From bd6ea4393c7d2f059fc4decc70f1ec3eb3597268 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Wed, 17 Aug 2016 23:08:22 +0800 Subject: [PATCH] Initial public version --- .gitignore | 14 + .gitmodules | 3 + Kconfig | 63 + LICENSE | 202 + README.buildenv | 265 + README.md | 151 + bin/eclipse_windows_make.sh | 9 + bin/esptool.py | 1800 +++ bin/gen_esp32part.py | 308 + components/bootloader/Makefile.projbuild | 45 + components/bootloader/src/.gitignore | 2 + components/bootloader/src/Makefile | 12 + components/bootloader/src/main/Makefile | 13 + .../bootloader/src/main/bootloader_config.h | 138 + .../bootloader/src/main/bootloader_log.h | 89 + .../bootloader/src/main/bootloader_start.c | 597 + .../bootloader/src/main/eagle.bootloader.ld | 148 + .../bootloader/src/main/flash_encrypt.c | 190 + components/bootloader/src/main/secure_boot.c | 125 + components/bt/Kconfig | 23 + components/esp32/Kconfig | 39 + components/esp32/Makefile | 20 + components/esp32/abi.cpp | 114 + components/esp32/cpu_start.c | 259 + components/esp32/event.c | 306 + components/esp32/heap_alloc_caps.c | 246 + components/esp32/heap_alloc_caps.h | 34 + components/esp32/include/esp_attr.h | 35 + components/esp32/include/esp_err.h | 36 + components/esp32/include/esp_event.h | 107 + components/esp32/include/esp_ssc.h | 119 + components/esp32/include/esp_system.h | 364 + components/esp32/include/esp_types.h | 73 + components/esp32/include/esp_wifi.h | 231 + components/esp32/include/esp_wps.h | 131 + components/esp32/include/rom/aes.h | 48 + components/esp32/include/rom/bigint.h | 53 + components/esp32/include/rom/cache.h | 69 + components/esp32/include/rom/crc.h | 34 + components/esp32/include/rom/efuse.h | 29 + components/esp32/include/rom/ets_sys.h | 329 + components/esp32/include/rom/gpio.h | 142 + components/esp32/include/rom/libc_stubs.h | 89 + components/esp32/include/rom/lldesc.h | 176 + components/esp32/include/rom/md5_hash.h | 36 + components/esp32/include/rom/miniz.h | 777 ++ components/esp32/include/rom/queue.h | 645 + components/esp32/include/rom/rtc.h | 168 + components/esp32/include/rom/secure_boot.h | 41 + components/esp32/include/rom/sha.h | 50 + components/esp32/include/rom/spi_flash.h | 145 + components/esp32/include/rom/ssc.h | 85 + components/esp32/include/rom/tbconsole.h | 27 + components/esp32/include/rom/tjpgd.h | 99 + components/esp32/include/rom/uart.h | 187 + components/esp32/include/rom/wdt.h | 40 + components/esp32/include/soc/bb_reg.h | 102 + components/esp32/include/soc/boot_mode.h | 104 + components/esp32/include/soc/dport_reg.h | 1766 +++ components/esp32/include/soc/efuse_reg.h | 422 + components/esp32/include/soc/gpio_reg.h | 3124 +++++ components/esp32/include/soc/gpio_sd_reg.h | 80 + components/esp32/include/soc/gpio_sig_map.h | 422 + components/esp32/include/soc/i2s_reg.h | 579 + components/esp32/include/soc/io_mux_reg.h | 264 + components/esp32/include/soc/pid.h | 65 + components/esp32/include/soc/rtc_cntl_reg.h | 751 ++ components/esp32/include/soc/rtc_io_reg.h | 723 ++ components/esp32/include/soc/soc.h | 270 + components/esp32/include/soc/spi_register.h | 399 + components/esp32/include/soc/timers_reg.h | 288 + components/esp32/include/soc/uart_register.h | 1399 ++ components/esp32/include/soc/uhci0_reg.h | 350 + components/esp32/include/xtensa/board.h | 28 + components/esp32/include/xtensa/c6x-compat.h | 1758 +++ components/esp32/include/xtensa/cacheasm.h | 962 ++ .../esp32/include/xtensa/cacheattrasm.h | 436 + .../esp32/include/xtensa/config/core-isa.h | 655 + .../esp32/include/xtensa/config/core-matmap.h | 318 + components/esp32/include/xtensa/config/core.h | 1405 +++ components/esp32/include/xtensa/config/defs.h | 38 + .../esp32/include/xtensa/config/specreg.h | 117 + .../esp32/include/xtensa/config/system.h | 274 + .../esp32/include/xtensa/config/tie-asm.h | 323 + components/esp32/include/xtensa/config/tie.h | 182 + components/esp32/include/xtensa/core-macros.h | 456 + components/esp32/include/xtensa/coreasm.h | 939 ++ components/esp32/include/xtensa/corebits.h | 185 + components/esp32/include/xtensa/debugfs.h | 93 + components/esp32/include/xtensa/feedback.h | 45 + components/esp32/include/xtensa/gdbio.h | 80 + components/esp32/include/xtensa/hal.h | 1024 ++ components/esp32/include/xtensa/jtag-xtensa.h | 99 + .../xtensa/lcd-splc780d-4bitmode-board.h | 62 + .../include/xtensa/lcd-splc780d-4bitmode.h | 105 + .../esp32/include/xtensa/lcd-splc780d.h | 151 + components/esp32/include/xtensa/overlay.h | 184 + .../esp32/include/xtensa/overlay_os_asm.h | 140 + components/esp32/include/xtensa/sim.h | 60 + components/esp32/include/xtensa/simboard.h | 71 + .../esp32/include/xtensa/simcall-errno.h | 139 + .../esp32/include/xtensa/simcall-fcntl.h | 21 + components/esp32/include/xtensa/simcall.h | 189 + components/esp32/include/xtensa/specreg.h | 143 + .../esp32/include/xtensa/tie/xt_DFP_assist.h | 96 + components/esp32/include/xtensa/tie/xt_FP.h | 197 + .../esp32/include/xtensa/tie/xt_MAC16.h | 239 + .../esp32/include/xtensa/tie/xt_MUL32.h | 24 + .../esp32/include/xtensa/tie/xt_booleans.h | 69 + .../include/xtensa/tie/xt_coprocessors.h | 48 + components/esp32/include/xtensa/tie/xt_core.h | 395 + .../esp32/include/xtensa/tie/xt_debug.h | 116 + .../esp32/include/xtensa/tie/xt_density.h | 58 + .../esp32/include/xtensa/tie/xt_exceptions.h | 45 + .../include/xtensa/tie/xt_externalregisters.h | 46 + .../include/xtensa/tie/xt_integerdivide.h | 50 + .../esp32/include/xtensa/tie/xt_interrupt.h | 56 + .../esp32/include/xtensa/tie/xt_ioports.h | 66 + components/esp32/include/xtensa/tie/xt_misc.h | 58 + components/esp32/include/xtensa/tie/xt_mmu.h | 62 + components/esp32/include/xtensa/tie/xt_mul.h | 52 + .../esp32/include/xtensa/tie/xt_regwin.h | 64 + .../esp32/include/xtensa/tie/xt_scmpr.h | 22 + components/esp32/include/xtensa/tie/xt_sync.h | 60 + .../esp32/include/xtensa/tie/xt_timer.h | 66 + .../esp32/include/xtensa/tie/xt_trace.h | 44 + components/esp32/include/xtensa/trax-api.h | 93 + .../esp32/include/xtensa/trax-core-config.h | 144 + components/esp32/include/xtensa/trax-proto.h | 91 + components/esp32/include/xtensa/trax-util.h | 63 + components/esp32/include/xtensa/trax.h | 409 + components/esp32/include/xtensa/traxfile.h | 62 + components/esp32/include/xtensa/traxreg.h | 199 + .../esp32/include/xtensa/uart-16550-board.h | 69 + components/esp32/include/xtensa/uart-16550.h | 152 + components/esp32/include/xtensa/udma.h | 276 + components/esp32/include/xtensa/xdm-regs.h | 530 + components/esp32/include/xtensa/xmon.h | 97 + components/esp32/include/xtensa/xmp-library.h | 789 ++ components/esp32/include/xtensa/xos.h | 524 + components/esp32/include/xtensa/xos_common.h | 362 + components/esp32/include/xtensa/xos_cond.h | 145 + components/esp32/include/xtensa/xos_errors.h | 107 + components/esp32/include/xtensa/xos_event.h | 281 + .../esp32/include/xtensa/xos_internal.h | 120 + components/esp32/include/xtensa/xos_msgq.h | 278 + components/esp32/include/xtensa/xos_mutex.h | 205 + components/esp32/include/xtensa/xos_params.h | 276 + .../esp32/include/xtensa/xos_regaccess.h | 201 + .../esp32/include/xtensa/xos_semaphore.h | 190 + .../esp32/include/xtensa/xos_stopwatch.h | 175 + components/esp32/include/xtensa/xos_syslog.h | 330 + components/esp32/include/xtensa/xos_thread.h | 1086 ++ components/esp32/include/xtensa/xos_timer.h | 592 + components/esp32/include/xtensa/xos_types.h | 75 + .../esp32/include/xtensa/xt_perf_consts.h | 283 + components/esp32/include/xtensa/xt_perfmon.h | 183 + .../esp32/include/xtensa/xt_profiling.h | 233 + components/esp32/include/xtensa/xt_reftb.h | 86 + components/esp32/include/xtensa/xtav110.h | 313 + .../include/xtensa/xtav110/xtensa/board.h | 13 + components/esp32/include/xtensa/xtav200.h | 280 + .../include/xtensa/xtav200/xtensa/board.h | 13 + components/esp32/include/xtensa/xtav60.h | 241 + .../include/xtensa/xtav60/xtensa/board.h | 13 + .../xtensa/xtav60/xtensa/lcd-splc780d-board.h | 60 + components/esp32/include/xtensa/xtbsp.h | 269 + .../include/xtensa/xtensa-libdb-macros.h | 161 + .../esp32/include/xtensa/xtensa-versions.h | 347 + components/esp32/include/xtensa/xtensa-xer.h | 149 + components/esp32/include/xtensa/xtkc705.h | 14 + .../include/xtensa/xtkc705/xtensa/board.h | 13 + components/esp32/include/xtensa/xtload-api.h | 77 + components/esp32/include/xtensa/xtml605.h | 338 + .../include/xtensa/xtml605/xtensa/board.h | 13 + .../include/xtensa/xtruntime-core-state.h | 212 + .../esp32/include/xtensa/xtruntime-frames.h | 162 + components/esp32/include/xtensa/xtruntime.h | 221 + components/esp32/include/xtensa/xtutil.h | 61 + .../esp32/ld/eagle.fpga32.rom.addr.v7.ld | 1829 +++ components/esp32/ld/eagle.fpga32.v7.ld | 170 + components/esp32/ld/elf_to_ld.sh | 12 + components/esp32/lib | 1 + components/esp32/libhal.a | Bin 0 -> 462242 bytes components/esp32/spiram.h | 19 + components/esp32/syscalls.c | 256 + components/esp32/wifi.c | 109 + components/esptool_py/Kconfig.projbuild | 49 + components/esptool_py/LICENSE | 339 + components/esptool_py/Makefile.projbuild | 25 + components/freertos/Kconfig | 125 + components/freertos/Makefile | 13 + components/freertos/croutine.c | 390 + components/freertos/event_groups.c | 695 + components/freertos/gdbstub.c | 365 + components/freertos/gdbstub.h | 22 + components/freertos/heap_regions.c | 559 + .../freertos/include/freertos/FreeRTOS.h | 791 ++ .../include/freertos/FreeRTOSConfig.h | 244 + .../freertos/include/freertos/StackMacros.h | 184 + .../freertos/include/freertos/croutine.h | 762 ++ .../include/freertos/deprecated_definitions.h | 321 + .../freertos/include/freertos/event_groups.h | 730 ++ .../freertos/include/freertos/heap_regions.h | 34 + components/freertos/include/freertos/list.h | 453 + .../freertos/include/freertos/mpu_wrappers.h | 157 + .../freertos/include/freertos/portable.h | 203 + .../freertos/include/freertos/portbenchmark.h | 46 + .../freertos/include/freertos/portmacro.h | 290 + .../freertos/include/freertos/porttrace.h | 42 + .../freertos/include/freertos/projdefs.h | 109 + components/freertos/include/freertos/queue.h | 1693 +++ components/freertos/include/freertos/semphr.h | 844 ++ components/freertos/include/freertos/task.h | 2019 +++ components/freertos/include/freertos/timers.h | 1125 ++ .../freertos/include/freertos/xtensa_api.h | 118 + .../freertos/include/freertos/xtensa_config.h | 146 + .../include/freertos/xtensa_context.h | 383 + .../freertos/include/freertos/xtensa_rtos.h | 233 + .../freertos/include/freertos/xtensa_timer.h | 159 + components/freertos/license.txt | 440 + components/freertos/list.c | 233 + components/freertos/panic.c | 211 + components/freertos/port.c | 390 + components/freertos/portasm.S | 662 + components/freertos/queue.c | 2642 ++++ components/freertos/readme_smp.txt | 26 + components/freertos/readme_xtensa.txt | 769 ++ components/freertos/stdint.readme | 27 + components/freertos/tasks.c | 4535 +++++++ components/freertos/timers.c | 909 ++ components/freertos/xtensa_context.S | 645 + components/freertos/xtensa_init.c | 65 + components/freertos/xtensa_intr.c | 138 + components/freertos/xtensa_intr_asm.S | 179 + components/freertos/xtensa_overlay_os_hook.c | 67 + components/freertos/xtensa_vectors.S | 1980 +++ components/freertos/xtensa_vectors.S-new | 1915 +++ components/freertos/xtensa_vectors.S-old | 2064 +++ components/lwip/CHANGELOG | 4044 ++++++ components/lwip/COPYING | 33 + components/lwip/Kconfig | 14 + components/lwip/Makefile | 16 + components/lwip/README | 86 + components/lwip/VERSION | 1 + components/lwip/api/api_lib.c | 979 ++ components/lwip/api/api_msg.c | 1930 +++ components/lwip/api/err.c | 75 + components/lwip/api/netbuf.c | 250 + components/lwip/api/netdb.c | 415 + components/lwip/api/netifapi.c | 206 + components/lwip/api/pppapi.c | 371 + components/lwip/api/sockets.c | 3263 +++++ components/lwip/api/tcpip.c | 569 + components/lwip/apps/dhcpserver.c | 2485 ++++ components/lwip/core/def.c | 108 + components/lwip/core/dns.c | 1500 +++ components/lwip/core/inet_chksum.c | 612 + components/lwip/core/init.c | 378 + components/lwip/core/ip.c | 101 + components/lwip/core/ipv4/autoip.c | 549 + components/lwip/core/ipv4/dhcp.c | 1941 +++ components/lwip/core/ipv4/icmp.c | 391 + components/lwip/core/ipv4/igmp.c | 832 ++ components/lwip/core/ipv4/ip4.c | 1085 ++ components/lwip/core/ipv4/ip4_addr.c | 372 + components/lwip/core/ipv4/ip_frag.c | 902 ++ components/lwip/core/ipv6/README | 1 + components/lwip/core/ipv6/dhcp6.c | 50 + components/lwip/core/ipv6/ethip6.c | 159 + components/lwip/core/ipv6/icmp6.c | 353 + components/lwip/core/ipv6/inet6.c | 53 + components/lwip/core/ipv6/ip6.c | 1104 ++ components/lwip/core/ipv6/ip6_addr.c | 292 + components/lwip/core/ipv6/ip6_frag.c | 778 ++ components/lwip/core/ipv6/mld6.c | 593 + components/lwip/core/ipv6/nd6.c | 1846 +++ components/lwip/core/mem.c | 686 + components/lwip/core/memp.c | 436 + components/lwip/core/netif.c | 1090 ++ components/lwip/core/pbuf.c | 1396 ++ components/lwip/core/raw.c | 483 + components/lwip/core/stats.c | 188 + components/lwip/core/sys.c | 68 + components/lwip/core/tcp.c | 2155 ++++ components/lwip/core/tcp_in.c | 1802 +++ components/lwip/core/tcp_out.c | 1614 +++ components/lwip/core/timers.c | 614 + components/lwip/core/udp.c | 1198 ++ .../lwip/include/lwip/apps/dhcpserver.h | 494 + components/lwip/include/lwip/lwip/api.h | 368 + components/lwip/include/lwip/lwip/arch.h | 233 + components/lwip/include/lwip/lwip/autoip.h | 124 + components/lwip/include/lwip/lwip/debug.h | 117 + components/lwip/include/lwip/lwip/def.h | 132 + components/lwip/include/lwip/lwip/dhcp.h | 298 + components/lwip/include/lwip/lwip/dhcp6.h | 58 + components/lwip/include/lwip/lwip/dns.h | 118 + components/lwip/include/lwip/lwip/err.h | 95 + components/lwip/include/lwip/lwip/ethip6.h | 68 + components/lwip/include/lwip/lwip/icmp.h | 137 + components/lwip/include/lwip/lwip/icmp6.h | 152 + components/lwip/include/lwip/lwip/igmp.h | 108 + components/lwip/include/lwip/lwip/inet.h | 172 + .../lwip/include/lwip/lwip/inet_chksum.h | 106 + components/lwip/include/lwip/lwip/init.h | 72 + components/lwip/include/lwip/lwip/ip.h | 304 + components/lwip/include/lwip/lwip/ip4.h | 161 + components/lwip/include/lwip/lwip/ip4_addr.h | 253 + components/lwip/include/lwip/lwip/ip6.h | 197 + components/lwip/include/lwip/lwip/ip6_addr.h | 301 + components/lwip/include/lwip/lwip/ip6_frag.h | 120 + components/lwip/include/lwip/lwip/ip_addr.h | 291 + components/lwip/include/lwip/lwip/ip_frag.h | 95 + components/lwip/include/lwip/lwip/mem.h | 162 + components/lwip/include/lwip/lwip/memp.h | 133 + components/lwip/include/lwip/lwip/mld6.h | 119 + components/lwip/include/lwip/lwip/nd6.h | 361 + components/lwip/include/lwip/lwip/netbuf.h | 112 + components/lwip/include/lwip/lwip/netdb.h | 142 + components/lwip/include/lwip/lwip/netif.h | 447 + components/lwip/include/lwip/lwip/netifapi.h | 108 + components/lwip/include/lwip/lwip/opt.h | 3015 +++++ components/lwip/include/lwip/lwip/pbuf.h | 231 + components/lwip/include/lwip/lwip/pppapi.h | 148 + .../lwip/include/lwip/lwip/priv/api_msg.h | 260 + .../lwip/include/lwip/lwip/priv/memp_priv.h | 163 + .../lwip/include/lwip/lwip/priv/memp_std.h | 151 + .../lwip/include/lwip/lwip/priv/tcp_priv.h | 545 + .../lwip/include/lwip/lwip/priv/tcpip_priv.h | 163 + components/lwip/include/lwip/lwip/raw.h | 109 + components/lwip/include/lwip/lwip/sio.h | 141 + components/lwip/include/lwip/lwip/snmp.h | 195 + components/lwip/include/lwip/lwip/sockets.h | 624 + components/lwip/include/lwip/lwip/stats.h | 462 + components/lwip/include/lwip/lwip/sys.h | 362 + components/lwip/include/lwip/lwip/tcp.h | 411 + components/lwip/include/lwip/lwip/tcpip.h | 85 + components/lwip/include/lwip/lwip/timers.h | 101 + components/lwip/include/lwip/lwip/udp.h | 194 + components/lwip/include/lwip/netif/etharp.h | 143 + components/lwip/include/lwip/netif/ethernet.h | 171 + components/lwip/include/lwip/netif/lowpan6.h | 84 + .../lwip/include/lwip/netif/lowpan6_opts.h | 65 + components/lwip/include/lwip/netif/ppp/ccp.h | 156 + .../lwip/include/lwip/netif/ppp/chap-md5.h | 36 + .../lwip/include/lwip/netif/ppp/chap-new.h | 192 + .../lwip/include/lwip/netif/ppp/chap_ms.h | 44 + components/lwip/include/lwip/netif/ppp/eap.h | 169 + components/lwip/include/lwip/netif/ppp/ecp.h | 50 + .../lwip/include/lwip/netif/ppp/eui64.h | 94 + components/lwip/include/lwip/netif/ppp/fsm.h | 175 + components/lwip/include/lwip/netif/ppp/ipcp.h | 126 + .../lwip/include/lwip/netif/ppp/ipv6cp.h | 183 + components/lwip/include/lwip/netif/ppp/lcp.h | 169 + .../lwip/include/lwip/netif/ppp/magic.h | 122 + components/lwip/include/lwip/netif/ppp/mppe.h | 177 + .../include/lwip/netif/ppp/polarssl/arc4.h | 81 + .../include/lwip/netif/ppp/polarssl/des.h | 92 + .../include/lwip/netif/ppp/polarssl/md4.h | 97 + .../include/lwip/netif/ppp/polarssl/md5.h | 96 + .../include/lwip/netif/ppp/polarssl/sha1.h | 96 + components/lwip/include/lwip/netif/ppp/ppp.h | 573 + .../lwip/include/lwip/netif/ppp/ppp_impl.h | 632 + .../lwip/include/lwip/netif/ppp/pppcrypt.h | 43 + .../lwip/include/lwip/netif/ppp/pppdebug.h | 80 + .../lwip/include/lwip/netif/ppp/pppoe.h | 179 + .../lwip/include/lwip/netif/ppp/pppol2tp.h | 201 + .../lwip/include/lwip/netif/ppp/pppos.h | 119 + components/lwip/include/lwip/netif/ppp/upap.h | 123 + components/lwip/include/lwip/netif/ppp/vj.h | 161 + components/lwip/include/lwip/netif/slipif.h | 81 + components/lwip/include/lwip/port/arch/cc.h | 77 + components/lwip/include/lwip/port/arch/perf.h | 40 + .../lwip/include/lwip/port/arch/sys_arch.h | 73 + components/lwip/include/lwip/port/lwipopts.h | 526 + .../lwip/include/lwip/port/netif/wlanif.h | 23 + components/lwip/include/lwip/posix/netdb.h | 33 + .../lwip/include/lwip/posix/sys/socket.h | 33 + components/lwip/netif/FILES | 31 + components/lwip/netif/etharp.c | 1385 ++ components/lwip/netif/ethernet.c | 222 + components/lwip/netif/ethernetif.c | 339 + components/lwip/netif/lowpan6.c | 1196 ++ components/lwip/netif/ppp/PPPD_FOLLOWUP | 382 + components/lwip/netif/ppp/auth.c | 2497 ++++ components/lwip/netif/ppp/ccp.c | 1741 +++ components/lwip/netif/ppp/chap-md5.c | 127 + components/lwip/netif/ppp/chap-new.c | 677 + components/lwip/netif/ppp/chap_ms.c | 954 ++ components/lwip/netif/ppp/demand.c | 465 + components/lwip/netif/ppp/eap.c | 2429 ++++ components/lwip/netif/ppp/ecp.c | 191 + components/lwip/netif/ppp/eui64.c | 56 + components/lwip/netif/ppp/fsm.c | 799 ++ components/lwip/netif/ppp/ipcp.c | 2408 ++++ components/lwip/netif/ppp/ipv6cp.c | 1533 +++ components/lwip/netif/ppp/lcp.c | 2786 ++++ components/lwip/netif/ppp/magic.c | 294 + components/lwip/netif/ppp/mppe.c | 418 + components/lwip/netif/ppp/multilink.c | 609 + components/lwip/netif/ppp/polarssl/README | 33 + components/lwip/netif/ppp/polarssl/arc4.c | 101 + components/lwip/netif/ppp/polarssl/des.c | 422 + components/lwip/netif/ppp/polarssl/md4.c | 281 + components/lwip/netif/ppp/polarssl/md5.c | 300 + components/lwip/netif/ppp/polarssl/sha1.c | 335 + components/lwip/netif/ppp/ppp.c | 1600 +++ components/lwip/netif/ppp/pppcrypt.c | 66 + components/lwip/netif/ppp/pppoe.c | 1250 ++ components/lwip/netif/ppp/pppol2tp.c | 1151 ++ components/lwip/netif/ppp/pppos.c | 899 ++ components/lwip/netif/ppp/upap.c | 677 + components/lwip/netif/ppp/utils.c | 961 ++ components/lwip/netif/ppp/vj.c | 670 + components/lwip/netif/slipif.c | 555 + components/lwip/port/freertos/sys_arch.c | 494 + components/lwip/port/netif/wlanif.c | 284 + components/newlib/.gitignore | 2 + components/newlib/.gitmodules | 4 + components/newlib/COPYING.NEWLIB | 953 ++ components/newlib/Makefile | 8 + components/newlib/Makefile.old | 47 + components/newlib/include/_ansi.h | 140 + components/newlib/include/_syslist.h | 40 + components/newlib/include/alloca.h | 21 + components/newlib/include/ar.h | 69 + components/newlib/include/argz.h | 33 + components/newlib/include/assert.h | 50 + components/newlib/include/complex.h | 124 + components/newlib/include/config.h | 28 + components/newlib/include/ctype.h | 113 + components/newlib/include/dirent.h | 15 + components/newlib/include/envlock.h | 15 + components/newlib/include/envz.h | 16 + components/newlib/include/errno.h | 11 + components/newlib/include/fastmath.h | 13 + components/newlib/include/fcntl.h | 1 + components/newlib/include/fenv.h | 88 + components/newlib/include/fnmatch.h | 55 + components/newlib/include/getopt.h | 190 + components/newlib/include/glob.h | 90 + components/newlib/include/grp.h | 95 + components/newlib/include/iconv.h | 63 + components/newlib/include/ieeefp.h | 256 + components/newlib/include/inttypes.h | 319 + components/newlib/include/langinfo.h | 316 + components/newlib/include/libgen.h | 23 + components/newlib/include/limits.h | 146 + components/newlib/include/locale.h | 64 + .../newlib/include/machine/_default_types.h | 56 + components/newlib/include/machine/_types.h | 8 + components/newlib/include/machine/ansi.h | 1 + components/newlib/include/machine/endian.h | 20 + components/newlib/include/machine/fastmath.h | 100 + components/newlib/include/machine/ieeefp.h | 434 + components/newlib/include/machine/malloc.h | 8 + components/newlib/include/machine/param.h | 1 + components/newlib/include/machine/setjmp-dj.h | 43 + components/newlib/include/machine/setjmp.h | 453 + components/newlib/include/machine/stdlib.h | 8 + components/newlib/include/machine/termios.h | 1 + components/newlib/include/machine/time.h | 19 + components/newlib/include/machine/types.h | 30 + components/newlib/include/malloc.h | 169 + components/newlib/include/math.h | 615 + components/newlib/include/newlib.h | 201 + components/newlib/include/paths.h | 9 + components/newlib/include/pthread.h | 431 + components/newlib/include/pwd.h | 87 + components/newlib/include/reent.h | 189 + components/newlib/include/regdef.h | 7 + components/newlib/include/regex.h | 103 + components/newlib/include/sched.h | 97 + components/newlib/include/search.h | 64 + components/newlib/include/setjmp.h | 27 + components/newlib/include/signal.h | 32 + components/newlib/include/spawn.h | 119 + components/newlib/include/stdatomic.h | 413 + components/newlib/include/stdint.h | 511 + components/newlib/include/stdio.h | 727 ++ components/newlib/include/stdio_ext.h | 79 + components/newlib/include/stdlib.h | 297 + components/newlib/include/string.h | 167 + components/newlib/include/strings.h | 35 + .../newlib/include/sys/_default_fcntl.h | 213 + components/newlib/include/sys/_intsup.h | 20 + components/newlib/include/sys/_types.h | 91 + components/newlib/include/sys/cdefs.h | 710 ++ components/newlib/include/sys/config.h | 300 + components/newlib/include/sys/custom_file.h | 2 + components/newlib/include/sys/dir.h | 10 + components/newlib/include/sys/dirent.h | 13 + components/newlib/include/sys/errno.h | 192 + components/newlib/include/sys/fcntl.h | 4 + components/newlib/include/sys/features.h | 235 + components/newlib/include/sys/file.h | 33 + components/newlib/include/sys/iconvnls.h | 77 + components/newlib/include/sys/lock.h | 50 + components/newlib/include/sys/param.h | 28 + components/newlib/include/sys/queue.h | 691 + components/newlib/include/sys/reent.h | 793 ++ components/newlib/include/sys/resource.h | 17 + components/newlib/include/sys/sched.h | 67 + components/newlib/include/sys/signal.h | 357 + components/newlib/include/sys/stat.h | 192 + components/newlib/include/sys/stdio.h | 27 + components/newlib/include/sys/string.h | 2 + components/newlib/include/sys/syslimits.h | 65 + components/newlib/include/sys/time.h | 91 + components/newlib/include/sys/timeb.h | 39 + components/newlib/include/sys/times.h | 31 + components/newlib/include/sys/types.h | 521 + components/newlib/include/sys/unistd.h | 516 + components/newlib/include/sys/utime.h | 22 + components/newlib/include/sys/wait.h | 44 + components/newlib/include/tar.h | 39 + components/newlib/include/termios.h | 7 + components/newlib/include/tgmath.h | 184 + components/newlib/include/time.h | 291 + components/newlib/include/unctrl.h | 46 + components/newlib/include/unistd.h | 13 + components/newlib/include/utime.h | 12 + components/newlib/include/utmp.h | 8 + components/newlib/include/wchar.h | 254 + components/newlib/include/wctype.h | 47 + components/newlib/include/wordexp.h | 53 + .../newlib/include/xtensa/config/core-isa.h | 655 + components/newlib/lib/extracted/romsyms | 639 + components/newlib/lib/fixlibc.sh | 23 + components/newlib/lib/libc-minusrom.a | Bin 0 -> 3675626 bytes components/newlib/lib/libc.a | Bin 0 -> 3699654 bytes components/newlib/lib/libc_rom.a | Bin 0 -> 4870926 bytes components/newlib/lib/libg.a | Bin 0 -> 4921612 bytes components/newlib/lib/libm.a | Bin 0 -> 2227074 bytes components/newlib/libc_discard.list | 159 + components/nvs_flash/.gitignore | 1 + components/nvs_flash/Makefile | 14 + components/nvs_flash/README.rst | 219 + components/nvs_flash/include/nvs.h | 212 + components/nvs_flash/include/nvs_flash.h | 29 + .../nvs_flash/src/compressed_enum_table.hpp | 79 + components/nvs_flash/src/intrusive_list.h | 248 + components/nvs_flash/src/nvs.hpp | 25 + components/nvs_flash/src/nvs_api.cpp | 278 + components/nvs_flash/src/nvs_page.cpp | 689 + components/nvs_flash/src/nvs_page.hpp | 246 + components/nvs_flash/src/nvs_pagemanager.cpp | 137 + components/nvs_flash/src/nvs_pagemanager.hpp | 70 + components/nvs_flash/src/nvs_platform.hpp | 84 + components/nvs_flash/src/nvs_storage.cpp | 195 + components/nvs_flash/src/nvs_storage.hpp | 114 + components/nvs_flash/src/nvs_types.cpp | 42 + components/nvs_flash/src/nvs_types.hpp | 100 + components/nvs_flash/test/Makefile | 40 + components/nvs_flash/test/catch.hpp | 10509 ++++++++++++++++ components/nvs_flash/test/crc.cpp | 38 + components/nvs_flash/test/crc.h | 30 + components/nvs_flash/test/main.cpp | 2 + .../nvs_flash/test/spi_flash_emulation.cpp | 97 + .../nvs_flash/test/spi_flash_emulation.h | 198 + .../test/test_compressed_enum_table.cpp | 56 + .../nvs_flash/test/test_intrusive_list.cpp | 212 + components/nvs_flash/test/test_nvs.cpp | 715 ++ .../test/test_spi_flash_emulation.cpp | 154 + components/partition_table/Kconfig.projbuild | 50 + components/partition_table/Makefile.projbuild | 42 + .../partition_table/partitions_singleapp.csv | 4 + .../partition_table/partitions_two_ota.csv | 7 + .../tests/gen_esp32part_tests.py | 313 + components/spi_flash/Makefile | 3 + components/spi_flash/esp_spi_flash.c | 106 + components/spi_flash/include/esp_spi_flash.h | 69 + components/tcpip_adapter/Makefile | 12 + .../tcpip_adapter/include/tcpip_adapter.h | 100 + components/tcpip_adapter/tcpip_adapter_lwip.c | 450 + docs/COPYRIGHT.rst | 103 + docs/eclipse-setup.rst | 75 + docs/windows-setup.rst | 87 + make/common.mk | 56 + make/component.mk | 111 + make/project.mk | 185 + make/project_config.mk | 63 + tools/gen_esp32part.py | 343 + tools/kconfig/.gitignore | 22 + tools/kconfig/Kconfig | 1 + tools/kconfig/Makefile | 306 + tools/kconfig/POTFILES.in | 12 + tools/kconfig/check.sh | 13 + tools/kconfig/conf.c | 723 ++ tools/kconfig/confdata.c | 1247 ++ tools/kconfig/expr.c | 1206 ++ tools/kconfig/expr.h | 238 + tools/kconfig/gconf.c | 1521 +++ tools/kconfig/gconf.glade | 661 + tools/kconfig/images.c | 326 + tools/kconfig/kconfig-language.txt | 556 + tools/kconfig/kxgettext.c | 235 + tools/kconfig/list.h | 131 + tools/kconfig/lkc.h | 187 + tools/kconfig/lkc_proto.h | 52 + tools/kconfig/lxdialog/.gitignore | 4 + tools/kconfig/lxdialog/BIG.FAT.WARNING | 4 + tools/kconfig/lxdialog/check-lxdialog.sh | 95 + tools/kconfig/lxdialog/checklist.c | 332 + tools/kconfig/lxdialog/dialog.h | 257 + tools/kconfig/lxdialog/inputbox.c | 301 + tools/kconfig/lxdialog/menubox.c | 437 + tools/kconfig/lxdialog/textbox.c | 408 + tools/kconfig/lxdialog/util.c | 713 ++ tools/kconfig/lxdialog/yesno.c | 114 + tools/kconfig/mconf.c | 1047 ++ tools/kconfig/menu.c | 697 + tools/kconfig/merge_config.sh | 170 + tools/kconfig/nconf.c | 1561 +++ tools/kconfig/nconf.gui.c | 656 + tools/kconfig/nconf.h | 96 + tools/kconfig/qconf.cc | 1870 +++ tools/kconfig/qconf.h | 330 + tools/kconfig/streamline_config.pl | 647 + tools/kconfig/symbol.c | 1378 ++ tools/kconfig/util.c | 147 + tools/kconfig/zconf.gperf | 49 + tools/kconfig/zconf.l | 390 + tools/kconfig/zconf.y | 745 ++ tools/tests/gen_esp32part_tests.py | 313 + ...oolchain-linux64-win32-canadian-build.conf | 534 + .../windows/windows_install_prerequisites.sh | 60 + 628 files changed, 224814 insertions(+) create mode 100644 .gitignore create mode 100644 .gitmodules create mode 100644 Kconfig create mode 100644 LICENSE create mode 100644 README.buildenv create mode 100644 README.md create mode 100755 bin/eclipse_windows_make.sh create mode 100755 bin/esptool.py create mode 100755 bin/gen_esp32part.py create mode 100644 components/bootloader/Makefile.projbuild create mode 100644 components/bootloader/src/.gitignore create mode 100644 components/bootloader/src/Makefile create mode 100644 components/bootloader/src/main/Makefile create mode 100644 components/bootloader/src/main/bootloader_config.h create mode 100644 components/bootloader/src/main/bootloader_log.h create mode 100644 components/bootloader/src/main/bootloader_start.c create mode 100644 components/bootloader/src/main/eagle.bootloader.ld create mode 100644 components/bootloader/src/main/flash_encrypt.c create mode 100644 components/bootloader/src/main/secure_boot.c create mode 100644 components/bt/Kconfig create mode 100644 components/esp32/Kconfig create mode 100644 components/esp32/Makefile create mode 100644 components/esp32/abi.cpp create mode 100644 components/esp32/cpu_start.c create mode 100644 components/esp32/event.c create mode 100644 components/esp32/heap_alloc_caps.c create mode 100644 components/esp32/heap_alloc_caps.h create mode 100644 components/esp32/include/esp_attr.h create mode 100644 components/esp32/include/esp_err.h create mode 100755 components/esp32/include/esp_event.h create mode 100644 components/esp32/include/esp_ssc.h create mode 100644 components/esp32/include/esp_system.h create mode 100755 components/esp32/include/esp_types.h create mode 100755 components/esp32/include/esp_wifi.h create mode 100644 components/esp32/include/esp_wps.h create mode 100644 components/esp32/include/rom/aes.h create mode 100644 components/esp32/include/rom/bigint.h create mode 100644 components/esp32/include/rom/cache.h create mode 100644 components/esp32/include/rom/crc.h create mode 100644 components/esp32/include/rom/efuse.h create mode 100644 components/esp32/include/rom/ets_sys.h create mode 100644 components/esp32/include/rom/gpio.h create mode 100644 components/esp32/include/rom/libc_stubs.h create mode 100644 components/esp32/include/rom/lldesc.h create mode 100755 components/esp32/include/rom/md5_hash.h create mode 100644 components/esp32/include/rom/miniz.h create mode 100755 components/esp32/include/rom/queue.h create mode 100644 components/esp32/include/rom/rtc.h create mode 100644 components/esp32/include/rom/secure_boot.h create mode 100644 components/esp32/include/rom/sha.h create mode 100644 components/esp32/include/rom/spi_flash.h create mode 100755 components/esp32/include/rom/ssc.h create mode 100644 components/esp32/include/rom/tbconsole.h create mode 100644 components/esp32/include/rom/tjpgd.h create mode 100755 components/esp32/include/rom/uart.h create mode 100644 components/esp32/include/rom/wdt.h create mode 100755 components/esp32/include/soc/bb_reg.h create mode 100755 components/esp32/include/soc/boot_mode.h create mode 100644 components/esp32/include/soc/dport_reg.h create mode 100644 components/esp32/include/soc/efuse_reg.h create mode 100644 components/esp32/include/soc/gpio_reg.h create mode 100644 components/esp32/include/soc/gpio_sd_reg.h create mode 100644 components/esp32/include/soc/gpio_sig_map.h create mode 100644 components/esp32/include/soc/i2s_reg.h create mode 100644 components/esp32/include/soc/io_mux_reg.h create mode 100644 components/esp32/include/soc/pid.h create mode 100644 components/esp32/include/soc/rtc_cntl_reg.h create mode 100644 components/esp32/include/soc/rtc_io_reg.h create mode 100755 components/esp32/include/soc/soc.h create mode 100755 components/esp32/include/soc/spi_register.h create mode 100644 components/esp32/include/soc/timers_reg.h create mode 100644 components/esp32/include/soc/uart_register.h create mode 100644 components/esp32/include/soc/uhci0_reg.h create mode 100755 components/esp32/include/xtensa/board.h create mode 100755 components/esp32/include/xtensa/c6x-compat.h create mode 100755 components/esp32/include/xtensa/cacheasm.h create mode 100755 components/esp32/include/xtensa/cacheattrasm.h create mode 100644 components/esp32/include/xtensa/config/core-isa.h create mode 100644 components/esp32/include/xtensa/config/core-matmap.h create mode 100644 components/esp32/include/xtensa/config/core.h create mode 100644 components/esp32/include/xtensa/config/defs.h create mode 100644 components/esp32/include/xtensa/config/specreg.h create mode 100644 components/esp32/include/xtensa/config/system.h create mode 100644 components/esp32/include/xtensa/config/tie-asm.h create mode 100644 components/esp32/include/xtensa/config/tie.h create mode 100755 components/esp32/include/xtensa/core-macros.h create mode 100755 components/esp32/include/xtensa/coreasm.h create mode 100755 components/esp32/include/xtensa/corebits.h create mode 100755 components/esp32/include/xtensa/debugfs.h create mode 100755 components/esp32/include/xtensa/feedback.h create mode 100755 components/esp32/include/xtensa/gdbio.h create mode 100755 components/esp32/include/xtensa/hal.h create mode 100755 components/esp32/include/xtensa/jtag-xtensa.h create mode 100755 components/esp32/include/xtensa/lcd-splc780d-4bitmode-board.h create mode 100755 components/esp32/include/xtensa/lcd-splc780d-4bitmode.h create mode 100755 components/esp32/include/xtensa/lcd-splc780d.h create mode 100755 components/esp32/include/xtensa/overlay.h create mode 100755 components/esp32/include/xtensa/overlay_os_asm.h create mode 100755 components/esp32/include/xtensa/sim.h create mode 100755 components/esp32/include/xtensa/simboard.h create mode 100755 components/esp32/include/xtensa/simcall-errno.h create mode 100755 components/esp32/include/xtensa/simcall-fcntl.h create mode 100755 components/esp32/include/xtensa/simcall.h create mode 100755 components/esp32/include/xtensa/specreg.h create mode 100644 components/esp32/include/xtensa/tie/xt_DFP_assist.h create mode 100644 components/esp32/include/xtensa/tie/xt_FP.h create mode 100644 components/esp32/include/xtensa/tie/xt_MAC16.h create mode 100644 components/esp32/include/xtensa/tie/xt_MUL32.h create mode 100644 components/esp32/include/xtensa/tie/xt_booleans.h create mode 100644 components/esp32/include/xtensa/tie/xt_coprocessors.h create mode 100644 components/esp32/include/xtensa/tie/xt_core.h create mode 100644 components/esp32/include/xtensa/tie/xt_debug.h create mode 100644 components/esp32/include/xtensa/tie/xt_density.h create mode 100644 components/esp32/include/xtensa/tie/xt_exceptions.h create mode 100644 components/esp32/include/xtensa/tie/xt_externalregisters.h create mode 100644 components/esp32/include/xtensa/tie/xt_integerdivide.h create mode 100644 components/esp32/include/xtensa/tie/xt_interrupt.h create mode 100644 components/esp32/include/xtensa/tie/xt_ioports.h create mode 100644 components/esp32/include/xtensa/tie/xt_misc.h create mode 100644 components/esp32/include/xtensa/tie/xt_mmu.h create mode 100644 components/esp32/include/xtensa/tie/xt_mul.h create mode 100644 components/esp32/include/xtensa/tie/xt_regwin.h create mode 100644 components/esp32/include/xtensa/tie/xt_scmpr.h create mode 100644 components/esp32/include/xtensa/tie/xt_sync.h create mode 100644 components/esp32/include/xtensa/tie/xt_timer.h create mode 100644 components/esp32/include/xtensa/tie/xt_trace.h create mode 100755 components/esp32/include/xtensa/trax-api.h create mode 100755 components/esp32/include/xtensa/trax-core-config.h create mode 100755 components/esp32/include/xtensa/trax-proto.h create mode 100755 components/esp32/include/xtensa/trax-util.h create mode 100755 components/esp32/include/xtensa/trax.h create mode 100755 components/esp32/include/xtensa/traxfile.h create mode 100755 components/esp32/include/xtensa/traxreg.h create mode 100755 components/esp32/include/xtensa/uart-16550-board.h create mode 100755 components/esp32/include/xtensa/uart-16550.h create mode 100755 components/esp32/include/xtensa/udma.h create mode 100755 components/esp32/include/xtensa/xdm-regs.h create mode 100755 components/esp32/include/xtensa/xmon.h create mode 100755 components/esp32/include/xtensa/xmp-library.h create mode 100755 components/esp32/include/xtensa/xos.h create mode 100755 components/esp32/include/xtensa/xos_common.h create mode 100755 components/esp32/include/xtensa/xos_cond.h create mode 100755 components/esp32/include/xtensa/xos_errors.h create mode 100755 components/esp32/include/xtensa/xos_event.h create mode 100755 components/esp32/include/xtensa/xos_internal.h create mode 100755 components/esp32/include/xtensa/xos_msgq.h create mode 100755 components/esp32/include/xtensa/xos_mutex.h create mode 100755 components/esp32/include/xtensa/xos_params.h create mode 100755 components/esp32/include/xtensa/xos_regaccess.h create mode 100755 components/esp32/include/xtensa/xos_semaphore.h create mode 100755 components/esp32/include/xtensa/xos_stopwatch.h create mode 100755 components/esp32/include/xtensa/xos_syslog.h create mode 100755 components/esp32/include/xtensa/xos_thread.h create mode 100755 components/esp32/include/xtensa/xos_timer.h create mode 100755 components/esp32/include/xtensa/xos_types.h create mode 100755 components/esp32/include/xtensa/xt_perf_consts.h create mode 100755 components/esp32/include/xtensa/xt_perfmon.h create mode 100755 components/esp32/include/xtensa/xt_profiling.h create mode 100755 components/esp32/include/xtensa/xt_reftb.h create mode 100755 components/esp32/include/xtensa/xtav110.h create mode 100755 components/esp32/include/xtensa/xtav110/xtensa/board.h create mode 100755 components/esp32/include/xtensa/xtav200.h create mode 100755 components/esp32/include/xtensa/xtav200/xtensa/board.h create mode 100755 components/esp32/include/xtensa/xtav60.h create mode 100755 components/esp32/include/xtensa/xtav60/xtensa/board.h create mode 100755 components/esp32/include/xtensa/xtav60/xtensa/lcd-splc780d-board.h create mode 100755 components/esp32/include/xtensa/xtbsp.h create mode 100755 components/esp32/include/xtensa/xtensa-libdb-macros.h create mode 100755 components/esp32/include/xtensa/xtensa-versions.h create mode 100755 components/esp32/include/xtensa/xtensa-xer.h create mode 100755 components/esp32/include/xtensa/xtkc705.h create mode 100755 components/esp32/include/xtensa/xtkc705/xtensa/board.h create mode 100755 components/esp32/include/xtensa/xtload-api.h create mode 100755 components/esp32/include/xtensa/xtml605.h create mode 100755 components/esp32/include/xtensa/xtml605/xtensa/board.h create mode 100755 components/esp32/include/xtensa/xtruntime-core-state.h create mode 100755 components/esp32/include/xtensa/xtruntime-frames.h create mode 100755 components/esp32/include/xtensa/xtruntime.h create mode 100755 components/esp32/include/xtensa/xtutil.h create mode 100644 components/esp32/ld/eagle.fpga32.rom.addr.v7.ld create mode 100644 components/esp32/ld/eagle.fpga32.v7.ld create mode 100755 components/esp32/ld/elf_to_ld.sh create mode 160000 components/esp32/lib create mode 100644 components/esp32/libhal.a create mode 100644 components/esp32/spiram.h create mode 100644 components/esp32/syscalls.c create mode 100644 components/esp32/wifi.c create mode 100644 components/esptool_py/Kconfig.projbuild create mode 100644 components/esptool_py/LICENSE create mode 100644 components/esptool_py/Makefile.projbuild create mode 100644 components/freertos/Kconfig create mode 100644 components/freertos/Makefile create mode 100644 components/freertos/croutine.c create mode 100644 components/freertos/event_groups.c create mode 100644 components/freertos/gdbstub.c create mode 100644 components/freertos/gdbstub.h create mode 100644 components/freertos/heap_regions.c create mode 100644 components/freertos/include/freertos/FreeRTOS.h create mode 100644 components/freertos/include/freertos/FreeRTOSConfig.h create mode 100644 components/freertos/include/freertos/StackMacros.h create mode 100644 components/freertos/include/freertos/croutine.h create mode 100644 components/freertos/include/freertos/deprecated_definitions.h create mode 100644 components/freertos/include/freertos/event_groups.h create mode 100644 components/freertos/include/freertos/heap_regions.h create mode 100644 components/freertos/include/freertos/list.h create mode 100644 components/freertos/include/freertos/mpu_wrappers.h create mode 100644 components/freertos/include/freertos/portable.h create mode 100644 components/freertos/include/freertos/portbenchmark.h create mode 100644 components/freertos/include/freertos/portmacro.h create mode 100644 components/freertos/include/freertos/porttrace.h create mode 100644 components/freertos/include/freertos/projdefs.h create mode 100644 components/freertos/include/freertos/queue.h create mode 100644 components/freertos/include/freertos/semphr.h create mode 100644 components/freertos/include/freertos/task.h create mode 100644 components/freertos/include/freertos/timers.h create mode 100644 components/freertos/include/freertos/xtensa_api.h create mode 100644 components/freertos/include/freertos/xtensa_config.h create mode 100644 components/freertos/include/freertos/xtensa_context.h create mode 100644 components/freertos/include/freertos/xtensa_rtos.h create mode 100644 components/freertos/include/freertos/xtensa_timer.h create mode 100644 components/freertos/license.txt create mode 100644 components/freertos/list.c create mode 100644 components/freertos/panic.c create mode 100644 components/freertos/port.c create mode 100644 components/freertos/portasm.S create mode 100644 components/freertos/queue.c create mode 100644 components/freertos/readme_smp.txt create mode 100644 components/freertos/readme_xtensa.txt create mode 100644 components/freertos/stdint.readme create mode 100644 components/freertos/tasks.c create mode 100644 components/freertos/timers.c create mode 100644 components/freertos/xtensa_context.S create mode 100644 components/freertos/xtensa_init.c create mode 100644 components/freertos/xtensa_intr.c create mode 100644 components/freertos/xtensa_intr_asm.S create mode 100644 components/freertos/xtensa_overlay_os_hook.c create mode 100644 components/freertos/xtensa_vectors.S create mode 100644 components/freertos/xtensa_vectors.S-new create mode 100644 components/freertos/xtensa_vectors.S-old create mode 100755 components/lwip/CHANGELOG create mode 100755 components/lwip/COPYING create mode 100644 components/lwip/Kconfig create mode 100755 components/lwip/Makefile create mode 100755 components/lwip/README create mode 100644 components/lwip/VERSION create mode 100755 components/lwip/api/api_lib.c create mode 100755 components/lwip/api/api_msg.c create mode 100755 components/lwip/api/err.c create mode 100755 components/lwip/api/netbuf.c create mode 100755 components/lwip/api/netdb.c create mode 100755 components/lwip/api/netifapi.c create mode 100755 components/lwip/api/pppapi.c create mode 100755 components/lwip/api/sockets.c create mode 100755 components/lwip/api/tcpip.c create mode 100644 components/lwip/apps/dhcpserver.c create mode 100755 components/lwip/core/def.c create mode 100755 components/lwip/core/dns.c create mode 100755 components/lwip/core/inet_chksum.c create mode 100755 components/lwip/core/init.c create mode 100755 components/lwip/core/ip.c create mode 100755 components/lwip/core/ipv4/autoip.c create mode 100755 components/lwip/core/ipv4/dhcp.c create mode 100755 components/lwip/core/ipv4/icmp.c create mode 100755 components/lwip/core/ipv4/igmp.c create mode 100755 components/lwip/core/ipv4/ip4.c create mode 100755 components/lwip/core/ipv4/ip4_addr.c create mode 100755 components/lwip/core/ipv4/ip_frag.c create mode 100755 components/lwip/core/ipv6/README create mode 100755 components/lwip/core/ipv6/dhcp6.c create mode 100755 components/lwip/core/ipv6/ethip6.c create mode 100755 components/lwip/core/ipv6/icmp6.c create mode 100755 components/lwip/core/ipv6/inet6.c create mode 100755 components/lwip/core/ipv6/ip6.c create mode 100755 components/lwip/core/ipv6/ip6_addr.c create mode 100755 components/lwip/core/ipv6/ip6_frag.c create mode 100755 components/lwip/core/ipv6/mld6.c create mode 100755 components/lwip/core/ipv6/nd6.c create mode 100755 components/lwip/core/mem.c create mode 100755 components/lwip/core/memp.c create mode 100755 components/lwip/core/netif.c create mode 100755 components/lwip/core/pbuf.c create mode 100755 components/lwip/core/raw.c create mode 100755 components/lwip/core/stats.c create mode 100755 components/lwip/core/sys.c create mode 100755 components/lwip/core/tcp.c create mode 100755 components/lwip/core/tcp_in.c create mode 100755 components/lwip/core/tcp_out.c create mode 100755 components/lwip/core/timers.c create mode 100755 components/lwip/core/udp.c create mode 100644 components/lwip/include/lwip/apps/dhcpserver.h create mode 100755 components/lwip/include/lwip/lwip/api.h create mode 100755 components/lwip/include/lwip/lwip/arch.h create mode 100755 components/lwip/include/lwip/lwip/autoip.h create mode 100755 components/lwip/include/lwip/lwip/debug.h create mode 100755 components/lwip/include/lwip/lwip/def.h create mode 100755 components/lwip/include/lwip/lwip/dhcp.h create mode 100755 components/lwip/include/lwip/lwip/dhcp6.h create mode 100755 components/lwip/include/lwip/lwip/dns.h create mode 100755 components/lwip/include/lwip/lwip/err.h create mode 100755 components/lwip/include/lwip/lwip/ethip6.h create mode 100755 components/lwip/include/lwip/lwip/icmp.h create mode 100755 components/lwip/include/lwip/lwip/icmp6.h create mode 100755 components/lwip/include/lwip/lwip/igmp.h create mode 100755 components/lwip/include/lwip/lwip/inet.h create mode 100755 components/lwip/include/lwip/lwip/inet_chksum.h create mode 100755 components/lwip/include/lwip/lwip/init.h create mode 100755 components/lwip/include/lwip/lwip/ip.h create mode 100755 components/lwip/include/lwip/lwip/ip4.h create mode 100755 components/lwip/include/lwip/lwip/ip4_addr.h create mode 100755 components/lwip/include/lwip/lwip/ip6.h create mode 100755 components/lwip/include/lwip/lwip/ip6_addr.h create mode 100755 components/lwip/include/lwip/lwip/ip6_frag.h create mode 100755 components/lwip/include/lwip/lwip/ip_addr.h create mode 100755 components/lwip/include/lwip/lwip/ip_frag.h create mode 100755 components/lwip/include/lwip/lwip/mem.h create mode 100755 components/lwip/include/lwip/lwip/memp.h create mode 100755 components/lwip/include/lwip/lwip/mld6.h create mode 100755 components/lwip/include/lwip/lwip/nd6.h create mode 100755 components/lwip/include/lwip/lwip/netbuf.h create mode 100755 components/lwip/include/lwip/lwip/netdb.h create mode 100755 components/lwip/include/lwip/lwip/netif.h create mode 100755 components/lwip/include/lwip/lwip/netifapi.h create mode 100755 components/lwip/include/lwip/lwip/opt.h create mode 100755 components/lwip/include/lwip/lwip/pbuf.h create mode 100755 components/lwip/include/lwip/lwip/pppapi.h create mode 100755 components/lwip/include/lwip/lwip/priv/api_msg.h create mode 100755 components/lwip/include/lwip/lwip/priv/memp_priv.h create mode 100755 components/lwip/include/lwip/lwip/priv/memp_std.h create mode 100755 components/lwip/include/lwip/lwip/priv/tcp_priv.h create mode 100755 components/lwip/include/lwip/lwip/priv/tcpip_priv.h create mode 100755 components/lwip/include/lwip/lwip/raw.h create mode 100755 components/lwip/include/lwip/lwip/sio.h create mode 100755 components/lwip/include/lwip/lwip/snmp.h create mode 100755 components/lwip/include/lwip/lwip/sockets.h create mode 100755 components/lwip/include/lwip/lwip/stats.h create mode 100755 components/lwip/include/lwip/lwip/sys.h create mode 100755 components/lwip/include/lwip/lwip/tcp.h create mode 100755 components/lwip/include/lwip/lwip/tcpip.h create mode 100755 components/lwip/include/lwip/lwip/timers.h create mode 100755 components/lwip/include/lwip/lwip/udp.h create mode 100755 components/lwip/include/lwip/netif/etharp.h create mode 100755 components/lwip/include/lwip/netif/ethernet.h create mode 100755 components/lwip/include/lwip/netif/lowpan6.h create mode 100755 components/lwip/include/lwip/netif/lowpan6_opts.h create mode 100755 components/lwip/include/lwip/netif/ppp/ccp.h create mode 100755 components/lwip/include/lwip/netif/ppp/chap-md5.h create mode 100755 components/lwip/include/lwip/netif/ppp/chap-new.h create mode 100755 components/lwip/include/lwip/netif/ppp/chap_ms.h create mode 100755 components/lwip/include/lwip/netif/ppp/eap.h create mode 100755 components/lwip/include/lwip/netif/ppp/ecp.h create mode 100755 components/lwip/include/lwip/netif/ppp/eui64.h create mode 100755 components/lwip/include/lwip/netif/ppp/fsm.h create mode 100755 components/lwip/include/lwip/netif/ppp/ipcp.h create mode 100755 components/lwip/include/lwip/netif/ppp/ipv6cp.h create mode 100755 components/lwip/include/lwip/netif/ppp/lcp.h create mode 100755 components/lwip/include/lwip/netif/ppp/magic.h create mode 100755 components/lwip/include/lwip/netif/ppp/mppe.h create mode 100755 components/lwip/include/lwip/netif/ppp/polarssl/arc4.h create mode 100755 components/lwip/include/lwip/netif/ppp/polarssl/des.h create mode 100755 components/lwip/include/lwip/netif/ppp/polarssl/md4.h create mode 100755 components/lwip/include/lwip/netif/ppp/polarssl/md5.h create mode 100755 components/lwip/include/lwip/netif/ppp/polarssl/sha1.h create mode 100755 components/lwip/include/lwip/netif/ppp/ppp.h create mode 100755 components/lwip/include/lwip/netif/ppp/ppp_impl.h create mode 100755 components/lwip/include/lwip/netif/ppp/pppcrypt.h create mode 100755 components/lwip/include/lwip/netif/ppp/pppdebug.h create mode 100755 components/lwip/include/lwip/netif/ppp/pppoe.h create mode 100755 components/lwip/include/lwip/netif/ppp/pppol2tp.h create mode 100755 components/lwip/include/lwip/netif/ppp/pppos.h create mode 100755 components/lwip/include/lwip/netif/ppp/upap.h create mode 100755 components/lwip/include/lwip/netif/ppp/vj.h create mode 100755 components/lwip/include/lwip/netif/slipif.h create mode 100644 components/lwip/include/lwip/port/arch/cc.h create mode 100644 components/lwip/include/lwip/port/arch/perf.h create mode 100644 components/lwip/include/lwip/port/arch/sys_arch.h create mode 100755 components/lwip/include/lwip/port/lwipopts.h create mode 100755 components/lwip/include/lwip/port/netif/wlanif.h create mode 100755 components/lwip/include/lwip/posix/netdb.h create mode 100755 components/lwip/include/lwip/posix/sys/socket.h create mode 100755 components/lwip/netif/FILES create mode 100755 components/lwip/netif/etharp.c create mode 100755 components/lwip/netif/ethernet.c create mode 100755 components/lwip/netif/ethernetif.c create mode 100755 components/lwip/netif/lowpan6.c create mode 100755 components/lwip/netif/ppp/PPPD_FOLLOWUP create mode 100755 components/lwip/netif/ppp/auth.c create mode 100755 components/lwip/netif/ppp/ccp.c create mode 100755 components/lwip/netif/ppp/chap-md5.c create mode 100755 components/lwip/netif/ppp/chap-new.c create mode 100755 components/lwip/netif/ppp/chap_ms.c create mode 100755 components/lwip/netif/ppp/demand.c create mode 100755 components/lwip/netif/ppp/eap.c create mode 100755 components/lwip/netif/ppp/ecp.c create mode 100755 components/lwip/netif/ppp/eui64.c create mode 100755 components/lwip/netif/ppp/fsm.c create mode 100755 components/lwip/netif/ppp/ipcp.c create mode 100755 components/lwip/netif/ppp/ipv6cp.c create mode 100755 components/lwip/netif/ppp/lcp.c create mode 100755 components/lwip/netif/ppp/magic.c create mode 100755 components/lwip/netif/ppp/mppe.c create mode 100755 components/lwip/netif/ppp/multilink.c create mode 100755 components/lwip/netif/ppp/polarssl/README create mode 100755 components/lwip/netif/ppp/polarssl/arc4.c create mode 100755 components/lwip/netif/ppp/polarssl/des.c create mode 100755 components/lwip/netif/ppp/polarssl/md4.c create mode 100755 components/lwip/netif/ppp/polarssl/md5.c create mode 100755 components/lwip/netif/ppp/polarssl/sha1.c create mode 100755 components/lwip/netif/ppp/ppp.c create mode 100755 components/lwip/netif/ppp/pppcrypt.c create mode 100755 components/lwip/netif/ppp/pppoe.c create mode 100755 components/lwip/netif/ppp/pppol2tp.c create mode 100755 components/lwip/netif/ppp/pppos.c create mode 100755 components/lwip/netif/ppp/upap.c create mode 100755 components/lwip/netif/ppp/utils.c create mode 100755 components/lwip/netif/ppp/vj.c create mode 100755 components/lwip/netif/slipif.c create mode 100755 components/lwip/port/freertos/sys_arch.c create mode 100755 components/lwip/port/netif/wlanif.c create mode 100644 components/newlib/.gitignore create mode 100644 components/newlib/.gitmodules create mode 100644 components/newlib/COPYING.NEWLIB create mode 100644 components/newlib/Makefile create mode 100644 components/newlib/Makefile.old create mode 100644 components/newlib/include/_ansi.h create mode 100644 components/newlib/include/_syslist.h create mode 100644 components/newlib/include/alloca.h create mode 100644 components/newlib/include/ar.h create mode 100644 components/newlib/include/argz.h create mode 100644 components/newlib/include/assert.h create mode 100644 components/newlib/include/complex.h create mode 100644 components/newlib/include/config.h create mode 100644 components/newlib/include/ctype.h create mode 100644 components/newlib/include/dirent.h create mode 100644 components/newlib/include/envlock.h create mode 100644 components/newlib/include/envz.h create mode 100644 components/newlib/include/errno.h create mode 100644 components/newlib/include/fastmath.h create mode 100644 components/newlib/include/fcntl.h create mode 100644 components/newlib/include/fenv.h create mode 100644 components/newlib/include/fnmatch.h create mode 100644 components/newlib/include/getopt.h create mode 100644 components/newlib/include/glob.h create mode 100644 components/newlib/include/grp.h create mode 100644 components/newlib/include/iconv.h create mode 100644 components/newlib/include/ieeefp.h create mode 100644 components/newlib/include/inttypes.h create mode 100644 components/newlib/include/langinfo.h create mode 100644 components/newlib/include/libgen.h create mode 100644 components/newlib/include/limits.h create mode 100644 components/newlib/include/locale.h create mode 100644 components/newlib/include/machine/_default_types.h create mode 100644 components/newlib/include/machine/_types.h create mode 100644 components/newlib/include/machine/ansi.h create mode 100644 components/newlib/include/machine/endian.h create mode 100644 components/newlib/include/machine/fastmath.h create mode 100644 components/newlib/include/machine/ieeefp.h create mode 100644 components/newlib/include/machine/malloc.h create mode 100644 components/newlib/include/machine/param.h create mode 100644 components/newlib/include/machine/setjmp-dj.h create mode 100644 components/newlib/include/machine/setjmp.h create mode 100644 components/newlib/include/machine/stdlib.h create mode 100644 components/newlib/include/machine/termios.h create mode 100644 components/newlib/include/machine/time.h create mode 100644 components/newlib/include/machine/types.h create mode 100644 components/newlib/include/malloc.h create mode 100644 components/newlib/include/math.h create mode 100644 components/newlib/include/newlib.h create mode 100644 components/newlib/include/paths.h create mode 100644 components/newlib/include/pthread.h create mode 100644 components/newlib/include/pwd.h create mode 100644 components/newlib/include/reent.h create mode 100644 components/newlib/include/regdef.h create mode 100644 components/newlib/include/regex.h create mode 100644 components/newlib/include/sched.h create mode 100644 components/newlib/include/search.h create mode 100644 components/newlib/include/setjmp.h create mode 100644 components/newlib/include/signal.h create mode 100644 components/newlib/include/spawn.h create mode 100644 components/newlib/include/stdatomic.h create mode 100644 components/newlib/include/stdint.h create mode 100644 components/newlib/include/stdio.h create mode 100644 components/newlib/include/stdio_ext.h create mode 100644 components/newlib/include/stdlib.h create mode 100644 components/newlib/include/string.h create mode 100644 components/newlib/include/strings.h create mode 100644 components/newlib/include/sys/_default_fcntl.h create mode 100644 components/newlib/include/sys/_intsup.h create mode 100644 components/newlib/include/sys/_types.h create mode 100644 components/newlib/include/sys/cdefs.h create mode 100644 components/newlib/include/sys/config.h create mode 100644 components/newlib/include/sys/custom_file.h create mode 100644 components/newlib/include/sys/dir.h create mode 100644 components/newlib/include/sys/dirent.h create mode 100644 components/newlib/include/sys/errno.h create mode 100644 components/newlib/include/sys/fcntl.h create mode 100644 components/newlib/include/sys/features.h create mode 100644 components/newlib/include/sys/file.h create mode 100644 components/newlib/include/sys/iconvnls.h create mode 100644 components/newlib/include/sys/lock.h create mode 100644 components/newlib/include/sys/param.h create mode 100644 components/newlib/include/sys/queue.h create mode 100644 components/newlib/include/sys/reent.h create mode 100644 components/newlib/include/sys/resource.h create mode 100644 components/newlib/include/sys/sched.h create mode 100644 components/newlib/include/sys/signal.h create mode 100644 components/newlib/include/sys/stat.h create mode 100644 components/newlib/include/sys/stdio.h create mode 100644 components/newlib/include/sys/string.h create mode 100644 components/newlib/include/sys/syslimits.h create mode 100644 components/newlib/include/sys/time.h create mode 100644 components/newlib/include/sys/timeb.h create mode 100644 components/newlib/include/sys/times.h create mode 100644 components/newlib/include/sys/types.h create mode 100644 components/newlib/include/sys/unistd.h create mode 100644 components/newlib/include/sys/utime.h create mode 100644 components/newlib/include/sys/wait.h create mode 100644 components/newlib/include/tar.h create mode 100644 components/newlib/include/termios.h create mode 100644 components/newlib/include/tgmath.h create mode 100644 components/newlib/include/time.h create mode 100644 components/newlib/include/unctrl.h create mode 100644 components/newlib/include/unistd.h create mode 100644 components/newlib/include/utime.h create mode 100644 components/newlib/include/utmp.h create mode 100644 components/newlib/include/wchar.h create mode 100644 components/newlib/include/wctype.h create mode 100644 components/newlib/include/wordexp.h create mode 100644 components/newlib/include/xtensa/config/core-isa.h create mode 100644 components/newlib/lib/extracted/romsyms create mode 100755 components/newlib/lib/fixlibc.sh create mode 100644 components/newlib/lib/libc-minusrom.a create mode 100644 components/newlib/lib/libc.a create mode 100644 components/newlib/lib/libc_rom.a create mode 100644 components/newlib/lib/libg.a create mode 100644 components/newlib/lib/libm.a create mode 100644 components/newlib/libc_discard.list create mode 100644 components/nvs_flash/.gitignore create mode 100755 components/nvs_flash/Makefile create mode 100644 components/nvs_flash/README.rst create mode 100644 components/nvs_flash/include/nvs.h create mode 100644 components/nvs_flash/include/nvs_flash.h create mode 100644 components/nvs_flash/src/compressed_enum_table.hpp create mode 100644 components/nvs_flash/src/intrusive_list.h create mode 100644 components/nvs_flash/src/nvs.hpp create mode 100644 components/nvs_flash/src/nvs_api.cpp create mode 100644 components/nvs_flash/src/nvs_page.cpp create mode 100644 components/nvs_flash/src/nvs_page.hpp create mode 100644 components/nvs_flash/src/nvs_pagemanager.cpp create mode 100644 components/nvs_flash/src/nvs_pagemanager.hpp create mode 100644 components/nvs_flash/src/nvs_platform.hpp create mode 100644 components/nvs_flash/src/nvs_storage.cpp create mode 100644 components/nvs_flash/src/nvs_storage.hpp create mode 100644 components/nvs_flash/src/nvs_types.cpp create mode 100644 components/nvs_flash/src/nvs_types.hpp create mode 100644 components/nvs_flash/test/Makefile create mode 100644 components/nvs_flash/test/catch.hpp create mode 100644 components/nvs_flash/test/crc.cpp create mode 100644 components/nvs_flash/test/crc.h create mode 100644 components/nvs_flash/test/main.cpp create mode 100644 components/nvs_flash/test/spi_flash_emulation.cpp create mode 100644 components/nvs_flash/test/spi_flash_emulation.h create mode 100644 components/nvs_flash/test/test_compressed_enum_table.cpp create mode 100644 components/nvs_flash/test/test_intrusive_list.cpp create mode 100644 components/nvs_flash/test/test_nvs.cpp create mode 100644 components/nvs_flash/test/test_spi_flash_emulation.cpp create mode 100644 components/partition_table/Kconfig.projbuild create mode 100644 components/partition_table/Makefile.projbuild create mode 100644 components/partition_table/partitions_singleapp.csv create mode 100644 components/partition_table/partitions_two_ota.csv create mode 100755 components/partition_table/tests/gen_esp32part_tests.py create mode 100755 components/spi_flash/Makefile create mode 100644 components/spi_flash/esp_spi_flash.c create mode 100644 components/spi_flash/include/esp_spi_flash.h create mode 100755 components/tcpip_adapter/Makefile create mode 100644 components/tcpip_adapter/include/tcpip_adapter.h create mode 100644 components/tcpip_adapter/tcpip_adapter_lwip.c create mode 100644 docs/COPYRIGHT.rst create mode 100644 docs/eclipse-setup.rst create mode 100644 docs/windows-setup.rst create mode 100644 make/common.mk create mode 100644 make/component.mk create mode 100644 make/project.mk create mode 100644 make/project_config.mk create mode 100755 tools/gen_esp32part.py create mode 100644 tools/kconfig/.gitignore create mode 100644 tools/kconfig/Kconfig create mode 100644 tools/kconfig/Makefile create mode 100644 tools/kconfig/POTFILES.in create mode 100755 tools/kconfig/check.sh create mode 100644 tools/kconfig/conf.c create mode 100644 tools/kconfig/confdata.c create mode 100644 tools/kconfig/expr.c create mode 100644 tools/kconfig/expr.h create mode 100644 tools/kconfig/gconf.c create mode 100644 tools/kconfig/gconf.glade create mode 100644 tools/kconfig/images.c create mode 100644 tools/kconfig/kconfig-language.txt create mode 100644 tools/kconfig/kxgettext.c create mode 100644 tools/kconfig/list.h create mode 100644 tools/kconfig/lkc.h create mode 100644 tools/kconfig/lkc_proto.h create mode 100644 tools/kconfig/lxdialog/.gitignore create mode 100644 tools/kconfig/lxdialog/BIG.FAT.WARNING create mode 100755 tools/kconfig/lxdialog/check-lxdialog.sh create mode 100644 tools/kconfig/lxdialog/checklist.c create mode 100644 tools/kconfig/lxdialog/dialog.h create mode 100644 tools/kconfig/lxdialog/inputbox.c create mode 100644 tools/kconfig/lxdialog/menubox.c create mode 100644 tools/kconfig/lxdialog/textbox.c create mode 100644 tools/kconfig/lxdialog/util.c create mode 100644 tools/kconfig/lxdialog/yesno.c create mode 100644 tools/kconfig/mconf.c create mode 100644 tools/kconfig/menu.c create mode 100755 tools/kconfig/merge_config.sh create mode 100644 tools/kconfig/nconf.c create mode 100644 tools/kconfig/nconf.gui.c create mode 100644 tools/kconfig/nconf.h create mode 100644 tools/kconfig/qconf.cc create mode 100644 tools/kconfig/qconf.h create mode 100755 tools/kconfig/streamline_config.pl create mode 100644 tools/kconfig/symbol.c create mode 100644 tools/kconfig/util.c create mode 100644 tools/kconfig/zconf.gperf create mode 100644 tools/kconfig/zconf.l create mode 100644 tools/kconfig/zconf.y create mode 100755 tools/tests/gen_esp32part_tests.py create mode 100644 tools/windows/ctng-toolchain-linux64-win32-canadian-build.conf create mode 100755 tools/windows/windows_install_prerequisites.sh diff --git a/.gitignore b/.gitignore new file mode 100644 index 000000000..48230f569 --- /dev/null +++ b/.gitignore @@ -0,0 +1,14 @@ +.config +*.o +*.pyc + +# gtags +GTAGS +GRTAGS +GPATH + +# emacs temp file suffixes +*~ +.#* +\#*# + diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 000000000..174c4c70b --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "components/esp32/lib"] + path = components/esp32/lib + url = ssh://git@github.com:espressif/esp32-wifi-lib.git diff --git a/Kconfig b/Kconfig new file mode 100644 index 000000000..f3cfbef10 --- /dev/null +++ b/Kconfig @@ -0,0 +1,63 @@ +# +# For a description of the syntax of this configuration file, +# see kconfig/kconfig-language.txt. +# +mainmenu "Espressif ESP32 SDK Configuration" + + +menu "SDK tool configuration" +config TOOLPREFIX + string "Compiler toolchain path/prefix" + default "xtensa-esp32-elf-" + help + The prefix/path that is used to call the toolchain. The default setting assumes + a crosstool-ng gcc setup that is in your PATH. + +config PYTHON + string "Python 2 interpreter" + default "python" + help + The executable name/path that is used to run python. On some systems Python 2.x + may need to be invoked as python2. + +config MEMMAP_BT + bool "Reserve space for Bluetooth stack" + default "n" + help + The Bluetooth stack uses memory that cannot be used as generic memory anymore. This + reserves the space for that within the memory map of the compiled binary. + +config MEMMAP_SMP + bool "Reserve memory for two cores" + default "y" + help + The ESP32 contains two cores. If you plan to only use one, you can disable this item + to save some memory. (ToDo: Make this automatically depend on unicore support) + +config MEMMAP_TRACEMEM + bool "Use TRAX tracing feature" + default "n" + help + The ESP32 contains a feature which allows you to trace the execution path the processor + has taken through the program. This is stored in a chunk of 32K (16K for single-processor) + of memory that can't be used for general purposes anymore. Disable this if you do not know + what this is. + +config MEMMAP_SPISRAM + bool "Use external SPI SRAM chip as main memory" + default "n" + help + The ESP32 can control an external SPI SRAM chip, adding the memory it contains to the + main memory map. Enable this if you have this hardware and want to use it in the same + way as on-chip RAM. + +endmenu + +source "$COMPONENT_KCONFIGS_PROJBUILD" + +menu "Component config" +source "$COMPONENT_KCONFIGS" +endmenu + + + diff --git a/LICENSE b/LICENSE new file mode 100644 index 000000000..d64569567 --- /dev/null +++ b/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + 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. diff --git a/README.buildenv b/README.buildenv new file mode 100644 index 000000000..249268c48 --- /dev/null +++ b/README.buildenv @@ -0,0 +1,265 @@ +The build structure of the Espressif IoT Development Framework explained. + +An ESP-IDF project can be seen as an almagation of a number of components. +For example, for a webserver that shows the current humidity, we would +have: +- The ESP32 base libraries (libc, rom bindings etc) +- The WiFi drivers +- A TCP/IP stack +- The FreeRTOS operating system +- A webserver +- A driver for an humidity sensor +- Main code tying it all together + +ESP-IDF makes these components explicit and configurable. To do that, when a project +is compiled, the build environment will look up all the components in the +SDK directories, the project directories and optionally custom other component +directories. It then allows the user to configure compile-time options using +a friendly text-based menu system to customize the SDK as well as other components +to the requirements of the project. After the components are customized, the +build process will compile everything into an output file, which can then be uploaded +into a board in a way that can also be defined by components. + +A project in this sense is defined as a directory under which all the files required +to build it live, excluding the SDK files and the toolchain. A simple project +tree looks like this: + +- myProject/ - build/ + - components/ - component1/ - Makefile + - Kconfig + - src1.c + - component2/ - Makefile + - Kconfig + - src1.c + - main/ - src1.c + - src2.c + - Makefile + + +As we can see, a project consists of a components/ subdirectory containing its +components as well as one or more directories containing the project-specific +sources; by default a single directory called 'main' is assumed. The project +directory will also have a Makefile where the projects name as well as optionally +other options are defined. After compilation, the project directory will contain +a 'build'-directory containing all of the objects, libraries and other generated +files as well as the final binary. + +Components also have a Makefile containing various definititions influencing +the build process of the component as well as the project it's used in, as +well as a Kconfig file defining the compile-time options that are settable +by means of the menu system. + + +Project makefile variables that can be set by the programmer: +PROJECT_NAME: Mandatory. Name for the project +BUILD_DIR_BASE: Set the directory where all objects/libraries/binaries end up in. + Defaults to $(PROJECT_PATH)/build +COMPONENT_DIRS: Search path for components. Defaults to the component/ directories + in the SDK path and the project path. +COMPONENTS: A list of component names. Defaults to all the component found in the + COMPONENT_DIRS directory +EXTRA_COMPONENT_DIRS: Defaults to unset. Use this to add directories to the default + COMPONENT_DIRS. +SRCDIRS: Directories under the project dir containing project-specific sources. + Defaults to 'main'. These are treated as 'lite' components: they do not have + include directories that are passed to the compilation pass of all components and + they do not have a Kconfig option. + + +Component makefile variables that can be set by the programmer: +COMPONENT_ADD_INCLUDEDIRS: Relative path to include directories to be added to + the entire project +COMPONENT_PRIV_INCLUDEDIRS: Relative path to include directories that are only used + when compiling this specific component +COMPONENT_DEPENDS: Names of any components that need to be compiled before this component. +COMPONENT_ADD_LDFLAGS: Ld flags to add for this project. Defaults to -l$(COMPONENT_NAME). + Add libraries etc in the current directory as $(abspath libwhatever.a) +COMPONENT_EXTRA_INCLUDES: Any extra include paths. These will be prefixed with '-I' and + passed to the compiler; please put absolute paths here. +COMPONENT_SRCDIRS: Relative directories to look in for sources. Defaults to '.', the current + directory (the root of the component) only. Use this to specify any subdirectories. Note + that specifying this overwrites the default action of compiling everything in the + components root dir; to keep this behaviour please also add '.' as a directory in this + list. +COMPONENT_OBJS: Object files to compile. Defaults to the .o variants of all .c and .S files + that are found in COMPONENT_SRCDIRS. +COMPONENT_EXTRA_CLEAN: Files that are generated using rules in the components Makefile + that also need to be cleaned +COMPONENT_BUILDRECIPE: Recipe to build the component. Optional. Defaults to building all + COMPONENT_OBJS and linking them into lib(componentname).a +COMPONENT_CLEANRECIPE: Recipe to clean the component. Optional. Defaults to removing + all built objects and libraries. +COMPONENT_BUILD_DIR: Equals the cwd of the component build, which is the build dir + of the component (where all the .o etc files should be created). + + +These variables are already set early on in the Makefile and the values in it will +be usable in component or project Makefiles: +CC, LD, AR, OBJCOPY: Xtensa gcc tools +HOSTCC, HOSTLD etc: Host gcc tools +LDFLAGS, CFLAGS: Set to usable values as defined in SDK Makefile +PROJECT_NAME: Name of the project, as set in project makefile +PROJECT_PATH: Path to the root of the project folder +COMPONENTS: Name of the components to be included +CONFIG_*: Values set by 'make menuconfig' also have corresponding Makefile variables. + +For components, there also are these defines: +COMPONENT_PATH: Absolute path to the root of the source tree of the component we're + compiling +COMPONENT_LIBRARY: The full path to the static library the components compilation pass + is supposed to generate + + +How this works: +The Make process is always invoked from the project directory by the +user; invoking it anywhere else gives an error. This is what happens if +we build a binary: + +The Makefile first determines how it was included. It determines it was +included as a project file in this case and will continue to figure out +various paths as well as the components available to it. It will also +collect the ldflags and includes that the components specify they need. +It does this by running a dummy Make on the components with a target that +will output these values. + +The Makefile will then create targets to build the lib*.a libraries of +all components and make the elf target depend on this. The targets +invoke Make on the makefiles of the components in a subshell: this way +the components have full freedom to do whatever is necessary to build +the library without influencing other components. By default, the +component includes the utility makefile $(SDK_PATH)/make/component.mk. +This provides default targets and configurations that will work +out-of-the-box for most projects. + +For components that have parts that need to be run when building of the +project is done, you can create a file called Makefile.projbuild in the +component root directory. This file will be included in the main +Makefile. For the menu, there's an equivalent: if you want to include +options not in the 'components' submenu, create a Kconfig.projbuild and +it will be included in the main menu of menuconfig. Take good care when +(re)defining stuff here: because it's included with all the other +.projbuild files, it's possible to overwrite variables or re-declare +targets defined in the SDK makefile/Kconfig and other .projbuild files + + +WRITING COMPONENT MAKEFILES + +A component consists of a directory which doubles as the name for the +component: a component named 'httpd' lives in a directory called 'httpd' +Because components usually live under the project directory (although +they can also reside in an other folder), the path to this may be +something like /home/myuser/projects/myprojects/components/httpd . + +One of the things that most components will have is a Makefile, +containing instructions on how to build the component. Because the +build environment tries to set reasonable defaults that will work most +of the time, a component Makefile can be pretty small. At the absolute +minimum, it will just include the SDK component makefile, which adds +component functionality: + +----8<---- +include $(SDK_PATH)/make/component.mk +---->8---- + +This will take all the .c and .S files in the component root and compile +them into object files, finally linking them into a library. +Subdirectories are ignored; if your project has sources in subdirectories +instead of in the root of the component, you can tell that to the build +system by setting COMPONENT_SRCDIRS: + +----8<---- +COMPONENT_SRCDIRS := src1 src2 +include $(SDK_PATH)/make/component.mk +---->8---- + +This will compile all source files in the src1/ and src2/ subdirectories +instead. + +The standard component.mk logic adds all .S and .c files in the source +directories as sources to be compiled unconditionally. It is possible +to circumvent that logic and hardcode the objects to be compiled by +manually setting the COMPONENT_OBJS variable to the name of the +objects that need to be generated: + +----8<---- +COMPONENT_OBJS := file1.o file2.o thing/filea.o thing/fileb.o anotherthing/main.o +include $(SDK_PATH)/make/component.mk +---->8---- + +This can also be used in order to conditionally compile some files +dependent on the options selected in the Makefile: + +Kconfig: +----8<---- +config FOO_ENABLE_BAR + bool "Enable the BAR feature." + help + This enables the BAR feature of the FOO component. +---->8---- + +Makefile: +----8<---- +COMPONENT_OBJS := foo_a.o foo_b.o $(if $(CONFIG_FOO_ENABLE_BAR),foo_bar.o foo_bar_interface.o) +include $(SDK_PATH)/make/component.mk +---->8---- + +Some components will have a situation where a source file isn't supplied +with the component itself but has to be generated from another file. Say +our component has a header file that consists of the converted binary +data of a BMP file, converted using a hypothetical tool called bmp2h. The +header file is then included in as C source file called graphics_lib.c. + +----8<---- +COMPONENT_EXTRA_CLEAN := logo.h + +graphics_lib.o: logo.h + +logo.h: $(COMPONENT_PATH)/logo.bmp + bmp2h -i $^ -o $@ + +include $(SDK_PATH)/make/component.mk +---->8---- + +In this example, graphics_lib.o and logo.h will be generated in the +current directory (the build directory) while logo.bmp comes with the +component and resides under the component path. Because logo.h is a +generated file, it needs to be cleaned when make clean is called which +why it is added to the COMPONENT_EXTRA_CLEAN variable. + + +This will work just fine, but there's one last cosmetic improvement that +can be done. The SDK make system tries to make the make process somewhat +easier on the eyes by hiding the commands (unless you run make with the +V=1 switch) and this does not do that yet. Here's an improved version +that will output in the same style as the rest of the make process: + +----8<---- +COMPONENT_EXTRA_CLEAN := test_tjpgd_logo.h + +graphics_lib.o: logo.h + +logo.h: $(COMPONENT_PATH)/logo.bmp + $(vecho) BMP2H $@ + $(Q) bmp2h -i $^ -o $@ + +include $(SDK_PATH)/make/component.mk +---->8---- + +Obviously, there are cases where all these recipes are insufficient for a +certain component, for example when the component is basically a wrapper +around another third-party component not originally intended to be +compiled under this build system. In that case, it's possible to forego +the build system entirely by setting COMPONENT_OWNBUILDTARGET and +possibly COMPONENT_OWNCLEANTARGET and defining your own build- and clean +target. The build target can do anything as long as it creates +$(COMPONENT_LIBRARY) for the main file to link into the project binary, +and even that is not necessary: if the COMPONENT_ADD_LDFLAGS variable +is set, the component can instruct the linker to do anything else as well. + + + + + + + + diff --git a/README.md b/README.md new file mode 100644 index 000000000..42b5ee7e8 --- /dev/null +++ b/README.md @@ -0,0 +1,151 @@ +# Using Espressif IoT Development Framework with the ESP32 + +# Prerequisites + +# Configuring your project + +`make menuconfig` + +# Compiling your project + +`make app` + +# Flashing the Bootloader + +ESP32 has a bootloader in ROM which runs after reset, but ESP-IDF also uses a second stage software bootloader. The ROM bootloader loads the software bootloader, which then loads the firmware app of the ESP32. The software bootloader must be flashed to offset 0x5000 in the flash. + +To build the software bootloader, navigate to your project's top-level directory and run: + +``` shell +make bootloader +``` + +If you've configured the serial port details in `make menuconfig`, then + +``` shell +make bootloader-flash +``` + +... will automatically run esptool.py to flash the image. Otherwise, you can customise the `esptool.py` command that is printed out as part of `make bootloader`. + +You only need to flash the ESP32 bootloader once. + +# The Partition Table + +Once you've compiled your project, the "build" directory will contain a binary file with a name like "my_app.bin". This is an ESP32 image binary that can be loaded by the bootloader. + +A single ESP32's flash can contain multiple apps, as well as many different kinds of data (calibration data, filesystems, parameter storage, etc). For this reason a partition table is flashed to offset 0x4000 in the flash. + +Each entry in the partition table has a name (label), type (app, data, or something else), subtype and the offset in flash where the partition is loaded. + +The simplest way to use the partition table is to `make menuconfig` and choose one of the simple predefined partition tables: + +* "Single factory app, no OTA" +* "Factory app, two OTA definitions" + +In both cases the factory app is flashed at offset 0x10000. If you `make partition_table` then it will print a summary of the partition table. + +Here is the summary printed for the "Single factory app, no OTA" configuration: + +``` +# Espressif ESP32 Partition Table +# Name, Type, SubType, Offset, Size +factory, app, factory, 0x10000, 1M +rfdata, data, rf, 0x110000, 256K +wifidata,data, wifi, 0x150000, 256K +``` + +* At a 0x10000 (64KB) offset in the flash is the app labelled "factory". The bootloader will run this app by default. +* There are also two data regions defined in the partition table for storing RF & Wifi calibration data. + +Here is the summary printed for the "Factory app, two OTA definitions" configuration: + +``` +# Espressif ESP32 Partition Table +# Name, Type, SubType, Offset, Size +factory, app, factory, 0x10000, 1M +ota_0, app, ota_0, 0x110000, 1M +ota_1, app, ota_1, 0x210000, 1M +rfdata, data, rf, 0x310000, 256K +wifidata,data, wifi, 0x350000, 256K +otadata, data, ota, 0x390000, 256K +``` + +* There are now three app partition definitions. +* The type of all three are set as "app", but the subtype varies between the factory app at 0x10000 and the next two "OTA" apps. +* There is also a new "ota data" slot, which holds the data for OTA updates. The bootloader consults this data in order to know which app to execute. If "ota data" is empty, it will execute the factory app. + + +## Creating Custom Tables + +If you choose "Custom partition table CSV" in menuconfig then you can also enter the name of a CSV file (in the project directory) to use for your partition table. The CSV file can describe any number of definitions for the table you need. + +The CSV format is the same format as printed in the summaries shown above. However, not all fields are required in the CSV. For example, here is the "input" CSV for the OTA partition table: + +``` +# Name, Type, SubType, Offset, Size +factory, app, factory, 0x10000, 1M +ota_0, app, ota_0, , 1M +ota_1, app, ota_1, , 1M +rfdata, data, rf, , 256K +wifidata, data, wifi, , 256K +otadata, data, ota, , 256K +``` + +* Whitespace between fields is ignored, and so is any line starting with # (comments). +* Each non-comment line in the CSV file is a partition definition. +* Only the offset for the first partition is supplied. The gen_esp32part.py tool fills in each remaining offset to start after the preceding partition. + +### Name field + +Name field can be any meaningful name. It is not significant to the ESP32. Names longer than 16 characters will be truncated. + +### Type field + +Type field can be specified as app (0) or data (1). Or it can be a number 0-254 (or as hex 0x00-0xFE). Types 0x00-0x3F are reserved for Espressif. If your application needs to store data, please add a custom partition type in the range 0x40-0xFE. + +The bootloader ignores any types other than 0 & 1. + +### Subtype + +When type is "app", the subtype field can be specified as factory (0), ota_0 (0x10) ... ota_15 (0x1F) and test (0x20). Or it can be any number 0-255 (0x00-0xFF). The bootloader will execute the factory app unless there it sees a partition of type data/ota, in which case it reads this partition to determine which OTA image to boot + +When type is "data", the subtype field can be specified as ota (0), rf (1), wifi (2). Or it can be a number 0x00-0xFF. The bootloader ignores all data subtypes except for ota. Other "data" subtypes are reserved for Espressif use. To create custom data partition subtypes then use a custom type value, and choose any subtype 0x00-0xFF. + +### Offset & Size + +Only the first offset field is required (we recommend using 0x10000). Partitions with blank offsets will start after the previous partition. + +App partitions have to be at offsets aligned to 0x10000 (64K). If you leave the offset field blank, the tool will automatically align the partition. If you specify an unaligned offset for an app partition, the tool will return an error. + +Sizes and offsets can be specified as decimal numbers, hex numbers with the prefix 0x, or size multipliers M or K (1024 and 1024*1024 bytes). + +## Generating Binary Partition Table + +The partition table which is flashed to the ESP32 is in a binary format, not CSV. The tool components/partition_table/gen_esp32part.py is used to convert between CSV and binary formats. + +If you configure the partition table CSV name in `make menuconfig` and then `make partition_table`, this conversion is done for you. + +To convert CSV to Binary manually: + +``` shell +python components/partition_table/gen_esp32part.py --verify input_partitions.csv binary_partitions.bin +``` + +To convert binary format back to CSV: + +``` shell +python components/partition_table/gen_esp32part.py --verify binary_partitions.bin input_partitions.csv +``` + +To display the contents of a binary partition table on stdout (this is how the summaries displayed when running `make partition_table` are generated: + +``` shell +python components/partition_table/gen_esp32part.py binary_partitions.bin +``` + +`gen_esp32part.py` takes one optional argument, `--verify`, which will also verify the partition table during conversion (checking for overlapping partitions, unaligned partitions, etc.) + +# Flashing the partition table + +The command `make partition_table-flash` will flash the partition table with esptool.py. However a manual flashing command is printed as part of `make partition_table`. diff --git a/bin/eclipse_windows_make.sh b/bin/eclipse_windows_make.sh new file mode 100755 index 000000000..115ecac2f --- /dev/null +++ b/bin/eclipse_windows_make.sh @@ -0,0 +1,9 @@ +#!/bin/bash +# A wrapper for make on Windows with Eclipse +# +# Eclipse's output parser expects to see output of the form C:/dir/dir/file but our Make +# process uses MinGW paths of the form /c/dir/dir/file. So parse these out... +# +# (regexp deliberate only matches after a space character to try and avoid false-positives.) +echo "Running make in $(dirname $0)" +make $@ V=1 | sed -E "s@ /([a-z])/(.+)/@ \1:/\2/@g" | sed -E "s@-I/([a-z])/(.+)/@-I\1:/\2/@g" | sed -E "s@-L/([a-z])/(.+)/@-L\1:/\2/@g" diff --git a/bin/esptool.py b/bin/esptool.py new file mode 100755 index 000000000..345fb2fd9 --- /dev/null +++ b/bin/esptool.py @@ -0,0 +1,1800 @@ +#!/usr/bin/env python +# NB: Before sending a PR to change the above line to '#!/usr/bin/env python2', please read https://github.com/themadinventor/esptool/issues/21 +# +# ESP8266 ROM Bootloader Utility +# https://github.com/themadinventor/esptool +# +# Copyright (C) 2014-2016 Fredrik Ahlberg, Angus Gratton, other contributors as noted. +# ESP31/32 support Copyright (C) 2016 Angus Gratton, based in part on work Copyright +# (C) 2015-2016 Espressif Systems. +# +# This program is free software; you can redistribute it and/or modify it under +# the terms of the GNU General Public License as published by the Free Software +# Foundation; either version 2 of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License along with +# this program; if not, write to the Free Software Foundation, Inc., 51 Franklin +# Street, Fifth Floor, Boston, MA 02110-1301 USA. + +import argparse +import hashlib +import inspect +import json +import os +import serial +import struct +import subprocess +import sys +import time +import zlib + +__version__ = "2.0-dev" + + +MAX_UINT32 = 0xffffffff +MAX_UINT24 = 0xffffff + + +class ESPROM(object): + """ Base class providing access to ESP ROM bootloader. Subclasses provide + ESP8266, ESP31 & ESP32 specific functionality. + + Don't instantiate this base class directly, either instantiate a subclass or + call ESPROM.detect_chip() which will interrogate the chip and return the + appropriate subclass instance. + + """ + CHIP_NAME = "Espressif device" + + DEFAULT_PORT = "/dev/ttyUSB0" + + # These are the currently known commands supported by the ROM + ESP_FLASH_BEGIN = 0x02 + ESP_FLASH_DATA = 0x03 + ESP_FLASH_END = 0x04 + ESP_MEM_BEGIN = 0x05 + ESP_MEM_END = 0x06 + ESP_MEM_DATA = 0x07 + ESP_SYNC = 0x08 + ESP_WRITE_REG = 0x09 + ESP_READ_REG = 0x0a + + # Maximum block sized for RAM and Flash writes, respectively. + ESP_RAM_BLOCK = 0x1800 + ESP_FLASH_BLOCK = 0x400 + + # Default baudrate. The ROM auto-bauds, so we can use more or less whatever we want. + ESP_ROM_BAUD = 115200 + + # First byte of the application image + ESP_IMAGE_MAGIC = 0xe9 + + # Initial state for the checksum routine + ESP_CHECKSUM_MAGIC = 0xef + + # Flash sector size, minimum unit of erase. + ESP_FLASH_SECTOR = 0x1000 + + UART_DATA_REG_ADDR = 0x60000078 + + # SPI peripheral "command" bitmasks + SPI_CMD_READ_ID = 0x10000000 + + # Memory addresses + IROM_MAP_START = 0x40200000 + IROM_MAP_END = 0x40300000 + + # The number of bytes in the response that signify command status + STATUS_BYTES_LENGTH = 2 + + def __init__(self, port=DEFAULT_PORT, baud=ESP_ROM_BAUD, do_connect=True): + """Base constructor for ESPROM objects + + Don't call this constructor, either instantiate ESP8266ROM, + ESP31ROM, or ESP32ROM, or use ESPROM.detect_chip(). + + """ + self._port = serial.Serial(port) + self._slip_reader = slip_reader(self._port) + # setting baud rate in a separate step is a workaround for + # CH341 driver on some Linux versions (this opens at 9600 then + # sets), shouldn't matter for other platforms/drivers. See + # https://github.com/themadinventor/esptool/issues/44#issuecomment-107094446 + self._port.baudrate = baud + if do_connect: + self.connect() + + @staticmethod + def detect_chip(port=DEFAULT_PORT, baud=ESP_ROM_BAUD): + """Use serial access to detect the chip type. + + We use the UART's datecode register for this, it's mapped at + the same address on ESP8266 & ESP31/32 so we can use one + memory read and compare to the datecode register for each chip + type. + + """ + detect_port = ESPROM(port, baud, True) + sys.stdout.write('Detecting chip type... ') + date_reg = detect_port.read_reg(ESPROM.UART_DATA_REG_ADDR) + for cls in [ESP8266ROM, ESP31ROM, ESP32ROM]: + if date_reg == cls.DATE_REG_VALUE: + inst = cls(port, baud, False) # don't connect a second time + print '%s' % inst.CHIP_NAME + return inst + print '' + raise FatalError("Unexpected UART datecode value 0x%08x. Failed to autodetect chip type." % date_reg) + + """ Read a SLIP packet from the serial port """ + def read(self): + return self._slip_reader.next() + + """ Write bytes to the serial port while performing SLIP escaping """ + def write(self, packet): + buf = '\xc0' \ + + (packet.replace('\xdb','\xdb\xdd').replace('\xc0','\xdb\xdc')) \ + + '\xc0' + self._port.write(buf) + + """ Calculate checksum of a blob, as it is defined by the ROM """ + @staticmethod + def checksum(data, state=ESP_CHECKSUM_MAGIC): + for b in data: + state ^= ord(b) + return state + + """ Send a request and read the response """ + def command(self, op=None, data=None, chk=0): + if op is not None: + pkt = struct.pack(' self.STATUS_BYTES_LENGTH: + return data[:-self.STATUS_BYTES_LENGTH] + else: # otherwise, just return the 'val' field which comes from the reply header (this is used by read_reg) + return val + + def sync(self): + """ Perform a connection test """ + self.command(ESPROM.ESP_SYNC, '\x07\x07\x12\x20' + 32 * '\x55') + for i in xrange(7): + self.command() + + def connect(self): + """ Try connecting repeatedly until successful, or giving up """ + print 'Connecting...' + + for _ in xrange(4): + # issue reset-to-bootloader: + # RTS = either CH_PD or nRESET (both active low = chip in reset) + # DTR = GPIO0 (active low = boot to flasher) + self._port.setDTR(False) + self._port.setRTS(True) + time.sleep(0.05) + self._port.setDTR(True) + self._port.setRTS(False) + time.sleep(0.05) + self._port.setDTR(False) + + # worst-case latency timer should be 255ms (probably <20ms) + self._port.timeout = 0.3 + last_exception = None + for _ in xrange(4): + try: + self._port.flushInput() + self._slip_reader = slip_reader(self._port) + self._port.flushOutput() + self.sync() + self._port.timeout = 5 + return + except FatalError as e: + last_exception = e + time.sleep(0.05) + raise FatalError('Failed to connect to %s: %s' % (self.CHIP_NAME, last_exception)) + + """ Read memory address in target """ + def read_reg(self, addr): + # we don't call check_command here because read_reg() function is called + # when detecting chip type, and the way we check for success (STATUS_BYTES_LENGTH) is different + # for different chip types (!) + val, data = self.command(ESPROM.ESP_READ_REG, struct.pack('> 24) | ((id1 & MAX_UINT24) << 8) + + def read_mac(self): + """ Read MAC from OTP ROM """ + mac0 = self.read_reg(self.ESP_OTP_MAC0) + mac1 = self.read_reg(self.ESP_OTP_MAC1) + mac3 = self.read_reg(self.ESP_OTP_MAC3) + if (mac3 != 0): + oui = ((mac3 >> 16) & 0xff, (mac3 >> 8) & 0xff, mac3 & 0xff) + elif ((mac1 >> 16) & 0xff) == 0: + oui = (0x18, 0xfe, 0x34) + elif ((mac1 >> 16) & 0xff) == 1: + oui = (0xac, 0xd0, 0x74) + else: + raise FatalError("Unknown OUI") + return oui + ((mac1 >> 8) & 0xff, mac1 & 0xff, (mac0 >> 24) & 0xff) + + def get_erase_size(self, size): + """ Calculate an erase size given a specific size in bytes. + + Provides a workaround for the bootloader erase bug.""" + + sectors_per_block = 16 + sector_size = self.ESP_FLASH_SECTOR + num_sectors = (size + sector_size - 1) / sector_size + start_sector = offset / sector_size + + head_sectors = sectors_per_block - (start_sector % sectors_per_block) + if num_sectors < head_sectors: + head_sectors = num_sectors + + if num_sectors < 2 * head_sectors: + return (num_sectors + 1) / 2 * sector_size + else: + return (num_sectors - head_sectors) * sector_size + +class ESP31ROM(ESPROM): + """ Access class for ESP31 ROM bootloader + """ + CHIP_NAME = "ESP31" + + DATE_REG_VALUE = 0x15052100 + + SPI_CMD_REG_ADDR = 0x60003000 + SPI_W0_REG_ADDR = 0x60003040 + + EFUSE_BASE = 0x6001a000 + + FLASH_SIZES = { + '1MB':0x00, + '2MB':0x10, + '4MB':0x20, + '8MB':0x30, + '16MB':0x40 + } + + def read_efuse(self, n): + """ Read the nth word of the ESP3x EFUSE region. """ + return self.read_reg(self.EFUSE_BASE + (4 * n)) + + def chip_id(self): + word16 = self.read_efuse(16) + word17 = self.read_efuse(17) + return ((word17 & MAX_UINT24) << 24) | (word16 >> 8) & MAX_UINT24 + + def read_mac(self): + """ Read MAC from EFUSE region """ + word16 = self.read_efuse(16) + word17 = self.read_efuse(17) + word18 = self.read_efuse(18) + word19 = self.read_efuse(19) + wifi_mac = (((word17 >> 16) & 0xff), ((word17 >> 8) & 0xff), ((word17 >> 0) & 0xff), + ((word16 >> 24) & 0xff), ((word16 >> 16) & 0xff), ((word16 >> 8) & 0xff)) + bt_mac = (((word19 >> 16) & 0xff), ((word19 >> 8) & 0xff), ((word19 >> 0) & 0xff), + ((word18 >> 24) & 0xff), ((word18 >> 16) & 0xff), ((word18 >> 8) & 0xff)) + return (wifi_mac,bt_mac) + + def get_erase_size(self, size): + return size + +class ESP32ROM(ESP31ROM): + """Access class for ESP32 ROM bootloader + + """ + CHIP_NAME = "ESP32" + + DATE_REG_VALUE = 0x15122500 + + # ESP32-only commands + ESP_SPI_FLASH_SET = 0xb + + ESP_SPI_ATTACH_REQ = 0xD + + ESP_CHANGE_BAUDRATE = 0x0F + ESP_FLASH_DEFL_BEGIN = 0x10 + ESP_FLASH_DEFL_DATA = 0x11 + ESP_FLASH_DEFL_END = 0x12 + + ESP_SPI_FLASH_MD5 = 0x13 + + IROM_MAP_START = 0x400d0000 + IROM_MAP_END = 0x40400000 + DROM_MAP_START = 0x3F400000 + DROM_MAP_END = 0x3F700000 + + # ESP32 uses a 4 byte status reply + STATUS_BYTES_LENGTH = 4 + + def flash_defl_begin(self, size, compsize, offset): + """ Start downloading compressed data to Flash (performs an erase) """ + old_tmo = self._port.timeout + num_blocks = (compsize + self.ESP_FLASH_BLOCK - 1) / self.ESP_FLASH_BLOCK + erase_blocks = (size + self.ESP_FLASH_BLOCK - 1) / self.ESP_FLASH_BLOCK + + erase_size = size + if erase_size > 0 and (offset + erase_size) >= (16 / 8) * 1024 * 1024: + self.flash_spi_param_set() + + self._port.timeout = 20 + t = time.time() + print "Unc size %d comp size %d comp blocks %d" % (size, compsize, num_blocks) + self.check_command("enter compressed flash mode", self.ESP_FLASH_DEFL_BEGIN, + struct.pack(' 16: + raise FatalError('Invalid firmware image magic=%d segments=%d' % (magic, segments)) + return segments + + def load_segment(self, f, is_irom_segment=False): + """ Load the next segment from the image file """ + file_offs = f.tell() + (offset, size) = struct.unpack(' 0x40200000 or offset < 0x3ffe0000 or size > 65536: + print('WARNING: Suspicious segment 0x%x, length %d' % (offset, size)) + segment_data = f.read(size) + if len(segment_data) < size: + raise FatalError('End of file reading segment 0x%x, length %d (actual length %d)' % (offset, size, len(segment_data))) + segment = ImageSegment(offset, segment_data, file_offs) + self.segments.append(segment) + return segment + + def save_segment(self, f, segment, checksum=None): + """ Save the next segment to the image file, return next checksum value if provided """ + f.write(struct.pack(' 0: + if len(irom_segments) != 1: + raise FatalError('Found %d segments that could be irom0. Bad ELF file?' % len(irom_segments)) + return irom_segments[0] + return None + + def get_non_irom_segments(self): + irom_segment = self.get_irom_segment() + return [s for s in self.segments if s != irom_segment] + + +class ESPFirmwareImage(BaseFirmwareImage): + """ 'Version 1' firmware image, segments loaded directly by the ROM bootloader. """ + def __init__(self, load_file=None): + super(ESPFirmwareImage, self).__init__() + self.flash_mode = 0 + self.flash_size_freq = 0 + self.version = 1 + + if load_file is not None: + segments = self.load_common_header(load_file, ESPROM.ESP_IMAGE_MAGIC) + + for _ in xrange(segments): + self.load_segment(load_file) + self.checksum = self.read_checksum(load_file) + + def default_output_name(self, input_file): + """ Derive a default output name from the ELF name. """ + return input_file + '-' + + def save(self, basename): + """ Save a set of V1 images for flashing. Parameter is a base filename. """ + # IROM data goes in its own plain binary file + irom_segment = self.get_irom_segment() + if irom_segment is not None: + with open("%s0x%05x.bin" % (basename, irom_segment.addr), "wb") as f: + f.write(irom_segment.data) + + # everything but IROM goes at 0x00000 in an image file + normal_segments = self.get_non_irom_segments() + with open("%s0x00000.bin" % basename, 'wb') as f: + self.write_common_header(f, normal_segments) + checksum = ESPROM.ESP_CHECKSUM_MAGIC + for segment in self.segments: + checksum = self.save_segment(f, segment, checksum) + self.append_checksum(f, checksum) + + +class OTAFirmwareImage(BaseFirmwareImage): + """ 'Version 2' firmware image, segments loaded by software bootloader stub + (ie Espressif bootloader or rboot) + """ + def __init__(self, load_file=None): + super(OTAFirmwareImage, self).__init__() + self.version = 2 + if load_file is not None: + segments = self.load_common_header(load_file, ESPBOOTLOADER.IMAGE_V2_MAGIC) + if segments != ESPBOOTLOADER.IMAGE_V2_SEGMENT: + # segment count is not really segment count here, but we expect to see '4' + print 'Warning: V2 header has unexpected "segment" count %d (usually 4)' % segments + + # irom segment comes before the second header + # + # the file is saved in the image with a zero load address + # in the header, so we need to calculate a load address + irom_offs = load_file.tell() + irom_segment = self.load_segment(load_file, True) + irom_segment.addr = irom_offs + ESPROM.IROM_MAP_START + + first_flash_mode = self.flash_mode + first_flash_size_freq = self.flash_size_freq + first_entrypoint = self.entrypoint + # load the second header + self.load_common_header(load_file, ESPROM.ESP_IMAGE_MAGIC) + (magic, segments, self.flash_mode, self.flash_size_freq, self.entrypoint) = struct.unpack(' 0: + #print("Calculated pad length %08x to place next header @ %08x" % (pad_len, f.tell()+pad_len)) + null = ImageSegment(0, '\x00' * pad_len, f.tell()) + checksum = self.save_segment(f, null, checksum) + #print("After padding, at file offset %08x" % f.tell()) + padding_segments += 1 + #print "Comparing file offs %x (data @ %x) with segment load addr %x" % (f.tell(), f.tell() + 8, segment.addr) + # verify that after the 8 byte header is added, were are at the correct offset relative to the segment's vaddr + assert (f.tell() + 8) % IROM_ALIGN == segment.addr % IROM_ALIGN + checksum = self.save_segment(f, segment, checksum) + self.append_checksum(f, checksum) + # kinda hacky: go back to the initial header and write the new segment count + # that includes padding segments. Luckily(?) this header is not checksummed + f.seek(1) + f.write(chr(len(self.segments) + padding_segments)) + + +class ELFFile(object): + SEC_TYPE_PROGBITS = 0x01 + SEC_TYPE_STRTAB = 0x03 + + def __init__(self, name): + # Load sections from the ELF file + self.name = name + with open(self.name, 'rb') as f: + self._read_elf_file(f) + + def _read_elf_file(self, f): + # read the ELF file header + LEN_FILE_HEADER = 0x34 + try: + (ident,_type,machine,_version, + self.entrypoint,_phoff,shoff,_flags, + _ehsize, _phentsize,_phnum,_shentsize, + _shnum,shstrndx) = struct.unpack("<16sHHLLLLLHHHHHH", f.read(LEN_FILE_HEADER)) + except struct.error as e: + raise FatalError("Failed to read a valid ELF header from %s: %s" % (self.name, e)) + + if ident[0] != '\x7f' or ident[1:4] != 'ELF': + raise FatalError("%s has invalid ELF magic header" % self.name) + if machine != 0x5e: + raise FatalError("%s does not appear to be an Xtensa ELF file. e_machine=%04x" % (self.name, machine)) + self._read_sections(f, shoff, shstrndx) + + def _read_sections(self, f, section_header_offs, shstrndx): + f.seek(section_header_offs) + section_header = f.read() + LEN_SEC_HEADER = 0x28 + if len(section_header) == 0: + raise FatalError("No section header found at offset %04x in ELF file." % section_header_offs) + if len(section_header) % LEN_SEC_HEADER != 0: + print 'WARNING: Unexpected ELF section header length %04x is not mod-%02x' % (len(section_header),LEN_SEC_HEADER) + + # walk through the section header and extract all sections + section_header_offsets = range(0, len(section_header), LEN_SEC_HEADER) + + def read_section_header(offs): + name_offs,sec_type,_flags,lma,sec_offs,size = struct.unpack_from(" 0: + esp._port.baudrate = baud_rate + # Read the greeting. + p = esp.read() + if p != 'OHAI': + raise FatalError('Failed to connect to the flasher (got %s)' % hexify(p)) + + def flash_write(self, addr, data, show_progress=False): + assert addr % self._esp.ESP_FLASH_SECTOR == 0, 'Address must be sector-aligned' + assert len(data) % self._esp.ESP_FLASH_SECTOR == 0, 'Length must be sector-aligned' + sys.stdout.write('Writing %d @ 0x%x... ' % (len(data), addr)) + sys.stdout.flush() + self._esp.write(struct.pack(' length: + raise FatalError('Read more than expected') + p = self._esp.read() + if len(p) != 16: + raise FatalError('Expected digest, got: %s' % hexify(p)) + expected_digest = hexify(p).upper() + digest = hashlib.md5(data).hexdigest().upper() + print + if digest != expected_digest: + raise FatalError('Digest mismatch: expected %s, got %s' % (expected_digest, digest)) + p = self._esp.read() + if len(p) != 1: + raise FatalError('Expected status, got: %s' % hexify(p)) + status_code = struct.unpack(', ) or a single +# argument. + +def load_ram(esp, args): + image = LoadFirmwareImage(esp, args.filename) + + print 'RAM boot...' + for (offset, size, data) in image.segments: + print 'Downloading %d bytes at %08x...' % (size, offset), + sys.stdout.flush() + esp.mem_begin(size, div_roundup(size, esp.ESP_RAM_BLOCK), esp.ESP_RAM_BLOCK, offset) + + seq = 0 + while len(data) > 0: + esp.mem_block(data[0:esp.ESP_RAM_BLOCK], seq) + data = data[esp.ESP_RAM_BLOCK:] + seq += 1 + print 'done!' + + print 'All segments done, executing at %08x' % image.entrypoint + esp.mem_finish(image.entrypoint) + + +def read_mem(esp, args): + print '0x%08x = 0x%08x' % (args.address, esp.read_reg(args.address)) + + +def write_mem(esp, args): + esp.write_reg(args.address, args.value, args.mask, 0) + print 'Wrote %08x, mask %08x to %08x' % (args.value, args.mask, args.address) + + +def dump_mem(esp, args): + f = file(args.filename, 'wb') + for i in xrange(args.size / 4): + d = esp.read_reg(args.address + (i * 4)) + f.write(struct.pack(' 0: + print '\rWriting at 0x%08x... (%d %%)' % (address + seq * esp.ESP_FLASH_BLOCK, 100 * (seq + 1) / blocks), + sys.stdout.flush() + block = image[0:esp.ESP_FLASH_BLOCK] + if args.compress: + esp.flash_defl_block(block, seq) + else: + # Pad the last block + block = block + '\xff' * (esp.ESP_FLASH_BLOCK - len(block)) + # Fix sflash config data + if address == 0 and seq == 0 and block[0] == '\xe9': + block = block[0:2] + flash_info + block[4:] + header_block = block + esp.flash_block(block, seq) + image = image[esp.ESP_FLASH_BLOCK:] + seq += 1 + written += len(block) + t = time.time() - t + print '\rWrote %d bytes at 0x%08x in %.1f seconds (%.1f kbit/s)...' % (written, address, t, written / t * 8 / 1000) + res = esp.flash_md5sum(address, uncsize) + if res != calcmd5: + print 'File md5: %s' % calcmd5 + print 'Flash md5: %s' % res + raise FatalError("MD5 of file does not match data in flash!") + else: + print 'Hash of data verified.' + print '\nLeaving...' + if args.flash_mode == 'dio': + esp.flash_unlock_dio() + else: + esp.flash_begin(0, 0) + if args.compress: + esp.flash_defl_finish(False) + else: + esp.flash_finish(False) + if args.verify: + print 'Verifying just-written flash...' + verify_flash(esp, args, header_block) + + +def image_info(args): + image = LoadFirmwareImage(args.chip, args.filename) + print('Image version: %d' % image.version) + print('Entry point: %08x' % image.entrypoint) if image.entrypoint != 0 else 'Entry point not set' + print '%d segments' % len(image.segments) + print + checksum = ESPROM.ESP_CHECKSUM_MAGIC + idx = 0 + for seg in image.segments: + idx += 1 + print 'Segment %d: %r' % (idx, seg) + checksum = ESPROM.checksum(seg.data, checksum) + print + print 'Checksum: %02x (%s)' % (image.checksum, 'valid' if image.checksum == checksum else 'invalid!') + + +def make_image(args): + image = ESPFirmwareImage() + if len(args.segfile) == 0: + raise FatalError('No segments specified') + if len(args.segfile) != len(args.segaddr): + raise FatalError('Number of specified files does not match number of specified addresses') + for (seg, addr) in zip(args.segfile, args.segaddr): + data = file(seg, 'rb').read() + image.segments.append(ImageSegment(addr, data)) + image.entrypoint = args.entrypoint + image.save(args.output) + + +def elf2image(args): + e = ELFFile(args.input) + if args.chip == 'auto': # Default to ESP8266 for backwards compatibility + print "Creating image for ESP8266..." + args.chip == 'esp8266' + + if args.chip == 'esp31': + raise FatalError("No elf2image support for ESP31. Use gen_appimage.py from the ESP31 SDK") + elif args.chip == 'esp32': + image = ESP32FirmwareImage() + elif args.version == '1': # ESP8266 + image = ESPFirmwareImage() + else: + image = OTAFirmwareImage() + image.entrypoint = e.entrypoint + image.segments = e.sections # ELFSection is a subclass of ImageSegment + image.flash_mode = {'qio':0, 'qout':1, 'dio':2, 'dout': 3}[args.flash_mode] + image.flash_size_freq = ESP8266ROM.FLASH_SIZES[args.flash_size] + image.flash_size_freq += {'40m':0, '26m':1, '20m':2, '80m': 0xf}[args.flash_freq] + + if args.output is None: + args.output = image.default_output_name(args.input) + image.save(args.output) + + +def read_mac(esp, args): + mac = esp.read_mac() + print 'MAC: %s' % ':'.join(map(lambda x: '%02x' % x, mac)) + + +def chip_id(esp, args): + chipid = esp.chip_id() + print 'Chip ID: 0x%08x' % chipid + + +def erase_flash(esp, args): + print 'Erasing flash (this may take a while)...' + flasher = CesantaFlasher(esp, args.baud) + flasher.flash_erase() + print 'Erase completed successfully.' + + +def run(esp, args): + esp.run() + + +def flash_id(esp, args): + flash_id = esp.flash_id() + print 'Manufacturer: %02x' % (flash_id & 0xff) + print 'Device: %02x%02x' % ((flash_id >> 8) & 0xff, (flash_id >> 16) & 0xff) + + +def read_flash(esp, args): + flasher = CesantaFlasher(esp, args.baud) + t = time.time() + data = flasher.flash_read(args.address, args.size, not args.no_progress) + t = time.time() - t + print ('\rRead %d bytes at 0x%x in %.1f seconds (%.1f kbit/s)...' + % (len(data), args.address, t, len(data) / t * 8 / 1000)) + file(args.filename, 'wb').write(data) + + +def _verify_flash(flasher, args, flash_params=None): + differences = False + for address, argfile in args.addr_filename: + image = argfile.read() + argfile.seek(0) # rewind in case we need it again + if address == 0 and image[0] == '\xe9' and flash_params is not None: + image = image[0:2] + flash_params + image[4:] + image_size = len(image) + print 'Verifying 0x%x (%d) bytes @ 0x%08x in flash against %s...' % (image_size, image_size, address, argfile.name) + # Try digest first, only read if there are differences. + digest, _ = flasher.flash_digest(address, image_size) + digest = hexify(digest).upper() + expected_digest = hashlib.md5(image).hexdigest().upper() + if digest == expected_digest: + print '-- verify OK (digest matched)' + continue + else: + differences = True + if getattr(args, 'diff', 'no') != 'yes': + print '-- verify FAILED (digest mismatch)' + continue + + flash = flasher.flash_read(address, image_size) + assert flash != image + diff = [i for i in xrange(image_size) if flash[i] != image[i]] + print '-- verify FAILED: %d differences, first @ 0x%08x' % (len(diff), address + diff[0]) + for d in diff: + print ' %08x %02x %02x' % (address + d, ord(flash[d]), ord(image[d])) + if differences: + raise FatalError("Verify failed.") + + +def verify_flash(esp, args, flash_params=None): + flasher = CesantaFlasher(esp) + _verify_flash(flasher, args, flash_params) + + +def version(args): + print __version__ + +# +# End of operations functions +# + + +def main(): + parser = argparse.ArgumentParser(description='esptool.py v%s - ESP8266 ROM Bootloader Utility' % __version__, prog='esptool') + + parser.add_argument('--chip', '-c', + help='Target chip type', + choices=['auto', 'esp8266', 'esp31', 'esp32'], + default=os.environ.get('ESPTOOL_CHIP', 'auto')) + + parser.add_argument( + '--port', '-p', + help='Serial port device', + default=os.environ.get('ESPTOOL_PORT', ESPROM.DEFAULT_PORT)) + + parser.add_argument( + '--baud', '-b', + help='Serial port baud rate used when flashing/reading', + type=arg_auto_int, + default=os.environ.get('ESPTOOL_BAUD', ESPROM.ESP_ROM_BAUD)) + + subparsers = parser.add_subparsers( + dest='operation', + help='Run esptool {command} -h for additional help') + + parser_load_ram = subparsers.add_parser( + 'load_ram', + help='Download an image to RAM and execute') + parser_load_ram.add_argument('filename', help='Firmware image') + + parser_dump_mem = subparsers.add_parser( + 'dump_mem', + help='Dump arbitrary memory to disk') + parser_dump_mem.add_argument('address', help='Base address', type=arg_auto_int) + parser_dump_mem.add_argument('size', help='Size of region to dump', type=arg_auto_int) + parser_dump_mem.add_argument('filename', help='Name of binary dump') + + parser_read_mem = subparsers.add_parser( + 'read_mem', + help='Read arbitrary memory location') + parser_read_mem.add_argument('address', help='Address to read', type=arg_auto_int) + + parser_write_mem = subparsers.add_parser( + 'write_mem', + help='Read-modify-write to arbitrary memory location') + parser_write_mem.add_argument('address', help='Address to write', type=arg_auto_int) + parser_write_mem.add_argument('value', help='Value', type=arg_auto_int) + parser_write_mem.add_argument('mask', help='Mask of bits to write', type=arg_auto_int) + + def add_spi_flash_subparsers(parent): + """ Add common parser arguments for SPI flash properties """ + parent.add_argument('--flash_freq', '-ff', help='SPI Flash frequency', + choices=['40m', '26m', '20m', '80m'], + default=os.environ.get('ESPTOOL_FF', '40m')) + parent.add_argument('--flash_mode', '-fm', help='SPI Flash mode', + choices=['qio', 'qout', 'dio', 'dout'], + default=os.environ.get('ESPTOOL_FM', 'qio')) + parent.add_argument('--flash_size', '-fs', help='SPI Flash size in MegaBytes (1MB, 2MB, 4MB, 8MB, 16M)' + ' plus ESP8266-only (256KB, 512KB, 2MB-c1, 4MB-c1, 4MB-2)', + action=FlashSizeAction, + default=os.environ.get('ESPTOOL_FS', '1MB')) + + parser_write_flash = subparsers.add_parser( + 'write_flash', + help='Write a binary blob to flash') + parser_write_flash.add_argument('addr_filename', metavar='
', help='Address followed by binary filename, separated by space', + action=AddrFilenamePairAction) + add_spi_flash_subparsers(parser_write_flash) + parser_write_flash.add_argument('--no-progress', '-p', help='Suppress progress output', action="store_true") + parser_write_flash.add_argument('--verify', help='Verify just-written data (only necessary if very cautious, data is already CRCed', action='store_true') + parser_write_flash.add_argument('--ucIsHspi', '-ih', help='Config SPI PORT/PINS (Espressif internal feature)',default='0') + parser_write_flash.add_argument('--ucIsLegacy', '-il', help='Config SPI LEGACY (Espressif internal feature)',default='0') + parser_write_flash.add_argument('--compress', '-z', help='Compress data in transfer',action="store_true") + + subparsers.add_parser( + 'run', + help='Run application code in flash') + + parser_image_info = subparsers.add_parser( + 'image_info', + help='Dump headers from an application image') + parser_image_info.add_argument('filename', help='Image file to parse') + + parser_make_image = subparsers.add_parser( + 'make_image', + help='Create an application image from binary files') + parser_make_image.add_argument('output', help='Output image file') + parser_make_image.add_argument('--segfile', '-f', action='append', help='Segment input file') + parser_make_image.add_argument('--segaddr', '-a', action='append', help='Segment base address', type=arg_auto_int) + parser_make_image.add_argument('--entrypoint', '-e', help='Address of entry point', type=arg_auto_int, default=0) + + parser_elf2image = subparsers.add_parser( + 'elf2image', + help='Create an application image from ELF file') + parser_elf2image.add_argument('input', help='Input ELF file') + parser_elf2image.add_argument('--output', '-o', help='Output filename prefix (for version 1 image), or filename (for version 2 single image)', type=str) + parser_elf2image.add_argument('--version', '-e', help='Output image version', choices=['1','2'], default='1') + add_spi_flash_subparsers(parser_elf2image) + + subparsers.add_parser( + 'read_mac', + help='Read MAC address from OTP ROM') + + subparsers.add_parser( + 'chip_id', + help='Read Chip ID from OTP ROM') + + subparsers.add_parser( + 'flash_id', + help='Read SPI flash manufacturer and device ID') + + parser_read_flash = subparsers.add_parser( + 'read_flash', + help='Read SPI flash content') + parser_read_flash.add_argument('address', help='Start address', type=arg_auto_int) + parser_read_flash.add_argument('size', help='Size of region to dump', type=arg_auto_int) + parser_read_flash.add_argument('filename', help='Name of binary dump') + parser_read_flash.add_argument('--no-progress', '-p', help='Suppress progress output', action="store_true") + + parser_verify_flash = subparsers.add_parser( + 'verify_flash', + help='Verify a binary blob against flash') + parser_verify_flash.add_argument('addr_filename', help='Address and binary file to verify there, separated by space', + action=AddrFilenamePairAction) + parser_verify_flash.add_argument('--diff', '-d', help='Show differences', + choices=['no', 'yes'], default='no') + + subparsers.add_parser( + 'erase_flash', + help='Perform Chip Erase on SPI flash') + + subparsers.add_parser( + 'version', help='Print esptool version') + + # internal sanity check - every operation matches a module function of the same name + for operation in subparsers.choices.keys(): + assert operation in globals(), "%s should be a module function" % operation + + args = parser.parse_args() + + print 'esptool.py v%s' % __version__ + + # operation function can take 1 arg (args), 2 args (esp, arg) + # or be a member function of the ESPROM class. + + operation_func = globals()[args.operation] + operation_args,_,_,_ = inspect.getargspec(operation_func) + if operation_args[0] == 'esp': # operation function takes an ESPROM connection object + initial_baud = min(ESPROM.ESP_ROM_BAUD, args.baud) # don't sync faster than the default baud rate + chip_constructor_fun = { + 'auto': ESPROM.detect_chip, + 'esp8266': ESP8266ROM, + 'esp31': ESP31ROM, + 'esp32': ESP32ROM, + }[args.chip] + esp = chip_constructor_fun(args.port, initial_baud) + operation_func(esp, args) + else: + operation_func(args) + + +class FlashSizeAction(argparse.Action): + """ Custom flash size parser class to support backwards compatibility with megabit size arguments. + + (At next major relase, remove deprecated sizes and this can become a 'normal' choices= argument again.) + """ + def __init__(self, option_strings, dest, nargs=1, **kwargs): + super(FlashSizeAction, self).__init__(option_strings, dest, nargs, **kwargs) + + def __call__(self, parser, namespace, values, option_string=None): + try: + value = { + '2m': '256KB', + '4m': '512KB', + '8m': '1MB', + '16m': '2MB', + '32m': '4MB', + '16m-c1': '2MB-c1', + '32m-c1': '4MB-c1', + '32m-c2': '4MB-c2' + }[values[0]] + print("WARNING: Flash size arguments in megabits like '%s' are deprecated." % (values[0])) + print("Please use the equivalent size '%s'." % (value)) + print("Megabit arguments may be removed in a future release.") + except KeyError: + values = values[0] + + known_sizes = dict(ESP8266ROM.FLASH_SIZES) + known_sizes.update(ESP32ROM.FLASH_SIZES) + if value not in known_sizes: + raise argparse.ArgumentError(self, '%s is not a known flash size. Known sizes: %s' % (value, ", ".join(known_sizes.keys()))) + setattr(namespace, self.dest, value) + + +class AddrFilenamePairAction(argparse.Action): + """ Custom parser class for the address/filename pairs passed as arguments """ + def __init__(self, option_strings, dest, nargs='+', **kwargs): + super(AddrFilenamePairAction, self).__init__(option_strings, dest, nargs, **kwargs) + + def __call__(self, parser, namespace, values, option_string=None): + # validate pair arguments + pairs = [] + for i in range(0,len(values),2): + try: + address = int(values[i],0) + except ValueError as e: + raise argparse.ArgumentError(self,'Address "%s" must be a number' % values[i]) + try: + argfile = open(values[i + 1], 'rb') + except IOError as e: + raise argparse.ArgumentError(self, e) + except IndexError: + raise argparse.ArgumentError(self,'Must be pairs of an address and the binary filename to write there') + pairs.append((address, argfile)) + setattr(namespace, self.dest, pairs) + +# This is "wrapped" stub_flasher.c, to be loaded using run_stub. +_CESANTA_FLASHER_STUB = """\ +{"code_start": 1074790404, "code": "080000601C000060000000601000006031FCFF71FCFF\ +81FCFFC02000680332D218C020004807404074DCC48608005823C0200098081BA5A9239245005803\ +1B555903582337350129230B446604DFC6F3FF21EEFFC0200069020DF0000000010078480040004A\ +0040B449004012C1F0C921D911E901DD0209312020B4ED033C2C56C2073020B43C3C56420701F5FF\ +C000003C4C569206CD0EEADD860300202C4101F1FFC0000056A204C2DCF0C02DC0CC6CCAE2D1EAFF\ +0606002030F456D3FD86FBFF00002020F501E8FFC00000EC82D0CCC0C02EC0C73DEB2ADC46030020\ +2C4101E1FFC00000DC42C2DCF0C02DC056BCFEC602003C5C8601003C6C4600003C7C08312D0CD811\ +C821E80112C1100DF0000C180000140010400C0000607418000064180000801800008C1800008418\ +0000881800009018000018980040880F0040A80F0040349800404C4A0040740F0040800F0040980F\ +00400099004012C1E091F5FFC961CD0221EFFFE941F9310971D9519011C01A223902E2D1180C0222\ +6E1D21E4FF31E9FF2AF11A332D0F42630001EAFFC00000C030B43C2256A31621E1FF1A2228022030\ +B43C3256B31501ADFFC00000DD023C4256ED1431D6FF4D010C52D90E192E126E0101DDFFC0000021\ +D2FF32A101C020004802303420C0200039022C0201D7FFC00000463300000031CDFF1A333803D023\ +C03199FF27B31ADC7F31CBFF1A3328030198FFC0000056C20E2193FF2ADD060E000031C6FF1A3328\ +030191FFC0000056820DD2DD10460800000021BEFF1A2228029CE231BCFFC020F51A33290331BBFF\ +C02C411A332903C0F0F4222E1D22D204273D9332A3FFC02000280E27B3F721ABFF381E1A2242A400\ +01B5FFC00000381E2D0C42A40001B3FFC0000056120801B2FFC00000C02000280EC2DC0422D2FCC0\ +2000290E01ADFFC00000222E1D22D204226E1D281E22D204E7B204291E860000126E012198FF32A0\ +042A21C54C003198FF222E1D1A33380337B202C6D6FF2C02019FFFC000002191FF318CFF1A223A31\ +019CFFC00000218DFF1C031A22C549000C02060300003C528601003C624600003C72918BFF9A1108\ +71C861D851E841F83112C1200DF00010000068100000581000007010000074100000781000007C10\ +0000801000001C4B0040803C004091FDFF12C1E061F7FFC961E941F9310971D9519011C01A662906\ +21F3FFC2D1101A22390231F2FF0C0F1A33590331EAFFF26C1AED045C2247B3028636002D0C016DFF\ +C0000021E5FF41EAFF2A611A4469040622000021E4FF1A222802F0D2C0D7BE01DD0E31E0FF4D0D1A\ +3328033D0101E2FFC00000561209D03D2010212001DFFFC000004D0D2D0C3D01015DFFC0000041D5\ +FFDAFF1A444804D0648041D2FF1A4462640061D1FF106680622600673F1331D0FF10338028030C43\ +853A002642164613000041CAFF222C1A1A444804202FC047328006F6FF222C1A273F3861C2FF222C\ +1A1A6668066732B921BDFF3D0C1022800148FFC0000021BAFF1C031A2201BFFFC000000C02460300\ +5C3206020000005C424600005C5291B7FF9A110871C861D851E841F83112C1200DF0B0100000C010\ +0000D010000012C1E091FEFFC961D951E9410971F931CD039011C0ED02DD0431A1FF9C1422A06247\ +B302062D0021F4FF1A22490286010021F1FF1A223902219CFF2AF12D0F011FFFC00000461C0022D1\ +10011CFFC0000021E9FFFD0C1A222802C7B20621E6FF1A22F8022D0E3D014D0F0195FFC000008C52\ +22A063C6180000218BFF3D01102280F04F200111FFC00000AC7D22D1103D014D0F010DFFC0000021\ +D6FF32D110102280010EFFC0000021D3FF1C031A220185FFC00000FAEEF0CCC056ACF821CDFF317A\ +FF1A223A310105FFC0000021C9FF1C031A22017CFFC000002D0C91C8FF9A110871C861D851E841F8\ +3112C1200DF0000200600000001040020060FFFFFF0012C1E00C02290131FAFF21FAFF026107C961\ +C02000226300C02000C80320CC10564CFF21F5FFC02000380221F4FF20231029010C432D010163FF\ +C0000008712D0CC86112C1200DF00080FE3F8449004012C1D0C9A109B17CFC22C1110C13C51C0026\ +1202463000220111C24110B68202462B0031F5FF3022A02802A002002D011C03851A0066820A2801\ +32210105A6FF0607003C12C60500000010212032A01085180066A20F2221003811482105B3FF2241\ +10861A004C1206FDFF2D011C03C5160066B20E280138114821583185CFFF06F7FF005C1286F5FF00\ +10212032A01085140066A20D2221003811482105E1FF06EFFF0022A06146EDFF45F0FFC6EBFF0000\ +01D2FFC0000006E9FF000C022241100C1322C110C50F00220111060600000022C1100C13C50E0022\ +011132C2FA303074B6230206C8FF08B1C8A112C1300DF0000000000010404F484149007519031027\ +000000110040A8100040BC0F0040583F0040CC2E00401CE20040D83900408000004021F4FF12C1E0\ +C961C80221F2FF097129010C02D951C91101F4FFC0000001F3FFC00000AC2C22A3E801F2FFC00000\ +21EAFFC031412A233D0C01EFFFC000003D0222A00001EDFFC00000C1E4FF2D0C01E8FFC000002D01\ +32A004450400C5E7FFDD022D0C01E3FFC00000666D1F4B2131DCFF4600004B22C0200048023794F5\ +31D9FFC0200039023DF08601000001DCFFC000000871C861D85112C1200DF000000012C1F0026103\ +01EAFEC00000083112C1100DF000643B004012C1D0E98109B1C9A1D991F97129013911E2A0C001FA\ +FFC00000CD02E792F40C0DE2A0C0F2A0DB860D00000001F4FFC00000204220E71240F7921C226102\ +01EFFFC0000052A0DC482157120952A0DD571205460500004D0C3801DA234242001BDD3811379DC5\ +C6000000000C0DC2A0C001E3FFC00000C792F608B12D0DC8A1D891E881F87112C1300DF00000", "\ +entry": 1074792180, "num_params": 1, "params_start": 1074790400, "data": "FE0510\ +401A0610403B0610405A0610407A061040820610408C0610408C061040", "data_start": 10736\ +43520} +""" + +if __name__ == '__main__': + try: + main() + except FatalError as e: + print '\nA fatal error occurred: %s' % e + sys.exit(2) diff --git a/bin/gen_esp32part.py b/bin/gen_esp32part.py new file mode 100755 index 000000000..8b5df2b3b --- /dev/null +++ b/bin/gen_esp32part.py @@ -0,0 +1,308 @@ +#!/usr/bin/env python +# +# ESP32 partition table generation tool +# +# Converts partition tables to/from CSV and binary formats. +# +# See the sdkng README.md file for details about how to use this tool. +import struct +import argparse +import sys + +__version__ = '1.0' + +quiet = False + +def status(msg): + """ Print status message to stderr """ + if not quiet: + critical(msg) + +def critical(msg): + """ Print critical message to stderr """ + if not quiet: + sys.stderr.write(msg) + sys.stderr.write('\n') + +class PartitionTable(list): + def __init__(self): + super(PartitionTable, self).__init__(self) + + @classmethod + def from_csv(cls, csv_contents): + res = PartitionTable() + lines = csv_contents.split("\n") + for line_no in range(len(lines)): + line = lines[line_no].strip() + if line.startswith("#") or len(line) == 0: + continue + try: + res.append(PartitionDefinition.from_csv(line)) + except InputError as e: + raise InputError("Error at line %d: %s" % (line_no+1, e)) + except Exception: + critical("Unexpected error parsing line %d: %s" % (line_no+1, line)) + raise + + # fix up missing offsets & negative sizes + last_end = 0x5000 # first offset after partition table + for e in res: + if e.offset is None: + pad_to = 0x10000 if e.type == PartitionDefinition.APP_TYPE else 4 + if last_end % pad_to != 0: + last_end += pad_to - (last_end % pad_to) + e.offset = last_end + if e.size < 0: + e.size = -e.size - e.offset + last_end = e.offset + e.size + + return res + + def __getitem__(self, item): + """ Allow partition table access via name as well as by + numeric index. """ + if isinstance(item, str): + for x in self: + if x.name == item: + return x + raise ValueError("No partition entry named '%s'" % item) + else: + return super(PartitionTable, self).__getitem__(item) + + def verify(self): + # verify each partition individually + for p in self: + p.verify() + # check for overlaps + last = None + for p in sorted(self): + if p.offset < 0x5000: + raise InputError("Partition offset 0x%x is below 0x5000" % p.offset) + if last is not None and p.offset < last.offset + last.size: + raise InputError("Partition at 0x%x overlaps 0x%x-0x%x" % (p.offset, last.offset, last.offset+last.size-1)) + last = p + + @classmethod + def from_binary(cls, b): + if len(b) % 32 != 0: + raise InputError("Partition table length must be a multiple of 32 bytes. Got %d bytes." % len(b)) + result = cls() + for o in range(0,len(b),32): + result.append(PartitionDefinition.from_binary(b[o:o+32])) + return result + + def to_binary(self): + return "".join(e.to_binary() for e in self) + + def to_csv(self, simple_formatting=False): + rows = [ "# Espressif ESP32 Partition Table", + "# Name, Type, SubType, Offset, Size" ] + rows += [ x.to_csv(simple_formatting) for x in self ] + return "\n".join(rows) + "\n" + +class PartitionDefinition(object): + APP_TYPE = 0x00 + DATA_TYPE = 0x01 + TYPES = { + "app" : APP_TYPE, + "data" : DATA_TYPE, + } + + SUBTYPES = { + APP_TYPE : { + "factory" : 0x00, + "test" : 0x20, + }, + DATA_TYPE : { + "ota" : 0x00, + "rf" : 0x01, + "wifi" : 0x02, + }, + } + + MAGIC_BYTES = "\xAA\x50" + + ALIGNMENT = { + APP_TYPE : 0x1000, + DATA_TYPE : 0x04, + } + + # add subtypes for the 16 OTA slot values ("ota_XXX, etc.") + for ota_slot in range(16): + SUBTYPES[TYPES["app"]]["ota_%d" % ota_slot] = 0x10 + ota_slot + + def __init__(self): + self.name = "" + self.type = None + self.subtype = None + self.offset = None + self.size = None + + @classmethod + def from_csv(cls, line): + """ Parse a line from the CSV """ + line_w_defaults = line + ",,," # lazy way to support default fields + fields = [ f.strip() for f in line_w_defaults.split(",") ] + + res = PartitionDefinition() + res.name = fields[0] + res.type = res.parse_type(fields[1]) + res.subtype = res.parse_subtype(fields[2]) + res.offset = res.parse_address(fields[3]) + res.size = res.parse_address(fields[4]) + if res.size is None: + raise InputError("Size field can't be empty") + return res + + def __eq__(self, other): + return self.name == other.name and self.type == other.type \ + and self.subtype == other.subtype and self.offset == other.offset \ + and self.size == other.size + + def __repr__(self): + def maybe_hex(x): + return "0x%x" % x if x is not None else "None" + return "PartitionDefinition('%s', 0x%x, 0x%x, %s, %s)" % (self.name, self.type, self.subtype or 0, + maybe_hex(self.offset), maybe_hex(self.size)) + + def __str__(self): + return "Part '%s' %d/%d @ 0x%x size 0x%x" % (self.name, self.type, self.subtype, self.offset or -1, self.size or -1) + + def __cmp__(self, other): + return self.offset - other.offset + + def parse_type(self, strval): + if strval == "": + raise InputError("Field 'type' can't be left empty.") + return parse_int(strval, self.TYPES) + + def parse_subtype(self, strval): + if strval == "": + return 0 # default + return parse_int(strval, self.SUBTYPES.get(self.type, {})) + + def parse_address(self, strval): + if strval == "": + return None # PartitionTable will fill in default + return parse_int(strval) + + def verify(self): + if self.type is None: + raise ValidationError("Type field is not set") + if self.subtype is None: + raise ValidationError("Subtype field is not set") + if self.offset is None: + raise ValidationError("Offset field is not set") + align = self.ALIGNMENT.get(self.type, 4) + if self.offset % align: + raise ValidationError("%s offset 0x%x is not aligned to 0x%x" % (self.name, self.offset, align)) + if self.size is None: + raise ValidationError("Size field is not set") + + STRUCT_FORMAT = "<2sBBLL16sL" + + @classmethod + def from_binary(cls, b): + if len(b) != 32: + raise InputError("Partition definition length must be exactly 32 bytes. Got %d bytes." % len(b)) + res = cls() + (magic, res.type, res.subtype, res.offset, + res.size, res.name, reserved) = struct.unpack(cls.STRUCT_FORMAT, b) + if "\x00" in res.name: # strip null byte padding from name string + res.name = res.name[:res.name.index("\x00")] + if magic != cls.MAGIC_BYTES: + raise InputError("Invalid magic bytes (%r) for partition definition" % magic) + if reserved != 0: + critical("WARNING: Partition definition had unexpected reserved value 0x%08x. Newer binary format?" % reserved) + return res + + def to_binary(self): + return struct.pack(self.STRUCT_FORMAT, + self.MAGIC_BYTES, + self.type, self.subtype, + self.offset, self.size, + self.name, + 0) # reserved + + def to_csv(self, simple_formatting=False): + def addr_format(a, include_sizes): + if not simple_formatting and include_sizes: + for (val, suffix) in [ (0x100000, "M"), (0x400, "K") ]: + if a % val == 0: + return "%d%s" % (a / val, suffix) + return "0x%x" % a + + def lookup_keyword(t, keywords): + for k,v in keywords.items(): + if simple_formatting == False and t == v: + return k + return "%d" % t + + return ",".join([ self.name, + lookup_keyword(self.type, self.TYPES), + lookup_keyword(self.subtype, self.SUBTYPES.get(self.type, {})), + addr_format(self.offset, False), + addr_format(self.size, True) ]) + +class InputError(RuntimeError): + def __init__(self, e): + super(InputError, self).__init__(e) + +def parse_int(v, keywords={}): + """Generic parser for integer fields - int(x,0) with provision for + k/m/K/M suffixes and 'keyword' value lookup. + """ + try: + for letter, multiplier in [ ("k",1024), ("m",1024*1024) ]: + if v.lower().endswith(letter): + return parse_int(v[:-1], keywords) * multiplier + return int(v, 0) + except ValueError: + if len(keywords) == 0: + raise InputError("Invalid field value %s" % v) + try: + return keywords[v.lower()] + except KeyError: + raise InputError("Value '%s' is not valid. Known keywords: %s" % (v, ", ".join(keywords))) + +def main(): + global quiet + parser = argparse.ArgumentParser(description='ESP32 partition table utility') + + parser.add_argument('--verify', '-v', help='Verify partition table fields', default=True, action='store_false') + parser.add_argument('--quiet', '-q', help="Don't print status messages to stderr", action='store_true') + + parser.add_argument('input', help='Path to CSV or binary file to parse. Will use stdin if omitted.', type=argparse.FileType('r'), default=sys.stdin) + parser.add_argument('output', help='Path to output converted binary or CSV file. Will use stdout if omitted, unless the --display argument is also passed (in which case only the summary is printed.)', + nargs='?', + default='-') + + args = parser.parse_args() + + quiet = args.quiet + input = args.input.read() + input_is_binary = input[0:2] == PartitionDefinition.MAGIC_BYTES + if input_is_binary: + status("Parsing binary partition input...") + table = PartitionTable.from_binary(input) + else: + status("Parsing CSV input...") + table = PartitionTable.from_csv(input) + + if args.verify: + status("Verifying table...") + table.verify() + + if input_is_binary: + output = table.to_csv() + else: + output = table.to_binary() + with sys.stdout if args.output == '-' else open(args.output, 'w') as f: + f.write(output) + +if __name__ == '__main__': + try: + main() + except InputError as e: + print(e) + sys.exit(2) diff --git a/components/bootloader/Makefile.projbuild b/components/bootloader/Makefile.projbuild new file mode 100644 index 000000000..72f078965 --- /dev/null +++ b/components/bootloader/Makefile.projbuild @@ -0,0 +1,45 @@ +# +# Bootloader component +# +# The bootloader is not a real component that gets linked into the project. +# Instead it is an entire standalone project ( in src/) that gets built in +# the upper projects build directory. This Makefile.projbuild provides the +# glue to build the bootloader project from the original project. It +# basically runs Make in the src/ directory but it needs to zero some variables +# the SDK makefile exports first, to not let them interfere. +# + +BOOTLOADER_COMPONENT_PATH := $(COMPONENT_PATH) +EXTRA_CLEAN_TARGETS+=bootloader-clean +BOOTLOADER_BIN=$(BUILD_DIR_BASE)/bootloader.bin + +.PHONY: bootloader-clean bootloader-flash bootloader + +$(BOOTLOADER_BIN): $(COMPONENT_PATH)/src/sdkconfig + $(Q) PROJECT_PATH= \ + COMPONENT_LDFLAGS= \ + COMPONENT_INCLUDES= \ + LDFLAGS= \ + CFLAGS= \ + BUILD_DIR_BASE=$(BUILD_DIR_BASE)/bootloader \ + make -C $(BOOTLOADER_COMPONENT_PATH)/src MAKEFLAGS= V=$(V) TARGET_BIN_LAYOUT="$(BOOTLOADER_TARGET_BIN_LAYOUT)" + +bootloader-clean: + $(Q) PROJECT_PATH= \ + COMPONENT_LDFLAGS= \ + COMPONENT_INCLUDES= \ + LDFLAGS= \ + CFLAGS= \ + BUILD_DIR_BASE=$(BUILD_DIR_BASE)/bootloader \ + make -C $(BOOTLOADER_COMPONENT_PATH)/src clean MAKEFLAGS= V=$(V) + +bootloader: $(BUILD_DIR_BASE)/bootloader.bin + +# synchronise the project level config to the component's +# config +$(COMPONENT_PATH)/src/sdkconfig: $(PROJECT_PATH)/sdkconfig + $(Q) cp $< $@ + +# bootloader-flash calls flash in the bootloader dummy project +bootloader-flash: $(BOOTLOADER_BIN) + make -C $(BOOTLOADER_COMPONENT_PATH)/src flash MAKEFLAGS= V=$(V) CONFIG_APP_OFFSET=0x1000 diff --git a/components/bootloader/src/.gitignore b/components/bootloader/src/.gitignore new file mode 100644 index 000000000..278a862ae --- /dev/null +++ b/components/bootloader/src/.gitignore @@ -0,0 +1,2 @@ +build +sdkconfig diff --git a/components/bootloader/src/Makefile b/components/bootloader/src/Makefile new file mode 100644 index 000000000..abf637401 --- /dev/null +++ b/components/bootloader/src/Makefile @@ -0,0 +1,12 @@ +# +# This is a project Makefile. It is assumed the directory this Makefile resides in is a +# project subdirectory. +# + +PROJECT_NAME := bootloader +COMPONENTS := esptool_py + +#We cannot include the esp32 component directly but we need its includes. This is fixed by +#adding it in the main/Makefile directory. + +include $(SDK_PATH)/make/project.mk diff --git a/components/bootloader/src/main/Makefile b/components/bootloader/src/main/Makefile new file mode 100644 index 000000000..2f07b6972 --- /dev/null +++ b/components/bootloader/src/main/Makefile @@ -0,0 +1,13 @@ +# +# Main Makefile. This is basically the same as a component makefile. +# +# This Makefile should, at the very least, just include $(SDK_PATH)/make/component.mk. By default, +# this will take the sources in the src/ directory, compile them and link them into +# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable, +# please read the SDK documents if you need to do this. +# + +COMPONENT_ADD_LDFLAGS := -L $(abspath .) -lmain -T eagle.bootloader.ld -T $(SDK_PATH)/components/esp32/ld/eagle.fpga32.rom.addr.v7.ld +COMPONENT_EXTRA_INCLUDES := $(SDK_PATH)/components/esp32/include + +include $(SDK_PATH)/make/component.mk diff --git a/components/bootloader/src/main/bootloader_config.h b/components/bootloader/src/main/bootloader_config.h new file mode 100644 index 000000000..7ad97af67 --- /dev/null +++ b/components/bootloader/src/main/bootloader_config.h @@ -0,0 +1,138 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef __BOOT_CONFIG_H__ +#define __BOOT_CONFIG_H__ + +#include + +#ifdef __cplusplus +extern "C" +{ +#endif +#define BOOT_VERSION "V0.1" +#define SPI_SEC_SIZE 0x1000 +#define MEM_CACHE(offset) (uint8_t *)(0x3f400000 + (offset)) +#define CACHE_READ_32(offset) ((uint32_t *)(0x3f400000 + (offset))) +#define PARTITION_ADD 0x4000 +#define PARTITION_MAGIC 0x50AA +#define IROM_LOW 0x400D0000 +#define IROM_HIGH 0x40400000 +#define DROM_LOW 0x3F400000 +#define DROM_HIGH 0x3F800000 + +/*spi mode,saved in third byte in flash */ +enum { + SPI_MODE_QIO, + SPI_MODE_QOUT, + SPI_MODE_DIO, + SPI_MODE_DOUT, + SPI_MODE_FAST_READ, + SPI_MODE_SLOW_READ +}; +/* spi speed*/ +enum { + SPI_SPEED_40M, + SPI_SPEED_26M, + SPI_SPEED_20M, + SPI_SPEED_80M = 0xF +}; +/*suppport flash size in esp32 */ +enum { + SPI_SIZE_1MB = 0, + SPI_SIZE_2MB, + SPI_SIZE_4MB, + SPI_SIZE_8MB, + SPI_SIZE_16MB, + SPI_SIZE_MAX +}; + + +struct flash_hdr { + char magic; + char blocks; + char spi_mode; /* flag of flash read mode in unpackage and usage in future */ + char spi_speed: 4; /* low bit */ + char spi_size: 4; + unsigned int entry_addr; + uint8_t encrypt_flag; /* encrypt flag */ + uint8_t secury_boot_flag; /* secury boot flag */ + char extra_header[14]; /* ESP32 additional header, unused by second bootloader */ +}; + +/* each header of flash bin block */ +struct block_hdr { + unsigned int load_addr; + unsigned int data_len; +}; + +/* OTA selection structure (two copies in the OTA data partition.) + + Size of 32 bytes is friendly to flash encryption */ +typedef struct { + uint32_t ota_seq; + uint8_t seq_label[24]; + uint32_t crc; /* CRC32 of ota_seq field only */ +} ota_select; + +typedef struct { + uint32_t offset; + uint32_t size; +} partition_pos_t; + +typedef struct { + uint16_t magic; + uint8_t type; /* partition Type */ + uint8_t subtype; /* part_subtype */ + partition_pos_t pos; + uint8_t label[16]; /* label for the partition */ + uint8_t reserved[4]; /* reserved */ +} partition_info_t; + +#define PART_TYPE_APP 0x00 +#define PART_SUBTYPE_FACTORY 0x00 +#define PART_SUBTYPE_OTA_FLAG 0x10 +#define PART_SUBTYPE_OTA_MASK 0x0f +#define PART_SUBTYPE_TEST 0x20 + +#define PART_TYPE_DATA 0x01 +#define PART_SUBTYPE_DATA_OTA 0x00 +#define PART_SUBTYPE_DATA_RF 0x01 +#define PART_SUBTYPE_DATA_WIFI 0x02 + +#define PART_TYPE_END 0xff +#define PART_SUBTYPE_END 0xff + +#define SPI_ERROR_LOG "spi flash error" + +typedef struct { + partition_pos_t ota_info; + partition_pos_t factory; + partition_pos_t test; + partition_pos_t ota[16]; + uint32_t app_count; + uint32_t selected_subtype; +} bootloader_state_t; + +void boot_cache_redirect( uint32_t pos, size_t size ); +uint32_t get_bin_len(uint32_t pos); + +bool flash_encrypt(bootloader_state_t *bs); +bool secure_boot(void); + + +#ifdef __cplusplus +} +#endif + +#endif /* __BOOT_CONFIG_H__ */ diff --git a/components/bootloader/src/main/bootloader_log.h b/components/bootloader/src/main/bootloader_log.h new file mode 100644 index 000000000..32bc4852e --- /dev/null +++ b/components/bootloader/src/main/bootloader_log.h @@ -0,0 +1,89 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef __BOOT_LOG_H__ +#define __BOOT_LOG_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + + +#define BOOT_LOG_LEVEL_ERROR (1) +#define BOOT_LOG_LEVEL_WARN (2) +#define BOOT_LOG_LEVEL_INFO (3) +#define BOOT_LOG_LEVEL_NOTICE (4) +#define BOOT_LOG_LEVEL_DEBUG (5) + +#define Black 0;30 +#define Red 0;31 +#define Green 0;32 +#define Brown 0;33 +#define Blue 0;34 +#define Purple 0;35 +#define Cyan 0;36 + +// TODO: move BOOT_LOG_LEVEL into menuconfig +//#define BOOT_LOG_LEVEL BOOT_LOG_LEVEL_ERROR +#define BOOT_LOG_LEVEL BOOT_LOG_LEVEL_NOTICE + +//printf("\033[0;36m[NOTICE][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__); +#define log_notice(format, ...) \ + do{\ + if(BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_NOTICE){\ + ets_printf("\033[0;36m" format "\r\n", ##__VA_ARGS__);\ + ets_printf("\033[0m"); \ + }\ + }while(0) + +#define log_info(format, ...) \ + do{\ + if(BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_INFO){\ + ets_printf("\033[1;36m" format "\r\n", ##__VA_ARGS__);\ + ets_printf("\033[0m"); \ + }\ + }while(0) + +//printf("\033[0;31m[ERROR][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__); +#define log_error(format, ...) \ + do{\ + if(BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_ERROR){\ + ets_printf("\033[0;31m[ERROR][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__);\ + ets_printf("\033[0m"); \ + }\ + }while(0) + +//printf("\033[1;33m[WARN][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__); +#define log_warn(format, ...) \ + do{\ + if(BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_WARN){\ + ets_printf("\033[1;33m[WARN][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__);\ + ets_printf("\033[0m"); \ + }\ + }while(0) + +//printf("\033[1;32m[DEBUG][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__); +#define log_debug(format, ...) \ + do{\ + if(BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_DEBUG){\ + ets_printf("\033[1;32m[DEBUG][%s][%s][%d]\n" format "\r\n", __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__); \ + ets_printf("\033[0m"); \ + }\ + }while(0) + +#ifdef __cplusplus +} +#endif + +#endif /* __BOOT_LOGGING_H__ */ \ No newline at end of file diff --git a/components/bootloader/src/main/bootloader_start.c b/components/bootloader/src/main/bootloader_start.c new file mode 100644 index 000000000..5c2a18681 --- /dev/null +++ b/components/bootloader/src/main/bootloader_start.c @@ -0,0 +1,597 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include +#include + +#include "esp_attr.h" + +#include "rom/cache.h" +#include "rom/ets_sys.h" +#include "rom/spi_flash.h" +#include "rom/crc.h" + +#include "soc/soc.h" +#include "soc/dport_reg.h" +#include "soc/io_mux_reg.h" +#include "soc/efuse_reg.h" +#include "soc/rtc_cntl_reg.h" +#include "soc/timers_reg.h" + +#include "sdkconfig.h" + +#include "bootloader_log.h" +#include "bootloader_config.h" + +extern int _bss_start; +extern int _bss_end; +/* +We arrive here after the bootloader finished loading the program from flash. The hardware is mostly uninitialized, +flash cache is down and the app CPU is in reset. We do have a stack, so we can do the initialization in C. +*/ + +// TODO: make a nice header file for ROM functions instead of adding externs all over the place +extern void Cache_Flush(int); + +void bootloader_main(); +void unpack_load_app(const partition_pos_t *app_node); +void print_flash_info(struct flash_hdr* pfhdr); +void IRAM_ATTR set_cache_and_start_app(uint32_t drom_addr, + uint32_t drom_load_addr, + uint32_t drom_size, + uint32_t irom_addr, + uint32_t irom_load_addr, + uint32_t irom_size, + uint32_t entry_addr); + + +void IRAM_ATTR call_start_cpu0() +{ + //Make page 0 access raise an exception + //Also some other unused pages so we can catch weirdness + //ToDo: this but nicer. + asm volatile (\ + "movi a4,0x00000000\n" \ + "movi a5,0xf\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x80000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xa0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xc0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xe0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x20000000\n" \ + "movi a5,0x0\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x40000000\n" \ + "movi a5,0x2\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "isync\n" \ + :::"a4","a5"); + + //Clear bss + memset(&_bss_start, 0, (&_bss_end - &_bss_start) * sizeof(_bss_start)); + + /* completely reset MMU for both CPUs + (in case serial bootloader was running) */ + Cache_Read_Disable(0); + Cache_Read_Disable(1); + Cache_Flush(0); + Cache_Flush(1); + mmu_init(0); + mmu_init(1); + /* (above steps probably unnecessary for most serial bootloader + usage, all that's absolutely needed is that we unmask DROM0 + cache on the following two lines - normal ROM boot exits with + DROM0 cache unmasked, but serial bootloader exits with it + masked. However can't hurt to be thorough and reset + everything.) + */ + REG_CLR_BIT(PRO_CACHE_CTRL1_REG, DPORT_PRO_CACHE_MASK_DROM0); + REG_CLR_BIT(APP_CACHE_CTRL1_REG, DPORT_APP_CACHE_MASK_DROM0); + + bootloader_main(); +} + +/** + * @function : get_bin_len + * @description: get bin's length + * + * @inputs: pos bin locate address in flash + * @return: uint32 length of bin,if bin MAGIC error return 0 + */ + +uint32_t get_bin_len(uint32_t pos) +{ + uint32_t len = 8 + 16; + uint8_t i; + log_debug("pos %d %x\n",pos,*(uint8_t *)pos); + if(0xE9 != *(uint8_t *)pos) { + return 0; + } + for (i = 0; i < *(uint8_t *)(pos + 1); i++) { + len += *(uint32_t *)(pos + len + 4) + 8; + } + if (len % 16 != 0) { + len = (len / 16 + 1) * 16; + } else { + len += 16; + } + log_debug("bin length = %d\n", len); + return len; +} + +/** + * @function : boot_cache_redirect + * @description: Configure several pages in flash map so that `size` bytes + * starting at `pos` are mapped to 0x3f400000. + * This sets up mapping only for PRO CPU. + * + * @inputs: pos address in flash + * size size of the area to map, in bytes + */ +void boot_cache_redirect( uint32_t pos, size_t size ) +{ + uint32_t pos_aligned = pos & 0xffff0000; + uint32_t count = (size + 0xffff) / 0x10000; + Cache_Read_Disable( 0 ); + Cache_Flush( 0 ); + log_debug( "mmu set paddr=%08x count=%d", pos_aligned, count ); + cache_flash_mmu_set( 0, 0, 0x3f400000, pos_aligned, 64, count ); + Cache_Read_Enable( 0 ); +} + +/** + * @function : load_partition_table + * @description: Parse partition table, get useful data such as location of + * OTA info sector, factory app sector, and test app sector. + * + * @inputs: bs bootloader state structure used to save the data + * addr address of partition table in flash + * @return: return true, if the partition table is loaded (and MD5 checksum is valid) + * + */ +bool load_partition_table(bootloader_state_t* bs, uint32_t addr) +{ + partition_info_t partition; + uint32_t end = addr + 0x1000; + int index = 0; + char *partition_usage; + + log_info("Partition Table:"); + log_info("## Label Usage Type ST Offset Length"); + + while (addr < end) { + log_debug("load partition table entry from %x(%08x)", addr, MEM_CACHE(addr)); + memcpy(&partition, MEM_CACHE(addr), sizeof(partition)); + log_debug("type=%x subtype=%x", partition.type, partition.subtype); + partition_usage = "unknown"; + + if (partition.magic == PARTITION_MAGIC) { /* valid partition definition */ + switch(partition.type) { + case PART_TYPE_APP: /* app partition */ + switch(partition.subtype) { + case PART_SUBTYPE_FACTORY: /* factory binary */ + bs->factory = partition.pos; + partition_usage = "factory app"; + break; + case PART_SUBTYPE_TEST: /* test binary */ + bs->test = partition.pos; + partition_usage = "test app"; + break; + default: + /* OTA binary */ + if ((partition.subtype & ~PART_SUBTYPE_OTA_MASK) == PART_SUBTYPE_OTA_FLAG) { + bs->ota[partition.subtype & PART_SUBTYPE_OTA_MASK] = partition.pos; + ++bs->app_count; + partition_usage = "OTA app"; + } + else { + partition_usage = "Unknown app"; + } + break; + } + break; /* PART_TYPE_APP */ + case PART_TYPE_DATA: /* data partition */ + switch(partition.subtype) { + case PART_SUBTYPE_DATA_OTA: /* ota data */ + bs->ota_info = partition.pos; + partition_usage = "OTA data"; + break; + case PART_SUBTYPE_DATA_RF: + partition_usage = "RF data"; + break; + case PART_SUBTYPE_DATA_WIFI: + partition_usage = "WiFi data"; + break; + default: + partition_usage = "Unknown data"; + break; + } + break; /* PARTITION_USAGE_DATA */ + default: /* other partition type */ + break; + } + } + /* invalid partition magic number */ + else { + break; /* todo: validate md5 */ + } + + /* print partition type info */ + log_info("%2d %-16s %-16s %02x %02x %08x %08x", index, partition.label, partition_usage, + partition.type, partition.subtype, + partition.pos.offset, partition.pos.size); + index++; + addr += sizeof(partition); + } + + log_info("End of partition table"); + return true; +} + +static uint32_t ota_select_crc(const ota_select *s) +{ + return crc32_le(UINT32_MAX, (uint8_t*)&s->ota_seq, 4); +} + +static bool ota_select_valid(const ota_select *s) +{ + return s->ota_seq != UINT32_MAX && s->crc == ota_select_crc(s); +} + +/** + * @function : bootloader_main + * @description: entry function of 2nd bootloader + * + * @inputs: void + */ + +void bootloader_main() +{ + //Run start routine. + /*ESP32 2ND bootload start here*/ + + + log_info( "\n" ); + log_info( "**************************************" ); + log_info( "* hello espressif ESP32! *" ); + log_info( "* 2nd boot is running! *" ); + log_info( "* version (%s) *", BOOT_VERSION); + log_info( "**************************************"); + + struct flash_hdr fhdr; + bootloader_state_t bs; + SpiFlashOpResult spiRet1,spiRet2; + ota_select sa,sb; + memset(&bs, 0, sizeof(bs)); + + log_notice( "compile time %s\n", __TIME__ ); + /* close watch dog here */ + REG_CLR_BIT( RTC_WDTCONFIG0, RTC_CNTL_WDT_FLASHBOOT_MOD_EN ); + REG_CLR_BIT( WDTCONFIG0, TIMERS_WDT_FLASHBOOT_MOD_EN ); + SPIUnlock(); + /*register first sector in drom0 page 0 */ + boot_cache_redirect( 0, 0x5000 ); + + memcpy((unsigned int *) &fhdr, MEM_CACHE(0x1000), sizeof(struct flash_hdr) ); + + print_flash_info(&fhdr); + + if (!load_partition_table(&bs, PARTITION_ADD)) { + log_error("load partition table error!"); + return; + } + + partition_pos_t load_part_pos; + + if (bs.ota_info.offset != 0) { // check if partition table has OTA info partition + //log_error("OTA info sector handling is not implemented"); + boot_cache_redirect(bs.ota_info.offset, bs.ota_info.size ); + memcpy(&sa,MEM_CACHE(bs.ota_info.offset & 0x0000ffff),sizeof(sa)); + memcpy(&sb,MEM_CACHE((bs.ota_info.offset + 0x1000)&0x0000ffff) ,sizeof(sb)); + if(sa.ota_seq == 0xFFFFFFFF && sb.ota_seq == 0xFFFFFFFF) { + // init status flash + load_part_pos = bs.ota[0]; + sa.ota_seq = 0x01; + sa.crc = ota_select_crc(&sa); + sb.ota_seq = 0x00; + sb.crc = ota_select_crc(&sb); + + Cache_Read_Disable(0); + spiRet1 = SPIEraseSector(bs.ota_info.offset/0x1000); + spiRet2 = SPIEraseSector(bs.ota_info.offset/0x1000+1); + if (spiRet1 != SPI_FLASH_RESULT_OK || spiRet2 != SPI_FLASH_RESULT_OK ) { + log_error(SPI_ERROR_LOG); + return; + } + spiRet1 = SPIWrite(bs.ota_info.offset,(uint32_t *)&sa,sizeof(ota_select)); + spiRet2 = SPIWrite(bs.ota_info.offset + 0x1000,(uint32_t *)&sb,sizeof(ota_select)); + if (spiRet1 != SPI_FLASH_RESULT_OK || spiRet2 != SPI_FLASH_RESULT_OK ) { + log_error(SPI_ERROR_LOG); + return; + } + Cache_Read_Enable(0); + //TODO:write data in ota info + } else { + if(ota_select_valid(&sa) && ota_select_valid(&sb)) { + load_part_pos = bs.ota[(((sa.ota_seq > sb.ota_seq)?sa.ota_seq:sb.ota_seq) - 1)%bs.app_count]; + }else if(ota_select_valid(&sa)) { + load_part_pos = bs.ota[(sa.ota_seq - 1) % bs.app_count]; + }else if(ota_select_valid(&sb)) { + load_part_pos = bs.ota[(sb.ota_seq - 1) % bs.app_count]; + }else { + log_error("ota data partition info error"); + return; + } + } + } else if (bs.factory.offset != 0) { // otherwise, look for factory app partition + load_part_pos = bs.factory; + } else if (bs.test.offset != 0) { // otherwise, look for test app parition + load_part_pos = bs.test; + } else { // nothing to load, bail out + log_error("nothing to load"); + return; + } + + log_info("Loading app partition at offset %08x", load_part_pos); + if(fhdr.secury_boot_flag == 0x01) { + /* protect the 2nd_boot */ + if(false == secure_boot()){ + log_error("secure boot failed"); + return; + } + } + + if(fhdr.encrypt_flag == 0x01) { + /* encrypt flash */ + if (false == flash_encrypt(&bs)) { + log_error("flash encrypt failed"); + return; + } + } + + // copy sections to RAM, set up caches, and start application + unpack_load_app(&load_part_pos); +} + + +void unpack_load_app(const partition_pos_t* partition) +{ + boot_cache_redirect(partition->offset, partition->size); + + uint32_t pos = 0; + struct flash_hdr image_header; + memcpy(&image_header, MEM_CACHE(pos), sizeof(image_header)); + pos += sizeof(image_header); + + uint32_t drom_addr = 0; + uint32_t drom_load_addr = 0; + uint32_t drom_size = 0; + uint32_t irom_addr = 0; + uint32_t irom_load_addr = 0; + uint32_t irom_size = 0; + + log_debug("bin_header: %u %u %u %u %08x\n", image_header.magic, + image_header.blocks, + image_header.spi_mode, + image_header.spi_size, + (unsigned)image_header.entry_addr); + + for (uint32_t section_index = 0; + section_index < image_header.blocks; + ++section_index) { + struct block_hdr section_header = {0}; + memcpy(§ion_header, MEM_CACHE(pos), sizeof(section_header)); + pos += sizeof(section_header); + + const uint32_t address = section_header.load_addr; + bool load = true; + bool map = false; + if (address == 0x00000000) { // padding, ignore block + load = false; + } + if (address == 0x00000004) { + load = false; // md5 checksum block + // TODO: actually check md5 + } + + if (address >= DROM_LOW && address < DROM_HIGH) { + log_debug("found drom section, map from %08x to %08x\n", pos, + section_header.load_addr); + drom_addr = partition->offset + pos - sizeof(section_header); + drom_load_addr = section_header.load_addr; + drom_size = section_header.data_len + sizeof(section_header); + load = false; + map = true; + } + + if (address >= IROM_LOW && address < IROM_HIGH) { + log_debug("found irom section, map from %08x to %08x\n", pos, + section_header.load_addr); + irom_addr = partition->offset + pos - sizeof(section_header); + irom_load_addr = section_header.load_addr; + irom_size = section_header.data_len + sizeof(section_header); + load = false; + map = true; + } + + log_notice("section %d: paddr=0x%08x vaddr=0x%08x size=0x%05x (%6d) %s", section_index, pos, section_header.load_addr, section_header.data_len, section_header.data_len, (load)?"load":(map)?"map":""); + + if (!load) { + pos += section_header.data_len; + continue; + } + + memcpy((void*) section_header.load_addr, MEM_CACHE(pos), section_header.data_len); + pos += section_header.data_len; + } + + set_cache_and_start_app(drom_addr, + drom_load_addr, + drom_size, + irom_addr, + irom_load_addr, + irom_size, + image_header.entry_addr); +} + +void IRAM_ATTR set_cache_and_start_app( + uint32_t drom_addr, + uint32_t drom_load_addr, + uint32_t drom_size, + uint32_t irom_addr, + uint32_t irom_load_addr, + uint32_t irom_size, + uint32_t entry_addr) +{ + log_debug("configure drom and irom and start\n"); + Cache_Read_Disable( 0 ); + Cache_Read_Disable( 1 ); + Cache_Flush( 0 ); + Cache_Flush( 1 ); + uint32_t drom_page_count = (drom_size + 64*1024 - 1) / (64*1024); // round up to 64k + log_debug( "d mmu set paddr=%08x vaddr=%08x size=%d n=%d \n", drom_addr & 0xffff0000, drom_load_addr & 0xffff0000, drom_size, drom_page_count ); + int rc = cache_flash_mmu_set( 0, 0, drom_load_addr & 0xffff0000, drom_addr & 0xffff0000, 64, drom_page_count ); + log_debug( "rc=%d", rc ); + rc = cache_flash_mmu_set( 1, 0, drom_load_addr & 0xffff0000, drom_addr & 0xffff0000, 64, drom_page_count ); + log_debug( "rc=%d", rc ); + uint32_t irom_page_count = (irom_size + 64*1024 - 1) / (64*1024); // round up to 64k + log_debug( "i mmu set paddr=%08x vaddr=%08x size=%d n=%d\n", irom_addr & 0xffff0000, irom_load_addr & 0xffff0000, irom_size, irom_page_count ); + rc = cache_flash_mmu_set( 0, 0, irom_load_addr & 0xffff0000, irom_addr & 0xffff0000, 64, irom_page_count ); + log_debug( "rc=%d", rc ); + rc = cache_flash_mmu_set( 1, 0, irom_load_addr & 0xffff0000, irom_addr & 0xffff0000, 64, irom_page_count ); + log_debug( "rc=%d", rc ); + REG_CLR_BIT( PRO_CACHE_CTRL1_REG, (DPORT_PRO_CACHE_MASK_IRAM0) | (DPORT_PRO_CACHE_MASK_IRAM1 & 0) | (DPORT_PRO_CACHE_MASK_IROM0 & 0) | DPORT_PRO_CACHE_MASK_DROM0 | DPORT_PRO_CACHE_MASK_DRAM1 ); + REG_CLR_BIT( APP_CACHE_CTRL1_REG, (DPORT_APP_CACHE_MASK_IRAM0) | (DPORT_APP_CACHE_MASK_IRAM1 & 0) | (DPORT_APP_CACHE_MASK_IROM0 & 0) | DPORT_APP_CACHE_MASK_DROM0 | DPORT_APP_CACHE_MASK_DRAM1 ); + Cache_Read_Enable( 0 ); + Cache_Read_Enable( 1 ); + + log_notice("start: 0x%08x\n", entry_addr); + typedef void (*entry_t)(void); + entry_t entry = ((entry_t) entry_addr); + + // TODO: we have used quite a bit of stack at this point. + // use "movsp" instruction to reset stack back to where ROM stack starts. + (*entry)(); +} + + +void print_flash_info(struct flash_hdr* pfhdr) +{ +#if (BOOT_LOG_LEVEL >= BOOT_LOG_LEVEL_NOTICE) + + struct flash_hdr fhdr = *pfhdr; + + log_debug( "[D]: magic %02x\n", fhdr.magic ); + log_debug( "[D]: blocks %02x\n", fhdr.blocks ); + log_debug( "[D]: spi_mode %02x\n", fhdr.spi_mode ); + log_debug( "[D]: spi_speed %02x\n", fhdr.spi_speed ); + log_debug( "[D]: spi_size %02x\n", fhdr.spi_size ); + + const char* str; + switch ( fhdr.spi_speed ) { + case SPI_SPEED_40M: + str = "40MHz"; + break; + + case SPI_SPEED_26M: + str = "26.7MHz"; + break; + + case SPI_SPEED_20M: + str = "20MHz"; + break; + + case SPI_SPEED_80M: + str = "80MHz"; + break; + + default: + str = "20MHz"; + break; + } + log_notice( " SPI Speed : %s", str ); + + + + switch ( fhdr.spi_mode ) { + case SPI_MODE_QIO: + str = "QIO"; + break; + + case SPI_MODE_QOUT: + str = "QOUT"; + break; + + case SPI_MODE_DIO: + str = "DIO"; + break; + + case SPI_MODE_DOUT: + str = "DOUT"; + break; + + case SPI_MODE_FAST_READ: + str = "FAST READ"; + break; + + case SPI_MODE_SLOW_READ: + str = "SLOW READ"; + break; + default: + str = "DIO"; + break; + } + log_notice( " SPI Mode : %s", str ); + + + + switch ( fhdr.spi_size ) { + case SPI_SIZE_1MB: + str = "1MB"; + break; + + case SPI_SIZE_2MB: + str = "2MB"; + break; + + case SPI_SIZE_4MB: + str = "4MB"; + break; + + case SPI_SIZE_8MB: + str = "8MB"; + break; + + case SPI_SIZE_16MB: + str = "16MB"; + break; + + default: + str = "1MB"; + break; + } + log_notice( " SPI Flash Size : %s", str ); +#endif +} diff --git a/components/bootloader/src/main/eagle.bootloader.ld b/components/bootloader/src/main/eagle.bootloader.ld new file mode 100644 index 000000000..af97bda3a --- /dev/null +++ b/components/bootloader/src/main/eagle.bootloader.ld @@ -0,0 +1,148 @@ +/* +Linker file used to link the bootloader. + +*WARNING* For now this linker dumps everything into IRAM/DRAM. ToDo: move +some/most stuff to DROM/IROM. + +*/ + + +/* THESE ARE THE VIRTUAL RUNTIME ADDRESSES */ +/* The load addresses are defined later using the AT statements. */ +MEMORY +{ + /* All these values assume the flash cache is on, and have the blocks this uses subtracted from the length + of the various regions. The 'data access port' dram/drom regions map to the same iram/irom regions but + are connected to the data port of the CPU and eg allow bytewise access. */ + dport0_seg (RW) : org = 0x3FF00000, len = 0x10 /* IO */ + iram_seg (RWX) : org = 0x40098000, len = 0x1000 + iram_pool_1_seg (RWX) : org = 0x40078000, len = 0x8000 /* IRAM POOL1, used for APP CPU cache. We can abuse it in bootloader because APP CPU is still held in reset, until we enable APP CPU cache */ + dram_seg (RW) : org = 0x3FFC0000, len = 0x20000 /* Shared RAM, minus rom bss/data/stack.*/ +} + +/* Default entry point: */ +ENTRY(call_start_cpu0); + + +SECTIONS +{ + .iram1.text : + { + _init_start = ABSOLUTE(.); + *(.UserEnter.literal); + *(.UserEnter.text); + . = ALIGN (16); + *(.entry.text) + *(.init.literal) + *(.init) + _init_end = ABSOLUTE(.); + + /* Code marked as runnning out of IRAM */ + _iram_text_start = ABSOLUTE(.); + *(.iram1 .iram1.*) + _iram_text_end = ABSOLUTE(.); + } > iram_seg + + + /* Shared RAM */ + .dram0.bss (NOLOAD) : + { + . = ALIGN (8); + _bss_start = ABSOLUTE(.); + *(.dynsbss) + *(.sbss) + *(.sbss.*) + *(.gnu.linkonce.sb.*) + *(.scommon) + *(.sbss2) + *(.sbss2.*) + *(.gnu.linkonce.sb2.*) + *(.dynbss) + KEEP(*(.bss)) + *(.bss.*) + *(.gnu.linkonce.b.*) + *(COMMON) + . = ALIGN (8); + _bss_end = ABSOLUTE(.); + } >dram_seg + + + .dram0.data : + { + _data_start = ABSOLUTE(.); + KEEP(*(.data)) + KEEP(*(.data.*)) + KEEP(*(.gnu.linkonce.d.*)) + KEEP(*(.data1)) + KEEP(*(.sdata)) + KEEP(*(.sdata.*)) + KEEP(*(.gnu.linkonce.s.*)) + KEEP(*(.sdata2)) + KEEP(*(.sdata2.*)) + KEEP(*(.gnu.linkonce.s2.*)) + KEEP(*(.jcr)) + _data_end = ABSOLUTE(.); + } >dram_seg + + + + + .dram0.rodata : + { + _rodata_start = ABSOLUTE(.); + *(.rodata) + *(.rodata.*) + *(.irom1.text) /* catch stray ICACHE_RODATA_ATTR */ + *(.gnu.linkonce.r.*) + *(.rodata1) + __XT_EXCEPTION_TABLE_ = ABSOLUTE(.); + *(.xt_except_table) + *(.gcc_except_table) + *(.gnu.linkonce.e.*) + *(.gnu.version_r) + *(.eh_frame) + . = (. + 3) & ~ 3; + /* C++ constructor and destructor tables, properly ordered: */ + __init_array_start = ABSOLUTE(.); + KEEP (*crtbegin.o(.ctors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .ctors)) + KEEP (*(SORT(.ctors.*))) + KEEP (*(.ctors)) + __init_array_end = ABSOLUTE(.); + KEEP (*crtbegin.o(.dtors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .dtors)) + KEEP (*(SORT(.dtors.*))) + KEEP (*(.dtors)) + /* C++ exception handlers table: */ + __XT_EXCEPTION_DESCS_ = ABSOLUTE(.); + *(.xt_except_desc) + *(.gnu.linkonce.h.*) + __XT_EXCEPTION_DESCS_END__ = ABSOLUTE(.); + *(.xt_except_desc_end) + *(.dynamic) + *(.gnu.version_d) + _rodata_end = ABSOLUTE(.); + /* Literals are also RO data. */ + _lit4_start = ABSOLUTE(.); + *(*.lit4) + *(.lit4.*) + *(.gnu.linkonce.lit4.*) + _lit4_end = ABSOLUTE(.); + . = ALIGN(4); + _heap_start = ABSOLUTE(.); + } >dram_seg + + .iram_pool_1.text : + { + _stext = .; + _text_start = ABSOLUTE(.); + *(.literal .text .literal.* .text.* .stub .gnu.warning .gnu.linkonce.literal.* .gnu.linkonce.t.*.literal .gnu.linkonce.t.*) + *(.irom0.text) /* catch stray ICACHE_RODATA_ATTR */ + *(.fini.literal) + *(.fini) + *(.gnu.version) + _text_end = ABSOLUTE(.); + _etext = .; + } >iram_pool_1_seg + +} diff --git a/components/bootloader/src/main/flash_encrypt.c b/components/bootloader/src/main/flash_encrypt.c new file mode 100644 index 000000000..d5f105f9c --- /dev/null +++ b/components/bootloader/src/main/flash_encrypt.c @@ -0,0 +1,190 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#include + +#include "esp_types.h" +#include "esp_attr.h" + +#include "rom/cache.h" +#include "rom/ets_sys.h" +#include "rom/spi_flash.h" + +#include "soc/dport_reg.h" +#include "soc/io_mux_reg.h" +#include "soc/efuse_reg.h" +#include "soc/rtc_cntl_reg.h" + +#include "sdkconfig.h" + +#include "bootloader_log.h" +#include "bootloader_config.h" + +/** + * @function : bitcount + * @description: caculate bit 1 in flash_crypt_cnt + * if it's even number ,need encrypt flash data,and burn efuse + * + * @inputs: n flash_crypt_cnt + * @return: number of 1 in flash_crypt_cnt + * + */ +int bitcount(int n){ + int count = 0; + while (n > 0) { + count += n & 1; + n >>= 1; + } + return count; + +} +/** + * @function : flash_encrypt_write + * @description: write encrypted data in flash + * + * @inputs: pos address in flash + * len size of data need encrypt + * @return: return true, if the write flash success + * + */ +bool flash_encrypt_write(uint32_t pos, uint32_t len) +{ + SpiFlashOpResult spiRet; + uint32_t buf[1024]; + int i = 0; + Cache_Read_Disable(0); + for (i = 0;i<((len-1)/0x1000 + 1);i++) { + spiRet = SPIRead(pos, buf, SPI_SEC_SIZE); + if (spiRet != SPI_FLASH_RESULT_OK) { + Cache_Read_Enable(0); + log_error(SPI_ERROR_LOG); + return false; + } + spiRet = SPIEraseSector(pos/SPI_SEC_SIZE); + if (spiRet != SPI_FLASH_RESULT_OK) { + Cache_Read_Enable(0); + log_error(SPI_ERROR_LOG); + return false; + } + spiRet = SPI_Encrypt_Write(pos, buf, SPI_SEC_SIZE); + if (spiRet != SPI_FLASH_RESULT_OK) { + Cache_Read_Enable(0); + log_error(SPI_ERROR_LOG); + return false; + } + pos += SPI_SEC_SIZE; + } + Cache_Read_Enable(0); + return true; +} +/** + * @function : flash_encrypt + * @description: encrypt 2nd boot ,partition table ,factory bin ��test bin (if use)��ota bin + * ��OTA info sector. + * + * @inputs: bs bootloader state structure used to save the data + * + * @return: return true, if the encrypt flash success + * + */ +bool flash_encrypt(bootloader_state_t *bs) +{ + uint32_t bin_len = 0; + uint32_t flash_crypt_cnt = REG_GET_FIELD(EFUSE_BLK0_RDATA0, EFUSE_FLASH_CRYPT_CNT); + uint8_t count = bitcount(flash_crypt_cnt); + int i = 0; + log_debug("flash crypt cnt %x, count %d\n", flash_crypt_cnt, count); + + if ((count % 2) == 0) { + boot_cache_redirect( 0, 64*1024); + /* encrypt iv and abstruct */ + if (false == flash_encrypt_write(0,SPI_SEC_SIZE)) { + log_error("encrypt iv and abstruct error"); + return false; + } + + /* encrypt write boot bin*/ + bin_len = get_bin_len((uint32_t)MEM_CACHE(0x1000)); + if(bin_len != 0) { + if (false == flash_encrypt_write(0x1000,bin_len)) { + log_error("encrypt 2nd boot error"); + return false; + } + } else { + log_error("2nd boot len error"); + return false; + } + /* encrypt partition table */ + if (false == flash_encrypt_write(PARTITION_ADD,SPI_SEC_SIZE)) { + log_error("encrypt partition table error"); + return false; + } + + /* encrypt write factory bin */ + if(bs->factory.offset != 0x00) { + log_debug("have factory bin\n"); + boot_cache_redirect(bs->factory.offset,bs->factory.size); + bin_len = get_bin_len((uint32_t)MEM_CACHE(bs->factory.offset&0xffff)); + if(bin_len != 0) { + if (false == flash_encrypt_write(bs->factory.offset,bin_len)) { + log_error("encrypt factory bin error"); + return false; + } + } + } + /* encrypt write test bin */ + if(bs->test.offset != 0x00) { + ets_printf("have test bin\n"); + boot_cache_redirect(bs->test.offset,bs->test.size); + bin_len = get_bin_len((uint32_t)MEM_CACHE(bs->test.offset&0xffff)); + if(bin_len != 0) { + if (false == flash_encrypt_write(bs->test.offset,bin_len)) { + log_error("encrypt test bin error"); + return false; + } + } + } + /* encrypt write ota bin */ + for (i = 0;i<16;i++) { + if(bs->ota[i].offset != 0x00) { + log_debug("have ota[%d] bin\n",i); + boot_cache_redirect(bs->ota[i].offset,bs->ota[i].size); + bin_len = get_bin_len((uint32_t)MEM_CACHE(bs->ota[i].offset&0xffff)); + if(bin_len != 0) { + if (false == flash_encrypt_write(bs->ota[i].offset,bin_len)) { + log_error("encrypt ota bin error"); + return false; + } + } + } + } + /* encrypt write ota info bin */ + if (false == flash_encrypt_write(bs->ota_info.offset,2*SPI_SEC_SIZE)) { + log_error("encrypt ota binfo error"); + return false; + } + REG_SET_FIELD(EFUSE_BLK0_WDATA0, EFUSE_FLASH_CRYPT_CNT, 0x04); + REG_WRITE(EFUSE_CONF, 0x5A5A); /* efuse_pgm_op_ena, force no rd/wr disable */ + REG_WRITE(EFUSE_CMD, 0x02); /* efuse_pgm_cmd */ + while (REG_READ(EFUSE_CMD)); /* wait for efuse_pagm_cmd=0 */ + log_warn("burn flash_crypt_cnt\n"); + REG_WRITE(EFUSE_CONF, 0x5AA5); /* efuse_read_op_ena, release force */ + REG_WRITE(EFUSE_CMD, 0x01); /* efuse_read_cmd */ + while (REG_READ(EFUSE_CMD)); /* wait for efuse_read_cmd=0 */ + return true; + } else { + log_info("flash already encrypted.\n"); + return true; + } +} diff --git a/components/bootloader/src/main/secure_boot.c b/components/bootloader/src/main/secure_boot.c new file mode 100644 index 000000000..97ddd1a8d --- /dev/null +++ b/components/bootloader/src/main/secure_boot.c @@ -0,0 +1,125 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#include + +#include "esp_attr.h" +#include "esp_types.h" + +#include "rom/cache.h" +#include "rom/ets_sys.h" +#include "rom/spi_flash.h" +#include "rom/secure_boot.h" + +#include "soc/dport_reg.h" +#include "soc/io_mux_reg.h" +#include "soc/efuse_reg.h" +#include "soc/rtc_cntl_reg.h" + +#include "sdkconfig.h" + +#include "bootloader_log.h" +#include "bootloader_config.h" + +/** + * @function : secure_boot_generate + * @description: generate boot abstruct & iv + * + * @inputs: bool + */ +bool secure_boot_generate(uint32_t bin_len){ + SpiFlashOpResult spiRet; + uint16_t i; + uint32_t buf[32]; + if (bin_len % 128 != 0) { + bin_len = (bin_len / 128 + 1) * 128; + } + ets_secure_boot_start(); + ets_secure_boot_rd_iv(buf); + ets_secure_boot_hash(NULL); + Cache_Read_Disable(0); + /* iv stored in sec 0 */ + spiRet = SPIEraseSector(0); + if (spiRet != SPI_FLASH_RESULT_OK) + { + log_error(SPI_ERROR_LOG); + return false; + } + /* write iv to flash, 0x0000, 128 bytes (1024 bits) */ + spiRet = SPIWrite(0, buf, 128); + if (spiRet != SPI_FLASH_RESULT_OK) + { + log_error(SPI_ERROR_LOG); + return false; + } + log_debug("write iv to flash.\n"); + Cache_Read_Enable(0); + /* read 4K code image from flash, for test */ + for (i = 0; i < bin_len; i+=128) { + ets_secure_boot_hash((uint32_t *)(0x3f400000 + 0x1000 + i)); + } + + ets_secure_boot_obtain(); + ets_secure_boot_rd_abstract(buf); + ets_secure_boot_finish(); + Cache_Read_Disable(0); + /* write abstract to flash, 0x0080, 64 bytes (512 bits) */ + spiRet = SPIWrite(0x80, buf, 64); + if (spiRet != SPI_FLASH_RESULT_OK) { + log_error(SPI_ERROR_LOG); + return false; + } + log_debug("write abstract to flash.\n"); + Cache_Read_Enable(0); + return true; +} + + +/** + * @function : secure_boot + * @description: protect boot code inflash + * + * @inputs: bool + */ +bool secure_boot(void){ + uint32_t bin_len = 0; + if (REG_READ(EFUSE_BLK0_RDATA6) & EFUSE_RD_ABS_DONE_0) + { + log_info("already secure boot !\n"); + return true; + } else { + boot_cache_redirect( 0, 64*1024); + bin_len = get_bin_len((uint32_t)MEM_CACHE(0x1000)); + if (bin_len == 0) { + log_error("boot len is error"); + return false; + } + if (false == secure_boot_generate(bin_len)){ + log_error("secure boot generate failed"); + return false; + } + } + + REG_SET_BIT(EFUSE_BLK0_WDATA6, EFUSE_RD_ABS_DONE_0); + REG_WRITE(EFUSE_CONF, 0x5A5A); /* efuse_pgm_op_ena, force no rd/wr disable */ + REG_WRITE(EFUSE_CMD, 0x02); /* efuse_pgm_cmd */ + while (REG_READ(EFUSE_CMD)); /* wait for efuse_pagm_cmd=0 */ + log_warn("burn abstract_done_0\n"); + REG_WRITE(EFUSE_CONF, 0x5AA5); /* efuse_read_op_ena, release force */ + REG_WRITE(EFUSE_CMD, 0x01); /* efuse_read_cmd */ + while (REG_READ(EFUSE_CMD)); /* wait for efuse_read_cmd=0 */ + log_debug("read EFUSE_BLK0_RDATA6 %x\n", REG_READ(EFUSE_BLK0_RDATA6)); + return true; + +} diff --git a/components/bt/Kconfig b/components/bt/Kconfig new file mode 100644 index 000000000..90ef1f3eb --- /dev/null +++ b/components/bt/Kconfig @@ -0,0 +1,23 @@ +menu "BT config" +visible if MEMMAP_BT + + +config BT_ENABLED + bool "Enable low-level BT stack" + depends on MEMMAP_BT + help + This compiles in the low-level BT stack. + +config BT_BTLE + bool "Enable BTLE" + depends on BT_ENABLED + help + This compiles BTLE support + +config BT_BT + bool "Enable classic BT" + depends on BT_ENABLED + help + This enables classic BT support + +endmenu diff --git a/components/esp32/Kconfig b/components/esp32/Kconfig new file mode 100644 index 000000000..b25780684 --- /dev/null +++ b/components/esp32/Kconfig @@ -0,0 +1,39 @@ +menu "WiFi config" + +config WIFI_ENABLED + bool "Enable low-level WiFi stack" + default "y" + help + This compiles in the low-level WiFi stack. + +config WIFI_AUTO_STARTUP + bool "Start WiFi with system startup" + default "y" + depends on WIFI_ENABLED + help + By default, WiFi is started with system startup, you can turn off this + feature and start by yourself. + +config WIFI_AUTO_CONNECT + bool "Enable auto connect" + default "y" + depends on WIFI_ENABLED + help + If station is enabled, and station config is set, this will enable WiFi + station auto connect when WiFi startup. + +config WIFI_ENENT_QUEUE_SIZE + int "WiFi event queue size" + default 32 + depends on WIFI_ENABLED + help + Config WiFi event queue size in different application. + +config WIFI_EVENT_TASK_STACK_SIZE + int "WiFi event task stack size" + default 2048 + depends on WIFI_ENABLED + help + Config WiFi event task stack size in different application. + +endmenu diff --git a/components/esp32/Makefile b/components/esp32/Makefile new file mode 100644 index 000000000..db3772c35 --- /dev/null +++ b/components/esp32/Makefile @@ -0,0 +1,20 @@ +# +# Component Makefile +# +# This Makefile should, at the very least, just include $(SDK_PATH)/make/component.mk. By default, +# this will take the sources in this directory, compile them and link them into +# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable, +# please read the SDK documents if you need to do this. +# + +LIBS := crypto core net80211 phy rtc pp wpa wps + +COMPONENT_ADD_LDFLAGS := -lesp32 \ + $(abspath libhal.a) \ + -L$(abspath lib) \ + $(addprefix -l,$(LIBS)) \ + -L $(abspath ld) \ + -T eagle.fpga32.v7.ld \ + -T eagle.fpga32.rom.addr.v7.ld + +include $(SDK_PATH)/make/component.mk diff --git a/components/esp32/abi.cpp b/components/esp32/abi.cpp new file mode 100644 index 000000000..c40dba85e --- /dev/null +++ b/components/esp32/abi.cpp @@ -0,0 +1,114 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include +#include +#include + +// using __cxxabiv1::__guard; + +void *operator new(size_t size) +{ + return malloc(size); +} + +void *operator new[](size_t size) +{ + return malloc(size); +} + +void operator delete(void * ptr) +{ + free(ptr); +} + +void operator delete[](void * ptr) +{ + free(ptr); +} + +extern "C" void __cxa_pure_virtual(void) __attribute__ ((__noreturn__)); +extern "C" void __cxa_deleted_virtual(void) __attribute__ ((__noreturn__)); + +void __cxa_pure_virtual(void) +{ + abort(); +} + +void __cxa_deleted_virtual(void) +{ + abort(); +} + +#if 0 +typedef struct { + uint8_t guard; + uint8_t ps; +} guard_t; + +extern "C" int __cxa_guard_acquire(__guard* pg) +{ + uint8_t ps = xt_rsil(15); + if (reinterpret_cast(pg)->guard) { + xt_wsr_ps(ps); + return 0; + } + reinterpret_cast(pg)->ps = ps; + return 1; +} + +extern "C" void __cxa_guard_release(__guard* pg) +{ + reinterpret_cast(pg)->guard = 1; + xt_wsr_ps(reinterpret_cast(pg)->ps); +} + +extern "C" void __cxa_guard_abort(__guard* pg) +{ + xt_wsr_ps(reinterpret_cast(pg)->ps); +} +#endif + +extern "C" void __cxa_throw_bad_array_new_length() +{ + abort(); +} + +namespace std +{ +void __throw_bad_function_call() +{ + abort(); +} + +void __throw_length_error(char const*) +{ + abort(); +} + +void __throw_bad_alloc() +{ + abort(); +} + +void __throw_logic_error(const char* str) +{ + abort(); +} + +void __throw_out_of_range(const char* str) +{ + abort(); +} +} diff --git a/components/esp32/cpu_start.c b/components/esp32/cpu_start.c new file mode 100644 index 000000000..d6e8fdd5c --- /dev/null +++ b/components/esp32/cpu_start.c @@ -0,0 +1,259 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include + +#include "esp_attr.h" +#include "esp_err.h" + +#include "rom/ets_sys.h" + +#include "soc/dport_reg.h" +#include "soc/io_mux_reg.h" + +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "freertos/semphr.h" +#include "freertos/queue.h" +#include "freertos/portmacro.h" + +#include "tcpip_adapter.h" + +#include "heap_alloc_caps.h" +#include "sdkconfig.h" +#include "esp_system.h" +#include "esp_spi_flash.h" +#include "nvs_flash.h" +#include "esp_event.h" + +static void IRAM_ATTR user_start_cpu0(void); +static void IRAM_ATTR call_user_start_cpu1(); +static void IRAM_ATTR user_start_cpu1(void); +void Cache_Read_Enable(); +extern void ets_setup_syscalls(void); + + +extern int __cpu1_entry_point; +extern int _bss_start; +extern int _bss_end; +extern int _init_start; +extern int _init_end; +extern int _iram_romjumptable_start; +extern int _iram_romjumptable_end; +extern int _iram_text_start; +extern int _iram_text_end; + +/* +We arrive here after the bootloader finished loading the program from flash. The hardware is mostly uninitialized, +flash cache is down and the app CPU is in reset. We do have a stack, so we can do the initialization in C. +*/ + +void Uart_Init(int no); +void uartAttach(); +void ets_set_appcpu_boot_addr(uint32_t ent); +int ets_getAppEntry(); + +void IRAM_ATTR call_user_start_cpu0() { + //Kill wdt + REG_CLR_BIT(0x3ff4808c, BIT(10)); //RTCCNTL+8C RTC_WDTCONFIG0 RTC_ + REG_CLR_BIT(0x6001f048, BIT(14)); //DR_REG_BB_BASE+48 + + //Move exception vectors to IRAM + asm volatile (\ + "wsr %0, vecbase\n" \ + ::"r"(&_init_start)); + + uartAttach(); + ets_install_uart_printf(); + + //Make page 0 access raise an exception + //Also some other unused pages so we can catch weirdness + //ToDo: this but nicer. + asm volatile (\ + "movi a4,0x00000000\n" \ + "movi a5,0xf\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x80000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xa0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xc0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xe0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x20000000\n" \ + "movi a5,0x0\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x40000000\n" \ + "movi a5,0x2\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "isync\n" \ + :::"a4","a5"); + + memset(&_bss_start, 0, (&_bss_end - &_bss_start) * sizeof(_bss_start)); + + //Initialize heap allocator + heap_alloc_caps_init(); + + ets_printf("Pro cpu up.\n"); +#ifndef CONFIG_FREERTOS_UNICORE + ets_printf("Running app cpu, entry point is %p\n", call_user_start_cpu1); + ets_delay_us(60000); + + SET_PERI_REG_MASK(APPCPU_CTRL_REG_B, DPORT_APPCPU_CLKGATE_EN); + SET_PERI_REG_MASK(APPCPU_CTRL_REG_A, DPORT_APPCPU_RESETTING); + CLEAR_PERI_REG_MASK(APPCPU_CTRL_REG_A, DPORT_APPCPU_RESETTING); + + + for (int i=0; i<20; i++) ets_delay_us(40000); + ets_set_appcpu_boot_addr((uint32_t)call_user_start_cpu1); + + ets_delay_us(10000); + +// while (ets_getAppEntry()==(int)call_user_start_cpu1) ; + //Because of Reasons (tm), the pro cpu cannot use the SPI flash while the app cpu is booting. +// while(((READ_PERI_REG(RTC_STORE7))&BIT(31)) == 0) ; // check APP boot complete flag + ets_delay_us(50000); + ets_delay_us(50000); + ets_printf("\n\nBack to pro cpu.\n"); +#else + CLEAR_PERI_REG_MASK(APPCPU_CTRL_REG_B, DPORT_APPCPU_CLKGATE_EN); +#endif + user_start_cpu0(); +} + + +extern int xPortGetCoreID(); + +extern int _init_start; + +/* +We arrive here because the pro CPU pulled us from reset. IRAM is in place, cache is still disabled, we can execute C code. +*/ +void IRAM_ATTR call_user_start_cpu1() { + //We need to do this ASAP because otherwise the structure to catch the SYSCALL instruction, which + //we abuse to do ROM calls, won't work. + + asm volatile (\ + "wsr %0, vecbase\n" \ + ::"r"(&_init_start)); + + //Enable SPI flash +// PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA3_U, FUNC_SD_DATA3_SPIWP); // swap PIN SDDATA3 from uart1 to spi, because cache need spi + + ets_printf("App cpu up\n"); + + //Make page 0 access raise an exception + //Also some other unused pages so we can catch weirdness + //ToDo: this but nicer. + asm volatile (\ + "movi a4,0x00000000\n" \ + "movi a5,0xf\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x80000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xa0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xc0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0xe0000000\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x20000000\n" \ + "movi a5,0x0\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "movi a4,0x40000000\n" \ + "movi a5,0x2\n" \ + "wdtlb a5,a4\n" \ + "witlb a5,a4\n" \ + "isync\n" \ + :::"a4","a5"); + + user_start_cpu1(); +} + + + +extern volatile int port_xSchedulerRunning; +extern int xPortStartScheduler(); + +void user_start_cpu1(void) { + ets_printf("App cpu is running!\n"); + //Wait for the freertos initialization is finished on CPU0 + while (port_xSchedulerRunning == 0) ; + ets_printf("Core0 started initializing FreeRTOS. Jumping to scheduler.\n"); + //Okay, start the scheduler! + xPortStartScheduler(); +} + +extern void (*__init_array_start)(void); +extern void (*__init_array_end)(void); + +extern esp_err_t app_main(); +static void do_global_ctors(void) { + void (**p)(void); + for(p = &__init_array_start; p != &__init_array_end; ++p) + (*p)(); +} + + +void user_start_cpu0(void) { + esp_err_t ret; + + ets_setup_syscalls(); + do_global_ctors(); + +#if 1 //workaround + for (uint8_t i = 5; i < 8; i++) { + ets_printf("erase sector %d\n", i); + spi_flash_erase_sector(i); + } +#endif + ets_printf("nvs_flash_init\n"); + ret = nvs_flash_init(5, 3); + if (ESP_OK != ret) { + ets_printf("nvs_flash_init fail, ret=%d\n", ret); + } + + system_init(); + + esp_event_init(NULL); + + // TODO: consider ethernet interface +#if CONFIG_WIFI_ENABLED + tcpip_adapter_init(); +#endif + +#if CONFIG_WIFI_ENABLED && CONFIG_WIFI_AUTO_STARTUP +#include "esp_wifi.h" + esp_wifi_startup(app_main); +#else + app_main(); +#endif + + vTaskStartScheduler(); +} + diff --git a/components/esp32/event.c b/components/esp32/event.c new file mode 100644 index 000000000..1a920436b --- /dev/null +++ b/components/esp32/event.c @@ -0,0 +1,306 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include + +#include "esp_err.h" +#include "esp_wifi.h" +#include "esp_event.h" + +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "freertos/queue.h" +#include "freertos/semphr.h" + +#include "tcpip_adapter.h" + +#define ESP32_WORKAROUND 1 + +#if CONFIG_WIFI_ENABLED + +#ifdef ESP32_WORKAROUND + +extern SemaphoreHandle_t stdio_mutex_tx; +#define os_printf(fmt, ...) do {\ + if (!stdio_mutex_tx) {\ + stdio_mutex_tx = xSemaphoreCreateMutex();\ + }\ +\ + xSemaphoreTake(stdio_mutex_tx, portMAX_DELAY);\ + ets_printf(fmt, ##__VA_ARGS__);\ + xSemaphoreGive(stdio_mutex_tx);\ +} while (0) + +#endif + +static xQueueHandle g_event_handler = NULL; +static system_event_cb_t g_event_handler_cb; + +#define WIFI_DEBUG os_printf +#define WIFI_API_CALL_CHECK(info, api_call, ret) \ +do{\ + esp_err_t __err = (api_call);\ + if ((ret) != __err) {\ + WIFI_DEBUG("%s %d %s ret=%d\n", __FUNCTION__, __LINE__, (info), __err);\ + return __err;\ + }\ +} while(0) + +typedef esp_err_t (*system_event_handle_fn_t)(system_event_t *e); +typedef struct { + system_event_id_t event_id; + system_event_handle_fn_t event_handle; +} system_event_handle_t; + + +static esp_err_t system_event_ap_start_handle_default(system_event_t *event); +static esp_err_t system_event_ap_stop_handle_default(system_event_t *event); +static esp_err_t system_event_sta_start_handle_default(system_event_t *event); +static esp_err_t system_event_sta_stop_handle_default(system_event_t *event); +static esp_err_t system_event_sta_connected_handle_default(system_event_t *event); +static esp_err_t system_event_sta_disconnected_handle_default(system_event_t *event); + +static system_event_handle_t g_system_event_handle_table[] = { + {SYSTEM_EVENT_WIFI_READY, NULL}, + {SYSTEM_EVENT_SCAN_DONE, NULL}, + {SYSTEM_EVENT_STA_START, system_event_sta_start_handle_default}, + {SYSTEM_EVENT_STA_STOP, system_event_sta_stop_handle_default}, + {SYSTEM_EVENT_STA_CONNECTED, system_event_sta_connected_handle_default}, + {SYSTEM_EVENT_STA_DISCONNECTED, system_event_sta_disconnected_handle_default}, + {SYSTEM_EVENT_STA_AUTHMODE_CHANGE, NULL}, + {SYSTEM_EVENT_AP_START, system_event_ap_start_handle_default}, + {SYSTEM_EVENT_AP_STOP, system_event_ap_stop_handle_default}, + {SYSTEM_EVENT_AP_STACONNECTED, NULL}, + {SYSTEM_EVENT_AP_STADISCONNECTED, NULL}, + {SYSTEM_EVENT_AP_PROBEREQRECVED, NULL}, + {SYSTEM_EVENT_MAX, NULL}, +}; + +esp_err_t system_event_ap_start_handle_default(system_event_t *event) +{ + struct ip_info ap_ip; + uint8_t ap_mac[6]; + + WIFI_API_CALL_CHECK("esp_wifi_reg_rxcb", esp_wifi_reg_rxcb(WIFI_IF_AP, (wifi_rxcb_t)tcpip_adapter_ap_input), ESP_OK); + WIFI_API_CALL_CHECK("esp_wifi_mac_get", esp_wifi_get_mac(WIFI_IF_AP, ap_mac), ESP_OK); + + tcpip_adapter_get_ip_info(TCPIP_ADAPTER_IF_AP, &ap_ip); + tcpip_adapter_start(TCPIP_ADAPTER_IF_AP, ap_mac, &ap_ip); + + return ESP_OK; +} + +esp_err_t system_event_ap_stop_handle_default(system_event_t *event) +{ + WIFI_API_CALL_CHECK("esp_wifi_reg_rxcb", esp_wifi_reg_rxcb(WIFI_IF_AP, NULL), ESP_OK); + + tcpip_adapter_stop(TCPIP_ADAPTER_IF_AP); + + return ESP_OK; +} + +esp_err_t system_event_sta_start_handle_default(system_event_t *event) +{ + struct ip_info sta_ip; + uint8_t sta_mac[6]; + + WIFI_API_CALL_CHECK("esp_wifi_mac_get", esp_wifi_get_mac(WIFI_IF_STA, sta_mac), ESP_OK); + tcpip_adapter_get_ip_info(TCPIP_ADAPTER_IF_STA, &sta_ip); + tcpip_adapter_start(TCPIP_ADAPTER_IF_STA, sta_mac, &sta_ip); + + return ESP_OK; +} + +esp_err_t system_event_sta_stop_handle_default(system_event_t *event) +{ + tcpip_adapter_stop(TCPIP_ADAPTER_IF_STA); + + return ESP_OK; +} + +esp_err_t system_event_sta_connected_handle_default(system_event_t *event) +{ + WIFI_API_CALL_CHECK("esp_wifi_reg_rxcb", esp_wifi_reg_rxcb(WIFI_IF_STA, (wifi_rxcb_t)tcpip_adapter_sta_input), ESP_OK); + + tcpip_adapter_up(TCPIP_ADAPTER_IF_STA); + tcpip_adapter_dhcpc_start(TCPIP_ADAPTER_IF_STA); + + return ESP_OK; +} + +esp_err_t system_event_sta_disconnected_handle_default(system_event_t *event) +{ + tcpip_adapter_down(TCPIP_ADAPTER_IF_STA); + WIFI_API_CALL_CHECK("esp_wifi_reg_rxcb", esp_wifi_reg_rxcb(WIFI_IF_STA, NULL), ESP_OK); + return ESP_OK; +} + +static esp_err_t esp_wifi_post_event_to_user(system_event_t *event) +{ + if (g_event_handler_cb) { + return (*g_event_handler_cb)(event); + } + + return ESP_OK; +} + +static esp_err_t esp_system_event_debug(system_event_t *event) +{ + system_event_sta_scan_done_t *scan_done; + system_event_sta_connected_t *connected; + system_event_sta_disconnected_t *disconnected; + system_event_sta_authmode_change_t *auth_change; + system_event_ap_staconnected_t *staconnected; + system_event_ap_stadisconnected_t *stadisconnected; + system_event_ap_probe_req_rx_t *ap_probereqrecved; + + if (event == NULL) { + os_printf("Error: event is null!\n"); + return ESP_FAIL; + } + + os_printf("received event: "); + switch (event->event_id) { + case SYSTEM_EVENT_WIFI_READY: + os_printf("SYSTEM_EVENT_WIFI_READY\n"); + break; + case SYSTEM_EVENT_SCAN_DONE: + scan_done = &event->event_info.scan_done; + os_printf("SYSTEM_EVENT_SCAN_DONE\nstatus:%d, number:%d\n", \ + scan_done->status, scan_done->number); + break; + case SYSTEM_EVENT_STA_START: + os_printf("SYSTEM_EVENT_STA_START\n"); + break; + case SYSTEM_EVENT_STA_STOP: + os_printf("SYSTEM_EVENT_STA_STOP\n"); + break; + case SYSTEM_EVENT_STA_CONNECTED: + connected = &event->event_info.connected; + os_printf("SYSTEM_EVENT_STA_CONNECTED\nssid:%s, ssid_len:%d, bssid:%02x:%02x:%02x:%02x:%02x:%02x, channel:%d\n", \ + connected->ssid, connected->ssid_len, connected->bssid[0], connected->bssid[0], connected->bssid[1], \ + connected->bssid[3], connected->bssid[4], connected->bssid[5], connected->channel); + break; + case SYSTEM_EVENT_STA_DISCONNECTED: + disconnected = &event->event_info.disconnected; + os_printf("SYSTEM_EVENT_STA_DISCONNECTED\nssid:%s, ssid_len:%d, bssid:%02x:%02x:%02x:%02x:%02x:%02x, reason:%d\n", \ + disconnected->ssid, disconnected->ssid_len, disconnected->bssid[0], disconnected->bssid[0], disconnected->bssid[1], \ + disconnected->bssid[3], disconnected->bssid[4], disconnected->bssid[5], disconnected->reason); + break; + case SYSTEM_EVENT_STA_AUTHMODE_CHANGE: + auth_change = &event->event_info.auth_change; + os_printf("SYSTEM_EVENT_STA_AUTHMODE_CHNAGE\nold_mode:%d, new_mode:%d\n", auth_change->old_mode, auth_change->new_mode); + break; + case SYSTEM_EVENT_AP_START: + os_printf("SYSTEM_EVENT_AP_START\n"); + break; + case SYSTEM_EVENT_AP_STOP: + os_printf("SYSTEM_EVENT_AP_STOP\n"); + break; + case SYSTEM_EVENT_AP_STACONNECTED: + staconnected = &event->event_info.sta_connected; + os_printf("SYSTEM_EVENT_AP_STACONNECTED\nmac:%02x:%02x:%02x:%02x:%02x:%02x, aid:%d\n", \ + staconnected->mac[0], staconnected->mac[0], staconnected->mac[1], \ + staconnected->mac[3], staconnected->mac[4], staconnected->mac[5], staconnected->aid); + break; + case SYSTEM_EVENT_AP_STADISCONNECTED: + stadisconnected = &event->event_info.sta_disconnected; + os_printf("SYSTEM_EVENT_AP_STADISCONNECTED\nmac:%02x:%02x:%02x:%02x:%02x:%02x, aid:%d\n", \ + stadisconnected->mac[0], stadisconnected->mac[0], stadisconnected->mac[1], \ + stadisconnected->mac[3], stadisconnected->mac[4], stadisconnected->mac[5], stadisconnected->aid); + break; + case SYSTEM_EVENT_AP_PROBEREQRECVED: + ap_probereqrecved = &event->event_info.ap_probereqrecved; + os_printf("SYSTEM_EVENT_AP_PROBEREQRECVED\nrssi:%d, mac:%02x:%02x:%02x:%02x:%02x:%02x\n", \ + ap_probereqrecved->rssi, ap_probereqrecved->mac[0], ap_probereqrecved->mac[0], ap_probereqrecved->mac[1], \ + ap_probereqrecved->mac[3], ap_probereqrecved->mac[4], ap_probereqrecved->mac[5]); + break; + default: + os_printf("Error: no such kind of event!\n"); + break; + } + + return ESP_OK; +} + +static esp_err_t esp_system_event_handler(system_event_t *event) +{ + if (event == NULL) { + os_printf("Error: event is null!\n"); + return ESP_FAIL; + } + + esp_system_event_debug(event); + if ((event->event_id < SYSTEM_EVENT_MAX) && (event->event_id == g_system_event_handle_table[event->event_id].event_id)){ + if (g_system_event_handle_table[event->event_id].event_handle){ + os_printf("enter default callback\n"); + g_system_event_handle_table[event->event_id].event_handle(event); + os_printf("exit default callback\n"); + } + } else { + os_printf("mismatch or invalid event, id=%d\n", event->event_id); + } + + return esp_wifi_post_event_to_user(event); +} + +static void esp_system_event_task(void *pvParameters) +{ + system_event_t evt; + esp_err_t ret; + + while (1) { + if (xQueueReceive(g_event_handler, &evt, portMAX_DELAY) == pdPASS) { + ret = esp_system_event_handler(&evt); + if (ret == ESP_FAIL) + os_printf("esp wifi post event to user fail!\n"); + } + } +} + +system_event_cb_t esp_event_set_cb(system_event_cb_t cb) +{ + system_event_cb_t old_cb = g_event_handler_cb; + g_event_handler_cb = cb; + return old_cb; +} + +esp_err_t esp_event_send(system_event_t *event) +{ + portBASE_TYPE ret; + + ret = xQueueSendToBack((xQueueHandle)g_event_handler, event, 0); + if (pdPASS != ret){ + if (event) ets_printf("e=%d f\n", event->event_id); + else ets_printf("e null\n"); + return ESP_FAIL; + } + + return ESP_OK; +} + +void* esp_event_get_handler(void) +{ + return (void*)g_event_handler; +} + +esp_err_t esp_event_init(system_event_cb_t cb) +{ + g_event_handler_cb = (system_event_cb_t)cb; + g_event_handler = xQueueCreate(CONFIG_WIFI_ENENT_QUEUE_SIZE, sizeof(system_event_t)); + xTaskCreatePinnedToCore(esp_system_event_task, "eventTask", CONFIG_WIFI_EVENT_TASK_STACK_SIZE, NULL, 5, NULL, 0); // TODO: rearrange task priority + return ESP_OK; +} + +#endif diff --git a/components/esp32/heap_alloc_caps.c b/components/esp32/heap_alloc_caps.c new file mode 100644 index 000000000..3f63c5d8a --- /dev/null +++ b/components/esp32/heap_alloc_caps.c @@ -0,0 +1,246 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include + +#include + +#include "heap_alloc_caps.h" +#include "spiram.h" + +/* +This file, combined with a region allocator that supports tags, solves the problem that the ESP32 has RAM that's +slightly heterogeneous. Some RAM can be byte-accessed, some allows only 32-bit accesses, some can execute memory, +some can be remapped by the MMU to only be accessed by a certain PID etc. In order to allow the most flexible +memory allocation possible, this code makes it possible to request memory that has certain capabilities. The +code will then use its knowledge of how the memory is configured along with a priority scheme to allocate that +memory in the most sane way possible. This should optimize the amount of RAM accessible to the code without +hardwiring addresses. +*/ + + +//Amount of priority slots for the tag descriptors. +#define NO_PRIOS 3 + +/* +Tag descriptors. These describe the capabilities of a bit of memory that's tagged with the index into this table. +Each tag contains NO_PRIOS entries; later entries are only taken if earlier ones can't fulfill the memory request. +*/ +static const uint32_t tagDesc[][NO_PRIOS]={ + { MALLOC_CAP_DMA|MALLOC_CAP_8BIT, MALLOC_CAP_32BIT, 0 }, //Tag 0: Plain ole D-port RAM + { 0, MALLOC_CAP_DMA|MALLOC_CAP_8BIT, MALLOC_CAP_32BIT|MALLOC_CAP_EXEC }, //Tag 1: Plain ole D-port RAM which has an alias on the I-port + { MALLOC_CAP_EXEC|MALLOC_CAP_32BIT, 0, 0 }, //Tag 2: IRAM + { MALLOC_CAP_PID2, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, //Tag 3-8: PID 2-7 IRAM + { MALLOC_CAP_PID3, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID4, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID5, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID6, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID7, 0, MALLOC_CAP_EXEC|MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID2, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, //Tag 9-14: PID 2-7 DRAM + { MALLOC_CAP_PID3, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID4, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID5, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID6, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, // + { MALLOC_CAP_PID7, MALLOC_CAP_8BIT, MALLOC_CAP_32BIT }, // + { MALLOC_CAP_SPISRAM, 0, MALLOC_CAP_DMA|MALLOC_CAP_8BIT|MALLOC_CAP_32BIT}, //Tag 15: SPI SRAM data + { MALLOC_CAP_INVALID, MALLOC_CAP_INVALID, MALLOC_CAP_INVALID } //End +}; + +/* +Region descriptors. These describe all regions of memory available, and tag them according to the +capabilities the hardware has. This array is not marked constant; the initialization code may want to +change the tags of some regions because eg BT is detected, applications are loaded etc. + +The priorities here roughly work like this: +- For a normal malloc (MALLOC_CAP_8BIT), give away the DRAM-only memory first, then pass off any dual-use IRAM regions, + finally eat into the application memory. +- For a malloc where 32-bit-aligned-only access is okay, first allocate IRAM, then DRAM, finally application IRAM. +- Application mallocs (PIDx) will allocate IRAM first, if possible, then DRAM. +- Most other malloc caps only fit in one region anyway. + +These region descriptors are very ESP32 specific, because they describe the memory pools available there. + +Because of requirements in the coalescing code as well as the heap allocator itself, this list should always +be sorted from low to high start address. + +This array is *NOT* const because it gets modified depending on what pools are/aren't available. +*/ +static HeapRegionTagged_t regions[]={ + { (uint8_t *)0x3F800000, 0x20000, 15, 0}, //SPI SRAM, if available +// { (uint8_t *)0x3FFAE000, 0x2000, 0, 0}, //pool 16 <- can be used for BT <- THIS POOL DOESN'T WORK for some reason! Hw seems fine. ToDo: Figure out. + { (uint8_t *)0x3FFB0000, 0x8000, 0, 0}, //pool 15 <- can be used for BT + { (uint8_t *)0x3FFB8000, 0x8000, 0, 0}, //pool 14 + { (uint8_t *)0x3FFC0000, 0x2000, 0, 0}, //pool 10-13, mmu page 0 + { (uint8_t *)0x3FFC2000, 0x2000, 0, 0}, //pool 10-13, mmu page 1 + { (uint8_t *)0x3FFC4000, 0x2000, 0, 0}, //pool 10-13, mmu page 2 + { (uint8_t *)0x3FFC6000, 0x2000, 0, 0}, //pool 10-13, mmu page 3 + { (uint8_t *)0x3FFC8000, 0x2000, 0, 0}, //pool 10-13, mmu page 4 + { (uint8_t *)0x3FFCA000, 0x2000, 0, 0}, //pool 10-13, mmu page 5 + { (uint8_t *)0x3FFCC000, 0x2000, 0, 0}, //pool 10-13, mmu page 6 + { (uint8_t *)0x3FFCE000, 0x2000, 0, 0}, //pool 10-13, mmu page 7 + { (uint8_t *)0x3FFD0000, 0x2000, 0, 0}, //pool 10-13, mmu page 8 + { (uint8_t *)0x3FFD2000, 0x2000, 0, 0}, //pool 10-13, mmu page 9 + { (uint8_t *)0x3FFD4000, 0x2000, 0, 0}, //pool 10-13, mmu page 10 + { (uint8_t *)0x3FFD6000, 0x2000, 0, 0}, //pool 10-13, mmu page 11 + { (uint8_t *)0x3FFD8000, 0x2000, 0, 0}, //pool 10-13, mmu page 12 + { (uint8_t *)0x3FFDA000, 0x2000, 0, 0}, //pool 10-13, mmu page 13 + { (uint8_t *)0x3FFDC000, 0x2000, 0, 0}, //pool 10-13, mmu page 14 + { (uint8_t *)0x3FFDE000, 0x2000, 0, 0}, //pool 10-13, mmu page 15 + { (uint8_t *)0x3FFE0000, 0x4000, 1, 0x400BC000}, //pool 9 blk 1 + { (uint8_t *)0x3FFE4000, 0x4000, 1, 0x400B8000}, //pool 9 blk 0 + { (uint8_t *)0x3FFE8000, 0x8000, 1, 0x400B0000}, //pool 8 <- can be remapped to ROM, used for MAC dump + { (uint8_t *)0x3FFF0000, 0x8000, 1, 0x400A8000}, //pool 7 <- can be used for MAC dump + { (uint8_t *)0x3FFF8000, 0x4000, 1, 0x400A4000}, //pool 6 blk 1 <- can be used as trace memory + { (uint8_t *)0x3FFFC000, 0x4000, 1, 0x400A0000}, //pool 6 blk 0 <- can be used as trace memory + { (uint8_t *)0x40070000, 0x8000, 2, 0}, //pool 0 + { (uint8_t *)0x40078000, 0x8000, 2, 0}, //pool 1 + { (uint8_t *)0x40080000, 0x2000, 2, 0}, //pool 2-5, mmu page 0 + { (uint8_t *)0x40082000, 0x2000, 2, 0}, //pool 2-5, mmu page 1 + { (uint8_t *)0x40084000, 0x2000, 2, 0}, //pool 2-5, mmu page 2 + { (uint8_t *)0x40086000, 0x2000, 2, 0}, //pool 2-5, mmu page 3 + { (uint8_t *)0x40088000, 0x2000, 2, 0}, //pool 2-5, mmu page 4 + { (uint8_t *)0x4008A000, 0x2000, 2, 0}, //pool 2-5, mmu page 5 + { (uint8_t *)0x4008C000, 0x2000, 2, 0}, //pool 2-5, mmu page 6 + { (uint8_t *)0x4008E000, 0x2000, 2, 0}, //pool 2-5, mmu page 7 + { (uint8_t *)0x40090000, 0x2000, 2, 0}, //pool 2-5, mmu page 8 + { (uint8_t *)0x40092000, 0x2000, 2, 0}, //pool 2-5, mmu page 9 + { (uint8_t *)0x40094000, 0x2000, 2, 0}, //pool 2-5, mmu page 10 + { (uint8_t *)0x40096000, 0x2000, 2, 0}, //pool 2-5, mmu page 11 + { (uint8_t *)0x40098000, 0x2000, 2, 0}, //pool 2-5, mmu page 12 + { (uint8_t *)0x4009A000, 0x2000, 2, 0}, //pool 2-5, mmu page 13 + { (uint8_t *)0x4009C000, 0x2000, 2, 0}, //pool 2-5, mmu page 14 + { (uint8_t *)0x4009E000, 0x2000, 2, 0}, //pool 2-5, mmu page 15 + { NULL, 0, 0, 0} //end +}; + + +//Modify regions array to disable the given range of memory. +static void disable_mem_region(void *from, void *to) { + int i; + //Align from and to on word boundaries + from=(void*)((uint32_t)from&~3); + to=(void*)(((uint32_t)to+3)&~3); + for (i=0; regions[i].xSizeInBytes!=0; i++) { + void *regStart=regions[i].pucStartAddress; + void *regEnd=regions[i].pucStartAddress+regions[i].xSizeInBytes; + if (regStart>=from && regEnd<=to) { + //Entire region falls in the range. Disable entirely. + regions[i].xTag=-1; + } else if (regStart>=from && regEnd>to && regStartfrom && regEnd<=to) { + //End of the region falls in the range. Modify length. + regions[i].xSizeInBytes-=(uint8_t *)regEnd-(uint8_t *)from; + } else if (regStartto) { + //Range punches a hole in the region! We do not support this. + ets_printf("%s: region %d: hole punching is not supported!\n", i); + regions[i].xTag=-1; //Just disable memory region. That'll teach them! + } + } +} + + +/* +ToDo: These are very dependent on the linker script, and the logic involving this works only +because we're not using the SPI flash yet! If we enable that, this will break. ToDo: Rewrite by then. +*/ +extern int _init_start, _text_end; +extern int _bss_start, _heap_start; + +/* +Initialize the heap allocator. We pass it a bunch of region descriptors, but we need to modify those first to accommodate for +the data as loaded by the bootloader. +ToDo: The regions are different when stuff like trace memory, BT, ... is used. Modify the regions struct on the fly for this. +Same with loading of apps. Same with using SPI RAM. +*/ +void heap_alloc_caps_init() { + int i; + //Disable the bits of memory where this code is loaded. + disable_mem_region(&_init_start, &_text_end); + disable_mem_region(&_bss_start, &_heap_start); + disable_mem_region((void*)0x3ffae000, (void*)0x3ffb0000); //knock out ROM data region + disable_mem_region((void*)0x3ffe0000, (void*)0x3ffe8000); //knock out ROM data region + disable_mem_region((void*)0x40070000, (void*)0x40078000); //CPU0 cache region + disable_mem_region((void*)0x40078000, (void*)0x40080000); //CPU1 cache region +#if 0 + enable_spi_sram(); +#else + disable_mem_region((void*)0x3f800000, (void*)0x3f820000); //SPI SRAM not installed +#endif + + //The heap allocator will treat every region given to it as separate. In order to get bigger ranges of contiguous memory, + //it's useful to coalesce adjacent regions that have the same tag. + + for (i=1; regions[i].xSizeInBytes!=0; i++) { + if (regions[i].pucStartAddress == (regions[i-1].pucStartAddress + regions[i-1].xSizeInBytes) && + regions[i].xTag == regions[i-1].xTag ) { + regions[i-1].xTag=-1; + regions[i].pucStartAddress=regions[i-1].pucStartAddress; + regions[i].xSizeInBytes+=regions[i-1].xSizeInBytes; + } + } + +#if 1 //Change to 1 to show the regions the heap allocator is initialized with. + ets_printf("Initializing heap allocator:\n"); + for (i=0; regions[i].xSizeInBytes!=0; i++) { + if ( regions[i].xTag != -1 ) ets_printf("Region %02d: %08X len %08X tag %d\n", i, (int)regions[i].pucStartAddress, regions[i].xSizeInBytes, regions[i].xTag); + } +#endif + //Initialize the malloc implementation. + vPortDefineHeapRegionsTagged( regions ); +} + +/* +Standard malloc() implementation. Will return ho-hum byte-accessible data memory. +*/ +void *pvPortMalloc( size_t xWantedSize ) +{ + return pvPortMallocCaps( xWantedSize, MALLOC_CAP_8BIT ); +} + +/* +Routine to allocate a bit of memory with certain capabilities. caps is a bitfield of MALLOC_CAP_* bits. +*/ +void *pvPortMallocCaps( size_t xWantedSize, uint32_t caps ) +{ + int prio; + int tag, j; + void *ret=NULL; + uint32_t remCaps; + for (prio=0; prio + +#ifdef __cplusplus +extern "C" { +#endif + +typedef int32_t esp_err_t; + +/* Definitions for error constants. */ + +#define ESP_OK 0 +#define ESP_FAIL -1 + +#define ESP_ERR_NO_MEM 0x101 + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_ERR_H__ */ diff --git a/components/esp32/include/esp_event.h b/components/esp32/include/esp_event.h new file mode 100755 index 000000000..8a34eb569 --- /dev/null +++ b/components/esp32/include/esp_event.h @@ -0,0 +1,107 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_EVENT_H__ +#define __ESP_EVENT_H__ + +#include +#include + +#include "esp_err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef enum { + SYSTEM_EVENT_WIFI_READY = 0, /**< ESP32 wifi ready */ + SYSTEM_EVENT_SCAN_DONE, /**< ESP32 finish scanning AP */ + SYSTEM_EVENT_STA_START, /**< ESP32 station start */ + SYSTEM_EVENT_STA_STOP, /**< ESP32 station start */ + SYSTEM_EVENT_STA_CONNECTED, /**< ESP32 station connected to AP */ + SYSTEM_EVENT_STA_DISCONNECTED, /**< ESP32 station disconnected to AP */ + SYSTEM_EVENT_STA_AUTHMODE_CHANGE, /**< the auth mode of AP connected by ESP32 station changed */ + SYSTEM_EVENT_AP_START, /**< ESP32 softap start */ + SYSTEM_EVENT_AP_STOP, /**< ESP32 softap start */ + SYSTEM_EVENT_AP_STACONNECTED, /**< a station connected to ESP32 soft-AP */ + SYSTEM_EVENT_AP_STADISCONNECTED, /**< a station disconnected to ESP32 soft-AP */ + SYSTEM_EVENT_AP_PROBEREQRECVED, /**< Receive probe request packet in soft-AP interface */ + SYSTEM_EVENT_MAX +} system_event_id_t; + +typedef struct { + uint32_t status; /**< status of scanning APs*/ + uint8_t number; +} system_event_sta_scan_done_t; + +typedef struct { + uint8_t ssid[32]; /**< SSID of connected AP */ + uint8_t ssid_len; /**< SSID length of connected AP */ + uint8_t bssid[6]; /**< BSSID of connected AP*/ + uint8_t channel; /**< channel of connected AP*/ +} system_event_sta_connected_t; + +typedef struct { + uint8_t ssid[32]; /**< SSID of disconnected AP */ + uint8_t ssid_len; /**< SSID length of disconnected AP */ + uint8_t bssid[6]; /**< BSSID of disconnected AP */ + uint8_t reason; /**< reason of disconnection */ +} system_event_sta_disconnected_t; + +typedef struct { + uint8_t old_mode; /**< the old auth mode of AP */ + uint8_t new_mode; /**< the new auth mode of AP */ +} system_event_sta_authmode_change_t; + +typedef struct { + uint8_t mac[6]; /**< MAC address of the station connected to ESP32 soft-AP */ + uint8_t aid; /**< the aid that ESP32 soft-AP gives to the station connected to */ +} system_event_ap_staconnected_t; + +typedef struct { + uint8_t mac[6]; /**< MAC address of the station disconnects to ESP32 soft-AP */ + uint8_t aid; /**< the aid that ESP32 soft-AP gave to the station disconnects to */ +} system_event_ap_stadisconnected_t; + +typedef struct { + int rssi; /**< Received probe request signal strength */ + uint8_t mac[6]; /**< MAC address of the station which send probe request */ +} system_event_ap_probe_req_rx_t; + +typedef union { + system_event_sta_connected_t connected; /**< ESP32 station connected to AP */ + system_event_sta_disconnected_t disconnected; /**< ESP32 station disconnected to AP */ + system_event_sta_scan_done_t scan_done; /**< ESP32 station scan (APs) done */ + system_event_sta_authmode_change_t auth_change; /**< the auth mode of AP ESP32 station connected to changed */ + system_event_ap_staconnected_t sta_connected; /**< a station connected to ESP32 soft-AP */ + system_event_ap_stadisconnected_t sta_disconnected; /**< a station disconnected to ESP32 soft-AP */ + system_event_ap_probe_req_rx_t ap_probereqrecved; /**< ESP32 softAP receive probe request packet */ +} system_event_info_t; + +typedef struct { + system_event_id_t event_id; /**< even ID */ + system_event_info_t event_info; /**< event information */ +} system_event_t; + +typedef esp_err_t (*system_event_cb_t)(system_event_t *event); +system_event_cb_t esp_event_set_cb(system_event_cb_t cb); +esp_err_t esp_event_send(system_event_t * event); +void* esp_event_get_handler(void); +esp_err_t esp_event_init(system_event_cb_t cb); + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_EVENT_H__ */ diff --git a/components/esp32/include/esp_ssc.h b/components/esp32/include/esp_ssc.h new file mode 100644 index 000000000..02893ff41 --- /dev/null +++ b/components/esp32/include/esp_ssc.h @@ -0,0 +1,119 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_SSC_H__ +#define __ESP_SSC_H__ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#define CMD_T_ASYNC 0x01 +#define CMD_T_SYNC 0x02 + +typedef struct cmd_s { + char *cmd_str; + uint8_t flag; + uint8_t id; + void (* cmd_func)(void); + void (* cmd_callback)(void *arg); +} ssc_cmd_t; + +#define MAX_LINE_N 127 + +typedef enum { + SSC_BR_9600 = 9600, + SSC_BR_19200 = 19200, + SSC_BR_38400 = 38400, + SSC_BR_57600 = 57600, + SSC_BR_74880 = 74880, + SSC_BR_115200 = 115200, + SSC_BR_230400 = 230400, + SSC_BR_460800 = 460800, + SSC_BR_921600 = 921600 +} SscBaudRate; + +/** \defgroup SSC_APIs SSC APIs + * @brief SSC APIs + * + * SSC means simple serial command. + * SSC APIs allows users to define their own command, users can refer to spiffs_test/test_main.c. + * + */ + +/** @addtogroup SSC_APIs + * @{ + */ + +/** + * @brief Initial the ssc function. + * + * @attention param is no use, just compatible with ESP8266, default bandrate is 115200 + * + * @param SscBaudRate bandrate : baud rate + * + * @return null + */ +void ssc_attach(SscBaudRate bandrate); + +/** + * @brief Get the length of the simple serial command. + * + * @param null + * + * @return length of the command. + */ +int ssc_param_len(void); + +/** + * @brief Get the simple serial command string. + * + * @param null + * + * @return the command. + */ +char *ssc_param_str(void); + +/** + * @brief Parse the simple serial command (ssc). + * + * @param char *pLine : [input] the ssc string + * @param char *argv[] : [output] parameters of the ssc + * + * @return the number of parameters. + */ +int ssc_parse_param(char *pLine, char *argv[]); + +/** + * @brief Register the user-defined simple serial command (ssc) set. + * + * @param ssc_cmd_t *cmdset : the ssc set + * @param uint8 cmdnum : number of commands + * @param void (* help)(void) : callback of user-guide + * + * @return null + */ +void ssc_register(ssc_cmd_t *cmdset, uint8_t cmdnum, void (* help)(void)); + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_SSC_H__ */ diff --git a/components/esp32/include/esp_system.h b/components/esp32/include/esp_system.h new file mode 100644 index 000000000..4f140db91 --- /dev/null +++ b/components/esp32/include/esp_system.h @@ -0,0 +1,364 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_SYSTEM_H__ +#define __ESP_SYSTEM_H__ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** \defgroup System_APIs System APIs + * @brief System APIs + */ + +/** @addtogroup System_APIs + * @{ + */ + +/** + * @brief Get information of the SDK version. + * + * @param null + * + * @return Information of the SDK version. + */ +const char *system_get_sdk_version(void); + +/** + * @brief Reset to default settings. + * + * Reset to default settings of the following APIs : wifi_station_set_auto_connect, + * wifi_set_phy_mode, wifi_softap_set_config related, wifi_station_set_config + * related, and wifi_set_opmode. + * + * @param null + * + * @return null + */ +void system_restore(void); + +/** + * @brief Restart system. + * + * @param null + * + * @return null + */ +void system_restart(void); + +/** + * @brief Set the chip to deep-sleep mode. + * + * The device will automatically wake up after the deep-sleep time set + * by the users. Upon waking up, the device boots up from user_init. + * + * @attention The parameter time_in_us to be "uint64" is for further development. + * Only the low 32 bits of parameter time_in_us are avalable now. + * + * @param uint64 time_in_us : deep-sleep time, only the low 32bits are avalable now. unit: microsecond + * + * @return null + */ +void system_deep_sleep(uint64_t time_in_us); + +/** + * @brief Get system time, unit: microsecond. + * + * @param null + * + * @return System time, unit: microsecond. + */ +uint32_t system_get_time(void); + +/** + * @brief Print the system memory distribution, including data/rodata/bss/heap. + * + * @param null + * + * @return null + */ +void system_print_meminfo(void); + +/** + * @brief Get the size of available heap. + * + * @param null + * + * @return Available heap size. + */ +uint32_t system_get_free_heap_size(void); + +/** + * @brief Get the chip ID. + * + * Example: + *
 
+  *         uint8 chip_id[6];
+  *         system_get_chip_id(chip_id);
+  * 
+ * + * @param uint8 *chip_id : the chip ID + * + * @return true : succeed + * @return false : fail + */ +bool system_get_chip_id(uint8_t *chip_id); + +/** + * @brief Get RTC time, unit: RTC clock cycle. + * + * @param null + * + * @return RTC time. + */ +uint64_t system_get_rtc_time(void); + +/** + * @brief Read user data from the RTC memory. + * + * The user data segment (1024 bytes, as shown below) is used to store user data. + * + * |<---- system data(512 bytes) ---->|<----------- user data(1024 bytes) --------->| + * + * @attention Read and write unit for data stored in the RTC memory is 4 bytes. + * @attention src_addr is the block number (4 bytes per block). So when reading data + * at the beginning of the user data segment, src_addr will be 512/4 = 128, + * n will be data length. + * + * @param uint16 src : source address of rtc memory, src_addr >= 128 + * @param void *dst : data pointer + * @param uint16 n : data length, unit: byte + * + * @return true : succeed + * @return false : fail + */ +bool system_rtc_mem_read(uint16_t src, void *dst, uint16_t n); + +/** + * @brief Write user data to the RTC memory. + * + * During deep-sleep, only RTC is working. So users can store their data + * in RTC memory if it is needed. The user data segment below (1024 bytes) + * is used to store the user data. + * + * |<---- system data(512 bytes) ---->|<----------- user data(1024 bytes) --------->| + * + * @attention Read and write unit for data stored in the RTC memory is 4 bytes. + * @attention src_addr is the block number (4 bytes per block). So when storing data + * at the beginning of the user data segment, src_addr will be 512/4 = 128, + * n will be data length. + * + * @param uint16 src : source address of rtc memory, src_addr >= 128 + * @param void *dst : data pointer + * @param uint16 n : data length, unit: byte + * + * @return true : succeed + * @return false : fail + */ +bool system_rtc_mem_write(uint16_t dst, const void *src, uint16_t n); + +typedef enum { + ADC1_PAD_GPIO36 = 0, + ADC1_PAD_GPIO37, + ADC1_PAD_GPIO38, + ADC1_PAD_GPIO39, + ADC1_PAD_GPIO32, + ADC1_PAD_GPIO33, + ADC1_PAD_GPIO34, + ADC1_PAD_GPIO35 +} adc1_read_pad_t; + +typedef enum { + ADC1_ATTEN_0DB = 0, + ADC1_ATTEN_3DB, + ADC1_ATTEN_6DB, + ADC1_ATTEN_12DB +} adc1_read_atten_t; + +/** + * @brief Read ADC1. + * + * @param adc1_read_pad pad : the corresponding GPIO + * @param adc1_read_atten atten : value of attenuation + * + * @return range of the return value is [0, 4096]. + * - If atten == 0, the range of voltage can be measured is [0, 1] V. + * - If atten == 1, the range of voltage can be measured is [0, 1.4] V. + * - If atten == 2, the range of voltage can be measured is [0, 2] V. + * - If atten == 3, the range of voltage can be measured is [0, 4] V. + */ +uint16_t system_adc1_read(adc1_read_pad_t pad, adc1_read_atten_t atten); + +/** + * @brief Measure the power voltage of VDD3P3 pin 3 and 4, unit : 1/1024 V. + * + * @attention system_get_vdd33 depends on RF, please do not use it if RF is disabled. + * + * @param null + * + * @return Power voltage of VDD33, unit : 1/1024 V + */ +uint16_t system_get_vdd33(void); + +/** + * @brief Write data into flash with protection. + * + * Flash read/write has to be 4-bytes aligned. + * + * Protection of flash read/write : + * use 3 sectors (4KBytes per sector) to save 4KB data with protect, + * sector 0 and sector 1 are data sectors, back up each other, + * save data alternately, sector 2 is flag sector, point out which sector + * is keeping the latest data, sector 0 or sector 1. + * + * @param uint16 start_sec : start sector (sector 0) of the 3 sectors which are + * used for flash read/write protection. + * - For example, in IOT_Demo we can use the 3 sectors (3 * 4KB) starting from flash + * 0x3D000 for flash read/write protection, so the parameter start_sec should be 0x3D + * @param void *param : pointer of the data to be written + * @param uint16 len : data length, should be less than a sector, which is 4 * 1024 + * + * @return true : succeed + * @return false : fail + */ +bool system_param_save_with_protect(uint16_t start_sec, void *param, uint16_t len); + +/** + * @brief Read the data saved into flash with the read/write protection. + * + * Flash read/write has to be 4-bytes aligned. + * + * Read/write protection of flash: + * use 3 sectors (4KB per sector) to save 4KB data with protect, sector + * 0 and sector 1 are data sectors, back up each other, save data alternately, + * sector 2 is flag sector, point out which sector is keeping the latest data, + * sector 0 or sector 1. + * + * @param uint16 start_sec : start sector (sector 0) of the 3 sectors used for + * flash read/write protection. It cannot be sector 1 or sector 2. + * - For example, in IOT_Demo, the 3 sectors (3 * 4KB) starting from flash 0x3D000 + * can be used for flash read/write protection. + * The parameter start_sec is 0x3D, and it cannot be 0x3E or 0x3F. + * @param uint16 offset : offset of data saved in sector + * @param void *param : data pointer + * @param uint16 len : data length, offset + len =< 4 * 1024 + * + * @return true : succeed + * @return false : fail + */ +bool system_param_load(uint16_t start_sec, uint16_t offset, void *param, uint16_t len); + + +/** \defgroup System_boot_APIs Boot APIs + * @brief boot APIs + */ + +/** @addtogroup System_boot_APIs + * @{ + */ + +/** + * @} + */ + +/** \defgroup Hardware_MAC_APIs Hardware MAC APIs + * @brief Hardware MAC address APIs + * + * In WiFi MAC, only ESP32 station MAC is the hardware MAC, ESP32 softAP MAC is a software MAC + * calculated from ESP32 station MAC. + * So users need to call wifi_get_macaddr to query the ESP32 softAP MAC if ESP32 station MAC changed. + * + */ + +/** @addtogroup Hardware_MAC_APIs + * @{ + */ + +typedef enum { + DEFAULT_MAC = 0, /**< Default hardware MAC provided by Espressif Systems */ + USER_MAC, /**< User-define hardware MAC */ +} mac_group_t; + +typedef enum { + WIFI_MAC = 0, /**< Hardware MAC address of ESP32 WiFi */ + BT_MAC, /**< Hardware MAC address of ESP32 bluetooth */ +} mac_type_t; + +/** + * @brief Set user-define hardware MAC address. + * + * @attention Hardware MAC address can only be set ONCE for each ESP32 chip. + * + * @param mac_type type : type of hardware MAC address. + * @param uint8 *mac : user-define hardware MAC address, length: 6 bytes. + * + * @return 0 : succeed to set. + * @return 1 : the hardware MAC has been set once, users can not set it any more. + * @return 2 : fail to set. + * @return 3 : invalid parameter. + */ +int system_efuse_program_user_mac(mac_type_t type, uint8_t *mac); + +/** + * @brief Read hardware MAC address. + * + * @param mac_group group : default MAC or user-defined MAC. + * @param mac_type type : type of hardware MAC address. + * @param uint8 *mac : the hardware MAC address, length: 6 bytes. + * + * @return true : succeed + * @return false : fail + */ +bool system_efuse_read_mac(mac_group_t group, mac_type_t type, uint8_t *mac); + +/** + * @brief Set hardware MAC group, default MAC or user-defined MAC. + * + * @attention This API needs system_restart to take effect. + * + * @param mac_group group : default MAC or user-defined MAC. + * + * @return true : succeed + * @return false : fail + */ +bool system_efuse_set_mac_group(mac_group_t group); + +/** + * @brief Get hardware MAC group, default MAC or user-defined MAC. + * + * @param null + * + * @return mac_group, the hardware MAC group. + */ +mac_group_t system_efuse_get_mac_group(void); + +void system_init(void); + +/** + * @} + */ + + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_SYSTEM_H__ */ diff --git a/components/esp32/include/esp_types.h b/components/esp32/include/esp_types.h new file mode 100755 index 000000000..c142aee68 --- /dev/null +++ b/components/esp32/include/esp_types.h @@ -0,0 +1,73 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_TYPES_H__ +#define __ESP_TYPES_H__ + +#ifdef __GNUC__ +#include +#endif /*__GNUC__*/ +#include +#include +#include + +#define __ATTRIB_PACK __attribute__ ((packed)) +#define __ATTRIB_PRINTF __attribute__ ((format (printf, 1, 2))) +#define __ATTRIB_NORETURN __attribute__ ((noreturn)) +#define __ATTRIB_ALIGN(x) __attribute__ ((aligned((x)))) +#define INLINE __inline__ + +#define LOCAL static + +/* probably should not put STATUS here */ +typedef enum { + OK = 0, + FAIL, + PENDING, + BUSY, + CANCEL, +} STATUS; + +//#define _LITTLE_ENDIAN 1234 +//#define _BYTE_ORDER == _LITTLE_ENDIAN + +#define ASSERT( x ) do { \ + if (!(x)) { \ + printf("%s %u\n", __FILE__, __LINE__); \ + while (1) { \ + asm volatile("nop"); \ + }; \ + } \ +} while (0) + +/* #if __GNUC_PREREQ__(4, 1) */ +#ifndef __GNUC__ +#if 1 +#define __offsetof(type, field) __builtin_offsetof(type, field) +#else +#define __offsetof(type, field) ((size_t)(&((type *)0)->field)) +#endif +#endif /* __GNUC__ */ + + +/* Macros for counting and rounding. */ +#ifndef howmany +#define howmany(x, y) (((x)+((y)-1))/(y)) +#endif + +#define container_of(ptr, type, member) ({ \ + const typeof( ((type *)0)->member ) *__mptr = (ptr); \ + (type *)( (char *)__mptr - __offsetof(type,member) );}) + +#endif /* __ESP_TYPES_H__ */ diff --git a/components/esp32/include/esp_wifi.h b/components/esp32/include/esp_wifi.h new file mode 100755 index 000000000..bdd125395 --- /dev/null +++ b/components/esp32/include/esp_wifi.h @@ -0,0 +1,231 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_WIFI_H__ +#define __ESP_WIFI_H__ + +#include +#include + +#include "esp_err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef enum { + WIFI_MODE_NULL = 0, /**< null mode */ + WIFI_MODE_STA, /**< WiFi station mode */ + WIFI_MODE_AP, /**< WiFi soft-AP mode */ + WIFI_MODE_APSTA, /**< WiFi station + soft-AP mode */ + WIFI_MODE_MAX +} wifi_mode_t; + +typedef enum { + WIFI_IF_STA = 0, /**< ESP32 station interface */ + WIFI_IF_AP, /**< ESP32 soft-AP interface */ + WIFI_IF_MAX +} wifi_interface_t; + +typedef enum { + WIFI_COUNTRY_CN = 0, + WIFI_COUNTRY_JP, + WIFI_COUNTRY_US, + WIFI_COUNTRY_EU, + WIFI_COUNTRY_MAX +} wifi_country_t; + +typedef enum { + WIFI_AUTH_OPEN = 0, /**< authenticate mode : open */ + WIFI_AUTH_WEP, /**< authenticate mode : WEP */ + WIFI_AUTH_WPA_PSK, /**< authenticate mode : WPA_PSK */ + WIFI_AUTH_WPA2_PSK, /**< authenticate mode : WPA2_PSK */ + WIFI_AUTH_WPA_WPA2_PSK, /**< authenticate mode : WPA_WPA2_PSK */ + WIFI_AUTH_MAX +} wifi_auth_mode_t; + +enum { + WIFI_REASON_UNSPECIFIED = 1, + WIFI_REASON_AUTH_EXPIRE = 2, + WIFI_REASON_AUTH_LEAVE = 3, + WIFI_REASON_ASSOC_EXPIRE = 4, + WIFI_REASON_ASSOC_TOOMANY = 5, + WIFI_REASON_NOT_AUTHED = 6, + WIFI_REASON_NOT_ASSOCED = 7, + WIFI_REASON_ASSOC_LEAVE = 8, + WIFI_REASON_ASSOC_NOT_AUTHED = 9, + WIFI_REASON_DISASSOC_PWRCAP_BAD = 10, + WIFI_REASON_DISASSOC_SUPCHAN_BAD = 11, + WIFI_REASON_IE_INVALID = 13, + WIFI_REASON_MIC_FAILURE = 14, + WIFI_REASON_4WAY_HANDSHAKE_TIMEOUT = 15, + WIFI_REASON_GROUP_KEY_UPDATE_TIMEOUT = 16, + WIFI_REASON_IE_IN_4WAY_DIFFERS = 17, + WIFI_REASON_GROUP_CIPHER_INVALID = 18, + WIFI_REASON_PAIRWISE_CIPHER_INVALID = 19, + WIFI_REASON_AKMP_INVALID = 20, + WIFI_REASON_UNSUPP_RSN_IE_VERSION = 21, + WIFI_REASON_INVALID_RSN_IE_CAP = 22, + WIFI_REASON_802_1X_AUTH_FAILED = 23, + WIFI_REASON_CIPHER_SUITE_REJECTED = 24, + + WIFI_REASON_BEACON_TIMEOUT = 200, + WIFI_REASON_NO_AP_FOUND = 201, + WIFI_REASON_AUTH_FAIL = 202, + WIFI_REASON_ASSOC_FAIL = 203, + WIFI_REASON_HANDSHAKE_TIMEOUT = 204, +}; + +typedef enum { + WIFI_SECOND_CHAN_NONE = 0, + WIFI_SECOND_CHAN_ABOVE, + WIFI_SECOND_CHAN_BELOW, +} wifi_second_chan_t; + +typedef esp_err_t (* wifi_startup_cb_t)(void); + +void esp_wifi_startup(wifi_startup_cb_t cb); + +typedef struct { + void *event_q; + uint8_t rx_ba_win; /**< TBC */ + uint8_t tx_ba_win; /**< TBC */ + uint8_t rx_buf_cnt; /**< TBC */ + uint8_t tx_buf_cnt; /**< TBC */ +} wifi_init_config_t; + +esp_err_t esp_wifi_init(wifi_init_config_t *config); + +esp_err_t esp_wifi_deinit(void); + +esp_err_t esp_wifi_set_mode(wifi_mode_t mode); + +esp_err_t esp_wifi_get_mode(wifi_mode_t *mode); + +esp_err_t esp_wifi_start(void); + +esp_err_t esp_wifi_stop(void); + +esp_err_t esp_wifi_connect(void); + +esp_err_t esp_wifi_disconnect(void); + +typedef struct { + char *ssid; /**< SSID of AP */ + uint8_t *bssid; /**< MAC address of AP */ + uint8_t channel; /**< channel, scan the specific channel */ + bool show_hidden; /**< enable to scan AP whose SSID is hidden */ +} wifi_scan_config_t; + +esp_err_t esp_wifi_scan_start(wifi_scan_config_t *conf); + +esp_err_t esp_wifi_scan_stop(void); + +esp_err_t esp_wifi_get_ap_num(uint16_t *number); + +typedef struct { + uint8_t bssid[6]; /**< MAC address of AP */ + uint8_t ssid[32]; /**< SSID of AP */ + uint8_t primary; /**< channel of AP */ + wifi_second_chan_t second; /**< second channel of AP */ + char rssi; /**< single strength of AP */ + wifi_auth_mode_t authmode; /**< authmode of AP */ +}wifi_ap_list_t; + +esp_err_t esp_wifi_get_ap_list(uint16_t *number, wifi_ap_list_t *ap_list); + +typedef enum { + WIFI_PS_NONE, + WIFI_PS_MODEM, + WIFI_PS_LIGHT, + WIFI_PS_MAC, +} wifi_ps_type_t; + +esp_err_t esp_wifi_set_ps(wifi_ps_type_t type); + +esp_err_t esp_wifi_get_ps(wifi_ps_type_t *type); + +#define WIFI_PROTOCOL_11B 1 +#define WIFI_PROTOCOL_11G 2 +#define WIFI_PROTOCOL_11N 4 + +esp_err_t esp_wifi_set_protocol(wifi_interface_t ifx, uint8_t protocol); + +esp_err_t esp_wifi_get_protocol(wifi_interface_t ifx, uint8_t *protocol); + +typedef enum { + WIFI_BW_HT20 = 0, + WIFI_BW_HT40, +} wifi_bandwidth_t; + +esp_err_t esp_wifi_set_bandwidth(wifi_interface_t ifx, wifi_bandwidth_t bw); + +esp_err_t esp_wifi_get_bandwidth(wifi_interface_t ifx, wifi_bandwidth_t *bw); + +esp_err_t esp_wifi_set_channel(uint8_t primary, wifi_second_chan_t second); + +esp_err_t esp_wifi_get_channel(uint8_t *primary, wifi_second_chan_t *second); + +esp_err_t esp_wifi_set_country(wifi_country_t country); + +esp_err_t esp_wifi_get_country(wifi_country_t *country); + +esp_err_t esp_wifi_set_mac(wifi_interface_t ifx, uint8_t mac[6]); + +esp_err_t esp_wifi_get_mac(wifi_interface_t ifx, uint8_t mac[6]); + +typedef void (* wifi_promiscuous_cb_t)(void *buf, uint16_t len); + +wifi_promiscuous_cb_t wifi_set_promiscuous_rx_cb(wifi_promiscuous_cb_t cb); + +esp_err_t esp_wifi_set_promiscuous(uint8_t enable); + +esp_err_t esp_wifi_get_promiscuous(uint8_t *enable); + +typedef struct { + char ssid[32]; /**< SSID of ESP32 soft-AP */ + char password[64]; /**< Password of ESP32 soft-AP */ + uint8_t ssid_len; /**< Length of SSID. If softap_config.ssid_len==0, check the SSID until there is a termination character; otherwise, set the SSID length according to softap_config.ssid_len. */ + uint8_t channel; /**< Channel of ESP32 soft-AP */ + wifi_auth_mode_t authmode; /**< Auth mode of ESP32 soft-AP. Do not support AUTH_WEP in soft-AP mode */ + uint8_t ssid_hidden; /**< Broadcast SSID or not, default 0, broadcast the SSID */ + uint8_t max_connection; /**< Max number of stations allowed to connect in, default 4, max 4 */ + uint16_t beacon_interval; /**< Beacon interval, 100 ~ 60000 ms, default 100 */ +} wifi_ap_config_t; + +typedef struct { + char ssid[32]; /**< SSID of target AP*/ + char password[64]; /**< password of target AP*/ + bool bssid_set; /**< whether set MAC address of target AP or not. Generally, station_config.bssid_set needs to be 0; and it needs to be 1 only when users need to check the MAC address of the AP.*/ + uint8_t bssid[6]; /**< MAC address of target AP*/ +} wifi_sta_config_t; + +typedef union { + wifi_ap_config_t ap; + wifi_sta_config_t sta; +} wifi_config_t; + +esp_err_t esp_wifi_set_config(wifi_interface_t ifx, wifi_config_t *conf); + +esp_err_t esp_wifi_get_config(wifi_interface_t ifx, wifi_config_t *conf); + +typedef esp_err_t (*wifi_rxcb_t)(void *buffer, uint16_t len, void* eb); + +esp_err_t esp_wifi_reg_rxcb(wifi_interface_t ifx, wifi_rxcb_t fn); + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_WIFI_H__ */ diff --git a/components/esp32/include/esp_wps.h b/components/esp32/include/esp_wps.h new file mode 100644 index 000000000..b37fe542e --- /dev/null +++ b/components/esp32/include/esp_wps.h @@ -0,0 +1,131 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef __ESP_WPS_H__ +#define __ESP_WPS_H__ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** \defgroup WiFi_APIs WiFi Related APIs + * @brief WiFi APIs + */ + +/** @addtogroup WiFi_APIs + * @{ + */ + +/** \defgroup WPS_APIs WPS APIs + * @brief ESP32 WPS APIs + * + * WPS can only be used when ESP32 station is enabled. + * + */ + +/** @addtogroup WPS_APIs + * @{ + */ + +typedef enum wps_type { + WPS_TYPE_DISABLE = 0, + WPS_TYPE_PBC, + WPS_TYPE_PIN, + WPS_TYPE_DISPLAY, + WPS_TYPE_MAX, +} WPS_TYPE_t; + +enum wps_cb_status { + WPS_CB_ST_SUCCESS = 0, /**< WPS succeed */ + WPS_CB_ST_FAILED, /**< WPS fail */ + WPS_CB_ST_TIMEOUT, /**< WPS timeout, fail */ + WPS_CB_ST_WEP, /**< WPS failed because that WEP is not supported */ + WPS_CB_ST_SCAN_ERR, /**< can not find the target WPS AP */ +}; + +/** + * @brief Enable Wi-Fi WPS function. + * + * @attention WPS can only be used when ESP32 station is enabled. + * + * @param WPS_TYPE_t wps_type : WPS type, so far only WPS_TYPE_PBC is supported + * + * @return true : succeed + * @return false : fail + */ +bool wifi_wps_enable(WPS_TYPE_t wps_type); + +/** + * @brief Disable Wi-Fi WPS function and release resource it taken. + * + * @param null + * + * @return true : succeed + * @return false : fail + */ +bool wifi_wps_disable(void); + +/** + * @brief WPS starts to work. + * + * @attention WPS can only be used when ESP32 station is enabled. + * + * @param null + * + * @return true : WPS starts to work successfully, but does not mean WPS succeed. + * @return false : fail + */ +bool wifi_wps_start(void); + +/** + * @brief WPS callback. + * + * @param int status : status of WPS, enum wps_cb_status. + * - If parameter status == WPS_CB_ST_SUCCESS in WPS callback, it means WPS got AP's + * information, user can call wifi_wps_disable to disable WPS and release resource, + * then call wifi_station_connect to connect to target AP. + * - Otherwise, it means that WPS fail, user can create a timer to retry WPS by + * wifi_wps_start after a while, or call wifi_wps_disable to disable WPS and release resource. + * + * @return null + */ +typedef void (*wps_st_cb_t)(int status); + +/** + * @brief Set WPS callback. + * + * @attention WPS can only be used when ESP32 station is enabled. + * + * @param wps_st_cb_t cb : callback. + * + * @return true : WPS starts to work successfully, but does not mean WPS succeed. + * @return false : fail + */ +bool wifi_set_wps_cb(wps_st_cb_t cb); + +/** + * @} + */ + +/** + * @} + */ + +#ifdef __cplusplus +} +#endif + +#endif /* __ESP_WPS_H__ */ diff --git a/components/esp32/include/rom/aes.h b/components/esp32/include/rom/aes.h new file mode 100644 index 000000000..97e6248bc --- /dev/null +++ b/components/esp32/include/rom/aes.h @@ -0,0 +1,48 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_AES_H_ +#define _ROM_AES_H_ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +enum AES_BITS { + AES128, + AES192, + AES256 +}; + +void ets_aes_enable(void); + +void ets_aes_disable(void); + +void ets_set_endian(bool key_word_swap, bool key_byte_swap, + bool in_word_swap, bool in_byte_swap, + bool out_word_swap, bool out_byte_swap); + +bool ets_aes_setkey_enc(const uint8_t *key, enum AES_BITS bits); + +bool ets_aes_setkey_dec(const uint8_t *key, enum AES_BITS bits); + +void ets_aes_crypt(const uint8_t input[16], uint8_t output[16]); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_AES_H_ */ diff --git a/components/esp32/include/rom/bigint.h b/components/esp32/include/rom/bigint.h new file mode 100644 index 000000000..461469cac --- /dev/null +++ b/components/esp32/include/rom/bigint.h @@ -0,0 +1,53 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_BIGINT_H_ +#define _ROM_BIGINT_H_ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +void ets_bigint_enable(void); + +void ets_bigint_disable(void); + +void ets_bigint_wait_finish(void); + +bool ets_bigint_mod_power_prepare(uint32_t *x, uint32_t *y, uint32_t *m, + uint32_t m_dash, uint32_t *rb, uint32_t len, bool again); + +bool ets_bigint_mod_power_getz(uint32_t *z, uint32_t len); + +bool ets_bigint_mult_prepare(uint32_t *x, uint32_t *y, uint32_t len); + +bool ets_bigint_mult_getz(uint32_t *z, uint32_t len); + +bool ets_bigint_montgomery_mult_prepare(uint32_t *x, uint32_t *y, uint32_t *m, + uint32_t m_dash, uint32_t len, bool again); + +bool ets_bigint_montgomery_mult_getz(uint32_t *z, uint32_t len); + +bool ets_bigint_mod_mult_prepare(uint32_t *x, uint32_t *y, uint32_t *m, + uint32_t m_dash, uint32_t *rb, uint32_t len, bool again); + +bool ets_bigint_mod_mult_getz(uint32_t *m, uint32_t *z, uint32_t len); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_BIGINT_H_ */ diff --git a/components/esp32/include/rom/cache.h b/components/esp32/include/rom/cache.h new file mode 100644 index 000000000..b9e59448f --- /dev/null +++ b/components/esp32/include/rom/cache.h @@ -0,0 +1,69 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_CACHE_H_ +#define _ROM_CACHE_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +//=========================================== +// function : cache_init +// description: initialise cache mmu, mark all entries as invalid. +// conditions: +// Call Cache_Read_Disable() before calling this function. +// inputs: +// cpu_no is CPU number,0(PRO CPU) or 1(APP CPU), +// output: NONE +//=========================================== +void mmu_init(int cpu_no); + +//=========================================== +// function : cache_flash_mmu_set +// description: Configure MMU to cache a flash region. +// conditions: +// Call this function to configure the flash cache before enabling it. +// Check return value to verify MMU was set correctly. +// inputs: +// cpu_no is CPU number,0(PRO CPU) or 1(APP CPU), +// pid is process identifier. Range 0~7 +// vaddr is "virtual" address in CPU address space. Can be IRam0, IRam1, IRom0 and DRom0 memory address. +// Should be aligned by psize +// paddr is "physical" address in flash controller's address space. +// ie for 16M flash the range is 0x000000~0xFFFFFF. Should be aligned by psize +// psize is page size of flash, in kilobytes. Can be 64, 32, 16. +// num is number of pages to be set, valid range 0 ~ (flash size)/(page size) +// output: error status +// 0 : mmu set success +// 1 : vaddr or paddr is not aligned +// 2 : pid error +// 3 : psize error +// 4 : mmu table to be written is out of range +// 5 : vaddr is out of range +//=========================================== +unsigned int cache_flash_mmu_set(int cpu_no, int pid, unsigned int vaddr, unsigned int paddr, int psize, int num); + +unsigned int cache_sram_mmu_set(int cpu_no, int pid,unsigned int vaddr, unsigned int paddr, int psize, int num); + +void Cache_Read_Init(int cpu_no); + +void Cache_Read_Disable(int cpu_no); + +void Cache_Read_Enable(int cpu_no); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_CACHE_H_ */ diff --git a/components/esp32/include/rom/crc.h b/components/esp32/include/rom/crc.h new file mode 100644 index 000000000..be763d7dc --- /dev/null +++ b/components/esp32/include/rom/crc.h @@ -0,0 +1,34 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef ROM_CRC_H +#define ROM_CRC_H + +#ifdef __cplusplus +extern "C" { +#endif + +/* Standard CRC8/16/32 algorithms. */ +uint32_t crc32_le(uint32_t crc, uint8_t const * buf, uint32_t len); +uint32_t crc32_be(uint32_t crc, uint8_t const * buf, uint32_t len); +uint16_t crc16_le(uint16_t crc, uint8_t const * buf, uint32_t len); +uint16_t crc16_be(uint16_t crc, uint8_t const * buf, uint32_t len); +uint8_t crc8_le(uint8_t crc, uint8_t const * buf, uint32_t len); +uint8_t crc8_be(uint8_t crc, uint8_t const * buf, uint32_t len); + +#ifdef __cplusplus +} +#endif + + +#endif diff --git a/components/esp32/include/rom/efuse.h b/components/esp32/include/rom/efuse.h new file mode 100644 index 000000000..6d0252b5e --- /dev/null +++ b/components/esp32/include/rom/efuse.h @@ -0,0 +1,29 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_EFUSE_H_ +#define _ROM_EFUSE_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +void ets_efuse_read_op(void); + +void ets_efuse_program_op(void); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_EFUSE_H_ */ diff --git a/components/esp32/include/rom/ets_sys.h b/components/esp32/include/rom/ets_sys.h new file mode 100644 index 000000000..a1c186d97 --- /dev/null +++ b/components/esp32/include/rom/ets_sys.h @@ -0,0 +1,329 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_ETS_SYS_H_ +#define _ROM_ETS_SYS_H_ + +#include +#include + +#include "soc/soc.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define ETS_DEBUG +#define ETS_SERIAL_ENABLED() (1) + +typedef enum { + ETS_OK = 0, + ETS_FAILED = 1 +} ETS_STATUS; + +typedef uint32_t ETSSignal; +typedef uint32_t ETSParam; + +typedef struct ETSEventTag ETSEvent; + +struct ETSEventTag { + ETSSignal sig; + ETSParam par; +}; + +typedef void (*ETSTask)(ETSEvent *e); + +enum ETS_User_Priorities { + /* task priorities... */ + TICK_TASK_A_PRIO = 2, + KBD_TASK_PRIO = 5, + MAX_ETS_USER_PRIO = 16, + + /* ISR priorities... */ + MAX_ETS_USER_ISR_PRIO = 0xFF - 16 +}; + +/* ETS interrupt entry and exit */ +/* actually we don't need the following 2 macros any more since we won't exit + * isr until it is finised, more over, we don't do nest interrupt + */ + +void ets_run(void); + +void ets_task(ETSTask task, uint8_t prio, ETSEvent *queue, uint8_t qlen); + +ETS_STATUS ets_post(uint8_t prio, ETSSignal sig, ETSParam par); + +/* + * now things become complicated, print could be directed to uart and/or SDIO + */ +int ets_printf(const char *fmt, ...); + +/* by default it's UART, just install_uart_printf, set putc1 to NULL to disable */ +void ets_install_putc1(void (*p)(char c)); +void ets_install_uart_printf(void); + +/* no need to install, call directly */ +int ets_uart_printf(const char *fmt, ...); + +/* usually we don't need to call this, unless we want to disable SDIO print */ +void ets_install_putc2(void (*p)(char c)); +/* @prepare_buf: allocate buffer for printf internal writting + * @putc: just set to NULL, let printf write to to buffer, unless if you want more fancy stuff + * @post_printf: will be called every time printf finish write buffer + * + * main idea of external printf is re-directing content to an external buffer. + * e.g. sip module allocates an event buffer in prepare_buf() and send the event to host in post_printf() + * moreover, you can check printf_buf_remain_len in post_printf(), send the event to host till buf is + * about to full. + * + * TBD: Another approach is sending printf parameter to host and let host to decode, which could save some bytes. + */ +void ets_install_external_printf(void (*prepare_buf)(char ** bufptr, uint16_t *buflen, uint32_t *cookie), + void (*putc)(char c), + void (*post_printf)(uint32_t cookie)); + +uint16_t est_get_printf_buf_remain_len(void); +void est_reset_printf_buf_len(void); + +/* external (SDIO) printf only, still need to install*/ +int ets_external_printf(const char *fmt, ...); + + +#define ETS_PRINTF(...) ets_printf(...) + +#define ETS_ASSERT(v) do { \ + if (!(v)) { \ + ets_printf("%s %u \n", __FILE__, __LINE__); \ + while (1) {}; \ + } \ +} while (0); + +/* memory and string support */ +int8_t ets_char2xdigit(char ch); +uint8_t * ets_str2macaddr(uint8_t *macaddr, char *str); +void ets_getc(char *c); +void ets_putc(char c); + +/* timer related */ +typedef uint32_t ETSHandle; +typedef void ETSTimerFunc(void *timer_arg); + +typedef struct _ETSTIMER_ { + struct _ETSTIMER_ *timer_next; + uint32_t timer_expire; + uint32_t timer_period; + ETSTimerFunc *timer_func; + void *timer_arg; +} ETSTimer; + +void ets_timer_init(void); +void ets_timer_arm(ETSTimer *timer, uint32_t tmout, bool repeat); +void ets_timer_disarm(ETSTimer *timer); +void ets_timer_done(ETSTimer *ptimer); +void ets_timer_setfn(ETSTimer *ptimer, ETSTimerFunc *pfunction, void *parg); + +/* watchdog related */ +typedef enum { + WDT_NONE = -1, + WDT_DISABLED = 0, + WDT_CONTROL_RESET = 1, + WDT_CONTROL_INTR = 2, /* usually we use this mode? */ + WDT_CONTROL_EXTERNAL_FEED = 3, + WDT_TESET_OVERFLOW = 4, // intend to make watchdog overflow to test +} WDT_MODE; + +typedef enum{ + WDT_INTERVAL_THREE_SEC = 3, + WDT_INTERVAL_SIX_SEC = 6, + WDT_INTERVAL_TWELVE_SEC = 12, +} WDT_INTERVAL_TIME; + +void ets_wdt_init(void); +WDT_MODE ets_wdt_get_mode(void); +void ets_wdt_enable(WDT_MODE mode, WDT_INTERVAL_TIME feed_interval, + WDT_INTERVAL_TIME expire_interval); +WDT_MODE ets_wdt_disable(void); +void ets_wdt_restore(WDT_MODE old_mode); + +/* interrupt related */ +typedef void (* ets_isr_t)(void *); + +#define ETS_WMAC_SOURCE 0 +#define ETS_SLC_SOURCE 1 +#define ETS_UART_SOURCE 13 +#define ETS_UART1_SOURCE 14 +#define ETS_FRC_TIMER2_SOURCE 43 + +#define ETS_WMAC_INUM 0 +#define ETS_SLC_INUM 1 +#define ETS_SPI_INUM 2 +#define ETS_HSIP_INUM 2 +#define ETS_I2S_INUM 2 +#define ETS_RTC_INUM 3 +#define ETS_FRC_TIMER1_INUM 9 /* use edge*/ +#define ETS_FRC_TIMER2_INUM 10 /* use edge*/ +#define ETS_WDT_INUM 8 /* use edge*/ +#define ETS_GPIO_INUM 4 +#define ETS_UART_INUM 5 +#define ETS_UART1_INUM 5 +#define ETS_MAX_INUM 6 + + +void ets_isr_attach(int i, ets_isr_t func, void *arg); +void ets_isr_mask(uint32_t mask); +void ets_isr_unmask(uint32_t unmask); +void ets_intr_lock(void); +void ets_intr_unlock(void); +void intr_matrix_set(int cpu_no, uint32_t model_num, uint32_t intr_num); + +#define _ETSTR(v) # v +#define _ETS_SET_INTLEVEL(intlevel) ({ unsigned __tmp; \ + __asm__ __volatile__( "rsil %0, " _ETSTR(intlevel) "\n" \ + : "=a" (__tmp) : : "memory" ); \ + }) + +#define ETS_INTR_LOCK() \ + ets_intr_lock() + +#define ETS_INTR_UNLOCK() \ + ets_intr_unlock() + +#define ETS_CCOMPARE_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_CCOMPARE_INUM, (func), (void *)(arg)) + +#define ETS_PWM_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_PWM_INUM, (func), (void *)(arg)) + +#define ETS_WMAC_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_WMAC_INUM, (func), (void *)(arg)) + +#define ETS_FRC_TIMER1_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_FRC_TIMER1_INUM, (func), (void *)(arg)) + +#define ETS_FRC_TIMER2_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_FRC_TIMER2_INUM, (func), (void *)(arg)) + +#define ETS_GPIO_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_GPIO_INUM, (func), (void *)(arg)) + +#define ETS_UART_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_UART_INUM, (func), (void *)(arg)) + +#define ETS_WDT_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_WDT_INUM, (func), (void *)(arg)) + +#define ETS_RTC_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_RTC_INUM, (func), (void *)(arg)) + +#define ETS_SLC_INTR_ATTACH(func, arg) \ + ets_isr_attach(ETS_SLC_INUM, (func), (void *)(arg)) + + +#define ETS_INTR_ENABLE(inum) \ + ets_isr_unmask((1<= '0') && (c <= '9')) + +#define isxdigit(c) (((c >= '0') && (c <= '9')) || \ + ((c >= 'a') && (c <= 'f')) || \ + ((c >= 'A') && (c <= 'F')) ) + +#define isblank(c) ((c == ' ') || (c == '\t')) + +#define isupper(c) ((c >= 'A') && (c <= 'Z')) +#endif + + +#ifndef MAC2STR +#define MAC2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5] +#define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x" +#endif + +#define ETS_MEM_BAR() asm volatile ( "" : : : "memory" ) + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_ETS_SYS_H_ */ diff --git a/components/esp32/include/rom/gpio.h b/components/esp32/include/rom/gpio.h new file mode 100644 index 000000000..afb8e2018 --- /dev/null +++ b/components/esp32/include/rom/gpio.h @@ -0,0 +1,142 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_GPIO_H_ +#define _ROM_GPIO_H_ + +#include +#include + +#include "esp_attr.h" +#include "soc/gpio_reg.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define GPIO_REG_READ(reg) READ_PERI_REG(reg) +#define GPIO_REG_WRITE(reg, val) WRITE_PERI_REG(reg, val) +#define GPIO_PIN_COUNT 40 +#define GPIO_ID_PIN0 0 +#define GPIO_ID_PIN(n) (GPIO_ID_PIN0+(n)) +#define GPIO_PIN_ADDR(i) (GPIO_PIN0 + i*4) + +#define GPIO_ID_IS_PIN_REGISTER(reg_id) \ + ((reg_id >= GPIO_ID_PIN0) && (reg_id <= GPIO_ID_PIN(GPIO_PIN_COUNT-1))) + +#define GPIO_REGID_TO_PINIDX(reg_id) ((reg_id) - GPIO_ID_PIN0) + +typedef enum{ + GPIO_PIN_INTR_DISABLE = 0, + GPIO_PIN_INTR_POSEDGE = 1, + GPIO_PIN_INTR_NEGEDGE = 2, + GPIO_PIN_INTR_ANYEGDE = 3, + GPIO_PIN_INTR_LOLEVEL = 4, + GPIO_PIN_INTR_HILEVEL = 5 +}GPIO_INT_TYPE; + +#define GREEN_LED_ON() GPIO_OUTPUT_SET(GPIO_ID_PIN(1) , 0) +#define GREEN_LED_OFF() GPIO_OUTPUT_SET(GPIO_ID_PIN(1) , 1) + +#define GPIO_OUTPUT_SET(gpio_no, bit_value) \ + ((gpio_no < 32) ? gpio_output_set(bit_value<>gpio_no)&BIT0) : ((gpio_input_get_high()>>(gpio_no - 32))&BIT0)) + +/* GPIO interrupt handler, registered through gpio_intr_handler_register */ +typedef void (* gpio_intr_handler_fn_t)(uint32_t intr_mask, bool high, void *arg); + + +/* + * Initialize GPIO. This includes reading the GPIO Configuration DataSet + * to initialize "output enables" and pin configurations for each gpio pin. + * Must be called once during startup. + */ +void gpio_init(void) ROMFN_ATTR; + +/* + * Change GPIO pin output by setting, clearing, or disabling pins. + * In general, it is expected that a bit will be set in at most one + * of these masks. If a bit is clear in all masks, the output state + * remains unchanged. + * + * There is no particular ordering guaranteed; so if the order of + * writes is significant, calling code should divide a single call + * into multiple calls. + */ +void gpio_output_set(uint32_t set_mask, + uint32_t clear_mask, + uint32_t enable_mask, + uint32_t disable_mask) ROMFN_ATTR; +void gpio_output_set_high(uint32_t set_mask, + uint32_t clear_mask, + uint32_t enable_mask, + uint32_t disable_mask) ROMFN_ATTR; +/* + * Sample the value of GPIO input pins and returns a bitmask. + */ +uint32_t gpio_input_get(void) ROMFN_ATTR; +uint32_t gpio_input_get_high(void) ROMFN_ATTR; + +/* + * Set the specified GPIO register to the specified value. + * This is a very general and powerful interface that is not + * expected to be used during normal operation. It is intended + * mainly for debug, or for unusual requirements. + */ +void gpio_register_set(uint32_t reg_id, uint32_t value) ROMFN_ATTR; + +/* Get the current value of the specified GPIO register. */ +uint32_t gpio_register_get(uint32_t reg_id) ROMFN_ATTR; + +/* + * Register an application-specific interrupt handler for GPIO pin + * interrupts. Once the interrupt handler is called, it will not + * be called again until after a call to gpio_intr_ack. Any GPIO + * interrupts that occur during the interim are masked. + * + * The application-specific handler is called with a mask of + * pending GPIO interrupts. After processing pin interrupts, the + * application-specific handler may wish to use gpio_intr_pending + * to check for any additional pending interrupts before it returns. + */ +void gpio_intr_handler_register(gpio_intr_handler_fn_t fn, void *arg) ROMFN_ATTR; + +/* Determine which GPIO interrupts are pending. */ +uint32_t gpio_intr_pending(void) ROMFN_ATTR; +uint32_t gpio_intr_pending_high(void) ROMFN_ATTR; + +/* + * Acknowledge GPIO interrupts. + * Intended to be called from the gpio_intr_handler_fn. + */ +void gpio_intr_ack(uint32_t ack_mask) ROMFN_ATTR; +void gpio_intr_ack_high(uint32_t ack_mask) ROMFN_ATTR; + +void gpio_pin_wakeup_enable(uint32_t i, GPIO_INT_TYPE intr_state) ROMFN_ATTR; + +void gpio_pin_wakeup_disable() ROMFN_ATTR; + +//extern void gpio_module_install(struct gpio_api *api); + +void gpio_matrix_in(uint32_t gpio, uint32_t signal_idx, bool inv) ROMFN_ATTR; + +void gpio_matrix_out(uint32_t gpio, uint32_t signal_idx, bool out_inv, bool oen_inv) ROMFN_ATTR; + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_GPIO_H_ */ diff --git a/components/esp32/include/rom/libc_stubs.h b/components/esp32/include/rom/libc_stubs.h new file mode 100644 index 000000000..0c1876e58 --- /dev/null +++ b/components/esp32/include/rom/libc_stubs.h @@ -0,0 +1,89 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_LIBC_STUBS_H_ +#define _ROM_LIBC_STUBS_H_ + +#include +#include +#include +#include +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* +ESP32 ROM code contains implementations of some of C library functions. +Whenever a function in ROM needs to use a syscall, it calls a pointer to the corresponding syscall +implementation defined in the following struct. + +The table itself, by default, is not allocated in RAM. There are two pointers, `syscall_table_ptr_pro` and +`syscall_table_ptr_app`, which can be set to point to the locations of syscall tables of CPU 0 (aka PRO CPU) +and CPU 1 (aka APP CPU). Location of these pointers in .bss segment of ROM code is defined in linker script. + +So, before using any of the C library functions (except for pure functions and memcpy/memset functions), +application must allocate syscall table structure for each CPU being used, and populate it with pointers +to actual implementations of corresponding syscalls. +*/ + +struct syscall_stub_table +{ + struct _reent* (*__getreent)(void); + void* (*_malloc_r)(struct _reent *r, size_t); + void (*_free_r)(struct _reent *r, void*); + void* (*_realloc_r)(struct _reent *r, void*, size_t); + void* (*_calloc_r)(struct _reent *r, size_t, size_t); + void (*_abort)(void); + int (*_system_r)(struct _reent *r, const char*); + int (*_rename_r)(struct _reent *r, const char*, const char*); + clock_t (*_times_r)(struct _reent *r, struct tms *); + int (*_gettimeofday_r) (struct _reent *r, struct timeval *, void *); + void (*_raise_r)(struct _reent *r); + int (*_unlink_r)(struct _reent *r, const char*); + int (*_link_r)(struct _reent *r, const char*, const char*); + int (*_stat_r)(struct _reent *r, const char*, struct stat *); + int (*_fstat_r)(struct _reent *r, int, struct stat *); + void* (*_sbrk_r)(struct _reent *r, ptrdiff_t); + int (*_getpid_r)(struct _reent *r); + int (*_kill_r)(struct _reent *r, int, int); + void (*_exit_r)(struct _reent *r, int); + int (*_close_r)(struct _reent *r, int); + int (*_open_r)(struct _reent *r, const char *, int, int); + int (*_write_r)(struct _reent *r, int, const void *, int); + int (*_lseek_r)(struct _reent *r, int, int, int); + int (*_read_r)(struct _reent *r, int, void *, int); + void (*_lock_init)(_lock_t *lock); + void (*_lock_init_recursive)(_lock_t *lock); + void (*_lock_close)(_lock_t *lock); + void (*_lock_close_recursive)(_lock_t *lock); + void (*_lock_acquire)(_lock_t *lock); + void (*_lock_acquire_recursive)(_lock_t *lock); + int (*_lock_try_acquire)(_lock_t *lock); + int (*_lock_try_acquire_recursive)(_lock_t *lock); + void (*_lock_release)(_lock_t *lock); + void (*_lock_release_recursive)(_lock_t *lock); + int (*_printf_float)(struct _reent *data, void *pdata, FILE * fp, int (*pfunc) (struct _reent *, FILE *, _CONST char *, size_t len), va_list * ap); + int (*_scanf_float) (struct _reent *rptr, void *pdata, FILE *fp, va_list *ap); +}; + +extern struct syscall_stub_table* syscall_table_ptr_pro; +extern struct syscall_stub_table* syscall_table_ptr_app; + +#ifdef __cplusplus +} // extern "C" +#endif + +#endif /* _ROM_LIBC_STUBS_H_ */ diff --git a/components/esp32/include/rom/lldesc.h b/components/esp32/include/rom/lldesc.h new file mode 100644 index 000000000..d027362a5 --- /dev/null +++ b/components/esp32/include/rom/lldesc.h @@ -0,0 +1,176 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_LLDESC_H_ +#define _ROM_LLDESC_H_ + +#include + +#include "queue.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define LLDESC_TX_MBLK_SIZE 268 /* */ +#define LLDESC_RX_SMBLK_SIZE 64 /* small block size, for small mgmt frame */ +#define LLDESC_RX_MBLK_SIZE 524 /* rx is large sinec we want to contain mgmt frame in one block*/ +#define LLDESC_RX_AMPDU_ENTRY_MBLK_SIZE 64 /* it is a small buffer which is a cycle link*/ +#define LLDESC_RX_AMPDU_LEN_MBLK_SIZE 256 /*for ampdu entry*/ +#ifdef ESP_MAC_5 +#define LLDESC_TX_MBLK_NUM 116 /* 64K / 256 */ +#define LLDESC_RX_MBLK_NUM 82 /* 64K / 512 MAX 172*/ +#define LLDESC_RX_AMPDU_ENTRY_MBLK_NUM 4 +#define LLDESC_RX_AMPDU_LEN_MLBK_NUM 12 +#else +#ifdef SBUF_RXTX +#define LLDESC_TX_MBLK_NUM_MAX (2 * 48) /* 23K / 260 - 8 */ +#define LLDESC_RX_MBLK_NUM_MAX (2 * 48) /* 23K / 524 */ +#define LLDESC_TX_MBLK_NUM_MIN (2 * 16) /* 23K / 260 - 8 */ +#define LLDESC_RX_MBLK_NUM_MIN (2 * 16) /* 23K / 524 */ +#endif +#define LLDESC_TX_MBLK_NUM 10 //(2 * 32) /* 23K / 260 - 8 */ + +#ifdef IEEE80211_RX_AMPDU +#define LLDESC_RX_MBLK_NUM 30 +#else +#define LLDESC_RX_MBLK_NUM 10 +#endif /*IEEE80211_RX_AMPDU*/ + +#define LLDESC_RX_AMPDU_ENTRY_MBLK_NUM 4 +#define LLDESC_RX_AMPDU_LEN_MLBK_NUM 8 +#endif /* !ESP_MAC_5 */ +/* + * SLC2 DMA Desc struct, aka lldesc_t + * + * -------------------------------------------------------------- + * | own | EoF | sub_sof | 5'b0 | length [11:0] | size [11:0] | + * -------------------------------------------------------------- + * | buf_ptr [31:0] | + * -------------------------------------------------------------- + * | next_desc_ptr [31:0] | + * -------------------------------------------------------------- + */ + +/* this bitfield is start from the LSB!!! */ +typedef struct lldesc_s { + volatile uint32_t size :12, + length:12, + offset: 5, /* h/w reserved 5bit, s/w use it as offset in buffer */ + sosf : 1, /* start of sub-frame */ + eof : 1, /* end of frame */ + owner : 1; /* hw or sw */ + volatile uint8_t *buf; /* point to buffer data */ + union{ + volatile uint32_t empty; + STAILQ_ENTRY(lldesc_s) qe; /* pointing to the next desc */ + }; +} lldesc_t; + +typedef struct tx_ampdu_entry_s{ + uint32_t sub_len :12, + dili_num : 7, + : 1, + null_byte: 2, + data : 1, + enc : 1, + seq : 8; +} tx_ampdu_entry_t; + +typedef struct lldesc_chain_s { + lldesc_t *head; + lldesc_t *tail; +} lldesc_chain_t; + +#ifdef SBUF_RXTX +enum sbuf_mask_s { + SBUF_MOVE_NO = 0, + SBUF_MOVE_TX2RX, + SBUF_MOVE_RX2TX, +} ; + +#define SBUF_MOVE_STEP 8 +#endif +#define LLDESC_SIZE sizeof(struct lldesc_s) + +/* SLC Descriptor */ +#define LLDESC_OWNER_MASK 0x80000000 +#define LLDESC_OWNER_SHIFT 31 +#define LLDESC_SW_OWNED 0 +#define LLDESC_HW_OWNED 1 + +#define LLDESC_EOF_MASK 0x40000000 +#define LLDESC_EOF_SHIFT 30 + +#define LLDESC_SOSF_MASK 0x20000000 +#define LLDESC_SOSF_SHIFT 29 + +#define LLDESC_LENGTH_MASK 0x00fff000 +#define LLDESC_LENGTH_SHIFT 12 + +#define LLDESC_SIZE_MASK 0x00000fff +#define LLDESC_SIZE_SHIFT 0 + +#define LLDESC_ADDR_MASK 0x000fffff + +void lldesc_build_chain(uint8_t *descptr, uint32_t desclen, uint8_t * mblkptr, uint32_t buflen, uint32_t blksz, uint8_t owner, + lldesc_t **head, +#ifdef TO_HOST_RESTART + lldesc_t ** one_before_tail, +#endif + lldesc_t **tail); + +lldesc_t *lldesc_num2link(lldesc_t * head, uint16_t nblks); + +lldesc_t *lldesc_set_owner(lldesc_t * head, uint16_t nblks, uint8_t owner); + +static inline uint32_t lldesc_get_chain_length(lldesc_t *head) +{ + lldesc_t *ds = head; + uint32_t len = 0; + + while (ds) { + len += ds->length; + ds = STAILQ_NEXT(ds, qe); + } + + return len; +} + +static inline void lldesc_config(lldesc_t *ds, uint8_t owner, uint8_t eof, uint8_t sosf, uint16_t len) +{ + ds->owner = owner; + ds->eof = eof; + ds->sosf = sosf; + ds->length = len; +} + +#define LLDESC_CONFIG(_desc, _owner, _eof, _sosf, _len) do { \ + (_desc)->owner = (_owner); \ + (_desc)->eof = (_eof); \ + (_desc)->sosf = (_sosf); \ + (_desc)->length = (_len); \ +} while(0) + +#define LLDESC_FROM_HOST_CLEANUP(ds) LLDESC_CONFIG((ds), LLDESC_HW_OWNED, 0, 0, 0) + +#define LLDESC_MAC_RX_CLEANUP(ds) LLDESC_CONFIG((ds), LLDESC_HW_OWNED, 0, 0, (ds)->size) + +#define LLDESC_TO_HOST_CLEANUP(ds) LLDESC_CONFIG((ds), LLDESC_HW_OWNED, 0, 0, 0) + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_LLDESC_H_ */ diff --git a/components/esp32/include/rom/md5_hash.h b/components/esp32/include/rom/md5_hash.h new file mode 100755 index 000000000..612ee5992 --- /dev/null +++ b/components/esp32/include/rom/md5_hash.h @@ -0,0 +1,36 @@ +/* + * MD5 internal definitions + * Copyright (c) 2003-2005, Jouni Malinen + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License version 2 as + * published by the Free Software Foundation. + * + * Alternatively, this software may be distributed under the terms of BSD + * license. + * + * See README and COPYING for more details. + */ + +#ifndef _ROM_MD5_HASH_H_ +#define _ROM_MD5_HASH_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +struct MD5Context { + uint32 buf[4]; + uint32 bits[2]; + uint8 in[64]; +}; + +void MD5Init(struct MD5Context *context); +void MD5Update(struct MD5Context *context, unsigned char const *buf, unsigned len); +void MD5Final(unsigned char digest[16], struct MD5Context *context); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_MD5_HASH_H_ */ diff --git a/components/esp32/include/rom/miniz.h b/components/esp32/include/rom/miniz.h new file mode 100644 index 000000000..ed79beb2c --- /dev/null +++ b/components/esp32/include/rom/miniz.h @@ -0,0 +1,777 @@ +#ifndef MINIZ_HEADER_INCLUDED +#define MINIZ_HEADER_INCLUDED + +#include + +// Defines to completely disable specific portions of miniz.c: +// If all macros here are defined the only functionality remaining will be CRC-32, adler-32, tinfl, and tdefl. + +// Define MINIZ_NO_STDIO to disable all usage and any functions which rely on stdio for file I/O. +#define MINIZ_NO_STDIO + +// If MINIZ_NO_TIME is specified then the ZIP archive functions will not be able to get the current time, or +// get/set file times, and the C run-time funcs that get/set times won't be called. +// The current downside is the times written to your archives will be from 1979. +#define MINIZ_NO_TIME + +// Define MINIZ_NO_ARCHIVE_APIS to disable all ZIP archive API's. +#define MINIZ_NO_ARCHIVE_APIS + +// Define MINIZ_NO_ARCHIVE_APIS to disable all writing related ZIP archive API's. +#define MINIZ_NO_ARCHIVE_WRITING_APIS + +// Define MINIZ_NO_ZLIB_APIS to remove all ZLIB-style compression/decompression API's. +#define MINIZ_NO_ZLIB_APIS + +// Define MINIZ_NO_ZLIB_COMPATIBLE_NAME to disable zlib names, to prevent conflicts against stock zlib. +#define MINIZ_NO_ZLIB_COMPATIBLE_NAMES + +// Define MINIZ_NO_MALLOC to disable all calls to malloc, free, and realloc. +// Note if MINIZ_NO_MALLOC is defined then the user must always provide custom user alloc/free/realloc +// callbacks to the zlib and archive API's, and a few stand-alone helper API's which don't provide custom user +// functions (such as tdefl_compress_mem_to_heap() and tinfl_decompress_mem_to_heap()) won't work. +#define MINIZ_NO_MALLOC + +#if defined(__TINYC__) && (defined(__linux) || defined(__linux__)) + // TODO: Work around "error: include file 'sys\utime.h' when compiling with tcc on Linux + #define MINIZ_NO_TIME +#endif + +#if !defined(MINIZ_NO_TIME) && !defined(MINIZ_NO_ARCHIVE_APIS) + #include +#endif + +//Hardcoded options for Xtensa - JD +#define MINIZ_X86_OR_X64_CPU 0 +#define MINIZ_LITTLE_ENDIAN 1 +#define MINIZ_USE_UNALIGNED_LOADS_AND_STORES 0 +#define MINIZ_HAS_64BIT_REGISTERS 0 +#define TINFL_USE_64BIT_BITBUF 0 + + +#if defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || defined(__i386) || defined(__i486__) || defined(__i486) || defined(i386) || defined(__ia64__) || defined(__x86_64__) +// MINIZ_X86_OR_X64_CPU is only used to help set the below macros. +#define MINIZ_X86_OR_X64_CPU 1 +#endif + +#if (__BYTE_ORDER__==__ORDER_LITTLE_ENDIAN__) || MINIZ_X86_OR_X64_CPU +// Set MINIZ_LITTLE_ENDIAN to 1 if the processor is little endian. +#define MINIZ_LITTLE_ENDIAN 1 +#endif + +#if MINIZ_X86_OR_X64_CPU +// Set MINIZ_USE_UNALIGNED_LOADS_AND_STORES to 1 on CPU's that permit efficient integer loads and stores from unaligned addresses. +#define MINIZ_USE_UNALIGNED_LOADS_AND_STORES 1 +#endif + +#if defined(_M_X64) || defined(_WIN64) || defined(__MINGW64__) || defined(_LP64) || defined(__LP64__) || defined(__ia64__) || defined(__x86_64__) +// Set MINIZ_HAS_64BIT_REGISTERS to 1 if operations on 64-bit integers are reasonably fast (and don't involve compiler generated calls to helper functions). +#define MINIZ_HAS_64BIT_REGISTERS 1 +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +// ------------------- zlib-style API Definitions. + +// For more compatibility with zlib, miniz.c uses unsigned long for some parameters/struct members. Beware: mz_ulong can be either 32 or 64-bits! +typedef unsigned long mz_ulong; + +// mz_free() internally uses the MZ_FREE() macro (which by default calls free() unless you've modified the MZ_MALLOC macro) to release a block allocated from the heap. +void mz_free(void *p); + +#define MZ_ADLER32_INIT (1) +// mz_adler32() returns the initial adler-32 value to use when called with ptr==NULL. +mz_ulong mz_adler32(mz_ulong adler, const unsigned char *ptr, size_t buf_len); + +#define MZ_CRC32_INIT (0) +// mz_crc32() returns the initial CRC-32 value to use when called with ptr==NULL. +mz_ulong mz_crc32(mz_ulong crc, const unsigned char *ptr, size_t buf_len); + +// Compression strategies. +enum { MZ_DEFAULT_STRATEGY = 0, MZ_FILTERED = 1, MZ_HUFFMAN_ONLY = 2, MZ_RLE = 3, MZ_FIXED = 4 }; + +// Method +#define MZ_DEFLATED 8 + +#ifndef MINIZ_NO_ZLIB_APIS + +// Heap allocation callbacks. +// Note that mz_alloc_func parameter types purpsosely differ from zlib's: items/size is size_t, not unsigned long. +typedef void *(*mz_alloc_func)(void *opaque, size_t items, size_t size); +typedef void (*mz_free_func)(void *opaque, void *address); +typedef void *(*mz_realloc_func)(void *opaque, void *address, size_t items, size_t size); + +#define MZ_VERSION "9.1.15" +#define MZ_VERNUM 0x91F0 +#define MZ_VER_MAJOR 9 +#define MZ_VER_MINOR 1 +#define MZ_VER_REVISION 15 +#define MZ_VER_SUBREVISION 0 + +// Flush values. For typical usage you only need MZ_NO_FLUSH and MZ_FINISH. The other values are for advanced use (refer to the zlib docs). +enum { MZ_NO_FLUSH = 0, MZ_PARTIAL_FLUSH = 1, MZ_SYNC_FLUSH = 2, MZ_FULL_FLUSH = 3, MZ_FINISH = 4, MZ_BLOCK = 5 }; + +// Return status codes. MZ_PARAM_ERROR is non-standard. +enum { MZ_OK = 0, MZ_STREAM_END = 1, MZ_NEED_DICT = 2, MZ_ERRNO = -1, MZ_STREAM_ERROR = -2, MZ_DATA_ERROR = -3, MZ_MEM_ERROR = -4, MZ_BUF_ERROR = -5, MZ_VERSION_ERROR = -6, MZ_PARAM_ERROR = -10000 }; + +// Compression levels: 0-9 are the standard zlib-style levels, 10 is best possible compression (not zlib compatible, and may be very slow), MZ_DEFAULT_COMPRESSION=MZ_DEFAULT_LEVEL. +enum { MZ_NO_COMPRESSION = 0, MZ_BEST_SPEED = 1, MZ_BEST_COMPRESSION = 9, MZ_UBER_COMPRESSION = 10, MZ_DEFAULT_LEVEL = 6, MZ_DEFAULT_COMPRESSION = -1 }; + +// Window bits +#define MZ_DEFAULT_WINDOW_BITS 15 + +struct mz_internal_state; + +// Compression/decompression stream struct. +typedef struct mz_stream_s +{ + const unsigned char *next_in; // pointer to next byte to read + unsigned int avail_in; // number of bytes available at next_in + mz_ulong total_in; // total number of bytes consumed so far + + unsigned char *next_out; // pointer to next byte to write + unsigned int avail_out; // number of bytes that can be written to next_out + mz_ulong total_out; // total number of bytes produced so far + + char *msg; // error msg (unused) + struct mz_internal_state *state; // internal state, allocated by zalloc/zfree + + mz_alloc_func zalloc; // optional heap allocation function (defaults to malloc) + mz_free_func zfree; // optional heap free function (defaults to free) + void *opaque; // heap alloc function user pointer + + int data_type; // data_type (unused) + mz_ulong adler; // adler32 of the source or uncompressed data + mz_ulong reserved; // not used +} mz_stream; + +typedef mz_stream *mz_streamp; + +// Returns the version string of miniz.c. +const char *mz_version(void); + +// mz_deflateInit() initializes a compressor with default options: +// Parameters: +// pStream must point to an initialized mz_stream struct. +// level must be between [MZ_NO_COMPRESSION, MZ_BEST_COMPRESSION]. +// level 1 enables a specially optimized compression function that's been optimized purely for performance, not ratio. +// (This special func. is currently only enabled when MINIZ_USE_UNALIGNED_LOADS_AND_STORES and MINIZ_LITTLE_ENDIAN are defined.) +// Return values: +// MZ_OK on success. +// MZ_STREAM_ERROR if the stream is bogus. +// MZ_PARAM_ERROR if the input parameters are bogus. +// MZ_MEM_ERROR on out of memory. +int mz_deflateInit(mz_streamp pStream, int level); + +// mz_deflateInit2() is like mz_deflate(), except with more control: +// Additional parameters: +// method must be MZ_DEFLATED +// window_bits must be MZ_DEFAULT_WINDOW_BITS (to wrap the deflate stream with zlib header/adler-32 footer) or -MZ_DEFAULT_WINDOW_BITS (raw deflate/no header or footer) +// mem_level must be between [1, 9] (it's checked but ignored by miniz.c) +int mz_deflateInit2(mz_streamp pStream, int level, int method, int window_bits, int mem_level, int strategy); + +// Quickly resets a compressor without having to reallocate anything. Same as calling mz_deflateEnd() followed by mz_deflateInit()/mz_deflateInit2(). +int mz_deflateReset(mz_streamp pStream); + +// mz_deflate() compresses the input to output, consuming as much of the input and producing as much output as possible. +// Parameters: +// pStream is the stream to read from and write to. You must initialize/update the next_in, avail_in, next_out, and avail_out members. +// flush may be MZ_NO_FLUSH, MZ_PARTIAL_FLUSH/MZ_SYNC_FLUSH, MZ_FULL_FLUSH, or MZ_FINISH. +// Return values: +// MZ_OK on success (when flushing, or if more input is needed but not available, and/or there's more output to be written but the output buffer is full). +// MZ_STREAM_END if all input has been consumed and all output bytes have been written. Don't call mz_deflate() on the stream anymore. +// MZ_STREAM_ERROR if the stream is bogus. +// MZ_PARAM_ERROR if one of the parameters is invalid. +// MZ_BUF_ERROR if no forward progress is possible because the input and/or output buffers are empty. (Fill up the input buffer or free up some output space and try again.) +int mz_deflate(mz_streamp pStream, int flush); + +// mz_deflateEnd() deinitializes a compressor: +// Return values: +// MZ_OK on success. +// MZ_STREAM_ERROR if the stream is bogus. +int mz_deflateEnd(mz_streamp pStream); + +// mz_deflateBound() returns a (very) conservative upper bound on the amount of data that could be generated by deflate(), assuming flush is set to only MZ_NO_FLUSH or MZ_FINISH. +mz_ulong mz_deflateBound(mz_streamp pStream, mz_ulong source_len); + +// Single-call compression functions mz_compress() and mz_compress2(): +// Returns MZ_OK on success, or one of the error codes from mz_deflate() on failure. +int mz_compress(unsigned char *pDest, mz_ulong *pDest_len, const unsigned char *pSource, mz_ulong source_len); +int mz_compress2(unsigned char *pDest, mz_ulong *pDest_len, const unsigned char *pSource, mz_ulong source_len, int level); + +// mz_compressBound() returns a (very) conservative upper bound on the amount of data that could be generated by calling mz_compress(). +mz_ulong mz_compressBound(mz_ulong source_len); + +// Initializes a decompressor. +int mz_inflateInit(mz_streamp pStream); + +// mz_inflateInit2() is like mz_inflateInit() with an additional option that controls the window size and whether or not the stream has been wrapped with a zlib header/footer: +// window_bits must be MZ_DEFAULT_WINDOW_BITS (to parse zlib header/footer) or -MZ_DEFAULT_WINDOW_BITS (raw deflate). +int mz_inflateInit2(mz_streamp pStream, int window_bits); + +// Decompresses the input stream to the output, consuming only as much of the input as needed, and writing as much to the output as possible. +// Parameters: +// pStream is the stream to read from and write to. You must initialize/update the next_in, avail_in, next_out, and avail_out members. +// flush may be MZ_NO_FLUSH, MZ_SYNC_FLUSH, or MZ_FINISH. +// On the first call, if flush is MZ_FINISH it's assumed the input and output buffers are both sized large enough to decompress the entire stream in a single call (this is slightly faster). +// MZ_FINISH implies that there are no more source bytes available beside what's already in the input buffer, and that the output buffer is large enough to hold the rest of the decompressed data. +// Return values: +// MZ_OK on success. Either more input is needed but not available, and/or there's more output to be written but the output buffer is full. +// MZ_STREAM_END if all needed input has been consumed and all output bytes have been written. For zlib streams, the adler-32 of the decompressed data has also been verified. +// MZ_STREAM_ERROR if the stream is bogus. +// MZ_DATA_ERROR if the deflate stream is invalid. +// MZ_PARAM_ERROR if one of the parameters is invalid. +// MZ_BUF_ERROR if no forward progress is possible because the input buffer is empty but the inflater needs more input to continue, or if the output buffer is not large enough. Call mz_inflate() again +// with more input data, or with more room in the output buffer (except when using single call decompression, described above). +int mz_inflate(mz_streamp pStream, int flush); + +// Deinitializes a decompressor. +int mz_inflateEnd(mz_streamp pStream); + +// Single-call decompression. +// Returns MZ_OK on success, or one of the error codes from mz_inflate() on failure. +int mz_uncompress(unsigned char *pDest, mz_ulong *pDest_len, const unsigned char *pSource, mz_ulong source_len); + +// Returns a string description of the specified error code, or NULL if the error code is invalid. +const char *mz_error(int err); + +// Redefine zlib-compatible names to miniz equivalents, so miniz.c can be used as a drop-in replacement for the subset of zlib that miniz.c supports. +// Define MINIZ_NO_ZLIB_COMPATIBLE_NAMES to disable zlib-compatibility if you use zlib in the same project. +#ifndef MINIZ_NO_ZLIB_COMPATIBLE_NAMES + typedef unsigned char Byte; + typedef unsigned int uInt; + typedef mz_ulong uLong; + typedef Byte Bytef; + typedef uInt uIntf; + typedef char charf; + typedef int intf; + typedef void *voidpf; + typedef uLong uLongf; + typedef void *voidp; + typedef void *const voidpc; + #define Z_NULL 0 + #define Z_NO_FLUSH MZ_NO_FLUSH + #define Z_PARTIAL_FLUSH MZ_PARTIAL_FLUSH + #define Z_SYNC_FLUSH MZ_SYNC_FLUSH + #define Z_FULL_FLUSH MZ_FULL_FLUSH + #define Z_FINISH MZ_FINISH + #define Z_BLOCK MZ_BLOCK + #define Z_OK MZ_OK + #define Z_STREAM_END MZ_STREAM_END + #define Z_NEED_DICT MZ_NEED_DICT + #define Z_ERRNO MZ_ERRNO + #define Z_STREAM_ERROR MZ_STREAM_ERROR + #define Z_DATA_ERROR MZ_DATA_ERROR + #define Z_MEM_ERROR MZ_MEM_ERROR + #define Z_BUF_ERROR MZ_BUF_ERROR + #define Z_VERSION_ERROR MZ_VERSION_ERROR + #define Z_PARAM_ERROR MZ_PARAM_ERROR + #define Z_NO_COMPRESSION MZ_NO_COMPRESSION + #define Z_BEST_SPEED MZ_BEST_SPEED + #define Z_BEST_COMPRESSION MZ_BEST_COMPRESSION + #define Z_DEFAULT_COMPRESSION MZ_DEFAULT_COMPRESSION + #define Z_DEFAULT_STRATEGY MZ_DEFAULT_STRATEGY + #define Z_FILTERED MZ_FILTERED + #define Z_HUFFMAN_ONLY MZ_HUFFMAN_ONLY + #define Z_RLE MZ_RLE + #define Z_FIXED MZ_FIXED + #define Z_DEFLATED MZ_DEFLATED + #define Z_DEFAULT_WINDOW_BITS MZ_DEFAULT_WINDOW_BITS + #define alloc_func mz_alloc_func + #define free_func mz_free_func + #define internal_state mz_internal_state + #define z_stream mz_stream + #define deflateInit mz_deflateInit + #define deflateInit2 mz_deflateInit2 + #define deflateReset mz_deflateReset + #define deflate mz_deflate + #define deflateEnd mz_deflateEnd + #define deflateBound mz_deflateBound + #define compress mz_compress + #define compress2 mz_compress2 + #define compressBound mz_compressBound + #define inflateInit mz_inflateInit + #define inflateInit2 mz_inflateInit2 + #define inflate mz_inflate + #define inflateEnd mz_inflateEnd + #define uncompress mz_uncompress + #define crc32 mz_crc32 + #define adler32 mz_adler32 + #define MAX_WBITS 15 + #define MAX_MEM_LEVEL 9 + #define zError mz_error + #define ZLIB_VERSION MZ_VERSION + #define ZLIB_VERNUM MZ_VERNUM + #define ZLIB_VER_MAJOR MZ_VER_MAJOR + #define ZLIB_VER_MINOR MZ_VER_MINOR + #define ZLIB_VER_REVISION MZ_VER_REVISION + #define ZLIB_VER_SUBREVISION MZ_VER_SUBREVISION + #define zlibVersion mz_version + #define zlib_version mz_version() +#endif // #ifndef MINIZ_NO_ZLIB_COMPATIBLE_NAMES + +#endif // MINIZ_NO_ZLIB_APIS + +// ------------------- Types and macros + +typedef unsigned char mz_uint8; +typedef signed short mz_int16; +typedef unsigned short mz_uint16; +typedef unsigned int mz_uint32; +typedef unsigned int mz_uint; +typedef long long mz_int64; +typedef unsigned long long mz_uint64; +typedef int mz_bool; + +#define MZ_FALSE (0) +#define MZ_TRUE (1) + +// An attempt to work around MSVC's spammy "warning C4127: conditional expression is constant" message. +#ifdef _MSC_VER + #define MZ_MACRO_END while (0, 0) +#else + #define MZ_MACRO_END while (0) +#endif + +// ------------------- ZIP archive reading/writing + +#ifndef MINIZ_NO_ARCHIVE_APIS + +enum +{ + MZ_ZIP_MAX_IO_BUF_SIZE = 64*1024, + MZ_ZIP_MAX_ARCHIVE_FILENAME_SIZE = 260, + MZ_ZIP_MAX_ARCHIVE_FILE_COMMENT_SIZE = 256 +}; + +typedef struct +{ + mz_uint32 m_file_index; + mz_uint32 m_central_dir_ofs; + mz_uint16 m_version_made_by; + mz_uint16 m_version_needed; + mz_uint16 m_bit_flag; + mz_uint16 m_method; +#ifndef MINIZ_NO_TIME + time_t m_time; +#endif + mz_uint32 m_crc32; + mz_uint64 m_comp_size; + mz_uint64 m_uncomp_size; + mz_uint16 m_internal_attr; + mz_uint32 m_external_attr; + mz_uint64 m_local_header_ofs; + mz_uint32 m_comment_size; + char m_filename[MZ_ZIP_MAX_ARCHIVE_FILENAME_SIZE]; + char m_comment[MZ_ZIP_MAX_ARCHIVE_FILE_COMMENT_SIZE]; +} mz_zip_archive_file_stat; + +typedef size_t (*mz_file_read_func)(void *pOpaque, mz_uint64 file_ofs, void *pBuf, size_t n); +typedef size_t (*mz_file_write_func)(void *pOpaque, mz_uint64 file_ofs, const void *pBuf, size_t n); + +struct mz_zip_internal_state_tag; +typedef struct mz_zip_internal_state_tag mz_zip_internal_state; + +typedef enum +{ + MZ_ZIP_MODE_INVALID = 0, + MZ_ZIP_MODE_READING = 1, + MZ_ZIP_MODE_WRITING = 2, + MZ_ZIP_MODE_WRITING_HAS_BEEN_FINALIZED = 3 +} mz_zip_mode; + +typedef struct mz_zip_archive_tag +{ + mz_uint64 m_archive_size; + mz_uint64 m_central_directory_file_ofs; + mz_uint m_total_files; + mz_zip_mode m_zip_mode; + + mz_uint m_file_offset_alignment; + + mz_alloc_func m_pAlloc; + mz_free_func m_pFree; + mz_realloc_func m_pRealloc; + void *m_pAlloc_opaque; + + mz_file_read_func m_pRead; + mz_file_write_func m_pWrite; + void *m_pIO_opaque; + + mz_zip_internal_state *m_pState; + +} mz_zip_archive; + +typedef enum +{ + MZ_ZIP_FLAG_CASE_SENSITIVE = 0x0100, + MZ_ZIP_FLAG_IGNORE_PATH = 0x0200, + MZ_ZIP_FLAG_COMPRESSED_DATA = 0x0400, + MZ_ZIP_FLAG_DO_NOT_SORT_CENTRAL_DIRECTORY = 0x0800 +} mz_zip_flags; + +// ZIP archive reading + +// Inits a ZIP archive reader. +// These functions read and validate the archive's central directory. +mz_bool mz_zip_reader_init(mz_zip_archive *pZip, mz_uint64 size, mz_uint32 flags); +mz_bool mz_zip_reader_init_mem(mz_zip_archive *pZip, const void *pMem, size_t size, mz_uint32 flags); + +#ifndef MINIZ_NO_STDIO +mz_bool mz_zip_reader_init_file(mz_zip_archive *pZip, const char *pFilename, mz_uint32 flags); +#endif + +// Returns the total number of files in the archive. +mz_uint mz_zip_reader_get_num_files(mz_zip_archive *pZip); + +// Returns detailed information about an archive file entry. +mz_bool mz_zip_reader_file_stat(mz_zip_archive *pZip, mz_uint file_index, mz_zip_archive_file_stat *pStat); + +// Determines if an archive file entry is a directory entry. +mz_bool mz_zip_reader_is_file_a_directory(mz_zip_archive *pZip, mz_uint file_index); +mz_bool mz_zip_reader_is_file_encrypted(mz_zip_archive *pZip, mz_uint file_index); + +// Retrieves the filename of an archive file entry. +// Returns the number of bytes written to pFilename, or if filename_buf_size is 0 this function returns the number of bytes needed to fully store the filename. +mz_uint mz_zip_reader_get_filename(mz_zip_archive *pZip, mz_uint file_index, char *pFilename, mz_uint filename_buf_size); + +// Attempts to locates a file in the archive's central directory. +// Valid flags: MZ_ZIP_FLAG_CASE_SENSITIVE, MZ_ZIP_FLAG_IGNORE_PATH +// Returns -1 if the file cannot be found. +int mz_zip_reader_locate_file(mz_zip_archive *pZip, const char *pName, const char *pComment, mz_uint flags); + +// Extracts a archive file to a memory buffer using no memory allocation. +mz_bool mz_zip_reader_extract_to_mem_no_alloc(mz_zip_archive *pZip, mz_uint file_index, void *pBuf, size_t buf_size, mz_uint flags, void *pUser_read_buf, size_t user_read_buf_size); +mz_bool mz_zip_reader_extract_file_to_mem_no_alloc(mz_zip_archive *pZip, const char *pFilename, void *pBuf, size_t buf_size, mz_uint flags, void *pUser_read_buf, size_t user_read_buf_size); + +// Extracts a archive file to a memory buffer. +mz_bool mz_zip_reader_extract_to_mem(mz_zip_archive *pZip, mz_uint file_index, void *pBuf, size_t buf_size, mz_uint flags); +mz_bool mz_zip_reader_extract_file_to_mem(mz_zip_archive *pZip, const char *pFilename, void *pBuf, size_t buf_size, mz_uint flags); + +// Extracts a archive file to a dynamically allocated heap buffer. +void *mz_zip_reader_extract_to_heap(mz_zip_archive *pZip, mz_uint file_index, size_t *pSize, mz_uint flags); +void *mz_zip_reader_extract_file_to_heap(mz_zip_archive *pZip, const char *pFilename, size_t *pSize, mz_uint flags); + +// Extracts a archive file using a callback function to output the file's data. +mz_bool mz_zip_reader_extract_to_callback(mz_zip_archive *pZip, mz_uint file_index, mz_file_write_func pCallback, void *pOpaque, mz_uint flags); +mz_bool mz_zip_reader_extract_file_to_callback(mz_zip_archive *pZip, const char *pFilename, mz_file_write_func pCallback, void *pOpaque, mz_uint flags); + +#ifndef MINIZ_NO_STDIO +// Extracts a archive file to a disk file and sets its last accessed and modified times. +// This function only extracts files, not archive directory records. +mz_bool mz_zip_reader_extract_to_file(mz_zip_archive *pZip, mz_uint file_index, const char *pDst_filename, mz_uint flags); +mz_bool mz_zip_reader_extract_file_to_file(mz_zip_archive *pZip, const char *pArchive_filename, const char *pDst_filename, mz_uint flags); +#endif + +// Ends archive reading, freeing all allocations, and closing the input archive file if mz_zip_reader_init_file() was used. +mz_bool mz_zip_reader_end(mz_zip_archive *pZip); + +// ZIP archive writing + +#ifndef MINIZ_NO_ARCHIVE_WRITING_APIS + +// Inits a ZIP archive writer. +mz_bool mz_zip_writer_init(mz_zip_archive *pZip, mz_uint64 existing_size); +mz_bool mz_zip_writer_init_heap(mz_zip_archive *pZip, size_t size_to_reserve_at_beginning, size_t initial_allocation_size); + +#ifndef MINIZ_NO_STDIO +mz_bool mz_zip_writer_init_file(mz_zip_archive *pZip, const char *pFilename, mz_uint64 size_to_reserve_at_beginning); +#endif + +// Converts a ZIP archive reader object into a writer object, to allow efficient in-place file appends to occur on an existing archive. +// For archives opened using mz_zip_reader_init_file, pFilename must be the archive's filename so it can be reopened for writing. If the file can't be reopened, mz_zip_reader_end() will be called. +// For archives opened using mz_zip_reader_init_mem, the memory block must be growable using the realloc callback (which defaults to realloc unless you've overridden it). +// Finally, for archives opened using mz_zip_reader_init, the mz_zip_archive's user provided m_pWrite function cannot be NULL. +// Note: In-place archive modification is not recommended unless you know what you're doing, because if execution stops or something goes wrong before +// the archive is finalized the file's central directory will be hosed. +mz_bool mz_zip_writer_init_from_reader(mz_zip_archive *pZip, const char *pFilename); + +// Adds the contents of a memory buffer to an archive. These functions record the current local time into the archive. +// To add a directory entry, call this method with an archive name ending in a forwardslash with empty buffer. +// level_and_flags - compression level (0-10, see MZ_BEST_SPEED, MZ_BEST_COMPRESSION, etc.) logically OR'd with zero or more mz_zip_flags, or just set to MZ_DEFAULT_COMPRESSION. +mz_bool mz_zip_writer_add_mem(mz_zip_archive *pZip, const char *pArchive_name, const void *pBuf, size_t buf_size, mz_uint level_and_flags); +mz_bool mz_zip_writer_add_mem_ex(mz_zip_archive *pZip, const char *pArchive_name, const void *pBuf, size_t buf_size, const void *pComment, mz_uint16 comment_size, mz_uint level_and_flags, mz_uint64 uncomp_size, mz_uint32 uncomp_crc32); + +#ifndef MINIZ_NO_STDIO +// Adds the contents of a disk file to an archive. This function also records the disk file's modified time into the archive. +// level_and_flags - compression level (0-10, see MZ_BEST_SPEED, MZ_BEST_COMPRESSION, etc.) logically OR'd with zero or more mz_zip_flags, or just set to MZ_DEFAULT_COMPRESSION. +mz_bool mz_zip_writer_add_file(mz_zip_archive *pZip, const char *pArchive_name, const char *pSrc_filename, const void *pComment, mz_uint16 comment_size, mz_uint level_and_flags); +#endif + +// Adds a file to an archive by fully cloning the data from another archive. +// This function fully clones the source file's compressed data (no recompression), along with its full filename, extra data, and comment fields. +mz_bool mz_zip_writer_add_from_zip_reader(mz_zip_archive *pZip, mz_zip_archive *pSource_zip, mz_uint file_index); + +// Finalizes the archive by writing the central directory records followed by the end of central directory record. +// After an archive is finalized, the only valid call on the mz_zip_archive struct is mz_zip_writer_end(). +// An archive must be manually finalized by calling this function for it to be valid. +mz_bool mz_zip_writer_finalize_archive(mz_zip_archive *pZip); +mz_bool mz_zip_writer_finalize_heap_archive(mz_zip_archive *pZip, void **pBuf, size_t *pSize); + +// Ends archive writing, freeing all allocations, and closing the output file if mz_zip_writer_init_file() was used. +// Note for the archive to be valid, it must have been finalized before ending. +mz_bool mz_zip_writer_end(mz_zip_archive *pZip); + +// Misc. high-level helper functions: + +// mz_zip_add_mem_to_archive_file_in_place() efficiently (but not atomically) appends a memory blob to a ZIP archive. +// level_and_flags - compression level (0-10, see MZ_BEST_SPEED, MZ_BEST_COMPRESSION, etc.) logically OR'd with zero or more mz_zip_flags, or just set to MZ_DEFAULT_COMPRESSION. +mz_bool mz_zip_add_mem_to_archive_file_in_place(const char *pZip_filename, const char *pArchive_name, const void *pBuf, size_t buf_size, const void *pComment, mz_uint16 comment_size, mz_uint level_and_flags); + +// Reads a single file from an archive into a heap block. +// Returns NULL on failure. +void *mz_zip_extract_archive_file_to_heap(const char *pZip_filename, const char *pArchive_name, size_t *pSize, mz_uint zip_flags); + +#endif // #ifndef MINIZ_NO_ARCHIVE_WRITING_APIS + +#endif // #ifndef MINIZ_NO_ARCHIVE_APIS + +// ------------------- Low-level Decompression API Definitions + +// Decompression flags used by tinfl_decompress(). +// TINFL_FLAG_PARSE_ZLIB_HEADER: If set, the input has a valid zlib header and ends with an adler32 checksum (it's a valid zlib stream). Otherwise, the input is a raw deflate stream. +// TINFL_FLAG_HAS_MORE_INPUT: If set, there are more input bytes available beyond the end of the supplied input buffer. If clear, the input buffer contains all remaining input. +// TINFL_FLAG_USING_NON_WRAPPING_OUTPUT_BUF: If set, the output buffer is large enough to hold the entire decompressed stream. If clear, the output buffer is at least the size of the dictionary (typically 32KB). +// TINFL_FLAG_COMPUTE_ADLER32: Force adler-32 checksum computation of the decompressed bytes. +enum +{ + TINFL_FLAG_PARSE_ZLIB_HEADER = 1, + TINFL_FLAG_HAS_MORE_INPUT = 2, + TINFL_FLAG_USING_NON_WRAPPING_OUTPUT_BUF = 4, + TINFL_FLAG_COMPUTE_ADLER32 = 8 +}; + +// High level decompression functions: +// tinfl_decompress_mem_to_heap() decompresses a block in memory to a heap block allocated via malloc(). +// On entry: +// pSrc_buf, src_buf_len: Pointer and size of the Deflate or zlib source data to decompress. +// On return: +// Function returns a pointer to the decompressed data, or NULL on failure. +// *pOut_len will be set to the decompressed data's size, which could be larger than src_buf_len on uncompressible data. +// The caller must call mz_free() on the returned block when it's no longer needed. +void *tinfl_decompress_mem_to_heap(const void *pSrc_buf, size_t src_buf_len, size_t *pOut_len, int flags); + +// tinfl_decompress_mem_to_mem() decompresses a block in memory to another block in memory. +// Returns TINFL_DECOMPRESS_MEM_TO_MEM_FAILED on failure, or the number of bytes written on success. +#define TINFL_DECOMPRESS_MEM_TO_MEM_FAILED ((size_t)(-1)) +size_t tinfl_decompress_mem_to_mem(void *pOut_buf, size_t out_buf_len, const void *pSrc_buf, size_t src_buf_len, int flags); + +// tinfl_decompress_mem_to_callback() decompresses a block in memory to an internal 32KB buffer, and a user provided callback function will be called to flush the buffer. +// Returns 1 on success or 0 on failure. +typedef int (*tinfl_put_buf_func_ptr)(const void* pBuf, int len, void *pUser); +int tinfl_decompress_mem_to_callback(const void *pIn_buf, size_t *pIn_buf_size, tinfl_put_buf_func_ptr pPut_buf_func, void *pPut_buf_user, int flags); + +struct tinfl_decompressor_tag; typedef struct tinfl_decompressor_tag tinfl_decompressor; + +// Max size of LZ dictionary. +#define TINFL_LZ_DICT_SIZE 32768 + +// Return status. +typedef enum +{ + TINFL_STATUS_BAD_PARAM = -3, + TINFL_STATUS_ADLER32_MISMATCH = -2, + TINFL_STATUS_FAILED = -1, + TINFL_STATUS_DONE = 0, + TINFL_STATUS_NEEDS_MORE_INPUT = 1, + TINFL_STATUS_HAS_MORE_OUTPUT = 2 +} tinfl_status; + +// Initializes the decompressor to its initial state. +#define tinfl_init(r) do { (r)->m_state = 0; } MZ_MACRO_END +#define tinfl_get_adler32(r) (r)->m_check_adler32 + +// Main low-level decompressor coroutine function. This is the only function actually needed for decompression. All the other functions are just high-level helpers for improved usability. +// This is a universal API, i.e. it can be used as a building block to build any desired higher level decompression API. In the limit case, it can be called once per every byte input or output. +tinfl_status tinfl_decompress(tinfl_decompressor *r, const mz_uint8 *pIn_buf_next, size_t *pIn_buf_size, mz_uint8 *pOut_buf_start, mz_uint8 *pOut_buf_next, size_t *pOut_buf_size, const mz_uint32 decomp_flags); + +// Internal/private bits follow. +enum +{ + TINFL_MAX_HUFF_TABLES = 3, TINFL_MAX_HUFF_SYMBOLS_0 = 288, TINFL_MAX_HUFF_SYMBOLS_1 = 32, TINFL_MAX_HUFF_SYMBOLS_2 = 19, + TINFL_FAST_LOOKUP_BITS = 10, TINFL_FAST_LOOKUP_SIZE = 1 << TINFL_FAST_LOOKUP_BITS +}; + +typedef struct +{ + mz_uint8 m_code_size[TINFL_MAX_HUFF_SYMBOLS_0]; + mz_int16 m_look_up[TINFL_FAST_LOOKUP_SIZE], m_tree[TINFL_MAX_HUFF_SYMBOLS_0 * 2]; +} tinfl_huff_table; + +#if MINIZ_HAS_64BIT_REGISTERS + #define TINFL_USE_64BIT_BITBUF 1 +#endif + +#if TINFL_USE_64BIT_BITBUF + typedef mz_uint64 tinfl_bit_buf_t; + #define TINFL_BITBUF_SIZE (64) +#else + typedef mz_uint32 tinfl_bit_buf_t; + #define TINFL_BITBUF_SIZE (32) +#endif + +struct tinfl_decompressor_tag +{ + mz_uint32 m_state, m_num_bits, m_zhdr0, m_zhdr1, m_z_adler32, m_final, m_type, m_check_adler32, m_dist, m_counter, m_num_extra, m_table_sizes[TINFL_MAX_HUFF_TABLES]; + tinfl_bit_buf_t m_bit_buf; + size_t m_dist_from_out_buf_start; + tinfl_huff_table m_tables[TINFL_MAX_HUFF_TABLES]; + mz_uint8 m_raw_header[4], m_len_codes[TINFL_MAX_HUFF_SYMBOLS_0 + TINFL_MAX_HUFF_SYMBOLS_1 + 137]; +}; + +// ------------------- Low-level Compression API Definitions + +// Set TDEFL_LESS_MEMORY to 1 to use less memory (compression will be slightly slower, and raw/dynamic blocks will be output more frequently). +#define TDEFL_LESS_MEMORY 1 + +// tdefl_init() compression flags logically OR'd together (low 12 bits contain the max. number of probes per dictionary search): +// TDEFL_DEFAULT_MAX_PROBES: The compressor defaults to 128 dictionary probes per dictionary search. 0=Huffman only, 1=Huffman+LZ (fastest/crap compression), 4095=Huffman+LZ (slowest/best compression). +enum +{ + TDEFL_HUFFMAN_ONLY = 0, TDEFL_DEFAULT_MAX_PROBES = 128, TDEFL_MAX_PROBES_MASK = 0xFFF +}; + +// TDEFL_WRITE_ZLIB_HEADER: If set, the compressor outputs a zlib header before the deflate data, and the Adler-32 of the source data at the end. Otherwise, you'll get raw deflate data. +// TDEFL_COMPUTE_ADLER32: Always compute the adler-32 of the input data (even when not writing zlib headers). +// TDEFL_GREEDY_PARSING_FLAG: Set to use faster greedy parsing, instead of more efficient lazy parsing. +// TDEFL_NONDETERMINISTIC_PARSING_FLAG: Enable to decrease the compressor's initialization time to the minimum, but the output may vary from run to run given the same input (depending on the contents of memory). +// TDEFL_RLE_MATCHES: Only look for RLE matches (matches with a distance of 1) +// TDEFL_FILTER_MATCHES: Discards matches <= 5 chars if enabled. +// TDEFL_FORCE_ALL_STATIC_BLOCKS: Disable usage of optimized Huffman tables. +// TDEFL_FORCE_ALL_RAW_BLOCKS: Only use raw (uncompressed) deflate blocks. +// The low 12 bits are reserved to control the max # of hash probes per dictionary lookup (see TDEFL_MAX_PROBES_MASK). +enum +{ + TDEFL_WRITE_ZLIB_HEADER = 0x01000, + TDEFL_COMPUTE_ADLER32 = 0x02000, + TDEFL_GREEDY_PARSING_FLAG = 0x04000, + TDEFL_NONDETERMINISTIC_PARSING_FLAG = 0x08000, + TDEFL_RLE_MATCHES = 0x10000, + TDEFL_FILTER_MATCHES = 0x20000, + TDEFL_FORCE_ALL_STATIC_BLOCKS = 0x40000, + TDEFL_FORCE_ALL_RAW_BLOCKS = 0x80000 +}; + +// High level compression functions: +// tdefl_compress_mem_to_heap() compresses a block in memory to a heap block allocated via malloc(). +// On entry: +// pSrc_buf, src_buf_len: Pointer and size of source block to compress. +// flags: The max match finder probes (default is 128) logically OR'd against the above flags. Higher probes are slower but improve compression. +// On return: +// Function returns a pointer to the compressed data, or NULL on failure. +// *pOut_len will be set to the compressed data's size, which could be larger than src_buf_len on uncompressible data. +// The caller must free() the returned block when it's no longer needed. +void *tdefl_compress_mem_to_heap(const void *pSrc_buf, size_t src_buf_len, size_t *pOut_len, int flags); + +// tdefl_compress_mem_to_mem() compresses a block in memory to another block in memory. +// Returns 0 on failure. +size_t tdefl_compress_mem_to_mem(void *pOut_buf, size_t out_buf_len, const void *pSrc_buf, size_t src_buf_len, int flags); + +// Compresses an image to a compressed PNG file in memory. +// On entry: +// pImage, w, h, and num_chans describe the image to compress. num_chans may be 1, 2, 3, or 4. +// The image pitch in bytes per scanline will be w*num_chans. The leftmost pixel on the top scanline is stored first in memory. +// level may range from [0,10], use MZ_NO_COMPRESSION, MZ_BEST_SPEED, MZ_BEST_COMPRESSION, etc. or a decent default is MZ_DEFAULT_LEVEL +// If flip is true, the image will be flipped on the Y axis (useful for OpenGL apps). +// On return: +// Function returns a pointer to the compressed data, or NULL on failure. +// *pLen_out will be set to the size of the PNG image file. +// The caller must mz_free() the returned heap block (which will typically be larger than *pLen_out) when it's no longer needed. +void *tdefl_write_image_to_png_file_in_memory_ex(const void *pImage, int w, int h, int num_chans, size_t *pLen_out, mz_uint level, mz_bool flip); +void *tdefl_write_image_to_png_file_in_memory(const void *pImage, int w, int h, int num_chans, size_t *pLen_out); + +// Output stream interface. The compressor uses this interface to write compressed data. It'll typically be called TDEFL_OUT_BUF_SIZE at a time. +typedef mz_bool (*tdefl_put_buf_func_ptr)(const void* pBuf, int len, void *pUser); + +// tdefl_compress_mem_to_output() compresses a block to an output stream. The above helpers use this function internally. +mz_bool tdefl_compress_mem_to_output(const void *pBuf, size_t buf_len, tdefl_put_buf_func_ptr pPut_buf_func, void *pPut_buf_user, int flags); + +enum { TDEFL_MAX_HUFF_TABLES = 3, TDEFL_MAX_HUFF_SYMBOLS_0 = 288, TDEFL_MAX_HUFF_SYMBOLS_1 = 32, TDEFL_MAX_HUFF_SYMBOLS_2 = 19, TDEFL_LZ_DICT_SIZE = 32768, TDEFL_LZ_DICT_SIZE_MASK = TDEFL_LZ_DICT_SIZE - 1, TDEFL_MIN_MATCH_LEN = 3, TDEFL_MAX_MATCH_LEN = 258 }; + +// TDEFL_OUT_BUF_SIZE MUST be large enough to hold a single entire compressed output block (using static/fixed Huffman codes). +#if TDEFL_LESS_MEMORY +enum { TDEFL_LZ_CODE_BUF_SIZE = 24 * 1024, TDEFL_OUT_BUF_SIZE = (TDEFL_LZ_CODE_BUF_SIZE * 13 ) / 10, TDEFL_MAX_HUFF_SYMBOLS = 288, TDEFL_LZ_HASH_BITS = 12, TDEFL_LEVEL1_HASH_SIZE_MASK = 4095, TDEFL_LZ_HASH_SHIFT = (TDEFL_LZ_HASH_BITS + 2) / 3, TDEFL_LZ_HASH_SIZE = 1 << TDEFL_LZ_HASH_BITS }; +#else +enum { TDEFL_LZ_CODE_BUF_SIZE = 64 * 1024, TDEFL_OUT_BUF_SIZE = (TDEFL_LZ_CODE_BUF_SIZE * 13 ) / 10, TDEFL_MAX_HUFF_SYMBOLS = 288, TDEFL_LZ_HASH_BITS = 15, TDEFL_LEVEL1_HASH_SIZE_MASK = 4095, TDEFL_LZ_HASH_SHIFT = (TDEFL_LZ_HASH_BITS + 2) / 3, TDEFL_LZ_HASH_SIZE = 1 << TDEFL_LZ_HASH_BITS }; +#endif + +// The low-level tdefl functions below may be used directly if the above helper functions aren't flexible enough. The low-level functions don't make any heap allocations, unlike the above helper functions. +typedef enum +{ + TDEFL_STATUS_BAD_PARAM = -2, + TDEFL_STATUS_PUT_BUF_FAILED = -1, + TDEFL_STATUS_OKAY = 0, + TDEFL_STATUS_DONE = 1, +} tdefl_status; + +// Must map to MZ_NO_FLUSH, MZ_SYNC_FLUSH, etc. enums +typedef enum +{ + TDEFL_NO_FLUSH = 0, + TDEFL_SYNC_FLUSH = 2, + TDEFL_FULL_FLUSH = 3, + TDEFL_FINISH = 4 +} tdefl_flush; + +// tdefl's compression state structure. +typedef struct +{ + tdefl_put_buf_func_ptr m_pPut_buf_func; + void *m_pPut_buf_user; + mz_uint m_flags, m_max_probes[2]; + int m_greedy_parsing; + mz_uint m_adler32, m_lookahead_pos, m_lookahead_size, m_dict_size; + mz_uint8 *m_pLZ_code_buf, *m_pLZ_flags, *m_pOutput_buf, *m_pOutput_buf_end; + mz_uint m_num_flags_left, m_total_lz_bytes, m_lz_code_buf_dict_pos, m_bits_in, m_bit_buffer; + mz_uint m_saved_match_dist, m_saved_match_len, m_saved_lit, m_output_flush_ofs, m_output_flush_remaining, m_finished, m_block_index, m_wants_to_finish; + tdefl_status m_prev_return_status; + const void *m_pIn_buf; + void *m_pOut_buf; + size_t *m_pIn_buf_size, *m_pOut_buf_size; + tdefl_flush m_flush; + const mz_uint8 *m_pSrc; + size_t m_src_buf_left, m_out_buf_ofs; + mz_uint8 m_dict[TDEFL_LZ_DICT_SIZE + TDEFL_MAX_MATCH_LEN - 1]; + mz_uint16 m_huff_count[TDEFL_MAX_HUFF_TABLES][TDEFL_MAX_HUFF_SYMBOLS]; + mz_uint16 m_huff_codes[TDEFL_MAX_HUFF_TABLES][TDEFL_MAX_HUFF_SYMBOLS]; + mz_uint8 m_huff_code_sizes[TDEFL_MAX_HUFF_TABLES][TDEFL_MAX_HUFF_SYMBOLS]; + mz_uint8 m_lz_code_buf[TDEFL_LZ_CODE_BUF_SIZE]; + mz_uint16 m_next[TDEFL_LZ_DICT_SIZE]; + mz_uint16 m_hash[TDEFL_LZ_HASH_SIZE]; + mz_uint8 m_output_buf[TDEFL_OUT_BUF_SIZE]; +} tdefl_compressor; + +// Initializes the compressor. +// There is no corresponding deinit() function because the tdefl API's do not dynamically allocate memory. +// pBut_buf_func: If NULL, output data will be supplied to the specified callback. In this case, the user should call the tdefl_compress_buffer() API for compression. +// If pBut_buf_func is NULL the user should always call the tdefl_compress() API. +// flags: See the above enums (TDEFL_HUFFMAN_ONLY, TDEFL_WRITE_ZLIB_HEADER, etc.) +tdefl_status tdefl_init(tdefl_compressor *d, tdefl_put_buf_func_ptr pPut_buf_func, void *pPut_buf_user, int flags); + +// Compresses a block of data, consuming as much of the specified input buffer as possible, and writing as much compressed data to the specified output buffer as possible. +tdefl_status tdefl_compress(tdefl_compressor *d, const void *pIn_buf, size_t *pIn_buf_size, void *pOut_buf, size_t *pOut_buf_size, tdefl_flush flush); + +// tdefl_compress_buffer() is only usable when the tdefl_init() is called with a non-NULL tdefl_put_buf_func_ptr. +// tdefl_compress_buffer() always consumes the entire input buffer. +tdefl_status tdefl_compress_buffer(tdefl_compressor *d, const void *pIn_buf, size_t in_buf_size, tdefl_flush flush); + +tdefl_status tdefl_get_prev_return_status(tdefl_compressor *d); +mz_uint32 tdefl_get_adler32(tdefl_compressor *d); + +// Can't use tdefl_create_comp_flags_from_zip_params if MINIZ_NO_ZLIB_APIS isn't defined, because it uses some of its macros. +#ifndef MINIZ_NO_ZLIB_APIS +// Create tdefl_compress() flags given zlib-style compression parameters. +// level may range from [0,10] (where 10 is absolute max compression, but may be much slower on some files) +// window_bits may be -15 (raw deflate) or 15 (zlib) +// strategy may be either MZ_DEFAULT_STRATEGY, MZ_FILTERED, MZ_HUFFMAN_ONLY, MZ_RLE, or MZ_FIXED +mz_uint tdefl_create_comp_flags_from_zip_params(int level, int window_bits, int strategy); +#endif // #ifndef MINIZ_NO_ZLIB_APIS + +#ifdef __cplusplus +} +#endif + +#endif // MINIZ_HEADER_INCLUDED + diff --git a/components/esp32/include/rom/queue.h b/components/esp32/include/rom/queue.h new file mode 100755 index 000000000..29ee67060 --- /dev/null +++ b/components/esp32/include/rom/queue.h @@ -0,0 +1,645 @@ +/*- + * Copyright (c) 1991, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)queue.h 8.5 (Berkeley) 8/20/94 + * $FreeBSD$ + */ + +#ifndef _SYS_QUEUE_H_ +#define _SYS_QUEUE_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * This file defines four types of data structures: singly-linked lists, + * singly-linked tail queues, lists and tail queues. + * + * A singly-linked list is headed by a single forward pointer. The elements + * are singly linked for minimum space and pointer manipulation overhead at + * the expense of O(n) removal for arbitrary elements. New elements can be + * added to the list after an existing element or at the head of the list. + * Elements being removed from the head of the list should use the explicit + * macro for this purpose for optimum efficiency. A singly-linked list may + * only be traversed in the forward direction. Singly-linked lists are ideal + * for applications with large datasets and few or no removals or for + * implementing a LIFO queue. + * + * A singly-linked tail queue is headed by a pair of pointers, one to the + * head of the list and the other to the tail of the list. The elements are + * singly linked for minimum space and pointer manipulation overhead at the + * expense of O(n) removal for arbitrary elements. New elements can be added + * to the list after an existing element, at the head of the list, or at the + * end of the list. Elements being removed from the head of the tail queue + * should use the explicit macro for this purpose for optimum efficiency. + * A singly-linked tail queue may only be traversed in the forward direction. + * Singly-linked tail queues are ideal for applications with large datasets + * and few or no removals or for implementing a FIFO queue. + * + * A list is headed by a single forward pointer (or an array of forward + * pointers for a hash table header). The elements are doubly linked + * so that an arbitrary element can be removed without a need to + * traverse the list. New elements can be added to the list before + * or after an existing element or at the head of the list. A list + * may only be traversed in the forward direction. + * + * A tail queue is headed by a pair of pointers, one to the head of the + * list and the other to the tail of the list. The elements are doubly + * linked so that an arbitrary element can be removed without a need to + * traverse the list. New elements can be added to the list before or + * after an existing element, at the head of the list, or at the end of + * the list. A tail queue may be traversed in either direction. + * + * For details on the use of these macros, see the queue(3) manual page. + * + * + * SLIST LIST STAILQ TAILQ + * _HEAD + + + + + * _HEAD_INITIALIZER + + + + + * _ENTRY + + + + + * _INIT + + + + + * _EMPTY + + + + + * _FIRST + + + + + * _NEXT + + + + + * _PREV - - - + + * _LAST - - + + + * _FOREACH + + + + + * _FOREACH_SAFE + + + + + * _FOREACH_REVERSE - - - + + * _FOREACH_REVERSE_SAFE - - - + + * _INSERT_HEAD + + + + + * _INSERT_BEFORE - + - + + * _INSERT_AFTER + + + + + * _INSERT_TAIL - - + + + * _CONCAT - - + + + * _REMOVE_AFTER + - + - + * _REMOVE_HEAD + - + - + * _REMOVE + + + + + * + */ +#ifdef QUEUE_MACRO_DEBUG +/* Store the last 2 places the queue element or head was altered */ +struct qm_trace { + char * lastfile; + int lastline; + char * prevfile; + int prevline; +}; + +#define TRACEBUF struct qm_trace trace; +#define TRASHIT(x) do {(x) = (void *)-1;} while (0) +#define QMD_SAVELINK(name, link) void **name = (void *)&(link) + +#define QMD_TRACE_HEAD(head) do { \ + (head)->trace.prevline = (head)->trace.lastline; \ + (head)->trace.prevfile = (head)->trace.lastfile; \ + (head)->trace.lastline = __LINE__; \ + (head)->trace.lastfile = __FILE__; \ +} while (0) + +#define QMD_TRACE_ELEM(elem) do { \ + (elem)->trace.prevline = (elem)->trace.lastline; \ + (elem)->trace.prevfile = (elem)->trace.lastfile; \ + (elem)->trace.lastline = __LINE__; \ + (elem)->trace.lastfile = __FILE__; \ +} while (0) + +#else +#define QMD_TRACE_ELEM(elem) +#define QMD_TRACE_HEAD(head) +#define QMD_SAVELINK(name, link) +#define TRACEBUF +#define TRASHIT(x) +#endif /* QUEUE_MACRO_DEBUG */ + +/* + * Singly-linked List declarations. + */ +#define SLIST_HEAD(name, type) \ +struct name { \ + struct type *slh_first; /* first element */ \ +} + +#define SLIST_HEAD_INITIALIZER(head) \ + { NULL } + +#define SLIST_ENTRY(type) \ +struct { \ + struct type *sle_next; /* next element */ \ +} + +/* + * Singly-linked List functions. + */ +#define SLIST_EMPTY(head) ((head)->slh_first == NULL) + +#define SLIST_FIRST(head) ((head)->slh_first) + +#define SLIST_FOREACH(var, head, field) \ + for ((var) = SLIST_FIRST((head)); \ + (var); \ + (var) = SLIST_NEXT((var), field)) + +#define SLIST_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = SLIST_FIRST((head)); \ + (var) && ((tvar) = SLIST_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define SLIST_FOREACH_PREVPTR(var, varp, head, field) \ + for ((varp) = &SLIST_FIRST((head)); \ + ((var) = *(varp)) != NULL; \ + (varp) = &SLIST_NEXT((var), field)) + +#define SLIST_INIT(head) do { \ + SLIST_FIRST((head)) = NULL; \ +} while (0) + +#define SLIST_INSERT_AFTER(slistelm, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_NEXT((slistelm), field); \ + SLIST_NEXT((slistelm), field) = (elm); \ +} while (0) + +#define SLIST_INSERT_HEAD(head, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_FIRST((head)); \ + SLIST_FIRST((head)) = (elm); \ +} while (0) + +#define SLIST_NEXT(elm, field) ((elm)->field.sle_next) + +#define SLIST_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.sle_next); \ + if (SLIST_FIRST((head)) == (elm)) { \ + SLIST_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = SLIST_FIRST((head)); \ + while (SLIST_NEXT(curelm, field) != (elm)) \ + curelm = SLIST_NEXT(curelm, field); \ + SLIST_REMOVE_AFTER(curelm, field); \ + } \ + TRASHIT(*oldnext); \ +} while (0) + +#define SLIST_REMOVE_AFTER(elm, field) do { \ + SLIST_NEXT(elm, field) = \ + SLIST_NEXT(SLIST_NEXT(elm, field), field); \ +} while (0) + +#define SLIST_REMOVE_HEAD(head, field) do { \ + SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field); \ +} while (0) + +/* + * Singly-linked Tail queue declarations. + */ +#define STAILQ_HEAD(name, type) \ +struct name { \ + struct type *stqh_first;/* first element */ \ + struct type **stqh_last;/* addr of last next element */ \ +} + +#define STAILQ_HEAD_INITIALIZER(head) \ + { NULL, &(head).stqh_first } + +#define STAILQ_ENTRY(type) \ +struct { \ + struct type *stqe_next; /* next element */ \ +} + +/* + * Singly-linked Tail queue functions. + */ +#define STAILQ_CONCAT(head1, head2) do { \ + if (!STAILQ_EMPTY((head2))) { \ + *(head1)->stqh_last = (head2)->stqh_first; \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_INIT((head2)); \ + } \ +} while (0) + +#define STAILQ_EMPTY(head) ((head)->stqh_first == NULL) + +#define STAILQ_FIRST(head) ((head)->stqh_first) + +#define STAILQ_FOREACH(var, head, field) \ + for((var) = STAILQ_FIRST((head)); \ + (var); \ + (var) = STAILQ_NEXT((var), field)) + + +#define STAILQ_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = STAILQ_FIRST((head)); \ + (var) && ((tvar) = STAILQ_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define STAILQ_INIT(head) do { \ + STAILQ_FIRST((head)) = NULL; \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ +} while (0) + +#define STAILQ_INSERT_AFTER(head, tqelm, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_NEXT((tqelm), field)) == NULL)\ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_NEXT((tqelm), field) = (elm); \ +} while (0) + +#define STAILQ_INSERT_HEAD(head, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_FIRST((head))) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_FIRST((head)) = (elm); \ +} while (0) + +#define STAILQ_INSERT_TAIL(head, elm, field) do { \ + STAILQ_NEXT((elm), field) = NULL; \ + *(head)->stqh_last = (elm); \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ +} while (0) + +#define STAILQ_LAST(head, type, field) \ + (STAILQ_EMPTY((head)) ? \ + NULL : \ + ((struct type *)(void *) \ + ((char *)((head)->stqh_last) - __offsetof(struct type, field)))) + +#define STAILQ_NEXT(elm, field) ((elm)->field.stqe_next) + +#define STAILQ_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.stqe_next); \ + if (STAILQ_FIRST((head)) == (elm)) { \ + STAILQ_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = STAILQ_FIRST((head)); \ + while (STAILQ_NEXT(curelm, field) != (elm)) \ + curelm = STAILQ_NEXT(curelm, field); \ + STAILQ_REMOVE_AFTER(head, curelm, field); \ + } \ + TRASHIT(*oldnext); \ +} while (0) + +#define STAILQ_REMOVE_HEAD(head, field) do { \ + if ((STAILQ_FIRST((head)) = \ + STAILQ_NEXT(STAILQ_FIRST((head)), field)) == NULL) \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ +} while (0) + +#define STAILQ_REMOVE_AFTER(head, elm, field) do { \ + if ((STAILQ_NEXT(elm, field) = \ + STAILQ_NEXT(STAILQ_NEXT(elm, field), field)) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ +} while (0) + +#define STAILQ_SWAP(head1, head2, type) do { \ + struct type *swap_first = STAILQ_FIRST(head1); \ + struct type **swap_last = (head1)->stqh_last; \ + STAILQ_FIRST(head1) = STAILQ_FIRST(head2); \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_FIRST(head2) = swap_first; \ + (head2)->stqh_last = swap_last; \ + if (STAILQ_EMPTY(head1)) \ + (head1)->stqh_last = &STAILQ_FIRST(head1); \ + if (STAILQ_EMPTY(head2)) \ + (head2)->stqh_last = &STAILQ_FIRST(head2); \ +} while (0) + +#define STAILQ_INSERT_CHAIN_HEAD(head, elm_chead, elm_ctail, field) do { \ + if ((STAILQ_NEXT(elm_ctail, field) = STAILQ_FIRST(head)) == NULL ) { \ + (head)->stqh_last = &STAILQ_NEXT(elm_ctail, field); \ + } \ + STAILQ_FIRST(head) = (elm_chead); \ +} while (0) + + +/* + * List declarations. + */ +#define LIST_HEAD(name, type) \ +struct name { \ + struct type *lh_first; /* first element */ \ +} + +#define LIST_HEAD_INITIALIZER(head) \ + { NULL } + +#define LIST_ENTRY(type) \ +struct { \ + struct type *le_next; /* next element */ \ + struct type **le_prev; /* address of previous next element */ \ +} + +/* + * List functions. + */ + +#if (defined(_KERNEL) && defined(INVARIANTS)) +#define QMD_LIST_CHECK_HEAD(head, field) do { \ + if (LIST_FIRST((head)) != NULL && \ + LIST_FIRST((head))->field.le_prev != \ + &LIST_FIRST((head))) \ + panic("Bad list head %p first->prev != head", (head)); \ +} while (0) + +#define QMD_LIST_CHECK_NEXT(elm, field) do { \ + if (LIST_NEXT((elm), field) != NULL && \ + LIST_NEXT((elm), field)->field.le_prev != \ + &((elm)->field.le_next)) \ + panic("Bad link elm %p next->prev != elm", (elm)); \ +} while (0) + +#define QMD_LIST_CHECK_PREV(elm, field) do { \ + if (*(elm)->field.le_prev != (elm)) \ + panic("Bad link elm %p prev->next != elm", (elm)); \ +} while (0) +#else +#define QMD_LIST_CHECK_HEAD(head, field) +#define QMD_LIST_CHECK_NEXT(elm, field) +#define QMD_LIST_CHECK_PREV(elm, field) +#endif /* (_KERNEL && INVARIANTS) */ + +#define LIST_EMPTY(head) ((head)->lh_first == NULL) + +#define LIST_FIRST(head) ((head)->lh_first) + +#define LIST_FOREACH(var, head, field) \ + for ((var) = LIST_FIRST((head)); \ + (var); \ + (var) = LIST_NEXT((var), field)) + +#define LIST_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = LIST_FIRST((head)); \ + (var) && ((tvar) = LIST_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define LIST_INIT(head) do { \ + LIST_FIRST((head)) = NULL; \ +} while (0) + +#define LIST_INSERT_AFTER(listelm, elm, field) do { \ + QMD_LIST_CHECK_NEXT(listelm, field); \ + if ((LIST_NEXT((elm), field) = LIST_NEXT((listelm), field)) != NULL)\ + LIST_NEXT((listelm), field)->field.le_prev = \ + &LIST_NEXT((elm), field); \ + LIST_NEXT((listelm), field) = (elm); \ + (elm)->field.le_prev = &LIST_NEXT((listelm), field); \ +} while (0) + +#define LIST_INSERT_BEFORE(listelm, elm, field) do { \ + QMD_LIST_CHECK_PREV(listelm, field); \ + (elm)->field.le_prev = (listelm)->field.le_prev; \ + LIST_NEXT((elm), field) = (listelm); \ + *(listelm)->field.le_prev = (elm); \ + (listelm)->field.le_prev = &LIST_NEXT((elm), field); \ +} while (0) + +#define LIST_INSERT_HEAD(head, elm, field) do { \ + QMD_LIST_CHECK_HEAD((head), field); \ + if ((LIST_NEXT((elm), field) = LIST_FIRST((head))) != NULL) \ + LIST_FIRST((head))->field.le_prev = &LIST_NEXT((elm), field);\ + LIST_FIRST((head)) = (elm); \ + (elm)->field.le_prev = &LIST_FIRST((head)); \ +} while (0) + +#define LIST_NEXT(elm, field) ((elm)->field.le_next) + +#define LIST_REMOVE(elm, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.le_next); \ + QMD_SAVELINK(oldprev, (elm)->field.le_prev); \ + QMD_LIST_CHECK_NEXT(elm, field); \ + QMD_LIST_CHECK_PREV(elm, field); \ + if (LIST_NEXT((elm), field) != NULL) \ + LIST_NEXT((elm), field)->field.le_prev = \ + (elm)->field.le_prev; \ + *(elm)->field.le_prev = LIST_NEXT((elm), field); \ + TRASHIT(*oldnext); \ + TRASHIT(*oldprev); \ +} while (0) + +#define LIST_SWAP(head1, head2, type, field) do { \ + struct type *swap_tmp = LIST_FIRST((head1)); \ + LIST_FIRST((head1)) = LIST_FIRST((head2)); \ + LIST_FIRST((head2)) = swap_tmp; \ + if ((swap_tmp = LIST_FIRST((head1))) != NULL) \ + swap_tmp->field.le_prev = &LIST_FIRST((head1)); \ + if ((swap_tmp = LIST_FIRST((head2))) != NULL) \ + swap_tmp->field.le_prev = &LIST_FIRST((head2)); \ +} while (0) + +/* + * Tail queue declarations. + */ +#define TAILQ_HEAD(name, type) \ +struct name { \ + struct type *tqh_first; /* first element */ \ + struct type **tqh_last; /* addr of last next element */ \ + TRACEBUF \ +} + +#define TAILQ_HEAD_INITIALIZER(head) \ + { NULL, &(head).tqh_first } + +#define TAILQ_ENTRY(type) \ +struct { \ + struct type *tqe_next; /* next element */ \ + struct type **tqe_prev; /* address of previous next element */ \ + TRACEBUF \ +} + +/* + * Tail queue functions. + */ +#if (defined(_KERNEL) && defined(INVARIANTS)) +#define QMD_TAILQ_CHECK_HEAD(head, field) do { \ + if (!TAILQ_EMPTY(head) && \ + TAILQ_FIRST((head))->field.tqe_prev != \ + &TAILQ_FIRST((head))) \ + panic("Bad tailq head %p first->prev != head", (head)); \ +} while (0) + +#define QMD_TAILQ_CHECK_TAIL(head, field) do { \ + if (*(head)->tqh_last != NULL) \ + panic("Bad tailq NEXT(%p->tqh_last) != NULL", (head)); \ +} while (0) + +#define QMD_TAILQ_CHECK_NEXT(elm, field) do { \ + if (TAILQ_NEXT((elm), field) != NULL && \ + TAILQ_NEXT((elm), field)->field.tqe_prev != \ + &((elm)->field.tqe_next)) \ + panic("Bad link elm %p next->prev != elm", (elm)); \ +} while (0) + +#define QMD_TAILQ_CHECK_PREV(elm, field) do { \ + if (*(elm)->field.tqe_prev != (elm)) \ + panic("Bad link elm %p prev->next != elm", (elm)); \ +} while (0) +#else +#define QMD_TAILQ_CHECK_HEAD(head, field) +#define QMD_TAILQ_CHECK_TAIL(head, headname) +#define QMD_TAILQ_CHECK_NEXT(elm, field) +#define QMD_TAILQ_CHECK_PREV(elm, field) +#endif /* (_KERNEL && INVARIANTS) */ + +#define TAILQ_CONCAT(head1, head2, field) do { \ + if (!TAILQ_EMPTY(head2)) { \ + *(head1)->tqh_last = (head2)->tqh_first; \ + (head2)->tqh_first->field.tqe_prev = (head1)->tqh_last; \ + (head1)->tqh_last = (head2)->tqh_last; \ + TAILQ_INIT((head2)); \ + QMD_TRACE_HEAD(head1); \ + QMD_TRACE_HEAD(head2); \ + } \ +} while (0) + +#define TAILQ_EMPTY(head) ((head)->tqh_first == NULL) + +#define TAILQ_FIRST(head) ((head)->tqh_first) + +#define TAILQ_FOREACH(var, head, field) \ + for ((var) = TAILQ_FIRST((head)); \ + (var); \ + (var) = TAILQ_NEXT((var), field)) + +#define TAILQ_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = TAILQ_FIRST((head)); \ + (var) && ((tvar) = TAILQ_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define TAILQ_FOREACH_REVERSE(var, head, headname, field) \ + for ((var) = TAILQ_LAST((head), headname); \ + (var); \ + (var) = TAILQ_PREV((var), headname, field)) + +#define TAILQ_FOREACH_REVERSE_SAFE(var, head, headname, field, tvar) \ + for ((var) = TAILQ_LAST((head), headname); \ + (var) && ((tvar) = TAILQ_PREV((var), headname, field), 1); \ + (var) = (tvar)) + +#define TAILQ_INIT(head) do { \ + TAILQ_FIRST((head)) = NULL; \ + (head)->tqh_last = &TAILQ_FIRST((head)); \ + QMD_TRACE_HEAD(head); \ +} while (0) + +#define TAILQ_INSERT_AFTER(head, listelm, elm, field) do { \ + QMD_TAILQ_CHECK_NEXT(listelm, field); \ + if ((TAILQ_NEXT((elm), field) = TAILQ_NEXT((listelm), field)) != NULL)\ + TAILQ_NEXT((elm), field)->field.tqe_prev = \ + &TAILQ_NEXT((elm), field); \ + else { \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_HEAD(head); \ + } \ + TAILQ_NEXT((listelm), field) = (elm); \ + (elm)->field.tqe_prev = &TAILQ_NEXT((listelm), field); \ + QMD_TRACE_ELEM(&(elm)->field); \ + QMD_TRACE_ELEM(&listelm->field); \ +} while (0) + +#define TAILQ_INSERT_BEFORE(listelm, elm, field) do { \ + QMD_TAILQ_CHECK_PREV(listelm, field); \ + (elm)->field.tqe_prev = (listelm)->field.tqe_prev; \ + TAILQ_NEXT((elm), field) = (listelm); \ + *(listelm)->field.tqe_prev = (elm); \ + (listelm)->field.tqe_prev = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_ELEM(&(elm)->field); \ + QMD_TRACE_ELEM(&listelm->field); \ +} while (0) + +#define TAILQ_INSERT_HEAD(head, elm, field) do { \ + QMD_TAILQ_CHECK_HEAD(head, field); \ + if ((TAILQ_NEXT((elm), field) = TAILQ_FIRST((head))) != NULL) \ + TAILQ_FIRST((head))->field.tqe_prev = \ + &TAILQ_NEXT((elm), field); \ + else \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + TAILQ_FIRST((head)) = (elm); \ + (elm)->field.tqe_prev = &TAILQ_FIRST((head)); \ + QMD_TRACE_HEAD(head); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_INSERT_TAIL(head, elm, field) do { \ + QMD_TAILQ_CHECK_TAIL(head, field); \ + TAILQ_NEXT((elm), field) = NULL; \ + (elm)->field.tqe_prev = (head)->tqh_last; \ + *(head)->tqh_last = (elm); \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_HEAD(head); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_LAST(head, headname) \ + (*(((struct headname *)((head)->tqh_last))->tqh_last)) + +#define TAILQ_NEXT(elm, field) ((elm)->field.tqe_next) + +#define TAILQ_PREV(elm, headname, field) \ + (*(((struct headname *)((elm)->field.tqe_prev))->tqh_last)) + +#define TAILQ_REMOVE(head, elm, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.tqe_next); \ + QMD_SAVELINK(oldprev, (elm)->field.tqe_prev); \ + QMD_TAILQ_CHECK_NEXT(elm, field); \ + QMD_TAILQ_CHECK_PREV(elm, field); \ + if ((TAILQ_NEXT((elm), field)) != NULL) \ + TAILQ_NEXT((elm), field)->field.tqe_prev = \ + (elm)->field.tqe_prev; \ + else { \ + (head)->tqh_last = (elm)->field.tqe_prev; \ + QMD_TRACE_HEAD(head); \ + } \ + *(elm)->field.tqe_prev = TAILQ_NEXT((elm), field); \ + TRASHIT(*oldnext); \ + TRASHIT(*oldprev); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_SWAP(head1, head2, type, field) do { \ + struct type *swap_first = (head1)->tqh_first; \ + struct type **swap_last = (head1)->tqh_last; \ + (head1)->tqh_first = (head2)->tqh_first; \ + (head1)->tqh_last = (head2)->tqh_last; \ + (head2)->tqh_first = swap_first; \ + (head2)->tqh_last = swap_last; \ + if ((swap_first = (head1)->tqh_first) != NULL) \ + swap_first->field.tqe_prev = &(head1)->tqh_first; \ + else \ + (head1)->tqh_last = &(head1)->tqh_first; \ + if ((swap_first = (head2)->tqh_first) != NULL) \ + swap_first->field.tqe_prev = &(head2)->tqh_first; \ + else \ + (head2)->tqh_last = &(head2)->tqh_first; \ +} while (0) + +#ifdef __cplusplus +} +#endif + +#endif /* !_SYS_QUEUE_H_ */ diff --git a/components/esp32/include/rom/rtc.h b/components/esp32/include/rom/rtc.h new file mode 100644 index 000000000..31323646f --- /dev/null +++ b/components/esp32/include/rom/rtc.h @@ -0,0 +1,168 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_RTC_H_ +#define _ROM_RTC_H_ + +#include "ets_sys.h" + +#include +#include + +#include "soc/soc.h" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef enum { + AWAKE = 0, //CPU ON + LIGHT_SLEEP = BIT0, //CPU waiti, PLL ON. We don't need explicitly set this mode. + DEEP_SLEEP = BIT1 //CPU OFF, PLL OFF, only specific timer could wake up +} SLEEP_MODE; + +typedef enum { + NO_MEAN = 0, + POWERON_RESET = 1, //1 Vbat power on reset, RTC reset +// EXT_SYS_RESET = 2, //4 External System reset, RTC reset + SW_RESET = 3, //6 Software warm reset + OWDT_RESET = 4, //5 Watch dog reset + DEEPSLEEP_RESET = 5, //2 Deep sleep timer reach reset. + SDIO_RESET = 6, //3 Deep sleep Pbint power on reset [boot] + TG0WDT_SYS_RESET = 7, + TG1WDT_SYS_RESET = 8, + RTCWDT_SYS_RESET = 9, + INTRUSION_RESET = 10, + TGWDT_CPU_RESET = 11, + SW_CPU_RESET = 12, + RTCWDT_CPU_RESET = 13, + EXT_CPU_RESET = 14, + RTCWDT_BROWN_OUT_RESET = 15, + RTCWDT_RTC_RESET = 16 +} RESET_REASON; + +typedef enum { + NO_SLEEP = 0, + EXT_EVENT0_TRIG = BIT0, + EXT_EVENT1_TRIG = BIT1, + GPIO_TRIG = BIT2, + TIMER_EXPIRE = BIT3, + SDIO_TRIG = BIT4, + MAC_TRIG = BIT5, + UART0_TRIG = BIT6, + UART1_TRIG = BIT7, + TOUCH_TRIG = BIT8, + SAR_TRIG = BIT9, + BT_TRIG = BIT10 +} WAKEUP_REASON; + +typedef enum { + DISEN_WAKEUP = NO_SLEEP, + EXT_EVENT0_TRIG_EN = EXT_EVENT0_TRIG, + EXT_EVENT1_TRIG_EN = EXT_EVENT1_TRIG, + GPIO_TRIG_EN = GPIO_TRIG, + TIMER_EXPIRE_EN = TIMER_EXPIRE, + SDIO_TRIG_EN = SDIO_TRIG, + MAC_TRIG_EN = MAC_TRIG, + UART0_TRIG_EN = UART0_TRIG, + UART1_TRIG_EN = UART1_TRIG, + TOUCH_TRIG_EN = TOUCH_TRIG, + SAR_TRIG_EN = SAR_TRIG, + BT_TRIG_EN = BT_TRIG +} WAKEUP_ENABLE; + +typedef enum { + NO_INT = 0, + WAKEUP_INT = BIT0, + REJECT_INT = BIT1, + SDIO_IDLE_INT = BIT2, + RTC_WDT_INT = BIT3, + RTC_TIME_VALID_INT = BIT4 +} RTC_INT_REASON; + +typedef enum { + DISEN_INT = 0, + WAKEUP_INT_EN = WAKEUP_INT, + REJECT_INT_EN = REJECT_INT, + SDIO_IDLE_INT_EN = SDIO_IDLE_INT, + RTC_WDT_INT_EN = RTC_WDT_INT, + RTC_TIME_VALID_INT_EN = RTC_TIME_VALID_INT +}RTC_INT_EN; + + + +// Alive memory is a special memory block which could restore data during system +// deep sleep. power management and wlan profile data may need put into this +// memory area. +// Should create a dram segment in link script. +#define ALIVE_MEMORY_ADDR +#define ALIVE_MEMORY_SIZE (1024 * 2) + +void rtc_hw_init(void); + +RESET_REASON rtc_get_reset_reason(int cpu_no); +void software_reset(void); +void software_reset_cpu(int cpu_no); +void rtc_select_apb_bridge(bool sel); +void rtc_set_sleep_mode(SLEEP_MODE mode, uint32_t sleep_sec, uint32_t wakeup_mode); + +uint8_t ets_rtc_recovery(void); + +#define MAX_DEEPSLEEP_DURATION (0xffffffff / RTC_CLK_FREQ) +#define SECOND_TO_RTC_TICK(second) ((second)*RTC_CLK_FREQ) //32KHz +#define CALIB_VALUE_TO_RTC_TICK(microsecond, clk_mkz, n_rtc,nclk) ((microsecond)*(clk_mkz)*(n_rtc)/(nclk)) //32KHz +#define RTC_TICK_TO_SECOND(tick) ((tick)/RTC_CLK_FREQ ) +#define GET_CURRENT_TICK() (READ_PERI_REG(RTC_TIME)) +#define SET_WAKEUP_TICK(tick) (WRITE_PERI_REG(RTC_TIMER0, tick)) + +//#define GET_WAKEUP_CAUSE() GET_PERI_REG_BITS2(RTC_STATE1, RTC_CNTL_WAKEUP_CAUSE, RTC_CNTL_WAKEUP_CAUSE_S) +#define DISABLE_RTC_INT(int_type) CLEAR_PERI_REG_MASK(RTC_INT_ENA, int_type) +#define ENABLE_RTC_INT(int_type) SET_PERI_REG_MASK(RTC_INT_ENA, int_type) +#define CLR_RTC_INT(int_type) SET_PERI_REG_MASK(RTC_INT_CLR, int_type) +#define GET_RTC_INT_CAUSE() GET_PERI_REG_BITS(RTC_INT_RAW, RTC_INT_RAW_MSB,RTC_INT_RAW_LSB) + +void rtc_register_deepsleep_timer(ETSTimer *timer, uint32_t tmout); +void rtc_disable_deepsleep_timer(void); + +void rtc_enter_sleep(void); +void ets_rtc_int_register(void); +void dtm_set_intr_mask(uint32_t mask); +uint32_t dtm_get_intr_mask(void); +void dtm_set_params(uint32_t sleep_mode, uint32_t sleep_tm_ms, uint32_t wakeup_tm_ms, uint32_t sleep_times, uint32_t rxbcn_len); +void save_rxbcn_mactime(uint32_t rxbcn_mactime); +void save_tsf_us(uint32_t tsf_us); + +typedef void (* ets_idle_cb_t)(void *arg); + +typedef uint32_t (* ETS_GET_MACTIME)(void); +typedef void (* ETS_WAKEUP_INIT)(void); + +void dtm_params_init(ETS_GET_MACTIME get_mactime, ETS_WAKEUP_INIT wakeup_init); + +void ets_set_idle_cb(ets_idle_cb_t func, void *arg); + +void ets_enter_sleep(void); + +void rtc_intr_handler(void *); + +#define ETS_SLEEP_START(pfunc, parg) ets_set_idle_cb((pfunc), (parg)); + +#define ETS_SLEEP_END() ets_set_idle_cb(NULL, NULL); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_RTC_H_ */ + diff --git a/components/esp32/include/rom/secure_boot.h b/components/esp32/include/rom/secure_boot.h new file mode 100644 index 000000000..1e39d3453 --- /dev/null +++ b/components/esp32/include/rom/secure_boot.h @@ -0,0 +1,41 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_SECURE_BOOT_H_ +#define _ROM_SECURE_BOOT_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +void ets_secure_boot_start(void); + +void ets_secure_boot_finish(void); + +void ets_secure_boot_hash(uint32_t *buf); + +void ets_secure_boot_obtain(void); + +int ets_secure_boot_check(uint32_t *buf); + +void ets_secure_boot_rd_iv(uint32_t *buf); + +void ets_secure_boot_rd_abstract(uint32_t *buf); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_SECURE_BOOT_H_ */ diff --git a/components/esp32/include/rom/sha.h b/components/esp32/include/rom/sha.h new file mode 100644 index 000000000..a5536bd3b --- /dev/null +++ b/components/esp32/include/rom/sha.h @@ -0,0 +1,50 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_SHA_H_ +#define _ROM_SHA_H_ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct SHAContext { + bool start; + uint32_t total_input_bits[4]; +} SHA_CTX; + +enum SHA_TYPE { + SHA1 = 0, + SHA2_256, + SHA2_384, + SHA2_512 +}; + +void ets_sha_init(SHA_CTX *ctx); + +void ets_sha_enable(void); + +void ets_sha_disable(void); + +void ets_sha_update(SHA_CTX *ctx, enum SHA_TYPE type, const uint8_t *input, size_t input_bits); + +void ets_sha_finish(SHA_CTX *ctx, enum SHA_TYPE type, uint8_t *output); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_SHA_H_ */ diff --git a/components/esp32/include/rom/spi_flash.h b/components/esp32/include/rom/spi_flash.h new file mode 100644 index 000000000..b61994837 --- /dev/null +++ b/components/esp32/include/rom/spi_flash.h @@ -0,0 +1,145 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_SPI_FLASH_H_ +#define _ROM_SPI_FLASH_H_ + +#include +#include + +#include "esp_attr.h" + +#include "soc/spi_register.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define PERIPHS_SPI_FLASH_CMD SPI_CMD(1) +#define PERIPHS_SPI_FLASH_ADDR SPI_ADDR(1) +#define PERIPHS_SPI_FLASH_CTRL SPI_CTRL(1) +#define PERIPHS_SPI_FLASH_CTRL1 SPI_CTRL1(1) +#define PERIPHS_SPI_FLASH_STATUS SPI_RD_STATUS(1) +#define PERIPHS_SPI_FLASH_USRREG SPI_USER(1) +#define PERIPHS_SPI_FLASH_USRREG1 SPI_USER1(1) +#define PERIPHS_SPI_FLASH_USRREG2 SPI_USER2(1) +#define PERIPHS_SPI_FLASH_C0 SPI_W0(1) +#define PERIPHS_SPI_FLASH_C1 SPI_W1(1) +#define PERIPHS_SPI_FLASH_C2 SPI_W2(1) +#define PERIPHS_SPI_FLASH_C3 SPI_W3(1) +#define PERIPHS_SPI_FLASH_C4 SPI_W4(1) +#define PERIPHS_SPI_FLASH_C5 SPI_W5(1) +#define PERIPHS_SPI_FLASH_C6 SPI_W6(1) +#define PERIPHS_SPI_FLASH_C7 SPI_W7(1) +#define PERIPHS_SPI_FLASH_TX_CRC SPI_TX_CRC(1) + +#define SPI0_R_QIO_DUMMY_CYCLELEN 3 +#define SPI0_R_QIO_ADDR_BITSLEN 31 +#define SPI0_R_FAST_DUMMY_CYCLELEN 7 +#define SPI0_R_DIO_DUMMY_CYCLELEN 3 +#define SPI0_R_FAST_ADDR_BITSLEN 23 +#define SPI0_R_SIO_ADDR_BITSLEN 23 + +#define SPI1_R_QIO_DUMMY_CYCLELEN 3 +#define SPI1_R_QIO_ADDR_BITSLEN 31 +#define SPI1_R_FAST_DUMMY_CYCLELEN 7 +#define SPI1_R_DIO_DUMMY_CYCLELEN 3 +#define SPI1_R_DIO_ADDR_BITSLEN 31 +#define SPI1_R_FAST_ADDR_BITSLEN 23 +#define SPI1_R_SIO_ADDR_BITSLEN 23 + +#define SPI_W_SIO_ADDR_BITSLEN 23 + +#define TWO_BYTE_STATUS_EN SPI_WRSR_2B + +//SPI address register +#define SPI_FLASH_BYTES_LEN 24 +#define SPI_BUFF_BYTE_WRITE_NUM 32 +#define SPI_BUFF_BYTE_READ_NUM 64 +#define SPI_BUFF_BYTE_READ_BITS 0x3f + +//SPI status register +#define SPI_FLASH_BUSY_FLAG BIT0 +#define SPI_FLASH_WRENABLE_FLAG BIT1 +#define SPI_FLASH_BP0 BIT2 +#define SPI_FLASH_BP1 BIT3 +#define SPI_FLASH_BP2 BIT4 +#define FLASH_WR_PROTECT (SPI_FLASH_BP0|SPI_FLASH_BP1|SPI_FLASH_BP2) +#define SPI_FLASH_QE BIT9 + +typedef enum { + SPI_FLASH_QIO_MODE = 0, + SPI_FLASH_QOUT_MODE, + SPI_FLASH_DIO_MODE, + SPI_FLASH_DOUT_MODE, + SPI_FLASH_FASTRD_MODE, + SPI_FLASH_SLOWRD_MODE +} SpiFlashRdMode; + +typedef enum { + SPI_FLASH_RESULT_OK, + SPI_FLASH_RESULT_ERR, + SPI_FLASH_RESULT_TIMEOUT +} SpiFlashOpResult; + +typedef struct{ + uint32_t deviceId; + uint32_t chip_size; // chip size in bytes + uint32_t block_size; + uint32_t sector_size; + uint32_t page_size; + uint32_t status_mask; +} SpiFlashChip; + +typedef struct { + uint8_t data_length; + uint8_t read_cmd0; + uint8_t read_cmd1; + uint8_t write_cmd; + uint16_t data_mask; + uint16_t data; +} SpiCommonCmd; + +void SelectSpiQIO(uint8_t wp_gpio_num, uint32_t ishspi) ROMFN_ATTR; +void SetSpiDrvs(uint8_t wp_gpio_num, uint32_t ishspi, uint8_t* drvs) ROMFN_ATTR; +void SelectSpiFunction(uint32_t ishspi) ROMFN_ATTR; +SpiFlashOpResult SPIEraseChip(void) ROMFN_ATTR; +SpiFlashOpResult SPIEraseBlock(uint32_t block_num) ROMFN_ATTR; +SpiFlashOpResult SPIEraseSector(uint32_t sector_num) ROMFN_ATTR; +SpiFlashOpResult SPIWrite(uint32_t dest_addr, const uint32_t* src, int32_t len) ROMFN_ATTR; +void SPI_Write_Encrypt_Enable() ROMFN_ATTR; +SpiFlashOpResult SPI_Prepare_Encrypt_Data(uint32_t flash_addr, uint32_t* data) ROMFN_ATTR; +void SPI_Write_Encrypt_Disable() ROMFN_ATTR; +SpiFlashOpResult SPI_Encrypt_Write(uint32_t flash_addr, uint32_t* data, uint32_t len) ROMFN_ATTR; +SpiFlashOpResult SPIRead(uint32_t src_addr, uint32_t* dest, int32_t len) ROMFN_ATTR; +SpiFlashOpResult SPIReadModeCnfig(SpiFlashRdMode mode, bool legacy) ROMFN_ATTR; +SpiFlashOpResult SPIMasterReadModeCnfig(SpiFlashRdMode mode) ROMFN_ATTR; +SpiFlashOpResult SPIClkConfig(uint8_t freqdiv, uint8_t spi) ROMFN_ATTR; +uint16_t SPI_Common_Command(SpiCommonCmd * cmd) ROMFN_ATTR; +SpiFlashOpResult SPIUnlock() ROMFN_ATTR; +SpiFlashOpResult SPIEraseArea(uint32_t start_addr, uint32_t area_len) ROMFN_ATTR; +SpiFlashOpResult SPILock() ROMFN_ATTR; +SpiFlashOpResult SPIParamCfg(uint32_t deviceId, uint32_t chip_size, uint32_t block_size, uint32_t sector_size, uint32_t page_size, uint32_t status_mask) ROMFN_ATTR; +SpiFlashOpResult SPI_user_command_read(uint32_t * status, uint8_t cmd) ROMFN_ATTR; +void spi_cache_sram_init() ROMFN_ATTR; + +//ETS_STATUS ets_unpack_flash_code(uint32_t pos, uint32_t *entry_addr, bool jump, bool sb_need_check, bool config) ROMFN_ATTR; +//ETS_STATUS ets_unpack_flash_code_legacy(uint32_t pos, uint32_t *entry_addr, bool jump, bool config) ROMFN_ATTR; + +void spi_flash_attach(uint32_t ishspi, bool legacy) ROMFN_ATTR; + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_SPI_FLASH_H_ */ diff --git a/components/esp32/include/rom/ssc.h b/components/esp32/include/rom/ssc.h new file mode 100755 index 000000000..509e0da2f --- /dev/null +++ b/components/esp32/include/rom/ssc.h @@ -0,0 +1,85 @@ +// Copyright 2011-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_SSC_H_ +#define _ROM_SSC_H_ + +#include "esp_types.h" + +#include "esp_attr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct cmd_s { + char *cmd_str; +#define CMD_T_ASYNC 0x01 +#define CMD_T_SYNC 0x02 + uint8_t flag; + uint8_t id; + void (* cmd_func)(void); + void (* cmd_callback)(void *arg); +} ssc_cmd_t; + +#define ssc_printf ets_printf +#define SSC_CMD_N 10 //since the command not added in ssc_cmd.c +#define MAX_LINE_N 40 +#define PROMPT ":>" +#define SSC_EVT_N 4 + + +#define SSC_PRIO 30 +enum { + CMD_SET_SSID = 0, + CMD_SCAN, + CMD_CONNECT, + CMD_DISCONNECT, + CMD_SET_MACADDR, + CMD_PING, + CMD_PING_COUNT, + CMD_PING_LENGTH, + CMD_SET_IP, +// CMD_RD_I2C, +// CMD_SET_NULL, it's just for solving the old rom bug +// CMD_SET_I2C, +// CMD_RD_I2CM, +// CMD_SET_I2CM, +// CMD_SET_PBUS, +// CMD_SET_TXTONE, +// CMD_SET_STOPTONE, + CMD_END, +}; + +enum { + SIG_SSC_RUNCMD, + SIG_SSC_CMDDONE, + SIG_SSC_RESTART, + SIG_SSC_UART_RX_CHAR, +}; + +void ssc_attach(void) ROMFN_ATTR; +void ssc_cmd_done(int cmd_id, STATUS status) ROMFN_ATTR; +int ssc_param_len(void) ROMFN_ATTR; +char * ssc_param_str(void) ROMFN_ATTR; +void ssc_register(ssc_cmd_t *cmdset, uint8_t cmdnum, void (* help)(void)) ROMFN_ATTR; + +extern ssc_cmd_t sscCmdSet[]; +void ssc_help(void); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_SSC_H_ */ diff --git a/components/esp32/include/rom/tbconsole.h b/components/esp32/include/rom/tbconsole.h new file mode 100644 index 000000000..891c2732a --- /dev/null +++ b/components/esp32/include/rom/tbconsole.h @@ -0,0 +1,27 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _ROM_TBCONSOLE_H_ +#define _ROM_TBCONSOLE_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +void start_tb_console(); + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_TBCONSOLE_H_ */ diff --git a/components/esp32/include/rom/tjpgd.h b/components/esp32/include/rom/tjpgd.h new file mode 100644 index 000000000..31fbc97cc --- /dev/null +++ b/components/esp32/include/rom/tjpgd.h @@ -0,0 +1,99 @@ +/*----------------------------------------------------------------------------/ +/ TJpgDec - Tiny JPEG Decompressor include file (C)ChaN, 2012 +/----------------------------------------------------------------------------*/ +#ifndef _TJPGDEC +#define _TJPGDEC +/*---------------------------------------------------------------------------*/ +/* System Configurations */ + +#define JD_SZBUF 512 /* Size of stream input buffer */ +#define JD_FORMAT 0 /* Output pixel format 0:RGB888 (3 BYTE/pix), 1:RGB565 (1 WORD/pix) */ +#define JD_USE_SCALE 1 /* Use descaling feature for output */ +#define JD_TBLCLIP 1 /* Use table for saturation (might be a bit faster but increases 1K bytes of code size) */ + +/*---------------------------------------------------------------------------*/ + +#ifdef __cplusplus +extern "C" { +#endif + +/* These types must be 16-bit, 32-bit or larger integer */ +typedef int INT; +typedef unsigned int UINT; + +/* These types must be 8-bit integer */ +typedef char CHAR; +typedef unsigned char UCHAR; +typedef unsigned char BYTE; + +/* These types must be 16-bit integer */ +typedef short SHORT; +typedef unsigned short USHORT; +typedef unsigned short WORD; +typedef unsigned short WCHAR; + +/* These types must be 32-bit integer */ +typedef long LONG; +typedef unsigned long ULONG; +typedef unsigned long DWORD; + + +/* Error code */ +typedef enum { + JDR_OK = 0, /* 0: Succeeded */ + JDR_INTR, /* 1: Interrupted by output function */ + JDR_INP, /* 2: Device error or wrong termination of input stream */ + JDR_MEM1, /* 3: Insufficient memory pool for the image */ + JDR_MEM2, /* 4: Insufficient stream input buffer */ + JDR_PAR, /* 5: Parameter error */ + JDR_FMT1, /* 6: Data format error (may be damaged data) */ + JDR_FMT2, /* 7: Right format but not supported */ + JDR_FMT3 /* 8: Not supported JPEG standard */ +} JRESULT; + + + +/* Rectangular structure */ +typedef struct { + WORD left, right, top, bottom; +} JRECT; + + + +/* Decompressor object structure */ +typedef struct JDEC JDEC; +struct JDEC { + UINT dctr; /* Number of bytes available in the input buffer */ + BYTE* dptr; /* Current data read ptr */ + BYTE* inbuf; /* Bit stream input buffer */ + BYTE dmsk; /* Current bit in the current read byte */ + BYTE scale; /* Output scaling ratio */ + BYTE msx, msy; /* MCU size in unit of block (width, height) */ + BYTE qtid[3]; /* Quantization table ID of each component */ + SHORT dcv[3]; /* Previous DC element of each component */ + WORD nrst; /* Restart inverval */ + UINT width, height; /* Size of the input image (pixel) */ + BYTE* huffbits[2][2]; /* Huffman bit distribution tables [id][dcac] */ + WORD* huffcode[2][2]; /* Huffman code word tables [id][dcac] */ + BYTE* huffdata[2][2]; /* Huffman decoded data tables [id][dcac] */ + LONG* qttbl[4]; /* Dequaitizer tables [id] */ + void* workbuf; /* Working buffer for IDCT and RGB output */ + BYTE* mcubuf; /* Working buffer for the MCU */ + void* pool; /* Pointer to available memory pool */ + UINT sz_pool; /* Size of momory pool (bytes available) */ + UINT (*infunc)(JDEC*, BYTE*, UINT);/* Pointer to jpeg stream input function */ + void* device; /* Pointer to I/O device identifiler for the session */ +}; + + + +/* TJpgDec API functions */ +JRESULT jd_prepare (JDEC*, UINT(*)(JDEC*,BYTE*,UINT), void*, UINT, void*); +JRESULT jd_decomp (JDEC*, UINT(*)(JDEC*,void*,JRECT*), BYTE); + + +#ifdef __cplusplus +} +#endif + +#endif /* _TJPGDEC */ diff --git a/components/esp32/include/rom/uart.h b/components/esp32/include/rom/uart.h new file mode 100755 index 000000000..b29569773 --- /dev/null +++ b/components/esp32/include/rom/uart.h @@ -0,0 +1,187 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_UART_H_ +#define _ROM_UART_H_ + +#include "esp_types.h" +#include "esp_attr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define RX_BUFF_SIZE 0x100 +#define TX_BUFF_SIZE 100 + +//uart int enalbe register ctrl bits +#define UART_RCV_INTEN BIT0 +#define UART_TRX_INTEN BIT1 +#define UART_LINE_STATUS_INTEN BIT2 + +//uart int identification ctrl bits +#define UART_INT_FLAG_MASK 0x0E + +//uart fifo ctrl bits +#define UART_CLR_RCV_FIFO BIT1 +#define UART_CLR_TRX_FIFO BIT2 +#define UART_RCVFIFO_TRG_LVL_BITS BIT6 + +//uart line control bits +#define UART_DIV_LATCH_ACCESS_BIT BIT7 + +//uart line status bits +#define UART_RCV_DATA_RDY_FLAG BIT0 +#define UART_RCV_OVER_FLOW_FLAG BIT1 +#define UART_RCV_PARITY_ERR_FLAG BIT2 +#define UART_RCV_FRAME_ERR_FLAG BIT3 +#define UART_BRK_INT_FLAG BIT4 +#define UART_TRX_FIFO_EMPTY_FLAG BIT5 +#define UART_TRX_ALL_EMPTY_FLAG BIT6 // include fifo and shift reg +#define UART_RCV_ERR_FLAG BIT7 + +//send and receive message frame head +#define FRAME_FLAG 0x7E + +typedef enum{ + UART_LINE_STATUS_INT_FLAG = 0x06, + UART_RCV_FIFO_INT_FLAG = 0x04, + UART_RCV_TMOUT_INT_FLAG = 0x0C, + UART_TXBUFF_EMPTY_INT_FLAG = 0x02 +} UartIntType; //consider bit0 for int_flag + +typedef enum { + RCV_ONE_BYTE = 0x0, + RCV_FOUR_BYTE = 0x1, + RCV_EIGHT_BYTE = 0x2, + RCV_FOURTEEN_BYTE = 0x3 +} UartRcvFifoTrgLvl; + +typedef enum { + FIVE_BITS = 0x0, + SIX_BITS = 0x1, + SEVEN_BITS = 0x2, + EIGHT_BITS = 0x3 +} UartBitsNum4Char; + +typedef enum { + ONE_STOP_BIT = 1, + ONE_HALF_STOP_BIT = 2, + TWO_STOP_BIT = 3 +} UartStopBitsNum; + +typedef enum { + NONE_BITS = 0, + ODD_BITS = 2, + EVEN_BITS = 3 + +} UartParityMode; + +typedef enum { + STICK_PARITY_DIS = 0, + STICK_PARITY_EN = 2 +} UartExistParity; + +typedef enum { + BIT_RATE_9600 = 9600, + BIT_RATE_19200 = 19200, + BIT_RATE_38400 = 38400, + BIT_RATE_57600 = 57600, + BIT_RATE_115200 = 115200, + BIT_RATE_230400 = 230400, + BIT_RATE_460800 = 460800, + BIT_RATE_921600 = 921600 +} UartBautRate; + +typedef enum { + NONE_CTRL, + HARDWARE_CTRL, + XON_XOFF_CTRL +} UartFlowCtrl; + +typedef enum { + EMPTY, + UNDER_WRITE, + WRITE_OVER +} RcvMsgBuffState; + +typedef struct { +// uint32_t RcvBuffSize; + uint8_t *pRcvMsgBuff; + uint8_t *pWritePos; + uint8_t *pReadPos; + uint8_t TrigLvl; //JLU: may need to pad + RcvMsgBuffState BuffState; +}RcvMsgBuff; + +typedef struct { + uint32_t TrxBuffSize; + uint8_t *pTrxBuff; +} TrxMsgBuff; + +typedef enum { + BAUD_RATE_DET, + WAIT_SYNC_FRM, + SRCH_MSG_HEAD, + RCV_MSG_BODY, + RCV_ESC_CHAR, +} RcvMsgState; + +typedef struct{ + UartBautRate baut_rate; + UartBitsNum4Char data_bits; + UartExistParity exist_parity; + UartParityMode parity; // chip size in byte + UartStopBitsNum stop_bits; + UartFlowCtrl flow_ctrl; + uint8_t buff_uart_no; //indicate which uart use tx/rx buffer + uint8_t tx_uart_no; + RcvMsgBuff rcv_buff; +// TrxMsgBuff trx_buff; + RcvMsgState rcv_state; + int received; +} UartDevice; + +void Uart_Init(uint8_t uart_no, uint32_t clock) ROMFN_ATTR; +STATUS UartTxString(uint8_t* pString) ROMFN_ATTR; +STATUS UartRxString(uint8_t* pString, uint8_t MaxStrlen) ROMFN_ATTR; + +STATUS uart_tx_one_char(uint8_t TxChar) ROMFN_ATTR;//for print +STATUS uart_tx_one_char2(uint8_t TxChar) ROMFN_ATTR;//for send message +STATUS uart_rx_one_char(uint8_t* pRxChar) ROMFN_ATTR; +char uart_rx_one_char_block(void) ROMFN_ATTR; +void uart_rx_intr_handler(void * para) ROMFN_ATTR; +STATUS uart_rx_readbuff( RcvMsgBuff* pRxBuff, uint8_t* pRxByte) ROMFN_ATTR; +STATUS UartGetCmdLn(uint8_t * pCmdLn) ROMFN_ATTR; +UartDevice * GetUartDevice() ROMFN_ATTR; + +void uartToggleInterrupt(bool en) ROMFN_ATTR; + +STATUS SendMsg(uint8_t *pData, uint16_t DataLen) ROMFN_ATTR; + +STATUS RcvMsg(uint8_t *pData, uint16_t MaxDataLen, uint8_t is_sync) ROMFN_ATTR; + +void uartAttach() ROMFN_ATTR; +void uart_div_modify(uint8_t uart_no, uint32_t DivLatchValue) ROMFN_ATTR; +int uart_baudrate_detect(uint8_t uart_no, uint8_t is_sync) ROMFN_ATTR; +void uart_buff_switch(uint8_t uart_no) ROMFN_ATTR; +void uart_tx_flush(uint8_t uart_no) ROMFN_ATTR; +void uart_tx_wait_idle(uint8_t uart_no) ROMFN_ATTR; +extern UartDevice UartDev; + +#ifdef __cplusplus +} +#endif + +#endif /* _ROM_UART_H_ */ diff --git a/components/esp32/include/rom/wdt.h b/components/esp32/include/rom/wdt.h new file mode 100644 index 000000000..04a31c329 --- /dev/null +++ b/components/esp32/include/rom/wdt.h @@ -0,0 +1,40 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ROM_WDT_H_ +#define _ROM_WDT_H_ + +#include "soc.h" +#include "ets_sys.h" + +#define WDT_RESET_VALUE 0x73 +#define WDT_RESET_LEN 7 //real time: (1<<(WDT_RESET_LEN+1))*pclk +#define WDT_CONTROL_ENABLED BIT0 +#define WDT_MODE_SET(v) (v) +#define WDT_TARGET_SET(v) (v) +#define WDT_ADDRESS 0 + +#define SEC_TO_WDT_TICK(s) (s * WDT_CLK_FREQ) //it's Pclk clock,44MHz + +typedef enum{ + NEXT_OVERFLOW_RESET = 0, + NEXT_OVERFLOW_NO_RESET = 1, + EACH_OVERFLOW_RESET = 2, +} WDT_RESP_MODE; + +#define WDT_DEFAULT_FEED_INTERVAL WDT_INTERVAL_SIX_SEC /* 6 seconds */ +#define WDT_DEFAULT_EXPIRE_INTERVAL WDT_INTERVAL_TWELVE_SEC /* 12 seconds */ + +#endif /* _ROM_WDT_H_ */ + diff --git a/components/esp32/include/soc/bb_reg.h b/components/esp32/include/soc/bb_reg.h new file mode 100755 index 000000000..0b52f66ae --- /dev/null +++ b/components/esp32/include/soc/bb_reg.h @@ -0,0 +1,102 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _SOC_BB_REG_H_ +#define _SOC_BB_REG_H_ + +#define apb_bb_offset 0x6001c000 + +#define BB_DLY apb_bb_offset + 0x00009b00 // reg 00 +#define BB_TEST apb_bb_offset + 0x00009b08 // reg 02 +#define BB_TM1 apb_bb_offset + 0x00009b0c // reg 03 +#define BB_TM_CNTL apb_bb_offset + 0x00009b14 // reg 05 +#define BB_DEL_CNTL apb_bb_offset + 0x00009b28 // reg 10 +#define BB_PARAL_CNTL apb_bb_offset + 0x00009b2c // reg 11 +#define BB_FSM1 apb_bb_offset + 0x00009b44 // reg 17 +#define BB_MXG apb_bb_offset + 0x00009b48 // reg 18 +#define BB_MNOF apb_bb_offset + 0x00009b4c // reg 19 +#define BB_SIZE apb_bb_offset + 0x00009b50 // reg 20 +#define BB_TM3a apb_bb_offset + 0x00009b54 // reg 21 +#define BB_TM4a apb_bb_offset + 0x00009b58 // reg 22 +#define BB_GAIN apb_bb_offset + 0x00009b5c // reg 23 +#define BB_CNTL apb_bb_offset + 0x00009b60 // reg 24 +#define BB_CAD apb_bb_offset + 0x00009b64 // reg 25 +#define BB_DET apb_bb_offset + 0x00009b68 // reg 26 +#define BB_DETL apb_bb_offset + 0x00009b6c // reg 27 + +#define BB_MASK_PCLL apb_bb_offset + 0x00009d08 // reg 66 +#define BB_MASK_PCLH apb_bb_offset + 0x00009d0c // reg 67 +#define BB_RX_CTRL4 apb_bb_offset + 0x00009d10 // reg 68 +#define BB_RX_CTRL apb_bb_offset + 0x00009d1c // reg 71 +#define BB_RX_CTRL2 apb_bb_offset + 0x00009d20 // reg 72 +#define BB_RX_CTRL3 apb_bb_offset + 0x00009d24 // reg 73 +#define BB_DEL4 apb_bb_offset + 0x00009d40 // reg 80 +#define BB_TM5 apb_bb_offset + 0x00009d44 // reg 81 +#define BB_TM6 apb_bb_offset + 0x00009d48 // reg 82 +#define BB_PMCTRL apb_bb_offset + 0x00009d4c // reg 83 +#define BB_PWR apb_bb_offset + 0x00009d68 // reg 90 +#define BB_BCTRL2 apb_bb_offset + 0x00009d70 // reg 92 + +#define BB_MASK_PL apb_bb_offset + 0x00009884 // reg 97 +#define BB_MASK_PCHL apb_bb_offset + 0x00009888 // reg 98 +#define BB_MASK_PCHH apb_bb_offset + 0x0000988c // reg 99 + +#define BB_MASK_CL apb_bb_offset + 0x0000989c // reg 103 +#define BB_TONE apb_bb_offset + 0x000098a0 // reg 104 +#define BB_MASK_CH apb_bb_offset + 0x000098d4 // reg 117 +#define BB_SER apb_bb_offset + 0x000098ec // reg 123 +#define BB_GN_TB apb_bb_offset + 0x00009e00 // reg 128 + +#define BB_MODE apb_bb_offset + 0x00009c00 // reg 640 +#define BB_TXCTRL apb_bb_offset + 0x00009c04 // reg 641 +#define BB_BCTRL3 apb_bb_offset + 0x00009c08 // reg 642 +#define BB_BCTRL apb_bb_offset + 0x00009c28 // reg 650 +#define BB_SMCTRL apb_bb_offset + 0x00009c48 // reg 658 +#define BB_SMCTRL2 apb_bb_offset + 0x00009c4C // reg 659 +#define BB_TXCNT apb_bb_offset + 0x00009c58 // reg 662 +#define BB_RXCTRL apb_bb_offset + 0x00009c68 // reg 666 + +#define BB_TXGAIN apb_bb_offset + 0x00009900 // reg 704 + +#define BB_RXS_CNTL apb_bb_offset + 0x00009988 // reg 738 +#define BB_MASK2_PCLL apb_bb_offset + 0x000099a8 // reg 746 +#define BB_MASK2_PCLH apb_bb_offset + 0x000099ac // reg 747 +#define BB_MASK_PH apb_bb_offset + 0x000099b0 // reg 748 +#define BB_MASK2_PCHL apb_bb_offset + 0x000099b8 // reg 750 +#define BB_MASK2_PCHH apb_bb_offset + 0x000099bc // reg 751 +// +#define BB_TX_TONE_CNTL apb_bb_offset + 0x000099f0 // reg 764 +#define BB_ADD_CNTL0 apb_bb_offset + 0x00009a28 // reg 778 +#define BB_ADD_CNTL2 apb_bb_offset + 0x00009a2c // reg 779 +#define BB_GAIN_CNTL0 apb_bb_offset + 0x00009a34 // reg 781 +#define BB_GAIN_CNTL1 apb_bb_offset + 0x00009a38 // reg 782 +#define BB_GAIN_CNTL2 apb_bb_offset + 0x00009a3c // reg 783 +#define BB_AGCMEM_CTRL apb_bb_offset + 0x00009a68 // reg 794 + +#define BB_11B_RECORD apb_bb_offset + 0x00009808 // reg 802 +#define BB_FILTER_CNTL apb_bb_offset + 0x0000980c // reg 803 +#define BB_ANALOG_CTRL1 apb_bb_offset + 0x00009838 +#define BB_ANALOG_CTRL2 apb_bb_offset + 0x0000983c //reg 815 +#define BB_ANALOG_CTRL3 apb_bb_offset + 0x00009840 //reg 816 +#define BB_RFCFG_CTRL0 apb_bb_offset + 0x00009844 //reg 817 +#define BB_RFCFG_CTRL1 apb_bb_offset + 0x00009848 //reg 818 + +#define BB_ADD_CNTL1 apb_bb_offset + 0x00009860 //reg824 +#define BB_PA_CNTL apb_bb_offset + 0x00009864 //reg825 +#define BB_RFCFG_CTRL2 apb_bb_offset + 0x0000986c //reg827 +#define BB_RXDEL_CTRL apb_bb_offset + 0x00009d18 +#define BB_RXLENGTH_CTRL apb_bb_offset + 0x00009d1c + +#endif /* _SOC_BB_REG_H_ */ + diff --git a/components/esp32/include/soc/boot_mode.h b/components/esp32/include/soc/boot_mode.h new file mode 100755 index 000000000..5106e10cf --- /dev/null +++ b/components/esp32/include/soc/boot_mode.h @@ -0,0 +1,104 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _SOC_BOOT_MODE_H_ +#define _SOC_BOOT_MODE_H_ + +#include "soc.h" + +/*SPI Boot*/ +#define IS_1XXXX(v) (((v)&0x10)==0x10) + +/*HSPI Boot*/ +#define IS_010XX(v) (((v)&0x1c)==0x08) + +/*Download Boot, SDIO/UART0/UART1*/ +#define IS_00XXX(v) (((v)&0x18)==0x00) + +/*Download Boot, SDIO/UART0/UART1,FEI_FEO V2*/ +#define IS_00X00(v) (((v)&0x1b)==0x00) + +/*Download Boot, SDIO/UART0/UART1,FEI_REO V2*/ +#define IS_00X01(v) (((v)&0x1b)==0x01) + +/*Download Boot, SDIO/UART0/UART1,REI_FEO V2*/ +#define IS_00X10(v) (((v)&0x1b)==0x02) + +/*Download Boot, SDIO/UART0/UART1,REI_FEO V2*/ +#define IS_00X11(v) (((v)&0x1b)==0x03) + +/*ATE/ANALOG Mode*/ +#define IS_01110(v) (((v)&0x1f)==0x0e) + +/*Diagnostic Mode+UART0 download Mode*/ +#define IS_01111(v) (((v)&0x1f)==0x0f) + +/*legacy SPI Boot*/ +#define IS_01100(v) (((v)&0x1f)==0x0c) + +/*SDIO_Slave download Mode V1.1*/ +#define IS_01101(v) (((v)&0x1f)==0x0d) + + + +#define BOOT_MODE_GET() (GPIO_REG_READ(GPIO_STRAP)) + +/*do not include download mode*/ +#define ETS_IS_UART_BOOT() IS_01111(BOOT_MODE_GET()) + +/*all spi boot including spi/hspi/legacy*/ +#define ETS_IS_FLASH_BOOT() (IS_1XXXX(BOOT_MODE_GET()) || IS_010XX(BOOT_MODE_GET()) || IS_01100(BOOT_MODE_GET())) + +/*all faster spi boot including spi/hspi*/ +#define ETS_IS_FAST_FLASH_BOOT() (IS_1XXXX(BOOT_MODE_GET()) || IS_010XX(BOOT_MODE_GET())) + +/*all spi boot including spi/legacy*/ +#define ETS_IS_SPI_FLASH_BOOT() (IS_1XXXX(BOOT_MODE_GET()) || IS_01100(BOOT_MODE_GET())) + +/*all spi boot including hspi/legacy*/ +#define ETS_IS_HSPI_FLASH_BOOT() IS_010XX(BOOT_MODE_GET()) + +/*all sdio V2 of failing edge input, failing edge output*/ +#define ETS_IS_SDIO_FEI_FEO_V2_BOOT() IS_00X00(BOOT_MODE_GET()) + +/*all sdio V2 of failing edge input, raising edge output*/ +#define ETS_IS_SDIO_FEI_REO_V2_BOOT() IS_00X01(BOOT_MODE_GET()) + +/*all sdio V2 of raising edge input, failing edge output*/ +#define ETS_IS_SDIO_REI_FEO_V2_BOOT() IS_00X10(BOOT_MODE_GET()) + +/*all sdio V2 of raising edge input, raising edge output*/ +#define ETS_IS_SDIO_REI_REO_V2_BOOT() IS_00X11(BOOT_MODE_GET()) + +/*all sdio V1 of raising edge input, failing edge output*/ +#define ETS_IS_SDIO_REI_FEO_V1_BOOT() IS_01101(BOOT_MODE_GET()) + +/*do not include download mode*/ +#define ETS_IS_SDIO_BOOT() IS_01101(BOOT_MODE_GET()) + +/*joint download boot*/ +#define ETS_IS_SDIO_UART_BOOT() IS_00XXX(BOOT_MODE_GET()) + +/*ATE mode*/ +#define ETS_IS_ATE_BOOT() IS_01110(BOOT_MODE_GET()) + +/*A bit to control flash boot print*/ +#define ETS_IS_PRINT_BOOT() (BOOT_MODE_GET() & 0x2) + +/*used by ETS_IS_SDIO_UART_BOOT*/ +#define SEL_NO_BOOT 0 +#define SEL_SDIO_BOOT BIT0 +#define SEL_UART_BOOT BIT1 + +#endif /* _SOC_BOOT_MODE_H_ */ diff --git a/components/esp32/include/soc/dport_reg.h b/components/esp32/include/soc/dport_reg.h new file mode 100644 index 000000000..d91c12cc8 --- /dev/null +++ b/components/esp32/include/soc/dport_reg.h @@ -0,0 +1,1766 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_DPORT_REG_H_ +#define _SOC_DPORT_REG_H_ + +#include "soc.h" + +#define PRO_BOOT_REMAP_CTRL_REG (DR_REG_DPORT_BASE + 0x000) +#define DPORT_PRO_BOOT_REMAP (BIT(0)) +#define DPORT_PRO_BOOT_REMAP_S 0 + +#define APP_BOOT_REMAP_CTRL_REG (DR_REG_DPORT_BASE + 0x004) +#define DPORT_APP_BOOT_REMAP (BIT(0)) +#define DPORT_APP_BOOT_REMAP_S 0 + +#define DPORT_ACCESS_CHECK (DR_REG_DPORT_BASE + 0x008) +#define DPORT_DPORT_ACCESS_CHECK_APP (BIT(8)) +#define DPORT_DPORT_ACCESS_CHECK_APP_S 8 +#define DPORT_DPORT_ACCESS_CHECK_PRO (BIT(0)) +#define DPORT_DPORT_ACCESS_CHECK_PRO_S 0 + +#define PRO_DPORT_APB_MASK0 (DR_REG_DPORT_BASE + 0x00C) +#define DPORT_PRODPORT_APB_MASK0 0xFFFFFFFF +#define DPORT_PRODPORT_APB_MASK0_S 0 + +#define PRO_DPORT_APB_MASK1 (DR_REG_DPORT_BASE + 0x010) +#define DPORT_PRODPORT_APB_MASK1 0xFFFFFFFF +#define DPORT_PRODPORT_APB_MASK1_S 0 + +#define APP_DPORT_APB_MASK0 (DR_REG_DPORT_BASE + 0x014) +#define DPORT_APPDPORT_APB_MASK0 0xFFFFFFFF +#define DPORT_APPDPORT_APB_MASK0_S 0 + +#define APP_DPORT_APB_MASK1 (DR_REG_DPORT_BASE + 0x018) +#define DPORT_APPDPORT_APB_MASK1 0xFFFFFFFF +#define DPORT_APPDPORT_APB_MASK1_S 0 + +#define PERI_CLK_EN (DR_REG_DPORT_BASE + 0x01C) +#define DPORT_PERI_CLK_EN 0xFFFFFFFF +#define DPORT_PERI_CLK_EN_S 0 + +#define PERI_RST_EN (DR_REG_DPORT_BASE + 0x020) +#define DPORT_PERI_RST_EN 0xFFFFFFFF +#define DPORT_PERI_RST_EN_S 0 + +#define WIFI_BB_CFG (DR_REG_DPORT_BASE + 0x024) +#define DPORT_WIFI_BB_CFG 0xFFFFFFFF +#define DPORT_WIFI_BB_CFG_S 0 + +#define WIFI_BB_CFG_2 (DR_REG_DPORT_BASE + 0x028) +#define DPORT_WIFI_BB_CFG_2 0xFFFFFFFF +#define DPORT_WIFI_BB_CFG_2_S 0 + +#define APPCPU_CTRL_REG_A (DR_REG_DPORT_BASE + 0x02C) +#define DPORT_APPCPU_RESETTING (BIT(0)) +#define DPORT_APPCPU_RESETTING_S 0 + +#define APPCPU_CTRL_REG_B (DR_REG_DPORT_BASE + 0x030) +#define DPORT_APPCPU_CLKGATE_EN (BIT(0)) +#define DPORT_APPCPU_CLKGATE_EN_S 0 + +#define APPCPU_CTRL_REG_C (DR_REG_DPORT_BASE + 0x034) +#define DPORT_APPCPU_RUNSTALL (BIT(0)) +#define DPORT_APPCPU_RUNSTALL_S 0 + +#define APPCPU_CTRL_REG_D (DR_REG_DPORT_BASE + 0x038) +#define DPORT_APPCPU_BOOT_ADDR 0xFFFFFFFF +#define DPORT_APPCPU_BOOT_ADDR_S 0 + +#define CPU_PER_CONF_REG (DR_REG_DPORT_BASE + 0x03C) +#define DPORT_FAST_CLK_RTC_SEL (BIT(3)) +#define DPORT_FAST_CLK_RTC_SEL_S 3 +#define DPORT_LOWSPEED_CLK_SEL (BIT(2)) +#define DPORT_LOWSPEED_CLK_SEL_S 2 +#define DPORT_CPUPERIOD_SEL 0x00000003 +#define DPORT_CPUPERIOD_SEL_S 0 + +#define PRO_CACHE_CTRL_REG (DR_REG_DPORT_BASE + 0x040) +#define DPORT_PRO_DRAM_HL (BIT(16)) +#define DPORT_PRO_DRAM_HL_S 16 +#define DPORT_SLAVE_REQ (BIT(15)) +#define DPORT_SLAVE_REQ_S 15 +#define DPORT_AHB_SPI_REQ (BIT(14)) +#define DPORT_AHB_SPI_REQ_S 14 +#define DPORT_PRO_SLAVE_REQ (BIT(13)) +#define DPORT_PRO_SLAVE_REQ_S 13 +#define DPORT_PRO_AHB_SPI_REQ (BIT(12)) +#define DPORT_PRO_AHB_SPI_REQ_S 12 +#define DPORT_PRO_DRAM_SPLIT (BIT(11)) +#define DPORT_PRO_DRAM_SPLIT_S 11 +#define DPORT_PRO_SINGLE_IRAM_ENA (BIT(10)) +#define DPORT_PRO_SINGLE_IRAM_ENA_S 10 +#define DPORT_PRO_CACHE_LOCK_3_EN (BIT(9)) +#define DPORT_PRO_CACHE_LOCK_3_EN_S 9 +#define DPORT_PRO_CACHE_LOCK_2_EN (BIT(8)) +#define DPORT_PRO_CACHE_LOCK_2_EN_S 8 +#define DPORT_PRO_CACHE_LOCK_1_EN (BIT(7)) +#define DPORT_PRO_CACHE_LOCK_1_EN_S 7 +#define DPORT_PRO_CACHE_LOCK_0_EN (BIT(6)) +#define DPORT_PRO_CACHE_LOCK_0_EN_S 6 +#define DPORT_PRO_CACHE_FLUSH_DONE (BIT(5)) +#define DPORT_PRO_CACHE_FLUSH_DONE_S 5 +#define DPORT_PRO_CACHE_FLUSH_ENA (BIT(4)) +#define DPORT_PRO_CACHE_FLUSH_ENA_S 4 +#define DPORT_PRO_CACHE_ENABLE (BIT(3)) +#define DPORT_PRO_CACHE_ENABLE_S 3 +#define DPORT_PRO_CACHE_MODE (BIT(2)) +#define DPORT_PRO_CACHE_MODE_S 2 + +#define PRO_CACHE_CTRL1_REG (DR_REG_DPORT_BASE + 0x044) +#define DPORT_PRO_CACHE_MMU_IA_CLR (BIT(13)) +#define DPORT_PRO_CACHE_MMU_IA_CLR_S 13 +#define DPORT_PRO_CMMU_PD (BIT(12)) +#define DPORT_PRO_CMMU_PD_S 12 +#define DPORT_PRO_CMMU_FORCE_ON (BIT(11)) +#define DPORT_PRO_CMMU_FORCE_ON_S 11 +#define DPORT_PRO_CMMU_FLASH_PAGE_MODE 0x00000003 +#define DPORT_PRO_CMMU_FLASH_PAGE_MODE_S 9 +#define DPORT_PRO_CMMU_SRAM_PAGE_MODE 0x00000007 +#define DPORT_PRO_CMMU_SRAM_PAGE_MODE_S 6 +#define DPORT_PRO_CACHE_MASK_OPSDRAM (BIT(5)) +#define DPORT_PRO_CACHE_MASK_OPSDRAM_S 5 +#define DPORT_PRO_CACHE_MASK_DROM0 (BIT(4)) +#define DPORT_PRO_CACHE_MASK_DROM0_S 4 +#define DPORT_PRO_CACHE_MASK_DRAM1 (BIT(3)) +#define DPORT_PRO_CACHE_MASK_DRAM1_S 3 +#define DPORT_PRO_CACHE_MASK_IROM0 (BIT(2)) +#define DPORT_PRO_CACHE_MASK_IROM0_S 2 +#define DPORT_PRO_CACHE_MASK_IRAM1 (BIT(1)) +#define DPORT_PRO_CACHE_MASK_IRAM1_S 1 +#define DPORT_PRO_CACHE_MASK_IRAM0 (BIT(0)) +#define DPORT_PRO_CACHE_MASK_IRAM0_S 0 + +#define PRO_CACHE_LOCK_0_ADDR_REG (DR_REG_DPORT_BASE + 0x048) +#define DPORT_PRO_CACHE_LOCK_0_ADDR_MAX 0x0000000F +#define DPORT_PRO_CACHE_LOCK_0_ADDR_MAX_S 18 +#define DPORT_PRO_CACHE_LOCK_0_ADDR_MIN 0x0000000F +#define DPORT_PRO_CACHE_LOCK_0_ADDR_MIN_S 14 +#define DPORT_PRO_CACHE_LOCK_0_ADDR_PRE 0x00003FFF +#define DPORT_PRO_CACHE_LOCK_0_ADDR_PRE_S 0 + +#define PRO_CACHE_LOCK_1_ADDR_REG (DR_REG_DPORT_BASE + 0x04C) +#define DPORT_PRO_CACHE_LOCK_1_ADDR_MAX 0x0000000F +#define DPORT_PRO_CACHE_LOCK_1_ADDR_MAX_S 18 +#define DPORT_PRO_CACHE_LOCK_1_ADDR_MIN 0x0000000F +#define DPORT_PRO_CACHE_LOCK_1_ADDR_MIN_S 14 +#define DPORT_PRO_CACHE_LOCK_1_ADDR_PRE 0x00003FFF +#define DPORT_PRO_CACHE_LOCK_1_ADDR_PRE_S 0 + +#define PRO_CACHE_LOCK_2_ADDR_REG (DR_REG_DPORT_BASE + 0x050) +#define DPORT_PRO_CACHE_LOCK_2_ADDR_MAX 0x0000000F +#define DPORT_PRO_CACHE_LOCK_2_ADDR_MAX_S 18 +#define DPORT_PRO_CACHE_LOCK_2_ADDR_MIN 0x0000000F +#define DPORT_PRO_CACHE_LOCK_2_ADDR_MIN_S 14 +#define DPORT_PRO_CACHE_LOCK_2_ADDR_PRE 0x00003FFF +#define DPORT_PRO_CACHE_LOCK_2_ADDR_PRE_S 0 + +#define PRO_CACHE_LOCK_3_ADDR_REG (DR_REG_DPORT_BASE + 0x054) +#define DPORT_PRO_CACHE_LOCK_3_ADDR_MAX 0x0000000F +#define DPORT_PRO_CACHE_LOCK_3_ADDR_MAX_S 18 +#define DPORT_PRO_CACHE_LOCK_3_ADDR_MIN 0x0000000F +#define DPORT_PRO_CACHE_LOCK_3_ADDR_MIN_S 14 +#define DPORT_PRO_CACHE_LOCK_3_ADDR_PRE 0x00003FFF +#define DPORT_PRO_CACHE_LOCK_3_ADDR_PRE_S 0 + +#define APP_CACHE_CTRL_REG (DR_REG_DPORT_BASE + 0x058) +#define DPORT_APP_DRAM_HL (BIT(14)) +#define DPORT_APP_DRAM_HL_S 14 +#define DPORT_APP_SLAVE_REQ (BIT(13)) +#define DPORT_APP_SLAVE_REQ_S 13 +#define DPORT_APP_AHB_SPI_REQ (BIT(12)) +#define DPORT_APP_AHB_SPI_REQ_S 12 +#define DPORT_APP_DRAM_SPLIT (BIT(11)) +#define DPORT_APP_DRAM_SPLIT_S 11 +#define DPORT_APP_SINGLE_IRAM_ENA (BIT(10)) +#define DPORT_APP_SINGLE_IRAM_ENA_S 10 +#define DPORT_APP_CACHE_LOCK_3_EN (BIT(9)) +#define DPORT_APP_CACHE_LOCK_3_EN_S 9 +#define DPORT_APP_CACHE_LOCK_2_EN (BIT(8)) +#define DPORT_APP_CACHE_LOCK_2_EN_S 8 +#define DPORT_APP_CACHE_LOCK_1_EN (BIT(7)) +#define DPORT_APP_CACHE_LOCK_1_EN_S 7 +#define DPORT_APP_CACHE_LOCK_0_EN (BIT(6)) +#define DPORT_APP_CACHE_LOCK_0_EN_S 6 +#define DPORT_APP_CACHE_FLUSH_DONE (BIT(5)) +#define DPORT_APP_CACHE_FLUSH_DONE_S 5 +#define DPORT_APP_CACHE_FLUSH_ENA (BIT(4)) +#define DPORT_APP_CACHE_FLUSH_ENA_S 4 +#define DPORT_APP_CACHE_ENABLE (BIT(3)) +#define DPORT_APP_CACHE_ENABLE_S 3 +#define DPORT_APP_CACHE_MODE (BIT(2)) +#define DPORT_APP_CACHE_MODE_S 2 + +#define APP_CACHE_CTRL1_REG (DR_REG_DPORT_BASE + 0x05C) +#define DPORT_APP_CACHE_MMU_IA_CLR (BIT(13)) +#define DPORT_APP_CACHE_MMU_IA_CLR_S 13 +#define DPORT_APP_CMMU_PD (BIT(12)) +#define DPORT_APP_CMMU_PD_S 12 +#define DPORT_APP_CMMU_FORCE_ON (BIT(11)) +#define DPORT_APP_CMMU_FORCE_ON_S 11 +#define DPORT_APP_CMMU_FLASH_PAGE_MODE 0x00000003 +#define DPORT_APP_CMMU_FLASH_PAGE_MODE_S 9 +#define DPORT_APP_CMMU_SRAM_PAGE_MODE 0x00000007 +#define DPORT_APP_CMMU_SRAM_PAGE_MODE_S 6 +#define DPORT_APP_CACHE_MASK_OPSDRAM (BIT(5)) +#define DPORT_APP_CACHE_MASK_OPSDRAM_S 5 +#define DPORT_APP_CACHE_MASK_DROM0 (BIT(4)) +#define DPORT_APP_CACHE_MASK_DROM0_S 4 +#define DPORT_APP_CACHE_MASK_DRAM1 (BIT(3)) +#define DPORT_APP_CACHE_MASK_DRAM1_S 3 +#define DPORT_APP_CACHE_MASK_IROM0 (BIT(2)) +#define DPORT_APP_CACHE_MASK_IROM0_S 2 +#define DPORT_APP_CACHE_MASK_IRAM1 (BIT(1)) +#define DPORT_APP_CACHE_MASK_IRAM1_S 1 +#define DPORT_APP_CACHE_MASK_IRAM0 (BIT(0)) +#define DPORT_APP_CACHE_MASK_IRAM0_S 0 + +#define APP_CACHE_LOCK_0_ADDR_REG (DR_REG_DPORT_BASE + 0x060) +#define DPORT_APP_CACHE_LOCK_0_ADDR_MAX 0x0000000F +#define DPORT_APP_CACHE_LOCK_0_ADDR_MAX_S 18 +#define DPORT_APP_CACHE_LOCK_0_ADDR_MIN 0x0000000F +#define DPORT_APP_CACHE_LOCK_0_ADDR_MIN_S 14 +#define DPORT_APP_CACHE_LOCK_0_ADDR_PRE 0x00003FFF +#define DPORT_APP_CACHE_LOCK_0_ADDR_PRE_S 0 + +#define APP_CACHE_LOCK_1_ADDR_REG (DR_REG_DPORT_BASE + 0x064) +#define DPORT_APP_CACHE_LOCK_1_ADDR_MAX 0x0000000F +#define DPORT_APP_CACHE_LOCK_1_ADDR_MAX_S 18 +#define DPORT_APP_CACHE_LOCK_1_ADDR_MIN 0x0000000F +#define DPORT_APP_CACHE_LOCK_1_ADDR_MIN_S 14 +#define DPORT_APP_CACHE_LOCK_1_ADDR_PRE 0x00003FFF +#define DPORT_APP_CACHE_LOCK_1_ADDR_PRE_S 0 + +#define APP_CACHE_LOCK_2_ADDR_REG (DR_REG_DPORT_BASE + 0x068) +#define DPORT_APP_CACHE_LOCK_2_ADDR_MAX 0x0000000F +#define DPORT_APP_CACHE_LOCK_2_ADDR_MAX_S 18 +#define DPORT_APP_CACHE_LOCK_2_ADDR_MIN 0x0000000F +#define DPORT_APP_CACHE_LOCK_2_ADDR_MIN_S 14 +#define DPORT_APP_CACHE_LOCK_2_ADDR_PRE 0x00003FFF +#define DPORT_APP_CACHE_LOCK_2_ADDR_PRE_S 0 + +#define APP_CACHE_LOCK_3_ADDR_REG (DR_REG_DPORT_BASE + 0x06C) +#define DPORT_APP_CACHE_LOCK_3_ADDR_MAX 0x0000000F +#define DPORT_APP_CACHE_LOCK_3_ADDR_MAX_S 18 +#define DPORT_APP_CACHE_LOCK_3_ADDR_MIN 0x0000000F +#define DPORT_APP_CACHE_LOCK_3_ADDR_MIN_S 14 +#define DPORT_APP_CACHE_LOCK_3_ADDR_PRE 0x00003FFF +#define DPORT_APP_CACHE_LOCK_3_ADDR_PRE_S 0 + +#define TRACEMEM_MUX_MODE (DR_REG_DPORT_BASE + 0x070) +#define DPORT_TRACEMEM_MUX_MODE 0x00000003 +#define DPORT_TRACEMEM_MUX_MODE_S 0 + +#define PRO_TRACEMEM_ENA (DR_REG_DPORT_BASE + 0x074) +#define DPORT_PRO_TRACEMEM_ENA (BIT(0)) +#define DPORT_PRO_TRACEMEM_ENA_S 0 + +#define APP_TRACEMEM_ENA (DR_REG_DPORT_BASE + 0x078) +#define DPORT_APP_TRACEMEM_ENA (BIT(0)) +#define DPORT_APP_TRACEMEM_ENA_S 0 + +#define CACHE_MUX_MODE (DR_REG_DPORT_BASE + 0x07C) +#define DPORT_CACHE_MUX_MODE 0x00000003 +#define DPORT_CACHE_MUX_MODE_S 0 + +#define IMMU_PAGE_MODE (DR_REG_DPORT_BASE + 0x080) +#define DPORT_IMMU_PAGE_MODE 0x00000003 +#define DPORT_IMMU_PAGE_MODE_S 1 +#define DPORT_INTERNAL_SRAM_IMMU_ENA (BIT(0)) +#define DPORT_INTERNAL_SRAM_IMMU_ENA_S 0 + +#define DMMU_PAGE_MODE (DR_REG_DPORT_BASE + 0x084) +#define DPORT_DMMU_PAGE_MODE 0x00000003 +#define DPORT_DMMU_PAGE_MODE_S 1 +#define DPORT_INTERNAL_SRAM_DMMU_ENA (BIT(0)) +#define DPORT_INTERNAL_SRAM_DMMU_ENA_S 0 + +#define ROM_MPU_ENA (DR_REG_DPORT_BASE + 0x088) +#define DPORT_APP_ROM_MPU_ENA (BIT(2)) +#define DPORT_APP_ROM_MPU_ENA_S 2 +#define DPORT_PRO_ROM_MPU_ENA (BIT(1)) +#define DPORT_PRO_ROM_MPU_ENA_S 1 +#define DPORT_SHARE_ROM_MPU_ENA (BIT(0)) +#define DPORT_SHARE_ROM_MPU_ENA_S 0 + +#define MEM_PD_MASK_REG (DR_REG_DPORT_BASE + 0x08C) +#define DPORT_LSLP_MEM_PD_MASK (BIT(0)) +#define DPORT_LSLP_MEM_PD_MASK_S 0 + +#define ROM_PD_CTRL_REG (DR_REG_DPORT_BASE + 0x090) +#define DPORT_SHARE_ROM_PD 0x0000003F +#define DPORT_SHARE_ROM_PD_S 2 +#define DPORT_APP_ROM_PD (BIT(1)) +#define DPORT_APP_ROM_PD_S 1 +#define DPORT_PRO_ROM_PD (BIT(0)) +#define DPORT_PRO_ROM_PD_S 0 + +#define ROM_FO_CTRL_REG (DR_REG_DPORT_BASE + 0x094) +#define DPORT_SHARE_ROM_FO 0x0000003F +#define DPORT_SHARE_ROM_FO_S 2 +#define DPORT_APP_ROM_FO (BIT(1)) +#define DPORT_APP_ROM_FO_S 1 +#define DPORT_PRO_ROM_FO (BIT(0)) +#define DPORT_PRO_ROM_FO_S 0 + +#define SRAM_PD_CTRL_REG_0 (DR_REG_DPORT_BASE + 0x098) +#define DPORT_SRAM_PD_0 0xFFFFFFFF +#define DPORT_SRAM_PD_0_S 0 + +#define SRAM_PD_CTRL_REG_1 (DR_REG_DPORT_BASE + 0x09C) +#define DPORT_SRAM_PD_1 (BIT(0)) +#define DPORT_SRAM_PD_1_S 0 + +#define SRAM_FO_CTRL_REG_0 (DR_REG_DPORT_BASE + 0x0A0) +#define DPORT_SRAM_FO_0 0xFFFFFFFF +#define DPORT_SRAM_FO_0_S 0 + +#define SRAM_FO_CTRL_REG_1 (DR_REG_DPORT_BASE + 0x0A4) +#define DPORT_SRAM_FO_1 (BIT(0)) +#define DPORT_SRAM_FO_1_S 0 + +#define IRAM_DRAM_AHB_SEL (DR_REG_DPORT_BASE + 0x0A8) +#define DPORT_MAC_DUMP_MODE 0x00000003 +#define DPORT_MAC_DUMP_MODE_S 5 +#define DPORT_MASK_AHB (BIT(4)) +#define DPORT_MASK_AHB_S 4 +#define DPORT_MASK_APP_DRAM (BIT(3)) +#define DPORT_MASK_APP_DRAM_S 3 +#define DPORT_MASK_PRO_DRAM (BIT(2)) +#define DPORT_MASK_PRO_DRAM_S 2 +#define DPORT_MASK_APP_IRAM (BIT(1)) +#define DPORT_MASK_APP_IRAM_S 1 +#define DPORT_MASK_PRO_IRAM (BIT(0)) +#define DPORT_MASK_PRO_IRAM_S 0 + +#define TAG_FO_CTRL_REG (DR_REG_DPORT_BASE + 0x0AC) +#define DPORT_APP_CACHE_TAG_PD (BIT(9)) +#define DPORT_APP_CACHE_TAG_PD_S 9 +#define DPORT_APP_CACHE_TAG_FORCE_ON (BIT(8)) +#define DPORT_APP_CACHE_TAG_FORCE_ON_S 8 +#define DPORT_PRO_CACHE_TAG_PD (BIT(1)) +#define DPORT_PRO_CACHE_TAG_PD_S 1 +#define DPORT_PRO_CACHE_TAG_FORCE_ON (BIT(0)) +#define DPORT_PRO_CACHE_TAG_FORCE_ON_S 0 + +#define AHB_LITE_MASK_REG (DR_REG_DPORT_BASE + 0x0B0) +#define DPORT_AHB_LITE_SDHOST_PID_REG 0x00000007 +#define DPORT_AHB_LITE_SDHOST_PID_REG_S 11 +#define DPORT_AHB_LITE_MASK_APPDPORT (BIT(10)) +#define DPORT_AHB_LITE_MASK_APPDPORT_S 10 +#define DPORT_AHB_LITE_MASK_PRODPORT (BIT(9)) +#define DPORT_AHB_LITE_MASK_PRODPORT_S 9 +#define DPORT_AHB_LITE_MASK_SDIO (BIT(8)) +#define DPORT_AHB_LITE_MASK_SDIO_S 8 +#define DPORT_AHB_LITE_MASK_APP (BIT(4)) +#define DPORT_AHB_LITE_MASK_APP_S 4 +#define DPORT_AHB_LITE_MASK_PRO (BIT(0)) +#define DPORT_AHB_LITE_MASK_PRO_S 0 + +#define AHB_MPU_TABLE_0 (DR_REG_DPORT_BASE + 0x0B4) +#define DPORT_AHB_ACCESS_GRANT_0 0xFFFFFFFF +#define DPORT_AHB_ACCESS_GRANT_0_S 0 + +#define AHB_MPU_TABLE_1 (DR_REG_DPORT_BASE + 0x0B8) +#define DPORT_AHB_ACCESS_GRANT_1 0x000001FF +#define DPORT_AHB_ACCESS_GRANT_1_S 0 + +#define HOST_INF_SEL (DR_REG_DPORT_BASE + 0x0BC) +#define DPORT_LINK_DEVICE_SEL 0x000000FF +#define DPORT_LINK_DEVICE_SEL_S 8 +#define DPORT_PERI_IO_SWAP 0x000000FF +#define DPORT_PERI_IO_SWAP_S 0 + +#define PERIP_CLK_EN (DR_REG_DPORT_BASE + 0x0C0) +#define DPORT_PERIP_CLK_EN 0xFFFFFFFF +#define DPORT_PERIP_CLK_EN_S 0 + +#define PERIP_RST_EN (DR_REG_DPORT_BASE + 0x0C4) +#define DPORT_PERIP_RST 0xFFFFFFFF +#define DPORT_PERIP_RST_S 0 + +#define SLAVE_SPI_CONFIG_REG (DR_REG_DPORT_BASE + 0x0C8) +#define DPORT_SPI_DECRYPT_ENABLE (BIT(12)) +#define DPORT_SPI_DECRYPT_ENABLE_S 12 +#define DPORT_SPI_ENCRYPT_ENABLE (BIT(8)) +#define DPORT_SPI_ENCRYPT_ENABLE_S 8 +#define DPORT_SLAVE_SPI_MASK_APP (BIT(4)) +#define DPORT_SLAVE_SPI_MASK_APP_S 4 +#define DPORT_SLAVE_SPI_MASK_PRO (BIT(0)) +#define DPORT_SLAVE_SPI_MASK_PRO_S 0 + +#define WIFI_CLK_EN (DR_REG_DPORT_BASE + 0x0CC) +#define DPORT_WIFI_CLK_EN 0xFFFFFFFF +#define DPORT_WIFI_CLK_EN_S 0 + +#define WIFI_RST_EN (DR_REG_DPORT_BASE + 0x0D0) +#define DPORT_SDIO_RST (BIT(5)) +#define DPORT_MAC_RST (BIT(2)) +#define DPORT_WIFI_RST 0xFFFFFFFF +#define DPORT_WIFI_RST_S 0 + +#define BT_LPCK_DIV_INT (DR_REG_DPORT_BASE + 0x0D4) +#define DPORT_BTEXTWAKEUP_REQ (BIT(12)) +#define DPORT_BTEXTWAKEUP_REQ_S 12 +#define DPORT_BT_LPCK_DIV_NUM 0x00000FFF +#define DPORT_BT_LPCK_DIV_NUM_S 0 + +#define BT_LPCK_DIV_FRAC (DR_REG_DPORT_BASE + 0x0D8) +#define DPORT_LPCLK_SEL_XTAL32K (BIT(27)) +#define DPORT_LPCLK_SEL_XTAL32K_S 27 +#define DPORT_LPCLK_SEL_XTAL (BIT(26)) +#define DPORT_LPCLK_SEL_XTAL_S 26 +#define DPORT_LPCLK_SEL_8M (BIT(25)) +#define DPORT_LPCLK_SEL_8M_S 25 +#define DPORT_LPCLK_SEL_RTC_SLOW (BIT(24)) +#define DPORT_LPCLK_SEL_RTC_SLOW_S 24 +#define DPORT_BT_LPCK_DIV_A 0x00000FFF +#define DPORT_BT_LPCK_DIV_A_S 12 +#define DPORT_BT_LPCK_DIV_B 0x00000FFF +#define DPORT_BT_LPCK_DIV_B_S 0 + +#define CPU_INTR_FROM_CPU_0_REG (DR_REG_DPORT_BASE + 0x0DC) +#define DPORT_CPU_INTR_FROM_CPU_0 (BIT(0)) +#define DPORT_CPU_INTR_FROM_CPU_0_S 0 + +#define CPU_INTR_FROM_CPU_1_REG (DR_REG_DPORT_BASE + 0x0E0) +#define DPORT_CPU_INTR_FROM_CPU_1 (BIT(0)) +#define DPORT_CPU_INTR_FROM_CPU_1_S 0 + +#define CPU_INTR_FROM_CPU_2_REG (DR_REG_DPORT_BASE + 0x0E4) +#define DPORT_CPU_INTR_FROM_CPU_2 (BIT(0)) +#define DPORT_CPU_INTR_FROM_CPU_2_S 0 + +#define CPU_INTR_FROM_CPU_3_REG (DR_REG_DPORT_BASE + 0x0E8) +#define DPORT_CPU_INTR_FROM_CPU_3 (BIT(0)) +#define DPORT_CPU_INTR_FROM_CPU_3_S 0 + +#define PRO_INTR_STATUS_REG_0 (DR_REG_DPORT_BASE + 0x0EC) +#define DPORT_PRO_INTR_STATUS_0 0xFFFFFFFF +#define DPORT_PRO_INTR_STATUS_0_S 0 + +#define PRO_INTR_STATUS_REG_1 (DR_REG_DPORT_BASE + 0x0F0) +#define DPORT_PRO_INTR_STATUS_1 0xFFFFFFFF +#define DPORT_PRO_INTR_STATUS_1_S 0 + +#define PRO_INTR_STATUS_REG_2 (DR_REG_DPORT_BASE + 0x0F4) +#define DPORT_PRO_INTR_STATUS_2 0xFFFFFFFF +#define DPORT_PRO_INTR_STATUS_2_S 0 + +#define APP_INTR_STATUS_REG_0 (DR_REG_DPORT_BASE + 0x0F8) +#define DPORT_APP_INTR_STATUS_0 0xFFFFFFFF +#define DPORT_APP_INTR_STATUS_0_S 0 + +#define APP_INTR_STATUS_REG_1 (DR_REG_DPORT_BASE + 0x0FC) +#define DPORT_APP_INTR_STATUS_1 0xFFFFFFFF +#define DPORT_APP_INTR_STATUS_1_S 0 + +#define APP_INTR_STATUS_REG_2 (DR_REG_DPORT_BASE + 0x100) +#define DPORT_APP_INTR_STATUS_2 0xFFFFFFFF +#define DPORT_APP_INTR_STATUS_2_S 0 + +#define PRO_MAC_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x104) +#define DPORT_PRO_MAC_INTR_MAP 0x0000001F +#define DPORT_PRO_MAC_INTR_MAP_S 0 + +#define PRO_MAC_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x108) +#define DPORT_PRO_MAC_NMI_MAP 0x0000001F +#define DPORT_PRO_MAC_NMI_MAP_S 0 + +#define PRO_BB_INT_MAP_REG (DR_REG_DPORT_BASE + 0x10C) +#define DPORT_PRO_BB_INT_MAP 0x0000001F +#define DPORT_PRO_BB_INT_MAP_S 0 + +#define PRO_BT_MAC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x110) +#define DPORT_PRO_BT_MAC_INT_MAP 0x0000001F +#define DPORT_PRO_BT_MAC_INT_MAP_S 0 + +#define PRO_BT_BB_INT_MAP_REG (DR_REG_DPORT_BASE + 0x114) +#define DPORT_PRO_BT_BB_INT_MAP 0x0000001F +#define DPORT_PRO_BT_BB_INT_MAP_S 0 + +#define PRO_BT_BB_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x118) +#define DPORT_PRO_BT_BB_NMI_MAP 0x0000001F +#define DPORT_PRO_BT_BB_NMI_MAP_S 0 + +#define PRO_RWBT_IRQ_MAP_REG (DR_REG_DPORT_BASE + 0x11C) +#define DPORT_PRO_RWBT_IRQ_MAP 0x0000001F +#define DPORT_PRO_RWBT_IRQ_MAP_S 0 + +#define PRO_RWBLE_IRQ_MAP_REG (DR_REG_DPORT_BASE + 0x120) +#define DPORT_PRO_RWBLE_IRQ_MAP 0x0000001F +#define DPORT_PRO_RWBLE_IRQ_MAP_S 0 + +#define PRO_RWBT_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x124) +#define DPORT_PRO_RWBT_NMI_MAP 0x0000001F +#define DPORT_PRO_RWBT_NMI_MAP_S 0 + +#define PRO_RWBLE_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x128) +#define DPORT_PRO_RWBLE_NMI_MAP 0x0000001F +#define DPORT_PRO_RWBLE_NMI_MAP_S 0 + +#define PRO_SLC0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x12C) +#define DPORT_PRO_SLC0_INTR_MAP 0x0000001F +#define DPORT_PRO_SLC0_INTR_MAP_S 0 + +#define PRO_SLC1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x130) +#define DPORT_PRO_SLC1_INTR_MAP 0x0000001F +#define DPORT_PRO_SLC1_INTR_MAP_S 0 + +#define PRO_UHCI0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x134) +#define DPORT_PRO_UHCI0_INTR_MAP 0x0000001F +#define DPORT_PRO_UHCI0_INTR_MAP_S 0 + +#define PRO_UHCI1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x138) +#define DPORT_PRO_UHCI1_INTR_MAP 0x0000001F +#define DPORT_PRO_UHCI1_INTR_MAP_S 0 + +#define PRO_TG_T0_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x13C) +#define DPORT_PRO_TG_T0_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG_T0_LEVEL_INT_MAP_S 0 + +#define PRO_TG_T1_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x140) +#define DPORT_PRO_TG_T1_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG_T1_LEVEL_INT_MAP_S 0 + +#define PRO_TG_WDT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x144) +#define DPORT_PRO_TG_WDT_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG_WDT_LEVEL_INT_MAP_S 0 + +#define PRO_TG_LACT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x148) +#define DPORT_PRO_TG_LACT_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG_LACT_LEVEL_INT_MAP_S 0 + +#define PRO_TG1_T0_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x14C) +#define DPORT_PRO_TG1_T0_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_T0_LEVEL_INT_MAP_S 0 + +#define PRO_TG1_T1_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x150) +#define DPORT_PRO_TG1_T1_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_T1_LEVEL_INT_MAP_S 0 + +#define PRO_TG1_WDT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x154) +#define DPORT_PRO_TG1_WDT_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_WDT_LEVEL_INT_MAP_S 0 + +#define PRO_TG1_LACT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x158) +#define DPORT_PRO_TG1_LACT_LEVEL_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_LACT_LEVEL_INT_MAP_S 0 + +#define PRO_GPIO_INTERRUPT_MAP_REG (DR_REG_DPORT_BASE + 0x15C) +#define DPORT_PRO_GPIO_INTERRUPT_PRO_MAP 0x0000001F +#define DPORT_PRO_GPIO_INTERRUPT_PRO_MAP_S 0 + +#define PRO_GPIO_INTERRUPT_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x160) +#define DPORT_PRO_GPIO_INTERRUPT_PRO_NMI_MAP 0x0000001F +#define DPORT_PRO_GPIO_INTERRUPT_PRO_NMI_MAP_S 0 + +#define PRO_CPU_INTR_FROM_CPU_0_MAP_REG (DR_REG_DPORT_BASE + 0x164) +#define DPORT_PRO_CPU_INTR_FROM_CPU_0_MAP 0x0000001F +#define DPORT_PRO_CPU_INTR_FROM_CPU_0_MAP_S 0 + +#define PRO_CPU_INTR_FROM_CPU_1_MAP_REG (DR_REG_DPORT_BASE + 0x168) +#define DPORT_PRO_CPU_INTR_FROM_CPU_1_MAP 0x0000001F +#define DPORT_PRO_CPU_INTR_FROM_CPU_1_MAP_S 0 + +#define PRO_CPU_INTR_FROM_CPU_2_MAP_REG (DR_REG_DPORT_BASE + 0x16C) +#define DPORT_PRO_CPU_INTR_FROM_CPU_2_MAP 0x0000001F +#define DPORT_PRO_CPU_INTR_FROM_CPU_2_MAP_S 0 + +#define PRO_CPU_INTR_FROM_CPU_3_MAP_REG (DR_REG_DPORT_BASE + 0x170) +#define DPORT_PRO_CPU_INTR_FROM_CPU_3_MAP 0x0000001F +#define DPORT_PRO_CPU_INTR_FROM_CPU_3_MAP_S 0 + +#define PRO_SPI_INTR_0_MAP_REG (DR_REG_DPORT_BASE + 0x174) +#define DPORT_PRO_SPI_INTR_0_MAP 0x0000001F +#define DPORT_PRO_SPI_INTR_0_MAP_S 0 + +#define PRO_SPI_INTR_1_MAP_REG (DR_REG_DPORT_BASE + 0x178) +#define DPORT_PRO_SPI_INTR_1_MAP 0x0000001F +#define DPORT_PRO_SPI_INTR_1_MAP_S 0 + +#define PRO_SPI_INTR_2_MAP_REG (DR_REG_DPORT_BASE + 0x17C) +#define DPORT_PRO_SPI_INTR_2_MAP 0x0000001F +#define DPORT_PRO_SPI_INTR_2_MAP_S 0 + +#define PRO_SPI_INTR_3_MAP_REG (DR_REG_DPORT_BASE + 0x180) +#define DPORT_PRO_SPI_INTR_3_MAP 0x0000001F +#define DPORT_PRO_SPI_INTR_3_MAP_S 0 + +#define PRO_I2S0_INT_MAP_REG (DR_REG_DPORT_BASE + 0x184) +#define DPORT_PRO_I2S0_INT_MAP 0x0000001F +#define DPORT_PRO_I2S0_INT_MAP_S 0 + +#define PRO_I2S1_INT_MAP_REG (DR_REG_DPORT_BASE + 0x188) +#define DPORT_PRO_I2S1_INT_MAP 0x0000001F +#define DPORT_PRO_I2S1_INT_MAP_S 0 + +#define PRO_UART_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x18C) +#define DPORT_PRO_UART_INTR_MAP 0x0000001F +#define DPORT_PRO_UART_INTR_MAP_S 0 + +#define PRO_UART1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x190) +#define DPORT_PRO_UART1_INTR_MAP 0x0000001F +#define DPORT_PRO_UART1_INTR_MAP_S 0 + +#define PRO_UART2_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x194) +#define DPORT_PRO_UART2_INTR_MAP 0x0000001F +#define DPORT_PRO_UART2_INTR_MAP_S 0 + +#define PRO_SDIO_HOST_INTERRUPT_MAP_REG (DR_REG_DPORT_BASE + 0x198) +#define DPORT_PRO_SDIO_HOST_INTERRUPT_MAP 0x0000001F +#define DPORT_PRO_SDIO_HOST_INTERRUPT_MAP_S 0 + +#define PRO_EMAC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x19C) +#define DPORT_PRO_EMAC_INT_MAP 0x0000001F +#define DPORT_PRO_EMAC_INT_MAP_S 0 + +#define PRO_PWM0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1A0) +#define DPORT_PRO_PWM0_INTR_MAP 0x0000001F +#define DPORT_PRO_PWM0_INTR_MAP_S 0 + +#define PRO_PWM1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1A4) +#define DPORT_PRO_PWM1_INTR_MAP 0x0000001F +#define DPORT_PRO_PWM1_INTR_MAP_S 0 + +#define PRO_PWM2_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1A8) +#define DPORT_PRO_PWM2_INTR_MAP 0x0000001F +#define DPORT_PRO_PWM2_INTR_MAP_S 0 + +#define PRO_PWM3_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1AC) +#define DPORT_PRO_PWM3_INTR_MAP 0x0000001F +#define DPORT_PRO_PWM3_INTR_MAP_S 0 + +#define PRO_LEDC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1B0) +#define DPORT_PRO_LEDC_INT_MAP 0x0000001F +#define DPORT_PRO_LEDC_INT_MAP_S 0 + +#define PRO_EFUSE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1B4) +#define DPORT_PRO_EFUSE_INT_MAP 0x0000001F +#define DPORT_PRO_EFUSE_INT_MAP_S 0 + +#define PRO_CAN_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1B8) +#define DPORT_PRO_CAN_INT_MAP 0x0000001F +#define DPORT_PRO_CAN_INT_MAP_S 0 + +#define PRO_RTC_CORE_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1BC) +#define DPORT_PRO_RTC_CORE_INTR_MAP 0x0000001F +#define DPORT_PRO_RTC_CORE_INTR_MAP_S 0 + +#define PRO_RMT_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1C0) +#define DPORT_PRO_RMT_INTR_MAP 0x0000001F +#define DPORT_PRO_RMT_INTR_MAP_S 0 + +#define PRO_PCNT_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1C4) +#define DPORT_PRO_PCNT_INTR_MAP 0x0000001F +#define DPORT_PRO_PCNT_INTR_MAP_S 0 + +#define PRO_I2C_EXT0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1C8) +#define DPORT_PRO_I2C_EXT0_INTR_MAP 0x0000001F +#define DPORT_PRO_I2C_EXT0_INTR_MAP_S 0 + +#define PRO_I2C_EXT1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1CC) +#define DPORT_PRO_I2C_EXT1_INTR_MAP 0x0000001F +#define DPORT_PRO_I2C_EXT1_INTR_MAP_S 0 + +#define PRO_RSA_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x1D0) +#define DPORT_PRO_RSA_INTR_MAP 0x0000001F +#define DPORT_PRO_RSA_INTR_MAP_S 0 + +#define PRO_SPI1_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1D4) +#define DPORT_PRO_SPI1_DMA_INT_MAP 0x0000001F +#define DPORT_PRO_SPI1_DMA_INT_MAP_S 0 + +#define PRO_SPI2_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1D8) +#define DPORT_PRO_SPI2_DMA_INT_MAP 0x0000001F +#define DPORT_PRO_SPI2_DMA_INT_MAP_S 0 + +#define PRO_SPI3_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1DC) +#define DPORT_PRO_SPI3_DMA_INT_MAP 0x0000001F +#define DPORT_PRO_SPI3_DMA_INT_MAP_S 0 + +#define PRO_WDG_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1E0) +#define DPORT_PRO_WDG_INT_MAP 0x0000001F +#define DPORT_PRO_WDG_INT_MAP_S 0 + +#define PRO_TIMER_INT1_MAP_REG (DR_REG_DPORT_BASE + 0x1E4) +#define DPORT_PRO_TIMER_INT1_MAP 0x0000001F +#define DPORT_PRO_TIMER_INT1_MAP_S 0 + +#define PRO_TIMER_INT2_MAP_REG (DR_REG_DPORT_BASE + 0x1E8) +#define DPORT_PRO_TIMER_INT2_MAP 0x0000001F +#define DPORT_PRO_TIMER_INT2_MAP_S 0 + +#define PRO_TG_T0_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1EC) +#define DPORT_PRO_TG_T0_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG_T0_EDGE_INT_MAP_S 0 + +#define PRO_TG_T1_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1F0) +#define DPORT_PRO_TG_T1_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG_T1_EDGE_INT_MAP_S 0 + +#define PRO_TG_WDT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1F4) +#define DPORT_PRO_TG_WDT_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG_WDT_EDGE_INT_MAP_S 0 + +#define PRO_TG_LACT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1F8) +#define DPORT_PRO_TG_LACT_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG_LACT_EDGE_INT_MAP_S 0 + +#define PRO_TG1_T0_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x1FC) +#define DPORT_PRO_TG1_T0_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_T0_EDGE_INT_MAP_S 0 + +#define PRO_TG1_T1_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x200) +#define DPORT_PRO_TG1_T1_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_T1_EDGE_INT_MAP_S 0 + +#define PRO_TG1_WDT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x204) +#define DPORT_PRO_TG1_WDT_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_WDT_EDGE_INT_MAP_S 0 + +#define PRO_TG1_LACT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x208) +#define DPORT_PRO_TG1_LACT_EDGE_INT_MAP 0x0000001F +#define DPORT_PRO_TG1_LACT_EDGE_INT_MAP_S 0 + +#define PRO_MMU_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x20C) +#define DPORT_PRO_MMU_IA_INT_MAP 0x0000001F +#define DPORT_PRO_MMU_IA_INT_MAP_S 0 + +#define PRO_MPU_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x210) +#define DPORT_PRO_MPU_IA_INT_MAP 0x0000001F +#define DPORT_PRO_MPU_IA_INT_MAP_S 0 + +#define PRO_CACHE_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x214) +#define DPORT_PRO_CACHE_IA_INT_MAP 0x0000001F +#define DPORT_PRO_CACHE_IA_INT_MAP_S 0 + +#define APP_MAC_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x218) +#define DPORT_APP_MAC_INTR_MAP 0x0000001F +#define DPORT_APP_MAC_INTR_MAP_S 0 + +#define APP_MAC_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x21C) +#define DPORT_APP_MAC_NMI_MAP 0x0000001F +#define DPORT_APP_MAC_NMI_MAP_S 0 + +#define APP_BB_INT_MAP_REG (DR_REG_DPORT_BASE + 0x220) +#define DPORT_APP_BB_INT_MAP 0x0000001F +#define DPORT_APP_BB_INT_MAP_S 0 + +#define APP_BT_MAC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x224) +#define DPORT_APP_BT_MAC_INT_MAP 0x0000001F +#define DPORT_APP_BT_MAC_INT_MAP_S 0 + +#define APP_BT_BB_INT_MAP_REG (DR_REG_DPORT_BASE + 0x228) +#define DPORT_APP_BT_BB_INT_MAP 0x0000001F +#define DPORT_APP_BT_BB_INT_MAP_S 0 + +#define APP_BT_BB_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x22C) +#define DPORT_APP_BT_BB_NMI_MAP 0x0000001F +#define DPORT_APP_BT_BB_NMI_MAP_S 0 + +#define APP_RWBT_IRQ_MAP_REG (DR_REG_DPORT_BASE + 0x230) +#define DPORT_APP_RWBT_IRQ_MAP 0x0000001F +#define DPORT_APP_RWBT_IRQ_MAP_S 0 + +#define APP_RWBLE_IRQ_MAP_REG (DR_REG_DPORT_BASE + 0x234) +#define DPORT_APP_RWBLE_IRQ_MAP 0x0000001F +#define DPORT_APP_RWBLE_IRQ_MAP_S 0 + +#define APP_RWBT_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x238) +#define DPORT_APP_RWBT_NMI_MAP 0x0000001F +#define DPORT_APP_RWBT_NMI_MAP_S 0 + +#define APP_RWBLE_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x23C) +#define DPORT_APP_RWBLE_NMI_MAP 0x0000001F +#define DPORT_APP_RWBLE_NMI_MAP_S 0 + +#define APP_SLC0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x240) +#define DPORT_APP_SLC0_INTR_MAP 0x0000001F +#define DPORT_APP_SLC0_INTR_MAP_S 0 + +#define APP_SLC1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x244) +#define DPORT_APP_SLC1_INTR_MAP 0x0000001F +#define DPORT_APP_SLC1_INTR_MAP_S 0 + +#define APP_UHCI0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x248) +#define DPORT_APP_UHCI0_INTR_MAP 0x0000001F +#define DPORT_APP_UHCI0_INTR_MAP_S 0 + +#define APP_UHCI1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x24C) +#define DPORT_APP_UHCI1_INTR_MAP 0x0000001F +#define DPORT_APP_UHCI1_INTR_MAP_S 0 + +#define APP_TG_T0_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x250) +#define DPORT_APP_TG_T0_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG_T0_LEVEL_INT_MAP_S 0 + +#define APP_TG_T1_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x254) +#define DPORT_APP_TG_T1_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG_T1_LEVEL_INT_MAP_S 0 + +#define APP_TG_WDT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x258) +#define DPORT_APP_TG_WDT_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG_WDT_LEVEL_INT_MAP_S 0 + +#define APP_TG_LACT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x25C) +#define DPORT_APP_TG_LACT_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG_LACT_LEVEL_INT_MAP_S 0 + +#define APP_TG1_T0_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x260) +#define DPORT_APP_TG1_T0_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG1_T0_LEVEL_INT_MAP_S 0 + +#define APP_TG1_T1_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x264) +#define DPORT_APP_TG1_T1_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG1_T1_LEVEL_INT_MAP_S 0 + +#define APP_TG1_WDT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x268) +#define DPORT_APP_TG1_WDT_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG1_WDT_LEVEL_INT_MAP_S 0 + +#define APP_TG1_LACT_LEVEL_INT_MAP_REG (DR_REG_DPORT_BASE + 0x26C) +#define DPORT_APP_TG1_LACT_LEVEL_INT_MAP 0x0000001F +#define DPORT_APP_TG1_LACT_LEVEL_INT_MAP_S 0 + +#define APP_GPIO_INTERRUPT_MAP_REG (DR_REG_DPORT_BASE + 0x270) +#define DPORT_APP_GPIO_INTERRUPT_APP_MAP 0x0000001F +#define DPORT_APP_GPIO_INTERRUPT_APP_MAP_S 0 + +#define APP_GPIO_INTERRUPT_NMI_MAP_REG (DR_REG_DPORT_BASE + 0x274) +#define DPORT_APP_GPIO_INTERRUPT_APP_NMI_MAP 0x0000001F +#define DPORT_APP_GPIO_INTERRUPT_APP_NMI_MAP_S 0 + +#define APP_CPU_INTR_FROM_CPU_0_MAP_REG (DR_REG_DPORT_BASE + 0x278) +#define DPORT_APP_CPU_INTR_FROM_CPU_0_MAP 0x0000001F +#define DPORT_APP_CPU_INTR_FROM_CPU_0_MAP_S 0 + +#define APP_CPU_INTR_FROM_CPU_1_MAP_REG (DR_REG_DPORT_BASE + 0x27C) +#define DPORT_APP_CPU_INTR_FROM_CPU_1_MAP 0x0000001F +#define DPORT_APP_CPU_INTR_FROM_CPU_1_MAP_S 0 + +#define APP_CPU_INTR_FROM_CPU_2_MAP_REG (DR_REG_DPORT_BASE + 0x280) +#define DPORT_APP_CPU_INTR_FROM_CPU_2_MAP 0x0000001F +#define DPORT_APP_CPU_INTR_FROM_CPU_2_MAP_S 0 + +#define APP_CPU_INTR_FROM_CPU_3_MAP_REG (DR_REG_DPORT_BASE + 0x284) +#define DPORT_APP_CPU_INTR_FROM_CPU_3_MAP 0x0000001F +#define DPORT_APP_CPU_INTR_FROM_CPU_3_MAP_S 0 + +#define APP_SPI_INTR_0_MAP_REG (DR_REG_DPORT_BASE + 0x288) +#define DPORT_APP_SPI_INTR_0_MAP 0x0000001F +#define DPORT_APP_SPI_INTR_0_MAP_S 0 + +#define APP_SPI_INTR_1_MAP_REG (DR_REG_DPORT_BASE + 0x28C) +#define DPORT_APP_SPI_INTR_1_MAP 0x0000001F +#define DPORT_APP_SPI_INTR_1_MAP_S 0 + +#define APP_SPI_INTR_2_MAP_REG (DR_REG_DPORT_BASE + 0x290) +#define DPORT_APP_SPI_INTR_2_MAP 0x0000001F +#define DPORT_APP_SPI_INTR_2_MAP_S 0 + +#define APP_SPI_INTR_3_MAP_REG (DR_REG_DPORT_BASE + 0x294) +#define DPORT_APP_SPI_INTR_3_MAP 0x0000001F +#define DPORT_APP_SPI_INTR_3_MAP_S 0 + +#define APP_I2S0_INT_MAP_REG (DR_REG_DPORT_BASE + 0x298) +#define DPORT_APP_I2S0_INT_MAP 0x0000001F +#define DPORT_APP_I2S0_INT_MAP_S 0 + +#define APP_I2S1_INT_MAP_REG (DR_REG_DPORT_BASE + 0x29C) +#define DPORT_APP_I2S1_INT_MAP 0x0000001F +#define DPORT_APP_I2S1_INT_MAP_S 0 + +#define APP_UART_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2A0) +#define DPORT_APP_UART_INTR_MAP 0x0000001F +#define DPORT_APP_UART_INTR_MAP_S 0 + +#define APP_UART1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2A4) +#define DPORT_APP_UART1_INTR_MAP 0x0000001F +#define DPORT_APP_UART1_INTR_MAP_S 0 + +#define APP_UART2_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2A8) +#define DPORT_APP_UART2_INTR_MAP 0x0000001F +#define DPORT_APP_UART2_INTR_MAP_S 0 + +#define APP_SDIO_HOST_INTERRUPT_MAP_REG (DR_REG_DPORT_BASE + 0x2AC) +#define DPORT_APP_SDIO_HOST_INTERRUPT_MAP 0x0000001F +#define DPORT_APP_SDIO_HOST_INTERRUPT_MAP_S 0 + +#define APP_EMAC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2B0) +#define DPORT_APP_EMAC_INT_MAP 0x0000001F +#define DPORT_APP_EMAC_INT_MAP_S 0 + +#define APP_PWM0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2B4) +#define DPORT_APP_PWM0_INTR_MAP 0x0000001F +#define DPORT_APP_PWM0_INTR_MAP_S 0 + +#define APP_PWM1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2B8) +#define DPORT_APP_PWM1_INTR_MAP 0x0000001F +#define DPORT_APP_PWM1_INTR_MAP_S 0 + +#define APP_PWM2_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2BC) +#define DPORT_APP_PWM2_INTR_MAP 0x0000001F +#define DPORT_APP_PWM2_INTR_MAP_S 0 + +#define APP_PWM3_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2C0) +#define DPORT_APP_PWM3_INTR_MAP 0x0000001F +#define DPORT_APP_PWM3_INTR_MAP_S 0 + +#define APP_LEDC_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2C4) +#define DPORT_APP_LEDC_INT_MAP 0x0000001F +#define DPORT_APP_LEDC_INT_MAP_S 0 + +#define APP_EFUSE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2C8) +#define DPORT_APP_EFUSE_INT_MAP 0x0000001F +#define DPORT_APP_EFUSE_INT_MAP_S 0 + +#define APP_CAN_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2CC) +#define DPORT_APP_CAN_INT_MAP 0x0000001F +#define DPORT_APP_CAN_INT_MAP_S 0 + +#define APP_RTC_CORE_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2D0) +#define DPORT_APP_RTC_CORE_INTR_MAP 0x0000001F +#define DPORT_APP_RTC_CORE_INTR_MAP_S 0 + +#define APP_RMT_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2D4) +#define DPORT_APP_RMT_INTR_MAP 0x0000001F +#define DPORT_APP_RMT_INTR_MAP_S 0 + +#define APP_PCNT_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2D8) +#define DPORT_APP_PCNT_INTR_MAP 0x0000001F +#define DPORT_APP_PCNT_INTR_MAP_S 0 + +#define APP_I2C_EXT0_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2DC) +#define DPORT_APP_I2C_EXT0_INTR_MAP 0x0000001F +#define DPORT_APP_I2C_EXT0_INTR_MAP_S 0 + +#define APP_I2C_EXT1_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2E0) +#define DPORT_APP_I2C_EXT1_INTR_MAP 0x0000001F +#define DPORT_APP_I2C_EXT1_INTR_MAP_S 0 + +#define APP_RSA_INTR_MAP_REG (DR_REG_DPORT_BASE + 0x2E4) +#define DPORT_APP_RSA_INTR_MAP 0x0000001F +#define DPORT_APP_RSA_INTR_MAP_S 0 + +#define APP_SPI1_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2E8) +#define DPORT_APP_SPI1_DMA_INT_MAP 0x0000001F +#define DPORT_APP_SPI1_DMA_INT_MAP_S 0 + +#define APP_SPI2_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2EC) +#define DPORT_APP_SPI2_DMA_INT_MAP 0x0000001F +#define DPORT_APP_SPI2_DMA_INT_MAP_S 0 + +#define APP_SPI3_DMA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2F0) +#define DPORT_APP_SPI3_DMA_INT_MAP 0x0000001F +#define DPORT_APP_SPI3_DMA_INT_MAP_S 0 + +#define APP_WDG_INT_MAP_REG (DR_REG_DPORT_BASE + 0x2F4) +#define DPORT_APP_WDG_INT_MAP 0x0000001F +#define DPORT_APP_WDG_INT_MAP_S 0 + +#define APP_TIMER_INT1_MAP_REG (DR_REG_DPORT_BASE + 0x2F8) +#define DPORT_APP_TIMER_INT1_MAP 0x0000001F +#define DPORT_APP_TIMER_INT1_MAP_S 0 + +#define APP_TIMER_INT2_MAP_REG (DR_REG_DPORT_BASE + 0x2FC) +#define DPORT_APP_TIMER_INT2_MAP 0x0000001F +#define DPORT_APP_TIMER_INT2_MAP_S 0 + +#define APP_TG_T0_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x300) +#define DPORT_APP_TG_T0_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG_T0_EDGE_INT_MAP_S 0 + +#define APP_TG_T1_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x304) +#define DPORT_APP_TG_T1_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG_T1_EDGE_INT_MAP_S 0 + +#define APP_TG_WDT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x308) +#define DPORT_APP_TG_WDT_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG_WDT_EDGE_INT_MAP_S 0 + +#define APP_TG_LACT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x30C) +#define DPORT_APP_TG_LACT_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG_LACT_EDGE_INT_MAP_S 0 + +#define APP_TG1_T0_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x310) +#define DPORT_APP_TG1_T0_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG1_T0_EDGE_INT_MAP_S 0 + +#define APP_TG1_T1_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x314) +#define DPORT_APP_TG1_T1_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG1_T1_EDGE_INT_MAP_S 0 + +#define APP_TG1_WDT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x318) +#define DPORT_APP_TG1_WDT_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG1_WDT_EDGE_INT_MAP_S 0 + +#define APP_TG1_LACT_EDGE_INT_MAP_REG (DR_REG_DPORT_BASE + 0x31C) +#define DPORT_APP_TG1_LACT_EDGE_INT_MAP 0x0000001F +#define DPORT_APP_TG1_LACT_EDGE_INT_MAP_S 0 + +#define APP_MMU_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x320) +#define DPORT_APP_MMU_IA_INT_MAP 0x0000001F +#define DPORT_APP_MMU_IA_INT_MAP_S 0 + +#define APP_MPU_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x324) +#define DPORT_APP_MPU_IA_INT_MAP 0x0000001F +#define DPORT_APP_MPU_IA_INT_MAP_S 0 + +#define APP_CACHE_IA_INT_MAP_REG (DR_REG_DPORT_BASE + 0x328) +#define DPORT_APP_CACHE_IA_INT_MAP 0x0000001F +#define DPORT_APP_CACHE_IA_INT_MAP_S 0 + +#define AHBLITE_MPU_TABLE_UART (DR_REG_DPORT_BASE + 0x32C) +#define DPORT_UART_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_UART_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SPI1 (DR_REG_DPORT_BASE + 0x330) +#define DPORT_SPI1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SPI1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SPI0 (DR_REG_DPORT_BASE + 0x334) +#define DPORT_SPI0_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SPI0_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_GPIO (DR_REG_DPORT_BASE + 0x338) +#define DPORT_GPIO_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_GPIO_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_FE2 (DR_REG_DPORT_BASE + 0x33C) +#define DPORT_FE2_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_FE2_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_FE (DR_REG_DPORT_BASE + 0x340) +#define DPORT_FE_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_FE_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_TIMER (DR_REG_DPORT_BASE + 0x344) +#define DPORT_TIMER_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_TIMER_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_RTC (DR_REG_DPORT_BASE + 0x348) +#define DPORT_RTC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_RTC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_IO_MUX (DR_REG_DPORT_BASE + 0x34C) +#define DPORT_IOMUX_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_IOMUX_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_WDG (DR_REG_DPORT_BASE + 0x350) +#define DPORT_WDG_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_WDG_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_HINF (DR_REG_DPORT_BASE + 0x354) +#define DPORT_HINF_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_HINF_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_UHCI1 (DR_REG_DPORT_BASE + 0x358) +#define DPORT_UHCI1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_UHCI1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_MISC (DR_REG_DPORT_BASE + 0x35C) +#define DPORT_MISC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_MISC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_I2C (DR_REG_DPORT_BASE + 0x360) +#define DPORT_I2C_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_I2C_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_I2S0 (DR_REG_DPORT_BASE + 0x364) +#define DPORT_I2S0_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_I2S0_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_UART1 (DR_REG_DPORT_BASE + 0x368) +#define DPORT_UART1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_UART1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_BT (DR_REG_DPORT_BASE + 0x36C) +#define DPORT_BT_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_BT_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_BT_BUFFER (DR_REG_DPORT_BASE + 0x370) +#define DPORT_BTBUFFER_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_BTBUFFER_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_I2C_EXT0 (DR_REG_DPORT_BASE + 0x374) +#define DPORT_I2CEXT0_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_I2CEXT0_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_UHCI0 (DR_REG_DPORT_BASE + 0x378) +#define DPORT_UHCI0_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_UHCI0_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SLCHOST (DR_REG_DPORT_BASE + 0x37C) +#define DPORT_SLCHOST_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SLCHOST_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_RMT (DR_REG_DPORT_BASE + 0x380) +#define DPORT_RMT_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_RMT_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PCNT (DR_REG_DPORT_BASE + 0x384) +#define DPORT_PCNT_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PCNT_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SLC (DR_REG_DPORT_BASE + 0x388) +#define DPORT_SLC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SLC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_LEDC (DR_REG_DPORT_BASE + 0x38C) +#define DPORT_LEDC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_LEDC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_EFUSE (DR_REG_DPORT_BASE + 0x390) +#define DPORT_EFUSE_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_EFUSE_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SPI_ENCRYPT (DR_REG_DPORT_BASE + 0x394) +#define DPORT_SPI_ENCRYPY_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SPI_ENCRYPY_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_BB (DR_REG_DPORT_BASE + 0x398) +#define DPORT_BB_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_BB_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PWM0 (DR_REG_DPORT_BASE + 0x39C) +#define DPORT_PWM0_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PWM0_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_TIMERGROUP (DR_REG_DPORT_BASE + 0x3A0) +#define DPORT_TIMERGROUP_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_TIMERGROUP_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_TIMERGROUP1 (DR_REG_DPORT_BASE + 0x3A4) +#define DPORT_TIMERGROUP1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_TIMERGROUP1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SPI2 (DR_REG_DPORT_BASE + 0x3A8) +#define DPORT_SPI2_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SPI2_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SPI3 (DR_REG_DPORT_BASE + 0x3AC) +#define DPORT_SPI3_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SPI3_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_APB_CTRL (DR_REG_DPORT_BASE + 0x3B0) +#define DPORT_APBCTRL_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_APBCTRL_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_I2C_EXT1 (DR_REG_DPORT_BASE + 0x3B4) +#define DPORT_I2CEXT1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_I2CEXT1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_SDIO_HOST (DR_REG_DPORT_BASE + 0x3B8) +#define DPORT_SDIOHOST_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_SDIOHOST_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_EMAC (DR_REG_DPORT_BASE + 0x3BC) +#define DPORT_EMAC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_EMAC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_CAN (DR_REG_DPORT_BASE + 0x3C0) +#define DPORT_CAN_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_CAN_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PWM1 (DR_REG_DPORT_BASE + 0x3C4) +#define DPORT_PWM1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PWM1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_I2S1 (DR_REG_DPORT_BASE + 0x3C8) +#define DPORT_I2S1_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_I2S1_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_UART2 (DR_REG_DPORT_BASE + 0x3CC) +#define DPORT_UART2_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_UART2_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PWM2 (DR_REG_DPORT_BASE + 0x3D0) +#define DPORT_PWM2_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PWM2_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PWM3 (DR_REG_DPORT_BASE + 0x3D4) +#define DPORT_PWM3_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PWM3_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_RWBT (DR_REG_DPORT_BASE + 0x3D8) +#define DPORT_RWBT_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_RWBT_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_BTMAC (DR_REG_DPORT_BASE + 0x3DC) +#define DPORT_BTMAC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_BTMAC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_WIFIMAC (DR_REG_DPORT_BASE + 0x3E0) +#define DPORT_WIFIMAC_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_WIFIMAC_ACCESS_GRANT_CONFIG_S 0 + +#define AHBLITE_MPU_TABLE_PWR (DR_REG_DPORT_BASE + 0x3E4) +#define DPORT_PWR_ACCESS_GRANT_CONFIG 0x0000003F +#define DPORT_PWR_ACCESS_GRANT_CONFIG_S 0 + +#define MEM_ACCESS_DBUG0 (DR_REG_DPORT_BASE + 0x3E8) +#define DPORT_INTERNAL_SRAM_MMU_MULTI_HIT 0x0000000F +#define DPORT_INTERNAL_SRAM_MMU_MULTI_HIT_S 26 +#define DPORT_INTERNAL_SRAM_IA 0x00000FFF +#define DPORT_INTERNAL_SRAM_IA_S 14 +#define DPORT_INTERNAL_SRAM_MMU_AD 0x0000000F +#define DPORT_INTERNAL_SRAM_MMU_AD_S 10 +#define DPORT_SHARE_ROM_IA 0x0000000F +#define DPORT_SHARE_ROM_IA_S 6 +#define DPORT_SHARE_ROM_MPU_AD 0x00000003 +#define DPORT_SHARE_ROM_MPU_AD_S 4 +#define DPORT_APP_ROM_IA (BIT(3)) +#define DPORT_APP_ROM_IA_S 3 +#define DPORT_APP_ROM_MPU_AD (BIT(2)) +#define DPORT_APP_ROM_MPU_AD_S 2 +#define DPORT_PRO_ROM_IA (BIT(1)) +#define DPORT_PRO_ROM_IA_S 1 +#define DPORT_PRO_ROM_MPU_AD (BIT(0)) +#define DPORT_PRO_ROM_MPU_AD_S 0 + +#define MEM_ACCESS_DBUG1 (DR_REG_DPORT_BASE + 0x3EC) +#define DPORT_AHBLITE_IA (BIT(10)) +#define DPORT_AHBLITE_IA_S 10 +#define DPORT_AHBLITE_ACCESS_DENY (BIT(9)) +#define DPORT_AHBLITE_ACCESS_DENY_S 9 +#define DPORT_AHB_ACCESS_DENY (BIT(8)) +#define DPORT_AHB_ACCESS_DENY_S 8 +#define DPORT_DPORT_PIDGEN_IA 0x00000003 +#define DPORT_DPORT_PIDGEN_IA_S 6 +#define DPORT_DPORT_ARB_IA 0x00000003 +#define DPORT_DPORT_ARB_IA_S 4 +#define DPORT_INTERNAL_SRAM_MMU_MISS 0x0000000F +#define DPORT_INTERNAL_SRAM_MMU_MISS_S 0 + +#define PRO_DCACHE_DBUG_REG0 (DR_REG_DPORT_BASE + 0x3F0) +#define DPORT_PRO_RX_END (BIT(23)) +#define DPORT_PRO_RX_END_S 23 +#define DPORT_PRO_SLAVE_WDATA_V (BIT(22)) +#define DPORT_PRO_SLAVE_WDATA_V_S 22 +#define DPORT_PRO_SLAVE_WR (BIT(21)) +#define DPORT_PRO_SLAVE_WR_S 21 +#define DPORT_PRO_TX_END (BIT(20)) +#define DPORT_PRO_TX_END_S 20 +#define DPORT_PRO_WR_BAK_TO_READ (BIT(19)) +#define DPORT_PRO_WR_BAK_TO_READ_S 19 +#define DPORT_PRO_CACHE_STATE 0x00000FFF +#define DPORT_PRO_CACHE_STATE_S 7 +#define DPORT_PRO_CACHE_IA 0x0000003F +#define DPORT_PRO_CACHE_IA_S 1 +#define DPORT_PRO_CACHE_MMU_IA (BIT(0)) +#define DPORT_PRO_CACHE_MMU_IA_S 0 + +#define PRO_DCACHE_DBUG_REG1 (DR_REG_DPORT_BASE + 0x3F4) +#define DPORT_PRO_CTAG_RAM_RDATA 0xFFFFFFFF +#define DPORT_PRO_CTAG_RAM_RDATA_S 0 + +#define PRO_DCACHE_DBUG_REG2 (DR_REG_DPORT_BASE + 0x3F8) +#define DPORT_PRO_CACHE_VADDR 0x07FFFFFF +#define DPORT_PRO_CACHE_VADDR_S 0 + +#define PRO_DCACHE_DBUG_REG3 (DR_REG_DPORT_BASE + 0x3FC) +#define DPORT_PRO_CACHE_IRAM0_PID_ERROR (BIT(15)) +#define DPORT_PRO_CACHE_IRAM0_PID_ERROR_S 15 +#define DPORT_PRO_CPU_DISABLED_CACHE_IA 0x0000003F +#define DPORT_PRO_CPU_DISABLED_CACHE_IA_S 9 +#define DPORT_PRO_MMU_RDATA 0x000001FF +#define DPORT_PRO_MMU_RDATA_S 0 + +#define PRO_DCACHE_DBUG_REG4 (DR_REG_DPORT_BASE + 0x400) +#define DPORT_PRO_DRAM1ADDR0_IA 0x000FFFFF +#define DPORT_PRO_DRAM1ADDR0_IA_S 0 + +#define PRO_DCACHE_DBUG_REG5 (DR_REG_DPORT_BASE + 0x404) +#define DPORT_PRO_DROM0ADDR0_IA 0x000FFFFF +#define DPORT_PRO_DROM0ADDR0_IA_S 0 + +#define PRO_DCACHE_DBUG_REG6 (DR_REG_DPORT_BASE + 0x408) +#define DPORT_PRO_IRAM0ADDR_IA 0x000FFFFF +#define DPORT_PRO_IRAM0ADDR_IA_S 0 + +#define PRO_DCACHE_DBUG_REG7 (DR_REG_DPORT_BASE + 0x40C) +#define DPORT_PRO_IRAM1ADDR_IA 0x000FFFFF +#define DPORT_PRO_IRAM1ADDR_IA_S 0 + +#define PRO_DCACHE_DBUG_REG8 (DR_REG_DPORT_BASE + 0x410) +#define DPORT_PRO_IROM0ADDR_IA 0x000FFFFF +#define DPORT_PRO_IROM0ADDR_IA_S 0 + +#define PRO_DCACHE_DBUG_REG9 (DR_REG_DPORT_BASE + 0x414) +#define DPORT_PRO_OPSDRAMADDR_IA 0x000FFFFF +#define DPORT_PRO_OPSDRAMADDR_IA_S 0 + +#define APP_DCACHE_DBUG_REG0 (DR_REG_DPORT_BASE + 0x418) +#define DPORT_APP_RX_END (BIT(23)) +#define DPORT_APP_RX_END_S 23 +#define DPORT_APP_SLAVE_WDATA_V (BIT(22)) +#define DPORT_APP_SLAVE_WDATA_V_S 22 +#define DPORT_APP_SLAVE_WR (BIT(21)) +#define DPORT_APP_SLAVE_WR_S 21 +#define DPORT_APP_TX_END (BIT(20)) +#define DPORT_APP_TX_END_S 20 +#define DPORT_APP_WR_BAK_TO_READ (BIT(19)) +#define DPORT_APP_WR_BAK_TO_READ_S 19 +#define DPORT_APP_CACHE_STATE 0x00000FFF +#define DPORT_APP_CACHE_STATE_S 7 +#define DPORT_APP_CACHE_IA 0x0000003F +#define DPORT_APP_CACHE_IA_S 1 +#define DPORT_APP_CACHE_MMU_IA (BIT(0)) +#define DPORT_APP_CACHE_MMU_IA_S 0 + +#define APP_DCACHE_DBUG_REG1 (DR_REG_DPORT_BASE + 0x41C) +#define DPORT_APP_CTAG_RAM_RDATA 0xFFFFFFFF +#define DPORT_APP_CTAG_RAM_RDATA_S 0 + +#define APP_DCACHE_DBUG_REG2 (DR_REG_DPORT_BASE + 0x420) +#define DPORT_APP_CACHE_VADDR 0x07FFFFFF +#define DPORT_APP_CACHE_VADDR_S 0 + +#define APP_DCACHE_DBUG_REG3 (DR_REG_DPORT_BASE + 0x424) +#define DPORT_APP_CACHE_IRAM0_PID_ERROR (BIT(15)) +#define DPORT_APP_CACHE_IRAM0_PID_ERROR_S 15 +#define DPORT_APP_CPU_DISABLED_CACHE_IA 0x0000003F +#define DPORT_APP_CPU_DISABLED_CACHE_IA_S 9 +#define DPORT_APP_MMU_RDATA 0x000001FF +#define DPORT_APP_MMU_RDATA_S 0 + +#define APP_DCACHE_DBUG_REG4 (DR_REG_DPORT_BASE + 0x428) +#define DPORT_APP_DRAM1ADDR0_IA 0x000FFFFF +#define DPORT_APP_DRAM1ADDR0_IA_S 0 + +#define APP_DCACHE_DBUG_REG5 (DR_REG_DPORT_BASE + 0x42C) +#define DPORT_APP_DROM0ADDR0_IA 0x000FFFFF +#define DPORT_APP_DROM0ADDR0_IA_S 0 + +#define APP_DCACHE_DBUG_REG6 (DR_REG_DPORT_BASE + 0x430) +#define DPORT_APP_IRAM0ADDR_IA 0x000FFFFF +#define DPORT_APP_IRAM0ADDR_IA_S 0 + +#define APP_DCACHE_DBUG_REG7 (DR_REG_DPORT_BASE + 0x434) +#define DPORT_APP_IRAM1ADDR_IA 0x000FFFFF +#define DPORT_APP_IRAM1ADDR_IA_S 0 + +#define APP_DCACHE_DBUG_REG8 (DR_REG_DPORT_BASE + 0x438) +#define DPORT_APP_IROM0ADDR_IA 0x000FFFFF +#define DPORT_APP_IROM0ADDR_IA_S 0 + +#define APP_DCACHE_DBUG_REG9 (DR_REG_DPORT_BASE + 0x43C) +#define DPORT_APP_OPSDRAMADDR_IA 0x000FFFFF +#define DPORT_APP_OPSDRAMADDR_IA_S 0 + +#define PRO_CPU_RECORD_CTRL (DR_REG_DPORT_BASE + 0x440) +#define DPORT_PRO_CPU_PDEBUG_ENABLE (BIT(8)) +#define DPORT_PRO_CPU_PDEBUG_ENABLE_S 8 +#define DPORT_PRO_CPU_RECORD_DISABLE (BIT(4)) +#define DPORT_PRO_CPU_RECORD_DISABLE_S 4 +#define DPORT_PRO_CPU_RECORD_ENABLE (BIT(0)) +#define DPORT_PRO_CPU_RECORD_ENABLE_S 0 + +#define PRO_CPU_RECORD_STATUS (DR_REG_DPORT_BASE + 0x444) +#define DPORT_PRO_CPU_RECORDING (BIT(0)) +#define DPORT_PRO_CPU_RECORDING_S 0 + +#define PRO_CPU_RECORD_PID (DR_REG_DPORT_BASE + 0x448) +#define DPORT_RECORD_PRO_PID 0x00000007 +#define DPORT_RECORD_PRO_PID_S 0 + +#define PRO_CPU_RECORD_PDEBUGINST (DR_REG_DPORT_BASE + 0x44C) +#define DPORT_RECORD_PRO_PDEBUGINST 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGINST_S 0 + +#define PRO_CPU_RECORD_PDEBUGSTATUS (DR_REG_DPORT_BASE + 0x450) +#define DPORT_RECORD_PRO_PDEBUGSTATUS 0x000000FF +#define DPORT_RECORD_PRO_PDEBUGSTATUS_S 0 + +#define PRO_CPU_RECORD_PDEBUGDATA (DR_REG_DPORT_BASE + 0x454) +#define DPORT_RECORD_PRO_PDEBUGDATA 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGDATA_S 0 + +#define PRO_CPU_RECORD_PDEBUGPC (DR_REG_DPORT_BASE + 0x458) +#define DPORT_RECORD_PRO_PDEBUGPC 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGPC_S 0 + +#define PRO_CPU_RECORD_PDEBUGLS0STAT (DR_REG_DPORT_BASE + 0x45C) +#define DPORT_RECORD_PRO_PDEBUGLS0STAT 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGLS0STAT_S 0 + +#define PRO_CPU_RECORD_PDEBUGLS0ADDR (DR_REG_DPORT_BASE + 0x460) +#define DPORT_RECORD_PRO_PDEBUGLS0ADDR 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGLS0ADDR_S 0 + +#define PRO_CPU_RECORD_PDEBUGLS0DATA (DR_REG_DPORT_BASE + 0x464) +#define DPORT_RECORD_PRO_PDEBUGLS0DATA 0xFFFFFFFF +#define DPORT_RECORD_PRO_PDEBUGLS0DATA_S 0 + +#define APP_CPU_RECORD_CTRL (DR_REG_DPORT_BASE + 0x468) +#define DPORT_APP_CPU_PDEBUG_ENABLE (BIT(8)) +#define DPORT_APP_CPU_PDEBUG_ENABLE_S 8 +#define DPORT_APP_CPU_RECORD_DISABLE (BIT(4)) +#define DPORT_APP_CPU_RECORD_DISABLE_S 4 +#define DPORT_APP_CPU_RECORD_ENABLE (BIT(0)) +#define DPORT_APP_CPU_RECORD_ENABLE_S 0 + +#define APP_CPU_RECORD_STATUS (DR_REG_DPORT_BASE + 0x46C) +#define DPORT_APP_CPU_RECORDING (BIT(0)) +#define DPORT_APP_CPU_RECORDING_S 0 + +#define APP_CPU_RECORD_PID (DR_REG_DPORT_BASE + 0x470) +#define DPORT_RECORD_APP_PID 0x00000007 +#define DPORT_RECORD_APP_PID_S 0 + +#define APP_CPU_RECORD_PDEBUGINST (DR_REG_DPORT_BASE + 0x474) +#define DPORT_RECORD_APP_PDEBUGINST 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGINST_S 0 + +#define APP_CPU_RECORD_PDEBUGSTATUS (DR_REG_DPORT_BASE + 0x478) +#define DPORT_RECORD_APP_PDEBUGSTATUS 0x000000FF +#define DPORT_RECORD_APP_PDEBUGSTATUS_S 0 + +#define APP_CPU_RECORD_PDEBUGDATA (DR_REG_DPORT_BASE + 0x47C) +#define DPORT_RECORD_APP_PDEBUGDATA 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGDATA_S 0 + +#define APP_CPU_RECORD_PDEBUGPC (DR_REG_DPORT_BASE + 0x480) +#define DPORT_RECORD_APP_PDEBUGPC 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGPC_S 0 + +#define APP_CPU_RECORD_PDEBUGLS0STAT (DR_REG_DPORT_BASE + 0x484) +#define DPORT_RECORD_APP_PDEBUGLS0STAT 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGLS0STAT_S 0 + +#define APP_CPU_RECORD_PDEBUGLS0ADDR (DR_REG_DPORT_BASE + 0x488) +#define DPORT_RECORD_APP_PDEBUGLS0ADDR 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGLS0ADDR_S 0 + +#define APP_CPU_RECORD_PDEBUGLS0DATA (DR_REG_DPORT_BASE + 0x48C) +#define DPORT_RECORD_APP_PDEBUGLS0DATA 0xFFFFFFFF +#define DPORT_RECORD_APP_PDEBUGLS0DATA_S 0 + +#define RSA_PD_CTRL_REG (DR_REG_DPORT_BASE + 0x490) +#define DPORT_RSA_PD (BIT(0)) +#define DPORT_RSA_PD_S 0 + +#define ROM_MPU_TABLE0 (DR_REG_DPORT_BASE + 0x494) +#define DPORT_ROM_MPU_TABLE0 0x00000003 +#define DPORT_ROM_MPU_TABLE0_S 0 + +#define ROM_MPU_TABLE1 (DR_REG_DPORT_BASE + 0x498) +#define DPORT_ROM_MPU_TABLE1 0x00000003 +#define DPORT_ROM_MPU_TABLE1_S 0 + +#define ROM_MPU_TABLE2 (DR_REG_DPORT_BASE + 0x49C) +#define DPORT_ROM_MPU_TABLE2 0x00000003 +#define DPORT_ROM_MPU_TABLE2_S 0 + +#define ROM_MPU_TABLE3 (DR_REG_DPORT_BASE + 0x4A0) +#define DPORT_ROM_MPU_TABLE3 0x00000003 +#define DPORT_ROM_MPU_TABLE3_S 0 + +#define SHROM_MPU_TABLE0 (DR_REG_DPORT_BASE + 0x4A4) +#define DPORT_SHROM_MPU_TABLE0 0x00000003 +#define DPORT_SHROM_MPU_TABLE0_S 0 + +#define SHROM_MPU_TABLE1 (DR_REG_DPORT_BASE + 0x4A8) +#define DPORT_SHROM_MPU_TABLE1 0x00000003 +#define DPORT_SHROM_MPU_TABLE1_S 0 + +#define SHROM_MPU_TABLE2 (DR_REG_DPORT_BASE + 0x4AC) +#define DPORT_SHROM_MPU_TABLE2 0x00000003 +#define DPORT_SHROM_MPU_TABLE2_S 0 + +#define SHROM_MPU_TABLE3 (DR_REG_DPORT_BASE + 0x4B0) +#define DPORT_SHROM_MPU_TABLE3 0x00000003 +#define DPORT_SHROM_MPU_TABLE3_S 0 + +#define SHROM_MPU_TABLE4 (DR_REG_DPORT_BASE + 0x4B4) +#define DPORT_SHROM_MPU_TABLE4 0x00000003 +#define DPORT_SHROM_MPU_TABLE4_S 0 + +#define SHROM_MPU_TABLE5 (DR_REG_DPORT_BASE + 0x4B8) +#define DPORT_SHROM_MPU_TABLE5 0x00000003 +#define DPORT_SHROM_MPU_TABLE5_S 0 + +#define SHROM_MPU_TABLE6 (DR_REG_DPORT_BASE + 0x4BC) +#define DPORT_SHROM_MPU_TABLE6 0x00000003 +#define DPORT_SHROM_MPU_TABLE6_S 0 + +#define SHROM_MPU_TABLE7 (DR_REG_DPORT_BASE + 0x4C0) +#define DPORT_SHROM_MPU_TABLE7 0x00000003 +#define DPORT_SHROM_MPU_TABLE7_S 0 + +#define SHROM_MPU_TABLE8 (DR_REG_DPORT_BASE + 0x4C4) +#define DPORT_SHROM_MPU_TABLE8 0x00000003 +#define DPORT_SHROM_MPU_TABLE8_S 0 + +#define SHROM_MPU_TABLE9 (DR_REG_DPORT_BASE + 0x4C8) +#define DPORT_SHROM_MPU_TABLE9 0x00000003 +#define DPORT_SHROM_MPU_TABLE9_S 0 + +#define SHROM_MPU_TABLE10 (DR_REG_DPORT_BASE + 0x4CC) +#define DPORT_SHROM_MPU_TABLE10 0x00000003 +#define DPORT_SHROM_MPU_TABLE10_S 0 + +#define SHROM_MPU_TABLE11 (DR_REG_DPORT_BASE + 0x4D0) +#define DPORT_SHROM_MPU_TABLE11 0x00000003 +#define DPORT_SHROM_MPU_TABLE11_S 0 + +#define SHROM_MPU_TABLE12 (DR_REG_DPORT_BASE + 0x4D4) +#define DPORT_SHROM_MPU_TABLE12 0x00000003 +#define DPORT_SHROM_MPU_TABLE12_S 0 + +#define SHROM_MPU_TABLE13 (DR_REG_DPORT_BASE + 0x4D8) +#define DPORT_SHROM_MPU_TABLE13 0x00000003 +#define DPORT_SHROM_MPU_TABLE13_S 0 + +#define SHROM_MPU_TABLE14 (DR_REG_DPORT_BASE + 0x4DC) +#define DPORT_SHROM_MPU_TABLE14 0x00000003 +#define DPORT_SHROM_MPU_TABLE14_S 0 + +#define SHROM_MPU_TABLE15 (DR_REG_DPORT_BASE + 0x4E0) +#define DPORT_SHROM_MPU_TABLE15 0x00000003 +#define DPORT_SHROM_MPU_TABLE15_S 0 + +#define SHROM_MPU_TABLE16 (DR_REG_DPORT_BASE + 0x4E4) +#define DPORT_SHROM_MPU_TABLE16 0x00000003 +#define DPORT_SHROM_MPU_TABLE16_S 0 + +#define SHROM_MPU_TABLE17 (DR_REG_DPORT_BASE + 0x4E8) +#define DPORT_SHROM_MPU_TABLE17 0x00000003 +#define DPORT_SHROM_MPU_TABLE17_S 0 + +#define SHROM_MPU_TABLE18 (DR_REG_DPORT_BASE + 0x4EC) +#define DPORT_SHROM_MPU_TABLE18 0x00000003 +#define DPORT_SHROM_MPU_TABLE18_S 0 + +#define SHROM_MPU_TABLE19 (DR_REG_DPORT_BASE + 0x4F0) +#define DPORT_SHROM_MPU_TABLE19 0x00000003 +#define DPORT_SHROM_MPU_TABLE19_S 0 + +#define SHROM_MPU_TABLE20 (DR_REG_DPORT_BASE + 0x4F4) +#define DPORT_SHROM_MPU_TABLE20 0x00000003 +#define DPORT_SHROM_MPU_TABLE20_S 0 + +#define SHROM_MPU_TABLE21 (DR_REG_DPORT_BASE + 0x4F8) +#define DPORT_SHROM_MPU_TABLE21 0x00000003 +#define DPORT_SHROM_MPU_TABLE21_S 0 + +#define SHROM_MPU_TABLE22 (DR_REG_DPORT_BASE + 0x4FC) +#define DPORT_SHROM_MPU_TABLE22 0x00000003 +#define DPORT_SHROM_MPU_TABLE22_S 0 + +#define SHROM_MPU_TABLE23 (DR_REG_DPORT_BASE + 0x500) +#define DPORT_SHROM_MPU_TABLE23 0x00000003 +#define DPORT_SHROM_MPU_TABLE23_S 0 + +#define IMMU_TABLE0 (DR_REG_DPORT_BASE + 0x504) +#define DPORT_IMMU_TABLE0 0x0000007F +#define DPORT_IMMU_TABLE0_S 0 + +#define IMMU_TABLE1 (DR_REG_DPORT_BASE + 0x508) +#define DPORT_IMMU_TABLE1 0x0000007F +#define DPORT_IMMU_TABLE1_S 0 + +#define IMMU_TABLE2 (DR_REG_DPORT_BASE + 0x50C) +#define DPORT_IMMU_TABLE2 0x0000007F +#define DPORT_IMMU_TABLE2_S 0 + +#define IMMU_TABLE3 (DR_REG_DPORT_BASE + 0x510) +#define DPORT_IMMU_TABLE3 0x0000007F +#define DPORT_IMMU_TABLE3_S 0 + +#define IMMU_TABLE4 (DR_REG_DPORT_BASE + 0x514) +#define DPORT_IMMU_TABLE4 0x0000007F +#define DPORT_IMMU_TABLE4_S 0 + +#define IMMU_TABLE5 (DR_REG_DPORT_BASE + 0x518) +#define DPORT_IMMU_TABLE5 0x0000007F +#define DPORT_IMMU_TABLE5_S 0 + +#define IMMU_TABLE6 (DR_REG_DPORT_BASE + 0x51C) +#define DPORT_IMMU_TABLE6 0x0000007F +#define DPORT_IMMU_TABLE6_S 0 + +#define IMMU_TABLE7 (DR_REG_DPORT_BASE + 0x520) +#define DPORT_IMMU_TABLE7 0x0000007F +#define DPORT_IMMU_TABLE7_S 0 + +#define IMMU_TABLE8 (DR_REG_DPORT_BASE + 0x524) +#define DPORT_IMMU_TABLE8 0x0000007F +#define DPORT_IMMU_TABLE8_S 0 + +#define IMMU_TABLE9 (DR_REG_DPORT_BASE + 0x528) +#define DPORT_IMMU_TABLE9 0x0000007F +#define DPORT_IMMU_TABLE9_S 0 + +#define IMMU_TABLE10 (DR_REG_DPORT_BASE + 0x52C) +#define DPORT_IMMU_TABLE10 0x0000007F +#define DPORT_IMMU_TABLE10_S 0 + +#define IMMU_TABLE11 (DR_REG_DPORT_BASE + 0x530) +#define DPORT_IMMU_TABLE11 0x0000007F +#define DPORT_IMMU_TABLE11_S 0 + +#define IMMU_TABLE12 (DR_REG_DPORT_BASE + 0x534) +#define DPORT_IMMU_TABLE12 0x0000007F +#define DPORT_IMMU_TABLE12_S 0 + +#define IMMU_TABLE13 (DR_REG_DPORT_BASE + 0x538) +#define DPORT_IMMU_TABLE13 0x0000007F +#define DPORT_IMMU_TABLE13_S 0 + +#define IMMU_TABLE14 (DR_REG_DPORT_BASE + 0x53C) +#define DPORT_IMMU_TABLE14 0x0000007F +#define DPORT_IMMU_TABLE14_S 0 + +#define IMMU_TABLE15 (DR_REG_DPORT_BASE + 0x540) +#define DPORT_IMMU_TABLE15 0x0000007F +#define DPORT_IMMU_TABLE15_S 0 + +#define DMMU_TABLE0 (DR_REG_DPORT_BASE + 0x544) +#define DPORT_DMMU_TABLE0 0x0000007F +#define DPORT_DMMU_TABLE0_S 0 + +#define DMMU_TABLE1 (DR_REG_DPORT_BASE + 0x548) +#define DPORT_DMMU_TABLE1 0x0000007F +#define DPORT_DMMU_TABLE1_S 0 + +#define DMMU_TABLE2 (DR_REG_DPORT_BASE + 0x54C) +#define DPORT_DMMU_TABLE2 0x0000007F +#define DPORT_DMMU_TABLE2_S 0 + +#define DMMU_TABLE3 (DR_REG_DPORT_BASE + 0x550) +#define DPORT_DMMU_TABLE3 0x0000007F +#define DPORT_DMMU_TABLE3_S 0 + +#define DMMU_TABLE4 (DR_REG_DPORT_BASE + 0x554) +#define DPORT_DMMU_TABLE4 0x0000007F +#define DPORT_DMMU_TABLE4_S 0 + +#define DMMU_TABLE5 (DR_REG_DPORT_BASE + 0x558) +#define DPORT_DMMU_TABLE5 0x0000007F +#define DPORT_DMMU_TABLE5_S 0 + +#define DMMU_TABLE6 (DR_REG_DPORT_BASE + 0x55C) +#define DPORT_DMMU_TABLE6 0x0000007F +#define DPORT_DMMU_TABLE6_S 0 + +#define DMMU_TABLE7 (DR_REG_DPORT_BASE + 0x560) +#define DPORT_DMMU_TABLE7 0x0000007F +#define DPORT_DMMU_TABLE7_S 0 + +#define DMMU_TABLE8 (DR_REG_DPORT_BASE + 0x564) +#define DPORT_DMMU_TABLE8 0x0000007F +#define DPORT_DMMU_TABLE8_S 0 + +#define DMMU_TABLE9 (DR_REG_DPORT_BASE + 0x568) +#define DPORT_DMMU_TABLE9 0x0000007F +#define DPORT_DMMU_TABLE9_S 0 + +#define DMMU_TABLE10 (DR_REG_DPORT_BASE + 0x56C) +#define DPORT_DMMU_TABLE10 0x0000007F +#define DPORT_DMMU_TABLE10_S 0 + +#define DMMU_TABLE11 (DR_REG_DPORT_BASE + 0x570) +#define DPORT_DMMU_TABLE11 0x0000007F +#define DPORT_DMMU_TABLE11_S 0 + +#define DMMU_TABLE12 (DR_REG_DPORT_BASE + 0x574) +#define DPORT_DMMU_TABLE12 0x0000007F +#define DPORT_DMMU_TABLE12_S 0 + +#define DMMU_TABLE13 (DR_REG_DPORT_BASE + 0x578) +#define DPORT_DMMU_TABLE13 0x0000007F +#define DPORT_DMMU_TABLE13_S 0 + +#define DMMU_TABLE14 (DR_REG_DPORT_BASE + 0x57C) +#define DPORT_DMMU_TABLE14 0x0000007F +#define DPORT_DMMU_TABLE14_S 0 + +#define DMMU_TABLE15 (DR_REG_DPORT_BASE + 0x580) +#define DPORT_DMMU_TABLE15 0x0000007F +#define DPORT_DMMU_TABLE15_S 0 + +#define PRO_INTRUSION_CTRL (DR_REG_DPORT_BASE + 0x584) +#define DPORT_PRO_INTRUSION_RECORD_RESET_N (BIT(0)) +#define DPORT_PRO_INTRUSION_RECORD_RESET_N_S 0 + +#define PRO_INTRUSION_STATUS (DR_REG_DPORT_BASE + 0x588) +#define DPORT_PRO_INTRUSION_RECORD 0x0000000F +#define DPORT_PRO_INTRUSION_RECORD_S 0 + +#define APP_INTRUSION_CTRL (DR_REG_DPORT_BASE + 0x58C) +#define DPORT_APP_INTRUSION_RECORD_RESET_N (BIT(0)) +#define DPORT_APP_INTRUSION_RECORD_RESET_N_S 0 + +#define APP_INTRUSION_STATUS (DR_REG_DPORT_BASE + 0x590) +#define DPORT_APP_INTRUSION_RECORD 0x0000000F +#define DPORT_APP_INTRUSION_RECORD_S 0 + +#define FRONT_END_MEM_PD (DR_REG_DPORT_BASE + 0x594) +#define DPORT_PBUS_MEM_FORCE_PD (BIT(3)) +#define DPORT_PBUS_MEM_FORCE_PD_S 3 +#define DPORT_PBUS_MEM_FORCE_PU (BIT(2)) +#define DPORT_PBUS_MEM_FORCE_PU_S 2 +#define DPORT_AGC_MEM_FORCE_PD (BIT(1)) +#define DPORT_AGC_MEM_FORCE_PD_S 1 +#define DPORT_AGC_MEM_FORCE_PU (BIT(0)) +#define DPORT_AGC_MEM_FORCE_PU_S 0 + +#define MMU_IA_INT_EN (DR_REG_DPORT_BASE + 0x598) +#define DPORT_MMU_IA_INT_EN 0x00FFFFFF +#define DPORT_MMU_IA_INT_EN_S 0 + +#define MPU_IA_INT_EN (DR_REG_DPORT_BASE + 0x59C) +#define DPORT_MPU_IA_INT_EN 0x0001FFFF +#define DPORT_MPU_IA_INT_EN_S 0 + +#define CACHE_IA_INT_EN (DR_REG_DPORT_BASE + 0x5A0) +#define DPORT_CACHE_IA_INT_EN 0x0FFFFFFF +#define DPORT_CACHE_IA_INT_EN_S 0 + +#define SECURE_BOOT_CTRL (DR_REG_DPORT_BASE + 0x5A4) +#define DPORT_SW_BOOTLOADER_SEL (BIT(0)) +#define DPORT_SW_BOOTLOADER_SEL_S 0 + +#define SPI_DMA_CHAN_SEL (DR_REG_DPORT_BASE + 0x5A8) +#define DPORT_SPI3_DMA_CHAN_SEL 0x00000003 +#define DPORT_SPI3_DMA_CHAN_SEL_S 4 +#define DPORT_SPI2_DMA_CHAN_SEL 0x00000003 +#define DPORT_SPI2_DMA_CHAN_SEL_S 2 +#define DPORT_SPI1_DMA_CHAN_SEL 0x00000003 +#define DPORT_SPI1_DMA_CHAN_SEL_S 0 + +#define PRO_VECBASE_CTRL (DR_REG_DPORT_BASE + 0x5AC) +#define DPORT_PRO_OUT_VECBASE_SEL 0x00000003 +#define DPORT_PRO_OUT_VECBASE_SEL_S 0 + +#define PRO_VECBASE_SET (DR_REG_DPORT_BASE + 0x5B0) +#define DPORT_PRO_OUT_VECBASE_REG 0x003FFFFF +#define DPORT_PRO_OUT_VECBASE_REG_S 0 + +#define APP_VECBASE_CTRL (DR_REG_DPORT_BASE + 0x5B4) +#define DPORT_APP_OUT_VECBASE_SEL 0x00000003 +#define DPORT_APP_OUT_VECBASE_SEL_S 0 + +#define APP_VECBASE_SET (DR_REG_DPORT_BASE + 0x5B8) +#define DPORT_APP_OUT_VECBASE_REG 0x003FFFFF +#define DPORT_APP_OUT_VECBASE_REG_S 0 + +#define DPORT_REG_DATE (DR_REG_DPORT_BASE + 0xFFC) +#define DPORT_DPORT_DATE 0x0FFFFFFF +#define DPORT_DPORT_DATE_S 0 +#define DPORT_DPORT_DATE_VERSION 0x1605190 + +#endif /* _SOC_DPORT_REG_H_ */ diff --git a/components/esp32/include/soc/efuse_reg.h b/components/esp32/include/soc/efuse_reg.h new file mode 100644 index 000000000..85a6361f2 --- /dev/null +++ b/components/esp32/include/soc/efuse_reg.h @@ -0,0 +1,422 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_EFUSE_REG_H_ +#define _SOC_EFUSE_REG_H_ + +#include "soc.h" + +#define EFUSE_BLK0_RDATA0 (DR_REG_EFUSE_BASE + 0x000) +#define EFUSE_RD_FLASH_CRYPT_CNT 0x000000FF +#define EFUSE_RD_FLASH_CRYPT_CNT_S 20 +#define EFUSE_RD_EFUSE_RD_DIS 0x0000000F +#define EFUSE_RD_EFUSE_RD_DIS_S 16 +#define EFUSE_RD_EFUSE_WR_DIS 0x0000FFFF +#define EFUSE_RD_EFUSE_WR_DIS_S 0 + +#define EFUSE_BLK0_RDATA1 (DR_REG_EFUSE_BASE + 0x004) +#define EFUSE_RD_WIFI_MAC_CRC_LOW 0xFFFFFFFF +#define EFUSE_RD_WIFI_MAC_CRC_LOW_S 0 + +#define EFUSE_BLK0_RDATA2 (DR_REG_EFUSE_BASE + 0x008) +#define EFUSE_RD_WIFI_MAC_CRC_HIGH 0x00FFFFFF +#define EFUSE_RD_WIFI_MAC_CRC_HIGH_S 0 + +#define EFUSE_BLK0_RDATA3 (DR_REG_EFUSE_BASE + 0x00c) +#define EFUSE_RD_CHIP_VER_RESERVE 0x00001FFF +#define EFUSE_RD_CHIP_VER_RESERVE_S 4 +#define EFUSE_RD_CHIP_VER_DIS_CACHE (BIT(3)) +#define EFUSE_RD_CHIP_VER_DIS_CACHE_S 3 +#define EFUSE_RD_CHIP_VER_32PAD (BIT(2)) +#define EFUSE_RD_CHIP_VER_32PAD_S 2 +#define EFUSE_RD_CHIP_VER_DIS_BT (BIT(1)) +#define EFUSE_RD_CHIP_VER_DIS_BT_S 1 +#define EFUSE_RD_CHIP_VER_DIS_APP_CPU (BIT(0)) +#define EFUSE_RD_CHIP_VER_DIS_APP_CPU_S 0 + +#define EFUSE_BLK0_RDATA4 (DR_REG_EFUSE_BASE + 0x010) +#define EFUSE_RD_SDIO_FORCE (BIT(16)) +#define EFUSE_RD_SDIO_FORCE_S 16 +#define EFUSE_RD_SDIO_TIEH (BIT(15)) +#define EFUSE_RD_SDIO_TIEH_S 15 +#define EFUSE_RD_XPD_SDIO_REG (BIT(14)) +#define EFUSE_RD_XPD_SDIO_REG_S 14 +#define EFUSE_RD_SDIO_DREFL 0x00000003 +#define EFUSE_RD_SDIO_DREFL_S 12 +#define EFUSE_RD_SDIO_DREFM 0x00000003 +#define EFUSE_RD_SDIO_DREFM_S 10 +#define EFUSE_RD_SDIO_DREFH 0x00000003 +#define EFUSE_RD_SDIO_DREFH_S 8 +#define EFUSE_RD_CK8M_FREQ 0x000000FF +#define EFUSE_RD_CK8M_FREQ_S 0 + +#define EFUSE_BLK0_RDATA5 (DR_REG_EFUSE_BASE + 0x014) +#define EFUSE_RD_FLASH_CRYPT_CONFIG 0x0000000F +#define EFUSE_RD_FLASH_CRYPT_CONFIG_S 28 +#define EFUSE_RD_INST_CONFIG 0x000000FF +#define EFUSE_RD_INST_CONFIG_S 20 +#define EFUSE_RD_SPI_PAD_CONFIG 0x000FFFFF +#define EFUSE_RD_SPI_PAD_CONFIG_S 0 + +#define EFUSE_BLK0_RDATA6 (DR_REG_EFUSE_BASE + 0x018) +#define EFUSE_RD_KEY_STATUS (BIT(10)) +#define EFUSE_RD_KEY_STATUS_S 10 +#define EFUSE_RD_DISABLE_DL_CACHE (BIT(9)) +#define EFUSE_RD_DISABLE_DL_CACHE_S 9 +#define EFUSE_RD_DISABLE_DL_DECRYPT (BIT(8)) +#define EFUSE_RD_DISABLE_DL_DECRYPT_S 8 +#define EFUSE_RD_DISABLE_DL_ENCRYPT (BIT(7)) +#define EFUSE_RD_DISABLE_DL_ENCRYPT_S 7 +#define EFUSE_RD_DISABLE_JTAG (BIT(6)) +#define EFUSE_RD_DISABLE_JTAG_S 6 +#define EFUSE_RD_ABS_DONE_1 (BIT(5)) +#define EFUSE_RD_ABS_DONE_1_S 5 +#define EFUSE_RD_ABS_DONE_0 (BIT(4)) +#define EFUSE_RD_ABS_DONE_0_S 4 +#define EFUSE_RD_DISABLE_SDIO_HOST (BIT(3)) +#define EFUSE_RD_DISABLE_SDIO_HOST_S 3 +#define EFUSE_RD_DIG_RESERVE (BIT(2)) +#define EFUSE_RD_DIG_RESERVE_S 2 +#define EFUSE_RD_CODING_SCHEME 0x00000003 +#define EFUSE_RD_CODING_SCHEME_S 0 + +#define EFUSE_BLK0_WDATA0 (DR_REG_EFUSE_BASE + 0x01c) +#define EFUSE_FLASH_CRYPT_CNT 0x000000FF +#define EFUSE_FLASH_CRYPT_CNT_S 20 +#define EFUSE_EFUSE_RD_DIS 0x0000000F +#define EFUSE_EFUSE_RD_DIS_S 16 +#define EFUSE_EFUSE_WR_DIS 0x0000FFFF +#define EFUSE_EFUSE_WR_DIS_S 0 + +#define EFUSE_BLK0_WDATA1 (DR_REG_EFUSE_BASE + 0x020) +#define EFUSE_WIFI_MAC_CRC_LOW 0xFFFFFFFF +#define EFUSE_WIFI_MAC_CRC_LOW_S 0 + +#define EFUSE_BLK0_WDATA2 (DR_REG_EFUSE_BASE + 0x024) +#define EFUSE_WIFI_MAC_CRC_HIGH 0x00FFFFFF +#define EFUSE_WIFI_MAC_CRC_HIGH_S 0 + +#define EFUSE_BLK0_WDATA3 (DR_REG_EFUSE_BASE + 0x028) +#define EFUSE_CHIP_VER_RESERVE 0x00001FFF +#define EFUSE_CHIP_VER_RESERVE_S 4 +#define EFUSE_CHIP_VER_DIS_CACHE (BIT(3)) +#define EFUSE_CHIP_VER_DIS_CACHE_S 3 +#define EFUSE_CHIP_VER_32PAD (BIT(2)) +#define EFUSE_CHIP_VER_32PAD_S 2 +#define EFUSE_CHIP_VER_DIS_BT (BIT(1)) +#define EFUSE_CHIP_VER_DIS_BT_S 1 +#define EFUSE_CHIP_VER_DIS_APP_CPU (BIT(0)) +#define EFUSE_CHIP_VER_DIS_APP_CPU_S 0 + +#define EFUSE_BLK0_WDATA4 (DR_REG_EFUSE_BASE + 0x02c) +#define EFUSE_SDIO_FORCE (BIT(16)) +#define EFUSE_SDIO_FORCE_S 16 +#define EFUSE_SDIO_TIEH (BIT(15)) +#define EFUSE_SDIO_TIEH_S 15 +#define EFUSE_XPD_SDIO_REG (BIT(14)) +#define EFUSE_XPD_SDIO_REG_S 14 +#define EFUSE_SDIO_DREFL 0x00000003 +#define EFUSE_SDIO_DREFL_S 12 +#define EFUSE_SDIO_DREFM 0x00000003 +#define EFUSE_SDIO_DREFM_S 10 +#define EFUSE_SDIO_DREFH 0x00000003 +#define EFUSE_SDIO_DREFH_S 8 +#define EFUSE_CK8M_FREQ 0x000000FF +#define EFUSE_CK8M_FREQ_S 0 + +#define EFUSE_BLK0_WDATA5 (DR_REG_EFUSE_BASE + 0x030) +#define EFUSE_FLASH_CRYPT_CONFIG 0x0000000F +#define EFUSE_FLASH_CRYPT_CONFIG_S 28 +#define EFUSE_INST_CONFIG 0x000000FF +#define EFUSE_INST_CONFIG_S 20 +#define EFUSE_SPI_PAD_CONFIG 0x000FFFFF +#define EFUSE_SPI_PAD_CONFIG_S 0 + +#define EFUSE_BLK0_WDATA6 (DR_REG_EFUSE_BASE + 0x034) +#define EFUSE_KEY_STATUS (BIT(10)) +#define EFUSE_KEY_STATUS_S 10 +#define EFUSE_DISABLE_DL_CACHE (BIT(9)) +#define EFUSE_DISABLE_DL_CACHE_S 9 +#define EFUSE_DISABLE_DL_DECRYPT (BIT(8)) +#define EFUSE_DISABLE_DL_DECRYPT_S 8 +#define EFUSE_DISABLE_DL_ENCRYPT (BIT(7)) +#define EFUSE_DISABLE_DL_ENCRYPT_S 7 +#define EFUSE_DISABLE_JTAG (BIT(6)) +#define EFUSE_DISABLE_JTAG_S 6 +#define EFUSE_ABS_DONE_1 (BIT(5)) +#define EFUSE_ABS_DONE_1_S 5 +#define EFUSE_ABS_DONE_0 (BIT(4)) +#define EFUSE_ABS_DONE_0_S 4 +#define EFUSE_DISABLE_SDIO_HOST (BIT(3)) +#define EFUSE_DISABLE_SDIO_HOST_S 3 +#define EFUSE_DIG_RESERVE (BIT(2)) +#define EFUSE_DIG_RESERVE_S 2 +#define EFUSE_CODING_SCHEME 0x00000003 +#define EFUSE_CODING_SCHEME_S 0 + +#define EFUSE_BLK1_RDATA0 (DR_REG_EFUSE_BASE + 0x038) +#define EFUSE_EFUSE_BLK1_DOUT0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT0_S 0 + +#define EFUSE_BLK1_RDATA1 (DR_REG_EFUSE_BASE + 0x03c) +#define EFUSE_EFUSE_BLK1_DOUT1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT1_S 0 + +#define EFUSE_BLK1_RDATA2 (DR_REG_EFUSE_BASE + 0x040) +#define EFUSE_EFUSE_BLK1_DOUT2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT2_S 0 + +#define EFUSE_BLK1_RDATA3 (DR_REG_EFUSE_BASE + 0x044) +#define EFUSE_EFUSE_BLK1_DOUT3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT3_S 0 + +#define EFUSE_BLK1_RDATA4 (DR_REG_EFUSE_BASE + 0x048) +#define EFUSE_EFUSE_BLK1_DOUT4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT4_S 0 + +#define EFUSE_BLK1_RDATA5 (DR_REG_EFUSE_BASE + 0x04c) +#define EFUSE_EFUSE_BLK1_DOUT5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT5_S 0 + +#define EFUSE_BLK1_RDATA6 (DR_REG_EFUSE_BASE + 0x050) +#define EFUSE_EFUSE_BLK1_DOUT6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT6_S 0 + +#define EFUSE_BLK1_RDATA7 (DR_REG_EFUSE_BASE + 0x054) +#define EFUSE_EFUSE_BLK1_DOUT7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DOUT7_S 0 + +#define EFUSE_BLK2_RDATA0 (DR_REG_EFUSE_BASE + 0x058) +#define EFUSE_EFUSE_BLK2_DOUT0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT0_S 0 + +#define EFUSE_BLK2_RDATA1 (DR_REG_EFUSE_BASE + 0x05c) +#define EFUSE_EFUSE_BLK2_DOUT1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT1_S 0 + +#define EFUSE_BLK2_RDATA2 (DR_REG_EFUSE_BASE + 0x060) +#define EFUSE_EFUSE_BLK2_DOUT2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT2_S 0 + +#define EFUSE_BLK2_RDATA3 (DR_REG_EFUSE_BASE + 0x064) +#define EFUSE_EFUSE_BLK2_DOUT3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT3_S 0 + +#define EFUSE_BLK2_RDATA4 (DR_REG_EFUSE_BASE + 0x068) +#define EFUSE_EFUSE_BLK2_DOUT4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT4_S 0 + +#define EFUSE_BLK2_RDATA5 (DR_REG_EFUSE_BASE + 0x06c) +#define EFUSE_EFUSE_BLK2_DOUT5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT5_S 0 + +#define EFUSE_BLK2_RDATA6 (DR_REG_EFUSE_BASE + 0x070) +#define EFUSE_EFUSE_BLK2_DOUT6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT6_S 0 + +#define EFUSE_BLK2_RDATA7 (DR_REG_EFUSE_BASE + 0x074) +#define EFUSE_EFUSE_BLK2_DOUT7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DOUT7_S 0 + +#define EFUSE_BLK3_RDATA0 (DR_REG_EFUSE_BASE + 0x078) +#define EFUSE_EFUSE_BLK3_DOUT0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT0_S 0 + +#define EFUSE_BLK3_RDATA1 (DR_REG_EFUSE_BASE + 0x07c) +#define EFUSE_EFUSE_BLK3_DOUT1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT1_S 0 + +#define EFUSE_BLK3_RDATA2 (DR_REG_EFUSE_BASE + 0x080) +#define EFUSE_EFUSE_BLK3_DOUT2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT2_S 0 + +#define EFUSE_BLK3_RDATA3 (DR_REG_EFUSE_BASE + 0x084) +#define EFUSE_EFUSE_BLK3_DOUT3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT3_S 0 + +#define EFUSE_BLK3_RDATA4 (DR_REG_EFUSE_BASE + 0x088) +#define EFUSE_EFUSE_BLK3_DOUT4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT4_S 0 + +#define EFUSE_BLK3_RDATA5 (DR_REG_EFUSE_BASE + 0x08c) +#define EFUSE_EFUSE_BLK3_DOUT5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT5_S 0 + +#define EFUSE_BLK3_RDATA6 (DR_REG_EFUSE_BASE + 0x090) +#define EFUSE_EFUSE_BLK3_DOUT6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT6_S 0 + +#define EFUSE_BLK3_RDATA7 (DR_REG_EFUSE_BASE + 0x094) +#define EFUSE_EFUSE_BLK3_DOUT7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DOUT7_S 0 + +#define EFUSE_BLK1_WDATA0 (DR_REG_EFUSE_BASE + 0x098) +#define EFUSE_EFUSE_BLK1_DIN0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN0_S 0 + +#define EFUSE_BLK1_WDATA1 (DR_REG_EFUSE_BASE + 0x09c) +#define EFUSE_EFUSE_BLK1_DIN1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN1_S 0 + +#define EFUSE_BLK1_WDATA2 (DR_REG_EFUSE_BASE + 0x0a0) +#define EFUSE_EFUSE_BLK1_DIN2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN2_S 0 + +#define EFUSE_BLK1_WDATA3 (DR_REG_EFUSE_BASE + 0x0a4) +#define EFUSE_EFUSE_BLK1_DIN3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN3_S 0 + +#define EFUSE_BLK1_WDATA4 (DR_REG_EFUSE_BASE + 0x0a8) +#define EFUSE_EFUSE_BLK1_DIN4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN4_S 0 + +#define EFUSE_BLK1_WDATA5 (DR_REG_EFUSE_BASE + 0x0ac) +#define EFUSE_EFUSE_BLK1_DIN5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN5_S 0 + +#define EFUSE_BLK1_WDATA6 (DR_REG_EFUSE_BASE + 0x0b0) +#define EFUSE_EFUSE_BLK1_DIN6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN6_S 0 + +#define EFUSE_BLK1_WDATA7 (DR_REG_EFUSE_BASE + 0x0b4) +#define EFUSE_EFUSE_BLK1_DIN7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK1_DIN7_S 0 + +#define EFUSE_BLK2_WDATA0 (DR_REG_EFUSE_BASE + 0x0b8) +#define EFUSE_EFUSE_BLK2_DIN0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN0_S 0 + +#define EFUSE_BLK2_WDATA1 (DR_REG_EFUSE_BASE + 0x0bc) +#define EFUSE_EFUSE_BLK2_DIN1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN1_S 0 + +#define EFUSE_BLK2_WDATA2 (DR_REG_EFUSE_BASE + 0x0c0) +#define EFUSE_EFUSE_BLK2_DIN2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN2_S 0 + +#define EFUSE_BLK2_WDATA3 (DR_REG_EFUSE_BASE + 0x0c4) +#define EFUSE_EFUSE_BLK2_DIN3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN3_S 0 + +#define EFUSE_BLK2_WDATA4 (DR_REG_EFUSE_BASE + 0x0c8) +#define EFUSE_EFUSE_BLK2_DIN4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN4_S 0 + +#define EFUSE_BLK2_WDATA5 (DR_REG_EFUSE_BASE + 0x0cc) +#define EFUSE_EFUSE_BLK2_DIN5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN5_S 0 + +#define EFUSE_BLK2_WDATA6 (DR_REG_EFUSE_BASE + 0x0d0) +#define EFUSE_EFUSE_BLK2_DIN6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN6_S 0 + +#define EFUSE_BLK2_WDATA7 (DR_REG_EFUSE_BASE + 0x0d4) +#define EFUSE_EFUSE_BLK2_DIN7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK2_DIN7_S 0 + +#define EFUSE_BLK3_WDATA0 (DR_REG_EFUSE_BASE + 0x0d8) +#define EFUSE_EFUSE_BLK3_DIN0 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN0_S 0 + +#define EFUSE_BLK3_WDATA1 (DR_REG_EFUSE_BASE + 0x0dc) +#define EFUSE_EFUSE_BLK3_DIN1 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN1_S 0 + +#define EFUSE_BLK3_WDATA2 (DR_REG_EFUSE_BASE + 0x0e0) +#define EFUSE_EFUSE_BLK3_DIN2 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN2_S 0 + +#define EFUSE_BLK3_WDATA3 (DR_REG_EFUSE_BASE + 0x0e4) +#define EFUSE_EFUSE_BLK3_DIN3 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN3_S 0 + +#define EFUSE_BLK3_WDATA4 (DR_REG_EFUSE_BASE + 0x0e8) +#define EFUSE_EFUSE_BLK3_DIN4 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN4_S 0 + +#define EFUSE_BLK3_WDATA5 (DR_REG_EFUSE_BASE + 0x0ec) +#define EFUSE_EFUSE_BLK3_DIN5 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN5_S 0 + +#define EFUSE_BLK3_WDATA6 (DR_REG_EFUSE_BASE + 0x0f0) +#define EFUSE_EFUSE_BLK3_DIN6 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN6_S 0 + +#define EFUSE_BLK3_WDATA7 (DR_REG_EFUSE_BASE + 0x0f4) +#define EFUSE_EFUSE_BLK3_DIN7 0xFFFFFFFF +#define EFUSE_EFUSE_BLK3_DIN7_S 0 + +#define EFUSE_CLK (DR_REG_EFUSE_BASE + 0x0f8) +#define EFUSE_CLK_EN (BIT(16)) +#define EFUSE_CLK_EN_S 16 +#define EFUSE_EFUSE_CLK_SEL1 0x000000FF +#define EFUSE_EFUSE_CLK_SEL1_S 8 +#define EFUSE_EFUSE_CLK_SEL0 0x000000FF +#define EFUSE_EFUSE_CLK_SEL0_S 0 + +#define EFUSE_CONF (DR_REG_EFUSE_BASE + 0x0fc) +#define EFUSE_EFUSE_FORCE_NO_WR_RD_DIS (BIT(16)) +#define EFUSE_EFUSE_FORCE_NO_WR_RD_DIS_S 16 +#define EFUSE_EFUSE_OP_CODE 0x0000FFFF +#define EFUSE_EFUSE_OP_CODE_S 0 + +#define EFUSE_STATUS (DR_REG_EFUSE_BASE + 0x100) +#define EFUSE_EFUSE_DEBUG 0xFFFFFFFF +#define EFUSE_EFUSE_DEBUG_S 0 + +#define EFUSE_CMD (DR_REG_EFUSE_BASE + 0x104) +#define EFUSE_EFUSE_PGM_CMD (BIT(1)) +#define EFUSE_EFUSE_PGM_CMD_S 1 +#define EFUSE_EFUSE_READ_CMD (BIT(0)) +#define EFUSE_EFUSE_READ_CMD_S 0 + +#define EFUSE_INT_RAW (DR_REG_EFUSE_BASE + 0x108) +#define EFUSE_EFUSE_PGM_DONE_INT_RAW (BIT(1)) +#define EFUSE_EFUSE_PGM_DONE_INT_RAW_S 1 +#define EFUSE_EFUSE_READ_DONE_INT_RAW (BIT(0)) +#define EFUSE_EFUSE_READ_DONE_INT_RAW_S 0 + +#define EFUSE_INT_ST (DR_REG_EFUSE_BASE + 0x10c) +#define EFUSE_EFUSE_PGM_DONE_INT_ST (BIT(1)) +#define EFUSE_EFUSE_PGM_DONE_INT_ST_S 1 +#define EFUSE_EFUSE_READ_DONE_INT_ST (BIT(0)) +#define EFUSE_EFUSE_READ_DONE_INT_ST_S 0 + +#define EFUSE_INT_ENA (DR_REG_EFUSE_BASE + 0x110) +#define EFUSE_EFUSE_PGM_DONE_INT_ENA (BIT(1)) +#define EFUSE_EFUSE_PGM_DONE_INT_ENA_S 1 +#define EFUSE_EFUSE_READ_DONE_INT_ENA (BIT(0)) +#define EFUSE_EFUSE_READ_DONE_INT_ENA_S 0 + +#define EFUSE_INT_CLR (DR_REG_EFUSE_BASE + 0x114) +#define EFUSE_EFUSE_PGM_DONE_INT_CLR (BIT(1)) +#define EFUSE_EFUSE_PGM_DONE_INT_CLR_S 1 +#define EFUSE_EFUSE_READ_DONE_INT_CLR (BIT(0)) +#define EFUSE_EFUSE_READ_DONE_INT_CLR_S 0 + +#define EFUSE_DAC_CONF (DR_REG_EFUSE_BASE + 0x118) +#define EFUSE_EFUSE_DAC_CLK_PAD_SEL (BIT(8)) +#define EFUSE_EFUSE_DAC_CLK_PAD_SEL_S 8 +#define EFUSE_EFUSE_DAC_CLK_DIV 0x000000FF +#define EFUSE_EFUSE_DAC_CLK_DIV_S 0 + +#define EFUSE_DEC_STATUS (DR_REG_EFUSE_BASE + 0x11c) +#define EFUSE_EFUSE_DEC_WARNINGS 0x00000FFF +#define EFUSE_EFUSE_DEC_WARNINGS_S 0 + +#define EFUSE_DATE (DR_REG_EFUSE_BASE + 0x1FC) +#define EFUSE_EFUSE_DATE 0xFFFFFFFF +#define EFUSE_EFUSE_DATE_S 0 +#define EFUSE_EFUSE_DATE_VERSION 0x16042600 + +#endif /* _SOC_EFUSE_REG_H_ */ diff --git a/components/esp32/include/soc/gpio_reg.h b/components/esp32/include/soc/gpio_reg.h new file mode 100644 index 000000000..8e13dafa7 --- /dev/null +++ b/components/esp32/include/soc/gpio_reg.h @@ -0,0 +1,3124 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_GPIO_REG_H_ +#define _SOC_GPIO_REG_H_ + +#include "soc.h" + +//for GPIO_PIN group +#define GPIO_PIN_CONFIG_MSB 12 +#define GPIO_PIN_CONFIG_LSB 11 +#define GPIO_PIN_CONFIG_MASK 0x00001800 +#define GPIO_PIN_CONFIG_GET(x) (((x) & GPIO_PIN_CONFIG_MASK) >> GPIO_PIN_CONFIG_LSB) +#define GPIO_PIN_CONFIG_SET(x) (((x) << GPIO_PIN_CONFIG_LSB) & GPIO_PIN_CONFIG_MASK) + +#define GPIO_WAKEUP_ENABLE 1 +#define GPIO_WAKEUP_DISABLE (~GPIO_WAKEUP_ENABLE) +#define GPIO_PIN_WAKEUP_ENABLE_MSB 10 +#define GPIO_PIN_WAKEUP_ENABLE_LSB 10 +#define GPIO_PIN_WAKEUP_ENABLE_MASK 0x00000400 +#define GPIO_PIN_WAKEUP_ENABLE_GET(x) (((x) & GPIO_PIN_WAKEUP_ENABLE_MASK) >> GPIO_PIN_WAKEUP_ENABLE_LSB) +#define GPIO_PIN_WAKEUP_ENABLE_SET(x) (((x) << GPIO_PIN_WAKEUP_ENABLE_LSB) & GPIO_PIN_WAKEUP_ENABLE_MASK) + +#define GPIO_PIN_INT_TYPE_MASK 0x380 +#define GPIO_PIN_INT_TYPE_MSB 9 +#define GPIO_PIN_INT_TYPE_LSB 7 +#define GPIO_PIN_INT_TYPE_GET(x) (((x) & GPIO_PIN_INT_TYPE_MASK) >> GPIO_PIN_INT_TYPE_LSB) +#define GPIO_PIN_INT_TYPE_SET(x) (((x) << GPIO_PIN_INT_TYPE_LSB) & GPIO_PIN_INT_TYPE_MASK) + +#define GPIO_PAD_DRIVER_ENABLE 1 +#define GPIO_PAD_DRIVER_DISABLE (~GPIO_PAD_DRIVER_ENABLE) +#define GPIO_PIN_PAD_DRIVER_MSB 2 +#define GPIO_PIN_PAD_DRIVER_LSB 2 +#define GPIO_PIN_PAD_DRIVER_MASK 0x00000004 +#define GPIO_PIN_PAD_DRIVER_GET(x) (((x) & GPIO_PIN_PAD_DRIVER_MASK) >> GPIO_PIN_PAD_DRIVER_LSB) +#define GPIO_PIN_PAD_DRIVER_SET(x) (((x) << GPIO_PIN_PAD_DRIVER_LSB) & GPIO_PIN_PAD_DRIVER_MASK) + +//end GPIO_PIN group + +#define GPIO_BT_SELECT (DR_REG_GPIO_BASE + 0x0000) +#define GPIO_GPIO_BT_SEL 0xFFFFFFFF +#define GPIO_GPIO_BT_SEL_S 0 + +#define GPIO_OUT (DR_REG_GPIO_BASE + 0x0004) +#define GPIO_GPIO_OUT_DATA 0xFFFFFFFF +#define GPIO_GPIO_OUT_DATA_S 0 + +#define GPIO_OUT_W1TS (DR_REG_GPIO_BASE + 0x0008) +#define GPIO_GPIO_OUT_DATA 0xFFFFFFFF +#define GPIO_GPIO_OUT_DATA_S 0 + +#define GPIO_OUT_W1TC (DR_REG_GPIO_BASE + 0x000c) +#define GPIO_GPIO_OUT_DATA 0xFFFFFFFF +#define GPIO_GPIO_OUT_DATA_S 0 + +#define GPIO_OUT1 (DR_REG_GPIO_BASE + 0x0010) +#define GPIO_GPIO_OUT_DATA_H 0x000000FF +#define GPIO_GPIO_OUT_DATA_H_S 0 + +#define GPIO_OUT1_W1TS (DR_REG_GPIO_BASE + 0x0014) +#define GPIO_GPIO_OUT_DATA_H 0x000000FF +#define GPIO_GPIO_OUT_DATA_H_S 0 + +#define GPIO_OUT1_W1TC (DR_REG_GPIO_BASE + 0x0018) +#define GPIO_GPIO_OUT_DATA_H 0x000000FF +#define GPIO_GPIO_OUT_DATA_H_S 0 + +#define GPIO_SDIO_SELECT (DR_REG_GPIO_BASE + 0x001c) +#define GPIO_GPIO_SDIO_SEL 0x000000FF +#define GPIO_GPIO_SDIO_SEL_S 0 + +#define GPIO_ENABLE (DR_REG_GPIO_BASE + 0x0020) +#define GPIO_GPIO_ENABLE_DATA 0xFFFFFFFF +#define GPIO_GPIO_ENABLE_DATA_S 0 + +#define GPIO_ENABLE_W1TS (DR_REG_GPIO_BASE + 0x0024) +#define GPIO_GPIO_ENABLE_DATA 0xFFFFFFFF +#define GPIO_GPIO_ENABLE_DATA_S 0 + +#define GPIO_ENABLE_W1TC (DR_REG_GPIO_BASE + 0x0028) +#define GPIO_GPIO_ENABLE_DATA 0xFFFFFFFF +#define GPIO_GPIO_ENABLE_DATA_S 0 + +#define GPIO_ENABLE1 (DR_REG_GPIO_BASE + 0x002c) +#define GPIO_GPIO_ENABLE_DATA_H 0x000000FF +#define GPIO_GPIO_ENABLE_DATA_H_S 0 + +#define GPIO_ENABLE1_W1TS (DR_REG_GPIO_BASE + 0x0030) +#define GPIO_GPIO_ENABLE_DATA_H 0x000000FF +#define GPIO_GPIO_ENABLE_DATA_H_S 0 + +#define GPIO_ENABLE1_W1TC (DR_REG_GPIO_BASE + 0x0034) +#define GPIO_GPIO_ENABLE_DATA_H 0x000000FF +#define GPIO_GPIO_ENABLE_DATA_H_S 0 + +#define GPIO_STRAP (DR_REG_GPIO_BASE + 0x0038) +#define GPIO_GPIO_STRAPPING 0x0000FFFF +#define GPIO_GPIO_STRAPPING_S 0 + +#define GPIO_IN (DR_REG_GPIO_BASE + 0x003c) +#define GPIO_GPIO_IN_DATA_NEXT 0xFFFFFFFF +#define GPIO_GPIO_IN_DATA_NEXT_S 0 + +#define GPIO_IN1 (DR_REG_GPIO_BASE + 0x0040) +#define GPIO_GPIO_IN_DATA_NEXT_H 0x000000FF +#define GPIO_GPIO_IN_DATA_NEXT_H_S 0 + +#define GPIO_STATUS (DR_REG_GPIO_BASE + 0x0044) +#define GPIO_GPIO_STATUS_INTERRUPT 0xFFFFFFFF +#define GPIO_GPIO_STATUS_INTERRUPT_S 0 + +#define GPIO_STATUS_W1TS (DR_REG_GPIO_BASE + 0x0048) +#define GPIO_GPIO_STATUS_INTERRUPT 0xFFFFFFFF +#define GPIO_GPIO_STATUS_INTERRUPT_S 0 + +#define GPIO_STATUS_W1TC (DR_REG_GPIO_BASE + 0x004c) +#define GPIO_GPIO_STATUS_INTERRUPT 0xFFFFFFFF +#define GPIO_GPIO_STATUS_INTERRUPT_S 0 + +#define GPIO_STATUS1 (DR_REG_GPIO_BASE + 0x0050) +#define GPIO_GPIO_STATUS_INTERRUPT_H 0x000000FF +#define GPIO_GPIO_STATUS_INTERRUPT_H_S 0 + +#define GPIO_STATUS1_W1TS (DR_REG_GPIO_BASE + 0x0054) +#define GPIO_GPIO_STATUS_INTERRUPT_H 0x000000FF +#define GPIO_GPIO_STATUS_INTERRUPT_H_S 0 + +#define GPIO_STATUS1_W1TC (DR_REG_GPIO_BASE + 0x0058) +#define GPIO_GPIO_STATUS_INTERRUPT_H 0x000000FF +#define GPIO_GPIO_STATUS_INTERRUPT_H_S 0 + +#define GPIO_ACPU_INT (DR_REG_GPIO_BASE + 0x0060) +#define GPIO_GPIO_APPCPU_INT 0xFFFFFFFF +#define GPIO_GPIO_APPCPU_INT_S 0 + +#define GPIO_ACPU_NMI_INT (DR_REG_GPIO_BASE + 0x0064) +#define GPIO_GPIO_APPCPU_NMI_INT 0xFFFFFFFF +#define GPIO_GPIO_APPCPU_NMI_INT_S 0 + +#define GPIO_PCPU_INT (DR_REG_GPIO_BASE + 0x0068) +#define GPIO_GPIO_PROCPU_INT 0xFFFFFFFF +#define GPIO_GPIO_PROCPU_INT_S 0 + +#define GPIO_PCPU_NMI_INT (DR_REG_GPIO_BASE + 0x006c) +#define GPIO_GPIO_PROCPU_NMI_INT 0xFFFFFFFF +#define GPIO_GPIO_PROCPU_NMI_INT_S 0 + +#define GPIO_CPUSDIO_INT (DR_REG_GPIO_BASE + 0x0070) +#define GPIO_GPIO_SDIO_INT 0xFFFFFFFF +#define GPIO_GPIO_SDIO_INT_S 0 + +#define GPIO_ACPU_INT1 (DR_REG_GPIO_BASE + 0x0074) +#define GPIO_GPIO_APPCPU_INT_H 0x000000FF +#define GPIO_GPIO_APPCPU_INT_H_S 0 + +#define GPIO_ACPU_NMI_INT1 (DR_REG_GPIO_BASE + 0x0078) +#define GPIO_GPIO_APPCPU_NMI_INT_H 0x000000FF +#define GPIO_GPIO_APPCPU_NMI_INT_H_S 0 + +#define GPIO_PCPU_INT1 (DR_REG_GPIO_BASE + 0x007c) +#define GPIO_GPIO_PROCPU_INT_H 0x000000FF +#define GPIO_GPIO_PROCPU_INT_H_S 0 + +#define GPIO_PCPU_NMI_INT1 (DR_REG_GPIO_BASE + 0x0080) +#define GPIO_GPIO_PROCPU_NMI_INT_H 0x000000FF +#define GPIO_GPIO_PROCPU_NMI_INT_H_S 0 + +#define GPIO_CPUSDIO_INT1 (DR_REG_GPIO_BASE + 0x0084) +#define GPIO_GPIO_SDIO_INT_H 0x000000FF +#define GPIO_GPIO_SDIO_INT_H_S 0 + +#define GPIO_PIN0 (DR_REG_GPIO_BASE + 0x0088) +#define GPIO_GPIO_PIN0_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN0_INT_ENA_S 13 +#define GPIO_GPIO_PIN0_CONFIG 0x00000003 +#define GPIO_GPIO_PIN0_CONFIG_S 11 +#define GPIO_GPIO_PIN0_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN0_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN0_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN0_INT_TYPE_S 7 +#define GPIO_GPIO_PIN0_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN0_PAD_DRIVER_S 2 + +#define GPIO_PIN1 (DR_REG_GPIO_BASE + 0x008c) +#define GPIO_GPIO_PIN1_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN1_INT_ENA_S 13 +#define GPIO_GPIO_PIN1_CONFIG 0x00000003 +#define GPIO_GPIO_PIN1_CONFIG_S 11 +#define GPIO_GPIO_PIN1_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN1_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN1_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN1_INT_TYPE_S 7 +#define GPIO_GPIO_PIN1_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN1_PAD_DRIVER_S 2 + +#define GPIO_PIN2 (DR_REG_GPIO_BASE + 0x0090) +#define GPIO_GPIO_PIN2_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN2_INT_ENA_S 13 +#define GPIO_GPIO_PIN2_CONFIG 0x00000003 +#define GPIO_GPIO_PIN2_CONFIG_S 11 +#define GPIO_GPIO_PIN2_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN2_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN2_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN2_INT_TYPE_S 7 +#define GPIO_GPIO_PIN2_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN2_PAD_DRIVER_S 2 + +#define GPIO_PIN3 (DR_REG_GPIO_BASE + 0x0094) +#define GPIO_GPIO_PIN3_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN3_INT_ENA_S 13 +#define GPIO_GPIO_PIN3_CONFIG 0x00000003 +#define GPIO_GPIO_PIN3_CONFIG_S 11 +#define GPIO_GPIO_PIN3_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN3_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN3_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN3_INT_TYPE_S 7 +#define GPIO_GPIO_PIN3_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN3_PAD_DRIVER_S 2 + +#define GPIO_PIN4 (DR_REG_GPIO_BASE + 0x0098) +#define GPIO_GPIO_PIN4_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN4_INT_ENA_S 13 +#define GPIO_GPIO_PIN4_CONFIG 0x00000003 +#define GPIO_GPIO_PIN4_CONFIG_S 11 +#define GPIO_GPIO_PIN4_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN4_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN4_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN4_INT_TYPE_S 7 +#define GPIO_GPIO_PIN4_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN4_PAD_DRIVER_S 2 + +#define GPIO_PIN5 (DR_REG_GPIO_BASE + 0x009c) +#define GPIO_GPIO_PIN5_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN5_INT_ENA_S 13 +#define GPIO_GPIO_PIN5_CONFIG 0x00000003 +#define GPIO_GPIO_PIN5_CONFIG_S 11 +#define GPIO_GPIO_PIN5_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN5_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN5_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN5_INT_TYPE_S 7 +#define GPIO_GPIO_PIN5_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN5_PAD_DRIVER_S 2 + +#define GPIO_PIN6 (DR_REG_GPIO_BASE + 0x00a0) +#define GPIO_GPIO_PIN6_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN6_INT_ENA_S 13 +#define GPIO_GPIO_PIN6_CONFIG 0x00000003 +#define GPIO_GPIO_PIN6_CONFIG_S 11 +#define GPIO_GPIO_PIN6_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN6_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN6_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN6_INT_TYPE_S 7 +#define GPIO_GPIO_PIN6_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN6_PAD_DRIVER_S 2 + +#define GPIO_PIN7 (DR_REG_GPIO_BASE + 0x00a4) +#define GPIO_GPIO_PIN7_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN7_INT_ENA_S 13 +#define GPIO_GPIO_PIN7_CONFIG 0x00000003 +#define GPIO_GPIO_PIN7_CONFIG_S 11 +#define GPIO_GPIO_PIN7_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN7_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN7_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN7_INT_TYPE_S 7 +#define GPIO_GPIO_PIN7_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN7_PAD_DRIVER_S 2 + +#define GPIO_PIN8 (DR_REG_GPIO_BASE + 0x00a8) +#define GPIO_GPIO_PIN8_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN8_INT_ENA_S 13 +#define GPIO_GPIO_PIN8_CONFIG 0x00000003 +#define GPIO_GPIO_PIN8_CONFIG_S 11 +#define GPIO_GPIO_PIN8_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN8_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN8_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN8_INT_TYPE_S 7 +#define GPIO_GPIO_PIN8_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN8_PAD_DRIVER_S 2 + +#define GPIO_PIN9 (DR_REG_GPIO_BASE + 0x00ac) +#define GPIO_GPIO_PIN9_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN9_INT_ENA_S 13 +#define GPIO_GPIO_PIN9_CONFIG 0x00000003 +#define GPIO_GPIO_PIN9_CONFIG_S 11 +#define GPIO_GPIO_PIN9_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN9_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN9_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN9_INT_TYPE_S 7 +#define GPIO_GPIO_PIN9_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN9_PAD_DRIVER_S 2 + +#define GPIO_PIN10 (DR_REG_GPIO_BASE + 0x00b0) +#define GPIO_GPIO_PIN10_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN10_INT_ENA_S 13 +#define GPIO_GPIO_PIN10_CONFIG 0x00000003 +#define GPIO_GPIO_PIN10_CONFIG_S 11 +#define GPIO_GPIO_PIN10_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN10_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN10_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN10_INT_TYPE_S 7 +#define GPIO_GPIO_PIN10_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN10_PAD_DRIVER_S 2 + +#define GPIO_PIN11 (DR_REG_GPIO_BASE + 0x00b4) +#define GPIO_GPIO_PIN11_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN11_INT_ENA_S 13 +#define GPIO_GPIO_PIN11_CONFIG 0x00000003 +#define GPIO_GPIO_PIN11_CONFIG_S 11 +#define GPIO_GPIO_PIN11_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN11_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN11_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN11_INT_TYPE_S 7 +#define GPIO_GPIO_PIN11_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN11_PAD_DRIVER_S 2 + +#define GPIO_PIN12 (DR_REG_GPIO_BASE + 0x00b8) +#define GPIO_GPIO_PIN12_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN12_INT_ENA_S 13 +#define GPIO_GPIO_PIN12_CONFIG 0x00000003 +#define GPIO_GPIO_PIN12_CONFIG_S 11 +#define GPIO_GPIO_PIN12_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN12_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN12_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN12_INT_TYPE_S 7 +#define GPIO_GPIO_PIN12_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN12_PAD_DRIVER_S 2 + +#define GPIO_PIN13 (DR_REG_GPIO_BASE + 0x00bc) +#define GPIO_GPIO_PIN13_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN13_INT_ENA_S 13 +#define GPIO_GPIO_PIN13_CONFIG 0x00000003 +#define GPIO_GPIO_PIN13_CONFIG_S 11 +#define GPIO_GPIO_PIN13_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN13_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN13_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN13_INT_TYPE_S 7 +#define GPIO_GPIO_PIN13_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN13_PAD_DRIVER_S 2 + +#define GPIO_PIN14 (DR_REG_GPIO_BASE + 0x00c0) +#define GPIO_GPIO_PIN14_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN14_INT_ENA_S 13 +#define GPIO_GPIO_PIN14_CONFIG 0x00000003 +#define GPIO_GPIO_PIN14_CONFIG_S 11 +#define GPIO_GPIO_PIN14_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN14_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN14_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN14_INT_TYPE_S 7 +#define GPIO_GPIO_PIN14_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN14_PAD_DRIVER_S 2 + +#define GPIO_PIN15 (DR_REG_GPIO_BASE + 0x00c4) +#define GPIO_GPIO_PIN15_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN15_INT_ENA_S 13 +#define GPIO_GPIO_PIN15_CONFIG 0x00000003 +#define GPIO_GPIO_PIN15_CONFIG_S 11 +#define GPIO_GPIO_PIN15_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN15_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN15_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN15_INT_TYPE_S 7 +#define GPIO_GPIO_PIN15_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN15_PAD_DRIVER_S 2 + +#define GPIO_PIN16 (DR_REG_GPIO_BASE + 0x00c8) +#define GPIO_GPIO_PIN16_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN16_INT_ENA_S 13 +#define GPIO_GPIO_PIN16_CONFIG 0x00000003 +#define GPIO_GPIO_PIN16_CONFIG_S 11 +#define GPIO_GPIO_PIN16_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN16_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN16_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN16_INT_TYPE_S 7 +#define GPIO_GPIO_PIN16_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN16_PAD_DRIVER_S 2 + +#define GPIO_PIN17 (DR_REG_GPIO_BASE + 0x00cc) +#define GPIO_GPIO_PIN17_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN17_INT_ENA_S 13 +#define GPIO_GPIO_PIN17_CONFIG 0x00000003 +#define GPIO_GPIO_PIN17_CONFIG_S 11 +#define GPIO_GPIO_PIN17_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN17_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN17_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN17_INT_TYPE_S 7 +#define GPIO_GPIO_PIN17_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN17_PAD_DRIVER_S 2 + +#define GPIO_PIN18 (DR_REG_GPIO_BASE + 0x00d0) +#define GPIO_GPIO_PIN18_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN18_INT_ENA_S 13 +#define GPIO_GPIO_PIN18_CONFIG 0x00000003 +#define GPIO_GPIO_PIN18_CONFIG_S 11 +#define GPIO_GPIO_PIN18_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN18_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN18_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN18_INT_TYPE_S 7 +#define GPIO_GPIO_PIN18_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN18_PAD_DRIVER_S 2 + +#define GPIO_PIN19 (DR_REG_GPIO_BASE + 0x00d4) +#define GPIO_GPIO_PIN19_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN19_INT_ENA_S 13 +#define GPIO_GPIO_PIN19_CONFIG 0x00000003 +#define GPIO_GPIO_PIN19_CONFIG_S 11 +#define GPIO_GPIO_PIN19_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN19_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN19_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN19_INT_TYPE_S 7 +#define GPIO_GPIO_PIN19_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN19_PAD_DRIVER_S 2 + +#define GPIO_PIN20 (DR_REG_GPIO_BASE + 0x00d8) +#define GPIO_GPIO_PIN20_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN20_INT_ENA_S 13 +#define GPIO_GPIO_PIN20_CONFIG 0x00000003 +#define GPIO_GPIO_PIN20_CONFIG_S 11 +#define GPIO_GPIO_PIN20_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN20_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN20_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN20_INT_TYPE_S 7 +#define GPIO_GPIO_PIN20_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN20_PAD_DRIVER_S 2 + +#define GPIO_PIN21 (DR_REG_GPIO_BASE + 0x00dc) +#define GPIO_GPIO_PIN21_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN21_INT_ENA_S 13 +#define GPIO_GPIO_PIN21_CONFIG 0x00000003 +#define GPIO_GPIO_PIN21_CONFIG_S 11 +#define GPIO_GPIO_PIN21_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN21_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN21_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN21_INT_TYPE_S 7 +#define GPIO_GPIO_PIN21_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN21_PAD_DRIVER_S 2 + +#define GPIO_PIN22 (DR_REG_GPIO_BASE + 0x00e0) +#define GPIO_GPIO_PIN22_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN22_INT_ENA_S 13 +#define GPIO_GPIO_PIN22_CONFIG 0x00000003 +#define GPIO_GPIO_PIN22_CONFIG_S 11 +#define GPIO_GPIO_PIN22_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN22_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN22_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN22_INT_TYPE_S 7 +#define GPIO_GPIO_PIN22_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN22_PAD_DRIVER_S 2 + +#define GPIO_PIN23 (DR_REG_GPIO_BASE + 0x00e4) +#define GPIO_GPIO_PIN23_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN23_INT_ENA_S 13 +#define GPIO_GPIO_PIN23_CONFIG 0x00000003 +#define GPIO_GPIO_PIN23_CONFIG_S 11 +#define GPIO_GPIO_PIN23_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN23_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN23_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN23_INT_TYPE_S 7 +#define GPIO_GPIO_PIN23_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN23_PAD_DRIVER_S 2 + +#define GPIO_PIN24 (DR_REG_GPIO_BASE + 0x00e8) +#define GPIO_GPIO_PIN24_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN24_INT_ENA_S 13 +#define GPIO_GPIO_PIN24_CONFIG 0x00000003 +#define GPIO_GPIO_PIN24_CONFIG_S 11 +#define GPIO_GPIO_PIN24_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN24_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN24_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN24_INT_TYPE_S 7 +#define GPIO_GPIO_PIN24_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN24_PAD_DRIVER_S 2 + +#define GPIO_PIN25 (DR_REG_GPIO_BASE + 0x00ec) +#define GPIO_GPIO_PIN25_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN25_INT_ENA_S 13 +#define GPIO_GPIO_PIN25_CONFIG 0x00000003 +#define GPIO_GPIO_PIN25_CONFIG_S 11 +#define GPIO_GPIO_PIN25_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN25_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN25_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN25_INT_TYPE_S 7 +#define GPIO_GPIO_PIN25_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN25_PAD_DRIVER_S 2 + +#define GPIO_PIN26 (DR_REG_GPIO_BASE + 0x00f0) +#define GPIO_GPIO_PIN26_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN26_INT_ENA_S 13 +#define GPIO_GPIO_PIN26_CONFIG 0x00000003 +#define GPIO_GPIO_PIN26_CONFIG_S 11 +#define GPIO_GPIO_PIN26_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN26_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN26_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN26_INT_TYPE_S 7 +#define GPIO_GPIO_PIN26_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN26_PAD_DRIVER_S 2 + +#define GPIO_PIN27 (DR_REG_GPIO_BASE + 0x00f4) +#define GPIO_GPIO_PIN27_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN27_INT_ENA_S 13 +#define GPIO_GPIO_PIN27_CONFIG 0x00000003 +#define GPIO_GPIO_PIN27_CONFIG_S 11 +#define GPIO_GPIO_PIN27_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN27_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN27_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN27_INT_TYPE_S 7 +#define GPIO_GPIO_PIN27_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN27_PAD_DRIVER_S 2 + +#define GPIO_PIN28 (DR_REG_GPIO_BASE + 0x00f8) +#define GPIO_GPIO_PIN28_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN28_INT_ENA_S 13 +#define GPIO_GPIO_PIN28_CONFIG 0x00000003 +#define GPIO_GPIO_PIN28_CONFIG_S 11 +#define GPIO_GPIO_PIN28_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN28_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN28_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN28_INT_TYPE_S 7 +#define GPIO_GPIO_PIN28_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN28_PAD_DRIVER_S 2 + +#define GPIO_PIN29 (DR_REG_GPIO_BASE + 0x00fc) +#define GPIO_GPIO_PIN29_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN29_INT_ENA_S 13 +#define GPIO_GPIO_PIN29_CONFIG 0x00000003 +#define GPIO_GPIO_PIN29_CONFIG_S 11 +#define GPIO_GPIO_PIN29_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN29_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN29_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN29_INT_TYPE_S 7 +#define GPIO_GPIO_PIN29_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN29_PAD_DRIVER_S 2 + +#define GPIO_PIN30 (DR_REG_GPIO_BASE + 0x0100) +#define GPIO_GPIO_PIN30_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN30_INT_ENA_S 13 +#define GPIO_GPIO_PIN30_CONFIG 0x00000003 +#define GPIO_GPIO_PIN30_CONFIG_S 11 +#define GPIO_GPIO_PIN30_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN30_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN30_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN30_INT_TYPE_S 7 +#define GPIO_GPIO_PIN30_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN30_PAD_DRIVER_S 2 + +#define GPIO_PIN31 (DR_REG_GPIO_BASE + 0x0104) +#define GPIO_GPIO_PIN31_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN31_INT_ENA_S 13 +#define GPIO_GPIO_PIN31_CONFIG 0x00000003 +#define GPIO_GPIO_PIN31_CONFIG_S 11 +#define GPIO_GPIO_PIN31_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN31_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN31_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN31_INT_TYPE_S 7 +#define GPIO_GPIO_PIN31_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN31_PAD_DRIVER_S 2 + +#define GPIO_PIN32 (DR_REG_GPIO_BASE + 0x0108) +#define GPIO_GPIO_PIN32_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN32_INT_ENA_S 13 +#define GPIO_GPIO_PIN32_CONFIG 0x00000003 +#define GPIO_GPIO_PIN32_CONFIG_S 11 +#define GPIO_GPIO_PIN32_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN32_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN32_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN32_INT_TYPE_S 7 +#define GPIO_GPIO_PIN32_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN32_PAD_DRIVER_S 2 + +#define GPIO_PIN33 (DR_REG_GPIO_BASE + 0x010c) +#define GPIO_GPIO_PIN33_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN33_INT_ENA_S 13 +#define GPIO_GPIO_PIN33_CONFIG 0x00000003 +#define GPIO_GPIO_PIN33_CONFIG_S 11 +#define GPIO_GPIO_PIN33_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN33_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN33_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN33_INT_TYPE_S 7 +#define GPIO_GPIO_PIN33_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN33_PAD_DRIVER_S 2 + +#define GPIO_PIN34 (DR_REG_GPIO_BASE + 0x0110) +#define GPIO_GPIO_PIN34_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN34_INT_ENA_S 13 +#define GPIO_GPIO_PIN34_CONFIG 0x00000003 +#define GPIO_GPIO_PIN34_CONFIG_S 11 +#define GPIO_GPIO_PIN34_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN34_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN34_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN34_INT_TYPE_S 7 +#define GPIO_GPIO_PIN34_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN34_PAD_DRIVER_S 2 + +#define GPIO_PIN35 (DR_REG_GPIO_BASE + 0x0114) +#define GPIO_GPIO_PIN35_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN35_INT_ENA_S 13 +#define GPIO_GPIO_PIN35_CONFIG 0x00000003 +#define GPIO_GPIO_PIN35_CONFIG_S 11 +#define GPIO_GPIO_PIN35_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN35_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN35_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN35_INT_TYPE_S 7 +#define GPIO_GPIO_PIN35_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN35_PAD_DRIVER_S 2 + +#define GPIO_PIN36 (DR_REG_GPIO_BASE + 0x0118) +#define GPIO_GPIO_PIN36_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN36_INT_ENA_S 13 +#define GPIO_GPIO_PIN36_CONFIG 0x00000003 +#define GPIO_GPIO_PIN36_CONFIG_S 11 +#define GPIO_GPIO_PIN36_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN36_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN36_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN36_INT_TYPE_S 7 +#define GPIO_GPIO_PIN36_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN36_PAD_DRIVER_S 2 + +#define GPIO_PIN37 (DR_REG_GPIO_BASE + 0x011c) +#define GPIO_GPIO_PIN37_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN37_INT_ENA_S 13 +#define GPIO_GPIO_PIN37_CONFIG 0x00000003 +#define GPIO_GPIO_PIN37_CONFIG_S 11 +#define GPIO_GPIO_PIN37_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN37_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN37_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN37_INT_TYPE_S 7 +#define GPIO_GPIO_PIN37_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN37_PAD_DRIVER_S 2 + +#define GPIO_PIN38 (DR_REG_GPIO_BASE + 0x0120) +#define GPIO_GPIO_PIN38_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN38_INT_ENA_S 13 +#define GPIO_GPIO_PIN38_CONFIG 0x00000003 +#define GPIO_GPIO_PIN38_CONFIG_S 11 +#define GPIO_GPIO_PIN38_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN38_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN38_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN38_INT_TYPE_S 7 +#define GPIO_GPIO_PIN38_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN38_PAD_DRIVER_S 2 + +#define GPIO_PIN39 (DR_REG_GPIO_BASE + 0x0124) +#define GPIO_GPIO_PIN39_INT_ENA 0x0000001F +#define GPIO_GPIO_PIN39_INT_ENA_S 13 +#define GPIO_GPIO_PIN39_CONFIG 0x00000003 +#define GPIO_GPIO_PIN39_CONFIG_S 11 +#define GPIO_GPIO_PIN39_WAKEUP_ENABLE (BIT(10)) +#define GPIO_GPIO_PIN39_WAKEUP_ENABLE_S 10 +#define GPIO_GPIO_PIN39_INT_TYPE 0x00000007 +#define GPIO_GPIO_PIN39_INT_TYPE_S 7 +#define GPIO_GPIO_PIN39_PAD_DRIVER (BIT(2)) +#define GPIO_GPIO_PIN39_PAD_DRIVER_S 2 + +#define CALI_CONF (DR_REG_GPIO_BASE + 0x0128) +#define GPIO_CALI_START (BIT(31)) +#define GPIO_CALI_START_S 31 +#define GPIO_CALI_RTC_MAX 0x000003FF +#define GPIO_CALI_RTC_MAX_S 0 + +#define CALI_DATA (DR_REG_GPIO_BASE + 0x012c) +#define GPIO_CALI_RDY_SYNC2 (BIT(31)) +#define GPIO_CALI_RDY_SYNC2_S 31 +#define GPIO_CALI_RDY_REAL (BIT(30)) +#define GPIO_CALI_RDY_REAL_S 30 +#define GPIO_CALI_VALUE_SYNC2 0x000FFFFF +#define GPIO_CALI_VALUE_SYNC2_S 0 + +#define GPIO_FUNC0_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0130) +#define GPIO_GPIO_SIG0_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG0_IN_SEL_S 7 +#define GPIO_GPIO_FUNC0_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC0_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC0_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC0_IN_SEL_S 0 + +#define GPIO_FUNC1_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0134) +#define GPIO_GPIO_SIG1_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG1_IN_SEL_S 7 +#define GPIO_GPIO_FUNC1_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC1_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC1_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC1_IN_SEL_S 0 + +#define GPIO_FUNC2_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0138) +#define GPIO_GPIO_SIG2_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG2_IN_SEL_S 7 +#define GPIO_GPIO_FUNC2_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC2_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC2_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC2_IN_SEL_S 0 + +#define GPIO_FUNC3_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x013c) +#define GPIO_GPIO_SIG3_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG3_IN_SEL_S 7 +#define GPIO_GPIO_FUNC3_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC3_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC3_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC3_IN_SEL_S 0 + +#define GPIO_FUNC4_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0140) +#define GPIO_GPIO_SIG4_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG4_IN_SEL_S 7 +#define GPIO_GPIO_FUNC4_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC4_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC4_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC4_IN_SEL_S 0 + +#define GPIO_FUNC5_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0144) +#define GPIO_GPIO_SIG5_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG5_IN_SEL_S 7 +#define GPIO_GPIO_FUNC5_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC5_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC5_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC5_IN_SEL_S 0 + +#define GPIO_FUNC6_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0148) +#define GPIO_GPIO_SIG6_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG6_IN_SEL_S 7 +#define GPIO_GPIO_FUNC6_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC6_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC6_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC6_IN_SEL_S 0 + +#define GPIO_FUNC7_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x014c) +#define GPIO_GPIO_SIG7_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG7_IN_SEL_S 7 +#define GPIO_GPIO_FUNC7_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC7_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC7_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC7_IN_SEL_S 0 + +#define GPIO_FUNC8_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0150) +#define GPIO_GPIO_SIG8_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG8_IN_SEL_S 7 +#define GPIO_GPIO_FUNC8_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC8_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC8_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC8_IN_SEL_S 0 + +#define GPIO_FUNC9_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0154) +#define GPIO_GPIO_SIG9_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG9_IN_SEL_S 7 +#define GPIO_GPIO_FUNC9_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC9_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC9_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC9_IN_SEL_S 0 + +#define GPIO_FUNC10_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0158) +#define GPIO_GPIO_SIG10_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG10_IN_SEL_S 7 +#define GPIO_GPIO_FUNC10_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC10_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC10_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC10_IN_SEL_S 0 + +#define GPIO_FUNC11_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x015c) +#define GPIO_GPIO_SIG11_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG11_IN_SEL_S 7 +#define GPIO_GPIO_FUNC11_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC11_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC11_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC11_IN_SEL_S 0 + +#define GPIO_FUNC12_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0160) +#define GPIO_GPIO_SIG12_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG12_IN_SEL_S 7 +#define GPIO_GPIO_FUNC12_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC12_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC12_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC12_IN_SEL_S 0 + +#define GPIO_FUNC13_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0164) +#define GPIO_GPIO_SIG13_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG13_IN_SEL_S 7 +#define GPIO_GPIO_FUNC13_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC13_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC13_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC13_IN_SEL_S 0 + +#define GPIO_FUNC14_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0168) +#define GPIO_GPIO_SIG14_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG14_IN_SEL_S 7 +#define GPIO_GPIO_FUNC14_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC14_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC14_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC14_IN_SEL_S 0 + +#define GPIO_FUNC15_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x016c) +#define GPIO_GPIO_SIG15_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG15_IN_SEL_S 7 +#define GPIO_GPIO_FUNC15_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC15_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC15_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC15_IN_SEL_S 0 + +#define GPIO_FUNC16_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0170) +#define GPIO_GPIO_SIG16_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG16_IN_SEL_S 7 +#define GPIO_GPIO_FUNC16_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC16_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC16_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC16_IN_SEL_S 0 + +#define GPIO_FUNC17_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0174) +#define GPIO_GPIO_SIG17_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG17_IN_SEL_S 7 +#define GPIO_GPIO_FUNC17_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC17_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC17_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC17_IN_SEL_S 0 + +#define GPIO_FUNC18_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0178) +#define GPIO_GPIO_SIG18_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG18_IN_SEL_S 7 +#define GPIO_GPIO_FUNC18_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC18_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC18_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC18_IN_SEL_S 0 + +#define GPIO_FUNC19_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x017c) +#define GPIO_GPIO_SIG19_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG19_IN_SEL_S 7 +#define GPIO_GPIO_FUNC19_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC19_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC19_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC19_IN_SEL_S 0 + +#define GPIO_FUNC20_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0180) +#define GPIO_GPIO_SIG20_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG20_IN_SEL_S 7 +#define GPIO_GPIO_FUNC20_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC20_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC20_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC20_IN_SEL_S 0 + +#define GPIO_FUNC21_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0184) +#define GPIO_GPIO_SIG21_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG21_IN_SEL_S 7 +#define GPIO_GPIO_FUNC21_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC21_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC21_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC21_IN_SEL_S 0 + +#define GPIO_FUNC22_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0188) +#define GPIO_GPIO_SIG22_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG22_IN_SEL_S 7 +#define GPIO_GPIO_FUNC22_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC22_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC22_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC22_IN_SEL_S 0 + +#define GPIO_FUNC23_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x018c) +#define GPIO_GPIO_SIG23_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG23_IN_SEL_S 7 +#define GPIO_GPIO_FUNC23_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC23_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC23_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC23_IN_SEL_S 0 + +#define GPIO_FUNC24_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0190) +#define GPIO_GPIO_SIG24_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG24_IN_SEL_S 7 +#define GPIO_GPIO_FUNC24_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC24_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC24_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC24_IN_SEL_S 0 + +#define GPIO_FUNC25_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0194) +#define GPIO_GPIO_SIG25_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG25_IN_SEL_S 7 +#define GPIO_GPIO_FUNC25_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC25_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC25_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC25_IN_SEL_S 0 + +#define GPIO_FUNC26_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0198) +#define GPIO_GPIO_SIG26_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG26_IN_SEL_S 7 +#define GPIO_GPIO_FUNC26_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC26_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC26_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC26_IN_SEL_S 0 + +#define GPIO_FUNC27_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x019c) +#define GPIO_GPIO_SIG27_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG27_IN_SEL_S 7 +#define GPIO_GPIO_FUNC27_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC27_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC27_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC27_IN_SEL_S 0 + +#define GPIO_FUNC28_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01a0) +#define GPIO_GPIO_SIG28_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG28_IN_SEL_S 7 +#define GPIO_GPIO_FUNC28_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC28_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC28_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC28_IN_SEL_S 0 + +#define GPIO_FUNC29_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01a4) +#define GPIO_GPIO_SIG29_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG29_IN_SEL_S 7 +#define GPIO_GPIO_FUNC29_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC29_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC29_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC29_IN_SEL_S 0 + +#define GPIO_FUNC30_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01a8) +#define GPIO_GPIO_SIG30_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG30_IN_SEL_S 7 +#define GPIO_GPIO_FUNC30_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC30_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC30_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC30_IN_SEL_S 0 + +#define GPIO_FUNC31_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01ac) +#define GPIO_GPIO_SIG31_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG31_IN_SEL_S 7 +#define GPIO_GPIO_FUNC31_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC31_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC31_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC31_IN_SEL_S 0 + +#define GPIO_FUNC32_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01b0) +#define GPIO_GPIO_SIG32_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG32_IN_SEL_S 7 +#define GPIO_GPIO_FUNC32_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC32_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC32_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC32_IN_SEL_S 0 + +#define GPIO_FUNC33_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01b4) +#define GPIO_GPIO_SIG33_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG33_IN_SEL_S 7 +#define GPIO_GPIO_FUNC33_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC33_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC33_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC33_IN_SEL_S 0 + +#define GPIO_FUNC34_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01b8) +#define GPIO_GPIO_SIG34_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG34_IN_SEL_S 7 +#define GPIO_GPIO_FUNC34_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC34_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC34_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC34_IN_SEL_S 0 + +#define GPIO_FUNC35_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01bc) +#define GPIO_GPIO_SIG35_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG35_IN_SEL_S 7 +#define GPIO_GPIO_FUNC35_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC35_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC35_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC35_IN_SEL_S 0 + +#define GPIO_FUNC36_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01c0) +#define GPIO_GPIO_SIG36_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG36_IN_SEL_S 7 +#define GPIO_GPIO_FUNC36_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC36_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC36_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC36_IN_SEL_S 0 + +#define GPIO_FUNC37_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01c4) +#define GPIO_GPIO_SIG37_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG37_IN_SEL_S 7 +#define GPIO_GPIO_FUNC37_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC37_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC37_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC37_IN_SEL_S 0 + +#define GPIO_FUNC38_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01c8) +#define GPIO_GPIO_SIG38_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG38_IN_SEL_S 7 +#define GPIO_GPIO_FUNC38_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC38_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC38_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC38_IN_SEL_S 0 + +#define GPIO_FUNC39_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01cc) +#define GPIO_GPIO_SIG39_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG39_IN_SEL_S 7 +#define GPIO_GPIO_FUNC39_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC39_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC39_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC39_IN_SEL_S 0 + +#define GPIO_FUNC40_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01d0) +#define GPIO_GPIO_SIG40_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG40_IN_SEL_S 7 +#define GPIO_GPIO_FUNC40_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC40_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC40_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC40_IN_SEL_S 0 + +#define GPIO_FUNC41_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01d4) +#define GPIO_GPIO_SIG41_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG41_IN_SEL_S 7 +#define GPIO_GPIO_FUNC41_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC41_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC41_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC41_IN_SEL_S 0 + +#define GPIO_FUNC42_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01d8) +#define GPIO_GPIO_SIG42_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG42_IN_SEL_S 7 +#define GPIO_GPIO_FUNC42_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC42_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC42_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC42_IN_SEL_S 0 + +#define GPIO_FUNC43_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01dc) +#define GPIO_GPIO_SIG43_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG43_IN_SEL_S 7 +#define GPIO_GPIO_FUNC43_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC43_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC43_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC43_IN_SEL_S 0 + +#define GPIO_FUNC44_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01e0) +#define GPIO_GPIO_SIG44_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG44_IN_SEL_S 7 +#define GPIO_GPIO_FUNC44_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC44_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC44_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC44_IN_SEL_S 0 + +#define GPIO_FUNC45_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01e4) +#define GPIO_GPIO_SIG45_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG45_IN_SEL_S 7 +#define GPIO_GPIO_FUNC45_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC45_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC45_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC45_IN_SEL_S 0 + +#define GPIO_FUNC46_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01e8) +#define GPIO_GPIO_SIG46_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG46_IN_SEL_S 7 +#define GPIO_GPIO_FUNC46_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC46_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC46_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC46_IN_SEL_S 0 + +#define GPIO_FUNC47_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01ec) +#define GPIO_GPIO_SIG47_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG47_IN_SEL_S 7 +#define GPIO_GPIO_FUNC47_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC47_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC47_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC47_IN_SEL_S 0 + +#define GPIO_FUNC48_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01f0) +#define GPIO_GPIO_SIG48_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG48_IN_SEL_S 7 +#define GPIO_GPIO_FUNC48_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC48_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC48_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC48_IN_SEL_S 0 + +#define GPIO_FUNC49_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01f4) +#define GPIO_GPIO_SIG49_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG49_IN_SEL_S 7 +#define GPIO_GPIO_FUNC49_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC49_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC49_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC49_IN_SEL_S 0 + +#define GPIO_FUNC50_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01f8) +#define GPIO_GPIO_SIG50_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG50_IN_SEL_S 7 +#define GPIO_GPIO_FUNC50_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC50_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC50_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC50_IN_SEL_S 0 + +#define GPIO_FUNC51_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x01fc) +#define GPIO_GPIO_SIG51_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG51_IN_SEL_S 7 +#define GPIO_GPIO_FUNC51_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC51_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC51_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC51_IN_SEL_S 0 + +#define GPIO_FUNC52_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0200) +#define GPIO_GPIO_SIG52_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG52_IN_SEL_S 7 +#define GPIO_GPIO_FUNC52_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC52_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC52_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC52_IN_SEL_S 0 + +#define GPIO_FUNC53_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0204) +#define GPIO_GPIO_SIG53_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG53_IN_SEL_S 7 +#define GPIO_GPIO_FUNC53_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC53_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC53_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC53_IN_SEL_S 0 + +#define GPIO_FUNC54_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0208) +#define GPIO_GPIO_SIG54_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG54_IN_SEL_S 7 +#define GPIO_GPIO_FUNC54_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC54_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC54_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC54_IN_SEL_S 0 + +#define GPIO_FUNC55_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x020c) +#define GPIO_GPIO_SIG55_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG55_IN_SEL_S 7 +#define GPIO_GPIO_FUNC55_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC55_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC55_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC55_IN_SEL_S 0 + +#define GPIO_FUNC56_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0210) +#define GPIO_GPIO_SIG56_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG56_IN_SEL_S 7 +#define GPIO_GPIO_FUNC56_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC56_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC56_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC56_IN_SEL_S 0 + +#define GPIO_FUNC57_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0214) +#define GPIO_GPIO_SIG57_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG57_IN_SEL_S 7 +#define GPIO_GPIO_FUNC57_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC57_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC57_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC57_IN_SEL_S 0 + +#define GPIO_FUNC58_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0218) +#define GPIO_GPIO_SIG58_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG58_IN_SEL_S 7 +#define GPIO_GPIO_FUNC58_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC58_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC58_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC58_IN_SEL_S 0 + +#define GPIO_FUNC59_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x021c) +#define GPIO_GPIO_SIG59_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG59_IN_SEL_S 7 +#define GPIO_GPIO_FUNC59_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC59_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC59_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC59_IN_SEL_S 0 + +#define GPIO_FUNC60_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0220) +#define GPIO_GPIO_SIG60_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG60_IN_SEL_S 7 +#define GPIO_GPIO_FUNC60_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC60_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC60_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC60_IN_SEL_S 0 + +#define GPIO_FUNC61_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0224) +#define GPIO_GPIO_SIG61_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG61_IN_SEL_S 7 +#define GPIO_GPIO_FUNC61_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC61_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC61_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC61_IN_SEL_S 0 + +#define GPIO_FUNC62_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0228) +#define GPIO_GPIO_SIG62_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG62_IN_SEL_S 7 +#define GPIO_GPIO_FUNC62_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC62_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC62_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC62_IN_SEL_S 0 + +#define GPIO_FUNC63_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x022c) +#define GPIO_GPIO_SIG63_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG63_IN_SEL_S 7 +#define GPIO_GPIO_FUNC63_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC63_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC63_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC63_IN_SEL_S 0 + +#define GPIO_FUNC64_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0230) +#define GPIO_GPIO_SIG64_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG64_IN_SEL_S 7 +#define GPIO_GPIO_FUNC64_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC64_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC64_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC64_IN_SEL_S 0 + +#define GPIO_FUNC65_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0234) +#define GPIO_GPIO_SIG65_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG65_IN_SEL_S 7 +#define GPIO_GPIO_FUNC65_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC65_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC65_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC65_IN_SEL_S 0 + +#define GPIO_FUNC66_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0238) +#define GPIO_GPIO_SIG66_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG66_IN_SEL_S 7 +#define GPIO_GPIO_FUNC66_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC66_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC66_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC66_IN_SEL_S 0 + +#define GPIO_FUNC67_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x023c) +#define GPIO_GPIO_SIG67_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG67_IN_SEL_S 7 +#define GPIO_GPIO_FUNC67_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC67_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC67_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC67_IN_SEL_S 0 + +#define GPIO_FUNC68_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0240) +#define GPIO_GPIO_SIG68_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG68_IN_SEL_S 7 +#define GPIO_GPIO_FUNC68_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC68_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC68_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC68_IN_SEL_S 0 + +#define GPIO_FUNC69_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0244) +#define GPIO_GPIO_SIG69_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG69_IN_SEL_S 7 +#define GPIO_GPIO_FUNC69_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC69_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC69_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC69_IN_SEL_S 0 + +#define GPIO_FUNC70_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0248) +#define GPIO_GPIO_SIG70_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG70_IN_SEL_S 7 +#define GPIO_GPIO_FUNC70_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC70_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC70_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC70_IN_SEL_S 0 + +#define GPIO_FUNC71_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x024c) +#define GPIO_GPIO_SIG71_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG71_IN_SEL_S 7 +#define GPIO_GPIO_FUNC71_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC71_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC71_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC71_IN_SEL_S 0 + +#define GPIO_FUNC72_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0250) +#define GPIO_GPIO_SIG72_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG72_IN_SEL_S 7 +#define GPIO_GPIO_FUNC72_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC72_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC72_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC72_IN_SEL_S 0 + +#define GPIO_FUNC73_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0254) +#define GPIO_GPIO_SIG73_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG73_IN_SEL_S 7 +#define GPIO_GPIO_FUNC73_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC73_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC73_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC73_IN_SEL_S 0 + +#define GPIO_FUNC74_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0258) +#define GPIO_GPIO_SIG74_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG74_IN_SEL_S 7 +#define GPIO_GPIO_FUNC74_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC74_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC74_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC74_IN_SEL_S 0 + +#define GPIO_FUNC75_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x025c) +#define GPIO_GPIO_SIG75_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG75_IN_SEL_S 7 +#define GPIO_GPIO_FUNC75_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC75_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC75_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC75_IN_SEL_S 0 + +#define GPIO_FUNC76_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0260) +#define GPIO_GPIO_SIG76_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG76_IN_SEL_S 7 +#define GPIO_GPIO_FUNC76_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC76_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC76_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC76_IN_SEL_S 0 + +#define GPIO_FUNC77_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0264) +#define GPIO_GPIO_SIG77_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG77_IN_SEL_S 7 +#define GPIO_GPIO_FUNC77_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC77_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC77_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC77_IN_SEL_S 0 + +#define GPIO_FUNC78_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0268) +#define GPIO_GPIO_SIG78_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG78_IN_SEL_S 7 +#define GPIO_GPIO_FUNC78_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC78_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC78_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC78_IN_SEL_S 0 + +#define GPIO_FUNC79_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x026c) +#define GPIO_GPIO_SIG79_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG79_IN_SEL_S 7 +#define GPIO_GPIO_FUNC79_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC79_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC79_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC79_IN_SEL_S 0 + +#define GPIO_FUNC80_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0270) +#define GPIO_GPIO_SIG80_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG80_IN_SEL_S 7 +#define GPIO_GPIO_FUNC80_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC80_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC80_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC80_IN_SEL_S 0 + +#define GPIO_FUNC81_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0274) +#define GPIO_GPIO_SIG81_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG81_IN_SEL_S 7 +#define GPIO_GPIO_FUNC81_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC81_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC81_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC81_IN_SEL_S 0 + +#define GPIO_FUNC82_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0278) +#define GPIO_GPIO_SIG82_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG82_IN_SEL_S 7 +#define GPIO_GPIO_FUNC82_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC82_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC82_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC82_IN_SEL_S 0 + +#define GPIO_FUNC83_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x027c) +#define GPIO_GPIO_SIG83_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG83_IN_SEL_S 7 +#define GPIO_GPIO_FUNC83_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC83_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC83_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC83_IN_SEL_S 0 + +#define GPIO_FUNC84_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0280) +#define GPIO_GPIO_SIG84_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG84_IN_SEL_S 7 +#define GPIO_GPIO_FUNC84_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC84_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC84_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC84_IN_SEL_S 0 + +#define GPIO_FUNC85_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0284) +#define GPIO_GPIO_SIG85_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG85_IN_SEL_S 7 +#define GPIO_GPIO_FUNC85_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC85_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC85_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC85_IN_SEL_S 0 + +#define GPIO_FUNC86_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0288) +#define GPIO_GPIO_SIG86_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG86_IN_SEL_S 7 +#define GPIO_GPIO_FUNC86_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC86_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC86_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC86_IN_SEL_S 0 + +#define GPIO_FUNC87_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x028c) +#define GPIO_GPIO_SIG87_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG87_IN_SEL_S 7 +#define GPIO_GPIO_FUNC87_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC87_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC87_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC87_IN_SEL_S 0 + +#define GPIO_FUNC88_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0290) +#define GPIO_GPIO_SIG88_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG88_IN_SEL_S 7 +#define GPIO_GPIO_FUNC88_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC88_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC88_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC88_IN_SEL_S 0 + +#define GPIO_FUNC89_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0294) +#define GPIO_GPIO_SIG89_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG89_IN_SEL_S 7 +#define GPIO_GPIO_FUNC89_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC89_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC89_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC89_IN_SEL_S 0 + +#define GPIO_FUNC90_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0298) +#define GPIO_GPIO_SIG90_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG90_IN_SEL_S 7 +#define GPIO_GPIO_FUNC90_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC90_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC90_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC90_IN_SEL_S 0 + +#define GPIO_FUNC91_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x029c) +#define GPIO_GPIO_SIG91_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG91_IN_SEL_S 7 +#define GPIO_GPIO_FUNC91_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC91_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC91_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC91_IN_SEL_S 0 + +#define GPIO_FUNC92_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02a0) +#define GPIO_GPIO_SIG92_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG92_IN_SEL_S 7 +#define GPIO_GPIO_FUNC92_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC92_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC92_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC92_IN_SEL_S 0 + +#define GPIO_FUNC93_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02a4) +#define GPIO_GPIO_SIG93_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG93_IN_SEL_S 7 +#define GPIO_GPIO_FUNC93_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC93_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC93_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC93_IN_SEL_S 0 + +#define GPIO_FUNC94_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02a8) +#define GPIO_GPIO_SIG94_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG94_IN_SEL_S 7 +#define GPIO_GPIO_FUNC94_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC94_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC94_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC94_IN_SEL_S 0 + +#define GPIO_FUNC95_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02ac) +#define GPIO_GPIO_SIG95_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG95_IN_SEL_S 7 +#define GPIO_GPIO_FUNC95_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC95_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC95_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC95_IN_SEL_S 0 + +#define GPIO_FUNC96_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02b0) +#define GPIO_GPIO_SIG96_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG96_IN_SEL_S 7 +#define GPIO_GPIO_FUNC96_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC96_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC96_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC96_IN_SEL_S 0 + +#define GPIO_FUNC97_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02b4) +#define GPIO_GPIO_SIG97_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG97_IN_SEL_S 7 +#define GPIO_GPIO_FUNC97_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC97_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC97_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC97_IN_SEL_S 0 + +#define GPIO_FUNC98_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02b8) +#define GPIO_GPIO_SIG98_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG98_IN_SEL_S 7 +#define GPIO_GPIO_FUNC98_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC98_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC98_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC98_IN_SEL_S 0 + +#define GPIO_FUNC99_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02bc) +#define GPIO_GPIO_SIG99_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG99_IN_SEL_S 7 +#define GPIO_GPIO_FUNC99_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC99_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC99_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC99_IN_SEL_S 0 + +#define GPIO_FUNC100_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02c0) +#define GPIO_GPIO_SIG100_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG100_IN_SEL_S 7 +#define GPIO_GPIO_FUNC100_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC100_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC100_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC100_IN_SEL_S 0 + +#define GPIO_FUNC101_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02c4) +#define GPIO_GPIO_SIG101_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG101_IN_SEL_S 7 +#define GPIO_GPIO_FUNC101_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC101_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC101_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC101_IN_SEL_S 0 + +#define GPIO_FUNC102_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02c8) +#define GPIO_GPIO_SIG102_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG102_IN_SEL_S 7 +#define GPIO_GPIO_FUNC102_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC102_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC102_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC102_IN_SEL_S 0 + +#define GPIO_FUNC103_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02cc) +#define GPIO_GPIO_SIG103_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG103_IN_SEL_S 7 +#define GPIO_GPIO_FUNC103_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC103_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC103_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC103_IN_SEL_S 0 + +#define GPIO_FUNC104_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02d0) +#define GPIO_GPIO_SIG104_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG104_IN_SEL_S 7 +#define GPIO_GPIO_FUNC104_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC104_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC104_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC104_IN_SEL_S 0 + +#define GPIO_FUNC105_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02d4) +#define GPIO_GPIO_SIG105_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG105_IN_SEL_S 7 +#define GPIO_GPIO_FUNC105_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC105_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC105_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC105_IN_SEL_S 0 + +#define GPIO_FUNC106_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02d8) +#define GPIO_GPIO_SIG106_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG106_IN_SEL_S 7 +#define GPIO_GPIO_FUNC106_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC106_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC106_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC106_IN_SEL_S 0 + +#define GPIO_FUNC107_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02dc) +#define GPIO_GPIO_SIG107_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG107_IN_SEL_S 7 +#define GPIO_GPIO_FUNC107_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC107_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC107_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC107_IN_SEL_S 0 + +#define GPIO_FUNC108_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02e0) +#define GPIO_GPIO_SIG108_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG108_IN_SEL_S 7 +#define GPIO_GPIO_FUNC108_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC108_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC108_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC108_IN_SEL_S 0 + +#define GPIO_FUNC109_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02e4) +#define GPIO_GPIO_SIG109_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG109_IN_SEL_S 7 +#define GPIO_GPIO_FUNC109_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC109_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC109_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC109_IN_SEL_S 0 + +#define GPIO_FUNC110_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02e8) +#define GPIO_GPIO_SIG110_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG110_IN_SEL_S 7 +#define GPIO_GPIO_FUNC110_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC110_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC110_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC110_IN_SEL_S 0 + +#define GPIO_FUNC111_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02ec) +#define GPIO_GPIO_SIG111_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG111_IN_SEL_S 7 +#define GPIO_GPIO_FUNC111_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC111_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC111_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC111_IN_SEL_S 0 + +#define GPIO_FUNC112_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02f0) +#define GPIO_GPIO_SIG112_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG112_IN_SEL_S 7 +#define GPIO_GPIO_FUNC112_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC112_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC112_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC112_IN_SEL_S 0 + +#define GPIO_FUNC113_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02f4) +#define GPIO_GPIO_SIG113_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG113_IN_SEL_S 7 +#define GPIO_GPIO_FUNC113_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC113_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC113_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC113_IN_SEL_S 0 + +#define GPIO_FUNC114_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02f8) +#define GPIO_GPIO_SIG114_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG114_IN_SEL_S 7 +#define GPIO_GPIO_FUNC114_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC114_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC114_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC114_IN_SEL_S 0 + +#define GPIO_FUNC115_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x02fc) +#define GPIO_GPIO_SIG115_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG115_IN_SEL_S 7 +#define GPIO_GPIO_FUNC115_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC115_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC115_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC115_IN_SEL_S 0 + +#define GPIO_FUNC116_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0300) +#define GPIO_GPIO_SIG116_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG116_IN_SEL_S 7 +#define GPIO_GPIO_FUNC116_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC116_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC116_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC116_IN_SEL_S 0 + +#define GPIO_FUNC117_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0304) +#define GPIO_GPIO_SIG117_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG117_IN_SEL_S 7 +#define GPIO_GPIO_FUNC117_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC117_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC117_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC117_IN_SEL_S 0 + +#define GPIO_FUNC118_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0308) +#define GPIO_GPIO_SIG118_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG118_IN_SEL_S 7 +#define GPIO_GPIO_FUNC118_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC118_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC118_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC118_IN_SEL_S 0 + +#define GPIO_FUNC119_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x030c) +#define GPIO_GPIO_SIG119_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG119_IN_SEL_S 7 +#define GPIO_GPIO_FUNC119_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC119_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC119_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC119_IN_SEL_S 0 + +#define GPIO_FUNC120_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0310) +#define GPIO_GPIO_SIG120_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG120_IN_SEL_S 7 +#define GPIO_GPIO_FUNC120_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC120_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC120_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC120_IN_SEL_S 0 + +#define GPIO_FUNC121_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0314) +#define GPIO_GPIO_SIG121_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG121_IN_SEL_S 7 +#define GPIO_GPIO_FUNC121_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC121_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC121_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC121_IN_SEL_S 0 + +#define GPIO_FUNC122_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0318) +#define GPIO_GPIO_SIG122_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG122_IN_SEL_S 7 +#define GPIO_GPIO_FUNC122_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC122_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC122_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC122_IN_SEL_S 0 + +#define GPIO_FUNC123_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x031c) +#define GPIO_GPIO_SIG123_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG123_IN_SEL_S 7 +#define GPIO_GPIO_FUNC123_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC123_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC123_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC123_IN_SEL_S 0 + +#define GPIO_FUNC124_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0320) +#define GPIO_GPIO_SIG124_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG124_IN_SEL_S 7 +#define GPIO_GPIO_FUNC124_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC124_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC124_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC124_IN_SEL_S 0 + +#define GPIO_FUNC125_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0324) +#define GPIO_GPIO_SIG125_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG125_IN_SEL_S 7 +#define GPIO_GPIO_FUNC125_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC125_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC125_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC125_IN_SEL_S 0 + +#define GPIO_FUNC126_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0328) +#define GPIO_GPIO_SIG126_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG126_IN_SEL_S 7 +#define GPIO_GPIO_FUNC126_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC126_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC126_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC126_IN_SEL_S 0 + +#define GPIO_FUNC127_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x032c) +#define GPIO_GPIO_SIG127_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG127_IN_SEL_S 7 +#define GPIO_GPIO_FUNC127_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC127_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC127_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC127_IN_SEL_S 0 + +#define GPIO_FUNC128_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0330) +#define GPIO_GPIO_SIG128_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG128_IN_SEL_S 7 +#define GPIO_GPIO_FUNC128_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC128_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC128_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC128_IN_SEL_S 0 + +#define GPIO_FUNC129_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0334) +#define GPIO_GPIO_SIG129_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG129_IN_SEL_S 7 +#define GPIO_GPIO_FUNC129_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC129_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC129_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC129_IN_SEL_S 0 + +#define GPIO_FUNC130_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0338) +#define GPIO_GPIO_SIG130_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG130_IN_SEL_S 7 +#define GPIO_GPIO_FUNC130_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC130_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC130_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC130_IN_SEL_S 0 + +#define GPIO_FUNC131_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x033c) +#define GPIO_GPIO_SIG131_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG131_IN_SEL_S 7 +#define GPIO_GPIO_FUNC131_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC131_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC131_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC131_IN_SEL_S 0 + +#define GPIO_FUNC132_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0340) +#define GPIO_GPIO_SIG132_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG132_IN_SEL_S 7 +#define GPIO_GPIO_FUNC132_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC132_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC132_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC132_IN_SEL_S 0 + +#define GPIO_FUNC133_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0344) +#define GPIO_GPIO_SIG133_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG133_IN_SEL_S 7 +#define GPIO_GPIO_FUNC133_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC133_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC133_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC133_IN_SEL_S 0 + +#define GPIO_FUNC134_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0348) +#define GPIO_GPIO_SIG134_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG134_IN_SEL_S 7 +#define GPIO_GPIO_FUNC134_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC134_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC134_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC134_IN_SEL_S 0 + +#define GPIO_FUNC135_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x034c) +#define GPIO_GPIO_SIG135_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG135_IN_SEL_S 7 +#define GPIO_GPIO_FUNC135_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC135_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC135_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC135_IN_SEL_S 0 + +#define GPIO_FUNC136_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0350) +#define GPIO_GPIO_SIG136_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG136_IN_SEL_S 7 +#define GPIO_GPIO_FUNC136_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC136_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC136_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC136_IN_SEL_S 0 + +#define GPIO_FUNC137_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0354) +#define GPIO_GPIO_SIG137_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG137_IN_SEL_S 7 +#define GPIO_GPIO_FUNC137_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC137_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC137_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC137_IN_SEL_S 0 + +#define GPIO_FUNC138_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0358) +#define GPIO_GPIO_SIG138_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG138_IN_SEL_S 7 +#define GPIO_GPIO_FUNC138_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC138_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC138_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC138_IN_SEL_S 0 + +#define GPIO_FUNC139_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x035c) +#define GPIO_GPIO_SIG139_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG139_IN_SEL_S 7 +#define GPIO_GPIO_FUNC139_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC139_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC139_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC139_IN_SEL_S 0 + +#define GPIO_FUNC140_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0360) +#define GPIO_GPIO_SIG140_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG140_IN_SEL_S 7 +#define GPIO_GPIO_FUNC140_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC140_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC140_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC140_IN_SEL_S 0 + +#define GPIO_FUNC141_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0364) +#define GPIO_GPIO_SIG141_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG141_IN_SEL_S 7 +#define GPIO_GPIO_FUNC141_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC141_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC141_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC141_IN_SEL_S 0 + +#define GPIO_FUNC142_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0368) +#define GPIO_GPIO_SIG142_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG142_IN_SEL_S 7 +#define GPIO_GPIO_FUNC142_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC142_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC142_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC142_IN_SEL_S 0 + +#define GPIO_FUNC143_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x036c) +#define GPIO_GPIO_SIG143_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG143_IN_SEL_S 7 +#define GPIO_GPIO_FUNC143_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC143_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC143_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC143_IN_SEL_S 0 + +#define GPIO_FUNC144_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0370) +#define GPIO_GPIO_SIG144_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG144_IN_SEL_S 7 +#define GPIO_GPIO_FUNC144_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC144_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC144_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC144_IN_SEL_S 0 + +#define GPIO_FUNC145_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0374) +#define GPIO_GPIO_SIG145_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG145_IN_SEL_S 7 +#define GPIO_GPIO_FUNC145_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC145_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC145_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC145_IN_SEL_S 0 + +#define GPIO_FUNC146_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0378) +#define GPIO_GPIO_SIG146_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG146_IN_SEL_S 7 +#define GPIO_GPIO_FUNC146_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC146_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC146_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC146_IN_SEL_S 0 + +#define GPIO_FUNC147_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x037c) +#define GPIO_GPIO_SIG147_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG147_IN_SEL_S 7 +#define GPIO_GPIO_FUNC147_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC147_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC147_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC147_IN_SEL_S 0 + +#define GPIO_FUNC148_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0380) +#define GPIO_GPIO_SIG148_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG148_IN_SEL_S 7 +#define GPIO_GPIO_FUNC148_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC148_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC148_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC148_IN_SEL_S 0 + +#define GPIO_FUNC149_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0384) +#define GPIO_GPIO_SIG149_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG149_IN_SEL_S 7 +#define GPIO_GPIO_FUNC149_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC149_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC149_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC149_IN_SEL_S 0 + +#define GPIO_FUNC150_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0388) +#define GPIO_GPIO_SIG150_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG150_IN_SEL_S 7 +#define GPIO_GPIO_FUNC150_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC150_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC150_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC150_IN_SEL_S 0 + +#define GPIO_FUNC151_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x038c) +#define GPIO_GPIO_SIG151_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG151_IN_SEL_S 7 +#define GPIO_GPIO_FUNC151_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC151_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC151_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC151_IN_SEL_S 0 + +#define GPIO_FUNC152_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0390) +#define GPIO_GPIO_SIG152_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG152_IN_SEL_S 7 +#define GPIO_GPIO_FUNC152_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC152_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC152_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC152_IN_SEL_S 0 + +#define GPIO_FUNC153_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0394) +#define GPIO_GPIO_SIG153_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG153_IN_SEL_S 7 +#define GPIO_GPIO_FUNC153_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC153_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC153_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC153_IN_SEL_S 0 + +#define GPIO_FUNC154_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0398) +#define GPIO_GPIO_SIG154_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG154_IN_SEL_S 7 +#define GPIO_GPIO_FUNC154_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC154_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC154_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC154_IN_SEL_S 0 + +#define GPIO_FUNC155_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x039c) +#define GPIO_GPIO_SIG155_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG155_IN_SEL_S 7 +#define GPIO_GPIO_FUNC155_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC155_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC155_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC155_IN_SEL_S 0 + +#define GPIO_FUNC156_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03a0) +#define GPIO_GPIO_SIG156_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG156_IN_SEL_S 7 +#define GPIO_GPIO_FUNC156_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC156_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC156_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC156_IN_SEL_S 0 + +#define GPIO_FUNC157_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03a4) +#define GPIO_GPIO_SIG157_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG157_IN_SEL_S 7 +#define GPIO_GPIO_FUNC157_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC157_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC157_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC157_IN_SEL_S 0 + +#define GPIO_FUNC158_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03a8) +#define GPIO_GPIO_SIG158_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG158_IN_SEL_S 7 +#define GPIO_GPIO_FUNC158_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC158_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC158_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC158_IN_SEL_S 0 + +#define GPIO_FUNC159_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03ac) +#define GPIO_GPIO_SIG159_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG159_IN_SEL_S 7 +#define GPIO_GPIO_FUNC159_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC159_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC159_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC159_IN_SEL_S 0 + +#define GPIO_FUNC160_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03b0) +#define GPIO_GPIO_SIG160_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG160_IN_SEL_S 7 +#define GPIO_GPIO_FUNC160_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC160_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC160_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC160_IN_SEL_S 0 + +#define GPIO_FUNC161_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03b4) +#define GPIO_GPIO_SIG161_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG161_IN_SEL_S 7 +#define GPIO_GPIO_FUNC161_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC161_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC161_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC161_IN_SEL_S 0 + +#define GPIO_FUNC162_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03b8) +#define GPIO_GPIO_SIG162_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG162_IN_SEL_S 7 +#define GPIO_GPIO_FUNC162_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC162_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC162_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC162_IN_SEL_S 0 + +#define GPIO_FUNC163_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03bc) +#define GPIO_GPIO_SIG163_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG163_IN_SEL_S 7 +#define GPIO_GPIO_FUNC163_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC163_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC163_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC163_IN_SEL_S 0 + +#define GPIO_FUNC164_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03c0) +#define GPIO_GPIO_SIG164_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG164_IN_SEL_S 7 +#define GPIO_GPIO_FUNC164_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC164_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC164_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC164_IN_SEL_S 0 + +#define GPIO_FUNC165_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03c4) +#define GPIO_GPIO_SIG165_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG165_IN_SEL_S 7 +#define GPIO_GPIO_FUNC165_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC165_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC165_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC165_IN_SEL_S 0 + +#define GPIO_FUNC166_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03c8) +#define GPIO_GPIO_SIG166_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG166_IN_SEL_S 7 +#define GPIO_GPIO_FUNC166_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC166_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC166_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC166_IN_SEL_S 0 + +#define GPIO_FUNC167_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03cc) +#define GPIO_GPIO_SIG167_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG167_IN_SEL_S 7 +#define GPIO_GPIO_FUNC167_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC167_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC167_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC167_IN_SEL_S 0 + +#define GPIO_FUNC168_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03d0) +#define GPIO_GPIO_SIG168_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG168_IN_SEL_S 7 +#define GPIO_GPIO_FUNC168_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC168_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC168_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC168_IN_SEL_S 0 + +#define GPIO_FUNC169_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03d4) +#define GPIO_GPIO_SIG169_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG169_IN_SEL_S 7 +#define GPIO_GPIO_FUNC169_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC169_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC169_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC169_IN_SEL_S 0 + +#define GPIO_FUNC170_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03d8) +#define GPIO_GPIO_SIG170_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG170_IN_SEL_S 7 +#define GPIO_GPIO_FUNC170_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC170_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC170_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC170_IN_SEL_S 0 + +#define GPIO_FUNC171_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03dc) +#define GPIO_GPIO_SIG171_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG171_IN_SEL_S 7 +#define GPIO_GPIO_FUNC171_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC171_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC171_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC171_IN_SEL_S 0 + +#define GPIO_FUNC172_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03e0) +#define GPIO_GPIO_SIG172_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG172_IN_SEL_S 7 +#define GPIO_GPIO_FUNC172_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC172_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC172_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC172_IN_SEL_S 0 + +#define GPIO_FUNC173_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03e4) +#define GPIO_GPIO_SIG173_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG173_IN_SEL_S 7 +#define GPIO_GPIO_FUNC173_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC173_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC173_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC173_IN_SEL_S 0 + +#define GPIO_FUNC174_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03e8) +#define GPIO_GPIO_SIG174_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG174_IN_SEL_S 7 +#define GPIO_GPIO_FUNC174_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC174_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC174_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC174_IN_SEL_S 0 + +#define GPIO_FUNC175_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03ec) +#define GPIO_GPIO_SIG175_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG175_IN_SEL_S 7 +#define GPIO_GPIO_FUNC175_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC175_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC175_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC175_IN_SEL_S 0 + +#define GPIO_FUNC176_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03f0) +#define GPIO_GPIO_SIG176_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG176_IN_SEL_S 7 +#define GPIO_GPIO_FUNC176_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC176_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC176_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC176_IN_SEL_S 0 + +#define GPIO_FUNC177_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03f4) +#define GPIO_GPIO_SIG177_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG177_IN_SEL_S 7 +#define GPIO_GPIO_FUNC177_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC177_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC177_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC177_IN_SEL_S 0 + +#define GPIO_FUNC178_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03f8) +#define GPIO_GPIO_SIG178_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG178_IN_SEL_S 7 +#define GPIO_GPIO_FUNC178_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC178_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC178_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC178_IN_SEL_S 0 + +#define GPIO_FUNC179_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x03fc) +#define GPIO_GPIO_SIG179_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG179_IN_SEL_S 7 +#define GPIO_GPIO_FUNC179_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC179_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC179_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC179_IN_SEL_S 0 + +#define GPIO_FUNC180_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0400) +#define GPIO_GPIO_SIG180_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG180_IN_SEL_S 7 +#define GPIO_GPIO_FUNC180_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC180_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC180_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC180_IN_SEL_S 0 + +#define GPIO_FUNC181_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0404) +#define GPIO_GPIO_SIG181_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG181_IN_SEL_S 7 +#define GPIO_GPIO_FUNC181_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC181_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC181_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC181_IN_SEL_S 0 + +#define GPIO_FUNC182_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0408) +#define GPIO_GPIO_SIG182_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG182_IN_SEL_S 7 +#define GPIO_GPIO_FUNC182_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC182_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC182_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC182_IN_SEL_S 0 + +#define GPIO_FUNC183_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x040c) +#define GPIO_GPIO_SIG183_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG183_IN_SEL_S 7 +#define GPIO_GPIO_FUNC183_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC183_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC183_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC183_IN_SEL_S 0 + +#define GPIO_FUNC184_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0410) +#define GPIO_GPIO_SIG184_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG184_IN_SEL_S 7 +#define GPIO_GPIO_FUNC184_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC184_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC184_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC184_IN_SEL_S 0 + +#define GPIO_FUNC185_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0414) +#define GPIO_GPIO_SIG185_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG185_IN_SEL_S 7 +#define GPIO_GPIO_FUNC185_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC185_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC185_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC185_IN_SEL_S 0 + +#define GPIO_FUNC186_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0418) +#define GPIO_GPIO_SIG186_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG186_IN_SEL_S 7 +#define GPIO_GPIO_FUNC186_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC186_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC186_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC186_IN_SEL_S 0 + +#define GPIO_FUNC187_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x041c) +#define GPIO_GPIO_SIG187_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG187_IN_SEL_S 7 +#define GPIO_GPIO_FUNC187_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC187_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC187_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC187_IN_SEL_S 0 + +#define GPIO_FUNC188_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0420) +#define GPIO_GPIO_SIG188_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG188_IN_SEL_S 7 +#define GPIO_GPIO_FUNC188_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC188_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC188_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC188_IN_SEL_S 0 + +#define GPIO_FUNC189_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0424) +#define GPIO_GPIO_SIG189_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG189_IN_SEL_S 7 +#define GPIO_GPIO_FUNC189_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC189_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC189_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC189_IN_SEL_S 0 + +#define GPIO_FUNC190_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0428) +#define GPIO_GPIO_SIG190_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG190_IN_SEL_S 7 +#define GPIO_GPIO_FUNC190_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC190_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC190_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC190_IN_SEL_S 0 + +#define GPIO_FUNC191_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x042c) +#define GPIO_GPIO_SIG191_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG191_IN_SEL_S 7 +#define GPIO_GPIO_FUNC191_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC191_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC191_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC191_IN_SEL_S 0 + +#define GPIO_FUNC192_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0430) +#define GPIO_GPIO_SIG192_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG192_IN_SEL_S 7 +#define GPIO_GPIO_FUNC192_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC192_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC192_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC192_IN_SEL_S 0 + +#define GPIO_FUNC193_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0434) +#define GPIO_GPIO_SIG193_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG193_IN_SEL_S 7 +#define GPIO_GPIO_FUNC193_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC193_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC193_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC193_IN_SEL_S 0 + +#define GPIO_FUNC194_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0438) +#define GPIO_GPIO_SIG194_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG194_IN_SEL_S 7 +#define GPIO_GPIO_FUNC194_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC194_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC194_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC194_IN_SEL_S 0 + +#define GPIO_FUNC195_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x043c) +#define GPIO_GPIO_SIG195_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG195_IN_SEL_S 7 +#define GPIO_GPIO_FUNC195_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC195_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC195_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC195_IN_SEL_S 0 + +#define GPIO_FUNC196_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0440) +#define GPIO_GPIO_SIG196_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG196_IN_SEL_S 7 +#define GPIO_GPIO_FUNC196_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC196_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC196_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC196_IN_SEL_S 0 + +#define GPIO_FUNC197_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0444) +#define GPIO_GPIO_SIG197_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG197_IN_SEL_S 7 +#define GPIO_GPIO_FUNC197_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC197_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC197_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC197_IN_SEL_S 0 + +#define GPIO_FUNC198_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0448) +#define GPIO_GPIO_SIG198_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG198_IN_SEL_S 7 +#define GPIO_GPIO_FUNC198_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC198_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC198_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC198_IN_SEL_S 0 + +#define GPIO_FUNC199_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x044c) +#define GPIO_GPIO_SIG199_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG199_IN_SEL_S 7 +#define GPIO_GPIO_FUNC199_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC199_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC199_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC199_IN_SEL_S 0 + +#define GPIO_FUNC200_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0450) +#define GPIO_GPIO_SIG200_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG200_IN_SEL_S 7 +#define GPIO_GPIO_FUNC200_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC200_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC200_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC200_IN_SEL_S 0 + +#define GPIO_FUNC201_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0454) +#define GPIO_GPIO_SIG201_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG201_IN_SEL_S 7 +#define GPIO_GPIO_FUNC201_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC201_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC201_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC201_IN_SEL_S 0 + +#define GPIO_FUNC202_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0458) +#define GPIO_GPIO_SIG202_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG202_IN_SEL_S 7 +#define GPIO_GPIO_FUNC202_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC202_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC202_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC202_IN_SEL_S 0 + +#define GPIO_FUNC203_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x045c) +#define GPIO_GPIO_SIG203_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG203_IN_SEL_S 7 +#define GPIO_GPIO_FUNC203_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC203_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC203_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC203_IN_SEL_S 0 + +#define GPIO_FUNC204_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0460) +#define GPIO_GPIO_SIG204_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG204_IN_SEL_S 7 +#define GPIO_GPIO_FUNC204_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC204_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC204_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC204_IN_SEL_S 0 + +#define GPIO_FUNC205_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0464) +#define GPIO_GPIO_SIG205_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG205_IN_SEL_S 7 +#define GPIO_GPIO_FUNC205_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC205_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC205_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC205_IN_SEL_S 0 + +#define GPIO_FUNC206_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0468) +#define GPIO_GPIO_SIG206_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG206_IN_SEL_S 7 +#define GPIO_GPIO_FUNC206_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC206_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC206_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC206_IN_SEL_S 0 + +#define GPIO_FUNC207_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x046c) +#define GPIO_GPIO_SIG207_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG207_IN_SEL_S 7 +#define GPIO_GPIO_FUNC207_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC207_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC207_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC207_IN_SEL_S 0 + +#define GPIO_FUNC208_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0470) +#define GPIO_GPIO_SIG208_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG208_IN_SEL_S 7 +#define GPIO_GPIO_FUNC208_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC208_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC208_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC208_IN_SEL_S 0 + +#define GPIO_FUNC209_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0474) +#define GPIO_GPIO_SIG209_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG209_IN_SEL_S 7 +#define GPIO_GPIO_FUNC209_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC209_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC209_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC209_IN_SEL_S 0 + +#define GPIO_FUNC210_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0478) +#define GPIO_GPIO_SIG210_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG210_IN_SEL_S 7 +#define GPIO_GPIO_FUNC210_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC210_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC210_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC210_IN_SEL_S 0 + +#define GPIO_FUNC211_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x047c) +#define GPIO_GPIO_SIG211_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG211_IN_SEL_S 7 +#define GPIO_GPIO_FUNC211_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC211_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC211_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC211_IN_SEL_S 0 + +#define GPIO_FUNC212_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0480) +#define GPIO_GPIO_SIG212_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG212_IN_SEL_S 7 +#define GPIO_GPIO_FUNC212_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC212_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC212_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC212_IN_SEL_S 0 + +#define GPIO_FUNC213_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0484) +#define GPIO_GPIO_SIG213_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG213_IN_SEL_S 7 +#define GPIO_GPIO_FUNC213_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC213_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC213_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC213_IN_SEL_S 0 + +#define GPIO_FUNC214_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0488) +#define GPIO_GPIO_SIG214_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG214_IN_SEL_S 7 +#define GPIO_GPIO_FUNC214_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC214_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC214_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC214_IN_SEL_S 0 + +#define GPIO_FUNC215_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x048c) +#define GPIO_GPIO_SIG215_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG215_IN_SEL_S 7 +#define GPIO_GPIO_FUNC215_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC215_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC215_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC215_IN_SEL_S 0 + +#define GPIO_FUNC216_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0490) +#define GPIO_GPIO_SIG216_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG216_IN_SEL_S 7 +#define GPIO_GPIO_FUNC216_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC216_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC216_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC216_IN_SEL_S 0 + +#define GPIO_FUNC217_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0494) +#define GPIO_GPIO_SIG217_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG217_IN_SEL_S 7 +#define GPIO_GPIO_FUNC217_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC217_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC217_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC217_IN_SEL_S 0 + +#define GPIO_FUNC218_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0498) +#define GPIO_GPIO_SIG218_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG218_IN_SEL_S 7 +#define GPIO_GPIO_FUNC218_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC218_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC218_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC218_IN_SEL_S 0 + +#define GPIO_FUNC219_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x049c) +#define GPIO_GPIO_SIG219_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG219_IN_SEL_S 7 +#define GPIO_GPIO_FUNC219_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC219_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC219_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC219_IN_SEL_S 0 + +#define GPIO_FUNC220_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04a0) +#define GPIO_GPIO_SIG220_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG220_IN_SEL_S 7 +#define GPIO_GPIO_FUNC220_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC220_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC220_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC220_IN_SEL_S 0 + +#define GPIO_FUNC221_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04a4) +#define GPIO_GPIO_SIG221_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG221_IN_SEL_S 7 +#define GPIO_GPIO_FUNC221_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC221_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC221_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC221_IN_SEL_S 0 + +#define GPIO_FUNC222_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04a8) +#define GPIO_GPIO_SIG222_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG222_IN_SEL_S 7 +#define GPIO_GPIO_FUNC222_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC222_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC222_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC222_IN_SEL_S 0 + +#define GPIO_FUNC223_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04ac) +#define GPIO_GPIO_SIG223_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG223_IN_SEL_S 7 +#define GPIO_GPIO_FUNC223_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC223_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC223_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC223_IN_SEL_S 0 + +#define GPIO_FUNC224_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04b0) +#define GPIO_GPIO_SIG224_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG224_IN_SEL_S 7 +#define GPIO_GPIO_FUNC224_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC224_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC224_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC224_IN_SEL_S 0 + +#define GPIO_FUNC225_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04b4) +#define GPIO_GPIO_SIG225_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG225_IN_SEL_S 7 +#define GPIO_GPIO_FUNC225_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC225_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC225_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC225_IN_SEL_S 0 + +#define GPIO_FUNC226_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04b8) +#define GPIO_GPIO_SIG226_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG226_IN_SEL_S 7 +#define GPIO_GPIO_FUNC226_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC226_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC226_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC226_IN_SEL_S 0 + +#define GPIO_FUNC227_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04bc) +#define GPIO_GPIO_SIG227_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG227_IN_SEL_S 7 +#define GPIO_GPIO_FUNC227_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC227_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC227_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC227_IN_SEL_S 0 + +#define GPIO_FUNC228_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04c0) +#define GPIO_GPIO_SIG228_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG228_IN_SEL_S 7 +#define GPIO_GPIO_FUNC228_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC228_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC228_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC228_IN_SEL_S 0 + +#define GPIO_FUNC229_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04c4) +#define GPIO_GPIO_SIG229_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG229_IN_SEL_S 7 +#define GPIO_GPIO_FUNC229_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC229_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC229_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC229_IN_SEL_S 0 + +#define GPIO_FUNC230_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04c8) +#define GPIO_GPIO_SIG230_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG230_IN_SEL_S 7 +#define GPIO_GPIO_FUNC230_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC230_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC230_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC230_IN_SEL_S 0 + +#define GPIO_FUNC231_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04cc) +#define GPIO_GPIO_SIG231_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG231_IN_SEL_S 7 +#define GPIO_GPIO_FUNC231_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC231_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC231_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC231_IN_SEL_S 0 + +#define GPIO_FUNC232_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04d0) +#define GPIO_GPIO_SIG232_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG232_IN_SEL_S 7 +#define GPIO_GPIO_FUNC232_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC232_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC232_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC232_IN_SEL_S 0 + +#define GPIO_FUNC233_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04d4) +#define GPIO_GPIO_SIG233_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG233_IN_SEL_S 7 +#define GPIO_GPIO_FUNC233_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC233_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC233_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC233_IN_SEL_S 0 + +#define GPIO_FUNC234_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04d8) +#define GPIO_GPIO_SIG234_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG234_IN_SEL_S 7 +#define GPIO_GPIO_FUNC234_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC234_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC234_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC234_IN_SEL_S 0 + +#define GPIO_FUNC235_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04dc) +#define GPIO_GPIO_SIG235_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG235_IN_SEL_S 7 +#define GPIO_GPIO_FUNC235_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC235_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC235_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC235_IN_SEL_S 0 + +#define GPIO_FUNC236_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04e0) +#define GPIO_GPIO_SIG236_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG236_IN_SEL_S 7 +#define GPIO_GPIO_FUNC236_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC236_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC236_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC236_IN_SEL_S 0 + +#define GPIO_FUNC237_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04e4) +#define GPIO_GPIO_SIG237_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG237_IN_SEL_S 7 +#define GPIO_GPIO_FUNC237_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC237_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC237_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC237_IN_SEL_S 0 + +#define GPIO_FUNC238_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04e8) +#define GPIO_GPIO_SIG238_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG238_IN_SEL_S 7 +#define GPIO_GPIO_FUNC238_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC238_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC238_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC238_IN_SEL_S 0 + +#define GPIO_FUNC239_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04ec) +#define GPIO_GPIO_SIG239_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG239_IN_SEL_S 7 +#define GPIO_GPIO_FUNC239_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC239_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC239_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC239_IN_SEL_S 0 + +#define GPIO_FUNC240_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04f0) +#define GPIO_GPIO_SIG240_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG240_IN_SEL_S 7 +#define GPIO_GPIO_FUNC240_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC240_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC240_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC240_IN_SEL_S 0 + +#define GPIO_FUNC241_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04f4) +#define GPIO_GPIO_SIG241_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG241_IN_SEL_S 7 +#define GPIO_GPIO_FUNC241_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC241_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC241_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC241_IN_SEL_S 0 + +#define GPIO_FUNC242_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04f8) +#define GPIO_GPIO_SIG242_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG242_IN_SEL_S 7 +#define GPIO_GPIO_FUNC242_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC242_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC242_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC242_IN_SEL_S 0 + +#define GPIO_FUNC243_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x04fc) +#define GPIO_GPIO_SIG243_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG243_IN_SEL_S 7 +#define GPIO_GPIO_FUNC243_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC243_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC243_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC243_IN_SEL_S 0 + +#define GPIO_FUNC244_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0500) +#define GPIO_GPIO_SIG244_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG244_IN_SEL_S 7 +#define GPIO_GPIO_FUNC244_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC244_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC244_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC244_IN_SEL_S 0 + +#define GPIO_FUNC245_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0504) +#define GPIO_GPIO_SIG245_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG245_IN_SEL_S 7 +#define GPIO_GPIO_FUNC245_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC245_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC245_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC245_IN_SEL_S 0 + +#define GPIO_FUNC246_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0508) +#define GPIO_GPIO_SIG246_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG246_IN_SEL_S 7 +#define GPIO_GPIO_FUNC246_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC246_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC246_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC246_IN_SEL_S 0 + +#define GPIO_FUNC247_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x050c) +#define GPIO_GPIO_SIG247_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG247_IN_SEL_S 7 +#define GPIO_GPIO_FUNC247_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC247_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC247_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC247_IN_SEL_S 0 + +#define GPIO_FUNC248_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0510) +#define GPIO_GPIO_SIG248_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG248_IN_SEL_S 7 +#define GPIO_GPIO_FUNC248_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC248_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC248_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC248_IN_SEL_S 0 + +#define GPIO_FUNC249_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0514) +#define GPIO_GPIO_SIG249_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG249_IN_SEL_S 7 +#define GPIO_GPIO_FUNC249_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC249_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC249_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC249_IN_SEL_S 0 + +#define GPIO_FUNC250_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0518) +#define GPIO_GPIO_SIG250_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG250_IN_SEL_S 7 +#define GPIO_GPIO_FUNC250_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC250_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC250_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC250_IN_SEL_S 0 + +#define GPIO_FUNC251_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x051c) +#define GPIO_GPIO_SIG251_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG251_IN_SEL_S 7 +#define GPIO_GPIO_FUNC251_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC251_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC251_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC251_IN_SEL_S 0 + +#define GPIO_FUNC252_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0520) +#define GPIO_GPIO_SIG252_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG252_IN_SEL_S 7 +#define GPIO_GPIO_FUNC252_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC252_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC252_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC252_IN_SEL_S 0 + +#define GPIO_FUNC253_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0524) +#define GPIO_GPIO_SIG253_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG253_IN_SEL_S 7 +#define GPIO_GPIO_FUNC253_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC253_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC253_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC253_IN_SEL_S 0 + +#define GPIO_FUNC254_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x0528) +#define GPIO_GPIO_SIG254_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG254_IN_SEL_S 7 +#define GPIO_GPIO_FUNC254_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC254_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC254_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC254_IN_SEL_S 0 + +#define GPIO_FUNC255_IN_SEL_CFG (DR_REG_GPIO_BASE + 0x052c) +#define GPIO_GPIO_SIG255_IN_SEL (BIT(7)) +#define GPIO_GPIO_SIG255_IN_SEL_S 7 +#define GPIO_GPIO_FUNC255_IN_INV_SEL (BIT(6)) +#define GPIO_GPIO_FUNC255_IN_INV_SEL_S 6 +#define GPIO_GPIO_FUNC255_IN_SEL 0x0000003F +#define GPIO_GPIO_FUNC255_IN_SEL_S 0 + +#define GPIO_FUNC0_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0530) +#define GPIO_GPIO_FUNC0_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC0_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC0_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC0_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC0_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC0_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC0_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC0_OUT_SEL_S 0 + +#define GPIO_FUNC1_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0534) +#define GPIO_GPIO_FUNC1_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC1_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC1_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC1_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC1_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC1_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC1_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC1_OUT_SEL_S 0 + +#define GPIO_FUNC2_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0538) +#define GPIO_GPIO_FUNC2_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC2_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC2_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC2_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC2_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC2_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC2_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC2_OUT_SEL_S 0 + +#define GPIO_FUNC3_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x053c) +#define GPIO_GPIO_FUNC3_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC3_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC3_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC3_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC3_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC3_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC3_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC3_OUT_SEL_S 0 + +#define GPIO_FUNC4_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0540) +#define GPIO_GPIO_FUNC4_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC4_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC4_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC4_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC4_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC4_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC4_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC4_OUT_SEL_S 0 + +#define GPIO_FUNC5_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0544) +#define GPIO_GPIO_FUNC5_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC5_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC5_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC5_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC5_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC5_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC5_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC5_OUT_SEL_S 0 + +#define GPIO_FUNC6_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0548) +#define GPIO_GPIO_FUNC6_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC6_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC6_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC6_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC6_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC6_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC6_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC6_OUT_SEL_S 0 + +#define GPIO_FUNC7_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x054c) +#define GPIO_GPIO_FUNC7_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC7_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC7_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC7_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC7_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC7_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC7_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC7_OUT_SEL_S 0 + +#define GPIO_FUNC8_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0550) +#define GPIO_GPIO_FUNC8_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC8_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC8_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC8_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC8_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC8_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC8_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC8_OUT_SEL_S 0 + +#define GPIO_FUNC9_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0554) +#define GPIO_GPIO_FUNC9_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC9_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC9_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC9_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC9_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC9_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC9_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC9_OUT_SEL_S 0 + +#define GPIO_FUNC10_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0558) +#define GPIO_GPIO_FUNC10_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC10_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC10_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC10_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC10_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC10_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC10_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC10_OUT_SEL_S 0 + +#define GPIO_FUNC11_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x055c) +#define GPIO_GPIO_FUNC11_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC11_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC11_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC11_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC11_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC11_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC11_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC11_OUT_SEL_S 0 + +#define GPIO_FUNC12_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0560) +#define GPIO_GPIO_FUNC12_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC12_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC12_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC12_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC12_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC12_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC12_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC12_OUT_SEL_S 0 + +#define GPIO_FUNC13_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0564) +#define GPIO_GPIO_FUNC13_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC13_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC13_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC13_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC13_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC13_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC13_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC13_OUT_SEL_S 0 + +#define GPIO_FUNC14_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0568) +#define GPIO_GPIO_FUNC14_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC14_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC14_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC14_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC14_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC14_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC14_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC14_OUT_SEL_S 0 + +#define GPIO_FUNC15_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x056c) +#define GPIO_GPIO_FUNC15_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC15_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC15_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC15_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC15_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC15_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC15_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC15_OUT_SEL_S 0 + +#define GPIO_FUNC16_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0570) +#define GPIO_GPIO_FUNC16_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC16_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC16_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC16_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC16_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC16_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC16_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC16_OUT_SEL_S 0 + +#define GPIO_FUNC17_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0574) +#define GPIO_GPIO_FUNC17_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC17_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC17_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC17_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC17_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC17_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC17_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC17_OUT_SEL_S 0 + +#define GPIO_FUNC18_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0578) +#define GPIO_GPIO_FUNC18_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC18_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC18_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC18_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC18_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC18_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC18_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC18_OUT_SEL_S 0 + +#define GPIO_FUNC19_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x057c) +#define GPIO_GPIO_FUNC19_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC19_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC19_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC19_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC19_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC19_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC19_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC19_OUT_SEL_S 0 + +#define GPIO_FUNC20_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0580) +#define GPIO_GPIO_FUNC20_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC20_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC20_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC20_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC20_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC20_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC20_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC20_OUT_SEL_S 0 + +#define GPIO_FUNC21_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0584) +#define GPIO_GPIO_FUNC21_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC21_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC21_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC21_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC21_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC21_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC21_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC21_OUT_SEL_S 0 + +#define GPIO_FUNC22_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0588) +#define GPIO_GPIO_FUNC22_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC22_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC22_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC22_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC22_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC22_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC22_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC22_OUT_SEL_S 0 + +#define GPIO_FUNC23_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x058c) +#define GPIO_GPIO_FUNC23_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC23_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC23_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC23_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC23_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC23_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC23_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC23_OUT_SEL_S 0 + +#define GPIO_FUNC24_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0590) +#define GPIO_GPIO_FUNC24_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC24_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC24_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC24_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC24_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC24_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC24_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC24_OUT_SEL_S 0 + +#define GPIO_FUNC25_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0594) +#define GPIO_GPIO_FUNC25_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC25_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC25_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC25_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC25_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC25_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC25_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC25_OUT_SEL_S 0 + +#define GPIO_FUNC26_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x0598) +#define GPIO_GPIO_FUNC26_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC26_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC26_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC26_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC26_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC26_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC26_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC26_OUT_SEL_S 0 + +#define GPIO_FUNC27_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x059c) +#define GPIO_GPIO_FUNC27_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC27_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC27_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC27_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC27_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC27_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC27_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC27_OUT_SEL_S 0 + +#define GPIO_FUNC28_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05a0) +#define GPIO_GPIO_FUNC28_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC28_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC28_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC28_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC28_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC28_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC28_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC28_OUT_SEL_S 0 + +#define GPIO_FUNC29_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05a4) +#define GPIO_GPIO_FUNC29_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC29_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC29_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC29_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC29_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC29_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC29_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC29_OUT_SEL_S 0 + +#define GPIO_FUNC30_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05a8) +#define GPIO_GPIO_FUNC30_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC30_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC30_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC30_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC30_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC30_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC30_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC30_OUT_SEL_S 0 + +#define GPIO_FUNC31_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05ac) +#define GPIO_GPIO_FUNC31_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC31_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC31_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC31_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC31_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC31_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC31_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC31_OUT_SEL_S 0 + +#define GPIO_FUNC32_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05b0) +#define GPIO_GPIO_FUNC32_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC32_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC32_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC32_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC32_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC32_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC32_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC32_OUT_SEL_S 0 + +#define GPIO_FUNC33_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05b4) +#define GPIO_GPIO_FUNC33_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC33_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC33_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC33_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC33_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC33_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC33_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC33_OUT_SEL_S 0 + +#define GPIO_FUNC34_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05b8) +#define GPIO_GPIO_FUNC34_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC34_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC34_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC34_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC34_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC34_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC34_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC34_OUT_SEL_S 0 + +#define GPIO_FUNC35_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05bc) +#define GPIO_GPIO_FUNC35_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC35_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC35_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC35_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC35_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC35_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC35_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC35_OUT_SEL_S 0 + +#define GPIO_FUNC36_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05c0) +#define GPIO_GPIO_FUNC36_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC36_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC36_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC36_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC36_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC36_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC36_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC36_OUT_SEL_S 0 + +#define GPIO_FUNC37_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05c4) +#define GPIO_GPIO_FUNC37_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC37_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC37_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC37_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC37_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC37_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC37_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC37_OUT_SEL_S 0 + +#define GPIO_FUNC38_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05c8) +#define GPIO_GPIO_FUNC38_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC38_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC38_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC38_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC38_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC38_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC38_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC38_OUT_SEL_S 0 + +#define GPIO_FUNC39_OUT_SEL_CFG (DR_REG_GPIO_BASE + 0x05cc) +#define GPIO_GPIO_FUNC39_OEN_INV_SEL (BIT(11)) +#define GPIO_GPIO_FUNC39_OEN_INV_SEL_S 11 +#define GPIO_GPIO_FUNC39_OEN_SEL (BIT(10)) +#define GPIO_GPIO_FUNC39_OEN_SEL_S 10 +#define GPIO_GPIO_FUNC39_OUT_INV_SEL (BIT(9)) +#define GPIO_GPIO_FUNC39_OUT_INV_SEL_S 9 +#define GPIO_GPIO_FUNC39_OUT_SEL 0x000001FF +#define GPIO_GPIO_FUNC39_OUT_SEL_S 0 + +#endif /* _SOC_GPIO_REG_H_ */ diff --git a/components/esp32/include/soc/gpio_sd_reg.h b/components/esp32/include/soc/gpio_sd_reg.h new file mode 100644 index 000000000..3d9dbb285 --- /dev/null +++ b/components/esp32/include/soc/gpio_sd_reg.h @@ -0,0 +1,80 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_GPIO_SD_REG_H_ +#define _SOC_GPIO_SD_REG_H_ + +#include "soc.h" + +#define SIGMADELTA0 (DR_REG_GPIO_SD_BASE + 0x0000) +#define SIGMADELTA_SD0_PRESCALE 0x000000FF +#define SIGMADELTA_SD0_PRESCALE_S 8 +#define SIGMADELTA_SD0_IN 0x000000FF +#define SIGMADELTA_SD0_IN_S 0 + +#define SIGMADELTA1 (DR_REG_GPIO_SD_BASE + 0x0004) +#define SIGMADELTA_SD1_PRESCALE 0x000000FF +#define SIGMADELTA_SD1_PRESCALE_S 8 +#define SIGMADELTA_SD1_IN 0x000000FF +#define SIGMADELTA_SD1_IN_S 0 + +#define SIGMADELTA2 (DR_REG_GPIO_SD_BASE + 0x0008) +#define SIGMADELTA_SD2_PRESCALE 0x000000FF +#define SIGMADELTA_SD2_PRESCALE_S 8 +#define SIGMADELTA_SD2_IN 0x000000FF +#define SIGMADELTA_SD2_IN_S 0 + +#define SIGMADELTA3 (DR_REG_GPIO_SD_BASE + 0x000c) +#define SIGMADELTA_SD3_PRESCALE 0x000000FF +#define SIGMADELTA_SD3_PRESCALE_S 8 +#define SIGMADELTA_SD3_IN 0x000000FF +#define SIGMADELTA_SD3_IN_S 0 + +#define SIGMADELTA4 (DR_REG_GPIO_SD_BASE + 0x0010) +#define SIGMADELTA_SD4_PRESCALE 0x000000FF +#define SIGMADELTA_SD4_PRESCALE_S 8 +#define SIGMADELTA_SD4_IN 0x000000FF +#define SIGMADELTA_SD4_IN_S 0 + +#define SIGMADELTA5 (DR_REG_GPIO_SD_BASE + 0x0014) +#define SIGMADELTA_SD5_PRESCALE 0x000000FF +#define SIGMADELTA_SD5_PRESCALE_S 8 +#define SIGMADELTA_SD5_IN 0x000000FF +#define SIGMADELTA_SD5_IN_S 0 + +#define SIGMADELTA6 (DR_REG_GPIO_SD_BASE + 0x0018) +#define SIGMADELTA_SD6_PRESCALE 0x000000FF +#define SIGMADELTA_SD6_PRESCALE_S 8 +#define SIGMADELTA_SD6_IN 0x000000FF +#define SIGMADELTA_SD6_IN_S 0 + +#define SIGMADELTA7 (DR_REG_GPIO_SD_BASE + 0x001c) +#define SIGMADELTA_SD7_PRESCALE 0x000000FF +#define SIGMADELTA_SD7_PRESCALE_S 8 +#define SIGMADELTA_SD7_IN 0x000000FF +#define SIGMADELTA_SD7_IN_S 0 + +#define SIGMADELTA_CG (DR_REG_GPIO_SD_BASE + 0x0020) +#define SIGMADELTA_GPIO_SD_CLK_EN (BIT(31)) +#define SIGMADELTA_GPIO_SD_CLK_EN_S 31 + +#define SIGMADELTA_MISC (DR_REG_GPIO_SD_BASE + 0x0024) +#define SIGMADELTA_SPI_SWAP (BIT(31)) +#define SIGMADELTA_SPI_SWAP_S 31 + +#define SIGMADELTA_VERSION (DR_REG_GPIO_SD_BASE + 0x0028) +#define SIGMADELTA_GPIO_SD_DATE 0x0FFFFFFF +#define SIGMADELTA_GPIO_SD_DATE_S 0 +#define SIGMADELTA_GPIO_SD_DATE_VERSION 0x1506190 + +#endif /* _SOC_GPIO_SD_REG_H_ */ diff --git a/components/esp32/include/soc/gpio_sig_map.h b/components/esp32/include/soc/gpio_sig_map.h new file mode 100644 index 000000000..dad22f92f --- /dev/null +++ b/components/esp32/include/soc/gpio_sig_map.h @@ -0,0 +1,422 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_GPIO_SIG_MAP_H_ +#define _SOC_GPIO_SIG_MAP_H_ + +#define SPICLK_IN_IDX 0 +#define SPICLK_OUT_IDX 0 +#define SPIQ_IN_IDX 1 +#define SPIQ_OUT_IDX 1 +#define SPID_IN_IDX 2 +#define SPID_OUT_IDX 2 +#define SPIHD_IN_IDX 3 +#define SPIHD_OUT_IDX 3 +#define SPIWP_IN_IDX 4 +#define SPIWP_OUT_IDX 4 +#define SPICS0_IN_IDX 5 +#define SPICS0_OUT_IDX 5 +#define SPICS1_IN_IDX 6 +#define SPICS1_OUT_IDX 6 +#define SPICS2_IN_IDX 7 +#define SPICS2_OUT_IDX 7 +#define HSPICLK_IN_IDX 8 +#define HSPICLK_OUT_IDX 8 +#define HSPIQ_IN_IDX 9 +#define HSPIQ_OUT_IDX 9 +#define HSPID_IN_IDX 10 +#define HSPID_OUT_IDX 10 +#define HSPICS0_IN_IDX 11 +#define HSPICS0_OUT_IDX 11 +#define HSPIHD_IN_IDX 12 +#define HSPIHD_OUT_IDX 12 +#define HSPIWP_IN_IDX 13 +#define HSPIWP_OUT_IDX 13 +#define U0RXD_IN_IDX 14 +#define U0TXD_OUT_IDX 14 +#define U0CTS_IN_IDX 15 +#define U0RTS_OUT_IDX 15 +#define U0DSR_IN_IDX 16 +#define U0DTR_OUT_IDX 16 +#define U1RXD_IN_IDX 17 +#define U1TXD_OUT_IDX 17 +#define U1CTS_IN_IDX 18 +#define U1RTS_OUT_IDX 18 +#define I2CM_SCL_O_IDX 19 +#define I2CM_SDA_I_IDX 20 +#define I2CM_SDA_O_IDX 20 +#define EXT_I2C_SCL_O_IDX 21 +#define EXT_I2C_SDA_O_IDX 22 +#define EXT_I2C_SDA_I_IDX 22 +#define I2S0O_BCK_IN_IDX 23 +#define I2S0O_BCK_OUT_IDX 23 +#define I2S1O_BCK_IN_IDX 24 +#define I2S1O_BCK_OUT_IDX 24 +#define I2S0O_WS_IN_IDX 25 +#define I2S0O_WS_OUT_IDX 25 +#define I2S1O_WS_IN_IDX 26 +#define I2S1O_WS_OUT_IDX 26 +#define I2S0I_BCK_IN_IDX 27 +#define I2S0I_BCK_OUT_IDX 27 +#define I2S0I_WS_IN_IDX 28 +#define I2S0I_WS_OUT_IDX 28 +#define I2CEXT0_SCL_IN_IDX 29 +#define I2CEXT0_SCL_OUT_IDX 29 +#define I2CEXT0_SDA_IN_IDX 30 +#define I2CEXT0_SDA_OUT_IDX 30 +#define PWM0_SYNC0_IN_IDX 31 +#define SDIO_TOHOST_INT_OUT_IDX 31 +#define PWM0_SYNC1_IN_IDX 32 +#define PWM0_OUT0A_IDX 32 +#define PWM0_SYNC2_IN_IDX 33 +#define PWM0_OUT0B_IDX 33 +#define PWM0_F0_IN_IDX 34 +#define PWM0_OUT1A_IDX 34 +#define PWM0_F1_IN_IDX 35 +#define PWM0_OUT1B_IDX 35 +#define PWM0_F2_IN_IDX 36 +#define PWM0_OUT2A_IDX 36 +#define GPIO_BT_ACTIVE_IDX 37 +#define PWM0_OUT2B_IDX 37 +#define GPIO_BT_PRIORITY_IDX 38 +#define PCNT_SIG_CH0_IN0_IDX 39 +#define PCNT_SIG_CH1_IN0_IDX 40 +#define GPIO_WLAN_ACTIVE_IDX 40 +#define PCNT_CTRL_CH0_IN0_IDX 41 +#define BB_DIAG0_IDX 41 +#define PCNT_CTRL_CH1_IN0_IDX 42 +#define BB_DIAG1_IDX 42 +#define PCNT_SIG_CH0_IN1_IDX 43 +#define BB_DIAG2_IDX 43 +#define PCNT_SIG_CH1_IN1_IDX 44 +#define BB_DIAG3_IDX 44 +#define PCNT_CTRL_CH0_IN1_IDX 45 +#define BB_DIAG4_IDX 45 +#define PCNT_CTRL_CH1_IN1_IDX 46 +#define BB_DIAG5_IDX 46 +#define PCNT_SIG_CH0_IN2_IDX 47 +#define BB_DIAG6_IDX 47 +#define PCNT_SIG_CH1_IN2_IDX 48 +#define BB_DIAG7_IDX 48 +#define PCNT_CTRL_CH0_IN2_IDX 49 +#define BB_DIAG8_IDX 49 +#define PCNT_CTRL_CH1_IN2_IDX 50 +#define BB_DIAG9_IDX 50 +#define PCNT_SIG_CH0_IN3_IDX 51 +#define BB_DIAG10_IDX 51 +#define PCNT_SIG_CH1_IN3_IDX 52 +#define BB_DIAG11_IDX 52 +#define PCNT_CTRL_CH0_IN3_IDX 53 +#define BB_DIAG12_IDX 53 +#define PCNT_CTRL_CH1_IN3_IDX 54 +#define BB_DIAG13_IDX 54 +#define PCNT_SIG_CH0_IN4_IDX 55 +#define BB_DIAG14_IDX 55 +#define PCNT_SIG_CH1_IN4_IDX 56 +#define BB_DIAG15_IDX 56 +#define PCNT_CTRL_CH0_IN4_IDX 57 +#define BB_DIAG16_IDX 57 +#define PCNT_CTRL_CH1_IN4_IDX 58 +#define BB_DIAG17_IDX 58 +#define BB_DIAG18_IDX 59 +#define BB_DIAG19_IDX 60 +#define HSPICS1_IN_IDX 61 +#define HSPICS1_OUT_IDX 61 +#define HSPICS2_IN_IDX 62 +#define HSPICS2_OUT_IDX 62 +#define VSPICLK_IN_IDX 63 +#define VSPICLK_OUT_MUX_IDX 63 +#define VSPIQ_IN_IDX 64 +#define VSPIQ_OUT_IDX 64 +#define VSPID_IN_IDX 65 +#define VSPID_OUT_IDX 65 +#define VSPIHD_IN_IDX 66 +#define VSPIHD_OUT_IDX 66 +#define VSPIWP_IN_IDX 67 +#define VSPIWP_OUT_IDX 67 +#define VSPICS0_IN_IDX 68 +#define VSPICS0_OUT_IDX 68 +#define VSPICS1_IN_IDX 69 +#define VSPICS1_OUT_IDX 69 +#define VSPICS2_IN_IDX 70 +#define VSPICS2_OUT_IDX 70 +#define PCNT_SIG_CH0_IN5_IDX 71 +#define LEDC_HS_SIG_OUT0_IDX 71 +#define PCNT_SIG_CH1_IN5_IDX 72 +#define LEDC_HS_SIG_OUT1_IDX 72 +#define PCNT_CTRL_CH0_IN5_IDX 73 +#define LEDC_HS_SIG_OUT2_IDX 73 +#define PCNT_CTRL_CH1_IN5_IDX 74 +#define LEDC_HS_SIG_OUT3_IDX 74 +#define PCNT_SIG_CH0_IN6_IDX 75 +#define LEDC_HS_SIG_OUT4_IDX 75 +#define PCNT_SIG_CH1_IN6_IDX 76 +#define LEDC_HS_SIG_OUT5_IDX 76 +#define PCNT_CTRL_CH0_IN6_IDX 77 +#define LEDC_HS_SIG_OUT6_IDX 77 +#define PCNT_CTRL_CH1_IN6_IDX 78 +#define LEDC_HS_SIG_OUT7_IDX 78 +#define PCNT_SIG_CH0_IN7_IDX 79 +#define LEDC_LS_SIG_OUT0_IDX 79 +#define PCNT_SIG_CH1_IN7_IDX 80 +#define LEDC_LS_SIG_OUT1_IDX 80 +#define PCNT_CTRL_CH0_IN7_IDX 81 +#define LEDC_LS_SIG_OUT2_IDX 81 +#define PCNT_CTRL_CH1_IN7_IDX 82 +#define LEDC_LS_SIG_OUT3_IDX 82 +#define RMT_SIG_IN0_IDX 83 +#define LEDC_LS_SIG_OUT4_IDX 83 +#define RMT_SIG_IN1_IDX 84 +#define LEDC_LS_SIG_OUT5_IDX 84 +#define RMT_SIG_IN2_IDX 85 +#define LEDC_LS_SIG_OUT6_IDX 85 +#define RMT_SIG_IN3_IDX 86 +#define LEDC_LS_SIG_OUT7_IDX 86 +#define RMT_SIG_IN4_IDX 87 +#define RMT_SIG_OUT0_IDX 87 +#define RMT_SIG_IN5_IDX 88 +#define RMT_SIG_OUT1_IDX 88 +#define RMT_SIG_IN6_IDX 89 +#define RMT_SIG_OUT2_IDX 89 +#define RMT_SIG_IN7_IDX 90 +#define RMT_SIG_OUT3_IDX 90 +#define RMT_SIG_OUT4_IDX 91 +#define RMT_SIG_OUT5_IDX 92 +#define EXT_ADC_START_IDX 93 +#define RMT_SIG_OUT6_IDX 93 +#define CAN_RX_IDX 94 +#define RMT_SIG_OUT7_IDX 94 +#define I2CEXT1_SCL_IN_IDX 95 +#define I2CEXT1_SCL_OUT_IDX 95 +#define I2CEXT1_SDA_IN_IDX 96 +#define I2CEXT1_SDA_OUT_IDX 96 +#define HOST_CARD_DETECT_N_1_IDX 97 +#define HOST_CCMD_OD_PULLUP_EN_N_IDX 97 +#define HOST_CARD_DETECT_N_2_IDX 98 +#define HOST_RST_N_1_IDX 98 +#define HOST_CARD_WRITE_PRT_1_IDX 99 +#define HOST_RST_N_2_IDX 99 +#define HOST_CARD_WRITE_PRT_2_IDX 100 +#define GPIO_SD0_OUT_IDX 100 +#define HOST_CARD_INT_N_1_IDX 101 +#define GPIO_SD1_OUT_IDX 101 +#define HOST_CARD_INT_N_2_IDX 102 +#define GPIO_SD2_OUT_IDX 102 +#define PWM1_SYNC0_IN_IDX 103 +#define GPIO_SD3_OUT_IDX 103 +#define PWM1_SYNC1_IN_IDX 104 +#define GPIO_SD4_OUT_IDX 104 +#define PWM1_SYNC2_IN_IDX 105 +#define GPIO_SD5_OUT_IDX 105 +#define PWM1_F0_IN_IDX 106 +#define GPIO_SD6_OUT_IDX 106 +#define PWM1_F1_IN_IDX 107 +#define GPIO_SD7_OUT_IDX 107 +#define PWM1_F2_IN_IDX 108 +#define PWM1_OUT0A_IDX 108 +#define PWM0_CAP0_IN_IDX 109 +#define PWM1_OUT0B_IDX 109 +#define PWM0_CAP1_IN_IDX 110 +#define PWM1_OUT1A_IDX 110 +#define PWM0_CAP2_IN_IDX 111 +#define PWM1_OUT1B_IDX 111 +#define PWM1_CAP0_IN_IDX 112 +#define PWM1_OUT2A_IDX 112 +#define PWM1_CAP1_IN_IDX 113 +#define PWM1_OUT2B_IDX 113 +#define PWM1_CAP2_IN_IDX 114 +#define PWM2_OUT1H_IDX 114 +#define PWM2_FLTA_IDX 115 +#define PWM2_OUT1L_IDX 115 +#define PWM2_FLTB_IDX 116 +#define PWM2_OUT2H_IDX 116 +#define PWM2_CAP1_IN_IDX 117 +#define PWM2_OUT2L_IDX 117 +#define PWM2_CAP2_IN_IDX 118 +#define PWM2_OUT3H_IDX 118 +#define PWM2_CAP3_IN_IDX 119 +#define PWM2_OUT3L_IDX 119 +#define PWM3_FLTA_IDX 120 +#define PWM2_OUT4H_IDX 120 +#define PWM3_FLTB_IDX 121 +#define PWM2_OUT4L_IDX 121 +#define PWM3_CAP1_IN_IDX 122 +#define PWM3_CAP2_IN_IDX 123 +#define CAN_TX_IDX 123 +#define PWM3_CAP3_IN_IDX 124 +#define CAN_BUS_OFF_ON_IDX 124 +#define CAN_CLKOUT_IDX 125 +#define SPID4_IN_IDX 128 +#define SPID4_OUT_IDX 128 +#define SPID5_IN_IDX 129 +#define SPID5_OUT_IDX 129 +#define SPID6_IN_IDX 130 +#define SPID6_OUT_IDX 130 +#define SPID7_IN_IDX 131 +#define SPID7_OUT_IDX 131 +#define HSPID4_IN_IDX 132 +#define HSPID4_OUT_IDX 132 +#define HSPID5_IN_IDX 133 +#define HSPID5_OUT_IDX 133 +#define HSPID6_IN_IDX 134 +#define HSPID6_OUT_IDX 134 +#define HSPID7_IN_IDX 135 +#define HSPID7_OUT_IDX 135 +#define VSPID4_IN_IDX 136 +#define VSPID4_OUT_IDX 136 +#define VSPID5_IN_IDX 137 +#define VSPID5_OUT_IDX 137 +#define VSPID6_IN_IDX 138 +#define VSPID6_OUT_IDX 138 +#define VSPID7_IN_IDX 139 +#define VSPID7_OUT_IDX 139 +#define I2S0I_DATA_IN0_IDX 140 +#define I2S0O_DATA_OUT0_IDX 140 +#define I2S0I_DATA_IN1_IDX 141 +#define I2S0O_DATA_OUT1_IDX 141 +#define I2S0I_DATA_IN2_IDX 142 +#define I2S0O_DATA_OUT2_IDX 142 +#define I2S0I_DATA_IN3_IDX 143 +#define I2S0O_DATA_OUT3_IDX 143 +#define I2S0I_DATA_IN4_IDX 144 +#define I2S0O_DATA_OUT4_IDX 144 +#define I2S0I_DATA_IN5_IDX 145 +#define I2S0O_DATA_OUT5_IDX 145 +#define I2S0I_DATA_IN6_IDX 146 +#define I2S0O_DATA_OUT6_IDX 146 +#define I2S0I_DATA_IN7_IDX 147 +#define I2S0O_DATA_OUT7_IDX 147 +#define I2S0I_DATA_IN8_IDX 148 +#define I2S0O_DATA_OUT8_IDX 148 +#define I2S0I_DATA_IN9_IDX 149 +#define I2S0O_DATA_OUT9_IDX 149 +#define I2S0I_DATA_IN10_IDX 150 +#define I2S0O_DATA_OUT10_IDX 150 +#define I2S0I_DATA_IN11_IDX 151 +#define I2S0O_DATA_OUT11_IDX 151 +#define I2S0I_DATA_IN12_IDX 152 +#define I2S0O_DATA_OUT12_IDX 152 +#define I2S0I_DATA_IN13_IDX 153 +#define I2S0O_DATA_OUT13_IDX 153 +#define I2S0I_DATA_IN14_IDX 154 +#define I2S0O_DATA_OUT14_IDX 154 +#define I2S0I_DATA_IN15_IDX 155 +#define I2S0O_DATA_OUT15_IDX 155 +#define I2S0O_DATA_OUT16_IDX 156 +#define I2S0O_DATA_OUT17_IDX 157 +#define I2S0O_DATA_OUT18_IDX 158 +#define I2S0O_DATA_OUT19_IDX 159 +#define I2S0O_DATA_OUT20_IDX 160 +#define I2S0O_DATA_OUT21_IDX 161 +#define I2S0O_DATA_OUT22_IDX 162 +#define I2S0O_DATA_OUT23_IDX 163 +#define I2S1I_BCK_IN_IDX 164 +#define I2S1I_BCK_OUT_IDX 164 +#define I2S1I_WS_IN_IDX 165 +#define I2S1I_WS_OUT_IDX 165 +#define I2S1I_DATA_IN0_IDX 166 +#define I2S1O_DATA_OUT0_IDX 166 +#define I2S1I_DATA_IN1_IDX 167 +#define I2S1O_DATA_OUT1_IDX 167 +#define I2S1I_DATA_IN2_IDX 168 +#define I2S1O_DATA_OUT2_IDX 168 +#define I2S1I_DATA_IN3_IDX 169 +#define I2S1O_DATA_OUT3_IDX 169 +#define I2S1I_DATA_IN4_IDX 170 +#define I2S1O_DATA_OUT4_IDX 170 +#define I2S1I_DATA_IN5_IDX 171 +#define I2S1O_DATA_OUT5_IDX 171 +#define I2S1I_DATA_IN6_IDX 172 +#define I2S1O_DATA_OUT6_IDX 172 +#define I2S1I_DATA_IN7_IDX 173 +#define I2S1O_DATA_OUT7_IDX 173 +#define I2S1I_DATA_IN8_IDX 174 +#define I2S1O_DATA_OUT8_IDX 174 +#define I2S1I_DATA_IN9_IDX 175 +#define I2S1O_DATA_OUT9_IDX 175 +#define I2S1I_DATA_IN10_IDX 176 +#define I2S1O_DATA_OUT10_IDX 176 +#define I2S1I_DATA_IN11_IDX 177 +#define I2S1O_DATA_OUT11_IDX 177 +#define I2S1I_DATA_IN12_IDX 178 +#define I2S1O_DATA_OUT12_IDX 178 +#define I2S1I_DATA_IN13_IDX 179 +#define I2S1O_DATA_OUT13_IDX 179 +#define I2S1I_DATA_IN14_IDX 180 +#define I2S1O_DATA_OUT14_IDX 180 +#define I2S1I_DATA_IN15_IDX 181 +#define I2S1O_DATA_OUT15_IDX 181 +#define I2S1O_DATA_OUT16_IDX 182 +#define I2S1O_DATA_OUT17_IDX 183 +#define I2S1O_DATA_OUT18_IDX 184 +#define I2S1O_DATA_OUT19_IDX 185 +#define I2S1O_DATA_OUT20_IDX 186 +#define I2S1O_DATA_OUT21_IDX 187 +#define I2S1O_DATA_OUT22_IDX 188 +#define I2S1O_DATA_OUT23_IDX 189 +#define I2S0I_H_SYNC_IDX 190 +#define PWM3_OUT1H_IDX 190 +#define I2S0I_V_SYNC_IDX 191 +#define PWM3_OUT1L_IDX 191 +#define I2S0I_H_ENABLE_IDX 192 +#define PWM3_OUT2H_IDX 192 +#define I2S1I_H_SYNC_IDX 193 +#define PWM3_OUT2L_IDX 193 +#define I2S1I_V_SYNC_IDX 194 +#define PWM3_OUT3H_IDX 194 +#define I2S1I_H_ENABLE_IDX 195 +#define PWM3_OUT3L_IDX 195 +#define PWM3_OUT4H_IDX 196 +#define PWM3_OUT4L_IDX 197 +#define U2RXD_IN_IDX 198 +#define U2TXD_OUT_IDX 198 +#define U2CTS_IN_IDX 199 +#define U2RTS_OUT_IDX 199 +#define EMAC_MDC_I_IDX 200 +#define EMAC_MDC_O_IDX 200 +#define EMAC_MDI_I_IDX 201 +#define EMAC_MDO_O_IDX 201 +#define EMAC_CRS_I_IDX 202 +#define EMAC_CRS_O_IDX 202 +#define EMAC_COL_I_IDX 203 +#define EMAC_COL_O_IDX 203 +#define PCMFSYNC_IN_IDX 204 +#define BT_AUDIO0_IRQ_IDX 204 +#define PCMCLK_IN_IDX 205 +#define BT_AUDIO1_IRQ_IDX 205 +#define PCMDIN_IDX 206 +#define BT_AUDIO2_IRQ_IDX 206 +#define BLE_AUDIO0_IRQ_IDX 207 +#define BLE_AUDIO1_IRQ_IDX 208 +#define BLE_AUDIO2_IRQ_IDX 209 +#define PCMFSYNC_OUT_IDX 210 +#define PCMCLK_OUT_IDX 211 +#define PCMDOUT_IDX 212 +#define BLE_AUDIO_SYNC0_P_IDX 213 +#define BLE_AUDIO_SYNC1_P_IDX 214 +#define BLE_AUDIO_SYNC2_P_IDX 215 +#define ANT_SEL0_IDX 216 +#define ANT_SEL1_IDX 217 +#define ANT_SEL2_IDX 218 +#define ANT_SEL3_IDX 219 +#define ANT_SEL4_IDX 220 +#define ANT_SEL5_IDX 221 +#define ANT_SEL6_IDX 222 +#define ANT_SEL7_IDX 223 +#define SIG_IN_FUNC224_IDX 224 +#define SIG_IN_FUNC225_IDX 225 +#define SIG_IN_FUNC226_IDX 226 +#define SIG_IN_FUNC227_IDX 227 +#define SIG_IN_FUNC228_IDX 228 + +#endif /* _SOC_GPIO_SIG_MAP_H_ */ diff --git a/components/esp32/include/soc/i2s_reg.h b/components/esp32/include/soc/i2s_reg.h new file mode 100644 index 000000000..4c31a9fae --- /dev/null +++ b/components/esp32/include/soc/i2s_reg.h @@ -0,0 +1,579 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_I2S_REG_H_ +#define _SOC_I2S_REG_H_ + +#include "soc.h" + +#define I2SCONF (DR_REG_I2S_BASE + 0x0008) +#define I2S_I2S_SIG_LOOPBACK (BIT(18)) +#define I2S_I2S_SIG_LOOPBACK_S 18 +#define I2S_RX_MSB_RIGHT (BIT(17)) +#define I2S_RX_MSB_RIGHT_S 17 +#define I2S_TX_MSB_RIGHT (BIT(16)) +#define I2S_TX_MSB_RIGHT_S 16 +#define I2S_I2S_RX_MONO (BIT(15)) +#define I2S_I2S_RX_MONO_S 15 +#define I2S_I2S_TX_MONO (BIT(14)) +#define I2S_I2S_TX_MONO_S 14 +#define I2S_I2S_RX_SHORT_SYNC (BIT(13)) +#define I2S_I2S_RX_SHORT_SYNC_S 13 +#define I2S_I2S_TX_SHORT_SYNC (BIT(12)) +#define I2S_I2S_TX_SHORT_SYNC_S 12 +#define I2S_RX_MSB_SHIFT (BIT(11)) +#define I2S_RX_MSB_SHIFT_S 11 +#define I2S_TX_MSB_SHIFT (BIT(10)) +#define I2S_TX_MSB_SHIFT_S 10 +#define I2S_RX_RIGHT_FIRST (BIT(9)) +#define I2S_RX_RIGHT_FIRST_S 9 +#define I2S_TX_RIGHT_FIRST (BIT(8)) +#define I2S_TX_RIGHT_FIRST_S 8 +#define I2S_RX_SLAVE_MOD (BIT(7)) +#define I2S_RX_SLAVE_MOD_S 7 +#define I2S_TX_SLAVE_MOD (BIT(6)) +#define I2S_TX_SLAVE_MOD_S 6 +#define I2S_I2S_RX_START (BIT(5)) +#define I2S_I2S_RX_START_S 5 +#define I2S_I2S_TX_START (BIT(4)) +#define I2S_I2S_TX_START_S 4 +#define I2S_I2S_RX_FIFO_RESET (BIT(3)) +#define I2S_I2S_RX_FIFO_RESET_S 3 +#define I2S_I2S_TX_FIFO_RESET (BIT(2)) +#define I2S_I2S_TX_FIFO_RESET_S 2 +#define I2S_I2S_RX_RESET (BIT(1)) +#define I2S_I2S_RX_RESET_S 1 +#define I2S_I2S_TX_RESET (BIT(0)) +#define I2S_I2S_TX_RESET_S 0 + +#define I2SINT_RAW (DR_REG_I2S_BASE + 0x000c) +#define I2S_I2S_OUT_TOTAL_EOF_INT_RAW (BIT(16)) +#define I2S_I2S_OUT_TOTAL_EOF_INT_RAW_S 16 +#define I2S_I2S_IN_DSCR_EMPTY_INT_RAW (BIT(15)) +#define I2S_I2S_IN_DSCR_EMPTY_INT_RAW_S 15 +#define I2S_I2S_OUT_DSCR_ERR_INT_RAW (BIT(14)) +#define I2S_I2S_OUT_DSCR_ERR_INT_RAW_S 14 +#define I2S_I2S_IN_DSCR_ERR_INT_RAW (BIT(13)) +#define I2S_I2S_IN_DSCR_ERR_INT_RAW_S 13 +#define I2S_I2S_OUT_EOF_INT_RAW (BIT(12)) +#define I2S_I2S_OUT_EOF_INT_RAW_S 12 +#define I2S_I2S_OUT_DONE_INT_RAW (BIT(11)) +#define I2S_I2S_OUT_DONE_INT_RAW_S 11 +#define I2S_I2S_IN_ERR_EOF_INT_RAW (BIT(10)) +#define I2S_I2S_IN_ERR_EOF_INT_RAW_S 10 +#define I2S_I2S_IN_SUC_EOF_INT_RAW (BIT(9)) +#define I2S_I2S_IN_SUC_EOF_INT_RAW_S 9 +#define I2S_I2S_IN_DONE_INT_RAW (BIT(8)) +#define I2S_I2S_IN_DONE_INT_RAW_S 8 +#define I2S_I2S_TX_HUNG_INT_RAW (BIT(7)) +#define I2S_I2S_TX_HUNG_INT_RAW_S 7 +#define I2S_I2S_RX_HUNG_INT_RAW (BIT(6)) +#define I2S_I2S_RX_HUNG_INT_RAW_S 6 +#define I2S_I2S_TX_REMPTY_INT_RAW (BIT(5)) +#define I2S_I2S_TX_REMPTY_INT_RAW_S 5 +#define I2S_I2S_TX_WFULL_INT_RAW (BIT(4)) +#define I2S_I2S_TX_WFULL_INT_RAW_S 4 +#define I2S_I2S_RX_REMPTY_INT_RAW (BIT(3)) +#define I2S_I2S_RX_REMPTY_INT_RAW_S 3 +#define I2S_I2S_RX_WFULL_INT_RAW (BIT(2)) +#define I2S_I2S_RX_WFULL_INT_RAW_S 2 +#define I2S_I2S_TX_PUT_DATA_INT_RAW (BIT(1)) +#define I2S_I2S_TX_PUT_DATA_INT_RAW_S 1 +#define I2S_I2S_RX_TAKE_DATA_INT_RAW (BIT(0)) +#define I2S_I2S_RX_TAKE_DATA_INT_RAW_S 0 + +#define I2SINT_ST (DR_REG_I2S_BASE + 0x0010) +#define I2S_I2S_OUT_TOTAL_EOF_INT_ST (BIT(16)) +#define I2S_I2S_OUT_TOTAL_EOF_INT_ST_S 16 +#define I2S_I2S_IN_DSCR_EMPTY_INT_ST (BIT(15)) +#define I2S_I2S_IN_DSCR_EMPTY_INT_ST_S 15 +#define I2S_I2S_OUT_DSCR_ERR_INT_ST (BIT(14)) +#define I2S_I2S_OUT_DSCR_ERR_INT_ST_S 14 +#define I2S_I2S_IN_DSCR_ERR_INT_ST (BIT(13)) +#define I2S_I2S_IN_DSCR_ERR_INT_ST_S 13 +#define I2S_I2S_OUT_EOF_INT_ST (BIT(12)) +#define I2S_I2S_OUT_EOF_INT_ST_S 12 +#define I2S_I2S_OUT_DONE_INT_ST (BIT(11)) +#define I2S_I2S_OUT_DONE_INT_ST_S 11 +#define I2S_I2S_IN_ERR_EOF_INT_ST (BIT(10)) +#define I2S_I2S_IN_ERR_EOF_INT_ST_S 10 +#define I2S_I2S_IN_SUC_EOF_INT_ST (BIT(9)) +#define I2S_I2S_IN_SUC_EOF_INT_ST_S 9 +#define I2S_I2S_IN_DONE_INT_ST (BIT(8)) +#define I2S_I2S_IN_DONE_INT_ST_S 8 +#define I2S_I2S_TX_HUNG_INT_ST (BIT(7)) +#define I2S_I2S_TX_HUNG_INT_ST_S 7 +#define I2S_I2S_RX_HUNG_INT_ST (BIT(6)) +#define I2S_I2S_RX_HUNG_INT_ST_S 6 +#define I2S_I2S_TX_REMPTY_INT_ST (BIT(5)) +#define I2S_I2S_TX_REMPTY_INT_ST_S 5 +#define I2S_I2S_TX_WFULL_INT_ST (BIT(4)) +#define I2S_I2S_TX_WFULL_INT_ST_S 4 +#define I2S_I2S_RX_REMPTY_INT_ST (BIT(3)) +#define I2S_I2S_RX_REMPTY_INT_ST_S 3 +#define I2S_I2S_RX_WFULL_INT_ST (BIT(2)) +#define I2S_I2S_RX_WFULL_INT_ST_S 2 +#define I2S_I2S_TX_PUT_DATA_INT_ST (BIT(1)) +#define I2S_I2S_TX_PUT_DATA_INT_ST_S 1 +#define I2S_I2S_RX_TAKE_DATA_INT_ST (BIT(0)) +#define I2S_I2S_RX_TAKE_DATA_INT_ST_S 0 + +#define I2SINT_ENA (DR_REG_I2S_BASE + 0x0014) +#define I2S_I2S_OUT_TOTAL_EOF_INT_ENA (BIT(16)) +#define I2S_I2S_OUT_TOTAL_EOF_INT_ENA_S 16 +#define I2S_I2S_IN_DSCR_EMPTY_INT_ENA (BIT(15)) +#define I2S_I2S_IN_DSCR_EMPTY_INT_ENA_S 15 +#define I2S_I2S_OUT_DSCR_ERR_INT_ENA (BIT(14)) +#define I2S_I2S_OUT_DSCR_ERR_INT_ENA_S 14 +#define I2S_I2S_IN_DSCR_ERR_INT_ENA (BIT(13)) +#define I2S_I2S_IN_DSCR_ERR_INT_ENA_S 13 +#define I2S_I2S_OUT_EOF_INT_ENA (BIT(12)) +#define I2S_I2S_OUT_EOF_INT_ENA_S 12 +#define I2S_I2S_OUT_DONE_INT_ENA (BIT(11)) +#define I2S_I2S_OUT_DONE_INT_ENA_S 11 +#define I2S_I2S_IN_ERR_EOF_INT_ENA (BIT(10)) +#define I2S_I2S_IN_ERR_EOF_INT_ENA_S 10 +#define I2S_I2S_IN_SUC_EOF_INT_ENA (BIT(9)) +#define I2S_I2S_IN_SUC_EOF_INT_ENA_S 9 +#define I2S_I2S_IN_DONE_INT_ENA (BIT(8)) +#define I2S_I2S_IN_DONE_INT_ENA_S 8 +#define I2S_I2S_TX_HUNG_INT_ENA (BIT(7)) +#define I2S_I2S_TX_HUNG_INT_ENA_S 7 +#define I2S_I2S_RX_HUNG_INT_ENA (BIT(6)) +#define I2S_I2S_RX_HUNG_INT_ENA_S 6 +#define I2S_I2S_TX_REMPTY_INT_ENA (BIT(5)) +#define I2S_I2S_TX_REMPTY_INT_ENA_S 5 +#define I2S_I2S_TX_WFULL_INT_ENA (BIT(4)) +#define I2S_I2S_TX_WFULL_INT_ENA_S 4 +#define I2S_I2S_RX_REMPTY_INT_ENA (BIT(3)) +#define I2S_I2S_RX_REMPTY_INT_ENA_S 3 +#define I2S_I2S_RX_WFULL_INT_ENA (BIT(2)) +#define I2S_I2S_RX_WFULL_INT_ENA_S 2 +#define I2S_I2S_TX_PUT_DATA_INT_ENA (BIT(1)) +#define I2S_I2S_TX_PUT_DATA_INT_ENA_S 1 +#define I2S_I2S_RX_TAKE_DATA_INT_ENA (BIT(0)) +#define I2S_I2S_RX_TAKE_DATA_INT_ENA_S 0 + +#define I2SINT_CLR (DR_REG_I2S_BASE + 0x0018) +#define I2S_I2S_OUT_TOTAL_EOF_INT_CLR (BIT(16)) +#define I2S_I2S_OUT_TOTAL_EOF_INT_CLR_S 16 +#define I2S_I2S_IN_DSCR_EMPTY_INT_CLR (BIT(15)) +#define I2S_I2S_IN_DSCR_EMPTY_INT_CLR_S 15 +#define I2S_I2S_OUT_DSCR_ERR_INT_CLR (BIT(14)) +#define I2S_I2S_OUT_DSCR_ERR_INT_CLR_S 14 +#define I2S_I2S_IN_DSCR_ERR_INT_CLR (BIT(13)) +#define I2S_I2S_IN_DSCR_ERR_INT_CLR_S 13 +#define I2S_I2S_OUT_EOF_INT_CLR (BIT(12)) +#define I2S_I2S_OUT_EOF_INT_CLR_S 12 +#define I2S_I2S_OUT_DONE_INT_CLR (BIT(11)) +#define I2S_I2S_OUT_DONE_INT_CLR_S 11 +#define I2S_I2S_IN_ERR_EOF_INT_CLR (BIT(10)) +#define I2S_I2S_IN_ERR_EOF_INT_CLR_S 10 +#define I2S_I2S_IN_SUC_EOF_INT_CLR (BIT(9)) +#define I2S_I2S_IN_SUC_EOF_INT_CLR_S 9 +#define I2S_I2S_IN_DONE_INT_CLR (BIT(8)) +#define I2S_I2S_IN_DONE_INT_CLR_S 8 +#define I2S_I2S_TX_HUNG_INT_CLR (BIT(7)) +#define I2S_I2S_TX_HUNG_INT_CLR_S 7 +#define I2S_I2S_RX_HUNG_INT_CLR (BIT(6)) +#define I2S_I2S_RX_HUNG_INT_CLR_S 6 +#define I2S_I2S_TX_REMPTY_INT_CLR (BIT(5)) +#define I2S_I2S_TX_REMPTY_INT_CLR_S 5 +#define I2S_I2S_TX_WFULL_INT_CLR (BIT(4)) +#define I2S_I2S_TX_WFULL_INT_CLR_S 4 +#define I2S_I2S_RX_REMPTY_INT_CLR (BIT(3)) +#define I2S_I2S_RX_REMPTY_INT_CLR_S 3 +#define I2S_I2S_RX_WFULL_INT_CLR (BIT(2)) +#define I2S_I2S_RX_WFULL_INT_CLR_S 2 +#define I2S_I2S_PUT_DATA_INT_CLR (BIT(1)) +#define I2S_I2S_PUT_DATA_INT_CLR_S 1 +#define I2S_I2S_TAKE_DATA_INT_CLR (BIT(0)) +#define I2S_I2S_TAKE_DATA_INT_CLR_S 0 + +#define I2STIMING (DR_REG_I2S_BASE + 0x001c) +#define I2S_TX_BCK_IN_INV (BIT(24)) +#define I2S_TX_BCK_IN_INV_S 24 +#define I2S_DATA_ENABLE_DELAY 0x00000003 +#define I2S_DATA_ENABLE_DELAY_S 22 +#define I2S_RX_DSYNC_SW (BIT(21)) +#define I2S_RX_DSYNC_SW_S 21 +#define I2S_TX_DSYNC_SW (BIT(20)) +#define I2S_TX_DSYNC_SW_S 20 +#define I2S_RX_BCK_OUT_DELAY 0x00000003 +#define I2S_RX_BCK_OUT_DELAY_S 18 +#define I2S_RX_WS_OUT_DELAY 0x00000003 +#define I2S_RX_WS_OUT_DELAY_S 16 +#define I2S_TX_SD_OUT_DELAY 0x00000003 +#define I2S_TX_SD_OUT_DELAY_S 14 +#define I2S_TX_WS_OUT_DELAY 0x00000003 +#define I2S_TX_WS_OUT_DELAY_S 12 +#define I2S_TX_BCK_OUT_DELAY 0x00000003 +#define I2S_TX_BCK_OUT_DELAY_S 10 +#define I2S_RX_SD_IN_DELAY 0x00000003 +#define I2S_RX_SD_IN_DELAY_S 8 +#define I2S_RX_WS_IN_DELAY 0x00000003 +#define I2S_RX_WS_IN_DELAY_S 6 +#define I2S_RX_BCK_IN_DELAY 0x00000003 +#define I2S_RX_BCK_IN_DELAY_S 4 +#define I2S_TX_WS_IN_DELAY 0x00000003 +#define I2S_TX_WS_IN_DELAY_S 2 +#define I2S_TX_BCK_IN_DELAY 0x00000003 +#define I2S_TX_BCK_IN_DELAY_S 0 + +#define I2S_FIFO_CONF (DR_REG_I2S_BASE + 0x0020) +#define I2S_I2S_RX_FIFO_MOD_FORCE_EN (BIT(20)) +#define I2S_I2S_RX_FIFO_MOD_FORCE_EN_S 20 +#define I2S_I2S_TX_FIFO_MOD_FORCE_EN (BIT(19)) +#define I2S_I2S_TX_FIFO_MOD_FORCE_EN_S 19 +#define I2S_I2S_RX_FIFO_MOD 0x00000007 +#define I2S_I2S_RX_FIFO_MOD_S 16 +#define I2S_I2S_TX_FIFO_MOD 0x00000007 +#define I2S_I2S_TX_FIFO_MOD_S 13 +#define I2S_I2S_DSCR_EN (BIT(12)) +#define I2S_I2S_DSCR_EN_S 12 +#define I2S_I2S_TX_DATA_NUM 0x0000003F +#define I2S_I2S_TX_DATA_NUM_S 6 +#define I2S_I2S_RX_DATA_NUM 0x0000003F +#define I2S_I2S_RX_DATA_NUM_S 0 + +#define I2SRXEOF_NUM (DR_REG_I2S_BASE + 0x0024) +#define I2S_I2S_RX_EOF_NUM 0xFFFFFFFF +#define I2S_I2S_RX_EOF_NUM_S 0 + +#define I2SCONF_SIGLE_DATA (DR_REG_I2S_BASE + 0x0028) +#define I2S_I2S_SIGLE_DATA 0xFFFFFFFF +#define I2S_I2S_SIGLE_DATA_S 0 + +#define I2SCONF_CHAN (DR_REG_I2S_BASE + 0x002c) +#define I2S_RX_CHAN_MOD 0x00000003 +#define I2S_RX_CHAN_MOD_S 3 +#define I2S_TX_CHAN_MOD 0x00000007 +#define I2S_TX_CHAN_MOD_S 0 + +#define I2SOUT_LINK (DR_REG_I2S_BASE + 0x0030) +#define I2S_OUTLINK_PARK (BIT(31)) +#define I2S_OUTLINK_PARK_S 31 +#define I2S_I2S_OUTLINK_RESTART (BIT(30)) +#define I2S_I2S_OUTLINK_RESTART_S 30 +#define I2S_I2S_OUTLINK_START (BIT(29)) +#define I2S_I2S_OUTLINK_START_S 29 +#define I2S_I2S_OUTLINK_STOP (BIT(28)) +#define I2S_I2S_OUTLINK_STOP_S 28 +#define I2S_I2S_OUTLINK_ADDR 0x000FFFFF +#define I2S_I2S_OUTLINK_ADDR_S 0 + +#define I2SIN_LINK (DR_REG_I2S_BASE + 0x0034) +#define I2S_INLINK_PARK (BIT(31)) +#define I2S_INLINK_PARK_S 31 +#define I2S_I2S_INLINK_RESTART (BIT(30)) +#define I2S_I2S_INLINK_RESTART_S 30 +#define I2S_I2S_INLINK_START (BIT(29)) +#define I2S_I2S_INLINK_START_S 29 +#define I2S_I2S_INLINK_STOP (BIT(28)) +#define I2S_I2S_INLINK_STOP_S 28 +#define I2S_I2S_INLINK_ADDR 0x000FFFFF +#define I2S_I2S_INLINK_ADDR_S 0 + +#define I2S_OUT_EOF_DES_ADDR (DR_REG_I2S_BASE + 0x0038) +#define I2S_I2S_OUT_EOF_DES_ADDR 0xFFFFFFFF +#define I2S_I2S_OUT_EOF_DES_ADDR_S 0 + +#define I2S_IN_EOF_DES_ADDR (DR_REG_I2S_BASE + 0x003c) +#define I2S_I2S_IN_SUC_EOF_DES_ADDR 0xFFFFFFFF +#define I2S_I2S_IN_SUC_EOF_DES_ADDR_S 0 + +#define I2S_OUT_EOF_BFR_DES_ADDR (DR_REG_I2S_BASE + 0x0040) +#define I2S_I2S_OUT_EOF_BFR_DES_ADDR 0xFFFFFFFF +#define I2S_I2S_OUT_EOF_BFR_DES_ADDR_S 0 + +#define I2S_AHB_TEST (DR_REG_I2S_BASE + 0x0044) +#define I2S_I2S_AHB_TESTADDR 0x00000003 +#define I2S_I2S_AHB_TESTADDR_S 4 +#define I2S_I2S_AHB_TESTMODE 0x00000007 +#define I2S_I2S_AHB_TESTMODE_S 0 + +#define I2S_INLINK_DSCR (DR_REG_I2S_BASE + 0x0048) +#define I2S_I2S_INLINK_DSCR 0xFFFFFFFF +#define I2S_I2S_INLINK_DSCR_S 0 + +#define I2S_INLINK_DSCR_BF0 (DR_REG_I2S_BASE + 0x004C) +#define I2S_I2S_INLINK_DSCR_BF0 0xFFFFFFFF +#define I2S_I2S_INLINK_DSCR_BF0_S 0 + +#define I2S_INLINK_DSCR_BF1 (DR_REG_I2S_BASE + 0x0050) +#define I2S_I2S_INLINK_DSCR_BF1 0xFFFFFFFF +#define I2S_I2S_INLINK_DSCR_BF1_S 0 + +#define I2S_OUTLINK_DSCR (DR_REG_I2S_BASE + 0x0054) +#define I2S_I2S_OUTLINK_DSCR 0xFFFFFFFF +#define I2S_I2S_OUTLINK_DSCR_S 0 + +#define I2S_OUTLINK_DSCR_BF0 (DR_REG_I2S_BASE + 0x0058) +#define I2S_I2S_OUTLINK_DSCR_BF0 0xFFFFFFFF +#define I2S_I2S_OUTLINK_DSCR_BF0_S 0 + +#define I2S_OUTLINK_DSCR_BF1 (DR_REG_I2S_BASE + 0x005C) +#define I2S_I2S_OUTLINK_DSCR_BF1 0xFFFFFFFF +#define I2S_I2S_OUTLINK_DSCR_BF1_S 0 + +#define I2S_LC_CONF (DR_REG_I2S_BASE + 0x0060) +#define I2S_I2S_MEM_TRANS_EN (BIT(13)) +#define I2S_I2S_MEM_TRANS_EN_S 13 +#define I2S_I2S_CHECK_OWNER (BIT(12)) +#define I2S_I2S_CHECK_OWNER_S 12 +#define I2S_I2S_OUT_DATA_BURST_EN (BIT(11)) +#define I2S_I2S_OUT_DATA_BURST_EN_S 11 +#define I2S_I2S_INDSCR_BURST_EN (BIT(10)) +#define I2S_I2S_INDSCR_BURST_EN_S 10 +#define I2S_I2S_OUTDSCR_BURST_EN (BIT(9)) +#define I2S_I2S_OUTDSCR_BURST_EN_S 9 +#define I2S_I2S_OUT_EOF_MODE (BIT(8)) +#define I2S_I2S_OUT_EOF_MODE_S 8 +#define I2S_I2S_OUT_NO_RESTART_CLR (BIT(7)) +#define I2S_I2S_OUT_NO_RESTART_CLR_S 7 +#define I2S_I2S_OUT_AUTO_WRBACK (BIT(6)) +#define I2S_I2S_OUT_AUTO_WRBACK_S 6 +#define I2S_I2S_IN_LOOP_TEST (BIT(5)) +#define I2S_I2S_IN_LOOP_TEST_S 5 +#define I2S_I2S_OUT_LOOP_TEST (BIT(4)) +#define I2S_I2S_OUT_LOOP_TEST_S 4 +#define I2S_I2S_AHBM_RST (BIT(3)) +#define I2S_I2S_AHBM_RST_S 3 +#define I2S_I2S_AHBM_FIFO_RST (BIT(2)) +#define I2S_I2S_AHBM_FIFO_RST_S 2 +#define I2S_I2S_OUT_RST (BIT(1)) +#define I2S_I2S_OUT_RST_S 1 +#define I2S_I2S_IN_RST (BIT(0)) +#define I2S_I2S_IN_RST_S 0 + +#define I2S_OUTFIFO_PUSH (DR_REG_I2S_BASE + 0x0064) +#define I2S_I2S_OUTFIFO_PUSH (BIT(16)) +#define I2S_I2S_OUTFIFO_PUSH_S 16 +#define I2S_I2S_OUTFIFO_WDATA 0x000001FF +#define I2S_I2S_OUTFIFO_WDATA_S 0 + +#define I2S_INFIFO_POP (DR_REG_I2S_BASE + 0x0068) +#define I2S_I2S_INFIFO_POP (BIT(16)) +#define I2S_I2S_INFIFO_POP_S 16 +#define I2S_I2S_INFIFO_RDATA 0x00000FFF +#define I2S_I2S_INFIFO_RDATA_S 0 + +#define I2S_LC_STATE0 (DR_REG_I2S_BASE + 0x006C) +#define I2S_I2S_LC_STATE0 0xFFFFFFFF +#define I2S_I2S_LC_STATE0_S 0 + +#define I2S_LC_STATE1 (DR_REG_I2S_BASE + 0x0070) +#define I2S_I2S_LC_STATE1 0xFFFFFFFF +#define I2S_I2S_LC_STATE1_S 0 + +#define I2S_LC_HUNG_CONF (DR_REG_I2S_BASE + 0x0074) +#define I2S_I2S_LC_FIFO_TIMEOUT_ENA (BIT(11)) +#define I2S_I2S_LC_FIFO_TIMEOUT_ENA_S 11 +#define I2S_I2S_LC_FIFO_TIMEOUT_SHIFT 0x00000007 +#define I2S_I2S_LC_FIFO_TIMEOUT_SHIFT_S 8 +#define I2S_I2S_LC_FIFO_TIMEOUT 0x000000FF +#define I2S_I2S_LC_FIFO_TIMEOUT_S 0 + +#define I2S_CVSD_CONF0 (DR_REG_I2S_BASE + 0x0080) +#define I2S_I2S_CVSD_Y_MIN 0x0000FFFF +#define I2S_I2S_CVSD_Y_MIN_S 16 +#define I2S_I2S_CVSD_Y_MAX 0x0000FFFF +#define I2S_I2S_CVSD_Y_MAX_S 0 + +#define I2S_CVSD_CONF1 (DR_REG_I2S_BASE + 0x0084) +#define I2S_I2S_CVSD_SIGMA_MIN 0x0000FFFF +#define I2S_I2S_CVSD_SIGMA_MIN_S 16 +#define I2S_I2S_CVSD_SIGMA_MAX 0x0000FFFF +#define I2S_I2S_CVSD_SIGMA_MAX_S 0 + +#define I2S_CVSD_CONF2 (DR_REG_I2S_BASE + 0x0088) +#define I2S_I2S_CVSD_H 0x00000007 +#define I2S_I2S_CVSD_H_S 16 +#define I2S_I2S_CVSD_BETA 0x000003FF +#define I2S_I2S_CVSD_BETA_S 6 +#define I2S_I2S_CVSD_J 0x00000007 +#define I2S_I2S_CVSD_J_S 3 +#define I2S_I2S_CVSD_K 0x00000007 +#define I2S_I2S_CVSD_K_S 0 + +#define I2S_PLC_CONF0 (DR_REG_I2S_BASE + 0x008C) +#define I2S_I2S_N_MIN_ERR 0x00000007 +#define I2S_I2S_N_MIN_ERR_S 25 +#define I2S_I2S_PACK_LEN_8K 0x0000001F +#define I2S_I2S_PACK_LEN_8K_S 20 +#define I2S_I2S_MAX_SLIDE_SAMPLE 0x000000FF +#define I2S_I2S_MAX_SLIDE_SAMPLE_S 12 +#define I2S_I2S_SHIFT_RATE 0x00000007 +#define I2S_I2S_SHIFT_RATE_S 9 +#define I2S_I2S_N_ERR_SEG 0x00000007 +#define I2S_I2S_N_ERR_SEG_S 6 +#define I2S_I2S_GOOD_PACK_MAX 0x0000003F +#define I2S_I2S_GOOD_PACK_MAX_S 0 + +#define I2S_PLC_CONF1 (DR_REG_I2S_BASE + 0x0090) +#define I2S_I2S_SLIDE_WIN_LEN 0x000000FF +#define I2S_I2S_SLIDE_WIN_LEN_S 24 +#define I2S_I2S_BAD_OLA_WIN2_PARA 0x000000FF +#define I2S_I2S_BAD_OLA_WIN2_PARA_S 16 +#define I2S_I2S_BAD_OLA_WIN2_PARA_SHIFT 0x0000000F +#define I2S_I2S_BAD_OLA_WIN2_PARA_SHIFT_S 12 +#define I2S_I2S_BAD_CEF_ATTEN_PARA_SHIFT 0x0000000F +#define I2S_I2S_BAD_CEF_ATTEN_PARA_SHIFT_S 8 +#define I2S_I2S_BAD_CEF_ATTEN_PARA 0x000000FF +#define I2S_I2S_BAD_CEF_ATTEN_PARA_S 0 + +#define I2S_PLC_CONF2 (DR_REG_I2S_BASE + 0x0094) +#define I2S_I2S_MIN_PERIOD 0x0000001F +#define I2S_I2S_MIN_PERIOD_S 2 +#define I2S_I2S_CVSD_SEG_MOD 0x00000003 +#define I2S_I2S_CVSD_SEG_MOD_S 0 + +#define I2S_ESCO_CONF0 (DR_REG_I2S_BASE + 0x0098) +#define I2S_I2S_PLC2DMA_EN (BIT(12)) +#define I2S_I2S_PLC2DMA_EN_S 12 +#define I2S_I2S_PLC_EN (BIT(11)) +#define I2S_I2S_PLC_EN_S 11 +#define I2S_I2S_CVSD_DEC_RESET (BIT(10)) +#define I2S_I2S_CVSD_DEC_RESET_S 10 +#define I2S_I2S_CVSD_DEC_START (BIT(9)) +#define I2S_I2S_CVSD_DEC_START_S 9 +#define I2S_I2S_ESCO_CVSD_INF_EN (BIT(8)) +#define I2S_I2S_ESCO_CVSD_INF_EN_S 8 +#define I2S_I2S_ESCO_CVSD_PACK_LEN_8K 0x0000001F +#define I2S_I2S_ESCO_CVSD_PACK_LEN_8K_S 3 +#define I2S_I2S_ESCO_CVSD_DEC_PACK_ERR (BIT(2)) +#define I2S_I2S_ESCO_CVSD_DEC_PACK_ERR_S 2 +#define I2S_I2S_ESCO_CHAN_MOD (BIT(1)) +#define I2S_I2S_ESCO_CHAN_MOD_S 1 +#define I2S_I2S_ESCO_EN (BIT(0)) +#define I2S_I2S_ESCO_EN_S 0 + +#define I2S_SCO_CONF0 (DR_REG_I2S_BASE + 0x009c) +#define I2S_I2S_CVSD_ENC_RESET (BIT(3)) +#define I2S_I2S_CVSD_ENC_RESET_S 3 +#define I2S_I2S_CVSD_ENC_START (BIT(2)) +#define I2S_I2S_CVSD_ENC_START_S 2 +#define I2S_I2S_SCO_NO_I2S_EN (BIT(1)) +#define I2S_I2S_SCO_NO_I2S_EN_S 1 +#define I2S_I2S_SCO_WITH_I2S_EN (BIT(0)) +#define I2S_I2S_SCO_WITH_I2S_EN_S 0 + +#define I2SCONF1 (DR_REG_I2S_BASE + 0x00a0) +#define I2S_I2S_TX_ZEROS_RM_EN (BIT(9)) +#define I2S_I2S_TX_ZEROS_RM_EN_S 9 +#define I2S_I2S_TX_STOP_EN (BIT(8)) +#define I2S_I2S_TX_STOP_EN_S 8 +#define I2S_RX_PCM_BYPASS (BIT(7)) +#define I2S_RX_PCM_BYPASS_S 7 +#define I2S_RX_PCM_CONF 0x00000007 +#define I2S_RX_PCM_CONF_S 4 +#define I2S_TX_PCM_BYPASS (BIT(3)) +#define I2S_TX_PCM_BYPASS_S 3 +#define I2S_TX_PCM_CONF 0x00000007 +#define I2S_TX_PCM_CONF_S 0 + +#define I2S_PD_CONF (DR_REG_I2S_BASE + 0x00a4) +#define I2S_PLC_MEM_FORCE_PU (BIT(3)) +#define I2S_PLC_MEM_FORCE_PU_S 3 +#define I2S_PLC_MEM_FORCE_PD (BIT(2)) +#define I2S_PLC_MEM_FORCE_PD_S 2 +#define I2S_I2S_FIFO_FORCE_PU (BIT(1)) +#define I2S_I2S_FIFO_FORCE_PU_S 1 +#define I2S_I2S_FIFO_FORCE_PD (BIT(0)) +#define I2S_I2S_FIFO_FORCE_PD_S 0 + +#define I2SCONF2 (DR_REG_I2S_BASE + 0x00a8) +#define I2S_INTER_VALID_EN (BIT(7)) +#define I2S_INTER_VALID_EN_S 7 +#define I2S_EXT_ADC_START_EN (BIT(6)) +#define I2S_EXT_ADC_START_EN_S 6 +#define I2S_LCD_EN (BIT(5)) +#define I2S_LCD_EN_S 5 +#define I2S_DATA_ENABLE (BIT(4)) +#define I2S_DATA_ENABLE_S 4 +#define I2S_DATA_ENABLE_TEST_EN (BIT(3)) +#define I2S_DATA_ENABLE_TEST_EN_S 3 +#define I2S_LCD_TX_SDX2_EN (BIT(2)) +#define I2S_LCD_TX_SDX2_EN_S 2 +#define I2S_LCD_TX_WRX2_EN (BIT(1)) +#define I2S_LCD_TX_WRX2_EN_S 1 +#define I2S_CAMERA_EN (BIT(0)) +#define I2S_CAMERA_EN_S 0 + +#define I2S_CLKM_CONF (DR_REG_I2S_BASE + 0x00ac) +#define I2S_CLKA_ENA (BIT(21)) +#define I2S_CLKA_ENA_S 21 +#define I2S_CLK_EN (BIT(20)) +#define I2S_CLK_EN_S 20 +#define I2S_CLKM_DIV_A 0x0000003F +#define I2S_CLKM_DIV_A_S 14 +#define I2S_CLKM_DIV_B 0x0000003F +#define I2S_CLKM_DIV_B_S 8 +#define I2S_CLKM_DIV_NUM 0x000000FF +#define I2S_CLKM_DIV_NUM_S 0 + +#define I2S_SAMPLE_RATE_CONF (DR_REG_I2S_BASE + 0x00b0) +#define I2S_RX_BITS_MOD 0x0000003F +#define I2S_RX_BITS_MOD_S 18 +#define I2S_TX_BITS_MOD 0x0000003F +#define I2S_TX_BITS_MOD_S 12 +#define I2S_RX_BCK_DIV_NUM 0x0000003F +#define I2S_RX_BCK_DIV_NUM_S 6 +#define I2S_TX_BCK_DIV_NUM 0x0000003F +#define I2S_TX_BCK_DIV_NUM_S 0 + +#define I2S_PDM_CONF (DR_REG_I2S_BASE + 0x00b4) +#define I2S_TX_PDM_HP_BYPASS (BIT(25)) +#define I2S_TX_PDM_HP_BYPASS_S 25 +#define I2S_RX_PDM_SINC_DSR_16_EN (BIT(24)) +#define I2S_RX_PDM_SINC_DSR_16_EN_S 24 +#define I2S_TX_PDM_SIGMADELTA_IN_SHIFT 0x00000003 +#define I2S_TX_PDM_SIGMADELTA_IN_SHIFT_S 22 +#define I2S_TX_PDM_SINC_IN_SHIFT 0x00000003 +#define I2S_TX_PDM_SINC_IN_SHIFT_S 20 +#define I2S_TX_PDM_LP_IN_SHIFT 0x00000003 +#define I2S_TX_PDM_LP_IN_SHIFT_S 18 +#define I2S_TX_PDM_HP_IN_SHIFT 0x00000003 +#define I2S_TX_PDM_HP_IN_SHIFT_S 16 +#define I2S_TX_PDM_PRESCALE 0x000000FF +#define I2S_TX_PDM_PRESCALE_S 8 +#define I2S_TX_PDM_SINC_OSR2 0x0000000F +#define I2S_TX_PDM_SINC_OSR2_S 4 +#define I2S_PDM2PCM_CONV_EN (BIT(3)) +#define I2S_PDM2PCM_CONV_EN_S 3 +#define I2S_PCM2PDM_CONV_EN (BIT(2)) +#define I2S_PCM2PDM_CONV_EN_S 2 +#define I2S_RX_PDM_EN (BIT(1)) +#define I2S_RX_PDM_EN_S 1 +#define I2S_TX_PDM_EN (BIT(0)) +#define I2S_TX_PDM_EN_S 0 + +#define I2S_PDM_FREQ_CONF (DR_REG_I2S_BASE + 0x00b8) +#define I2S_TX_PDM_FP 0x000003FF +#define I2S_TX_PDM_FP_S 10 +#define I2S_TX_PDM_FS 0x000003FF +#define I2S_TX_PDM_FS_S 0 + +#define I2S_STATE (DR_REG_I2S_BASE + 0x00bc) +#define I2S_I2S_RX_FIFO_RESET_BACK (BIT(2)) +#define I2S_I2S_RX_FIFO_RESET_BACK_S 2 +#define I2S_I2S_TX_FIFO_RESET_BACK (BIT(1)) +#define I2S_I2S_TX_FIFO_RESET_BACK_S 1 +#define I2S_I2S_TX_IDLE (BIT(0)) +#define I2S_I2S_TX_IDLE_S 0 + +#define I2S_DATE (DR_REG_I2S_BASE + 0x00fc) +#define I2S_I2SDATE 0xFFFFFFFF +#define I2S_I2SDATE_S 0 + +#endif /* _SOC_I2S_REG_H_ */ diff --git a/components/esp32/include/soc/io_mux_reg.h b/components/esp32/include/soc/io_mux_reg.h new file mode 100644 index 000000000..bc9f769b7 --- /dev/null +++ b/components/esp32/include/soc/io_mux_reg.h @@ -0,0 +1,264 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_IO_MUX_REG_H_ +#define _SOC_IO_MUX_REG_H_ + +#include "soc.h" + +#define SLP_OE (BIT(0)) +#define SLP_SEL (BIT(1)) +#define SLP_PD (BIT(2)) +#define SLP_PU (BIT(3)) +#define SLP_IE (BIT(4)) +#define SLP_DRV 0x3 +#define SLP_DRV_S 5 +#define FUN_PD (BIT(7)) +#define FUN_PU (BIT(8)) +#define FUN_IE (BIT(9)) +#define FUN_DRV 0x3 +#define FUN_DRV_S 10 +#define MCU_SEL 0x7 +#define MCU_SEL_S 12 + + +#define PIN_SET_DRV(PIN_NAME, drv) REG_SET_FIELD(PIN_NAME, FUN_DRV, (drv)); +#define PIN_PULLUP_DIS(PIN_NAME) REG_CLR_BIT(PIN_NAME, FUN_PU) +#define PIN_PULLUP_EN(PIN_NAME) REG_SET_BIT(PIN_NAME, FUN_PU) +#define PIN_PULLDWN_DIS(PIN_NAME) REG_CLR_BIT(PIN_NAME, FUN_PD) +#define PIN_PULLDWN_EN(PIN_NAME) REG_SET_BIT(PIN_NAME, FUN_PD) +#define PIN_FUNC_SELECT(PIN_NAME, FUNC) REG_SET_FIELD(PIN_NAME, MCU_SEL, FUNC) + +#define PIN_CTRL (DR_REG_IO_MUX_BASE +0x00) +#define CLK_OUT3 0xf +#define CLK_OUT3_S 8 +#define CLK_OUT2 0xf +#define CLK_OUT2_S 4 +#define CLK_OUT1 0xf +#define CLK_OUT1_S 0 + +#define PERIPHS_IO_MUX_GPIO36_U (DR_REG_IO_MUX_BASE +0x04) +#define FUNC_GPIO36_GPIO36 2 +#define FUNC_GPIO36_GPIO36_0 0 + +#define PERIPHS_IO_MUX_GPIO37_U (DR_REG_IO_MUX_BASE +0x08) +#define FUNC_GPIO37_GPIO37 2 +#define FUNC_GPIO37_GPIO37_0 0 + +#define PERIPHS_IO_MUX_GPIO38_U (DR_REG_IO_MUX_BASE +0x0c) +#define FUNC_GPIO38_GPIO38 2 +#define FUNC_GPIO38_GPIO38_0 0 + +#define PERIPHS_IO_MUX_GPIO39_U (DR_REG_IO_MUX_BASE +0x10) +#define FUNC_GPIO39_GPIO39 2 +#define FUNC_GPIO39_GPIO39_0 0 + +#define PERIPHS_IO_MUX_GPIO34_U (DR_REG_IO_MUX_BASE +0x14) +#define FUNC_GPIO34_GPIO34 2 +#define FUNC_GPIO34_GPIO34_0 0 + +#define PERIPHS_IO_MUX_GPIO35_U (DR_REG_IO_MUX_BASE +0x18) +#define FUNC_GPIO35_GPIO35 2 +#define FUNC_GPIO35_GPIO35_0 0 + +#define PERIPHS_IO_MUX_GPIO32_U (DR_REG_IO_MUX_BASE +0x1c) +#define FUNC_GPIO32_GPIO32 2 +#define FUNC_GPIO32_GPIO32_0 0 + +#define PERIPHS_IO_MUX_GPIO33_U (DR_REG_IO_MUX_BASE +0x20) +#define FUNC_GPIO33_GPIO33 2 +#define FUNC_GPIO33_GPIO33_0 0 + +#define PERIPHS_IO_MUX_GPIO25_U (DR_REG_IO_MUX_BASE +0x24) +#define FUNC_GPIO25_GPIO25 2 +#define FUNC_GPIO25_GPIO25_0 0 + +#define PERIPHS_IO_MUX_GPIO26_U (DR_REG_IO_MUX_BASE +0x28) +#define FUNC_GPIO26_GPIO26 2 +#define FUNC_GPIO26_GPIO26_0 0 + +#define PERIPHS_IO_MUX_GPIO27_U (DR_REG_IO_MUX_BASE +0x2c) +#define FUNC_GPIO27_EMAC_RXD2 5 +#define FUNC_GPIO27_GPIO27 2 +#define FUNC_GPIO27_GPIO27_0 0 + +#define PERIPHS_IO_MUX_MTMS_U (DR_REG_IO_MUX_BASE +0x30) +#define FUNC_MTMS_EMAC_TXD2 5 +#define FUNC_MTMS_SD_CLK 4 +#define FUNC_MTMS_GPIO14 2 +#define FUNC_MTMS_HSPICLK 1 +#define FUNC_MTMS_MTMS 0 + +#define PERIPHS_IO_MUX_MTDI_U (DR_REG_IO_MUX_BASE +0x34) +#define FUNC_MTDI_EMAC_TXD3 5 +#define FUNC_MTDI_SD_DATA2 4 +#define FUNC_MTDI_GPIO12 2 +#define FUNC_MTDI_HSPIQ 1 +#define FUNC_MTDI_MTDI 0 + +#define PERIPHS_IO_MUX_MTCK_U (DR_REG_IO_MUX_BASE +0x38) +#define FUNC_MTCK_EMAC_RX_ER 5 +#define FUNC_MTCK_SD_DATA3 4 +#define FUNC_MTCK_U0CTS 3 +#define FUNC_MTCK_GPIO13 2 +#define FUNC_MTCK_HSPID 1 +#define FUNC_MTCK_MTCK 0 + +#define PERIPHS_IO_MUX_MTDO_U (DR_REG_IO_MUX_BASE +0x3c) +#define FUNC_MTDO_EMAC_RXD3 5 +#define FUNC_MTDO_SD_CMD 4 +#define FUNC_MTDO_U0RTS 3 +#define FUNC_MTDO_GPIO15 2 +#define FUNC_MTDO_HSPICS0 1 +#define FUNC_MTDO_MTDO 0 + +#define PERIPHS_IO_MUX_GPIO2_U (DR_REG_IO_MUX_BASE +0x40) +#define FUNC_GPIO2_EMAC_RX_DV 5 +#define FUNC_GPIO2_SD_DATA0 4 +#define FUNC_GPIO2_GPIO2 2 +#define FUNC_GPIO2_HSPIWP 1 +#define FUNC_GPIO2_GPIO2_0 0 + +#define PERIPHS_IO_MUX_GPIO0_U (DR_REG_IO_MUX_BASE +0x44) +#define FUNC_GPIO0_EMAC_TX_CLK 5 +#define FUNC_GPIO0_HS2_CMD 3 +#define FUNC_GPIO0_GPIO0 2 +#define FUNC_GPIO0_CLK_OUT1 1 +#define FUNC_GPIO0_GPIO0_0 0 + +#define PERIPHS_IO_MUX_GPIO4_U (DR_REG_IO_MUX_BASE +0x48) +#define FUNC_GPIO4_EMAC_TX_ER 5 +#define FUNC_GPIO4_SD_DATA1 4 +#define FUNC_GPIO4_GPIO4 2 +#define FUNC_GPIO4_HSPIHD 1 +#define FUNC_GPIO4_GPIO4_0 0 + +#define PERIPHS_IO_MUX_GPIO16_U (DR_REG_IO_MUX_BASE +0x4c) +#define FUNC_GPIO16_EMAC_CLK_OUT 5 +#define FUNC_GPIO16_U2RXD 4 +#define FUNC_GPIO16_HS1_DATA4 3 +#define FUNC_GPIO16_GPIO16 2 +#define FUNC_GPIO16_GPIO16_0 0 + +#define PERIPHS_IO_MUX_GPIO17_U (DR_REG_IO_MUX_BASE +0x50) +#define FUNC_GPIO17_EMAC_CLK_OUT_180 5 +#define FUNC_GPIO17_U2TXD 4 +#define FUNC_GPIO17_HS1_DATA5 3 +#define FUNC_GPIO17_GPIO17 2 +#define FUNC_GPIO17_GPIO17_0 0 + +#define PERIPHS_IO_MUX_SD_DATA2_U (DR_REG_IO_MUX_BASE +0x54) +#define FUNC_SD_DATA2_U1RXD 4 +#define FUNC_SD_DATA2_HS1_DATA2 3 +#define FUNC_SD_DATA2_GPIO9 2 +#define FUNC_SD_DATA2_SPIHD 1 +#define FUNC_SD_DATA2_SD_DATA2 0 + +#define PERIPHS_IO_MUX_SD_DATA3_U (DR_REG_IO_MUX_BASE +0x58) +#define FUNC_SD_DATA3_U1TXD 4 +#define FUNC_SD_DATA3_HS1_DATA3 3 +#define FUNC_SD_DATA3_GPIO10 2 +#define FUNC_SD_DATA3_SPIWP 1 +#define FUNC_SD_DATA3_SD_DATA3 0 + +#define PERIPHS_IO_MUX_SD_CMD_U (DR_REG_IO_MUX_BASE +0x5c) +#define FUNC_SD_CMD_U1RTS 4 +#define FUNC_SD_CMD_HS1_CMD 3 +#define FUNC_SD_CMD_GPIO11 2 +#define FUNC_SD_CMD_SPICS0 1 +#define FUNC_SD_CMD_SD_CMD 0 + +#define PERIPHS_IO_MUX_SD_CLK_U (DR_REG_IO_MUX_BASE +0x60) +#define FUNC_SD_CLK_U1CTS 4 +#define FUNC_SD_CLK_HS1_CLK 3 +#define FUNC_SD_CLK_GPIO6 2 +#define FUNC_SD_CLK_SPICLK 1 +#define FUNC_SD_CLK_SD_CLK 0 + +#define PERIPHS_IO_MUX_SD_DATA0_U (DR_REG_IO_MUX_BASE +0x64) +#define FUNC_SD_DATA0_U2RTS 4 +#define FUNC_SD_DATA0_HS1_DATA0 3 +#define FUNC_SD_DATA0_GPIO7 2 +#define FUNC_SD_DATA0_SPIQ 1 +#define FUNC_SD_DATA0_SD_DATA0 0 + +#define PERIPHS_IO_MUX_SD_DATA1_U (DR_REG_IO_MUX_BASE +0x68) +#define FUNC_SD_DATA1_U2CTS 4 +#define FUNC_SD_DATA1_HS1_DATA1 3 +#define FUNC_SD_DATA1_GPIO8 2 +#define FUNC_SD_DATA1_SPID 1 +#define FUNC_SD_DATA1_SD_DATA1 0 + +#define PERIPHS_IO_MUX_GPIO5_U (DR_REG_IO_MUX_BASE +0x6c) +#define FUNC_GPIO5_EMAC_RX_CLK 5 +#define FUNC_GPIO5_HS1_DATA6 3 +#define FUNC_GPIO5_GPIO5 2 +#define FUNC_GPIO5_VSPICS0 1 +#define FUNC_GPIO5_GPIO5_0 0 + +#define PERIPHS_IO_MUX_GPIO18_U (DR_REG_IO_MUX_BASE +0x70) +#define FUNC_GPIO18_EMAC_TXD0 5 +#define FUNC_GPIO18_HS1_DATA7 3 +#define FUNC_GPIO18_GPIO18 2 +#define FUNC_GPIO18_VSPICLK 1 +#define FUNC_GPIO18_GPIO18_0 0 + +#define PERIPHS_IO_MUX_GPIO19_U (DR_REG_IO_MUX_BASE +0x74) +#define FUNC_GPIO19_EMAC_TXD1 5 +#define FUNC_GPIO19_HS2_DATA2 3 +#define FUNC_GPIO19_GPIO19 2 +#define FUNC_GPIO19_VSPIQ 1 +#define FUNC_GPIO19_GPIO19_0 0 + +#define PERIPHS_IO_MUX_GPIO20_U (DR_REG_IO_MUX_BASE +0x78) +#define FUNC_GPIO20_GPIO20 2 +#define FUNC_GPIO20_GPIO20_0 0 + +#define PERIPHS_IO_MUX_GPIO21_U (DR_REG_IO_MUX_BASE +0x7c) +#define FUNC_GPIO21_EMAC_RXD0 5 +#define FUNC_GPIO21_HS2_DATA3 3 +#define FUNC_GPIO21_GPIO21 2 +#define FUNC_GPIO21_VSPIHD 1 +#define FUNC_GPIO21_GPIO21_0 0 + +#define PERIPHS_IO_MUX_GPIO22_U (DR_REG_IO_MUX_BASE +0x80) +#define FUNC_GPIO22_EMAC_RXD1 5 +#define FUNC_GPIO22_HS2_CLK 3 +#define FUNC_GPIO22_GPIO22 2 +#define FUNC_GPIO22_VSPIWP 1 +#define FUNC_GPIO22_GPIO22_0 0 + +#define PERIPHS_IO_MUX_U0RXD_U (DR_REG_IO_MUX_BASE +0x84) +#define FUNC_U0RXD_HS2_DATA0 3 +#define FUNC_U0RXD_GPIO3 2 +#define FUNC_U0RXD_CLK_OUT2 1 +#define FUNC_U0RXD_U0RXD 0 + +#define PERIPHS_IO_MUX_U0TXD_U (DR_REG_IO_MUX_BASE +0x88) +#define FUNC_U0TXD_HS2_DATA1 3 +#define FUNC_U0TXD_GPIO1 2 +#define FUNC_U0TXD_CLK_OUT3 1 +#define FUNC_U0TXD_U0TXD 0 + +#define PERIPHS_IO_MUX_GPIO23_U (DR_REG_IO_MUX_BASE +0x8c) +#define FUNC_GPIO23_EMAC_TX_EN 5 +#define FUNC_GPIO23_HS1_STROBE 3 +#define FUNC_GPIO23_GPIO23 2 +#define FUNC_GPIO23_VSPID 1 +#define FUNC_GPIO23_GPIO23_0 0 + +#define PERIPHS_IO_MUX_GPIO24_U (DR_REG_IO_MUX_BASE +0x90) +#define FUNC_GPIO24_GPIO24 2 +#define FUNC_GPIO24_GPIO24_0 0 + +#endif /* _SOC_IO_MUX_REG_H_ */ diff --git a/components/esp32/include/soc/pid.h b/components/esp32/include/soc/pid.h new file mode 100644 index 000000000..bd4e9f26d --- /dev/null +++ b/components/esp32/include/soc/pid.h @@ -0,0 +1,65 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_PID_H_ +#define _SOC_PID_H_ + +#define PROPID_GEN_BASE 0x3FF1F000 +//Bits 1..7: 1 if interrupt will be triggering PID change +#define PROPID_CONFIG_INTERRUPT_ENABLE ((PROPID_GEN_BASE)+0x000) +//Vectors for the various interrupt handlers +#define PROPID_CONFIG_INTERRUPT_ADDR_1 ((PROPID_GEN_BASE)+0x004) +#define PROPID_CONFIG_INTERRUPT_ADDR_2 ((PROPID_GEN_BASE)+0x008) +#define PROPID_CONFIG_INTERRUPT_ADDR_3 ((PROPID_GEN_BASE)+0x00C) +#define PROPID_CONFIG_INTERRUPT_ADDR_4 ((PROPID_GEN_BASE)+0x010) +#define PROPID_CONFIG_INTERRUPT_ADDR_5 ((PROPID_GEN_BASE)+0x014) +#define PROPID_CONFIG_INTERRUPT_ADDR_6 ((PROPID_GEN_BASE)+0x018) +#define PROPID_CONFIG_INTERRUPT_ADDR_7 ((PROPID_GEN_BASE)+0x01C) + +//Delay, in CPU cycles, before switching to new PID +#define PROPID_CONFIG_PID_DELAY ((PROPID_GEN_BASE)+0x020) +#define PROPID_CONFIG_NMI_DELAY ((PROPID_GEN_BASE)+0x024) + +//Last detected interrupt. Set by hw on int. +#define PROPID_TABLE_LEVEL ((PROPID_GEN_BASE)+0x028) +//PID/prev int data for each int +#define PROPID_FROM_1 ((PROPID_GEN_BASE)+0x02C) +#define PROPID_FROM_2 ((PROPID_GEN_BASE)+0x030) +#define PROPID_FROM_3 ((PROPID_GEN_BASE)+0x034) +#define PROPID_FROM_4 ((PROPID_GEN_BASE)+0x038) +#define PROPID_FROM_5 ((PROPID_GEN_BASE)+0x03C) +#define PROPID_FROM_6 ((PROPID_GEN_BASE)+0x040) +#define PROPID_FROM_7 ((PROPID_GEN_BASE)+0x044) +#define PROPID_FROM_PID_MASK 0x7 +#define PROPID_FROM_PID_S 0 +#define PROPID_FROM_INT_MASK 0xF +#define PROPID_FROM_INT_S 3 + +//PID to be set after confirm routine +#define PROPID_PID_NEW ((PROPID_GEN_BASE)+0x048) +//Write to kick off PID change +#define PROPID_PID_CONFIRM ((PROPID_GEN_BASE)+0x04c) +//current PID? +#define PROPID_PID_REG ((PROPID_GEN_BASE)+0x050) + +//Write to mask NMI +#define PROPID_PID_NMI_MASK_HW_ENABLE ((PROPID_GEN_BASE)+0x054) +//Write to unmask NMI +#define PROPID_PID_NMI_MASK_HW_DISABLE ((PROPID_GEN_BASE)+0x058) +#define PROPID_PID_NMI_MASK_HW_REG ((PROPID_GEN_BASE)+0x05c) + +//Debug regs +#define PROPID_PID ((PROPID_GEN_BASE)+0x060) +#define PROPID_NMI_MASK_HW ((PROPID_GEN_BASE)+0x064) + +#endif /* _SOC_PID_H_ */ diff --git a/components/esp32/include/soc/rtc_cntl_reg.h b/components/esp32/include/soc/rtc_cntl_reg.h new file mode 100644 index 000000000..c94d17dbb --- /dev/null +++ b/components/esp32/include/soc/rtc_cntl_reg.h @@ -0,0 +1,751 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_RTC_CNTL_REG_H_ +#define _SOC_RTC_CNTL_REG_H_ + +#include "soc.h" + +#define RTC_OPTIONS0 (DR_REG_RTCCNTL_BASE + 0x0) +#define RTC_CNTL_SW_SYS_RST (BIT(31)) +#define RTC_CNTL_SW_SYS_RST_S 31 +#define RTC_CNTL_DG_WRAP_FORCE_NORST (BIT(30)) +#define RTC_CNTL_DG_WRAP_FORCE_NORST_S 30 +#define RTC_CNTL_DG_WRAP_FORCE_RST (BIT(29)) +#define RTC_CNTL_DG_WRAP_FORCE_RST_S 29 +#define RTC_CNTL_ANALOG_FORCE_NOISO (BIT(28)) +#define RTC_CNTL_ANALOG_FORCE_NOISO_S 28 +#define RTC_CNTL_PLL_FORCE_NOISO (BIT(27)) +#define RTC_CNTL_PLL_FORCE_NOISO_S 27 +#define RTC_CNTL_XTL_FORCE_NOISO (BIT(26)) +#define RTC_CNTL_XTL_FORCE_NOISO_S 26 +#define RTC_CNTL_ANALOG_FORCE_ISO (BIT(25)) +#define RTC_CNTL_ANALOG_FORCE_ISO_S 25 +#define RTC_CNTL_PLL_FORCE_ISO (BIT(24)) +#define RTC_CNTL_PLL_FORCE_ISO_S 24 +#define RTC_CNTL_XTL_FORCE_ISO (BIT(23)) +#define RTC_CNTL_XTL_FORCE_ISO_S 23 +#define RTC_CNTL_BIAS_CORE_FORCE_PU (BIT(22)) +#define RTC_CNTL_BIAS_CORE_FORCE_PU_S 22 +#define RTC_CNTL_BIAS_CORE_FORCE_PD (BIT(21)) +#define RTC_CNTL_BIAS_CORE_FORCE_PD_S 21 +#define RTC_CNTL_BIAS_CORE_FOLW_12M (BIT(20)) +#define RTC_CNTL_BIAS_CORE_FOLW_12M_S 20 +#define RTC_CNTL_BIAS_I2C_FORCE_PU (BIT(19)) +#define RTC_CNTL_BIAS_I2C_FORCE_PU_S 19 +#define RTC_CNTL_BIAS_I2C_FORCE_PD (BIT(18)) +#define RTC_CNTL_BIAS_I2C_FORCE_PD_S 18 +#define RTC_CNTL_BIAS_I2C_FOLW_12M (BIT(17)) +#define RTC_CNTL_BIAS_I2C_FOLW_12M_S 17 +#define RTC_CNTL_BIAS_FORCE_NOSLEEP (BIT(16)) +#define RTC_CNTL_BIAS_FORCE_NOSLEEP_S 16 +#define RTC_CNTL_BIAS_FORCE_SLEEP (BIT(15)) +#define RTC_CNTL_BIAS_FORCE_SLEEP_S 15 +#define RTC_CNTL_BIAS_SLEEP_FOLW_12M (BIT(14)) +#define RTC_CNTL_BIAS_SLEEP_FOLW_12M_S 14 +#define RTC_CNTL_XTL_FORCE_PU (BIT(13)) +#define RTC_CNTL_XTL_FORCE_PU_S 13 +#define RTC_CNTL_XTL_FORCE_PD (BIT(12)) +#define RTC_CNTL_XTL_FORCE_PD_S 12 +#define RTC_CNTL_BBPLL_FORCE_PU (BIT(11)) +#define RTC_CNTL_BBPLL_FORCE_PU_S 11 +#define RTC_CNTL_BBPLL_FORCE_PD (BIT(10)) +#define RTC_CNTL_BBPLL_FORCE_PD_S 10 +#define RTC_CNTL_BBPLL_I2C_FORCE_PU (BIT(9)) +#define RTC_CNTL_BBPLL_I2C_FORCE_PU_S 9 +#define RTC_CNTL_BBPLL_I2C_FORCE_PD (BIT(8)) +#define RTC_CNTL_BBPLL_I2C_FORCE_PD_S 8 +#define RTC_CNTL_BB_I2C_FORCE_PU (BIT(7)) +#define RTC_CNTL_BB_I2C_FORCE_PU_S 7 +#define RTC_CNTL_BB_I2C_FORCE_PD (BIT(6)) +#define RTC_CNTL_BB_I2C_FORCE_PD_S 6 +#define RTC_CNTL_SW_PROCPU_RST (BIT(5)) +#define RTC_CNTL_SW_PROCPU_RST_S 5 +#define RTC_CNTL_SW_APPCPU_RST (BIT(4)) +#define RTC_CNTL_SW_APPCPU_RST_S 4 +#define RTC_CNTL_SW_STALL_PROCPU_C0 0x00000003 +#define RTC_CNTL_SW_STALL_PROCPU_C0_S 2 +#define RTC_CNTL_SW_STALL_APPCPU_C0 0x00000003 +#define RTC_CNTL_SW_STALL_APPCPU_C0_S 0 + +#define RTC_SLP_TIMER0 (DR_REG_RTCCNTL_BASE + 0x4) +#define RTC_CNTL_SLP_VAL_LO 0xFFFFFFFF +#define RTC_CNTL_SLP_VAL_LO_S 0 + +#define RTC_SLP_TIMER1 (DR_REG_RTCCNTL_BASE + 0x8) +#define RTC_CNTL_RTC_MAIN_TIMER_ALARM_EN (BIT(16)) +#define RTC_CNTL_RTC_MAIN_TIMER_ALARM_EN_S 16 +#define RTC_CNTL_SLP_VAL_HI 0x0000FFFF +#define RTC_CNTL_SLP_VAL_HI_S 0 + +#define RTC_TIME_UPDATE (DR_REG_RTCCNTL_BASE + 0xc) +#define RTC_CNTL_RTC_TIME_UPDATE (BIT(31)) +#define RTC_CNTL_RTC_TIME_UPDATE_S 31 +#define RTC_CNTL_RTC_TIME_VALID (BIT(30)) +#define RTC_CNTL_RTC_TIME_VALID_S 30 + +#define RTC_TIME0 (DR_REG_RTCCNTL_BASE + 0x10) +#define RTC_CNTL_RTC_TIME_LO 0xFFFFFFFF +#define RTC_CNTL_RTC_TIME_LO_S 0 + +#define RTC_TIME1 (DR_REG_RTCCNTL_BASE + 0x14) +#define RTC_CNTL_RTC_TIME_HI 0x0000FFFF +#define RTC_CNTL_RTC_TIME_HI_S 0 + +#define RTC_STATE0 (DR_REG_RTCCNTL_BASE + 0x18) +#define RTC_CNTL_SLEEP_EN (BIT(31)) +#define RTC_CNTL_SLEEP_EN_S 31 +#define RTC_CNTL_SLP_REJECT (BIT(30)) +#define RTC_CNTL_SLP_REJECT_S 30 +#define RTC_CNTL_SLP_WAKEUP (BIT(29)) +#define RTC_CNTL_SLP_WAKEUP_S 29 +#define RTC_CNTL_SDIO_ACTIVE_IND (BIT(28)) +#define RTC_CNTL_SDIO_ACTIVE_IND_S 28 +#define RTC_CNTL_SAR_SLP_TIMER_EN (BIT(24)) +#define RTC_CNTL_SAR_SLP_TIMER_EN_S 24 +#define RTC_CNTL_TOUCH_SLP_TIMER_EN (BIT(23)) +#define RTC_CNTL_TOUCH_SLP_TIMER_EN_S 23 +#define RTC_CNTL_APB2RTC_BRIDGE_SEL (BIT(22)) +#define RTC_CNTL_APB2RTC_BRIDGE_SEL_S 22 +#define RTC_CNTL_SAR_WAKEUP_FORCE_EN (BIT(21)) +#define RTC_CNTL_SAR_WAKEUP_FORCE_EN_S 21 +#define RTC_CNTL_TOUCH_WAKEUP_FORCE_EN (BIT(20)) +#define RTC_CNTL_TOUCH_WAKEUP_FORCE_EN_S 20 + +#define RTC_TIMER1 (DR_REG_RTCCNTL_BASE + 0x1c) +#define RTC_CNTL_PLL_BUF_WAIT 0x000000FF +#define RTC_CNTL_PLL_BUF_WAIT_S 24 +#define RTC_CNTL_XTL_BUF_WAIT 0x000003FF +#define RTC_CNTL_XTL_BUF_WAIT_S 14 +#define RTC_CNTL_CK12M_WAIT 0x000000FF +#define RTC_CNTL_CK12M_WAIT_S 6 +#define RTC_CNTL_CPU_STALL_WAIT 0x0000001F +#define RTC_CNTL_CPU_STALL_WAIT_S 1 +#define RTC_CNTL_CPU_STALL_EN (BIT(0)) +#define RTC_CNTL_CPU_STALL_EN_S 0 + +#define RTC_TIMER2 (DR_REG_RTCCNTL_BASE + 0x20) +#define RTC_CNTL_MIN_TIME_CK12M_OFF 0x000000FF +#define RTC_CNTL_MIN_TIME_CK12M_OFF_S 24 +#define RTC_CNTL_SAR_TOUCH_START_WAIT 0x000001FF +#define RTC_CNTL_SAR_TOUCH_START_WAIT_S 15 + +#define RTC_TIMER3 (DR_REG_RTCCNTL_BASE + 0x24) +#define RTC_CNTL_ROM_RAM_POWERUP_TIMER 0x0000007F +#define RTC_CNTL_ROM_RAM_POWERUP_TIMER_S 25 +#define RTC_CNTL_ROM_RAM_WAIT_TIMER 0x000001FF +#define RTC_CNTL_ROM_RAM_WAIT_TIMER_S 16 +#define RTC_CNTL_WIFI_POWERUP_TIMER 0x0000007F +#define RTC_CNTL_WIFI_POWERUP_TIMER_S 9 +#define RTC_CNTL_WIFI_WAIT_TIMER 0x000001FF +#define RTC_CNTL_WIFI_WAIT_TIMER_S 0 + +#define RTC_TIMER4 (DR_REG_RTCCNTL_BASE + 0x28) +#define RTC_CNTL_DG_WRAP_POWERUP_TIMER 0x0000007F +#define RTC_CNTL_DG_WRAP_POWERUP_TIMER_S 25 +#define RTC_CNTL_DG_WRAP_WAIT_TIMER 0x000001FF +#define RTC_CNTL_DG_WRAP_WAIT_TIMER_S 16 +#define RTC_CNTL_RTC_POWERUP_TIMER 0x0000007F +#define RTC_CNTL_RTC_POWERUP_TIMER_S 9 +#define RTC_CNTL_RTC_WAIT_TIMER 0x000001FF +#define RTC_CNTL_RTC_WAIT_TIMER_S 0 + +#define RTC_TIMER5 (DR_REG_RTCCNTL_BASE + 0x2c) +#define RTC_CNTL_RTCMEM_POWERUP_TIMER 0x0000007F +#define RTC_CNTL_RTCMEM_POWERUP_TIMER_S 25 +#define RTC_CNTL_RTCMEM_WAIT_TIMER 0x000001FF +#define RTC_CNTL_RTCMEM_WAIT_TIMER_S 16 +#define RTC_CNTL_MIN_SLP_VAL 0x000000FF +#define RTC_CNTL_MIN_SLP_VAL_S 8 +#define RTC_CNTL_SAR_SUBTIMER_PREDIV 0x000000FF +#define RTC_CNTL_SAR_SUBTIMER_PREDIV_S 0 + +#define RTC_ANA_CONF (DR_REG_RTCCNTL_BASE + 0x30) +#define RTC_CNTL_PLL_I2C_PU (BIT(31)) +#define RTC_CNTL_PLL_I2C_PU_S 31 +#define RTC_CNTL_CKGEN_I2C_PU (BIT(30)) +#define RTC_CNTL_CKGEN_I2C_PU_S 30 +#define RTC_CNTL_RFRX_PBUS_PU (BIT(28)) +#define RTC_CNTL_RFRX_PBUS_PU_S 28 +#define RTC_CNTL_TXRF_I2C_PU (BIT(27)) +#define RTC_CNTL_TXRF_I2C_PU_S 27 +#define RTC_CNTL_PVTMON_PU (BIT(26)) +#define RTC_CNTL_PVTMON_PU_S 26 +#define RTC_CNTL_BBPLL_CAL_SLP_START (BIT(25)) +#define RTC_CNTL_BBPLL_CAL_SLP_START_S 25 +#define RTC_CNTL_PLLA_FORCE_PU (BIT(24)) +#define RTC_CNTL_PLLA_FORCE_PU_S 24 +#define RTC_CNTL_PLLA_FORCE_PD (BIT(23)) +#define RTC_CNTL_PLLA_FORCE_PD_S 23 + +#define RTC_RESET_STATE (DR_REG_RTCCNTL_BASE + 0x34) +#define RTC_CNTL_PROCPU_STAT_VECTOR_SEL (BIT(13)) +#define RTC_CNTL_PROCPU_STAT_VECTOR_SEL_S 13 +#define RTC_CNTL_APPCPU_STAT_VECTOR_SEL (BIT(12)) +#define RTC_CNTL_APPCPU_STAT_VECTOR_SEL_S 12 +#define RTC_CNTL_RESET_CAUSE_APPCPU 0x0000003F +#define RTC_CNTL_RESET_CAUSE_APPCPU_S 6 +#define RTC_CNTL_RESET_CAUSE_PROCPU 0x0000003F +#define RTC_CNTL_RESET_CAUSE_PROCPU_S 0 + +#define RTC_WAKEUP_STATE (DR_REG_RTCCNTL_BASE + 0x38) +#define RTC_CNTL_GPIO_WAKEUP_FILTER (BIT(22)) +#define RTC_CNTL_GPIO_WAKEUP_FILTER_S 22 +#define RTC_CNTL_RTC_WAKEUP_ENA 0x000007FF +#define RTC_CNTL_RTC_WAKEUP_ENA_S 11 +#define RTC_CNTL_WAKEUP_CAUSE 0x000007FF +#define RTC_CNTL_WAKEUP_CAUSE_S 0 + +#define INT_ENA_RTC (DR_REG_RTCCNTL_BASE + 0x3c) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_ENA (BIT(8)) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_ENA_S 8 +#define RTC_CNTL_RTC_BROWN_OUT_INT_ENA (BIT(7)) +#define RTC_CNTL_RTC_BROWN_OUT_INT_ENA_S 7 +#define RTC_CNTL_RTC_TOUCH_INT_ENA (BIT(6)) +#define RTC_CNTL_RTC_TOUCH_INT_ENA_S 6 +#define RTC_CNTL_RTC_SAR_INT_ENA (BIT(5)) +#define RTC_CNTL_RTC_SAR_INT_ENA_S 5 +#define RTC_CNTL_RTC_TIME_VALID_INT_ENA (BIT(4)) +#define RTC_CNTL_RTC_TIME_VALID_INT_ENA_S 4 +#define RTC_CNTL_RTC_WDT_INT_ENA (BIT(3)) +#define RTC_CNTL_RTC_WDT_INT_ENA_S 3 +#define RTC_CNTL_SDIO_IDLE_INT_ENA (BIT(2)) +#define RTC_CNTL_SDIO_IDLE_INT_ENA_S 2 +#define RTC_CNTL_SLP_REJECT_INT_ENA (BIT(1)) +#define RTC_CNTL_SLP_REJECT_INT_ENA_S 1 +#define RTC_CNTL_SLP_WAKEUP_INT_ENA (BIT(0)) +#define RTC_CNTL_SLP_WAKEUP_INT_ENA_S 0 + +#define INT_RAW_RTC (DR_REG_RTCCNTL_BASE + 0x40) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_RAW (BIT(8)) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_RAW_S 8 +#define RTC_CNTL_RTC_BROWN_OUT_INT_RAW (BIT(7)) +#define RTC_CNTL_RTC_BROWN_OUT_INT_RAW_S 7 +#define RTC_CNTL_RTC_TOUCH_INT_RAW (BIT(6)) +#define RTC_CNTL_RTC_TOUCH_INT_RAW_S 6 +#define RTC_CNTL_RTC_SAR_INT_RAW (BIT(5)) +#define RTC_CNTL_RTC_SAR_INT_RAW_S 5 +#define RTC_CNTL_RTC_TIME_VALID_INT_RAW (BIT(4)) +#define RTC_CNTL_RTC_TIME_VALID_INT_RAW_S 4 +#define RTC_CNTL_RTC_WDT_INT_RAW (BIT(3)) +#define RTC_CNTL_RTC_WDT_INT_RAW_S 3 +#define RTC_CNTL_SDIO_IDLE_INT_RAW (BIT(2)) +#define RTC_CNTL_SDIO_IDLE_INT_RAW_S 2 +#define RTC_CNTL_SLP_REJECT_INT_RAW (BIT(1)) +#define RTC_CNTL_SLP_REJECT_INT_RAW_S 1 +#define RTC_CNTL_SLP_WAKEUP_INT_RAW (BIT(0)) +#define RTC_CNTL_SLP_WAKEUP_INT_RAW_S 0 + +#define INT_ST_RTC (DR_REG_RTCCNTL_BASE + 0x44) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_ST (BIT(8)) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_ST_S 8 +#define RTC_CNTL_RTC_BROWN_OUT_INT_ST (BIT(7)) +#define RTC_CNTL_RTC_BROWN_OUT_INT_ST_S 7 +#define RTC_CNTL_RTC_TOUCH_INT_ST (BIT(6)) +#define RTC_CNTL_RTC_TOUCH_INT_ST_S 6 +#define RTC_CNTL_RTC_SAR_INT_ST (BIT(5)) +#define RTC_CNTL_RTC_SAR_INT_ST_S 5 +#define RTC_CNTL_RTC_TIME_VALID_INT_ST (BIT(4)) +#define RTC_CNTL_RTC_TIME_VALID_INT_ST_S 4 +#define RTC_CNTL_RTC_WDT_INT_ST (BIT(3)) +#define RTC_CNTL_RTC_WDT_INT_ST_S 3 +#define RTC_CNTL_SDIO_IDLE_INT_ST (BIT(2)) +#define RTC_CNTL_SDIO_IDLE_INT_ST_S 2 +#define RTC_CNTL_SLP_REJECT_INT_ST (BIT(1)) +#define RTC_CNTL_SLP_REJECT_INT_ST_S 1 +#define RTC_CNTL_SLP_WAKEUP_INT_ST (BIT(0)) +#define RTC_CNTL_SLP_WAKEUP_INT_ST_S 0 + +#define INT_CLR_RTC (DR_REG_RTCCNTL_BASE + 0x48) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_CLR (BIT(8)) +#define RTC_CNTL_RTC_MAIN_TIMER_INT_CLR_S 8 +#define RTC_CNTL_RTC_BROWN_OUT_INT_CLR (BIT(7)) +#define RTC_CNTL_RTC_BROWN_OUT_INT_CLR_S 7 +#define RTC_CNTL_RTC_TOUCH_INT_CLR (BIT(6)) +#define RTC_CNTL_RTC_TOUCH_INT_CLR_S 6 +#define RTC_CNTL_RTC_SAR_INT_CLR (BIT(5)) +#define RTC_CNTL_RTC_SAR_INT_CLR_S 5 +#define RTC_CNTL_RTC_TIME_VALID_INT_CLR (BIT(4)) +#define RTC_CNTL_RTC_TIME_VALID_INT_CLR_S 4 +#define RTC_CNTL_RTC_WDT_INT_CLR (BIT(3)) +#define RTC_CNTL_RTC_WDT_INT_CLR_S 3 +#define RTC_CNTL_SDIO_IDLE_INT_CLR (BIT(2)) +#define RTC_CNTL_SDIO_IDLE_INT_CLR_S 2 +#define RTC_CNTL_SLP_REJECT_INT_CLR (BIT(1)) +#define RTC_CNTL_SLP_REJECT_INT_CLR_S 1 +#define RTC_CNTL_SLP_WAKEUP_INT_CLR (BIT(0)) +#define RTC_CNTL_SLP_WAKEUP_INT_CLR_S 0 + +#define RTC_STORE0 (DR_REG_RTCCNTL_BASE + 0x4c) +#define RTC_CNTL_RTC_SCRATCH0 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH0_S 0 + +#define RTC_STORE1 (DR_REG_RTCCNTL_BASE + 0x50) +#define RTC_CNTL_RTC_SCRATCH1 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH1_S 0 + +#define RTC_STORE2 (DR_REG_RTCCNTL_BASE + 0x54) +#define RTC_CNTL_RTC_SCRATCH2 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH2_S 0 + +#define RTC_STORE3 (DR_REG_RTCCNTL_BASE + 0x58) +#define RTC_CNTL_RTC_SCRATCH3 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH3_S 0 + +#define RTC_EXT_XTL_CONF (DR_REG_RTCCNTL_BASE + 0x5c) +#define RTC_CNTL_XTL_EXT_CTR_EN (BIT(31)) +#define RTC_CNTL_XTL_EXT_CTR_EN_S 31 +#define RTC_CNTL_XTL_EXT_CTR_LV (BIT(30)) +#define RTC_CNTL_XTL_EXT_CTR_LV_S 30 + +#define RTC_EXT_WAKEUP_CONF (DR_REG_RTCCNTL_BASE + 0x60) +#define RTC_CNTL_EXT_WAKEUP1_LV (BIT(31)) +#define RTC_CNTL_EXT_WAKEUP1_LV_S 31 +#define RTC_CNTL_EXT_WAKEUP0_LV (BIT(30)) +#define RTC_CNTL_EXT_WAKEUP0_LV_S 30 + +#define RTC_SLP_REJECT_CONF (DR_REG_RTCCNTL_BASE + 0x64) +#define RTC_CNTL_REJECT_CAUSE 0x0000000F +#define RTC_CNTL_REJECT_CAUSE_S 28 +#define RTC_CNTL_DEEP_SLP_REJECT_EN (BIT(27)) +#define RTC_CNTL_DEEP_SLP_REJECT_EN_S 27 +#define RTC_CNTL_LIGHT_SLP_REJECT_EN (BIT(26)) +#define RTC_CNTL_LIGHT_SLP_REJECT_EN_S 26 +#define RTC_CNTL_SDIO_REJECT_EN (BIT(25)) +#define RTC_CNTL_SDIO_REJECT_EN_S 25 +#define RTC_CNTL_GPIO_REJECT_EN (BIT(24)) +#define RTC_CNTL_GPIO_REJECT_EN_S 24 + +#define RTC_CPU_PERIOD_CONF (DR_REG_RTCCNTL_BASE + 0x68) +#define RTC_CNTL_RTC_CPUPERIOD_SEL 0x00000003 +#define RTC_CNTL_RTC_CPUPERIOD_SEL_S 30 +#define RTC_CNTL_RTC_CPUSEL_CONF (BIT(29)) +#define RTC_CNTL_RTC_CPUSEL_CONF_S 29 + +#define RTC_SDIO_ACT_CONF (DR_REG_RTCCNTL_BASE + 0x6c) +#define RTC_CNTL_SDIO_ACT_DNUM 0x000003FF +#define RTC_CNTL_SDIO_ACT_DNUM_S 22 + +#define RTC_CLK_CONF (DR_REG_RTCCNTL_BASE + 0x70) +#define RTC_CNTL_ANA_CLK_RTC_SEL 0x00000003 +#define RTC_CNTL_ANA_CLK_RTC_SEL_S 30 +#define RTC_CNTL_FAST_CLK_RTC_SEL (BIT(29)) +#define RTC_CNTL_FAST_CLK_RTC_SEL_S 29 +#define RTC_CNTL_SOC_CLK_SEL 0x00000003 +#define RTC_CNTL_SOC_CLK_SEL_S 27 +#define RTC_CNTL_CK12M_FORCE_PU (BIT(26)) +#define RTC_CNTL_CK12M_FORCE_PU_S 26 +#define RTC_CNTL_CK12M_FORCE_PD (BIT(25)) +#define RTC_CNTL_CK12M_FORCE_PD_S 25 +#define RTC_CNTL_CK12M_DFREQ 0x000000FF +#define RTC_CNTL_CK12M_DFREQ_S 17 +#define RTC_CNTL_CK12M_FORCE_NOGATING (BIT(16)) +#define RTC_CNTL_CK12M_FORCE_NOGATING_S 16 +#define RTC_CNTL_XTAL_FORCE_NOGATING (BIT(15)) +#define RTC_CNTL_XTAL_FORCE_NOGATING_S 15 +#define RTC_CNTL_CK12M_DIV_SEL 0x00000007 +#define RTC_CNTL_CK12M_DIV_SEL_S 12 +#define RTC_CNTL_CK12M_DFREQ_FORCE (BIT(11)) +#define RTC_CNTL_CK12M_DFREQ_FORCE_S 11 +#define RTC_CNTL_DIG_CLK12M_EN (BIT(10)) +#define RTC_CNTL_DIG_CLK12M_EN_S 10 +#define RTC_CNTL_DIG_CLK12M_D256_EN (BIT(9)) +#define RTC_CNTL_DIG_CLK12M_D256_EN_S 9 +#define RTC_CNTL_DIG_XTAL32K_EN (BIT(8)) +#define RTC_CNTL_DIG_XTAL32K_EN_S 8 +#define RTC_CNTL_ENB_CK12M_DIV (BIT(7)) +#define RTC_CNTL_ENB_CK12M_DIV_S 7 +#define RTC_CNTL_ENB_CK12M (BIT(6)) +#define RTC_CNTL_ENB_CK12M_S 6 +#define RTC_CNTL_CK12M_DIV 0x00000003 +#define RTC_CNTL_CK12M_DIV_S 4 + +#define RTC_SDIO_CONF (DR_REG_RTCCNTL_BASE + 0x74) +#define RTC_CNTL_XPD_SDIO_REG (BIT(31)) +#define RTC_CNTL_XPD_SDIO_REG_S 31 +#define RTC_CNTL_DREFH_SDIO 0x00000003 +#define RTC_CNTL_DREFH_SDIO_S 29 +#define RTC_CNTL_DREFM_SDIO 0x00000003 +#define RTC_CNTL_DREFM_SDIO_S 27 +#define RTC_CNTL_DREFL_SDIO 0x00000003 +#define RTC_CNTL_DREFL_SDIO_S 25 +#define RTC_CNTL_REG1P8_READY (BIT(24)) +#define RTC_CNTL_REG1P8_READY_S 24 +#define RTC_CNTL_SDIO_TIEH (BIT(23)) +#define RTC_CNTL_SDIO_TIEH_S 23 +#define RTC_CNTL_SDIO_FORCE (BIT(22)) +#define RTC_CNTL_SDIO_FORCE_S 22 +#define RTC_CNTL_SDIO_REG_PD_EN (BIT(21)) +#define RTC_CNTL_SDIO_REG_PD_EN_S 21 + +#define RTC_BIAS_CONF (DR_REG_RTCCNTL_BASE + 0x78) +#define RTC_CNTL_RST_BIAS_I2C (BIT(31)) +#define RTC_CNTL_RST_BIAS_I2C_S 31 +#define RTC_CNTL_DEC_HEARTBEAT_WIDTH (BIT(30)) +#define RTC_CNTL_DEC_HEARTBEAT_WIDTH_S 30 +#define RTC_CNTL_INC_HEARTBEAT_PERIOD (BIT(29)) +#define RTC_CNTL_INC_HEARTBEAT_PERIOD_S 29 +#define RTC_CNTL_DEC_HEARTBEAT_PERIOD (BIT(28)) +#define RTC_CNTL_DEC_HEARTBEAT_PERIOD_S 28 +#define RTC_CNTL_INC_HEARTBEAT_REFRESH (BIT(27)) +#define RTC_CNTL_INC_HEARTBEAT_REFRESH_S 27 +#define RTC_CNTL_ENB_SCK_XTAL (BIT(26)) +#define RTC_CNTL_ENB_SCK_XTAL_S 26 +#define RTC_CNTL_DBG_ATTEN 0x00000003 +#define RTC_CNTL_DBG_ATTEN_S 24 + +#define RTC_REG (DR_REG_RTCCNTL_BASE + 0x7c) +#define RTC_CNTL_RTC_REG_FORCE_PU (BIT(31)) +#define RTC_CNTL_RTC_REG_FORCE_PU_S 31 +#define RTC_CNTL_RTC_REG_FORCE_PD (BIT(30)) +#define RTC_CNTL_RTC_REG_FORCE_PD_S 30 +#define RTC_CNTL_RTC_DBOOST_FORCE_PU (BIT(29)) +#define RTC_CNTL_RTC_DBOOST_FORCE_PU_S 29 +#define RTC_CNTL_RTC_DBOOST_FORCE_PD (BIT(28)) +#define RTC_CNTL_RTC_DBOOST_FORCE_PD_S 28 +#define RTC_CNTL_RTC_DBIAS_WAK 0x00000007 +#define RTC_CNTL_RTC_DBIAS_WAK_S 25 +#define RTC_CNTL_RTC_DBIAS_SLP 0x00000007 +#define RTC_CNTL_RTC_DBIAS_SLP_S 22 +#define RTC_CNTL_SCK_DCAP 0x000000FF +#define RTC_CNTL_SCK_DCAP_S 14 +#define RTC_CNTL_DIG_REG_DBIAS_WAK 0x00000007 +#define RTC_CNTL_DIG_REG_DBIAS_WAK_S 11 +#define RTC_CNTL_DIG_REG_DBIAS_SLP 0x00000007 +#define RTC_CNTL_DIG_REG_DBIAS_SLP_S 8 +#define RTC_CNTL_SCK_DCAP_FORCE (BIT(7)) +#define RTC_CNTL_SCK_DCAP_FORCE_S 7 + +#define RTC_PWC (DR_REG_RTCCNTL_BASE + 0x80) +#define RTC_CNTL_RTC_PD_EN (BIT(20)) +#define RTC_CNTL_RTC_PD_EN_S 20 +#define RTC_CNTL_RTC_FORCE_PU (BIT(19)) +#define RTC_CNTL_RTC_FORCE_PU_S 19 +#define RTC_CNTL_RTC_FORCE_PD (BIT(18)) +#define RTC_CNTL_RTC_FORCE_PD_S 18 +#define RTC_CNTL_RTC_SLOWMEM_PD_EN (BIT(17)) +#define RTC_CNTL_RTC_SLOWMEM_PD_EN_S 17 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_PU (BIT(16)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_PU_S 16 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_PD (BIT(15)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_PD_S 15 +#define RTC_CNTL_RTC_FASTMEM_PD_EN (BIT(14)) +#define RTC_CNTL_RTC_FASTMEM_PD_EN_S 14 +#define RTC_CNTL_RTC_FASTMEM_FORCE_PU (BIT(13)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_PU_S 13 +#define RTC_CNTL_RTC_FASTMEM_FORCE_PD (BIT(12)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_PD_S 12 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_LPU (BIT(11)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_LPU_S 11 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_LPD (BIT(10)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_LPD_S 10 +#define RTC_CNTL_RTC_SLOWMEM_FOLW_CPU (BIT(9)) +#define RTC_CNTL_RTC_SLOWMEM_FOLW_CPU_S 9 +#define RTC_CNTL_RTC_FASTMEM_FORCE_LPU (BIT(8)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_LPU_S 8 +#define RTC_CNTL_RTC_FASTMEM_FORCE_LPD (BIT(7)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_LPD_S 7 +#define RTC_CNTL_RTC_FASTMEM_FOLW_CPU (BIT(6)) +#define RTC_CNTL_RTC_FASTMEM_FOLW_CPU_S 6 +#define RTC_CNTL_RTC_FORCE_NOISO (BIT(5)) +#define RTC_CNTL_RTC_FORCE_NOISO_S 5 +#define RTC_CNTL_RTC_FORCE_ISO (BIT(4)) +#define RTC_CNTL_RTC_FORCE_ISO_S 4 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_ISO (BIT(3)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_ISO_S 3 +#define RTC_CNTL_RTC_SLOWMEM_FORCE_NOISO (BIT(2)) +#define RTC_CNTL_RTC_SLOWMEM_FORCE_NOISO_S 2 +#define RTC_CNTL_RTC_FASTMEM_FORCE_ISO (BIT(1)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_ISO_S 1 +#define RTC_CNTL_RTC_FASTMEM_FORCE_NOISO (BIT(0)) +#define RTC_CNTL_RTC_FASTMEM_FORCE_NOISO_S 0 + +#define DIG_PWC (DR_REG_RTCCNTL_BASE + 0x84) +#define RTC_CNTL_DG_WRAP_PD_EN (BIT(31)) +#define RTC_CNTL_DG_WRAP_PD_EN_S 31 +#define RTC_CNTL_WIFI_PD_EN (BIT(30)) +#define RTC_CNTL_WIFI_PD_EN_S 30 +#define RTC_CNTL_INTER_RAM4_PD_EN (BIT(29)) +#define RTC_CNTL_INTER_RAM4_PD_EN_S 29 +#define RTC_CNTL_INTER_RAM3_PD_EN (BIT(28)) +#define RTC_CNTL_INTER_RAM3_PD_EN_S 28 +#define RTC_CNTL_INTER_RAM2_PD_EN (BIT(27)) +#define RTC_CNTL_INTER_RAM2_PD_EN_S 27 +#define RTC_CNTL_INTER_RAM1_PD_EN (BIT(26)) +#define RTC_CNTL_INTER_RAM1_PD_EN_S 26 +#define RTC_CNTL_INTER_RAM0_PD_EN (BIT(25)) +#define RTC_CNTL_INTER_RAM0_PD_EN_S 25 +#define RTC_CNTL_ROM0_PD_EN (BIT(24)) +#define RTC_CNTL_ROM0_PD_EN_S 24 +#define RTC_CNTL_DG_WRAP_FORCE_PU (BIT(20)) +#define RTC_CNTL_DG_WRAP_FORCE_PU_S 20 +#define RTC_CNTL_DG_WRAP_FORCE_PD (BIT(19)) +#define RTC_CNTL_DG_WRAP_FORCE_PD_S 19 +#define RTC_CNTL_WIFI_FORCE_PU (BIT(18)) +#define RTC_CNTL_WIFI_FORCE_PU_S 18 +#define RTC_CNTL_WIFI_FORCE_PD (BIT(17)) +#define RTC_CNTL_WIFI_FORCE_PD_S 17 +#define RTC_CNTL_INTER_RAM4_FORCE_PU (BIT(16)) +#define RTC_CNTL_INTER_RAM4_FORCE_PU_S 16 +#define RTC_CNTL_INTER_RAM4_FORCE_PD (BIT(15)) +#define RTC_CNTL_INTER_RAM4_FORCE_PD_S 15 +#define RTC_CNTL_INTER_RAM3_FORCE_PU (BIT(14)) +#define RTC_CNTL_INTER_RAM3_FORCE_PU_S 14 +#define RTC_CNTL_INTER_RAM3_FORCE_PD (BIT(13)) +#define RTC_CNTL_INTER_RAM3_FORCE_PD_S 13 +#define RTC_CNTL_INTER_RAM2_FORCE_PU (BIT(12)) +#define RTC_CNTL_INTER_RAM2_FORCE_PU_S 12 +#define RTC_CNTL_INTER_RAM2_FORCE_PD (BIT(11)) +#define RTC_CNTL_INTER_RAM2_FORCE_PD_S 11 +#define RTC_CNTL_INTER_RAM1_FORCE_PU (BIT(10)) +#define RTC_CNTL_INTER_RAM1_FORCE_PU_S 10 +#define RTC_CNTL_INTER_RAM1_FORCE_PD (BIT(9)) +#define RTC_CNTL_INTER_RAM1_FORCE_PD_S 9 +#define RTC_CNTL_INTER_RAM0_FORCE_PU (BIT(8)) +#define RTC_CNTL_INTER_RAM0_FORCE_PU_S 8 +#define RTC_CNTL_INTER_RAM0_FORCE_PD (BIT(7)) +#define RTC_CNTL_INTER_RAM0_FORCE_PD_S 7 +#define RTC_CNTL_ROM0_FORCE_PU (BIT(6)) +#define RTC_CNTL_ROM0_FORCE_PU_S 6 +#define RTC_CNTL_ROM0_FORCE_PD (BIT(5)) +#define RTC_CNTL_ROM0_FORCE_PD_S 5 +#define RTC_CNTL_LSLP_MEM_FORCE_PU (BIT(4)) +#define RTC_CNTL_LSLP_MEM_FORCE_PU_S 4 +#define RTC_CNTL_LSLP_MEM_FORCE_PD (BIT(3)) +#define RTC_CNTL_LSLP_MEM_FORCE_PD_S 3 + +#define DIG_ISO (DR_REG_RTCCNTL_BASE + 0x88) +#define RTC_CNTL_DG_WRAP_FORCE_NOISO (BIT(31)) +#define RTC_CNTL_DG_WRAP_FORCE_NOISO_S 31 +#define RTC_CNTL_DG_WRAP_FORCE_ISO (BIT(30)) +#define RTC_CNTL_DG_WRAP_FORCE_ISO_S 30 +#define RTC_CNTL_WIFI_FORCE_NOISO (BIT(29)) +#define RTC_CNTL_WIFI_FORCE_NOISO_S 29 +#define RTC_CNTL_WIFI_FORCE_ISO (BIT(28)) +#define RTC_CNTL_WIFI_FORCE_ISO_S 28 +#define RTC_CNTL_INTER_RAM4_FORCE_NOISO (BIT(27)) +#define RTC_CNTL_INTER_RAM4_FORCE_NOISO_S 27 +#define RTC_CNTL_INTER_RAM4_FORCE_ISO (BIT(26)) +#define RTC_CNTL_INTER_RAM4_FORCE_ISO_S 26 +#define RTC_CNTL_INTER_RAM3_FORCE_NOISO (BIT(25)) +#define RTC_CNTL_INTER_RAM3_FORCE_NOISO_S 25 +#define RTC_CNTL_INTER_RAM3_FORCE_ISO (BIT(24)) +#define RTC_CNTL_INTER_RAM3_FORCE_ISO_S 24 +#define RTC_CNTL_INTER_RAM2_FORCE_NOISO (BIT(23)) +#define RTC_CNTL_INTER_RAM2_FORCE_NOISO_S 23 +#define RTC_CNTL_INTER_RAM2_FORCE_ISO (BIT(22)) +#define RTC_CNTL_INTER_RAM2_FORCE_ISO_S 22 +#define RTC_CNTL_INTER_RAM1_FORCE_NOISO (BIT(21)) +#define RTC_CNTL_INTER_RAM1_FORCE_NOISO_S 21 +#define RTC_CNTL_INTER_RAM1_FORCE_ISO (BIT(20)) +#define RTC_CNTL_INTER_RAM1_FORCE_ISO_S 20 +#define RTC_CNTL_INTER_RAM0_FORCE_NOISO (BIT(19)) +#define RTC_CNTL_INTER_RAM0_FORCE_NOISO_S 19 +#define RTC_CNTL_INTER_RAM0_FORCE_ISO (BIT(18)) +#define RTC_CNTL_INTER_RAM0_FORCE_ISO_S 18 +#define RTC_CNTL_ROM0_FORCE_NOISO (BIT(17)) +#define RTC_CNTL_ROM0_FORCE_NOISO_S 17 +#define RTC_CNTL_ROM0_FORCE_ISO (BIT(16)) +#define RTC_CNTL_ROM0_FORCE_ISO_S 16 +#define RTC_CNTL_DG_PAD_FORCE_HOLD (BIT(15)) +#define RTC_CNTL_DG_PAD_FORCE_HOLD_S 15 +#define RTC_CNTL_DG_PAD_FORCE_UNHOLD (BIT(14)) +#define RTC_CNTL_DG_PAD_FORCE_UNHOLD_S 14 +#define RTC_CNTL_DG_PAD_FORCE_ISO (BIT(13)) +#define RTC_CNTL_DG_PAD_FORCE_ISO_S 13 +#define RTC_CNTL_DG_PAD_FORCE_NOISO (BIT(12)) +#define RTC_CNTL_DG_PAD_FORCE_NOISO_S 12 +#define RTC_CNTL_DG_PAD_AUTOHOLD_EN (BIT(11)) +#define RTC_CNTL_DG_PAD_AUTOHOLD_EN_S 11 +#define RTC_CNTL_CLR_DG_PAD_AUTOHOLD (BIT(10)) +#define RTC_CNTL_CLR_DG_PAD_AUTOHOLD_S 10 +#define RTC_CNTL_DG_PAD_AUTOHOLD (BIT(9)) +#define RTC_CNTL_DG_PAD_AUTOHOLD_S 9 +#define RTC_CNTL_DIG_ISO_FORCE_ON (BIT(8)) +#define RTC_CNTL_DIG_ISO_FORCE_ON_S 8 +#define RTC_CNTL_DIG_ISO_FORCE_OFF (BIT(7)) +#define RTC_CNTL_DIG_ISO_FORCE_OFF_S 7 + +#define RTC_WDTCONFIG0 (DR_REG_RTCCNTL_BASE + 0x8c) +#define RTC_CNTL_WDT_EN (BIT(31)) +#define RTC_CNTL_WDT_EN_S 31 +#define RTC_CNTL_WDT_STG0 0x00000007 +#define RTC_CNTL_WDT_STG0_S 28 +#define RTC_CNTL_WDT_STG1 0x00000007 +#define RTC_CNTL_WDT_STG1_S 25 +#define RTC_CNTL_WDT_STG2 0x00000007 +#define RTC_CNTL_WDT_STG2_S 22 +#define RTC_CNTL_WDT_STG3 0x00000007 +#define RTC_CNTL_WDT_STG3_S 19 +#define RTC_CNTL_WDT_EDGE_INT_EN (BIT(18)) +#define RTC_CNTL_WDT_EDGE_INT_EN_S 18 +#define RTC_CNTL_WDT_LEVEL_INT_EN (BIT(17)) +#define RTC_CNTL_WDT_LEVEL_INT_EN_S 17 +#define RTC_CNTL_WDT_CPU_RESET_LENGTH 0x00000007 +#define RTC_CNTL_WDT_CPU_RESET_LENGTH_S 14 +#define RTC_CNTL_WDT_SYS_RESET_LENGTH 0x00000007 +#define RTC_CNTL_WDT_SYS_RESET_LENGTH_S 11 +#define RTC_CNTL_WDT_FLASHBOOT_MOD_EN (BIT(10)) +#define RTC_CNTL_WDT_FLASHBOOT_MOD_EN_S 10 +#define RTC_CNTL_WDT_PROCPU_RESET_EN (BIT(9)) +#define RTC_CNTL_WDT_PROCPU_RESET_EN_S 9 +#define RTC_CNTL_WDT_APPCPU_RESET_EN (BIT(8)) +#define RTC_CNTL_WDT_APPCPU_RESET_EN_S 8 +#define RTC_CNTL_WDT_PAUSE_IN_SLP (BIT(7)) +#define RTC_CNTL_WDT_PAUSE_IN_SLP_S 7 + +#define RTC_WDTCONFIG1 (DR_REG_RTCCNTL_BASE + 0x90) +#define RTC_CNTL_WDT_STG0_HOLD 0xFFFFFFFF +#define RTC_CNTL_WDT_STG0_HOLD_S 0 + +#define RTC_WDTCONFIG2 (DR_REG_RTCCNTL_BASE + 0x94) +#define RTC_CNTL_WDT_STG1_HOLD 0xFFFFFFFF +#define RTC_CNTL_WDT_STG1_HOLD_S 0 + +#define RTC_WDTCONFIG3 (DR_REG_RTCCNTL_BASE + 0x98) +#define RTC_CNTL_WDT_STG2_HOLD 0xFFFFFFFF +#define RTC_CNTL_WDT_STG2_HOLD_S 0 + +#define RTC_WDTCONFIG4 (DR_REG_RTCCNTL_BASE + 0x9c) +#define RTC_CNTL_WDT_STG3_HOLD 0xFFFFFFFF +#define RTC_CNTL_WDT_STG3_HOLD_S 0 + +#define RTC_WDTFEED (DR_REG_RTCCNTL_BASE + 0xa0) +#define RTC_CNTL_RTC_WDT_FEED (BIT(31)) +#define RTC_CNTL_RTC_WDT_FEED_S 31 + +#define RTC_WDTWPROTECT (DR_REG_RTCCNTL_BASE + 0xa4) +#define RTC_CNTL_WDT_WKEY 0xFFFFFFFF +#define RTC_CNTL_WDT_WKEY_S 0 + +#define RTC_TEST_MUX (DR_REG_RTCCNTL_BASE + 0xa8) +#define RTC_CNTL_DTEST_RTC 0x00000003 +#define RTC_CNTL_DTEST_RTC_S 30 +#define RTC_CNTL_ENT_RTC (BIT(29)) +#define RTC_CNTL_ENT_RTC_S 29 + +#define RTC_SW_CPU_STALL (DR_REG_RTCCNTL_BASE + 0xac) +#define RTC_CNTL_SW_STALL_PROCPU_C1 0x0000003F +#define RTC_CNTL_SW_STALL_PROCPU_C1_S 26 +#define RTC_CNTL_SW_STALL_APPCPU_C1 0x0000003F +#define RTC_CNTL_SW_STALL_APPCPU_C1_S 20 + +#define RTC_STORE4 (DR_REG_RTCCNTL_BASE + 0xb0) +#define RTC_CNTL_RTC_SCRATCH4 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH4_S 0 + +#define RTC_STORE5 (DR_REG_RTCCNTL_BASE + 0xb4) +#define RTC_CNTL_RTC_SCRATCH5 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH5_S 0 + +#define RTC_STORE6 (DR_REG_RTCCNTL_BASE + 0xb8) +#define RTC_CNTL_RTC_SCRATCH6 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH6_S 0 + +#define RTC_STORE7 (DR_REG_RTCCNTL_BASE + 0xbc) +#define RTC_CNTL_RTC_SCRATCH7 0xFFFFFFFF +#define RTC_CNTL_RTC_SCRATCH7_S 0 + +#define RTC_DIAG0 (DR_REG_RTCCNTL_BASE + 0xc0) +#define RTC_CNTL_RTC_LOW_POWER_DIAG0 0xFFFFFFFF +#define RTC_CNTL_RTC_LOW_POWER_DIAG0_S 0 + +#define RTC_DIAG1 (DR_REG_RTCCNTL_BASE + 0xc4) +#define RTC_CNTL_RTC_LOW_POWER_DIAG1 0xFFFFFFFF +#define RTC_CNTL_RTC_LOW_POWER_DIAG1_S 0 + +#define RTC_HOLD_FORCE (DR_REG_RTCCNTL_BASE + 0xc8) +#define RTC_CNTL_X32N_HOLD_FORCE (BIT(17)) +#define RTC_CNTL_X32N_HOLD_FORCE_S 17 +#define RTC_CNTL_X32P_HOLD_FORCE (BIT(16)) +#define RTC_CNTL_X32P_HOLD_FORCE_S 16 +#define RTC_CNTL_TOUCH_PAD7_HOLD_FORCE (BIT(15)) +#define RTC_CNTL_TOUCH_PAD7_HOLD_FORCE_S 15 +#define RTC_CNTL_TOUCH_PAD6_HOLD_FORCE (BIT(14)) +#define RTC_CNTL_TOUCH_PAD6_HOLD_FORCE_S 14 +#define RTC_CNTL_TOUCH_PAD5_HOLD_FORCE (BIT(13)) +#define RTC_CNTL_TOUCH_PAD5_HOLD_FORCE_S 13 +#define RTC_CNTL_TOUCH_PAD4_HOLD_FORCE (BIT(12)) +#define RTC_CNTL_TOUCH_PAD4_HOLD_FORCE_S 12 +#define RTC_CNTL_TOUCH_PAD3_HOLD_FORCE (BIT(11)) +#define RTC_CNTL_TOUCH_PAD3_HOLD_FORCE_S 11 +#define RTC_CNTL_TOUCH_PAD2_HOLD_FORCE (BIT(10)) +#define RTC_CNTL_TOUCH_PAD2_HOLD_FORCE_S 10 +#define RTC_CNTL_TOUCH_PAD1_HOLD_FORCE (BIT(9)) +#define RTC_CNTL_TOUCH_PAD1_HOLD_FORCE_S 9 +#define RTC_CNTL_TOUCH_PAD0_HOLD_FORCE (BIT(8)) +#define RTC_CNTL_TOUCH_PAD0_HOLD_FORCE_S 8 +#define RTC_CNTL_SENSE4_HOLD_FORCE (BIT(7)) +#define RTC_CNTL_SENSE4_HOLD_FORCE_S 7 +#define RTC_CNTL_SENSE3_HOLD_FORCE (BIT(6)) +#define RTC_CNTL_SENSE3_HOLD_FORCE_S 6 +#define RTC_CNTL_SENSE2_HOLD_FORCE (BIT(5)) +#define RTC_CNTL_SENSE2_HOLD_FORCE_S 5 +#define RTC_CNTL_SENSE1_HOLD_FORCE (BIT(4)) +#define RTC_CNTL_SENSE1_HOLD_FORCE_S 4 +#define RTC_CNTL_PDAC2_HOLD_FORCE (BIT(3)) +#define RTC_CNTL_PDAC2_HOLD_FORCE_S 3 +#define RTC_CNTL_PDAC1_HOLD_FORCE (BIT(2)) +#define RTC_CNTL_PDAC1_HOLD_FORCE_S 2 +#define RTC_CNTL_ADC2_HOLD_FORCE (BIT(1)) +#define RTC_CNTL_ADC2_HOLD_FORCE_S 1 +#define RTC_CNTL_ADC1_HOLD_FORCE (BIT(0)) +#define RTC_CNTL_ADC1_HOLD_FORCE_S 0 + +#define RTC_EXT_WAKEUP1 (DR_REG_RTCCNTL_BASE + 0xcc) +#define RTC_CNTL_EXT_WAKEUP1_STATUS_CLR (BIT(18)) +#define RTC_CNTL_EXT_WAKEUP1_STATUS_CLR_S 18 +#define RTC_CNTL_EXT_WAKEUP1_SEL 0x0003FFFF +#define RTC_CNTL_EXT_WAKEUP1_SEL_S 0 + +#define RTC_EXT_WAKEUP1_STATUS (DR_REG_RTCCNTL_BASE + 0xd0) +#define RTC_CNTL_EXT_WAKEUP1_STATUS 0x0003FFFF +#define RTC_CNTL_EXT_WAKEUP1_STATUS_S 0 + +#define RTC_BROWN_OUT (DR_REG_RTCCNTL_BASE + 0xd4) +#define RTC_CNTL_RTC_BROWN_OUT_DET (BIT(31)) +#define RTC_CNTL_RTC_BROWN_OUT_DET_S 31 +#define RTC_CNTL_BROWN_OUT_ENA (BIT(30)) +#define RTC_CNTL_BROWN_OUT_ENA_S 30 +#define RTC_CNTL_DBROWN_OUT_THRES 0x00000007 +#define RTC_CNTL_DBROWN_OUT_THRES_S 27 +#define RTC_CNTL_BROWN_OUT_RST_ENA (BIT(26)) +#define RTC_CNTL_BROWN_OUT_RST_ENA_S 26 +#define RTC_CNTL_BROWN_OUT_RST_WAIT 0x000003FF +#define RTC_CNTL_BROWN_OUT_RST_WAIT_S 16 +#define RTC_CNTL_BROWN_OUT_PD_RF_ENA (BIT(15)) +#define RTC_CNTL_BROWN_OUT_PD_RF_ENA_S 15 +#define RTC_CNTL_BROWN_OUT_CLOSE_FLASH_ENA (BIT(14)) +#define RTC_CNTL_BROWN_OUT_CLOSE_FLASH_ENA_S 14 + +#define RTC_MEM_CONF (DR_REG_RTCCNTL_BASE + 0x40 * 4) +#define RTC_MEM_CRC_FINISH (BIT(31)) +#define RTC_MEM_CRC_FINISH_S (31) +#define RTC_MEM_CRC_LEN (0x7ff) +#define RTC_MEM_CRC_LEN_S (20) +#define RTC_MEM_CRC_ADDR (0x7ff) +#define RTC_MEM_CRC_ADDR_S (9) +#define RTC_MEM_CRC_START (BIT(8)) +#define RTC_MEM_CRC_START_S (8) +#define RTC_MEM_PID_CONF (0xff) +#define RTC_MEM_PID_CONF_S (0) + +#define RTC_MEM_CRC_RES (DR_REG_RTCCNTL_BASE + 0x41 * 4) + + +#define RTC_CNTL_DATE (DR_REG_RTCCNTL_BASE + 0x13c) +#define RTC_CNTL_RTC_CNTL_DATE 0x0FFFFFFF +#define RTC_CNTL_RTC_CNTL_DATE_S 0 +#define RTC_CNTL_RTC_CNTL_DATE_VERSION 0x1604280 + +#endif /* _SOC_RTC_CNTL_REG_H_ */ diff --git a/components/esp32/include/soc/rtc_io_reg.h b/components/esp32/include/soc/rtc_io_reg.h new file mode 100644 index 000000000..a60167c86 --- /dev/null +++ b/components/esp32/include/soc/rtc_io_reg.h @@ -0,0 +1,723 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_RTC_IO_REG_H_ +#define _SOC_RTC_IO_REG_H_ + +#include "soc.h" + +#define RTC_GPIO_OUT (DR_REG_RTCIO_BASE + 0x0) +#define RTC_IO_RTC_GPIO_OUT_DATA 0x0003FFFF +#define RTC_IO_RTC_GPIO_OUT_DATA_S 14 + +#define RTC_GPIO_OUT_W1TS (DR_REG_RTCIO_BASE + 0x4) +#define RTC_IO_RTC_GPIO_OUT_DATA_W1TS 0x0003FFFF +#define RTC_IO_RTC_GPIO_OUT_DATA_W1TS_S 14 + +#define RTC_GPIO_OUT_W1TC (DR_REG_RTCIO_BASE + 0x8) +#define RTC_IO_RTC_GPIO_OUT_DATA_W1TC 0x0003FFFF +#define RTC_IO_RTC_GPIO_OUT_DATA_W1TC_S 14 + +#define RTC_GPIO_ENABLE (DR_REG_RTCIO_BASE + 0xc) +#define RTC_IO_RTC_GPIO_ENABLE 0x0003FFFF +#define RTC_IO_RTC_GPIO_ENABLE_S 14 + +#define RTC_GPIO_ENABLE_W1TS (DR_REG_RTCIO_BASE + 0x10) +#define RTC_IO_RTC_GPIO_ENABLE_W1TS 0x0003FFFF +#define RTC_IO_RTC_GPIO_ENABLE_W1TS_S 14 + +#define RTC_GPIO_ENABLE_W1TC (DR_REG_RTCIO_BASE + 0x14) +#define RTC_IO_RTC_GPIO_ENABLE_W1TC 0x0003FFFF +#define RTC_IO_RTC_GPIO_ENABLE_W1TC_S 14 + +#define RTC_GPIO_STATUS (DR_REG_RTCIO_BASE + 0x18) +#define RTC_IO_RTC_GPIO_STATUS_INT 0x0003FFFF +#define RTC_IO_RTC_GPIO_STATUS_INT_S 14 + +#define RTC_GPIO_STATUS_W1TS (DR_REG_RTCIO_BASE + 0x1c) +#define RTC_IO_RTC_GPIO_STATUS_INT_W1TS 0x0003FFFF +#define RTC_IO_RTC_GPIO_STATUS_INT_W1TS_S 14 + +#define RTC_GPIO_STATUS_W1TC (DR_REG_RTCIO_BASE + 0x20) +#define RTC_IO_RTC_GPIO_STATUS_INT_W1TC 0x0003FFFF +#define RTC_IO_RTC_GPIO_STATUS_INT_W1TC_S 14 + +#define RTC_GPIO_IN (DR_REG_RTCIO_BASE + 0x24) +#define RTC_IO_RTC_GPIO_IN_NEXT 0x0003FFFF +#define RTC_IO_RTC_GPIO_IN_NEXT_S 14 + +#define RTC_GPIO_PIN0 (DR_REG_RTCIO_BASE + 0x28) +#define RTC_IO_RTC_GPIO_PIN0_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN0_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN0_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN0_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN0_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN0_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN1 (DR_REG_RTCIO_BASE + 0x2c) +#define RTC_IO_RTC_GPIO_PIN1_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN1_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN1_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN1_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN1_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN1_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN2 (DR_REG_RTCIO_BASE + 0x30) +#define RTC_IO_RTC_GPIO_PIN2_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN2_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN2_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN2_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN2_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN2_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN3 (DR_REG_RTCIO_BASE + 0x34) +#define RTC_IO_RTC_GPIO_PIN3_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN3_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN3_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN3_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN3_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN3_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN4 (DR_REG_RTCIO_BASE + 0x38) +#define RTC_IO_RTC_GPIO_PIN4_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN4_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN4_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN4_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN4_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN4_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN5 (DR_REG_RTCIO_BASE + 0x3c) +#define RTC_IO_RTC_GPIO_PIN5_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN5_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN5_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN5_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN5_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN5_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN6 (DR_REG_RTCIO_BASE + 0x40) +#define RTC_IO_RTC_GPIO_PIN6_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN6_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN6_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN6_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN6_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN6_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN7 (DR_REG_RTCIO_BASE + 0x44) +#define RTC_IO_RTC_GPIO_PIN7_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN7_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN7_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN7_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN7_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN7_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN8 (DR_REG_RTCIO_BASE + 0x48) +#define RTC_IO_RTC_GPIO_PIN8_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN8_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN8_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN8_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN8_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN8_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN9 (DR_REG_RTCIO_BASE + 0x4c) +#define RTC_IO_RTC_GPIO_PIN9_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN9_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN9_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN9_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN9_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN9_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN10 (DR_REG_RTCIO_BASE + 0x50) +#define RTC_IO_RTC_GPIO_PIN10_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN10_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN10_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN10_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN10_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN10_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN11 (DR_REG_RTCIO_BASE + 0x54) +#define RTC_IO_RTC_GPIO_PIN11_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN11_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN11_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN11_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN11_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN11_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN12 (DR_REG_RTCIO_BASE + 0x58) +#define RTC_IO_RTC_GPIO_PIN12_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN12_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN12_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN12_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN12_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN12_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN13 (DR_REG_RTCIO_BASE + 0x5c) +#define RTC_IO_RTC_GPIO_PIN13_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN13_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN13_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN13_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN13_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN13_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN14 (DR_REG_RTCIO_BASE + 0x60) +#define RTC_IO_RTC_GPIO_PIN14_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN14_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN14_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN14_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN14_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN14_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN15 (DR_REG_RTCIO_BASE + 0x64) +#define RTC_IO_RTC_GPIO_PIN15_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN15_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN15_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN15_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN15_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN15_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN16 (DR_REG_RTCIO_BASE + 0x68) +#define RTC_IO_RTC_GPIO_PIN16_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN16_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN16_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN16_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN16_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN16_PAD_DRIVER_S 2 + +#define RTC_GPIO_PIN17 (DR_REG_RTCIO_BASE + 0x6c) +#define RTC_IO_RTC_GPIO_PIN17_WAKEUP_ENABLE (BIT(10)) +#define RTC_IO_RTC_GPIO_PIN17_WAKEUP_ENABLE_S 10 +#define RTC_IO_RTC_GPIO_PIN17_INT_TYPE 0x00000007 +#define RTC_IO_RTC_GPIO_PIN17_INT_TYPE_S 7 +#define RTC_IO_RTC_GPIO_PIN17_PAD_DRIVER (BIT(2)) +#define RTC_IO_RTC_GPIO_PIN17_PAD_DRIVER_S 2 + +#define RTC_DEBUG_SEL (DR_REG_RTCIO_BASE + 0x70) +#define RTC_IO_RTC_DEBUG_12M_NO_GATING (BIT(25)) +#define RTC_IO_RTC_DEBUG_12M_NO_GATING_S 25 +#define RTC_IO_RTC_DEBUG_SEL4 0x0000001F +#define RTC_IO_RTC_DEBUG_SEL4_S 20 +#define RTC_IO_RTC_DEBUG_SEL3 0x0000001F +#define RTC_IO_RTC_DEBUG_SEL3_S 15 +#define RTC_IO_RTC_DEBUG_SEL2 0x0000001F +#define RTC_IO_RTC_DEBUG_SEL2_S 10 +#define RTC_IO_RTC_DEBUG_SEL1 0x0000001F +#define RTC_IO_RTC_DEBUG_SEL1_S 5 +#define RTC_IO_RTC_DEBUG_SEL0 0x0000001F +#define RTC_IO_RTC_DEBUG_SEL0_S 0 + +#define DIG_PAD_HOLD (DR_REG_RTCIO_BASE + 0x74) +#define RTC_IO_DIG_PAD_HOLD 0xFFFFFFFF +#define RTC_IO_DIG_PAD_HOLD_S 0 + +#define HALL_SENS (DR_REG_RTCIO_BASE + 0x78) +#define RTC_IO_XPD_HALL (BIT(31)) +#define RTC_IO_XPD_HALL_S 31 +#define RTC_IO_HALL_PHASE (BIT(30)) +#define RTC_IO_HALL_PHASE_S 30 + +#define SENSOR_PADS (DR_REG_RTCIO_BASE + 0x7c) +#define RTC_IO_SENSE1_HOLD (BIT(31)) +#define RTC_IO_SENSE1_HOLD_S 31 +#define RTC_IO_SENSE2_HOLD (BIT(30)) +#define RTC_IO_SENSE2_HOLD_S 30 +#define RTC_IO_SENSE3_HOLD (BIT(29)) +#define RTC_IO_SENSE3_HOLD_S 29 +#define RTC_IO_SENSE4_HOLD (BIT(28)) +#define RTC_IO_SENSE4_HOLD_S 28 +#define RTC_IO_SENSE1_MUX_SEL (BIT(27)) +#define RTC_IO_SENSE1_MUX_SEL_S 27 +#define RTC_IO_SENSE2_MUX_SEL (BIT(26)) +#define RTC_IO_SENSE2_MUX_SEL_S 26 +#define RTC_IO_SENSE3_MUX_SEL (BIT(25)) +#define RTC_IO_SENSE3_MUX_SEL_S 25 +#define RTC_IO_SENSE4_MUX_SEL (BIT(24)) +#define RTC_IO_SENSE4_MUX_SEL_S 24 +#define RTC_IO_SENSE1_FUN_SEL 0x00000003 +#define RTC_IO_SENSE1_FUN_SEL_S 22 +#define RTC_IO_SENSE1_SLP_SEL (BIT(21)) +#define RTC_IO_SENSE1_SLP_SEL_S 21 +#define RTC_IO_SENSE1_SLP_IE (BIT(20)) +#define RTC_IO_SENSE1_SLP_IE_S 20 +#define RTC_IO_SENSE1_FUN_IE (BIT(19)) +#define RTC_IO_SENSE1_FUN_IE_S 19 +#define RTC_IO_SENSE2_FUN_SEL 0x00000003 +#define RTC_IO_SENSE2_FUN_SEL_S 17 +#define RTC_IO_SENSE2_SLP_SEL (BIT(16)) +#define RTC_IO_SENSE2_SLP_SEL_S 16 +#define RTC_IO_SENSE2_SLP_IE (BIT(15)) +#define RTC_IO_SENSE2_SLP_IE_S 15 +#define RTC_IO_SENSE2_FUN_IE (BIT(14)) +#define RTC_IO_SENSE2_FUN_IE_S 14 +#define RTC_IO_SENSE3_FUN_SEL 0x00000003 +#define RTC_IO_SENSE3_FUN_SEL_S 12 +#define RTC_IO_SENSE3_SLP_SEL (BIT(11)) +#define RTC_IO_SENSE3_SLP_SEL_S 11 +#define RTC_IO_SENSE3_SLP_IE (BIT(10)) +#define RTC_IO_SENSE3_SLP_IE_S 10 +#define RTC_IO_SENSE3_FUN_IE (BIT(9)) +#define RTC_IO_SENSE3_FUN_IE_S 9 +#define RTC_IO_SENSE4_FUN_SEL 0x00000003 +#define RTC_IO_SENSE4_FUN_SEL_S 7 +#define RTC_IO_SENSE4_SLP_SEL (BIT(6)) +#define RTC_IO_SENSE4_SLP_SEL_S 6 +#define RTC_IO_SENSE4_SLP_IE (BIT(5)) +#define RTC_IO_SENSE4_SLP_IE_S 5 +#define RTC_IO_SENSE4_FUN_IE (BIT(4)) +#define RTC_IO_SENSE4_FUN_IE_S 4 + +#define ADC_PAD (DR_REG_RTCIO_BASE + 0x80) +#define RTC_IO_ADC1_HOLD (BIT(31)) +#define RTC_IO_ADC1_HOLD_S 31 +#define RTC_IO_ADC2_HOLD (BIT(30)) +#define RTC_IO_ADC2_HOLD_S 30 +#define RTC_IO_ADC1_MUX_SEL (BIT(29)) +#define RTC_IO_ADC1_MUX_SEL_S 29 +#define RTC_IO_ADC2_MUX_SEL (BIT(28)) +#define RTC_IO_ADC2_MUX_SEL_S 28 +#define RTC_IO_ADC1_FUN_SEL 0x00000003 +#define RTC_IO_ADC1_FUN_SEL_S 26 +#define RTC_IO_ADC1_SLP_SEL (BIT(25)) +#define RTC_IO_ADC1_SLP_SEL_S 25 +#define RTC_IO_ADC1_SLP_IE (BIT(24)) +#define RTC_IO_ADC1_SLP_IE_S 24 +#define RTC_IO_ADC1_FUN_IE (BIT(23)) +#define RTC_IO_ADC1_FUN_IE_S 23 +#define RTC_IO_ADC2_FUN_SEL 0x00000003 +#define RTC_IO_ADC2_FUN_SEL_S 21 +#define RTC_IO_ADC2_SLP_SEL (BIT(20)) +#define RTC_IO_ADC2_SLP_SEL_S 20 +#define RTC_IO_ADC2_SLP_IE (BIT(19)) +#define RTC_IO_ADC2_SLP_IE_S 19 +#define RTC_IO_ADC2_FUN_IE (BIT(18)) +#define RTC_IO_ADC2_FUN_IE_S 18 + +#define PAD_DAC1 (DR_REG_RTCIO_BASE + 0x84) +#define RTC_IO_PDAC1_DRV 0x00000003 +#define RTC_IO_PDAC1_DRV_S 30 +#define RTC_IO_PDAC1_HOLD (BIT(29)) +#define RTC_IO_PDAC1_HOLD_S 29 +#define RTC_IO_PDAC1_RDE (BIT(28)) +#define RTC_IO_PDAC1_RDE_S 28 +#define RTC_IO_PDAC1_RUE (BIT(27)) +#define RTC_IO_PDAC1_RUE_S 27 +#define RTC_IO_PDAC1_DAC 0x000000FF +#define RTC_IO_PDAC1_DAC_S 19 +#define RTC_IO_PDAC1_XPD_DAC (BIT(18)) +#define RTC_IO_PDAC1_XPD_DAC_S 18 +#define RTC_IO_PDAC1_MUX_SEL (BIT(17)) +#define RTC_IO_PDAC1_MUX_SEL_S 17 +#define RTC_IO_PDAC1_FUN_SEL 0x00000003 +#define RTC_IO_PDAC1_FUN_SEL_S 15 +#define RTC_IO_PDAC1_SLP_SEL (BIT(14)) +#define RTC_IO_PDAC1_SLP_SEL_S 14 +#define RTC_IO_PDAC1_SLP_IE (BIT(13)) +#define RTC_IO_PDAC1_SLP_IE_S 13 +#define RTC_IO_PDAC1_SLP_OE (BIT(12)) +#define RTC_IO_PDAC1_SLP_OE_S 12 +#define RTC_IO_PDAC1_FUN_IE (BIT(11)) +#define RTC_IO_PDAC1_FUN_IE_S 11 +#define RTC_IO_PDAC1_DAC_XPD_FORCE (BIT(10)) +#define RTC_IO_PDAC1_DAC_XPD_FORCE_S 10 + +#define PAD_DAC2 (DR_REG_RTCIO_BASE + 0x88) +#define RTC_IO_PDAC2_DRV 0x00000003 +#define RTC_IO_PDAC2_DRV_S 30 +#define RTC_IO_PDAC2_HOLD (BIT(29)) +#define RTC_IO_PDAC2_HOLD_S 29 +#define RTC_IO_PDAC2_RDE (BIT(28)) +#define RTC_IO_PDAC2_RDE_S 28 +#define RTC_IO_PDAC2_RUE (BIT(27)) +#define RTC_IO_PDAC2_RUE_S 27 +#define RTC_IO_PDAC2_DAC 0x000000FF +#define RTC_IO_PDAC2_DAC_S 19 +#define RTC_IO_PDAC2_XPD_DAC (BIT(18)) +#define RTC_IO_PDAC2_XPD_DAC_S 18 +#define RTC_IO_PDAC2_MUX_SEL (BIT(17)) +#define RTC_IO_PDAC2_MUX_SEL_S 17 +#define RTC_IO_PDAC2_FUN_SEL 0x00000003 +#define RTC_IO_PDAC2_FUN_SEL_S 15 +#define RTC_IO_PDAC2_SLP_SEL (BIT(14)) +#define RTC_IO_PDAC2_SLP_SEL_S 14 +#define RTC_IO_PDAC2_SLP_IE (BIT(13)) +#define RTC_IO_PDAC2_SLP_IE_S 13 +#define RTC_IO_PDAC2_SLP_OE (BIT(12)) +#define RTC_IO_PDAC2_SLP_OE_S 12 +#define RTC_IO_PDAC2_FUN_IE (BIT(11)) +#define RTC_IO_PDAC2_FUN_IE_S 11 +#define RTC_IO_PDAC2_DAC_XPD_FORCE (BIT(10)) +#define RTC_IO_PDAC2_DAC_XPD_FORCE_S 10 + +#define XTAL_32K_PAD (DR_REG_RTCIO_BASE + 0x8c) +#define RTC_IO_X32N_DRV 0x00000003 +#define RTC_IO_X32N_DRV_S 30 +#define RTC_IO_X32N_HOLD (BIT(29)) +#define RTC_IO_X32N_HOLD_S 29 +#define RTC_IO_X32N_RDE (BIT(28)) +#define RTC_IO_X32N_RDE_S 28 +#define RTC_IO_X32N_RUE (BIT(27)) +#define RTC_IO_X32N_RUE_S 27 +#define RTC_IO_X32P_DRV 0x00000003 +#define RTC_IO_X32P_DRV_S 25 +#define RTC_IO_X32P_HOLD (BIT(24)) +#define RTC_IO_X32P_HOLD_S 24 +#define RTC_IO_X32P_RDE (BIT(23)) +#define RTC_IO_X32P_RDE_S 23 +#define RTC_IO_X32P_RUE (BIT(22)) +#define RTC_IO_X32P_RUE_S 22 +#define RTC_IO_DAC_XTAL_32K 0x00000003 +#define RTC_IO_DAC_XTAL_32K_S 20 +#define RTC_IO_XPD_XTAL_32K (BIT(19)) +#define RTC_IO_XPD_XTAL_32K_S 19 +#define RTC_IO_X32N_MUX_SEL (BIT(18)) +#define RTC_IO_X32N_MUX_SEL_S 18 +#define RTC_IO_X32P_MUX_SEL (BIT(17)) +#define RTC_IO_X32P_MUX_SEL_S 17 +#define RTC_IO_X32N_FUN_SEL 0x00000003 +#define RTC_IO_X32N_FUN_SEL_S 15 +#define RTC_IO_X32N_SLP_SEL (BIT(14)) +#define RTC_IO_X32N_SLP_SEL_S 14 +#define RTC_IO_X32N_SLP_IE (BIT(13)) +#define RTC_IO_X32N_SLP_IE_S 13 +#define RTC_IO_X32N_SLP_OE (BIT(12)) +#define RTC_IO_X32N_SLP_OE_S 12 +#define RTC_IO_X32N_FUN_IE (BIT(11)) +#define RTC_IO_X32N_FUN_IE_S 11 +#define RTC_IO_X32P_FUN_SEL 0x00000003 +#define RTC_IO_X32P_FUN_SEL_S 9 +#define RTC_IO_X32P_SLP_SEL (BIT(8)) +#define RTC_IO_X32P_SLP_SEL_S 8 +#define RTC_IO_X32P_SLP_IE (BIT(7)) +#define RTC_IO_X32P_SLP_IE_S 7 +#define RTC_IO_X32P_SLP_OE (BIT(6)) +#define RTC_IO_X32P_SLP_OE_S 6 +#define RTC_IO_X32P_FUN_IE (BIT(5)) +#define RTC_IO_X32P_FUN_IE_S 5 +#define RTC_IO_DRES_XTAL_32K 0x00000003 +#define RTC_IO_DRES_XTAL_32K_S 3 +#define RTC_IO_DBIAS_XTAL_32K 0x00000003 +#define RTC_IO_DBIAS_XTAL_32K_S 1 + +#define TOUCH_CFG (DR_REG_RTCIO_BASE + 0x90) +#define RTC_IO_TOUCH_XPD_BIAS (BIT(31)) +#define RTC_IO_TOUCH_XPD_BIAS_S 31 +#define RTC_IO_TOUCH_DREFH 0x00000003 +#define RTC_IO_TOUCH_DREFH_S 29 +#define RTC_IO_TOUCH_DREFL 0x00000003 +#define RTC_IO_TOUCH_DREFL_S 27 +#define RTC_IO_TOUCH_DRANGE 0x00000003 +#define RTC_IO_TOUCH_DRANGE_S 25 +#define RTC_IO_TOUCH_DCUR 0x00000003 +#define RTC_IO_TOUCH_DCUR_S 23 + +#define TOUCH_PAD0 (DR_REG_RTCIO_BASE + 0x94) +#define RTC_IO_TOUCH_PAD0_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD0_HOLD_S 31 +#define RTC_IO_TOUCH_PAD0_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD0_DRV_S 29 +#define RTC_IO_TOUCH_PAD0_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD0_RDE_S 28 +#define RTC_IO_TOUCH_PAD0_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD0_RUE_S 27 +#define RTC_IO_TOUCH_PAD0_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD0_DAC_S 23 +#define RTC_IO_TOUCH_PAD0_START (BIT(22)) +#define RTC_IO_TOUCH_PAD0_START_S 22 +#define RTC_IO_TOUCH_PAD0_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD0_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD0_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD0_XPD_S 20 +#define RTC_IO_TOUCH_PAD0_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD0_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD0_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD0_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD0_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD0_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD0_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD0_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD0_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD0_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD0_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD0_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD0_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD0_TO_GPIO_S 12 + +#define TOUCH_PAD1 (DR_REG_RTCIO_BASE + 0x98) +#define RTC_IO_TOUCH_PAD1_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD1_HOLD_S 31 +#define RTC_IO_TOUCH_PAD1_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD1_DRV_S 29 +#define RTC_IO_TOUCH_PAD1_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD1_RDE_S 28 +#define RTC_IO_TOUCH_PAD1_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD1_RUE_S 27 +#define RTC_IO_TOUCH_PAD1_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD1_DAC_S 23 +#define RTC_IO_TOUCH_PAD1_START (BIT(22)) +#define RTC_IO_TOUCH_PAD1_START_S 22 +#define RTC_IO_TOUCH_PAD1_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD1_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD1_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD1_XPD_S 20 +#define RTC_IO_TOUCH_PAD1_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD1_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD1_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD1_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD1_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD1_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD1_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD1_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD1_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD1_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD1_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD1_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD1_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD1_TO_GPIO_S 12 + +#define TOUCH_PAD2 (DR_REG_RTCIO_BASE + 0x9c) +#define RTC_IO_TOUCH_PAD2_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD2_HOLD_S 31 +#define RTC_IO_TOUCH_PAD2_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD2_DRV_S 29 +#define RTC_IO_TOUCH_PAD2_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD2_RDE_S 28 +#define RTC_IO_TOUCH_PAD2_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD2_RUE_S 27 +#define RTC_IO_TOUCH_PAD2_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD2_DAC_S 23 +#define RTC_IO_TOUCH_PAD2_START (BIT(22)) +#define RTC_IO_TOUCH_PAD2_START_S 22 +#define RTC_IO_TOUCH_PAD2_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD2_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD2_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD2_XPD_S 20 +#define RTC_IO_TOUCH_PAD2_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD2_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD2_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD2_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD2_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD2_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD2_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD2_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD2_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD2_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD2_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD2_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD2_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD2_TO_GPIO_S 12 + +#define TOUCH_PAD3 (DR_REG_RTCIO_BASE + 0xa0) +#define RTC_IO_TOUCH_PAD3_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD3_HOLD_S 31 +#define RTC_IO_TOUCH_PAD3_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD3_DRV_S 29 +#define RTC_IO_TOUCH_PAD3_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD3_RDE_S 28 +#define RTC_IO_TOUCH_PAD3_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD3_RUE_S 27 +#define RTC_IO_TOUCH_PAD3_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD3_DAC_S 23 +#define RTC_IO_TOUCH_PAD3_START (BIT(22)) +#define RTC_IO_TOUCH_PAD3_START_S 22 +#define RTC_IO_TOUCH_PAD3_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD3_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD3_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD3_XPD_S 20 +#define RTC_IO_TOUCH_PAD3_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD3_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD3_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD3_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD3_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD3_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD3_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD3_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD3_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD3_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD3_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD3_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD3_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD3_TO_GPIO_S 12 + +#define TOUCH_PAD4 (DR_REG_RTCIO_BASE + 0xa4) +#define RTC_IO_TOUCH_PAD4_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD4_HOLD_S 31 +#define RTC_IO_TOUCH_PAD4_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD4_DRV_S 29 +#define RTC_IO_TOUCH_PAD4_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD4_RDE_S 28 +#define RTC_IO_TOUCH_PAD4_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD4_RUE_S 27 +#define RTC_IO_TOUCH_PAD4_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD4_DAC_S 23 +#define RTC_IO_TOUCH_PAD4_START (BIT(22)) +#define RTC_IO_TOUCH_PAD4_START_S 22 +#define RTC_IO_TOUCH_PAD4_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD4_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD4_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD4_XPD_S 20 +#define RTC_IO_TOUCH_PAD4_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD4_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD4_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD4_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD4_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD4_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD4_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD4_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD4_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD4_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD4_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD4_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD4_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD4_TO_GPIO_S 12 + +#define TOUCH_PAD5 (DR_REG_RTCIO_BASE + 0xa8) +#define RTC_IO_TOUCH_PAD5_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD5_HOLD_S 31 +#define RTC_IO_TOUCH_PAD5_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD5_DRV_S 29 +#define RTC_IO_TOUCH_PAD5_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD5_RDE_S 28 +#define RTC_IO_TOUCH_PAD5_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD5_RUE_S 27 +#define RTC_IO_TOUCH_PAD5_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD5_DAC_S 23 +#define RTC_IO_TOUCH_PAD5_START (BIT(22)) +#define RTC_IO_TOUCH_PAD5_START_S 22 +#define RTC_IO_TOUCH_PAD5_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD5_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD5_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD5_XPD_S 20 +#define RTC_IO_TOUCH_PAD5_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD5_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD5_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD5_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD5_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD5_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD5_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD5_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD5_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD5_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD5_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD5_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD5_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD5_TO_GPIO_S 12 + +#define TOUCH_PAD6 (DR_REG_RTCIO_BASE + 0xac) +#define RTC_IO_TOUCH_PAD6_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD6_HOLD_S 31 +#define RTC_IO_TOUCH_PAD6_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD6_DRV_S 29 +#define RTC_IO_TOUCH_PAD6_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD6_RDE_S 28 +#define RTC_IO_TOUCH_PAD6_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD6_RUE_S 27 +#define RTC_IO_TOUCH_PAD6_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD6_DAC_S 23 +#define RTC_IO_TOUCH_PAD6_START (BIT(22)) +#define RTC_IO_TOUCH_PAD6_START_S 22 +#define RTC_IO_TOUCH_PAD6_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD6_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD6_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD6_XPD_S 20 +#define RTC_IO_TOUCH_PAD6_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD6_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD6_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD6_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD6_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD6_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD6_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD6_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD6_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD6_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD6_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD6_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD6_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD6_TO_GPIO_S 12 + +#define TOUCH_PAD7 (DR_REG_RTCIO_BASE + 0xb0) +#define RTC_IO_TOUCH_PAD7_HOLD (BIT(31)) +#define RTC_IO_TOUCH_PAD7_HOLD_S 31 +#define RTC_IO_TOUCH_PAD7_DRV 0x00000003 +#define RTC_IO_TOUCH_PAD7_DRV_S 29 +#define RTC_IO_TOUCH_PAD7_RDE (BIT(28)) +#define RTC_IO_TOUCH_PAD7_RDE_S 28 +#define RTC_IO_TOUCH_PAD7_RUE (BIT(27)) +#define RTC_IO_TOUCH_PAD7_RUE_S 27 +#define RTC_IO_TOUCH_PAD7_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD7_DAC_S 23 +#define RTC_IO_TOUCH_PAD7_START (BIT(22)) +#define RTC_IO_TOUCH_PAD7_START_S 22 +#define RTC_IO_TOUCH_PAD7_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD7_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD7_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD7_XPD_S 20 +#define RTC_IO_TOUCH_PAD7_MUX_SEL (BIT(19)) +#define RTC_IO_TOUCH_PAD7_MUX_SEL_S 19 +#define RTC_IO_TOUCH_PAD7_FUN_SEL 0x00000003 +#define RTC_IO_TOUCH_PAD7_FUN_SEL_S 17 +#define RTC_IO_TOUCH_PAD7_SLP_SEL (BIT(16)) +#define RTC_IO_TOUCH_PAD7_SLP_SEL_S 16 +#define RTC_IO_TOUCH_PAD7_SLP_IE (BIT(15)) +#define RTC_IO_TOUCH_PAD7_SLP_IE_S 15 +#define RTC_IO_TOUCH_PAD7_SLP_OE (BIT(14)) +#define RTC_IO_TOUCH_PAD7_SLP_OE_S 14 +#define RTC_IO_TOUCH_PAD7_FUN_IE (BIT(13)) +#define RTC_IO_TOUCH_PAD7_FUN_IE_S 13 +#define RTC_IO_TOUCH_PAD7_TO_GPIO (BIT(12)) +#define RTC_IO_TOUCH_PAD7_TO_GPIO_S 12 + +#define TOUCH_PAD8 (DR_REG_RTCIO_BASE + 0xb4) +#define RTC_IO_TOUCH_PAD8_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD8_DAC_S 23 +#define RTC_IO_TOUCH_PAD8_START (BIT(22)) +#define RTC_IO_TOUCH_PAD8_START_S 22 +#define RTC_IO_TOUCH_PAD8_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD8_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD8_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD8_XPD_S 20 +#define RTC_IO_TOUCH_PAD8_TO_GPIO (BIT(19)) +#define RTC_IO_TOUCH_PAD8_TO_GPIO_S 19 + +#define TOUCH_PAD9 (DR_REG_RTCIO_BASE + 0xb8) +#define RTC_IO_TOUCH_PAD9_DAC 0x00000007 +#define RTC_IO_TOUCH_PAD9_DAC_S 23 +#define RTC_IO_TOUCH_PAD9_START (BIT(22)) +#define RTC_IO_TOUCH_PAD9_START_S 22 +#define RTC_IO_TOUCH_PAD9_TIE_OPT (BIT(21)) +#define RTC_IO_TOUCH_PAD9_TIE_OPT_S 21 +#define RTC_IO_TOUCH_PAD9_XPD (BIT(20)) +#define RTC_IO_TOUCH_PAD9_XPD_S 20 +#define RTC_IO_TOUCH_PAD9_TO_GPIO (BIT(19)) +#define RTC_IO_TOUCH_PAD9_TO_GPIO_S 19 + +#define EXT_WAKEUP0 (DR_REG_RTCIO_BASE + 0xbc) +#define RTC_IO_EXT_WAKEUP0_SEL 0x0000001F +#define RTC_IO_EXT_WAKEUP0_SEL_S 27 + +#define XTL_EXT_CTR (DR_REG_RTCIO_BASE + 0xc0) +#define RTC_IO_XTL_EXT_CTR_SEL 0x0000001F +#define RTC_IO_XTL_EXT_CTR_SEL_S 27 + +#define SAR_I2C_IO (DR_REG_RTCIO_BASE + 0xc4) +#define RTC_IO_SAR_I2C_SDA_SEL 0x00000003 +#define RTC_IO_SAR_I2C_SDA_SEL_S 30 +#define RTC_IO_SAR_I2C_SCL_SEL 0x00000003 +#define RTC_IO_SAR_I2C_SCL_SEL_S 28 +#define RTC_IO_SAR_DEBUG_BIT_SEL 0x0000001F +#define RTC_IO_SAR_DEBUG_BIT_SEL_S 23 + +#define RTC_IO_DATE (DR_REG_RTCIO_BASE + 0xc8) +#define RTC_IO_RTC_IO_DATE 0x0FFFFFFF +#define RTC_IO_RTC_IO_DATE_S 0 +#define RTC_IO_RTC_IO_DATE_VERSION 0x1703160 + +#endif /* _SOC_RTC_IO_REG_H_ */ + diff --git a/components/esp32/include/soc/soc.h b/components/esp32/include/soc/soc.h new file mode 100755 index 000000000..cb3d5154a --- /dev/null +++ b/components/esp32/include/soc/soc.h @@ -0,0 +1,270 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _ESP32_SOC_H_ +#define _ESP32_SOC_H_ + +#include + +//Register Bits{{ +#define BIT31 0x80000000 +#define BIT30 0x40000000 +#define BIT29 0x20000000 +#define BIT28 0x10000000 +#define BIT27 0x08000000 +#define BIT26 0x04000000 +#define BIT25 0x02000000 +#define BIT24 0x01000000 +#define BIT23 0x00800000 +#define BIT22 0x00400000 +#define BIT21 0x00200000 +#define BIT20 0x00100000 +#define BIT19 0x00080000 +#define BIT18 0x00040000 +#define BIT17 0x00020000 +#define BIT16 0x00010000 +#define BIT15 0x00008000 +#define BIT14 0x00004000 +#define BIT13 0x00002000 +#define BIT12 0x00001000 +#define BIT11 0x00000800 +#define BIT10 0x00000400 +#define BIT9 0x00000200 +#define BIT8 0x00000100 +#define BIT7 0x00000080 +#define BIT6 0x00000040 +#define BIT5 0x00000020 +#define BIT4 0x00000010 +#define BIT3 0x00000008 +#define BIT2 0x00000004 +#define BIT1 0x00000002 +#define BIT0 0x00000001 +//}} + +//Registers Operation {{ +#define ETS_UNCACHED_ADDR(addr) (addr) +#define ETS_CACHED_ADDR(addr) (addr) + +#define BIT(nr) (1UL << (nr)) + +#define REG_WRITE(_r, _v) (*(volatile uint32_t *)(_r)) = (_v) +#define REG_READ(_r) (*(volatile uint32_t *)(_r)) + +#define REG_GET_BIT(_r, _b) (*(volatile uint32_t*)(_r) & (_b)) +#define REG_SET_BIT(_r, _b) (*(volatile uint32_t*)(_r) |= (_b)) +#define REG_CLR_BIT(_r, _b) (*(volatile uint32_t*)(_r) &= ~(_b)) +#define REG_SET_BITS(_r, _b, _m) (*(volatile uint32_t*)(_r) = (*(volatile uint32_t*)(_r) & ~(_m)) | ((_b) & (_m))) +#define VALUE_GET_FIELD(_r, _f) (((_r) >> (_f##_S)) & (_f)) +#define VALUE_GET_FIELD2(_r, _f) (((_r) & (_f))>> (_f##_S)) +#define VALUE_SET_FIELD(_r, _f, _v) ((_r)=(((_r) & ~((_f) << (_f##_S)))|((_v)<<(_f##_S)))) +#define VALUE_SET_FIELD2(_r, _f, _v) ((_r)=(((_r) & ~(_f))|((_v)<<(_f##_S)))) +#define FIELD_TO_VALUE(_f, _v) (((_v)&(_f))<<_f##_S) +#define FIELD_TO_VALUE2(_f, _v) (((_v)<<_f##_S) & (_f)) +#define REG_GET_FIELD(_r, _f) ((REG_READ(_r) >> (_f##_S)) & (_f)) +#define REG_SET_FIELD(_r, _f, _v) (REG_WRITE((_r),((REG_READ(_r) & ~((_f) << (_f##_S)))|(((_v) & (_f))<<(_f##_S))))) + + +#define READ_PERI_REG(addr) (*((volatile uint32_t *)ETS_UNCACHED_ADDR(addr))) +#define WRITE_PERI_REG(addr, val) (*((volatile uint32_t *)ETS_UNCACHED_ADDR(addr))) = (uint32_t)(val) +#define CLEAR_PERI_REG_MASK(reg, mask) WRITE_PERI_REG((reg), (READ_PERI_REG(reg)&(~(mask)))) +#define SET_PERI_REG_MASK(reg, mask) WRITE_PERI_REG((reg), (READ_PERI_REG(reg)|(mask))) +#define GET_PERI_REG_MASK(reg, mask) (READ_PERI_REG(reg) & (mask)) +#define GET_PERI_REG_BITS(reg, hipos,lowpos) ((READ_PERI_REG(reg)>>(lowpos))&((1<<((hipos)-(lowpos)+1))-1)) +#define SET_PERI_REG_BITS(reg,bit_map,value,shift) (WRITE_PERI_REG((reg),(READ_PERI_REG(reg)&(~((bit_map)<<(shift))))|(((value) & bit_map)<<(shift)) )) +#define GET_PERI_REG_BITS2(reg, mask,shift) ((READ_PERI_REG(reg)>>(shift))&(mask)) +//}} + +//Periheral Clock {{ +#define APB_CLK_FREQ_ROM 13*1000000 +#define CPU_CLK_FREQ_ROM APB_CLK_FREQ_ROM +#define CPU_CLK_FREQ APB_CLK_FREQ +#define APB_CLK_FREQ 40*1000000 //unit: Hz +#define UART_CLK_FREQ APB_CLK_FREQ +//#define WDT_CLK_FREQ APB_CLK_FREQ +#define TIMER_CLK_FREQ (80000000>>4) //80MHz divided by 16 +#define SPI_CLK_DIV 4 +//#define RTC_CLK_FREQ 32768 //unit:Hz +//#define RTC_CLK_FREQ 100000 //unit:Hz +//#define CALIB_CLK_MHZ 40 +#define TICKS_PER_US 13 // CPU is 80MHz +//}} + +#if 0 +//Peripheral device base address define{{ +#define DR_REG_DPORT_BASE 0x3ff00000 +#define DR_REG_UART_BASE 0x60000000 +#define DR_REG_SPI1_BASE 0x60002000 //no +#define DR_REG_SPI0_BASE 0x60003000 //no +#define DR_REG_GPIO_BASE 0x60004000 //no +#define DR_REG_FE2_BASE 0x60005000 +#define DR_REG_FE_BASE 0x60006000 +#define DR_REG_TIMER_BASE 0x60007000 //no +#define DR_REG_RTCCNTL_BASE 0x60008000 +#define DR_REG_RTCIO_BASE 0x60008400 + +#define DR_REG_RTCMEM0_BASE 0x60021000 +#define DR_REG_RTCMEM1_BASE 0x60022000 +#define DR_REG_RTCMEM2_BASE 0x60023000 + +#define DR_REG_IO_MUX_BASE 0x60009000 //no +#define DR_REG_WDG_BASE 0x6000A000 //no +#define DR_REG_HINF_BASE 0x6000B000 //no +#define DR_REG_UHCI1_BASE 0x6000C000 +//#define DR_REG_MISC_BASE 0x6000D000 //no use +#define DR_REG_I2C_BASE 0x6000E000 //no +#define DR_REG_I2S_BASE 0x6000F000 +#define DR_REG_UART1_BASE 0x60010000 +#define DR_REG_BT_BASE 0x60011000 +//#define DR_REG_BT_BUFFER_BASE 0x60012000 //no use +#define DR_REG_I2C_EXT_BASE 0x60013000 //no +#define DR_REG_UHCI0_BASE 0x60014000 +#define DR_REG_SLCHOST_BASE 0x60015000 +#define DR_REG_RMT_BASE 0x60016000 +#define DR_REG_PCNT_BASE 0x60017000 +#define DR_REG_SLC_BASE 0x60018000 +#define DR_REG_LEDC_BASE 0x60019000 +#define DR_REG_EFUSE_BASE 0x6001A000 +#define DR_REG_SPI_ENCRYPT_BASE 0x6001B000 +#define DR_REG_PWM_BASE 0x6001C000 //no +#define DR_REG_TIMERGROUP_BASE 0x6001D000 //no +#define DR_REG_TIMERGROUP1_BASE 0x6001E000 //no +#define DR_REG_BB_BASE 0x6001F000 +#define DR_REG_GPIO_SD_BASE 0x60004f00 +#else +#define DR_REG_DPORT_BASE 0x3ff00000 +#define DR_REG_UART_BASE 0x3ff40000 +#define DR_REG_SPI1_BASE 0x3ff42000 //no +#define DR_REG_SPI0_BASE 0x3ff43000 //no +#define DR_REG_GPIO_BASE 0x3ff44000 //no +#define DR_REG_FE2_BASE 0x3ff45000 +#define DR_REG_FE_BASE 0x3ff46000 +#define DR_REG_TIMER_BASE 0x3ff47000 //no +#define DR_REG_RTCCNTL_BASE 0x3ff48000 +#define DR_REG_RTCIO_BASE 0x3ff48400 + +#define DR_REG_RTCMEM0_BASE 0x3ff61000 +#define DR_REG_RTCMEM1_BASE 0x3ff62000 +#define DR_REG_RTCMEM2_BASE 0x3ff63000 + +#define DR_REG_IO_MUX_BASE 0x3ff49000 //no +#define DR_REG_WDG_BASE 0x3ff4A000 //no +#define DR_REG_HINF_BASE 0x3ff4B000 //no +#define DR_REG_UHCI1_BASE 0x3ff4C000 +//#define DR_REG_MISC_BASE 0x6000D000 //no use +#define DR_REG_I2C_BASE 0x3ff4E000 //no +#define DR_REG_I2S_BASE 0x3ff4F000 +#define DR_REG_I2S1_BASE 0x3ff6D000 +#define DR_REG_UART1_BASE 0x3ff50000 +#define DR_REG_BT_BASE 0x3ff51000 +//#define DR_REG_BT_BUFFER_BASE 0x60012000 //no use +#define DR_REG_I2C_EXT_BASE 0x3ff53000 //no +#define DR_REG_UHCI0_BASE 0x3ff54000 +#define DR_REG_SLCHOST_BASE 0x3ff55000 +#define DR_REG_RMT_BASE 0x3ff56000 +#define DR_REG_PCNT_BASE 0x3ff57000 +#define DR_REG_SLC_BASE 0x3ff58000 +#define DR_REG_LEDC_BASE 0x3ff59000 +#define DR_REG_EFUSE_BASE 0x3ff5A000 +#define DR_REG_SPI_ENCRYPT_BASE 0x3ff5B000 +#define DR_REG_PWM_BASE 0x3ff5C000 //no +#define DR_REG_TIMERS_BASE 0x3ff5F000 //no +#define DR_REG_TIMERGROUP1_BASE 0x3ff5E000 //no +#define DR_REG_BB_BASE 0x3ff5F000 +#define DR_REG_GPIO_SD_BASE 0x3ff44f00 +#endif + +//}} +#define REG_SPI_BASE(i) (DR_REG_SPI0_BASE - i*(0x1000)) +#define PERIPHS_TIMER_BASEDDR DR_REG_TIMER_BASE +#define PERIPHS_SPI_ENCRYPT_BASEADDR DR_REG_SPI_ENCRYPT_BASE + +#define UART0_UNHOLD_MASK 0x3 +#define UART1_UNHOLD_MASK 0x60 +#define SDIO_UNHOLD_MASK 0xfc +#define SPI_UNHOLD_MASK 0xfc + +// TIMER reg {{ +#define TIMER_REG_READ(addr) READ_PERI_REG(addr) +#define TIMER_REG_WRITE(addr, val) WRITE_PERI_REG(addr, val) +#define TIMER_SET_REG_MASK(reg, mask) WRITE_PERI_REG(reg, (READ_PERI_REG(reg)|(mask))) +/* Returns the current time according to the timer timer. */ +#define NOW() TIMER_REG_READ(FRC2_COUNT_ADDRESS) +//load initial_value to timer1 +#define FRC1_LOAD_ADDRESS (PERIPHS_TIMER_BASEDDR +0x00) +#define FRC1_LOAD_DATA_MSB 22 +#define FRC1_LOAD_DATA_LSB 0 +#define FRC1_LOAD_DATA_MASK 0x007fffff + +//timer1's counter value(count from initial_value to 0) +#define FRC1_COUNT_ADDRESS (PERIPHS_TIMER_BASEDDR +0x04) +#define FRC1_COUNT_DATA_MSB 22 +#define FRC1_COUNT_DATA_LSB 0 +#define FRC1_COUNT_DATA_MASK 0x007fffff + +#define FRC1_CTRL_ADDRESS (PERIPHS_TIMER_BASEDDR +0x08) +#define FRC1_CTRL_DATA_MSB 7 +#define FRC1_CTRL_DATA_LSB 0 +#define FRC1_CTRL_DATA_MASK 0x000000ff + +//clear timer1's interrupt when write this address +#define FRC1_INT_ADDRESS (PERIPHS_TIMER_BASEDDR +0x0c) +#define FRC1_INT_CLR_MSB 0 +#define FRC1_INT_CLR_LSB 0 +#define FRC1_INT_CLR_MASK 0x00000001 + +//only used for simulation +#define FRC1_TEST_ADDRESS (PERIPHS_TIMER_BASEDDR +0x10) +#define FRC1_TEST_MODE_MSB 0 +#define FRC1_TEST_MODE_LSB 0 +#define FRC1_TEST_MODE_MASK 0x00000001 + +//load initial_value to timer2 +#define FRC2_LOAD_ADDRESS (PERIPHS_TIMER_BASEDDR +0x20) +#define FRC2_LOAD_DATA_MSB 31 +#define FRC2_LOAD_DATA_LSB 0 +#define FRC2_LOAD_DATA_MASK 0xffffffff + +//timer2's counter value(count from initial_value to 0) +#define FRC2_COUNT_ADDRESS (PERIPHS_TIMER_BASEDDR +0x24) +#define FRC2_COUNT_DATA_MSB 31 +#define FRC2_COUNT_DATA_LSB 0 +#define FRC2_COUNT_DATA_MASK 0xffffffff + +#define FRC2_CTRL_ADDRESS (PERIPHS_TIMER_BASEDDR +0x28) +#define FRC2_CTRL_DATA_MSB 7 +#define FRC2_CTRL_DATA_LSB 0 +#define FRC2_CTRL_DATA_MASK 0x000000ff + +//clear interrupt when write this address +#define FRC2_INT_ADDRESS (PERIPHS_TIMER_BASEDDR +0x2c) +#define FRC2_INT_CLR_MSB 0 +#define FRC2_INT_CLR_LSB 0 +#define FRC2_INT_CLR_MASK 0x00000001 + +//set Alarm_value for timer2 to generate interrupt +#define FRC2_ALARM_ADDRESS (PERIPHS_TIMER_BASEDDR +0x30) +#define FRC2_ALARM_DATA_MSB 31 +#define FRC2_ALARM_DATA_LSB 0 +#define FRC2_ALARM_DATA_MASK 0xffffffff +// }} + +#define SPI_ENCRYPT_CNTL (PERIPHS_SPI_ENCRYPT_BASEADDR + 0x20) +#define SPI_ENCRYPT_CNTL_ENA BIT(0) + +#define SPI_ENCRYPT_ADDR (PERIPHS_SPI_ENCRYPT_BASEADDR + 0x24) + +#define SPI_ENCRYPT_CHECKDONE (PERIPHS_SPI_ENCRYPT_BASEADDR + 0x28) +#define SPI_ENCRYPT_CHECKDONE_STATUS BIT(0) + +#endif /* _ESP32_SOC_H_ */ diff --git a/components/esp32/include/soc/spi_register.h b/components/esp32/include/soc/spi_register.h new file mode 100755 index 000000000..d292c952b --- /dev/null +++ b/components/esp32/include/soc/spi_register.h @@ -0,0 +1,399 @@ +// Copyright 2010-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _SOC_SPI_REG_H_ +#define _SOC_SPI_REG_H_ + +#include "soc.h" + +#define SPI_CMD( i ) (REG_SPI_BASE( i ) + 0x0) +#define SPI_FLASH_READ (BIT(31)) +#define SPI_FLASH_WREN (BIT(30)) +#define SPI_FLASH_WRDI (BIT(29)) +#define SPI_FLASH_RDID (BIT(28)) +#define SPI_FLASH_RDSR (BIT(27)) +#define SPI_FLASH_WRSR (BIT(26)) +#define SPI_FLASH_PP (BIT(25)) +#define SPI_FLASH_SE (BIT(24)) +#define SPI_FLASH_BE (BIT(23)) +#define SPI_FLASH_CE (BIT(22)) +#define SPI_FLASH_DP (BIT(21)) +#define SPI_FLASH_RES (BIT(20)) +#define SPI_FLASH_HPM (BIT(19)) +#define SPI_USR (BIT(18)) +#define SPI_FLASH_PES (BIT(17)) +#define SPI_FLASH_PER (BIT(16)) +#define SPI_ADDR( i ) (REG_SPI_BASE( i ) + 0x4) +#define SPI_CTRL( i ) (REG_SPI_BASE( i ) + 0x8) +#define SPI_WR_BIT_ORDER (BIT(26)) +#define SPI_RD_BIT_ORDER (BIT(25)) +#define SPI_FREAD_QIO (BIT(24)) +#define SPI_FREAD_DIO (BIT(23)) +#define SPI_WRSR_2B (BIT(22)) +#define SPI_WP_REG (BIT(21)) +#define SPI_FREAD_QUAD (BIT(20)) +#define SPI_RESANDRES (BIT(15)) +#define SPI_FREAD_DUAL (BIT(14)) +#define SPI_FASTRD_MODE (BIT(13)) +#define SPI_WAIT_FLASH_IDLE_EN (BIT(12)) +#define SPI_TX_CRC_EN (BIT(11)) +#define SPI_FCS_CRC_EN (BIT(10)) +#define SPI_CTRL1( i ) (REG_SPI_BASE( i ) + 0xC) +#define SPI_CS_HOLD_DELAY 0x0000000F +#define SPI_CS_HOLD_DELAY_S 28 +#define SPI_CS_HOLD_DELAY_RES 0x00000FFF +#define SPI_CS_HOLD_DELAY_RES_S 16 +#define SPI_RD_STATUS( i ) (REG_SPI_BASE( i ) + 0x10) +#define SPI_STATUS_EXT 0x000000FF +#define SPI_STATUS_EXT_S 24 +#define SPI_WB_MODE 0x000000FF +#define SPI_WB_MODE_S 16 +#define SPI_STATUS 0x0000FFFF +#define SPI_STATUS_S 0 + +#define SPI_CTRL2( i ) (REG_SPI_BASE( i ) + 0x14) +#define SPI_CS_DELAY_NUM 0x0000000F +#define SPI_CS_DELAY_NUM_S 28 +#define SPI_CS_DELAY_MODE 0x00000003 +#define SPI_CS_DELAY_MODE_S 26 +#define SPI_MOSI_DELAY_NUM 0x00000007 +#define SPI_MOSI_DELAY_NUM_S 23 +#define SPI_MOSI_DELAY_MODE 0x00000003 +#define SPI_MOSI_DELAY_MODE_S 21 +#define SPI_MISO_DELAY_NUM 0x00000007 +#define SPI_MISO_DELAY_NUM_S 18 +#define SPI_MISO_DELAY_MODE 0x00000003 +#define SPI_MISO_DELAY_MODE_S 16 +#define SPI_CK_OUT_HIGH_MODE 0x0000000F +#define SPI_CK_OUT_HIGH_MODE_S 12 +#define SPI_CK_OUT_LOW_MODE 0x0000000F +#define SPI_CK_OUT_LOW_MODE_S 8 +#define SPI_HOLD_TIME 0x0000000F +#define SPI_HOLD_TIME_S 4 +#define SPI_SETUP_TIME 0x0000000F +#define SPI_SETUP_TIME_S 0 + +#define SPI_CLOCK( i ) (REG_SPI_BASE( i ) + 0x18) +#define SPI_CLK_EQU_SYSCLK (BIT(31)) +#define SPI_CLKDIV_PRE 0x00001FFF +#define SPI_CLKDIV_PRE_S 18 +#define SPI_CLKCNT_N 0x0000003F +#define SPI_CLKCNT_N_S 12 +#define SPI_CLKCNT_H 0x0000003F +#define SPI_CLKCNT_H_S 6 +#define SPI_CLKCNT_L 0x0000003F +#define SPI_CLKCNT_L_S 0 + +#define SPI_USER( i ) (REG_SPI_BASE( i ) + 0x1C) +#define SPI_USR_COMMAND (BIT(31)) +#define SPI_USR_ADDR (BIT(30)) +#define SPI_USR_DUMMY (BIT(29)) +#define SPI_USR_MISO (BIT(28)) +#define SPI_USR_MOSI (BIT(27)) +#define SPI_USR_DUMMY_IDLE (BIT(26)) +#define SPI_USR_MOSI_HIGHPART (BIT(25)) +#define SPI_USR_MISO_HIGHPART (BIT(24)) +#define SPI_USR_PREP_HOLD (BIT(23)) +#define SPI_USR_CMD_HOLD (BIT(22)) +#define SPI_USR_ADDR_HOLD (BIT(21)) +#define SPI_USR_DUMMY_HOLD (BIT(20)) +#define SPI_USR_DIN_HOLD (BIT(19)) +#define SPI_USR_DOUT_HOLD (BIT(18)) +#define SPI_USR_HOLD_POL (BIT(17)) +#define SPI_SIO (BIT(16)) +#define SPI_FWRITE_QIO (BIT(15)) +#define SPI_FWRITE_DIO (BIT(14)) +#define SPI_FWRITE_QUAD (BIT(13)) +#define SPI_FWRITE_DUAL (BIT(12)) +#define SPI_WR_BYTE_ORDER (BIT(11)) +#define SPI_RD_BYTE_ORDER (BIT(10)) +#define SPI_CK_OUT_EDGE (BIT(7)) +#define SPI_CK_I_EDGE (BIT(6)) +#define SPI_CS_SETUP (BIT(5)) +#define SPI_CS_HOLD (BIT(4)) +#define SPI_DOUTDIN (BIT(0)) + +#define SPI_USER1( i ) (REG_SPI_BASE( i ) + 0x20) +#define SPI_USR_ADDR_BITLEN 0x0000003F +#define SPI_USR_ADDR_BITLEN_S 26 +#define SPI_USR_DUMMY_CYCLELEN 0x000000FF +#define SPI_USR_DUMMY_CYCLELEN_S 0 + +#define SPI_USER2( i ) (REG_SPI_BASE( i ) + 0x24) +#define SPI_USR_COMMAND_BITLEN 0x0000000F +#define SPI_USR_COMMAND_BITLEN_S 28 +#define SPI_USR_COMMAND_VALUE 0x0000FFFF +#define SPI_USR_COMMAND_VALUE_S 0 + +#define SPI_MOSI_DLEN( i ) (REG_SPI_BASE( i ) + 0x28) +#define SPI_USR_MOSI_DBITLEN 0x00FFFFFF +#define SPI_USR_MOSI_DBITLEN_S 0 + +#define SPI_MISO_DLEN( i ) (REG_SPI_BASE( i ) + 0x2C) +#define SPI_USR_MISO_DBITLEN 0x00FFFFFF +#define SPI_USR_MISO_DBITLEN_S 0 + +#define SPI_SLV_WR_STATUS( i ) (REG_SPI_BASE( i ) + 0x30) +#define SPI_PIN( i ) (REG_SPI_BASE( i ) + 0x34) +#define SPI_CS_KEEP_ACTIVE (BIT(30)) +#define SPI_CK_IDLE_EDGE (BIT(29)) +#define SPI_CSCK_SEL (BIT(19)) +#define SPI_MASTER_CK_SEL 0x0000001F +#define SPI_MASTER_CK_SEL_S 11 +#define SPI_MASTER_CS_POL 0x0000001F +#define SPI_MASTER_CS_POL_S 6 +#define SPI_CK_DIS (BIT(5)) +#define SPI_CS2_DIS (BIT(2)) +#define SPI_CS1_DIS (BIT(1)) +#define SPI_CS0_DIS (BIT(0)) + +#define SPI_SLAVE( i ) (REG_SPI_BASE( i ) + 0x38) +#define SPI_SYNC_RESET (BIT(31)) +#define SPI_SLAVE_MODE (BIT(30)) +#define SPI_SLV_WR_RD_BUF_EN (BIT(29)) +#define SPI_SLV_WR_RD_STA_EN (BIT(28)) +#define SPI_SLV_CMD_DEFINE (BIT(27)) +#define SPI_TRANS_CNT 0x0000000F +#define SPI_TRANS_CNT_S 23 +#define SPI_SLV_LAST_STATE 0x00000007 +#define SPI_SLV_LAST_STATE_S 20 +#define SPI_SLV_LAST_COMMAND 0x00000007 +#define SPI_SLV_LAST_COMMAND_S 17 +#define SPI_CS_I_MODE 0x00000003 +#define SPI_CS_I_MODE_S 10 +#define SPI_INT_EN 0x0000001F +#define SPI_INT_EN_S 5 +#define SPI_TRANS_DONE (BIT(4)) +#define SPI_SLV_WR_STA_DONE (BIT(3)) +#define SPI_SLV_RD_STA_DONE (BIT(2)) +#define SPI_SLV_WR_BUF_DONE (BIT(1)) +#define SPI_SLV_RD_BUF_DONE (BIT(0)) + +#define SPI_SLAVE1( i ) (REG_SPI_BASE( i ) + 0x3C) +#define SPI_SLV_STATUS_BITLEN 0x0000001F +#define SPI_SLV_STATUS_BITLEN_S 27 +#define SPI_SLV_STATUS_FAST_EN (BIT(26)) +#define SPI_SLV_STATUS_READBACK (BIT(25)) +#define SPI_SLV_RD_ADDR_BITLEN 0x0000003F +#define SPI_SLV_RD_ADDR_BITLEN_S 10 +#define SPI_SLV_WR_ADDR_BITLEN 0x0000003F +#define SPI_SLV_WR_ADDR_BITLEN_S 4 +#define SPI_SLV_WRSTA_DUMMY_EN (BIT(3)) +#define SPI_SLV_RDSTA_DUMMY_EN (BIT(2)) +#define SPI_SLV_WRBUF_DUMMY_EN (BIT(1)) +#define SPI_SLV_RDBUF_DUMMY_EN (BIT(0)) + +#define SPI_SLAVE2( i ) (REG_SPI_BASE( i ) + 0x40) +#define SPI_SLV_WRBUF_DUMMY_CYCLELEN 0x000000FF +#define SPI_SLV_WRBUF_DUMMY_CYCLELEN_S 24 +#define SPI_SLV_RDBUF_DUMMY_CYCLELEN 0x000000FF +#define SPI_SLV_RDBUF_DUMMY_CYCLELEN_S 16 +#define SPI_SLV_WRSTA_DUMMY_CYCLELEN 0x000000FF +#define SPI_SLV_WRSTA_DUMMY_CYCLELEN_S 8 +#define SPI_SLV_RDSTA_DUMMY_CYCLELEN 0x000000FF +#define SPI_SLV_RDSTA_DUMMY_CYCLELEN_S 0 + +#define SPI_SLAVE3( i ) (REG_SPI_BASE( i ) + 0x44) +#define SPI_SLV_WRSTA_CMD_VALUE 0x000000FF +#define SPI_SLV_WRSTA_CMD_VALUE_S 24 +#define SPI_SLV_RDSTA_CMD_VALUE 0x000000FF +#define SPI_SLV_RDSTA_CMD_VALUE_S 16 +#define SPI_SLV_WRBUF_CMD_VALUE 0x000000FF +#define SPI_SLV_WRBUF_CMD_VALUE_S 8 +#define SPI_SLV_RDBUF_CMD_VALUE 0x000000FF +#define SPI_SLV_RDBUF_CMD_VALUE_S 0 + +#define SPI_SLV_WRBUF_DLEN( i ) (REG_SPI_BASE( i ) + 0x48) +#define SPI_SLV_WRBUF_DBITLEN 0x00FFFFFF +#define SPI_SLV_WRBUF_DBITLEN_S 0 + +#define SPI_SLV_RDBUF_DLEN( i ) (REG_SPI_BASE( i ) + 0x4C) +#define SPI_SLV_RDBUF_DBITLEN 0x00FFFFFF +#define SPI_SLV_RDBUF_DBITLEN_S 0 + +#define SPI_CACHE_FCTRL( i ) (REG_SPI_BASE( i ) + 0x50) +#define SPI_CACHE_FLASH_PES_EN (BIT(3)) +#define SPI_CACHE_FLASH_USR_CMD (BIT(2)) +#define SPI_CACHE_USR_CMD_4BYTE (BIT(1)) +#define SPI_CACHE_REQ_EN (BIT(0)) + +#define SPI_CACHE_SCTRL( i ) (REG_SPI_BASE( i ) + 0x54) +#define SPI_CACHE_SRAM_USR_WCMD (BIT(28)) +#define SPI_SRAM_ADDR_BITLEN 0x0000003F +#define SPI_SRAM_ADDR_BITLEN_S 22 +#define SPI_SRAM_DUMMY_CYCLELEN 0x000000FF +#define SPI_SRAM_DUMMY_CYCLELEN_S 14 +#define SPI_SRAM_BYTES_LEN 0x000000FF +#define SPI_SRAM_BYTES_LEN_S 6 +#define SPI_CACHE_SRAM_USR_RCMD (BIT(5)) +#define SPI_USR_RD_SRAM_DUMMY (BIT(4)) +#define SPI_USR_WR_SRAM_DUMMY (BIT(3)) +#define SPI_USR_SRAM_QIO (BIT(2)) +#define SPI_USR_SRAM_DIO (BIT(1)) +#define SPI_SRAM_CMD( i ) (REG_SPI_BASE( i ) + 0x58) +#define SPI_SRAM_RSTIO (BIT(4)) +#define SPI_SRAM_QIO (BIT(1)) +#define SPI_SRAM_DIO (BIT(0)) + +#define SPI_SRAM_DRD_CMD( i ) (REG_SPI_BASE( i ) + 0x5C) +#define SPI_CACHE_SRAM_USR_RD_CMD_BITLEN 0x0000000F +#define SPI_CACHE_SRAM_USR_RD_CMD_BITLEN_S 28 +#define SPI_CACHE_SRAM_USR_RD_CMD_VALUE 0x0000FFFF +#define SPI_CACHE_SRAM_USR_RD_CMD_VALUE_S 0 + +#define SPI_SRAM_DWR_CMD( i ) (REG_SPI_BASE( i ) + 0x60) +#define SPI_CACHE_SRAM_USR_WR_CMD_BITLEN 0x0000000F +#define SPI_CACHE_SRAM_USR_WR_CMD_BITLEN_S 28 +#define SPI_CACHE_SRAM_USR_WR_CMD_VALUE 0x0000FFFF +#define SPI_CACHE_SRAM_USR_WR_CMD_VALUE_S 0 + +#define SPI_SLV_RD_BIT( i ) (REG_SPI_BASE( i ) + 0x64) +#define SPI_SLV_RDATA_BIT 0x00FFFFFF +#define SPI_SLV_RDATA_BIT_S 0 + +#define SPI_W0( i ) (REG_SPI_BASE( i ) + 0x80) +#define SPI_W1( i ) (REG_SPI_BASE( i ) + 0x84) +#define SPI_W2( i ) (REG_SPI_BASE( i ) + 0x88) +#define SPI_W3( i ) (REG_SPI_BASE( i ) + 0x8C) +#define SPI_W4( i ) (REG_SPI_BASE( i ) + 0x90) +#define SPI_W5( i ) (REG_SPI_BASE( i ) + 0x94) +#define SPI_W6( i ) (REG_SPI_BASE( i ) + 0x98) +#define SPI_W7( i ) (REG_SPI_BASE( i ) + 0x9C) +#define SPI_W8( i ) (REG_SPI_BASE( i ) + 0xA0) +#define SPI_W9( i ) (REG_SPI_BASE( i ) + 0xA4) +#define SPI_W10( i ) (REG_SPI_BASE( i ) + 0xA8) +#define SPI_W11( i ) (REG_SPI_BASE( i ) + 0xAC) +#define SPI_W12( i ) (REG_SPI_BASE( i ) + 0xB0) +#define SPI_W13( i ) (REG_SPI_BASE( i ) + 0xB4) +#define SPI_W14( i ) (REG_SPI_BASE( i ) + 0xB8) +#define SPI_W15( i ) (REG_SPI_BASE( i ) + 0xBC) +#define SPI_TX_CRC( i ) (REG_SPI_BASE( i ) + 0xC0) +#define SPI_EXT0( i ) (REG_SPI_BASE( i ) + 0xF0) +#define SPI_T_PP_ENA (BIT(31)) +#define SPI_T_PP_SHIFT 0x0000000F +#define SPI_T_PP_SHIFT_S 16 +#define SPI_T_PP_TIME 0x00000FFF +#define SPI_T_PP_TIME_S 0 + +#define SPI_EXT1( i ) (REG_SPI_BASE( i ) + 0xF4) +#define SPI_T_ERASE_ENA (BIT(31)) +#define SPI_T_ERASE_SHIFT 0x0000000F +#define SPI_T_ERASE_SHIFT_S 16 +#define SPI_T_ERASE_TIME 0x00000FFF +#define SPI_T_ERASE_TIME_S 0 + +#define SPI_EXT2( i ) (REG_SPI_BASE( i ) + 0xF8) +#define SPI_ST 0x00000007 +#define SPI_ST_S 0 + +#define SPI_EXT3( i ) (REG_SPI_BASE( i ) + 0xFC) +#define SPI_INT_HOLD_ENA 0x00000003 +#define SPI_INT_HOLD_ENA_S 0 + +#define SPI_DMA_CONF( i ) (REG_SPI_BASE( i ) + 0x100) +#define SPI_DMA_CONTINUE (BIT(16)) +#define SPI_DMA_TX_STOP (BIT(15)) +#define SPI_DMA_RX_STOP (BIT(14)) +#define SPI_OUT_DATA_BURST_EN (BIT(12)) +#define SPI_INDSCR_BURST_EN (BIT(11)) +#define SPI_OUTDSCR_BURST_EN (BIT(10)) +#define SPI_OUT_EOF_MODE (BIT(9)) +#define SPI_OUT_AUTO_WRBACK (BIT(8)) +#define SPI_OUT_LOOP_TEST (BIT(7)) +#define SPI_IN_LOOP_TEST (BIT(6)) +#define SPI_AHBM_RST (BIT(5)) +#define SPI_AHBM_FIFO_RST (BIT(4)) +#define SPI_OUT_RST (BIT(3)) +#define SPI_IN_RST (BIT(2)) +#define SPI_DMA_OUT_LINK( i ) (REG_SPI_BASE( i ) + 0x104) +#define SPI_OUTLINK_RESTART (BIT(30)) +#define SPI_OUTLINK_START (BIT(29)) +#define SPI_OUTLINK_STOP (BIT(28)) +#define SPI_OUTLINK_ADDR 0x000FFFFF +#define SPI_OUTLINK_ADDR_S 0 + +#define SPI_DMA_IN_LINK( i ) (REG_SPI_BASE( i ) + 0x108) +#define SPI_INLINK_RESTART (BIT(30)) +#define SPI_INLINK_START (BIT(29)) +#define SPI_INLINK_STOP (BIT(28)) +#define SPI_INLINK_AUTO_RET (BIT(20)) +#define SPI_INLINK_ADDR 0x000FFFFF +#define SPI_INLINK_ADDR_S 0 + +#define SPI_DMA_STATUS( i ) (REG_SPI_BASE( i ) + 0x10C) +#define SPI_DMA_TX_EN (BIT(1)) +#define SPI_DMA_RX_EN (BIT(0)) + +#define SPI_DMA_INT_ENA( i ) (REG_SPI_BASE( i ) + 0x110) +#define SPI_OUT_TOTAL_EOF_INT_ENA (BIT(8)) +#define SPI_OUT_EOF_INT_ENA (BIT(7)) +#define SPI_OUT_DONE_INT_ENA (BIT(6)) +#define SPI_IN_SUC_EOF_INT_ENA (BIT(5)) +#define SPI_IN_ERR_EOF_INT_ENA (BIT(4)) +#define SPI_IN_DONE_INT_ENA (BIT(3)) +#define SPI_INLINK_DSCR_ERROR_INT_ENA (BIT(2)) +#define SPI_OUTLINK_DSCR_ERROR_INT_ENA (BIT(1)) +#define SPI_INLINK_DSCR_EMPTY_INT_ENA (BIT(0)) + +#define SPI_DMA_INT_RAW( i ) (REG_SPI_BASE( i ) + 0x114) +#define SPI_OUT_TOTAL_EOF_INT_RAW (BIT(8)) +#define SPI_OUT_EOF_INT_RAW (BIT(7)) +#define SPI_OUT_DONE_INT_RAW (BIT(6)) +#define SPI_IN_SUC_EOF_INT_RAW (BIT(5)) +#define SPI_IN_ERR_EOF_INT_RAW (BIT(4)) +#define SPI_IN_DONE_INT_RAW (BIT(3)) +#define SPI_INLINK_DSCR_ERROR_INT_RAW (BIT(2)) +#define SPI_OUTLINK_DSCR_ERROR_INT_RAW (BIT(1)) +#define SPI_INLINK_DSCR_EMPTY_INT_RAW (BIT(0)) + +#define SPI_DMA_INT_ST( i ) (REG_SPI_BASE( i ) + 0x118) +#define SPI_OUT_TOTAL_EOF_INT_ST (BIT(8)) +#define SPI_OUT_EOF_INT_ST (BIT(7)) +#define SPI_OUT_DONE_INT_ST (BIT(6)) +#define SPI_IN_SUC_EOF_INT_ST (BIT(5)) +#define SPI_IN_ERR_EOF_INT_ST (BIT(4)) +#define SPI_IN_DONE_INT_ST (BIT(3)) +#define SPI_INLINK_DSCR_ERROR_INT_ST (BIT(2)) +#define SPI_OUTLINK_DSCR_ERROR_INT_ST (BIT(1)) +#define SPI_INLINK_DSCR_EMPTY_INT_ST (BIT(0)) + +#define SPI_DMA_INT_CLR( i ) (REG_SPI_BASE( i ) + 0x11C) +#define SPI_OUT_TOTAL_EOF_INT_CLR (BIT(8)) +#define SPI_OUT_EOF_INT_CLR (BIT(7)) +#define SPI_OUT_DONE_INT_CLR (BIT(6)) +#define SPI_IN_SUC_EOF_INT_CLR (BIT(5)) +#define SPI_IN_ERR_EOF_INT_CLR (BIT(4)) +#define SPI_IN_DONE_INT_CLR (BIT(3)) +#define SPI_INLINK_DSCR_ERROR_INT_CLR (BIT(2)) +#define SPI_OUTLINK_DSCR_ERROR_INT_CLR (BIT(1)) +#define SPI_INLINK_DSCR_EMPTY_INT_CLR (BIT(0)) + +#define SPI_IN_ERR_EOF_DES_ADDR( i ) (REG_SPI_BASE( i ) + 0x120) +#define SPI_IN_SUC_EOF_DES_ADDR( i ) (REG_SPI_BASE( i ) + 0x124) +#define SPI_INLINK_DSCR( i ) (REG_SPI_BASE( i ) + 0x128) +#define SPI_INLINK_DSCR_BF0( i ) (REG_SPI_BASE( i ) + 0x12C) +#define SPI_INLINK_DSCR_BF1( i ) (REG_SPI_BASE( i ) + 0x130) +#define SPI_OUT_EOF_BFR_DES_ADDR( i ) (REG_SPI_BASE( i ) + 0x134) +#define SPI_OUT_EOF_DES_ADDR( i ) (REG_SPI_BASE( i ) + 0x138) +#define SPI_OUTLINK_DSCR( i ) (REG_SPI_BASE( i ) + 0x13C) +#define SPI_OUTLINK_DSCR_BF0( i ) (REG_SPI_BASE( i ) + 0x140) +#define SPI_OUTLINK_DSCR_BF1( i ) (REG_SPI_BASE( i ) + 0x144) +#define SPI_DMA_RSTATUS( i ) (REG_SPI_BASE( i ) + 0x148) +#define SPI_DMA_TSTATUS( i ) (REG_SPI_BASE( i ) + 0x14C) +#define SPI_REG_DATE( i ) (REG_SPI_BASE( i ) + 0x3FC) +#define SPI_DATE 0x0FFFFFFF +#define SPI_DATE_S 0 +#define SPI_DATE_VERSION 0x1604290 + +#endif /* _SOC_SPI_REG_H_ */ diff --git a/components/esp32/include/soc/timers_reg.h b/components/esp32/include/soc/timers_reg.h new file mode 100644 index 000000000..577f375aa --- /dev/null +++ b/components/esp32/include/soc/timers_reg.h @@ -0,0 +1,288 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_TIMERS_REG_H_ +#define _SOC_TIMER_REG_H_ + +#include "soc.h" + +#define T0CONFIG (DR_REG_TIMERS_BASE + 0x0000) +#define TIMERS_T0_EN (BIT(31)) +#define TIMERS_T0_EN_S 31 +#define TIMERS_T0_INCREASE (BIT(30)) +#define TIMERS_T0_INCREASE_S 30 +#define TIMERS_T0_AUTORELOAD (BIT(29)) +#define TIMERS_T0_AUTORELOAD_S 29 +#define TIMERS_T0_DIVIDER 0x0000FFFF +#define TIMERS_T0_DIVIDER_S 13 +#define TIMERS_T0_EDGE_INT_EN (BIT(12)) +#define TIMERS_T0_EDGE_INT_EN_S 12 +#define TIMERS_T0_LEVEL_INT_EN (BIT(11)) +#define TIMERS_T0_LEVEL_INT_EN_S 11 +#define TIMERS_T0_ALARM_EN (BIT(10)) +#define TIMERS_T0_ALARM_EN_S 10 + +#define T0LO (DR_REG_TIMERS_BASE + 0x0004) +#define TIMERS_T0_LO 0xFFFFFFFF +#define TIMERS_T0_LO_S 0 + +#define T0HI (DR_REG_TIMERS_BASE + 0x0008) +#define TIMERS_T0_HI 0xFFFFFFFF +#define TIMERS_T0_HI_S 0 + +#define T0UPDATE (DR_REG_TIMERS_BASE + 0x000c) +#define TIMERS_T0_UPDATE 0xFFFFFFFF +#define TIMERS_T0_UPDATE_S 0 + +#define T0ALARMLO (DR_REG_TIMERS_BASE + 0x0010) +#define TIMERS_T0_ALARM_LO 0xFFFFFFFF +#define TIMERS_T0_ALARM_LO_S 0 + +#define T0ALARMHI (DR_REG_TIMERS_BASE + 0x0014) +#define TIMERS_T0_ALARM_HI 0xFFFFFFFF +#define TIMERS_T0_ALARM_HI_S 0 + +#define T0LOADLO (DR_REG_TIMERS_BASE + 0x0018) +#define TIMERS_T0_LOAD_LO 0xFFFFFFFF +#define TIMERS_T0_LOAD_LO_S 0 + +#define T0LOADHI (DR_REG_TIMERS_BASE + 0x001c) +#define TIMERS_T0_LOAD_HI 0xFFFFFFFF +#define TIMERS_T0_LOAD_HI_S 0 + +#define T0LOAD (DR_REG_TIMERS_BASE + 0x0020) +#define TIMERS_T0_LOAD 0xFFFFFFFF +#define TIMERS_T0_LOAD_S 0 + +#define T1CONFIG (DR_REG_TIMERS_BASE + 0x0024) +#define TIMERS_T1_EN (BIT(31)) +#define TIMERS_T1_EN_S 31 +#define TIMERS_T1_INCREASE (BIT(30)) +#define TIMERS_T1_INCREASE_S 30 +#define TIMERS_T1_AUTORELOAD (BIT(29)) +#define TIMERS_T1_AUTORELOAD_S 29 +#define TIMERS_T1_DIVIDER 0x0000FFFF +#define TIMERS_T1_DIVIDER_S 13 +#define TIMERS_T1_EDGE_INT_EN (BIT(12)) +#define TIMERS_T1_EDGE_INT_EN_S 12 +#define TIMERS_T1_LEVEL_INT_EN (BIT(11)) +#define TIMERS_T1_LEVEL_INT_EN_S 11 +#define TIMERS_T1_ALARM_EN (BIT(10)) +#define TIMERS_T1_ALARM_EN_S 10 + +#define T1LO (DR_REG_TIMERS_BASE + 0x0028) +#define TIMERS_T1_LO 0xFFFFFFFF +#define TIMERS_T1_LO_S 0 + +#define T1HI (DR_REG_TIMERS_BASE + 0x002c) +#define TIMERS_T1_HI 0xFFFFFFFF +#define TIMERS_T1_HI_S 0 + +#define T1UPDATE (DR_REG_TIMERS_BASE + 0x0030) +#define TIMERS_T1_UPDATE 0xFFFFFFFF +#define TIMERS_T1_UPDATE_S 0 + +#define T1ALARMLO (DR_REG_TIMERS_BASE + 0x0034) +#define TIMERS_T1_ALARM_LO 0xFFFFFFFF +#define TIMERS_T1_ALARM_LO_S 0 + +#define T1ALARMHI (DR_REG_TIMERS_BASE + 0x0038) +#define TIMERS_T1_ALARM_HI 0xFFFFFFFF +#define TIMERS_T1_ALARM_HI_S 0 + +#define T1LOADLO (DR_REG_TIMERS_BASE + 0x003c) +#define TIMERS_T1_LOAD_LO 0xFFFFFFFF +#define TIMERS_T1_LOAD_LO_S 0 + +#define T1LOADHI (DR_REG_TIMERS_BASE + 0x0040) +#define TIMERS_T1_LOAD_HI 0xFFFFFFFF +#define TIMERS_T1_LOAD_HI_S 0 + +#define T1LOAD (DR_REG_TIMERS_BASE + 0x0044) +#define TIMERS_T1_LOAD 0xFFFFFFFF +#define TIMERS_T1_LOAD_S 0 + +#define WDTCONFIG0 (DR_REG_TIMERS_BASE + 0x0048) +#define TIMERS_WDT_EN (BIT(31)) +#define TIMERS_WDT_EN_S 31 +#define TIMERS_WDT_STG0 0x00000003 +#define TIMERS_WDT_STG0_S 29 +#define TIMERS_WDT_STG1 0x00000003 +#define TIMERS_WDT_STG1_S 27 +#define TIMERS_WDT_STG2 0x00000003 +#define TIMERS_WDT_STG2_S 25 +#define TIMERS_WDT_STG3 0x00000003 +#define TIMERS_WDT_STG3_S 23 +#define TIMERS_WDT_EDGE_INT_EN (BIT(22)) +#define TIMERS_WDT_EDGE_INT_EN_S 22 +#define TIMERS_WDT_LEVEL_INT_EN (BIT(21)) +#define TIMERS_WDT_LEVEL_INT_EN_S 21 +#define TIMERS_WDT_CPU_RESET_LENGTH 0x00000007 +#define TIMERS_WDT_CPU_RESET_LENGTH_S 18 +#define TIMERS_WDT_SYS_RESET_LENGTH 0x00000007 +#define TIMERS_WDT_SYS_RESET_LENGTH_S 15 +#define TIMERS_WDT_FLASHBOOT_MOD_EN (BIT(14)) +#define TIMERS_WDT_FLASHBOOT_MOD_EN_S 14 + +#define WDTCONFIG1 (DR_REG_TIMERS_BASE + 0x004c) +#define TIMERS_WDT_CLK_PRESCALE 0x0000FFFF +#define TIMERS_WDT_CLK_PRESCALE_S 16 + +#define WDTCONFIG2 (DR_REG_TIMERS_BASE + 0x0050) +#define TIMERS_WDT_STG0_HOLD 0xFFFFFFFF +#define TIMERS_WDT_STG0_HOLD_S 0 + +#define WDTCONFIG3 (DR_REG_TIMERS_BASE + 0x0054) +#define TIMERS_WDT_STG1_HOLD 0xFFFFFFFF +#define TIMERS_WDT_STG1_HOLD_S 0 + +#define WDTCONFIG4 (DR_REG_TIMERS_BASE + 0x0058) +#define TIMERS_WDT_STG2_HOLD 0xFFFFFFFF +#define TIMERS_WDT_STG2_HOLD_S 0 + +#define WDTCONFIG5 (DR_REG_TIMERS_BASE + 0x005c) +#define TIMERS_WDT_STG3_HOLD 0xFFFFFFFF +#define TIMERS_WDT_STG3_HOLD_S 0 + +#define WDTFEED (DR_REG_TIMERS_BASE + 0x0060) +#define TIMERS_WDT_FEED 0xFFFFFFFF +#define TIMERS_WDT_FEED_S 0 + +#define WDTWPROTECT (DR_REG_TIMERS_BASE + 0x0064) +#define TIMERS_WDT_WKEY 0xFFFFFFFF +#define TIMERS_WDT_WKEY_S 0 + +#define RTCCALICFG (DR_REG_TIMERS_BASE + 0x0068) +#define TIMERS_RTC_CALI_START (BIT(31)) +#define TIMERS_RTC_CALI_START_S 31 +#define TIMERS_RTC_CALI_MAX 0x00007FFF +#define TIMERS_RTC_CALI_MAX_S 16 +#define TIMERS_RTC_CALI_RDY (BIT(15)) +#define TIMERS_RTC_CALI_RDY_S 15 +#define TIMERS_RTC_CALI_CLK_SEL 0x00000003 +#define TIMERS_RTC_CALI_CLK_SEL_S 13 +#define TIMERS_RTC_CALI_START_CYCLING (BIT(12)) +#define TIMERS_RTC_CALI_START_CYCLING_S 12 + +#define RTCCALICFG1 (DR_REG_TIMERS_BASE + 0x006c) +#define TIMERS_RTC_CALI_VALUE 0x01FFFFFF +#define TIMERS_RTC_CALI_VALUE_S 7 + +#define LACTCONFIG (DR_REG_TIMERS_BASE + 0x0070) +#define TIMERS_LACT_EN (BIT(31)) +#define TIMERS_LACT_EN_S 31 +#define TIMERS_LACT_INCREASE (BIT(30)) +#define TIMERS_LACT_INCREASE_S 30 +#define TIMERS_LACT_AUTORELOAD (BIT(29)) +#define TIMERS_LACT_AUTORELOAD_S 29 +#define TIMERS_LACT_DIVIDER 0x0000FFFF +#define TIMERS_LACT_DIVIDER_S 13 +#define TIMERS_LACT_EDGE_INT_EN (BIT(12)) +#define TIMERS_LACT_EDGE_INT_EN_S 12 +#define TIMERS_LACT_LEVEL_INT_EN (BIT(11)) +#define TIMERS_LACT_LEVEL_INT_EN_S 11 +#define TIMERS_LACT_ALARM_EN (BIT(10)) +#define TIMERS_LACT_ALARM_EN_S 10 +#define TIMERS_LACT_LAC_EN (BIT(9)) +#define TIMERS_LACT_LAC_EN_S 9 +#define TIMERS_LACT_CPST_EN (BIT(8)) +#define TIMERS_LACT_CPST_EN_S 8 +#define TIMERS_LACT_RTC_ONLY (BIT(7)) +#define TIMERS_LACT_RTC_ONLY_S 7 + +#define LACTRTC (DR_REG_TIMERS_BASE + 0x0074) +#define TIMERS_LACT_RTC_STEP_LEN 0x03FFFFFF +#define TIMERS_LACT_RTC_STEP_LEN_S 6 + +#define LACTLO (DR_REG_TIMERS_BASE + 0x0078) +#define TIMERS_LACT_LO 0xFFFFFFFF +#define TIMERS_LACT_LO_S 0 + +#define LACTHI (DR_REG_TIMERS_BASE + 0x007c) +#define TIMERS_LACT_HI 0xFFFFFFFF +#define TIMERS_LACT_HI_S 0 + +#define LACTUPDATE (DR_REG_TIMERS_BASE + 0x0080) +#define TIMERS_LACT_UPDATE 0xFFFFFFFF +#define TIMERS_LACT_UPDATE_S 0 + +#define LACTALARMLO (DR_REG_TIMERS_BASE + 0x0084) +#define TIMERS_LACT_ALARM_LO 0xFFFFFFFF +#define TIMERS_LACT_ALARM_LO_S 0 + +#define LACTALARMHI (DR_REG_TIMERS_BASE + 0x0088) +#define TIMERS_LACT_ALARM_HI 0xFFFFFFFF +#define TIMERS_LACT_ALARM_HI_S 0 + +#define LACTLOADLO (DR_REG_TIMERS_BASE + 0x008c) +#define TIMERS_LACT_LOAD_LO 0xFFFFFFFF +#define TIMERS_LACT_LOAD_LO_S 0 + +#define LACTLOADHI (DR_REG_TIMERS_BASE + 0x0090) +#define TIMERS_LACT_LOAD_HI 0xFFFFFFFF +#define TIMERS_LACT_LOAD_HI_S 0 + +#define LACTLOAD (DR_REG_TIMERS_BASE + 0x0094) +#define TIMERS_LACT_LOAD 0xFFFFFFFF +#define TIMERS_LACT_LOAD_S 0 + +#define INT_ENA_TIMERS (DR_REG_TIMERS_BASE + 0x0098) +#define TIMERS_LACT_INT_ENA (BIT(3)) +#define TIMERS_LACT_INT_ENA_S 3 +#define TIMERS_WDT_INT_ENA (BIT(2)) +#define TIMERS_WDT_INT_ENA_S 2 +#define TIMERS_T1_INT_ENA (BIT(1)) +#define TIMERS_T1_INT_ENA_S 1 +#define TIMERS_T0_INT_ENA (BIT(0)) +#define TIMERS_T0_INT_ENA_S 0 + +#define INT_RAW_TIMERS (DR_REG_TIMERS_BASE + 0x009c) +#define TIMERS_LACT_INT_RAW (BIT(3)) +#define TIMERS_LACT_INT_RAW_S 3 +#define TIMERS_WDT_INT_RAW (BIT(2)) +#define TIMERS_WDT_INT_RAW_S 2 +#define TIMERS_T1_INT_RAW (BIT(1)) +#define TIMERS_T1_INT_RAW_S 1 +#define TIMERS_T0_INT_RAW (BIT(0)) +#define TIMERS_T0_INT_RAW_S 0 + +#define INT_ST_TIMERS (DR_REG_TIMERS_BASE + 0x00a0) +#define TIMERS_LACT_INT_ST (BIT(3)) +#define TIMERS_LACT_INT_ST_S 3 +#define TIMERS_WDT_INT_ST (BIT(2)) +#define TIMERS_WDT_INT_ST_S 2 +#define TIMERS_T1_INT_ST (BIT(1)) +#define TIMERS_T1_INT_ST_S 1 +#define TIMERS_T0_INT_ST (BIT(0)) +#define TIMERS_T0_INT_ST_S 0 + +#define INT_CLR_TIMERS (DR_REG_TIMERS_BASE + 0x00a4) +#define TIMERS_LACT_INT_CLR (BIT(3)) +#define TIMERS_LACT_INT_CLR_S 3 +#define TIMERS_WDT_INT_CLR (BIT(2)) +#define TIMERS_WDT_INT_CLR_S 2 +#define TIMERS_T1_INT_CLR (BIT(1)) +#define TIMERS_T1_INT_CLR_S 1 +#define TIMERS_T0_INT_CLR (BIT(0)) +#define TIMERS_T0_INT_CLR_S 0 + +#define NTIMERS_DATE (DR_REG_TIMERS_BASE + 0x00f8) +#define TIMERS_NTIMERS_DATE 0x0FFFFFFF +#define TIMERS_NTIMERS_DATE_S 0 +#define TIMERS_NTIMERS_DATE_VERSION 0x1604290 + +#define REGCLK (DR_REG_TIMERS_BASE + 0x00fc) +#define TIMERS_CLK_EN (BIT(31)) +#define TIMERS_CLK_EN_S 31 + +#endif /* _SOC_TIMER_REG_H_ */ diff --git a/components/esp32/include/soc/uart_register.h b/components/esp32/include/soc/uart_register.h new file mode 100644 index 000000000..91bd4ddc8 --- /dev/null +++ b/components/esp32/include/soc/uart_register.h @@ -0,0 +1,1399 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_UART_REG_H_ +#define _SOC_UART_REG_H_ + +#include "soc.h" + +//Slow bus +//#define REG_UART_BASE( i ) (0x60000000+(i)*0x10000) +//Fast bus +#define REG_UART_BASE( i ) (0x3ff40000+(i)*0x10000) + +#define UART_FIFO_REG(i) (REG_UART_BASE(i) + 0x0) + /* UART_RXFIFO_RD_BYTE : RO ;bitpos:[7:0] ;default: 8'b0 ; */ + /*description: R/W share the same address*/ + #define UART_RXFIFO_RD_BYTE 0x000000FF + #define UART_RXFIFO_RD_BYTE_M ((UART_RXFIFO_RD_BYTE_V)<<(UART_RXFIFO_RD_BYTE_S)) + #define UART_RXFIFO_RD_BYTE_V 0xFF + #define UART_RXFIFO_RD_BYTE_S 0 + #define UART_GET_RXFIFO_RD_BYTE(i) GET_PERI_REG_BITS2(UART_FIFO_REG(i) , UART_RXFIFO_RD_BYTE_V, UART_RXFIFO_RD_BYTE_S) + #define UART_SET_TXFIFO_WR_BYTE(i,val) SET_PERI_REG_BITS(UART_FIFO_REG(i) , UART_RXFIFO_RD_BYTE_V, val, UART_RXFIFO_RD_BYTE_S) + + + +#define UART_INT_RAW_REG(i) (REG_UART_BASE(i) + 0x4) + /* UART_AT_CMD_CHAR_DET_INT_RAW : RO ;bitpos:[18] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for detecting AT_CMD char interrupt*/ + #define UART_AT_CMD_CHAR_DET_INT_RAW (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_RAW_M (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_RAW_V 0x1 + #define UART_AT_CMD_CHAR_DET_INT_RAW_S 18 + /* UART_RS485_CLASH_INT_RAW : RO ;bitpos:[17] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rs485 tx rx clash interrrupt*/ + #define UART_RS485_CLASH_INT_RAW (BIT(17)) + #define UART_RS485_CLASH_INT_RAW_M (BIT(17)) + #define UART_RS485_CLASH_INT_RAW_V 0x1 + #define UART_RS485_CLASH_INT_RAW_S 17 + /* UART_RS485_FRM_ERR_INT_RAW : RO ;bitpos:[16] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rs485 other rx error*/ + #define UART_RS485_FRM_ERR_INT_RAW (BIT(16)) + #define UART_RS485_FRM_ERR_INT_RAW_M (BIT(16)) + #define UART_RS485_FRM_ERR_INT_RAW_V 0x1 + #define UART_RS485_FRM_ERR_INT_RAW_S 16 + /* UART_RS485_PARITY_ERR_INT_RAW : RO ;bitpos:[15] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rs485 parity error*/ + #define UART_RS485_PARITY_ERR_INT_RAW (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_RAW_M (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_RAW_V 0x1 + #define UART_RS485_PARITY_ERR_INT_RAW_S 15 + /* UART_TX_DONE_INT_RAW : RO ;bitpos:[14] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for tx done*/ + #define UART_TX_DONE_INT_RAW (BIT(14)) + #define UART_TX_DONE_INT_RAW_M (BIT(14)) + #define UART_TX_DONE_INT_RAW_V 0x1 + #define UART_TX_DONE_INT_RAW_S 14 + /* UART_TX_BRK_IDLE_DONE_INT_RAW : RO ;bitpos:[13] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for tx send idle done(depends on the uart_tx_idle_num)*/ + #define UART_TX_BRK_IDLE_DONE_INT_RAW (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_RAW_M (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_RAW_V 0x1 + #define UART_TX_BRK_IDLE_DONE_INT_RAW_S 13 + /* UART_TX_BRK_DONE_INT_RAW : RO ;bitpos:[12] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for send 0 done(depends on uart_tx_brk_num)*/ + #define UART_TX_BRK_DONE_INT_RAW (BIT(12)) + #define UART_TX_BRK_DONE_INT_RAW_M (BIT(12)) + #define UART_TX_BRK_DONE_INT_RAW_V 0x1 + #define UART_TX_BRK_DONE_INT_RAW_S 12 + /* UART_GLITCH_DET_INT_RAW : RO ;bitpos:[11] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for detecting rx glitch pulse*/ + #define UART_GLITCH_DET_INT_RAW (BIT(11)) + #define UART_GLITCH_DET_INT_RAW_M (BIT(11)) + #define UART_GLITCH_DET_INT_RAW_V 0x1 + #define UART_GLITCH_DET_INT_RAW_S 11 + /* UART_SW_XOFF_INT_RAW : RO ;bitpos:[10] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rx receive xoff char(depends on the uart_xoff_char )*/ + #define UART_SW_XOFF_INT_RAW (BIT(10)) + #define UART_SW_XOFF_INT_RAW_M (BIT(10)) + #define UART_SW_XOFF_INT_RAW_V 0x1 + #define UART_SW_XOFF_INT_RAW_S 10 + /* UART_SW_XON_INT_RAW : RO ;bitpos:[9] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rx receive xon char(depends on the uart_xon_char )*/ + #define UART_SW_XON_INT_RAW (BIT(9)) + #define UART_SW_XON_INT_RAW_M (BIT(9)) + #define UART_SW_XON_INT_RAW_V 0x1 + #define UART_SW_XON_INT_RAW_S 9 + /* UART_RXFIFO_TOUT_INT_RAW : RO ;bitpos:[8] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for Rx time-out interrupt(depands on the UART_RX_TOUT_THRHD)*/ + #define UART_RXFIFO_TOUT_INT_RAW (BIT(8)) + #define UART_RXFIFO_TOUT_INT_RAW_M (BIT(8)) + #define UART_RXFIFO_TOUT_INT_RAW_V 0x1 + #define UART_RXFIFO_TOUT_INT_RAW_S 8 + /* UART_BRK_DET_INT_RAW : RO ;bitpos:[7] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for Rx byte start error*/ + #define UART_BRK_DET_INT_RAW (BIT(7)) + #define UART_BRK_DET_INT_RAW_M (BIT(7)) + #define UART_BRK_DET_INT_RAW_V 0x1 + #define UART_BRK_DET_INT_RAW_S 7 + /* UART_CTS_CHG_INT_RAW : RO ;bitpos:[6] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for CTS changing level*/ + #define UART_CTS_CHG_INT_RAW (BIT(6)) + #define UART_CTS_CHG_INT_RAW_M (BIT(6)) + #define UART_CTS_CHG_INT_RAW_V 0x1 + #define UART_CTS_CHG_INT_RAW_S 6 + /* UART_DSR_CHG_INT_RAW : RO ;bitpos:[5] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for DSR changing level*/ + #define UART_DSR_CHG_INT_RAW (BIT(5)) + #define UART_DSR_CHG_INT_RAW_M (BIT(5)) + #define UART_DSR_CHG_INT_RAW_V 0x1 + #define UART_DSR_CHG_INT_RAW_S 5 + /* UART_RXFIFO_OVF_INT_RAW : RO ;bitpos:[4] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rx fifo overflow*/ + #define UART_RXFIFO_OVF_INT_RAW (BIT(4)) + #define UART_RXFIFO_OVF_INT_RAW_M (BIT(4)) + #define UART_RXFIFO_OVF_INT_RAW_V 0x1 + #define UART_RXFIFO_OVF_INT_RAW_S 4 + /* UART_FRM_ERR_INT_RAW : RO ;bitpos:[3] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for other rx error*/ + #define UART_FRM_ERR_INT_RAW (BIT(3)) + #define UART_FRM_ERR_INT_RAW_M (BIT(3)) + #define UART_FRM_ERR_INT_RAW_V 0x1 + #define UART_FRM_ERR_INT_RAW_S 3 + /* UART_PARITY_ERR_INT_RAW : RO ;bitpos:[2] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for parity check error*/ + #define UART_PARITY_ERR_INT_RAW (BIT(2)) + #define UART_PARITY_ERR_INT_RAW_M (BIT(2)) + #define UART_PARITY_ERR_INT_RAW_V 0x1 + #define UART_PARITY_ERR_INT_RAW_S 2 + /* UART_TXFIFO_EMPTY_INT_RAW : RO ;bitpos:[1] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for tx fifo empty interrupt(depands on UART_TXFIFO_EMPTY_THRHD bits)*/ + #define UART_TXFIFO_EMPTY_INT_RAW (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_RAW_M (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_RAW_V 0x1 + #define UART_TXFIFO_EMPTY_INT_RAW_S 1 + /* UART_RXFIFO_FULL_INT_RAW : RO ;bitpos:[0] ;default: 1'b0 ; */ + /*description: The interrupt raw bit for rx fifo full interrupt(depands on UART_RXFIFO_FULL_THRHD bits)*/ + #define UART_RXFIFO_FULL_INT_RAW (BIT(0)) + #define UART_RXFIFO_FULL_INT_RAW_M (BIT(0)) + #define UART_RXFIFO_FULL_INT_RAW_V 0x1 + #define UART_RXFIFO_FULL_INT_RAW_S 0 + #define UART_GET_AT_CMD_CHAR_DET_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_AT_CMD_CHAR_DET_INT_RAW_V, UART_AT_CMD_CHAR_DET_INT_RAW_S) + #define UART_GET_RS485_CLASH_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RS485_CLASH_INT_RAW_V, UART_RS485_CLASH_INT_RAW_S) + #define UART_GET_RS485_FRM_ERR_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RS485_FRM_ERR_INT_RAW_V, UART_RS485_FRM_ERR_INT_RAW_S) + #define UART_GET_RS485_PARITY_ERR_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RS485_PARITY_ERR_INT_RAW_V, UART_RS485_PARITY_ERR_INT_RAW_S) + #define UART_GET_TX_DONE_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_TX_DONE_INT_RAW_V, UART_TX_DONE_INT_RAW_S) + #define UART_GET_TX_BRK_IDLE_DONE_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_TX_BRK_IDLE_DONE_INT_RAW_V, UART_TX_BRK_IDLE_DONE_INT_RAW_S) + #define UART_GET_TX_BRK_DONE_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_TX_BRK_DONE_INT_RAW_V, UART_TX_BRK_DONE_INT_RAW_S) + #define UART_GET_GLITCH_DET_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_GLITCH_DET_INT_RAW_V, UART_GLITCH_DET_INT_RAW_S) + #define UART_GET_SW_XOFF_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_SW_XOFF_INT_RAW_V, UART_SW_XOFF_INT_RAW_S) + #define UART_GET_SW_XON_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_SW_XON_INT_RAW_V, UART_SW_XON_INT_RAW_S) + #define UART_GET_RXFIFO_TOUT_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RXFIFO_TOUT_INT_RAW_V, UART_RXFIFO_TOUT_INT_RAW_S) + #define UART_GET_BRK_DET_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_BRK_DET_INT_RAW_V, UART_BRK_DET_INT_RAW_S) + #define UART_GET_CTS_CHG_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_CTS_CHG_INT_RAW_V, UART_CTS_CHG_INT_RAW_S) + #define UART_GET_DSR_CHG_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_DSR_CHG_INT_RAW_V, UART_DSR_CHG_INT_RAW_S) + #define UART_GET_RXFIFO_OVF_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RXFIFO_OVF_INT_RAW_V, UART_RXFIFO_OVF_INT_RAW_S) + #define UART_GET_FRM_ERR_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_FRM_ERR_INT_RAW_V, UART_FRM_ERR_INT_RAW_S) + #define UART_GET_PARITY_ERR_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_PARITY_ERR_INT_RAW_V, UART_PARITY_ERR_INT_RAW_S) + #define UART_GET_TXFIFO_EMPTY_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_TXFIFO_EMPTY_INT_RAW_V, UART_TXFIFO_EMPTY_INT_RAW_S) + #define UART_GET_RXFIFO_FULL_INT_RAW(i) GET_PERI_REG_BITS2(UART_INT_RAW_REG(i) , UART_RXFIFO_FULL_INT_RAW_V, UART_RXFIFO_FULL_INT_RAW_S) + + + +#define UART_INT_ST_REG(i) (REG_UART_BASE(i) + 0x8) + /* UART_AT_CMD_CHAR_DET_INT_ST : RO ;bitpos:[18] ;default: 1'b0 ; */ + /*description: The interrupt state bit for detecting AT_CMD char interrupt*/ + #define UART_AT_CMD_CHAR_DET_INT_ST (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_ST_M (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_ST_V 0x1 + #define UART_AT_CMD_CHAR_DET_INT_ST_S 18 + /* UART_RS485_CLASH_INT_ST : RO ;bitpos:[17] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rs485 tx rx clash interrrupt*/ + #define UART_RS485_CLASH_INT_ST (BIT(17)) + #define UART_RS485_CLASH_INT_ST_M (BIT(17)) + #define UART_RS485_CLASH_INT_ST_V 0x1 + #define UART_RS485_CLASH_INT_ST_S 17 + /* UART_RS485_FRM_ERR_INT_ST : RO ;bitpos:[16] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rs485 other rx error*/ + #define UART_RS485_FRM_ERR_INT_ST (BIT(16)) + #define UART_RS485_FRM_ERR_INT_ST_M (BIT(16)) + #define UART_RS485_FRM_ERR_INT_ST_V 0x1 + #define UART_RS485_FRM_ERR_INT_ST_S 16 + /* UART_RS485_PARITY_ERR_INT_ST : RO ;bitpos:[15] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rs485 parity error*/ + #define UART_RS485_PARITY_ERR_INT_ST (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_ST_M (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_ST_V 0x1 + #define UART_RS485_PARITY_ERR_INT_ST_S 15 + /* UART_TX_DONE_INT_ST : RO ;bitpos:[14] ;default: 1'b0 ; */ + /*description: The interrupt state bit for tx done event*/ + #define UART_TX_DONE_INT_ST (BIT(14)) + #define UART_TX_DONE_INT_ST_M (BIT(14)) + #define UART_TX_DONE_INT_ST_V 0x1 + #define UART_TX_DONE_INT_ST_S 14 + /* UART_TX_BRK_IDLE_DONE_INT_ST : RO ;bitpos:[13] ;default: 1'b0 ; */ + /*description: The interrupt state bit for tx send idle done event*/ + #define UART_TX_BRK_IDLE_DONE_INT_ST (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_ST_M (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_ST_V 0x1 + #define UART_TX_BRK_IDLE_DONE_INT_ST_S 13 + /* UART_TX_BRK_DONE_INT_ST : RO ;bitpos:[12] ;default: 1'b0 ; */ + /*description: The interrupt state bit for send 0 done event*/ + #define UART_TX_BRK_DONE_INT_ST (BIT(12)) + #define UART_TX_BRK_DONE_INT_ST_M (BIT(12)) + #define UART_TX_BRK_DONE_INT_ST_V 0x1 + #define UART_TX_BRK_DONE_INT_ST_S 12 + /* UART_GLITCH_DET_INT_ST : RO ;bitpos:[11] ;default: 1'b0 ; */ + /*description: The interrupt state bit for detecting rx glitch pulse event*/ + #define UART_GLITCH_DET_INT_ST (BIT(11)) + #define UART_GLITCH_DET_INT_ST_M (BIT(11)) + #define UART_GLITCH_DET_INT_ST_V 0x1 + #define UART_GLITCH_DET_INT_ST_S 11 + /* UART_SW_XOFF_INT_ST : RO ;bitpos:[10] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rx receive xoff char event*/ + #define UART_SW_XOFF_INT_ST (BIT(10)) + #define UART_SW_XOFF_INT_ST_M (BIT(10)) + #define UART_SW_XOFF_INT_ST_V 0x1 + #define UART_SW_XOFF_INT_ST_S 10 + /* UART_SW_XON_INT_ST : RO ;bitpos:[9] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rx receive xon char event*/ + #define UART_SW_XON_INT_ST (BIT(9)) + #define UART_SW_XON_INT_ST_M (BIT(9)) + #define UART_SW_XON_INT_ST_V 0x1 + #define UART_SW_XON_INT_ST_S 9 + /* UART_RXFIFO_TOUT_INT_ST : RO ;bitpos:[8] ;default: 1'b0 ; */ + /*description: The interrupt state bit for Rx time-out event*/ + #define UART_RXFIFO_TOUT_INT_ST (BIT(8)) + #define UART_RXFIFO_TOUT_INT_ST_M (BIT(8)) + #define UART_RXFIFO_TOUT_INT_ST_V 0x1 + #define UART_RXFIFO_TOUT_INT_ST_S 8 + /* UART_BRK_DET_INT_ST : RO ;bitpos:[7] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rx byte start error*/ + #define UART_BRK_DET_INT_ST (BIT(7)) + #define UART_BRK_DET_INT_ST_M (BIT(7)) + #define UART_BRK_DET_INT_ST_V 0x1 + #define UART_BRK_DET_INT_ST_S 7 + /* UART_CTS_CHG_INT_ST : RO ;bitpos:[6] ;default: 1'b0 ; */ + /*description: The interrupt state bit for CTS changing level*/ + #define UART_CTS_CHG_INT_ST (BIT(6)) + #define UART_CTS_CHG_INT_ST_M (BIT(6)) + #define UART_CTS_CHG_INT_ST_V 0x1 + #define UART_CTS_CHG_INT_ST_S 6 + /* UART_DSR_CHG_INT_ST : RO ;bitpos:[5] ;default: 1'b0 ; */ + /*description: The interrupt state bit for DSR changing level*/ + #define UART_DSR_CHG_INT_ST (BIT(5)) + #define UART_DSR_CHG_INT_ST_M (BIT(5)) + #define UART_DSR_CHG_INT_ST_V 0x1 + #define UART_DSR_CHG_INT_ST_S 5 + /* UART_RXFIFO_OVF_INT_ST : RO ;bitpos:[4] ;default: 1'b0 ; */ + /*description: The interrupt state bit for RX fifo overflow*/ + #define UART_RXFIFO_OVF_INT_ST (BIT(4)) + #define UART_RXFIFO_OVF_INT_ST_M (BIT(4)) + #define UART_RXFIFO_OVF_INT_ST_V 0x1 + #define UART_RXFIFO_OVF_INT_ST_S 4 + /* UART_FRM_ERR_INT_ST : RO ;bitpos:[3] ;default: 1'b0 ; */ + /*description: The interrupt state for other rx error*/ + #define UART_FRM_ERR_INT_ST (BIT(3)) + #define UART_FRM_ERR_INT_ST_M (BIT(3)) + #define UART_FRM_ERR_INT_ST_V 0x1 + #define UART_FRM_ERR_INT_ST_S 3 + /* UART_PARITY_ERR_INT_ST : RO ;bitpos:[2] ;default: 1'b0 ; */ + /*description: The interrupt state bit for rx parity error*/ + #define UART_PARITY_ERR_INT_ST (BIT(2)) + #define UART_PARITY_ERR_INT_ST_M (BIT(2)) + #define UART_PARITY_ERR_INT_ST_V 0x1 + #define UART_PARITY_ERR_INT_ST_S 2 + /* UART_TXFIFO_EMPTY_INT_ST : RO ;bitpos:[1] ;default: 1'b0 ; */ + /*description: The interrupt state bit for TX fifo empty*/ + #define UART_TXFIFO_EMPTY_INT_ST (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_ST_M (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_ST_V 0x1 + #define UART_TXFIFO_EMPTY_INT_ST_S 1 + /* UART_RXFIFO_FULL_INT_ST : RO ;bitpos:[0] ;default: 1'b0 ; */ + /*description: The interrupt state bit for RX fifo full event*/ + #define UART_RXFIFO_FULL_INT_ST (BIT(0)) + #define UART_RXFIFO_FULL_INT_ST_M (BIT(0)) + #define UART_RXFIFO_FULL_INT_ST_V 0x1 + #define UART_RXFIFO_FULL_INT_ST_S 0 + #define UART_GET_AT_CMD_CHAR_DET_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_AT_CMD_CHAR_DET_INT_ST_V, UART_AT_CMD_CHAR_DET_INT_ST_S) + #define UART_GET_RS485_CLASH_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RS485_CLASH_INT_ST_V, UART_RS485_CLASH_INT_ST_S) + #define UART_GET_RS485_FRM_ERR_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RS485_FRM_ERR_INT_ST_V, UART_RS485_FRM_ERR_INT_ST_S) + #define UART_GET_RS485_PARITY_ERR_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RS485_PARITY_ERR_INT_ST_V, UART_RS485_PARITY_ERR_INT_ST_S) + #define UART_GET_TX_DONE_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_TX_DONE_INT_ST_V, UART_TX_DONE_INT_ST_S) + #define UART_GET_TX_BRK_IDLE_DONE_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_TX_BRK_IDLE_DONE_INT_ST_V, UART_TX_BRK_IDLE_DONE_INT_ST_S) + #define UART_GET_TX_BRK_DONE_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_TX_BRK_DONE_INT_ST_V, UART_TX_BRK_DONE_INT_ST_S) + #define UART_GET_GLITCH_DET_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_GLITCH_DET_INT_ST_V, UART_GLITCH_DET_INT_ST_S) + #define UART_GET_SW_XOFF_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_SW_XOFF_INT_ST_V, UART_SW_XOFF_INT_ST_S) + #define UART_GET_SW_XON_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_SW_XON_INT_ST_V, UART_SW_XON_INT_ST_S) + #define UART_GET_RXFIFO_TOUT_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RXFIFO_TOUT_INT_ST_V, UART_RXFIFO_TOUT_INT_ST_S) + #define UART_GET_BRK_DET_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_BRK_DET_INT_ST_V, UART_BRK_DET_INT_ST_S) + #define UART_GET_CTS_CHG_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_CTS_CHG_INT_ST_V, UART_CTS_CHG_INT_ST_S) + #define UART_GET_DSR_CHG_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_DSR_CHG_INT_ST_V, UART_DSR_CHG_INT_ST_S) + #define UART_GET_RXFIFO_OVF_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RXFIFO_OVF_INT_ST_V, UART_RXFIFO_OVF_INT_ST_S) + #define UART_GET_FRM_ERR_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_FRM_ERR_INT_ST_V, UART_FRM_ERR_INT_ST_S) + #define UART_GET_PARITY_ERR_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_PARITY_ERR_INT_ST_V, UART_PARITY_ERR_INT_ST_S) + #define UART_GET_TXFIFO_EMPTY_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_TXFIFO_EMPTY_INT_ST_V, UART_TXFIFO_EMPTY_INT_ST_S) + #define UART_GET_RXFIFO_FULL_INT_ST(i) GET_PERI_REG_BITS2(UART_INT_ST_REG(i) , UART_RXFIFO_FULL_INT_ST_V, UART_RXFIFO_FULL_INT_ST_S) + + + +#define UART_INT_ENA_REG(i) (REG_UART_BASE(i) + 0xC) + /* UART_AT_CMD_CHAR_DET_INT_ENA : R/W ;bitpos:[18] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for detecting AT_CMD char interrupt*/ + #define UART_AT_CMD_CHAR_DET_INT_ENA (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_ENA_M (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_ENA_V 0x1 + #define UART_AT_CMD_CHAR_DET_INT_ENA_S 18 + /* UART_RS485_CLASH_INT_ENA : R/W ;bitpos:[17] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rs485 tx rx clash interrrupt*/ + #define UART_RS485_CLASH_INT_ENA (BIT(17)) + #define UART_RS485_CLASH_INT_ENA_M (BIT(17)) + #define UART_RS485_CLASH_INT_ENA_V 0x1 + #define UART_RS485_CLASH_INT_ENA_S 17 + /* UART_RS485_FRM_ERR_INT_ENA : R/W ;bitpos:[16] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rs485 other rx error*/ + #define UART_RS485_FRM_ERR_INT_ENA (BIT(16)) + #define UART_RS485_FRM_ERR_INT_ENA_M (BIT(16)) + #define UART_RS485_FRM_ERR_INT_ENA_V 0x1 + #define UART_RS485_FRM_ERR_INT_ENA_S 16 + /* UART_RS485_PARITY_ERR_INT_ENA : R/W ;bitpos:[15] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rs485 parity error*/ + #define UART_RS485_PARITY_ERR_INT_ENA (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_ENA_M (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_ENA_V 0x1 + #define UART_RS485_PARITY_ERR_INT_ENA_S 15 + /* UART_TX_DONE_INT_ENA : R/W ;bitpos:[14] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for tx done interrupt*/ + #define UART_TX_DONE_INT_ENA (BIT(14)) + #define UART_TX_DONE_INT_ENA_M (BIT(14)) + #define UART_TX_DONE_INT_ENA_V 0x1 + #define UART_TX_DONE_INT_ENA_S 14 + /* UART_TX_BRK_IDLE_DONE_INT_ENA : R/W ;bitpos:[13] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for tx send idle done interrupt*/ + #define UART_TX_BRK_IDLE_DONE_INT_ENA (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_ENA_M (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_ENA_V 0x1 + #define UART_TX_BRK_IDLE_DONE_INT_ENA_S 13 + /* UART_TX_BRK_DONE_INT_ENA : R/W ;bitpos:[12] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for send 0 done interrupt*/ + #define UART_TX_BRK_DONE_INT_ENA (BIT(12)) + #define UART_TX_BRK_DONE_INT_ENA_M (BIT(12)) + #define UART_TX_BRK_DONE_INT_ENA_V 0x1 + #define UART_TX_BRK_DONE_INT_ENA_S 12 + /* UART_GLITCH_DET_INT_ENA : R/W ;bitpos:[11] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for detecting rx glitch pulse interrupt*/ + #define UART_GLITCH_DET_INT_ENA (BIT(11)) + #define UART_GLITCH_DET_INT_ENA_M (BIT(11)) + #define UART_GLITCH_DET_INT_ENA_V 0x1 + #define UART_GLITCH_DET_INT_ENA_S 11 + /* UART_SW_XOFF_INT_ENA : R/W ;bitpos:[10] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx receive xoff char interrupt*/ + #define UART_SW_XOFF_INT_ENA (BIT(10)) + #define UART_SW_XOFF_INT_ENA_M (BIT(10)) + #define UART_SW_XOFF_INT_ENA_V 0x1 + #define UART_SW_XOFF_INT_ENA_S 10 + /* UART_SW_XON_INT_ENA : R/W ;bitpos:[9] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx receive xon char interrupt*/ + #define UART_SW_XON_INT_ENA (BIT(9)) + #define UART_SW_XON_INT_ENA_M (BIT(9)) + #define UART_SW_XON_INT_ENA_V 0x1 + #define UART_SW_XON_INT_ENA_S 9 + /* UART_RXFIFO_TOUT_INT_ENA : R/W ;bitpos:[8] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx time-out interrupt*/ + #define UART_RXFIFO_TOUT_INT_ENA (BIT(8)) + #define UART_RXFIFO_TOUT_INT_ENA_M (BIT(8)) + #define UART_RXFIFO_TOUT_INT_ENA_V 0x1 + #define UART_RXFIFO_TOUT_INT_ENA_S 8 + /* UART_BRK_DET_INT_ENA : R/W ;bitpos:[7] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx byte start error*/ + #define UART_BRK_DET_INT_ENA (BIT(7)) + #define UART_BRK_DET_INT_ENA_M (BIT(7)) + #define UART_BRK_DET_INT_ENA_V 0x1 + #define UART_BRK_DET_INT_ENA_S 7 + /* UART_CTS_CHG_INT_ENA : R/W ;bitpos:[6] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for CTS changing level*/ + #define UART_CTS_CHG_INT_ENA (BIT(6)) + #define UART_CTS_CHG_INT_ENA_M (BIT(6)) + #define UART_CTS_CHG_INT_ENA_V 0x1 + #define UART_CTS_CHG_INT_ENA_S 6 + /* UART_DSR_CHG_INT_ENA : R/W ;bitpos:[5] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for DSR changing level*/ + #define UART_DSR_CHG_INT_ENA (BIT(5)) + #define UART_DSR_CHG_INT_ENA_M (BIT(5)) + #define UART_DSR_CHG_INT_ENA_V 0x1 + #define UART_DSR_CHG_INT_ENA_S 5 + /* UART_RXFIFO_OVF_INT_ENA : R/W ;bitpos:[4] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx fifo overflow*/ + #define UART_RXFIFO_OVF_INT_ENA (BIT(4)) + #define UART_RXFIFO_OVF_INT_ENA_M (BIT(4)) + #define UART_RXFIFO_OVF_INT_ENA_V 0x1 + #define UART_RXFIFO_OVF_INT_ENA_S 4 + /* UART_FRM_ERR_INT_ENA : R/W ;bitpos:[3] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for other rx error*/ + #define UART_FRM_ERR_INT_ENA (BIT(3)) + #define UART_FRM_ERR_INT_ENA_M (BIT(3)) + #define UART_FRM_ERR_INT_ENA_V 0x1 + #define UART_FRM_ERR_INT_ENA_S 3 + /* UART_PARITY_ERR_INT_ENA : R/W ;bitpos:[2] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for parity error*/ + #define UART_PARITY_ERR_INT_ENA (BIT(2)) + #define UART_PARITY_ERR_INT_ENA_M (BIT(2)) + #define UART_PARITY_ERR_INT_ENA_V 0x1 + #define UART_PARITY_ERR_INT_ENA_S 2 + /* UART_TXFIFO_EMPTY_INT_ENA : R/W ;bitpos:[1] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for tx fifo empty event*/ + #define UART_TXFIFO_EMPTY_INT_ENA (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_ENA_M (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_ENA_V 0x1 + #define UART_TXFIFO_EMPTY_INT_ENA_S 1 + /* UART_RXFIFO_FULL_INT_ENA : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: The interrupt enable bit for rx fifo full event*/ + #define UART_RXFIFO_FULL_INT_ENA (BIT(0)) + #define UART_RXFIFO_FULL_INT_ENA_M (BIT(0)) + #define UART_RXFIFO_FULL_INT_ENA_V 0x1 + #define UART_RXFIFO_FULL_INT_ENA_S 0 + #define UART_GET_AT_CMD_CHAR_DET_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_AT_CMD_CHAR_DET_INT_ENA_V, UART_AT_CMD_CHAR_DET_INT_ENA_S) + #define UART_SET_AT_CMD_CHAR_DET_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_AT_CMD_CHAR_DET_INT_ENA_V,(val),UART_AT_CMD_CHAR_DET_INT_ENA_S) + #define UART_GET_RS485_CLASH_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RS485_CLASH_INT_ENA_V, UART_RS485_CLASH_INT_ENA_S) + #define UART_SET_RS485_CLASH_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RS485_CLASH_INT_ENA_V,(val),UART_RS485_CLASH_INT_ENA_S) + #define UART_GET_RS485_FRM_ERR_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RS485_FRM_ERR_INT_ENA_V, UART_RS485_FRM_ERR_INT_ENA_S) + #define UART_SET_RS485_FRM_ERR_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RS485_FRM_ERR_INT_ENA_V,(val),UART_RS485_FRM_ERR_INT_ENA_S) + #define UART_GET_RS485_PARITY_ERR_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RS485_PARITY_ERR_INT_ENA_V, UART_RS485_PARITY_ERR_INT_ENA_S) + #define UART_SET_RS485_PARITY_ERR_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RS485_PARITY_ERR_INT_ENA_V,(val),UART_RS485_PARITY_ERR_INT_ENA_S) + #define UART_GET_TX_DONE_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_TX_DONE_INT_ENA_V, UART_TX_DONE_INT_ENA_S) + #define UART_SET_TX_DONE_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_TX_DONE_INT_ENA_V,(val),UART_TX_DONE_INT_ENA_S) + #define UART_GET_TX_BRK_IDLE_DONE_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_TX_BRK_IDLE_DONE_INT_ENA_V, UART_TX_BRK_IDLE_DONE_INT_ENA_S) + #define UART_SET_TX_BRK_IDLE_DONE_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_TX_BRK_IDLE_DONE_INT_ENA_V,(val),UART_TX_BRK_IDLE_DONE_INT_ENA_S) + #define UART_GET_TX_BRK_DONE_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_TX_BRK_DONE_INT_ENA_V, UART_TX_BRK_DONE_INT_ENA_S) + #define UART_SET_TX_BRK_DONE_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_TX_BRK_DONE_INT_ENA_V,(val),UART_TX_BRK_DONE_INT_ENA_S) + #define UART_GET_GLITCH_DET_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_GLITCH_DET_INT_ENA_V, UART_GLITCH_DET_INT_ENA_S) + #define UART_SET_GLITCH_DET_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_GLITCH_DET_INT_ENA_V,(val),UART_GLITCH_DET_INT_ENA_S) + #define UART_GET_SW_XOFF_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_SW_XOFF_INT_ENA_V, UART_SW_XOFF_INT_ENA_S) + #define UART_SET_SW_XOFF_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_SW_XOFF_INT_ENA_V,(val),UART_SW_XOFF_INT_ENA_S) + #define UART_GET_SW_XON_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_SW_XON_INT_ENA_V, UART_SW_XON_INT_ENA_S) + #define UART_SET_SW_XON_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_SW_XON_INT_ENA_V,(val),UART_SW_XON_INT_ENA_S) + #define UART_GET_RXFIFO_TOUT_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RXFIFO_TOUT_INT_ENA_V, UART_RXFIFO_TOUT_INT_ENA_S) + #define UART_SET_RXFIFO_TOUT_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RXFIFO_TOUT_INT_ENA_V,(val),UART_RXFIFO_TOUT_INT_ENA_S) + #define UART_GET_BRK_DET_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_BRK_DET_INT_ENA_V, UART_BRK_DET_INT_ENA_S) + #define UART_SET_BRK_DET_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_BRK_DET_INT_ENA_V,(val),UART_BRK_DET_INT_ENA_S) + #define UART_GET_CTS_CHG_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_CTS_CHG_INT_ENA_V, UART_CTS_CHG_INT_ENA_S) + #define UART_SET_CTS_CHG_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_CTS_CHG_INT_ENA_V,(val),UART_CTS_CHG_INT_ENA_S) + #define UART_GET_DSR_CHG_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_DSR_CHG_INT_ENA_V, UART_DSR_CHG_INT_ENA_S) + #define UART_SET_DSR_CHG_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_DSR_CHG_INT_ENA_V,(val),UART_DSR_CHG_INT_ENA_S) + #define UART_GET_RXFIFO_OVF_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RXFIFO_OVF_INT_ENA_V, UART_RXFIFO_OVF_INT_ENA_S) + #define UART_SET_RXFIFO_OVF_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RXFIFO_OVF_INT_ENA_V,(val),UART_RXFIFO_OVF_INT_ENA_S) + #define UART_GET_FRM_ERR_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_FRM_ERR_INT_ENA_V, UART_FRM_ERR_INT_ENA_S) + #define UART_SET_FRM_ERR_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_FRM_ERR_INT_ENA_V,(val),UART_FRM_ERR_INT_ENA_S) + #define UART_GET_PARITY_ERR_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_PARITY_ERR_INT_ENA_V, UART_PARITY_ERR_INT_ENA_S) + #define UART_SET_PARITY_ERR_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_PARITY_ERR_INT_ENA_V,(val),UART_PARITY_ERR_INT_ENA_S) + #define UART_GET_TXFIFO_EMPTY_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_TXFIFO_EMPTY_INT_ENA_V, UART_TXFIFO_EMPTY_INT_ENA_S) + #define UART_SET_TXFIFO_EMPTY_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_TXFIFO_EMPTY_INT_ENA_V,(val),UART_TXFIFO_EMPTY_INT_ENA_S) + #define UART_GET_RXFIFO_FULL_INT_ENA(i) GET_PERI_REG_BITS2(UART_INT_ENA_REG(i) , UART_RXFIFO_FULL_INT_ENA_V, UART_RXFIFO_FULL_INT_ENA_S) + #define UART_SET_RXFIFO_FULL_INT_ENA(i,val) SET_PERI_REG_BITS(UART_INT_ENA_REG(i) ,UART_RXFIFO_FULL_INT_ENA_V,(val),UART_RXFIFO_FULL_INT_ENA_S) + + + +#define UART_INT_CLR_REG(i) (REG_UART_BASE(i) + 0x10) + /* UART_AT_CMD_CHAR_DET_INT_CLR : WO ;bitpos:[18] ;default: 1'b0 ; */ + /*description: Set this bit for detecting AT_CMD char interrupt*/ + #define UART_AT_CMD_CHAR_DET_INT_CLR (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_CLR_M (BIT(18)) + #define UART_AT_CMD_CHAR_DET_INT_CLR_V 0x1 + #define UART_AT_CMD_CHAR_DET_INT_CLR_S 18 + /* UART_RS485_CLASH_INT_CLR : WO ;bitpos:[17] ;default: 1'b0 ; */ + /*description: Set this bit for rs485 tx rx clash interrrupt*/ + #define UART_RS485_CLASH_INT_CLR (BIT(17)) + #define UART_RS485_CLASH_INT_CLR_M (BIT(17)) + #define UART_RS485_CLASH_INT_CLR_V 0x1 + #define UART_RS485_CLASH_INT_CLR_S 17 + /* UART_RS485_FRM_ERR_INT_CLR : WO ;bitpos:[16] ;default: 1'b0 ; */ + /*description: Set this bit for rs485 other rx error*/ + #define UART_RS485_FRM_ERR_INT_CLR (BIT(16)) + #define UART_RS485_FRM_ERR_INT_CLR_M (BIT(16)) + #define UART_RS485_FRM_ERR_INT_CLR_V 0x1 + #define UART_RS485_FRM_ERR_INT_CLR_S 16 + /* UART_RS485_PARITY_ERR_INT_CLR : WO ;bitpos:[15] ;default: 1'b0 ; */ + /*description: Set this bit for rs485 parity error interrupt*/ + #define UART_RS485_PARITY_ERR_INT_CLR (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_CLR_M (BIT(15)) + #define UART_RS485_PARITY_ERR_INT_CLR_V 0x1 + #define UART_RS485_PARITY_ERR_INT_CLR_S 15 + /* UART_TX_DONE_INT_CLR : WO ;bitpos:[14] ;default: 1'b0 ; */ + /*description: Set this bit to clear the tx done interrupt*/ + #define UART_TX_DONE_INT_CLR (BIT(14)) + #define UART_TX_DONE_INT_CLR_M (BIT(14)) + #define UART_TX_DONE_INT_CLR_V 0x1 + #define UART_TX_DONE_INT_CLR_S 14 + /* UART_TX_BRK_IDLE_DONE_INT_CLR : WO ;bitpos:[13] ;default: 1'b0 ; */ + /*description: Set this bit to clear the tx send idle done interrupt*/ + #define UART_TX_BRK_IDLE_DONE_INT_CLR (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_CLR_M (BIT(13)) + #define UART_TX_BRK_IDLE_DONE_INT_CLR_V 0x1 + #define UART_TX_BRK_IDLE_DONE_INT_CLR_S 13 + /* UART_TX_BRK_DONE_INT_CLR : WO ;bitpos:[12] ;default: 1'b0 ; */ + /*description: Set this bit to clear the send 0 done interrupt*/ + #define UART_TX_BRK_DONE_INT_CLR (BIT(12)) + #define UART_TX_BRK_DONE_INT_CLR_M (BIT(12)) + #define UART_TX_BRK_DONE_INT_CLR_V 0x1 + #define UART_TX_BRK_DONE_INT_CLR_S 12 + /* UART_GLITCH_DET_INT_CLR : WO ;bitpos:[11] ;default: 1'b0 ; */ + /*description: Set this bit to clear the detecting rx glitch pulse interrupt*/ + #define UART_GLITCH_DET_INT_CLR (BIT(11)) + #define UART_GLITCH_DET_INT_CLR_M (BIT(11)) + #define UART_GLITCH_DET_INT_CLR_V 0x1 + #define UART_GLITCH_DET_INT_CLR_S 11 + /* UART_SW_XOFF_INT_CLR : WO ;bitpos:[10] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx receive xoff char interrupt*/ + #define UART_SW_XOFF_INT_CLR (BIT(10)) + #define UART_SW_XOFF_INT_CLR_M (BIT(10)) + #define UART_SW_XOFF_INT_CLR_V 0x1 + #define UART_SW_XOFF_INT_CLR_S 10 + /* UART_SW_XON_INT_CLR : WO ;bitpos:[9] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx receive xon char interrupt*/ + #define UART_SW_XON_INT_CLR (BIT(9)) + #define UART_SW_XON_INT_CLR_M (BIT(9)) + #define UART_SW_XON_INT_CLR_V 0x1 + #define UART_SW_XON_INT_CLR_S 9 + /* UART_RXFIFO_TOUT_INT_CLR : WO ;bitpos:[8] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx time-out interrupt*/ + #define UART_RXFIFO_TOUT_INT_CLR (BIT(8)) + #define UART_RXFIFO_TOUT_INT_CLR_M (BIT(8)) + #define UART_RXFIFO_TOUT_INT_CLR_V 0x1 + #define UART_RXFIFO_TOUT_INT_CLR_S 8 + /* UART_BRK_DET_INT_CLR : WO ;bitpos:[7] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx byte start interrupt*/ + #define UART_BRK_DET_INT_CLR (BIT(7)) + #define UART_BRK_DET_INT_CLR_M (BIT(7)) + #define UART_BRK_DET_INT_CLR_V 0x1 + #define UART_BRK_DET_INT_CLR_S 7 + /* UART_CTS_CHG_INT_CLR : WO ;bitpos:[6] ;default: 1'b0 ; */ + /*description: Set this bit to clear the CTS changing interrupt*/ + #define UART_CTS_CHG_INT_CLR (BIT(6)) + #define UART_CTS_CHG_INT_CLR_M (BIT(6)) + #define UART_CTS_CHG_INT_CLR_V 0x1 + #define UART_CTS_CHG_INT_CLR_S 6 + /* UART_DSR_CHG_INT_CLR : WO ;bitpos:[5] ;default: 1'b0 ; */ + /*description: Set this bit to clear the DSR changing interrupt*/ + #define UART_DSR_CHG_INT_CLR (BIT(5)) + #define UART_DSR_CHG_INT_CLR_M (BIT(5)) + #define UART_DSR_CHG_INT_CLR_V 0x1 + #define UART_DSR_CHG_INT_CLR_S 5 + /* UART_RXFIFO_OVF_INT_CLR : WO ;bitpos:[4] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx fifo over-flow interrupt*/ + #define UART_RXFIFO_OVF_INT_CLR (BIT(4)) + #define UART_RXFIFO_OVF_INT_CLR_M (BIT(4)) + #define UART_RXFIFO_OVF_INT_CLR_V 0x1 + #define UART_RXFIFO_OVF_INT_CLR_S 4 + /* UART_FRM_ERR_INT_CLR : WO ;bitpos:[3] ;default: 1'b0 ; */ + /*description: Set this bit to clear other rx error interrupt*/ + #define UART_FRM_ERR_INT_CLR (BIT(3)) + #define UART_FRM_ERR_INT_CLR_M (BIT(3)) + #define UART_FRM_ERR_INT_CLR_V 0x1 + #define UART_FRM_ERR_INT_CLR_S 3 + /* UART_PARITY_ERR_INT_CLR : WO ;bitpos:[2] ;default: 1'b0 ; */ + /*description: Set this bit to clear the parity error interrupt*/ + #define UART_PARITY_ERR_INT_CLR (BIT(2)) + #define UART_PARITY_ERR_INT_CLR_M (BIT(2)) + #define UART_PARITY_ERR_INT_CLR_V 0x1 + #define UART_PARITY_ERR_INT_CLR_S 2 + /* UART_TXFIFO_EMPTY_INT_CLR : WO ;bitpos:[1] ;default: 1'b0 ; */ + /*description: Set this bit to clear the tx fifo empty interrupt*/ + #define UART_TXFIFO_EMPTY_INT_CLR (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_CLR_M (BIT(1)) + #define UART_TXFIFO_EMPTY_INT_CLR_V 0x1 + #define UART_TXFIFO_EMPTY_INT_CLR_S 1 + /* UART_RXFIFO_FULL_INT_CLR : WO ;bitpos:[0] ;default: 1'b0 ; */ + /*description: Set this bit to clear the rx fifo full interrupt*/ + #define UART_RXFIFO_FULL_INT_CLR (BIT(0)) + #define UART_RXFIFO_FULL_INT_CLR_M (BIT(0)) + #define UART_RXFIFO_FULL_INT_CLR_V 0x1 + #define UART_RXFIFO_FULL_INT_CLR_S 0 + #define UART_SET_AT_CMD_CHAR_DET_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_AT_CMD_CHAR_DET_INT_CLR_V,(val),UART_AT_CMD_CHAR_DET_INT_CLR_S) + #define UART_SET_RS485_CLASH_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RS485_CLASH_INT_CLR_V,(val),UART_RS485_CLASH_INT_CLR_S) + #define UART_SET_RS485_FRM_ERR_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RS485_FRM_ERR_INT_CLR_V,(val),UART_RS485_FRM_ERR_INT_CLR_S) + #define UART_SET_RS485_PARITY_ERR_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RS485_PARITY_ERR_INT_CLR_V,(val),UART_RS485_PARITY_ERR_INT_CLR_S) + #define UART_SET_TX_DONE_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_TX_DONE_INT_CLR_V,(val),UART_TX_DONE_INT_CLR_S) + #define UART_SET_TX_BRK_IDLE_DONE_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_TX_BRK_IDLE_DONE_INT_CLR_V,(val),UART_TX_BRK_IDLE_DONE_INT_CLR_S) + #define UART_SET_TX_BRK_DONE_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_TX_BRK_DONE_INT_CLR_V,(val),UART_TX_BRK_DONE_INT_CLR_S) + #define UART_SET_GLITCH_DET_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_GLITCH_DET_INT_CLR_V,(val),UART_GLITCH_DET_INT_CLR_S) + #define UART_SET_SW_XOFF_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_SW_XOFF_INT_CLR_V,(val),UART_SW_XOFF_INT_CLR_S) + #define UART_SET_SW_XON_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_SW_XON_INT_CLR_V,(val),UART_SW_XON_INT_CLR_S) + #define UART_SET_RXFIFO_TOUT_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RXFIFO_TOUT_INT_CLR_V,(val),UART_RXFIFO_TOUT_INT_CLR_S) + #define UART_SET_BRK_DET_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_BRK_DET_INT_CLR_V,(val),UART_BRK_DET_INT_CLR_S) + #define UART_SET_CTS_CHG_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_CTS_CHG_INT_CLR_V,(val),UART_CTS_CHG_INT_CLR_S) + #define UART_SET_DSR_CHG_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_DSR_CHG_INT_CLR_V,(val),UART_DSR_CHG_INT_CLR_S) + #define UART_SET_RXFIFO_OVF_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RXFIFO_OVF_INT_CLR_V,(val),UART_RXFIFO_OVF_INT_CLR_S) + #define UART_SET_FRM_ERR_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_FRM_ERR_INT_CLR_V,(val),UART_FRM_ERR_INT_CLR_S) + #define UART_SET_PARITY_ERR_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_PARITY_ERR_INT_CLR_V,(val),UART_PARITY_ERR_INT_CLR_S) + #define UART_SET_TXFIFO_EMPTY_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_TXFIFO_EMPTY_INT_CLR_V,(val),UART_TXFIFO_EMPTY_INT_CLR_S) + #define UART_SET_RXFIFO_FULL_INT_CLR(i,val) SET_PERI_REG_BITS(UART_INT_CLR_REG(i) ,UART_RXFIFO_FULL_INT_CLR_V,(val),UART_RXFIFO_FULL_INT_CLR_S) + + + +#define UART_CLKDIV_REG(i) (REG_UART_BASE(i) + 0x14) + /* UART_CLKDIV_FRAG : R/W ;bitpos:[23:20] ;default: 4'b0 ; */ + /*description: The decimal part of divider*/ + #define UART_CLKDIV_FRAG 0x0000000F + #define UART_CLKDIV_FRAG_M ((UART_CLKDIV_FRAG_V)<<(UART_CLKDIV_FRAG_S)) + #define UART_CLKDIV_FRAG_V 0xF + #define UART_CLKDIV_FRAG_S 20 + /* UART_CLKDIV : R/W ;bitpos:[19:0] ;default: 20'h2B6 ; */ + /*description: The interger part of divider BAUDRATE = UART_CLK_FREQ / UART_CLKDIV*/ + #define UART_CLKDIV 0x000FFFFF + #define UART_CLKDIV_M ((UART_CLKDIV_V)<<(UART_CLKDIV_S)) + #define UART_CLKDIV_V 0xFFFFF + #define UART_CLKDIV_S 0 + #define UART_GET_CLKDIV_FRAG(i) GET_PERI_REG_BITS2(UART_CLKDIV_REG(i) , UART_CLKDIV_FRAG_V, UART_CLKDIV_FRAG_S) + #define UART_SET_CLKDIV_FRAG(i,val) SET_PERI_REG_BITS(UART_CLKDIV_REG(i) ,UART_CLKDIV_FRAG_V,(val),UART_CLKDIV_FRAG_S) + #define UART_GET_CLKDIV(i) GET_PERI_REG_BITS2(UART_CLKDIV_REG(i) , UART_CLKDIV_V, UART_CLKDIV_S) + #define UART_SET_CLKDIV(i,val) SET_PERI_REG_BITS(UART_CLKDIV_REG(i) ,UART_CLKDIV_V,(val),UART_CLKDIV_S) + + + +#define UART_AUTOBAUD_REG(i) (REG_UART_BASE(i) + 0x18) + /* UART_GLITCH_FILT : R/W ;bitpos:[15:8] ;default: 8'h10 ; */ + /*description: ignore the glitch when pulse cnt is lower then this value*/ + #define UART_GLITCH_FILT 0x000000FF + #define UART_GLITCH_FILT_M ((UART_GLITCH_FILT_V)<<(UART_GLITCH_FILT_S)) + #define UART_GLITCH_FILT_V 0xFF + #define UART_GLITCH_FILT_S 8 + /* UART_AUTOBAUD_EN : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: Set this bit to enable baudrate detect*/ + #define UART_AUTOBAUD_EN (BIT(0)) + #define UART_AUTOBAUD_EN_M (BIT(0)) + #define UART_AUTOBAUD_EN_V 0x1 + #define UART_AUTOBAUD_EN_S 0 + #define UART_GET_GLITCH_FILT(i) GET_PERI_REG_BITS2(UART_AUTOBAUD_REG(i) , UART_GLITCH_FILT_V, UART_GLITCH_FILT_S) + #define UART_SET_GLITCH_FILT(i,val) SET_PERI_REG_BITS(UART_AUTOBAUD_REG(i) ,UART_GLITCH_FILT_V,(val),UART_GLITCH_FILT_S) + #define UART_GET_AUTOBAUD_EN(i) GET_PERI_REG_BITS2(UART_AUTOBAUD_REG(i) , UART_AUTOBAUD_EN_V, UART_AUTOBAUD_EN_S) + #define UART_SET_AUTOBAUD_EN(i,val) SET_PERI_REG_BITS(UART_AUTOBAUD_REG(i) ,UART_AUTOBAUD_EN_V,(val),UART_AUTOBAUD_EN_S) + + + +#define UART_STATUS_REG(i) (REG_UART_BASE(i) + 0x1C) + /* UART_TXD : RO ;bitpos:[31] ;default: 8'h0 ; */ + /*description: The level of the internal uart txd value*/ + #define UART_TXD (BIT(31)) + #define UART_TXD_M (BIT(31)) + #define UART_TXD_V 0x1 + #define UART_TXD_S 31 + /* UART_RTSN : RO ;bitpos:[30] ;default: 1'b0 ; */ + /*description: The level of the internal uart rts pin*/ + #define UART_RTSN (BIT(30)) + #define UART_RTSN_M (BIT(30)) + #define UART_RTSN_V 0x1 + #define UART_RTSN_S 30 + /* UART_DTRN : RO ;bitpos:[29] ;default: 1'b0 ; */ + /*description: The level of the internaluart dtr pin*/ + #define UART_DTRN (BIT(29)) + #define UART_DTRN_M (BIT(29)) + #define UART_DTRN_V 0x1 + #define UART_DTRN_S 29 + /* UART_ST_UTX_OUT : RO ;bitpos:[27:24] ;default: 4'b0 ; */ + /*description: The state for transmitting data. 4'd0:TX_IDLE*/ + #define UART_ST_UTX_OUT 0x0000000F + #define UART_ST_UTX_OUT_M ((UART_ST_UTX_OUT_V)<<(UART_ST_UTX_OUT_S)) + #define UART_ST_UTX_OUT_V 0xF + #define UART_ST_UTX_OUT_S 24 + /* UART_TXFIFO_CNT : RO ;bitpos:[23:16] ;default: 8'b0 ; */ + /*description: Number of data in UART TX fifo*/ + #define UART_TXFIFO_CNT 0x000000FF + #define UART_TXFIFO_CNT_M ((UART_TXFIFO_CNT_V)<<(UART_TXFIFO_CNT_S)) + #define UART_TXFIFO_CNT_V 0xFF + #define UART_TXFIFO_CNT_S 16 + /* UART_RXD : RO ;bitpos:[15] ;default: 1'b0 ; */ + /*description: The level of the internal uart rxd value*/ + #define UART_RXD (BIT(15)) + #define UART_RXD_M (BIT(15)) + #define UART_RXD_V 0x1 + #define UART_RXD_S 15 + /* UART_CTSN : RO ;bitpos:[14] ;default: 1'b0 ; */ + /*description: The level of the internal uart cts value*/ + #define UART_CTSN (BIT(14)) + #define UART_CTSN_M (BIT(14)) + #define UART_CTSN_V 0x1 + #define UART_CTSN_S 14 + /* UART_DSRN : RO ;bitpos:[13] ;default: 1'b0 ; */ + /*description: The level of the internal uart dsr value*/ + #define UART_DSRN (BIT(13)) + #define UART_DSRN_M (BIT(13)) + #define UART_DSRN_V 0x1 + #define UART_DSRN_S 13 + /* UART_ST_URX_OUT : RO ;bitpos:[11:8] ;default: 4'b0 ; */ + /*description: The state for receiving data. 4‘d0: RX_IDLE*/ + #define UART_ST_URX_OUT 0x0000000F + #define UART_ST_URX_OUT_M ((UART_ST_URX_OUT_V)<<(UART_ST_URX_OUT_S)) + #define UART_ST_URX_OUT_V 0xF + #define UART_ST_URX_OUT_S 8 + /* UART_RXFIFO_CNT : RO ;bitpos:[7:0] ;default: 8'b0 ; */ + /*description: Number of data in UART RX fifo*/ + #define UART_RXFIFO_CNT 0x000000FF + #define UART_RXFIFO_CNT_M ((UART_RXFIFO_CNT_V)<<(UART_RXFIFO_CNT_S)) + #define UART_RXFIFO_CNT_V 0xFF + #define UART_RXFIFO_CNT_S 0 + #define UART_GET_TXD(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_TXD_V, UART_TXD_S) + #define UART_GET_RTSN(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_RTSN_V, UART_RTSN_S) + #define UART_GET_DTRN(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_DTRN_V, UART_DTRN_S) + #define UART_GET_ST_UTX_OUT(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_ST_UTX_OUT_V, UART_ST_UTX_OUT_S) + #define UART_GET_TXFIFO_CNT(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_TXFIFO_CNT_V, UART_TXFIFO_CNT_S) + #define UART_GET_RXD(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_RXD_V, UART_RXD_S) + #define UART_GET_CTSN(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_CTSN_V, UART_CTSN_S) + #define UART_GET_DSRN(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_DSRN_V, UART_DSRN_S) + #define UART_GET_ST_URX_OUT(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_ST_URX_OUT_V, UART_ST_URX_OUT_S) + #define UART_GET_RXFIFO_CNT(i) GET_PERI_REG_BITS2(UART_STATUS_REG(i) , UART_RXFIFO_CNT_V, UART_RXFIFO_CNT_S) + + + +#define UART_CONF0_REG(i) (REG_UART_BASE(i) + 0x20) + /* UART_TICK_REF_ALWAYS_ON : R/W ;bitpos:[27] ;default: 1'b1 ; */ + /*description: 1:use apb clock:use referrence clock*/ + #define UART_TICK_REF_ALWAYS_ON (BIT(27)) + #define UART_TICK_REF_ALWAYS_ON_M (BIT(27)) + #define UART_TICK_REF_ALWAYS_ON_V 0x1 + #define UART_TICK_REF_ALWAYS_ON_S 27 + /* UART_ERR_WR_MASK : R/W ;bitpos:[26] ;default: 1'b0 ; */ + /*description: 1:rx stop storing data int rxfifo when data is error 0:if received data is wrong*/ + #define UART_ERR_WR_MASK (BIT(26)) + #define UART_ERR_WR_MASK_M (BIT(26)) + #define UART_ERR_WR_MASK_V 0x1 + #define UART_ERR_WR_MASK_S 26 + /* UART_CLK_EN : R/W ;bitpos:[25] ;default: 1'h0 ; */ + /*description: 1:force clock on for registers:support clock only when write registers*/ + #define UART_CLK_EN (BIT(25)) + #define UART_CLK_EN_M (BIT(25)) + #define UART_CLK_EN_V 0x1 + #define UART_CLK_EN_S 25 + /* UART_DTR_INV : R/W ;bitpos:[24] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart dtr level*/ + #define UART_DTR_INV (BIT(24)) + #define UART_DTR_INV_M (BIT(24)) + #define UART_DTR_INV_V 0x1 + #define UART_DTR_INV_S 24 + /* UART_RTS_INV : R/W ;bitpos:[23] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart rts level*/ + #define UART_RTS_INV (BIT(23)) + #define UART_RTS_INV_M (BIT(23)) + #define UART_RTS_INV_V 0x1 + #define UART_RTS_INV_S 23 + /* UART_TXD_INV : R/W ;bitpos:[22] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart txd level*/ + #define UART_TXD_INV (BIT(22)) + #define UART_TXD_INV_M (BIT(22)) + #define UART_TXD_INV_V 0x1 + #define UART_TXD_INV_S 22 + /* UART_DSR_INV : R/W ;bitpos:[21] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart dsr level*/ + #define UART_DSR_INV (BIT(21)) + #define UART_DSR_INV_M (BIT(21)) + #define UART_DSR_INV_V 0x1 + #define UART_DSR_INV_S 21 + /* UART_CTS_INV : R/W ;bitpos:[20] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart cts level*/ + #define UART_CTS_INV (BIT(20)) + #define UART_CTS_INV_M (BIT(20)) + #define UART_CTS_INV_V 0x1 + #define UART_CTS_INV_S 20 + /* UART_RXD_INV : R/W ;bitpos:[19] ;default: 1'h0 ; */ + /*description: Set this bit to inverse uart rxd level*/ + #define UART_RXD_INV (BIT(19)) + #define UART_RXD_INV_M (BIT(19)) + #define UART_RXD_INV_V 0x1 + #define UART_RXD_INV_S 19 + /* UART_TXFIFO_RST : R/W ;bitpos:[18] ;default: 1'h0 ; */ + /*description: Set this bit to reset uart tx fifo*/ + #define UART_TXFIFO_RST (BIT(18)) + #define UART_TXFIFO_RST_M (BIT(18)) + #define UART_TXFIFO_RST_V 0x1 + #define UART_TXFIFO_RST_S 18 + /* UART_RXFIFO_RST : R/W ;bitpos:[17] ;default: 1'h0 ; */ + /*description: Set this bit to reset uart rx fifo*/ + #define UART_RXFIFO_RST (BIT(17)) + #define UART_RXFIFO_RST_M (BIT(17)) + #define UART_RXFIFO_RST_V 0x1 + #define UART_RXFIFO_RST_S 17 + /* UART_IRDA_EN : R/W ;bitpos:[16] ;default: 1'h0 ; */ + /*description: Set this bit to enable irda protocol*/ + #define UART_IRDA_EN (BIT(16)) + #define UART_IRDA_EN_M (BIT(16)) + #define UART_IRDA_EN_V 0x1 + #define UART_IRDA_EN_S 16 + /* UART_TX_FLOW_EN : R/W ;bitpos:[15] ;default: 1'b0 ; */ + /*description: Set this bit to enable tx flow control*/ + #define UART_TX_FLOW_EN (BIT(15)) + #define UART_TX_FLOW_EN_M (BIT(15)) + #define UART_TX_FLOW_EN_V 0x1 + #define UART_TX_FLOW_EN_S 15 + /* UART_LOOPBACK : R/W ;bitpos:[14] ;default: 1'b0 ; */ + /*description: Set this bit to enable uart loopback test mode*/ + #define UART_LOOPBACK (BIT(14)) + #define UART_LOOPBACK_M (BIT(14)) + #define UART_LOOPBACK_V 0x1 + #define UART_LOOPBACK_S 14 + /* UART_IRDA_RX_INV : R/W ;bitpos:[13] ;default: 1'b0 ; */ + /*description: Set this bit to inverse irda rx level*/ + #define UART_IRDA_RX_INV (BIT(13)) + #define UART_IRDA_RX_INV_M (BIT(13)) + #define UART_IRDA_RX_INV_V 0x1 + #define UART_IRDA_RX_INV_S 13 + /* UART_IRDA_TX_INV : R/W ;bitpos:[12] ;default: 1'b0 ; */ + /*description: Set this bit to inverse irda tx level*/ + #define UART_IRDA_TX_INV (BIT(12)) + #define UART_IRDA_TX_INV_M (BIT(12)) + #define UART_IRDA_TX_INV_V 0x1 + #define UART_IRDA_TX_INV_S 12 + /* UART_IRDA_WCTL : R/W ;bitpos:[11] ;default: 1'b0 ; */ + /*description: 1:the tx 11th bit is the same to the 10th bit 0:set tx 11th bit to 0*/ + #define UART_IRDA_WCTL (BIT(11)) + #define UART_IRDA_WCTL_M (BIT(11)) + #define UART_IRDA_WCTL_V 0x1 + #define UART_IRDA_WCTL_S 11 + /* UART_IRDA_TX_EN : R/W ;bitpos:[10] ;default: 1'b0 ; */ + /*description: Set this bit to enable irda to send data*/ + #define UART_IRDA_TX_EN (BIT(10)) + #define UART_IRDA_TX_EN_M (BIT(10)) + #define UART_IRDA_TX_EN_V 0x1 + #define UART_IRDA_TX_EN_S 10 + /* UART_IRDA_DPLX : R/W ;bitpos:[9] ;default: 1'b0 ; */ + /*description: Set this bit to enable irda duplex mode*/ + #define UART_IRDA_DPLX (BIT(9)) + #define UART_IRDA_DPLX_M (BIT(9)) + #define UART_IRDA_DPLX_V 0x1 + #define UART_IRDA_DPLX_S 9 + /* UART_TXD_BRK : R/W ;bitpos:[8] ;default: 1'b0 ; */ + /*description: Set this bit to enbale tx send 0*/ + #define UART_TXD_BRK (BIT(8)) + #define UART_TXD_BRK_M (BIT(8)) + #define UART_TXD_BRK_V 0x1 + #define UART_TXD_BRK_S 8 + /* UART_SW_DTR : R/W ;bitpos:[7] ;default: 1'b0 ; */ + /*description: sw dtr*/ + #define UART_SW_DTR (BIT(7)) + #define UART_SW_DTR_M (BIT(7)) + #define UART_SW_DTR_V 0x1 + #define UART_SW_DTR_S 7 + /* UART_SW_RTS : R/W ;bitpos:[6] ;default: 1'b0 ; */ + /*description: sw rts*/ + #define UART_SW_RTS (BIT(6)) + #define UART_SW_RTS_M (BIT(6)) + #define UART_SW_RTS_V 0x1 + #define UART_SW_RTS_S 6 + /* UART_STOP_BIT_NUM : R/W ;bitpos:[5:4] ;default: 2'd1 ; */ + /*description: Set stop bit: 1:1bit 2:1.5bits 3:2bits*/ + #define UART_STOP_BIT_NUM 0x00000003 + #define UART_STOP_BIT_NUM_M ((UART_STOP_BIT_NUM_V)<<(UART_STOP_BIT_NUM_S)) + #define UART_STOP_BIT_NUM_V 0x3 + #define UART_STOP_BIT_NUM_S 4 + /* UART_BIT_NUM : R/W ;bitpos:[3:2] ;default: 2'd3 ; */ + /*description: Set bit num: 0:5bits 1:6bits 2:7bits 3:8bits*/ + #define UART_BIT_NUM 0x00000003 + #define UART_BIT_NUM_M ((UART_BIT_NUM_V)<<(UART_BIT_NUM_S)) + #define UART_BIT_NUM_V 0x3 + #define UART_BIT_NUM_S 2 + /* UART_PARITY_EN : R/W ;bitpos:[1] ;default: 1'b0 ; */ + /*description: Set this bit to enable uart parity check*/ + #define UART_PARITY_EN (BIT(1)) + #define UART_PARITY_EN_M (BIT(1)) + #define UART_PARITY_EN_V 0x1 + #define UART_PARITY_EN_S 1 + /* UART_PARITY : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: Set parity check: 0:even 1:odd*/ + #define UART_PARITY (BIT(0)) + #define UART_PARITY_M (BIT(0)) + #define UART_PARITY_V 0x1 + #define UART_PARITY_S 0 + #define UART_GET_TICK_REF_ALWAYS_ON(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_TICK_REF_ALWAYS_ON_V, UART_TICK_REF_ALWAYS_ON_S) + #define UART_SET_TICK_REF_ALWAYS_ON(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_TICK_REF_ALWAYS_ON_V,(val),UART_TICK_REF_ALWAYS_ON_S) + #define UART_GET_ERR_WR_MASK(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_ERR_WR_MASK_V, UART_ERR_WR_MASK_S) + #define UART_SET_ERR_WR_MASK(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_ERR_WR_MASK_V,(val),UART_ERR_WR_MASK_S) + #define UART_GET_REG_CLK_EN(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_CLK_EN_V, UART_CLK_EN_S) + #define UART_SET_REG_CLK_EN(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_CLK_EN_V,(val),UART_CLK_EN_S) + #define UART_GET_DTR_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_DTR_INV_V, UART_DTR_INV_S) + #define UART_SET_DTR_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_DTR_INV_V,(val),UART_DTR_INV_S) + #define UART_GET_RTS_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_RTS_INV_V, UART_RTS_INV_S) + #define UART_SET_RTS_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_RTS_INV_V,(val),UART_RTS_INV_S) + #define UART_GET_TXD_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_TXD_INV_V, UART_TXD_INV_S) + #define UART_SET_TXD_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_TXD_INV_V,(val),UART_TXD_INV_S) + #define UART_GET_DSR_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_DSR_INV_V, UART_DSR_INV_S) + #define UART_SET_DSR_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_DSR_INV_V,(val),UART_DSR_INV_S) + #define UART_GET_CTS_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_CTS_INV_V, UART_CTS_INV_S) + #define UART_SET_CTS_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_CTS_INV_V,(val),UART_CTS_INV_S) + #define UART_GET_RXD_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_RXD_INV_V, UART_RXD_INV_S) + #define UART_SET_RXD_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_RXD_INV_V,(val),UART_RXD_INV_S) + #define UART_GET_TXFIFO_RST(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_TXFIFO_RST_V, UART_TXFIFO_RST_S) + #define UART_SET_TXFIFO_RST(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_TXFIFO_RST_V,(val),UART_TXFIFO_RST_S) + #define UART_GET_RXFIFO_RST(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_RXFIFO_RST_V, UART_RXFIFO_RST_S) + #define UART_SET_RXFIFO_RST(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_RXFIFO_RST_V,(val),UART_RXFIFO_RST_S) + #define UART_GET_IRDA_EN(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_EN_V, UART_IRDA_EN_S) + #define UART_SET_IRDA_EN(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_EN_V,(val),UART_IRDA_EN_S) + #define UART_GET_TX_FLOW_EN(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_TX_FLOW_EN_V, UART_TX_FLOW_EN_S) + #define UART_SET_TX_FLOW_EN(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_TX_FLOW_EN_V,(val),UART_TX_FLOW_EN_S) + #define UART_GET_LOOPBACK(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_LOOPBACK_V, UART_LOOPBACK_S) + #define UART_SET_LOOPBACK(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_LOOPBACK_V,(val),UART_LOOPBACK_S) + #define UART_GET_IRDA_RX_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_RX_INV_V, UART_IRDA_RX_INV_S) + #define UART_SET_IRDA_RX_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_RX_INV_V,(val),UART_IRDA_RX_INV_S) + #define UART_GET_IRDA_TX_INV(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_TX_INV_V, UART_IRDA_TX_INV_S) + #define UART_SET_IRDA_TX_INV(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_TX_INV_V,(val),UART_IRDA_TX_INV_S) + #define UART_GET_IRDA_WCTL(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_WCTL_V, UART_IRDA_WCTL_S) + #define UART_SET_IRDA_WCTL(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_WCTL_V,(val),UART_IRDA_WCTL_S) + #define UART_GET_IRDA_TX_EN(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_TX_EN_V, UART_IRDA_TX_EN_S) + #define UART_SET_IRDA_TX_EN(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_TX_EN_V,(val),UART_IRDA_TX_EN_S) + #define UART_GET_IRDA_DPLX(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_IRDA_DPLX_V, UART_IRDA_DPLX_S) + #define UART_SET_IRDA_DPLX(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_IRDA_DPLX_V,(val),UART_IRDA_DPLX_S) + #define UART_GET_TXD_BRK(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_TXD_BRK_V, UART_TXD_BRK_S) + #define UART_SET_TXD_BRK(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_TXD_BRK_V,(val),UART_TXD_BRK_S) + #define UART_GET_SW_DTR(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_SW_DTR_V, UART_SW_DTR_S) + #define UART_SET_SW_DTR(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_SW_DTR_V,(val),UART_SW_DTR_S) + #define UART_GET_SW_RTS(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_SW_RTS_V, UART_SW_RTS_S) + #define UART_SET_SW_RTS(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_SW_RTS_V,(val),UART_SW_RTS_S) + #define UART_GET_STOP_BIT_NUM(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_STOP_BIT_NUM_V, UART_STOP_BIT_NUM_S) + #define UART_SET_STOP_BIT_NUM(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_STOP_BIT_NUM_V,(val),UART_STOP_BIT_NUM_S) + #define UART_GET_BIT_NUM(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_BIT_NUM_V, UART_BIT_NUM_S) + #define UART_SET_BIT_NUM(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_BIT_NUM_V,(val),UART_BIT_NUM_S) + #define UART_GET_PARITY_EN(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_PARITY_EN_V, UART_PARITY_EN_S) + #define UART_SET_PARITY_EN(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_PARITY_EN_V,(val),UART_PARITY_EN_S) + #define UART_GET_PARITY(i) GET_PERI_REG_BITS2(UART_CONF0_REG(i) , UART_PARITY_V, UART_PARITY_S) + #define UART_SET_PARITY(i,val) SET_PERI_REG_BITS(UART_CONF0_REG(i) ,UART_PARITY_V,(val),UART_PARITY_S) + + + +#define UART_CONF1_REG(i) (REG_UART_BASE(i) + 0x24) + /* UART_RX_TOUT_EN : R/W ;bitpos:[31] ;default: 1'b0 ; */ + /*description: Set this bit to enable rx time-out function*/ + #define UART_RX_TOUT_EN (BIT(31)) + #define UART_RX_TOUT_EN_M (BIT(31)) + #define UART_RX_TOUT_EN_V 0x1 + #define UART_RX_TOUT_EN_S 31 + /* UART_RX_TOUT_THRHD : R/W ;bitpos:[30:24] ;default: 7'b0 ; */ + /*description: Config bits for rx time-out threshold*/ + #define UART_RX_TOUT_THRHD 0x0000007F + #define UART_RX_TOUT_THRHD_M ((UART_RX_TOUT_THRHD_V)<<(UART_RX_TOUT_THRHD_S)) + #define UART_RX_TOUT_THRHD_V 0x7F + #define UART_RX_TOUT_THRHD_S 24 + /* UART_RX_FLOW_EN : R/W ;bitpos:[23] ;default: 1'b0 ; */ + /*description: Set this bit to enable rx hardware flow control*/ + #define UART_RX_FLOW_EN (BIT(23)) + #define UART_RX_FLOW_EN_M (BIT(23)) + #define UART_RX_FLOW_EN_V 0x1 + #define UART_RX_FLOW_EN_S 23 + /* UART_RX_FLOW_THRHD : R/W ;bitpos:[22:16] ;default: 7'h0 ; */ + /*description: The config bits for rx flow control threshold*/ + #define UART_RX_FLOW_THRHD 0x0000007F + #define UART_RX_FLOW_THRHD_M ((UART_RX_FLOW_THRHD_V)<<(UART_RX_FLOW_THRHD_S)) + #define UART_RX_FLOW_THRHD_V 0x7F + #define UART_RX_FLOW_THRHD_S 16 + /* UART_TXFIFO_EMPTY_THRHD : R/W ;bitpos:[14:8] ;default: 7'h60 ; */ + /*description: The config bits for tx fifo empty threshold*/ + #define UART_TXFIFO_EMPTY_THRHD 0x0000007F + #define UART_TXFIFO_EMPTY_THRHD_M ((UART_TXFIFO_EMPTY_THRHD_V)<<(UART_TXFIFO_EMPTY_THRHD_S)) + #define UART_TXFIFO_EMPTY_THRHD_V 0x7F + #define UART_TXFIFO_EMPTY_THRHD_S 8 + /* UART_RXFIFO_FULL_THRHD : R/W ;bitpos:[6:0] ;default: 7'h60 ; */ + /*description: The config bits for rx fifo full threshold*/ + #define UART_RXFIFO_FULL_THRHD 0x0000007F + #define UART_RXFIFO_FULL_THRHD_M ((UART_RXFIFO_FULL_THRHD_V)<<(UART_RXFIFO_FULL_THRHD_S)) + #define UART_RXFIFO_FULL_THRHD_V 0x7F + #define UART_RXFIFO_FULL_THRHD_S 0 + #define UART_GET_RX_TOUT_EN(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_RX_TOUT_EN_V, UART_RX_TOUT_EN_S) + #define UART_SET_RX_TOUT_EN(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_RX_TOUT_EN_V,(val),UART_RX_TOUT_EN_S) + #define UART_GET_RX_TOUT_THRHD(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_RX_TOUT_THRHD_V, UART_RX_TOUT_THRHD_S) + #define UART_SET_RX_TOUT_THRHD(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_RX_TOUT_THRHD_V,(val),UART_RX_TOUT_THRHD_S) + #define UART_GET_RX_FLOW_EN(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_RX_FLOW_EN_V, UART_RX_FLOW_EN_S) + #define UART_SET_RX_FLOW_EN(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_RX_FLOW_EN_V,(val),UART_RX_FLOW_EN_S) + #define UART_GET_RX_FLOW_THRHD(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_RX_FLOW_THRHD_V, UART_RX_FLOW_THRHD_S) + #define UART_SET_RX_FLOW_THRHD(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_RX_FLOW_THRHD_V,(val),UART_RX_FLOW_THRHD_S) + #define UART_GET_TXFIFO_EMPTY_THRHD(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_TXFIFO_EMPTY_THRHD_V, UART_TXFIFO_EMPTY_THRHD_S) + #define UART_SET_TXFIFO_EMPTY_THRHD(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_TXFIFO_EMPTY_THRHD_V,(val),UART_TXFIFO_EMPTY_THRHD_S) + #define UART_GET_RXFIFO_FULL_THRHD(i) GET_PERI_REG_BITS2(UART_CONF1_REG(i) , UART_RXFIFO_FULL_THRHD_V, UART_RXFIFO_FULL_THRHD_S) + #define UART_SET_RXFIFO_FULL_THRHD(i,val) SET_PERI_REG_BITS(UART_CONF1_REG(i) ,UART_RXFIFO_FULL_THRHD_V,(val),UART_RXFIFO_FULL_THRHD_S) + + + +#define UART_LOWPULSE_REG(i) (REG_UART_BASE(i) + 0x28) + /* UART_LOWPULSE_MIN_CNT : RO ;bitpos:[19:0] ;default: 20'hFFFFF ; */ + /*description: used in baudrate detect*/ + #define UART_LOWPULSE_MIN_CNT 0x000FFFFF + #define UART_LOWPULSE_MIN_CNT_M ((UART_LOWPULSE_MIN_CNT_V)<<(UART_LOWPULSE_MIN_CNT_S)) + #define UART_LOWPULSE_MIN_CNT_V 0xFFFFF + #define UART_LOWPULSE_MIN_CNT_S 0 + #define UART_GET_LOWPULSE_MIN_CNT(i) GET_PERI_REG_BITS2(UART_LOWPULSE_REG(i) , UART_LOWPULSE_MIN_CNT_V, UART_LOWPULSE_MIN_CNT_S) + + + +#define UART_HIGHPULSE_REG(i) (REG_UART_BASE(i) + 0x2C) + /* UART_HIGHPULSE_MIN_CNT : RO ;bitpos:[19:0] ;default: 20'hFFFFF ; */ + /*description: used in baudrate detect*/ + #define UART_HIGHPULSE_MIN_CNT 0x000FFFFF + #define UART_HIGHPULSE_MIN_CNT_M ((UART_HIGHPULSE_MIN_CNT_V)<<(UART_HIGHPULSE_MIN_CNT_S)) + #define UART_HIGHPULSE_MIN_CNT_V 0xFFFFF + #define UART_HIGHPULSE_MIN_CNT_S 0 + #define UART_GET_HIGHPULSE_MIN_CNT(i) GET_PERI_REG_BITS2(UART_HIGHPULSE_REG(i) , UART_HIGHPULSE_MIN_CNT_V, UART_HIGHPULSE_MIN_CNT_S) + + + +#define UART_RXD_CNT_REG(i) (REG_UART_BASE(i) + 0x30) + /* UART_RXD_EDGE_CNT : RO ;bitpos:[9:0] ;default: 10'h0 ; */ + /*description: used in baudrate detect*/ + #define UART_RXD_EDGE_CNT 0x000003FF + #define UART_RXD_EDGE_CNT_M ((UART_RXD_EDGE_CNT_V)<<(UART_RXD_EDGE_CNT_S)) + #define UART_RXD_EDGE_CNT_V 0x3FF + #define UART_RXD_EDGE_CNT_S 0 + #define UART_GET_RXD_EDGE_CNT(i) GET_PERI_REG_BITS2(UART_RXD_CNT_REG(i) , UART_RXD_EDGE_CNT_V, UART_RXD_EDGE_CNT_S) + + + +#define UART_FLOW_CONF_REG(i) (REG_UART_BASE(i) + 0x34) + /* UART_SEND_XOFF : R/W ;bitpos:[5] ;default: 1'b0 ; */ + /*description: */ + #define UART_SEND_XOFF (BIT(5)) + #define UART_SEND_XOFF_M (BIT(5)) + #define UART_SEND_XOFF_V 0x1 + #define UART_SEND_XOFF_S 5 + /* UART_SEND_XON : R/W ;bitpos:[4] ;default: 1'b0 ; */ + /*description: */ + #define UART_SEND_XON (BIT(4)) + #define UART_SEND_XON_M (BIT(4)) + #define UART_SEND_XON_V 0x1 + #define UART_SEND_XON_S 4 + /* UART_FORCE_XOFF : R/W ;bitpos:[3] ;default: 1'b0 ; */ + /*description: Set this bit to set ctsn*/ + #define UART_FORCE_XOFF (BIT(3)) + #define UART_FORCE_XOFF_M (BIT(3)) + #define UART_FORCE_XOFF_V 0x1 + #define UART_FORCE_XOFF_S 3 + /* UART_FORCE_XON : R/W ;bitpos:[2] ;default: 1'b0 ; */ + /*description: Set this bit to clear ctsn*/ + #define UART_FORCE_XON (BIT(2)) + #define UART_FORCE_XON_M (BIT(2)) + #define UART_FORCE_XON_V 0x1 + #define UART_FORCE_XON_S 2 + /* UART_XONOFF_DEL : R/W ;bitpos:[1] ;default: 1'b0 ; */ + /*description: Set this bit to remove flow control char from rx data*/ + #define UART_XONOFF_DEL (BIT(1)) + #define UART_XONOFF_DEL_M (BIT(1)) + #define UART_XONOFF_DEL_V 0x1 + #define UART_XONOFF_DEL_S 1 + /* UART_SW_FLOW_CON_EN : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: Set this bit to enable sw flow control*/ + #define UART_SW_FLOW_CON_EN (BIT(0)) + #define UART_SW_FLOW_CON_EN_M (BIT(0)) + #define UART_SW_FLOW_CON_EN_V 0x1 + #define UART_SW_FLOW_CON_EN_S 0 + #define UART_GET_SEND_XOFF(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_SEND_XOFF_V, UART_SEND_XOFF_S) + #define UART_SET_SEND_XOFF(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_SEND_XOFF_V,(val),UART_SEND_XOFF_S) + #define UART_GET_SEND_XON(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_SEND_XON_V, UART_SEND_XON_S) + #define UART_SET_SEND_XON(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_SEND_XON_V,(val),UART_SEND_XON_S) + #define UART_GET_FORCE_XOFF(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_FORCE_XOFF_V, UART_FORCE_XOFF_S) + #define UART_SET_FORCE_XOFF(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_FORCE_XOFF_V,(val),UART_FORCE_XOFF_S) + #define UART_GET_FORCE_XON(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_FORCE_XON_V, UART_FORCE_XON_S) + #define UART_SET_FORCE_XON(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_FORCE_XON_V,(val),UART_FORCE_XON_S) + #define UART_GET_XONOFF_DEL(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_XONOFF_DEL_V, UART_XONOFF_DEL_S) + #define UART_SET_XONOFF_DEL(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_XONOFF_DEL_V,(val),UART_XONOFF_DEL_S) + #define UART_GET_SW_FLOW_CON_EN(i) GET_PERI_REG_BITS2(UART_FLOW_CONF_REG(i) , UART_SW_FLOW_CON_EN_V, UART_SW_FLOW_CON_EN_S) + #define UART_SET_SW_FLOW_CON_EN(i,val) SET_PERI_REG_BITS(UART_FLOW_CONF_REG(i) ,UART_SW_FLOW_CON_EN_V,(val),UART_SW_FLOW_CON_EN_S) + + + +#define UART_SLEEP_CONF_REG(i) (REG_UART_BASE(i) + 0x38) + /* UART_ACTIVE_THRESHOLD : R/W ;bitpos:[9:0] ;default: 10'hf0 ; */ + /*description: when the num of rx level change is more than this value*/ + #define UART_ACTIVE_THRESHOLD 0x000003FF + #define UART_ACTIVE_THRESHOLD_M ((UART_ACTIVE_THRESHOLD_V)<<(UART_ACTIVE_THRESHOLD_S)) + #define UART_ACTIVE_THRESHOLD_V 0x3FF + #define UART_ACTIVE_THRESHOLD_S 0 + #define UART_GET_ACTIVE_THRESHOLD(i) GET_PERI_REG_BITS2(UART_SLEEP_CONF_REG(i) , UART_ACTIVE_THRESHOLD_V, UART_ACTIVE_THRESHOLD_S) + #define UART_SET_ACTIVE_THRESHOLD(i,val) SET_PERI_REG_BITS(UART_SLEEP_CONF_REG(i) ,UART_ACTIVE_THRESHOLD_V,(val),UART_ACTIVE_THRESHOLD_S) + + + +#define UART_SWFC_CONF_REG(i) (REG_UART_BASE(i) + 0x3C) + /* UART_XOFF_CHAR : R/W ;bitpos:[31:24] ;default: 8'h13 ; */ + /*description: xoff char*/ + #define UART_XOFF_CHAR 0x000000FF + #define UART_XOFF_CHAR_M ((UART_XOFF_CHAR_V)<<(UART_XOFF_CHAR_S)) + #define UART_XOFF_CHAR_V 0xFF + #define UART_XOFF_CHAR_S 24 + /* UART_XON_CHAR : R/W ;bitpos:[23:16] ;default: 8'h11 ; */ + /*description: xon char*/ + #define UART_XON_CHAR 0x000000FF + #define UART_XON_CHAR_M ((UART_XON_CHAR_V)<<(UART_XON_CHAR_S)) + #define UART_XON_CHAR_V 0xFF + #define UART_XON_CHAR_S 16 + /* UART_XOFF_THRESHOLD : R/W ;bitpos:[15:8] ;default: 8'he0 ; */ + /*description: rx stop receiving data when rxfifo_cnt is more than this value*/ + #define UART_XOFF_THRESHOLD 0x000000FF + #define UART_XOFF_THRESHOLD_M ((UART_XOFF_THRESHOLD_V)<<(UART_XOFF_THRESHOLD_S)) + #define UART_XOFF_THRESHOLD_V 0xFF + #define UART_XOFF_THRESHOLD_S 8 + /* UART_XON_THRESHOLD : R/W ;bitpos:[7:0] ;default: 8'h0 ; */ + /*description: rx continue receiving data when rxfifo cnt is less then this value*/ + #define UART_XON_THRESHOLD 0x000000FF + #define UART_XON_THRESHOLD_M ((UART_XON_THRESHOLD_V)<<(UART_XON_THRESHOLD_S)) + #define UART_XON_THRESHOLD_V 0xFF + #define UART_XON_THRESHOLD_S 0 + #define UART_GET_XOFF_CH(i) GET_PERI_REG_BITS2(UART_SWFC_CONF_REG(i) , UART_XOFF_CHAR_V, UART_XOFF_CHAR_S) + #define UART_SET_XOFF_CH(i,val) SET_PERI_REG_BITS(UART_SWFC_CONF_REG(i) ,UART_XOFF_CHAR_V,(val),UART_XOFF_CHAR_S) + #define UART_GET_XON_CH(i) GET_PERI_REG_BITS2(UART_SWFC_CONF_REG(i) , UART_XON_CHAR_V, UART_XON_CHAR_S) + #define UART_SET_XON_CH(i,val) SET_PERI_REG_BITS(UART_SWFC_CONF_REG(i) ,UART_XON_CHAR_V,(val),UART_XON_CHAR_S) + #define UART_GET_XOFF_THRESHOLD(i) GET_PERI_REG_BITS2(UART_SWFC_CONF_REG(i) , UART_XOFF_THRESHOLD_V, UART_XOFF_THRESHOLD_S) + #define UART_SET_XOFF_THRESHOLD(i,val) SET_PERI_REG_BITS(UART_SWFC_CONF_REG(i) ,UART_XOFF_THRESHOLD_V,(val),UART_XOFF_THRESHOLD_S) + #define UART_GET_XON_THRESHOLD(i) GET_PERI_REG_BITS2(UART_SWFC_CONF_REG(i) , UART_XON_THRESHOLD_V, UART_XON_THRESHOLD_S) + #define UART_SET_XON_THRESHOLD(i,val) SET_PERI_REG_BITS(UART_SWFC_CONF_REG(i) ,UART_XON_THRESHOLD_V,(val),UART_XON_THRESHOLD_S) + + + +#define UART_IDLE_CONF_REG(i) (REG_UART_BASE(i) + 0x40) + /* UART_TX_BRK_NUM : R/W ;bitpos:[27:20] ;default: 8'ha ; */ + /*description: brk number config*/ + #define UART_TX_BRK_NUM 0x000000FF + #define UART_TX_BRK_NUM_M ((UART_TX_BRK_NUM_V)<<(UART_TX_BRK_NUM_S)) + #define UART_TX_BRK_NUM_V 0xFF + #define UART_TX_BRK_NUM_S 20 + /* UART_TX_IDLE_NUM : R/W ;bitpos:[19:10] ;default: 10'h100 ; */ + /*description: idle number config*/ + #define UART_TX_IDLE_NUM 0x000003FF + #define UART_TX_IDLE_NUM_M ((UART_TX_IDLE_NUM_V)<<(UART_TX_IDLE_NUM_S)) + #define UART_TX_IDLE_NUM_V 0x3FF + #define UART_TX_IDLE_NUM_S 10 + /* UART_RX_IDLE_THRHD : R/W ;bitpos:[9:0] ;default: 10'h100 ; */ + /*description: rx idle number config*/ + #define UART_RX_IDLE_THRHD 0x000003FF + #define UART_RX_IDLE_THRHD_M ((UART_RX_IDLE_THRHD_V)<<(UART_RX_IDLE_THRHD_S)) + #define UART_RX_IDLE_THRHD_V 0x3FF + #define UART_RX_IDLE_THRHD_S 0 + #define UART_GET_TX_BRK_NUM(i) GET_PERI_REG_BITS2(UART_IDLE_CONF_REG(i) , UART_TX_BRK_NUM_V, UART_TX_BRK_NUM_S) + #define UART_SET_TX_BRK_NUM(i,val) SET_PERI_REG_BITS(UART_IDLE_CONF_REG(i) ,UART_TX_BRK_NUM_V,(val),UART_TX_BRK_NUM_S) + #define UART_GET_TX_IDLE_NUM(i) GET_PERI_REG_BITS2(UART_IDLE_CONF_REG(i) , UART_TX_IDLE_NUM_V, UART_TX_IDLE_NUM_S) + #define UART_SET_TX_IDLE_NUM(i,val) SET_PERI_REG_BITS(UART_IDLE_CONF_REG(i) ,UART_TX_IDLE_NUM_V,(val),UART_TX_IDLE_NUM_S) + #define UART_GET_RX_IDLE_THRHD(i) GET_PERI_REG_BITS2(UART_IDLE_CONF_REG(i) , UART_RX_IDLE_THRHD_V, UART_RX_IDLE_THRHD_S) + #define UART_SET_RX_IDLE_THRHD(i,val) SET_PERI_REG_BITS(UART_IDLE_CONF_REG(i) ,UART_RX_IDLE_THRHD_V,(val),UART_RX_IDLE_THRHD_S) + + + +#define UART_RS485_CONF_REG(i) (REG_UART_BASE(i) + 0x44) + /* UART_RS485_TX_DLY_NUM : R/W ;bitpos:[9:6] ;default: 4'b0 ; */ + /*description: config this reg to delay tx signal*/ + #define UART_RS485_TX_DLY_NUM 0x0000000F + #define UART_RS485_TX_DLY_NUM_M ((UART_RS485_TX_DLY_NUM_V)<<(UART_RS485_TX_DLY_NUM_S)) + #define UART_RS485_TX_DLY_NUM_V 0xF + #define UART_RS485_TX_DLY_NUM_S 6 + /* UART_RS485_RX_DLY_NUM : R/W ;bitpos:[5] ;default: 1'b0 ; */ + /*description: config this reg to delay rx signal*/ + #define UART_RS485_RX_DLY_NUM (BIT(5)) + #define UART_RS485_RX_DLY_NUM_M (BIT(5)) + #define UART_RS485_RX_DLY_NUM_V 0x1 + #define UART_RS485_RX_DLY_NUM_S 5 + /* UART_RS485RXBY_TX_EN : R/W ;bitpos:[4] ;default: 1'b0 ; */ + /*description: set this bit to enable tx when rx is busy*/ + #define UART_RS485RXBY_TX_EN (BIT(4)) + #define UART_RS485RXBY_TX_EN_M (BIT(4)) + #define UART_RS485RXBY_TX_EN_V 0x1 + #define UART_RS485RXBY_TX_EN_S 4 + /* UART_RS485TX_RX_EN : R/W ;bitpos:[3] ;default: 1'b0 ; */ + /*description: set this bit to enable rx receiving when tx is sending*/ + #define UART_RS485TX_RX_EN (BIT(3)) + #define UART_RS485TX_RX_EN_M (BIT(3)) + #define UART_RS485TX_RX_EN_V 0x1 + #define UART_RS485TX_RX_EN_S 3 + /* UART_DL1_EN : R/W ;bitpos:[2] ;default: 1'b0 ; */ + /*description: set this bit to add 1 bit stop bit(after data)*/ + #define UART_DL1_EN (BIT(2)) + #define UART_DL1_EN_M (BIT(2)) + #define UART_DL1_EN_V 0x1 + #define UART_DL1_EN_S 2 + /* UART_DL0_EN : R/W ;bitpos:[1] ;default: 1'b0 ; */ + /*description: set this bit to add 1 bit stop bit(before data)*/ + #define UART_DL0_EN (BIT(1)) + #define UART_DL0_EN_M (BIT(1)) + #define UART_DL0_EN_V 0x1 + #define UART_DL0_EN_S 1 + /* UART_RS485_EN : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: set this bit to enable rs485 protocol*/ + #define UART_RS485_EN (BIT(0)) + #define UART_RS485_EN_M (BIT(0)) + #define UART_RS485_EN_V 0x1 + #define UART_RS485_EN_S 0 + #define UART_GET_RS485_TX_DLY_NUM(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_RS485_TX_DLY_NUM_V, UART_RS485_TX_DLY_NUM_S) + #define UART_SET_RS485_TX_DLY_NUM(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_RS485_TX_DLY_NUM_V,(val),UART_RS485_TX_DLY_NUM_S) + #define UART_GET_RS485_RX_DLY_NUM(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_RS485_RX_DLY_NUM_V, UART_RS485_RX_DLY_NUM_S) + #define UART_SET_RS485_RX_DLY_NUM(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_RS485_RX_DLY_NUM_V,(val),UART_RS485_RX_DLY_NUM_S) + #define UART_GET_RS485RXBY_TX_EN(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_RS485RXBY_TX_EN_V, UART_RS485RXBY_TX_EN_S) + #define UART_SET_RS485RXBY_TX_EN(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_RS485RXBY_TX_EN_V,(val),UART_RS485RXBY_TX_EN_S) + #define UART_GET_RS485TX_RX_EN(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_RS485TX_RX_EN_V, UART_RS485TX_RX_EN_S) + #define UART_SET_RS485TX_RX_EN(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_RS485TX_RX_EN_V,(val),UART_RS485TX_RX_EN_S) + #define UART_GET_DL1_EN(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_DL1_EN_V, UART_DL1_EN_S) + #define UART_SET_DL1_EN(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_DL1_EN_V,(val),UART_DL1_EN_S) + #define UART_GET_DL0_EN(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_DL0_EN_V, UART_DL0_EN_S) + #define UART_SET_DL0_EN(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_DL0_EN_V,(val),UART_DL0_EN_S) + #define UART_GET_RS485_EN(i) GET_PERI_REG_BITS2(UART_RS485_CONF_REG(i) , UART_RS485_EN_V, UART_RS485_EN_S) + #define UART_SET_RS485_EN(i,val) SET_PERI_REG_BITS(UART_RS485_CONF_REG(i) ,UART_RS485_EN_V,(val),UART_RS485_EN_S) + + + +#define UART_AT_CMD_PRECNT_REG(i) (REG_UART_BASE(i) + 0x48) + /* UART_PRE_IDLE_NUM : R/W ;bitpos:[23:0] ;default: 24'h186a00 ; */ + /*description: config the idle time before receiving AT_CMD*/ + #define UART_PRE_IDLE_NUM 0x00FFFFFF + #define UART_PRE_IDLE_NUM_M ((UART_PRE_IDLE_NUM_V)<<(UART_PRE_IDLE_NUM_S)) + #define UART_PRE_IDLE_NUM_V 0xFFFFFF + #define UART_PRE_IDLE_NUM_S 0 + #define UART_GET_PRE_IDLE_NUM(i) GET_PERI_REG_BITS2(UART_AT_CMD_PRECNT_REG(i) , UART_PRE_IDLE_NUM_V, UART_PRE_IDLE_NUM_S) + #define UART_SET_PRE_IDLE_NUM(i,val) SET_PERI_REG_BITS(UART_AT_CMD_PRECNT_REG(i) ,UART_PRE_IDLE_NUM_V,(val),UART_PRE_IDLE_NUM_S) + + + +#define UART_AT_CMD_POSTCNT_REG(i) (REG_UART_BASE(i) + 0x4c) + /* UART_POST_IDLE_NUM : R/W ;bitpos:[23:0] ;default: 24'h186a00 ; */ + /*description: config the idle time after receiving AT_CMD*/ + #define UART_POST_IDLE_NUM 0x00FFFFFF + #define UART_POST_IDLE_NUM_M ((UART_POST_IDLE_NUM_V)<<(UART_POST_IDLE_NUM_S)) + #define UART_POST_IDLE_NUM_V 0xFFFFFF + #define UART_POST_IDLE_NUM_S 0 + #define UART_GET_POST_IDLE_NUM(i) GET_PERI_REG_BITS2(UART_AT_CMD_POSTCNT_REG(i) , UART_POST_IDLE_NUM_V, UART_POST_IDLE_NUM_S) + #define UART_SET_POST_IDLE_NUM(i,val) SET_PERI_REG_BITS(UART_AT_CMD_POSTCNT_REG(i) ,UART_POST_IDLE_NUM_V,(val),UART_POST_IDLE_NUM_S) + + + +#define UART_AT_CMD_GAPTOUT_REG(i) (REG_UART_BASE(i) + 0x50) + /* UART_RX_GAP_TOUT : R/W ;bitpos:[23:0] ;default: 24'h1e00 ; */ + /*description: config the time between receiving two AT_CMD*/ + #define UART_RX_GAP_TOUT 0x00FFFFFF + #define UART_RX_GAP_TOUT_M ((UART_RX_GAP_TOUT_V)<<(UART_RX_GAP_TOUT_S)) + #define UART_RX_GAP_TOUT_V 0xFFFFFF + #define UART_RX_GAP_TOUT_S 0 + #define UART_GET_RX_GAP_TOUT(i) GET_PERI_REG_BITS2(UART_AT_CMD_GAPTOUT_REG(i) , UART_RX_GAP_TOUT_V, UART_RX_GAP_TOUT_S) + #define UART_SET_RX_GAP_TOUT(i,val) SET_PERI_REG_BITS(UART_AT_CMD_GAPTOUT_REG(i) ,UART_RX_GAP_TOUT_V,(val),UART_RX_GAP_TOUT_S) + + + +#define UART_AT_CMD_CHAR_REG(i) (REG_UART_BASE(i) + 0x54) + /* UART_CHAR_NUM : R/W ;bitpos:[15:8] ;default: 8'd3 ; */ + /*description: config the continous num of AT_CMD*/ + #define UART_CHAR_NUM 0x000000FF + #define UART_CHAR_NUM_M ((UART_CHAR_NUM_V)<<(UART_CHAR_NUM_S)) + #define UART_CHAR_NUM_V 0xFF + #define UART_CHAR_NUM_S 8 + /* UART_AT_CMD_CHAR : R/W ;bitpos:[7:0] ;default: 8'h2b ; */ + /*description: config AT_CMD*/ + #define UART_AT_CMD_CHAR 0x000000FF + #define UART_AT_CMD_CHAR_M ((UART_AT_CMD_CHAR_V)<<(UART_AT_CMD_CHAR_S)) + #define UART_AT_CMD_CHAR_V 0xFF + #define UART_AT_CMD_CHAR_S 0 + #define UART_GET_CHAR_NUM(i) GET_PERI_REG_BITS2(UART_AT_CMD_CHAR_REG(i) , UART_CHAR_NUM_V, UART_CHAR_NUM_S) + #define UART_SET_CHAR_NUM(i,val) SET_PERI_REG_BITS(UART_AT_CMD_CHAR_REG(i) ,UART_CHAR_NUM_V,(val),UART_CHAR_NUM_S) + #define UART_GET_AT_CMD_CHAR(i) GET_PERI_REG_BITS2(UART_AT_CMD_CHAR_REG(i) , UART_AT_CMD_CHAR_V, UART_AT_CMD_CHAR_S) + #define UART_SET_AT_CMD_CHAR(i,val) SET_PERI_REG_BITS(UART_AT_CMD_CHAR_REG(i) ,UART_AT_CMD_CHAR_V,(val),UART_AT_CMD_CHAR_S) + + + +#define UART_MEM_CONF_REG(i) (REG_UART_BASE(i) + 0x58) + /* UART_TX_MEM_EMPTY_THRHD : R/W ;bitpos:[30:28] ;default: 3'h0 ; */ + /*description: the most significant bits of tx fifo empty threashold*/ + #define UART_TX_MEM_EMPTY_THRHD 0x00000007 + #define UART_TX_MEM_EMPTY_THRHD_M ((UART_TX_MEM_EMPTY_THRHD_V)<<(UART_TX_MEM_EMPTY_THRHD_S)) + #define UART_TX_MEM_EMPTY_THRHD_V 0x7 + #define UART_TX_MEM_EMPTY_THRHD_S 28 + /* UART_RX_MEM_FULL_THRHD : R/W ;bitpos:[27:25] ;default: 3'h0 ; */ + /*description: the most significant bits of rx fifo full threashold*/ + #define UART_RX_MEM_FULL_THRHD 0x00000007 + #define UART_RX_MEM_FULL_THRHD_M ((UART_RX_MEM_FULL_THRHD_V)<<(UART_RX_MEM_FULL_THRHD_S)) + #define UART_RX_MEM_FULL_THRHD_V 0x7 + #define UART_RX_MEM_FULL_THRHD_S 25 + /* UART_XOFF_THRESHOLD_H2 : R/W ;bitpos:[24:23] ;default: 2'h0 ; */ + /*description: the most significant bits of uart xoff flow threashold*/ + #define UART_XOFF_THRESHOLD_H2 0x00000003 + #define UART_XOFF_THRESHOLD_H2_M ((UART_XOFF_THRESHOLD_H2_V)<<(UART_XOFF_THRESHOLD_H2_S)) + #define UART_XOFF_THRESHOLD_H2_V 0x3 + #define UART_XOFF_THRESHOLD_H2_S 23 + /* UART_XON_THRESHOLD_H2 : R/W ;bitpos:[22:21] ;default: 2'h0 ; */ + /*description: the most significant bits of uart xon flow threshold*/ + #define UART_XON_THRESHOLD_H2 0x00000003 + #define UART_XON_THRESHOLD_H2_M ((UART_XON_THRESHOLD_H2_V)<<(UART_XON_THRESHOLD_H2_S)) + #define UART_XON_THRESHOLD_H2_V 0x3 + #define UART_XON_THRESHOLD_H2_S 21 + /* UART_RX_TOUT_THRHD_H3 : R/W ;bitpos:[20:18] ;default: 3h0 ; */ + /*description: the most significant bits of rx timeout threshold*/ + #define UART_RX_TOUT_THRHD_H3 0x00000007 + #define UART_RX_TOUT_THRHD_H3_M ((UART_RX_TOUT_THRHD_H3_V)<<(UART_RX_TOUT_THRHD_H3_S)) + #define UART_RX_TOUT_THRHD_H3_V 0x7 + #define UART_RX_TOUT_THRHD_H3_S 18 + /* UART_RX_FLOW_THRHD_H3 : R/W ;bitpos:[17:15] ;default: 3'h0 ; */ + /*description: the most significant bits of rx flow control threshold*/ + #define UART_RX_FLOW_THRHD_H3 0x00000007 + #define UART_RX_FLOW_THRHD_H3_M ((UART_RX_FLOW_THRHD_H3_V)<<(UART_RX_FLOW_THRHD_H3_S)) + #define UART_RX_FLOW_THRHD_H3_V 0x7 + #define UART_RX_FLOW_THRHD_H3_S 15 + /* UART_TX_SIZE : R/W ;bitpos:[10:7] ;default: 3'h0 ; */ + /*description: config tx_mem's size(128*reg_rx_size)*/ + #define UART_TX_SIZE 0x0000000F + #define UART_TX_SIZE_M ((UART_TX_SIZE_V)<<(UART_TX_SIZE_S)) + #define UART_TX_SIZE_V 0xF + #define UART_TX_SIZE_S 7 + /* UART_RX_SIZE : R/W ;bitpos:[6:3] ;default: 3'h0 ; */ + /*description: config rx mem's size(128*reg_rx_size)*/ + #define UART_RX_SIZE 0x0000000F + #define UART_RX_SIZE_M ((UART_RX_SIZE_V)<<(UART_RX_SIZE_S)) + #define UART_RX_SIZE_V 0xF + #define UART_RX_SIZE_S 3 + /* UART_MEM_PD : R/W ;bitpos:[0] ;default: 1'b0 ; */ + /*description: set this bit to pull_down mem's pd signal*/ + #define UART_MEM_PD (BIT(0)) + #define UART_MEM_PD_M (BIT(0)) + #define UART_MEM_PD_V 0x1 + #define UART_MEM_PD_S 0 + #define UART_GET_TX_MEM_EMPTY_THRHD(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_TX_MEM_EMPTY_THRHD_V, UART_TX_MEM_EMPTY_THRHD_S) + #define UART_SET_TX_MEM_EMPTY_THRHD(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_TX_MEM_EMPTY_THRHD_V,(val),UART_TX_MEM_EMPTY_THRHD_S) + #define UART_GET_RX_MEM_FULL_THRHD(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_RX_MEM_FULL_THRHD_V, UART_RX_MEM_FULL_THRHD_S) + #define UART_SET_RX_MEM_FULL_THRHD(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_RX_MEM_FULL_THRHD_V,(val),UART_RX_MEM_FULL_THRHD_S) + #define UART_GET_XOFF_THRESHOLD_H2(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_XOFF_THRESHOLD_H2_V, UART_XOFF_THRESHOLD_H2_S) + #define UART_SET_XOFF_THRESHOLD_H2(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_XOFF_THRESHOLD_H2_V,(val),UART_XOFF_THRESHOLD_H2_S) + #define UART_GET_XON_THRESHOLD_H2(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_XON_THRESHOLD_H2_V, UART_XON_THRESHOLD_H2_S) + #define UART_SET_XON_THRESHOLD_H2(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_XON_THRESHOLD_H2_V,(val),UART_XON_THRESHOLD_H2_S) + #define UART_GET_RX_TOUT_THRHD_H3(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_RX_TOUT_THRHD_H3_V, UART_RX_TOUT_THRHD_H3_S) + #define UART_SET_RX_TOUT_THRHD_H3(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_RX_TOUT_THRHD_H3_V,(val),UART_RX_TOUT_THRHD_H3_S) + #define UART_GET_RX_FLOW_THRHD_H3(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_RX_FLOW_THRHD_H3_V, UART_RX_FLOW_THRHD_H3_S) + #define UART_SET_RX_FLOW_THRHD_H3(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_RX_FLOW_THRHD_H3_V,(val),UART_RX_FLOW_THRHD_H3_S) + #define UART_GET_REG_TX_SIZE(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_TX_SIZE_V, UART_TX_SIZE_S) + #define UART_SET_REG_TX_SIZE(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_TX_SIZE_V,(val),UART_TX_SIZE_S) + #define UART_GET_REG_RX_SIZE(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_RX_SIZE_V, UART_RX_SIZE_S) + #define UART_SET_REG_RX_SIZE(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_RX_SIZE_V,(val),UART_RX_SIZE_S) + #define UART_GET_REG_MEM_PD(i) GET_PERI_REG_BITS2(UART_MEM_CONF_REG(i) , UART_MEM_PD_V, UART_MEM_PD_S) + #define UART_SET_REG_MEM_PD(i,val) SET_PERI_REG_BITS(UART_MEM_CONF_REG(i) ,UART_MEM_PD_V,(val),UART_MEM_PD_S) + + + +#define UART_MEM_TX_STATUS_REG(i) (REG_UART_BASE(i) + 0x5c) + /* UART_TX_RADDR_CHX : RO ;bitpos:[23:13] ;default: 11'b0 ; */ + /*description: uartx tx mem's read address*/ + #define UART_TX_RADDR_CHX 0x000007FF + #define UART_TX_RADDR_CHX_M ((UART_TX_RADDR_CHX_V)<<(UART_TX_RADDR_CHX_S)) + #define UART_TX_RADDR_CHX_V 0x7FF + #define UART_TX_RADDR_CHX_S 13 + /* UART_APB_TX_WADDR_CHX : RO ;bitpos:[12:2] ;default: 11'b0 ; */ + /*description: uartx tx mem's write address*/ + #define UART_APB_TX_WADDR_CHX 0x000007FF + #define UART_APB_TX_WADDR_CHX_M ((UART_APB_TX_WADDR_CHX_V)<<(UART_APB_TX_WADDR_CHX_S)) + #define UART_APB_TX_WADDR_CHX_V 0x7FF + #define UART_APB_TX_WADDR_CHX_S 2 + #define UART_GET_TX_RADDR_CHX(i) GET_PERI_REG_BITS2(UART_MEM_TX_STATUS_REG(i) , UART_TX_RADDR_CHX_V, UART_TX_RADDR_CHX_S) + #define UART_GET_APB_TX_WADDR_CHX(i) GET_PERI_REG_BITS2(UART_MEM_TX_STATUS_REG(i) , UART_APB_TX_WADDR_CHX_V, UART_APB_TX_WADDR_CHX_S) + + + +#define UART_MEM_RX_STATUS_REG(i) (REG_UART_BASE(i) + 0x60) + /* UART_RX_WADDR_CHX : RO ;bitpos:[23:13] ;default: 11'b0 ; */ + /*description: uartx rx mem's write address*/ + #define UART_RX_WADDR_CHX 0x000007FF + #define UART_RX_WADDR_CHX_M ((UART_RX_WADDR_CHX_V)<<(UART_RX_WADDR_CHX_S)) + #define UART_RX_WADDR_CHX_V 0x7FF + #define UART_RX_WADDR_CHX_S 13 + /* UART_APB_RX_RADDR_CHX : RO ;bitpos:[12:2] ;default: 11'b0 ; */ + /*description: uartx rx mem's read address*/ + #define UART_APB_RX_RADDR_CHX 0x000007FF + #define UART_APB_RX_RADDR_CHX_M ((UART_APB_RX_RADDR_CHX_V)<<(UART_APB_RX_RADDR_CHX_S)) + #define UART_APB_RX_RADDR_CHX_V 0x7FF + #define UART_APB_RX_RADDR_CHX_S 2 + #define UART_GET_RX_WADDR_CHX(i) GET_PERI_REG_BITS2(UART_MEM_RX_STATUS_REG(i) , UART_RX_WADDR_CHX_V, UART_RX_WADDR_CHX_S) + #define UART_GET_APB_RX_RADDR_CHX(i) GET_PERI_REG_BITS2(UART_MEM_RX_STATUS_REG(i) , UART_APB_RX_RADDR_CHX_V, UART_APB_RX_RADDR_CHX_S) + + + +#define UART_DATE_REG(i) (REG_UART_BASE(i) + 0x78) + /* UART_DATE : R/W ;bitpos:[31:0] ;default: 32'h15122500 ; */ + /*description: */ + #define UART_DATE 0xFFFFFFFF + #define UART_DATE_M ((UART_DATE_V)<<(UART_DATE_S)) + #define UART_DATE_V 0xFFFFFFFF + #define UART_DATE_S 0 + #define UART_GET_DATE(i) GET_PERI_REG_BITS2(UART_DATE_REG(i) , UART_DATE_V, UART_DATE_S) + #define UART_SET_DATE(i,val) SET_PERI_REG_BITS(UART_DATE_REG(i) ,UART_DATE_V,(val),UART_DATE_S) + + + +#define UART_ID_REG(i) (REG_UART_BASE(i) + 0x7C) + /* UART_ID : R/W ;bitpos:[31:0] ;default: 32'h0500 ; */ + /*description: */ + #define UART_ID 0xFFFFFFFF + #define UART_ID_M ((UART_ID_V)<<(UART_ID_S)) + #define UART_ID_V 0xFFFFFFFF + #define UART_ID_S 0 + #define UART_GET_ID(i) GET_PERI_REG_BITS2(UART_ID_REG(i) , UART_ID_V, UART_ID_S) + #define UART_SET_ID(i,val) SET_PERI_REG_BITS(UART_ID_REG(i) ,UART_ID_V,(val),UART_ID_S) + + + + + + +#endif /* _SOC_UART_REG_H_ */ + + diff --git a/components/esp32/include/soc/uhci0_reg.h b/components/esp32/include/soc/uhci0_reg.h new file mode 100644 index 000000000..353a96eaa --- /dev/null +++ b/components/esp32/include/soc/uhci0_reg.h @@ -0,0 +1,350 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _SOC_UHCI0_REG_H_ +#define _SOC_UHCI0_REG_H_ + +#include "soc.h" + +#define UHCI0_CONF0 ( DR_REG_UHCI0_BASE + 0x0) +#define UHCI0_UART_RX_BRK_EOF_EN (BIT(22)) +#define UHCI0_CLK_EN (BIT(21)) +#define UHCI0_ENCODE_CRC_EN (BIT(20)) +#define UHCI0_LEN_EOF_EN (BIT(19)) +#define UHCI0_UART_IDLE_EOF_EN (BIT(18)) +#define UHCI0_CRC_REC_EN (BIT(17)) +#define UHCI0_HEAD_EN (BIT(16)) +#define UHCI0_SEPER_EN (BIT(15)) +#define UHCI0_MEM_TRANS_EN (BIT(14)) +#define UHCI0_RX_DATA_BURST_EN (BIT(13)) +#define UHCI0_TXDSCR_BURST_EN (BIT(12)) +#define UHCI0_RXDSCR_BURST_EN (BIT(11)) +#define UHCI0_UART1_CE (BIT(10)) +#define UHCI0_UART0_CE (BIT(9)) +#define UHCI0_TO_EOF_MODE (BIT(8)) +#define UHCI0_RX_NO_RESTART_CLR (BIT(7)) +#define UHCI0_RX_AUTO_WRBACK (BIT(6)) +#define UHCI0_RX_LOOP_TEST (BIT(5)) +#define UHCI0_TX_LOOP_TEST (BIT(4)) +#define UHCI0_AHBM_RST (BIT(3)) +#define UHCI0_AHBM_FIFO_RST (BIT(2)) +#define UHCI0_RX_RST (BIT(1)) +#define UHCI0_TX_RST (BIT(0)) + +#define UHCI0_INT_RAW ( DR_REG_UHCI0_BASE + 0x4) +#define UHCI0_UHCI_SEND_A_Q_INT_RAW (BIT(15)) +#define UHCI0_UHCI_SEND_S_Q_INT_RAW (BIT(14)) +#define UHCI0_UHCI_TO_TOTAL_EOF_INT_RAW (BIT(13)) +#define UHCI0_UHCI_RXLINK_EOF_ERR_INT_RAW (BIT(12)) +#define UHCI0_UHCI_TX_DSCR_EMPTY_INT_RAW (BIT(11)) +#define UHCI0_UHCI_RX_DSCR_ERR_INT_RAW (BIT(10)) +#define UHCI0_UHCI_TX_DSCR_ERR_INT_RAW (BIT(9)) +#define UHCI0_UHCI_TO_EOF_INT_RAW (BIT(8)) +#define UHCI0_UHCI_RX_DONE_INT_RAW (BIT(7)) +#define UHCI0_UHCI_FROM_ERR_EOF_INT_RAW (BIT(6)) +#define UHCI0_UHCI_FROM_SUC_EOF_INT_RAW (BIT(5)) +#define UHCI0_UHCI_TX_DONE_INT_RAW (BIT(4)) +#define UHCI0_UHCI_TX_HUNG_INT_RAW (BIT(3)) +#define UHCI0_UHCI_RX_HUNG_INT_RAW (BIT(2)) +#define UHCI0_UHCI_TX_START_INT_RAW (BIT(1)) +#define UHCI0_UHCI_RX_START_INT_RAW (BIT(0)) + +#define UHCI0_INT_ST ( DR_REG_UHCI0_BASE + 0x8) +#define UHCI0_UHCI_SEND_A_Q_INT_ST (BIT(15)) +#define UHCI0_UHCI_SEND_S_Q_INT_ST (BIT(14)) +#define UHCI0_UHCI_TO_TOTAL_EOF_INT_ST (BIT(13)) +#define UHCI0_UHCI_RXLINK_EOF_ERR_INT_ST (BIT(12)) +#define UHCI0_UHCI_TX_DSCR_EMPTY_INT_ST (BIT(11)) +#define UHCI0_UHCI_RX_DSCR_ERR_INT_ST (BIT(10)) +#define UHCI0_UHCI_TX_DSCR_ERR_INT_ST (BIT(9)) +#define UHCI0_UHCI_TO_EOF_INT_ST (BIT(8)) +#define UHCI0_UHCI_RX_DONE_INT_ST (BIT(7)) +#define UHCI0_UHCI_FROM_ERR_EOF_INT_ST (BIT(6)) +#define UHCI0_UHCI_FROM_SUC_EOF_INT_ST (BIT(5)) +#define UHCI0_UHCI_TX_DONE_INT_ST (BIT(4)) +#define UHCI0_UHCI_TX_HUNG_INT_ST (BIT(3)) +#define UHCI0_UHCI_RX_HUNG_INT_ST (BIT(2)) +#define UHCI0_UHCI_TX_START_INT_ST (BIT(1)) +#define UHCI0_UHCI_RX_START_INT_ST (BIT(0)) + +#define UHCI0_INT_ENA ( DR_REG_UHCI0_BASE + 0xC) +#define UHCI0_UHCI_SEND_A_Q_INT_ENA (BIT(15)) +#define UHCI0_UHCI_SEND_S_Q_INT_ENA (BIT(14)) +#define UHCI0_UHCI_TO_TOTAL_EOF_INT_ENA (BIT(13)) +#define UHCI0_UHCI_RXLINK_EOF_ERR_INT_ENA (BIT(12)) +#define UHCI0_UHCI_TX_DSCR_EMPTY_INT_ENA (BIT(11)) +#define UHCI0_UHCI_RX_DSCR_ERR_INT_ENA (BIT(10)) +#define UHCI0_UHCI_TX_DSCR_ERR_INT_ENA (BIT(9)) +#define UHCI0_UHCI_TO_EOF_INT_ENA (BIT(8)) +#define UHCI0_UHCI_RX_DONE_INT_ENA (BIT(7)) +#define UHCI0_UHCI_FROM_ERR_EOF_INT_ENA (BIT(6)) +#define UHCI0_UHCI_FROM_SUC_EOF_INT_ENA (BIT(5)) +#define UHCI0_UHCI_TX_DONE_INT_ENA (BIT(4)) +#define UHCI0_UHCI_TX_HUNG_INT_ENA (BIT(3)) +#define UHCI0_UHCI_RX_HUNG_INT_ENA (BIT(2)) +#define UHCI0_UHCI_TX_START_INT_ENA (BIT(1)) +#define UHCI0_UHCI_RX_START_INT_ENA (BIT(0)) + +#define UHCI0_INT_CLR ( DR_REG_UHCI0_BASE + 0x10) +#define UHCI0_SEND_A_REG_Q_INT_CLR (BIT(15)) +#define UHCI0_SEND_S_REG_Q_INT_CLR (BIT(14)) +#define UHCI0_TO_TOTAL_EOF_INT_CLR (BIT(13)) +#define UHCI0_RXLINK_EOF_ERR_INT_CLR (BIT(12)) +#define UHCI0_TX_DSCR_EMPTY_INT_CLR (BIT(11)) +#define UHCI0_RX_DSCR_ERR_INT_CLR (BIT(10)) +#define UHCI0_TX_DSCR_ERR_INT_CLR (BIT(9)) +#define UHCI0_TO_EOF_INT_CLR (BIT(8)) +#define UHCI0_RX_DONE_INT_CLR (BIT(7)) +#define UHCI0_FROM_ERR_EOF_INT_CLR (BIT(6)) +#define UHCI0_FROM_SUC_EOF_INT_CLR (BIT(5)) +#define UHCI0_TX_DONE_INT_CLR (BIT(4)) +#define UHCI0_TX_HUNG_INT_CLR (BIT(3)) +#define UHCI0_RX_HUNG_INT_CLR (BIT(2)) +#define UHCI0_TX_START_INT_CLR (BIT(1)) +#define UHCI0_RX_START_INT_CLR (BIT(0)) + +#define UHCI0_RX_STATUS ( DR_REG_UHCI0_BASE + 0x14) +#define UHCI0_RX_EMPTY (BIT(1)) +#define UHCI0_RX_FULL (BIT(0)) + +#define UHCI0_RXFIFO_PUSH ( DR_REG_UHCI0_BASE + 0x18) +#define UHCI0_RXFIFO_PUSH_EN (BIT(16)) +#define UHCI0_RXFIFO_WDATA 0x000001FF +#define UHCI0_RXFIFO_WDATA_S 0 + +#define UHCI0_TX_STATUS ( DR_REG_UHCI0_BASE + 0x1C) +#define UHCI0_UHCI_RX_ERR_CAUSE 0x00000007 +#define UHCI0_UHCI_RX_ERR_CAUSE_S 4 +#define UHCI0_TX_EMPTY (BIT(1)) +#define UHCI0_TX_FULL (BIT(0)) + +#define UHCI0_TX_POP ( DR_REG_UHCI0_BASE + 0x20) +#define UHCI0_TXFIFO_POP (BIT(16)) +#define UHCI0_TXFIFO_RDATA 0x00000FFF +#define UHCI0_TXFIFO_RDATA_S 0 + +#define UHCI0_RX_LINK ( DR_REG_UHCI0_BASE + 0x24) +#define UHCI0_UHCI_RXLINK_PARK (BIT(31)) +#define UHCI0_RXLINK_RESTART (BIT(30)) +#define UHCI0_RXLINK_START (BIT(29)) +#define UHCI0_RXLINK_STOP (BIT(28)) +#define UHCI0_RXLINK_ADDR 0x000FFFFF +#define UHCI0_RXLINK_ADDR_S 0 + +#define UHCI0_TX_LINK ( DR_REG_UHCI0_BASE + 0x28) +#define UHCI0_UHCI_TXLINK_PARK (BIT(31)) +#define UHCI0_TXLINK_RESTART (BIT(30)) +#define UHCI0_TXLINK_START (BIT(29)) +#define UHCI0_TXLINK_STOP (BIT(28)) +#define UHCI0_TXLINK_AUTO_RET (BIT(20)) +#define UHCI0_TXLINK_ADDR 0x000FFFFF +#define UHCI0_TXLINK_ADDR_S 0 + +#define UHCI0_CONF1 ( DR_REG_UHCI0_BASE + 0x2C) +#define UHCI0_SW_START (BIT(8)) +#define UHCI0_WAIT_SW_START (BIT(7)) +#define UHCI0_CHECK_OWNER (BIT(6)) +#define UHCI0_TX_ACK_NUM_RE (BIT(5)) +#define UHCI0_TX_CHECK_SUM_RE (BIT(4)) +#define UHCI0_SAVE_HEAD (BIT(3)) +#define UHCI0_CRC_DISABLE (BIT(2)) +#define UHCI0_CHECK_SEQ_EN (BIT(1)) +#define UHCI0_CHECK_SUM_EN (BIT(0)) + +#define UHCI0_STATE0 ( DR_REG_UHCI0_BASE + 0x30) +#define UHCI0_UHCI_STATE0 0xFFFFFFFF +#define UHCI0_UHCI_STATE0_S 0 + +#define UHCI0_STATE1 ( DR_REG_UHCI0_BASE + 0x34) +#define UHCI0_UHCI_STATE1 0xFFFFFFFF +#define UHCI0_UHCI_STATE1_S 0 + +#define UHCI0_RX_EOF_DES_ADDR ( DR_REG_UHCI0_BASE + 0x38) +#define UHCI0_TO_EOF_DES_ADDR 0xFFFFFFFF +#define UHCI0_TO_EOF_DES_ADDR_S 0 + +#define UHCI0_TX_SUC_EOF_DES_ADDR ( DR_REG_UHCI0_BASE + 0x3C) +#define UHCI0_FROM_SUC_EOF_DES_ADDR 0xFFFFFFFF +#define UHCI0_FROM_SUC_EOF_DES_ADDR_S 0 + +#define UHCI0_TX_ERR_EOF_DES_ADDR ( DR_REG_UHCI0_BASE + 0x40) +#define UHCI0_FROM_ERR_EOF_DES_ADDR 0xFFFFFFFF +#define UHCI0_FROM_ERR_EOF_DES_ADDR_S 0 + +#define UHCI0_RX_EOF_BFR_DES_ADDR ( DR_REG_UHCI0_BASE + 0x44) +#define UHCI0_TO_EOF_BFR_DES_ADDR 0xFFFFFFFF +#define UHCI0_TO_EOF_BFR_DES_ADDR_S 0 + +#define UHCI0_AHB_TEST ( DR_REG_UHCI0_BASE + 0x48) +#define UHCI0_AHB_TESTADDR 0x00000003 +#define UHCI0_AHB_TESTADDR_S 4 +#define UHCI0_AHB_TESTMODE 0x00000007 +#define UHCI0_AHB_TESTMODE_S 0 + +#define UHCI0_TX_DSCR ( DR_REG_UHCI0_BASE + 0x4C) +#define UHCI0_TXLINK_DSCR 0xFFFFFFFF +#define UHCI0_TXLINK_DSCR_S 0 + +#define UHCI0_TX_DSCR_BF0 ( DR_REG_UHCI0_BASE + 0x50) +#define UHCI0_TXLINK_DSCR_BF0 0xFFFFFFFF +#define UHCI0_TXLINK_DSCR_BF0_S 0 + +#define UHCI0_TX_DSCR_BF1 ( DR_REG_UHCI0_BASE + 0x54) +#define UHCI0_TXLINK_DSCR_BF1 0xFFFFFFFF +#define UHCI0_TXLINK_DSCR_BF1_S 0 + +#define UHCI0_RX_DSCR ( DR_REG_UHCI0_BASE + 0x58) +#define UHCI0_RXLINK_DSCR 0xFFFFFFFF +#define UHCI0_RXLINK_DSCR_S 0 + +#define UHCI0_RX_DSCR_BF0 ( DR_REG_UHCI0_BASE + 0x5C) +#define UHCI0_RXLINK_DSCR_BF0 0xFFFFFFFF +#define UHCI0_RXLINK_DSCR_BF0_S 0 + +#define UHCI0_RX_DSCR_BF1 ( DR_REG_UHCI0_BASE + 0x60) +#define UHCI0_RXLINK_DSCR_BF1 0xFFFFFFFF +#define UHCI0_RXLINK_DSCR_BF1_S 0 + +#define UHCI0_ESCAPE_CONF ( DR_REG_UHCI0_BASE + 0x64) +#define UHCI0_RX_13_ESC_EN (BIT(7)) +#define UHCI0_RX_11_ESC_EN (BIT(6)) +#define UHCI0_RX_DB_ESC_EN (BIT(5)) +#define UHCI0_RX_C0_ESC_EN (BIT(4)) +#define UHCI0_TX_13_ESC_EN (BIT(3)) +#define UHCI0_TX_11_ESC_EN (BIT(2)) +#define UHCI0_TX_DB_ESC_EN (BIT(1)) +#define UHCI0_TX_C0_ESC_EN (BIT(0)) + +#define UHCI0_HUNG_CONF ( DR_REG_UHCI0_BASE + 0x68) +#define UHCI0_RXFIFO_TIMEOUT_ENA (BIT(23)) +#define UHCI0_RXFIFO_TIMEOUT_SHIFT 0x00000007 +#define UHCI0_RXFIFO_TIMEOUT_SHIFT_S 20 +#define UHCI0_RXFIFO_TIMEOUT 0x000000FF +#define UHCI0_RXFIFO_TIMEOUT_S 12 +#define UHCI0_TXFIFO_TIMEOUT_ENA (BIT(11)) +#define UHCI0_TXFIFO_TIMEOUT_SHIFT 0x00000007 +#define UHCI0_TXFIFO_TIMEOUT_SHIFT_S 8 +#define UHCI0_TXFIFO_TIMEOUT 0x000000FF +#define UHCI0_TXFIFO_TIMEOUT_S 0 + +#define UHCI0_ACK_NUM ( DR_REG_UHCI0_BASE + 0x6C) + +#define UHCI0_RX_HEAD ( DR_REG_UHCI0_BASE + 0x70) +#define UHCI0_UHCI_RX_HEAD 0xFFFFFFFF +#define UHCI0_UHCI_RX_HEAD_S 0 + +#define UHCI0_QUICK_SENT ( DR_REG_UHCI0_BASE + 0x74) +#define UHCI0_ALWAYS_SEND_EN (BIT(7)) +#define UHCI0_ALWAYS_SEND_NUM 0x00000007 +#define UHCI0_ALWAYS_SEND_NUM_S 4 +#define UHCI0_SINGLE_SEND_EN (BIT(3)) +#define UHCI0_SINGLE_SEND_NUM 0x00000007 +#define UHCI0_SINGLE_SEND_NUM_S 0 + +#define UHCI0_REG_Q0_WORD0 ( DR_REG_UHCI0_BASE + 0x78) +#define UHCI0_SEND_Q0_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q0_WORD0_S 0 + +#define UHCI0_REG_Q0_WORD1 ( DR_REG_UHCI0_BASE + 0x7C) +#define UHCI0_SEND_Q0_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q0_WORD1_S 0 + +#define UHCI0_REG_Q1_WORD0 ( DR_REG_UHCI0_BASE + 0x80) +#define UHCI0_SEND_Q1_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q1_WORD0_S 0 + +#define UHCI0_REG_Q1_WORD1 ( DR_REG_UHCI0_BASE + 0x84) +#define UHCI0_SEND_Q1_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q1_WORD1_S 0 + +#define UHCI0_REG_Q2_WORD0 ( DR_REG_UHCI0_BASE + 0x88) +#define UHCI0_SEND_Q2_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q2_WORD0_S 0 + +#define UHCI0_REG_Q2_WORD1 ( DR_REG_UHCI0_BASE + 0x8C) +#define UHCI0_SEND_Q2_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q2_WORD1_S 0 + +#define UHCI0_REG_Q3_WORD0 ( DR_REG_UHCI0_BASE + 0x90) +#define UHCI0_SEND_Q3_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q3_WORD0_S 0 + +#define UHCI0_REG_Q3_WORD1 ( DR_REG_UHCI0_BASE + 0x94) +#define UHCI0_SEND_Q3_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q3_WORD1_S 0 + +#define UHCI0_REG_Q4_WORD0 ( DR_REG_UHCI0_BASE + 0x98) +#define UHCI0_SEND_Q4_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q4_WORD0_S 0 + +#define UHCI0_REG_Q4_WORD1 ( DR_REG_UHCI0_BASE + 0x9C) +#define UHCI0_SEND_Q4_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q4_WORD1_S 0 + +#define UHCI0_REG_Q5_WORD0 ( DR_REG_UHCI0_BASE + 0xA0) +#define UHCI0_SEND_Q5_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q5_WORD0_S 0 + +#define UHCI0_REG_Q5_WORD1 ( DR_REG_UHCI0_BASE + 0xA4) +#define UHCI0_SEND_Q5_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q5_WORD1_S 0 + +#define UHCI0_REG_Q6_WORD0 ( DR_REG_UHCI0_BASE + 0xA8) +#define UHCI0_SEND_Q6_WORD0 0xFFFFFFFF +#define UHCI0_SEND_Q6_WORD0_S 0 + +#define UHCI0_REG_Q6_WORD1 ( DR_REG_UHCI0_BASE + 0xAC) +#define UHCI0_SEND_Q6_WORD1 0xFFFFFFFF +#define UHCI0_SEND_Q6_WORD1_S 0 + +#define UHCI0_ESC_CONF0 ( DR_REG_UHCI0_BASE + 0xB0) +#define UHCI0_SEPER_ESC_CHAR1 0x000000FF +#define UHCI0_SEPER_ESC_CHAR1_S 16 +#define UHCI0_SEPER_ESC_CHAR0 0x000000FF +#define UHCI0_SEPER_ESC_CHAR0_S 8 +#define UHCI0_SEPER_CHAR 0x000000FF +#define UHCI0_SEPER_CHAR_S 0 + +#define UHCI0_ESC_CONF1 ( DR_REG_UHCI0_BASE + 0xB4) +#define UHCI0_ESC_SEQ0_CHAR1 0x000000FF +#define UHCI0_ESC_SEQ0_CHAR1_S 16 +#define UHCI0_ESC_SEQ0_CHAR0 0x000000FF +#define UHCI0_ESC_SEQ0_CHAR0_S 8 +#define UHCI0_ESC_SEQ0 0x000000FF +#define UHCI0_ESC_SEQ0_S 0 + +#define UHCI0_ESC_CONF2 ( DR_REG_UHCI0_BASE + 0xB8) +#define UHCI0_ESC_SEQ1_CHAR1 0x000000FF +#define UHCI0_ESC_SEQ1_CHAR1_S 16 +#define UHCI0_ESC_SEQ1_CHAR0 0x000000FF +#define UHCI0_ESC_SEQ1_CHAR0_S 8 +#define UHCI0_ESC_SEQ1 0x000000FF +#define UHCI0_ESC_SEQ1_S 0 + +#define UHCI0_ESC_CONF3 ( DR_REG_UHCI0_BASE + 0xBC) +#define UHCI0_ESC_SEQ2_CHAR1 0x000000FF +#define UHCI0_ESC_SEQ2_CHAR1_S 16 +#define UHCI0_ESC_SEQ2_CHAR0 0x000000FF +#define UHCI0_ESC_SEQ2_CHAR0_S 8 +#define UHCI0_ESC_SEQ2 0x000000FF +#define UHCI0_ESC_SEQ2_S 0 + +#define UHCI0_PKT_THRES ( DR_REG_UHCI0_BASE + 0xC0) +#define UHCI0_PKT_THRS 0x00001FFF +#define UHCI0_PKT_THRS_S 0 + +#define UHCI0_DATA ( DR_REG_UHCI0_BASE + 0xFC) +#define UHCI0_UHCI_DATA 0xFFFFFFFF +#define UHCI0_UHCI_DATA_S 0 + +#endif /* _SOC_UHCI0_REG_H_ */ diff --git a/components/esp32/include/xtensa/board.h b/components/esp32/include/xtensa/board.h new file mode 100755 index 000000000..c6b04a250 --- /dev/null +++ b/components/esp32/include/xtensa/board.h @@ -0,0 +1,28 @@ +/* This header is supposed to be obtained from /xtensa/board.h + using a -I directive passed to the compiler. */ + +#error "Unspecified board. Missing -I directive to select supported Xtensa board, usually -I XTENSA_TOOLS_ROOT/xtensa-elf/include/xtensa/ (XTENSA_TOOLS_ROOT is root of Xtensa Tools install, see xt-run --show-config=xttools)" + +/* + * Copyright (c) 2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + diff --git a/components/esp32/include/xtensa/c6x-compat.h b/components/esp32/include/xtensa/c6x-compat.h new file mode 100755 index 000000000..4b17987ea --- /dev/null +++ b/components/esp32/include/xtensa/c6x-compat.h @@ -0,0 +1,1758 @@ +/* + * Copyright (c) 2006-2010 Tensilica Inc. ALL RIGHTS RESERVED. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +#ifndef __C6X_COMPAT__H +#define __C6X_COMPAT__H + +/* Unimplemented functions _gmpy, _gmpy4, _xormpy, _lssub, _cmpy, _cmpyr, + _cmpyr1, _ddotpl2r, _ddotph2r */ + + +typedef long long C6X_COMPAT_LONG40; + + +#define _memd8(a) (*((double*)(a))) +#define _memd8_const(a) (*((const double*)(a))) + +#define _amemd8(a) (*((double*)(a))) +#define _amemd8_const(a) (*((const double*)(a))) + +#define _mem8(a) (*((unsigned long long*)(a))) +#define _mem8_const(a) (*((const unsigned long long*)(a))) + +#define _mem4(a) (*((unsigned*)(a))) +#define _mem4_const(a) (*((const unsigned*)(a))) +#define _amem4_const(a) (*((const unsigned*)(a))) + +/* NOTE: To emulate a C6X properly you should define global variables + for your Xtensa with these names. Some of the emulation routines + will set these values. */ + +extern int _carry; +extern int _overflow; + +// Utility routines + + +#define TESTBIT(x,n) (((x) >> (n)) & 1) + +#define NSA_BITS 32 + +static inline unsigned int norm_shift_amt_U_and_non_U(int is_signed, int inp) { +int j=0, k=0; +int x=inp; +if (is_signed) { + /* Invert signed val if negative */ + x= TESTBIT(x,(NSA_BITS-1))? ~x: x; + x= (x&1)|(x<<1); /* Shift up to return count-1 */ + if (x ==0) + return NSA_BITS-1; + } + if (x ==0) + return NSA_BITS; + /* Now count leading zeros */ + for (j=0, k=NSA_BITS-1; k>=0; j++, k--) { + if (TESTBIT(x,k)) + return j; + } + return NSA_BITS; +} + + + +static inline long long +orig_L40_set( long long L40_var1) { + long long L40_var_out; + + L40_var_out = L40_var1 & 0x000000ffffffffffLL; + + if( L40_var1 & 0x8000000000LL) + L40_var_out = L40_var_out | 0xffffff0000000000LL; + + return( L40_var_out); +} + + + +static inline signed long long +util_saturate_n_no_state(signed long long t, int n) +{ + signed long long maxv, minv; + maxv = (1LL << (n-1)) - 1; + minv = (-1LL << (n-1)); + if (t > maxv) { + t = maxv; + } else if (t < minv) { + t = minv; + } + return t; +} + + +static inline signed long long +util_saturate_n_sgn(signed long long t, int n) +{ + signed long long result; + signed long long maxv, minv; + maxv = (1LL << (n-1)) - 1; + minv = (-1LL << (n-1)); + if (t > 0) { + result = maxv; + _overflow = 1; + } else if (t < 0) { + result = minv; + _overflow = 1; + } else { + result = 0; + } + return result; +} + + + + +/* well-behaved signed shift right (left on negative) with + saturation */ +static inline signed long long +util_shift_right_saturate_n(signed long long t, int shval, int n) +{ + /* n should be <= 62 */ + long long result; + + signed long long mask; + int actual_shift = shval; + long long shft = actual_shift > 0 ? actual_shift : -actual_shift; + + if (t == 0 || actual_shift == 0) + return t; + + if (actual_shift >= n) { + return (t < 0) ? -1 : 0; + } + if (actual_shift <= -n) { + return util_saturate_n_sgn(t, n); + } + if (actual_shift > 0) { + return t >> actual_shift; + } + /* actual_shift < 0. Check for saturation after shift. */ + mask = (-1LL << (n-shft-1)); + if (t > 0 && ((mask & t) != 0)) { + return util_saturate_n_sgn(t, n); + } + if (t < 0 && ((mask & t) != mask)) { + return util_saturate_n_sgn(t, n); + } + result = t << shft; + + return result; +} + + +/* Implemented c6x standard C compatibility functions (alphabetical + order) */ + + +static inline int _abs(int src1) { + if ((unsigned) src1 == (unsigned) 0x80000000) { + return 0x7fffffff; + } + return abs(src1); +} + + +static inline int _abs2(int src1) { + short s1[2],r[2]; + int result; + *((int*)s1) = src1; + if ((unsigned short) s1[1] == (unsigned short) 0x8000) r[1] = 0x7fff; + else r[1] = abs(s1[1]); + if ((unsigned short) s1[0] == (unsigned short) 0x8000) r[0] = 0x7fff; + else r[0] = abs(s1[0]); + result = *(int*)r; + return result; + } + + + + +static inline int _add2(int src1, int src2) { + short s1[2], s2[2], r[2]; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r[0] = s1[0] + s2[0]; + r[1] = s1[1] + s2[1]; + result = *(int*)r; + return result; +} + +static inline int _add4(int src1, int src2) { + char c1[4], c2[4], r[4]; + int result; + *((int*)c1) = src1; + *((int*)c2) = src2; + r[0] = c1[0] + c2[0]; + r[1] = c1[1] + c2[1]; + r[2] = c1[2] + c2[2]; + r[3] = c1[3] + c2[3]; + result = *(int*)r; + return result; +} + + + +static inline long long _addsub(unsigned int src1, unsigned int src2) +{ + + int res_lo; + int res_hi; + + res_hi = src1+src2; + res_lo = src1-src2; + return (((unsigned long long) res_hi) << 32) | ((unsigned int) res_lo) ; +} + + +static inline long long _addsub2(unsigned int src1, unsigned int src2) +{ + short s1[2], s2[2], ra[2], rs[2]; + int res_lo; + int res_hi; + + *((int*)s1) = src1; + *((int*)s2) = src2; + ra[0] = s1[0] + s2[0]; + ra[1] = s1[1] + s2[1]; + rs[0] = s1[0] - s2[0]; + rs[1] = s1[1] - s2[1]; + + res_hi = *(int*)ra; + res_lo = *(int*)rs; + return (((unsigned long long) res_hi) << 32) | ((unsigned int) res_lo) ; +} + + +static inline int _avg2(int src1, int src2) { + int low = (((int)1 + (short) src1 + (short) src2) >> 1) & 0XFFFF; + int high1 = src1 >> 16; + int high2 = src2 >> 16; + int high = ((high1 + high2 + 1) >> 1)<< 16; + return high | low; +} + + + +static inline unsigned int _avgu4(unsigned int src1, unsigned int src2) { +unsigned int res0 = ((src1 & 0xFF) + (src2 & 0xFF) + 1) >> 1; + unsigned int res1 = (((src1 & 0xFF00) >> 8) + ((src2 & 0xFF00) >> 8) + 1) >> 1; + unsigned int res2 = (((src1 & 0xFF0000) >> 16) + ((src2 & 0xFF0000) >> 16) + 1) >> 1; + unsigned int res3 = (((src1 & 0xFF000000) >> 24) + ((src2 & 0xFF000000) >> 24) + 1) >> 1; + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; +} + + +static inline int TEN_popc (unsigned char b) +{ + int i, result = 0; + for (i = 0; i < 8; i++){ + if (b & 0x1) + result++; + b >>= 1; + } + return result; +} + +static inline unsigned int _bitc4(unsigned int src1) +{ + unsigned int res0 = TEN_popc(src1 & 0xFF); + unsigned int res1 = TEN_popc((src1 & 0xFF00) >> 8); + unsigned int res2 = TEN_popc((src1 & 0xFF0000) >> 16); + unsigned int res3 = TEN_popc((src1 & 0xFF000000) >> 24); + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; +} + +static inline unsigned int _bitr(unsigned int src) { + int i; + unsigned r = 0; + for (i = 0; i< 32; ++i) { + r = r | (((src >> i) & 1)<<(31-i)); + } + return r; +} + + +static inline unsigned int _clr(unsigned int src2, int csta, int cstb) +{ + csta &= 0x1f; + cstb &= 0x1f; + if (csta > cstb) + return src2; + else { + unsigned int mask = (((1 << (cstb - csta)) << 1) - 1) << csta; + return src2 & (~mask); + } +} + +static inline unsigned int _clrr(unsigned int src2, int src1) +{ + unsigned int csta = (src1 >> 5) & 0x1f; + unsigned int cstb = src1 & 0x1f; + if (csta > cstb) + return src2; + else { + unsigned int mask = (((1 << (cstb - csta)) << 1) - 1) << csta; + return src2 & (~mask); + } +} + + + + +static inline int _cmpeq2(int src1, int src2) { + short s1[2], s2[2]; + int r0, r1; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r0 = s1[0] == s2[0] ? 1 : 0; + r1 = s1[1] == s2[1] ? 1 : 0; + result = (r1 << 1) | r0; + return result; +} + +static inline int _cmpeq4(int src1, int src2) { + char s1[4], s2[4]; + int r0, r1, r2, r3; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r0 = s1[0] == s2[0] ? 1 : 0; + r1 = s1[1] == s2[1] ? 1 : 0; + r2 = s1[2] == s2[2] ? 1 : 0; + r3 = s1[3] == s2[3] ? 1 : 0; + result = (r3 << 3) | (r2 << 2) | (r1 << 1) | r0; + return result; +} + + +static inline int _cmpgt2(int src1, int src2) { + short s1[2], s2[2]; + int r1, r0; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r0 = s1[0] > s2[0] ? 1 : 0; + r1 = s1[1] > s2[1] ? 1 : 0; + result = (r1<<1) | r0; + return result; +} + + +static inline unsigned int _cmpgtu4(unsigned int src1, unsigned int src2) { + unsigned int s1_0 = (src1 & 0xFF); + unsigned int s1_1 = (src1 & 0xFF00) >> 8; + unsigned int s1_2 = (src1 & 0xFF0000) >> 16; + unsigned int s1_3 = (src1 & 0xFF000000) >> 24; + + unsigned int s2_0 = (src2 & 0xFF); + unsigned int s2_1 = (src2 & 0xFF00) >> 8; + unsigned int s2_2 = (src2 & 0xFF0000) >> 16; + unsigned int s2_3 = (src2 & 0xFF000000) >> 24; + + unsigned int result = 0; + + if (s1_0 > s2_0) + result |= 0x1; + + if (s1_1 > s2_1) + result |= 0x2; + + if (s1_2 > s2_2) + result |= 0x4; + + if (s1_3 > s2_3) + result |= 0x8; + + return result; +} + + + + +static inline long long _ddotp4(unsigned int src1, unsigned int src2) { + unsigned int res0, res1; + short s1_0 = (src1 & 0xffff); + short s1_1 = (src1 & 0xfff0000) >> 16; + + unsigned short s2_0 = (src2 & 0xff); + unsigned short s2_1 = (src2 & 0xff00) >> 8; + unsigned short s2_2 = (src2 & 0xff0000) >> 16; + unsigned short s2_3 = (src2 & 0xff000000) >> 24; + + res0 = ((int)s1_0) * s2_0 + ((int)s1_1) * s2_1; + res1 = ((int)s1_0) * s2_2 + ((int)s1_1) * s2_3; + + return (res1 << 16) | res0; +} + + +static inline long long _ddotph2(long long src1_o_src1_e, unsigned int src2) +{ + + unsigned int src1_o = src1_o_src1_e >> 32; + unsigned int src1_e = src1_o_src1_e & 0xFFFFFFFF; + short ls1_o = src1_o & 0XFFFF; + short hs1_o = src1_o >> 16; +// short ls1_e = src1_e & 0XFFFF; + short hs1_e = src1_e >> 16; + short ls2 = src2 & 0XFFFF; + short hs2 = src2 >> 16; + + unsigned long long res_hi = ls2 * ls1_o + hs2 * hs1_o; + unsigned int res_lo = ls1_o * hs2 + hs1_e * ls2; + return (res_hi << 32) | res_lo; +} + + +static inline long long _ddotpl2(long long src1_o_src1_e, unsigned int src2) +{ + unsigned int src1_o = src1_o_src1_e >> 32; + unsigned int src1_e = src1_o_src1_e & 0xFFFFFFFF; + short ls1_o = src1_o & 0XFFFF; +// short hs1_o = src1_o >> 16; + short ls1_e = src1_e & 0XFFFF; + short hs1_e = src1_e >> 16; + short ls2 = src2 & 0XFFFF; + short hs2 = src2 >> 16; + + unsigned long long res_hi = ls2 * hs1_e + hs2 * ls1_o; + unsigned res_lo = hs1_e * hs2 + ls1_e * ls2; + return (res_hi << 32) | res_lo; +} + + +static inline unsigned int _deal(unsigned int src) +{ + int i; + unsigned short lo = 0, hi = 0; + for (i = 0; i < 32; i+= 2) { + lo >>= 1; + lo |= (src & 0x1) << 15; + src >>= 1; + hi >>= 1; + hi |= (src & 0x1) << 15; + src >>= 1; + } + return (hi << 16) | lo; +} + + +static inline long long _dmv(unsigned int src1, unsigned int src2) +{ + return (((long long) src1) << 32) | src2; +} + + +static inline int _dotpn2(int src1, int src2) { +short int s1_h = src1>>16; + short int s1_l = src1; + short int s2_h = src2>>16; + short int s2_l = src2; + return s1_h * s2_h - s1_l * s2_l; +} + + +static inline int _dotp2(int src1, int src2) { + short int s1_h = src1>>16; + short int s1_l = src1; + short int s2_h = src2>>16; + short int s2_l = src2; + return s1_h * s2_h + s1_l * s2_l; +} + + + +static inline int _dotpnrsu2(int src1, unsigned int src2) +{ + short ls1 = src1 & 0XFFFF; + unsigned short ls2 = src2 & 0XFFFF; + short hs1 = src1 >> 16; + unsigned short hs2 = src2 >> 16; + + int result = (((long long) (int)(hs1 * hs2)) - ((long long) (int)(ls1 * ls2)) + (1 << 15)) >> 16; + return result; +} + + + +static inline int _dotprsu2(int src1, unsigned int src2) { + short ls1 = src1 & 0XFFFF; + unsigned short ls2 = (src2 & 0XFFFF); + short hs1 = src1 >> 16; + unsigned short hs2 = (src2 >> 16); + + int result = (((long long) (int) (ls1 * ls2)) + ((long long) (int) (hs1 * hs2)) + (1LL << 15)) >> 16; + return result; +} + + + + + + + +static inline int _dotpsu4(int src1, unsigned int src2) { + int result; + signed char s1_0 = (src1 & 0xff); + signed char s1_1 = (src1 & 0xff00) >> 8; + signed char s1_2 = (src1 & 0xff0000) >> 16; + signed char s1_3 = (src1 & 0xff000000) >> 24; + + unsigned int s2_0 = (src2 & 0xff); + unsigned int s2_1 = (src2 & 0xff00) >> 8; + unsigned int s2_2 = (src2 & 0xff0000) >> 16; + unsigned int s2_3 = (src2 & 0xff000000) >> 24; + + result = s1_0 * s2_0 + s1_1 * s2_1 + s1_2 * s2_2 + s1_3 * s2_3; + return result; +} + + +static inline unsigned int _dotpu4(unsigned int src1, unsigned int src2) { + unsigned char v1_0 = src1 & 0xff; + unsigned char v1_1 = (src1>>8) & 0xff; + unsigned char v1_2 = (src1>>16) & 0xff; + unsigned char v1_3 = (src1>>24) & 0xff; + + unsigned char v2_0 = src2 & 0xff; + unsigned char v2_1 = (src2>>8) & 0xff; + unsigned char v2_2 = (src2>>16) & 0xff; + unsigned char v2_3 = (src2>>24) & 0xff; + + unsigned v = v1_0 * v2_0 + v1_1 * v2_1 + v1_2 * v2_2 + v1_3 * v2_3; + return v; +} + + +static inline long long _dpack2(unsigned int src1, unsigned int src2){ +unsigned short s1[2], s2[2]; +*((int*)s1) = src1; +*((int*)s2) = src2; +return ((unsigned long long) s1[1] << 48) | ((unsigned long long) s2[1] << 32) | ((unsigned long long) s1[0] << 16) | ((unsigned long long) s2[0]); +} + + +static inline long long _dpackx2(unsigned int src1, unsigned int src2){ +unsigned short s1[2], s2[2]; +*((int*)s1) = src1; +*((int*)s2) = src2; +return ((unsigned long long) s2[0] << 48) | ((unsigned long long) s1[1] << 32) | ((unsigned long long) s1[0] << 16) | ((unsigned long long) s2[1]); +} + +static inline int _ext(int src2, unsigned int csta, unsigned int cstb) +{ + return (src2 << csta) >> cstb; +} + +static inline int _extr(int src2, int src1) +{ + unsigned int csta = (src1 >> 5) & 0x1f; + unsigned int cstb = src1 & 0x1f; + return (src2 << csta) >> cstb; +} + +static inline unsigned int _extu(unsigned int src2, unsigned int csta, unsigned int cstb) +{ + return (src2 << csta) >> cstb; +} + +static inline unsigned int _extur(unsigned int src2, int src1) +{ + unsigned int csta = (src1 >> 5) & 0x1f; + unsigned int cstb = src1 & 0x1f; + return (src2 << csta) >> cstb; +} + + +static inline unsigned long long _hi(double src) { + unsigned long long v; + *(double*)&v = src; + return v>>32; +} + +static inline unsigned int _hill (long long src) +{ + return (unsigned int) (src >> 32); +} + + + +static inline double _itod(unsigned hi, unsigned lo) { + double v; + unsigned long long ll = ((((unsigned long long)(hi))<<32) | (unsigned long long)((unsigned)lo)); + *((unsigned long long *)&v) = ll; + return v; +} + + +static inline long long _itoll(unsigned int src2, unsigned int src1) +{ + return (((long long) src2) << 32) | src1; +} + + +static inline C6X_COMPAT_LONG40 _labs(C6X_COMPAT_LONG40 src2) +{ + long long maxv = (1LL << (40 -1)) - 1; + long long minv = (-1LL << (40 - 1)); + C6X_COMPAT_LONG40 lres = orig_L40_set(src2); + + lres = lres < 0 ? -lres : lres; + if (lres > maxv) lres = maxv; + else if (lres < minv) lres = minv; + + return lres; +} + + +static inline C6X_COMPAT_LONG40 _ldotp2(int src1, int src2) { +return (C6X_COMPAT_LONG40) _dotp2(src1, src2); +} + + +static inline unsigned int _lmbd(unsigned int src1, unsigned int src2) +{ + return norm_shift_amt_U_and_non_U(0,(((int) (src1 << 31)) >> 31) ^ (~src2)); +} + + +static inline unsigned int _lnorm(C6X_COMPAT_LONG40 src2) { +if (src2 == 0) + return 39; + else { + int hi = (int)(src2 >> 32); + int lo = (int)src2; + + + long long temp = (unsigned long long)(unsigned)lo | (unsigned long long)hi << 32; + temp = orig_L40_set(temp); + + if (temp == 0) return 0; + int cnt = 0; + while (((temp >> 39) & 1) == ((temp >> 38) & 1)) { + temp <<= 1; + cnt++; + } + return cnt; + } +} + + +static inline unsigned long long _lo(double src) { + unsigned long long v; + *(double*)&v = src; + return v; +} + + +static inline unsigned int _loll (long long src) +{ + return (unsigned int) src; +} + + +static inline C6X_COMPAT_LONG40 _lsadd(int src1, C6X_COMPAT_LONG40 src2) +{ + long long maxv = (1LL << (40 -1)) - 1; + long long minv = (-1LL << (40 - 1)); + int hi = (int)(src2 >> 32); + int lo = (int)src2; + long long src2_int = (unsigned long long)(unsigned)lo | (unsigned long long)hi << 32; + + + long long src2_int2 = orig_L40_set(src2_int); + + long long res = src1 + src2_int2; + + if (res > maxv) { + res = maxv; + _overflow = 1; + } + else if (res < minv) { + res = minv; + _overflow = 1; + } + + long long res2 = orig_L40_set(res); + + res2 = (signed char)(res2 >> 32); + + C6X_COMPAT_LONG40 lres = (((C6X_COMPAT_LONG40) res2) << 32) | ((unsigned int)res); + return lres; +} + + + +static inline int _max2 (int src1, int src2) { + short s1[2], s2[2], r[2]; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r[0] = s1[0] > s2[0] ? s1[0] : s2[0]; + r[1] = s1[1] > s2[1] ? s1[1] : s2[1]; + result = *(int*)r; + return result; +} + + + + + + +static inline unsigned int _maxu4(unsigned int src1, unsigned int src2) { + unsigned int res0, res1, res2, res3; + unsigned int s1_0 = res0 = (src1 & 0xFF); + unsigned int s1_1 = res1 = (src1 & 0xFF00) >> 8; + unsigned int s1_2 = res2 = (src1 & 0xFF0000) >> 16; + unsigned int s1_3 = res3 = (src1 & 0xFF000000) >> 24; + + unsigned int s2_0 = (src2 & 0xFF); + unsigned int s2_1 = (src2 & 0xFF00) >> 8; + unsigned int s2_2 = (src2 & 0xFF0000) >> 16; + unsigned int s2_3 = (src2 & 0xFF000000) >> 24; + +// unsigned int res = 0; + + if (s1_0 < s2_0) + res0 = s2_0; + + if (s1_1 < s2_1) + res1 = s2_1; + + if (s1_2 < s2_2) + res2 = s2_2; + + if (s1_3 < s2_3) + res3 = s2_3; + + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; + + +} + +static inline int _min2(int src1, int src2) { + short s1[2], s2[2], r[2]; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r[0] = s1[0] < s2[0] ? s1[0] : s2[0]; + r[1] = s1[1] < s2[1] ? s1[1] : s2[1]; + result = *(int*)r; + return result; +} + + +static inline unsigned int _minu4(unsigned int src1, unsigned int src2) { +unsigned int res0, res1, res2, res3; + unsigned int s1_0 = res0 = (src1 & 0xFF); + unsigned int s1_1 = res1 = (src1 & 0xFF00) >> 8; + unsigned int s1_2 = res2 = (src1 & 0xFF0000) >> 16; + unsigned int s1_3 = res3 = (src1 & 0xFF000000) >> 24; + + unsigned int s2_0 = (src2 & 0xFF); + unsigned int s2_1 = (src2 & 0xFF00) >> 8; + unsigned int s2_2 = (src2 & 0xFF0000) >> 16; + unsigned int s2_3 = (src2 & 0xFF000000) >> 24; + +// unsigned int res = 0; + + if (s1_0 > s2_0) + res0 = s2_0; + + if (s1_1 > s2_1) + res1 = s2_1; + + if (s1_2 > s2_2) + res2 = s2_2; + + if (s1_3 > s2_3) + res3 = s2_3; + + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; +} + + +static inline int _mpy(int src1, int src2) { +return (short) src1 * (short) src2; +} + + +static inline int _mpyh(int src1, int src2) { +return (short) (src1 >> 16) * (short) (src2 >> 16); +} + + +static inline long long _mpyhill (int src1, int src2) +{ + short s1 = src1 >> 16; + return ((long long) src2) * s1; +} + +static inline int _mpyhir(int src1, int src2) +{ + short s1 = src1 >> 16; + long long result = ((long long) src2) * s1 + (1 << 14); + result >>= 15; + return result; +} + + +static inline int _mpyhl(int src1, int src2) { +return (short) (src1 >> 16) * (short) (src2); +} + +static inline unsigned int _mpyhlu(unsigned int src1, unsigned int src2) { +return (unsigned short) (src1 >> 16) * (unsigned short) (src2); +} + +static inline int _mpyhslu(int src1, unsigned int src2) { +return (short) (src1 >> 16) * (unsigned short) src2; +} + + +static inline int _mpyhsu(int src1, unsigned int src2) { +return (short) (src1 >>16) * (unsigned short) (src2 >>16); +} + + +static inline unsigned int _mpyhu(unsigned int src1, unsigned int src2) { +return (unsigned short) (src1 >>16) * (unsigned short) (src2 >> 16); +} + + +static inline int _mpyhuls(unsigned int src1, int src2) { +return (unsigned short) (src1 >>16) * (signed short) (src2); +} + + +static inline int _mpyhus(unsigned int src1, int src2) { +return (unsigned short) (src1 >> 16) * (short) (src2 >>16); +} + + + +static inline long long _mpyidll (int src1, int src2) +{ + return (long long) src1 * src2; +} + + +static inline int _mpylh(int src1, int src2) { +return (signed short) (src1 & 0xffff) * (signed short) (src2 >> 16); +} + +static inline unsigned int _mpylhu(unsigned int src1, unsigned int src2) { +return (unsigned short) src1 * (unsigned short) (src2 >> 16); +} + + +static inline long long _mpylill (int src1, int src2) +{ + return ((long long) src2) * ((short)src1); +} + + + +static inline int _mpylir(int src1, int src2) +{ + short s1 = src1; + long long result = ((long long) src2) * s1 + (1 << 14); + result >>= 15; + return result; +} + + +static inline int _mpylshu(int src1, unsigned int src2) { +return (short) src1 * (unsigned short) (src2 >> 16); +} + + +static inline int _mpyluhs(unsigned int src1, int src2) { +return (unsigned short) src1 * (short) (src2 >> 16); +} + + + +static inline int _mpysu(int src1, unsigned int src2) { +return (short) src1 * (unsigned short) src2; +} + + + +static inline long long _mpysu4ll (int src1, unsigned int src2) { + unsigned short res0, res1, res2, res3; + signed char s1_0 = (src1 & 0xff); + signed char s1_1 = (src1 & 0xff00) >> 8; + signed char s1_2 = (src1 & 0xff0000) >> 16; + signed char s1_3 = (src1 & 0xff000000) >> 24; + + unsigned short s2_0 = (src2 & 0xff); + unsigned short s2_1 = (src2 & 0xff00) >> 8; + unsigned short s2_2 = (src2 & 0xff0000) >> 16; + unsigned short s2_3 = (src2 & 0xff000000) >> 24; + + res0 = s1_0 * s2_0; + res1 = s1_1 * s2_1; + res2 = s1_2 * s2_2; + res3 = s1_3 * s2_3; + + return (((unsigned long long) res3) << 48) + | (((unsigned long long) res2) << 32) + | (((unsigned long long) res1) << 16) + | res0; +} + +static inline unsigned int _mpyu(unsigned int src1, unsigned int src2) { + unsigned v = (unsigned short)src1 * (unsigned short)src2; + return v; +} + +static inline int _mpyus(unsigned int src1, int src2) { +return (unsigned short) src1 * (short) src2; +} + +static inline long long _mpyu4ll (unsigned int src1, unsigned int src2) { + unsigned short res0, res1, res2, res3; + unsigned char s1_0 = (src1 & 0xff); + unsigned char s1_1 = (src1 & 0xff00) >> 8; + unsigned char s1_2 = (src1 & 0xff0000) >> 16; + unsigned char s1_3 = (src1 & 0xff000000) >> 24; + + unsigned short s2_0 = (src2 & 0xff); + unsigned short s2_1 = (src2 & 0xff00) >> 8; + unsigned short s2_2 = (src2 & 0xff0000) >> 16; + unsigned short s2_3 = (src2 & 0xff000000) >> 24; + + res0 = s1_0 * s2_0; + res1 = s1_1 * s2_1; + res2 = s1_2 * s2_2; + res3 = s1_3 * s2_3; + + return (((unsigned long long) res3) << 48) + | (((unsigned long long) res2) << 32) + | (((unsigned long long) res1) << 16) + | res0; +} + + +static inline long long _mpy2ir(unsigned int src1, unsigned int src2) +{ + if ((src1 == 0x8000) && (src2 == 0x80000000)) { + _overflow = 1; + return 0; + } + else { + short ls1 = src1 & 0xffff; + short hs1 = src1 >> 16; + unsigned long long hi = (((long long) hs1) * (int) src2 + (1 << 14)) >> 15; + unsigned long long lo = ((((long long) ls1) * (int) src2 + (1 << 14)) >> 15) & 0xFFFFFFFF; + return (hi << 32) | lo; + } +} + + +static inline long long _mpy2ll (int src1, int src2) { + short ls1 = src1 & 0xffff; + short hs1 = src1 >> 16; + short ls2 = src2 & 0xffff; + short hs2 = src2 >> 16; + + unsigned long long hi = hs1 * hs2; + unsigned long long lo = (ls1 * ls2) & 0xFFFFFFFF; + + return (hi << 32) | lo; + +} + + +static inline int _mpy32(int src1, int src2) +{ + return src1 * src2; +} + + +static inline long long _mpy32ll(int src1, int src2) +{ + return ((long long) src1) * src2; +} + +static inline long long _mpy32su(int src1, unsigned int src2) +{ + return ((long long) src1) * ((int) src2); +} + +static inline long long _mpy32u(unsigned int src1, unsigned int src2) +{ + return ((long long) ((int) src1)) * ((long long) ((int) src2)); +} + +static inline long long _mpy32us(unsigned int src1, int src2) +{ + return ((int) src1) * ((long long) src2); +} + +static inline int _mvd (int src2) +{ + return src2; +} + + +static inline unsigned int _norm(int src2) +{ + return norm_shift_amt_U_and_non_U(1,src2); +} + + +static inline unsigned int _pack2 (unsigned int src1, unsigned int src2) { + short s1[2], s2[2], r[2]; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r[0] = s2[0]; + r[1] = s1[0]; + result = *(int*)r; + return result; +} + + +static inline int _packh2 (unsigned int src1, unsigned int src2) { + unsigned v0 = src1 & 0xffff0000; + unsigned v1 = src2 >> 16; + unsigned v = v0|v1; + return v; + +} + +static inline unsigned int _packh4 (unsigned int src1, unsigned int src2) { + unsigned v3 = (src1 >> 24) & 0xff; + unsigned v2 = (src1 >> 8) & 0xff; + unsigned v1 = (src2 >> 24) & 0xff; + unsigned v0 = (src2 >> 8) & 0xff; + unsigned v = (v3<<24) | (v2<<16) | (v1 << 8) | v0; + return v; +} + +static inline unsigned int _packhl2 (unsigned int src1, unsigned int src2) { + unsigned v0 = src1 & 0xffff0000; + unsigned v1 = src2 & 0x0000ffff; + unsigned v = v0|v1; + return v; +} + +static inline unsigned int _packlh2 (unsigned int src1, unsigned int src2) { + unsigned v0 = src1 << 16; + unsigned v1 = (src2 >> 16) & 0xffff; + unsigned v = v0|v1; + return v; +} + + + + +static inline unsigned int _packl4 (unsigned int src1, unsigned int src2) { + unsigned v3 = (src1 >> 16) & 0xff; + unsigned v2 = (src1) & 0xff; + unsigned v1 = (src2 >> 16) & 0xff; + unsigned v0 = (src2) & 0xff; + unsigned v = (v3<<24) | (v2<<16) | (v1 << 8) | v0; + return v; +} + + + + +static inline unsigned int _rpack2 (unsigned int src1, unsigned int src2) { +int s1 = (int) src1; +int s2 = (int) src2; +s1 = util_shift_right_saturate_n (s1, -1, 32); +s2 = util_shift_right_saturate_n (s2, -1, 32); +return (unsigned int) (s1 & 0xffff0000) | (unsigned int) ((s2 & 0xffff0000) >>16); +} + + +static inline unsigned int _rotl (unsigned int src1, unsigned int src2) +{ + src2 &= 0x1f; + return (src1 << src2) | (src1 >> (32 - src2)); +} + + +static inline int _sadd(int src1, int src2) { +signed long long res; +signed long long maxv, minv; +maxv = (1LL << (32-1)) - 1; +minv = (-1LL << (32-1)); +res = (long long) src1 + (long long) src2; +if (res > maxv) { + res = maxv; + _overflow = 1; + } +else if (res < minv ) { + res = minv; + _overflow = 1; + } +return (int) res; +} + +static inline long long _saddsub(unsigned int src1, unsigned int src2) { +int radd; +signed long long rsub; + +signed long long maxv, minv; +maxv = (1LL << (32-1)) - 1; +minv = (-1LL << (32-1)); + +radd = (int) src1 + (int) src2; + +// saturate on subtract, not add + + +rsub = (long long) ((int) src1) - (long long) ((int) src2); +if (rsub > maxv) { + rsub = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (rsub < minv ) { + rsub = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + +return (((unsigned long long) radd) << 32) | ( rsub & 0x00000000ffffffff ) ; +} + + + +static inline long long _saddsub2(unsigned int src1, unsigned int src2) { +signed int radd[2]; +signed int rsub[2]; +signed short s1[2], s2[2]; + +signed int maxv, minv; +maxv = (1L << (16-1)) - 1; +minv = (-1L << (16-1)); + +*((int*)s1) = src1; +*((int*)s2) = src2; + +radd[0] = (int) s1[0] + (int) s2[0]; +radd[1] = (int) s1[1] + (int) s2[1]; + +rsub[0] = (int) s1[0] - (int) s2[0]; +rsub[1] = (int) s1[1] - (int) s2[1]; + +if (radd[0] > maxv) { + radd[0] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (radd[0] < minv ) { + radd[0] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + +if (radd[1] > maxv) { + radd[1] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (radd[1] < minv ) { + radd[1] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + + +if (rsub[0] > maxv) { + rsub[0] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (rsub[0] < minv ) { + rsub[0] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + +if (rsub[1] > maxv) { + rsub[1] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (rsub[1] < minv ) { + rsub[1] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + + +return ((((unsigned long long) radd[1]) & 0x000000000000ffff) << 48) | + ((((unsigned long long) radd[0]) & 0x000000000000ffff) << 32) | + ((((unsigned long long) rsub[1]) & 0x000000000000ffff) << 16) | + ((((unsigned long long) rsub[0]) & 0x000000000000ffff)); +} + + + +static inline int _sadd2(int src1, int src2) { +signed short s1[2], s2[2]; +signed int r[2], maxv, minv; + +maxv = (1L << (16-1)) - 1; +minv = (-1L << (16-1)); + + +*((int*)s1) = src1; +*((int*)s2) = src2; + +r[0] = (int) s1[0] + (int) s2[0]; +r[1] = (int) s1[1] + (int) s2[1]; + +if (r[0] > maxv) { + r[0] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (r[0] < minv ) { + r[0] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +if (r[1] > maxv) { + r[1] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (r[1] < minv ) { + r[1] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + +return ((r[1] & 0xffff) << 16 ) | (r[0] & 0xffff) ; +} + + +static inline int _saddus2(unsigned int src1, int src2) { +int res0, res1; + unsigned int s1_0 = (src1 & 0xffff); + unsigned int s1_1 = (src1 & 0xffff0000) >> 16; + + short s2_0 = (src2 & 0xffff); + short s2_1 = (src2 & 0xffff0000) >> 16; + + res0 = s1_0 + s2_0; + res1 = s1_1 + s2_1; + + if (res0 >= 0x10000) + res0 = 0xffff; + else if (res0 < 0) + res0 = 0; + + if (res1 >= 0x10000) + res1 = 0xffff; + else if (res1 < 0) + res1 = 0; + + return (res1 << 16) | res0; +} + + +static inline unsigned int _saddu4(unsigned int src1, unsigned int src2) { +unsigned int res0, res1, res2, res3; + unsigned int s1_0 = (src1 & 0xff); + unsigned int s1_1 = (src1 & 0xff00) >> 8; + unsigned int s1_2 = (src1 & 0xff0000) >> 16; + unsigned int s1_3 = (src1 & 0xff000000) >> 24; + + unsigned int s2_0 = (src2 & 0xff); + unsigned int s2_1 = (src2 & 0xff00) >> 8; + unsigned int s2_2 = (src2 & 0xff0000) >> 16; + unsigned int s2_3 = (src2 & 0xff000000) >> 24; + + res0 = s1_0 + s2_0; + res1 = s1_1 + s2_1; + res2 = s1_2 + s2_2; + res3 = s1_3 + s2_3; + + if (res0 >= 0x100) + res0 = 0xff; + + if (res1 >= 0x100) + res1 = 0xff; + + if (res2 >= 0x100) + res2 = 0xff; + + if (res3 >= 0x100) + res3 = 0xff; + + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; + +} + + + +static inline int _sat(C6X_COMPAT_LONG40 src2) +{ + long long maxv = (1LL << (32-1)) - 1; + long long minv = (-1LL << (32-1)); + + int hi = (int)(src2 >> 32); + int lo = (int)src2; + long long temp = (unsigned long long)(unsigned)lo | (unsigned long long)hi << 32; + temp = orig_L40_set(temp); + + if (temp > maxv) { + temp = maxv; + _overflow = 1; + } + else if (temp < minv) { + temp = minv; + _overflow = 1; + } + return (int) temp; +} + +static inline unsigned int _set(unsigned int src2, unsigned int csta, unsigned int cstb) +{ + csta &= 0x1f; + cstb &= 0x1f; + if (csta > cstb) + return src2; + else { + unsigned int mask = (((1 << (cstb - csta)) << 1) - 1) << csta; + return src2 | mask; + } +} + +static inline unsigned int _setr(unsigned int src2, int src1) +{ + unsigned int csta = (src1 >> 5) & 0x1f; + unsigned int cstb = src1 & 0x1f; + if (csta > cstb) + return src2; + else { + unsigned int mask = (((1 << (cstb - csta)) << 1) - 1) << csta; + return src2 | mask; + } +} + + +static inline unsigned int _shfl (unsigned int src2) +{ + unsigned short lo = src2; + unsigned short hi = src2 >> 16; + unsigned int result = 0; + int i; + for (i = 0; i < 32; i+= 2) { + result >>= 1; + result |= (lo & 0x1) << 31; + lo >>= 1; + result >>= 1; + result |= (hi & 0x1) << 31; + hi >>= 1; + } + return result; +} + +static inline long long _shfl3 (unsigned int src1, unsigned int src2) +{ + unsigned short lo = src2; + unsigned short hi = src1 >> 16; + unsigned short mid = src1; + unsigned long long result = 0; + int i; + for (i = 0; i < 32; i+= 2) { + result >>= 1; + result |= ((unsigned long long) (lo & 0x1)) << 47; + lo >>= 1; + result >>= 1; + result |= ((unsigned long long) (mid & 0x1)) << 47; + mid >>= 1; + result >>= 1; + result |= ((unsigned long long) (hi & 0x1)) << 47; + hi >>= 1; + } + return result; +} + + + +static inline unsigned int _shlmb (unsigned int src1, unsigned int src2) +{ + return (src2 << 8) | (src1 >> 24); +} + +static inline unsigned int _shrmb (unsigned int src1, unsigned int src2) +{ + return (src2 >> 8) | (src1 << 24); +} + + +static inline unsigned int _shru2 (unsigned int src1, unsigned int src2) { +unsigned short hs1 = src1 >> 16; + unsigned short ls1 = src1 & 0xFFFF; + hs1 >>= src2; + ls1 >>= src2; + return (hs1 << 16) | ls1; +} + + +static inline int _shr2 (int src1, unsigned int src2) { + short s1[2], result[2]; + *((int*)s1) = src1; + src2 = src2 & 31; + result[0] = (int)s1[0] >> src2; + result[1] = (int)s1[1] >> src2; + + return *(int*)result; +} + + +static inline int _smpy (int src1, int src2) { +unsigned long long result; +result = (((short) src1 * (short) src2) << 1); + +if ((result & 0xffffffff) == 0x80000000){ + result = 0x7fffffff; + _overflow = 1; + } +return (int) (result); +} + +static inline int _smpyh (int src1, int src2) { +unsigned long long result; +result = ((short) (src1 >> 16) * (short) (src2 >> 16)) << 1; +if ((result & 0xffffffff) == 0x80000000){ + result = 0x7fffffff; + _overflow = 1; + } +return (int) (result); +} + +static inline int _smpyhl (int src1, int src2) { +unsigned long long result; +result = ((short) (src1 >> 16) * (short) (src2)) << 1; +if ((result & 0xffffffff) == 0x80000000){ + result = 0x7fffffff; + _overflow = 1; + } +return (int) (result); +} + +static inline int _smpylh (int src1, int src2) { +unsigned long long result; +result = ((short) (src1) * (short) (src2 >> 16)) << 1; +if ((result & 0xffffffff) == 0x80000000){ + result = 0x7fffffff; + _overflow = 1; + } +return (int) (result); +} + +static inline long long _smpy2ll (int src1, int src2) { + short ls1 = src1 & 0XFFFF; + short hs1 = src1 >> 16; + short ls2 = src2 & 0XFFFF; + short hs2 = src2 >> 16; + + unsigned long long hi = (hs1 * hs2) << 1; + unsigned long long lo = ((ls1 * ls2) << 1) & 0xFFFFFFFF; + if ((hi & 0xffffffff) == 0x80000000){ + hi = 0x7fffffff; + _overflow = 1; + } + + if ((lo & 0xffffffff) == 0x80000000){ + lo = 0x7fffffff; + _overflow = 1; + } + + return (hi << 32) | lo; +} + + + + +static inline int _smpy32(int src1, int src2) +{ + long long res = (long long) src1 * src2; + res <<= 1; + res >>= 32; + return res; +} + +static inline unsigned char TEN_satu8 (short src) +{ + if (src > 0xff) + return 0xff; + else if (src < 0) + return 0; + else + return src; +} + +static inline int _spack2 (int src1, int src2) { +short s1 = (short) util_saturate_n_no_state(src1,16); +short s2 = (short) util_saturate_n_no_state(src2,16); +return ( (unsigned int) s1 << 16) | (((int) s2) & 0xFFFF); +} + + +static inline unsigned int _spacku4 (int src1, int src2) { + short lolo = src2; + short lohi = src2 >> 16; + short hilo = src1; + short hihi = src1 >> 16; + + lolo = TEN_satu8(lolo); + lohi = TEN_satu8(lohi); + hilo = TEN_satu8(hilo); + hihi = TEN_satu8(hihi); + + return (((unsigned int) hihi) << 24) | (((unsigned int) hilo) << 16) | (lohi << 8) | lolo; +} + + + +static inline int _sshl (int src1, unsigned int src2) { +short local2 = (short)(src2 & 0x7FFF); +return (int) util_shift_right_saturate_n(src1, -local2, 32); +} + + + + +static inline int _sshvl (int src2, int src1) { + short s1; + if (src1 > 31) + s1 = 31; + else if (src1 < -31) + s1 = -31; + else + s1 = src1; + + return (int) util_shift_right_saturate_n(src2, -s1, 32); +} + + + + + +static inline int _sshvr (int src2, int src1) { +short s1; + if (src1 > 31) + s1 = 31; + else if (src1 < -31) + s1 = -31; + else + s1 = src1; + return (int) util_shift_right_saturate_n(src2, s1, 32); +} + + + + +static inline int _ssub(int src1, int src2) { +signed long long res; +signed long long maxv, minv; +maxv = (1LL << (32-1)) - 1; +minv = (-1LL << (32-1)); +res = (long long) src1 - (long long) src2; +if (res > maxv) { + res = maxv; + _overflow = 1; + } +else if (res < minv ) { + res = minv; + _overflow = 1; + } +return (int) res; +} + +static inline int _ssub2(int src1, int src2) { +signed short s1[2], s2[2]; +signed int r[2], maxv, minv; + +maxv = (1L << (16-1)) - 1; +minv = (-1L << (16-1)); + + +*((int*)s1) = src1; +*((int*)s2) = src2; + +r[0] = (int) s1[0] - (int) s2[0]; +r[1] = (int) s1[1] - (int) s2[1]; + +if (r[0] > maxv) { + r[0] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (r[0] < minv ) { + r[0] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +if (r[1] > maxv) { + r[1] = maxv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } +else if (r[1] < minv ) { + r[1] = minv; + /* NOTE: TI c6x does NOT set the overflow register even if results saturate */ + /* _overflow = 1; */ + } + +return ((r[1] & 0xffff) << 16 ) | (r[0] & 0xffff) ; +} + + +static inline int _subabs4 (int src1, int src2) { + int res0, res1, res2, res3; + unsigned int s1_0 = (src1 & 0xff); + unsigned int s1_1 = (src1 & 0xff00) >> 8; + unsigned int s1_2 = (src1 & 0xff0000) >> 16; + unsigned int s1_3 = (src1 & 0xff000000) >> 24; + + unsigned int s2_0 = (src2 & 0xff); + unsigned int s2_1 = (src2 & 0xff00) >> 8; + unsigned int s2_2 = (src2 & 0xff0000) >> 16; + unsigned int s2_3 = (src2 & 0xff000000) >> 24; + + res0 = s1_0 - s2_0; + res1 = s1_1 - s2_1; + res2 = s1_2 - s2_2; + res3 = s1_3 - s2_3; + + if (res0 < 0) + res0 = -res0; + + if (res1 < 0) + res1 = -res1; + + if (res2 < 0) + res2 = -res2; + + if (res3 < 0) + res3 = -res3; + + return (res3 << 24) | (res2 << 16) | (res1 << 8) | res0; +} + + +static inline unsigned int _subc (unsigned int src1, unsigned int src2) +{ + if ( src1 >= src2) + return ((src1 - src2) << 1) + 1; + else + return src1 << 1; +} + + + +static inline int _sub2(int src1, int src2) { + short s1[2], s2[2], r[2]; + int result; + *((int*)s1) = src1; + *((int*)s2) = src2; + r[0] = s1[0] - s2[0]; + r[1] = s1[1] - s2[1]; + result = *(int*)r; + return result; +} + + +static inline int _sub4(int src1, int src2) { + char c1[4], c2[4], r[4]; + int result; + *((int*)c1) = src1; + *((int*)c2) = src2; + r[0] = c1[0] - c2[0]; + r[1] = c1[1] - c2[1]; + r[2] = c1[2] - c2[2]; + r[3] = c1[3] - c2[3]; + result = *(int*)r; + return result; +} + + +static inline int _swap4 (unsigned int src1) { + unsigned char v0 = src1; + unsigned char v1 = src1 >> 8; + unsigned char v2 = src1 >> 16; + unsigned char v3 = src1 >> 24; + unsigned v = v0<<8 | v1 | v2<<24 | v3<<16; + return v; +} + +static inline unsigned int _unpkhu4 (unsigned int src1) { + unsigned v0 = src1>>24; + unsigned v1 = (src1>>16) & 0xff; + return (v0<<16) | v1; +} + +static inline unsigned int _unpklu4 (unsigned int src1) { + unsigned v1 = (src1>>8) & 0xff; + unsigned v0 = (src1) & 0xff; + return (v1<<16) | v0; +} + + + + +static inline unsigned int _xpnd2 (unsigned int src1) { + int v0 = (src1 & 0x1) ? 0x0000ffff : 0x00000000; + int v1 = (src1 & 0x2) ? 0xffff0000 : 0x00000000; + return v0|v1; +} + +static inline unsigned int _xpnd4 (unsigned int src1) { + int v0 = (src1 & 0x1) ? 0x000000ff : 0x00000000; + int v1 = (src1 & 0x2) ? 0x0000ff00 : 0x00000000; + int v2 = (src1 & 0x4) ? 0x00ff0000 : 0x00000000; + int v3 = (src1 & 0x8) ? 0xff000000 : 0x00000000; + int r = v0|v1|v2|v3; + return r; +} + + + +// end of Implemented in alphabetical order + + +#endif /* __C6X_COMPAT__H */ diff --git a/components/esp32/include/xtensa/cacheasm.h b/components/esp32/include/xtensa/cacheasm.h new file mode 100755 index 000000000..225e01b32 --- /dev/null +++ b/components/esp32/include/xtensa/cacheasm.h @@ -0,0 +1,962 @@ +/* + * xtensa/cacheasm.h -- assembler-specific cache related definitions + * that depend on CORE configuration + * + * This file is logically part of xtensa/coreasm.h , + * but is kept separate for modularity / compilation-performance. + */ + +/* + * Copyright (c) 2001-2014 Cadence Design Systems, Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_CACHEASM_H +#define XTENSA_CACHEASM_H + +#include +#include +#include +#include + +/* + * This header file defines assembler macros of the form: + * cache_ + * where is 'i' or 'd' for instruction and data caches, + * and indicates the function of the macro. + * + * The following functions are defined, + * and apply only to the specified cache (I or D): + * + * reset + * Resets the cache. + * + * sync + * Makes sure any previous cache instructions have been completed; + * ie. makes sure any previous cache control operations + * have had full effect and been synchronized to memory. + * Eg. any invalidate completed [so as not to generate a hit], + * any writebacks or other pipelined writes written to memory, etc. + * + * invalidate_line (single cache line) + * invalidate_region (specified memory range) + * invalidate_all (entire cache) + * Invalidates all cache entries that cache + * data from the specified memory range. + * NOTE: locked entries are not invalidated. + * + * writeback_line (single cache line) + * writeback_region (specified memory range) + * writeback_all (entire cache) + * Writes back to memory all dirty cache entries + * that cache data from the specified memory range, + * and marks these entries as clean. + * NOTE: on some future implementations, this might + * also invalidate. + * NOTE: locked entries are written back, but never invalidated. + * NOTE: instruction caches never implement writeback. + * + * writeback_inv_line (single cache line) + * writeback_inv_region (specified memory range) + * writeback_inv_all (entire cache) + * Writes back to memory all dirty cache entries + * that cache data from the specified memory range, + * and invalidates these entries (including all clean + * cache entries that cache data from that range). + * NOTE: locked entries are written back but not invalidated. + * NOTE: instruction caches never implement writeback. + * + * lock_line (single cache line) + * lock_region (specified memory range) + * Prefetch and lock the specified memory range into cache. + * NOTE: if any part of the specified memory range cannot + * be locked, a Load/Store Error (for dcache) or Instruction + * Fetch Error (for icache) exception occurs. These macros don't + * do anything special (yet anyway) to handle this situation. + * + * unlock_line (single cache line) + * unlock_region (specified memory range) + * unlock_all (entire cache) + * Unlock cache entries that cache the specified memory range. + * Entries not already locked are unaffected. + * + * coherence_on + * coherence_off + * Turn off and on cache coherence + * + */ + + + +/*************************** GENERIC -- ALL CACHES ***************************/ + + +/* + * The following macros assume the following cache size/parameter limits + * in the current Xtensa core implementation: + * cache size: 1024 bytes minimum + * line size: 16 - 64 bytes + * way count: 1 - 4 + * + * Minimum entries per way (ie. per associativity) = 1024 / 64 / 4 = 4 + * Hence the assumption that each loop can execute four cache instructions. + * + * Correspondingly, the offset range of instructions is assumed able to cover + * four lines, ie. offsets {0,1,2,3} * line_size are assumed valid for + * both hit and indexed cache instructions. Ie. these offsets are all + * valid: 0, 16, 32, 48, 64, 96, 128, 192 (for line sizes 16, 32, 64). + * This is true of all original cache instructions + * (dhi, ihi, dhwb, dhwbi, dii, iii) which have offsets + * of 0 to 1020 in multiples of 4 (ie. 8 bits shifted by 2). + * This is also true of subsequent cache instructions + * (dhu, ihu, diu, iiu, diwb, diwbi, dpfl, ipfl) which have offsets + * of 0 to 240 in multiples of 16 (ie. 4 bits shifted by 4). + * + * (Maximum cache size, currently 32k, doesn't affect the following macros. + * Cache ways > MMU min page size cause aliasing but that's another matter.) + */ + + + +/* + * Macro to apply an 'indexed' cache instruction to the entire cache. + * + * Parameters: + * cainst instruction/ that takes an address register parameter + * and an offset parameter (in range 0 .. 3*linesize). + * size size of cache in bytes + * linesize size of cache line in bytes (always power-of-2) + * assoc_or1 number of associativities (ways/sets) in cache + * if all sets affected by cainst, + * or 1 if only one set (or not all sets) of the cache + * is affected by cainst (eg. DIWB or DIWBI [not yet ISA defined]). + * aa, ab unique address registers (temporaries). + * awb set to other than a0 if wb type of instruction + * loopokay 1 allows use of zero-overhead loops, 0 does not + * immrange range (max value) of cainst's immediate offset parameter, in bytes + * (NOTE: macro assumes immrange allows power-of-2 number of lines) + */ + + .macro cache_index_all cainst, size, linesize, assoc_or1, aa, ab, loopokay, maxofs, awb=a0 + + // Number of indices in cache (lines per way): + .set .Lindices, (\size / (\linesize * \assoc_or1)) + // Number of indices processed per loop iteration (max 4): + .set .Lperloop, .Lindices + .ifgt .Lperloop - 4 + .set .Lperloop, 4 + .endif + // Also limit instructions per loop if cache line size exceeds immediate range: + .set .Lmaxperloop, (\maxofs / \linesize) + 1 + .ifgt .Lperloop - .Lmaxperloop + .set .Lperloop, .Lmaxperloop + .endif + // Avoid addi of 128 which takes two instructions (addmi,addi): + .ifeq .Lperloop*\linesize - 128 + .ifgt .Lperloop - 1 + .set .Lperloop, .Lperloop / 2 + .endif + .endif + + // \size byte cache, \linesize byte lines, \assoc_or1 way(s) affected by each \cainst. + // XCHAL_ERRATUM_497 - don't execute using loop, to reduce the amount of added code + .ifne (\loopokay & XCHAL_HAVE_LOOPS && !XCHAL_ERRATUM_497) + + movi \aa, .Lindices / .Lperloop // number of loop iterations + // Possible improvement: need only loop if \aa > 1 ; + // however \aa == 1 is highly unlikely. + movi \ab, 0 // to iterate over cache + loop \aa, .Lend_cachex\@ + .set .Li, 0 ; .rept .Lperloop + \cainst \ab, .Li*\linesize + .set .Li, .Li+1 ; .endr + addi \ab, \ab, .Lperloop*\linesize // move to next line +.Lend_cachex\@: + + .else + + movi \aa, (\size / \assoc_or1) + // Possible improvement: need only loop if \aa > 1 ; + // however \aa == 1 is highly unlikely. + movi \ab, 0 // to iterate over cache + .ifne ((\awb !=a0) & XCHAL_ERRATUM_497) // don't use awb if set to a0 + movi \awb, 0 + .endif +.Lstart_cachex\@: + .set .Li, 0 ; .rept .Lperloop + \cainst \ab, .Li*\linesize + .set .Li, .Li+1 ; .endr + .ifne ((\awb !=a0) & XCHAL_ERRATUM_497) // do memw after 8 cainst wb instructions + addi \awb, \awb, .Lperloop + blti \awb, 8, .Lstart_memw\@ + memw + movi \awb, 0 +.Lstart_memw\@: + .endif + addi \ab, \ab, .Lperloop*\linesize // move to next line + bltu \ab, \aa, .Lstart_cachex\@ + .endif + + .endm + + +/* + * Macro to apply a 'hit' cache instruction to a memory region, + * ie. to any cache entries that cache a specified portion (region) of memory. + * Takes care of the unaligned cases, ie. may apply to one + * more cache line than $asize / lineSize if $aaddr is not aligned. + * + * + * Parameters are: + * cainst instruction/macro that takes an address register parameter + * and an offset parameter (currently always zero) + * and generates a cache instruction (eg. "dhi", "dhwb", "ihi", etc.) + * linesize_log2 log2(size of cache line in bytes) + * addr register containing start address of region (clobbered) + * asize register containing size of the region in bytes (clobbered) + * askew unique register used as temporary + * awb unique register used as temporary for erratum 497. + * + * Note: A possible optimization to this macro is to apply the operation + * to the entire cache if the region exceeds the size of the cache + * by some empirically determined amount or factor. Some experimentation + * is required to determine the appropriate factors, which also need + * to be tunable if required. + */ + + .macro cache_hit_region cainst, linesize_log2, addr, asize, askew, awb=a0 + + // Make \asize the number of iterations: + extui \askew, \addr, 0, \linesize_log2 // get unalignment amount of \addr + add \asize, \asize, \askew // ... and add it to \asize + addi \asize, \asize, (1 << \linesize_log2) - 1 // round up! + srli \asize, \asize, \linesize_log2 + + // Iterate over region: + .ifne ((\awb !=a0) & XCHAL_ERRATUM_497) // don't use awb if set to a0 + movi \awb, 0 + .endif + floopnez \asize, cacheh\@ + \cainst \addr, 0 + .ifne ((\awb !=a0) & XCHAL_ERRATUM_497) // do memw after 8 cainst wb instructions + addi \awb, \awb, 1 + blti \awb, 8, .Lstart_memw\@ + memw + movi \awb, 0 +.Lstart_memw\@: + .endif + addi \addr, \addr, (1 << \linesize_log2) // move to next line + floopend \asize, cacheh\@ + .endm + + + + + +/*************************** INSTRUCTION CACHE ***************************/ + + +/* + * Reset/initialize the instruction cache by simply invalidating it: + * (need to unlock first also, if cache locking implemented): + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro icache_reset aa, ab, loopokay=0 + icache_unlock_all \aa, \ab, \loopokay + icache_invalidate_all \aa, \ab, \loopokay + .endm + + +/* + * Synchronize after an instruction cache operation, + * to be sure everything is in sync with memory as to be + * expected following any previous instruction cache control operations. + * + * Even if a config doesn't have caches, an isync is still needed + * when instructions in any memory are modified, whether by a loader + * or self-modifying code. Therefore, this macro always produces + * an isync, whether or not an icache is present. + * + * Parameters are: + * ar an address register (temporary) (currently unused, but may be used in future) + */ + .macro icache_sync ar + isync + .endm + + + +/* + * Invalidate a single line of the instruction cache. + * Parameters are: + * ar address register that contains (virtual) address to invalidate + * (may get clobbered in a future implementation, but not currently) + * offset (optional) offset to add to \ar to compute effective address to invalidate + * (note: some number of lsbits are ignored) + */ + .macro icache_invalidate_line ar, offset +#if XCHAL_ICACHE_SIZE > 0 + ihi \ar, \offset // invalidate icache line + icache_sync \ar +#endif + .endm + + + + +/* + * Invalidate instruction cache entries that cache a specified portion of memory. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro icache_invalidate_region astart, asize, ac +#if XCHAL_ICACHE_SIZE > 0 + // Instruction cache region invalidation: + cache_hit_region ihi, XCHAL_ICACHE_LINEWIDTH, \astart, \asize, \ac + icache_sync \ac + // End of instruction cache region invalidation +#endif + .endm + + + +/* + * Invalidate entire instruction cache. + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro icache_invalidate_all aa, ab, loopokay=1 +#if XCHAL_ICACHE_SIZE > 0 + // Instruction cache invalidation: + cache_index_all iii, XCHAL_ICACHE_SIZE, XCHAL_ICACHE_LINESIZE, XCHAL_ICACHE_WAYS, \aa, \ab, \loopokay, 1020 + icache_sync \aa + // End of instruction cache invalidation +#endif + .endm + + + +/* + * Lock (prefetch & lock) a single line of the instruction cache. + * + * Parameters are: + * ar address register that contains (virtual) address to lock + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to lock + * (note: some number of lsbits are ignored) + */ + .macro icache_lock_line ar, offset +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE + ipfl \ar, \offset /* prefetch and lock icache line */ + icache_sync \ar +#endif + .endm + + + +/* + * Lock (prefetch & lock) a specified portion of memory into the instruction cache. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro icache_lock_region astart, asize, ac +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE + // Instruction cache region lock: + cache_hit_region ipfl, XCHAL_ICACHE_LINEWIDTH, \astart, \asize, \ac + icache_sync \ac + // End of instruction cache region lock +#endif + .endm + + + +/* + * Unlock a single line of the instruction cache. + * + * Parameters are: + * ar address register that contains (virtual) address to unlock + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to unlock + * (note: some number of lsbits are ignored) + */ + .macro icache_unlock_line ar, offset +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE + ihu \ar, \offset /* unlock icache line */ + icache_sync \ar +#endif + .endm + + + +/* + * Unlock a specified portion of memory from the instruction cache. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro icache_unlock_region astart, asize, ac +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE + // Instruction cache region unlock: + cache_hit_region ihu, XCHAL_ICACHE_LINEWIDTH, \astart, \asize, \ac + icache_sync \ac + // End of instruction cache region unlock +#endif + .endm + + + +/* + * Unlock entire instruction cache. + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro icache_unlock_all aa, ab, loopokay=1 +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE + // Instruction cache unlock: + cache_index_all iiu, XCHAL_ICACHE_SIZE, XCHAL_ICACHE_LINESIZE, 1, \aa, \ab, \loopokay, 240 + icache_sync \aa + // End of instruction cache unlock +#endif + .endm + + + + + +/*************************** DATA CACHE ***************************/ + + + +/* + * Reset/initialize the data cache by simply invalidating it + * (need to unlock first also, if cache locking implemented): + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro dcache_reset aa, ab, loopokay=0 + dcache_unlock_all \aa, \ab, \loopokay + dcache_invalidate_all \aa, \ab, \loopokay + .endm + + + + +/* + * Synchronize after a data cache operation, + * to be sure everything is in sync with memory as to be + * expected following any previous data cache control operations. + * + * Parameters are: + * ar an address register (temporary) (currently unused, but may be used in future) + */ + .macro dcache_sync ar, wbtype=0 +#if XCHAL_DCACHE_SIZE > 0 + // No synchronization is needed. + // (memw may be desired e.g. after writeback operation to help ensure subsequent + // external accesses are seen to follow that writeback, however that's outside + // the scope of this macro) + + //dsync + .ifne (\wbtype & XCHAL_ERRATUM_497) + memw + .endif +#endif + .endm + + + +/* + * Turn on cache coherence. + * + * WARNING: for RE-201x.x and later hardware, any interrupt that tries + * to change MEMCTL will see its changes dropped if the interrupt comes + * in the middle of this routine. If this might be an issue, call this + * routine with interrupts disabled. + * + * Parameters are: + * ar,at two scratch address registers (both clobbered) + */ + .macro cache_coherence_on ar at +#if XCHAL_DCACHE_IS_COHERENT +# if XCHAL_HW_MIN_VERSION >= XTENSA_HWVERSION_RE_2012_0 + /* Have MEMCTL. Enable snoop responses. */ + rsr.memctl \ar + movi \at, MEMCTL_SNOOP_EN + or \ar, \ar, \at + wsr.memctl \ar +# elif XCHAL_HAVE_EXTERN_REGS && XCHAL_HAVE_MX + /* Opt into coherence for MX (for backward compatibility / testing). */ + movi \ar, 1 + movi \at, XER_CCON + wer \ar, \at + extw +# endif +#endif + .endm + + + +/* + * Turn off cache coherence. + * + * NOTE: this is generally preceded by emptying the cache; + * see xthal_cache_coherence_optout() in hal/coherence.c for details. + * + * WARNING: for RE-201x.x and later hardware, any interrupt that tries + * to change MEMCTL will see its changes dropped if the interrupt comes + * in the middle of this routine. If this might be an issue, call this + * routine with interrupts disabled. + * + * Parameters are: + * ar,at two scratch address registers (both clobbered) + */ + .macro cache_coherence_off ar at +#if XCHAL_DCACHE_IS_COHERENT +# if XCHAL_HW_MIN_VERSION >= XTENSA_HWVERSION_RE_2012_0 + /* Have MEMCTL. Disable snoop responses. */ + rsr.memctl \ar + movi \at, ~MEMCTL_SNOOP_EN + and \ar, \ar, \at + wsr.memctl \ar +# elif XCHAL_HAVE_EXTERN_REGS && XCHAL_HAVE_MX + /* Opt out of coherence, for MX (for backward compatibility / testing). */ + extw + movi \at, 0 + movi \ar, XER_CCON + wer \at, \ar + extw +# endif +#endif + .endm + + + +/* + * Synchronize after a data store operation, + * to be sure the stored data is completely off the processor + * (and assuming there is no buffering outside the processor, + * that the data is in memory). This may be required to + * ensure that the processor's write buffers are emptied. + * A MEMW followed by a read guarantees this, by definition. + * We also try to make sure the read itself completes. + * + * Parameters are: + * ar an address register (temporary) + */ + .macro write_sync ar + memw // ensure previous memory accesses are complete prior to subsequent memory accesses + l32i \ar, sp, 0 // completing this read ensures any previous write has completed, because of MEMW + //slot + add \ar, \ar, \ar // use the result of the read to help ensure the read completes (in future architectures) + .endm + + +/* + * Invalidate a single line of the data cache. + * Parameters are: + * ar address register that contains (virtual) address to invalidate + * (may get clobbered in a future implementation, but not currently) + * offset (optional) offset to add to \ar to compute effective address to invalidate + * (note: some number of lsbits are ignored) + */ + .macro dcache_invalidate_line ar, offset +#if XCHAL_DCACHE_SIZE > 0 + dhi \ar, \offset + dcache_sync \ar +#endif + .endm + + + + + +/* + * Invalidate data cache entries that cache a specified portion of memory. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro dcache_invalidate_region astart, asize, ac +#if XCHAL_DCACHE_SIZE > 0 + // Data cache region invalidation: + cache_hit_region dhi, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac + dcache_sync \ac + // End of data cache region invalidation +#endif + .endm + + + +/* + * Invalidate entire data cache. + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro dcache_invalidate_all aa, ab, loopokay=1 +#if XCHAL_DCACHE_SIZE > 0 + // Data cache invalidation: + cache_index_all dii, XCHAL_DCACHE_SIZE, XCHAL_DCACHE_LINESIZE, XCHAL_DCACHE_WAYS, \aa, \ab, \loopokay, 1020 + dcache_sync \aa + // End of data cache invalidation +#endif + .endm + + + +/* + * Writeback a single line of the data cache. + * Parameters are: + * ar address register that contains (virtual) address to writeback + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to writeback + * (note: some number of lsbits are ignored) + */ + .macro dcache_writeback_line ar, offset +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_IS_WRITEBACK + dhwb \ar, \offset + dcache_sync \ar, wbtype=1 +#endif + .endm + + + +/* + * Writeback dirty data cache entries that cache a specified portion of memory. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro dcache_writeback_region astart, asize, ac, awb +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_IS_WRITEBACK + // Data cache region writeback: + cache_hit_region dhwb, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac, \awb + dcache_sync \ac, wbtype=1 + // End of data cache region writeback +#endif + .endm + + + +/* + * Writeback entire data cache. + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro dcache_writeback_all aa, ab, awb, loopokay=1 +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_IS_WRITEBACK + // Data cache writeback: + cache_index_all diwb, XCHAL_DCACHE_SIZE, XCHAL_DCACHE_LINESIZE, 1, \aa, \ab, \loopokay, 240, \awb, + dcache_sync \aa, wbtype=1 + // End of data cache writeback +#endif + .endm + + + +/* + * Writeback and invalidate a single line of the data cache. + * Parameters are: + * ar address register that contains (virtual) address to writeback and invalidate + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to writeback and invalidate + * (note: some number of lsbits are ignored) + */ + .macro dcache_writeback_inv_line ar, offset +#if XCHAL_DCACHE_SIZE > 0 + dhwbi \ar, \offset /* writeback and invalidate dcache line */ + dcache_sync \ar, wbtype=1 +#endif + .endm + + + +/* + * Writeback and invalidate data cache entries that cache a specified portion of memory. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro dcache_writeback_inv_region astart, asize, ac, awb +#if XCHAL_DCACHE_SIZE > 0 + // Data cache region writeback and invalidate: + cache_hit_region dhwbi, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac, \awb + dcache_sync \ac, wbtype=1 + // End of data cache region writeback and invalidate +#endif + .endm + + + +/* + * Writeback and invalidate entire data cache. + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro dcache_writeback_inv_all aa, ab, awb, loopokay=1 +#if XCHAL_DCACHE_SIZE > 0 + // Data cache writeback and invalidate: +#if XCHAL_DCACHE_IS_WRITEBACK + cache_index_all diwbi, XCHAL_DCACHE_SIZE, XCHAL_DCACHE_LINESIZE, 1, \aa, \ab, \loopokay, 240, \awb + dcache_sync \aa, wbtype=1 +#else /*writeback*/ + // Data cache does not support writeback, so just invalidate: */ + dcache_invalidate_all \aa, \ab, \loopokay +#endif /*writeback*/ + // End of data cache writeback and invalidate +#endif + .endm + + + + +/* + * Lock (prefetch & lock) a single line of the data cache. + * + * Parameters are: + * ar address register that contains (virtual) address to lock + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to lock + * (note: some number of lsbits are ignored) + */ + .macro dcache_lock_line ar, offset +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE + dpfl \ar, \offset /* prefetch and lock dcache line */ + dcache_sync \ar +#endif + .endm + + + +/* + * Lock (prefetch & lock) a specified portion of memory into the data cache. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro dcache_lock_region astart, asize, ac +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE + // Data cache region lock: + cache_hit_region dpfl, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac + dcache_sync \ac + // End of data cache region lock +#endif + .endm + + + +/* + * Unlock a single line of the data cache. + * + * Parameters are: + * ar address register that contains (virtual) address to unlock + * (may get clobbered in a future implementation, but not currently) + * offset offset to add to \ar to compute effective address to unlock + * (note: some number of lsbits are ignored) + */ + .macro dcache_unlock_line ar, offset +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE + dhu \ar, \offset /* unlock dcache line */ + dcache_sync \ar +#endif + .endm + + + +/* + * Unlock a specified portion of memory from the data cache. + * Parameters are: + * astart start address (register gets clobbered) + * asize size of the region in bytes (register gets clobbered) + * ac unique register used as temporary + */ + .macro dcache_unlock_region astart, asize, ac +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE + // Data cache region unlock: + cache_hit_region dhu, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac + dcache_sync \ac + // End of data cache region unlock +#endif + .endm + + + +/* + * Unlock entire data cache. + * + * Parameters: + * aa, ab unique address registers (temporaries) + */ + .macro dcache_unlock_all aa, ab, loopokay=1 +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE + // Data cache unlock: + cache_index_all diu, XCHAL_DCACHE_SIZE, XCHAL_DCACHE_LINESIZE, 1, \aa, \ab, \loopokay, 240 + dcache_sync \aa + // End of data cache unlock +#endif + .endm + + + +/* + * Get the number of enabled icache ways. Note that this may + * be different from the value read from the MEMCTL register. + * + * Parameters: + * aa address register where value is returned + */ + .macro icache_get_ways aa +#if XCHAL_ICACHE_SIZE > 0 +#if XCHAL_HAVE_ICACHE_DYN_WAYS + // Read from MEMCTL and shift/mask + rsr \aa, MEMCTL + extui \aa, \aa, MEMCTL_ICWU_SHIFT, MEMCTL_ICWU_BITS + blti \aa, XCHAL_ICACHE_WAYS, .Licgw + movi \aa, XCHAL_ICACHE_WAYS +.Licgw: +#else + // All ways are always enabled + movi \aa, XCHAL_ICACHE_WAYS +#endif +#else + // No icache + movi \aa, 0 +#endif + .endm + + + +/* + * Set the number of enabled icache ways. + * + * Parameters: + * aa address register specifying number of ways (trashed) + * ab,ac address register for scratch use (trashed) + */ + .macro icache_set_ways aa, ab, ac +#if XCHAL_ICACHE_SIZE > 0 +#if XCHAL_HAVE_ICACHE_DYN_WAYS + movi \ac, MEMCTL_ICWU_CLR_MASK // set up to clear bits 18-22 + rsr \ab, MEMCTL + and \ab, \ab, \ac + movi \ac, MEMCTL_INV_EN // set bit 23 + slli \aa, \aa, MEMCTL_ICWU_SHIFT // move to right spot + or \ab, \ab, \aa + or \ab, \ab, \ac + wsr \ab, MEMCTL + isync +#else + // All ways are always enabled +#endif +#else + // No icache +#endif + .endm + + + +/* + * Get the number of enabled dcache ways. Note that this may + * be different from the value read from the MEMCTL register. + * + * Parameters: + * aa address register where value is returned + */ + .macro dcache_get_ways aa +#if XCHAL_DCACHE_SIZE > 0 +#if XCHAL_HAVE_DCACHE_DYN_WAYS + // Read from MEMCTL and shift/mask + rsr \aa, MEMCTL + extui \aa, \aa, MEMCTL_DCWU_SHIFT, MEMCTL_DCWU_BITS + blti \aa, XCHAL_DCACHE_WAYS, .Ldcgw + movi \aa, XCHAL_DCACHE_WAYS +.Ldcgw: +#else + // All ways are always enabled + movi \aa, XCHAL_DCACHE_WAYS +#endif +#else + // No dcache + movi \aa, 0 +#endif + .endm + + + +/* + * Set the number of enabled dcache ways. + * + * Parameters: + * aa address register specifying number of ways (trashed) + * ab,ac address register for scratch use (trashed) + */ + .macro dcache_set_ways aa, ab, ac +#if (XCHAL_DCACHE_SIZE > 0) && XCHAL_HAVE_DCACHE_DYN_WAYS + movi \ac, MEMCTL_DCWA_CLR_MASK // set up to clear bits 13-17 + rsr \ab, MEMCTL + and \ab, \ab, \ac // clear ways allocatable + slli \ac, \aa, MEMCTL_DCWA_SHIFT + or \ab, \ab, \ac // set ways allocatable + wsr \ab, MEMCTL +#if XCHAL_DCACHE_IS_WRITEBACK + // Check if the way count is increasing or decreasing + extui \ac, \ab, MEMCTL_DCWU_SHIFT, MEMCTL_DCWU_BITS // bits 8-12 - ways in use + bge \aa, \ac, .Ldsw3 // equal or increasing + slli \ab, \aa, XCHAL_DCACHE_LINEWIDTH + XCHAL_DCACHE_SETWIDTH // start way number + slli \ac, \ac, XCHAL_DCACHE_LINEWIDTH + XCHAL_DCACHE_SETWIDTH // end way number +.Ldsw1: + diwbui.p \ab // auto-increments ab + bge \ab, \ac, .Ldsw2 + beqz \ab, .Ldsw2 + j .Ldsw1 +.Ldsw2: + rsr \ab, MEMCTL +#endif +.Ldsw3: + // No dirty data to write back, just set the new number of ways + movi \ac, MEMCTL_DCWU_CLR_MASK // set up to clear bits 8-12 + and \ab, \ab, \ac // clear ways in use + movi \ac, MEMCTL_INV_EN + or \ab, \ab, \ac // set bit 23 + slli \aa, \aa, MEMCTL_DCWU_SHIFT + or \ab, \ab, \aa // set ways in use + wsr \ab, MEMCTL +#else + // No dcache or no way disable support +#endif + .endm + +#endif /*XTENSA_CACHEASM_H*/ + diff --git a/components/esp32/include/xtensa/cacheattrasm.h b/components/esp32/include/xtensa/cacheattrasm.h new file mode 100755 index 000000000..20c4cfd55 --- /dev/null +++ b/components/esp32/include/xtensa/cacheattrasm.h @@ -0,0 +1,436 @@ +/* + * xtensa/cacheattrasm.h -- assembler-specific CACHEATTR register related definitions + * that depend on CORE configuration + * + * This file is logically part of xtensa/coreasm.h (or perhaps xtensa/cacheasm.h), + * but is kept separate for modularity / compilation-performance. + */ + +/* + * Copyright (c) 2001-2009 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_CACHEATTRASM_H +#define XTENSA_CACHEATTRASM_H + +#include + +/* Determine whether cache attributes are controlled using eight 512MB entries: */ +#define XCHAL_CA_8X512 (XCHAL_HAVE_CACHEATTR || XCHAL_HAVE_MIMIC_CACHEATTR || XCHAL_HAVE_XLT_CACHEATTR \ + || (XCHAL_HAVE_PTP_MMU && XCHAL_HAVE_SPANNING_WAY)) + + +/* + * This header file defines assembler macros of the form: + * cacheattr_ + * where: + * is 'i', 'd' or absent for instruction, data + * or both caches; and + * indicates the function of the macro. + * + * The following functions are defined: + * + * icacheattr_get + * Reads I-cache CACHEATTR into a2 (clobbers a3-a5). + * + * dcacheattr_get + * Reads D-cache CACHEATTR into a2 (clobbers a3-a5). + * (Note: for configs with a real CACHEATTR register, the + * above two macros are identical.) + * + * cacheattr_set + * Writes both I-cache and D-cache CACHEATTRs from a2 (a3-a8 clobbered). + * Works even when changing one's own code's attributes. + * + * icacheattr_is_enabled label + * Branches to \label if I-cache appears to have been enabled + * (eg. if CACHEATTR contains a cache-enabled attribute). + * (clobbers a2-a5,SAR) + * + * dcacheattr_is_enabled label + * Branches to \label if D-cache appears to have been enabled + * (eg. if CACHEATTR contains a cache-enabled attribute). + * (clobbers a2-a5,SAR) + * + * cacheattr_is_enabled label + * Branches to \label if either I-cache or D-cache appears to have been enabled + * (eg. if CACHEATTR contains a cache-enabled attribute). + * (clobbers a2-a5,SAR) + * + * The following macros are only defined under certain conditions: + * + * icacheattr_set (if XCHAL_HAVE_MIMIC_CACHEATTR || XCHAL_HAVE_XLT_CACHEATTR) + * Writes I-cache CACHEATTR from a2 (a3-a8 clobbered). + * + * dcacheattr_set (if XCHAL_HAVE_MIMIC_CACHEATTR || XCHAL_HAVE_XLT_CACHEATTR) + * Writes D-cache CACHEATTR from a2 (a3-a8 clobbered). + */ + + + +/*************************** GENERIC -- ALL CACHES ***************************/ + +/* + * _cacheattr_get + * + * (Internal macro.) + * Returns value of CACHEATTR register (or closest equivalent) in a2. + * + * Entry: + * (none) + * Exit: + * a2 value read from CACHEATTR + * a3-a5 clobbered (temporaries) + */ + .macro _cacheattr_get tlb +#if XCHAL_HAVE_CACHEATTR + rsr a2, CACHEATTR +#elif XCHAL_CA_8X512 + // We have a config that "mimics" CACHEATTR using a simplified + // "MMU" composed of a single statically-mapped way. + // DTLB and ITLB are independent, so there's no single + // cache attribute that can describe both. So for now + // just return the DTLB state. + movi a5, 0xE0000000 + movi a2, 0 + movi a3, XCHAL_SPANNING_WAY +1: add a3, a3, a5 // next segment + r&tlb&1 a4, a3 // get PPN+CA of segment at 0xE0000000, 0xC0000000, ..., 0 + dsync // interlock??? + slli a2, a2, 4 + extui a4, a4, 0, 4 // extract CA + or a2, a2, a4 + bgeui a3, 16, 1b +#else + // This macro isn't applicable to arbitrary MMU configurations. + // Just return zero. + movi a2, 0 +#endif + .endm + + .macro icacheattr_get + _cacheattr_get itlb + .endm + + .macro dcacheattr_get + _cacheattr_get dtlb + .endm + + +/* Default (powerup/reset) value of CACHEATTR, + all BYPASS mode (ie. disabled/bypassed caches): */ +#if XCHAL_HAVE_PTP_MMU +# define XCHAL_CACHEATTR_ALL_BYPASS 0x33333333 +#else +# define XCHAL_CACHEATTR_ALL_BYPASS 0x22222222 +#endif + +#if XCHAL_CA_8X512 + +#if XCHAL_HAVE_PTP_MMU +# define XCHAL_FCA_ENAMASK 0x0AA0 /* bitmap of fetch attributes that require enabled icache */ +# define XCHAL_LCA_ENAMASK 0x0FF0 /* bitmap of load attributes that require enabled dcache */ +# define XCHAL_SCA_ENAMASK 0x0CC0 /* bitmap of store attributes that require enabled dcache */ +#else +# define XCHAL_FCA_ENAMASK 0x003A /* bitmap of fetch attributes that require enabled icache */ +# define XCHAL_LCA_ENAMASK 0x0033 /* bitmap of load attributes that require enabled dcache */ +# define XCHAL_SCA_ENAMASK 0x0033 /* bitmap of store attributes that require enabled dcache */ +#endif +#define XCHAL_LSCA_ENAMASK (XCHAL_LCA_ENAMASK|XCHAL_SCA_ENAMASK) /* l/s attrs requiring enabled dcache */ +#define XCHAL_ALLCA_ENAMASK (XCHAL_FCA_ENAMASK|XCHAL_LSCA_ENAMASK) /* all attrs requiring enabled caches */ + +/* + * _cacheattr_is_enabled + * + * (Internal macro.) + * Branches to \label if CACHEATTR in a2 indicates an enabled + * cache, using mask in a3. + * + * Parameters: + * label where to branch to if cache is enabled + * Entry: + * a2 contains CACHEATTR value used to determine whether + * caches are enabled + * a3 16-bit constant where each bit correspond to + * one of the 16 possible CA values (in a CACHEATTR mask); + * CA values that indicate the cache is enabled + * have their corresponding bit set in this mask + * (eg. use XCHAL_xCA_ENAMASK , above) + * Exit: + * a2,a4,a5 clobbered + * SAR clobbered + */ + .macro _cacheattr_is_enabled label + movi a4, 8 // loop 8 times +.Lcaife\@: + extui a5, a2, 0, 4 // get CA nibble + ssr a5 // index into mask according to CA... + srl a5, a3 // ...and get CA's mask bit in a5 bit 0 + bbsi.l a5, 0, \label // if CA indicates cache enabled, jump to label + srli a2, a2, 4 // next nibble + addi a4, a4, -1 + bnez a4, .Lcaife\@ // loop for each nibble + .endm + +#else /* XCHAL_CA_8X512 */ + .macro _cacheattr_is_enabled label + j \label // macro not applicable, assume caches always enabled + .endm +#endif /* XCHAL_CA_8X512 */ + + + +/* + * icacheattr_is_enabled + * + * Branches to \label if I-cache is enabled. + * + * Parameters: + * label where to branch to if icache is enabled + * Entry: + * (none) + * Exit: + * a2-a5, SAR clobbered (temporaries) + */ + .macro icacheattr_is_enabled label +#if XCHAL_CA_8X512 + icacheattr_get + movi a3, XCHAL_FCA_ENAMASK +#endif + _cacheattr_is_enabled \label + .endm + +/* + * dcacheattr_is_enabled + * + * Branches to \label if D-cache is enabled. + * + * Parameters: + * label where to branch to if dcache is enabled + * Entry: + * (none) + * Exit: + * a2-a5, SAR clobbered (temporaries) + */ + .macro dcacheattr_is_enabled label +#if XCHAL_CA_8X512 + dcacheattr_get + movi a3, XCHAL_LSCA_ENAMASK +#endif + _cacheattr_is_enabled \label + .endm + +/* + * cacheattr_is_enabled + * + * Branches to \label if either I-cache or D-cache is enabled. + * + * Parameters: + * label where to branch to if a cache is enabled + * Entry: + * (none) + * Exit: + * a2-a5, SAR clobbered (temporaries) + */ + .macro cacheattr_is_enabled label +#if XCHAL_HAVE_CACHEATTR + rsr a2, CACHEATTR + movi a3, XCHAL_ALLCA_ENAMASK +#elif XCHAL_CA_8X512 + icacheattr_get + movi a3, XCHAL_FCA_ENAMASK + _cacheattr_is_enabled \label + dcacheattr_get + movi a3, XCHAL_LSCA_ENAMASK +#endif + _cacheattr_is_enabled \label + .endm + + + +/* + * The ISA does not have a defined way to change the + * instruction cache attributes of the running code, + * ie. of the memory area that encloses the current PC. + * However, each micro-architecture (or class of + * configurations within a micro-architecture) + * provides a way to deal with this issue. + * + * Here are a few macros used to implement the relevant + * approach taken. + */ + +#if XCHAL_CA_8X512 && !XCHAL_HAVE_CACHEATTR + // We have a config that "mimics" CACHEATTR using a simplified + // "MMU" composed of a single statically-mapped way. + +/* + * icacheattr_set + * + * Entry: + * a2 cacheattr value to set + * Exit: + * a2 unchanged + * a3-a8 clobbered (temporaries) + */ + .macro icacheattr_set + + movi a5, 0xE0000000 // mask of upper 3 bits + movi a6, 3f // PC where ITLB is set + movi a3, XCHAL_SPANNING_WAY // start at region 0 (0 .. 7) + mov a7, a2 // copy a2 so it doesn't get clobbered + and a6, a6, a5 // upper 3 bits of local PC area + j 3f + + // Use micro-architecture specific method. + // The following 4-instruction sequence is aligned such that + // it all fits within a single I-cache line. Sixteen byte + // alignment is sufficient for this (using XCHAL_ICACHE_LINESIZE + // actually causes problems because that can be greater than + // the alignment of the reset vector, where this macro is often + // invoked, which would cause the linker to align the reset + // vector code away from the reset vector!!). + .begin no-transform + .align 16 /*XCHAL_ICACHE_LINESIZE*/ +1: witlb a4, a3 // write wired PTE (CA, no PPN) of 512MB segment to ITLB + isync + .end no-transform + nop + nop + + sub a3, a3, a5 // next segment (add 0x20000000) + bltui a3, 16, 4f // done? + + // Note that in the WITLB loop, we don't do any load/stores + // (may not be an issue here, but it is important in the DTLB case). +2: srli a7, a7, 4 // next CA +3: +# if XCHAL_HAVE_MIMIC_CACHEATTR + extui a4, a7, 0, 4 // extract CA to set +# else /* have translation, preserve it: */ + ritlb1 a8, a3 // get current PPN+CA of segment + //dsync // interlock??? + extui a4, a7, 0, 4 // extract CA to set + srli a8, a8, 4 // clear CA but keep PPN ... + slli a8, a8, 4 // ... + add a4, a4, a8 // combine new CA with PPN to preserve +# endif + beq a3, a6, 1b // current PC's region? if so, do it in a safe way + witlb a4, a3 // write wired PTE (CA [+PPN]) of 512MB segment to ITLB + sub a3, a3, a5 // next segment (add 0x20000000) + bgeui a3, 16, 2b + isync // make sure all ifetch changes take effect +4: + .endm // icacheattr_set + + +/* + * dcacheattr_set + * + * Entry: + * a2 cacheattr value to set + * Exit: + * a2 unchanged + * a3-a8 clobbered (temporaries) + */ + + .macro dcacheattr_set + + movi a5, 0xE0000000 // mask of upper 3 bits + movi a3, XCHAL_SPANNING_WAY // start at region 0 (0 .. 7) + mov a7, a2 // copy a2 so it doesn't get clobbered + // Note that in the WDTLB loop, we don't do any load/stores +2: // (including implicit l32r via movi) because it isn't safe. +# if XCHAL_HAVE_MIMIC_CACHEATTR + extui a4, a7, 0, 4 // extract CA to set +# else /* have translation, preserve it: */ + rdtlb1 a8, a3 // get current PPN+CA of segment + //dsync // interlock??? + extui a4, a7, 0, 4 // extract CA to set + srli a8, a8, 4 // clear CA but keep PPN ... + slli a8, a8, 4 // ... + add a4, a4, a8 // combine new CA with PPN to preserve +# endif + wdtlb a4, a3 // write wired PTE (CA [+PPN]) of 512MB segment to DTLB + sub a3, a3, a5 // next segment (add 0x20000000) + srli a7, a7, 4 // next CA + bgeui a3, 16, 2b + dsync // make sure all data path changes take effect + .endm // dcacheattr_set + +#endif /* XCHAL_CA_8X512 && !XCHAL_HAVE_CACHEATTR */ + + + +/* + * cacheattr_set + * + * Macro that sets the current CACHEATTR safely + * (both i and d) according to the current contents of a2. + * It works even when changing the cache attributes of + * the currently running code. + * + * Entry: + * a2 cacheattr value to set + * Exit: + * a2 unchanged + * a3-a8 clobbered (temporaries) + */ + .macro cacheattr_set + +#if XCHAL_HAVE_CACHEATTR +# if XCHAL_ICACHE_LINESIZE < 4 + // No i-cache, so can always safely write to CACHEATTR: + wsr a2, CACHEATTR +# else + // The Athens micro-architecture, when using the old + // exception architecture option (ie. with the CACHEATTR register) + // allows changing the cache attributes of the running code + // using the following exact sequence aligned to be within + // an instruction cache line. (NOTE: using XCHAL_ICACHE_LINESIZE + // alignment actually causes problems because that can be greater + // than the alignment of the reset vector, where this macro is often + // invoked, which would cause the linker to align the reset + // vector code away from the reset vector!!). + j 1f + .begin no-transform + .align 16 /*XCHAL_ICACHE_LINESIZE*/ // align to within an I-cache line +1: wsr a2, CACHEATTR + isync + .end no-transform + nop + nop +# endif +#elif XCHAL_CA_8X512 + // DTLB and ITLB are independent, but to keep semantics + // of this macro we simply write to both. + icacheattr_set + dcacheattr_set +#else + // This macro isn't applicable to arbitrary MMU configurations. + // Do nothing in this case. +#endif + .endm + + +#endif /*XTENSA_CACHEATTRASM_H*/ + diff --git a/components/esp32/include/xtensa/config/core-isa.h b/components/esp32/include/xtensa/config/core-isa.h new file mode 100644 index 000000000..184564726 --- /dev/null +++ b/components/esp32/include/xtensa/config/core-isa.h @@ -0,0 +1,655 @@ +/* + * xtensa/config/core-isa.h -- HAL definitions that are dependent on Xtensa + * processor CORE configuration + * + * See , which includes this file, for more details. + */ + +/* Xtensa processor core configuration information. + + Customer ID=11657; Build=0x5fe96; Copyright (c) 1999-2016 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _XTENSA_CORE_CONFIGURATION_H +#define _XTENSA_CORE_CONFIGURATION_H + + +/**************************************************************************** + Parameters Useful for Any Code, USER or PRIVILEGED + ****************************************************************************/ + +/* + * Note: Macros of the form XCHAL_HAVE_*** have a value of 1 if the option is + * configured, and a value of 0 otherwise. These macros are always defined. + */ + + +/*---------------------------------------------------------------------- + ISA + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_BE 0 /* big-endian byte ordering */ +#define XCHAL_HAVE_WINDOWED 1 /* windowed registers option */ +#define XCHAL_NUM_AREGS 64 /* num of physical addr regs */ +#define XCHAL_NUM_AREGS_LOG2 6 /* log2(XCHAL_NUM_AREGS) */ +#define XCHAL_MAX_INSTRUCTION_SIZE 3 /* max instr bytes (3..8) */ +#define XCHAL_HAVE_DEBUG 1 /* debug option */ +#define XCHAL_HAVE_DENSITY 1 /* 16-bit instructions */ +#define XCHAL_HAVE_LOOPS 1 /* zero-overhead loops */ +#define XCHAL_LOOP_BUFFER_SIZE 256 /* zero-ov. loop instr buffer size */ +#define XCHAL_HAVE_NSA 1 /* NSA/NSAU instructions */ +#define XCHAL_HAVE_MINMAX 1 /* MIN/MAX instructions */ +#define XCHAL_HAVE_SEXT 1 /* SEXT instruction */ +#define XCHAL_HAVE_DEPBITS 0 /* DEPBITS instruction */ +#define XCHAL_HAVE_CLAMPS 1 /* CLAMPS instruction */ +#define XCHAL_HAVE_MUL16 1 /* MUL16S/MUL16U instructions */ +#define XCHAL_HAVE_MUL32 1 /* MULL instruction */ +#define XCHAL_HAVE_MUL32_HIGH 1 /* MULUH/MULSH instructions */ +#define XCHAL_HAVE_DIV32 1 /* QUOS/QUOU/REMS/REMU instructions */ +#define XCHAL_HAVE_L32R 1 /* L32R instruction */ +#define XCHAL_HAVE_ABSOLUTE_LITERALS 0 /* non-PC-rel (extended) L32R */ +#define XCHAL_HAVE_CONST16 0 /* CONST16 instruction */ +#define XCHAL_HAVE_ADDX 1 /* ADDX#/SUBX# instructions */ +#define XCHAL_HAVE_WIDE_BRANCHES 0 /* B*.W18 or B*.W15 instr's */ +#define XCHAL_HAVE_PREDICTED_BRANCHES 0 /* B[EQ/EQZ/NE/NEZ]T instr's */ +#define XCHAL_HAVE_CALL4AND12 1 /* (obsolete option) */ +#define XCHAL_HAVE_ABS 1 /* ABS instruction */ +/*#define XCHAL_HAVE_POPC 0*/ /* POPC instruction */ +/*#define XCHAL_HAVE_CRC 0*/ /* CRC instruction */ +#define XCHAL_HAVE_RELEASE_SYNC 1 /* L32AI/S32RI instructions */ +#define XCHAL_HAVE_S32C1I 1 /* S32C1I instruction */ +#define XCHAL_HAVE_SPECULATION 0 /* speculation */ +#define XCHAL_HAVE_FULL_RESET 1 /* all regs/state reset */ +#define XCHAL_NUM_CONTEXTS 1 /* */ +#define XCHAL_NUM_MISC_REGS 4 /* num of scratch regs (0..4) */ +#define XCHAL_HAVE_TAP_MASTER 0 /* JTAG TAP control instr's */ +#define XCHAL_HAVE_PRID 1 /* processor ID register */ +#define XCHAL_HAVE_EXTERN_REGS 1 /* WER/RER instructions */ +#define XCHAL_HAVE_MX 0 /* MX core (Tensilica internal) */ +#define XCHAL_HAVE_MP_INTERRUPTS 0 /* interrupt distributor port */ +#define XCHAL_HAVE_MP_RUNSTALL 0 /* core RunStall control port */ +#define XCHAL_HAVE_PSO 0 /* Power Shut-Off */ +#define XCHAL_HAVE_PSO_CDM 0 /* core/debug/mem pwr domains */ +#define XCHAL_HAVE_PSO_FULL_RETENTION 0 /* all regs preserved on PSO */ +#define XCHAL_HAVE_THREADPTR 1 /* THREADPTR register */ +#define XCHAL_HAVE_BOOLEANS 1 /* boolean registers */ +#define XCHAL_HAVE_CP 1 /* CPENABLE reg (coprocessor) */ +#define XCHAL_CP_MAXCFG 8 /* max allowed cp id plus one */ +#define XCHAL_HAVE_MAC16 1 /* MAC16 package */ + +#define XCHAL_HAVE_FUSION 0 /* Fusion*/ +#define XCHAL_HAVE_FUSION_FP 0 /* Fusion FP option */ +#define XCHAL_HAVE_FUSION_LOW_POWER 0 /* Fusion Low Power option */ +#define XCHAL_HAVE_FUSION_AES 0 /* Fusion BLE/Wifi AES-128 CCM option */ +#define XCHAL_HAVE_FUSION_CONVENC 0 /* Fusion Conv Encode option */ +#define XCHAL_HAVE_FUSION_LFSR_CRC 0 /* Fusion LFSR-CRC option */ +#define XCHAL_HAVE_FUSION_BITOPS 0 /* Fusion Bit Operations Support option */ +#define XCHAL_HAVE_FUSION_AVS 0 /* Fusion AVS option */ +#define XCHAL_HAVE_FUSION_16BIT_BASEBAND 0 /* Fusion 16-bit Baseband option */ +#define XCHAL_HAVE_FUSION_VITERBI 0 /* Fusion Viterbi option */ +#define XCHAL_HAVE_FUSION_SOFTDEMAP 0 /* Fusion Soft Bit Demap option */ +#define XCHAL_HAVE_HIFIPRO 0 /* HiFiPro Audio Engine pkg */ +#define XCHAL_HAVE_HIFI4 0 /* HiFi4 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI4_VFPU 0 /* HiFi4 Audio Engine VFPU option */ +#define XCHAL_HAVE_HIFI3 0 /* HiFi3 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI3_VFPU 0 /* HiFi3 Audio Engine VFPU option */ +#define XCHAL_HAVE_HIFI2 0 /* HiFi2 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI2EP 0 /* HiFi2EP */ +#define XCHAL_HAVE_HIFI_MINI 0 + + +#define XCHAL_HAVE_VECTORFPU2005 0 /* vector or user floating-point pkg */ +#define XCHAL_HAVE_USER_DPFPU 0 /* user DP floating-point pkg */ +#define XCHAL_HAVE_USER_SPFPU 0 /* user DP floating-point pkg */ +#define XCHAL_HAVE_FP 1 /* single prec floating point */ +#define XCHAL_HAVE_FP_DIV 1 /* FP with DIV instructions */ +#define XCHAL_HAVE_FP_RECIP 1 /* FP with RECIP instructions */ +#define XCHAL_HAVE_FP_SQRT 1 /* FP with SQRT instructions */ +#define XCHAL_HAVE_FP_RSQRT 1 /* FP with RSQRT instructions */ +#define XCHAL_HAVE_DFP 0 /* double precision FP pkg */ +#define XCHAL_HAVE_DFP_DIV 0 /* DFP with DIV instructions */ +#define XCHAL_HAVE_DFP_RECIP 0 /* DFP with RECIP instructions*/ +#define XCHAL_HAVE_DFP_SQRT 0 /* DFP with SQRT instructions */ +#define XCHAL_HAVE_DFP_RSQRT 0 /* DFP with RSQRT instructions*/ +#define XCHAL_HAVE_DFP_ACCEL 1 /* double precision FP acceleration pkg */ +#define XCHAL_HAVE_DFP_accel XCHAL_HAVE_DFP_ACCEL /* for backward compatibility */ + +#define XCHAL_HAVE_DFPU_SINGLE_ONLY 1 /* DFPU Coprocessor, single precision only */ +#define XCHAL_HAVE_DFPU_SINGLE_DOUBLE 0 /* DFPU Coprocessor, single and double precision */ +#define XCHAL_HAVE_VECTRA1 0 /* Vectra I pkg */ +#define XCHAL_HAVE_VECTRALX 0 /* Vectra LX pkg */ +#define XCHAL_HAVE_PDX4 0 /* PDX4 */ +#define XCHAL_HAVE_CONNXD2 0 /* ConnX D2 pkg */ +#define XCHAL_HAVE_CONNXD2_DUALLSFLIX 0 /* ConnX D2 & Dual LoadStore Flix */ +#define XCHAL_HAVE_BBE16 0 /* ConnX BBE16 pkg */ +#define XCHAL_HAVE_BBE16_RSQRT 0 /* BBE16 & vector recip sqrt */ +#define XCHAL_HAVE_BBE16_VECDIV 0 /* BBE16 & vector divide */ +#define XCHAL_HAVE_BBE16_DESPREAD 0 /* BBE16 & despread */ +#define XCHAL_HAVE_BBENEP 0 /* ConnX BBENEP pkgs */ +#define XCHAL_HAVE_BSP3 0 /* ConnX BSP3 pkg */ +#define XCHAL_HAVE_BSP3_TRANSPOSE 0 /* BSP3 & transpose32x32 */ +#define XCHAL_HAVE_SSP16 0 /* ConnX SSP16 pkg */ +#define XCHAL_HAVE_SSP16_VITERBI 0 /* SSP16 & viterbi */ +#define XCHAL_HAVE_TURBO16 0 /* ConnX Turbo16 pkg */ +#define XCHAL_HAVE_BBP16 0 /* ConnX BBP16 pkg */ +#define XCHAL_HAVE_FLIX3 0 /* basic 3-way FLIX option */ +#define XCHAL_HAVE_GRIVPEP 0 /* GRIVPEP is General Release of IVPEP */ +#define XCHAL_HAVE_GRIVPEP_HISTOGRAM 0 /* Histogram option on GRIVPEP */ + + +/*---------------------------------------------------------------------- + MISC + ----------------------------------------------------------------------*/ + +#define XCHAL_NUM_LOADSTORE_UNITS 1 /* load/store units */ +#define XCHAL_NUM_WRITEBUFFER_ENTRIES 4 /* size of write buffer */ +#define XCHAL_INST_FETCH_WIDTH 4 /* instr-fetch width in bytes */ +#define XCHAL_DATA_WIDTH 4 /* data width in bytes */ +#define XCHAL_DATA_PIPE_DELAY 2 /* d-side pipeline delay + (1 = 5-stage, 2 = 7-stage) */ +#define XCHAL_CLOCK_GATING_GLOBAL 1 /* global clock gating */ +#define XCHAL_CLOCK_GATING_FUNCUNIT 1 /* funct. unit clock gating */ +/* In T1050, applies to selected core load and store instructions (see ISA): */ +#define XCHAL_UNALIGNED_LOAD_EXCEPTION 0 /* unaligned loads cause exc. */ +#define XCHAL_UNALIGNED_STORE_EXCEPTION 0 /* unaligned stores cause exc.*/ +#define XCHAL_UNALIGNED_LOAD_HW 1 /* unaligned loads work in hw */ +#define XCHAL_UNALIGNED_STORE_HW 1 /* unaligned stores work in hw*/ + +#define XCHAL_SW_VERSION 1100003 /* sw version of this header */ + +#define XCHAL_CORE_ID "esp32_v3_49_prod" /* alphanum core name + (CoreID) set in the Xtensa + Processor Generator */ + +#define XCHAL_BUILD_UNIQUE_ID 0x0005FE96 /* 22-bit sw build ID */ + +/* + * These definitions describe the hardware targeted by this software. + */ +#define XCHAL_HW_CONFIGID0 0xC2BCFFFE /* ConfigID hi 32 bits*/ +#define XCHAL_HW_CONFIGID1 0x1CC5FE96 /* ConfigID lo 32 bits*/ +#define XCHAL_HW_VERSION_NAME "LX6.0.3" /* full version name */ +#define XCHAL_HW_VERSION_MAJOR 2600 /* major ver# of targeted hw */ +#define XCHAL_HW_VERSION_MINOR 3 /* minor ver# of targeted hw */ +#define XCHAL_HW_VERSION 260003 /* major*100+minor */ +#define XCHAL_HW_REL_LX6 1 +#define XCHAL_HW_REL_LX6_0 1 +#define XCHAL_HW_REL_LX6_0_3 1 +#define XCHAL_HW_CONFIGID_RELIABLE 1 +/* If software targets a *range* of hardware versions, these are the bounds: */ +#define XCHAL_HW_MIN_VERSION_MAJOR 2600 /* major v of earliest tgt hw */ +#define XCHAL_HW_MIN_VERSION_MINOR 3 /* minor v of earliest tgt hw */ +#define XCHAL_HW_MIN_VERSION 260003 /* earliest targeted hw */ +#define XCHAL_HW_MAX_VERSION_MAJOR 2600 /* major v of latest tgt hw */ +#define XCHAL_HW_MAX_VERSION_MINOR 3 /* minor v of latest tgt hw */ +#define XCHAL_HW_MAX_VERSION 260003 /* latest targeted hw */ + + +/*---------------------------------------------------------------------- + CACHE + ----------------------------------------------------------------------*/ + +#define XCHAL_ICACHE_LINESIZE 4 /* I-cache line size in bytes */ +#define XCHAL_DCACHE_LINESIZE 4 /* D-cache line size in bytes */ +#define XCHAL_ICACHE_LINEWIDTH 2 /* log2(I line size in bytes) */ +#define XCHAL_DCACHE_LINEWIDTH 2 /* log2(D line size in bytes) */ + +#define XCHAL_ICACHE_SIZE 0 /* I-cache size in bytes or 0 */ +#define XCHAL_DCACHE_SIZE 0 /* D-cache size in bytes or 0 */ + +#define XCHAL_DCACHE_IS_WRITEBACK 0 /* writeback feature */ +#define XCHAL_DCACHE_IS_COHERENT 0 /* MP coherence feature */ + +#define XCHAL_HAVE_PREFETCH 0 /* PREFCTL register */ +#define XCHAL_HAVE_PREFETCH_L1 0 /* prefetch to L1 dcache */ +#define XCHAL_PREFETCH_CASTOUT_LINES 0 /* dcache pref. castout bufsz */ +#define XCHAL_PREFETCH_ENTRIES 0 /* cache prefetch entries */ +#define XCHAL_PREFETCH_BLOCK_ENTRIES 0 /* prefetch block streams */ +#define XCHAL_HAVE_CACHE_BLOCKOPS 0 /* block prefetch for caches */ +#define XCHAL_HAVE_ICACHE_TEST 0 /* Icache test instructions */ +#define XCHAL_HAVE_DCACHE_TEST 0 /* Dcache test instructions */ +#define XCHAL_HAVE_ICACHE_DYN_WAYS 0 /* Icache dynamic way support */ +#define XCHAL_HAVE_DCACHE_DYN_WAYS 0 /* Dcache dynamic way support */ + + + + +/**************************************************************************** + Parameters Useful for PRIVILEGED (Supervisory or Non-Virtualized) Code + ****************************************************************************/ + + +#ifndef XTENSA_HAL_NON_PRIVILEGED_ONLY + +/*---------------------------------------------------------------------- + CACHE + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_PIF 1 /* any outbound PIF present */ +#define XCHAL_HAVE_AXI 0 /* AXI bus */ + +#define XCHAL_HAVE_PIF_WR_RESP 0 /* pif write response */ +#define XCHAL_HAVE_PIF_REQ_ATTR 0 /* pif attribute */ + +/* If present, cache size in bytes == (ways * 2^(linewidth + setwidth)). */ + +/* Number of cache sets in log2(lines per way): */ +#define XCHAL_ICACHE_SETWIDTH 0 +#define XCHAL_DCACHE_SETWIDTH 0 + +/* Cache set associativity (number of ways): */ +#define XCHAL_ICACHE_WAYS 1 +#define XCHAL_DCACHE_WAYS 1 + +/* Cache features: */ +#define XCHAL_ICACHE_LINE_LOCKABLE 0 +#define XCHAL_DCACHE_LINE_LOCKABLE 0 +#define XCHAL_ICACHE_ECC_PARITY 0 +#define XCHAL_DCACHE_ECC_PARITY 0 + +/* Cache access size in bytes (affects operation of SICW instruction): */ +#define XCHAL_ICACHE_ACCESS_SIZE 1 +#define XCHAL_DCACHE_ACCESS_SIZE 1 + +#define XCHAL_DCACHE_BANKS 0 /* number of banks */ + +/* Number of encoded cache attr bits (see for decoded bits): */ +#define XCHAL_CA_BITS 4 + + +/*---------------------------------------------------------------------- + INTERNAL I/D RAM/ROMs and XLMI + ----------------------------------------------------------------------*/ + +#define XCHAL_NUM_INSTROM 1 /* number of core instr. ROMs */ +#define XCHAL_NUM_INSTRAM 2 /* number of core instr. RAMs */ +#define XCHAL_NUM_DATAROM 1 /* number of core data ROMs */ +#define XCHAL_NUM_DATARAM 2 /* number of core data RAMs */ +#define XCHAL_NUM_URAM 0 /* number of core unified RAMs*/ +#define XCHAL_NUM_XLMI 1 /* number of core XLMI ports */ + +/* Instruction ROM 0: */ +#define XCHAL_INSTROM0_VADDR 0x40800000 /* virtual address */ +#define XCHAL_INSTROM0_PADDR 0x40800000 /* physical address */ +#define XCHAL_INSTROM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTROM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Instruction RAM 0: */ +#define XCHAL_INSTRAM0_VADDR 0x40000000 /* virtual address */ +#define XCHAL_INSTRAM0_PADDR 0x40000000 /* physical address */ +#define XCHAL_INSTRAM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTRAM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Instruction RAM 1: */ +#define XCHAL_INSTRAM1_VADDR 0x40400000 /* virtual address */ +#define XCHAL_INSTRAM1_PADDR 0x40400000 /* physical address */ +#define XCHAL_INSTRAM1_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTRAM1_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Data ROM 0: */ +#define XCHAL_DATAROM0_VADDR 0x3F400000 /* virtual address */ +#define XCHAL_DATAROM0_PADDR 0x3F400000 /* physical address */ +#define XCHAL_DATAROM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_DATAROM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATAROM0_BANKS 1 /* number of banks */ + +/* Data RAM 0: */ +#define XCHAL_DATARAM0_VADDR 0x3FF80000 /* virtual address */ +#define XCHAL_DATARAM0_PADDR 0x3FF80000 /* physical address */ +#define XCHAL_DATARAM0_SIZE 524288 /* size in bytes */ +#define XCHAL_DATARAM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATARAM0_BANKS 1 /* number of banks */ + +/* Data RAM 1: */ +#define XCHAL_DATARAM1_VADDR 0x3F800000 /* virtual address */ +#define XCHAL_DATARAM1_PADDR 0x3F800000 /* physical address */ +#define XCHAL_DATARAM1_SIZE 4194304 /* size in bytes */ +#define XCHAL_DATARAM1_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATARAM1_BANKS 1 /* number of banks */ + +/* XLMI Port 0: */ +#define XCHAL_XLMI0_VADDR 0x3FF00000 /* virtual address */ +#define XCHAL_XLMI0_PADDR 0x3FF00000 /* physical address */ +#define XCHAL_XLMI0_SIZE 524288 /* size in bytes */ +#define XCHAL_XLMI0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +#define XCHAL_HAVE_IMEM_LOADSTORE 1 /* can load/store to IROM/IRAM*/ + + +/*---------------------------------------------------------------------- + INTERRUPTS and TIMERS + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_INTERRUPTS 1 /* interrupt option */ +#define XCHAL_HAVE_HIGHPRI_INTERRUPTS 1 /* med/high-pri. interrupts */ +#define XCHAL_HAVE_NMI 1 /* non-maskable interrupt */ +#define XCHAL_HAVE_CCOUNT 1 /* CCOUNT reg. (timer option) */ +#define XCHAL_NUM_TIMERS 3 /* number of CCOMPAREn regs */ +#define XCHAL_NUM_INTERRUPTS 32 /* number of interrupts */ +#define XCHAL_NUM_INTERRUPTS_LOG2 5 /* ceil(log2(NUM_INTERRUPTS)) */ +#define XCHAL_NUM_EXTINTERRUPTS 26 /* num of external interrupts */ +#define XCHAL_NUM_INTLEVELS 6 /* number of interrupt levels + (not including level zero) */ +#define XCHAL_EXCM_LEVEL 3 /* level masked by PS.EXCM */ + /* (always 1 in XEA1; levels 2 .. EXCM_LEVEL are "medium priority") */ + +/* Masks of interrupts at each interrupt level: */ +#define XCHAL_INTLEVEL1_MASK 0x000637FF +#define XCHAL_INTLEVEL2_MASK 0x00380000 +#define XCHAL_INTLEVEL3_MASK 0x28C08800 +#define XCHAL_INTLEVEL4_MASK 0x53000000 +#define XCHAL_INTLEVEL5_MASK 0x84010000 +#define XCHAL_INTLEVEL6_MASK 0x00000000 +#define XCHAL_INTLEVEL7_MASK 0x00004000 + +/* Masks of interrupts at each range 1..n of interrupt levels: */ +#define XCHAL_INTLEVEL1_ANDBELOW_MASK 0x000637FF +#define XCHAL_INTLEVEL2_ANDBELOW_MASK 0x003E37FF +#define XCHAL_INTLEVEL3_ANDBELOW_MASK 0x28FEBFFF +#define XCHAL_INTLEVEL4_ANDBELOW_MASK 0x7BFEBFFF +#define XCHAL_INTLEVEL5_ANDBELOW_MASK 0xFFFFBFFF +#define XCHAL_INTLEVEL6_ANDBELOW_MASK 0xFFFFBFFF +#define XCHAL_INTLEVEL7_ANDBELOW_MASK 0xFFFFFFFF + +/* Level of each interrupt: */ +#define XCHAL_INT0_LEVEL 1 +#define XCHAL_INT1_LEVEL 1 +#define XCHAL_INT2_LEVEL 1 +#define XCHAL_INT3_LEVEL 1 +#define XCHAL_INT4_LEVEL 1 +#define XCHAL_INT5_LEVEL 1 +#define XCHAL_INT6_LEVEL 1 +#define XCHAL_INT7_LEVEL 1 +#define XCHAL_INT8_LEVEL 1 +#define XCHAL_INT9_LEVEL 1 +#define XCHAL_INT10_LEVEL 1 +#define XCHAL_INT11_LEVEL 3 +#define XCHAL_INT12_LEVEL 1 +#define XCHAL_INT13_LEVEL 1 +#define XCHAL_INT14_LEVEL 7 +#define XCHAL_INT15_LEVEL 3 +#define XCHAL_INT16_LEVEL 5 +#define XCHAL_INT17_LEVEL 1 +#define XCHAL_INT18_LEVEL 1 +#define XCHAL_INT19_LEVEL 2 +#define XCHAL_INT20_LEVEL 2 +#define XCHAL_INT21_LEVEL 2 +#define XCHAL_INT22_LEVEL 3 +#define XCHAL_INT23_LEVEL 3 +#define XCHAL_INT24_LEVEL 4 +#define XCHAL_INT25_LEVEL 4 +#define XCHAL_INT26_LEVEL 5 +#define XCHAL_INT27_LEVEL 3 +#define XCHAL_INT28_LEVEL 4 +#define XCHAL_INT29_LEVEL 3 +#define XCHAL_INT30_LEVEL 4 +#define XCHAL_INT31_LEVEL 5 +#define XCHAL_DEBUGLEVEL 6 /* debug interrupt level */ +#define XCHAL_HAVE_DEBUG_EXTERN_INT 1 /* OCD external db interrupt */ +#define XCHAL_NMILEVEL 7 /* NMI "level" (for use with + EXCSAVE/EPS/EPC_n, RFI n) */ + +/* Type of each interrupt: */ +#define XCHAL_INT0_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT1_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT2_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT3_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT4_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT5_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT6_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT7_TYPE XTHAL_INTTYPE_SOFTWARE +#define XCHAL_INT8_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT9_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT10_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT11_TYPE XTHAL_INTTYPE_PROFILING +#define XCHAL_INT12_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT13_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT14_TYPE XTHAL_INTTYPE_NMI +#define XCHAL_INT15_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT16_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT17_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT18_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT19_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT20_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT21_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT22_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT23_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT24_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT25_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT26_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT27_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT28_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT29_TYPE XTHAL_INTTYPE_SOFTWARE +#define XCHAL_INT30_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT31_TYPE XTHAL_INTTYPE_EXTERN_LEVEL + +/* Masks of interrupts for each type of interrupt: */ +#define XCHAL_INTTYPE_MASK_UNCONFIGURED 0x00000000 +#define XCHAL_INTTYPE_MASK_SOFTWARE 0x20000080 +#define XCHAL_INTTYPE_MASK_EXTERN_EDGE 0x50400400 +#define XCHAL_INTTYPE_MASK_EXTERN_LEVEL 0x8FBE333F +#define XCHAL_INTTYPE_MASK_TIMER 0x00018040 +#define XCHAL_INTTYPE_MASK_NMI 0x00004000 +#define XCHAL_INTTYPE_MASK_WRITE_ERROR 0x00000000 +#define XCHAL_INTTYPE_MASK_PROFILING 0x00000800 + +/* Interrupt numbers assigned to specific interrupt sources: */ +#define XCHAL_TIMER0_INTERRUPT 6 /* CCOMPARE0 */ +#define XCHAL_TIMER1_INTERRUPT 15 /* CCOMPARE1 */ +#define XCHAL_TIMER2_INTERRUPT 16 /* CCOMPARE2 */ +#define XCHAL_TIMER3_INTERRUPT XTHAL_TIMER_UNCONFIGURED +#define XCHAL_NMI_INTERRUPT 14 /* non-maskable interrupt */ +#define XCHAL_PROFILING_INTERRUPT 11 /* profiling interrupt */ + +/* Interrupt numbers for levels at which only one interrupt is configured: */ +#define XCHAL_INTLEVEL7_NUM 14 +/* (There are many interrupts each at level(s) 1, 2, 3, 4, 5.) */ + + +/* + * External interrupt mapping. + * These macros describe how Xtensa processor interrupt numbers + * (as numbered internally, eg. in INTERRUPT and INTENABLE registers) + * map to external BInterrupt pins, for those interrupts + * configured as external (level-triggered, edge-triggered, or NMI). + * See the Xtensa processor databook for more details. + */ + +/* Core interrupt numbers mapped to each EXTERNAL BInterrupt pin number: */ +#define XCHAL_EXTINT0_NUM 0 /* (intlevel 1) */ +#define XCHAL_EXTINT1_NUM 1 /* (intlevel 1) */ +#define XCHAL_EXTINT2_NUM 2 /* (intlevel 1) */ +#define XCHAL_EXTINT3_NUM 3 /* (intlevel 1) */ +#define XCHAL_EXTINT4_NUM 4 /* (intlevel 1) */ +#define XCHAL_EXTINT5_NUM 5 /* (intlevel 1) */ +#define XCHAL_EXTINT6_NUM 8 /* (intlevel 1) */ +#define XCHAL_EXTINT7_NUM 9 /* (intlevel 1) */ +#define XCHAL_EXTINT8_NUM 10 /* (intlevel 1) */ +#define XCHAL_EXTINT9_NUM 12 /* (intlevel 1) */ +#define XCHAL_EXTINT10_NUM 13 /* (intlevel 1) */ +#define XCHAL_EXTINT11_NUM 14 /* (intlevel 7) */ +#define XCHAL_EXTINT12_NUM 17 /* (intlevel 1) */ +#define XCHAL_EXTINT13_NUM 18 /* (intlevel 1) */ +#define XCHAL_EXTINT14_NUM 19 /* (intlevel 2) */ +#define XCHAL_EXTINT15_NUM 20 /* (intlevel 2) */ +#define XCHAL_EXTINT16_NUM 21 /* (intlevel 2) */ +#define XCHAL_EXTINT17_NUM 22 /* (intlevel 3) */ +#define XCHAL_EXTINT18_NUM 23 /* (intlevel 3) */ +#define XCHAL_EXTINT19_NUM 24 /* (intlevel 4) */ +#define XCHAL_EXTINT20_NUM 25 /* (intlevel 4) */ +#define XCHAL_EXTINT21_NUM 26 /* (intlevel 5) */ +#define XCHAL_EXTINT22_NUM 27 /* (intlevel 3) */ +#define XCHAL_EXTINT23_NUM 28 /* (intlevel 4) */ +#define XCHAL_EXTINT24_NUM 30 /* (intlevel 4) */ +#define XCHAL_EXTINT25_NUM 31 /* (intlevel 5) */ +/* EXTERNAL BInterrupt pin numbers mapped to each core interrupt number: */ +#define XCHAL_INT0_EXTNUM 0 /* (intlevel 1) */ +#define XCHAL_INT1_EXTNUM 1 /* (intlevel 1) */ +#define XCHAL_INT2_EXTNUM 2 /* (intlevel 1) */ +#define XCHAL_INT3_EXTNUM 3 /* (intlevel 1) */ +#define XCHAL_INT4_EXTNUM 4 /* (intlevel 1) */ +#define XCHAL_INT5_EXTNUM 5 /* (intlevel 1) */ +#define XCHAL_INT8_EXTNUM 6 /* (intlevel 1) */ +#define XCHAL_INT9_EXTNUM 7 /* (intlevel 1) */ +#define XCHAL_INT10_EXTNUM 8 /* (intlevel 1) */ +#define XCHAL_INT12_EXTNUM 9 /* (intlevel 1) */ +#define XCHAL_INT13_EXTNUM 10 /* (intlevel 1) */ +#define XCHAL_INT14_EXTNUM 11 /* (intlevel 7) */ +#define XCHAL_INT17_EXTNUM 12 /* (intlevel 1) */ +#define XCHAL_INT18_EXTNUM 13 /* (intlevel 1) */ +#define XCHAL_INT19_EXTNUM 14 /* (intlevel 2) */ +#define XCHAL_INT20_EXTNUM 15 /* (intlevel 2) */ +#define XCHAL_INT21_EXTNUM 16 /* (intlevel 2) */ +#define XCHAL_INT22_EXTNUM 17 /* (intlevel 3) */ +#define XCHAL_INT23_EXTNUM 18 /* (intlevel 3) */ +#define XCHAL_INT24_EXTNUM 19 /* (intlevel 4) */ +#define XCHAL_INT25_EXTNUM 20 /* (intlevel 4) */ +#define XCHAL_INT26_EXTNUM 21 /* (intlevel 5) */ +#define XCHAL_INT27_EXTNUM 22 /* (intlevel 3) */ +#define XCHAL_INT28_EXTNUM 23 /* (intlevel 4) */ +#define XCHAL_INT30_EXTNUM 24 /* (intlevel 4) */ +#define XCHAL_INT31_EXTNUM 25 /* (intlevel 5) */ + + +/*---------------------------------------------------------------------- + EXCEPTIONS and VECTORS + ----------------------------------------------------------------------*/ + +#define XCHAL_XEA_VERSION 2 /* Xtensa Exception Architecture + number: 1 == XEA1 (old) + 2 == XEA2 (new) + 0 == XEAX (extern) or TX */ +#define XCHAL_HAVE_XEA1 0 /* Exception Architecture 1 */ +#define XCHAL_HAVE_XEA2 1 /* Exception Architecture 2 */ +#define XCHAL_HAVE_XEAX 0 /* External Exception Arch. */ +#define XCHAL_HAVE_EXCEPTIONS 1 /* exception option */ +#define XCHAL_HAVE_HALT 0 /* halt architecture option */ +#define XCHAL_HAVE_BOOTLOADER 0 /* boot loader (for TX) */ +#define XCHAL_HAVE_MEM_ECC_PARITY 0 /* local memory ECC/parity */ +#define XCHAL_HAVE_VECTOR_SELECT 1 /* relocatable vectors */ +#define XCHAL_HAVE_VECBASE 1 /* relocatable vectors */ +#define XCHAL_VECBASE_RESET_VADDR 0x40000000 /* VECBASE reset value */ +#define XCHAL_VECBASE_RESET_PADDR 0x40000000 +#define XCHAL_RESET_VECBASE_OVERLAP 0 + +#define XCHAL_RESET_VECTOR0_VADDR 0x50000000 +#define XCHAL_RESET_VECTOR0_PADDR 0x50000000 +#define XCHAL_RESET_VECTOR1_VADDR 0x40000400 +#define XCHAL_RESET_VECTOR1_PADDR 0x40000400 +#define XCHAL_RESET_VECTOR_VADDR 0x40000400 +#define XCHAL_RESET_VECTOR_PADDR 0x40000400 +#define XCHAL_USER_VECOFS 0x00000340 +#define XCHAL_USER_VECTOR_VADDR 0x40000340 +#define XCHAL_USER_VECTOR_PADDR 0x40000340 +#define XCHAL_KERNEL_VECOFS 0x00000300 +#define XCHAL_KERNEL_VECTOR_VADDR 0x40000300 +#define XCHAL_KERNEL_VECTOR_PADDR 0x40000300 +#define XCHAL_DOUBLEEXC_VECOFS 0x000003C0 +#define XCHAL_DOUBLEEXC_VECTOR_VADDR 0x400003C0 +#define XCHAL_DOUBLEEXC_VECTOR_PADDR 0x400003C0 +#define XCHAL_WINDOW_OF4_VECOFS 0x00000000 +#define XCHAL_WINDOW_UF4_VECOFS 0x00000040 +#define XCHAL_WINDOW_OF8_VECOFS 0x00000080 +#define XCHAL_WINDOW_UF8_VECOFS 0x000000C0 +#define XCHAL_WINDOW_OF12_VECOFS 0x00000100 +#define XCHAL_WINDOW_UF12_VECOFS 0x00000140 +#define XCHAL_WINDOW_VECTORS_VADDR 0x40000000 +#define XCHAL_WINDOW_VECTORS_PADDR 0x40000000 +#define XCHAL_INTLEVEL2_VECOFS 0x00000180 +#define XCHAL_INTLEVEL2_VECTOR_VADDR 0x40000180 +#define XCHAL_INTLEVEL2_VECTOR_PADDR 0x40000180 +#define XCHAL_INTLEVEL3_VECOFS 0x000001C0 +#define XCHAL_INTLEVEL3_VECTOR_VADDR 0x400001C0 +#define XCHAL_INTLEVEL3_VECTOR_PADDR 0x400001C0 +#define XCHAL_INTLEVEL4_VECOFS 0x00000200 +#define XCHAL_INTLEVEL4_VECTOR_VADDR 0x40000200 +#define XCHAL_INTLEVEL4_VECTOR_PADDR 0x40000200 +#define XCHAL_INTLEVEL5_VECOFS 0x00000240 +#define XCHAL_INTLEVEL5_VECTOR_VADDR 0x40000240 +#define XCHAL_INTLEVEL5_VECTOR_PADDR 0x40000240 +#define XCHAL_INTLEVEL6_VECOFS 0x00000280 +#define XCHAL_INTLEVEL6_VECTOR_VADDR 0x40000280 +#define XCHAL_INTLEVEL6_VECTOR_PADDR 0x40000280 +#define XCHAL_DEBUG_VECOFS XCHAL_INTLEVEL6_VECOFS +#define XCHAL_DEBUG_VECTOR_VADDR XCHAL_INTLEVEL6_VECTOR_VADDR +#define XCHAL_DEBUG_VECTOR_PADDR XCHAL_INTLEVEL6_VECTOR_PADDR +#define XCHAL_NMI_VECOFS 0x000002C0 +#define XCHAL_NMI_VECTOR_VADDR 0x400002C0 +#define XCHAL_NMI_VECTOR_PADDR 0x400002C0 +#define XCHAL_INTLEVEL7_VECOFS XCHAL_NMI_VECOFS +#define XCHAL_INTLEVEL7_VECTOR_VADDR XCHAL_NMI_VECTOR_VADDR +#define XCHAL_INTLEVEL7_VECTOR_PADDR XCHAL_NMI_VECTOR_PADDR + + +/*---------------------------------------------------------------------- + DEBUG MODULE + ----------------------------------------------------------------------*/ + +/* Misc */ +#define XCHAL_HAVE_DEBUG_ERI 1 /* ERI to debug module */ +#define XCHAL_HAVE_DEBUG_APB 1 /* APB to debug module */ +#define XCHAL_HAVE_DEBUG_JTAG 1 /* JTAG to debug module */ + +/* On-Chip Debug (OCD) */ +#define XCHAL_HAVE_OCD 1 /* OnChipDebug option */ +#define XCHAL_NUM_IBREAK 2 /* number of IBREAKn regs */ +#define XCHAL_NUM_DBREAK 2 /* number of DBREAKn regs */ +#define XCHAL_HAVE_OCD_DIR_ARRAY 0 /* faster OCD option (to LX4) */ +#define XCHAL_HAVE_OCD_LS32DDR 1 /* L32DDR/S32DDR (faster OCD) */ + +/* TRAX (in core) */ +#define XCHAL_HAVE_TRAX 1 /* TRAX in debug module */ +#define XCHAL_TRAX_MEM_SIZE 16384 /* TRAX memory size in bytes */ +#define XCHAL_TRAX_MEM_SHAREABLE 1 /* start/end regs; ready sig. */ +#define XCHAL_TRAX_ATB_WIDTH 32 /* ATB width (bits), 0=no ATB */ +#define XCHAL_TRAX_TIME_WIDTH 0 /* timestamp bitwidth, 0=none */ + +/* Perf counters */ +#define XCHAL_NUM_PERF_COUNTERS 2 /* performance counters */ + + +/*---------------------------------------------------------------------- + MMU + ----------------------------------------------------------------------*/ + +/* See core-matmap.h header file for more details. */ + +#define XCHAL_HAVE_TLBS 1 /* inverse of HAVE_CACHEATTR */ +#define XCHAL_HAVE_SPANNING_WAY 1 /* one way maps I+D 4GB vaddr */ +#define XCHAL_SPANNING_WAY 0 /* TLB spanning way number */ +#define XCHAL_HAVE_IDENTITY_MAP 1 /* vaddr == paddr always */ +#define XCHAL_HAVE_CACHEATTR 0 /* CACHEATTR register present */ +#define XCHAL_HAVE_MIMIC_CACHEATTR 1 /* region protection */ +#define XCHAL_HAVE_XLT_CACHEATTR 0 /* region prot. w/translation */ +#define XCHAL_HAVE_PTP_MMU 0 /* full MMU (with page table + [autorefill] and protection) + usable for an MMU-based OS */ +/* If none of the above last 4 are set, it's a custom TLB configuration. */ + +#define XCHAL_MMU_ASID_BITS 0 /* number of bits in ASIDs */ +#define XCHAL_MMU_RINGS 1 /* number of rings (1..4) */ +#define XCHAL_MMU_RING_BITS 0 /* num of bits in RING field */ + +#endif /* !XTENSA_HAL_NON_PRIVILEGED_ONLY */ + + +#endif /* _XTENSA_CORE_CONFIGURATION_H */ + diff --git a/components/esp32/include/xtensa/config/core-matmap.h b/components/esp32/include/xtensa/config/core-matmap.h new file mode 100644 index 000000000..b101f1e6a --- /dev/null +++ b/components/esp32/include/xtensa/config/core-matmap.h @@ -0,0 +1,318 @@ +/* + * xtensa/config/core-matmap.h -- Memory access and translation mapping + * parameters (CHAL) of the Xtensa processor core configuration. + * + * If you are using Xtensa Tools, see (which includes + * this file) for more details. + * + * In the Xtensa processor products released to date, all parameters + * defined in this file are derivable (at least in theory) from + * information contained in the core-isa.h header file. + * In particular, the following core configuration parameters are relevant: + * XCHAL_HAVE_CACHEATTR + * XCHAL_HAVE_MIMIC_CACHEATTR + * XCHAL_HAVE_XLT_CACHEATTR + * XCHAL_HAVE_PTP_MMU + * XCHAL_ITLB_ARF_ENTRIES_LOG2 + * XCHAL_DTLB_ARF_ENTRIES_LOG2 + * XCHAL_DCACHE_IS_WRITEBACK + * XCHAL_ICACHE_SIZE (presence of I-cache) + * XCHAL_DCACHE_SIZE (presence of D-cache) + * XCHAL_HW_VERSION_MAJOR + * XCHAL_HW_VERSION_MINOR + */ + +/* Customer ID=11657; Build=0x5fe96; Copyright (c) 1999-2016 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + + +#ifndef XTENSA_CONFIG_CORE_MATMAP_H +#define XTENSA_CONFIG_CORE_MATMAP_H + + +/*---------------------------------------------------------------------- + CACHE (MEMORY ACCESS) ATTRIBUTES + ----------------------------------------------------------------------*/ + + +/* Cache Attribute encodings -- lists of access modes for each cache attribute: */ +#define XCHAL_FCA_LIST XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_BYPASS XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION XCHAL_SEP \ + XTHAL_FAM_EXCEPTION +#define XCHAL_LCA_LIST XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_EXCEPTION XCHAL_SEP \ + XTHAL_LAM_BYPASSG XCHAL_SEP \ + XTHAL_LAM_EXCEPTION +#define XCHAL_SCA_LIST XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_EXCEPTION XCHAL_SEP \ + XTHAL_SAM_BYPASS XCHAL_SEP \ + XTHAL_SAM_EXCEPTION + + +/* + * Specific encoded cache attribute values of general interest. + * If a specific cache mode is not available, the closest available + * one is returned instead (eg. writethru instead of writeback, + * bypass instead of writethru). + */ +#define XCHAL_CA_BYPASS 2 /* cache disabled (bypassed) mode */ +#define XCHAL_CA_BYPASSBUF 6 /* cache disabled (bypassed) bufferable mode */ +#define XCHAL_CA_WRITETHRU 2 /* cache enabled (write-through) mode */ +#define XCHAL_CA_WRITEBACK 2 /* cache enabled (write-back) mode */ +#define XCHAL_HAVE_CA_WRITEBACK_NOALLOC 0 /* write-back no-allocate availability */ +#define XCHAL_CA_WRITEBACK_NOALLOC 2 /* cache enabled (write-back no-allocate) mode */ +#define XCHAL_CA_BYPASS_RW 0 /* cache disabled (bypassed) mode (no exec) */ +#define XCHAL_CA_WRITETHRU_RW 0 /* cache enabled (write-through) mode (no exec) */ +#define XCHAL_CA_WRITEBACK_RW 0 /* cache enabled (write-back) mode (no exec) */ +#define XCHAL_CA_WRITEBACK_NOALLOC_RW 0 /* cache enabled (write-back no-allocate) mode (no exec) */ +#define XCHAL_CA_ILLEGAL 15 /* no access allowed (all cause exceptions) mode */ +#define XCHAL_CA_ISOLATE 0 /* cache isolate (accesses go to cache not memory) mode */ + + +/*---------------------------------------------------------------------- + MMU + ----------------------------------------------------------------------*/ + +/* + * General notes on MMU parameters. + * + * Terminology: + * ASID = address-space ID (acts as an "extension" of virtual addresses) + * VPN = virtual page number + * PPN = physical page number + * CA = encoded cache attribute (access modes) + * TLB = translation look-aside buffer (term is stretched somewhat here) + * I = instruction (fetch accesses) + * D = data (load and store accesses) + * way = each TLB (ITLB and DTLB) consists of a number of "ways" + * that simultaneously match the virtual address of an access; + * a TLB successfully translates a virtual address if exactly + * one way matches the vaddr; if none match, it is a miss; + * if multiple match, one gets a "multihit" exception; + * each way can be independently configured in terms of number of + * entries, page sizes, which fields are writable or constant, etc. + * set = group of contiguous ways with exactly identical parameters + * ARF = auto-refill; hardware services a 1st-level miss by loading a PTE + * from the page table and storing it in one of the auto-refill ways; + * if this PTE load also misses, a miss exception is posted for s/w. + * min-wired = a "min-wired" way can be used to map a single (minimum-sized) + * page arbitrarily under program control; it has a single entry, + * is non-auto-refill (some other way(s) must be auto-refill), + * all its fields (VPN, PPN, ASID, CA) are all writable, and it + * supports the XCHAL_MMU_MIN_PTE_PAGE_SIZE page size (a current + * restriction is that this be the only page size it supports). + * + * TLB way entries are virtually indexed. + * TLB ways that support multiple page sizes: + * - must have all writable VPN and PPN fields; + * - can only use one page size at any given time (eg. setup at startup), + * selected by the respective ITLBCFG or DTLBCFG special register, + * whose bits n*4+3 .. n*4 index the list of page sizes for way n + * (XCHAL_xTLB_SETm_PAGESZ_LOG2_LIST for set m corresponding to way n); + * this list may be sparse for auto-refill ways because auto-refill + * ways have independent lists of supported page sizes sharing a + * common encoding with PTE entries; the encoding is the index into + * this list; unsupported sizes for a given way are zero in the list; + * selecting unsupported sizes results in undefined hardware behaviour; + * - is only possible for ways 0 thru 7 (due to ITLBCFG/DTLBCFG definition). + */ + +#define XCHAL_MMU_ASID_INVALID 0 /* ASID value indicating invalid address space */ +#define XCHAL_MMU_ASID_KERNEL 0 /* ASID value indicating kernel (ring 0) address space */ +#define XCHAL_MMU_SR_BITS 0 /* number of size-restriction bits supported */ +#define XCHAL_MMU_CA_BITS 4 /* number of bits needed to hold cache attribute encoding */ +#define XCHAL_MMU_MAX_PTE_PAGE_SIZE 29 /* max page size in a PTE structure (log2) */ +#define XCHAL_MMU_MIN_PTE_PAGE_SIZE 29 /* min page size in a PTE structure (log2) */ + + +/*** Instruction TLB: ***/ + +#define XCHAL_ITLB_WAY_BITS 0 /* number of bits holding the ways */ +#define XCHAL_ITLB_WAYS 1 /* number of ways (n-way set-associative TLB) */ +#define XCHAL_ITLB_ARF_WAYS 0 /* number of auto-refill ways */ +#define XCHAL_ITLB_SETS 1 /* number of sets (groups of ways with identical settings) */ + +/* Way set to which each way belongs: */ +#define XCHAL_ITLB_WAY0_SET 0 + +/* Ways sets that are used by hardware auto-refill (ARF): */ +#define XCHAL_ITLB_ARF_SETS 0 /* number of auto-refill sets */ + +/* Way sets that are "min-wired" (see terminology comment above): */ +#define XCHAL_ITLB_MINWIRED_SETS 0 /* number of "min-wired" sets */ + + +/* ITLB way set 0 (group of ways 0 thru 0): */ +#define XCHAL_ITLB_SET0_WAY 0 /* index of first way in this way set */ +#define XCHAL_ITLB_SET0_WAYS 1 /* number of (contiguous) ways in this way set */ +#define XCHAL_ITLB_SET0_ENTRIES_LOG2 3 /* log2(number of entries in this way) */ +#define XCHAL_ITLB_SET0_ENTRIES 8 /* number of entries in this way (always a power of 2) */ +#define XCHAL_ITLB_SET0_ARF 0 /* 1=autorefill by h/w, 0=non-autorefill (wired/constant/static) */ +#define XCHAL_ITLB_SET0_PAGESIZES 1 /* number of supported page sizes in this way */ +#define XCHAL_ITLB_SET0_PAGESZ_BITS 0 /* number of bits to encode the page size */ +#define XCHAL_ITLB_SET0_PAGESZ_LOG2_MIN 29 /* log2(minimum supported page size) */ +#define XCHAL_ITLB_SET0_PAGESZ_LOG2_MAX 29 /* log2(maximum supported page size) */ +#define XCHAL_ITLB_SET0_PAGESZ_LOG2_LIST 29 /* list of log2(page size)s, separated by XCHAL_SEP; + 2^PAGESZ_BITS entries in list, unsupported entries are zero */ +#define XCHAL_ITLB_SET0_ASID_CONSTMASK 0 /* constant ASID bits; 0 if all writable */ +#define XCHAL_ITLB_SET0_VPN_CONSTMASK 0x00000000 /* constant VPN bits, not including entry index bits; 0 if all writable */ +#define XCHAL_ITLB_SET0_PPN_CONSTMASK 0xE0000000 /* constant PPN bits, including entry index bits; 0 if all writable */ +#define XCHAL_ITLB_SET0_CA_CONSTMASK 0 /* constant CA bits; 0 if all writable */ +#define XCHAL_ITLB_SET0_ASID_RESET 0 /* 1 if ASID reset values defined (and all writable); 0 otherwise */ +#define XCHAL_ITLB_SET0_VPN_RESET 0 /* 1 if VPN reset values defined (and all writable); 0 otherwise */ +#define XCHAL_ITLB_SET0_PPN_RESET 0 /* 1 if PPN reset values defined (and all writable); 0 otherwise */ +#define XCHAL_ITLB_SET0_CA_RESET 1 /* 1 if CA reset values defined (and all writable); 0 otherwise */ +/* Constant VPN values for each entry of ITLB way set 0 (because VPN_CONSTMASK is non-zero): */ +#define XCHAL_ITLB_SET0_E0_VPN_CONST 0x00000000 +#define XCHAL_ITLB_SET0_E1_VPN_CONST 0x20000000 +#define XCHAL_ITLB_SET0_E2_VPN_CONST 0x40000000 +#define XCHAL_ITLB_SET0_E3_VPN_CONST 0x60000000 +#define XCHAL_ITLB_SET0_E4_VPN_CONST 0x80000000 +#define XCHAL_ITLB_SET0_E5_VPN_CONST 0xA0000000 +#define XCHAL_ITLB_SET0_E6_VPN_CONST 0xC0000000 +#define XCHAL_ITLB_SET0_E7_VPN_CONST 0xE0000000 +/* Constant PPN values for each entry of ITLB way set 0 (because PPN_CONSTMASK is non-zero): */ +#define XCHAL_ITLB_SET0_E0_PPN_CONST 0x00000000 +#define XCHAL_ITLB_SET0_E1_PPN_CONST 0x20000000 +#define XCHAL_ITLB_SET0_E2_PPN_CONST 0x40000000 +#define XCHAL_ITLB_SET0_E3_PPN_CONST 0x60000000 +#define XCHAL_ITLB_SET0_E4_PPN_CONST 0x80000000 +#define XCHAL_ITLB_SET0_E5_PPN_CONST 0xA0000000 +#define XCHAL_ITLB_SET0_E6_PPN_CONST 0xC0000000 +#define XCHAL_ITLB_SET0_E7_PPN_CONST 0xE0000000 +/* Reset CA values for each entry of ITLB way set 0 (because SET0_CA_RESET is non-zero): */ +#define XCHAL_ITLB_SET0_E0_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E1_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E2_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E3_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E4_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E5_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E6_CA_RESET 0x02 +#define XCHAL_ITLB_SET0_E7_CA_RESET 0x02 + + +/*** Data TLB: ***/ + +#define XCHAL_DTLB_WAY_BITS 0 /* number of bits holding the ways */ +#define XCHAL_DTLB_WAYS 1 /* number of ways (n-way set-associative TLB) */ +#define XCHAL_DTLB_ARF_WAYS 0 /* number of auto-refill ways */ +#define XCHAL_DTLB_SETS 1 /* number of sets (groups of ways with identical settings) */ + +/* Way set to which each way belongs: */ +#define XCHAL_DTLB_WAY0_SET 0 + +/* Ways sets that are used by hardware auto-refill (ARF): */ +#define XCHAL_DTLB_ARF_SETS 0 /* number of auto-refill sets */ + +/* Way sets that are "min-wired" (see terminology comment above): */ +#define XCHAL_DTLB_MINWIRED_SETS 0 /* number of "min-wired" sets */ + + +/* DTLB way set 0 (group of ways 0 thru 0): */ +#define XCHAL_DTLB_SET0_WAY 0 /* index of first way in this way set */ +#define XCHAL_DTLB_SET0_WAYS 1 /* number of (contiguous) ways in this way set */ +#define XCHAL_DTLB_SET0_ENTRIES_LOG2 3 /* log2(number of entries in this way) */ +#define XCHAL_DTLB_SET0_ENTRIES 8 /* number of entries in this way (always a power of 2) */ +#define XCHAL_DTLB_SET0_ARF 0 /* 1=autorefill by h/w, 0=non-autorefill (wired/constant/static) */ +#define XCHAL_DTLB_SET0_PAGESIZES 1 /* number of supported page sizes in this way */ +#define XCHAL_DTLB_SET0_PAGESZ_BITS 0 /* number of bits to encode the page size */ +#define XCHAL_DTLB_SET0_PAGESZ_LOG2_MIN 29 /* log2(minimum supported page size) */ +#define XCHAL_DTLB_SET0_PAGESZ_LOG2_MAX 29 /* log2(maximum supported page size) */ +#define XCHAL_DTLB_SET0_PAGESZ_LOG2_LIST 29 /* list of log2(page size)s, separated by XCHAL_SEP; + 2^PAGESZ_BITS entries in list, unsupported entries are zero */ +#define XCHAL_DTLB_SET0_ASID_CONSTMASK 0 /* constant ASID bits; 0 if all writable */ +#define XCHAL_DTLB_SET0_VPN_CONSTMASK 0x00000000 /* constant VPN bits, not including entry index bits; 0 if all writable */ +#define XCHAL_DTLB_SET0_PPN_CONSTMASK 0xE0000000 /* constant PPN bits, including entry index bits; 0 if all writable */ +#define XCHAL_DTLB_SET0_CA_CONSTMASK 0 /* constant CA bits; 0 if all writable */ +#define XCHAL_DTLB_SET0_ASID_RESET 0 /* 1 if ASID reset values defined (and all writable); 0 otherwise */ +#define XCHAL_DTLB_SET0_VPN_RESET 0 /* 1 if VPN reset values defined (and all writable); 0 otherwise */ +#define XCHAL_DTLB_SET0_PPN_RESET 0 /* 1 if PPN reset values defined (and all writable); 0 otherwise */ +#define XCHAL_DTLB_SET0_CA_RESET 1 /* 1 if CA reset values defined (and all writable); 0 otherwise */ +/* Constant VPN values for each entry of DTLB way set 0 (because VPN_CONSTMASK is non-zero): */ +#define XCHAL_DTLB_SET0_E0_VPN_CONST 0x00000000 +#define XCHAL_DTLB_SET0_E1_VPN_CONST 0x20000000 +#define XCHAL_DTLB_SET0_E2_VPN_CONST 0x40000000 +#define XCHAL_DTLB_SET0_E3_VPN_CONST 0x60000000 +#define XCHAL_DTLB_SET0_E4_VPN_CONST 0x80000000 +#define XCHAL_DTLB_SET0_E5_VPN_CONST 0xA0000000 +#define XCHAL_DTLB_SET0_E6_VPN_CONST 0xC0000000 +#define XCHAL_DTLB_SET0_E7_VPN_CONST 0xE0000000 +/* Constant PPN values for each entry of DTLB way set 0 (because PPN_CONSTMASK is non-zero): */ +#define XCHAL_DTLB_SET0_E0_PPN_CONST 0x00000000 +#define XCHAL_DTLB_SET0_E1_PPN_CONST 0x20000000 +#define XCHAL_DTLB_SET0_E2_PPN_CONST 0x40000000 +#define XCHAL_DTLB_SET0_E3_PPN_CONST 0x60000000 +#define XCHAL_DTLB_SET0_E4_PPN_CONST 0x80000000 +#define XCHAL_DTLB_SET0_E5_PPN_CONST 0xA0000000 +#define XCHAL_DTLB_SET0_E6_PPN_CONST 0xC0000000 +#define XCHAL_DTLB_SET0_E7_PPN_CONST 0xE0000000 +/* Reset CA values for each entry of DTLB way set 0 (because SET0_CA_RESET is non-zero): */ +#define XCHAL_DTLB_SET0_E0_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E1_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E2_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E3_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E4_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E5_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E6_CA_RESET 0x02 +#define XCHAL_DTLB_SET0_E7_CA_RESET 0x02 + + + + +#endif /*XTENSA_CONFIG_CORE_MATMAP_H*/ + diff --git a/components/esp32/include/xtensa/config/core.h b/components/esp32/include/xtensa/config/core.h new file mode 100644 index 000000000..98f1b1961 --- /dev/null +++ b/components/esp32/include/xtensa/config/core.h @@ -0,0 +1,1405 @@ +/* + * xtensa/config/core.h -- HAL definitions dependent on CORE configuration + * + * This header file is sometimes referred to as the "compile-time HAL" or CHAL. + * It pulls definitions tailored for a specific Xtensa processor configuration. + * + * Sources for binaries meant to be configuration-independent generally avoid + * including this file (they may use the configuration-specific HAL library). + * It is normal for the HAL library source itself to include this file. + */ + +/* + * Copyright (c) 2005-2014 Cadence Design Systems, Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + + +#ifndef XTENSA_CONFIG_CORE_H +#define XTENSA_CONFIG_CORE_H + +/* CONFIGURATION INDEPENDENT DEFINITIONS: */ +#ifdef __XTENSA__ +#include +#include +#else +#include "../hal.h" +#include "../xtensa-versions.h" +#endif + +/* CONFIGURATION SPECIFIC DEFINITIONS: */ +#ifdef __XTENSA__ +#include +#include +#include +#else +#include "core-isa.h" +#include "core-matmap.h" +#include "tie.h" +#endif + +#if defined (_ASMLANGUAGE) || defined (__ASSEMBLER__) +#ifdef __XTENSA__ +#include +#else +#include "tie-asm.h" +#endif +#endif /*_ASMLANGUAGE or __ASSEMBLER__*/ + + +/*---------------------------------------------------------------------- + GENERAL + ----------------------------------------------------------------------*/ + +/* + * Separators for macros that expand into arrays. + * These can be predefined by files that #include this one, + * when different separators are required. + */ +/* Element separator for macros that expand into 1-dimensional arrays: */ +#ifndef XCHAL_SEP +#define XCHAL_SEP , +#endif +/* Array separator for macros that expand into 2-dimensional arrays: */ +#ifndef XCHAL_SEP2 +#define XCHAL_SEP2 },{ +#endif + + + +/*---------------------------------------------------------------------- + ISA + ----------------------------------------------------------------------*/ + +#if XCHAL_HAVE_BE +# define XCHAL_HAVE_LE 0 +# define XCHAL_MEMORY_ORDER XTHAL_BIGENDIAN +#else +# define XCHAL_HAVE_LE 1 +# define XCHAL_MEMORY_ORDER XTHAL_LITTLEENDIAN +#endif + + + +/*---------------------------------------------------------------------- + INTERRUPTS + ----------------------------------------------------------------------*/ + +/* Indexing macros: */ +#define _XCHAL_INTLEVEL_MASK(n) XCHAL_INTLEVEL ## n ## _MASK +#define XCHAL_INTLEVEL_MASK(n) _XCHAL_INTLEVEL_MASK(n) /* n = 0 .. 15 */ +#define _XCHAL_INTLEVEL_ANDBELOWMASK(n) XCHAL_INTLEVEL ## n ## _ANDBELOW_MASK +#define XCHAL_INTLEVEL_ANDBELOW_MASK(n) _XCHAL_INTLEVEL_ANDBELOWMASK(n) /* n = 0 .. 15 */ +#define _XCHAL_INTLEVEL_NUM(n) XCHAL_INTLEVEL ## n ## _NUM +#define XCHAL_INTLEVEL_NUM(n) _XCHAL_INTLEVEL_NUM(n) /* n = 0 .. 15 */ +#define _XCHAL_INT_LEVEL(n) XCHAL_INT ## n ## _LEVEL +#define XCHAL_INT_LEVEL(n) _XCHAL_INT_LEVEL(n) /* n = 0 .. 31 */ +#define _XCHAL_INT_TYPE(n) XCHAL_INT ## n ## _TYPE +#define XCHAL_INT_TYPE(n) _XCHAL_INT_TYPE(n) /* n = 0 .. 31 */ +#define _XCHAL_TIMER_INTERRUPT(n) XCHAL_TIMER ## n ## _INTERRUPT +#define XCHAL_TIMER_INTERRUPT(n) _XCHAL_TIMER_INTERRUPT(n) /* n = 0 .. 3 */ + + +#define XCHAL_HAVE_HIGHLEVEL_INTERRUPTS XCHAL_HAVE_HIGHPRI_INTERRUPTS +#define XCHAL_NUM_LOWPRI_LEVELS 1 /* number of low-priority interrupt levels (always 1) */ +#define XCHAL_FIRST_HIGHPRI_LEVEL (XCHAL_NUM_LOWPRI_LEVELS+1) /* level of first high-priority interrupt (always 2) */ +/* Note: 1 <= LOWPRI_LEVELS <= EXCM_LEVEL < DEBUGLEVEL <= NUM_INTLEVELS < NMILEVEL <= 15 */ + +/* These values are constant for existing Xtensa processor implementations: */ +#define XCHAL_INTLEVEL0_MASK 0x00000000 +#define XCHAL_INTLEVEL8_MASK 0x00000000 +#define XCHAL_INTLEVEL9_MASK 0x00000000 +#define XCHAL_INTLEVEL10_MASK 0x00000000 +#define XCHAL_INTLEVEL11_MASK 0x00000000 +#define XCHAL_INTLEVEL12_MASK 0x00000000 +#define XCHAL_INTLEVEL13_MASK 0x00000000 +#define XCHAL_INTLEVEL14_MASK 0x00000000 +#define XCHAL_INTLEVEL15_MASK 0x00000000 + +/* Array of masks of interrupts at each interrupt level: */ +#define XCHAL_INTLEVEL_MASKS XCHAL_INTLEVEL0_MASK \ + XCHAL_SEP XCHAL_INTLEVEL1_MASK \ + XCHAL_SEP XCHAL_INTLEVEL2_MASK \ + XCHAL_SEP XCHAL_INTLEVEL3_MASK \ + XCHAL_SEP XCHAL_INTLEVEL4_MASK \ + XCHAL_SEP XCHAL_INTLEVEL5_MASK \ + XCHAL_SEP XCHAL_INTLEVEL6_MASK \ + XCHAL_SEP XCHAL_INTLEVEL7_MASK \ + XCHAL_SEP XCHAL_INTLEVEL8_MASK \ + XCHAL_SEP XCHAL_INTLEVEL9_MASK \ + XCHAL_SEP XCHAL_INTLEVEL10_MASK \ + XCHAL_SEP XCHAL_INTLEVEL11_MASK \ + XCHAL_SEP XCHAL_INTLEVEL12_MASK \ + XCHAL_SEP XCHAL_INTLEVEL13_MASK \ + XCHAL_SEP XCHAL_INTLEVEL14_MASK \ + XCHAL_SEP XCHAL_INTLEVEL15_MASK + +/* These values are constant for existing Xtensa processor implementations: */ +#define XCHAL_INTLEVEL0_ANDBELOW_MASK 0x00000000 +#define XCHAL_INTLEVEL8_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL9_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL10_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL11_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL12_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL13_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL14_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK +#define XCHAL_INTLEVEL15_ANDBELOW_MASK XCHAL_INTLEVEL7_ANDBELOW_MASK + +/* Mask of all low-priority interrupts: */ +#define XCHAL_LOWPRI_MASK XCHAL_INTLEVEL1_ANDBELOW_MASK + +/* Mask of all interrupts masked by PS.EXCM (or CEXCM): */ +#define XCHAL_EXCM_MASK XCHAL_INTLEVEL_ANDBELOW_MASK(XCHAL_EXCM_LEVEL) + +/* Array of masks of interrupts at each range 1..n of interrupt levels: */ +#define XCHAL_INTLEVEL_ANDBELOW_MASKS XCHAL_INTLEVEL0_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL1_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL2_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL3_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL4_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL5_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL6_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL7_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL8_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL9_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL10_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL11_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL12_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL13_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL14_ANDBELOW_MASK \ + XCHAL_SEP XCHAL_INTLEVEL15_ANDBELOW_MASK + +#if 0 /*XCHAL_HAVE_NMI*/ +/* NMI "interrupt level" (for use with EXCSAVE_n, EPS_n, EPC_n, RFI n): */ +# define XCHAL_NMILEVEL (XCHAL_NUM_INTLEVELS+1) +#endif + +/* Array of levels of each possible interrupt: */ +#define XCHAL_INT_LEVELS XCHAL_INT0_LEVEL \ + XCHAL_SEP XCHAL_INT1_LEVEL \ + XCHAL_SEP XCHAL_INT2_LEVEL \ + XCHAL_SEP XCHAL_INT3_LEVEL \ + XCHAL_SEP XCHAL_INT4_LEVEL \ + XCHAL_SEP XCHAL_INT5_LEVEL \ + XCHAL_SEP XCHAL_INT6_LEVEL \ + XCHAL_SEP XCHAL_INT7_LEVEL \ + XCHAL_SEP XCHAL_INT8_LEVEL \ + XCHAL_SEP XCHAL_INT9_LEVEL \ + XCHAL_SEP XCHAL_INT10_LEVEL \ + XCHAL_SEP XCHAL_INT11_LEVEL \ + XCHAL_SEP XCHAL_INT12_LEVEL \ + XCHAL_SEP XCHAL_INT13_LEVEL \ + XCHAL_SEP XCHAL_INT14_LEVEL \ + XCHAL_SEP XCHAL_INT15_LEVEL \ + XCHAL_SEP XCHAL_INT16_LEVEL \ + XCHAL_SEP XCHAL_INT17_LEVEL \ + XCHAL_SEP XCHAL_INT18_LEVEL \ + XCHAL_SEP XCHAL_INT19_LEVEL \ + XCHAL_SEP XCHAL_INT20_LEVEL \ + XCHAL_SEP XCHAL_INT21_LEVEL \ + XCHAL_SEP XCHAL_INT22_LEVEL \ + XCHAL_SEP XCHAL_INT23_LEVEL \ + XCHAL_SEP XCHAL_INT24_LEVEL \ + XCHAL_SEP XCHAL_INT25_LEVEL \ + XCHAL_SEP XCHAL_INT26_LEVEL \ + XCHAL_SEP XCHAL_INT27_LEVEL \ + XCHAL_SEP XCHAL_INT28_LEVEL \ + XCHAL_SEP XCHAL_INT29_LEVEL \ + XCHAL_SEP XCHAL_INT30_LEVEL \ + XCHAL_SEP XCHAL_INT31_LEVEL + +/* Array of types of each possible interrupt: */ +#define XCHAL_INT_TYPES XCHAL_INT0_TYPE \ + XCHAL_SEP XCHAL_INT1_TYPE \ + XCHAL_SEP XCHAL_INT2_TYPE \ + XCHAL_SEP XCHAL_INT3_TYPE \ + XCHAL_SEP XCHAL_INT4_TYPE \ + XCHAL_SEP XCHAL_INT5_TYPE \ + XCHAL_SEP XCHAL_INT6_TYPE \ + XCHAL_SEP XCHAL_INT7_TYPE \ + XCHAL_SEP XCHAL_INT8_TYPE \ + XCHAL_SEP XCHAL_INT9_TYPE \ + XCHAL_SEP XCHAL_INT10_TYPE \ + XCHAL_SEP XCHAL_INT11_TYPE \ + XCHAL_SEP XCHAL_INT12_TYPE \ + XCHAL_SEP XCHAL_INT13_TYPE \ + XCHAL_SEP XCHAL_INT14_TYPE \ + XCHAL_SEP XCHAL_INT15_TYPE \ + XCHAL_SEP XCHAL_INT16_TYPE \ + XCHAL_SEP XCHAL_INT17_TYPE \ + XCHAL_SEP XCHAL_INT18_TYPE \ + XCHAL_SEP XCHAL_INT19_TYPE \ + XCHAL_SEP XCHAL_INT20_TYPE \ + XCHAL_SEP XCHAL_INT21_TYPE \ + XCHAL_SEP XCHAL_INT22_TYPE \ + XCHAL_SEP XCHAL_INT23_TYPE \ + XCHAL_SEP XCHAL_INT24_TYPE \ + XCHAL_SEP XCHAL_INT25_TYPE \ + XCHAL_SEP XCHAL_INT26_TYPE \ + XCHAL_SEP XCHAL_INT27_TYPE \ + XCHAL_SEP XCHAL_INT28_TYPE \ + XCHAL_SEP XCHAL_INT29_TYPE \ + XCHAL_SEP XCHAL_INT30_TYPE \ + XCHAL_SEP XCHAL_INT31_TYPE + +/* Array of masks of interrupts for each type of interrupt: */ +#define XCHAL_INTTYPE_MASKS XCHAL_INTTYPE_MASK_UNCONFIGURED \ + XCHAL_SEP XCHAL_INTTYPE_MASK_SOFTWARE \ + XCHAL_SEP XCHAL_INTTYPE_MASK_EXTERN_EDGE \ + XCHAL_SEP XCHAL_INTTYPE_MASK_EXTERN_LEVEL \ + XCHAL_SEP XCHAL_INTTYPE_MASK_TIMER \ + XCHAL_SEP XCHAL_INTTYPE_MASK_NMI \ + XCHAL_SEP XCHAL_INTTYPE_MASK_WRITE_ERROR + +/* Interrupts that can be cleared using the INTCLEAR special register: */ +#define XCHAL_INTCLEARABLE_MASK (XCHAL_INTTYPE_MASK_SOFTWARE+XCHAL_INTTYPE_MASK_EXTERN_EDGE+XCHAL_INTTYPE_MASK_WRITE_ERROR) +/* Interrupts that can be triggered using the INTSET special register: */ +#define XCHAL_INTSETTABLE_MASK XCHAL_INTTYPE_MASK_SOFTWARE + +/* Array of interrupts assigned to each timer (CCOMPARE0 to CCOMPARE3): */ +#define XCHAL_TIMER_INTERRUPTS XCHAL_TIMER0_INTERRUPT \ + XCHAL_SEP XCHAL_TIMER1_INTERRUPT \ + XCHAL_SEP XCHAL_TIMER2_INTERRUPT \ + XCHAL_SEP XCHAL_TIMER3_INTERRUPT + + + +/* For backward compatibility and for the array macros, define macros for + * each unconfigured interrupt number (unfortunately, the value of + * XTHAL_INTTYPE_UNCONFIGURED is not zero): */ +#if XCHAL_NUM_INTERRUPTS == 0 +# define XCHAL_INT0_LEVEL 0 +# define XCHAL_INT0_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 1 +# define XCHAL_INT1_LEVEL 0 +# define XCHAL_INT1_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 2 +# define XCHAL_INT2_LEVEL 0 +# define XCHAL_INT2_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 3 +# define XCHAL_INT3_LEVEL 0 +# define XCHAL_INT3_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 4 +# define XCHAL_INT4_LEVEL 0 +# define XCHAL_INT4_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 5 +# define XCHAL_INT5_LEVEL 0 +# define XCHAL_INT5_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 6 +# define XCHAL_INT6_LEVEL 0 +# define XCHAL_INT6_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 7 +# define XCHAL_INT7_LEVEL 0 +# define XCHAL_INT7_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 8 +# define XCHAL_INT8_LEVEL 0 +# define XCHAL_INT8_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 9 +# define XCHAL_INT9_LEVEL 0 +# define XCHAL_INT9_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 10 +# define XCHAL_INT10_LEVEL 0 +# define XCHAL_INT10_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 11 +# define XCHAL_INT11_LEVEL 0 +# define XCHAL_INT11_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 12 +# define XCHAL_INT12_LEVEL 0 +# define XCHAL_INT12_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 13 +# define XCHAL_INT13_LEVEL 0 +# define XCHAL_INT13_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 14 +# define XCHAL_INT14_LEVEL 0 +# define XCHAL_INT14_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 15 +# define XCHAL_INT15_LEVEL 0 +# define XCHAL_INT15_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 16 +# define XCHAL_INT16_LEVEL 0 +# define XCHAL_INT16_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 17 +# define XCHAL_INT17_LEVEL 0 +# define XCHAL_INT17_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 18 +# define XCHAL_INT18_LEVEL 0 +# define XCHAL_INT18_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 19 +# define XCHAL_INT19_LEVEL 0 +# define XCHAL_INT19_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 20 +# define XCHAL_INT20_LEVEL 0 +# define XCHAL_INT20_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 21 +# define XCHAL_INT21_LEVEL 0 +# define XCHAL_INT21_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 22 +# define XCHAL_INT22_LEVEL 0 +# define XCHAL_INT22_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 23 +# define XCHAL_INT23_LEVEL 0 +# define XCHAL_INT23_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 24 +# define XCHAL_INT24_LEVEL 0 +# define XCHAL_INT24_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 25 +# define XCHAL_INT25_LEVEL 0 +# define XCHAL_INT25_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 26 +# define XCHAL_INT26_LEVEL 0 +# define XCHAL_INT26_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 27 +# define XCHAL_INT27_LEVEL 0 +# define XCHAL_INT27_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 28 +# define XCHAL_INT28_LEVEL 0 +# define XCHAL_INT28_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 29 +# define XCHAL_INT29_LEVEL 0 +# define XCHAL_INT29_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 30 +# define XCHAL_INT30_LEVEL 0 +# define XCHAL_INT30_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif +#if XCHAL_NUM_INTERRUPTS <= 31 +# define XCHAL_INT31_LEVEL 0 +# define XCHAL_INT31_TYPE XTHAL_INTTYPE_UNCONFIGURED +#endif + + +/* + * Masks and levels corresponding to each *external* interrupt. + */ + +#define XCHAL_EXTINT0_MASK (1 << XCHAL_EXTINT0_NUM) +#define XCHAL_EXTINT0_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT0_NUM) +#define XCHAL_EXTINT1_MASK (1 << XCHAL_EXTINT1_NUM) +#define XCHAL_EXTINT1_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT1_NUM) +#define XCHAL_EXTINT2_MASK (1 << XCHAL_EXTINT2_NUM) +#define XCHAL_EXTINT2_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT2_NUM) +#define XCHAL_EXTINT3_MASK (1 << XCHAL_EXTINT3_NUM) +#define XCHAL_EXTINT3_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT3_NUM) +#define XCHAL_EXTINT4_MASK (1 << XCHAL_EXTINT4_NUM) +#define XCHAL_EXTINT4_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT4_NUM) +#define XCHAL_EXTINT5_MASK (1 << XCHAL_EXTINT5_NUM) +#define XCHAL_EXTINT5_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT5_NUM) +#define XCHAL_EXTINT6_MASK (1 << XCHAL_EXTINT6_NUM) +#define XCHAL_EXTINT6_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT6_NUM) +#define XCHAL_EXTINT7_MASK (1 << XCHAL_EXTINT7_NUM) +#define XCHAL_EXTINT7_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT7_NUM) +#define XCHAL_EXTINT8_MASK (1 << XCHAL_EXTINT8_NUM) +#define XCHAL_EXTINT8_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT8_NUM) +#define XCHAL_EXTINT9_MASK (1 << XCHAL_EXTINT9_NUM) +#define XCHAL_EXTINT9_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT9_NUM) +#define XCHAL_EXTINT10_MASK (1 << XCHAL_EXTINT10_NUM) +#define XCHAL_EXTINT10_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT10_NUM) +#define XCHAL_EXTINT11_MASK (1 << XCHAL_EXTINT11_NUM) +#define XCHAL_EXTINT11_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT11_NUM) +#define XCHAL_EXTINT12_MASK (1 << XCHAL_EXTINT12_NUM) +#define XCHAL_EXTINT12_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT12_NUM) +#define XCHAL_EXTINT13_MASK (1 << XCHAL_EXTINT13_NUM) +#define XCHAL_EXTINT13_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT13_NUM) +#define XCHAL_EXTINT14_MASK (1 << XCHAL_EXTINT14_NUM) +#define XCHAL_EXTINT14_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT14_NUM) +#define XCHAL_EXTINT15_MASK (1 << XCHAL_EXTINT15_NUM) +#define XCHAL_EXTINT15_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT15_NUM) +#define XCHAL_EXTINT16_MASK (1 << XCHAL_EXTINT16_NUM) +#define XCHAL_EXTINT16_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT16_NUM) +#define XCHAL_EXTINT17_MASK (1 << XCHAL_EXTINT17_NUM) +#define XCHAL_EXTINT17_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT17_NUM) +#define XCHAL_EXTINT18_MASK (1 << XCHAL_EXTINT18_NUM) +#define XCHAL_EXTINT18_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT18_NUM) +#define XCHAL_EXTINT19_MASK (1 << XCHAL_EXTINT19_NUM) +#define XCHAL_EXTINT19_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT19_NUM) +#define XCHAL_EXTINT20_MASK (1 << XCHAL_EXTINT20_NUM) +#define XCHAL_EXTINT20_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT20_NUM) +#define XCHAL_EXTINT21_MASK (1 << XCHAL_EXTINT21_NUM) +#define XCHAL_EXTINT21_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT21_NUM) +#define XCHAL_EXTINT22_MASK (1 << XCHAL_EXTINT22_NUM) +#define XCHAL_EXTINT22_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT22_NUM) +#define XCHAL_EXTINT23_MASK (1 << XCHAL_EXTINT23_NUM) +#define XCHAL_EXTINT23_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT23_NUM) +#define XCHAL_EXTINT24_MASK (1 << XCHAL_EXTINT24_NUM) +#define XCHAL_EXTINT24_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT24_NUM) +#define XCHAL_EXTINT25_MASK (1 << XCHAL_EXTINT25_NUM) +#define XCHAL_EXTINT25_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT25_NUM) +#define XCHAL_EXTINT26_MASK (1 << XCHAL_EXTINT26_NUM) +#define XCHAL_EXTINT26_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT26_NUM) +#define XCHAL_EXTINT27_MASK (1 << XCHAL_EXTINT27_NUM) +#define XCHAL_EXTINT27_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT27_NUM) +#define XCHAL_EXTINT28_MASK (1 << XCHAL_EXTINT28_NUM) +#define XCHAL_EXTINT28_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT28_NUM) +#define XCHAL_EXTINT29_MASK (1 << XCHAL_EXTINT29_NUM) +#define XCHAL_EXTINT29_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT29_NUM) +#define XCHAL_EXTINT30_MASK (1 << XCHAL_EXTINT30_NUM) +#define XCHAL_EXTINT30_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT30_NUM) +#define XCHAL_EXTINT31_MASK (1 << XCHAL_EXTINT31_NUM) +#define XCHAL_EXTINT31_LEVEL XCHAL_INT_LEVEL(XCHAL_EXTINT31_NUM) + + +/*---------------------------------------------------------------------- + EXCEPTIONS and VECTORS + ----------------------------------------------------------------------*/ + +/* For backward compatibility ONLY -- DO NOT USE (will be removed in future release): */ +#define XCHAL_HAVE_OLD_EXC_ARCH XCHAL_HAVE_XEA1 /* (DEPRECATED) 1 if old exception architecture (XEA1), 0 otherwise (eg. XEA2) */ +#define XCHAL_HAVE_EXCM XCHAL_HAVE_XEA2 /* (DEPRECATED) 1 if PS.EXCM bit exists (currently equals XCHAL_HAVE_TLBS) */ +#ifdef XCHAL_USER_VECTOR_VADDR +#define XCHAL_PROGRAMEXC_VECTOR_VADDR XCHAL_USER_VECTOR_VADDR +#define XCHAL_USEREXC_VECTOR_VADDR XCHAL_USER_VECTOR_VADDR +#endif +#ifdef XCHAL_USER_VECTOR_PADDR +# define XCHAL_PROGRAMEXC_VECTOR_PADDR XCHAL_USER_VECTOR_PADDR +# define XCHAL_USEREXC_VECTOR_PADDR XCHAL_USER_VECTOR_PADDR +#endif +#ifdef XCHAL_KERNEL_VECTOR_VADDR +# define XCHAL_STACKEDEXC_VECTOR_VADDR XCHAL_KERNEL_VECTOR_VADDR +# define XCHAL_KERNELEXC_VECTOR_VADDR XCHAL_KERNEL_VECTOR_VADDR +#endif +#ifdef XCHAL_KERNEL_VECTOR_PADDR +# define XCHAL_STACKEDEXC_VECTOR_PADDR XCHAL_KERNEL_VECTOR_PADDR +# define XCHAL_KERNELEXC_VECTOR_PADDR XCHAL_KERNEL_VECTOR_PADDR +#endif + +#if 0 +#if XCHAL_HAVE_DEBUG +# define XCHAL_DEBUG_VECTOR_VADDR XCHAL_INTLEVEL_VECTOR_VADDR(XCHAL_DEBUGLEVEL) +/* This one should only get defined if the corresponding intlevel paddr macro exists: */ +# define XCHAL_DEBUG_VECTOR_PADDR XCHAL_INTLEVEL_VECTOR_PADDR(XCHAL_DEBUGLEVEL) +#endif +#endif + +/* Indexing macros: */ +#define _XCHAL_INTLEVEL_VECTOR_VADDR(n) XCHAL_INTLEVEL ## n ## _VECTOR_VADDR +#define XCHAL_INTLEVEL_VECTOR_VADDR(n) _XCHAL_INTLEVEL_VECTOR_VADDR(n) /* n = 0 .. 15 */ + +/* + * General Exception Causes + * (values of EXCCAUSE special register set by general exceptions, + * which vector to the user, kernel, or double-exception vectors). + * + * DEPRECATED. Please use the equivalent EXCCAUSE_xxx macros + * defined in . (Note that these have slightly + * different names, they don't just have the XCHAL_ prefix removed.) + */ +#define XCHAL_EXCCAUSE_ILLEGAL_INSTRUCTION 0 /* Illegal Instruction */ +#define XCHAL_EXCCAUSE_SYSTEM_CALL 1 /* System Call */ +#define XCHAL_EXCCAUSE_INSTRUCTION_FETCH_ERROR 2 /* Instruction Fetch Error */ +#define XCHAL_EXCCAUSE_LOAD_STORE_ERROR 3 /* Load Store Error */ +#define XCHAL_EXCCAUSE_LEVEL1_INTERRUPT 4 /* Level 1 Interrupt */ +#define XCHAL_EXCCAUSE_ALLOCA 5 /* Stack Extension Assist */ +#define XCHAL_EXCCAUSE_INTEGER_DIVIDE_BY_ZERO 6 /* Integer Divide by Zero */ +#define XCHAL_EXCCAUSE_SPECULATION 7 /* Speculation */ +#define XCHAL_EXCCAUSE_PRIVILEGED 8 /* Privileged Instruction */ +#define XCHAL_EXCCAUSE_UNALIGNED 9 /* Unaligned Load Store */ +/*10..15 reserved*/ +#define XCHAL_EXCCAUSE_ITLB_MISS 16 /* ITlb Miss Exception */ +#define XCHAL_EXCCAUSE_ITLB_MULTIHIT 17 /* ITlb Mutltihit Exception */ +#define XCHAL_EXCCAUSE_ITLB_PRIVILEGE 18 /* ITlb Privilege Exception */ +#define XCHAL_EXCCAUSE_ITLB_SIZE_RESTRICTION 19 /* ITlb Size Restriction Exception */ +#define XCHAL_EXCCAUSE_FETCH_CACHE_ATTRIBUTE 20 /* Fetch Cache Attribute Exception */ +/*21..23 reserved*/ +#define XCHAL_EXCCAUSE_DTLB_MISS 24 /* DTlb Miss Exception */ +#define XCHAL_EXCCAUSE_DTLB_MULTIHIT 25 /* DTlb Multihit Exception */ +#define XCHAL_EXCCAUSE_DTLB_PRIVILEGE 26 /* DTlb Privilege Exception */ +#define XCHAL_EXCCAUSE_DTLB_SIZE_RESTRICTION 27 /* DTlb Size Restriction Exception */ +#define XCHAL_EXCCAUSE_LOAD_CACHE_ATTRIBUTE 28 /* Load Cache Attribute Exception */ +#define XCHAL_EXCCAUSE_STORE_CACHE_ATTRIBUTE 29 /* Store Cache Attribute Exception */ +/*30..31 reserved*/ +#define XCHAL_EXCCAUSE_COPROCESSOR0_DISABLED 32 /* Coprocessor 0 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR1_DISABLED 33 /* Coprocessor 1 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR2_DISABLED 34 /* Coprocessor 2 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR3_DISABLED 35 /* Coprocessor 3 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR4_DISABLED 36 /* Coprocessor 4 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR5_DISABLED 37 /* Coprocessor 5 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR6_DISABLED 38 /* Coprocessor 6 disabled */ +#define XCHAL_EXCCAUSE_COPROCESSOR7_DISABLED 39 /* Coprocessor 7 disabled */ +/*40..63 reserved*/ + + +/* + * Miscellaneous special register fields. + * + * For each special register, and each field within each register: + * XCHAL__VALIDMASK is the set of bits defined in the register. + * XCHAL___BITS is the number of bits in the field. + * XCHAL___NUM is 2^bits, the number of possible values + * of the field. + * XCHAL___SHIFT is the position of the field within + * the register, starting from the least significant bit. + * + * DEPRECATED. Please use the equivalent macros defined in + * . (Note that these have different names.) + */ + +/* DBREAKC (special register number 160): */ +#define XCHAL_DBREAKC_VALIDMASK 0xC000003F +#define XCHAL_DBREAKC_MASK_BITS 6 +#define XCHAL_DBREAKC_MASK_NUM 64 +#define XCHAL_DBREAKC_MASK_SHIFT 0 +#define XCHAL_DBREAKC_MASK_MASK 0x0000003F +#define XCHAL_DBREAKC_LOADBREAK_BITS 1 +#define XCHAL_DBREAKC_LOADBREAK_NUM 2 +#define XCHAL_DBREAKC_LOADBREAK_SHIFT 30 +#define XCHAL_DBREAKC_LOADBREAK_MASK 0x40000000 +#define XCHAL_DBREAKC_STOREBREAK_BITS 1 +#define XCHAL_DBREAKC_STOREBREAK_NUM 2 +#define XCHAL_DBREAKC_STOREBREAK_SHIFT 31 +#define XCHAL_DBREAKC_STOREBREAK_MASK 0x80000000 +/* PS (special register number 230): */ +#define XCHAL_PS_VALIDMASK 0x00070F3F +#define XCHAL_PS_INTLEVEL_BITS 4 +#define XCHAL_PS_INTLEVEL_NUM 16 +#define XCHAL_PS_INTLEVEL_SHIFT 0 +#define XCHAL_PS_INTLEVEL_MASK 0x0000000F +#define XCHAL_PS_EXCM_BITS 1 +#define XCHAL_PS_EXCM_NUM 2 +#define XCHAL_PS_EXCM_SHIFT 4 +#define XCHAL_PS_EXCM_MASK 0x00000010 +#define XCHAL_PS_UM_BITS 1 +#define XCHAL_PS_UM_NUM 2 +#define XCHAL_PS_UM_SHIFT 5 +#define XCHAL_PS_UM_MASK 0x00000020 +#define XCHAL_PS_RING_BITS 2 +#define XCHAL_PS_RING_NUM 4 +#define XCHAL_PS_RING_SHIFT 6 +#define XCHAL_PS_RING_MASK 0x000000C0 +#define XCHAL_PS_OWB_BITS 4 +#define XCHAL_PS_OWB_NUM 16 +#define XCHAL_PS_OWB_SHIFT 8 +#define XCHAL_PS_OWB_MASK 0x00000F00 +#define XCHAL_PS_CALLINC_BITS 2 +#define XCHAL_PS_CALLINC_NUM 4 +#define XCHAL_PS_CALLINC_SHIFT 16 +#define XCHAL_PS_CALLINC_MASK 0x00030000 +#define XCHAL_PS_WOE_BITS 1 +#define XCHAL_PS_WOE_NUM 2 +#define XCHAL_PS_WOE_SHIFT 18 +#define XCHAL_PS_WOE_MASK 0x00040000 +/* EXCCAUSE (special register number 232): */ +#define XCHAL_EXCCAUSE_VALIDMASK 0x0000003F +#define XCHAL_EXCCAUSE_BITS 6 +#define XCHAL_EXCCAUSE_NUM 64 +#define XCHAL_EXCCAUSE_SHIFT 0 +#define XCHAL_EXCCAUSE_MASK 0x0000003F +/* DEBUGCAUSE (special register number 233): */ +#define XCHAL_DEBUGCAUSE_VALIDMASK 0x0000003F +#define XCHAL_DEBUGCAUSE_ICOUNT_BITS 1 +#define XCHAL_DEBUGCAUSE_ICOUNT_NUM 2 +#define XCHAL_DEBUGCAUSE_ICOUNT_SHIFT 0 +#define XCHAL_DEBUGCAUSE_ICOUNT_MASK 0x00000001 +#define XCHAL_DEBUGCAUSE_IBREAK_BITS 1 +#define XCHAL_DEBUGCAUSE_IBREAK_NUM 2 +#define XCHAL_DEBUGCAUSE_IBREAK_SHIFT 1 +#define XCHAL_DEBUGCAUSE_IBREAK_MASK 0x00000002 +#define XCHAL_DEBUGCAUSE_DBREAK_BITS 1 +#define XCHAL_DEBUGCAUSE_DBREAK_NUM 2 +#define XCHAL_DEBUGCAUSE_DBREAK_SHIFT 2 +#define XCHAL_DEBUGCAUSE_DBREAK_MASK 0x00000004 +#define XCHAL_DEBUGCAUSE_BREAK_BITS 1 +#define XCHAL_DEBUGCAUSE_BREAK_NUM 2 +#define XCHAL_DEBUGCAUSE_BREAK_SHIFT 3 +#define XCHAL_DEBUGCAUSE_BREAK_MASK 0x00000008 +#define XCHAL_DEBUGCAUSE_BREAKN_BITS 1 +#define XCHAL_DEBUGCAUSE_BREAKN_NUM 2 +#define XCHAL_DEBUGCAUSE_BREAKN_SHIFT 4 +#define XCHAL_DEBUGCAUSE_BREAKN_MASK 0x00000010 +#define XCHAL_DEBUGCAUSE_DEBUGINT_BITS 1 +#define XCHAL_DEBUGCAUSE_DEBUGINT_NUM 2 +#define XCHAL_DEBUGCAUSE_DEBUGINT_SHIFT 5 +#define XCHAL_DEBUGCAUSE_DEBUGINT_MASK 0x00000020 + + + + +/*---------------------------------------------------------------------- + TIMERS + ----------------------------------------------------------------------*/ + +/*#define XCHAL_HAVE_TIMERS XCHAL_HAVE_CCOUNT*/ + + + +/*---------------------------------------------------------------------- + INTERNAL I/D RAM/ROMs and XLMI + ----------------------------------------------------------------------*/ + +#define XCHAL_NUM_IROM XCHAL_NUM_INSTROM /* (DEPRECATED) */ +#define XCHAL_NUM_IRAM XCHAL_NUM_INSTRAM /* (DEPRECATED) */ +#define XCHAL_NUM_DROM XCHAL_NUM_DATAROM /* (DEPRECATED) */ +#define XCHAL_NUM_DRAM XCHAL_NUM_DATARAM /* (DEPRECATED) */ + +#define XCHAL_IROM0_VADDR XCHAL_INSTROM0_VADDR /* (DEPRECATED) */ +#define XCHAL_IROM0_PADDR XCHAL_INSTROM0_PADDR /* (DEPRECATED) */ +#define XCHAL_IROM0_SIZE XCHAL_INSTROM0_SIZE /* (DEPRECATED) */ +#define XCHAL_IROM1_VADDR XCHAL_INSTROM1_VADDR /* (DEPRECATED) */ +#define XCHAL_IROM1_PADDR XCHAL_INSTROM1_PADDR /* (DEPRECATED) */ +#define XCHAL_IROM1_SIZE XCHAL_INSTROM1_SIZE /* (DEPRECATED) */ +#define XCHAL_IRAM0_VADDR XCHAL_INSTRAM0_VADDR /* (DEPRECATED) */ +#define XCHAL_IRAM0_PADDR XCHAL_INSTRAM0_PADDR /* (DEPRECATED) */ +#define XCHAL_IRAM0_SIZE XCHAL_INSTRAM0_SIZE /* (DEPRECATED) */ +#define XCHAL_IRAM1_VADDR XCHAL_INSTRAM1_VADDR /* (DEPRECATED) */ +#define XCHAL_IRAM1_PADDR XCHAL_INSTRAM1_PADDR /* (DEPRECATED) */ +#define XCHAL_IRAM1_SIZE XCHAL_INSTRAM1_SIZE /* (DEPRECATED) */ +#define XCHAL_DROM0_VADDR XCHAL_DATAROM0_VADDR /* (DEPRECATED) */ +#define XCHAL_DROM0_PADDR XCHAL_DATAROM0_PADDR /* (DEPRECATED) */ +#define XCHAL_DROM0_SIZE XCHAL_DATAROM0_SIZE /* (DEPRECATED) */ +#define XCHAL_DROM1_VADDR XCHAL_DATAROM1_VADDR /* (DEPRECATED) */ +#define XCHAL_DROM1_PADDR XCHAL_DATAROM1_PADDR /* (DEPRECATED) */ +#define XCHAL_DROM1_SIZE XCHAL_DATAROM1_SIZE /* (DEPRECATED) */ +#define XCHAL_DRAM0_VADDR XCHAL_DATARAM0_VADDR /* (DEPRECATED) */ +#define XCHAL_DRAM0_PADDR XCHAL_DATARAM0_PADDR /* (DEPRECATED) */ +#define XCHAL_DRAM0_SIZE XCHAL_DATARAM0_SIZE /* (DEPRECATED) */ +#define XCHAL_DRAM1_VADDR XCHAL_DATARAM1_VADDR /* (DEPRECATED) */ +#define XCHAL_DRAM1_PADDR XCHAL_DATARAM1_PADDR /* (DEPRECATED) */ +#define XCHAL_DRAM1_SIZE XCHAL_DATARAM1_SIZE /* (DEPRECATED) */ + + + +/*---------------------------------------------------------------------- + CACHE + ----------------------------------------------------------------------*/ + + +/* Default PREFCTL value to enable prefetch. */ +#if XCHAL_HW_MIN_VERSION < XTENSA_HWVERSION_RE_2012_0 +#define XCHAL_CACHE_PREFCTL_DEFAULT 0x00044 /* enabled, not aggressive */ +#elif XCHAL_HW_MIN_VERSION < XTENSA_HWVERSION_RF_2014_0 +#define XCHAL_CACHE_PREFCTL_DEFAULT 0x01044 /* + enable prefetch to L1 */ +#elif XCHAL_PREFETCH_ENTRIES >= 16 +#define XCHAL_CACHE_PREFCTL_DEFAULT 0x81044 /* 12 entries for block ops */ +#elif XCHAL_PREFETCH_ENTRIES >= 8 +#define XCHAL_CACHE_PREFCTL_DEFAULT 0x51044 /* 5 entries for block ops */ +#else +#define XCHAL_CACHE_PREFCTL_DEFAULT 0x01044 /* 0 entries for block ops */ +#endif + + +/* Max for both I-cache and D-cache (used for general alignment): */ +#if XCHAL_ICACHE_LINESIZE > XCHAL_DCACHE_LINESIZE +# define XCHAL_CACHE_LINEWIDTH_MAX XCHAL_ICACHE_LINEWIDTH +# define XCHAL_CACHE_LINESIZE_MAX XCHAL_ICACHE_LINESIZE +#else +# define XCHAL_CACHE_LINEWIDTH_MAX XCHAL_DCACHE_LINEWIDTH +# define XCHAL_CACHE_LINESIZE_MAX XCHAL_DCACHE_LINESIZE +#endif + +#define XCHAL_ICACHE_SETSIZE (1< XCHAL_DCACHE_SETWIDTH +# define XCHAL_CACHE_SETWIDTH_MAX XCHAL_ICACHE_SETWIDTH +# define XCHAL_CACHE_SETSIZE_MAX XCHAL_ICACHE_SETSIZE +#else +# define XCHAL_CACHE_SETWIDTH_MAX XCHAL_DCACHE_SETWIDTH +# define XCHAL_CACHE_SETSIZE_MAX XCHAL_DCACHE_SETSIZE +#endif + +/* Instruction cache tag bits: */ +#define XCHAL_ICACHE_TAG_V_SHIFT 0 +#define XCHAL_ICACHE_TAG_V 0x1 /* valid bit */ +#if XCHAL_ICACHE_WAYS > 1 +# define XCHAL_ICACHE_TAG_F_SHIFT 1 +# define XCHAL_ICACHE_TAG_F 0x2 /* fill (LRU) bit */ +#else +# define XCHAL_ICACHE_TAG_F_SHIFT 0 +# define XCHAL_ICACHE_TAG_F 0 /* no fill (LRU) bit */ +#endif +#if XCHAL_ICACHE_LINE_LOCKABLE +# define XCHAL_ICACHE_TAG_L_SHIFT (XCHAL_ICACHE_TAG_F_SHIFT+1) +# define XCHAL_ICACHE_TAG_L (1 << XCHAL_ICACHE_TAG_L_SHIFT) /* lock bit */ +#else +# define XCHAL_ICACHE_TAG_L_SHIFT XCHAL_ICACHE_TAG_F_SHIFT +# define XCHAL_ICACHE_TAG_L 0 /* no lock bit */ +#endif +/* Data cache tag bits: */ +#define XCHAL_DCACHE_TAG_V_SHIFT 0 +#define XCHAL_DCACHE_TAG_V 0x1 /* valid bit */ +#if XCHAL_DCACHE_WAYS > 1 +# define XCHAL_DCACHE_TAG_F_SHIFT 1 +# define XCHAL_DCACHE_TAG_F 0x2 /* fill (LRU) bit */ +#else +# define XCHAL_DCACHE_TAG_F_SHIFT 0 +# define XCHAL_DCACHE_TAG_F 0 /* no fill (LRU) bit */ +#endif +#if XCHAL_DCACHE_IS_WRITEBACK +# define XCHAL_DCACHE_TAG_D_SHIFT (XCHAL_DCACHE_TAG_F_SHIFT+1) +# define XCHAL_DCACHE_TAG_D (1 << XCHAL_DCACHE_TAG_D_SHIFT) /* dirty bit */ +#else +# define XCHAL_DCACHE_TAG_D_SHIFT XCHAL_DCACHE_TAG_F_SHIFT +# define XCHAL_DCACHE_TAG_D 0 /* no dirty bit */ +#endif +#if XCHAL_DCACHE_LINE_LOCKABLE +# define XCHAL_DCACHE_TAG_L_SHIFT (XCHAL_DCACHE_TAG_D_SHIFT+1) +# define XCHAL_DCACHE_TAG_L (1 << XCHAL_DCACHE_TAG_L_SHIFT) /* lock bit */ +#else +# define XCHAL_DCACHE_TAG_L_SHIFT XCHAL_DCACHE_TAG_D_SHIFT +# define XCHAL_DCACHE_TAG_L 0 /* no lock bit */ +#endif + +/* Whether MEMCTL register has anything useful */ +#define XCHAL_USE_MEMCTL (((XCHAL_LOOP_BUFFER_SIZE > 0) || \ + XCHAL_DCACHE_IS_COHERENT || \ + XCHAL_HAVE_ICACHE_DYN_WAYS || \ + XCHAL_HAVE_DCACHE_DYN_WAYS) && \ + (XCHAL_HW_MIN_VERSION >= XTENSA_HWVERSION_RE_2012_0)) + +/* Default MEMCTL values: */ +#if XCHAL_HAVE_ICACHE_DYN_WAYS || XCHAL_HAVE_DCACHE_DYN_WAYS +/* NOTE: constant defined this way to allow movi instead of l32r in reset code. */ +#define XCHAL_CACHE_MEMCTL_DEFAULT 0xFFFFFF00 /* Init all possible ways */ +#else +#define XCHAL_CACHE_MEMCTL_DEFAULT 0x00000000 /* Nothing to do */ +#endif + +#if XCHAL_DCACHE_IS_COHERENT +#define _MEMCTL_SNOOP_EN 0x02 /* Enable snoop */ +#else +#define _MEMCTL_SNOOP_EN 0x00 /* Don't enable snoop */ +#endif + +#if (XCHAL_LOOP_BUFFER_SIZE == 0) || XCHAL_ERRATUM_453 +#define _MEMCTL_L0IBUF_EN 0x00 /* No loop buffer or don't enable */ +#else +#define _MEMCTL_L0IBUF_EN 0x01 /* Enable loop buffer */ +#endif + +#define XCHAL_SNOOP_LB_MEMCTL_DEFAULT (_MEMCTL_SNOOP_EN | _MEMCTL_L0IBUF_EN) + + +/*---------------------------------------------------------------------- + MMU + ----------------------------------------------------------------------*/ + +/* See for more details. */ + +/* Has different semantic in open source headers (where it means HAVE_PTP_MMU), + so comment out starting with RB-2008.3 release; later, might get + get reintroduced as a synonym for XCHAL_HAVE_PTP_MMU instead: */ +/*#define XCHAL_HAVE_MMU XCHAL_HAVE_TLBS*/ /* (DEPRECATED; use XCHAL_HAVE_TLBS instead) */ + +/* Indexing macros: */ +#define _XCHAL_ITLB_SET(n,_what) XCHAL_ITLB_SET ## n ## _what +#define XCHAL_ITLB_SET(n,what) _XCHAL_ITLB_SET(n, _ ## what ) +#define _XCHAL_ITLB_SET_E(n,i,_what) XCHAL_ITLB_SET ## n ## _E ## i ## _what +#define XCHAL_ITLB_SET_E(n,i,what) _XCHAL_ITLB_SET_E(n,i, _ ## what ) +#define _XCHAL_DTLB_SET(n,_what) XCHAL_DTLB_SET ## n ## _what +#define XCHAL_DTLB_SET(n,what) _XCHAL_DTLB_SET(n, _ ## what ) +#define _XCHAL_DTLB_SET_E(n,i,_what) XCHAL_DTLB_SET ## n ## _E ## i ## _what +#define XCHAL_DTLB_SET_E(n,i,what) _XCHAL_DTLB_SET_E(n,i, _ ## what ) +/* + * Example use: XCHAL_ITLB_SET(XCHAL_ITLB_ARF_SET0,ENTRIES) + * to get the value of XCHAL_ITLB_SET_ENTRIES where is the first auto-refill set. + */ + +/* Number of entries per autorefill way: */ +#define XCHAL_ITLB_ARF_ENTRIES (1< 0 && XCHAL_DTLB_ARF_WAYS > 0 && XCHAL_MMU_RINGS >= 2 +# define XCHAL_HAVE_PTP_MMU 1 /* have full MMU (with page table [autorefill] and protection) */ +#else +# define XCHAL_HAVE_PTP_MMU 0 /* don't have full MMU */ +#endif +#endif + +/* + * For full MMUs, report kernel RAM segment and kernel I/O segment static page mappings: + */ +#if XCHAL_HAVE_PTP_MMU && !XCHAL_HAVE_SPANNING_WAY +#define XCHAL_KSEG_CACHED_VADDR 0xD0000000 /* virt.addr of kernel RAM cached static map */ +#define XCHAL_KSEG_CACHED_PADDR 0x00000000 /* phys.addr of kseg_cached */ +#define XCHAL_KSEG_CACHED_SIZE 0x08000000 /* size in bytes of kseg_cached (assumed power of 2!!!) */ +#define XCHAL_KSEG_BYPASS_VADDR 0xD8000000 /* virt.addr of kernel RAM bypass (uncached) static map */ +#define XCHAL_KSEG_BYPASS_PADDR 0x00000000 /* phys.addr of kseg_bypass */ +#define XCHAL_KSEG_BYPASS_SIZE 0x08000000 /* size in bytes of kseg_bypass (assumed power of 2!!!) */ + +#define XCHAL_KIO_CACHED_VADDR 0xE0000000 /* virt.addr of kernel I/O cached static map */ +#define XCHAL_KIO_CACHED_PADDR 0xF0000000 /* phys.addr of kio_cached */ +#define XCHAL_KIO_CACHED_SIZE 0x10000000 /* size in bytes of kio_cached (assumed power of 2!!!) */ +#define XCHAL_KIO_BYPASS_VADDR 0xF0000000 /* virt.addr of kernel I/O bypass (uncached) static map */ +#define XCHAL_KIO_BYPASS_PADDR 0xF0000000 /* phys.addr of kio_bypass */ +#define XCHAL_KIO_BYPASS_SIZE 0x10000000 /* size in bytes of kio_bypass (assumed power of 2!!!) */ + +#define XCHAL_SEG_MAPPABLE_VADDR 0x00000000 /* start of largest non-static-mapped virtual addr area */ +#define XCHAL_SEG_MAPPABLE_SIZE 0xD0000000 /* size in bytes of " */ +/* define XCHAL_SEG_MAPPABLE2_xxx if more areas present, sorted in order of descending size. */ +#endif + + +/*---------------------------------------------------------------------- + MISC + ----------------------------------------------------------------------*/ + +/* Data alignment required if used for instructions: */ +#if XCHAL_INST_FETCH_WIDTH > XCHAL_DATA_WIDTH +# define XCHAL_ALIGN_MAX XCHAL_INST_FETCH_WIDTH +#else +# define XCHAL_ALIGN_MAX XCHAL_DATA_WIDTH +#endif + +/* + * Names kept for backward compatibility. + * (Here "RELEASE" is now a misnomer; these are product *versions*, not the releases + * under which they are released. In the T10##.# era there was no distinction.) + */ +#define XCHAL_HW_RELEASE_MAJOR XCHAL_HW_VERSION_MAJOR +#define XCHAL_HW_RELEASE_MINOR XCHAL_HW_VERSION_MINOR +#define XCHAL_HW_RELEASE_NAME XCHAL_HW_VERSION_NAME + + + + +/*---------------------------------------------------------------------- + COPROCESSORS and EXTRA STATE + ----------------------------------------------------------------------*/ + +#define XCHAL_EXTRA_SA_SIZE XCHAL_NCP_SA_SIZE +#define XCHAL_EXTRA_SA_ALIGN XCHAL_NCP_SA_ALIGN +#define XCHAL_CPEXTRA_SA_SIZE XCHAL_TOTAL_SA_SIZE +#define XCHAL_CPEXTRA_SA_ALIGN XCHAL_TOTAL_SA_ALIGN + +#if defined (_ASMLANGUAGE) || defined (__ASSEMBLER__) + + /* Invoked at start of save area load/store sequence macro to setup macro + * internal offsets. Not usually invoked directly. + * continue 0 for 1st sequence, 1 for subsequent consecutive ones. + * totofs offset from original ptr to next load/store location. + */ + .macro xchal_sa_start continue totofs + .ifeq \continue + .set .Lxchal_pofs_, 0 /* offset from original ptr to current \ptr */ + .set .Lxchal_ofs_, 0 /* offset from current \ptr to next load/store location */ + .endif + .if \totofs + 1 /* if totofs specified (not -1) */ + .set .Lxchal_ofs_, \totofs - .Lxchal_pofs_ /* specific offset from original ptr */ + .endif + .endm + + /* Align portion of save area and bring ptr in range if necessary. + * Used by save area load/store sequences. Not usually invoked directly. + * Allows combining multiple (sub-)sequences arbitrarily. + * ptr pointer to save area (may be off, see .Lxchal_pofs_) + * minofs,maxofs range of offset from cur ptr to next load/store loc; + * minofs <= 0 <= maxofs (0 must always be valid offset) + * range must be within +/- 30kB or so. + * ofsalign alignment granularity of minofs .. maxofs (pow of 2) + * (restriction on offset from ptr to next load/store loc) + * totalign align from orig ptr to next load/store loc (pow of 2) + */ + .macro xchal_sa_align ptr minofs maxofs ofsalign totalign + /* First align where we start accessing the next register + * per \totalign relative to original ptr (i.e. start of the save area): + */ + .set .Lxchal_ofs_, ((.Lxchal_pofs_ + .Lxchal_ofs_ + \totalign - 1) & -\totalign) - .Lxchal_pofs_ + /* If necessary, adjust \ptr to bring .Lxchal_ofs_ in acceptable range: */ + .if (((\maxofs) - .Lxchal_ofs_) & 0xC0000000) | ((.Lxchal_ofs_ - (\minofs)) & 0xC0000000) | (.Lxchal_ofs_ & (\ofsalign-1)) + .set .Ligmask, 0xFFFFFFFF /* TODO: optimize to addmi, per aligns and .Lxchal_ofs_ */ + addi \ptr, \ptr, (.Lxchal_ofs_ & .Ligmask) + .set .Lxchal_pofs_, .Lxchal_pofs_ + (.Lxchal_ofs_ & .Ligmask) + .set .Lxchal_ofs_, (.Lxchal_ofs_ & ~.Ligmask) + .endif + .endm + /* + * We could optimize for addi to expand to only addmi instead of + * "addmi;addi", where possible. Here's a partial example how: + * .set .Lmaxmask, -(\ofsalign) & -(\totalign) + * .if (((\maxofs) + ~.Lmaxmask + 1) & 0xFFFFFF00) && ((.Lxchal_ofs_ & ~.Lmaxmask) == 0) + * .set .Ligmask, 0xFFFFFF00 + * .elif ... ditto for negative ofs range ... + * .set .Ligmask, 0xFFFFFF00 + * .set ... adjust per offset ... + * .else + * .set .Ligmask, 0xFFFFFFFF + * .endif + */ + + /* Invoke this after xchal_XXX_{load,store} macros to restore \ptr. */ + .macro xchal_sa_ptr_restore ptr + .if .Lxchal_pofs_ + addi \ptr, \ptr, - .Lxchal_pofs_ + .set .Lxchal_ofs_, .Lxchal_ofs_ + .Lxchal_pofs_ + .set .Lxchal_pofs_, 0 + .endif + .endm + + /* + * Use as eg: + * xchal_atmps_store a1, SOMEOFS, XCHAL_SA_NUM_ATMPS, a4, a5 + * xchal_ncp_load a2, a0,a3,a4,a5 + * xchal_atmps_load a1, SOMEOFS, XCHAL_SA_NUM_ATMPS, a4, a5 + * + * Specify only the ARs you *haven't* saved/restored already, up to 4. + * They *must* be the *last* ARs (in same order) specified to save area + * load/store sequences. In the example above, a0 and a3 were already + * saved/restored and unused (thus available) but a4 and a5 were not. + */ +#define xchal_atmps_store xchal_atmps_loadstore s32i, +#define xchal_atmps_load xchal_atmps_loadstore l32i, + .macro xchal_atmps_loadstore inst ptr offset nreq aa=0 ab=0 ac=0 ad=0 + .set .Lnsaved_, 0 + .irp reg,\aa,\ab,\ac,\ad + .ifeq 0x\reg ; .set .Lnsaved_,.Lnsaved_+1 ; .endif + .endr + .set .Laofs_, 0 + .irp reg,\aa,\ab,\ac,\ad + .ifgt (\nreq)-.Lnsaved_ + \inst \reg, \ptr, .Laofs_+\offset + .set .Laofs_,.Laofs_+4 + .set .Lnsaved_,.Lnsaved_+1 + .endif + .endr + .endm + +/*#define xchal_ncp_load_a2 xchal_ncp_load a2,a3,a4,a5,a6*/ +/*#define xchal_ncp_store_a2 xchal_ncp_store a2,a3,a4,a5,a6*/ +#define xchal_extratie_load xchal_ncptie_load +#define xchal_extratie_store xchal_ncptie_store +#define xchal_extratie_load_a2 xchal_ncptie_load a2,a3,a4,a5,a6 +#define xchal_extratie_store_a2 xchal_ncptie_store a2,a3,a4,a5,a6 +#define xchal_extra_load xchal_ncp_load +#define xchal_extra_store xchal_ncp_store +#define xchal_extra_load_a2 xchal_ncp_load a2,a3,a4,a5,a6 +#define xchal_extra_store_a2 xchal_ncp_store a2,a3,a4,a5,a6 +#define xchal_extra_load_funcbody xchal_ncp_load a2,a3,a4,a5,a6 +#define xchal_extra_store_funcbody xchal_ncp_store a2,a3,a4,a5,a6 +#define xchal_cp0_store_a2 xchal_cp0_store a2,a3,a4,a5,a6 +#define xchal_cp0_load_a2 xchal_cp0_load a2,a3,a4,a5,a6 +#define xchal_cp1_store_a2 xchal_cp1_store a2,a3,a4,a5,a6 +#define xchal_cp1_load_a2 xchal_cp1_load a2,a3,a4,a5,a6 +#define xchal_cp2_store_a2 xchal_cp2_store a2,a3,a4,a5,a6 +#define xchal_cp2_load_a2 xchal_cp2_load a2,a3,a4,a5,a6 +#define xchal_cp3_store_a2 xchal_cp3_store a2,a3,a4,a5,a6 +#define xchal_cp3_load_a2 xchal_cp3_load a2,a3,a4,a5,a6 +#define xchal_cp4_store_a2 xchal_cp4_store a2,a3,a4,a5,a6 +#define xchal_cp4_load_a2 xchal_cp4_load a2,a3,a4,a5,a6 +#define xchal_cp5_store_a2 xchal_cp5_store a2,a3,a4,a5,a6 +#define xchal_cp5_load_a2 xchal_cp5_load a2,a3,a4,a5,a6 +#define xchal_cp6_store_a2 xchal_cp6_store a2,a3,a4,a5,a6 +#define xchal_cp6_load_a2 xchal_cp6_load a2,a3,a4,a5,a6 +#define xchal_cp7_store_a2 xchal_cp7_store a2,a3,a4,a5,a6 +#define xchal_cp7_load_a2 xchal_cp7_load a2,a3,a4,a5,a6 + +/* Empty placeholder macros for undefined coprocessors: */ +#if (XCHAL_CP_MASK & ~XCHAL_CP_PORT_MASK) == 0 +# if XCHAL_CP0_SA_SIZE == 0 + .macro xchal_cp0_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp0_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP1_SA_SIZE == 0 + .macro xchal_cp1_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp1_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP2_SA_SIZE == 0 + .macro xchal_cp2_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp2_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP3_SA_SIZE == 0 + .macro xchal_cp3_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp3_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP4_SA_SIZE == 0 + .macro xchal_cp4_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp4_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP5_SA_SIZE == 0 + .macro xchal_cp5_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp5_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP6_SA_SIZE == 0 + .macro xchal_cp6_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp6_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +# if XCHAL_CP7_SA_SIZE == 0 + .macro xchal_cp7_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp7_load p a b c d continue=0 ofs=-1 select=-1 ; .endm +# endif +#endif + + /******************** + * Macros to create functions that save and restore the state of *any* TIE + * coprocessor (by dynamic index). + */ + + /* + * Macro that expands to the body of a function + * that stores the selected coprocessor's state (registers etc). + * Entry: a2 = ptr to save area in which to save cp state + * a3 = coprocessor number + * Exit: any register a2-a15 (?) may have been clobbered. + */ + .macro xchal_cpi_store_funcbody +#if (XCHAL_CP_MASK & ~XCHAL_CP_PORT_MASK) +# if XCHAL_CP0_SA_SIZE + bnez a3, 99f + xchal_cp0_store_a2 + j 90f +99: +# endif +# if XCHAL_CP1_SA_SIZE + bnei a3, 1, 99f + xchal_cp1_store_a2 + j 90f +99: +# endif +# if XCHAL_CP2_SA_SIZE + bnei a3, 2, 99f + xchal_cp2_store_a2 + j 90f +99: +# endif +# if XCHAL_CP3_SA_SIZE + bnei a3, 3, 99f + xchal_cp3_store_a2 + j 90f +99: +# endif +# if XCHAL_CP4_SA_SIZE + bnei a3, 4, 99f + xchal_cp4_store_a2 + j 90f +99: +# endif +# if XCHAL_CP5_SA_SIZE + bnei a3, 5, 99f + xchal_cp5_store_a2 + j 90f +99: +# endif +# if XCHAL_CP6_SA_SIZE + bnei a3, 6, 99f + xchal_cp6_store_a2 + j 90f +99: +# endif +# if XCHAL_CP7_SA_SIZE + bnei a3, 7, 99f + xchal_cp7_store_a2 + j 90f +99: +# endif +90: +#endif + .endm + + /* + * Macro that expands to the body of a function + * that loads the selected coprocessor's state (registers etc). + * Entry: a2 = ptr to save area from which to restore cp state + * a3 = coprocessor number + * Exit: any register a2-a15 (?) may have been clobbered. + */ + .macro xchal_cpi_load_funcbody +#if (XCHAL_CP_MASK & ~XCHAL_CP_PORT_MASK) +# if XCHAL_CP0_SA_SIZE + bnez a3, 99f + xchal_cp0_load_a2 + j 90f +99: +# endif +# if XCHAL_CP1_SA_SIZE + bnei a3, 1, 99f + xchal_cp1_load_a2 + j 90f +99: +# endif +# if XCHAL_CP2_SA_SIZE + bnei a3, 2, 99f + xchal_cp2_load_a2 + j 90f +99: +# endif +# if XCHAL_CP3_SA_SIZE + bnei a3, 3, 99f + xchal_cp3_load_a2 + j 90f +99: +# endif +# if XCHAL_CP4_SA_SIZE + bnei a3, 4, 99f + xchal_cp4_load_a2 + j 90f +99: +# endif +# if XCHAL_CP5_SA_SIZE + bnei a3, 5, 99f + xchal_cp5_load_a2 + j 90f +99: +# endif +# if XCHAL_CP6_SA_SIZE + bnei a3, 6, 99f + xchal_cp6_load_a2 + j 90f +99: +# endif +# if XCHAL_CP7_SA_SIZE + bnei a3, 7, 99f + xchal_cp7_load_a2 + j 90f +99: +# endif +90: +#endif + .endm + +#endif /*_ASMLANGUAGE or __ASSEMBLER__*/ + + +/* Other default macros for undefined coprocessors: */ +#ifndef XCHAL_CP0_NAME +# define XCHAL_CP0_NAME 0 +# define XCHAL_CP0_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP0_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP1_NAME +# define XCHAL_CP1_NAME 0 +# define XCHAL_CP1_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP1_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP2_NAME +# define XCHAL_CP2_NAME 0 +# define XCHAL_CP2_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP2_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP3_NAME +# define XCHAL_CP3_NAME 0 +# define XCHAL_CP3_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP3_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP4_NAME +# define XCHAL_CP4_NAME 0 +# define XCHAL_CP4_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP4_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP5_NAME +# define XCHAL_CP5_NAME 0 +# define XCHAL_CP5_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP5_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP6_NAME +# define XCHAL_CP6_NAME 0 +# define XCHAL_CP6_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP6_SA_CONTENTS_LIBDB /* empty */ +#endif +#ifndef XCHAL_CP7_NAME +# define XCHAL_CP7_NAME 0 +# define XCHAL_CP7_SA_CONTENTS_LIBDB_NUM 0 +# define XCHAL_CP7_SA_CONTENTS_LIBDB /* empty */ +#endif + +#if XCHAL_CP_MASK == 0 +/* Filler info for unassigned coprocessors, to simplify arrays etc: */ +#define XCHAL_CP0_SA_SIZE 0 +#define XCHAL_CP0_SA_ALIGN 1 +#define XCHAL_CP1_SA_SIZE 0 +#define XCHAL_CP1_SA_ALIGN 1 +#define XCHAL_CP2_SA_SIZE 0 +#define XCHAL_CP2_SA_ALIGN 1 +#define XCHAL_CP3_SA_SIZE 0 +#define XCHAL_CP3_SA_ALIGN 1 +#define XCHAL_CP4_SA_SIZE 0 +#define XCHAL_CP4_SA_ALIGN 1 +#define XCHAL_CP5_SA_SIZE 0 +#define XCHAL_CP5_SA_ALIGN 1 +#define XCHAL_CP6_SA_SIZE 0 +#define XCHAL_CP6_SA_ALIGN 1 +#define XCHAL_CP7_SA_SIZE 0 +#define XCHAL_CP7_SA_ALIGN 1 +#endif + + +/* Indexing macros: */ +#define _XCHAL_CP_SA_SIZE(n) XCHAL_CP ## n ## _SA_SIZE +#define XCHAL_CP_SA_SIZE(n) _XCHAL_CP_SA_SIZE(n) /* n = 0 .. 7 */ +#define _XCHAL_CP_SA_ALIGN(n) XCHAL_CP ## n ## _SA_ALIGN +#define XCHAL_CP_SA_ALIGN(n) _XCHAL_CP_SA_ALIGN(n) /* n = 0 .. 7 */ + +#define XCHAL_CPEXTRA_SA_SIZE_TOR2 XCHAL_CPEXTRA_SA_SIZE /* Tor2Beta only - do not use */ + +/* Link-time HAL global variables that report coprocessor numbers by name + (names are case-preserved from the original TIE): */ +#if !defined(_ASMLANGUAGE) && !defined(_NOCLANGUAGE) && !defined(__ASSEMBLER__) +# define _XCJOIN(a,b) a ## b +# define XCJOIN(a,b) _XCJOIN(a,b) +# ifdef XCHAL_CP0_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP0_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP0_IDENT); +# endif +# ifdef XCHAL_CP1_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP1_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP1_IDENT); +# endif +# ifdef XCHAL_CP2_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP2_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP2_IDENT); +# endif +# ifdef XCHAL_CP3_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP3_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP3_IDENT); +# endif +# ifdef XCHAL_CP4_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP4_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP4_IDENT); +# endif +# ifdef XCHAL_CP5_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP5_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP5_IDENT); +# endif +# ifdef XCHAL_CP6_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP6_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP6_IDENT); +# endif +# ifdef XCHAL_CP7_NAME +extern const unsigned char XCJOIN(Xthal_cp_id_,XCHAL_CP7_IDENT); +extern const unsigned int XCJOIN(Xthal_cp_mask_,XCHAL_CP7_IDENT); +# endif +#endif + + + + +/*---------------------------------------------------------------------- + DERIVED + ----------------------------------------------------------------------*/ + +#if XCHAL_HAVE_BE +#define XCHAL_INST_ILLN 0xD60F /* 2-byte illegal instruction, msb-first */ +#define XCHAL_INST_ILLN_BYTE0 0xD6 /* 2-byte illegal instruction, 1st byte */ +#define XCHAL_INST_ILLN_BYTE1 0x0F /* 2-byte illegal instruction, 2nd byte */ +#else +#define XCHAL_INST_ILLN 0xF06D /* 2-byte illegal instruction, lsb-first */ +#define XCHAL_INST_ILLN_BYTE0 0x6D /* 2-byte illegal instruction, 1st byte */ +#define XCHAL_INST_ILLN_BYTE1 0xF0 /* 2-byte illegal instruction, 2nd byte */ +#endif +/* Belongs in xtensa/hal.h: */ +#define XTHAL_INST_ILL 0x000000 /* 3-byte illegal instruction */ + + +/* + * Because information as to exactly which hardware version is targeted + * by a given software build is not always available, compile-time HAL + * Hardware-Release "_AT" macros are fuzzy (return 0, 1, or XCHAL_MAYBE): + * (Here "RELEASE" is now a misnomer; these are product *versions*, not the releases + * under which they are released. In the T10##.# era there was no distinction.) + */ +#if XCHAL_HW_CONFIGID_RELIABLE +# define XCHAL_HW_RELEASE_AT_OR_BELOW(major,minor) (XTHAL_REL_LE( XCHAL_HW_VERSION_MAJOR,XCHAL_HW_VERSION_MINOR, major,minor ) ? 1 : 0) +# define XCHAL_HW_RELEASE_AT_OR_ABOVE(major,minor) (XTHAL_REL_GE( XCHAL_HW_VERSION_MAJOR,XCHAL_HW_VERSION_MINOR, major,minor ) ? 1 : 0) +# define XCHAL_HW_RELEASE_AT(major,minor) (XTHAL_REL_EQ( XCHAL_HW_VERSION_MAJOR,XCHAL_HW_VERSION_MINOR, major,minor ) ? 1 : 0) +# define XCHAL_HW_RELEASE_MAJOR_AT(major) ((XCHAL_HW_VERSION_MAJOR == (major)) ? 1 : 0) +#else +# define XCHAL_HW_RELEASE_AT_OR_BELOW(major,minor) ( ((major) < 1040 && XCHAL_HAVE_XEA2) ? 0 \ + : ((major) > 1050 && XCHAL_HAVE_XEA1) ? 1 \ + : XTHAL_MAYBE ) +# define XCHAL_HW_RELEASE_AT_OR_ABOVE(major,minor) ( ((major) >= 2000 && XCHAL_HAVE_XEA1) ? 0 \ + : (XTHAL_REL_LE(major,minor, 1040,0) && XCHAL_HAVE_XEA2) ? 1 \ + : XTHAL_MAYBE ) +# define XCHAL_HW_RELEASE_AT(major,minor) ( (((major) < 1040 && XCHAL_HAVE_XEA2) || \ + ((major) >= 2000 && XCHAL_HAVE_XEA1)) ? 0 : XTHAL_MAYBE) +# define XCHAL_HW_RELEASE_MAJOR_AT(major) XCHAL_HW_RELEASE_AT(major,0) +#endif + +/* + * Specific errata: + */ + +/* + * Erratum T1020.H13, T1030.H7, T1040.H10, T1050.H4 (fixed in T1040.3 and T1050.1; + * relevant only in XEA1, kernel-vector mode, level-one interrupts and overflows enabled): + */ +#define XCHAL_MAYHAVE_ERRATUM_XEA1KWIN (XCHAL_HAVE_XEA1 && \ + (XCHAL_HW_RELEASE_AT_OR_BELOW(1040,2) != 0 \ + || XCHAL_HW_RELEASE_AT(1050,0))) +/* + * Erratum 453 present in RE-2013.2 up to RF-2014.0, fixed in RF-2014.1. + * Applies to specific set of configuration options. + * Part of the workaround is to add ISYNC at certain points in the code. + * The workaround gated by this macro can be disabled if not needed, e.g. if + * zero-overhead loop buffer will be disabled, by defining _NO_ERRATUM_453. + */ +#if ( XCHAL_HW_MAX_VERSION >= XTENSA_HWVERSION_RE_2013_2 && \ + XCHAL_HW_MIN_VERSION <= XTENSA_HWVERSION_RF_2014_0 && \ + XCHAL_ICACHE_SIZE != 0 && XCHAL_HAVE_PIF /*covers also AXI/AHB*/ && \ + XCHAL_HAVE_LOOPS && XCHAL_LOOP_BUFFER_SIZE != 0 && \ + XCHAL_CLOCK_GATING_GLOBAL && !defined(_NO_ERRATUM_453) ) +#define XCHAL_ERRATUM_453 1 +#else +#define XCHAL_ERRATUM_453 0 +#endif + +/* + * Erratum 497 present in RE-2012.2 up to RG/RF-2015.2 + * Applies to specific set of configuration options. + * Workaround is to add MEMWs after at most 8 cache WB instructions + */ +#if ( ((XCHAL_HW_MAX_VERSION >= XTENSA_HWVERSION_RE_2012_0 && \ + XCHAL_HW_MIN_VERSION <= XTENSA_HWVERSION_RF_2015_2) || \ + (XCHAL_HW_MAX_VERSION >= XTENSA_HWVERSION_RG_2015_0 && \ + XCHAL_HW_MIN_VERSION <= XTENSA_HWVERSION_RG_2015_2) \ + ) && \ + XCHAL_DCACHE_IS_WRITEBACK && \ + XCHAL_HAVE_AXI && \ + XCHAL_HAVE_PIF_WR_RESP && \ + XCHAL_HAVE_PIF_REQ_ATTR && !defined(_NO_ERRATUM_497) \ + ) +#define XCHAL_ERRATUM_497 1 +#else +#define XCHAL_ERRATUM_497 0 +#endif + +#endif /*XTENSA_CONFIG_CORE_H*/ + diff --git a/components/esp32/include/xtensa/config/defs.h b/components/esp32/include/xtensa/config/defs.h new file mode 100644 index 000000000..d7c48ea84 --- /dev/null +++ b/components/esp32/include/xtensa/config/defs.h @@ -0,0 +1,38 @@ +/* Definitions for Xtensa instructions, types, and protos. */ + +/* Customer ID=11657; Build=0x5fe96; Copyright (c) 2003-2004 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +/* NOTE: This file exists only for backward compatibility with T1050 + and earlier Xtensa releases. It includes only a subset of the + available header files. */ + +#ifndef _XTENSA_BASE_HEADER +#define _XTENSA_BASE_HEADER + +#ifdef __XTENSA__ + +#include +#include +#include + +#endif /* __XTENSA__ */ +#endif /* !_XTENSA_BASE_HEADER */ diff --git a/components/esp32/include/xtensa/config/specreg.h b/components/esp32/include/xtensa/config/specreg.h new file mode 100644 index 000000000..0135d4c7f --- /dev/null +++ b/components/esp32/include/xtensa/config/specreg.h @@ -0,0 +1,117 @@ +/* + * Xtensa Special Register symbolic names + */ + +/* $Id: //depot/rel/Eaglenest/Xtensa/SWConfig/hal/specreg.h.tpp#1 $ */ + +/* Customer ID=11657; Build=0x5fe96; Copyright (c) 1998-2002 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef XTENSA_SPECREG_H +#define XTENSA_SPECREG_H + +/* Include these special register bitfield definitions, for historical reasons: */ +#include + + +/* Special registers: */ +#define LBEG 0 +#define LEND 1 +#define LCOUNT 2 +#define SAR 3 +#define BR 4 +#define SCOMPARE1 12 +#define ACCLO 16 +#define ACCHI 17 +#define MR_0 32 +#define MR_1 33 +#define MR_2 34 +#define MR_3 35 +#define WINDOWBASE 72 +#define WINDOWSTART 73 +#define IBREAKENABLE 96 +#define MEMCTL 97 +#define ATOMCTL 99 +#define DDR 104 +#define IBREAKA_0 128 +#define IBREAKA_1 129 +#define DBREAKA_0 144 +#define DBREAKA_1 145 +#define DBREAKC_0 160 +#define DBREAKC_1 161 +#define EPC_1 177 +#define EPC_2 178 +#define EPC_3 179 +#define EPC_4 180 +#define EPC_5 181 +#define EPC_6 182 +#define EPC_7 183 +#define DEPC 192 +#define EPS_2 194 +#define EPS_3 195 +#define EPS_4 196 +#define EPS_5 197 +#define EPS_6 198 +#define EPS_7 199 +#define EXCSAVE_1 209 +#define EXCSAVE_2 210 +#define EXCSAVE_3 211 +#define EXCSAVE_4 212 +#define EXCSAVE_5 213 +#define EXCSAVE_6 214 +#define EXCSAVE_7 215 +#define CPENABLE 224 +#define INTERRUPT 226 +#define INTENABLE 228 +#define PS 230 +#define VECBASE 231 +#define EXCCAUSE 232 +#define DEBUGCAUSE 233 +#define CCOUNT 234 +#define PRID 235 +#define ICOUNT 236 +#define ICOUNTLEVEL 237 +#define EXCVADDR 238 +#define CCOMPARE_0 240 +#define CCOMPARE_1 241 +#define CCOMPARE_2 242 +#define MISC_REG_0 244 +#define MISC_REG_1 245 +#define MISC_REG_2 246 +#define MISC_REG_3 247 + +/* Special cases (bases of special register series): */ +#define MR 32 +#define IBREAKA 128 +#define DBREAKA 144 +#define DBREAKC 160 +#define EPC 176 +#define EPS 192 +#define EXCSAVE 208 +#define CCOMPARE 240 + +/* Special names for read-only and write-only interrupt registers: */ +#define INTREAD 226 +#define INTSET 226 +#define INTCLEAR 227 + +#endif /* XTENSA_SPECREG_H */ + diff --git a/components/esp32/include/xtensa/config/system.h b/components/esp32/include/xtensa/config/system.h new file mode 100644 index 000000000..0d56eef74 --- /dev/null +++ b/components/esp32/include/xtensa/config/system.h @@ -0,0 +1,274 @@ +/* + * xtensa/config/system.h -- HAL definitions that are dependent on SYSTEM configuration + * + * NOTE: The location and contents of this file are highly subject to change. + * + * Source for configuration-independent binaries (which link in a + * configuration-specific HAL library) must NEVER include this file. + * The HAL itself has historically included this file in some instances, + * but this is not appropriate either, because the HAL is meant to be + * core-specific but system independent. + */ + +/* Customer ID=11657; Build=0x5fe96; Copyright (c) 2000-2010 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + + +#ifndef XTENSA_CONFIG_SYSTEM_H +#define XTENSA_CONFIG_SYSTEM_H + +/*#include */ + + + +/*---------------------------------------------------------------------- + CONFIGURED SOFTWARE OPTIONS + ----------------------------------------------------------------------*/ + +#define XSHAL_USE_ABSOLUTE_LITERALS 0 /* (sw-only option, whether software uses absolute literals) */ +#define XSHAL_HAVE_TEXT_SECTION_LITERALS 1 /* Set if there is some memory that allows both code and literals. */ + +#define XSHAL_ABI XTHAL_ABI_WINDOWED /* (sw-only option, selected ABI) */ +/* The above maps to one of the following constants: */ +#define XTHAL_ABI_WINDOWED 0 +#define XTHAL_ABI_CALL0 1 +/* Alternatives: */ +/*#define XSHAL_WINDOWED_ABI 1*/ /* set if windowed ABI selected */ +/*#define XSHAL_CALL0_ABI 0*/ /* set if call0 ABI selected */ + +#define XSHAL_CLIB XTHAL_CLIB_NEWLIB /* (sw-only option, selected C library) */ +/* The above maps to one of the following constants: */ +#define XTHAL_CLIB_NEWLIB 0 +#define XTHAL_CLIB_UCLIBC 1 +#define XTHAL_CLIB_XCLIB 2 +/* Alternatives: */ +/*#define XSHAL_NEWLIB 1*/ /* set if newlib C library selected */ +/*#define XSHAL_UCLIBC 0*/ /* set if uCLibC C library selected */ +/*#define XSHAL_XCLIB 0*/ /* set if Xtensa C library selected */ + +#define XSHAL_USE_FLOATING_POINT 1 + +#define XSHAL_FLOATING_POINT_ABI 0 + +/* SW workarounds enabled for HW errata: */ + +/*---------------------------------------------------------------------- + DEVICE ADDRESSES + ----------------------------------------------------------------------*/ + +/* + * Strange place to find these, but the configuration GUI + * allows moving these around to account for various core + * configurations. Specific boards (and their BSP software) + * will have specific meanings for these components. + */ + +/* I/O Block areas: */ +#define XSHAL_IOBLOCK_CACHED_VADDR 0x70000000 +#define XSHAL_IOBLOCK_CACHED_PADDR 0x70000000 +#define XSHAL_IOBLOCK_CACHED_SIZE 0x0E000000 + +#define XSHAL_IOBLOCK_BYPASS_VADDR 0x90000000 +#define XSHAL_IOBLOCK_BYPASS_PADDR 0x90000000 +#define XSHAL_IOBLOCK_BYPASS_SIZE 0x0E000000 + +/* System ROM: */ +#define XSHAL_ROM_VADDR 0x50000000 +#define XSHAL_ROM_PADDR 0x50000000 +#define XSHAL_ROM_SIZE 0x01000000 +/* Largest available area (free of vectors): */ +#define XSHAL_ROM_AVAIL_VADDR 0x50000000 +#define XSHAL_ROM_AVAIL_VSIZE 0x01000000 + +/* System RAM: */ +#define XSHAL_RAM_VADDR 0x60000000 +#define XSHAL_RAM_PADDR 0x60000000 +#define XSHAL_RAM_VSIZE 0x20000000 +#define XSHAL_RAM_PSIZE 0x20000000 +#define XSHAL_RAM_SIZE XSHAL_RAM_PSIZE +/* Largest available area (free of vectors): */ +#define XSHAL_RAM_AVAIL_VADDR 0x60000000 +#define XSHAL_RAM_AVAIL_VSIZE 0x20000000 + +/* + * Shadow system RAM (same device as system RAM, at different address). + * (Emulation boards need this for the SONIC Ethernet driver + * when data caches are configured for writeback mode.) + * NOTE: on full MMU configs, this points to the BYPASS virtual address + * of system RAM, ie. is the same as XSHAL_RAM_* except that virtual + * addresses are viewed through the BYPASS static map rather than + * the CACHED static map. + */ +#define XSHAL_RAM_BYPASS_VADDR 0xA0000000 +#define XSHAL_RAM_BYPASS_PADDR 0xA0000000 +#define XSHAL_RAM_BYPASS_PSIZE 0x20000000 + +/* Alternate system RAM (different device than system RAM): */ +/*#define XSHAL_ALTRAM_[VP]ADDR ...not configured...*/ +/*#define XSHAL_ALTRAM_SIZE ...not configured...*/ + +/* Some available location in which to place devices in a simulation (eg. XTMP): */ +#define XSHAL_SIMIO_CACHED_VADDR 0xC0000000 +#define XSHAL_SIMIO_BYPASS_VADDR 0xC0000000 +#define XSHAL_SIMIO_PADDR 0xC0000000 +#define XSHAL_SIMIO_SIZE 0x20000000 + + +/*---------------------------------------------------------------------- + * For use by reference testbench exit and diagnostic routines. + */ +#define XSHAL_MAGIC_EXIT 0x0 + +/*---------------------------------------------------------------------- + * DEVICE-ADDRESS DEPENDENT... + * + * Values written to CACHEATTR special register (or its equivalent) + * to enable and disable caches in various modes. + *----------------------------------------------------------------------*/ + +/*---------------------------------------------------------------------- + BACKWARD COMPATIBILITY ... + ----------------------------------------------------------------------*/ + +/* + * NOTE: the following two macros are DEPRECATED. Use the latter + * board-specific macros instead, which are specially tuned for the + * particular target environments' memory maps. + */ +#define XSHAL_CACHEATTR_BYPASS XSHAL_XT2000_CACHEATTR_BYPASS /* disable caches in bypass mode */ +#define XSHAL_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_DEFAULT /* default setting to enable caches (no writeback!) */ + +/*---------------------------------------------------------------------- + GENERIC + ----------------------------------------------------------------------*/ + +/* For the following, a 512MB region is used if it contains a system (PIF) RAM, + * system (PIF) ROM, local memory, or XLMI. */ + +/* These set any unused 512MB region to cache-BYPASS attribute: */ +#define XSHAL_ALLVALID_CACHEATTR_WRITEBACK 0x22221112 /* enable caches in write-back mode */ +#define XSHAL_ALLVALID_CACHEATTR_WRITEALLOC 0x22221112 /* enable caches in write-allocate mode */ +#define XSHAL_ALLVALID_CACHEATTR_WRITETHRU 0x22221112 /* enable caches in write-through mode */ +#define XSHAL_ALLVALID_CACHEATTR_BYPASS 0x22222222 /* disable caches in bypass mode */ +#define XSHAL_ALLVALID_CACHEATTR_DEFAULT XSHAL_ALLVALID_CACHEATTR_WRITEBACK /* default setting to enable caches */ + +/* These set any unused 512MB region to ILLEGAL attribute: */ +#define XSHAL_STRICT_CACHEATTR_WRITEBACK 0xFFFF111F /* enable caches in write-back mode */ +#define XSHAL_STRICT_CACHEATTR_WRITEALLOC 0xFFFF111F /* enable caches in write-allocate mode */ +#define XSHAL_STRICT_CACHEATTR_WRITETHRU 0xFFFF111F /* enable caches in write-through mode */ +#define XSHAL_STRICT_CACHEATTR_BYPASS 0xFFFF222F /* disable caches in bypass mode */ +#define XSHAL_STRICT_CACHEATTR_DEFAULT XSHAL_STRICT_CACHEATTR_WRITEBACK /* default setting to enable caches */ + +/* These set the first 512MB, if unused, to ILLEGAL attribute to help catch + * NULL-pointer dereference bugs; all other unused 512MB regions are set + * to cache-BYPASS attribute: */ +#define XSHAL_TRAPNULL_CACHEATTR_WRITEBACK 0x2222111F /* enable caches in write-back mode */ +#define XSHAL_TRAPNULL_CACHEATTR_WRITEALLOC 0x2222111F /* enable caches in write-allocate mode */ +#define XSHAL_TRAPNULL_CACHEATTR_WRITETHRU 0x2222111F /* enable caches in write-through mode */ +#define XSHAL_TRAPNULL_CACHEATTR_BYPASS 0x2222222F /* disable caches in bypass mode */ +#define XSHAL_TRAPNULL_CACHEATTR_DEFAULT XSHAL_TRAPNULL_CACHEATTR_WRITEBACK /* default setting to enable caches */ + +/*---------------------------------------------------------------------- + ISS (Instruction Set Simulator) SPECIFIC ... + ----------------------------------------------------------------------*/ + +/* For now, ISS defaults to the TRAPNULL settings: */ +#define XSHAL_ISS_CACHEATTR_WRITEBACK XSHAL_TRAPNULL_CACHEATTR_WRITEBACK +#define XSHAL_ISS_CACHEATTR_WRITEALLOC XSHAL_TRAPNULL_CACHEATTR_WRITEALLOC +#define XSHAL_ISS_CACHEATTR_WRITETHRU XSHAL_TRAPNULL_CACHEATTR_WRITETHRU +#define XSHAL_ISS_CACHEATTR_BYPASS XSHAL_TRAPNULL_CACHEATTR_BYPASS +#define XSHAL_ISS_CACHEATTR_DEFAULT XSHAL_TRAPNULL_CACHEATTR_WRITEBACK + +#define XSHAL_ISS_PIPE_REGIONS 0 +#define XSHAL_ISS_SDRAM_REGIONS 0 + + +/*---------------------------------------------------------------------- + XT2000 BOARD SPECIFIC ... + ----------------------------------------------------------------------*/ + +/* For the following, a 512MB region is used if it contains any system RAM, + * system ROM, local memory, XLMI, or other XT2000 board device or memory. + * Regions containing devices are forced to cache-BYPASS mode regardless + * of whether the macro is _WRITEBACK vs. _BYPASS etc. */ + +/* These set any 512MB region unused on the XT2000 to ILLEGAL attribute: */ +#define XSHAL_XT2000_CACHEATTR_WRITEBACK 0xFF22111F /* enable caches in write-back mode */ +#define XSHAL_XT2000_CACHEATTR_WRITEALLOC 0xFF22111F /* enable caches in write-allocate mode */ +#define XSHAL_XT2000_CACHEATTR_WRITETHRU 0xFF22111F /* enable caches in write-through mode */ +#define XSHAL_XT2000_CACHEATTR_BYPASS 0xFF22222F /* disable caches in bypass mode */ +#define XSHAL_XT2000_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_WRITEBACK /* default setting to enable caches */ + +#define XSHAL_XT2000_PIPE_REGIONS 0x00000000 /* BusInt pipeline regions */ +#define XSHAL_XT2000_SDRAM_REGIONS 0x00000440 /* BusInt SDRAM regions */ + + +/*---------------------------------------------------------------------- + VECTOR INFO AND SIZES + ----------------------------------------------------------------------*/ + +#define XSHAL_VECTORS_PACKED 0 +#define XSHAL_STATIC_VECTOR_SELECT 1 +#define XSHAL_RESET_VECTOR_VADDR 0x40000400 +#define XSHAL_RESET_VECTOR_PADDR 0x40000400 + +/* + * Sizes allocated to vectors by the system (memory map) configuration. + * These sizes are constrained by core configuration (eg. one vector's + * code cannot overflow into another vector) but are dependent on the + * system or board (or LSP) memory map configuration. + * + * Whether or not each vector happens to be in a system ROM is also + * a system configuration matter, sometimes useful, included here also: + */ +#define XSHAL_RESET_VECTOR_SIZE 0x00000300 +#define XSHAL_RESET_VECTOR_ISROM 0 +#define XSHAL_USER_VECTOR_SIZE 0x00000038 +#define XSHAL_USER_VECTOR_ISROM 0 +#define XSHAL_PROGRAMEXC_VECTOR_SIZE XSHAL_USER_VECTOR_SIZE /* for backward compatibility */ +#define XSHAL_USEREXC_VECTOR_SIZE XSHAL_USER_VECTOR_SIZE /* for backward compatibility */ +#define XSHAL_KERNEL_VECTOR_SIZE 0x00000038 +#define XSHAL_KERNEL_VECTOR_ISROM 0 +#define XSHAL_STACKEDEXC_VECTOR_SIZE XSHAL_KERNEL_VECTOR_SIZE /* for backward compatibility */ +#define XSHAL_KERNELEXC_VECTOR_SIZE XSHAL_KERNEL_VECTOR_SIZE /* for backward compatibility */ +#define XSHAL_DOUBLEEXC_VECTOR_SIZE 0x00000040 +#define XSHAL_DOUBLEEXC_VECTOR_ISROM 0 +#define XSHAL_WINDOW_VECTORS_SIZE 0x00000178 +#define XSHAL_WINDOW_VECTORS_ISROM 0 +#define XSHAL_INTLEVEL2_VECTOR_SIZE 0x00000038 +#define XSHAL_INTLEVEL2_VECTOR_ISROM 0 +#define XSHAL_INTLEVEL3_VECTOR_SIZE 0x00000038 +#define XSHAL_INTLEVEL3_VECTOR_ISROM 0 +#define XSHAL_INTLEVEL4_VECTOR_SIZE 0x00000038 +#define XSHAL_INTLEVEL4_VECTOR_ISROM 0 +#define XSHAL_INTLEVEL5_VECTOR_SIZE 0x00000038 +#define XSHAL_INTLEVEL5_VECTOR_ISROM 0 +#define XSHAL_INTLEVEL6_VECTOR_SIZE 0x00000038 +#define XSHAL_INTLEVEL6_VECTOR_ISROM 0 +#define XSHAL_DEBUG_VECTOR_SIZE XSHAL_INTLEVEL6_VECTOR_SIZE +#define XSHAL_DEBUG_VECTOR_ISROM XSHAL_INTLEVEL6_VECTOR_ISROM +#define XSHAL_NMI_VECTOR_SIZE 0x00000038 +#define XSHAL_NMI_VECTOR_ISROM 0 +#define XSHAL_INTLEVEL7_VECTOR_SIZE XSHAL_NMI_VECTOR_SIZE + + +#endif /*XTENSA_CONFIG_SYSTEM_H*/ + diff --git a/components/esp32/include/xtensa/config/tie-asm.h b/components/esp32/include/xtensa/config/tie-asm.h new file mode 100644 index 000000000..831d8676a --- /dev/null +++ b/components/esp32/include/xtensa/config/tie-asm.h @@ -0,0 +1,323 @@ +/* + * tie-asm.h -- compile-time HAL assembler definitions dependent on CORE & TIE + * + * NOTE: This header file is not meant to be included directly. + */ + +/* This header file contains assembly-language definitions (assembly + macros, etc.) for this specific Xtensa processor's TIE extensions + and options. It is customized to this Xtensa processor configuration. + + Customer ID=11657; Build=0x5fe96; Copyright (c) 1999-2016 Cadence Design Systems Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _XTENSA_CORE_TIE_ASM_H +#define _XTENSA_CORE_TIE_ASM_H + +/* Selection parameter values for save-area save/restore macros: */ +/* Option vs. TIE: */ +#define XTHAL_SAS_TIE 0x0001 /* custom extension or coprocessor */ +#define XTHAL_SAS_OPT 0x0002 /* optional (and not a coprocessor) */ +#define XTHAL_SAS_ANYOT 0x0003 /* both of the above */ +/* Whether used automatically by compiler: */ +#define XTHAL_SAS_NOCC 0x0004 /* not used by compiler w/o special opts/code */ +#define XTHAL_SAS_CC 0x0008 /* used by compiler without special opts/code */ +#define XTHAL_SAS_ANYCC 0x000C /* both of the above */ +/* ABI handling across function calls: */ +#define XTHAL_SAS_CALR 0x0010 /* caller-saved */ +#define XTHAL_SAS_CALE 0x0020 /* callee-saved */ +#define XTHAL_SAS_GLOB 0x0040 /* global across function calls (in thread) */ +#define XTHAL_SAS_ANYABI 0x0070 /* all of the above three */ +/* Misc */ +#define XTHAL_SAS_ALL 0xFFFF /* include all default NCP contents */ +#define XTHAL_SAS3(optie,ccuse,abi) ( ((optie) & XTHAL_SAS_ANYOT) \ + | ((ccuse) & XTHAL_SAS_ANYCC) \ + | ((abi) & XTHAL_SAS_ANYABI) ) + + + /* + * Macro to store all non-coprocessor (extra) custom TIE and optional state + * (not including zero-overhead loop registers). + * Required parameters: + * ptr Save area pointer address register (clobbered) + * (register must contain a 4 byte aligned address). + * at1..at4 Four temporary address registers (first XCHAL_NCP_NUM_ATMPS + * registers are clobbered, the remaining are unused). + * Optional parameters: + * continue If macro invoked as part of a larger store sequence, set to 1 + * if this is not the first in the sequence. Defaults to 0. + * ofs Offset from start of larger sequence (from value of first ptr + * in sequence) at which to store. Defaults to next available space + * (or 0 if is 0). + * select Select what category(ies) of registers to store, as a bitmask + * (see XTHAL_SAS_xxx constants). Defaults to all registers. + * alloc Select what category(ies) of registers to allocate; if any + * category is selected here that is not in , space for + * the corresponding registers is skipped without doing any load. + */ + .macro xchal_ncp_load ptr at1 at2 at3 at4 continue=0 ofs=-1 select=XTHAL_SAS_ALL alloc=0 + xchal_sa_start \continue, \ofs + // Optional global registers used by default by the compiler: + .ifeq (XTHAL_SAS_OPT | XTHAL_SAS_CC | XTHAL_SAS_GLOB) & ~(\select) + xchal_sa_align \ptr, 0, 1016, 4, 4 + l32i \at1, \ptr, .Lxchal_ofs_+0 + wur.THREADPTR \at1 // threadptr option + .set .Lxchal_ofs_, .Lxchal_ofs_ + 4 + .elseif ((XTHAL_SAS_OPT | XTHAL_SAS_CC | XTHAL_SAS_GLOB) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 1016, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 4 + .endif + // Optional caller-saved registers used by default by the compiler: + .ifeq (XTHAL_SAS_OPT | XTHAL_SAS_CC | XTHAL_SAS_CALR) & ~(\select) + xchal_sa_align \ptr, 0, 1012, 4, 4 + l32i \at1, \ptr, .Lxchal_ofs_+0 + wsr.ACCLO \at1 // MAC16 option + l32i \at1, \ptr, .Lxchal_ofs_+4 + wsr.ACCHI \at1 // MAC16 option + .set .Lxchal_ofs_, .Lxchal_ofs_ + 8 + .elseif ((XTHAL_SAS_OPT | XTHAL_SAS_CC | XTHAL_SAS_CALR) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 1012, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 8 + .endif + // Optional caller-saved registers not used by default by the compiler: + .ifeq (XTHAL_SAS_OPT | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\select) + xchal_sa_align \ptr, 0, 996, 4, 4 + l32i \at1, \ptr, .Lxchal_ofs_+0 + wsr.BR \at1 // boolean option + l32i \at1, \ptr, .Lxchal_ofs_+4 + wsr.SCOMPARE1 \at1 // conditional store option + l32i \at1, \ptr, .Lxchal_ofs_+8 + wsr.M0 \at1 // MAC16 option + l32i \at1, \ptr, .Lxchal_ofs_+12 + wsr.M1 \at1 // MAC16 option + l32i \at1, \ptr, .Lxchal_ofs_+16 + wsr.M2 \at1 // MAC16 option + l32i \at1, \ptr, .Lxchal_ofs_+20 + wsr.M3 \at1 // MAC16 option + .set .Lxchal_ofs_, .Lxchal_ofs_ + 24 + .elseif ((XTHAL_SAS_OPT | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 996, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 24 + .endif + // Custom caller-saved registers not used by default by the compiler: + .ifeq (XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\select) + xchal_sa_align \ptr, 0, 1008, 4, 4 + l32i \at1, \ptr, .Lxchal_ofs_+0 + wur.F64R_LO \at1 // ureg 234 + l32i \at1, \ptr, .Lxchal_ofs_+4 + wur.F64R_HI \at1 // ureg 235 + l32i \at1, \ptr, .Lxchal_ofs_+8 + wur.F64S \at1 // ureg 236 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 12 + .elseif ((XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 1008, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 12 + .endif + .endm // xchal_ncp_load + + +#define XCHAL_NCP_NUM_ATMPS 1 + + /* + * Macro to store the state of TIE coprocessor FPU. + * Required parameters: + * ptr Save area pointer address register (clobbered) + * (register must contain a 4 byte aligned address). + * at1..at4 Four temporary address registers (first XCHAL_CP0_NUM_ATMPS + * registers are clobbered, the remaining are unused). + * Optional parameters are the same as for xchal_ncp_store. + */ +#define xchal_cp_FPU_store xchal_cp0_store + .macro xchal_cp0_store ptr at1 at2 at3 at4 continue=0 ofs=-1 select=XTHAL_SAS_ALL alloc=0 + xchal_sa_start \continue, \ofs + // Custom caller-saved registers not used by default by the compiler: + .ifeq (XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\select) + xchal_sa_align \ptr, 0, 948, 4, 4 + rur.FCR \at1 // ureg 232 + s32i \at1, \ptr, .Lxchal_ofs_+0 + rur.FSR \at1 // ureg 233 + s32i \at1, \ptr, .Lxchal_ofs_+4 + ssi f0, \ptr, .Lxchal_ofs_+8 + ssi f1, \ptr, .Lxchal_ofs_+12 + ssi f2, \ptr, .Lxchal_ofs_+16 + ssi f3, \ptr, .Lxchal_ofs_+20 + ssi f4, \ptr, .Lxchal_ofs_+24 + ssi f5, \ptr, .Lxchal_ofs_+28 + ssi f6, \ptr, .Lxchal_ofs_+32 + ssi f7, \ptr, .Lxchal_ofs_+36 + ssi f8, \ptr, .Lxchal_ofs_+40 + ssi f9, \ptr, .Lxchal_ofs_+44 + ssi f10, \ptr, .Lxchal_ofs_+48 + ssi f11, \ptr, .Lxchal_ofs_+52 + ssi f12, \ptr, .Lxchal_ofs_+56 + ssi f13, \ptr, .Lxchal_ofs_+60 + ssi f14, \ptr, .Lxchal_ofs_+64 + ssi f15, \ptr, .Lxchal_ofs_+68 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 72 + .elseif ((XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 948, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 72 + .endif + .endm // xchal_cp0_store + + /* + * Macro to load the state of TIE coprocessor FPU. + * Required parameters: + * ptr Save area pointer address register (clobbered) + * (register must contain a 4 byte aligned address). + * at1..at4 Four temporary address registers (first XCHAL_CP0_NUM_ATMPS + * registers are clobbered, the remaining are unused). + * Optional parameters are the same as for xchal_ncp_load. + */ +#define xchal_cp_FPU_load xchal_cp0_load + .macro xchal_cp0_load ptr at1 at2 at3 at4 continue=0 ofs=-1 select=XTHAL_SAS_ALL alloc=0 + xchal_sa_start \continue, \ofs + // Custom caller-saved registers not used by default by the compiler: + .ifeq (XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\select) + xchal_sa_align \ptr, 0, 948, 4, 4 + l32i \at1, \ptr, .Lxchal_ofs_+0 + wur.FCR \at1 // ureg 232 + l32i \at1, \ptr, .Lxchal_ofs_+4 + wur.FSR \at1 // ureg 233 + lsi f0, \ptr, .Lxchal_ofs_+8 + lsi f1, \ptr, .Lxchal_ofs_+12 + lsi f2, \ptr, .Lxchal_ofs_+16 + lsi f3, \ptr, .Lxchal_ofs_+20 + lsi f4, \ptr, .Lxchal_ofs_+24 + lsi f5, \ptr, .Lxchal_ofs_+28 + lsi f6, \ptr, .Lxchal_ofs_+32 + lsi f7, \ptr, .Lxchal_ofs_+36 + lsi f8, \ptr, .Lxchal_ofs_+40 + lsi f9, \ptr, .Lxchal_ofs_+44 + lsi f10, \ptr, .Lxchal_ofs_+48 + lsi f11, \ptr, .Lxchal_ofs_+52 + lsi f12, \ptr, .Lxchal_ofs_+56 + lsi f13, \ptr, .Lxchal_ofs_+60 + lsi f14, \ptr, .Lxchal_ofs_+64 + lsi f15, \ptr, .Lxchal_ofs_+68 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 72 + .elseif ((XTHAL_SAS_TIE | XTHAL_SAS_NOCC | XTHAL_SAS_CALR) & ~(\alloc)) == 0 + xchal_sa_align \ptr, 0, 948, 4, 4 + .set .Lxchal_ofs_, .Lxchal_ofs_ + 72 + .endif + .endm // xchal_cp0_load + +#define XCHAL_CP0_NUM_ATMPS 1 +#define XCHAL_SA_NUM_ATMPS 1 + + /* Empty macros for unconfigured coprocessors: */ + .macro xchal_cp1_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp1_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp2_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp2_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp3_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp3_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp4_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp4_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp5_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp5_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp6_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp6_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp7_store p a b c d continue=0 ofs=-1 select=-1 ; .endm + .macro xchal_cp7_load p a b c d continue=0 ofs=-1 select=-1 ; .endm + +#endif /*_XTENSA_CORE_TIE_ASM_H*/ + diff --git a/components/esp32/include/xtensa/config/tie.h b/components/esp32/include/xtensa/config/tie.h new file mode 100644 index 000000000..e17879970 --- /dev/null +++ b/components/esp32/include/xtensa/config/tie.h @@ -0,0 +1,182 @@ +/* + * tie.h -- compile-time HAL definitions dependent on CORE & TIE configuration + * + * NOTE: This header file is not meant to be included directly. + */ + +/* This header file describes this specific Xtensa processor's TIE extensions + that extend basic Xtensa core functionality. It is customized to this + Xtensa processor configuration. + + Customer ID=11657; Build=0x5fe96; Copyright (c) 1999-2016 Cadence Design Systems Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _XTENSA_CORE_TIE_H +#define _XTENSA_CORE_TIE_H + +#define XCHAL_CP_NUM 1 /* number of coprocessors */ +#define XCHAL_CP_MAX 1 /* max CP ID + 1 (0 if none) */ +#define XCHAL_CP_MASK 0x01 /* bitmask of all CPs by ID */ +#define XCHAL_CP_PORT_MASK 0x00 /* bitmask of only port CPs */ + +/* Basic parameters of each coprocessor: */ +#define XCHAL_CP0_NAME "FPU" +#define XCHAL_CP0_IDENT FPU +#define XCHAL_CP0_SA_SIZE 72 /* size of state save area */ +#define XCHAL_CP0_SA_ALIGN 4 /* min alignment of save area */ +#define XCHAL_CP_ID_FPU 0 /* coprocessor ID (0..7) */ + +/* Filler info for unassigned coprocessors, to simplify arrays etc: */ +#define XCHAL_CP1_SA_SIZE 0 +#define XCHAL_CP1_SA_ALIGN 1 +#define XCHAL_CP2_SA_SIZE 0 +#define XCHAL_CP2_SA_ALIGN 1 +#define XCHAL_CP3_SA_SIZE 0 +#define XCHAL_CP3_SA_ALIGN 1 +#define XCHAL_CP4_SA_SIZE 0 +#define XCHAL_CP4_SA_ALIGN 1 +#define XCHAL_CP5_SA_SIZE 0 +#define XCHAL_CP5_SA_ALIGN 1 +#define XCHAL_CP6_SA_SIZE 0 +#define XCHAL_CP6_SA_ALIGN 1 +#define XCHAL_CP7_SA_SIZE 0 +#define XCHAL_CP7_SA_ALIGN 1 + +/* Save area for non-coprocessor optional and custom (TIE) state: */ +#define XCHAL_NCP_SA_SIZE 48 +#define XCHAL_NCP_SA_ALIGN 4 + +/* Total save area for optional and custom state (NCP + CPn): */ +#define XCHAL_TOTAL_SA_SIZE 128 /* with 16-byte align padding */ +#define XCHAL_TOTAL_SA_ALIGN 4 /* actual minimum alignment */ + +/* + * Detailed contents of save areas. + * NOTE: caller must define the XCHAL_SA_REG macro (not defined here) + * before expanding the XCHAL_xxx_SA_LIST() macros. + * + * XCHAL_SA_REG(s,ccused,abikind,kind,opt,name,galign,align,asize, + * dbnum,base,regnum,bitsz,gapsz,reset,x...) + * + * s = passed from XCHAL_*_LIST(s), eg. to select how to expand + * ccused = set if used by compiler without special options or code + * abikind = 0 (caller-saved), 1 (callee-saved), or 2 (thread-global) + * kind = 0 (special reg), 1 (TIE user reg), or 2 (TIE regfile reg) + * opt = 0 (custom TIE extension or coprocessor), or 1 (optional reg) + * name = lowercase reg name (no quotes) + * galign = group byte alignment (power of 2) (galign >= align) + * align = register byte alignment (power of 2) + * asize = allocated size in bytes (asize*8 == bitsz + gapsz + padsz) + * (not including any pad bytes required to galign this or next reg) + * dbnum = unique target number f/debug (see ) + * base = reg shortname w/o index (or sr=special, ur=TIE user reg) + * regnum = reg index in regfile, or special/TIE-user reg number + * bitsz = number of significant bits (regfile width, or ur/sr mask bits) + * gapsz = intervening bits, if bitsz bits not stored contiguously + * (padsz = pad bits at end [TIE regfile] or at msbits [ur,sr] of asize) + * reset = register reset value (or 0 if undefined at reset) + * x = reserved for future use (0 until then) + * + * To filter out certain registers, e.g. to expand only the non-global + * registers used by the compiler, you can do something like this: + * + * #define XCHAL_SA_REG(s,ccused,p...) SELCC##ccused(p) + * #define SELCC0(p...) + * #define SELCC1(abikind,p...) SELAK##abikind(p) + * #define SELAK0(p...) REG(p) + * #define SELAK1(p...) REG(p) + * #define SELAK2(p...) + * #define REG(kind,tie,name,galn,aln,asz,csz,dbnum,base,rnum,bsz,rst,x...) \ + * ...what you want to expand... + */ + +#define XCHAL_NCP_SA_NUM 12 +#define XCHAL_NCP_SA_LIST(s) \ + XCHAL_SA_REG(s,1,2,1,1, threadptr, 4, 4, 4,0x03E7, ur,231, 32,0,0,0) \ + XCHAL_SA_REG(s,1,0,0,1, acclo, 4, 4, 4,0x0210, sr,16 , 32,0,0,0) \ + XCHAL_SA_REG(s,1,0,0,1, acchi, 4, 4, 4,0x0211, sr,17 , 8,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, br, 4, 4, 4,0x0204, sr,4 , 16,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, scompare1, 4, 4, 4,0x020C, sr,12 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, m0, 4, 4, 4,0x0220, sr,32 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, m1, 4, 4, 4,0x0221, sr,33 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, m2, 4, 4, 4,0x0222, sr,34 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,0,1, m3, 4, 4, 4,0x0223, sr,35 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,1,0, f64r_lo, 4, 4, 4,0x03EA, ur,234, 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,1,0, f64r_hi, 4, 4, 4,0x03EB, ur,235, 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,1,0, f64s, 4, 4, 4,0x03EC, ur,236, 32,0,0,0) + +#define XCHAL_CP0_SA_NUM 18 +#define XCHAL_CP0_SA_LIST(s) \ + XCHAL_SA_REG(s,0,0,1,0, fcr, 4, 4, 4,0x03E8, ur,232, 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,1,0, fsr, 4, 4, 4,0x03E9, ur,233, 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f0, 4, 4, 4,0x0030, f,0 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f1, 4, 4, 4,0x0031, f,1 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f2, 4, 4, 4,0x0032, f,2 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f3, 4, 4, 4,0x0033, f,3 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f4, 4, 4, 4,0x0034, f,4 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f5, 4, 4, 4,0x0035, f,5 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f6, 4, 4, 4,0x0036, f,6 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f7, 4, 4, 4,0x0037, f,7 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f8, 4, 4, 4,0x0038, f,8 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f9, 4, 4, 4,0x0039, f,9 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f10, 4, 4, 4,0x003A, f,10 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f11, 4, 4, 4,0x003B, f,11 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f12, 4, 4, 4,0x003C, f,12 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f13, 4, 4, 4,0x003D, f,13 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f14, 4, 4, 4,0x003E, f,14 , 32,0,0,0) \ + XCHAL_SA_REG(s,0,0,2,0, f15, 4, 4, 4,0x003F, f,15 , 32,0,0,0) + +#define XCHAL_CP1_SA_NUM 0 +#define XCHAL_CP1_SA_LIST(s) /* empty */ + +#define XCHAL_CP2_SA_NUM 0 +#define XCHAL_CP2_SA_LIST(s) /* empty */ + +#define XCHAL_CP3_SA_NUM 0 +#define XCHAL_CP3_SA_LIST(s) /* empty */ + +#define XCHAL_CP4_SA_NUM 0 +#define XCHAL_CP4_SA_LIST(s) /* empty */ + +#define XCHAL_CP5_SA_NUM 0 +#define XCHAL_CP5_SA_LIST(s) /* empty */ + +#define XCHAL_CP6_SA_NUM 0 +#define XCHAL_CP6_SA_LIST(s) /* empty */ + +#define XCHAL_CP7_SA_NUM 0 +#define XCHAL_CP7_SA_LIST(s) /* empty */ + +/* Byte length of instruction from its first nibble (op0 field), per FLIX. */ +#define XCHAL_OP0_FORMAT_LENGTHS 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3 +/* Byte length of instruction from its first byte, per FLIX. */ +#define XCHAL_BYTE0_FORMAT_LENGTHS \ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3,\ + 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3, 3,3,3,3,3,3,3,3,2,2,2,2,2,2,3,3 + +#endif /*_XTENSA_CORE_TIE_H*/ + diff --git a/components/esp32/include/xtensa/core-macros.h b/components/esp32/include/xtensa/core-macros.h new file mode 100755 index 000000000..663d29478 --- /dev/null +++ b/components/esp32/include/xtensa/core-macros.h @@ -0,0 +1,456 @@ +/* + * xtensa/core-macros.h -- C specific definitions + * that depend on CORE configuration + */ + +/* + * Copyright (c) 2012 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_CACHE_H +#define XTENSA_CACHE_H + +#include + +/* Only define things for C code. */ +#if !defined(_ASMLANGUAGE) && !defined(_NOCLANGUAGE) && !defined(__ASSEMBLER__) + + + +/*************************** CACHE ***************************/ + +/* All the macros are in the lower case now and some of them + * share the name with the existing functions from hal.h. + * Including this header file will define XTHAL_USE_CACHE_MACROS + * which directs hal.h not to use the functions. + * + +/* + * Single-cache-line operations in C-callable inline assembly. + * Essentially macro versions (uppercase) of: + * + * xthal_icache_line_invalidate(void *addr); + * xthal_icache_line_lock(void *addr); + * xthal_icache_line_unlock(void *addr); + * xthal_icache_sync(void); + * + * NOTE: unlike the above functions, the following macros do NOT + * execute the xthal_icache_sync() as part of each line operation. + * This sync must be called explicitly by the caller. This is to + * allow better optimization when operating on more than one line. + * + * xthal_dcache_line_invalidate(void *addr); + * xthal_dcache_line_writeback(void *addr); + * xthal_dcache_line_writeback_inv(void *addr); + * xthal_dcache_line_lock(void *addr); + * xthal_dcache_line_unlock(void *addr); + * xthal_dcache_sync(void); + * xthal_dcache_line_prefetch_for_write(void *addr); + * xthal_dcache_line_prefetch_for_read(void *addr); + * + * All are made memory-barriers, given that's how they're typically used + * (ops operate on a whole line, so clobbers all memory not just *addr). + * + * NOTE: All the block block cache ops and line prefetches are implemented + * using intrinsics so they are better optimized regarding memory barriers etc. + * + * All block downgrade functions exist in two forms: with and without + * the 'max' parameter: This parameter allows compiler to optimize + * the functions whenever the parameter is smaller than the cache size. + * + * xthal_dcache_block_invalidate(void *addr, unsigned size); + * xthal_dcache_block_writeback(void *addr, unsigned size); + * xthal_dcache_block_writeback_inv(void *addr, unsigned size); + * xthal_dcache_block_invalidate_max(void *addr, unsigned size, unsigned max); + * xthal_dcache_block_writeback_max(void *addr, unsigned size, unsigned max); + * xthal_dcache_block_writeback_inv_max(void *addr, unsigned size, unsigned max); + * + * xthal_dcache_block_prefetch_for_read(void *addr, unsigned size); + * xthal_dcache_block_prefetch_for_write(void *addr, unsigned size); + * xthal_dcache_block_prefetch_modify(void *addr, unsigned size); + * xthal_dcache_block_prefetch_read_write(void *addr, unsigned size); + * xthal_dcache_block_prefetch_for_read_grp(void *addr, unsigned size); + * xthal_dcache_block_prefetch_for_write_grp(void *addr, unsigned size); + * xthal_dcache_block_prefetch_modify_grp(void *addr, unsigned size); + * xthal_dcache_block_prefetch_read_write_grp(void *addr, unsigned size) + * + * xthal_dcache_block_wait(); + * xthal_dcache_block_required_wait(); + * xthal_dcache_block_abort(); + * xthal_dcache_block_prefetch_end(); + * xthal_dcache_block_newgrp(); + */ + +/*** INSTRUCTION CACHE ***/ + +#define XTHAL_USE_CACHE_MACROS + +#if XCHAL_ICACHE_SIZE > 0 +# define xthal_icache_line_invalidate(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("ihi %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +#else +# define xthal_icache_line_invalidate(addr) do {/*nothing*/} while(0) +#endif + +#if XCHAL_ICACHE_SIZE > 0 && XCHAL_ICACHE_LINE_LOCKABLE +# define xthal_icache_line_lock(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("ipfl %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +# define xthal_icache_line_unlock(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("ihu %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +#else +# define xthal_icache_line_lock(addr) do {/*nothing*/} while(0) +# define xthal_icache_line_unlock(addr) do {/*nothing*/} while(0) +#endif + +/* + * Even if a config doesn't have caches, an isync is still needed + * when instructions in any memory are modified, whether by a loader + * or self-modifying code. Therefore, this macro always produces + * an isync, whether or not an icache is present. + */ +#define xthal_icache_sync() \ + __asm__ __volatile__("isync":::"memory") + + +/*** DATA CACHE ***/ + +#if XCHAL_DCACHE_SIZE > 0 + +# include + +# define xthal_dcache_line_invalidate(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("dhi %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +# define xthal_dcache_line_writeback(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("dhwb %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +# define xthal_dcache_line_writeback_inv(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("dhwbi %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +# define xthal_dcache_sync() \ + __asm__ __volatile__("" /*"dsync"?*/:::"memory") +# define xthal_dcache_line_prefetch_for_read(addr) do { \ + XT_DPFR((const int*)addr, 0); \ + } while(0) +#else +# define xthal_dcache_line_invalidate(addr) do {/*nothing*/} while(0) +# define xthal_dcache_line_writeback(addr) do {/*nothing*/} while(0) +# define xthal_dcache_line_writeback_inv(addr) do {/*nothing*/} while(0) +# define xthal_dcache_sync() __asm__ __volatile__("":::"memory") +# define xthal_dcache_line_prefetch_for_read(addr) do {/*nothing*/} while(0) +#endif + +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_LINE_LOCKABLE +# define xthal_dcache_line_lock(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("dpfl %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +# define xthal_dcache_line_unlock(addr) do { void *__a = (void*)(addr); \ + __asm__ __volatile__("dhu %0, 0" :: "a"(__a) : "memory"); \ + } while(0) +#else +# define xthal_dcache_line_lock(addr) do {/*nothing*/} while(0) +# define xthal_dcache_line_unlock(addr) do {/*nothing*/} while(0) +#endif + +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_IS_WRITEBACK + +# define xthal_dcache_line_prefetch_for_write(addr) do { \ + XT_DPFW((const int*)addr, 0); \ + } while(0) +#else +# define xthal_dcache_line_prefetch_for_write(addr) do {/*nothing*/} while(0) +#endif + + +/***** Block Operations *****/ + +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_HAVE_CACHE_BLOCKOPS + +/* upgrades */ + +# define _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, type) \ + { \ + type((const int*)addr, size); \ + } + +/*downgrades */ + +# define _XTHAL_DCACHE_BLOCK_DOWNGRADE(addr, size, type) \ + unsigned _s = size; \ + unsigned _a = addr; \ + do { \ + unsigned __s = (_s > XCHAL_DCACHE_SIZE) ? \ + XCHAL_DCACHE_SIZE : _s; \ + type((const int*)_a, __s); \ + _s -= __s; \ + _a += __s; \ + } while(_s > 0); + +# define _XTHAL_DCACHE_BLOCK_DOWNGRADE_MAX(addr, size, type, max) \ + if (max <= XCHAL_DCACHE_SIZE) { \ + unsigned _s = size; \ + unsigned _a = addr; \ + type((const int*)_a, _s); \ + } \ + else { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE(addr, size, type); \ + } + +# define xthal_dcache_block_invalidate(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE(addr, size, XT_DHI_B); \ + } while(0) +# define xthal_dcache_block_writeback(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE(addr, size, XT_DHWB_B); \ + } while(0) +# define xthal_dcache_block_writeback_inv(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE(addr, size, XT_DHWBI_B); \ + } while(0) + +# define xthal_dcache_block_invalidate_max(addr, size, max) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE_MAX(addr, size, XT_DHI_B, max); \ + } while(0) +# define xthal_dcache_block_writeback_max(addr, size, max) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE_MAX(addr, size, XT_DHWB_B, max); \ + } while(0) +# define xthal_dcache_block_writeback_inv_max(addr, size, max) do { \ + _XTHAL_DCACHE_BLOCK_DOWNGRADE_MAX(addr, size, XT_DHWBI_B, max); \ + } while(0) + +/* upgrades that are performed even with write-thru caches */ + +# define xthal_dcache_block_prefetch_read_write(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFW_B); \ + } while(0) +# define xthal_dcache_block_prefetch_read_write_grp(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFW_BF); \ + } while(0) +# define xthal_dcache_block_prefetch_for_read(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFR_B); \ + } while(0) +# define xthal_dcache_block_prefetch_for_read_grp(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFR_BF); \ + } while(0) + +/* abort all or end optional block cache operations */ +# define xthal_dcache_block_abort() do { \ + XT_PFEND_A(); \ + } while(0) +# define xthal_dcache_block_end() do { \ + XT_PFEND_O(); \ + } while(0) + +/* wait for all/required block cache operations to finish */ +# define xthal_dcache_block_wait() do { \ + XT_PFWAIT_A(); \ + } while(0) +# define xthal_dcache_block_required_wait() do { \ + XT_PFWAIT_R(); \ + } while(0) +/* Start a new group */ +# define xthal_dcache_block_newgrp() do { \ + XT_PFNXT_F(); \ + } while(0) +#else +# define xthal_dcache_block_invalidate(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_writeback(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_writeback_inv(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_invalidate_max(addr, size, max) do {/*nothing*/} while(0) +# define xthal_dcache_block_writeback_max(addr, size, max) do {/*nothing*/} while(0) +# define xthal_dcache_block_writeback_inv_max(addr, size, max) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_read_write(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_read_write_grp(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_for_read(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_for_read_grp(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_end() do {/*nothing*/} while(0) +# define xthal_dcache_block_abort() do {/*nothing*/} while(0) +# define xthal_dcache_block_wait() do {/*nothing*/} while(0) +# define xthal_dcache_block_required_wait() do {/*nothing*/} while(0) +# define xthal_dcache_block_newgrp() do {/*nothing*/} while(0) +#endif + +#if XCHAL_DCACHE_SIZE > 0 && XCHAL_HAVE_CACHE_BLOCKOPS && XCHAL_DCACHE_IS_WRITEBACK + +# define xthal_dcache_block_prefetch_for_write(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFW_B); \ + } while(0) +# define xthal_dcache_block_prefetch_modify(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFM_B); \ + } while(0) +# define xthal_dcache_block_prefetch_for_write_grp(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFW_BF); \ + } while(0) +# define xthal_dcache_block_prefetch_modify_grp(addr, size) do { \ + _XTHAL_DCACHE_BLOCK_UPGRADE(addr, size, XT_DPFM_BF); \ + } while(0) +#else +# define xthal_dcache_block_prefetch_for_write(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_modify(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_for_write_grp(addr, size) do {/*nothing*/} while(0) +# define xthal_dcache_block_prefetch_modify_grp(addr, size) do {/*nothing*/} while(0) +#endif + +/*************************** INTERRUPTS ***************************/ + +/* + * Macro versions of: + * unsigned xthal_get_intenable( void ); + * void xthal_set_intenable( unsigned ); + * unsigned xthal_get_interrupt( void ); + * void xthal_set_intset( unsigned ); + * void xthal_set_intclear( unsigned ); + * unsigned xthal_get_ccount(void); + * void xthal_set_ccompare(int, unsigned); + * unsigned xthal_get_ccompare(int); + * + * NOTE: for {set,get}_ccompare, the first argument MUST be a decimal constant. + */ + +#if XCHAL_HAVE_INTERRUPTS +# define XTHAL_GET_INTENABLE() ({ int __intenable; \ + __asm__("rsr.intenable %0" : "=a"(__intenable)); \ + __intenable; }) +# define XTHAL_SET_INTENABLE(v) do { int __intenable = (int)(v); \ + __asm__ __volatile__("wsr.intenable %0" :: "a"(__intenable):"memory"); \ + } while(0) +# define XTHAL_GET_INTERRUPT() ({ int __interrupt; \ + __asm__("rsr.interrupt %0" : "=a"(__interrupt)); \ + __interrupt; }) +# define XTHAL_SET_INTSET(v) do { int __interrupt = (int)(v); \ + __asm__ __volatile__("wsr.intset %0" :: "a"(__interrupt):"memory"); \ + } while(0) +# define XTHAL_SET_INTCLEAR(v) do { int __interrupt = (int)(v); \ + __asm__ __volatile__("wsr.intclear %0" :: "a"(__interrupt):"memory"); \ + } while(0) +# define XTHAL_GET_CCOUNT() ({ int __ccount; \ + __asm__("rsr.ccount %0" : "=a"(__ccount)); \ + __ccount; }) +# define XTHAL_SET_CCOUNT(v) do { int __ccount = (int)(v); \ + __asm__ __volatile__("wsr.ccount %0" :: "a"(__ccount):"memory"); \ + } while(0) +# define _XTHAL_GET_CCOMPARE(n) ({ int __ccompare; \ + __asm__("rsr.ccompare" #n " %0" : "=a"(__ccompare)); \ + __ccompare; }) +# define XTHAL_GET_CCOMPARE(n) _XTHAL_GET_CCOMPARE(n) +# define _XTHAL_SET_CCOMPARE(n,v) do { int __ccompare = (int)(v); \ + __asm__ __volatile__("wsr.ccompare" #n " %0 ; esync" :: "a"(__ccompare):"memory"); \ + } while(0) +# define XTHAL_SET_CCOMPARE(n,v) _XTHAL_SET_CCOMPARE(n,v) +#else +# define XTHAL_GET_INTENABLE() 0 +# define XTHAL_SET_INTENABLE(v) do {/*nothing*/} while(0) +# define XTHAL_GET_INTERRUPT() 0 +# define XTHAL_SET_INTSET(v) do {/*nothing*/} while(0) +# define XTHAL_SET_INTCLEAR(v) do {/*nothing*/} while(0) +# define XTHAL_GET_CCOUNT() 0 +# define XTHAL_SET_CCOUNT(v) do {/*nothing*/} while(0) +# define XTHAL_GET_CCOMPARE(n) 0 +# define XTHAL_SET_CCOMPARE(n,v) do {/*nothing*/} while(0) +#endif + + +/*************************** MISC ***************************/ + +/* + * Macro or inline versions of: + * void xthal_clear_regcached_code( void ); + * unsigned xthal_get_prid( void ); + * unsigned xthal_compare_and_set( int *addr, int testval, int setval ); + */ + +#if XCHAL_HAVE_LOOPS +# define XTHAL_CLEAR_REGCACHED_CODE() \ + __asm__ __volatile__("wsr.lcount %0" :: "a"(0) : "memory") +#else +# define XTHAL_CLEAR_REGCACHED_CODE() do {/*nothing*/} while(0) +#endif + +#if XCHAL_HAVE_PRID +# define XTHAL_GET_PRID() ({ int __prid; \ + __asm__("rsr.prid %0" : "=a"(__prid)); \ + __prid; }) +#else +# define XTHAL_GET_PRID() 0 +#endif + + +static inline unsigned XTHAL_COMPARE_AND_SET( int *addr, int testval, int setval ) +{ + int result; + +#if XCHAL_HAVE_S32C1I && XCHAL_HW_MIN_VERSION_MAJOR >= 2200 + __asm__ __volatile__ ( + " wsr.scompare1 %2 \n" + " s32c1i %0, %3, 0 \n" + : "=a"(result) : "0" (setval), "a" (testval), "a" (addr) + : "memory"); +#elif XCHAL_HAVE_INTERRUPTS + int tmp; + __asm__ __volatile__ ( + " rsil %4, 15 \n" // %4 == saved ps + " l32i %0, %3, 0 \n" // %0 == value to test, return val + " bne %2, %0, 9f \n" // test + " s32i %1, %3, 0 \n" // write the new value + "9: wsr.ps %4 ; rsync \n" // restore the PS + : "=a"(result) + : "0" (setval), "a" (testval), "a" (addr), "a" (tmp) + : "memory"); +#else + __asm__ __volatile__ ( + " l32i %0, %3, 0 \n" // %0 == value to test, return val + " bne %2, %0, 9f \n" // test + " s32i %1, %3, 0 \n" // write the new value + "9: \n" + : "=a"(result) : "0" (setval), "a" (testval), "a" (addr) + : "memory"); +#endif + return result; +} + +#if XCHAL_HAVE_EXTERN_REGS + +static inline unsigned XTHAL_RER (unsigned int reg) +{ + unsigned result; + + __asm__ __volatile__ ( + " rer %0, %1" + : "=a" (result) : "a" (reg) : "memory"); + + return result; +} + +static inline void XTHAL_WER (unsigned reg, unsigned value) +{ + __asm__ __volatile__ ( + " wer %0, %1" + : : "a" (value), "a" (reg) : "memory"); +} + +#endif /* XCHAL_HAVE_EXTERN_REGS */ + +#endif /* C code */ + +#endif /*XTENSA_CACHE_H*/ + diff --git a/components/esp32/include/xtensa/coreasm.h b/components/esp32/include/xtensa/coreasm.h new file mode 100755 index 000000000..e41e04d1b --- /dev/null +++ b/components/esp32/include/xtensa/coreasm.h @@ -0,0 +1,939 @@ +/* + * xtensa/coreasm.h -- assembler-specific definitions that depend on CORE configuration + * + * Source for configuration-independent binaries (which link in a + * configuration-specific HAL library) must NEVER include this file. + * It is perfectly normal, however, for the HAL itself to include this file. + * + * This file must NOT include xtensa/config/system.h. Any assembler + * header file that depends on system information should likely go + * in a new systemasm.h (or sysasm.h) header file. + * + * NOTE: macro beqi32 is NOT configuration-dependent, and is placed + * here until we have a proper configuration-independent header file. + */ + +/* $Id: //depot/rel/Eaglenest/Xtensa/OS/include/xtensa/coreasm.h#3 $ */ + +/* + * Copyright (c) 2000-2014 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_COREASM_H +#define XTENSA_COREASM_H + +/* + * Tell header files this is assembly source, so they can avoid non-assembler + * definitions (eg. C types etc): + */ +#ifndef _ASMLANGUAGE /* conditionalize to avoid cpp warnings (3rd parties might use same macro) */ +#define _ASMLANGUAGE +#endif + +#include +#include +#include + +/* + * Assembly-language specific definitions (assembly macros, etc.). + */ + +/*---------------------------------------------------------------------- + * find_ms_setbit + * + * This macro finds the most significant bit that is set in + * and return its index + in , or - 1 if is zero. + * The index counts starting at zero for the lsbit, so the return + * value ranges from -1 (no bit set) to +31 (msbit set). + * + * Parameters: + * destination address register (any register) + * source address register + * temporary address register (must be different than ) + * constant value added to result (usually 0 or 1) + * On entry: + * = undefined if different than + * = value whose most significant set bit is to be found + * = undefined + * no other registers are used by this macro. + * On exit: + * = + index of msbit set in original , + * = - 1 if original was zero. + * clobbered (if not ) + * clobbered (if not ) + * Example: + * find_ms_setbit a0, a4, a0, 0 -- return in a0 index of msbit set in a4 + */ + + .macro find_ms_setbit ad, as, at, base +#if XCHAL_HAVE_NSA + movi \at, 31+\base + nsau \as, \as // get index of \as, numbered from msbit (32 if absent) + sub \ad, \at, \as // get numbering from lsbit (0..31, -1 if absent) +#else /* XCHAL_HAVE_NSA */ + movi \at, \base // start with result of 0 (point to lsbit of 32) + + beqz \as, 2f // special case for zero argument: return -1 + bltui \as, 0x10000, 1f // is it one of the 16 lsbits? (if so, check lower 16 bits) + addi \at, \at, 16 // no, increment result to upper 16 bits (of 32) + //srli \as, \as, 16 // check upper half (shift right 16 bits) + extui \as, \as, 16, 16 // check upper half (shift right 16 bits) +1: bltui \as, 0x100, 1f // is it one of the 8 lsbits? (if so, check lower 8 bits) + addi \at, \at, 8 // no, increment result to upper 8 bits (of 16) + srli \as, \as, 8 // shift right to check upper 8 bits +1: bltui \as, 0x10, 1f // is it one of the 4 lsbits? (if so, check lower 4 bits) + addi \at, \at, 4 // no, increment result to upper 4 bits (of 8) + srli \as, \as, 4 // shift right 4 bits to check upper half +1: bltui \as, 0x4, 1f // is it one of the 2 lsbits? (if so, check lower 2 bits) + addi \at, \at, 2 // no, increment result to upper 2 bits (of 4) + srli \as, \as, 2 // shift right 2 bits to check upper half +1: bltui \as, 0x2, 1f // is it the lsbit? + addi \at, \at, 2 // no, increment result to upper bit (of 2) +2: addi \at, \at, -1 // (from just above: add 1; from beqz: return -1) + //srli \as, \as, 1 +1: // done! \at contains index of msbit set (or -1 if none set) + .if 0x\ad - 0x\at // destination different than \at ? (works because regs are a0-a15) + mov \ad, \at // then move result to \ad + .endif +#endif /* XCHAL_HAVE_NSA */ + .endm // find_ms_setbit + +/*---------------------------------------------------------------------- + * find_ls_setbit + * + * This macro finds the least significant bit that is set in , + * and return its index in . + * Usage is the same as for the find_ms_setbit macro. + * Example: + * find_ls_setbit a0, a4, a0, 0 -- return in a0 index of lsbit set in a4 + */ + + .macro find_ls_setbit ad, as, at, base + neg \at, \as // keep only the least-significant bit that is set... + and \as, \at, \as // ... in \as + find_ms_setbit \ad, \as, \at, \base + .endm // find_ls_setbit + +/*---------------------------------------------------------------------- + * find_ls_one + * + * Same as find_ls_setbit with base zero. + * Source (as) and destination (ad) registers must be different. + * Provided for backward compatibility. + */ + + .macro find_ls_one ad, as + find_ls_setbit \ad, \as, \ad, 0 + .endm // find_ls_one + +/*---------------------------------------------------------------------- + * floop, floopnez, floopgtz, floopend + * + * These macros are used for fast inner loops that + * work whether or not the Loops options is configured. + * If the Loops option is configured, they simply use + * the zero-overhead LOOP instructions; otherwise + * they use explicit decrement and branch instructions. + * + * They are used in pairs, with floop, floopnez or floopgtz + * at the beginning of the loop, and floopend at the end. + * + * Each pair of loop macro calls must be given the loop count + * address register and a unique label for that loop. + * + * Example: + * + * movi a3, 16 // loop 16 times + * floop a3, myloop1 + * : + * bnez a7, end1 // exit loop if a7 != 0 + * : + * floopend a3, myloop1 + * end1: + * + * Like the LOOP instructions, these macros cannot be + * nested, must include at least one instruction, + * cannot call functions inside the loop, etc. + * The loop can be exited by jumping to the instruction + * following floopend (or elsewhere outside the loop), + * or continued by jumping to a NOP instruction placed + * immediately before floopend. + * + * Unlike LOOP instructions, the register passed to floop* + * cannot be used inside the loop, because it is used as + * the loop counter if the Loops option is not configured. + * And its value is undefined after exiting the loop. + * And because the loop counter register is active inside + * the loop, you can't easily use this construct to loop + * across a register file using ROTW as you might with LOOP + * instructions, unless you copy the loop register along. + */ + + /* Named label version of the macros: */ + + .macro floop ar, endlabel + floop_ \ar, .Lfloopstart_\endlabel, .Lfloopend_\endlabel + .endm + + .macro floopnez ar, endlabel + floopnez_ \ar, .Lfloopstart_\endlabel, .Lfloopend_\endlabel + .endm + + .macro floopgtz ar, endlabel + floopgtz_ \ar, .Lfloopstart_\endlabel, .Lfloopend_\endlabel + .endm + + .macro floopend ar, endlabel + floopend_ \ar, .Lfloopstart_\endlabel, .Lfloopend_\endlabel + .endm + + /* Numbered local label version of the macros: */ +#if 0 /*UNTESTED*/ + .macro floop89 ar + floop_ \ar, 8, 9f + .endm + + .macro floopnez89 ar + floopnez_ \ar, 8, 9f + .endm + + .macro floopgtz89 ar + floopgtz_ \ar, 8, 9f + .endm + + .macro floopend89 ar + floopend_ \ar, 8b, 9 + .endm +#endif /*0*/ + + /* Underlying version of the macros: */ + + .macro floop_ ar, startlabel, endlabelref + .ifdef _infloop_ + .if _infloop_ + .err // Error: floop cannot be nested + .endif + .endif + .set _infloop_, 1 +#if XCHAL_HAVE_LOOPS + loop \ar, \endlabelref +#else /* XCHAL_HAVE_LOOPS */ +\startlabel: + addi \ar, \ar, -1 +#endif /* XCHAL_HAVE_LOOPS */ + .endm // floop_ + + .macro floopnez_ ar, startlabel, endlabelref + .ifdef _infloop_ + .if _infloop_ + .err // Error: floopnez cannot be nested + .endif + .endif + .set _infloop_, 1 +#if XCHAL_HAVE_LOOPS + loopnez \ar, \endlabelref +#else /* XCHAL_HAVE_LOOPS */ + beqz \ar, \endlabelref +\startlabel: + addi \ar, \ar, -1 +#endif /* XCHAL_HAVE_LOOPS */ + .endm // floopnez_ + + .macro floopgtz_ ar, startlabel, endlabelref + .ifdef _infloop_ + .if _infloop_ + .err // Error: floopgtz cannot be nested + .endif + .endif + .set _infloop_, 1 +#if XCHAL_HAVE_LOOPS + loopgtz \ar, \endlabelref +#else /* XCHAL_HAVE_LOOPS */ + bltz \ar, \endlabelref + beqz \ar, \endlabelref +\startlabel: + addi \ar, \ar, -1 +#endif /* XCHAL_HAVE_LOOPS */ + .endm // floopgtz_ + + + .macro floopend_ ar, startlabelref, endlabel + .ifndef _infloop_ + .err // Error: floopend without matching floopXXX + .endif + .ifeq _infloop_ + .err // Error: floopend without matching floopXXX + .endif + .set _infloop_, 0 +#if ! XCHAL_HAVE_LOOPS + bnez \ar, \startlabelref +#endif /* XCHAL_HAVE_LOOPS */ +\endlabel: + .endm // floopend_ + +/*---------------------------------------------------------------------- + * crsil -- conditional RSIL (read/set interrupt level) + * + * Executes the RSIL instruction if it exists, else just reads PS. + * The RSIL instruction does not exist in the new exception architecture + * if the interrupt option is not selected. + */ + + .macro crsil ar, newlevel +#if XCHAL_HAVE_OLD_EXC_ARCH || XCHAL_HAVE_INTERRUPTS + rsil \ar, \newlevel +#else + rsr \ar, PS +#endif + .endm // crsil + +/*---------------------------------------------------------------------- + * safe_movi_a0 -- move constant into a0 when L32R is not safe + * + * This macro is typically used by interrupt/exception handlers. + * Loads a 32-bit constant in a0, without using any other register, + * and without corrupting the LITBASE register, even when the + * value of the LITBASE register is unknown (eg. when application + * code and interrupt/exception handling code are built independently, + * and thus with independent values of the LITBASE register; + * debug monitors are one example of this). + * + * Worst-case size of resulting code: 17 bytes. + */ + + .macro safe_movi_a0 constant +#if XCHAL_HAVE_ABSOLUTE_LITERALS + /* Contort a PC-relative literal load even though we may be in litbase-relative mode: */ + j 1f + .begin no-transform // ensure what follows is assembled exactly as-is + .align 4 // ensure constant and call0 target ... + .byte 0 // ... are 4-byte aligned (call0 instruction is 3 bytes long) +1: call0 2f // read PC (that follows call0) in a0 + .long \constant // 32-bit constant to load into a0 +2: + .end no-transform + l32i a0, a0, 0 // load constant +#else + movi a0, \constant // no LITBASE, can assume PC-relative L32R +#endif + .endm + + + + +/*---------------------------------------------------------------------- + * window_spill{4,8,12} + * + * These macros spill callers' register windows to the stack. + * They work for both privileged and non-privileged tasks. + * Must be called from a windowed ABI context, eg. within + * a windowed ABI function (ie. valid stack frame, window + * exceptions enabled, not in exception mode, etc). + * + * This macro requires a single invocation of the window_spill_common + * macro in the same assembly unit and section. + * + * Note that using window_spill{4,8,12} macros is more efficient + * than calling a function implemented using window_spill_function, + * because the latter needs extra code to figure out the size of + * the call to the spilling function. + * + * Example usage: + * + * .text + * .align 4 + * .global some_function + * .type some_function,@function + * some_function: + * entry a1, 16 + * : + * : + * + * window_spill4 // Spill windows of some_function's callers; preserves a0..a3 only; + * // to use window_spill{8,12} in this example function we'd have + * // to increase space allocated by the entry instruction, because + * // 16 bytes only allows call4; 32 or 48 bytes (+locals) are needed + * // for call8/window_spill8 or call12/window_spill12 respectively. + * + * : + * + * retw + * + * window_spill_common // instantiates code used by window_spill4 + * + * + * On entry: + * none (if window_spill4) + * stack frame has enough space allocated for call8 (if window_spill8) + * stack frame has enough space allocated for call12 (if window_spill12) + * On exit: + * a4..a15 clobbered (if window_spill4) + * a8..a15 clobbered (if window_spill8) + * a12..a15 clobbered (if window_spill12) + * no caller windows are in live registers + */ + + .macro window_spill4 +#if XCHAL_HAVE_WINDOWED +# if XCHAL_NUM_AREGS == 16 + movi a15, 0 // for 16-register files, no need to call to reach the end +# elif XCHAL_NUM_AREGS == 32 + call4 .L__wdwspill_assist28 // call deep enough to clear out any live callers +# elif XCHAL_NUM_AREGS == 64 + call4 .L__wdwspill_assist60 // call deep enough to clear out any live callers +# endif +#endif + .endm // window_spill4 + + .macro window_spill8 +#if XCHAL_HAVE_WINDOWED +# if XCHAL_NUM_AREGS == 16 + movi a15, 0 // for 16-register files, no need to call to reach the end +# elif XCHAL_NUM_AREGS == 32 + call8 .L__wdwspill_assist24 // call deep enough to clear out any live callers +# elif XCHAL_NUM_AREGS == 64 + call8 .L__wdwspill_assist56 // call deep enough to clear out any live callers +# endif +#endif + .endm // window_spill8 + + .macro window_spill12 +#if XCHAL_HAVE_WINDOWED +# if XCHAL_NUM_AREGS == 16 + movi a15, 0 // for 16-register files, no need to call to reach the end +# elif XCHAL_NUM_AREGS == 32 + call12 .L__wdwspill_assist20 // call deep enough to clear out any live callers +# elif XCHAL_NUM_AREGS == 64 + call12 .L__wdwspill_assist52 // call deep enough to clear out any live callers +# endif +#endif + .endm // window_spill12 + + +/*---------------------------------------------------------------------- + * window_spill_function + * + * This macro outputs a function that will spill its caller's callers' + * register windows to the stack. Eg. it could be used to implement + * a version of xthal_window_spill() that works in non-privileged tasks. + * This works for both privileged and non-privileged tasks. + * + * Typical usage: + * + * .text + * .align 4 + * .global my_spill_function + * .type my_spill_function,@function + * my_spill_function: + * window_spill_function + * + * On entry to resulting function: + * none + * On exit from resulting function: + * none (no caller windows are in live registers) + */ + + .macro window_spill_function +#if XCHAL_HAVE_WINDOWED +# if XCHAL_NUM_AREGS == 32 + entry sp, 48 + bbci.l a0, 31, 1f // branch if called with call4 + bbsi.l a0, 30, 2f // branch if called with call12 + call8 .L__wdwspill_assist16 // called with call8, only need another 8 + retw +1: call12 .L__wdwspill_assist16 // called with call4, only need another 12 + retw +2: call4 .L__wdwspill_assist16 // called with call12, only need another 4 + retw +# elif XCHAL_NUM_AREGS == 64 + entry sp, 48 + bbci.l a0, 31, 1f // branch if called with call4 + bbsi.l a0, 30, 2f // branch if called with call12 + call4 .L__wdwspill_assist52 // called with call8, only need a call4 + retw +1: call8 .L__wdwspill_assist52 // called with call4, only need a call8 + retw +2: call12 .L__wdwspill_assist40 // called with call12, can skip a call12 + retw +# elif XCHAL_NUM_AREGS == 16 + entry sp, 16 + bbci.l a0, 31, 1f // branch if called with call4 + bbsi.l a0, 30, 2f // branch if called with call12 + movi a7, 0 // called with call8 + retw +1: movi a11, 0 // called with call4 +2: retw // if called with call12, everything already spilled + +// movi a15, 0 // trick to spill all but the direct caller +// j 1f +// // The entry instruction is magical in the assembler (gets auto-aligned) +// // so we have to jump to it to avoid falling through the padding. +// // We need entry/retw to know where to return. +//1: entry sp, 16 +// retw +# else +# error "unrecognized address register file size" +# endif + +#endif /* XCHAL_HAVE_WINDOWED */ + window_spill_common + .endm // window_spill_function + +/*---------------------------------------------------------------------- + * window_spill_common + * + * Common code used by any number of invocations of the window_spill## + * and window_spill_function macros. + * + * Must be instantiated exactly once within a given assembly unit, + * within call/j range of and same section as window_spill## + * macro invocations for that assembly unit. + * (Is automatically instantiated by the window_spill_function macro.) + */ + + .macro window_spill_common +#if XCHAL_HAVE_WINDOWED && (XCHAL_NUM_AREGS == 32 || XCHAL_NUM_AREGS == 64) + .ifndef .L__wdwspill_defined +# if XCHAL_NUM_AREGS >= 64 +.L__wdwspill_assist60: + entry sp, 32 + call8 .L__wdwspill_assist52 + retw +.L__wdwspill_assist56: + entry sp, 16 + call4 .L__wdwspill_assist52 + retw +.L__wdwspill_assist52: + entry sp, 48 + call12 .L__wdwspill_assist40 + retw +.L__wdwspill_assist40: + entry sp, 48 + call12 .L__wdwspill_assist28 + retw +# endif +.L__wdwspill_assist28: + entry sp, 48 + call12 .L__wdwspill_assist16 + retw +.L__wdwspill_assist24: + entry sp, 32 + call8 .L__wdwspill_assist16 + retw +.L__wdwspill_assist20: + entry sp, 16 + call4 .L__wdwspill_assist16 + retw +.L__wdwspill_assist16: + entry sp, 16 + movi a15, 0 + retw + .set .L__wdwspill_defined, 1 + .endif +#endif /* XCHAL_HAVE_WINDOWED with 32 or 64 aregs */ + .endm // window_spill_common + +/*---------------------------------------------------------------------- + * beqi32 + * + * macro implements version of beqi for arbitrary 32-bit immediate value + * + * beqi32 ax, ay, imm32, label + * + * Compares value in register ax with imm32 value and jumps to label if + * equal. Clobbers register ay if needed + * + */ + .macro beqi32 ax, ay, imm, label + .ifeq ((\imm-1) & ~7) // 1..8 ? + beqi \ax, \imm, \label + .else + .ifeq (\imm+1) // -1 ? + beqi \ax, \imm, \label + .else + .ifeq (\imm) // 0 ? + beqz \ax, \label + .else + // We could also handle immediates 10,12,16,32,64,128,256 + // but it would be a long macro... + movi \ay, \imm + beq \ax, \ay, \label + .endif + .endif + .endif + .endm // beqi32 + +/*---------------------------------------------------------------------- + * isync_retw_nop + * + * This macro must be invoked immediately after ISYNC if ISYNC + * would otherwise be immediately followed by RETW (or other instruction + * modifying WindowBase or WindowStart), in a context where + * kernel vector mode may be selected, and level-one interrupts + * and window overflows may be enabled, on an XEA1 configuration. + * + * On hardware with erratum "XEA1KWIN" (see for details), + * XEA1 code must have at least one instruction between ISYNC and RETW if + * run in kernel vector mode with interrupts and window overflows enabled. + */ + .macro isync_retw_nop +#if XCHAL_MAYHAVE_ERRATUM_XEA1KWIN + nop +#endif + .endm + +/*---------------------------------------------------------------------- + * isync_erratum453 + * + * This macro must be invoked at certain points in the code, + * such as in exception and interrupt vectors in particular, + * to work around erratum 453. + */ + .macro isync_erratum453 +#if XCHAL_ERRATUM_453 + isync +#endif + .endm + + + +/*---------------------------------------------------------------------- + * abs + * + * implements abs on machines that do not have it configured + */ + +#if !XCHAL_HAVE_ABS + .macro abs arr, ars + .ifc \arr, \ars + //src equal dest is less efficient + bgez \arr, 1f + neg \arr, \arr +1: + .else + neg \arr, \ars + movgez \arr, \ars, \ars + .endif + .endm +#endif /* !XCHAL_HAVE_ABS */ + + +/*---------------------------------------------------------------------- + * addx2 + * + * implements addx2 on machines that do not have it configured + * + */ + +#if !XCHAL_HAVE_ADDX + .macro addx2 arr, ars, art + .ifc \arr, \art + .ifc \arr, \ars + // addx2 a, a, a (not common) + .err + .else + add \arr, \ars, \art + add \arr, \ars, \art + .endif + .else + //addx2 a, b, c + //addx2 a, a, b + //addx2 a, b, b + slli \arr, \ars, 1 + add \arr, \arr, \art + .endif + .endm +#endif /* !XCHAL_HAVE_ADDX */ + +/*---------------------------------------------------------------------- + * addx4 + * + * implements addx4 on machines that do not have it configured + * + */ + +#if !XCHAL_HAVE_ADDX + .macro addx4 arr, ars, art + .ifc \arr, \art + .ifc \arr, \ars + // addx4 a, a, a (not common) + .err + .else + //# addx4 a, b, a + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + .endif + .else + //addx4 a, b, c + //addx4 a, a, b + //addx4 a, b, b + slli \arr, \ars, 2 + add \arr, \arr, \art + .endif + .endm +#endif /* !XCHAL_HAVE_ADDX */ + +/*---------------------------------------------------------------------- + * addx8 + * + * implements addx8 on machines that do not have it configured + * + */ + +#if !XCHAL_HAVE_ADDX + .macro addx8 arr, ars, art + .ifc \arr, \art + .ifc \arr, \ars + //addx8 a, a, a (not common) + .err + .else + //addx8 a, b, a + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + add \arr, \ars, \art + .endif + .else + //addx8 a, b, c + //addx8 a, a, b + //addx8 a, b, b + slli \arr, \ars, 3 + add \arr, \arr, \art + .endif + .endm +#endif /* !XCHAL_HAVE_ADDX */ + + +/*---------------------------------------------------------------------- + * rfe_rfue + * + * Maps to RFUE on XEA1, and RFE on XEA2. No mapping on XEAX. + */ + +#if XCHAL_HAVE_XEA1 + .macro rfe_rfue + rfue + .endm +#elif XCHAL_HAVE_XEA2 + .macro rfe_rfue + rfe + .endm +#endif + + +/*---------------------------------------------------------------------- + * abi_entry + * + * Generate proper function entry sequence for the current ABI + * (windowed or call0). Takes care of allocating stack space (up to 1kB) + * and saving the return PC, if necessary. The corresponding abi_return + * macro does the corresponding stack deallocation and restoring return PC. + * + * Parameters are: + * + * locsize Number of bytes to allocate on the stack + * for local variables (and for args to pass to + * callees, if any calls are made). Defaults to zero. + * The macro rounds this up to a multiple of 16. + * NOTE: large values are allowed (e.g. up to 1 GB). + * + * callsize Maximum call size made by this function. + * Leave zero (default) for leaf functions, i.e. if + * this function makes no calls to other functions. + * Otherwise must be set to 4, 8, or 12 according + * to whether the "largest" call made is a call[x]4, + * call[x]8, or call[x]12 (for call0 ABI, it makes + * no difference whether this is set to 4, 8 or 12, + * but it must be set to one of these values). + * + * NOTE: It is up to the caller to align the entry point, declare the + * function symbol, make it global, etc. + * + * NOTE: This macro relies on assembler relaxation for large values + * of locsize. It might not work with the no-transform directive. + * NOTE: For the call0 ABI, this macro ensures SP is allocated or + * de-allocated cleanly, i.e. without temporarily allocating too much + * (or allocating negatively!) due to addi relaxation. + * + * NOTE: Generating the proper sequence and register allocation for + * making calls in an ABI independent manner is a separate topic not + * covered by this macro. + * + * NOTE: To access arguments, you can't use a fixed offset from SP. + * The offset depends on the ABI, whether the function is leaf, etc. + * The simplest method is probably to use the .locsz symbol, which + * is set by this macro to the actual number of bytes allocated on + * the stack, in other words, to the offset from SP to the arguments. + * E.g. for a function whose arguments are all 32-bit integers, you + * can get the 7th and 8th arguments (1st and 2nd args stored on stack) + * using: + * l32i a2, sp, .locsz + * l32i a3, sp, .locsz+4 + * (this example works as long as locsize is under L32I's offset limit + * of 1020 minus up to 48 bytes of ABI-specific stack usage; + * otherwise you might first need to do "addi a?, sp, .locsz" + * or similar sequence). + * + * NOTE: For call0 ABI, this macro (and abi_return) may clobber a9 + * (a caller-saved register). + * + * Examples: + * abi_entry + * abi_entry 5 + * abi_entry 22, 8 + * abi_entry 0, 4 + */ + + /* + * Compute .locsz and .callsz without emitting any instructions. + * Used by both abi_entry and abi_return. + * Assumes locsize >= 0. + */ + .macro abi_entry_size locsize=0, callsize=0 +#if XCHAL_HAVE_WINDOWED && !__XTENSA_CALL0_ABI__ + .ifeq \callsize + .set .callsz, 16 + .else + .ifeq \callsize-4 + .set .callsz, 16 + .else + .ifeq \callsize-8 + .set .callsz, 32 + .else + .ifeq \callsize-12 + .set .callsz, 48 + .else + .error "abi_entry: invalid call size \callsize" + .endif + .endif + .endif + .endif + .set .locsz, .callsz + ((\locsize + 15) & -16) +#else + .set .callsz, \callsize + .if .callsz /* if calls, need space for return PC */ + .set .locsz, (\locsize + 4 + 15) & -16 + .else + .set .locsz, (\locsize + 15) & -16 + .endif +#endif + .endm + + .macro abi_entry locsize=0, callsize=0 + .iflt \locsize + .error "abi_entry: invalid negative size of locals (\locsize)" + .endif + abi_entry_size \locsize, \callsize +#if XCHAL_HAVE_WINDOWED && !__XTENSA_CALL0_ABI__ + .ifgt .locsz - 32760 /* .locsz > 32760 (ENTRY's max range)? */ + /* Funky computation to try to have assembler use addmi efficiently if possible: */ + entry sp, 0x7F00 + (.locsz & 0xF0) + addi a12, sp, - ((.locsz & -0x100) - 0x7F00) + movsp sp, a12 + .else + entry sp, .locsz + .endif +#else + .if .locsz + .ifle .locsz - 128 /* if locsz <= 128 */ + addi sp, sp, -.locsz + .if .callsz + s32i a0, sp, .locsz - 4 + .endif + .elseif .callsz /* locsz > 128, with calls: */ + movi a9, .locsz - 16 /* note: a9 is caller-saved */ + addi sp, sp, -16 + s32i a0, sp, 12 + sub sp, sp, a9 + .else /* locsz > 128, no calls: */ + movi a9, .locsz + sub sp, sp, a9 + .endif /* end */ + .endif +#endif + .endm + + + +/*---------------------------------------------------------------------- + * abi_return + * + * Generate proper function exit sequence for the current ABI + * (windowed or call0). Takes care of freeing stack space and + * restoring the return PC, if necessary. + * NOTE: This macro MUST be invoked following a corresponding + * abi_entry macro invocation. For call0 ABI in particular, + * all stack and PC restoration are done according to the last + * abi_entry macro invoked before this macro in the assembly file. + * + * Normally this macro takes no arguments. However to allow + * for placing abi_return *before* abi_entry (as must be done + * for some highly optimized assembly), it optionally takes + * exactly the same arguments as abi_entry. + */ + + .macro abi_return locsize=-1, callsize=0 + .ifge \locsize + abi_entry_size \locsize, \callsize + .endif +#if XCHAL_HAVE_WINDOWED && !__XTENSA_CALL0_ABI__ + retw +#else + .if .locsz + .iflt .locsz - 128 /* if locsz < 128 */ + .if .callsz + l32i a0, sp, .locsz - 4 + .endif + addi sp, sp, .locsz + .elseif .callsz /* locsz >= 128, with calls: */ + addi a9, sp, .locsz - 16 + l32i a0, a9, 12 + addi sp, a9, 16 + .else /* locsz >= 128, no calls: */ + movi a9, .locsz + add sp, sp, a9 + .endif /* end */ + .endif + ret +#endif + .endm + + +/* + * HW erratum fixes. + */ + + .macro hw_erratum_487_fix +#if defined XSHAL_ERRATUM_487_FIX + isync +#endif + .endm + + +#endif /*XTENSA_COREASM_H*/ + diff --git a/components/esp32/include/xtensa/corebits.h b/components/esp32/include/xtensa/corebits.h new file mode 100755 index 000000000..0ac0c8014 --- /dev/null +++ b/components/esp32/include/xtensa/corebits.h @@ -0,0 +1,185 @@ +/* + * xtensa/corebits.h - Xtensa Special Register field positions, masks, values. + * + * (In previous releases, these were defined in specreg.h, a generated file. + * This file is not generated, ie. it is processor configuration independent.) + */ + +/* $Id: //depot/rel/Eaglenest/Xtensa/OS/include/xtensa/corebits.h#2 $ */ + +/* + * Copyright (c) 2005-2011 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_COREBITS_H +#define XTENSA_COREBITS_H + +/* EXCCAUSE register fields: */ +#define EXCCAUSE_EXCCAUSE_SHIFT 0 +#define EXCCAUSE_EXCCAUSE_MASK 0x3F +/* EXCCAUSE register values: */ +/* + * General Exception Causes + * (values of EXCCAUSE special register set by general exceptions, + * which vector to the user, kernel, or double-exception vectors). + */ +#define EXCCAUSE_ILLEGAL 0 /* Illegal Instruction */ +#define EXCCAUSE_SYSCALL 1 /* System Call (SYSCALL instruction) */ +#define EXCCAUSE_INSTR_ERROR 2 /* Instruction Fetch Error */ +# define EXCCAUSE_IFETCHERROR 2 /* (backward compatibility macro, deprecated, avoid) */ +#define EXCCAUSE_LOAD_STORE_ERROR 3 /* Load Store Error */ +# define EXCCAUSE_LOADSTOREERROR 3 /* (backward compatibility macro, deprecated, avoid) */ +#define EXCCAUSE_LEVEL1_INTERRUPT 4 /* Level 1 Interrupt */ +# define EXCCAUSE_LEVEL1INTERRUPT 4 /* (backward compatibility macro, deprecated, avoid) */ +#define EXCCAUSE_ALLOCA 5 /* Stack Extension Assist (MOVSP instruction) for alloca */ +#define EXCCAUSE_DIVIDE_BY_ZERO 6 /* Integer Divide by Zero */ +#define EXCCAUSE_SPECULATION 7 /* Use of Failed Speculative Access (not implemented) */ +#define EXCCAUSE_PRIVILEGED 8 /* Privileged Instruction */ +#define EXCCAUSE_UNALIGNED 9 /* Unaligned Load or Store */ +/* Reserved 10..11 */ +#define EXCCAUSE_INSTR_DATA_ERROR 12 /* PIF Data Error on Instruction Fetch (RB-200x and later) */ +#define EXCCAUSE_LOAD_STORE_DATA_ERROR 13 /* PIF Data Error on Load or Store (RB-200x and later) */ +#define EXCCAUSE_INSTR_ADDR_ERROR 14 /* PIF Address Error on Instruction Fetch (RB-200x and later) */ +#define EXCCAUSE_LOAD_STORE_ADDR_ERROR 15 /* PIF Address Error on Load or Store (RB-200x and later) */ +#define EXCCAUSE_ITLB_MISS 16 /* ITLB Miss (no ITLB entry matches, hw refill also missed) */ +#define EXCCAUSE_ITLB_MULTIHIT 17 /* ITLB Multihit (multiple ITLB entries match) */ +#define EXCCAUSE_INSTR_RING 18 /* Ring Privilege Violation on Instruction Fetch */ +/* Reserved 19 */ /* Size Restriction on IFetch (not implemented) */ +#define EXCCAUSE_INSTR_PROHIBITED 20 /* Cache Attribute does not allow Instruction Fetch */ +/* Reserved 21..23 */ +#define EXCCAUSE_DTLB_MISS 24 /* DTLB Miss (no DTLB entry matches, hw refill also missed) */ +#define EXCCAUSE_DTLB_MULTIHIT 25 /* DTLB Multihit (multiple DTLB entries match) */ +#define EXCCAUSE_LOAD_STORE_RING 26 /* Ring Privilege Violation on Load or Store */ +/* Reserved 27 */ /* Size Restriction on Load/Store (not implemented) */ +#define EXCCAUSE_LOAD_PROHIBITED 28 /* Cache Attribute does not allow Load */ +#define EXCCAUSE_STORE_PROHIBITED 29 /* Cache Attribute does not allow Store */ +/* Reserved 30..31 */ +#define EXCCAUSE_CP_DISABLED(n) (32+(n)) /* Access to Coprocessor 'n' when disabled */ +#define EXCCAUSE_CP0_DISABLED 32 /* Access to Coprocessor 0 when disabled */ +#define EXCCAUSE_CP1_DISABLED 33 /* Access to Coprocessor 1 when disabled */ +#define EXCCAUSE_CP2_DISABLED 34 /* Access to Coprocessor 2 when disabled */ +#define EXCCAUSE_CP3_DISABLED 35 /* Access to Coprocessor 3 when disabled */ +#define EXCCAUSE_CP4_DISABLED 36 /* Access to Coprocessor 4 when disabled */ +#define EXCCAUSE_CP5_DISABLED 37 /* Access to Coprocessor 5 when disabled */ +#define EXCCAUSE_CP6_DISABLED 38 /* Access to Coprocessor 6 when disabled */ +#define EXCCAUSE_CP7_DISABLED 39 /* Access to Coprocessor 7 when disabled */ +/* Reserved 40..63 */ + +/* PS register fields: */ +#define PS_WOE_SHIFT 18 +#define PS_WOE_MASK 0x00040000 +#define PS_WOE PS_WOE_MASK +#define PS_CALLINC_SHIFT 16 +#define PS_CALLINC_MASK 0x00030000 +#define PS_CALLINC(n) (((n)&3)< +#include +#include + +int xt_dbfs_open(const char *pathname, int flags, mode_t mode); +int xt_dbfs_ftruncate(int fd, off_t length); +int xt_dbfs_truncate(const char * filename, off_t length); +int xt_dbfs_creat(const char *pathname, mode_t mode); +int xt_dbfs_errno(void); +int xt_dbfs_lseek(int fd, off_t offset, int whence); +ssize_t xt_dbfs_write(int fd, const void * buf, size_t bytes); + ssize_t xt_dbfs_open_append_close(const char * filename, int align, + const void * buf, size_t bytes); +ssize_t xt_dbfs_read(int fd, void * buf, size_t bytes); +int xt_dbfs_close(int fd); +int xt_dbfs_unlink(const char *pathname); + +/* By default, this function is a wrapper around sbrk, and follows + sbrk semantics: + + On success, it returns increment bytes of memory allocated from + system memory. + + On failure, it returns 0xFFFFFFFF + + + If you want to use a method of allocating memory other than sbrk, + implement xt_dbfs_sbrk in your own sources, and the linker will + automatically use that copy. +*/ +void * xt_dbfs_sbrk(int increment); + + + +#ifdef REPLACE_FS_WITH_DBFS +#define open xt_dbfs_open +#define close xt_dbfs_close +#define creat xt_dbfs_creat +#define lseek xt_dbfs_lseek +#define write xt_dbfs_write +#define read xt_dbfs_read +#define close xt_dbfs_close +#define unlink xt_dbfs_unlink + +#define rmdir NOT_IMPLEMENTED_IN_DBFS +#define opendir NOT_IMPLEMENTED_IN_DBFS +#define closedir NOT_IMPLEMENTED_IN_DBFS +#define dirfs NOT_IMPLEMENTED_IN_DBFS +#define readdir NOT_IMPLEMENTED_IN_DBFS +#define scandir NOT_IMPLEMENTED_IN_DBFS +#define seekdir NOT_IMPLEMENTED_IN_DBFS +#define telldir NOT_IMPLEMENTED_IN_DBFS + +#define fcntl NOT_IMPLEMENTED_IN_DBFS +#define dup2 NOT_IMPLEMENTED_IN_DBFS +#define dup NOT_IMPLEMENTED_IN_DBFS +#define flock NOT_IMPLEMENTED_IN_DBFS +#define lockf NOT_IMPLEMENTED_IN_DBFS +#define link NOT_IMPLEMENTED_IN_DBFS +#define stat NOT_IMPLEMENTED_IN_DBFS +#define fstat NOT_IMPLEMENTED_IN_DBFS +#define lstat NOT_IMPLEMENTED_IN_DBFS +#define chmod NOT_IMPLEMENTED_IN_DBFS +#define fchmod NOT_IMPLEMENTED_IN_DBFS +#define chmown NOT_IMPLEMENTED_IN_DBFS +#define lchown NOT_IMPLEMENTED_IN_DBFS +#define fchown NOT_IMPLEMENTED_IN_DBFS + +#endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/esp32/include/xtensa/feedback.h b/components/esp32/include/xtensa/feedback.h new file mode 100755 index 000000000..aecb74533 --- /dev/null +++ b/components/esp32/include/xtensa/feedback.h @@ -0,0 +1,45 @@ + +/* + * Copyright (c) 2013 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +#ifndef __XT_FEEDBACK_INCLUDED__ +#define __XT_FEEDBACK_INCLUDED__ + +#ifdef __cplusplus +extern "C" { +#endif + +/* xt_feedback_save_and_reset + + Save and reset the accumulated feedback data. +*/ +extern void xt_feedback_save_and_reset(void); + +/* xt_feedback_enable + + Turn on feedback accumulation. Ordinarily, feedback accumulation is on + by default. If you turn it off using xt_feedback_disable, You can turn + it on again via this function. +*/ +extern void xt_feedback_enable (void); + +/* xt_feedback_disable + + Turn off feedback accumulation. If you don't want to gather feedback for a + portion of your code, use this function and then xt_feedback_enable when + you want to start again. +*/ +extern void xt_feedback_disable (void); + +#ifdef __cplusplus +} +#endif + +#endif /* __XT_FEEDBACK_INCLUDED__ */ + diff --git a/components/esp32/include/xtensa/gdbio.h b/components/esp32/include/xtensa/gdbio.h new file mode 100755 index 000000000..784a86297 --- /dev/null +++ b/components/esp32/include/xtensa/gdbio.h @@ -0,0 +1,80 @@ +/* Xtensa Debug-FileSystem definitions + * + * Copyright (c) 2006-2009 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +#ifndef __DEBUGFS_H__ +#define __DEBUGFS_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#include + + int _gdbio_open_r(void * ptr, const char *pathname, int flags, mode_t mode); + int _gdbio_creat_r(void * ptr, const char *pathname, mode_t mode); + int _gdbio_lseek_r(void * ptr, int fd, off_t offset, int whence); + ssize_t _gdbio_write_r(void * ptr, int fd, const void * buf, size_t bytes); + ssize_t _gdbio_read_r(void * ptr, int fd, void * buf, size_t bytes); + int _gdbio_close_r(void * ptr, int fd); + int _gdbio_unlink_r(void * ptr, const char * pathname); + + static inline + int gdbio_open(const char *pathname, int flags, mode_t mode) { + return _gdbio_open_r(&errno, pathname, flags, mode); + } + static inline int + gdbio_creat(const char *pathname, mode_t mode) { + return _gdbio_open_r(&errno, pathname, O_CREAT|O_WRONLY|O_TRUNC, mode); + } + static inline int + gdbio_errno(void) { + return errno; + } + static inline int + gdbio_lseek(int fd, off_t offset, int whence) { + return _gdbio_lseek_r(&errno, fd, offset, whence); + } + static inline + ssize_t gdbio_write(int fd, const void * buf, size_t bytes) { + return _gdbio_write_r(&errno, fd, buf, bytes); + } + static inline + ssize_t gdbio_read(int fd, void * buf, size_t bytes) { + return _gdbio_read_r(&errno, fd, buf, bytes); + } + static inline int + gdbio_close(int fd) { + return _gdbio_close_r(&errno, fd); + } + static inline int + gdbio_unlink(const char * pathname) { + return _gdbio_unlink_r(&errno, pathname); + } + +#ifdef REPLACE_FS_WITH_GDBIO +#define open gdbio_open +#define close gdbio_close +#define creat gdbio_creat +#define lseek gdbio_lseek +#define write gdbio_write +#define read gdbio_read +#define close gdbio_close +#define unlink gdbio_unlink + +#endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/esp32/include/xtensa/hal.h b/components/esp32/include/xtensa/hal.h new file mode 100755 index 000000000..d4d95d9fe --- /dev/null +++ b/components/esp32/include/xtensa/hal.h @@ -0,0 +1,1024 @@ +/* + xtensa/hal.h -- contains a definition of the Core HAL interface + + All definitions in this header file are independent of any specific + Xtensa processor configuration. Thus software (eg. OS, application, + etc) can include this header file and be compiled into configuration- + independent objects that can be distributed and eventually linked + to the HAL library (libhal.a) to create a configuration-specific + final executable. + + Certain definitions, however, are release/version-specific -- such as + the XTHAL_RELEASE_xxx macros (or additions made in later versions). + + + $Id: //depot/rel/Eaglenest/Xtensa/OS/target-os-src/hal.h.tpp#4 $ + + Copyright (c) 1999-2014 Cadence Design Systems, Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +*/ + +#ifndef XTENSA_HAL_H +#define XTENSA_HAL_H + + +/**************************************************************************** + Definitions Useful for Any Code, USER or PRIVILEGED + ****************************************************************************/ + + +/*---------------------------------------------------------------------- + Constant Definitions (shared with assembly) + ----------------------------------------------------------------------*/ + +/* + * Software (Xtensa Tools) version information. Not configuration-specific! + * + * NOTE: "release" is a misnomer here, these are really product "version" + * numbers. A "release" is a collection of product versions + * made available at once (together) to customers. + * In the past, release and version names all matched in T####.# form, + * making the distinction irrelevant. This is no longer the case. + */ +#define XTHAL_RELEASE_MAJOR 11000 +#define XTHAL_RELEASE_MINOR 3 +#define XTHAL_RELEASE_NAME "11.0.3" +#define XTHAL_REL_11 1 +#define XTHAL_REL_11_0 1 +#define XTHAL_REL_11_0_3 1 + +/* HAL version numbers (these names are for backward compatibility): */ +#define XTHAL_MAJOR_REV XTHAL_RELEASE_MAJOR +#define XTHAL_MINOR_REV XTHAL_RELEASE_MINOR +/* + * A bit of software release/version history on values of XTHAL_{MAJOR,MINOR}_REV: + * + * SW Version MAJOR MINOR Comment + * ======= ===== ===== ======= + * T1015.n n/a n/a (HAL not yet available) + * T1020.{0,1,2} 0 1 (HAL beta) + * T1020.{3,4} 0 2 First release. + * T1020.n (n>4) 0 2 or >3 (TBD) + * T1030.0 0 1 (HAL beta) + * T1030.{1,2} 0 3 Equivalent to first release. + * T1030.n (n>=3) 0 >= 3 (TBD) + * T1040.n 1040 n Full CHAL available from T1040.2 + * T1050.n 1050 n . + * 6.0.n 6000 n Xtensa Tools v6 (RA-200x.n) + * 7.0.n 7000 n Xtensa Tools v7 (RB-200x.n) + * 7.1.n 7010 n Xtensa Tools v7.1 (RB-200x.(n+2)) + * 8.0.n 8000 n Xtensa Tools v8 (RC-20xx.n) + * 9.0.n 9000 n Xtensa Tools v9 (RD-201x.n) + * 10.0.n 10000 n Xtensa Tools v10 (RE-201x.n) + * + * + * Note: there is a distinction between the software version with + * which something is compiled (accessible using XTHAL_RELEASE_* macros) + * and the software version with which the HAL library was compiled + * (accessible using Xthal_release_* global variables). This + * distinction is particularly relevant for vendors that distribute + * configuration-independent binaries (eg. an OS), where their customer + * might link it with a HAL of a different Xtensa software version. + * In this case, it may be appropriate for the OS to verify at run-time + * whether XTHAL_RELEASE_* and Xthal_release_* are compatible. + * [Guidelines as to which version is compatible with which are not + * currently provided explicitly, but might be inferred from reading + * OSKit documentation for all releases -- compatibility is also highly + * dependent on which HAL features are used. Each version is usually + * backward compatible, with very few exceptions if any.] + */ + +/* Version comparison operators (among major/minor pairs): */ +#define XTHAL_REL_GE(maja,mina, majb,minb) ((maja) > (majb) || \ + ((maja) == (majb) && (mina) >= (minb))) +#define XTHAL_REL_GT(maja,mina, majb,minb) ((maja) > (majb) || \ + ((maja) == (majb) && (mina) > (minb))) +#define XTHAL_REL_LE(maja,mina, majb,minb) ((maja) < (majb) || \ + ((maja) == (majb) && (mina) <= (minb))) +#define XTHAL_REL_LT(maja,mina, majb,minb) ((maja) < (majb) || \ + ((maja) == (majb) && (mina) < (minb))) +#define XTHAL_REL_EQ(maja,mina, majb,minb) ((maja) == (majb) && (mina) == (minb)) + +/* Fuzzy (3-way) logic operators: */ +#define XTHAL_MAYBE -1 /* 0=NO, 1=YES, -1=MAYBE */ +#define XTHAL_FUZZY_AND(a,b) (((a)==0 || (b)==0) ? 0 : ((a)==1 && (b)==1) ? 1 : XTHAL_MAYBE) +#define XTHAL_FUZZY_OR(a,b) (((a)==1 || (b)==1) ? 1 : ((a)==0 && (b)==0) ? 0 : XTHAL_MAYBE) +#define XTHAL_FUZZY_NOT(a) (((a)==0 || (a)==1) ? (1-(a)) : XTHAL_MAYBE) + + +/* + * Architectural limit, independent of configuration: + */ +#define XTHAL_MAX_CPS 8 /* max number of coprocessors (0..7) */ + +/* Misc: */ +#define XTHAL_LITTLEENDIAN 0 +#define XTHAL_BIGENDIAN 1 + + + +#if !defined(_ASMLANGUAGE) && !defined(_NOCLANGUAGE) && !defined(__ASSEMBLER__) +#ifdef __cplusplus +extern "C" { +#endif + +/*---------------------------------------------------------------------- + HAL + ----------------------------------------------------------------------*/ + +/* Constant to be checked in build = (XTHAL_MAJOR_REV<<16)|XTHAL_MINOR_REV */ +extern const unsigned int Xthal_rev_no; + + +/*---------------------------------------------------------------------- + Optional/Custom Processor State + ----------------------------------------------------------------------*/ + +/* save & restore the extra processor state */ +extern void xthal_save_extra(void *base); +extern void xthal_restore_extra(void *base); + +extern void xthal_save_cpregs(void *base, int); +extern void xthal_restore_cpregs(void *base, int); +/* versions specific to each coprocessor id */ +extern void xthal_save_cp0(void *base); +extern void xthal_save_cp1(void *base); +extern void xthal_save_cp2(void *base); +extern void xthal_save_cp3(void *base); +extern void xthal_save_cp4(void *base); +extern void xthal_save_cp5(void *base); +extern void xthal_save_cp6(void *base); +extern void xthal_save_cp7(void *base); +extern void xthal_restore_cp0(void *base); +extern void xthal_restore_cp1(void *base); +extern void xthal_restore_cp2(void *base); +extern void xthal_restore_cp3(void *base); +extern void xthal_restore_cp4(void *base); +extern void xthal_restore_cp5(void *base); +extern void xthal_restore_cp6(void *base); +extern void xthal_restore_cp7(void *base); +/* pointers to each of the functions above */ +extern void* Xthal_cpregs_save_fn[XTHAL_MAX_CPS]; +extern void* Xthal_cpregs_restore_fn[XTHAL_MAX_CPS]; +/* similarly for non-windowed ABI (may be same or different) */ +extern void* Xthal_cpregs_save_nw_fn[XTHAL_MAX_CPS]; +extern void* Xthal_cpregs_restore_nw_fn[XTHAL_MAX_CPS]; + +/*extern void xthal_save_all_extra(void *base);*/ +/*extern void xthal_restore_all_extra(void *base);*/ + +/* space for processor state */ +extern const unsigned int Xthal_extra_size; +extern const unsigned int Xthal_extra_align; +extern const unsigned int Xthal_cpregs_size[XTHAL_MAX_CPS]; +extern const unsigned int Xthal_cpregs_align[XTHAL_MAX_CPS]; +extern const unsigned int Xthal_all_extra_size; +extern const unsigned int Xthal_all_extra_align; +/* coprocessor names */ +extern const char * const Xthal_cp_names[XTHAL_MAX_CPS]; + +/* initialize the extra processor */ +/*extern void xthal_init_extra(void);*/ +/* initialize the TIE coprocessor */ +/*extern void xthal_init_cp(int);*/ + +/* initialize the extra processor */ +extern void xthal_init_mem_extra(void *); +/* initialize the TIE coprocessor */ +extern void xthal_init_mem_cp(void *, int); + +/* the number of TIE coprocessors contiguous from zero (for Tor2) */ +extern const unsigned int Xthal_num_coprocessors; + +/* actual number of coprocessors */ +extern const unsigned char Xthal_cp_num; +/* index of highest numbered coprocessor, plus one */ +extern const unsigned char Xthal_cp_max; +/* index of highest allowed coprocessor number, per cfg, plus one */ +/*extern const unsigned char Xthal_cp_maxcfg;*/ +/* bitmask of which coprocessors are present */ +extern const unsigned int Xthal_cp_mask; + +/* read & write extra state register */ +/*extern int xthal_read_extra(void *base, unsigned reg, unsigned *value);*/ +/*extern int xthal_write_extra(void *base, unsigned reg, unsigned value);*/ + +/* read & write a TIE coprocessor register */ +/*extern int xthal_read_cpreg(void *base, int cp, unsigned reg, unsigned *value);*/ +/*extern int xthal_write_cpreg(void *base, int cp, unsigned reg, unsigned value);*/ + +/* return coprocessor number based on register */ +/*extern int xthal_which_cp(unsigned reg);*/ + + +/*---------------------------------------------------------------------- + Register Windows + ----------------------------------------------------------------------*/ + +/* number of registers in register window */ +extern const unsigned int Xthal_num_aregs; +extern const unsigned char Xthal_num_aregs_log2; + + +/*---------------------------------------------------------------------- + Cache + ----------------------------------------------------------------------*/ + +/* size of the cache lines in log2(bytes) */ +extern const unsigned char Xthal_icache_linewidth; +extern const unsigned char Xthal_dcache_linewidth; +/* size of the cache lines in bytes (2^linewidth) */ +extern const unsigned short Xthal_icache_linesize; +extern const unsigned short Xthal_dcache_linesize; + +/* size of the caches in bytes (ways * 2^(linewidth + setwidth)) */ +extern const unsigned int Xthal_icache_size; +extern const unsigned int Xthal_dcache_size; +/* cache features */ +extern const unsigned char Xthal_dcache_is_writeback; + +/* invalidate the caches */ + +extern void xthal_icache_region_invalidate( void *addr, unsigned size ); +extern void xthal_dcache_region_invalidate( void *addr, unsigned size ); +# ifndef XTHAL_USE_CACHE_MACROS +extern void xthal_icache_line_invalidate(void *addr); +extern void xthal_dcache_line_invalidate(void *addr); +# endif +/* write dirty data back */ +extern void xthal_dcache_region_writeback( void *addr, unsigned size ); +# ifndef XTHAL_USE_CACHE_MACROS +extern void xthal_dcache_line_writeback(void *addr); +# endif +/* write dirty data back and invalidate */ +extern void xthal_dcache_region_writeback_inv( void *addr, unsigned size ); +# ifndef XTHAL_USE_CACHE_MACROS +extern void xthal_dcache_line_writeback_inv(void *addr); +/* sync icache and memory */ +extern void xthal_icache_sync( void ); +/* sync dcache and memory */ +extern void xthal_dcache_sync( void ); +#endif + +/* get number of icache ways enabled */ +extern unsigned int xthal_icache_get_ways(void); +/* set number of icache ways enabled */ +extern void xthal_icache_set_ways(unsigned int ways); +/* get number of dcache ways enabled */ +extern unsigned int xthal_dcache_get_ways(void); +/* set number of dcache ways enabled */ +extern void xthal_dcache_set_ways(unsigned int ways); + +/* coherency (low-level -- not normally called directly) */ +extern void xthal_cache_coherence_on( void ); +extern void xthal_cache_coherence_off( void ); +/* coherency (high-level) */ +extern void xthal_cache_coherence_optin( void ); +extern void xthal_cache_coherence_optout( void ); + +/* + * Cache prefetch control. + * The parameter to xthal_set_cache_prefetch() contains both + * a PREFCTL register value and a mask of which bits to actually modify. + * This allows easily combining field macros (below) by ORing, + * leaving unspecified fields unmodified. + * + * For backward compatibility with the older version of this routine + * (that took 15-bit value and mask in a 32-bit parameter, for pre-RF + * cores with only the lower 15 bits of PREFCTL defined), the 32-bit + * value and mask are staggered as follows in a 64-bit parameter: + * param[63:48] are PREFCTL[31:16] if param[31] is set + * param[47:32] are mask[31:16] if param[31] is set + * param[31] is set if mask is used, 0 if not + * param[31:16] are mask[15:0] if param[31] is set + * param[31:16] are PREFCTL[31:16] if param[31] is clear + * param[15:0] are PREFCTL[15:0] + * + * Limitation: PREFCTL register bit 31 cannot be set without masking, + * and bit 15 must always be set when using masking, so it is hoped that + * these two bits will remain reserved, read-as-zero in PREFCTL. + */ +#define XTHAL_PREFETCH_ENABLE -1 /* enable inst+data prefetch */ +#define XTHAL_PREFETCH_DISABLE 0xFFFF0000 /* disab inst+data prefetch*/ +#define XTHAL_DCACHE_PREFETCH(n) (0x800F0000+((n)&0xF)) /* data-side */ +#define XTHAL_DCACHE_PREFETCH_OFF XTHAL_DCACHE_PREFETCH(0) /* disable */ +#define XTHAL_DCACHE_PREFETCH_LOW XTHAL_DCACHE_PREFETCH(4) /* less aggr.*/ +#define XTHAL_DCACHE_PREFETCH_MEDIUM XTHAL_DCACHE_PREFETCH(5) /* mid aggr. */ +#define XTHAL_DCACHE_PREFETCH_HIGH XTHAL_DCACHE_PREFETCH(8) /* more aggr.*/ +#define XTHAL_DCACHE_PREFETCH_L1_OFF 0x90000000 /* to prefetch buffers*/ +#define XTHAL_DCACHE_PREFETCH_L1 0x90001000 /* direct to L1 dcache*/ +#define XTHAL_ICACHE_PREFETCH(n) (0x80F00000+(((n)&0xF)<<4)) /* i-side */ +#define XTHAL_ICACHE_PREFETCH_OFF XTHAL_ICACHE_PREFETCH(0) /* disable */ +#define XTHAL_ICACHE_PREFETCH_LOW XTHAL_ICACHE_PREFETCH(4) /* less aggr.*/ +#define XTHAL_ICACHE_PREFETCH_MEDIUM XTHAL_ICACHE_PREFETCH(5) /* mid aggr. */ +#define XTHAL_ICACHE_PREFETCH_HIGH XTHAL_ICACHE_PREFETCH(8) /* more aggr.*/ +#define XTHAL_ICACHE_PREFETCH_L1_OFF 0xA0000000 /* (not implemented) */ +#define XTHAL_ICACHE_PREFETCH_L1 0xA0002000 /* (not implemented) */ +#define _XTHAL_PREFETCH_BLOCKS(n) ((n)<0?0:(n)<5?(n):(n)<15?((n)>>1)+2:9) +#define XTHAL_PREFETCH_BLOCKS(n) (0x0000000F80000000ULL + \ + (((unsigned long long)_XTHAL_PREFETCH_BLOCKS(n))<<48)) + +extern int xthal_get_cache_prefetch( void ); +extern int xthal_set_cache_prefetch( int ); +extern int xthal_set_cache_prefetch_long( unsigned long long ); +/* Only use the new extended function from now on: */ +#define xthal_set_cache_prefetch xthal_set_cache_prefetch_long +#define xthal_set_cache_prefetch_nw xthal_set_cache_prefetch_long_nw + + +/*---------------------------------------------------------------------- + Debug + ----------------------------------------------------------------------*/ + +/* 1 if debug option configured, 0 if not: */ +extern const int Xthal_debug_configured; + +/* Set (plant) and remove software breakpoint, both synchronizing cache: */ +extern unsigned int xthal_set_soft_break(void *addr); +extern void xthal_remove_soft_break(void *addr, unsigned int); + + +/*---------------------------------------------------------------------- + Disassembler + ----------------------------------------------------------------------*/ + +/* Max expected size of the return buffer for a disassembled instruction (hint only): */ +#define XTHAL_DISASM_BUFSIZE 80 + +/* Disassembly option bits for selecting what to return: */ +#define XTHAL_DISASM_OPT_ADDR 0x0001 /* display address */ +#define XTHAL_DISASM_OPT_OPHEX 0x0002 /* display opcode bytes in hex */ +#define XTHAL_DISASM_OPT_OPCODE 0x0004 /* display opcode name (mnemonic) */ +#define XTHAL_DISASM_OPT_PARMS 0x0008 /* display parameters */ +#define XTHAL_DISASM_OPT_ALL 0x0FFF /* display everything */ + +/* routine to get a string for the disassembled instruction */ +extern int xthal_disassemble( unsigned char *instr_buf, void *tgt_addr, + char *buffer, unsigned buflen, unsigned options ); + +/* routine to get the size of the next instruction. Returns 0 for + illegal instruction */ +extern int xthal_disassemble_size( unsigned char *instr_buf ); + + +/*---------------------------------------------------------------------- + Instruction/Data RAM/ROM Access + ----------------------------------------------------------------------*/ + +extern void* xthal_memcpy(void *dst, const void *src, unsigned len); +extern void* xthal_bcopy(const void *src, void *dst, unsigned len); + + +/*---------------------------------------------------------------------- + MP Synchronization + ----------------------------------------------------------------------*/ + +extern int xthal_compare_and_set( int *addr, int test_val, int compare_val ); + +/*extern const char Xthal_have_s32c1i;*/ + + +/*---------------------------------------------------------------------- + Miscellaneous + ----------------------------------------------------------------------*/ + +extern const unsigned int Xthal_release_major; +extern const unsigned int Xthal_release_minor; +extern const char * const Xthal_release_name; +extern const char * const Xthal_release_internal; + +extern const unsigned char Xthal_memory_order; +extern const unsigned char Xthal_have_windowed; +extern const unsigned char Xthal_have_density; +extern const unsigned char Xthal_have_booleans; +extern const unsigned char Xthal_have_loops; +extern const unsigned char Xthal_have_nsa; +extern const unsigned char Xthal_have_minmax; +extern const unsigned char Xthal_have_sext; +extern const unsigned char Xthal_have_clamps; +extern const unsigned char Xthal_have_mac16; +extern const unsigned char Xthal_have_mul16; +extern const unsigned char Xthal_have_fp; +extern const unsigned char Xthal_have_speculation; +extern const unsigned char Xthal_have_threadptr; + +extern const unsigned char Xthal_have_pif; +extern const unsigned short Xthal_num_writebuffer_entries; + +extern const unsigned int Xthal_build_unique_id; +/* Version info for hardware targeted by software upgrades: */ +extern const unsigned int Xthal_hw_configid0; +extern const unsigned int Xthal_hw_configid1; +extern const unsigned int Xthal_hw_release_major; +extern const unsigned int Xthal_hw_release_minor; +extern const char * const Xthal_hw_release_name; +extern const char * const Xthal_hw_release_internal; + +/* Clear any remnant code-dependent state (i.e. clear loop count regs). */ +extern void xthal_clear_regcached_code( void ); + +#ifdef __cplusplus +} +#endif +#endif /*!_ASMLANGUAGE && !_NOCLANGUAGE && !__ASSEMBLER__ */ + + + + + +/**************************************************************************** + Definitions Useful for PRIVILEGED (Supervisory or Non-Virtualized) Code + ****************************************************************************/ + + +#ifndef XTENSA_HAL_NON_PRIVILEGED_ONLY + +/*---------------------------------------------------------------------- + Constant Definitions (shared with assembly) + ----------------------------------------------------------------------*/ + +/* + * Architectural limits, independent of configuration. + * Note that these are ISA-defined limits, not micro-architecture implementation + * limits enforced by the Xtensa Processor Generator (which may be stricter than + * these below). + */ +#define XTHAL_MAX_INTERRUPTS 32 /* max number of interrupts (0..31) */ +#define XTHAL_MAX_INTLEVELS 16 /* max number of interrupt levels (0..15) */ + /* (as of T1040, implementation limit is 7: 0..6) */ +#define XTHAL_MAX_TIMERS 4 /* max number of timers (CCOMPARE0..CCOMPARE3) */ + /* (as of T1040, implementation limit is 3: 0..2) */ + +/* Interrupt types: */ +#define XTHAL_INTTYPE_UNCONFIGURED 0 +#define XTHAL_INTTYPE_SOFTWARE 1 +#define XTHAL_INTTYPE_EXTERN_EDGE 2 +#define XTHAL_INTTYPE_EXTERN_LEVEL 3 +#define XTHAL_INTTYPE_TIMER 4 +#define XTHAL_INTTYPE_NMI 5 +#define XTHAL_INTTYPE_WRITE_ERROR 6 +#define XTHAL_INTTYPE_PROFILING 7 +#define XTHAL_MAX_INTTYPES 8 /* number of interrupt types */ + +/* Timer related: */ +#define XTHAL_TIMER_UNCONFIGURED -1 /* Xthal_timer_interrupt[] value for non-existent timers */ +#define XTHAL_TIMER_UNASSIGNED XTHAL_TIMER_UNCONFIGURED /* (for backwards compatibility only) */ + +/* Local Memory ECC/Parity: */ +#define XTHAL_MEMEP_PARITY 1 +#define XTHAL_MEMEP_ECC 2 +/* Flags parameter to xthal_memep_inject_error(): */ +#define XTHAL_MEMEP_F_LOCAL 0 /* local memory (default) */ +#define XTHAL_MEMEP_F_DCACHE_DATA 4 /* data cache data */ +#define XTHAL_MEMEP_F_DCACHE_TAG 5 /* data cache tag */ +#define XTHAL_MEMEP_F_ICACHE_DATA 6 /* instruction cache data */ +#define XTHAL_MEMEP_F_ICACHE_TAG 7 /* instruction cache tag */ +#define XTHAL_MEMEP_F_CORRECTABLE 16 /* inject correctable error + (default is non-corr.) */ + + +/* Access Mode bits (tentative): */ /* bit abbr unit short_name PPC equ - Description */ +#define XTHAL_AMB_EXCEPTION 0 /* 001 E EX fls: EXception none + exception on any access (aka "illegal") */ +#define XTHAL_AMB_HITCACHE 1 /* 002 C CH fls: use Cache on Hit ~(I CI) + [or H HC] way from tag match; + [or U UC] (ISA: same except Isolate case) */ +#define XTHAL_AMB_ALLOCATE 2 /* 004 A AL fl?: ALlocate none + [or F FI fill] refill cache on miss, way from LRU + (ISA: Read/Write Miss Refill) */ +#define XTHAL_AMB_WRITETHRU 3 /* 008 W WT --s: WriteThrough W WT + store immediately to memory (ISA: same) */ +#define XTHAL_AMB_ISOLATE 4 /* 010 I IS fls: ISolate none + use cache regardless of hit-vs-miss, + way from vaddr (ISA: use-cache-on-miss+hit) */ +#define XTHAL_AMB_GUARD 5 /* 020 G GU ?l?: GUard G * + non-speculative; spec/replay refs not permitted */ +#define XTHAL_AMB_COHERENT 6 /* 040 M MC ?ls: Mem/MP Coherent M + on read, other CPU/bus-master may need to supply data; + on write, maybe redirect to or flush other CPU dirty line; etc */ +#if 0 +#define XTHAL_AMB_BUFFERABLE x /* 000 B BU --s: BUfferable ? + write response may return earlier than from final destination */ +#define XTHAL_AMB_ORDERED x /* 000 O OR fls: ORdered G * + mem accesses cannot be out of order */ +#define XTHAL_AMB_FUSEWRITES x /* 000 F FW --s: FuseWrites none + allow combining/merging/coalescing multiple writes + (to same datapath data unit) into one + (implied by writeback) */ +#define XTHAL_AMB_TRUSTED x /* 000 T TR ?l?: TRusted none + memory will not bus error (if it does, + handle as fatal imprecise interrupt) */ +#define XTHAL_AMB_PREFETCH x /* 000 P PR fl?: PRefetch none + on refill, read line+1 into prefetch buffers */ +#define XTHAL_AMB_STREAM x /* 000 S ST ???: STreaming none + access one of N stream buffers */ +#endif /*0*/ + +#define XTHAL_AM_EXCEPTION (1< = bit is set + * '-' = bit is clear + * '.' = bit is irrelevant / don't care, as follows: + * E=1 makes all others irrelevant + * W,F relevant only for stores + * "2345" + * Indicates which Xtensa releases support the corresponding + * access mode. Releases for each character column are: + * 2 = prior to T1020.2: T1015 (V1.5), T1020.0, T1020.1 + * 3 = T1020.2 and later: T1020.2+, T1030 + * 4 = T1040 + * 5 = T1050 (maybe), LX1, LX2, LX2.1 + * 7 = LX2.2 + * 8 = LX3, LX4 + * 9 = LX5 + * And the character column contents are: + * = supported by release(s) + * "." = unsupported by release(s) + * "?" = support unknown + */ + /* foMGIWACE 2345789 */ +/* For instruction fetch: */ +#define XTHAL_FAM_EXCEPTION 0x001 /* ........E 2345789 exception */ +/*efine XTHAL_FAM_ISOLATE*/ /*0x012*/ /* .---I.-C- ....... isolate */ +#define XTHAL_FAM_BYPASS 0x000 /* .----.--- 2345789 bypass */ +/*efine XTHAL_FAM_NACACHED*/ /*0x002*/ /* .----.-C- ....... cached no-allocate (frozen) */ +#define XTHAL_FAM_CACHED 0x006 /* .----.AC- 2345789 cached */ +/* For data load: */ +#define XTHAL_LAM_EXCEPTION 0x001 /* ........E 2345789 exception */ +#define XTHAL_LAM_ISOLATE 0x012 /* .---I.-C- 2345789 isolate */ +#define XTHAL_LAM_BYPASS 0x000 /* .O---.--- 2...... bypass speculative */ +#define XTHAL_LAM_BYPASSG 0x020 /* .O-G-.--- .345789 bypass guarded */ +#define XTHAL_LAM_CACHED_NOALLOC 0x002 /* .O---.-C- 2345789 cached no-allocate speculative */ +#define XTHAL_LAM_NACACHED XTHAL_LAM_CACHED_NOALLOC +#define XTHAL_LAM_NACACHEDG 0x022 /* .O-G-.-C- .?..... cached no-allocate guarded */ +#define XTHAL_LAM_CACHED 0x006 /* .----.AC- 2345789 cached speculative */ +#define XTHAL_LAM_COHCACHED 0x046 /* .-M--.AC- ....*89 cached speculative MP-coherent */ +/* For data store: */ +#define XTHAL_SAM_EXCEPTION 0x001 /* ........E 2345789 exception */ +#define XTHAL_SAM_ISOLATE 0x032 /* .--GI--C- 2345789 isolate */ +#define XTHAL_SAM_BYPASS 0x028 /* -O-G-W--- 2345789 bypass */ +#define XTHAL_SAM_WRITETHRU 0x02A /* -O-G-W-C- 2345789 writethrough */ +/*efine XTHAL_SAM_WRITETHRU_ALLOC*/ /*0x02E*/ /* -O-G-WAC- ....... writethrough allocate */ +#define XTHAL_SAM_WRITEBACK 0x026 /* F--G--AC- ...5789 writeback */ +#define XTHAL_SAM_WRITEBACK_NOALLOC 0x022 /* ?--G---C- .....89 writeback no-allocate */ +#define XTHAL_SAM_COHWRITEBACK 0x066 /* F-MG--AC- ....*89 writeback MP-coherent */ +/* For PIF attributes: */ /* -PIwrWCBUUUU ...9 */ +#define XTHAL_PAM_BYPASS 0x000 /* xxx00000xxxx ...9 bypass non-bufferable */ +#define XTHAL_PAM_BYPASS_BUF 0x010 /* xxx0000bxxxx ...9 bypass */ +#define XTHAL_PAM_CACHED_NOALLOC 0x030 /* xxx0001bxxxx ...9 cached no-allocate */ +#define XTHAL_PAM_WRITETHRU 0x0B0 /* xxx0101bxxxx ...9 writethrough (WT) */ +#define XTHAL_PAM_WRITEBACK_NOALLOC 0x0F0 /* xxx0111bxxxx ...9 writeback no-alloc (WBNA) */ +#define XTHAL_PAM_WRITEBACK 0x1F0 /* xxx1111bxxxx ...9 writeback (WB) */ +/*efine XTHAL_PAM_NORMAL*/ /*0x050*/ /* xxx0010bxxxx .... (unimplemented) */ +/*efine XTHAL_PAM_WRITETHRU_WA*/ /*0x130*/ /* xxx1001bxxxx .... (unimplemented, less likely) */ +/*efine XTHAL_PAM_WRITETHRU_RWA*/ /*0x1B0*/ /* xxx1101bxxxx .... (unimplemented, less likely) */ +/*efine XTHAL_PAM_WRITEBACK_WA*/ /*0x170*/ /* xxx1011bxxxx .... (unimplemented, less likely) */ + + +#if 0 +/* + Cache attribute encoding for CACHEATTR (per ISA): + (Note: if this differs from ISA Ref Manual, ISA has precedence) + + Inst-fetches Loads Stores + ------------- ------------ ------------- +0x0 FCA_EXCEPTION LCA_NACACHED SCA_WRITETHRU cached no-allocate (previously misnamed "uncached") +0x1 FCA_CACHED LCA_CACHED SCA_WRITETHRU cached +0x2 FCA_BYPASS LCA_BYPASS_G* SCA_BYPASS bypass cache (what most people call uncached) +0x3 FCA_CACHED LCA_CACHED SCA_WRITEALLOCF write-allocate + or LCA_EXCEPTION SCA_EXCEPTION (if unimplemented) +0x4 FCA_CACHED LCA_CACHED SCA_WRITEBACK[M] write-back [MP-coherent] + or LCA_EXCEPTION SCA_EXCEPTION (if unimplemented) +0x5 FCA_CACHED LCA_CACHED SCA_WRITEBACK_NOALLOC write-back no-allocate + or FCA_EXCEPTION LCA_EXCEPTION SCA_EXCEPTION (if unimplemented) +0x6..D FCA_EXCEPTION LCA_EXCEPTION SCA_EXCEPTION (reserved) +0xE FCA_EXCEPTION LCA_ISOLATE SCA_ISOLATE isolate +0xF FCA_EXCEPTION LCA_EXCEPTION SCA_EXCEPTION illegal + * Prior to T1020.2?, guard feature not supported, this defaulted to speculative (no _G) +*/ +#endif /*0*/ + + +#if !defined(_ASMLANGUAGE) && !defined(_NOCLANGUAGE) && !defined(__ASSEMBLER__) +#ifdef __cplusplus +extern "C" { +#endif + + +/*---------------------------------------------------------------------- + Register Windows + ----------------------------------------------------------------------*/ + +/* This spill any live register windows (other than the caller's): + * (NOTE: current implementation require privileged code, but + * a user-callable implementation is possible.) */ +extern void xthal_window_spill( void ); + + +/*---------------------------------------------------------------------- + Optional/Custom Processor State + ----------------------------------------------------------------------*/ + +/* validate & invalidate the TIE register file */ +extern void xthal_validate_cp(int); +extern void xthal_invalidate_cp(int); + +/* read and write cpenable register */ +extern void xthal_set_cpenable(unsigned); +extern unsigned xthal_get_cpenable(void); + + +/*---------------------------------------------------------------------- + Interrupts + ----------------------------------------------------------------------*/ + +/* the number of interrupt levels */ +extern const unsigned char Xthal_num_intlevels; +/* the number of interrupts */ +extern const unsigned char Xthal_num_interrupts; +/* the highest level of interrupts masked by PS.EXCM */ +extern const unsigned char Xthal_excm_level; + +/* mask for level of interrupts */ +extern const unsigned int Xthal_intlevel_mask[XTHAL_MAX_INTLEVELS]; +/* mask for level 0 to N interrupts */ +extern const unsigned int Xthal_intlevel_andbelow_mask[XTHAL_MAX_INTLEVELS]; + +/* level of each interrupt */ +extern const unsigned char Xthal_intlevel[XTHAL_MAX_INTERRUPTS]; + +/* type per interrupt */ +extern const unsigned char Xthal_inttype[XTHAL_MAX_INTERRUPTS]; + +/* masks of each type of interrupt */ +extern const unsigned int Xthal_inttype_mask[XTHAL_MAX_INTTYPES]; + +/* interrupt numbers assigned to each timer interrupt */ +extern const int Xthal_timer_interrupt[XTHAL_MAX_TIMERS]; + +/* INTENABLE,INTERRUPT,INTSET,INTCLEAR register access functions: */ +extern unsigned xthal_get_intenable( void ); +extern void xthal_set_intenable( unsigned ); +extern unsigned xthal_get_interrupt( void ); +#define xthal_get_intread xthal_get_interrupt /* backward compatibility */ +extern void xthal_set_intset( unsigned ); +extern void xthal_set_intclear( unsigned ); + + +/*---------------------------------------------------------------------- + Debug + ----------------------------------------------------------------------*/ + +/* Number of instruction and data break registers: */ +extern const int Xthal_num_ibreak; +extern const int Xthal_num_dbreak; + + +/*---------------------------------------------------------------------- + Core Counter + ----------------------------------------------------------------------*/ + +/* counter info */ +extern const unsigned char Xthal_have_ccount; /* set if CCOUNT register present */ +extern const unsigned char Xthal_num_ccompare; /* number of CCOMPAREn registers */ + +/* get CCOUNT register (if not present return 0) */ +extern unsigned xthal_get_ccount(void); + +/* set and get CCOMPAREn registers (if not present, get returns 0) */ +extern void xthal_set_ccompare(int, unsigned); +extern unsigned xthal_get_ccompare(int); + + +/*---------------------------------------------------------------------- + Miscellaneous + ----------------------------------------------------------------------*/ + +extern const unsigned char Xthal_have_prid; +extern const unsigned char Xthal_have_exceptions; +extern const unsigned char Xthal_xea_version; +extern const unsigned char Xthal_have_interrupts; +extern const unsigned char Xthal_have_highlevel_interrupts; +extern const unsigned char Xthal_have_nmi; + +extern unsigned xthal_get_prid( void ); + + +/*---------------------------------------------------------------------- + Virtual interrupt prioritization (DEPRECATED) + ----------------------------------------------------------------------*/ + +/* Convert between interrupt levels (as per PS.INTLEVEL) and virtual interrupt priorities: */ +extern unsigned xthal_vpri_to_intlevel(unsigned vpri); +extern unsigned xthal_intlevel_to_vpri(unsigned intlevel); + +/* Enables/disables given set (mask) of interrupts; returns previous enabled-mask of all ints: */ +extern unsigned xthal_int_enable(unsigned); +extern unsigned xthal_int_disable(unsigned); + +/* Set/get virtual priority of an interrupt: */ +extern int xthal_set_int_vpri(int intnum, int vpri); +extern int xthal_get_int_vpri(int intnum); + +/* Set/get interrupt lockout level for exclusive access to virtual priority data structures: */ +extern void xthal_set_vpri_locklevel(unsigned intlevel); +extern unsigned xthal_get_vpri_locklevel(void); + +/* Set/get current virtual interrupt priority: */ +extern unsigned xthal_set_vpri(unsigned vpri); +extern unsigned xthal_get_vpri(void); +extern unsigned xthal_set_vpri_intlevel(unsigned intlevel); +extern unsigned xthal_set_vpri_lock(void); + + +/*---------------------------------------------------------------------- + Generic Interrupt Trampolining Support (DEPRECATED) + ----------------------------------------------------------------------*/ + +typedef void (XtHalVoidFunc)(void); + +/* Bitmask of interrupts currently trampolining down: */ +extern unsigned Xthal_tram_pending; + +/* + * Bitmask of which interrupts currently trampolining down synchronously are + * actually enabled; this bitmask is necessary because INTENABLE cannot hold + * that state (sync-trampolining interrupts must be kept disabled while + * trampolining); in the current implementation, any bit set here is not set + * in INTENABLE, and vice-versa; once a sync-trampoline is handled (at level + * one), its enable bit must be moved from here to INTENABLE: + */ +extern unsigned Xthal_tram_enabled; + +/* Bitmask of interrupts configured for sync trampolining: */ +extern unsigned Xthal_tram_sync; + +/* Trampoline support functions: */ +extern unsigned xthal_tram_pending_to_service( void ); +extern void xthal_tram_done( unsigned serviced_mask ); +extern int xthal_tram_set_sync( int intnum, int sync ); +extern XtHalVoidFunc* xthal_set_tram_trigger_func( XtHalVoidFunc *trigger_fn ); + + +/*---------------------------------------------------------------------- + Internal Memories + ----------------------------------------------------------------------*/ + +extern const unsigned char Xthal_num_instrom; +extern const unsigned char Xthal_num_instram; +extern const unsigned char Xthal_num_datarom; +extern const unsigned char Xthal_num_dataram; +extern const unsigned char Xthal_num_xlmi; + +/* Each of the following arrays contains at least one entry, + * or as many entries as needed if more than one: */ +extern const unsigned int Xthal_instrom_vaddr[]; +extern const unsigned int Xthal_instrom_paddr[]; +extern const unsigned int Xthal_instrom_size []; +extern const unsigned int Xthal_instram_vaddr[]; +extern const unsigned int Xthal_instram_paddr[]; +extern const unsigned int Xthal_instram_size []; +extern const unsigned int Xthal_datarom_vaddr[]; +extern const unsigned int Xthal_datarom_paddr[]; +extern const unsigned int Xthal_datarom_size []; +extern const unsigned int Xthal_dataram_vaddr[]; +extern const unsigned int Xthal_dataram_paddr[]; +extern const unsigned int Xthal_dataram_size []; +extern const unsigned int Xthal_xlmi_vaddr[]; +extern const unsigned int Xthal_xlmi_paddr[]; +extern const unsigned int Xthal_xlmi_size []; + + +/*---------------------------------------------------------------------- + Cache + ----------------------------------------------------------------------*/ + +/* number of cache sets in log2(lines per way) */ +extern const unsigned char Xthal_icache_setwidth; +extern const unsigned char Xthal_dcache_setwidth; +/* cache set associativity (number of ways) */ +extern const unsigned int Xthal_icache_ways; +extern const unsigned int Xthal_dcache_ways; +/* cache features */ +extern const unsigned char Xthal_icache_line_lockable; +extern const unsigned char Xthal_dcache_line_lockable; + +/* cache attribute register control (used by other HAL routines) */ +extern unsigned xthal_get_cacheattr( void ); +extern unsigned xthal_get_icacheattr( void ); +extern unsigned xthal_get_dcacheattr( void ); +extern void xthal_set_cacheattr( unsigned ); +extern void xthal_set_icacheattr( unsigned ); +extern void xthal_set_dcacheattr( unsigned ); +/* set cache attribute (access modes) for a range of memory */ +extern int xthal_set_region_attribute( void *addr, unsigned size, + unsigned cattr, unsigned flags ); +/* Bits of flags parameter to xthal_set_region_attribute(): */ +#define XTHAL_CAFLAG_EXPAND 0x000100 /* only expand allowed access to range, don't reduce it */ +#define XTHAL_CAFLAG_EXACT 0x000200 /* return error if can't apply change to exact range specified */ +#define XTHAL_CAFLAG_NO_PARTIAL 0x000400 /* don't apply change to regions partially covered by range */ +#define XTHAL_CAFLAG_NO_AUTO_WB 0x000800 /* don't writeback data after leaving writeback attribute */ +#define XTHAL_CAFLAG_NO_AUTO_INV 0x001000 /* don't invalidate after disabling cache (entering bypass) */ + +/* enable caches */ +extern void xthal_icache_enable( void ); /* DEPRECATED */ +extern void xthal_dcache_enable( void ); /* DEPRECATED */ +/* disable caches */ +extern void xthal_icache_disable( void ); /* DEPRECATED */ +extern void xthal_dcache_disable( void ); /* DEPRECATED */ + +/* invalidate the caches */ +extern void xthal_icache_all_invalidate( void ); +extern void xthal_dcache_all_invalidate( void ); +/* write dirty data back */ +extern void xthal_dcache_all_writeback( void ); +/* write dirty data back and invalidate */ +extern void xthal_dcache_all_writeback_inv( void ); +/* prefetch and lock specified memory range into cache */ +extern void xthal_icache_region_lock( void *addr, unsigned size ); +extern void xthal_dcache_region_lock( void *addr, unsigned size ); +# ifndef XTHAL_USE_CACHE_MACROS +extern void xthal_icache_line_lock(void *addr); +extern void xthal_dcache_line_lock(void *addr); +# endif +/* unlock from cache */ +extern void xthal_icache_all_unlock( void ); +extern void xthal_dcache_all_unlock( void ); +extern void xthal_icache_region_unlock( void *addr, unsigned size ); +extern void xthal_dcache_region_unlock( void *addr, unsigned size ); +# ifndef XTHAL_USE_CACHE_MACROS +extern void xthal_icache_line_unlock(void *addr); +extern void xthal_dcache_line_unlock(void *addr); +# endif + + + +/*---------------------------------------------------------------------- + Local Memory ECC/Parity + ----------------------------------------------------------------------*/ + +/* Inject memory errors; flags is bit combination of XTHAL_MEMEP_F_xxx: */ +extern void xthal_memep_inject_error(void *addr, int size, int flags); + + + +/*---------------------------------------------------------------------- + Memory Management Unit + ----------------------------------------------------------------------*/ + +extern const unsigned char Xthal_have_spanning_way; +extern const unsigned char Xthal_have_identity_map; +extern const unsigned char Xthal_have_mimic_cacheattr; +extern const unsigned char Xthal_have_xlt_cacheattr; +extern const unsigned char Xthal_have_cacheattr; +extern const unsigned char Xthal_have_tlbs; + +extern const unsigned char Xthal_mmu_asid_bits; /* 0 .. 8 */ +extern const unsigned char Xthal_mmu_asid_kernel; +extern const unsigned char Xthal_mmu_rings; /* 1 .. 4 (perhaps 0 if no MMU and/or no protection?) */ +extern const unsigned char Xthal_mmu_ring_bits; +extern const unsigned char Xthal_mmu_sr_bits; +extern const unsigned char Xthal_mmu_ca_bits; +extern const unsigned int Xthal_mmu_max_pte_page_size; +extern const unsigned int Xthal_mmu_min_pte_page_size; + +extern const unsigned char Xthal_itlb_way_bits; +extern const unsigned char Xthal_itlb_ways; +extern const unsigned char Xthal_itlb_arf_ways; +extern const unsigned char Xthal_dtlb_way_bits; +extern const unsigned char Xthal_dtlb_ways; +extern const unsigned char Xthal_dtlb_arf_ways; + +/* Convert between virtual and physical addresses (through static maps only): */ +/*** WARNING: these two functions may go away in a future release; don't depend on them! ***/ +extern int xthal_static_v2p( unsigned vaddr, unsigned *paddrp ); +extern int xthal_static_p2v( unsigned paddr, unsigned *vaddrp, unsigned cached ); + +#define XCHAL_SUCCESS 0 +#define XCHAL_ADDRESS_MISALIGNED -1 +#define XCHAL_INEXACT -2 +#define XCHAL_INVALID_ADDRESS -3 +#define XCHAL_UNSUPPORTED_ON_THIS_ARCH -4 +#define XCHAL_NO_PAGES_MAPPED -5 +#define XTHAL_NO_MAPPING -6 + +#define XCHAL_CA_R (0xC0 | 0x40000000) +#define XCHAL_CA_RX (0xD0 | 0x40000000) +#define XCHAL_CA_RW (0xE0 | 0x40000000) +#define XCHAL_CA_RWX (0xF0 | 0x40000000) + +extern int xthal_set_region_translation(void* vaddr, void* paddr, unsigned size, unsigned cache_atr, unsigned flags); +extern int xthal_v2p(void*, void**, unsigned*, unsigned*); +extern int xthal_invalidate_region(void* addr); +extern int xthal_set_region_translation_raw(void *vaddr, void *paddr, unsigned cattr); + +#ifdef __cplusplus +} +#endif +#endif /*!_ASMLANGUAGE && !_NOCLANGUAGE && !__ASSEMBLER__ */ + +#endif /* !XTENSA_HAL_NON_PRIVILEGED_ONLY */ + + + + +/**************************************************************************** + EXPERIMENTAL and DEPRECATED Definitions + ****************************************************************************/ + + +#if !defined(_ASMLANGUAGE) && !defined(_NOCLANGUAGE) && !defined(__ASSEMBLER__) +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef INCLUDE_DEPRECATED_HAL_CODE +extern const unsigned char Xthal_have_old_exc_arch; +extern const unsigned char Xthal_have_mmu; +extern const unsigned int Xthal_num_regs; +extern const unsigned char Xthal_num_iroms; +extern const unsigned char Xthal_num_irams; +extern const unsigned char Xthal_num_droms; +extern const unsigned char Xthal_num_drams; +extern const unsigned int Xthal_configid0; +extern const unsigned int Xthal_configid1; +#endif + +#ifdef INCLUDE_DEPRECATED_HAL_DEBUG_CODE +#define XTHAL_24_BIT_BREAK 0x80000000 +#define XTHAL_16_BIT_BREAK 0x40000000 +extern const unsigned short Xthal_ill_inst_16[16]; +#define XTHAL_DEST_REG 0xf0000000 /* Mask for destination register */ +#define XTHAL_DEST_REG_INST 0x08000000 /* Branch address is in register */ +#define XTHAL_DEST_REL_INST 0x04000000 /* Branch address is relative */ +#define XTHAL_RFW_INST 0x00000800 +#define XTHAL_RFUE_INST 0x00000400 +#define XTHAL_RFI_INST 0x00000200 +#define XTHAL_RFE_INST 0x00000100 +#define XTHAL_RET_INST 0x00000080 +#define XTHAL_BREAK_INST 0x00000040 +#define XTHAL_SYSCALL_INST 0x00000020 +#define XTHAL_LOOP_END 0x00000010 /* Not set by xthal_inst_type */ +#define XTHAL_JUMP_INST 0x00000008 /* Call or jump instruction */ +#define XTHAL_BRANCH_INST 0x00000004 /* Branch instruction */ +#define XTHAL_24_BIT_INST 0x00000002 +#define XTHAL_16_BIT_INST 0x00000001 +typedef struct xthal_state { + unsigned pc; + unsigned ar[16]; + unsigned lbeg; + unsigned lend; + unsigned lcount; + unsigned extra_ptr; + unsigned cpregs_ptr[XTHAL_MAX_CPS]; +} XTHAL_STATE; +extern unsigned int xthal_inst_type(void *addr); +extern unsigned int xthal_branch_addr(void *addr); +extern unsigned int xthal_get_npc(XTHAL_STATE *user_state); +#endif /* INCLUDE_DEPRECATED_HAL_DEBUG_CODE */ + +#ifdef __cplusplus +} +#endif +#endif /*!_ASMLANGUAGE && !_NOCLANGUAGE && !__ASSEMBLER__ */ + +#endif /*XTENSA_HAL_H*/ + diff --git a/components/esp32/include/xtensa/jtag-xtensa.h b/components/esp32/include/xtensa/jtag-xtensa.h new file mode 100755 index 000000000..45ac1caa4 --- /dev/null +++ b/components/esp32/include/xtensa/jtag-xtensa.h @@ -0,0 +1,99 @@ +/* Copyright (c) 2011-2012 Tensilica Inc. ALL RIGHTS RESERVED. +// These coded instructions, statements, and computer programs are the +// copyrighted works and confidential proprietary information of Tensilica Inc. +// They may not be modified, copied, reproduced, distributed, or disclosed to +// third parties in any manner, medium, or form, in whole or in part, without +// the prior written consent of Tensilica Inc. +*/ + +#ifndef _JTAG_XTENSA_H_ +#define _JTAG_XTENSA_H_ + + +/* ---------------- JTAG registers ------------------ */ + +/* -- ER and later JTAG registers */ +typedef enum { + regIR, + regBypass, + regNAR, + regNDR, + regIdcode, + regPWRCTL, + regPWRSTAT, + regJtagMAX, +} xtensaJtagReg; + +/* -- pre-ER JTAG registers */ +typedef enum { + regOldIR, + regOldBypass, + regOldDIRW, + regOldDIR, + regOldDDR, + regOldDOSR, + regOldESR, + regOldDCR, + regOldTraxNDR, + regOldTraxNAR, + regOldMAX +} xtensaOldJtagReg; + + +/* ---------------- JTAG Instructions ------------------ */ + +/* -- pre-ER JTAG instructions */ +typedef enum { + ji_EnableOCD = 0x11, + ji_DebugInt, + ji_RetDebugInt, // TBD: remove + ji_DisRetOCD, // TBD: remove + ji_ExecuteDI, + ji_LoadDI, + ji_ScanDDR, + ji_ReadDOSR, + ji_ScanDCR, + ji_LoadWDI, + ji_TRAX = 0x1c, + ji_BYPASS = 0x1f, +} xtensaJtagInstruction; + +typedef enum { + OCDNormalMode, + OCDRunMode, + OCDHaltMode, + OCDStepMode +} xtensaMode; + +typedef struct { + xtensaMode mode; + int DRsel; + XTMP_core core; + XTMP_tap tap; + int core_num; + jtagReg_t *jtagRegs; + void *dap; // used for ARM DAP only + bool isBig; + int dir_array_option; // used by pre-ER devices only + // for testing, below - FIXME - delete later + int ocdReg; + unsigned int wr_data; + XTMP_event start_OCD_trans; + bool data_cycle; + bool data_pending; +} coreSlaveData_t; + + +enum OCD_ACCESS_TYPE{ + NEXUS_ACCESS, + CS_ACCESS, +}; + +// pre-ER Xtensa initializiation +EXTERN XTMP_deviceStatus +XTMP_jtagCoreSlaveEX(XTMP_component component, XTMP_jtagSlave slave, void* mydata); + +extern char *OCDrd; +extern char *OCDwr; + +#endif diff --git a/components/esp32/include/xtensa/lcd-splc780d-4bitmode-board.h b/components/esp32/include/xtensa/lcd-splc780d-4bitmode-board.h new file mode 100755 index 000000000..f4db58858 --- /dev/null +++ b/components/esp32/include/xtensa/lcd-splc780d-4bitmode-board.h @@ -0,0 +1,62 @@ +/******************************************************************************* +Copyright (c) 2009-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +These coded instructions, statements, and computer programs are the +copyrighted works and confidential proprietary information of Tensilica Inc. +They may not be modified, copied, reproduced, distributed, or disclosed to +third parties in any manner, medium, or form, in whole or in part, without +the prior written consent of Tensilica Inc. +-------------------------------------------------------------------------------- + +lcd-splc780d-4bitmode-board.h Board-specific LCD info for these boards: + Avnet AV110 (XT-AV110) + Xilinx ML605 (XT-ML605) + Xilinx KC705 (XT-KC705) + +Interface between board-independent driver and board-specific header. + +This is used by a board-independent SPLC780D LCD controller (4 bit mode) +driver to obtain board-specific information about LCD displays on the board, +such as the controller register base address and spacing (a function of how +the address lines are connected on the board) and length of the visible window +of the display (a function of the LCD panel the controller drives). +The driver doesnot refer directly to the board-specific header, which therefore is not +constrained to use macro names consistent with other boards. + +!! Must not contain any board-specific macro names (only controller specific) !! + +Included at compile-time via an include path specific to the board. + +The listed boards contain a single MYTech MOC-16216B-B display driven by +a Sunplus SPLC870D controller. + +*******************************************************************************/ + +#ifndef _LCD_SPLC780D_4BIT_BOARD_H +#define _LCD_SPLC780D_4BIT_BOARD_H + +#include /* Board info */ + + +/* Base address of the controller's registers. */ +#ifdef SPLC780D_4BIT_VADDR +#define SPLC780D_4BIT_REGBASE SPLC780D_4BIT_VADDR +#endif + +/* +The controller's registers are connected at word addresses on these boards. +Each byte-wide register appears as the least-significant-byte (LSB) of the +word regardless of the endianness of the processor (so if using word accesses +then endianness doesn't matter). +*/ +#define SPLC780D_4BIT_REGSPACING 4 +typedef unsigned splc780d_4bit_reg_t; + +/* Include generic information shared by all boards that use this device. */ +#include + + +/* Display limits of the LCD panel. */ +#define DISPLAY_VISIBLE_LEN 16 /* length (chars) of visible window */ + +#endif /* _LCD_SPLC780D_4BIT_BOARD_H */ + diff --git a/components/esp32/include/xtensa/lcd-splc780d-4bitmode.h b/components/esp32/include/xtensa/lcd-splc780d-4bitmode.h new file mode 100755 index 000000000..0a214bb40 --- /dev/null +++ b/components/esp32/include/xtensa/lcd-splc780d-4bitmode.h @@ -0,0 +1,105 @@ +/******************************************************************************* + +Copyright (c) 2009-2010 by Tensilica Inc. ALL RIGHTS RESERVED. +These coded instructions, statements, and computer programs are the +copyrighted works and confidential proprietary information of Tensilica Inc. +They may not be modified, copied, reproduced, distributed, or disclosed to +third parties in any manner, medium, or form, in whole or in part, without +the prior written consent of Tensilica Inc. +-------------------------------------------------------------------------------- + +lcd-SPLC780D-4bitmode.h Generic definitions for Sunplus SPLC780D LCD Controller +operating in 4 bit mode. + +This is used by board-support-packages with one or more LCD displays that use +a SPLC780D controller in 4 bit mode. A BSP provides a base address for each +instance of an SPLC780D LCD controller on the board. + +Note that LCD display operation is almost totally independent of the LCD +display, depending almost entirely on the controller. However the display +may limit the number of characters of the controller's RAM buffer that are +actually visible at one time. The length of the display's visible window +is not specifified in this controller-specific header, but comes to the +driver from the board-specific "display.h" header. + +*******************************************************************************/ + +#ifndef _LCD_SPLC780D_4BIT_H_ +#define _LCD_SPLC780D_4BIT_H_ + + +/* Offsets to controller registers from base. */ +#define SPLC780D_4BIT_INST 0 +#define SPLC780D_4BIT_DATA (SPLC780D_4BIT_INST + SPLC780D_4BIT_REGSPACING) + + +#define SPLC780D_4BIT_INST_INIT1 0xFF /* First command in + init sequence */ +#define SPLC780D_4BIT_INST_INIT2 0x30 /* Second command in + init sequence, + issued 3 times */ +#define SPLC780D_4BIT_INST_INIT3 0x20 /* Third and last command + in init sequence */ +#define SPLC780D_4BIT_INST_CLEAR 0x01 /* clear (blank) display) */ +#define SPLC780D_4BIT_INST_SET_MODE 0x28 /* Set LCD mode. Supported + setting is 4 bit data + length, 2 lines, 5*8 */ +#define SPLC780D_4BIT_INST_DSPLY_ON 0x0C /* Set Display ON */ +#define SPLC780D_4BIT_INST_CRSR_INC 0x06 /* Set cursor moving direction + as increment */ + +#define SPLC780D_4BIT_LINET_ADDR 0x80 /* clear (blank) display) */ +#define SPLC780D_4BIT_LINEB_ADDR 0xC0 /* clear (blank) display) */ + +#ifndef __ASSEMBLER__ + +/* C interface to controller registers. */ +struct splc780d_4bit_s { + splc780d_4bit_reg_t inst; /* instruction register */ + splc780d_4bit_reg_t data; /* data register */ +}; + +typedef volatile struct splc780d_4bit_s splc780d_4bit_t; + +/* +Prototypes of high level driver functions. +*/ + +/* Write an instruction byte to LCD, result in two back to back writes since the + * LCD is hooked up in 4 bit mode*/ +extern void lcd_write_inst_byte(splc780d_4bit_t *lcd, unsigned char inst); + +/* Write a data byte to LCD, result in two back to back writes since the + * LCD is hooked up in 4 bit mode*/ +extern void lcd_write_data_byte(splc780d_4bit_t *lcd, unsigned char data); + +/* +Initialize the display with default settings. +*/ +extern void splc780d_4bit_init_default(splc780d_4bit_t *lcd); + +/* +Write a single character at a given position (chars from left, starting at 0). +Wait long enough afterward for the controller to be ready for more input. +Positions beyond the end of the display are ignored. +*/ +extern void splc780d_4bit_write_char(splc780d_4bit_t *lcd, unsigned pos, const char c); + +/* +Write a string to the display starting at the left (position 0). +Blank-pad to or truncate at the end of the display (overwrites any previous +string so don't need to blank the display first). +Wait long enough after each char for the controller to be ready for more input. +*/ +extern void splc780d_4bit_write_string(splc780d_4bit_t *lcd, const char *s); + +/* +Blank (clear) the entire display. +Wait long enough afterward for the controller to be ready for more input. +*/ +extern void splc780d_4bit_blank(splc780d_4bit_t *lcd); + +#endif /* __ASSEMBLER__ */ + +#endif /* _LCD_SPLC780D_4BIT_H_ */ + diff --git a/components/esp32/include/xtensa/lcd-splc780d.h b/components/esp32/include/xtensa/lcd-splc780d.h new file mode 100755 index 000000000..4e878e905 --- /dev/null +++ b/components/esp32/include/xtensa/lcd-splc780d.h @@ -0,0 +1,151 @@ +/******************************************************************************* + +Copyright (c) 2006-2007 by Tensilica Inc. ALL RIGHTS RESERVED. +These coded instructions, statements, and computer programs are the +copyrighted works and confidential proprietary information of Tensilica Inc. +They may not be modified, copied, reproduced, distributed, or disclosed to +third parties in any manner, medium, or form, in whole or in part, without +the prior written consent of Tensilica Inc. +-------------------------------------------------------------------------------- + +lcd-SPLC780D.h Generic definitions for Sunplus SPLC780D LCD Controller + +This is used by board-support-packages with one or more LCD displays that use +a SPLC780D controller. A BSP provides a base address for each instance of an +SPLC780D LCD controller on the board. + +Note that LCD display operation is almost totally independent of the LCD +display, depending almost entirely on the controller. However the display +may limit the number of characters of the controller's RAM buffer that are +actually visible at one time. The length of the display's visible window +is not specifified in this controller-specific header, but comes to the +driver from the board-specific "display.h" header. + +*******************************************************************************/ + +#ifndef _LCD_SPLC780D_H_ +#define _LCD_SPLC780D_H_ + + +/* Offsets to controller registers from base. */ +#define SPLC780D_INST 0 +#define SPLC780D_DATA (SPLC780D_INST + SPLC780D_REGSPACING) + +/* +Bit fields and their values in the instruction register. +These fields are NOT orthogonal - they overlap! +Thus only one field may be written at a time, determined by the +most-significant 1 bit in the pattern (the field selector). +All less significant bits are part of the value of the selected field. +The fields and their values are grouped together to emphasize this format. +Field selector macro names end in '_' (implying something more needs +to be ORed) and the value macros are indented. The pattern written to a +bitfield is a bitwise OR of a field selector and one or more values, eg. + (SPLC780D_INST_ON_ | SPLC780D_INST_ON_DISPLAY | SPLC780D_INST_ON_CURSOR) +A single bit field (eg. SPCL780D_INST_HOME) need not have a value. + +NOTE: Controller requires a software delay after writing to the control +or data registers. For the data register it is 38us. For the control +register it is 38us for most bit fields, with the following exceptions: + SPLC780D_FUNC_ 100us. + SPLC780D_INST_CLEAR, SPLC780D_INST_HOME 1520us. +For more details and reset timing, see the SUNPLUS SPLC780D data sheet. +*/ + +#define SPLC780D_INST_CLEAR_ 0x1 /* clear (blank) display) */ + +#define SPLC780D_INST_HOME_ 0x2 /* home cursor and shift pos */ + +#define SPLC780D_INST_ENTRY_ 0x4 /* combine *ENTRY_* flags below */ +#define SPLC780D_INST_ENTRY_SHIFT 0x1 /* display shift on entry / not */ +#define SPLC780D_INST_ENTRY_INCR 0x2 /* cursor incr / decr */ +#define SPLC780D_INST_ENTRY_DECR 0 /* cursor incr / decr */ + +#define SPLC780D_INST_ON_ 0x8 /* combine *ON_* flags below */ +#define SPLC780D_INST_ON_DISPLAY 0x4 /* display on / off */ +#define SPLC780D_INST_ON_CURSOR 0x2 /* cursor on / off */ +#define SPLC780D_INST_ON_BLINK 0x1 /* blink on / off */ + +#define SPLC780D_INST_SHIFT_ 0x10 /* combine *SHIFT_* flags below */ +#define SPLC780D_INST_SHIFT_DISP 0x8 /* shift display / move cursor */ +#define SPLC780D_INST_SHIFT_CURS 0 /* shift display / move cursor */ +#define SPLC780D_INST_SHIFT_RIGHT 0x4 /* shift right / left */ +#define SPLC780D_INST_SHIFT_LEFT 0 /* shift right / left */ + +#define SPLC780D_INST_FUNC_ 0x20 /* combine *FUNC_* flags below */ +#define SPLC780D_INST_FUNC_8BIT 0x10 /* data length 8 bit / 4 bit */ +#define SPLC780D_INST_FUNC_4BIT 0 /* data length 8 bit / 4 bit */ +#define SPLC780D_INST_FUNC_2LINE 0x08 /* display lines 2 / 1 */ +#define SPLC780D_INST_FUNC_1LINE 0 /* display lines 2 / 1 */ +#define SPLC780D_INST_FUNC_F5x10 0x04 /* character font 5x10 / 5x8 */ +#define SPLC780D_INST_FUNC_F5x8 0 /* character font 5x10 / 5x8 */ + /* font must be 5x8 for 2 lines */ +#define SPLC780D_INST_CGEN_ 0x40 /* set char generator address */ +#define SPLC780D_INST_CGEN_ADDR 0x3F /* to address in this field */ +#define SPLC780D_INST_DRAM_ 0x80 /* set display data RAM address */ +#define SPLC780D_INST_DRAM_ADDR 0x7F /* to address in this field */ +#define SPLC780D_INST_DRAM_LINE2 0x40 /* address offset to line 2 */ +/* Controller limits */ +#define SPLC780D_RAMLEN_1LINE 0x50 /* length of line in RAM (1 line) */ +#define SPLC780D_RAMLEN_2LINE 0x28 /* length of line in RAM (2 line) */ + + +#ifndef __ASSEMBLER__ + +/* C interface to controller registers. */ +struct splc780d_s { + splc780d_reg_t inst; /* instruction register */ + splc780d_reg_t data; /* data register */ +}; + +typedef volatile struct splc780d_s splc780d_t; + +/* +Prototypes of high level driver functions. +*/ + +/* +Initialize the display with the FUNC_, ENTRY_ and ON_ fields as specified in +terms of the values above. The splc780d_init_default() macro is an example. +*/ +extern void splc780d_init(splc780d_t *lcd, + unsigned func, unsigned entry, unsigned on); + +/* +Initialize the display to default mode: 8-bit interface, 2 line, 5x8 font, +increment cursor on entry, display on (cursor and blinking off). +*/ +#define splc780d_init_default(lcd) \ + splc780d_init( lcd, \ + SPLC780D_INST_FUNC_8BIT \ + | SPLC780D_INST_FUNC_2LINE \ + | SPLC780D_INST_FUNC_F5x8, \ + SPLC780D_INST_ENTRY_INCR, \ + SPLC780D_INST_ON_DISPLAY \ + ) + +/* +Write a single character at a given position (chars from left, starting at 0). +Wait long enough afterward for the controller to be ready for more input. +Positions beyond the end of the display are ignored. +*/ +extern void splc780d_write_char(splc780d_t *lcd, unsigned pos, const char c); + +/* +Write a string to the display starting at the left (position 0). +Blank-pad to or truncate at the end of the display (overwrites any previous +string so don't need to blank the display first). +Wait long enough after each char for the controller to be ready for more input. +*/ +extern void splc780d_write_string(splc780d_t *lcd, const char *s); + +/* +Blank (clear) the entire display. +Wait long enough afterward for the controller to be ready for more input. +*/ +extern void splc780d_blank(splc780d_t *lcd); + +#endif /* __ASSEMBLER__ */ + +#endif /* _LCD_SPLC780D_H_ */ + diff --git a/components/esp32/include/xtensa/overlay.h b/components/esp32/include/xtensa/overlay.h new file mode 100755 index 000000000..e959cf512 --- /dev/null +++ b/components/esp32/include/xtensa/overlay.h @@ -0,0 +1,184 @@ +// overlay.h -- Overlay manager header file +// $Id$ + +// Copyright (c) 2013 Tensilica Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef OVERLAY_H +#define OVERLAY_H + + +#include + + +#ifdef __cplusplus +extern "C" { +#endif + +// Define this to turn off overlay support +#ifdef XT_DISABLE_OVERLAYS + +#define OVERLAY(n) +#define DECLARE_OVERLAY(n) + +#define xt_overlay_map(ov_id) +#define xt_overlay_map_async(ov_id) 0 +#define xt_overlay_map_in_progress() 0 +#define xt_overlay_get_id() 0 +#define xt_overlay_get_state(pc) 0 +#define xt_overlay_check_map(pc,ps,ovstate,sp) 0 + +#else + +// Shorthand for convenience and portability. +#define OVERLAY(n) __attribute__((overlay(n))) + +// Structure of the overlay table required by gdb and the overlay +// manager. Should not be accessed by user code unless overriding +// the load process. +struct ovly_table { + void * vma; // The overlay's mapped address. + unsigned int size; // The size of the overlay, in bytes. + void * lma; // The overlay's load address. + unsigned int mapped; // Non-zero if overlay is currently mapped; zero otherwise. +}; + +// Constructed by the linker. Required for gdb and for the overlay +// manager. Should not be accessed by user code unless overriding +// the load process. +extern struct ovly_table _ovly_table[]; + +// Functions. +void xt_overlay_map(int ov_id); +int xt_overlay_map_async(int ov_id); +int xt_overlay_map_in_progress(void); +unsigned int xt_overlay_get_state(unsigned int pc); +unsigned int xt_overlay_check_map(unsigned int * pc, unsigned int * ps, + unsigned int ovstate, unsigned int sp); +int xt_overlay_start_map(void * dst, void * src, unsigned int len, int ov_id); +int xt_overlay_is_mapping(int ov_id); +void xt_overlay_fatal_error(int ov_id); + + +// Returns the current overlay ID. If no overlay is mapped or an overlay +// is in the middle of being mapped, returns -1. Inlined to avoid calling +// out of overlay (wastes cycles, can end up reading wrong ID on interrupt +// activity). +// +static inline int xt_overlay_get_id(void) +{ +#pragma always_inline +extern short _mapping_id; +extern short _ovly_id; + + int ret; + unsigned int flags = XTOS_SET_INTLEVEL(15); + + if (_mapping_id >= 0) { + ret = -1; + } + else { + ret = _ovly_id; + } + + XTOS_RESTORE_INTLEVEL(flags); + return ret; +} + + +// The following macros are used to declare numbered overlays and generate +// the corresponding call stubs. Use as follows: +// +// DECLARE_OVERLAY(n) +// +// See documentation for more details. + +//#include + +// At this time overlays are not supported without windowing. +#if defined(__XTENSA_WINDOWED_ABI__) + +#define xstr(x) str(x) +#define str(x) #x + +// At entry, register a8 holds the return address and a9 holds the target +// function address. This stub saves a8 on the stack at (SP - 20) which +// is the only location that is safe for us to use. Then it allocates 32 +// bytes on the stack for working storage, loads the overlay number into +// a8, and jumps to the common handler. The common handler will make sure +// that the called function is loaded into memory before calling it. +// NOTE: we are using the stack area normally reserved for nested functions. +// This means nested functions cannot be used when overlays are in use. + +#define CALL_IN(num) \ + asm(".section .gnu.linkonce.t.overlay.call." xstr(num) ".text, \"ax\"\n" \ + ".global _overlay_call_in_" xstr(num) "_\n" \ + ".align 4\n" \ + "_overlay_call_in_" xstr(num) "_:\n" \ + "s32e a8, a1, -20\n" \ + "addi a8, a1, -32\n" \ + "movsp a1, a8\n" \ + "movi a8, " xstr(num) "\n" \ + "j _overlay_call_in_common\n" \ + ".size _overlay_call_in_" xstr(num) "_, . - _overlay_call_in_" xstr(num) "_\n"); + +// The call-out stub first calls the target function, then loads the overlay +// number into register a14 and jumps to the common handler. The handler will +// make sure that the caller function is present in memory before returning. +// Note that registers a10-a13 may contain return values so must be preserved. +// +// Because we came here via a call4, the return address is in a4, and the top +// 2 bits are set to the window increment. We'll restore the top 2 bits of +// the return address from the called function's address, assuming that both +// are in the same 1 GB segment. For now this is always true. + +#define CALL_OUT(num) \ + asm(".section .gnu.linkonce.t.overlay.call." xstr(num) ".text, \"ax\"\n" \ + ".global _overlay_call_out_" xstr(num) "_\n" \ + ".align 4\n" \ + "_overlay_call_out_" xstr(num) "_:\n" \ + "slli a4, a4, 2\n" \ + "srli a4, a4, 2\n" \ + "extui a8, a9, 30, 2\n" \ + "slli a8, a8, 30\n" \ + "or a4, a4, a8\n" \ + "callx8 a9\n" \ + "movi a14, " xstr(num) "\n" \ + "j _overlay_call_out_common\n" \ + ".size _overlay_call_out_" xstr(num) "_, . - _overlay_call_out_" xstr(num) "_\n"); + +// Generate a call-in and a call-out stub for each overlay. + +#define DECLARE_OVERLAY(num) \ + CALL_IN(num) \ + CALL_OUT(num) + +#endif // defined(__XTENSA_WINDOWED_ABI__) + +#endif // XT_DISABLE_OVERLAYS + +#ifdef __cplusplus +} +#endif + +#endif // OVERLAY_H + diff --git a/components/esp32/include/xtensa/overlay_os_asm.h b/components/esp32/include/xtensa/overlay_os_asm.h new file mode 100755 index 000000000..4adc044e6 --- /dev/null +++ b/components/esp32/include/xtensa/overlay_os_asm.h @@ -0,0 +1,140 @@ +// overlay_os_asm.h -- Overlay manager assembly macros for OS use. +// $Id$ + +// Copyright (c) 2013 Tensilica Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef OVERLAY_OS_ASM_H +#define OVERLAY_OS_ASM_H + +// The macros in here are intended to be used by RTOS task switch code +// to check overlay status. Such code is usually in assembly and cannot +// call C code without penalty. For C code usage, it is best to use the +// corresponding C functions from the library. + + +// Inline assembly version of xt_overlay_get_state(). The arguments are +// three AR registers (a0-a15): +// +// "pcreg" - should contain the outgoing task's PC, i.e. the point at +// which the task got interrupted. The return value is also +// returned in this register. +// "sr1/2" - Scratch registers. These must be distinct from "pcreg". +// +// The return value is a 32-bit result that should be saved with the +// task context and passed as-is to xt_overlay_check_map. + + .macro _xt_overlay_get_state pcreg sr1 sr2 + + movi \sr1, _mapping_id + movi \sr2, _ovly_id + l16si \sr1, \sr1, 0 + l16ui \sr2, \sr2, 0 + slli \sr1, \sr1, 16 + or \pcreg, \sr1, \sr2 + + .endm + + +// Inline assembly version of xt_overlay_check_map(). It requires 5 AR +// registers (a0-a15) as arguments. +// +// "pcreg" - should contain the interrupted task's PC, i.e. the point +// at which the task got interrupted. This will be adjusted +// if required. +// "psreg" - should contain the interrupted task's PS. This will be +// adjusted if required. +// "ovreg" - should contain the overlay state on entry. Contents may +// be clobbered. +// "spreg" - should contain the tasks stack pointer on entry. +// "sr1" - Scratch register. Must be distinct from any of the above. +// +// The return values are "pcreg" and "psreg" and these must be used +// to update the task's PC and PS. +// Note that this macro may store data below the "spreg" pointer. If +// it does, then it will also disable interrupts via the PS, so that +// the task resumes with all interrupts disabled (to avoid corrupting +// this data). +// +// (SP - 24) Overlay ID to restore +// (SP - 28) Task PC +// (SP - 32) Task PS + + .macro _xt_overlay_check_map pcreg psreg ovreg spreg sr1 + +// There are four cases to deal with: +// +// _ovly_id = -1, _mapping_id = -1 +// No overlay is mapped or mapping, nothing to do. +// +// _ovly_id >= 0, _mapping_id = -1 +// An overlay was mapped, check PC to see if we need a restore. +// +// _ovly_id = -1, _mapping_id >= 0 +// An overlay is being mapped. Either it belongs to this task, which +// implies that the PC is in the mapping function, or it does not +// belong to this task. Either way there is nothing to do. +// +// _ovly_id >= 0, _mapping_id >= 0 +// Illegal, cannot happen by design. Don't need to handle this. +// +// So, the logic is to check _ovly_id first. If this is >= 0, then +// we check the task PC. If the PC is in the regions of interest then +// we'll patch the return PC to invoke xt_overlay_restore. + +.L1: + extui \sr1, \ovreg, 0, 16 // Extract _ovly_id + bbsi.l \sr1, 15, .Lno // If -1 then we're done + mov \ovreg, \sr1 // Restore this one + +// Next check the PC to see if it falls within the ranges of interest. + +.L2: + movi \sr1, _overlay_vma // Is PC < VMA range ? + bltu \pcreg, \sr1, .L3 + movi \sr1, _overlay_vma_end // Is PC > VMA range ? + bgeu \pcreg, \sr1, .L3 + j .L4 // PC is in VMA range +.L3: + movi \sr1, _overlay_call_stubs_start // Is PC < call stubs range ? + bltu \pcreg, \sr1, .Lno + movi \sr1, _overlay_call_stubs_end // Is PC > call stubs range ? + bgeu \pcreg, \sr1, .Lno + +// If we get here then a restore is needed. Save the overlay ID, PC and PS. +// Return modified PC and PS so that xt_overlay_restore() will execute in +// the context of the task when resumed. Note that the OS resumption code +// may expect PS.EXCM to be set so we leave it as is in the return value. + +.L4: + s32e \ovreg, \spreg, -24 // Save overlay ID + s32e \pcreg, \spreg, -28 // Save task PC + s32e \psreg, \spreg, -32 // Save task PS + movi \pcreg, xt_overlay_restore // Adjust resumption PC + movi \sr1, 15 + or \psreg, \psreg, \sr1 // Set intlevel to highest +.Lno: + + .endm + +#endif // OVERLAY_OS_ASM_H + diff --git a/components/esp32/include/xtensa/sim.h b/components/esp32/include/xtensa/sim.h new file mode 100755 index 000000000..e02087c5c --- /dev/null +++ b/components/esp32/include/xtensa/sim.h @@ -0,0 +1,60 @@ +/* Copyright (c) 2004-2006 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* sim.h + * + * Definitions and prototypes for specific ISS SIMCALLs + * (ie. outside the standard C library). + */ + +#ifndef _INC_SIM_H_ +#define _INC_SIM_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Shortcuts for enabling/disabling profiling in the Xtensa ISS */ +extern void xt_iss_profile_enable(void); +extern void xt_iss_profile_disable(void); + +/* Shortcut for setting the trace level in the Xtensa ISS */ +extern void xt_iss_trace_level(unsigned level); + +/* Generic interface for passing client commands in the Xtensa ISS: + * returns 0 on success, -1 on failure. + */ +extern int xt_iss_client_command(const char *client, const char *command); + +/* Interface for switching simulation modes in the Xtensa ISS: + * returns 0 on success, -1 on failure. + */ +#define XT_ISS_CYCLE_ACCURATE 0 +#define XT_ISS_FUNCTIONAL 1 +extern int xt_iss_switch_mode(int mode); + + +/* Interface for waiting on a system synchronization event */ +extern void xt_iss_event_wait(unsigned event_id); + +/* Interface for firing a system synchronization event */ +extern void xt_iss_event_fire(unsigned event_id); + +/* Interface for invoking a user simcall action, + * which can be registered in XTMP or XTSC. + */ +extern int xt_iss_simcall(int arg1, int arg2, int arg3, + int arg4, int arg5, int arg6); + + +#ifdef __cplusplus +} +#endif + +#endif /*_INC_SIM_H_*/ + diff --git a/components/esp32/include/xtensa/simboard.h b/components/esp32/include/xtensa/simboard.h new file mode 100755 index 000000000..980b0b759 --- /dev/null +++ b/components/esp32/include/xtensa/simboard.h @@ -0,0 +1,71 @@ +/* + * Copyright (c) 2001 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +/* simboard.h - Xtensa ISS "Board" specific definitions */ + +#ifndef _INC_SIMBOARD_H_ +#define _INC_SIMBOARD_H_ + +#include +#include + + +/* + * Device addresses. + */ + +/* System ROM: */ +#define XTBOARD_ROM_SIZE XSHAL_ROM_SIZE +#ifdef XSHAL_ROM_VADDR +#define XTBOARD_ROM_VADDR XSHAL_ROM_VADDR +#endif +#ifdef XSHAL_ROM_PADDR +#define XTBOARD_ROM_PADDR XSHAL_ROM_PADDR +#endif + +/* System RAM: */ +#define XTBOARD_RAM_SIZE XSHAL_RAM_SIZE +#ifdef XSHAL_RAM_VADDR +#define XTBOARD_RAM_VADDR XSHAL_RAM_VADDR +#endif +#ifdef XSHAL_RAM_PADDR +#define XTBOARD_RAM_PADDR XSHAL_RAM_PADDR +#endif + + +/* + * Things that depend on device addresses. + */ + +#define XTBOARD_CACHEATTR_WRITEBACK XSHAL_ISS_CACHEATTR_WRITEBACK +#define XTBOARD_CACHEATTR_WRITEALLOC XSHAL_ISS_CACHEATTR_WRITEALLOC +#define XTBOARD_CACHEATTR_WRITETHRU XSHAL_ISS_CACHEATTR_WRITETHRU +#define XTBOARD_CACHEATTR_BYPASS XSHAL_ISS_CACHEATTR_BYPASS +#define XTBOARD_CACHEATTR_DEFAULT XSHAL_ISS_CACHEATTR_DEFAULT + +#define XTBOARD_BUSINT_PIPE_REGIONS 0 +#define XTBOARD_BUSINT_SDRAM_REGIONS 0 + + +#endif /*_INC_SIMBOARD_H_*/ + diff --git a/components/esp32/include/xtensa/simcall-errno.h b/components/esp32/include/xtensa/simcall-errno.h new file mode 100755 index 000000000..445ec9013 --- /dev/null +++ b/components/esp32/include/xtensa/simcall-errno.h @@ -0,0 +1,139 @@ +/* Error numbers for Xtensa ISS semihosting. */ + +/* Copyright (c) 2003 by Tensilica Inc. ALL RIGHTS RESERVED. + These coded instructions, statements, and computer programs are the + copyrighted works and confidential proprietary information of Tensilica Inc. + They may not be modified, copied, reproduced, distributed, or disclosed to + third parties in any manner, medium, or form, in whole or in part, without + the prior written consent of Tensilica Inc. */ + +#ifndef _SIMCALL_ERRNO_H +#define _SIMCALL_ERRNO_H + +/* Define the error numbers (using the default newlib values) with prefixes + so they can be used in ISS without conflicting with the host values. */ + +#define _SIMC_EPERM 1 +#define _SIMC_ENOENT 2 +#define _SIMC_ESRCH 3 +#define _SIMC_EINTR 4 +#define _SIMC_EIO 5 +#define _SIMC_ENXIO 6 +#define _SIMC_E2BIG 7 +#define _SIMC_ENOEXEC 8 +#define _SIMC_EBADF 9 +#define _SIMC_ECHILD 10 +#define _SIMC_EAGAIN 11 +#define _SIMC_ENOMEM 12 +#define _SIMC_EACCES 13 +#define _SIMC_EFAULT 14 +#define _SIMC_ENOTBLK 15 +#define _SIMC_EBUSY 16 +#define _SIMC_EEXIST 17 +#define _SIMC_EXDEV 18 +#define _SIMC_ENODEV 19 +#define _SIMC_ENOTDIR 20 +#define _SIMC_EISDIR 21 +#define _SIMC_EINVAL 22 +#define _SIMC_ENFILE 23 +#define _SIMC_EMFILE 24 +#define _SIMC_ENOTTY 25 +#define _SIMC_ETXTBSY 26 +#define _SIMC_EFBIG 27 +#define _SIMC_ENOSPC 28 +#define _SIMC_ESPIPE 29 +#define _SIMC_EROFS 30 +#define _SIMC_EMLINK 31 +#define _SIMC_EPIPE 32 +#define _SIMC_EDOM 33 +#define _SIMC_ERANGE 34 +#define _SIMC_ENOMSG 35 +#define _SIMC_EIDRM 36 +#define _SIMC_ECHRNG 37 +#define _SIMC_EL2NSYNC 38 +#define _SIMC_EL3HLT 39 +#define _SIMC_EL3RST 40 +#define _SIMC_ELNRNG 41 +#define _SIMC_EUNATCH 42 +#define _SIMC_ENOCSI 43 +#define _SIMC_EL2HLT 44 +#define _SIMC_EDEADLK 45 +#define _SIMC_ENOLCK 46 +#define _SIMC_EBADE 50 +#define _SIMC_EBADR 51 +#define _SIMC_EXFULL 52 +#define _SIMC_ENOANO 53 +#define _SIMC_EBADRQC 54 +#define _SIMC_EBADSLT 55 +#define _SIMC_EDEADLOCK 56 +#define _SIMC_EBFONT 57 +#define _SIMC_ENOSTR 60 +#define _SIMC_ENODATA 61 +#define _SIMC_ETIME 62 +#define _SIMC_ENOSR 63 +#define _SIMC_ENONET 64 +#define _SIMC_ENOPKG 65 +#define _SIMC_EREMOTE 66 +#define _SIMC_ENOLINK 67 +#define _SIMC_EADV 68 +#define _SIMC_ESRMNT 69 +#define _SIMC_ECOMM 70 +#define _SIMC_EPROTO 71 +#define _SIMC_EMULTIHOP 74 +#define _SIMC_ELBIN 75 +#define _SIMC_EDOTDOT 76 +#define _SIMC_EBADMSG 77 +#define _SIMC_EFTYPE 79 +#define _SIMC_ENOTUNIQ 80 +#define _SIMC_EBADFD 81 +#define _SIMC_EREMCHG 82 +#define _SIMC_ELIBACC 83 +#define _SIMC_ELIBBAD 84 +#define _SIMC_ELIBSCN 85 +#define _SIMC_ELIBMAX 86 +#define _SIMC_ELIBEXEC 87 +#define _SIMC_ENOSYS 88 +#define _SIMC_ENMFILE 89 +#define _SIMC_ENOTEMPTY 90 +#define _SIMC_ENAMETOOLONG 91 +#define _SIMC_ELOOP 92 +#define _SIMC_EOPNOTSUPP 95 +#define _SIMC_EPFNOSUPPORT 96 +#define _SIMC_ECONNRESET 104 +#define _SIMC_ENOBUFS 105 +#define _SIMC_EAFNOSUPPORT 106 +#define _SIMC_EPROTOTYPE 107 +#define _SIMC_ENOTSOCK 108 +#define _SIMC_ENOPROTOOPT 109 +#define _SIMC_ESHUTDOWN 110 +#define _SIMC_ECONNREFUSED 111 +#define _SIMC_EADDRINUSE 112 +#define _SIMC_ECONNABORTED 113 +#define _SIMC_ENETUNREACH 114 +#define _SIMC_ENETDOWN 115 +#define _SIMC_ETIMEDOUT 116 +#define _SIMC_EHOSTDOWN 117 +#define _SIMC_EHOSTUNREACH 118 +#define _SIMC_EINPROGRESS 119 +#define _SIMC_EALREADY 120 +#define _SIMC_EDESTADDRREQ 121 +#define _SIMC_EMSGSIZE 122 +#define _SIMC_EPROTONOSUPPORT 123 +#define _SIMC_ESOCKTNOSUPPORT 124 +#define _SIMC_EADDRNOTAVAIL 125 +#define _SIMC_ENETRESET 126 +#define _SIMC_EISCONN 127 +#define _SIMC_ENOTCONN 128 +#define _SIMC_ETOOMANYREFS 129 +#define _SIMC_EPROCLIM 130 +#define _SIMC_EUSERS 131 +#define _SIMC_EDQUOT 132 +#define _SIMC_ESTALE 133 +#define _SIMC_ENOTSUP 134 +#define _SIMC_ENOMEDIUM 135 +#define _SIMC_ENOSHARE 136 +#define _SIMC_ECASECLASH 137 +#define _SIMC_EILSEQ 138 +#define _SIMC_EOVERFLOW 139 + +#endif /* ! _SIMCALL_ERRNO_H */ diff --git a/components/esp32/include/xtensa/simcall-fcntl.h b/components/esp32/include/xtensa/simcall-fcntl.h new file mode 100755 index 000000000..1c03f5595 --- /dev/null +++ b/components/esp32/include/xtensa/simcall-fcntl.h @@ -0,0 +1,21 @@ +/* File control operations for Xtensa ISS semihosting. */ + +/* Copyright (c) 2003 by Tensilica Inc. ALL RIGHTS RESERVED. + These coded instructions, statements, and computer programs are the + copyrighted works and confidential proprietary information of Tensilica Inc. + They may not be modified, copied, reproduced, distributed, or disclosed to + third parties in any manner, medium, or form, in whole or in part, without + the prior written consent of Tensilica Inc. */ + +#ifndef _SIMCALL_FCNTL_H +#define _SIMCALL_FCNTL_H + +#define _SIMC_O_APPEND 0x0008 +#define _SIMC_O_NONBLOCK 0x0080 +#define _SIMC_O_CREAT 0x0100 +#define _SIMC_O_TRUNC 0x0200 +#define _SIMC_O_EXCL 0x0400 +#define _SIMC_O_TEXT 0x4000 +#define _SIMC_O_BINARY 0x8000 + +#endif /* ! _SIMCALL_FCNTL_H */ diff --git a/components/esp32/include/xtensa/simcall.h b/components/esp32/include/xtensa/simcall.h new file mode 100755 index 000000000..d71959eea --- /dev/null +++ b/components/esp32/include/xtensa/simcall.h @@ -0,0 +1,189 @@ +/* + * simcall.h - Simulator call numbers + * + * Software that runs on a simulated Xtensa processor using + * the instruction set simulator (ISS) can invoke simulator + * services using the SIMCALL instruction. The a2 register + * is set prior to executing SIMCALL to a "simcall number", + * indicating which service to invoke. This file defines the + * simcall numbers defined and/or supported by the Xtensa ISS. + * + * IMPORTANT NOTE: These numbers are highly subject to change! + * + * Copyright (c) 2002-2007 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +#ifndef SIMCALL_INCLUDED +#define SIMCALL_INCLUDED + +/* + * System call like services offered by the simulator host. + * These are modeled after the Linux 2.4 kernel system calls + * for Xtensa processors. However not all system calls and + * not all functionality of a given system call are implemented, + * or necessarily have well defined or equivalent semantics in + * the context of a simulation (as opposed to a Unix kernel). + * + * These services behave largely as if they had been invoked + * as a task in the simulator host's operating system + * (eg. files accessed are those of the simulator host). + * However, these SIMCALLs model a virtual operating system + * so that various definitions, bit assignments etc + * (eg. open mode bits, errno values, etc) are independent + * of the host operating system used to run the simulation. + * Rather these definitions are specific to the Xtensa ISS. + * This way Xtensa ISA code written to use these SIMCALLs + * can (in principle) be simulated on any host. + * + * Up to 6 parameters are passed in registers a3 to a8 + * (note the 6th parameter isn't passed on the stack, + * unlike windowed function calling conventions). + * The return value is in a2. A negative value in the + * range -4096 to -1 indicates a negated error code to be + * reported in errno with a return value of -1, otherwise + * the value in a2 is returned as is. + */ + +/* These #defines need to match what's in Xtensa/OS/vxworks/xtiss/simcalls.c */ + +#define SYS_nop 0 /* n/a - setup; used to flush register windows */ +#define SYS_exit 1 /*x*/ +#define SYS_fork 2 +#define SYS_read 3 /*x*/ +#define SYS_write 4 /*x*/ +#define SYS_open 5 /*x*/ +#define SYS_close 6 /*x*/ +#define SYS_rename 7 /*x 38 - waitpid */ +#define SYS_creat 8 /*x*/ +#define SYS_link 9 /*x (not implemented on WIN32) */ +#define SYS_unlink 10 /*x*/ +#define SYS_execv 11 /* n/a - execve */ +#define SYS_execve 12 /* 11 - chdir */ +#define SYS_pipe 13 /* 42 - time */ +#define SYS_stat 14 /* 106 - mknod */ +#define SYS_chmod 15 +#define SYS_chown 16 /* 202 - lchown */ +#define SYS_utime 17 /* 30 - break */ +#define SYS_wait 18 /* n/a - oldstat */ +#define SYS_lseek 19 /*x*/ +#define SYS_getpid 20 +#define SYS_isatty 21 /* n/a - mount */ +#define SYS_fstat 22 /* 108 - oldumount */ +#define SYS_time 23 /* 13 - setuid */ +#define SYS_gettimeofday 24 /*x 78 - getuid (not implemented on WIN32) */ +#define SYS_times 25 /*X 43 - stime (Xtensa-specific implementation) */ +#define SYS_socket 26 +#define SYS_sendto 27 +#define SYS_recvfrom 28 +#define SYS_select_one 29 /* not compitible select, one file descriptor at the time */ +#define SYS_bind 30 +#define SYS_ioctl 31 + +/* + * Other... + */ +#define SYS_iss_argc 1000 /* returns value of argc */ +#define SYS_iss_argv_size 1001 /* bytes needed for argv & arg strings */ +#define SYS_iss_set_argv 1002 /* saves argv & arg strings at given addr */ + +#define SYS_memset 1004 /* fill a range of memory (fast) */ + +/* + * SIMCALLs for the ferret memory debugger. All are invoked by + * libferret.a ... ( Xtensa/Target-Libs/ferret ) + */ +#define SYS_ferret 1010 +#define SYS_malloc 1011 +#define SYS_free 1012 +#define SYS_more_heap 1013 +#define SYS_no_heap 1014 +#define SYS_enter_ferret 1015 +#define SYS_leave_ferret 1016 + +/* + * SIMCALLs for ISS client commands + */ +#define SYS_profile_enable 1020 +#define SYS_profile_disable 1021 +#define SYS_trace_level 1022 +#define SYS_client_command 1023 + +/* + * SIMCALL for simulation mode switching + */ +#define SYS_sim_mode_switch 1030 + +/* + * SIMCALLs for XTMP/XTSC event notify and core stall + */ +#define SYS_event_fire 1040 +#define SYS_event_stall 1041 + +/* + * SIMCALLs for callbacks registered in XTMP/XTSC + */ +#define SYS_callback_first 100 +#define SYS_callback_last 999 + +/* + * User defined simcall + */ +#define SYS_user_simcall 100 + +#define SYS_xmpa_errinfo 200 +#define SYS_xmpa_proc_status 201 +#define SYS_xmpa_proc_start 202 +#define SYS_xmpa_proc_stop 203 +#define SYS_xmpa_proc_mem_read 204 +#define SYS_xmpa_proc_mem_write 205 +#define SYS_xmpa_proc_mem_fill 206 +#define SYS_xmpa_proc_reg_read 207 +#define SYS_xmpa_proc_reg_write 208 + + +/* + * Extra SIMCALLs for GDB: + */ +#define SYS_gdb_break -1 /* invoked by XTOS on user exceptions if EPC points + to a break.n/break, regardless of cause! */ +#define SYS_xmon_out -2 /* invoked by XMON: ... */ +#define SYS_xmon_in -3 /* invoked by XMON: ... */ +#define SYS_xmon_flush -4 /* invoked by XMON: ... */ +#define SYS_gdb_abort -5 /* invoked by XTOS in _xtos_panic() */ +#define SYS_gdb_illegal_inst -6 /* invoked by XTOS for illegal instructions (too deeply) */ +#define SYS_xmon_init -7 /* invoked by XMON: ... */ +#define SYS_gdb_enter_sktloop -8 /* invoked by XTOS on debug exceptions */ +#define SYS_unhandled_kernel_exc -9 /* invoked by XTOS for unhandled kernel exceptions */ +#define SYS_unhandled_user_exc -10 /* invoked by XTOS for unhandled user exceptions */ +#define SYS_unhandled_double_exc -11 /* invoked by XTOS for unhandled double exceptions */ +#define SYS_unhandled_highpri_interrupt -12 /* invoked by XTOS for unhandled high-priority interrupts */ +#define SYS_xmon_close -13 /* invoked by XMON: ... */ + +/* + * SIMCALLs for vxWorks xtiss BSP: + */ +#define SYS_setup_ppp_pipes -83 +#define SYS_log_msg -84 + +/* + * SYS_select_one specifiers + */ +#define XTISS_SELECT_ONE_READ 1 +#define XTISS_SELECT_ONE_WRITE 2 +#define XTISS_SELECT_ONE_EXCEPT 3 + +/* + * SIMCALL for client calling arbitrary code in a client plug in. + * see clients/xcc_instr to see how this works. + */ + +#define SYS_client 0xC0DECAFE + + + +#endif /* !SIMCALL_INCLUDED */ diff --git a/components/esp32/include/xtensa/specreg.h b/components/esp32/include/xtensa/specreg.h new file mode 100755 index 000000000..0b2edee01 --- /dev/null +++ b/components/esp32/include/xtensa/specreg.h @@ -0,0 +1,143 @@ +/* + * Xtensa Special Register symbolic names + */ + +/* $Id: //depot/rel/Eaglenest/Xtensa/OS/include/xtensa/specreg.h#2 $ */ + +/* + * Copyright (c) 2005-2011 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTENSA_SPECREG_H +#define XTENSA_SPECREG_H + +/* Special registers: */ +#define LBEG 0 +#define LEND 1 +#define LCOUNT 2 +#define SAR 3 +#define BR 4 +#define LITBASE 5 +#define SCOMPARE1 12 +#define ACCLO 16 +#define ACCHI 17 +#define MR_0 32 +#define MR_1 33 +#define MR_2 34 +#define MR_3 35 +#define PREFCTL 40 +#define WINDOWBASE 72 +#define WINDOWSTART 73 +#define PTEVADDR 83 +#define RASID 90 +#define ITLBCFG 91 +#define DTLBCFG 92 +#define IBREAKENABLE 96 +#define MEMCTL 97 +#define CACHEATTR 98 +#define ATOMCTL 99 +#define DDR 104 +#define MECR 110 +#define IBREAKA_0 128 +#define IBREAKA_1 129 +#define DBREAKA_0 144 +#define DBREAKA_1 145 +#define DBREAKC_0 160 +#define DBREAKC_1 161 +#define CONFIGID0 176 +#define EPC_1 177 +#define EPC_2 178 +#define EPC_3 179 +#define EPC_4 180 +#define EPC_5 181 +#define EPC_6 182 +#define EPC_7 183 +#define DEPC 192 +#define EPS_2 194 +#define EPS_3 195 +#define EPS_4 196 +#define EPS_5 197 +#define EPS_6 198 +#define EPS_7 199 +#define CONFIGID1 208 +#define EXCSAVE_1 209 +#define EXCSAVE_2 210 +#define EXCSAVE_3 211 +#define EXCSAVE_4 212 +#define EXCSAVE_5 213 +#define EXCSAVE_6 214 +#define EXCSAVE_7 215 +#define CPENABLE 224 +#define INTERRUPT 226 +#define INTREAD INTERRUPT /* alternate name for backward compatibility */ +#define INTSET INTERRUPT /* alternate name for backward compatibility */ +#define INTCLEAR 227 +#define INTENABLE 228 +#define PS 230 +#define VECBASE 231 +#define EXCCAUSE 232 +#define DEBUGCAUSE 233 +#define CCOUNT 234 +#define PRID 235 +#define ICOUNT 236 +#define ICOUNTLEVEL 237 +#define EXCVADDR 238 +#define CCOMPARE_0 240 +#define CCOMPARE_1 241 +#define CCOMPARE_2 242 +#define MISC_REG_0 244 +#define MISC_REG_1 245 +#define MISC_REG_2 246 +#define MISC_REG_3 247 + +/* Special cases (bases of special register series): */ +#define MR 32 +#define IBREAKA 128 +#define DBREAKA 144 +#define DBREAKC 160 +#define EPC 176 +#define EPS 192 +#define EXCSAVE 208 +#define CCOMPARE 240 +#define MISC_REG 244 + +/* Tensilica-defined user registers: */ +#if 0 +/*#define ... 21..24 */ /* (545CK) */ +/*#define ... 140..143 */ /* (545CK) */ +#define EXPSTATE 230 /* Diamond */ +#define THREADPTR 231 /* threadptr option */ +#define FCR 232 /* FPU */ +#define FSR 233 /* FPU */ +#define AE_OVF_SAR 240 /* HiFi2 */ +#define AE_BITHEAD 241 /* HiFi2 */ +#define AE_TS_FTS_BU_BP 242 /* HiFi2 */ +#define AE_SD_NO 243 /* HiFi2 */ +#define VSAR 240 /* VectraLX */ +#define ROUND_LO 242 /* VectraLX */ +#define ROUND_HI 243 /* VectraLX */ +#define CBEGIN 246 /* VectraLX */ +#define CEND 247 /* VectraLX */ +#endif + +#endif /* XTENSA_SPECREG_H */ + diff --git a/components/esp32/include/xtensa/tie/xt_DFP_assist.h b/components/esp32/include/xtensa/tie/xt_DFP_assist.h new file mode 100644 index 000000000..4d529ebd3 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_DFP_assist.h @@ -0,0 +1,96 @@ +/* Definitions for the xt_DFP_assist TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_DFP_assist_HEADER +#define _XTENSA_xt_DFP_assist_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_DFP_assist_F64ITER(unsigned arr /*inout*/, unsigned ars, unsigned art, immediate oper, immediate noshift); +extern unsigned _TIE_xt_DFP_assist_F64RND(unsigned ars, unsigned art, immediate mode); +extern void _TIE_xt_DFP_assist_F64ADDC(unsigned art /*inout*/, unsigned ars, immediate immZ, immediate immC); +extern void _TIE_xt_DFP_assist_F64SUBC(unsigned art /*inout*/, unsigned ars, immediate immZ, immediate immC); +extern unsigned _TIE_xt_DFP_assist_F64SIG(unsigned ars); +extern unsigned _TIE_xt_DFP_assist_F64CMPL(unsigned ars, unsigned art); +extern unsigned _TIE_xt_DFP_assist_F64CMPH(unsigned ars, unsigned art, immediate oper); +extern unsigned _TIE_xt_DFP_assist_F64NORM(unsigned ars, unsigned art, immediate mode); +extern unsigned _TIE_xt_DFP_assist_F64SEXP(unsigned ars, unsigned art); +extern unsigned _TIE_xt_DFP_assist_RF64R(immediate hilo); +extern void _TIE_xt_DFP_assist_WF64R(unsigned ars, unsigned art, immediate hilo); +extern unsigned _TIE_xt_DFP_assist_RUR_F64R_LO(void); +extern unsigned _TIE_xt_DFP_assist_RUR_F64R_HI(void); +extern void _TIE_xt_DFP_assist_WUR_F64R_LO(unsigned art); +extern void _TIE_xt_DFP_assist_WUR_F64R_HI(unsigned art); +extern unsigned _TIE_xt_DFP_assist_RUR_F64S(void); +extern void _TIE_xt_DFP_assist_WUR_F64S(unsigned art); +#define F64ITER _TIE_xt_DFP_assist_F64ITER +#define F64RND _TIE_xt_DFP_assist_F64RND +#define F64ADDC _TIE_xt_DFP_assist_F64ADDC +#define F64SUBC _TIE_xt_DFP_assist_F64SUBC +#define F64SIG _TIE_xt_DFP_assist_F64SIG +#define F64CMPL _TIE_xt_DFP_assist_F64CMPL +#define F64CMPH _TIE_xt_DFP_assist_F64CMPH +#define F64NORM _TIE_xt_DFP_assist_F64NORM +#define F64SEXP _TIE_xt_DFP_assist_F64SEXP +#define RF64R _TIE_xt_DFP_assist_RF64R +#define WF64R _TIE_xt_DFP_assist_WF64R +#define RUR_F64R_LO _TIE_xt_DFP_assist_RUR_F64R_LO +#define RF64R_LO _TIE_xt_DFP_assist_RUR_F64R_LO +#define RUR234 _TIE_xt_DFP_assist_RUR_F64R_LO +#define RUR_F64R_HI _TIE_xt_DFP_assist_RUR_F64R_HI +#define RF64R_HI _TIE_xt_DFP_assist_RUR_F64R_HI +#define RUR235 _TIE_xt_DFP_assist_RUR_F64R_HI +#define WUR_F64R_LO _TIE_xt_DFP_assist_WUR_F64R_LO +#define WF64R_LO _TIE_xt_DFP_assist_WUR_F64R_LO +#define WUR234 _TIE_xt_DFP_assist_WUR_F64R_LO +#define WUR_F64R_HI _TIE_xt_DFP_assist_WUR_F64R_HI +#define WF64R_HI _TIE_xt_DFP_assist_WUR_F64R_HI +#define WUR235 _TIE_xt_DFP_assist_WUR_F64R_HI +#define RUR_F64S _TIE_xt_DFP_assist_RUR_F64S +#define RF64S _TIE_xt_DFP_assist_RUR_F64S +#define RUR236 _TIE_xt_DFP_assist_RUR_F64S +#define WUR_F64S _TIE_xt_DFP_assist_WUR_F64S +#define WF64S _TIE_xt_DFP_assist_WUR_F64S +#define WUR236 _TIE_xt_DFP_assist_WUR_F64S + +#ifndef RUR +#define RUR(NUM) RUR##NUM() +#endif + +#ifndef WUR +#define WUR(VAL, NUM) WUR##NUM(VAL) +#endif + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_DFP_assist_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_FP.h b/components/esp32/include/xtensa/tie/xt_FP.h new file mode 100644 index 000000000..229a108ab --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_FP.h @@ -0,0 +1,197 @@ +/* Definitions for the xt_FP TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_FP_HEADER +#define _XTENSA_xt_FP_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include +#include +typedef float _TIE_xt_FP_xtfloat; +typedef _TIE_xt_FP_xtfloat xtfloat; + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_FP_RUR_FCR(void); +extern void _TIE_xt_FP_WUR_FCR(unsigned v); +extern unsigned _TIE_xt_FP_RUR_FSR(void); +extern void _TIE_xt_FP_WUR_FSR(unsigned v); +extern xtfloat _TIE_xt_FP_xtfloat_loadi(const xtfloat * p, immediate imm8x4); +extern void _TIE_xt_FP_xtfloat_storei(xtfloat t, xtfloat * p, immediate imm8x4); +extern void _TIE_xt_FP_xtfloat_loadip(xtfloat t /*out*/, const xtfloat * p /*inout*/, immediate imm8x4); +extern void _TIE_xt_FP_xtfloat_storeip(xtfloat t, xtfloat * p /*inout*/, immediate imm8x4); +extern xtfloat _TIE_xt_FP_xtfloat_loadx(const xtfloat * p, int imm8x4); +extern void _TIE_xt_FP_xtfloat_storex(xtfloat t, xtfloat * p, int imm8x4); +extern void _TIE_xt_FP_xtfloat_loadxp(xtfloat t /*out*/, const xtfloat * p /*inout*/, int imm8x4); +extern void _TIE_xt_FP_xtfloat_storexp(xtfloat t, xtfloat * p /*inout*/, int imm8x4); +extern xtfloat _TIE_xt_FP_xtfloat_move(xtfloat r); +extern int _TIE_xt_FP_ROUND_S(xtfloat s, immediate t); +extern int _TIE_xt_FP_TRUNC_S(xtfloat s, immediate t); +extern unsigned _TIE_xt_FP_UTRUNC_S(xtfloat s, immediate t); +extern int _TIE_xt_FP_FLOOR_S(xtfloat s, immediate t); +extern int _TIE_xt_FP_CEIL_S(xtfloat s, immediate t); +extern xtfloat _TIE_xt_FP_LSI(const xtfloat * p, immediate imm8x4); +extern void _TIE_xt_FP_SSI(xtfloat t, xtfloat * p, immediate imm8x4); +extern void _TIE_xt_FP_LSIP(xtfloat t /*out*/, const xtfloat * p /*inout*/, immediate imm8x4); +extern void _TIE_xt_FP_SSIP(xtfloat t, xtfloat * p /*inout*/, immediate imm8x4); +extern xtfloat _TIE_xt_FP_LSX(const xtfloat * p, int imm8x4); +extern void _TIE_xt_FP_SSX(xtfloat t, xtfloat * p, int imm8x4); +extern void _TIE_xt_FP_LSXP(xtfloat t /*out*/, const xtfloat * p /*inout*/, int imm8x4); +extern void _TIE_xt_FP_SSXP(xtfloat t, xtfloat * p /*inout*/, int imm8x4); +extern xtfloat _TIE_xt_FP_ABS_S(xtfloat s); +extern xtfloat _TIE_xt_FP_NEG_S(xtfloat s); +extern xtfloat _TIE_xt_FP_MOV_S(xtfloat s); +extern void _TIE_xt_FP_MOVEQZ_S(xtfloat r /*inout*/, xtfloat s, int t); +extern void _TIE_xt_FP_MOVNEZ_S(xtfloat r /*inout*/, xtfloat s, int t); +extern void _TIE_xt_FP_MOVLTZ_S(xtfloat r /*inout*/, xtfloat s, int t); +extern void _TIE_xt_FP_MOVGEZ_S(xtfloat r /*inout*/, xtfloat s, int t); +extern void _TIE_xt_FP_MOVF_S(xtfloat r /*inout*/, xtfloat s, xtbool t); +extern void _TIE_xt_FP_MOVT_S(xtfloat r /*inout*/, xtfloat s, xtbool t); +extern unsigned _TIE_xt_FP_RFR(xtfloat s); +extern xtfloat _TIE_xt_FP_WFR(unsigned s); +extern xtfloat _TIE_xt_FP_FLOAT_S(int s, immediate t); +extern xtfloat _TIE_xt_FP_UFLOAT_S(unsigned s, immediate t); +extern xtbool _TIE_xt_FP_OEQ_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_OLE_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_OLT_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_UEQ_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_ULE_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_ULT_S(xtfloat s, xtfloat t); +extern xtbool _TIE_xt_FP_UN_S(xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_ADD_S(xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_SUB_S(xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_MUL_S(xtfloat s, xtfloat t); +extern void _TIE_xt_FP_MADD_S(xtfloat r /*inout*/, xtfloat s, xtfloat t); +extern void _TIE_xt_FP_MSUB_S(xtfloat r /*inout*/, xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_RECIP0_S(xtfloat s); +extern xtfloat _TIE_xt_FP_DIV0_S(xtfloat s); +extern xtfloat _TIE_xt_FP_NEXP01_S(xtfloat s); +extern xtfloat _TIE_xt_FP_CONST_S(immediate s); +extern void _TIE_xt_FP_MKDADJ_S(xtfloat r /*inout*/, xtfloat s); +extern xtfloat _TIE_xt_FP_MKSADJ_S(xtfloat s); +extern void _TIE_xt_FP_ADDEXPM_S(xtfloat r /*inout*/, xtfloat s); +extern void _TIE_xt_FP_ADDEXP_S(xtfloat r /*inout*/, xtfloat s); +extern void _TIE_xt_FP_DIVN_S(xtfloat r /*inout*/, xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_RSQRT0_S(xtfloat s); +extern xtfloat _TIE_xt_FP_SQRT0_S(xtfloat s); +extern void _TIE_xt_FP_MADDN_S(xtfloat r /*inout*/, xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_DIV_S(xtfloat s, xtfloat t); +extern xtfloat _TIE_xt_FP_SQRT_S(xtfloat s); +extern xtfloat _TIE_xt_FP_RECIP_S(xtfloat s); +extern xtfloat _TIE_xt_FP_RSQRT_S(xtfloat s); +extern xtfloat _TIE_xt_FP_FSQRT_S(xtfloat s); +#define XT_RUR_FCR _TIE_xt_FP_RUR_FCR +#define RFCR _TIE_xt_FP_RUR_FCR +#define RUR232 _TIE_xt_FP_RUR_FCR +#define XT_WUR_FCR _TIE_xt_FP_WUR_FCR +#define WFCR _TIE_xt_FP_WUR_FCR +#define WUR232 _TIE_xt_FP_WUR_FCR +#define XT_RUR_FSR _TIE_xt_FP_RUR_FSR +#define RFSR _TIE_xt_FP_RUR_FSR +#define RUR233 _TIE_xt_FP_RUR_FSR +#define XT_WUR_FSR _TIE_xt_FP_WUR_FSR +#define WFSR _TIE_xt_FP_WUR_FSR +#define WUR233 _TIE_xt_FP_WUR_FSR +#define XT_xtfloat_loadi _TIE_xt_FP_xtfloat_loadi +#define XT_xtfloat_storei _TIE_xt_FP_xtfloat_storei +#define XT_xtfloat_loadip _TIE_xt_FP_xtfloat_loadip +#define XT_xtfloat_storeip _TIE_xt_FP_xtfloat_storeip +#define XT_xtfloat_loadx _TIE_xt_FP_xtfloat_loadx +#define XT_xtfloat_storex _TIE_xt_FP_xtfloat_storex +#define XT_xtfloat_loadxp _TIE_xt_FP_xtfloat_loadxp +#define XT_xtfloat_storexp _TIE_xt_FP_xtfloat_storexp +#define XT_xtfloat_move _TIE_xt_FP_xtfloat_move +#define XT_ROUND_S _TIE_xt_FP_ROUND_S +#define XT_TRUNC_S _TIE_xt_FP_TRUNC_S +#define XT_UTRUNC_S _TIE_xt_FP_UTRUNC_S +#define XT_FLOOR_S _TIE_xt_FP_FLOOR_S +#define XT_CEIL_S _TIE_xt_FP_CEIL_S +#define XT_LSI _TIE_xt_FP_LSI +#define XT_SSI _TIE_xt_FP_SSI +#define XT_LSIP _TIE_xt_FP_LSIP +#define XT_SSIP _TIE_xt_FP_SSIP +#define XT_LSX _TIE_xt_FP_LSX +#define XT_SSX _TIE_xt_FP_SSX +#define XT_LSXP _TIE_xt_FP_LSXP +#define XT_SSXP _TIE_xt_FP_SSXP +#define XT_ABS_S _TIE_xt_FP_ABS_S +#define XT_NEG_S _TIE_xt_FP_NEG_S +#define XT_MOV_S _TIE_xt_FP_MOV_S +#define XT_MOVEQZ_S _TIE_xt_FP_MOVEQZ_S +#define XT_MOVNEZ_S _TIE_xt_FP_MOVNEZ_S +#define XT_MOVLTZ_S _TIE_xt_FP_MOVLTZ_S +#define XT_MOVGEZ_S _TIE_xt_FP_MOVGEZ_S +#define XT_MOVF_S _TIE_xt_FP_MOVF_S +#define XT_MOVT_S _TIE_xt_FP_MOVT_S +#define XT_RFR _TIE_xt_FP_RFR +#define XT_WFR _TIE_xt_FP_WFR +#define XT_FLOAT_S _TIE_xt_FP_FLOAT_S +#define XT_UFLOAT_S _TIE_xt_FP_UFLOAT_S +#define XT_OEQ_S _TIE_xt_FP_OEQ_S +#define XT_OLE_S _TIE_xt_FP_OLE_S +#define XT_OLT_S _TIE_xt_FP_OLT_S +#define XT_UEQ_S _TIE_xt_FP_UEQ_S +#define XT_ULE_S _TIE_xt_FP_ULE_S +#define XT_ULT_S _TIE_xt_FP_ULT_S +#define XT_UN_S _TIE_xt_FP_UN_S +#define XT_ADD_S _TIE_xt_FP_ADD_S +#define XT_SUB_S _TIE_xt_FP_SUB_S +#define XT_MUL_S _TIE_xt_FP_MUL_S +#define XT_MADD_S _TIE_xt_FP_MADD_S +#define XT_MSUB_S _TIE_xt_FP_MSUB_S +#define XT_RECIP0_S _TIE_xt_FP_RECIP0_S +#define XT_DIV0_S _TIE_xt_FP_DIV0_S +#define XT_NEXP01_S _TIE_xt_FP_NEXP01_S +#define XT_CONST_S _TIE_xt_FP_CONST_S +#define XT_MKDADJ_S _TIE_xt_FP_MKDADJ_S +#define XT_MKSADJ_S _TIE_xt_FP_MKSADJ_S +#define XT_ADDEXPM_S _TIE_xt_FP_ADDEXPM_S +#define XT_ADDEXP_S _TIE_xt_FP_ADDEXP_S +#define XT_DIVN_S _TIE_xt_FP_DIVN_S +#define XT_RSQRT0_S _TIE_xt_FP_RSQRT0_S +#define XT_SQRT0_S _TIE_xt_FP_SQRT0_S +#define XT_MADDN_S _TIE_xt_FP_MADDN_S +#define XT_DIV_S _TIE_xt_FP_DIV_S +#define XT_SQRT_S _TIE_xt_FP_SQRT_S +#define XT_RECIP_S _TIE_xt_FP_RECIP_S +#define XT_RSQRT_S _TIE_xt_FP_RSQRT_S +#define XT_FSQRT_S _TIE_xt_FP_FSQRT_S + +#ifndef RUR +#define RUR(NUM) RUR##NUM() +#endif + +#ifndef WUR +#define WUR(VAL, NUM) WUR##NUM(VAL) +#endif + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_FP_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_MAC16.h b/components/esp32/include/xtensa/tie/xt_MAC16.h new file mode 100644 index 000000000..b46a1db7f --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_MAC16.h @@ -0,0 +1,239 @@ +/* Definitions for the xt_MAC16 TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_MAC16_HEADER +#define _XTENSA_xt_MAC16_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_MAC16_UMUL_AA_HH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_UMUL_AA_LH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_UMUL_AA_HL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_UMUL_AA_LL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MUL_AA_HH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MUL_AA_LH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MUL_AA_HL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MUL_AA_LL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MUL_AD_HH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MUL_AD_LH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MUL_AD_HL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MUL_AD_LL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MUL_DA_HH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MUL_DA_LH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MUL_DA_HL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MUL_DA_LL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MUL_DD_HH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MUL_DD_LH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MUL_DD_HL(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MUL_DD_LL(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULS_AA_HH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULS_AA_LH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULS_AA_HL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULS_AA_LL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULA_AA_HH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULA_AA_LH(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULA_AA_HL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULA_AA_LL(unsigned ars, unsigned art); +extern void _TIE_xt_MAC16_MULS_AD_HH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULS_AD_LH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULS_AD_HL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULS_AD_LL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULA_AD_HH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULA_AD_LH(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULA_AD_HL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULA_AD_LL(unsigned ars, immediate my); +extern void _TIE_xt_MAC16_MULS_DA_HH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULS_DA_LH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULS_DA_HL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULS_DA_LL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULA_DA_HH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULA_DA_LH(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULA_DA_HL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULA_DA_LL(immediate mx, unsigned art); +extern void _TIE_xt_MAC16_MULS_DD_HH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULS_DD_LH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULS_DD_HL(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULS_DD_LL(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULA_DD_HH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULA_DD_LH(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULA_DD_HL(immediate mx, immediate my); +extern void _TIE_xt_MAC16_MULA_DD_LL(immediate mx, immediate my); +extern unsigned _TIE_xt_MAC16_RSR_M0(void); +extern void _TIE_xt_MAC16_WSR_M0(unsigned art); +extern void _TIE_xt_MAC16_XSR_M0(unsigned art /*inout*/); +extern unsigned _TIE_xt_MAC16_RSR_M1(void); +extern void _TIE_xt_MAC16_WSR_M1(unsigned art); +extern void _TIE_xt_MAC16_XSR_M1(unsigned art /*inout*/); +extern unsigned _TIE_xt_MAC16_RSR_M2(void); +extern void _TIE_xt_MAC16_WSR_M2(unsigned art); +extern void _TIE_xt_MAC16_XSR_M2(unsigned art /*inout*/); +extern unsigned _TIE_xt_MAC16_RSR_M3(void); +extern void _TIE_xt_MAC16_WSR_M3(unsigned art); +extern void _TIE_xt_MAC16_XSR_M3(unsigned art /*inout*/); +extern unsigned _TIE_xt_MAC16_RSR_ACCLO(void); +extern void _TIE_xt_MAC16_WSR_ACCLO(unsigned art); +extern void _TIE_xt_MAC16_XSR_ACCLO(unsigned art /*inout*/); +extern unsigned _TIE_xt_MAC16_RSR_ACCHI(void); +extern void _TIE_xt_MAC16_WSR_ACCHI(unsigned art); +extern void _TIE_xt_MAC16_XSR_ACCHI(unsigned art /*inout*/); +extern void _TIE_xt_MAC16_MULA_DA_LL_LDDEC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_LL_LDINC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_HL_LDDEC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_HL_LDINC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_LH_LDDEC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_LH_LDINC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_HH_LDDEC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DA_HH_LDINC(immediate w, const short * s /*inout*/, immediate x, int t); +extern void _TIE_xt_MAC16_MULA_DD_LL_LDDEC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_LL_LDINC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_HL_LDDEC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_HL_LDINC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_LH_LDDEC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_LH_LDINC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_HH_LDDEC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_MULA_DD_HH_LDINC(immediate w, const short * s /*inout*/, immediate x, immediate y); +extern void _TIE_xt_MAC16_LDDEC(immediate w, const short * p /*inout*/); +extern void _TIE_xt_MAC16_ULDDEC(immediate w, const unsigned short * p /*inout*/); +extern void _TIE_xt_MAC16_SLDDEC(immediate w, const short * p /*inout*/); +extern void _TIE_xt_MAC16_LDINC(immediate w, const short * p /*inout*/); +extern void _TIE_xt_MAC16_ULDINC(immediate w, const unsigned short * p /*inout*/); +extern void _TIE_xt_MAC16_SLDINC(immediate w, const short * p /*inout*/); +extern int _TIE_xt_MAC16_RSR16(void); +extern void _TIE_xt_MAC16_WSR16(int t); +extern void _TIE_xt_MAC16_XSR16(int t /*inout*/); +extern int _TIE_xt_MAC16_RSR17(void); +extern void _TIE_xt_MAC16_WSR17(int t); +extern void _TIE_xt_MAC16_XSR17(int t /*inout*/); +#define XT_UMUL_AA_HH _TIE_xt_MAC16_UMUL_AA_HH +#define XT_UMUL_AA_LH _TIE_xt_MAC16_UMUL_AA_LH +#define XT_UMUL_AA_HL _TIE_xt_MAC16_UMUL_AA_HL +#define XT_UMUL_AA_LL _TIE_xt_MAC16_UMUL_AA_LL +#define XT_MUL_AA_HH _TIE_xt_MAC16_MUL_AA_HH +#define XT_MUL_AA_LH _TIE_xt_MAC16_MUL_AA_LH +#define XT_MUL_AA_HL _TIE_xt_MAC16_MUL_AA_HL +#define XT_MUL_AA_LL _TIE_xt_MAC16_MUL_AA_LL +#define XT_MUL_AD_HH _TIE_xt_MAC16_MUL_AD_HH +#define XT_MUL_AD_LH _TIE_xt_MAC16_MUL_AD_LH +#define XT_MUL_AD_HL _TIE_xt_MAC16_MUL_AD_HL +#define XT_MUL_AD_LL _TIE_xt_MAC16_MUL_AD_LL +#define XT_MUL_DA_HH _TIE_xt_MAC16_MUL_DA_HH +#define XT_MUL_DA_LH _TIE_xt_MAC16_MUL_DA_LH +#define XT_MUL_DA_HL _TIE_xt_MAC16_MUL_DA_HL +#define XT_MUL_DA_LL _TIE_xt_MAC16_MUL_DA_LL +#define XT_MUL_DD_HH _TIE_xt_MAC16_MUL_DD_HH +#define XT_MUL_DD_LH _TIE_xt_MAC16_MUL_DD_LH +#define XT_MUL_DD_HL _TIE_xt_MAC16_MUL_DD_HL +#define XT_MUL_DD_LL _TIE_xt_MAC16_MUL_DD_LL +#define XT_MULS_AA_HH _TIE_xt_MAC16_MULS_AA_HH +#define XT_MULS_AA_LH _TIE_xt_MAC16_MULS_AA_LH +#define XT_MULS_AA_HL _TIE_xt_MAC16_MULS_AA_HL +#define XT_MULS_AA_LL _TIE_xt_MAC16_MULS_AA_LL +#define XT_MULA_AA_HH _TIE_xt_MAC16_MULA_AA_HH +#define XT_MULA_AA_LH _TIE_xt_MAC16_MULA_AA_LH +#define XT_MULA_AA_HL _TIE_xt_MAC16_MULA_AA_HL +#define XT_MULA_AA_LL _TIE_xt_MAC16_MULA_AA_LL +#define XT_MULS_AD_HH _TIE_xt_MAC16_MULS_AD_HH +#define XT_MULS_AD_LH _TIE_xt_MAC16_MULS_AD_LH +#define XT_MULS_AD_HL _TIE_xt_MAC16_MULS_AD_HL +#define XT_MULS_AD_LL _TIE_xt_MAC16_MULS_AD_LL +#define XT_MULA_AD_HH _TIE_xt_MAC16_MULA_AD_HH +#define XT_MULA_AD_LH _TIE_xt_MAC16_MULA_AD_LH +#define XT_MULA_AD_HL _TIE_xt_MAC16_MULA_AD_HL +#define XT_MULA_AD_LL _TIE_xt_MAC16_MULA_AD_LL +#define XT_MULS_DA_HH _TIE_xt_MAC16_MULS_DA_HH +#define XT_MULS_DA_LH _TIE_xt_MAC16_MULS_DA_LH +#define XT_MULS_DA_HL _TIE_xt_MAC16_MULS_DA_HL +#define XT_MULS_DA_LL _TIE_xt_MAC16_MULS_DA_LL +#define XT_MULA_DA_HH _TIE_xt_MAC16_MULA_DA_HH +#define XT_MULA_DA_LH _TIE_xt_MAC16_MULA_DA_LH +#define XT_MULA_DA_HL _TIE_xt_MAC16_MULA_DA_HL +#define XT_MULA_DA_LL _TIE_xt_MAC16_MULA_DA_LL +#define XT_MULS_DD_HH _TIE_xt_MAC16_MULS_DD_HH +#define XT_MULS_DD_LH _TIE_xt_MAC16_MULS_DD_LH +#define XT_MULS_DD_HL _TIE_xt_MAC16_MULS_DD_HL +#define XT_MULS_DD_LL _TIE_xt_MAC16_MULS_DD_LL +#define XT_MULA_DD_HH _TIE_xt_MAC16_MULA_DD_HH +#define XT_MULA_DD_LH _TIE_xt_MAC16_MULA_DD_LH +#define XT_MULA_DD_HL _TIE_xt_MAC16_MULA_DD_HL +#define XT_MULA_DD_LL _TIE_xt_MAC16_MULA_DD_LL +#define XT_RSR_M0 _TIE_xt_MAC16_RSR_M0 +#define XT_WSR_M0 _TIE_xt_MAC16_WSR_M0 +#define XT_XSR_M0 _TIE_xt_MAC16_XSR_M0 +#define XT_RSR_M1 _TIE_xt_MAC16_RSR_M1 +#define XT_WSR_M1 _TIE_xt_MAC16_WSR_M1 +#define XT_XSR_M1 _TIE_xt_MAC16_XSR_M1 +#define XT_RSR_M2 _TIE_xt_MAC16_RSR_M2 +#define XT_WSR_M2 _TIE_xt_MAC16_WSR_M2 +#define XT_XSR_M2 _TIE_xt_MAC16_XSR_M2 +#define XT_RSR_M3 _TIE_xt_MAC16_RSR_M3 +#define XT_WSR_M3 _TIE_xt_MAC16_WSR_M3 +#define XT_XSR_M3 _TIE_xt_MAC16_XSR_M3 +#define XT_RSR_ACCLO _TIE_xt_MAC16_RSR_ACCLO +#define XT_WSR_ACCLO _TIE_xt_MAC16_WSR_ACCLO +#define XT_XSR_ACCLO _TIE_xt_MAC16_XSR_ACCLO +#define XT_RSR_ACCHI _TIE_xt_MAC16_RSR_ACCHI +#define XT_WSR_ACCHI _TIE_xt_MAC16_WSR_ACCHI +#define XT_XSR_ACCHI _TIE_xt_MAC16_XSR_ACCHI +#define XT_MULA_DA_LL_LDDEC _TIE_xt_MAC16_MULA_DA_LL_LDDEC +#define XT_MULA_DA_LL_LDINC _TIE_xt_MAC16_MULA_DA_LL_LDINC +#define XT_MULA_DA_HL_LDDEC _TIE_xt_MAC16_MULA_DA_HL_LDDEC +#define XT_MULA_DA_HL_LDINC _TIE_xt_MAC16_MULA_DA_HL_LDINC +#define XT_MULA_DA_LH_LDDEC _TIE_xt_MAC16_MULA_DA_LH_LDDEC +#define XT_MULA_DA_LH_LDINC _TIE_xt_MAC16_MULA_DA_LH_LDINC +#define XT_MULA_DA_HH_LDDEC _TIE_xt_MAC16_MULA_DA_HH_LDDEC +#define XT_MULA_DA_HH_LDINC _TIE_xt_MAC16_MULA_DA_HH_LDINC +#define XT_MULA_DD_LL_LDDEC _TIE_xt_MAC16_MULA_DD_LL_LDDEC +#define XT_MULA_DD_LL_LDINC _TIE_xt_MAC16_MULA_DD_LL_LDINC +#define XT_MULA_DD_HL_LDDEC _TIE_xt_MAC16_MULA_DD_HL_LDDEC +#define XT_MULA_DD_HL_LDINC _TIE_xt_MAC16_MULA_DD_HL_LDINC +#define XT_MULA_DD_LH_LDDEC _TIE_xt_MAC16_MULA_DD_LH_LDDEC +#define XT_MULA_DD_LH_LDINC _TIE_xt_MAC16_MULA_DD_LH_LDINC +#define XT_MULA_DD_HH_LDDEC _TIE_xt_MAC16_MULA_DD_HH_LDDEC +#define XT_MULA_DD_HH_LDINC _TIE_xt_MAC16_MULA_DD_HH_LDINC +#define XT_LDDEC _TIE_xt_MAC16_LDDEC +#define XT_ULDDEC _TIE_xt_MAC16_ULDDEC +#define XT_SLDDEC _TIE_xt_MAC16_SLDDEC +#define XT_LDINC _TIE_xt_MAC16_LDINC +#define XT_ULDINC _TIE_xt_MAC16_ULDINC +#define XT_SLDINC _TIE_xt_MAC16_SLDINC +#define XT_RSR16 _TIE_xt_MAC16_RSR16 +#define XT_WSR16 _TIE_xt_MAC16_WSR16 +#define XT_XSR16 _TIE_xt_MAC16_XSR16 +#define XT_RSR17 _TIE_xt_MAC16_RSR17 +#define XT_WSR17 _TIE_xt_MAC16_WSR17 +#define XT_XSR17 _TIE_xt_MAC16_XSR17 + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_MAC16_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_MUL32.h b/components/esp32/include/xtensa/tie/xt_MUL32.h new file mode 100644 index 000000000..91b3c3299 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_MUL32.h @@ -0,0 +1,24 @@ +/* Definitions for the 32-bit Integer Multiply Option. */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2009 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* NOTE: This file exists only for backward compatibility with RB-200X.x + and earlier Xtensa releases. Starting with RC-2009.0 you should use + . */ + +#ifndef _XTENSA_xt_MUL32_HEADER +#define _XTENSA_xt_MUL32_HEADER + +#ifdef __XTENSA__ + +#include + +#endif /* __XTENSA__ */ +#endif /* !_XTENSA_xt_MUL32_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_booleans.h b/components/esp32/include/xtensa/tie/xt_booleans.h new file mode 100644 index 000000000..94b5b468e --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_booleans.h @@ -0,0 +1,69 @@ +/* Definitions for the xt_booleans TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_booleans_HEADER +#define _XTENSA_xt_booleans_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include +typedef _TIE_xtbool xtbool; +typedef _TIE_xtbool2 xtbool2; +typedef _TIE_xtbool4 xtbool4; +typedef _TIE_xtbool8 xtbool8; +typedef _TIE_xtbool16 xtbool16; + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern xtbool _TIE_xt_booleans_XORB(xtbool bs, xtbool bt); +extern xtbool _TIE_xt_booleans_ORBC(xtbool bs, xtbool bt); +extern xtbool _TIE_xt_booleans_ORB(xtbool bs, xtbool bt); +extern xtbool _TIE_xt_booleans_ANDBC(xtbool bs, xtbool bt); +extern xtbool _TIE_xt_booleans_ANDB(xtbool bs, xtbool bt); +extern xtbool _TIE_xt_booleans_ALL4(xtbool4 bs4); +extern xtbool _TIE_xt_booleans_ANY4(xtbool4 bs4); +extern xtbool _TIE_xt_booleans_ALL8(xtbool8 bs8); +extern xtbool _TIE_xt_booleans_ANY8(xtbool8 bs8); +extern void _TIE_xt_booleans_MOVT(unsigned arr /*inout*/, unsigned ars, xtbool bt); +extern void _TIE_xt_booleans_MOVF(unsigned arr /*inout*/, unsigned ars, xtbool bt); +#define XT_XORB _TIE_xt_booleans_XORB +#define XT_ORBC _TIE_xt_booleans_ORBC +#define XT_ORB _TIE_xt_booleans_ORB +#define XT_ANDBC _TIE_xt_booleans_ANDBC +#define XT_ANDB _TIE_xt_booleans_ANDB +#define XT_ALL4 _TIE_xt_booleans_ALL4 +#define XT_ANY4 _TIE_xt_booleans_ANY4 +#define XT_ALL8 _TIE_xt_booleans_ALL8 +#define XT_ANY8 _TIE_xt_booleans_ANY8 +#define XT_MOVT _TIE_xt_booleans_MOVT +#define XT_MOVF _TIE_xt_booleans_MOVF + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_booleans_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_coprocessors.h b/components/esp32/include/xtensa/tie/xt_coprocessors.h new file mode 100644 index 000000000..27215cf1c --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_coprocessors.h @@ -0,0 +1,48 @@ +/* Definitions for the xt_coprocessors TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_coprocessors_HEADER +#define _XTENSA_xt_coprocessors_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_coprocessors_RSR_CPENABLE(void); +extern void _TIE_xt_coprocessors_WSR_CPENABLE(unsigned art); +extern void _TIE_xt_coprocessors_XSR_CPENABLE(unsigned art /*inout*/); +#define XT_RSR_CPENABLE _TIE_xt_coprocessors_RSR_CPENABLE +#define XT_WSR_CPENABLE _TIE_xt_coprocessors_WSR_CPENABLE +#define XT_XSR_CPENABLE _TIE_xt_coprocessors_XSR_CPENABLE + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_coprocessors_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_core.h b/components/esp32/include/xtensa/tie/xt_core.h new file mode 100644 index 000000000..469b199e6 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_core.h @@ -0,0 +1,395 @@ +/* Definitions for the xt_core TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_core_HEADER +#define _XTENSA_xt_core_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_core_ILL(void); +extern void _TIE_xt_core_NOP(void); +extern void _TIE_xt_core_SIMCALL(void); +extern void _TIE_xt_core_MEMW(void); +extern void _TIE_xt_core_EXTW(void); +extern void _TIE_xt_core_ISYNC(void); +extern void _TIE_xt_core_DSYNC(void); +extern void _TIE_xt_core_ESYNC(void); +extern void _TIE_xt_core_RSYNC(void); +extern unsigned _TIE_xt_core_RSR_LBEG(void); +extern void _TIE_xt_core_WSR_LBEG(unsigned art); +extern void _TIE_xt_core_XSR_LBEG(unsigned art /*inout*/); +extern unsigned _TIE_xt_core_RSR_CONFIGID0(void); +extern void _TIE_xt_core_WSR_CONFIGID0(unsigned art); +extern unsigned _TIE_xt_core_RSR_CONFIGID1(void); +extern unsigned _TIE_xt_core_RUR_THREADPTR(void); +extern void _TIE_xt_core_WUR_THREADPTR(unsigned v); +extern unsigned _TIE_xt_core_uint32_loadi(const unsigned * p, immediate o); +extern void _TIE_xt_core_uint32_storei(unsigned c, unsigned * p, immediate o); +extern unsigned _TIE_xt_core_uint32_move(unsigned b); +extern int _TIE_xt_core_ADDI(int s, immediate i); +extern int _TIE_xt_core_OR(int s, int t); +extern int _TIE_xt_core_L32I(const int * p, immediate i); +extern void _TIE_xt_core_S32I(int r, int * p, immediate i); +extern void _TIE_xt_core_S32NB(int r, int * p, immediate i); +extern unsigned char _TIE_xt_core_L8UI(const unsigned char * p, immediate i); +extern void _TIE_xt_core_S8I(signed char r, signed char * p, immediate i); +extern unsigned short _TIE_xt_core_L16UI(const unsigned short * p, immediate i); +extern short _TIE_xt_core_L16SI(const short * p, immediate i); +extern void _TIE_xt_core_S16I(short r, short * p, immediate i); +extern int _TIE_xt_core_ADDMI(int s, immediate i); +extern int _TIE_xt_core_ADD(int s, int t); +extern int _TIE_xt_core_ADDX2(int s, int t); +extern int _TIE_xt_core_ADDX4(int s, int t); +extern int _TIE_xt_core_ADDX8(int s, int t); +extern int _TIE_xt_core_SUB(int s, int t); +extern int _TIE_xt_core_SUBX2(int s, int t); +extern int _TIE_xt_core_SUBX4(int s, int t); +extern int _TIE_xt_core_SUBX8(int s, int t); +extern int _TIE_xt_core_AND(int s, int t); +extern int _TIE_xt_core_XOR(int s, int t); +extern unsigned _TIE_xt_core_EXTUI(unsigned t, immediate i, immediate o); +extern int _TIE_xt_core_MOVI(immediate i); +extern void _TIE_xt_core_MOVEQZ(int r /*inout*/, int s, int t); +extern void _TIE_xt_core_MOVNEZ(int r /*inout*/, int s, int t); +extern void _TIE_xt_core_MOVLTZ(int r /*inout*/, int s, int t); +extern void _TIE_xt_core_MOVGEZ(int r /*inout*/, int s, int t); +extern int _TIE_xt_core_NEG(int t); +extern int _TIE_xt_core_ABS(int t); +extern void _TIE_xt_core_SSR(int s); +extern void _TIE_xt_core_SSL(int s); +extern void _TIE_xt_core_SSA8L(int s); +extern void _TIE_xt_core_SSA8B(int s); +extern void _TIE_xt_core_SSAI(immediate i); +extern int _TIE_xt_core_SLL(int s); +extern int _TIE_xt_core_SRC(int s, int t); +extern unsigned _TIE_xt_core_SRL(unsigned t); +extern int _TIE_xt_core_SRA(int t); +extern int _TIE_xt_core_SLLI(int s, immediate i); +extern int _TIE_xt_core_SRAI(int t, immediate i); +extern unsigned _TIE_xt_core_SRLI(unsigned t, immediate i); +extern int _TIE_xt_core_SSAI_SRC(int src1, int src2, immediate amount); +extern int _TIE_xt_core_SSR_SRC(int src1, int src2, int amount); +extern int _TIE_xt_core_WSR_SAR_SRC(int src1, int src2, int amount); +extern int _TIE_xt_core_SSR_SRA(int src, int amount); +extern unsigned _TIE_xt_core_SSR_SRL(unsigned src, int amount); +extern int _TIE_xt_core_SSL_SLL(int src, int amount); +extern int _TIE_xt_core_RSIL(immediate t); +extern int _TIE_xt_core_RSR_LEND(void); +extern void _TIE_xt_core_WSR_LEND(int t); +extern void _TIE_xt_core_XSR_LEND(int t /*inout*/); +extern int _TIE_xt_core_RSR_LCOUNT(void); +extern void _TIE_xt_core_WSR_LCOUNT(int t); +extern void _TIE_xt_core_XSR_LCOUNT(int t /*inout*/); +extern unsigned _TIE_xt_core_RSR_SAR(void); +extern void _TIE_xt_core_WSR_SAR(unsigned t); +extern void _TIE_xt_core_XSR_SAR(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_MEMCTL(void); +extern void _TIE_xt_core_WSR_MEMCTL(unsigned t); +extern void _TIE_xt_core_XSR_MEMCTL(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_LITBASE(void); +extern void _TIE_xt_core_WSR_LITBASE(unsigned t); +extern void _TIE_xt_core_XSR_LITBASE(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_PS(void); +extern void _TIE_xt_core_WSR_PS(unsigned t); +extern void _TIE_xt_core_XSR_PS(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC1(void); +extern void _TIE_xt_core_WSR_EPC1(unsigned t); +extern void _TIE_xt_core_XSR_EPC1(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE1(void); +extern void _TIE_xt_core_WSR_EXCSAVE1(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE1(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC2(void); +extern void _TIE_xt_core_WSR_EPC2(unsigned t); +extern void _TIE_xt_core_XSR_EPC2(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE2(void); +extern void _TIE_xt_core_WSR_EXCSAVE2(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE2(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC3(void); +extern void _TIE_xt_core_WSR_EPC3(unsigned t); +extern void _TIE_xt_core_XSR_EPC3(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE3(void); +extern void _TIE_xt_core_WSR_EXCSAVE3(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE3(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC4(void); +extern void _TIE_xt_core_WSR_EPC4(unsigned t); +extern void _TIE_xt_core_XSR_EPC4(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE4(void); +extern void _TIE_xt_core_WSR_EXCSAVE4(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE4(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC5(void); +extern void _TIE_xt_core_WSR_EPC5(unsigned t); +extern void _TIE_xt_core_XSR_EPC5(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE5(void); +extern void _TIE_xt_core_WSR_EXCSAVE5(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE5(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC6(void); +extern void _TIE_xt_core_WSR_EPC6(unsigned t); +extern void _TIE_xt_core_XSR_EPC6(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE6(void); +extern void _TIE_xt_core_WSR_EXCSAVE6(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE6(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPC7(void); +extern void _TIE_xt_core_WSR_EPC7(unsigned t); +extern void _TIE_xt_core_XSR_EPC7(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCSAVE7(void); +extern void _TIE_xt_core_WSR_EXCSAVE7(unsigned t); +extern void _TIE_xt_core_XSR_EXCSAVE7(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_VECBASE(void); +extern void _TIE_xt_core_WSR_VECBASE(unsigned t); +extern void _TIE_xt_core_XSR_VECBASE(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS2(void); +extern void _TIE_xt_core_WSR_EPS2(unsigned t); +extern void _TIE_xt_core_XSR_EPS2(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS3(void); +extern void _TIE_xt_core_WSR_EPS3(unsigned t); +extern void _TIE_xt_core_XSR_EPS3(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS4(void); +extern void _TIE_xt_core_WSR_EPS4(unsigned t); +extern void _TIE_xt_core_XSR_EPS4(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS5(void); +extern void _TIE_xt_core_WSR_EPS5(unsigned t); +extern void _TIE_xt_core_XSR_EPS5(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS6(void); +extern void _TIE_xt_core_WSR_EPS6(unsigned t); +extern void _TIE_xt_core_XSR_EPS6(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EPS7(void); +extern void _TIE_xt_core_WSR_EPS7(unsigned t); +extern void _TIE_xt_core_XSR_EPS7(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCCAUSE(void); +extern void _TIE_xt_core_WSR_EXCCAUSE(unsigned t); +extern void _TIE_xt_core_XSR_EXCCAUSE(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_EXCVADDR(void); +extern void _TIE_xt_core_WSR_EXCVADDR(unsigned t); +extern void _TIE_xt_core_XSR_EXCVADDR(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_DEPC(void); +extern void _TIE_xt_core_WSR_DEPC(unsigned t); +extern void _TIE_xt_core_XSR_DEPC(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_MISC0(void); +extern void _TIE_xt_core_WSR_MISC0(unsigned t); +extern void _TIE_xt_core_XSR_MISC0(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_MISC1(void); +extern void _TIE_xt_core_WSR_MISC1(unsigned t); +extern void _TIE_xt_core_XSR_MISC1(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_MISC2(void); +extern void _TIE_xt_core_WSR_MISC2(unsigned t); +extern void _TIE_xt_core_XSR_MISC2(unsigned t /*inout*/); +extern unsigned _TIE_xt_core_RSR_MISC3(void); +extern void _TIE_xt_core_WSR_MISC3(unsigned t); +extern void _TIE_xt_core_XSR_MISC3(unsigned t /*inout*/); +extern int _TIE_xt_core_RSR_PRID(void); +#define XT_ILL _TIE_xt_core_ILL +#define XT_NOP _TIE_xt_core_NOP +#define XT_SIMCALL _TIE_xt_core_SIMCALL +#define XT_MEMW _TIE_xt_core_MEMW +#define XT_EXTW _TIE_xt_core_EXTW +#define XT_ISYNC _TIE_xt_core_ISYNC +#define XT_DSYNC _TIE_xt_core_DSYNC +#define XT_ESYNC _TIE_xt_core_ESYNC +#define XT_RSYNC _TIE_xt_core_RSYNC +#define XT_RSR_LBEG _TIE_xt_core_RSR_LBEG +#define XT_WSR_LBEG _TIE_xt_core_WSR_LBEG +#define XT_XSR_LBEG _TIE_xt_core_XSR_LBEG +#define XT_RSR_CONFIGID0 _TIE_xt_core_RSR_CONFIGID0 +#define XT_WSR_CONFIGID0 _TIE_xt_core_WSR_CONFIGID0 +#define XT_RSR_CONFIGID1 _TIE_xt_core_RSR_CONFIGID1 +#define XT_RUR_THREADPTR _TIE_xt_core_RUR_THREADPTR +#define RTHREADPTR _TIE_xt_core_RUR_THREADPTR +#define RUR231 _TIE_xt_core_RUR_THREADPTR +#define XT_WUR_THREADPTR _TIE_xt_core_WUR_THREADPTR +#define WTHREADPTR _TIE_xt_core_WUR_THREADPTR +#define WUR231 _TIE_xt_core_WUR_THREADPTR +#define XT_uint32_loadi _TIE_xt_core_uint32_loadi +#define XT_uint32_storei _TIE_xt_core_uint32_storei +#define XT_uint32_move _TIE_xt_core_uint32_move +#define XT_ADDI _TIE_xt_core_ADDI +#define XT_OR _TIE_xt_core_OR +#define XT_L32I _TIE_xt_core_L32I +#define XT_S32I _TIE_xt_core_S32I +#define XT_S32NB _TIE_xt_core_S32NB +#define XT_L8UI _TIE_xt_core_L8UI +#define XT_S8I _TIE_xt_core_S8I +#define XT_L16UI _TIE_xt_core_L16UI +#define XT_L16SI _TIE_xt_core_L16SI +#define XT_S16I _TIE_xt_core_S16I +#define XT_ADDMI _TIE_xt_core_ADDMI +#define XT_ADD _TIE_xt_core_ADD +#define XT_ADDX2 _TIE_xt_core_ADDX2 +#define XT_ADDX4 _TIE_xt_core_ADDX4 +#define XT_ADDX8 _TIE_xt_core_ADDX8 +#define XT_SUB _TIE_xt_core_SUB +#define XT_SUBX2 _TIE_xt_core_SUBX2 +#define XT_SUBX4 _TIE_xt_core_SUBX4 +#define XT_SUBX8 _TIE_xt_core_SUBX8 +#define XT_AND _TIE_xt_core_AND +#define XT_XOR _TIE_xt_core_XOR +#define XT_EXTUI _TIE_xt_core_EXTUI +#define XT_MOVI _TIE_xt_core_MOVI +#define XT_MOVEQZ _TIE_xt_core_MOVEQZ +#define XT_MOVNEZ _TIE_xt_core_MOVNEZ +#define XT_MOVLTZ _TIE_xt_core_MOVLTZ +#define XT_MOVGEZ _TIE_xt_core_MOVGEZ +#define XT_NEG _TIE_xt_core_NEG +#define XT_ABS _TIE_xt_core_ABS +#define XT_SSR _TIE_xt_core_SSR +#define XT_SSL _TIE_xt_core_SSL +#define XT_SSA8L _TIE_xt_core_SSA8L +#define XT_SSA8B _TIE_xt_core_SSA8B +#define XT_SSAI _TIE_xt_core_SSAI +#define XT_SLL _TIE_xt_core_SLL +#define XT_SRC _TIE_xt_core_SRC +#define XT_SRL _TIE_xt_core_SRL +#define XT_SRA _TIE_xt_core_SRA +#define XT_SLLI _TIE_xt_core_SLLI +#define XT_SRAI _TIE_xt_core_SRAI +#define XT_SRLI _TIE_xt_core_SRLI +#define XT_SSAI_SRC _TIE_xt_core_SSAI_SRC +#define XT_SSR_SRC _TIE_xt_core_SSR_SRC +#define XT_WSR_SAR_SRC _TIE_xt_core_WSR_SAR_SRC +#define XT_SSR_SRA _TIE_xt_core_SSR_SRA +#define XT_SSR_SRL _TIE_xt_core_SSR_SRL +#define XT_SSL_SLL _TIE_xt_core_SSL_SLL +#define XT_RSIL _TIE_xt_core_RSIL +#define XT_RSR_LEND _TIE_xt_core_RSR_LEND +#define XT_WSR_LEND _TIE_xt_core_WSR_LEND +#define XT_XSR_LEND _TIE_xt_core_XSR_LEND +#define XT_RSR_LCOUNT _TIE_xt_core_RSR_LCOUNT +#define XT_WSR_LCOUNT _TIE_xt_core_WSR_LCOUNT +#define XT_XSR_LCOUNT _TIE_xt_core_XSR_LCOUNT +#define XT_RSR_SAR _TIE_xt_core_RSR_SAR +#define XT_WSR_SAR _TIE_xt_core_WSR_SAR +#define XT_XSR_SAR _TIE_xt_core_XSR_SAR +#define XT_RSR_MEMCTL _TIE_xt_core_RSR_MEMCTL +#define XT_WSR_MEMCTL _TIE_xt_core_WSR_MEMCTL +#define XT_XSR_MEMCTL _TIE_xt_core_XSR_MEMCTL +#define XT_RSR_LITBASE _TIE_xt_core_RSR_LITBASE +#define XT_WSR_LITBASE _TIE_xt_core_WSR_LITBASE +#define XT_XSR_LITBASE _TIE_xt_core_XSR_LITBASE +#define XT_RSR_PS _TIE_xt_core_RSR_PS +#define XT_WSR_PS _TIE_xt_core_WSR_PS +#define XT_XSR_PS _TIE_xt_core_XSR_PS +#define XT_RSR_EPC1 _TIE_xt_core_RSR_EPC1 +#define XT_WSR_EPC1 _TIE_xt_core_WSR_EPC1 +#define XT_XSR_EPC1 _TIE_xt_core_XSR_EPC1 +#define XT_RSR_EXCSAVE1 _TIE_xt_core_RSR_EXCSAVE1 +#define XT_WSR_EXCSAVE1 _TIE_xt_core_WSR_EXCSAVE1 +#define XT_XSR_EXCSAVE1 _TIE_xt_core_XSR_EXCSAVE1 +#define XT_RSR_EPC2 _TIE_xt_core_RSR_EPC2 +#define XT_WSR_EPC2 _TIE_xt_core_WSR_EPC2 +#define XT_XSR_EPC2 _TIE_xt_core_XSR_EPC2 +#define XT_RSR_EXCSAVE2 _TIE_xt_core_RSR_EXCSAVE2 +#define XT_WSR_EXCSAVE2 _TIE_xt_core_WSR_EXCSAVE2 +#define XT_XSR_EXCSAVE2 _TIE_xt_core_XSR_EXCSAVE2 +#define XT_RSR_EPC3 _TIE_xt_core_RSR_EPC3 +#define XT_WSR_EPC3 _TIE_xt_core_WSR_EPC3 +#define XT_XSR_EPC3 _TIE_xt_core_XSR_EPC3 +#define XT_RSR_EXCSAVE3 _TIE_xt_core_RSR_EXCSAVE3 +#define XT_WSR_EXCSAVE3 _TIE_xt_core_WSR_EXCSAVE3 +#define XT_XSR_EXCSAVE3 _TIE_xt_core_XSR_EXCSAVE3 +#define XT_RSR_EPC4 _TIE_xt_core_RSR_EPC4 +#define XT_WSR_EPC4 _TIE_xt_core_WSR_EPC4 +#define XT_XSR_EPC4 _TIE_xt_core_XSR_EPC4 +#define XT_RSR_EXCSAVE4 _TIE_xt_core_RSR_EXCSAVE4 +#define XT_WSR_EXCSAVE4 _TIE_xt_core_WSR_EXCSAVE4 +#define XT_XSR_EXCSAVE4 _TIE_xt_core_XSR_EXCSAVE4 +#define XT_RSR_EPC5 _TIE_xt_core_RSR_EPC5 +#define XT_WSR_EPC5 _TIE_xt_core_WSR_EPC5 +#define XT_XSR_EPC5 _TIE_xt_core_XSR_EPC5 +#define XT_RSR_EXCSAVE5 _TIE_xt_core_RSR_EXCSAVE5 +#define XT_WSR_EXCSAVE5 _TIE_xt_core_WSR_EXCSAVE5 +#define XT_XSR_EXCSAVE5 _TIE_xt_core_XSR_EXCSAVE5 +#define XT_RSR_EPC6 _TIE_xt_core_RSR_EPC6 +#define XT_WSR_EPC6 _TIE_xt_core_WSR_EPC6 +#define XT_XSR_EPC6 _TIE_xt_core_XSR_EPC6 +#define XT_RSR_EXCSAVE6 _TIE_xt_core_RSR_EXCSAVE6 +#define XT_WSR_EXCSAVE6 _TIE_xt_core_WSR_EXCSAVE6 +#define XT_XSR_EXCSAVE6 _TIE_xt_core_XSR_EXCSAVE6 +#define XT_RSR_EPC7 _TIE_xt_core_RSR_EPC7 +#define XT_WSR_EPC7 _TIE_xt_core_WSR_EPC7 +#define XT_XSR_EPC7 _TIE_xt_core_XSR_EPC7 +#define XT_RSR_EXCSAVE7 _TIE_xt_core_RSR_EXCSAVE7 +#define XT_WSR_EXCSAVE7 _TIE_xt_core_WSR_EXCSAVE7 +#define XT_XSR_EXCSAVE7 _TIE_xt_core_XSR_EXCSAVE7 +#define XT_RSR_VECBASE _TIE_xt_core_RSR_VECBASE +#define XT_WSR_VECBASE _TIE_xt_core_WSR_VECBASE +#define XT_XSR_VECBASE _TIE_xt_core_XSR_VECBASE +#define XT_RSR_EPS2 _TIE_xt_core_RSR_EPS2 +#define XT_WSR_EPS2 _TIE_xt_core_WSR_EPS2 +#define XT_XSR_EPS2 _TIE_xt_core_XSR_EPS2 +#define XT_RSR_EPS3 _TIE_xt_core_RSR_EPS3 +#define XT_WSR_EPS3 _TIE_xt_core_WSR_EPS3 +#define XT_XSR_EPS3 _TIE_xt_core_XSR_EPS3 +#define XT_RSR_EPS4 _TIE_xt_core_RSR_EPS4 +#define XT_WSR_EPS4 _TIE_xt_core_WSR_EPS4 +#define XT_XSR_EPS4 _TIE_xt_core_XSR_EPS4 +#define XT_RSR_EPS5 _TIE_xt_core_RSR_EPS5 +#define XT_WSR_EPS5 _TIE_xt_core_WSR_EPS5 +#define XT_XSR_EPS5 _TIE_xt_core_XSR_EPS5 +#define XT_RSR_EPS6 _TIE_xt_core_RSR_EPS6 +#define XT_WSR_EPS6 _TIE_xt_core_WSR_EPS6 +#define XT_XSR_EPS6 _TIE_xt_core_XSR_EPS6 +#define XT_RSR_EPS7 _TIE_xt_core_RSR_EPS7 +#define XT_WSR_EPS7 _TIE_xt_core_WSR_EPS7 +#define XT_XSR_EPS7 _TIE_xt_core_XSR_EPS7 +#define XT_RSR_EXCCAUSE _TIE_xt_core_RSR_EXCCAUSE +#define XT_WSR_EXCCAUSE _TIE_xt_core_WSR_EXCCAUSE +#define XT_XSR_EXCCAUSE _TIE_xt_core_XSR_EXCCAUSE +#define XT_RSR_EXCVADDR _TIE_xt_core_RSR_EXCVADDR +#define XT_WSR_EXCVADDR _TIE_xt_core_WSR_EXCVADDR +#define XT_XSR_EXCVADDR _TIE_xt_core_XSR_EXCVADDR +#define XT_RSR_DEPC _TIE_xt_core_RSR_DEPC +#define XT_WSR_DEPC _TIE_xt_core_WSR_DEPC +#define XT_XSR_DEPC _TIE_xt_core_XSR_DEPC +#define XT_RSR_MISC0 _TIE_xt_core_RSR_MISC0 +#define XT_WSR_MISC0 _TIE_xt_core_WSR_MISC0 +#define XT_XSR_MISC0 _TIE_xt_core_XSR_MISC0 +#define XT_RSR_MISC1 _TIE_xt_core_RSR_MISC1 +#define XT_WSR_MISC1 _TIE_xt_core_WSR_MISC1 +#define XT_XSR_MISC1 _TIE_xt_core_XSR_MISC1 +#define XT_RSR_MISC2 _TIE_xt_core_RSR_MISC2 +#define XT_WSR_MISC2 _TIE_xt_core_WSR_MISC2 +#define XT_XSR_MISC2 _TIE_xt_core_XSR_MISC2 +#define XT_RSR_MISC3 _TIE_xt_core_RSR_MISC3 +#define XT_WSR_MISC3 _TIE_xt_core_WSR_MISC3 +#define XT_XSR_MISC3 _TIE_xt_core_XSR_MISC3 +#define XT_RSR_PRID _TIE_xt_core_RSR_PRID + +#ifndef RUR +#define RUR(NUM) RUR##NUM() +#endif + +#ifndef WUR +#define WUR(VAL, NUM) WUR##NUM(VAL) +#endif + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_core_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_debug.h b/components/esp32/include/xtensa/tie/xt_debug.h new file mode 100644 index 000000000..676fd33c7 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_debug.h @@ -0,0 +1,116 @@ +/* Definitions for the xt_debug TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_debug_HEADER +#define _XTENSA_xt_debug_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_debug_BREAK(immediate imms, immediate immt); +extern void _TIE_xt_debug_BREAK_N(immediate imms); +extern unsigned _TIE_xt_debug_RSR_DBREAKA0(void); +extern void _TIE_xt_debug_WSR_DBREAKA0(unsigned art); +extern void _TIE_xt_debug_XSR_DBREAKA0(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_DBREAKC0(void); +extern void _TIE_xt_debug_WSR_DBREAKC0(unsigned art); +extern void _TIE_xt_debug_XSR_DBREAKC0(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_DBREAKA1(void); +extern void _TIE_xt_debug_WSR_DBREAKA1(unsigned art); +extern void _TIE_xt_debug_XSR_DBREAKA1(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_DBREAKC1(void); +extern void _TIE_xt_debug_WSR_DBREAKC1(unsigned art); +extern void _TIE_xt_debug_XSR_DBREAKC1(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_IBREAKA0(void); +extern void _TIE_xt_debug_WSR_IBREAKA0(unsigned art); +extern void _TIE_xt_debug_XSR_IBREAKA0(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_IBREAKA1(void); +extern void _TIE_xt_debug_WSR_IBREAKA1(unsigned art); +extern void _TIE_xt_debug_XSR_IBREAKA1(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_IBREAKENABLE(void); +extern void _TIE_xt_debug_WSR_IBREAKENABLE(unsigned art); +extern void _TIE_xt_debug_XSR_IBREAKENABLE(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_DEBUGCAUSE(void); +extern void _TIE_xt_debug_WSR_DEBUGCAUSE(unsigned art); +extern void _TIE_xt_debug_XSR_DEBUGCAUSE(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_ICOUNT(void); +extern void _TIE_xt_debug_WSR_ICOUNT(unsigned art); +extern void _TIE_xt_debug_XSR_ICOUNT(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_ICOUNTLEVEL(void); +extern void _TIE_xt_debug_WSR_ICOUNTLEVEL(unsigned art); +extern void _TIE_xt_debug_XSR_ICOUNTLEVEL(unsigned art /*inout*/); +extern unsigned _TIE_xt_debug_RSR_DDR(void); +extern void _TIE_xt_debug_WSR_DDR(unsigned art); +extern void _TIE_xt_debug_XSR_DDR(unsigned art /*inout*/); +extern void _TIE_xt_debug_LDDR32_P(const void * ars /*inout*/); +extern void _TIE_xt_debug_SDDR32_P(void * ars /*inout*/); +#define XT_BREAK _TIE_xt_debug_BREAK +#define XT_BREAK_N _TIE_xt_debug_BREAK_N +#define XT_RSR_DBREAKA0 _TIE_xt_debug_RSR_DBREAKA0 +#define XT_WSR_DBREAKA0 _TIE_xt_debug_WSR_DBREAKA0 +#define XT_XSR_DBREAKA0 _TIE_xt_debug_XSR_DBREAKA0 +#define XT_RSR_DBREAKC0 _TIE_xt_debug_RSR_DBREAKC0 +#define XT_WSR_DBREAKC0 _TIE_xt_debug_WSR_DBREAKC0 +#define XT_XSR_DBREAKC0 _TIE_xt_debug_XSR_DBREAKC0 +#define XT_RSR_DBREAKA1 _TIE_xt_debug_RSR_DBREAKA1 +#define XT_WSR_DBREAKA1 _TIE_xt_debug_WSR_DBREAKA1 +#define XT_XSR_DBREAKA1 _TIE_xt_debug_XSR_DBREAKA1 +#define XT_RSR_DBREAKC1 _TIE_xt_debug_RSR_DBREAKC1 +#define XT_WSR_DBREAKC1 _TIE_xt_debug_WSR_DBREAKC1 +#define XT_XSR_DBREAKC1 _TIE_xt_debug_XSR_DBREAKC1 +#define XT_RSR_IBREAKA0 _TIE_xt_debug_RSR_IBREAKA0 +#define XT_WSR_IBREAKA0 _TIE_xt_debug_WSR_IBREAKA0 +#define XT_XSR_IBREAKA0 _TIE_xt_debug_XSR_IBREAKA0 +#define XT_RSR_IBREAKA1 _TIE_xt_debug_RSR_IBREAKA1 +#define XT_WSR_IBREAKA1 _TIE_xt_debug_WSR_IBREAKA1 +#define XT_XSR_IBREAKA1 _TIE_xt_debug_XSR_IBREAKA1 +#define XT_RSR_IBREAKENABLE _TIE_xt_debug_RSR_IBREAKENABLE +#define XT_WSR_IBREAKENABLE _TIE_xt_debug_WSR_IBREAKENABLE +#define XT_XSR_IBREAKENABLE _TIE_xt_debug_XSR_IBREAKENABLE +#define XT_RSR_DEBUGCAUSE _TIE_xt_debug_RSR_DEBUGCAUSE +#define XT_WSR_DEBUGCAUSE _TIE_xt_debug_WSR_DEBUGCAUSE +#define XT_XSR_DEBUGCAUSE _TIE_xt_debug_XSR_DEBUGCAUSE +#define XT_RSR_ICOUNT _TIE_xt_debug_RSR_ICOUNT +#define XT_WSR_ICOUNT _TIE_xt_debug_WSR_ICOUNT +#define XT_XSR_ICOUNT _TIE_xt_debug_XSR_ICOUNT +#define XT_RSR_ICOUNTLEVEL _TIE_xt_debug_RSR_ICOUNTLEVEL +#define XT_WSR_ICOUNTLEVEL _TIE_xt_debug_WSR_ICOUNTLEVEL +#define XT_XSR_ICOUNTLEVEL _TIE_xt_debug_XSR_ICOUNTLEVEL +#define XT_RSR_DDR _TIE_xt_debug_RSR_DDR +#define XT_WSR_DDR _TIE_xt_debug_WSR_DDR +#define XT_XSR_DDR _TIE_xt_debug_XSR_DDR +#define XT_LDDR32_P _TIE_xt_debug_LDDR32_P +#define XT_SDDR32_P _TIE_xt_debug_SDDR32_P + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_debug_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_density.h b/components/esp32/include/xtensa/tie/xt_density.h new file mode 100644 index 000000000..da5c51ccf --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_density.h @@ -0,0 +1,58 @@ +/* Definitions for the xt_density TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_density_HEADER +#define _XTENSA_xt_density_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_density_ILL_N(void); +extern void _TIE_xt_density_NOP_N(void); +extern int _TIE_xt_density_L32I_N(const int * p, immediate i); +extern void _TIE_xt_density_S32I_N(int t, int * p, immediate i); +extern int _TIE_xt_density_ADD_N(int s, int t); +extern int _TIE_xt_density_ADDI_N(int s, immediate i); +extern int _TIE_xt_density_MOV_N(int s); +extern int _TIE_xt_density_MOVI_N(immediate i); +#define XT_ILL_N _TIE_xt_density_ILL_N +#define XT_NOP_N _TIE_xt_density_NOP_N +#define XT_L32I_N _TIE_xt_density_L32I_N +#define XT_S32I_N _TIE_xt_density_S32I_N +#define XT_ADD_N _TIE_xt_density_ADD_N +#define XT_ADDI_N _TIE_xt_density_ADDI_N +#define XT_MOV_N _TIE_xt_density_MOV_N +#define XT_MOVI_N _TIE_xt_density_MOVI_N + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_density_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_exceptions.h b/components/esp32/include/xtensa/tie/xt_exceptions.h new file mode 100644 index 000000000..64fb39307 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_exceptions.h @@ -0,0 +1,45 @@ +/* Definitions for the xt_exceptions TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_exceptions_HEADER +#define _XTENSA_xt_exceptions_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_exceptions_EXCW(void); +extern void _TIE_xt_exceptions_SYSCALL(void); +#define XT_EXCW _TIE_xt_exceptions_EXCW +#define XT_SYSCALL _TIE_xt_exceptions_SYSCALL + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_exceptions_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_externalregisters.h b/components/esp32/include/xtensa/tie/xt_externalregisters.h new file mode 100644 index 000000000..3196527c2 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_externalregisters.h @@ -0,0 +1,46 @@ +/* Definitions for the xt_externalregisters TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_externalregisters_HEADER +#define _XTENSA_xt_externalregisters_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_externalregisters_RER(unsigned ars); +extern void _TIE_xt_externalregisters_WER(unsigned art, unsigned ars); +#define XT_RER _TIE_xt_externalregisters_RER +#define XT_WER _TIE_xt_externalregisters_WER + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_externalregisters_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_integerdivide.h b/components/esp32/include/xtensa/tie/xt_integerdivide.h new file mode 100644 index 000000000..9fbe9615b --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_integerdivide.h @@ -0,0 +1,50 @@ +/* Definitions for the xt_integerdivide TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_integerdivide_HEADER +#define _XTENSA_xt_integerdivide_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_integerdivide_REMS(unsigned ars, unsigned art); +extern unsigned _TIE_xt_integerdivide_REMU(unsigned ars, unsigned art); +extern unsigned _TIE_xt_integerdivide_QUOS(unsigned ars, unsigned art); +extern unsigned _TIE_xt_integerdivide_QUOU(unsigned ars, unsigned art); +#define XT_REMS _TIE_xt_integerdivide_REMS +#define XT_REMU _TIE_xt_integerdivide_REMU +#define XT_QUOS _TIE_xt_integerdivide_QUOS +#define XT_QUOU _TIE_xt_integerdivide_QUOU + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_integerdivide_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_interrupt.h b/components/esp32/include/xtensa/tie/xt_interrupt.h new file mode 100644 index 000000000..b20c94f47 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_interrupt.h @@ -0,0 +1,56 @@ +/* Definitions for the xt_interrupt TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_interrupt_HEADER +#define _XTENSA_xt_interrupt_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_interrupt_WAITI(immediate s); +extern unsigned _TIE_xt_interrupt_RSR_INTERRUPT(void); +extern void _TIE_xt_interrupt_WSR_INTSET(unsigned art); +extern void _TIE_xt_interrupt_WSR_INTCLEAR(unsigned art); +extern unsigned _TIE_xt_interrupt_RSR_INTENABLE(void); +extern void _TIE_xt_interrupt_WSR_INTENABLE(unsigned art); +extern void _TIE_xt_interrupt_XSR_INTENABLE(unsigned art /*inout*/); +#define XT_WAITI _TIE_xt_interrupt_WAITI +#define XT_RSR_INTERRUPT _TIE_xt_interrupt_RSR_INTERRUPT +#define XT_WSR_INTSET _TIE_xt_interrupt_WSR_INTSET +#define XT_WSR_INTCLEAR _TIE_xt_interrupt_WSR_INTCLEAR +#define XT_RSR_INTENABLE _TIE_xt_interrupt_RSR_INTENABLE +#define XT_WSR_INTENABLE _TIE_xt_interrupt_WSR_INTENABLE +#define XT_XSR_INTENABLE _TIE_xt_interrupt_XSR_INTENABLE + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_interrupt_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_ioports.h b/components/esp32/include/xtensa/tie/xt_ioports.h new file mode 100644 index 000000000..0253bea4c --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_ioports.h @@ -0,0 +1,66 @@ +/* Definitions for the xt_ioports TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_ioports_HEADER +#define _XTENSA_xt_ioports_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_ioports_READ_IMPWIRE(void); +extern void _TIE_xt_ioports_SETB_EXPSTATE(immediate bitindex); +extern void _TIE_xt_ioports_CLRB_EXPSTATE(immediate bitindex); +extern void _TIE_xt_ioports_WRMSK_EXPSTATE(unsigned art, unsigned ars); +extern unsigned _TIE_xt_ioports_RUR_EXPSTATE(void); +extern void _TIE_xt_ioports_WUR_EXPSTATE(unsigned v); +#define READ_IMPWIRE _TIE_xt_ioports_READ_IMPWIRE +#define SETB_EXPSTATE _TIE_xt_ioports_SETB_EXPSTATE +#define CLRB_EXPSTATE _TIE_xt_ioports_CLRB_EXPSTATE +#define WRMSK_EXPSTATE _TIE_xt_ioports_WRMSK_EXPSTATE +#define RUR_EXPSTATE _TIE_xt_ioports_RUR_EXPSTATE +#define REXPSTATE _TIE_xt_ioports_RUR_EXPSTATE +#define RUR230 _TIE_xt_ioports_RUR_EXPSTATE +#define WUR_EXPSTATE _TIE_xt_ioports_WUR_EXPSTATE +#define WEXPSTATE _TIE_xt_ioports_WUR_EXPSTATE +#define WUR230 _TIE_xt_ioports_WUR_EXPSTATE + +#ifndef RUR +#define RUR(NUM) RUR##NUM() +#endif + +#ifndef WUR +#define WUR(VAL, NUM) WUR##NUM(VAL) +#endif + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_ioports_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_misc.h b/components/esp32/include/xtensa/tie/xt_misc.h new file mode 100644 index 000000000..a0b36f4e5 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_misc.h @@ -0,0 +1,58 @@ +/* Definitions for the xt_misc TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_misc_HEADER +#define _XTENSA_xt_misc_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern int _TIE_xt_misc_CLAMPS(int s, immediate i); +extern int _TIE_xt_misc_MIN(int s, int t); +extern int _TIE_xt_misc_MAX(int s, int t); +extern unsigned _TIE_xt_misc_MINU(unsigned s, unsigned t); +extern unsigned _TIE_xt_misc_MAXU(unsigned s, unsigned t); +extern int _TIE_xt_misc_NSA(int s); +extern unsigned _TIE_xt_misc_NSAU(unsigned s); +extern int _TIE_xt_misc_SEXT(int s, immediate i); +#define XT_CLAMPS _TIE_xt_misc_CLAMPS +#define XT_MIN _TIE_xt_misc_MIN +#define XT_MAX _TIE_xt_misc_MAX +#define XT_MINU _TIE_xt_misc_MINU +#define XT_MAXU _TIE_xt_misc_MAXU +#define XT_NSA _TIE_xt_misc_NSA +#define XT_NSAU _TIE_xt_misc_NSAU +#define XT_SEXT _TIE_xt_misc_SEXT + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_misc_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_mmu.h b/components/esp32/include/xtensa/tie/xt_mmu.h new file mode 100644 index 000000000..ce786c0fe --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_mmu.h @@ -0,0 +1,62 @@ +/* Definitions for the xt_mmu TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_mmu_HEADER +#define _XTENSA_xt_mmu_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_mmu_IDTLB(unsigned ars); +extern unsigned _TIE_xt_mmu_RDTLB1(unsigned ars); +extern unsigned _TIE_xt_mmu_RDTLB0(unsigned ars); +extern unsigned _TIE_xt_mmu_PDTLB(unsigned ars); +extern void _TIE_xt_mmu_WDTLB(unsigned art, unsigned ars); +extern void _TIE_xt_mmu_IITLB(unsigned ars); +extern unsigned _TIE_xt_mmu_RITLB1(unsigned ars); +extern unsigned _TIE_xt_mmu_RITLB0(unsigned ars); +extern unsigned _TIE_xt_mmu_PITLB(unsigned ars); +extern void _TIE_xt_mmu_WITLB(unsigned art, unsigned ars); +#define XT_IDTLB _TIE_xt_mmu_IDTLB +#define XT_RDTLB1 _TIE_xt_mmu_RDTLB1 +#define XT_RDTLB0 _TIE_xt_mmu_RDTLB0 +#define XT_PDTLB _TIE_xt_mmu_PDTLB +#define XT_WDTLB _TIE_xt_mmu_WDTLB +#define XT_IITLB _TIE_xt_mmu_IITLB +#define XT_RITLB1 _TIE_xt_mmu_RITLB1 +#define XT_RITLB0 _TIE_xt_mmu_RITLB0 +#define XT_PITLB _TIE_xt_mmu_PITLB +#define XT_WITLB _TIE_xt_mmu_WITLB + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_mmu_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_mul.h b/components/esp32/include/xtensa/tie/xt_mul.h new file mode 100644 index 000000000..e20862069 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_mul.h @@ -0,0 +1,52 @@ +/* Definitions for the xt_mul TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_mul_HEADER +#define _XTENSA_xt_mul_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern int _TIE_xt_mul_MUL16S(short s, short t); +extern unsigned _TIE_xt_mul_MUL16U(unsigned short s, unsigned short t); +extern int _TIE_xt_mul_MULL(int s, int t); +extern unsigned _TIE_xt_mul_MULUH(unsigned s, unsigned t); +extern int _TIE_xt_mul_MULSH(int s, int t); +#define XT_MUL16S _TIE_xt_mul_MUL16S +#define XT_MUL16U _TIE_xt_mul_MUL16U +#define XT_MULL _TIE_xt_mul_MULL +#define XT_MULUH _TIE_xt_mul_MULUH +#define XT_MULSH _TIE_xt_mul_MULSH + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_mul_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_regwin.h b/components/esp32/include/xtensa/tie/xt_regwin.h new file mode 100644 index 000000000..7bce471a0 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_regwin.h @@ -0,0 +1,64 @@ +/* Definitions for the xt_regwin TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_regwin_HEADER +#define _XTENSA_xt_regwin_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_regwin_ENTRY(unsigned ars /*inout*/, immediate uimm12x8); +extern void _TIE_xt_regwin_ROTW(immediate simm4); +extern int _TIE_xt_regwin_MOVSP(int s); +extern int _TIE_xt_regwin_L32E(const int * s, immediate o); +extern void _TIE_xt_regwin_S32E(int t, int * s, immediate o); +extern unsigned _TIE_xt_regwin_RSR_WINDOWBASE(void); +extern void _TIE_xt_regwin_WSR_WINDOWBASE(unsigned t); +extern void _TIE_xt_regwin_XSR_WINDOWBASE(unsigned t /*inout*/); +extern unsigned _TIE_xt_regwin_RSR_WINDOWSTART(void); +extern void _TIE_xt_regwin_WSR_WINDOWSTART(unsigned t); +extern void _TIE_xt_regwin_XSR_WINDOWSTART(unsigned t /*inout*/); +#define XT_ENTRY _TIE_xt_regwin_ENTRY +#define XT_ROTW _TIE_xt_regwin_ROTW +#define XT_MOVSP _TIE_xt_regwin_MOVSP +#define XT_L32E _TIE_xt_regwin_L32E +#define XT_S32E _TIE_xt_regwin_S32E +#define XT_RSR_WINDOWBASE _TIE_xt_regwin_RSR_WINDOWBASE +#define XT_WSR_WINDOWBASE _TIE_xt_regwin_WSR_WINDOWBASE +#define XT_XSR_WINDOWBASE _TIE_xt_regwin_XSR_WINDOWBASE +#define XT_RSR_WINDOWSTART _TIE_xt_regwin_RSR_WINDOWSTART +#define XT_WSR_WINDOWSTART _TIE_xt_regwin_WSR_WINDOWSTART +#define XT_XSR_WINDOWSTART _TIE_xt_regwin_XSR_WINDOWSTART + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_regwin_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_scmpr.h b/components/esp32/include/xtensa/tie/xt_scmpr.h new file mode 100644 index 000000000..337c7762e --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_scmpr.h @@ -0,0 +1,22 @@ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_scmpr_h_HEADER +#define _XTENSA_xt_scmpr_h_HEADER + + +/* Header includes start */ + + +/* Header includes end */ + +#endif /* !_XTENSA_xt_scmpr_h_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_sync.h b/components/esp32/include/xtensa/tie/xt_sync.h new file mode 100644 index 000000000..9323dfe4b --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_sync.h @@ -0,0 +1,60 @@ +/* Definitions for the xt_sync TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_sync_HEADER +#define _XTENSA_xt_sync_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_sync_RSR_SCOMPARE1(void); +extern void _TIE_xt_sync_WSR_SCOMPARE1(unsigned art); +extern void _TIE_xt_sync_XSR_SCOMPARE1(unsigned art /*inout*/); +extern unsigned _TIE_xt_sync_RSR_ATOMCTL(void); +extern void _TIE_xt_sync_WSR_ATOMCTL(unsigned art); +extern void _TIE_xt_sync_XSR_ATOMCTL(unsigned art /*inout*/); +extern unsigned _TIE_xt_sync_L32AI(const unsigned * p, immediate o); +extern void _TIE_xt_sync_S32RI(unsigned c, unsigned * p, immediate o); +extern void _TIE_xt_sync_S32C1I(unsigned c /*inout*/, const unsigned * p, immediate o); +#define XT_RSR_SCOMPARE1 _TIE_xt_sync_RSR_SCOMPARE1 +#define XT_WSR_SCOMPARE1 _TIE_xt_sync_WSR_SCOMPARE1 +#define XT_XSR_SCOMPARE1 _TIE_xt_sync_XSR_SCOMPARE1 +#define XT_RSR_ATOMCTL _TIE_xt_sync_RSR_ATOMCTL +#define XT_WSR_ATOMCTL _TIE_xt_sync_WSR_ATOMCTL +#define XT_XSR_ATOMCTL _TIE_xt_sync_XSR_ATOMCTL +#define XT_L32AI _TIE_xt_sync_L32AI +#define XT_S32RI _TIE_xt_sync_S32RI +#define XT_S32C1I _TIE_xt_sync_S32C1I + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_sync_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_timer.h b/components/esp32/include/xtensa/tie/xt_timer.h new file mode 100644 index 000000000..64db45c1a --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_timer.h @@ -0,0 +1,66 @@ +/* Definitions for the xt_timer TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_timer_HEADER +#define _XTENSA_xt_timer_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern unsigned _TIE_xt_timer_RSR_CCOUNT(void); +extern void _TIE_xt_timer_WSR_CCOUNT(unsigned art); +extern void _TIE_xt_timer_XSR_CCOUNT(unsigned art /*inout*/); +extern unsigned _TIE_xt_timer_RSR_CCOMPARE0(void); +extern void _TIE_xt_timer_WSR_CCOMPARE0(unsigned art); +extern void _TIE_xt_timer_XSR_CCOMPARE0(unsigned art /*inout*/); +extern unsigned _TIE_xt_timer_RSR_CCOMPARE1(void); +extern void _TIE_xt_timer_WSR_CCOMPARE1(unsigned art); +extern void _TIE_xt_timer_XSR_CCOMPARE1(unsigned art /*inout*/); +extern unsigned _TIE_xt_timer_RSR_CCOMPARE2(void); +extern void _TIE_xt_timer_WSR_CCOMPARE2(unsigned art); +extern void _TIE_xt_timer_XSR_CCOMPARE2(unsigned art /*inout*/); +#define XT_RSR_CCOUNT _TIE_xt_timer_RSR_CCOUNT +#define XT_WSR_CCOUNT _TIE_xt_timer_WSR_CCOUNT +#define XT_XSR_CCOUNT _TIE_xt_timer_XSR_CCOUNT +#define XT_RSR_CCOMPARE0 _TIE_xt_timer_RSR_CCOMPARE0 +#define XT_WSR_CCOMPARE0 _TIE_xt_timer_WSR_CCOMPARE0 +#define XT_XSR_CCOMPARE0 _TIE_xt_timer_XSR_CCOMPARE0 +#define XT_RSR_CCOMPARE1 _TIE_xt_timer_RSR_CCOMPARE1 +#define XT_WSR_CCOMPARE1 _TIE_xt_timer_WSR_CCOMPARE1 +#define XT_XSR_CCOMPARE1 _TIE_xt_timer_XSR_CCOMPARE1 +#define XT_RSR_CCOMPARE2 _TIE_xt_timer_RSR_CCOMPARE2 +#define XT_WSR_CCOMPARE2 _TIE_xt_timer_WSR_CCOMPARE2 +#define XT_XSR_CCOMPARE2 _TIE_xt_timer_XSR_CCOMPARE2 + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_timer_HEADER */ diff --git a/components/esp32/include/xtensa/tie/xt_trace.h b/components/esp32/include/xtensa/tie/xt_trace.h new file mode 100644 index 000000000..8d8d07fa4 --- /dev/null +++ b/components/esp32/include/xtensa/tie/xt_trace.h @@ -0,0 +1,44 @@ +/* Definitions for the xt_trace TIE package */ + +/* + * Customer ID=11657; Build=0x5fe96; Copyright (c) 2004-2010 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +/* Do not modify. This is automatically generated.*/ + +#ifndef _XTENSA_xt_trace_HEADER +#define _XTENSA_xt_trace_HEADER + +#ifdef __XTENSA__ +#ifdef __XCC__ + +#include + +/* + * The following prototypes describe intrinsic functions + * corresponding to TIE instructions. Some TIE instructions + * may produce multiple results (designated as "out" operands + * in the iclass section) or may have operands used as both + * inputs and outputs (designated as "inout"). However, the C + * and C++ languages do not provide syntax that can express + * the in/out/inout constraints of TIE intrinsics. + * Nevertheless, the compiler understands these constraints + * and will check that the intrinsic functions are used + * correctly. To improve the readability of these prototypes, + * the "out" and "inout" parameters are marked accordingly + * with comments. + */ + +extern void _TIE_xt_trace_WSR_MMID(unsigned art); +#define XT_WSR_MMID _TIE_xt_trace_WSR_MMID + +#endif /* __XCC__ */ + +#endif /* __XTENSA__ */ + +#endif /* !_XTENSA_xt_trace_HEADER */ diff --git a/components/esp32/include/xtensa/trax-api.h b/components/esp32/include/xtensa/trax-api.h new file mode 100755 index 000000000..aa1584359 --- /dev/null +++ b/components/esp32/include/xtensa/trax-api.h @@ -0,0 +1,93 @@ +/* Misc TRAX API function definitions. + + Copyright (c) 2007-2012 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _TRAX_API_H_ +#define _TRAX_API_H_ + +#include +#include +#include "tpack.h" +#include "traxreg.h" + +#include "xdm-regs.h" + +/* Flags for trax_stop(): */ +#define TRAX_STOP_HALT 0x0001 /* halt immediately, don't wait for post-stop-trigger capture */ +#define TRAX_STOP_QUIET 0x0002 /* don't display informative messages */ + + +/* + * Describes a TRAX channel (based on tpack). + */ +typedef struct { + tpack_channel chan; /* channel structure header */ + /* Per TRAX unit information: */ + int trax_version; /* TRAX_ID_VER(id), one of TRAX_VER_xxx macros */ + unsigned long trax_tram_size; /* size of trace RAM in bytes */ + int trax_erratum10; /* set if TRAX 1.0 erratum workarounds needed */ + int trax_erratum20; /* set if TRAX 2.0 erratum workaround needed (PR 22161)*/ + int trax_erratum20_size; + int trax_has_busy; /* has trace-busy feature */ + int trax_has_atb; /* has ATB feature */ + /*FIXME: add various features: coresight regs (don't call it that), APB, ATB, TRAM, ... */ +} trax_channel; + + +/* Prototypes: */ + +/* TRAX Protocol API: */ +extern int trax_read_register(tpack_channel *tchan, int regno, unsigned *value); +extern int trax_write_register(tpack_channel *tchan, int regno, unsigned value); +extern int trax_read_memory(tpack_channel *tchan, int address, int size, unsigned char *pdata); +extern int trax_fill_memory(tpack_channel *tchan, int address, int size, tpack_u32 pattern); +extern int trax_enumerate_devices(tpack_channel *tchan, int * buf, int * size); + +/* TRAX Network API: */ +extern unsigned long trax_ram_size(tpack_channel *traxchan); +extern unsigned long trax_ram_size_addr(tpack_channel *traxchan); +extern int trax_create_tracefile(tpack_channel *traxchan, int size, unsigned char * data, + char *filename, int hflags, const char *toolver); +extern int trax_memaccess_safe(tpack_channel *traxchan, const char *what); +extern int trax_start(tpack_channel *traxchan, int flags); +extern int trax_stop(tpack_channel *traxchan, int flags); +extern int trax_halt(tpack_channel *traxchan, int flags); +extern int trax_save(tpack_channel *traxchan, char *filename, int flags, const char *toolver, int erratum); + +/* TRAX Misc API (no network dependencies): */ +int trax_fixed_hw(unsigned * regs); +extern int trax_display_id(unsigned id, const char *prefix); +extern int trax_display_summary(unsigned id, + unsigned status, + unsigned control, + unsigned address, + unsigned delay, + unsigned trigger, + unsigned match, + unsigned startaddr, + unsigned endaddr, + const char *prefix); + +/* Other: */ + +#endif /* _TRAX_API_H_ */ + diff --git a/components/esp32/include/xtensa/trax-core-config.h b/components/esp32/include/xtensa/trax-core-config.h new file mode 100755 index 000000000..42a03334a --- /dev/null +++ b/components/esp32/include/xtensa/trax-core-config.h @@ -0,0 +1,144 @@ +/* Definitions for Xtensa processor config info needed for TRAX. + + Copyright (c) 2005-2011 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef TRAX_CORE_CONFIG_H +#define TRAX_CORE_CONFIG_H + +#include "xtensa-params.h" + +/* + * Vector Enumerations. + */ + +/* These must match the LX2.0 and later traceport spec: */ +#define VEC_NO_VECTOR 0 +#define VEC_FIRST VEC_RESET /* first valid vector */ +#define VEC_RESET 1 +#define VEC_DEBUG 2 +#define VEC_NMI 3 +#define VEC_USER 4 +#define VEC_KERNEL 5 +#define VEC_DOUBLE 6 +#define VEC_MEMERR 7 +#define VEC_RESERVED8 8 +#define VEC_RESERVED9 9 +#define VEC_WINO4 10 +#define VEC_WINU4 11 +#define VEC_WINO8 12 +#define VEC_WINU8 13 +#define VEC_WINO12 14 +#define VEC_WINU12 15 +#define VEC_INTLEVEL2 16 +#define VEC_INTLEVEL3 17 +#define VEC_INTLEVEL4 18 +#define VEC_INTLEVEL5 19 +#define VEC_INTLEVEL6 20 +/* These are internal, i.e. don't appear like this on traceport: */ +#define VEC_DEBUG_OCD 21 +#define VEC_UNKNOWN 22 +/* Enumerations 23 through 31 are also reserved, but putting */ +/* placeholders here seems wasteful and unnecessary. */ +#define VEC_COUNT 23 + +/* Other branch (change-of-PC-flow) type encodings; + * if PC changes due to an exception or interrupt vector, + * one of the VEC_* values above is used, otherwise + * (or if it's unknown whether it's due to an exception/interrupt) + * one of the following is used: */ + +#define BRANCH_IS_VEC(n) ((n) < VEC_COUNT) /* is known to be except/interrupt? */ +#define BRANCH_OR_VEC 24 /* unknown type of branch (branch/exception/interrupt/etc) */ +#define BRANCH_UNKNOWN 25 /* unknown type of branch (anything but except/interrupt) */ +#define BRANCH_UNKNOWN_ERR 26 /* like BRANCH_UNKNOWN with known error (non-branch instr) */ +#define BRANCH_LOOPBACK 28 /* zero-overhead loopback (from LEND to LBEG) */ +#define BRANCH_CONDTAKEN 29 /* conditional branch taken (or LOOP{NEZ,GTZ} loop skip) */ +#define BRANCH_JUMP 30 /* jump (unconditional branch, i.e. J or JX) */ +#define BRANCH_IS_CALL(n) (((n) & ~3) == 32) /* is a function call? */ +#define BRANCH_CALL0 32 /* non-windowed function call (CALL0, CALLX0) */ +#define BRANCH_CALL4 33 /* windowed function call (CALL4, CALLX4) */ +#define BRANCH_CALL8 34 /* windowed function call (CALL8, CALLX8) */ +#define BRANCH_CALL12 35 /* windowed function call (CALL12, CALLX12) */ +#define BRANCH_IS_RETURN(n) ((n) >= 36) /* is any kind of return? */ +#define BRANCH_IS_CALLRETURN(n) (((n) & ~1) == 36) /* is a function return? */ +#define BRANCH_RET 36 /* non-windowed function return (RET or RET.N) */ +#define BRANCH_RETW 37 /* windowed function return (RETW or RETW.N) */ +#define BRANCH_IS_EIRETURN(n) ((n) >= 38) /* is an except/inter. return? */ +#define BRANCH_RFE 38 /* RFE or RFUE */ +#define BRANCH_RFDE 39 /* RFDE */ +#define BRANCH_RFWO 40 /* RFWO */ +#define BRANCH_RFWU 41 /* RFWU */ +#define BRANCH_RFI_2 42 /* RFI 2 */ +#define BRANCH_RFI_3 43 /* RFI 3 */ +#define BRANCH_RFI_4 44 /* RFI 4 */ +#define BRANCH_RFI_5 45 /* RFI 5 */ +#define BRANCH_RFI_6 46 /* RFI 6 */ +#define BRANCH_RFI_NMI 47 /* RFI NMILEVEL */ +#define BRANCH_RFI_DEBUG 48 /* RFI DEBUGLEVEL */ +#define BRANCH_RFME 49 /* RFME */ +#define BRANCH_COUNT 50 /* (number of defined BRANCH_xxx values) */ + + + +typedef struct { + unsigned vaddr; + unsigned vaddr2; /* for static vectors only (reloc vectors option) */ + int is_configured; +} trax_vector_t; + + +/* + * This structure describes those portion of a Tensilica processor's + * configuration that are useful for trace. + */ +typedef struct { + char ** isa_dlls; + char * core_name; /* (XPG core name, not necessarily same as XTENSA_CORE) */ + int big_endian; /* 0 = little-endian, 1 = big-endian */ + int has_loops; /* 1 = zero overhead loops configured */ + int has_autorefill; /* 1 = TLB autorefill (MMU) configured */ + unsigned max_instr_size; /* in bytes (eg. 3, 4, 8, ...) */ + unsigned int_level_max; /* number of interrupt levels configured (without NMI) */ + int debug_level; /* debug intlevel, 0 if debug not configured */ + int nmi_level; /* NMI intlevel, 0 if NMI not configured */ + unsigned targethw_min; /* min. targeted hardware version (XTENSA_HWVERSION_) */ + unsigned targethw_max; /* max. targeted hardware version (XTENSA_HWVERSION_) */ + int reloc_vectors; /* 0 = fixed vectors, 1 = relocatable vectors */ + int statvec_select; /* 0 = stat vec base 0, 1 = stat vec base 1 (SW default) */ + int vecbase_align; /* number of bits to align VECBASE (32 - bits in VECBASE) */ + unsigned statvec_base0; /* static vector base 0 */ + unsigned statvec_base1; /* static vector base 1 */ + unsigned vecbase_reset; /* reset value of VECBASE */ + trax_vector_t vectors[VEC_COUNT]; /* all vectors... */ +} trax_core_config_t; + + +/* Globals: */ +//extern const char * const trax_vector_short_names[/*VEC_COUNT*/]; // nobody uses this one +extern const char * const trax_vector_names[/*VEC_COUNT*/]; + +/* Prototypes: */ +extern int trax_read_params (trax_core_config_t *c, xtensa_params p); +extern int trax_vector_from_address(trax_core_config_t *config, unsigned long vaddr, unsigned long *vecbases); + +#endif /* TRAX_CORE_CONFIG_H */ + diff --git a/components/esp32/include/xtensa/trax-proto.h b/components/esp32/include/xtensa/trax-proto.h new file mode 100755 index 000000000..41d5c9fd7 --- /dev/null +++ b/components/esp32/include/xtensa/trax-proto.h @@ -0,0 +1,91 @@ +/* This file contains functions that are hidden from the user. These are + * protocol specific functions used to read and write TRAX registers + * and the trace memory + */ + +/* + * Copyright (c) 2012-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ +#ifndef _TRAX_PROTO_H +#define _TRAX_PROTO_H + +#ifdef __cplusplus +extern "C" { +#endif + +/* Function to read register + * + * regno : The register number to be read (not ERI addressed) + * data : Location where the read value is kept + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_read_register_eri (int regno, unsigned *data); + +/* Function to write a value into a register + * + * regno : The register number to be written (not ERI addressed) + * value : The value to be written at that register location + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_write_register_eri (int regno, unsigned value); + +/* Function to read memory + * + * address : Address of the TraceRAM memory, each location has a word + * len : Amount of memory in bytes, to be read + * data : buffer in which the read memory is stored + * final_address: Next address to be read in the following call to this + * function (trace save mechanism) + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_read_memory_eri (unsigned address, int len, int *data, + unsigned *final_address); + +/* Function to write a value to the memory address + * + * address : Address of the TraceRAM memory + * value : The value to be written inside that location + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_write_memory_eri (int address, unsigned value); + +/* Function to write to a subfield of the register. + * Called by set and show parameter functions. + * + * regno : Register number + * regmask : Mask in order to toggle appropriate bits + * value : Value to be written in the masked location + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_write_register_field_eri (int regno, unsigned regmask, + unsigned value); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/esp32/include/xtensa/trax-util.h b/components/esp32/include/xtensa/trax-util.h new file mode 100755 index 000000000..123ac366d --- /dev/null +++ b/components/esp32/include/xtensa/trax-util.h @@ -0,0 +1,63 @@ +/* This file contains utility functions that can be used for polling TRAX + * or executing higher level save functionality + * It assumes that print subroutines and file I/O routines are available + * on the system + */ + +/* + * Copyright (c) 2012-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef _TRAX_UTIL_H +#define _TRAX_UTIL_H + + +#ifdef __cplusplus +extern "C" { +#endif + +/* User can use this function if he wants to generate a tracefile output. + * Internally it calls trax_get_trace in a loop until it realizes that + * the entire trace has been read. + * + * context : pointer to structure which contains information about the + * current TRAX session + * filename : user specified output trace file name. If the file does not + * exist, it would create the new file, else would append to it + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_save (trax_context *context, char *filename); + +/* Displays a brief machine readable status. + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_poll (trax_context *context); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/esp32/include/xtensa/trax.h b/components/esp32/include/xtensa/trax.h new file mode 100755 index 000000000..47049c51d --- /dev/null +++ b/components/esp32/include/xtensa/trax.h @@ -0,0 +1,409 @@ +/* Header file for TRAX control Library */ + +/* + * Copyright (c) 2012-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef _TRAX_H +#define _TRAX_H + +#ifdef __cplusplus +extern "C" { +#endif + +#define TRAX_STOP_HALT 0x0001 +#define TRAX_STOP_QUIET 0x0002 + +/* Flag values to indicate if the user wanted to reverse the pcstop + * parameters */ +#define TRAX_PCSTOP_REVERSE 0x0001 +#define TRAX_PCSTOP_NO_REVERSE 0x0000 + +/* Indicating whether postsize should be in terms of bytes, instructions + * or percentage of trace size captured */ +#define TRAX_POSTSIZE_BYTES 0x0000 +#define TRAX_POSTSIZE_INSTR 0x0001 +#define TRAX_POSTSIZE_PERCENT 0x0002 + +/* Size of the header inside the trace file */ +#define TRAX_HEADER_SIZE 256 + +/* Minimum size between start and end addresses */ +#define TRAX_MIN_TRACEMEM 64 + +/* For basic debugging */ +#define DEBUG 0 + +#include + +#define ffs(i) __builtin_ffs(i) + +/* Data structures */ + +/* Represents the context of the TRAX unit and the current TRAX session. + * To be used by set and show function calls to set and show appropriate + * parameters of appropriate TRAX unit. + */ + +typedef struct { + int trax_version; /* TRAX PC version information */ + unsigned long trax_tram_size; /* If trace RAM is present,size of it */ + int hflags; /* Flags that can be used to debug, + print info, etc. */ + int address_read_last; /* During saving of the trace, this + indicates the address from which + the current trace reading must + resume */ + unsigned long bytes_read; /* bytes read uptil now */ + unsigned long total_memlen; /* Total bytes to be read based on the + trace collected in the trace RAM */ + bool get_trace_started; /* indicates that the first chunk of + bytes (which include the header) has + been read */ +} trax_context; + + +/* -----------------------TRAX Initialization ------------------------------*/ + +/* Initializing the trax context. Reads registers and sets values for version, + * trace RAM size, total memory length, etc. Most of the other values are + * initialized to their default case. + * + * context : pointer to structure which contains information about the + * current TRAX session + * + * returns : 0 if successful, -1 if unsuccessful, -2 if ram_size if + * incorrect + */ +int trax_context_init_eri (trax_context *context); + +/* -----------------Starting/Stopping TRAX session -------------------------*/ + +/* Start tracing with current parameter setting. If tracing is already in + * progress, an error is reported. Otherwise, tracing starts and any unsaved + * contents of the TraceRAM is discarded + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if successful, 1 if trace is already active, + * -1 if unsuccessful + */ +int trax_start (trax_context *context); + +/* This command initiates a stop trigger or halts a trace session based of the + * value of the flag parameter passed. In case stop trigger is initiated, any + * selected post-stop-trigger capture proceeds normally. + * If trace capture was not in progress, or a stop was already triggered, the + * return value indicates appropriately. + * + * context : pointer to structure which contains information about the + * current TRAX session + * flags : To differentiate between stopping trace without any + * post-size-trigger capture (trax_halt) or with that. + * A zero value would stop the trace based on trigger and a + * value of one would halt it + * + * returns : 0 if successful, 1 if already stopped, -1 if unsuccessful + */ +int trax_stop_halt (trax_context *context, int flags); + +/* Resets the TRAX parameters to their default values which would internally + * involve resetting the TRAX registers. To invoke another trace session or + * reset the current tracing mechanism, this function needs to be called as + * it resets parameters of the context that deal with tracing information + * + * context : pointer to structure which contains information about the + * current TRAX session + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_reset (trax_context *context); + +/* ---------------Set/Get several TRAX parameters --------------------------*/ + +/* Sets the start address and end address (word aligned) of the trace in the + * TraceRAM. Care must be taken to ensure that the difference between the + * start and the end addresses is atleast TRAX_MIN_TRACEMEM bytes. If not, + * the values are reset to default, which is 0 for startaddr and + * traceRAM_words -1 for endaddr + * + * context : pointer to structure which contains information about the + * current TRAX session + * startaddr : value to which the start address must be set. Can be + * any value between 0 - (traceRAM_words - 1) + * endaddr : value to which the end address must be set. Can be any value + * between 0 - (traceRAM_words - 1) + * + * returns : 0 if successful, -1 if unsuccessful, -2 if the difference + * between the start and end addresses is less than + * TRAX_MIN_TRACEMEM bytes or if they are passed incorrect + * values, -3 if memory shared option is not configured, in + * which case, start and end addresses are set to default + * values instead of those passed by the user + */ +int trax_set_ram_boundaries (trax_context *context, unsigned startaddr, + unsigned endaddr); + +/* Shows the start address and end address(word aligned) of the trace in the + * TraceRAM. If incorrect, the startaddress and the endaddress values are + * set to default, i.e. 0 for startaddr and traceRAM_words - 1 for endaddr + * + * context : pointer to structure which contains information about the + * current TRAX session + * startaddr : pointer to value which will contain the start address + * endaddr : pointer to value which will contain the end address + * + * returns : 0 if successful, -1 if unsuccessful + * + */ +int trax_get_ram_boundaries (trax_context *context, unsigned *startaddr, + unsigned *endaddr); + +/* Selects stop trigger via cross-trigger input + * + * context : pointer to structure which contains information about the + * current TRAX session + * value : 0 = off (reset value), 1 = on + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_set_ctistop (trax_context *context, unsigned value); + +/* Shows if stop-trigger via cross-trigger input is off or on + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if off, 1 if on, -1 if unsuccessful + */ +int trax_get_ctistop (trax_context *context); + +/* Selects stop trigger via processor-trigger input + * + * context : pointer to structure which contains information about the + * current TRAX session + * value : 0 = off (reset value), 1 = on + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_set_ptistop (trax_context *context, unsigned value); + +/* Shows if stop trigger visa processor-trigger input is off or on + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if off, 1 if on, -1 if unsuccessful + */ +int trax_get_ptistop (trax_context *context); + +/* Reports cross trigger output state + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if CTO bit is reset, 1 if CTO bit is set + */ +int trax_get_cto (trax_context *context); + +/* Reports processor trigger output state + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if PTO bit is reset, 1 if PTO bit is set + */ +int trax_get_pto (trax_context *context); + +/* Selects condition that asserts cross trigger output + * + * context : pointer to structure which contains information about the + * current TRAX session + * option : 0 = off(reset value)/1 = ontrig/2 = onhalt + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_set_ctowhen (trax_context *context, int option); + +/* Shows condition that asserted cross trigger output. It can be + * any of: ontrig or onhalt or even off + * + * context : pointer to structure which contains information about the + * current TRAX session + * + * returns : 0 if off, 1 if ontrig, 2 if onhalt, -1 if unsuccessful + */ +int trax_get_ctowhen (trax_context *context); + +/* Selects condition that asserts processor trigger output + * + * context : pointer to structure which contains information about the + * current TRAX session + * option : 0 = off(reset value)/1 = ontrig/2 = onhalt + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_set_ptowhen (trax_context *context, int option); + + +/* Shows condition that asserted processor trigger output. It can be + * any of: ontrig or onhalt or even off + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : 0 if off, 1 if ontrig, 2 if onhalt, -1 if unsuccessful + */ +int trax_get_ptowhen (trax_context *context); + +/* Selects the trace synchronization message period. + * If ATEN enabled, we cannot allow syncper to be off, set it to reset value. + * Also, if no trace RAM, and ATEN enabled, set syncper to be reset value + * i.e. 256. A value of 1 i.e. on indicates that internally the message + * frequency is set to an optimal value. This option should be preferred + * if the user is not sure what message frequency option to set for the + * trace session. + * + * context : pointer to structure which contains information about the + * current TRAX session + * option : 0 = off, 1 = on, -1 = auto, 8, 16, 32, 64, 128, + * 256 (reset value) + * + * returns : 0 if successful, -1 if unsuccessful, -2 if incorrect + * arguments + */ +int trax_set_syncper (trax_context *context, int option); + +/* Shows trace synchronization message period. Can be one of: + * off, on, auto, 8, 16, 32, 64, 128, 256 (reset value) + * + * context : pointer to structure which contains information about the + * current TRAX session + * returns : value of sync period, 0 if off, -1 if unsuccessful + */ +int trax_get_syncper (trax_context *context); + +/* Selects stop trigger via PC match. Specifies the address or + * address range to match against program counter. Trace stops when the + * processor executes an instruction matching the specified address + * or range. + * + * context : pointer to structure which contains information about the + * current TRAX session + * index : indicates the number of stop trigger (currently there is + * only one i.e. index = 0) + * startaddress : start range of the address at which the stop trigger + * should be activated + * enaddress : end range of the address at which the stop trigger should + * be activated + * flags : If non-zero, this inverts the range. i.e. trace stops + * when the processor executes an instruction that does not + * match the specified address or range + * + * returns : 0 if successful, -1 if unsuccessful, -2 if incorrect + * arguments (unaligned) + * + * Note : For the current version of TRAX library, the endaddress and + * startaddress can differ by at most 31 bytes and the total + * range i.e. (endaddress - startaddress + 1) has to be a power + * of two + */ +int trax_set_pcstop (trax_context *context, int index, unsigned long startaddress, + unsigned long endaddress, int flags); + +/* Shows the stop trigger via PC match + * + * context : pointer to structure which contains information about the + * current TRAX session + * index : container of information about the number of stop triggers + * startaddress : container of start range of stop trigger + * endaddress : container of end range of stop trigger + * flags : container of information whcih indicates whether the + * pc stop range is inverted or not. + * + * returns : 0 if successful, -1 if unsuccessful + */ +int trax_get_pcstop (trax_context *context, int *index, + unsigned long *startaddress, + unsigned long *endaddress, int *flags); + +/* This function is used to set the amount of trace to be captured past + * the stop trigger. + * + * context : pointer to structure which contains information about the + * current TRAX session + * count_unit : contains the count of units (instructions or bytes) to be + * captured post trigger. If 0, it implies that this is off + * unit : unit of measuring the count. 0 is bytes, 1 is instructions + * 2 is percentage of trace + * + * returns : 0 if successful, -1 if unsuccessful, -2 if incorrect + * arguments + * + */ +int trax_set_postsize (trax_context *context, int count_unit, int unit); + +/* This function shows the amount of TraceRAM in terms of the number of + * instructions or bytes, captured post the stop trigger + * + * context : pointer to structure which contains information about the + * current TRAX session + * count_unit : will contain the count of units(instructions or bytes) post + * trigger + * unit : will contain information about the events that are counted + * 0 implies that the traceRAM words consumed are counted and + * 1 implies that the target processor instructions executed and + * excpetions/interrupts taken are counted + * + * returns : 0 if postsize was got successfully, -1 if unsuccessful + */ +int trax_get_postsize (trax_context *context, int *count_unit, int *unit); + +/* -------------------------- TRAX save routines ---------------------------*/ + +/* This function should be called by the user to return a chunk of + * bytes in buf. It can be a lower layer function of save, or can be + * called by the user explicitly. If bytes_actually_read contains a 0 + * after a call to this function has been made, it implies that the entire + * trace has been read successfully. + * + * context : pointer to structure which contains information about + * the current TRAX session + * buf : Buffer that is allocated by the user, all the trace + * data read would be put in this buffer, which can then + * be used to generate a tracefile. + * The first TRAX_HEADER_SIZE of the buffer will always + * contain the header information. + * bytes_to_be_read : Indicates the bytes the user wants to read. The first + * invocation would need this parameter to be + * TRAX_HEADER_SIZE at least. + * + * returns : bytes actually read during the call to this function. + * 0 implies that all the bytes in the trace have been + * read, -1 if unsuccessful read/write of + * registers or memory, -2 if trace was active while + * this function was called, -3 if user enters + * bytes_to_be_read < TRAX_HEADER_SIZE in the first + * pass + */ +int trax_get_trace (trax_context *context, void *buf, + int bytes_to_be_read); +#ifdef __cplusplus +} +#endif + +#endif /* _TRAX_H */ diff --git a/components/esp32/include/xtensa/traxfile.h b/components/esp32/include/xtensa/traxfile.h new file mode 100755 index 000000000..4afc926a5 --- /dev/null +++ b/components/esp32/include/xtensa/traxfile.h @@ -0,0 +1,62 @@ +/* TRAX file header definition. + + Copyright (c) 2007-2012 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + + +#define TRAX_FHEAD_MAGIC "TRAXdmp" +#define TRAX_FHEAD_VERSION 1 + +/* Header flags: */ +#define TRAX_FHEADF_OCD_ENABLED 0x00000001 /* set if OCD was enabled while capturing trace */ +#define TRAX_FHEADF_TESTDUMP 0x00000002 /* set if is a test file + (from 'memsave' instead of 'save') */ +#define TRAX_FHEADF_OCD_ENABLED_WHILE_EXIT 0x00000004 /* set if OCD was enabled while capturing trace and + we were exiting the OCD mode */ + +/* Header at the start of a TRAX dump file. */ +typedef struct { + char magic[8]; /* 00: "TRAXdmp\0" (TRAX_FHEAD_MAGIC) */ + char endianness; /* 08: 0=little-endian, 1=big-endian */ + char version; /* 09: TRAX_FHEAD_VERSION */ + char reserved0[2]; /* 0A: ... */ + unsigned filesize; /* 0C: size of the trace file, including this header */ + unsigned trace_ofs; /* 10: start of trace output, byte offset from start of header */ + unsigned trace_size; /* 14: size of trace output in bytes */ + unsigned dumptime; /* 18: date/time of capture save (secs since 1970-01-01), 0 if unknown */ + unsigned flags; /* 1C: misc flags (TRAX_FHEAD_F_xxx) */ + char username[16]; /* 20: user doing the capture/save (up to 15 chars) */ + char toolver[24]; /* 30: tool + version used for capture/save (up to 23 chars) */ + char reserved2[40]; /* 48: (reserved - could be hostname used for dump (up to 39 chars)) */ + unsigned configid[2]; /* 70: processor ConfigID values, 0 if unknown */ + unsigned ts_freq; /* 78: timestamp frequency, 0 if not specified */ + unsigned reserved3; /* 7C: (reserved) */ + unsigned id; /* 80: TRAX registers at time of save (0 if not read) */ + unsigned control; + unsigned status; + unsigned reserved4; /* Data register (should not be read) */ + unsigned address; + unsigned trigger; + unsigned match; + unsigned delay; + unsigned trax_regs[24]; /*100: (total size) -- dummy allocation (FIXME) */ +} trax_file_header; + diff --git a/components/esp32/include/xtensa/traxreg.h b/components/esp32/include/xtensa/traxreg.h new file mode 100755 index 000000000..282ba1fee --- /dev/null +++ b/components/esp32/include/xtensa/traxreg.h @@ -0,0 +1,199 @@ +/* TRAX register definitions + + Copyright (c) 2006-2012 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _TRAX_REGISTERS_H_ +#define _TRAX_REGISTERS_H_ + +#define SHOW 1 +#define HIDE 0 + +#define RO 0 +#define RW 1 + +/* TRAX Register Numbers (from possible range of 0..127) */ +#if 0 +#define TRAXREG_ID 0 +#define TRAXREG_CONTROL 1 +#define TRAXREG_STATUS 2 +#define TRAXREG_DATA 3 +#define TRAXREG_ADDRESS 4 +#define TRAXREG_TRIGGER 5 +#define TRAXREG_MATCH 6 +#define TRAXREG_DELAY 7 +#define TRAXREG_STARTADDR 8 +#define TRAXREG_ENDADDR 9 +/* Internal use only (unpublished): */ +#define TRAXREG_P4CHANGE 16 +#define TRAXREG_P4REV 17 +#define TRAXREG_P4DATE 18 +#define TRAXREG_P4TIME 19 +#define TRAXREG_PDSTATUS 20 +#define TRAXREG_PDDATA 21 +#define TRAXREG_STOP_PC 22 +#define TRAXREG_STOP_ICNT 23 +#define TRAXREG_MSG_STATUS 24 +#define TRAXREG_FSM_STATUS 25 +#define TRAXREG_IB_STATUS 26 +#define TRAXREG_MAX 27 +#define TRAXREG_ITCTRL 96 +#endif +/* The registers above match the NAR addresses. So, their values are used for NAR access */ + +/* TRAX Register Fields */ + +/* TRAX ID register fields: */ +#define TRAX_ID_PRODNO 0xf0000000 /* product number (0=TRAX) */ +#define TRAX_ID_PRODOPT 0x0f000000 /* product options */ +#define TRAX_ID_MIW64 0x08000000 /* opt: instruction width */ +#define TRAX_ID_AMTRAX 0x04000000 /* opt: collection of options, + internal (VER_2_0 or later)*/ +#define TRAX_ID_MAJVER(id) (((id) >> 20) & 0x0f) +#define TRAX_ID_MINVER(id) (((id) >> 17) & 0x07) +#define TRAX_ID_VER(id) ((TRAX_ID_MAJVER(id)<<4)|TRAX_ID_MINVER(id)) +#define TRAX_ID_STDCFG 0x00010000 /* standard config */ +#define TRAX_ID_CFGID 0x0000ffff /* TRAX configuration ID */ +#define TRAX_ID_MEMSHARED 0x00001000 /* Memshared option in TRAX */ +#define TRAX_ID_FROM_VER(ver) ((((ver) & 0xf0) << 16) | (((ver) & 0x7) << 17)) +/* Other TRAX ID register macros: */ +/* TRAX versions of interest (TRAX_ID_VER(), ie. MAJVER*16 + MINVER): */ +#define TRAX_VER_1_0 0x10 /* RA */ +#define TRAX_VER_1_1 0x11 /* RB thru RC-2010.1 */ +#define TRAX_VER_2_0 0x20 /* RC-2010.2, RD-2010.0, + RD-2011.1 */ +#define TRAX_VER_2_1 0x21 /* RC-2011.3 / RD-2011.2 and + later */ +#define TRAX_VER_3_0 0x30 /* RE-2012.0 */ +#define TRAX_VER_3_1 0x31 /* RE-2012.1 */ +#define TRAX_VER_HUAWEI_3 TRAX_VER_3_0 /* For Huawei, PRs: 25223, 25224 + , 24880 */ + + +/* TRAX version 1.0 requires a couple software workarounds: */ +#define TRAX_ID_1_0_ERRATUM(id) (TRAX_ID_VER(id) == TRAX_VER_1_0) +/* TRAX version 2.0 requires software workaround for PR 22161: */ +#define TRAX_ID_MEMSZ_ERRATUM(id) (TRAX_ID_VER(id) == TRAX_VER_2_0) + +/* TRAX Control register fields: */ +#define TRAX_CONTROL_TREN 0x00000001 +#define TRAX_CONTROL_TRSTP 0x00000002 +#define TRAX_CONTROL_PCMEN 0x00000004 +#define TRAX_CONTROL_PTIEN 0x00000010 +#define TRAX_CONTROL_CTIEN 0x00000020 +#define TRAX_CONTROL_TMEN 0x00000080 /* 2.0+ */ +#define TRAX_CONTROL_CNTU 0x00000200 +#define TRAX_CONTROL_BIEN 0x00000400 +#define TRAX_CONTROL_BOEN 0x00000800 +#define TRAX_CONTROL_TSEN 0x00000800 +#define TRAX_CONTROL_SMPER 0x00007000 +#define TRAX_CONTROL_SMPER_SHIFT 12 +#define TRAX_CONTROL_PTOWT 0x00010000 +#define TRAX_CONTROL_CTOWT 0x00020000 +#define TRAX_CONTROL_PTOWS 0x00100000 +#define TRAX_CONTROL_CTOWS 0x00200000 +#define TRAX_CONTROL_ATID 0x7F000000 /* 2.0+, amtrax */ +#define TRAX_CONTROL_ATID_SHIFT 24 +#define TRAX_CONTROL_ATEN 0x80000000 /* 2.0+, amtrax */ + +#define TRAX_CONTROL_PTOWS_ER 0x00020000 /* For 3.0 */ +#define TRAX_CONTROL_CTOWT_ER 0x00100000 /* For 3.0 */ + +#define TRAX_CONTROL_ITCTO 0x00400000 /* For 3.0 */ +#define TRAX_CONTROL_ITCTIA 0x00800000 /* For 3.0 */ +#define TRAX_CONTROL_ITATV 0x01000000 /* For 3.0 */ + + +/* TRAX Status register fields: */ +#define TRAX_STATUS_TRACT 0x00000001 +#define TRAX_STATUS_TRIG 0x00000002 +#define TRAX_STATUS_PCMTG 0x00000004 +#define TRAX_STATUS_BUSY 0x00000008 /* ER ??? */ +#define TRAX_STATUS_PTITG 0x00000010 +#define TRAX_STATUS_CTITG 0x00000020 +#define TRAX_STATUS_MEMSZ 0x00001F00 +#define TRAX_STATUS_MEMSZ_SHIFT 8 +#define TRAX_STATUS_PTO 0x00010000 +#define TRAX_STATUS_CTO 0x00020000 + +#define TRAX_STATUS_ITCTOA 0x00400000 /* For 3.0 */ +#define TRAX_STATUS_ITCTI 0x00800000 /* For 3.0 */ +#define TRAX_STATUS_ITATR 0x01000000 /* For 3.0 */ + + +/* TRAX Address register fields: */ +#define TRAX_ADDRESS_TWSAT 0x80000000 +#define TRAX_ADDRESS_TWSAT_SHIFT 31 +#define TRAX_ADDRESS_TOTALMASK 0x00FFFFFF +// !!! VUakiVU. added for new TRAX: +#define TRAX_ADDRESS_WRAPCNT 0x7FE00000 /* version ???... */ +#define TRAX_ADDRESS_WRAP_SHIFT 21 + +/* TRAX PCMatch register fields: */ +#define TRAX_PCMATCH_PCML 0x0000001F +#define TRAX_PCMATCH_PCML_SHIFT 0 +#define TRAX_PCMATCH_PCMS 0x80000000 + +/* Compute trace ram buffer size (in bytes) from status register: */ +#define TRAX_MEM_SIZE(status) (1L << (((status) & TRAX_STATUS_MEMSZ) >> TRAX_STATUS_MEMSZ_SHIFT)) + +#if 0 +/* Describes a field within a register: */ +typedef struct { + const char* name; +// unsigned width; +// unsigned shift; + char width; + char shift; + char visible; /* 0 = internal use only, 1 = shown */ + char reserved; +} trax_regfield_t; +#endif + +/* Describes a TRAX register: */ +typedef struct { + const char* name; + unsigned id; + char width; + char visible; + char writable; + char reserved; + //const trax_regfield_t * fieldset; +} trax_regdef_t; + + +extern const trax_regdef_t trax_reglist[]; +extern const signed char trax_readable_regs[]; + +#ifdef __cplusplus +extern "C" { +#endif + +/* Prototypes: */ +extern int trax_find_reg(char * regname, char **errmsg); +extern const char * trax_regname(int regno); + +#ifdef __cplusplus +} +#endif + +#endif /* _TRAX_REGISTERS_H_ */ + diff --git a/components/esp32/include/xtensa/uart-16550-board.h b/components/esp32/include/xtensa/uart-16550-board.h new file mode 100755 index 000000000..8ef8af163 --- /dev/null +++ b/components/esp32/include/xtensa/uart-16550-board.h @@ -0,0 +1,69 @@ +/******************************************************************************* +Copyright (c) 2006-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +These coded instructions, statements, and computer programs are the +copyrighted works and confidential proprietary information of Tensilica Inc. +They may not be modified, copied, reproduced, distributed, or disclosed to +third parties in any manner, medium, or form, in whole or in part, without +the prior written consent of Tensilica Inc. +-------------------------------------------------------------------------------- + +uart-16550-board.h Board-specific UART info on these boards: + Avnet AV60 (XT-AV60) + Avnet AV110 (XT-AV110) + Avnet AV200 (XT-AV200) + Xilinx ML605 (XT-ML605) + Xilinx KC705 (XT-KC705) + +Interface between board-independent driver and board-specific header. + +This is used by a board-independent 16550 UART driver to obtain board-specific +information about 1 instance of the 16550 UART on the board, such as the device +register base address and spacing (a function of how the address lines are +connected on the board) and the frequency of the UART clock. The driver does +not refer directly to the board-specific header, which therefore is not +constrained to use macro names consistent with other boards. + +!! Must not contain any board-specific macro names (only UART specific). !! + +Included at compile-time via an include path specific to the board. + +These boards contain a single 16550 UART implemented on the FPGA. +Their clock frequency comes from the board's core clock (not its own crystal) +which depends on the core config so is not a constant. Obtained via the BSP. + +*******************************************************************************/ + +#ifndef _UART_16550_BOARD_H +#define _UART_16550_BOARD_H + +#include /* BSP API */ +#include /* Board info */ + + +/* Base address of UART's registers. */ +#ifdef UART16550_VADDR +#define UART_16550_REGBASE UART16550_VADDR +#endif + +/* +The UART's registers are connected at word addresses on these boards. +Each byte-wide register appears as the least-significant-byte (LSB) of the +word regardless of the endianness of the processor. +*/ +#define UART_16550_REGSPACING 4 +typedef unsigned uart16550_reg_t; + +/* UART Clock Frequency in Hz */ +#define UART_16550_XTAL_FREQ xtbsp_clock_freq_hz() + +/* UART Interrupt Number */ +#ifdef UART16550_INTNUM +#define UART_16550_INTNUM UART16550_INTNUM +#endif + + +/* Include generic information shared by all boards that use this device. */ +#include + +#endif /* _UART_16550_BOARD_H */ + diff --git a/components/esp32/include/xtensa/uart-16550.h b/components/esp32/include/xtensa/uart-16550.h new file mode 100755 index 000000000..c551c64c1 --- /dev/null +++ b/components/esp32/include/xtensa/uart-16550.h @@ -0,0 +1,152 @@ +/******************************************************************************* + + Copyright (c) 2006-2007 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +-------------------------------------------------------------------------------- + +uart-16550.h Generic definitions for National Semiconductor 16550 UART + +This is used by board-support-packages with one or more 16550 compatible UARTs. +A BSP provides a base address for each instance of a 16550 UART on the board. + +Note that a 16552 DUART (Dual UART) is simply two instances of a 16550 UART. + +*******************************************************************************/ + +#ifndef _UART_16550_H_ +#define _UART_16550_H_ + +/* C interface to UART registers. */ +struct uart_dev_s { + union { + uart16550_reg_t rxb; /* DLAB=0: receive buffer, read-only */ + uart16550_reg_t txb; /* DLAB=0: transmit buffer, write-only */ + uart16550_reg_t dll; /* DLAB=1: divisor, LS byte latch */ + } w0; + union { + uart16550_reg_t ier; /* DLAB=0: interrupt-enable register */ + uart16550_reg_t dlm; /* DLAB=1: divisor, MS byte latch */ + } w1; + + union { + uart16550_reg_t isr; /* DLAB=0: interrupt status register, read-only */ + uart16550_reg_t fcr; /* DLAB=0: FIFO control register, write-only */ + uart16550_reg_t afr; /* DLAB=1: alternate function register */ + } w2; + + uart16550_reg_t lcr; /* line control-register, write-only */ + uart16550_reg_t mcr; /* modem control-regsiter, write-only */ + uart16550_reg_t lsr; /* line status register, read-only */ + uart16550_reg_t msr; /* modem status register, read-only */ + uart16550_reg_t scr; /* scratch regsiter, read/write */ +}; + + +#define _RXB(u) ((u)->w0.rxb) +#define _TXB(u) ((u)->w0.txb) +#define _DLL(u) ((u)->w0.dll) +#define _IER(u) ((u)->w1.ier) +#define _DLM(u) ((u)->w1.dlm) +#define _ISR(u) ((u)->w2.isr) +#define _FCR(u) ((u)->w2.fcr) +#define _AFR(u) ((u)->w2.afr) +#define _LCR(u) ((u)->lcr) +#define _MCR(u) ((u)->mcr) +#define _LSR(u) ((u)->lsr) +#define _MSR(u) ((u)->msr) +#define _SCR(u) ((u)->scr) + +typedef volatile struct uart_dev_s uart_dev_t; + +/* IER bits */ +#define RCVR_DATA_REG_INTENABLE 0x01 +#define XMIT_HOLD_REG_INTENABLE 0x02 +#define RCVR_STATUS_INTENABLE 0x04 +#define MODEM_STATUS_INTENABLE 0x08 + +/* FCR bits */ +#define _FIFO_ENABLE 0x01 +#define RCVR_FIFO_RESET 0x02 +#define XMIT_FIFO_RESET 0x04 +#define DMA_MODE_SELECT 0x08 +#define RCVR_TRIGGER_LSB 0x40 +#define RCVR_TRIGGER_MSB 0x80 + +/* AFR bits */ +#define AFR_CONC_WRITE 0x01 +#define AFR_BAUDOUT_SEL 0x02 +#define AFR_RXRDY_SEL 0x04 + +/* ISR bits */ +#define INT_STATUS(r) ((r)&1) +#define INT_PRIORITY(r) (((r)>>1)&0x7) + +/* LCR bits */ +#define WORD_LENGTH(n) (((n)-5)&0x3) +#define STOP_BIT_ENABLE 0x04 +#define PARITY_ENABLE 0x08 +#define EVEN_PARITY 0x10 +#define FORCE_PARITY 0x20 +#define XMIT_BREAK 0x40 +#define DLAB_ENABLE 0x80 + +/* MCR bits */ +#define _DTR 0x01 +#define _RTS 0x02 +#define _OP1 0x04 +#define _OP2 0x08 +#define LOOP_BACK 0x10 + +/* LSR Bits */ +#define RCVR_DATA_READY 0x01 +#define OVERRUN_ERROR 0x02 +#define PARITY_ERROR 0x04 +#define FRAMING_ERROR 0x08 +#define BREAK_INTERRUPT 0x10 +#define XMIT_HOLD_EMPTY 0x20 +#define XMIT_EMPTY 0x40 +#define FIFO_ERROR 0x80 +#define RCVR_READY(u) (_LSR(u)&RCVR_DATA_READY) +#define XMIT_READY(u) (_LSR(u)&XMIT_HOLD_EMPTY) + +/* MSR bits */ +#define _RDR 0x01 +#define DELTA_DSR 0x02 +#define DELTA_RI 0x04 +#define DELTA_CD 0x08 +#define _CTS 0x10 +#define _DSR 0x20 +#define _RI 0x40 +#define _CD 0x80 + + +/* Compute 16-bit divisor for baudrate generator, with rounding: */ +#define UART_DIVISOR(clock,baud) (((clock)/16 + (baud)/2)/(baud)) + +/* Prototypes of driver functions */ +extern void uart16550_init( uart_dev_t *u, unsigned baud, unsigned ndata, + unsigned parity, unsigned nstop ); +extern void uart16550_out( uart_dev_t *u, char c ); +extern char uart16550_in( uart_dev_t *u ); +extern unsigned uart16550_measure_sys_clk( uart_dev_t *u ); + +#endif /* _UART_16550_H_ */ diff --git a/components/esp32/include/xtensa/udma.h b/components/esp32/include/xtensa/udma.h new file mode 100755 index 000000000..a5feb7770 --- /dev/null +++ b/components/esp32/include/xtensa/udma.h @@ -0,0 +1,276 @@ +/* Customer ID=11656; Build=0x5f626; Copyright (c) 2005-2014 by Cadence Design Systems, Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of + * Cadence Design Systems, Inc. They may not be modified, copied, reproduced, + * distributed, or disclosed to third parties in any manner, medium, or form, + * in whole or in part, without the prior written consent of Cadence Design + * Systems Inc. + */ +#ifndef __UDMA_H__ +#define __UDMA_H__ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Size of the uDMA descriptor */ +#define UDMA_DESC_STRUCT_SIZE 32 + +/* Request attribute is a bit vector passed to the udma functions - udma_copy, + * udma_2d_copy, udma_add_descs. + * Bit 0 : 1 - trigger an interrupt when done, else do nothing + * Bit 1 : 0 - retry the failed request; abort after programmer specified + * number of retries. Defaults to abort with no retries. + * 1 - abort the failed request (after retries) and all pending requests + */ +#define UDMA_DONE_INTERRUPT 0x1 +#define UDMA_ERROR_ABORT 0x0 +#define UDMA_ERROR_ABORT_ALL 0x2 + +/* Enum representing various udma error conditions, udma status, and + * return values + */ +typedef enum { + UDMA_OK = 0, + UDMA_ERROR_QUEUE_FULL = 1, + UDMA_ERROR_BAD_DESC = 2, + UDMA_ERROR_DRAM_CROSSING = 3, + UDMA_ERROR_PIF_ADDR_BUS = 4, + UDMA_ERROR_PIF_DATA_BUS = 5, + UDMA_REQ_PENDING = 6, + UDMA_REQ_DONE = 7, + UDMA_ERROR_BAD_REQUEST = 8, + UDMA_ERROR_INVALID_ARG = 11, + UDMA_ERROR_INIT = 12, + UDMA_ERROR_INTERNAL = -1 +} udma_status_t; + +#ifndef __UDMA_INTERNAL_H__ +/* Opaque structure describing a uDMA descriptor */ +struct udma_desc_struct { + char _[UDMA_DESC_STRUCT_SIZE]; +} __attribute__ ((aligned (UDMA_DESC_STRUCT_SIZE))); +#endif + +typedef struct udma_desc_struct udma_desc_t; + +/* Initialize the udma control structure, the uDMA registers with + * the descriptor queue addresses, and the uDMA sync and error interrupt + * handler. This function needs to be invoked prior to using the uDMA. + * + * xmp_udma_sync_intr : Processor interrupt number to flag udma done + * xmp_udma_error_intr : Processor interrupt number to flag udma error + * + * Returns UDMA_ERROR_INIT if there was an error during initialization else + * returns UDMA_OK. + */ +extern udma_status_t +udma_init(uint32_t xmp_udma_sync_intr, uint32_t xmp_udma_error_intr); + +/* Performs a copy of a linear block of size bytes from the src + * to the dest address. If the call returns UDMA_OK, status is set to + * UDMA_REQ_PENDING or UDMA_REQ_DONE. If there is a dma error, the error code, + * which could be one of UDMA_ERROR_BAD_DESC, UDMA_ERROR_DRAM_CROSSING, + * UDMA_ERROR_PIF_ADDR_BUS, UDMA_ERROR_PIF_DATA_BUS is returned in the status. + * Status is set to UDMA_REQ_DONE if the dma completes normally. + * On completion, the callback function is invoked with the callback_data + * and status as parameters. Note, the callback is always invoked even if + * there is a dma error. + * + * src : src address of the copy + * dest : dest address of the copy + * size : number of bytes to copy + * callback_data : optional data to be passed to callback_func + * callback_func : optional callback after copy is done + * request_attr : attribute defining how to process this request + * (see description of the request attribute in top of udma.h) + * status : track status of the copy; this gets also passed + * as the second argument to the callback_func + * + * Returns UDMA_ERROR_QUEUE_FULL if no more requests can be added, else + * returns UDMA_OK. + */ +extern udma_status_t +udma_copy(void *dest, + void *src, + size_t size, + void *callback_data, + void (*callback_func)(void *, udma_status_t *status), + uint32_t request_attr, + udma_status_t *status); + +/* Performs a copy of a 2D block of data from the src to the dest + * address. If the call returns UDMA_OK, status is set to UDMA_REQ_PENDING or + * UDMA_REQ_DONE. If there is a dma error, the error code, + * which could be one of UDMA_ERROR_BAD_DESC, UDMA_ERROR_DRAM_CROSSING, + * UDMA_ERROR_PIF_ADDR_BUS, UDMA_ERROR_PIF_DATA_BUS is returned in the status. + * Status is set to UDMA_REQ_DONE if the dma completes normally. + * On completion, the callback function is invoked with the callback_data + * and status as parameters. Note, the callback is always invoked even if + * there is a dma error. + * + * src : src address of the copy + * dest : dest address of the copy + * row_size : number of bytes per row to copy + * num_rows : number of rows to copy + * src_pitch : src pitch + * dest_pitch : dest pitch + * callback_data : optional data to be passed to callback_func + * callback_func : optional callback after copy is done + * request_attr : attribute defining how to process this request + * (see description of the request attribute in top of udma.h) + * status : track status of the copy; this gets also passed + * as the second argument to the callback_func + * + * Returns UDMA_ERROR_QUEUE_FULL if no more requests can be added, else + * returns UDMA_OK. + */ +extern udma_status_t +udma_2d_copy(void *dest, + void *src, + size_t row_size, + uint32_t num_rows, + uint32_t src_pitch, + uint32_t dest_pitch, + void *callback_data, + void (*callback_func)(void *, udma_status_t *status), + uint32_t request_attr, + udma_status_t *status); + +/* Process requests that are done. Any callbacks associated + * with the completed requests gets invoked. If there are any errors, + * the error request is (and any pending request based on the request attribute) + * cancelled and the error code is returned in the status associated with + * all such cancelled requests. Callbacks associated with the cancelled + * requests are also invoked. If all requests terminate normally, the status + * of the completed requests are set to UDMA_REQ_DONE. + * + * Returns void + */ +extern void +udma_process_requests(); + +/* Sets the udma max PIF block size + * + * max_block_size : max block size to be set + * + * Returns UDMA_ERROR_INVALID_ARG if block_size is > 3, else returns UDMA_OK + */ +udma_status_t +udma_set_max_block_size(uint32_t block_size); + +/* Sets the udma max outstanding PIF requests + * + * max_outstanding : max outstanding PIF requests + * + * Returns UDMA_ERROR_INVALID_ARG if max_outstanding is not between 1 and 16 + * else returns UDMA_OK + */ +udma_status_t +udma_set_max_outstanding(uint32_t max_outstanding); + +/* Initialize a uDMA descriptor using the copy parameters. The descriptor + * is then queued separately using udma_add_desc + * + * src : src address of the copy + * dest : dest address of the copy + * row_size : number of bytes per row to copy + * num_rows : number of rows to copy + * src_pitch : src pitch + * dest_pitch : dest pitch + * notify_with_interrupt : If 1, interrupt when dma is done with this descriptor + * if 0, do nothing, else undefined + * + * Returns void + */ +extern void +udma_set_desc(void *src, + void *dest, + size_t row_size, + uint32_t num_rows, + uint32_t src_pitch, + uint32_t dest_pitch, + uint32_t notify_with_interrupt, + udma_desc_t *desc); + +/* Add multiple uDMA descriptors to the descriptor queue. If the call returns + * UDMA_OK, the status is set to UDMA_REQ_PENDING or UDMA_REQ_DONE. + * If there is a dma error, the error code, which could be one of + * UDMA_ERROR_BAD_DESC, UDMA_ERROR_DRAM_CROSSING, UDMA_ERROR_PIF_ADDR_BUS, + * UDMA_ERROR_PIF_DATA_BUS is returned in the status. Status is set + * to UDMA_REQ_DONE, if the dma completes normally. + * On completion, the callback function is invoked with the callback_data + * and status as parameters. Note, the callback is always invoked even if + * there is a dma error. + * + * desc : descriptors to be added + * num_desc : number of descriptors to be added + * callback_data : optional data to be passed to callback_func + * callback_func : optional callback after copy is done + * request_attr : attribute defining how to process this request + * (see description of the request attribute in top of udma.h) + * Note, bit 0 (for enabling interrupt) is ignored in this call. + * To interrupt on dma completion, set the + * notify_with_interrupt parameter when creating descriptors + * using udma_set_desc. + * status : track status of the copy; this gets also passed + * as the second argument to the callback_func + * + * Returns UDMA_ERROR_QUEUE_FULL if no more descriptors can be added, + * UDMA_ERROR_INVALID_ARG if num_descs == 0, else return UDMA_OK + */ +udma_status_t +udma_add_descs(udma_desc_t *descs, + uint32_t num_descs, + void *callback_data, + void (*callback_func)(void *, udma_status_t *status), + uint32_t request_attr, + udma_status_t *status); + +/* Wait for udma copy request to complete. Could spin wait or goto waiti + * based on the sleep_wait parameter. Once the request is done, the callback + * associated with this request and any prior completed requests are handled. + * Error code, if any, is returned in the status s, else s is set to + * UDMA_REQ_DONE. + * + * s : status to wait for + * sleep_wait : sleep wait if true, else spin waits + * + * Returns void + */ +extern void +udma_wait_request(volatile udma_status_t *s, uint32_t sleep_wait); + +/* Inlined function to set the src, dest address of the descriptor + * + * src : src address of the uDMA + * dest : dest address of the uDMA + * desc : descriptor to be modified + * + * Returns void + */ +void static inline +udma_set_desc_addrs(void *src, void *dest, udma_desc_t *desc) { + uint32_t *d = (uint32_t *)desc; + *d = (uintptr_t)src; + *(d+1) = (uintptr_t)dest; +} + +/* Sets the number of retries for a failed dma request + * + * max_retries : max number of retries + * + * Sets the max number of retries for a failed dma request. The default is 0, + * i.e, no retries + */ +void +udma_set_max_retries(uint32_t max_retries); + +#ifdef __cplusplus +} +#endif + +#endif /* __UDMA_H__ */ diff --git a/components/esp32/include/xtensa/xdm-regs.h b/components/esp32/include/xtensa/xdm-regs.h new file mode 100755 index 000000000..50ee02933 --- /dev/null +++ b/components/esp32/include/xtensa/xdm-regs.h @@ -0,0 +1,530 @@ +/* xdm-regs.h - Common register and related definitions for the XDM + (Xtensa Debug Module) */ + +/* Copyright (c) 2011-2012 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + + +#ifndef _XDM_REGS_H_ +#define _XDM_REGS_H_ + +/* NOTE: This header file is included by C, assembler, and other sources. + So any C-specific or asm-specific content must be appropriately #ifdef'd. */ + + +/* + * XDM registers can be accessed using APB, ERI, or JTAG (via NAR). + * Address offsets for APB and ERI are the same, and for JTAG + * is different (due to the limited 7-bit NAR addressing). + * + * Here, we first provide the constants as APB / ERI address offsets. + * This is necessary for assembler code (which accesses XDM via ERI), + * because complex conversion macros between the two address maps + * don't work in the assembler. + * Conversion macros are used to convert these to/from JTAG (NAR), + * addresses, for software using JTAG. + */ +/* FIXME: maybe provide only MISC+CS registers here, and leave specific + subsystem registers in separate headers? eg. for TRAX, PERF, OCD */ + +/* XDM_.... ERI addr [NAR addr] Description...... */ + +/* TRAX */ +#define XDM_TRAX_ID 0x0000 /*[0x00] ID */ +#define XDM_TRAX_CONTROL 0x0004 /*[0x01] Control */ +#define XDM_TRAX_STATUS 0x0008 /*[0x02] Status */ +#define XDM_TRAX_DATA 0x000C /*[0x03] Data */ +#define XDM_TRAX_ADDRESS 0x0010 /*[0x04] Address */ +#define XDM_TRAX_TRIGGER 0x0014 /*[0x05] Stop PC */ +#define XDM_TRAX_MATCH 0x0018 /*[0x06] Stop PC Range */ +#define XDM_TRAX_DELAY 0x001C /*[0x07] Post Stop Trigger Capture Size */ +#define XDM_TRAX_STARTADDR 0x0020 /*[0x08] Trace Memory Start */ +#define XDM_TRAX_ENDADDR 0x0024 /*[0x09] Trace Memory End */ +#define XDM_TRAX_DEBUGPC 0x003C /*[0x0F] Debug PC */ +#define XDM_TRAX_P4CHANGE 0x0040 /*[0x10] X */ +#define XDM_TRAX_TIME0 0x0040 /*[0x10] First Time Register */ +#define XDM_TRAX_P4REV 0x0044 /*[0x11] X */ +#define XDM_TRAX_TIME1 0x0044 /*[0x11] Second Time Register */ +#define XDM_TRAX_P4DATE 0x0048 /*[0x12] X */ +#define XDM_TRAX_INTTIME_MAX 0x0048 /*[0x12] maximal Value of Timestamp IntTime */ +#define XDM_TRAX_P4TIME 0x004C /*[0x13] X */ +#define XDM_TRAX_PDSTATUS 0x0050 /*[0x14] Sample of PDebugStatus */ +#define XDM_TRAX_PDDATA 0x0054 /*[0x15] Sample of PDebugData */ +#define XDM_TRAX_STOP_PC 0x0058 /*[0x16] X */ +#define XDM_TRAX_STOP_ICNT 0x005C /*[0x16] X */ +#define XDM_TRAX_MSG_STATUS 0x0060 /*[0x17] X */ +#define XDM_TRAX_FSM_STATUS 0x0064 /*[0x18] X */ +#define XDM_TRAX_IB_STATUS 0x0068 /*[0x19] X */ +#define XDM_TRAX_STOPCNT 0x006C /*[0x1A] X */ + +/* Performance Monitoring Counters */ +#define XDM_PERF_PMG 0x1000 /*[0x20] perf. mon. global control register */ +#define XDM_PERF_INTPC 0x1010 /*[0x24] perf. mon. interrupt PC */ +#define XDM_PERF_PM0 0x1080 /*[0x28] perf. mon. counter 0 value */ +#define XDM_PERF_PM1 0x1084 /*[0x29] perf. mon. counter 1 value */ +#define XDM_PERF_PM2 0x1088 /*[0x2A] perf. mon. counter 2 value */ +#define XDM_PERF_PM3 0x108C /*[0x2B] perf. mon. counter 3 value */ +#define XDM_PERF_PM4 0x1090 /*[0x2C] perf. mon. counter 4 value */ +#define XDM_PERF_PM5 0x1094 /*[0x2D] perf. mon. counter 5 value */ +#define XDM_PERF_PM6 0x1098 /*[0x2E] perf. mon. counter 6 value */ +#define XDM_PERF_PM7 0x109C /*[0x2F] perf. mon. counter 7 value */ +#define XDM_PERF_PM(n) (0x1080+((n)<<2)) /* perfmon cnt n=0..7 value */ +#define XDM_PERF_PMCTRL0 0x1100 /*[0x30] perf. mon. counter 0 control */ +#define XDM_PERF_PMCTRL1 0x1104 /*[0x31] perf. mon. counter 1 control */ +#define XDM_PERF_PMCTRL2 0x1108 /*[0x32] perf. mon. counter 2 control */ +#define XDM_PERF_PMCTRL3 0x110C /*[0x33] perf. mon. counter 3 control */ +#define XDM_PERF_PMCTRL4 0x1110 /*[0x34] perf. mon. counter 4 control */ +#define XDM_PERF_PMCTRL5 0x1114 /*[0x35] perf. mon. counter 5 control */ +#define XDM_PERF_PMCTRL6 0x1118 /*[0x36] perf. mon. counter 6 control */ +#define XDM_PERF_PMCTRL7 0x111C /*[0x37] perf. mon. counter 7 control */ +#define XDM_PERF_PMCTRL(n) (0x1100+((n)<<2)) /* perfmon cnt n=0..7 control */ +#define XDM_PERF_PMSTAT0 0x1180 /*[0x38] perf. mon. counter 0 status */ +#define XDM_PERF_PMSTAT1 0x1184 /*[0x39] perf. mon. counter 1 status */ +#define XDM_PERF_PMSTAT2 0x1188 /*[0x3A] perf. mon. counter 2 status */ +#define XDM_PERF_PMSTAT3 0x118C /*[0x3B] perf. mon. counter 3 status */ +#define XDM_PERF_PMSTAT4 0x1190 /*[0x3C] perf. mon. counter 4 status */ +#define XDM_PERF_PMSTAT5 0x1194 /*[0x3D] perf. mon. counter 5 status */ +#define XDM_PERF_PMSTAT6 0x1198 /*[0x3E] perf. mon. counter 6 status */ +#define XDM_PERF_PMSTAT7 0x119C /*[0x3F] perf. mon. counter 7 status */ +#define XDM_PERF_PMSTAT(n) (0x1180+((n)<<2)) /* perfmon cnt n=0..7 status */ + +/* On-Chip-Debug (OCD) */ +#define XDM_OCD_ID 0x2000 /*[0x40] ID register */ +#define XDM_OCD_DCR_CLR 0x2008 /*[0x42] Debug Control reg clear */ +#define XDM_OCD_DCR_SET 0x200C /*[0x43] Debug Control reg set */ +#define XDM_OCD_DSR 0x2010 /*[0x44] Debug Status reg */ +#define XDM_OCD_DDR 0x2014 /*[0x45] Debug Data reg */ +#define XDM_OCD_DDREXEC 0x2018 /*[0x46] Debug Data reg + execute-DIR */ +#define XDM_OCD_DIR0EXEC 0x201C /*[0x47] Debug Instruction reg, word 0 + execute-DIR */ +#define XDM_OCD_DIR0 0x2020 /*[0x48] Debug Instruction reg, word 1 */ +#define XDM_OCD_DIR1 0x2024 /*[0x49] Debug Instruction reg, word 2 */ +#define XDM_OCD_DIR2 0x2028 /*[0x4A] Debug Instruction reg, word 3 */ +#define XDM_OCD_DIR3 0x202C /*[0x49] Debug Instruction reg, word 4 */ +#define XDM_OCD_DIR4 0x2030 /*[0x4C] Debug Instruction reg, word 5 */ +#define XDM_OCD_DIR5 0x2034 /*[0x4D] Debug Instruction reg, word 5 */ +#define XDM_OCD_DIR6 0x2038 /*[0x4E] Debug Instruction reg, word 6 */ +#define XDM_OCD_DIR7 0x203C /*[0x4F] Debug Instruction reg, word 7 */ + +/* Miscellaneous Registers */ +#define XDM_MISC_PWRCTL 0x3020 /*[0x58] Power and Reset Control */ +#define XDM_MISC_PWRSTAT 0x3024 /*[0x59] Power and Reset Status */ +#define XDM_MISC_ERISTAT 0x3028 /*[0x5A] ERI Transaction Status */ +#define XDM_MISC_DATETIME 0x3034 /*[0x5D] [INTERNAL] Timestamps of build */ +#define XDM_MISC_UBID 0x3038 /*[0x5E] [INTERNAL] Build Unique ID */ +#define XDM_MISC_CID 0x303C /*[0x5F] [INTERNAL] Customer ID */ + +/* CoreSight compatibility */ +#define XDM_CS_ITCTRL 0x3F00 /*[0x60] InTegration Mode control reg */ +#define XDM_CS_CLAIMSET 0x3FA0 /*[0x68] Claim Tag Set reg */ +#define XDM_CS_CLAIMCLR 0x3FA4 /*[0x69] Claim Tag Clear reg */ +#define XDM_CS_LOCK_ACCESS 0x3FB0 /*[0x6B] Lock Access (writing 0xC5ACCE55 unlocks) */ +#define XDM_CS_LOCK_STATUS 0x3FB4 /*[0x6D] Lock Status */ +#define XDM_CS_AUTH_STATUS 0x3FB8 /*[0x6E] Authentication Status */ +#define XDM_CS_DEV_ID 0x3FC8 /*[0x72] Device ID */ +#define XDM_CS_DEV_TYPE 0x3FCC /*[0x73] Device Type */ +#define XDM_CS_PER_ID4 0x3FD0 /*[0x74] Peripheral ID reg byte 4 */ +#define XDM_CS_PER_ID5 0x3FD4 /*[0x75] Peripheral ID reg byte 5 */ +#define XDM_CS_PER_ID6 0x3FD8 /*[0x76] Peripheral ID reg byte 6 */ +#define XDM_CS_PER_ID7 0x3FDC /*[0x77] Peripheral ID reg byte 7 */ +#define XDM_CS_PER_ID0 0x3FE0 /*[0x78] Peripheral ID reg byte 0 */ +#define XDM_CS_PER_ID1 0x3FE4 /*[0x79] Peripheral ID reg byte 1 */ +#define XDM_CS_PER_ID2 0x3FE8 /*[0x7A] Peripheral ID reg byte 2 */ +#define XDM_CS_PER_ID3 0x3FEC /*[0x7B] Peripheral ID reg byte 3 */ +#define XDM_CS_COMP_ID0 0x3FF0 /*[0x7C] Component ID reg byte 0 */ +#define XDM_CS_COMP_ID1 0x3FF4 /*[0x7D] Component ID reg byte 1 */ +#define XDM_CS_COMP_ID2 0x3FF8 /*[0x7E] Component ID reg byte 2 */ +#define XDM_CS_COMP_ID3 0x3FFC /*[0x7F] Component ID reg byte 3 */ + +#define CS_PER_ID0 0x00000003 +#define CS_PER_ID1 0x00000021 +#define CS_PER_ID2 0x0000000f +#define CS_PER_ID3 0x00000000 +#define CS_PER_ID4 0x00000024 + +#define CS_COMP_ID0 0x0000000d +#define CS_COMP_ID1 0x00000090 +#define CS_COMP_ID2 0x00000005 +#define CS_COMP_ID3 0x000000b1 + +#define CS_DEV_TYPE 0x00000015 + +#define XTENSA_IDCODE 0x120034e5 // FIXME (upper bits not spec. out but BE is !) +#define XTENSA_MFC_ID (XTENSA_IDCODE & 0xFFF) +#define CS_DEV_ID XTENSA_IDCODE + +#define NXS_OCD_REG(val) ((val >= 0x40) && (val <= 0x5F)) +#define NXS_TRAX_REG(val) val <= 0x3F + +#define ERI_TRAX_REG(val) ((val & 0xFFFF) < 0x1000) +#define ERI_OCD_REG(val) ((val & 0xFFFF) >= 0x2000) && ((val & 0xFFFF) < 0x4000)) + +/* Convert above 14-bit ERI/APB address/offset to 7-bit NAR address: */ +#define _XDM_ERI_TO_NAR(a) ( ((a)&0x3F80)==0x0000 ? (((a)>>2) & 0x1F) \ + : ((a)&0x3E00)==0x1000 ? (0x20 | (((a)>>2) & 7) | (((a)>>4) & 0x18)) \ + : ((a)&0x3FC0)==0x2000 ? (0x40 | (((a)>>2) & 0xF)) \ + : ((a)&0x3FE0)==0x3020 ? (0x50 | (((a)>>2) & 0xF)) \ + : ((a)&0x3FFC)==0x3F00 ? 0x60 \ + : ((a)&0x3F80)==0x3F80 ? (0x60 | (((a)>>2) & 0x1F)) \ + : -1 ) + +#define XDM_ERI_TO_NAR(a) _XDM_ERI_TO_NAR(a & 0xFFFF) + +/* Convert 7-bit NAR address back to ERI/APB address/offset: */ +#define _XDM_NAR_TO_APB(a) ((a) <= 0x1f ? ((a) << 2) \ + :(a) >= 0x20 && (a) <= 0x3F ? (0x1000 | (((a)& 7) << 2) | (((a)&0x18)<<4)) \ + :(a) >= 0x40 && (a) <= 0x4F ? (0x2000 | (((a)&0xF) << 2)) \ + :(a) >= 0x58 && (a) <= 0x5F ? (0x3000 | (((a)&0xF) << 2)) \ + :(a) == 0x60 ? (0x3F00) \ + :(a) >= 0x68 && (a) <= 0x7F ? (0x3F80 | (((a)&0x1F) << 2)) \ + : -1) + +#define XDM_NAR_TO_APB(a) _XDM_NAR_TO_APB((a & 0xFFFF)) +#define XDM_NAR_TO_ERI(a) _XDM_NAR_TO_APB((a & 0xFFFF)) | 0x000000 + +/* Convert APB to ERI address */ +#define XDM_APB_TO_ERI(a) ((a) | (0x100000)) +#define XDM_ERI_TO_APB(a) ((a) & (0x0FFFFF)) + +/*********** Bit definitions within some of the above registers ***********/ +#define OCD_ID_LSDDRP 0x01000000 +#define OCD_ID_LSDDRP_SHIFT 24 +#define OCD_ID_ENDIANESS 0x00000001 +#define OCD_ID_ENDIANESS_SHIFT 0 +#define OCD_ID_PSO 0x0000000C +#define OCD_ID_PSO_SHIFT 2 +#define OCD_ID_TRACEPORT 0x00000080 +#define OCD_ID_TRACEPORT_SHIFT 7 + +/* Power Status register. NOTE: different bit positions in JTAG vs. ERI/APB !! */ +/* ERI/APB: */ +#define PWRSTAT_CORE_DOMAIN_ON 0x00000001 /* set if core is powered on */ +#define PWRSTAT_CORE_DOMAIN_ON_SHIFT 0 +#define PWRSTAT_WAKEUP_RESET 0x00000002 /* [ERI only] 0=cold start, 1=PSO wakeup */ +#define PWRSTAT_WAKEUP_RESET_SHIFT 1 +#define PWRSTAT_CACHES_LOST_POWER 0x00000004 /* [ERI only] set if caches (/localmems?) lost power */ + /* FIXME: does this include local memories? */ +#define PWRSTAT_CACHES_LOST_POWER_SHIFT 2 +#define PWRSTAT_CORE_STILL_NEEDED 0x00000010 /* set if others keeping core awake */ +#define PWRSTAT_CORE_STILL_NEEDED_SHIFT 4 +#define PWRSTAT_MEM_DOMAIN_ON 0x00000100 /* set if memory domain is powered on */ +#define PWRSTAT_MEM_DOMAIN_ON_SHIFT 8 +#define PWRSTAT_DEBUG_DOMAIN_ON 0x00001000 /* set if debug domain is powered on */ +#define PWRSTAT_DEBUG_DOMAIN_ON_SHIFT 12 +#define PWRSTAT_ALL_ON PWRSTAT_CORE_DOMAIN_ON | PWRSTAT_MEM_DOMAIN_ON | PWRSTAT_DEBUG_DOMAIN_ON +#define PWRSTAT_CORE_WAS_RESET 0x00010000 /* [APB only] set if core got reset */ +#define PWRSTAT_CORE_WAS_RESET_SHIFT 16 +#define PWRSTAT_DEBUG_WAS_RESET 0x10000000 /* set if debug module got reset */ +#define PWRSTAT_DEBUG_WAS_RESET_SHIFT 28 +/* JTAG: */ +#define J_PWRSTAT_CORE_DOMAIN_ON 0x01 /* set if core is powered on */ +#define J_PWRSTAT_MEM_DOMAIN_ON 0x02 /* set if memory domain is powered on */ +#define J_PWRSTAT_DEBUG_DOMAIN_ON 0x04 /* set if debug domain is powered on */ +#define J_PWRSTAT_ALL_ON J_PWRSTAT_CORE_DOMAIN_ON | J_PWRSTAT_MEM_DOMAIN_ON | J_PWRSTAT_DEBUG_DOMAIN_ON +#define J_PWRSTAT_CORE_STILL_NEEDED 0x08 /* set if others keeping core awake */ +#define J_PWRSTAT_CORE_WAS_RESET 0x10 /* set if core got reset */ +#define J_PWRSTAT_DEBUG_WAS_RESET 0x40 /* set if debug module got reset */ + +/* Power Control register. NOTE: different bit positions in JTAG vs. ERI/APB !! */ +/* ERI/APB: */ +#define PWRCTL_CORE_SHUTOFF 0x00000001 /* [ERI only] core wants to shut off on WAITI */ +#define PWRCTL_CORE_SHUTOFF_SHIFT 0 +#define PWRCTL_CORE_WAKEUP 0x00000001 /* [APB only] set to force core to stay powered on */ +#define PWRCTL_CORE_WAKEUP_SHIFT 0 +#define PWRCTL_MEM_WAKEUP 0x00000100 /* set to force memory domain to stay powered on */ +#define PWRCTL_MEM_WAKEUP_SHIFT 8 +#define PWRCTL_DEBUG_WAKEUP 0x00001000 /* set to force debug domain to stay powered on */ +#define PWRCTL_DEBUG_WAKEUP_SHIFT 12 +#define PWRCTL_ALL_ON PWRCTL_CORE_WAKEUP | PWRCTL_MEM_WAKEUP | PWRCTL_DEBUG_WAKEUP +#define PWRCTL_CORE_RESET 0x00010000 /* [APB only] set to assert core reset */ +#define PWRCTL_CORE_RESET_SHIFT 16 +#define PWRCTL_DEBUG_RESET 0x10000000 /* set to assert debug module reset */ +#define PWRCTL_DEBUG_RESET_SHIFT 28 +/* JTAG: */ +#define J_PWRCTL_CORE_WAKEUP 0x01 /* set to force core to stay powered on */ +#define J_PWRCTL_MEM_WAKEUP 0x02 /* set to force memory domain to stay powered on */ +#define J_PWRCTL_DEBUG_WAKEUP 0x04 /* set to force debug domain to stay powered on */ +#define J_DEBUG_USE 0x80 /* */ +#define J_PWRCTL_ALL_ON J_DEBUG_USE | J_PWRCTL_CORE_WAKEUP | J_PWRCTL_MEM_WAKEUP | J_PWRCTL_DEBUG_WAKEUP +#define J_PWRCTL_DEBUG_ON J_DEBUG_USE | J_PWRCTL_DEBUG_WAKEUP +#define J_PWRCTL_CORE_RESET 0x10 /* set to assert core reset */ +#define J_PWRCTL_DEBUG_RESET 0x40 /* set to assert debug module reset */ + +#define J_PWRCTL_WRITE_MASK 0xFF +#define J_PWRSTAT_WRITE_MASK 0xFF + +#define PWRCTL_WRITE_MASK ~0 +#define PWRSTAT_WRITE_MASK ~0 + +/************ The following are only relevant for JTAG, so perhaps belong in OCD only **************/ + +/* XDM 5-bit JTAG Instruction Register (IR) values: */ +#define XDM_IR_PWRCTL 0x08 /* select 8-bit Power/Reset Control (PRC) */ +#define XDM_IR_PWRSTAT 0x09 /* select 8-bit Power/Reset Status (PRS) */ +#define XDM_IR_NAR_SEL 0x1c /* select altern. 8-bit NAR / 32-bit NDR (Nexus-style) */ +#define XDM_IR_NDR_SEL 0x1d /* select altern. 32-bit NDR / 8-bit NAR + (FIXME - functionality not yet in HW) */ +#define XDM_IR_IDCODE 0x1e /* select 32-bit JTAG IDCODE */ +#define XDM_IR_BYPASS 0x1f /* select 1-bit bypass */ + +#define XDM_IR_WIDTH 5 /* width of IR for Xtensa TAP */ + +/* NAR register bits: */ +#define XDM_NAR_WRITE 0x01 +#define XDM_NAR_ADDR_MASK 0xFE +#define XDM_NAR_ADDR_SHIFT 1 + +#define XDM_NAR_BUSY 0x02 +#define XDM_NAR_ERROR 0x01 + +#define NEXUS_DIR_READ 0x00 +#define NEXUS_DIR_WRITE 0x01 + +/************ Define DCR register bits **************/ + +#define DCR_ENABLEOCD 0x0000001 +#define DCR_ENABLEOCD_SHIFT 0 +#define DCR_DEBUG_INT 0x0000002 +#define DCR_DEBUG_INT_SHIFT 1 +#define DCR_DEBUG_OVERRIDE 0x0000004 +#define DCR_DEBUG_OVERRIDE_SHIFT 2 +#define DCR_DEBUG_INTERCEPT 0x0000008 +#define DCR_DEBUG_INTERCEPT_SHIFT 3 +#define DCR_MASK_NMI 0x0000020 +#define DCR_MASK_NMI_SHIFT 5 +#define DCR_STEP_ENABLE 0x0000040 +#define DCR_STEP_ENABLE_SHIFT 6 +#define DCR_BREAK_IN_EN 0x0010000 +#define DCR_BREAK_IN_EN_SHIFT 16 +#define DCR_BREAK_OUT_EN 0x0020000 +#define DCR_BREAK_OUT_EN_SHIFT 17 +#define DCR_DEBUG_INT_EN 0x0040000 +#define DCR_DEBUG_INT_EN_SHIFT 18 +#define DCR_DBG_SW_ACTIVE 0x0100000 +#define DCR_DBG_SW_ACTIVE_SHIFT 20 +#define DCR_STALL_IN_EN 0x0200000 +#define DCR_STALL_IN_EN_SHIFT 21 +#define DCR_DEBUG_OUT_EN 0x0400000 +#define DCR_DEBUG_OUT_EN_SHIFT 22 +#define DCR_BREAK_OUT_ITO 0x1000000 +#define DCR_STALL_OUT_ITO 0x2000000 +#define DCR_STALL_OUT_ITO_SHIFT 25 + +/************ Define DSR register bits **************/ + +#define DOSR_EXECDONE_ER 0x01 +#define DOSR_EXECDONE_SHIFT 0 +#define DOSR_EXCEPTION_ER 0x02 +#define DOSR_EXCEPTION_SHIFT 1 +#define DOSR_BUSY 0x04 +#define DOSR_BUSY_SHIFT 2 +#define DOSR_OVERRUN 0x08 +#define DOSR_OVERRUN_SHIFT 3 +#define DOSR_INOCDMODE_ER 0x10 +#define DOSR_INOCDMODE_SHIFT 4 +#define DOSR_CORE_WROTE_DDR_ER 0x400 +#define DOSR_CORE_WROTE_DDR_SHIFT 10 +#define DOSR_CORE_READ_DDR_ER 0x800 +#define DOSR_CORE_READ_DDR_SHIFT 11 +#define DOSR_HOST_WROTE_DDR_ER 0x4000 +#define DOSR_HOST_WROTE_DDR_SHIFT 14 +#define DOSR_HOST_READ_DDR_ER 0x8000 +#define DOSR_HOST_READ_DDR_SHIFT 15 + +#define DOSR_DEBUG_PEND_BIN 0x10000 +#define DOSR_DEBUG_PEND_HOST 0x20000 +#define DOSR_DEBUG_PEND_TRAX 0x40000 +#define DOSR_DEBUG_BIN 0x100000 +#define DOSR_DEBUG_HOST 0x200000 +#define DOSR_DEBUG_TRAX 0x400000 +#define DOSR_DEBUG_PEND_BIN_SHIFT 16 +#define DOSR_DEBUG_PEND_HOST_SHIFT 17 +#define DOSR_DEBUG_PEND_TRAX_SHIFT 18 +#define DOSR_DEBUG_BREAKIN 0x0100000 +#define DOSR_DEBUG_BREAKIN_SHIFT 20 +#define DOSR_DEBUG_HOST_SHIFT 21 +#define DOSR_DEBUG_TRAX_SHIFT 22 + +#define DOSR_DEBUG_STALL 0x1000000 +#define DOSR_DEBUG_STALL_SHIFT 24 + +#define DOSR_CORE_ON 0x40000000 +#define DOSR_CORE_ON_SHIFT 30 +#define DOSR_DEBUG_ON 0x80000000 +#define DOSR_DEBUG_ON_SHIFT 31 + +/********** Performance monitor registers bits **********/ + +#define PERF_PMG_ENABLE 0x00000001 /* global enable bit */ +#define PERF_PMG_ENABLE_SHIFT 0 + +#define PERF_PMCTRL_INT_ENABLE 0x00000001 /* assert interrupt on overflow */ +#define PERF_PMCTRL_INT_ENABLE_SHIFT 0 +#define PERF_PMCTRL_KRNLCNT 0x00000008 /* ignore TRACELEVEL */ +#define PERF_PMCTRL_KRNLCNT_SHIFT 3 +#define PERF_PMCTRL_TRACELEVEL 0x000000F0 /* count when CINTLEVEL <= TRACELEVEL */ +#define PERF_PMCTRL_TRACELEVEL_SHIFT 4 +#define PERF_PMCTRL_SELECT 0x00001F00 /* events group selector */ +#define PERF_PMCTRL_SELECT_SHIFT 8 +#define PERF_PMCTRL_MASK 0xFFFF0000 /* events mask */ +#define PERF_PMCTRL_MASK_SHIFT 16 + +#define PERF_PMSTAT_OVERFLOW 0x00000001 /* counter overflowed */ +#define PERF_PMSTAT_OVERFLOW_SHIFT 0 +#define PERF_PMSTAT_INT 0x00000010 /* interrupt asserted */ +#define PERF_PMSTAT_INT_SHIFT 4 + +#if defined (USE_XDM_REGNAME) || defined (USE_DAP_REGNAME) +/* Describes XDM register: */ +typedef struct { + int reg; + char* name; +} regdef_t; + +/*char* regname(regdef_t* list, int regno) +{ + unsigned i; + for(i = 0 ; i < (sizeof(list) / sizeof(regdef_t)); i++){ + if(list[i].reg == regno) + return list[i].name; + } + return "???"; +}*/ + +/* + * Returns the name of the specified XDM register number, + * or simply "???" if the register number is not recognized. + * FIXME - requires -1 as the last entry - change to compare the name to ??? + * or even better, make the code above to work. + */ +static char * regname(regdef_t* list, int reg) +{ + int i = 0; + while (list[i].reg != -1){ + if (list[i].reg == reg) + break; + i++; + } + return list[i].name; +} + +#if defined (USE_XDM_REGNAME) +regdef_t xdm_reglist[] = +{ + {XDM_TRAX_ID ,"TRAX_ID" }, + {XDM_TRAX_CONTROL ,"CONTROL" }, + {XDM_TRAX_STATUS ,"STATUS" }, + {XDM_TRAX_DATA ,"DATA" }, + {XDM_TRAX_ADDRESS ,"ADDRESS" }, + {XDM_TRAX_TRIGGER ,"TRIGGER PC" }, + {XDM_TRAX_MATCH ,"PC MATCH" }, + {XDM_TRAX_DELAY ,"DELAY CNT." }, + {XDM_TRAX_STARTADDR ,"START ADDRESS"}, + {XDM_TRAX_ENDADDR ,"END ADDRESS" }, + {XDM_TRAX_DEBUGPC ,"DEBUG PC" }, + {XDM_TRAX_P4CHANGE ,"P4 CHANGE" }, + {XDM_TRAX_P4REV ,"P4 REV." }, + {XDM_TRAX_P4DATE ,"P4 DATE" }, + {XDM_TRAX_P4TIME ,"P4 TIME" }, + {XDM_TRAX_PDSTATUS ,"PD STATUS" }, + {XDM_TRAX_PDDATA ,"PD DATA" }, + {XDM_TRAX_STOP_PC ,"STOP PC" }, + {XDM_TRAX_STOP_ICNT ,"STOP ICNT" }, + {XDM_TRAX_MSG_STATUS ,"MSG STAT." }, + {XDM_TRAX_FSM_STATUS ,"FSM STAT." }, + {XDM_TRAX_IB_STATUS ,"IB STAT." }, + + {XDM_OCD_ID ,"OCD_ID" }, + {XDM_OCD_DCR_CLR ,"DCR_CLR" }, + {XDM_OCD_DCR_SET ,"DCR_SET" }, + {XDM_OCD_DSR ,"DOSR" }, + {XDM_OCD_DDR ,"DDR" }, + {XDM_OCD_DDREXEC ,"DDREXEC" }, + {XDM_OCD_DIR0EXEC ,"DIR0EXEC"}, + {XDM_OCD_DIR0 ,"DIR0" }, + {XDM_OCD_DIR1 ,"DIR1" }, + {XDM_OCD_DIR2 ,"DIR2" }, + {XDM_OCD_DIR3 ,"DIR3" }, + {XDM_OCD_DIR4 ,"DIR4" }, + {XDM_OCD_DIR5 ,"DIR5" }, + {XDM_OCD_DIR6 ,"DIR6" }, + {XDM_OCD_DIR7 ,"DIR7" }, + + {XDM_PERF_PMG ,"PMG" }, + {XDM_PERF_INTPC ,"INTPC" }, + {XDM_PERF_PM0 ,"PM0 " }, + {XDM_PERF_PM1 ,"PM1 " }, + {XDM_PERF_PM2 ,"PM2 " }, + {XDM_PERF_PM3 ,"PM3 " }, + {XDM_PERF_PM4 ,"PM4 " }, + {XDM_PERF_PM5 ,"PM5 " }, + {XDM_PERF_PM6 ,"PM6 " }, + {XDM_PERF_PM7 ,"PM7 " }, + {XDM_PERF_PMCTRL0 ,"PMCTRL0"}, + {XDM_PERF_PMCTRL1 ,"PMCTRL1"}, + {XDM_PERF_PMCTRL2 ,"PMCTRL2"}, + {XDM_PERF_PMCTRL3 ,"PMCTRL3"}, + {XDM_PERF_PMCTRL4 ,"PMCTRL4"}, + {XDM_PERF_PMCTRL5 ,"PMCTRL5"}, + {XDM_PERF_PMCTRL6 ,"PMCTRL6"}, + {XDM_PERF_PMCTRL7 ,"PMCTRL7"}, + {XDM_PERF_PMSTAT0 ,"PMSTAT0"}, + {XDM_PERF_PMSTAT1 ,"PMSTAT1"}, + {XDM_PERF_PMSTAT2 ,"PMSTAT2"}, + {XDM_PERF_PMSTAT3 ,"PMSTAT3"}, + {XDM_PERF_PMSTAT4 ,"PMSTAT4"}, + {XDM_PERF_PMSTAT5 ,"PMSTAT5"}, + {XDM_PERF_PMSTAT6 ,"PMSTAT6"}, + {XDM_PERF_PMSTAT7 ,"PMSTAT7"}, + + {XDM_MISC_PWRCTL ,"PWRCTL" }, + {XDM_MISC_PWRSTAT ,"PWRSTAT" }, + {XDM_MISC_ERISTAT ,"ERISTAT" }, + {XDM_MISC_DATETIME ,"DATETIME"}, + {XDM_MISC_UBID ,"UBID" }, + {XDM_MISC_CID ,"CID" }, + + {XDM_CS_ITCTRL ,"ITCTRL" }, + {XDM_CS_CLAIMSET ,"CLAIMSET" }, + {XDM_CS_CLAIMCLR ,"CLAIMCLR" }, + {XDM_CS_LOCK_ACCESS ,"LOCK_ACCESS"}, + {XDM_CS_LOCK_STATUS ,"LOCK_STATUS"}, + {XDM_CS_AUTH_STATUS ,"AUTH_STATUS"}, + {XDM_CS_DEV_ID ,"DEV_ID" }, + {XDM_CS_DEV_TYPE ,"DEV_TYPE" }, + {XDM_CS_PER_ID4 ,"PER_ID4" }, + {XDM_CS_PER_ID5 ,"PER_ID5" }, + {XDM_CS_PER_ID6 ,"PER_ID6" }, + {XDM_CS_PER_ID7 ,"PER_ID7" }, + {XDM_CS_PER_ID0 ,"PER_ID0" }, + {XDM_CS_PER_ID1 ,"PER_ID1" }, + {XDM_CS_PER_ID2 ,"PER_ID2" }, + {XDM_CS_PER_ID3 ,"PER_ID3" }, + {XDM_CS_COMP_ID0 ,"COMP_ID0" }, + {XDM_CS_COMP_ID1 ,"COMP_ID1" }, + {XDM_CS_COMP_ID2 ,"COMP_ID2" }, + {XDM_CS_COMP_ID3 ,"COMP_ID3" }, + {-1 ,"???" }, +}; +#endif + +#endif + +#endif /* _XDM_REGS_H_ */ diff --git a/components/esp32/include/xtensa/xmon.h b/components/esp32/include/xtensa/xmon.h new file mode 100755 index 000000000..12a757a2c --- /dev/null +++ b/components/esp32/include/xtensa/xmon.h @@ -0,0 +1,97 @@ +/* xmon.h - XMON definitions + * + * $Id: //depot/rel/Eaglenest/Xtensa/OS/xmon/xmon.h#3 $ + * + * Copyright (c) 2001-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef __H_XMON +#define __H_XMON + +/* Default GDB packet size */ +#define GDB_PKT_SIZE 4096 + +/*XMON signals */ +#define XMON_SIGINT 2 /*target was interrupted */ +#define XMON_SIGILL 4 /*illegal instruction */ +#define XMON_SIGTRAP 5 /*general exception */ +#define XMON_SIGSEGV 11 /*page faults */ + + +/* Type of log message from XMON to the application */ +typedef enum { + XMON_LOG, + XMON_TRACE, + XMON_ERR, + XMON_APP, + XMON_GDB +} xmon_log_t; + +/* Return value type for xmon_proc() (see below) */ +typedef enum { + XMON_GDB_PEND, + XMON_GDB_PKT, + XMON_NOT_GDB +} xmon_gdb_pkt_t; + +#ifdef _cplusplus +extern "C" { +#endif + +/* + * THE FOLLOWING ROUTINES ARE USED BY USER + */ +extern int _xmon_init(char* gdbBuf, int gdbPktSize, + void(*xlog)(xmon_log_t type, const char* str)); +//Initialize GDB communication and logging to the main app. +//For the logging to work, xlog function needs to be provided. +//gdbBuf - pointer to a buffer XMON can use to comm. with GDB +//gdbPktSize - Size of the allocated buffer for GDB communication. +//xlog - logger handle. + + +extern void _xmon_close(void); +//Main application can detach from xmon at any time + + +extern xmon_gdb_pkt_t _xmon_proc(char); +// Give character to XMON to check if GDB message +// Application is supposed to accumulate all the +// character in case the recognition fails and chars +// have to be sent to the original handler +// Return: XMON_GDB_PEND - send me more chars +// XMON_GDB_PKT - GDB message confirmed, C) not +// XMON_NOT_GDB - not GDB message + + +/* + * THE FOLLOWING ROUTINES NEED TO BE PROVIDED BY USER + */ +extern int _xmon_in(); // wait for character from GDB +extern void _xmon_out(char); // output a character to GDB +extern int _xmon_flush(void); // flush output characters + +#ifdef _cplusplus +} +#endif + +#endif diff --git a/components/esp32/include/xtensa/xmp-library.h b/components/esp32/include/xtensa/xmp-library.h new file mode 100755 index 000000000..624272077 --- /dev/null +++ b/components/esp32/include/xtensa/xmp-library.h @@ -0,0 +1,789 @@ +/* Customer ID=11656; Build=0x5f626; Copyright (c) 2008-2009 by Tensilica Inc. ALL RIGHTS RESERVED. + These coded instructions, statements, and computer programs are the + copyrighted works and confidential proprietary information of Tensilica Inc. + They may not be modified, copied, reproduced, distributed, or disclosed to + third parties in any manner, medium, or form, in whole or in part, without + the prior written consent of Tensilica Inc. */ + +#ifndef _XMP_LIBRARY_H +#define _XMP_LIBRARY_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#if XCHAL_HAVE_RELEASE_SYNC +#include +#endif +#if XCHAL_HAVE_EXTERN_REGS +#include +#endif +#include +#include + +#include "xtensa/system/mpsystem.h" + +/* + W A R N I N G: + + xmp library clients should treat all data structures in this file + as opaque. They are only public to enable users to declare them + statically. +*/ + + +/* ------------------------------------------------------------------------- + When using XMP on cache-incoherent systems, these macros are helpful + to ensure that you are not reading stale data, and to ensure that + the data you write makes it all the way back to main memory. + */ + +#if !XCHAL_DCACHE_IS_COHERENT +#define XMP_WRITE_BACK_ELEMENT(x) xthal_dcache_region_writeback((void *)x, sizeof(*x)) +#define XMP_INVALIDATE_ELEMENT(x) xthal_dcache_region_invalidate((void *)x, sizeof(*x)) +#define XMP_WRITE_BACK_INVALIDATE_ELEMENT(x) xthal_dcache_region_writeback_inv((void *)x, sizeof(*x)) +#define XMP_WRITE_BACK_ARRAY(x) xthal_dcache_region_writeback((void *)x, sizeof(x)) +#define XMP_INVALIDATE_ARRAY(x) xthal_dcache_region_invalidate((void *)x, sizeof(x)) +#define XMP_WRITE_BACK_INVALIDATE_ARRAY(x) xthal_dcache_region_writeback_inv((void *)x, sizeof(x)) +#define XMP_WRITE_BACK_ARRAY_ELEMENTS(x, num_elements) xthal_dcache_region_writeback((void *)x, sizeof(*x) * num_elements) +#define XMP_INVALIDATE_ARRAY_ELEMENTS(x, num_elements) xthal_dcache_region_invalidate((void *)x, sizeof(*x) * num_elements) +#define XMP_WRITE_BACK_INVALIDATE_ARRAY_ELEMENTS(x, num_elements) xthal_dcache_region_writeback_inv((void *)x, sizeof(*x) * num_elements) +#else +#define XMP_WRITE_BACK_ELEMENT(x) +#define XMP_INVALIDATE_ELEMENT(x) +#define XMP_WRITE_BACK_INVALIDATE_ELEMENT(x) +#define XMP_WRITE_BACK_ARRAY(x) +#define XMP_INVALIDATE_ARRAY(x) +#define XMP_WRITE_BACK_INVALIDATE_ARRAY(x) +#define XMP_WRITE_BACK_ARRAY_ELEMENTS(x, num_elements) +#define XMP_INVALIDATE_ARRAY_ELEMENTS(x, num_elements) +#define XMP_WRITE_BACK_INVALIDATE_ARRAY_ELEMENTS(x, num_elements) +#endif + +/* ------------------------------------------------------------------------- + Initialization, error codes, constants and house-keeping + + Every core should call xmp_init with the number of cores in the + system. + + xmp_init should be called before you use any global synchronization + primitive or shared data. + + Further, before you use a dynamically allocated synchronization + primitives, you need to both initialize it by calling the + xmp_*_init function, and you need to have called xmp_init, which + sets up interrupt handlers and interrupt routing. + + The second parameter sets the interprocessor interrupt + routing. Passing zero instructs the library to use the default + routing, which will be suitable for most users. + +*/ + +extern void xmp_init (int num_cores, unsigned int interrupt_routing); + + +/* If you want finer-grained control than that provided by xmp_init, + you can the functions below individually--however, this is more + inconvenient and requires greater understanding of the library's + internals. Don't use them directly unless you have a good reason. +*/ + +extern void xmp_unpack_shared (void); +extern void xmp_route_interrupts (unsigned int routing); + +#if XCHAL_HAVE_MP_INTERRUPTS +extern void xmp_enable_ipi_interrupts (void); + +/* Turn off certain things enabled by xmp_init */ +extern void xmp_disable_ipi_interrupts (void); +#endif + +extern void xmp_end (void); + +/* Only valid after xmp_init. */ +extern int xmp_num_cores (void); + +/* How many cycles should a core wait before rechecking a + synchronization variable? Higher values will reduce memory + transactions, but will also result in higher latency in returning + from synchronization. +*/ +extern void xmp_spin_wait_set_cycles (unsigned int limit); + +/* If you would prefer to provide your own spin wait function, + to go to sleep, etc. Declare a function of this type, then call + this function. */ +typedef void (*xmp_spin_wait_function_t)(void); +extern void xmp_spin_wait_set_function (xmp_spin_wait_function_t func); +extern void xmp_spin(void); + +#define XMP_NO_OWNER 0x07 +#define XMP_MUTEX_DESTROYED 0xFE +#define XMP_ERROR_FATAL 0xFD + +#define XMP_MAX_CORES 0x4 + + +static inline unsigned int xmp_prid (void) +{ +#if XCHAL_HAVE_PRID + return XT_RSR_PRID() & 0xFF; +#else + return 0; +#endif +} + + +/* ------------------------------------------------------------------------- + Tracing + + A core must set a trace_file if it wants any synchronization + tracing to occur. Sharing file descriptors among cores is very + messy, so don't do it. This, unfortunately, means that two cores + contending for a mutex are not able to trace to the same file. + + Any object (except the atomic integer) can have tracing off or on. +*/ + +extern void xmp_set_trace_file (FILE * file); +extern void xmp_trace (const char * fmt, ...); + + +/* ------------------------------------------------------------------------- + Memory Allocation Functions. + + These do what you would expect, only from shared memory instead of + private memory. +*/ + +#if XCHAL_DCACHE_IS_COHERENT +extern void * xmp_malloc (size_t size); +extern void * xmp_calloc (size_t nmemb, size_t size); +extern void xmp_free (void * ptr); +#endif +extern void * xmp_sbrk(int size); + +/* ------------------------------------------------------------------------- + xmp_atomic_int_t + + The most basic synchronization primitive in the xmp library. + Atomic ints are sharable among processors, and even interrupt + levels on the same processor. However, their semantics are fairly + rudimentary. All other primitives are based on these, therefore, + changing this implementation affects all other primitives. + +*/ + +typedef unsigned int xmp_atomic_int_t; + +static inline xmp_atomic_int_t +xmp_coherent_l32ai(xmp_atomic_int_t * address) +{ + XMP_INVALIDATE_ELEMENT (address); + return XT_L32AI(address, 0); +} + +static inline void +xmp_coherent_s32ri(xmp_atomic_int_t value, xmp_atomic_int_t * address) +{ + XT_S32RI (value, address, 0); + XMP_WRITE_BACK_ELEMENT (address); +} + +#define XMP_ATOMIC_INT_INITIALIZER(value) (value) + +/* xmp_atomic_int_init - Initialize an int prior to use + + Nonsynchronizing, Nonblocking + + Usage: + value - initial value + integer - points to an uninitialized integer + + On exit: + initialized to given value + + Errors: none +*/ + +static inline void +xmp_atomic_int_init (xmp_atomic_int_t * integer, int value) +{ + xmp_coherent_s32ri (value, integer); +} + + +/* xmp_atomic_int_value - Read the value + + Nonsynchronizing, Nonblocking + + Usage: + integer - points to an int + + Returns: + the value +*/ + +static inline int +xmp_atomic_int_value (xmp_atomic_int_t * integer) +{ + return xmp_coherent_l32ai (integer); +} + + +/* xmp_atomic_int_conditional_increment - Conditionally increment integer + + Synchronizing, nonblocking + + Usage: + integer - points to an initialized integer + amount - how much to increment + prev - believed value of the integer + eg: prev = xmp_atomic_int_value (integer); + success = xmp_atomic_int_increment (integer, 1, prev); + + Returns: current value of integer - user should check if it matches + the previous value of the integer. If it does, then the update + was successful. + +*/ + +#define USE_ASSEMBLY_IMPLEMENTATION 0 + +static inline int +xmp_atomic_int_conditional_increment (xmp_atomic_int_t * integer, int amount, int prev) +{ + int val; + int saved; + +#if USE_ASSEMBLY_IMPLEMENTATION + /* %0 = prev + %1 = saved + %2 = atomic integer pointer + %3 = amount + */ + + asm volatile ("wsr.scompare1 %0\n" + "mov %1, %0\n" + "add %0, %0, %3\n" + "s32c1i %0, %2, 0\n" + : "+&a" (prev), "+&a"(saved) : "a" (integer), "a" (amount)); + + return prev; + +#else + + XT_WSR_SCOMPARE1 (prev); + val = prev + amount; + saved = val; + XT_S32C1I (val, integer, 0); + + return val; +#endif +} + + +/* xmp_atomic_int_increment - Increment integer + + Synchronizing, blocking + + Usage: + integer - points to an initialized integer + amount - how much to increment + + Returns: new value of integer + +*/ + +static inline int +xmp_atomic_int_increment (xmp_atomic_int_t * integer, int amount) +{ + int val; + int saved; +#if USE_ASSEMBLY_IMPLEMENTATION + /* %0 = val + %1 = saved + %2 = atomic integer pointer + %3 = amount + */ + + asm volatile ("l32ai %0, %2, 0\n" + "1:\n" + "wsr.scompare1 %0\n" + "mov %1, %0\n" + "add %0, %0, %3\n" + "s32c1i %0, %2, 0\n" + "bne %0, %1, 1b\n" + : "+&a" (val), "+&a"(saved) : "a" (integer), "a" (amount)); +#else + /* Accurately naming "val" is tricky. Sometimes it will be what we + want to be the new value, but sometimes it contains the value + that is currently at the location. */ + + /* Load location's current value */ + val = xmp_coherent_l32ai (integer); + + do { + XT_WSR_SCOMPARE1 (val); + saved = val; + /* Change it to what we would like to store there--"new_val" */ + val = val + amount; + /* Possibly store new_val, but reload location's current value no + matter what. */ + XT_S32C1I (val, integer, 0); + if (val != saved) + xmp_spin(); + } while (val != saved); + +#endif + return val + amount; +} + + +/* xmp_atomic_int_conditional_set - Set the value of an atomic integer + + Synchronizing, nonblocking + + Usage: + integer - points to an initialized integer + from - believed value of the integer + eg: prev = xmp_atomic_int_value (integer); + success = xmp_atomic_int_conditional_set (integer, 1, prev); + to - new value + + Returns: current value of integer - user should check if it matches + the previous value of the integer. If it does, then the update + was successful. + +*/ + +static inline int +xmp_atomic_int_conditional_set (xmp_atomic_int_t * integer, int from, int to) +{ + int val; + + /* Don't even try to update if the integer's value isn't what we + think it should be. This prevents acquiring this cache-line for + writing and therefore prevents bus transactions when various + cores contend. */ + val = xmp_coherent_l32ai(integer); + if (val == from) { + XT_WSR_SCOMPARE1 (from); + val = to; + /* Possibly store to, but reload location's current value no + matter what. */ + XT_S32C1I (val, integer, 0); + } + return val; +} + + +/* Macros to implement trivial spin locks. These are very primitive, but + can be useful when you don't need the higher-overhead synchronization. + + To use an xmp_atomic_int_t as a trivial spin lock, you should + initialize it to zero first. +*/ + +#define XMP_SIMPLE_SPINLOCK_ACQUIRE(atomic_int_ptr) \ + { while (xmp_atomic_int_conditional_set (atomic_int_ptr, 0, xmp_prid() + 1) != 0) \ + xmp_spin(); } +#define XMP_SIMPLE_SPINLOCK_RELEASE(atomic_int_ptr) \ + { while (xmp_atomic_int_conditional_set (atomic_int_ptr, xmp_prid() + 1, 0) != xmp_prid() + 1) \ + xmp_spin(); } + +#define XMP_SIMPLE_SPINLOCK_OWNER(atomic_int_ptr) (xmp_atomic_int_value(atomic_int_ptr) - 1) + + +/* ------------------------------------------------------------------------- + xmp_mutex_t - An even higher-level data structure to enforce + mutual exclusion between cores. A core which waits on a mutex might + sleep with a waiti and be interrupted by an interrupt. + + Mutexes can be normal or recursive. For a normal mutex, a core + attempting to acquire a mutex it already holds will result in + deadlock. For a recursive mutex, a core will succeed in acquiring a + mutex it already holds, and must release it as many times as it + acquired it. + + Mutexes are not sharable between interrupt levels--because + ownership is tracked by core, not thread. + + Like all xmp data structures, an object of type xmp_mutex_t + should be treated by the programmer as opaque. They are only + public in this header file to allow them to be declared statically. + + For configurations with 16-byte cache lines, this has the most + frequently used and changed data in the first line. + +*/ + +#if XCHAL_DCACHE_IS_COHERENT +typedef struct xmp_mutex_t { + xmp_atomic_int_t qlock; + unsigned int qhead; + unsigned int qtail; + unsigned char queue[XMP_MAX_CORES]; + unsigned short held; + + unsigned char owner; + unsigned char recursive : 1; + unsigned char trace : 1; + unsigned char system : 1; + unsigned char unused : 5; + const char * name; +} xmp_mutex_t __attribute__ ((aligned (XMP_MAX_DCACHE_LINESIZE))); + + +#define XMP_MUTEX_INITIALIZER(name) \ + { 0, 0, -1, {XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER}, \ + 0, XMP_NO_OWNER, XMP_MUTEX_FLAG_NORMAL, 0, 0, 0, name } + +#define XMP_RECURSIVE_MUTEX_INITIALIZER(name) \ + { 0, 0, -1, {XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER}, \ + 0, XMP_NO_OWNER, XMP_MUTEX_FLAG_RECURSIVE, 0, 0, 0, name } + +#define XMP_MUTEX_FLAG_NORMAL 0 +#define XMP_MUTEX_FLAG_RECURSIVE 1 + +#define XMP_MUTEX_ACQUIRE_FAILED -1 +#define XMP_MUTEX_ERROR_DESTROY_OWNED -2 +#define XMP_MUTEX_ERROR_NOT_OWNED -3 +#define XMP_MUTEX_ERROR_ALREADY_OWNED -4 + +/* + xmp_mutex_init + + Nonsynchronizing + Nonblocking + + Usage: + mutex - points to an uninitialized mutex + name - name if you want one, NULL if not. + recursive - use recursive semantices + + Returns + zero on success (always succeeds) + +*/ + +extern int xmp_mutex_init (xmp_mutex_t * mutex, + const char * name, + unsigned int recursive); + +/* + int xmp_mutex_destroy (xmp_mutex_t * mutex); + + Synchronizing - will fail if mutex is held by anyone -- including + current processor + Nonblocking + + Usage: + mutex - points to a mutex + + Returns + zero on success + non-zero if mutex is held +*/ + +extern int xmp_mutex_destroy (xmp_mutex_t * mutex); + + +/* + xmp_mutex_lock -- Synchronizing + xmp_mutex_trylock + + Usage: + mutex - points to a mutex + + Returns + zero on success +*/ + +extern int xmp_mutex_lock (xmp_mutex_t * mutex); +extern int xmp_mutex_trylock (xmp_mutex_t * mutex); + + +/* + xmp_mutex_unlock + + Synchronizing + Nonblocking + + Usage: + mutex - points to a mutex + + Returns + zero on success - mutex is released + non-zero on failure - mutex is owned by another core + - prid of processor that does own it + note that by the time this function + returns, the owner of the core may + have changed. +*/ + +extern int xmp_mutex_unlock (xmp_mutex_t * mutex); + + +/* + xmp_mutex_name + + Nonsynchronizing + Nonblocking + + Usage: + mutex - points to a mutex + + Returns the name of the given mutex, which may be NULL. + +*/ + +const char * xmp_mutex_name (const xmp_mutex_t * mutex); + + +/* + xmp_mutex_trace_on + xmp_mutex_trace_off + + Nonsynchronizing + Nonblocking + + Turn off and on tracing for the mutex. + + These functions are only present in the debug version of the library. +*/ + +extern void xmp_mutex_trace_on (xmp_mutex_t * mutex); +extern void xmp_mutex_trace_off (xmp_mutex_t * mutex); + + +/* ------------------------------------------------------------------------- + xmp_condition_t + + Condition Variables following Mesa semantics. + + Condition variables are not sharable among interrupt levels. + +*/ + + +typedef struct xmp_condition_t { + unsigned int qhead; + unsigned int qtail; + unsigned char queue[XMP_MAX_CORES]; + unsigned int waiting[XMP_MAX_CORES]; + + unsigned char trace : 1; + unsigned char unused : 7; + const char * name; +} xmp_condition_t __attribute__ ((aligned (XMP_MAX_DCACHE_LINESIZE))); + + +#define XMP_CONDITION_INITIALIZER(name) \ + { 0, -1, {XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER, XMP_NO_OWNER}, \ + {0, 0, 0, 0}, 0, 0, name} + + +/* xmp_condition_init - Initialize a condition variable + + Nonsynchronizing, Nonblocking + + Usage: + condition - pointer to an xmp_condition_t + + On exit: + condition initialized + + Errors: none +*/ + +extern int xmp_condition_init (xmp_condition_t * condition, + const char * name); +extern int xmp_condition_destroy (xmp_condition_t * condition); + + +/* xmp_condition_wait - Wait for a condition variable + + Synchronizing, blocking + + Usage: + condition - pointer to an xmp_condition_t + mutex - pointer to an xmp_mutex_t already acquired by the calling + process + + Errors: if the mutex isn't held by this core +*/ + +extern int xmp_condition_wait (xmp_condition_t * condition, + xmp_mutex_t * mutex); + +/* xmp_condition_signal + + - Signal the first (if any) core waiting on a condition variable + + You must hold the mutex you passed to xmp_condition_wait before + calling this function. + + Synchronizing, nonblocking + + Usage: + condition - pointer to an xmp_condition_t + + Errors: none +*/ + +extern int xmp_condition_signal (xmp_condition_t * condition); + + +/* xmp_condition_broadcast + + - Signal all cores waiting on a condition variable + + Synchronizing, nonblocking + + You must hold the mutex you passed to xmp_condition_wait before + calling this function. + + Usage: + condition - pointer to an xmp_condition_t + + Errors: none +*/ + +extern int xmp_condition_broadcast (xmp_condition_t * condition); + + +static inline const char * xmp_condition_name (const xmp_condition_t * condition) +{ + return condition->name; +} + +/* + xmp_condition_trace_on + xmp_condition_trace_off + + Nonsynchronizing + Nonblocking + + Turn off and on statistics and tracing for the condition. For + tracing you must also set a trace file for the core. + + These functions are only present in the debug-version of the library. +*/ + +extern void xmp_condition_trace_on (xmp_condition_t * condition); +extern void xmp_condition_trace_off (xmp_condition_t * condition); + +#endif /* XCHAL_DCACHE_IS_COHERENT */ + +/* ------------------------------------------------------------------------- + xmp_barrier_t + + Classic barriers that stop any core from continuing until a + specified number of cores reach that point. Once the barrier allows + cores through, the barrier is reset and will stop cores from + progressing again. + + Barriers are not sharable among interrupt levels. + +*/ + + +typedef struct xmp_barrier_t +{ + xmp_atomic_int_t count; + xmp_atomic_int_t state; + xmp_atomic_int_t sleeping; + unsigned short num_cores; + unsigned short trace : 1; + unsigned short system : 1; + const char * name; +} xmp_barrier_t __attribute__ ((aligned (XMP_MAX_DCACHE_LINESIZE))); + +#define XMP_BARRIER_INITIALIZER(number, name) \ + { 0, 0, 0, number, 0, 0, name } + + +/* xmp_barrier_init - Initialize a barrier + + Nonsynchronizing, Nonblocking + + Usage: + barrier - pointer to an xmp_barrier_t + num_cores - number of cores needed to arrive at the + barrier before any are allowed through + On exit: + barrier initialized + + Always returns zero. + + Errors: none +*/ + +extern int xmp_barrier_init (xmp_barrier_t * barrier, int num_cores, + const char * name); + + +/* xmp_barrier_wait - Wait on a barrier + + Nonsynchronizing, Nonblocking + + Usage: + barrier - pointer to an xmp_barrier_t + On exit: + Enough cores (as determined at the barrier's initialization) + have reached the barrier. + + Errors: none +*/ + +extern int xmp_barrier_wait (xmp_barrier_t * barrier); + + +static inline const char * xmp_barrier_name (const xmp_barrier_t * barrier) +{ + return barrier->name; +} + + +/* + xmp_barrier_trace_on + xmp_barrier_trace_off + + Nonsynchronizing + Nonblocking + + Turn on and off tracing for the barrier. For + tracing you must also set a trace file for the core. + + These functions are only present in the debug-version of the library. +*/ + +extern void xmp_barrier_trace_on (xmp_barrier_t * barrier); +extern void xmp_barrier_trace_off (xmp_barrier_t * barrier); + + +/* ------------------------------------------------------------------------- + Portions of the library that are internal, but belong here for + convenience. +*/ + +extern xmp_atomic_int_t _ResetSync; + +static inline void +xmp_initial_sync (int num_cores) +{ + xmp_atomic_int_increment (&_ResetSync, 1); + while (xmp_coherent_l32ai (&_ResetSync) != num_cores) + xmp_spin (); +} + +#ifdef __cplusplus +} +#endif + +#endif /* _XMP_LIBRARY_H */ diff --git a/components/esp32/include/xtensa/xos.h b/components/esp32/include/xtensa/xos.h new file mode 100755 index 000000000..883a9c975 --- /dev/null +++ b/components/esp32/include/xtensa/xos.h @@ -0,0 +1,524 @@ +/** @file */ + +// xos.h - XOS API interface and data structures visible to user code. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef __XOS_H__ +#define __XOS_H__ + +#ifdef __cplusplus +extern "C" { +#endif + + +#include "xos_types.h" + +#include +#if XCHAL_HAVE_INTERRUPTS +#include +#include +#endif + +#include "xos_common.h" +#include "xos_errors.h" +#include "xos_regaccess.h" + + +//----------------------------------------------------------------------------- +// Convert x into a literal string. +//----------------------------------------------------------------------------- +#define _XOS_STR(x) __XOS_STR(x) +#define __XOS_STR(x) #x + + +//----------------------------------------------------------------------------- +// XOS version. +//----------------------------------------------------------------------------- +#define XOS_VERSION_MAJOR 1 +#define XOS_VERSION_MINOR 10 +#define XOS_VERSION_STRING "1.10" ///< XOS version string. + + +//----------------------------------------------------------------------------- +// Runtime error handling. +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +/// +/// Reports a fatal error and halts XOS operation, i.e. halts the system. This +/// function will call a user-registered error handler (if one has been set) +/// and then halt the system. The user handler may do system-specific things +/// such as record the error reason in nonvolatile memory etc. +/// +/// \param errcode Error code. May be any user defined value < 0. +/// Values >=0 are reserved for use by the system. +/// +/// \param errmsg Optional text string describing the error. +/// +/// \return This function does not return. +/// +//----------------------------------------------------------------------------- +void +xos_fatal_error(int32_t errcode, const char * errmsg); + + +#if XOS_DEBUG + +// Do not call directly. +void +xos_assert(const char * file, int32_t line); + +//----------------------------------------------------------------------------- +/// +/// Check condition and fail if condition expression is false. +/// In debug builds, an assertion failure will cause a fatal error to be +/// reported. In non-debug builds, assertions are compiled out. +/// +/// NOTE: Remember that any code in XOS_ASSERT() statements gets compiled out +/// for non-debug builds. +/// +//----------------------------------------------------------------------------- + +#define XOS_ASSERT(expr) if ((expr) == 0) xos_assert(__FILE__, __LINE__) + +#else + +#define XOS_ASSERT(expr) + +#endif + + +//----------------------------------------------------------------------------- +/// +/// Interrupt handler function pointer type. +/// +//----------------------------------------------------------------------------- +typedef void (XosIntFunc)(void * arg); + +//----------------------------------------------------------------------------- +/// +/// Print handler function pointer type. +/// +//----------------------------------------------------------------------------- +typedef int32_t (XosPrintFunc)(void * arg, const char * fmt, ...); + +//----------------------------------------------------------------------------- +/// +/// Fatal error handler function pointer type. +/// +//----------------------------------------------------------------------------- +typedef void (XosFatalErrFunc)(int32_t errcode, const char * errmsg); + +//----------------------------------------------------------------------------- +/// +/// Exception handler function pointer type. +/// +//----------------------------------------------------------------------------- +typedef void (XosExcHandlerFunc)(XosExcFrame * frame); + + +//----------------------------------------------------------------------------- +/// +/// Install a user defined exception handler for the specified exception type. +/// This will override the default XOS exception handler. The handler is a C +/// function that is passed one parameter -- a pointer to the exception frame. +/// The exception frame is allocated on the stack of the thread that caused the +/// exception, and contains saved state and exception information. For details +/// of the exception frame see the structure XosExcFrame. +/// +/// \param exc Exception type (number) to override. The exception +/// numbers are enumerated in . +/// +/// \param handler Pointer to handler function to be installed. +/// To revert to the default handler, pass NULL. +/// +/// \return Returns a pointer to previous handler installed, if any. +/// +//----------------------------------------------------------------------------- +XosExcHandlerFunc * +xos_register_exception_handler(int32_t exc, XosExcHandlerFunc * handler); + + +//----------------------------------------------------------------------------- +/// +/// Install a user defined fatal error handler. This function will be called if +/// a fatal error is reported either by user code or by XOS itself. It will be +/// passed the same arguments that are passed to xos_fatal_error(). +/// +/// The handler need not return. It should make minimal assumptions about the +/// state of the system. In particular, it should not assume that further XOS +/// system calls will succeed. +/// +/// \param handler Pointer to handler function to be installed. +/// +/// \return Returns a pointer to previous handler installed, if any. +/// +//----------------------------------------------------------------------------- +XosFatalErrFunc * +xos_register_fatal_error_handler(XosFatalErrFunc * handler); + + +#ifdef _XOS_INCLUDE_INTERNAL_ +# include "xos_internal.h" +#endif + + +#include "xos_thread.h" +#include "xos_timer.h" +#include "xos_cond.h" +#include "xos_event.h" +#include "xos_mutex.h" +#include "xos_msgq.h" +#include "xos_semaphore.h" +#include "xos_stopwatch.h" + + +//----------------------------------------------------------------------------- +/// +/// Register a handler function to call when interrupt "num" occurs. +/// +/// For level-triggered and timer interrupts, the handler function will have +/// to clear the source of the interrupt before returning, to avoid infinitely +/// retaking the interrupt. Edge-triggered and software interrupts are +/// automatically cleared by the OS interrupt dispatcher (see xos_handlers.S). +/// +/// \param num Xtensa internal interrupt number (0..31). To +/// refer to a specific external interrupt number +/// (BInterrupt pin), use HAL macro XCHAL_EXTINTx_NUM +/// where 'x' is the external number. +/// +/// \param handler Pointer to handler function. +/// +/// \param arg Argument passed to handler. +/// +/// \return Returns XOS_OK if successful, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_register_interrupt_handler(int32_t num, XosIntFunc * handler, void * arg); + + +//----------------------------------------------------------------------------- +/// +/// Unregister a handler function for interrupt "num". If no handler was +/// installed, this function will have no effect. +/// +/// \param num Xtensa internal interrupt number (0..31). To +/// refer to a specific external interrupt number +/// (BInterrupt pin), use HAL macro XCHAL_EXTINTx_NUM +/// where 'x' is the external number. +/// +/// \return Returns XOS_OK if successful, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_unregister_interrupt_handler(int32_t num); + + +//----------------------------------------------------------------------------- +/// +/// Register a high priority interrupt handler for interrupt level "level". +/// +/// Unlike low and medium priority interrupt handlers, high priority handlers +/// are not installed for a specific interrupt number, but for an interrupt +/// level. The level must be above XCHAL_EXCM_LEVEL. The handler function must +/// be written in assembly since C handlers are not supported for levels above +/// XCHAL_EXCM_LEVEL. The handler function must preserve all registers except +/// a0, and must return to the dispatcher via a "ret" instruction, not "rfi". +/// +/// NOTE: This method of dispatch takes a few cycles of overhead. If you wish +/// to save even these cycles, then you can define your own dispatch function +/// to override the built-in dispatcher. See xos_handlers.S for more details. +/// +/// \param level The interrupt level to be handled. +/// +/// \param handler Pointer to handler function. +/// +/// \return Returns XOS_OK if successful, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_register_hp_interrupt_handler(int32_t level, void * handler); + + +//----------------------------------------------------------------------------- +/// +/// Enable a specific interrupt, by interrupt number. +/// The state (enabled vs. disabled) of individual interrupts is global, i.e. +/// not associated with any specific thread. Depending on system options and +/// implementation, this state may be stored in one of two ways: +/// - directly in the INTENABLE register, or +/// - in a global variable (this is generally the case when INTENABLE is used +/// not just to control what interrupts are enabled globally, but also for +/// software interrupt prioritization within an interrupt level, effectively +/// providing finer grained levels; in this case XOS takes care to update +/// INTENABLE whenever either the global enabled-state variable or the +/// per-thread fine-grained-level variable change). +/// Thus it is best to never access the INTENABLE register directly. +/// +/// To modify thread-specific interrupt priority level, use one of: +/// - xos_set_int_pri_level() +/// - xos_restore_int_pri_level() +/// - xos_disable_interrupts() +/// - xos_restore_interrupts() +/// +/// NOTE: To refer to a specific external interrupt number (BInterrupt pin), +/// use HAL macro XCHAL_EXTINTx_NUM where 'x' is the external interrupt +/// number. For example, to enable external interrupt 3 (BInterrupt[3]), +/// you can use: +/// +/// xos_interrupt_enable( XCHAL_EXTINT3_NUM ); +/// +/// \param intnum Interrupt number to enable. Must range between 0-31. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_interrupt_enable(uint32_t intnum); + + +//----------------------------------------------------------------------------- +/// +/// Disable a specific individual interrupt, by interrupt number. +/// +/// This is the counterpart to xos_interrupt_enable(). See the description +/// of xos_interrupt_enable() for further comments and notes. +/// +/// \param intnum Interrupt number to disable. Must range between 0-31. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_interrupt_disable(uint32_t intnum); + + +//----------------------------------------------------------------------------- +/// +/// Get the CPU's current interrupt priority level. Interrupts at or below this +/// priority level are blocked. +/// +/// \return Returns the current IPL, ranging from 0 to XCHAL_NUM_INTLEVELS. +/// +//----------------------------------------------------------------------------- +static inline uint32_t +xos_get_int_pri_level(void) +{ +#if XCHAL_HAVE_INTERRUPTS + return XT_RSR_PS() & 0xF; +#else + return 0; +#endif +} + + +//----------------------------------------------------------------------------- +/// +/// Set the CPU's interrupt priority level to the specified level, but only if +/// the current IPL is below the one requested. This function will never cause +/// the interrupt priority level to be lowered from the current level. +/// Call this function to block interrupts at or below the specified priority +/// level. +/// +/// When setting the IPL temporarily (such as in a critical section), call +/// xos_set_int_pri_level(), execute the critical code section, and then call +/// xos_restore_int_pri_level(). +/// +/// The interrupt priority level is part of the thread context, so it is saved +/// and restored across context switches. To enable and disable individual +/// interrupts globally, use the functions xos_interrupt_enable() and +/// xos_interrupt_disable() instead. +/// +/// NOTE: It is usually not required to disable interrupts at a level higher +/// than that of the highest priority interrupt that interacts with the OS +/// (i.e. calls into XOS such that threads may be woken / blocked / +/// reprioritized / switched, or otherwise access XOS data structures). +/// In XOS, that maximum level is XOS_MAX_OS_INTLEVEL, which defaults to +/// XCHAL_EXCM_LEVEL. This may be modified by editing xos_params.h and +/// rebuilding XOS. +/// +/// \param level The new interrupt priority level (IPL). +/// +/// \return Returns a value that can be used to restore the previous +/// priority level by calling xos_restore_int_pri_level(). This +/// value should be treated as opaque by application code, and +/// should be passed unchanged to the restore function. +/// +//----------------------------------------------------------------------------- +__attribute__((always_inline)) +static inline uint32_t +xos_set_int_pri_level(uint32_t level) +{ +#if XCHAL_HAVE_INTERRUPTS +#pragma no_reorder + uint32_t ps = XT_RSR_PS(); + + if (level > (ps & 0xF)) { + level = (ps & ~0xF) | level; + XT_WSR_PS(level); + XT_RSYNC(); + } + + return ps; +#else + return 0; +#endif +} + + +//----------------------------------------------------------------------------- +/// +/// Restores the CPU to a previously saved interrupt priority level. This level +/// must have been obtained by calling xos_set_int_pri_level(). +/// +/// \param oldval Return value from xos_set_int_pri_level(). +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +__attribute__((always_inline)) +static inline void +xos_restore_int_pri_level(const uint32_t oldval) +{ +#if XCHAL_HAVE_INTERRUPTS +#pragma no_reorder + XT_WSR_PS(oldval); + XT_RSYNC(); +#else + // Nothing +#endif +} + + +//----------------------------------------------------------------------------- +/// +/// Disable all interrupts that can interact directly with the OS. This is a +/// convenience function, shorthand for setting the IPL to XOS_MAX_OS_INTLEVEL. +/// +/// Returns: A value that can be used to restore the previous priority level +/// by calling xos_restore_interrupts(). This value should be treated as +/// opaque by application code, and should be passed unchanged to the restore +/// function. +/// +//----------------------------------------------------------------------------- +static inline uint32_t +xos_disable_interrupts(void) +{ + return xos_set_int_pri_level(XOS_MAX_OS_INTLEVEL); +} + + +//----------------------------------------------------------------------------- +/// +/// Restore the CPU's previously saved interrupt status. This is a convenience +/// function, the counterpart to xos_disable_interrupts(). +/// +/// \return rval Return value from xos_disable_interrupts(). +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_restore_interrupts(uint32_t rval) +{ + xos_restore_int_pri_level(rval); +} + + +#ifdef _XOS_INCLUDE_INTERNAL_ + +//----------------------------------------------------------------------------- +// Enter an OS critical section, i.e. get exclusive access to OS critical +// state and data structures. Code that manipulates the state of OS objects +// or modifies internal OS state must call this function first, to ensure +// that it has exclusive access. On a single-core system, this is equivalent +// to blocking all interrupts that can interact directly with the OS, i.e. +// all interrupts at or below XOS_MAX_OS_INTLEVEL. In a multi-core system +// this is likely to be implemented differently to achieve the same effect. +// +// Returns: A value that is to be used to restore the state of the CPU when +// exiting the critical section. This must be treated as opaque and passed +// unmodified to xos_critical_exit(). +// +// NOTE: This function is meant for use in OS code, not in applications. +//----------------------------------------------------------------------------- +__attribute__((always_inline)) +static inline uint32_t +xos_critical_enter(void) +{ +#if XCHAL_HAVE_INTERRUPTS + // This function cannot be called by high-level interrupt handlers, + // i.e. it can never be called with intlevel > XOS_MAX_OS_INTLEVEL. + // So, we do not need to check current intlevel because we will not + // ever be lowering it by setting it to XOS_MAX_OS_INTLEVEL. + // NOTE: sync after RSIL not needed. + return XT_RSIL(XOS_MAX_OS_INTLEVEL); +#else + return 0; +#endif +} + + +//----------------------------------------------------------------------------- +// Exit an OS critical section and restore CPU state. See the documentation +// for xos_critical_enter(). +// +// cflags Return value from xos_critical_enter(). +// Must be treated as an opaque value. +// +// Returns: Nothing. +// +// NOTE: This function is meant for use in OS code, not in applications. +//----------------------------------------------------------------------------- +__attribute__((always_inline)) +static inline void +xos_critical_exit(uint32_t cflags) +{ + xos_restore_int_pri_level(cflags); +} + +#endif // _XOS_INCLUDE_INTERNAL_ + + +// This file uses things defined above +#include "xos_syslog.h" + + +// Misc + +//----------------------------------------------------------------------------- +// Helper function to list all threads in system. Useful for debug. +//----------------------------------------------------------------------------- +void +xos_display_threads(void * arg, XosPrintFunc * print_fn); + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_H__ + diff --git a/components/esp32/include/xtensa/xos_common.h b/components/esp32/include/xtensa/xos_common.h new file mode 100755 index 000000000..647cb7f45 --- /dev/null +++ b/components/esp32/include/xtensa/xos_common.h @@ -0,0 +1,362 @@ + +// xos_common.h - Macros and definitions common to C and assembly code. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef __XOS_COMMON_H__ +#define __XOS_COMMON_H__ + +#ifdef __cplusplus +extern "C" { +#endif + + +#include +#include +#include + +#include "xos_params.h" + + +//----------------------------------------------------------------------------- +// Macros that help define structures for both C and assembler. +// These are somewhat different from the XTOS version in xtruntime-frames.h. +//----------------------------------------------------------------------------- +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) + +#define STRUCT_BEGIN .pushsection .text; .struct 0 +#define STRUCT_FIELD(ctype,size,asname,name) asname: .space size +#define STRUCT_AFIELD(ctype,size,asname,name,n) asname: .space (size)*(n) +#define STRUCT_END(sname) sname##Size:; .popsection + +#else + +#define STRUCT_BEGIN typedef struct { +#define STRUCT_FIELD(ctype,size,asname,name) ctype name; +#define STRUCT_AFIELD(ctype,size,asname,name,n) ctype name[n]; +#define STRUCT_END(sname) } sname; + +#endif //_ASMLANGUAGE || __ASSEMBLER__ + + +//----------------------------------------------------------------------------- +// Offsets relative to xos_globals. +//----------------------------------------------------------------------------- +#define XOS_INTLEVEL_MASK 0 // offset to the level mask +#define XOS_INTENABLE_MASK 4 // offset to the enable mask +#define XOS_CURR_THREADPTR 8 // offset to the current thread ptr +#define XOS_NEXT_THREADPTR 12 // offset to the next thread ptr +#define XOS_INTERRUPT_TABLE 16 // offset to the interrupt table + + +//----------------------------------------------------------------------------- +// Offsets for xos_interrupt_table[] entries. +//----------------------------------------------------------------------------- +#define XOS_INTTAB_HANDLER (XOS_INTERRUPT_TABLE+0) // ofs to interrupt handler +#define XOS_INTTAB_ARG (XOS_INTERRUPT_TABLE+4) // ofs to interrupt handler arg +#define XOS_INTTAB_PS (XOS_INTERRUPT_TABLE+8) // (hwpri) PS for interrupt level +#define XOS_INTTAB_LEVEL (XOS_INTERRUPT_TABLE+8) // (swpri) interrupt level (1..7) +#define XOS_INTTAB_PRI (XOS_INTERRUPT_TABLE+9) // (swpri) interrupt priority (0..255) +#define XOS_INTTAB_PRIMASK (XOS_INTERRUPT_TABLE+12) // (swpri) mask of higher pri. interrupts + + +//----------------------------------------------------------------------------- +// Exception/interrupt stack frame layout for a pre-empted thread +// tcb->resume_fn == &xos_resume_preempted_thread). +// Pointed to by thread->esf. Located just below thread's current stack ptr. +// Thread's a1 == thread->esf + XosExcFrameSize. +// NOTE: exception frame size is a multiple of 16. +//----------------------------------------------------------------------------- +STRUCT_BEGIN +STRUCT_AFIELD(long,4,FRAME_AREG,areg, 12) // a4-a15 (offsets 0 thru 44) + // (a1 is computed, a0,a2-a3 are in s32e range of a1) +//#if XCHAL_HAVE_LOOPS +STRUCT_FIELD (long,4,FRAME_LBEG,lbeg) +STRUCT_FIELD (long,4,FRAME_LEND,lend) +STRUCT_FIELD (long,4,FRAME_LCOUNT,lcount) +//#endif +//#if XCHAL_HAVE_MAC16 +STRUCT_FIELD (long,4,FRAME_ACCLO,acclo) +STRUCT_FIELD (char,1,FRAME_ACCHI,acchi) +//#endif +STRUCT_FIELD (char,1,FRAME_SAR,sar) +STRUCT_FIELD (short,2,FRAME_PAD0,pad0) // unused +STRUCT_FIELD (long,4,FRAME_EXCCAUSE,exccause) +STRUCT_FIELD (long,4,FRAME_EXCVADDR,excvaddr) +STRUCT_FIELD (long,4,FRAME_PAD1,pad1) // unused -- pad to make multiple of 16 bytes +STRUCT_FIELD (long,4,FRAME_PAD2,pad2) +STRUCT_FIELD (long,4,FRAME_PS,ps) // (XOS_FRAME_SIZE-44) in S32E range of end +STRUCT_FIELD (long,4,FRAME_PC,pc) // (XOS_FRAME_SIZE-40) in S32E range of end +STRUCT_FIELD (long,4,FRAME_A0,a0) +STRUCT_FIELD (long,4,FRAME_A2,a2) // (XOS_FRAME_SIZE-32) in S32E range of end +STRUCT_FIELD (long,4,FRAME_A3,a3) // (XOS_FRAME_SIZE-28) in S32E range of end +STRUCT_FIELD (long,4,FRAME_LEVELMASK,levelmask) // +STRUCT_FIELD (long,4,FRAME_NESTCHAIN,nestchain) // nested C function call chain ptr +// Caller's a0-a3 save area below SP. These fields MUST be the last ones in the +// struct so that they are guaranteed to be just under the original SP (before +// we allocate the exception frame). +STRUCT_AFIELD (long,4,FRAME_CWINSAVE,cwinsave, 4) // (XOS_FRAME_SIZE-16) +STRUCT_END(XosExcFrame) // NOTE: exception frame size is 128 + +#define FRAME_AR(x) (FRAME_AREG + x*4 - 16) + +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) +#define XOS_FRAME_SIZE XosExcFrameSize +#else +#define XOS_FRAME_SIZE sizeof(XosExcFrame) +#endif + + +//----------------------------------------------------------------------------- +// Stack frame layout for a cooperatively switched out thread +// (tcb->resume_fn == &xos_resume_cooperative_thread). +// Pointed to by thread->esf. This is a function frame. +// Thread's a1 == thread->esf. +//----------------------------------------------------------------------------- +STRUCT_BEGIN +STRUCT_FIELD (long,4,CFRAME_A0,a0) // return PC +STRUCT_FIELD (long,4,CFRAME_LEVELMASK,levelmask) +STRUCT_FIELD (long,4,CFRAME_PS,ps) +#ifdef __XTENSA_CALL0_ABI__ +STRUCT_FIELD (long,4,CFRAME_PAD0,pad0) +STRUCT_AFIELD(long,4,CFRAME_AREG,areg,4) // callee-saved regs a12-a15 +#endif +STRUCT_END(XosCoopFrame) + + +//----------------------------------------------------------------------------- +// Offsets into thread control block (must match xos_thread.h !!) +//----------------------------------------------------------------------------- +#define TCB_RESUME_FN 12 // ptr to thread resume asm sequence +#define TCB_STACK_ESF 16 // saved stack ptr (actually, ptr to ESF) +#define TCB_TIE_SAVE 20 // ptr to TIE save area +#define TCB_RETVALUE 24 // ptr to xos_block return value +#define TCB_STACK_END 36 // ptr to end of stack (thread's initial stack ptr) +#define TCB_STARTUP_ENTRY 40 // ptr to thread entry function +#define TCB_STARTUP_ARG 44 // ptr to thread entry function's arg +#define TCB_READY 48 // thread ready state (1 byte) +#define TCB_CLIB_PTR 108 // thread C lib context pointer + +#define TCB_RESUME_CCOUNT 116 // cycle count at last resume +#define TCB_CYCLE_COUNT 120 // number of cycles consumed +#define TCB_NORMAL_RESUMES 128 // number of cooperative/restart thread resumes +#define TCB_PREEMPT_RESUMES 132 // number of pre-emptive thread resumes + + +//----------------------------------------------------------------------------- +// Coprocessor state handling: +// The coprocessor state save area is allocated on the thread stack. The stack +// must be sized appropriately. Threads that do not use coprocessors need not +// allocate the storage area. +// +// Along with the save area for each coprocessor, two bitmasks with flags per +// coprocessor (laid out as in the CPENABLE reg) help manage context switching +// coprocessors as efficiently as possible: +// +// XT_CPENABLE +// The contents of a non-running thread's CPENABLE register. +// It represents the coprocessors owned (and whose state is still needed) +// by the thread. When a thread is preempted, its CPENABLE is saved here. +// When a thread solicits a context switch, its CPENABLE is cleared - the +// compiler has saved the (caller-saved) coprocessor state if needed. +// When a non-running thread loses ownership of a CP, its bit is cleared. +// When a thread runs, it's XT_CPENABLE is loaded into the CPENABLE reg. +// Avoids coprocessor exceptions when no change of ownership is needed. +// +// XT_CPSTORED +// A bitmask with the same layout as CPENABLE, a bit per coprocessor. +// Indicates whether the state of each coprocessor is saved in the state +// save area. When a thread enters the kernel, only the state of coprocs +// still enabled in CPENABLE is saved. When the coprocessor exception +// handler assigns ownership of a coprocessor to a thread, it restores +// the saved state only if this bit is set, and clears this bit. +// +// XT_CP_CS_ST +// A bitmask with the same layout as CPENABLE, a bit per co-processor. +// Indicates whether callee-saved state is saved in the state save area. +// Callee-saved state is saved by itself on a solicited context switch, +// and restored when needed by the coprocessor exception handler. +// Unsolicited switches will cause the entire coprocessor to be saved +// when necessary. +// +// XT_NCP_ASA +// Pointer to aligned save area for non-CP state. This is always filled +// in, even if there is no non-CP state to be saved. If there is no state +// to be saved then no space is actually allocated and this pointer is +// not used. +// +// XT_CP_ASA +// Pointer to aligned save area for coprocessor state. This is filled in +// only if coprocessor state is to be saved for the thread. Allows it to be +// aligned more than the overall save area (which might be stack-aligned +// or TCB-aligned). Especially relevant for Xtensa cores configured with a +// very large data path that requires alignment greater than 16 bytes (ABI +// stack alignment). +//----------------------------------------------------------------------------- + +#define ALIGNUP(n, val) (((val) + (n)-1) & -(n)) + +// Offsets of each coprocessor save area within the 'aligned save area'. +// The non-CP TIE state save area is at offset 0, so that it does not +// move around if some or all coprocessors are not to be saved. + +#define XT_NCP_SA 0 +#define XT_CP0_SA ALIGNUP(XCHAL_CP0_SA_ALIGN, XT_NCP_SA + XCHAL_NCP_SA_SIZE) +#define XT_CP1_SA ALIGNUP(XCHAL_CP1_SA_ALIGN, XT_CP0_SA + XCHAL_CP0_SA_SIZE) +#define XT_CP2_SA ALIGNUP(XCHAL_CP2_SA_ALIGN, XT_CP1_SA + XCHAL_CP1_SA_SIZE) +#define XT_CP3_SA ALIGNUP(XCHAL_CP3_SA_ALIGN, XT_CP2_SA + XCHAL_CP2_SA_SIZE) +#define XT_CP4_SA ALIGNUP(XCHAL_CP4_SA_ALIGN, XT_CP3_SA + XCHAL_CP3_SA_SIZE) +#define XT_CP5_SA ALIGNUP(XCHAL_CP5_SA_ALIGN, XT_CP4_SA + XCHAL_CP4_SA_SIZE) +#define XT_CP6_SA ALIGNUP(XCHAL_CP6_SA_ALIGN, XT_CP5_SA + XCHAL_CP5_SA_SIZE) +#define XT_CP7_SA ALIGNUP(XCHAL_CP7_SA_ALIGN, XT_CP6_SA + XCHAL_CP6_SA_SIZE) + +#define XT_TOT_SA_SIZE ALIGNUP(16, XT_CP7_SA + XCHAL_CP7_SA_SIZE) +#define XT_NCP_SA_SIZE XCHAL_NCP_SA_SIZE + +// Offsets within the overall save area + +#define XT_CPENABLE 0 // (2 bytes) coprocessors active for this thread +#define XT_CPSTORED 2 // (2 bytes) coprocessors saved for this thread +#define XT_CP_CS_ST 4 // (2 bytes) coprocessor callee-saved regs for this thread +#define XT_NCP_ASA 8 // (4 bytes) ptr to aligned save area for nonCP state +#define XT_CP_ASA 12 // (4 bytes) ptr to aligned save area for CP state + +// Overall size allows for dynamic alignment, make sure multiple of 4 bytes. +// XT_CP_SIZE - total space needed for all coprocessors + nonCP state + hdr +// XT_NCP_SIZE - total space needed for nonCP state + hdr + +#define XT_CP_SIZE ALIGNUP(4, (16 + XT_TOT_SA_SIZE + XCHAL_TOTAL_SA_ALIGN)) +#define XT_NCP_SIZE ALIGNUP(4, (16 + XT_NCP_SA_SIZE + XCHAL_TOTAL_SA_ALIGN)) + + +//----------------------------------------------------------------------------- +// Stack size computation. +// +// XOS_STACK_MIN_SIZE +// The minimum recommended stack size for any XOS thread. If you want to +// use a stack size smaller than this, you will have to verify that the +// smaller size will work under all operating conditions. +// +// XOS_STACK_MIN_SIZE_NO_CP +// The minimum recommended atack size for threads that will not use any +// coprocessor resources. No coprocessor state will be saved/restored +// for these threads. Non-CP TIE state will still be saved/restored. +// These threads must be created with the flag XOS_THREAD_NO_CP. +// +// XOS_STACK_EXTRA +// The amount of stack space used by the system to: +// - save coprocessor state +// - save non-coprocessor TIE state +// - allocate an interrupt/exception frame +// +// XOS_STACK_EXTRA_NO_CP +// The amount of stack space used by the system to: +// - save non-coprocessor TIE state +// - allocate an interrupt/exception frame +//----------------------------------------------------------------------------- + +#define XOS_STACK_EXTRA (XOS_FRAME_SIZE + XT_CP_SIZE) +#define XOS_STACK_EXTRA_NO_CP (XOS_FRAME_SIZE + XT_NCP_SIZE) + +#ifdef __XTENSA_CALL0_ABI__ +#define XOS_STACK_MIN_SIZE (XOS_STACK_EXTRA + 0x180) +#define XOS_STACK_MIN_SIZE_NO_CP (XOS_STACK_EXTRA_NO_CP + 0x180) +#else +#define XOS_STACK_MIN_SIZE (XOS_STACK_EXTRA + 0x200) +#define XOS_STACK_MIN_SIZE_NO_CP (XOS_STACK_EXTRA_NO_CP + 0x200) +#endif + + +//----------------------------------------------------------------------------- +// Items related to C library thread safety. +//----------------------------------------------------------------------------- +#if XOS_OPT_THREAD_SAFE_CLIB + +#if XSHAL_CLIB == XTHAL_CLIB_XCLIB + #if !defined(_ASMLANGUAGE) && !defined(__ASSEMBLER__) + #include + #endif + #define CLIB_THREAD_STRUCT struct _reent xclib_reent + #define GLOBAL_CLIB_PTR _reent_ptr +#elif XSHAL_CLIB == XTHAL_CLIB_NEWLIB + #if !defined(_ASMLANGUAGE) && !defined(__ASSEMBLER__) + #include + #endif + #define CLIB_THREAD_STRUCT struct _reent newlib_reent + #define GLOBAL_CLIB_PTR _impure_ptr +#else + #error The selected C runtime library is not thread safe. +#endif + +#endif // XOS_OPT_THREAD_SAFE_CLIB + + +//----------------------------------------------------------------------------- +// Check (MAX_OS_INTLEVEL,EXCM_LEVEL) +//----------------------------------------------------------------------------- +#if XOS_MAX_OS_INTLEVEL >= XCHAL_EXCM_LEVEL +# define XOS_MAX_OSEXCM_LEVEL XOS_MAX_OS_INTLEVEL +#else +# warning "XOS_MAX_OS_INTLEVEL was set below XCHAL_EXCM_LEVEL: this was never tested" +# define XOS_MAX_OSEXCM_LEVEL XCHAL_EXCM_LEVEL +#endif + + +//----------------------------------------------------------------------------- +// Detect if in interrupt context. +//----------------------------------------------------------------------------- +#if XCHAL_HAVE_INTERRUPTS +#define INTERRUPT_CONTEXT ((XT_RSR_PS() & PS_UM) == 0) +#else +#define INTERRUPT_CONTEXT 0 +#endif + + +//----------------------------------------------------------------------------- +// Xtensa tools version. +//----------------------------------------------------------------------------- +#if defined __XCC__ +#define XTTOOLS_VERSION (__XCC__ + __XCC_MINOR__) +#else +#define XTTOOLS_VERSION (0) +#endif + + +//----------------------------------------------------------------------------- +// Erratum workarounds. +//----------------------------------------------------------------------------- + +// Erratum 487 fix is available in version RF.3 onwards and RG.2 onwards. +#if ((__XCC__ == 11000) && (__XCC_MINOR__ >= 3)) || (XTTOOLS_VERSION >= 12002) +#define HWERR_487_FIX hw_erratum_487_fix +#else +#define HWERR_487_FIX +#endif + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_COMMON_H__ + diff --git a/components/esp32/include/xtensa/xos_cond.h b/components/esp32/include/xtensa/xos_cond.h new file mode 100755 index 000000000..8116947d3 --- /dev/null +++ b/components/esp32/include/xtensa/xos_cond.h @@ -0,0 +1,145 @@ +/** @file */ + +// xos_cond.h - XOS condition variables API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + +#ifndef __XOS_COND_H__ +#define __XOS_COND_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// +// Function pointer type for condition callbacks (defined in xos_thread.h) +// +// typedef int32_t (XosCondFunc)(void * arg, int32_t sig_value, XosThread * thread); +// +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +/// +/// Condition object. +/// +//----------------------------------------------------------------------------- +typedef struct XosCond { + XosThreadQueue queue; ///< Queue of waiters. +#if XOS_COND_DEBUG + uint32_t sig; // Signature indicates valid object. +#endif +} XosCond; + + +//----------------------------------------------------------------------------- +/// +/// Initialize a condition object before first use. The object must be +/// allocated by the caller. +/// +/// \param cond Pointer to condition object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_cond_create(XosCond * cond); + + +//----------------------------------------------------------------------------- +/// +/// Destroy a condition object. Must have been previously created by calling +/// xos_cond_create(). +/// +/// \param cond Pointer to condition object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_cond_delete(XosCond * cond); + + +//----------------------------------------------------------------------------- +/// +/// Wait on a condition: block until the condition is satisfied. The condition +/// is satisfied when xos_cond_signal() is called on this condition *and* the +/// condition callback function returns non-zero. If there is no callback +/// function, then the condition is automatically satisfied. +/// +/// The condition structure must have been initialized before first use by +/// calling xos_cond_create(). +/// +/// \param cond Pointer to condition object. +/// +/// \param cond_fn Pointer to a function, called by xos_cond_signal(), +/// that should return non-zero if this thread is to +/// be resumed. The function is invoked as: +/// `(*cond_fn)(cond_arg, sig_value)`. +/// +/// \param cond_arg Argument passed to cond_fn. +/// +/// \return Returns the value passed to xos_cond_signal(). +/// +//----------------------------------------------------------------------------- +int32_t +xos_cond_wait(XosCond * cond, XosCondFunc * cond_fn, void * cond_arg); + + +//----------------------------------------------------------------------------- +/// +/// Trigger the condition: wake all threads waiting on the condition, if their +/// condition function evaluates to true (non-zero). If there is no condition +/// function for a thread then it is automatically awakened. +/// +/// The condition structure must have been initialized before first use by +/// calling xos_cond_create(). +/// +/// \param cond Pointer to condition object. +/// +/// \param sig_value Value passed to all waiters, returned by +/// xos_cond_wait(). +/// +/// \return Returns the number of waiting threads that were resumed. +/// +/// NOTE: Signaling a condition that has no waiters has no effect on it, and +/// the signal is not remembered. Any thread that waits on it later must be +/// woken by another call to xos_cond_signal(). +/// +//----------------------------------------------------------------------------- +int32_t +xos_cond_signal(XosCond * cond, int32_t sig_value); + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_COND_H__ + diff --git a/components/esp32/include/xtensa/xos_errors.h b/components/esp32/include/xtensa/xos_errors.h new file mode 100755 index 000000000..790cdde3b --- /dev/null +++ b/components/esp32/include/xtensa/xos_errors.h @@ -0,0 +1,107 @@ +/** @file */ + +// xos_errors.h - XOS error codes. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_ERRORS_H__ +#define __XOS_ERRORS_H__ + +#include "xos_types.h" + + +#define _XOS_ERR_FIRST (-65536) +#define _XOS_ERR_LAST (-1) + + +//----------------------------------------------------------------------------- +/// +/// List of XOS error codes. All error codes are negative integers, except for +/// XOS_OK which is zero. +/// XOS error codes occupy the range from -65536 up to -1. +/// The function IS_XOS_ERRCODE() can be used to check if a value lies within +/// the error code range. +/// +//----------------------------------------------------------------------------- +typedef enum xos_err_t { + XOS_OK = 0, + + XOS_ERR_NOT_FOUND = _XOS_ERR_FIRST, ///< Object not found + XOS_ERR_INVALID_PARAMETER, ///< Function parameter is invalid + XOS_ERR_LIMIT, ///< Limit exceeded + XOS_ERR_NOT_OWNED, ///< Object not owned by caller + XOS_ERR_MUTEX_LOCKED, ///< Mutex is already locked + XOS_ERR_MUTEX_NOT_OWNED, ///< Mutex not owned by caller + XOS_ERR_MUTEX_ALREADY_OWNED, ///< Mutex already owned by caller + XOS_ERR_MUTEX_DELETE, ///< Mutex being waited on has been deleted + XOS_ERR_COND_DELETE, ///< Condition being waited on has been deleted + XOS_ERR_SEM_DELETE, ///< Semaphore being waited on has been deleted + XOS_ERR_SEM_BUSY, ///< Semaphore is not available + XOS_ERR_EVENT_DELETE, ///< Event being waited on has been deleted + XOS_ERR_MSGQ_FULL, ///< Message queue is full + XOS_ERR_MSGQ_EMPTY, ///< Message queue is empty + XOS_ERR_MSGQ_DELETE, ///< Message queue being waited on has been deleted + XOS_ERR_TIMER_DELETE, ///< Timer being waited on has been deleted + XOS_ERR_CONTAINER_NOT_RTC, ///< Containing thread not of RTC type + XOS_ERR_CONTAINER_NOT_SAME_PRI, ///< Containing thread not at same priority + XOS_ERR_STACK_TOO_SMALL, ///< Thread stack is too small + XOS_ERR_CONTAINER_ILLEGAL, ///< Illegal container thread + XOS_ERR_ILLEGAL_OPERATION, ///< This operation is not allowed + XOS_ERR_THREAD_EXITED, ///< The thread has already exited + XOS_ERR_NO_TIMER, ///< No suitable timer found + XOS_ERR_FEATURE_NOT_PRESENT, ///< This feature is disabled or not implemented + XOS_ERR_TIMEOUT, ///< Wait timed out + + XOS_ERR_UNHANDLED_INTERRUPT, ///< No handler for interrupt + XOS_ERR_UNHANDLED_EXCEPTION, ///< No handler for exception + XOS_ERR_INTERRUPT_CONTEXT, ///< Operation is illegal in interrupt context + XOS_ERR_THREAD_BLOCKED, ///< Thread already blocked + XOS_ERR_ASSERT_FAILED, ///< Runtime assertion failure + XOS_ERR_CLIB_ERR, ///< Error in C library thread safety module + XOS_ERR_INTERNAL_ERROR, ///< XOS internal error + + XOS_ERR_LAST = _XOS_ERR_LAST, +} xos_err_t; + + +//----------------------------------------------------------------------------- +/// +/// Check if a value is a valid XOS error code. +/// +/// \param val Value to check +/// +/// \return Returns nonzero if 'val' is in the XOS error code range. +/// +//----------------------------------------------------------------------------- +static inline int32_t +IS_XOS_ERRCODE(xos_err_t val) +{ + return ((val >= _XOS_ERR_FIRST) && (val <= _XOS_ERR_LAST)); +} + + +#endif // __XOS_ERRORS_H__ + diff --git a/components/esp32/include/xtensa/xos_event.h b/components/esp32/include/xtensa/xos_event.h new file mode 100755 index 000000000..43219a247 --- /dev/null +++ b/components/esp32/include/xtensa/xos_event.h @@ -0,0 +1,281 @@ +/** @file */ + +// xos_event.h - XOS Event API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + +#ifndef __XOS_EVENT_H__ +#define __XOS_EVENT_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// Defines. +//----------------------------------------------------------------------------- +#define XOS_EVENT_BITS_ALL 0xFFFFFFFF +#define XOS_EVENT_BITS_NONE 0 + + +//----------------------------------------------------------------------------- +// Event flags. +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +/// +/// Event object. +/// +//----------------------------------------------------------------------------- +typedef struct XosEvent { + XosThreadQueue waitq; ///< Queue of waiters. + uint32_t bits; ///< Event bits + uint32_t mask; ///< Specifies which bits are valid + uint16_t flags; ///< Properties. + uint16_t pad; ///< Padding +#if XOS_EVENT_DEBUG + uint32_t sig; // Valid signature indicates inited. +#endif +} XosEvent; + + +//----------------------------------------------------------------------------- +/// +/// Initialize an event object before first use. +/// +/// \param event Pointer to event object. +/// +/// \param mask Mask of active bits. Only these bits can be signaled. +/// +/// \param flags Creation flags (currently ignored, should be zero). +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_event_create(XosEvent * event, uint32_t mask, uint32_t flags); + + +//----------------------------------------------------------------------------- +/// +/// Destroy an event object. Must have been previously created by calling +/// xos_event_create(). +/// +/// \param event Pointer to event object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_event_delete(XosEvent * event); + + +//----------------------------------------------------------------------------- +/// +/// Set the specified bits in the specified event. Propagates the bit states +/// to all waiting threads and wakes them if needed. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to set. Bits not set in the mask +/// will not be modified by this call. To set all +/// the bits in the event, use the constant +/// XOS_EVENT_BITS_ALL. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_set(XosEvent * event, uint32_t bits); + + +//----------------------------------------------------------------------------- +/// +/// Clear the specified bits in the specified event. Propagates the bit states +/// to all waiting threads and wakes them if needed. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to clear. Every bit that is set in +/// the mask will be cleared from the event. Bits +/// not set in the mask will not be modified by this +/// call. To clear all the bits in an event use the +/// constant XOS_EVENT_BITS_ALL. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_clear(XosEvent * event, uint32_t bits); + + +//----------------------------------------------------------------------------- +/// +/// Clear and set the specified bits in the specified event. The two steps are +/// combined into one update, so this is faster than calling xos_event_clear() +/// and xos_event_set() separately. Only one update is sent out to waiting +/// threads. +/// +/// \param event Pointer to event object. +/// +/// \param clr_bits Mask of bits to clear. The clear operation +/// happens before the set operation. +/// +/// \param set_bits Mask of bits to set. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_clear_and_set(XosEvent * event, uint32_t clr_bits, uint32_t set_bits); + + +//----------------------------------------------------------------------------- +/// +/// Get the current state of the event object. This is a snapshot of the state +/// of the event at this time. +/// +/// \param event Pointer to event object. +/// +/// \param pstate Pointer to a uint32_t variable where the state +/// will be returned. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_get(XosEvent * event, uint32_t * pstate); + + +//----------------------------------------------------------------------------- +/// +/// Wait until all the specified bits in the wait mask become set in the given +/// event object. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to test. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_wait_all(XosEvent * event, uint32_t bits); + + +//----------------------------------------------------------------------------- +/// +/// Wait until all the specified bits in the wait mask become set in the given +/// event object, or the timeout expires. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to test. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else +/// error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_wait_all_timeout(XosEvent * event, uint32_t bits, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Wait until any of the specified bits in the wait mask become set in the +/// given event object. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to test. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_wait_any(XosEvent * event, uint32_t bits); + + +//----------------------------------------------------------------------------- +/// +/// Wait until any of the specified bits in the wait mask become set in the +/// event object, or the timeout expires. +/// +/// \param event Pointer to event object. +/// +/// \param bits Mask of bits to test. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else +/// error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_wait_any_timeout(XosEvent * event, uint32_t bits, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Atomically set a specified group of bits, then wait for another specified +/// group of bits to become set. +/// +/// \param event Pointer to event object. +/// +/// \param set_bits Group of bits to set. +/// +/// \param wait_bits Group of bits to wait on. All the bits in the +/// group will have to get set before the wait is +/// satisfied. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_event_set_and_wait(XosEvent * event, uint32_t set_bits, uint32_t wait_bits); + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_EVENT_H__ + diff --git a/components/esp32/include/xtensa/xos_internal.h b/components/esp32/include/xtensa/xos_internal.h new file mode 100755 index 000000000..5b8c8b466 --- /dev/null +++ b/components/esp32/include/xtensa/xos_internal.h @@ -0,0 +1,120 @@ + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef __XOS_INTERNAL_H__ +#define __XOS_INTERNAL_H__ + +#if !defined(__XOS_H__) || !defined(_XOS_INCLUDE_INTERNAL_) + #error "xos_internal.h must be included by defining _XOS_INCLUDE_INTERNAL_ before including xos.h" +#endif + +#include +#include "xos_common.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +// Use this macro to suppress compiler warnings for unused variables. + +#define UNUSED(x) (void)(x) + + +#if XOS_DEBUG + +#include +#include +# define DPRINTF printf + +#else + +# define DPRINTF(x...) do {} while(0) + +#endif + + +//----------------------------------------------------------------------------- +// Internal flags for thread creation. +//----------------------------------------------------------------------------- +#define XOS_THREAD_FAKE 0x8000 // Don't allocate stack (init and idle threads). + + +//----------------------------------------------------------------------------- +// Interrupt handler table entry. This structure defines one entry in the XOS +// interrupt handler table. +//----------------------------------------------------------------------------- +typedef struct XosIntEntry { + XosIntFunc * handler; // Pointer to handler function. + void * arg; // Argument passed to handler function. +#if XOS_OPT_INTERRUPT_SWPRI + unsigned char level; // Interrupt level. + unsigned char priority; // Interrupt priority. + short reserved; // Reserved. + unsigned int primask; // Mask of interrupts at higher priority. +#else + unsigned int ps; // Value of PS when running the handler. +#endif +} XosIntEntry; + + +//----------------------------------------------------------------------------- +// Extern variables. +//----------------------------------------------------------------------------- +extern unsigned xos_intlevel_mask; +extern unsigned xos_intenable_mask; +extern XosIntEntry xos_interrupt_table[XCHAL_NUM_INTERRUPTS]; + +extern uint32_t xos_clock_freq; +extern uint32_t xos_tick_period; +extern uint64_t xos_system_ticks; +extern uint64_t xos_system_cycles; +extern uint32_t xos_num_ctx_switches; + + +/* + +One thing I noticed is different between my initial idea of stack +assignments to RTC threads, when comparing to interrupts, is that I +expected each RTC thread priority to have its own stack, whereas +interrupts of different priorities share an interrupt stack. + +It's not really a difference in memory usage, because when assigning +multiple priorities to a stack, you have to add-up worst-case for +all priorities. One possible functional difference is that with +separate stacks per priority, it's possible to dynamically change +the priority of an RTC thread (while it's running). Not sure how +valuable that might be -- changing priority is useful with priority +inheritance, to avoid priority inversion, but I don't know how often +an RTC thread might acquire a lock (it couldn't block on acquiring a +lock in the usual sense -- it could get queued waiting and be restarted +when it becomes available, or use try_lock instead of lock). + +*/ + +#ifdef __cplusplus +} +#endif + +#endif /* __XOS_INTERNAL_H__ */ + diff --git a/components/esp32/include/xtensa/xos_msgq.h b/components/esp32/include/xtensa/xos_msgq.h new file mode 100755 index 000000000..30b9aa903 --- /dev/null +++ b/components/esp32/include/xtensa/xos_msgq.h @@ -0,0 +1,278 @@ +/** @file */ + +// xos_msgq.h - XOS Message Queue API and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_MSGQ_H__ +#define __XOS_MSGQ_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// XosMsgQueue is a multi-writer multi-reader message queue implementation. +// It is completely thread-safe and can be used by interrupt handlers. +// Interrupt handlers are guaranteed not to block when trying to send or +// receive a message. Messages are copied into the queue. The queue contains +// storage for a fixed number of messages defined at queue creation time. +// Messages must be a multiple of 4 bytes long (padded if necessary) and the +// message buffers must be 4-byte aligned. +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +// Message Queue flags. +//----------------------------------------------------------------------------- +#define XOS_MSGQ_WAIT_PRIORITY 0x0000 ///< Wake waiters in priority order (default) +#define XOS_MSGQ_WAIT_FIFO 0x0001 ///< Wake waiters in FIFO order +#define XOS_MSGQ_FULL 0x0002 // Queue is full +#define XOS_MSGQ_DELETED 0x8000 // Queue is deleted + + +//----------------------------------------------------------------------------- +/// +/// XosMsgQueue object. +/// +//----------------------------------------------------------------------------- +typedef struct XosMsgQueue { + uint16_t flags; ///< queue flags + uint16_t count; ///< # of messages queue can hold + uint32_t msize; ///< message size in bytes + uint16_t head; ///< write pointer + uint16_t tail; ///< read pointer + XosThreadQueue readq; ///< reader wait queue + XosThreadQueue writeq; ///< writer wait queue +#if XOS_MSGQ_DEBUG + uint32_t sig; // debug signature +#endif +#if XOS_OPT_MSGQ_STATS + uint32_t num_send; ///< # of messages put to queue + uint32_t num_recv; ///< # of messages taken from queue + uint32_t num_send_blks; ///< # of times thread blocked on send + uint32_t num_recv_blks; ///< # of times thread blocked on recv +#endif + uint32_t msg[1]; ///< first word of message buffer +} XosMsgQueue; + + +//----------------------------------------------------------------------------- +/// +/// Use these macros to statically or dynamically allocate a message queue. +/// XOS_MSGQ_ALLOC allocates a static queue, while XOS_MSGQ_SIZE can be used +/// to allocate memory via malloc() etc. +/// +/// Static: this allocates a queue named "testq", containing 10 messages, +/// each 16 bytes long. +/// +/// XOS_MSGQ_ALLOC(testq, 10, 16); +/// +/// Dynamic: this allocates a queue named "testq", containing 10 messages, +/// each 16 bytes long. +/// +/// XosMsgQueue * testq = malloc( XOS_MSGQ_SIZE(10, 16) ); +/// +/// \param name The queue name, i.e. the name of the pointer +/// to the queue. Used as the queue handle in +/// queue API calls. +/// +/// \param num Number of messages to allocate in queue. Must be > 0. +/// +/// \param size Message size in bytes. Must be > 0 and multiple of 4. +/// +//----------------------------------------------------------------------------- + +#define XOS_MSGQ_ALLOC(name, num, size) \ + static uint8_t name ## _buf[ sizeof(XosMsgQueue) + ((num) * (size)) ]; \ + XosMsgQueue * name = (XosMsgQueue *) name ## _buf; + +#define XOS_MSGQ_SIZE(num, size) \ + (sizeof(XosMsgQueue) + ((num) * (size))) + + +//----------------------------------------------------------------------------- +/// +/// Create the message queue object. Memory for the queue must be allocated by +/// the caller, either statically or via dynamic allocation. See the macros +/// XOS_MSGQ_ALLOC and XOS_MSGQ_SIZE for examples. +/// +/// \param msgq Handle (pointer) to message queue. +/// +/// \param num Number of messages allocated in queue. Must be > 0. +/// +/// \param size Message size in bytes. Must be > 0 and multiple of 4. +/// +/// \param flags Queue flags: +/// - XOS_MSGQ_WAIT_FIFO - blocked threads will be +/// woken in FIFO order. +/// - XOS_MSGQ_WAIT_PRIORITY - blocked threads will +/// be woken in priority order (default). +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_create(XosMsgQueue * msgq, uint16_t num, uint32_t size, uint16_t flags); + + +//----------------------------------------------------------------------------- +/// +/// Destroys the specified queue. Any waiting threads are unblocked with an +/// error return. Any messages in the queue will be lost. +/// +/// \param msgq Pointer to message queue. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_delete(XosMsgQueue * msgq); + + +//----------------------------------------------------------------------------- +/// +/// Put a message into the queue. The message contents are copied into the next +/// available message slot. If no space is available, this function will block +/// if called from a thread, but will return immediately if called from an +/// interrupt handler. +/// +/// \param msgq Pointer to message queue. +/// +/// \param msg Pointer to message buffer. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_put(XosMsgQueue * msgq, const uint32_t * msg); + + +//----------------------------------------------------------------------------- +/// +/// Put a message into the queue. The message contents are copied into the next +/// available message slot. If no space is available, this function will block +/// if called from a thread, but will return immediately if called from an +/// interrupt handler. The thread will be unblocked when space frees up in the +/// queue or the timeout expires. +/// +/// \param msgq Pointer to message queue. +/// +/// \param msg Pointer to message buffer. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_put_timeout(XosMsgQueue * msgq, const uint32_t * msg, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Get a message from the queue. The message contents are copied into the +/// buffer that must be provided. If no message is available, this function +/// will block if called from a thread, but will return immediately if called +/// from an interrupt handler. +/// +/// \param msgq Pointer to message queue. +/// +/// \param msg Pointer to message buffer. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_get(XosMsgQueue * msgq, uint32_t * msg); + + +//----------------------------------------------------------------------------- +/// +/// Get a message from the queue. The message contents are copied into the +/// buffer that must be provided. If no message is available, this function +/// will block if called from a thread, but will return immediately if called +/// from an interrupt handler. The thread will be unblocked when a message +/// arrives in the queue or the timeout expires. +/// +/// \param msgq Pointer to message queue. +/// +/// \param msg Pointer to message buffer. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_get_timeout(XosMsgQueue * msgq, uint32_t * msg, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Check if the queue is empty. +/// +/// \param msgq Pointer to message queue. +/// +/// \return Returns nonzero if queue is empty, zero if queue is not empty. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_empty(XosMsgQueue * msgq); + + +//----------------------------------------------------------------------------- +/// +/// Check if the queue is full. +/// +/// \param msgq Pointer to message queue. +/// +/// \return Returns nonzero if queue is full, zero if queue is not full. +/// +//----------------------------------------------------------------------------- +int32_t +xos_msgq_full(XosMsgQueue * msgq); + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_MSGQ_H__ + diff --git a/components/esp32/include/xtensa/xos_mutex.h b/components/esp32/include/xtensa/xos_mutex.h new file mode 100755 index 000000000..9df5f9750 --- /dev/null +++ b/components/esp32/include/xtensa/xos_mutex.h @@ -0,0 +1,205 @@ +/** @file */ + +// xos_mutex.h - XOS Mutex API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + +#ifndef __XOS_MUTEX_H__ +#define __XOS_MUTEX_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// Mutex flags. +//----------------------------------------------------------------------------- +#define XOS_MUTEX_WAIT_PRIORITY 0x0000 ///< Wake waiters in priority order (default) +#define XOS_MUTEX_WAIT_FIFO 0x0001 ///< Wake waiters in FIFO order +#define XOS_MUTEX_PRIORITY_CLG 0x0004 // Use priority ceiling +#define XOS_MUTEX_PRIORITY_INV 0x0008 // Protect against priority inversion + + +//----------------------------------------------------------------------------- +/// +/// XosMutex object. +/// +//----------------------------------------------------------------------------- +typedef struct XosMutex { + XosThread * owner; ///< Owning thread (null if unlocked). + XosThreadQueue waitq; ///< Queue of waiters. + uint32_t flags; ///< Properties. + uint32_t priority; + int32_t lock_count; ///< For recursive locking. +#if XOS_MUTEX_DEBUG + uint32_t sig; // Valid signature indicates inited. +#endif +} XosMutex; + + +//----------------------------------------------------------------------------- +/// +/// Initialize a mutex object before first use. +/// +/// \param mutex Pointer to mutex object. +/// +/// \param flags Creation flags: +/// - XOS_MUTEX_WAIT_FIFO -- Queue waiting threads +/// in fifo order. +/// - XOS_MUTEX_WAIT_PRIORITY -- Queue waiting threads +/// by priority. This is the default. +/// - XOS_MUTEX_PRIORITY_CLG -- Use specified priority +/// value as the mutex's priority ceiling. If the +/// owning thread has a priority lower than the mutex's +/// priority, then the thread will have its priority +/// raised to the higher value as long as it owns the +/// mutex. +/// - XOS_MUTEX_PRIORITY_INV -- Protect against priority +/// inversion. If there is a waiting thread with a +/// higher priority than the current owner thread, +/// then the owner thread's priority is raised to the +/// higher value for as long as it owns the mutex. +/// +/// \param priority Mutex's priority ceiling. This is used only if the +/// XOS_MUTEX_PRIORITY_CLG flag is set. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: XOS_MUTEX_PRIORITY_CLG and XOS_MUTEX_PRIORITY_INV are NOT supported +/// in the current release. They will be supported in a future release. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_create(XosMutex * mutex, uint32_t flags, uint8_t priority); + + +//----------------------------------------------------------------------------- +/// +/// Destroy a mutex object. Must have been previously initialized by calling +/// xos_mutex_create(). +/// +/// \param mutex Pointer to mutex object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_delete(XosMutex * mutex); + + +//----------------------------------------------------------------------------- +/// +/// Take ownership of the mutex: block until the mutex is owned. +/// The mutex must have been initialized. +/// +/// \param mutex Pointer to mutex object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_lock(XosMutex * mutex); + + +//----------------------------------------------------------------------------- +/// +/// Take ownership of the mutex: block until the mutex is owned or the timeout +/// expires. The mutex must have been initialized. +/// +/// \param mutex Pointer to mutex object. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_lock_timeout(XosMutex * mutex, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Release ownership of the mutex. The mutex must have been initialized and +/// must be owned by the calling thread. +/// +/// \param mutex Pointer to mutex object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_unlock(XosMutex * mutex); + + +//----------------------------------------------------------------------------- +/// +/// Try to take ownership of the mutex, but do not block if the mutex is taken. +/// Return immediately. The mutex must have been initialized. +/// +/// \param mutex Pointer to mutex object. +/// +/// \return Returns XOS_OK on success (mutex owned), else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_mutex_trylock(XosMutex * mutex); + + +//----------------------------------------------------------------------------- +/// +/// Return the state of the mutex (locked or unlocked) but do not attempt to +/// take ownership. The mutex must have been initialized. +/// +/// \param mutex Pointer to mutex object. +/// +/// \return Returns 0 if the mutex is unlocked, 1 if it is locked, -1 on error. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_mutex_test(XosMutex * mutex) +{ + XOS_ASSERT(mutex); + + if (mutex != XOS_NULL) { + return (mutex->owner != XOS_NULL) ? 1 : 0; + } + return -1; +} + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_MUTEX_H__ + diff --git a/components/esp32/include/xtensa/xos_params.h b/components/esp32/include/xtensa/xos_params.h new file mode 100755 index 000000000..3fca11f21 --- /dev/null +++ b/components/esp32/include/xtensa/xos_params.h @@ -0,0 +1,276 @@ +/** @file */ + +// xos_params.h - user-settable compile time parameters for XOS. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#ifndef __XOS_PARAMS_H__ +#define __XOS_PARAMS_H__ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +/// +/// Number of thread priority levels. At this time XOS supports a maximum of +/// 32 priority levels (0 - 31). +/// +//----------------------------------------------------------------------------- +#ifndef XOS_NUM_PRIORITY +#define XOS_NUM_PRIORITY 16 // Default is 16 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Debug flags - Set to 1 to enable debug mode (and more verbose operation). +/// Can be set individually, or define XOS_DEBUG_ALL to enable all of them. +/// +/// - XOS_DEBUG -- Generic OS debug +/// - XOS_COND_DEBUG -- Condition objects debug +/// - XOS_EVENT_DEBUG -- Event objects debug +/// - XOS_MSGQ_DEBUG -- Message queue debug +/// - XOS_MUTEX_DEBUG -- Mutex objects debug +/// - XOS_SEM_DEBUG -- Semaphore objects debug +/// - XOS_THREAD_DEBUG -- Thread module debug +/// - XOS_TIMER_DEBUG -- Timer module debug +/// +/// WARNING: Enabling one or more of these flags will affect system performance +/// and timing. +/// +/// NOTE: Not all of these have been fully implemented. +/// +//----------------------------------------------------------------------------- +#if defined XOS_DEBUG_ALL + +#define XOS_DEBUG 1 +#define XOS_THREAD_DEBUG 1 +#define XOS_TIMER_DEBUG 1 +#define XOS_COND_DEBUG 1 +#define XOS_MUTEX_DEBUG 1 +#define XOS_SEM_DEBUG 1 +#define XOS_EVENT_DEBUG 1 +#define XOS_MSGQ_DEBUG 1 + +#else + +#ifndef XOS_DEBUG +#define XOS_DEBUG 0 +#endif +#ifndef XOS_THREAD_DEBUG +#define XOS_THREAD_DEBUG 0 +#endif +#ifndef XOS_TIMER_DEBUG +#define XOS_TIMER_DEBUG 0 +#endif +#ifndef XOS_COND_DEBUG +#define XOS_COND_DEBUG 0 +#endif +#ifndef XOS_MUTEX_DEBUG +#define XOS_MUTEX_DEBUG 0 +#endif +#ifndef XOS_SEM_DEBUG +#define XOS_SEM_DEBUG 0 +#endif +#ifndef XOS_EVENT_DEBUG +#define XOS_EVENT_DEBUG 0 +#endif +#ifndef XOS_MSGQ_DEBUG +#define XOS_MSGQ_DEBUG 0 +#endif + +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable runtime statistics collection for XOS. +/// NOTE: Enabling this option does have some impact on runtime performance +/// and OS footprint. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_STATS +#define XOS_OPT_STATS 1 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable statistics tracking for message queues. +/// enabling this will cause message queue objects to increase in size, and add +/// some overhead to message queue processing. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_MSGQ_STATS +#define XOS_OPT_MSGQ_STATS 0 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Size of interrupt stack in bytes. Shared by all interrupt handlers. Must be +/// sized to handle worst case nested interrupts. This is also used by the idle +/// thread so must exist even if interrupts are not configured. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_INT_STACK_SIZE +#if XCHAL_HAVE_INTERRUPTS +#define XOS_INT_STACK_SIZE 8192 +#else +#define XOS_INT_STACK_SIZE 32 +#endif +#endif + + +//----------------------------------------------------------------------------- +/// +/// Default maximum interrupt level at which XOS primitives may be called. +/// It is the level at which interrupts are disabled by default. +/// See also description of xos_set_int_pri_level(). +/// +//----------------------------------------------------------------------------- +#ifndef XOS_MAX_OS_INTLEVEL +#define XOS_MAX_OS_INTLEVEL XCHAL_EXCM_LEVEL +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this to 1 to enable stack checking. The stack is filled with a pattern +/// on thread creation, and the stack is checked at certain times during system +/// operation. +/// WARNING: Enabling this option can have some impact on runtime performance. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_STACK_CHECK +#if XOS_DEBUG +#define XOS_OPT_STACK_CHECK 1 +#else +#define XOS_OPT_STACK_CHECK 0 +#endif +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set XOS_CLOCK_FREQ to the system clock frequency if this is known ahead of +/// time. Otherwise, call xos_set_clock_freq() to set it at run time. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_CLOCK_FREQ +#define XOS_CLOCK_FREQ 1000000 +#endif +#define XOS_DEFAULT_CLOCK_FREQ XOS_CLOCK_FREQ + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable software prioritization of interrupts. The +/// priority scheme applied is that a higher interrupt number at the same level +/// will have higher priority. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_INTERRUPT_SWPRI +#define XOS_OPT_INTERRUPT_SWPRI 1 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to use the thread-safe version of the C runtime library. +/// You may need to enable this if you call C library functions from multiple +/// threads -- see the documentation for the relevant C library to determine if +/// this is necessary. This option increases the size of the TCB. +/// NOTE: At this time only the newlib and xclib libraries are supported for +/// thread safety. +/// +//----------------------------------------------------------------------------- +#include + +#ifndef XOS_OPT_THREAD_SAFE_CLIB + +#if XSHAL_CLIB == XTHAL_CLIB_XCLIB +#define XOS_OPT_THREAD_SAFE_CLIB 1 +#elif XSHAL_CLIB == XTHAL_CLIB_NEWLIB +#define XOS_OPT_THREAD_SAFE_CLIB 1 +#else +#define XOS_OPT_THREAD_SAFE_CLIB 0 +#endif + +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable the wait timeout feature. This allows waits +/// on waitable objects to expire after a specified timeout. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_WAIT_TIMEOUT +#define XOS_OPT_WAIT_TIMEOUT 1 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable threads waiting on timer objects. If this +/// feature is not used, turning it off will make timer objects smaller, and +/// reduce the time taken by timer expiry processing (by a small amount). +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_TIMER_WAIT +#define XOS_OPT_TIMER_WAIT 1 +#endif + + +//----------------------------------------------------------------------------- +/// +/// Set this option to 1 to enable time-slicing between multiple threads at the +/// same priority. If this option is enabled then on every timer tick the timer +/// handler will switch out the current thread if there is another ready thread +/// at the same priority, and allow the latter thread to run. Execution will be +/// round robin switched among all the threads at the same priority. +/// +/// Currently the time slice interval is fixed to be one timer tick. +/// +/// This feature is most useful if fixed duration timer ticks are used. +/// If dynamic ticking is enabled, then time slicing will work unpredictably +/// because the interval between ticks will vary. In some cases it may be +/// better to turn time slicing off. +/// +//----------------------------------------------------------------------------- +#ifndef XOS_OPT_TIME_SLICE +#define XOS_OPT_TIME_SLICE 1 +#endif + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_PARAMS_H__ + diff --git a/components/esp32/include/xtensa/xos_regaccess.h b/components/esp32/include/xtensa/xos_regaccess.h new file mode 100755 index 000000000..1fea5ddc2 --- /dev/null +++ b/components/esp32/include/xtensa/xos_regaccess.h @@ -0,0 +1,201 @@ + +// xos_regaccess.h - Access routines for various processor special registers. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +#ifndef __REGACCESS_H__ +#define __REGACCESS_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "xos_types.h" + +#include + +#if defined (__XCC__) +#if XCHAL_HAVE_CCOUNT +#include +#endif +#endif + + +//----------------------------------------------------------------------------- +// Read CCOUNT register. +//----------------------------------------------------------------------------- +static __inline__ uint32_t xos_get_ccount(void) +{ +#if XCHAL_HAVE_CCOUNT + +#if defined (__XCC__) + return XT_RSR_CCOUNT(); +#else + uint32_t ccount; + + __asm__ __volatile__ ( "rsr %0, ccount" : "=a" (ccount) ); + return ccount; +#endif + +#else + + return 0; + +#endif +} + + +//----------------------------------------------------------------------------- +// Read CCOMPARE0 +//----------------------------------------------------------------------------- +static __inline__ uint32_t xos_get_ccompare0(void) +{ +#if XCHAL_HAVE_CCOUNT + +#if defined (__XCC__) + return XT_RSR_CCOMPARE0(); +#else + uint32_t ccompare0; + + __asm__ __volatile__ ( "rsr %0, ccompare0" : "=a" (ccompare0)); + return ccompare0; +#endif + +#else + + return 0; + +#endif +} + + +//----------------------------------------------------------------------------- +// Read CCOMPARE1 +//----------------------------------------------------------------------------- +#if (XCHAL_NUM_TIMERS > 1) +static __inline__ uint32_t xos_get_ccompare1(void) +{ +#if defined (__XCC__) + return XT_RSR_CCOMPARE1(); +#else + uint32_t ccompare1; + + __asm__ __volatile__ ( "rsr %0, ccompare1" : "=a" (ccompare1)); + return ccompare1; +#endif +} +#endif + + +//----------------------------------------------------------------------------- +// Read CCOMPARE2 +//----------------------------------------------------------------------------- +#if (XCHAL_NUM_TIMERS > 2) +static __inline__ uint32_t xos_get_ccompare2(void) +{ +#if defined (__XCC__) + return XT_RSR_CCOMPARE2(); +#else + uint32_t ccompare2; + + __asm__ __volatile__ ( "rsr %0, ccompare2" : "=a" (ccompare2)); + return ccompare2; +#endif +} +#endif + + +//----------------------------------------------------------------------------- +// Write CCOMPARE0 +//----------------------------------------------------------------------------- +static __inline__ void xos_set_ccompare0(uint32_t val) +{ +#if XCHAL_HAVE_CCOUNT + +#if defined (__XCC__) + XT_WSR_CCOMPARE0(val); + XT_ISYNC(); +#else + __asm__ __volatile__ ( + "wsr %0, ccompare0\n" + "isync" + : + : "a" (val) + ); +#endif + +#else + + // Empty + +#endif +} + + +//----------------------------------------------------------------------------- +// Write CCOMPARE1 +//----------------------------------------------------------------------------- +#if (XCHAL_NUM_TIMERS > 1) +static __inline__ void xos_set_ccompare1(uint32_t val) +{ +#if defined (__XCC__) + XT_WSR_CCOMPARE1(val); + XT_ISYNC(); +#else + __asm__ __volatile__ ( + "wsr %0, ccompare1\n" + "isync" + : + : "a" (val) + ); +#endif +} +#endif + + +//----------------------------------------------------------------------------- +// Write CCOMPARE2 +//----------------------------------------------------------------------------- +#if (XCHAL_NUM_TIMERS > 2) +static __inline__ void xos_set_ccompare2(uint32_t val) +{ +#if defined (__XCC__) + XT_WSR_CCOMPARE2(val); + XT_ISYNC(); +#else + __asm__ __volatile__ ( + "wsr %0, ccompare2\n" + "isync" + : + : "a" (val) + ); +#endif +} +#endif + + +#ifdef __cplusplus +} +#endif + +#endif // __REGACCESS_H__ + diff --git a/components/esp32/include/xtensa/xos_semaphore.h b/components/esp32/include/xtensa/xos_semaphore.h new file mode 100755 index 000000000..42b7914ef --- /dev/null +++ b/components/esp32/include/xtensa/xos_semaphore.h @@ -0,0 +1,190 @@ +/** @file */ + +// xos_semaphore.h - XOS Semaphore API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + +#ifndef __XOS_SEMAPHORE_H__ +#define __XOS_SEMAPHORE_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// Semaphore flags. +//----------------------------------------------------------------------------- +#define XOS_SEM_WAIT_PRIORITY 0x0000 ///< Wake waiters in priority order (default) +#define XOS_SEM_WAIT_FIFO 0x0001 ///< Wake waiters in FIFO order +#define XOS_SEM_PRIORITY_INV 0x0004 // Protect against priority inversion + + +//----------------------------------------------------------------------------- +/// +/// XosSem object. +/// +//----------------------------------------------------------------------------- +typedef struct XosSem { + uint32_t count; ///< Current count + XosThreadQueue waitq; ///< Queue of waiters. + uint32_t flags; ///< Properties. +#if XOS_SEM_DEBUG + uint32_t sig; // Valid signature indicates inited. +#endif +} XosSem; + + +//----------------------------------------------------------------------------- +/// +/// Initialize a semaphore object before first use. +/// +/// \param sem Pointer to semaphore object. +/// +/// \param flags Creation flags: +/// - XOS_SEM_WAIT_FIFO -- queue waiting threads in +/// fifo order. +/// - XOS_SEM_WAIT_PRIORITY -- queue waiting threads +/// by priority. This is the default. +/// - XOS_SEM_PRIORITY_INV -- protect against priority +/// inversion. +/// +/// \param initial_count Initial count for semaphore on creation. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: XOS_SEM_PRIORITY_INV is NOT supported in the current release. It will +/// be supported in a future release. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_create(XosSem * sem, uint32_t flags, uint32_t initial_count); + + +//----------------------------------------------------------------------------- +/// +/// Destroy a semaphore object. Must have been previously created by calling +/// xos_sem_create(). +/// +/// \param sem Pointer to semaphore object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_delete(XosSem * sem); + + +//----------------------------------------------------------------------------- +/// +/// Decrement the semaphore count: block until the decrement is possible. +/// The semaphore must have been initialized. +/// +/// \param sem Pointer to semaphore object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_get(XosSem * sem); + + +//----------------------------------------------------------------------------- +/// +/// Decrement the semaphore count: block until the decrement is possible or +/// the timeout expires. The semaphore must have been initialized. +/// +/// \param sem Pointer to semaphore object. +/// +/// \param to_cycles Timeout in cycles. Convert from time to cycles +/// using the helper functions provided in xos_timer. +/// A value of zero indicates no timeout. +/// +/// \return Returns XOS_OK on success, XOS_ERR_TIMEOUT on timeout, else error code. +/// +/// NOTE: If XOS_OPT_WAIT_TIMEOUT is not enabled, then the timeout value is +/// ignored, and no timeout will occur. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_get_timeout(XosSem * sem, uint64_t to_cycles); + + +//----------------------------------------------------------------------------- +/// +/// Increment the semaphore count. The semaphore must have been initialized. +/// Remember that this action may wake up a waiting thread, and if that thread +/// is higher priority then there will be an immediate context switch. +/// +/// \param sem Pointer to semaphore object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_put(XosSem * sem); + + +//----------------------------------------------------------------------------- +/// +/// Try to decrement the semaphore, but do not block if the semaphore count is +/// zero. Return immediately. The semaphore must have been initialized. +/// +/// \param sem Pointer to semaphore object. +/// +/// \return Returns XOS_OK on success (semaphore decremented), else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_sem_tryget(XosSem * sem); + + +//----------------------------------------------------------------------------- +/// +/// Return the count of the semaphore but do not attempt to decrement it. +/// The semaphore must have been initialized. +/// +/// \param sem Pointer to semaphore object. +/// +/// \return Returns semaphore count, -1 on error. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_sem_test(XosSem * sem) +{ + XOS_ASSERT(sem); + + return sem ? sem->count : -1; +} + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_SEMAPHORE_H__ + diff --git a/components/esp32/include/xtensa/xos_stopwatch.h b/components/esp32/include/xtensa/xos_stopwatch.h new file mode 100755 index 000000000..bf71cc388 --- /dev/null +++ b/components/esp32/include/xtensa/xos_stopwatch.h @@ -0,0 +1,175 @@ +/** @file */ + +// xos_stopwatch.h - XOS Stopwatch objects and related API. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_STOPWATCH_H__ +#define __XOS_STOPWATCH_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "xos_types.h" +#include "xos_params.h" + + +//----------------------------------------------------------------------------- +// A stopwatch object can be used to track elapsed time and accumulate total +// elapsed time over multiple execution periods. The stopwatch records the +// time whenever its start function is called, and stops recording the time +// when the stop function is called and updates its cumulative time counter. +// The stopwatch keeps time in cycles. This can be converted to seconds etc. +// by using the XOS conversion calls such as xos_cycles_to_secs(). +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +/// +/// XosStopwatch object. +/// +//----------------------------------------------------------------------------- +typedef struct XosStopwatch { + uint64_t total; ///< Total accumulated cycle count + uint64_t start; ///< Starting system cycle count + uint16_t active; ///< Active flag (nonzero when active) +} XosStopwatch; + + +//----------------------------------------------------------------------------- +/// +/// Initialize a stopwatch object. +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_stopwatch_init(XosStopwatch * sw) +{ + sw->total = 0; + sw->start = 0; + sw->active = 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Start a stopwatch. Starts cycle counting. +/// Note that this does not necessarily start counting from zero. The current +/// run (start-to-stop interval) will just get added to the accumulated count +/// in the stopwatch if any. +/// To reset the accumulated count, use xos_stopwatch_clear(). +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_stopwatch_start(XosStopwatch * sw) +{ + XOS_ASSERT(!sw->active); + sw->active = 1; + sw->start = xos_get_system_cycles(); +} + + +//----------------------------------------------------------------------------- +/// +/// Stop a stopwatch. Stops cycle counting and updates total. +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_stopwatch_stop(XosStopwatch * sw) +{ + XOS_ASSERT(sw->active); + sw->active = 0; + sw->total += xos_get_system_cycles() - sw->start; +} + + +//----------------------------------------------------------------------------- +/// +/// Get stopwatch accumulated count. +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns the accumulated count. +/// +//----------------------------------------------------------------------------- +static inline uint64_t +xos_stopwatch_count(XosStopwatch * sw) +{ + return sw->total; +} + + +//----------------------------------------------------------------------------- +/// +/// Get elapsed time since stopwatch was started. If not started, returns zero. +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns elapsed time in cycles. +/// +//----------------------------------------------------------------------------- +static inline uint64_t +xos_stopwatch_elapsed(XosStopwatch * sw) +{ + return sw->active ? xos_get_system_cycles() - sw->start : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Clears a stopwatch. Resets the accumulated count to zero, and deactivates +/// it if active. +/// +/// \param sw Pointer to a stopwatch object. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_stopwatch_clear(XosStopwatch * sw) +{ + xos_stopwatch_init(sw); +} + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_STOPWATCH_H__ + diff --git a/components/esp32/include/xtensa/xos_syslog.h b/components/esp32/include/xtensa/xos_syslog.h new file mode 100755 index 000000000..be56968fc --- /dev/null +++ b/components/esp32/include/xtensa/xos_syslog.h @@ -0,0 +1,330 @@ +/** @file */ + +// xos_syslog.h - XOS Event logging module. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_SYSLOG_H__ +#define __XOS_SYSLOG_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +// The XOS system log is an array of fixed size entries. The size of the log +// is determined by the application, and memory for the log must be provided +// at init time. Every time the log function is called, an entry is made in +// the log and the next pointer advanced. When the log is full, it will wrap +// around and start overwriting the oldest entries. +// Logging can be done from C/C++ code as well as assembly code, and at any +// interrupt level, even from high level interrupt handlers. +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +// Defines. +//----------------------------------------------------------------------------- +#define XOS_SYSLOG_ENABLED 0x0001 + + +///---------------------------------------------------------------------------- +/// +/// Use this macro to compute how much memory to allocate for the syslog. +/// +///---------------------------------------------------------------------------- +#define XOS_SYSLOG_SIZE(num_entries) \ + ( sizeof(XosSysLog) + ((num_entries - 1) * sizeof(XosSysLogEntry)) ) + + +///---------------------------------------------------------------------------- +/// +/// System log entry structure. +/// +///---------------------------------------------------------------------------- +typedef struct XosSysLogEntry { + uint32_t timestamp; ///< Timestamp in clock cycles + uint32_t param1; ///< User defined value + uint32_t param2; ///< User defined value + struct XosSysLogEntry * next; ///< Link to next entry +} XosSysLogEntry; + + +///---------------------------------------------------------------------------- +/// +/// System log structure. +/// +///---------------------------------------------------------------------------- +typedef struct XosSysLog { + uint16_t flags; ///< Flags + uint16_t size; ///< Number of entries + XosSysLogEntry * next; ///< Next write position + XosSysLogEntry entries[1]; ///< First entry +} XosSysLog; + + +//----------------------------------------------------------------------------- +// Pointer to syslog area. +//----------------------------------------------------------------------------- +extern XosSysLog * xos_syslog; + + +//---------------------------------------------------------------------------- +/// +/// Initialize the syslog. Initializing the log also enables it. The system +/// log always wraps around when full and overwrites the oldest entries. +/// +/// \param log_mem Pointer to allocated memory for the log. +/// +/// \param num_entries The number of entries that the log can contain. +/// +/// \return Returns nothing. +/// +//---------------------------------------------------------------------------- +static inline void +xos_syslog_init(void * log_mem, uint16_t num_entries) +{ + uint16_t i; + + xos_syslog = (XosSysLog *) log_mem; + xos_syslog->size = num_entries; + xos_syslog->next = xos_syslog->entries; + + for (i = 0; i < num_entries - 1; i++) { + xos_syslog->entries[i].next = &(xos_syslog->entries[i+1]); + xos_syslog->entries[i].timestamp = 0; + } + xos_syslog->entries[i].next = xos_syslog->entries; + xos_syslog->entries[i].timestamp = 0; + + xos_syslog->flags = XOS_SYSLOG_ENABLED; +} + + +///---------------------------------------------------------------------------- +/// +/// Reset the syslog. All entries made up to now are abandoned and the write +/// pointer is set to the first entry location. +/// +/// No parameters. +/// +/// \return Returns nothing. +/// +///---------------------------------------------------------------------------- +static inline void +xos_syslog_clear() +{ +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + + xos_syslog_init(xos_syslog, xos_syslog->size); +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif +} + + +///---------------------------------------------------------------------------- +/// +/// Enable logging to the syslog. This function needs to be called only if +/// logging had been previously disabled via xos_syslog_disable(), since +/// initializing the syslog automatically enables it. +/// +/// No parameters. +/// +/// \return Returns nothing. +/// +///---------------------------------------------------------------------------- +static inline void +xos_syslog_enable() +{ +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + + xos_syslog->flags |= XOS_SYSLOG_ENABLED; +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif +} + + +///---------------------------------------------------------------------------- +/// +/// Disable logging to the syslog. It is sometimes useful to disable logging +/// while the log is being examined or dumped. +/// +/// No parameters. +/// +/// \return Returns nothing. +/// +///---------------------------------------------------------------------------- +static inline void +xos_syslog_disable() +{ +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + xos_syslog->flags &= ~XOS_SYSLOG_ENABLED; +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif +} + + +///---------------------------------------------------------------------------- +/// +/// Write an entry into the syslog. This function does disable all interrupts +/// since logging can be done from interrupt handlers as well. It will write +/// into the log only if the log exists and is enabled. +/// +/// \param param1 User defined value. +/// +/// \param param2 User defined value. +/// +/// \return Returns nothing. +/// +///---------------------------------------------------------------------------- +static inline void +xos_syslog_write(uint32_t param1, uint32_t param2) +{ + if (xos_syslog != XOS_NULL) { +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + + if ((xos_syslog->flags & XOS_SYSLOG_ENABLED) != 0) { + XosSysLogEntry * next = xos_syslog->next; + + next->timestamp = xos_get_ccount(); + next->param1 = param1; + next->param2 = param2; + + xos_syslog->next = next->next; + } + +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif + } +} + + +///---------------------------------------------------------------------------- +/// +/// Read the first (oldest) entry in the syslog. Will return an error if the +/// log has not been created or is empty. Storage to copy the entry must be +/// provided by the caller. +/// +/// \param entry Pointer to storage where the entry data will be +/// copied. This pointer must be passed to +/// xos_syslog_get_next(). +/// +/// \return Returns XOS_OK on success, else error code. +/// +///---------------------------------------------------------------------------- +static inline int32_t +xos_syslog_get_first(XosSysLogEntry * entry) +{ + if (xos_syslog == XOS_NULL) { + return XOS_ERR_NOT_FOUND; + } + + if (entry != XOS_NULL) { +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + XosSysLogEntry * next = xos_syslog->next; + + // 'next' should be pointing to the next entry to be overwritten, if we + // have wrapped. This means it is the oldest entry. However if this entry + // has a zero timestamp then we have not wrapped, in which case we must + // look at the first entry in the list. + if (next->timestamp == 0) { + next = xos_syslog->entries; + } + + *entry = *next; +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif + return entry->timestamp ? XOS_OK : XOS_ERR_NOT_FOUND; + } + + return XOS_ERR_INVALID_PARAMETER; +} + + +///---------------------------------------------------------------------------- +/// +/// Get the next sequential entry from the syslog. This function must be called +/// only after xos_syslog_get_first() has been called. +/// +/// \param entry Pointer to storage where entry data will be copied. +/// Must be the same pointer that was passed in the call +/// to xos_syslog_get_first(), as it is used to keep track +/// of the current position. +/// +/// \return Returns XOS_OK on success, else error code. +/// +///---------------------------------------------------------------------------- +static inline int32_t +xos_syslog_get_next(XosSysLogEntry * entry) +{ + if (entry != XOS_NULL) { +#if XCHAL_HAVE_INTERRUPTS + uint32_t ps = XT_RSIL(XCHAL_NUM_INTLEVELS); +#endif + XosSysLogEntry * next = entry->next; + int32_t ret = XOS_OK; + + // Make sure we're not pointing past the last entry. + if ((next != XOS_NULL) && (next != xos_syslog->next) && (next->timestamp != 0)) { + *entry = *next; + } + else { + ret = XOS_ERR_NOT_FOUND; + } +#if XCHAL_HAVE_INTERRUPTS + xos_restore_int_pri_level(ps); +#endif + return ret; + } + + return XOS_ERR_INVALID_PARAMETER; +} + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_SYSLOG_H__ + diff --git a/components/esp32/include/xtensa/xos_thread.h b/components/esp32/include/xtensa/xos_thread.h new file mode 100755 index 000000000..8bc5077ec --- /dev/null +++ b/components/esp32/include/xtensa/xos_thread.h @@ -0,0 +1,1086 @@ +/** @file */ + +// xos_thread.h - XOS Thread API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_THREAD_H__ +#define __XOS_THREAD_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "xos_types.h" +#include "xos_params.h" + + +//----------------------------------------------------------------------------- +// Number of thread priority levels. +//----------------------------------------------------------------------------- +#ifndef XOS_NUM_PRIORITY +#error "XOS_NUM_PRIORITY must be defined (in xos_params.h)." +#endif +#if XOS_NUM_PRIORITY > 32 +#error "The number of thread priority levels (XOS_NUM_PRIORITY) must be <= 32." +#endif +#define XOS_MAX_PRIORITY (XOS_NUM_PRIORITY) + + +//----------------------------------------------------------------------------- +// Macro for thread self pointer. +//----------------------------------------------------------------------------- +#define XOS_THREAD_SELF (xos_thread_id()) + + +//----------------------------------------------------------------------------- +/// +/// Thread entry function pointer type. +/// +//----------------------------------------------------------------------------- +typedef int32_t (XosThreadFunc)(void * arg, int32_t wake_value); + + +//----------------------------------------------------------------------------- +// Thread switcher function signature. +//----------------------------------------------------------------------------- +typedef struct XosThread XosThread; +typedef int32_t (XosSwitchFunc)(XosThread *); + + +//----------------------------------------------------------------------------- +/// +/// Condition evaluation callback function pointer type. +/// +//----------------------------------------------------------------------------- +typedef int32_t (XosCondFunc)(void * arg, int32_t sig_value, XosThread * thread); + + +//----------------------------------------------------------------------------- +/// +/// Thread exit handler function pointer type. +/// +//----------------------------------------------------------------------------- +typedef int32_t (XosThdExitFunc)(int32_t exitcode); + + +//----------------------------------------------------------------------------- +// Thread queue structure. Used to implement the ready queues as well +// as the wait queues. +//----------------------------------------------------------------------------- +typedef struct XosThreadQueue { + XosThread * head; // Pointer to first thread in queue, or 0 if none. + XosThread ** tail; // Pointer to last thread's r_next pointer, or + // to "head" if none. +} XosThreadQueue; + + +//----------------------------------------------------------------------------- +// Stack frame for a thread that is not running. That is, it has either +// been preempted or has yielded. +//----------------------------------------------------------------------------- +typedef union XosFrame { + XosExcFrame e; // resume_fn == &xos_resume_preempted_thread + XosCoopFrame c; // resume_fn == &xos_resume_cooperative_thread + // nothing for resume_fn == &xos_resume_idle_thread + // nothing for resume_fn == &xos_resume_by_restart +} XosFrame; + + +//----------------------------------------------------------------------------- +// Thread Control Block. Tracks the state and control information associated +// with a thread. +// +// IMPORTANT: keep this in sync with TCB_*** offsets in xos_common.h . +//----------------------------------------------------------------------------- +struct XosThread { + XosThread * r_next; // 00 Next thread in queue (eg. ready queue of + // its priority, or some queue of blocked threads) + // Should be NULL if not in any queue. + + XosThread ** r_pprev; // 04 Points to previous queue entry's r_next + // pointer (i.e. to itself), or to queue head + // if first in queue. NULL if not in any queue. + + XosThread * all_next; // 08 Next in list of all threads. + + void * resume_fn; // 12 Pointer to the routine to be called to + // resume this thread. On entry to such code: + // a2 == xos_curr_threadptr (thread being resumed) + // a3 == &xos_globals + + XosFrame * esf; // 16 Pointer to saved exception stack frame, + // just below thread's current stack pointer. + // For RTC threads, this is valid only while the + // thread is preempted, not when it is blocked. + + void * tie_save; // 20 TIE state save area. May be NULL if there + // is not TIE state saved for this thread. + + int32_t wake_value; // 24 Value returned from block call (by wake call) + // (for RTC: pass this to start function??) + + XosSwitchFunc * switch_fn; // 28 Pointer to a function that + // can be called from within this thread, to save + // this thread's state and switch to a specified + // other thread. Returns wake value. + + void * stack_base; // 32 Base of stack as specified by thread creator. + + void * stack_end; // 36 End of stack (adjusted for TIE state save area + // if any). + + XosThreadFunc * entry; // 40 Pointer to thread entry function. Used for + // RTC thread restart. + + void * arg; // 44 Argument value passed to entry function. + + bool ready; // 48 Set when thread is ready to run, and is in + // its priority queue (i.e. r_pprev is set when + // this flag is set). + + bool in_exit; // Exit flag, nonzero when in exit processing. + + int8_t priority; // Thread priority, 0 .. (XOS_MAX_PRI - 1). Higher + // numbers have higher priority. This must only be + // changed when thread is not ready, or by calling + // xos_thread_set_priority(). + + int8_t preempt_pri; // This thread's preemption blocking priority. + // (preempt_pri >= priority). A thread's priority + // must be higher than another's preempt_pri to be + // able to preempt it. Note that preempt_pri can + // change during runtime e.g. due to priority + // inheritance. + + uint32_t flags; // 52 Thread creation flags. + + const char * name; // 56 Thread name (mainly for debug). + + const char * block_cause; // 60 Reason for blocking. Valid only when thread + // not ready (r_pprev == 0). + + XosThread * container; // 64 Thread whose stack will be used to run + // this thread. Valid for RTC threads only, else NULL. + + XosThdExitFunc * exit_func; // 68 Thread exit handler function pointer. + + XosThreadQueue exit_waiters; // 72 Queue of threads waiting for this one to exit. + + XosThreadQueue * wq_ptr; // 80 If this thread is in a wait queue, this + // points to the queue. Must be NULL when + // thread not in a queue. + + XosCondFunc * cond_fn; // 84 Condition function. Valid only while thread + // is blocked on condition. + + void * cond_arg; // 88 Argument to be passed to condition function. + + uint16_t cp_mask; // 92 Mask of coprocessors used. + uint16_t cp_saved; // 94 Mask of coprocessors saved. + + uint32_t event_bits; // 96 event bits + uint32_t event_mask; // 100 event bit mask + uint32_t event_flags; // 104 event flags + + void * clib_ptr; // 108 Pointer to C lib context struct. + + uint32_t sig; // 112 Signature of valid TCB + + uint32_t resume_ccount; // 116 cycle count at resume + uint64_t cycle_count; // 120 number of cycles consumed (approx). + // NOTE: must be 8-byte aligned + uint32_t normal_resumes; // 128 Number of non-preemptive resumptions. + uint32_t preempt_resumes;// 132 Number of preemptive resumptions. + +#if XOS_OPT_THREAD_SAFE_CLIB + CLIB_THREAD_STRUCT; // C library context area. +#endif +}; + + +//----------------------------------------------------------------------------- +// User-visible flags for xos_thread_create(). +//----------------------------------------------------------------------------- +#define XOS_THREAD_SUSPEND 0x0001 ///< Create suspended instead of ready +#define XOS_THREAD_RTC 0x0002 ///< Run-to-completion thread +#define XOS_THREAD_NO_CP 0x0004 ///< Thread does not use coprocessors + + +//----------------------------------------------------------------------------- +// Flags used by thread creation extra parameters. +//----------------------------------------------------------------------------- +#define XOS_TP_COPROC_MASK 0x0001 +#define XOS_TP_PREEMPT_PRI 0x0002 +#define XOS_TP_EXIT_HANDLER 0x0004 + + +//----------------------------------------------------------------------------- +// Thread creation extra parameters. +//----------------------------------------------------------------------------- +typedef struct XosThreadParm { + uint32_t parms_mask; // Combination of XOS_TP_xxx flags indicating + // which parameters are valid. + + uint16_t cp_mask; // Mask of coprocessors the thread can access. + + uint32_t preempt_pri; // Initial preemption blocking priority. Can be + // changed later via xos_thread_set_priority(). + + XosThdExitFunc * handler; // Exit handler function. + +} XosThreadParm; + + +//----------------------------------------------------------------------------- +// Wrapper struct for RTC (run to completion) thread. +//----------------------------------------------------------------------------- +typedef struct XosRtcThread { + struct XosThread thread; +} XosRtcThread; + + +//----------------------------------------------------------------------------- +// External variables. +//----------------------------------------------------------------------------- +extern XosThread * xos_curr_threadptr; // Current active thread +extern XosThread * xos_next_threadptr; // Next ready thread +extern XosThread * xos_all_threads; // List of all threads + + +//----------------------------------------------------------------------------- +/// +/// Set thread creation parameter: the group of coprocessors that this thread +/// will use. This must be set during thread creation, and cannot be changed +/// after the thread has been created. Defining this allows reduction of +/// memory usage (for CP state saving) in some circumstances, and can also +/// speed up the context switch time. +/// +/// NOTE: Support for this is not currently implemented. If a thread uses +/// any coprocessor, space for all coprocessors must be reserved. +/// +/// \param parms Thread creation parameter structure. Must be +/// allocated by the caller. +/// +/// \param cp_mask Bitmask of coprocessors thread is allowed to +/// use. Bit 0 for coprocessor 0, etc. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_threadp_set_cp_mask(XosThreadParm * parms, uint16_t cp_mask) +{ + if (parms != XOS_NULL) { + parms->parms_mask |= XOS_TP_COPROC_MASK; + parms->cp_mask = cp_mask; + } +} + + +//----------------------------------------------------------------------------- +/// +/// Set thread creation parameter: thread pre-emption priority. +/// +/// \param parms Thread creation parameter structure. Must be +/// allocated by caller. +/// +/// \param preempt_pri Thread pre-emption blocking priority. +/// From 0 .. XOS_NUM_PRIORITY - 1. +/// Must be greater or equal to the thread priority +/// (if not, is automatically set to thread priority). +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_threadp_set_preemption_priority(XosThreadParm * parms, int8_t preempt_pri) +{ + if (parms != XOS_NULL) { + parms->parms_mask |= XOS_TP_PREEMPT_PRI; + parms->preempt_pri = preempt_pri; + } +} + + +//----------------------------------------------------------------------------- +/// +/// Set thread creation parameter: thread exit handler. +/// +/// \param parms Thread creation parameter structure. Must be +/// allocated by caller. +/// +/// \param handler Exit handler function. +/// +/// \return Returns nothing. +//----------------------------------------------------------------------------- +static inline void +xos_threadp_set_exit_handler(XosThreadParm * parms, XosThdExitFunc * handler) +{ + if (parms != XOS_NULL) { + parms->parms_mask |= XOS_TP_EXIT_HANDLER; + parms->handler = handler; + } +} + + +//----------------------------------------------------------------------------- +/// +/// Create a new thread. If the thread is not created suspended, then it will +/// be made ready as soon as it is created, and will immediately run if it is +/// the highest priority non-blocked thread in the system. +/// +/// \param thread Pointer to the thread descriptor (an otherwise +/// unused XosThread structure, usually allocated +/// by the caller for the lifetime of the thread, +/// for example as a global variable). +/// +/// \param container Pointer to separate thread acting as "container" +/// for this one. At the moment, this is only meaningful +/// for run-to-completion (RTC) threads (identified with +/// the XOS_THREAD_RTC flag), in which case the container +/// must have the same priority and also be an RTC thread. +/// (The priority restriction may be lifted in a future +/// implementation, with appropriate constraints on dynamic +/// reprioritization of the created thread). +/// +/// \param entry Thread entry function, takes one argument. +/// +/// \param arg Argument "void*" that is passed to the thread function. +/// +/// \param name Unique name of the thread, for debug/display purposes. +/// This string must be valid for the lifetime of the thread +/// (only a pointer to it is stored in the thread control block). +/// Typically consists of identifier chars with no spaces. +/// +/// \param stack Base of initial stack for the thread, allocated by the +/// caller. Need not be aligned (initial stack pointer will be +/// computed and aligned from given stack base and size). +/// Required argument, except for run-to-completion threads +/// when container is non-NULL, in which case the container's +/// stack is used and this argument must be NULL. +/// +/// \param stack_size Size of the stack, in bytes. +/// NOTE: stack should be at least XOS_STACK_EXTRA bytes plus +/// whatever the thread actually needs if the thread will use +/// coprocessors/TIE state. If the thread will not touch the +/// coprocessors, then it should be XOS_STACK_EXTRA_NO_CP +/// plus whatever the thread actually needs. +/// Recommended minimum stack sizes are defined by the constants +/// XOS_STACK_MIN_SIZE and XOS_STACK_MIN_SIZE_NO_CP. +/// +/// For run-to-completion threads where container is non-NULL, +/// stack_size specifies the minimum stack size required for +/// the thread; it should be smaller or equal to the container's +/// stack. +/// +/// \param priority Initial thread priority. From 0 .. XOS_MAX_PRI - 1. +/// Higher numbers are higher priority. +/// +/// \param parms Pointer to extra parameters structure, or 0 if none given. +/// Use xos_thread_p_***() functions to set parameters in the +/// structure. +/// +/// \param flags Option flags: +/// - XOS_THREAD_SUSPEND -- Leave thread suspended instead of +/// making it ready. The thread can be made ready to run later +/// by calling xos_thread_resume(). +/// - XOS_THREAD_RTC -- Run-to-completion thread. +/// - XOS_THREAD_NO_CP -- Thread does not use coprocessors. +/// No coprocessor state will be saved for this thread. +/// Threads that have this flag set will not allocate any +/// storage for saving coprocessor state and so can have +/// smaller stacks. +/// +/// NOTE: xos_start_main() calls xos_thread_create() to convert main() into the 'main' +/// thread. +/// +/// \return Returns XOS_OK if successful, error code otherwise. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_create(XosThread * thread, + XosThread * container, + XosThreadFunc * entry, + void * arg, + const char * name, + void * stack, + uint32_t stack_size, + int32_t priority, + XosThreadParm * parms, + uint32_t flags ); + + +//----------------------------------------------------------------------------- +/// +/// Remove thread and free up all resources. Thread must have exited already. +/// After this call returns, all resources allocated to the thread (e.g. TCB, +/// stack space, etc.) can be reused. +/// +/// \param thread Handle of thread to be deleted. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: A thread cannot call this on itself. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_delete(XosThread * thread); + + +//----------------------------------------------------------------------------- +/// +/// Force the thread to terminate. The thread execution is aborted, but exit +/// processing will still happen, i.e. the exit handler (if any) will be run. +/// After termination, any other threads waiting on this thread are notified. +/// This function cannot be called on the current thread. +/// +/// \param thread Handle of thread to be aborted. +/// +/// \param exitcode Exit code returned to any waiting threads. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: If the thread is blocked waiting for something, the wait is aborted +/// and the thread is made ready. +/// NOTE: The thread is not guaranteed to have exited when this call returns. +/// It will be made ready and set up for exit processing, but when the exit +/// processing will actually happen depends on the state of the system and +/// the priority of the thread being aborted. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_abort(XosThread * thread, int32_t exitcode); + + +//----------------------------------------------------------------------------- +/// +/// Exit the current thread. The exit handler (if any) will be run before the +/// thread terminates. +/// +/// \param exitcode Exit code to be returned to any waiting threads. +/// +/// \return This function does not return. +/// +/// NOTE: This is automatically called if the thread returns from its entry +/// function. The entry function's return value will be passed as the exit +/// code. +/// +//----------------------------------------------------------------------------- +void +xos_thread_exit(int32_t exitcode); + + +//----------------------------------------------------------------------------- +/// +/// Wait until the specified thread exits and get its exit code. If the thread +/// has exited already, an error will be returned. +/// +/// \param thread The thread to wait for. Cannot be "self", i.e. +/// one cannot wait on one's own exit. +/// +/// \param p_exitcode If not null, the exit code will be returned here. +/// +/// \return Returns XOS_OK on sucess, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_join(XosThread * thread, int32_t * p_exitcode); + + +//----------------------------------------------------------------------------- +/// +/// Yield the CPU to the next thread in line. The calling thread remains ready +/// and is placed at the tail of the ready queue at its current priority level. +/// If there are no threads at the same priority level that are ready to run, +/// then this call will return immediately. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_thread_yield(); + + +//----------------------------------------------------------------------------- +/// +/// Suspend the specified thread. The thread will remain suspended until +/// xos_thread_resume() has been called on it. If the thread is already blocked +/// on some other condition, then this function will return an error. +/// +/// \param thread Handle of thread being suspended. A thread can +/// use the special handle XOS_THREAD_SELF to suspend +/// itself. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_suspend(XosThread * thread); + + +//----------------------------------------------------------------------------- +/// +/// Resume a suspended thread. If the thread is not suspended or is blocked on +/// some other condition then this function will do nothing. Otherwise, it will +/// be made ready, and this can cause an immediate context switch if the thread +/// is at a higher priority than the calling thread. +/// +/// \param thread Handle of thread being resumed. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_resume(XosThread * thread); + + +//----------------------------------------------------------------------------- +/// +/// Get the priority of the specified thread. This returns the priority of the +/// queried thread at this instant, however this can change at any time due to +/// other activity in the system. +/// +/// \param thread Handle of thread being queried. A thread can use +/// the special handle XOS_THREAD_SELF to query itself. +/// +/// \return Returns the thread's current priority, or -1 if the thread handle +/// is not valid. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_thread_get_priority(XosThread * thread) +{ + XOS_ASSERT(thread); + return thread ? thread->priority : -1; +} + + +//----------------------------------------------------------------------------- +/// +/// Set the priority of the specified thread. The thread must exist. +/// +/// \param thread Handle of thread being affected. A thread can +/// use the special handle XOS_THREAD_SELF to specify +/// itself. +/// +/// \param priority The new priority level to be set. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: Calling this function can result in a scheduler activation, and the +/// caller may be suspended as a result. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_set_priority(XosThread * thread, int32_t priority); + + +//----------------------------------------------------------------------------- +/// +/// Return the name of the specified thread. +/// +/// \param thread Handle of thread being queried. A thread can use +/// the special handle XOS_THREAD_SELF to specify +/// itself. +/// +/// \return Returns a pointer to the name string if available, else NULL. +/// +//----------------------------------------------------------------------------- +static inline const char * +xos_thread_get_name(XosThread * thread) +{ + XOS_ASSERT(thread); + return thread ? thread->name : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Set the name of the specified thread. +/// +/// \param thread Handle of thread whose name is to be set. A thread +/// can use the special handle XOS_THREAD_SELF to specify +/// itself. +/// +/// \param name Pointer to the new name string. The string is not +/// copied, only the pointer is saved. So the string +/// must be persistent for the life of the thread. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_thread_set_name(XosThread * thread, const char * name) +{ + XOS_ASSERT(thread); + if (thread != XOS_NULL) { + thread->name = name; + return XOS_OK; + } + + return XOS_ERR_INVALID_PARAMETER; +} + + +//----------------------------------------------------------------------------- +/// +/// Set an exit handler for the specified thread. The exit handler is run when +/// the thread terminates, either by calling xos_thread_exit() or by returning +/// from its entry function. It will also be called if the thread is being +/// terminated due to e.g. an unhandled exception. +/// +/// The handler must be a function defined as e.g.: +/// +/// int32_t exit_handler(int32_t exitcode); +/// +/// The exit handler runs in the context of the exiting thread, and can call +/// system services. It is provided with a single parameter which is the +/// thread's exit code (the exit code may be set to an error code if the +/// thread is being terminated due to an error or exception). The handler +/// must return a value which will be set as the thread's exit code. +/// +/// \param thread Handle of the thread for which the handler is +/// to be installed. A thread can use the special +/// handle XOS_THREAD_SELF to specify itself. +/// +/// \param func Pointer to exit handler function. To clear an +/// existing handler, pass NULL as the pointer. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_set_exit_handler(XosThread * thread, XosThdExitFunc * func); + + +//----------------------------------------------------------------------------- +/// +/// Return the ID (handle) of the current thread. +/// +/// \return Returns the handle of the current thread. This handle can be +/// used in all XOS system calls. +/// +/// NOTE: If called from interrupt context, returns the handle of the thread +/// that was preempted. +/// +//----------------------------------------------------------------------------- +static inline XosThread * +xos_thread_id() +{ + return xos_curr_threadptr; +} + + +//----------------------------------------------------------------------------- +/// +/// Return the coprocessor mask for the specified thread. +/// +/// \param thread Handle of thread being queried. +/// +/// \return Returns the mask for the specified thread if available, else 0. +/// +//----------------------------------------------------------------------------- +static inline uint16_t +xos_thread_cp_mask(XosThread * thread) +{ + XOS_ASSERT(thread); + return thread ? thread->cp_mask : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Return the wake value for the specified thread. +/// +/// \return thread Handle of thread being queried. +/// +/// \return Returns The last set wake value. There is no way to detect what +/// action set the wake value and when. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_thread_get_wake_value(XosThread * thread) +{ + XOS_ASSERT(thread); + return thread ? thread->wake_value : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Return the current value of the event bits for the current thread. +/// This function takes no parameters. +/// +/// \return Returns the current value of the event bits. The event bits +/// are set when the thread is woken from an event wait. They will +/// not change while the thread is running. There is no way to +/// determine when the event bits were last updated. +/// +//----------------------------------------------------------------------------- +static inline uint32_t +xos_thread_get_event_bits(void) +{ + XosThread * thread = xos_thread_id(); + return thread ? thread->event_bits : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Enum values for thread state. +/// +//----------------------------------------------------------------------------- +typedef enum xos_thread_state_t { + XOS_THREAD_STATE_INVALID = 0, ///< Invalid thread + XOS_THREAD_STATE_BLOCKED, ///< Thread is blocked + XOS_THREAD_STATE_READY, ///< Thread is ready to run + XOS_THREAD_STATE_RUNNING, ///< Thread is running + XOS_THREAD_STATE_EXITED, ///< Thread has exited +} xos_thread_state_t; + + +//----------------------------------------------------------------------------- +/// +/// Return the state of the specified thread. +/// +/// \param thread Handle of thread being queried. +/// +/// \return Returns one of the following values: +/// - XOS_THREAD_STATE_RUNNING -- The thread is currently running. +/// - XOS_THREAD_STATE_READY -- The thread is ready to run. +/// - XOS_THREAD_STATE_BLOCKED -- The thread is blocked on something. +/// - XOS_THREAD_STATE_INVALID -- The thread handle is invalid. +/// - XOS_THREAD_STATE_EXITED -- The thread has exited. +/// +//----------------------------------------------------------------------------- +xos_thread_state_t +xos_thread_get_state(XosThread * thread); + + +//----------------------------------------------------------------------------- +/// +/// Disable thread preemption. Prevents context switching to another thread. +/// However, interrupt handlers will still continue to be run. Multiple calls +/// will nest, and the same number of calls to xos_preemption_enable() will be +/// required to re-enable preemption. If the calling thread yields the CPU or +/// exits without enabling preemption, it will cause a system halt. +/// If the calling thread encounters a fatal error, preemption will be enabled +/// during fatal error handling. +/// +/// \return Returns the new value of preemption disable flag after this call. +/// +/// NOTE: Cannot be called from interrupt context. +/// +//----------------------------------------------------------------------------- +uint32_t +xos_preemption_disable(void); + + +//----------------------------------------------------------------------------- +/// +/// Enable thread preemption. Has no effect if preemption was already enabled. +/// Otherwise, it decrements the value of the preemption disable flag and if +/// the value goes to zero, enables preemption. +/// +/// \return Returns the new value of preemption disable flag after this call. +/// +/// NOTE: If scheduling gets enabled, it may cause an immediate context switch +/// if higher priority threads are ready. +/// +//----------------------------------------------------------------------------- +uint32_t +xos_preemption_enable(void); + + +//----------------------------------------------------------------------------- +/// +/// Initialize XOS thread support and start scheduler. +/// +/// Must be called from main() before calling any other thread function. +/// This function initializes thread support, creates the idle thread, and +/// starts the scheduler. It does not return to its caller. This means that +/// at least one user thread must be created before calling xos_start(). +/// Otherwise, the scheduler will run the idle thread since it will be the +/// only thread in the system, and no other thread can be created. +/// +/// NOTE: This function does not initialize timer/tick support. For timer +/// services to be available xos_start_system_timer() must be called. +/// +/// NOTE: xos_start() and xos_start_main() are exclusive, both cannot be +/// called within the same application. +/// +/// \param flags Currently unused (pass 0). +/// +/// \return Does not return. +/// +//----------------------------------------------------------------------------- +void +xos_start(uint32_t flags); + + +//----------------------------------------------------------------------------- +/// +/// Initialize XOS thread support and create init (main) thread. +/// +/// Must be called from main() before calling any other thread function. +/// This function converts the caller into the 'main' or 'init' thread, and +/// returns to the caller after completing initialization. +/// +/// NOTE: This function does not initialize timer/tick support. For timer +/// services to be available xos_start_system_timer() must be called. +/// +/// NOTE: xos_start_main() and xos_start() are exclusive, both cannot be +/// called within the same application. +/// +/// \param name Name of main thread (see xos_thread_create()). +/// +/// \param priority Initial priority of main thread. +/// +/// \param flags Currently unused (pass 0). +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +void +xos_start_main(const char * name, int8_t priority, uint32_t flags); + + +//----------------------------------------------------------------------------- +/// +/// Per-thread stats structure. +/// Note that the CPU use % is approximate, both because of cycle counting +/// and because of integer division. So all the threads' CPU % will not add +/// up to exactly 100%. +/// +//----------------------------------------------------------------------------- +typedef struct XosThreadStats { + XosThread * thread; ///< Thread handle (or pseudo-handle) + uint32_t cpu_pct; ///< CPU use % for this thread + uint32_t normal_switches; ///< Number of non-preemptive switches. + uint32_t preempt_switches; ///< Number of preemptive switches. + uint64_t cycle_count; ///< Number of cycles consumed. +} XosThreadStats; + + +//----------------------------------------------------------------------------- +// Thread pseudo-handles. +//----------------------------------------------------------------------------- +#define XOS_THD_STATS_IDLE ((XosThread *) 1) +#define XOS_THD_STATS_INTR ((XosThread *) 2) + + +//----------------------------------------------------------------------------- +/// +/// Get the thread statistics for the specified thread. Statistics are only +/// available if XOS_OPT_STATS has been enabled. Otherwise, the function +/// will return XOS_OK, but the structure contents will be undefined. +/// +/// \param thread Handle of thread being queried. The following +/// special pseudo-handles can be used: +/// - XOS_THD_STATS_IDLE -- stats for idle thread +/// - XOS_THD_STATS_INTR -- stats for interrupt processing +/// +/// \param stats Pointer to XosThreadStats struct to be filled in. +/// +/// \return Returns XOS_OK on success, else error code. +/// +/// NOTE: Can be called from interrupt context. +/// NOTE: This call will not fill in the "thread" and "cpu_pct" fields in the +/// "stats" structure. The thread handle is already known, and calculating the +/// CPU loading can take quite a bit of time so is not done here. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_get_stats(XosThread * thread, XosThreadStats * stats); + + +//----------------------------------------------------------------------------- +/// +/// Get CPU loading statistics for the system. This function computes the CPU +/// percentage use for all threads in the system (including the idle thread and +/// the 'interrupt thread' (interrupt context). It also returns the cycle count +/// and number of context switches for each thread. +/// Statistics are only available if XOS_OPT_STATS has been enabled. +/// Otherwise, the function will return XOS_OK, but the structure contents will +/// be undefined. +/// +/// IMPORTANT: The entry for interrupt context does not contain a real thread +/// handle. It uses the pseudo-handle XOS_THD_STATS_INTR to indicate that this +/// entry reports interrupt statistics. This pseudo-handle cannot be used for +/// any other thread operations or queries. +/// +/// NOTE: This function disables interrupts while traversing the thread list. +/// It does not leave interrupts disabled during the computations, as that can +/// take a fair amount of time. +/// +/// \param stats Pointer to an array of XosThreadStats structures. +/// The array must be large enough to accommodate all +/// threads in the system. +/// +/// \param size The number of elements available in the array. If +/// this is smaller than the number of threads plus one +/// (for the interrupt context) then XOS_ERR_INVALID_PARAMETER +/// will be returned and '*size' will be set to the +/// minimum number of elements required. On a successful +/// return, '*size' is set to the number of elements +/// actually filled in. +/// +/// \param reset If nonzero, then thread stats counters are reset +/// after reading. This is useful if you want to track +/// the stats so as to get a better idea of current +/// system loading. E.g. calling this function once a +/// second with 'reset' nonzero will provide CPU load +/// information for the last second on each call. +/// +/// \return Returns XOS_OK on success, else error code. In particular, +/// XOS_ERR_INVALID_PARAMETER will be returned if the output buffer +/// is too small. +/// +//----------------------------------------------------------------------------- +int32_t +xos_get_cpu_load(XosThreadStats * stats, int32_t * size, int32_t reset); + + +#ifdef _XOS_INCLUDE_INTERNAL_ + +// Signature of valid thread object +#define XOS_THREAD_SIG 0x54485244 + + +// Extern functions +void +xos_init(void); + +bool +xos_init_done(void); + +bool +xos_started(void); + +int32_t +xos_schedule(XosThread * curr_thread); + +void +xos_q_remove(XosThreadQueue * queue, XosThread * thread); + +XosThread * +xos_q_pop(XosThreadQueue * queue); + +int32_t +xos_wake_queue(XosThreadQueue * queue, const char * expected_cause, int32_t wake_value); + +// Well known block causes +extern const char * const xos_blkon_idle; // (for idle thread only) +extern const char * const xos_blkon_suspend; +extern const char * const xos_blkon_delay; +extern const char * const xos_blkon_exited; +extern const char * const xos_blkon_join; +extern const char * const xos_blkon_event; +extern const char * const xos_blkon_condition; +extern const char * const xos_blkon_mutex; +extern const char * const xos_blkon_sem; +extern const char * const xos_blkon_msgq; + + +//----------------------------------------------------------------------------- +// Blocks the current active thread. +// +// Currently, this can be called from an interrupt handler to block the thread +// that was interrupted. Note that in interrupt context the current thread can +// already be in the blocked state, due to a previous call to this function. +// Can be called with interrupts enabled. +// +// block_cause Reason for blocking. +// +// block_queue Queue on to which this thread should be pushed once it +// is blocked. Can be NULL. +// +// must_schedule If nonzero, then forces a scheduling operation to pick +// the next thread to run, even if there are ready threads +// at the same priority level as the blocked thread. +// +// use_priority If nonzero, then the blocked thread will be queued in +// priority order in the specified block queue. If zero, +// the thread is queued in FIFO order. If no queue has +// been specified, this parameter is ignored. +// +// Returns: The value passed by xos_thread_wake(). +//----------------------------------------------------------------------------- +int32_t +xos_block(const char * block_cause, + XosThreadQueue * block_queue, + int32_t must_schedule, + int32_t use_priority); + + +//----------------------------------------------------------------------------- +// Unblocks the specified blocked thread and puts it at the tail end of its +// ready queue. Schedules it if it is higher priority than the current thread. +// No effect if the thread is not blocked with the specified cause. +// +// thread The thread to wake up (make ready). +// +// expected_cause The expected block cause of the thread. Thread will be +// woken only if its block cause matches this cause, or if +// expected_cause is zero. +// +// wake_value The value to be passed to the woken thread as a return +// value from xos_thread_block(). +// +// Returns: nothing. +// +// The target thread can be woken at a different priority by changing its +// priority while the thread is blocked. +// Can be called with interrupts enabled. Can be called in interrupt context. +//----------------------------------------------------------------------------- +void +xos_thread_wake(XosThread * thread, const char * expected_cause, int32_t wakevalue); + + +//----------------------------------------------------------------------------- +// Function to init C library per-thread and reentrancy support. +//----------------------------------------------------------------------------- +#if XOS_OPT_THREAD_SAFE_CLIB +void +xos_clib_init(void); + +void +xos_clib_thread_init(XosThread * thread); + +void +xos_clib_thread_cleanup(XosThread * thread); +#endif + +#endif + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_THREAD_H__ + diff --git a/components/esp32/include/xtensa/xos_timer.h b/components/esp32/include/xtensa/xos_timer.h new file mode 100755 index 000000000..0d89a2192 --- /dev/null +++ b/components/esp32/include/xtensa/xos_timer.h @@ -0,0 +1,592 @@ +/** @file */ + +// xos_timer.h - XOS Timer API interface and data structures. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_TIMER_H__ +#define __XOS_TIMER_H__ + +#include "xos_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +//----------------------------------------------------------------------------- +/// +/// Function pointer type for timer callbacks. +/// +//----------------------------------------------------------------------------- +typedef void (XosTimerFunc)(void * arg); + + +//----------------------------------------------------------------------------- +/// +/// Timer event structure. Used to track pending timer events. +/// +//----------------------------------------------------------------------------- +typedef struct XosTimer { + struct XosTimer * next; ///< Pointer to next event in list. + uint64_t when; ///< Time (clock cycles) at which to trigger. + uint64_t delta; ///< Delta for next re-trigger, 0 if none. + XosTimerFunc * fn; ///< Function to call when timer expires. + void * arg; ///< Argument to pass to called function. + bool active; ///< Set if active (in some list of events). +#if XOS_OPT_TIMER_WAIT + XosThreadQueue waitq; ///< Queue of threads waiting on this timer. +#endif +#if XOS_TIMER_DEBUG + uint32_t signature; +#endif +} XosTimer; + + +//----------------------------------------------------------------------------- +// Extern declarations. +//----------------------------------------------------------------------------- + +// System clock frequency in cycles per second. +extern uint32_t xos_clock_freq; + + +///@{ +//----------------------------------------------------------------------------- +// Functions to convert from clock cycles to time units and vice versa. +// +// Note that these are integer conversions so for example a cycle count of less +// than one second will convert to zero seconds. +//----------------------------------------------------------------------------- + +/// Converts CPU cycles to time in seconds. +/// +/// \param cycles Number of CPU cycles. +/// +/// \return Equivalent number of seconds (truncated to integer). +static inline uint64_t +xos_cycles_to_secs(uint64_t cycles) +{ + return cycles / xos_clock_freq; +} + +/// Converts CPU cycles to time in milliseconds. +/// +/// \param cycles Number of CPU cycles. +/// +/// \return Equivalent number of milliseconds (truncated to integer). +static inline uint64_t +xos_cycles_to_msecs(uint64_t cycles) +{ + return (cycles * 1000) / xos_clock_freq; +} + +/// Converts CPU cycles to time in microseconds. +/// +/// \param cycles Number of CPU cycles. +/// +/// \return Equivalent number of microseconds (truncated to integer). +static inline uint64_t +xos_cycles_to_usecs(uint64_t cycles) +{ + return (cycles * 1000000) / xos_clock_freq; +} + +/// Converts time in seconds to CPU cycle count. +/// +/// \param secs Number of seconds. +/// +/// \return Equivalent number of CPU cycles. +static inline uint64_t +xos_secs_to_cycles(uint64_t secs) +{ + return secs * xos_clock_freq; +} + +/// Converts time in milliseconds to CPU cycle count. +/// +/// \param msecs Number of milliseconds. +/// +/// \return Equivalent number of CPU cycles. +static inline uint64_t +xos_msecs_to_cycles(uint64_t msecs) +{ + return (msecs * xos_clock_freq) / 1000; +} + +/// Converts time in microseconds to CPU cycle count. +/// +/// \param usecs Number of microseconds. +/// +/// \return Equivalent number of CPU cycles. +static inline uint64_t +xos_usecs_to_cycles(uint64_t usecs) +{ + return (usecs * xos_clock_freq) / 1000000; +} +///@} + + +//----------------------------------------------------------------------------- +/// +/// Set system clock frequency. This is expected to be set only once, and only +/// if the clock frequency is not known at compile time. +/// +/// \param freq Frequency in cycles per second. +/// +/// \return Returns nothing. +/// +//----------------------------------------------------------------------------- +static inline void +xos_set_clock_freq(uint32_t freq) +{ + xos_clock_freq = freq; +} + + +//----------------------------------------------------------------------------- +/// +/// Get current system clock frequency. +/// +/// \return Returns current system clock frequency in cycles per second. +/// +//----------------------------------------------------------------------------- +static inline uint32_t +xos_get_clock_freq() +{ + return xos_clock_freq; +} + + +//----------------------------------------------------------------------------- +/// +/// Initialize timer support and start the system timer. +/// This function must be called before calling any other timer function. +/// +/// NOTE: The smaller the tick period, the more precisely delays can be +/// specified using timers. However, we also need to make the tick period +/// large enough to allow time both to execute the tick timer interrupt handler +/// and for the application to make reasonable forward progress. If tick_period +/// is too small, the timer interrupt may re-trigger before the timer interrupt +/// handler has returned to the application, thus keeping the processor busy in +/// constantly executing the timer interrupt handler without leaving any cycles +/// for the application. Or, the application might get some cycles but only a +/// fraction of what is spent in the timer interrupt handler, thus severely +/// impacting application performance. +/// +/// The exact number of cycles needed to execute the timer interrupt handler +/// is not specified here. It depends on many factors (e.g. use of caches, +/// various processor configuration options, etc) and can vary by orders of +/// magnitude. Also note that the time to execute this handler is variable: +/// when timers expire upon a given tick timer interrupt, their respective +/// timer handler functions are called from within the interrupt handler. +/// +/// \param timer_num Which Xtensa timer to use (0..2). This timer +/// must exist and be configured at level 1 or at a +/// medium-priority interrupt level (<=EXCM_LEVEL). +/// If 'timer_num' is -1, then this function will +/// automatically choose the highest priority timer +/// that is suitable for use. This value will be +/// passed to xos_system_timer_select(). +/// +/// \param tick_period Number of clock (CCOUNT) cycles between ticks. +/// Must range between 0 and UINT32_MAX. +/// Zero is used to specify dynamic tick (tickless) +/// mode. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_start_system_timer(int32_t timer_num, uint32_t tick_period); + + +//----------------------------------------------------------------------------- +/// +/// Get the timer number of the system timer. Useful mainly when XOS has been +/// allowed to choose its own timer via xos_start_system_timer(). Not valid if +/// called before the system timer has been started. +/// +/// \return Returns one of XOS_SYS_TIMER_0, XOS_SYS_TIMER_1, XOS_SYS_TIMER_2 +/// or XOS_SYS_TIMER_EXTERNAL, or XOS_SYS_TIMER_NONE. +/// +//----------------------------------------------------------------------------- +int32_t +xos_get_system_timer_num(void); + + +//----------------------------------------------------------------------------- +/// +/// Initialize timer object. +/// +/// \param timer Pointer to timer event structure. +/// +/// \return Returns nothing. +/// +/// NOTE: This function should not be called on a timer object once it has +/// been activated. +/// +//----------------------------------------------------------------------------- +void xos_timer_init(XosTimer * timer); + + +//----------------------------------------------------------------------------- +// Flags for xos_timer_start(). +//----------------------------------------------------------------------------- +#define XOS_TIMER_DELTA 0x0000 +#define XOS_TIMER_PERIODIC 0x0001 +#define XOS_TIMER_ABSOLUTE 0x0002 +#define XOS_TIMER_FROM_NOW 0x0000 +#define XOS_TIMER_FROM_LAST 0x0010 + + +//----------------------------------------------------------------------------- +/// +/// Start the timer, and when the timer expires, call the specified function +/// (invoke (*fn)(arg)). If the timer is periodic, it will be automatically +/// restarted when it expires. +/// +/// The specified timer event structure must have been initialized before +/// first use by calling xos_timer_init(). +/// +/// The callback function will be called in an interrupt context. Hence it is +/// NOT safe to use any coprocessors in the function, including the FPU. If a +/// coprocessor must be used, then its state must be saved and restored across +/// its use. +/// +/// NOTE: If you are using the timer only to wait on (via xos_timer_wait()) +/// then it is not necessary to specify a callback function. You should pass +/// NULL for the callback function and zero for the callback argument. +/// +/// \param timer Pointer to timer event structure. Must have been +/// initialized. May be active or not. +/// +/// \param when When to call the function (see flags). +/// +/// \param flags Set of option flags XOS_TIMER_* \n +/// The following flags are mutually exclusive: +/// - XOS_TIMER_DELTA -- when is number of cycles from +/// [see below] (default) +/// - XOS_TIMER_PERIODIC -- when is number of cycles +/// from [see below], and timer continually +/// re-triggers at that interval +/// - XOS_TIMER_ABSOLUTE -- when is absolute value of +/// cycle count \n +/// \n +/// The following flags are mutually exclusive: +/// - XOS_TIMER_FROM_NOW -- *DELTA and *PERIODIC are +/// relative to now (default) +/// - XOS_TIMER_FROM_LAST -- *DELTA and *PERIODIC are +/// relative to the timer event's last specified expiry +/// time (usually in the future if active, in the past +/// if not, absolute 0 if was never activated). +/// +/// \param func Function to call (called in timer interrupt context). +/// This argument is optional. Specify NULL if no function +/// is to be called. +/// +/// \param arg Argument passed to callback function. Only relevant if +/// 'func' is not NULL. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_timer_start(XosTimer * timer, + uint64_t when, + uint32_t flags, + XosTimerFunc * func, + void * arg); + + +//----------------------------------------------------------------------------- +/// +/// Stop the timer and remove it from the list of active timers. Has no effect +/// if the timer is not active. Any waiting threads are woken up. +/// +/// The timer structure must have been initialized at least once, else its +/// contents are undefined and can lead to unpredictable results. +/// +/// \param timer Pointer to timer object. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_timer_stop(XosTimer * timer); + + +//----------------------------------------------------------------------------- +/// +/// Reset and restart the timer. +/// +/// The timer is reset to go off at time "when" from now. If the timer was not +/// active, it will be activated. If the timer was active, it will be restarted. +/// If the timer is periodic, the period will be set to "when". +/// The timer object must have been initialized at some point before this call. +/// +/// \param timer Pointer to timer object. +/// +/// \param when Number of cycles from now that the timer will expire. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_timer_restart(XosTimer * timer, uint64_t when); + + +//----------------------------------------------------------------------------- +/// +/// Check if the timer is active. The timer is active if it has been started +/// and not yet expired or canceled. +/// +/// \param timer Pointer to timer object. +/// +/// \return Returns non-zero if the timer is active, else zero. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_timer_is_active(XosTimer * timer) +{ + return timer ? timer->active : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Get the repeat period for a periodic timer. For a one-shot timer this will +/// return zero. The period is reported in system clock cycles. +/// +/// \param timer Pointer to timer object. +/// +/// \return Returns period in cycles, or zero for non-periodic timers. +/// +//----------------------------------------------------------------------------- +static inline uint64_t +xos_timer_get_period(XosTimer * timer) +{ + return timer ? timer->delta : 0; +} + + +//----------------------------------------------------------------------------- +/// +/// Set the repeat period for a periodic timer. The period must be specified +/// in system clock cycles. +/// +/// If the timer is active, the change in period does not take effect until +/// the timer expires at least once after this call. +/// Note that setting a period of zero will effectively turn a periodic timer +/// into a one-shot timer. Similarly, a one-shot timer can be turned into a +/// periodic timer. +/// +/// \param timer Pointer to timer object. +/// +/// \param period Repeat period in system clock cycles. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_timer_set_period(XosTimer * timer, uint64_t period); + + +//----------------------------------------------------------------------------- +/// +/// Get the current system cycle count. This accounts for the periodic rollover +/// of the 32-bit CCOUNT cycle counter and returns a 64-bit value. +/// +/// \return Returns the current system cycle count. +/// +//----------------------------------------------------------------------------- +static inline uint64_t +xos_get_system_cycles(void) +{ + extern uint64_t xos_system_cycles; + extern uint32_t xos_last_ccount; + + // xos_last_ccount was updated when xos_system_cycles was last updated. + // We need to add in the number of cycles elapsed since then. + return xos_system_cycles + (xos_get_ccount() - xos_last_ccount); +} + + +//----------------------------------------------------------------------------- +/// +/// Put calling thread to sleep for at least the specified number of cycles. +/// The actual number of cycles spent sleeping may be larger depending upon +/// the granularity of the system timer. Once the specified time has elapsed +/// the thread will be woken and made ready. +/// +/// \param cycles Number of system clock cycles to sleep. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_thread_sleep(uint64_t cycles); + + +//----------------------------------------------------------------------------- +/// +/// Put calling thread to sleep for at least the specified number of msec. +/// The actual amount of time spent sleeping may be larger depending upon +/// the granularity of the system timer. Once the specified time has elapsed +/// the thread will be woken and made ready. +/// +/// \return msecs The number of milliseconds to sleep. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_thread_sleep_msec(uint64_t msecs) +{ + return xos_thread_sleep(xos_msecs_to_cycles(msecs)); +} + + +//----------------------------------------------------------------------------- +/// +/// Put calling thread to sleep for at least the specified number of usec. +/// The actual amount of time spent sleeping may be larger depending upon +/// the granularity of the system timer. Once the specified time has elapsed +/// the thread will be woken and made ready. +/// +/// \return usecs The number of microseconds to sleep. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +static inline int32_t +xos_thread_sleep_usec(uint64_t usecs) +{ + return xos_thread_sleep(xos_usecs_to_cycles(usecs)); +} + + +//----------------------------------------------------------------------------- +/// +/// Wait on a timer until it expires or is cancelled. The calling thread will +/// be blocked. The timer must be active. +/// NOTE: This operation is only available if XOS_OPT_TIMER_WAIT is set +/// to 1 in the configuration options. +/// +/// \param timer Pointer to timer object. +/// +/// \return Returns XOS_OK on normal timeout, else an error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_timer_wait(XosTimer * timer); + + +//----------------------------------------------------------------------------- +// System timer control interface. +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +// Defines for system timer ID. +//----------------------------------------------------------------------------- +#define XOS_SYS_TIMER_0 0 ///< Internal timer 0 +#define XOS_SYS_TIMER_1 1 ///< Internal timer 1 +#define XOS_SYS_TIMER_2 2 ///< Internal timer 2 +#define XOS_SYS_TIMER_EXTERNAL -2 ///< External timer +#define XOS_SYS_TIMER_NONE -1 ///< No system timer selected + + +//----------------------------------------------------------------------------- +/// +/// This function handles XOS timer tick processing. It must be called by the +/// timer interrupt handler on every timer interrupt. This function computes +/// the time to the next tick and sets it up by calling xos_system_timer_set(). +/// +//----------------------------------------------------------------------------- +void +xos_tick_handler(void); + + +//----------------------------------------------------------------------------- +/// +/// Selects the timer to use. The selection may be one of the internal timers +/// or an external timer. The default implementation selects an internal timer. +/// This function can be overridden to provide custom timer processing or to +/// support an external timer. +/// +/// \param timer_num The internal timer number to select (0-2) or +/// -1 to auto-select a timer. This parameter can +/// be ignored by custom implementations that use +/// an external timer. +/// +/// \param psel Pointer to a location where the selected timer +/// ID must be returned. The timer ID must be one +/// of XOS_SYS_TIMER_0, XOS_SYS_TIMER_1, XOS_SYS_TIMER_2 +/// or XOS_SYS_TIMER_EXTERNAL. +/// +/// \return Returns XOS_OK on success, else error code. +/// +//----------------------------------------------------------------------------- +int32_t +xos_system_timer_select(int32_t timer_num, int32_t *psel); + + +//----------------------------------------------------------------------------- +/// +/// Starts the system timer and sets up the first interrupt. This function can +/// be overridden to provide custom timer processing or to support an external +/// timer. +/// +/// \param cycles The number of CPU cycles from now when the +/// first interrupt must occur. +/// +//----------------------------------------------------------------------------- +void +xos_system_timer_init(uint32_t cycles); + + +//----------------------------------------------------------------------------- +/// +/// Sets the next trigger value of the system timer. The parameter 'cycles' is +/// the number of CPU cycles from now when the interrupt must occur. +/// This function can be overridden to provide custom timer processing or to +/// support an external timer. +/// +/// \param cycles The number of CPU cycles from now when the +/// next interrupt must occur. +/// +//----------------------------------------------------------------------------- +void +xos_system_timer_set(uint32_t cycles); + + +#ifdef __cplusplus +} +#endif + +#endif // __XOS_TIMER_H__ + diff --git a/components/esp32/include/xtensa/xos_types.h b/components/esp32/include/xtensa/xos_types.h new file mode 100755 index 000000000..a913b94a2 --- /dev/null +++ b/components/esp32/include/xtensa/xos_types.h @@ -0,0 +1,75 @@ +/** @file */ +// xos_types.h - XOS type definitions. + +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// NOTE: Do not include this file directly in your application. Including +// xos.h will automatically include this file. + + +#ifndef __XOS_TYPES_H__ +#define __XOS_TYPES_H__ + +#if !defined(_ASMLANGUAGE) && !defined(__ASSEMBLER__) + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +//----------------------------------------------------------------------------- +// The following are defined here because of the variations in the C libraries +// that we need to work with. +// - Not all of them have stdbool.h +// - Not all of them define NULL as (void *)0 +//----------------------------------------------------------------------------- + + +//----------------------------------------------------------------------------- +/// +/// XOS define for NULL value. This makes the NULL value independent of the +/// C library (not all of them define NULL the same way). +/// +//----------------------------------------------------------------------------- +#define XOS_NULL ((void *)0) + + +//----------------------------------------------------------------------------- +/// +/// XOS definition of 'bool' type. Some C libraries do not support stdbool.h. +/// +//----------------------------------------------------------------------------- +#ifndef bool +#define bool int8_t +#define false 0 ///< XOS definition of 'false' +#define true 1 ///< XOS definition of 'true' +#endif + +#ifdef __cplusplus +} +#endif + +#endif // !defined(_ASMLANGUAGE) && !defined(__ASSEMBLER__) + +#endif // __XOS_TYPES_H__ + diff --git a/components/esp32/include/xtensa/xt_perf_consts.h b/components/esp32/include/xtensa/xt_perf_consts.h new file mode 100755 index 000000000..f063a31f7 --- /dev/null +++ b/components/esp32/include/xtensa/xt_perf_consts.h @@ -0,0 +1,283 @@ +/* + * Customer ID=11656; Build=0x5f626; Copyright (c) 2012 by Tensilica Inc. ALL RIGHTS RESERVED. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +#ifndef __XT_PERF_CONSTS_H__ +#define __XT_PERF_CONSTS_H__ + +/* + * Performance monitor counter selectors + */ + +#define XTPERF_CNT_COMMITTED_INSN 0x8002 /* Instructions committed */ +#define XTPERF_CNT_BRANCH_PENALTY 0x8003 /* Branch penalty cycles */ +#define XTPERF_CNT_PIPELINE_INTERLOCKS 0x8004 /* Pipeline interlocks cycles */ +#define XTPERF_CNT_ICACHE_MISSES 0x8005 /* ICache misses penalty in cycles */ +#define XTPERF_CNT_DCACHE_MISSES 0x8006 /* DCache misses penalty in cycles */ + +#define XTPERF_CNT_CYCLES 0 /* Count cycles */ +#define XTPERF_CNT_OVERFLOW 1 /* Overflow of counter n-1 (assuming this is counter n) */ +#define XTPERF_CNT_INSN 2 /* Successfully completed instructions */ +#define XTPERF_CNT_D_STALL 3 /* Data-related GlobalStall cycles */ +#define XTPERF_CNT_I_STALL 4 /* Instruction-related and other GlobalStall cycles */ +#define XTPERF_CNT_EXR 5 /* Exceptions and pipeline replays */ +#define XTPERF_CNT_BUBBLES 6 /* Hold and other bubble cycles */ +#define XTPERF_CNT_I_TLB 7 /* Instruction TLB Accesses (per instruction retiring) */ +#define XTPERF_CNT_I_MEM 8 /* Instruction memory accesses (per instruction retiring) */ +#define XTPERF_CNT_D_TLB 9 /* Data TLB accesses */ +#define XTPERF_CNT_D_LOAD_U1 10 /* Data memory load instruction (load-store unit 1) */ +#define XTPERF_CNT_D_STORE_U1 11 /* Data memory store instruction (load-store unit 1) */ +#define XTPERF_CNT_D_ACCESS_U1 12 /* Data memory accesses (load, store, S32C1I, etc; load-store unit 1) */ +#define XTPERF_CNT_D_LOAD_U2 13 /* Data memory load instruction (load-store unit 2) */ +#define XTPERF_CNT_D_STORE_U2 14 /* Data memory store instruction (load-store unit 2) */ +#define XTPERF_CNT_D_ACCESS_U2 15 /* Data memory accesses (load, store, S32C1I, etc; load-store unit 2) */ +#define XTPERF_CNT_D_LOAD_U3 16 /* Data memory load instruction (load-store unit 3) */ +#define XTPERF_CNT_D_STORE_U3 17 /* Data memory store instruction (load-store unit 3) */ +#define XTPERF_CNT_D_ACCESS_U3 18 /* Data memory accesses (load, store, S32C1I, etc; load-store unit 3) */ +#define XTPERF_CNT_MULTIPLE_LS 22 /* Multiple Load/Store */ +#define XTPERF_CNT_OUTBOUND_PIF 23 /* Outbound PIF transactions */ +#define XTPERF_CNT_INBOUND_PIF 24 /* Inbound PIF transactions */ +#define XTPERF_CNT_PREFETCH 26 /* Prefetch events */ + + +/* + * Masks for each of the selector listed above + */ + +/* XTPERF_CNT_COMMITTED_INSN selector mask */ + +#define XTPERF_MASK_COMMITTED_INSN 0x0001 + +/* XTPERF_CNT_BRANCH_PENALTY selector mask */ + +#define XTPERF_MASK_BRANCH_PENALTY 0x0001 + +/* XTPERF_CNT_PIPELINE_INTERLOCKS selector mask */ + +#define XTPERF_MASK_PIPELINE_INTERLOCKS 0x0001 + +/* XTPERF_CNT_ICACHE_MISSES selector mask */ + +#define XTPERF_MASK_ICACHE_MISSES 0x0001 + +/* XTPERF_CNT_DCACHE_MISSES selector mask */ + +#define XTPERF_MASK_DCACHE_MISSES 0x0001 + +/* XTPERF_CNT_CYCLES selector mask */ + +#define XTPERF_MASK_CYCLES 0x0001 + +/* XTPERF_CNT_OVERFLOW selector mask */ + +#define XTPERF_MASK_OVERFLOW 0x0001 + +/* + * XTPERF_CNT_INSN selector mask + */ + +#define XTPERF_MASK_INSN_ALL 0x8DFF + +#define XTPERF_MASK_INSN_JX 0x0001 /* JX */ +#define XTPERF_MASK_INSN_CALLX 0x0002 /* CALLXn */ +#define XTPERF_MASK_INSN_RET 0x0004 /* call return i.e. RET, RETW */ +#define XTPERF_MASK_INSN_RF 0x0008 /* supervisor return i.e. RFDE, RFE, RFI, RFWO, RFWU */ +#define XTPERF_MASK_INSN_BRANCH_TAKEN 0x0010 /* Conditional branch taken, or loopgtz/loopnez skips loop */ +#define XTPERF_MASK_INSN_J 0x0020 /* J */ +#define XTPERF_MASK_INSN_CALL 0x0040 /* CALLn */ +#define XTPERF_MASK_INSN_BRANCH_NOT_TAKEN 0x0080 /* Conditional branch fall through (aka. not-taken branch) */ +#define XTPERF_MASK_INSN_LOOP_TAKEN 0x0100 /* Loop instr falls into loop (aka. taken loop) */ +#define XTPERF_MASK_INSN_LOOP_BEG 0x0400 /* Loopback taken to LBEG */ +#define XTPERF_MASK_INSN_LOOP_END 0x0800 /* Loopback falls through to LEND */ +#define XTPERF_MASK_INSN_NON_BRANCH 0x8000 /* Non-branch instruction (aka. non-CTI) */ + +/* + * XTPERF_CNT_D_STALL selector mask + */ + +#define XTPERF_MASK_D_STALL_ALL 0x01FE + +#define XTPERF_MASK_D_STALL_STORE_BUF_FULL 0x0002 /* Store buffer full stall */ +#define XTPERF_MASK_D_STALL_STORE_BUF_CONFLICT 0x0004 /* Store buffer conflict stall */ +#define XTPERF_MASK_D_STALL_CACHE_MISS 0x0008 /* DCache-miss stall */ +#define XTPERF_MASK_D_STALL_BUSY 0x0010 /* Data RAM/ROM/XLMI busy stall */ +#define XTPERF_MASK_D_STALL_IN_PIF 0x0020 /* Data inbound-PIF request stall (incl s32c1i) */ +#define XTPERF_MASK_D_STALL_MHT_LOOKUP 0x0040 /* MHT lookup stall */ +#define XTPERF_MASK_D_STALL_UNCACHED_LOAD 0x0080 /* Uncached load stall (included in MHT lookup stall) */ +#define XTPERF_MASK_D_STALL_BANK_CONFLICT 0x0100 /* Bank-conflict stall */ + +/* + * XTPERF_CNT_I_STALL selector mask + */ + +#define XTPERF_MASK_I_STALL_ALL 0x01FF + +#define XTPERF_MASK_I_STALL_CACHE_MISS 0x0001 /* ICache-miss stall */ +#define XTPERF_MASK_I_STALL_BUSY 0x0002 /* Instruction RAM/ROM busy stall */ +#define XTPERF_MASK_I_STALL_IN_PIF 0x0004 /* Instruction RAM inbound-PIF request stall */ +#define XTPERF_MASK_I_STALL_TIE_PORT 0x0008 /* TIE port stall */ +#define XTPERF_MASK_I_STALL_EXTERNAL_SIGNAL 0x0010 /* External RunStall signal status */ +#define XTPERF_MASK_I_STALL_UNCACHED_FETCH 0x0020 /* Uncached fetch stall */ +#define XTPERF_MASK_I_STALL_FAST_L32R 0x0040 /* FastL32R stall */ +#define XTPERF_MASK_I_STALL_ITERATIVE_MUL 0x0080 /* Iterative multiply stall */ +#define XTPERF_MASK_I_STALL_ITERATIVE_DIV 0x0100 /* Iterative divide stall */ + +/* + * XTPERF_CNT_EXR selector mask + */ + +#define XTPERF_MASK_EXR_ALL 0x01FF + +#define XTPERF_MASK_EXR_REPLAYS 0x0001 /* Other Pipeline Replay (i.e. excludes $ miss etc.) */ +#define XTPERF_MASK_EXR_LEVEL1_INT 0x0002 /* Level-1 interrupt */ +#define XTPERF_MASK_EXR_LEVELH_INT 0x0004 /* Greater-than-level-1 interrupt */ +#define XTPERF_MASK_EXR_DEBUG 0x0008 /* Debug exception */ +#define XTPERF_MASK_EXR_NMI 0x0010 /* NMI */ +#define XTPERF_MASK_EXR_WINDOW 0x0020 /* Window exception */ +#define XTPERF_MASK_EXR_ALLOCA 0x0040 /* Alloca exception */ +#define XTPERF_MASK_EXR_OTHER 0x0080 /* Other exceptions */ +#define XTPERF_MASK_EXR_MEM_ERR 0x0100 /* HW-corrected memory error */ + +/* + * XTPERF_CNT_BUBBLES selector mask + */ + +#define XTPERF_MASK_BUBBLES_ALL 0x01FD + +#define XTPERF_MASK_BUBBLES_PSO 0x0001 /* Processor domain PSO bubble */ +#define XTPERF_MASK_BUBBLES_R_HOLD_D_CACHE_MISS 0x0004 /* R hold caused by DCache miss */ +#define XTPERF_MASK_BUBBLES_R_HOLD_STORE_RELEASE 0x0008 /* R hold caused by Store release */ +#define XTPERF_MASK_BUBBLES_R_HOLD_REG_DEP 0x0010 /* R hold caused by register dependency */ +#define XTPERF_MASK_BUBBLES_R_HOLD_WAIT 0x0020 /* R hold caused by MEMW, EXTW or EXCW */ +#define XTPERF_MASK_BUBBLES_R_HOLD_HALT 0x0040 /* R hold caused by Halt instruction (TX only) */ +#define XTPERF_MASK_BUBBLES_CTI 0x0080 /* CTI bubble (e.g. branch delay slot) */ +#define XTPERF_MASK_BUBBLES_WAITI 0x0100 /* WAITI bubble */ + +/* + * XTPERF_CNT_I_TLB selector mask + */ + +#define XTPERF_MASK_I_TLB_ALL 0x000F + +#define XTPERF_MASK_I_TLB_HITS 0x0001 /* Hit */ +#define XTPERF_MASK_I_TLB_REPLAYS 0x0002 /* Replay of instruction due to ITLB miss */ +#define XTPERF_MASK_I_TLB_REFILLS 0x0004 /* HW-assisted TLB Refill completes */ +#define XTPERF_MASK_I_TLB_MISSES 0x0008 /* ITLB Miss Exception */ + +/* + * XTPERF_CNT_I_MEM selector mask + */ + +#define XTPERF_MASK_I_MEM_ALL 0x000F + +#define XTPERF_MASK_I_MEM_CACHE_HITS 0x0001 /* ICache Hit */ +#define XTPERF_MASK_I_MEM_CACHE_MISSES 0x0002 /* ICache Miss (includes uncached) */ +#define XTPERF_MASK_I_MEM_IRAM 0x0004 /* InstRAM or InstROM */ +#define XTPERF_MASK_I_MEM_BYPASS 0x0008 /* Bypass (i.e. uncached) fetch */ + +/* + * XTPERF_CNT_D_TLB selector mask + */ + +#define XTPERF_MASK_D_TLB_ALL 0x000F + +#define XTPERF_MASK_D_TLB_HITS 0x0001 /* Hit */ +#define XTPERF_MASK_D_TLB_REPLAYS 0x0002 /* Replay of instruction due to DTLB miss */ +#define XTPERF_MASK_D_TLB_REFILLS 0x0004 /* HW-assisted TLB Refill completes */ +#define XTPERF_MASK_D_TLB_MISSES 0x0008 /* DTLB Miss Exception */ + +/* + * XTPERF_CNT_D_LOAD_U* selector mask + */ + +#define XTPERF_MASK_D_LOAD_ALL 0x000F + +#define XTPERF_MASK_D_LOAD_CACHE_HITS 0x0001 /* Cache Hit */ +#define XTPERF_MASK_D_LOAD_CACHE_MISSES 0x0002 /* Cache Miss */ +#define XTPERF_MASK_D_LOAD_LOCAL_MEM 0x0004 /* Local memory hit */ +#define XTPERF_MASK_D_LOAD_BYPASS 0x0008 /* Bypass (i.e. uncached) load */ + +/* + * XTPERF_CNT_D_STORE_U* selector mask + */ + +#define XTPERF_MASK_D_STORE_ALL 0x000F + +#define XTPERF_MASK_D_STORE_CACHE_HITS 0x0001 /* DCache Hit */ +#define XTPERF_MASK_D_STORE_CACHE_MISSES 0x0002 /* DCache Miss */ +#define XTPERF_MASK_D_STORE_LOCAL_MEM 0x0004 /* Local memory hit */ +#define XTPERF_MASK_D_STORE_PIF 0x0008 /* PIF Store */ + +/* + * XTPERF_CNT_D_ACCESS_U* selector mask + */ + +#define XTPERF_MASK_D_ACCESS_ALL 0x000F + +#define XTPERF_MASK_D_ACCESS_CACHE_MISSES 0x0001 /* DCache Miss */ +#define XTPERF_MASK_D_ACCESS_HITS_SHARED 0x0002 /* Hit Shared */ +#define XTPERF_MASK_D_ACCESS_HITS_EXCLUSIVE 0x0004 /* Hit Exclusive */ +#define XTPERF_MASK_D_ACCESS_HITS_MODIFIED 0x0008 /* Hit Modified */ + +/* + * XTPERF_CNT_MULTIPLE_LS selector mask + */ + +#define XTPERF_MASK_MULTIPLE_LS_ALL 0x003F + +#define XTPERF_MASK_MULTIPLE_LS_0S_0L 0x0001 /* 0 stores and 0 loads */ +#define XTPERF_MASK_MULTIPLE_LS_0S_1L 0x0002 /* 0 stores and 1 loads */ +#define XTPERF_MASK_MULTIPLE_LS_1S_0L 0x0004 /* 1 stores and 0 loads */ +#define XTPERF_MASK_MULTIPLE_LS_1S_1L 0x0008 /* 1 stores and 1 loads */ +#define XTPERF_MASK_MULTIPLE_LS_0S_2L 0x0010 /* 0 stores and 2 loads */ +#define XTPERF_MASK_MULTIPLE_LS_2S_0L 0x0020 /* 2 stores and 0 loads */ + +/* + * XTPERF_CNT_OUTBOUND_PIF selector mask + */ + +#define XTPERF_MASK_OUTBOUND_PIF_ALL 0x0003 + +#define XTPERF_MASK_OUTBOUND_PIF_CASTOUT 0x0001 /* Castout */ +#define XTPERF_MASK_OUTBOUND_PIF_PREFETCH 0x0002 /* Prefetch */ + +/* + * XTPERF_CNT_INBOUND_PIF selector mask + */ + +#define XTPERF_MASK_INBOUND_PIF_ALL 0x0003 + +#define XTPERF_MASK_INBOUND_PIF_I_DMA 0x0001 /* Instruction DMA */ +#define XTPERF_MASK_INBOUND_PIF_D_DMA 0x0002 /* Data DMA */ + +/* + * XTPERF_CNT_PREFETCH selector mask + */ + +#define XTPERF_MASK_PREFETCH_ALL 0x002F + +#define XTPERF_MASK_PREFETCH_I_HIT 0x0001 /* I prefetch-buffer-lookup hit */ +#define XTPERF_MASK_PREFETCH_D_HIT 0x0002 /* D prefetch-buffer-lookup hit */ +#define XTPERF_MASK_PREFETCH_I_MISS 0x0004 /* I prefetch-buffer-lookup miss */ +#define XTPERF_MASK_PREFETCH_D_MISS 0x0008 /* D prefetch-buffer-lookup miss */ +#define XTPERF_MASK_PREFETCH_D_L1_FILL 0x0020 /* Fill directly to DCache L1 */ + +#endif /* __XT_PERF_CONSTS_H__ */ diff --git a/components/esp32/include/xtensa/xt_perfmon.h b/components/esp32/include/xtensa/xt_perfmon.h new file mode 100755 index 000000000..959052b16 --- /dev/null +++ b/components/esp32/include/xtensa/xt_perfmon.h @@ -0,0 +1,183 @@ +/* + * Customer ID=11656; Build=0x5f626; Copyright (c) 2012 by Tensilica Inc. ALL RIGHTS RESERVED. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +#ifndef __XT_PERFMON_H__ +#define __XT_PERFMON_H__ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +typedef int counter_id_t; + +/* xt_perf_init + + Initialize the performance monitor library. Ordinarily, this + function is called automatically via the .init section. If your + environment does not support the .init section, you will need to + call this function from your code. +*/ + +extern void xt_perf_init(void); + +/* xt_perf_enable + + Turn on the performance monitor. Ordinarily, counting is off by + default. If you turn off performance monitor using xt_perf_disable or + by call to a function that disables performance monitor, you can turn + it on again via this function. +*/ + +extern void xt_perf_enable(void); + +/* xt_perf_disable + + Turn off the performance monitor. If you want to suspend counting + events for a portion of your code, use this function and then call + xt_perf_enable when you want to start again. +*/ + +extern void xt_perf_disable(void); + +/* xt_perf_clear + + Disable performance monitor and clear all initialized hardware counters. + All counter ids are invalid after call to this function and all hardware + counters available for initialization. +*/ + +extern void xt_perf_clear (void); + +/* xt_perf_counters_num + + Returns number of free hardware performance counters. After call to xt_perf_clear + all counters are free and available for initialization. With each successful + xt_perf_init_counter/xt_perf_init_event call this number is decreasing until + no free counters available. +*/ + +extern int xt_perf_counters_num (void); + +/* xt_perf_init_counter32 + + Setup 32 bit performance counter. This function disables performance monitor + if it was enabled. + + Returns zero based counter id on success or negative value if failed. + This function may fail if there is insufficient number of free hardware + counters or function arguments are invalid. + + The counter id returned on success can be used with xt_perf_reset_counter + and xt_perf_counter32 functions. + + - events group, one of XTPERF_CNT constants defined in + xt_perf_consts.h; + - events mask for selected group. Mask bit fields for each + selector defined with XTPERF_MASK prefix in xt_perf_consts.h; + - specifies interrupt levels at which to count events; + if trace_level is greater or equal to zero events are + counted only at interrupt levels below or equal to + trace_level; if trace_level is negative events are + counted only at (-trace_level) interrupt level or higher. +*/ + + +extern counter_id_t xt_perf_init_counter32 ( unsigned int selector, + unsigned int mask, + int trace_level); + +/* xt_perf_init_counter64 + + Setup 64 bit performance counter. Library emulates 64 bit counters by handling + profiling interrupt and recording overflows of 32 bit hardware counters. + This function disables performance monitor if it was enabled. + + Returns zero based counter id on success or negative value if failed. + This function may fail if there is insufficient number of free hardware + counters or function arguments are invalid. + + The counter id returned on success can be used with xt_perf_reset_counter + and xt_perf_counter64 functions. + + - events group, one of XTPERF_CNT constants defined in + xt_perf_consts.h; + - events mask for selected group. Mask bit fields for each + selector defined with XTPERF_MASK prefix in xt_perf_consts.h; + - specifies interrupt levels at which to count events; + if trace_level is greater or equal to zero events are + counted only at interrupt levels below or equal to + trace_level; if trace_level is negative events are + counted only at (-trace_level) interrupt level or higher. +*/ + +extern counter_id_t xt_perf_init_counter64 ( unsigned int selector, + unsigned int mask, + int trace_level); + +/* xt_perf_reset_counter + + Reset counter value to 0. + Returns zero on success or non zero if failed. +*/ + +extern int xt_perf_reset_counter (counter_id_t counter_id); + +/* xt_perf_counter32 + + Read 32 bit counter value. + + Returns zero if counter id is not valid. +*/ + +extern unsigned int xt_perf_counter32 (counter_id_t counter_id); + +/* xt_perf_counter64 + + Read 64 bit counter value. + + Counter must be initialized using xt_perf_init_counter64 function. + + Returns zero if counter id is not valid. +*/ + +extern unsigned long long xt_perf_counter64 (counter_id_t counter_id); + + /* xt_perf_overflow32 + + Read overflow flag of 32 bit counter. This flag is dropped when + counter initialized or reset. Once counter overflows and wraps + around the flag is set and stays set until counter reset. + + Returns negative value if counter id is invalid, zero if counter + not overflowed, positive if in overflowed state. + */ + +extern int xt_perf_overflow32 (counter_id_t counter_id); + +#ifdef __cplusplus +} +#endif + +#endif /* __XT_PERFMON_H__ */ diff --git a/components/esp32/include/xtensa/xt_profiling.h b/components/esp32/include/xtensa/xt_profiling.h new file mode 100755 index 000000000..650713a45 --- /dev/null +++ b/components/esp32/include/xtensa/xt_profiling.h @@ -0,0 +1,233 @@ +/* + * Customer ID=11656; Build=0x5f626; Copyright (c) 2005-2012 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +#ifndef __XT_PROFILER_H__ +#define __XT_PROFILER_H__ + +#include + +#if XCHAL_NUM_PERF_COUNTERS +/* Performance monitor counters constants */ +#include + +#endif /* XCHAL_NUM_PERF_COUNTERS */ + + +#ifdef __cplusplus +extern "C" { +#endif + +/* This file defines an interface that allows a program being profiled + to control when and how it is profiled, whether it is running under + the instruction set simulator or under the hardware profiler. + + Both ISS and HWP implement this interface, although in different + ways. Both also do the right thing if you don't call any of these + functions. +*/ + + +/* +xt_profile_init + + ISS: a no op. + + HWP: Initialize the profiler. Ordinarily, this function is called + automatically via the .init section. If your environment does not + support the .init section, you will need to call this function + by hand. +*/ +extern void xt_profile_init(void); + +/* +xt_profile_add_memory + + ISS: a no op. + + HWP: + Makes "buf_size" bytes at "buf" available to the hardware profiler. + This buffer should be initialized to zeros prior to this call. + + The hardware profiler has already estimated the amount of memory it needs, + but under certain circumstances may still run out of memory. If so, you can + provide more memory with this routine. + +*/ +extern void xt_profile_add_memory(void * buf, unsigned int buf_size); + + +/* xt_profile_enable + + Turn on the profiler. Ordinarily, profiling is on by default. + If you turn off profiling using xt_profile_disable, You can turn + it on again via this function. +*/ +extern void xt_profile_enable(void); + +/* xt_profile_disable + + Turn off the profiler. If you don't want to profile a portion of your code, + use this function and then xt_profile_enable when you want to start again. +*/ +extern void xt_profile_disable(void); + +/* xt_profile_save_and_reset + + Save and reset the profiler's data. + If there were errors, either during profiling or while attempting to + write the data, no data will be written and this function will + return non-zero. + +*/ +extern int xt_profile_save_and_reset(void); + +/* xt_profile_get_frequency + + ISS: always returns 1. + + HWP: + Returns the number of cycles between samples for timer based profiler. + In performance counters based profiler always returns 1. +*/ +extern unsigned int xt_profile_get_frequency(void); + +/* xt_profile_set_frequency + + ISS: a no op. + + HWP: + Set the number of cycles between samples for timer based profiler. + Ignored in performance counters based profiler. + + sample frequency is the number of cycles to wait between samples. It should + be a multiple of 1024. + + If you set the sample frequency to a different value than was passed in xt_profile_init, + then the labels in the output will reflect the later frequency, even though some samples may + have been taken at the earlier frequency. Typically this does not make a significant difference + in the results if this function is called early enough. +*/ +extern void xt_profile_set_frequency(unsigned int sample_frequency); + +/* xt_profile_num_errors + + ISS: always returns 0 + + HWP: + Returns the number of errors that occured while taking samples. Typically these + are out of memory errors and you need to pass a bigger buffer to + xt_profile_add_memory +*/ +extern int xt_profile_num_errors(void); + + +#if XCHAL_NUM_PERF_COUNTERS + + +/* xt_profile_randomize + + ISS: not available + + HWP: Available in performance monitor based profiler. + + Turns on or off sampling period randomization mode. Period randomization + helps to avoid aliasing problems when code being profiled is highly periodic. + Profiler maintains same average sampling period but individual sampling + steps may vary. + Period randomization is turned off by default. + + - non zero turns randomization on, + zero turns randomization off. +*/ + +extern void xt_profile_randomization(int value); + +/* xt_profile_config_clear + + ISS: not available + + HWP: Available in performance monitor based profiler. + + Stops profiling if it was enabled and clears performance counters + parameters. Accumulated profile data stays in memory and will be + saved when xt_profile_save_and_reset is called or at program exit. + Number of configured performance counters is zero after this + function call. +*/ + +extern void xt_profile_config_clear(void); + + +/* xt_profile_config_num + + ISS: not available + + HWP: Available in performance monitor based profiler. + + Returns number of free performance counters. +*/ + +extern int xt_profile_config_num(void); + + +/* xt_profile_config_counter error codes +*/ + +#define XTPROF_ERR_OUT_OF_MEM -1 +#define XTPROF_ERR_INVALID_ARGS -2 +#define XTPROF_ERR_NOT_ENOUGH_COUNTERS -3 +#define XTPROF_ERR_DEFUNCT -4 + +/* xt_profile_config_counter + + ISS: not available + + HWP: Available in performance monitor based profiler. + + Allocating and initializing one or more performance counter for sampling. + Even though event may require multiple performance counters allocated the + profile data for event is merged and dumped into single gmon file. + This function disables profiling if it was enabled. + + Returns 0 on success, non zero if failed: + XTPROF_ERR_OUT_OF_MEM - memory allocation failed; + XTPROF_ERR_INVALID_ARGS - invalid function parameters; + XTPROF_ERR_NOT_ENOUGH_COUNTERS - not enough free performance counters available; + XTPROF_ERR_DEFUNCT - profiling is disabled because of previous errors + (xt_profile_num_errors() is non zero) + + - events group, one of XTPERF_CNT constants defined in xt_perf_consts.h + - events mask for selected group. Mask bit fields for each + selector defined with XTPERF_MASK prefix in xt_perf_consts.h + - specifies interrupt levels at which to take samples; + if trace_level is greater or equal to zero samples are + taken only at interrupt levels below or equal to + trace_level; if trace_level is negative samples are taken + only at (-trace_level) interrupt level or higher. + - sampling period; 1 - record every event, 2 - record every + other event and so on; + Please note - there is overhead associated with events recording, + high frequency events may produce incorrect profile when period + is too small. +*/ + +extern int xt_profile_config_counter ( unsigned int selector, + unsigned int mask, + int trace_level, + unsigned int period); + + + +#endif /* XCHAL_NUM_PERF_COUNTERS */ + +#ifdef __cplusplus +} +#endif + +#endif /* __XT_PROFILER_H__ */ diff --git a/components/esp32/include/xtensa/xt_reftb.h b/components/esp32/include/xtensa/xt_reftb.h new file mode 100755 index 000000000..358c39f74 --- /dev/null +++ b/components/esp32/include/xtensa/xt_reftb.h @@ -0,0 +1,86 @@ +/* + * Customer ID=11656; Build=0x5f626; Copyright (c) 2009-2013 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of + * Tensilica Inc. They may be adapted and modified by bona fide + * purchasers for internal use, but neither the original nor any + * adapted or modified version may be disclosed or distributed to + * third parties in any manner, medium, or form, in whole or in part, + * without the prior written consent of Tensilica Inc. + * + * This software and its derivatives are to be executed solely on + * products incorporating a Tensilica processor. + */ + +// Utility routines for returning pass/fail status in HW simulations + +#ifndef XT_REF_TESTBENCH_H +#define XT_REF_TESTBENCH_H 1 + +#ifdef __cplusplus +extern "C" { +#endif + +// Exit routines for HW simulation +extern int diag_pass(); +extern int diag_fail(); + +// Set exit status for HW simulation +int set_diag_status(int stat); + +// Setup for user power toggling +extern int setup_power_toggle(); + +// Return exit status location +extern unsigned int* testbench_exit_location(); +// Return power toggle location +extern unsigned int* testbench_power_toggle_location(); + + +// Change exit status location +// You must also change the plusarg "+DVMagicExit" sent to the HW simulator +// or change the argument "--exit_location" sent to the ISS +extern unsigned int* set_testbench_exit_location(unsigned int*); +// Change power toggle location +// You must also change the plusarg "+DVPowerLoc" sent to the HW simulator +extern unsigned int* set_testbench_power_toggle_location(unsigned int*); + +// Exit routines with status message +// +static inline +int pass(const char *msg) +{ + return diag_pass(); +} + +static inline +int fail(const char *msg) +{ + return diag_fail(); +} + +#define POWER_TOGGLE_ON 1 +#define POWER_TOGGLE_OFF 0 + +// Routine to turn on and off power toggle +// Does a magic write that Monitors.v intercepts and appropriately turns +// SAIF dumping on and offf +// +extern volatile unsigned int *_reftb_power_toggle; + +__attribute__ ((always_inline)) +static inline +int set_power_toggle(int val) +{ +#ifdef __XTENSA__ + *_reftb_power_toggle = val; +#endif + return val; +} + +#ifdef __cplusplus +} +#endif + +#endif // XT_REF_TESTBENCH_H + diff --git a/components/esp32/include/xtensa/xtav110.h b/components/esp32/include/xtensa/xtav110.h new file mode 100755 index 000000000..23421f0b7 --- /dev/null +++ b/components/esp32/include/xtensa/xtav110.h @@ -0,0 +1,313 @@ +/* Copyright (c) 2007-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* xtav110.h - Xtensa Avnet LX110 (XT-AV110) board specific definitions */ + +#ifndef _INC_XTAV110_H_ +#define _INC_XTAV110_H_ + +#include +#include + +#define XTBOARD_NAME "XT-AV110" + + +/* + * Default assignment of XTAV110 devices to external interrupts. + */ + +/* Ethernet interrupt: */ +#ifdef XCHAL_EXTINT1_NUM +#define ETHERNET_INTNUM XCHAL_EXTINT1_NUM +#define ETHERNET_INTLEVEL XCHAL_EXTINT1_LEVEL +#define ETHERNET_INTMASK XCHAL_EXTINT1_MASK +#else +#define ETHERNET_INTMASK 0 +#endif + +/* UART interrupt: */ +#ifdef XCHAL_EXTINT0_NUM +#define UART16550_INTNUM XCHAL_EXTINT0_NUM +#define UART16550_INTLEVEL XCHAL_EXTINT0_LEVEL +#define UART16550_INTMASK XCHAL_EXTINT0_MASK +#else +#define UART16550_INTMASK 0 +#endif + +/* Audio output interrupt (I2S transmitter FIFO): */ +#ifdef XCHAL_EXTINT2_NUM +#define AUDIO_I2S_OUT_INTNUM XCHAL_EXTINT2_NUM +#define AUDIO_I2S_OUT_INTLEVEL XCHAL_EXTINT2_LEVEL +#define AUDIO_I2S_OUT_INTMASK XCHAL_EXTINT2_MASK +#else +#define AUDIO_I2S_OUT_INTMASK 0 +#endif + +/* Audio input interrupt (I2S receiver FIFO): */ +#ifdef XCHAL_EXTINT3_NUM +#define AUDIO_I2S_IN_INTNUM XCHAL_EXTINT3_NUM +#define AUDIO_I2S_IN_INTLEVEL XCHAL_EXTINT3_LEVEL +#define AUDIO_I2S_IN_INTMASK XCHAL_EXTINT3_MASK +#else +#define AUDIO_I2S_IN_INTMASK 0 +#endif + +/* I2C interrupt */ +#ifdef XCHAL_EXTINT4_NUM +#define I2C_INTNUM XCHAL_EXTINT4_NUM +#define I2C_INTLEVEL XCHAL_EXTINT4_LEVEL +#define I2C_INTMASK XCHAL_EXTINT4_MASK +#else +#define I2C_INTMASK 0 +#endif + +/* USB interrupt */ +#ifdef XCHAL_EXTINT5_NUM +#define USB_INTNUM XCHAL_EXTINT5_NUM +#define USB_INTLEVEL XCHAL_EXTINT5_LEVEL +#define USB_INTMASK XCHAL_EXTINT5_MASK +#else +#define USB_INTMASK 0 +#endif + +/* + * Device addresses. + * + * Note: for endianness-independence, use 32-bit loads and stores for all + * register accesses to Ethernet, UART and LED devices. Undefined bits + * may need to be masked out if needed when reading if the actual register + * size is smaller than 32 bits. + * + * Note: XTAV110 bus byte lanes are defined in terms of msbyte and lsbyte + * relative to the processor. So 32-bit registers are accessed consistently + * from both big and little endian processors. However, this means byte + * sequences are not consistent between big and little endian processors. + * This is fine for RAM, and for ROM if ROM is created for a specific + * processor (and thus has correct byte sequences). However this may be + * unexpected for Flash, which might contain a file-system that one wants + * to use for multiple processor configurations (eg. the Flash might contain + * the Ethernet card's address, endianness-independent application data, etc). + * That is, byte sequences written in Flash by a core of a given endianness + * will be byte-swapped when seen by a core of the other endianness. + * Someone implementing an endianness-independent Flash file system will + * likely handle this byte-swapping issue in the Flash driver software. + */ + +#define XTBOARD_FLASH_MAXSIZE 0x1000000 /* 16 MB */ + +#ifdef XSHAL_IOBLOCK_BYPASS_PADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D030000) + + +/* UART National-Semi PC16550D: */ +# define UART16550_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D050000) + +/* I2S transmitter */ +# define AUDIO_I2S_OUT_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D080000) + +/* I2S receiver */ +# define AUDIO_I2S_IN_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D088000) + +/* I2C master */ +# define I2C_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D090000) + +/* SPI controller */ +# define SPI_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0A0000) + +/* Display controller Sunplus SPLC780D, 4bit mode, + * LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_4BIT_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0C0000) + +/* USB Controller */ +# define USB_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0D0000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_PADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_PADDR +# define XTBOARD_FLASH_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x08000000) +# define ETHERNET_BUFFER_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D800000) +#endif /* XSHAL_IOBLOCK_CACHED_PADDR */ + + +/*** Same thing over again, this time with virtual addresses: ***/ + +#ifdef XSHAL_IOBLOCK_BYPASS_VADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D030000) + + +/* UART National-Semi PC16550D: */ +# define UART16550_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D050000) + +/* I2S transmitter */ +# define AUDIO_I2S_OUT_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D080000) + +/* I2S receiver */ +# define AUDIO_I2S_IN_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D088000) + +/* I2C master */ +# define I2C_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D090000) + +/* SPI controller */ +# define SPI_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0A0000) + +/* Display controller Sunplus SPLC780D, 4bit mode, + * LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_4BIT_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0C0000) + +/* USB Controller */ +# define USB_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0D0000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_VADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_VADDR +# define XTBOARD_FLASH_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x08000000) +# define ETHERNET_BUFFER_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D800000) +#endif /* XSHAL_IOBLOCK_CACHED_VADDR */ + + +/* System ROM: */ +#define XTBOARD_ROM_SIZE XSHAL_ROM_SIZE +#ifdef XSHAL_ROM_VADDR +#define XTBOARD_ROM_VADDR XSHAL_ROM_VADDR +#endif +#ifdef XSHAL_ROM_PADDR +#define XTBOARD_ROM_PADDR XSHAL_ROM_PADDR +#endif + +/* System RAM: */ +#define XTBOARD_RAM_SIZE XSHAL_RAM_SIZE +#ifdef XSHAL_RAM_VADDR +#define XTBOARD_RAM_VADDR XSHAL_RAM_VADDR +#endif +#ifdef XSHAL_RAM_PADDR +#define XTBOARD_RAM_PADDR XSHAL_RAM_PADDR +#endif +#define XTBOARD_RAM_BYPASS_VADDR XSHAL_RAM_BYPASS_VADDR +#define XTBOARD_RAM_BYPASS_PADDR XSHAL_RAM_BYPASS_PADDR + + + +/* + * Things that depend on device addresses. + */ + + +#define XTBOARD_CACHEATTR_WRITEBACK XSHAL_XT2000_CACHEATTR_WRITEBACK +#define XTBOARD_CACHEATTR_WRITEALLOC XSHAL_XT2000_CACHEATTR_WRITEALLOC +#define XTBOARD_CACHEATTR_WRITETHRU XSHAL_XT2000_CACHEATTR_WRITETHRU +#define XTBOARD_CACHEATTR_BYPASS XSHAL_XT2000_CACHEATTR_BYPASS +#define XTBOARD_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_DEFAULT + +#define XTBOARD_BUSINT_PIPE_REGIONS XSHAL_XT2000_PIPE_REGIONS +#define XTBOARD_BUSINT_SDRAM_REGIONS XSHAL_XT2000_SDRAM_REGIONS + + +/* + * FPGA registers. + * All these registers are normally accessed using 32-bit loads/stores. + */ + +/* Register offsets: */ +#define XTBOARD_DATECD_OFS 0x00 /* date code (read-only) */ +#define XTBOARD_CLKFRQ_OFS 0x04 /* clock frequency Hz (read-only) */ +#define XTBOARD_SYSLED_OFS 0x08 /* LEDs */ +#define XTBOARD_DIPSW_OFS 0x0C /* DIP switch bits (read-only) */ +#define XTBOARD_SWRST_OFS 0x10 /* software reset */ + +/* Physical register addresses: */ +#ifdef XTBOARD_FPGAREGS_PADDR +#define XTBOARD_DATECD_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SWRST_OFS) +#endif + +/* Virtual register addresses: */ +#ifdef XTBOARD_FPGAREGS_VADDR +#define XTBOARD_DATECD_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SWRST_OFS) +/* Register access (for C code): */ +#define XTBOARD_DATECD_REG (*(volatile unsigned*) XTBOARD_DATECD_VADDR) +#define XTBOARD_CLKFRQ_REG (*(volatile unsigned*) XTBOARD_CLKFRQ_VADDR) +#define XTBOARD_SYSLED_REG (*(volatile unsigned*) XTBOARD_SYSLED_VADDR) +#define XTBOARD_DIPSW_REG (*(volatile unsigned*) XTBOARD_DIPSW_VADDR) +#define XTBOARD_SWRST_REG (*(volatile unsigned*) XTBOARD_SWRST_VADDR) +#endif + +/* DATECD (date code; when core was built) bit fields: */ +/* BCD-coded month (01..12): */ +#define XTBOARD_DATECD_MONTH_SHIFT 24 +#define XTBOARD_DATECD_MONTH_BITS 8 +#define XTBOARD_DATECD_MONTH_MASK 0xFF000000 +/* BCD-coded day (01..31): */ +#define XTBOARD_DATECD_DAY_SHIFT 16 +#define XTBOARD_DATECD_DAY_BITS 8 +#define XTBOARD_DATECD_DAY_MASK 0x00FF0000 +/* BCD-coded year (2001..9999): */ +#define XTBOARD_DATECD_YEAR_SHIFT 0 +#define XTBOARD_DATECD_YEAR_BITS 16 +#define XTBOARD_DATECD_YEAR_MASK 0x0000FFFF + +/* SYSLED (system LED) bit fields: */ + +/* LED control bits (off=0, on=1): */ +#define XTBOARD_SYSLED_USER_SHIFT 0 +#define XTBOARD_SYSLED_USER_BITS 2 +#define XTBOARD_SYSLED_USER_MASK 0x00000003 + +/* DIP Switch SW5 (left=sw1=lsb=bit0, right=sw4=msb=bit3; off=0, on=1): */ +/* DIP switch bit fields (bit2/sw3 is reserved and presently unused): */ +#define XTBOARD_DIPSW_USER_SHIFT 0 /* labeled 1-2 (1=lsb) */ +#define XTBOARD_DIPSW_USER_BITS 2 +#define XTBOARD_DIPSW_USER_MASK 0x00000003 +#define XTBOARD_DIPSW_BOOT_SHIFT 3 /* labeled 8 (msb) */ +#define XTBOARD_DIPSW_BOOT_BITS 1 +#define XTBOARD_DIPSW_BOOT_MASK 0x00000008 +/* Boot settings: bit3/sw4, off=0, on=1 (this switch controls hardware): */ +#define XTBOARD_DIPSW_BOOT_RAM (0< + diff --git a/components/esp32/include/xtensa/xtav200.h b/components/esp32/include/xtensa/xtav200.h new file mode 100755 index 000000000..f3d837efa --- /dev/null +++ b/components/esp32/include/xtensa/xtav200.h @@ -0,0 +1,280 @@ +/* Copyright (c) 2007-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* xtav200.h - Xtensa Avnet LX200 (XT-AV200) board specific definitions */ + +#ifndef _INC_XTAV200_H_ +#define _INC_XTAV200_H_ + +#include +#include + +#define XTBOARD_NAME "XT-AV200" + + +/* + * Default assignment of XTAV200 devices to external interrupts. + */ + +/* Ethernet interrupt: */ +#ifdef XCHAL_EXTINT1_NUM +#define ETHERNET_INTNUM XCHAL_EXTINT1_NUM +#define ETHERNET_INTLEVEL XCHAL_EXTINT1_LEVEL +#define ETHERNET_INTMASK XCHAL_EXTINT1_MASK +#else +#define ETHERNET_INTMASK 0 +#endif + +/* UART interrupt: */ +#ifdef XCHAL_EXTINT0_NUM +#define UART16550_INTNUM XCHAL_EXTINT0_NUM +#define UART16550_INTLEVEL XCHAL_EXTINT0_LEVEL +#define UART16550_INTMASK XCHAL_EXTINT0_MASK +#else +#define UART16550_INTMASK 0 +#endif + +/* Audio output interrupt (I2S FIFO underrun): */ +#ifdef XCHAL_EXTINT2_NUM +#define AUDIO_INTNUM XCHAL_EXTINT2_NUM +#define AUDIO_INTLEVEL XCHAL_EXTINT2_LEVEL +#define AUDIO_INTMASK XCHAL_EXTINT2_MASK +#else +#define AUDIO_INTMASK 0 +#endif + +/* Audio output (I2S FIFO level) interrupt: */ +#ifdef XCHAL_EXTINT3_NUM +#define AUDIO_I2SLVL_INTNUM XCHAL_EXTINT3_NUM +#define AUDIO_I2SLVL_INTLEVEL XCHAL_EXTINT3_LEVEL +#define AUDIO_I2SLVL_INTMASK XCHAL_EXTINT3_MASK +#else +#define AUDIO_I2SLVL_INTMASK 0 +#endif + +/* Audio input (ADC FIFO level) interrupt: */ +#ifdef XCHAL_EXTINT4_NUM +#define AUDIO_ADCLVL_INTNUM XCHAL_EXTINT4_NUM +#define AUDIO_ADCLVL_INTLEVEL XCHAL_EXTINT4_LEVEL +#define AUDIO_ADCLVL_INTMASK XCHAL_EXTINT4_MASK +#else +#define AUDIO_ADCLVL_INTMASK 0 +#endif + + +/* + * Device addresses. + * + * Note: for endianness-independence, use 32-bit loads and stores for all + * register accesses to Ethernet, UART and LED devices. Undefined bits + * may need to be masked out if needed when reading if the actual register + * size is smaller than 32 bits. + * + * Note: XTAV200 bus byte lanes are defined in terms of msbyte and lsbyte + * relative to the processor. So 32-bit registers are accessed consistently + * from both big and little endian processors. However, this means byte + * sequences are not consistent between big and little endian processors. + * This is fine for RAM, and for ROM if ROM is created for a specific + * processor (and thus has correct byte sequences). However this may be + * unexpected for Flash, which might contain a file-system that one wants + * to use for multiple processor configurations (eg. the Flash might contain + * the Ethernet card's address, endianness-independent application data, etc). + * That is, byte sequences written in Flash by a core of a given endianness + * will be byte-swapped when seen by a core of the other endianness. + * Someone implementing an endianness-independent Flash file system will + * likely handle this byte-swapping issue in the Flash driver software. + */ + +#define XTBOARD_FLASH_MAXSIZE 0x1000000 /* 16 MB */ + +#ifdef XSHAL_IOBLOCK_BYPASS_PADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D030000) + +/* UART National-Semi PC16550D: */ +# define UART16550_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D050000) + +/* TI 320AIC23/28-TSSOP Stereo Audio Codec: */ +# define AUDIO_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D070000) + +/* Boot 128K Sram address: */ +# define BOOT_SRAM_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D400000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_PADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_PADDR +# define XTBOARD_FLASH_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x08000000) +# define ETHERNET_BUFFER_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D800000) +# define BOOT_SRAM_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D400000) +#endif /* XSHAL_IOBLOCK_CACHED_PADDR */ + + +/*** Same thing over again, this time with virtual addresses: ***/ + +#ifdef XSHAL_IOBLOCK_BYPASS_VADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D030000) + +/* UART National-Semi PC16550D: */ +# define UART16550_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D050000) + +/* TI 320AIC23/28-TSSOP Stereo Audio Codec: */ +# define AUDIO_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D070000) + +/* 128K Sram address: */ +# define BOOT_SRAM_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D400000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_VADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_VADDR +# define XTBOARD_FLASH_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x08000000) +# define AUDIO_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D070000) +# define ETHERNET_BUFFER_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D800000) +# define BOOT_SRAM_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D400000) +#endif /* XSHAL_IOBLOCK_CACHED_VADDR */ + + +/* System ROM: */ +#define XTBOARD_ROM_SIZE XSHAL_ROM_SIZE +#ifdef XSHAL_ROM_VADDR +#define XTBOARD_ROM_VADDR XSHAL_ROM_VADDR +#endif +#ifdef XSHAL_ROM_PADDR +#define XTBOARD_ROM_PADDR XSHAL_ROM_PADDR +#endif + +/* System RAM: */ +#define XTBOARD_RAM_SIZE XSHAL_RAM_SIZE +#ifdef XSHAL_RAM_VADDR +#define XTBOARD_RAM_VADDR XSHAL_RAM_VADDR +#endif +#ifdef XSHAL_RAM_PADDR +#define XTBOARD_RAM_PADDR XSHAL_RAM_PADDR +#endif +#define XTBOARD_RAM_BYPASS_VADDR XSHAL_RAM_BYPASS_VADDR +#define XTBOARD_RAM_BYPASS_PADDR XSHAL_RAM_BYPASS_PADDR + + + +/* + * Things that depend on device addresses. + */ + + +#define XTBOARD_CACHEATTR_WRITEBACK XSHAL_XT2000_CACHEATTR_WRITEBACK +#define XTBOARD_CACHEATTR_WRITEALLOC XSHAL_XT2000_CACHEATTR_WRITEALLOC +#define XTBOARD_CACHEATTR_WRITETHRU XSHAL_XT2000_CACHEATTR_WRITETHRU +#define XTBOARD_CACHEATTR_BYPASS XSHAL_XT2000_CACHEATTR_BYPASS +#define XTBOARD_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_DEFAULT + +#define XTBOARD_BUSINT_PIPE_REGIONS XSHAL_XT2000_PIPE_REGIONS +#define XTBOARD_BUSINT_SDRAM_REGIONS XSHAL_XT2000_SDRAM_REGIONS + + +/* + * FPGA registers. + * All these registers are normally accessed using 32-bit loads/stores. + */ + +/* Register offsets: */ +#define XTBOARD_DATECD_OFS 0x00 /* date code (read-only) */ +#define XTBOARD_CLKFRQ_OFS 0x04 /* clock frequency Hz (read-only) */ +#define XTBOARD_SYSLED_OFS 0x08 /* LEDs */ +#define XTBOARD_DIPSW_OFS 0x0C /* DIP switch bits (read-only) */ +#define XTBOARD_SWRST_OFS 0x10 /* software reset */ + +/* Physical register addresses: */ +#ifdef XTBOARD_FPGAREGS_PADDR +#define XTBOARD_DATECD_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SWRST_OFS) +#endif + +/* Virtual register addresses: */ +#ifdef XTBOARD_FPGAREGS_VADDR +#define XTBOARD_DATECD_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SWRST_OFS) +/* Register access (for C code): */ +#define XTBOARD_DATECD_REG (*(volatile unsigned*) XTBOARD_DATECD_VADDR) +#define XTBOARD_CLKFRQ_REG (*(volatile unsigned*) XTBOARD_CLKFRQ_VADDR) +#define XTBOARD_SYSLED_REG (*(volatile unsigned*) XTBOARD_SYSLED_VADDR) +#define XTBOARD_DIPSW_REG (*(volatile unsigned*) XTBOARD_DIPSW_VADDR) +#define XTBOARD_SWRST_REG (*(volatile unsigned*) XTBOARD_SWRST_VADDR) +#endif + +/* DATECD (date code; when core was built) bit fields: */ +/* BCD-coded month (01..12): */ +#define XTBOARD_DATECD_MONTH_SHIFT 24 +#define XTBOARD_DATECD_MONTH_BITS 8 +#define XTBOARD_DATECD_MONTH_MASK 0xFF000000 +/* BCD-coded day (01..31): */ +#define XTBOARD_DATECD_DAY_SHIFT 16 +#define XTBOARD_DATECD_DAY_BITS 8 +#define XTBOARD_DATECD_DAY_MASK 0x00FF0000 +/* BCD-coded year (2001..9999): */ +#define XTBOARD_DATECD_YEAR_SHIFT 0 +#define XTBOARD_DATECD_YEAR_BITS 16 +#define XTBOARD_DATECD_YEAR_MASK 0x0000FFFF + +/* SYSLED (system LED) bit fields: */ + +/* LED control bits (off=0, on=1): */ +#define XTBOARD_SYSLED_USER_SHIFT 0 +#define XTBOARD_SYSLED_USER_BITS 4 +#define XTBOARD_SYSLED_USER_MASK 0x0000000F + +/* DIP Switch (left=sw1=lsb=bit0, right=sw8=msb=bit7; off=0, on=1): */ +/* DIP switch bit fields (bit6/sw7 is reserved and presently unused): */ +#define XTBOARD_DIPSW_USER_SHIFT 0 /* labeled 1-6 (1=lsb) */ +#define XTBOARD_DIPSW_USER_BITS 6 +#define XTBOARD_DIPSW_USER_MASK 0x0000003F +#define XTBOARD_DIPSW_BOOT_SHIFT 7 /* labeled 8 (msb) */ +#define XTBOARD_DIPSW_BOOT_BITS 1 +#define XTBOARD_DIPSW_BOOT_MASK 0x00000080 +/* Boot settings: bit7/sw8, off=0, on=1 (this switch controls hardware): */ +#define XTBOARD_DIPSW_BOOT_RAM (0< + diff --git a/components/esp32/include/xtensa/xtav60.h b/components/esp32/include/xtensa/xtav60.h new file mode 100755 index 000000000..d7c8e3aed --- /dev/null +++ b/components/esp32/include/xtensa/xtav60.h @@ -0,0 +1,241 @@ +/* Copyright (c) 2002-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* xtav60.h - Xtensa Avnet LX60 (XT-AV60) board specific definitions */ + +#ifndef _INC_XTAV60_H_ +#define _INC_XTAV60_H_ + +#include +#include + +#define XTBOARD_NAME "XT-AV60" + + +/* + * Default assignment of XTAV60 devices to external interrupts. + */ + +/* Ethernet interrupt: */ +#ifdef XCHAL_EXTINT1_NUM +#define ETHERNET_INTNUM XCHAL_EXTINT1_NUM +#define ETHERNET_INTLEVEL XCHAL_EXTINT1_LEVEL +#define ETHERNET_INTMASK XCHAL_EXTINT1_MASK +#else +#define ETHERNET_INTMASK 0 +#endif + +/* UART interrupt: */ +#ifdef XCHAL_EXTINT0_NUM +#define UART16550_INTNUM XCHAL_EXTINT0_NUM +#define UART16550_INTLEVEL XCHAL_EXTINT0_LEVEL +#define UART16550_INTMASK XCHAL_EXTINT0_MASK +#else +#define UART16550_INTMASK 0 +#endif + +/* + * Device addresses. + * + * Note: for endianness-independence, use 32-bit loads and stores for all + * register accesses to Ethernet, UART and LED devices. Undefined bits + * may need to be masked out if needed when reading if the actual register + * size is smaller than 32 bits. + * + * Note: XTAV60 bus byte lanes are defined in terms of msbyte and lsbyte + * relative to the processor. So 32-bit registers are accessed consistently + * from both big and little endian processors. However, this means byte + * sequences are not consistent between big and little endian processors. + * This is fine for RAM, and for ROM if ROM is created for a specific + * processor (and thus has correct byte sequences). However this may be + * unexpected for Flash, which might contain a file-system that one wants + * to use for multiple processor configurations (eg. the Flash might contain + * the Ethernet card's address, endianness-independent application data, etc). + * That is, byte sequences written in Flash by a core of a given endianness + * will be byte-swapped when seen by a core of the other endianness. + * Someone implementing an endianness-independent Flash file system will + * likely handle this byte-swapping issue in the Flash driver software. + */ + +#define XTBOARD_FLASH_MAXSIZE 0x400000 /* 4 MB */ + +#ifdef XSHAL_IOBLOCK_BYPASS_PADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D030000) +# define ETHERNET_CONTROLLER_PADDR ETHERNET_PADDR /* legacy macro */ + +/* Display controller Sunplus SPLC780D, LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D040000) + +/* UART National-Semi PC16550D: */ +# define UART16550_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D050000) + +/* Boot 128K Sram address: */ +# define BOOT_SRAM_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D400000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_PADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_PADDR +# define XTBOARD_FLASH_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x08000000) +# define ETHERNET_BUFFER_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D800000) +# define BOOT_SRAM_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D400000) +#endif /* XSHAL_IOBLOCK_CACHED_PADDR */ + + +/*** Same thing over again, this time with virtual addresses: ***/ + +#ifdef XSHAL_IOBLOCK_BYPASS_VADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x08000000) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D030000) + +/* Display controller Sunplus SPLC780D, LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D040000) + +/* UART National-Semi PC16550D: */ +# define UART16550_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D050000) + +/* 128K Sram address: */ +# define BOOT_SRAM_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D400000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_VADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_VADDR +# define XTBOARD_FLASH_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x08000000) +# define ETHERNET_BUFFER_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D800000) +# define BOOT_SRAM_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D400000) +#endif /* XSHAL_IOBLOCK_CACHED_VADDR */ + + +/* System ROM: */ +#define XTBOARD_ROM_SIZE XSHAL_ROM_SIZE +#ifdef XSHAL_ROM_VADDR +#define XTBOARD_ROM_VADDR XSHAL_ROM_VADDR +#endif +#ifdef XSHAL_ROM_PADDR +#define XTBOARD_ROM_PADDR XSHAL_ROM_PADDR +#endif + +/* System RAM: */ +#define XTBOARD_RAM_SIZE XSHAL_RAM_SIZE +#ifdef XSHAL_RAM_VADDR +#define XTBOARD_RAM_VADDR XSHAL_RAM_VADDR +#endif +#ifdef XSHAL_RAM_PADDR +#define XTBOARD_RAM_PADDR XSHAL_RAM_PADDR +#endif +#define XTBOARD_RAM_BYPASS_VADDR XSHAL_RAM_BYPASS_VADDR +#define XTBOARD_RAM_BYPASS_PADDR XSHAL_RAM_BYPASS_PADDR + + + +/* + * Things that depend on device addresses. + */ + + +#define XTBOARD_CACHEATTR_WRITEBACK XSHAL_XT2000_CACHEATTR_WRITEBACK +#define XTBOARD_CACHEATTR_WRITEALLOC XSHAL_XT2000_CACHEATTR_WRITEALLOC +#define XTBOARD_CACHEATTR_WRITETHRU XSHAL_XT2000_CACHEATTR_WRITETHRU +#define XTBOARD_CACHEATTR_BYPASS XSHAL_XT2000_CACHEATTR_BYPASS +#define XTBOARD_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_DEFAULT + +#define XTBOARD_BUSINT_PIPE_REGIONS XSHAL_XT2000_PIPE_REGIONS +#define XTBOARD_BUSINT_SDRAM_REGIONS XSHAL_XT2000_SDRAM_REGIONS + + +/* + * FPGA registers. + * All these registers are normally accessed using 32-bit loads/stores. + */ + +/* Register offsets: */ +#define XTBOARD_DATECD_OFS 0x00 /* date code (read-only) */ +#define XTBOARD_CLKFRQ_OFS 0x04 /* clock frequency Hz (read-only) */ +#define XTBOARD_DIPSW_OFS 0x0C /* DIP switch bits (read-only) */ +#define XTBOARD_SWRST_OFS 0x10 /* software reset */ + +/* Physical register addresses: */ +#ifdef XTBOARD_FPGAREGS_PADDR +#define XTBOARD_DATECD_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_DIPSW_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SWRST_OFS) +#endif + +/* Virtual register addresses: */ +#ifdef XTBOARD_FPGAREGS_VADDR +#define XTBOARD_DATECD_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_DIPSW_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SWRST_OFS) +/* Register access (for C code): */ +#define XTBOARD_DATECD_REG (*(volatile unsigned*) XTBOARD_DATECD_VADDR) +#define XTBOARD_CLKFRQ_REG (*(volatile unsigned*) XTBOARD_CLKFRQ_VADDR) +#define XTBOARD_DIPSW_REG (*(volatile unsigned*) XTBOARD_DIPSW_VADDR) +#define XTBOARD_SWRST_REG (*(volatile unsigned*) XTBOARD_SWRST_VADDR) +#endif + +/* DATECD (date code; when core was built) bit fields: */ +/* BCD-coded month (01..12): */ +#define XTBOARD_DATECD_MONTH_SHIFT 24 +#define XTBOARD_DATECD_MONTH_BITS 8 +#define XTBOARD_DATECD_MONTH_MASK 0xFF000000 +/* BCD-coded day (01..31): */ +#define XTBOARD_DATECD_DAY_SHIFT 16 +#define XTBOARD_DATECD_DAY_BITS 8 +#define XTBOARD_DATECD_DAY_MASK 0x00FF0000 +/* BCD-coded year (2001..9999): */ +#define XTBOARD_DATECD_YEAR_SHIFT 0 +#define XTBOARD_DATECD_YEAR_BITS 16 +#define XTBOARD_DATECD_YEAR_MASK 0x0000FFFF + +/* DIP Switch (left=sw1=lsb=bit0, right=sw8=msb=bit7; off=0, on=1): */ +/* DIP switch bit fields (bit6/sw7 is reserved and presently unused): */ +#define XTBOARD_DIPSW_USER_SHIFT 0 /* labeled 1-6 (1=lsb) */ +#define XTBOARD_DIPSW_USER_BITS 6 +#define XTBOARD_DIPSW_USER_MASK 0x0000003F +#define XTBOARD_DIPSW_BOOT_SHIFT 7 /* labeled 8 (msb) */ +#define XTBOARD_DIPSW_BOOT_BITS 1 +#define XTBOARD_DIPSW_BOOT_MASK 0x00000080 +/* Boot settings: bit7/sw8, off=0, on=1 (this switch controls hardware): */ +#define XTBOARD_DIPSW_BOOT_RAM (0< + diff --git a/components/esp32/include/xtensa/xtav60/xtensa/lcd-splc780d-board.h b/components/esp32/include/xtensa/xtav60/xtensa/lcd-splc780d-board.h new file mode 100755 index 000000000..629a32581 --- /dev/null +++ b/components/esp32/include/xtensa/xtav60/xtensa/lcd-splc780d-board.h @@ -0,0 +1,60 @@ +/******************************************************************************* + +Copyright (c) 2006-2007 by Tensilica Inc. ALL RIGHTS RESERVED. +These coded instructions, statements, and computer programs are the +copyrighted works and confidential proprietary information of Tensilica Inc. +They may not be modified, copied, reproduced, distributed, or disclosed to +third parties in any manner, medium, or form, in whole or in part, without +the prior written consent of Tensilica Inc. +-------------------------------------------------------------------------------- + +lcd-splc780d-board.h Board-specific LCD info on Avnet AV60 (XT-AV60) board. + +Interface between board-independent driver and board-specific header. + +This is used by a board-independent SPLC780D LCD controller driver to obtain +board-specific information about LCD displays on the board, such as the +controller register base address and spacing (a function of how the address +lines are connected on the board) and length of the visible window of the +display (a function of the LCD panel the controller drives). The driver does +not refer directly to the board-specific header, which therefore is not +constrained to use macro names consistent with other boards. + +!! Must not contain any board-specific macro names (only controller specific) !! + +Included at compile-time via an include path specific to the board. + +The XT-AV60 board contains a single MYTech MOC-16216B-B display driven by +a Sunplus SPLC870D controller. + +*******************************************************************************/ + +#ifndef _LCD_SPLC780D_BOARD_H +#define _LCD_SPLC780D_BOARD_H + +#include /* Board info */ + + +/* Base address of the controller's registers. */ +#ifdef SPLC780D_VADDR +#define SPLC780D_REGBASE SPLC780D_VADDR +#endif + +/* +The controller's registers are connected at word addresses on the XT-AV60. +Each byte-wide register appears as the least-significant-byte (LSB) of the +word regardless of the endianness of the processor (so if using word accesses +then endianness doesn't matter). +*/ +#define SPLC780D_REGSPACING 4 +typedef unsigned splc780d_reg_t; + +/* Include generic information shared by all boards that use this device. */ +#include + + +/* Display limits of the LCD panel. */ +#define DISPLAY_VISIBLE_LEN 16 /* length (chars) of visible window */ + +#endif /* _LCD_SPLC780D_BOARD_H */ + diff --git a/components/esp32/include/xtensa/xtbsp.h b/components/esp32/include/xtensa/xtbsp.h new file mode 100755 index 000000000..62356dd86 --- /dev/null +++ b/components/esp32/include/xtensa/xtbsp.h @@ -0,0 +1,269 @@ +/******************************************************************************* + + Copyright (c) 2006-2009 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +-------------------------------------------------------------------------------- + +xtbsp.h Xtensa Board Support Package API + +This API defines a minimal set of board-support functions that every supported +Xtensa board is expected to provide in the board-support-package (BSP) library +associated with the board-specific LSP. Only basic board functions are provided +in this board-independent API. API functions not applicable to a board must be +stubbed in its BSP library. More complex operations must use a board-specific +interface. Functions are grouped by type of peripheral device. + +*******************************************************************************/ + +#ifndef _XTBSP_H_ +#define _XTBSP_H_ + + +#ifdef __cplusplus +extern "C" { +#endif + + +/******************************************************************************* +BOARD INITIALIZATION. +The board with all its devices is initialized by xtbsp_board_init(). +Individual devices represented by this API can be reinitialized at any +time by calling their inidividual device init functions (grouped with +other device functions). This might be useful to (say) change the baud +rate of the UART. +*/ + + +/* +Initialize the board. Must call before any other API function. +Iniitializes BSP, board in general, and all devices on the board. +*/ +extern void xtbsp_board_init(void); + + +/******************************************************************************* +BOARD CHARACTERISTICS and CONVENIENCE FUNCTIONS. +Board support functions not associated with a particular peripheral device. +*/ + +/* +Return a short string representing the type of board. +If the board has a display, the string must fit on a single line. +*/ +extern const char * xtbsp_board_name(void); + +/* +Hardware reset the entire board (if possible). Does not return if successful. +If this function returns, it is stubbed out or not possible with this board. +*/ +extern void xtbsp_board_reset(void); + +/* +Return the clock frequency in Hertz. May be constant or computed. +*/ +extern unsigned xtbsp_clock_freq_hz(void); + +/* +Return the clock period in picoseconds. May be constant or computed. +*/ +extern unsigned xtbsp_clock_period_ps(void); + +/* +Spin (at least) a number of cycles per the processor's CCOUNT register. +Unlike a s/w delay loop, the duration is not affected by compiler +optimization or interrupts completed within the delay period. +If the processor doesn't have CCOUNT, a s/w delay loop is used to obtain +a rough approximation of the cycle count. +*/ +extern void xtbsp_delay_cycles(unsigned cycles); + +/* +Spin at least a number of nanoseconds (approximate and err in the high side). +BSP implementation should do this efficiently, avoiding integer overflow or +excessive loss of precision, run-time division or floating point. +Function implementation (vs. macro) allows BSP to optimize for the clock +frequency by pre-computing (or using constant) scale factors. +*/ +extern void xtbsp_delay_ns(unsigned ns); + + +/******************************************************************************* +C LIBRARY SUPPORT. +These functions are called by the C library libgloss interface. +Their names are predetermined apart from this BSP API. +*/ + +/* +Initialize the board. Called by C library initialization code. +Usually simply calls xtbsp_board_init(). +*/ +extern void board_init(void); + +/* +(Wait for and) Input a single byte from the default character I/O +device. Return -1 if there is no input device. +This device is usually a UART and this function calls xtbsp_uart_getchar(). +On some boards (eg.) it might be a directly connected keyboard. +*/ +extern int inbyte(void); + +/* +Output a single char to the default character I/O device (and wait +until it's been taken). +This device is usually a UART and this function calls xtbsp_uart_putchar(). +On some boards (eg.) it might be a directly connected bit-mapped screen. +*/ +extern void outbyte(int c); + + +/******************************************************************************* +UART (SERIAL I/O). +Supports a single UART in a simple polling mode and provides control of +receiver and transmitter data interrupts (client must provide handler). +Provides a mapping to processor interrupt number which can be used with +the HAL to control processor interrupt enable (INTENABLE) etc. +*/ + +/* Bitmasks to identify UART interrupts. */ +typedef enum xtbsp_uart_int { + xtbsp_uart_int_rx = 1<<0, + xtbsp_uart_int_tx = 1<<1, + /* mask of all valid interrupt bits */ + xtbsp_uart_int_all = (1<<2)-1 +} xtbsp_uart_int; + +/* +Return non-zero if the board has a UART. +*/ +extern int xtbsp_uart_exists(void); + +/* +Initialize the UART: + parity = 0 (none), 1 (odd), or 2 (even). + nstop = 1 or 2 (stop bits). + ndata = 7 or 8 (data bits). +Disables all UART interrupts. +Returns non-zero if failed (perhaps due to unsupported parameter values). +Must call before any of the following functions. +*/ +extern int xtbsp_uart_init(unsigned baud, unsigned ndata, + unsigned parity, unsigned nstop); +#define xtbsp_uart_init_default() xtbsp_uart_init(38400, 8, 0, 1) + +/* +(Wait for and) Input a single char from the UART. +Any pending xtbsp_uart_int_rx interrupt is cleared. +*/ +extern char xtbsp_uart_getchar(void); + +/* +(Wait for transmitter ready and) Output a single char to the UART. +Any pending xtbsp_uart_int_tx interrupt is cleared. +*/ +extern void xtbsp_uart_putchar(const char c); + +/* +Return true (non-zero) if a character has been received and is ready +to be input by xtbsp_uart_getchar() without waiting, else return 0. +*/ +extern int xtbsp_uart_get_isready(void); + +/* +Return non-zero if a character may be output by xtbsp_uart_putchar() +without waiting, else return 0. +Any pending xtbsp_uart_int_tx interrupt is cleared. +*/ +extern int xtbsp_uart_put_isready(void); + +/* +Return the enable status of all UART interrupts represented by this API, +that is those with bits defined in type xtbsp_uart_int (1 bit = enabled). +This is the enable status at the device, not the processor's INTENABLE. +*/ +extern xtbsp_uart_int xtbsp_uart_int_enable_status(void); + +/* +Enable selected UART interrupts at the device. +*/ +extern void xtbsp_uart_int_enable(const xtbsp_uart_int mask); + +/* +Disable selected UART interrupts at the device. +*/ +extern void xtbsp_uart_int_disable(const xtbsp_uart_int mask); + +/* +Return the interrupt number (0..31) to which the selected UART interrupt +is connected. May be used with the link-time HAL to obtain more information, +eg. Xthal_intlevel_mask[xtbsp_uart_int_number(xtbsp_uart_int_rx)] +This information can be used to control the processor's INTENABLE, etc. +Result is -1 if not connected, undefined if mask has more than 1 bit set. +*/ +extern int xtbsp_uart_int_number(const xtbsp_uart_int mask); + + +/******************************************************************************* +DISPLAY. +Supports a single display that can render a series of ASCII characters. +Functions are provided to perform generic display tasks such as display +a string, display character by character, or blank the display. +Chars are 7-bit printable ASCII. Strings are C style NUL \0 terminated. +These functions busy-wait for any required timing delays so the caller does +not have to deal with timing. Some displays require long delays which in +some client applications warrant a board and RTOS specific approach to +driving the display, however that is beyond the scope of this API. +*/ + +/* +Return non-zero if board has a display. +*/ +extern int xtbsp_display_exists(void); + +/* +Initialize the display. Must call before any of the following functions. +*/ +extern void xtbsp_display_init(void); + +/* +Display a single char at position pos (0 is leftmost). Other positions are +left untouched. Positions beyond the width of the display are ignored. +*/ +extern void xtbsp_display_char(unsigned pos, const char c); + +/* +Display a string. Blank-pad to or truncate at the end of the display +(overwrites any previous string so don't need to blank display first). +*/ +extern void xtbsp_display_string(const char *s); + +/* +Blank (clear) the entire display. +*/ +extern void xtbsp_display_blank(void); + + + +#ifdef __cplusplus +} +#endif + +#endif /* _XTBSP_H_ */ diff --git a/components/esp32/include/xtensa/xtensa-libdb-macros.h b/components/esp32/include/xtensa/xtensa-libdb-macros.h new file mode 100755 index 000000000..fbbe50964 --- /dev/null +++ b/components/esp32/include/xtensa/xtensa-libdb-macros.h @@ -0,0 +1,161 @@ +/* + * xtensa-libdb-macros.h + */ + +/* $Id: //depot/rel/Eaglenest/Xtensa/Software/libdb/xtensa-libdb-macros.h#1 $ */ + +/* Copyright (c) 2004-2008 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef __H_LIBDB_MACROS +#define __H_LIBDB_MACROS + +/* + * This header file provides macros used to construct, identify and use + * "target numbers" that are assigned to various types of Xtensa processor + * registers and states. These target numbers are used by GDB in the remote + * protocol, and are thus used by all GDB debugger agents (targets). + * They are also used in ELF debugger information sections (stabs, dwarf, etc). + * + * These macros are separated from xtensa-libdb.h because they are needed + * by certain debugger agents that do not use or have access to libdb, + * e.g. the OCD daemon, RedBoot, XMON, etc. + * + * For the time being, for compatibility with certain 3rd party debugger + * software vendors, target numbers are limited to 16 bits. It is + * conceivable that this will be extended in the future to 32 bits. + */ + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef uint32 + #define uint32 unsigned int +#endif +#ifndef int32 + #define int32 int +#endif + + +/* + * Macros to form register "target numbers" for various standard registers/states: + */ +#define XTENSA_DBREGN_INVALID -1 /* not a valid target number */ +#define XTENSA_DBREGN_A(n) (0x0000+(n)) /* address registers a0..a15 */ +#define XTENSA_DBREGN_B(n) (0x0010+(n)) /* boolean bits b0..b15 */ +#define XTENSA_DBREGN_PC 0x0020 /* program counter */ + /* 0x0021 RESERVED for use by Tensilica */ +#define XTENSA_DBREGN_BO(n) (0x0022+(n)) /* boolean octuple-bits bo0..bo1 */ +#define XTENSA_DBREGN_BQ(n) (0x0024+(n)) /* boolean quadruple-bits bq0..bq3 */ +#define XTENSA_DBREGN_BD(n) (0x0028+(n)) /* boolean double-bits bd0..bd7 */ +#define XTENSA_DBREGN_F(n) (0x0030+(n)) /* floating point registers f0..f15 */ +#define XTENSA_DBREGN_VEC(n) (0x0040+(n)) /* Vectra vec regs v0..v15 */ +#define XTENSA_DBREGN_VSEL(n) (0x0050+(n)) /* Vectra sel s0..s3 (V1) ..s7 (V2) */ +#define XTENSA_DBREGN_VALIGN(n) (0x0058+(n)) /* Vectra valign regs u0..u3 */ +#define XTENSA_DBREGN_VCOEFF(n) (0x005C+(n)) /* Vectra I vcoeff regs c0..c1 */ + /* 0x005E..0x005F RESERVED for use by Tensilica */ +#define XTENSA_DBREGN_AEP(n) (0x0060+(n)) /* HiFi2 Audio Engine regs aep0..aep7 */ +#define XTENSA_DBREGN_AEQ(n) (0x0068+(n)) /* HiFi2 Audio Engine regs aeq0..aeq3 */ + /* 0x006C..0x00FF RESERVED for use by Tensilica */ +#define XTENSA_DBREGN_AR(n) (0x0100+(n)) /* physical address regs ar0..ar63 + (note: only with window option) */ + /* 0x0140..0x01FF RESERVED for use by Tensilica */ +#define XTENSA_DBREGN_SREG(n) (0x0200+(n)) /* special registers 0..255 (core) */ +#define XTENSA_DBREGN_BR XTENSA_DBREGN_SREG(0x04) /* all 16 boolean bits, BR */ +#define XTENSA_DBREGN_MR(n) XTENSA_DBREGN_SREG(0x20+(n)) /* MAC16 registers m0..m3 */ +#define XTENSA_DBREGN_UREG(n) (0x0300+(n)) /* user registers 0..255 (TIE) */ + /* 0x0400..0x0FFF RESERVED for use by Tensilica */ + /* 0x1000..0x1FFF user-defined regfiles */ + /* 0x2000..0xEFFF other states (and regfiles) */ +#define XTENSA_DBREGN_DBAGENT(n) (0xF000+(n)) /* non-processor "registers" 0..4095 for + 3rd-party debugger agent defined use */ + /* > 0xFFFF (32-bit) RESERVED for use by Tensilica */ +/*#define XTENSA_DBREGN_CONTEXT(n) (0x02000000+((n)<<20))*/ /* add this macro's value to a target + number to identify a specific context 0..31 + for context-replicated registers */ +#define XTENSA_DBREGN_MASK 0xFFFF /* mask of valid target_number bits */ +#define XTENSA_DBREGN_WRITE_SIDE 0x04000000 /* flag to request write half of a register + split into distinct read and write entries + with the same target number (currently only + valid in a couple of libdb API functions; + see xtensa-libdb.h for details) */ + +/* + * Macros to identify specific ranges of target numbers (formed above): + * NOTE: any context number (or other upper 12 bits) are considered + * modifiers and are thus stripped out for identification purposes. + */ +#define XTENSA_DBREGN_IS_VALID(tn) (((tn) & ~0xFFFF) == 0) /* just tests it's 16-bit unsigned */ +#define XTENSA_DBREGN_IS_A(tn) (((tn) & 0xFFF0)==0x0000) /* is a0..a15 */ +#define XTENSA_DBREGN_IS_B(tn) (((tn) & 0xFFF0)==0x0010) /* is b0..b15 */ +#define XTENSA_DBREGN_IS_PC(tn) (((tn) & 0xFFFF)==0x0020) /* is program counter */ +#define XTENSA_DBREGN_IS_BO(tn) (((tn) & 0xFFFE)==0x0022) /* is bo0..bo1 */ +#define XTENSA_DBREGN_IS_BQ(tn) (((tn) & 0xFFFC)==0x0024) /* is bq0..bq3 */ +#define XTENSA_DBREGN_IS_BD(tn) (((tn) & 0xFFF8)==0x0028) /* is bd0..bd7 */ +#define XTENSA_DBREGN_IS_F(tn) (((tn) & 0xFFF0)==0x0030) /* is f0..f15 */ +#define XTENSA_DBREGN_IS_VEC(tn) (((tn) & 0xFFF0)==0x0040) /* is v0..v15 */ +#define XTENSA_DBREGN_IS_VSEL(tn) (((tn) & 0xFFF8)==0x0050) /* is s0..s7 (s0..s3 in V1) */ +#define XTENSA_DBREGN_IS_VALIGN(tn) (((tn) & 0xFFFC)==0x0058) /* is u0..u3 */ +#define XTENSA_DBREGN_IS_VCOEFF(tn) (((tn) & 0xFFFE)==0x005C) /* is c0..c1 */ +#define XTENSA_DBREGN_IS_AEP(tn) (((tn) & 0xFFF8)==0x0060) /* is aep0..aep7 */ +#define XTENSA_DBREGN_IS_AEQ(tn) (((tn) & 0xFFFC)==0x0068) /* is aeq0..aeq3 */ +#define XTENSA_DBREGN_IS_AR(tn) (((tn) & 0xFFC0)==0x0100) /* is ar0..ar63 */ +#define XTENSA_DBREGN_IS_SREG(tn) (((tn) & 0xFF00)==0x0200) /* is special register */ +#define XTENSA_DBREGN_IS_BR(tn) (((tn) & 0xFFFF)==XTENSA_DBREGN_SREG(0x04)) /* is BR */ +#define XTENSA_DBREGN_IS_MR(tn) (((tn) & 0xFFFC)==XTENSA_DBREGN_SREG(0x20)) /* m0..m3 */ +#define XTENSA_DBREGN_IS_UREG(tn) (((tn) & 0xFF00)==0x0300) /* is user register */ +#define XTENSA_DBREGN_IS_DBAGENT(tn) (((tn) & 0xF000)==0xF000) /* is non-processor */ +/*#define XTENSA_DBREGN_IS_CONTEXT(tn) (((tn) & 0x02000000) != 0)*/ /* specifies context # */ + +/* + * Macros to extract register index from a register "target number" + * when a specific range has been identified using one of the _IS_ macros above. + * These macros only return a useful value if the corresponding _IS_ macro returns true. + */ +#define XTENSA_DBREGN_A_INDEX(tn) ((tn) & 0x0F) /* 0..15 for a0..a15 */ +#define XTENSA_DBREGN_B_INDEX(tn) ((tn) & 0x0F) /* 0..15 for b0..b15 */ +#define XTENSA_DBREGN_BO_INDEX(tn) ((tn) & 0x01) /* 0..1 for bo0..bo1 */ +#define XTENSA_DBREGN_BQ_INDEX(tn) ((tn) & 0x03) /* 0..3 for bq0..bq3 */ +#define XTENSA_DBREGN_BD_INDEX(tn) ((tn) & 0x07) /* 0..7 for bd0..bd7 */ +#define XTENSA_DBREGN_F_INDEX(tn) ((tn) & 0x0F) /* 0..15 for f0..f15 */ +#define XTENSA_DBREGN_VEC_INDEX(tn) ((tn) & 0x0F) /* 0..15 for v0..v15 */ +#define XTENSA_DBREGN_VSEL_INDEX(tn) ((tn) & 0x07) /* 0..7 for s0..s7 */ +#define XTENSA_DBREGN_VALIGN_INDEX(tn) ((tn) & 0x03) /* 0..3 for u0..u3 */ +#define XTENSA_DBREGN_VCOEFF_INDEX(tn) ((tn) & 0x01) /* 0..1 for c0..c1 */ +#define XTENSA_DBREGN_AEP_INDEX(tn) ((tn) & 0x07) /* 0..7 for aep0..aep7 */ +#define XTENSA_DBREGN_AEQ_INDEX(tn) ((tn) & 0x03) /* 0..3 for aeq0..aeq3 */ +#define XTENSA_DBREGN_AR_INDEX(tn) ((tn) & 0x3F) /* 0..63 for ar0..ar63 */ +#define XTENSA_DBREGN_SREG_INDEX(tn) ((tn) & 0xFF) /* 0..255 for special registers */ +#define XTENSA_DBREGN_MR_INDEX(tn) ((tn) & 0x03) /* 0..3 for m0..m3 */ +#define XTENSA_DBREGN_UREG_INDEX(tn) ((tn) & 0xFF) /* 0..255 for user registers */ +#define XTENSA_DBREGN_DBAGENT_INDEX(tn) ((tn) & 0xFFF) /* 0..4095 for non-processor */ +/*#define XTENSA_DBREGN_CONTEXT_INDEX(tn) (((tn) >> 20) & 0x1F)*/ /* 0..31 context numbers */ + + + + +#ifdef __cplusplus +} +#endif + +#endif /* __H_LIBDB_MACROS */ + diff --git a/components/esp32/include/xtensa/xtensa-versions.h b/components/esp32/include/xtensa/xtensa-versions.h new file mode 100755 index 000000000..abed3a18d --- /dev/null +++ b/components/esp32/include/xtensa/xtensa-versions.h @@ -0,0 +1,347 @@ +/* + xtensa-versions.h -- definitions of Xtensa version and release numbers + + This file defines most Xtensa-related product versions and releases + that exist so far. + It also provides a bit of information about which ones are current. + This file changes every release, as versions/releases get added. + + + $Id: //depot/rel/Eaglenest/Xtensa/Software/misc/xtensa-versions.h.tpp#2 $ + + Copyright (c) 2006-2010 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +*/ + +#ifndef XTENSA_VERSIONS_H +#define XTENSA_VERSIONS_H + + +/* + * NOTE: A "release" is a collection of product versions + * made available at once (together) to customers. + * In the past, release and version names all matched in T####.# form, + * making the distinction irrelevant. + * Starting with the RA-2004.1 release, this is no longer the case. + */ + + +/* Hardware (Xtensa/Diamond processor) versions: */ +#define XTENSA_HWVERSION_T1020_0 102000 /* versions T1020.0 */ +#define XTENSA_HWCIDSCHEME_T1020_0 10 +#define XTENSA_HWCIDVERS_T1020_0 2 +#define XTENSA_HWVERSION_T1020_1 102001 /* versions T1020.1 */ +#define XTENSA_HWCIDSCHEME_T1020_1 10 +#define XTENSA_HWCIDVERS_T1020_1 3 +#define XTENSA_HWVERSION_T1020_2B 102002 /* versions T1020.2b */ +#define XTENSA_HWCIDSCHEME_T1020_2B 10 +#define XTENSA_HWCIDVERS_T1020_2B 5 +#define XTENSA_HWVERSION_T1020_2 102002 /* versions T1020.2 */ +#define XTENSA_HWCIDSCHEME_T1020_2 10 +#define XTENSA_HWCIDVERS_T1020_2 4 +#define XTENSA_HWVERSION_T1020_3 102003 /* versions T1020.3 */ +#define XTENSA_HWCIDSCHEME_T1020_3 10 +#define XTENSA_HWCIDVERS_T1020_3 6 +#define XTENSA_HWVERSION_T1020_4 102004 /* versions T1020.4 */ +#define XTENSA_HWCIDSCHEME_T1020_4 10 +#define XTENSA_HWCIDVERS_T1020_4 7 +#define XTENSA_HWVERSION_T1030_0 103000 /* versions T1030.0 */ +#define XTENSA_HWCIDSCHEME_T1030_0 10 +#define XTENSA_HWCIDVERS_T1030_0 9 +#define XTENSA_HWVERSION_T1030_1 103001 /* versions T1030.1 */ +#define XTENSA_HWCIDSCHEME_T1030_1 10 +#define XTENSA_HWCIDVERS_T1030_1 10 +#define XTENSA_HWVERSION_T1030_2 103002 /* versions T1030.2 */ +#define XTENSA_HWCIDSCHEME_T1030_2 10 +#define XTENSA_HWCIDVERS_T1030_2 11 +#define XTENSA_HWVERSION_T1030_3 103003 /* versions T1030.3 */ +#define XTENSA_HWCIDSCHEME_T1030_3 10 +#define XTENSA_HWCIDVERS_T1030_3 12 +#define XTENSA_HWVERSION_T1040_0 104000 /* versions T1040.0 */ +#define XTENSA_HWCIDSCHEME_T1040_0 10 +#define XTENSA_HWCIDVERS_T1040_0 15 +#define XTENSA_HWVERSION_T1040_1 104001 /* versions T1040.1 */ +#define XTENSA_HWCIDSCHEME_T1040_1 01 +#define XTENSA_HWCIDVERS_T1040_1 32 +#define XTENSA_HWVERSION_T1040_1P 104001 /* versions T1040.1-prehotfix */ +#define XTENSA_HWCIDSCHEME_T1040_1P 10 +#define XTENSA_HWCIDVERS_T1040_1P 16 +#define XTENSA_HWVERSION_T1040_2 104002 /* versions T1040.2 */ +#define XTENSA_HWCIDSCHEME_T1040_2 01 +#define XTENSA_HWCIDVERS_T1040_2 33 +#define XTENSA_HWVERSION_T1040_3 104003 /* versions T1040.3 */ +#define XTENSA_HWCIDSCHEME_T1040_3 01 +#define XTENSA_HWCIDVERS_T1040_3 34 +#define XTENSA_HWVERSION_T1050_0 105000 /* versions T1050.0 */ +#define XTENSA_HWCIDSCHEME_T1050_0 1100 +#define XTENSA_HWCIDVERS_T1050_0 1 +#define XTENSA_HWVERSION_T1050_1 105001 /* versions T1050.1 */ +#define XTENSA_HWCIDSCHEME_T1050_1 1100 +#define XTENSA_HWCIDVERS_T1050_1 2 +#define XTENSA_HWVERSION_T1050_2 105002 /* versions T1050.2 */ +#define XTENSA_HWCIDSCHEME_T1050_2 1100 +#define XTENSA_HWCIDVERS_T1050_2 4 +#define XTENSA_HWVERSION_T1050_3 105003 /* versions T1050.3 */ +#define XTENSA_HWCIDSCHEME_T1050_3 1100 +#define XTENSA_HWCIDVERS_T1050_3 6 +#define XTENSA_HWVERSION_T1050_4 105004 /* versions T1050.4 */ +#define XTENSA_HWCIDSCHEME_T1050_4 1100 +#define XTENSA_HWCIDVERS_T1050_4 7 +#define XTENSA_HWVERSION_T1050_5 105005 /* versions T1050.5 */ +#define XTENSA_HWCIDSCHEME_T1050_5 1100 +#define XTENSA_HWCIDVERS_T1050_5 8 +#define XTENSA_HWVERSION_RA_2004_1 210000 /* versions LX1.0.0 */ +#define XTENSA_HWCIDSCHEME_RA_2004_1 1100 +#define XTENSA_HWCIDVERS_RA_2004_1 3 +#define XTENSA_HWVERSION_RA_2005_1 210001 /* versions LX1.0.1 */ +#define XTENSA_HWCIDSCHEME_RA_2005_1 1100 +#define XTENSA_HWCIDVERS_RA_2005_1 20 +#define XTENSA_HWVERSION_RA_2005_2 210002 /* versions LX1.0.2 */ +#define XTENSA_HWCIDSCHEME_RA_2005_2 1100 +#define XTENSA_HWCIDVERS_RA_2005_2 21 +#define XTENSA_HWVERSION_RA_2005_3 210003 /* versions LX1.0.3, X6.0.3 */ +#define XTENSA_HWCIDSCHEME_RA_2005_3 1100 +#define XTENSA_HWCIDVERS_RA_2005_3 22 +#define XTENSA_HWVERSION_RA_2006_4 210004 /* versions LX1.0.4, X6.0.4 */ +#define XTENSA_HWCIDSCHEME_RA_2006_4 1100 +#define XTENSA_HWCIDVERS_RA_2006_4 23 +#define XTENSA_HWVERSION_RA_2006_5 210005 /* versions LX1.0.5, X6.0.5 */ +#define XTENSA_HWCIDSCHEME_RA_2006_5 1100 +#define XTENSA_HWCIDVERS_RA_2006_5 24 +#define XTENSA_HWVERSION_RA_2006_6 210006 /* versions LX1.0.6, X6.0.6 */ +#define XTENSA_HWCIDSCHEME_RA_2006_6 1100 +#define XTENSA_HWCIDVERS_RA_2006_6 25 +#define XTENSA_HWVERSION_RA_2007_7 210007 /* versions LX1.0.7, X6.0.7 */ +#define XTENSA_HWCIDSCHEME_RA_2007_7 1100 +#define XTENSA_HWCIDVERS_RA_2007_7 26 +#define XTENSA_HWVERSION_RA_2008_8 210008 /* versions LX1.0.8, X6.0.8 */ +#define XTENSA_HWCIDSCHEME_RA_2008_8 1100 +#define XTENSA_HWCIDVERS_RA_2008_8 27 +#define XTENSA_HWVERSION_RB_2006_0 220000 /* versions LX2.0.0, X7.0.0 */ +#define XTENSA_HWCIDSCHEME_RB_2006_0 1100 +#define XTENSA_HWCIDVERS_RB_2006_0 48 +#define XTENSA_HWVERSION_RB_2007_1 220001 /* versions LX2.0.1, X7.0.1 */ +#define XTENSA_HWCIDSCHEME_RB_2007_1 1100 +#define XTENSA_HWCIDVERS_RB_2007_1 49 +#define XTENSA_HWVERSION_RB_2007_2 221000 /* versions LX2.1.0, X7.1.0 */ +#define XTENSA_HWCIDSCHEME_RB_2007_2 1100 +#define XTENSA_HWCIDVERS_RB_2007_2 52 +#define XTENSA_HWVERSION_RB_2008_3 221001 /* versions LX2.1.1, X7.1.1 */ +#define XTENSA_HWCIDSCHEME_RB_2008_3 1100 +#define XTENSA_HWCIDVERS_RB_2008_3 53 +#define XTENSA_HWVERSION_RB_2008_4 221002 /* versions LX2.1.2, X7.1.2 */ +#define XTENSA_HWCIDSCHEME_RB_2008_4 1100 +#define XTENSA_HWCIDVERS_RB_2008_4 54 +#define XTENSA_HWVERSION_RB_2009_5 221003 /* versions LX2.1.3, X7.1.3 */ +#define XTENSA_HWCIDSCHEME_RB_2009_5 1100 +#define XTENSA_HWCIDVERS_RB_2009_5 55 +#define XTENSA_HWVERSION_RB_2007_2_MP 221100 /* versions LX2.1.8-MP, X7.1.8-MP */ +#define XTENSA_HWCIDSCHEME_RB_2007_2_MP 1100 +#define XTENSA_HWCIDVERS_RB_2007_2_MP 64 +#define XTENSA_HWVERSION_RC_2009_0 230000 /* versions LX3.0.0, X8.0.0, MX1.0.0 */ +#define XTENSA_HWCIDSCHEME_RC_2009_0 1100 +#define XTENSA_HWCIDVERS_RC_2009_0 65 +#define XTENSA_HWVERSION_RC_2010_1 230001 /* versions LX3.0.1, X8.0.1, MX1.0.1 */ +#define XTENSA_HWCIDSCHEME_RC_2010_1 1100 +#define XTENSA_HWCIDVERS_RC_2010_1 66 +#define XTENSA_HWVERSION_RC_2010_2 230002 /* versions LX3.0.2, X8.0.2, MX1.0.2 */ +#define XTENSA_HWCIDSCHEME_RC_2010_2 1100 +#define XTENSA_HWCIDVERS_RC_2010_2 67 +#define XTENSA_HWVERSION_RC_2011_3 230003 /* versions LX3.0.3, X8.0.3, MX1.0.3 */ +#define XTENSA_HWCIDSCHEME_RC_2011_3 1100 +#define XTENSA_HWCIDVERS_RC_2011_3 68 +#define XTENSA_HWVERSION_RD_2010_0 240000 /* versions LX4.0.0, X9.0.0, MX1.1.0, TX1.0.0 */ +#define XTENSA_HWCIDSCHEME_RD_2010_0 1100 +#define XTENSA_HWCIDVERS_RD_2010_0 80 +#define XTENSA_HWVERSION_RD_2011_1 240001 /* versions LX4.0.1, X9.0.1, MX1.1.1, TX1.0.1 */ +#define XTENSA_HWCIDSCHEME_RD_2011_1 1100 +#define XTENSA_HWCIDVERS_RD_2011_1 81 +#define XTENSA_HWVERSION_RD_2011_2 240002 /* versions LX4.0.2, X9.0.2, MX1.1.2, TX1.0.2 */ +#define XTENSA_HWCIDSCHEME_RD_2011_2 1100 +#define XTENSA_HWCIDVERS_RD_2011_2 82 +#define XTENSA_HWVERSION_RD_2011_3 240003 /* versions LX4.0.3, X9.0.3, MX1.1.3, TX1.0.3 */ +#define XTENSA_HWCIDSCHEME_RD_2011_3 1100 +#define XTENSA_HWCIDVERS_RD_2011_3 83 +#define XTENSA_HWVERSION_RD_2012_4 240004 /* versions LX4.0.4, X9.0.4, MX1.1.4, TX1.0.4 */ +#define XTENSA_HWCIDSCHEME_RD_2012_4 1100 +#define XTENSA_HWCIDVERS_RD_2012_4 84 +#define XTENSA_HWVERSION_RD_2012_5 240005 /* versions LX4.0.5, X9.0.5, MX1.1.5, TX1.0.5 */ +#define XTENSA_HWCIDSCHEME_RD_2012_5 1100 +#define XTENSA_HWCIDVERS_RD_2012_5 85 +#define XTENSA_HWVERSION_RE_2012_0 250000 /* versions LX5.0.0, X10.0.0, MX1.2.0, TX2.0.0 */ +#define XTENSA_HWCIDSCHEME_RE_2012_0 1100 +#define XTENSA_HWCIDVERS_RE_2012_0 96 +#define XTENSA_HWVERSION_RE_2012_1 250001 /* versions LX5.0.1, X10.0.1, MX1.2.1, TX2.0.1 */ +#define XTENSA_HWCIDSCHEME_RE_2012_1 1100 +#define XTENSA_HWCIDVERS_RE_2012_1 97 +#define XTENSA_HWVERSION_RE_2013_2 250002 /* versions LX5.0.2, X10.0.2, MX1.2.2, TX2.0.2 */ +#define XTENSA_HWCIDSCHEME_RE_2013_2 1100 +#define XTENSA_HWCIDVERS_RE_2013_2 98 +#define XTENSA_HWVERSION_RE_2013_3 250003 /* versions LX5.0.3, X10.0.3, MX1.2.3, TX2.0.3 */ +#define XTENSA_HWCIDSCHEME_RE_2013_3 1100 +#define XTENSA_HWCIDVERS_RE_2013_3 99 +#define XTENSA_HWVERSION_RE_2013_4 250004 /* versions LX5.0.4, X10.0.4, MX1.2.4, TX2.0.4 */ +#define XTENSA_HWCIDSCHEME_RE_2013_4 1100 +#define XTENSA_HWCIDVERS_RE_2013_4 100 +#define XTENSA_HWVERSION_RE_2014_5 250005 /* versions LX5.0.5, X10.0.5, MX1.2.5, TX2.0.5 */ +#define XTENSA_HWCIDSCHEME_RE_2014_5 1100 +#define XTENSA_HWCIDVERS_RE_2014_5 101 +#define XTENSA_HWVERSION_RE_2015_6 250006 /* versions LX5.0.6, X10.0.6, MX1.2.6, TX2.0.6 */ +#define XTENSA_HWCIDSCHEME_RE_2015_6 1100 +#define XTENSA_HWCIDVERS_RE_2015_6 102 +#define XTENSA_HWVERSION_RF_2014_0 260000 /* versions LX6.0.0, X11.0.0, MX1.3.0, TX3.0.0 */ +#define XTENSA_HWCIDSCHEME_RF_2014_0 1100 +#define XTENSA_HWCIDVERS_RF_2014_0 112 +#define XTENSA_HWVERSION_RF_2014_1 260001 /* versions LX6.0.1, X11.0.1 */ +#define XTENSA_HWCIDSCHEME_RF_2014_1 1100 +#define XTENSA_HWCIDVERS_RF_2014_1 113 +#define XTENSA_HWVERSION_RF_2015_2 260002 /* versions LX6.0.2, X11.0.2 */ +#define XTENSA_HWCIDSCHEME_RF_2015_2 1100 +#define XTENSA_HWCIDVERS_RF_2015_2 114 +#define XTENSA_HWVERSION_RF_2015_3 260003 /* versions LX6.0.3, X11.0.3 */ +#define XTENSA_HWCIDSCHEME_RF_2015_3 1100 +#define XTENSA_HWCIDVERS_RF_2015_3 115 +#define XTENSA_HWVERSION_RG_2015_0 270000 /* versions LX7.0.0, X12.0.0, NX1.0.0, SX1.0.0, MX1.4.0, TX4.0.0 */ +#define XTENSA_HWCIDSCHEME_RG_2015_0 1100 +#define XTENSA_HWCIDVERS_RG_2015_0 128 + +/* Software (Xtensa Tools) versions: */ +#define XTENSA_SWVERSION_T1020_0 102000 /* versions T1020.0 */ +#define XTENSA_SWVERSION_T1020_1 102001 /* versions T1020.1 */ +#define XTENSA_SWVERSION_T1020_2B 102002 /* versions T1020.2b */ +#define XTENSA_SWVERSION_T1020_2 102002 /* versions T1020.2 */ +#define XTENSA_SWVERSION_T1020_3 102003 /* versions T1020.3 */ +#define XTENSA_SWVERSION_T1020_4 102004 /* versions T1020.4 */ +#define XTENSA_SWVERSION_T1030_0 103000 /* versions T1030.0 */ +#define XTENSA_SWVERSION_T1030_1 103001 /* versions T1030.1 */ +#define XTENSA_SWVERSION_T1030_2 103002 /* versions T1030.2 */ +#define XTENSA_SWVERSION_T1030_3 103003 /* versions T1030.3 */ +#define XTENSA_SWVERSION_T1040_0 104000 /* versions T1040.0 */ +#define XTENSA_SWVERSION_T1040_1 104001 /* versions T1040.1 */ +#define XTENSA_SWVERSION_T1040_1P 104001 /* versions T1040.1-prehotfix */ +#define XTENSA_SWVERSION_T1040_2 104002 /* versions T1040.2 */ +#define XTENSA_SWVERSION_T1040_3 104003 /* versions T1040.3 */ +#define XTENSA_SWVERSION_T1050_0 105000 /* versions T1050.0 */ +#define XTENSA_SWVERSION_T1050_1 105001 /* versions T1050.1 */ +#define XTENSA_SWVERSION_T1050_2 105002 /* versions T1050.2 */ +#define XTENSA_SWVERSION_T1050_3 105003 /* versions T1050.3 */ +#define XTENSA_SWVERSION_T1050_4 105004 /* versions T1050.4 */ +#define XTENSA_SWVERSION_T1050_5 105005 /* versions T1050.5 */ +#define XTENSA_SWVERSION_RA_2004_1 600000 /* versions 6.0.0 */ +#define XTENSA_SWVERSION_RA_2005_1 600001 /* versions 6.0.1 */ +#define XTENSA_SWVERSION_RA_2005_2 600002 /* versions 6.0.2 */ +#define XTENSA_SWVERSION_RA_2005_3 600003 /* versions 6.0.3 */ +#define XTENSA_SWVERSION_RA_2006_4 600004 /* versions 6.0.4 */ +#define XTENSA_SWVERSION_RA_2006_5 600005 /* versions 6.0.5 */ +#define XTENSA_SWVERSION_RA_2006_6 600006 /* versions 6.0.6 */ +#define XTENSA_SWVERSION_RA_2007_7 600007 /* versions 6.0.7 */ +#define XTENSA_SWVERSION_RA_2008_8 600008 /* versions 6.0.8 */ +#define XTENSA_SWVERSION_RB_2006_0 700000 /* versions 7.0.0 */ +#define XTENSA_SWVERSION_RB_2007_1 700001 /* versions 7.0.1 */ +#define XTENSA_SWVERSION_RB_2007_2 701000 /* versions 7.1.0 */ +#define XTENSA_SWVERSION_RB_2008_3 701001 /* versions 7.1.1 */ +#define XTENSA_SWVERSION_RB_2008_4 701002 /* versions 7.1.2 */ +#define XTENSA_SWVERSION_RB_2009_5 701003 /* versions 7.1.3 */ +#define XTENSA_SWVERSION_RB_2007_2_MP 701100 /* versions 7.1.8-MP */ +#define XTENSA_SWVERSION_RC_2009_0 800000 /* versions 8.0.0 */ +#define XTENSA_SWVERSION_RC_2010_1 800001 /* versions 8.0.1 */ +#define XTENSA_SWVERSION_RC_2010_2 800002 /* versions 8.0.2 */ +#define XTENSA_SWVERSION_RC_2011_3 800003 /* versions 8.0.3 */ +#define XTENSA_SWVERSION_RD_2010_0 900000 /* versions 9.0.0 */ +#define XTENSA_SWVERSION_RD_2011_1 900001 /* versions 9.0.1 */ +#define XTENSA_SWVERSION_RD_2011_2 900002 /* versions 9.0.2 */ +#define XTENSA_SWVERSION_RD_2011_3 900003 /* versions 9.0.3 */ +#define XTENSA_SWVERSION_RD_2012_4 900004 /* versions 9.0.4 */ +#define XTENSA_SWVERSION_RD_2012_5 900005 /* versions 9.0.5 */ +#define XTENSA_SWVERSION_RE_2012_0 1000000 /* versions 10.0.0 */ +#define XTENSA_SWVERSION_RE_2012_1 1000001 /* versions 10.0.1 */ +#define XTENSA_SWVERSION_RE_2013_2 1000002 /* versions 10.0.2 */ +#define XTENSA_SWVERSION_RE_2013_3 1000003 /* versions 10.0.3 */ +#define XTENSA_SWVERSION_RE_2013_4 1000004 /* versions 10.0.4 */ +#define XTENSA_SWVERSION_RE_2014_5 1000005 /* versions 10.0.5 */ +#define XTENSA_SWVERSION_RE_2015_6 1000006 /* versions 10.0.6 */ +#define XTENSA_SWVERSION_RF_2014_0 1100000 /* versions 11.0.0 */ +#define XTENSA_SWVERSION_RF_2014_1 1100001 /* versions 11.0.1 */ +#define XTENSA_SWVERSION_RF_2015_2 1100002 /* versions 11.0.2 */ +#define XTENSA_SWVERSION_RF_2015_3 1100003 /* versions 11.0.3 */ +#define XTENSA_SWVERSION_RG_2015_0 1200000 /* versions 12.0.0 */ +#define XTENSA_SWVERSION_T1040_1_PREHOTFIX XTENSA_SWVERSION_T1040_1P /* T1040.1-prehotfix */ +#define XTENSA_SWVERSION_6_0_0 XTENSA_SWVERSION_RA_2004_1 /* 6.0.0 */ +#define XTENSA_SWVERSION_6_0_1 XTENSA_SWVERSION_RA_2005_1 /* 6.0.1 */ +#define XTENSA_SWVERSION_6_0_2 XTENSA_SWVERSION_RA_2005_2 /* 6.0.2 */ +#define XTENSA_SWVERSION_6_0_3 XTENSA_SWVERSION_RA_2005_3 /* 6.0.3 */ +#define XTENSA_SWVERSION_6_0_4 XTENSA_SWVERSION_RA_2006_4 /* 6.0.4 */ +#define XTENSA_SWVERSION_6_0_5 XTENSA_SWVERSION_RA_2006_5 /* 6.0.5 */ +#define XTENSA_SWVERSION_6_0_6 XTENSA_SWVERSION_RA_2006_6 /* 6.0.6 */ +#define XTENSA_SWVERSION_6_0_7 XTENSA_SWVERSION_RA_2007_7 /* 6.0.7 */ +#define XTENSA_SWVERSION_6_0_8 XTENSA_SWVERSION_RA_2008_8 /* 6.0.8 */ +#define XTENSA_SWVERSION_7_0_0 XTENSA_SWVERSION_RB_2006_0 /* 7.0.0 */ +#define XTENSA_SWVERSION_7_0_1 XTENSA_SWVERSION_RB_2007_1 /* 7.0.1 */ +#define XTENSA_SWVERSION_7_1_0 XTENSA_SWVERSION_RB_2007_2 /* 7.1.0 */ +#define XTENSA_SWVERSION_7_1_1 XTENSA_SWVERSION_RB_2008_3 /* 7.1.1 */ +#define XTENSA_SWVERSION_7_1_2 XTENSA_SWVERSION_RB_2008_4 /* 7.1.2 */ +#define XTENSA_SWVERSION_7_1_3 XTENSA_SWVERSION_RB_2009_5 /* 7.1.3 */ +#define XTENSA_SWVERSION_7_1_8_MP XTENSA_SWVERSION_RB_2007_2_MP /* 7.1.8-MP */ +#define XTENSA_SWVERSION_8_0_0 XTENSA_SWVERSION_RC_2009_0 /* 8.0.0 */ +#define XTENSA_SWVERSION_8_0_1 XTENSA_SWVERSION_RC_2010_1 /* 8.0.1 */ +#define XTENSA_SWVERSION_8_0_2 XTENSA_SWVERSION_RC_2010_2 /* 8.0.2 */ +#define XTENSA_SWVERSION_8_0_3 XTENSA_SWVERSION_RC_2011_3 /* 8.0.3 */ +#define XTENSA_SWVERSION_9_0_0 XTENSA_SWVERSION_RD_2010_0 /* 9.0.0 */ +#define XTENSA_SWVERSION_9_0_1 XTENSA_SWVERSION_RD_2011_1 /* 9.0.1 */ +#define XTENSA_SWVERSION_9_0_2 XTENSA_SWVERSION_RD_2011_2 /* 9.0.2 */ +#define XTENSA_SWVERSION_9_0_3 XTENSA_SWVERSION_RD_2011_3 /* 9.0.3 */ +#define XTENSA_SWVERSION_9_0_4 XTENSA_SWVERSION_RD_2012_4 /* 9.0.4 */ +#define XTENSA_SWVERSION_9_0_5 XTENSA_SWVERSION_RD_2012_5 /* 9.0.5 */ +#define XTENSA_SWVERSION_10_0_0 XTENSA_SWVERSION_RE_2012_0 /* 10.0.0 */ +#define XTENSA_SWVERSION_10_0_1 XTENSA_SWVERSION_RE_2012_1 /* 10.0.1 */ +#define XTENSA_SWVERSION_10_0_2 XTENSA_SWVERSION_RE_2013_2 /* 10.0.2 */ +#define XTENSA_SWVERSION_10_0_3 XTENSA_SWVERSION_RE_2013_3 /* 10.0.3 */ +#define XTENSA_SWVERSION_10_0_4 XTENSA_SWVERSION_RE_2013_4 /* 10.0.4 */ +#define XTENSA_SWVERSION_10_0_5 XTENSA_SWVERSION_RE_2014_5 /* 10.0.5 */ +#define XTENSA_SWVERSION_10_0_6 XTENSA_SWVERSION_RE_2015_6 /* 10.0.6 */ +#define XTENSA_SWVERSION_11_0_0 XTENSA_SWVERSION_RF_2014_0 /* 11.0.0 */ +#define XTENSA_SWVERSION_11_0_1 XTENSA_SWVERSION_RF_2014_1 /* 11.0.1 */ +#define XTENSA_SWVERSION_11_0_2 XTENSA_SWVERSION_RF_2015_2 /* 11.0.2 */ +#define XTENSA_SWVERSION_11_0_3 XTENSA_SWVERSION_RF_2015_3 /* 11.0.3 */ +#define XTENSA_SWVERSION_12_0_0 XTENSA_SWVERSION_RG_2015_0 /* 12.0.0 */ + + +/* The current release: */ +#define XTENSA_RELEASE_NAME "RF-2015.3" +#define XTENSA_RELEASE_CANONICAL_NAME "RF-2015.3" + +/* The product versions within the current release: */ +#define XTENSA_SWVERSION XTENSA_SWVERSION_RF_2015_3 +#define XTENSA_SWVERSION_NAME "11.0.3" +#define XTENSA_SWVERSION_CANONICAL_NAME "11.0.3" +#define XTENSA_SWVERSION_MAJORMID_NAME "11.0" +#define XTENSA_SWVERSION_MAJOR_NAME "11" +/* For product licensing (not necessarily same as *_MAJORMID_NAME): */ +#define XTENSA_SWVERSION_LICENSE_NAME "11.0" + +/* Note: there may be multiple hardware products in one release, + and software can target older hardware, so the notion of + "current" hardware versions is partially configuration dependent. + For now, "current" hardware product version info is left out + to avoid confusion. */ + +#endif /*XTENSA_VERSIONS_H*/ + diff --git a/components/esp32/include/xtensa/xtensa-xer.h b/components/esp32/include/xtensa/xtensa-xer.h new file mode 100755 index 000000000..900bda333 --- /dev/null +++ b/components/esp32/include/xtensa/xtensa-xer.h @@ -0,0 +1,149 @@ +/* xer-constants.h -- various constants describing external registers accessed + via wer and rer. + + TODO: find a better prefix. Also conditionalize certain constants based + on number of cores and interrupts actually present. +*/ + +/* + * Copyright (c) 1999-2008 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#include + +#define NUM_INTERRUPTS 27 +#define NUM_CORES 4 + +/* Routing of NMI (BInterrupt2) and interrupts 0..n-1 (BInterrupt3+) + RER reads + WER writes + */ + +#define XER_MIROUT 0x0000 +#define XER_MIROUT_LAST (XER_MIROUT + NUM_INTERRUPTS) + + +/* IPI to core M (all 16 causes). + + RER reads + WER clears + */ +#define XER_MIPICAUSE 0x0100 +#define XER_MIPICAUSE_FIELD_A_FIRST 0x0 +#define XER_MIPICAUSE_FIELD_A_LAST 0x0 +#define XER_MIPICAUSE_FIELD_B_FIRST 0x1 +#define XER_MIPICAUSE_FIELD_B_LAST 0x3 +#define XER_MIPICAUSE_FIELD_C_FIRST 0x4 +#define XER_MIPICAUSE_FIELD_C_LAST 0x7 +#define XER_MIPICAUSE_FIELD_D_FIRST 0x8 +#define XER_MIPICAUSE_FIELD_D_LAST 0xF + + +/* IPI from cause bit 0..15 + + RER invalid + WER sets +*/ +#define XER_MIPISET 0x0140 +#define XER_MIPISET_LAST 0x014F + + +/* Global enable + + RER read + WER clear +*/ +#define XER_MIENG 0x0180 + + +/* Global enable + + RER invalid + WER set +*/ +#define XER_MIENG_SET 0x0184 + +/* Global assert + + RER read + WER clear +*/ +#define XER_MIASG 0x0188 + + +/* Global enable + + RER invalid + WER set +*/ +#define XER_MIASG_SET 0x018C + + +/* IPI partition register + + RER read + WER write +*/ +#define XER_PART 0x0190 +#define XER_IPI0 0x0 +#define XER_IPI1 0x1 +#define XER_IPI2 0x2 +#define XER_IPI3 0x3 + +#define XER_PART_ROUTE_IPI(NUM, FIELD) ((NUM) << ((FIELD) << 2)) + +#define XER_PART_ROUTE_IPI_CAUSE(TO_A, TO_B, TO_C, TO_D) \ + (XER_PART_ROUTE_IPI(TO_A, XER_IPI0) | \ + XER_PART_ROUTE_IPI(TO_B, XER_IPI1) | \ + XER_PART_ROUTE_IPI(TO_C, XER_IPI2) | \ + XER_PART_ROUTE_IPI(TO_D, XER_IPI3)) + +#define XER_IPI_WAKE_EXT_INTERRUPT XCHAL_EXTINT0_NUM +#define XER_IPI_WAKE_CAUSE XER_MIPICAUSE_FIELD_C_FIRST +#define XER_IPI_WAKE_ADDRESS (XER_MIPISET + XER_IPI_WAKE_CAUSE) +#define XER_DEFAULT_IPI_ROUTING XER_PART_ROUTE_IPI_CAUSE(XER_IPI1, XER_IPI0, XER_IPI2, XER_IPI3) + + +/* System configuration ID + + RER read + WER invalid +*/ +#define XER_SYSCFGID 0x01A0 + + +/* RunStall to slave processors + + RER read + WER write +*/ +#define XER_MPSCORE 0x0200 + + +/* Cache coherency ON + + RER read + WER write +*/ +#define XER_CCON 0x0220 + + diff --git a/components/esp32/include/xtensa/xtkc705.h b/components/esp32/include/xtensa/xtkc705.h new file mode 100755 index 000000000..831c15d54 --- /dev/null +++ b/components/esp32/include/xtensa/xtkc705.h @@ -0,0 +1,14 @@ +/* Copyright (c) 2006-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* xtkc705.h - Xtensa Xilinx KC705 (XT-KC705) board specific definitions */ + +/* 99.9% same as ML605, just indicate we're KC705 and include ML605 header: */ +#define XTBOARD_IS_KC705 1 +#include + diff --git a/components/esp32/include/xtensa/xtkc705/xtensa/board.h b/components/esp32/include/xtensa/xtkc705/xtensa/board.h new file mode 100755 index 000000000..5d2d83480 --- /dev/null +++ b/components/esp32/include/xtensa/xtkc705/xtensa/board.h @@ -0,0 +1,13 @@ +/* + * board.h - Include board-specific definitions + * + * Copyright (c) 2013 by Tensilica Inc. ALL RIGHTS RESERVED. + * These coded instructions, statements, and computer programs are the + * copyrighted works and confidential proprietary information of Tensilica Inc. + * They may not be modified, copied, reproduced, distributed, or disclosed to + * third parties in any manner, medium, or form, in whole or in part, without + * the prior written consent of Tensilica Inc. + */ + +#include + diff --git a/components/esp32/include/xtensa/xtload-api.h b/components/esp32/include/xtensa/xtload-api.h new file mode 100755 index 000000000..4e2297f51 --- /dev/null +++ b/components/esp32/include/xtensa/xtload-api.h @@ -0,0 +1,77 @@ +/* Customer ID=11656; Build=0x5f626; Copyright (c) 2003-2012 Tensilica Inc. ALL RIGHTS RESERVED. + These coded instructions, statements, and computer programs are the + copyrighted works and confidential proprietary information of Tensilica Inc. + They may not be modified, copied, reproduced, distributed, or disclosed to + third parties in any manner, medium, or form, in whole or in part, without + the prior written consent of Tensilica Inc. */ + +#ifndef _XTLOAD_API_H +#define _XTLOAD_API_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#define XTENSA_BYTES_PER_WORD 4 +#define XLOAD_ALL_CORES -1 + +typedef int core_number_t; +typedef uint32_t xtload_address_t; +typedef uint32_t xtload_word_count_t; +typedef uint32_t * xtload_word_ptr_t; + +/* These functions correspond one-to-one with xt-load script + commands. See the documentation for xt-load for their usage. + + There are however, several higher-level script commands--such as + load-elf-file--which don't have direct analogues here. These + "missing" commands are essentially just macros that result in + several of these commands below. Note that you can execute several + of these commands, then the results of a script, or vice-versa. + */ + +void xtload_bootloader_wake (void); +void xtload_bootloader_sleep (void); +void xtload_bootloader_done (void); +void xtload_bootloader_not_done (void); +void xtload_reset_and_cont (core_number_t core); +void xtload_stall_and_reset (core_number_t core); +#define xtload_reset_and_stall xtload_stall_and_reset +void xtload_stall_and_target (core_number_t core); +void xtload_ignore_and_stall (core_number_t core); +void xtload_ignore_and_cont (core_number_t core); +#define xtload_ignore_and_continue xtload_ignore_and_cont +void xtload_read_words (xtload_address_t addr, xtload_word_count_t count); +void xtload_zero_words (xtload_address_t addr, xtload_word_count_t count); +void xtload_write_words (int swap, xtload_address_t addr, + xtload_word_ptr_t ptr, xtload_word_count_t count); +void xtload_setup_write_words (xtload_address_t addr, xtload_word_count_t count); +void xtload_read_register (core_number_t core); + +/* *I M P O R T A N T* + + The bootloader API calls this function whenever it outputs a word + to the bootloader hardware chain. + + Because the API has no information about how the bootloader + hardware is connected to the host hardware, the user must + implement this function to write a word to the bootloader's register. + + A user's implementation might write the bytes to an Xtensa queue or + to a memory-mapped register. + + For example, xt-load uses this API just like any other client. Its + implementation of this function simply writes this word to an + output file. +*/ + +void xtload_user_output_word (uint32_t word); + +#ifdef __cplusplus +} +#endif + +#endif /* _XTLOAD_API_H */ + diff --git a/components/esp32/include/xtensa/xtml605.h b/components/esp32/include/xtensa/xtml605.h new file mode 100755 index 000000000..5f54d700d --- /dev/null +++ b/components/esp32/include/xtensa/xtml605.h @@ -0,0 +1,338 @@ +/* Copyright (c) 2007-2013 by Tensilica Inc. ALL RIGHTS RESERVED. +/ These coded instructions, statements, and computer programs are the +/ copyrighted works and confidential proprietary information of Tensilica Inc. +/ They may not be modified, copied, reproduced, distributed, or disclosed to +/ third parties in any manner, medium, or form, in whole or in part, without +/ the prior written consent of Tensilica Inc. +*/ + +/* xtml605.h - Xtensa Xilinx ML605 (XT-ML605) board specific definitions */ +/* xtkc705.h - Also includes this, for the Xilinx KC705 (XT-KC705). */ + +#ifndef _INC_ML605_H_ +#define _INC_ML605_H_ + +#include +#include + +#if XTBOARD_IS_KC705 +#define XTBOARD_NAME "XT-KC705" +#else +#define XTBOARD_NAME "XT-ML605" +#endif + + +/* + * Default assignment of ML605 devices to external interrupts. + */ + +/* Ethernet interrupt: */ +#ifdef XCHAL_EXTINT1_NUM +#define ETHERNET_INTNUM XCHAL_EXTINT1_NUM +#define ETHERNET_INTLEVEL XCHAL_EXTINT1_LEVEL +#define ETHERNET_INTMASK XCHAL_EXTINT1_MASK +#else +#define ETHERNET_INTMASK 0 +#endif + +/* UART interrupt: */ +#ifdef XCHAL_EXTINT0_NUM +#define UART16550_INTNUM XCHAL_EXTINT0_NUM +#define UART16550_INTLEVEL XCHAL_EXTINT0_LEVEL +#define UART16550_INTMASK XCHAL_EXTINT0_MASK +#else +#define UART16550_INTMASK 0 +#endif + +/* Audio output interrupt (I2S transmitter FIFO): */ +#ifdef XCHAL_EXTINT2_NUM +#define AUDIO_I2S_OUT_INTNUM XCHAL_EXTINT2_NUM +#define AUDIO_I2S_OUT_INTLEVEL XCHAL_EXTINT2_LEVEL +#define AUDIO_I2S_OUT_INTMASK XCHAL_EXTINT2_MASK +#else +#define AUDIO_I2S_OUT_INTMASK 0 +#endif + +/* Audio input interrupt (I2S receiver FIFO): */ +#ifdef XCHAL_EXTINT3_NUM +#define AUDIO_I2S_IN_INTNUM XCHAL_EXTINT3_NUM +#define AUDIO_I2S_IN_INTLEVEL XCHAL_EXTINT3_LEVEL +#define AUDIO_I2S_IN_INTMASK XCHAL_EXTINT3_MASK +#else +#define AUDIO_I2S_IN_INTMASK 0 +#endif + +/* I2C interrupt */ +#ifdef XCHAL_EXTINT4_NUM +#define I2C_INTNUM XCHAL_EXTINT4_NUM +#define I2C_INTLEVEL XCHAL_EXTINT4_LEVEL +#define I2C_INTMASK XCHAL_EXTINT4_MASK +#else +#define I2C_INTMASK 0 +#endif + +/* USB interrupt */ +#ifdef XCHAL_EXTINT5_NUM +#define USB_INTNUM XCHAL_EXTINT5_NUM +#define USB_INTLEVEL XCHAL_EXTINT5_LEVEL +#define USB_INTMASK XCHAL_EXTINT5_MASK +#else +#define USB_INTMASK 0 +#endif + +/* + * Device addresses. + * + * Note: for endianness-independence, use 32-bit loads and stores for all + * register accesses to Ethernet, UART and LED devices. Undefined bits + * may need to be masked out if needed when reading if the actual register + * size is smaller than 32 bits. + * + * Note: ML605 bus byte lanes are defined in terms of msbyte and lsbyte + * relative to the processor. So 32-bit registers are accessed consistently + * from both big and little endian processors. However, this means byte + * sequences are not consistent between big and little endian processors. + * This is fine for RAM, and for ROM if ROM is created for a specific + * processor (and thus has correct byte sequences). However this may be + * unexpected for Flash, which might contain a file-system that one wants + * to use for multiple processor configurations (eg. the Flash might contain + * the Ethernet card's address, endianness-independent application data, etc). + * That is, byte sequences written in Flash by a core of a given endianness + * will be byte-swapped when seen by a core of the other endianness. + * Someone implementing an endianness-independent Flash file system will + * likely handle this byte-swapping issue in the Flash driver software. + */ + +#define ML605_FLASH_MAXSIZE 0x01000000 /* 16 MB */ +#define ML605_FLASH_IOBLOCK_OFS 0x08000000 + +#define KC705_FLASH_MAXSIZE 0x08000000 /* 128 MB */ +#define KC705_FLASH_IOBLOCK_OFS 0x00000000 + +#if XTBOARD_IS_KC705 +#define XTBOARD_FLASH_MAXSIZE KC705_FLASH_MAXSIZE +#define XTBOARD_FLASH_IO_OFS KC705_FLASH_IOBLOCK_OFS +#else +#define XTBOARD_FLASH_MAXSIZE ML605_FLASH_MAXSIZE +#define XTBOARD_FLASH_IO_OFS ML605_FLASH_IOBLOCK_OFS +#endif + +#ifdef XSHAL_IOBLOCK_BYPASS_PADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+XTBOARD_FLASH_IO_OFS) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D030000) + + +/* UART National-Semi PC16550D: */ +# define UART16550_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D050000) + +/* I2S transmitter */ +# define AUDIO_I2S_OUT_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D080000) + +/* I2S receiver */ +# define AUDIO_I2S_IN_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D088000) + +/* I2C master */ +# define I2C_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D090000) + +/* SPI controller */ +# define SPI_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0A0000) + +/* Display controller Sunplus SPLC780D, 4bit mode, + * LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_4BIT_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0C0000) + +/* USB Controller */ +# define USB_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D0D0000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_PADDR (XSHAL_IOBLOCK_BYPASS_PADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_PADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_PADDR +# define XTBOARD_FLASH_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+XTBOARD_FLASH_IO_OFS) +# define ETHERNET_BUFFER_CACHED_PADDR (XSHAL_IOBLOCK_CACHED_PADDR+0x0D800000) +#endif /* XSHAL_IOBLOCK_CACHED_PADDR */ + + +/*** Same thing over again, this time with virtual addresses: ***/ + +#ifdef XSHAL_IOBLOCK_BYPASS_VADDR + +/* Flash Memory: */ +# define XTBOARD_FLASH_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+XTBOARD_FLASH_IO_OFS) + +/* FPGA registers: */ +# define XTBOARD_FPGAREGS_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D020000) + +/* Ethernet controller/transceiver SONIC SN83934: */ +# define ETHERNET_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D030000) + + +/* UART National-Semi PC16550D: */ +# define UART16550_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D050000) + +/* I2S transmitter */ +# define AUDIO_I2S_OUT_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D080000) + +/* I2S receiver */ +# define AUDIO_I2S_IN_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D088000) + +/* I2C master */ +# define I2C_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D090000) + +/* SPI controller */ +# define SPI_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0A0000) + +/* Display controller Sunplus SPLC780D, 4bit mode, + * LCD Display MYTech MOC-16216B-B: */ +# define SPLC780D_4BIT_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0C0000) + +/* USB Controller */ +# define USB_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D0D0000) + +/* Ethernet buffer: */ +# define ETHERNET_BUFFER_VADDR (XSHAL_IOBLOCK_BYPASS_VADDR+0x0D800000) + +#endif /* XSHAL_IOBLOCK_BYPASS_VADDR */ + +/* These devices might be accessed cached: */ +#ifdef XSHAL_IOBLOCK_CACHED_VADDR +# define XTBOARD_FLASH_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+XTBOARD_FLASH_IO_OFS) +# define ETHERNET_BUFFER_CACHED_VADDR (XSHAL_IOBLOCK_CACHED_VADDR+0x0D800000) +#endif /* XSHAL_IOBLOCK_CACHED_VADDR */ + + +/* System ROM: */ +#define XTBOARD_ROM_SIZE XSHAL_ROM_SIZE +#ifdef XSHAL_ROM_VADDR +#define XTBOARD_ROM_VADDR XSHAL_ROM_VADDR +#endif +#ifdef XSHAL_ROM_PADDR +#define XTBOARD_ROM_PADDR XSHAL_ROM_PADDR +#endif + +/* System RAM: */ +#define XTBOARD_RAM_SIZE XSHAL_RAM_SIZE +#ifdef XSHAL_RAM_VADDR +#define XTBOARD_RAM_VADDR XSHAL_RAM_VADDR +#endif +#ifdef XSHAL_RAM_PADDR +#define XTBOARD_RAM_PADDR XSHAL_RAM_PADDR +#endif +#define XTBOARD_RAM_BYPASS_VADDR XSHAL_RAM_BYPASS_VADDR +#define XTBOARD_RAM_BYPASS_PADDR XSHAL_RAM_BYPASS_PADDR + + + +/* + * Things that depend on device addresses. + */ + + +#define XTBOARD_CACHEATTR_WRITEBACK XSHAL_XT2000_CACHEATTR_WRITEBACK +#define XTBOARD_CACHEATTR_WRITEALLOC XSHAL_XT2000_CACHEATTR_WRITEALLOC +#define XTBOARD_CACHEATTR_WRITETHRU XSHAL_XT2000_CACHEATTR_WRITETHRU +#define XTBOARD_CACHEATTR_BYPASS XSHAL_XT2000_CACHEATTR_BYPASS +#define XTBOARD_CACHEATTR_DEFAULT XSHAL_XT2000_CACHEATTR_DEFAULT + +#define XTBOARD_BUSINT_PIPE_REGIONS XSHAL_XT2000_PIPE_REGIONS +#define XTBOARD_BUSINT_SDRAM_REGIONS XSHAL_XT2000_SDRAM_REGIONS + + +/* + * FPGA registers. + * All these registers are normally accessed using 32-bit loads/stores. + */ + +/* Register offsets: */ +#define XTBOARD_DATECD_OFS 0x00 /* date code (read-only) */ +#define XTBOARD_CLKFRQ_OFS 0x04 /* clock frequency Hz (read-only) */ +#define XTBOARD_SYSLED_OFS 0x08 /* LEDs */ +#define XTBOARD_DIPSW_OFS 0x0C /* DIP switch bits (read-only) */ +#define XTBOARD_SWRST_OFS 0x10 /* software reset */ + +/* Physical register addresses: */ +#ifdef XTBOARD_FPGAREGS_PADDR +#define XTBOARD_DATECD_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_PADDR (XTBOARD_FPGAREGS_PADDR+XTBOARD_SWRST_OFS) +#endif + +/* Virtual register addresses: */ +#ifdef XTBOARD_FPGAREGS_VADDR +#define XTBOARD_DATECD_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DATECD_OFS) +#define XTBOARD_CLKFRQ_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_CLKFRQ_OFS) +#define XTBOARD_SYSLED_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SYSLED_OFS) +#define XTBOARD_DIPSW_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_DIPSW_OFS) +#define XTBOARD_SWRST_VADDR (XTBOARD_FPGAREGS_VADDR+XTBOARD_SWRST_OFS) +/* Register access (for C code): */ +#define XTBOARD_DATECD_REG (*(volatile unsigned*) XTBOARD_DATECD_VADDR) +#define XTBOARD_CLKFRQ_REG (*(volatile unsigned*) XTBOARD_CLKFRQ_VADDR) +#define XTBOARD_SYSLED_REG (*(volatile unsigned*) XTBOARD_SYSLED_VADDR) +#define XTBOARD_DIPSW_REG (*(volatile unsigned*) XTBOARD_DIPSW_VADDR) +#define XTBOARD_SWRST_REG (*(volatile unsigned*) XTBOARD_SWRST_VADDR) +#endif + +/* DATECD (date code; when core was built) bit fields: */ +/* BCD-coded month (01..12): */ +#define XTBOARD_DATECD_MONTH_SHIFT 24 +#define XTBOARD_DATECD_MONTH_BITS 8 +#define XTBOARD_DATECD_MONTH_MASK 0xFF000000 +/* BCD-coded day (01..31): */ +#define XTBOARD_DATECD_DAY_SHIFT 16 +#define XTBOARD_DATECD_DAY_BITS 8 +#define XTBOARD_DATECD_DAY_MASK 0x00FF0000 +/* BCD-coded year (2001..9999): */ +#define XTBOARD_DATECD_YEAR_SHIFT 0 +#define XTBOARD_DATECD_YEAR_BITS 16 +#define XTBOARD_DATECD_YEAR_MASK 0x0000FFFF + +/* SYSLED (system LED) bit fields: */ + +/* LED control bits (off=0, on=1): */ +#define XTBOARD_SYSLED_USER_SHIFT 0 +#define XTBOARD_SYSLED_USER_BITS 2 +#define XTBOARD_SYSLED_USER_MASK 0x00000003 + +/* DIP Switch SW? (left=sw1=lsb=bit0, right=sw4=msb=bit3; off=0, on=1): */ +/* DIP switch bit fields (bit2/sw3 is reserved and presently unused): */ +#if XTBOARD_IS_KC705 +#define XTBOARD_DIPSW_USER_SHIFT 0 +#define XTBOARD_DIPSW_USER_BITS 2 +#define XTBOARD_DIPSW_USER_MASK 0x00000003 +#define XTBOARD_DIPSW_BOOT_SHIFT 3 +#define XTBOARD_DIPSW_BOOT_BITS 1 +#define XTBOARD_DIPSW_BOOT_MASK 0x00000008 +#else /* ML605: */ +#define XTBOARD_DIPSW_USER_SHIFT 0 +#define XTBOARD_DIPSW_USER_BITS 6 +#define XTBOARD_DIPSW_USER_MASK 0x0000003F +#define XTBOARD_DIPSW_BOOT_SHIFT 7 +#define XTBOARD_DIPSW_BOOT_BITS 1 +#define XTBOARD_DIPSW_BOOT_MASK 0x00000080 +#endif /*ML605*/ +#define XTBOARD_DIPSW_BOOT_RAM (0< + diff --git a/components/esp32/include/xtensa/xtruntime-core-state.h b/components/esp32/include/xtensa/xtruntime-core-state.h new file mode 100755 index 000000000..37d203c21 --- /dev/null +++ b/components/esp32/include/xtensa/xtruntime-core-state.h @@ -0,0 +1,212 @@ +/* xtruntime-core-state.h - core state save area (used eg. by PSO) */ +/* $Id: //depot/rel/Eaglenest/Xtensa/OS/include/xtensa/xtruntime-core-state.h#1 $ */ + +/* + * Copyright (c) 2012-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef _XTOS_CORE_STATE_H_ +#define _XTOS_CORE_STATE_H_ + +/* Import STRUCT_xxx macros for defining structures: */ +#include +#include +#include + +//#define XTOS_PSO_TEST 1 // uncommented for internal PSO testing only + +#define CORE_STATE_SIGNATURE 0xB1C5AFED // pattern that indicates state was saved + + +/* + * Save area for saving entire core state, such as across Power Shut-Off (PSO). + */ + +STRUCT_BEGIN +STRUCT_FIELD (long,4,CS_SA_,signature) // for checking whether state was saved +STRUCT_FIELD (long,4,CS_SA_,restore_label) +STRUCT_FIELD (long,4,CS_SA_,aftersave_label) +STRUCT_AFIELD(long,4,CS_SA_,areg,XCHAL_NUM_AREGS) +#if XCHAL_HAVE_WINDOWED +STRUCT_AFIELD(long,4,CS_SA_,caller_regs,16) // save a max of 16 caller regs +STRUCT_FIELD (long,4,CS_SA_,caller_regs_saved) // flag to show if caller regs saved +#endif +#if XCHAL_HAVE_PSO_CDM +STRUCT_FIELD (long,4,CS_SA_,pwrctl) +#endif +#if XCHAL_HAVE_WINDOWED +STRUCT_FIELD (long,4,CS_SA_,windowbase) +STRUCT_FIELD (long,4,CS_SA_,windowstart) +#endif +STRUCT_FIELD (long,4,CS_SA_,sar) +#if XCHAL_HAVE_EXCEPTIONS +STRUCT_FIELD (long,4,CS_SA_,epc1) +STRUCT_FIELD (long,4,CS_SA_,ps) +STRUCT_FIELD (long,4,CS_SA_,excsave1) +# ifdef XCHAL_DOUBLEEXC_VECTOR_VADDR +STRUCT_FIELD (long,4,CS_SA_,depc) +# endif +#endif +#if XCHAL_NUM_INTLEVELS + XCHAL_HAVE_NMI >= 2 +STRUCT_AFIELD(long,4,CS_SA_,epc, XCHAL_NUM_INTLEVELS + XCHAL_HAVE_NMI - 1) +STRUCT_AFIELD(long,4,CS_SA_,eps, XCHAL_NUM_INTLEVELS + XCHAL_HAVE_NMI - 1) +STRUCT_AFIELD(long,4,CS_SA_,excsave,XCHAL_NUM_INTLEVELS + XCHAL_HAVE_NMI - 1) +#endif +#if XCHAL_HAVE_LOOPS +STRUCT_FIELD (long,4,CS_SA_,lcount) +STRUCT_FIELD (long,4,CS_SA_,lbeg) +STRUCT_FIELD (long,4,CS_SA_,lend) +#endif +#if XCHAL_HAVE_ABSOLUTE_LITERALS +STRUCT_FIELD (long,4,CS_SA_,litbase) +#endif +#if XCHAL_HAVE_VECBASE +STRUCT_FIELD (long,4,CS_SA_,vecbase) +#endif +#if XCHAL_HAVE_S32C1I && (XCHAL_HW_MIN_VERSION >= XTENSA_HWVERSION_RC_2009_0) /* have ATOMCTL ? */ +STRUCT_FIELD (long,4,CS_SA_,atomctl) +#endif +#if XCHAL_HAVE_PREFETCH +STRUCT_FIELD (long,4,CS_SA_,prefctl) +#endif +#if XCHAL_USE_MEMCTL +STRUCT_FIELD (long,4,CS_SA_,memctl) +#endif +#if XCHAL_HAVE_CCOUNT +STRUCT_FIELD (long,4,CS_SA_,ccount) +STRUCT_AFIELD(long,4,CS_SA_,ccompare, XCHAL_NUM_TIMERS) +#endif +#if XCHAL_HAVE_INTERRUPTS +STRUCT_FIELD (long,4,CS_SA_,intenable) +STRUCT_FIELD (long,4,CS_SA_,interrupt) +#endif +#if XCHAL_HAVE_DEBUG +STRUCT_FIELD (long,4,CS_SA_,icount) +STRUCT_FIELD (long,4,CS_SA_,icountlevel) +STRUCT_FIELD (long,4,CS_SA_,debugcause) +// DDR not saved +# if XCHAL_NUM_DBREAK +STRUCT_AFIELD(long,4,CS_SA_,dbreakc, XCHAL_NUM_DBREAK) +STRUCT_AFIELD(long,4,CS_SA_,dbreaka, XCHAL_NUM_DBREAK) +# endif +# if XCHAL_NUM_IBREAK +STRUCT_AFIELD(long,4,CS_SA_,ibreaka, XCHAL_NUM_IBREAK) +STRUCT_FIELD (long,4,CS_SA_,ibreakenable) +# endif +#endif +#if XCHAL_NUM_MISC_REGS +STRUCT_AFIELD(long,4,CS_SA_,misc,XCHAL_NUM_MISC_REGS) +#endif +#if XCHAL_HAVE_MEM_ECC_PARITY +STRUCT_FIELD (long,4,CS_SA_,mepc) +STRUCT_FIELD (long,4,CS_SA_,meps) +STRUCT_FIELD (long,4,CS_SA_,mesave) +STRUCT_FIELD (long,4,CS_SA_,mesr) +STRUCT_FIELD (long,4,CS_SA_,mecr) +STRUCT_FIELD (long,4,CS_SA_,mevaddr) +#endif + +/* We put this ahead of TLB and other TIE state, + to keep it within S32I/L32I offset range. */ +#if XCHAL_HAVE_CP +STRUCT_FIELD (long,4,CS_SA_,cpenable) +#endif + +/* TLB state */ +#if XCHAL_HAVE_MIMIC_CACHEATTR || XCHAL_HAVE_XLT_CACHEATTR +STRUCT_AFIELD(long,4,CS_SA_,tlbs,8*2) +#endif +#if XCHAL_HAVE_PTP_MMU +/* Compute number of auto-refill (ARF) entries as max of I and D, + to simplify TLB save logic. On the unusual configs with + ITLB ARF != DTLB ARF entries, we'll just end up + saving/restoring some extra entries redundantly. */ +# if XCHAL_DTLB_ARF_ENTRIES_LOG2 + XCHAL_ITLB_ARF_ENTRIES_LOG2 > 4 +# define ARF_ENTRIES 8 +# else +# define ARF_ENTRIES 4 +# endif +STRUCT_FIELD (long,4,CS_SA_,ptevaddr) +STRUCT_FIELD (long,4,CS_SA_,rasid) +STRUCT_FIELD (long,4,CS_SA_,dtlbcfg) +STRUCT_FIELD (long,4,CS_SA_,itlbcfg) +/*** WARNING: past this point, field offsets may be larger than S32I/L32I range ***/ +STRUCT_AFIELD(long,4,CS_SA_,tlbs,((4*ARF_ENTRIES+4)*2+3)*2) +# if XCHAL_HAVE_SPANNING_WAY /* MMU v3 */ +STRUCT_AFIELD(long,4,CS_SA_,tlbs_ways56,(4+8)*2*2) +# endif +#endif + +/* TIE state */ +/* NOTE: NCP area is aligned to XCHAL_TOTAL_SA_ALIGN not XCHAL_NCP_SA_ALIGN, + because the offsets of all subsequent coprocessor save areas are relative + to the NCP save area. */ +STRUCT_AFIELD_A(char,1,XCHAL_TOTAL_SA_ALIGN,CS_SA_,ncp,XCHAL_NCP_SA_SIZE) +#if XCHAL_HAVE_CP +STRUCT_AFIELD_A(char,1,XCHAL_CP0_SA_ALIGN,CS_SA_,cp0,XCHAL_CP0_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP1_SA_ALIGN,CS_SA_,cp1,XCHAL_CP1_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP2_SA_ALIGN,CS_SA_,cp2,XCHAL_CP2_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP3_SA_ALIGN,CS_SA_,cp3,XCHAL_CP3_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP4_SA_ALIGN,CS_SA_,cp4,XCHAL_CP4_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP5_SA_ALIGN,CS_SA_,cp5,XCHAL_CP5_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP6_SA_ALIGN,CS_SA_,cp6,XCHAL_CP6_SA_SIZE) +STRUCT_AFIELD_A(char,1,XCHAL_CP7_SA_ALIGN,CS_SA_,cp7,XCHAL_CP7_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP8_SA_ALIGN,CS_SA_,cp8,XCHAL_CP8_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP9_SA_ALIGN,CS_SA_,cp9,XCHAL_CP9_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP10_SA_ALIGN,CS_SA_,cp10,XCHAL_CP10_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP11_SA_ALIGN,CS_SA_,cp11,XCHAL_CP11_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP12_SA_ALIGN,CS_SA_,cp12,XCHAL_CP12_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP13_SA_ALIGN,CS_SA_,cp13,XCHAL_CP13_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP14_SA_ALIGN,CS_SA_,cp14,XCHAL_CP14_SA_SIZE) +//STRUCT_AFIELD_A(char,1,XCHAL_CP15_SA_ALIGN,CS_SA_,cp15,XCHAL_CP15_SA_SIZE) +#endif + +STRUCT_END(XtosCoreState) + + + +// These are part of non-coprocessor state (ncp): +#if XCHAL_HAVE_MAC16 +//STRUCT_FIELD (long,4,CS_SA_,acclo) +//STRUCT_FIELD (long,4,CS_SA_,acchi) +//STRUCT_AFIELD(long,4,CS_SA_,mr, 4) +#endif +#if XCHAL_HAVE_THREADPTR +//STRUCT_FIELD (long,4,CS_SA_,threadptr) +#endif +#if XCHAL_HAVE_S32C1I +//STRUCT_FIELD (long,4,CS_SA_,scompare1) +#endif +#if XCHAL_HAVE_BOOLEANS +//STRUCT_FIELD (long,4,CS_SA_,br) +#endif + +// Not saved: +// EXCCAUSE ?? +// DEBUGCAUSE ?? +// EXCVADDR ?? +// DDR +// INTERRUPT +// ... locked cache lines ... + +#endif /* _XTOS_CORE_STATE_H_ */ + diff --git a/components/esp32/include/xtensa/xtruntime-frames.h b/components/esp32/include/xtensa/xtruntime-frames.h new file mode 100755 index 000000000..8b5a7463a --- /dev/null +++ b/components/esp32/include/xtensa/xtruntime-frames.h @@ -0,0 +1,162 @@ +/* xtruntime-frames.h - exception stack frames for single-threaded run-time */ +/* $Id: //depot/rel/Eaglenest/Xtensa/OS/include/xtensa/xtruntime-frames.h#1 $ */ + +/* + * Copyright (c) 2002-2012 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef _XTRUNTIME_FRAMES_H_ +#define _XTRUNTIME_FRAMES_H_ + +#include + +/* Macros that help define structures for both C and assembler: */ +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) +#define STRUCT_BEGIN .pushsection .text; .struct 0 +#define STRUCT_FIELD(ctype,size,pre,name) pre##name: .space size +#define STRUCT_AFIELD(ctype,size,pre,name,n) pre##name: .if n ; .space (size)*(n) ; .endif +#define STRUCT_AFIELD_A(ctype,size,align,pre,name,n) .balign align ; pre##name: .if n ; .space (size)*(n) ; .endif +#define STRUCT_END(sname) sname##Size:; .popsection +#else /*_ASMLANGUAGE||__ASSEMBLER__*/ +#define STRUCT_BEGIN typedef struct { +#define STRUCT_FIELD(ctype,size,pre,name) ctype name; +#define STRUCT_AFIELD(ctype,size,pre,name,n) ctype name[n]; +#define STRUCT_AFIELD_A(ctype,size,align,pre,name,n) ctype name[n] __attribute__((aligned(align))); +#define STRUCT_END(sname) } sname; +#endif /*_ASMLANGUAGE||__ASSEMBLER__*/ + + +/* + * Kernel vector mode exception stack frame. + * + * NOTE: due to the limited range of addi used in the current + * kernel exception vector, and the fact that historically + * the vector is limited to 12 bytes, the size of this + * stack frame is limited to 128 bytes (currently at 64). + */ +STRUCT_BEGIN +STRUCT_FIELD (long,4,KEXC_,pc) /* "parm" */ +STRUCT_FIELD (long,4,KEXC_,ps) +STRUCT_AFIELD(long,4,KEXC_,areg, 4) /* a12 .. a15 */ +STRUCT_FIELD (long,4,KEXC_,sar) /* "save" */ +#if XCHAL_HAVE_LOOPS +STRUCT_FIELD (long,4,KEXC_,lcount) +STRUCT_FIELD (long,4,KEXC_,lbeg) +STRUCT_FIELD (long,4,KEXC_,lend) +#endif +#if XCHAL_HAVE_MAC16 +STRUCT_FIELD (long,4,KEXC_,acclo) +STRUCT_FIELD (long,4,KEXC_,acchi) +STRUCT_AFIELD(long,4,KEXC_,mr, 4) +#endif +STRUCT_END(KernelFrame) + + +/* + * User vector mode exception stack frame: + * + * WARNING: if you modify this structure, you MUST modify the + * computation of the pad size (ALIGNPAD) accordingly. + */ +STRUCT_BEGIN +STRUCT_FIELD (long,4,UEXC_,pc) +STRUCT_FIELD (long,4,UEXC_,ps) +STRUCT_FIELD (long,4,UEXC_,sar) +STRUCT_FIELD (long,4,UEXC_,vpri) +#ifdef __XTENSA_CALL0_ABI__ +STRUCT_FIELD (long,4,UEXC_,a0) +#endif +STRUCT_FIELD (long,4,UEXC_,a2) +STRUCT_FIELD (long,4,UEXC_,a3) +STRUCT_FIELD (long,4,UEXC_,a4) +STRUCT_FIELD (long,4,UEXC_,a5) +#ifdef __XTENSA_CALL0_ABI__ +STRUCT_FIELD (long,4,UEXC_,a6) +STRUCT_FIELD (long,4,UEXC_,a7) +STRUCT_FIELD (long,4,UEXC_,a8) +STRUCT_FIELD (long,4,UEXC_,a9) +STRUCT_FIELD (long,4,UEXC_,a10) +STRUCT_FIELD (long,4,UEXC_,a11) +STRUCT_FIELD (long,4,UEXC_,a12) +STRUCT_FIELD (long,4,UEXC_,a13) +STRUCT_FIELD (long,4,UEXC_,a14) +STRUCT_FIELD (long,4,UEXC_,a15) +#endif +STRUCT_FIELD (long,4,UEXC_,exccause) /* NOTE: can probably rid of this one (pass direct) */ +#if XCHAL_HAVE_LOOPS +STRUCT_FIELD (long,4,UEXC_,lcount) +STRUCT_FIELD (long,4,UEXC_,lbeg) +STRUCT_FIELD (long,4,UEXC_,lend) +#endif +#if XCHAL_HAVE_MAC16 +STRUCT_FIELD (long,4,UEXC_,acclo) +STRUCT_FIELD (long,4,UEXC_,acchi) +STRUCT_AFIELD(long,4,UEXC_,mr, 4) +#endif +/* ALIGNPAD is the 16-byte alignment padding. */ +#ifdef __XTENSA_CALL0_ABI__ +# define CALL0_ABI 1 +#else +# define CALL0_ABI 0 +#endif +#define ALIGNPAD ((3 + XCHAL_HAVE_LOOPS*1 + XCHAL_HAVE_MAC16*2 + CALL0_ABI*1) & 3) +#if ALIGNPAD +STRUCT_AFIELD(long,4,UEXC_,pad, ALIGNPAD) /* 16-byte alignment padding */ +#endif +/*STRUCT_AFIELD_A(char,1,XCHAL_CPEXTRA_SA_ALIGN,UEXC_,ureg, (XCHAL_CPEXTRA_SA_SIZE+3)&-4)*/ /* not used */ +STRUCT_END(UserFrame) + + +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) + + +/* Check for UserFrameSize small enough not to require rounding...: */ + /* Skip 16-byte save area, then 32-byte space for 8 regs of call12 + * (which overlaps with 16-byte GCC nested func chaining area), + * then exception stack frame: */ + .set UserFrameTotalSize, 16+32+UserFrameSize + /* Greater than 112 bytes? (max range of ADDI, both signs, when aligned to 16 bytes): */ + .ifgt UserFrameTotalSize-112 + /* Round up to 256-byte multiple to accelerate immediate adds: */ + .set UserFrameTotalSize, ((UserFrameTotalSize+255) & 0xFFFFFF00) + .endif +# define ESF_TOTALSIZE UserFrameTotalSize + +#endif /* _ASMLANGUAGE || __ASSEMBLER__ */ + + +#if XCHAL_NUM_CONTEXTS > 1 +/* Structure of info stored on new context's stack for setup: */ +STRUCT_BEGIN +STRUCT_FIELD (long,4,INFO_,sp) +STRUCT_FIELD (long,4,INFO_,arg1) +STRUCT_FIELD (long,4,INFO_,funcpc) +STRUCT_FIELD (long,4,INFO_,prevps) +STRUCT_END(SetupInfo) +#endif + + +#define KERNELSTACKSIZE 1024 + + +#endif /* _XTRUNTIME_FRAMES_H_ */ + diff --git a/components/esp32/include/xtensa/xtruntime.h b/components/esp32/include/xtensa/xtruntime.h new file mode 100755 index 000000000..9dae1f4b2 --- /dev/null +++ b/components/esp32/include/xtensa/xtruntime.h @@ -0,0 +1,221 @@ +/* + * xtruntime.h -- general C definitions for single-threaded run-time + * + * Copyright (c) 2002-2013 Tensilica Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be included + * in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +#ifndef XTRUNTIME_H +#define XTRUNTIME_H + +#include +#include +#include + +#ifndef XTSTR +#define _XTSTR(x) # x +#define XTSTR(x) _XTSTR(x) +#endif + +/* _xtos_core_shutoff() flags parameter values: */ +#define XTOS_KEEPON_MEM 0x00000100 /* ==PWRCTL_MEM_WAKEUP */ +#define XTOS_KEEPON_MEM_SHIFT 8 +#define XTOS_KEEPON_DEBUG 0x00001000 /* ==PWRCTL_DEBUG_WAKEUP */ +#define XTOS_KEEPON_DEBUG_SHIFT 12 + +#define XTOS_COREF_PSO 0x00000001 /* do power shutoff */ +#define XTOS_COREF_PSO_SHIFT 0 + +#define _xtos_set_execption_handler _xtos_set_exception_handler /* backward compatibility */ +#define _xtos_set_saved_intenable _xtos_ints_on /* backward compatibility */ +#define _xtos_clear_saved_intenable _xtos_ints_off /* backward compatibility */ + +#if !defined(_ASMLANGUAGE) && !defined(__ASSEMBLER__) + +#ifdef __cplusplus +extern "C" { +#endif + +/*typedef void (_xtos_timerdelta_func)(int);*/ +#ifdef __cplusplus +typedef void (_xtos_handler_func)(...); +#else +typedef void (_xtos_handler_func)(); +#endif +typedef _xtos_handler_func *_xtos_handler; + +/* + * unsigned XTOS_SET_INTLEVEL(int intlevel); + * This macro sets the current interrupt level. + * The 'intlevel' parameter must be a constant. + * This macro returns a 32-bit value that must be passed to + * XTOS_RESTORE_INTLEVEL() to restore the previous interrupt level. + * XTOS_RESTORE_JUST_INTLEVEL() also does this, but in XEA2 configs + * it restores only PS.INTLEVEL rather than the entire PS register + * and thus is slower. + */ +#if !XCHAL_HAVE_INTERRUPTS +# define XTOS_SET_INTLEVEL(intlevel) 0 +# define XTOS_SET_MIN_INTLEVEL(intlevel) 0 +# define XTOS_RESTORE_INTLEVEL(restoreval) +# define XTOS_RESTORE_JUST_INTLEVEL(restoreval) +#elif XCHAL_HAVE_XEA2 +/* In XEA2, we can simply safely set PS.INTLEVEL directly: */ +/* NOTE: these asm macros don't modify memory, but they are marked + * as such to act as memory access barriers to the compiler because + * these macros are sometimes used to delineate critical sections; + * function calls are natural barriers (the compiler does not know + * whether a function modifies memory) unless declared to be inlined. */ +# define XTOS_SET_INTLEVEL(intlevel) ({ unsigned __tmp; \ + __asm__ __volatile__( "rsil %0, " XTSTR(intlevel) "\n" \ + : "=a" (__tmp) : : "memory" ); \ + __tmp;}) +# define XTOS_SET_MIN_INTLEVEL(intlevel) ({ unsigned __tmp, __tmp2, __tmp3; \ + __asm__ __volatile__( "rsr %0, " XTSTR(PS) "\n" /* get old (current) PS.INTLEVEL */ \ + "movi %2, " XTSTR(intlevel) "\n" \ + "extui %1, %0, 0, 4\n" /* keep only INTLEVEL bits of parameter */ \ + "blt %2, %1, 1f\n" \ + "rsil %0, " XTSTR(intlevel) "\n" \ + "1:\n" \ + : "=a" (__tmp), "=&a" (__tmp2), "=&a" (__tmp3) : : "memory" ); \ + __tmp;}) +# define XTOS_RESTORE_INTLEVEL(restoreval) do{ unsigned __tmp = (restoreval); \ + __asm__ __volatile__( "wsr %0, " XTSTR(PS) " ; rsync\n" \ + : : "a" (__tmp) : "memory" ); \ + }while(0) +# define XTOS_RESTORE_JUST_INTLEVEL(restoreval) _xtos_set_intlevel(restoreval) +#else +/* In XEA1, we have to rely on INTENABLE register virtualization: */ +extern unsigned _xtos_set_vpri( unsigned vpri ); +extern unsigned _xtos_vpri_enabled; /* current virtual priority */ +# define XTOS_SET_INTLEVEL(intlevel) _xtos_set_vpri(~XCHAL_INTLEVEL_ANDBELOW_MASK(intlevel)) +# define XTOS_SET_MIN_INTLEVEL(intlevel) _xtos_set_vpri(_xtos_vpri_enabled & ~XCHAL_INTLEVEL_ANDBELOW_MASK(intlevel)) +# define XTOS_RESTORE_INTLEVEL(restoreval) _xtos_set_vpri(restoreval) +# define XTOS_RESTORE_JUST_INTLEVEL(restoreval) _xtos_set_vpri(restoreval) +#endif + +/* + * The following macros build upon the above. They are generally used + * instead of invoking the SET_INTLEVEL and SET_MIN_INTLEVEL macros directly. + * They all return a value that can be used with XTOS_RESTORE_INTLEVEL() + * or _xtos_restore_intlevel() or _xtos_restore_just_intlevel() to restore + * the effective interrupt level to what it was before the macro was invoked. + * In XEA2, the DISABLE macros are much faster than the MASK macros + * (in all configs, DISABLE sets the effective interrupt level, whereas MASK + * makes ensures the effective interrupt level is at least the level given + * without lowering it; in XEA2 with INTENABLE virtualization, these macros + * affect PS.INTLEVEL only, not the virtual priority, so DISABLE has partial + * MASK semantics). + * + * A typical critical section sequence might be: + * unsigned rval = XTOS_DISABLE_EXCM_INTERRUPTS; + * ... critical section ... + * XTOS_RESTORE_INTLEVEL(rval); + */ +/* Enable all interrupts (those activated with _xtos_ints_on()): */ +#define XTOS_ENABLE_INTERRUPTS XTOS_SET_INTLEVEL(0) +/* Disable low priority level interrupts (they can interact with the OS): */ +#define XTOS_DISABLE_LOWPRI_INTERRUPTS XTOS_SET_INTLEVEL(XCHAL_NUM_LOWPRI_LEVELS) +#define XTOS_MASK_LOWPRI_INTERRUPTS XTOS_SET_MIN_INTLEVEL(XCHAL_NUM_LOWPRI_LEVELS) +/* Disable interrupts that can interact with the OS: */ +#define XTOS_DISABLE_EXCM_INTERRUPTS XTOS_SET_INTLEVEL(XCHAL_EXCM_LEVEL) +#define XTOS_MASK_EXCM_INTERRUPTS XTOS_SET_MIN_INTLEVEL(XCHAL_EXCM_LEVEL) +#if 0 /* XTOS_LOCK_LEVEL is not exported to applications */ +/* Disable interrupts that can interact with the OS, or manipulate virtual INTENABLE: */ +#define XTOS_DISABLE_LOCK_INTERRUPTS XTOS_SET_INTLEVEL(XTOS_LOCK_LEVEL) +#define XTOS_MASK_LOCK_INTERRUPTS XTOS_SET_MIN_INTLEVEL(XTOS_LOCK_LEVEL) +#endif +/* Disable ALL interrupts (not for common use, particularly if one's processor + * configuration has high-level interrupts and one cares about their latency): */ +#define XTOS_DISABLE_ALL_INTERRUPTS XTOS_SET_INTLEVEL(15) + + +extern unsigned int _xtos_ints_off( unsigned int mask ); +extern unsigned int _xtos_ints_on( unsigned int mask ); +extern unsigned _xtos_set_intlevel( int intlevel ); +extern unsigned _xtos_set_min_intlevel( int intlevel ); +extern unsigned _xtos_restore_intlevel( unsigned restoreval ); +extern unsigned _xtos_restore_just_intlevel( unsigned restoreval ); +extern _xtos_handler _xtos_set_interrupt_handler( int n, _xtos_handler f ); +extern _xtos_handler _xtos_set_interrupt_handler_arg( int n, _xtos_handler f, void *arg ); +extern _xtos_handler _xtos_set_exception_handler( int n, _xtos_handler f ); + +extern void _xtos_memep_initrams( void ); +extern void _xtos_memep_enable( int flags ); + +/* For use with the tiny LSP (see LSP reference manual). */ +#if XCHAL_NUM_INTLEVELS >= 1 +extern void _xtos_dispatch_level1_interrupts( void ); +#endif +#if XCHAL_NUM_INTLEVELS >= 2 +extern void _xtos_dispatch_level2_interrupts( void ); +#endif +#if XCHAL_NUM_INTLEVELS >= 3 +extern void _xtos_dispatch_level3_interrupts( void ); +#endif +#if XCHAL_NUM_INTLEVELS >= 4 +extern void _xtos_dispatch_level4_interrupts( void ); +#endif +#if XCHAL_NUM_INTLEVELS >= 5 +extern void _xtos_dispatch_level5_interrupts( void ); +#endif +#if XCHAL_NUM_INTLEVELS >= 6 +extern void _xtos_dispatch_level6_interrupts( void ); +#endif + +/* Deprecated (but kept because they were documented): */ +extern unsigned int _xtos_read_ints( void ); /* use xthal_get_interrupt() instead */ +extern void _xtos_clear_ints( unsigned int mask ); /* use xthal_set_intclear() instead */ + + +/* Power shut-off related routines. */ +extern int _xtos_core_shutoff(unsigned flags); +extern int _xtos_core_save(unsigned flags, XtosCoreState *savearea, void *code); +extern void _xtos_core_restore(unsigned retvalue, XtosCoreState *savearea); + + +#if XCHAL_NUM_CONTEXTS > 1 +extern unsigned _xtos_init_context(int context_num, int stack_size, + _xtos_handler_func *start_func, int arg1); +#endif + +/* Deprecated: */ +#if XCHAL_NUM_TIMERS > 0 +extern void _xtos_timer_0_delta( int cycles ); +#endif +#if XCHAL_NUM_TIMERS > 1 +extern void _xtos_timer_1_delta( int cycles ); +#endif +#if XCHAL_NUM_TIMERS > 2 +extern void _xtos_timer_2_delta( int cycles ); +#endif +#if XCHAL_NUM_TIMERS > 3 +extern void _xtos_timer_3_delta( int cycles ); +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* !_ASMLANGUAGE && !__ASSEMBLER__ */ + +#endif /* XTRUNTIME_H */ + diff --git a/components/esp32/include/xtensa/xtutil.h b/components/esp32/include/xtensa/xtutil.h new file mode 100755 index 000000000..fb05c3705 --- /dev/null +++ b/components/esp32/include/xtensa/xtutil.h @@ -0,0 +1,61 @@ + +/* $Id$ */ +/*******************************************************************************/ +/* Copyright (c) 2001-2013 by Tensilica Inc. ALL RIGHTS RESERVED. */ +/* These coded instructions, statements, and computer programs are the */ +/* copyrighted works and confidential proprietary information of Tensilica Inc.*/ +/* They may not be modified, copied, reproduced, distributed, or disclosed to */ +/* third parties in any manner, medium, or form, in whole or in part, without */ +/* the prior written consent of Tensilica Inc. */ +/*******************************************************************************/ + +#ifndef XTUTIL_H +#define XTUTIL_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +extern int xt_putchar(int c); +extern int xt_puts(const char * s); +extern void xt_putn(unsigned n); +extern int xt_atoi(const char * s); +extern int xt_printf(const char *fmt, ...); +extern int xt_sprintf(char * buf, const char * fmt, ...); + +typedef int xt_output_fn(int *, int, const void *, int); +extern xt_output_fn * xt_set_output_fn(xt_output_fn * fn); + +#ifdef XTUTIL_LIB + +// Only defined if building library + +typedef void (xt_outbuf_fn)(void *, char *, int); + +extern int xt_vprintf(xt_outbuf_fn * out, void * outarg, const char * fmt, va_list ap); + +#else + +// Only defined if building application and overriding + +#ifndef XTUTIL_NO_OVERRIDE + +#define putchar xt_putchar +#define puts xt_puts +#define putn xt_putn +#define atoi xt_atoi +#define printf xt_printf +#define sprintf xt_sprintf + +#endif // XTUTIL_NO_OVERRIDE + +#endif // XTUTIL_LIB + +#ifdef __cplusplus +} +#endif + +#endif // XTUTIL_H + diff --git a/components/esp32/ld/eagle.fpga32.rom.addr.v7.ld b/components/esp32/ld/eagle.fpga32.rom.addr.v7.ld new file mode 100644 index 000000000..3777405fe --- /dev/null +++ b/components/esp32/ld/eagle.fpga32.rom.addr.v7.ld @@ -0,0 +1,1829 @@ +/* +ESP32 ROM address table +Generated for ROM with MD5sum: +ab8282ae908fe9e7a63fb2a4ac2df013 ../../rom_image/prorom.elf +*/ +PROVIDE ( abort = 0x4000bba4 ); +PROVIDE ( abs = 0x40056340 ); +PROVIDE ( __absvdi2 = 0x4006387c ); +PROVIDE ( __absvsi2 = 0x40063868 ); +PROVIDE ( Add2SelfBigHex256 = 0x40015b7c ); +PROVIDE ( AddBigHex256 = 0x40015b28 ); +PROVIDE ( AddBigHexModP256 = 0x40015c98 ); +PROVIDE ( __adddf3 = 0x40002590 ); +PROVIDE ( AddP256 = 0x40015c74 ); +PROVIDE ( AddPdiv2_256 = 0x40015ce0 ); +PROVIDE ( __addsf3 = 0x400020e8 ); +PROVIDE ( __addvdi3 = 0x40002cbc ); +PROVIDE ( __addvsi3 = 0x40002c98 ); +PROVIDE ( aes_128_cbc_decrypt = 0x4005cc7c ); +PROVIDE ( aes_128_cbc_encrypt = 0x4005cc18 ); +PROVIDE ( aes_unwrap = 0x4005ccf0 ); +PROVIDE ( app_gpio_arg = 0x3ffe003c ); +PROVIDE ( app_gpio_handler = 0x3ffe0040 ); +PROVIDE ( __ascii_wctomb = 0x40058ef0 ); +PROVIDE ( asctime = 0x40059588 ); +PROVIDE ( asctime_r = 0x40000ec8 ); +PROVIDE ( __ashldi3 = 0x4000c818 ); +PROVIDE ( __ashrdi3 = 0x4000c830 ); +PROVIDE ( asiprintf = 0x40056d9c ); +PROVIDE ( _asiprintf_r = 0x40056d4c ); +PROVIDE ( asniprintf = 0x40056cd8 ); +PROVIDE ( _asniprintf_r = 0x40056c64 ); +PROVIDE ( asnprintf = 0x40056cd8 ); +PROVIDE ( _asnprintf_r = 0x40056c64 ); +PROVIDE ( asprintf = 0x40056d9c ); +PROVIDE ( _asprintf_r = 0x40056d4c ); +PROVIDE ( atoi = 0x400566c4 ); +PROVIDE ( _atoi_r = 0x400566d4 ); +PROVIDE ( atol = 0x400566ec ); +PROVIDE ( _atol_r = 0x400566fc ); +PROVIDE ( base64_decode = 0x4005ced8 ); +PROVIDE ( base64_encode = 0x4005cdbc ); +PROVIDE ( BasePoint_x_256 = 0x3ff97488 ); +PROVIDE ( BasePoint_y_256 = 0x3ff97468 ); +PROVIDE ( bigHexInversion256 = 0x400168f0 ); +PROVIDE ( bigHexP256 = 0x3ff973bc ); +PROVIDE ( __bswapdi2 = 0x400649c4 ); +PROVIDE ( __bswapsi2 = 0x4006499c ); +PROVIDE ( btdm_r_ble_bt_handler_tab_p_get = 0x40019b0c ); +PROVIDE ( btdm_r_btdm_option_data_p_get = 0x40010004 ); +PROVIDE ( btdm_r_btdm_rom_version_get = 0x40010078 ); +PROVIDE ( btdm_r_data_init = 0x4001002c ); +PROVIDE ( btdm_r_import_rf_phy_func_p_get = 0x40054298 ); +PROVIDE ( btdm_r_ip_func_p_get = 0x40019af0 ); +PROVIDE ( btdm_r_ip_func_p_set = 0x40019afc ); +PROVIDE ( btdm_r_modules_func_p_get = 0x4005427c ); +PROVIDE ( btdm_r_modules_func_p_set = 0x40054270 ); +PROVIDE ( btdm_r_plf_func_p_set = 0x40054288 ); +PROVIDE ( bt_util_buf_env = 0x3ffb8bd4 ); +PROVIDE ( bzero = 0x4000c1f4 ); +PROVIDE ( cache_flash_mmu_set = 0x400095e0 ); +PROVIDE ( Cache_Flush = 0x40009a14 ); +PROVIDE ( Cache_Read_Disable = 0x40009ab8 ); +PROVIDE ( Cache_Read_Enable = 0x40009a84 ); +PROVIDE ( Cache_Read_Init = 0x40009950 ); +PROVIDE ( cache_sram_mmu_set = 0x400097f4 ); +PROVIDE ( calloc = 0x4000bee4 ); +PROVIDE ( _calloc_r = 0x4000bbf8 ); +PROVIDE ( check_pos = 0x400068b8 ); +PROVIDE ( _cleanup = 0x40001df8 ); +PROVIDE ( _cleanup_r = 0x40001d48 ); +PROVIDE ( __clear_cache = 0x40063860 ); +PROVIDE ( close = 0x40001778 ); +PROVIDE ( _close_r = 0x4000bd3c ); +PROVIDE ( __clrsbdi2 = 0x40064a38 ); +PROVIDE ( __clrsbsi2 = 0x40064a20 ); +PROVIDE ( __clzdi2 = 0x4000ca50 ); +PROVIDE ( __clzsi2 = 0x4000c7e8 ); +PROVIDE ( __cmpdi2 = 0x40063820 ); +PROVIDE ( co_default_bdaddr = 0x3ffae704 ); +PROVIDE ( co_null_bdaddr = 0x3ffb80e0 ); +PROVIDE ( co_sca2ppm = 0x3ff971e8 ); +PROVIDE ( crc16_be = 0x4005d09c ); +PROVIDE ( crc16_le = 0x4005d05c ); +PROVIDE ( crc32_be = 0x4005d024 ); +PROVIDE ( crc32_le = 0x4005cfec ); +PROVIDE ( crc8_be = 0x4005d114 ); +PROVIDE ( crc8_le = 0x4005d0e0 ); +PROVIDE ( creat = 0x40000e8c ); +PROVIDE ( ctime = 0x400595b0 ); +PROVIDE ( ctime_r = 0x400595c4 ); +PROVIDE ( _ctype_ = 0x3ff96354 ); +PROVIDE ( __ctype_ptr__ = 0x3ff96350 ); +PROVIDE ( __ctzdi2 = 0x4000ca64 ); +PROVIDE ( __ctzsi2 = 0x4000c7f0 ); +PROVIDE ( _data_end = 0x4000d5c8 ); +PROVIDE ( _data_end_btdm_rom = 0x4000d4f8 ); +PROVIDE ( _data_start = 0x4000d4f8 ); +PROVIDE ( _data_start_btdm_rom = 0x4000d4f4 ); +PROVIDE ( _daylight = 0x3ffae0a4 ); +PROVIDE ( dbg_default_handler = 0x3ff97218 ); +PROVIDE ( dbg_state = 0x3ffb8d5d ); +PROVIDE ( DebugE256PublicKey_x = 0x3ff97428 ); +PROVIDE ( DebugE256PublicKey_y = 0x3ff97408 ); +PROVIDE ( DebugE256SecretKey = 0x3ff973e8 ); +PROVIDE ( _DebugExceptionVector = 0x40000280 ); +PROVIDE ( debug_timer = 0x3ffe042c ); +PROVIDE ( debug_timerfn = 0x3ffe0430 ); +PROVIDE ( dh_group14_generator = 0x3ff9ac60 ); +PROVIDE ( dh_group14_prime = 0x3ff9ab60 ); +PROVIDE ( dh_group15_generator = 0x3ff9ab5f ); +PROVIDE ( dh_group15_prime = 0x3ff9a9df ); +PROVIDE ( dh_group16_generator = 0x3ff9a9de ); +PROVIDE ( dh_group16_prime = 0x3ff9a7de ); +PROVIDE ( dh_group17_generator = 0x3ff9a7dd ); +PROVIDE ( dh_group17_prime = 0x3ff9a4dd ); +PROVIDE ( dh_group18_generator = 0x3ff9a4dc ); +PROVIDE ( dh_group18_prime = 0x3ff9a0dc ); +PROVIDE ( dh_group1_generator = 0x3ff9ae03 ); +PROVIDE ( dh_group1_prime = 0x3ff9ada3 ); +PROVIDE ( dh_group2_generator = 0x3ff9ada2 ); +PROVIDE ( dh_group2_prime = 0x3ff9ad22 ); +PROVIDE ( dh_group5_generator = 0x3ff9ad21 ); +PROVIDE ( dh_group5_prime = 0x3ff9ac61 ); +PROVIDE ( div = 0x40056348 ); +PROVIDE ( __divdc3 = 0x40064460 ); +PROVIDE ( __divdf3 = 0x40002954 ); +PROVIDE ( __divdi3 = 0x4000ca84 ); +PROVIDE ( __divsc3 = 0x40064200 ); +PROVIDE ( __divsf3 = 0x4000234c ); +PROVIDE ( __divsi3 = 0x4000c7b8 ); +PROVIDE ( _DoubleExceptionVector = 0x400003c0 ); +PROVIDE ( dummy_len_plus = 0x3ffae290 ); +PROVIDE ( __dummy_lock = 0x4000c728 ); +PROVIDE ( __dummy_lock_try = 0x4000c730 ); +PROVIDE ( ecc_env = 0x3ffb8d60 ); +PROVIDE ( ecc_Jacobian_InfinityPoint256 = 0x3ff972e8 ); +PROVIDE ( em_buf_env = 0x3ffb8d74 ); +PROVIDE ( environ = 0x3ffae0b4 ); +PROVIDE ( __env_lock = 0x40001fd4 ); +PROVIDE ( __env_unlock = 0x40001fe0 ); +PROVIDE ( __eqdf2 = 0x400636a8 ); +PROVIDE ( __eqsf2 = 0x40063374 ); +PROVIDE ( esp_crc8 = 0x4005d144 ); +PROVIDE ( _etext = 0x4000d66c ); +PROVIDE ( ets_aes_crypt = 0x4005c9b8 ); +PROVIDE ( ets_aes_disable = 0x4005c8f8 ); +PROVIDE ( ets_aes_enable = 0x4005c8cc ); +PROVIDE ( ets_aes_set_endian = 0x4005c928 ); +PROVIDE ( ets_aes_setkey_dec = 0x4005c994 ); +PROVIDE ( ets_aes_setkey_enc = 0x4005c97c ); +PROVIDE ( ets_bigint_disable = 0x4005c4e0 ); +PROVIDE ( ets_bigint_enable = 0x4005c498 ); +PROVIDE ( ets_bigint_mod_mult_getz = 0x4005c818 ); +PROVIDE ( ets_bigint_mod_mult_prepare = 0x4005c7b4 ); +PROVIDE ( ets_bigint_mod_power_getz = 0x4005c614 ); +PROVIDE ( ets_bigint_mod_power_prepare = 0x4005c54c ); +PROVIDE ( ets_bigint_montgomery_mult_getz = 0x4005c7a4 ); +PROVIDE ( ets_bigint_montgomery_mult_prepare = 0x4005c6fc ); +PROVIDE ( ets_bigint_mult_getz = 0x4005c6e8 ); +PROVIDE ( ets_bigint_mult_prepare = 0x4005c630 ); +PROVIDE ( ets_bigint_wait_finish = 0x4005c520 ); +PROVIDE ( ets_delay_us = 0x40008534 ); +PROVIDE ( ets_efuse_get_8M_clock = 0x40008710 ); +PROVIDE ( ets_efuse_get_spiconfig = 0x40008658 ); +PROVIDE ( ets_efuse_program_op = 0x40008628 ); +PROVIDE ( ets_efuse_read_op = 0x40008600 ); +PROVIDE ( ets_get_cpu_frequency = 0x4000855c ); +PROVIDE ( ets_get_detected_xtal_freq = 0x40008588 ); +PROVIDE ( ets_get_xtal_scale = 0x4000856c ); +PROVIDE ( ets_install_putc1 = 0x40007d18 ); +PROVIDE ( ets_install_putc2 = 0x40007d38 ); +PROVIDE ( ets_install_uart_printf = 0x40007d28 ); +PROVIDE ( ets_intr_count = 0x3ffe03fc ); +PROVIDE ( ets_intr_lock = 0x400067b0 ); +PROVIDE ( ets_intr_unlock = 0x400067c4 ); +PROVIDE ( ets_isr_attach = 0x400067ec ); +PROVIDE ( ets_isr_mask = 0x400067fc ); +PROVIDE ( ets_isr_unmask = 0x40006808 ); +PROVIDE ( ets_post = 0x4000673c ); +PROVIDE ( ets_printf = 0x40007d54 ); +PROVIDE ( ets_readySet_ = 0x3ffe01f0 ); +PROVIDE ( ets_run = 0x400066bc ); +PROVIDE ( ets_secure_boot_check = 0x4005cb40 ); +PROVIDE ( ets_secure_boot_check_finish = 0x4005cc04 ); +PROVIDE ( ets_secure_boot_check_start = 0x4005cbcc ); +PROVIDE ( ets_secure_boot_finish = 0x4005ca84 ); +PROVIDE ( ets_secure_boot_hash = 0x4005cad4 ); +PROVIDE ( ets_secure_boot_obtain = 0x4005cb14 ); +PROVIDE ( ets_secure_boot_rd_abstract = 0x4005cba8 ); +PROVIDE ( ets_secure_boot_rd_iv = 0x4005cb84 ); +PROVIDE ( ets_secure_boot_start = 0x4005ca34 ); +PROVIDE ( ets_set_appcpu_boot_addr = 0x4000689c ); +PROVIDE ( ets_set_idle_cb = 0x40006674 ); +PROVIDE ( ets_set_startup_callback = 0x4000688c ); +PROVIDE ( ets_set_user_start = 0x4000687c ); +PROVIDE ( ets_sha_disable = 0x4005c0a8 ); +PROVIDE ( ets_sha_enable = 0x4005c07c ); +PROVIDE ( ets_sha_finish = 0x4005c104 ); +PROVIDE ( ets_sha_init = 0x4005c0d4 ); +PROVIDE ( ets_sha_update = 0x4005c2a0 ); +PROVIDE ( ets_startup_callback = 0x3ffe0404 ); +PROVIDE ( ets_task = 0x40006688 ); +PROVIDE ( ets_timer_arm = 0x40008368 ); +PROVIDE ( ets_timer_arm_us = 0x400083ac ); +PROVIDE ( ets_timer_disarm = 0x400083ec ); +PROVIDE ( ets_timer_done = 0x40008428 ); +PROVIDE ( ets_timer_handler_isr = 0x40008454 ); +PROVIDE ( ets_timer_init = 0x400084e8 ); +PROVIDE ( ets_timer_setfn = 0x40008350 ); +PROVIDE ( ets_unpack_flash_code = 0x40007018 ); +PROVIDE ( ets_unpack_flash_code_legacy = 0x4000694c ); +PROVIDE ( ets_update_cpu_frequency = 0x40008550 ); +PROVIDE ( ets_waiti0 = 0x400067d8 ); +PROVIDE ( exc_cause_table = 0x3ff991d0 ); +PROVIDE ( _exit_r = 0x4000bd28 ); +PROVIDE ( __extendsfdf2 = 0x40002c34 ); +PROVIDE ( fclose = 0x400020ac ); +PROVIDE ( _fclose_r = 0x40001fec ); +PROVIDE ( fflush = 0x40059394 ); +PROVIDE ( _fflush_r = 0x40059320 ); +PROVIDE ( __ffsdi2 = 0x4000ca2c ); +PROVIDE ( __ffssi2 = 0x4000c804 ); +PROVIDE ( FilePacketSendDeflatedReqMsgProc = 0x40008b24 ); +PROVIDE ( FilePacketSendReqMsgProc = 0x40008860 ); +PROVIDE ( _findenv_r = 0x40001f44 ); +PROVIDE ( fiprintf = 0x40056efc ); +PROVIDE ( _fiprintf_r = 0x40056ed8 ); +PROVIDE ( fiscanf = 0x40058884 ); +PROVIDE ( _fiscanf_r = 0x400588b4 ); +PROVIDE ( __fixdfdi = 0x40002ac4 ); +PROVIDE ( __fixdfsi = 0x40002a78 ); +PROVIDE ( __fixsfdi = 0x4000244c ); +PROVIDE ( __fixsfsi = 0x4000240c ); +PROVIDE ( __fixunsdfsi = 0x40002b30 ); +PROVIDE ( __fixunssfdi = 0x40002504 ); +PROVIDE ( __fixunssfsi = 0x400024ac ); +PROVIDE ( FlashDwnLdDeflatedStartMsgProc = 0x40008ad8 ); +PROVIDE ( FlashDwnLdParamCfgMsgProc = 0x4000891c ); +PROVIDE ( FlashDwnLdStartMsgProc = 0x40008820 ); +PROVIDE ( FlashDwnLdStopDeflatedReqMsgProc = 0x40008c18 ); +PROVIDE ( FlashDwnLdStopReqMsgProc = 0x400088ec ); +PROVIDE ( __floatdidf = 0x4000c988 ); +PROVIDE ( __floatdisf = 0x4000c8c0 ); +PROVIDE ( __floatsidf = 0x4000c944 ); +PROVIDE ( __floatsisf = 0x4000c870 ); +PROVIDE ( __floatundidf = 0x4000c978 ); +PROVIDE ( __floatundisf = 0x4000c8b0 ); +PROVIDE ( __floatunsidf = 0x4000c938 ); +PROVIDE ( __floatunsisf = 0x4000c864 ); +PROVIDE ( __fp_lock_all = 0x40001f1c ); +PROVIDE ( fprintf = 0x40056efc ); +PROVIDE ( _fprintf_r = 0x40056ed8 ); +PROVIDE ( __fp_unlock_all = 0x40001f30 ); +PROVIDE ( fputwc = 0x40058ea8 ); +PROVIDE ( __fputwc = 0x40058da0 ); +PROVIDE ( _fputwc_r = 0x40058e4c ); +PROVIDE ( free = 0x4000beb8 ); +PROVIDE ( _free_r = 0x4000bbcc ); +PROVIDE ( fscanf = 0x40058884 ); +PROVIDE ( _fscanf_r = 0x400588b4 ); +PROVIDE ( _fstat_r = 0x4000bccc ); +PROVIDE ( _fwalk = 0x4000c738 ); +PROVIDE ( _fwalk_reent = 0x4000c770 ); +PROVIDE ( __gcc_bcmp = 0x40064a70 ); +PROVIDE ( __gedf2 = 0x40063768 ); +PROVIDE ( _GeneralException = 0x40000e14 ); +PROVIDE ( __gesf2 = 0x4006340c ); +PROVIDE ( __get_current_time_locale = 0x40001834 ); +PROVIDE ( _getenv_r = 0x40001fbc ); +PROVIDE ( _getpid_r = 0x4000bcfc ); +PROVIDE ( __getreent = 0x4000be8c ); +PROVIDE ( _gettimeofday_r = 0x4000bc58 ); +PROVIDE ( __gettzinfo = 0x40001fcc ); +PROVIDE ( GetUartDevice = 0x40009598 ); +PROVIDE ( GF_Jacobian_Point_Addition256 = 0x400163a4 ); +PROVIDE ( GF_Jacobian_Point_Double256 = 0x40016260 ); +PROVIDE ( GF_Point_Jacobian_To_Affine256 = 0x40016b0c ); +PROVIDE ( _global_impure_ptr = 0x3ffae0b0 ); +PROVIDE ( gmtime = 0x40059848 ); +PROVIDE ( gmtime_r = 0x40059868 ); +PROVIDE ( g_phyFuns_instance = 0x3ffae0c4 ); +PROVIDE ( gpio_init = 0x40009c20 ); +PROVIDE ( gpio_input_get = 0x40009b88 ); +PROVIDE ( gpio_input_get_high = 0x40009b9c ); +PROVIDE ( gpio_intr_ack = 0x40009dd4 ); +PROVIDE ( gpio_intr_ack_high = 0x40009e1c ); +PROVIDE ( gpio_intr_handler_register = 0x40009e6c ); +PROVIDE ( gpio_intr_pending = 0x40009cec ); +PROVIDE ( gpio_intr_pending_high = 0x40009cf8 ); +PROVIDE ( gpio_matrix_in = 0x40009edc ); +PROVIDE ( gpio_matrix_out = 0x40009f0c ); +PROVIDE ( gpio_output_set = 0x40009b24 ); +PROVIDE ( gpio_output_set_high = 0x40009b5c ); +PROVIDE ( gpio_pad_hold = 0x4000a734 ); +PROVIDE ( gpio_pad_pulldown = 0x4000a348 ); +PROVIDE ( gpio_pad_pullup = 0x4000a22c ); +PROVIDE ( gpio_pad_select_gpio = 0x40009fdc ); +PROVIDE ( gpio_pad_set_drv = 0x4000a11c ); +PROVIDE ( gpio_pad_unhold = 0x4000a484 ); +PROVIDE ( gpio_pending_mask = 0x3ffe0038 ); +PROVIDE ( gpio_pending_mask_high = 0x3ffe0044 ); +PROVIDE ( gpio_pin_intr_state_set = 0x40009d04 ); +PROVIDE ( gpio_pin_wakeup_disable = 0x40009eb0 ); +PROVIDE ( gpio_pin_wakeup_enable = 0x40009e7c ); +PROVIDE ( gpio_register_get = 0x40009cbc ); +PROVIDE ( gpio_register_set = 0x40009bbc ); +PROVIDE ( __gtdf2 = 0x400636dc ); +PROVIDE ( __gtsf2 = 0x400633a0 ); +PROVIDE ( gTxMsg = 0x3ffe0050 ); +PROVIDE ( hci_cmd_desc_root_tab = 0x3ff976d4 ); +PROVIDE ( hci_cmd_desc_tab_ctrl_bb = 0x3ff97b70 ); +PROVIDE ( hci_cmd_desc_tab_info_par = 0x3ff97b1c ); +PROVIDE ( hci_cmd_desc_tab_le = 0x3ff97870 ); +PROVIDE ( hci_cmd_desc_tab_lk_ctrl = 0x3ff97fc0 ); +PROVIDE ( hci_cmd_desc_tab_lk_pol = 0x3ff97f3c ); +PROVIDE ( hci_cmd_desc_tab_stat_par = 0x3ff97ac8 ); +PROVIDE ( hci_cmd_desc_tab_testing = 0x3ff97a98 ); +PROVIDE ( hci_cmd_desc_tab_vs = 0x3ff97714 ); +PROVIDE ( hci_command_handler = 0x4004c928 ); +PROVIDE ( hci_env = 0x3ffb9350 ); +PROVIDE ( hci_evt_dbg_desc_tab = 0x3ff9750c ); +PROVIDE ( hci_evt_desc_tab = 0x3ff9751c ); +PROVIDE ( hci_evt_le_desc_tab = 0x3ff974b4 ); +PROVIDE ( hci_fc_env = 0x3ffb9340 ); +PROVIDE ( hmac_md5 = 0x4005d264 ); +PROVIDE ( hmac_md5_vector = 0x4005d17c ); +PROVIDE ( hmac_sha1 = 0x40060acc ); +PROVIDE ( hmac_sha1_vector = 0x400609e4 ); +PROVIDE ( hmac_sha256 = 0x40060d58 ); +PROVIDE ( hmac_sha256_vector = 0x40060c84 ); +PROVIDE ( intr_matrix_set = 0x4000681c ); +PROVIDE ( iprintf = 0x40056978 ); +PROVIDE ( _iprintf_r = 0x40056944 ); +PROVIDE ( isalnum = 0x40000f04 ); +PROVIDE ( isalpha = 0x40000f18 ); +PROVIDE ( isascii = 0x4000c20c ); +PROVIDE ( _isatty_r = 0x40000ea0 ); +PROVIDE ( isblank = 0x40000f2c ); +PROVIDE ( iscanf = 0x40058760 ); +PROVIDE ( _iscanf_r = 0x4005879c ); +PROVIDE ( iscntrl = 0x40000f50 ); +PROVIDE ( isdigit = 0x40000f64 ); +PROVIDE ( isgraph = 0x40000f94 ); +PROVIDE ( islower = 0x40000f78 ); +PROVIDE ( isprint = 0x40000fa8 ); +PROVIDE ( ispunct = 0x40000fc0 ); +PROVIDE ( isspace = 0x40000fd4 ); +PROVIDE ( isupper = 0x40000fe8 ); +PROVIDE ( itoa = 0x400566b4 ); +PROVIDE ( __itoa = 0x40056678 ); +PROVIDE ( jd_decomp = 0x400613e8 ); +PROVIDE ( jd_prepare = 0x40060fa8 ); +PROVIDE ( ke_env = 0x3ffb93cc ); +PROVIDE ( _KernelExceptionVector = 0x40000300 ); +PROVIDE ( _kill_r = 0x4000bd10 ); +PROVIDE ( labs = 0x40056370 ); +PROVIDE ( lb_default_handler = 0x3ff982b8 ); +PROVIDE ( lb_default_state_tab_p_get = 0x4001c198 ); +PROVIDE ( lb_env = 0x3ffb9424 ); +PROVIDE ( lb_hci_cmd_handler_tab_p_get = 0x4001c18c ); +PROVIDE ( lb_state = 0x3ffb94e8 ); +PROVIDE ( lc_default_handler = 0x3ff98648 ); +PROVIDE ( lc_default_state_tab_p_get = 0x4002f494 ); +PROVIDE ( lc_env = 0x3ffb94ec ); +PROVIDE ( lc_hci_cmd_handler_tab_p_get = 0x4002f488 ); +PROVIDE ( lc_state = 0x3ffb9508 ); +PROVIDE ( ld_acl_br_sizes = 0x3ff98a2a ); +PROVIDE ( ld_acl_br_types = 0x3ff98a36 ); +PROVIDE ( ld_acl_edr_sizes = 0x3ff98a14 ); +PROVIDE ( ld_acl_edr_types = 0x3ff98a22 ); +PROVIDE ( ld_env = 0x3ffb9510 ); +PROVIDE ( ldiv = 0x40056378 ); +PROVIDE ( ld_pcm_settings_dft = 0x3ff98a0c ); +PROVIDE ( ld_sched_params = 0x3ffb96c0 ); +PROVIDE ( ld_sync_train_channels = 0x3ff98a3c ); +PROVIDE ( __ledf2 = 0x40063704 ); +PROVIDE ( __lesf2 = 0x400633c0 ); +PROVIDE ( _Level2FromVector = 0x40000954 ); +PROVIDE ( _Level2Vector = 0x40000180 ); +PROVIDE ( _Level3FromVector = 0x40000a28 ); +PROVIDE ( _Level3Vector = 0x400001c0 ); +PROVIDE ( _Level4FromVector = 0x40000af8 ); +PROVIDE ( _Level4Vector = 0x40000200 ); +PROVIDE ( _Level5FromVector = 0x40000c68 ); +PROVIDE ( _Level5Vector = 0x40000240 ); +PROVIDE ( _LevelOneInterrupt = 0x40000835 ); +PROVIDE ( _link_r = 0x4000bc9c ); +PROVIDE ( llc_default_handler = 0x3ff98b3c ); +PROVIDE ( llc_default_state_tab_p_get = 0x40046058 ); +PROVIDE ( llc_env = 0x3ffb96d0 ); +PROVIDE ( llc_hci_acl_data_tx_handler = 0x40042398 ); +PROVIDE ( llc_hci_cmd_handler_tab_p_get = 0x40042358 ); +PROVIDE ( llc_hci_command_handler = 0x40042360 ); +PROVIDE ( llcp_pdu_handler_tab_p_get = 0x40043f64 ); +PROVIDE ( llc_state = 0x3ffb96f8 ); +PROVIDE ( lldesc_build_chain = 0x4000a850 ); +PROVIDE ( lldesc_num2link = 0x4000a948 ); +PROVIDE ( lldesc_set_owner = 0x4000a974 ); +PROVIDE ( lld_evt_env = 0x3ffb9704 ); +PROVIDE ( lld_pdu_adv_pk_desc_tab = 0x3ff98c70 ); +PROVIDE ( lld_pdu_llcp_pk_desc_tab = 0x3ff98b68 ); +PROVIDE ( LLM_AA_CT1 = 0x3ff98d8a ); +PROVIDE ( LLM_AA_CT2 = 0x3ff98d88 ); +PROVIDE ( llm_default_handler = 0x3ff98d80 ); +PROVIDE ( llm_default_state_tab_p_get = 0x4004e718 ); +PROVIDE ( llm_hci_cmd_handler_tab_p_get = 0x4004c920 ); +PROVIDE ( llm_le_env = 0x3ffb976c ); +PROVIDE ( llm_local_cmds = 0x3ff98d38 ); +PROVIDE ( llm_local_data_len_values = 0x3ff98d1c ); +PROVIDE ( llm_local_le_feats = 0x3ff98d30 ); +PROVIDE ( llm_local_le_states = 0x3ff98d28 ); +PROVIDE ( llm_state = 0x3ffb985c ); +PROVIDE ( lm_default_handler = 0x3ff990e0 ); +PROVIDE ( lm_default_state_tab_p_get = 0x40054268 ); +PROVIDE ( lm_env = 0x3ffb9860 ); +PROVIDE ( lm_hci_cmd_handler_tab_p_get = 0x4005425c ); +PROVIDE ( lm_local_supp_feats = 0x3ff990ee ); +PROVIDE ( lm_n_page_tab = 0x3ff990e8 ); +PROVIDE ( lmp_desc_tab = 0x3ff96e6c ); +PROVIDE ( lmp_ext_desc_tab = 0x3ff96d9c ); +PROVIDE ( lm_state = 0x3ffb9a1c ); +PROVIDE ( __locale_charset = 0x40059540 ); +PROVIDE ( __locale_cjk_lang = 0x40059558 ); +PROVIDE ( localeconv = 0x4005957c ); +PROVIDE ( _localeconv_r = 0x40059560 ); +PROVIDE ( __locale_mb_cur_max = 0x40059548 ); +PROVIDE ( __locale_msgcharset = 0x40059550 ); +PROVIDE ( localtime = 0x400595dc ); +PROVIDE ( localtime_r = 0x400595fc ); +PROVIDE ( _lock_acquire = 0x4000be14 ); +PROVIDE ( _lock_acquire_recursive = 0x4000be28 ); +PROVIDE ( _lock_close = 0x4000bdec ); +PROVIDE ( _lock_close_recursive = 0x4000be00 ); +PROVIDE ( _lock_init = 0x4000bdc4 ); +PROVIDE ( _lock_init_recursive = 0x4000bdd8 ); +PROVIDE ( _lock_release = 0x4000be64 ); +PROVIDE ( _lock_release_recursive = 0x4000be78 ); +PROVIDE ( _lock_try_acquire = 0x4000be3c ); +PROVIDE ( _lock_try_acquire_recursive = 0x4000be50 ); +PROVIDE ( longjmp = 0x400562cc ); +PROVIDE ( _lseek_r = 0x4000bd8c ); +PROVIDE ( __lshrdi3 = 0x4000c84c ); +PROVIDE ( __ltdf2 = 0x40063790 ); +PROVIDE ( __ltsf2 = 0x4006342c ); +PROVIDE ( main = 0x400076c4 ); +PROVIDE ( malloc = 0x4000bea0 ); +PROVIDE ( _malloc_r = 0x4000bbb4 ); +PROVIDE ( maxSecretKey_256 = 0x3ff97448 ); +PROVIDE ( __mb_cur_max = 0x3ff96530 ); +PROVIDE ( MD5Final = 0x4005db1c ); +PROVIDE ( MD5Init = 0x4005da7c ); +PROVIDE ( MD5Update = 0x4005da9c ); +PROVIDE ( md5_vector = 0x4005db80 ); +PROVIDE ( memccpy = 0x4000c220 ); +PROVIDE ( memchr = 0x4000c244 ); +PROVIDE ( memcmp = 0x4000c260 ); +PROVIDE ( memcpy = 0x4000c2c8 ); +PROVIDE ( MemDwnLdStartMsgProc = 0x40008948 ); +PROVIDE ( MemDwnLdStopReqMsgProc = 0x400089dc ); +PROVIDE ( memmove = 0x4000c3c0 ); +PROVIDE ( MemPacketSendReqMsgProc = 0x40008978 ); +PROVIDE ( memrchr = 0x4000c400 ); +PROVIDE ( memset = 0x4000c44c ); +PROVIDE ( mktime = 0x4005a5e8 ); +PROVIDE ( mmu_init = 0x400095a4 ); +PROVIDE ( __moddi3 = 0x4000cd4c ); +PROVIDE ( __modsi3 = 0x4000c7c0 ); +PROVIDE ( __month_lengths = 0x3ff9609c ); +PROVIDE ( __muldc3 = 0x40063bf4 ); +PROVIDE ( __muldf3 = 0x4006358c ); +PROVIDE ( __muldi3 = 0x4000c9fc ); +PROVIDE ( __mulsc3 = 0x40063934 ); +PROVIDE ( __mulsf3 = 0x400632c8 ); +PROVIDE ( __mulsi3 = 0x4000c7b0 ); +PROVIDE ( MultiplyBigHexByUint32_256 = 0x40016214 ); +PROVIDE ( MultiplyBigHexModP256 = 0x400160b8 ); +PROVIDE ( MultiplyByU32ModP256 = 0x40015fdc ); +PROVIDE ( multofup = 0x4000ab8c ); +PROVIDE ( __mulvdi3 = 0x40002d78 ); +PROVIDE ( __mulvsi3 = 0x40002d60 ); +PROVIDE ( mz_adler32 = 0x4005edbc ); +PROVIDE ( mz_crc32 = 0x4005ee88 ); +PROVIDE ( mz_free = 0x4005eed4 ); +PROVIDE ( __nedf2 = 0x400636a8 ); +PROVIDE ( __negdf2 = 0x400634a0 ); +PROVIDE ( __negdi2 = 0x4000ca14 ); +PROVIDE ( __negsf2 = 0x400020c0 ); +PROVIDE ( __negvdi2 = 0x40002e98 ); +PROVIDE ( __negvsi2 = 0x40002e78 ); +PROVIDE ( __nesf2 = 0x40063374 ); +PROVIDE ( _NMIExceptionVector = 0x400002c0 ); +PROVIDE ( notEqual256 = 0x40015b04 ); +PROVIDE ( __nsau_data = 0x3ff96544 ); +PROVIDE ( one_bits = 0x3ff971f8 ); +PROVIDE ( open = 0x4000178c ); +PROVIDE ( _open_r = 0x4000bd54 ); +PROVIDE ( __paritysi2 = 0x40002f3c ); +PROVIDE ( pbkdf2_sha1 = 0x40060ba4 ); +PROVIDE ( phy_get_romfuncs = 0x40004100 ); +PROVIDE ( __popcountdi2 = 0x40002ef8 ); +PROVIDE ( __popcountsi2 = 0x40002ed0 ); +PROVIDE ( __popcount_tab = 0x3ff96544 ); +PROVIDE ( __powidf2 = 0x400638d4 ); +PROVIDE ( __powisf2 = 0x4006389c ); +PROVIDE ( _Pri_4_HandlerAddress = 0x3ffe0648 ); +PROVIDE ( _Pri_5_HandlerAddress = 0x3ffe064c ); +PROVIDE ( printf = 0x40056978 ); +PROVIDE ( _printf_common = 0x40057338 ); +PROVIDE ( _printf_float = 0x4000befc ); +PROVIDE ( _printf_i = 0x40057404 ); +PROVIDE ( _printf_r = 0x40056944 ); +PROVIDE ( qsort = 0x40056424 ); +PROVIDE ( _raise_r = 0x4000bc70 ); +PROVIDE ( rand = 0x40001058 ); +PROVIDE ( rand_r = 0x400010d4 ); +PROVIDE ( r_btdm_option_data = 0x3ffae6e0 ); +PROVIDE ( r_bt_util_buf_acl_rx_alloc = 0x40010218 ); +PROVIDE ( r_bt_util_buf_acl_rx_free = 0x40010234 ); +PROVIDE ( r_bt_util_buf_acl_tx_alloc = 0x40010268 ); +PROVIDE ( r_bt_util_buf_acl_tx_free = 0x40010280 ); +PROVIDE ( r_bt_util_buf_init = 0x400100e4 ); +PROVIDE ( r_bt_util_buf_lmp_tx_alloc = 0x400101d0 ); +PROVIDE ( r_bt_util_buf_lmp_tx_free = 0x400101ec ); +PROVIDE ( r_bt_util_buf_sync_clear = 0x400103c8 ); +PROVIDE ( r_bt_util_buf_sync_init = 0x400102c4 ); +PROVIDE ( r_bt_util_buf_sync_rx_alloc = 0x40010468 ); +PROVIDE ( r_bt_util_buf_sync_rx_free = 0x4001049c ); +PROVIDE ( r_bt_util_buf_sync_tx_alloc = 0x400103ec ); +PROVIDE ( r_bt_util_buf_sync_tx_free = 0x40010428 ); +PROVIDE ( rc4_skip = 0x40060928 ); +PROVIDE ( r_co_bdaddr_compare = 0x40014324 ); +PROVIDE ( r_co_bytes_to_string = 0x400142e4 ); +PROVIDE ( r_co_list_check_size_available = 0x400142c4 ); +PROVIDE ( r_co_list_extract = 0x4001404c ); +PROVIDE ( r_co_list_extract_after = 0x40014118 ); +PROVIDE ( r_co_list_find = 0x4001419c ); +PROVIDE ( r_co_list_init = 0x40013f14 ); +PROVIDE ( r_co_list_insert_after = 0x40014254 ); +PROVIDE ( r_co_list_insert_before = 0x40014200 ); +PROVIDE ( r_co_list_merge = 0x400141bc ); +PROVIDE ( r_co_list_pool_init = 0x40013f30 ); +PROVIDE ( r_co_list_pop_front = 0x40014028 ); +PROVIDE ( r_co_list_push_back = 0x40013fb8 ); +PROVIDE ( r_co_list_push_front = 0x40013ff4 ); +PROVIDE ( r_co_list_size = 0x400142ac ); +PROVIDE ( r_co_nb_good_channels = 0x40014360 ); +PROVIDE ( r_co_slot_to_duration = 0x40014348 ); +PROVIDE ( RcvMsg = 0x4000954c ); +PROVIDE ( r_dbg_init = 0x40014394 ); +PROVIDE ( r_dbg_platform_reset_complete = 0x400143d0 ); +PROVIDE ( r_dbg_swdiag_init = 0x40014470 ); +PROVIDE ( r_dbg_swdiag_read = 0x400144a4 ); +PROVIDE ( r_dbg_swdiag_write = 0x400144d0 ); +PROVIDE ( r_E1 = 0x400108e8 ); +PROVIDE ( r_E21 = 0x40010968 ); +PROVIDE ( r_E22 = 0x400109b4 ); +PROVIDE ( r_E3 = 0x40010a58 ); +PROVIDE ( r_ea_alarm_clear = 0x40015ab4 ); +PROVIDE ( r_ea_alarm_set = 0x40015a10 ); +PROVIDE ( read = 0x400017dc ); +PROVIDE ( _read_r = 0x4000bda8 ); +PROVIDE ( r_ea_elt_cancel = 0x400150d0 ); +PROVIDE ( r_ea_elt_create = 0x40015264 ); +PROVIDE ( r_ea_elt_insert = 0x400152a8 ); +PROVIDE ( r_ea_elt_remove = 0x400154f0 ); +PROVIDE ( r_ea_finetimer_isr = 0x400155d4 ); +PROVIDE ( r_ea_init = 0x40015228 ); +PROVIDE ( r_ea_interval_create = 0x4001555c ); +PROVIDE ( r_ea_interval_delete = 0x400155a8 ); +PROVIDE ( r_ea_interval_duration_req = 0x4001597c ); +PROVIDE ( r_ea_interval_insert = 0x4001557c ); +PROVIDE ( r_ea_interval_remove = 0x40015590 ); +PROVIDE ( realloc = 0x4000becc ); +PROVIDE ( _realloc_r = 0x4000bbe0 ); +PROVIDE ( r_ea_offset_req = 0x40015748 ); +PROVIDE ( r_ea_sleep_check = 0x40015928 ); +PROVIDE ( r_ea_sw_isr = 0x40015724 ); +PROVIDE ( r_ea_time_get_halfslot_rounded = 0x40015894 ); +PROVIDE ( r_ea_time_get_slot_rounded = 0x400158d4 ); +PROVIDE ( r_ecc_abort_key256_generation = 0x40017070 ); +PROVIDE ( r_ecc_generate_key256 = 0x40016e00 ); +PROVIDE ( r_ecc_gen_new_public_key = 0x400170c0 ); +PROVIDE ( r_ecc_gen_new_secret_key = 0x400170e4 ); +PROVIDE ( r_ecc_get_debug_Keys = 0x40017224 ); +PROVIDE ( r_ecc_init = 0x40016dbc ); +PROVIDE ( RecvBuff = 0x3ffe009c ); +PROVIDE ( recv_packet = 0x40009424 ); +PROVIDE ( r_em_buf_init = 0x4001729c ); +PROVIDE ( r_em_buf_rx_buff_addr_get = 0x400173e8 ); +PROVIDE ( r_em_buf_rx_free = 0x400173c4 ); +PROVIDE ( r_em_buf_tx_buff_addr_get = 0x40017404 ); +PROVIDE ( r_em_buf_tx_free = 0x4001741c ); +PROVIDE ( _rename_r = 0x4000bc28 ); +PROVIDE ( _ResetHandler = 0x40000450 ); +PROVIDE ( _ResetVector = 0x40000400 ); +PROVIDE ( r_F1_256 = 0x400133e4 ); +PROVIDE ( r_F2_256 = 0x40013568 ); +PROVIDE ( r_F3_256 = 0x40013664 ); +PROVIDE ( RFPLL_ICP_TABLE = 0x3ffb8b7c ); +PROVIDE ( r_G_256 = 0x40013470 ); +PROVIDE ( r_H3 = 0x40013760 ); +PROVIDE ( r_H4 = 0x40013830 ); +PROVIDE ( r_h4tl_init = 0x40017878 ); +PROVIDE ( r_h4tl_start = 0x40017924 ); +PROVIDE ( r_h4tl_stop = 0x40017934 ); +PROVIDE ( r_h4tl_write = 0x400178d0 ); +PROVIDE ( r_H5 = 0x400138dc ); +PROVIDE ( r_hashConcat = 0x40013a38 ); +PROVIDE ( r_hci_acl_tx_data_alloc = 0x4001951c ); +PROVIDE ( r_hci_acl_tx_data_received = 0x40019654 ); +PROVIDE ( r_hci_bt_acl_bdaddr_register = 0x40018900 ); +PROVIDE ( r_hci_bt_acl_bdaddr_unregister = 0x400189ac ); +PROVIDE ( r_hci_bt_acl_conhdl_register = 0x4001895c ); +PROVIDE ( r_hci_cmd_get_max_param_size = 0x400192d0 ); +PROVIDE ( r_hci_cmd_received = 0x400192f8 ); +PROVIDE ( r_hci_evt_filter_add = 0x40018a64 ); +PROVIDE ( r_hci_evt_mask_set = 0x400189e4 ); +PROVIDE ( r_hci_fc_acl_buf_size_set = 0x40017988 ); +PROVIDE ( r_hci_fc_acl_en = 0x400179d8 ); +PROVIDE ( r_hci_fc_acl_packet_sent = 0x40017a3c ); +PROVIDE ( r_hci_fc_check_host_available_nb_acl_packets = 0x40017aa4 ); +PROVIDE ( r_hci_fc_check_host_available_nb_sync_packets = 0x40017ac8 ); +PROVIDE ( r_hci_fc_host_nb_acl_pkts_complete = 0x40017a6c ); +PROVIDE ( r_hci_fc_host_nb_sync_pkts_complete = 0x40017a88 ); +PROVIDE ( r_hci_fc_init = 0x40017974 ); +PROVIDE ( r_hci_fc_sync_buf_size_set = 0x400179b0 ); +PROVIDE ( r_hci_fc_sync_en = 0x40017a30 ); +PROVIDE ( r_hci_fc_sync_packet_sent = 0x40017a54 ); +PROVIDE ( r_hci_init = 0x40018538 ); +PROVIDE ( r_hci_look_for_cmd_desc = 0x40018454 ); +PROVIDE ( r_hci_look_for_dbg_evt_desc = 0x400184c4 ); +PROVIDE ( r_hci_look_for_evt_desc = 0x400184a0 ); +PROVIDE ( r_hci_look_for_le_evt_desc = 0x400184e0 ); +PROVIDE ( r_hci_reset = 0x4001856c ); +PROVIDE ( r_hci_send_2_host = 0x400185bc ); +PROVIDE ( r_hci_sync_tx_data_alloc = 0x40019754 ); +PROVIDE ( r_hci_sync_tx_data_received = 0x400197c0 ); +PROVIDE ( r_hci_tl_init = 0x40019290 ); +PROVIDE ( r_hci_tl_send = 0x40019228 ); +PROVIDE ( r_hci_util_pack = 0x40019874 ); +PROVIDE ( r_hci_util_unpack = 0x40019998 ); +PROVIDE ( r_hci_voice_settings_get = 0x40018bdc ); +PROVIDE ( r_hci_voice_settings_set = 0x40018be8 ); +PROVIDE ( r_HMAC = 0x40013968 ); +PROVIDE ( r_import_rf_phy_func = 0x3ffb8354 ); +PROVIDE ( r_import_rf_phy_func_p = 0x3ffafd64 ); +PROVIDE ( r_ip_funcs = 0x3ffae710 ); +PROVIDE ( r_ip_funcs_p = 0x3ffae70c ); +PROVIDE ( r_ke_check_malloc = 0x40019de0 ); +PROVIDE ( r_ke_event_callback_set = 0x40019ba8 ); +PROVIDE ( r_ke_event_clear = 0x40019c2c ); +PROVIDE ( r_ke_event_flush = 0x40019ccc ); +PROVIDE ( r_ke_event_get = 0x40019c78 ); +PROVIDE ( r_ke_event_get_all = 0x40019cc0 ); +PROVIDE ( r_ke_event_init = 0x40019b90 ); +PROVIDE ( r_ke_event_schedule = 0x40019cdc ); +PROVIDE ( r_ke_event_set = 0x40019be0 ); +PROVIDE ( r_ke_flush = 0x4001a374 ); +PROVIDE ( r_ke_free = 0x4001a014 ); +PROVIDE ( r_ke_get_max_mem_usage = 0x4001a1c8 ); +PROVIDE ( r_ke_get_mem_usage = 0x4001a1a0 ); +PROVIDE ( r_ke_init = 0x4001a318 ); +PROVIDE ( r_ke_is_free = 0x4001a184 ); +PROVIDE ( r_ke_malloc = 0x40019eb4 ); +PROVIDE ( r_ke_mem_init = 0x40019d3c ); +PROVIDE ( r_ke_mem_is_empty = 0x40019d8c ); +PROVIDE ( r_ke_msg_alloc = 0x4001a1e0 ); +PROVIDE ( r_ke_msg_dest_id_get = 0x4001a2e0 ); +PROVIDE ( r_ke_msg_discard = 0x4001a850 ); +PROVIDE ( r_ke_msg_forward = 0x4001a290 ); +PROVIDE ( r_ke_msg_forward_new_id = 0x4001a2ac ); +PROVIDE ( r_ke_msg_free = 0x4001a2cc ); +PROVIDE ( r_ke_msg_in_queue = 0x4001a2f8 ); +PROVIDE ( r_ke_msg_save = 0x4001a858 ); +PROVIDE ( r_ke_msg_send = 0x4001a234 ); +PROVIDE ( r_ke_msg_send_basic = 0x4001a26c ); +PROVIDE ( r_ke_msg_src_id_get = 0x4001a2ec ); +PROVIDE ( r_ke_queue_extract = 0x40055fd0 ); +PROVIDE ( r_ke_queue_insert = 0x40056020 ); +PROVIDE ( r_ke_sleep_check = 0x4001a3d8 ); +PROVIDE ( r_ke_state_get = 0x4001a7d8 ); +PROVIDE ( r_ke_state_set = 0x4001a6fc ); +PROVIDE ( r_ke_stats_get = 0x4001a3f0 ); +PROVIDE ( r_ke_task_check = 0x4001a8a4 ); +PROVIDE ( r_ke_task_create = 0x4001a674 ); +PROVIDE ( r_ke_task_delete = 0x4001a6c0 ); +PROVIDE ( r_ke_task_init = 0x4001a650 ); +PROVIDE ( r_ke_task_msg_flush = 0x4001a860 ); +PROVIDE ( r_ke_timer_active = 0x4001ac08 ); +PROVIDE ( r_ke_timer_adjust_all = 0x4001ac30 ); +PROVIDE ( r_ke_timer_clear = 0x4001ab90 ); +PROVIDE ( r_ke_timer_init = 0x4001aa9c ); +PROVIDE ( r_ke_timer_set = 0x4001aac0 ); +PROVIDE ( r_ke_timer_sleep_check = 0x4001ac50 ); +PROVIDE ( r_KPrimC = 0x40010ad4 ); +PROVIDE ( r_lb_clk_adj_activate = 0x4001ae70 ); +PROVIDE ( r_lb_clk_adj_id_get = 0x4001af14 ); +PROVIDE ( r_lb_clk_adj_period_update = 0x4001af20 ); +PROVIDE ( r_lb_init = 0x4001acd4 ); +PROVIDE ( r_lb_mst_key = 0x4001afc0 ); +PROVIDE ( r_lb_mst_key_cmp = 0x4001af74 ); +PROVIDE ( r_lb_mst_key_restart_enc = 0x4001b0d4 ); +PROVIDE ( r_lb_mst_start_act_bcst_enc = 0x4001b198 ); +PROVIDE ( r_lb_mst_stop_act_bcst_enc = 0x4001b24c ); +PROVIDE ( r_lb_reset = 0x4001ad38 ); +PROVIDE ( r_lb_send_lmp = 0x4001adbc ); +PROVIDE ( r_lb_send_pdu_clk_adj = 0x4001af3c ); +PROVIDE ( r_lb_util_get_csb_mode = 0x4001ada4 ); +PROVIDE ( r_lb_util_get_nb_broadcast = 0x4001ad80 ); +PROVIDE ( r_lb_util_get_res_lt_addr = 0x4001ad98 ); +PROVIDE ( r_lb_util_set_nb_broadcast = 0x4001ad8c ); +PROVIDE ( r_lc_afh_set = 0x4001cc74 ); +PROVIDE ( r_lc_afh_start = 0x4001d240 ); +PROVIDE ( r_lc_auth_cmp = 0x4001cd54 ); +PROVIDE ( r_lc_calc_link_key = 0x4001ce7c ); +PROVIDE ( r_lc_chg_pkt_type_cmp = 0x4001d038 ); +PROVIDE ( r_lc_chg_pkt_type_cont = 0x4001cfbc ); +PROVIDE ( r_lc_chg_pkt_type_retry = 0x4001d0ac ); +PROVIDE ( r_lc_chk_to = 0x4001d2a8 ); +PROVIDE ( r_lc_cmd_stat_send = 0x4001c914 ); +PROVIDE ( r_lc_comb_key_svr = 0x4001d30c ); +PROVIDE ( r_lc_con_cmp = 0x4001d44c ); +PROVIDE ( r_lc_con_cmp_evt_send = 0x4001d4fc ); +PROVIDE ( r_lc_conn_seq_done = 0x40021334 ); +PROVIDE ( r_lc_detach = 0x4002037c ); +PROVIDE ( r_lc_dhkey = 0x4001d564 ); +PROVIDE ( r_lc_enc_cmp = 0x4001d8bc ); +PROVIDE ( r_lc_enc_key_refresh = 0x4001d720 ); +PROVIDE ( r_lc_end_chk_colli = 0x4001d858 ); +PROVIDE ( r_lc_end_of_sniff_nego = 0x4001d9a4 ); +PROVIDE ( r_lc_enter_sniff_mode = 0x4001ddb8 ); +PROVIDE ( r_lc_epr_change_lk = 0x4001db38 ); +PROVIDE ( r_lc_epr_cmp = 0x4001da88 ); +PROVIDE ( r_lc_epr_resp = 0x4001e0b4 ); +PROVIDE ( r_lc_epr_rsw_cmp = 0x4001dd40 ); +PROVIDE ( r_lc_ext_feat = 0x40020d6c ); +PROVIDE ( r_lc_feat = 0x40020984 ); +PROVIDE ( r_lc_hl_connect = 0x400209e8 ); +PROVIDE ( r_lc_init = 0x4001c948 ); +PROVIDE ( r_lc_init_calc_f3 = 0x4001deb0 ); +PROVIDE ( r_lc_initiator_epr = 0x4001e064 ); +PROVIDE ( r_lc_init_passkey_loop = 0x4001dfc0 ); +PROVIDE ( r_lc_init_start_mutual_auth = 0x4001df60 ); +PROVIDE ( r_lc_key_exch_end = 0x4001e140 ); +PROVIDE ( r_lc_legacy_pair = 0x4001e1c0 ); +PROVIDE ( r_lc_local_switch = 0x4001e22c ); +PROVIDE ( r_lc_local_trans_mode = 0x4001e2e4 ); +PROVIDE ( r_lc_local_untrans_mode = 0x4001e3a0 ); +PROVIDE ( r_lc_loc_auth = 0x40020ecc ); +PROVIDE ( r_lc_locepr_lkref = 0x4001d648 ); +PROVIDE ( r_lc_locepr_rsw = 0x4001d5d0 ); +PROVIDE ( r_lc_loc_sniff = 0x40020a6c ); +PROVIDE ( r_lc_max_slot_mgt = 0x4001e410 ); +PROVIDE ( r_lc_mst_key = 0x4001e7c0 ); +PROVIDE ( r_lc_mst_qos_done = 0x4001ea80 ); +PROVIDE ( r_lc_mst_send_mst_key = 0x4001e8f4 ); +PROVIDE ( r_lc_mutual_auth_end = 0x4001e670 ); +PROVIDE ( r_lc_mutual_auth_end2 = 0x4001e4f4 ); +PROVIDE ( r_lc_packet_type = 0x40021038 ); +PROVIDE ( r_lc_pair = 0x40020ddc ); +PROVIDE ( r_lc_pairing_cont = 0x4001eafc ); +PROVIDE ( r_lc_passkey_comm = 0x4001ed20 ); +PROVIDE ( r_lc_prepare_all_links_for_clk_adj = 0x40021430 ); +PROVIDE ( r_lc_proc_rcv_dhkey = 0x4001edec ); +PROVIDE ( r_lc_ptt = 0x4001ee2c ); +PROVIDE ( r_lc_ptt_cmp = 0x4001eeec ); +PROVIDE ( r_lc_qos_setup = 0x4001ef50 ); +PROVIDE ( r_lc_rd_rem_name = 0x4001efd0 ); +PROVIDE ( r_lc_release = 0x4001f8a8 ); +PROVIDE ( r_lc_rem_enc = 0x4001f124 ); +PROVIDE ( r_lc_rem_name_cont = 0x4001f290 ); +PROVIDE ( r_lc_rem_nego_trans_mode = 0x4001f1b4 ); +PROVIDE ( r_lc_rem_sniff = 0x40020ca4 ); +PROVIDE ( r_lc_rem_sniff_sub_rate = 0x40020b10 ); +PROVIDE ( r_lc_rem_switch = 0x4001f070 ); +PROVIDE ( r_lc_rem_trans_mode = 0x4001f314 ); +PROVIDE ( r_lc_rem_unsniff = 0x400207a0 ); +PROVIDE ( r_lc_rem_untrans_mode = 0x4001f36c ); +PROVIDE ( r_lc_reset = 0x4001c99c ); +PROVIDE ( r_lc_resp_auth = 0x4001f518 ); +PROVIDE ( r_lc_resp_calc_f3 = 0x4001f710 ); +PROVIDE ( r_lc_resp_num_comp = 0x40020074 ); +PROVIDE ( r_lc_resp_oob_nonce = 0x4001f694 ); +PROVIDE ( r_lc_resp_oob_wait_nonce = 0x4001f66c ); +PROVIDE ( r_lc_resp_pair = 0x400208a4 ); +PROVIDE ( r_lc_resp_sec_auth = 0x4001f4a0 ); +PROVIDE ( r_lc_resp_wait_dhkey_cont = 0x4001f86c ); +PROVIDE ( r_lc_restart_enc = 0x4001f8ec ); +PROVIDE ( r_lc_restart_enc_cont = 0x4001f940 ); +PROVIDE ( r_lc_restore_afh_reporting = 0x4001f028 ); +PROVIDE ( r_lc_restore_to = 0x4001f9e0 ); +PROVIDE ( r_lc_ret_sniff_max_slot_chg = 0x4001fa30 ); +PROVIDE ( r_lc_rsw_clean_up = 0x4001dc70 ); +PROVIDE ( r_lc_rsw_done = 0x4001db94 ); +PROVIDE ( r_lc_sco_baseband_ack = 0x40022b00 ); +PROVIDE ( r_lc_sco_detach = 0x40021e40 ); +PROVIDE ( r_lc_sco_host_accept = 0x40022118 ); +PROVIDE ( r_lc_sco_host_reject = 0x400222b8 ); +PROVIDE ( r_lc_sco_host_request = 0x40021f4c ); +PROVIDE ( r_lc_sco_host_request_disc = 0x4002235c ); +PROVIDE ( r_lc_sco_init = 0x40021dc8 ); +PROVIDE ( r_lc_sco_peer_accept = 0x40022780 ); +PROVIDE ( r_lc_sco_peer_accept_disc = 0x40022a08 ); +PROVIDE ( r_lc_sco_peer_reject = 0x40022824 ); +PROVIDE ( r_lc_sco_peer_reject_disc = 0x40022a8c ); +PROVIDE ( r_lc_sco_peer_request = 0x4002240c ); +PROVIDE ( r_lc_sco_peer_request_disc = 0x400228ec ); +PROVIDE ( r_lc_sco_release = 0x40021eec ); +PROVIDE ( r_lc_sco_reset = 0x40021dfc ); +PROVIDE ( r_lc_sco_timeout = 0x40022bd4 ); +PROVIDE ( r_lc_sec_auth_compute_sres = 0x4001f3ec ); +PROVIDE ( r_lc_semi_key_cmp = 0x40020294 ); +PROVIDE ( r_lc_send_enc_chg_evt = 0x4002134c ); +PROVIDE ( r_lc_send_enc_mode = 0x40020220 ); +PROVIDE ( r_lc_send_lmp = 0x4001c1a8 ); +PROVIDE ( r_lc_send_pdu_acc = 0x4001c21c ); +PROVIDE ( r_lc_send_pdu_acc_ext4 = 0x4001c240 ); +PROVIDE ( r_lc_send_pdu_au_rand = 0x4001c308 ); +PROVIDE ( r_lc_send_pdu_auto_rate = 0x4001c5d0 ); +PROVIDE ( r_lc_send_pdu_clk_adj_ack = 0x4001c46c ); +PROVIDE ( r_lc_send_pdu_clk_adj_req = 0x4001c494 ); +PROVIDE ( r_lc_send_pdu_comb_key = 0x4001c368 ); +PROVIDE ( r_lc_send_pdu_dhkey_chk = 0x4001c8e8 ); +PROVIDE ( r_lc_send_pdu_encaps_head = 0x4001c440 ); +PROVIDE ( r_lc_send_pdu_encaps_payl = 0x4001c410 ); +PROVIDE ( r_lc_send_pdu_enc_key_sz_req = 0x4001c670 ); +PROVIDE ( r_lc_send_pdu_esco_lk_rem_req = 0x4001c5a8 ); +PROVIDE ( r_lc_send_pdu_feats_ext_req = 0x4001c6ec ); +PROVIDE ( r_lc_send_pdu_feats_res = 0x4001c694 ); +PROVIDE ( r_lc_send_pdu_in_rand = 0x4001c338 ); +PROVIDE ( r_lc_send_pdu_io_cap_res = 0x4001c72c ); +PROVIDE ( r_lc_send_pdu_lsto = 0x4001c64c ); +PROVIDE ( r_lc_send_pdu_max_slot = 0x4001c3c8 ); +PROVIDE ( r_lc_send_pdu_max_slot_req = 0x4001c3ec ); +PROVIDE ( r_lc_send_pdu_not_acc = 0x4001c26c ); +PROVIDE ( r_lc_send_pdu_not_acc_ext4 = 0x4001c294 ); +PROVIDE ( r_lc_send_pdu_num_comp_fail = 0x4001c770 ); +PROVIDE ( r_lc_send_pdu_pause_enc_aes_req = 0x4001c794 ); +PROVIDE ( r_lc_send_pdu_paus_enc_req = 0x4001c7c0 ); +PROVIDE ( r_lc_send_pdu_ptt_req = 0x4001c4c0 ); +PROVIDE ( r_lc_send_pdu_qos_req = 0x4001c82c ); +PROVIDE ( r_lc_send_pdu_resu_enc_req = 0x4001c7e4 ); +PROVIDE ( r_lc_send_pdu_sco_lk_rem_req = 0x4001c580 ); +PROVIDE ( r_lc_send_pdu_set_afh = 0x4001c2c8 ); +PROVIDE ( r_lc_send_pdu_setup_cmp = 0x4001c808 ); +PROVIDE ( r_lc_send_pdu_slot_off = 0x4001c854 ); +PROVIDE ( r_lc_send_pdu_sniff_req = 0x4001c5f0 ); +PROVIDE ( r_lc_send_pdu_sp_cfm = 0x4001c518 ); +PROVIDE ( r_lc_send_pdu_sp_nb = 0x4001c4e8 ); +PROVIDE ( r_lc_send_pdu_sres = 0x4001c548 ); +PROVIDE ( r_lc_send_pdu_tim_acc = 0x4001c6cc ); +PROVIDE ( r_lc_send_pdu_unit_key = 0x4001c398 ); +PROVIDE ( r_lc_send_pdu_unsniff_req = 0x4001c894 ); +PROVIDE ( r_lc_send_pdu_vers_req = 0x4001c8b4 ); +PROVIDE ( r_lc_skip_hl_oob_req = 0x400201bc ); +PROVIDE ( r_lc_sniff_init = 0x40022cac ); +PROVIDE ( r_lc_sniff_max_slot_chg = 0x40020590 ); +PROVIDE ( r_lc_sniff_reset = 0x40022cc8 ); +PROVIDE ( r_lc_sniff_slot_unchange = 0x40021100 ); +PROVIDE ( r_lc_sniff_sub_mode = 0x400204fc ); +PROVIDE ( r_lc_sp_end = 0x400213a8 ); +PROVIDE ( r_lc_sp_fail = 0x40020470 ); +PROVIDE ( r_lc_sp_oob_tid_fail = 0x400204cc ); +PROVIDE ( r_lc_ssr_nego = 0x4002125c ); +PROVIDE ( r_lc_start = 0x4001ca28 ); +PROVIDE ( r_lc_start_enc = 0x4001fb28 ); +PROVIDE ( r_lc_start_enc_key_size = 0x4001fd9c ); +PROVIDE ( r_lc_start_key_exch = 0x4001fe10 ); +PROVIDE ( r_lc_start_lmp_to = 0x4001fae8 ); +PROVIDE ( r_lc_start_oob = 0x4001fffc ); +PROVIDE ( r_lc_start_passkey = 0x4001feac ); +PROVIDE ( r_lc_start_passkey_loop = 0x4001ff88 ); +PROVIDE ( r_lc_stop_afh_report = 0x40020184 ); +PROVIDE ( r_lc_stop_enc = 0x40020110 ); +PROVIDE ( r_lc_switch_cmp = 0x40020448 ); +PROVIDE ( r_lc_unit_key_svr = 0x400206d8 ); +PROVIDE ( r_lc_unsniff = 0x40020c50 ); +PROVIDE ( r_lc_unsniff_cmp = 0x40020810 ); +PROVIDE ( r_lc_unsniff_cont = 0x40020750 ); +PROVIDE ( r_lc_upd_to = 0x4002065c ); +PROVIDE ( r_lc_util_convert_pref_rate_to_packet_type = 0x4002f9b0 ); +PROVIDE ( r_lc_util_get_max_packet_size = 0x4002f4ac ); +PROVIDE ( r_lc_util_get_offset_clke = 0x4002f538 ); +PROVIDE ( r_lc_util_get_offset_clkn = 0x4002f51c ); +PROVIDE ( r_lc_util_set_loc_trans_coll = 0x4002f500 ); +PROVIDE ( r_lc_version = 0x40020a30 ); +PROVIDE ( r_ld_acl_active_hop_types_get = 0x40036e10 ); +PROVIDE ( r_ld_acl_afh_confirm = 0x40036d40 ); +PROVIDE ( r_ld_acl_afh_prepare = 0x40036c84 ); +PROVIDE ( r_ld_acl_afh_set = 0x40036b60 ); +PROVIDE ( r_ld_acl_allowed_tx_packet_types_set = 0x40036810 ); +PROVIDE ( r_ld_acl_bcst_rx_dec = 0x40036394 ); +PROVIDE ( r_ld_acl_bit_off_get = 0x40036b18 ); +PROVIDE ( r_ld_acl_clk_adj_set = 0x40036a00 ); +PROVIDE ( r_ld_acl_clk_off_get = 0x40036b00 ); +PROVIDE ( r_ld_acl_clk_set = 0x40036950 ); +PROVIDE ( r_ld_acl_clock_offset_get = 0x400364c0 ); +PROVIDE ( r_ld_acl_current_tx_power_get = 0x400368f0 ); +PROVIDE ( r_ld_acl_data_flush = 0x400357bc ); +PROVIDE ( r_ld_acl_data_tx = 0x4003544c ); +PROVIDE ( r_ld_acl_edr_set = 0x4003678c ); +PROVIDE ( r_ld_acl_enc_key_load = 0x40036404 ); +PROVIDE ( r_ld_acl_flow_off = 0x40035400 ); +PROVIDE ( r_ld_acl_flow_on = 0x4003541c ); +PROVIDE ( r_ld_acl_flush_timeout_get = 0x40035f9c ); +PROVIDE ( r_ld_acl_flush_timeout_set = 0x40035fe0 ); +PROVIDE ( r_ld_acl_init = 0x40034d08 ); +PROVIDE ( r_ld_acl_lmp_flush = 0x40035d80 ); +PROVIDE ( r_ld_acl_lmp_tx = 0x40035b34 ); +PROVIDE ( r_ld_acl_lsto_get = 0x400366b4 ); +PROVIDE ( r_ld_acl_lsto_set = 0x400366f8 ); +PROVIDE ( r_ld_acl_reset = 0x40034d24 ); +PROVIDE ( r_ld_acl_role_get = 0x40036b30 ); +PROVIDE ( r_ld_acl_rssi_delta_get = 0x40037028 ); +PROVIDE ( r_ld_acl_rsw_req = 0x40035e74 ); +PROVIDE ( r_ld_acl_rx_enc = 0x40036344 ); +PROVIDE ( r_ld_acl_rx_max_slot_get = 0x40036e58 ); +PROVIDE ( r_ld_acl_rx_max_slot_set = 0x40036ea0 ); +PROVIDE ( r_ld_acl_slot_offset_get = 0x4003653c ); +PROVIDE ( r_ld_acl_slot_offset_set = 0x40036658 ); +PROVIDE ( r_ld_acl_sniff = 0x4003617c ); +PROVIDE ( r_ld_acl_sniff_trans = 0x400360a8 ); +PROVIDE ( r_ld_acl_ssr_set = 0x40036274 ); +PROVIDE ( r_ld_acl_start = 0x40034ddc ); +PROVIDE ( r_ld_acl_stop = 0x4003532c ); +PROVIDE ( r_ld_acl_test_mode_set = 0x40036f24 ); +PROVIDE ( r_ld_acl_timing_accuracy_set = 0x4003673c ); +PROVIDE ( r_ld_acl_t_poll_get = 0x40036024 ); +PROVIDE ( r_ld_acl_t_poll_set = 0x40036068 ); +PROVIDE ( r_ld_acl_tx_enc = 0x400362f8 ); +PROVIDE ( r_ld_acl_unsniff = 0x400361e0 ); +PROVIDE ( r_ld_active_check = 0x4003cac4 ); +PROVIDE ( r_ld_afh_ch_assess_data_get = 0x4003caec ); +PROVIDE ( r_ld_bcst_acl_data_tx = 0x40038d3c ); +PROVIDE ( r_ld_bcst_acl_init = 0x40038bd0 ); +PROVIDE ( r_ld_bcst_acl_reset = 0x40038bdc ); +PROVIDE ( r_ld_bcst_acl_start = 0x4003882c ); +PROVIDE ( r_ld_bcst_afh_update = 0x40038f3c ); +PROVIDE ( r_ld_bcst_enc_key_load = 0x4003906c ); +PROVIDE ( r_ld_bcst_lmp_tx = 0x40038bf8 ); +PROVIDE ( r_ld_bcst_tx_enc = 0x40038ff8 ); +PROVIDE ( r_ld_bd_addr_get = 0x4003ca20 ); +PROVIDE ( r_ld_channel_assess = 0x4003c184 ); +PROVIDE ( r_ld_class_of_dev_get = 0x4003ca34 ); +PROVIDE ( r_ld_class_of_dev_set = 0x4003ca50 ); +PROVIDE ( r_ld_csb_rx_afh_update = 0x40039af4 ); +PROVIDE ( r_ld_csb_rx_init = 0x40039690 ); +PROVIDE ( r_ld_csb_rx_reset = 0x4003969c ); +PROVIDE ( r_ld_csb_rx_start = 0x4003972c ); +PROVIDE ( r_ld_csb_rx_stop = 0x40039bb8 ); +PROVIDE ( r_ld_csb_tx_afh_update = 0x4003a5fc ); +PROVIDE ( r_ld_csb_tx_clr_data = 0x4003a71c ); +PROVIDE ( r_ld_csb_tx_dis = 0x4003a5e8 ); +PROVIDE ( r_ld_csb_tx_en = 0x4003a1c0 ); +PROVIDE ( r_ld_csb_tx_init = 0x4003a0e8 ); +PROVIDE ( r_ld_csb_tx_reset = 0x4003a0f8 ); +PROVIDE ( r_ld_csb_tx_set_data = 0x4003a6c0 ); +PROVIDE ( r_ld_fm_clk_isr = 0x4003a7a8 ); +PROVIDE ( r_ld_fm_frame_isr = 0x4003a82c ); +PROVIDE ( r_ld_fm_init = 0x4003a760 ); +PROVIDE ( r_ld_fm_prog_check = 0x4003ab28 ); +PROVIDE ( r_ld_fm_prog_disable = 0x4003a984 ); +PROVIDE ( r_ld_fm_prog_enable = 0x4003a944 ); +PROVIDE ( r_ld_fm_prog_push = 0x4003a9d4 ); +PROVIDE ( r_ld_fm_reset = 0x4003a794 ); +PROVIDE ( r_ld_fm_rx_isr = 0x4003a7f4 ); +PROVIDE ( r_ld_fm_sket_isr = 0x4003a8a4 ); +PROVIDE ( r_ld_init = 0x4003c294 ); +PROVIDE ( r_ld_inq_init = 0x4003b15c ); +PROVIDE ( r_ld_inq_reset = 0x4003b168 ); +PROVIDE ( r_ld_inq_start = 0x4003b1f0 ); +PROVIDE ( r_ld_inq_stop = 0x4003b4f0 ); +PROVIDE ( r_ld_iscan_eir_get = 0x4003c118 ); +PROVIDE ( r_ld_iscan_eir_set = 0x4003bfa0 ); +PROVIDE ( r_ld_iscan_init = 0x4003b9f0 ); +PROVIDE ( r_ld_iscan_reset = 0x4003ba14 ); +PROVIDE ( r_ld_iscan_restart = 0x4003ba44 ); +PROVIDE ( r_ld_iscan_start = 0x4003bb28 ); +PROVIDE ( r_ld_iscan_stop = 0x4003bf1c ); +PROVIDE ( r_ld_iscan_tx_pwr_get = 0x4003c138 ); +PROVIDE ( r_ld_page_init = 0x4003d808 ); +PROVIDE ( r_ld_page_reset = 0x4003d814 ); +PROVIDE ( r_ld_page_start = 0x4003d848 ); +PROVIDE ( r_ld_page_stop = 0x4003da54 ); +PROVIDE ( r_ld_pca_coarse_clock_adjust = 0x4003e324 ); +PROVIDE ( r_ld_pca_init = 0x4003deb4 ); +PROVIDE ( r_ld_pca_initiate_clock_dragging = 0x4003e4ac ); +PROVIDE ( r_ld_pca_local_config = 0x4003df6c ); +PROVIDE ( r_ld_pca_mws_frame_sync = 0x4003e104 ); +PROVIDE ( r_ld_pca_mws_moment_offset_gt = 0x4003e278 ); +PROVIDE ( r_ld_pca_mws_moment_offset_lt = 0x4003e280 ); +PROVIDE ( r_ld_pca_reporting_enable = 0x4003e018 ); +PROVIDE ( r_ld_pca_reset = 0x4003df0c ); +PROVIDE ( r_ld_pca_update_target_offset = 0x4003e050 ); +PROVIDE ( r_ld_pscan_evt_handler = 0x4003f238 ); +PROVIDE ( r_ld_pscan_init = 0x4003f474 ); +PROVIDE ( r_ld_pscan_reset = 0x4003f498 ); +PROVIDE ( r_ld_pscan_restart = 0x4003f4b8 ); +PROVIDE ( r_ld_pscan_start = 0x4003f514 ); +PROVIDE ( r_ld_pscan_stop = 0x4003f618 ); +PROVIDE ( r_ld_read_clock = 0x4003c9e4 ); +PROVIDE ( r_ld_reset = 0x4003c714 ); +PROVIDE ( r_ld_sched_acl_add = 0x4003f978 ); +PROVIDE ( r_ld_sched_acl_remove = 0x4003f99c ); +PROVIDE ( r_ld_sched_compute = 0x4003f6f8 ); +PROVIDE ( r_ld_sched_init = 0x4003f7ac ); +PROVIDE ( r_ld_sched_inq_add = 0x4003f8a8 ); +PROVIDE ( r_ld_sched_inq_remove = 0x4003f8d0 ); +PROVIDE ( r_ld_sched_iscan_add = 0x4003f7e8 ); +PROVIDE ( r_ld_sched_iscan_remove = 0x4003f808 ); +PROVIDE ( r_ld_sched_page_add = 0x4003f910 ); +PROVIDE ( r_ld_sched_page_remove = 0x4003f938 ); +PROVIDE ( r_ld_sched_pscan_add = 0x4003f828 ); +PROVIDE ( r_ld_sched_pscan_remove = 0x4003f848 ); +PROVIDE ( r_ld_sched_reset = 0x4003f7d4 ); +PROVIDE ( r_ld_sched_sco_add = 0x4003fa4c ); +PROVIDE ( r_ld_sched_sco_remove = 0x4003fa9c ); +PROVIDE ( r_ld_sched_sniff_add = 0x4003f9c4 ); +PROVIDE ( r_ld_sched_sniff_remove = 0x4003fa0c ); +PROVIDE ( r_ld_sched_sscan_add = 0x4003f868 ); +PROVIDE ( r_ld_sched_sscan_remove = 0x4003f888 ); +PROVIDE ( r_ld_sco_audio_isr = 0x40037cc8 ); +PROVIDE ( r_ld_sco_data_tx = 0x40037ee8 ); +PROVIDE ( r_ld_sco_start = 0x40037110 ); +PROVIDE ( r_ld_sco_stop = 0x40037c40 ); +PROVIDE ( r_ld_sco_update = 0x40037a74 ); +PROVIDE ( r_ld_sscan_activated = 0x4004031c ); +PROVIDE ( r_ld_sscan_init = 0x400402f0 ); +PROVIDE ( r_ld_sscan_reset = 0x400402fc ); +PROVIDE ( r_ld_sscan_start = 0x40040384 ); +PROVIDE ( r_ld_strain_init = 0x400409f4 ); +PROVIDE ( r_ld_strain_reset = 0x40040a00 ); +PROVIDE ( r_ld_strain_start = 0x40040a8c ); +PROVIDE ( r_ld_strain_stop = 0x40040df0 ); +PROVIDE ( r_ld_timing_accuracy_get = 0x4003caac ); +PROVIDE ( r_ld_util_active_master_afh_map_get = 0x4004131c ); +PROVIDE ( r_ld_util_active_master_afh_map_set = 0x40041308 ); +PROVIDE ( r_ld_util_bch_create = 0x40040fcc ); +PROVIDE ( r_ld_util_fhs_pk = 0x400411c8 ); +PROVIDE ( r_ld_util_fhs_unpk = 0x40040e54 ); +PROVIDE ( r_ld_util_stp_pk = 0x400413f4 ); +PROVIDE ( r_ld_util_stp_unpk = 0x40041324 ); +PROVIDE ( r_ld_version_get = 0x4003ca6c ); +PROVIDE ( r_ld_wlcoex_set = 0x4003caf8 ); +PROVIDE ( r_llc_ch_assess_get_current_ch_map = 0x40041574 ); +PROVIDE ( r_llc_ch_assess_get_local_ch_map = 0x4004150c ); +PROVIDE ( r_llc_ch_assess_local = 0x40041494 ); +PROVIDE ( r_llc_ch_assess_merge_ch = 0x40041588 ); +PROVIDE ( r_llc_ch_assess_reass_ch = 0x400415c0 ); +PROVIDE ( r_llc_common_cmd_complete_send = 0x40044eac ); +PROVIDE ( r_llc_common_cmd_status_send = 0x40044ee0 ); +PROVIDE ( r_llc_common_enc_change_evt_send = 0x40044f6c ); +PROVIDE ( r_llc_common_enc_key_ref_comp_evt_send = 0x40044f38 ); +PROVIDE ( r_llc_common_flush_occurred_send = 0x40044f0c ); +PROVIDE ( r_llc_common_nb_of_pkt_comp_evt_send = 0x40045000 ); +PROVIDE ( r_llc_con_update_complete_send = 0x40044d68 ); +PROVIDE ( r_llc_con_update_finished = 0x4004518c ); +PROVIDE ( r_llc_con_update_ind = 0x40045038 ); +PROVIDE ( r_llc_discon_event_complete_send = 0x40044a30 ); +PROVIDE ( r_llc_end_evt_defer = 0x40046330 ); +PROVIDE ( r_llc_feats_rd_event_send = 0x40044e0c ); +PROVIDE ( r_llc_init = 0x40044778 ); +PROVIDE ( r_llc_le_con_cmp_evt_send = 0x40044a78 ); +PROVIDE ( r_llc_llcp_ch_map_update_pdu_send = 0x40043f94 ); +PROVIDE ( r_llc_llcp_con_param_req_pdu_send = 0x400442fc ); +PROVIDE ( r_llc_llcp_con_param_rsp_pdu_send = 0x40044358 ); +PROVIDE ( r_llc_llcp_con_update_pdu_send = 0x400442c4 ); +PROVIDE ( r_llc_llcp_enc_req_pdu_send = 0x40044064 ); +PROVIDE ( r_llc_llcp_enc_rsp_pdu_send = 0x40044160 ); +PROVIDE ( r_llc_llcp_feats_req_pdu_send = 0x400443b4 ); +PROVIDE ( r_llc_llcp_feats_rsp_pdu_send = 0x400443f0 ); +PROVIDE ( r_llc_llcp_get_autorize = 0x4004475c ); +PROVIDE ( r_llc_llcp_length_req_pdu_send = 0x40044574 ); +PROVIDE ( r_llc_llcp_length_rsp_pdu_send = 0x400445ac ); +PROVIDE ( r_llc_llcp_pause_enc_req_pdu_send = 0x40043fd8 ); +PROVIDE ( r_llc_llcp_pause_enc_rsp_pdu_send = 0x40044010 ); +PROVIDE ( r_llc_llcp_ping_req_pdu_send = 0x4004454c ); +PROVIDE ( r_llc_llcp_ping_rsp_pdu_send = 0x40044560 ); +PROVIDE ( r_llc_llcp_recv_handler = 0x40044678 ); +PROVIDE ( r_llc_llcp_reject_ind_pdu_send = 0x4004425c ); +PROVIDE ( r_llc_llcp_start_enc_req_pdu_send = 0x4004441c ); +PROVIDE ( r_llc_llcp_start_enc_rsp_pdu_send = 0x400441f8 ); +PROVIDE ( r_llc_llcp_terminate_ind_pdu_send = 0x400444b0 ); +PROVIDE ( r_llc_llcp_tester_send = 0x400445e4 ); +PROVIDE ( r_llc_llcp_unknown_rsp_send_pdu = 0x40044534 ); +PROVIDE ( r_llc_llcp_version_ind_pdu_send = 0x40043f6c ); +PROVIDE ( r_llc_lsto_con_update = 0x40045098 ); +PROVIDE ( r_llc_ltk_req_send = 0x40044dc0 ); +PROVIDE ( r_llc_map_update_finished = 0x40045260 ); +PROVIDE ( r_llc_map_update_ind = 0x400450f0 ); +PROVIDE ( r_llc_pdu_acl_tx_ack_defer = 0x400464dc ); +PROVIDE ( r_llc_pdu_defer = 0x40046528 ); +PROVIDE ( r_llc_pdu_llcp_tx_ack_defer = 0x400463ac ); +PROVIDE ( r_llc_reset = 0x400447b8 ); +PROVIDE ( r_llc_start = 0x400447f4 ); +PROVIDE ( r_llc_stop = 0x400449ac ); +PROVIDE ( r_llc_util_bw_mgt = 0x4004629c ); +PROVIDE ( r_llc_util_clear_operation_ptr = 0x40046234 ); +PROVIDE ( r_llc_util_dicon_procedure = 0x40046130 ); +PROVIDE ( r_llc_util_get_free_conhdl = 0x400460c8 ); +PROVIDE ( r_llc_util_get_nb_active_link = 0x40046100 ); +PROVIDE ( r_llc_util_set_auth_payl_to_margin = 0x400461f4 ); +PROVIDE ( r_llc_util_set_llcp_discard_enable = 0x400461c8 ); +PROVIDE ( r_llc_util_update_channel_map = 0x400461ac ); +PROVIDE ( r_llc_version_rd_event_send = 0x40044e60 ); +PROVIDE ( r_lld_adv_start = 0x40048b38 ); +PROVIDE ( r_lld_adv_stop = 0x40048ea0 ); +PROVIDE ( r_lld_ch_map_ind = 0x4004a2f4 ); +PROVIDE ( r_lld_con_param_req = 0x40049f0c ); +PROVIDE ( r_lld_con_param_rsp = 0x40049e00 ); +PROVIDE ( r_lld_con_start = 0x400491f8 ); +PROVIDE ( r_lld_con_stop = 0x40049fdc ); +PROVIDE ( r_lld_con_update_after_param_req = 0x40049bcc ); +PROVIDE ( r_lld_con_update_ind = 0x4004a30c ); +PROVIDE ( r_lld_con_update_req = 0x40049b60 ); +PROVIDE ( r_lld_core_reset = 0x40048a9c ); +PROVIDE ( r_lld_crypt_isr = 0x4004a324 ); +PROVIDE ( r_lld_evt_adv_create = 0x400481f4 ); +PROVIDE ( r_lld_evt_canceled = 0x400485c8 ); +PROVIDE ( r_lld_evt_channel_next = 0x40046aac ); +PROVIDE ( r_lld_evt_deffered_elt_handler = 0x400482bc ); +PROVIDE ( r_lld_evt_delete_elt_handler = 0x40046974 ); +PROVIDE ( r_lld_evt_delete_elt_push = 0x40046a3c ); +PROVIDE ( r_lld_evt_drift_compute = 0x40047670 ); +PROVIDE ( r_lld_evt_elt_delete = 0x40047538 ); +PROVIDE ( r_lld_evt_elt_insert = 0x400474c8 ); +PROVIDE ( r_lld_evt_end = 0x400483e8 ); +PROVIDE ( r_lld_evt_end_isr = 0x4004862c ); +PROVIDE ( r_lld_evt_init = 0x40046b3c ); +PROVIDE ( r_lld_evt_init_evt = 0x40046cd0 ); +PROVIDE ( r_lld_evt_move_to_master = 0x40047ba0 ); +PROVIDE ( r_lld_evt_move_to_slave = 0x40047e18 ); +PROVIDE ( r_lld_evt_prevent_stop = 0x40047adc ); +PROVIDE ( r_lld_evt_restart = 0x40046d50 ); +PROVIDE ( r_lld_evt_rx = 0x40048578 ); +PROVIDE ( r_lld_evt_rx_isr = 0x40048678 ); +PROVIDE ( r_lld_evt_scan_create = 0x40047ae8 ); +PROVIDE ( r_lld_evt_schedule = 0x40047908 ); +PROVIDE ( r_lld_evt_schedule_next = 0x400477dc ); +PROVIDE ( r_lld_evt_schedule_next_instant = 0x400476a8 ); +PROVIDE ( r_lld_evt_slave_update = 0x40048138 ); +PROVIDE ( r_lld_evt_update_create = 0x40047cd8 ); +PROVIDE ( r_lld_get_mode = 0x40049ff8 ); +PROVIDE ( r_lld_init = 0x4004873c ); +PROVIDE ( r_lld_move_to_master = 0x400499e0 ); +PROVIDE ( r_lld_move_to_slave = 0x4004a024 ); +PROVIDE ( r_lld_pdu_adv_pack = 0x4004b488 ); +PROVIDE ( r_lld_pdu_check = 0x4004ac34 ); +PROVIDE ( r_lld_pdu_data_send = 0x4004b018 ); +PROVIDE ( r_lld_pdu_data_tx_push = 0x4004aecc ); +PROVIDE ( r_lld_pdu_rx_handler = 0x4004b4d4 ); +PROVIDE ( r_lld_pdu_send_packet = 0x4004b774 ); +PROVIDE ( r_lld_pdu_tx_flush = 0x4004b414 ); +PROVIDE ( r_lld_pdu_tx_loop = 0x4004ae40 ); +PROVIDE ( r_lld_pdu_tx_prog = 0x4004b120 ); +PROVIDE ( r_lld_pdu_tx_push = 0x4004b080 ); +PROVIDE ( r_lld_ral_renew_req = 0x4004a73c ); +PROVIDE ( r_lld_scan_start = 0x40048ee0 ); +PROVIDE ( r_lld_scan_stop = 0x40049190 ); +PROVIDE ( r_lld_test_mode_rx = 0x4004a540 ); +PROVIDE ( r_lld_test_mode_tx = 0x4004a350 ); +PROVIDE ( r_lld_test_stop = 0x4004a710 ); +PROVIDE ( r_lld_util_anchor_point_move = 0x4004bacc ); +PROVIDE ( r_lld_util_compute_ce_max = 0x4004bc0c ); +PROVIDE ( r_lld_util_connection_param_set = 0x4004ba40 ); +PROVIDE ( r_lld_util_dle_set_cs_fields = 0x4004ba90 ); +PROVIDE ( r_lld_util_eff_tx_time_set = 0x4004bd88 ); +PROVIDE ( r_lld_util_elt_programmed = 0x4004bce0 ); +PROVIDE ( r_lld_util_flush_list = 0x4004bbd8 ); +PROVIDE ( r_lld_util_freq2chnl = 0x4004b9e4 ); +PROVIDE ( r_lld_util_get_bd_address = 0x4004b8ac ); +PROVIDE ( r_lld_util_get_local_offset = 0x4004ba10 ); +PROVIDE ( r_lld_util_get_peer_offset = 0x4004ba24 ); +PROVIDE ( r_lld_util_get_tx_pkt_cnt = 0x4004bd80 ); +PROVIDE ( r_lld_util_instant_get = 0x4004b890 ); +PROVIDE ( r_lld_util_instant_ongoing = 0x4004bbfc ); +PROVIDE ( r_lld_util_priority_set = 0x4004bd10 ); +PROVIDE ( r_lld_util_priority_update = 0x4004bd78 ); +PROVIDE ( r_lld_util_ral_force_rpa_renew = 0x4004b980 ); +PROVIDE ( r_lld_util_set_bd_address = 0x4004b8f8 ); +PROVIDE ( r_lld_wlcoex_set = 0x4004bd98 ); +PROVIDE ( r_llm_ble_ready = 0x4004cc34 ); +PROVIDE ( r_llm_common_cmd_complete_send = 0x4004d288 ); +PROVIDE ( r_llm_common_cmd_status_send = 0x4004d2b4 ); +PROVIDE ( r_llm_con_req_ind = 0x4004cc54 ); +PROVIDE ( r_llm_con_req_tx_cfm = 0x4004d158 ); +PROVIDE ( r_llm_create_con = 0x4004de78 ); +PROVIDE ( r_llm_encryption_done = 0x4004dff8 ); +PROVIDE ( r_llm_encryption_start = 0x4004e128 ); +PROVIDE ( r_llm_end_evt_defer = 0x4004eb6c ); +PROVIDE ( r_llm_init = 0x4004c9f8 ); +PROVIDE ( r_llm_le_adv_report_ind = 0x4004cdf4 ); +PROVIDE ( r_llm_pdu_defer = 0x4004ec48 ); +PROVIDE ( r_llm_ral_clear = 0x4004e1fc ); +PROVIDE ( r_llm_ral_dev_add = 0x4004e23c ); +PROVIDE ( r_llm_ral_dev_rm = 0x4004e3bc ); +PROVIDE ( r_llm_ral_get_rpa = 0x4004e400 ); +PROVIDE ( r_llm_ral_set_timeout = 0x4004e4a0 ); +PROVIDE ( r_llm_ral_update = 0x4004e4f8 ); +PROVIDE ( r_llm_set_adv_data = 0x4004d960 ); +PROVIDE ( r_llm_set_adv_en = 0x4004d7ec ); +PROVIDE ( r_llm_set_adv_param = 0x4004d5f4 ); +PROVIDE ( r_llm_set_scan_en = 0x4004db64 ); +PROVIDE ( r_llm_set_scan_param = 0x4004dac8 ); +PROVIDE ( r_llm_set_scan_rsp_data = 0x4004da14 ); +PROVIDE ( r_llm_test_mode_start_rx = 0x4004d534 ); +PROVIDE ( r_llm_test_mode_start_tx = 0x4004d2fc ); +PROVIDE ( r_llm_util_adv_data_update = 0x4004e8fc ); +PROVIDE ( r_llm_util_apply_bd_addr = 0x4004e868 ); +PROVIDE ( r_llm_util_bd_addr_in_ral = 0x4004eb08 ); +PROVIDE ( r_llm_util_bd_addr_in_wl = 0x4004e788 ); +PROVIDE ( r_llm_util_bd_addr_wl_position = 0x4004e720 ); +PROVIDE ( r_llm_util_bl_add = 0x4004e9ac ); +PROVIDE ( r_llm_util_bl_check = 0x4004e930 ); +PROVIDE ( r_llm_util_bl_rem = 0x4004ea70 ); +PROVIDE ( r_llm_util_check_address_validity = 0x4004e7e4 ); +PROVIDE ( r_llm_util_check_evt_mask = 0x4004e8b0 ); +PROVIDE ( r_llm_util_check_map_validity = 0x4004e800 ); +PROVIDE ( r_llm_util_get_channel_map = 0x4004e8d4 ); +PROVIDE ( r_llm_util_get_supp_features = 0x4004e8e8 ); +PROVIDE ( r_llm_util_set_public_addr = 0x4004e89c ); +PROVIDE ( r_llm_wl_clr = 0x4004dc54 ); +PROVIDE ( r_llm_wl_dev_add = 0x4004dcc0 ); +PROVIDE ( r_llm_wl_dev_add_hdl = 0x4004dd38 ); +PROVIDE ( r_llm_wl_dev_rem = 0x4004dcfc ); +PROVIDE ( r_llm_wl_dev_rem_hdl = 0x4004dde0 ); +PROVIDE ( r_lm_acl_disc = 0x4004f148 ); +PROVIDE ( r_LM_AddSniff = 0x40022d20 ); +PROVIDE ( r_lm_add_sync = 0x40051358 ); +PROVIDE ( r_lm_afh_activate_timer = 0x4004f444 ); +PROVIDE ( r_lm_afh_ch_ass_en_get = 0x4004f3f8 ); +PROVIDE ( r_lm_afh_host_ch_class_get = 0x4004f410 ); +PROVIDE ( r_lm_afh_master_ch_map_get = 0x4004f43c ); +PROVIDE ( r_lm_afh_peer_ch_class_set = 0x4004f418 ); +PROVIDE ( r_lm_check_active_sync = 0x40051334 ); +PROVIDE ( r_LM_CheckEdrFeatureRequest = 0x4002f90c ); +PROVIDE ( r_LM_CheckSwitchInstant = 0x4002f8c0 ); +PROVIDE ( r_lm_check_sync_hl_rsp = 0x4005169c ); +PROVIDE ( r_lm_clk_adj_ack_pending_clear = 0x4004f514 ); +PROVIDE ( r_lm_clk_adj_instant_pending_set = 0x4004f4d8 ); +PROVIDE ( r_LM_ComputePacketType = 0x4002f554 ); +PROVIDE ( r_LM_ComputeSniffSubRate = 0x400233ac ); +PROVIDE ( r_lm_debug_key_compare_192 = 0x4004f3a8 ); +PROVIDE ( r_lm_debug_key_compare_256 = 0x4004f3d0 ); +PROVIDE ( r_lm_dhkey_calc_init = 0x40013234 ); +PROVIDE ( r_lm_dhkey_compare = 0x400132d8 ); +PROVIDE ( r_lm_dut_mode_en_get = 0x4004f3ec ); +PROVIDE ( r_LM_ExtractMaxEncKeySize = 0x4001aca4 ); +PROVIDE ( r_lm_f1 = 0x40012bb8 ); +PROVIDE ( r_lm_f2 = 0x40012cfc ); +PROVIDE ( r_lm_f3 = 0x40013050 ); +PROVIDE ( r_lm_g = 0x40012f90 ); +PROVIDE ( r_LM_GetAFHSwitchInstant = 0x4002f86c ); +PROVIDE ( r_lm_get_auth_en = 0x4004f1ac ); +PROVIDE ( r_lm_get_common_pkt_types = 0x4002fa1c ); +PROVIDE ( r_LM_GetConnectionAcceptTimeout = 0x4004f1f4 ); +PROVIDE ( r_LM_GetFeature = 0x4002f924 ); +PROVIDE ( r_LM_GetLinkTimeout = 0x400233ec ); +PROVIDE ( r_LM_GetLocalNameSeg = 0x4004f200 ); +PROVIDE ( r_lm_get_loopback_mode = 0x4004f248 ); +PROVIDE ( r_LM_GetMasterEncKeySize = 0x4001b29c ); +PROVIDE ( r_LM_GetMasterEncRand = 0x4001b288 ); +PROVIDE ( r_LM_GetMasterKey = 0x4001b260 ); +PROVIDE ( r_LM_GetMasterKeyRand = 0x4001b274 ); +PROVIDE ( r_lm_get_min_sync_intv = 0x400517a8 ); +PROVIDE ( r_lm_get_nb_acl = 0x4004ef9c ); +PROVIDE ( r_lm_get_nb_sync_link = 0x4005179c ); +PROVIDE ( r_lm_get_nonce = 0x400131c4 ); +PROVIDE ( r_lm_get_oob_local_commit = 0x4004f374 ); +PROVIDE ( r_lm_get_oob_local_data_192 = 0x4004f2d4 ); +PROVIDE ( r_lm_get_oob_local_data_256 = 0x4004f318 ); +PROVIDE ( r_LM_GetPINType = 0x4004f1e8 ); +PROVIDE ( r_lm_get_priv_key_192 = 0x4004f278 ); +PROVIDE ( r_lm_get_priv_key_256 = 0x4004f2b8 ); +PROVIDE ( r_lm_get_pub_key_192 = 0x4004f258 ); +PROVIDE ( r_lm_get_pub_key_256 = 0x4004f298 ); +PROVIDE ( r_LM_GetQoSParam = 0x4002f6e0 ); +PROVIDE ( r_lm_get_sec_con_host_supp = 0x4004f1d4 ); +PROVIDE ( r_LM_GetSniffSubratingParam = 0x4002325c ); +PROVIDE ( r_lm_get_sp_en = 0x4004f1c0 ); +PROVIDE ( r_LM_GetSwitchInstant = 0x4002f7f8 ); +PROVIDE ( r_lm_get_synchdl = 0x4005175c ); +PROVIDE ( r_lm_get_sync_param = 0x400503b4 ); +PROVIDE ( r_lm_init = 0x4004ed34 ); +PROVIDE ( r_lm_init_sync = 0x400512d8 ); +PROVIDE ( r_lm_is_acl_con = 0x4004f47c ); +PROVIDE ( r_lm_is_acl_con_role = 0x4004f49c ); +PROVIDE ( r_lm_is_clk_adj_ack_pending = 0x4004f4e8 ); +PROVIDE ( r_lm_is_clk_adj_instant_pending = 0x4004f4c8 ); +PROVIDE ( r_lm_local_ext_fr_configured = 0x4004f540 ); +PROVIDE ( r_lm_look_for_stored_link_key = 0x4002f948 ); +PROVIDE ( r_lm_look_for_sync = 0x40051774 ); +PROVIDE ( r_lm_lt_addr_alloc = 0x4004ef1c ); +PROVIDE ( r_lm_lt_addr_free = 0x4004ef74 ); +PROVIDE ( r_lm_lt_addr_reserve = 0x4004ef48 ); +PROVIDE ( r_LM_MakeCof = 0x4002f84c ); +PROVIDE ( r_LM_MakeRandVec = 0x400112d8 ); +PROVIDE ( r_lm_master_clk_adj_req_handler = 0x40054180 ); +PROVIDE ( r_LM_MaxSlot = 0x4002f694 ); +PROVIDE ( r_lm_modif_sync = 0x40051578 ); +PROVIDE ( r_lm_n_is_zero = 0x40012170 ); +PROVIDE ( r_lm_num_clk_adj_ack_pending_set = 0x4004f500 ); +PROVIDE ( r_lm_oob_f1 = 0x40012e54 ); +PROVIDE ( r_lm_pca_sscan_link_get = 0x4004f560 ); +PROVIDE ( r_lm_pca_sscan_link_set = 0x4004f550 ); +PROVIDE ( r_lmp_pack = 0x4001135c ); +PROVIDE ( r_lmp_unpack = 0x4001149c ); +PROVIDE ( r_lm_read_features = 0x4004f0d8 ); +PROVIDE ( r_LM_RemoveSniff = 0x40023124 ); +PROVIDE ( r_LM_RemoveSniffSubrating = 0x400233c4 ); +PROVIDE ( r_lm_remove_sync = 0x400517c8 ); +PROVIDE ( r_lm_reset_sync = 0x40051304 ); +PROVIDE ( r_lm_role_switch_finished = 0x4004f028 ); +PROVIDE ( r_lm_role_switch_start = 0x4004efe0 ); +PROVIDE ( r_lm_sco_nego_end = 0x40051828 ); +PROVIDE ( r_LM_SniffSubrateNegoRequired = 0x40023334 ); +PROVIDE ( r_LM_SniffSubratingHlReq = 0x40023154 ); +PROVIDE ( r_LM_SniffSubratingPeerReq = 0x400231dc ); +PROVIDE ( r_lm_sp_debug_mode_get = 0x4004f398 ); +PROVIDE ( r_lm_sp_n192_convert_wnaf = 0x400123c0 ); +PROVIDE ( r_lm_sp_n_one = 0x400123a4 ); +PROVIDE ( r_lm_sp_p192_add = 0x40012828 ); +PROVIDE ( r_lm_sp_p192_dbl = 0x4001268c ); +PROVIDE ( r_lm_sp_p192_invert = 0x40012b6c ); +PROVIDE ( r_lm_sp_p192_point_jacobian_to_affine = 0x40012468 ); +PROVIDE ( r_lm_sp_p192_points_jacobian_to_affine = 0x400124e4 ); +PROVIDE ( r_lm_sp_p192_point_to_inf = 0x40012458 ); +PROVIDE ( r_lm_sp_pre_compute_points = 0x40012640 ); +PROVIDE ( r_lm_sp_sha256_calculate = 0x400121a0 ); +PROVIDE ( r_LM_SuppressAclPacket = 0x4002f658 ); +PROVIDE ( r_lm_sync_flow_ctrl_en_get = 0x4004f404 ); +PROVIDE ( r_LM_UpdateAclEdrPacketType = 0x4002f5d8 ); +PROVIDE ( r_LM_UpdateAclPacketType = 0x4002f584 ); +PROVIDE ( r_modules_funcs = 0x3ffafd6c ); +PROVIDE ( r_modules_funcs_p = 0x3ffafd68 ); +PROVIDE ( r_nvds_del = 0x400544c4 ); +PROVIDE ( r_nvds_get = 0x40054488 ); +PROVIDE ( r_nvds_init = 0x40054410 ); +PROVIDE ( r_nvds_lock = 0x400544fc ); +PROVIDE ( r_nvds_put = 0x40054534 ); +PROVIDE ( rom_abs_temp = 0x400054f0 ); +PROVIDE ( rom_bb_bss_bw_40_en = 0x4000401c ); +PROVIDE ( rom_bb_bss_cbw40_dig = 0x40003bac ); +PROVIDE ( rom_bb_rx_ht20_cen_bcov_en = 0x40003734 ); +PROVIDE ( rom_bb_tx_ht20_cen = 0x40003760 ); +PROVIDE ( rom_bb_wdg_test_en = 0x40003b70 ); +PROVIDE ( rom_cbw2040_cfg = 0x400040b0 ); +PROVIDE ( rom_check_noise_floor = 0x40003c78 ); +PROVIDE ( rom_chip_i2c_readReg = 0x40004110 ); +PROVIDE ( rom_chip_i2c_writeReg = 0x40004168 ); +PROVIDE ( rom_chip_v7_bt_init = 0x40004d8c ); +PROVIDE ( rom_chip_v7_rx_init = 0x40004cec ); +PROVIDE ( rom_chip_v7_rx_rifs_en = 0x40003d90 ); +PROVIDE ( rom_chip_v7_tx_init = 0x40004d18 ); +PROVIDE ( rom_clk_force_on_vit = 0x40003710 ); +PROVIDE ( rom_correct_rf_ana_gain = 0x400062a8 ); +PROVIDE ( rom_dc_iq_est = 0x400055c8 ); +PROVIDE ( rom_disable_agc = 0x40002fa4 ); +PROVIDE ( rom_enable_agc = 0x40002fcc ); +PROVIDE ( rom_en_pwdet = 0x4000506c ); +PROVIDE ( rom_gen_rx_gain_table = 0x40003e3c ); +PROVIDE ( rom_get_data_sat = 0x4000312c ); +PROVIDE ( rom_get_fm_sar_dout = 0x40005204 ); +PROVIDE ( rom_get_power_db = 0x40005fc8 ); +PROVIDE ( rom_get_pwctrl_correct = 0x400065d4 ); +PROVIDE ( rom_get_rfcal_rxiq_data = 0x40005bbc ); +PROVIDE ( rom_get_rf_gain_qdb = 0x40006290 ); +PROVIDE ( rom_get_sar_dout = 0x40006564 ); +PROVIDE ( rom_i2c_readReg = 0x40004148 ); +PROVIDE ( rom_i2c_readReg_Mask = 0x400041c0 ); +PROVIDE ( rom_i2c_writeReg = 0x400041a4 ); +PROVIDE ( rom_i2c_writeReg_Mask = 0x400041fc ); +PROVIDE ( rom_index_to_txbbgain = 0x40004df8 ); +PROVIDE ( rom_iq_est_disable = 0x40005590 ); +PROVIDE ( rom_iq_est_enable = 0x40005514 ); +PROVIDE ( rom_linear_to_db = 0x40005f64 ); +PROVIDE ( rom_loopback_mode_en = 0x400030f8 ); +PROVIDE ( rom_meas_tone_pwr_db = 0x40006004 ); +PROVIDE ( rom_mhz2ieee = 0x4000404c ); +PROVIDE ( rom_noise_floor_auto_set = 0x40003bdc ); +PROVIDE ( rom_pbus_debugmode = 0x40004458 ); +PROVIDE ( rom_pbus_force_mode = 0x40004270 ); +PROVIDE ( rom_pbus_force_test = 0x400043c0 ); +PROVIDE ( rom_pbus_rd = 0x40004414 ); +PROVIDE ( rom_pbus_rd_addr = 0x40004334 ); +PROVIDE ( rom_pbus_rd_shift = 0x40004374 ); +PROVIDE ( rom_pbus_rx_dco_cal = 0x40005620 ); +PROVIDE ( rom_pbus_set_dco = 0x40004638 ); +PROVIDE ( rom_pbus_set_rxgain = 0x40004480 ); +PROVIDE ( rom_pbus_workmode = 0x4000446c ); +PROVIDE ( rom_pbus_xpd_rx_off = 0x40004508 ); +PROVIDE ( rom_pbus_xpd_rx_on = 0x4000453c ); +PROVIDE ( rom_pbus_xpd_tx_off = 0x40004590 ); +PROVIDE ( rom_pbus_xpd_tx_on = 0x400045e0 ); +PROVIDE ( rom_phy_disable_agc = 0x40002f6c ); +PROVIDE ( rom_phy_disable_cca = 0x40003000 ); +PROVIDE ( rom_phy_enable_agc = 0x40002f88 ); +PROVIDE ( rom_phy_enable_cca = 0x4000302c ); +PROVIDE ( rom_phy_freq_correct = 0x40004b44 ); +PROVIDE ( rom_phyFuns = 0x3ffae0c0 ); +PROVIDE ( rom_phy_get_noisefloor = 0x40003c2c ); +PROVIDE ( rom_phy_get_vdd33 = 0x4000642c ); +PROVIDE ( rom_pow_usr = 0x40003044 ); +PROVIDE ( rom_read_sar_dout = 0x400051c0 ); +PROVIDE ( rom_restart_cal = 0x400046e0 ); +PROVIDE ( rom_rfcal_pwrctrl = 0x40006058 ); +PROVIDE ( rom_rfcal_rxiq = 0x40005b4c ); +PROVIDE ( rom_rfcal_txcap = 0x40005dec ); +PROVIDE ( rom_rfpll_reset = 0x40004680 ); +PROVIDE ( rom_rfpll_set_freq = 0x400047f8 ); +PROVIDE ( rom_rtc_mem_backup = 0x40003db4 ); +PROVIDE ( rom_rtc_mem_recovery = 0x40003df4 ); +PROVIDE ( rom_rx_gain_force = 0x4000351c ); +PROVIDE ( rom_rxiq_cover_mg_mp = 0x40005a68 ); +PROVIDE ( rom_rxiq_get_mis = 0x400058e4 ); +PROVIDE ( rom_rxiq_set_reg = 0x40005a00 ); +PROVIDE ( rom_set_cal_rxdc = 0x400030b8 ); +PROVIDE ( rom_set_chan_cal_interp = 0x40005ce0 ); +PROVIDE ( rom_set_channel_freq = 0x40004880 ); +PROVIDE ( rom_set_loopback_gain = 0x40003060 ); +PROVIDE ( rom_set_noise_floor = 0x40003d48 ); +PROVIDE ( rom_set_pbus_mem = 0x400031a4 ); +PROVIDE ( rom_set_rf_freq_offset = 0x40004ca8 ); +PROVIDE ( rom_set_rxclk_en = 0x40003594 ); +PROVIDE ( rom_set_txcap_reg = 0x40005d50 ); +PROVIDE ( rom_set_txclk_en = 0x40003564 ); +PROVIDE ( rom_spur_coef_cfg = 0x40003ac8 ); +PROVIDE ( rom_spur_reg_write_one_tone = 0x400037f0 ); +PROVIDE ( rom_start_tx_tone = 0x400036b4 ); +PROVIDE ( rom_start_tx_tone_step = 0x400035d0 ); +PROVIDE ( rom_stop_tx_tone = 0x40003f98 ); +PROVIDE ( _rom_store = 0x4000d66c ); +PROVIDE ( _rom_store_table = 0x4000d4f8 ); +PROVIDE ( rom_target_power_add_backoff = 0x40006268 ); +PROVIDE ( rom_tx_atten_set_interp = 0x400061cc ); +PROVIDE ( rom_txbbgain_to_index = 0x40004dc0 ); +PROVIDE ( rom_txcal_work_mode = 0x4000510c ); +PROVIDE ( rom_txdc_cal_init = 0x40004e10 ); +PROVIDE ( rom_txdc_cal_v70 = 0x40004ea4 ); +PROVIDE ( rom_txiq_cover = 0x4000538c ); +PROVIDE ( rom_txiq_get_mis_pwr = 0x400052dc ); +PROVIDE ( rom_txiq_set_reg = 0x40005154 ); +PROVIDE ( rom_tx_pwctrl_bg_init = 0x4000662c ); +PROVIDE ( rom_txtone_linear_pwr = 0x40005290 ); +PROVIDE ( rom_wait_rfpll_cal_end = 0x400047a8 ); +PROVIDE ( rom_write_gain_mem = 0x4000348c ); +PROVIDE ( rom_write_rfpll_sdm = 0x40004740 ); +PROVIDE ( roundup2 = 0x4000ab7c ); +PROVIDE ( r_plf_funcs_p = 0x3ffb8360 ); +PROVIDE ( r_rf_rw_bt_init = 0x40054868 ); +PROVIDE ( r_rf_rw_init = 0x40054b0c ); +PROVIDE ( r_rf_rw_le_init = 0x400549d0 ); +PROVIDE ( r_rwble_activity_ongoing_check = 0x40054d8c ); +PROVIDE ( r_rwble_init = 0x40054bf4 ); +PROVIDE ( r_rwble_isr = 0x40054e08 ); +PROVIDE ( r_rwble_reset = 0x40054ce8 ); +PROVIDE ( r_rwble_sleep_check = 0x40054d78 ); +PROVIDE ( r_rwble_version = 0x40054dac ); +PROVIDE ( r_rwbt_init = 0x40055160 ); +PROVIDE ( r_rwbt_isr = 0x40055248 ); +PROVIDE ( r_rwbt_reset = 0x400551bc ); +PROVIDE ( r_rwbt_sleep_check = 0x4005577c ); +PROVIDE ( r_rwbt_sleep_enter = 0x400557a4 ); +PROVIDE ( r_rwbt_sleep_wakeup = 0x400557fc ); +PROVIDE ( r_rwbt_sleep_wakeup_end = 0x400558cc ); +PROVIDE ( r_rwbt_version = 0x4005520c ); +PROVIDE ( r_rwip_assert_err = 0x40055f88 ); +PROVIDE ( r_rwip_check_wakeup_boundary = 0x400558fc ); +PROVIDE ( r_rwip_ext_wakeup_enable = 0x40055f3c ); +PROVIDE ( r_rwip_init = 0x4005595c ); +PROVIDE ( r_rwip_pca_clock_dragging_only = 0x40055f48 ); +PROVIDE ( r_rwip_prevent_sleep_clear = 0x40055ec8 ); +PROVIDE ( r_rwip_prevent_sleep_set = 0x40055e64 ); +PROVIDE ( r_rwip_reset = 0x40055ab8 ); +PROVIDE ( r_rwip_schedule = 0x40055b38 ); +PROVIDE ( r_rwip_sleep = 0x40055b5c ); +PROVIDE ( r_rwip_sleep_enable = 0x40055f30 ); +PROVIDE ( r_rwip_version = 0x40055b20 ); +PROVIDE ( r_rwip_wakeup = 0x40055dc4 ); +PROVIDE ( r_rwip_wakeup_delay_set = 0x40055e4c ); +PROVIDE ( r_rwip_wakeup_end = 0x40055e18 ); +PROVIDE ( r_rwip_wlcoex_set = 0x40055f60 ); +PROVIDE ( r_SHA_256 = 0x40013a90 ); +PROVIDE ( rtc_boot_control = 0x4000821c ); +PROVIDE ( rtc_get_reset_reason = 0x400081d4 ); +PROVIDE ( rtc_get_wakeup_cause = 0x400081f4 ); +PROVIDE ( rtc_select_apb_bridge = 0x40008288 ); +PROVIDE ( rwip_coex_cfg = 0x3ff9914c ); +PROVIDE ( rwip_priority = 0x3ff99159 ); +PROVIDE ( rwip_rf = 0x3ffbdb28 ); +PROVIDE ( rwip_rf_p_get = 0x400558f4 ); +PROVIDE ( r_XorKey = 0x400112c0 ); +PROVIDE ( sbrk = 0x400017f4 ); +PROVIDE ( _sbrk_r = 0x4000bce4 ); +PROVIDE ( scanf = 0x40058760 ); +PROVIDE ( _scanf_chars = 0x40058384 ); +PROVIDE ( _scanf_float = 0x4000bf18 ); +PROVIDE ( _scanf_i = 0x4005845c ); +PROVIDE ( _scanf_r = 0x4005879c ); +PROVIDE ( __sccl = 0x4000c498 ); +PROVIDE ( __sclose = 0x400011b8 ); +PROVIDE ( SelectSpiFunction = 0x40061f84 ); +PROVIDE ( SelectSpiQIO = 0x40061ddc ); +PROVIDE ( SendMsg = 0x40009384 ); +PROVIDE ( send_packet = 0x40009340 ); +PROVIDE ( __seofread = 0x40001148 ); +PROVIDE ( setjmp = 0x40056268 ); +PROVIDE ( setlocale = 0x40059568 ); +PROVIDE ( _setlocale_r = 0x4005950c ); +PROVIDE ( set_rtc_memory_crc = 0x40008208 ); +PROVIDE ( SetSpiDrvs = 0x40061e78 ); +PROVIDE ( __sf_fake_stderr = 0x3ff96458 ); +PROVIDE ( __sf_fake_stdin = 0x3ff96498 ); +PROVIDE ( __sf_fake_stdout = 0x3ff96478 ); +PROVIDE ( __sflush_r = 0x400591e0 ); +PROVIDE ( __sfmoreglue = 0x40001dc8 ); +PROVIDE ( __sfp = 0x40001e90 ); +PROVIDE ( __sfp_lock_acquire = 0x40001e08 ); +PROVIDE ( __sfp_lock_release = 0x40001e14 ); +PROVIDE ( __sfputs_r = 0x40057790 ); +PROVIDE ( __sfvwrite_r = 0x4005893c ); +PROVIDE ( sha1_prf = 0x40060ae8 ); +PROVIDE ( sha1_vector = 0x40060b64 ); +PROVIDE ( sha256_prf = 0x40060d70 ); +PROVIDE ( sha256_vector = 0x40060e08 ); +PROVIDE ( sha_blk_bits = 0x3ff99290 ); +PROVIDE ( sha_blk_bits_bytes = 0x3ff99288 ); +PROVIDE ( sha_blk_hash_bytes = 0x3ff9928c ); +PROVIDE ( sig_matrix = 0x3ffae293 ); +PROVIDE ( __sinit = 0x40001e38 ); +PROVIDE ( __sinit_lock_acquire = 0x40001e20 ); +PROVIDE ( __sinit_lock_release = 0x40001e2c ); +PROVIDE ( sip_after_tx_complete = 0x4000b358 ); +PROVIDE ( sip_alloc_to_host_evt = 0x4000ab9c ); +PROVIDE ( sip_get_ptr = 0x4000b34c ); +PROVIDE ( sip_get_state = 0x4000ae2c ); +PROVIDE ( sip_init_attach = 0x4000ae58 ); +PROVIDE ( sip_install_rx_ctrl_cb = 0x4000ae10 ); +PROVIDE ( sip_install_rx_data_cb = 0x4000ae20 ); +PROVIDE ( sip_is_active = 0x4000b3c0 ); +PROVIDE ( sip_post_init = 0x4000aed8 ); +PROVIDE ( sip_reclaim_from_host_cmd = 0x4000adbc ); +PROVIDE ( sip_reclaim_tx_data_pkt = 0x4000ad5c ); +PROVIDE ( siprintf = 0x40056c08 ); +PROVIDE ( _siprintf_r = 0x40056bbc ); +PROVIDE ( sip_send = 0x4000af54 ); +PROVIDE ( sip_to_host_chain_append = 0x4000aef8 ); +PROVIDE ( sip_to_host_evt_send_done = 0x4000ac04 ); +PROVIDE ( siscanf = 0x400587d0 ); +PROVIDE ( _siscanf_r = 0x40058830 ); +PROVIDE ( slc_add_credits = 0x4000baf4 ); +PROVIDE ( slc_enable = 0x4000b64c ); +PROVIDE ( slc_from_host_chain_fetch = 0x4000b7e8 ); +PROVIDE ( slc_from_host_chain_recycle = 0x4000bb10 ); +PROVIDE ( slc_has_pkt_to_host = 0x4000b5fc ); +PROVIDE ( slc_init_attach = 0x4000b918 ); +PROVIDE ( slc_init_credit = 0x4000badc ); +PROVIDE ( slc_reattach = 0x4000b62c ); +PROVIDE ( slc_send_to_host_chain = 0x4000b6a0 ); +PROVIDE ( slc_set_host_io_max_window = 0x4000b89c ); +PROVIDE ( slc_to_host_chain_recycle = 0x4000b758 ); +PROVIDE ( __smakebuf_r = 0x40059108 ); +PROVIDE ( sniprintf = 0x40056b4c ); +PROVIDE ( _sniprintf_r = 0x40056ae4 ); +PROVIDE ( snprintf = 0x40056b4c ); +PROVIDE ( _snprintf_r = 0x40056ae4 ); +PROVIDE ( software_reset = 0x4000824c ); +PROVIDE ( software_reset_cpu = 0x40008264 ); +PROVIDE ( specialModP256 = 0x4001600c ); +PROVIDE ( spi_cache_sram_init = 0x400626e4 ); +PROVIDE ( SPIClkConfig = 0x40062bc8 ); +PROVIDE ( SPI_Common_Command = 0x4006246c ); +PROVIDE ( spi_dummy_len_fix = 0x40061d90 ); +PROVIDE ( SPI_Encrypt_Write = 0x40062e78 ); +PROVIDE ( SPIEraseArea = 0x400631ac ); +PROVIDE ( SPIEraseBlock = 0x40062c4c ); +PROVIDE ( SPIEraseChip = 0x40062c14 ); +PROVIDE ( SPIEraseSector = 0x40062ccc ); +PROVIDE ( spi_flash_attach = 0x40062a6c ); +PROVIDE ( SPILock = 0x400628f0 ); +PROVIDE ( SPIMasterReadModeCnfig = 0x40062b64 ); +PROVIDE ( spi_modes = 0x3ff99270 ); +PROVIDE ( SPIParamCfg = 0x40063238 ); +PROVIDE ( SPI_Prepare_Encrypt_Data = 0x40062e1c ); +PROVIDE ( SPIRead = 0x40062ed8 ); +PROVIDE ( SPIReadModeCnfig = 0x40062944 ); +PROVIDE ( SPIUnlock = 0x400628b0 ); +PROVIDE ( SPI_user_command_read = 0x400621b0 ); +PROVIDE ( spi_w25q16 = 0x3ffae270 ); +PROVIDE ( SPIWrite = 0x40062d50 ); +PROVIDE ( SPI_Write_Encrypt_Disable = 0x40062e60 ); +PROVIDE ( SPI_Write_Encrypt_Enable = 0x40062df4 ); +PROVIDE ( sprintf = 0x40056c08 ); +PROVIDE ( _sprintf_r = 0x40056bbc ); +PROVIDE ( __sprint_r = 0x400577e4 ); +PROVIDE ( srand = 0x40001004 ); +PROVIDE ( __sread = 0x40001118 ); +PROVIDE ( __srefill_r = 0x400593d4 ); +PROVIDE ( sscanf = 0x400587d0 ); +PROVIDE ( _sscanf_r = 0x40058830 ); +PROVIDE ( __sseek = 0x40001184 ); +PROVIDE ( __ssprint_r = 0x40056ff8 ); +PROVIDE ( __ssputs_r = 0x40056f2c ); +PROVIDE ( __ssrefill_r = 0x40057fec ); +PROVIDE ( __ssvfiscanf_r = 0x4005802c ); +PROVIDE ( __ssvfscanf_r = 0x4005802c ); +PROVIDE ( __stack = 0x3ffe3f20 ); +PROVIDE ( __stack_app = 0x3ffe7e30 ); +PROVIDE ( _stack_sentry = 0x3ffe1320 ); +PROVIDE ( _stack_sentry_app = 0x3ffe5230 ); +PROVIDE ( _start = 0x40000704 ); +PROVIDE ( start_tb_console = 0x4005a980 ); +PROVIDE ( _stat_r = 0x4000bcb4 ); +PROVIDE ( _stext = 0x40000560 ); +PROVIDE ( strcasecmp = 0x400011cc ); +PROVIDE ( strcasestr = 0x40001210 ); +PROVIDE ( strcat = 0x4000c518 ); +PROVIDE ( strchr = 0x4000c53c ); +PROVIDE ( strcmp = 0x40001274 ); +PROVIDE ( strcoll = 0x40001398 ); +PROVIDE ( strcpy = 0x400013ac ); +PROVIDE ( strcspn = 0x4000c558 ); +PROVIDE ( strdup = 0x4000143c ); +PROVIDE ( _strdup_r = 0x40001450 ); +PROVIDE ( strftime = 0x40059ab4 ); +PROVIDE ( strlcat = 0x40001470 ); +PROVIDE ( strlcpy = 0x4000c584 ); +PROVIDE ( strlen = 0x400014c0 ); +PROVIDE ( strlwr = 0x40001524 ); +PROVIDE ( strncasecmp = 0x40001550 ); +PROVIDE ( strncat = 0x4000c5c4 ); +PROVIDE ( strncmp = 0x4000c5f4 ); +PROVIDE ( strncpy = 0x400015d4 ); +PROVIDE ( strndup = 0x400016b0 ); +PROVIDE ( _strndup_r = 0x400016c4 ); +PROVIDE ( strnlen = 0x4000c628 ); +PROVIDE ( strrchr = 0x40001708 ); +PROVIDE ( strsep = 0x40001734 ); +PROVIDE ( strspn = 0x4000c648 ); +PROVIDE ( strstr = 0x4000c674 ); +PROVIDE ( __strtok_r = 0x4000c6a8 ); +PROVIDE ( strtok_r = 0x4000c70c ); +PROVIDE ( strtol = 0x4005681c ); +PROVIDE ( _strtol_r = 0x40056714 ); +PROVIDE ( strtoul = 0x4005692c ); +PROVIDE ( _strtoul_r = 0x40056834 ); +PROVIDE ( strupr = 0x4000174c ); +PROVIDE ( __subdf3 = 0x400026e4 ); +PROVIDE ( __submore = 0x40058f3c ); +PROVIDE ( __subsf3 = 0x400021d0 ); +PROVIDE ( SubtractBigHex256 = 0x40015bcc ); +PROVIDE ( SubtractBigHexMod256 = 0x40015e8c ); +PROVIDE ( SubtractBigHexUint32_256 = 0x40015f8c ); +PROVIDE ( SubtractFromSelfBigHex256 = 0x40015c20 ); +PROVIDE ( SubtractFromSelfBigHexSign256 = 0x40015dc8 ); +PROVIDE ( __subvdi3 = 0x40002d20 ); +PROVIDE ( __subvsi3 = 0x40002cf8 ); +PROVIDE ( _sungetc_r = 0x40057f6c ); +PROVIDE ( _svfiprintf_r = 0x40057100 ); +PROVIDE ( __svfiscanf_r = 0x40057b08 ); +PROVIDE ( _svfprintf_r = 0x40057100 ); +PROVIDE ( __svfscanf = 0x40057f04 ); +PROVIDE ( __svfscanf_r = 0x40057b08 ); +PROVIDE ( __swbuf = 0x40058cb4 ); +PROVIDE ( __swbuf_r = 0x40058bec ); +PROVIDE ( __swrite = 0x40001150 ); +PROVIDE ( __swsetup_r = 0x40058cc8 ); +PROVIDE ( sw_to_hw = 0x3ffb8d40 ); +PROVIDE ( _SyscallException = 0x400007cf ); +PROVIDE ( syscall_table_ptr_app = 0x3ffae020 ); +PROVIDE ( syscall_table_ptr_pro = 0x3ffae024 ); +PROVIDE ( _system_r = 0x4000bc10 ); +PROVIDE ( tdefl_compress = 0x400600bc ); +PROVIDE ( tdefl_compress_buffer = 0x400607f4 ); +PROVIDE ( tdefl_compress_mem_to_mem = 0x40060900 ); +PROVIDE ( tdefl_compress_mem_to_output = 0x400608e0 ); +PROVIDE ( tdefl_get_adler32 = 0x400608d8 ); +PROVIDE ( tdefl_get_prev_return_status = 0x400608d0 ); +PROVIDE ( tdefl_init = 0x40060810 ); +PROVIDE ( tdefl_write_image_to_png_file_in_memory = 0x4006091c ); +PROVIDE ( tdefl_write_image_to_png_file_in_memory_ex = 0x40060910 ); +PROVIDE ( time = 0x40001844 ); +PROVIDE ( __time_load_locale = 0x4000183c ); +PROVIDE ( times = 0x40001808 ); +PROVIDE ( _times_r = 0x4000bc40 ); +PROVIDE ( _timezone = 0x3ffae0a0 ); +PROVIDE ( tinfl_decompress = 0x4005ef30 ); +PROVIDE ( tinfl_decompress_mem_to_callback = 0x40060090 ); +PROVIDE ( tinfl_decompress_mem_to_mem = 0x40060050 ); +PROVIDE ( toascii = 0x4000c720 ); +PROVIDE ( tolower = 0x40001868 ); +PROVIDE ( toupper = 0x40001884 ); +PROVIDE ( __truncdfsf2 = 0x40002b90 ); +PROVIDE ( __tzcalc_limits = 0x400018a0 ); +PROVIDE ( __tz_lock = 0x40001a04 ); +PROVIDE ( _tzname = 0x3ffae030 ); +PROVIDE ( tzset = 0x40001a1c ); +PROVIDE ( _tzset_r = 0x40001a28 ); +PROVIDE ( __tz_unlock = 0x40001a10 ); +PROVIDE ( uartAttach = 0x40008fd0 ); +PROVIDE ( uart_baudrate_detect = 0x40009034 ); +PROVIDE ( uart_buff_switch = 0x400093c0 ); +PROVIDE ( UartConnCheck = 0x40008738 ); +PROVIDE ( UartConnectProc = 0x40008a04 ); +PROVIDE ( UartDev = 0x3ffe019c ); +PROVIDE ( uart_div_modify = 0x400090cc ); +PROVIDE ( UartDwnLdProc = 0x40008ce8 ); +PROVIDE ( UartGetCmdLn = 0x40009564 ); +PROVIDE ( Uart_Init = 0x40009120 ); +PROVIDE ( UartRegReadProc = 0x40008a58 ); +PROVIDE ( UartRegWriteProc = 0x40008a14 ); +PROVIDE ( uart_rx_intr_handler = 0x40008f4c ); +PROVIDE ( uart_rx_one_char = 0x400092d0 ); +PROVIDE ( uart_rx_one_char_block = 0x400092a4 ); +PROVIDE ( uart_rx_readbuff = 0x40009394 ); +PROVIDE ( UartRxString = 0x400092fc ); +PROVIDE ( UartSetBaudProc = 0x40008aac ); +PROVIDE ( UartSpiAttachProc = 0x40008a6c ); +PROVIDE ( UartSpiReadProc = 0x40008a80 ); +PROVIDE ( uart_tx_flush = 0x40009258 ); +PROVIDE ( uart_tx_one_char = 0x40009200 ); +PROVIDE ( uart_tx_one_char2 = 0x4000922c ); +PROVIDE ( uart_tx_switch = 0x40009028 ); +PROVIDE ( uart_tx_wait_idle = 0x40009278 ); +PROVIDE ( __ucmpdi2 = 0x40063840 ); +PROVIDE ( __udivdi3 = 0x4000cff8 ); +PROVIDE ( __udivmoddi4 = 0x40064ab0 ); +PROVIDE ( __udivsi3 = 0x4000c7c8 ); +PROVIDE ( __udiv_w_sdiv = 0x40064aa8 ); +PROVIDE ( __umoddi3 = 0x4000d280 ); +PROVIDE ( __umodsi3 = 0x4000c7d0 ); +PROVIDE ( __umulsidi3 = 0x4000c7d8 ); +PROVIDE ( ungetc = 0x400590f4 ); +PROVIDE ( _ungetc_r = 0x40058fa0 ); +PROVIDE ( _unlink_r = 0x4000bc84 ); +PROVIDE ( __unorddf2 = 0x400637f4 ); +PROVIDE ( __unordsf2 = 0x40063478 ); +PROVIDE ( user_code_start = 0x3ffe0400 ); +PROVIDE ( _UserExceptionVector = 0x40000340 ); +PROVIDE ( utoa = 0x40056258 ); +PROVIDE ( __utoa = 0x400561f0 ); +PROVIDE ( vasiprintf = 0x40056eb8 ); +PROVIDE ( _vasiprintf_r = 0x40056e80 ); +PROVIDE ( vasniprintf = 0x40056e58 ); +PROVIDE ( _vasniprintf_r = 0x40056df8 ); +PROVIDE ( vasnprintf = 0x40056e58 ); +PROVIDE ( _vasnprintf_r = 0x40056df8 ); +PROVIDE ( vasprintf = 0x40056eb8 ); +PROVIDE ( _vasprintf_r = 0x40056e80 ); +PROVIDE ( VerifyFlashMd5Proc = 0x40008c44 ); +PROVIDE ( veryBigHexP256 = 0x3ff9736c ); +PROVIDE ( vfiprintf = 0x40057ae8 ); +PROVIDE ( _vfiprintf_r = 0x40057850 ); +PROVIDE ( vfiscanf = 0x40057eb8 ); +PROVIDE ( _vfiscanf_r = 0x40057f24 ); +PROVIDE ( vfprintf = 0x40057ae8 ); +PROVIDE ( _vfprintf_r = 0x40057850 ); +PROVIDE ( vfscanf = 0x40057eb8 ); +PROVIDE ( _vfscanf_r = 0x40057f24 ); +PROVIDE ( viprintf = 0x400569b4 ); +PROVIDE ( _viprintf_r = 0x400569e4 ); +PROVIDE ( viscanf = 0x40058698 ); +PROVIDE ( _viscanf_r = 0x400586c8 ); +PROVIDE ( vprintf = 0x400569b4 ); +PROVIDE ( _vprintf_r = 0x400569e4 ); +PROVIDE ( vscanf = 0x40058698 ); +PROVIDE ( _vscanf_r = 0x400586c8 ); +PROVIDE ( vsiprintf = 0x40056ac4 ); +PROVIDE ( _vsiprintf_r = 0x40056a90 ); +PROVIDE ( vsiscanf = 0x40058740 ); +PROVIDE ( _vsiscanf_r = 0x400586f8 ); +PROVIDE ( vsniprintf = 0x40056a68 ); +PROVIDE ( _vsniprintf_r = 0x40056a14 ); +PROVIDE ( vsnprintf = 0x40056a68 ); +PROVIDE ( _vsnprintf_r = 0x40056a14 ); +PROVIDE ( vsprintf = 0x40056ac4 ); +PROVIDE ( _vsprintf_r = 0x40056a90 ); +PROVIDE ( vsscanf = 0x40058740 ); +PROVIDE ( _vsscanf_r = 0x400586f8 ); +PROVIDE ( wcrtomb = 0x40058920 ); +PROVIDE ( _wcrtomb_r = 0x400588d8 ); +PROVIDE ( __wctomb = 0x3ff96540 ); +PROVIDE ( _wctomb_r = 0x40058f14 ); +PROVIDE ( _WindowOverflow12 = 0x40000100 ); +PROVIDE ( _WindowOverflow4 = 0x40000000 ); +PROVIDE ( _WindowOverflow8 = 0x40000080 ); +PROVIDE ( _WindowUnderflow12 = 0x40000140 ); +PROVIDE ( _WindowUnderflow4 = 0x40000040 ); +PROVIDE ( _WindowUnderflow8 = 0x400000c0 ); +PROVIDE ( write = 0x4000181c ); +PROVIDE ( _write_r = 0x4000bd70 ); +PROVIDE ( xthal_bcopy = 0x4000c098 ); +PROVIDE ( xthal_copy123 = 0x4000c124 ); +PROVIDE ( xthal_get_ccompare = 0x4000c078 ); +PROVIDE ( xthal_get_ccount = 0x4000c050 ); +PROVIDE ( xthal_get_interrupt = 0x4000c1e4 ); +PROVIDE ( xthal_get_intread = 0x4000c1e4 ); +PROVIDE ( Xthal_intlevel = 0x3ff9c2b4 ); +PROVIDE ( xthal_memcpy = 0x4000c0bc ); +PROVIDE ( xthal_set_ccompare = 0x4000c058 ); +PROVIDE ( xthal_set_intclear = 0x4000c1ec ); +PROVIDE ( _xtos_alloca_handler = 0x40000010 ); +PROVIDE ( _xtos_cause3_handler = 0x40000dd8 ); +PROVIDE ( _xtos_c_handler_table = 0x3ffe0548 ); +PROVIDE ( _xtos_c_wrapper_handler = 0x40000de8 ); +PROVIDE ( _xtos_enabled = 0x3ffe0650 ); +PROVIDE ( _xtos_exc_handler_table = 0x3ffe0448 ); +PROVIDE ( _xtos_interrupt_mask_table = 0x3ffe0758 ); +PROVIDE ( _xtos_interrupt_table = 0x3ffe0658 ); +PROVIDE ( _xtos_ints_off = 0x4000bfac ); +PROVIDE ( _xtos_ints_on = 0x4000bf88 ); +PROVIDE ( _xtos_intstruct = 0x3ffe0650 ); +PROVIDE ( _xtos_l1int_handler = 0x40000814 ); +PROVIDE ( _xtos_p_none = 0x4000bfd4 ); +PROVIDE ( _xtos_restore_intlevel = 0x40000928 ); +PROVIDE ( _xtos_return_from_exc = 0x4000c034 ); +PROVIDE ( _xtos_set_exception_handler = 0x4000074c ); +PROVIDE ( _xtos_set_interrupt_handler = 0x4000bf78 ); +PROVIDE ( _xtos_set_interrupt_handler_arg = 0x4000bf34 ); +PROVIDE ( _xtos_set_intlevel = 0x4000bfdc ); +PROVIDE ( _xtos_set_min_intlevel = 0x4000bff8 ); +PROVIDE ( _xtos_set_vpri = 0x40000934 ); +PROVIDE ( _xtos_syscall_handler = 0x40000790 ); +PROVIDE ( _xtos_unhandled_exception = 0x4000c024 ); +PROVIDE ( _xtos_unhandled_interrupt = 0x4000c01c ); +PROVIDE ( _xtos_vpri_enabled = 0x3ffe0654 ); + +PROVIDE ( I2S0 = 0x6000F000 ); \ No newline at end of file diff --git a/components/esp32/ld/eagle.fpga32.v7.ld b/components/esp32/ld/eagle.fpga32.v7.ld new file mode 100644 index 000000000..6824486a8 --- /dev/null +++ b/components/esp32/ld/eagle.fpga32.v7.ld @@ -0,0 +1,170 @@ +/* THESE ARE THE VIRTUAL RUNTIME ADDRESSES */ +/* The load addresses are defined later using the AT statements. */ +MEMORY +{ + /* All these values assume the flash cache is on, and have the blocks this uses subtracted from the length + of the various regions. The 'data access port' dram/drom regions map to the same iram/irom regions but + are connected to the data port of the CPU and eg allow bytewise access. */ + iram0_0_seg (RX) : org = 0x40080000, len = 0x18000 /* IRAM for PRO cpu. Not sure if happy with this, this is MMU area... */ + iram0_2_seg (RX) : org = 0x400D0018, len = 0x330000 /* Even though the segment name is iram, it is actually mapped to flash */ + dram0_0_seg (RW) : org = 0x3FFC0000, len = 0x20000 /* Shared RAM, minus rom bss/data/stack.*/ + drom0_0_seg (R) : org = 0x3F400010, len = 0x800000 +} + +_heap_end = 0x3fffe000; + +/* Default entry point: */ +ENTRY(call_user_start_cpu0); + +SECTIONS +{ + /* Send .iram0 code to iram */ + .iram0.vectors : + { + /* Vectors go to IRAM */ + _init_start = ABSOLUTE(.); + /* Vectors according to builds/RF-2015.2-win32/esp108_v1_2_s5_512int_2/config.html */ + . = 0x0; + KEEP(*(.WindowVectors.text)); + . = 0x180; + KEEP(*(.Level2InterruptVector.text)); + . = 0x1c0; + KEEP(*(.Level3InterruptVector.text)); + . = 0x200; + KEEP(*(.Level4InterruptVector.text)); + . = 0x240; + KEEP(*(.Level5InterruptVector.text)); + . = 0x280; + KEEP(*(.DebugExceptionVector.text)); + . = 0x2c0; + KEEP(*(.NMIExceptionVector.text)); + . = 0x300; + KEEP(*(.KernelExceptionVector.text)); + . = 0x340; + KEEP(*(.UserExceptionVector.text)); + . = 0x3C0; + KEEP(*(.DoubleExceptionVector.text)); + . = 0x400; + *(.*Vector.literal) + + *(.UserEnter.literal); + *(.UserEnter.text); + . = ALIGN (16); + *(.entry.text) + *(.init.literal) + *(.init) + _init_end = ABSOLUTE(.); + } > iram0_0_seg + + .iram0.text : + { + /* Code marked as runnning out of IRAM */ + _iram_text_start = ABSOLUTE(.); + *(.iram1 .iram1.*) + *libfreertos.a:(.literal .text .literal.* .text.*) + *libphy.a:(.literal .text .literal.* .text.*) + *librtc.a:(.literal .text .literal.* .text.*) + *libpp.a:(.literal .text .literal.* .text.*) + *libhal.a:(.literal .text .literal.* .text.*) + _iram_text_end = ABSOLUTE(.); + } > iram0_0_seg + + /* Shared RAM */ + .dram0.bss (NOLOAD) : + { + . = ALIGN (8); + _bss_start = ABSOLUTE(.); + *(.dynsbss) + *(.sbss) + *(.sbss.*) + *(.gnu.linkonce.sb.*) + *(.scommon) + *(.sbss2) + *(.sbss2.*) + *(.gnu.linkonce.sb2.*) + *(.dynbss) + KEEP(*(.bss)) + *(.bss.*) + *(.share.mem) + *(.gnu.linkonce.b.*) + *(COMMON) + . = ALIGN (8); + _bss_end = ABSOLUTE(.); + } >dram0_0_seg + + .dram0.data : + { + _data_start = ABSOLUTE(.); + KEEP(*(.data)) + KEEP(*(.data.*)) + KEEP(*(.gnu.linkonce.d.*)) + KEEP(*(.data1)) + KEEP(*(.sdata)) + KEEP(*(.sdata.*)) + KEEP(*(.gnu.linkonce.s.*)) + KEEP(*(.sdata2)) + KEEP(*(.sdata2.*)) + KEEP(*(.gnu.linkonce.s2.*)) + KEEP(*(.jcr)) + _data_end = ABSOLUTE(.); + . = ALIGN(4); + _heap_start = ABSOLUTE(.); + } >dram0_0_seg + + .flash.rodata : + { + _rodata_start = ABSOLUTE(.); + *(.rodata) + *(.rodata.*) + *(.irom1.text) /* catch stray ICACHE_RODATA_ATTR */ + *(.gnu.linkonce.r.*) + *(.rodata1) + __XT_EXCEPTION_TABLE_ = ABSOLUTE(.); + *(.xt_except_table) + *(.gcc_except_table) + *(.gnu.linkonce.e.*) + *(.gnu.version_r) + *(.eh_frame) + . = (. + 3) & ~ 3; + /* C++ constructor and destructor tables, properly ordered: */ + __init_array_start = ABSOLUTE(.); + KEEP (*crtbegin.o(.ctors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .ctors)) + KEEP (*(SORT(.ctors.*))) + KEEP (*(.ctors)) + __init_array_end = ABSOLUTE(.); + KEEP (*crtbegin.o(.dtors)) + KEEP (*(EXCLUDE_FILE (*crtend.o) .dtors)) + KEEP (*(SORT(.dtors.*))) + KEEP (*(.dtors)) + /* C++ exception handlers table: */ + __XT_EXCEPTION_DESCS_ = ABSOLUTE(.); + *(.xt_except_desc) + *(.gnu.linkonce.h.*) + __XT_EXCEPTION_DESCS_END__ = ABSOLUTE(.); + *(.xt_except_desc_end) + *(.dynamic) + *(.gnu.version_d) + _rodata_end = ABSOLUTE(.); + /* Literals are also RO data. */ + _lit4_start = ABSOLUTE(.); + *(*.lit4) + *(.lit4.*) + *(.gnu.linkonce.lit4.*) + _lit4_end = ABSOLUTE(.); + . = ALIGN(4); + } >drom0_0_seg + + .flash.text : + { + _stext = .; + _text_start = ABSOLUTE(.); + *(.literal .text .literal.* .text.* .stub .gnu.warning .gnu.linkonce.literal.* .gnu.linkonce.t.*.literal .gnu.linkonce.t.*) + *(.irom0.text) /* catch stray ICACHE_RODATA_ATTR */ + *(.fini.literal) + *(.fini) + *(.gnu.version) + _text_end = ABSOLUTE(.); + _etext = .; + } >iram0_2_seg +} diff --git a/components/esp32/ld/elf_to_ld.sh b/components/esp32/ld/elf_to_ld.sh new file mode 100755 index 000000000..138f24d60 --- /dev/null +++ b/components/esp32/ld/elf_to_ld.sh @@ -0,0 +1,12 @@ +#!/bin/bash + +echo '/*' +echo 'ESP32 ROM address table' +echo 'Generated for ROM with MD5sum:' +md5sum $1 +echo '*/' +xtensa-esp108-elf-nm $1 | grep '[0-9a-f] [TBRD]' | while read adr ttp nm; do + if ! echo "$nm" | grep -q -e '^_bss' -e '_heap'; then + echo "PROVIDE ( $nm = 0x$adr );"; + fi +done \ No newline at end of file diff --git a/components/esp32/lib b/components/esp32/lib new file mode 160000 index 000000000..40dc7af7f --- /dev/null +++ b/components/esp32/lib @@ -0,0 +1 @@ +Subproject commit 40dc7af7f3d8da6745476e66cbd65be9b8988f6c diff --git a/components/esp32/libhal.a b/components/esp32/libhal.a new file mode 100644 index 0000000000000000000000000000000000000000..382f4e0ab2336d96e9216a63c885fda7cd3d45c1 GIT binary patch literal 462242 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 TBi}54m1G@jmEj!9^7sD%BG5g= literal 0 HcmV?d00001 diff --git a/components/esp32/spiram.h b/components/esp32/spiram.h new file mode 100644 index 000000000..ebdbcaaee --- /dev/null +++ b/components/esp32/spiram.h @@ -0,0 +1,19 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef SPI_RAM_H +#define SPI_RAM_H + +void enable_spi_sram(); + +#endif \ No newline at end of file diff --git a/components/esp32/syscalls.c b/components/esp32/syscalls.c new file mode 100644 index 000000000..5fb7c94d0 --- /dev/null +++ b/components/esp32/syscalls.c @@ -0,0 +1,256 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include +#include +#include +#include +#include +#include +#include +#include "rom/libc_stubs.h" +#include "freertos/FreeRTOS.h" +#include "freertos/portmacro.h" +#include "freertos/task.h" + +int uart_tx_one_char(uint8_t c); + +void abort() { + do + { + __asm__ ("break 0,0"); + *((int*) 0) = 0; + } while(true); +} + +void* _malloc_r(struct _reent *r, size_t size) { + return pvPortMalloc(size); +} + +void _free_r(struct _reent *r, void* ptr) { + return vPortFree(ptr); +} + +// TODO: improve realloc to grow buffer in place if possible +void* _realloc_r(struct _reent *r, void* ptr, size_t size) { + void* new_chunk = pvPortMalloc(size); + if (new_chunk) { + memcpy(new_chunk, ptr, size); + vPortFree(ptr); + } + // realloc behaviour: don't free original chunk if alloc failed + return new_chunk; +} + +void* _calloc_r(struct _reent *r, size_t count, size_t size) { + void* result = pvPortMalloc(count * size); + if (result) + { + memset(result, 0, count * size); + } + return result; +} + +int _system_r(struct _reent *r, const char *str) { + abort(); + return 0; +} + +int _rename_r(struct _reent *r, const char *src, const char *dst) { + abort(); + return 0; +} + +clock_t _times_r(struct _reent *r, struct tms *ptms) { + abort(); + return 0; +} + +// TODO: read time from RTC +int _gettimeofday_r(struct _reent *r, struct timeval *tv, void *tz) { + abort(); + return 0; +} + +void _raise_r(struct _reent *r) { + abort(); +} + +int _unlink_r(struct _reent *r, const char *path) { + abort(); + return 0; +} + +int _link_r(struct _reent *r, const char* n1, const char* n2) { + abort(); + return 0; +} + +int _stat_r(struct _reent *r, const char * path, struct stat * st) { + return 0; +} + +int _fstat_r(struct _reent *r, int fd, struct stat * st) { + st->st_mode = S_IFCHR; + return 0; +} + +void* _sbrk_r(struct _reent *r, ptrdiff_t sz) { + abort(); + return 0; +} + +int _getpid_r(struct _reent *r) { + abort(); + return 0; +} + +int _kill_r(struct _reent *r, int pid, int sig) { + abort(); + return 0; +} + +void _exit_r(struct _reent *r, int e) { + abort(); +} + +int _close_r(struct _reent *r, int fd) { + return 0; +} + +int _open_r(struct _reent *r, const char * path, int flags, int mode) { + return 0; +} + +ssize_t _write_r(struct _reent *r, int fd, const void * data, size_t size) { + const char* p = (const char*) data; + if (fd == STDOUT_FILENO) { + while(size--) { + uart_tx_one_char(*p); + ++p; + } + } + return size; +} + +_off_t _lseek_r(struct _reent *r, int fd, _off_t size, int mode) { + return 0; +} + +// TODO: implement reading from UART +ssize_t _read_r(struct _reent *r, int fd, void * dst, size_t size) { + return 0; +} + +// TODO: implement locks via FreeRTOS mutexes +void _lock_init(_lock_t *lock) { +} + +void _lock_init_recursive(_lock_t *lock) { +} + +void _lock_close(_lock_t *lock) { +} + +void _lock_close_recursive(_lock_t *lock) { +} + +void _lock_acquire(_lock_t *lock) { +} + +void _lock_acquire_recursive(_lock_t *lock) { +} + +int _lock_try_acquire(_lock_t *lock) { + return 0; +} + +int _lock_try_acquire_recursive(_lock_t *lock) { + return 0; +} + +void _lock_release(_lock_t *lock) { +} + +void _lock_release_recursive(_lock_t *lock) { +} + +static struct _reent s_reent; + +/* + General ToDo that the Xtensa newlib support code did but we do not: Close every open fd a running task had when the task + is killed. Do we want that too? - JD +*/ + +extern int _printf_float(struct _reent *rptr, + void *pdata, + FILE * fp, + int (*pfunc) (struct _reent *, FILE *, _CONST char *, size_t len), + va_list * ap); + + +extern int _scanf_float(struct _reent *rptr, + void *pdata, + FILE *fp, + va_list *ap); + + +static struct syscall_stub_table s_stub_table = { + .__getreent = &__getreent, + ._malloc_r = &_malloc_r, + ._free_r = &_free_r, + ._realloc_r = &_realloc_r, + ._calloc_r = &_calloc_r, + ._abort = &abort, + ._system_r = &_system_r, + ._rename_r = &_rename_r, + ._times_r = &_times_r, + ._gettimeofday_r = &_gettimeofday_r, + ._raise_r = &_raise_r, + ._unlink_r = &_unlink_r, + ._link_r = &_link_r, + ._stat_r = &_stat_r, + ._fstat_r = &_fstat_r, + ._sbrk_r = &_sbrk_r, + ._getpid_r = &_getpid_r, + ._kill_r = &_kill_r, + ._exit_r = &_exit_r, + ._close_r = &_close_r, + ._open_r = &_open_r, + ._write_r = (int (*)(struct _reent *r, int, const void *, int)) &_write_r, + ._lseek_r = (int (*)(struct _reent *r, int, int, int)) &_lseek_r, + ._read_r = (int (*)(struct _reent *r, int, void *, int)) &_read_r, + ._lock_init = &_lock_init, + ._lock_init_recursive = &_lock_init_recursive, + ._lock_close = &_lock_close, + ._lock_close_recursive = &_lock_close_recursive, + ._lock_acquire = &_lock_acquire, + ._lock_acquire_recursive = &_lock_acquire_recursive, + ._lock_try_acquire = &_lock_try_acquire, + ._lock_try_acquire_recursive = &_lock_try_acquire_recursive, + ._lock_release = &_lock_release, + ._lock_release_recursive = &_lock_release_recursive, + ._printf_float = &_printf_float, + ._scanf_float = &_scanf_float, +}; + +void ets_setup_syscalls() { + syscall_table_ptr_pro = &s_stub_table; + syscall_table_ptr_app = &s_stub_table; + _GLOBAL_REENT = &s_reent; + environ = malloc(sizeof(char*)); + environ[0] = NULL; +} + + diff --git a/components/esp32/wifi.c b/components/esp32/wifi.c new file mode 100644 index 000000000..38fd733dc --- /dev/null +++ b/components/esp32/wifi.c @@ -0,0 +1,109 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include + +#include "esp_err.h" +#include "esp_wifi.h" +#include "esp_event.h" + +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "freertos/queue.h" +#include "freertos/semphr.h" + +//#include "tcpip_adapter.h" + +#define ESP32_WORKAROUND 1 + +#if CONFIG_WIFI_ENABLED + +#ifdef ESP32_WORKAROUND + +SemaphoreHandle_t stdio_mutex_tx = NULL; +#define os_printf(fmt, ...) do {\ + if (!stdio_mutex_tx) {\ + stdio_mutex_tx = xSemaphoreCreateMutex();\ + }\ +\ + xSemaphoreTake(stdio_mutex_tx, portMAX_DELAY);\ + ets_printf(fmt, ##__VA_ARGS__);\ + xSemaphoreGive(stdio_mutex_tx);\ +} while (0) + +#endif + +static wifi_startup_cb_t startup_cb; + +#define WIFI_DEBUG os_printf +#define WIFI_API_CALL_CHECK(info, api_call, ret) \ +do{\ + esp_err_t __err = (api_call);\ + if ((ret) != __err) {\ + WIFI_DEBUG("%s %d %s ret=%d\n", __FUNCTION__, __LINE__, (info), __err);\ + return __err;\ + }\ +} while(0) + +static void esp_wifi_task(void *pvParameters) +{ + esp_err_t err; + wifi_init_config_t cfg; + cfg.event_q = (xQueueHandle)esp_event_get_handler(); + + do { + err = esp_wifi_init(&cfg); + if (err != ESP_OK) { + break; + } + + if (startup_cb) { + err = (*startup_cb)(); + if (err != ESP_OK) { + break; + } + } + + err = esp_wifi_start(); + if (err != ESP_OK) { // TODO: if already started, it's also OK + break; + } + +#if CONFIG_WIFI_AUTO_CONNECT + wifi_mode_t mode; + + esp_wifi_get_mode(&mode); + + if (mode == WIFI_MODE_STA || mode == WIFI_MODE_APSTA) { + err = esp_wifi_connect(); + if (err != ESP_OK) { + break; + } + } +#endif + } while (0); + + if (err != ESP_OK) { + esp_wifi_deinit(); + } + + vTaskDelete(NULL); +} + +void esp_wifi_startup(wifi_startup_cb_t cb) +{ + startup_cb = cb; + xTaskCreatePinnedToCore(esp_wifi_task, "wifiTask", 4096, NULL, 5, NULL, 0);// TODO: rearrange task priority +} +#endif diff --git a/components/esptool_py/Kconfig.projbuild b/components/esptool_py/Kconfig.projbuild new file mode 100644 index 000000000..ad7fefb1c --- /dev/null +++ b/components/esptool_py/Kconfig.projbuild @@ -0,0 +1,49 @@ +menu "Serial flasher config" + +config ESPTOOLPY_PORT + string "Default serial port" + default "/dev/ttyUSB0" + help + The serial port that's connected to the ESP chip. This can be overridden by setting the ESPPORT + environment variable. + +choice ESPTOOLPY_BAUD + prompt "Default baud rate" + default ESPTOOLPY_BAUD_115200B + help + Default baud rate to use while communicating with the ESP chip. Can be overridden by + setting the ESPBAUD variable. + +config ESPTOOLPY_BAUD_115200B + bool "115200 baud" +config ESPTOOLPY_BAUD_230400B + bool "230400 baud" +config ESPTOOLPY_BAUD_921600B + bool "921600 baud" +config ESPTOOLPY_BAUD_2MB + bool "2Mbaud" +config ESPTOOLPY_BAUD_OTHER + bool "Other baud rate" +endchoice + +config ESPTOOLPY_BAUD_OTHER_VAL + int "Other baud rate value" if ESPTOOLPY_BAUD_OTHER + default 115200 + +config ESPTOOLPY_BAUD + int + default 115200 if ESPTOOLPY_BAUD_115200B + default 230400 if ESPTOOLPY_BAUD_230400B + default 921600 if ESPTOOLPY_BAUD_921600B + default 2000000 if ESPTOOLPY_BAUD_2MB + default ESPTOOLPY_BAUD_OTHER_VAL if ESPTOOLPY_BAUD_OTHER + +config ESPTOOLPY_COMPRESSED + bool "Use compressed upload" + default "y" + help + The flasher tool can send data compressed using zlib, letting the ROM on the ESP chip + decompress it on the fly before flashing it. For most payloads, this should result in a + speed increase. + +endmenu diff --git a/components/esptool_py/LICENSE b/components/esptool_py/LICENSE new file mode 100644 index 000000000..d159169d1 --- /dev/null +++ b/components/esptool_py/LICENSE @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/components/esptool_py/Makefile.projbuild b/components/esptool_py/Makefile.projbuild new file mode 100644 index 000000000..4bec1f87d --- /dev/null +++ b/components/esptool_py/Makefile.projbuild @@ -0,0 +1,25 @@ +# Component support for esptool.py. Doesn't do much by itself, +# components have their own flash targets that can use these variables. +ESPPORT ?= $(CONFIG_ESPTOOLPY_PORT) +ESPBAUD ?= $(CONFIG_ESPTOOLPY_BAUD) + +PYTHON ?= $(call dequote,$(CONFIG_PYTHON)) + +# two commands that can be used from other components +# to invoke esptool.py (with or without serial port args) +# +# NB: esptool.py lives in the sdk/bin directory not the component directory +ESPTOOLPY := $(PYTHON) $(SDK_PATH)/bin/esptool.py --chip esp32 +ESPTOOLPY_SERIAL := $(ESPTOOLPY) --port $(ESPPORT) --baud $(ESPBAUD) + +PROJECT_FLASH_COMMAND=$(ESPTOOLPY_SERIAL) write_flash $(CONFIG_APP_OFFSET) $(PROJECT_BIN) + +$(PROJECT_BIN): $(PROJECT_ELF) + $(Q) $(ESPTOOLPY) elf2image -o $@ $< + +flash: $(PROJECT_BIN) + @echo "Flashing project app to $(CONFIG_APP_OFFSET)..." + $(Q) $(PROJECT_FLASH_COMMAND) + +# convenience target to flash bootloader, partitions, app all at once +flash_all: bootloader-flash partition_table-flash flash diff --git a/components/freertos/Kconfig b/components/freertos/Kconfig new file mode 100644 index 000000000..8c05199f8 --- /dev/null +++ b/components/freertos/Kconfig @@ -0,0 +1,125 @@ +menu "FreeRTOS" + +# This is actually also handled in the ESP32 startup code, not only in FreeRTOS. +config FREERTOS_UNICORE + bool "Run FreeRTOS only on first core" + default n + help + This version of FreeRTOS normally takes control of all cores of + the CPU. Select this if you only want to start it on the first core. + This is needed when e.g. another process needs complete control + over the second core. + + +choice FREERTOS_CORETIMER + prompt "Xtensa timer to use as the FreeRTOS tick source" + default CONFIG_FREERTOS_CORETIMER_0 + help + FreeRTOS needs a timer with an associated interrupt to use as + the main tick source to increase counters, run timers and do + pre-emptive multitasking with. There are multiple timers available + to do this, with different interrupt priorities. Check + +config FREERTOS_CORETIMER_0 + bool "Timer 0 (int 6, level 1)" + help + Select this to use timer 0 + +config FREERTOS_CORETIMER_1 + bool "Timer 1 (int 15, level 3)" + help + Select this to use timer 1 + +config FREERTOS_CORETIMER_2 + bool "Timer 2 (int 16, level 5)" + help + Select this to use timer 2 + +endchoice + +config FREERTOS_HZ + int "Tick rate (Hz)" + range 1 10000 + default 100 + help + Select the tick rate at which FreeRTOS does pre-emptive context switching. + +choice FREERTOS_CHECK_STACKOVERFLOW + prompt "Check for stack overflow" + default FREERTOS_CHECK_STACKOVERFLOW_QUICK + help + FreeRTOS can check for stack overflows in threads and trigger an user function + called vApplicationStackOverflowHook when this happens. + +config FREERTOS_CHECK_STACKOVERFLOW_NONE + bool "No checking" + help + Do not check for stack overflows (configCHECK_FOR_STACK_OVERFLOW=0) + +config FREERTOS_CHECK_STACKOVERFLOW_PTRVAL + bool "Check by stack pointer value" + help + Check for stack overflows on each context switch by checking if + the stack pointer is in a valid range. Quick but does not detect + stack overflows that happened between context switches + (configCHECK_FOR_STACK_OVERFLOW=1) + +config FREERTOS_CHECK_STACKOVERFLOW_CANARY + bool "Check using canary bytes" + help + Places some magic bytes at the end of the stack area and on each + context switch, check if these bytes are still intact. More thorough + than just checking the pointer, but also slightly slower. + (configCHECK_FOR_STACK_OVERFLOW=2) +endchoice + +config CONFIG_FREERTOS_THREAD_LOCAL_STORAGE_POINTERS + int "Amount of thread local storage pointers" + range 0 256 + default 0 + help + FreeRTOS has the ability to store per-thread pointers in the task + control block. This controls the amount of pointers available; + 0 turns off this functionality. + +#This still needs to be implemented. +choice FREERTOS_PANIC + prompt "Panic handler behaviour" + default FREERTOS_PANIC_PRINT_REBOOT + help + If FreeRTOS detects unexpected behaviour or an unhandled exception, the panic handler is + invoked. Configure the panic handlers action here. + +config FREERTOS_PANIC_PRINT_HALT + bool "Print registers and halt" + help + Outputs the relevant registers over the serial port and halt the + processor. Needs a manual reset to restart. + +config FREERTOS_PANIC_PRINT_REBOOT + bool "Print registers and reboot" + help + Outputs the relevant registers over the serial port and immediately + reset the processor. + +config FREERTOS_PANIC_SILENT_REBOOT + bool "Silent reboot" + help + Just resets the processor without outputting anything + +config FREERTOS_PANIC_GDBSTUB + bool "Invoke GDBStub" + help + Invoke gdbstub on the serial port, allowing for gdb to attach to it to do a postmortem + of the crash. +endchoice + +config FREERTOS_DEBUG_OCDAWARE + bool "Make exception and panic handlers JTAG/OCD aware" + default y + help + The FreeRTOS panic and unhandled exception handers can detect a JTAG OCD debugger and + instead of panicking, have the debugger stop on the offending instruction. + + +endmenu diff --git a/components/freertos/Makefile b/components/freertos/Makefile new file mode 100644 index 000000000..b00176dd1 --- /dev/null +++ b/components/freertos/Makefile @@ -0,0 +1,13 @@ +# +# Component Makefile +# +# This Makefile should, at the very least, just include $(SDK_PATH)/make/component.mk. By default, +# this will take the sources in this directory, compile them and link them into +# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable, +# please read the SDK documents if you need to do this. +# + +COMPONENT_ADD_INCLUDEDIRS := include +COMPONENT_PRIV_INCLUDEDIRS := include/freertos + +include $(SDK_PATH)/make/component.mk diff --git a/components/freertos/croutine.c b/components/freertos/croutine.c new file mode 100644 index 000000000..6a36da903 --- /dev/null +++ b/components/freertos/croutine.c @@ -0,0 +1,390 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#include "FreeRTOS.h" +#include "task.h" +#include "croutine.h" + +/* + * Some kernel aware debuggers require data to be viewed to be global, rather + * than file scope. + */ +#ifdef portREMOVE_STATIC_QUALIFIER + #define static +#endif + + +/* Lists for ready and blocked co-routines. --------------------*/ +static List_t pxReadyCoRoutineLists[ configMAX_CO_ROUTINE_PRIORITIES ]; /*< Prioritised ready co-routines. */ +static List_t xDelayedCoRoutineList1; /*< Delayed co-routines. */ +static List_t xDelayedCoRoutineList2; /*< Delayed co-routines (two lists are used - one for delays that have overflowed the current tick count. */ +static List_t * pxDelayedCoRoutineList; /*< Points to the delayed co-routine list currently being used. */ +static List_t * pxOverflowDelayedCoRoutineList; /*< Points to the delayed co-routine list currently being used to hold co-routines that have overflowed the current tick count. */ +static List_t xPendingReadyCoRoutineList; /*< Holds co-routines that have been readied by an external event. They cannot be added directly to the ready lists as the ready lists cannot be accessed by interrupts. */ + +/* Other file private variables. --------------------------------*/ +CRCB_t * pxCurrentCoRoutine = NULL; +static UBaseType_t uxTopCoRoutineReadyPriority = 0; +static TickType_t xCoRoutineTickCount = 0, xLastTickCount = 0, xPassedTicks = 0; + +/* The initial state of the co-routine when it is created. */ +#define corINITIAL_STATE ( 0 ) + +/* + * Place the co-routine represented by pxCRCB into the appropriate ready queue + * for the priority. It is inserted at the end of the list. + * + * This macro accesses the co-routine ready lists and therefore must not be + * used from within an ISR. + */ +#define prvAddCoRoutineToReadyQueue( pxCRCB ) \ +{ \ + if( pxCRCB->uxPriority > uxTopCoRoutineReadyPriority ) \ + { \ + uxTopCoRoutineReadyPriority = pxCRCB->uxPriority; \ + } \ + vListInsertEnd( ( List_t * ) &( pxReadyCoRoutineLists[ pxCRCB->uxPriority ] ), &( pxCRCB->xGenericListItem ) ); \ +} + +/* + * Utility to ready all the lists used by the scheduler. This is called + * automatically upon the creation of the first co-routine. + */ +static void prvInitialiseCoRoutineLists( void ); + +/* + * Co-routines that are readied by an interrupt cannot be placed directly into + * the ready lists (there is no mutual exclusion). Instead they are placed in + * in the pending ready list in order that they can later be moved to the ready + * list by the co-routine scheduler. + */ +static void prvCheckPendingReadyList( void ); + +/* + * Macro that looks at the list of co-routines that are currently delayed to + * see if any require waking. + * + * Co-routines are stored in the queue in the order of their wake time - + * meaning once one co-routine has been found whose timer has not expired + * we need not look any further down the list. + */ +static void prvCheckDelayedList( void ); + +/*-----------------------------------------------------------*/ + +BaseType_t xCoRoutineCreate( crCOROUTINE_CODE pxCoRoutineCode, UBaseType_t uxPriority, UBaseType_t uxIndex ) +{ +BaseType_t xReturn; +CRCB_t *pxCoRoutine; + + /* Allocate the memory that will store the co-routine control block. */ + pxCoRoutine = ( CRCB_t * ) pvPortMalloc( sizeof( CRCB_t ) ); + if( pxCoRoutine ) + { + /* If pxCurrentCoRoutine is NULL then this is the first co-routine to + be created and the co-routine data structures need initialising. */ + if( pxCurrentCoRoutine == NULL ) + { + pxCurrentCoRoutine = pxCoRoutine; + prvInitialiseCoRoutineLists(); + } + + /* Check the priority is within limits. */ + if( uxPriority >= configMAX_CO_ROUTINE_PRIORITIES ) + { + uxPriority = configMAX_CO_ROUTINE_PRIORITIES - 1; + } + + /* Fill out the co-routine control block from the function parameters. */ + pxCoRoutine->uxState = corINITIAL_STATE; + pxCoRoutine->uxPriority = uxPriority; + pxCoRoutine->uxIndex = uxIndex; + pxCoRoutine->pxCoRoutineFunction = pxCoRoutineCode; + + /* Initialise all the other co-routine control block parameters. */ + vListInitialiseItem( &( pxCoRoutine->xGenericListItem ) ); + vListInitialiseItem( &( pxCoRoutine->xEventListItem ) ); + + /* Set the co-routine control block as a link back from the ListItem_t. + This is so we can get back to the containing CRCB from a generic item + in a list. */ + listSET_LIST_ITEM_OWNER( &( pxCoRoutine->xGenericListItem ), pxCoRoutine ); + listSET_LIST_ITEM_OWNER( &( pxCoRoutine->xEventListItem ), pxCoRoutine ); + + /* Event lists are always in priority order. */ + listSET_LIST_ITEM_VALUE( &( pxCoRoutine->xEventListItem ), ( ( TickType_t ) configMAX_CO_ROUTINE_PRIORITIES - ( TickType_t ) uxPriority ) ); + + /* Now the co-routine has been initialised it can be added to the ready + list at the correct priority. */ + prvAddCoRoutineToReadyQueue( pxCoRoutine ); + + xReturn = pdPASS; + } + else + { + xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY; + } + + return xReturn; +} +/*-----------------------------------------------------------*/ + +void vCoRoutineAddToDelayedList( TickType_t xTicksToDelay, List_t *pxEventList ) +{ +TickType_t xTimeToWake; + + /* Calculate the time to wake - this may overflow but this is + not a problem. */ + xTimeToWake = xCoRoutineTickCount + xTicksToDelay; + + /* We must remove ourselves from the ready list before adding + ourselves to the blocked list as the same list item is used for + both lists. */ + ( void ) uxListRemove( ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + + /* The list item will be inserted in wake time order. */ + listSET_LIST_ITEM_VALUE( &( pxCurrentCoRoutine->xGenericListItem ), xTimeToWake ); + + if( xTimeToWake < xCoRoutineTickCount ) + { + /* Wake time has overflowed. Place this item in the + overflow list. */ + vListInsert( ( List_t * ) pxOverflowDelayedCoRoutineList, ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + } + else + { + /* The wake time has not overflowed, so we can use the + current block list. */ + vListInsert( ( List_t * ) pxDelayedCoRoutineList, ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + } + + if( pxEventList ) + { + /* Also add the co-routine to an event list. If this is done then the + function must be called with interrupts disabled. */ + vListInsert( pxEventList, &( pxCurrentCoRoutine->xEventListItem ) ); + } +} +/*-----------------------------------------------------------*/ + +static void prvCheckPendingReadyList( void ) +{ + /* Are there any co-routines waiting to get moved to the ready list? These + are co-routines that have been readied by an ISR. The ISR cannot access + the ready lists itself. */ + while( listLIST_IS_EMPTY( &xPendingReadyCoRoutineList ) == pdFALSE ) + { + CRCB_t *pxUnblockedCRCB; + + /* The pending ready list can be accessed by an ISR. */ + portDISABLE_INTERRUPTS(); + { + pxUnblockedCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( (&xPendingReadyCoRoutineList) ); + ( void ) uxListRemove( &( pxUnblockedCRCB->xEventListItem ) ); + } + portENABLE_INTERRUPTS(); + + ( void ) uxListRemove( &( pxUnblockedCRCB->xGenericListItem ) ); + prvAddCoRoutineToReadyQueue( pxUnblockedCRCB ); + } +} +/*-----------------------------------------------------------*/ + +static void prvCheckDelayedList( void ) +{ +CRCB_t *pxCRCB; + + xPassedTicks = xTaskGetTickCount() - xLastTickCount; + while( xPassedTicks ) + { + xCoRoutineTickCount++; + xPassedTicks--; + + /* If the tick count has overflowed we need to swap the ready lists. */ + if( xCoRoutineTickCount == 0 ) + { + List_t * pxTemp; + + /* Tick count has overflowed so we need to swap the delay lists. If there are + any items in pxDelayedCoRoutineList here then there is an error! */ + pxTemp = pxDelayedCoRoutineList; + pxDelayedCoRoutineList = pxOverflowDelayedCoRoutineList; + pxOverflowDelayedCoRoutineList = pxTemp; + } + + /* See if this tick has made a timeout expire. */ + while( listLIST_IS_EMPTY( pxDelayedCoRoutineList ) == pdFALSE ) + { + pxCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedCoRoutineList ); + + if( xCoRoutineTickCount < listGET_LIST_ITEM_VALUE( &( pxCRCB->xGenericListItem ) ) ) + { + /* Timeout not yet expired. */ + break; + } + + portDISABLE_INTERRUPTS(); + { + /* The event could have occurred just before this critical + section. If this is the case then the generic list item will + have been moved to the pending ready list and the following + line is still valid. Also the pvContainer parameter will have + been set to NULL so the following lines are also valid. */ + ( void ) uxListRemove( &( pxCRCB->xGenericListItem ) ); + + /* Is the co-routine waiting on an event also? */ + if( pxCRCB->xEventListItem.pvContainer ) + { + ( void ) uxListRemove( &( pxCRCB->xEventListItem ) ); + } + } + portENABLE_INTERRUPTS(); + + prvAddCoRoutineToReadyQueue( pxCRCB ); + } + } + + xLastTickCount = xCoRoutineTickCount; +} +/*-----------------------------------------------------------*/ + +void vCoRoutineSchedule( void ) +{ + /* See if any co-routines readied by events need moving to the ready lists. */ + prvCheckPendingReadyList(); + + /* See if any delayed co-routines have timed out. */ + prvCheckDelayedList(); + + /* Find the highest priority queue that contains ready co-routines. */ + while( listLIST_IS_EMPTY( &( pxReadyCoRoutineLists[ uxTopCoRoutineReadyPriority ] ) ) ) + { + if( uxTopCoRoutineReadyPriority == 0 ) + { + /* No more co-routines to check. */ + return; + } + --uxTopCoRoutineReadyPriority; + } + + /* listGET_OWNER_OF_NEXT_ENTRY walks through the list, so the co-routines + of the same priority get an equal share of the processor time. */ + listGET_OWNER_OF_NEXT_ENTRY( pxCurrentCoRoutine, &( pxReadyCoRoutineLists[ uxTopCoRoutineReadyPriority ] ) ); + + /* Call the co-routine. */ + ( pxCurrentCoRoutine->pxCoRoutineFunction )( pxCurrentCoRoutine, pxCurrentCoRoutine->uxIndex ); + + return; +} +/*-----------------------------------------------------------*/ + +static void prvInitialiseCoRoutineLists( void ) +{ +UBaseType_t uxPriority; + + for( uxPriority = 0; uxPriority < configMAX_CO_ROUTINE_PRIORITIES; uxPriority++ ) + { + vListInitialise( ( List_t * ) &( pxReadyCoRoutineLists[ uxPriority ] ) ); + } + + vListInitialise( ( List_t * ) &xDelayedCoRoutineList1 ); + vListInitialise( ( List_t * ) &xDelayedCoRoutineList2 ); + vListInitialise( ( List_t * ) &xPendingReadyCoRoutineList ); + + /* Start with pxDelayedCoRoutineList using list1 and the + pxOverflowDelayedCoRoutineList using list2. */ + pxDelayedCoRoutineList = &xDelayedCoRoutineList1; + pxOverflowDelayedCoRoutineList = &xDelayedCoRoutineList2; +} +/*-----------------------------------------------------------*/ + +BaseType_t xCoRoutineRemoveFromEventList( const List_t *pxEventList ) +{ +CRCB_t *pxUnblockedCRCB; +BaseType_t xReturn; + + /* This function is called from within an interrupt. It can only access + event lists and the pending ready list. This function assumes that a + check has already been made to ensure pxEventList is not empty. */ + pxUnblockedCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxEventList ); + ( void ) uxListRemove( &( pxUnblockedCRCB->xEventListItem ) ); + vListInsertEnd( ( List_t * ) &( xPendingReadyCoRoutineList ), &( pxUnblockedCRCB->xEventListItem ) ); + + if( pxUnblockedCRCB->uxPriority >= pxCurrentCoRoutine->uxPriority ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + + return xReturn; +} + diff --git a/components/freertos/event_groups.c b/components/freertos/event_groups.c new file mode 100644 index 000000000..1aa95e084 --- /dev/null +++ b/components/freertos/event_groups.c @@ -0,0 +1,695 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* Standard includes. */ +#include + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +/* FreeRTOS includes. */ +#include "FreeRTOS.h" +#include "task.h" +#include "timers.h" +#include "event_groups.h" + +/* Lint e961 and e750 are suppressed as a MISRA exception justified because the +MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the +header files above, but not in this file, in order to generate the correct +privileged Vs unprivileged linkage and placement. */ +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */ + +#if ( INCLUDE_xEventGroupSetBitFromISR == 1 ) && ( configUSE_TIMERS == 0 ) + #error configUSE_TIMERS must be set to 1 to make the xEventGroupSetBitFromISR() function available. +#endif + +#if ( INCLUDE_xEventGroupSetBitFromISR == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 0 ) + #error INCLUDE_xTimerPendFunctionCall must also be set to one to make the xEventGroupSetBitFromISR() function available. +#endif + +/* The following bit fields convey control information in a task's event list +item value. It is important they don't clash with the +taskEVENT_LIST_ITEM_VALUE_IN_USE definition. */ +#if configUSE_16_BIT_TICKS == 1 + #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x0100U + #define eventUNBLOCKED_DUE_TO_BIT_SET 0x0200U + #define eventWAIT_FOR_ALL_BITS 0x0400U + #define eventEVENT_BITS_CONTROL_BYTES 0xff00U +#else + #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x01000000UL + #define eventUNBLOCKED_DUE_TO_BIT_SET 0x02000000UL + #define eventWAIT_FOR_ALL_BITS 0x04000000UL + #define eventEVENT_BITS_CONTROL_BYTES 0xff000000UL +#endif + +typedef struct xEventGroupDefinition +{ + EventBits_t uxEventBits; + List_t xTasksWaitingForBits; /*< List of tasks waiting for a bit to be set. */ + + #if( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxEventGroupNumber; + #endif + +} EventGroup_t; + + +/* Again: one mux for all events. Maybe this can be made more granular. ToDo: look into that. -JD */ +static portMUX_TYPE xEventGroupMux; +static BaseType_t xMuxInitialized = pdFALSE; + + +/*-----------------------------------------------------------*/ + +/* + * Test the bits set in uxCurrentEventBits to see if the wait condition is met. + * The wait condition is defined by xWaitForAllBits. If xWaitForAllBits is + * pdTRUE then the wait condition is met if all the bits set in uxBitsToWaitFor + * are also set in uxCurrentEventBits. If xWaitForAllBits is pdFALSE then the + * wait condition is met if any of the bits set in uxBitsToWait for are also set + * in uxCurrentEventBits. + */ +static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits ); + +/*-----------------------------------------------------------*/ + +EventGroupHandle_t xEventGroupCreate( void ) +{ +EventGroup_t *pxEventBits; + + //Initialize mux, if needed + if ( xMuxInitialized == pdFALSE ) { + vPortCPUInitializeMutex( & xEventGroupMux ); + xMuxInitialized = pdTRUE; + } + + pxEventBits = pvPortMalloc( sizeof( EventGroup_t ) ); + if( pxEventBits != NULL ) + { + pxEventBits->uxEventBits = 0; + vListInitialise( &( pxEventBits->xTasksWaitingForBits ) ); + traceEVENT_GROUP_CREATE( pxEventBits ); + } + else + { + traceEVENT_GROUP_CREATE_FAILED(); + } + + return ( EventGroupHandle_t ) pxEventBits; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait ) +{ +EventBits_t uxOriginalBitValue, uxReturn; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +BaseType_t xAlreadyYielded; +BaseType_t xTimeoutOccurred = pdFALSE; + + configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + configASSERT( uxBitsToWaitFor != 0 ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + vTaskSuspendAll(); + { + uxOriginalBitValue = pxEventBits->uxEventBits; + + ( void ) xEventGroupSetBits( xEventGroup, uxBitsToSet ); + + if( ( ( uxOriginalBitValue | uxBitsToSet ) & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + /* All the rendezvous bits are now set - no need to block. */ + uxReturn = ( uxOriginalBitValue | uxBitsToSet ); + + /* Rendezvous always clear the bits. They will have been cleared + already unless this is the only task in the rendezvous. */ + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + + xTicksToWait = 0; + } + else + { + if( xTicksToWait != ( TickType_t ) 0 ) + { + traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor ); + + /* Store the bits that the calling task is waiting for in the + task's event list item so the kernel knows when a match is + found. Then enter the blocked state. */ + vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | eventCLEAR_EVENTS_ON_EXIT_BIT | eventWAIT_FOR_ALL_BITS ), xTicksToWait ); + + /* This assignment is obsolete as uxReturn will get set after + the task unblocks, but some compilers mistakenly generate a + warning about uxReturn being returned without being set if the + assignment is omitted. */ + uxReturn = 0; + } + else + { + /* The rendezvous bits were not set, but no block time was + specified - just return the current event bit value. */ + uxReturn = pxEventBits->uxEventBits; + } + } + } + xAlreadyYielded = xTaskResumeAll(); + + if( xTicksToWait != ( TickType_t ) 0 ) + { + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The task blocked to wait for its required bits to be set - at this + point either the required bits were set or the block time expired. If + the required bits were set they will have been stored in the task's + event list item, and they should now be retrieved then cleared. */ + uxReturn = uxTaskResetEventItemValue(); + + if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 ) + { + /* The task timed out, just return the current event bit value. */ + taskENTER_CRITICAL( &xEventGroupMux ); + { + uxReturn = pxEventBits->uxEventBits; + + /* Although the task got here because it timed out before the + bits it was waiting for were set, it is possible that since it + unblocked another task has set the bits. If this is the case + then it needs to clear the bits before exiting. */ + if( ( uxReturn & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL( &xEventGroupMux ); + + xTimeoutOccurred = pdTRUE; + } + else + { + /* The task unblocked because the bits were set. */ + } + + /* Control bits might be set as the task had blocked should not be + returned. */ + uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES; + } + + traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn, uxControlBits = 0; +BaseType_t xWaitConditionMet, xAlreadyYielded; +BaseType_t xTimeoutOccurred = pdFALSE; + + /* Check the user is not attempting to wait on the bits used by the kernel + itself, and that at least one bit is being requested. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + configASSERT( uxBitsToWaitFor != 0 ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + vTaskSuspendAll(); + { + const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits; + + /* Check to see if the wait condition is already met or not. */ + xWaitConditionMet = prvTestWaitCondition( uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits ); + + if( xWaitConditionMet != pdFALSE ) + { + /* The wait condition has already been met so there is no need to + block. */ + uxReturn = uxCurrentEventBits; + xTicksToWait = ( TickType_t ) 0; + + /* Clear the wait bits if requested to do so. */ + if( xClearOnExit != pdFALSE ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( xTicksToWait == ( TickType_t ) 0 ) + { + /* The wait condition has not been met, but no block time was + specified, so just return the current value. */ + uxReturn = uxCurrentEventBits; + } + else + { + /* The task is going to block to wait for its required bits to be + set. uxControlBits are used to remember the specified behaviour of + this call to xEventGroupWaitBits() - for use when the event bits + unblock the task. */ + if( xClearOnExit != pdFALSE ) + { + uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( xWaitForAllBits != pdFALSE ) + { + uxControlBits |= eventWAIT_FOR_ALL_BITS; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Store the bits that the calling task is waiting for in the + task's event list item so the kernel knows when a match is + found. Then enter the blocked state. */ + vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait ); + + /* This is obsolete as it will get set after the task unblocks, but + some compilers mistakenly generate a warning about the variable + being returned without being set if it is not done. */ + uxReturn = 0; + + traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor ); + } + } + xAlreadyYielded = xTaskResumeAll(); + + if( xTicksToWait != ( TickType_t ) 0 ) + { + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The task blocked to wait for its required bits to be set - at this + point either the required bits were set or the block time expired. If + the required bits were set they will have been stored in the task's + event list item, and they should now be retrieved then cleared. */ + uxReturn = uxTaskResetEventItemValue(); + + if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 ) + { + taskENTER_CRITICAL( &xEventGroupMux ); + { + /* The task timed out, just return the current event bit value. */ + uxReturn = pxEventBits->uxEventBits; + + /* It is possible that the event bits were updated between this + task leaving the Blocked state and running again. */ + if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE ) + { + if( xClearOnExit != pdFALSE ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL( &xEventGroupMux ); + + /* Prevent compiler warnings when trace macros are not used. */ + xTimeoutOccurred = pdFALSE; + } + else + { + /* The task unblocked because the bits were set. */ + } + + /* The task blocked so control bits may have been set. */ + uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES; + } + traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn; + + /* Check the user is not attempting to clear the bits used by the kernel + itself. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + + taskENTER_CRITICAL( &xEventGroupMux ); + { + traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear ); + + /* The value returned is the event group value prior to the bits being + cleared. */ + uxReturn = pxEventBits->uxEventBits; + + /* Clear the bits. */ + pxEventBits->uxEventBits &= ~uxBitsToClear; + } + taskEXIT_CRITICAL( &xEventGroupMux ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) ) + + BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) + { + BaseType_t xReturn; + + traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear ); + xReturn = xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL ); + + return xReturn; + } + +#endif +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup ) +{ +UBaseType_t uxSavedInterruptStatus; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn; + + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + { + uxReturn = pxEventBits->uxEventBits; + } + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) +{ +ListItem_t *pxListItem, *pxNext; +ListItem_t const *pxListEnd; +List_t *pxList; +EventBits_t uxBitsToClear = 0, uxBitsWaitedFor, uxControlBits; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +BaseType_t xMatchFound = pdFALSE; + + /* Check the user is not attempting to set the bits used by the kernel + itself. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToSet & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + + pxList = &( pxEventBits->xTasksWaitingForBits ); + pxListEnd = listGET_END_MARKER( pxList ); /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + vTaskSuspendAll(); + { + traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet ); + + pxListItem = listGET_HEAD_ENTRY( pxList ); + + /* Set the bits. */ + pxEventBits->uxEventBits |= uxBitsToSet; + + /* See if the new bit value should unblock any tasks. */ + while( pxListItem != pxListEnd ) + { + pxNext = listGET_NEXT( pxListItem ); + uxBitsWaitedFor = listGET_LIST_ITEM_VALUE( pxListItem ); + xMatchFound = pdFALSE; + + /* Split the bits waited for from the control bits. */ + uxControlBits = uxBitsWaitedFor & eventEVENT_BITS_CONTROL_BYTES; + uxBitsWaitedFor &= ~eventEVENT_BITS_CONTROL_BYTES; + + if( ( uxControlBits & eventWAIT_FOR_ALL_BITS ) == ( EventBits_t ) 0 ) + { + /* Just looking for single bit being set. */ + if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) != ( EventBits_t ) 0 ) + { + xMatchFound = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) == uxBitsWaitedFor ) + { + /* All bits are set. */ + xMatchFound = pdTRUE; + } + else + { + /* Need all bits to be set, but not all the bits were set. */ + } + + if( xMatchFound != pdFALSE ) + { + /* The bits match. Should the bits be cleared on exit? */ + if( ( uxControlBits & eventCLEAR_EVENTS_ON_EXIT_BIT ) != ( EventBits_t ) 0 ) + { + uxBitsToClear |= uxBitsWaitedFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Store the actual event flag value in the task's event list + item before removing the task from the event list. The + eventUNBLOCKED_DUE_TO_BIT_SET bit is set so the task knows + that is was unblocked due to its required bits matching, rather + than because it timed out. */ + ( void ) xTaskRemoveFromUnorderedEventList( pxListItem, pxEventBits->uxEventBits | eventUNBLOCKED_DUE_TO_BIT_SET ); + } + + /* Move onto the next list item. Note pxListItem->pxNext is not + used here as the list item may have been removed from the event list + and inserted into the ready/pending reading list. */ + pxListItem = pxNext; + } + + /* Clear any bits that matched when the eventCLEAR_EVENTS_ON_EXIT_BIT + bit was set in the control word. */ + pxEventBits->uxEventBits &= ~uxBitsToClear; + } + ( void ) xTaskResumeAll(); + + return pxEventBits->uxEventBits; +} +/*-----------------------------------------------------------*/ + +void vEventGroupDelete( EventGroupHandle_t xEventGroup ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +const List_t *pxTasksWaitingForBits = &( pxEventBits->xTasksWaitingForBits ); + + vTaskSuspendAll(); + { + traceEVENT_GROUP_DELETE( xEventGroup ); + + while( listCURRENT_LIST_LENGTH( pxTasksWaitingForBits ) > ( UBaseType_t ) 0 ) + { + /* Unblock the task, returning 0 as the event list is being deleted + and cannot therefore have any bits set. */ + configASSERT( pxTasksWaitingForBits->xListEnd.pxNext != ( ListItem_t * ) &( pxTasksWaitingForBits->xListEnd ) ); + ( void ) xTaskRemoveFromUnorderedEventList( pxTasksWaitingForBits->xListEnd.pxNext, eventUNBLOCKED_DUE_TO_BIT_SET ); + } + + vPortFree( pxEventBits ); + } + ( void ) xTaskResumeAll(); +} +/*-----------------------------------------------------------*/ + +/* For internal use only - execute a 'set bits' command that was pended from +an interrupt. */ +void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet ) +{ + ( void ) xEventGroupSetBits( pvEventGroup, ( EventBits_t ) ulBitsToSet ); +} +/*-----------------------------------------------------------*/ + +/* For internal use only - execute a 'clear bits' command that was pended from +an interrupt. */ +void vEventGroupClearBitsCallback( void *pvEventGroup, const uint32_t ulBitsToClear ) +{ + ( void ) xEventGroupClearBits( pvEventGroup, ( EventBits_t ) ulBitsToClear ); +} +/*-----------------------------------------------------------*/ + +static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits ) +{ +BaseType_t xWaitConditionMet = pdFALSE; + + if( xWaitForAllBits == pdFALSE ) + { + /* Task only has to wait for one bit within uxBitsToWaitFor to be + set. Is one already set? */ + if( ( uxCurrentEventBits & uxBitsToWaitFor ) != ( EventBits_t ) 0 ) + { + xWaitConditionMet = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* Task has to wait for all the bits in uxBitsToWaitFor to be set. + Are they set already? */ + if( ( uxCurrentEventBits & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + xWaitConditionMet = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + return xWaitConditionMet; +} +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) ) + + BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken ) + { + BaseType_t xReturn; + + traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet ); + xReturn = xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken ); + + return xReturn; + } + +#endif +/*-----------------------------------------------------------*/ + +#if (configUSE_TRACE_FACILITY == 1) + + UBaseType_t uxEventGroupGetNumber( void* xEventGroup ) + { + UBaseType_t xReturn; + EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; + + if( xEventGroup == NULL ) + { + xReturn = 0; + } + else + { + xReturn = pxEventBits->uxEventGroupNumber; + } + + return xReturn; + } + +#endif + diff --git a/components/freertos/gdbstub.c b/components/freertos/gdbstub.c new file mode 100644 index 000000000..ca2395f77 --- /dev/null +++ b/components/freertos/gdbstub.c @@ -0,0 +1,365 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +/****************************************************************************** + * Description: A stub to make the ESP32 debuggable by GDB over the serial + * port, at least enough to do a backtrace on panic. This gdbstub is read-only: + * it allows inspecting the ESP32 state + *******************************************************************************/ + +//ToDo: Clean up includes and sync to real rtos +#include "rom/ets_sys.h" + +#include "soc/uart_register.h" +#include "soc/io_mux_reg.h" + +#include "gdbstub.h" + +//Length of buffer used to reserve GDB commands. Has to be at least able to fit the G command, which +//implies a minimum size of about 320 bytes. +#define PBUFLEN 512 + +static unsigned char cmd[PBUFLEN]; //GDB command input buffer +static char chsum; //Running checksum of the output packet + +#define ATTR_GDBFN + +static void ATTR_GDBFN keepWDTalive() { + //ToDo for esp31/32 +} + + +//Receive a char from the uart. Uses polling and feeds the watchdog. +static int ATTR_GDBFN gdbRecvChar() { + int i; + while (((READ_PERI_REG(UART_STATUS_REG(0))>>UART_RXFIFO_CNT_S)&UART_RXFIFO_CNT)==0) { + keepWDTalive(); + } + i=READ_PERI_REG(UART_FIFO_REG(0)); + return i; +} + +//Send a char to the uart. +static void ATTR_GDBFN gdbSendChar(char c) { + while (((READ_PERI_REG(UART_STATUS_REG(0))>>UART_TXFIFO_CNT_S)&UART_TXFIFO_CNT)>=126) ; + WRITE_PERI_REG(UART_FIFO_REG(0), c); +} + +//Send the start of a packet; reset checksum calculation. +static void ATTR_GDBFN gdbPacketStart() { + chsum=0; + gdbSendChar('$'); +} + +//Send a char as part of a packet +static void ATTR_GDBFN gdbPacketChar(char c) { + if (c=='#' || c=='$' || c=='}' || c=='*') { + gdbSendChar('}'); + gdbSendChar(c^0x20); + chsum+=(c^0x20)+'}'; + } else { + gdbSendChar(c); + chsum+=c; + } +} + +//Send a string as part of a packet +static void ATTR_GDBFN gdbPacketStr(char *c) { + while (*c!=0) { + gdbPacketChar(*c); + c++; + } +} + +//Send a hex val as part of a packet. 'bits'/4 dictates the number of hex chars sent. +static void ATTR_GDBFN gdbPacketHex(int val, int bits) { + char hexChars[]="0123456789abcdef"; + int i; + for (i=bits; i>0; i-=4) { + gdbPacketChar(hexChars[(val>>(i-4))&0xf]); + } +} + +//Finish sending a packet. +static void ATTR_GDBFN gdbPacketEnd() { + gdbSendChar('#'); + gdbPacketHex(chsum, 8); +} + +//Error states used by the routines that grab stuff from the incoming gdb packet +#define ST_ENDPACKET -1 +#define ST_ERR -2 +#define ST_OK -3 +#define ST_CONT -4 + +//Grab a hex value from the gdb packet. Ptr will get positioned on the end +//of the hex string, as far as the routine has read into it. Bits/4 indicates +//the max amount of hex chars it gobbles up. Bits can be -1 to eat up as much +//hex chars as possible. +static long ATTR_GDBFN gdbGetHexVal(unsigned char **ptr, int bits) { + int i; + int no; + unsigned int v=0; + char c; + no=bits/4; + if (bits==-1) no=64; + for (i=0; i='0' && c<='9') { + v<<=4; + v|=(c-'0'); + } else if (c>='A' && c<='F') { + v<<=4; + v|=(c-'A')+10; + } else if (c>='a' && c<='f') { + v<<=4; + v|=(c-'a')+10; + } else if (c=='#') { + if (bits==-1) { + (*ptr)--; + return v; + } + return ST_ENDPACKET; + } else { + if (bits==-1) { + (*ptr)--; + return v; + } + return ST_ERR; + } + } + return v; +} + +//Swap an int into the form gdb wants it +static int ATTR_GDBFN iswap(int i) { + int r; + r=((i>>24)&0xff); + r|=((i>>16)&0xff)<<8; + r|=((i>>8)&0xff)<<16; + r|=((i>>0)&0xff)<<24; + return r; +} + +//Read a byte from ESP32 memory. +static unsigned char ATTR_GDBFN readbyte(unsigned int p) { + int *i=(int*)(p&(~3)); + if (p<0x20000000 || p>=0x80000000) return -1; + return *i>>((p&3)*8); +} + + +//Register file in the format exp108 gdb port expects it. +//Inspired by gdb/regformats/reg-xtensa.dat +typedef struct { + uint32_t pc; + uint32_t a[64]; + uint32_t lbeg; + uint32_t lend; + uint32_t lcount; + uint32_t sar; + uint32_t windowbase; + uint32_t windowstart; + uint32_t configid0; + uint32_t configid1; + uint32_t ps; + uint32_t threadptr; + uint32_t br; + uint32_t scompare1; + uint32_t acclo; + uint32_t acchi; + uint32_t m0; + uint32_t m1; + uint32_t m2; + uint32_t m3; + uint32_t expstate; //I'm going to assume this is exccause... + uint32_t f64r_lo; + uint32_t f64r_hi; + uint32_t f64s; + uint32_t f[16]; + uint32_t fcr; + uint32_t fsr; +} GdbRegFile; + + +GdbRegFile gdbRegFile; + +/* +//Register format as the Xtensa HAL has it: +STRUCT_FIELD (long, 4, XT_STK_EXIT, exit) +STRUCT_FIELD (long, 4, XT_STK_PC, pc) +STRUCT_FIELD (long, 4, XT_STK_PS, ps) +STRUCT_FIELD (long, 4, XT_STK_A0, a0) +[..] +STRUCT_FIELD (long, 4, XT_STK_A15, a15) +STRUCT_FIELD (long, 4, XT_STK_SAR, sar) +STRUCT_FIELD (long, 4, XT_STK_EXCCAUSE, exccause) +STRUCT_FIELD (long, 4, XT_STK_EXCVADDR, excvaddr) +STRUCT_FIELD (long, 4, XT_STK_LBEG, lbeg) +STRUCT_FIELD (long, 4, XT_STK_LEND, lend) +STRUCT_FIELD (long, 4, XT_STK_LCOUNT, lcount) +// Temporary space for saving stuff during window spill +STRUCT_FIELD (long, 4, XT_STK_TMP0, tmp0) +STRUCT_FIELD (long, 4, XT_STK_TMP1, tmp1) +STRUCT_FIELD (long, 4, XT_STK_TMP2, tmp2) +STRUCT_FIELD (long, 4, XT_STK_VPRI, vpri) +STRUCT_FIELD (long, 4, XT_STK_OVLY, ovly) +#endif +STRUCT_END(XtExcFrame) +*/ + + +static void dumpHwToRegfile(XtExcFrame *frame) { + int i; + long *frameAregs=&frame->a0; + gdbRegFile.pc=frame->pc; + for (i=0; i<16; i++) gdbRegFile.a[i]=frameAregs[i]; + for (i=16; i<64; i++) gdbRegFile.a[i]=0xDEADBEEF; + gdbRegFile.lbeg=frame->lbeg; + gdbRegFile.lend=frame->lend; + gdbRegFile.lcount=frame->lcount; + gdbRegFile.sar=frame->sar; + //All windows have been spilled to the stack by the ISR routines. The following values should indicate that. + gdbRegFile.sar=frame->sar; + gdbRegFile.windowbase=0; //0 + gdbRegFile.windowstart=0x1; //1 + gdbRegFile.configid0=0xdeadbeef; //ToDo + gdbRegFile.configid1=0xdeadbeef; //ToDo + gdbRegFile.ps=frame->ps-PS_EXCM_MASK; + gdbRegFile.threadptr=0xdeadbeef; //ToDo + gdbRegFile.br=0xdeadbeef; //ToDo + gdbRegFile.scompare1=0xdeadbeef; //ToDo + gdbRegFile.acclo=0xdeadbeef; //ToDo + gdbRegFile.acchi=0xdeadbeef; //ToDo + gdbRegFile.m0=0xdeadbeef; //ToDo + gdbRegFile.m1=0xdeadbeef; //ToDo + gdbRegFile.m2=0xdeadbeef; //ToDo + gdbRegFile.m3=0xdeadbeef; //ToDo + gdbRegFile.expstate=frame->exccause; //ToDo +} + + +//Send the reason execution is stopped to GDB. +static void sendReason() { + //exception-to-signal mapping + char exceptionSignal[]={4,31,11,11,2,6,8,0,6,7,0,0,7,7,7,7}; + int i=0; + gdbPacketStart(); + gdbPacketChar('T'); + i=gdbRegFile.expstate&0x7f; + if (i=PBUFLEN) return ST_ERR; + } + //A # has been received. Get and check the received chsum. + sentchs[0]=gdbRecvChar(); + sentchs[1]=gdbRecvChar(); + ptr=&sentchs[0]; + rchsum=gdbGetHexVal(&ptr, 8); +// ets_printf("c %x r %x\n", chsum, rchsum); + if (rchsum!=chsum) { + gdbSendChar('-'); + return ST_ERR; + } else { + gdbSendChar('+'); + return gdbHandleCommand(cmd, p); + } +} + + + +void gdbstubPanicHandler(XtExcFrame *frame) { + dumpHwToRegfile(frame); + //Make sure txd/rxd are enabled + PIN_PULLUP_DIS(PERIPHS_IO_MUX_U0TXD_U); + PIN_FUNC_SELECT(PERIPHS_IO_MUX_U0RXD_U, FUNC_U0RXD_U0RXD); + PIN_FUNC_SELECT(PERIPHS_IO_MUX_U0TXD_U, FUNC_U0TXD_U0TXD); + + sendReason(); + while(gdbReadCommand()!=ST_CONT); + while(1); +} + diff --git a/components/freertos/gdbstub.h b/components/freertos/gdbstub.h new file mode 100644 index 000000000..5e97213c9 --- /dev/null +++ b/components/freertos/gdbstub.h @@ -0,0 +1,22 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef GDBSTUB_H +#define GDBSTUB_H + +#include +#include "freertos/xtensa_api.h" + +void gdbstubPanicHandler(XtExcFrame *frame); + +#endif \ No newline at end of file diff --git a/components/freertos/heap_regions.c b/components/freertos/heap_regions.c new file mode 100644 index 000000000..d1ab6240b --- /dev/null +++ b/components/freertos/heap_regions.c @@ -0,0 +1,559 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* + * This is a heap allocator that can allocate memory out of several tagged memory regions, + * with the regions having differing capabilities. In the ESP32, this is used to + * allocate memory for the various applications within the space the MMU allows them + * to work with. It can also be used to e.g. allocate memory in DMA-capable regions. + * + * Usage notes: + * + * vPortDefineHeapRegions() ***must*** be called before pvPortMalloc(). + * pvPortMalloc() will be called if any task objects (tasks, queues, event + * groups, etc.) are created, therefore vPortDefineHeapRegions() ***must*** be + * called before any other objects are defined. + * + * vPortDefineHeapRegions() takes a single parameter. The parameter is an array + * of HeapRegionTagged_t structures. HeapRegion_t is defined in portable.h as + * + * typedef struct HeapRegion + * { + * uint8_t *pucStartAddress; << Start address of a block of memory that will be part of the heap. + * size_t xSizeInBytes; << Size of the block of memory. + * BaseType_t xTag; << Tag + * } HeapRegionTagged_t; + * + * 'Tag' allows you to allocate memory of a certain type. Tag -1 is special; + * it basically tells the allocator to ignore this region as if it is not + * in the array at all. This facilitates disabling memory regions. + * + * The array is terminated using a NULL zero sized region definition, and the + * memory regions defined in the array ***must*** appear in address order from + * low address to high address. So the following is a valid example of how + * to use the function. + * + * HeapRegionTagged_t xHeapRegions[] = + * { + * { ( uint8_t * ) 0x80000000UL, 0x10000, 1 }, << Defines a block of 0x10000 bytes starting at address 0x80000000, tag 1 + * { ( uint8_t * ) 0x90000000UL, 0xa0000, 2 }, << Defines a block of 0xa0000 bytes starting at address of 0x90000000, tag 2 + * { NULL, 0, 0 } << Terminates the array. + * }; + * + * vPortDefineHeapRegions( xHeapRegions ); << Pass the array into vPortDefineHeapRegions(). + * + * Note 0x80000000 is the lower address so appears in the array first. + * + * pvPortMallocTagged can be used to get memory in a tagged region. + * + */ + +/* + +ToDo: +- This malloc implementation can be somewhat slow, especially when it is called multiple times with multiple tags +when having low memory issues. ToDo: Make it quicker. + -JD + */ + + +#include + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +#include "FreeRTOS.h" +#include "task.h" + +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +#include "heap_regions.h" + +#include "rom/ets_sys.h" + +/* Block sizes must not get too small. */ +#define heapMINIMUM_BLOCK_SIZE ( ( size_t ) ( uxHeapStructSize << 1 ) ) + +/* Assumes 8bit bytes! */ +#define heapBITS_PER_BYTE ( ( size_t ) 8 ) + +/* Define the linked list structure. This is used to link free blocks in order +of their memory address. */ +typedef struct A_BLOCK_LINK +{ + struct A_BLOCK_LINK *pxNextFreeBlock; /*<< The next free block in the list. */ + size_t xBlockSize; /*<< The size of the free block. */ + BaseType_t xTag; /*<< Tag of this region */ +} BlockLink_t; + +//Mux to protect the memory status data +static portMUX_TYPE xMallocMutex; + +/*-----------------------------------------------------------*/ + +/* + * Inserts a block of memory that is being freed into the correct position in + * the list of free memory blocks. The block being freed will be merged with + * the block in front it and/or the block behind it if the memory blocks are + * adjacent to each other. + */ +static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert ); + +/*-----------------------------------------------------------*/ + +/* The size of the structure placed at the beginning of each allocated memory +block must by correctly byte aligned. */ +static const uint32_t uxHeapStructSize = ( ( sizeof ( BlockLink_t ) + ( portBYTE_ALIGNMENT - 1 ) ) & ~portBYTE_ALIGNMENT_MASK ); + +/* Create a couple of list links to mark the start and end of the list. */ +static BlockLink_t xStart, *pxEnd = NULL; + +/* Keeps track of the number of free bytes remaining, but says nothing about +fragmentation. */ +static size_t xFreeBytesRemaining = 0; +static size_t xMinimumEverFreeBytesRemaining = 0; + +/* Gets set to the top bit of an size_t type. When this bit in the xBlockSize +member of an BlockLink_t structure is set then the block belongs to the +application. When the bit is free the block is still part of the free heap +space. */ +static size_t xBlockAllocatedBit = 0; + +/*-----------------------------------------------------------*/ + +void *pvPortMallocTagged( size_t xWantedSize, BaseType_t tag ) +{ +BlockLink_t *pxBlock, *pxPreviousBlock, *pxNewBlockLink; +void *pvReturn = NULL; + + /* The heap must be initialised before the first call to + prvPortMalloc(). */ + configASSERT( pxEnd ); + + taskENTER_CRITICAL(&xMallocMutex); + { + /* Check the requested block size is not so large that the top bit is + set. The top bit of the block size member of the BlockLink_t structure + is used to determine who owns the block - the application or the + kernel, so it must be free. */ + if( ( xWantedSize & xBlockAllocatedBit ) == 0 ) + { + /* The wanted size is increased so it can contain a BlockLink_t + structure in addition to the requested amount of bytes. */ + if( xWantedSize > 0 ) + { + xWantedSize += uxHeapStructSize; + + /* Ensure that blocks are always aligned to the required number + of bytes. */ + if( ( xWantedSize & portBYTE_ALIGNMENT_MASK ) != 0x00 ) + { + /* Byte alignment required. */ + xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & portBYTE_ALIGNMENT_MASK ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( ( xWantedSize > 0 ) && ( xWantedSize <= xFreeBytesRemaining ) ) + { + /* Traverse the list from the start (lowest address) block until + one of adequate size is found. */ + pxPreviousBlock = &xStart; + pxBlock = xStart.pxNextFreeBlock; + while( ( ( pxBlock->xTag != tag ) || ( pxBlock->xBlockSize < xWantedSize ) ) && ( pxBlock->pxNextFreeBlock != NULL ) ) + { +// ets_printf("Block %x -> %x\n", (uint32_t)pxBlock, (uint32_t)pxBlock->pxNextFreeBlock); + pxPreviousBlock = pxBlock; + pxBlock = pxBlock->pxNextFreeBlock; + } + + /* If the end marker was not reached then a block of adequate size + was found. */ + if( pxBlock != pxEnd ) + { + /* Return the memory space pointed to - jumping over the + BlockLink_t structure at its start. */ + pvReturn = ( void * ) ( ( ( uint8_t * ) pxPreviousBlock->pxNextFreeBlock ) + uxHeapStructSize ); + + /* This block is being returned for use so must be taken out + of the list of free blocks. */ + pxPreviousBlock->pxNextFreeBlock = pxBlock->pxNextFreeBlock; + + /* If the block is larger than required it can be split into + two. */ + if( ( pxBlock->xBlockSize - xWantedSize ) > heapMINIMUM_BLOCK_SIZE ) + { + /* This block is to be split into two. Create a new + block following the number of bytes requested. The void + cast is used to prevent byte alignment warnings from the + compiler. */ + pxNewBlockLink = ( void * ) ( ( ( uint8_t * ) pxBlock ) + xWantedSize ); + + /* Calculate the sizes of two blocks split from the + single block. */ + pxNewBlockLink->xBlockSize = pxBlock->xBlockSize - xWantedSize; + pxNewBlockLink->xTag = tag; + pxBlock->xBlockSize = xWantedSize; + + /* Insert the new block into the list of free blocks. */ + prvInsertBlockIntoFreeList( ( pxNewBlockLink ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + xFreeBytesRemaining -= pxBlock->xBlockSize; + + if( xFreeBytesRemaining < xMinimumEverFreeBytesRemaining ) + { + xMinimumEverFreeBytesRemaining = xFreeBytesRemaining; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The block is being returned - it is allocated and owned + by the application and has no "next" block. */ + pxBlock->xBlockSize |= xBlockAllocatedBit; + pxBlock->pxNextFreeBlock = NULL; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + traceMALLOC( pvReturn, xWantedSize ); + } + taskEXIT_CRITICAL(&xMallocMutex); + + #if( configUSE_MALLOC_FAILED_HOOK == 1 ) + { + if( pvReturn == NULL ) + { + extern void vApplicationMallocFailedHook( void ); + vApplicationMallocFailedHook(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif + + return pvReturn; +} +/*-----------------------------------------------------------*/ + +void vPortFree( void *pv ) +{ +uint8_t *puc = ( uint8_t * ) pv; +BlockLink_t *pxLink; + + if( pv != NULL ) + { + /* The memory being freed will have an BlockLink_t structure immediately + before it. */ + puc -= uxHeapStructSize; + + /* This casting is to keep the compiler from issuing warnings. */ + pxLink = ( void * ) puc; + + /* Check the block is actually allocated. */ + configASSERT( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 ); + configASSERT( pxLink->pxNextFreeBlock == NULL ); + + if( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 ) + { + if( pxLink->pxNextFreeBlock == NULL ) + { + /* The block is being returned to the heap - it is no longer + allocated. */ + pxLink->xBlockSize &= ~xBlockAllocatedBit; + + taskENTER_CRITICAL(&xMallocMutex); + { + /* Add this block to the list of free blocks. */ + xFreeBytesRemaining += pxLink->xBlockSize; + traceFREE( pv, pxLink->xBlockSize ); + prvInsertBlockIntoFreeList( ( ( BlockLink_t * ) pxLink ) ); + } + taskEXIT_CRITICAL(&xMallocMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } +} +/*-----------------------------------------------------------*/ + +size_t xPortGetFreeHeapSize( void ) +{ + return xFreeBytesRemaining; +} +/*-----------------------------------------------------------*/ + +size_t xPortGetMinimumEverFreeHeapSize( void ) +{ + return xMinimumEverFreeBytesRemaining; +} +/*-----------------------------------------------------------*/ + +static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert ) +{ +BlockLink_t *pxIterator; +uint8_t *puc; + + /* Iterate through the list until a block is found that has a higher address + than the block being inserted. */ + for( pxIterator = &xStart; pxIterator->pxNextFreeBlock < pxBlockToInsert; pxIterator = pxIterator->pxNextFreeBlock ) + { + /* Nothing to do here, just iterate to the right position. */ + } + + /* Do the block being inserted, and the block it is being inserted after + make a contiguous block of memory, and are the tags the same? */ + puc = ( uint8_t * ) pxIterator; + if( ( puc + pxIterator->xBlockSize ) == ( uint8_t * ) pxBlockToInsert && pxBlockToInsert->xTag==pxIterator->xTag) + { + pxIterator->xBlockSize += pxBlockToInsert->xBlockSize; + pxBlockToInsert = pxIterator; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Do the block being inserted, and the block it is being inserted before + make a contiguous block of memory, and are the tags the same */ + puc = ( uint8_t * ) pxBlockToInsert; + if( ( puc + pxBlockToInsert->xBlockSize ) == ( uint8_t * ) pxIterator->pxNextFreeBlock && pxBlockToInsert->xTag==pxIterator->pxNextFreeBlock->xTag ) + { + if( pxIterator->pxNextFreeBlock != pxEnd ) + { + /* Form one big block from the two blocks. */ + pxBlockToInsert->xBlockSize += pxIterator->pxNextFreeBlock->xBlockSize; + pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock->pxNextFreeBlock; + } + else + { + pxBlockToInsert->pxNextFreeBlock = pxEnd; + } + } + else + { + pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock; + } + + /* If the block being inserted plugged a gap, so was merged with the block + before and the block after, then it's pxNextFreeBlock pointer will have + already been set, and should not be set here as that would make it point + to itself. */ + if( pxIterator != pxBlockToInsert ) + { + pxIterator->pxNextFreeBlock = pxBlockToInsert; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } +} +/*-----------------------------------------------------------*/ + +void vPortDefineHeapRegionsTagged( const HeapRegionTagged_t * const pxHeapRegions ) +{ +BlockLink_t *pxFirstFreeBlockInRegion = NULL, *pxPreviousFreeBlock; +uint8_t *pucAlignedHeap; +size_t xTotalRegionSize, xTotalHeapSize = 0; +BaseType_t xDefinedRegions = 0, xRegIdx = 0; +uint32_t ulAddress; +const HeapRegionTagged_t *pxHeapRegion; + + /* Can only call once! */ + configASSERT( pxEnd == NULL ); + + vPortCPUInitializeMutex(&xMallocMutex); + + pxHeapRegion = &( pxHeapRegions[ xRegIdx ] ); + + while( pxHeapRegion->xSizeInBytes > 0 ) + { + if ( pxHeapRegion->xTag == -1 ) { + /* Move onto the next HeapRegionTagged_t structure. */ + xRegIdx++; + pxHeapRegion = &( pxHeapRegions[ xRegIdx ] ); + continue; + } + + xTotalRegionSize = pxHeapRegion->xSizeInBytes; + + /* Ensure the heap region starts on a correctly aligned boundary. */ + ulAddress = ( uint32_t ) pxHeapRegion->pucStartAddress; + if( ( ulAddress & portBYTE_ALIGNMENT_MASK ) != 0 ) + { + ulAddress += ( portBYTE_ALIGNMENT - 1 ); + ulAddress &= ~portBYTE_ALIGNMENT_MASK; + + /* Adjust the size for the bytes lost to alignment. */ + xTotalRegionSize -= ulAddress - ( uint32_t ) pxHeapRegion->pucStartAddress; + } + + pucAlignedHeap = ( uint8_t * ) ulAddress; + + /* Set xStart if it has not already been set. */ + if( xDefinedRegions == 0 ) + { + /* xStart is used to hold a pointer to the first item in the list of + free blocks. The void cast is used to prevent compiler warnings. */ + xStart.pxNextFreeBlock = ( BlockLink_t * ) pucAlignedHeap; + xStart.xBlockSize = ( size_t ) 0; + } + else + { + /* Should only get here if one region has already been added to the + heap. */ + configASSERT( pxEnd != NULL ); + + /* Check blocks are passed in with increasing start addresses. */ + configASSERT( ulAddress > ( uint32_t ) pxEnd ); + } + + /* Remember the location of the end marker in the previous region, if + any. */ + pxPreviousFreeBlock = pxEnd; + + /* pxEnd is used to mark the end of the list of free blocks and is + inserted at the end of the region space. */ + ulAddress = ( ( uint32_t ) pucAlignedHeap ) + xTotalRegionSize; + ulAddress -= uxHeapStructSize; + ulAddress &= ~portBYTE_ALIGNMENT_MASK; + pxEnd = ( BlockLink_t * ) ulAddress; + pxEnd->xBlockSize = 0; + pxEnd->pxNextFreeBlock = NULL; + pxEnd->xTag = -1; + + /* To start with there is a single free block in this region that is + sized to take up the entire heap region minus the space taken by the + free block structure. */ + pxFirstFreeBlockInRegion = ( BlockLink_t * ) pucAlignedHeap; + pxFirstFreeBlockInRegion->xBlockSize = ulAddress - ( uint32_t ) pxFirstFreeBlockInRegion; + pxFirstFreeBlockInRegion->pxNextFreeBlock = pxEnd; + pxFirstFreeBlockInRegion->xTag=pxHeapRegion->xTag; + + /* If this is not the first region that makes up the entire heap space + then link the previous region to this region. */ + if( pxPreviousFreeBlock != NULL ) + { + pxPreviousFreeBlock->pxNextFreeBlock = pxFirstFreeBlockInRegion; + } + + xTotalHeapSize += pxFirstFreeBlockInRegion->xBlockSize; + + /* Move onto the next HeapRegionTagged_t structure. */ + xDefinedRegions++; + xRegIdx++; + pxHeapRegion = &( pxHeapRegions[ xRegIdx ] ); + } + + xMinimumEverFreeBytesRemaining = xTotalHeapSize; + xFreeBytesRemaining = xTotalHeapSize; + + /* Check something was actually defined before it is accessed. */ + configASSERT( xTotalHeapSize ); + + /* Work out the position of the top bit in a size_t variable. */ + xBlockAllocatedBit = ( ( size_t ) 1 ) << ( ( sizeof( size_t ) * heapBITS_PER_BYTE ) - 1 ); +} + diff --git a/components/freertos/include/freertos/FreeRTOS.h b/components/freertos/include/freertos/FreeRTOS.h new file mode 100644 index 000000000..980f53d57 --- /dev/null +++ b/components/freertos/include/freertos/FreeRTOS.h @@ -0,0 +1,791 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef INC_FREERTOS_H +#define INC_FREERTOS_H + +/* + * Include the generic headers required for the FreeRTOS port being used. + */ +#include + +/* + * If stdint.h cannot be located then: + * + If using GCC ensure the -nostdint options is *not* being used. + * + Ensure the project's include path includes the directory in which your + * compiler stores stdint.h. + * + Set any compiler options necessary for it to support C99, as technically + * stdint.h is only mandatory with C99 (FreeRTOS does not require C99 in any + * other way). + * + The FreeRTOS download includes a simple stdint.h definition that can be + * used in cases where none is provided by the compiler. The files only + * contains the typedefs required to build FreeRTOS. Read the instructions + * in FreeRTOS/source/stdint.readme for more information. + */ +#include /* READ COMMENT ABOVE. */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Application specific configuration options. */ +#include "FreeRTOSConfig.h" + +/* Basic FreeRTOS definitions. */ +#include "projdefs.h" + +/* Definitions specific to the port being used. */ +#include "portable.h" + +/* + * Check all the required application specific macros have been defined. + * These macros are application specific and (as downloaded) are defined + * within FreeRTOSConfig.h. + */ + +#ifndef configMINIMAL_STACK_SIZE + #error Missing definition: configMINIMAL_STACK_SIZE must be defined in FreeRTOSConfig.h. configMINIMAL_STACK_SIZE defines the size (in words) of the stack allocated to the idle task. Refer to the demo project provided for your port for a suitable value. +#endif + +#ifndef configMAX_PRIORITIES + #error Missing definition: configMAX_PRIORITIES must be defined in FreeRTOSConfig.h. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_PREEMPTION + #error Missing definition: configUSE_PREEMPTION must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_IDLE_HOOK + #error Missing definition: configUSE_IDLE_HOOK must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_TICK_HOOK + #error Missing definition: configUSE_TICK_HOOK must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_CO_ROUTINES + #error Missing definition: configUSE_CO_ROUTINES must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_vTaskPrioritySet + #error Missing definition: INCLUDE_vTaskPrioritySet must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_uxTaskPriorityGet + #error Missing definition: INCLUDE_uxTaskPriorityGet must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_vTaskDelete + #error Missing definition: INCLUDE_vTaskDelete must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_vTaskSuspend + #error Missing definition: INCLUDE_vTaskSuspend must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_vTaskDelayUntil + #error Missing definition: INCLUDE_vTaskDelayUntil must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef INCLUDE_vTaskDelay + #error Missing definition: INCLUDE_vTaskDelay must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_16_BIT_TICKS + #error Missing definition: configUSE_16_BIT_TICKS must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#if configUSE_CO_ROUTINES != 0 + #ifndef configMAX_CO_ROUTINE_PRIORITIES + #error configMAX_CO_ROUTINE_PRIORITIES must be greater than or equal to 1. + #endif +#endif + +#ifndef configMAX_PRIORITIES + #error configMAX_PRIORITIES must be defined to be greater than or equal to 1. +#endif + +#ifndef INCLUDE_xTaskGetIdleTaskHandle + #define INCLUDE_xTaskGetIdleTaskHandle 0 +#endif + +#ifndef INCLUDE_xTimerGetTimerDaemonTaskHandle + #define INCLUDE_xTimerGetTimerDaemonTaskHandle 0 +#endif + +#ifndef INCLUDE_xQueueGetMutexHolder + #define INCLUDE_xQueueGetMutexHolder 0 +#endif + +#ifndef INCLUDE_xSemaphoreGetMutexHolder + #define INCLUDE_xSemaphoreGetMutexHolder INCLUDE_xQueueGetMutexHolder +#endif + +#ifndef INCLUDE_pcTaskGetTaskName + #define INCLUDE_pcTaskGetTaskName 0 +#endif + +#ifndef configUSE_APPLICATION_TASK_TAG + #define configUSE_APPLICATION_TASK_TAG 0 +#endif + +#ifndef INCLUDE_uxTaskGetStackHighWaterMark + #define INCLUDE_uxTaskGetStackHighWaterMark 0 +#endif + +#ifndef INCLUDE_eTaskGetState + #define INCLUDE_eTaskGetState 0 +#endif + +#ifndef configUSE_RECURSIVE_MUTEXES + #define configUSE_RECURSIVE_MUTEXES 0 +#endif + +#ifndef configUSE_MUTEXES + #define configUSE_MUTEXES 0 +#endif + +#ifndef configUSE_TIMERS + #define configUSE_TIMERS 0 +#endif + +#ifndef configUSE_COUNTING_SEMAPHORES + #define configUSE_COUNTING_SEMAPHORES 0 +#endif + +#ifndef configUSE_ALTERNATIVE_API + #define configUSE_ALTERNATIVE_API 0 +#endif + +#ifndef portCRITICAL_NESTING_IN_TCB + #define portCRITICAL_NESTING_IN_TCB 0 +#endif + +#ifndef configMAX_TASK_NAME_LEN + #define configMAX_TASK_NAME_LEN 16 +#endif + +#ifndef configIDLE_SHOULD_YIELD + #define configIDLE_SHOULD_YIELD 1 +#endif + +#if configMAX_TASK_NAME_LEN < 1 + #error configMAX_TASK_NAME_LEN must be set to a minimum of 1 in FreeRTOSConfig.h +#endif + +#ifndef INCLUDE_xTaskResumeFromISR + #define INCLUDE_xTaskResumeFromISR 1 +#endif + +#ifndef INCLUDE_xEventGroupSetBitFromISR + #define INCLUDE_xEventGroupSetBitFromISR 0 +#endif + +#ifndef INCLUDE_xTimerPendFunctionCall + #define INCLUDE_xTimerPendFunctionCall 0 +#endif + +#ifndef configASSERT + #define configASSERT( x ) + #define configASSERT_DEFINED 0 +#else + #define configASSERT_DEFINED 1 +#endif + +/* The timers module relies on xTaskGetSchedulerState(). */ +#if configUSE_TIMERS == 1 + + #ifndef configTIMER_TASK_PRIORITY + #error If configUSE_TIMERS is set to 1 then configTIMER_TASK_PRIORITY must also be defined. + #endif /* configTIMER_TASK_PRIORITY */ + + #ifndef configTIMER_QUEUE_LENGTH + #error If configUSE_TIMERS is set to 1 then configTIMER_QUEUE_LENGTH must also be defined. + #endif /* configTIMER_QUEUE_LENGTH */ + + #ifndef configTIMER_TASK_STACK_DEPTH + #error If configUSE_TIMERS is set to 1 then configTIMER_TASK_STACK_DEPTH must also be defined. + #endif /* configTIMER_TASK_STACK_DEPTH */ + +#endif /* configUSE_TIMERS */ + +#ifndef INCLUDE_xTaskGetSchedulerState + #define INCLUDE_xTaskGetSchedulerState 0 +#endif + +#ifndef INCLUDE_xTaskGetCurrentTaskHandle + #define INCLUDE_xTaskGetCurrentTaskHandle 0 +#endif + + +#ifndef portSET_INTERRUPT_MASK_FROM_ISR + #define portSET_INTERRUPT_MASK_FROM_ISR() 0 +#endif + +#ifndef portCLEAR_INTERRUPT_MASK_FROM_ISR + #define portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedStatusValue ) ( void ) uxSavedStatusValue +#endif + +#ifndef portCLEAN_UP_TCB + #define portCLEAN_UP_TCB( pxTCB ) ( void ) pxTCB +#endif + +#ifndef portPRE_TASK_DELETE_HOOK + #define portPRE_TASK_DELETE_HOOK( pvTaskToDelete, pxYieldPending ) +#endif + +#ifndef portSETUP_TCB + #define portSETUP_TCB( pxTCB ) ( void ) pxTCB +#endif + +#ifndef configQUEUE_REGISTRY_SIZE + #define configQUEUE_REGISTRY_SIZE 0U +#endif + +#if ( configQUEUE_REGISTRY_SIZE < 1 ) + #define vQueueAddToRegistry( xQueue, pcName ) + #define vQueueUnregisterQueue( xQueue ) +#endif + +#ifndef portPOINTER_SIZE_TYPE + #define portPOINTER_SIZE_TYPE uint32_t +#endif + +/* Remove any unused trace macros. */ +#ifndef traceSTART + /* Used to perform any necessary initialisation - for example, open a file + into which trace is to be written. */ + #define traceSTART() +#endif + +#ifndef traceEND + /* Use to close a trace, for example close a file into which trace has been + written. */ + #define traceEND() +#endif + +#ifndef traceTASK_SWITCHED_IN + /* Called after a task has been selected to run. pxCurrentTCB holds a pointer + to the task control block of the selected task. */ + #define traceTASK_SWITCHED_IN() +#endif + +#ifndef traceINCREASE_TICK_COUNT + /* Called before stepping the tick count after waking from tickless idle + sleep. */ + #define traceINCREASE_TICK_COUNT( x ) +#endif + +#ifndef traceLOW_POWER_IDLE_BEGIN + /* Called immediately before entering tickless idle. */ + #define traceLOW_POWER_IDLE_BEGIN() +#endif + +#ifndef traceLOW_POWER_IDLE_END + /* Called when returning to the Idle task after a tickless idle. */ + #define traceLOW_POWER_IDLE_END() +#endif + +#ifndef traceTASK_SWITCHED_OUT + /* Called before a task has been selected to run. pxCurrentTCB holds a pointer + to the task control block of the task being switched out. */ + #define traceTASK_SWITCHED_OUT() +#endif + +#ifndef traceTASK_PRIORITY_INHERIT + /* Called when a task attempts to take a mutex that is already held by a + lower priority task. pxTCBOfMutexHolder is a pointer to the TCB of the task + that holds the mutex. uxInheritedPriority is the priority the mutex holder + will inherit (the priority of the task that is attempting to obtain the + muted. */ + #define traceTASK_PRIORITY_INHERIT( pxTCBOfMutexHolder, uxInheritedPriority ) +#endif + +#ifndef traceTASK_PRIORITY_DISINHERIT + /* Called when a task releases a mutex, the holding of which had resulted in + the task inheriting the priority of a higher priority task. + pxTCBOfMutexHolder is a pointer to the TCB of the task that is releasing the + mutex. uxOriginalPriority is the task's configured (base) priority. */ + #define traceTASK_PRIORITY_DISINHERIT( pxTCBOfMutexHolder, uxOriginalPriority ) +#endif + +#ifndef traceBLOCKING_ON_QUEUE_RECEIVE + /* Task is about to block because it cannot read from a + queue/mutex/semaphore. pxQueue is a pointer to the queue/mutex/semaphore + upon which the read was attempted. pxCurrentTCB points to the TCB of the + task that attempted the read. */ + #define traceBLOCKING_ON_QUEUE_RECEIVE( pxQueue ) +#endif + +#ifndef traceBLOCKING_ON_QUEUE_SEND + /* Task is about to block because it cannot write to a + queue/mutex/semaphore. pxQueue is a pointer to the queue/mutex/semaphore + upon which the write was attempted. pxCurrentTCB points to the TCB of the + task that attempted the write. */ + #define traceBLOCKING_ON_QUEUE_SEND( pxQueue ) +#endif + +#ifndef configCHECK_FOR_STACK_OVERFLOW + #define configCHECK_FOR_STACK_OVERFLOW 0 +#endif + +/* The following event macros are embedded in the kernel API calls. */ + +#ifndef traceMOVED_TASK_TO_READY_STATE + #define traceMOVED_TASK_TO_READY_STATE( pxTCB ) +#endif + +#ifndef traceQUEUE_CREATE + #define traceQUEUE_CREATE( pxNewQueue ) +#endif + +#ifndef traceQUEUE_CREATE_FAILED + #define traceQUEUE_CREATE_FAILED( ucQueueType ) +#endif + +#ifndef traceCREATE_MUTEX + #define traceCREATE_MUTEX( pxNewQueue ) +#endif + +#ifndef traceCREATE_MUTEX_FAILED + #define traceCREATE_MUTEX_FAILED() +#endif + +#ifndef traceGIVE_MUTEX_RECURSIVE + #define traceGIVE_MUTEX_RECURSIVE( pxMutex ) +#endif + +#ifndef traceGIVE_MUTEX_RECURSIVE_FAILED + #define traceGIVE_MUTEX_RECURSIVE_FAILED( pxMutex ) +#endif + +#ifndef traceTAKE_MUTEX_RECURSIVE + #define traceTAKE_MUTEX_RECURSIVE( pxMutex ) +#endif + +#ifndef traceTAKE_MUTEX_RECURSIVE_FAILED + #define traceTAKE_MUTEX_RECURSIVE_FAILED( pxMutex ) +#endif + +#ifndef traceCREATE_COUNTING_SEMAPHORE + #define traceCREATE_COUNTING_SEMAPHORE() +#endif + +#ifndef traceCREATE_COUNTING_SEMAPHORE_FAILED + #define traceCREATE_COUNTING_SEMAPHORE_FAILED() +#endif + +#ifndef traceQUEUE_SEND + #define traceQUEUE_SEND( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FAILED + #define traceQUEUE_SEND_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE + #define traceQUEUE_RECEIVE( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK + #define traceQUEUE_PEEK( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK_FROM_ISR + #define traceQUEUE_PEEK_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FAILED + #define traceQUEUE_RECEIVE_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FROM_ISR + #define traceQUEUE_SEND_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FROM_ISR_FAILED + #define traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FROM_ISR + #define traceQUEUE_RECEIVE_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FROM_ISR_FAILED + #define traceQUEUE_RECEIVE_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK_FROM_ISR_FAILED + #define traceQUEUE_PEEK_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_DELETE + #define traceQUEUE_DELETE( pxQueue ) +#endif + +#ifndef traceTASK_CREATE + #define traceTASK_CREATE( pxNewTCB ) +#endif + +#ifndef traceTASK_CREATE_FAILED + #define traceTASK_CREATE_FAILED() +#endif + +#ifndef traceTASK_DELETE + #define traceTASK_DELETE( pxTaskToDelete ) +#endif + +#ifndef traceTASK_DELAY_UNTIL + #define traceTASK_DELAY_UNTIL() +#endif + +#ifndef traceTASK_DELAY + #define traceTASK_DELAY() +#endif + +#ifndef traceTASK_PRIORITY_SET + #define traceTASK_PRIORITY_SET( pxTask, uxNewPriority ) +#endif + +#ifndef traceTASK_SUSPEND + #define traceTASK_SUSPEND( pxTaskToSuspend ) +#endif + +#ifndef traceTASK_RESUME + #define traceTASK_RESUME( pxTaskToResume ) +#endif + +#ifndef traceTASK_RESUME_FROM_ISR + #define traceTASK_RESUME_FROM_ISR( pxTaskToResume ) +#endif + +#ifndef traceTASK_INCREMENT_TICK + #define traceTASK_INCREMENT_TICK( xTickCount ) +#endif + +#ifndef traceTIMER_CREATE + #define traceTIMER_CREATE( pxNewTimer ) +#endif + +#ifndef traceTIMER_CREATE_FAILED + #define traceTIMER_CREATE_FAILED() +#endif + +#ifndef traceTIMER_COMMAND_SEND + #define traceTIMER_COMMAND_SEND( xTimer, xMessageID, xMessageValueValue, xReturn ) +#endif + +#ifndef traceTIMER_EXPIRED + #define traceTIMER_EXPIRED( pxTimer ) +#endif + +#ifndef traceTIMER_COMMAND_RECEIVED + #define traceTIMER_COMMAND_RECEIVED( pxTimer, xMessageID, xMessageValue ) +#endif + +#ifndef traceMALLOC + #define traceMALLOC( pvAddress, uiSize ) +#endif + +#ifndef traceFREE + #define traceFREE( pvAddress, uiSize ) +#endif + +#ifndef traceEVENT_GROUP_CREATE + #define traceEVENT_GROUP_CREATE( xEventGroup ) +#endif + +#ifndef traceEVENT_GROUP_CREATE_FAILED + #define traceEVENT_GROUP_CREATE_FAILED() +#endif + +#ifndef traceEVENT_GROUP_SYNC_BLOCK + #define traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor ) +#endif + +#ifndef traceEVENT_GROUP_SYNC_END + #define traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred ) ( void ) xTimeoutOccurred +#endif + +#ifndef traceEVENT_GROUP_WAIT_BITS_BLOCK + #define traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor ) +#endif + +#ifndef traceEVENT_GROUP_WAIT_BITS_END + #define traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred ) ( void ) xTimeoutOccurred +#endif + +#ifndef traceEVENT_GROUP_CLEAR_BITS + #define traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear ) +#endif + +#ifndef traceEVENT_GROUP_CLEAR_BITS_FROM_ISR + #define traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear ) +#endif + +#ifndef traceEVENT_GROUP_SET_BITS + #define traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet ) +#endif + +#ifndef traceEVENT_GROUP_SET_BITS_FROM_ISR + #define traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet ) +#endif + +#ifndef traceEVENT_GROUP_DELETE + #define traceEVENT_GROUP_DELETE( xEventGroup ) +#endif + +#ifndef tracePEND_FUNC_CALL + #define tracePEND_FUNC_CALL(xFunctionToPend, pvParameter1, ulParameter2, ret) +#endif + +#ifndef tracePEND_FUNC_CALL_FROM_ISR + #define tracePEND_FUNC_CALL_FROM_ISR(xFunctionToPend, pvParameter1, ulParameter2, ret) +#endif + +#ifndef traceQUEUE_REGISTRY_ADD + #define traceQUEUE_REGISTRY_ADD(xQueue, pcQueueName) +#endif + +#ifndef configGENERATE_RUN_TIME_STATS + #define configGENERATE_RUN_TIME_STATS 0 +#endif + +#if ( configGENERATE_RUN_TIME_STATS == 1 ) + + #ifndef portCONFIGURE_TIMER_FOR_RUN_TIME_STATS + #error If configGENERATE_RUN_TIME_STATS is defined then portCONFIGURE_TIMER_FOR_RUN_TIME_STATS must also be defined. portCONFIGURE_TIMER_FOR_RUN_TIME_STATS should call a port layer function to setup a peripheral timer/counter that can then be used as the run time counter time base. + #endif /* portCONFIGURE_TIMER_FOR_RUN_TIME_STATS */ + + #ifndef portGET_RUN_TIME_COUNTER_VALUE + #ifndef portALT_GET_RUN_TIME_COUNTER_VALUE + #error If configGENERATE_RUN_TIME_STATS is defined then either portGET_RUN_TIME_COUNTER_VALUE or portALT_GET_RUN_TIME_COUNTER_VALUE must also be defined. See the examples provided and the FreeRTOS web site for more information. + #endif /* portALT_GET_RUN_TIME_COUNTER_VALUE */ + #endif /* portGET_RUN_TIME_COUNTER_VALUE */ + +#endif /* configGENERATE_RUN_TIME_STATS */ + +#ifndef portCONFIGURE_TIMER_FOR_RUN_TIME_STATS + #define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() +#endif + +#ifndef configUSE_MALLOC_FAILED_HOOK + #define configUSE_MALLOC_FAILED_HOOK 0 +#endif + +#ifndef portPRIVILEGE_BIT + #define portPRIVILEGE_BIT ( ( UBaseType_t ) 0x00 ) +#endif + +#ifndef portYIELD_WITHIN_API + #define portYIELD_WITHIN_API portYIELD +#endif + +#ifndef pvPortMallocAligned + #define pvPortMallocAligned( x, puxStackBuffer ) ( ( ( puxStackBuffer ) == NULL ) ? ( pvPortMalloc( ( x ) ) ) : ( puxStackBuffer ) ) +#endif + +#ifndef vPortFreeAligned + #define vPortFreeAligned( pvBlockToFree ) vPortFree( pvBlockToFree ) +#endif + +#ifndef portSUPPRESS_TICKS_AND_SLEEP + #define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) +#endif + +#ifndef configEXPECTED_IDLE_TIME_BEFORE_SLEEP + #define configEXPECTED_IDLE_TIME_BEFORE_SLEEP 2 +#endif + +#if configEXPECTED_IDLE_TIME_BEFORE_SLEEP < 2 + #error configEXPECTED_IDLE_TIME_BEFORE_SLEEP must not be less than 2 +#endif + +#ifndef configUSE_TICKLESS_IDLE + #define configUSE_TICKLESS_IDLE 0 +#endif + +#ifndef configPRE_SLEEP_PROCESSING + #define configPRE_SLEEP_PROCESSING( x ) +#endif + +#ifndef configPOST_SLEEP_PROCESSING + #define configPOST_SLEEP_PROCESSING( x ) +#endif + +#ifndef configUSE_QUEUE_SETS + #define configUSE_QUEUE_SETS 0 +#endif + +#ifndef portTASK_USES_FLOATING_POINT + #define portTASK_USES_FLOATING_POINT() +#endif + +#ifndef configUSE_TIME_SLICING + #define configUSE_TIME_SLICING 1 +#endif + +#ifndef configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS + #define configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS 0 +#endif + +#ifndef configUSE_NEWLIB_REENTRANT + #define configUSE_NEWLIB_REENTRANT 0 +#endif + +#ifndef configUSE_STATS_FORMATTING_FUNCTIONS + #define configUSE_STATS_FORMATTING_FUNCTIONS 0 +#endif + +#ifndef portASSERT_IF_INTERRUPT_PRIORITY_INVALID + #define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() +#endif + +#ifndef configUSE_TRACE_FACILITY + #define configUSE_TRACE_FACILITY 0 +#endif + +#ifndef mtCOVERAGE_TEST_MARKER + #define mtCOVERAGE_TEST_MARKER() +#endif + +#ifndef portASSERT_IF_IN_ISR + #define portASSERT_IF_IN_ISR() +#endif + +#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION + #define configUSE_PORT_OPTIMISED_TASK_SELECTION 0 +#endif + +#ifndef configAPPLICATION_ALLOCATED_HEAP + #define configAPPLICATION_ALLOCATED_HEAP 0 +#endif + +#ifndef configUSE_TASK_NOTIFICATIONS + #define configUSE_TASK_NOTIFICATIONS 1 +#endif + +#ifndef portTICK_TYPE_IS_ATOMIC + #define portTICK_TYPE_IS_ATOMIC 0 +#endif + +#if( portTICK_TYPE_IS_ATOMIC == 0 ) + /* Either variables of tick type cannot be read atomically, or + portTICK_TYPE_IS_ATOMIC was not set - map the critical sections used when + the tick count is returned to the standard critical section macros. */ + #define portTICK_TYPE_ENTER_CRITICAL(mux) portENTER_CRITICAL(mux) + #define portTICK_TYPE_EXIT_CRITICAL(mux) portEXIT_CRITICAL(mux) + #define portTICK_TYPE_SET_INTERRUPT_MASK_FROM_ISR() portSET_INTERRUPT_MASK_FROM_ISR() + #define portTICK_TYPE_CLEAR_INTERRUPT_MASK_FROM_ISR( x ) portCLEAR_INTERRUPT_MASK_FROM_ISR( ( x ) ) +#else + /* The tick type can be read atomically, so critical sections used when the + tick count is returned can be defined away. */ + #define portTICK_TYPE_ENTER_CRITICAL() + #define portTICK_TYPE_EXIT_CRITICAL() + #define portTICK_TYPE_SET_INTERRUPT_MASK_FROM_ISR() 0 + #define portTICK_TYPE_CLEAR_INTERRUPT_MASK_FROM_ISR( x ) ( void ) x +#endif + +/* Definitions to allow backward compatibility with FreeRTOS versions prior to +V8 if desired. */ +#ifndef configENABLE_BACKWARD_COMPATIBILITY + #define configENABLE_BACKWARD_COMPATIBILITY 1 +#endif + +#if configENABLE_BACKWARD_COMPATIBILITY == 1 + #define eTaskStateGet eTaskGetState + #define portTickType TickType_t + #define xTaskHandle TaskHandle_t + #define xQueueHandle QueueHandle_t + #define xSemaphoreHandle SemaphoreHandle_t + #define xQueueSetHandle QueueSetHandle_t + #define xQueueSetMemberHandle QueueSetMemberHandle_t + #define xTimeOutType TimeOut_t + #define xMemoryRegion MemoryRegion_t + #define xTaskParameters TaskParameters_t + #define xTaskStatusType TaskStatus_t + #define xTimerHandle TimerHandle_t + #define xCoRoutineHandle CoRoutineHandle_t + #define pdTASK_HOOK_CODE TaskHookFunction_t + #define portTICK_RATE_MS portTICK_PERIOD_MS + + /* Backward compatibility within the scheduler code only - these definitions + are not really required but are included for completeness. */ + #define tmrTIMER_CALLBACK TimerCallbackFunction_t + #define pdTASK_CODE TaskFunction_t + #define xListItem ListItem_t + #define xList List_t +#endif /* configENABLE_BACKWARD_COMPATIBILITY */ + +#ifdef __cplusplus +} +#endif + +#endif /* INC_FREERTOS_H */ + diff --git a/components/freertos/include/freertos/FreeRTOSConfig.h b/components/freertos/include/freertos/FreeRTOSConfig.h new file mode 100644 index 000000000..9ac985823 --- /dev/null +++ b/components/freertos/include/freertos/FreeRTOSConfig.h @@ -0,0 +1,244 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef FREERTOS_CONFIG_H +#define FREERTOS_CONFIG_H + +#include "sdkconfig.h" + + +/* ESP31 and ESP32 are dualcore processors. */ +#ifndef CONFIG_FREERTOS_UNICORE +#define portNUM_PROCESSORS 2 +#else +#define portNUM_PROCESSORS 1 +#endif + +#define XT_USE_THREAD_SAFE_CLIB 0 +#define configASSERT_2 0 +#define portUSING_MPU_WRAPPERS 0 +#define configUSE_MUTEX 1 +#undef XT_USE_SWPRI + +#if CONFIG_FREERTOS_CORETIMER_0 +#define XT_TIMER_INDEX 0 +#elif CONFIG_FREERTOS_CORETIMER_1 +#define XT_TIMER_INDEX 1 +#elif CONFIG_FREERTOS_CORETIMER_2 +#define XT_TIMER_INDEX 2 +#elif CONFIG_FREERTOS_CORETIMER_3 +#define XT_TIMER_INDEX 3 +#endif + +#define configNUM_THREAD_LOCAL_STORAGE_POINTERS CONFIG_FREERTOS_THREAD_LOCAL_STORAGE_POINTERS + +#define XT_CLOCK_FREQ 13000000 + +/* Required for configuration-dependent settings */ +#include "xtensa_config.h" + + +#if 1 +#ifndef __ASSEMBLER__ +#include "rom/ets_sys.h" +#define configASSERT(a) if (!(a)) ets_printf("%s:%d (%s)- assert failed!\n", __FILE__, __LINE__, __FUNCTION__) +#endif +#endif + + +/*----------------------------------------------------------- + * Application specific definitions. + * + * These definitions should be adjusted for your particular hardware and + * application requirements. + * + * Note that the default heap size is deliberately kept small so that + * the build is more likely to succeed for configurations with limited + * memory. + * + * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE + * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE. + *----------------------------------------------------------*/ + +#define configUSE_PREEMPTION 1 +#define configUSE_IDLE_HOOK 0 + +#define configUSE_TICK_HOOK 0 + +#define configTICK_RATE_HZ ( CONFIG_FREERTOS_HZ ) + +/* Default clock rate for simulator */ +//#define configCPU_CLOCK_HZ 80000000 + +/* This has impact on speed of search for highest priority */ +#ifdef SMALL_TEST +#define configMAX_PRIORITIES ( 7 ) +#else +#define configMAX_PRIORITIES ( 25 ) +#endif + +/* Minimal stack size. This may need to be increased for your application */ +/* NOTE: The FreeRTOS demos may not work reliably with stack size < 4KB. */ +/* The Xtensa-specific examples should be fine with XT_STACK_MIN_SIZE. */ +#if !(defined XT_STACK_MIN_SIZE) +#error XT_STACK_MIN_SIZE not defined, did you include xtensa_config.h ? +#endif + +#define configMINIMAL_STACK_SIZE (XT_STACK_MIN_SIZE > 1024 ? XT_STACK_MIN_SIZE : 1024) + +/* The Xtensa port uses a separate interrupt stack. Adjust the stack size */ +/* to suit the needs of your specific application. */ +#ifndef configISR_STACK_SIZE +#define configISR_STACK_SIZE 1024//2048 +#endif + +/* Minimal heap size to make sure examples can run on memory limited + configs. Adjust this to suit your system. */ + + +//We define the heap to span all of the non-statically-allocated shared RAM. ToDo: Make sure there +//is some space left for the app and main cpu when running outside of a thread. +#define configAPPLICATION_ALLOCATED_HEAP 1 +#define configTOTAL_HEAP_SIZE (&_heap_end - &_heap_start)//( ( size_t ) (64 * 1024) ) + +#define configMAX_TASK_NAME_LEN ( 16 ) +#define configUSE_TRACE_FACILITY 0 /* Used by vTaskList in main.c */ +#define configUSE_STATS_FORMATTING_FUNCTIONS 0 /* Used by vTaskList in main.c */ +#define configUSE_TRACE_FACILITY_2 0 /* Provided by Xtensa port patch */ +#define configBENCHMARK 0 /* Provided by Xtensa port patch */ +#define configUSE_16_BIT_TICKS 0 +#define configIDLE_SHOULD_YIELD 0 +#define configQUEUE_REGISTRY_SIZE 0 + +#define configUSE_MUTEXES 1 +#define configUSE_RECURSIVE_MUTEXES 1 +#define configUSE_COUNTING_SEMAPHORES 1 + +#if CONFIG_FREERTOS_CHECK_STACKOVERFLOW_NONE +#define configCHECK_FOR_STACK_OVERFLOW 0 +#elif CONFIG_FREERTOS_CHECK_STACKOVERFLOW_PTRVAL +#define configCHECK_FOR_STACK_OVERFLOW 1 +#elif CONFIG_FREERTOS_CHECK_STACKOVERFLOW_CANARY +#define configCHECK_FOR_STACK_OVERFLOW 2 +#endif + + + + +/* Co-routine definitions. */ +#define configUSE_CO_ROUTINES 0 +#define configMAX_CO_ROUTINE_PRIORITIES ( 2 ) + +/* Set the following definitions to 1 to include the API function, or zero + to exclude the API function. */ + +#define INCLUDE_vTaskPrioritySet 1 +#define INCLUDE_uxTaskPriorityGet 1 +#define INCLUDE_vTaskDelete 1 +#define INCLUDE_vTaskCleanUpResources 0 +#define INCLUDE_vTaskSuspend 1 +#define INCLUDE_vTaskDelayUntil 1 +#define INCLUDE_vTaskDelay 1 +#define INCLUDE_uxTaskGetStackHighWaterMark 1 + +/* The priority at which the tick interrupt runs. This should probably be + kept at 1. */ +#define configKERNEL_INTERRUPT_PRIORITY 1 + +/* The maximum interrupt priority from which FreeRTOS.org API functions can + be called. Only API functions that end in ...FromISR() can be used within + interrupts. */ +#define configMAX_SYSCALL_INTERRUPT_PRIORITY XCHAL_EXCM_LEVEL + +#define configUSE_NEWLIB_REENTRANT 1 + +/* Test FreeRTOS timers (with timer task) and more. */ +/* Some files don't compile if this flag is disabled */ +#define configUSE_TIMERS 1 +#define configTIMER_TASK_PRIORITY 1 +#define configTIMER_QUEUE_LENGTH 10 +#define configTIMER_TASK_STACK_DEPTH configMINIMAL_STACK_SIZE + +#define INCLUDE_xTimerPendFunctionCall 1 +#define INCLUDE_eTaskGetState 1 +#define configUSE_QUEUE_SETS 1 + +#if (!defined XT_INTEXC_HOOKS) +#define configXT_INTEXC_HOOKS 1 /* Exception hooks used by certain tests */ +#if configUSE_TRACE_FACILITY_2 +#define configASSERT_2 1 /* Specific to Xtensa port */ +#endif +#endif + +#define configXT_BOARD 1 /* Board mode */ +#define configXT_SIMULATOR 0 + + +#endif /* FREERTOS_CONFIG_H */ + diff --git a/components/freertos/include/freertos/StackMacros.h b/components/freertos/include/freertos/StackMacros.h new file mode 100644 index 000000000..50d2e198f --- /dev/null +++ b/components/freertos/include/freertos/StackMacros.h @@ -0,0 +1,184 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef STACK_MACROS_H +#define STACK_MACROS_H + +/* + * Call the stack overflow hook function if the stack of the task being swapped + * out is currently overflowed, or looks like it might have overflowed in the + * past. + * + * Setting configCHECK_FOR_STACK_OVERFLOW to 1 will cause the macro to check + * the current stack state only - comparing the current top of stack value to + * the stack limit. Setting configCHECK_FOR_STACK_OVERFLOW to greater than 1 + * will also cause the last few stack bytes to be checked to ensure the value + * to which the bytes were set when the task was created have not been + * overwritten. Note this second test does not guarantee that an overflowed + * stack will always be recognised. + */ + +/*-----------------------------------------------------------*/ + +#if( configCHECK_FOR_STACK_OVERFLOW == 0 ) + + /* FreeRTOSConfig.h is not set to check for stack overflows. */ + #define taskFIRST_CHECK_FOR_STACK_OVERFLOW() + #define taskSECOND_CHECK_FOR_STACK_OVERFLOW() + +#endif /* configCHECK_FOR_STACK_OVERFLOW == 0 */ +/*-----------------------------------------------------------*/ + +#if( configCHECK_FOR_STACK_OVERFLOW == 1 ) + + /* FreeRTOSConfig.h is only set to use the first method of + overflow checking. */ + #define taskSECOND_CHECK_FOR_STACK_OVERFLOW() + +#endif +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 0 ) && ( portSTACK_GROWTH < 0 ) ) + + /* Only the current stack state is to be checked. */ + #define taskFIRST_CHECK_FOR_STACK_OVERFLOW() \ + { \ + /* Is the currently saved stack pointer within the stack limit? */ \ + if( pxCurrentTCB[ xPortGetCoreID() ]->pxTopOfStack <= pxCurrentTCB[ xPortGetCoreID() ]->pxStack ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB[ xPortGetCoreID() ], pxCurrentTCB[ xPortGetCoreID() ]->pcTaskName ); \ + } \ + } + +#endif /* configCHECK_FOR_STACK_OVERFLOW > 0 */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 0 ) && ( portSTACK_GROWTH > 0 ) ) + + /* Only the current stack state is to be checked. */ + #define taskFIRST_CHECK_FOR_STACK_OVERFLOW() \ + { \ + \ + /* Is the currently saved stack pointer within the stack limit? */ \ + if( pxCurrentTCB[ xPortGetCoreID() ]->pxTopOfStack >= pxCurrentTCB[ xPortGetCoreID() ]->pxEndOfStack ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB[ xPortGetCoreID() ], pxCurrentTCB[ xPortGetCoreID() ]->pcTaskName ); \ + } \ + } + +#endif /* configCHECK_FOR_STACK_OVERFLOW == 1 */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) && ( portSTACK_GROWTH < 0 ) ) + + #define taskSECOND_CHECK_FOR_STACK_OVERFLOW() \ + { \ + static const uint8_t ucExpectedStackBytes[] = { tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE }; \ + \ + \ + /* Has the extremity of the task stack ever been written over? */ \ + if( memcmp( ( void * ) pxCurrentTCB[ xPortGetCoreID() ]->pxStack, ( void * ) ucExpectedStackBytes, sizeof( ucExpectedStackBytes ) ) != 0 ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB[ xPortGetCoreID() ], pxCurrentTCB[ xPortGetCoreID() ]->pcTaskName ); \ + } \ + } + +#endif /* #if( configCHECK_FOR_STACK_OVERFLOW > 1 ) */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) && ( portSTACK_GROWTH > 0 ) ) + + #define taskSECOND_CHECK_FOR_STACK_OVERFLOW() \ + { \ + int8_t *pcEndOfStack = ( int8_t * ) pxCurrentTCB[ xPortGetCoreID() ]->pxEndOfStack; \ + static const uint8_t ucExpectedStackBytes[] = { tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE }; \ + \ + \ + pcEndOfStack -= sizeof( ucExpectedStackBytes ); \ + \ + /* Has the extremity of the task stack ever been written over? */ \ + if( memcmp( ( void * ) pcEndOfStack, ( void * ) ucExpectedStackBytes, sizeof( ucExpectedStackBytes ) ) != 0 ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB[ xPortGetCoreID() ], pxCurrentTCB[ xPortGetCoreID() ]->pcTaskName ); \ + } \ + } + +#endif /* #if( configCHECK_FOR_STACK_OVERFLOW > 1 ) */ +/*-----------------------------------------------------------*/ + +#endif /* STACK_MACROS_H */ + diff --git a/components/freertos/include/freertos/croutine.h b/components/freertos/include/freertos/croutine.h new file mode 100644 index 000000000..7dfd4b8c3 --- /dev/null +++ b/components/freertos/include/freertos/croutine.h @@ -0,0 +1,762 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef CO_ROUTINE_H +#define CO_ROUTINE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h must appear in source files before include croutine.h" +#endif + +#include "list.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* Used to hide the implementation of the co-routine control block. The +control block structure however has to be included in the header due to +the macro implementation of the co-routine functionality. */ +typedef void * CoRoutineHandle_t; + +/* Defines the prototype to which co-routine functions must conform. */ +typedef void (*crCOROUTINE_CODE)( CoRoutineHandle_t, UBaseType_t ); + +typedef struct corCoRoutineControlBlock +{ + crCOROUTINE_CODE pxCoRoutineFunction; + ListItem_t xGenericListItem; /*< List item used to place the CRCB in ready and blocked queues. */ + ListItem_t xEventListItem; /*< List item used to place the CRCB in event lists. */ + UBaseType_t uxPriority; /*< The priority of the co-routine in relation to other co-routines. */ + UBaseType_t uxIndex; /*< Used to distinguish between co-routines when multiple co-routines use the same co-routine function. */ + uint16_t uxState; /*< Used internally by the co-routine implementation. */ +} CRCB_t; /* Co-routine control block. Note must be identical in size down to uxPriority with TCB_t. */ + +/** + * croutine. h + *
+ BaseType_t xCoRoutineCreate(
+                                 crCOROUTINE_CODE pxCoRoutineCode,
+                                 UBaseType_t uxPriority,
+                                 UBaseType_t uxIndex
+                               );
+ * + * Create a new co-routine and add it to the list of co-routines that are + * ready to run. + * + * @param pxCoRoutineCode Pointer to the co-routine function. Co-routine + * functions require special syntax - see the co-routine section of the WEB + * documentation for more information. + * + * @param uxPriority The priority with respect to other co-routines at which + * the co-routine will run. + * + * @param uxIndex Used to distinguish between different co-routines that + * execute the same function. See the example below and the co-routine section + * of the WEB documentation for further information. + * + * @return pdPASS if the co-routine was successfully created and added to a ready + * list, otherwise an error code defined with ProjDefs.h. + * + * Example usage: +
+ // Co-routine to be created.
+ void vFlashCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ // This may not be necessary for const variables.
+ static const char cLedToFlash[ 2 ] = { 5, 6 };
+ static const TickType_t uxFlashRates[ 2 ] = { 200, 400 };
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // This co-routine just delays for a fixed period, then toggles
+         // an LED.  Two co-routines are created using this function, so
+         // the uxIndex parameter is used to tell the co-routine which
+         // LED to flash and how int32_t to delay.  This assumes xQueue has
+         // already been created.
+         vParTestToggleLED( cLedToFlash[ uxIndex ] );
+         crDELAY( xHandle, uxFlashRates[ uxIndex ] );
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+
+ // Function that creates two co-routines.
+ void vOtherFunction( void )
+ {
+ uint8_t ucParameterToPass;
+ TaskHandle_t xHandle;
+
+     // Create two co-routines at priority 0.  The first is given index 0
+     // so (from the code above) toggles LED 5 every 200 ticks.  The second
+     // is given index 1 so toggles LED 6 every 400 ticks.
+     for( uxIndex = 0; uxIndex < 2; uxIndex++ )
+     {
+         xCoRoutineCreate( vFlashCoRoutine, 0, uxIndex );
+     }
+ }
+   
+ * \defgroup xCoRoutineCreate xCoRoutineCreate + * \ingroup Tasks + */ +BaseType_t xCoRoutineCreate( crCOROUTINE_CODE pxCoRoutineCode, UBaseType_t uxPriority, UBaseType_t uxIndex ); + + +/** + * croutine. h + *
+ void vCoRoutineSchedule( void );
+ * + * Run a co-routine. + * + * vCoRoutineSchedule() executes the highest priority co-routine that is able + * to run. The co-routine will execute until it either blocks, yields or is + * preempted by a task. Co-routines execute cooperatively so one + * co-routine cannot be preempted by another, but can be preempted by a task. + * + * If an application comprises of both tasks and co-routines then + * vCoRoutineSchedule should be called from the idle task (in an idle task + * hook). + * + * Example usage: +
+ // This idle task hook will schedule a co-routine each time it is called.
+ // The rest of the idle task will execute between co-routine calls.
+ void vApplicationIdleHook( void )
+ {
+	vCoRoutineSchedule();
+ }
+
+ // Alternatively, if you do not require any other part of the idle task to
+ // execute, the idle task hook can call vCoRoutineScheduler() within an
+ // infinite loop.
+ void vApplicationIdleHook( void )
+ {
+    for( ;; )
+    {
+        vCoRoutineSchedule();
+    }
+ }
+ 
+ * \defgroup vCoRoutineSchedule vCoRoutineSchedule + * \ingroup Tasks + */ +void vCoRoutineSchedule( void ); + +/** + * croutine. h + *
+ crSTART( CoRoutineHandle_t xHandle );
+ * + * This macro MUST always be called at the start of a co-routine function. + * + * Example usage: +
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static int32_t ulAVariable;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+          // Co-routine functionality goes here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crSTART crSTART + * \ingroup Tasks + */ +#define crSTART( pxCRCB ) switch( ( ( CRCB_t * )( pxCRCB ) )->uxState ) { case 0: + +/** + * croutine. h + *
+ crEND();
+ * + * This macro MUST always be called at the end of a co-routine function. + * + * Example usage: +
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static int32_t ulAVariable;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+          // Co-routine functionality goes here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crSTART crSTART + * \ingroup Tasks + */ +#define crEND() } + +/* + * These macros are intended for internal use by the co-routine implementation + * only. The macros should not be used directly by application writers. + */ +#define crSET_STATE0( xHandle ) ( ( CRCB_t * )( xHandle ) )->uxState = (__LINE__ * 2); return; case (__LINE__ * 2): +#define crSET_STATE1( xHandle ) ( ( CRCB_t * )( xHandle ) )->uxState = ((__LINE__ * 2)+1); return; case ((__LINE__ * 2)+1): + +/** + * croutine. h + *
+ crDELAY( CoRoutineHandle_t xHandle, TickType_t xTicksToDelay );
+ * + * Delay a co-routine for a fixed period of time. + * + * crDELAY can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * @param xHandle The handle of the co-routine to delay. This is the xHandle + * parameter of the co-routine function. + * + * @param xTickToDelay The number of ticks that the co-routine should delay + * for. The actual amount of time this equates to is defined by + * configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant portTICK_PERIOD_MS + * can be used to convert ticks to milliseconds. + * + * Example usage: +
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ // This may not be necessary for const variables.
+ // We are to delay for 200ms.
+ static const xTickType xDelayTime = 200 / portTICK_PERIOD_MS;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+        // Delay for 200ms.
+        crDELAY( xHandle, xDelayTime );
+
+        // Do something here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crDELAY crDELAY + * \ingroup Tasks + */ +#define crDELAY( xHandle, xTicksToDelay ) \ + if( ( xTicksToDelay ) > 0 ) \ + { \ + vCoRoutineAddToDelayedList( ( xTicksToDelay ), NULL ); \ + } \ + crSET_STATE0( ( xHandle ) ); + +/** + *
+ crQUEUE_SEND(
+                  CoRoutineHandle_t xHandle,
+                  QueueHandle_t pxQueue,
+                  void *pvItemToQueue,
+                  TickType_t xTicksToWait,
+                  BaseType_t *pxResult
+             )
+ * + * The macro's crQUEUE_SEND() and crQUEUE_RECEIVE() are the co-routine + * equivalent to the xQueueSend() and xQueueReceive() functions used by tasks. + * + * crQUEUE_SEND and crQUEUE_RECEIVE can only be used from a co-routine whereas + * xQueueSend() and xQueueReceive() can only be used from tasks. + * + * crQUEUE_SEND can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xHandle The handle of the calling co-routine. This is the xHandle + * parameter of the co-routine function. + * + * @param pxQueue The handle of the queue on which the data will be posted. + * The handle is obtained as the return value when the queue is created using + * the xQueueCreate() API function. + * + * @param pvItemToQueue A pointer to the data being posted onto the queue. + * The number of bytes of each queued item is specified when the queue is + * created. This number of bytes is copied from pvItemToQueue into the queue + * itself. + * + * @param xTickToDelay The number of ticks that the co-routine should block + * to wait for space to become available on the queue, should space not be + * available immediately. The actual amount of time this equates to is defined + * by configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant + * portTICK_PERIOD_MS can be used to convert ticks to milliseconds (see example + * below). + * + * @param pxResult The variable pointed to by pxResult will be set to pdPASS if + * data was successfully posted onto the queue, otherwise it will be set to an + * error defined within ProjDefs.h. + * + * Example usage: +
+ // Co-routine function that blocks for a fixed period then posts a number onto
+ // a queue.
+ static void prvCoRoutineFlashTask( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static BaseType_t xNumberToPost = 0;
+ static BaseType_t xResult;
+
+    // Co-routines must begin with a call to crSTART().
+    crSTART( xHandle );
+
+    for( ;; )
+    {
+        // This assumes the queue has already been created.
+        crQUEUE_SEND( xHandle, xCoRoutineQueue, &xNumberToPost, NO_DELAY, &xResult );
+
+        if( xResult != pdPASS )
+        {
+            // The message was not posted!
+        }
+
+        // Increment the number to be posted onto the queue.
+        xNumberToPost++;
+
+        // Delay for 100 ticks.
+        crDELAY( xHandle, 100 );
+    }
+
+    // Co-routines must end with a call to crEND().
+    crEND();
+ }
+ * \defgroup crQUEUE_SEND crQUEUE_SEND + * \ingroup Tasks + */ +#define crQUEUE_SEND( xHandle, pxQueue, pvItemToQueue, xTicksToWait, pxResult ) \ +{ \ + *( pxResult ) = xQueueCRSend( ( pxQueue) , ( pvItemToQueue) , ( xTicksToWait ) ); \ + if( *( pxResult ) == errQUEUE_BLOCKED ) \ + { \ + crSET_STATE0( ( xHandle ) ); \ + *pxResult = xQueueCRSend( ( pxQueue ), ( pvItemToQueue ), 0 ); \ + } \ + if( *pxResult == errQUEUE_YIELD ) \ + { \ + crSET_STATE1( ( xHandle ) ); \ + *pxResult = pdPASS; \ + } \ +} + +/** + * croutine. h + *
+  crQUEUE_RECEIVE(
+                     CoRoutineHandle_t xHandle,
+                     QueueHandle_t pxQueue,
+                     void *pvBuffer,
+                     TickType_t xTicksToWait,
+                     BaseType_t *pxResult
+                 )
+ * + * The macro's crQUEUE_SEND() and crQUEUE_RECEIVE() are the co-routine + * equivalent to the xQueueSend() and xQueueReceive() functions used by tasks. + * + * crQUEUE_SEND and crQUEUE_RECEIVE can only be used from a co-routine whereas + * xQueueSend() and xQueueReceive() can only be used from tasks. + * + * crQUEUE_RECEIVE can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xHandle The handle of the calling co-routine. This is the xHandle + * parameter of the co-routine function. + * + * @param pxQueue The handle of the queue from which the data will be received. + * The handle is obtained as the return value when the queue is created using + * the xQueueCreate() API function. + * + * @param pvBuffer The buffer into which the received item is to be copied. + * The number of bytes of each queued item is specified when the queue is + * created. This number of bytes is copied into pvBuffer. + * + * @param xTickToDelay The number of ticks that the co-routine should block + * to wait for data to become available from the queue, should data not be + * available immediately. The actual amount of time this equates to is defined + * by configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant + * portTICK_PERIOD_MS can be used to convert ticks to milliseconds (see the + * crQUEUE_SEND example). + * + * @param pxResult The variable pointed to by pxResult will be set to pdPASS if + * data was successfully retrieved from the queue, otherwise it will be set to + * an error code as defined within ProjDefs.h. + * + * Example usage: +
+ // A co-routine receives the number of an LED to flash from a queue.  It
+ // blocks on the queue until the number is received.
+ static void prvCoRoutineFlashWorkTask( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static BaseType_t xResult;
+ static UBaseType_t uxLEDToFlash;
+
+    // All co-routines must start with a call to crSTART().
+    crSTART( xHandle );
+
+    for( ;; )
+    {
+        // Wait for data to become available on the queue.
+        crQUEUE_RECEIVE( xHandle, xCoRoutineQueue, &uxLEDToFlash, portMAX_DELAY, &xResult );
+
+        if( xResult == pdPASS )
+        {
+            // We received the LED to flash - flash it!
+            vParTestToggleLED( uxLEDToFlash );
+        }
+    }
+
+    crEND();
+ }
+ * \defgroup crQUEUE_RECEIVE crQUEUE_RECEIVE + * \ingroup Tasks + */ +#define crQUEUE_RECEIVE( xHandle, pxQueue, pvBuffer, xTicksToWait, pxResult ) \ +{ \ + *( pxResult ) = xQueueCRReceive( ( pxQueue) , ( pvBuffer ), ( xTicksToWait ) ); \ + if( *( pxResult ) == errQUEUE_BLOCKED ) \ + { \ + crSET_STATE0( ( xHandle ) ); \ + *( pxResult ) = xQueueCRReceive( ( pxQueue) , ( pvBuffer ), 0 ); \ + } \ + if( *( pxResult ) == errQUEUE_YIELD ) \ + { \ + crSET_STATE1( ( xHandle ) ); \ + *( pxResult ) = pdPASS; \ + } \ +} + +/** + * croutine. h + *
+  crQUEUE_SEND_FROM_ISR(
+                            QueueHandle_t pxQueue,
+                            void *pvItemToQueue,
+                            BaseType_t xCoRoutinePreviouslyWoken
+                       )
+ * + * The macro's crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() are the + * co-routine equivalent to the xQueueSendFromISR() and xQueueReceiveFromISR() + * functions used by tasks. + * + * crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() can only be used to + * pass data between a co-routine and and ISR, whereas xQueueSendFromISR() and + * xQueueReceiveFromISR() can only be used to pass data between a task and and + * ISR. + * + * crQUEUE_SEND_FROM_ISR can only be called from an ISR to send data to a queue + * that is being used from within a co-routine. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xCoRoutinePreviouslyWoken This is included so an ISR can post onto + * the same queue multiple times from a single interrupt. The first call + * should always pass in pdFALSE. Subsequent calls should pass in + * the value returned from the previous call. + * + * @return pdTRUE if a co-routine was woken by posting onto the queue. This is + * used by the ISR to determine if a context switch may be required following + * the ISR. + * + * Example usage: +
+ // A co-routine that blocks on a queue waiting for characters to be received.
+ static void vReceivingCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ char cRxedChar;
+ BaseType_t xResult;
+
+     // All co-routines must start with a call to crSTART().
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // Wait for data to become available on the queue.  This assumes the
+         // queue xCommsRxQueue has already been created!
+         crQUEUE_RECEIVE( xHandle, xCommsRxQueue, &uxLEDToFlash, portMAX_DELAY, &xResult );
+
+         // Was a character received?
+         if( xResult == pdPASS )
+         {
+             // Process the character here.
+         }
+     }
+
+     // All co-routines must end with a call to crEND().
+     crEND();
+ }
+
+ // An ISR that uses a queue to send characters received on a serial port to
+ // a co-routine.
+ void vUART_ISR( void )
+ {
+ char cRxedChar;
+ BaseType_t xCRWokenByPost = pdFALSE;
+
+     // We loop around reading characters until there are none left in the UART.
+     while( UART_RX_REG_NOT_EMPTY() )
+     {
+         // Obtain the character from the UART.
+         cRxedChar = UART_RX_REG;
+
+         // Post the character onto a queue.  xCRWokenByPost will be pdFALSE
+         // the first time around the loop.  If the post causes a co-routine
+         // to be woken (unblocked) then xCRWokenByPost will be set to pdTRUE.
+         // In this manner we can ensure that if more than one co-routine is
+         // blocked on the queue only one is woken by this ISR no matter how
+         // many characters are posted to the queue.
+         xCRWokenByPost = crQUEUE_SEND_FROM_ISR( xCommsRxQueue, &cRxedChar, xCRWokenByPost );
+     }
+ }
+ * \defgroup crQUEUE_SEND_FROM_ISR crQUEUE_SEND_FROM_ISR + * \ingroup Tasks + */ +#define crQUEUE_SEND_FROM_ISR( pxQueue, pvItemToQueue, xCoRoutinePreviouslyWoken ) xQueueCRSendFromISR( ( pxQueue ), ( pvItemToQueue ), ( xCoRoutinePreviouslyWoken ) ) + + +/** + * croutine. h + *
+  crQUEUE_SEND_FROM_ISR(
+                            QueueHandle_t pxQueue,
+                            void *pvBuffer,
+                            BaseType_t * pxCoRoutineWoken
+                       )
+ * + * The macro's crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() are the + * co-routine equivalent to the xQueueSendFromISR() and xQueueReceiveFromISR() + * functions used by tasks. + * + * crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() can only be used to + * pass data between a co-routine and and ISR, whereas xQueueSendFromISR() and + * xQueueReceiveFromISR() can only be used to pass data between a task and and + * ISR. + * + * crQUEUE_RECEIVE_FROM_ISR can only be called from an ISR to receive data + * from a queue that is being used from within a co-routine (a co-routine + * posted to the queue). + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvBuffer A pointer to a buffer into which the received item will be + * placed. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from the queue into + * pvBuffer. + * + * @param pxCoRoutineWoken A co-routine may be blocked waiting for space to become + * available on the queue. If crQUEUE_RECEIVE_FROM_ISR causes such a + * co-routine to unblock *pxCoRoutineWoken will get set to pdTRUE, otherwise + * *pxCoRoutineWoken will remain unchanged. + * + * @return pdTRUE an item was successfully received from the queue, otherwise + * pdFALSE. + * + * Example usage: +
+ // A co-routine that posts a character to a queue then blocks for a fixed
+ // period.  The character is incremented each time.
+ static void vSendingCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // cChar holds its value while this co-routine is blocked and must therefore
+ // be declared static.
+ static char cCharToTx = 'a';
+ BaseType_t xResult;
+
+     // All co-routines must start with a call to crSTART().
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // Send the next character to the queue.
+         crQUEUE_SEND( xHandle, xCoRoutineQueue, &cCharToTx, NO_DELAY, &xResult );
+
+         if( xResult == pdPASS )
+         {
+             // The character was successfully posted to the queue.
+         }
+		 else
+		 {
+			// Could not post the character to the queue.
+		 }
+
+         // Enable the UART Tx interrupt to cause an interrupt in this
+		 // hypothetical UART.  The interrupt will obtain the character
+		 // from the queue and send it.
+		 ENABLE_RX_INTERRUPT();
+
+		 // Increment to the next character then block for a fixed period.
+		 // cCharToTx will maintain its value across the delay as it is
+		 // declared static.
+		 cCharToTx++;
+		 if( cCharToTx > 'x' )
+		 {
+			cCharToTx = 'a';
+		 }
+		 crDELAY( 100 );
+     }
+
+     // All co-routines must end with a call to crEND().
+     crEND();
+ }
+
+ // An ISR that uses a queue to receive characters to send on a UART.
+ void vUART_ISR( void )
+ {
+ char cCharToTx;
+ BaseType_t xCRWokenByPost = pdFALSE;
+
+     while( UART_TX_REG_EMPTY() )
+     {
+         // Are there any characters in the queue waiting to be sent?
+		 // xCRWokenByPost will automatically be set to pdTRUE if a co-routine
+		 // is woken by the post - ensuring that only a single co-routine is
+		 // woken no matter how many times we go around this loop.
+         if( crQUEUE_RECEIVE_FROM_ISR( pxQueue, &cCharToTx, &xCRWokenByPost ) )
+		 {
+			 SEND_CHARACTER( cCharToTx );
+		 }
+     }
+ }
+ * \defgroup crQUEUE_RECEIVE_FROM_ISR crQUEUE_RECEIVE_FROM_ISR + * \ingroup Tasks + */ +#define crQUEUE_RECEIVE_FROM_ISR( pxQueue, pvBuffer, pxCoRoutineWoken ) xQueueCRReceiveFromISR( ( pxQueue ), ( pvBuffer ), ( pxCoRoutineWoken ) ) + +/* + * This function is intended for internal use by the co-routine macros only. + * The macro nature of the co-routine implementation requires that the + * prototype appears here. The function should not be used by application + * writers. + * + * Removes the current co-routine from its ready list and places it in the + * appropriate delayed list. + */ +void vCoRoutineAddToDelayedList( TickType_t xTicksToDelay, List_t *pxEventList ); + +/* + * This function is intended for internal use by the queue implementation only. + * The function should not be used by application writers. + * + * Removes the highest priority co-routine from the event list and places it in + * the pending ready list. + */ +BaseType_t xCoRoutineRemoveFromEventList( const List_t *pxEventList ); + +#ifdef __cplusplus +} +#endif + +#endif /* CO_ROUTINE_H */ diff --git a/components/freertos/include/freertos/deprecated_definitions.h b/components/freertos/include/freertos/deprecated_definitions.h new file mode 100644 index 000000000..fb031cdde --- /dev/null +++ b/components/freertos/include/freertos/deprecated_definitions.h @@ -0,0 +1,321 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef DEPRECATED_DEFINITIONS_H +#define DEPRECATED_DEFINITIONS_H + + +/* Each FreeRTOS port has a unique portmacro.h header file. Originally a +pre-processor definition was used to ensure the pre-processor found the correct +portmacro.h file for the port being used. That scheme was deprecated in favour +of setting the compiler's include path such that it found the correct +portmacro.h file - removing the need for the constant and allowing the +portmacro.h file to be located anywhere in relation to the port being used. The +definitions below remain in the code for backward compatibility only. New +projects should not use them. */ + +#ifdef OPEN_WATCOM_INDUSTRIAL_PC_PORT + #include "..\..\Source\portable\owatcom\16bitdos\pc\portmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef OPEN_WATCOM_FLASH_LITE_186_PORT + #include "..\..\Source\portable\owatcom\16bitdos\flsh186\portmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef GCC_MEGA_AVR + #include "../portable/GCC/ATMega323/portmacro.h" +#endif + +#ifdef IAR_MEGA_AVR + #include "../portable/IAR/ATMega323/portmacro.h" +#endif + +#ifdef MPLAB_PIC24_PORT + #include "../../Source/portable/MPLAB/PIC24_dsPIC/portmacro.h" +#endif + +#ifdef MPLAB_DSPIC_PORT + #include "../../Source/portable/MPLAB/PIC24_dsPIC/portmacro.h" +#endif + +#ifdef MPLAB_PIC18F_PORT + #include "../../Source/portable/MPLAB/PIC18F/portmacro.h" +#endif + +#ifdef MPLAB_PIC32MX_PORT + #include "../../Source/portable/MPLAB/PIC32MX/portmacro.h" +#endif + +#ifdef _FEDPICC + #include "libFreeRTOS/Include/portmacro.h" +#endif + +#ifdef SDCC_CYGNAL + #include "../../Source/portable/SDCC/Cygnal/portmacro.h" +#endif + +#ifdef GCC_ARM7 + #include "../../Source/portable/GCC/ARM7_LPC2000/portmacro.h" +#endif + +#ifdef GCC_ARM7_ECLIPSE + #include "portmacro.h" +#endif + +#ifdef ROWLEY_LPC23xx + #include "../../Source/portable/GCC/ARM7_LPC23xx/portmacro.h" +#endif + +#ifdef IAR_MSP430 + #include "..\..\Source\portable\IAR\MSP430\portmacro.h" +#endif + +#ifdef GCC_MSP430 + #include "../../Source/portable/GCC/MSP430F449/portmacro.h" +#endif + +#ifdef ROWLEY_MSP430 + #include "../../Source/portable/Rowley/MSP430F449/portmacro.h" +#endif + +#ifdef ARM7_LPC21xx_KEIL_RVDS + #include "..\..\Source\portable\RVDS\ARM7_LPC21xx\portmacro.h" +#endif + +#ifdef SAM7_GCC + #include "../../Source/portable/GCC/ARM7_AT91SAM7S/portmacro.h" +#endif + +#ifdef SAM7_IAR + #include "..\..\Source\portable\IAR\AtmelSAM7S64\portmacro.h" +#endif + +#ifdef SAM9XE_IAR + #include "..\..\Source\portable\IAR\AtmelSAM9XE\portmacro.h" +#endif + +#ifdef LPC2000_IAR + #include "..\..\Source\portable\IAR\LPC2000\portmacro.h" +#endif + +#ifdef STR71X_IAR + #include "..\..\Source\portable\IAR\STR71x\portmacro.h" +#endif + +#ifdef STR75X_IAR + #include "..\..\Source\portable\IAR\STR75x\portmacro.h" +#endif + +#ifdef STR75X_GCC + #include "..\..\Source\portable\GCC\STR75x\portmacro.h" +#endif + +#ifdef STR91X_IAR + #include "..\..\Source\portable\IAR\STR91x\portmacro.h" +#endif + +#ifdef GCC_H8S + #include "../../Source/portable/GCC/H8S2329/portmacro.h" +#endif + +#ifdef GCC_AT91FR40008 + #include "../../Source/portable/GCC/ARM7_AT91FR40008/portmacro.h" +#endif + +#ifdef RVDS_ARMCM3_LM3S102 + #include "../../Source/portable/RVDS/ARM_CM3/portmacro.h" +#endif + +#ifdef GCC_ARMCM3_LM3S102 + #include "../../Source/portable/GCC/ARM_CM3/portmacro.h" +#endif + +#ifdef GCC_ARMCM3 + #include "../../Source/portable/GCC/ARM_CM3/portmacro.h" +#endif + +#ifdef IAR_ARM_CM3 + #include "../../Source/portable/IAR/ARM_CM3/portmacro.h" +#endif + +#ifdef IAR_ARMCM3_LM + #include "../../Source/portable/IAR/ARM_CM3/portmacro.h" +#endif + +#ifdef HCS12_CODE_WARRIOR + #include "../../Source/portable/CodeWarrior/HCS12/portmacro.h" +#endif + +#ifdef MICROBLAZE_GCC + #include "../../Source/portable/GCC/MicroBlaze/portmacro.h" +#endif + +#ifdef TERN_EE + #include "..\..\Source\portable\Paradigm\Tern_EE\small\portmacro.h" +#endif + +#ifdef GCC_HCS12 + #include "../../Source/portable/GCC/HCS12/portmacro.h" +#endif + +#ifdef GCC_MCF5235 + #include "../../Source/portable/GCC/MCF5235/portmacro.h" +#endif + +#ifdef COLDFIRE_V2_GCC + #include "../../../Source/portable/GCC/ColdFire_V2/portmacro.h" +#endif + +#ifdef COLDFIRE_V2_CODEWARRIOR + #include "../../Source/portable/CodeWarrior/ColdFire_V2/portmacro.h" +#endif + +#ifdef GCC_PPC405 + #include "../../Source/portable/GCC/PPC405_Xilinx/portmacro.h" +#endif + +#ifdef GCC_PPC440 + #include "../../Source/portable/GCC/PPC440_Xilinx/portmacro.h" +#endif + +#ifdef _16FX_SOFTUNE + #include "..\..\Source\portable\Softune\MB96340\portmacro.h" +#endif + +#ifdef BCC_INDUSTRIAL_PC_PORT + /* A short file name has to be used in place of the normal + FreeRTOSConfig.h when using the Borland compiler. */ + #include "frconfig.h" + #include "..\portable\BCC\16BitDOS\PC\prtmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef BCC_FLASH_LITE_186_PORT + /* A short file name has to be used in place of the normal + FreeRTOSConfig.h when using the Borland compiler. */ + #include "frconfig.h" + #include "..\portable\BCC\16BitDOS\flsh186\prtmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef __GNUC__ + #ifdef __AVR32_AVR32A__ + #include "portmacro.h" + #endif +#endif + +#ifdef __ICCAVR32__ + #ifdef __CORE__ + #if __CORE__ == __AVR32A__ + #include "portmacro.h" + #endif + #endif +#endif + +#ifdef __91467D + #include "portmacro.h" +#endif + +#ifdef __96340 + #include "portmacro.h" +#endif + + +#ifdef __IAR_V850ES_Fx3__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx3__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx3_L__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx2__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Hx2__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_78K0R_Kx3__ + #include "../../Source/portable/IAR/78K0R/portmacro.h" +#endif + +#ifdef __IAR_78K0R_Kx3L__ + #include "../../Source/portable/IAR/78K0R/portmacro.h" +#endif + +#endif /* DEPRECATED_DEFINITIONS_H */ + diff --git a/components/freertos/include/freertos/event_groups.h b/components/freertos/include/freertos/event_groups.h new file mode 100644 index 000000000..c7d0156ab --- /dev/null +++ b/components/freertos/include/freertos/event_groups.h @@ -0,0 +1,730 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef EVENT_GROUPS_H +#define EVENT_GROUPS_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include event_groups.h" +#endif + +#include "timers.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * An event group is a collection of bits to which an application can assign a + * meaning. For example, an application may create an event group to convey + * the status of various CAN bus related events in which bit 0 might mean "A CAN + * message has been received and is ready for processing", bit 1 might mean "The + * application has queued a message that is ready for sending onto the CAN + * network", and bit 2 might mean "It is time to send a SYNC message onto the + * CAN network" etc. A task can then test the bit values to see which events + * are active, and optionally enter the Blocked state to wait for a specified + * bit or a group of specified bits to be active. To continue the CAN bus + * example, a CAN controlling task can enter the Blocked state (and therefore + * not consume any processing time) until either bit 0, bit 1 or bit 2 are + * active, at which time the bit that was actually active would inform the task + * which action it had to take (process a received message, send a message, or + * send a SYNC). + * + * The event groups implementation contains intelligence to avoid race + * conditions that would otherwise occur were an application to use a simple + * variable for the same purpose. This is particularly important with respect + * to when a bit within an event group is to be cleared, and when bits have to + * be set and then tested atomically - as is the case where event groups are + * used to create a synchronisation point between multiple tasks (a + * 'rendezvous'). + * + * \defgroup EventGroup + */ + + + +/** + * event_groups.h + * + * Type by which event groups are referenced. For example, a call to + * xEventGroupCreate() returns an EventGroupHandle_t variable that can then + * be used as a parameter to other event group functions. + * + * \defgroup EventGroupHandle_t EventGroupHandle_t + * \ingroup EventGroup + */ +typedef void * EventGroupHandle_t; + +/* + * The type that holds event bits always matches TickType_t - therefore the + * number of bits it holds is set by configUSE_16_BIT_TICKS (16 bits if set to 1, + * 32 bits if set to 0. + * + * \defgroup EventBits_t EventBits_t + * \ingroup EventGroup + */ +typedef TickType_t EventBits_t; + +/** + * event_groups.h + *
+ EventGroupHandle_t xEventGroupCreate( void );
+ 
+ * + * Create a new event group. This function cannot be called from an interrupt. + * + * Although event groups are not related to ticks, for internal implementation + * reasons the number of bits available for use in an event group is dependent + * on the configUSE_16_BIT_TICKS setting in FreeRTOSConfig.h. If + * configUSE_16_BIT_TICKS is 1 then each event group contains 8 usable bits (bit + * 0 to bit 7). If configUSE_16_BIT_TICKS is set to 0 then each event group has + * 24 usable bits (bit 0 to bit 23). The EventBits_t type is used to store + * event bits within an event group. + * + * @return If the event group was created then a handle to the event group is + * returned. If there was insufficient FreeRTOS heap available to create the + * event group then NULL is returned. See http://www.freertos.org/a00111.html + * + * Example usage: +
+	// Declare a variable to hold the created event group.
+	EventGroupHandle_t xCreatedEventGroup;
+
+	// Attempt to create the event group.
+	xCreatedEventGroup = xEventGroupCreate();
+
+	// Was the event group created successfully?
+	if( xCreatedEventGroup == NULL )
+	{
+		// The event group was not created because there was insufficient
+		// FreeRTOS heap available.
+	}
+	else
+	{
+		// The event group was created.
+	}
+   
+ * \defgroup xEventGroupCreate xEventGroupCreate + * \ingroup EventGroup + */ +EventGroupHandle_t xEventGroupCreate( void ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	EventBits_t xEventGroupWaitBits( 	EventGroupHandle_t xEventGroup,
+										const EventBits_t uxBitsToWaitFor,
+										const BaseType_t xClearOnExit,
+										const BaseType_t xWaitForAllBits,
+										const TickType_t xTicksToWait );
+ 
+ * + * [Potentially] block to wait for one or more bits to be set within a + * previously created event group. + * + * This function cannot be called from an interrupt. + * + * @param xEventGroup The event group in which the bits are being tested. The + * event group must have previously been created using a call to + * xEventGroupCreate(). + * + * @param uxBitsToWaitFor A bitwise value that indicates the bit or bits to test + * inside the event group. For example, to wait for bit 0 and/or bit 2 set + * uxBitsToWaitFor to 0x05. To wait for bits 0 and/or bit 1 and/or bit 2 set + * uxBitsToWaitFor to 0x07. Etc. + * + * @param xClearOnExit If xClearOnExit is set to pdTRUE then any bits within + * uxBitsToWaitFor that are set within the event group will be cleared before + * xEventGroupWaitBits() returns if the wait condition was met (if the function + * returns for a reason other than a timeout). If xClearOnExit is set to + * pdFALSE then the bits set in the event group are not altered when the call to + * xEventGroupWaitBits() returns. + * + * @param xWaitForAllBits If xWaitForAllBits is set to pdTRUE then + * xEventGroupWaitBits() will return when either all the bits in uxBitsToWaitFor + * are set or the specified block time expires. If xWaitForAllBits is set to + * pdFALSE then xEventGroupWaitBits() will return when any one of the bits set + * in uxBitsToWaitFor is set or the specified block time expires. The block + * time is specified by the xTicksToWait parameter. + * + * @param xTicksToWait The maximum amount of time (specified in 'ticks') to wait + * for one/all (depending on the xWaitForAllBits value) of the bits specified by + * uxBitsToWaitFor to become set. + * + * @return The value of the event group at the time either the bits being waited + * for became set, or the block time expired. Test the return value to know + * which bits were set. If xEventGroupWaitBits() returned because its timeout + * expired then not all the bits being waited for will be set. If + * xEventGroupWaitBits() returned because the bits it was waiting for were set + * then the returned value is the event group value before any bits were + * automatically cleared in the case that xClearOnExit parameter was set to + * pdTRUE. + * + * Example usage: +
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+   const TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;
+
+		// Wait a maximum of 100ms for either bit 0 or bit 4 to be set within
+		// the event group.  Clear the bits before exiting.
+		uxBits = xEventGroupWaitBits(
+					xEventGroup,	// The event group being tested.
+					BIT_0 | BIT_4,	// The bits within the event group to wait for.
+					pdTRUE,			// BIT_0 and BIT_4 should be cleared before returning.
+					pdFALSE,		// Don't wait for both bits, either bit will do.
+					xTicksToWait );	// Wait a maximum of 100ms for either bit to be set.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// xEventGroupWaitBits() returned because both bits were set.
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// xEventGroupWaitBits() returned because just BIT_0 was set.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// xEventGroupWaitBits() returned because just BIT_4 was set.
+		}
+		else
+		{
+			// xEventGroupWaitBits() returned because xTicksToWait ticks passed
+			// without either BIT_0 or BIT_4 becoming set.
+		}
+   }
+   
+ * \defgroup xEventGroupWaitBits xEventGroupWaitBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear );
+ 
+ * + * Clear bits within an event group. This function cannot be called from an + * interrupt. + * + * @param xEventGroup The event group in which the bits are to be cleared. + * + * @param uxBitsToClear A bitwise value that indicates the bit or bits to clear + * in the event group. For example, to clear bit 3 only, set uxBitsToClear to + * 0x08. To clear bit 3 and bit 0 set uxBitsToClear to 0x09. + * + * @return The value of the event group before the specified bits were cleared. + * + * Example usage: +
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+
+		// Clear bit 0 and bit 4 in xEventGroup.
+		uxBits = xEventGroupClearBits(
+								xEventGroup,	// The event group being updated.
+								BIT_0 | BIT_4 );// The bits being cleared.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// Both bit 0 and bit 4 were set before xEventGroupClearBits() was
+			// called.  Both will now be clear (not set).
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// Bit 0 was set before xEventGroupClearBits() was called.  It will
+			// now be clear.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// Bit 4 was set before xEventGroupClearBits() was called.  It will
+			// now be clear.
+		}
+		else
+		{
+			// Neither bit 0 nor bit 4 were set in the first place.
+		}
+   }
+   
+ * \defgroup xEventGroupClearBits xEventGroupClearBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet );
+ 
+ * + * A version of xEventGroupClearBits() that can be called from an interrupt. + * + * Setting bits in an event group is not a deterministic operation because there + * are an unknown number of tasks that may be waiting for the bit or bits being + * set. FreeRTOS does not allow nondeterministic operations to be performed + * while interrupts are disabled, so protects event groups that are accessed + * from tasks by suspending the scheduler rather than disabling interrupts. As + * a result event groups cannot be accessed directly from an interrupt service + * routine. Therefore xEventGroupClearBitsFromISR() sends a message to the + * timer task to have the clear operation performed in the context of the timer + * task. + * + * @param xEventGroup The event group in which the bits are to be cleared. + * + * @param uxBitsToClear A bitwise value that indicates the bit or bits to clear. + * For example, to clear bit 3 only, set uxBitsToClear to 0x08. To clear bit 3 + * and bit 0 set uxBitsToClear to 0x09. + * + * @return If the request to execute the function was posted successfully then + * pdPASS is returned, otherwise pdFALSE is returned. pdFALSE will be returned + * if the timer service queue was full. + * + * Example usage: +
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   // An event group which it is assumed has already been created by a call to
+   // xEventGroupCreate().
+   EventGroupHandle_t xEventGroup;
+
+   void anInterruptHandler( void )
+   {
+		// Clear bit 0 and bit 4 in xEventGroup.
+		xResult = xEventGroupClearBitsFromISR(
+							xEventGroup,	 // The event group being updated.
+							BIT_0 | BIT_4 ); // The bits being set.
+
+		if( xResult == pdPASS )
+		{
+			// The message was posted successfully.
+		}
+  }
+   
+ * \defgroup xEventGroupSetBitsFromISR xEventGroupSetBitsFromISR + * \ingroup EventGroup + */ +#if( configUSE_TRACE_FACILITY == 1 ) + BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ); +#else + #define xEventGroupClearBitsFromISR( xEventGroup, uxBitsToClear ) xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL ) +#endif + +/** + * event_groups.h + *
+	EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet );
+ 
+ * + * Set bits within an event group. + * This function cannot be called from an interrupt. xEventGroupSetBitsFromISR() + * is a version that can be called from an interrupt. + * + * Setting bits in an event group will automatically unblock tasks that are + * blocked waiting for the bits. + * + * @param xEventGroup The event group in which the bits are to be set. + * + * @param uxBitsToSet A bitwise value that indicates the bit or bits to set. + * For example, to set bit 3 only, set uxBitsToSet to 0x08. To set bit 3 + * and bit 0 set uxBitsToSet to 0x09. + * + * @return The value of the event group at the time the call to + * xEventGroupSetBits() returns. There are two reasons why the returned value + * might have the bits specified by the uxBitsToSet parameter cleared. First, + * if setting a bit results in a task that was waiting for the bit leaving the + * blocked state then it is possible the bit will be cleared automatically + * (see the xClearBitOnExit parameter of xEventGroupWaitBits()). Second, any + * unblocked (or otherwise Ready state) task that has a priority above that of + * the task that called xEventGroupSetBits() will execute and may change the + * event group value before the call to xEventGroupSetBits() returns. + * + * Example usage: +
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+
+		// Set bit 0 and bit 4 in xEventGroup.
+		uxBits = xEventGroupSetBits(
+							xEventGroup,	// The event group being updated.
+							BIT_0 | BIT_4 );// The bits being set.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// Both bit 0 and bit 4 remained set when the function returned.
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// Bit 0 remained set when the function returned, but bit 4 was
+			// cleared.  It might be that bit 4 was cleared automatically as a
+			// task that was waiting for bit 4 was removed from the Blocked
+			// state.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// Bit 4 remained set when the function returned, but bit 0 was
+			// cleared.  It might be that bit 0 was cleared automatically as a
+			// task that was waiting for bit 0 was removed from the Blocked
+			// state.
+		}
+		else
+		{
+			// Neither bit 0 nor bit 4 remained set.  It might be that a task
+			// was waiting for both of the bits to be set, and the bits were
+			// cleared as the task left the Blocked state.
+		}
+   }
+   
+ * \defgroup xEventGroupSetBits xEventGroupSetBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken );
+ 
+ * + * A version of xEventGroupSetBits() that can be called from an interrupt. + * + * Setting bits in an event group is not a deterministic operation because there + * are an unknown number of tasks that may be waiting for the bit or bits being + * set. FreeRTOS does not allow nondeterministic operations to be performed in + * interrupts or from critical sections. Therefore xEventGroupSetBitFromISR() + * sends a message to the timer task to have the set operation performed in the + * context of the timer task - where a scheduler lock is used in place of a + * critical section. + * + * @param xEventGroup The event group in which the bits are to be set. + * + * @param uxBitsToSet A bitwise value that indicates the bit or bits to set. + * For example, to set bit 3 only, set uxBitsToSet to 0x08. To set bit 3 + * and bit 0 set uxBitsToSet to 0x09. + * + * @param pxHigherPriorityTaskWoken As mentioned above, calling this function + * will result in a message being sent to the timer daemon task. If the + * priority of the timer daemon task is higher than the priority of the + * currently running task (the task the interrupt interrupted) then + * *pxHigherPriorityTaskWoken will be set to pdTRUE by + * xEventGroupSetBitsFromISR(), indicating that a context switch should be + * requested before the interrupt exits. For that reason + * *pxHigherPriorityTaskWoken must be initialised to pdFALSE. See the + * example code below. + * + * @return If the request to execute the function was posted successfully then + * pdPASS is returned, otherwise pdFALSE is returned. pdFALSE will be returned + * if the timer service queue was full. + * + * Example usage: +
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   // An event group which it is assumed has already been created by a call to
+   // xEventGroupCreate().
+   EventGroupHandle_t xEventGroup;
+
+   void anInterruptHandler( void )
+   {
+   BaseType_t xHigherPriorityTaskWoken, xResult;
+
+		// xHigherPriorityTaskWoken must be initialised to pdFALSE.
+		xHigherPriorityTaskWoken = pdFALSE;
+
+		// Set bit 0 and bit 4 in xEventGroup.
+		xResult = xEventGroupSetBitsFromISR(
+							xEventGroup,	// The event group being updated.
+							BIT_0 | BIT_4   // The bits being set.
+							&xHigherPriorityTaskWoken );
+
+		// Was the message posted successfully?
+		if( xResult == pdPASS )
+		{
+			// If xHigherPriorityTaskWoken is now set to pdTRUE then a context
+			// switch should be requested.  The macro used is port specific and 
+			// will be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() - 
+			// refer to the documentation page for the port being used.
+			portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
+		}
+  }
+   
+ * \defgroup xEventGroupSetBitsFromISR xEventGroupSetBitsFromISR + * \ingroup EventGroup + */ +#if( configUSE_TRACE_FACILITY == 1 ) + BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken ); +#else + #define xEventGroupSetBitsFromISR( xEventGroup, uxBitsToSet, pxHigherPriorityTaskWoken ) xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken ) +#endif + +/** + * event_groups.h + *
+	EventBits_t xEventGroupSync(	EventGroupHandle_t xEventGroup,
+									const EventBits_t uxBitsToSet,
+									const EventBits_t uxBitsToWaitFor,
+									TickType_t xTicksToWait );
+ 
+ * + * Atomically set bits within an event group, then wait for a combination of + * bits to be set within the same event group. This functionality is typically + * used to synchronise multiple tasks, where each task has to wait for the other + * tasks to reach a synchronisation point before proceeding. + * + * This function cannot be used from an interrupt. + * + * The function will return before its block time expires if the bits specified + * by the uxBitsToWait parameter are set, or become set within that time. In + * this case all the bits specified by uxBitsToWait will be automatically + * cleared before the function returns. + * + * @param xEventGroup The event group in which the bits are being tested. The + * event group must have previously been created using a call to + * xEventGroupCreate(). + * + * @param uxBitsToSet The bits to set in the event group before determining + * if, and possibly waiting for, all the bits specified by the uxBitsToWait + * parameter are set. + * + * @param uxBitsToWaitFor A bitwise value that indicates the bit or bits to test + * inside the event group. For example, to wait for bit 0 and bit 2 set + * uxBitsToWaitFor to 0x05. To wait for bits 0 and bit 1 and bit 2 set + * uxBitsToWaitFor to 0x07. Etc. + * + * @param xTicksToWait The maximum amount of time (specified in 'ticks') to wait + * for all of the bits specified by uxBitsToWaitFor to become set. + * + * @return The value of the event group at the time either the bits being waited + * for became set, or the block time expired. Test the return value to know + * which bits were set. If xEventGroupSync() returned because its timeout + * expired then not all the bits being waited for will be set. If + * xEventGroupSync() returned because all the bits it was waiting for were + * set then the returned value is the event group value before any bits were + * automatically cleared. + * + * Example usage: +
+ // Bits used by the three tasks.
+ #define TASK_0_BIT		( 1 << 0 )
+ #define TASK_1_BIT		( 1 << 1 )
+ #define TASK_2_BIT		( 1 << 2 )
+
+ #define ALL_SYNC_BITS ( TASK_0_BIT | TASK_1_BIT | TASK_2_BIT )
+
+ // Use an event group to synchronise three tasks.  It is assumed this event
+ // group has already been created elsewhere.
+ EventGroupHandle_t xEventBits;
+
+ void vTask0( void *pvParameters )
+ {
+ EventBits_t uxReturn;
+ TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;
+
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 0 in the event flag to note this task has reached the
+		// sync point.  The other two tasks will set the other two bits defined
+		// by ALL_SYNC_BITS.  All three tasks have reached the synchronisation
+		// point when all the ALL_SYNC_BITS are set.  Wait a maximum of 100ms
+		// for this to happen.
+		uxReturn = xEventGroupSync( xEventBits, TASK_0_BIT, ALL_SYNC_BITS, xTicksToWait );
+
+		if( ( uxReturn & ALL_SYNC_BITS ) == ALL_SYNC_BITS )
+		{
+			// All three tasks reached the synchronisation point before the call
+			// to xEventGroupSync() timed out.
+		}
+	}
+ }
+
+ void vTask1( void *pvParameters )
+ {
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 1 in the event flag to note this task has reached the
+		// synchronisation point.  The other two tasks will set the other two
+		// bits defined by ALL_SYNC_BITS.  All three tasks have reached the
+		// synchronisation point when all the ALL_SYNC_BITS are set.  Wait
+		// indefinitely for this to happen.
+		xEventGroupSync( xEventBits, TASK_1_BIT, ALL_SYNC_BITS, portMAX_DELAY );
+
+		// xEventGroupSync() was called with an indefinite block time, so
+		// this task will only reach here if the syncrhonisation was made by all
+		// three tasks, so there is no need to test the return value.
+	 }
+ }
+
+ void vTask2( void *pvParameters )
+ {
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 2 in the event flag to note this task has reached the
+		// synchronisation point.  The other two tasks will set the other two
+		// bits defined by ALL_SYNC_BITS.  All three tasks have reached the
+		// synchronisation point when all the ALL_SYNC_BITS are set.  Wait
+		// indefinitely for this to happen.
+		xEventGroupSync( xEventBits, TASK_2_BIT, ALL_SYNC_BITS, portMAX_DELAY );
+
+		// xEventGroupSync() was called with an indefinite block time, so
+		// this task will only reach here if the syncrhonisation was made by all
+		// three tasks, so there is no need to test the return value.
+	}
+ }
+
+ 
+ * \defgroup xEventGroupSync xEventGroupSync + * \ingroup EventGroup + */ +EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + + +/** + * event_groups.h + *
+	EventBits_t xEventGroupGetBits( EventGroupHandle_t xEventGroup );
+ 
+ * + * Returns the current value of the bits in an event group. This function + * cannot be used from an interrupt. + * + * @param xEventGroup The event group being queried. + * + * @return The event group bits at the time xEventGroupGetBits() was called. + * + * \defgroup xEventGroupGetBits xEventGroupGetBits + * \ingroup EventGroup + */ +#define xEventGroupGetBits( xEventGroup ) xEventGroupClearBits( xEventGroup, 0 ) + +/** + * event_groups.h + *
+	EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup );
+ 
+ * + * A version of xEventGroupGetBits() that can be called from an ISR. + * + * @param xEventGroup The event group being queried. + * + * @return The event group bits at the time xEventGroupGetBitsFromISR() was called. + * + * \defgroup xEventGroupGetBitsFromISR xEventGroupGetBitsFromISR + * \ingroup EventGroup + */ +EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup ); + +/** + * event_groups.h + *
+	void xEventGroupDelete( EventGroupHandle_t xEventGroup );
+ 
+ * + * Delete an event group that was previously created by a call to + * xEventGroupCreate(). Tasks that are blocked on the event group will be + * unblocked and obtain 0 as the event group's value. + * + * @param xEventGroup The event group being deleted. + */ +void vEventGroupDelete( EventGroupHandle_t xEventGroup ); + +/* For internal use only. */ +void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet ); +void vEventGroupClearBitsCallback( void *pvEventGroup, const uint32_t ulBitsToClear ); + +#if (configUSE_TRACE_FACILITY == 1) + UBaseType_t uxEventGroupGetNumber( void* xEventGroup ); +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* EVENT_GROUPS_H */ + + diff --git a/components/freertos/include/freertos/heap_regions.h b/components/freertos/include/freertos/heap_regions.h new file mode 100644 index 000000000..aedea42a1 --- /dev/null +++ b/components/freertos/include/freertos/heap_regions.h @@ -0,0 +1,34 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef _HEAP_REGIONS_H +#define _HEAP_REGIONS_H + +#include "freertos/FreeRTOS.h" + + +typedef struct HeapRegionTagged +{ + uint8_t *pucStartAddress; + size_t xSizeInBytes; + BaseType_t xTag; + uint32_t xExecAddr; +} HeapRegionTagged_t; + + +void vPortDefineHeapRegionsTagged( const HeapRegionTagged_t * const pxHeapRegions ); +void *pvPortMallocTagged( size_t xWantedSize, BaseType_t tag ); + + + +#endif \ No newline at end of file diff --git a/components/freertos/include/freertos/list.h b/components/freertos/include/freertos/list.h new file mode 100644 index 000000000..b63df7f72 --- /dev/null +++ b/components/freertos/include/freertos/list.h @@ -0,0 +1,453 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* + * This is the list implementation used by the scheduler. While it is tailored + * heavily for the schedulers needs, it is also available for use by + * application code. + * + * list_ts can only store pointers to list_item_ts. Each ListItem_t contains a + * numeric value (xItemValue). Most of the time the lists are sorted in + * descending item value order. + * + * Lists are created already containing one list item. The value of this + * item is the maximum possible that can be stored, it is therefore always at + * the end of the list and acts as a marker. The list member pxHead always + * points to this marker - even though it is at the tail of the list. This + * is because the tail contains a wrap back pointer to the true head of + * the list. + * + * In addition to it's value, each list item contains a pointer to the next + * item in the list (pxNext), a pointer to the list it is in (pxContainer) + * and a pointer to back to the object that contains it. These later two + * pointers are included for efficiency of list manipulation. There is + * effectively a two way link between the object containing the list item and + * the list item itself. + * + * + * \page ListIntroduction List Implementation + * \ingroup FreeRTOSIntro + */ + +#ifndef INC_FREERTOS_H + #error FreeRTOS.h must be included before list.h +#endif + +#ifndef LIST_H +#define LIST_H + +/* + * The list structure members are modified from within interrupts, and therefore + * by rights should be declared volatile. However, they are only modified in a + * functionally atomic way (within critical sections of with the scheduler + * suspended) and are either passed by reference into a function or indexed via + * a volatile variable. Therefore, in all use cases tested so far, the volatile + * qualifier can be omitted in order to provide a moderate performance + * improvement without adversely affecting functional behaviour. The assembly + * instructions generated by the IAR, ARM and GCC compilers when the respective + * compiler's options were set for maximum optimisation has been inspected and + * deemed to be as intended. That said, as compiler technology advances, and + * especially if aggressive cross module optimisation is used (a use case that + * has not been exercised to any great extend) then it is feasible that the + * volatile qualifier will be needed for correct optimisation. It is expected + * that a compiler removing essential code because, without the volatile + * qualifier on the list structure members and with aggressive cross module + * optimisation, the compiler deemed the code unnecessary will result in + * complete and obvious failure of the scheduler. If this is ever experienced + * then the volatile qualifier can be inserted in the relevant places within the + * list structures by simply defining configLIST_VOLATILE to volatile in + * FreeRTOSConfig.h (as per the example at the bottom of this comment block). + * If configLIST_VOLATILE is not defined then the preprocessor directives below + * will simply #define configLIST_VOLATILE away completely. + * + * To use volatile list structure members then add the following line to + * FreeRTOSConfig.h (without the quotes): + * "#define configLIST_VOLATILE volatile" + */ +#ifndef configLIST_VOLATILE + #define configLIST_VOLATILE +#endif /* configSUPPORT_CROSS_MODULE_OPTIMISATION */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Macros that can be used to place known values within the list structures, +then check that the known values do not get corrupted during the execution of +the application. These may catch the list data structures being overwritten in +memory. They will not catch data errors caused by incorrect configuration or +use of FreeRTOS.*/ +#if( configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES == 0 ) + /* Define the macros to do nothing. */ + #define listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE + #define listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE + #define listFIRST_LIST_INTEGRITY_CHECK_VALUE + #define listSECOND_LIST_INTEGRITY_CHECK_VALUE + #define listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) + #define listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) + #define listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList ) + #define listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList ) + #define listTEST_LIST_ITEM_INTEGRITY( pxItem ) + #define listTEST_LIST_INTEGRITY( pxList ) +#else + /* Define macros that add new members into the list structures. */ + #define listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE TickType_t xListItemIntegrityValue1; + #define listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE TickType_t xListItemIntegrityValue2; + #define listFIRST_LIST_INTEGRITY_CHECK_VALUE TickType_t xListIntegrityValue1; + #define listSECOND_LIST_INTEGRITY_CHECK_VALUE TickType_t xListIntegrityValue2; + + /* Define macros that set the new structure members to known values. */ + #define listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) ( pxItem )->xListItemIntegrityValue1 = pdINTEGRITY_CHECK_VALUE + #define listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) ( pxItem )->xListItemIntegrityValue2 = pdINTEGRITY_CHECK_VALUE + #define listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList ) ( pxList )->xListIntegrityValue1 = pdINTEGRITY_CHECK_VALUE + #define listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList ) ( pxList )->xListIntegrityValue2 = pdINTEGRITY_CHECK_VALUE + + /* Define macros that will assert if one of the structure members does not + contain its expected value. */ + #define listTEST_LIST_ITEM_INTEGRITY( pxItem ) configASSERT( ( ( pxItem )->xListItemIntegrityValue1 == pdINTEGRITY_CHECK_VALUE ) && ( ( pxItem )->xListItemIntegrityValue2 == pdINTEGRITY_CHECK_VALUE ) ) + #define listTEST_LIST_INTEGRITY( pxList ) configASSERT( ( ( pxList )->xListIntegrityValue1 == pdINTEGRITY_CHECK_VALUE ) && ( ( pxList )->xListIntegrityValue2 == pdINTEGRITY_CHECK_VALUE ) ) +#endif /* configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES */ + + +/* + * Definition of the only type of object that a list can contain. + */ +struct xLIST_ITEM +{ + listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE TickType_t xItemValue; /*< The value being listed. In most cases this is used to sort the list in descending order. */ + struct xLIST_ITEM * configLIST_VOLATILE pxNext; /*< Pointer to the next ListItem_t in the list. */ + struct xLIST_ITEM * configLIST_VOLATILE pxPrevious; /*< Pointer to the previous ListItem_t in the list. */ + void * pvOwner; /*< Pointer to the object (normally a TCB) that contains the list item. There is therefore a two way link between the object containing the list item and the list item itself. */ + void * configLIST_VOLATILE pvContainer; /*< Pointer to the list in which this list item is placed (if any). */ + listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ +}; +typedef struct xLIST_ITEM ListItem_t; /* For some reason lint wants this as two separate definitions. */ + +struct xMINI_LIST_ITEM +{ + listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE TickType_t xItemValue; + struct xLIST_ITEM * configLIST_VOLATILE pxNext; + struct xLIST_ITEM * configLIST_VOLATILE pxPrevious; +}; +typedef struct xMINI_LIST_ITEM MiniListItem_t; + +/* + * Definition of the type of queue used by the scheduler. + */ +typedef struct xLIST +{ + listFIRST_LIST_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE UBaseType_t uxNumberOfItems; + ListItem_t * configLIST_VOLATILE pxIndex; /*< Used to walk through the list. Points to the last item returned by a call to listGET_OWNER_OF_NEXT_ENTRY (). */ + MiniListItem_t xListEnd; /*< List item that contains the maximum possible item value meaning it is always at the end of the list and is therefore used as a marker. */ + listSECOND_LIST_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ +} List_t; + +/* + * Access macro to set the owner of a list item. The owner of a list item + * is the object (usually a TCB) that contains the list item. + * + * \page listSET_LIST_ITEM_OWNER listSET_LIST_ITEM_OWNER + * \ingroup LinkedList + */ +#define listSET_LIST_ITEM_OWNER( pxListItem, pxOwner ) ( ( pxListItem )->pvOwner = ( void * ) ( pxOwner ) ) + +/* + * Access macro to get the owner of a list item. The owner of a list item + * is the object (usually a TCB) that contains the list item. + * + * \page listSET_LIST_ITEM_OWNER listSET_LIST_ITEM_OWNER + * \ingroup LinkedList + */ +#define listGET_LIST_ITEM_OWNER( pxListItem ) ( ( pxListItem )->pvOwner ) + +/* + * Access macro to set the value of the list item. In most cases the value is + * used to sort the list in descending order. + * + * \page listSET_LIST_ITEM_VALUE listSET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listSET_LIST_ITEM_VALUE( pxListItem, xValue ) ( ( pxListItem )->xItemValue = ( xValue ) ) + +/* + * Access macro to retrieve the value of the list item. The value can + * represent anything - for example the priority of a task, or the time at + * which a task should be unblocked. + * + * \page listGET_LIST_ITEM_VALUE listGET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listGET_LIST_ITEM_VALUE( pxListItem ) ( ( pxListItem )->xItemValue ) + +/* + * Access macro to retrieve the value of the list item at the head of a given + * list. + * + * \page listGET_LIST_ITEM_VALUE listGET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxList ) ( ( ( pxList )->xListEnd ).pxNext->xItemValue ) + +/* + * Return the list item at the head of the list. + * + * \page listGET_HEAD_ENTRY listGET_HEAD_ENTRY + * \ingroup LinkedList + */ +#define listGET_HEAD_ENTRY( pxList ) ( ( ( pxList )->xListEnd ).pxNext ) + +/* + * Return the list item at the head of the list. + * + * \page listGET_NEXT listGET_NEXT + * \ingroup LinkedList + */ +#define listGET_NEXT( pxListItem ) ( ( pxListItem )->pxNext ) + +/* + * Return the list item that marks the end of the list + * + * \page listGET_END_MARKER listGET_END_MARKER + * \ingroup LinkedList + */ +#define listGET_END_MARKER( pxList ) ( ( ListItem_t const * ) ( &( ( pxList )->xListEnd ) ) ) + +/* + * Access macro to determine if a list contains any items. The macro will + * only have the value true if the list is empty. + * + * \page listLIST_IS_EMPTY listLIST_IS_EMPTY + * \ingroup LinkedList + */ +#define listLIST_IS_EMPTY( pxList ) ( ( BaseType_t ) ( ( pxList )->uxNumberOfItems == ( UBaseType_t ) 0 ) ) + +/* + * Access macro to return the number of items in the list. + */ +#define listCURRENT_LIST_LENGTH( pxList ) ( ( pxList )->uxNumberOfItems ) + +/* + * Access function to obtain the owner of the next entry in a list. + * + * The list member pxIndex is used to walk through a list. Calling + * listGET_OWNER_OF_NEXT_ENTRY increments pxIndex to the next item in the list + * and returns that entry's pxOwner parameter. Using multiple calls to this + * function it is therefore possible to move through every item contained in + * a list. + * + * The pxOwner parameter of a list item is a pointer to the object that owns + * the list item. In the scheduler this is normally a task control block. + * The pxOwner parameter effectively creates a two way link between the list + * item and its owner. + * + * @param pxTCB pxTCB is set to the address of the owner of the next list item. + * @param pxList The list from which the next item owner is to be returned. + * + * \page listGET_OWNER_OF_NEXT_ENTRY listGET_OWNER_OF_NEXT_ENTRY + * \ingroup LinkedList + */ +#define listGET_OWNER_OF_NEXT_ENTRY( pxTCB, pxList ) \ +{ \ +List_t * const pxConstList = ( pxList ); \ + /* Increment the index to the next item and return the item, ensuring */ \ + /* we don't return the marker used at the end of the list. */ \ + ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext; \ + if( ( void * ) ( pxConstList )->pxIndex == ( void * ) &( ( pxConstList )->xListEnd ) ) \ + { \ + ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext; \ + } \ + ( pxTCB ) = ( pxConstList )->pxIndex->pvOwner; \ +} + + +/* + * Access function to obtain the owner of the first entry in a list. Lists + * are normally sorted in ascending item value order. + * + * This function returns the pxOwner member of the first item in the list. + * The pxOwner parameter of a list item is a pointer to the object that owns + * the list item. In the scheduler this is normally a task control block. + * The pxOwner parameter effectively creates a two way link between the list + * item and its owner. + * + * @param pxList The list from which the owner of the head item is to be + * returned. + * + * \page listGET_OWNER_OF_HEAD_ENTRY listGET_OWNER_OF_HEAD_ENTRY + * \ingroup LinkedList + */ +#define listGET_OWNER_OF_HEAD_ENTRY( pxList ) ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner ) + +/* + * Check to see if a list item is within a list. The list item maintains a + * "container" pointer that points to the list it is in. All this macro does + * is check to see if the container and the list match. + * + * @param pxList The list we want to know if the list item is within. + * @param pxListItem The list item we want to know if is in the list. + * @return pdTRUE if the list item is in the list, otherwise pdFALSE. + */ +#define listIS_CONTAINED_WITHIN( pxList, pxListItem ) ( ( BaseType_t ) ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) ) ) + +/* + * Return the list a list item is contained within (referenced from). + * + * @param pxListItem The list item being queried. + * @return A pointer to the List_t object that references the pxListItem + */ +#define listLIST_ITEM_CONTAINER( pxListItem ) ( ( pxListItem )->pvContainer ) + +/* + * This provides a crude means of knowing if a list has been initialised, as + * pxList->xListEnd.xItemValue is set to portMAX_DELAY by the vListInitialise() + * function. + */ +#define listLIST_IS_INITIALISED( pxList ) ( ( pxList )->xListEnd.xItemValue == portMAX_DELAY ) + +/* + * Must be called before a list is used! This initialises all the members + * of the list structure and inserts the xListEnd item into the list as a + * marker to the back of the list. + * + * @param pxList Pointer to the list being initialised. + * + * \page vListInitialise vListInitialise + * \ingroup LinkedList + */ +void vListInitialise( List_t * const pxList ); + +/* + * Must be called before a list item is used. This sets the list container to + * null so the item does not think that it is already contained in a list. + * + * @param pxItem Pointer to the list item being initialised. + * + * \page vListInitialiseItem vListInitialiseItem + * \ingroup LinkedList + */ +void vListInitialiseItem( ListItem_t * const pxItem ); + +/* + * Insert a list item into a list. The item will be inserted into the list in + * a position determined by its item value (descending item value order). + * + * @param pxList The list into which the item is to be inserted. + * + * @param pxNewListItem The item that is to be placed in the list. + * + * \page vListInsert vListInsert + * \ingroup LinkedList + */ +void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem ); + +/* + * Insert a list item into a list. The item will be inserted in a position + * such that it will be the last item within the list returned by multiple + * calls to listGET_OWNER_OF_NEXT_ENTRY. + * + * The list member pvIndex is used to walk through a list. Calling + * listGET_OWNER_OF_NEXT_ENTRY increments pvIndex to the next item in the list. + * Placing an item in a list using vListInsertEnd effectively places the item + * in the list position pointed to by pvIndex. This means that every other + * item within the list will be returned by listGET_OWNER_OF_NEXT_ENTRY before + * the pvIndex parameter again points to the item being inserted. + * + * @param pxList The list into which the item is to be inserted. + * + * @param pxNewListItem The list item to be inserted into the list. + * + * \page vListInsertEnd vListInsertEnd + * \ingroup LinkedList + */ +void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem ); + +/* + * Remove an item from a list. The list item has a pointer to the list that + * it is in, so only the list item need be passed into the function. + * + * @param uxListRemove The item to be removed. The item will remove itself from + * the list pointed to by it's pxContainer parameter. + * + * @return The number of items that remain in the list after the list item has + * been removed. + * + * \page uxListRemove uxListRemove + * \ingroup LinkedList + */ +UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove ); + +#ifdef __cplusplus +} +#endif + +#endif + diff --git a/components/freertos/include/freertos/mpu_wrappers.h b/components/freertos/include/freertos/mpu_wrappers.h new file mode 100644 index 000000000..504f6d934 --- /dev/null +++ b/components/freertos/include/freertos/mpu_wrappers.h @@ -0,0 +1,157 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef MPU_WRAPPERS_H +#define MPU_WRAPPERS_H + +/* This file redefines API functions to be called through a wrapper macro, but +only for ports that are using the MPU. */ +#if portUSING_MPU_WRAPPERS + + /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE will be defined when this file is + included from queue.c or task.c to prevent it from having an effect within + those files. */ + #ifndef MPU_WRAPPERS_INCLUDED_FROM_API_FILE + + #define xTaskGenericCreate MPU_xTaskGenericCreate + #define vTaskAllocateMPURegions MPU_vTaskAllocateMPURegions + #define vTaskDelete MPU_vTaskDelete + #define vTaskDelayUntil MPU_vTaskDelayUntil + #define vTaskDelay MPU_vTaskDelay + #define uxTaskPriorityGet MPU_uxTaskPriorityGet + #define vTaskPrioritySet MPU_vTaskPrioritySet + #define eTaskGetState MPU_eTaskGetState + #define vTaskSuspend MPU_vTaskSuspend + #define vTaskResume MPU_vTaskResume + #define vTaskSuspendAll MPU_vTaskSuspendAll + #define xTaskResumeAll MPU_xTaskResumeAll + #define xTaskGetTickCount MPU_xTaskGetTickCount + #define uxTaskGetNumberOfTasks MPU_uxTaskGetNumberOfTasks + #define vTaskList MPU_vTaskList + #define vTaskGetRunTimeStats MPU_vTaskGetRunTimeStats + #define vTaskSetApplicationTaskTag MPU_vTaskSetApplicationTaskTag + #define xTaskGetApplicationTaskTag MPU_xTaskGetApplicationTaskTag + #define xTaskCallApplicationTaskHook MPU_xTaskCallApplicationTaskHook + #define uxTaskGetStackHighWaterMark MPU_uxTaskGetStackHighWaterMark + #define xTaskGetCurrentTaskHandle MPU_xTaskGetCurrentTaskHandle + #define xTaskGetSchedulerState MPU_xTaskGetSchedulerState + #define xTaskGetIdleTaskHandle MPU_xTaskGetIdleTaskHandle + #define uxTaskGetSystemState MPU_uxTaskGetSystemState + + #define xQueueGenericCreate MPU_xQueueGenericCreate + #define xQueueCreateMutex MPU_xQueueCreateMutex + #define xQueueGiveMutexRecursive MPU_xQueueGiveMutexRecursive + #define xQueueTakeMutexRecursive MPU_xQueueTakeMutexRecursive + #define xQueueCreateCountingSemaphore MPU_xQueueCreateCountingSemaphore + #define xQueueGenericSend MPU_xQueueGenericSend + #define xQueueAltGenericSend MPU_xQueueAltGenericSend + #define xQueueAltGenericReceive MPU_xQueueAltGenericReceive + #define xQueueGenericReceive MPU_xQueueGenericReceive + #define uxQueueMessagesWaiting MPU_uxQueueMessagesWaiting + #define vQueueDelete MPU_vQueueDelete + #define xQueueGenericReset MPU_xQueueGenericReset + #define xQueueCreateSet MPU_xQueueCreateSet + #define xQueueSelectFromSet MPU_xQueueSelectFromSet + #define xQueueAddToSet MPU_xQueueAddToSet + #define xQueueRemoveFromSet MPU_xQueueRemoveFromSet + #define xQueuePeekFromISR MPU_xQueuePeekFromISR + #define xQueueGetMutexHolder MPU_xQueueGetMutexHolder + + #define pvPortMalloc MPU_pvPortMalloc + #define vPortFree MPU_vPortFree + #define xPortGetFreeHeapSize MPU_xPortGetFreeHeapSize + #define vPortInitialiseBlocks MPU_vPortInitialiseBlocks + + #if configQUEUE_REGISTRY_SIZE > 0 + #define vQueueAddToRegistry MPU_vQueueAddToRegistry + #define vQueueUnregisterQueue MPU_vQueueUnregisterQueue + #endif + + /* Remove the privileged function macro. */ + #define PRIVILEGED_FUNCTION + + #else /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */ + + /* Ensure API functions go in the privileged execution section. */ + #define PRIVILEGED_FUNCTION __attribute__((section("privileged_functions"))) + #define PRIVILEGED_DATA __attribute__((section("privileged_data"))) + + #endif /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */ + +#else /* portUSING_MPU_WRAPPERS */ + + #define PRIVILEGED_FUNCTION + #define PRIVILEGED_DATA + #define portUSING_MPU_WRAPPERS 0 + +#endif /* portUSING_MPU_WRAPPERS */ + + +#endif /* MPU_WRAPPERS_H */ + diff --git a/components/freertos/include/freertos/portable.h b/components/freertos/include/freertos/portable.h new file mode 100644 index 000000000..4030ca0c0 --- /dev/null +++ b/components/freertos/include/freertos/portable.h @@ -0,0 +1,203 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/*----------------------------------------------------------- + * Portable layer API. Each function must be defined for each port. + *----------------------------------------------------------*/ + +#ifndef PORTABLE_H +#define PORTABLE_H + +/* Each FreeRTOS port has a unique portmacro.h header file. Originally a +pre-processor definition was used to ensure the pre-processor found the correct +portmacro.h file for the port being used. That scheme was deprecated in favour +of setting the compiler's include path such that it found the correct +portmacro.h file - removing the need for the constant and allowing the +portmacro.h file to be located anywhere in relation to the port being used. +Purely for reasons of backward compatibility the old method is still valid, but +to make it clear that new projects should not use it, support for the port +specific constants has been moved into the deprecated_definitions.h header +file. */ +#include "deprecated_definitions.h" + +/* If portENTER_CRITICAL is not defined then including deprecated_definitions.h +did not result in a portmacro.h header file being included - and it should be +included here. In this case the path to the correct portmacro.h header file +must be set in the compiler's include path. */ +#ifndef portENTER_CRITICAL + #include "portmacro.h" +#endif + +#if portBYTE_ALIGNMENT == 8 + #define portBYTE_ALIGNMENT_MASK ( 0x0007U ) +#endif + +#if portBYTE_ALIGNMENT == 4 + #define portBYTE_ALIGNMENT_MASK ( 0x0003 ) +#endif + +#if portBYTE_ALIGNMENT == 2 + #define portBYTE_ALIGNMENT_MASK ( 0x0001 ) +#endif + +#if portBYTE_ALIGNMENT == 1 + #define portBYTE_ALIGNMENT_MASK ( 0x0000 ) +#endif + +#ifndef portBYTE_ALIGNMENT_MASK + #error "Invalid portBYTE_ALIGNMENT definition" +#endif + +#ifndef portNUM_CONFIGURABLE_REGIONS + #define portNUM_CONFIGURABLE_REGIONS 1 +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#include "mpu_wrappers.h" + +/* + * Setup the stack of a new task so it is ready to be placed under the + * scheduler control. The registers have to be placed on the stack in + * the order that the port expects to find them. + * + */ +#if( portUSING_MPU_WRAPPERS == 1 ) + StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters, BaseType_t xRunPrivileged ) PRIVILEGED_FUNCTION; +#else + StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters ) PRIVILEGED_FUNCTION; +#endif + +/* Used by heap_5.c. */ +typedef struct HeapRegion +{ + uint8_t *pucStartAddress; + size_t xSizeInBytes; +} HeapRegion_t; + +/* + * Used to define multiple heap regions for use by heap_5.c. This function + * must be called before any calls to pvPortMalloc() - not creating a task, + * queue, semaphore, mutex, software timer, event group, etc. will result in + * pvPortMalloc being called. + * + * pxHeapRegions passes in an array of HeapRegion_t structures - each of which + * defines a region of memory that can be used as the heap. The array is + * terminated by a HeapRegions_t structure that has a size of 0. The region + * with the lowest start address must appear first in the array. + */ +void vPortDefineHeapRegions( const HeapRegion_t * const pxHeapRegions ); + + +/* + * Map to the memory management routines required for the port. + */ +void *pvPortMalloc( size_t xSize ) PRIVILEGED_FUNCTION; +void vPortFree( void *pv ) PRIVILEGED_FUNCTION; +void vPortInitialiseBlocks( void ) PRIVILEGED_FUNCTION; +size_t xPortGetFreeHeapSize( void ) PRIVILEGED_FUNCTION; +size_t xPortGetMinimumEverFreeHeapSize( void ) PRIVILEGED_FUNCTION; + +/* + * Setup the hardware ready for the scheduler to take control. This generally + * sets up a tick interrupt and sets timers for the correct tick frequency. + */ +BaseType_t xPortStartScheduler( void ) PRIVILEGED_FUNCTION; + +/* + * Undo any hardware/ISR setup that was performed by xPortStartScheduler() so + * the hardware is left in its original condition after the scheduler stops + * executing. + */ +void vPortEndScheduler( void ) PRIVILEGED_FUNCTION; + +/* + * The structures and methods of manipulating the MPU are contained within the + * port layer. + * + * Fills the xMPUSettings structure with the memory region information + * contained in xRegions. + */ +#if( portUSING_MPU_WRAPPERS == 1 ) + struct xMEMORY_REGION; + void vPortStoreTaskMPUSettings( xMPU_SETTINGS *xMPUSettings, const struct xMEMORY_REGION * const xRegions, StackType_t *pxBottomOfStack, uint16_t usStackDepth ) PRIVILEGED_FUNCTION; +#endif + +/* Multi-core: get current core ID */ +int xPortGetCoreID( void ); + + +#ifdef __cplusplus +} +#endif + +#endif /* PORTABLE_H */ + diff --git a/components/freertos/include/freertos/portbenchmark.h b/components/freertos/include/freertos/portbenchmark.h new file mode 100644 index 000000000..4ce41d3da --- /dev/null +++ b/components/freertos/include/freertos/portbenchmark.h @@ -0,0 +1,46 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- +*/ + +/* + * This utility helps benchmarking interrupt latency and context switches. + * In order to enable it, set configBENCHMARK to 1 in FreeRTOSConfig.h. + * You will also need to download the FreeRTOS_trace patch that contains + * portbenchmark.c and the complete version of portbenchmark.h + */ + +#ifndef PORTBENCHMARK_H +#define PORTBENCHMARK_H + +#if configBENCHMARK + #error "You need to download the FreeRTOS_trace patch that overwrites this file" +#endif + +#define portbenchmarkINTERRUPT_DISABLE() +#define portbenchmarkINTERRUPT_RESTORE(newstate) +#define portbenchmarkIntLatency() +#define portbenchmarkIntWait() +#define portbenchmarkReset() +#define portbenchmarkPrint() + +#endif /* PORTBENCHMARK */ diff --git a/components/freertos/include/freertos/portmacro.h b/components/freertos/include/freertos/portmacro.h new file mode 100644 index 000000000..b659a8271 --- /dev/null +++ b/components/freertos/include/freertos/portmacro.h @@ -0,0 +1,290 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that has become a de facto standard. * + * * + * Help yourself get started quickly and support the FreeRTOS * + * project by purchasing a FreeRTOS tutorial book, reference * + * manual, or both from: http://www.FreeRTOS.org/Documentation * + * * + * Thank you! * + * * + *************************************************************************** + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available from the following + link: http://www.freertos.org/a00114.html + + 1 tab == 4 spaces! + + *************************************************************************** + * * + * Having a problem? Start by reading the FAQ "My application does * + * not run, what could be wrong?" * + * * + * http://www.FreeRTOS.org/FAQHelp.html * + * * + *************************************************************************** + + http://www.FreeRTOS.org - Documentation, books, training, latest versions, + license and Real Time Engineers Ltd. contact details. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High + Integrity Systems to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef PORTMACRO_H +#define PORTMACRO_H + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef __ASSEMBLER__ + +#include + +#include +#include +#include +#include /* required for XSHAL_CLIB */ +#include + +//#include "xtensa_context.h" + +/*----------------------------------------------------------- + * Port specific definitions. + * + * The settings in this file configure FreeRTOS correctly for the + * given hardware and compiler. + * + * These settings should not be altered. + *----------------------------------------------------------- + */ + +/* Type definitions. */ + +#define portCHAR int8_t +#define portFLOAT float +#define portDOUBLE double +#define portLONG int32_t +#define portSHORT int16_t +#define portSTACK_TYPE uint8_t +#define portBASE_TYPE int + +typedef portSTACK_TYPE StackType_t; +typedef portBASE_TYPE BaseType_t; +typedef unsigned portBASE_TYPE UBaseType_t; + +#if( configUSE_16_BIT_TICKS == 1 ) + typedef uint16_t TickType_t; + #define portMAX_DELAY ( TickType_t ) 0xffff +#else + typedef uint32_t TickType_t; + #define portMAX_DELAY ( TickType_t ) 0xffffffffUL +#endif +/*-----------------------------------------------------------*/ + +// portbenchmark +#include "portbenchmark.h" + + +#define portMUX_DEBUG + +typedef struct { + volatile uint32_t mux; +#ifdef portMUX_DEBUG + const char *lastLockedFn; + int lastLockedLine; +#endif +} portMUX_TYPE; + + /* + * Kernel mux values can be: + * 0 - Uninitialized + * (0-portNUM_PROCESSORS)|(recCnt<<8)|0xB33F0000 - taken by core (val), recurse count is (recCnt) + * 0xB33FFFFF - free + * + * The magic number in the top 16 bits is there so we can detect uninitialized and corrupted muxes. + */ + +#define portMUX_MAGIC_VAL 0xB33F0000 +#define portMUX_FREE_VAL 0xB33FFFFF +#define portMUX_MAGIC_MASK 0xFFFF0000 +#define portMUX_MAGIC_SHIFT 16 +#define portMUX_CNT_MASK 0x0000FF00 +#define portMUX_CNT_SHIFT 8 +#define portMUX_VAL_MASK 0x000000FF +#define portMUX_VAL_SHIFT 0 + +/* Critical section management. NW-TODO: replace XTOS_SET_INTLEVEL with more efficient version, if any? */ +// These cannot be nested. They should be used with a lot of care and cannot be called from interrupt level. +#define portDISABLE_INTERRUPTS() do { XTOS_SET_INTLEVEL(XCHAL_EXCM_LEVEL); portbenchmarkINTERRUPT_DISABLE(); } while (0) +#define portENABLE_INTERRUPTS() do { portbenchmarkINTERRUPT_RESTORE(0); XTOS_SET_INTLEVEL(0); } while (0) + +#define portCRITICAL_NESTING_IN_TCB 1 + + +/* +Enable this to enable mux debugging. With this on, the mux code will warn you for deadlocks +and double releases etc. +*/ +#define portMUX_DEBUG + +/* +Modifications to portENTER_CRITICAL: + +The original portENTER_CRITICAL only disabled the ISRs. This is enough for single-CPU operation: by +disabling the interrupts, there is no task switch so no other tasks can meddle in the data, and because +interrupts are disabled, ISRs can't corrupt data structures either. + +For multiprocessing, things get a bit more hairy. First of all, disabling the interrupts doesn't stop +the tasks or ISRs on the other processors meddling with our CPU. For tasks, this is solved by adding +a spinlock to the portENTER_CRITICAL macro. A task running on the other CPU accessing the same data will +spinlock in the portENTER_CRITICAL code until the first CPU is done. + +For ISRs, we now also need muxes: while portENTER_CRITICAL disabling interrupts will stop ISRs on the same +CPU from meddling with the data, it does not stop interrupts on the other cores from interfering with the +data. For this, we also use a spinlock in the routines called by the ISR, but these spinlocks +do not disable the interrupts (because they already are). + +This all assumes that interrupts are either entirely disabled or enabled. Interrupr priority levels +will break this scheme. +*/ +void vPortCPUInitializeMutex(portMUX_TYPE *mux); +#ifdef portMUX_DEBUG +void vPortCPUAcquireMutex(portMUX_TYPE *mux, const char *function, int line); +portBASE_TYPE vPortCPUReleaseMutex(portMUX_TYPE *mux, const char *function, int line); +void vTaskEnterCritical( portMUX_TYPE *mux, const char *function, int line ); +void vTaskExitCritical( portMUX_TYPE *mux, const char *function, int line ); +#define portENTER_CRITICAL(mux) vTaskEnterCritical(mux, __FUNCTION__, __LINE__) +#define portEXIT_CRITICAL(mux) vTaskExitCritical(mux, __FUNCTION__, __LINE__) +#define portENTER_CRITICAL_ISR(mux) vPortCPUAcquireMutex(mux, __FUNCTION__, __LINE__) +#define portEXIT_CRITICAL_ISR(mux) vPortCPUReleaseMutex(mux, __FUNCTION__, __LINE__) +#else +void vTaskExitCritical( portMUX_TYPE *mux ); +void vTaskEnterCritical( portMUX_TYPE *mux ); +void vPortCPUAcquireMutex(portMUX_TYPE *mux); +portBASE_TYPE vPortCPUReleaseMutex(portMUX_TYPE *mux); +#define portENTER_CRITICAL(mux) vTaskEnterCritical(mux) +#define portEXIT_CRITICAL(mux) vTaskExitCritical(mux) +#define portENTER_CRITICAL_ISR(mux) vPortCPUAcquireMutex(mux) +#define portEXIT_CRITICAL_ISR(mux) vPortCPUReleaseMutex(mux) +#endif + + +// Cleaner and preferred solution allows nested interrupts disabling and restoring via local registers or stack. +// They can be called from interrupts too. +static inline unsigned portENTER_CRITICAL_NESTED() { unsigned state = XTOS_SET_INTLEVEL(XCHAL_EXCM_LEVEL); portbenchmarkINTERRUPT_DISABLE(); return state; } +#define portEXIT_CRITICAL_NESTED(state) do { portbenchmarkINTERRUPT_RESTORE(state); XTOS_RESTORE_JUST_INTLEVEL(state); } while (0) + +// These FreeRTOS versions are similar to the nested versions above +#define portSET_INTERRUPT_MASK_FROM_ISR() portENTER_CRITICAL_NESTED() +#define portCLEAR_INTERRUPT_MASK_FROM_ISR(state) portEXIT_CRITICAL_NESTED(state) + + +/*-----------------------------------------------------------*/ + +/* Architecture specifics. */ +#define portSTACK_GROWTH ( -1 ) +#define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ ) +#define portBYTE_ALIGNMENT 4 +#define portNOP() XT_NOP() +/*-----------------------------------------------------------*/ + +/* Fine resolution time */ +#define portGET_RUN_TIME_COUNTER_VALUE() xthal_get_ccount() + +/* Kernel utilities. */ +void vPortYield( void ); +void _frxt_setup_switch( void ); +#define portYIELD() vPortYield() +#define portYIELD_FROM_ISR() _frxt_setup_switch() +/*-----------------------------------------------------------*/ + +/* Task function macros as described on the FreeRTOS.org WEB site. */ +#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters ) +#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters ) + +// When coprocessors are defined, we to maintain a pointer to coprocessors area. +// We currently use a hack: redefine field xMPU_SETTINGS in TCB block as a structure that can hold: +// MPU wrappers, coprocessor area pointer, trace code structure, and more if needed. +// The field is normally used for memory protection. FreeRTOS should create another general purpose field. +typedef struct { + #if XCHAL_CP_NUM > 0 + volatile StackType_t* coproc_area; // Pointer to coprocessor save area; MUST BE FIRST + #endif + + #if portUSING_MPU_WRAPPERS + // Define here mpu_settings, which is port dependent + int mpu_setting; // Just a dummy example here; MPU not ported to Xtensa yet + #endif + + #if configUSE_TRACE_FACILITY_2 + struct { + // Cf. porttraceStamp() + int taskstamp; /* Stamp from inside task to see where we are */ + int taskstampcount; /* A counter usually incremented when we restart the task's loop */ + } porttrace; + #endif +} xMPU_SETTINGS; + +// Main hack to use MPU_wrappers even when no MPU is defined (warning: mpu_setting should not be accessed; otherwise move this above xMPU_SETTINGS) +#if (XCHAL_CP_NUM > 0 || configUSE_TRACE_FACILITY_2) && !portUSING_MPU_WRAPPERS // If MPU wrappers not used, we still need to allocate coproc area + #undef portUSING_MPU_WRAPPERS + #define portUSING_MPU_WRAPPERS 1 // Enable it to allocate coproc area + #define MPU_WRAPPERS_H // Override mpu_wrapper.h to disable unwanted code + #define PRIVILEGED_FUNCTION + #define PRIVILEGED_DATA +#endif + +// porttrace +#if configUSE_TRACE_FACILITY_2 +#include "porttrace.h" +#endif + +// configASSERT_2 if requested +#if configASSERT_2 +#include +void exit(int); +#define configASSERT( x ) if (!(x)) { porttracePrint(-1); printf("\nAssertion failed in %s:%d\n", __FILE__, __LINE__); exit(-1); } +#endif + +#endif // __ASSEMBLER__ + +#ifdef __cplusplus +} +#endif + +#endif /* PORTMACRO_H */ + diff --git a/components/freertos/include/freertos/porttrace.h b/components/freertos/include/freertos/porttrace.h new file mode 100644 index 000000000..bf2fb4125 --- /dev/null +++ b/components/freertos/include/freertos/porttrace.h @@ -0,0 +1,42 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + +/* + * This utility helps tracing the entering and exiting from tasks. It maintains a circular buffer + * of tasks in the order they execute, and their execution time. + * In order to enable it, set configUSE_TRACE_FACILITY_2 to 1 in FreeRTOSConfig.h. + * You will also need to download the FreeRTOS_trace patch that contains + * porttrace.c and the complete version of porttrace.h + */ + +#ifndef PORTTRACE_H +#define PORTTRACE_H + +#if configUSE_TRACE_FACILITY_2 + #error "You need to download the FreeRTOS_trace patch that overwrites this file" +#endif + +#define porttracePrint(nelements) +#define porttraceStamp(stamp, count_incr) + +#endif /* PORTTRACE_H */ diff --git a/components/freertos/include/freertos/projdefs.h b/components/freertos/include/freertos/projdefs.h new file mode 100644 index 000000000..1bd39c58d --- /dev/null +++ b/components/freertos/include/freertos/projdefs.h @@ -0,0 +1,109 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef PROJDEFS_H +#define PROJDEFS_H + +/* + * Defines the prototype to which task functions must conform. Defined in this + * file to ensure the type is known before portable.h is included. + */ +typedef void (*TaskFunction_t)( void * ); + +/* Converts a time in milliseconds to a time in ticks. */ +#define pdMS_TO_TICKS( xTimeInMs ) ( ( ( TickType_t ) ( xTimeInMs ) * configTICK_RATE_HZ ) / ( TickType_t ) 1000 ) + +#define pdFALSE ( ( BaseType_t ) 0 ) +#define pdTRUE ( ( BaseType_t ) 1 ) + +#define pdPASS ( pdTRUE ) +#define pdFAIL ( pdFALSE ) +#define errQUEUE_EMPTY ( ( BaseType_t ) 0 ) +#define errQUEUE_FULL ( ( BaseType_t ) 0 ) + +/* Error definitions. */ +#define errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY ( -1 ) +#define errQUEUE_BLOCKED ( -4 ) +#define errQUEUE_YIELD ( -5 ) + +/* Macros used for basic data corruption checks. */ +#ifndef configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES + #define configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES 0 +#endif + +#if( configUSE_16_BIT_TICKS == 1 ) + #define pdINTEGRITY_CHECK_VALUE 0x5a5a +#else + #define pdINTEGRITY_CHECK_VALUE 0x5a5a5a5aUL +#endif + +#endif /* PROJDEFS_H */ + + + diff --git a/components/freertos/include/freertos/queue.h b/components/freertos/include/freertos/queue.h new file mode 100644 index 000000000..2095c59b0 --- /dev/null +++ b/components/freertos/include/freertos/queue.h @@ -0,0 +1,1693 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef QUEUE_H +#define QUEUE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include queue.h" +#endif + +#ifdef __cplusplus +extern "C" { +#endif + + +/** + * Type by which queues are referenced. For example, a call to xQueueCreate() + * returns an QueueHandle_t variable that can then be used as a parameter to + * xQueueSend(), xQueueReceive(), etc. + */ +typedef void * QueueHandle_t; + +/** + * Type by which queue sets are referenced. For example, a call to + * xQueueCreateSet() returns an xQueueSet variable that can then be used as a + * parameter to xQueueSelectFromSet(), xQueueAddToSet(), etc. + */ +typedef void * QueueSetHandle_t; + +/** + * Queue sets can contain both queues and semaphores, so the + * QueueSetMemberHandle_t is defined as a type to be used where a parameter or + * return value can be either an QueueHandle_t or an SemaphoreHandle_t. + */ +typedef void * QueueSetMemberHandle_t; + +/* For internal use only. */ +#define queueSEND_TO_BACK ( ( BaseType_t ) 0 ) +#define queueSEND_TO_FRONT ( ( BaseType_t ) 1 ) +#define queueOVERWRITE ( ( BaseType_t ) 2 ) + +/* For internal use only. These definitions *must* match those in queue.c. */ +#define queueQUEUE_TYPE_BASE ( ( uint8_t ) 0U ) +#define queueQUEUE_TYPE_SET ( ( uint8_t ) 0U ) +#define queueQUEUE_TYPE_MUTEX ( ( uint8_t ) 1U ) +#define queueQUEUE_TYPE_COUNTING_SEMAPHORE ( ( uint8_t ) 2U ) +#define queueQUEUE_TYPE_BINARY_SEMAPHORE ( ( uint8_t ) 3U ) +#define queueQUEUE_TYPE_RECURSIVE_MUTEX ( ( uint8_t ) 4U ) + +/** + * queue. h + *
+ QueueHandle_t xQueueCreate(
+							  UBaseType_t uxQueueLength,
+							  UBaseType_t uxItemSize
+						  );
+ * 
+ * + * Creates a new queue instance. This allocates the storage required by the + * new queue and returns a handle for the queue. + * + * @param uxQueueLength The maximum number of items that the queue can contain. + * + * @param uxItemSize The number of bytes each item in the queue will require. + * Items are queued by copy, not by reference, so this is the number of bytes + * that will be copied for each posted item. Each item on the queue must be + * the same size. + * + * @return If the queue is successfully create then a handle to the newly + * created queue is returned. If the queue cannot be created then 0 is + * returned. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ };
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+	if( xQueue1 == 0 )
+	{
+		// Queue was not created and must not be used.
+	}
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue2 == 0 )
+	{
+		// Queue was not created and must not be used.
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueCreate xQueueCreate + * \ingroup QueueManagement + */ +#define xQueueCreate( uxQueueLength, uxItemSize ) xQueueGenericCreate( uxQueueLength, uxItemSize, queueQUEUE_TYPE_BASE ) + +/** + * queue. h + *
+ BaseType_t xQueueSendToToFront(
+								   QueueHandle_t	xQueue,
+								   const void		*pvItemToQueue,
+								   TickType_t		xTicksToWait
+							   );
+ * 
+ * + * This is a macro that calls xQueueGenericSend(). + * + * Post an item to the front of a queue. The item is queued by copy, not by + * reference. This function must not be called from an interrupt service + * routine. See xQueueSendFromISR () for an alternative which may be used + * in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSendToFront( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSendToFront( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSendToFront( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_FRONT ) + +/** + * queue. h + *
+ BaseType_t xQueueSendToBack(
+								   QueueHandle_t	xQueue,
+								   const void		*pvItemToQueue,
+								   TickType_t		xTicksToWait
+							   );
+ * 
+ * + * This is a macro that calls xQueueGenericSend(). + * + * Post an item to the back of a queue. The item is queued by copy, not by + * reference. This function must not be called from an interrupt service + * routine. See xQueueSendFromISR () for an alternative which may be used + * in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the queue + * is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSendToBack( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSendToBack( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSendToBack( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_BACK ) + +/** + * queue. h + *
+ BaseType_t xQueueSend(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue,
+							  TickType_t xTicksToWait
+						 );
+ * 
+ * + * This is a macro that calls xQueueGenericSend(). It is included for + * backward compatibility with versions of FreeRTOS.org that did not + * include the xQueueSendToFront() and xQueueSendToBack() macros. It is + * equivalent to xQueueSendToBack(). + * + * Post an item on a queue. The item is queued by copy, not by reference. + * This function must not be called from an interrupt service routine. + * See xQueueSendFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSend( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSend( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSend( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_BACK ) + +/** + * queue. h + *
+ BaseType_t xQueueOverwrite(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue
+						 );
+ * 
+ * + * Only for use with queues that have a length of one - so the queue is either + * empty or full. + * + * Post an item on a queue. If the queue is already full then overwrite the + * value held in the queue. The item is queued by copy, not by reference. + * + * This function must not be called from an interrupt service routine. + * See xQueueOverwriteFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle of the queue to which the data is being sent. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @return xQueueOverwrite() is a macro that calls xQueueGenericSend(), and + * therefore has the same return values as xQueueSendToFront(). However, pdPASS + * is the only value that can be returned because xQueueOverwrite() will write + * to the queue even when the queue is already full. + * + * Example usage: +
+
+ void vFunction( void *pvParameters )
+ {
+ QueueHandle_t xQueue;
+ uint32_t ulVarToSend, ulValReceived;
+
+	// Create a queue to hold one uint32_t value.  It is strongly
+	// recommended *not* to use xQueueOverwrite() on queues that can
+	// contain more than one value, and doing so will trigger an assertion
+	// if configASSERT() is defined.
+	xQueue = xQueueCreate( 1, sizeof( uint32_t ) );
+
+	// Write the value 10 to the queue using xQueueOverwrite().
+	ulVarToSend = 10;
+	xQueueOverwrite( xQueue, &ulVarToSend );
+
+	// Peeking the queue should now return 10, but leave the value 10 in
+	// the queue.  A block time of zero is used as it is known that the
+	// queue holds a value.
+	ulValReceived = 0;
+	xQueuePeek( xQueue, &ulValReceived, 0 );
+
+	if( ulValReceived != 10 )
+	{
+		// Error unless the item was removed by a different task.
+	}
+
+	// The queue is still full.  Use xQueueOverwrite() to overwrite the
+	// value held in the queue with 100.
+	ulVarToSend = 100;
+	xQueueOverwrite( xQueue, &ulVarToSend );
+
+	// This time read from the queue, leaving the queue empty once more.
+	// A block time of 0 is used again.
+	xQueueReceive( xQueue, &ulValReceived, 0 );
+
+	// The value read should be the last value written, even though the
+	// queue was already full when the value was written.
+	if( ulValReceived != 100 )
+	{
+		// Error!
+	}
+
+	// ...
+}
+ 
+ * \defgroup xQueueOverwrite xQueueOverwrite + * \ingroup QueueManagement + */ +#define xQueueOverwrite( xQueue, pvItemToQueue ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), 0, queueOVERWRITE ) + + +/** + * queue. h + *
+ BaseType_t xQueueGenericSend(
+									QueueHandle_t xQueue,
+									const void * pvItemToQueue,
+									TickType_t xTicksToWait
+									BaseType_t xCopyPosition
+								);
+ * 
+ * + * It is preferred that the macros xQueueSend(), xQueueSendToFront() and + * xQueueSendToBack() are used in place of calling this function directly. + * + * Post an item on a queue. The item is queued by copy, not by reference. + * This function must not be called from an interrupt service routine. + * See xQueueSendFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @param xCopyPosition Can take the value queueSEND_TO_BACK to place the + * item at the back of the queue, or queueSEND_TO_FRONT to place the item + * at the front of the queue (for high priority messages). + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueGenericSend( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10, queueSEND_TO_BACK ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueGenericSend( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0, queueSEND_TO_BACK );
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
+ BaseType_t xQueuePeek(
+							 QueueHandle_t xQueue,
+							 void *pvBuffer,
+							 TickType_t xTicksToWait
+						 );
+ * + * This is a macro that calls the xQueueGenericReceive() function. + * + * Receive an item from a queue without removing the item from the queue. + * The item is received by copy so a buffer of adequate size must be + * provided. The number of bytes copied into the buffer was defined when + * the queue was created. + * + * Successfully received items remain on the queue so will be returned again + * by the next call, or a call to xQueueReceive(). + * + * This macro must not be used in an interrupt service routine. See + * xQueuePeekFromISR() for an alternative that can be called from an interrupt + * service routine. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * xQueuePeek() will return immediately if xTicksToWait is 0 and the queue + * is empty. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to peek the data from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Peek a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueuePeek( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask, but the item still remains on the queue.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +#define xQueuePeek( xQueue, pvBuffer, xTicksToWait ) xQueueGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdTRUE ) + +/** + * queue. h + *
+ BaseType_t xQueuePeekFromISR(
+									QueueHandle_t xQueue,
+									void *pvBuffer,
+								);
+ * + * A version of xQueuePeek() that can be called from an interrupt service + * routine (ISR). + * + * Receive an item from a queue without removing the item from the queue. + * The item is received by copy so a buffer of adequate size must be + * provided. The number of bytes copied into the buffer was defined when + * the queue was created. + * + * Successfully received items remain on the queue so will be returned again + * by the next call, or a call to xQueueReceive(). + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * \defgroup xQueuePeekFromISR xQueuePeekFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueuePeekFromISR( QueueHandle_t xQueue, void * const pvBuffer ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
+ BaseType_t xQueueReceive(
+								 QueueHandle_t xQueue,
+								 void *pvBuffer,
+								 TickType_t xTicksToWait
+							);
+ * + * This is a macro that calls the xQueueGenericReceive() function. + * + * Receive an item from a queue. The item is received by copy so a buffer of + * adequate size must be provided. The number of bytes copied into the buffer + * was defined when the queue was created. + * + * Successfully received items are removed from the queue. + * + * This function must not be used in an interrupt service routine. See + * xQueueReceiveFromISR for an alternative that can. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. xQueueReceive() will return immediately if xTicksToWait + * is zero and the queue is empty. The time is defined in tick periods so the + * constant portTICK_PERIOD_MS should be used to convert to real time if this is + * required. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to receive from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Receive a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueueReceive( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +#define xQueueReceive( xQueue, pvBuffer, xTicksToWait ) xQueueGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdFALSE ) + + +/** + * queue. h + *
+ BaseType_t xQueueGenericReceive(
+									   QueueHandle_t	xQueue,
+									   void	*pvBuffer,
+									   TickType_t	xTicksToWait
+									   BaseType_t	xJustPeek
+									);
+ * + * It is preferred that the macro xQueueReceive() be used rather than calling + * this function directly. + * + * Receive an item from a queue. The item is received by copy so a buffer of + * adequate size must be provided. The number of bytes copied into the buffer + * was defined when the queue was created. + * + * This function must not be used in an interrupt service routine. See + * xQueueReceiveFromISR for an alternative that can. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * xQueueGenericReceive() will return immediately if the queue is empty and + * xTicksToWait is 0. + * + * @param xJustPeek When set to true, the item received from the queue is not + * actually removed from the queue - meaning a subsequent call to + * xQueueReceive() will return the same item. When set to false, the item + * being received from the queue is also removed from the queue. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: +
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to receive from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Receive a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueueGenericReceive( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+ 
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xJustPeek ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue );
+ * + * Return the number of messages stored in a queue. + * + * @param xQueue A handle to the queue being queried. + * + * @return The number of messages available in the queue. + * + * \defgroup uxQueueMessagesWaiting uxQueueMessagesWaiting + * \ingroup QueueManagement + */ +UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue );
+ * + * Return the number of free spaces available in a queue. This is equal to the + * number of items that can be sent to the queue before the queue becomes full + * if no items are removed. + * + * @param xQueue A handle to the queue being queried. + * + * @return The number of spaces available in the queue. + * + * \defgroup uxQueueMessagesWaiting uxQueueMessagesWaiting + * \ingroup QueueManagement + */ +UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
void vQueueDelete( QueueHandle_t xQueue );
+ * + * Delete a queue - freeing all the memory allocated for storing of items + * placed on the queue. + * + * @param xQueue A handle to the queue to be deleted. + * + * \defgroup vQueueDelete vQueueDelete + * \ingroup QueueManagement + */ +void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
+ BaseType_t xQueueSendToFrontFromISR(
+										 QueueHandle_t xQueue,
+										 const void *pvItemToQueue,
+										 BaseType_t *pxHigherPriorityTaskWoken
+									  );
+ 
+ * + * This is a macro that calls xQueueGenericSendFromISR(). + * + * Post an item to the front of a queue. It is safe to use this macro from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendToFrontFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendToFromFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): +
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPrioritTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendToFrontFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		taskYIELD ();
+	}
+ }
+ 
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendToFrontFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_FRONT ) + + +/** + * queue. h + *
+ BaseType_t xQueueSendToBackFromISR(
+										 QueueHandle_t xQueue,
+										 const void *pvItemToQueue,
+										 BaseType_t *pxHigherPriorityTaskWoken
+									  );
+ 
+ * + * This is a macro that calls xQueueGenericSendFromISR(). + * + * Post an item to the back of a queue. It is safe to use this macro from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendToBackFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendToBackFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): +
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendToBackFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		taskYIELD ();
+	}
+ }
+ 
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendToBackFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_BACK ) + +/** + * queue. h + *
+ BaseType_t xQueueOverwriteFromISR(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue,
+							  BaseType_t *pxHigherPriorityTaskWoken
+						 );
+ * 
+ * + * A version of xQueueOverwrite() that can be used in an interrupt service + * routine (ISR). + * + * Only for use with queues that can hold a single item - so the queue is either + * empty or full. + * + * Post an item on a queue. If the queue is already full then overwrite the + * value held in the queue. The item is queued by copy, not by reference. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueOverwriteFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueOverwriteFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return xQueueOverwriteFromISR() is a macro that calls + * xQueueGenericSendFromISR(), and therefore has the same return values as + * xQueueSendToFrontFromISR(). However, pdPASS is the only value that can be + * returned because xQueueOverwriteFromISR() will write to the queue even when + * the queue is already full. + * + * Example usage: +
+
+ QueueHandle_t xQueue;
+
+ void vFunction( void *pvParameters )
+ {
+ 	// Create a queue to hold one uint32_t value.  It is strongly
+	// recommended *not* to use xQueueOverwriteFromISR() on queues that can
+	// contain more than one value, and doing so will trigger an assertion
+	// if configASSERT() is defined.
+	xQueue = xQueueCreate( 1, sizeof( uint32_t ) );
+}
+
+void vAnInterruptHandler( void )
+{
+// xHigherPriorityTaskWoken must be set to pdFALSE before it is used.
+BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+uint32_t ulVarToSend, ulValReceived;
+
+	// Write the value 10 to the queue using xQueueOverwriteFromISR().
+	ulVarToSend = 10;
+	xQueueOverwriteFromISR( xQueue, &ulVarToSend, &xHigherPriorityTaskWoken );
+
+	// The queue is full, but calling xQueueOverwriteFromISR() again will still
+	// pass because the value held in the queue will be overwritten with the
+	// new value.
+	ulVarToSend = 100;
+	xQueueOverwriteFromISR( xQueue, &ulVarToSend, &xHigherPriorityTaskWoken );
+
+	// Reading from the queue will now return 100.
+
+	// ...
+
+	if( xHigherPrioritytaskWoken == pdTRUE )
+	{
+		// Writing to the queue caused a task to unblock and the unblocked task
+		// has a priority higher than or equal to the priority of the currently
+		// executing task (the task this interrupt interrupted).  Perform a context
+		// switch so this interrupt returns directly to the unblocked task.
+		portYIELD_FROM_ISR(); // or portEND_SWITCHING_ISR() depending on the port.
+	}
+}
+ 
+ * \defgroup xQueueOverwriteFromISR xQueueOverwriteFromISR + * \ingroup QueueManagement + */ +#define xQueueOverwriteFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueOVERWRITE ) + +/** + * queue. h + *
+ BaseType_t xQueueSendFromISR(
+									 QueueHandle_t xQueue,
+									 const void *pvItemToQueue,
+									 BaseType_t *pxHigherPriorityTaskWoken
+								);
+ 
+ * + * This is a macro that calls xQueueGenericSendFromISR(). It is included + * for backward compatibility with versions of FreeRTOS.org that did not + * include the xQueueSendToBackFromISR() and xQueueSendToFrontFromISR() + * macros. + * + * Post an item to the back of a queue. It is safe to use this function from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): +
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		// Actual macro used here is port specific.
+		portYIELD_FROM_ISR ();
+	}
+ }
+ 
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_BACK ) + +/** + * queue. h + *
+ BaseType_t xQueueGenericSendFromISR(
+										   QueueHandle_t		xQueue,
+										   const	void	*pvItemToQueue,
+										   BaseType_t	*pxHigherPriorityTaskWoken,
+										   BaseType_t	xCopyPosition
+									   );
+ 
+ * + * It is preferred that the macros xQueueSendFromISR(), + * xQueueSendToFrontFromISR() and xQueueSendToBackFromISR() be used in place + * of calling this function directly. xQueueGiveFromISR() is an + * equivalent for use by semaphores that don't actually copy any data. + * + * Post an item on a queue. It is safe to use this function from within an + * interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueGenericSendFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueGenericSendFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @param xCopyPosition Can take the value queueSEND_TO_BACK to place the + * item at the back of the queue, or queueSEND_TO_FRONT to place the item + * at the front of the queue (for high priority messages). + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): +
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWokenByPost;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWokenByPost = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post each byte.
+		xQueueGenericSendFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWokenByPost, queueSEND_TO_BACK );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.  Note that the
+	// name of the yield function required is port specific.
+	if( xHigherPriorityTaskWokenByPost )
+	{
+		taskYIELD_YIELD_FROM_ISR();
+	}
+ }
+ 
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericSendFromISR( QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGiveFromISR( QueueHandle_t xQueue, BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; + +/** + * queue. h + *
+ BaseType_t xQueueReceiveFromISR(
+									   QueueHandle_t	xQueue,
+									   void	*pvBuffer,
+									   BaseType_t *pxTaskWoken
+								   );
+ * 
+ * + * Receive an item from a queue. It is safe to use this function from within an + * interrupt service routine. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param pxTaskWoken A task may be blocked waiting for space to become + * available on the queue. If xQueueReceiveFromISR causes such a task to + * unblock *pxTaskWoken will get set to pdTRUE, otherwise *pxTaskWoken will + * remain unchanged. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: +
+
+ QueueHandle_t xQueue;
+
+ // Function to create a queue and post some values.
+ void vAFunction( void *pvParameters )
+ {
+ char cValueToPost;
+ const TickType_t xTicksToWait = ( TickType_t )0xff;
+
+	// Create a queue capable of containing 10 characters.
+	xQueue = xQueueCreate( 10, sizeof( char ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Post some characters that will be used within an ISR.  If the queue
+	// is full then this task will block for xTicksToWait ticks.
+	cValueToPost = 'a';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+	cValueToPost = 'b';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+
+	// ... keep posting characters ... this task may block when the queue
+	// becomes full.
+
+	cValueToPost = 'c';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+ }
+
+ // ISR that outputs all the characters received on the queue.
+ void vISR_Routine( void )
+ {
+ BaseType_t xTaskWokenByReceive = pdFALSE;
+ char cRxedChar;
+
+	while( xQueueReceiveFromISR( xQueue, ( void * ) &cRxedChar, &xTaskWokenByReceive) )
+	{
+		// A character was received.  Output the character now.
+		vOutputCharacter( cRxedChar );
+
+		// If removing the character from the queue woke the task that was
+		// posting onto the queue cTaskWokenByReceive will have been set to
+		// pdTRUE.  No matter how many times this loop iterates only one
+		// task will be woken.
+	}
+
+	if( cTaskWokenByPost != ( char ) pdFALSE;
+	{
+		taskYIELD ();
+	}
+ }
+ 
+ * \defgroup xQueueReceiveFromISR xQueueReceiveFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueueReceiveFromISR( QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; + +/* + * Utilities to query queues that are safe to use from an ISR. These utilities + * should be used only from witin an ISR, or within a critical section. + */ +BaseType_t xQueueIsQueueEmptyFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +BaseType_t xQueueIsQueueFullFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +UBaseType_t uxQueueMessagesWaitingFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + + +/* + * xQueueAltGenericSend() is an alternative version of xQueueGenericSend(). + * Likewise xQueueAltGenericReceive() is an alternative version of + * xQueueGenericReceive(). + * + * The source code that implements the alternative (Alt) API is much + * simpler because it executes everything from within a critical section. + * This is the approach taken by many other RTOSes, but FreeRTOS.org has the + * preferred fully featured API too. The fully featured API has more + * complex code that takes longer to execute, but makes much less use of + * critical sections. Therefore the alternative API sacrifices interrupt + * responsiveness to gain execution speed, whereas the fully featured API + * sacrifices execution speed to ensure better interrupt responsiveness. + */ +BaseType_t xQueueAltGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, BaseType_t xCopyPosition ); +BaseType_t xQueueAltGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, BaseType_t xJustPeeking ); +#define xQueueAltSendToFront( xQueue, pvItemToQueue, xTicksToWait ) xQueueAltGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_FRONT ) +#define xQueueAltSendToBack( xQueue, pvItemToQueue, xTicksToWait ) xQueueAltGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_BACK ) +#define xQueueAltReceive( xQueue, pvBuffer, xTicksToWait ) xQueueAltGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdFALSE ) +#define xQueueAltPeek( xQueue, pvBuffer, xTicksToWait ) xQueueAltGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdTRUE ) + +/* + * The functions defined above are for passing data to and from tasks. The + * functions below are the equivalents for passing data to and from + * co-routines. + * + * These functions are called from the co-routine macro implementation and + * should not be called directly from application code. Instead use the macro + * wrappers defined within croutine.h. + */ +BaseType_t xQueueCRSendFromISR( QueueHandle_t xQueue, const void *pvItemToQueue, BaseType_t xCoRoutinePreviouslyWoken ); +BaseType_t xQueueCRReceiveFromISR( QueueHandle_t xQueue, void *pvBuffer, BaseType_t *pxTaskWoken ); +BaseType_t xQueueCRSend( QueueHandle_t xQueue, const void *pvItemToQueue, TickType_t xTicksToWait ); +BaseType_t xQueueCRReceive( QueueHandle_t xQueue, void *pvBuffer, TickType_t xTicksToWait ); + +/* + * For internal use only. Use xSemaphoreCreateMutex(), + * xSemaphoreCreateCounting() or xSemaphoreGetMutexHolder() instead of calling + * these functions directly. + */ +QueueHandle_t xQueueCreateMutex( const uint8_t ucQueueType ) PRIVILEGED_FUNCTION; +QueueHandle_t xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount ) PRIVILEGED_FUNCTION; +void* xQueueGetMutexHolder( QueueHandle_t xSemaphore ) PRIVILEGED_FUNCTION; + +/* + * For internal use only. Use xSemaphoreTakeMutexRecursive() or + * xSemaphoreGiveMutexRecursive() instead of calling these functions directly. + */ +BaseType_t xQueueTakeMutexRecursive( QueueHandle_t xMutex, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGiveMutexRecursive( QueueHandle_t pxMutex ) PRIVILEGED_FUNCTION; + +/* + * Reset a queue back to its original empty state. pdPASS is returned if the + * queue is successfully reset. pdFAIL is returned if the queue could not be + * reset because there are tasks blocked on the queue waiting to either + * receive from the queue or send to the queue. + */ +#define xQueueReset( xQueue ) xQueueGenericReset( xQueue, pdFALSE ) + +/* + * The registry is provided as a means for kernel aware debuggers to + * locate queues, semaphores and mutexes. Call vQueueAddToRegistry() add + * a queue, semaphore or mutex handle to the registry if you want the handle + * to be available to a kernel aware debugger. If you are not using a kernel + * aware debugger then this function can be ignored. + * + * configQUEUE_REGISTRY_SIZE defines the maximum number of handles the + * registry can hold. configQUEUE_REGISTRY_SIZE must be greater than 0 + * within FreeRTOSConfig.h for the registry to be available. Its value + * does not effect the number of queues, semaphores and mutexes that can be + * created - just the number that the registry can hold. + * + * @param xQueue The handle of the queue being added to the registry. This + * is the handle returned by a call to xQueueCreate(). Semaphore and mutex + * handles can also be passed in here. + * + * @param pcName The name to be associated with the handle. This is the + * name that the kernel aware debugger will display. The queue registry only + * stores a pointer to the string - so the string must be persistent (global or + * preferably in ROM/Flash), not on the stack. + */ +#if configQUEUE_REGISTRY_SIZE > 0 + void vQueueAddToRegistry( QueueHandle_t xQueue, const char *pcName ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +#endif + +/* + * The registry is provided as a means for kernel aware debuggers to + * locate queues, semaphores and mutexes. Call vQueueAddToRegistry() add + * a queue, semaphore or mutex handle to the registry if you want the handle + * to be available to a kernel aware debugger, and vQueueUnregisterQueue() to + * remove the queue, semaphore or mutex from the register. If you are not using + * a kernel aware debugger then this function can be ignored. + * + * @param xQueue The handle of the queue being removed from the registry. + */ +#if configQUEUE_REGISTRY_SIZE > 0 + void vQueueUnregisterQueue( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +#endif + +/* + * Generic version of the queue creation function, which is in turn called by + * any queue, semaphore or mutex creation function or macro. + */ +QueueHandle_t xQueueGenericCreate( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, const uint8_t ucQueueType ) PRIVILEGED_FUNCTION; + +/* + * Queue sets provide a mechanism to allow a task to block (pend) on a read + * operation from multiple queues or semaphores simultaneously. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * A queue set must be explicitly created using a call to xQueueCreateSet() + * before it can be used. Once created, standard FreeRTOS queues and semaphores + * can be added to the set using calls to xQueueAddToSet(). + * xQueueSelectFromSet() is then used to determine which, if any, of the queues + * or semaphores contained in the set is in a state where a queue read or + * semaphore take operation would be successful. + * + * Note 1: See the documentation on http://wwwFreeRTOS.org/RTOS-queue-sets.html + * for reasons why queue sets are very rarely needed in practice as there are + * simpler methods of blocking on multiple objects. + * + * Note 2: Blocking on a queue set that contains a mutex will not cause the + * mutex holder to inherit the priority of the blocked task. + * + * Note 3: An additional 4 bytes of RAM is required for each space in a every + * queue added to a queue set. Therefore counting semaphores that have a high + * maximum count value should not be added to a queue set. + * + * Note 4: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param uxEventQueueLength Queue sets store events that occur on + * the queues and semaphores contained in the set. uxEventQueueLength specifies + * the maximum number of events that can be queued at once. To be absolutely + * certain that events are not lost uxEventQueueLength should be set to the + * total sum of the length of the queues added to the set, where binary + * semaphores and mutexes have a length of 1, and counting semaphores have a + * length set by their maximum count value. Examples: + * + If a queue set is to hold a queue of length 5, another queue of length 12, + * and a binary semaphore, then uxEventQueueLength should be set to + * (5 + 12 + 1), or 18. + * + If a queue set is to hold three binary semaphores then uxEventQueueLength + * should be set to (1 + 1 + 1 ), or 3. + * + If a queue set is to hold a counting semaphore that has a maximum count of + * 5, and a counting semaphore that has a maximum count of 3, then + * uxEventQueueLength should be set to (5 + 3), or 8. + * + * @return If the queue set is created successfully then a handle to the created + * queue set is returned. Otherwise NULL is returned. + */ +QueueSetHandle_t xQueueCreateSet( const UBaseType_t uxEventQueueLength ) PRIVILEGED_FUNCTION; + +/* + * Adds a queue or semaphore to a queue set that was previously created by a + * call to xQueueCreateSet(). + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * Note 1: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param xQueueOrSemaphore The handle of the queue or semaphore being added to + * the queue set (cast to an QueueSetMemberHandle_t type). + * + * @param xQueueSet The handle of the queue set to which the queue or semaphore + * is being added. + * + * @return If the queue or semaphore was successfully added to the queue set + * then pdPASS is returned. If the queue could not be successfully added to the + * queue set because it is already a member of a different queue set then pdFAIL + * is returned. + */ +BaseType_t xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* + * Removes a queue or semaphore from a queue set. A queue or semaphore can only + * be removed from a set if the queue or semaphore is empty. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * @param xQueueOrSemaphore The handle of the queue or semaphore being removed + * from the queue set (cast to an QueueSetMemberHandle_t type). + * + * @param xQueueSet The handle of the queue set in which the queue or semaphore + * is included. + * + * @return If the queue or semaphore was successfully removed from the queue set + * then pdPASS is returned. If the queue was not in the queue set, or the + * queue (or semaphore) was not empty, then pdFAIL is returned. + */ +BaseType_t xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* + * xQueueSelectFromSet() selects from the members of a queue set a queue or + * semaphore that either contains data (in the case of a queue) or is available + * to take (in the case of a semaphore). xQueueSelectFromSet() effectively + * allows a task to block (pend) on a read operation on all the queues and + * semaphores in a queue set simultaneously. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * Note 1: See the documentation on http://wwwFreeRTOS.org/RTOS-queue-sets.html + * for reasons why queue sets are very rarely needed in practice as there are + * simpler methods of blocking on multiple objects. + * + * Note 2: Blocking on a queue set that contains a mutex will not cause the + * mutex holder to inherit the priority of the blocked task. + * + * Note 3: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param xQueueSet The queue set on which the task will (potentially) block. + * + * @param xTicksToWait The maximum time, in ticks, that the calling task will + * remain in the Blocked state (with other tasks executing) to wait for a member + * of the queue set to be ready for a successful queue read or semaphore take + * operation. + * + * @return xQueueSelectFromSet() will return the handle of a queue (cast to + * a QueueSetMemberHandle_t type) contained in the queue set that contains data, + * or the handle of a semaphore (cast to a QueueSetMemberHandle_t type) contained + * in the queue set that is available, or NULL if no such queue or semaphore + * exists before before the specified block time expires. + */ +QueueSetMemberHandle_t xQueueSelectFromSet( QueueSetHandle_t xQueueSet, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/* + * A version of xQueueSelectFromSet() that can be used from an ISR. + */ +QueueSetMemberHandle_t xQueueSelectFromSetFromISR( QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* Not public API functions. */ +void vQueueWaitForMessageRestricted( QueueHandle_t xQueue, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGenericReset( QueueHandle_t xQueue, BaseType_t xNewQueue ) PRIVILEGED_FUNCTION; +void vQueueSetQueueNumber( QueueHandle_t xQueue, UBaseType_t uxQueueNumber ) PRIVILEGED_FUNCTION; +UBaseType_t uxQueueGetQueueNumber( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +uint8_t ucQueueGetQueueType( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + + +#ifdef __cplusplus +} +#endif + +#endif /* QUEUE_H */ + diff --git a/components/freertos/include/freertos/semphr.h b/components/freertos/include/freertos/semphr.h new file mode 100644 index 000000000..5866ab1ec --- /dev/null +++ b/components/freertos/include/freertos/semphr.h @@ -0,0 +1,844 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef SEMAPHORE_H +#define SEMAPHORE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include semphr.h" +#endif + +#include "queue.h" + +typedef QueueHandle_t SemaphoreHandle_t; + +#define semBINARY_SEMAPHORE_QUEUE_LENGTH ( ( uint8_t ) 1U ) +#define semSEMAPHORE_QUEUE_ITEM_LENGTH ( ( uint8_t ) 0U ) +#define semGIVE_BLOCK_TIME ( ( TickType_t ) 0U ) + + +/** + * semphr. h + *
vSemaphoreCreateBinary( SemaphoreHandle_t xSemaphore )
+ * + * This old vSemaphoreCreateBinary() macro is now deprecated in favour of the + * xSemaphoreCreateBinary() function. Note that binary semaphores created using + * the vSemaphoreCreateBinary() macro are created in a state such that the + * first call to 'take' the semaphore would pass, whereas binary semaphores + * created using xSemaphoreCreateBinary() are created in a state such that the + * the semaphore must first be 'given' before it can be 'taken'. + * + * Macro that implements a semaphore by using the existing queue mechanism. + * The queue length is 1 as this is a binary semaphore. The data size is 0 + * as we don't want to actually store any data - we just want to know if the + * queue is empty or full. + * + * This type of semaphore can be used for pure synchronisation between tasks or + * between an interrupt and a task. The semaphore need not be given back once + * obtained, so one task/interrupt can continuously 'give' the semaphore while + * another continuously 'takes' the semaphore. For this reason this type of + * semaphore does not use a priority inheritance mechanism. For an alternative + * that does use priority inheritance see xSemaphoreCreateMutex(). + * + * @param xSemaphore Handle to the created semaphore. Should be of type SemaphoreHandle_t. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to vSemaphoreCreateBinary ().
+    // This is a macro so pass the variable in directly.
+    vSemaphoreCreateBinary( xSemaphore );
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+ 
+ * \defgroup vSemaphoreCreateBinary vSemaphoreCreateBinary + * \ingroup Semaphores + */ +#define vSemaphoreCreateBinary( xSemaphore ) \ + { \ + ( xSemaphore ) = xQueueGenericCreate( ( UBaseType_t ) 1, semSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_BINARY_SEMAPHORE ); \ + if( ( xSemaphore ) != NULL ) \ + { \ + ( void ) xSemaphoreGive( ( xSemaphore ) ); \ + } \ + } + +/** + * semphr. h + *
SemaphoreHandle_t xSemaphoreCreateBinary( void )
+ * + * The old vSemaphoreCreateBinary() macro is now deprecated in favour of this + * xSemaphoreCreateBinary() function. Note that binary semaphores created using + * the vSemaphoreCreateBinary() macro are created in a state such that the + * first call to 'take' the semaphore would pass, whereas binary semaphores + * created using xSemaphoreCreateBinary() are created in a state such that the + * the semaphore must first be 'given' before it can be 'taken'. + * + * Function that creates a semaphore by using the existing queue mechanism. + * The queue length is 1 as this is a binary semaphore. The data size is 0 + * as nothing is actually stored - all that is important is whether the queue is + * empty or full (the binary semaphore is available or not). + * + * This type of semaphore can be used for pure synchronisation between tasks or + * between an interrupt and a task. The semaphore need not be given back once + * obtained, so one task/interrupt can continuously 'give' the semaphore while + * another continuously 'takes' the semaphore. For this reason this type of + * semaphore does not use a priority inheritance mechanism. For an alternative + * that does use priority inheritance see xSemaphoreCreateMutex(). + * + * @return Handle to the created semaphore. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to vSemaphoreCreateBinary ().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateBinary();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+ 
+ * \defgroup vSemaphoreCreateBinary vSemaphoreCreateBinary + * \ingroup Semaphores + */ +#define xSemaphoreCreateBinary() xQueueGenericCreate( ( UBaseType_t ) 1, semSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_BINARY_SEMAPHORE ) + +/** + * semphr. h + *
xSemaphoreTake(
+ *                   SemaphoreHandle_t xSemaphore,
+ *                   TickType_t xBlockTime
+ *               )
+ * + * Macro to obtain a semaphore. The semaphore must have previously been + * created with a call to vSemaphoreCreateBinary(), xSemaphoreCreateMutex() or + * xSemaphoreCreateCounting(). + * + * @param xSemaphore A handle to the semaphore being taken - obtained when + * the semaphore was created. + * + * @param xBlockTime The time in ticks to wait for the semaphore to become + * available. The macro portTICK_PERIOD_MS can be used to convert this to a + * real time. A block time of zero can be used to poll the semaphore. A block + * time of portMAX_DELAY can be used to block indefinitely (provided + * INCLUDE_vTaskSuspend is set to 1 in FreeRTOSConfig.h). + * + * @return pdTRUE if the semaphore was obtained. pdFALSE + * if xBlockTime expired without the semaphore becoming available. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ // A task that creates a semaphore.
+ void vATask( void * pvParameters )
+ {
+    // Create the semaphore to guard a shared resource.
+    vSemaphoreCreateBinary( xSemaphore );
+ }
+
+ // A task that uses the semaphore.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xSemaphore != NULL )
+    {
+        // See if we can obtain the semaphore.  If the semaphore is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTake( xSemaphore, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the semaphore and can now access the
+            // shared resource.
+
+            // ...
+
+            // We have finished accessing the shared resource.  Release the
+            // semaphore.
+            xSemaphoreGive( xSemaphore );
+        }
+        else
+        {
+            // We could not obtain the semaphore and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+ 
+ * \defgroup xSemaphoreTake xSemaphoreTake + * \ingroup Semaphores + */ +#define xSemaphoreTake( xSemaphore, xBlockTime ) xQueueGenericReceive( ( QueueHandle_t ) ( xSemaphore ), NULL, ( xBlockTime ), pdFALSE ) + +/** + * semphr. h + * xSemaphoreTakeRecursive( + * SemaphoreHandle_t xMutex, + * TickType_t xBlockTime + * ) + * + * Macro to recursively obtain, or 'take', a mutex type semaphore. + * The mutex must have previously been created using a call to + * xSemaphoreCreateRecursiveMutex(); + * + * configUSE_RECURSIVE_MUTEXES must be set to 1 in FreeRTOSConfig.h for this + * macro to be available. + * + * This macro must not be used on mutexes created using xSemaphoreCreateMutex(). + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * @param xMutex A handle to the mutex being obtained. This is the + * handle returned by xSemaphoreCreateRecursiveMutex(); + * + * @param xBlockTime The time in ticks to wait for the semaphore to become + * available. The macro portTICK_PERIOD_MS can be used to convert this to a + * real time. A block time of zero can be used to poll the semaphore. If + * the task already owns the semaphore then xSemaphoreTakeRecursive() will + * return immediately no matter what the value of xBlockTime. + * + * @return pdTRUE if the semaphore was obtained. pdFALSE if xBlockTime + * expired without the semaphore becoming available. + * + * Example usage: +
+ SemaphoreHandle_t xMutex = NULL;
+
+ // A task that creates a mutex.
+ void vATask( void * pvParameters )
+ {
+    // Create the mutex to guard a shared resource.
+    xMutex = xSemaphoreCreateRecursiveMutex();
+ }
+
+ // A task that uses the mutex.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xMutex != NULL )
+    {
+        // See if we can obtain the mutex.  If the mutex is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTakeRecursive( xSemaphore, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the mutex and can now access the
+            // shared resource.
+
+            // ...
+            // For some reason due to the nature of the code further calls to
+			// xSemaphoreTakeRecursive() are made on the same mutex.  In real
+			// code these would not be just sequential calls as this would make
+			// no sense.  Instead the calls are likely to be buried inside
+			// a more complex call structure.
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+
+            // The mutex has now been 'taken' three times, so will not be
+			// available to another task until it has also been given back
+			// three times.  Again it is unlikely that real code would have
+			// these calls sequentially, but instead buried in a more complex
+			// call structure.  This is just for illustrative purposes.
+            xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+
+			// Now the mutex can be taken by other tasks.
+        }
+        else
+        {
+            // We could not obtain the mutex and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+ 
+ * \defgroup xSemaphoreTakeRecursive xSemaphoreTakeRecursive + * \ingroup Semaphores + */ +#define xSemaphoreTakeRecursive( xMutex, xBlockTime ) xQueueTakeMutexRecursive( ( xMutex ), ( xBlockTime ) ) + + +/* + * xSemaphoreAltTake() is an alternative version of xSemaphoreTake(). + * + * The source code that implements the alternative (Alt) API is much + * simpler because it executes everything from within a critical section. + * This is the approach taken by many other RTOSes, but FreeRTOS.org has the + * preferred fully featured API too. The fully featured API has more + * complex code that takes longer to execute, but makes much less use of + * critical sections. Therefore the alternative API sacrifices interrupt + * responsiveness to gain execution speed, whereas the fully featured API + * sacrifices execution speed to ensure better interrupt responsiveness. + */ +#define xSemaphoreAltTake( xSemaphore, xBlockTime ) xQueueAltGenericReceive( ( QueueHandle_t ) ( xSemaphore ), NULL, ( xBlockTime ), pdFALSE ) + +/** + * semphr. h + *
xSemaphoreGive( SemaphoreHandle_t xSemaphore )
+ * + * Macro to release a semaphore. The semaphore must have previously been + * created with a call to vSemaphoreCreateBinary(), xSemaphoreCreateMutex() or + * xSemaphoreCreateCounting(). and obtained using sSemaphoreTake(). + * + * This macro must not be used from an ISR. See xSemaphoreGiveFromISR () for + * an alternative which can be used from an ISR. + * + * This macro must also not be used on semaphores created using + * xSemaphoreCreateRecursiveMutex(). + * + * @param xSemaphore A handle to the semaphore being released. This is the + * handle returned when the semaphore was created. + * + * @return pdTRUE if the semaphore was released. pdFALSE if an error occurred. + * Semaphores are implemented using queues. An error can occur if there is + * no space on the queue to post a message - indicating that the + * semaphore was not first obtained correctly. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Create the semaphore to guard a shared resource.
+    vSemaphoreCreateBinary( xSemaphore );
+
+    if( xSemaphore != NULL )
+    {
+        if( xSemaphoreGive( xSemaphore ) != pdTRUE )
+        {
+            // We would expect this call to fail because we cannot give
+            // a semaphore without first "taking" it!
+        }
+
+        // Obtain the semaphore - don't block if the semaphore is not
+        // immediately available.
+        if( xSemaphoreTake( xSemaphore, ( TickType_t ) 0 ) )
+        {
+            // We now have the semaphore and can access the shared resource.
+
+            // ...
+
+            // We have finished accessing the shared resource so can free the
+            // semaphore.
+            if( xSemaphoreGive( xSemaphore ) != pdTRUE )
+            {
+                // We would not expect this call to fail because we must have
+                // obtained the semaphore to get here.
+            }
+        }
+    }
+ }
+ 
+ * \defgroup xSemaphoreGive xSemaphoreGive + * \ingroup Semaphores + */ +#define xSemaphoreGive( xSemaphore ) xQueueGenericSend( ( QueueHandle_t ) ( xSemaphore ), NULL, semGIVE_BLOCK_TIME, queueSEND_TO_BACK ) + +/** + * semphr. h + *
xSemaphoreGiveRecursive( SemaphoreHandle_t xMutex )
+ * + * Macro to recursively release, or 'give', a mutex type semaphore. + * The mutex must have previously been created using a call to + * xSemaphoreCreateRecursiveMutex(); + * + * configUSE_RECURSIVE_MUTEXES must be set to 1 in FreeRTOSConfig.h for this + * macro to be available. + * + * This macro must not be used on mutexes created using xSemaphoreCreateMutex(). + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * @param xMutex A handle to the mutex being released, or 'given'. This is the + * handle returned by xSemaphoreCreateMutex(); + * + * @return pdTRUE if the semaphore was given. + * + * Example usage: +
+ SemaphoreHandle_t xMutex = NULL;
+
+ // A task that creates a mutex.
+ void vATask( void * pvParameters )
+ {
+    // Create the mutex to guard a shared resource.
+    xMutex = xSemaphoreCreateRecursiveMutex();
+ }
+
+ // A task that uses the mutex.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xMutex != NULL )
+    {
+        // See if we can obtain the mutex.  If the mutex is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the mutex and can now access the
+            // shared resource.
+
+            // ...
+            // For some reason due to the nature of the code further calls to
+			// xSemaphoreTakeRecursive() are made on the same mutex.  In real
+			// code these would not be just sequential calls as this would make
+			// no sense.  Instead the calls are likely to be buried inside
+			// a more complex call structure.
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+
+            // The mutex has now been 'taken' three times, so will not be
+			// available to another task until it has also been given back
+			// three times.  Again it is unlikely that real code would have
+			// these calls sequentially, it would be more likely that the calls
+			// to xSemaphoreGiveRecursive() would be called as a call stack
+			// unwound.  This is just for demonstrative purposes.
+            xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+
+			// Now the mutex can be taken by other tasks.
+        }
+        else
+        {
+            // We could not obtain the mutex and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+ 
+ * \defgroup xSemaphoreGiveRecursive xSemaphoreGiveRecursive + * \ingroup Semaphores + */ +#define xSemaphoreGiveRecursive( xMutex ) xQueueGiveMutexRecursive( ( xMutex ) ) + +/* + * xSemaphoreAltGive() is an alternative version of xSemaphoreGive(). + * + * The source code that implements the alternative (Alt) API is much + * simpler because it executes everything from within a critical section. + * This is the approach taken by many other RTOSes, but FreeRTOS.org has the + * preferred fully featured API too. The fully featured API has more + * complex code that takes longer to execute, but makes much less use of + * critical sections. Therefore the alternative API sacrifices interrupt + * responsiveness to gain execution speed, whereas the fully featured API + * sacrifices execution speed to ensure better interrupt responsiveness. + */ +#define xSemaphoreAltGive( xSemaphore ) xQueueAltGenericSend( ( QueueHandle_t ) ( xSemaphore ), NULL, semGIVE_BLOCK_TIME, queueSEND_TO_BACK ) + +/** + * semphr. h + *
+ xSemaphoreGiveFromISR(
+                          SemaphoreHandle_t xSemaphore,
+                          BaseType_t *pxHigherPriorityTaskWoken
+                      )
+ * + * Macro to release a semaphore. The semaphore must have previously been + * created with a call to vSemaphoreCreateBinary() or xSemaphoreCreateCounting(). + * + * Mutex type semaphores (those created using a call to xSemaphoreCreateMutex()) + * must not be used with this macro. + * + * This macro can be used from an ISR. + * + * @param xSemaphore A handle to the semaphore being released. This is the + * handle returned when the semaphore was created. + * + * @param pxHigherPriorityTaskWoken xSemaphoreGiveFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if giving the semaphore caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xSemaphoreGiveFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the semaphore was successfully given, otherwise errQUEUE_FULL. + * + * Example usage: +
+ \#define LONG_TIME 0xffff
+ \#define TICKS_TO_WAIT	10
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ // Repetitive task.
+ void vATask( void * pvParameters )
+ {
+    for( ;; )
+    {
+        // We want this task to run every 10 ticks of a timer.  The semaphore
+        // was created before this task was started.
+
+        // Block waiting for the semaphore to become available.
+        if( xSemaphoreTake( xSemaphore, LONG_TIME ) == pdTRUE )
+        {
+            // It is time to execute.
+
+            // ...
+
+            // We have finished our task.  Return to the top of the loop where
+            // we will block on the semaphore until it is time to execute
+            // again.  Note when using the semaphore for synchronisation with an
+			// ISR in this manner there is no need to 'give' the semaphore back.
+        }
+    }
+ }
+
+ // Timer ISR
+ void vTimerISR( void * pvParameters )
+ {
+ static uint8_t ucLocalTickCount = 0;
+ static BaseType_t xHigherPriorityTaskWoken;
+
+    // A timer tick has occurred.
+
+    // ... Do other time functions.
+
+    // Is it time for vATask () to run?
+	xHigherPriorityTaskWoken = pdFALSE;
+    ucLocalTickCount++;
+    if( ucLocalTickCount >= TICKS_TO_WAIT )
+    {
+        // Unblock the task by releasing the semaphore.
+        xSemaphoreGiveFromISR( xSemaphore, &xHigherPriorityTaskWoken );
+
+        // Reset the count so we release the semaphore again in 10 ticks time.
+        ucLocalTickCount = 0;
+    }
+
+    if( xHigherPriorityTaskWoken != pdFALSE )
+    {
+        // We can force a context switch here.  Context switching from an
+        // ISR uses port specific syntax.  Check the demo task for your port
+        // to find the syntax required.
+    }
+ }
+ 
+ * \defgroup xSemaphoreGiveFromISR xSemaphoreGiveFromISR + * \ingroup Semaphores + */ +#define xSemaphoreGiveFromISR( xSemaphore, pxHigherPriorityTaskWoken ) xQueueGiveFromISR( ( QueueHandle_t ) ( xSemaphore ), ( pxHigherPriorityTaskWoken ) ) + +/** + * semphr. h + *
+ xSemaphoreTakeFromISR(
+                          SemaphoreHandle_t xSemaphore,
+                          BaseType_t *pxHigherPriorityTaskWoken
+                      )
+ * + * Macro to take a semaphore from an ISR. The semaphore must have + * previously been created with a call to vSemaphoreCreateBinary() or + * xSemaphoreCreateCounting(). + * + * Mutex type semaphores (those created using a call to xSemaphoreCreateMutex()) + * must not be used with this macro. + * + * This macro can be used from an ISR, however taking a semaphore from an ISR + * is not a common operation. It is likely to only be useful when taking a + * counting semaphore when an interrupt is obtaining an object from a resource + * pool (when the semaphore count indicates the number of resources available). + * + * @param xSemaphore A handle to the semaphore being taken. This is the + * handle returned when the semaphore was created. + * + * @param pxHigherPriorityTaskWoken xSemaphoreTakeFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if taking the semaphore caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xSemaphoreTakeFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the semaphore was successfully taken, otherwise + * pdFALSE + */ +#define xSemaphoreTakeFromISR( xSemaphore, pxHigherPriorityTaskWoken ) xQueueReceiveFromISR( ( QueueHandle_t ) ( xSemaphore ), NULL, ( pxHigherPriorityTaskWoken ) ) + +/** + * semphr. h + *
SemaphoreHandle_t xSemaphoreCreateMutex( void )
+ * + * Macro that implements a mutex semaphore by using the existing queue + * mechanism. + * + * Mutexes created using this macro can be accessed using the xSemaphoreTake() + * and xSemaphoreGive() macros. The xSemaphoreTakeRecursive() and + * xSemaphoreGiveRecursive() macros should not be used. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See vSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @return xSemaphore Handle to the created mutex semaphore. Should be of type + * SemaphoreHandle_t. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateMutex().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateMutex();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+ 
+ * \defgroup vSemaphoreCreateMutex vSemaphoreCreateMutex + * \ingroup Semaphores + */ +#define xSemaphoreCreateMutex() xQueueCreateMutex( queueQUEUE_TYPE_MUTEX ) + + +/** + * semphr. h + *
SemaphoreHandle_t xSemaphoreCreateRecursiveMutex( void )
+ * + * Macro that implements a recursive mutex by using the existing queue + * mechanism. + * + * Mutexes created using this macro can be accessed using the + * xSemaphoreTakeRecursive() and xSemaphoreGiveRecursive() macros. The + * xSemaphoreTake() and xSemaphoreGive() macros should not be used. + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See vSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @return xSemaphore Handle to the created mutex semaphore. Should be of type + * SemaphoreHandle_t. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateMutex().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateRecursiveMutex();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+ 
+ * \defgroup vSemaphoreCreateMutex vSemaphoreCreateMutex + * \ingroup Semaphores + */ +#define xSemaphoreCreateRecursiveMutex() xQueueCreateMutex( queueQUEUE_TYPE_RECURSIVE_MUTEX ) + +/** + * semphr. h + *
SemaphoreHandle_t xSemaphoreCreateCounting( UBaseType_t uxMaxCount, UBaseType_t uxInitialCount )
+ * + * Macro that creates a counting semaphore by using the existing + * queue mechanism. + * + * Counting semaphores are typically used for two things: + * + * 1) Counting events. + * + * In this usage scenario an event handler will 'give' a semaphore each time + * an event occurs (incrementing the semaphore count value), and a handler + * task will 'take' a semaphore each time it processes an event + * (decrementing the semaphore count value). The count value is therefore + * the difference between the number of events that have occurred and the + * number that have been processed. In this case it is desirable for the + * initial count value to be zero. + * + * 2) Resource management. + * + * In this usage scenario the count value indicates the number of resources + * available. To obtain control of a resource a task must first obtain a + * semaphore - decrementing the semaphore count value. When the count value + * reaches zero there are no free resources. When a task finishes with the + * resource it 'gives' the semaphore back - incrementing the semaphore count + * value. In this case it is desirable for the initial count value to be + * equal to the maximum count value, indicating that all resources are free. + * + * @param uxMaxCount The maximum count value that can be reached. When the + * semaphore reaches this value it can no longer be 'given'. + * + * @param uxInitialCount The count value assigned to the semaphore when it is + * created. + * + * @return Handle to the created semaphore. Null if the semaphore could not be + * created. + * + * Example usage: +
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+ SemaphoreHandle_t xSemaphore = NULL;
+
+    // Semaphore cannot be used before a call to xSemaphoreCreateCounting().
+    // The max value to which the semaphore can count should be 10, and the
+    // initial value assigned to the count should be 0.
+    xSemaphore = xSemaphoreCreateCounting( 10, 0 );
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+ 
+ * \defgroup xSemaphoreCreateCounting xSemaphoreCreateCounting + * \ingroup Semaphores + */ +#define xSemaphoreCreateCounting( uxMaxCount, uxInitialCount ) xQueueCreateCountingSemaphore( ( uxMaxCount ), ( uxInitialCount ) ) + +/** + * semphr. h + *
void vSemaphoreDelete( SemaphoreHandle_t xSemaphore );
+ * + * Delete a semaphore. This function must be used with care. For example, + * do not delete a mutex type semaphore if the mutex is held by a task. + * + * @param xSemaphore A handle to the semaphore to be deleted. + * + * \defgroup vSemaphoreDelete vSemaphoreDelete + * \ingroup Semaphores + */ +#define vSemaphoreDelete( xSemaphore ) vQueueDelete( ( QueueHandle_t ) ( xSemaphore ) ) + +/** + * semphr.h + *
TaskHandle_t xSemaphoreGetMutexHolder( SemaphoreHandle_t xMutex );
+ * + * If xMutex is indeed a mutex type semaphore, return the current mutex holder. + * If xMutex is not a mutex type semaphore, or the mutex is available (not held + * by a task), return NULL. + * + * Note: This is a good way of determining if the calling task is the mutex + * holder, but not a good way of determining the identity of the mutex holder as + * the holder may change between the function exiting and the returned value + * being tested. + */ +#define xSemaphoreGetMutexHolder( xSemaphore ) xQueueGetMutexHolder( ( xSemaphore ) ) + +#endif /* SEMAPHORE_H */ + + diff --git a/components/freertos/include/freertos/task.h b/components/freertos/include/freertos/task.h new file mode 100644 index 000000000..d4b9d43c8 --- /dev/null +++ b/components/freertos/include/freertos/task.h @@ -0,0 +1,2019 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef INC_TASK_H +#define INC_TASK_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h must appear in source files before include task.h" +#endif + +#include "list.h" +#include "portmacro.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/*----------------------------------------------------------- + * MACROS AND DEFINITIONS + *----------------------------------------------------------*/ + +#define tskKERNEL_VERSION_NUMBER "V8.2.0" +#define tskKERNEL_VERSION_MAJOR 8 +#define tskKERNEL_VERSION_MINOR 2 +#define tskKERNEL_VERSION_BUILD 0 + +#define tskNO_AFFINITY portNUM_PROCESSORS + +/** + * task. h + * + * Type by which tasks are referenced. For example, a call to xTaskCreate + * returns (via a pointer parameter) an TaskHandle_t variable that can then + * be used as a parameter to vTaskDelete to delete the task. + * + * \defgroup TaskHandle_t TaskHandle_t + * \ingroup Tasks + */ +typedef void * TaskHandle_t; + +/* + * Defines the prototype to which the application task hook function must + * conform. + */ +typedef BaseType_t (*TaskHookFunction_t)( void * ); + +/* Task states returned by eTaskGetState. */ +typedef enum +{ + eRunning = 0, /* A task is querying the state of itself, so must be running. */ + eReady, /* The task being queried is in a read or pending ready list. */ + eBlocked, /* The task being queried is in the Blocked state. */ + eSuspended, /* The task being queried is in the Suspended state, or is in the Blocked state with an infinite time out. */ + eDeleted /* The task being queried has been deleted, but its TCB has not yet been freed. */ +} eTaskState; + +/* Actions that can be performed when vTaskNotify() is called. */ +typedef enum +{ + eNoAction = 0, /* Notify the task without updating its notify value. */ + eSetBits, /* Set bits in the task's notification value. */ + eIncrement, /* Increment the task's notification value. */ + eSetValueWithOverwrite, /* Set the task's notification value to a specific value even if the previous value has not yet been read by the task. */ + eSetValueWithoutOverwrite /* Set the task's notification value if the previous value has been read by the task. */ +} eNotifyAction; + +/* + * Used internally only. + */ +typedef struct xTIME_OUT +{ + BaseType_t xOverflowCount; + TickType_t xTimeOnEntering; +} TimeOut_t; + +/* + * Defines the memory ranges allocated to the task when an MPU is used. + */ +typedef struct xMEMORY_REGION +{ + void *pvBaseAddress; + uint32_t ulLengthInBytes; + uint32_t ulParameters; +} MemoryRegion_t; + +/* + * Parameters required to create an MPU protected task. + */ +typedef struct xTASK_PARAMETERS +{ + TaskFunction_t pvTaskCode; + const char * const pcName; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + uint16_t usStackDepth; + void *pvParameters; + UBaseType_t uxPriority; + StackType_t *puxStackBuffer; + MemoryRegion_t xRegions[ portNUM_CONFIGURABLE_REGIONS ]; +} TaskParameters_t; + +/* Used with the uxTaskGetSystemState() function to return the state of each task +in the system. */ +typedef struct xTASK_STATUS +{ + TaskHandle_t xHandle; /* The handle of the task to which the rest of the information in the structure relates. */ + const char *pcTaskName; /* A pointer to the task's name. This value will be invalid if the task was deleted since the structure was populated! */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + UBaseType_t xTaskNumber; /* A number unique to the task. */ + eTaskState eCurrentState; /* The state in which the task existed when the structure was populated. */ + UBaseType_t uxCurrentPriority; /* The priority at which the task was running (may be inherited) when the structure was populated. */ + UBaseType_t uxBasePriority; /* The priority to which the task will return if the task's current priority has been inherited to avoid unbounded priority inversion when obtaining a mutex. Only valid if configUSE_MUTEXES is defined as 1 in FreeRTOSConfig.h. */ + uint32_t ulRunTimeCounter; /* The total run time allocated to the task so far, as defined by the run time stats clock. See http://www.freertos.org/rtos-run-time-stats.html. Only valid when configGENERATE_RUN_TIME_STATS is defined as 1 in FreeRTOSConfig.h. */ + uint16_t usStackHighWaterMark; /* The minimum amount of stack space that has remained for the task since the task was created. The closer this value is to zero the closer the task has come to overflowing its stack. */ +} TaskStatus_t; + +/* Possible return values for eTaskConfirmSleepModeStatus(). */ +typedef enum +{ + eAbortSleep = 0, /* A task has been made ready or a context switch pended since portSUPPORESS_TICKS_AND_SLEEP() was called - abort entering a sleep mode. */ + eStandardSleep, /* Enter a sleep mode that will not last any longer than the expected idle time. */ + eNoTasksWaitingTimeout /* No tasks are waiting for a timeout so it is safe to enter a sleep mode that can only be exited by an external interrupt. */ +} eSleepModeStatus; + + +/** + * Defines the priority used by the idle task. This must not be modified. + * + * \ingroup TaskUtils + */ +#define tskIDLE_PRIORITY ( ( UBaseType_t ) 0U ) + +/** + * task. h + * + * Macro for forcing a context switch. + * + * \defgroup taskYIELD taskYIELD + * \ingroup SchedulerControl + */ +#define taskYIELD() portYIELD() + +/** + * task. h + * + * Macro to mark the start of a critical code region. Preemptive context + * switches cannot occur when in a critical region. + * + * NOTE: This may alter the stack (depending on the portable implementation) + * so must be used with care! + * + * \defgroup taskENTER_CRITICAL taskENTER_CRITICAL + * \ingroup SchedulerControl + */ +#define taskENTER_CRITICAL(mux) portENTER_CRITICAL(mux) +#define taskENTER_CRITICAL_ISR(mux) portENTER_CRITICAL_ISR(mux) + +/** + * task. h + * + * Macro to mark the end of a critical code region. Preemptive context + * switches cannot occur when in a critical region. + * + * NOTE: This may alter the stack (depending on the portable implementation) + * so must be used with care! + * + * \defgroup taskEXIT_CRITICAL taskEXIT_CRITICAL + * \ingroup SchedulerControl + */ +#define taskEXIT_CRITICAL(mux) portEXIT_CRITICAL(mux) +#define taskEXIT_CRITICAL_ISR(mux) portEXIT_CRITICAL_ISR(mux) + +/** + * task. h + * + * Macro to disable all maskable interrupts. + * + * \defgroup taskDISABLE_INTERRUPTS taskDISABLE_INTERRUPTS + * \ingroup SchedulerControl + */ +#define taskDISABLE_INTERRUPTS() portDISABLE_INTERRUPTS() + +/** + * task. h + * + * Macro to enable microcontroller interrupts. + * + * \defgroup taskENABLE_INTERRUPTS taskENABLE_INTERRUPTS + * \ingroup SchedulerControl + */ +#define taskENABLE_INTERRUPTS() portENABLE_INTERRUPTS() + +/* Definitions returned by xTaskGetSchedulerState(). taskSCHEDULER_SUSPENDED is +0 to generate more optimal code when configASSERT() is defined as the constant +is used in assert() statements. */ +#define taskSCHEDULER_SUSPENDED ( ( BaseType_t ) 0 ) +#define taskSCHEDULER_NOT_STARTED ( ( BaseType_t ) 1 ) +#define taskSCHEDULER_RUNNING ( ( BaseType_t ) 2 ) + + +/*----------------------------------------------------------- + * TASK CREATION API + *----------------------------------------------------------*/ + +/** + * task. h + *
+ BaseType_t xTaskCreate(
+							  TaskFunction_t pvTaskCode,
+							  const char * const pcName,
+							  uint16_t usStackDepth,
+							  void *pvParameters,
+							  UBaseType_t uxPriority,
+							  TaskHandle_t *pvCreatedTask
+						  );
+ * + * Create a new task and add it to the list of tasks that are ready to run. + * On multicore environments, this will give no specific affinity to the task. + * Use xTaskCreatePinnedToCore to give affinity. + * + * xTaskCreate() can only be used to create a task that has unrestricted + * access to the entire microcontroller memory map. Systems that include MPU + * support can alternatively create an MPU constrained task using + * xTaskCreateRestricted(). + * + * @param pvTaskCode Pointer to the task entry function. Tasks + * must be implemented to never return (i.e. continuous loop). + * + * @param pcName A descriptive name for the task. This is mainly used to + * facilitate debugging. Max length defined by configMAX_TASK_NAME_LEN - default + * is 16. + * + * @param usStackDepth The size of the task stack specified as the number of + * variables the stack can hold - not the number of bytes. For example, if + * the stack is 16 bits wide and usStackDepth is defined as 100, 200 bytes + * will be allocated for stack storage. + * + * @param pvParameters Pointer that will be used as the parameter for the task + * being created. + * + * @param uxPriority The priority at which the task should run. Systems that + * include MPU support can optionally create tasks in a privileged (system) + * mode by setting bit portPRIVILEGE_BIT of the priority parameter. For + * example, to create a privileged task at priority 2 the uxPriority parameter + * should be set to ( 2 | portPRIVILEGE_BIT ). + * + * @param pvCreatedTask Used to pass back a handle by which the created task + * can be referenced. + * + * @return pdPASS if the task was successfully created and added to a ready + * list, otherwise an error code defined in the file projdefs.h + * + * Example usage: +
+ // Task to be created.
+ void vTaskCode( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+	 }
+ }
+
+ // Function that creates a task.
+ void vOtherFunction( void )
+ {
+ static uint8_t ucParameterToPass;
+ TaskHandle_t xHandle = NULL;
+
+	 // Create the task, storing the handle.  Note that the passed parameter ucParameterToPass
+	 // must exist for the lifetime of the task, so in this case is declared static.  If it was just an
+	 // an automatic stack variable it might no longer exist, or at least have been corrupted, by the time
+	 // the new task attempts to access it.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, &ucParameterToPass, tskIDLE_PRIORITY, &xHandle );
+     configASSERT( xHandle );
+
+	 // Use the handle to delete the task.
+     if( xHandle != NULL )
+     {
+	     vTaskDelete( xHandle );
+     }
+ }
+   
+ * \defgroup xTaskCreate xTaskCreate + * \ingroup Tasks + */ +#define xTaskCreate( pvTaskCode, pcName, usStackDepth, pvParameters, uxPriority, pxCreatedTask ) xTaskGenericCreate( ( pvTaskCode ), ( pcName ), ( usStackDepth ), ( pvParameters ), ( uxPriority ), ( pxCreatedTask ), ( NULL ), ( NULL ), tskNO_AFFINITY ) +#define xTaskCreatePinnedToCore( pvTaskCode, pcName, usStackDepth, pvParameters, uxPriority, pxCreatedTask, xCoreID ) xTaskGenericCreate( ( pvTaskCode ), ( pcName ), ( usStackDepth ), ( pvParameters ), ( uxPriority ), ( pxCreatedTask ), ( NULL ), ( NULL ), xCoreID ) + +/** + * task. h + *
+ BaseType_t xTaskCreateRestricted( TaskParameters_t *pxTaskDefinition, TaskHandle_t *pxCreatedTask );
+ * + * xTaskCreateRestricted() should only be used in systems that include an MPU + * implementation. + * + * Create a new task and add it to the list of tasks that are ready to run. + * The function parameters define the memory regions and associated access + * permissions allocated to the task. + * + * @param pxTaskDefinition Pointer to a structure that contains a member + * for each of the normal xTaskCreate() parameters (see the xTaskCreate() API + * documentation) plus an optional stack buffer and the memory region + * definitions. + * + * @param pxCreatedTask Used to pass back a handle by which the created task + * can be referenced. + * + * @return pdPASS if the task was successfully created and added to a ready + * list, otherwise an error code defined in the file projdefs.h + * + * Example usage: +
+// Create an TaskParameters_t structure that defines the task to be created.
+static const TaskParameters_t xCheckTaskParameters =
+{
+	vATask,		// pvTaskCode - the function that implements the task.
+	"ATask",	// pcName - just a text name for the task to assist debugging.
+	100,		// usStackDepth	- the stack size DEFINED IN WORDS.
+	NULL,		// pvParameters - passed into the task function as the function parameters.
+	( 1UL | portPRIVILEGE_BIT ),// uxPriority - task priority, set the portPRIVILEGE_BIT if the task should run in a privileged state.
+	cStackBuffer,// puxStackBuffer - the buffer to be used as the task stack.
+
+	// xRegions - Allocate up to three separate memory regions for access by
+	// the task, with appropriate access permissions.  Different processors have
+	// different memory alignment requirements - refer to the FreeRTOS documentation
+	// for full information.
+	{
+		// Base address					Length	Parameters
+        { cReadWriteArray,				32,		portMPU_REGION_READ_WRITE },
+        { cReadOnlyArray,				32,		portMPU_REGION_READ_ONLY },
+        { cPrivilegedOnlyAccessArray,	128,	portMPU_REGION_PRIVILEGED_READ_WRITE }
+	}
+};
+
+int main( void )
+{
+TaskHandle_t xHandle;
+
+	// Create a task from the const structure defined above.  The task handle
+	// is requested (the second parameter is not NULL) but in this case just for
+	// demonstration purposes as its not actually used.
+	xTaskCreateRestricted( &xRegTest1Parameters, &xHandle );
+
+	// Start the scheduler.
+	vTaskStartScheduler();
+
+	// Will only get here if there was insufficient memory to create the idle
+	// and/or timer task.
+	for( ;; );
+}
+   
+ * \defgroup xTaskCreateRestricted xTaskCreateRestricted + * \ingroup Tasks + */ +#define xTaskCreateRestricted( x, pxCreatedTask ) xTaskGenericCreate( ((x)->pvTaskCode), ((x)->pcName), ((x)->usStackDepth), ((x)->pvParameters), ((x)->uxPriority), (pxCreatedTask), ((x)->puxStackBuffer), ((x)->xRegions) ) + +/** + * task. h + *
+ void vTaskAllocateMPURegions( TaskHandle_t xTask, const MemoryRegion_t * const pxRegions );
+ * + * Memory regions are assigned to a restricted task when the task is created by + * a call to xTaskCreateRestricted(). These regions can be redefined using + * vTaskAllocateMPURegions(). + * + * @param xTask The handle of the task being updated. + * + * @param xRegions A pointer to an MemoryRegion_t structure that contains the + * new memory region definitions. + * + * Example usage: +
+// Define an array of MemoryRegion_t structures that configures an MPU region
+// allowing read/write access for 1024 bytes starting at the beginning of the
+// ucOneKByte array.  The other two of the maximum 3 definable regions are
+// unused so set to zero.
+static const MemoryRegion_t xAltRegions[ portNUM_CONFIGURABLE_REGIONS ] =
+{
+	// Base address		Length		Parameters
+	{ ucOneKByte,		1024,		portMPU_REGION_READ_WRITE },
+	{ 0,				0,			0 },
+	{ 0,				0,			0 }
+};
+
+void vATask( void *pvParameters )
+{
+	// This task was created such that it has access to certain regions of
+	// memory as defined by the MPU configuration.  At some point it is
+	// desired that these MPU regions are replaced with that defined in the
+	// xAltRegions const struct above.  Use a call to vTaskAllocateMPURegions()
+	// for this purpose.  NULL is used as the task handle to indicate that this
+	// function should modify the MPU regions of the calling task.
+	vTaskAllocateMPURegions( NULL, xAltRegions );
+
+	// Now the task can continue its function, but from this point on can only
+	// access its stack and the ucOneKByte array (unless any other statically
+	// defined or shared regions have been declared elsewhere).
+}
+   
+ * \defgroup xTaskCreateRestricted xTaskCreateRestricted + * \ingroup Tasks + */ +void vTaskAllocateMPURegions( TaskHandle_t xTask, const MemoryRegion_t * const pxRegions ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskDelete( TaskHandle_t xTask );
+ * + * INCLUDE_vTaskDelete must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Remove a task from the RTOS real time kernel's management. The task being + * deleted will be removed from all ready, blocked, suspended and event lists. + * + * NOTE: The idle task is responsible for freeing the kernel allocated + * memory from tasks that have been deleted. It is therefore important that + * the idle task is not starved of microcontroller processing time if your + * application makes any calls to vTaskDelete (). Memory allocated by the + * task code is not automatically freed, and should be freed before the task + * is deleted. + * + * See the demo application file death.c for sample code that utilises + * vTaskDelete (). + * + * @param xTask The handle of the task to be deleted. Passing NULL will + * cause the calling task to be deleted. + * + * Example usage: +
+ void vOtherFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create the task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // Use the handle to delete the task.
+	 vTaskDelete( xHandle );
+ }
+   
+ * \defgroup vTaskDelete vTaskDelete + * \ingroup Tasks + */ +void vTaskDelete( TaskHandle_t xTaskToDelete ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * TASK CONTROL API + *----------------------------------------------------------*/ + +/** + * task. h + *
void vTaskDelay( const TickType_t xTicksToDelay );
+ * + * Delay a task for a given number of ticks. The actual time that the + * task remains blocked depends on the tick rate. The constant + * portTICK_PERIOD_MS can be used to calculate real time from the tick + * rate - with the resolution of one tick period. + * + * INCLUDE_vTaskDelay must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * + * vTaskDelay() specifies a time at which the task wishes to unblock relative to + * the time at which vTaskDelay() is called. For example, specifying a block + * period of 100 ticks will cause the task to unblock 100 ticks after + * vTaskDelay() is called. vTaskDelay() does not therefore provide a good method + * of controlling the frequency of a periodic task as the path taken through the + * code, as well as other task and interrupt activity, will effect the frequency + * at which vTaskDelay() gets called and therefore the time at which the task + * next executes. See vTaskDelayUntil() for an alternative API function designed + * to facilitate fixed frequency execution. It does this by specifying an + * absolute time (rather than a relative time) at which the calling task should + * unblock. + * + * @param xTicksToDelay The amount of time, in tick periods, that + * the calling task should block. + * + * Example usage: + + void vTaskFunction( void * pvParameters ) + { + // Block for 500ms. + const TickType_t xDelay = 500 / portTICK_PERIOD_MS; + + for( ;; ) + { + // Simply toggle the LED every 500ms, blocking between each toggle. + vToggleLED(); + vTaskDelay( xDelay ); + } + } + + * \defgroup vTaskDelay vTaskDelay + * \ingroup TaskCtrl + */ +void vTaskDelay( const TickType_t xTicksToDelay ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskDelayUntil( TickType_t *pxPreviousWakeTime, const TickType_t xTimeIncrement );
+ * + * INCLUDE_vTaskDelayUntil must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Delay a task until a specified time. This function can be used by periodic + * tasks to ensure a constant execution frequency. + * + * This function differs from vTaskDelay () in one important aspect: vTaskDelay () will + * cause a task to block for the specified number of ticks from the time vTaskDelay () is + * called. It is therefore difficult to use vTaskDelay () by itself to generate a fixed + * execution frequency as the time between a task starting to execute and that task + * calling vTaskDelay () may not be fixed [the task may take a different path though the + * code between calls, or may get interrupted or preempted a different number of times + * each time it executes]. + * + * Whereas vTaskDelay () specifies a wake time relative to the time at which the function + * is called, vTaskDelayUntil () specifies the absolute (exact) time at which it wishes to + * unblock. + * + * The constant portTICK_PERIOD_MS can be used to calculate real time from the tick + * rate - with the resolution of one tick period. + * + * @param pxPreviousWakeTime Pointer to a variable that holds the time at which the + * task was last unblocked. The variable must be initialised with the current time + * prior to its first use (see the example below). Following this the variable is + * automatically updated within vTaskDelayUntil (). + * + * @param xTimeIncrement The cycle time period. The task will be unblocked at + * time *pxPreviousWakeTime + xTimeIncrement. Calling vTaskDelayUntil with the + * same xTimeIncrement parameter value will cause the task to execute with + * a fixed interface period. + * + * Example usage: +
+ // Perform an action every 10 ticks.
+ void vTaskFunction( void * pvParameters )
+ {
+ TickType_t xLastWakeTime;
+ const TickType_t xFrequency = 10;
+
+	 // Initialise the xLastWakeTime variable with the current time.
+	 xLastWakeTime = xTaskGetTickCount ();
+	 for( ;; )
+	 {
+		 // Wait for the next cycle.
+		 vTaskDelayUntil( &xLastWakeTime, xFrequency );
+
+		 // Perform action here.
+	 }
+ }
+   
+ * \defgroup vTaskDelayUntil vTaskDelayUntil + * \ingroup TaskCtrl + */ +void vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask );
+ * + * INCLUDE_uxTaskPriorityGet must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Obtain the priority of any task. + * + * @param xTask Handle of the task to be queried. Passing a NULL + * handle results in the priority of the calling task being returned. + * + * @return The priority of xTask. + * + * Example usage: +
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to obtain the priority of the created task.
+	 // It was created with tskIDLE_PRIORITY, but may have changed
+	 // it itself.
+	 if( uxTaskPriorityGet( xHandle ) != tskIDLE_PRIORITY )
+	 {
+		 // The task has changed it's priority.
+	 }
+
+	 // ...
+
+	 // Is our priority higher than the created task?
+	 if( uxTaskPriorityGet( xHandle ) < uxTaskPriorityGet( NULL ) )
+	 {
+		 // Our priority (obtained using NULL handle) is higher.
+	 }
+ }
+   
+ * \defgroup uxTaskPriorityGet uxTaskPriorityGet + * \ingroup TaskCtrl + */ +UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask );
+ * + * A version of uxTaskPriorityGet() that can be used from an ISR. + */ +UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
eTaskState eTaskGetState( TaskHandle_t xTask );
+ * + * INCLUDE_eTaskGetState must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Obtain the state of any task. States are encoded by the eTaskState + * enumerated type. + * + * @param xTask Handle of the task to be queried. + * + * @return The state of xTask at the time the function was called. Note the + * state of the task might change between the function being called, and the + * functions return value being tested by the calling task. + */ +eTaskState eTaskGetState( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority );
+ * + * INCLUDE_vTaskPrioritySet must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Set the priority of any task. + * + * A context switch will occur before the function returns if the priority + * being set is higher than the currently executing task. + * + * @param xTask Handle to the task for which the priority is being set. + * Passing a NULL handle results in the priority of the calling task being set. + * + * @param uxNewPriority The priority to which the task will be set. + * + * Example usage: +
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to raise the priority of the created task.
+	 vTaskPrioritySet( xHandle, tskIDLE_PRIORITY + 1 );
+
+	 // ...
+
+	 // Use a NULL handle to raise our priority to the same value.
+	 vTaskPrioritySet( NULL, tskIDLE_PRIORITY + 1 );
+ }
+   
+ * \defgroup vTaskPrioritySet vTaskPrioritySet + * \ingroup TaskCtrl + */ +void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskSuspend( TaskHandle_t xTaskToSuspend );
+ * + * INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Suspend any task. When suspended a task will never get any microcontroller + * processing time, no matter what its priority. + * + * Calls to vTaskSuspend are not accumulative - + * i.e. calling vTaskSuspend () twice on the same task still only requires one + * call to vTaskResume () to ready the suspended task. + * + * @param xTaskToSuspend Handle to the task being suspended. Passing a NULL + * handle will cause the calling task to be suspended. + * + * Example usage: +
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to suspend the created task.
+	 vTaskSuspend( xHandle );
+
+	 // ...
+
+	 // The created task will not run during this period, unless
+	 // another task calls vTaskResume( xHandle ).
+
+	 //...
+
+
+	 // Suspend ourselves.
+	 vTaskSuspend( NULL );
+
+	 // We cannot get here unless another task calls vTaskResume
+	 // with our handle as the parameter.
+ }
+   
+ * \defgroup vTaskSuspend vTaskSuspend + * \ingroup TaskCtrl + */ +void vTaskSuspend( TaskHandle_t xTaskToSuspend ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskResume( TaskHandle_t xTaskToResume );
+ * + * INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Resumes a suspended task. + * + * A task that has been suspended by one or more calls to vTaskSuspend () + * will be made available for running again by a single call to + * vTaskResume (). + * + * @param xTaskToResume Handle to the task being readied. + * + * Example usage: +
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to suspend the created task.
+	 vTaskSuspend( xHandle );
+
+	 // ...
+
+	 // The created task will not run during this period, unless
+	 // another task calls vTaskResume( xHandle ).
+
+	 //...
+
+
+	 // Resume the suspended task ourselves.
+	 vTaskResume( xHandle );
+
+	 // The created task will once again get microcontroller processing
+	 // time in accordance with its priority within the system.
+ }
+   
+ * \defgroup vTaskResume vTaskResume + * \ingroup TaskCtrl + */ +void vTaskResume( TaskHandle_t xTaskToResume ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void xTaskResumeFromISR( TaskHandle_t xTaskToResume );
+ * + * INCLUDE_xTaskResumeFromISR must be defined as 1 for this function to be + * available. See the configuration section for more information. + * + * An implementation of vTaskResume() that can be called from within an ISR. + * + * A task that has been suspended by one or more calls to vTaskSuspend () + * will be made available for running again by a single call to + * xTaskResumeFromISR (). + * + * xTaskResumeFromISR() should not be used to synchronise a task with an + * interrupt if there is a chance that the interrupt could arrive prior to the + * task being suspended - as this can lead to interrupts being missed. Use of a + * semaphore as a synchronisation mechanism would avoid this eventuality. + * + * @param xTaskToResume Handle to the task being readied. + * + * @return pdTRUE if resuming the task should result in a context switch, + * otherwise pdFALSE. This is used by the ISR to determine if a context switch + * may be required following the ISR. + * + * \defgroup vTaskResumeFromISR vTaskResumeFromISR + * \ingroup TaskCtrl + */ +BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * SCHEDULER CONTROL + *----------------------------------------------------------*/ + +/** + * task. h + *
void vTaskStartScheduler( void );
+ * + * Starts the real time kernel tick processing. After calling the kernel + * has control over which tasks are executed and when. + * + * See the demo application file main.c for an example of creating + * tasks and starting the kernel. + * + * Example usage: +
+ void vAFunction( void )
+ {
+	 // Create at least one task before starting the kernel.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );
+
+	 // Start the real time kernel with preemption.
+	 vTaskStartScheduler ();
+
+	 // Will not get here unless a task calls vTaskEndScheduler ()
+ }
+   
+ * + * \defgroup vTaskStartScheduler vTaskStartScheduler + * \ingroup SchedulerControl + */ +void vTaskStartScheduler( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskEndScheduler( void );
+ * + * NOTE: At the time of writing only the x86 real mode port, which runs on a PC + * in place of DOS, implements this function. + * + * Stops the real time kernel tick. All created tasks will be automatically + * deleted and multitasking (either preemptive or cooperative) will + * stop. Execution then resumes from the point where vTaskStartScheduler () + * was called, as if vTaskStartScheduler () had just returned. + * + * See the demo application file main. c in the demo/PC directory for an + * example that uses vTaskEndScheduler (). + * + * vTaskEndScheduler () requires an exit function to be defined within the + * portable layer (see vPortEndScheduler () in port. c for the PC port). This + * performs hardware specific operations such as stopping the kernel tick. + * + * vTaskEndScheduler () will cause all of the resources allocated by the + * kernel to be freed - but will not free resources allocated by application + * tasks. + * + * Example usage: +
+ void vTaskCode( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // At some point we want to end the real time kernel processing
+		 // so call ...
+		 vTaskEndScheduler ();
+	 }
+ }
+
+ void vAFunction( void )
+ {
+	 // Create at least one task before starting the kernel.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );
+
+	 // Start the real time kernel with preemption.
+	 vTaskStartScheduler ();
+
+	 // Will only get here when the vTaskCode () task has called
+	 // vTaskEndScheduler ().  When we get here we are back to single task
+	 // execution.
+ }
+   
+ * + * \defgroup vTaskEndScheduler vTaskEndScheduler + * \ingroup SchedulerControl + */ +void vTaskEndScheduler( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
void vTaskSuspendAll( void );
+ * + * Suspends the scheduler without disabling interrupts. Context switches will + * not occur while the scheduler is suspended. + * + * After calling vTaskSuspendAll () the calling task will continue to execute + * without risk of being swapped out until a call to xTaskResumeAll () has been + * made. + * + * API functions that have the potential to cause a context switch (for example, + * vTaskDelayUntil(), xQueueSend(), etc.) must not be called while the scheduler + * is suspended. + * + * Example usage: +
+ void vTask1( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // ...
+
+		 // At some point the task wants to perform a long operation during
+		 // which it does not want to get swapped out.  It cannot use
+		 // taskENTER_CRITICAL ()/taskEXIT_CRITICAL () as the length of the
+		 // operation may cause interrupts to be missed - including the
+		 // ticks.
+
+		 // Prevent the real time kernel swapping out the task.
+		 vTaskSuspendAll ();
+
+		 // Perform the operation here.  There is no need to use critical
+		 // sections as we have all the microcontroller processing time.
+		 // During this time interrupts will still operate and the kernel
+		 // tick count will be maintained.
+
+		 // ...
+
+		 // The operation is complete.  Restart the kernel.
+		 xTaskResumeAll ();
+	 }
+ }
+   
+ * \defgroup vTaskSuspendAll vTaskSuspendAll + * \ingroup SchedulerControl + */ +void vTaskSuspendAll( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
BaseType_t xTaskResumeAll( void );
+ * + * Resumes scheduler activity after it was suspended by a call to + * vTaskSuspendAll(). + * + * xTaskResumeAll() only resumes the scheduler. It does not unsuspend tasks + * that were previously suspended by a call to vTaskSuspend(). + * + * @return If resuming the scheduler caused a context switch then pdTRUE is + * returned, otherwise pdFALSE is returned. + * + * Example usage: +
+ void vTask1( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // ...
+
+		 // At some point the task wants to perform a long operation during
+		 // which it does not want to get swapped out.  It cannot use
+		 // taskENTER_CRITICAL ()/taskEXIT_CRITICAL () as the length of the
+		 // operation may cause interrupts to be missed - including the
+		 // ticks.
+
+		 // Prevent the real time kernel swapping out the task.
+		 vTaskSuspendAll ();
+
+		 // Perform the operation here.  There is no need to use critical
+		 // sections as we have all the microcontroller processing time.
+		 // During this time interrupts will still operate and the real
+		 // time kernel tick count will be maintained.
+
+		 // ...
+
+		 // The operation is complete.  Restart the kernel.  We want to force
+		 // a context switch - but there is no point if resuming the scheduler
+		 // caused a context switch already.
+		 if( !xTaskResumeAll () )
+		 {
+			  taskYIELD ();
+		 }
+	 }
+ }
+   
+ * \defgroup xTaskResumeAll xTaskResumeAll + * \ingroup SchedulerControl + */ +BaseType_t xTaskResumeAll( void ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * TASK UTILITIES + *----------------------------------------------------------*/ + +/** + * task. h + *
TickType_t xTaskGetTickCount( void );
+ * + * @return The count of ticks since vTaskStartScheduler was called. + * + * \defgroup xTaskGetTickCount xTaskGetTickCount + * \ingroup TaskUtils + */ +TickType_t xTaskGetTickCount( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
TickType_t xTaskGetTickCountFromISR( void );
+ * + * @return The count of ticks since vTaskStartScheduler was called. + * + * This is a version of xTaskGetTickCount() that is safe to be called from an + * ISR - provided that TickType_t is the natural word size of the + * microcontroller being used or interrupt nesting is either not supported or + * not being used. + * + * \defgroup xTaskGetTickCountFromISR xTaskGetTickCountFromISR + * \ingroup TaskUtils + */ +TickType_t xTaskGetTickCountFromISR( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
uint16_t uxTaskGetNumberOfTasks( void );
+ * + * @return The number of tasks that the real time kernel is currently managing. + * This includes all ready, blocked and suspended tasks. A task that + * has been deleted but not yet freed by the idle task will also be + * included in the count. + * + * \defgroup uxTaskGetNumberOfTasks uxTaskGetNumberOfTasks + * \ingroup TaskUtils + */ +UBaseType_t uxTaskGetNumberOfTasks( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + *
char *pcTaskGetTaskName( TaskHandle_t xTaskToQuery );
+ * + * @return The text (human readable) name of the task referenced by the handle + * xTaskToQuery. A task can query its own name by either passing in its own + * handle, or by setting xTaskToQuery to NULL. INCLUDE_pcTaskGetTaskName must be + * set to 1 in FreeRTOSConfig.h for pcTaskGetTaskName() to be available. + * + * \defgroup pcTaskGetTaskName pcTaskGetTaskName + * \ingroup TaskUtils + */ +char *pcTaskGetTaskName( TaskHandle_t xTaskToQuery ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task.h + *
UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask );
+ * + * INCLUDE_uxTaskGetStackHighWaterMark must be set to 1 in FreeRTOSConfig.h for + * this function to be available. + * + * Returns the high water mark of the stack associated with xTask. That is, + * the minimum free stack space there has been (in words, so on a 32 bit machine + * a value of 1 means 4 bytes) since the task started. The smaller the returned + * number the closer the task has come to overflowing its stack. + * + * @param xTask Handle of the task associated with the stack to be checked. + * Set xTask to NULL to check the stack of the calling task. + * + * @return The smallest amount of free stack space there has been (in words, so + * actual spaces on the stack rather than bytes) since the task referenced by + * xTask was created. + */ +UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/* When using trace macros it is sometimes necessary to include task.h before +FreeRTOS.h. When this is done TaskHookFunction_t will not yet have been defined, +so the following two prototypes will cause a compilation error. This can be +fixed by simply guarding against the inclusion of these two prototypes unless +they are explicitly required by the configUSE_APPLICATION_TASK_TAG configuration +constant. */ +#ifdef configUSE_APPLICATION_TASK_TAG + #if configUSE_APPLICATION_TASK_TAG == 1 + /** + * task.h + *
void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction );
+ * + * Sets pxHookFunction to be the task hook function used by the task xTask. + * Passing xTask as NULL has the effect of setting the calling tasks hook + * function. + */ + void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction ) PRIVILEGED_FUNCTION; + + /** + * task.h + *
void xTaskGetApplicationTaskTag( TaskHandle_t xTask );
+ * + * Returns the pxHookFunction value assigned to the task xTask. + */ + TaskHookFunction_t xTaskGetApplicationTaskTag( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + #endif /* configUSE_APPLICATION_TASK_TAG ==1 */ +#endif /* ifdef configUSE_APPLICATION_TASK_TAG */ +#if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 ) + + /* Each task contains an array of pointers that is dimensioned by the + configNUM_THREAD_LOCAL_STORAGE_POINTERS setting in FreeRTOSConfig.h. The + kernel does not use the pointers itself, so the application writer can use + the pointers for any purpose they wish. The following two functions are + used to set and query a pointer respectively. */ + void vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet, BaseType_t xIndex, void *pvValue ) PRIVILEGED_FUNCTION; + void *pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery, BaseType_t xIndex ) PRIVILEGED_FUNCTION; + +#endif + +/** + * task.h + *
BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter );
+ * + * Calls the hook function associated with xTask. Passing xTask as NULL has + * the effect of calling the Running tasks (the calling task) hook function. + * + * pvParameter is passed to the hook function for the task to interpret as it + * wants. The return value is the value returned by the task hook function + * registered by the user. + */ +BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter ) PRIVILEGED_FUNCTION; + +/** + * xTaskGetIdleTaskHandle() is only available if + * INCLUDE_xTaskGetIdleTaskHandle is set to 1 in FreeRTOSConfig.h. + * + * Simply returns the handle of the idle task. It is not valid to call + * xTaskGetIdleTaskHandle() before the scheduler has been started. + */ +TaskHandle_t xTaskGetIdleTaskHandle( void ); + +/** + * configUSE_TRACE_FACILITY must be defined as 1 in FreeRTOSConfig.h for + * uxTaskGetSystemState() to be available. + * + * uxTaskGetSystemState() populates an TaskStatus_t structure for each task in + * the system. TaskStatus_t structures contain, among other things, members + * for the task handle, task name, task priority, task state, and total amount + * of run time consumed by the task. See the TaskStatus_t structure + * definition in this file for the full member list. + * + * NOTE: This function is intended for debugging use only as its use results in + * the scheduler remaining suspended for an extended period. + * + * @param pxTaskStatusArray A pointer to an array of TaskStatus_t structures. + * The array must contain at least one TaskStatus_t structure for each task + * that is under the control of the RTOS. The number of tasks under the control + * of the RTOS can be determined using the uxTaskGetNumberOfTasks() API function. + * + * @param uxArraySize The size of the array pointed to by the pxTaskStatusArray + * parameter. The size is specified as the number of indexes in the array, or + * the number of TaskStatus_t structures contained in the array, not by the + * number of bytes in the array. + * + * @param pulTotalRunTime If configGENERATE_RUN_TIME_STATS is set to 1 in + * FreeRTOSConfig.h then *pulTotalRunTime is set by uxTaskGetSystemState() to the + * total run time (as defined by the run time stats clock, see + * http://www.freertos.org/rtos-run-time-stats.html) since the target booted. + * pulTotalRunTime can be set to NULL to omit the total run time information. + * + * @return The number of TaskStatus_t structures that were populated by + * uxTaskGetSystemState(). This should equal the number returned by the + * uxTaskGetNumberOfTasks() API function, but will be zero if the value passed + * in the uxArraySize parameter was too small. + * + * Example usage: +
+    // This example demonstrates how a human readable table of run time stats
+	// information is generated from raw data provided by uxTaskGetSystemState().
+	// The human readable table is written to pcWriteBuffer
+	void vTaskGetRunTimeStats( char *pcWriteBuffer )
+	{
+	TaskStatus_t *pxTaskStatusArray;
+	volatile UBaseType_t uxArraySize, x;
+	uint32_t ulTotalRunTime, ulStatsAsPercentage;
+
+		// Make sure the write buffer does not contain a string.
+		*pcWriteBuffer = 0x00;
+
+		// Take a snapshot of the number of tasks in case it changes while this
+		// function is executing.
+		uxArraySize = uxTaskGetNumberOfTasks();
+
+		// Allocate a TaskStatus_t structure for each task.  An array could be
+		// allocated statically at compile time.
+		pxTaskStatusArray = pvPortMalloc( uxArraySize * sizeof( TaskStatus_t ) );
+
+		if( pxTaskStatusArray != NULL )
+		{
+			// Generate raw status information about each task.
+			uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, &ulTotalRunTime );
+
+			// For percentage calculations.
+			ulTotalRunTime /= 100UL;
+
+			// Avoid divide by zero errors.
+			if( ulTotalRunTime > 0 )
+			{
+				// For each populated position in the pxTaskStatusArray array,
+				// format the raw data as human readable ASCII data
+				for( x = 0; x < uxArraySize; x++ )
+				{
+					// What percentage of the total run time has the task used?
+					// This will always be rounded down to the nearest integer.
+					// ulTotalRunTimeDiv100 has already been divided by 100.
+					ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter / ulTotalRunTime;
+
+					if( ulStatsAsPercentage > 0UL )
+					{
+						sprintf( pcWriteBuffer, "%s\t\t%lu\t\t%lu%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter, ulStatsAsPercentage );
+					}
+					else
+					{
+						// If the percentage is zero here then the task has
+						// consumed less than 1% of the total run time.
+						sprintf( pcWriteBuffer, "%s\t\t%lu\t\t<1%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter );
+					}
+
+					pcWriteBuffer += strlen( ( char * ) pcWriteBuffer );
+				}
+			}
+
+			// The array is no longer needed, free the memory it consumes.
+			vPortFree( pxTaskStatusArray );
+		}
+	}
+	
+ */ +UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime ); + +/** + * task. h + *
void vTaskList( char *pcWriteBuffer );
+ * + * configUSE_TRACE_FACILITY and configUSE_STATS_FORMATTING_FUNCTIONS must + * both be defined as 1 for this function to be available. See the + * configuration section of the FreeRTOS.org website for more information. + * + * NOTE 1: This function will disable interrupts for its duration. It is + * not intended for normal application runtime use but as a debug aid. + * + * Lists all the current tasks, along with their current state and stack + * usage high water mark. + * + * Tasks are reported as blocked ('B'), ready ('R'), deleted ('D') or + * suspended ('S'). + * + * PLEASE NOTE: + * + * This function is provided for convenience only, and is used by many of the + * demo applications. Do not consider it to be part of the scheduler. + * + * vTaskList() calls uxTaskGetSystemState(), then formats part of the + * uxTaskGetSystemState() output into a human readable table that displays task + * names, states and stack usage. + * + * vTaskList() has a dependency on the sprintf() C library function that might + * bloat the code size, use a lot of stack, and provide different results on + * different platforms. An alternative, tiny, third party, and limited + * functionality implementation of sprintf() is provided in many of the + * FreeRTOS/Demo sub-directories in a file called printf-stdarg.c (note + * printf-stdarg.c does not provide a full snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() + * directly to get access to raw stats data, rather than indirectly through a + * call to vTaskList(). + * + * @param pcWriteBuffer A buffer into which the above mentioned details + * will be written, in ASCII form. This buffer is assumed to be large + * enough to contain the generated report. Approximately 40 bytes per + * task should be sufficient. + * + * \defgroup vTaskList vTaskList + * \ingroup TaskUtils + */ +void vTaskList( char * pcWriteBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task. h + *
void vTaskGetRunTimeStats( char *pcWriteBuffer );
+ * + * configGENERATE_RUN_TIME_STATS and configUSE_STATS_FORMATTING_FUNCTIONS + * must both be defined as 1 for this function to be available. The application + * must also then provide definitions for + * portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() and portGET_RUN_TIME_COUNTER_VALUE() + * to configure a peripheral timer/counter and return the timers current count + * value respectively. The counter should be at least 10 times the frequency of + * the tick count. + * + * NOTE 1: This function will disable interrupts for its duration. It is + * not intended for normal application runtime use but as a debug aid. + * + * Setting configGENERATE_RUN_TIME_STATS to 1 will result in a total + * accumulated execution time being stored for each task. The resolution + * of the accumulated time value depends on the frequency of the timer + * configured by the portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() macro. + * Calling vTaskGetRunTimeStats() writes the total execution time of each + * task into a buffer, both as an absolute count value and as a percentage + * of the total system execution time. + * + * NOTE 2: + * + * This function is provided for convenience only, and is used by many of the + * demo applications. Do not consider it to be part of the scheduler. + * + * vTaskGetRunTimeStats() calls uxTaskGetSystemState(), then formats part of the + * uxTaskGetSystemState() output into a human readable table that displays the + * amount of time each task has spent in the Running state in both absolute and + * percentage terms. + * + * vTaskGetRunTimeStats() has a dependency on the sprintf() C library function + * that might bloat the code size, use a lot of stack, and provide different + * results on different platforms. An alternative, tiny, third party, and + * limited functionality implementation of sprintf() is provided in many of the + * FreeRTOS/Demo sub-directories in a file called printf-stdarg.c (note + * printf-stdarg.c does not provide a full snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() directly + * to get access to raw stats data, rather than indirectly through a call to + * vTaskGetRunTimeStats(). + * + * @param pcWriteBuffer A buffer into which the execution times will be + * written, in ASCII form. This buffer is assumed to be large enough to + * contain the generated report. Approximately 40 bytes per task should + * be sufficient. + * + * \defgroup vTaskGetRunTimeStats vTaskGetRunTimeStats + * \ingroup TaskUtils + */ +void vTaskGetRunTimeStats( char *pcWriteBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task. h + *
BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @param ulValue Data that can be sent with the notification. How the data is + * used depends on the value of the eAction parameter. + * + * @param eAction Specifies how the notification updates the task's notification + * value, if at all. Valid values for eAction are as follows: + * + * eSetBits - + * The task's notification value is bitwise ORed with ulValue. xTaskNofify() + * always returns pdPASS in this case. + * + * eIncrement - + * The task's notification value is incremented. ulValue is not used and + * xTaskNotify() always returns pdPASS in this case. + * + * eSetValueWithOverwrite - + * The task's notification value is set to the value of ulValue, even if the + * task being notified had not yet processed the previous notification (the + * task already had a notification pending). xTaskNotify() always returns + * pdPASS in this case. + * + * eSetValueWithoutOverwrite - + * If the task being notified did not already have a notification pending then + * the task's notification value is set to ulValue and xTaskNotify() will + * return pdPASS. If the task being notified already had a notification + * pending then no action is performed and pdFAIL is returned. + * + * eNoAction - + * The task receives a notification without its notification value being + * updated. ulValue is not used and xTaskNotify() always returns pdPASS in + * this case. + * + * @return Dependent on the value of eAction. See the description of the + * eAction parameter. + * + * \defgroup xTaskNotify xTaskNotify + * \ingroup TaskNotifications + */ +BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction ); + +/** + * task. h + *
BaseType_t xTaskNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, BaseType_t *pxHigherPriorityTaskWoken );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * A version of xTaskNotify() that can be used from an interrupt service routine + * (ISR). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @param ulValue Data that can be sent with the notification. How the data is + * used depends on the value of the eAction parameter. + * + * @param eAction Specifies how the notification updates the task's notification + * value, if at all. Valid values for eAction are as follows: + * + * eSetBits - + * The task's notification value is bitwise ORed with ulValue. xTaskNofify() + * always returns pdPASS in this case. + * + * eIncrement - + * The task's notification value is incremented. ulValue is not used and + * xTaskNotify() always returns pdPASS in this case. + * + * eSetValueWithOverwrite - + * The task's notification value is set to the value of ulValue, even if the + * task being notified had not yet processed the previous notification (the + * task already had a notification pending). xTaskNotify() always returns + * pdPASS in this case. + * + * eSetValueWithoutOverwrite - + * If the task being notified did not already have a notification pending then + * the task's notification value is set to ulValue and xTaskNotify() will + * return pdPASS. If the task being notified already had a notification + * pending then no action is performed and pdFAIL is returned. + * + * eNoAction - + * The task receives a notification without its notification value being + * updated. ulValue is not used and xTaskNotify() always returns pdPASS in + * this case. + * + * @param pxHigherPriorityTaskWoken xTaskNotifyFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending the notification caused the + * task to which the notification was sent to leave the Blocked state, and the + * unblocked task has a priority higher than the currently running task. If + * xTaskNotifyFromISR() sets this value to pdTRUE then a context switch should + * be requested before the interrupt is exited. How a context switch is + * requested from an ISR is dependent on the port - see the documentation page + * for the port in use. + * + * @return Dependent on the value of eAction. See the description of the + * eAction parameter. + * + * \defgroup xTaskNotify xTaskNotify + * \ingroup TaskNotifications + */ +BaseType_t xTaskNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, BaseType_t *pxHigherPriorityTaskWoken ); + +/** + * task. h + *
BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param ulBitsToClearOnEntry Bits that are set in ulBitsToClearOnEntry value + * will be cleared in the calling task's notification value before the task + * checks to see if any notifications are pending, and optionally blocks if no + * notifications are pending. Setting ulBitsToClearOnEntry to ULONG_MAX (if + * limits.h is included) or 0xffffffffUL (if limits.h is not included) will have + * the effect of resetting the task's notification value to 0. Setting + * ulBitsToClearOnEntry to 0 will leave the task's notification value unchanged. + * + * @param ulBitsToClearOnExit If a notification is pending or received before + * the calling task exits the xTaskNotifyWait() function then the task's + * notification value (see the xTaskNotify() API function) is passed out using + * the pulNotificationValue parameter. Then any bits that are set in + * ulBitsToClearOnExit will be cleared in the task's notification value (note + * *pulNotificationValue is set before any bits are cleared). Setting + * ulBitsToClearOnExit to ULONG_MAX (if limits.h is included) or 0xffffffffUL + * (if limits.h is not included) will have the effect of resetting the task's + * notification value to 0 before the function exits. Setting + * ulBitsToClearOnExit to 0 will leave the task's notification value unchanged + * when the function exits (in which case the value passed out in + * pulNotificationValue will match the task's notification value). + * + * @param pulNotificationValue Used to pass the task's notification value out + * of the function. Note the value passed out will not be effected by the + * clearing of any bits caused by ulBitsToClearOnExit being non-zero. + * + * @param xTicksToWait The maximum amount of time that the task should wait in + * the Blocked state for a notification to be received, should a notification + * not already be pending when xTaskNotifyWait() was called. The task + * will not consume any processing time while it is in the Blocked state. This + * is specified in kernel ticks, the macro pdMS_TO_TICSK( value_in_ms ) can be + * used to convert a time specified in milliseconds to a time specified in + * ticks. + * + * @return If a notification was received (including notifications that were + * already pending when xTaskNotifyWait was called) then pdPASS is + * returned. Otherwise pdFAIL is returned. + * + * \defgroup xTaskNotifyWait xTaskNotifyWait + * \ingroup TaskNotifications + */ +BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait ); + +/** + * task. h + *
BaseType_t xTaskNotifyGive( TaskHandle_t xTaskToNotify );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this macro + * to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * xTaskNotifyGive() is a helper macro intended for use when task notifications + * are used as light weight and faster binary or counting semaphore equivalents. + * Actual FreeRTOS semaphores are given using the xSemaphoreGive() API function, + * the equivalent action that instead uses a task notification is + * xTaskNotifyGive(). + * + * When task notifications are being used as a binary or counting semaphore + * equivalent then the task being notified should wait for the notification + * using the ulTaskNotificationTake() API function rather than the + * xTaskNotifyWait() API function. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for more details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @return xTaskNotifyGive() is a macro that calls xTaskNotify() with the + * eAction parameter set to eIncrement - so pdPASS is always returned. + * + * \defgroup xTaskNotifyGive xTaskNotifyGive + * \ingroup TaskNotifications + */ +#define xTaskNotifyGive( xTaskToNotify ) xTaskNotify( ( xTaskToNotify ), 0, eIncrement ); + +/** + * task. h + *
void vTaskNotifyGiveFromISR( TaskHandle_t xTaskHandle, BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this macro
+ * to be available.
+ *
+ * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private
+ * "notification value", which is a 32-bit unsigned integer (uint32_t).
+ *
+ * A version of xTaskNotifyGive() that can be called from an interrupt service
+ * routine (ISR).
+ *
+ * Events can be sent to a task using an intermediary object.  Examples of such
+ * objects are queues, semaphores, mutexes and event groups.  Task notifications
+ * are a method of sending an event directly to a task without the need for such
+ * an intermediary object.
+ *
+ * A notification sent to a task can optionally perform an action, such as
+ * update, overwrite or increment the task's notification value.  In that way
+ * task notifications can be used to send data to a task, or be used as light
+ * weight and fast binary or counting semaphores.
+ *
+ * vTaskNotifyGiveFromISR() is intended for use when task notifications are
+ * used as light weight and faster binary or counting semaphore equivalents.
+ * Actual FreeRTOS semaphores are given from an ISR using the
+ * xSemaphoreGiveFromISR() API function, the equivalent action that instead uses
+ * a task notification is vTaskNotifyGiveFromISR().
+ *
+ * When task notifications are being used as a binary or counting semaphore
+ * equivalent then the task being notified should wait for the notification
+ * using the ulTaskNotificationTake() API function rather than the
+ * xTaskNotifyWait() API function.
+ *
+ * See http://www.FreeRTOS.org/RTOS-task-notifications.html for more details.
+ *
+ * @param xTaskToNotify The handle of the task being notified.  The handle to a
+ * task can be returned from the xTaskCreate() API function used to create the
+ * task, and the handle of the currently running task can be obtained by calling
+ * xTaskGetCurrentTaskHandle().
+ *
+ * @param pxHigherPriorityTaskWoken  vTaskNotifyGiveFromISR() will set
+ * *pxHigherPriorityTaskWoken to pdTRUE if sending the notification caused the
+ * task to which the notification was sent to leave the Blocked state, and the
+ * unblocked task has a priority higher than the currently running task.  If
+ * vTaskNotifyGiveFromISR() sets this value to pdTRUE then a context switch
+ * should be requested before the interrupt is exited.  How a context switch is
+ * requested from an ISR is dependent on the port - see the documentation page
+ * for the port in use.
+ *
+ * \defgroup xTaskNotifyWait xTaskNotifyWait
+ * \ingroup TaskNotifications
+ */
+void vTaskNotifyGiveFromISR( TaskHandle_t xTaskToNotify, BaseType_t *pxHigherPriorityTaskWoken );
+
+/**
+ * task. h
+ * 
uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * ulTaskNotifyTake() is intended for use when a task notification is used as a + * faster and lighter weight binary or counting semaphore alternative. Actual + * FreeRTOS semaphores are taken using the xSemaphoreTake() API function, the + * equivalent action that instead uses a task notification is + * ulTaskNotifyTake(). + * + * When a task is using its notification value as a binary or counting semaphore + * other tasks should send notifications to it using the xTaskNotifyGive() + * macro, or xTaskNotify() function with the eAction parameter set to + * eIncrement. + * + * ulTaskNotifyTake() can either clear the task's notification value to + * zero on exit, in which case the notification value acts like a binary + * semaphore, or decrement the task's notification value on exit, in which case + * the notification value acts like a counting semaphore. + * + * A task can use ulTaskNotifyTake() to [optionally] block to wait for a + * the task's notification value to be non-zero. The task does not consume any + * CPU time while it is in the Blocked state. + * + * Where as xTaskNotifyWait() will return when a notification is pending, + * ulTaskNotifyTake() will return when the task's notification value is + * not zero. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param xClearCountOnExit if xClearCountOnExit is pdFALSE then the task's + * notification value is decremented when the function exits. In this way the + * notification value acts like a counting semaphore. If xClearCountOnExit is + * not pdFALSE then the task's notification value is cleared to zero when the + * function exits. In this way the notification value acts like a binary + * semaphore. + * + * @param xTicksToWait The maximum amount of time that the task should wait in + * the Blocked state for the task's notification value to be greater than zero, + * should the count not already be greater than zero when + * ulTaskNotifyTake() was called. The task will not consume any processing + * time while it is in the Blocked state. This is specified in kernel ticks, + * the macro pdMS_TO_TICSK( value_in_ms ) can be used to convert a time + * specified in milliseconds to a time specified in ticks. + * + * @return The task's notification count before it is either cleared to zero or + * decremented (see the xClearCountOnExit parameter). + * + * \defgroup ulTaskNotifyTake ulTaskNotifyTake + * \ingroup TaskNotifications + */ +uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait ); + +/*----------------------------------------------------------- + * SCHEDULER INTERNALS AVAILABLE FOR PORTING PURPOSES + *----------------------------------------------------------*/ + +/* + * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE. IT IS ONLY + * INTENDED FOR USE WHEN IMPLEMENTING A PORT OF THE SCHEDULER AND IS + * AN INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER. + * + * Called from the real time kernel tick (either preemptive or cooperative), + * this increments the tick count and checks if any tasks that are blocked + * for a finite period required removing from a blocked list and placing on + * a ready list. If a non-zero value is returned then a context switch is + * required because either: + * + A task was removed from a blocked list because its timeout had expired, + * or + * + Time slicing is in use and there is a task of equal priority to the + * currently running task. + */ +BaseType_t xTaskIncrementTick( void ) PRIVILEGED_FUNCTION; + +/* + * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE. IT IS AN + * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER. + * + * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED. + * + * Removes the calling task from the ready list and places it both + * on the list of tasks waiting for a particular event, and the + * list of delayed tasks. The task will be removed from both lists + * and replaced on the ready list should either the event occur (and + * there be no higher priority tasks waiting on the same event) or + * the delay period expires. + * + * The 'unordered' version replaces the event list item value with the + * xItemValue value, and inserts the list item at the end of the list. + * + * The 'ordered' version uses the existing event list item value (which is the + * owning tasks priority) to insert the list item into the event list is task + * priority order. + * + * @param pxEventList The list containing tasks that are blocked waiting + * for the event to occur. + * + * @param xItemValue The item value to use for the event list item when the + * event list is not ordered by task priority. + * + * @param xTicksToWait The maximum amount of time that the task should wait + * for the event to occur. This is specified in kernel ticks,the constant + * portTICK_PERIOD_MS can be used to convert kernel ticks into a real time + * period. + */ +void vTaskPlaceOnEventList( List_t * const pxEventList, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; +void vTaskPlaceOnUnorderedEventList( List_t * pxEventList, const TickType_t xItemValue, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/* + * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE. IT IS AN + * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER. + * + * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED. + * + * This function performs nearly the same function as vTaskPlaceOnEventList(). + * The difference being that this function does not permit tasks to block + * indefinitely, whereas vTaskPlaceOnEventList() does. + * + */ +void vTaskPlaceOnEventListRestricted( List_t * const pxEventList, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/* + * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE. IT IS AN + * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER. + * + * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED. + * + * Removes a task from both the specified event list and the list of blocked + * tasks, and places it on a ready queue. + * + * xTaskRemoveFromEventList()/xTaskRemoveFromUnorderedEventList() will be called + * if either an event occurs to unblock a task, or the block timeout period + * expires. + * + * xTaskRemoveFromEventList() is used when the event list is in task priority + * order. It removes the list item from the head of the event list as that will + * have the highest priority owning task of all the tasks on the event list. + * xTaskRemoveFromUnorderedEventList() is used when the event list is not + * ordered and the event list items hold something other than the owning tasks + * priority. In this case the event list item value is updated to the value + * passed in the xItemValue parameter. + * + * @return pdTRUE if the task being removed has a higher priority than the task + * making the call, otherwise pdFALSE. + */ +BaseType_t xTaskRemoveFromEventList( const List_t * const pxEventList ) PRIVILEGED_FUNCTION; +BaseType_t xTaskRemoveFromUnorderedEventList( ListItem_t * pxEventListItem, const TickType_t xItemValue ) PRIVILEGED_FUNCTION; + +/* + * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE. IT IS ONLY + * INTENDED FOR USE WHEN IMPLEMENTING A PORT OF THE SCHEDULER AND IS + * AN INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER. + * + * Sets the pointer to the current TCB to the TCB of the highest priority task + * that is ready to run. + */ +void vTaskSwitchContext( void ) PRIVILEGED_FUNCTION; + +/* + * THESE FUNCTIONS MUST NOT BE USED FROM APPLICATION CODE. THEY ARE USED BY + * THE EVENT BITS MODULE. + */ +TickType_t uxTaskResetEventItemValue( void ) PRIVILEGED_FUNCTION; + +/* + * Return the handle of the calling task. + */ +TaskHandle_t xTaskGetCurrentTaskHandle( void ) PRIVILEGED_FUNCTION; + +/* + * Capture the current time status for future reference. + */ +void vTaskSetTimeOutState( TimeOut_t * const pxTimeOut ) PRIVILEGED_FUNCTION; + +/* + * Compare the time status now with that previously captured to see if the + * timeout has expired. + */ +BaseType_t xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut, TickType_t * const pxTicksToWait ) PRIVILEGED_FUNCTION; + +/* + * Shortcut used by the queue implementation to prevent unnecessary call to + * taskYIELD(); + */ +void vTaskMissedYield( void ) PRIVILEGED_FUNCTION; + +/* + * Returns the scheduler state as taskSCHEDULER_RUNNING, + * taskSCHEDULER_NOT_STARTED or taskSCHEDULER_SUSPENDED. + */ +BaseType_t xTaskGetSchedulerState( void ) PRIVILEGED_FUNCTION; + +/* + * Raises the priority of the mutex holder to that of the calling task should + * the mutex holder have a priority less than the calling task. + */ +void vTaskPriorityInherit( TaskHandle_t const pxMutexHolder ) PRIVILEGED_FUNCTION; + +/* + * Set the priority of a task back to its proper priority in the case that it + * inherited a higher priority while it was holding a semaphore. + */ +BaseType_t xTaskPriorityDisinherit( TaskHandle_t const pxMutexHolder ) PRIVILEGED_FUNCTION; + +/* + * Generic version of the task creation function which is in turn called by the + * xTaskCreate() and xTaskCreateRestricted() macros. + */ +BaseType_t xTaskGenericCreate( TaskFunction_t pxTaskCode, const char * const pcName, const uint16_t usStackDepth, void * const pvParameters, UBaseType_t uxPriority, TaskHandle_t * const pxCreatedTask, StackType_t * const puxStackBuffer, const MemoryRegion_t * const xRegions, const BaseType_t xCoreID) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/* + * Get the uxTCBNumber assigned to the task referenced by the xTask parameter. + */ +UBaseType_t uxTaskGetTaskNumber( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/* + * Set the uxTaskNumber of the task referenced by the xTask parameter to + * uxHandle. + */ +void vTaskSetTaskNumber( TaskHandle_t xTask, const UBaseType_t uxHandle ) PRIVILEGED_FUNCTION; + +/* + * Only available when configUSE_TICKLESS_IDLE is set to 1. + * If tickless mode is being used, or a low power mode is implemented, then + * the tick interrupt will not execute during idle periods. When this is the + * case, the tick count value maintained by the scheduler needs to be kept up + * to date with the actual execution time by being skipped forward by a time + * equal to the idle period. + */ +void vTaskStepTick( const TickType_t xTicksToJump ) PRIVILEGED_FUNCTION; + +/* + * Only avilable when configUSE_TICKLESS_IDLE is set to 1. + * Provided for use within portSUPPRESS_TICKS_AND_SLEEP() to allow the port + * specific sleep function to determine if it is ok to proceed with the sleep, + * and if it is ok to proceed, if it is ok to sleep indefinitely. + * + * This function is necessary because portSUPPRESS_TICKS_AND_SLEEP() is only + * called with the scheduler suspended, not from within a critical section. It + * is therefore possible for an interrupt to request a context switch between + * portSUPPRESS_TICKS_AND_SLEEP() and the low power mode actually being + * entered. eTaskConfirmSleepModeStatus() should be called from a short + * critical section between the timer being stopped and the sleep mode being + * entered to ensure it is ok to proceed into the sleep mode. + */ +eSleepModeStatus eTaskConfirmSleepModeStatus( void ) PRIVILEGED_FUNCTION; + +/* + * For internal use only. Increment the mutex held count when a mutex is + * taken and return the handle of the task that has taken the mutex. + */ +void *pvTaskIncrementMutexHeldCount( void ); + +#ifdef __cplusplus +} +#endif +#endif /* INC_TASK_H */ + + + diff --git a/components/freertos/include/freertos/timers.h b/components/freertos/include/freertos/timers.h new file mode 100644 index 000000000..f89cd1d70 --- /dev/null +++ b/components/freertos/include/freertos/timers.h @@ -0,0 +1,1125 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef TIMERS_H +#define TIMERS_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h must appear in source files before include timers.h" +#endif + +/*lint -e537 This headers are only multiply included if the application code +happens to also be including task.h. */ +#include "task.h" +/*lint +e537 */ + +#ifdef __cplusplus +extern "C" { +#endif + +/*----------------------------------------------------------- + * MACROS AND DEFINITIONS + *----------------------------------------------------------*/ + +/* IDs for commands that can be sent/received on the timer queue. These are to +be used solely through the macros that make up the public software timer API, +as defined below. The commands that are sent from interrupts must use the +highest numbers as tmrFIRST_FROM_ISR_COMMAND is used to determine if the task +or interrupt version of the queue send function should be used. */ +#define tmrCOMMAND_EXECUTE_CALLBACK_FROM_ISR ( ( BaseType_t ) -2 ) +#define tmrCOMMAND_EXECUTE_CALLBACK ( ( BaseType_t ) -1 ) +#define tmrCOMMAND_START_DONT_TRACE ( ( BaseType_t ) 0 ) +#define tmrCOMMAND_START ( ( BaseType_t ) 1 ) +#define tmrCOMMAND_RESET ( ( BaseType_t ) 2 ) +#define tmrCOMMAND_STOP ( ( BaseType_t ) 3 ) +#define tmrCOMMAND_CHANGE_PERIOD ( ( BaseType_t ) 4 ) +#define tmrCOMMAND_DELETE ( ( BaseType_t ) 5 ) + +#define tmrFIRST_FROM_ISR_COMMAND ( ( BaseType_t ) 6 ) +#define tmrCOMMAND_START_FROM_ISR ( ( BaseType_t ) 6 ) +#define tmrCOMMAND_RESET_FROM_ISR ( ( BaseType_t ) 7 ) +#define tmrCOMMAND_STOP_FROM_ISR ( ( BaseType_t ) 8 ) +#define tmrCOMMAND_CHANGE_PERIOD_FROM_ISR ( ( BaseType_t ) 9 ) + + +/** + * Type by which software timers are referenced. For example, a call to + * xTimerCreate() returns an TimerHandle_t variable that can then be used to + * reference the subject timer in calls to other software timer API functions + * (for example, xTimerStart(), xTimerReset(), etc.). + */ +typedef void * TimerHandle_t; + +/* + * Defines the prototype to which timer callback functions must conform. + */ +typedef void (*TimerCallbackFunction_t)( TimerHandle_t xTimer ); + +/* + * Defines the prototype to which functions used with the + * xTimerPendFunctionCallFromISR() function must conform. + */ +typedef void (*PendedFunction_t)( void *, uint32_t ); + +/** + * TimerHandle_t xTimerCreate( const char * const pcTimerName, + * TickType_t xTimerPeriodInTicks, + * UBaseType_t uxAutoReload, + * void * pvTimerID, + * TimerCallbackFunction_t pxCallbackFunction ); + * + * Creates a new software timer instance. This allocates the storage required + * by the new timer, initialises the new timers internal state, and returns a + * handle by which the new timer can be referenced. + * + * Timers are created in the dormant state. The xTimerStart(), xTimerReset(), + * xTimerStartFromISR(), xTimerResetFromISR(), xTimerChangePeriod() and + * xTimerChangePeriodFromISR() API functions can all be used to transition a + * timer into the active state. + * + * @param pcTimerName A text name that is assigned to the timer. This is done + * purely to assist debugging. The kernel itself only ever references a timer + * by its handle, and never by its name. + * + * @param xTimerPeriodInTicks The timer period. The time is defined in tick + * periods so the constant portTICK_PERIOD_MS can be used to convert a time that + * has been specified in milliseconds. For example, if the timer must expire + * after 100 ticks, then xTimerPeriodInTicks should be set to 100. + * Alternatively, if the timer must expire after 500ms, then xPeriod can be set + * to ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than or + * equal to 1000. + * + * @param uxAutoReload If uxAutoReload is set to pdTRUE then the timer will + * expire repeatedly with a frequency set by the xTimerPeriodInTicks parameter. + * If uxAutoReload is set to pdFALSE then the timer will be a one-shot timer and + * enter the dormant state after it expires. + * + * @param pvTimerID An identifier that is assigned to the timer being created. + * Typically this would be used in the timer callback function to identify which + * timer expired when the same callback function is assigned to more than one + * timer. + * + * @param pxCallbackFunction The function to call when the timer expires. + * Callback functions must have the prototype defined by TimerCallbackFunction_t, + * which is "void vCallbackFunction( TimerHandle_t xTimer );". + * + * @return If the timer is successfully created then a handle to the newly + * created timer is returned. If the timer cannot be created (because either + * there is insufficient FreeRTOS heap remaining to allocate the timer + * structures, or the timer period was set to 0) then NULL is returned. + * + * Example usage: + * @verbatim + * #define NUM_TIMERS 5 + * + * // An array to hold handles to the created timers. + * TimerHandle_t xTimers[ NUM_TIMERS ]; + * + * // An array to hold a count of the number of times each timer expires. + * int32_t lExpireCounters[ NUM_TIMERS ] = { 0 }; + * + * // Define a callback function that will be used by multiple timer instances. + * // The callback function does nothing but count the number of times the + * // associated timer expires, and stop the timer once the timer has expired + * // 10 times. + * void vTimerCallback( TimerHandle_t pxTimer ) + * { + * int32_t lArrayIndex; + * const int32_t xMaxExpiryCountBeforeStopping = 10; + * + * // Optionally do something if the pxTimer parameter is NULL. + * configASSERT( pxTimer ); + * + * // Which timer expired? + * lArrayIndex = ( int32_t ) pvTimerGetTimerID( pxTimer ); + * + * // Increment the number of times that pxTimer has expired. + * lExpireCounters[ lArrayIndex ] += 1; + * + * // If the timer has expired 10 times then stop it from running. + * if( lExpireCounters[ lArrayIndex ] == xMaxExpiryCountBeforeStopping ) + * { + * // Do not use a block time if calling a timer API function from a + * // timer callback function, as doing so could cause a deadlock! + * xTimerStop( pxTimer, 0 ); + * } + * } + * + * void main( void ) + * { + * int32_t x; + * + * // Create then start some timers. Starting the timers before the scheduler + * // has been started means the timers will start running immediately that + * // the scheduler starts. + * for( x = 0; x < NUM_TIMERS; x++ ) + * { + * xTimers[ x ] = xTimerCreate( "Timer", // Just a text name, not used by the kernel. + * ( 100 * x ), // The timer period in ticks. + * pdTRUE, // The timers will auto-reload themselves when they expire. + * ( void * ) x, // Assign each timer a unique id equal to its array index. + * vTimerCallback // Each timer calls the same callback when it expires. + * ); + * + * if( xTimers[ x ] == NULL ) + * { + * // The timer was not created. + * } + * else + * { + * // Start the timer. No block time is specified, and even if one was + * // it would be ignored because the scheduler has not yet been + * // started. + * if( xTimerStart( xTimers[ x ], 0 ) != pdPASS ) + * { + * // The timer could not be set into the Active state. + * } + * } + * } + * + * // ... + * // Create tasks here. + * // ... + * + * // Starting the scheduler will start the timers running as they have already + * // been set into the active state. + * xTaskStartScheduler(); + * + * // Should not reach here. + * for( ;; ); + * } + * @endverbatim + */ +TimerHandle_t xTimerCreate( const char * const pcTimerName, const TickType_t xTimerPeriodInTicks, const UBaseType_t uxAutoReload, void * const pvTimerID, TimerCallbackFunction_t pxCallbackFunction ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * void *pvTimerGetTimerID( TimerHandle_t xTimer ); + * + * Returns the ID assigned to the timer. + * + * IDs are assigned to timers using the pvTimerID parameter of the call to + * xTimerCreated() that was used to create the timer. + * + * If the same callback function is assigned to multiple timers then the timer + * ID can be used within the callback function to identify which timer actually + * expired. + * + * @param xTimer The timer being queried. + * + * @return The ID assigned to the timer being queried. + * + * Example usage: + * + * See the xTimerCreate() API function example usage scenario. + */ +void *pvTimerGetTimerID( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION; + +/** + * BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer ); + * + * Queries a timer to see if it is active or dormant. + * + * A timer will be dormant if: + * 1) It has been created but not started, or + * 2) It is an expired one-shot timer that has not been restarted. + * + * Timers are created in the dormant state. The xTimerStart(), xTimerReset(), + * xTimerStartFromISR(), xTimerResetFromISR(), xTimerChangePeriod() and + * xTimerChangePeriodFromISR() API functions can all be used to transition a timer into the + * active state. + * + * @param xTimer The timer being queried. + * + * @return pdFALSE will be returned if the timer is dormant. A value other than + * pdFALSE will be returned if the timer is active. + * + * Example usage: + * @verbatim + * // This function assumes xTimer has already been created. + * void vAFunction( TimerHandle_t xTimer ) + * { + * if( xTimerIsTimerActive( xTimer ) != pdFALSE ) // or more simply and equivalently "if( xTimerIsTimerActive( xTimer ) )" + * { + * // xTimer is active, do something. + * } + * else + * { + * // xTimer is not active, do something else. + * } + * } + * @endverbatim + */ +BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION; + +/** + * TaskHandle_t xTimerGetTimerDaemonTaskHandle( void ); + * + * xTimerGetTimerDaemonTaskHandle() is only available if + * INCLUDE_xTimerGetTimerDaemonTaskHandle is set to 1 in FreeRTOSConfig.h. + * + * Simply returns the handle of the timer service/daemon task. It it not valid + * to call xTimerGetTimerDaemonTaskHandle() before the scheduler has been started. + */ +TaskHandle_t xTimerGetTimerDaemonTaskHandle( void ); + +/** + * BaseType_t xTimerStart( TimerHandle_t xTimer, TickType_t xTicksToWait ); + * + * Timer functionality is provided by a timer service/daemon task. Many of the + * public FreeRTOS timer API functions send commands to the timer service task + * through a queue called the timer command queue. The timer command queue is + * private to the kernel itself and is not directly accessible to application + * code. The length of the timer command queue is set by the + * configTIMER_QUEUE_LENGTH configuration constant. + * + * xTimerStart() starts a timer that was previously created using the + * xTimerCreate() API function. If the timer had already been started and was + * already in the active state, then xTimerStart() has equivalent functionality + * to the xTimerReset() API function. + * + * Starting a timer ensures the timer is in the active state. If the timer + * is not stopped, deleted, or reset in the mean time, the callback function + * associated with the timer will get called 'n' ticks after xTimerStart() was + * called, where 'n' is the timers defined period. + * + * It is valid to call xTimerStart() before the scheduler has been started, but + * when this is done the timer will not actually start until the scheduler is + * started, and the timers expiry time will be relative to when the scheduler is + * started, not relative to when xTimerStart() was called. + * + * The configUSE_TIMERS configuration constant must be set to 1 for xTimerStart() + * to be available. + * + * @param xTimer The handle of the timer being started/restarted. + * + * @param xTicksToWait Specifies the time, in ticks, that the calling task should + * be held in the Blocked state to wait for the start command to be successfully + * sent to the timer command queue, should the queue already be full when + * xTimerStart() was called. xTicksToWait is ignored if xTimerStart() is called + * before the scheduler is started. + * + * @return pdFAIL will be returned if the start command could not be sent to + * the timer command queue even after xTicksToWait ticks had passed. pdPASS will + * be returned if the command was successfully sent to the timer command queue. + * When the command is actually processed will depend on the priority of the + * timer service/daemon task relative to other tasks in the system, although the + * timers expiry time is relative to when xTimerStart() is actually called. The + * timer service/daemon task priority is set by the configTIMER_TASK_PRIORITY + * configuration constant. + * + * Example usage: + * + * See the xTimerCreate() API function example usage scenario. + * + */ +#define xTimerStart( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_START, ( xTaskGetTickCount() ), NULL, ( xTicksToWait ) ) + +/** + * BaseType_t xTimerStop( TimerHandle_t xTimer, TickType_t xTicksToWait ); + * + * Timer functionality is provided by a timer service/daemon task. Many of the + * public FreeRTOS timer API functions send commands to the timer service task + * through a queue called the timer command queue. The timer command queue is + * private to the kernel itself and is not directly accessible to application + * code. The length of the timer command queue is set by the + * configTIMER_QUEUE_LENGTH configuration constant. + * + * xTimerStop() stops a timer that was previously started using either of the + * The xTimerStart(), xTimerReset(), xTimerStartFromISR(), xTimerResetFromISR(), + * xTimerChangePeriod() or xTimerChangePeriodFromISR() API functions. + * + * Stopping a timer ensures the timer is not in the active state. + * + * The configUSE_TIMERS configuration constant must be set to 1 for xTimerStop() + * to be available. + * + * @param xTimer The handle of the timer being stopped. + * + * @param xTicksToWait Specifies the time, in ticks, that the calling task should + * be held in the Blocked state to wait for the stop command to be successfully + * sent to the timer command queue, should the queue already be full when + * xTimerStop() was called. xTicksToWait is ignored if xTimerStop() is called + * before the scheduler is started. + * + * @return pdFAIL will be returned if the stop command could not be sent to + * the timer command queue even after xTicksToWait ticks had passed. pdPASS will + * be returned if the command was successfully sent to the timer command queue. + * When the command is actually processed will depend on the priority of the + * timer service/daemon task relative to other tasks in the system. The timer + * service/daemon task priority is set by the configTIMER_TASK_PRIORITY + * configuration constant. + * + * Example usage: + * + * See the xTimerCreate() API function example usage scenario. + * + */ +#define xTimerStop( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_STOP, 0U, NULL, ( xTicksToWait ) ) + +/** + * BaseType_t xTimerChangePeriod( TimerHandle_t xTimer, + * TickType_t xNewPeriod, + * TickType_t xTicksToWait ); + * + * Timer functionality is provided by a timer service/daemon task. Many of the + * public FreeRTOS timer API functions send commands to the timer service task + * through a queue called the timer command queue. The timer command queue is + * private to the kernel itself and is not directly accessible to application + * code. The length of the timer command queue is set by the + * configTIMER_QUEUE_LENGTH configuration constant. + * + * xTimerChangePeriod() changes the period of a timer that was previously + * created using the xTimerCreate() API function. + * + * xTimerChangePeriod() can be called to change the period of an active or + * dormant state timer. + * + * The configUSE_TIMERS configuration constant must be set to 1 for + * xTimerChangePeriod() to be available. + * + * @param xTimer The handle of the timer that is having its period changed. + * + * @param xNewPeriod The new period for xTimer. Timer periods are specified in + * tick periods, so the constant portTICK_PERIOD_MS can be used to convert a time + * that has been specified in milliseconds. For example, if the timer must + * expire after 100 ticks, then xNewPeriod should be set to 100. Alternatively, + * if the timer must expire after 500ms, then xNewPeriod can be set to + * ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than + * or equal to 1000. + * + * @param xTicksToWait Specifies the time, in ticks, that the calling task should + * be held in the Blocked state to wait for the change period command to be + * successfully sent to the timer command queue, should the queue already be + * full when xTimerChangePeriod() was called. xTicksToWait is ignored if + * xTimerChangePeriod() is called before the scheduler is started. + * + * @return pdFAIL will be returned if the change period command could not be + * sent to the timer command queue even after xTicksToWait ticks had passed. + * pdPASS will be returned if the command was successfully sent to the timer + * command queue. When the command is actually processed will depend on the + * priority of the timer service/daemon task relative to other tasks in the + * system. The timer service/daemon task priority is set by the + * configTIMER_TASK_PRIORITY configuration constant. + * + * Example usage: + * @verbatim + * // This function assumes xTimer has already been created. If the timer + * // referenced by xTimer is already active when it is called, then the timer + * // is deleted. If the timer referenced by xTimer is not active when it is + * // called, then the period of the timer is set to 500ms and the timer is + * // started. + * void vAFunction( TimerHandle_t xTimer ) + * { + * if( xTimerIsTimerActive( xTimer ) != pdFALSE ) // or more simply and equivalently "if( xTimerIsTimerActive( xTimer ) )" + * { + * // xTimer is already active - delete it. + * xTimerDelete( xTimer ); + * } + * else + * { + * // xTimer is not active, change its period to 500ms. This will also + * // cause the timer to start. Block for a maximum of 100 ticks if the + * // change period command cannot immediately be sent to the timer + * // command queue. + * if( xTimerChangePeriod( xTimer, 500 / portTICK_PERIOD_MS, 100 ) == pdPASS ) + * { + * // The command was successfully sent. + * } + * else + * { + * // The command could not be sent, even after waiting for 100 ticks + * // to pass. Take appropriate action here. + * } + * } + * } + * @endverbatim + */ + #define xTimerChangePeriod( xTimer, xNewPeriod, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_CHANGE_PERIOD, ( xNewPeriod ), NULL, ( xTicksToWait ) ) + +/** + * BaseType_t xTimerDelete( TimerHandle_t xTimer, TickType_t xTicksToWait ); + * + * Timer functionality is provided by a timer service/daemon task. Many of the + * public FreeRTOS timer API functions send commands to the timer service task + * through a queue called the timer command queue. The timer command queue is + * private to the kernel itself and is not directly accessible to application + * code. The length of the timer command queue is set by the + * configTIMER_QUEUE_LENGTH configuration constant. + * + * xTimerDelete() deletes a timer that was previously created using the + * xTimerCreate() API function. + * + * The configUSE_TIMERS configuration constant must be set to 1 for + * xTimerDelete() to be available. + * + * @param xTimer The handle of the timer being deleted. + * + * @param xTicksToWait Specifies the time, in ticks, that the calling task should + * be held in the Blocked state to wait for the delete command to be + * successfully sent to the timer command queue, should the queue already be + * full when xTimerDelete() was called. xTicksToWait is ignored if xTimerDelete() + * is called before the scheduler is started. + * + * @return pdFAIL will be returned if the delete command could not be sent to + * the timer command queue even after xTicksToWait ticks had passed. pdPASS will + * be returned if the command was successfully sent to the timer command queue. + * When the command is actually processed will depend on the priority of the + * timer service/daemon task relative to other tasks in the system. The timer + * service/daemon task priority is set by the configTIMER_TASK_PRIORITY + * configuration constant. + * + * Example usage: + * + * See the xTimerChangePeriod() API function example usage scenario. + */ +#define xTimerDelete( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_DELETE, 0U, NULL, ( xTicksToWait ) ) + +/** + * BaseType_t xTimerReset( TimerHandle_t xTimer, TickType_t xTicksToWait ); + * + * Timer functionality is provided by a timer service/daemon task. Many of the + * public FreeRTOS timer API functions send commands to the timer service task + * through a queue called the timer command queue. The timer command queue is + * private to the kernel itself and is not directly accessible to application + * code. The length of the timer command queue is set by the + * configTIMER_QUEUE_LENGTH configuration constant. + * + * xTimerReset() re-starts a timer that was previously created using the + * xTimerCreate() API function. If the timer had already been started and was + * already in the active state, then xTimerReset() will cause the timer to + * re-evaluate its expiry time so that it is relative to when xTimerReset() was + * called. If the timer was in the dormant state then xTimerReset() has + * equivalent functionality to the xTimerStart() API function. + * + * Resetting a timer ensures the timer is in the active state. If the timer + * is not stopped, deleted, or reset in the mean time, the callback function + * associated with the timer will get called 'n' ticks after xTimerReset() was + * called, where 'n' is the timers defined period. + * + * It is valid to call xTimerReset() before the scheduler has been started, but + * when this is done the timer will not actually start until the scheduler is + * started, and the timers expiry time will be relative to when the scheduler is + * started, not relative to when xTimerReset() was called. + * + * The configUSE_TIMERS configuration constant must be set to 1 for xTimerReset() + * to be available. + * + * @param xTimer The handle of the timer being reset/started/restarted. + * + * @param xTicksToWait Specifies the time, in ticks, that the calling task should + * be held in the Blocked state to wait for the reset command to be successfully + * sent to the timer command queue, should the queue already be full when + * xTimerReset() was called. xTicksToWait is ignored if xTimerReset() is called + * before the scheduler is started. + * + * @return pdFAIL will be returned if the reset command could not be sent to + * the timer command queue even after xTicksToWait ticks had passed. pdPASS will + * be returned if the command was successfully sent to the timer command queue. + * When the command is actually processed will depend on the priority of the + * timer service/daemon task relative to other tasks in the system, although the + * timers expiry time is relative to when xTimerStart() is actually called. The + * timer service/daemon task priority is set by the configTIMER_TASK_PRIORITY + * configuration constant. + * + * Example usage: + * @verbatim + * // When a key is pressed, an LCD back-light is switched on. If 5 seconds pass + * // without a key being pressed, then the LCD back-light is switched off. In + * // this case, the timer is a one-shot timer. + * + * TimerHandle_t xBacklightTimer = NULL; + * + * // The callback function assigned to the one-shot timer. In this case the + * // parameter is not used. + * void vBacklightTimerCallback( TimerHandle_t pxTimer ) + * { + * // The timer expired, therefore 5 seconds must have passed since a key + * // was pressed. Switch off the LCD back-light. + * vSetBacklightState( BACKLIGHT_OFF ); + * } + * + * // The key press event handler. + * void vKeyPressEventHandler( char cKey ) + * { + * // Ensure the LCD back-light is on, then reset the timer that is + * // responsible for turning the back-light off after 5 seconds of + * // key inactivity. Wait 10 ticks for the command to be successfully sent + * // if it cannot be sent immediately. + * vSetBacklightState( BACKLIGHT_ON ); + * if( xTimerReset( xBacklightTimer, 100 ) != pdPASS ) + * { + * // The reset command was not executed successfully. Take appropriate + * // action here. + * } + * + * // Perform the rest of the key processing here. + * } + * + * void main( void ) + * { + * int32_t x; + * + * // Create then start the one-shot timer that is responsible for turning + * // the back-light off if no keys are pressed within a 5 second period. + * xBacklightTimer = xTimerCreate( "BacklightTimer", // Just a text name, not used by the kernel. + * ( 5000 / portTICK_PERIOD_MS), // The timer period in ticks. + * pdFALSE, // The timer is a one-shot timer. + * 0, // The id is not used by the callback so can take any value. + * vBacklightTimerCallback // The callback function that switches the LCD back-light off. + * ); + * + * if( xBacklightTimer == NULL ) + * { + * // The timer was not created. + * } + * else + * { + * // Start the timer. No block time is specified, and even if one was + * // it would be ignored because the scheduler has not yet been + * // started. + * if( xTimerStart( xBacklightTimer, 0 ) != pdPASS ) + * { + * // The timer could not be set into the Active state. + * } + * } + * + * // ... + * // Create tasks here. + * // ... + * + * // Starting the scheduler will start the timer running as it has already + * // been set into the active state. + * xTaskStartScheduler(); + * + * // Should not reach here. + * for( ;; ); + * } + * @endverbatim + */ +#define xTimerReset( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_RESET, ( xTaskGetTickCount() ), NULL, ( xTicksToWait ) ) + +/** + * BaseType_t xTimerStartFromISR( TimerHandle_t xTimer, + * BaseType_t *pxHigherPriorityTaskWoken ); + * + * A version of xTimerStart() that can be called from an interrupt service + * routine. + * + * @param xTimer The handle of the timer being started/restarted. + * + * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most + * of its time in the Blocked state, waiting for messages to arrive on the timer + * command queue. Calling xTimerStartFromISR() writes a message to the timer + * command queue, so has the potential to transition the timer service/daemon + * task out of the Blocked state. If calling xTimerStartFromISR() causes the + * timer service/daemon task to leave the Blocked state, and the timer service/ + * daemon task has a priority equal to or greater than the currently executing + * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will + * get set to pdTRUE internally within the xTimerStartFromISR() function. If + * xTimerStartFromISR() sets this value to pdTRUE then a context switch should + * be performed before the interrupt exits. + * + * @return pdFAIL will be returned if the start command could not be sent to + * the timer command queue. pdPASS will be returned if the command was + * successfully sent to the timer command queue. When the command is actually + * processed will depend on the priority of the timer service/daemon task + * relative to other tasks in the system, although the timers expiry time is + * relative to when xTimerStartFromISR() is actually called. The timer + * service/daemon task priority is set by the configTIMER_TASK_PRIORITY + * configuration constant. + * + * Example usage: + * @verbatim + * // This scenario assumes xBacklightTimer has already been created. When a + * // key is pressed, an LCD back-light is switched on. If 5 seconds pass + * // without a key being pressed, then the LCD back-light is switched off. In + * // this case, the timer is a one-shot timer, and unlike the example given for + * // the xTimerReset() function, the key press event handler is an interrupt + * // service routine. + * + * // The callback function assigned to the one-shot timer. In this case the + * // parameter is not used. + * void vBacklightTimerCallback( TimerHandle_t pxTimer ) + * { + * // The timer expired, therefore 5 seconds must have passed since a key + * // was pressed. Switch off the LCD back-light. + * vSetBacklightState( BACKLIGHT_OFF ); + * } + * + * // The key press interrupt service routine. + * void vKeyPressEventInterruptHandler( void ) + * { + * BaseType_t xHigherPriorityTaskWoken = pdFALSE; + * + * // Ensure the LCD back-light is on, then restart the timer that is + * // responsible for turning the back-light off after 5 seconds of + * // key inactivity. This is an interrupt service routine so can only + * // call FreeRTOS API functions that end in "FromISR". + * vSetBacklightState( BACKLIGHT_ON ); + * + * // xTimerStartFromISR() or xTimerResetFromISR() could be called here + * // as both cause the timer to re-calculate its expiry time. + * // xHigherPriorityTaskWoken was initialised to pdFALSE when it was + * // declared (in this function). + * if( xTimerStartFromISR( xBacklightTimer, &xHigherPriorityTaskWoken ) != pdPASS ) + * { + * // The start command was not executed successfully. Take appropriate + * // action here. + * } + * + * // Perform the rest of the key processing here. + * + * // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch + * // should be performed. The syntax required to perform a context switch + * // from inside an ISR varies from port to port, and from compiler to + * // compiler. Inspect the demos for the port you are using to find the + * // actual syntax required. + * if( xHigherPriorityTaskWoken != pdFALSE ) + * { + * // Call the interrupt safe yield function here (actual function + * // depends on the FreeRTOS port being used). + * } + * } + * @endverbatim + */ +#define xTimerStartFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_START_FROM_ISR, ( xTaskGetTickCountFromISR() ), ( pxHigherPriorityTaskWoken ), 0U ) + +/** + * BaseType_t xTimerStopFromISR( TimerHandle_t xTimer, + * BaseType_t *pxHigherPriorityTaskWoken ); + * + * A version of xTimerStop() that can be called from an interrupt service + * routine. + * + * @param xTimer The handle of the timer being stopped. + * + * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most + * of its time in the Blocked state, waiting for messages to arrive on the timer + * command queue. Calling xTimerStopFromISR() writes a message to the timer + * command queue, so has the potential to transition the timer service/daemon + * task out of the Blocked state. If calling xTimerStopFromISR() causes the + * timer service/daemon task to leave the Blocked state, and the timer service/ + * daemon task has a priority equal to or greater than the currently executing + * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will + * get set to pdTRUE internally within the xTimerStopFromISR() function. If + * xTimerStopFromISR() sets this value to pdTRUE then a context switch should + * be performed before the interrupt exits. + * + * @return pdFAIL will be returned if the stop command could not be sent to + * the timer command queue. pdPASS will be returned if the command was + * successfully sent to the timer command queue. When the command is actually + * processed will depend on the priority of the timer service/daemon task + * relative to other tasks in the system. The timer service/daemon task + * priority is set by the configTIMER_TASK_PRIORITY configuration constant. + * + * Example usage: + * @verbatim + * // This scenario assumes xTimer has already been created and started. When + * // an interrupt occurs, the timer should be simply stopped. + * + * // The interrupt service routine that stops the timer. + * void vAnExampleInterruptServiceRoutine( void ) + * { + * BaseType_t xHigherPriorityTaskWoken = pdFALSE; + * + * // The interrupt has occurred - simply stop the timer. + * // xHigherPriorityTaskWoken was set to pdFALSE where it was defined + * // (within this function). As this is an interrupt service routine, only + * // FreeRTOS API functions that end in "FromISR" can be used. + * if( xTimerStopFromISR( xTimer, &xHigherPriorityTaskWoken ) != pdPASS ) + * { + * // The stop command was not executed successfully. Take appropriate + * // action here. + * } + * + * // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch + * // should be performed. The syntax required to perform a context switch + * // from inside an ISR varies from port to port, and from compiler to + * // compiler. Inspect the demos for the port you are using to find the + * // actual syntax required. + * if( xHigherPriorityTaskWoken != pdFALSE ) + * { + * // Call the interrupt safe yield function here (actual function + * // depends on the FreeRTOS port being used). + * } + * } + * @endverbatim + */ +#define xTimerStopFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_STOP_FROM_ISR, 0, ( pxHigherPriorityTaskWoken ), 0U ) + +/** + * BaseType_t xTimerChangePeriodFromISR( TimerHandle_t xTimer, + * TickType_t xNewPeriod, + * BaseType_t *pxHigherPriorityTaskWoken ); + * + * A version of xTimerChangePeriod() that can be called from an interrupt + * service routine. + * + * @param xTimer The handle of the timer that is having its period changed. + * + * @param xNewPeriod The new period for xTimer. Timer periods are specified in + * tick periods, so the constant portTICK_PERIOD_MS can be used to convert a time + * that has been specified in milliseconds. For example, if the timer must + * expire after 100 ticks, then xNewPeriod should be set to 100. Alternatively, + * if the timer must expire after 500ms, then xNewPeriod can be set to + * ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than + * or equal to 1000. + * + * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most + * of its time in the Blocked state, waiting for messages to arrive on the timer + * command queue. Calling xTimerChangePeriodFromISR() writes a message to the + * timer command queue, so has the potential to transition the timer service/ + * daemon task out of the Blocked state. If calling xTimerChangePeriodFromISR() + * causes the timer service/daemon task to leave the Blocked state, and the + * timer service/daemon task has a priority equal to or greater than the + * currently executing task (the task that was interrupted), then + * *pxHigherPriorityTaskWoken will get set to pdTRUE internally within the + * xTimerChangePeriodFromISR() function. If xTimerChangePeriodFromISR() sets + * this value to pdTRUE then a context switch should be performed before the + * interrupt exits. + * + * @return pdFAIL will be returned if the command to change the timers period + * could not be sent to the timer command queue. pdPASS will be returned if the + * command was successfully sent to the timer command queue. When the command + * is actually processed will depend on the priority of the timer service/daemon + * task relative to other tasks in the system. The timer service/daemon task + * priority is set by the configTIMER_TASK_PRIORITY configuration constant. + * + * Example usage: + * @verbatim + * // This scenario assumes xTimer has already been created and started. When + * // an interrupt occurs, the period of xTimer should be changed to 500ms. + * + * // The interrupt service routine that changes the period of xTimer. + * void vAnExampleInterruptServiceRoutine( void ) + * { + * BaseType_t xHigherPriorityTaskWoken = pdFALSE; + * + * // The interrupt has occurred - change the period of xTimer to 500ms. + * // xHigherPriorityTaskWoken was set to pdFALSE where it was defined + * // (within this function). As this is an interrupt service routine, only + * // FreeRTOS API functions that end in "FromISR" can be used. + * if( xTimerChangePeriodFromISR( xTimer, &xHigherPriorityTaskWoken ) != pdPASS ) + * { + * // The command to change the timers period was not executed + * // successfully. Take appropriate action here. + * } + * + * // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch + * // should be performed. The syntax required to perform a context switch + * // from inside an ISR varies from port to port, and from compiler to + * // compiler. Inspect the demos for the port you are using to find the + * // actual syntax required. + * if( xHigherPriorityTaskWoken != pdFALSE ) + * { + * // Call the interrupt safe yield function here (actual function + * // depends on the FreeRTOS port being used). + * } + * } + * @endverbatim + */ +#define xTimerChangePeriodFromISR( xTimer, xNewPeriod, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_CHANGE_PERIOD_FROM_ISR, ( xNewPeriod ), ( pxHigherPriorityTaskWoken ), 0U ) + +/** + * BaseType_t xTimerResetFromISR( TimerHandle_t xTimer, + * BaseType_t *pxHigherPriorityTaskWoken ); + * + * A version of xTimerReset() that can be called from an interrupt service + * routine. + * + * @param xTimer The handle of the timer that is to be started, reset, or + * restarted. + * + * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most + * of its time in the Blocked state, waiting for messages to arrive on the timer + * command queue. Calling xTimerResetFromISR() writes a message to the timer + * command queue, so has the potential to transition the timer service/daemon + * task out of the Blocked state. If calling xTimerResetFromISR() causes the + * timer service/daemon task to leave the Blocked state, and the timer service/ + * daemon task has a priority equal to or greater than the currently executing + * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will + * get set to pdTRUE internally within the xTimerResetFromISR() function. If + * xTimerResetFromISR() sets this value to pdTRUE then a context switch should + * be performed before the interrupt exits. + * + * @return pdFAIL will be returned if the reset command could not be sent to + * the timer command queue. pdPASS will be returned if the command was + * successfully sent to the timer command queue. When the command is actually + * processed will depend on the priority of the timer service/daemon task + * relative to other tasks in the system, although the timers expiry time is + * relative to when xTimerResetFromISR() is actually called. The timer service/daemon + * task priority is set by the configTIMER_TASK_PRIORITY configuration constant. + * + * Example usage: + * @verbatim + * // This scenario assumes xBacklightTimer has already been created. When a + * // key is pressed, an LCD back-light is switched on. If 5 seconds pass + * // without a key being pressed, then the LCD back-light is switched off. In + * // this case, the timer is a one-shot timer, and unlike the example given for + * // the xTimerReset() function, the key press event handler is an interrupt + * // service routine. + * + * // The callback function assigned to the one-shot timer. In this case the + * // parameter is not used. + * void vBacklightTimerCallback( TimerHandle_t pxTimer ) + * { + * // The timer expired, therefore 5 seconds must have passed since a key + * // was pressed. Switch off the LCD back-light. + * vSetBacklightState( BACKLIGHT_OFF ); + * } + * + * // The key press interrupt service routine. + * void vKeyPressEventInterruptHandler( void ) + * { + * BaseType_t xHigherPriorityTaskWoken = pdFALSE; + * + * // Ensure the LCD back-light is on, then reset the timer that is + * // responsible for turning the back-light off after 5 seconds of + * // key inactivity. This is an interrupt service routine so can only + * // call FreeRTOS API functions that end in "FromISR". + * vSetBacklightState( BACKLIGHT_ON ); + * + * // xTimerStartFromISR() or xTimerResetFromISR() could be called here + * // as both cause the timer to re-calculate its expiry time. + * // xHigherPriorityTaskWoken was initialised to pdFALSE when it was + * // declared (in this function). + * if( xTimerResetFromISR( xBacklightTimer, &xHigherPriorityTaskWoken ) != pdPASS ) + * { + * // The reset command was not executed successfully. Take appropriate + * // action here. + * } + * + * // Perform the rest of the key processing here. + * + * // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch + * // should be performed. The syntax required to perform a context switch + * // from inside an ISR varies from port to port, and from compiler to + * // compiler. Inspect the demos for the port you are using to find the + * // actual syntax required. + * if( xHigherPriorityTaskWoken != pdFALSE ) + * { + * // Call the interrupt safe yield function here (actual function + * // depends on the FreeRTOS port being used). + * } + * } + * @endverbatim + */ +#define xTimerResetFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_RESET_FROM_ISR, ( xTaskGetTickCountFromISR() ), ( pxHigherPriorityTaskWoken ), 0U ) + + +/** + * BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend, + * void *pvParameter1, + * uint32_t ulParameter2, + * BaseType_t *pxHigherPriorityTaskWoken ); + * + * + * Used from application interrupt service routines to defer the execution of a + * function to the RTOS daemon task (the timer service task, hence this function + * is implemented in timers.c and is prefixed with 'Timer'). + * + * Ideally an interrupt service routine (ISR) is kept as short as possible, but + * sometimes an ISR either has a lot of processing to do, or needs to perform + * processing that is not deterministic. In these cases + * xTimerPendFunctionCallFromISR() can be used to defer processing of a function + * to the RTOS daemon task. + * + * A mechanism is provided that allows the interrupt to return directly to the + * task that will subsequently execute the pended callback function. This + * allows the callback function to execute contiguously in time with the + * interrupt - just as if the callback had executed in the interrupt itself. + * + * @param xFunctionToPend The function to execute from the timer service/ + * daemon task. The function must conform to the PendedFunction_t + * prototype. + * + * @param pvParameter1 The value of the callback function's first parameter. + * The parameter has a void * type to allow it to be used to pass any type. + * For example, unsigned longs can be cast to a void *, or the void * can be + * used to point to a structure. + * + * @param ulParameter2 The value of the callback function's second parameter. + * + * @param pxHigherPriorityTaskWoken As mentioned above, calling this function + * will result in a message being sent to the timer daemon task. If the + * priority of the timer daemon task (which is set using + * configTIMER_TASK_PRIORITY in FreeRTOSConfig.h) is higher than the priority of + * the currently running task (the task the interrupt interrupted) then + * *pxHigherPriorityTaskWoken will be set to pdTRUE within + * xTimerPendFunctionCallFromISR(), indicating that a context switch should be + * requested before the interrupt exits. For that reason + * *pxHigherPriorityTaskWoken must be initialised to pdFALSE. See the + * example code below. + * + * @return pdPASS is returned if the message was successfully sent to the + * timer daemon task, otherwise pdFALSE is returned. + * + * Example usage: + * @verbatim + * + * // The callback function that will execute in the context of the daemon task. + * // Note callback functions must all use this same prototype. + * void vProcessInterface( void *pvParameter1, uint32_t ulParameter2 ) + * { + * BaseType_t xInterfaceToService; + * + * // The interface that requires servicing is passed in the second + * // parameter. The first parameter is not used in this case. + * xInterfaceToService = ( BaseType_t ) ulParameter2; + * + * // ...Perform the processing here... + * } + * + * // An ISR that receives data packets from multiple interfaces + * void vAnISR( void ) + * { + * BaseType_t xInterfaceToService, xHigherPriorityTaskWoken; + * + * // Query the hardware to determine which interface needs processing. + * xInterfaceToService = prvCheckInterfaces(); + * + * // The actual processing is to be deferred to a task. Request the + * // vProcessInterface() callback function is executed, passing in the + * // number of the interface that needs processing. The interface to + * // service is passed in the second parameter. The first parameter is + * // not used in this case. + * xHigherPriorityTaskWoken = pdFALSE; + * xTimerPendFunctionCallFromISR( vProcessInterface, NULL, ( uint32_t ) xInterfaceToService, &xHigherPriorityTaskWoken ); + * + * // If xHigherPriorityTaskWoken is now set to pdTRUE then a context + * // switch should be requested. The macro used is port specific and will + * // be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() - refer to + * // the documentation page for the port being used. + * portYIELD_FROM_ISR( xHigherPriorityTaskWoken ); + * + * } + * @endverbatim + */ +BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, BaseType_t *pxHigherPriorityTaskWoken ); + + /** + * BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, + * void *pvParameter1, + * uint32_t ulParameter2, + * TickType_t xTicksToWait ); + * + * + * Used to defer the execution of a function to the RTOS daemon task (the timer + * service task, hence this function is implemented in timers.c and is prefixed + * with 'Timer'). + * + * @param xFunctionToPend The function to execute from the timer service/ + * daemon task. The function must conform to the PendedFunction_t + * prototype. + * + * @param pvParameter1 The value of the callback function's first parameter. + * The parameter has a void * type to allow it to be used to pass any type. + * For example, unsigned longs can be cast to a void *, or the void * can be + * used to point to a structure. + * + * @param ulParameter2 The value of the callback function's second parameter. + * + * @param xTicksToWait Calling this function will result in a message being + * sent to the timer daemon task on a queue. xTicksToWait is the amount of + * time the calling task should remain in the Blocked state (so not using any + * processing time) for space to become available on the timer queue if the + * queue is found to be full. + * + * @return pdPASS is returned if the message was successfully sent to the + * timer daemon task, otherwise pdFALSE is returned. + * + */ +BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, TickType_t xTicksToWait ); + +/** + * const char * const pcTimerGetTimerName( TimerHandle_t xTimer ); + * + * Returns the name that was assigned to a timer when the timer was created. + * + * @param xTimer The handle of the timer being queried. + * + * @return The name assigned to the timer specified by the xTimer parameter. + */ +const char * pcTimerGetTimerName( TimerHandle_t xTimer ); /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/* + * Functions beyond this part are not part of the public API and are intended + * for use by the kernel only. + */ +BaseType_t xTimerCreateTimerTask( void ) PRIVILEGED_FUNCTION; +BaseType_t xTimerGenericCommand( TimerHandle_t xTimer, const BaseType_t xCommandID, const TickType_t xOptionalValue, BaseType_t * const pxHigherPriorityTaskWoken, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +#ifdef __cplusplus +} +#endif +#endif /* TIMERS_H */ + + + diff --git a/components/freertos/include/freertos/xtensa_api.h b/components/freertos/include/freertos/xtensa_api.h new file mode 100644 index 000000000..04ad7d62d --- /dev/null +++ b/components/freertos/include/freertos/xtensa_api.h @@ -0,0 +1,118 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +******************************************************************************/ + +/****************************************************************************** + Xtensa-specific API for RTOS ports. +******************************************************************************/ + +#ifndef __XTENSA_API_H__ +#define __XTENSA_API_H__ + +#include + +#include "xtensa_context.h" + + +/* Typedef for C-callable interrupt handler function */ +typedef void (*xt_handler)(void *); + +/* Typedef for C-callable exception handler function */ +typedef void (*xt_exc_handler)(XtExcFrame *); + + +/* +------------------------------------------------------------------------------- + Call this function to set a handler for the specified exception. + + n - Exception number (type) + f - Handler function address, NULL to uninstall handler. + + The handler will be passed a pointer to the exception frame, which is created + on the stack of the thread that caused the exception. + + If the handler returns, the thread context will be restored and the faulting + instruction will be retried. Any values in the exception frame that are + modified by the handler will be restored as part of the context. For details + of the exception frame structure see xtensa_context.h. +------------------------------------------------------------------------------- +*/ +extern xt_exc_handler xt_set_exception_handler(int n, xt_exc_handler f); + + +/* +------------------------------------------------------------------------------- + Call this function to set a handler for the specified interrupt. + + n - Interrupt number. + f - Handler function address, NULL to uninstall handler. + arg - Argument to be passed to handler. +------------------------------------------------------------------------------- +*/ +extern xt_handler xt_set_interrupt_handler(int n, xt_handler f, void * arg); + + +/* +------------------------------------------------------------------------------- + Call this function to enable the specified interrupts. + + mask - Bit mask of interrupts to be enabled. +------------------------------------------------------------------------------- +*/ +extern void xt_ints_on(unsigned int mask); + + +/* +------------------------------------------------------------------------------- + Call this function to disable the specified interrupts. + + mask - Bit mask of interrupts to be disabled. +------------------------------------------------------------------------------- +*/ +extern void xt_ints_off(unsigned int mask); + + +/* +------------------------------------------------------------------------------- + Call this function to set the specified (s/w) interrupt. +------------------------------------------------------------------------------- +*/ +static inline void xt_set_intset(unsigned int arg) +{ + xthal_set_intset(arg); +} + + +/* +------------------------------------------------------------------------------- + Call this function to clear the specified (s/w or edge-triggered) + interrupt. +------------------------------------------------------------------------------- +*/ +static inline void xt_set_intclear(unsigned int arg) +{ + xthal_set_intclear(arg); +} + + +#endif /* __XTENSA_API_H__ */ + diff --git a/components/freertos/include/freertos/xtensa_config.h b/components/freertos/include/freertos/xtensa_config.h new file mode 100644 index 000000000..58baee2da --- /dev/null +++ b/components/freertos/include/freertos/xtensa_config.h @@ -0,0 +1,146 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + Configuration-specific information for Xtensa build. This file must be + included in FreeRTOSConfig.h to properly set up the config-dependent + parameters correctly. + + NOTE: To enable thread-safe C library support, XT_USE_THREAD_SAFE_CLIB must + be defined to be > 0 somewhere above or on the command line. + +*******************************************************************************/ + +#ifndef XTENSA_CONFIG_H +#define XTENSA_CONFIG_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include /* required for XSHAL_CLIB */ + +#include "xtensa_context.h" + + +/*----------------------------------------------------------------------------- +* STACK REQUIREMENTS +* +* This section defines the minimum stack size, and the extra space required to +* be allocated for saving coprocessor state and/or C library state information +* (if thread safety is enabled for the C library). The sizes are in bytes. +* +* Stack sizes for individual tasks should be derived from these minima based on +* the maximum call depth of the task and the maximum level of interrupt nesting. +* A minimum stack size is defined by XT_STACK_MIN_SIZE. This minimum is based +* on the requirement for a task that calls nothing else but can be interrupted. +* This assumes that interrupt handlers do not call more than a few levels deep. +* If this is not true, i.e. one or more interrupt handlers make deep calls then +* the minimum must be increased. +* +* If the Xtensa processor configuration includes coprocessors, then space is +* allocated to save the coprocessor state on the stack. +* +* If thread safety is enabled for the C runtime library, (XT_USE_THREAD_SAFE_CLIB +* is defined) then space is allocated to save the C library context in the TCB. +* +* Allocating insufficient stack space is a common source of hard-to-find errors. +* During development, it is best to enable the FreeRTOS stack checking features. +* +* Usage: +* +* XT_USE_THREAD_SAFE_CLIB -- Define this to a nonzero value to enable thread-safe +* use of the C library. This will require extra stack +* space to be allocated for tasks that use the C library +* reentrant functions. See below for more information. +* +* NOTE: The Xtensa toolchain supports multiple C libraries and not all of them +* support thread safety. Check your core configuration to see which C library +* was chosen for your system. +* +* XT_STACK_MIN_SIZE -- The minimum stack size for any task. It is recommended +* that you do not use a stack smaller than this for any +* task. In case you want to use stacks smaller than this +* size, you must verify that the smaller size(s) will work +* under all operating conditions. +* +* XT_STACK_EXTRA -- The amount of extra stack space to allocate for a task +* that does not make C library reentrant calls. Add this +* to the amount of stack space required by the task itself. +* +* XT_STACK_EXTRA_CLIB -- The amount of space to allocate for C library state. +* +-----------------------------------------------------------------------------*/ + +/* Extra space required for interrupt/exception hooks. */ +#ifdef XT_INTEXC_HOOKS + #ifdef __XTENSA_CALL0_ABI__ + #define STK_INTEXC_EXTRA 0x200 + #else + #define STK_INTEXC_EXTRA 0x180 + #endif +#else + #define STK_INTEXC_EXTRA 0 +#endif + +#define XT_CLIB_CONTEXT_AREA_SIZE 0 + +/*------------------------------------------------------------------------------ + Extra size -- interrupt frame plus coprocessor save area plus hook space. + NOTE: Make sure XT_INTEXC_HOOKS is undefined unless you really need the hooks. +------------------------------------------------------------------------------*/ +#ifdef __XTENSA_CALL0_ABI__ + #define XT_XTRA_SIZE (XT_STK_FRMSZ + STK_INTEXC_EXTRA + 0x10 + XT_CP_SIZE) +#else + #define XT_XTRA_SIZE (XT_STK_FRMSZ + STK_INTEXC_EXTRA + 0x20 + XT_CP_SIZE) +#endif + +/*------------------------------------------------------------------------------ + Space allocated for user code -- function calls and local variables. + NOTE: This number can be adjusted to suit your needs. You must verify that the + amount of space you reserve is adequate for the worst-case conditions in your + application. + NOTE: The windowed ABI requires more stack, since space has to be reserved + for spilling register windows. +------------------------------------------------------------------------------*/ +#ifdef __XTENSA_CALL0_ABI__ + #define XT_USER_SIZE 0x200 +#else + #define XT_USER_SIZE 0x400 +#endif + +/* Minimum recommended stack size. */ +#define XT_STACK_MIN_SIZE ((XT_XTRA_SIZE + XT_USER_SIZE) / sizeof(unsigned char)) + +/* OS overhead with and without C library thread context. */ +#define XT_STACK_EXTRA (XT_XTRA_SIZE) +#define XT_STACK_EXTRA_CLIB (XT_XTRA_SIZE + XT_CLIB_CONTEXT_AREA_SIZE) + + +#ifdef __cplusplus +} +#endif + +#endif /* XTENSA_CONFIG_H */ + diff --git a/components/freertos/include/freertos/xtensa_context.h b/components/freertos/include/freertos/xtensa_context.h new file mode 100644 index 000000000..3167c8472 --- /dev/null +++ b/components/freertos/include/freertos/xtensa_context.h @@ -0,0 +1,383 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA CONTEXT FRAMES AND MACROS FOR RTOS ASSEMBLER SOURCES + +This header contains definitions and macros for use primarily by Xtensa +RTOS assembly coded source files. It includes and uses the Xtensa hardware +abstraction layer (HAL) to deal with config specifics. It may also be +included in C source files. + +!! Supports only Xtensa Exception Architecture 2 (XEA2). XEA1 not supported. !! + +NOTE: The Xtensa architecture requires stack pointer alignment to 16 bytes. + +*******************************************************************************/ + +#ifndef XTENSA_CONTEXT_H +#define XTENSA_CONTEXT_H + +#ifdef __ASSEMBLER__ +#include +#endif + +#include +#include +#include +#include + + +/* Align a value up to nearest n-byte boundary, where n is a power of 2. */ +#define ALIGNUP(n, val) (((val) + (n)-1) & -(n)) + + +/* +------------------------------------------------------------------------------- + Macros that help define structures for both C and assembler. +------------------------------------------------------------------------------- +*/ + +#ifdef STRUCT_BEGIN +#undef STRUCT_BEGIN +#undef STRUCT_FIELD +#undef STRUCT_AFIELD +#undef STRUCT_END +#endif + +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) + +#define STRUCT_BEGIN .pushsection .text; .struct 0 +#define STRUCT_FIELD(ctype,size,asname,name) asname: .space size +#define STRUCT_AFIELD(ctype,size,asname,name,n) asname: .space (size)*(n) +#define STRUCT_END(sname) sname##Size:; .popsection + +#else + +#define STRUCT_BEGIN typedef struct { +#define STRUCT_FIELD(ctype,size,asname,name) ctype name; +#define STRUCT_AFIELD(ctype,size,asname,name,n) ctype name[n]; +#define STRUCT_END(sname) } sname; + +#endif //_ASMLANGUAGE || __ASSEMBLER__ + + +/* +------------------------------------------------------------------------------- + INTERRUPT/EXCEPTION STACK FRAME FOR A THREAD OR NESTED INTERRUPT + + A stack frame of this structure is allocated for any interrupt or exception. + It goes on the current stack. If the RTOS has a system stack for handling + interrupts, every thread stack must allow space for just one interrupt stack + frame, then nested interrupt stack frames go on the system stack. + + The frame includes basic registers (explicit) and "extra" registers introduced + by user TIE or the use of the MAC16 option in the user's Xtensa config. + The frame size is minimized by omitting regs not applicable to user's config. + + For Windowed ABI, this stack frame includes the interruptee's base save area, + another base save area to manage gcc nested functions, and a little temporary + space to help manage the spilling of the register windows. +------------------------------------------------------------------------------- +*/ + +STRUCT_BEGIN +STRUCT_FIELD (long, 4, XT_STK_EXIT, exit) /* exit point for dispatch */ +STRUCT_FIELD (long, 4, XT_STK_PC, pc) /* return PC */ +STRUCT_FIELD (long, 4, XT_STK_PS, ps) /* return PS */ +STRUCT_FIELD (long, 4, XT_STK_A0, a0) +STRUCT_FIELD (long, 4, XT_STK_A1, a1) /* stack pointer before interrupt */ +STRUCT_FIELD (long, 4, XT_STK_A2, a2) +STRUCT_FIELD (long, 4, XT_STK_A3, a3) +STRUCT_FIELD (long, 4, XT_STK_A4, a4) +STRUCT_FIELD (long, 4, XT_STK_A5, a5) +STRUCT_FIELD (long, 4, XT_STK_A6, a6) +STRUCT_FIELD (long, 4, XT_STK_A7, a7) +STRUCT_FIELD (long, 4, XT_STK_A8, a8) +STRUCT_FIELD (long, 4, XT_STK_A9, a9) +STRUCT_FIELD (long, 4, XT_STK_A10, a10) +STRUCT_FIELD (long, 4, XT_STK_A11, a11) +STRUCT_FIELD (long, 4, XT_STK_A12, a12) +STRUCT_FIELD (long, 4, XT_STK_A13, a13) +STRUCT_FIELD (long, 4, XT_STK_A14, a14) +STRUCT_FIELD (long, 4, XT_STK_A15, a15) +STRUCT_FIELD (long, 4, XT_STK_SAR, sar) +STRUCT_FIELD (long, 4, XT_STK_EXCCAUSE, exccause) +STRUCT_FIELD (long, 4, XT_STK_EXCVADDR, excvaddr) +#if XCHAL_HAVE_LOOPS +STRUCT_FIELD (long, 4, XT_STK_LBEG, lbeg) +STRUCT_FIELD (long, 4, XT_STK_LEND, lend) +STRUCT_FIELD (long, 4, XT_STK_LCOUNT, lcount) +#endif +#ifndef __XTENSA_CALL0_ABI__ +/* Temporary space for saving stuff during window spill */ +STRUCT_FIELD (long, 4, XT_STK_TMP0, tmp0) +STRUCT_FIELD (long, 4, XT_STK_TMP1, tmp1) +STRUCT_FIELD (long, 4, XT_STK_TMP2, tmp2) +#endif +#ifdef XT_USE_SWPRI +/* Storage for virtual priority mask */ +STRUCT_FIELD (long, 4, XT_STK_VPRI, vpri) +#endif +#ifdef XT_USE_OVLY +/* Storage for overlay state */ +STRUCT_FIELD (long, 4, XT_STK_OVLY, ovly) +#endif +STRUCT_END(XtExcFrame) + +#if defined(_ASMLANGUAGE) || defined(__ASSEMBLER__) +#define XT_STK_NEXT1 XtExcFrameSize +#else +#define XT_STK_NEXT1 sizeof(XtExcFrame) +#endif + +/* Allocate extra storage if needed */ +#if XCHAL_EXTRA_SA_SIZE != 0 + +#if XCHAL_EXTRA_SA_ALIGN <= 16 +#define XT_STK_EXTRA ALIGNUP(XCHAL_EXTRA_SA_ALIGN, XT_STK_NEXT1) +#else +/* If need more alignment than stack, add space for dynamic alignment */ +#define XT_STK_EXTRA (ALIGNUP(XCHAL_EXTRA_SA_ALIGN, XT_STK_NEXT1) + XCHAL_EXTRA_SA_ALIGN) +#endif +#define XT_STK_NEXT2 (XT_STK_EXTRA + XCHAL_EXTRA_SA_SIZE) + +#else + +#define XT_STK_NEXT2 XT_STK_NEXT1 + +#endif + +/* +------------------------------------------------------------------------------- + This is the frame size. Add space for 4 registers (interruptee's base save + area) and some space for gcc nested functions if any. +------------------------------------------------------------------------------- +*/ +#define XT_STK_FRMSZ (ALIGNUP(0x10, XT_STK_NEXT2) + 0x20) + + +/* +------------------------------------------------------------------------------- + SOLICITED STACK FRAME FOR A THREAD + + A stack frame of this structure is allocated whenever a thread enters the + RTOS kernel intentionally (and synchronously) to submit to thread scheduling. + It goes on the current thread's stack. + + The solicited frame only includes registers that are required to be preserved + by the callee according to the compiler's ABI conventions, some space to save + the return address for returning to the caller, and the caller's PS register. + + For Windowed ABI, this stack frame includes the caller's base save area. + + Note on XT_SOL_EXIT field: + It is necessary to distinguish a solicited from an interrupt stack frame. + This field corresponds to XT_STK_EXIT in the interrupt stack frame and is + always at the same offset (0). It can be written with a code (usually 0) + to distinguish a solicted frame from an interrupt frame. An RTOS port may + opt to ignore this field if it has another way of distinguishing frames. +------------------------------------------------------------------------------- +*/ + +STRUCT_BEGIN +#ifdef __XTENSA_CALL0_ABI__ +STRUCT_FIELD (long, 4, XT_SOL_EXIT, exit) +STRUCT_FIELD (long, 4, XT_SOL_PC, pc) +STRUCT_FIELD (long, 4, XT_SOL_PS, ps) +STRUCT_FIELD (long, 4, XT_SOL_NEXT, next) +STRUCT_FIELD (long, 4, XT_SOL_A12, a12) /* should be on 16-byte alignment */ +STRUCT_FIELD (long, 4, XT_SOL_A13, a13) +STRUCT_FIELD (long, 4, XT_SOL_A14, a14) +STRUCT_FIELD (long, 4, XT_SOL_A15, a15) +#else +STRUCT_FIELD (long, 4, XT_SOL_EXIT, exit) +STRUCT_FIELD (long, 4, XT_SOL_PC, pc) +STRUCT_FIELD (long, 4, XT_SOL_PS, ps) +STRUCT_FIELD (long, 4, XT_SOL_NEXT, next) +STRUCT_FIELD (long, 4, XT_SOL_A0, a0) /* should be on 16-byte alignment */ +STRUCT_FIELD (long, 4, XT_SOL_A1, a1) +STRUCT_FIELD (long, 4, XT_SOL_A2, a2) +STRUCT_FIELD (long, 4, XT_SOL_A3, a3) +#endif +STRUCT_END(XtSolFrame) + +/* Size of solicited stack frame */ +#define XT_SOL_FRMSZ ALIGNUP(0x10, XtSolFrameSize) + + +/* +------------------------------------------------------------------------------- + CO-PROCESSOR STATE SAVE AREA FOR A THREAD + + The RTOS must provide an area per thread to save the state of co-processors + when that thread does not have control. Co-processors are context-switched + lazily (on demand) only when a new thread uses a co-processor instruction, + otherwise a thread retains ownership of the co-processor even when it loses + control of the processor. An Xtensa co-processor exception is triggered when + any co-processor instruction is executed by a thread that is not the owner, + and the context switch of that co-processor is then peformed by the handler. + Ownership represents which thread's state is currently in the co-processor. + + Co-processors may not be used by interrupt or exception handlers. If an + co-processor instruction is executed by an interrupt or exception handler, + the co-processor exception handler will trigger a kernel panic and freeze. + This restriction is introduced to reduce the overhead of saving and restoring + co-processor state (which can be quite large) and in particular remove that + overhead from interrupt handlers. + + The co-processor state save area may be in any convenient per-thread location + such as in the thread control block or above the thread stack area. It need + not be in the interrupt stack frame since interrupts don't use co-processors. + + Along with the save area for each co-processor, two bitmasks with flags per + co-processor (laid out as in the CPENABLE reg) help manage context-switching + co-processors as efficiently as possible: + + XT_CPENABLE + The contents of a non-running thread's CPENABLE register. + It represents the co-processors owned (and whose state is still needed) + by the thread. When a thread is preempted, its CPENABLE is saved here. + When a thread solicits a context-swtich, its CPENABLE is cleared - the + compiler has saved the (caller-saved) co-proc state if it needs to. + When a non-running thread loses ownership of a CP, its bit is cleared. + When a thread runs, it's XT_CPENABLE is loaded into the CPENABLE reg. + Avoids co-processor exceptions when no change of ownership is needed. + + XT_CPSTORED + A bitmask with the same layout as CPENABLE, a bit per co-processor. + Indicates whether the state of each co-processor is saved in the state + save area. When a thread enters the kernel, only the state of co-procs + still enabled in CPENABLE is saved. When the co-processor exception + handler assigns ownership of a co-processor to a thread, it restores + the saved state only if this bit is set, and clears this bit. + + XT_CP_CS_ST + A bitmask with the same layout as CPENABLE, a bit per co-processor. + Indicates whether callee-saved state is saved in the state save area. + Callee-saved state is saved by itself on a solicited context switch, + and restored when needed by the coprocessor exception handler. + Unsolicited switches will cause the entire coprocessor to be saved + when necessary. + + XT_CP_ASA + Pointer to the aligned save area. Allows it to be aligned more than + the overall save area (which might only be stack-aligned or TCB-aligned). + Especially relevant for Xtensa cores configured with a very large data + path that requires alignment greater than 16 bytes (ABI stack alignment). +------------------------------------------------------------------------------- +*/ + +#if XCHAL_CP_NUM > 0 + +/* Offsets of each coprocessor save area within the 'aligned save area': */ +#define XT_CP0_SA 0 +#define XT_CP1_SA ALIGNUP(XCHAL_CP1_SA_ALIGN, XT_CP0_SA + XCHAL_CP0_SA_SIZE) +#define XT_CP2_SA ALIGNUP(XCHAL_CP2_SA_ALIGN, XT_CP1_SA + XCHAL_CP1_SA_SIZE) +#define XT_CP3_SA ALIGNUP(XCHAL_CP3_SA_ALIGN, XT_CP2_SA + XCHAL_CP2_SA_SIZE) +#define XT_CP4_SA ALIGNUP(XCHAL_CP4_SA_ALIGN, XT_CP3_SA + XCHAL_CP3_SA_SIZE) +#define XT_CP5_SA ALIGNUP(XCHAL_CP5_SA_ALIGN, XT_CP4_SA + XCHAL_CP4_SA_SIZE) +#define XT_CP6_SA ALIGNUP(XCHAL_CP6_SA_ALIGN, XT_CP5_SA + XCHAL_CP5_SA_SIZE) +#define XT_CP7_SA ALIGNUP(XCHAL_CP7_SA_ALIGN, XT_CP6_SA + XCHAL_CP6_SA_SIZE) +#define XT_CP_SA_SIZE ALIGNUP(16, XT_CP7_SA + XCHAL_CP7_SA_SIZE) + +/* Offsets within the overall save area: */ +#define XT_CPENABLE 0 /* (2 bytes) coprocessors active for this thread */ +#define XT_CPSTORED 2 /* (2 bytes) coprocessors saved for this thread */ +#define XT_CP_CS_ST 4 /* (2 bytes) coprocessor callee-saved regs stored for this thread */ +#define XT_CP_ASA 8 /* (4 bytes) ptr to aligned save area */ +/* Overall size allows for dynamic alignment: */ +#define XT_CP_SIZE (12 + XT_CP_SA_SIZE + XCHAL_TOTAL_SA_ALIGN) +#else +#define XT_CP_SIZE 0 +#endif + + +/* + Macro to get the current core ID. Only uses the reg given as an argument. + Reading PRID on the ESP108 architecture gives us 0xCDCD on the PRO processor + and 0xABAB on the APP CPU. We distinguish between the two by simply checking + bit 1: it's 1 on the APP and 0 on the PRO processor. +*/ + +#ifdef __ASSEMBLER__ + .macro getcoreid reg + rsr.prid \reg + bbci \reg,1,1f + movi \reg,1 + j 2f +1: + movi \reg,0 +2: + .endm +#endif + + + +/* +------------------------------------------------------------------------------- + MACROS TO HANDLE ABI SPECIFICS OF FUNCTION ENTRY AND RETURN + + Convenient where the frame size requirements are the same for both ABIs. + ENTRY(sz), RET(sz) are for framed functions (have locals or make calls). + ENTRY0, RET0 are for frameless functions (no locals, no calls). + + where size = size of stack frame in bytes (must be >0 and aligned to 16). + For framed functions the frame is created and the return address saved at + base of frame (Call0 ABI) or as determined by hardware (Windowed ABI). + For frameless functions, there is no frame and return address remains in a0. + Note: Because CPP macros expand to a single line, macros requiring multi-line + expansions are implemented as assembler macros. +------------------------------------------------------------------------------- +*/ + +#ifdef __ASSEMBLER__ +#ifdef __XTENSA_CALL0_ABI__ + /* Call0 */ + #define ENTRY(sz) entry1 sz + .macro entry1 size=0x10 + addi sp, sp, -\size + s32i a0, sp, 0 + .endm + #define ENTRY0 + #define RET(sz) ret1 sz + .macro ret1 size=0x10 + l32i a0, sp, 0 + addi sp, sp, \size + ret + .endm + #define RET0 ret +#else + /* Windowed */ + #define ENTRY(sz) entry sp, sz + #define ENTRY0 entry sp, 0x10 + #define RET(sz) retw + #define RET0 retw +#endif +#endif + + + + + +#endif /* XTENSA_CONTEXT_H */ + diff --git a/components/freertos/include/freertos/xtensa_rtos.h b/components/freertos/include/freertos/xtensa_rtos.h new file mode 100644 index 000000000..980cc92e0 --- /dev/null +++ b/components/freertos/include/freertos/xtensa_rtos.h @@ -0,0 +1,233 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + RTOS-SPECIFIC INFORMATION FOR XTENSA RTOS ASSEMBLER SOURCES + (FreeRTOS Port) + +This header is the primary glue between generic Xtensa RTOS support +sources and a specific RTOS port for Xtensa. It contains definitions +and macros for use primarily by Xtensa assembly coded source files. + +Macros in this header map callouts from generic Xtensa files to specific +RTOS functions. It may also be included in C source files. + +Xtensa RTOS ports support all RTOS-compatible configurations of the Xtensa +architecture, using the Xtensa hardware abstraction layer (HAL) to deal +with configuration specifics. + +Should be included by all Xtensa generic and RTOS port-specific sources. + +*******************************************************************************/ + +#ifndef XTENSA_RTOS_H +#define XTENSA_RTOS_H + +#ifdef __ASSEMBLER__ +#include +#else +#include +#endif + +#include +#include +#include + +/* +Include any RTOS specific definitions that are needed by this header. +*/ +#include + +/* +Convert FreeRTOSConfig definitions to XTENSA definitions. +However these can still be overridden from the command line. +*/ + +#ifndef XT_SIMULATOR + #if configXT_SIMULATOR + #define XT_SIMULATOR 1 /* Simulator mode */ + #endif +#endif + +#ifndef XT_BOARD + #if configXT_BOARD + #define XT_BOARD 1 /* Board mode */ + #endif +#endif + +#ifndef XT_TIMER_INDEX + #if defined configXT_TIMER_INDEX + #define XT_TIMER_INDEX configXT_TIMER_INDEX /* Index of hardware timer to be used */ + #endif +#endif + +#ifndef XT_INTEXC_HOOKS + #if configXT_INTEXC_HOOKS + #define XT_INTEXC_HOOKS 1 /* Enables exception hooks */ + #endif +#endif + +#if !defined(XT_SIMULATOR) && !defined(XT_BOARD) + #error Either XT_SIMULATOR or XT_BOARD must be defined. +#endif + + +/* +Name of RTOS (for messages). +*/ +#define XT_RTOS_NAME FreeRTOS + +/* +Check some Xtensa configuration requirements and report error if not met. +Error messages can be customize to the RTOS port. +*/ + +#if !XCHAL_HAVE_XEA2 +#error "FreeRTOS/Xtensa requires XEA2 (exception architecture 2)." +#endif + + +/******************************************************************************* + +RTOS CALLOUT MACROS MAPPED TO RTOS PORT-SPECIFIC FUNCTIONS. + +Define callout macros used in generic Xtensa code to interact with the RTOS. +The macros are simply the function names for use in calls from assembler code. +Some of these functions may call back to generic functions in xtensa_context.h . + +*******************************************************************************/ + +/* +Inform RTOS of entry into an interrupt handler that will affect it. +Allows RTOS to manage switch to any system stack and count nesting level. +Called after minimal context has been saved, with interrupts disabled. +RTOS port can call0 _xt_context_save to save the rest of the context. +May only be called from assembly code by the 'call0' instruction. +*/ +// void XT_RTOS_INT_ENTER(void) +#define XT_RTOS_INT_ENTER _frxt_int_enter + +/* +Inform RTOS of completion of an interrupt handler, and give control to +RTOS to perform thread/task scheduling, switch back from any system stack +and restore the context, and return to the exit dispatcher saved in the +stack frame at XT_STK_EXIT. RTOS port can call0 _xt_context_restore +to save the context saved in XT_RTOS_INT_ENTER via _xt_context_save, +leaving only a minimal part of the context to be restored by the exit +dispatcher. This function does not return to the place it was called from. +May only be called from assembly code by the 'call0' instruction. +*/ +// void XT_RTOS_INT_EXIT(void) +#define XT_RTOS_INT_EXIT _frxt_int_exit + +/* +Inform RTOS of the occurrence of a tick timer interrupt. +If RTOS has no tick timer, leave XT_RTOS_TIMER_INT undefined. +May be coded in or called from C or assembly, per ABI conventions. +RTOS may optionally define XT_TICK_PER_SEC in its own way (eg. macro). +*/ +// void XT_RTOS_TIMER_INT(void) +#define XT_RTOS_TIMER_INT _frxt_timer_int +#define XT_TICK_PER_SEC configTICK_RATE_HZ + +/* +Return in a15 the base address of the co-processor state save area for the +thread that triggered a co-processor exception, or 0 if no thread was running. +The state save area is structured as defined in xtensa_context.h and has size +XT_CP_SIZE. Co-processor instructions should only be used in thread code, never +in interrupt handlers or the RTOS kernel. May only be called from assembly code +and by the 'call0' instruction. A result of 0 indicates an unrecoverable error. +The implementation may use only a2-4, a15 (all other regs must be preserved). +*/ +// void* XT_RTOS_CP_STATE(void) +#define XT_RTOS_CP_STATE _frxt_task_coproc_state + + +/******************************************************************************* + +HOOKS TO DYNAMICALLY INSTALL INTERRUPT AND EXCEPTION HANDLERS PER LEVEL. + +This Xtensa RTOS port provides hooks for dynamically installing exception +and interrupt handlers to facilitate automated testing where each test +case can install its own handler for user exceptions and each interrupt +priority (level). This consists of an array of function pointers indexed +by interrupt priority, with index 0 being the user exception handler hook. +Each entry in the array is initially 0, and may be replaced by a function +pointer of type XT_INTEXC_HOOK. A handler may be uninstalled by installing 0. + +The handler for low and medium priority obeys ABI conventions so may be coded +in C. For the exception handler, the cause is the contents of the EXCCAUSE +reg, and the result is -1 if handled, else the cause (still needs handling). +For interrupt handlers, the cause is a mask of pending enabled interrupts at +that level, and the result is the same mask with the bits for the handled +interrupts cleared (those not cleared still need handling). This allows a test +case to either pre-handle or override the default handling for the exception +or interrupt level (see xtensa_vectors.S). + +High priority handlers (including NMI) must be coded in assembly, are always +called by 'call0' regardless of ABI, must preserve all registers except a0, +and must not use or modify the interrupted stack. The hook argument 'cause' +is not passed and the result is ignored, so as not to burden the caller with +saving and restoring a2 (it assumes only one interrupt per level - see the +discussion in high priority interrupts in xtensa_vectors.S). The handler +therefore should be coded to prototype 'void h(void)' even though it plugs +into an array of handlers of prototype 'unsigned h(unsigned)'. + +To enable interrupt/exception hooks, compile the RTOS with '-DXT_INTEXC_HOOKS'. + +*******************************************************************************/ + +#define XT_INTEXC_HOOK_NUM (1 + XCHAL_NUM_INTLEVELS + XCHAL_HAVE_NMI) + +#ifndef __ASSEMBLER__ +typedef unsigned (*XT_INTEXC_HOOK)(unsigned cause); +extern volatile XT_INTEXC_HOOK _xt_intexc_hooks[XT_INTEXC_HOOK_NUM]; +#endif + + +/******************************************************************************* + +CONVENIENCE INCLUSIONS. + +Ensures RTOS specific files need only include this one Xtensa-generic header. +These headers are included last so they can use the RTOS definitions above. + +*******************************************************************************/ + +#include "xtensa_context.h" + +#ifdef XT_RTOS_TIMER_INT +#include "xtensa_timer.h" +#endif + + +/******************************************************************************* + +Xtensa Port Version. + +*******************************************************************************/ + +#define XTENSA_PORT_VERSION 1.4.2 +#define XTENSA_PORT_VERSION_STRING "1.4.2" + +#endif /* XTENSA_RTOS_H */ + diff --git a/components/freertos/include/freertos/xtensa_timer.h b/components/freertos/include/freertos/xtensa_timer.h new file mode 100644 index 000000000..9bb8648f6 --- /dev/null +++ b/components/freertos/include/freertos/xtensa_timer.h @@ -0,0 +1,159 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA INFORMATION FOR RTOS TICK TIMER AND CLOCK FREQUENCY + +This header contains definitions and macros for use primarily by Xtensa +RTOS assembly coded source files. It includes and uses the Xtensa hardware +abstraction layer (HAL) to deal with config specifics. It may also be +included in C source files. + +User may edit to modify timer selection and to specify clock frequency and +tick duration to match timer interrupt to the real-time tick duration. + +If the RTOS has no timer interrupt, then there is no tick timer and the +clock frequency is irrelevant, so all of these macros are left undefined +and the Xtensa core configuration need not have a timer. + +*******************************************************************************/ + +#ifndef XTENSA_TIMER_H +#define XTENSA_TIMER_H + +#ifdef __ASSEMBLER__ +#include +#endif + +#include +#include + +#include "xtensa_rtos.h" /* in case this wasn't included directly */ + +#include + +/* +Select timer to use for periodic tick, and determine its interrupt number +and priority. User may specify a timer by defining XT_TIMER_INDEX with -D, +in which case its validity is checked (it must exist in this core and must +not be on a high priority interrupt - an error will be reported in invalid). +Otherwise select the first low or medium priority interrupt timer available. +*/ +#if XCHAL_NUM_TIMERS == 0 + + #error "This Xtensa configuration is unsupported, it has no timers." + +#else + +#ifndef XT_TIMER_INDEX + #if XCHAL_TIMER3_INTERRUPT != XTHAL_TIMER_UNCONFIGURED + #if XCHAL_INT_LEVEL(XCHAL_TIMER3_INTERRUPT) <= XCHAL_EXCM_LEVEL + #undef XT_TIMER_INDEX + #define XT_TIMER_INDEX 3 + #endif + #endif + #if XCHAL_TIMER2_INTERRUPT != XTHAL_TIMER_UNCONFIGURED + #if XCHAL_INT_LEVEL(XCHAL_TIMER2_INTERRUPT) <= XCHAL_EXCM_LEVEL + #undef XT_TIMER_INDEX + #define XT_TIMER_INDEX 2 + #endif + #endif + #if XCHAL_TIMER1_INTERRUPT != XTHAL_TIMER_UNCONFIGURED + #if XCHAL_INT_LEVEL(XCHAL_TIMER1_INTERRUPT) <= XCHAL_EXCM_LEVEL + #undef XT_TIMER_INDEX + #define XT_TIMER_INDEX 1 + #endif + #endif + #if XCHAL_TIMER0_INTERRUPT != XTHAL_TIMER_UNCONFIGURED + #if XCHAL_INT_LEVEL(XCHAL_TIMER0_INTERRUPT) <= XCHAL_EXCM_LEVEL + #undef XT_TIMER_INDEX + #define XT_TIMER_INDEX 0 + #endif + #endif +#endif +#ifndef XT_TIMER_INDEX + #error "There is no suitable timer in this Xtensa configuration." +#endif + +#define XT_CCOMPARE (CCOMPARE + XT_TIMER_INDEX) +#define XT_TIMER_INTNUM XCHAL_TIMER_INTERRUPT(XT_TIMER_INDEX) +#define XT_TIMER_INTPRI XCHAL_INT_LEVEL(XT_TIMER_INTNUM) +#define XT_TIMER_INTEN (1 << XT_TIMER_INTNUM) + +#if XT_TIMER_INTNUM == XTHAL_TIMER_UNCONFIGURED + #error "The timer selected by XT_TIMER_INDEX does not exist in this core." +#elif XT_TIMER_INTPRI > XCHAL_EXCM_LEVEL + #error "The timer interrupt cannot be high priority (use medium or low)." +#endif + +#endif /* XCHAL_NUM_TIMERS */ + +/* +Set processor clock frequency, used to determine clock divisor for timer tick. +User should BE SURE TO ADJUST THIS for the Xtensa platform being used. +If using a supported board via the board-independent API defined in xtbsp.h, +this may be left undefined and frequency and tick divisor will be computed +and cached during run-time initialization. + +NOTE ON SIMULATOR: +Under the Xtensa instruction set simulator, the frequency can only be estimated +because it depends on the speed of the host and the version of the simulator. +Also because it runs much slower than hardware, it is not possible to achieve +real-time performance for most applications under the simulator. A frequency +too low does not allow enough time between timer interrupts, starving threads. +To obtain a more convenient but non-real-time tick duration on the simulator, +compile with xt-xcc option "-DXT_SIMULATOR". +Adjust this frequency to taste (it's not real-time anyway!). +*/ +#if defined(XT_SIMULATOR) && !defined(XT_CLOCK_FREQ) +#define XT_CLOCK_FREQ configCPU_CLOCK_HZ +#endif + +#if !defined(XT_CLOCK_FREQ) && !defined(XT_BOARD) + #error "XT_CLOCK_FREQ must be defined for the target platform." +#endif + +/* +Default number of timer "ticks" per second (default 100 for 10ms tick). +RTOS may define this in its own way (if applicable) in xtensa_rtos.h. +User may redefine this to an optimal value for the application, either by +editing this here or in xtensa_rtos.h, or compiling with xt-xcc option +"-DXT_TICK_PER_SEC=" where is a suitable number. +*/ +#ifndef XT_TICK_PER_SEC +#define XT_TICK_PER_SEC configTICK_RATE_HZ /* 10 ms tick = 100 ticks per second */ +#endif + +/* +Derivation of clock divisor for timer tick and interrupt (one per tick). +*/ +#ifdef XT_CLOCK_FREQ +#define XT_TICK_DIVISOR (XT_CLOCK_FREQ / XT_TICK_PER_SEC) +#endif + +#ifndef __ASSEMBLER__ +extern unsigned _xt_tick_divisor; +extern void _xt_tick_divisor_init(void); +#endif + +#endif /* XTENSA_TIMER_H */ + diff --git a/components/freertos/license.txt b/components/freertos/license.txt new file mode 100644 index 000000000..e48ed809d --- /dev/null +++ b/components/freertos/license.txt @@ -0,0 +1,440 @@ +The FreeRTOS.org source code is licensed by the *modified* GNU General Public +License (GPL), text provided below. A special exception to the GPL is +included to allow you to distribute a combined work that includes FreeRTOS +without being obliged to provide the source code for any proprietary +components. See the licensing section of http://www.FreeRTOS.org for full +details. The exception text is also included at the bottom of this file. + +The FreeRTOS download also includes demo application source code, some of +which is provided by third parties AND IS LICENSED SEPARATELY FROM FREERTOS. + +For the avoidance of any doubt refer to the comment included at the top +of each source and header file for license and copyright information. + +This is a list of files for which Real Time Engineers Ltd are not the +copyright owner and are NOT COVERED BY THE GPL. + + +1) Various header files provided by silicon manufacturers and tool vendors + that define processor specific memory addresses and utility macros. + Permission has been granted by the various copyright holders for these + files to be included in the FreeRTOS download. Users must ensure license + conditions are adhered to for any use other than compilation of the + FreeRTOS demo applications. + +2) The uIP TCP/IP stack the copyright of which is held by Adam Dunkels. + Users must ensure the open source license conditions stated at the top + of each uIP source file is understood and adhered to. + +3) The lwIP TCP/IP stack the copyright of which is held by the Swedish + Institute of Computer Science. Users must ensure the open source license + conditions stated at the top of each lwIP source file is understood and + adhered to. + +4) Various peripheral driver source files and binaries provided by silicon + manufacturers and tool vendors. Permission has been granted by the + various copyright holders for these files to be included in the FreeRTOS + download. Users must ensure license conditions are adhered to for any + use other than compilation of the FreeRTOS demo applications. + +5) The files contained within FreeRTOS\Demo\WizNET_DEMO_TERN_186\tern_code, + which are slightly modified versions of code provided by and copyright to + Tern Inc. + +Errors and omissions should be reported to Richard Barry, contact details for +whom can be obtained from http://www.FreeRTOS.org. + + + + + +The GPL license text follows. + +A special exception to the GPL is included to allow you to distribute a +combined work that includes FreeRTOS without being obliged to provide +the source code for any proprietary components. See the licensing section +of http://www.FreeRTOS.org for full details. The exception text is also +included at the bottom of this file. + +-------------------------------------------------------------------- + + + + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License** as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. + +---------------------------------------------------------------------------- + +The FreeRTOS GPL Exception Text: + +Any FreeRTOS source code, whether modified or in it's original release form, +or whether in whole or in part, can only be distributed by you under the terms +of the GNU General Public License plus this exception. An independent module is +a module which is not derived from or based on FreeRTOS. + +Clause 1: + +Linking FreeRTOS statically or dynamically with other modules is making a +combined work based on FreeRTOS. Thus, the terms and conditions of the GNU +General Public License cover the whole combination. + +As a special exception, the copyright holder of FreeRTOS gives you permission +to link FreeRTOS with independent modules that communicate with FreeRTOS +solely through the FreeRTOS API interface, regardless of the license terms of +these independent modules, and to copy and distribute the resulting combined +work under terms of your choice, provided that + + + Every copy of the combined work is accompanied by a written statement that + details to the recipient the version of FreeRTOS used and an offer by yourself + to provide the FreeRTOS source code (including any modifications you may have + made) should the recipient request it. + + + The combined work is not itself an RTOS, scheduler, kernel or related product. + + + The independent modules add significant and primary functionality to FreeRTOS + and do not merely extend the existing functionality already present in FreeRTOS. + +Clause 2: + +FreeRTOS may not be used for any competitive or comparative purpose, including the +publication of any form of run time or compile time metric, without the express +permission of Real Time Engineers Ltd. (this is the norm within the industry and +is intended to ensure information accuracy). diff --git a/components/freertos/list.c b/components/freertos/list.c new file mode 100644 index 000000000..03649295c --- /dev/null +++ b/components/freertos/list.c @@ -0,0 +1,233 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#include +#include "FreeRTOS.h" +#include "list.h" + +/*----------------------------------------------------------- + * PUBLIC LIST API documented in list.h + *----------------------------------------------------------*/ + +void vListInitialise( List_t * const pxList ) +{ + /* The list structure contains a list item which is used to mark the + end of the list. To initialise the list the list end is inserted + as the only list entry. */ + pxList->pxIndex = ( ListItem_t * ) &( pxList->xListEnd ); /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + + /* The list end value is the highest possible value in the list to + ensure it remains at the end of the list. */ + pxList->xListEnd.xItemValue = portMAX_DELAY; + + /* The list end next and previous pointers point to itself so we know + when the list is empty. */ + pxList->xListEnd.pxNext = ( ListItem_t * ) &( pxList->xListEnd ); /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + pxList->xListEnd.pxPrevious = ( ListItem_t * ) &( pxList->xListEnd );/*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + + pxList->uxNumberOfItems = ( UBaseType_t ) 0U; + + /* Write known values into the list if + configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList ); + listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList ); +} +/*-----------------------------------------------------------*/ + +void vListInitialiseItem( ListItem_t * const pxItem ) +{ + /* Make sure the list item is not recorded as being on a list. */ + pxItem->pvContainer = NULL; + + /* Write known values into the list item if + configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ); + listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ); +} +/*-----------------------------------------------------------*/ + +void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem ) +{ +ListItem_t * const pxIndex = pxList->pxIndex; + + /* Only effective when configASSERT() is also defined, these tests may catch + the list data structures being overwritten in memory. They will not catch + data errors caused by incorrect configuration or use of FreeRTOS. */ + listTEST_LIST_INTEGRITY( pxList ); + listTEST_LIST_ITEM_INTEGRITY( pxNewListItem ); + + /* Insert a new list item into pxList, but rather than sort the list, + makes the new list item the last item to be removed by a call to + listGET_OWNER_OF_NEXT_ENTRY(). */ + pxNewListItem->pxNext = pxIndex; + pxNewListItem->pxPrevious = pxIndex->pxPrevious; + pxIndex->pxPrevious->pxNext = pxNewListItem; + pxIndex->pxPrevious = pxNewListItem; + + /* Remember which list the item is in. */ + pxNewListItem->pvContainer = ( void * ) pxList; + + ( pxList->uxNumberOfItems )++; +} +/*-----------------------------------------------------------*/ + +void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem ) +{ +ListItem_t *pxIterator; +const TickType_t xValueOfInsertion = pxNewListItem->xItemValue; + + /* Only effective when configASSERT() is also defined, these tests may catch + the list data structures being overwritten in memory. They will not catch + data errors caused by incorrect configuration or use of FreeRTOS. */ + listTEST_LIST_INTEGRITY( pxList ); + listTEST_LIST_ITEM_INTEGRITY( pxNewListItem ); + + /* Insert the new list item into the list, sorted in xItemValue order. + + If the list already contains a list item with the same item value then the + new list item should be placed after it. This ensures that TCB's which are + stored in ready lists (all of which have the same xItemValue value) get a + share of the CPU. However, if the xItemValue is the same as the back marker + the iteration loop below will not end. Therefore the value is checked + first, and the algorithm slightly modified if necessary. */ + if( xValueOfInsertion == portMAX_DELAY ) + { + pxIterator = pxList->xListEnd.pxPrevious; + } + else + { + /* *** NOTE *********************************************************** + If you find your application is crashing here then likely causes are + listed below. In addition see http://www.freertos.org/FAQHelp.html for + more tips, and ensure configASSERT() is defined! + http://www.freertos.org/a00110.html#configASSERT + + 1) Stack overflow - + see http://www.freertos.org/Stacks-and-stack-overflow-checking.html + 2) Incorrect interrupt priority assignment, especially on Cortex-M + parts where numerically high priority values denote low actual + interrupt priorities, which can seem counter intuitive. See + http://www.freertos.org/RTOS-Cortex-M3-M4.html and the definition + of configMAX_SYSCALL_INTERRUPT_PRIORITY on + http://www.freertos.org/a00110.html + 3) Calling an API function from within a critical section or when + the scheduler is suspended, or calling an API function that does + not end in "FromISR" from an interrupt. + 4) Using a queue or semaphore before it has been initialised or + before the scheduler has been started (are interrupts firing + before vTaskStartScheduler() has been called?). + **********************************************************************/ + + for( pxIterator = ( ListItem_t * ) &( pxList->xListEnd ); pxIterator->pxNext->xItemValue <= xValueOfInsertion; pxIterator = pxIterator->pxNext ) /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + { + /* There is nothing to do here, just iterating to the wanted + insertion position. */ + } + } + + pxNewListItem->pxNext = pxIterator->pxNext; + pxNewListItem->pxNext->pxPrevious = pxNewListItem; + pxNewListItem->pxPrevious = pxIterator; + pxIterator->pxNext = pxNewListItem; + + /* Remember which list the item is in. This allows fast removal of the + item later. */ + pxNewListItem->pvContainer = ( void * ) pxList; + + ( pxList->uxNumberOfItems )++; +} +/*-----------------------------------------------------------*/ + +UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove ) +{ +/* The list item knows which list it is in. Obtain the list from the list +item. */ +List_t * const pxList = ( List_t * ) pxItemToRemove->pvContainer; + + pxItemToRemove->pxNext->pxPrevious = pxItemToRemove->pxPrevious; + pxItemToRemove->pxPrevious->pxNext = pxItemToRemove->pxNext; + + /* Make sure the index is left pointing to a valid item. */ + if( pxList->pxIndex == pxItemToRemove ) + { + pxList->pxIndex = pxItemToRemove->pxPrevious; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + pxItemToRemove->pvContainer = NULL; + ( pxList->uxNumberOfItems )--; + + return pxList->uxNumberOfItems; +} +/*-----------------------------------------------------------*/ + diff --git a/components/freertos/panic.c b/components/freertos/panic.c new file mode 100644 index 000000000..4711e9efe --- /dev/null +++ b/components/freertos/panic.c @@ -0,0 +1,211 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include + +#include + +#include "rom/rtc.h" + +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "freertos/xtensa_api.h" + +#include "soc/uart_register.h" +#include "soc/io_mux_reg.h" +#include "soc/dport_reg.h" +#include "soc/rtc_cntl_reg.h" + +#include "gdbstub.h" + +/* +Panic handlers; these get called when an unhandled exception occurs or the assembly-level +task switching / interrupt code runs into an unrecoverable error. The default task stack +overflow handler also is in here. +*/ + +#if !CONFIG_FREERTOS_PANIC_SILENT_REBOOT +//os_printf may be broken, so we fix our own printing fns... +inline static void panicPutchar(char c) { + while (((READ_PERI_REG(UART_STATUS_REG(0))>>UART_TXFIFO_CNT_S)&UART_TXFIFO_CNT)>=126) ; + WRITE_PERI_REG(UART_FIFO_REG(0), c); +} + +inline static void panicPutStr(const char *c) { + int x=0; + while (c[x]!=0) { + panicPutchar(c[x]); + x++; + } +} + +inline static void panicPutHex(int a) { + int x; + int c; + panicPutchar(' '); + for (x=0; x<8; x++) { + c=(a>>28)&0xf; + if (c<10) panicPutchar('0'+c); else panicPutchar('a'+c-10); + a<<=4; + } +} + +inline static void panicPutDec(int a) { + int n1, n2; + n1=a%10; + n2=a/10; + panicPutchar(' '); + if (n2==0) panicPutchar(' '); else panicPutchar(n2+'0'); + panicPutchar(n1+'0'); +} +#else +//No printing wanted. Stub out these functions. +inline static void panicPutchar(char c) { } +inline static void panicPutStr(const char *c) { } +inline static void panicPutHex(int a) { } +inline static void panicPutDec(int a) { } +#endif + +int xPortGetCoreID(); + +void __attribute__((weak)) vApplicationStackOverflowHook( TaskHandle_t xTask, signed char *pcTaskName ) { + panicPutStr("***ERROR*** A stack overflow in task"); + panicPutStr((char*)pcTaskName); + panicPutStr("has been detected.\n"); +} + +static const char *edesc[]={ + "IllegalInstruction", "Syscall", "InstructionFetchError", "LoadStoreError", + "Level1Interrupt", "Alloca", "IntegerDivideByZero", "PCValue", + "Privileged", "LoadStoreAlignment", "res", "res", + "InstrPDAddrError", "LoadStorePIFDataError", "InstrPIFAddrError", "LoadStorePIFAddrError", + "InstTLBMiss", "InstTLBMultiHit", "InstFetchPrivilege", "res", + "InstrFetchProhibited", "res", "res", "res", + "LoadStoreTLBMiss", "LoadStoreTLBMultihit", "LoadStorePrivilege", "res", + "LoadProhibited", "StoreProhibited", "res", "res", + "Cp0Dis", "Cp1Dis", "Cp2Dis", "Cp3Dis", + "Cp4Dis", "Cp5Dis", "Cp6Dis", "Cp7Dis" + }; + + +void commonErrorHandler(XtExcFrame *frame); + +//The fact that we've panic'ed probably means the other CPU is now running wild, possibly +//messing up the serial output, so we kill it here. +static void haltOtherCore() { + if (xPortGetCoreID()==0) { + //Kill app cpu + CLEAR_PERI_REG_MASK(RTC_OPTIONS0, RTC_CNTL_SW_STALL_APPCPU_C1<>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- +*/ + +#include +#include + +#include "xtensa_rtos.h" + +#include "rom/ets_sys.h" + +#include "FreeRTOS.h" +#include "task.h" + +/* Defined in portasm.h */ +extern void _frxt_tick_timer_init(void); + +/* Defined in xtensa_context.S */ +extern void _xt_coproc_init(void); + + +/*-----------------------------------------------------------*/ + +unsigned port_xSchedulerRunning[portNUM_PROCESSORS] = {0}; // Duplicate of inaccessible xSchedulerRunning; needed at startup to avoid counting nesting +unsigned port_interruptNesting[portNUM_PROCESSORS] = {0}; // Interrupt nesting level + +/*-----------------------------------------------------------*/ + +// User exception dispatcher when exiting +void _xt_user_exit(void); + +/* + * Stack initialization + */ +#if portUSING_MPU_WRAPPERS +StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters, BaseType_t xRunPrivileged ) +#else +StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters ) +#endif +{ + StackType_t *sp, *tp; + XtExcFrame *frame; + #if XCHAL_CP_NUM > 0 + uint32_t *p; + #endif + + /* Create interrupt stack frame aligned to 16 byte boundary */ + sp = (StackType_t *) (((UBaseType_t)(pxTopOfStack + 1) - XT_CP_SIZE - XT_STK_FRMSZ) & ~0xf); + + /* Clear the entire frame (do not use memset() because we don't depend on C library) */ + for (tp = sp; tp <= pxTopOfStack; ++tp) + *tp = 0; + + frame = (XtExcFrame *) sp; + + /* Explicitly initialize certain saved registers */ + frame->pc = (UBaseType_t) pxCode; /* task entrypoint */ + frame->a0 = 0; /* to terminate GDB backtrace */ + frame->a1 = (UBaseType_t) sp + XT_STK_FRMSZ; /* physical top of stack frame */ + frame->exit = (UBaseType_t) _xt_user_exit; /* user exception exit dispatcher */ + + /* Set initial PS to int level 0, EXCM disabled ('rfe' will enable), user mode. */ + /* Also set entry point argument parameter. */ + #ifdef __XTENSA_CALL0_ABI__ + frame->a2 = (UBaseType_t) pvParameters; + frame->ps = PS_UM | PS_EXCM; + #else + /* + for windowed ABI also set WOE and CALLINC (pretend task was 'call4'd). */ + frame->a6 = (UBaseType_t) pvParameters; + frame->ps = PS_UM | PS_EXCM | PS_WOE | PS_CALLINC(1); + #endif + + #ifdef XT_USE_SWPRI + /* Set the initial virtual priority mask value to all 1's. */ + frame->vpri = 0xFFFFFFFF; + #endif + + #if XCHAL_CP_NUM > 0 + /* Init the coprocessor save area (see xtensa_context.h) */ + /* No access to TCB here, so derive indirectly. Stack growth is top to bottom. + * //p = (uint32_t *) xMPUSettings->coproc_area; + */ + p = (uint32_t *)(((uint32_t) pxTopOfStack - XT_CP_SIZE) & ~0xf); + p[0] = 0; + p[1] = 0; + p[2] = (((uint32_t) p) + 12 + XCHAL_TOTAL_SA_ALIGN - 1) & -XCHAL_TOTAL_SA_ALIGN; + #endif + + return sp; +} + +/*-----------------------------------------------------------*/ + +void vPortEndScheduler( void ) +{ + /* It is unlikely that the Xtensa port will get stopped. If required simply + disable the tick interrupt here. */ +} + +/*-----------------------------------------------------------*/ + +BaseType_t xPortStartScheduler( void ) +{ + // Interrupts are disabled at this point and stack contains PS with enabled interrupts when task context is restored + + #if XCHAL_CP_NUM > 0 + /* Initialize co-processor management for tasks. Leave CPENABLE alone. */ + _xt_coproc_init(); + #endif + + /* Init the tick divisor value */ + _xt_tick_divisor_init(); + + /* Setup the hardware to generate the tick. */ + _frxt_tick_timer_init(); + + port_xSchedulerRunning[xPortGetCoreID()] = 1; + + // Cannot be directly called from C; never returns + __asm__ volatile ("call0 _frxt_dispatch\n"); + + /* Should not get here. */ + return pdTRUE; +} +/*-----------------------------------------------------------*/ + +BaseType_t xPortSysTickHandler( void ) +{ + BaseType_t ret; + + portbenchmarkIntLatency(); + ret = xTaskIncrementTick(); + if( ret != pdFALSE ) + { + portYIELD_FROM_ISR(); + } + + return ret; +} +/*-----------------------------------------------------------*/ + +/* + * Used to set coprocessor area in stack. Current hack is to reuse MPU pointer for coprocessor area. + */ +#if portUSING_MPU_WRAPPERS +void vPortStoreTaskMPUSettings( xMPU_SETTINGS *xMPUSettings, const struct xMEMORY_REGION * const xRegions, StackType_t *pxBottomOfStack, uint16_t usStackDepth ) +{ + #if XCHAL_CP_NUM > 0 + xMPUSettings->coproc_area = (StackType_t*)((((uint32_t)(pxBottomOfStack + usStackDepth - 1)) - XT_CP_SIZE ) & ~0xf); + + + /* NOTE: we cannot initialize the coprocessor save area here because FreeRTOS is going to + * clear the stack area after we return. This is done in pxPortInitialiseStack(). + */ + #endif +} +#endif + + + +/* + * Wrapper for the Xtensa compare-and-set instruction. This subroutine will atomically compare + * *addr to compare, and if it's the same, will set *addr to set. It will return the old value + * of *addr. + * + * Note: the NOPs are needed on the ESP31 processor but superfluous on the ESP32. + * + * Warning: From the ISA docs: in some (unspecified) cases, the s32c1i instruction may return the + * *bitwise inverse* of the old mem if the mem wasn't written. This doesn't seem to happen on the + * ESP32, though. (Would show up directly if it did because the magic wouldn't match.) + */ +uint32_t uxPortCompareSet(volatile uint32_t *mux, uint32_t compare, uint32_t set) +{ + __asm__ __volatile__ ( + "WSR %2,SCOMPARE1 \n" //initialize SCOMPARE1 + "ISYNC \n" //wait sync + "S32C1I %0, %1, 0 \n" //store id into the lock, if the lock is the same as comparel. Otherwise, no write-access + :"=r"(set) \ + :"r"(mux), "r"(compare), "0"(set) \ + ); + return set; +} + +/* + * For kernel use: Initialize a per-CPU mux. Mux will be initialized unlocked. + */ +void vPortCPUInitializeMutex(portMUX_TYPE *mux) { +#ifdef portMUX_DEBUG + ets_printf("Initializing mux %p\n", mux); + mux->lastLockedFn="(never locked)"; + mux->lastLockedLine=-1; +#endif + mux->mux=portMUX_FREE_VAL; +} + + +/* + * For kernel use: Acquire a per-CPU mux. Spinlocks, so don't hold on to these muxes for too long. + */ +#ifdef portMUX_DEBUG +void vPortCPUAcquireMutex(portMUX_TYPE *mux, const char *fnName, int line) { +#else +void vPortCPUAcquireMutex(portMUX_TYPE *mux) { +#endif + uint32_t res; + uint32_t recCnt; + unsigned int irqStatus; +#ifdef portMUX_DEBUG + uint32_t cnt=(1<<16); + if ( (mux->mux & portMUX_MAGIC_MASK) != portMUX_MAGIC_VAL ) { + ets_printf("ERROR: vPortCPUAcquireMutex: mux %p is uninitialized (0x%X)!\n", mux, mux->mux); + mux->mux=portMUX_FREE_VAL; + } +#endif + + irqStatus=portENTER_CRITICAL_NESTED(); + do { + //Lock mux if it's currently unlocked + res=uxPortCompareSet(&mux->mux, portMUX_FREE_VAL, (xPortGetCoreID()<>portMUX_VAL_SHIFT) == xPortGetCoreID()) ) { + //Mux was already locked by us. Just bump the recurse count by one. + recCnt=(res&portMUX_CNT_MASK)>>portMUX_CNT_SHIFT; + recCnt++; +#ifdef portMUX_DEBUG_RECURSIVE + ets_printf("Recursive lock: recCnt=%d last non-recursive lock %s line %d, curr %s line %d\n", recCnt, mux->lastLockedFn, mux->lastLockedLine, fnName, line); +#endif + mux->mux=portMUX_MAGIC_VAL|(recCnt<lastLockedFn, mux->lastLockedLine, fnName, line); + ets_printf("Mux value %X\n", mux->mux); + } +#endif + } while (res!=portMUX_FREE_VAL); +#ifdef portMUX_DEBUG + if (res==portMUX_FREE_VAL) { //initial lock + mux->lastLockedFn=fnName; + mux->lastLockedLine=line; + } +#endif + portEXIT_CRITICAL_NESTED(irqStatus); +} + +/* + * For kernel use: Release a per-CPU mux. Returns true if everything is OK, false if mux + * was already unlocked or is locked by a different core. + */ +#ifdef portMUX_DEBUG +portBASE_TYPE vPortCPUReleaseMutex(portMUX_TYPE *mux, const char *fnName, int line) { +#else +portBASE_TYPE vPortCPUReleaseMutex(portMUX_TYPE *mux) { +#endif + uint32_t res=0; + uint32_t recCnt; + unsigned int irqStatus; + portBASE_TYPE ret=pdTRUE; +// ets_printf("Unlock %p\n", mux); + irqStatus=portENTER_CRITICAL_NESTED(); +#ifdef portMUX_DEBUG + const char *lastLockedFn=mux->lastLockedFn; + int lastLockedLine=mux->lastLockedLine; + mux->lastLockedFn=fnName; + mux->lastLockedLine=line; + if ( (mux->mux & portMUX_MAGIC_MASK) != portMUX_MAGIC_VAL ) ets_printf("ERROR: vPortCPUReleaseMutex: mux %p is uninitialized (0x%X)!\n", mux, mux->mux); +#endif + //Unlock mux if it's currently locked with a recurse count of 0 + res=uxPortCompareSet(&mux->mux, (xPortGetCoreID()<>portMUX_VAL_SHIFT) != xPortGetCoreID() ) { +#ifdef portMUX_DEBUG + ets_printf("ERROR: vPortCPUReleaseMutex: mux %p wasn't locked by this core (%d) but by core %d (ret=%x, mux=%x).\n", mux, xPortGetCoreID(), ((res&portMUX_VAL_MASK)>>portMUX_VAL_SHIFT), res, mux->mux); + ets_printf("Last non-recursive lock %s line %d\n", lastLockedFn, lastLockedLine); + ets_printf("Called by %s line %d\n", fnName, line); +#endif + ret=pdFALSE; + } else if ( ((res&portMUX_CNT_MASK)>>portMUX_CNT_SHIFT)!=0) { + //We locked this, but the reccount isn't zero. Decrease refcount and continue. + recCnt=(res&portMUX_CNT_MASK)>>portMUX_CNT_SHIFT; + recCnt--; +#ifdef portMUX_DEBUG_RECURSIVE + ets_printf("Recursive unlock: recCnt=%d last locked %s line %d, curr %s line %d\n", recCnt, lastLockedFn, lastLockedLine, fnName, line); +#endif + mux->mux=portMUX_MAGIC_VAL|(recCnt<pxTopOfStack = SP */ + movi a1, port_IntStackTop /* a1 = top of intr stack */ + movi a2, configISR_STACK_SIZE + getcoreid a3 + mull a2, a3, a2 + add a1, a1, a2 /* for current proc */ + +.Lnested: +1: + mov a0, a12 /* restore return addr and return */ + ret + +/* +******************************************************************************* +* _frxt_int_exit +* void _frxt_int_exit(void) +* +* Implements the Xtensa RTOS porting layer's XT_RTOS_INT_EXIT function for +* FreeRTOS. If required, calls vPortYieldFromInt() to perform task context +* switching, restore the (possibly) new task's context, and return to the +* exit dispatcher saved in the task's stack frame at XT_STK_EXIT. +* May only be called from assembly code by the 'call0' instruction. Does not +* return to caller. +* See the description of the XT_RTOS_ENTER macro in xtensa_rtos.h. +* +******************************************************************************* +*/ + .globl _frxt_int_exit + .type _frxt_int_exit,@function + .align 4 +_frxt_int_exit: + + getcoreid a3 + slli a4, a3, 2 /* a4 is core * 4 */ + movi a2, port_xSchedulerRunning + add a2, a2, a4 + movi a3, port_interruptNesting + add a3, a3, a4 + rsil a0, XCHAL_EXCM_LEVEL /* lock out interrupts */ + l32i a2, a2, 0 /* a2 = port_xSchedulerRunning */ + beqz a2, .Lnoswitch /* scheduler not running, no tasks */ + l32i a2, a3, 0 /* a2 = port_interruptNesting */ + addi a2, a2, -1 /* decrement nesting count */ + s32i a2, a3, 0 /* save nesting count */ + bnez a2, .Lnesting /* !=0 after decr so still nested */ + + movi a2, pxCurrentTCB + add a2, a2, a4 + l32i a2, a2, 0 /* a2 = current TCB */ + beqz a2, 1f /* no task ? go to dispatcher */ + l32i a1, a2, TOPOFSTACK_OFFS /* SP = pxCurrentTCB->pxTopOfStack */ + + movi a2, port_switch_flag /* address of switch flag */ + add a2, a2, a4 /* point to flag for this cpu */ + l32i a3, a2, 0 /* a3 = port_switch_flag */ + beqz a3, .Lnoswitch /* flag = 0 means no switch reqd */ + movi a3, 0 + s32i a3, a2, 0 /* zero out the flag for next time */ + +1: + /* + Call0 ABI callee-saved regs a12-15 need to be saved before possible preemption. + However a12-13 were already saved by _frxt_int_enter(). + */ + #ifdef __XTENSA_CALL0_ABI__ + s32i a14, a1, XT_STK_A14 + s32i a15, a1, XT_STK_A15 + #endif + + #ifdef __XTENSA_CALL0_ABI__ + call0 vPortYieldFromInt /* call dispatch inside the function; never returns */ + #else + call4 vPortYieldFromInt /* this one returns */ + call0 _frxt_dispatch /* tail-call dispatcher */ + /* Never returns here. */ + #endif + +.Lnoswitch: + /* + If we came here then about to resume the interrupted task. + */ + +.Lnesting: + /* + We come here only if there was no context switch, that is if this + is a nested interrupt, or the interrupted task was not preempted. + In either case there's no need to load the SP. + */ + + /* Restore full context from interrupt stack frame */ + call0 _xt_context_restore + + /* + Must return via the exit dispatcher corresponding to the entrypoint from which + this was called. Interruptee's A0, A1, PS, PC are restored and the interrupt + stack frame is deallocated in the exit dispatcher. + */ + l32i a0, a1, XT_STK_EXIT + ret + + +/* +********************************************************************************************************** +* _frxt_timer_int +* void _frxt_timer_int(void) +* +* Implements the Xtensa RTOS porting layer's XT_RTOS_TIMER_INT function for FreeRTOS. +* Called every timer interrupt. +* Manages the tick timer and calls xPortSysTickHandler() every tick. +* See the detailed description of the XT_RTOS_ENTER macro in xtensa_rtos.h. +* +* Callable from C (obeys ABI conventions). Implemented in assmebly code for performance. +* +********************************************************************************************************** +*/ + .globl _frxt_timer_int + .type _frxt_timer_int,@function + .align 4 +_frxt_timer_int: + + /* + Xtensa timers work by comparing a cycle counter with a preset value. Once the match occurs + an interrupt is generated, and the handler has to set a new cycle count into the comparator. + To avoid clock drift due to interrupt latency, the new cycle count is computed from the old, + not the time the interrupt was serviced. However if a timer interrupt is ever serviced more + than one tick late, it is necessary to process multiple ticks until the new cycle count is + in the future, otherwise the next timer interrupt would not occur until after the cycle + counter had wrapped (2^32 cycles later). + + do { + ticks++; + old_ccompare = read_ccompare_i(); + write_ccompare_i( old_ccompare + divisor ); + service one tick; + diff = read_ccount() - old_ccompare; + } while ( diff > divisor ); + */ + + ENTRY(16) + +.L_xt_timer_int_catchup: + + /* Update the timer comparator for the next tick. */ + #ifdef XT_CLOCK_FREQ + movi a2, XT_TICK_DIVISOR /* a2 = comparator increment */ + #else + movi a3, _xt_tick_divisor + l32i a2, a3, 0 /* a2 = comparator increment */ + #endif + rsr a3, XT_CCOMPARE /* a3 = old comparator value */ + add a4, a3, a2 /* a4 = new comparator value */ + wsr a4, XT_CCOMPARE /* update comp. and clear interrupt */ + esync + + #ifdef __XTENSA_CALL0_ABI__ + /* Preserve a2 and a3 across C calls. */ + s32i a2, sp, 4 + s32i a3, sp, 8 + #endif + + /* Call the FreeRTOS tick handler (see port.c). */ + #ifdef __XTENSA_CALL0_ABI__ + call0 xPortSysTickHandler + #else + call4 xPortSysTickHandler + #endif + + #ifdef __XTENSA_CALL0_ABI__ + /* Restore a2 and a3. */ + l32i a2, sp, 4 + l32i a3, sp, 8 + #endif + + /* Check if we need to process more ticks to catch up. */ + esync /* ensure comparator update complete */ + rsr a4, CCOUNT /* a4 = cycle count */ + sub a4, a4, a3 /* diff = ccount - old comparator */ + blt a2, a4, .L_xt_timer_int_catchup /* repeat while diff > divisor */ + + RET(16) + + /* +********************************************************************************************************** +* _frxt_tick_timer_init +* void _frxt_tick_timer_init(void) +* +* Initialize timer and timer interrrupt handler (_xt_tick_divisor_init() has already been been called). +* Callable from C (obeys ABI conventions on entry). +* +********************************************************************************************************** +*/ + .globl _frxt_tick_timer_init + .type _frxt_tick_timer_init,@function + .align 4 +_frxt_tick_timer_init: + + ENTRY(16) + + + /* Set up the periodic tick timer (assume enough time to complete init). */ + #ifdef XT_CLOCK_FREQ + movi a3, XT_TICK_DIVISOR + #else + movi a2, _xt_tick_divisor + l32i a3, a2, 0 + #endif + rsr a2, CCOUNT /* current cycle count */ + add a2, a2, a3 /* time of first timer interrupt */ + wsr a2, XT_CCOMPARE /* set the comparator */ + + /* + Enable the timer interrupt at the device level. Don't write directly + to the INTENABLE register because it may be virtualized. + */ + #ifdef __XTENSA_CALL0_ABI__ + movi a2, XT_TIMER_INTEN + call0 xt_ints_on + #else + movi a6, XT_TIMER_INTEN + call4 xt_ints_on + #endif + + RET(16) + +/* +********************************************************************************************************** +* DISPATCH THE HIGH READY TASK +* void _frxt_dispatch(void) +* +* Switch context to the highest priority ready task, restore its state and dispatch control to it. +* +* This is a common dispatcher that acts as a shared exit path for all the context switch functions +* including vPortYield() and vPortYieldFromInt(), all of which tail-call this dispatcher +* (for windowed ABI vPortYieldFromInt() calls it indirectly via _frxt_int_exit() ). +* +* The Xtensa port uses different stack frames for solicited and unsolicited task suspension (see +* comments on stack frames in xtensa_context.h). This function restores the state accordingly. +* If restoring a task that solicited entry, restores the minimal state and leaves CPENABLE clear. +* If restoring a task that was preempted, restores all state including the task's CPENABLE. +* +* Entry: +* pxCurrentTCB points to the TCB of the task to suspend, +* Because it is tail-called without a true function entrypoint, it needs no 'entry' instruction. +* +* Exit: +* If incoming task called vPortYield() (solicited), this function returns as if from vPortYield(). +* If incoming task was preempted by an interrupt, this function jumps to exit dispatcher. +* +********************************************************************************************************** +*/ + .globl _frxt_dispatch + .type _frxt_dispatch,@function + .align 4 +_frxt_dispatch: + + #ifdef __XTENSA_CALL0_ABI__ + call0 vTaskSwitchContext // Get next TCB to resume + movi a2, pxCurrentTCB + getcoreid a3 + slli a3, a3, 2 + add a2, a2, a3 + #else + call4 vTaskSwitchContext // Get next TCB to resume + movi a2, pxCurrentTCB + getcoreid a3 + slli a3, a3, 2 + add a2, a2, a3 + #endif + l32i a3, a2, 0 + l32i sp, a3, TOPOFSTACK_OFFS /* SP = next_TCB->pxTopOfStack; */ + s32i a3, a2, 0 + + /* Determine the type of stack frame. */ + l32i a2, sp, XT_STK_EXIT /* exit dispatcher or solicited flag */ + bnez a2, .L_frxt_dispatch_stk + +.L_frxt_dispatch_sol: + + /* Solicited stack frame. Restore minimal context and return from vPortYield(). */ + l32i a3, sp, XT_SOL_PS + #ifdef __XTENSA_CALL0_ABI__ + l32i a12, sp, XT_SOL_A12 + l32i a13, sp, XT_SOL_A13 + l32i a14, sp, XT_SOL_A14 + l32i a15, sp, XT_SOL_A15 + #endif + l32i a0, sp, XT_SOL_PC + #if XCHAL_CP_NUM > 0 + /* Ensure wsr.CPENABLE is complete (should be, it was cleared on entry). */ + rsync + #endif + /* As soons as PS is restored, interrupts can happen. No need to sync PS. */ + wsr a3, PS + #ifdef __XTENSA_CALL0_ABI__ + addi sp, sp, XT_SOL_FRMSZ + ret + #else + retw + #endif + +.L_frxt_dispatch_stk: + + #if XCHAL_CP_NUM > 0 + /* Restore CPENABLE from task's co-processor save area. */ + movi a3, pxCurrentTCB /* cp_state = */ + getcoreid a2 + slli a2, a2, 2 + add a3, a2, a3 + l32i a3, a3, 0 + l32i a2, a3, CP_TOPOFSTACK_OFFS /* StackType_t *pxStack; */ + l16ui a3, a2, XT_CPENABLE /* CPENABLE = cp_state->cpenable; */ + wsr a3, CPENABLE + #endif + + /* Interrupt stack frame. Restore full context and return to exit dispatcher. */ + call0 _xt_context_restore + + /* In Call0 ABI, restore callee-saved regs (A12, A13 already restored). */ + #ifdef __XTENSA_CALL0_ABI__ + l32i a14, sp, XT_STK_A14 + l32i a15, sp, XT_STK_A15 + #endif + + #if XCHAL_CP_NUM > 0 + /* Ensure wsr.CPENABLE has completed. */ + rsync + #endif + + /* + Must return via the exit dispatcher corresponding to the entrypoint from which + this was called. Interruptee's A0, A1, PS, PC are restored and the interrupt + stack frame is deallocated in the exit dispatcher. + */ + l32i a0, sp, XT_STK_EXIT + ret + + +/* +********************************************************************************************************** +* PERFORM A SOLICTED CONTEXT SWITCH (from a task) +* void vPortYield(void) +* +* This function saves the minimal state needed for a solicited task suspension, clears CPENABLE, +* then tail-calls the dispatcher _frxt_dispatch() to perform the actual context switch +* +* At Entry: +* pxCurrentTCB points to the TCB of the task to suspend +* Callable from C (obeys ABI conventions on entry). +* +* Does not return to caller. +* +********************************************************************************************************** +*/ + .globl vPortYield + .type vPortYield,@function + .align 4 +vPortYield: + + #ifdef __XTENSA_CALL0_ABI__ + addi sp, sp, -XT_SOL_FRMSZ + #else + entry sp, XT_SOL_FRMSZ + #endif + + rsr a2, PS + s32i a0, sp, XT_SOL_PC + s32i a2, sp, XT_SOL_PS + #ifdef __XTENSA_CALL0_ABI__ + s32i a12, sp, XT_SOL_A12 /* save callee-saved registers */ + s32i a13, sp, XT_SOL_A13 + s32i a14, sp, XT_SOL_A14 + s32i a15, sp, XT_SOL_A15 + #else + /* Spill register windows. Calling xthal_window_spill() causes extra */ + /* spills and reloads, so we will set things up to call the _nw version */ + /* instead to save cycles. */ + movi a6, ~(PS_WOE_MASK|PS_INTLEVEL_MASK) /* spills a4-a7 if needed */ + and a2, a2, a6 /* clear WOE, INTLEVEL */ + addi a2, a2, XCHAL_EXCM_LEVEL /* set INTLEVEL */ + wsr a2, PS + rsync + call0 xthal_window_spill_nw + l32i a2, sp, XT_SOL_PS /* restore PS */ + wsr a2, PS + #endif + + rsil a2, XCHAL_EXCM_LEVEL /* disable low/med interrupts */ + + #if XCHAL_CP_NUM > 0 + /* Save coprocessor callee-saved state (if any). At this point CPENABLE */ + /* should still reflect which CPs were in use (enabled). */ + call0 _xt_coproc_savecs + #endif + + movi a2, pxCurrentTCB + getcoreid a3 + slli a3, a3, 2 + add a2, a2, a3 + l32i a2, a2, 0 /* a2 = pxCurrentTCB */ + movi a3, 0 + s32i a3, sp, XT_SOL_EXIT /* 0 to flag as solicited frame */ + s32i sp, a2, TOPOFSTACK_OFFS /* pxCurrentTCB->pxTopOfStack = SP */ + + #if XCHAL_CP_NUM > 0 + /* Clear CPENABLE, also in task's co-processor state save area. */ + l32i a2, a2, CP_TOPOFSTACK_OFFS /* a2 = pxCurrentTCB->cp_state */ + movi a3, 0 + wsr a3, CPENABLE + beqz a2, 1f + s16i a3, a2, XT_CPENABLE /* clear saved cpenable */ +1: + #endif + + /* Tail-call dispatcher. */ + call0 _frxt_dispatch + /* Never reaches here. */ + + +/* +********************************************************************************************************** +* PERFORM AN UNSOLICITED CONTEXT SWITCH (from an interrupt) +* void vPortYieldFromInt(void) +* +* This calls the context switch hook (removed), saves and clears CPENABLE, then tail-calls the dispatcher +* _frxt_dispatch() to perform the actual context switch. +* +* At Entry: +* Interrupted task context has been saved in an interrupt stack frame at pxCurrentTCB->pxTopOfStack. +* pxCurrentTCB points to the TCB of the task to suspend, +* Callable from C (obeys ABI conventions on entry). +* +* At Exit: +* Windowed ABI defers the actual context switch until the stack is unwound to interrupt entry. +* Call0 ABI tail-calls the dispatcher directly (no need to unwind) so does not return to caller. +* +********************************************************************************************************** +*/ + .globl vPortYieldFromInt + .type vPortYieldFromInt,@function + .align 4 +vPortYieldFromInt: + + ENTRY(16) + + #if XCHAL_CP_NUM > 0 + /* Save CPENABLE in task's co-processor save area, and clear CPENABLE. */ + movi a3, pxCurrentTCB /* cp_state = */ + getcoreid a2 + slli a2, a2, 2 + add a3, a2, a3 + l32i a3, a3, 0 + + l32i a2, a3, CP_TOPOFSTACK_OFFS + + rsr a3, CPENABLE + s16i a3, a2, XT_CPENABLE /* cp_state->cpenable = CPENABLE; */ + movi a3, 0 + wsr a3, CPENABLE /* disable all co-processors */ + #endif + + #ifdef __XTENSA_CALL0_ABI__ + /* Tail-call dispatcher. */ + call0 _frxt_dispatch + /* Never reaches here. */ + #else + RET(16) + #endif + +/* +********************************************************************************************************** +* _frxt_task_coproc_state +* void _frxt_task_coproc_state(void) +* +* Implements the Xtensa RTOS porting layer's XT_RTOS_CP_STATE function for FreeRTOS. +* +* May only be called when a task is running, not within an interrupt handler (returns 0 in that case). +* May only be called from assembly code by the 'call0' instruction. Does NOT obey ABI conventions. +* Returns in A15 a pointer to the base of the co-processor state save area for the current task. +* See the detailed description of the XT_RTOS_ENTER macro in xtensa_rtos.h. +* +********************************************************************************************************** +*/ +#if XCHAL_CP_NUM > 0 + + .globl _frxt_task_coproc_state + .type _frxt_task_coproc_state,@function + .align 4 +_frxt_task_coproc_state: + + + /* We can use a3 as a scratchpad, the instances of code calling XT_RTOS_CP_STATE don't seem to need it saved. */ + getcoreid a3 + slli a3, a3, 2 /* a3=coreid*4 */ + movi a15, port_xSchedulerRunning /* if (port_xSchedulerRunning */ + add a15, a15, a3 + l32i a15, a15, 0 + beqz a15, 1f + movi a15, port_interruptNesting /* && port_interruptNesting == 0 */ + add a15, a15, a3 + l32i a15, a15, 0 + bnez a15, 1f + + movi a15, pxCurrentTCB + add a15, a3, a15 + l32i a15, a15, 0 /* && pxCurrentTCB != 0) { */ + + + beqz a15, 2f + l32i a15, a15, CP_TOPOFSTACK_OFFS + ret + +1: movi a15, 0 +2: ret + +#endif /* XCHAL_CP_NUM > 0 */ diff --git a/components/freertos/queue.c b/components/freertos/queue.c new file mode 100644 index 000000000..337352fca --- /dev/null +++ b/components/freertos/queue.c @@ -0,0 +1,2642 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + + +/* + ToDo: The multicore implementation of this uses taskENTER_CRITICAL etc to make sure the + queue structures aren't accessed by another processor or core. It would be useful to have + IRQs be able to schedule stuff while doing task-related stuff, meaning we have to convert + the taskENTER_CRITICAL stuff to a lock + a scheduler suspend instead. +*/ + +#include +#include + +#include "rom/ets_sys.h" + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +#include "FreeRTOS.h" +#include "task.h" +#include "queue.h" + +#if ( configUSE_CO_ROUTINES == 1 ) + #include "croutine.h" +#endif + +/* Lint e961 and e750 are suppressed as a MISRA exception justified because the +MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the +header files above, but not in this file, in order to generate the correct +privileged Vs unprivileged linkage and placement. */ +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */ + + +/* Constants used with the xRxLock and xTxLock structure members. */ +#define queueUNLOCKED ( ( BaseType_t ) -1 ) +#define queueLOCKED_UNMODIFIED ( ( BaseType_t ) 0 ) + +/* When the Queue_t structure is used to represent a base queue its pcHead and +pcTail members are used as pointers into the queue storage area. When the +Queue_t structure is used to represent a mutex pcHead and pcTail pointers are +not necessary, and the pcHead pointer is set to NULL to indicate that the +pcTail pointer actually points to the mutex holder (if any). Map alternative +names to the pcHead and pcTail structure members to ensure the readability of +the code is maintained despite this dual use of two structure members. An +alternative implementation would be to use a union, but use of a union is +against the coding standard (although an exception to the standard has been +permitted where the dual use also significantly changes the type of the +structure member). */ +#define pxMutexHolder pcTail +#define uxQueueType pcHead +#define queueQUEUE_IS_MUTEX NULL + +/* Semaphores do not actually store or copy data, so have an item size of +zero. */ +#define queueSEMAPHORE_QUEUE_ITEM_LENGTH ( ( UBaseType_t ) 0 ) +#define queueMUTEX_GIVE_BLOCK_TIME ( ( TickType_t ) 0U ) + +#if( configUSE_PREEMPTION == 0 ) + /* If the cooperative scheduler is being used then a yield should not be + performed just because a higher priority task has been woken. */ + #define queueYIELD_IF_USING_PREEMPTION_MUX() + #define queueYIELD_IF_USING_PREEMPTION() +#else + #define queueYIELD_IF_USING_PREEMPTION() portYIELD_WITHIN_API() + #define queueYIELD_IF_USING_PREEMPTION_MUX(mux) { \ + taskEXIT_CRITICAL(mux); \ + portYIELD_WITHIN_API(); \ + taskENTER_CRITICAL(mux); \ + } while(0) +#endif + +/* + * Definition of the queue used by the scheduler. + * Items are queued by copy, not reference. See the following link for the + * rationale: http://www.freertos.org/Embedded-RTOS-Queues.html + */ +typedef struct QueueDefinition +{ + int8_t *pcHead; /*< Points to the beginning of the queue storage area. */ + int8_t *pcTail; /*< Points to the byte at the end of the queue storage area. Once more byte is allocated than necessary to store the queue items, this is used as a marker. */ + int8_t *pcWriteTo; /*< Points to the free next place in the storage area. */ + + union /* Use of a union is an exception to the coding standard to ensure two mutually exclusive structure members don't appear simultaneously (wasting RAM). */ + { + int8_t *pcReadFrom; /*< Points to the last place that a queued item was read from when the structure is used as a queue. */ + UBaseType_t uxRecursiveCallCount;/*< Maintains a count of the number of times a recursive mutex has been recursively 'taken' when the structure is used as a mutex. */ + } u; + + List_t xTasksWaitingToSend; /*< List of tasks that are blocked waiting to post onto this queue. Stored in priority order. */ + List_t xTasksWaitingToReceive; /*< List of tasks that are blocked waiting to read from this queue. Stored in priority order. */ + + volatile UBaseType_t uxMessagesWaiting;/*< The number of items currently in the queue. */ + UBaseType_t uxLength; /*< The length of the queue defined as the number of items it will hold, not the number of bytes. */ + UBaseType_t uxItemSize; /*< The size of each items that the queue will hold. */ + + volatile BaseType_t xRxLock; /*< Stores the number of items received from the queue (removed from the queue) while the queue was locked. Set to queueUNLOCKED when the queue is not locked. */ + volatile BaseType_t xTxLock; /*< Stores the number of items transmitted to the queue (added to the queue) while the queue was locked. Set to queueUNLOCKED when the queue is not locked. */ + + #if ( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxQueueNumber; + uint8_t ucQueueType; + #endif + + #if ( configUSE_QUEUE_SETS == 1 ) + struct QueueDefinition *pxQueueSetContainer; + #endif + + portMUX_TYPE mux; + +} xQUEUE; + +/* The old xQUEUE name is maintained above then typedefed to the new Queue_t +name below to enable the use of older kernel aware debuggers. */ +typedef xQUEUE Queue_t; + +/*-----------------------------------------------------------*/ + +/* + * The queue registry is just a means for kernel aware debuggers to locate + * queue structures. It has no other purpose so is an optional component. + */ +#if ( configQUEUE_REGISTRY_SIZE > 0 ) + + /* The type stored within the queue registry array. This allows a name + to be assigned to each queue making kernel aware debugging a little + more user friendly. */ + typedef struct QUEUE_REGISTRY_ITEM + { + const char *pcQueueName; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + QueueHandle_t xHandle; + } xQueueRegistryItem; + + /* The old xQueueRegistryItem name is maintained above then typedefed to the + new xQueueRegistryItem name below to enable the use of older kernel aware + debuggers. */ + typedef xQueueRegistryItem QueueRegistryItem_t; + + /* The queue registry is simply an array of QueueRegistryItem_t structures. + The pcQueueName member of a structure being NULL is indicative of the + array position being vacant. */ + QueueRegistryItem_t xQueueRegistry[ configQUEUE_REGISTRY_SIZE ]; + +#endif /* configQUEUE_REGISTRY_SIZE */ + +/* + * Unlocks a queue locked by a call to prvLockQueue. Locking a queue does not + * prevent an ISR from adding or removing items to the queue, but does prevent + * an ISR from removing tasks from the queue event lists. If an ISR finds a + * queue is locked it will instead increment the appropriate queue lock count + * to indicate that a task may require unblocking. When the queue in unlocked + * these lock counts are inspected, and the appropriate action taken. + */ +static void prvUnlockQueue( Queue_t * const pxQueue ) PRIVILEGED_FUNCTION; + +/* + * Uses a critical section to determine if there is any data in a queue. + * + * @return pdTRUE if the queue contains no items, otherwise pdFALSE. + */ +static BaseType_t prvIsQueueEmpty( Queue_t *pxQueue ) PRIVILEGED_FUNCTION; + +/* + * Uses a critical section to determine if there is any space in a queue. + * + * @return pdTRUE if there is no space, otherwise pdFALSE; + */ +static BaseType_t prvIsQueueFull( Queue_t *pxQueue ) PRIVILEGED_FUNCTION; + +/* + * Copies an item into the queue, either at the front of the queue or the + * back of the queue. + */ +static BaseType_t prvCopyDataToQueue( Queue_t * const pxQueue, const void *pvItemToQueue, const BaseType_t xPosition ) PRIVILEGED_FUNCTION; + +/* + * Copies an item out of a queue. + */ +static void prvCopyDataFromQueue( Queue_t * const pxQueue, void * const pvBuffer ) PRIVILEGED_FUNCTION; + +#if ( configUSE_QUEUE_SETS == 1 ) + /* + * Checks to see if a queue is a member of a queue set, and if so, notifies + * the queue set that the queue contains data. + */ + static BaseType_t prvNotifyQueueSetContainer( const Queue_t * const pxQueue, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION; +#endif + +/*-----------------------------------------------------------*/ + +/* + * Macro to mark a queue as locked. Locking a queue prevents an ISR from + * accessing the queue event lists. + */ +#define prvLockQueue( pxQueue ) \ + taskENTER_CRITICAL(&pxQueue->mux); \ + { \ + if( ( pxQueue )->xRxLock == queueUNLOCKED ) \ + { \ + ( pxQueue )->xRxLock = queueLOCKED_UNMODIFIED; \ + } \ + if( ( pxQueue )->xTxLock == queueUNLOCKED ) \ + { \ + ( pxQueue )->xTxLock = queueLOCKED_UNMODIFIED; \ + } \ + } \ + taskEXIT_CRITICAL(&pxQueue->mux) +/*-----------------------------------------------------------*/ + +BaseType_t xQueueGenericReset( QueueHandle_t xQueue, BaseType_t xNewQueue ) +{ +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + + if ( xNewQueue == pdTRUE ) + { + vPortCPUInitializeMutex(&pxQueue->mux); + } + taskENTER_CRITICAL(&pxQueue->mux); + { + pxQueue->pcTail = pxQueue->pcHead + ( pxQueue->uxLength * pxQueue->uxItemSize ); + pxQueue->uxMessagesWaiting = ( UBaseType_t ) 0U; + pxQueue->pcWriteTo = pxQueue->pcHead; + pxQueue->u.pcReadFrom = pxQueue->pcHead + ( ( pxQueue->uxLength - ( UBaseType_t ) 1U ) * pxQueue->uxItemSize ); + pxQueue->xRxLock = queueUNLOCKED; + pxQueue->xTxLock = queueUNLOCKED; + + if( xNewQueue == pdFALSE ) + { + /* If there are tasks blocked waiting to read from the queue, then + the tasks will remain blocked as after this function exits the queue + will still be empty. If there are tasks blocked waiting to write to + the queue, then one should be unblocked as after this function exits + it will be possible to write to it. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) == pdTRUE ) + { + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* Ensure the event queues start in the correct state. */ + vListInitialise( &( pxQueue->xTasksWaitingToSend ) ); + vListInitialise( &( pxQueue->xTasksWaitingToReceive ) ); + } + } + taskEXIT_CRITICAL(&pxQueue->mux); + + /* A value is returned for calling semantic consistency with previous + versions. */ + return pdPASS; +} +/*-----------------------------------------------------------*/ + +QueueHandle_t xQueueGenericCreate( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, const uint8_t ucQueueType ) +{ +Queue_t *pxNewQueue; +size_t xQueueSizeInBytes; +QueueHandle_t xReturn = NULL; +int8_t *pcAllocatedBuffer; + + /* Remove compiler warnings about unused parameters should + configUSE_TRACE_FACILITY not be set to 1. */ + ( void ) ucQueueType; + + configASSERT( uxQueueLength > ( UBaseType_t ) 0 ); + + if( uxItemSize == ( UBaseType_t ) 0 ) + { + /* There is not going to be a queue storage area. */ + xQueueSizeInBytes = ( size_t ) 0; + } + else + { + /* The queue is one byte longer than asked for to make wrap checking + easier/faster. */ + xQueueSizeInBytes = ( size_t ) ( uxQueueLength * uxItemSize ) + ( size_t ) 1; /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + } + + /* Allocate the new queue structure and storage area. */ + pcAllocatedBuffer = ( int8_t * ) pvPortMalloc( sizeof( Queue_t ) + xQueueSizeInBytes ); + + if( pcAllocatedBuffer != NULL ) + { + pxNewQueue = ( Queue_t * ) pcAllocatedBuffer; /*lint !e826 MISRA The buffer cannot be to small because it was dimensioned by sizeof( Queue_t ) + xQueueSizeInBytes. */ + + if( uxItemSize == ( UBaseType_t ) 0 ) + { + /* No RAM was allocated for the queue storage area, but PC head + cannot be set to NULL because NULL is used as a key to say the queue + is used as a mutex. Therefore just set pcHead to point to the queue + as a benign value that is known to be within the memory map. */ + pxNewQueue->pcHead = ( int8_t * ) pxNewQueue; + } + else + { + /* Jump past the queue structure to find the location of the queue + storage area - adding the padding bytes to get a better alignment. */ + pxNewQueue->pcHead = pcAllocatedBuffer + sizeof( Queue_t ); + } + + /* Initialise the queue members as described above where the queue type + is defined. */ + pxNewQueue->uxLength = uxQueueLength; + pxNewQueue->uxItemSize = uxItemSize; + ( void ) xQueueGenericReset( pxNewQueue, pdTRUE ); + + #if ( configUSE_TRACE_FACILITY == 1 ) + { + pxNewQueue->ucQueueType = ucQueueType; + } + #endif /* configUSE_TRACE_FACILITY */ + + #if( configUSE_QUEUE_SETS == 1 ) + { + pxNewQueue->pxQueueSetContainer = NULL; + } + #endif /* configUSE_QUEUE_SETS */ + + traceQUEUE_CREATE( pxNewQueue ); + xReturn = pxNewQueue; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + configASSERT( xReturn ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_MUTEXES == 1 ) + + QueueHandle_t xQueueCreateMutex( const uint8_t ucQueueType ) + { + Queue_t *pxNewQueue; + + /* Prevent compiler warnings about unused parameters if + configUSE_TRACE_FACILITY does not equal 1. */ + ( void ) ucQueueType; + + /* Allocate the new queue structure. */ + pxNewQueue = ( Queue_t * ) pvPortMalloc( sizeof( Queue_t ) ); + if( pxNewQueue != NULL ) + { + /* Information required for priority inheritance. */ + pxNewQueue->pxMutexHolder = NULL; + pxNewQueue->uxQueueType = queueQUEUE_IS_MUTEX; + + /* Queues used as a mutex no data is actually copied into or out + of the queue. */ + pxNewQueue->pcWriteTo = NULL; + pxNewQueue->u.pcReadFrom = NULL; + + /* Each mutex has a length of 1 (like a binary semaphore) and + an item size of 0 as nothing is actually copied into or out + of the mutex. */ + pxNewQueue->uxMessagesWaiting = ( UBaseType_t ) 0U; + pxNewQueue->uxLength = ( UBaseType_t ) 1U; + pxNewQueue->uxItemSize = ( UBaseType_t ) 0U; + pxNewQueue->xRxLock = queueUNLOCKED; + pxNewQueue->xTxLock = queueUNLOCKED; + + #if ( configUSE_TRACE_FACILITY == 1 ) + { + pxNewQueue->ucQueueType = ucQueueType; + } + #endif + + #if ( configUSE_QUEUE_SETS == 1 ) + { + pxNewQueue->pxQueueSetContainer = NULL; + } + #endif + + /* Ensure the event queues start with the correct state. */ + vListInitialise( &( pxNewQueue->xTasksWaitingToSend ) ); + vListInitialise( &( pxNewQueue->xTasksWaitingToReceive ) ); + + traceCREATE_MUTEX( pxNewQueue ); + + /* Start with the semaphore in the expected state. */ + ( void ) xQueueGenericSend( pxNewQueue, NULL, ( TickType_t ) 0U, queueSEND_TO_BACK ); + } + else + { + traceCREATE_MUTEX_FAILED(); + } + + configASSERT( pxNewQueue ); + return pxNewQueue; + } + +#endif /* configUSE_MUTEXES */ +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_MUTEXES == 1 ) && ( INCLUDE_xSemaphoreGetMutexHolder == 1 ) ) + + void* xQueueGetMutexHolder( QueueHandle_t xSemaphore ) + { + void *pxReturn; + + /* This function is called by xSemaphoreGetMutexHolder(), and should not + be called directly. Note: This is a good way of determining if the + calling task is the mutex holder, but not a good way of determining the + identity of the mutex holder, as the holder may change between the + following critical section exiting and the function returning. */ + taskENTER_CRITICAL(); + { + if( ( ( Queue_t * ) xSemaphore )->uxQueueType == queueQUEUE_IS_MUTEX ) + { + pxReturn = ( void * ) ( ( Queue_t * ) xSemaphore )->pxMutexHolder; + } + else + { + pxReturn = NULL; + } + } + taskEXIT_CRITICAL(); + + return pxReturn; + } /*lint !e818 xSemaphore cannot be a pointer to const because it is a typedef. */ + +#endif +/*-----------------------------------------------------------*/ + +#if ( configUSE_RECURSIVE_MUTEXES == 1 ) + + BaseType_t xQueueGiveMutexRecursive( QueueHandle_t xMutex ) + { + BaseType_t xReturn; + Queue_t * const pxMutex = ( Queue_t * ) xMutex; + + configASSERT( pxMutex ); + + /* If this is the task that holds the mutex then pxMutexHolder will not + change outside of this task. If this task does not hold the mutex then + pxMutexHolder can never coincidentally equal the tasks handle, and as + this is the only condition we are interested in it does not matter if + pxMutexHolder is accessed simultaneously by another task. Therefore no + mutual exclusion is required to test the pxMutexHolder variable. */ + if( pxMutex->pxMutexHolder == ( void * ) xTaskGetCurrentTaskHandle() ) /*lint !e961 Not a redundant cast as TaskHandle_t is a typedef. */ + { + traceGIVE_MUTEX_RECURSIVE( pxMutex ); + + /* uxRecursiveCallCount cannot be zero if pxMutexHolder is equal to + the task handle, therefore no underflow check is required. Also, + uxRecursiveCallCount is only modified by the mutex holder, and as + there can only be one, no mutual exclusion is required to modify the + uxRecursiveCallCount member. */ + ( pxMutex->u.uxRecursiveCallCount )--; + + /* Have we unwound the call count? */ + if( pxMutex->u.uxRecursiveCallCount == ( UBaseType_t ) 0 ) + { + /* Return the mutex. This will automatically unblock any other + task that might be waiting to access the mutex. */ + ( void ) xQueueGenericSend( pxMutex, NULL, queueMUTEX_GIVE_BLOCK_TIME, queueSEND_TO_BACK ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + xReturn = pdPASS; + } + else + { + /* The mutex cannot be given because the calling task is not the + holder. */ + xReturn = pdFAIL; + + traceGIVE_MUTEX_RECURSIVE_FAILED( pxMutex ); + } + + return xReturn; + } + +#endif /* configUSE_RECURSIVE_MUTEXES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_RECURSIVE_MUTEXES == 1 ) + + BaseType_t xQueueTakeMutexRecursive( QueueHandle_t xMutex, TickType_t xTicksToWait ) + { + BaseType_t xReturn; + Queue_t * const pxMutex = ( Queue_t * ) xMutex; + + configASSERT( pxMutex ); + + /* Comments regarding mutual exclusion as per those within + xQueueGiveMutexRecursive(). */ + + traceTAKE_MUTEX_RECURSIVE( pxMutex ); + + if( pxMutex->pxMutexHolder == ( void * ) xTaskGetCurrentTaskHandle() ) /*lint !e961 Cast is not redundant as TaskHandle_t is a typedef. */ + { + ( pxMutex->u.uxRecursiveCallCount )++; + xReturn = pdPASS; + } + else + { + xReturn = xQueueGenericReceive( pxMutex, NULL, xTicksToWait, pdFALSE ); + + /* pdPASS will only be returned if the mutex was successfully + obtained. The calling task may have entered the Blocked state + before reaching here. */ + if( xReturn == pdPASS ) + { + ( pxMutex->u.uxRecursiveCallCount )++; + } + else + { + traceTAKE_MUTEX_RECURSIVE_FAILED( pxMutex ); + } + } + + return xReturn; + } + +#endif /* configUSE_RECURSIVE_MUTEXES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_COUNTING_SEMAPHORES == 1 ) + + QueueHandle_t xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount ) + { + QueueHandle_t xHandle; + + configASSERT( uxMaxCount != 0 ); + configASSERT( uxInitialCount <= uxMaxCount ); + + xHandle = xQueueGenericCreate( uxMaxCount, queueSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_COUNTING_SEMAPHORE ); + + if( xHandle != NULL ) + { + ( ( Queue_t * ) xHandle )->uxMessagesWaiting = uxInitialCount; + + traceCREATE_COUNTING_SEMAPHORE(); + } + else + { + traceCREATE_COUNTING_SEMAPHORE_FAILED(); + } + + configASSERT( xHandle ); + return xHandle; + } + +#endif /* configUSE_COUNTING_SEMAPHORES */ +/*-----------------------------------------------------------*/ + +BaseType_t xQueueGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, const BaseType_t xCopyPosition ) +{ +BaseType_t xEntryTimeSet = pdFALSE, xYieldRequired; +TimeOut_t xTimeOut; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvItemToQueue == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + configASSERT( !( ( xCopyPosition == queueOVERWRITE ) && ( pxQueue->uxLength != 1 ) ) ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + + /* This function relaxes the coding standard somewhat to allow return + statements within the function itself. This is done in the interest + of execution time efficiency. */ + for( ;; ) + { + taskENTER_CRITICAL(&pxQueue->mux); + { + /* Is there room on the queue now? The running task must be + the highest priority task wanting to access the queue. If + the head item in the queue is to be overwritten then it does + not matter if the queue is full. */ + if( ( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) || ( xCopyPosition == queueOVERWRITE ) ) + { + traceQUEUE_SEND( pxQueue ); + xYieldRequired = prvCopyDataToQueue( pxQueue, pvItemToQueue, xCopyPosition ); + + #if ( configUSE_QUEUE_SETS == 1 ) + { + if( pxQueue->pxQueueSetContainer != NULL ) + { + if( prvNotifyQueueSetContainer( pxQueue, xCopyPosition ) == pdTRUE ) + { + /* The queue is a member of a queue set, and posting + to the queue set caused a higher priority task to + unblock. A context switch is required. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* If there was a task waiting for data to arrive on the + queue then unblock it now. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) == pdTRUE ) + { + /* The unblocked task has a priority higher than + our own so yield immediately. Yes it is ok to + do this from within the critical section - the + kernel takes care of that. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( xYieldRequired != pdFALSE ) + { + /* This path is a special case that will only get + executed if the task was holding multiple mutexes + and the mutexes were given back in an order that is + different to that in which they were taken. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + #else /* configUSE_QUEUE_SETS */ + { + /* If there was a task waiting for data to arrive on the + queue then unblock it now. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) == pdTRUE ) + { + /* The unblocked task has a priority higher than + our own so yield immediately. Yes it is ok to do + this from within the critical section - the kernel + takes care of that. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( xYieldRequired != pdFALSE ) + { + /* This path is a special case that will only get + executed if the task was holding multiple mutexes and + the mutexes were given back in an order that is + different to that in which they were taken. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_QUEUE_SETS */ + + taskEXIT_CRITICAL(&pxQueue->mux); + return pdPASS; + } + else + { + if( xTicksToWait == ( TickType_t ) 0 ) + { + /* The queue was full and no block time is specified (or + the block time has expired) so leave now. */ + taskEXIT_CRITICAL(&pxQueue->mux); + + /* Return to the original privilege level before exiting + the function. */ + traceQUEUE_SEND_FAILED( pxQueue ); + return errQUEUE_FULL; + } + else if( xEntryTimeSet == pdFALSE ) + { + /* The queue was full and a block time was specified so + configure the timeout structure. */ + vTaskSetTimeOutState( &xTimeOut ); + xEntryTimeSet = pdTRUE; + } + else + { + /* Entry time was already set. */ + mtCOVERAGE_TEST_MARKER(); + } + } + } + taskEXIT_CRITICAL(&pxQueue->mux); + + /* Interrupts and other tasks can send to and receive from the queue + now the critical section has been exited. */ + + taskENTER_CRITICAL(&pxQueue->mux); +// prvLockQueue( pxQueue ); + + /* Update the timeout state to see if it has expired yet. */ + if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE ) + { + if( prvIsQueueFull( pxQueue ) != pdFALSE ) + { + traceBLOCKING_ON_QUEUE_SEND( pxQueue ); + vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToSend ), xTicksToWait ); + + /* Unlocking the queue means queue events can effect the + event list. It is possible that interrupts occurring now + remove this task from the event list again - but as the + scheduler is suspended the task will go onto the pending + ready last instead of the actual ready list. */ +// prvUnlockQueue( pxQueue ); + + + /* Resuming the scheduler will move tasks from the pending + ready list into the ready list - so it is feasible that this + task is already in a ready list before it yields - in which + case the yield will not cause a context switch unless there + is also a higher priority task in the pending ready list. */ + taskEXIT_CRITICAL(&pxQueue->mux); + portYIELD_WITHIN_API(); + } + else + { + /* Try again. */ +// prvUnlockQueue( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + } + } + else + { + /* The timeout has expired. */ +// prvUnlockQueue( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + + /* Return to the original privilege level before exiting the + function. */ + traceQUEUE_SEND_FAILED( pxQueue ); + return errQUEUE_FULL; + } + } +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_ALTERNATIVE_API == 1 ) + + BaseType_t xQueueAltGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, BaseType_t xCopyPosition ) + { + BaseType_t xEntryTimeSet = pdFALSE; + TimeOut_t xTimeOut; + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvItemToQueue == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + + for( ;; ) + { + taskENTER_CRITICAL(&pxQueue->mux); + { + /* Is there room on the queue now? To be running we must be + the highest priority task wanting to access the queue. */ + if( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) + { + traceQUEUE_SEND( pxQueue ); + prvCopyDataToQueue( pxQueue, pvItemToQueue, xCopyPosition ); + + /* If there was a task waiting for data to arrive on the + queue then unblock it now. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) == pdTRUE ) + { + /* The unblocked task has a priority higher than + our own so yield immediately. */ + taskEXIT_CRITICAL(&pxQueue->mux); + portYIELD_WITHIN_API(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + taskEXIT_CRITICAL(&pxQueue->mux); + return pdPASS; + } + else + { + if( xTicksToWait == ( TickType_t ) 0 ) + { + taskEXIT_CRITICAL(&pxQueue->mux); + return errQUEUE_FULL; + } + else if( xEntryTimeSet == pdFALSE ) + { + vTaskSetTimeOutState( &xTimeOut ); + xEntryTimeSet = pdTRUE; + } + } + } + taskEXIT_CRITICAL(&pxQueue->mux); + + taskENTER_CRITICAL(&pxQueue->mux); + { + if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE ) + { + if( prvIsQueueFull( pxQueue ) != pdFALSE ) + { + traceBLOCKING_ON_QUEUE_SEND( pxQueue ); + vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToSend ), xTicksToWait ); + taskEXIT_CRITICAL(&pxQueue->mux); + portYIELD_WITHIN_API(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + taskEXIT_CRITICAL(&pxQueue->mux); + traceQUEUE_SEND_FAILED( pxQueue ); + return errQUEUE_FULL; + } + } + taskEXIT_CRITICAL(&pxQueue->mux); + } + } + +#endif /* configUSE_ALTERNATIVE_API */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_ALTERNATIVE_API == 1 ) + + BaseType_t xQueueAltGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, BaseType_t xJustPeeking ) + { + BaseType_t xEntryTimeSet = pdFALSE; + TimeOut_t xTimeOut; + int8_t *pcOriginalReadPosition; + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + ets_printf("Not Supported: %s\n", __FUNCTION__); + for( ;; ) + { + taskENTER_CRITICAL(); + { + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + /* Remember our read position in case we are just peeking. */ + pcOriginalReadPosition = pxQueue->u.pcReadFrom; + + prvCopyDataFromQueue( pxQueue, pvBuffer ); + + if( xJustPeeking == pdFALSE ) + { + traceQUEUE_RECEIVE( pxQueue ); + + /* Data is actually being removed (not just peeked). */ + --( pxQueue->uxMessagesWaiting ); + + #if ( configUSE_MUTEXES == 1 ) + { + if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) + { + /* Record the information required to implement + priority inheritance should it become necessary. */ + pxQueue->pxMutexHolder = ( int8_t * ) xTaskGetCurrentTaskHandle(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif + + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) == pdTRUE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + else + { + traceQUEUE_PEEK( pxQueue ); + + /* The data is not being removed, so reset our read + pointer. */ + pxQueue->u.pcReadFrom = pcOriginalReadPosition; + + /* The data is being left in the queue, so see if there are + any other tasks waiting for the data. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + /* Tasks that are removed from the event list will get added to + the pending ready list as the scheduler is still suspended. */ + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority than this task. */ + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + taskEXIT_CRITICAL(); + return pdPASS; + } + else + { + if( xTicksToWait == ( TickType_t ) 0 ) + { + taskEXIT_CRITICAL(); + traceQUEUE_RECEIVE_FAILED( pxQueue ); + return errQUEUE_EMPTY; + } + else if( xEntryTimeSet == pdFALSE ) + { + vTaskSetTimeOutState( &xTimeOut ); + xEntryTimeSet = pdTRUE; + } + } + } + taskEXIT_CRITICAL(); + + taskENTER_CRITICAL(); + { + if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE ) + { + if( prvIsQueueEmpty( pxQueue ) != pdFALSE ) + { + traceBLOCKING_ON_QUEUE_RECEIVE( pxQueue ); + + #if ( configUSE_MUTEXES == 1 ) + { + if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) + { + taskENTER_CRITICAL(); + { + vTaskPriorityInherit( ( void * ) pxQueue->pxMutexHolder ); + } + taskEXIT_CRITICAL(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif + + vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToReceive ), xTicksToWait ); + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + taskEXIT_CRITICAL(); + traceQUEUE_RECEIVE_FAILED( pxQueue ); + return errQUEUE_EMPTY; + } + } + taskEXIT_CRITICAL(); + } + } + + +#endif /* configUSE_ALTERNATIVE_API */ +/*-----------------------------------------------------------*/ + +BaseType_t xQueueGenericSendFromISR( QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken, const BaseType_t xCopyPosition ) +{ +BaseType_t xReturn; +UBaseType_t uxSavedInterruptStatus; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvItemToQueue == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + configASSERT( !( ( xCopyPosition == queueOVERWRITE ) && ( pxQueue->uxLength != 1 ) ) ); + + /* RTOS ports that support interrupt nesting have the concept of a maximum + system call (or maximum API call) interrupt priority. Interrupts that are + above the maximum system call priority are kept permanently enabled, even + when the RTOS kernel is in a critical section, but cannot make any calls to + FreeRTOS API functions. If configASSERT() is defined in FreeRTOSConfig.h + then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion + failure if a FreeRTOS API function is called from an interrupt that has been + assigned a priority above the configured maximum system call priority. + Only FreeRTOS functions that end in FromISR can be called from interrupts + that have been assigned a priority at or (logically) below the maximum + system call interrupt priority. FreeRTOS maintains a separate interrupt + safe API to ensure interrupt entry is as fast and as simple as possible. + More information (albeit Cortex-M specific) is provided on the following + link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */ + portASSERT_IF_INTERRUPT_PRIORITY_INVALID(); + + /* Similar to xQueueGenericSend, except without blocking if there is no room + in the queue. Also don't directly wake a task that was blocked on a queue + read, instead return a flag to say whether a context switch is required or + not (i.e. has a task with a higher priority than us been woken by this + post). */ + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + { + taskENTER_CRITICAL_ISR(&pxQueue->mux); + if( ( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) || ( xCopyPosition == queueOVERWRITE ) ) + { + traceQUEUE_SEND_FROM_ISR( pxQueue ); + + /* A task can only have an inherited priority if it is a mutex + holder - and if there is a mutex holder then the mutex cannot be + given from an ISR. Therefore, unlike the xQueueGenericGive() + function, there is no need to determine the need for priority + disinheritance here or to clear the mutex holder TCB member. */ + ( void ) prvCopyDataToQueue( pxQueue, pvItemToQueue, xCopyPosition ); + + /* The event list is not altered if the queue is locked. This will + be done when the queue is unlocked later. */ + if( pxQueue->xTxLock == queueUNLOCKED ) + { + #if ( configUSE_QUEUE_SETS == 1 ) + { + if( pxQueue->pxQueueSetContainer != NULL ) + { + if( prvNotifyQueueSetContainer( pxQueue, xCopyPosition ) == pdTRUE ) + { + /* The queue is a member of a queue set, and posting + to the queue set caused a higher priority task to + unblock. A context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so + record that a context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + #else /* configUSE_QUEUE_SETS */ + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so record that a + context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_QUEUE_SETS */ + } + else + { + /* Increment the lock count so the task that unlocks the queue + knows that data was posted while it was locked. */ + ++( pxQueue->xTxLock ); + } + + xReturn = pdPASS; + } + else + { + traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue ); + xReturn = errQUEUE_FULL; + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + } + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueueGiveFromISR( QueueHandle_t xQueue, BaseType_t * const pxHigherPriorityTaskWoken ) +{ +BaseType_t xReturn; +UBaseType_t uxSavedInterruptStatus; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + + /* xQueueGenericSendFromISR() should be used in the item size is not 0. */ + configASSERT( pxQueue->uxItemSize == 0 ); + + /* RTOS ports that support interrupt nesting have the concept of a maximum + system call (or maximum API call) interrupt priority. Interrupts that are + above the maximum system call priority are kept permanently enabled, even + when the RTOS kernel is in a critical section, but cannot make any calls to + FreeRTOS API functions. If configASSERT() is defined in FreeRTOSConfig.h + then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion + failure if a FreeRTOS API function is called from an interrupt that has been + assigned a priority above the configured maximum system call priority. + Only FreeRTOS functions that end in FromISR can be called from interrupts + that have been assigned a priority at or (logically) below the maximum + system call interrupt priority. FreeRTOS maintains a separate interrupt + safe API to ensure interrupt entry is as fast and as simple as possible. + More information (albeit Cortex-M specific) is provided on the following + link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */ + portASSERT_IF_INTERRUPT_PRIORITY_INVALID(); + + /* Similar to xQueueGenericSendFromISR() but used with semaphores where the + item size is 0. Don't directly wake a task that was blocked on a queue + read, instead return a flag to say whether a context switch is required or + not (i.e. has a task with a higher priority than us been woken by this + post). */ + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + { + taskENTER_CRITICAL_ISR(&pxQueue->mux); + /* When the queue is used to implement a semaphore no data is ever + moved through the queue but it is still valid to see if the queue 'has + space'. */ + if( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) + { + traceQUEUE_SEND_FROM_ISR( pxQueue ); + + /* A task can only have an inherited priority if it is a mutex + holder - and if there is a mutex holder then the mutex cannot be + given from an ISR. Therefore, unlike the xQueueGenericGive() + function, there is no need to determine the need for priority + disinheritance here or to clear the mutex holder TCB member. */ + + ++( pxQueue->uxMessagesWaiting ); + + /* The event list is not altered if the queue is locked. This will + be done when the queue is unlocked later. */ + if( pxQueue->xTxLock == queueUNLOCKED ) + { + #if ( configUSE_QUEUE_SETS == 1 ) + { + if( pxQueue->pxQueueSetContainer != NULL ) + { + if( prvNotifyQueueSetContainer( pxQueue, queueSEND_TO_BACK ) == pdTRUE ) + { + /* The semaphore is a member of a queue set, and + posting to the queue set caused a higher priority + task to unblock. A context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so + record that a context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + #else /* configUSE_QUEUE_SETS */ + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so record that a + context switch is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_QUEUE_SETS */ + } + else + { + /* Increment the lock count so the task that unlocks the queue + knows that data was posted while it was locked. */ + ++( pxQueue->xTxLock ); + } + + xReturn = pdPASS; + } + else + { + traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue ); + xReturn = errQUEUE_FULL; + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + } + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xJustPeeking ) +{ +BaseType_t xEntryTimeSet = pdFALSE; +TimeOut_t xTimeOut; +int8_t *pcOriginalReadPosition; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + /* This function relaxes the coding standard somewhat to allow return + statements within the function itself. This is done in the interest + of execution time efficiency. */ + + for( ;; ) + { + taskENTER_CRITICAL(&pxQueue->mux); + { + /* Is there data in the queue now? To be running the calling task + must be the highest priority task wanting to access the queue. */ + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + /* Remember the read position in case the queue is only being + peeked. */ + pcOriginalReadPosition = pxQueue->u.pcReadFrom; + + prvCopyDataFromQueue( pxQueue, pvBuffer ); + + if( xJustPeeking == pdFALSE ) + { + traceQUEUE_RECEIVE( pxQueue ); + + /* Actually removing data, not just peeking. */ + --( pxQueue->uxMessagesWaiting ); + + #if ( configUSE_MUTEXES == 1 ) + { + if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) + { + /* Record the information required to implement + priority inheritance should it become necessary. */ + pxQueue->pxMutexHolder = ( int8_t * ) pvTaskIncrementMutexHeldCount(); /*lint !e961 Cast is not redundant as TaskHandle_t is a typedef. */ + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_MUTEXES */ + + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) == pdTRUE ) + { + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + traceQUEUE_PEEK( pxQueue ); + + /* The data is not being removed, so reset the read + pointer. */ + pxQueue->u.pcReadFrom = pcOriginalReadPosition; + + /* The data is being left in the queue, so see if there are + any other tasks waiting for the data. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + /* Tasks that are removed from the event list will get added to + the pending ready list as the scheduler is still suspended. */ + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority than this task. */ + queueYIELD_IF_USING_PREEMPTION_MUX(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + taskEXIT_CRITICAL(&pxQueue->mux); + return pdPASS; + } + else + { + if( xTicksToWait == ( TickType_t ) 0 ) + { + /* The queue was empty and no block time is specified (or + the block time has expired) so leave now. */ + traceQUEUE_RECEIVE_FAILED( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + return errQUEUE_EMPTY; + } + else if( xEntryTimeSet == pdFALSE ) + { + /* The queue was empty and a block time was specified so + configure the timeout structure. */ + vTaskSetTimeOutState( &xTimeOut ); + xEntryTimeSet = pdTRUE; + } + else + { + /* Entry time was already set. */ + mtCOVERAGE_TEST_MARKER(); + } + } + } + taskEXIT_CRITICAL(&pxQueue->mux); + + /* Interrupts and other tasks can send to and receive from the queue + now the critical section has been exited. */ + + taskENTER_CRITICAL(&pxQueue->mux); +// prvLockQueue( pxQueue ); + + /* Update the timeout state to see if it has expired yet. */ + if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE ) + { + if( prvIsQueueEmpty( pxQueue ) != pdFALSE ) + { + traceBLOCKING_ON_QUEUE_RECEIVE( pxQueue ); + + #if ( configUSE_MUTEXES == 1 ) + { + if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) + { + vTaskPriorityInherit( ( void * ) pxQueue->pxMutexHolder ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif + + vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToReceive ), xTicksToWait ); +// prvUnlockQueue( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + portYIELD_WITHIN_API(); + } + else + { + /* Try again. */ +// prvUnlockQueue( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + } + } + else + { +// prvUnlockQueue( pxQueue ); + taskEXIT_CRITICAL(&pxQueue->mux); + traceQUEUE_RECEIVE_FAILED( pxQueue ); + return errQUEUE_EMPTY; + } + } +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueueReceiveFromISR( QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken ) +{ +BaseType_t xReturn; +UBaseType_t uxSavedInterruptStatus; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + + /* RTOS ports that support interrupt nesting have the concept of a maximum + system call (or maximum API call) interrupt priority. Interrupts that are + above the maximum system call priority are kept permanently enabled, even + when the RTOS kernel is in a critical section, but cannot make any calls to + FreeRTOS API functions. If configASSERT() is defined in FreeRTOSConfig.h + then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion + failure if a FreeRTOS API function is called from an interrupt that has been + assigned a priority above the configured maximum system call priority. + Only FreeRTOS functions that end in FromISR can be called from interrupts + that have been assigned a priority at or (logically) below the maximum + system call interrupt priority. FreeRTOS maintains a separate interrupt + safe API to ensure interrupt entry is as fast and as simple as possible. + More information (albeit Cortex-M specific) is provided on the following + link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */ + portASSERT_IF_INTERRUPT_PRIORITY_INVALID(); + + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + { + taskENTER_CRITICAL_ISR(&pxQueue->mux); + /* Cannot block in an ISR, so check there is data available. */ + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + traceQUEUE_RECEIVE_FROM_ISR( pxQueue ); + + prvCopyDataFromQueue( pxQueue, pvBuffer ); + --( pxQueue->uxMessagesWaiting ); + + /* If the queue is locked the event list will not be modified. + Instead update the lock count so the task that unlocks the queue + will know that an ISR has removed data while the queue was + locked. */ + if( pxQueue->xRxLock == queueUNLOCKED ) + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE ) + { + /* The task waiting has a higher priority than us so + force a context switch. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* Increment the lock count so the task that unlocks the queue + knows that data was removed while it was locked. */ + ++( pxQueue->xRxLock ); + } + + xReturn = pdPASS; + } + else + { + xReturn = pdFAIL; + traceQUEUE_RECEIVE_FROM_ISR_FAILED( pxQueue ); + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + } + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueuePeekFromISR( QueueHandle_t xQueue, void * const pvBuffer ) +{ +BaseType_t xReturn; +UBaseType_t uxSavedInterruptStatus; +int8_t *pcOriginalReadPosition; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) ); + configASSERT( pxQueue->uxItemSize != 0 ); /* Can't peek a semaphore. */ + + /* RTOS ports that support interrupt nesting have the concept of a maximum + system call (or maximum API call) interrupt priority. Interrupts that are + above the maximum system call priority are kept permanently enabled, even + when the RTOS kernel is in a critical section, but cannot make any calls to + FreeRTOS API functions. If configASSERT() is defined in FreeRTOSConfig.h + then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion + failure if a FreeRTOS API function is called from an interrupt that has been + assigned a priority above the configured maximum system call priority. + Only FreeRTOS functions that end in FromISR can be called from interrupts + that have been assigned a priority at or (logically) below the maximum + system call interrupt priority. FreeRTOS maintains a separate interrupt + safe API to ensure interrupt entry is as fast and as simple as possible. + More information (albeit Cortex-M specific) is provided on the following + link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */ + portASSERT_IF_INTERRUPT_PRIORITY_INVALID(); + + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + taskENTER_CRITICAL_ISR(&pxQueue->mux); + { + /* Cannot block in an ISR, so check there is data available. */ + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + traceQUEUE_PEEK_FROM_ISR( pxQueue ); + + /* Remember the read position so it can be reset as nothing is + actually being removed from the queue. */ + pcOriginalReadPosition = pxQueue->u.pcReadFrom; + prvCopyDataFromQueue( pxQueue, pvBuffer ); + pxQueue->u.pcReadFrom = pcOriginalReadPosition; + + xReturn = pdPASS; + } + else + { + xReturn = pdFAIL; + traceQUEUE_PEEK_FROM_ISR_FAILED( pxQueue ); + } + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue ) +{ +UBaseType_t uxReturn; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( xQueue ); + + taskENTER_CRITICAL(&pxQueue->mux); + { + uxReturn = ( ( Queue_t * ) xQueue )->uxMessagesWaiting; + } + taskEXIT_CRITICAL(&pxQueue->mux); + + return uxReturn; +} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */ +/*-----------------------------------------------------------*/ + +UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue ) +{ +UBaseType_t uxReturn; +Queue_t *pxQueue; + + pxQueue = ( Queue_t * ) xQueue; + configASSERT( pxQueue ); + + taskENTER_CRITICAL(&pxQueue->mux); + { + uxReturn = pxQueue->uxLength - pxQueue->uxMessagesWaiting; + } + taskEXIT_CRITICAL(&pxQueue->mux); + + return uxReturn; +} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */ +/*-----------------------------------------------------------*/ + +UBaseType_t uxQueueMessagesWaitingFromISR( const QueueHandle_t xQueue ) +{ +UBaseType_t uxReturn; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( xQueue ); + + taskENTER_CRITICAL_ISR(&pxQueue->mux); + uxReturn = ( ( Queue_t * ) xQueue )->uxMessagesWaiting; + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + + return uxReturn; +} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */ +/*-----------------------------------------------------------*/ + +void vQueueDelete( QueueHandle_t xQueue ) +{ +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( pxQueue ); + + traceQUEUE_DELETE( pxQueue ); + #if ( configQUEUE_REGISTRY_SIZE > 0 ) + { + vQueueUnregisterQueue( pxQueue ); + } + #endif + vPortFree( pxQueue ); +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + UBaseType_t uxQueueGetQueueNumber( QueueHandle_t xQueue ) + { + return ( ( Queue_t * ) xQueue )->uxQueueNumber; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + void vQueueSetQueueNumber( QueueHandle_t xQueue, UBaseType_t uxQueueNumber ) + { + ( ( Queue_t * ) xQueue )->uxQueueNumber = uxQueueNumber; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + uint8_t ucQueueGetQueueType( QueueHandle_t xQueue ) + { + return ( ( Queue_t * ) xQueue )->ucQueueType; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*-----------------------------------------------------------*/ + +//This routine assumes the queue has already been locked. +static BaseType_t prvCopyDataToQueue( Queue_t * const pxQueue, const void *pvItemToQueue, const BaseType_t xPosition ) +{ +BaseType_t xReturn = pdFALSE; + + if( pxQueue->uxItemSize == ( UBaseType_t ) 0 ) + { + #if ( configUSE_MUTEXES == 1 ) + { + if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) + { + /* The mutex is no longer being held. */ + xReturn = xTaskPriorityDisinherit( ( void * ) pxQueue->pxMutexHolder ); + pxQueue->pxMutexHolder = NULL; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_MUTEXES */ + } + else if( xPosition == queueSEND_TO_BACK ) + { + ( void ) memcpy( ( void * ) pxQueue->pcWriteTo, pvItemToQueue, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 !e418 MISRA exception as the casts are only redundant for some ports, plus previous logic ensures a null pointer can only be passed to memcpy() if the copy size is 0. */ + pxQueue->pcWriteTo += pxQueue->uxItemSize; + if( pxQueue->pcWriteTo >= pxQueue->pcTail ) /*lint !e946 MISRA exception justified as comparison of pointers is the cleanest solution. */ + { + pxQueue->pcWriteTo = pxQueue->pcHead; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + ( void ) memcpy( ( void * ) pxQueue->u.pcReadFrom, pvItemToQueue, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + pxQueue->u.pcReadFrom -= pxQueue->uxItemSize; + if( pxQueue->u.pcReadFrom < pxQueue->pcHead ) /*lint !e946 MISRA exception justified as comparison of pointers is the cleanest solution. */ + { + pxQueue->u.pcReadFrom = ( pxQueue->pcTail - pxQueue->uxItemSize ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( xPosition == queueOVERWRITE ) + { + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + /* An item is not being added but overwritten, so subtract + one from the recorded number of items in the queue so when + one is added again below the number of recorded items remains + correct. */ + --( pxQueue->uxMessagesWaiting ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + ++( pxQueue->uxMessagesWaiting ); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +static void prvCopyDataFromQueue( Queue_t * const pxQueue, void * const pvBuffer ) +{ + if( pxQueue->uxItemSize != ( UBaseType_t ) 0 ) + { + pxQueue->u.pcReadFrom += pxQueue->uxItemSize; + if( pxQueue->u.pcReadFrom >= pxQueue->pcTail ) /*lint !e946 MISRA exception justified as use of the relational operator is the cleanest solutions. */ + { + pxQueue->u.pcReadFrom = pxQueue->pcHead; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + ( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 !e418 MISRA exception as the casts are only redundant for some ports. Also previous logic ensures a null pointer can only be passed to memcpy() when the count is 0. */ + } +} +/*-----------------------------------------------------------*/ + +static void prvUnlockQueue( Queue_t * const pxQueue ) +{ + /* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED. */ + + /* The lock counts contains the number of extra data items placed or + removed from the queue while the queue was locked. When a queue is + locked items can be added or removed, but the event lists cannot be + updated. */ + taskENTER_CRITICAL(&pxQueue->mux); + { + /* See if data was added to the queue while it was locked. */ + while( pxQueue->xTxLock > queueLOCKED_UNMODIFIED ) + { + /* Data was posted while the queue was locked. Are any tasks + blocked waiting for data to become available? */ + #if ( configUSE_QUEUE_SETS == 1 ) + { + if( pxQueue->pxQueueSetContainer != NULL ) + { + if( prvNotifyQueueSetContainer( pxQueue, queueSEND_TO_BACK ) == pdTRUE ) + { + /* The queue is a member of a queue set, and posting to + the queue set caused a higher priority task to unblock. + A context switch is required. */ + taskEXIT_CRITICAL(&pxQueue->mux); //ToDo: Is aquire/release needed around any of the bTaskMissedYield calls? + vTaskMissedYield(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* Tasks that are removed from the event list will get added to + the pending ready list as the scheduler is still suspended. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so record that a + context switch is required. */ + taskEXIT_CRITICAL(&pxQueue->mux); + vTaskMissedYield(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + break; + } + } + } + #else /* configUSE_QUEUE_SETS */ + { + /* Tasks that are removed from the event list will get added to + the pending ready list as the scheduler is still suspended. */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority so record that a + context switch is required. */ + taskEXIT_CRITICAL(&pxQueue->mux); + vTaskMissedYield(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + break; + } + } + #endif /* configUSE_QUEUE_SETS */ + + --( pxQueue->xTxLock ); + } + + pxQueue->xTxLock = queueUNLOCKED; + } + taskEXIT_CRITICAL(&pxQueue->mux); + + /* Do the same for the Rx lock. */ + taskENTER_CRITICAL(&pxQueue->mux); + { + while( pxQueue->xRxLock > queueLOCKED_UNMODIFIED ) + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE ) + { + taskEXIT_CRITICAL(&pxQueue->mux); + vTaskMissedYield(); + taskENTER_CRITICAL(&pxQueue->mux); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + --( pxQueue->xRxLock ); + } + else + { + break; + } + } + + pxQueue->xRxLock = queueUNLOCKED; + } + taskEXIT_CRITICAL(&pxQueue->mux); +} +/*-----------------------------------------------------------*/ + +static BaseType_t prvIsQueueEmpty( Queue_t *pxQueue ) +{ +BaseType_t xReturn; + + //No lock needed: we read a base type. + { + if( pxQueue->uxMessagesWaiting == ( UBaseType_t ) 0 ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + } + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueueIsQueueEmptyFromISR( QueueHandle_t xQueue ) +{ +BaseType_t xReturn; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( xQueue ); + taskENTER_CRITICAL_ISR(&pxQueue->mux); + if( ( ( Queue_t * ) xQueue )->uxMessagesWaiting == ( UBaseType_t ) 0 ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + + return xReturn; +} /*lint !e818 xQueue could not be pointer to const because it is a typedef. */ +/*-----------------------------------------------------------*/ + +static BaseType_t prvIsQueueFull( Queue_t *pxQueue ) +{ +BaseType_t xReturn; + + taskENTER_CRITICAL_ISR(&pxQueue->mux); + { + if( pxQueue->uxMessagesWaiting == pxQueue->uxLength ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xQueueIsQueueFullFromISR( QueueHandle_t xQueue ) +{ +BaseType_t xReturn; +Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + configASSERT( xQueue ); + taskENTER_CRITICAL_ISR(&pxQueue->mux); + if( ( ( Queue_t * ) xQueue )->uxMessagesWaiting == ( ( Queue_t * ) xQueue )->uxLength ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + taskEXIT_CRITICAL_ISR(&pxQueue->mux); + + return xReturn; +} /*lint !e818 xQueue could not be pointer to const because it is a typedef. */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_CO_ROUTINES == 1 ) + + BaseType_t xQueueCRSend( QueueHandle_t xQueue, const void *pvItemToQueue, TickType_t xTicksToWait ) + { + BaseType_t xReturn; + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + /* If the queue is already full we may have to block. A critical section + is required to prevent an interrupt removing something from the queue + between the check to see if the queue is full and blocking on the queue. */ + portDISABLE_INTERRUPTS(); + { + if( prvIsQueueFull( pxQueue ) != pdFALSE ) + { + /* The queue is full - do we want to block or just leave without + posting? */ + if( xTicksToWait > ( TickType_t ) 0 ) + { + /* As this is called from a coroutine we cannot block directly, but + return indicating that we need to block. */ + vCoRoutineAddToDelayedList( xTicksToWait, &( pxQueue->xTasksWaitingToSend ) ); + portENABLE_INTERRUPTS(); + return errQUEUE_BLOCKED; + } + else + { + portENABLE_INTERRUPTS(); + return errQUEUE_FULL; + } + } + } + portENABLE_INTERRUPTS(); + + portDISABLE_INTERRUPTS(); + { + if( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) + { + /* There is room in the queue, copy the data into the queue. */ + prvCopyDataToQueue( pxQueue, pvItemToQueue, queueSEND_TO_BACK ); + xReturn = pdPASS; + + /* Were any co-routines waiting for data to become available? */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + /* In this instance the co-routine could be placed directly + into the ready list as we are within a critical section. + Instead the same pending ready list mechanism is used as if + the event were caused from within an interrupt. */ + if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The co-routine waiting has a higher priority so record + that a yield might be appropriate. */ + xReturn = errQUEUE_YIELD; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + xReturn = errQUEUE_FULL; + } + } + portENABLE_INTERRUPTS(); + + return xReturn; + } + +#endif /* configUSE_CO_ROUTINES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_CO_ROUTINES == 1 ) + + BaseType_t xQueueCRReceive( QueueHandle_t xQueue, void *pvBuffer, TickType_t xTicksToWait ) + { + BaseType_t xReturn; + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + /* If the queue is already empty we may have to block. A critical section + is required to prevent an interrupt adding something to the queue + between the check to see if the queue is empty and blocking on the queue. */ + portDISABLE_INTERRUPTS(); + { + if( pxQueue->uxMessagesWaiting == ( UBaseType_t ) 0 ) + { + /* There are no messages in the queue, do we want to block or just + leave with nothing? */ + if( xTicksToWait > ( TickType_t ) 0 ) + { + /* As this is a co-routine we cannot block directly, but return + indicating that we need to block. */ + vCoRoutineAddToDelayedList( xTicksToWait, &( pxQueue->xTasksWaitingToReceive ) ); + portENABLE_INTERRUPTS(); + return errQUEUE_BLOCKED; + } + else + { + portENABLE_INTERRUPTS(); + return errQUEUE_FULL; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + portENABLE_INTERRUPTS(); + + portDISABLE_INTERRUPTS(); + { + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + /* Data is available from the queue. */ + pxQueue->u.pcReadFrom += pxQueue->uxItemSize; + if( pxQueue->u.pcReadFrom >= pxQueue->pcTail ) + { + pxQueue->u.pcReadFrom = pxQueue->pcHead; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + --( pxQueue->uxMessagesWaiting ); + ( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( unsigned ) pxQueue->uxItemSize ); + + xReturn = pdPASS; + + /* Were any co-routines waiting for space to become available? */ + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + /* In this instance the co-routine could be placed directly + into the ready list as we are within a critical section. + Instead the same pending ready list mechanism is used as if + the event were caused from within an interrupt. */ + if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE ) + { + xReturn = errQUEUE_YIELD; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + xReturn = pdFAIL; + } + } + portENABLE_INTERRUPTS(); + + return xReturn; + } + +#endif /* configUSE_CO_ROUTINES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_CO_ROUTINES == 1 ) + + BaseType_t xQueueCRSendFromISR( QueueHandle_t xQueue, const void *pvItemToQueue, BaseType_t xCoRoutinePreviouslyWoken ) + { + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + /* Cannot block within an ISR so if there is no space on the queue then + exit without doing anything. */ + if( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) + { + prvCopyDataToQueue( pxQueue, pvItemToQueue, queueSEND_TO_BACK ); + + /* We only want to wake one co-routine per ISR, so check that a + co-routine has not already been woken. */ + if( xCoRoutinePreviouslyWoken == pdFALSE ) + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE ) + { + return pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + return xCoRoutinePreviouslyWoken; + } + +#endif /* configUSE_CO_ROUTINES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_CO_ROUTINES == 1 ) + + BaseType_t xQueueCRReceiveFromISR( QueueHandle_t xQueue, void *pvBuffer, BaseType_t *pxCoRoutineWoken ) + { + BaseType_t xReturn; + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + /* We cannot block from an ISR, so check there is data available. If + not then just leave without doing anything. */ + if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 ) + { + /* Copy the data from the queue. */ + pxQueue->u.pcReadFrom += pxQueue->uxItemSize; + if( pxQueue->u.pcReadFrom >= pxQueue->pcTail ) + { + pxQueue->u.pcReadFrom = pxQueue->pcHead; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + --( pxQueue->uxMessagesWaiting ); + ( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( unsigned ) pxQueue->uxItemSize ); + + if( ( *pxCoRoutineWoken ) == pdFALSE ) + { + if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE ) + { + if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE ) + { + *pxCoRoutineWoken = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + xReturn = pdPASS; + } + else + { + xReturn = pdFAIL; + } + + return xReturn; + } + +#endif /* configUSE_CO_ROUTINES */ +/*-----------------------------------------------------------*/ + +#if ( configQUEUE_REGISTRY_SIZE > 0 ) + + void vQueueAddToRegistry( QueueHandle_t xQueue, const char *pcQueueName ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + { + UBaseType_t ux; + + /* See if there is an empty space in the registry. A NULL name denotes + a free slot. */ + for( ux = ( UBaseType_t ) 0U; ux < ( UBaseType_t ) configQUEUE_REGISTRY_SIZE; ux++ ) + { + if( xQueueRegistry[ ux ].pcQueueName == NULL ) + { + /* Store the information on this queue. */ + xQueueRegistry[ ux ].pcQueueName = pcQueueName; + xQueueRegistry[ ux ].xHandle = xQueue; + + traceQUEUE_REGISTRY_ADD( xQueue, pcQueueName ); + break; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + +#endif /* configQUEUE_REGISTRY_SIZE */ +/*-----------------------------------------------------------*/ + +#if ( configQUEUE_REGISTRY_SIZE > 0 ) + + void vQueueUnregisterQueue( QueueHandle_t xQueue ) + { + UBaseType_t ux; + + /* See if the handle of the queue being unregistered in actually in the + registry. */ + for( ux = ( UBaseType_t ) 0U; ux < ( UBaseType_t ) configQUEUE_REGISTRY_SIZE; ux++ ) + { + if( xQueueRegistry[ ux ].xHandle == xQueue ) + { + /* Set the name to NULL to show that this slot if free again. */ + xQueueRegistry[ ux ].pcQueueName = NULL; + break; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + } /*lint !e818 xQueue could not be pointer to const because it is a typedef. */ + +#endif /* configQUEUE_REGISTRY_SIZE */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_TIMERS == 1 ) + + void vQueueWaitForMessageRestricted( QueueHandle_t xQueue, TickType_t xTicksToWait ) + { + Queue_t * const pxQueue = ( Queue_t * ) xQueue; + + /* This function should not be called by application code hence the + 'Restricted' in its name. It is not part of the public API. It is + designed for use by kernel code, and has special calling requirements. + It can result in vListInsert() being called on a list that can only + possibly ever have one item in it, so the list will be fast, but even + so it should be called with the scheduler locked and not from a critical + section. */ + + /* Only do anything if there are no messages in the queue. This function + will not actually cause the task to block, just place it on a blocked + list. It will not block until the scheduler is unlocked - at which + time a yield will be performed. If an item is added to the queue while + the queue is locked, and the calling task blocks on the queue, then the + calling task will be immediately unblocked when the queue is unlocked. */ +// prvLockQueue( pxQueue ); + if( pxQueue->uxMessagesWaiting == ( UBaseType_t ) 0U ) + { + /* There is nothing in the queue, block for the specified period. */ + vTaskPlaceOnEventListRestricted( &( pxQueue->xTasksWaitingToReceive ), xTicksToWait ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } +// prvUnlockQueue( pxQueue ); + } + +#endif /* configUSE_TIMERS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + QueueSetHandle_t xQueueCreateSet( const UBaseType_t uxEventQueueLength ) + { + QueueSetHandle_t pxQueue; + + pxQueue = xQueueGenericCreate( uxEventQueueLength, sizeof( Queue_t * ), queueQUEUE_TYPE_SET ); + + return pxQueue; + } + +#endif /* configUSE_QUEUE_SETS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + BaseType_t xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) + { + BaseType_t xReturn; + +//ToDo: figure out locking +// taskENTER_CRITICAL(&pxQueue->mux); + { + if( ( ( Queue_t * ) xQueueOrSemaphore )->pxQueueSetContainer != NULL ) + { + /* Cannot add a queue/semaphore to more than one queue set. */ + xReturn = pdFAIL; + } + else if( ( ( Queue_t * ) xQueueOrSemaphore )->uxMessagesWaiting != ( UBaseType_t ) 0 ) + { + /* Cannot add a queue/semaphore to a queue set if there are already + items in the queue/semaphore. */ + xReturn = pdFAIL; + } + else + { + ( ( Queue_t * ) xQueueOrSemaphore )->pxQueueSetContainer = xQueueSet; + xReturn = pdPASS; + } + } +// taskEXIT_CRITICAL(&pxQueue->mux); + + return xReturn; + } + +#endif /* configUSE_QUEUE_SETS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + BaseType_t xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) + { + BaseType_t xReturn; + Queue_t * const pxQueueOrSemaphore = ( Queue_t * ) xQueueOrSemaphore; + + if( pxQueueOrSemaphore->pxQueueSetContainer != xQueueSet ) + { + /* The queue was not a member of the set. */ + xReturn = pdFAIL; + } + else if( pxQueueOrSemaphore->uxMessagesWaiting != ( UBaseType_t ) 0 ) + { + /* It is dangerous to remove a queue from a set when the queue is + not empty because the queue set will still hold pending events for + the queue. */ + xReturn = pdFAIL; + } + else + { +// taskENTER_CRITICAL(&pxQueue->mux); + { + /* The queue is no longer contained in the set. */ + pxQueueOrSemaphore->pxQueueSetContainer = NULL; + } +// taskEXIT_CRITICAL(&pxQueue->mux); + xReturn = pdPASS; + } + + return xReturn; + } /*lint !e818 xQueueSet could not be declared as pointing to const as it is a typedef. */ + +#endif /* configUSE_QUEUE_SETS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + QueueSetMemberHandle_t xQueueSelectFromSet( QueueSetHandle_t xQueueSet, TickType_t const xTicksToWait ) + { + QueueSetMemberHandle_t xReturn = NULL; + + ( void ) xQueueGenericReceive( ( QueueHandle_t ) xQueueSet, &xReturn, xTicksToWait, pdFALSE ); /*lint !e961 Casting from one typedef to another is not redundant. */ + return xReturn; + } + +#endif /* configUSE_QUEUE_SETS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + QueueSetMemberHandle_t xQueueSelectFromSetFromISR( QueueSetHandle_t xQueueSet ) + { + QueueSetMemberHandle_t xReturn = NULL; + + ( void ) xQueueReceiveFromISR( ( QueueHandle_t ) xQueueSet, &xReturn, NULL ); /*lint !e961 Casting from one typedef to another is not redundant. */ + return xReturn; + } + +#endif /* configUSE_QUEUE_SETS */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_QUEUE_SETS == 1 ) + + static BaseType_t prvNotifyQueueSetContainer( const Queue_t * const pxQueue, const BaseType_t xCopyPosition ) + { + Queue_t *pxQueueSetContainer = pxQueue->pxQueueSetContainer; + BaseType_t xReturn = pdFALSE; + + /* This function must be called form a critical section. */ + + configASSERT( pxQueueSetContainer ); + configASSERT( pxQueueSetContainer->uxMessagesWaiting < pxQueueSetContainer->uxLength ); + + if( pxQueueSetContainer->uxMessagesWaiting < pxQueueSetContainer->uxLength ) + { + traceQUEUE_SEND( pxQueueSetContainer ); + /* The data copied is the handle of the queue that contains data. */ + xReturn = prvCopyDataToQueue( pxQueueSetContainer, &pxQueue, xCopyPosition ); + + if( listLIST_IS_EMPTY( &( pxQueueSetContainer->xTasksWaitingToReceive ) ) == pdFALSE ) + { + if( xTaskRemoveFromEventList( &( pxQueueSetContainer->xTasksWaitingToReceive ) ) != pdFALSE ) + { + /* The task waiting has a higher priority */ + xReturn = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + return xReturn; + } + +#endif /* configUSE_QUEUE_SETS */ + + + + + + + + + + + + diff --git a/components/freertos/readme_smp.txt b/components/freertos/readme_smp.txt new file mode 100644 index 000000000..0f7a66d74 --- /dev/null +++ b/components/freertos/readme_smp.txt @@ -0,0 +1,26 @@ +This version of FreeRTOS has been modified by Espressif to be SMP-aware. The +API is similar to the original FreeRTOS API, with the following changes: + +- The xTaskCreate() function now creates tasks that will run on the first +core only, for backwards compatibility. To schedule tasks on another core, +use xTaskCreatePinnedToCore(), which will accept a core ID as the last +argument. If this is the constant tskNO_AFFINITY, the task will be dynamically +scheduled on whichever core has time. + +- vTaskSuspendAll/vTaskResumeAll in non-SMP FreeRTOS will suspend the scheduler +so no other tasks than the current one will run. In this SMP version, it will +only suspend the scheduler ON THE CURRENT CORE. That is, tasks scheduled to +run on the other core(s) or without a specific CPU affinity, will still be +able to run. + +- Enabling and disabling interrupts will only affect the current core. +Disabling the interrupts will not disallow other tasks to run as +it would on a single-core system: the other core still will keep on +executing all it's own. Use a mux, queue or semaphore to protect your +structures instead. + +- While each core has individual interrupts, the handlers are shared. This +means that when you set a handler for an interrupt, it will get triggered if +the interrupt is triggered on both CPU0 as well as on CPU1. This is something +we may change in future FreeRTOS-esp32 releases. + diff --git a/components/freertos/readme_xtensa.txt b/components/freertos/readme_xtensa.txt new file mode 100644 index 000000000..1d8d246dc --- /dev/null +++ b/components/freertos/readme_xtensa.txt @@ -0,0 +1,769 @@ + FreeRTOS Port for Xtensa Configurable and Diamond Processors + ============================================================ + + FreeRTOS Version 8.2.0 + + +Introduction +------------ + +This document describes the Xtensa port for FreeRTOS multitasking RTOS. +For an introduction to FreeRTOS itself, please refer to FreeRTOS +documentation. + +This port currently works with version 8.2.0. + + +Xtensa Configuration Requirements and Restrictions +-------------------------------------------------- + +The Xtensa configurable architecture supports a vast space of processor +features. This port supports all of them, including custom processor +extensions defined in the TIE language, with certain minimum +requirements. You must use Xtensa Tools to compile and link FreeRTOS and +your application for your Xtensa configuration. The port uses the Xtensa +Hardware Abstraction Layer (HAL) to adapt to your Xtensa configuration. +NOTE: It may be possible to build and run this with the open-source +xtensa-linux tools provided you have the correct overlay for your Xtensa +configuration. However, this has not been tested and is currently not +supported by Cadence. + +This port includes optional reentrancy support for the 'newlib' C runtime +library that is distributed with Xtensa Tools, providing thread-safety on +a per task basis (for use in tasks only, not interrupt handlers). + +NOTE: At this time only the 'newlib' C library is supported for thread +safety. The 'xclib' and 'uclibc' libraries are not reentrant and do not +provide thread safety at this time. However, if you are not concerned +with reentrancy then you can use any of these libraries. + +This port also includes a simple example application that may run on +a supported board or the Xtensa instruction set simulator (ISS). There +are also a couple of test programs used in maintaining the port, which +serve as additional examples. + +FreeRTOS for Xtensa configurable processors requires the following minimum +processor configuration options: +- Timer interrupt option with at least one interruptible timer. +- Interrupt option (implied by the timer interrupt option). +- Exception Architecture 2 (XEA2). Please note that XEA1 is NOT supported. + All 'Diamond', 'Xtensa 6', 'Xtensa LX' and 'Xtensa LX2' processors and + most 'Xtensa T1050' processors are configured with XEA2. +All Diamond processor cores meet these requirements and are supported. + +Minimal support for certain evaluation boards is provided via a board +independent XTBSP API implemented by a board specific library distributed +with the Xtensa Tools. This provides the board clock frequency and basic +polled drivers for the display and console device. Note that XTBSP +is not a tradtional RTOS "board support package" with RTOS specific +interrupt-driven drivers - it is not specific to any RTOS. Note that +FreeRTOS can run on any Xtensa or Diamond board without this board support +(a "raw" platform), but you will have to provide the clock frequency +and drivers for any on-board devices you want to use. + + +Installation +------------ + +This port is downloaded in a ZIP file from FreeRTOS Web site. You will +also need to obtain the common FreeRTOS source package from FreeRTOS's +website in order to build the OS and applications. The Xtensa port files +are not currently included in the common package. + +All source is provided along with a Makefile that works for any host +platform supported by Xtensa Tools (Windows, Linux). These instructions +are written for Windows users, but can easily be understood and adapted +to other host platforms. + +First install the FreeRTOS common package in a directory of your choosing. +The structure of that package will look like this: + +FreeRTOS +|-- Demo +| |-- Common +| | |-- Minimal +| | `-- include +| | +| |-- Xtensa_XCC +| `-- ParTest +| +`-- Source + |-- include + `-- portable + |-- MemMang + `-- XCC + `-- Xtensa + +Since the Xtensa specific files are currently unavailable in the common +package, then you will need the separate zip file containing the Xtensa port +files. Extract from that zip file the Source/portable/XCC and Demo/Xtensa_XCC +folders and place them in the appropriate location under the common tree. + +The Xtensa Tools are available from Cadence as part of a processor +license. Be sure you have installed the Xtensa Tools and your processor +configuration. + + +Building FreeRTOS for Xtensa +---------------------------- + +The Makefiles are provided for your convenience and you do not need to +use them. Essentially you need to compile all the FreeRTOS common files, +the port files, and your application, and link them all. However all the +build instructions in this note use the Makefiles. + +By default, you will build for the Xtensa instruction set simulator. If +you have a supported emulation board, you can build to run on that. You +can also build to run on a raw Xtensa core with no board support, a +good starting point for supporting your own target platform. Cadence +recommends doing functional development on the simulator because it +is easier to debug with, then move to a board if/when you need to test +hardware drivers or real-time performance. + +The provided Makefile simplifies building FreeRTOS and the example +for your Xtensa configuration and platform (ISS, board, etc.). There +are detailed instructions in the comment at the top of the Makefile. +The test/Makefile provides similar support for building the tests, +and may be invoked directly from the top level Makefile. + +The Makefiles work on any host platform and support incremental builds. +The build for each Xtensa configuration and target platform is placed in +a subdirectory so several core and platform builds can co-exist even with +incremental rebuilds. You may specify the root of the build area (if tou +want it to be elsewhere than under the source tree) by defining BLDROOT +either in the make command or your shell environment. + +First, be sure you have installed Xtensa Tools and your processor +configuration, and be sure that Xtensa Tools are in your search path. +You can use xt-make, which comes with the Xtensa Tools, to run the +makefiles. + +Change directories to the Xtensa port directory: + +> cd FreeRTOS/Source/portable/XCC/Xtensa + +Now build the FreeRTOS RTOS as a library (libfreertos.a) as follows: + +> xt-make + +which by default builds for the simulator (TARGET=sim), or: + +> xt-make TARGET=board + +which builds for a supported board. Note that the board type does not +need to be specified when building the FreeRTOS library. + +If you are building for an Xtensa processor configuration that is not the +default you selected when you installed Xtensa Tools, you need to define the +environment variable XTENSA_CORE. If your configuration is not in the +default registry you selected when you installed Xtensa Tools, you also +need to define the environment variable XTENSA_SYSTEM. See tools manuals. +You can avoid defining these in your environment if you pass the variables +you need to redefine into xt-make as follows: + +> xt-make XTENSA_CORE= XTENSA_SYSTEM= ... + +There are more details about build options in the comment in the Makefile. + +After the library has been built, you must link your application with this +library in order to use FreeRTOS. + + +Building a FreeRTOS Application +------------------------------- + +The provided FreeRTOS example is designed to run on the Xtensa instruction +set simulator (ISS) or a supported evaluation board programmed with your +Xtensa processor configuration. + +To build the example for the default platform (simulator): + +> xt-make example + +which is the same as + +> xt-make example TARGET=sim + +The boards currently supported are the Xilinx ML605 and KC705 FPGA +development boards. To target these boards, type + +> xt-make example TARGET=ml605 + +or + +> xt-make example TARGET=kc705 + +To build in a location other than the default, specify the new location +using the BLDROOT variable. Note that this makefile will invoke the +FreeRTOS library build makefile automatically, passing on the relevant +parameters based on what you specified. + +You can override the default compilation options by specifying the new +options via CFLAGS. For example: + +> xt-make example TARGET=sim CFLAGS="-O2 -Os -g" + +This compiles example.c and links it with the FreeRTOS library +libfreertos.a and the appropriate linker-support package (LSP) for your +target platform (you can override the LSP by adding LSP= to the +xt-make command line). The resulting file example.exe is an ELF binary +file that can be downloaded and executed on the target. + +The example.exe binary appears in the platform specific subdirectory +described earlier. For the following commands, change to that directory +or prepend it as the path of example.exe. + +To build your application with thread-safe C library support using +the open-source 'newlib' library provided with the Xtensa Tools, you +need to make certain modifications to the application to plug in and +invoke the newlib reentrancy support. This allows each task to use +the library without interference with other tasks (it is not safe for +interrupt handlers to call the C library). + +First, you must define + + XT_USE_THREAD_SAFE_CLIB + +to a nonzero either in FreeRTOSConfig.h or in the compiler's command +line. + +Then, you must also make sure to allocate extra space on the stack for +each task that will use the C library reentrant functions. This extra +space is to be allocated over and above the actual stack space required +by the task itself. The define + + XT_STACK_EXTRA_CLIB + +specifies the amount of extra space to be added on to the stack to allow +saving the context for the C library as well as the coprocessors if any. +E.g. if your task requires 2000 bytes of stack space, you must allocate +(2000 + XT_STACK_EXTRA_CLIB) bytes for the stack. + +To build the example with thread-safe C library support: + +> xt-make CFLAGS="-O0 -DXT_USE_THREAD_SAFE_CLIB" example + +The "-O0" is necessary because you are overriding the default COPT=-O0. +You can specify any optimization level you require (if none, the compiler +defaults to -O2). + + +Running or Debugging an Application +----------------------------------- + +To execute the example application on the simulator: + +> xt-run [--turbo] example.exe + +The option --turbo provides much faster, but non-cycle-accurate simulation +(the --turbo option is only available with Xtensa Tools version 7 or later). + + +To execute on the simulator using the Xplorer GUI based debugger: + +> xplorer --debug example.exe + + +To execute on a supported evaluation board, download example.exe per +instructions in the tools manuals. Be sure the board has been programmed +with the correct configuration and is set up to boot from RAM and debug +a downloaded program! Optionally you may connect a terminal or terminal +emulator to the serial port on the board with settings as described in +the board user manual, and see the output of printf on the terminal. + +To obtain I/O on a "raw" platform such as an unsupported board, you need +to provide low level I/O drivers (eg. inbyte() and outbyte() for character +I/O if you want to use printf etc.). You can run "raw" executables on +any Xtensa platform, including simulator and any board, but you will not +see any behavior specific to the platform (eg. display, printed output, +stopping simulation at end of program). You can, while debugging, use a +debugger mechanism called GDBIO to obtain basic I/O. To use GDBIO, link +with the gdbio LSP. Refer to Xtensa tools documentation for details. + + +Task Stack Sizes +---------------- + +The application must ensure that every task has enough space for its +stack. Each task needs enough space for its own use, its own interrupt +stack frame (defined in xtensa_context.h) and space to save coprocessor +state, if any. Several factors influence the size of the stack required, +including the compiler optimization level and the use of the C library. +Calls to standard output functions such as printf() can use up a lot of +stack space. The tool xt-stack-usage is helpful in determining safe stack +sizes for your application. + +Some macros are provided in xtensa_config.h to help determine the stack +size for tasks that do and do not use the C library. Use these as the +basis for each task's stack size. They are minimum requirements taking +into account your configuration and use of the C library. In particular, +the define + + XT_STACK_MIN_SIZE + +defines the minimum stack size for any task. Be very careful if you try +to use a stack size smaller than this minimum. Stack overruns can cause +all kinds of hard-to-debug errors. It is recommended that you enable the +FreeRTOS stack checking features during development. + +WARNING: The newlib printf() function uses a lot of stack space. Be very +careful in using it. Optionally you can use the 'libxtutil' library for +output - it implements a subset of printf() that has smaller code size +and uses far less stack space. More information about this library is in +the Xtensa Tools documentation. + + +Interrupt Stack +--------------- + +Beginning with port version 1.2, the port uses a separate interrupt stack +for handling interrupts. Thus, it is no longer necessary for each task to +reserve space on its stack to handle interrupts. The size of the interrupt +stack is controlled by the parameter "configISR_STACK_SIZE" defined in +FreeRTOSConfig.h. Define this carefully to match your system requirements. + + +Assembler / Compiler Switches +----------------------------- + +The following are compiler switches are used by the provided +Makefile in building the FreeRTOS library and example application. +These can be modified by editing the Makefile or by overriding the +CFLAGS variable in the make command line, for example: + +> xt-make CFLAGS="-O2 -DXT_USE_THREAD_SAFE_CLIB" + + -g Specifies debug information. + -c Specifies object code generation. + -On Sets compiler optimization level n (default -O0). + -mlongcalls Allows assembler and linker to convert call + instructions to longer indirect call sequences + when target is out of range. + -x assembler-with-cpp Passes .s and .S files through C preprocessor. + -Dmacro Define a preprocessor macro with no value. + -Dmacro=value Define a preprocessor macro with a value. + +See the compiler / linker documentation for a full list of switches and +their use. + +Many definitions can be provided at compile-time via the -D option +without editing the source code. Here are some of the more useful ones: + + XT_USE_THREAD_SAFE_CLIB Enable support for the reentrancy to provide + thread-safety in the GNU newlib supplied with + Xtensa Tools. Default off. + + Note, the follwing defines are unique to the Xtensa port so have names + beginning with "XT_". + + XT_SIMULATOR Set this if building to run on the simulator. + Takes advantage of certain simulator control + and reporting facilities, and adjusts timing + of periodic tick to provide a more acceptable + performance in simulation (see XT_CLOCK_FREQ). + Set by default unless PLATFORM is overridden. + + XT_BOARD Set this if building for a supported board. + Be sure to specify the correct LSP for the + board. See the example makefile for usage. + + XT_CLOCK_FREQ=freq Specifies the target processor's clock + frequency in Hz. Used primarily to set the + timer that generates the periodic interrupt. + Defaults are provided and may be edited in + xtensa_timer.h (see comments there also). + Default for simulator provides more acceptable + performance, but cannot provide real-time + performance due to variation in simulation + speed per host platform and insufficient + cycles between interrupts to process them. + Supported board platforms by default leave + this undefined and compute the clock frequency + at initialization unless this is explicitly + defined. + + XT_TICK_PER_SEC=n Specifies the frequency of the periodic tick. + + XT_TIMER_INDEX=n Specifies which timer to use for periodic tick. + Set this if your Xtensa processor configuration + provides more than one suitable timer and you + want to override the default. See xtensa_timer.h . + + XT_INTEXC_HOOKS Enables hooks in interrupt vector handlers + to support dynamic installation of exception + and interrupt handlers. Disabled by default. + + XT_USE_OVLY Enable code overlay support. It uses a mutex, + hence configUSE_MUTEX must be enabled. This + option is currently unsupported. + + XT_USE_SWPRI Enable software prioritization of interrupts. + Enabling this will prioritize interrupts with + higher bit numbers over those with lower bit + numbers at the same level. This works only for + low and medium priority interrupts that can be + dispatched to C handlers. + + +Register Usage and Stack Frames +------------------------------- + +The Xtensa architecture specifies two ABIs that determine how the general +purpose registers a0-a15 are used: the standard windowed ABI use with +the Xtensa windowed register file architecture, and the optional and +more conventional Call0 ABI (required for Xtensa configurations without +a windowed register file). + +Xtensa processors may have other special registers (including co-processor +registers and other TIE "states") that are independent of this choice +of ABI. See Xtensa documentation for more details. + +In the windowed ABI the registers of the current window are used as follows: + a0 = return address + a1 = stack pointer (alias sp) + a2 = first argument and result of call (in simple cases) + a3-7 = second through sixth arguments of call (in simple cases). + Note that complex or large arguments are passed on the + stack. Details are in the Xtensa Tools manuals. + a8-a15 = available for use as temporaries. +There are no callee-save registers. The windowed hardware automatically +saves registers a0-a3 on a call4, a0-a8 on a call8, a0-a12 on a call12, +by rotating the register window. Hardware triggers window overflow and +underflow exceptions as necessary when registers outside the current +window need to be spilled to preallocated space in the stack frame, or +restored. Complete details are in the Xtensa manuals. The entire windowed +register file is saved and restored on interrupt or task context switch. + +The Call0 ABI does not make use of register windows, relying instead +on a fixed set of 16 registers without window rotation. +The Call0 ABI is more conventional and uses registers as follows: + a0 = return address + a1 = stack pointer (alias sp) + a2 = first argument and result of call (in simple cases) + a3-7 = second through sixth arguments of call (in simple cases). + Note that complex or large arguments are passed on the + stack. Details are in the Xtensa Tools manuals. + a8-a11 = scratch. + a12-a15 = callee-save (a function must preserve these for its caller). +On a FreeRTOS API call, callee-save registers are saved only when a task +context switch occurs, and other registers are not saved at all (the caller +does not expect them to be preserved). On an interrupt, callee-saved +registers might only be saved and restored when a task context-switch +occurs, but all other registers are always saved and restored. + +An Xtensa processor has other special registers independent of the ABI, +depending on the configuration (including co-processor registers and other +TIE state) that are part of the task context. FreeRTOS preserves all such +registers over an unsolicited context-switch triggered by an interrupt. +However it does NOT preserve these over a solicited context-switch during +a FreeRTOS API call. This bears some explanation. These special registers +are either ignored by the compiler or treated as caller-saved, meaning +that if kept "live" over a function call (ie. need to be preserved) +they must be saved and restored by the caller. Since solicited entry to +FreeRTOS is always made by a function call, FreeRTOS assumes the caller +has saved any of these registers that are "live". FreeRTOS avoids a lot +of overhead by not having to save and restore every special register +(there can be many) on every solicited context switch. + +As a consequence, the application developer should NOT assume that special +registers are preserved over a FreeRTOS API call such as vTaskDelay(). +If multiple tasks use a register, the caller must save and restore it. + +The saved context stack frames for context switches that occur as +a result of interrupt handling (interrupt frame) or from task-level +API calls (solicited frame) are described in human readable form in +xtensa_context.h . All suspended tasks have one of these two types +of stack frames. The top of the suspended task's stack is pointed to +by pxCurrentTCB->pxTopOfStack. A special location common to both stack +frames differentiates solicited and interrupt stack frames. + + +Improving Performance, Footprint, or Ease of Debugging +------------------------------------------------------ + +By default FreeRTOS for Xtensa is built with debug (-g) and without +compiler optimizations (-O0). This makes debugging easier. Of course, +-O0 costs performance and usually also increases stack usage. To make +FreeRTOS run faster you can change the Makefile to enable the desired +optimizations or set a predefined optimization level (-O) . + +Maximum performance is achieved with -O3 -ipa, but that might increase +the footprint substantially. A good compromise is -O2. See the compiler +manual for details. + +Minimal footprint is achieved by optimizing for space with -Os, at the +cost of some performance. See the compiler manual for details. + +The Xtensa architecture port-specific assembly files are coded with no +file-scope labels inside functions (all labels inside functions begin with +".L"). This allows a profiler to accurately associate an address with a +function, and also allows the debugger's stack trace to show the correct +function wherever the program counter is within that function. However +there are some tradeoffs in debugging. Local (".L") labels are not +visible to the debugger, so the following limitations may be observed +during debugging: +- You cannot set a breakpoint on a local label inside a function. +- Disassembly will show the entire function, but will get out of sync and + show incorrect opcodes if it crosses any padding before an aligned local + branch target (".L" label, not ".Ln"). Restart disassembly specifying an + address range explicitly between points where there is padding. +Since FreeRTOS is provided in source form, it is not difficult to remove +the ".L" and ".Ln" prefixes from local labels if you want them visible. +They can also be made visible by passing the '-L' option to the assembler +and linker (see the assembler and linker manuals for details). + + +Interrupt and Exception Handling +-------------------------------- + +FreeRTOS provides a complete set of efficient exception and first-level +interrupt handlers installed at the appropriate exception and interrupt +vector locations. The Xtensa architecture supports several different +classes of exceptions and interrupts. Being a configurable architecture, +many of these are optional, and the vector locations are determined by +your processor configuration. (Note that Diamond cores are pre-configured +with specific vector locations.) The handlers provided use conditional +compilation to adapt to your processor configuration and include only +the code that is needed. + +Xtensa vector locations may reside almost anywhere, including in ROM. +The amount of code space available at each of these locations is +often very small (e.g. due to following vectors). A small stub of +code installed at the vector jumps to the corresponding handler, +usually in RAM. The exception and interrupt handlers are defined in +xtensa_vectors.S. They are not specific to FreeRTOS, but call into +FreeRTOS where appropriate via macros defined in xtensa_rtos.h . + +The handlers provided for low and medium priority interrupts are just +dispatchers that save relevant state and call user-definable handlers. +See the files xtensa_vectors.S and xtensa_api.h for more details of how +to create and install application-specific user interrupt handlers. +Similarly, user-defined handlers can be installed for exceptions (other +than a few which are always handled by the OS). + +The high priority interrupt handlers provided may be considered templates +into which the application adds code to service specific interrupts. +The places where application handlers should be inserted are tagged with +the comment "USER_EDIT" in xtensa_vectors.S. + +This FreeRTOS port supports strict priority-based nesting of interrupts. +An interrupt may only nest on top of one of strictly lower priority. +Equal priority interrupts concurrently pending are handled in an +application-defined sequence before any lower priority interrupts +are handled. During interrupt and exception handling, the processor's +interrupt level (PS.INTLEVEL) is used to control the interrupt priority +level that can be accepted; interrupt sources are not controlled +individually by FreeRTOS (the application is free to access the INTENABLE +register directly to enable/disable individual interrupts, eg. using +Xtensa HAL services). This approach provides the most deterministic +bounds on interrupt latency (for a given priority) and stack depth. + +Software prioritization of interrupts at the same priority is controlled +by the definition of XT_USE_SWPRI. See above for a description of this +parameter. + +The following subsections describe the handling of each class of exception +and interrupt in more detail. Many have nothing to do with FreeRTOS but +are mentioned because there is code to handle them in xtensa_vectors.S. + +User Exception and Interrupt Handler (Low/Medium Priority): + + All Xtensa 'general exceptions' come to the user, kernel, or double + exception vector. The exception type is identified by the EXCCAUSE + special register (level 1 interrupts are one particular cause of a + general exception). This port sets up PS to direct all such exceptions + to the user vector. Exceptions taken at the other two vectors usually + indicate a kernel or application bug. + + Level 1 interrupts are identified at the beginning of the handler + and are dispatched to a dedicated handler. Then, syscall and alloca + exceptions are identified and dispatched to special handlers described + below. After this, coprocessor exceptions are identified and dispatched + to the coprocessor handler. + + Any remaining exceptions are processed as follows: + + Having allocated the exception stack frame, the user exception handler + saves the current task state and sets up a C environment and enables + the high-priority class of interrupts (which do not interact with + FreeRTOS), then reads EXCCAUSE and uses the cause (number) to index + into a table of user-specified handlers. The correct handler is then + called. If the handler returns, the context is restored and control is + returned to the code that caused the exception. The user-defined handler + may alter the saved context, or any other system state, that allows the + faulting instruction to be retried. + + If the cause is a level 1 (low-priority) or medium-priority interrupt, + the handler enables all interrupts above that priority level after + saving the task context. It then sets up the environment for C code + and then calls the handler (found in the handler table) for the + interrupt number. If the user has not specified a handler, then the + default handler will be called, which will terminate the program. + + If the interrupt is for the system timer, it calls a special interrupt + handler for the system timer tick, which calls _frxt_timer_int then + clears its bit from the mask. This interrupt cannot be hooked by the + user-defined handler. + + Finally, the handler calls _frxt_int_exit to allow FreeRTOS to perform + any scheduling necessary and return either to the interrupted task + or another. + + If software prioritization is enabled, the handler will re-enable all + interrupts at the same level that are numerically higher than the current + one, before calling the user handler. This allows a higher priority + interrupt to pre-empt the lower priority handler. + +Medium Priority Interrupt Handlers: + + Medium priority interrupts are those at levels 2 up to XCHAL_EXCM_LEVEL, + a configuration-specific maximum interrupt level affected by the global + 'exception mode' bit in the processor status word (PS.EXCM). + Interrupt levels above XCHAL_EXCM_LEVEL are of the high-priority class. + The Xtensa hardware documentation considers medium priority interrupts + to be a special case of high-priority interrupts, but from a software + perspective they are very different. + + Dispatch of medium-priority interrupts is discussed in the section + above. + +High Priority Interrupt Handlers: + + High priority interrupts are those strictly above XCHAL_EXCM_LEVEL, + a configuration-specific maximum interrupt level affected by the + global 'exception mode' bit in the processor status word (PS.EXCM). + High priority handlers may not directly interact with FreeRTOS at all, + and are described here only for the sake of completeness. They must + be coded in assembler (may not be coded in C) and are intended to be + used for handling extremely high frequency hardware events that need + to be handled in only a few cycles. A high priority interrupt handler + may trigger a software interrupt at a medium or low priority level to + occasionally signal FreeRTOS. Please see Xtensa documentation. + + There is a separate vector and a few special registers for each high + priority interrupt, providing for fast dispatch and efficient nesting + on top of lower priority interrupts. Handlers are templates included + only for the vectors that exist in your Xtensa processor configuration. + These templates are written for only one interrupt per high priority + level to minimize latency servicing very fast time-critical interrupts. + The vector code jumps to the corresponding first-level interrupt handler, + which then executes application-provided assembler code before returning + quickly to the interrupted task or lower priority handler. + +Kernel Exception Handler: + + Kernel mode is not used in this port of FreeRTOS, and therefore kernel + exceptions should not happen. A stub is provided for the vector that + triggers the debugger (if connected) or calls _xt_panic to freeze the + processor should a kernel exception occur. + +Alloca Exception Handler: + + Alloca exceptions are generated by the 'movsp' instruction, which + is used only in the windowed ABI. Its purpose is to allocate some + space on top of the stack. Because the window hardware may have + spilled some registers to the 16 byte "base save" area below the + stack pointer, it is necessary to protect those values. The alloca + handler accomplishes this quickly without setting up an interrupt + frame or entering FreeRTOS, by emulating a register underflow and + re-executing 'movsp'. + +Syscall Exception Handler: + + Syscall exceptions are generated by a 'syscall' instruction. + The windowed ABI specifies that executing this instruction with + a value of zero in register a2 must spill any unsaved registers + in the windowed register file to their pre-determined locations + on the caller's stack. The handler does exactly that, and skips + over the 'syscall' instruction before returning to the caller. + If a2 is non-zero, the handler returns a2 == -1 to the caller. + +Co-Processor Exception Handler: + + A co-processor exception is generated when a task accesses a + co-processor that it does not "own". Ownership represents which + task's state is currently in the co-processor. Co-processors are + context-switched "lazily" (on demand) only when a non-owning task + uses a co-processor instruction, otherwise a task retains ownership + even when it is preempted from the main processor. The co-processor + exception handler performs the context-switch and manages ownership. + + Co-processors may not be used by any code outside the context of a + task. A co-processor exception triggered by code that is not part + of a running task is a fatal error and FreeRTOS for Xtensa will panic. + This restriction is intended to reduce the overhead of saving and + restoring co-processor state (which can be quite large) and in + particular remove that overhead from interrupt handlers. + +Debug Exception Handler: + + A debug exception is caused as a result of running code, such as by + a 'break' instruction or hardware breakpoints and watchpoints, or + as a result of an external debug interrupt, such as from an OCD based + debugger or multiprocessor debug events ("breakin/breakout"). If the + processor is running in OCD mode under control of an OCD-based debugger, + the trigger event immediately halts the processor and gives control to + the OCD debugger. Otherwise control is transferred to the debug vector. + The debug vector handler calls the simulator if running on the ISS, + which then takes control and interacts with any attached debugger. + If running on hardware and not in OCD mode, debug exceptions are not + expected, so the debug handler calls _xt_panic to freeze the processor. + +Double Exception Handler: + + A double exception is a general exception that happens while the + processor is in exception mode (PS.EXCM set), and thus indicates a + bug in kernel code. The double exception vector handler triggers + the debugger (if connected) or calls _xt_panic to freeze the + processor. + +Window Overflow and Underflow Exception Handlers: + + Window overflow and underflow handlers are required for use of the + windowed ABI. Each has its own dedicated vector and highly optimized + code that is independent of OS. See Xtensa documentation for details. + +Hooks for Dynamic Installation of Handlers: + + Optional hooks are provided in the user exception and low level + interrupt handler and all medium and high priority interrupt handlers, + to dynamically install a handler function (which may be coded in C, + unless in a high-priority interrupt handler). These hooks are enabled + and used by automatic regression tests, they are not part of a normal + FreeRTOS build. However an application is free to take advantage of + them. The interrupt/exception hooks are described in xtensa_rtos.h . + + It is recommended that the application not make use of these hooks, but + rather use xt_set_interrupt_handler() and xt_set_exception_handler() + to install application-specific handlers. This method is more convenient + and allows arguments to be passed to the handlers. Software prioritization + of interrupts works only with this method. See xtensa_api.h for details. + +Overlay Support + + Code overlays are currently not supported for FreeRTOS. This will be + supported in a future release. Make sure that the option XT_USE_OVLY is + never defined when building. + + +Note on Porting Methodology and Copyrights +------------------------------------------ + +This port is based on a well-tested Cadence RTOS porting layer +that abstracts out Xtensa-generic aspects from the RTOS specifics +in the same way most RTOSes abstract out their generic code from the +architecture specific port code. This code is common to several RTOSes +ported by Cadence, and deals with highly Xtensa specific aspects such +as context save/restore, interrupt and exception dispatch, and handling +of co-processor, alloc and window over/underflow exceptions. + +The porting layer files are prefixed "xtensa_" and belong to Cadence +(they are provided freely as part of this port but are not subject to +FreeRTOS's copyright). The rest of the port is FreeRTOS specific and +are under FreeRTOS's copyright. + +The Makefiles are also provided by Cadence so have much in common with +other RTOS Makefiles provided by Cadence. + +-End- + diff --git a/components/freertos/stdint.readme b/components/freertos/stdint.readme new file mode 100644 index 000000000..4414c29ed --- /dev/null +++ b/components/freertos/stdint.readme @@ -0,0 +1,27 @@ + +#ifndef FREERTOS_STDINT +#define FREERTOS_STDINT + +/******************************************************************************* + * THIS IS NOT A FULL stdint.h IMPLEMENTATION - It only contains the definitions + * necessary to build the FreeRTOS code. It is provided to allow FreeRTOS to be + * built using compilers that do not provide their own stdint.h definition. + * + * To use this file: + * + * 1) Copy this file into the directory that contains your FreeRTOSConfig.h + * header file, as that directory will already be in the compilers include + * path. + * + * 2) Rename the copied file stdint.h. + * + */ + +typedef signed char int8_t; +typedef unsigned char uint8_t; +typedef short int16_t; +typedef unsigned short uint16_t; +typedef long int32_t; +typedef unsigned long uint32_t; + +#endif /* FREERTOS_STDINT */ diff --git a/components/freertos/tasks.c b/components/freertos/tasks.c new file mode 100644 index 000000000..d747708eb --- /dev/null +++ b/components/freertos/tasks.c @@ -0,0 +1,4535 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* Standard includes. */ +#include +#include + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +#include "rom/ets_sys.h" + +/* FreeRTOS includes. */ +#include "FreeRTOS.h" +#include "task.h" +#include "timers.h" +#include "StackMacros.h" +#include "portmacro.h" + +/* Lint e961 and e750 are suppressed as a MISRA exception justified because the +MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the +header files above, but not in this file, in order to generate the correct +privileged Vs unprivileged linkage and placement. */ +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */ + +/* Set configUSE_STATS_FORMATTING_FUNCTIONS to 2 to include the stats formatting +functions but without including stdio.h here. */ +#if ( configUSE_STATS_FORMATTING_FUNCTIONS == 1 ) + /* At the bottom of this file are two optional functions that can be used + to generate human readable text from the raw data generated by the + uxTaskGetSystemState() function. Note the formatting functions are provided + for convenience only, and are NOT considered part of the kernel. */ + #include +#endif /* configUSE_STATS_FORMATTING_FUNCTIONS == 1 ) */ + +/* Sanity check the configuration. */ +#if configUSE_TICKLESS_IDLE != 0 + #if INCLUDE_vTaskSuspend != 1 + #error INCLUDE_vTaskSuspend must be set to 1 if configUSE_TICKLESS_IDLE is not set to 0 + #endif /* INCLUDE_vTaskSuspend */ +#endif /* configUSE_TICKLESS_IDLE */ + +/* + * Defines the size, in words, of the stack allocated to the idle task. + */ +#define tskIDLE_STACK_SIZE configMINIMAL_STACK_SIZE + +#if( configUSE_PREEMPTION == 0 ) + /* If the cooperative scheduler is being used then a yield should not be + performed just because a higher priority task has been woken. */ + #define taskYIELD_IF_USING_PREEMPTION() + #define queueYIELD_IF_USING_PREEMPTION_MUX(mux) +#else + #define taskYIELD_IF_USING_PREEMPTION() portYIELD_WITHIN_API() + #define taskYIELD_IF_USING_PREEMPTION_MUX(mux) { \ + taskEXIT_CRITICAL(mux); \ + portYIELD_WITHIN_API(); \ + taskENTER_CRITICAL(mux); \ + } while(0) +#endif + +/* Value that can be assigned to the eNotifyState member of the TCB. */ +typedef enum +{ + eNotWaitingNotification = 0, + eWaitingNotification, + eNotified +} eNotifyValue; + +/* + * Task control block. A task control block (TCB) is allocated for each task, + * and stores task state information, including a pointer to the task's context + * (the task's run time environment, including register values) + */ +typedef struct tskTaskControlBlock +{ + volatile StackType_t *pxTopOfStack; /*< Points to the location of the last item placed on the tasks stack. THIS MUST BE THE FIRST MEMBER OF THE TCB STRUCT. */ + + #if ( portUSING_MPU_WRAPPERS == 1 ) + xMPU_SETTINGS xMPUSettings; /*< The MPU settings are defined as part of the port layer. THIS MUST BE THE SECOND MEMBER OF THE TCB STRUCT. */ + BaseType_t xUsingStaticallyAllocatedStack; /* Set to pdTRUE if the stack is a statically allocated array, and pdFALSE if the stack is dynamically allocated. */ + #endif + + ListItem_t xGenericListItem; /*< The list that the state list item of a task is reference from denotes the state of that task (Ready, Blocked, Suspended ). */ + ListItem_t xEventListItem; /*< Used to reference a task from an event list. */ + UBaseType_t uxPriority; /*< The priority of the task. 0 is the lowest priority. */ + StackType_t *pxStack; /*< Points to the start of the stack. */ + char pcTaskName[ configMAX_TASK_NAME_LEN ];/*< Descriptive name given to the task when created. Facilitates debugging only. */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + BaseType_t xCoreID; /*< Core this task is pinned to */ + + #if ( portSTACK_GROWTH > 0 ) + StackType_t *pxEndOfStack; /*< Points to the end of the stack on architectures where the stack grows up from low memory. */ + #endif + + #if ( portCRITICAL_NESTING_IN_TCB == 1 ) + UBaseType_t uxCriticalNesting; /*< Holds the critical section nesting depth for ports that do not maintain their own count in the port layer. */ + #endif + + #if ( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxTCBNumber; /*< Stores a number that increments each time a TCB is created. It allows debuggers to determine when a task has been deleted and then recreated. */ + UBaseType_t uxTaskNumber; /*< Stores a number specifically for use by third party trace code. */ + #endif + + #if ( configUSE_MUTEXES == 1 ) + UBaseType_t uxBasePriority; /*< The priority last assigned to the task - used by the priority inheritance mechanism. */ + UBaseType_t uxMutexesHeld; + #endif + + #if ( configUSE_APPLICATION_TASK_TAG == 1 ) + TaskHookFunction_t pxTaskTag; + #endif + + #if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 ) + void *pvThreadLocalStoragePointers[ configNUM_THREAD_LOCAL_STORAGE_POINTERS ]; + #endif + + #if ( configGENERATE_RUN_TIME_STATS == 1 ) + uint32_t ulRunTimeCounter; /*< Stores the amount of time the task has spent in the Running state. */ + #endif + + #if ( configUSE_NEWLIB_REENTRANT == 1 ) + /* Allocate a Newlib reent structure that is specific to this task. + Note Newlib support has been included by popular demand, but is not + used by the FreeRTOS maintainers themselves. FreeRTOS is not + responsible for resulting newlib operation. User must be familiar with + newlib and must provide system-wide implementations of the necessary + stubs. Be warned that (at the time of writing) the current newlib design + implements a system-wide malloc() that must be provided with locks. */ + struct _reent xNewLib_reent; + #endif + + #if ( configUSE_TASK_NOTIFICATIONS == 1 ) + volatile uint32_t ulNotifiedValue; + volatile eNotifyValue eNotifyState; + #endif + +} tskTCB; + +/* The old tskTCB name is maintained above then typedefed to the new TCB_t name +below to enable the use of older kernel aware debuggers. */ +typedef tskTCB TCB_t; + +/* + * Some kernel aware debuggers require the data the debugger needs access to to + * be global, rather than file scope. + */ +#ifdef portREMOVE_STATIC_QUALIFIER + #define static +#endif + +/*lint -e956 A manual analysis and inspection has been used to determine which +static variables must be declared volatile. */ + +PRIVILEGED_DATA TCB_t * volatile pxCurrentTCB[ portNUM_PROCESSORS ] = { NULL }; + +/* Lists for ready and blocked tasks. --------------------*/ +PRIVILEGED_DATA static List_t pxReadyTasksLists[ configMAX_PRIORITIES ];/*< Prioritised ready tasks. */ +PRIVILEGED_DATA static List_t xDelayedTaskList1; /*< Delayed tasks. */ +PRIVILEGED_DATA static List_t xDelayedTaskList2; /*< Delayed tasks (two lists are used - one for delays that have overflowed the current tick count. */ +PRIVILEGED_DATA static List_t * volatile pxDelayedTaskList; /*< Points to the delayed task list currently being used. */ +PRIVILEGED_DATA static List_t * volatile pxOverflowDelayedTaskList; /*< Points to the delayed task list currently being used to hold tasks that have overflowed the current tick count. */ +PRIVILEGED_DATA static List_t xPendingReadyList; /*< Tasks that have been readied while the scheduler was suspended. They will be moved to the ready list when the scheduler is resumed. */ + +#if ( INCLUDE_vTaskDelete == 1 ) + + PRIVILEGED_DATA static List_t xTasksWaitingTermination; /*< Tasks that have been deleted - but their memory not yet freed. Protected by xTaskQueueMutex.*/ + PRIVILEGED_DATA static volatile UBaseType_t uxTasksDeleted = ( UBaseType_t ) 0U; + +#endif + +#if ( INCLUDE_vTaskSuspend == 1 ) + + PRIVILEGED_DATA static List_t xSuspendedTaskList; /*< Tasks that are currently suspended. */ + +#endif + +#if ( INCLUDE_xTaskGetIdleTaskHandle == 1 ) + + PRIVILEGED_DATA static TaskHandle_t xIdleTaskHandle = NULL; /*< Holds the handle of the idle task. The idle task is created automatically when the scheduler is started. */ + +#endif + +/* Other file private variables. --------------------------------*/ +PRIVILEGED_DATA static volatile UBaseType_t uxCurrentNumberOfTasks = ( UBaseType_t ) 0U; +PRIVILEGED_DATA static volatile TickType_t xTickCount = ( TickType_t ) 0U; +PRIVILEGED_DATA static volatile UBaseType_t uxTopReadyPriority = tskIDLE_PRIORITY; +PRIVILEGED_DATA static volatile BaseType_t xSchedulerRunning = pdFALSE; +PRIVILEGED_DATA static volatile UBaseType_t uxPendedTicks = ( UBaseType_t ) 0U; +PRIVILEGED_DATA static volatile BaseType_t xYieldPending = pdFALSE; +PRIVILEGED_DATA static volatile BaseType_t xNumOfOverflows = ( BaseType_t ) 0; +PRIVILEGED_DATA static UBaseType_t uxTaskNumber = ( UBaseType_t ) 0U; +PRIVILEGED_DATA static volatile TickType_t xNextTaskUnblockTime = portMAX_DELAY; + +/* Context switches are held pending while the scheduler is suspended. Also, +interrupts must not manipulate the xGenericListItem of a TCB, or any of the +lists the xGenericListItem can be referenced from, if the scheduler is suspended. +If an interrupt needs to unblock a task while the scheduler is suspended then it +moves the task's event list item into the xPendingReadyList, ready for the +kernel to move the task from the pending ready list into the real ready list +when the scheduler is unsuspended. The pending ready list itself can only be +accessed from a critical section. */ +PRIVILEGED_DATA static volatile UBaseType_t uxSchedulerSuspended[ portNUM_PROCESSORS ] = { ( UBaseType_t ) pdFALSE }; + +/* Muxes used in the task code */ +PRIVILEGED_DATA static portBASE_TYPE xMutexesInitialised = pdFALSE; +/* For now, we use just one mux for all the critical sections. ToDo: give evrything a bit more granularity; + that could improve performance by not needlessly spinning in spinlocks for unrelated resources. */ +PRIVILEGED_DATA static portMUX_TYPE xTaskQueueMutex; +PRIVILEGED_DATA static portMUX_TYPE xTickCountMutex; + +#if ( configGENERATE_RUN_TIME_STATS == 1 ) + + PRIVILEGED_DATA static uint32_t ulTaskSwitchedInTime = 0UL; /*< Holds the value of a timer/counter the last time a task was switched in. */ + PRIVILEGED_DATA static uint32_t ulTotalRunTime = 0UL; /*< Holds the total amount of execution time as defined by the run time counter clock. */ + +#endif + +/*lint +e956 */ + +/* Debugging and trace facilities private variables and macros. ------------*/ + +/* + * The value used to fill the stack of a task when the task is created. This + * is used purely for checking the high water mark for tasks. + */ +#define tskSTACK_FILL_BYTE ( 0xa5U ) + +/* + * Macros used by vListTask to indicate which state a task is in. + */ +#define tskBLOCKED_CHAR ( 'B' ) +#define tskREADY_CHAR ( 'R' ) +#define tskDELETED_CHAR ( 'D' ) +#define tskSUSPENDED_CHAR ( 'S' ) + +/*-----------------------------------------------------------*/ + + +#if ( configUSE_PORT_OPTIMISED_TASK_SELECTION == 0 ) + + /* If configUSE_PORT_OPTIMISED_TASK_SELECTION is 0 then task selection is + performed in a generic way that is not optimised to any particular + microcontroller architecture. */ + + /* uxTopReadyPriority holds the priority of the highest priority ready + state task. */ + #define taskRECORD_READY_PRIORITY( uxPriority ) \ + { \ + if( ( uxPriority ) > uxTopReadyPriority ) \ + { \ + uxTopReadyPriority = ( uxPriority ); \ + } \ + } /* taskRECORD_READY_PRIORITY */ + + /*-----------------------------------------------------------*/ + + #define taskSELECT_HIGHEST_PRIORITY_TASK() \ + { \ + /* Find the highest priority queue that contains ready tasks. */ \ + while( listLIST_IS_EMPTY( &( pxReadyTasksLists[ uxTopReadyPriority ] ) ) ) \ + { \ + configASSERT( uxTopReadyPriority ); \ + --uxTopReadyPriority; \ + } \ + \ + /* listGET_OWNER_OF_NEXT_ENTRY indexes through the list, so the tasks of \ + the same priority get an equal share of the processor time. */ \ + listGET_OWNER_OF_NEXT_ENTRY( pxCurrentTCB[ xPortGetCoreID() ], &( pxReadyTasksLists[ uxTopReadyPriority ] ) ); \ + } /* taskSELECT_HIGHEST_PRIORITY_TASK */ + + /*-----------------------------------------------------------*/ + + /* Define away taskRESET_READY_PRIORITY() and portRESET_READY_PRIORITY() as + they are only required when a port optimised method of task selection is + being used. */ + #define taskRESET_READY_PRIORITY( uxPriority ) + #define portRESET_READY_PRIORITY( uxPriority, uxTopReadyPriority ) + +#else /* configUSE_PORT_OPTIMISED_TASK_SELECTION */ + + /* If configUSE_PORT_OPTIMISED_TASK_SELECTION is 1 then task selection is + performed in a way that is tailored to the particular microcontroller + architecture being used. */ + + /* A port optimised version is provided. Call the port defined macros. */ + #define taskRECORD_READY_PRIORITY( uxPriority ) portRECORD_READY_PRIORITY( uxPriority, uxTopReadyPriority ) + + /*-----------------------------------------------------------*/ + + #define taskSELECT_HIGHEST_PRIORITY_TASK() \ + { \ + UBaseType_t uxTopPriority; \ + \ + /* Find the highest priority queue that contains ready tasks. */ \ + portGET_HIGHEST_PRIORITY( uxTopPriority, uxTopReadyPriority ); \ + configASSERT( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ uxTopPriority ] ) ) > 0 ); \ + listGET_OWNER_OF_NEXT_ENTRY( pxCurrentTCB[ xPortGetCoreID() ], &( pxReadyTasksLists[ uxTopPriority ] ) ); \ + } /* taskSELECT_HIGHEST_PRIORITY_TASK() */ + + /*-----------------------------------------------------------*/ + + /* A port optimised version is provided, call it only if the TCB being reset + is being referenced from a ready list. If it is referenced from a delayed + or suspended list then it won't be in a ready list. */ + #define taskRESET_READY_PRIORITY( uxPriority ) \ + { \ + if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ ( uxPriority ) ] ) ) == ( UBaseType_t ) 0 ) \ + { \ + portRESET_READY_PRIORITY( ( uxPriority ), ( uxTopReadyPriority ) ); \ + } \ + } + +#endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */ + +/*-----------------------------------------------------------*/ + +/* pxDelayedTaskList and pxOverflowDelayedTaskList are switched when the tick +count overflows. */ +#define taskSWITCH_DELAYED_LISTS() \ +{ \ + List_t *pxTemp; \ + \ + /* The delayed tasks list should be empty when the lists are switched. */ \ + configASSERT( ( listLIST_IS_EMPTY( pxDelayedTaskList ) ) ); \ + \ + pxTemp = pxDelayedTaskList; \ + pxDelayedTaskList = pxOverflowDelayedTaskList; \ + pxOverflowDelayedTaskList = pxTemp; \ + xNumOfOverflows++; \ + prvResetNextTaskUnblockTime(); \ +} + +/*-----------------------------------------------------------*/ + +/* + * Place the task represented by pxTCB into the appropriate ready list for + * the task. It is inserted at the end of the list. + */ +#define prvAddTaskToReadyList( pxTCB ) \ + traceMOVED_TASK_TO_READY_STATE( pxTCB ) \ + taskRECORD_READY_PRIORITY( ( pxTCB )->uxPriority ); \ + vListInsertEnd( &( pxReadyTasksLists[ ( pxTCB )->uxPriority ] ), &( ( pxTCB )->xGenericListItem ) ) +/*-----------------------------------------------------------*/ + +/* + * Several functions take an TaskHandle_t parameter that can optionally be NULL, + * where NULL is used to indicate that the handle of the currently executing + * task should be used in place of the parameter. This macro simply checks to + * see if the parameter is NULL and returns a pointer to the appropriate TCB. + */ +/* ToDo: See if this still works for multicore. */ +#define prvGetTCBFromHandle( pxHandle ) ( ( ( pxHandle ) == NULL ) ? ( TCB_t * ) pxCurrentTCB[ xPortGetCoreID() ] : ( TCB_t * ) ( pxHandle ) ) + +/* The item value of the event list item is normally used to hold the priority +of the task to which it belongs (coded to allow it to be held in reverse +priority order). However, it is occasionally borrowed for other purposes. It +is important its value is not updated due to a task priority change while it is +being used for another purpose. The following bit definition is used to inform +the scheduler that the value should not be changed - in which case it is the +responsibility of whichever module is using the value to ensure it gets set back +to its original value when it is released. */ +#if configUSE_16_BIT_TICKS == 1 + #define taskEVENT_LIST_ITEM_VALUE_IN_USE 0x8000U +#else + #define taskEVENT_LIST_ITEM_VALUE_IN_USE 0x80000000UL +#endif + +/* Callback function prototypes. --------------------------*/ +#if configCHECK_FOR_STACK_OVERFLOW > 0 + extern void vApplicationStackOverflowHook( TaskHandle_t xTask, char *pcTaskName ); +#endif + +#if configUSE_TICK_HOOK > 0 + extern void vApplicationTickHook( void ); +#endif + +/* File private functions. --------------------------------*/ + +/* + * Utility to ready a TCB for a given task. Mainly just copies the parameters + * into the TCB structure. + */ +static void prvInitialiseTCBVariables( TCB_t * const pxTCB, const char * const pcName, UBaseType_t uxPriority, const MemoryRegion_t * const xRegions, const uint16_t usStackDepth, const BaseType_t xCoreID ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * Utility task that simply returns pdTRUE if the task referenced by xTask is + * currently in the Suspended state, or pdFALSE if the task referenced by xTask + * is in any other state. + */ +#if ( INCLUDE_vTaskSuspend == 1 ) + static BaseType_t prvTaskIsTaskSuspended( const TaskHandle_t xTask ) PRIVILEGED_FUNCTION; +#endif /* INCLUDE_vTaskSuspend */ + +/* + * Utility to ready all the lists used by the scheduler. This is called + * automatically upon the creation of the first task. + */ +static void prvInitialiseTaskLists( void ) PRIVILEGED_FUNCTION; + +/* + * The idle task, which as all tasks is implemented as a never ending loop. + * The idle task is automatically created and added to the ready lists upon + * creation of the first user task. + * + * The portTASK_FUNCTION_PROTO() macro is used to allow port/compiler specific + * language extensions. The equivalent prototype for this function is: + * + * void prvIdleTask( void *pvParameters ); + * + */ +static portTASK_FUNCTION_PROTO( prvIdleTask, pvParameters ); + +/* + * Utility to free all memory allocated by the scheduler to hold a TCB, + * including the stack pointed to by the TCB. + * + * This does not free memory allocated by the task itself (i.e. memory + * allocated by calls to pvPortMalloc from within the tasks application code). + */ +#if ( INCLUDE_vTaskDelete == 1 ) + + static void prvDeleteTCB( TCB_t *pxTCB ) PRIVILEGED_FUNCTION; + +#endif + +/* + * Used only by the idle task. This checks to see if anything has been placed + * in the list of tasks waiting to be deleted. If so the task is cleaned up + * and its TCB deleted. + */ +static void prvCheckTasksWaitingTermination( void ) PRIVILEGED_FUNCTION; + +/* + * The currently executing task is entering the Blocked state. Add the task to + * either the current or the overflow delayed task list. + */ +static void prvAddCurrentTaskToDelayedList( const portBASE_TYPE xCoreID, const TickType_t xTimeToWake ) PRIVILEGED_FUNCTION; + +/* + * Allocates memory from the heap for a TCB and associated stack. Checks the + * allocation was successful. + */ +static TCB_t *prvAllocateTCBAndStack( const uint16_t usStackDepth, StackType_t * const puxStackBuffer ) PRIVILEGED_FUNCTION; + +/* + * Fills an TaskStatus_t structure with information on each task that is + * referenced from the pxList list (which may be a ready list, a delayed list, + * a suspended list, etc.). + * + * THIS FUNCTION IS INTENDED FOR DEBUGGING ONLY, AND SHOULD NOT BE CALLED FROM + * NORMAL APPLICATION CODE. + */ +#if ( configUSE_TRACE_FACILITY == 1 ) + + static UBaseType_t prvListTaskWithinSingleList( TaskStatus_t *pxTaskStatusArray, List_t *pxList, eTaskState eState ) PRIVILEGED_FUNCTION; + +#endif + +/* + * When a task is created, the stack of the task is filled with a known value. + * This function determines the 'high water mark' of the task stack by + * determining how much of the stack remains at the original preset value. + */ +#if ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) + + static uint16_t prvTaskCheckFreeStackSpace( const uint8_t * pucStackByte ) PRIVILEGED_FUNCTION; + +#endif + +/* + * Return the amount of time, in ticks, that will pass before the kernel will + * next move a task from the Blocked state to the Running state. + * + * This conditional compilation should use inequality to 0, not equality to 1. + * This is to ensure portSUPPRESS_TICKS_AND_SLEEP() can be called when user + * defined low power mode implementations require configUSE_TICKLESS_IDLE to be + * set to a value other than 1. + */ +#if ( configUSE_TICKLESS_IDLE != 0 ) + + static TickType_t prvGetExpectedIdleTime( void ) PRIVILEGED_FUNCTION; + +#endif + +/* + * Set xNextTaskUnblockTime to the time at which the next Blocked state task + * will exit the Blocked state. + */ +static void prvResetNextTaskUnblockTime( void ); + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) + + /* + * Helper function used to pad task names with spaces when printing out + * human readable tables of task information. + */ + static char *prvWriteNameToBuffer( char *pcBuffer, const char *pcTaskName ); + +#endif + +/*-----------------------------------------------------------*/ + + +static void vTaskInitializeLocalMuxes( void ) +{ + vPortCPUInitializeMutex(&xTaskQueueMutex); + vPortCPUInitializeMutex(&xTickCountMutex); + xMutexesInitialised = pdTRUE; +} + +/*-----------------------------------------------------------*/ + +BaseType_t xTaskGenericCreate( TaskFunction_t pxTaskCode, const char * const pcName, const uint16_t usStackDepth, void * const pvParameters, UBaseType_t uxPriority, TaskHandle_t * const pxCreatedTask, StackType_t * const puxStackBuffer, const MemoryRegion_t * const xRegions, const BaseType_t xCoreID) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +{ +BaseType_t xReturn; +TCB_t * pxNewTCB; +StackType_t *pxTopOfStack; +BaseType_t i; + + /* Initialize mutexes, if they're not already initialized. */ + if (xMutexesInitialised == pdFALSE) vTaskInitializeLocalMuxes(); + + configASSERT( pxTaskCode ); + configASSERT( ( ( uxPriority & ( ~portPRIVILEGE_BIT ) ) < configMAX_PRIORITIES ) ); + configASSERT( (xCoreID>=0 && xCoreIDxUsingStaticallyAllocatedStack = pdTRUE; + } + else + { + /* The stack was allocated dynamically. Note this so it can be + deleted again if the task is deleted. */ + pxNewTCB->xUsingStaticallyAllocatedStack = pdFALSE; + } + #endif /* portUSING_MPU_WRAPPERS == 1 */ + + /* Calculate the top of stack address. This depends on whether the + stack grows from high memory to low (as per the 80x86) or vice versa. + portSTACK_GROWTH is used to make the result positive or negative as + required by the port. */ + #if( portSTACK_GROWTH < 0 ) + { + pxTopOfStack = pxNewTCB->pxStack + ( usStackDepth - ( uint16_t ) 1 ); + pxTopOfStack = ( StackType_t * ) ( ( ( portPOINTER_SIZE_TYPE ) pxTopOfStack ) & ( ( portPOINTER_SIZE_TYPE ) ~portBYTE_ALIGNMENT_MASK ) ); /*lint !e923 MISRA exception. Avoiding casts between pointers and integers is not practical. Size differences accounted for using portPOINTER_SIZE_TYPE type. */ + + /* Check the alignment of the calculated top of stack is correct. */ + configASSERT( ( ( ( portPOINTER_SIZE_TYPE ) pxTopOfStack & ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) == 0UL ) ); + } + #else /* portSTACK_GROWTH */ + { + pxTopOfStack = pxNewTCB->pxStack; + + /* Check the alignment of the stack buffer is correct. */ + configASSERT( ( ( ( portPOINTER_SIZE_TYPE ) pxNewTCB->pxStack & ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) == 0UL ) ); + + /* If we want to use stack checking on architectures that use + a positive stack growth direction then we also need to store the + other extreme of the stack space. */ + pxNewTCB->pxEndOfStack = pxNewTCB->pxStack + ( usStackDepth - 1 ); + } + #endif /* portSTACK_GROWTH */ + + /* Setup the newly allocated TCB with the initial state of the task. */ + prvInitialiseTCBVariables( pxNewTCB, pcName, uxPriority, xRegions, usStackDepth, xCoreID ); + + /* Initialize the TCB stack to look as if the task was already running, + but had been interrupted by the scheduler. The return address is set + to the start of the task function. Once the stack has been initialised + the top of stack variable is updated. */ + #if( portUSING_MPU_WRAPPERS == 1 ) + { + pxNewTCB->pxTopOfStack = pxPortInitialiseStack( pxTopOfStack, pxTaskCode, pvParameters, xRunPrivileged ); + } + #else /* portUSING_MPU_WRAPPERS */ + { + pxNewTCB->pxTopOfStack = pxPortInitialiseStack( pxTopOfStack, pxTaskCode, pvParameters ); + } + #endif /* portUSING_MPU_WRAPPERS */ + + if( ( void * ) pxCreatedTask != NULL ) + { + /* Pass the TCB out - in an anonymous way. The calling function/ + task can use this as a handle to delete the task later if + required.*/ + *pxCreatedTask = ( TaskHandle_t ) pxNewTCB; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Ensure interrupts don't access the task lists while they are being + updated. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + { + uxCurrentNumberOfTasks++; + if( uxCurrentNumberOfTasks == ( UBaseType_t ) 1 ) + { + /* This is the first task to be created so do the preliminary + initialisation required. We will not recover if this call + fails, but we will report the failure. */ + prvInitialiseTaskLists(); + } + if( xSchedulerRunning == pdFALSE ) + { + /* Scheduler isn't running yet. We need to determine on which CPU to run this task. */ + for ( i=0; iuxPriority <= uxPriority ) + { + pxCurrentTCB[i] = pxNewTCB; + break; + } + } + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + uxTaskNumber++; + + #if ( configUSE_TRACE_FACILITY == 1 ) + { + /* Add a counter into the TCB for tracing only. */ + pxNewTCB->uxTCBNumber = uxTaskNumber; + } + #endif /* configUSE_TRACE_FACILITY */ + traceTASK_CREATE( pxNewTCB ); + + prvAddTaskToReadyList( pxNewTCB ); + + xReturn = pdPASS; + portSETUP_TCB( pxNewTCB ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + else + { + xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY; + traceTASK_CREATE_FAILED(); + } + + if( xReturn == pdPASS ) + { + if( xSchedulerRunning != pdFALSE ) + { + /* Scheduler is running. If the created task is of a higher priority than an executing task + then it should run now. + ToDo: This only works for the current core. If a task is scheduled on an other processor, + the other processor will keep running the task it's working on, and only switch to the newer + task on a timer interrupt. */ + //No mux here, uxPriority is mostly atomic and there's not really any harm if this check misfires. + if( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority < uxPriority ) + { + taskYIELD_IF_USING_PREEMPTION(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + return xReturn; +} +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskDelete == 1 ) + void vTaskDelete( TaskHandle_t xTaskToDelete ) + { + TCB_t *pxTCB; + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* If null is passed in here then it is the calling task that is + being deleted. */ + pxTCB = prvGetTCBFromHandle( xTaskToDelete ); + + /* Remove task from the ready list and place in the termination list. + This will stop the task from be scheduled. The idle task will check + the termination list and free up any memory allocated by the + scheduler for the TCB and stack. */ + if( uxListRemove( &( pxTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + taskRESET_READY_PRIORITY( pxTCB->uxPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Is the task waiting on an event also? */ + if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL ) + { + ( void ) uxListRemove( &( pxTCB->xEventListItem ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + vListInsertEnd( &xTasksWaitingTermination, &( pxTCB->xGenericListItem ) ); + + /* Increment the ucTasksDeleted variable so the idle task knows + there is a task that has been deleted and that it should therefore + check the xTasksWaitingTermination list. */ + ++uxTasksDeleted; + + /* Increment the uxTaskNumberVariable also so kernel aware debuggers + can detect that the task lists need re-generating. */ + uxTaskNumber++; + + traceTASK_DELETE( pxTCB ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + /* Force a reschedule if it is the currently running task that has just + been deleted. */ + if( xSchedulerRunning != pdFALSE ) + { + //No mux; no harm done if this misfires. The deleted task won't get scheduled anyway. + if( pxTCB == pxCurrentTCB[ xPortGetCoreID() ] ) + { + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] == 0 ); + + /* The pre-delete hook is primarily for the Windows simulator, + in which Windows specific clean up operations are performed, + after which it is not possible to yield away from this task - + hence xYieldPending is used to latch that a context switch is + required. */ + portPRE_TASK_DELETE_HOOK( pxTCB, &xYieldPending ); + portYIELD_WITHIN_API(); + } + else + { + /* Reset the next expected unblock time in case it referred to + the task that has just been deleted. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + { + prvResetNextTaskUnblockTime(); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + } + } + +#endif /* INCLUDE_vTaskDelete */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskDelayUntil == 1 ) + +/* ToDo: Make this multicore-compatible. */ + void vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement ) + { + TickType_t xTimeToWake; + BaseType_t xAlreadyYielded=pdFALSE, xShouldDelay = pdFALSE; + + ets_printf("ToDo %s\n", __FUNCTION__); + configASSERT( pxPreviousWakeTime ); + configASSERT( ( xTimeIncrement > 0U ) ); + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] == 0 ); + + taskENTER_CRITICAL(&xTaskQueueMutex); +// vTaskSuspendAll(); + { + /* Minor optimisation. The tick count cannot change in this + block. */ +// portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + const TickType_t xConstTickCount = xTickCount; +// portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + + /* Generate the tick time at which the task wants to wake. */ + xTimeToWake = *pxPreviousWakeTime + xTimeIncrement; + + if( xConstTickCount < *pxPreviousWakeTime ) + { + /* The tick count has overflowed since this function was + lasted called. In this case the only time we should ever + actually delay is if the wake time has also overflowed, + and the wake time is greater than the tick time. When this + is the case it is as if neither time had overflowed. */ + if( ( xTimeToWake < *pxPreviousWakeTime ) && ( xTimeToWake > xConstTickCount ) ) + { + xShouldDelay = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* The tick time has not overflowed. In this case we will + delay if either the wake time has overflowed, and/or the + tick time is less than the wake time. */ + if( ( xTimeToWake < *pxPreviousWakeTime ) || ( xTimeToWake > xConstTickCount ) ) + { + xShouldDelay = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + /* Update the wake time ready for the next call. */ + *pxPreviousWakeTime = xTimeToWake; + + if( xShouldDelay != pdFALSE ) + { + traceTASK_DELAY_UNTIL(); + + /* Remove the task from the ready list before adding it to the + blocked list as the same list item is used for both lists. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is + no need to check, and the port reset macro can be called + directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } +// xAlreadyYielded = xTaskResumeAll(); + taskEXIT_CRITICAL(&xTaskQueueMutex); + + /* Force a reschedule if xTaskResumeAll has not already done so, we may + have put ourselves to sleep. */ + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* INCLUDE_vTaskDelayUntil */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskDelay == 1 ) + void vTaskDelay( const TickType_t xTicksToDelay ) + { + TickType_t xTimeToWake; + BaseType_t xAlreadyYielded = pdFALSE; + + /* A delay time of zero just forces a reschedule. */ + if( xTicksToDelay > ( TickType_t ) 0U ) + { + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] == 0 ); + taskENTER_CRITICAL(&xTaskQueueMutex); +// vTaskSuspendAll(); + { + traceTASK_DELAY(); + + /* A task that is removed from the event list while the + scheduler is suspended will not get placed in the ready + list or removed from the blocked list until the scheduler + is resumed. + + This task cannot be in an event list as it is the currently + executing task. */ + + /* Calculate the time to wake - this may overflow but this is + not a problem. */ +// portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + xTimeToWake = xTickCount + xTicksToDelay; +// portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + + /* We must remove ourselves from the ready list before adding + ourselves to the blocked list as the same list item is used for + both lists. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is + no need to check, and the port reset macro can be called + directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } +// xAlreadyYielded = xTaskResumeAll(); + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Force a reschedule if xTaskResumeAll has not already done so, we may + have put ourselves to sleep. */ + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* INCLUDE_vTaskDelay */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_eTaskGetState == 1 ) +/* ToDo: Make this multicore-compatible. */ + eTaskState eTaskGetState( TaskHandle_t xTask ) + { + eTaskState eReturn; + List_t *pxStateList; + const TCB_t * const pxTCB = ( TCB_t * ) xTask; + + ets_printf("ToDo %s\n", __FUNCTION__); + configASSERT( pxTCB ); + + if( pxTCB == pxCurrentTCB[ xPortGetCoreID() ] ) + { + /* The task calling this function is querying its own state. */ + eReturn = eRunning; + } + else + { + taskENTER_CRITICAL(&xTaskQueueMutex); + { + pxStateList = ( List_t * ) listLIST_ITEM_CONTAINER( &( pxTCB->xGenericListItem ) ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + if( ( pxStateList == pxDelayedTaskList ) || ( pxStateList == pxOverflowDelayedTaskList ) ) + { + /* The task being queried is referenced from one of the Blocked + lists. */ + eReturn = eBlocked; + } + + #if ( INCLUDE_vTaskSuspend == 1 ) + else if( pxStateList == &xSuspendedTaskList ) + { + /* The task being queried is referenced from the suspended + list. Is it genuinely suspended or is it block + indefinitely? */ + if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL ) + { + eReturn = eSuspended; + } + else + { + eReturn = eBlocked; + } + } + #endif + + #if ( INCLUDE_vTaskDelete == 1 ) + else if( pxStateList == &xTasksWaitingTermination ) + { + /* The task being queried is referenced from the deleted + tasks list. */ + eReturn = eDeleted; + } + #endif + + else /*lint !e525 Negative indentation is intended to make use of pre-processor clearer. */ + { + /* If the task is not in any other state, it must be in the + Ready (including pending ready) state. */ + eReturn = eReady; + } + } + + return eReturn; + } /*lint !e818 xTask cannot be a pointer to const because it is a typedef. */ + +#endif /* INCLUDE_eTaskGetState */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_uxTaskPriorityGet == 1 ) +/* ToDo: Make this multicore-compatible. */ + UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask ) + { + TCB_t *pxTCB; + UBaseType_t uxReturn; + + ets_printf("ToDo %s\n", __FUNCTION__); + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* If null is passed in here then we are changing the + priority of the calling function. */ + pxTCB = prvGetTCBFromHandle( xTask ); + uxReturn = pxTCB->uxPriority; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return uxReturn; + } + +#endif /* INCLUDE_uxTaskPriorityGet */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_uxTaskPriorityGet == 1 ) +/* ToDo: Make this multicore-compatible. */ + UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask ) + { + TCB_t *pxTCB; + UBaseType_t uxReturn; + + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + { + /* If null is passed in here then it is the priority of the calling + task that is being queried. */ + pxTCB = prvGetTCBFromHandle( xTask ); + uxReturn = pxTCB->uxPriority; + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + + return uxReturn; + } + +#endif /* INCLUDE_uxTaskPriorityGet */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskPrioritySet == 1 ) + + void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority ) + { + TCB_t *pxTCB; + UBaseType_t uxCurrentBasePriority, uxPriorityUsedOnEntry; + BaseType_t xYieldRequired = pdFALSE; + + configASSERT( ( uxNewPriority < configMAX_PRIORITIES ) ); + + /* Ensure the new priority is valid. */ + if( uxNewPriority >= ( UBaseType_t ) configMAX_PRIORITIES ) + { + uxNewPriority = ( UBaseType_t ) configMAX_PRIORITIES - ( UBaseType_t ) 1U; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* If null is passed in here then it is the priority of the calling + task that is being changed. */ + pxTCB = prvGetTCBFromHandle( xTask ); + + traceTASK_PRIORITY_SET( pxTCB, uxNewPriority ); + + #if ( configUSE_MUTEXES == 1 ) + { + uxCurrentBasePriority = pxTCB->uxBasePriority; + } + #else + { + uxCurrentBasePriority = pxTCB->uxPriority; + } + #endif + + if( uxCurrentBasePriority != uxNewPriority ) + { + /* The priority change may have readied a task of higher + priority than the calling task. */ + if( uxNewPriority > uxCurrentBasePriority ) + { + if( pxTCB != pxCurrentTCB[ xPortGetCoreID() ] ) + { + /* The priority of a task other than the currently + running task is being raised. Is the priority being + raised above that of the running task? */ + if( uxNewPriority >= pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + xYieldRequired = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* The priority of the running task is being raised, + but the running task must already be the highest + priority task able to run so no yield is required. */ + } + } + else if( pxTCB == pxCurrentTCB[ xPortGetCoreID() ] ) + { + /* Setting the priority of the running task down means + there may now be another task of higher priority that + is ready to execute. */ + xYieldRequired = pdTRUE; + } + else + { + /* Setting the priority of any other task down does not + require a yield as the running task must be above the + new priority of the task being modified. */ + } + + /* Remember the ready list the task might be referenced from + before its uxPriority member is changed so the + taskRESET_READY_PRIORITY() macro can function correctly. */ + uxPriorityUsedOnEntry = pxTCB->uxPriority; + + #if ( configUSE_MUTEXES == 1 ) + { + /* Only change the priority being used if the task is not + currently using an inherited priority. */ + if( pxTCB->uxBasePriority == pxTCB->uxPriority ) + { + pxTCB->uxPriority = uxNewPriority; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The base priority gets set whatever. */ + pxTCB->uxBasePriority = uxNewPriority; + } + #else + { + pxTCB->uxPriority = uxNewPriority; + } + #endif + + /* Only reset the event list item value if the value is not + being used for anything else. */ + if( ( listGET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ) ) & taskEVENT_LIST_ITEM_VALUE_IN_USE ) == 0UL ) + { + listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) uxNewPriority ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* If the task is in the blocked or suspended list we need do + nothing more than change it's priority variable. However, if + the task is in a ready list it needs to be removed and placed + in the list appropriate to its new priority. */ + if( listIS_CONTAINED_WITHIN( &( pxReadyTasksLists[ uxPriorityUsedOnEntry ] ), &( pxTCB->xGenericListItem ) ) != pdFALSE ) + { + /* The task is currently in its ready list - remove before adding + it to it's new ready list. As we are in a critical section we + can do this even if the scheduler is suspended. */ + if( uxListRemove( &( pxTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* It is known that the task is in its ready list so + there is no need to check again and the port level + reset macro can be called directly. */ + portRESET_READY_PRIORITY( uxPriorityUsedOnEntry, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + prvAddTaskToReadyList( pxTCB ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( xYieldRequired == pdTRUE ) + { + taskYIELD_IF_USING_PREEMPTION_MUX(&xTaskQueueMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Remove compiler warning about unused variables when the port + optimised task selection is not being used. */ + ( void ) uxPriorityUsedOnEntry; + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + +#endif /* INCLUDE_vTaskPrioritySet */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskSuspend == 1 ) +/* ToDo: Make this multicore-compatible. */ + void vTaskSuspend( TaskHandle_t xTaskToSuspend ) + { + TCB_t *pxTCB; + + ets_printf("ToDo %s\n", __FUNCTION__); + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* If null is passed in here then it is the running task that is + being suspended. */ + pxTCB = prvGetTCBFromHandle( xTaskToSuspend ); + + traceTASK_SUSPEND( pxTCB ); + + /* Remove task from the ready/delayed list and place in the + suspended list. */ + if( uxListRemove( &( pxTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + taskRESET_READY_PRIORITY( pxTCB->uxPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Is the task waiting on an event also? */ + if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL ) + { + ( void ) uxListRemove( &( pxTCB->xEventListItem ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + vListInsertEnd( &xSuspendedTaskList, &( pxTCB->xGenericListItem ) ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + if( pxTCB == pxCurrentTCB[ xPortGetCoreID() ] ) + { + if( xSchedulerRunning != pdFALSE ) + { + /* The current task has just been suspended. */ + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] == 0 ); + portYIELD_WITHIN_API(); + } + else + { + /* The scheduler is not running, but the task that was pointed + to by pxCurrentTCB has just been suspended and pxCurrentTCB + must be adjusted to point to a different task. */ + if( listCURRENT_LIST_LENGTH( &xSuspendedTaskList ) == uxCurrentNumberOfTasks ) + { + /* No other tasks are ready, so set pxCurrentTCB back to + NULL so when the next task is created pxCurrentTCB will + be set to point to it no matter what its relative priority + is. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + pxCurrentTCB[ xPortGetCoreID() ] = NULL; + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + else + { + vTaskSwitchContext(); + } + } + } + else + { + if( xSchedulerRunning != pdFALSE ) + { + /* A task other than the currently running task was suspended, + reset the next expected unblock time in case it referred to the + task that is now in the Suspended state. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + { + prvResetNextTaskUnblockTime(); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + +#endif /* INCLUDE_vTaskSuspend */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskSuspend == 1 ) + + static BaseType_t prvTaskIsTaskSuspended( const TaskHandle_t xTask ) + { + BaseType_t xReturn = pdFALSE; + const TCB_t * const pxTCB = ( TCB_t * ) xTask; + + /* Accesses xPendingReadyList so must be called from a critical + section. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + + /* It does not make sense to check if the calling task is suspended. */ + configASSERT( xTask ); + + /* Is the task being resumed actually in the suspended list? */ + if( listIS_CONTAINED_WITHIN( &xSuspendedTaskList, &( pxTCB->xGenericListItem ) ) != pdFALSE ) + { + /* Has the task already been resumed from within an ISR? */ + if( listIS_CONTAINED_WITHIN( &xPendingReadyList, &( pxTCB->xEventListItem ) ) == pdFALSE ) + { + /* Is it in the suspended list because it is in the Suspended + state, or because is is blocked with no timeout? */ + if( listIS_CONTAINED_WITHIN( NULL, &( pxTCB->xEventListItem ) ) != pdFALSE ) + { + xReturn = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; + } /*lint !e818 xTask cannot be a pointer to const because it is a typedef. */ + +#endif /* INCLUDE_vTaskSuspend */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskSuspend == 1 ) + +/* ToDo: Make this multicore-compatible. */ + void vTaskResume( TaskHandle_t xTaskToResume ) + { + TCB_t * const pxTCB = ( TCB_t * ) xTaskToResume; + + ets_printf("ToDo %s\n", __FUNCTION__); + /* It does not make sense to resume the calling task. */ + configASSERT( xTaskToResume ); + + taskENTER_CRITICAL(&xTaskQueueMutex); + /* The parameter cannot be NULL as it is impossible to resume the + currently executing task. */ + if( ( pxTCB != NULL ) && ( pxTCB != pxCurrentTCB[ xPortGetCoreID() ] ) ) + { + { + if( prvTaskIsTaskSuspended( pxTCB ) == pdTRUE ) + { + traceTASK_RESUME( pxTCB ); + + /* As we are in a critical section we can access the ready + lists even if the scheduler is suspended. */ + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + + /* We may have just resumed a higher priority task. */ + if( pxTCB->uxPriority >= pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* This yield may not cause the task just resumed to run, + but will leave the lists in the correct state for the + next yield. */ + taskYIELD_IF_USING_PREEMPTION_MUX(&xTaskQueueMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + +#endif /* INCLUDE_vTaskSuspend */ + +/*-----------------------------------------------------------*/ + +#if ( ( INCLUDE_xTaskResumeFromISR == 1 ) && ( INCLUDE_vTaskSuspend == 1 ) ) + +/* ToDo: Make this multicore-compatible. */ + BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume ) + { + BaseType_t xYieldRequired = pdFALSE; + TCB_t * const pxTCB = ( TCB_t * ) xTaskToResume; + + configASSERT( xTaskToResume ); + + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + + { + if( prvTaskIsTaskSuspended( pxTCB ) == pdTRUE ) + { + traceTASK_RESUME_FROM_ISR( pxTCB ); + + /* Check the ready lists can be accessed. */ + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + /* Ready lists can be accessed so move the task from the + suspended list to the ready list directly. */ + if( pxTCB->uxPriority >= pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + xYieldRequired = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + } + else + { + /* The delayed or ready lists cannot be accessed so the task + is held in the pending ready list until the scheduler is + unsuspended. */ + vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) ); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + + return xYieldRequired; + } + +#endif /* ( ( INCLUDE_xTaskResumeFromISR == 1 ) && ( INCLUDE_vTaskSuspend == 1 ) ) */ +/*-----------------------------------------------------------*/ + +void vTaskStartScheduler( void ) +{ +BaseType_t xReturn; +BaseType_t i; + + /* Add the per-core idle tasks at the lowest priority. */ + for ( i=0; ixNewLib_reent; + } +} +#endif + + +void vTaskSuspendAll( void ) +{ + /* A critical section is not required as the variable is of type + BaseType_t. Please read Richard Barry's reply in the following link to a + post in the FreeRTOS support forum before reporting this as a bug! - + http://goo.gl/wu4acr */ + ++uxSchedulerSuspended[ xPortGetCoreID() ]; +} +/*----------------------------------------------------------*/ + +#if ( configUSE_TICKLESS_IDLE != 0 ) + + static TickType_t prvGetExpectedIdleTime( void ) + { + TickType_t xReturn; + + + taskENTER_CRITICAL(&xTaskQueueMutex); + if( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority > tskIDLE_PRIORITY ) + { + xReturn = 0; + } + else if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ tskIDLE_PRIORITY ] ) ) > 1 ) + { + /* There are other idle priority tasks in the ready state. If + time slicing is used then the very next tick interrupt must be + processed. */ + xReturn = 0; + } + else + { + portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + xReturn = xNextTaskUnblockTime - xTickCount; + portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; + } + +#endif /* configUSE_TICKLESS_IDLE */ +/*----------------------------------------------------------*/ + +BaseType_t xTaskResumeAll( void ) +{ +TCB_t *pxTCB; +BaseType_t xAlreadyYielded = pdFALSE; + + /* If uxSchedulerSuspended[ xPortGetCoreID() ] is zero then this function does not match a + previous call to vTaskSuspendAll(). */ + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] ); + /* It is possible that an ISR caused a task to be removed from an event + list while the scheduler was suspended. If this was the case then the + removed task will have been added to the xPendingReadyList. Once the + scheduler has been resumed it is safe to move all the pending ready + tasks from this list into their appropriate ready list. */ + + //This uses a mux, but can be called before tasks are scheduled. Make sure muxes are inited. + /* Initialize mutexes, if they're not already initialized. */ + if (xMutexesInitialised == pdFALSE) vTaskInitializeLocalMuxes(); + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + --uxSchedulerSuspended[ xPortGetCoreID() ]; + + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + if( uxCurrentNumberOfTasks > ( UBaseType_t ) 0U ) + { + /* Move any readied tasks from the pending list into the + appropriate ready list. */ + while( listLIST_IS_EMPTY( &xPendingReadyList ) == pdFALSE ) + { + pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xPendingReadyList ) ); + ( void ) uxListRemove( &( pxTCB->xEventListItem ) ); + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + + /* If the moved task has a priority higher than the current + task then a yield must be performed. */ + if( pxTCB->uxPriority >= pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + xYieldPending = pdTRUE; + break; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + /* If any ticks occurred while the scheduler was suspended then + they should be processed now. This ensures the tick count does + not slip, and that any delayed tasks are resumed at the correct + time. */ + if( uxPendedTicks > ( UBaseType_t ) 0U ) + { + while( uxPendedTicks > ( UBaseType_t ) 0U ) + { + if( xTaskIncrementTick() != pdFALSE ) + { + xYieldPending = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + --uxPendedTicks; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( xYieldPending == pdTRUE ) + { + #if( configUSE_PREEMPTION != 0 ) + { + xAlreadyYielded = pdTRUE; + } + #endif + taskYIELD_IF_USING_PREEMPTION_MUX(&xTaskQueueMutex); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xAlreadyYielded; +} +/*-----------------------------------------------------------*/ + +TickType_t xTaskGetTickCount( void ) +{ +TickType_t xTicks; + + /* Critical section required if running on a 16 bit processor. */ + portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + { + xTicks = xTickCount; + } + portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + + return xTicks; +} +/*-----------------------------------------------------------*/ + +TickType_t xTaskGetTickCountFromISR( void ) +{ +TickType_t xReturn; + + taskENTER_CRITICAL_ISR(&xTickCountMutex); + { + xReturn = xTickCount; +// vPortCPUReleaseMutex( &xTickCountMutex ); + } + taskEXIT_CRITICAL_ISR(&xTickCountMutex); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +UBaseType_t uxTaskGetNumberOfTasks( void ) +{ + /* A critical section is not required because the variables are of type + BaseType_t. */ + return uxCurrentNumberOfTasks; +} +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_pcTaskGetTaskName == 1 ) + + char *pcTaskGetTaskName( TaskHandle_t xTaskToQuery ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + { + TCB_t *pxTCB; + + /* If null is passed in here then the name of the calling task is being queried. */ + pxTCB = prvGetTCBFromHandle( xTaskToQuery ); + configASSERT( pxTCB ); + return &( pxTCB->pcTaskName[ 0 ] ); + } + +#endif /* INCLUDE_pcTaskGetTaskName */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime ) + { + UBaseType_t uxTask = 0, uxQueue = configMAX_PRIORITIES; + + ets_printf("ToDo %s\n", __FUNCTION__); + vTaskSuspendAll(); //WARNING: This only suspends one CPU. ToDo: suspend others as well. Mux using taskQueueMutex maybe? + { + /* Is there a space in the array for each task in the system? */ + if( uxArraySize >= uxCurrentNumberOfTasks ) + { + /* Fill in an TaskStatus_t structure with information on each + task in the Ready state. */ + do + { + uxQueue--; + uxTask += prvListTaskWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &( pxReadyTasksLists[ uxQueue ] ), eReady ); + + } while( uxQueue > ( UBaseType_t ) tskIDLE_PRIORITY ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + + /* Fill in an TaskStatus_t structure with information on each + task in the Blocked state. */ + uxTask += prvListTaskWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), ( List_t * ) pxDelayedTaskList, eBlocked ); + uxTask += prvListTaskWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), ( List_t * ) pxOverflowDelayedTaskList, eBlocked ); + + #if( INCLUDE_vTaskDelete == 1 ) + { + /* Fill in an TaskStatus_t structure with information on + each task that has been deleted but not yet cleaned up. */ + uxTask += prvListTaskWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &xTasksWaitingTermination, eDeleted ); + } + #endif + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + /* Fill in an TaskStatus_t structure with information on + each task in the Suspended state. */ + uxTask += prvListTaskWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &xSuspendedTaskList, eSuspended ); + } + #endif + + #if ( configGENERATE_RUN_TIME_STATS == 1) + { + if( pulTotalRunTime != NULL ) + { + #ifdef portALT_GET_RUN_TIME_COUNTER_VALUE + portALT_GET_RUN_TIME_COUNTER_VALUE( ( *pulTotalRunTime ) ); + #else + *pulTotalRunTime = portGET_RUN_TIME_COUNTER_VALUE(); + #endif + } + } + #else + { + if( pulTotalRunTime != NULL ) + { + *pulTotalRunTime = 0; + } + } + #endif + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + ( void ) xTaskResumeAll(); + + return uxTask; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*----------------------------------------------------------*/ + +#if ( INCLUDE_xTaskGetIdleTaskHandle == 1 ) + + TaskHandle_t xTaskGetIdleTaskHandle( void ) + { + /* If xTaskGetIdleTaskHandle() is called before the scheduler has been + started, then xIdleTaskHandle will be NULL. */ + configASSERT( ( xIdleTaskHandle != NULL ) ); + return xIdleTaskHandle; + } + +#endif /* INCLUDE_xTaskGetIdleTaskHandle */ +/*----------------------------------------------------------*/ + +/* This conditional compilation should use inequality to 0, not equality to 1. +This is to ensure vTaskStepTick() is available when user defined low power mode +implementations require configUSE_TICKLESS_IDLE to be set to a value other than +1. */ +#if ( configUSE_TICKLESS_IDLE != 0 ) + + void vTaskStepTick( const TickType_t xTicksToJump ) + { + /* Correct the tick count value after a period during which the tick + was suppressed. Note this does *not* call the tick hook function for + each stepped tick. */ + portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + configASSERT( ( xTickCount + xTicksToJump ) <= xNextTaskUnblockTime ); + xTickCount += xTicksToJump; + portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + traceINCREASE_TICK_COUNT( xTicksToJump ); + } + +#endif /* configUSE_TICKLESS_IDLE */ +/*----------------------------------------------------------*/ + +BaseType_t xTaskIncrementTick( void ) +{ +TCB_t * pxTCB; +TickType_t xItemValue; +BaseType_t xSwitchRequired = pdFALSE; + + /* Called by the portable layer each time a tick interrupt occurs. + Increments the tick then checks to see if the new tick value will cause any + tasks to be unblocked. */ + + /* Only let core 0 increase the tick count, to keep accurate track of time. */ + /* ToDo: This doesn't really play nice with the logic below: it means when core 1 is + running a low-priority task, it will keep running it until there is a context + switch, even when this routine (running on core 0) unblocks a bunch of high-priority + tasks... this is less than optimal -- JD. */ + if ( xPortGetCoreID()!=0 ) { + /* + We can't really calculate what we need, that's done on core 0... just assume we need a switch. + ToDo: Make this more intelligent? -- JD + */ + return pdTRUE; + } + + + traceTASK_INCREMENT_TICK( xTickCount ); + + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + portTICK_TYPE_ENTER_CRITICAL( &xTickCountMutex ); + /* Increment the RTOS tick, switching the delayed and overflowed + delayed lists if it wraps to 0. */ + ++xTickCount; + portTICK_TYPE_EXIT_CRITICAL( &xTickCountMutex ); + + //The other CPU may decide to mess with the task queues, so this needs a mux. + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + { + /* Minor optimisation. The tick count cannot change in this + block. */ + const TickType_t xConstTickCount = xTickCount; + + if( xConstTickCount == ( TickType_t ) 0U ) + { + taskSWITCH_DELAYED_LISTS(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* See if this tick has made a timeout expire. Tasks are stored in + the queue in the order of their wake time - meaning once one task + has been found whose block time has not expired there is no need to + look any further down the list. */ + if( xConstTickCount >= xNextTaskUnblockTime ) + { + for( ;; ) + { + if( listLIST_IS_EMPTY( pxDelayedTaskList ) != pdFALSE ) + { + /* The delayed list is empty. Set xNextTaskUnblockTime + to the maximum possible value so it is extremely + unlikely that the + if( xTickCount >= xNextTaskUnblockTime ) test will pass + next time through. */ + xNextTaskUnblockTime = portMAX_DELAY; + break; + } + else + { + /* The delayed list is not empty, get the value of the + item at the head of the delayed list. This is the time + at which the task at the head of the delayed list must + be removed from the Blocked state. */ + pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedTaskList ); + xItemValue = listGET_LIST_ITEM_VALUE( &( pxTCB->xGenericListItem ) ); + + if( xConstTickCount < xItemValue ) + { + /* It is not time to unblock this item yet, but the + item value is the time at which the task at the head + of the blocked list must be removed from the Blocked + state - so record the item value in + xNextTaskUnblockTime. */ + xNextTaskUnblockTime = xItemValue; + break; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* It is time to remove the item from the Blocked state. */ + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + + /* Is the task waiting on an event also? If so remove + it from the event list. */ + if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL ) + { + ( void ) uxListRemove( &( pxTCB->xEventListItem ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Place the unblocked task into the appropriate ready + list. */ + prvAddTaskToReadyList( pxTCB ); + + /* A task being unblocked cannot cause an immediate + context switch if preemption is turned off. */ + #if ( configUSE_PREEMPTION == 1 ) + { + /* Preemption is on, but a context switch should + only be performed if the unblocked task has a + priority that is equal to or higher than the + currently executing task. */ + if( pxTCB->uxPriority >= pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + xSwitchRequired = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_PREEMPTION */ + } + } + } + } + + /* Tasks of equal priority to the currently running task will share + processing time (time slice) if preemption is on, and the application + writer has not explicitly turned time slicing off. */ + #if ( ( configUSE_PREEMPTION == 1 ) && ( configUSE_TIME_SLICING == 1 ) ) + { + if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ] ) ) > ( UBaseType_t ) 1 ) + { + xSwitchRequired = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* ( ( configUSE_PREEMPTION == 1 ) && ( configUSE_TIME_SLICING == 1 ) ) */ + + #if ( configUSE_TICK_HOOK == 1 ) + { + /* Guard against the tick hook being called when the pended tick + count is being unwound (when the scheduler is being unlocked). */ + if( uxPendedTicks == ( UBaseType_t ) 0U ) + { + vApplicationTickHook(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_TICK_HOOK */ + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + } + else + { + ++uxPendedTicks; + + /* The tick hook gets called at regular intervals, even if the + scheduler is locked. */ + #if ( configUSE_TICK_HOOK == 1 ) + { + vApplicationTickHook(); + } + #endif + } + + #if ( configUSE_PREEMPTION == 1 ) + { + if( xYieldPending != pdFALSE ) + { + xSwitchRequired = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_PREEMPTION */ + + return xSwitchRequired; +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_APPLICATION_TASK_TAG == 1 ) + + void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction ) + { + TCB_t *xTCB; + + /* If xTask is NULL then it is the task hook of the calling task that is + getting set. */ + if( xTask == NULL ) + { + xTCB = ( TCB_t * ) pxCurrentTCB[ xPortGetCoreID() ]; + } + else + { + xTCB = ( TCB_t * ) xTask; + } + + /* Save the hook function in the TCB. A critical section is required as + the value can be accessed from an interrupt. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + xTCB->pxTaskTag = pxHookFunction; + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + +#endif /* configUSE_APPLICATION_TASK_TAG */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_APPLICATION_TASK_TAG == 1 ) + + TaskHookFunction_t xTaskGetApplicationTaskTag( TaskHandle_t xTask ) + { + TCB_t *xTCB; + TaskHookFunction_t xReturn; + + /* If xTask is NULL then we are setting our own task hook. */ + if( xTask == NULL ) + { + xTCB = ( TCB_t * ) pxCurrentTCB[ xPortGetCoreID() ]; + } + else + { + xTCB = ( TCB_t * ) xTask; + } + + /* Save the hook function in the TCB. A critical section is required as + the value can be accessed from an interrupt. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + { + xReturn = xTCB->pxTaskTag; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; + } + +#endif /* configUSE_APPLICATION_TASK_TAG */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_APPLICATION_TASK_TAG == 1 ) + + BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter ) + { + TCB_t *xTCB; + BaseType_t xReturn; + + /* If xTask is NULL then we are calling our own task hook. */ + if( xTask == NULL ) + { + xTCB = ( TCB_t * ) pxCurrentTCB[ xPortGetCoreID() ]; + } + else + { + xTCB = ( TCB_t * ) xTask; + } + + if( xTCB->pxTaskTag != NULL ) + { + xReturn = xTCB->pxTaskTag( pvParameter ); + } + else + { + xReturn = pdFAIL; + } + + return xReturn; + } + +#endif /* configUSE_APPLICATION_TASK_TAG */ +/*-----------------------------------------------------------*/ + +void vTaskSwitchContext( void ) +{ + tskTCB * pxTCB; + //This can be called both from IRQ as well as normal context, so we can't + //use taskENTER_CRITICAL() here. Instead, save the irq status and disable + //IRQs, so we can use taskENTER_CRITICAL_ISR and friends. + int irqstate=portENTER_CRITICAL_NESTED(); + if( uxSchedulerSuspended[ xPortGetCoreID() ] != ( UBaseType_t ) pdFALSE ) + { + /* The scheduler is currently suspended - do not allow a context + switch. */ + xYieldPending = pdTRUE; + } + else + { + xYieldPending = pdFALSE; + traceTASK_SWITCHED_OUT(); + + #if ( configGENERATE_RUN_TIME_STATS == 1 ) + { + #ifdef portALT_GET_RUN_TIME_COUNTER_VALUE + portALT_GET_RUN_TIME_COUNTER_VALUE( ulTotalRunTime ); + #else + ulTotalRunTime = portGET_RUN_TIME_COUNTER_VALUE(); + #endif + + /* Add the amount of time the task has been running to the + accumulated time so far. The time the task started running was + stored in ulTaskSwitchedInTime. Note that there is no overflow + protection here so count values are only valid until the timer + overflows. The guard against negative values is to protect + against suspect run time stat counter implementations - which + are provided by the application, not the kernel. */ + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + if( ulTotalRunTime > ulTaskSwitchedInTime ) + { + pxCurrentTCB[ xPortGetCoreID() ]->ulRunTimeCounter += ( ulTotalRunTime - ulTaskSwitchedInTime ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + ulTaskSwitchedInTime = ulTotalRunTime; + } + #endif /* configGENERATE_RUN_TIME_STATS */ + + /* Check for stack overflow, if configured. */ + taskFIRST_CHECK_FOR_STACK_OVERFLOW(); + taskSECOND_CHECK_FOR_STACK_OVERFLOW(); + + /* Select a new task to run using either the generic C or port + optimised asm code. */ + /* ToDo: either get rid of port-changable task switching stuff, or put all this inside the + taskSELECT_HIGHEST_PRIORITY_TASK macro, then replace this all with a taskSELECT_HIGHEST_PRIORITY_TASK(); + call */ + + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + + unsigned portBASE_TYPE foundNonExecutingWaiter = pdFALSE, ableToSchedule = pdFALSE, resetListHead; + unsigned portBASE_TYPE uxDynamicTopReady = uxTopReadyPriority; + unsigned portBASE_TYPE holdTop=pdFALSE; + + /* + * ToDo: This scheduler doesn't correctly implement the round-robin scheduling as done in the single-core + * FreeRTOS stack when multiple tasks have the same priority and are all ready; it just keeps grabbing the + * first one. ToDo: fix this. + * (Is this still true? if any, there's the issue with one core skipping over the processes for the other + * core, potentially not giving the skipped-over processes any time.) + */ + + while ( ableToSchedule == pdFALSE && uxDynamicTopReady >= 0 ) + { + configASSERT( uxTopReadyPriority>=0 ); + configASSERT( uxDynamicTopReady>=0 ); + resetListHead = pdFALSE; + // Nothing to do for empty lists + if (!listLIST_IS_EMPTY( &( pxReadyTasksLists[ uxDynamicTopReady ] ) )) { + + ableToSchedule = pdFALSE; + tskTCB * pxRefTCB; + + /* Remember the current list item so that we + can detect if all items have been inspected. + Once this happens, we move on to a lower + priority list (assuming nothing is suitable + for scheduling). Note: This can return NULL if + the list index is at the listItem */ + pxRefTCB = pxReadyTasksLists[ uxDynamicTopReady ].pxIndex->pvOwner; + + if ((void*)pxReadyTasksLists[ uxDynamicTopReady ].pxIndex==(void*)&pxReadyTasksLists[ uxDynamicTopReady ].xListEnd) { + //pxIndex points to the list end marker. Skip that and just get the next item. + listGET_OWNER_OF_NEXT_ENTRY( pxRefTCB, &( pxReadyTasksLists[ uxDynamicTopReady ] ) ); + } + + do { + listGET_OWNER_OF_NEXT_ENTRY( pxTCB, &( pxReadyTasksLists[ uxDynamicTopReady ] ) ); + /* Find out if the next task in the list is + already being executed by another core */ + foundNonExecutingWaiter = pdTRUE; + portBASE_TYPE i = 0; + for ( i=0; ixCoreID == tskNO_AFFINITY) { + pxCurrentTCB[xPortGetCoreID()] = pxTCB; + ableToSchedule = pdTRUE; + } else if (pxTCB->xCoreID == xPortGetCoreID()) { + pxCurrentTCB[xPortGetCoreID()] = pxTCB; + ableToSchedule = pdTRUE; + } else { + ableToSchedule = pdFALSE; + holdTop=pdTRUE; //keep this as the top prio, for the other CPU + } + } else { + ableToSchedule = pdFALSE; + } + + if (ableToSchedule == pdFALSE) { + resetListHead = pdTRUE; + } else if ((ableToSchedule == pdTRUE) && (resetListHead == pdTRUE)) { + tskTCB * pxResetTCB; + do { + listGET_OWNER_OF_NEXT_ENTRY( pxResetTCB, &( pxReadyTasksLists[ uxDynamicTopReady ] ) ); + } while(pxResetTCB != pxRefTCB); + } + } while ((ableToSchedule == pdFALSE) && (pxTCB != pxRefTCB)); + } else { + if (!holdTop) --uxTopReadyPriority; + } + --uxDynamicTopReady; + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + + /* ToDo: taskSELECT_HIGHEST_PRIORITY_TASK replacement code ends here. */ + + traceTASK_SWITCHED_IN(); + + } + portEXIT_CRITICAL_NESTED(irqstate); +} +/*-----------------------------------------------------------*/ + +void vTaskPlaceOnEventList( List_t * const pxEventList, const TickType_t xTicksToWait ) +{ +TickType_t xTimeToWake; + + configASSERT( pxEventList ); + + taskENTER_CRITICAL(&xTaskQueueMutex); + + /* Place the event list item of the TCB in the appropriate event list. + This is placed in the list in priority order so the highest priority task + is the first to be woken by the event. The queue that contains the event + list is locked, preventing simultaneous access from interrupts. */ + vListInsert( pxEventList, &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ) ); + + /* The task must be removed from from the ready list before it is added to + the blocked list as the same list item is used for both lists. Exclusive + access to the ready lists guaranteed because the scheduler is locked. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is no need to + check, and the port reset macro can be called directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + if( xTicksToWait == portMAX_DELAY ) + { + /* Add the task to the suspended task list instead of a delayed task + list to ensure the task is not woken by a timing event. It will + block indefinitely. */ + vListInsertEnd( &xSuspendedTaskList, &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ); + } + else + { + /* Calculate the time at which the task should be woken if the event + does not occur. This may overflow but this doesn't matter, the + scheduler will handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } + } + #else /* INCLUDE_vTaskSuspend */ + { + /* Calculate the time at which the task should be woken if the event does + not occur. This may overflow but this doesn't matter, the scheduler + will handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xTimeToWake ); + } + #endif /* INCLUDE_vTaskSuspend */ + + taskEXIT_CRITICAL(&xTaskQueueMutex); + +} +/*-----------------------------------------------------------*/ + +void vTaskPlaceOnUnorderedEventList( List_t * pxEventList, const TickType_t xItemValue, const TickType_t xTicksToWait ) +{ +TickType_t xTimeToWake; + + configASSERT( pxEventList ); + + taskENTER_CRITICAL(&xTaskQueueMutex); + + /* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED. It is used by + the event groups implementation. */ + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] != 0 ); + + /* Store the item value in the event list item. It is safe to access the + event list item here as interrupts won't access the event list item of a + task that is not in the Blocked state. */ + listSET_LIST_ITEM_VALUE( &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ), xItemValue | taskEVENT_LIST_ITEM_VALUE_IN_USE ); + + /* Place the event list item of the TCB at the end of the appropriate event + list. It is safe to access the event list here because it is part of an + event group implementation - and interrupts don't access event groups + directly (instead they access them indirectly by pending function calls to + the task level). */ + vListInsertEnd( pxEventList, &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ) ); + + /* The task must be removed from the ready list before it is added to the + blocked list. Exclusive access can be assured to the ready list as the + scheduler is locked. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is no need to + check, and the port reset macro can be called directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + if( xTicksToWait == portMAX_DELAY ) + { + /* Add the task to the suspended task list instead of a delayed task + list to ensure it is not woken by a timing event. It will block + indefinitely. */ + vListInsertEnd( &xSuspendedTaskList, &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ); + } + else + { + /* Calculate the time at which the task should be woken if the event + does not occur. This may overflow but this doesn't matter, the + kernel will manage it correctly. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } + } + #else /* INCLUDE_vTaskSuspend */ + { + /* Calculate the time at which the task should be woken if the event does + not occur. This may overflow but this doesn't matter, the kernel + will manage it correctly. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xTimeToWake ); + } + #endif /* INCLUDE_vTaskSuspend */ + + taskEXIT_CRITICAL(&xTaskQueueMutex); +} +/*-----------------------------------------------------------*/ + +#if configUSE_TIMERS == 1 + + void vTaskPlaceOnEventListRestricted( List_t * const pxEventList, const TickType_t xTicksToWait ) + { + TickType_t xTimeToWake; + + taskENTER_CRITICAL(&xTaskQueueMutex); + configASSERT( pxEventList ); + + /* This function should not be called by application code hence the + 'Restricted' in its name. It is not part of the public API. It is + designed for use by kernel code, and has special calling requirements - + it should be called from a critical section. */ + + + /* Place the event list item of the TCB in the appropriate event list. + In this case it is assume that this is the only task that is going to + be waiting on this event list, so the faster vListInsertEnd() function + can be used in place of vListInsert. */ + vListInsertEnd( pxEventList, &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ) ); + + /* We must remove this task from the ready list before adding it to the + blocked list as the same list item is used for both lists. This + function is called form a critical section. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is no need to + check, and the port reset macro can be called directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Calculate the time at which the task should be woken if the event does + not occur. This may overflow but this doesn't matter. */ + xTimeToWake = xTickCount + xTicksToWait; + + traceTASK_DELAY_UNTIL(); + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + taskEXIT_CRITICAL(&xTaskQueueMutex); + + } + +#endif /* configUSE_TIMERS */ +/*-----------------------------------------------------------*/ + +BaseType_t xTaskRemoveFromEventList( const List_t * const pxEventList ) +{ +TCB_t *pxUnblockedTCB; +BaseType_t xReturn; + + /* THIS FUNCTION MUST BE CALLED FROM A CRITICAL SECTION. It can also be + called from a critical section within an ISR. */ +//That makes the taskENTER_CRITICALs here unnecessary, right? -JD +// taskENTER_CRITICAL(&xTaskQueueMutex); + /* The event list is sorted in priority order, so the first in the list can + be removed as it is known to be the highest priority. Remove the TCB from + the delayed list, and add it to the ready list. + + If an event is for a queue that is locked then this function will never + get called - the lock count on the queue will get modified instead. This + means exclusive access to the event list is guaranteed here. + + This function assumes that a check has already been made to ensure that + pxEventList is not empty. */ + pxUnblockedTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxEventList ); + configASSERT( pxUnblockedTCB ); + ( void ) uxListRemove( &( pxUnblockedTCB->xEventListItem ) ); + + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + ( void ) uxListRemove( &( pxUnblockedTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxUnblockedTCB ); + } + else + { + /* The delayed and ready lists cannot be accessed, so hold this task + pending until the scheduler is resumed. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + vListInsertEnd( &( xPendingReadyList ), &( pxUnblockedTCB->xEventListItem ) ); + taskEXIT_CRITICAL(&xTaskQueueMutex); + } + + if( pxUnblockedTCB->uxPriority > pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* Return true if the task removed from the event list has a higher + priority than the calling task. This allows the calling task to know if + it should force a context switch now. */ + xReturn = pdTRUE; + + /* Mark that a yield is pending in case the user is not using the + "xHigherPriorityTaskWoken" parameter to an ISR safe FreeRTOS function. */ + xYieldPending = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + + #if( configUSE_TICKLESS_IDLE == 1 ) + { + /* If a task is blocked on a kernel object then xNextTaskUnblockTime + might be set to the blocked task's time out time. If the task is + unblocked for a reason other than a timeout xNextTaskUnblockTime is + normally left unchanged, because it is automatically get reset to a new + value when the tick count equals xNextTaskUnblockTime. However if + tickless idling is used it might be more important to enter sleep mode + at the earliest possible time - so reset xNextTaskUnblockTime here to + ensure it is updated at the earliest possible time. */ + prvResetNextTaskUnblockTime(); + } + #endif +// taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +BaseType_t xTaskRemoveFromUnorderedEventList( ListItem_t * pxEventListItem, const TickType_t xItemValue ) +{ +TCB_t *pxUnblockedTCB; +BaseType_t xReturn; + + taskENTER_CRITICAL(&xTaskQueueMutex); + /* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED. It is used by + the event flags implementation. */ + configASSERT( uxSchedulerSuspended[ xPortGetCoreID() ] != pdFALSE ); + + /* Store the new item value in the event list. */ + listSET_LIST_ITEM_VALUE( pxEventListItem, xItemValue | taskEVENT_LIST_ITEM_VALUE_IN_USE ); + + /* Remove the event list form the event flag. Interrupts do not access + event flags. */ + pxUnblockedTCB = ( TCB_t * ) listGET_LIST_ITEM_OWNER( pxEventListItem ); + configASSERT( pxUnblockedTCB ); + ( void ) uxListRemove( pxEventListItem ); + + /* Remove the task from the delayed list and add it to the ready list. The + scheduler is suspended so interrupts will not be accessing the ready + lists. */ + ( void ) uxListRemove( &( pxUnblockedTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxUnblockedTCB ); + + if( pxUnblockedTCB->uxPriority > pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* Return true if the task removed from the event list has + a higher priority than the calling task. This allows + the calling task to know if it should force a context + switch now. */ + xReturn = pdTRUE; + + /* Mark that a yield is pending in case the user is not using the + "xHigherPriorityTaskWoken" parameter to an ISR safe FreeRTOS function. */ + xYieldPending = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + + taskEXIT_CRITICAL(&xTaskQueueMutex); + return xReturn; +} +/*-----------------------------------------------------------*/ + +void vTaskSetTimeOutState( TimeOut_t * const pxTimeOut ) +{ + configASSERT( pxTimeOut ); + pxTimeOut->xOverflowCount = xNumOfOverflows; + pxTimeOut->xTimeOnEntering = xTickCount; +} +/*-----------------------------------------------------------*/ + +BaseType_t xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut, TickType_t * const pxTicksToWait ) +{ +BaseType_t xReturn; + + configASSERT( pxTimeOut ); + configASSERT( pxTicksToWait ); + + taskENTER_CRITICAL(&xTickCountMutex); + { + /* Minor optimisation. The tick count cannot change in this block. */ + const TickType_t xConstTickCount = xTickCount; + + #if ( INCLUDE_vTaskSuspend == 1 ) + /* If INCLUDE_vTaskSuspend is set to 1 and the block time specified is + the maximum block time then the task should block indefinitely, and + therefore never time out. */ + if( *pxTicksToWait == portMAX_DELAY ) + { + xReturn = pdFALSE; + } + else /* We are not blocking indefinitely, perform the checks below. */ + #endif + + if( ( xNumOfOverflows != pxTimeOut->xOverflowCount ) && ( xConstTickCount >= pxTimeOut->xTimeOnEntering ) ) /*lint !e525 Indentation preferred as is to make code within pre-processor directives clearer. */ + { + /* The tick count is greater than the time at which vTaskSetTimeout() + was called, but has also overflowed since vTaskSetTimeOut() was called. + It must have wrapped all the way around and gone past us again. This + passed since vTaskSetTimeout() was called. */ + xReturn = pdTRUE; + } + else if( ( xConstTickCount - pxTimeOut->xTimeOnEntering ) < *pxTicksToWait ) + { + /* Not a genuine timeout. Adjust parameters for time remaining. */ + *pxTicksToWait -= ( xConstTickCount - pxTimeOut->xTimeOnEntering ); + vTaskSetTimeOutState( pxTimeOut ); + xReturn = pdFALSE; + } + else + { + xReturn = pdTRUE; + } + } + taskEXIT_CRITICAL(&xTickCountMutex); + + return xReturn; +} +/*-----------------------------------------------------------*/ + +void vTaskMissedYield( void ) +{ + xYieldPending = pdTRUE; +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + UBaseType_t uxTaskGetTaskNumber( TaskHandle_t xTask ) + { + UBaseType_t uxReturn; + TCB_t *pxTCB; + + if( xTask != NULL ) + { + pxTCB = ( TCB_t * ) xTask; + uxReturn = pxTCB->uxTaskNumber; + } + else + { + uxReturn = 0U; + } + + return uxReturn; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + void vTaskSetTaskNumber( TaskHandle_t xTask, const UBaseType_t uxHandle ) + { + TCB_t *pxTCB; + + if( xTask != NULL ) + { + pxTCB = ( TCB_t * ) xTask; + pxTCB->uxTaskNumber = uxHandle; + } + } + +#endif /* configUSE_TRACE_FACILITY */ + +/* + * ----------------------------------------------------------- + * The Idle task. + * ---------------------------------------------------------- + * + * The portTASK_FUNCTION() macro is used to allow port/compiler specific + * language extensions. The equivalent prototype for this function is: + * + * void prvIdleTask( void *pvParameters ); + * + */ +static portTASK_FUNCTION( prvIdleTask, pvParameters ) +{ + /* Stop warnings. */ + ( void ) pvParameters; + + for( ;; ) + { + /* See if any tasks have been deleted. */ + prvCheckTasksWaitingTermination(); + + #if ( configUSE_PREEMPTION == 0 ) + { + /* If we are not using preemption we keep forcing a task switch to + see if any other task has become available. If we are using + preemption we don't need to do this as any task becoming available + will automatically get the processor anyway. */ + taskYIELD(); + } + #endif /* configUSE_PREEMPTION */ + + #if ( ( configUSE_PREEMPTION == 1 ) && ( configIDLE_SHOULD_YIELD == 1 ) ) + { + /* When using preemption tasks of equal priority will be + timesliced. If a task that is sharing the idle priority is ready + to run then the idle task should yield before the end of the + timeslice. + + A critical region is not required here as we are just reading from + the list, and an occasional incorrect value will not matter. If + the ready list at the idle priority contains more than one task + then a task other than the idle task is ready to execute. */ + if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ tskIDLE_PRIORITY ] ) ) > ( UBaseType_t ) 1 ) + { + taskYIELD(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* ( ( configUSE_PREEMPTION == 1 ) && ( configIDLE_SHOULD_YIELD == 1 ) ) */ + + #if ( configUSE_IDLE_HOOK == 1 ) + { + extern void vApplicationIdleHook( void ); + + /* Call the user defined function from within the idle task. This + allows the application designer to add background functionality + without the overhead of a separate task. + NOTE: vApplicationIdleHook() MUST NOT, UNDER ANY CIRCUMSTANCES, + CALL A FUNCTION THAT MIGHT BLOCK. */ + vApplicationIdleHook(); + } + #endif /* configUSE_IDLE_HOOK */ + + /* This conditional compilation should use inequality to 0, not equality + to 1. This is to ensure portSUPPRESS_TICKS_AND_SLEEP() is called when + user defined low power mode implementations require + configUSE_TICKLESS_IDLE to be set to a value other than 1. */ + #if ( configUSE_TICKLESS_IDLE != 0 ) + { + TickType_t xExpectedIdleTime; + + /* It is not desirable to suspend then resume the scheduler on + each iteration of the idle task. Therefore, a preliminary + test of the expected idle time is performed without the + scheduler suspended. The result here is not necessarily + valid. */ + xExpectedIdleTime = prvGetExpectedIdleTime(); + + if( xExpectedIdleTime >= configEXPECTED_IDLE_TIME_BEFORE_SLEEP ) + { +// vTaskSuspendAll(); + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* Now the scheduler is suspended, the expected idle + time can be sampled again, and this time its value can + be used. */ + configASSERT( xNextTaskUnblockTime >= xTickCount ); + xExpectedIdleTime = prvGetExpectedIdleTime(); + + if( xExpectedIdleTime >= configEXPECTED_IDLE_TIME_BEFORE_SLEEP ) + { + traceLOW_POWER_IDLE_BEGIN(); + portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ); + traceLOW_POWER_IDLE_END(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); +// ( void ) xTaskResumeAll(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_TICKLESS_IDLE */ + } +} +/*-----------------------------------------------------------*/ + +#if configUSE_TICKLESS_IDLE != 0 + + eSleepModeStatus eTaskConfirmSleepModeStatus( void ) + { + eSleepModeStatus eReturn = eStandardSleep; + taskENTER_CRITICAL(&xTaskQueueMutex); + + if( listCURRENT_LIST_LENGTH( &xPendingReadyList ) != 0 ) + { + /* A task was made ready while the scheduler was suspended. */ + eReturn = eAbortSleep; + } + else if( xYieldPending != pdFALSE ) + { + /* A yield was pended while the scheduler was suspended. */ + eReturn = eAbortSleep; + } + else + { + #if configUSE_TIMERS == 0 + { + /* The idle task exists in addition to the application tasks. */ + const UBaseType_t uxNonApplicationTasks = 1; + + /* If timers are not being used and all the tasks are in the + suspended list (which might mean they have an infinite block + time rather than actually being suspended) then it is safe to + turn all clocks off and just wait for external interrupts. */ + if( listCURRENT_LIST_LENGTH( &xSuspendedTaskList ) == ( uxCurrentNumberOfTasks - uxNonApplicationTasks ) ) + { + eReturn = eNoTasksWaitingTimeout; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configUSE_TIMERS */ + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return eReturn; + } +#endif /* configUSE_TICKLESS_IDLE */ +/*-----------------------------------------------------------*/ + +static void prvInitialiseTCBVariables( TCB_t * const pxTCB, const char * const pcName, UBaseType_t uxPriority, const MemoryRegion_t * const xRegions, const uint16_t usStackDepth, const BaseType_t xCoreID ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +{ +UBaseType_t x; + + /* Store the task name in the TCB. */ + for( x = ( UBaseType_t ) 0; x < ( UBaseType_t ) configMAX_TASK_NAME_LEN; x++ ) + { + pxTCB->pcTaskName[ x ] = pcName[ x ]; + + /* Don't copy all configMAX_TASK_NAME_LEN if the string is shorter than + configMAX_TASK_NAME_LEN characters just in case the memory after the + string is not accessible (extremely unlikely). */ + if( pcName[ x ] == 0x00 ) + { + break; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + /* Ensure the name string is terminated in the case that the string length + was greater or equal to configMAX_TASK_NAME_LEN. */ + pxTCB->pcTaskName[ configMAX_TASK_NAME_LEN - 1 ] = '\0'; + + /* This is used as an array index so must ensure it's not too large. First + remove the privilege bit if one is present. */ + if( uxPriority >= ( UBaseType_t ) configMAX_PRIORITIES ) + { + uxPriority = ( UBaseType_t ) configMAX_PRIORITIES - ( UBaseType_t ) 1U; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + pxTCB->uxPriority = uxPriority; + pxTCB->xCoreID = xCoreID; + #if ( configUSE_MUTEXES == 1 ) + { + pxTCB->uxBasePriority = uxPriority; + pxTCB->uxMutexesHeld = 0; + } + #endif /* configUSE_MUTEXES */ + + vListInitialiseItem( &( pxTCB->xGenericListItem ) ); + vListInitialiseItem( &( pxTCB->xEventListItem ) ); + + /* Set the pxTCB as a link back from the ListItem_t. This is so we can get + back to the containing TCB from a generic item in a list. */ + listSET_LIST_ITEM_OWNER( &( pxTCB->xGenericListItem ), pxTCB ); + + /* Event lists are always in priority order. */ + listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + listSET_LIST_ITEM_OWNER( &( pxTCB->xEventListItem ), pxTCB ); + + #if ( portCRITICAL_NESTING_IN_TCB == 1 ) + { + pxTCB->uxCriticalNesting = ( UBaseType_t ) 0U; + } + #endif /* portCRITICAL_NESTING_IN_TCB */ + + #if ( configUSE_APPLICATION_TASK_TAG == 1 ) + { + pxTCB->pxTaskTag = NULL; + } + #endif /* configUSE_APPLICATION_TASK_TAG */ + + #if ( configGENERATE_RUN_TIME_STATS == 1 ) + { + pxTCB->ulRunTimeCounter = 0UL; + } + #endif /* configGENERATE_RUN_TIME_STATS */ + + #if ( portUSING_MPU_WRAPPERS == 1 ) + { + vPortStoreTaskMPUSettings( &( pxTCB->xMPUSettings ), xRegions, pxTCB->pxStack, usStackDepth ); + } + #else /* portUSING_MPU_WRAPPERS */ + { + ( void ) xRegions; + ( void ) usStackDepth; + } + #endif /* portUSING_MPU_WRAPPERS */ + + #if( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 ) + { + for( x = 0; x < ( UBaseType_t ) configNUM_THREAD_LOCAL_STORAGE_POINTERS; x++ ) + { + pxNewTCB->pvThreadLocalStoragePointers[ x ] = NULL; + } + } + #endif + + + #if ( configUSE_TASK_NOTIFICATIONS == 1 ) + { + pxTCB->ulNotifiedValue = 0; + pxTCB->eNotifyState = eNotWaitingNotification; + } + #endif + + #if ( configUSE_NEWLIB_REENTRANT == 1 ) + { + /* Initialise this task's Newlib reent structure. */ + _REENT_INIT_PTR( ( &( pxTCB->xNewLib_reent ) ) ); + } + #endif /* configUSE_NEWLIB_REENTRANT */ +} +/*-----------------------------------------------------------*/ +#if ( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 ) + + void vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet, BaseType_t xIndex, void *pvValue ) + { + TCB_t *pxTCB; + + if( xIndex < configNUM_THREAD_LOCAL_STORAGE_POINTERS ) + { + pxTCB = prvGetTCBFromHandle( xTaskToSet ); + pxTCB->pvThreadLocalStoragePointers[ xIndex ] = pvValue; + } + } + +#endif /* configNUM_THREAD_LOCAL_STORAGE_POINTERS */ +/*-----------------------------------------------------------*/ + +#if ( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 ) + + void *pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery, BaseType_t xIndex ) + { + void *pvReturn = NULL; + TCB_t *pxTCB; + + if( xIndex < configNUM_THREAD_LOCAL_STORAGE_POINTERS ) + { + pxTCB = prvGetTCBFromHandle( xTaskToQuery ); + pvReturn = pxTCB->pvThreadLocalStoragePointers[ xIndex ]; + } + else + { + pvReturn = NULL; + } + + return pvReturn; + } + +#endif /* configNUM_THREAD_LOCAL_STORAGE_POINTERS */ + + +#if ( portUSING_MPU_WRAPPERS == 1 ) +/* ToDo: Check for multicore */ + void vTaskAllocateMPURegions( TaskHandle_t xTaskToModify, const MemoryRegion_t * const xRegions ) + { + TCB_t *pxTCB; + + ets_printf("ToDo %s\n", __FUNCTION__); + /* If null is passed in here then we are deleting ourselves. */ + pxTCB = prvGetTCBFromHandle( xTaskToModify ); + + vPortStoreTaskMPUSettings( &( pxTCB->xMPUSettings ), xRegions, NULL, 0 ); + } + +#endif /* portUSING_MPU_WRAPPERS */ +/*-----------------------------------------------------------*/ + +static void prvInitialiseTaskLists( void ) +{ +UBaseType_t uxPriority; + + for( uxPriority = ( UBaseType_t ) 0U; uxPriority < ( UBaseType_t ) configMAX_PRIORITIES; uxPriority++ ) + { + vListInitialise( &( pxReadyTasksLists[ uxPriority ] ) ); + } + + vListInitialise( &xDelayedTaskList1 ); + vListInitialise( &xDelayedTaskList2 ); + vListInitialise( &xPendingReadyList ); + + #if ( INCLUDE_vTaskDelete == 1 ) + { + vListInitialise( &xTasksWaitingTermination ); + } + #endif /* INCLUDE_vTaskDelete */ + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + vListInitialise( &xSuspendedTaskList ); + } + #endif /* INCLUDE_vTaskSuspend */ + + /* Start with pxDelayedTaskList using list1 and the pxOverflowDelayedTaskList + using list2. */ + pxDelayedTaskList = &xDelayedTaskList1; + pxOverflowDelayedTaskList = &xDelayedTaskList2; +} +/*-----------------------------------------------------------*/ + +static void prvCheckTasksWaitingTermination( void ) +{ + #if ( INCLUDE_vTaskDelete == 1 ) + { + BaseType_t xListIsEmpty; + + /* ucTasksDeleted is used to prevent vTaskSuspendAll() being called + too often in the idle task. */ + while( uxTasksDeleted > ( UBaseType_t ) 0U ) + { + taskENTER_CRITICAL(&xTaskQueueMutex); + { + xListIsEmpty = listLIST_IS_EMPTY( &xTasksWaitingTermination ); + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + if( xListIsEmpty == pdFALSE ) + { + TCB_t *pxTCB; + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xTasksWaitingTermination ) ); + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + --uxCurrentNumberOfTasks; + --uxTasksDeleted; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + prvDeleteTCB( pxTCB ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + #endif /* vTaskDelete */ +} +/*-----------------------------------------------------------*/ + +//This should be called with the taskqueuemutex grabbed. -JD +static void prvAddCurrentTaskToDelayedList( const BaseType_t xCoreID, const TickType_t xTimeToWake ) +{ + /* The list item will be inserted in wake time order. */ + listSET_LIST_ITEM_VALUE( &( pxCurrentTCB[ xCoreID ]->xGenericListItem ), xTimeToWake ); + + if( xTimeToWake < xTickCount ) + { + /* Wake time has overflowed. Place this item in the overflow list. */ + vListInsert( pxOverflowDelayedTaskList, &( pxCurrentTCB[ xCoreID ]->xGenericListItem ) ); + } + else + { + /* The wake time has not overflowed, so the current block list is used. */ + vListInsert( pxDelayedTaskList, &( pxCurrentTCB[ xCoreID ]->xGenericListItem ) ); + + /* If the task entering the blocked state was placed at the head of the + list of blocked tasks then xNextTaskUnblockTime needs to be updated + too. */ + if( xTimeToWake < xNextTaskUnblockTime ) + { + xNextTaskUnblockTime = xTimeToWake; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } +} +/*-----------------------------------------------------------*/ + +static TCB_t *prvAllocateTCBAndStack( const uint16_t usStackDepth, StackType_t * const puxStackBuffer ) +{ +TCB_t *pxNewTCB; + + /* If the stack grows down then allocate the stack then the TCB so the stack + does not grow into the TCB. Likewise if the stack grows up then allocate + the TCB then the stack. */ + #if( portSTACK_GROWTH > 0 ) + { + /* Allocate space for the TCB. Where the memory comes from depends on + the implementation of the port malloc function. */ + pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) ); + + if( pxNewTCB != NULL ) + { + /* Allocate space for the stack used by the task being created. + The base of the stack memory stored in the TCB so the task can + be deleted later if required. */ + pxNewTCB->pxStack = ( StackType_t * ) pvPortMallocAligned( ( ( ( size_t ) usStackDepth ) * sizeof( StackType_t ) ), puxStackBuffer ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + + if( pxNewTCB->pxStack == NULL ) + { + /* Could not allocate the stack. Delete the allocated TCB. */ + vPortFree( pxNewTCB ); + pxNewTCB = NULL; + } + } + } + #else /* portSTACK_GROWTH */ + { + StackType_t *pxStack; + + /* Allocate space for the stack used by the task being created. */ + pxStack = ( StackType_t * ) pvPortMallocAligned( ( ( ( size_t ) usStackDepth ) * sizeof( StackType_t ) ), puxStackBuffer ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + + if( pxStack != NULL ) + { + /* Allocate space for the TCB. Where the memory comes from depends + on the implementation of the port malloc function. */ + pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) ); + + if( pxNewTCB != NULL ) + { + /* Store the stack location in the TCB. */ + pxNewTCB->pxStack = pxStack; + } + else + { + /* The stack cannot be used as the TCB was not created. Free it + again. */ + vPortFree( pxStack ); + } + } + else + { + pxNewTCB = NULL; + } + } + #endif /* portSTACK_GROWTH */ + + if( pxNewTCB != NULL ) + { + /* Avoid dependency on memset() if it is not required. */ + #if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) || ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) + { + /* Just to help debugging. */ + ( void ) memset( pxNewTCB->pxStack, ( int ) tskSTACK_FILL_BYTE, ( size_t ) usStackDepth * sizeof( StackType_t ) ); + } + #endif /* ( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) || ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) ) */ + } + + return pxNewTCB; +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_TRACE_FACILITY == 1 ) + + static UBaseType_t prvListTaskWithinSingleList( TaskStatus_t *pxTaskStatusArray, List_t *pxList, eTaskState eState ) + { + volatile TCB_t *pxNextTCB, *pxFirstTCB; + UBaseType_t uxTask = 0; + + if( listCURRENT_LIST_LENGTH( pxList ) > ( UBaseType_t ) 0 ) + { + listGET_OWNER_OF_NEXT_ENTRY( pxFirstTCB, pxList ); + + /* Populate an TaskStatus_t structure within the + pxTaskStatusArray array for each task that is referenced from + pxList. See the definition of TaskStatus_t in task.h for the + meaning of each TaskStatus_t structure member. */ + do + { + listGET_OWNER_OF_NEXT_ENTRY( pxNextTCB, pxList ); + + pxTaskStatusArray[ uxTask ].xHandle = ( TaskHandle_t ) pxNextTCB; + pxTaskStatusArray[ uxTask ].pcTaskName = ( const char * ) &( pxNextTCB->pcTaskName [ 0 ] ); + pxTaskStatusArray[ uxTask ].xTaskNumber = pxNextTCB->uxTCBNumber; + pxTaskStatusArray[ uxTask ].eCurrentState = eState; + pxTaskStatusArray[ uxTask ].uxCurrentPriority = pxNextTCB->uxPriority; + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + /* If the task is in the suspended list then there is a chance + it is actually just blocked indefinitely - so really it should + be reported as being in the Blocked state. */ + if( eState == eSuspended ) + { + if( listLIST_ITEM_CONTAINER( &( pxNextTCB->xEventListItem ) ) != NULL ) + { + pxTaskStatusArray[ uxTask ].eCurrentState = eBlocked; + } + } + } + #endif /* INCLUDE_vTaskSuspend */ + + #if ( configUSE_MUTEXES == 1 ) + { + pxTaskStatusArray[ uxTask ].uxBasePriority = pxNextTCB->uxBasePriority; + } + #else + { + pxTaskStatusArray[ uxTask ].uxBasePriority = 0; + } + #endif + + #if ( configGENERATE_RUN_TIME_STATS == 1 ) + { + pxTaskStatusArray[ uxTask ].ulRunTimeCounter = pxNextTCB->ulRunTimeCounter; + } + #else + { + pxTaskStatusArray[ uxTask ].ulRunTimeCounter = 0; + } + #endif + + #if ( portSTACK_GROWTH > 0 ) + { + pxTaskStatusArray[ uxTask ].usStackHighWaterMark = prvTaskCheckFreeStackSpace( ( uint8_t * ) pxNextTCB->pxEndOfStack ); + } + #else + { + pxTaskStatusArray[ uxTask ].usStackHighWaterMark = prvTaskCheckFreeStackSpace( ( uint8_t * ) pxNextTCB->pxStack ); + } + #endif + + uxTask++; + + } while( pxNextTCB != pxFirstTCB ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + return uxTask; + } + +#endif /* configUSE_TRACE_FACILITY */ +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) + + static uint16_t prvTaskCheckFreeStackSpace( const uint8_t * pucStackByte ) + { + uint32_t ulCount = 0U; + + while( *pucStackByte == ( uint8_t ) tskSTACK_FILL_BYTE ) + { + pucStackByte -= portSTACK_GROWTH; + ulCount++; + } + + ulCount /= ( uint32_t ) sizeof( StackType_t ); /*lint !e961 Casting is not redundant on smaller architectures. */ + + return ( uint16_t ) ulCount; + } + +#endif /* ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) + + UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask ) + { + TCB_t *pxTCB; + uint8_t *pucEndOfStack; + UBaseType_t uxReturn; + + pxTCB = prvGetTCBFromHandle( xTask ); + + #if portSTACK_GROWTH < 0 + { + pucEndOfStack = ( uint8_t * ) pxTCB->pxStack; + } + #else + { + pucEndOfStack = ( uint8_t * ) pxTCB->pxEndOfStack; + } + #endif + + uxReturn = ( UBaseType_t ) prvTaskCheckFreeStackSpace( pucEndOfStack ); + + return uxReturn; + } + +#endif /* INCLUDE_uxTaskGetStackHighWaterMark */ +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_vTaskDelete == 1 ) + + static void prvDeleteTCB( TCB_t *pxTCB ) + { + /* This call is required specifically for the TriCore port. It must be + above the vPortFree() calls. The call is also used by ports/demos that + want to allocate and clean RAM statically. */ + portCLEAN_UP_TCB( pxTCB ); + + /* Free up the memory allocated by the scheduler for the task. It is up + to the task to free any memory allocated at the application level. */ + #if ( configUSE_NEWLIB_REENTRANT == 1 ) + { + _reclaim_reent( &( pxTCB->xNewLib_reent ) ); + } + #endif /* configUSE_NEWLIB_REENTRANT */ + + #if( portUSING_MPU_WRAPPERS == 1 ) + { + /* Only free the stack if it was allocated dynamically in the first + place. */ + if( pxTCB->xUsingStaticallyAllocatedStack == pdFALSE ) + { + vPortFreeAligned( pxTCB->pxStack ); + } + } + #else + { + vPortFreeAligned( pxTCB->pxStack ); + } + #endif + + vPortFree( pxTCB ); + } + +#endif /* INCLUDE_vTaskDelete */ +/*-----------------------------------------------------------*/ + +static void prvResetNextTaskUnblockTime( void ) +{ +TCB_t *pxTCB; + + if( listLIST_IS_EMPTY( pxDelayedTaskList ) != pdFALSE ) + { + /* The new current delayed list is empty. Set + xNextTaskUnblockTime to the maximum possible value so it is + extremely unlikely that the + if( xTickCount >= xNextTaskUnblockTime ) test will pass until + there is an item in the delayed list. */ + xNextTaskUnblockTime = portMAX_DELAY; + } + else + { + /* The new current delayed list is not empty, get the value of + the item at the head of the delayed list. This is the time at + which the task at the head of the delayed list should be removed + from the Blocked state. */ + ( pxTCB ) = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedTaskList ); + xNextTaskUnblockTime = listGET_LIST_ITEM_VALUE( &( ( pxTCB )->xGenericListItem ) ); + } +} +/*-----------------------------------------------------------*/ + +#if ( ( INCLUDE_xTaskGetCurrentTaskHandle == 1 ) || ( configUSE_MUTEXES == 1 ) ) + + TaskHandle_t xTaskGetCurrentTaskHandle( void ) + { + TaskHandle_t xReturn; + + /* A critical section is not required as this is not called from + an interrupt and the current TCB will always be the same for any + individual execution thread. */ + xReturn = pxCurrentTCB[ xPortGetCoreID() ]; + + return xReturn; + } + +#endif /* ( ( INCLUDE_xTaskGetCurrentTaskHandle == 1 ) || ( configUSE_MUTEXES == 1 ) ) */ +/*-----------------------------------------------------------*/ + +#if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + + BaseType_t xTaskGetSchedulerState( void ) + { + BaseType_t xReturn; + + if( xSchedulerRunning == pdFALSE ) + { + xReturn = taskSCHEDULER_NOT_STARTED; + } + else + { + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + xReturn = taskSCHEDULER_RUNNING; + } + else + { + xReturn = taskSCHEDULER_SUSPENDED; + } + } + + return xReturn; + } + +#endif /* ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) */ +/*-----------------------------------------------------------*/ + +/* +ToDo: Mutexes haven't been tested or adapted to multicore at all. + +In fact, nothing below this line has/is. +*/ + +#if ( configUSE_MUTEXES == 1 ) + + void vTaskPriorityInherit( TaskHandle_t const pxMutexHolder ) + { + TCB_t * const pxTCB = ( TCB_t * ) pxMutexHolder; + + taskENTER_CRITICAL(&xTickCountMutex); + /* If the mutex was given back by an interrupt while the queue was + locked then the mutex holder might now be NULL. */ + if( pxMutexHolder != NULL ) + { + if( pxTCB->uxPriority < pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* Adjust the mutex holder state to account for its new + priority. Only reset the event list item value if the value is + not being used for anything else. */ + if( ( listGET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ) ) & taskEVENT_LIST_ITEM_VALUE_IN_USE ) == 0UL ) + { + listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* If the task being modified is in the ready state it will need to + be moved into a new list. */ + if( listIS_CONTAINED_WITHIN( &( pxReadyTasksLists[ pxTCB->uxPriority ] ), &( pxTCB->xGenericListItem ) ) != pdFALSE ) + { + if( uxListRemove( &( pxTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + taskRESET_READY_PRIORITY( pxTCB->uxPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Inherit the priority before being moved into the new list. */ + pxTCB->uxPriority = pxCurrentTCB[ xPortGetCoreID() ]->uxPriority; + prvAddTaskToReadyList( pxTCB ); + } + else + { + /* Just inherit the priority. */ + pxTCB->uxPriority = pxCurrentTCB[ xPortGetCoreID() ]->uxPriority; + } + + traceTASK_PRIORITY_INHERIT( pxTCB, pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + taskEXIT_CRITICAL(&xTickCountMutex); + + } + +#endif /* configUSE_MUTEXES */ +/*-----------------------------------------------------------*/ + +#if ( configUSE_MUTEXES == 1 ) + + BaseType_t xTaskPriorityDisinherit( TaskHandle_t const pxMutexHolder ) + { + TCB_t * const pxTCB = ( TCB_t * ) pxMutexHolder; + BaseType_t xReturn = pdFALSE; + taskENTER_CRITICAL(&xTickCountMutex); + + if( pxMutexHolder != NULL ) + { + configASSERT( pxTCB->uxMutexesHeld ); + ( pxTCB->uxMutexesHeld )--; + + if( pxTCB->uxPriority != pxTCB->uxBasePriority ) + { + /* Only disinherit if no other mutexes are held. */ + if( pxTCB->uxMutexesHeld == ( UBaseType_t ) 0 ) + { + /* A task can only have an inhertied priority if it holds + the mutex. If the mutex is held by a task then it cannot be + given from an interrupt, and if a mutex is given by the + holding task then it must be the running state task. Remove + the holding task from the ready list. */ + if( uxListRemove( &( pxTCB->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + taskRESET_READY_PRIORITY( pxTCB->uxPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Disinherit the priority before adding the task into the + new ready list. */ + traceTASK_PRIORITY_DISINHERIT( pxTCB, pxTCB->uxBasePriority ); + pxTCB->uxPriority = pxTCB->uxBasePriority; + + /* Reset the event list item value. It cannot be in use for + any other purpose if this task is running, and it must be + running to give back the mutex. */ + listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxTCB->uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + prvAddTaskToReadyList( pxTCB ); + + /* Return true to indicate that a context switch is required. + This is only actually required in the corner case whereby + multiple mutexes were held and the mutexes were given back + in an order different to that in which they were taken. + If a context switch did not occur when the first mutex was + returned, even if a task was waiting on it, then a context + switch should occur when the last mutex is returned whether + a task is waiting on it or not. */ + xReturn = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + taskEXIT_CRITICAL(&xTickCountMutex); + return xReturn; + } + +#endif /* configUSE_MUTEXES */ +/*-----------------------------------------------------------*/ + +/* For multicore, this assumes the vPortCPUAquireMutex is recursive, that is, it can be called multiple + times and the release call will have to be called as many times for the mux to unlock. */ + +/* Gotcha (which seems to be deliberate in FreeRTOS, according to +http://www.freertos.org/FreeRTOS_Support_Forum_Archive/December_2012/freertos_PIC32_Bug_-_vTaskEnterCritical_6400806.html +) is that calling vTaskEnterCritical followed by vTaskExitCritical will leave the interrupts DISABLED! Re-enabling the +scheduler will re-enable the interrupts instead. */ + + +#if ( portCRITICAL_NESTING_IN_TCB == 1 ) + + +#ifdef portMUX_DEBUG + void vTaskEnterCritical( portMUX_TYPE *mux, const char *function, int line ) +#else + void vTaskEnterCritical( portMUX_TYPE *mux ) +#endif + { + portDISABLE_INTERRUPTS(); +#ifdef portMUX_DEBUG + vPortCPUAcquireMutex( mux, function, line ); +#else + vPortCPUAcquireMutex( mux ); +#endif + + if( xSchedulerRunning != pdFALSE ) + { + ( pxCurrentTCB[ xPortGetCoreID() ]->uxCriticalNesting )++; + + /* This is not the interrupt safe version of the enter critical + function so assert() if it is being called from an interrupt + context. Only API functions that end in "FromISR" can be used in an + interrupt. Only assert if the critical nesting count is 1 to + protect against recursive calls if the assert function also uses a + critical section. */ + if( pxCurrentTCB[ xPortGetCoreID() ]->uxCriticalNesting == 1 ) + { + portASSERT_IF_IN_ISR(); + } + + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* portCRITICAL_NESTING_IN_TCB */ +/*-----------------------------------------------------------*/ + +#if ( portCRITICAL_NESTING_IN_TCB == 1 ) + +#ifdef portMUX_DEBUG + void vTaskExitCritical( portMUX_TYPE *mux, const char *function, int line ) +#else + void vTaskExitCritical( portMUX_TYPE *mux ) +#endif + { +#ifdef portMUX_DEBUG + vPortCPUReleaseMutex( mux, function, line ); +#else + vPortCPUReleaseMutex( mux ); +#endif + if( xSchedulerRunning != pdFALSE ) + { + if( pxCurrentTCB[ xPortGetCoreID() ]->uxCriticalNesting > 0U ) + { + ( pxCurrentTCB[ xPortGetCoreID() ]->uxCriticalNesting )--; + + if( pxCurrentTCB[ xPortGetCoreID() ]->uxCriticalNesting == 0U ) + { + portENABLE_INTERRUPTS(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* portCRITICAL_NESTING_IN_TCB */ +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) + + static char *prvWriteNameToBuffer( char *pcBuffer, const char *pcTaskName ) + { + BaseType_t x; + + /* Start by copying the entire string. */ + strcpy( pcBuffer, pcTaskName ); + + /* Pad the end of the string with spaces to ensure columns line up when + printed out. */ + for( x = strlen( pcBuffer ); x < ( configMAX_TASK_NAME_LEN - 1 ); x++ ) + { + pcBuffer[ x ] = ' '; + } + + /* Terminate. */ + pcBuffer[ x ] = 0x00; + + /* Return the new end of string. */ + return &( pcBuffer[ x ] ); + } + +#endif /* ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) */ +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) + + void vTaskList( char * pcWriteBuffer ) + { + TaskStatus_t *pxTaskStatusArray; + volatile UBaseType_t uxArraySize, x; + char cStatus; + + /* + * PLEASE NOTE: + * + * This function is provided for convenience only, and is used by many + * of the demo applications. Do not consider it to be part of the + * scheduler. + * + * vTaskList() calls uxTaskGetSystemState(), then formats part of the + * uxTaskGetSystemState() output into a human readable table that + * displays task names, states and stack usage. + * + * vTaskList() has a dependency on the sprintf() C library function that + * might bloat the code size, use a lot of stack, and provide different + * results on different platforms. An alternative, tiny, third party, + * and limited functionality implementation of sprintf() is provided in + * many of the FreeRTOS/Demo sub-directories in a file called + * printf-stdarg.c (note printf-stdarg.c does not provide a full + * snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() + * directly to get access to raw stats data, rather than indirectly + * through a call to vTaskList(). + */ + + + /* Make sure the write buffer does not contain a string. */ + *pcWriteBuffer = 0x00; + + /* Take a snapshot of the number of tasks in case it changes while this + function is executing. */ + uxArraySize = uxCurrentNumberOfTasks; + + /* Allocate an array index for each task. */ + pxTaskStatusArray = pvPortMalloc( uxCurrentNumberOfTasks * sizeof( TaskStatus_t ) ); + + if( pxTaskStatusArray != NULL ) + { + /* Generate the (binary) data. */ + uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, NULL ); + + /* Create a human readable table from the binary data. */ + for( x = 0; x < uxArraySize; x++ ) + { + switch( pxTaskStatusArray[ x ].eCurrentState ) + { + case eReady: cStatus = tskREADY_CHAR; + break; + + case eBlocked: cStatus = tskBLOCKED_CHAR; + break; + + case eSuspended: cStatus = tskSUSPENDED_CHAR; + break; + + case eDeleted: cStatus = tskDELETED_CHAR; + break; + + default: /* Should not get here, but it is included + to prevent static checking errors. */ + cStatus = 0x00; + break; + } + + /* Write the task name to the string, padding with spaces so it + can be printed in tabular form more easily. */ + pcWriteBuffer = prvWriteNameToBuffer( pcWriteBuffer, pxTaskStatusArray[ x ].pcTaskName ); + + /* Write the rest of the string. */ + sprintf( pcWriteBuffer, "\t%c\t%u\t%u\t%u\r\n", cStatus, ( unsigned int ) pxTaskStatusArray[ x ].uxCurrentPriority, ( unsigned int ) pxTaskStatusArray[ x ].usStackHighWaterMark, ( unsigned int ) pxTaskStatusArray[ x ].xTaskNumber ); + pcWriteBuffer += strlen( pcWriteBuffer ); + } + + /* Free the array again. */ + vPortFree( pxTaskStatusArray ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) */ +/*----------------------------------------------------------*/ + +#if ( ( configGENERATE_RUN_TIME_STATS == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) + + void vTaskGetRunTimeStats( char *pcWriteBuffer ) + { + TaskStatus_t *pxTaskStatusArray; + volatile UBaseType_t uxArraySize, x; + uint32_t ulTotalTime, ulStatsAsPercentage; + + #if( configUSE_TRACE_FACILITY != 1 ) + { + #error configUSE_TRACE_FACILITY must also be set to 1 in FreeRTOSConfig.h to use vTaskGetRunTimeStats(). + } + #endif + + /* + * PLEASE NOTE: + * + * This function is provided for convenience only, and is used by many + * of the demo applications. Do not consider it to be part of the + * scheduler. + * + * vTaskGetRunTimeStats() calls uxTaskGetSystemState(), then formats part + * of the uxTaskGetSystemState() output into a human readable table that + * displays the amount of time each task has spent in the Running state + * in both absolute and percentage terms. + * + * vTaskGetRunTimeStats() has a dependency on the sprintf() C library + * function that might bloat the code size, use a lot of stack, and + * provide different results on different platforms. An alternative, + * tiny, third party, and limited functionality implementation of + * sprintf() is provided in many of the FreeRTOS/Demo sub-directories in + * a file called printf-stdarg.c (note printf-stdarg.c does not provide + * a full snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() + * directly to get access to raw stats data, rather than indirectly + * through a call to vTaskGetRunTimeStats(). + */ + + /* Make sure the write buffer does not contain a string. */ + *pcWriteBuffer = 0x00; + + /* Take a snapshot of the number of tasks in case it changes while this + function is executing. */ + uxArraySize = uxCurrentNumberOfTasks; + + /* Allocate an array index for each task. */ + pxTaskStatusArray = pvPortMalloc( uxCurrentNumberOfTasks * sizeof( TaskStatus_t ) ); + + if( pxTaskStatusArray != NULL ) + { + /* Generate the (binary) data. */ + uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, &ulTotalTime ); + + /* For percentage calculations. */ + ulTotalTime /= 100UL; + + /* Avoid divide by zero errors. */ + if( ulTotalTime > 0 ) + { + /* Create a human readable table from the binary data. */ + for( x = 0; x < uxArraySize; x++ ) + { + /* What percentage of the total run time has the task used? + This will always be rounded down to the nearest integer. + ulTotalRunTimeDiv100 has already been divided by 100. */ + ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter / ulTotalTime; + + /* Write the task name to the string, padding with + spaces so it can be printed in tabular form more + easily. */ + pcWriteBuffer = prvWriteNameToBuffer( pcWriteBuffer, pxTaskStatusArray[ x ].pcTaskName ); + + if( ulStatsAsPercentage > 0UL ) + { + #ifdef portLU_PRINTF_SPECIFIER_REQUIRED + { + sprintf( pcWriteBuffer, "\t%lu\t\t%lu%%\r\n", pxTaskStatusArray[ x ].ulRunTimeCounter, ulStatsAsPercentage ); + } + #else + { + /* sizeof( int ) == sizeof( long ) so a smaller + printf() library can be used. */ + sprintf( pcWriteBuffer, "\t%u\t\t%u%%\r\n", ( unsigned int ) pxTaskStatusArray[ x ].ulRunTimeCounter, ( unsigned int ) ulStatsAsPercentage ); + } + #endif + } + else + { + /* If the percentage is zero here then the task has + consumed less than 1% of the total run time. */ + #ifdef portLU_PRINTF_SPECIFIER_REQUIRED + { + sprintf( pcWriteBuffer, "\t%lu\t\t<1%%\r\n", pxTaskStatusArray[ x ].ulRunTimeCounter ); + } + #else + { + /* sizeof( int ) == sizeof( long ) so a smaller + printf() library can be used. */ + sprintf( pcWriteBuffer, "\t%u\t\t<1%%\r\n", ( unsigned int ) pxTaskStatusArray[ x ].ulRunTimeCounter ); + } + #endif + } + + pcWriteBuffer += strlen( pcWriteBuffer ); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Free the array again. */ + vPortFree( pxTaskStatusArray ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + +#endif /* ( ( configGENERATE_RUN_TIME_STATS == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) */ +/*-----------------------------------------------------------*/ + +TickType_t uxTaskResetEventItemValue( void ) +{ +TickType_t uxReturn; + taskENTER_CRITICAL(&xTaskQueueMutex); + uxReturn = listGET_LIST_ITEM_VALUE( &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ) ); + + /* Reset the event list item to its normal value - so it can be used with + queues and semaphores. */ + listSET_LIST_ITEM_VALUE( &( pxCurrentTCB[ xPortGetCoreID() ]->xEventListItem ), ( ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */ + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +#if ( configUSE_MUTEXES == 1 ) + + void *pvTaskIncrementMutexHeldCount( void ) + { + /* If xSemaphoreCreateMutex() is called before any tasks have been created + then pxCurrentTCB will be NULL. */ + taskENTER_CRITICAL(&xTaskQueueMutex); + if( pxCurrentTCB[ xPortGetCoreID() ] != NULL ) + { + ( pxCurrentTCB[ xPortGetCoreID() ]->uxMutexesHeld )++; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return pxCurrentTCB[ xPortGetCoreID() ]; + } + +#endif /* configUSE_MUTEXES */ +/*-----------------------------------------------------------*/ + +#if( configUSE_TASK_NOTIFICATIONS == 1 ) + + uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait ) + { + TickType_t xTimeToWake; + uint32_t ulReturn; + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* Only block if the notification count is not already non-zero. */ + if( pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue == 0UL ) + { + /* Mark this task as waiting for a notification. */ + pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState = eWaitingNotification; + + if( xTicksToWait > ( TickType_t ) 0 ) + { + /* The task is going to block. First it must be removed + from the ready list. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is + no need to check, and the port reset macro can be called + directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + if( xTicksToWait == portMAX_DELAY ) + { + /* Add the task to the suspended task list instead + of a delayed task list to ensure the task is not + woken by a timing event. It will block + indefinitely. */ + vListInsertEnd( &xSuspendedTaskList, &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ); + } + else + { + /* Calculate the time at which the task should be + woken if no notification events occur. This may + overflow but this doesn't matter, the scheduler will + handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } + } + #else /* INCLUDE_vTaskSuspend */ + { + /* Calculate the time at which the task should be + woken if the event does not occur. This may + overflow but this doesn't matter, the scheduler will + handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xTimeToWake ); + } + #endif /* INCLUDE_vTaskSuspend */ + + /* All ports are written to allow a yield in a critical + section (some will yield immediately, others wait until the + critical section exits) - but it is not something that + application code should ever do. */ + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + ulReturn = pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue; + + if( ulReturn != 0UL ) + { + if( xClearCountOnExit != pdFALSE ) + { + pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue = 0UL; + } + else + { + ( pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue )--; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState = eNotWaitingNotification; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return ulReturn; + } + +#endif /* configUSE_TASK_NOTIFICATIONS */ +/*-----------------------------------------------------------*/ + +#if( configUSE_TASK_NOTIFICATIONS == 1 ) + + BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait ) + { + TickType_t xTimeToWake; + BaseType_t xReturn; + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + /* Only block if a notification is not already pending. */ + if( pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState != eNotified ) + { + /* Clear bits in the task's notification value as bits may get + set by the notifying task or interrupt. This can be used to + clear the value to zero. */ + pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue &= ~ulBitsToClearOnEntry; + + /* Mark this task as waiting for a notification. */ + pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState = eWaitingNotification; + + if( xTicksToWait > ( TickType_t ) 0 ) + { + /* The task is going to block. First it must be removed + from the ready list. */ + if( uxListRemove( &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ) == ( UBaseType_t ) 0 ) + { + /* The current task must be in a ready list, so there is + no need to check, and the port reset macro can be called + directly. */ + portRESET_READY_PRIORITY( pxCurrentTCB[ xPortGetCoreID() ]->uxPriority, uxTopReadyPriority ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + #if ( INCLUDE_vTaskSuspend == 1 ) + { + if( xTicksToWait == portMAX_DELAY ) + { + /* Add the task to the suspended task list instead + of a delayed task list to ensure the task is not + woken by a timing event. It will block + indefinitely. */ + vListInsertEnd( &xSuspendedTaskList, &( pxCurrentTCB[ xPortGetCoreID() ]->xGenericListItem ) ); + } + else + { + /* Calculate the time at which the task should be + woken if no notification events occur. This may + overflow but this doesn't matter, the scheduler will + handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xPortGetCoreID(), xTimeToWake ); + } + } + #else /* INCLUDE_vTaskSuspend */ + { + /* Calculate the time at which the task should be + woken if the event does not occur. This may + overflow but this doesn't matter, the scheduler will + handle it. */ + xTimeToWake = xTickCount + xTicksToWait; + prvAddCurrentTaskToDelayedList( xTimeToWake ); + } + #endif /* INCLUDE_vTaskSuspend */ + + /* All ports are written to allow a yield in a critical + section (some will yield immediately, others wait until the + critical section exits) - but it is not something that + application code should ever do. */ + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + if( pulNotificationValue != NULL ) + { + /* Output the current notification value, which may or may not + have changed. */ + *pulNotificationValue = pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue; + } + + /* If eNotifyValue is set then either the task never entered the + blocked state (because a notification was already pending) or the + task unblocked because of a notification. Otherwise the task + unblocked because of a timeout. */ + if( pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState == eWaitingNotification ) + { + /* A notification was not received. */ + xReturn = pdFALSE; + } + else + { + /* A notification was already pending or a notification was + received while the task was waiting. */ + pxCurrentTCB[ xPortGetCoreID() ]->ulNotifiedValue &= ~ulBitsToClearOnExit; + xReturn = pdTRUE; + } + + pxCurrentTCB[ xPortGetCoreID() ]->eNotifyState = eNotWaitingNotification; + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; + } + +#endif /* configUSE_TASK_NOTIFICATIONS */ +/*-----------------------------------------------------------*/ + +#if( configUSE_TASK_NOTIFICATIONS == 1 ) + + BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction ) + { + TCB_t * pxTCB; + eNotifyValue eOriginalNotifyState; + BaseType_t xReturn = pdPASS; + + configASSERT( xTaskToNotify ); + pxTCB = ( TCB_t * ) xTaskToNotify; + + taskENTER_CRITICAL(&xTaskQueueMutex); + { + eOriginalNotifyState = pxTCB->eNotifyState; + + pxTCB->eNotifyState = eNotified; + + switch( eAction ) + { + case eSetBits : + pxTCB->ulNotifiedValue |= ulValue; + break; + + case eIncrement : + ( pxTCB->ulNotifiedValue )++; + break; + + case eSetValueWithOverwrite : + pxTCB->ulNotifiedValue = ulValue; + break; + + case eSetValueWithoutOverwrite : + if( eOriginalNotifyState != eNotified ) + { + pxTCB->ulNotifiedValue = ulValue; + } + else + { + /* The value could not be written to the task. */ + xReturn = pdFAIL; + } + break; + + case eNoAction: + /* The task is being notified without its notify value being + updated. */ + break; + } + + + /* If the task is in the blocked state specifically to wait for a + notification then unblock it now. */ + if( eOriginalNotifyState == eWaitingNotification ) + { + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + + /* The task should not have been on an event list. */ + configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL ); + + if( pxTCB->uxPriority > pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* The notified task has a priority above the currently + executing task so a yield is required. */ + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(&xTaskQueueMutex); + + return xReturn; + } + +#endif /* configUSE_TASK_NOTIFICATIONS */ +/*-----------------------------------------------------------*/ + +#if( configUSE_TASK_NOTIFICATIONS == 1 ) + + BaseType_t xTaskNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, BaseType_t *pxHigherPriorityTaskWoken ) + { + TCB_t * pxTCB; + eNotifyValue eOriginalNotifyState; + BaseType_t xReturn = pdPASS; + + configASSERT( xTaskToNotify ); + + pxTCB = ( TCB_t * ) xTaskToNotify; + + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + + { + eOriginalNotifyState = pxTCB->eNotifyState; + + pxTCB->eNotifyState = eNotified; + + switch( eAction ) + { + case eSetBits : + pxTCB->ulNotifiedValue |= ulValue; + break; + + case eIncrement : + ( pxTCB->ulNotifiedValue )++; + break; + + case eSetValueWithOverwrite : + pxTCB->ulNotifiedValue = ulValue; + break; + + case eSetValueWithoutOverwrite : + if( eOriginalNotifyState != eNotified ) + { + pxTCB->ulNotifiedValue = ulValue; + } + else + { + /* The value could not be written to the task. */ + xReturn = pdFAIL; + } + break; + + case eNoAction : + /* The task is being notified without its notify value being + updated. */ + break; + } + + + /* If the task is in the blocked state specifically to wait for a + notification then unblock it now. */ + if( eOriginalNotifyState == eWaitingNotification ) + { + /* The task should not have been on an event list. */ + configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL ); + + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + } + else + { + /* The delayed and ready lists cannot be accessed, so hold + this task pending until the scheduler is resumed. */ + vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) ); + } + + if( pxTCB->uxPriority > pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* The notified task has a priority above the currently + executing task so a yield is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + + return xReturn; + } + +#endif /* configUSE_TASK_NOTIFICATIONS */ +/*-----------------------------------------------------------*/ + +#if( configUSE_TASK_NOTIFICATIONS == 1 ) + + void vTaskNotifyGiveFromISR( TaskHandle_t xTaskToNotify, BaseType_t *pxHigherPriorityTaskWoken ) + { + TCB_t * pxTCB; + eNotifyValue eOriginalNotifyState; + + configASSERT( xTaskToNotify ); + + + pxTCB = ( TCB_t * ) xTaskToNotify; + + taskENTER_CRITICAL_ISR(&xTaskQueueMutex); + { + eOriginalNotifyState = pxTCB->eNotifyState; + pxTCB->eNotifyState = eNotified; + + /* 'Giving' is equivalent to incrementing a count in a counting + semaphore. */ + ( pxTCB->ulNotifiedValue )++; + + /* If the task is in the blocked state specifically to wait for a + notification then unblock it now. */ + if( eOriginalNotifyState == eWaitingNotification ) + { + /* The task should not have been on an event list. */ + configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL ); + + if( uxSchedulerSuspended[ xPortGetCoreID() ] == ( UBaseType_t ) pdFALSE ) + { + ( void ) uxListRemove( &( pxTCB->xGenericListItem ) ); + prvAddTaskToReadyList( pxTCB ); + } + else + { + /* The delayed and ready lists cannot be accessed, so hold + this task pending until the scheduler is resumed. */ + vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) ); + } + + if( pxTCB->uxPriority > pxCurrentTCB[ xPortGetCoreID() ]->uxPriority ) + { + /* The notified task has a priority above the currently + executing task so a yield is required. */ + if( pxHigherPriorityTaskWoken != NULL ) + { + *pxHigherPriorityTaskWoken = pdTRUE; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + taskEXIT_CRITICAL_ISR(&xTaskQueueMutex); + } + +#endif /* configUSE_TASK_NOTIFICATIONS */ + +/*-----------------------------------------------------------*/ + + +#ifdef FREERTOS_MODULE_TEST + #include "tasks_test_access_functions.h" +#endif + diff --git a/components/freertos/timers.c b/components/freertos/timers.c new file mode 100644 index 000000000..7c0ba5bd9 --- /dev/null +++ b/components/freertos/timers.c @@ -0,0 +1,909 @@ +/* + FreeRTOS V8.2.0 - Copyright (C) 2015 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* Standard includes. */ +#include + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +#include "FreeRTOS.h" +#include "task.h" +#include "queue.h" +#include "timers.h" +#include "portmacro.h" + +#if ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 0 ) + #error configUSE_TIMERS must be set to 1 to make the xTimerPendFunctionCall() function available. +#endif + +/* Lint e961 and e750 are suppressed as a MISRA exception justified because the +MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the +header files above, but not in this file, in order to generate the correct +privileged Vs unprivileged linkage and placement. */ +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */ + + +/* This entire source file will be skipped if the application is not configured +to include software timer functionality. This #if is closed at the very bottom +of this file. If you want to include software timer functionality then ensure +configUSE_TIMERS is set to 1 in FreeRTOSConfig.h. */ +#if ( configUSE_TIMERS == 1 ) + +/* Misc definitions. */ +#define tmrNO_DELAY ( TickType_t ) 0U + +/* The definition of the timers themselves. */ +typedef struct tmrTimerControl +{ + const char *pcTimerName; /*<< Text name. This is not used by the kernel, it is included simply to make debugging easier. */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + ListItem_t xTimerListItem; /*<< Standard linked list item as used by all kernel features for event management. */ + TickType_t xTimerPeriodInTicks;/*<< How quickly and often the timer expires. */ + UBaseType_t uxAutoReload; /*<< Set to pdTRUE if the timer should be automatically restarted once expired. Set to pdFALSE if the timer is, in effect, a one-shot timer. */ + void *pvTimerID; /*<< An ID to identify the timer. This allows the timer to be identified when the same callback is used for multiple timers. */ + TimerCallbackFunction_t pxCallbackFunction; /*<< The function that will be called when the timer expires. */ + #if( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxTimerNumber; /*<< An ID assigned by trace tools such as FreeRTOS+Trace */ + #endif +} xTIMER; + +/* The old xTIMER name is maintained above then typedefed to the new Timer_t +name below to enable the use of older kernel aware debuggers. */ +typedef xTIMER Timer_t; + +/* The definition of messages that can be sent and received on the timer queue. +Two types of message can be queued - messages that manipulate a software timer, +and messages that request the execution of a non-timer related callback. The +two message types are defined in two separate structures, xTimerParametersType +and xCallbackParametersType respectively. */ +typedef struct tmrTimerParameters +{ + TickType_t xMessageValue; /*<< An optional value used by a subset of commands, for example, when changing the period of a timer. */ + Timer_t * pxTimer; /*<< The timer to which the command will be applied. */ +} TimerParameter_t; + + +typedef struct tmrCallbackParameters +{ + PendedFunction_t pxCallbackFunction; /* << The callback function to execute. */ + void *pvParameter1; /* << The value that will be used as the callback functions first parameter. */ + uint32_t ulParameter2; /* << The value that will be used as the callback functions second parameter. */ +} CallbackParameters_t; + +/* The structure that contains the two message types, along with an identifier +that is used to determine which message type is valid. */ +typedef struct tmrTimerQueueMessage +{ + BaseType_t xMessageID; /*<< The command being sent to the timer service task. */ + union + { + TimerParameter_t xTimerParameters; + + /* Don't include xCallbackParameters if it is not going to be used as + it makes the structure (and therefore the timer queue) larger. */ + #if ( INCLUDE_xTimerPendFunctionCall == 1 ) + CallbackParameters_t xCallbackParameters; + #endif /* INCLUDE_xTimerPendFunctionCall */ + } u; +} DaemonTaskMessage_t; + +/*lint -e956 A manual analysis and inspection has been used to determine which +static variables must be declared volatile. */ + +/* The list in which active timers are stored. Timers are referenced in expire +time order, with the nearest expiry time at the front of the list. Only the +timer service task is allowed to access these lists. */ +PRIVILEGED_DATA static List_t xActiveTimerList1; +PRIVILEGED_DATA static List_t xActiveTimerList2; +PRIVILEGED_DATA static List_t *pxCurrentTimerList; +PRIVILEGED_DATA static List_t *pxOverflowTimerList; + +/* A queue that is used to send commands to the timer service task. */ +PRIVILEGED_DATA static QueueHandle_t xTimerQueue = NULL; + +/* Mux. We use a single mux for all the timers for now. ToDo: maybe increase granularity here? */ +PRIVILEGED_DATA portMUX_TYPE xTimerMux; + +#if ( INCLUDE_xTimerGetTimerDaemonTaskHandle == 1 ) + + PRIVILEGED_DATA static TaskHandle_t xTimerTaskHandle = NULL; + +#endif + +/*lint +e956 */ + +/*-----------------------------------------------------------*/ + +/* + * Initialise the infrastructure used by the timer service task if it has not + * been initialised already. + */ +static void prvCheckForValidListAndQueue( void ) PRIVILEGED_FUNCTION; + +/* + * The timer service task (daemon). Timer functionality is controlled by this + * task. Other tasks communicate with the timer service task using the + * xTimerQueue queue. + */ +static void prvTimerTask( void *pvParameters ) PRIVILEGED_FUNCTION; + +/* + * Called by the timer service task to interpret and process a command it + * received on the timer queue. + */ +static void prvProcessReceivedCommands( void ) PRIVILEGED_FUNCTION; + +/* + * Insert the timer into either xActiveTimerList1, or xActiveTimerList2, + * depending on if the expire time causes a timer counter overflow. + */ +static BaseType_t prvInsertTimerInActiveList( Timer_t * const pxTimer, const TickType_t xNextExpiryTime, const TickType_t xTimeNow, const TickType_t xCommandTime ) PRIVILEGED_FUNCTION; + +/* + * An active timer has reached its expire time. Reload the timer if it is an + * auto reload timer, then call its callback. + */ +static void prvProcessExpiredTimer( const TickType_t xNextExpireTime, const TickType_t xTimeNow ) PRIVILEGED_FUNCTION; + +/* + * The tick count has overflowed. Switch the timer lists after ensuring the + * current timer list does not still reference some timers. + */ +static void prvSwitchTimerLists( void ) PRIVILEGED_FUNCTION; + +/* + * Obtain the current tick count, setting *pxTimerListsWereSwitched to pdTRUE + * if a tick count overflow occurred since prvSampleTimeNow() was last called. + */ +static TickType_t prvSampleTimeNow( BaseType_t * const pxTimerListsWereSwitched ) PRIVILEGED_FUNCTION; + +/* + * If the timer list contains any active timers then return the expire time of + * the timer that will expire first and set *pxListWasEmpty to false. If the + * timer list does not contain any timers then return 0 and set *pxListWasEmpty + * to pdTRUE. + */ +static TickType_t prvGetNextExpireTime( BaseType_t * const pxListWasEmpty ) PRIVILEGED_FUNCTION; + +/* + * If a timer has expired, process it. Otherwise, block the timer service task + * until either a timer does expire or a command is received. + */ +static void prvProcessTimerOrBlockTask( const TickType_t xNextExpireTime, const BaseType_t xListWasEmpty ) PRIVILEGED_FUNCTION; + +/*-----------------------------------------------------------*/ + +BaseType_t xTimerCreateTimerTask( void ) +{ +BaseType_t xReturn = pdFAIL; + + /* This function is called when the scheduler is started if + configUSE_TIMERS is set to 1. Check that the infrastructure used by the + timer service task has been created/initialised. If timers have already + been created then the initialisation will already have been performed. */ + + /* For now, the timer task will be fixed to core 0. This means whatever process + running on whatever core schedules the timer, the timer callback function + will *ALWAYS* run on core 0. */ + prvCheckForValidListAndQueue(); + + if( xTimerQueue != NULL ) + { + #if ( INCLUDE_xTimerGetTimerDaemonTaskHandle == 1 ) + { + /* Create the timer task, storing its handle in xTimerTaskHandle so + it can be returned by the xTimerGetTimerDaemonTaskHandle() function. */ + xReturn = xTaskCreatePinnedToCore( prvTimerTask, "Tmr Svc", ( uint16_t ) configTIMER_TASK_STACK_DEPTH, NULL, ( ( UBaseType_t ) configTIMER_TASK_PRIORITY ) | portPRIVILEGE_BIT, &xTimerTaskHandle, 0 ); + } + #else + { + /* Create the timer task without storing its handle. */ + xReturn = xTaskCreatePinnedToCore( prvTimerTask, "Tmr Svc", ( uint16_t ) configTIMER_TASK_STACK_DEPTH, NULL, ( ( UBaseType_t ) configTIMER_TASK_PRIORITY ) | portPRIVILEGE_BIT, NULL, 0 ); + } + #endif + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + configASSERT( xReturn ); + return xReturn; +} +/*-----------------------------------------------------------*/ + +TimerHandle_t xTimerCreate( const char * const pcTimerName, const TickType_t xTimerPeriodInTicks, const UBaseType_t uxAutoReload, void * const pvTimerID, TimerCallbackFunction_t pxCallbackFunction ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +{ +Timer_t *pxNewTimer; + + /* Allocate the timer structure. */ + if( xTimerPeriodInTicks == ( TickType_t ) 0U ) + { + pxNewTimer = NULL; + } + else + { + pxNewTimer = ( Timer_t * ) pvPortMalloc( sizeof( Timer_t ) ); + if( pxNewTimer != NULL ) + { + /* Ensure the infrastructure used by the timer service task has been + created/initialised. */ + prvCheckForValidListAndQueue(); + + /* Initialise the timer structure members using the function parameters. */ + pxNewTimer->pcTimerName = pcTimerName; + pxNewTimer->xTimerPeriodInTicks = xTimerPeriodInTicks; + pxNewTimer->uxAutoReload = uxAutoReload; + pxNewTimer->pvTimerID = pvTimerID; + pxNewTimer->pxCallbackFunction = pxCallbackFunction; + vListInitialiseItem( &( pxNewTimer->xTimerListItem ) ); + + traceTIMER_CREATE( pxNewTimer ); + } + else + { + traceTIMER_CREATE_FAILED(); + } + } + + /* 0 is not a valid value for xTimerPeriodInTicks. */ + configASSERT( ( xTimerPeriodInTicks > 0 ) ); + + return ( TimerHandle_t ) pxNewTimer; +} +/*-----------------------------------------------------------*/ + +BaseType_t xTimerGenericCommand( TimerHandle_t xTimer, const BaseType_t xCommandID, const TickType_t xOptionalValue, BaseType_t * const pxHigherPriorityTaskWoken, const TickType_t xTicksToWait ) +{ +BaseType_t xReturn = pdFAIL; +DaemonTaskMessage_t xMessage; + + /* Send a message to the timer service task to perform a particular action + on a particular timer definition. */ + if( xTimerQueue != NULL ) + { + /* Send a command to the timer service task to start the xTimer timer. */ + xMessage.xMessageID = xCommandID; + xMessage.u.xTimerParameters.xMessageValue = xOptionalValue; + xMessage.u.xTimerParameters.pxTimer = ( Timer_t * ) xTimer; + + if( xCommandID < tmrFIRST_FROM_ISR_COMMAND ) + { + if( xTaskGetSchedulerState() == taskSCHEDULER_RUNNING ) + { + xReturn = xQueueSendToBack( xTimerQueue, &xMessage, xTicksToWait ); + } + else + { + xReturn = xQueueSendToBack( xTimerQueue, &xMessage, tmrNO_DELAY ); + } + } + else + { + xReturn = xQueueSendToBackFromISR( xTimerQueue, &xMessage, pxHigherPriorityTaskWoken ); + } + + traceTIMER_COMMAND_SEND( xTimer, xCommandID, xOptionalValue, xReturn ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + return xReturn; +} +/*-----------------------------------------------------------*/ + +#if ( INCLUDE_xTimerGetTimerDaemonTaskHandle == 1 ) + + TaskHandle_t xTimerGetTimerDaemonTaskHandle( void ) + { + /* If xTimerGetTimerDaemonTaskHandle() is called before the scheduler has been + started, then xTimerTaskHandle will be NULL. */ + configASSERT( ( xTimerTaskHandle != NULL ) ); + return xTimerTaskHandle; + } + +#endif +/*-----------------------------------------------------------*/ + +const char * pcTimerGetTimerName( TimerHandle_t xTimer ) +{ +Timer_t *pxTimer = ( Timer_t * ) xTimer; + + return pxTimer->pcTimerName; +} +/*-----------------------------------------------------------*/ + +static void prvProcessExpiredTimer( const TickType_t xNextExpireTime, const TickType_t xTimeNow ) +{ +BaseType_t xResult; +Timer_t * const pxTimer = ( Timer_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxCurrentTimerList ); + + /* Remove the timer from the list of active timers. A check has already + been performed to ensure the list is not empty. */ + ( void ) uxListRemove( &( pxTimer->xTimerListItem ) ); + traceTIMER_EXPIRED( pxTimer ); + + /* If the timer is an auto reload timer then calculate the next + expiry time and re-insert the timer in the list of active timers. */ + if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE ) + { + /* The timer is inserted into a list using a time relative to anything + other than the current time. It will therefore be inserted into the + correct list relative to the time this task thinks it is now. */ + if( prvInsertTimerInActiveList( pxTimer, ( xNextExpireTime + pxTimer->xTimerPeriodInTicks ), xTimeNow, xNextExpireTime ) == pdTRUE ) + { + /* The timer expired before it was added to the active timer + list. Reload it now. */ + xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xNextExpireTime, NULL, tmrNO_DELAY ); + configASSERT( xResult ); + ( void ) xResult; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Call the timer callback. */ + pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer ); +} +/*-----------------------------------------------------------*/ + +static void prvTimerTask( void *pvParameters ) +{ +TickType_t xNextExpireTime; +BaseType_t xListWasEmpty; + + /* Just to avoid compiler warnings. */ + ( void ) pvParameters; + + for( ;; ) + { + /* Query the timers list to see if it contains any timers, and if so, + obtain the time at which the next timer will expire. */ + xNextExpireTime = prvGetNextExpireTime( &xListWasEmpty ); + + /* If a timer has expired, process it. Otherwise, block this task + until either a timer does expire, or a command is received. */ + prvProcessTimerOrBlockTask( xNextExpireTime, xListWasEmpty ); + + /* Empty the command queue. */ + prvProcessReceivedCommands(); + } +} +/*-----------------------------------------------------------*/ + +static void prvProcessTimerOrBlockTask( const TickType_t xNextExpireTime, const BaseType_t xListWasEmpty ) +{ +TickType_t xTimeNow; +BaseType_t xTimerListsWereSwitched; + + vTaskSuspendAll(); + { + /* Obtain the time now to make an assessment as to whether the timer + has expired or not. If obtaining the time causes the lists to switch + then don't process this timer as any timers that remained in the list + when the lists were switched will have been processed within the + prvSampleTimeNow() function. */ + xTimeNow = prvSampleTimeNow( &xTimerListsWereSwitched ); + if( xTimerListsWereSwitched == pdFALSE ) + { + /* The tick count has not overflowed, has the timer expired? */ + if( ( xListWasEmpty == pdFALSE ) && ( xNextExpireTime <= xTimeNow ) ) + { + ( void ) xTaskResumeAll(); + prvProcessExpiredTimer( xNextExpireTime, xTimeNow ); + } + else + { + /* The tick count has not overflowed, and the next expire + time has not been reached yet. This task should therefore + block to wait for the next expire time or a command to be + received - whichever comes first. The following line cannot + be reached unless xNextExpireTime > xTimeNow, except in the + case when the current timer list is empty. */ + vQueueWaitForMessageRestricted( xTimerQueue, ( xNextExpireTime - xTimeNow ) ); + + if( xTaskResumeAll() == pdFALSE ) + { + /* Yield to wait for either a command to arrive, or the + block time to expire. If a command arrived between the + critical section being exited and this yield then the yield + will not cause the task to block. */ + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + } + else + { + ( void ) xTaskResumeAll(); + } + } +} +/*-----------------------------------------------------------*/ + +static TickType_t prvGetNextExpireTime( BaseType_t * const pxListWasEmpty ) +{ +TickType_t xNextExpireTime; + + /* Timers are listed in expiry time order, with the head of the list + referencing the task that will expire first. Obtain the time at which + the timer with the nearest expiry time will expire. If there are no + active timers then just set the next expire time to 0. That will cause + this task to unblock when the tick count overflows, at which point the + timer lists will be switched and the next expiry time can be + re-assessed. */ + *pxListWasEmpty = listLIST_IS_EMPTY( pxCurrentTimerList ); + if( *pxListWasEmpty == pdFALSE ) + { + xNextExpireTime = listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxCurrentTimerList ); + } + else + { + /* Ensure the task unblocks when the tick count rolls over. */ + xNextExpireTime = ( TickType_t ) 0U; + } + + return xNextExpireTime; +} +/*-----------------------------------------------------------*/ + +static TickType_t prvSampleTimeNow( BaseType_t * const pxTimerListsWereSwitched ) +{ +TickType_t xTimeNow; +PRIVILEGED_DATA static TickType_t xLastTime = ( TickType_t ) 0U; /*lint !e956 Variable is only accessible to one task. */ + + xTimeNow = xTaskGetTickCount(); + + if( xTimeNow < xLastTime ) + { + prvSwitchTimerLists(); + *pxTimerListsWereSwitched = pdTRUE; + } + else + { + *pxTimerListsWereSwitched = pdFALSE; + } + + xLastTime = xTimeNow; + + return xTimeNow; +} +/*-----------------------------------------------------------*/ + +static BaseType_t prvInsertTimerInActiveList( Timer_t * const pxTimer, const TickType_t xNextExpiryTime, const TickType_t xTimeNow, const TickType_t xCommandTime ) +{ +BaseType_t xProcessTimerNow = pdFALSE; + + listSET_LIST_ITEM_VALUE( &( pxTimer->xTimerListItem ), xNextExpiryTime ); + listSET_LIST_ITEM_OWNER( &( pxTimer->xTimerListItem ), pxTimer ); + + if( xNextExpiryTime <= xTimeNow ) + { + /* Has the expiry time elapsed between the command to start/reset a + timer was issued, and the time the command was processed? */ + if( ( xTimeNow - xCommandTime ) >= pxTimer->xTimerPeriodInTicks ) + { + /* The time between a command being issued and the command being + processed actually exceeds the timers period. */ + xProcessTimerNow = pdTRUE; + } + else + { + vListInsert( pxOverflowTimerList, &( pxTimer->xTimerListItem ) ); + } + } + else + { + if( ( xTimeNow < xCommandTime ) && ( xNextExpiryTime >= xCommandTime ) ) + { + /* If, since the command was issued, the tick count has overflowed + but the expiry time has not, then the timer must have already passed + its expiry time and should be processed immediately. */ + xProcessTimerNow = pdTRUE; + } + else + { + vListInsert( pxCurrentTimerList, &( pxTimer->xTimerListItem ) ); + } + } + + return xProcessTimerNow; +} +/*-----------------------------------------------------------*/ + +static void prvProcessReceivedCommands( void ) +{ +DaemonTaskMessage_t xMessage; +Timer_t *pxTimer; +BaseType_t xTimerListsWereSwitched, xResult; +TickType_t xTimeNow; + + while( xQueueReceive( xTimerQueue, &xMessage, tmrNO_DELAY ) != pdFAIL ) /*lint !e603 xMessage does not have to be initialised as it is passed out, not in, and it is not used unless xQueueReceive() returns pdTRUE. */ + { + #if ( INCLUDE_xTimerPendFunctionCall == 1 ) + { + /* Negative commands are pended function calls rather than timer + commands. */ + if( xMessage.xMessageID < ( BaseType_t ) 0 ) + { + const CallbackParameters_t * const pxCallback = &( xMessage.u.xCallbackParameters ); + + /* The timer uses the xCallbackParameters member to request a + callback be executed. Check the callback is not NULL. */ + configASSERT( pxCallback ); + + /* Call the function. */ + pxCallback->pxCallbackFunction( pxCallback->pvParameter1, pxCallback->ulParameter2 ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* INCLUDE_xTimerPendFunctionCall */ + + /* Commands that are positive are timer commands rather than pended + function calls. */ + if( xMessage.xMessageID >= ( BaseType_t ) 0 ) + { + /* The messages uses the xTimerParameters member to work on a + software timer. */ + pxTimer = xMessage.u.xTimerParameters.pxTimer; + + if( listIS_CONTAINED_WITHIN( NULL, &( pxTimer->xTimerListItem ) ) == pdFALSE ) + { + /* The timer is in a list, remove it. */ + ( void ) uxListRemove( &( pxTimer->xTimerListItem ) ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + traceTIMER_COMMAND_RECEIVED( pxTimer, xMessage.xMessageID, xMessage.u.xTimerParameters.xMessageValue ); + + /* In this case the xTimerListsWereSwitched parameter is not used, but + it must be present in the function call. prvSampleTimeNow() must be + called after the message is received from xTimerQueue so there is no + possibility of a higher priority task adding a message to the message + queue with a time that is ahead of the timer daemon task (because it + pre-empted the timer daemon task after the xTimeNow value was set). */ + xTimeNow = prvSampleTimeNow( &xTimerListsWereSwitched ); + + switch( xMessage.xMessageID ) + { + case tmrCOMMAND_START : + case tmrCOMMAND_START_FROM_ISR : + case tmrCOMMAND_RESET : + case tmrCOMMAND_RESET_FROM_ISR : + case tmrCOMMAND_START_DONT_TRACE : + /* Start or restart a timer. */ + if( prvInsertTimerInActiveList( pxTimer, xMessage.u.xTimerParameters.xMessageValue + pxTimer->xTimerPeriodInTicks, xTimeNow, xMessage.u.xTimerParameters.xMessageValue ) == pdTRUE ) + { + /* The timer expired before it was added to the active + timer list. Process it now. */ + pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer ); + traceTIMER_EXPIRED( pxTimer ); + + if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE ) + { + xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xMessage.u.xTimerParameters.xMessageValue + pxTimer->xTimerPeriodInTicks, NULL, tmrNO_DELAY ); + configASSERT( xResult ); + ( void ) xResult; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + break; + + case tmrCOMMAND_STOP : + case tmrCOMMAND_STOP_FROM_ISR : + /* The timer has already been removed from the active list. + There is nothing to do here. */ + break; + + case tmrCOMMAND_CHANGE_PERIOD : + case tmrCOMMAND_CHANGE_PERIOD_FROM_ISR : + pxTimer->xTimerPeriodInTicks = xMessage.u.xTimerParameters.xMessageValue; + configASSERT( ( pxTimer->xTimerPeriodInTicks > 0 ) ); + + /* The new period does not really have a reference, and can be + longer or shorter than the old one. The command time is + therefore set to the current time, and as the period cannot be + zero the next expiry time can only be in the future, meaning + (unlike for the xTimerStart() case above) there is no fail case + that needs to be handled here. */ + ( void ) prvInsertTimerInActiveList( pxTimer, ( xTimeNow + pxTimer->xTimerPeriodInTicks ), xTimeNow, xTimeNow ); + break; + + case tmrCOMMAND_DELETE : + /* The timer has already been removed from the active list, + just free up the memory. */ + vPortFree( pxTimer ); + break; + + default : + /* Don't expect to get here. */ + break; + } + } + } +} +/*-----------------------------------------------------------*/ + +static void prvSwitchTimerLists( void ) +{ +TickType_t xNextExpireTime, xReloadTime; +List_t *pxTemp; +Timer_t *pxTimer; +BaseType_t xResult; + + /* The tick count has overflowed. The timer lists must be switched. + If there are any timers still referenced from the current timer list + then they must have expired and should be processed before the lists + are switched. */ + while( listLIST_IS_EMPTY( pxCurrentTimerList ) == pdFALSE ) + { + xNextExpireTime = listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxCurrentTimerList ); + + /* Remove the timer from the list. */ + pxTimer = ( Timer_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxCurrentTimerList ); + ( void ) uxListRemove( &( pxTimer->xTimerListItem ) ); + traceTIMER_EXPIRED( pxTimer ); + + /* Execute its callback, then send a command to restart the timer if + it is an auto-reload timer. It cannot be restarted here as the lists + have not yet been switched. */ + pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer ); + + if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE ) + { + /* Calculate the reload value, and if the reload value results in + the timer going into the same timer list then it has already expired + and the timer should be re-inserted into the current list so it is + processed again within this loop. Otherwise a command should be sent + to restart the timer to ensure it is only inserted into a list after + the lists have been swapped. */ + xReloadTime = ( xNextExpireTime + pxTimer->xTimerPeriodInTicks ); + if( xReloadTime > xNextExpireTime ) + { + listSET_LIST_ITEM_VALUE( &( pxTimer->xTimerListItem ), xReloadTime ); + listSET_LIST_ITEM_OWNER( &( pxTimer->xTimerListItem ), pxTimer ); + vListInsert( pxCurrentTimerList, &( pxTimer->xTimerListItem ) ); + } + else + { + xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xNextExpireTime, NULL, tmrNO_DELAY ); + configASSERT( xResult ); + ( void ) xResult; + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + pxTemp = pxCurrentTimerList; + pxCurrentTimerList = pxOverflowTimerList; + pxOverflowTimerList = pxTemp; +} +/*-----------------------------------------------------------*/ + +static void prvCheckForValidListAndQueue( void ) +{ + /* Check that the list from which active timers are referenced, and the + queue used to communicate with the timer service, have been + initialised. */ + + /* Erm, yes, this is a problem. We can't lock until the lock is initialized, and we can't initialize the lock + atomically because we don't have a lock yet... I'm pretty sure doubly-initializing a lock on 2 cpus + is no problem in the current implementation, but this is not a nice way to solve things. ToDo - improve. */ + + if( xTimerQueue == NULL ) vPortCPUInitializeMutex( &xTimerMux ); + + taskENTER_CRITICAL( &xTimerMux ); + { + if( xTimerQueue == NULL ) + { + vListInitialise( &xActiveTimerList1 ); + vListInitialise( &xActiveTimerList2 ); + pxCurrentTimerList = &xActiveTimerList1; + pxOverflowTimerList = &xActiveTimerList2; + xTimerQueue = xQueueCreate( ( UBaseType_t ) configTIMER_QUEUE_LENGTH, sizeof( DaemonTaskMessage_t ) ); + configASSERT( xTimerQueue ); + + #if ( configQUEUE_REGISTRY_SIZE > 0 ) + { + if( xTimerQueue != NULL ) + { + vQueueAddToRegistry( xTimerQueue, "TmrQ" ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configQUEUE_REGISTRY_SIZE */ + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL( &xTimerMux ); +} +/*-----------------------------------------------------------*/ + +BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer ) +{ +BaseType_t xTimerIsInActiveList; +Timer_t *pxTimer = ( Timer_t * ) xTimer; + + /* Is the timer in the list of active timers? */ + taskENTER_CRITICAL( &xTimerMux ); + { + /* Checking to see if it is in the NULL list in effect checks to see if + it is referenced from either the current or the overflow timer lists in + one go, but the logic has to be reversed, hence the '!'. */ + xTimerIsInActiveList = ( BaseType_t ) !( listIS_CONTAINED_WITHIN( NULL, &( pxTimer->xTimerListItem ) ) ); + } + taskEXIT_CRITICAL( &xTimerMux ); + + return xTimerIsInActiveList; +} /*lint !e818 Can't be pointer to const due to the typedef. */ +/*-----------------------------------------------------------*/ + +void *pvTimerGetTimerID( const TimerHandle_t xTimer ) +{ +Timer_t * const pxTimer = ( Timer_t * ) xTimer; + + return pxTimer->pvTimerID; +} +/*-----------------------------------------------------------*/ + +#if( INCLUDE_xTimerPendFunctionCall == 1 ) + + BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, BaseType_t *pxHigherPriorityTaskWoken ) + { + DaemonTaskMessage_t xMessage; + BaseType_t xReturn; + + /* Complete the message with the function parameters and post it to the + daemon task. */ + xMessage.xMessageID = tmrCOMMAND_EXECUTE_CALLBACK_FROM_ISR; + xMessage.u.xCallbackParameters.pxCallbackFunction = xFunctionToPend; + xMessage.u.xCallbackParameters.pvParameter1 = pvParameter1; + xMessage.u.xCallbackParameters.ulParameter2 = ulParameter2; + + xReturn = xQueueSendFromISR( xTimerQueue, &xMessage, pxHigherPriorityTaskWoken ); + + tracePEND_FUNC_CALL_FROM_ISR( xFunctionToPend, pvParameter1, ulParameter2, xReturn ); + + return xReturn; + } + +#endif /* INCLUDE_xTimerPendFunctionCall */ +/*-----------------------------------------------------------*/ + +#if( INCLUDE_xTimerPendFunctionCall == 1 ) + + BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, TickType_t xTicksToWait ) + { + DaemonTaskMessage_t xMessage; + BaseType_t xReturn; + + /* This function can only be called after a timer has been created or + after the scheduler has been started because, until then, the timer + queue does not exist. */ + configASSERT( xTimerQueue ); + + /* Complete the message with the function parameters and post it to the + daemon task. */ + xMessage.xMessageID = tmrCOMMAND_EXECUTE_CALLBACK; + xMessage.u.xCallbackParameters.pxCallbackFunction = xFunctionToPend; + xMessage.u.xCallbackParameters.pvParameter1 = pvParameter1; + xMessage.u.xCallbackParameters.ulParameter2 = ulParameter2; + + xReturn = xQueueSendToBack( xTimerQueue, &xMessage, xTicksToWait ); + + tracePEND_FUNC_CALL( xFunctionToPend, pvParameter1, ulParameter2, xReturn ); + + return xReturn; + } + +#endif /* INCLUDE_xTimerPendFunctionCall */ +/*-----------------------------------------------------------*/ + +/* This entire source file will be skipped if the application is not configured +to include software timer functionality. If you want to include software timer +functionality then ensure configUSE_TIMERS is set to 1 in FreeRTOSConfig.h. */ +#endif /* configUSE_TIMERS == 1 */ + + + diff --git a/components/freertos/xtensa_context.S b/components/freertos/xtensa_context.S new file mode 100644 index 000000000..9e1c434f2 --- /dev/null +++ b/components/freertos/xtensa_context.S @@ -0,0 +1,645 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA CONTEXT SAVE AND RESTORE ROUTINES + +Low-level Call0 functions for handling generic context save and restore of +registers not specifically addressed by the interrupt vectors and handlers. +Those registers (not handled by these functions) are PC, PS, A0, A1 (SP). +Except for the calls to RTOS functions, this code is generic to Xtensa. + +Note that in Call0 ABI, interrupt handlers are expected to preserve the callee- +save regs (A12-A15), which is always the case if the handlers are coded in C. +However A12, A13 are made available as scratch registers for interrupt dispatch +code, so are presumed saved anyway, and are always restored even in Call0 ABI. +Only A14, A15 are truly handled as callee-save regs. + +Because Xtensa is a configurable architecture, this port supports all user +generated configurations (except restrictions stated in the release notes). +This is accomplished by conditional compilation using macros and functions +defined in the Xtensa HAL (hardware adaptation layer) for your configuration. +Only the processor state included in your configuration is saved and restored, +including any processor state added by user configuration options or TIE. + +*******************************************************************************/ + +/* Warn nicely if this file gets named with a lowercase .s instead of .S: */ +#define NOERROR # +NOERROR: .error "C preprocessor needed for this file: make sure its filename\ + ends in uppercase .S, or use xt-xcc's -x assembler-with-cpp option." + + +#include "xtensa_rtos.h" +#include "xtensa_context.h" + +#ifdef XT_USE_OVLY +#include +#endif + + .text + + + +/******************************************************************************* + +_xt_context_save + + !! MUST BE CALLED ONLY BY 'CALL0' INSTRUCTION !! + +Saves all Xtensa processor state except PC, PS, A0, A1 (SP), A12, A13, in the +interrupt stack frame defined in xtensa_rtos.h. +Its counterpart is _xt_context_restore (which also restores A12, A13). + +Caller is expected to have saved PC, PS, A0, A1 (SP), A12, A13 in the frame. +This function preserves A12 & A13 in order to provide the caller with 2 scratch +regs that need not be saved over the call to this function. The choice of which +2 regs to provide is governed by xthal_window_spill_nw and xthal_save_extra_nw, +to avoid moving data more than necessary. Caller can assign regs accordingly. + +Entry Conditions: + A0 = Return address in caller. + A1 = Stack pointer of interrupted thread or handler ("interruptee"). + Original A12, A13 have already been saved in the interrupt stack frame. + Other processor state except PC, PS, A0, A1 (SP), A12, A13, is as at the + point of interruption. + If windowed ABI, PS.EXCM = 1 (exceptions disabled). + +Exit conditions: + A0 = Return address in caller. + A1 = Stack pointer of interrupted thread or handler ("interruptee"). + A12, A13 as at entry (preserved). + If windowed ABI, PS.EXCM = 1 (exceptions disabled). + +*******************************************************************************/ + + .global _xt_context_save + .type _xt_context_save,@function + .align 4 + .literal_position + .align 4 +_xt_context_save: + + s32i a2, sp, XT_STK_A2 + s32i a3, sp, XT_STK_A3 + s32i a4, sp, XT_STK_A4 + s32i a5, sp, XT_STK_A5 + s32i a6, sp, XT_STK_A6 + s32i a7, sp, XT_STK_A7 + s32i a8, sp, XT_STK_A8 + s32i a9, sp, XT_STK_A9 + s32i a10, sp, XT_STK_A10 + s32i a11, sp, XT_STK_A11 + + /* + Call0 ABI callee-saved regs a12-15 do not need to be saved here. + a12-13 are the caller's responsibility so it can use them as scratch. + So only need to save a14-a15 here for Windowed ABI (not Call0). + */ + #ifndef __XTENSA_CALL0_ABI__ + s32i a14, sp, XT_STK_A14 + s32i a15, sp, XT_STK_A15 + #endif + + rsr a3, SAR + s32i a3, sp, XT_STK_SAR + + #if XCHAL_HAVE_LOOPS + rsr a3, LBEG + s32i a3, sp, XT_STK_LBEG + rsr a3, LEND + s32i a3, sp, XT_STK_LEND + rsr a3, LCOUNT + s32i a3, sp, XT_STK_LCOUNT + #endif + + #ifdef XT_USE_SWPRI + /* Save virtual priority mask */ + movi a3, _xt_vpri_mask + l32i a3, a3, 0 + s32i a3, sp, XT_STK_VPRI + #endif + + #if XCHAL_EXTRA_SA_SIZE > 0 || !defined(__XTENSA_CALL0_ABI__) + mov a9, a0 /* preserve ret addr */ + #endif + + #ifndef __XTENSA_CALL0_ABI__ + /* + To spill the reg windows, temp. need pre-interrupt stack ptr and a4-15. + Need to save a9,12,13 temporarily (in frame temps) and recover originals. + Interrupts need to be disabled below XCHAL_EXCM_LEVEL and window overflow + and underflow exceptions disabled (assured by PS.EXCM == 1). + */ + s32i a12, sp, XT_STK_TMP0 /* temp. save stuff in stack frame */ + s32i a13, sp, XT_STK_TMP1 + s32i a9, sp, XT_STK_TMP2 + + /* + Save the overlay state if we are supporting overlays. Since we just saved + three registers, we can conveniently use them here. Note that as of now, + overlays only work for windowed calling ABI. + */ + #ifdef XT_USE_OVLY + l32i a9, sp, XT_STK_PC /* recover saved PC */ + _xt_overlay_get_state a9, a12, a13 + s32i a9, sp, XT_STK_OVLY /* save overlay state */ + #endif + + l32i a12, sp, XT_STK_A12 /* recover original a9,12,13 */ + l32i a13, sp, XT_STK_A13 + l32i a9, sp, XT_STK_A9 + addi sp, sp, XT_STK_FRMSZ /* restore the interruptee's SP */ + call0 xthal_window_spill_nw /* preserves only a4,5,8,9,12,13 */ + addi sp, sp, -XT_STK_FRMSZ + l32i a12, sp, XT_STK_TMP0 /* recover stuff from stack frame */ + l32i a13, sp, XT_STK_TMP1 + l32i a9, sp, XT_STK_TMP2 + #endif + + #if XCHAL_EXTRA_SA_SIZE > 0 + /* + NOTE: Normally the xthal_save_extra_nw macro only affects address + registers a2-a5. It is theoretically possible for Xtensa processor + designers to write TIE that causes more address registers to be + affected, but it is generally unlikely. If that ever happens, + more registers need to be saved/restored around this macro invocation. + Here we assume a9,12,13 are preserved. + Future Xtensa tools releases might limit the regs that can be affected. + */ + addi a2, sp, XT_STK_EXTRA /* where to save it */ + # if XCHAL_EXTRA_SA_ALIGN > 16 + movi a3, -XCHAL_EXTRA_SA_ALIGN + and a2, a2, a3 /* align dynamically >16 bytes */ + # endif + call0 xthal_save_extra_nw /* destroys a0,2,3,4,5 */ + #endif + + #if XCHAL_EXTRA_SA_SIZE > 0 || !defined(__XTENSA_CALL0_ABI__) + mov a0, a9 /* retrieve ret addr */ + #endif + + ret + +/******************************************************************************* + +_xt_context_restore + + !! MUST BE CALLED ONLY BY 'CALL0' INSTRUCTION !! + +Restores all Xtensa processor state except PC, PS, A0, A1 (SP) (and in Call0 +ABI, A14, A15 which are preserved by all interrupt handlers) from an interrupt +stack frame defined in xtensa_rtos.h . +Its counterpart is _xt_context_save (whose caller saved A12, A13). + +Caller is responsible to restore PC, PS, A0, A1 (SP). + +Entry Conditions: + A0 = Return address in caller. + A1 = Stack pointer of interrupted thread or handler ("interruptee"). + +Exit conditions: + A0 = Return address in caller. + A1 = Stack pointer of interrupted thread or handler ("interruptee"). + Other processor state except PC, PS, A0, A1 (SP), is as at the point + of interruption. + +*******************************************************************************/ + + .global _xt_context_restore + .type _xt_context_restore,@function + .align 4 + .literal_position + .align 4 +_xt_context_restore: + + #if XCHAL_EXTRA_SA_SIZE > 0 + /* + NOTE: Normally the xthal_restore_extra_nw macro only affects address + registers a2-a5. It is theoretically possible for Xtensa processor + designers to write TIE that causes more address registers to be + affected, but it is generally unlikely. If that ever happens, + more registers need to be saved/restored around this macro invocation. + Here we only assume a13 is preserved. + Future Xtensa tools releases might limit the regs that can be affected. + */ + mov a13, a0 /* preserve ret addr */ + addi a2, sp, XT_STK_EXTRA /* where to find it */ + # if XCHAL_EXTRA_SA_ALIGN > 16 + movi a3, -XCHAL_EXTRA_SA_ALIGN + and a2, a2, a3 /* align dynamically >16 bytes */ + # endif + call0 xthal_restore_extra_nw /* destroys a0,2,3,4,5 */ + mov a0, a13 /* retrieve ret addr */ + #endif + + #if XCHAL_HAVE_LOOPS + l32i a2, sp, XT_STK_LBEG + l32i a3, sp, XT_STK_LEND + wsr a2, LBEG + l32i a2, sp, XT_STK_LCOUNT + wsr a3, LEND + wsr a2, LCOUNT + #endif + + #ifdef XT_USE_OVLY + /* + If we are using overlays, this is a good spot to check if we need + to restore an overlay for the incoming task. Here we have a bunch + of registers to spare. Note that this step is going to use a few + bytes of storage below SP (SP-20 to SP-32) if an overlay is going + to be restored. + */ + l32i a2, sp, XT_STK_PC /* retrieve PC */ + l32i a3, sp, XT_STK_PS /* retrieve PS */ + l32i a4, sp, XT_STK_OVLY /* retrieve overlay state */ + l32i a5, sp, XT_STK_A1 /* retrieve stack ptr */ + _xt_overlay_check_map a2, a3, a4, a5, a6 + s32i a2, sp, XT_STK_PC /* save updated PC */ + s32i a3, sp, XT_STK_PS /* save updated PS */ + #endif + + #ifdef XT_USE_SWPRI + /* Restore virtual interrupt priority and interrupt enable */ + movi a3, _xt_intdata + l32i a4, a3, 0 /* a4 = _xt_intenable */ + l32i a5, sp, XT_STK_VPRI /* a5 = saved _xt_vpri_mask */ + and a4, a4, a5 + wsr a4, INTENABLE /* update INTENABLE */ + s32i a5, a3, 4 /* restore _xt_vpri_mask */ + #endif + + l32i a3, sp, XT_STK_SAR + l32i a2, sp, XT_STK_A2 + wsr a3, SAR + l32i a3, sp, XT_STK_A3 + l32i a4, sp, XT_STK_A4 + l32i a5, sp, XT_STK_A5 + l32i a6, sp, XT_STK_A6 + l32i a7, sp, XT_STK_A7 + l32i a8, sp, XT_STK_A8 + l32i a9, sp, XT_STK_A9 + l32i a10, sp, XT_STK_A10 + l32i a11, sp, XT_STK_A11 + + /* + Call0 ABI callee-saved regs a12-15 do not need to be restored here. + However a12-13 were saved for scratch before XT_RTOS_INT_ENTER(), + so need to be restored anyway, despite being callee-saved in Call0. + */ + l32i a12, sp, XT_STK_A12 + l32i a13, sp, XT_STK_A13 + #ifndef __XTENSA_CALL0_ABI__ + l32i a14, sp, XT_STK_A14 + l32i a15, sp, XT_STK_A15 + #endif + + ret + + +/******************************************************************************* + +_xt_coproc_init + +Initializes global co-processor management data, setting all co-processors +to "unowned". Leaves CPENABLE as it found it (does NOT clear it). + +Called during initialization of the RTOS, before any threads run. + +This may be called from normal Xtensa single-threaded application code which +might use co-processors. The Xtensa run-time initialization enables all +co-processors. They must remain enabled here, else a co-processor exception +might occur outside of a thread, which the exception handler doesn't expect. + +Entry Conditions: + Xtensa single-threaded run-time environment is in effect. + No thread is yet running. + +Exit conditions: + None. + +Obeys ABI conventions per prototype: + void _xt_coproc_init(void) + +*******************************************************************************/ + +#if XCHAL_CP_NUM > 0 + + .global _xt_coproc_init + .type _xt_coproc_init,@function + .align 4 + .literal_position + .align 4 +_xt_coproc_init: + ENTRY0 + + /* Initialize thread co-processor ownerships to 0 (unowned). */ + movi a2, _xt_coproc_owner_sa /* a2 = base of owner array */ + addi a3, a2, (XCHAL_CP_MAX*portNUM_PROCESSORS) << 2 /* a3 = top+1 of owner array */ + movi a4, 0 /* a4 = 0 (unowned) */ +1: s32i a4, a2, 0 + addi a2, a2, 4 + bltu a2, a3, 1b + + RET0 + +#endif + + +/******************************************************************************* + +_xt_coproc_release + +Releases any and all co-processors owned by a given thread. The thread is +identified by it's co-processor state save area defined in xtensa_context.h . + +Must be called before a thread's co-proc save area is deleted to avoid +memory corruption when the exception handler tries to save the state. +May be called when a thread terminates or completes but does not delete +the co-proc save area, to avoid the exception handler having to save the +thread's co-proc state before another thread can use it (optimization). + +Entry Conditions: + A2 = Pointer to base of co-processor state save area. + +Exit conditions: + None. + +Obeys ABI conventions per prototype: + void _xt_coproc_release(void * coproc_sa_base) + +*******************************************************************************/ + +#if XCHAL_CP_NUM > 0 + + .global _xt_coproc_release + .type _xt_coproc_release,@function + .align 4 + .literal_position + .align 4 +_xt_coproc_release: + ENTRY0 /* a2 = base of save area */ + + getcoreid a5 + movi a3, XCHAL_CP_MAX << 2 + mull a5, a5, a3 + movi a3, _xt_coproc_owner_sa /* a3 = base of owner array */ + add a3, a3, a5 + + addi a4, a3, XCHAL_CP_MAX << 2 /* a4 = top+1 of owner array */ + movi a5, 0 /* a5 = 0 (unowned) */ + + rsil a6, XCHAL_EXCM_LEVEL /* lock interrupts */ + +1: l32i a7, a3, 0 /* a7 = owner at a3 */ + bne a2, a7, 2f /* if (coproc_sa_base == owner) */ + s32i a5, a3, 0 /* owner = unowned */ +2: addi a3, a3, 1<<2 /* a3 = next entry in owner array */ + bltu a3, a4, 1b /* repeat until end of array */ + +3: wsr a6, PS /* restore interrupts */ + + RET0 + +#endif + + +/******************************************************************************* +_xt_coproc_savecs + +If there is a current thread and it has a coprocessor state save area, then +save all callee-saved state into this area. This function is called from the +solicited context switch handler. It calls a system-specific function to get +the coprocessor save area base address. + +Entry conditions: + - The thread being switched out is still the current thread. + - CPENABLE state reflects which coprocessors are active. + - Registers have been saved/spilled already. + +Exit conditions: + - All necessary CP callee-saved state has been saved. + - Registers a2-a7, a13-a15 have been trashed. + +Must be called from assembly code only, using CALL0. +*******************************************************************************/ +#if XCHAL_CP_NUM > 0 + + .extern _xt_coproc_sa_offset /* external reference */ + + .global _xt_coproc_savecs + .type _xt_coproc_savecs,@function + .align 4 + .literal_position + .align 4 +_xt_coproc_savecs: + + /* At entry, CPENABLE should be showing which CPs are enabled. */ + + rsr a2, CPENABLE /* a2 = which CPs are enabled */ + beqz a2, .Ldone /* quick exit if none */ + mov a14, a0 /* save return address */ + call0 XT_RTOS_CP_STATE /* get address of CP save area */ + mov a0, a14 /* restore return address */ + beqz a15, .Ldone /* if none then nothing to do */ + s16i a2, a15, XT_CP_CS_ST /* save mask of CPs being stored */ + movi a13, _xt_coproc_sa_offset /* array of CP save offsets */ + l32i a15, a15, XT_CP_ASA /* a15 = base of aligned save area */ + +#if XCHAL_CP0_SA_SIZE + bbci.l a2, 0, 2f /* CP 0 not enabled */ + l32i a14, a13, 0 /* a14 = _xt_coproc_sa_offset[0] */ + add a3, a14, a15 /* a3 = save area for CP 0 */ + xchal_cp0_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP1_SA_SIZE + bbci.l a2, 1, 2f /* CP 1 not enabled */ + l32i a14, a13, 4 /* a14 = _xt_coproc_sa_offset[1] */ + add a3, a14, a15 /* a3 = save area for CP 1 */ + xchal_cp1_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP2_SA_SIZE + bbci.l a2, 2, 2f + l32i a14, a13, 8 + add a3, a14, a15 + xchal_cp2_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP3_SA_SIZE + bbci.l a2, 3, 2f + l32i a14, a13, 12 + add a3, a14, a15 + xchal_cp3_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP4_SA_SIZE + bbci.l a2, 4, 2f + l32i a14, a13, 16 + add a3, a14, a15 + xchal_cp4_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP5_SA_SIZE + bbci.l a2, 5, 2f + l32i a14, a13, 20 + add a3, a14, a15 + xchal_cp5_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP6_SA_SIZE + bbci.l a2, 6, 2f + l32i a14, a13, 24 + add a3, a14, a15 + xchal_cp6_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP7_SA_SIZE + bbci.l a2, 7, 2f + l32i a14, a13, 28 + add a3, a14, a15 + xchal_cp7_store a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +.Ldone: + ret +#endif + + +/******************************************************************************* +_xt_coproc_restorecs + +Restore any callee-saved coprocessor state for the incoming thread. +This function is called from coprocessor exception handling, when giving +ownership to a thread that solicited a context switch earlier. It calls a +system-specific function to get the coprocessor save area base address. + +Entry conditions: + - The incoming thread is set as the current thread. + - CPENABLE is set up correctly for all required coprocessors. + - a2 = mask of coprocessors to be restored. + +Exit conditions: + - All necessary CP callee-saved state has been restored. + - CPENABLE - unchanged. + - Registers a2-a7, a13-a15 have been trashed. + +Must be called from assembly code only, using CALL0. +*******************************************************************************/ +#if XCHAL_CP_NUM > 0 + + .global _xt_coproc_restorecs + .type _xt_coproc_restorecs,@function + .align 4 + .literal_position + .align 4 +_xt_coproc_restorecs: + + mov a14, a0 /* save return address */ + call0 XT_RTOS_CP_STATE /* get address of CP save area */ + mov a0, a14 /* restore return address */ + beqz a15, .Ldone2 /* if none then nothing to do */ + l16ui a3, a15, XT_CP_CS_ST /* a3 = which CPs have been saved */ + xor a3, a3, a2 /* clear the ones being restored */ + s32i a3, a15, XT_CP_CS_ST /* update saved CP mask */ + movi a13, _xt_coproc_sa_offset /* array of CP save offsets */ + l32i a15, a15, XT_CP_ASA /* a15 = base of aligned save area */ + +#if XCHAL_CP0_SA_SIZE + bbci.l a2, 0, 2f /* CP 0 not enabled */ + l32i a14, a13, 0 /* a14 = _xt_coproc_sa_offset[0] */ + add a3, a14, a15 /* a3 = save area for CP 0 */ + xchal_cp0_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP1_SA_SIZE + bbci.l a2, 1, 2f /* CP 1 not enabled */ + l32i a14, a13, 4 /* a14 = _xt_coproc_sa_offset[1] */ + add a3, a14, a15 /* a3 = save area for CP 1 */ + xchal_cp1_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP2_SA_SIZE + bbci.l a2, 2, 2f + l32i a14, a13, 8 + add a3, a14, a15 + xchal_cp2_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP3_SA_SIZE + bbci.l a2, 3, 2f + l32i a14, a13, 12 + add a3, a14, a15 + xchal_cp3_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP4_SA_SIZE + bbci.l a2, 4, 2f + l32i a14, a13, 16 + add a3, a14, a15 + xchal_cp4_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP5_SA_SIZE + bbci.l a2, 5, 2f + l32i a14, a13, 20 + add a3, a14, a15 + xchal_cp5_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP6_SA_SIZE + bbci.l a2, 6, 2f + l32i a14, a13, 24 + add a3, a14, a15 + xchal_cp6_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +#if XCHAL_CP7_SA_SIZE + bbci.l a2, 7, 2f + l32i a14, a13, 28 + add a3, a14, a15 + xchal_cp7_load a3, a4, a5, a6, a7 continue=0 ofs=-1 select=XTHAL_SAS_TIE|XTHAL_SAS_NOCC|XTHAL_SAS_CALE alloc=XTHAL_SAS_ALL +2: +#endif + +.Ldone2: + ret + +#endif + + diff --git a/components/freertos/xtensa_init.c b/components/freertos/xtensa_init.c new file mode 100644 index 000000000..ded8df109 --- /dev/null +++ b/components/freertos/xtensa_init.c @@ -0,0 +1,65 @@ +/******************************************************************************* +// Copyright (c) 2003-2015 Cadence Design Systems, Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA INITIALIZATION ROUTINES CODED IN C + +This file contains miscellaneous Xtensa RTOS-generic initialization functions +that are implemented in C. + +*******************************************************************************/ + + +#ifdef XT_BOARD +#include +#endif + +#include "xtensa_rtos.h" + +#ifdef XT_RTOS_TIMER_INT + +unsigned _xt_tick_divisor = 0; /* cached number of cycles per tick */ + +/* +Compute and initialize at run-time the tick divisor (the number of +processor clock cycles in an RTOS tick, used to set the tick timer). +Called when the processor clock frequency is not known at compile-time. +*/ +void _xt_tick_divisor_init(void) +{ +#ifdef XT_CLOCK_FREQ + + _xt_tick_divisor = (XT_CLOCK_FREQ / XT_TICK_PER_SEC); + +#else + + #ifdef XT_BOARD + _xt_tick_divisor = xtbsp_clock_freq_hz() / XT_TICK_PER_SEC; + #else + #error "No way to obtain processor clock frequency" + #endif /* XT_BOARD */ + +#endif /* XT_CLOCK_FREQ */ +} + +#endif /* XT_RTOS_TIMER_INT */ + diff --git a/components/freertos/xtensa_intr.c b/components/freertos/xtensa_intr.c new file mode 100644 index 000000000..f5ca7d151 --- /dev/null +++ b/components/freertos/xtensa_intr.c @@ -0,0 +1,138 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +******************************************************************************/ + +/****************************************************************************** + Xtensa-specific interrupt and exception functions for RTOS ports. + Also see xtensa_intr_asm.S. +******************************************************************************/ + +#include + +#include + +#include "freertos/xtensa_api.h" + +#include "rom/ets_sys.h" + +#if XCHAL_HAVE_EXCEPTIONS + +/* Handler table is in xtensa_intr_asm.S */ +// Todo: Make multicore - JD + +extern xt_exc_handler _xt_exception_table[XCHAL_EXCCAUSE_NUM]; + + +/* + Default handler for unhandled exceptions. + CHANGED: We do this in panic.c now +*/ + +//void xt_unhandled_exception(XtExcFrame *frame) +//{ + //exit(-1); +//} +extern void xt_unhandled_exception(XtExcFrame *frame); + + +/* + This function registers a handler for the specified exception. + The function returns the address of the previous handler. + On error, it returns 0. +*/ +xt_exc_handler xt_set_exception_handler(int n, xt_exc_handler f) +{ + xt_exc_handler old; + + if( n < 0 || n >= XCHAL_EXCCAUSE_NUM ) + return 0; /* invalid exception number */ + + old = _xt_exception_table[n]; + + if (f) { + _xt_exception_table[n] = f; + } + else { + _xt_exception_table[n] = &xt_unhandled_exception; + } + + return ((old == &xt_unhandled_exception) ? 0 : old); +} + +#endif + +#if XCHAL_HAVE_INTERRUPTS + +/* Handler table is in xtensa_intr_asm.S */ + +typedef struct xt_handler_table_entry { + void * handler; + void * arg; +} xt_handler_table_entry; + +extern xt_handler_table_entry _xt_interrupt_table[XCHAL_NUM_INTERRUPTS]; + + +/* + Default handler for unhandled interrupts. +*/ +void xt_unhandled_interrupt(void * arg) +{ + ets_printf("Unhandled interrupt!\n"); + //exit(-1); +} + + +/* + This function registers a handler for the specified interrupt. The "arg" + parameter specifies the argument to be passed to the handler when it is + invoked. The function returns the address of the previous handler. + On error, it returns 0. +*/ +xt_handler xt_set_interrupt_handler(int n, xt_handler f, void * arg) +{ + xt_handler_table_entry * entry; + xt_handler old; + + if( n < 0 || n >= XCHAL_NUM_INTERRUPTS ) + return 0; /* invalid interrupt number */ + if( Xthal_intlevel[n] > XCHAL_EXCM_LEVEL ) + return 0; /* priority level too high to safely handle in C */ + + entry = _xt_interrupt_table + n; + old = entry->handler; + + if (f) { + entry->handler = f; + entry->arg = arg; + } + else { + entry->handler = &xt_unhandled_interrupt; + entry->arg = (void*)n; + } + + return ((old == &xt_unhandled_interrupt) ? 0 : old); +} + + +#endif /* XCHAL_HAVE_INTERRUPTS */ + diff --git a/components/freertos/xtensa_intr_asm.S b/components/freertos/xtensa_intr_asm.S new file mode 100644 index 000000000..5f9890dfe --- /dev/null +++ b/components/freertos/xtensa_intr_asm.S @@ -0,0 +1,179 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +******************************************************************************/ + +/****************************************************************************** + Xtensa interrupt handling data and assembly routines. + Also see xtensa_intr.c and xtensa_vectors.S. +******************************************************************************/ + +#include +#include + +#include "xtensa_context.h" + +#if XCHAL_HAVE_INTERRUPTS + +/* +------------------------------------------------------------------------------- + INTENABLE virtualization information. +------------------------------------------------------------------------------- +*/ + + .data + .global _xt_intdata + .align 8 +_xt_intdata: + .global _xt_intenable + .type _xt_intenable,@object + .size _xt_intenable,4 + .global _xt_vpri_mask + .type _xt_vpri_mask,@object + .size _xt_vpri_mask,4 + +_xt_intenable: .word 0 /* Virtual INTENABLE */ +_xt_vpri_mask: .word 0xFFFFFFFF /* Virtual priority mask */ + + +/* +------------------------------------------------------------------------------- + Table of C-callable interrupt handlers for each interrupt. Note that not all + slots can be filled, because interrupts at level > EXCM_LEVEL will not be + dispatched to a C handler by default. +------------------------------------------------------------------------------- +*/ + + .data + .global _xt_interrupt_table + .align 8 + +_xt_interrupt_table: + + .set i, 0 + .rept XCHAL_NUM_INTERRUPTS + .word xt_unhandled_interrupt /* handler address */ + .word i /* handler arg (default: intnum) */ + .set i, i+1 + .endr + +#endif /* XCHAL_HAVE_INTERRUPTS */ + + +#if XCHAL_HAVE_EXCEPTIONS + +/* +------------------------------------------------------------------------------- + Table of C-callable exception handlers for each exception. Note that not all + slots will be active, because some exceptions (e.g. coprocessor exceptions) + are always handled by the OS and cannot be hooked by user handlers. +------------------------------------------------------------------------------- +*/ + + .data + .global _xt_exception_table + .align 4 + +_xt_exception_table: + .rept XCHAL_EXCCAUSE_NUM + .word xt_unhandled_exception /* handler address */ + .endr + +#endif + + +/* +------------------------------------------------------------------------------- + unsigned int xt_ints_on ( unsigned int mask ) + + Enables a set of interrupts. Does not simply set INTENABLE directly, but + computes it as a function of the current virtual priority. + Can be called from interrupt handlers. +------------------------------------------------------------------------------- +*/ + + .text + .align 4 + .global xt_ints_on + .type xt_ints_on,@function + +xt_ints_on: + + ENTRY0 +#if XCHAL_HAVE_INTERRUPTS + movi a3, 0 + movi a4, _xt_intdata + xsr a3, INTENABLE /* Disables all interrupts */ + rsync + l32i a3, a4, 0 /* a3 = _xt_intenable */ + l32i a6, a4, 4 /* a6 = _xt_vpri_mask */ + or a5, a3, a2 /* a5 = _xt_intenable | mask */ + s32i a5, a4, 0 /* _xt_intenable |= mask */ + and a5, a5, a6 /* a5 = _xt_intenable & _xt_vpri_mask */ + wsr a5, INTENABLE /* Reenable interrupts */ + mov a2, a3 /* Previous mask */ +#else + movi a2, 0 /* Return zero */ +#endif + RET0 + + .size xt_ints_on, . - xt_ints_on + + +/* +------------------------------------------------------------------------------- + unsigned int xt_ints_off ( unsigned int mask ) + + Disables a set of interrupts. Does not simply set INTENABLE directly, + but computes it as a function of the current virtual priority. + Can be called from interrupt handlers. +------------------------------------------------------------------------------- +*/ + + .text + .align 4 + .global xt_ints_off + .type xt_ints_off,@function + +xt_ints_off: + + ENTRY0 +#if XCHAL_HAVE_INTERRUPTS + movi a3, 0 + movi a4, _xt_intdata + xsr a3, INTENABLE /* Disables all interrupts */ + rsync + l32i a3, a4, 0 /* a3 = _xt_intenable */ + l32i a6, a4, 4 /* a6 = _xt_vpri_mask */ + or a5, a3, a2 /* a5 = _xt_intenable | mask */ + xor a5, a5, a2 /* a5 = _xt_intenable & ~mask */ + s32i a5, a4, 0 /* _xt_intenable &= ~mask */ + and a5, a5, a6 /* a5 = _xt_intenable & _xt_vpri_mask */ + wsr a5, INTENABLE /* Reenable interrupts */ + mov a2, a3 /* Previous mask */ +#else + movi a2, 0 /* return zero */ +#endif + RET0 + + .size xt_ints_off, . - xt_ints_off + + diff --git a/components/freertos/xtensa_overlay_os_hook.c b/components/freertos/xtensa_overlay_os_hook.c new file mode 100644 index 000000000..a5ca23cee --- /dev/null +++ b/components/freertos/xtensa_overlay_os_hook.c @@ -0,0 +1,67 @@ +// xtensa_overlay_os_hook.c -- Overlay manager OS hooks for FreeRTOS. + +// Copyright (c) 2015-2015 Cadence Design Systems Inc. +// +// Permission is hereby granted, free of charge, to any person obtaining +// a copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to +// permit persons to whom the Software is furnished to do so, subject to +// the following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +#include "FreeRTOS.h" +#include "semphr.h" + +#if configUSE_MUTEX + +/* Mutex object that controls access to the overlay. Currently only one + * overlay region is supported so one mutex suffices. + */ +static SemaphoreHandle_t xt_overlay_mutex; + + +/* This function should be overridden to provide OS specific init such + * as the creation of a mutex lock that can be used for overlay locking. + * Typically this mutex would be set up with priority inheritance. See + * overlay manager documentation for more details. + */ +void xt_overlay_init_os(void) +{ + /* Create the mutex for overlay access. Priority inheritance is + * required. + */ + xt_overlay_mutex = xSemaphoreCreateMutex(); +} + + +/* This function locks access to shared overlay resources, typically + * by acquiring a mutex. + */ +void xt_overlay_lock(void) +{ + xSemaphoreTake(xt_overlay_mutex, 0); +} + + +/* This function releases access to shared overlay resources, typically + * by unlocking a mutex. + */ +void xt_overlay_unlock(void) +{ + xSemaphoreGive(xt_overlay_mutex); +} + +#endif diff --git a/components/freertos/xtensa_vectors.S b/components/freertos/xtensa_vectors.S new file mode 100644 index 000000000..0ff6c4c19 --- /dev/null +++ b/components/freertos/xtensa_vectors.S @@ -0,0 +1,1980 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA VECTORS AND LOW LEVEL HANDLERS FOR AN RTOS + + Xtensa low level exception and interrupt vectors and handlers for an RTOS. + + Interrupt handlers and user exception handlers support interaction with + the RTOS by calling XT_RTOS_INT_ENTER and XT_RTOS_INT_EXIT before and + after user's specific interrupt handlers. These macros are defined in + xtensa_.h to call suitable functions in a specific RTOS. + + Users can install application-specific interrupt handlers for low and + medium level interrupts, by calling xt_set_interrupt_handler(). These + handlers can be written in C, and must obey C calling convention. The + handler table is indexed by the interrupt number. Each handler may be + provided with an argument. + + Note that the system timer interrupt is handled specially, and is + dispatched to the RTOS-specific handler. This timer cannot be hooked + by application code. + + Optional hooks are also provided to install a handler per level at + run-time, made available by compiling this source file with + '-DXT_INTEXC_HOOKS' (useful for automated testing). + +!! This file is a template that usually needs to be modified to handle !! +!! application specific interrupts. Search USER_EDIT for helpful comments !! +!! on where to insert handlers and how to write them. !! + + Users can also install application-specific exception handlers in the + same way, by calling xt_set_exception_handler(). One handler slot is + provided for each exception type. Note that some exceptions are handled + by the porting layer itself, and cannot be taken over by application + code in this manner. These are the alloca, syscall, and coprocessor + exceptions. + + The exception handlers can be written in C, and must follow C calling + convention. Each handler is passed a pointer to an exception frame as + its single argument. The exception frame is created on the stack, and + holds the saved context of the thread that took the exception. If the + handler returns, the context will be restored and the instruction that + caused the exception will be retried. If the handler makes any changes + to the saved state in the exception frame, the changes will be applied + when restoring the context. + + Because Xtensa is a configurable architecture, this port supports all user + generated configurations (except restrictions stated in the release notes). + This is accomplished by conditional compilation using macros and functions + defined in the Xtensa HAL (hardware adaptation layer) for your configuration. + Only the relevant parts of this file will be included in your RTOS build. + For example, this file provides interrupt vector templates for all types and + all priority levels, but only the ones in your configuration are built. + + NOTES on the use of 'call0' for long jumps instead of 'j': + 1. This file should be assembled with the -mlongcalls option to xt-xcc. + 2. The -mlongcalls compiler option causes 'call0 dest' to be expanded to + a sequence 'l32r a0, dest' 'callx0 a0' which works regardless of the + distance from the call to the destination. The linker then relaxes + it back to 'call0 dest' if it determines that dest is within range. + This allows more flexibility in locating code without the performance + overhead of the 'l32r' literal data load in cases where the destination + is in range of 'call0'. There is an additional benefit in that 'call0' + has a longer range than 'j' due to the target being word-aligned, so + the 'l32r' sequence is less likely needed. + 3. The use of 'call0' with -mlongcalls requires that register a0 not be + live at the time of the call, which is always the case for a function + call but needs to be ensured if 'call0' is used as a jump in lieu of 'j'. + 4. This use of 'call0' is independent of the C function call ABI. + +*******************************************************************************/ + +#include "xtensa_rtos.h" + + +/* Enable stack backtrace across exception/interrupt - see below */ +#define XT_DEBUG_BACKTRACE 0 + + +/* +-------------------------------------------------------------------------------- + Defines used to access _xtos_interrupt_table. +-------------------------------------------------------------------------------- +*/ +#define XIE_HANDLER 0 +#define XIE_ARG 4 +#define XIE_SIZE 8 + +/* +-------------------------------------------------------------------------------- + Macro extract_msb - return the input with only the highest bit set. + + Input : "ain" - Input value, clobbered. + Output : "aout" - Output value, has only one bit set, MSB of "ain". + The two arguments must be different AR registers. +-------------------------------------------------------------------------------- +*/ + + .macro extract_msb aout ain +1: + addi \aout, \ain, -1 /* aout = ain - 1 */ + and \ain, \ain, \aout /* ain = ain & aout */ + bnez \ain, 1b /* repeat until ain == 0 */ + addi \aout, \aout, 1 /* return aout + 1 */ + .endm + +/* +-------------------------------------------------------------------------------- + Macro dispatch_c_isr - dispatch interrupts to user ISRs. + This will dispatch to user handlers (if any) that are registered in the + XTOS dispatch table (_xtos_interrupt_table). These handlers would have + been registered by calling _xtos_set_interrupt_handler(). There is one + exception - the timer interrupt used by the OS will not be dispatched + to a user handler - this must be handled by the caller of this macro. + + Level triggered and software interrupts are automatically deasserted by + this code. + + ASSUMPTIONS: + -- PS.INTLEVEL is set to "level" at entry + -- PS.EXCM = 0, C calling enabled + + NOTE: For CALL0 ABI, a12-a15 have not yet been saved. + + NOTE: This macro will use registers a0 and a2-a6. The arguments are: + level -- interrupt level + mask -- interrupt bitmask for this level +-------------------------------------------------------------------------------- +*/ + + .macro dispatch_c_isr level mask + + /* Get mask of pending, enabled interrupts at this level into a2. */ + +.L_xt_user_int_&level&: + rsr a2, INTENABLE + rsr a3, INTERRUPT + movi a4, \mask + and a2, a2, a3 + and a2, a2, a4 + beqz a2, 9f /* nothing to do */ + + /* This bit of code provides a nice debug backtrace in the debugger. + It does take a few more instructions, so undef XT_DEBUG_BACKTRACE + if you want to save the cycles. + */ + #if XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 + \level - 1 /* return address */ + movi a4, 0xC0000000 /* constant with top 2 bits set (call size) */ + or a0, a0, a4 /* set top 2 bits */ + addx2 a0, a4, a0 /* clear top bit -- simulating call4 size */ + #endif + #endif + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a4, _xt_intexc_hooks + l32i a4, a4, \level << 2 + beqz a4, 2f + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqz a2, 9f + #else + mov a6, a2 + callx4 a4 + beqz a6, 9f + mov a2, a6 + #endif +2: + #endif + + /* Now look up in the dispatch table and call user ISR if any. */ + /* If multiple bits are set then MSB has highest priority. */ + + extract_msb a4, a2 /* a4 = MSB of a2, a2 trashed */ + + #ifdef XT_USE_SWPRI + /* Enable all interrupts at this level that are numerically higher + than the one we just selected, since they are treated as higher + priority. + */ + movi a3, \mask /* a3 = all interrupts at this level */ + add a2, a4, a4 /* a2 = a4 << 1 */ + addi a2, a2, -1 /* a2 = mask of 1's <= a4 bit */ + and a2, a2, a3 /* a2 = mask of all bits <= a4 at this level */ + movi a3, _xt_intdata + l32i a6, a3, 4 /* a6 = _xt_vpri_mask */ + neg a2, a2 + addi a2, a2, -1 /* a2 = mask to apply */ + and a5, a6, a2 /* mask off all bits <= a4 bit */ + s32i a5, a3, 4 /* update _xt_vpri_mask */ + rsr a3, INTENABLE + and a3, a3, a2 /* mask off all bits <= a4 bit */ + wsr a3, INTENABLE + rsil a3, \level - 1 /* lower interrupt level by 1 */ + #endif + + movi a3, XT_TIMER_INTEN /* a3 = timer interrupt bit */ + wsr a4, INTCLEAR /* clear sw or edge-triggered interrupt */ + beq a3, a4, 7f /* if timer interrupt then skip table */ + + find_ms_setbit a3, a4, a3, 0 /* a3 = interrupt number */ + + movi a4, _xt_interrupt_table + addx8 a3, a3, a4 /* a3 = address of interrupt table entry */ + l32i a4, a3, XIE_HANDLER /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 /* save in callee-saved reg */ + l32i a2, a3, XIE_ARG /* a2 = handler arg */ + callx0 a4 /* call handler */ + mov a2, a12 + #else + mov a2, a6 /* save in windowed reg */ + l32i a6, a3, XIE_ARG /* a6 = handler arg */ + callx4 a4 /* call handler */ + #endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + +7: + + .ifeq XT_TIMER_INTPRI - \level +.L_xt_user_int_timer_&level&: + /* + Interrupt handler for the RTOS tick timer if at this level. + We'll be reading the interrupt state again after this call + so no need to preserve any registers except a6 (vpri_mask). + */ + + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 + call0 XT_RTOS_TIMER_INT + mov a2, a12 + #else + mov a2, a6 + call4 XT_RTOS_TIMER_INT + #endif + .endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + + #ifdef XT_USE_SWPRI +8: + /* Restore old value of _xt_vpri_mask from a2. Also update INTENABLE from + virtual _xt_intenable which _could_ have changed during interrupt + processing. */ + + movi a3, _xt_intdata + l32i a4, a3, 0 /* a4 = _xt_intenable */ + s32i a2, a3, 4 /* update _xt_vpri_mask */ + and a4, a4, a2 /* a4 = masked intenable */ + wsr a4, INTENABLE /* update INTENABLE */ + #endif + +9: + /* done */ + + .endm + + +/* +-------------------------------------------------------------------------------- + Panic handler. + Should be reached by call0 (preferable) or jump only. If call0, a0 says where + from. If on simulator, display panic message and abort, else loop indefinitely. +-------------------------------------------------------------------------------- +*/ + + .section .iram1,"ax" + .global panicHandler + + .global _xt_panic + .type _xt_panic,@function + .align 4 + .literal_position + .align 4 + +_xt_panic: + /* Allocate exception frame and save minimal context. */ + mov a0, sp + addi sp, sp, -XT_STK_FRMSZ + s32i a0, sp, XT_STK_A1 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -12 /* for debug backtrace */ + #endif + rsr a0, PS /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_1 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -16 /* for debug backtrace */ + #endif + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + + /* Save exc cause and vaddr into exception frame */ + rsr a0, EXCCAUSE + s32i a0, sp, XT_STK_EXCCAUSE + rsr a0, EXCVADDR + s32i a0, sp, XT_STK_EXCVADDR + + /* _xt_context_save seems to save the current a0, but we need the interuptees a0. Fix this. */ + rsr a0, EXCSAVE_1 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + + /* Set up PS for C, reenable hi-pri interrupts, and clear EXCM. */ + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM | PS_WOE + wsr a0, PS + + //Call panic handler + mov a2,sp + call4 panicHandler + +1: j 1b /* loop infinitely */ + + retw + + + .align 4 +//Call using call0. Prints the hex char in a2. Kills a3, a4, a5 +panic_print_hex: + movi a3,0x60000000 + movi a4,8 +panic_print_hex_loop: + l32i a5, a3, 0x1c + extui a5, a5, 16, 8 + bgei a5,64,panic_print_hex_loop + + srli a5,a2,28 + bgei a5,10,panic_print_hex_a + addi a5,a5,'0' + j panic_print_hex_ok +panic_print_hex_a: + addi a5,a5,'A'-10 +panic_print_hex_ok: + s32i a5,a3,0 + slli a2,a2,4 + + addi a4,a4,-1 + bnei a4,0,panic_print_hex_loop + movi a5,' ' + s32i a5,a3,0 + + ret + + + + .section .rodata, "a" + .align 4 + + + +/* +-------------------------------------------------------------------------------- + Hooks to dynamically install handlers for exceptions and interrupts. + Allows automated regression frameworks to install handlers per test. + Consists of an array of function pointers indexed by interrupt level, + with index 0 containing the entry for user exceptions. + Initialized with all 0s, meaning no handler is installed at each level. + See comment in xtensa_rtos.h for more details. +-------------------------------------------------------------------------------- +*/ + + #ifdef XT_INTEXC_HOOKS + .data + .global _xt_intexc_hooks + .type _xt_intexc_hooks,@object + .align 4 + +_xt_intexc_hooks: + .fill XT_INTEXC_HOOK_NUM, 4, 0 + #endif + + +/* +-------------------------------------------------------------------------------- + EXCEPTION AND LEVEL 1 INTERRUPT VECTORS AND LOW LEVEL HANDLERS + (except window exception vectors). + + Each vector goes at a predetermined location according to the Xtensa + hardware configuration, which is ensured by its placement in a special + section known to the Xtensa linker support package (LSP). It performs + the minimum necessary before jumping to the handler in the .text section. + + The corresponding handler goes in the normal .text section. It sets up + the appropriate stack frame, saves a few vector-specific registers and + calls XT_RTOS_INT_ENTER to save the rest of the interrupted context + and enter the RTOS, then sets up a C environment. It then calls the + user's interrupt handler code (which may be coded in C) and finally + calls XT_RTOS_INT_EXIT to transfer control to the RTOS for scheduling. + + While XT_RTOS_INT_EXIT does not return directly to the interruptee, + eventually the RTOS scheduler will want to dispatch the interrupted + task or handler. The scheduler will return to the exit point that was + saved in the interrupt stack frame at XT_STK_EXIT. +-------------------------------------------------------------------------------- +*/ + + +/* +-------------------------------------------------------------------------------- +Debug Exception. +-------------------------------------------------------------------------------- +*/ + +#if XCHAL_HAVE_DEBUG + + .begin literal_prefix .DebugExceptionVector + .section .DebugExceptionVector.text, "ax" + .global _DebugExceptionVector + .align 4 + +_DebugExceptionVector: + + #ifdef XT_SIMULATOR + /* + In the simulator, let the debugger (if any) handle the debug exception, + or simply stop the simulation: + */ + wsr a2, EXCSAVE+XCHAL_DEBUGLEVEL /* save a2 where sim expects it */ + movi a2, SYS_gdb_enter_sktloop + simcall /* have ISS handle debug exc. */ + #elif 0 /* change condition to 1 to use the HAL minimal debug handler */ + wsr a3, EXCSAVE+XCHAL_DEBUGLEVEL + movi a3, xthal_debugexc_defhndlr_nw /* use default debug handler */ + jx a3 + #else + wsr a0, EXCSAVE+XCHAL_DEBUGLEVEL /* save original a0 somewhere */ + call0 _xt_panic /* does not return */ + rfi XCHAL_DEBUGLEVEL /* make a0 point here not later */ + #endif + + .end literal_prefix + +#endif + +/* +-------------------------------------------------------------------------------- +Double Exception. +Double exceptions are not a normal occurrence. They indicate a bug of some kind. +-------------------------------------------------------------------------------- +*/ + +#ifdef XCHAL_DOUBLEEXC_VECTOR_VADDR + + .begin literal_prefix .DoubleExceptionVector + .section .DoubleExceptionVector.text, "ax" + .global _DoubleExceptionVector + .align 4 + +_DoubleExceptionVector: + + #if XCHAL_HAVE_DEBUG + break 1, 4 /* unhandled double exception */ + #endif + call0 _xt_panic /* does not return */ + rfde /* make a0 point here not later */ + + .end literal_prefix + +#endif /* XCHAL_DOUBLEEXC_VECTOR_VADDR */ + +/* +-------------------------------------------------------------------------------- +Kernel Exception (including Level 1 Interrupt from kernel mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .KernelExceptionVector + .section .KernelExceptionVector.text, "ax" + .global _KernelExceptionVector + .align 4 + +_KernelExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_kernel_exc /* kernel exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .align 4 + +_xt_kernel_exc: + #if XCHAL_HAVE_DEBUG + break 1, 0 /* unhandled kernel exception */ + #endif + call0 _xt_panic /* does not return */ + rfe /* make a0 point here not there */ + + +/* +-------------------------------------------------------------------------------- +User Exception (including Level 1 Interrupt from user mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .UserExceptionVector + .section .UserExceptionVector.text, "ax" + .global _UserExceptionVector + .type _UserExceptionVector,@function + .align 4 + +_UserExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_user_exc /* user exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + +/* +-------------------------------------------------------------------------------- + Insert some waypoints for jumping beyond the signed 8-bit range of + conditional branch instructions, so the conditional branchces to specific + exception handlers are not taken in the mainline. Saves some cycles in the + mainline. +-------------------------------------------------------------------------------- +*/ + + .section .iram1,"ax" + + #if XCHAL_HAVE_WINDOWED + .align 4 +_xt_to_alloca_exc: + call0 _xt_alloca_exc /* in window vectors section */ + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + .align 4 +_xt_to_syscall_exc: + call0 _xt_syscall_exc + /* never returns here - call0 is used as a jump (see note at top) */ + + #if XCHAL_CP_NUM > 0 + .align 4 +_xt_to_coproc_exc: + call0 _xt_coproc_exc + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + +/* +-------------------------------------------------------------------------------- + User exception handler. +-------------------------------------------------------------------------------- +*/ + + .type _xt_user_exc,@function + .align 4 + +_xt_user_exc: + + /* If level 1 interrupt then jump to the dispatcher */ + rsr a0, EXCCAUSE + beqi a0, EXCCAUSE_LEVEL1INTERRUPT, _xt_lowint1 + + /* Handle any coprocessor exceptions. Rely on the fact that exception + numbers above EXCCAUSE_CP0_DISABLED all relate to the coprocessors. + */ + #if XCHAL_CP_NUM > 0 + bgeui a0, EXCCAUSE_CP0_DISABLED, _xt_to_coproc_exc + #endif + + /* Handle alloca and syscall exceptions */ + #if XCHAL_HAVE_WINDOWED + beqi a0, EXCCAUSE_ALLOCA, _xt_to_alloca_exc + #endif + beqi a0, EXCCAUSE_SYSCALL, _xt_to_syscall_exc + + /* Handle all other exceptions. All can have user-defined handlers. */ + /* NOTE: we'll stay on the user stack for exception handling. */ + + /* Allocate exception frame and save minimal context. */ + mov a0, sp + addi sp, sp, -XT_STK_FRMSZ + s32i a0, sp, XT_STK_A1 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -12 /* for debug backtrace */ + #endif + rsr a0, PS /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_1 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -16 /* for debug backtrace */ + #endif + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + + /* Save exc cause and vaddr into exception frame */ + rsr a0, EXCCAUSE + s32i a0, sp, XT_STK_EXCCAUSE + rsr a0, EXCVADDR + s32i a0, sp, XT_STK_EXCVADDR + + /* _xt_context_save seems to save the current a0, but we need the interuptees a0. Fix this. */ + rsr a0, EXCSAVE_1 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + + /* Set up PS for C, reenable hi-pri interrupts, and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM + #else + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM | PS_WOE + #endif + wsr a0, PS + + #ifdef XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 /* return address for debug backtrace */ + movi a5, 0xC0000000 /* constant with top 2 bits set (call size) */ + rsync /* wait for WSR.PS to complete */ + or a0, a0, a5 /* set top 2 bits */ + addx2 a0, a5, a0 /* clear top bit -- thus simulating call4 size */ + #else + rsync /* wait for WSR.PS to complete */ + #endif + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + + #ifdef XT_INTEXC_HOOKS + /* + Call exception hook to pre-handle exceptions (if installed). + Pass EXCCAUSE in a2, and check result in a2 (if -1, skip default handling). + */ + movi a4, _xt_intexc_hooks + l32i a4, a4, 0 /* user exception hook index 0 */ + beqz a4, 1f +.Ln_xt_user_exc_call_hook: + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqi a2, -1, .L_xt_user_done + #else + mov a6, a2 + callx4 a4 + beqi a6, -1, .L_xt_user_done + mov a2, a6 + #endif +1: + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + movi a3, _xt_exception_table + addx4 a4, a2, a3 /* a4 = address of exception table entry */ + l32i a4, a4, 0 /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a2, sp /* a2 = pointer to exc frame */ + callx0 a4 /* call handler */ + #else + mov a6, sp /* a6 = pointer to exc frame */ + callx4 a4 /* call handler */ + #endif + +.L_xt_user_done: + + /* Restore context and return */ + call0 _xt_context_restore + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove exception frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* +-------------------------------------------------------------------------------- + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. +-------------------------------------------------------------------------------- +*/ + + .global _xt_user_exit + .type _xt_user_exit,@function + .align 4 +_xt_user_exit: + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* + +-------------------------------------------------------------------------------- +Syscall Exception Handler (jumped to from User Exception Handler). +Syscall 0 is required to spill the register windows (no-op in Call 0 ABI). +Only syscall 0 is handled here. Other syscalls return -1 to caller in a2. +-------------------------------------------------------------------------------- +*/ + + .section .iram1,"ax" + .type _xt_syscall_exc,@function + .align 4 +_xt_syscall_exc: + + #ifdef __XTENSA_CALL0_ABI__ + /* + Save minimal regs for scratch. Syscall 0 does nothing in Call0 ABI. + Use a minimal stack frame (16B) to save A2 & A3 for scratch. + PS.EXCM could be cleared here, but unlikely to improve worst-case latency. + rsr a0, PS + addi a0, a0, -PS_EXCM_MASK + wsr a0, PS + */ + addi sp, sp, -16 + s32i a2, sp, 8 + s32i a3, sp, 12 + #else /* Windowed ABI */ + /* + Save necessary context and spill the register windows. + PS.EXCM is still set and must remain set until after the spill. + Reuse context save function though it saves more than necessary. + For this reason, a full interrupt stack frame is allocated. + */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + #endif + + /* + Grab the interruptee's PC and skip over the 'syscall' instruction. + If it's at the end of a zero-overhead loop and it's not on the last + iteration, decrement loop counter and skip to beginning of loop. + */ + rsr a2, EPC_1 /* a2 = PC of 'syscall' */ + addi a3, a2, 3 /* ++PC */ + #if XCHAL_HAVE_LOOPS + rsr a0, LEND /* if (PC == LEND */ + bne a3, a0, 1f + rsr a0, LCOUNT /* && LCOUNT != 0) */ + beqz a0, 1f /* { */ + addi a0, a0, -1 /* --LCOUNT */ + rsr a3, LBEG /* PC = LBEG */ + wsr a0, LCOUNT /* } */ + #endif +1: wsr a3, EPC_1 /* update PC */ + + /* Restore interruptee's context and return from exception. */ + #ifdef __XTENSA_CALL0_ABI__ + l32i a2, sp, 8 + l32i a3, sp, 12 + addi sp, sp, 16 + #else + call0 _xt_context_restore + addi sp, sp, XT_STK_FRMSZ + #endif + movi a0, -1 + movnez a2, a0, a2 /* return -1 if not syscall 0 */ + rsr a0, EXCSAVE_1 + rfe + +/* +-------------------------------------------------------------------------------- +Co-Processor Exception Handler (jumped to from User Exception Handler). +These exceptions are generated by co-processor instructions, which are only +allowed in thread code (not in interrupts or kernel code). This restriction is +deliberately imposed to reduce the burden of state-save/restore in interrupts. +-------------------------------------------------------------------------------- +*/ +#if XCHAL_CP_NUM > 0 + + .section .rodata, "a" + +/* Offset to CP n save area in thread's CP save area. */ + .global _xt_coproc_sa_offset + .type _xt_coproc_sa_offset,@object + .align 16 /* minimize crossing cache boundaries */ +_xt_coproc_sa_offset: + .word XT_CP0_SA, XT_CP1_SA, XT_CP2_SA, XT_CP3_SA + .word XT_CP4_SA, XT_CP5_SA, XT_CP6_SA, XT_CP7_SA + +/* Bitmask for CP n's CPENABLE bit. */ + .type _xt_coproc_mask,@object + .align 16,,8 /* try to keep it all in one cache line */ + .set i, 0 +_xt_coproc_mask: + .rept XCHAL_CP_MAX + .long (i<<16) | (1<= 2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_medint2 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_medint2,@function + .align 4 +_xt_medint2: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_2 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_2 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_2 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint2_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(2) | PS_UM + #else + movi a0, PS_INTLEVEL(2) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 2 XCHAL_INTLEVEL2_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint2_exit + .type _xt_medint2_exit,@function + .align 4 +_xt_medint2_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_2 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_2 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_EXCM_LEVEL >= 3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_medint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_medint3,@function + .align 4 +_xt_medint3: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_3 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_3 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_3 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint3_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(3) | PS_UM + #else + movi a0, PS_INTLEVEL(3) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 3 XCHAL_INTLEVEL3_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint3_exit + .type _xt_medint3_exit,@function + .align 4 +_xt_medint3_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_3 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_3 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_EXCM_LEVEL >= 4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_medint4 /* load interrupt handler */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_medint4,@function + .align 4 +_xt_medint4: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_4 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_4 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_4 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint4_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(4) | PS_UM + #else + movi a0, PS_INTLEVEL(4) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 4 XCHAL_INTLEVEL4_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint4_exit + .type _xt_medint4_exit,@function + .align 4 +_xt_medint4_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_4 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_4 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_EXCM_LEVEL >= 5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_medint5 /* load interrupt handler */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_medint5,@function + .align 4 +_xt_medint5: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_5 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_5 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_5 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint5_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(5) | PS_UM + #else + movi a0, PS_INTLEVEL(5) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 5 XCHAL_INTLEVEL5_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint5_exit + .type _xt_medint5_exit,@function + .align 4 +_xt_medint5_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_5 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_5 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_EXCM_LEVEL >= 6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_medint6 /* load interrupt handler */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_medint6,@function + .align 4 +_xt_medint6: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_6 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_6 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_6 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint6_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(6) | PS_UM + #else + movi a0, PS_INTLEVEL(6) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 6 XCHAL_INTLEVEL6_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint6_exit + .type _xt_medint6_exit,@function + .align 4 +_xt_medint6_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_6 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_6 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 6 + +#endif /* Level 6 */ + + +/******************************************************************************* + +HIGH PRIORITY (LEVEL > XCHAL_EXCM_LEVEL) INTERRUPT VECTORS AND HANDLERS + +High priority interrupts are by definition those with priorities greater +than XCHAL_EXCM_LEVEL. This includes non-maskable (NMI). High priority +interrupts cannot interact with the RTOS, that is they must save all regs +they use and not call any RTOS function. + +A further restriction imposed by the Xtensa windowed architecture is that +high priority interrupts must not modify the stack area even logically +"above" the top of the interrupted stack (they need to provide their +own stack or static save area). + +Cadence Design Systems recommends high priority interrupt handlers be coded in assembly +and used for purposes requiring very short service times. + +Here are templates for high priority (level 2+) interrupt vectors. +They assume only one interrupt per level to avoid the burden of identifying +which interrupts at this level are pending and enabled. This allows for +minimum latency and avoids having to save/restore a2 in addition to a0. +If more than one interrupt per high priority level is configured, this burden +is on the handler which in any case must provide a way to save and restore +registers it uses without touching the interrupted stack. + +Each vector goes at a predetermined location according to the Xtensa +hardware configuration, which is ensured by its placement in a special +section known to the Xtensa linker support package (LSP). It performs +the minimum necessary before jumping to the handler in the .text section. + +*******************************************************************************/ + +/* +Currently only shells for high priority interrupt handlers are provided +here. However a template and example can be found in the Cadence Design Systems tools +documentation: "Microprocessor Programmer's Guide". +*/ + +#if XCHAL_NUM_INTLEVELS >=2 && XCHAL_EXCM_LEVEL <2 && XCHAL_DEBUGLEVEL !=2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_highint2 /* load interrupt handler */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_highint2,@function + .align 4 +_xt_highint2: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 2<<2 + beqz a0, 1f +.Ln_xt_highint2_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 2 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint2_exit: + rsr a0, EXCSAVE_2 /* restore a0 */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_NUM_INTLEVELS >=3 && XCHAL_EXCM_LEVEL <3 && XCHAL_DEBUGLEVEL !=3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_highint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_highint3,@function + .align 4 +_xt_highint3: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 3<<2 + beqz a0, 1f +.Ln_xt_highint3_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 3 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint3_exit: + rsr a0, EXCSAVE_3 /* restore a0 */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_NUM_INTLEVELS >=4 && XCHAL_EXCM_LEVEL <4 && XCHAL_DEBUGLEVEL !=4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_highint4 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_highint4,@function + .align 4 +_xt_highint4: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 4<<2 + beqz a0, 1f +.Ln_xt_highint4_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 4 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint4_exit: + rsr a0, EXCSAVE_4 /* restore a0 */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_NUM_INTLEVELS >=5 && XCHAL_EXCM_LEVEL <5 && XCHAL_DEBUGLEVEL !=5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_highint5 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_highint5,@function + .align 4 +_xt_highint5: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 5<<2 + beqz a0, 1f +.Ln_xt_highint5_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 5 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint5_exit: + rsr a0, EXCSAVE_5 /* restore a0 */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_NUM_INTLEVELS >=6 && XCHAL_EXCM_LEVEL <6 && XCHAL_DEBUGLEVEL !=6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_highint6 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_highint6,@function + .align 4 +_xt_highint6: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 6<<2 + beqz a0, 1f +.Ln_xt_highint6_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 6 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint6_exit: + rsr a0, EXCSAVE_6 /* restore a0 */ + rfi 6 + +#endif /* Level 6 */ + +#if XCHAL_HAVE_NMI + + .begin literal_prefix .NMIExceptionVector + .section .NMIExceptionVector.text, "ax" + .global _NMIExceptionVector + .type _NMIExceptionVector,@function + .align 4 +_NMIExceptionVector: + wsr a0, EXCSAVE + XCHAL_NMILEVEL _ /* preserve a0 */ + call0 _xt_nmi /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .section .iram1,"ax" + .type _xt_nmi,@function + .align 4 +_xt_nmi: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, XCHAL_NMILEVEL<<2 + beqz a0, 1f +.Ln_xt_nmi_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY NON-MASKABLE INTERRUPT (NMI) HANDLER CODE HERE. + */ + + .align 4 +.L_xt_nmi_exit: + rsr a0, EXCSAVE + XCHAL_NMILEVEL /* restore a0 */ + rfi XCHAL_NMILEVEL + +#endif /* NMI */ + + +/******************************************************************************* + +WINDOW OVERFLOW AND UNDERFLOW EXCEPTION VECTORS AND ALLOCA EXCEPTION HANDLER + +Here is the code for each window overflow/underflow exception vector and +(interspersed) efficient code for handling the alloca exception cause. +Window exceptions are handled entirely in the vector area and are very +tight for performance. The alloca exception is also handled entirely in +the window vector area so comes at essentially no cost in code size. +Users should never need to modify them and Cadence Design Systems recommends +they do not. + +Window handlers go at predetermined vector locations according to the +Xtensa hardware configuration, which is ensured by their placement in a +special section known to the Xtensa linker support package (LSP). Since +their offsets in that section are always the same, the LSPs do not define +a section per vector. + +These things are coded for XEA2 only (XEA1 is not supported). + +Note on Underflow Handlers: +The underflow handler for returning from call[i+1] to call[i] +must preserve all the registers from call[i+1]'s window. +In particular, a0 and a1 must be preserved because the RETW instruction +will be reexecuted (and may even underflow if an intervening exception +has flushed call[i]'s registers). +Registers a2 and up may contain return values. + +*******************************************************************************/ + +#if XCHAL_HAVE_WINDOWED + + .section .WindowVectors.text, "ax" + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call4. + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call4 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a3 are registers to be saved; + a4-a15 must be preserved; + a5 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x0 + .global _WindowOverflow4 +_WindowOverflow4: + + s32e a0, a5, -16 /* save a0 to call[j+1]'s stack frame */ + s32e a1, a5, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a5, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a5, -4 /* save a3 to call[j+1]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call4 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call4 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a3 are undefined, must be reloaded with call[i].reg[0..3]; + a4-a15 must be preserved (they are call[i+1].reg[0..11]); + a5 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x40 + .global _WindowUnderflow4 +_WindowUnderflow4: + + l32e a0, a5, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a5, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a5, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a3, a5, -4 /* restore a3 from call[i+1]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Handle alloca exception generated by interruptee executing 'movsp'. +This uses space between the window vectors, so is essentially "free". +All interruptee's regs are intact except a0 which is saved in EXCSAVE_1, +and PS.EXCM has been set by the exception hardware (can't be interrupted). +The fact the alloca exception was taken means the registers associated with +the base-save area have been spilled and will be restored by the underflow +handler, so those 4 registers are available for scratch. +The code is optimized to avoid unaligned branches and minimize cache misses. +-------------------------------------------------------------------------------- +*/ + + .align 4 + .global _xt_alloca_exc +_xt_alloca_exc: + + rsr a0, WINDOWBASE /* grab WINDOWBASE before rotw changes it */ + rotw -1 /* WINDOWBASE goes to a4, new a0-a3 are scratch */ + rsr a2, PS + extui a3, a2, XCHAL_PS_OWB_SHIFT, XCHAL_PS_OWB_BITS + xor a3, a3, a4 /* bits changed from old to current windowbase */ + rsr a4, EXCSAVE_1 /* restore original a0 (now in a4) */ + slli a3, a3, XCHAL_PS_OWB_SHIFT + xor a2, a2, a3 /* flip changed bits in old window base */ + wsr a2, PS /* update PS.OWB to new window base */ + rsync + + _bbci.l a4, 31, _WindowUnderflow4 + rotw -1 /* original a0 goes to a8 */ + _bbci.l a8, 30, _WindowUnderflow8 + rotw -1 + j _WindowUnderflow12 + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call8 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call8 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a7 are registers to be saved; + a8-a15 must be preserved; + a9 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x80 + .global _WindowOverflow8 +_WindowOverflow8: + + s32e a0, a9, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a9, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a9, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a9, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -32 /* save a4 to call[j]'s stack frame */ + s32e a5, a0, -28 /* save a5 to call[j]'s stack frame */ + s32e a6, a0, -24 /* save a6 to call[j]'s stack frame */ + s32e a7, a0, -20 /* save a7 to call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call8 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call8 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a7 are undefined, must be reloaded with call[i].reg[0..7]; + a8-a15 must be preserved (they are call[i+1].reg[0..7]); + a9 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0xC0 + .global _WindowUnderflow8 +_WindowUnderflow8: + + l32e a0, a9, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a9, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a9, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a7, a1, -12 /* a7 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a9, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a7, -32 /* restore a4 from call[i]'s stack frame */ + l32e a5, a7, -28 /* restore a5 from call[i]'s stack frame */ + l32e a6, a7, -24 /* restore a6 from call[i]'s stack frame */ + l32e a7, a7, -20 /* restore a7 from call[i]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call12 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call12 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a11 are registers to be saved; + a12-a15 must be preserved; + a13 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x100 + .global _WindowOverflow12 +_WindowOverflow12: + + s32e a0, a13, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a13, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a13, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a13, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -48 /* save a4 to end of call[j]'s stack frame */ + s32e a5, a0, -44 /* save a5 to end of call[j]'s stack frame */ + s32e a6, a0, -40 /* save a6 to end of call[j]'s stack frame */ + s32e a7, a0, -36 /* save a7 to end of call[j]'s stack frame */ + s32e a8, a0, -32 /* save a8 to end of call[j]'s stack frame */ + s32e a9, a0, -28 /* save a9 to end of call[j]'s stack frame */ + s32e a10, a0, -24 /* save a10 to end of call[j]'s stack frame */ + s32e a11, a0, -20 /* save a11 to end of call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call12 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call12 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a11 are undefined, must be reloaded with call[i].reg[0..11]; + a12-a15 must be preserved (they are call[i+1].reg[0..3]); + a13 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x140 + .global _WindowUnderflow12 +_WindowUnderflow12: + + l32e a0, a13, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a13, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a13, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a11, a1, -12 /* a11 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a13, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a11, -48 /* restore a4 from end of call[i]'s stack frame */ + l32e a5, a11, -44 /* restore a5 from end of call[i]'s stack frame */ + l32e a6, a11, -40 /* restore a6 from end of call[i]'s stack frame */ + l32e a7, a11, -36 /* restore a7 from end of call[i]'s stack frame */ + l32e a8, a11, -32 /* restore a8 from end of call[i]'s stack frame */ + l32e a9, a11, -28 /* restore a9 from end of call[i]'s stack frame */ + l32e a10, a11, -24 /* restore a10 from end of call[i]'s stack frame */ + l32e a11, a11, -20 /* restore a11 from end of call[i]'s stack frame */ + rfwu + +#endif /* XCHAL_HAVE_WINDOWED */ + + .section .UserEnter.text, "ax" + .global call_user_start + .type call_user_start,@function + .align 4 + .literal_position + + + diff --git a/components/freertos/xtensa_vectors.S-new b/components/freertos/xtensa_vectors.S-new new file mode 100644 index 000000000..88349eee9 --- /dev/null +++ b/components/freertos/xtensa_vectors.S-new @@ -0,0 +1,1915 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA VECTORS AND LOW LEVEL HANDLERS FOR AN RTOS + + Xtensa low level exception and interrupt vectors and handlers for an RTOS. + + Interrupt handlers and user exception handlers support interaction with + the RTOS by calling XT_RTOS_INT_ENTER and XT_RTOS_INT_EXIT before and + after user's specific interrupt handlers. These macros are defined in + xtensa_.h to call suitable functions in a specific RTOS. + + Users can install application-specific interrupt handlers for low and + medium level interrupts, by calling xt_set_interrupt_handler(). These + handlers can be written in C, and must obey C calling convention. The + handler table is indexed by the interrupt number. Each handler may be + provided with an argument. + + Note that the system timer interrupt is handled specially, and is + dispatched to the RTOS-specific handler. This timer cannot be hooked + by application code. + + Optional hooks are also provided to install a handler per level at + run-time, made available by compiling this source file with + '-DXT_INTEXC_HOOKS' (useful for automated testing). + +!! This file is a template that usually needs to be modified to handle !! +!! application specific interrupts. Search USER_EDIT for helpful comments !! +!! on where to insert handlers and how to write them. !! + + Users can also install application-specific exception handlers in the + same way, by calling xt_set_exception_handler(). One handler slot is + provided for each exception type. Note that some exceptions are handled + by the porting layer itself, and cannot be taken over by application + code in this manner. These are the alloca, syscall, and coprocessor + exceptions. + + The exception handlers can be written in C, and must follow C calling + convention. Each handler is passed a pointer to an exception frame as + its single argument. The exception frame is created on the stack, and + holds the saved context of the thread that took the exception. If the + handler returns, the context will be restored and the instruction that + caused the exception will be retried. If the handler makes any changes + to the saved state in the exception frame, the changes will be applied + when restoring the context. + + Because Xtensa is a configurable architecture, this port supports all user + generated configurations (except restrictions stated in the release notes). + This is accomplished by conditional compilation using macros and functions + defined in the Xtensa HAL (hardware adaptation layer) for your configuration. + Only the relevant parts of this file will be included in your RTOS build. + For example, this file provides interrupt vector templates for all types and + all priority levels, but only the ones in your configuration are built. + + NOTES on the use of 'call0' for long jumps instead of 'j': + 1. This file should be assembled with the -mlongcalls option to xt-xcc. + 2. The -mlongcalls compiler option causes 'call0 dest' to be expanded to + a sequence 'l32r a0, dest' 'callx0 a0' which works regardless of the + distance from the call to the destination. The linker then relaxes + it back to 'call0 dest' if it determines that dest is within range. + This allows more flexibility in locating code without the performance + overhead of the 'l32r' literal data load in cases where the destination + is in range of 'call0'. There is an additional benefit in that 'call0' + has a longer range than 'j' due to the target being word-aligned, so + the 'l32r' sequence is less likely needed. + 3. The use of 'call0' with -mlongcalls requires that register a0 not be + live at the time of the call, which is always the case for a function + call but needs to be ensured if 'call0' is used as a jump in lieu of 'j'. + 4. This use of 'call0' is independent of the C function call ABI. + +*******************************************************************************/ + +#include "xtensa_rtos.h" + + +/* Enable stack backtrace across exception/interrupt - see below */ +#define XT_DEBUG_BACKTRACE 1 + + +/* +-------------------------------------------------------------------------------- + Defines used to access _xtos_interrupt_table. +-------------------------------------------------------------------------------- +*/ +#define XIE_HANDLER 0 +#define XIE_ARG 4 +#define XIE_SIZE 8 + +/* +-------------------------------------------------------------------------------- + Macro extract_msb - return the input with only the highest bit set. + + Input : "ain" - Input value, clobbered. + Output : "aout" - Output value, has only one bit set, MSB of "ain". + The two arguments must be different AR registers. +-------------------------------------------------------------------------------- +*/ + + .macro extract_msb aout ain +1: + addi \aout, \ain, -1 /* aout = ain - 1 */ + and \ain, \ain, \aout /* ain = ain & aout */ + bnez \ain, 1b /* repeat until ain == 0 */ + addi \aout, \aout, 1 /* return aout + 1 */ + .endm + +/* +-------------------------------------------------------------------------------- + Macro dispatch_c_isr - dispatch interrupts to user ISRs. + This will dispatch to user handlers (if any) that are registered in the + XTOS dispatch table (_xtos_interrupt_table). These handlers would have + been registered by calling _xtos_set_interrupt_handler(). There is one + exception - the timer interrupt used by the OS will not be dispatched + to a user handler - this must be handled by the caller of this macro. + + Level triggered and software interrupts are automatically deasserted by + this code. + + ASSUMPTIONS: + -- PS.INTLEVEL is set to "level" at entry + -- PS.EXCM = 0, C calling enabled + + NOTE: For CALL0 ABI, a12-a15 have not yet been saved. + + NOTE: This macro will use registers a0 and a2-a6. The arguments are: + level -- interrupt level + mask -- interrupt bitmask for this level +-------------------------------------------------------------------------------- +*/ + + .macro dispatch_c_isr level mask + + /* Get mask of pending, enabled interrupts at this level into a2. */ + +.L_xt_user_int_&level&: + rsr a2, INTENABLE + rsr a3, INTERRUPT + movi a4, \mask + and a2, a2, a3 + and a2, a2, a4 + beqz a2, 9f /* nothing to do */ + + /* This bit of code provides a nice debug backtrace in the debugger. + It does take a few more instructions, so undef XT_DEBUG_BACKTRACE + if you want to save the cycles. + */ + #if XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 + \level - 1 /* return address */ + movi a4, 0xC0000000 /* constant with top 2 bits set (call size) */ + or a0, a0, a4 /* set top 2 bits */ + addx2 a0, a4, a0 /* clear top bit -- simulating call4 size */ + #endif + #endif + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a4, _xt_intexc_hooks + l32i a4, a4, \level << 2 + beqz a4, 2f + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqz a2, 9f + #else + mov a6, a2 + callx4 a4 + beqz a6, 9f + mov a2, a6 + #endif +2: + #endif + + /* Now look up in the dispatch table and call user ISR if any. */ + /* If multiple bits are set then MSB has highest priority. */ + + extract_msb a4, a2 /* a4 = MSB of a2, a2 trashed */ + + #ifdef XT_USE_SWPRI + /* Enable all interrupts at this level that are numerically higher + than the one we just selected, since they are treated as higher + priority. + */ + movi a3, \mask /* a3 = all interrupts at this level */ + add a2, a4, a4 /* a2 = a4 << 1 */ + addi a2, a2, -1 /* a2 = mask of 1's <= a4 bit */ + and a2, a2, a3 /* a2 = mask of all bits <= a4 at this level */ + movi a3, _xt_intdata + l32i a6, a3, 4 /* a6 = _xt_vpri_mask */ + neg a2, a2 + addi a2, a2, -1 /* a2 = mask to apply */ + and a5, a6, a2 /* mask off all bits <= a4 bit */ + s32i a5, a3, 4 /* update _xt_vpri_mask */ + rsr a3, INTENABLE + and a3, a3, a2 /* mask off all bits <= a4 bit */ + wsr a3, INTENABLE + rsil a3, \level - 1 /* lower interrupt level by 1 */ + #endif + + movi a3, XT_TIMER_INTEN /* a3 = timer interrupt bit */ + wsr a4, INTCLEAR /* clear sw or edge-triggered interrupt */ + beq a3, a4, 7f /* if timer interrupt then skip table */ + + find_ms_setbit a3, a4, a3, 0 /* a3 = interrupt number */ + + movi a4, _xt_interrupt_table + addx8 a3, a3, a4 /* a3 = address of interrupt table entry */ + l32i a4, a3, XIE_HANDLER /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 /* save in callee-saved reg */ + l32i a2, a3, XIE_ARG /* a2 = handler arg */ + callx0 a4 /* call handler */ + mov a2, a12 + #else + mov a2, a6 /* save in windowed reg */ + l32i a6, a3, XIE_ARG /* a6 = handler arg */ + callx4 a4 /* call handler */ + #endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + +7: + + .ifeq XT_TIMER_INTPRI - \level +.L_xt_user_int_timer_&level&: + /* + Interrupt handler for the RTOS tick timer if at this level. + We'll be reading the interrupt state again after this call + so no need to preserve any registers except a6 (vpri_mask). + */ + + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 + call0 XT_RTOS_TIMER_INT + mov a2, a12 + #else + mov a2, a6 + call4 XT_RTOS_TIMER_INT + #endif + .endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + + #ifdef XT_USE_SWPRI +8: + /* Restore old value of _xt_vpri_mask from a2. Also update INTENABLE from + virtual _xt_intenable which _could_ have changed during interrupt + processing. */ + + movi a3, _xt_intdata + l32i a4, a3, 0 /* a4 = _xt_intenable */ + s32i a2, a3, 4 /* update _xt_vpri_mask */ + and a4, a4, a2 /* a4 = masked intenable */ + wsr a4, INTENABLE /* update INTENABLE */ + #endif + +9: + /* done */ + + .endm + + +/* +-------------------------------------------------------------------------------- + Panic handler. + Should be reached by call0 (preferable) or jump only. If call0, a0 says where + from. If on simulator, display panic message and abort, else loop indefinitely. +-------------------------------------------------------------------------------- +*/ + + .text + .global _xt_panic + .type _xt_panic,@function + .align 4 + +_xt_panic: + #ifdef XT_SIMULATOR + addi a4, a0, -3 /* point to call0 */ + movi a3, _xt_panic_message + movi a2, SYS_log_msg + simcall + movi a2, SYS_gdb_abort + simcall + #else + rsil a2, XCHAL_EXCM_LEVEL /* disable all low & med ints */ +1: j 1b /* loop infinitely */ + #endif + + .section .rodata, "a" + .align 4 + +_xt_panic_message: + .string "\n*** _xt_panic() was called from 0x%08x or jumped to. ***\n" + + +/* +-------------------------------------------------------------------------------- + Hooks to dynamically install handlers for exceptions and interrupts. + Allows automated regression frameworks to install handlers per test. + Consists of an array of function pointers indexed by interrupt level, + with index 0 containing the entry for user exceptions. + Initialized with all 0s, meaning no handler is installed at each level. + See comment in xtensa_rtos.h for more details. +-------------------------------------------------------------------------------- +*/ + + #ifdef XT_INTEXC_HOOKS + .data + .global _xt_intexc_hooks + .type _xt_intexc_hooks,@object + .align 4 + +_xt_intexc_hooks: + .fill XT_INTEXC_HOOK_NUM, 4, 0 + #endif + + +/* +-------------------------------------------------------------------------------- + EXCEPTION AND LEVEL 1 INTERRUPT VECTORS AND LOW LEVEL HANDLERS + (except window exception vectors). + + Each vector goes at a predetermined location according to the Xtensa + hardware configuration, which is ensured by its placement in a special + section known to the Xtensa linker support package (LSP). It performs + the minimum necessary before jumping to the handler in the .text section. + + The corresponding handler goes in the normal .text section. It sets up + the appropriate stack frame, saves a few vector-specific registers and + calls XT_RTOS_INT_ENTER to save the rest of the interrupted context + and enter the RTOS, then sets up a C environment. It then calls the + user's interrupt handler code (which may be coded in C) and finally + calls XT_RTOS_INT_EXIT to transfer control to the RTOS for scheduling. + + While XT_RTOS_INT_EXIT does not return directly to the interruptee, + eventually the RTOS scheduler will want to dispatch the interrupted + task or handler. The scheduler will return to the exit point that was + saved in the interrupt stack frame at XT_STK_EXIT. +-------------------------------------------------------------------------------- +*/ + + +/* +-------------------------------------------------------------------------------- +Debug Exception. +-------------------------------------------------------------------------------- +*/ + +#if XCHAL_HAVE_DEBUG + + .begin literal_prefix .DebugExceptionVector + .section .DebugExceptionVector.text, "ax" + .global _DebugExceptionVector + .align 4 + +_DebugExceptionVector: + + #ifdef XT_SIMULATOR + /* + In the simulator, let the debugger (if any) handle the debug exception, + or simply stop the simulation: + */ + wsr a2, EXCSAVE+XCHAL_DEBUGLEVEL /* save a2 where sim expects it */ + movi a2, SYS_gdb_enter_sktloop + simcall /* have ISS handle debug exc. */ + #elif 0 /* change condition to 1 to use the HAL minimal debug handler */ + wsr a3, EXCSAVE+XCHAL_DEBUGLEVEL + movi a3, xthal_debugexc_defhndlr_nw /* use default debug handler */ + jx a3 + #else + wsr a0, EXCSAVE+XCHAL_DEBUGLEVEL /* save original a0 somewhere */ + call0 _xt_panic /* does not return */ + rfi XCHAL_DEBUGLEVEL /* make a0 point here not later */ + #endif + + .end literal_prefix + +#endif + +/* +-------------------------------------------------------------------------------- +Double Exception. +Double exceptions are not a normal occurrence. They indicate a bug of some kind. +-------------------------------------------------------------------------------- +*/ + +#ifdef XCHAL_DOUBLEEXC_VECTOR_VADDR + + .begin literal_prefix .DoubleExceptionVector + .section .DoubleExceptionVector.text, "ax" + .global _DoubleExceptionVector + .align 4 + +_DoubleExceptionVector: + + #if XCHAL_HAVE_DEBUG + break 1, 4 /* unhandled double exception */ + #endif + call0 _xt_panic /* does not return */ + rfde /* make a0 point here not later */ + + .end literal_prefix + +#endif /* XCHAL_DOUBLEEXC_VECTOR_VADDR */ + +/* +-------------------------------------------------------------------------------- +Kernel Exception (including Level 1 Interrupt from kernel mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .KernelExceptionVector + .section .KernelExceptionVector.text, "ax" + .global _KernelExceptionVector + .align 4 + +_KernelExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_kernel_exc /* kernel exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .align 4 + +_xt_kernel_exc: + #if XCHAL_HAVE_DEBUG + break 1, 0 /* unhandled kernel exception */ + #endif + call0 _xt_panic /* does not return */ + rfe /* make a0 point here not there */ + + +/* +-------------------------------------------------------------------------------- +User Exception (including Level 1 Interrupt from user mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .UserExceptionVector + .section .UserExceptionVector.text, "ax" + .global _UserExceptionVector + .type _UserExceptionVector,@function + .align 4 + +_UserExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_user_exc /* user exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + +/* +-------------------------------------------------------------------------------- + Insert some waypoints for jumping beyond the signed 8-bit range of + conditional branch instructions, so the conditional branchces to specific + exception handlers are not taken in the mainline. Saves some cycles in the + mainline. +-------------------------------------------------------------------------------- +*/ + + .text + + #if XCHAL_HAVE_WINDOWED + .align 4 +_xt_to_alloca_exc: + call0 _xt_alloca_exc /* in window vectors section */ + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + .align 4 +_xt_to_syscall_exc: + call0 _xt_syscall_exc + /* never returns here - call0 is used as a jump (see note at top) */ + + #if XCHAL_CP_NUM > 0 + .align 4 +_xt_to_coproc_exc: + call0 _xt_coproc_exc + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + +/* +-------------------------------------------------------------------------------- + User exception handler. +-------------------------------------------------------------------------------- +*/ + + .type _xt_user_exc,@function + .align 4 + +_xt_user_exc: + + /* If level 1 interrupt then jump to the dispatcher */ + rsr a0, EXCCAUSE + beqi a0, EXCCAUSE_LEVEL1INTERRUPT, _xt_lowint1 + + /* Handle any coprocessor exceptions. Rely on the fact that exception + numbers above EXCCAUSE_CP0_DISABLED all relate to the coprocessors. + */ + #if XCHAL_CP_NUM > 0 + bgeui a0, EXCCAUSE_CP0_DISABLED, _xt_to_coproc_exc + #endif + + /* Handle alloca and syscall exceptions */ + #if XCHAL_HAVE_WINDOWED + beqi a0, EXCCAUSE_ALLOCA, _xt_to_alloca_exc + #endif + beqi a0, EXCCAUSE_SYSCALL, _xt_to_syscall_exc + + /* Handle all other exceptions. All can have user-defined handlers. */ + /* NOTE: we'll stay on the user stack for exception handling. */ + + /* Allocate exception frame and save minimal context. */ + mov a0, sp + addi sp, sp, -XT_STK_FRMSZ + s32i a0, sp, XT_STK_A1 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -12 /* for debug backtrace */ + #endif + rsr a0, PS /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_1 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_1 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -16 /* for debug backtrace */ + #endif + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + + /* Save exc cause and vaddr into exception frame */ + rsr a0, EXCCAUSE + s32i a0, sp, XT_STK_EXCCAUSE + rsr a0, EXCVADDR + s32i a0, sp, XT_STK_EXCVADDR + + /* Set up PS for C, reenable hi-pri interrupts, and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM + #else + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM | PS_WOE + #endif + wsr a0, PS + + #ifdef XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 /* return address for debug backtrace */ + movi a5, 0xC0000000 /* constant with top 2 bits set (call size) */ + rsync /* wait for WSR.PS to complete */ + or a0, a0, a5 /* set top 2 bits */ + addx2 a0, a5, a0 /* clear top bit -- thus simulating call4 size */ + #else + rsync /* wait for WSR.PS to complete */ + #endif + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + + #ifdef XT_INTEXC_HOOKS + /* + Call exception hook to pre-handle exceptions (if installed). + Pass EXCCAUSE in a2, and check result in a2 (if -1, skip default handling). + */ + movi a4, _xt_intexc_hooks + l32i a4, a4, 0 /* user exception hook index 0 */ + beqz a4, 1f +.Ln_xt_user_exc_call_hook: + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqi a2, -1, .L_xt_user_done + #else + mov a6, a2 + callx4 a4 + beqi a6, -1, .L_xt_user_done + mov a2, a6 + #endif +1: + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + movi a3, _xt_exception_table + addx4 a4, a2, a3 /* a4 = address of exception table entry */ + l32i a4, a4, 0 /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a2, sp /* a2 = pointer to exc frame */ + callx0 a4 /* call handler */ + #else + mov a6, sp /* a6 = pointer to exc frame */ + callx4 a4 /* call handler */ + #endif + +.L_xt_user_done: + + /* Restore context and return */ + call0 _xt_context_restore + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove exception frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* +-------------------------------------------------------------------------------- + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. +-------------------------------------------------------------------------------- +*/ + + .global _xt_user_exit + .type _xt_user_exit,@function + .align 4 +_xt_user_exit: + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* +-------------------------------------------------------------------------------- +Syscall Exception Handler (jumped to from User Exception Handler). +Syscall 0 is required to spill the register windows (no-op in Call 0 ABI). +Only syscall 0 is handled here. Other syscalls return -1 to caller in a2. +-------------------------------------------------------------------------------- +*/ + + .text + .type _xt_syscall_exc,@function + .align 4 +_xt_syscall_exc: + + #ifdef __XTENSA_CALL0_ABI__ + /* + Save minimal regs for scratch. Syscall 0 does nothing in Call0 ABI. + Use a minimal stack frame (16B) to save A2 & A3 for scratch. + PS.EXCM could be cleared here, but unlikely to improve worst-case latency. + rsr a0, PS + addi a0, a0, -PS_EXCM_MASK + wsr a0, PS + */ + addi sp, sp, -16 + s32i a2, sp, 8 + s32i a3, sp, 12 + #else /* Windowed ABI */ + /* + Save necessary context and spill the register windows. + PS.EXCM is still set and must remain set until after the spill. + Reuse context save function though it saves more than necessary. + For this reason, a full interrupt stack frame is allocated. + */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + #endif + + /* + Grab the interruptee's PC and skip over the 'syscall' instruction. + If it's at the end of a zero-overhead loop and it's not on the last + iteration, decrement loop counter and skip to beginning of loop. + */ + rsr a2, EPC_1 /* a2 = PC of 'syscall' */ + addi a3, a2, 3 /* ++PC */ + #if XCHAL_HAVE_LOOPS + rsr a0, LEND /* if (PC == LEND */ + bne a3, a0, 1f + rsr a0, LCOUNT /* && LCOUNT != 0) */ + beqz a0, 1f /* { */ + addi a0, a0, -1 /* --LCOUNT */ + rsr a3, LBEG /* PC = LBEG */ + wsr a0, LCOUNT /* } */ + #endif +1: wsr a3, EPC_1 /* update PC */ + + /* Restore interruptee's context and return from exception. */ + #ifdef __XTENSA_CALL0_ABI__ + l32i a2, sp, 8 + l32i a3, sp, 12 + addi sp, sp, 16 + #else + call0 _xt_context_restore + addi sp, sp, XT_STK_FRMSZ + #endif + movi a0, -1 + movnez a2, a0, a2 /* return -1 if not syscall 0 */ + rsr a0, EXCSAVE_1 + rfe + +/* +-------------------------------------------------------------------------------- +Co-Processor Exception Handler (jumped to from User Exception Handler). +These exceptions are generated by co-processor instructions, which are only +allowed in thread code (not in interrupts or kernel code). This restriction is +deliberately imposed to reduce the burden of state-save/restore in interrupts. +-------------------------------------------------------------------------------- +*/ +#if XCHAL_CP_NUM > 0 + + .section .rodata, "a" + +/* Offset to CP n save area in thread's CP save area. */ + .global _xt_coproc_sa_offset + .type _xt_coproc_sa_offset,@object + .align 16 /* minimize crossing cache boundaries */ +_xt_coproc_sa_offset: + .word XT_CP0_SA, XT_CP1_SA, XT_CP2_SA, XT_CP3_SA + .word XT_CP4_SA, XT_CP5_SA, XT_CP6_SA, XT_CP7_SA + +/* Bitmask for CP n's CPENABLE bit. */ + .type _xt_coproc_mask,@object + .align 16,,8 /* try to keep it all in one cache line */ + .set i, 0 +_xt_coproc_mask: + .rept XCHAL_CP_MAX + .long (i<<16) | (1<= 2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_medint2 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_medint2,@function + .align 4 +_xt_medint2: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_2 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_2 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_2 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint2_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(2) | PS_UM + #else + movi a0, PS_INTLEVEL(2) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 2 XCHAL_INTLEVEL2_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint2_exit + .type _xt_medint2_exit,@function + .align 4 +_xt_medint2_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_2 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_2 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_EXCM_LEVEL >= 3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_medint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_medint3,@function + .align 4 +_xt_medint3: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_3 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_3 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_3 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint3_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(3) | PS_UM + #else + movi a0, PS_INTLEVEL(3) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 3 XCHAL_INTLEVEL3_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint3_exit + .type _xt_medint3_exit,@function + .align 4 +_xt_medint3_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_3 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_3 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_EXCM_LEVEL >= 4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_medint4 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint4,@function + .align 4 +_xt_medint4: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_4 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_4 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_4 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint4_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(4) | PS_UM + #else + movi a0, PS_INTLEVEL(4) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 4 XCHAL_INTLEVEL4_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint4_exit + .type _xt_medint4_exit,@function + .align 4 +_xt_medint4_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_4 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_4 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_EXCM_LEVEL >= 5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_medint5 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint5,@function + .align 4 +_xt_medint5: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_5 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_5 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_5 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint5_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(5) | PS_UM + #else + movi a0, PS_INTLEVEL(5) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 5 XCHAL_INTLEVEL5_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint5_exit + .type _xt_medint5_exit,@function + .align 4 +_xt_medint5_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_5 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_5 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_EXCM_LEVEL >= 6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_medint6 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint6,@function + .align 4 +_xt_medint6: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_6 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_6 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_6 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint6_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(6) | PS_UM + #else + movi a0, PS_INTLEVEL(6) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 6 XCHAL_INTLEVEL6_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint6_exit + .type _xt_medint6_exit,@function + .align 4 +_xt_medint6_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_6 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_6 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 6 + +#endif /* Level 6 */ + + +/******************************************************************************* + +HIGH PRIORITY (LEVEL > XCHAL_EXCM_LEVEL) INTERRUPT VECTORS AND HANDLERS + +High priority interrupts are by definition those with priorities greater +than XCHAL_EXCM_LEVEL. This includes non-maskable (NMI). High priority +interrupts cannot interact with the RTOS, that is they must save all regs +they use and not call any RTOS function. + +A further restriction imposed by the Xtensa windowed architecture is that +high priority interrupts must not modify the stack area even logically +"above" the top of the interrupted stack (they need to provide their +own stack or static save area). + +Cadence Design Systems recommends high priority interrupt handlers be coded in assembly +and used for purposes requiring very short service times. + +Here are templates for high priority (level 2+) interrupt vectors. +They assume only one interrupt per level to avoid the burden of identifying +which interrupts at this level are pending and enabled. This allows for +minimum latency and avoids having to save/restore a2 in addition to a0. +If more than one interrupt per high priority level is configured, this burden +is on the handler which in any case must provide a way to save and restore +registers it uses without touching the interrupted stack. + +Each vector goes at a predetermined location according to the Xtensa +hardware configuration, which is ensured by its placement in a special +section known to the Xtensa linker support package (LSP). It performs +the minimum necessary before jumping to the handler in the .text section. + +*******************************************************************************/ + +/* +Currently only shells for high priority interrupt handlers are provided +here. However a template and example can be found in the Cadence Design Systems tools +documentation: "Microprocessor Programmer's Guide". +*/ + +#if XCHAL_NUM_INTLEVELS >=2 && XCHAL_EXCM_LEVEL <2 && XCHAL_DEBUGLEVEL !=2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_highint2 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_highint2,@function + .align 4 +_xt_highint2: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 2<<2 + beqz a0, 1f +.Ln_xt_highint2_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 2 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint2_exit: + rsr a0, EXCSAVE_2 /* restore a0 */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_NUM_INTLEVELS >=3 && XCHAL_EXCM_LEVEL <3 && XCHAL_DEBUGLEVEL !=3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_highint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint3,@function + .align 4 +_xt_highint3: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 3<<2 + beqz a0, 1f +.Ln_xt_highint3_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 3 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint3_exit: + rsr a0, EXCSAVE_3 /* restore a0 */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_NUM_INTLEVELS >=4 && XCHAL_EXCM_LEVEL <4 && XCHAL_DEBUGLEVEL !=4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_highint4 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint4,@function + .align 4 +_xt_highint4: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 4<<2 + beqz a0, 1f +.Ln_xt_highint4_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 4 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint4_exit: + rsr a0, EXCSAVE_4 /* restore a0 */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_NUM_INTLEVELS >=5 && XCHAL_EXCM_LEVEL <5 && XCHAL_DEBUGLEVEL !=5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_highint5 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint5,@function + .align 4 +_xt_highint5: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 5<<2 + beqz a0, 1f +.Ln_xt_highint5_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 5 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint5_exit: + rsr a0, EXCSAVE_5 /* restore a0 */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_NUM_INTLEVELS >=6 && XCHAL_EXCM_LEVEL <6 && XCHAL_DEBUGLEVEL !=6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_highint6 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint6,@function + .align 4 +_xt_highint6: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 6<<2 + beqz a0, 1f +.Ln_xt_highint6_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 6 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint6_exit: + rsr a0, EXCSAVE_6 /* restore a0 */ + rfi 6 + +#endif /* Level 6 */ + +#if XCHAL_HAVE_NMI + + .begin literal_prefix .NMIExceptionVector + .section .NMIExceptionVector.text, "ax" + .global _NMIExceptionVector + .type _NMIExceptionVector,@function + .align 4 +_NMIExceptionVector: + wsr a0, EXCSAVE + XCHAL_NMILEVEL _ /* preserve a0 */ + call0 _xt_nmi /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_nmi,@function + .align 4 +_xt_nmi: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, XCHAL_NMILEVEL<<2 + beqz a0, 1f +.Ln_xt_nmi_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY NON-MASKABLE INTERRUPT (NMI) HANDLER CODE HERE. + */ + + .align 4 +.L_xt_nmi_exit: + rsr a0, EXCSAVE + XCHAL_NMILEVEL /* restore a0 */ + rfi XCHAL_NMILEVEL + +#endif /* NMI */ + + +/******************************************************************************* + +WINDOW OVERFLOW AND UNDERFLOW EXCEPTION VECTORS AND ALLOCA EXCEPTION HANDLER + +Here is the code for each window overflow/underflow exception vector and +(interspersed) efficient code for handling the alloca exception cause. +Window exceptions are handled entirely in the vector area and are very +tight for performance. The alloca exception is also handled entirely in +the window vector area so comes at essentially no cost in code size. +Users should never need to modify them and Cadence Design Systems recommends +they do not. + +Window handlers go at predetermined vector locations according to the +Xtensa hardware configuration, which is ensured by their placement in a +special section known to the Xtensa linker support package (LSP). Since +their offsets in that section are always the same, the LSPs do not define +a section per vector. + +These things are coded for XEA2 only (XEA1 is not supported). + +Note on Underflow Handlers: +The underflow handler for returning from call[i+1] to call[i] +must preserve all the registers from call[i+1]'s window. +In particular, a0 and a1 must be preserved because the RETW instruction +will be reexecuted (and may even underflow if an intervening exception +has flushed call[i]'s registers). +Registers a2 and up may contain return values. + +*******************************************************************************/ + +#if XCHAL_HAVE_WINDOWED + + .section .WindowVectors.text, "ax" + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call4. + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call4 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a3 are registers to be saved; + a4-a15 must be preserved; + a5 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x0 + .global _WindowOverflow4 +_WindowOverflow4: + + s32e a0, a5, -16 /* save a0 to call[j+1]'s stack frame */ + s32e a1, a5, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a5, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a5, -4 /* save a3 to call[j+1]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call4 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call4 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a3 are undefined, must be reloaded with call[i].reg[0..3]; + a4-a15 must be preserved (they are call[i+1].reg[0..11]); + a5 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x40 + .global _WindowUnderflow4 +_WindowUnderflow4: + + l32e a0, a5, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a5, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a5, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a3, a5, -4 /* restore a3 from call[i+1]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Handle alloca exception generated by interruptee executing 'movsp'. +This uses space between the window vectors, so is essentially "free". +All interruptee's regs are intact except a0 which is saved in EXCSAVE_1, +and PS.EXCM has been set by the exception hardware (can't be interrupted). +The fact the alloca exception was taken means the registers associated with +the base-save area have been spilled and will be restored by the underflow +handler, so those 4 registers are available for scratch. +The code is optimized to avoid unaligned branches and minimize cache misses. +-------------------------------------------------------------------------------- +*/ + + .align 4 + .global _xt_alloca_exc +_xt_alloca_exc: + + rsr a0, WINDOWBASE /* grab WINDOWBASE before rotw changes it */ + rotw -1 /* WINDOWBASE goes to a4, new a0-a3 are scratch */ + rsr a2, PS + extui a3, a2, XCHAL_PS_OWB_SHIFT, XCHAL_PS_OWB_BITS + xor a3, a3, a4 /* bits changed from old to current windowbase */ + rsr a4, EXCSAVE_1 /* restore original a0 (now in a4) */ + slli a3, a3, XCHAL_PS_OWB_SHIFT + xor a2, a2, a3 /* flip changed bits in old window base */ + wsr a2, PS /* update PS.OWB to new window base */ + rsync + + _bbci.l a4, 31, _WindowUnderflow4 + rotw -1 /* original a0 goes to a8 */ + _bbci.l a8, 30, _WindowUnderflow8 + rotw -1 + j _WindowUnderflow12 + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call8 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call8 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a7 are registers to be saved; + a8-a15 must be preserved; + a9 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x80 + .global _WindowOverflow8 +_WindowOverflow8: + + s32e a0, a9, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a9, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a9, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a9, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -32 /* save a4 to call[j]'s stack frame */ + s32e a5, a0, -28 /* save a5 to call[j]'s stack frame */ + s32e a6, a0, -24 /* save a6 to call[j]'s stack frame */ + s32e a7, a0, -20 /* save a7 to call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call8 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call8 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a7 are undefined, must be reloaded with call[i].reg[0..7]; + a8-a15 must be preserved (they are call[i+1].reg[0..7]); + a9 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0xC0 + .global _WindowUnderflow8 +_WindowUnderflow8: + + l32e a0, a9, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a9, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a9, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a7, a1, -12 /* a7 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a9, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a7, -32 /* restore a4 from call[i]'s stack frame */ + l32e a5, a7, -28 /* restore a5 from call[i]'s stack frame */ + l32e a6, a7, -24 /* restore a6 from call[i]'s stack frame */ + l32e a7, a7, -20 /* restore a7 from call[i]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call12 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call12 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a11 are registers to be saved; + a12-a15 must be preserved; + a13 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x100 + .global _WindowOverflow12 +_WindowOverflow12: + + s32e a0, a13, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a13, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a13, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a13, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -48 /* save a4 to end of call[j]'s stack frame */ + s32e a5, a0, -44 /* save a5 to end of call[j]'s stack frame */ + s32e a6, a0, -40 /* save a6 to end of call[j]'s stack frame */ + s32e a7, a0, -36 /* save a7 to end of call[j]'s stack frame */ + s32e a8, a0, -32 /* save a8 to end of call[j]'s stack frame */ + s32e a9, a0, -28 /* save a9 to end of call[j]'s stack frame */ + s32e a10, a0, -24 /* save a10 to end of call[j]'s stack frame */ + s32e a11, a0, -20 /* save a11 to end of call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call12 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call12 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a11 are undefined, must be reloaded with call[i].reg[0..11]; + a12-a15 must be preserved (they are call[i+1].reg[0..3]); + a13 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x140 + .global _WindowUnderflow12 +_WindowUnderflow12: + + l32e a0, a13, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a13, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a13, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a11, a1, -12 /* a11 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a13, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a11, -48 /* restore a4 from end of call[i]'s stack frame */ + l32e a5, a11, -44 /* restore a5 from end of call[i]'s stack frame */ + l32e a6, a11, -40 /* restore a6 from end of call[i]'s stack frame */ + l32e a7, a11, -36 /* restore a7 from end of call[i]'s stack frame */ + l32e a8, a11, -32 /* restore a8 from end of call[i]'s stack frame */ + l32e a9, a11, -28 /* restore a9 from end of call[i]'s stack frame */ + l32e a10, a11, -24 /* restore a10 from end of call[i]'s stack frame */ + l32e a11, a11, -20 /* restore a11 from end of call[i]'s stack frame */ + rfwu + +#endif /* XCHAL_HAVE_WINDOWED */ + + .section .UserEnter.text, "ax" + .global call_user_start + .type call_user_start,@function + .align 4 + .literal_position + + +call_user_start: + + movi a2, 0x40040000 /* note: absolute symbol, not a ptr */ + wsr a2, vecbase + call0 user_start /* user exception handler */ diff --git a/components/freertos/xtensa_vectors.S-old b/components/freertos/xtensa_vectors.S-old new file mode 100644 index 000000000..2d0f7a99d --- /dev/null +++ b/components/freertos/xtensa_vectors.S-old @@ -0,0 +1,2064 @@ +/******************************************************************************* +Copyright (c) 2006-2015 Cadence Design Systems Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------------------- + + XTENSA VECTORS AND LOW LEVEL HANDLERS FOR AN RTOS + + Xtensa low level exception and interrupt vectors and handlers for an RTOS. + + Interrupt handlers and user exception handlers support interaction with + the RTOS by calling XT_RTOS_INT_ENTER and XT_RTOS_INT_EXIT before and + after user's specific interrupt handlers. These macros are defined in + xtensa_.h to call suitable functions in a specific RTOS. + + Users can install application-specific interrupt handlers for low and + medium level interrupts, by calling xt_set_interrupt_handler(). These + handlers can be written in C, and must obey C calling convention. The + handler table is indexed by the interrupt number. Each handler may be + provided with an argument. + + Note that the system timer interrupt is handled specially, and is + dispatched to the RTOS-specific handler. This timer cannot be hooked + by application code. + + Optional hooks are also provided to install a handler per level at + run-time, made available by compiling this source file with + '-DXT_INTEXC_HOOKS' (useful for automated testing). + +!! This file is a template that usually needs to be modified to handle !! +!! application specific interrupts. Search USER_EDIT for helpful comments !! +!! on where to insert handlers and how to write them. !! + + Users can also install application-specific exception handlers in the + same way, by calling xt_set_exception_handler(). One handler slot is + provided for each exception type. Note that some exceptions are handled + by the porting layer itself, and cannot be taken over by application + code in this manner. These are the alloca, syscall, and coprocessor + exceptions. + + The exception handlers can be written in C, and must follow C calling + convention. Each handler is passed a pointer to an exception frame as + its single argument. The exception frame is created on the stack, and + holds the saved context of the thread that took the exception. If the + handler returns, the context will be restored and the instruction that + caused the exception will be retried. If the handler makes any changes + to the saved state in the exception frame, the changes will be applied + when restoring the context. + + Because Xtensa is a configurable architecture, this port supports all user + generated configurations (except restrictions stated in the release notes). + This is accomplished by conditional compilation using macros and functions + defined in the Xtensa HAL (hardware adaptation layer) for your configuration. + Only the relevant parts of this file will be included in your RTOS build. + For example, this file provides interrupt vector templates for all types and + all priority levels, but only the ones in your configuration are built. + + NOTES on the use of 'call0' for long jumps instead of 'j': + 1. This file should be assembled with the -mlongcalls option to xt-xcc. + 2. The -mlongcalls compiler option causes 'call0 dest' to be expanded to + a sequence 'l32r a0, dest' 'callx0 a0' which works regardless of the + distance from the call to the destination. The linker then relaxes + it back to 'call0 dest' if it determines that dest is within range. + This allows more flexibility in locating code without the performance + overhead of the 'l32r' literal data load in cases where the destination + is in range of 'call0'. There is an additional benefit in that 'call0' + has a longer range than 'j' due to the target being word-aligned, so + the 'l32r' sequence is less likely needed. + 3. The use of 'call0' with -mlongcalls requires that register a0 not be + live at the time of the call, which is always the case for a function + call but needs to be ensured if 'call0' is used as a jump in lieu of 'j'. + 4. This use of 'call0' is independent of the C function call ABI. + +*******************************************************************************/ + +#include "xtensa_rtos.h" + + +/* Enable stack backtrace across exception/interrupt - see below */ +#define XT_DEBUG_BACKTRACE 0 + + +/* +-------------------------------------------------------------------------------- + Defines used to access _xtos_interrupt_table. +-------------------------------------------------------------------------------- +*/ +#define XIE_HANDLER 0 +#define XIE_ARG 4 +#define XIE_SIZE 8 + +/* +-------------------------------------------------------------------------------- + Macro extract_msb - return the input with only the highest bit set. + + Input : "ain" - Input value, clobbered. + Output : "aout" - Output value, has only one bit set, MSB of "ain". + The two arguments must be different AR registers. +-------------------------------------------------------------------------------- +*/ + + .macro extract_msb aout ain +1: + addi \aout, \ain, -1 /* aout = ain - 1 */ + and \ain, \ain, \aout /* ain = ain & aout */ + bnez \ain, 1b /* repeat until ain == 0 */ + addi \aout, \aout, 1 /* return aout + 1 */ + .endm + +/* +-------------------------------------------------------------------------------- + Macro dispatch_c_isr - dispatch interrupts to user ISRs. + This will dispatch to user handlers (if any) that are registered in the + XTOS dispatch table (_xtos_interrupt_table). These handlers would have + been registered by calling _xtos_set_interrupt_handler(). There is one + exception - the timer interrupt used by the OS will not be dispatched + to a user handler - this must be handled by the caller of this macro. + + Level triggered and software interrupts are automatically deasserted by + this code. + + ASSUMPTIONS: + -- PS.INTLEVEL is set to "level" at entry + -- PS.EXCM = 0, C calling enabled + + NOTE: For CALL0 ABI, a12-a15 have not yet been saved. + + NOTE: This macro will use registers a0 and a2-a6. The arguments are: + level -- interrupt level + mask -- interrupt bitmask for this level +-------------------------------------------------------------------------------- +*/ + + .macro dispatch_c_isr level mask + + /* Get mask of pending, enabled interrupts at this level into a2. */ + +.L_xt_user_int_&level&: + rsr a2, INTENABLE + rsr a3, INTERRUPT + movi a4, \mask + and a2, a2, a3 + and a2, a2, a4 + beqz a2, 9f /* nothing to do */ + + /* This bit of code provides a nice debug backtrace in the debugger. + It does take a few more instructions, so undef XT_DEBUG_BACKTRACE + if you want to save the cycles. + */ + #if XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 + \level - 1 /* return address */ + movi a4, 0xC0000000 /* constant with top 2 bits set (call size) */ + or a0, a0, a4 /* set top 2 bits */ + addx2 a0, a4, a0 /* clear top bit -- simulating call4 size */ + #endif + #endif + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a4, _xt_intexc_hooks + l32i a4, a4, \level << 2 + beqz a4, 2f + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqz a2, 9f + #else + mov a6, a2 + callx4 a4 + beqz a6, 9f + mov a2, a6 + #endif +2: + #endif + + /* Now look up in the dispatch table and call user ISR if any. */ + /* If multiple bits are set then MSB has highest priority. */ + + extract_msb a4, a2 /* a4 = MSB of a2, a2 trashed */ + + #ifdef XT_USE_SWPRI + /* Enable all interrupts at this level that are numerically higher + than the one we just selected, since they are treated as higher + priority. + */ + movi a3, \mask /* a3 = all interrupts at this level */ + add a2, a4, a4 /* a2 = a4 << 1 */ + addi a2, a2, -1 /* a2 = mask of 1's <= a4 bit */ + and a2, a2, a3 /* a2 = mask of all bits <= a4 at this level */ + movi a3, _xt_intdata + l32i a6, a3, 4 /* a6 = _xt_vpri_mask */ + neg a2, a2 + addi a2, a2, -1 /* a2 = mask to apply */ + and a5, a6, a2 /* mask off all bits <= a4 bit */ + s32i a5, a3, 4 /* update _xt_vpri_mask */ + rsr a3, INTENABLE + and a3, a3, a2 /* mask off all bits <= a4 bit */ + wsr a3, INTENABLE + rsil a3, \level - 1 /* lower interrupt level by 1 */ + #endif + + movi a3, XT_TIMER_INTEN /* a3 = timer interrupt bit */ + wsr a4, INTCLEAR /* clear sw or edge-triggered interrupt */ + beq a3, a4, 7f /* if timer interrupt then skip table */ + + find_ms_setbit a3, a4, a3, 0 /* a3 = interrupt number */ + + movi a4, _xt_interrupt_table + addx8 a3, a3, a4 /* a3 = address of interrupt table entry */ + l32i a4, a3, XIE_HANDLER /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 /* save in callee-saved reg */ + l32i a2, a3, XIE_ARG /* a2 = handler arg */ + callx0 a4 /* call handler */ + mov a2, a12 + #else + mov a2, a6 /* save in windowed reg */ + l32i a6, a3, XIE_ARG /* a6 = handler arg */ + callx4 a4 /* call handler */ + #endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + +7: + + .ifeq XT_TIMER_INTPRI - \level +.L_xt_user_int_timer_&level&: + /* + Interrupt handler for the RTOS tick timer if at this level. + We'll be reading the interrupt state again after this call + so no need to preserve any registers except a6 (vpri_mask). + */ + + #ifdef __XTENSA_CALL0_ABI__ + mov a12, a6 + call0 XT_RTOS_TIMER_INT + mov a2, a12 + #else + mov a2, a6 + call4 XT_RTOS_TIMER_INT + #endif + .endif + + #ifdef XT_USE_SWPRI + j 8f + #else + j .L_xt_user_int_&level& /* check for more interrupts */ + #endif + + #ifdef XT_USE_SWPRI +8: + /* Restore old value of _xt_vpri_mask from a2. Also update INTENABLE from + virtual _xt_intenable which _could_ have changed during interrupt + processing. */ + + movi a3, _xt_intdata + l32i a4, a3, 0 /* a4 = _xt_intenable */ + s32i a2, a3, 4 /* update _xt_vpri_mask */ + and a4, a4, a2 /* a4 = masked intenable */ + wsr a4, INTENABLE /* update INTENABLE */ + #endif + +9: + /* done */ + + .endm + + +/* +-------------------------------------------------------------------------------- + Panic handler. + Should be reached by call0 (preferable) or jump only. If call0, a0 says where + from. If on simulator, display panic message and abort, else loop indefinitely. +-------------------------------------------------------------------------------- +*/ + + .text + .global panicHandlerRegs + .global panicHandler + .global panicStack + + .global _xt_panic + .type _xt_panic,@function + .align 4 + +_xt_panic: + //ToDo: save registers + movi a2, panicHandlerRegs + s32i a0,a2,0 + s32i a1,a2,4 + s32i a2,a2,8 + s32i a3,a2,12 + s32i a4,a2,16 + s32i a5,a2,20 + s32i a6,a2,24 + s32i a7,a2,28 + s32i a8,a2,32 + s32i a9,a2,36 + s32i a10,a2,40 + s32i a11,a2,44 + s32i a12,a2,48 + s32i a13,a2,52 + s32i a14,a2,56 + s32i a15,a2,60 + + rsr a3, EXCSAVE + s32i a3,a2,64 + rsr a3, EXCSAVE+1 + s32i a3,a2,68 + rsr a3, EXCSAVE+2 + s32i a3,a2,72 + rsr a3, EXCSAVE+3 + s32i a3,a2,76 + rsr a3, EXCSAVE+4 + s32i a3,a2,80 + rsr a3, EXCSAVE+5 + s32i a3,a2,84 + rsr a3, EXCSAVE+6 + s32i a3,a2,88 + rsr a3, EXCSAVE+7 + s32i a3,a2,92 + + rsr a3, EPC + s32i a3,a2,96 + rsr a3, EPC+1 + s32i a3,a2,100 + rsr a3, EPC+2 + s32i a3,a2,104 + rsr a3, EPC+3 + s32i a3,a2,108 + rsr a3, EPC+4 + s32i a3,a2,112 + rsr a3, EPC+5 + s32i a3,a2,116 + rsr a3, EPC+6 + s32i a3,a2,120 + rsr a3, EPC+7 + s32i a3,a2,124 + + rsr a3, DEPC + s32i a3,a2,128 + rsr a3, EXCVADDR + s32i a3,a2,132 + + //Reset window start / base to 0 + movi a2, 1 + wsr a2, windowstart + movi a2, 0 + wsr a2, windowbase + rsync + + //Clear EXCM, set WOE flags + rsr a2, ps + movi a3, ~(PS_EXCM_MASK) + and a2, a2, a3 + movi a3, PS_WOE_MASK + or a2, a2, a3 + wsr a2, ps + rsync + + //Switch to private stack + movi a1,panicStack+(255*4) + rsil a2, XCHAL_EXCM_LEVEL /* disable all low & med ints */ + + + // Debug: output '!' on serport + movi a2,0x60000000 + movi a3,'!' + s32i a3,a2,0 + + movi a3, panicHandlerRegs + l32i a2,a3,0 + call0 panic_print_hex + rsr a2, EXCCAUSE + call0 panic_print_hex + rsr a2, EXCVADDR + call0 panic_print_hex + rsr a2,EPC+1 + call0 panic_print_hex + rsr a2,EPC+2 + call0 panic_print_hex + rsr a2,EPC+3 + call0 panic_print_hex + rsr a2,EPC+6 + call0 panic_print_hex + rsr a2,EXCSAVE_1 + call0 panic_print_hex + rsr a2,DEPC + call0 panic_print_hex + + //Call panic handler +// movi a4, panicHandler +// callx4 a4 + call4 panicHandler + + movi a2,0x60000000 + movi a3,'d' + s32i a3,a2,0 + + +1: j 1b /* loop infinitely */ + + .align 4 +panicHandlerz: + entry a1,32 + movi a2,0x60000000 + movi a3,'h' + memw + s32i a3,a2,0 + + retw + + + .align 4 +//Call using call0. Prints the hex char in a2. Kills a3, a4, a5 +panic_print_hex: + movi a3,0x60000000 + movi a4,8 +panic_print_hex_loop: + l32i a5, a3, 0x1c + extui a5, a5, 16, 8 + bgei a5,64,panic_print_hex_loop + + srli a5,a2,28 + bgei a5,10,panic_print_hex_a + addi a5,a5,'0' + j panic_print_hex_ok +panic_print_hex_a: + addi a5,a5,'A'-10 +panic_print_hex_ok: + s32i a5,a3,0 + slli a2,a2,4 + + addi a4,a4,-1 + bnei a4,0,panic_print_hex_loop + movi a5,' ' + s32i a5,a3,0 + + ret + + + + .section .rodata, "a" + .align 4 + + + +/* +-------------------------------------------------------------------------------- + Hooks to dynamically install handlers for exceptions and interrupts. + Allows automated regression frameworks to install handlers per test. + Consists of an array of function pointers indexed by interrupt level, + with index 0 containing the entry for user exceptions. + Initialized with all 0s, meaning no handler is installed at each level. + See comment in xtensa_rtos.h for more details. +-------------------------------------------------------------------------------- +*/ + + #ifdef XT_INTEXC_HOOKS + .data + .global _xt_intexc_hooks + .type _xt_intexc_hooks,@object + .align 4 + +_xt_intexc_hooks: + .fill XT_INTEXC_HOOK_NUM, 4, 0 + #endif + + +/* +-------------------------------------------------------------------------------- + EXCEPTION AND LEVEL 1 INTERRUPT VECTORS AND LOW LEVEL HANDLERS + (except window exception vectors). + + Each vector goes at a predetermined location according to the Xtensa + hardware configuration, which is ensured by its placement in a special + section known to the Xtensa linker support package (LSP). It performs + the minimum necessary before jumping to the handler in the .text section. + + The corresponding handler goes in the normal .text section. It sets up + the appropriate stack frame, saves a few vector-specific registers and + calls XT_RTOS_INT_ENTER to save the rest of the interrupted context + and enter the RTOS, then sets up a C environment. It then calls the + user's interrupt handler code (which may be coded in C) and finally + calls XT_RTOS_INT_EXIT to transfer control to the RTOS for scheduling. + + While XT_RTOS_INT_EXIT does not return directly to the interruptee, + eventually the RTOS scheduler will want to dispatch the interrupted + task or handler. The scheduler will return to the exit point that was + saved in the interrupt stack frame at XT_STK_EXIT. +-------------------------------------------------------------------------------- +*/ + + +/* +-------------------------------------------------------------------------------- +Debug Exception. +-------------------------------------------------------------------------------- +*/ + +#if XCHAL_HAVE_DEBUG + + .begin literal_prefix .DebugExceptionVector + .section .DebugExceptionVector.text, "ax" + .global _DebugExceptionVector + .align 4 + +_DebugExceptionVector: + + #ifdef XT_SIMULATOR + /* + In the simulator, let the debugger (if any) handle the debug exception, + or simply stop the simulation: + */ + wsr a2, EXCSAVE+XCHAL_DEBUGLEVEL /* save a2 where sim expects it */ + movi a2, SYS_gdb_enter_sktloop + simcall /* have ISS handle debug exc. */ + #elif 0 /* change condition to 1 to use the HAL minimal debug handler */ + wsr a3, EXCSAVE+XCHAL_DEBUGLEVEL + movi a3, xthal_debugexc_defhndlr_nw /* use default debug handler */ + jx a3 + #else + wsr a0, EXCSAVE+XCHAL_DEBUGLEVEL /* save original a0 somewhere */ + call0 _xt_panic /* does not return */ + rfi XCHAL_DEBUGLEVEL /* make a0 point here not later */ + #endif + + .end literal_prefix + +#endif + +/* +-------------------------------------------------------------------------------- +Double Exception. +Double exceptions are not a normal occurrence. They indicate a bug of some kind. +-------------------------------------------------------------------------------- +*/ + +#ifdef XCHAL_DOUBLEEXC_VECTOR_VADDR + + .begin literal_prefix .DoubleExceptionVector + .section .DoubleExceptionVector.text, "ax" + .global _DoubleExceptionVector + .align 4 + +_DoubleExceptionVector: + + #if XCHAL_HAVE_DEBUG + break 1, 4 /* unhandled double exception */ + #endif + call0 _xt_panic /* does not return */ + rfde /* make a0 point here not later */ + + .end literal_prefix + +#endif /* XCHAL_DOUBLEEXC_VECTOR_VADDR */ + +/* +-------------------------------------------------------------------------------- +Kernel Exception (including Level 1 Interrupt from kernel mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .KernelExceptionVector + .section .KernelExceptionVector.text, "ax" + .global _KernelExceptionVector + .align 4 + +_KernelExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_kernel_exc /* kernel exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .align 4 + +_xt_kernel_exc: + #if XCHAL_HAVE_DEBUG + break 1, 0 /* unhandled kernel exception */ + #endif + call0 _xt_panic /* does not return */ + rfe /* make a0 point here not there */ + + +/* +-------------------------------------------------------------------------------- +User Exception (including Level 1 Interrupt from user mode). +-------------------------------------------------------------------------------- +*/ + + .begin literal_prefix .UserExceptionVector + .section .UserExceptionVector.text, "ax" + .global _UserExceptionVector + .type _UserExceptionVector,@function + .align 4 + +_UserExceptionVector: + + wsr a0, EXCSAVE_1 /* preserve a0 */ + call0 _xt_user_exc /* user exception handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + +/* +-------------------------------------------------------------------------------- + Insert some waypoints for jumping beyond the signed 8-bit range of + conditional branch instructions, so the conditional branchces to specific + exception handlers are not taken in the mainline. Saves some cycles in the + mainline. +-------------------------------------------------------------------------------- +*/ + + .text + + #if XCHAL_HAVE_WINDOWED + .align 4 +_xt_to_alloca_exc: + call0 _xt_alloca_exc /* in window vectors section */ + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + .align 4 +_xt_to_syscall_exc: + call0 _xt_syscall_exc + /* never returns here - call0 is used as a jump (see note at top) */ + + #if XCHAL_CP_NUM > 0 + .align 4 +_xt_to_coproc_exc: + call0 _xt_coproc_exc + /* never returns here - call0 is used as a jump (see note at top) */ + #endif + + +/* +-------------------------------------------------------------------------------- + User exception handler. +-------------------------------------------------------------------------------- +*/ + + .type _xt_user_exc,@function + .align 4 + +_xt_user_exc: + + /* If level 1 interrupt then jump to the dispatcher */ + rsr a0, EXCCAUSE + beqi a0, EXCCAUSE_LEVEL1INTERRUPT, _xt_lowint1 + + /* Handle any coprocessor exceptions. Rely on the fact that exception + numbers above EXCCAUSE_CP0_DISABLED all relate to the coprocessors. + */ + #if XCHAL_CP_NUM > 0 + bgeui a0, EXCCAUSE_CP0_DISABLED, _xt_to_coproc_exc + #endif + + /* Handle alloca and syscall exceptions */ + #if XCHAL_HAVE_WINDOWED + beqi a0, EXCCAUSE_ALLOCA, _xt_to_alloca_exc + #endif + beqi a0, EXCCAUSE_SYSCALL, _xt_to_syscall_exc + + //HACK! No custom vector stuff, just call panic handler directly. ToDo: remove this when possible. -JD + call0 _xt_panic + + /* Handle all other exceptions. All can have user-defined handlers. */ + /* NOTE: we'll stay on the user stack for exception handling. */ + + /* Allocate exception frame and save minimal context. */ + mov a0, sp + addi sp, sp, -XT_STK_FRMSZ + s32i a0, sp, XT_STK_A1 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -12 /* for debug backtrace */ + #endif + rsr a0, PS /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_1 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_1 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + #if XCHAL_HAVE_WINDOWED + s32e a0, sp, -16 /* for debug backtrace */ + #endif + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + + /* Save exc cause and vaddr into exception frame */ + rsr a0, EXCCAUSE + s32i a0, sp, XT_STK_EXCCAUSE + rsr a0, EXCVADDR + s32i a0, sp, XT_STK_EXCVADDR + + /* Set up PS for C, reenable hi-pri interrupts, and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM + #else + movi a0, PS_INTLEVEL(XCHAL_EXCM_LEVEL) | PS_UM | PS_WOE + #endif + wsr a0, PS + + #ifdef XT_DEBUG_BACKTRACE + #ifndef __XTENSA_CALL0_ABI__ + rsr a0, EPC_1 /* return address for debug backtrace */ + movi a5, 0xC0000000 /* constant with top 2 bits set (call size) */ + rsync /* wait for WSR.PS to complete */ + or a0, a0, a5 /* set top 2 bits */ + addx2 a0, a5, a0 /* clear top bit -- thus simulating call4 size */ + #else + rsync /* wait for WSR.PS to complete */ + #endif + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + + #ifdef XT_INTEXC_HOOKS + /* + Call exception hook to pre-handle exceptions (if installed). + Pass EXCCAUSE in a2, and check result in a2 (if -1, skip default handling). + */ + movi a4, _xt_intexc_hooks + l32i a4, a4, 0 /* user exception hook index 0 */ + beqz a4, 1f +.Ln_xt_user_exc_call_hook: + #ifdef __XTENSA_CALL0_ABI__ + callx0 a4 + beqi a2, -1, .L_xt_user_done + #else + mov a6, a2 + callx4 a4 + beqi a6, -1, .L_xt_user_done + mov a2, a6 + #endif +1: + #endif + + rsr a2, EXCCAUSE /* recover exc cause */ + movi a3, _xt_exception_table + addx4 a4, a2, a3 /* a4 = address of exception table entry */ + l32i a4, a4, 0 /* a4 = handler address */ + #ifdef __XTENSA_CALL0_ABI__ + mov a2, sp /* a2 = pointer to exc frame */ + callx0 a4 /* call handler */ + #else + mov a6, sp /* a6 = pointer to exc frame */ + callx4 a4 /* call handler */ + #endif + +.L_xt_user_done: + + /* Restore context and return */ + call0 _xt_context_restore + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove exception frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* +-------------------------------------------------------------------------------- + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. +-------------------------------------------------------------------------------- +*/ + + .global _xt_user_exit + .type _xt_user_exit,@function + .align 4 +_xt_user_exit: + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, PS + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_1 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure PS and EPC written */ + rfe /* PS.EXCM is cleared */ + + +/* +-------------------------------------------------------------------------------- +Syscall Exception Handler (jumped to from User Exception Handler). +Syscall 0 is required to spill the register windows (no-op in Call 0 ABI). +Only syscall 0 is handled here. Other syscalls return -1 to caller in a2. +-------------------------------------------------------------------------------- +*/ + + .text + .type _xt_syscall_exc,@function + .align 4 +_xt_syscall_exc: + + #ifdef __XTENSA_CALL0_ABI__ + /* + Save minimal regs for scratch. Syscall 0 does nothing in Call0 ABI. + Use a minimal stack frame (16B) to save A2 & A3 for scratch. + PS.EXCM could be cleared here, but unlikely to improve worst-case latency. + rsr a0, PS + addi a0, a0, -PS_EXCM_MASK + wsr a0, PS + */ + addi sp, sp, -16 + s32i a2, sp, 8 + s32i a3, sp, 12 + #else /* Windowed ABI */ + /* + Save necessary context and spill the register windows. + PS.EXCM is still set and must remain set until after the spill. + Reuse context save function though it saves more than necessary. + For this reason, a full interrupt stack frame is allocated. + */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a12, sp, XT_STK_A12 /* _xt_context_save requires A12- */ + s32i a13, sp, XT_STK_A13 /* A13 to have already been saved */ + call0 _xt_context_save + #endif + + /* + Grab the interruptee's PC and skip over the 'syscall' instruction. + If it's at the end of a zero-overhead loop and it's not on the last + iteration, decrement loop counter and skip to beginning of loop. + */ + rsr a2, EPC_1 /* a2 = PC of 'syscall' */ + addi a3, a2, 3 /* ++PC */ + #if XCHAL_HAVE_LOOPS + rsr a0, LEND /* if (PC == LEND */ + bne a3, a0, 1f + rsr a0, LCOUNT /* && LCOUNT != 0) */ + beqz a0, 1f /* { */ + addi a0, a0, -1 /* --LCOUNT */ + rsr a3, LBEG /* PC = LBEG */ + wsr a0, LCOUNT /* } */ + #endif +1: wsr a3, EPC_1 /* update PC */ + + /* Restore interruptee's context and return from exception. */ + #ifdef __XTENSA_CALL0_ABI__ + l32i a2, sp, 8 + l32i a3, sp, 12 + addi sp, sp, 16 + #else + call0 _xt_context_restore + addi sp, sp, XT_STK_FRMSZ + #endif + movi a0, -1 + movnez a2, a0, a2 /* return -1 if not syscall 0 */ + rsr a0, EXCSAVE_1 + rfe + +/* +-------------------------------------------------------------------------------- +Co-Processor Exception Handler (jumped to from User Exception Handler). +These exceptions are generated by co-processor instructions, which are only +allowed in thread code (not in interrupts or kernel code). This restriction is +deliberately imposed to reduce the burden of state-save/restore in interrupts. +-------------------------------------------------------------------------------- +*/ +#if XCHAL_CP_NUM > 0 + + .section .rodata, "a" + +/* Offset to CP n save area in thread's CP save area. */ + .global _xt_coproc_sa_offset + .type _xt_coproc_sa_offset,@object + .align 16 /* minimize crossing cache boundaries */ +_xt_coproc_sa_offset: + .word XT_CP0_SA, XT_CP1_SA, XT_CP2_SA, XT_CP3_SA + .word XT_CP4_SA, XT_CP5_SA, XT_CP6_SA, XT_CP7_SA + +/* Bitmask for CP n's CPENABLE bit. */ + .type _xt_coproc_mask,@object + .align 16,,8 /* try to keep it all in one cache line */ + .set i, 0 +_xt_coproc_mask: + .rept XCHAL_CP_MAX + .long (i<<16) | (1<= 2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_medint2 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_medint2,@function + .align 4 +_xt_medint2: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_2 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_2 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_2 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint2_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(2) | PS_UM + #else + movi a0, PS_INTLEVEL(2) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 2 XCHAL_INTLEVEL2_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint2_exit + .type _xt_medint2_exit,@function + .align 4 +_xt_medint2_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_2 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_2 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_EXCM_LEVEL >= 3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_medint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_medint3,@function + .align 4 +_xt_medint3: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_3 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_3 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_3 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint3_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(3) | PS_UM + #else + movi a0, PS_INTLEVEL(3) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 3 XCHAL_INTLEVEL3_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint3_exit + .type _xt_medint3_exit,@function + .align 4 +_xt_medint3_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_3 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_3 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_EXCM_LEVEL >= 4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_medint4 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint4,@function + .align 4 +_xt_medint4: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_4 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_4 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_4 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint4_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(4) | PS_UM + #else + movi a0, PS_INTLEVEL(4) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 4 XCHAL_INTLEVEL4_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint4_exit + .type _xt_medint4_exit,@function + .align 4 +_xt_medint4_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_4 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_4 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_EXCM_LEVEL >= 5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_medint5 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint5,@function + .align 4 +_xt_medint5: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_5 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_5 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_5 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint5_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(5) | PS_UM + #else + movi a0, PS_INTLEVEL(5) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 5 XCHAL_INTLEVEL5_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint5_exit + .type _xt_medint5_exit,@function + .align 4 +_xt_medint5_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_5 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_5 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_EXCM_LEVEL >= 6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_medint6 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_medint6,@function + .align 4 +_xt_medint6: + mov a0, sp /* sp == a1 */ + addi sp, sp, -XT_STK_FRMSZ /* allocate interrupt stack frame */ + s32i a0, sp, XT_STK_A1 /* save pre-interrupt SP */ + rsr a0, EPS_6 /* save interruptee's PS */ + s32i a0, sp, XT_STK_PS + rsr a0, EPC_6 /* save interruptee's PC */ + s32i a0, sp, XT_STK_PC + rsr a0, EXCSAVE_6 /* save interruptee's a0 */ + s32i a0, sp, XT_STK_A0 + movi a0, _xt_medint6_exit /* save exit point for dispatch */ + s32i a0, sp, XT_STK_EXIT + + /* Save rest of interrupt context and enter RTOS. */ + call0 XT_RTOS_INT_ENTER /* common RTOS interrupt entry */ + + /* !! We are now on the RTOS system stack !! */ + + /* Set up PS for C, enable interrupts above this level and clear EXCM. */ + #ifdef __XTENSA_CALL0_ABI__ + movi a0, PS_INTLEVEL(6) | PS_UM + #else + movi a0, PS_INTLEVEL(6) | PS_UM | PS_WOE + #endif + wsr a0, PS + rsync + + /* OK to call C code at this point, dispatch user ISRs */ + + dispatch_c_isr 6 XCHAL_INTLEVEL6_MASK + + /* Done handling interrupts, transfer control to OS */ + call0 XT_RTOS_INT_EXIT /* does not return directly here */ + + /* + Exit point for dispatch. Saved in interrupt stack frame at XT_STK_EXIT + on entry and used to return to a thread or interrupted interrupt handler. + */ + .global _xt_medint6_exit + .type _xt_medint6_exit,@function + .align 4 +_xt_medint6_exit: + /* Restore only level-specific regs (the rest were already restored) */ + l32i a0, sp, XT_STK_PS /* retrieve interruptee's PS */ + wsr a0, EPS_6 + l32i a0, sp, XT_STK_PC /* retrieve interruptee's PC */ + wsr a0, EPC_6 + l32i a0, sp, XT_STK_A0 /* retrieve interruptee's A0 */ + l32i sp, sp, XT_STK_A1 /* remove interrupt stack frame */ + rsync /* ensure EPS and EPC written */ + rfi 6 + +#endif /* Level 6 */ + + +/******************************************************************************* + +HIGH PRIORITY (LEVEL > XCHAL_EXCM_LEVEL) INTERRUPT VECTORS AND HANDLERS + +High priority interrupts are by definition those with priorities greater +than XCHAL_EXCM_LEVEL. This includes non-maskable (NMI). High priority +interrupts cannot interact with the RTOS, that is they must save all regs +they use and not call any RTOS function. + +A further restriction imposed by the Xtensa windowed architecture is that +high priority interrupts must not modify the stack area even logically +"above" the top of the interrupted stack (they need to provide their +own stack or static save area). + +Cadence Design Systems recommends high priority interrupt handlers be coded in assembly +and used for purposes requiring very short service times. + +Here are templates for high priority (level 2+) interrupt vectors. +They assume only one interrupt per level to avoid the burden of identifying +which interrupts at this level are pending and enabled. This allows for +minimum latency and avoids having to save/restore a2 in addition to a0. +If more than one interrupt per high priority level is configured, this burden +is on the handler which in any case must provide a way to save and restore +registers it uses without touching the interrupted stack. + +Each vector goes at a predetermined location according to the Xtensa +hardware configuration, which is ensured by its placement in a special +section known to the Xtensa linker support package (LSP). It performs +the minimum necessary before jumping to the handler in the .text section. + +*******************************************************************************/ + +/* +Currently only shells for high priority interrupt handlers are provided +here. However a template and example can be found in the Cadence Design Systems tools +documentation: "Microprocessor Programmer's Guide". +*/ + +#if XCHAL_NUM_INTLEVELS >=2 && XCHAL_EXCM_LEVEL <2 && XCHAL_DEBUGLEVEL !=2 + + .begin literal_prefix .Level2InterruptVector + .section .Level2InterruptVector.text, "ax" + .global _Level2Vector + .type _Level2Vector,@function + .align 4 +_Level2Vector: + wsr a0, EXCSAVE_2 /* preserve a0 */ + call0 _xt_highint2 /* load interrupt handler */ + + .end literal_prefix + + .text + .type _xt_highint2,@function + .align 4 +_xt_highint2: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 2<<2 + beqz a0, 1f +.Ln_xt_highint2_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 2 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint2_exit: + rsr a0, EXCSAVE_2 /* restore a0 */ + rfi 2 + +#endif /* Level 2 */ + +#if XCHAL_NUM_INTLEVELS >=3 && XCHAL_EXCM_LEVEL <3 && XCHAL_DEBUGLEVEL !=3 + + .begin literal_prefix .Level3InterruptVector + .section .Level3InterruptVector.text, "ax" + .global _Level3Vector + .type _Level3Vector,@function + .align 4 +_Level3Vector: + wsr a0, EXCSAVE_3 /* preserve a0 */ + call0 _xt_highint3 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint3,@function + .align 4 +_xt_highint3: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 3<<2 + beqz a0, 1f +.Ln_xt_highint3_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 3 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint3_exit: + rsr a0, EXCSAVE_3 /* restore a0 */ + rfi 3 + +#endif /* Level 3 */ + +#if XCHAL_NUM_INTLEVELS >=4 && XCHAL_EXCM_LEVEL <4 && XCHAL_DEBUGLEVEL !=4 + + .begin literal_prefix .Level4InterruptVector + .section .Level4InterruptVector.text, "ax" + .global _Level4Vector + .type _Level4Vector,@function + .align 4 +_Level4Vector: + wsr a0, EXCSAVE_4 /* preserve a0 */ + call0 _xt_highint4 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint4,@function + .align 4 +_xt_highint4: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 4<<2 + beqz a0, 1f +.Ln_xt_highint4_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 4 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint4_exit: + rsr a0, EXCSAVE_4 /* restore a0 */ + rfi 4 + +#endif /* Level 4 */ + +#if XCHAL_NUM_INTLEVELS >=5 && XCHAL_EXCM_LEVEL <5 && XCHAL_DEBUGLEVEL !=5 + + .begin literal_prefix .Level5InterruptVector + .section .Level5InterruptVector.text, "ax" + .global _Level5Vector + .type _Level5Vector,@function + .align 4 +_Level5Vector: + wsr a0, EXCSAVE_5 /* preserve a0 */ + call0 _xt_highint5 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint5,@function + .align 4 +_xt_highint5: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 5<<2 + beqz a0, 1f +.Ln_xt_highint5_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 5 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint5_exit: + rsr a0, EXCSAVE_5 /* restore a0 */ + rfi 5 + +#endif /* Level 5 */ + +#if XCHAL_NUM_INTLEVELS >=6 && XCHAL_EXCM_LEVEL <6 && XCHAL_DEBUGLEVEL !=6 + + .begin literal_prefix .Level6InterruptVector + .section .Level6InterruptVector.text, "ax" + .global _Level6Vector + .type _Level6Vector,@function + .align 4 +_Level6Vector: + wsr a0, EXCSAVE_6 /* preserve a0 */ + call0 _xt_highint6 /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_highint6,@function + .align 4 +_xt_highint6: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, 6<<2 + beqz a0, 1f +.Ln_xt_highint6_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY LEVEL 6 INTERRUPT HANDLER CODE HERE. + */ + + .align 4 +.L_xt_highint6_exit: + rsr a0, EXCSAVE_6 /* restore a0 */ + rfi 6 + +#endif /* Level 6 */ + +#if XCHAL_HAVE_NMI + + .begin literal_prefix .NMIExceptionVector + .section .NMIExceptionVector.text, "ax" + .global _NMIExceptionVector + .type _NMIExceptionVector,@function + .align 4 +_NMIExceptionVector: + wsr a0, EXCSAVE + XCHAL_NMILEVEL _ /* preserve a0 */ + call0 _xt_nmi /* load interrupt handler */ + /* never returns here - call0 is used as a jump (see note at top) */ + + .end literal_prefix + + .text + .type _xt_nmi,@function + .align 4 +_xt_nmi: + + #ifdef XT_INTEXC_HOOKS + /* Call interrupt hook if present to (pre)handle interrupts. */ + movi a0, _xt_intexc_hooks + l32i a0, a0, XCHAL_NMILEVEL<<2 + beqz a0, 1f +.Ln_xt_nmi_call_hook: + callx0 a0 /* must NOT disturb stack! */ +1: + #endif + + /* USER_EDIT: + ADD HIGH PRIORITY NON-MASKABLE INTERRUPT (NMI) HANDLER CODE HERE. + */ + + .align 4 +.L_xt_nmi_exit: + rsr a0, EXCSAVE + XCHAL_NMILEVEL /* restore a0 */ + rfi XCHAL_NMILEVEL + +#endif /* NMI */ + + +/******************************************************************************* + +WINDOW OVERFLOW AND UNDERFLOW EXCEPTION VECTORS AND ALLOCA EXCEPTION HANDLER + +Here is the code for each window overflow/underflow exception vector and +(interspersed) efficient code for handling the alloca exception cause. +Window exceptions are handled entirely in the vector area and are very +tight for performance. The alloca exception is also handled entirely in +the window vector area so comes at essentially no cost in code size. +Users should never need to modify them and Cadence Design Systems recommends +they do not. + +Window handlers go at predetermined vector locations according to the +Xtensa hardware configuration, which is ensured by their placement in a +special section known to the Xtensa linker support package (LSP). Since +their offsets in that section are always the same, the LSPs do not define +a section per vector. + +These things are coded for XEA2 only (XEA1 is not supported). + +Note on Underflow Handlers: +The underflow handler for returning from call[i+1] to call[i] +must preserve all the registers from call[i+1]'s window. +In particular, a0 and a1 must be preserved because the RETW instruction +will be reexecuted (and may even underflow if an intervening exception +has flushed call[i]'s registers). +Registers a2 and up may contain return values. + +*******************************************************************************/ + +#if XCHAL_HAVE_WINDOWED + + .section .WindowVectors.text, "ax" + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call4. + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call4 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a3 are registers to be saved; + a4-a15 must be preserved; + a5 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x0 + .global _WindowOverflow4 +_WindowOverflow4: + + s32e a0, a5, -16 /* save a0 to call[j+1]'s stack frame */ + s32e a1, a5, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a5, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a5, -4 /* save a3 to call[j+1]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call4 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call4 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a3 are undefined, must be reloaded with call[i].reg[0..3]; + a4-a15 must be preserved (they are call[i+1].reg[0..11]); + a5 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x40 + .global _WindowUnderflow4 +_WindowUnderflow4: + + l32e a0, a5, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a5, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a5, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a3, a5, -4 /* restore a3 from call[i+1]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Handle alloca exception generated by interruptee executing 'movsp'. +This uses space between the window vectors, so is essentially "free". +All interruptee's regs are intact except a0 which is saved in EXCSAVE_1, +and PS.EXCM has been set by the exception hardware (can't be interrupted). +The fact the alloca exception was taken means the registers associated with +the base-save area have been spilled and will be restored by the underflow +handler, so those 4 registers are available for scratch. +The code is optimized to avoid unaligned branches and minimize cache misses. +-------------------------------------------------------------------------------- +*/ + + .align 4 + .global _xt_alloca_exc +_xt_alloca_exc: + + rsr a0, WINDOWBASE /* grab WINDOWBASE before rotw changes it */ + rotw -1 /* WINDOWBASE goes to a4, new a0-a3 are scratch */ + rsr a2, PS + extui a3, a2, XCHAL_PS_OWB_SHIFT, XCHAL_PS_OWB_BITS + xor a3, a3, a4 /* bits changed from old to current windowbase */ + rsr a4, EXCSAVE_1 /* restore original a0 (now in a4) */ + slli a3, a3, XCHAL_PS_OWB_SHIFT + xor a2, a2, a3 /* flip changed bits in old window base */ + wsr a2, PS /* update PS.OWB to new window base */ + rsync + + _bbci.l a4, 31, _WindowUnderflow4 + rotw -1 /* original a0 goes to a8 */ + _bbci.l a8, 30, _WindowUnderflow8 + rotw -1 + j _WindowUnderflow12 + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call8 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call8 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a7 are registers to be saved; + a8-a15 must be preserved; + a9 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x80 + .global _WindowOverflow8 +_WindowOverflow8: + + s32e a0, a9, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a9, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a9, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a9, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -32 /* save a4 to call[j]'s stack frame */ + s32e a5, a0, -28 /* save a5 to call[j]'s stack frame */ + s32e a6, a0, -24 /* save a6 to call[j]'s stack frame */ + s32e a7, a0, -20 /* save a7 to call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call8 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call8 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a7 are undefined, must be reloaded with call[i].reg[0..7]; + a8-a15 must be preserved (they are call[i+1].reg[0..7]); + a9 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0xC0 + .global _WindowUnderflow8 +_WindowUnderflow8: + + l32e a0, a9, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a9, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a9, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a7, a1, -12 /* a7 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a9, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a7, -32 /* restore a4 from call[i]'s stack frame */ + l32e a5, a7, -28 /* restore a5 from call[i]'s stack frame */ + l32e a6, a7, -24 /* restore a6 from call[i]'s stack frame */ + l32e a7, a7, -20 /* restore a7 from call[i]'s stack frame */ + rfwu + +/* +-------------------------------------------------------------------------------- +Window Overflow Exception for Call12 + +Invoked if a call[i] referenced a register (a4-a15) +that contains data from ancestor call[j]; +call[j] had done a call12 to call[j+1]. +On entry here: + window rotated to call[j] start point; + a0-a11 are registers to be saved; + a12-a15 must be preserved; + a13 is call[j+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x100 + .global _WindowOverflow12 +_WindowOverflow12: + + s32e a0, a13, -16 /* save a0 to call[j+1]'s stack frame */ + l32e a0, a1, -12 /* a0 <- call[j-1]'s sp + (used to find end of call[j]'s frame) */ + s32e a1, a13, -12 /* save a1 to call[j+1]'s stack frame */ + s32e a2, a13, -8 /* save a2 to call[j+1]'s stack frame */ + s32e a3, a13, -4 /* save a3 to call[j+1]'s stack frame */ + s32e a4, a0, -48 /* save a4 to end of call[j]'s stack frame */ + s32e a5, a0, -44 /* save a5 to end of call[j]'s stack frame */ + s32e a6, a0, -40 /* save a6 to end of call[j]'s stack frame */ + s32e a7, a0, -36 /* save a7 to end of call[j]'s stack frame */ + s32e a8, a0, -32 /* save a8 to end of call[j]'s stack frame */ + s32e a9, a0, -28 /* save a9 to end of call[j]'s stack frame */ + s32e a10, a0, -24 /* save a10 to end of call[j]'s stack frame */ + s32e a11, a0, -20 /* save a11 to end of call[j]'s stack frame */ + rfwo /* rotates back to call[i] position */ + +/* +-------------------------------------------------------------------------------- +Window Underflow Exception for Call12 + +Invoked by RETW returning from call[i+1] to call[i] +where call[i]'s registers must be reloaded (not live in ARs); +where call[i] had done a call12 to call[i+1]. +On entry here: + window rotated to call[i] start point; + a0-a11 are undefined, must be reloaded with call[i].reg[0..11]; + a12-a15 must be preserved (they are call[i+1].reg[0..3]); + a13 is call[i+1]'s stack pointer. +-------------------------------------------------------------------------------- +*/ + + .org 0x140 + .global _WindowUnderflow12 +_WindowUnderflow12: + + l32e a0, a13, -16 /* restore a0 from call[i+1]'s stack frame */ + l32e a1, a13, -12 /* restore a1 from call[i+1]'s stack frame */ + l32e a2, a13, -8 /* restore a2 from call[i+1]'s stack frame */ + l32e a11, a1, -12 /* a11 <- call[i-1]'s sp + (used to find end of call[i]'s frame) */ + l32e a3, a13, -4 /* restore a3 from call[i+1]'s stack frame */ + l32e a4, a11, -48 /* restore a4 from end of call[i]'s stack frame */ + l32e a5, a11, -44 /* restore a5 from end of call[i]'s stack frame */ + l32e a6, a11, -40 /* restore a6 from end of call[i]'s stack frame */ + l32e a7, a11, -36 /* restore a7 from end of call[i]'s stack frame */ + l32e a8, a11, -32 /* restore a8 from end of call[i]'s stack frame */ + l32e a9, a11, -28 /* restore a9 from end of call[i]'s stack frame */ + l32e a10, a11, -24 /* restore a10 from end of call[i]'s stack frame */ + l32e a11, a11, -20 /* restore a11 from end of call[i]'s stack frame */ + rfwu + +#endif /* XCHAL_HAVE_WINDOWED */ + + .section .UserEnter.text, "ax" + .global call_user_start + .type call_user_start,@function + .align 4 + .literal_position + + +call_user_start: + + movi a2, 0x40040000 /* note: absolute symbol, not a ptr */ + wsr a2, vecbase + call0 user_start /* user exception handler */ diff --git a/components/lwip/CHANGELOG b/components/lwip/CHANGELOG new file mode 100755 index 000000000..21a85c94c --- /dev/null +++ b/components/lwip/CHANGELOG @@ -0,0 +1,4044 @@ +HISTORY + +(git master) + + * [Enter new changes just after this line - do not remove this line] + + ++ New features: + + 2016-02-22: Ivan Delamer: + * Initial 6LoWPAN support + + 2015-12-26: Martin Hentschel and Dirk Ziegelmeier + * Rewrite SNMP agent + + 2015-11-12: Dirk Ziegelmeier + * Decouple SNMP stack from lwIP core and move stack to apps/ directory. + Breaking change: Users have to call snmp_init() now! + + 2015-11-12: Dirk Ziegelmeier + * Implement possibility to declare private memory pools. This is useful to + decouple some apps from the core (SNMP stack) or make contrib app useage + simpler (httpserver_raw) + + 2015-10-09: Simon Goldschmidt + * started to move "private" header files containing implementation details to + "lwip/priv/" include directory to seperate the API from the implementation. + + 2015-10-07: Simon Goldschmidt + * added sntp client as first "supported" application layer protocol implementation + added 'apps' folder + + 2015-09-30: Dirk Ziegelmeier + * snmp_structs.h, mib_structs.c, mib2.c: snmp: fixed ugly inheritance + implementation by aggregating the "base class" (struct mib_node) in all + derived node classes to get more type-safe code + + 2015-09-23: Simon Goldschmidt + * netif.h/.c, nd6.c: task #13729: Convert netif addresses (IPv4 & IPv6) to + ip_addr_t (so they can be used without conversion/temporary storage) + + 2015-09-08: Dirk Ziegelmeier + * snmp: Separate mib2 counter/table callbacks from snmp agent. This both cleans + up the code and should allow integration of a 3rd party agent/mib2. Simple + counters are kept in MIB2_STATS, tree/table change function prototypes moved to + snmp_mib2.h. + + 2015-09-03: Simon Goldschmidt + * opt.h, dns.h/.c: DNS/IPv6: added support for AAAA records + + 2015-09-01: Simon Goldschmidt + * task #12178: hardware checksum capabilities can be configured per netif + (use NETIF_SET_CHECKSUM_CTRL() in your netif's init function) + + 2015-08-30: Simon Goldschmidt + * PBUF_REF with "custom" pbufs is now supported for RX pbufs (see pcapif in + contrib for an example, LWIP_SUPPORT_CUSTOM_PBUF is required) + + 2015-08-30: Simon Goldschmidt + * support IPv4 source based routing: define LWIP_HOOK_IP4_ROUTE_SRC to point + to a routing function + + 2015-08-05: Simon Goldschmidt + * many files: allow multicast socket options IP_MULTICAST_TTL, IP_MULTICAST_IF + and IP_MULTICAST_LOOP to be used without IGMP + + 2015-04-24: Simon Goldschmidt + * dhcp.h/c, autoip.h/.c: added functions dhcp/autoip_supplied_address() to + check for the source of address assignment (replacement for NETIF_FLAG_DHCP) + + 2015-04-10: Simon Goldschmidt + * many files: task #13480: added LWIP_IPV4 define - IPv4 can be disabled, + leaving an IPv6-only stack + + 2015-04-09: Simon Goldschmidt + * nearly all files: task #12722 (improve IPv4/v6 address handling): renamed + ip_addr_t to ip4_addr_t, renamed ipX_addr_t to ip_addr_t and added IP + version; ip_addr_t is used for all generic IP addresses for the API, + ip(4/6)_addr_t are only used internally or when initializing netifs or when + calling version-related functions + + 2015-03-24: Simon Goldschmidt + * opt.h, ip4_addr.h, ip4.c, ip6.c: loopif is not required for loopback traffic + any more but passed through any netif (ENABLE_LOOPBACK has to be enabled) + + 2015-03-23: Simon Goldschmidt + * opt.h, etharp.c: with ETHARP_TABLE_MATCH_NETIF== 1, duplicate (Auto)-IP + addresses on multiple netifs should now be working correctly (if correctly + addressed by routing, that is) + + 2015-03-23: Simon Goldschmidt + * etharp.c: Stable etharp entries that are about to expire are now refreshed + using unicast to prevent unnecessary broadcast. Only if no answer is received + after 15 seconds, broadcast is used. + + 2015-03-06: Philip Gladstone + * netif.h/.c: patch #8359 (Provide utility function to add an IPv6 address to + an interface) + + 2015-03-05: Simon Goldschmidt + * netif.c, ip4.c, dhcp.c, autoip.c: fixed bug #37068 (netif up/down handling + is unclear): correclty separated administrative status of a netif (up/down) + from 'valid address' status + ATTENTION: netif_set_up() now always has to be called, even when dhcp/autoip + is used! + + 2015-02-26: patch by TabascoEye + * netif.c, udp.h/.c: fixed bug #40753 (re-bind UDP pcbs on change of IP address) + + 2015-02-22: chrysn, Simon Goldschmidt + * *.*: Changed nearly all functions taking 'ip(X)_addr_t' pointer to take + const pointers (changed user callbacks: raw_recv_fn, udp_recv_fn; changed + port callbacks: netif_output_fn, netif_igmp_mac_filter_fn) + + 2015-02-19: Ivan Delamer + * netif.h, dhcp.c: Removed unused netif flag for DHCP. The preferred way to evaluate + if DHCP is active is through netif->dhcp field. + + 2015-02-19: Ivan Delamer + * netif.h, slipif.c, ppp.c: Removed unused netif flag for point to point connections + + 2015-02-18: Simon Goldschmidt + * api_lib.c: fixed bug #37958 "netconn API doesn't handle correctly + connections half-closed by peer" + + 2015-02-18: Simon Goldschmidt + * tcp.c: tcp_alloc() prefers killing CLOSING/LAST_ACK over active connections + (see bug #39565) + + 2015-02-16: Claudius Zingerli, Sergio Caprile + * opt.h, dhcp.h/.c: patch #8361 "Add support for NTP option in DHCP" + + 2015-02-14: Simon Goldschmidt + * opt.h, snmp*: added support for write-access community and dedicated + community for sending traps + + 2015-02-13: Simon Goldschmidt + * opt.h, memp.c: added hook LWIP_HOOK_MEMP_AVAILABLE() to get informed when + a memp pool was empty and an item is now available + + 2015-02-13: Simon Goldschmidt + * opt.h, pbuf.h/.c, etharp.c: Added the option PBUF_LINK_ENCAPSULATION_HLEN to + allocate additional header space for TX on netifs requiring additional headers + + 2015-02-12: chrysn + * timers.h/.c: introduce sys_timeouts_sleeptime (returns the time left before + the next timeout is due, for NO_SYS==1) + + 2015-02-11: Nick van Ijzendoorn + * opt.h, sockets.h/c: patch #7702 "Include ability to increase the socket number + with defined offset" + + 2015-02-11: Frederick Baksik + * opt.h, def.h, others: patch #8423 "arch/perf.h" should be made an optional item + + 2015-02-11: Simon Goldschmidt + * api_msg.c, opt.h: started to implement fullduplex sockets/netconns + (note that this is highly unstable yet!) + + 2015-01-17: Simon Goldschmidt + * api: allow enabling socket API without (public) netconn API - netconn API is + still used by sockets, but keeping it private (static) should allow better + compiler optimizations + + 2015-01-16: Simon Goldschmidt + * tcp_in.c: fixed bug #20506 "Initial congestion window is very small" again + by implementing the calculation formula from RFC3390 + + 2014-12-10: Simon Goldschmidt + * api: added option LWIP_NETCONN_SEM_PER_THREAD to use a semaphore per thread + instead of using one per netconn and per select call + + 2014-12-08: Simon Goldschmidt + * ip6.h: fixed bug #43778: IPv6 header version not set on 16-bit platform + (macro IP6H_VTCFL_SET()) + + 2014-12-08: Simon Goldschmidt + * icmp.c, ip4.c, pbuf.c, udp.c, pbuf.h: task #11472 Support PBUF_REF for RX + (IPv6 and IPv4/v6 reassembly might not work yet) + + 2014-11-06: Simon Goldschmidt + * sockets.c/.h, init.c: lwip_socket_init() is not needed any more + -> compatibility define + + 2014-09-16: Simon Goldschmidt + * dns.c, opt.h: reduced ram usage by parsing DNS responses in place + + 2014-09-16: Simon Goldschmidt + * pbuf.h/.c: added pbuf_take_at() and pbuf_put_at() + + 2014-09-15: Simon Goldschmidt + * dns.c: added source port randomization to make the DNS client more robust + (see bug #43144) + + 2013-09-02: Simon Goldschmidt + * arch.h and many other files: added optional macros PACK_STRUCT_FLD_8() and + PACK_STRUCT_FLD_S() to prevent gcc 4 from warning about struct members that + do not need packing + + 2013-08-19: Simon Goldschmidt + * netif.h: bug #42998: made NETIF_MAX_HWADDR_LEN overridable for some special + networks + + 2013-03-17: Simon Goldschmidt (patch by Ghobad Emadi) + * opt.h, etharp.c: Added LWIP_HOOK_ETHARP_GET_GW to implement IPv4 routing with + multiple gateways + + 2013-04-20: Fatih Asici + * opt.h, etharp.h/.c: patch #7993: Added support for transmitting packets + with VLAN headers via hook function LWIP_HOOK_VLAN_SET and to check them + via hook function LWIP_HOOK_VLAN_CHECK + + 2014-02-20: Simon Goldschmidt (based on patch by Artem Pisarenko) + * patch #7885: modification of api modules to support FreeRTOS-MPU + (don't pass stack-pointers to other threads) + + 2014-02-05: Simon Goldschmidt (patch by "xtian" and "alex_ab") + * patch #6537/#7858: TCP window scaling support + + 2014-01-17: Jiri Engelthaler + * icmp, icmp6, opt.h: patch #8027: Completed HW checksuming for IPv4 and + IPv6 ICMP's + + 2012-08-22: Sylvain Rochet + * New PPP stack for lwIP, developed in ppp-new branch. + Based from pppd 2.4.5, released 2009-11-17, with huge changes to match + code size and memory requirements for embedded devices, including: + - Gluing together the previous low-level PPP code in lwIP to pppd 2.4.5, which + is more or less what pppd sys-* files are, so that we get something working + using the unix port. + - Merged some patchs from lwIP Git repository which add interesting features + or fix bugs. + - Merged some patchs from Debian pppd package which add interesting features + or fix bugs. + - Ported PPP timeout handling to the lwIP timers system + - Disabled all the PPP code using filesystem access, replaced in necessary cases + to configuration variables. + - Disabled all the PPP code forking processes. + - Removed IPX support, lwIP does not support IPX. + - Ported and improved random module from the previous PPP port. + - Removed samba TDB (file-driven database) usage, because it needs a filesystem. + - MS-CHAP required a DES implementation, we added the latest PolarSSL DES + implementation which is under a BSD-ish license. + - Also switched to PolarSSL MD4,MD5,SHA1 implementations, which are meant to be + used in embedded devices with reduced memory footprint. + - Removed PPP configuration file parsing support. + - Added macro definition EAP_SUPPORT to make EAP support optional. + - Added macro definition CHAP_SUPPORT to make CHAP support optional. + - Added macro definition MSCHAP_SUPPORT to make MSCHAP support optional. + - Added macro definition PAP_SUPPORT to make PAP support optional. + - Cleared all Linux syscall calls. + - Disabled demand support using a macro, so that it can be ported later. + - Disabled ECP support using a macro, so that it can be ported later. + - Disabled CCP support using a macro, so that it can be ported later. + - Disabled CBCP support using a macro, so that it can be ported later. + - Disabled LQR support using a macro, so that it can be ported later. + - Print packet debug feature optional, through PRINTPKT_SUPPORT + - Removed POSIX signal usage. + - Fully ported PPPoS code from the previous port. + - Fully ported PPPoE code from the previous port. + - Fully ported VJ compression protocol code from the previous port. + - Removed all malloc()/free() use from PPP, replaced by stack usage or PBUF. + - Disabled PPP server support using a macro, so that it can be ported later. + - Switched all PPP debug to lwIP debug system. + - Created PPP Control Block (PPP PCB), removed PPP unit integer everywhere, + removed all global variables everywhere, did everything necessary for + the PPP stack to support more than one PPP session (pppd only support + one session per process). + - Removed the statically allocated output buffer, now using PBUF. + - Improved structure size of all PPP modules, deep analyze of code to reduce + variables size to the bare minimum. Switched all boolean type (char type in + most architecture) to compiler generated bitfields. + - Added PPP IPv6 support, glued lwIP IPv6 support to PPP. + - Now using a persistent netif interface which can then be used in lwIP + functions requiring a netif. + - Now initializing PPP in lwip_init() function. + - Reworked completely the PPP state machine, so that we don't end up in + anymore in inconsistent state, especially with PPPoE. + - Improved the way we handle PPP reconnection after disconnect, cleaning + everything required so that we start the PPP connection again from a + clean state. + - Added PPP holdoff support, allow the lwIP user to wait a little bit before + reconnecting, prevents connection flood, especially when using PPPoL2TP. + - Added PPPoL2TP LAC support (a.k.a. UDP tunnels), adding a VPN client + feature to lwIP, L2TP being a widely used tunnel protocol. + - Switched all used PPP types to lwIP types (u8t, u16t, u32t, ...) + - Added PPP API "sequential" thread-safe API, based from NETIFAPI. + + 2011-07-21: Simon Goldschmidt + * sockets.c, opt.h: (bug #30185): added LWIP_FIONREAD_LINUXMODE that makes + ioctl/FIONREAD return the size of the next pending datagram. + + 2011-05-25: Simon Goldschmidt + * again nearly the whole stack, renamed ip.c to ip4.c, ip_addr.c to ip4_addr.c, + combined ipv4/ipv6 inet_chksum.c, added ip.h, ip_addr.h: Combined IPv4 + and IPv6 code where possible, added defines to access IPv4/IPv6 in non-IP + code so that the code is more readable. + + 2011-05-17: Patch by Ivan Delamer (only checked in by Simon Goldschmidt) + * nearly the whole stack: Finally, we got decent IPv6 support, big thanks to + Ivan! (this is work in progress: we're just post release anyway :-) + + + ++ Bugfixes: + + 2016-03-05: Simon Goldschmidt + * err.h/.c, sockets.c: ERR_IF is not necessarily a fatal error + + 2015-11-19: fix by Kerem Hadimli + * sockets.c: fixed bug #46471: lwip_accept() leaks socket descriptors if new + netconn was already closed because of peer behavior + + 2015-11-12: fix by Valery Ushakov + * tcp_in.c: fixed bug #46365 tcp_accept_null() should call tcp_abort() + + 2015-10-02: Dirk Ziegelmeier/Simon Goldschmidt + * snmp: cleaned up snmp structs API (fixed race conditions from bug #46089, + reduce ram/rom usage of tables): incompatible change for private MIBs + + 2015-09-30: Simon Goldschmidt + * ip4_addr.c: fixed bug #46072: ip4addr_aton() does not check the number range + of all address parts + + 2015-08-28: Simon Goldschmidt + * tcp.c, tcp_in.c: fixed bug #44023: TCP ssthresh value is unclear: ssthresh + is set to the full send window for active open, too, and is updated once + after SYN to ensure the correct send window is used + + 2015-08-28: Simon Goldschmidt + * tcp: fixed bug #45559: Window scaling casts u32_t to u16_t without checks + + 2015-08-26: Simon Goldschmidt + * ip6_frag.h/.c: fixed bug bug #41009: IPv6 reassembly broken on 64-bit platforms: + define IPV6_FRAG_COPYHEADER==1 on these platforms to copy the IPv6 header + instead of referencing it, which gives more room for struct ip6_reass_helper + + 2015-08-25: Simon Goldschmidt + * sockets.c: fixed bug #45827: recvfrom: TCP window is updated with MSG_PEEK + + 2015-08-20: Manoj Kumar + * snmp_msg.h, msg_in.c: fixed bug #43790: Sending octet string of Length >255 + from SNMP agent + + 2015-08-19: Jens Nielsen + * icmp.c, ip4.c, tcp_in.c, udp.c, raw.c: fixed bug #45120: Broadcast & multiple + interfaces handling + + 2015-08-19: Simon Goldschmidt (patch by "Sandra") + * dns.c: fixed bug #45004: dns response without answer might be discarded + + 2015-08-18: Chrysn + * timers.c: patch #8704 fix sys_timeouts_sleeptime function + + 2015-07-01: Erik Ekman + * puf.c: fixed bug #45454 (pbuf_take_at() skips write and returns OK if offset + is at start of pbuf in chain) + + 2015-05-19: Simon Goldschmidt + * dhcp.h/.c: fixed bugs #45140 and #45141 (dhcp was not stopped correctly after + fixing bug #38204) + + 2015-03-21: Simon Goldschmidt (patch by Homyak) + * tcp_in.c: fixed bug #44766 (LWIP_WND_SCALE: tcphdr->wnd was not scaled in + two places) + + 2015-03-21: Simon Goldschmidt + * tcp_impl.h, tcp.c, tcp_in.c: fixed bug #41318 (Bad memory ref in tcp_input() + after tcp_close()) + + 2015-03-21: Simon Goldschmidt + * tcp_in.c: fixed bug #38468 (tcp_sent() not called on half-open connection for + data ACKed with the same ack as FIN) + + 2015-03-21: Simon Goldschmidt (patch by Christoffer Lind) + * dhcp.h/.c: fixed bug #38204 (DHCP lease time not handled correctly) + + 2015-03-20: Simon Goldschmidt + * dhcp.c: fixed bug #38714 (Missing option and client address in DHCPRELEASE message) + + 2015-03-19: Simon Goldschmidt + * api.h, tcpip.h, api_lib.c, api_msg.c: fixed race conditions in assigning + netconn->last_err (fixed bugs #38121 and #37676) + + 2015-03-09: Simon Goldschmidt + * ip4.c: fixed the IPv4 part of bug #43904 (ip_route() must detect linkup status) + + 2015-03-04: Simon Goldschmidt + * nd6.c: fixed bug #43784 (a host should send at least one Router Solicitation) + + 2015-03-04: Valery Ushakov + * ip6.c: fixed bug #41094 (Byte-order bug in IPv6 fragmentation header test) + + 2015-03-04: Zach Smith + * nd6.c: fixed bug #38153 (nd6_input() byte order issues) + + 2015-02-26: Simon Goldschmidt + * netif.c, tcp.h/.c: fixed bug #44378 (TCP connections are not aborted on netif + remove) + + 2015-02-25: Simon Goldschmidt + * ip4.c, etharp.c: fixed bug #40177 (System hangs when dealing with corrupted + packets), implemented task #12357 (Ensure that malicious packets don't + assert-fail): improved some pbuf_header calls to not assert-fail. + + 2015-02-25: patch by Joel Cunningham + * udp.h/.c, sockets.c: fixed bug #43028 (IP_MULTICAST_TTL affects unicast + datagrams) + + 2015-02-25: patch by Greg Renda + * ip4_frag.c: fixed bug #38210 (ip reassembly while remove oldest datagram) + + 2015-02-25: Simon Goldschmidt + * sockets.c: fixed bug #38165 (socket with mulicast): ensure igmp membership + are dropped when socket (not netconn!) is closed. + + 2015-02-25: Simon Goldschmidt + * ip4.h/.c, udp.c: fixed bug #38061 (wrong multicast routing in IPv4) by + adding an optional default netif for multicast routing + + 2015-02-25: Simon Goldschmidt + * netconn API: fixed that netconn_connect still used message passing for + LWIP_TCPIP_CORE_LOCKING==1 + + 2015-02-22: patch by Jens Nielsen + * icmp.c: fixed bug #38803 (Source address in broadcast ping reply) + + 2015-02-22: Simon Goldschmidt + * udp.h, sockets.c: added proper accessor functions for pcb->multicast_ip + (previously used by get/setsockopt only) + + 2015-02-18: Simon Goldschmidt + * sockets.c: Fixed select not reporting received FIN as 'readable' in certain + rare cases (bug #43779: select(), close(), and TCP retransmission error) + + 2015-02-17: Simon Goldschmidt + * err.h, sockets.c, api_msg.c: fixed bug #38853 "connect() use a wrong errno": + return ERR_ALREADY/EALRADY during connect, ERR_ISCONN/EISCONN when already + connected + + 2015-02-17: Simon Goldschmidt + * tcp_impl.h, tcp_out.c, tcp.c, api_msg.c: fixed bug #37614 "Errors from + ipX_output are not processed". Now tcp_output(_segment) checks for the return + value of ipX_output and does not try to send more on error. A netif driver + can call tcp_txnow() (from tcpip_thread!) to try to send again if TX buffers + are available again. + + 2015-02-14: patches by Freddie Chopin + * snmp*: made community writable, fixed some const pointers + + 2015-02-13: Simon Goldschmidt + * msg_in.c: fixed bug #22070 "MIB_OBJECT_WRITE_ONLY not implemented in SNMP" + + 2015-02-12: Simon Goldschmidt + * ip.h, ip4.c, ip6.c: fixed bug #36403 "ip4_input() and ip6_input() always pass + inp to higher layers": now the accepting netif is passed up, but the input + netif is available through ip_current_input_netif() if required. + + 2015-02-11: patch by hichard + * tcpip.c: fixed bug #43094 "The function tcpip_input() forget to handle IPv6" + + 2015-02-10: Simon Goldschmidt + * netconn API: fixed that netconn_close/netconn_delete still used message passing + for LWIP_TCPIP_CORE_LOCKING==1 + + 2015-02-10: Simon Goldschmidt + * netconn/socket api: fixed bug #44225 "closing TCP socket should time out + eventually", implemented task #6930 "Implement SO_LINGER": closing TCP sockets + times out after 20 seconds or after the configured SND_TIMEOUT or depending + on the linger settings. + + 2015-01-27: Simon Goldschmidt + * api_msg.c: fixed that SHUT_RD followed by SHUT_WR was different to SHUT_RDWR, + fixed return value of lwip_netconn_do_close on unconnected netconns + + 2015-01-17: Simon Goldschmidt + * sockets.c: fixed bug #43361 select() crashes with stale FDs + + 2015-01-17: Simon Goldschmidt + * sockets.c/.h, memp_std.h: fixed bug #40788 "lwip_setsockopt_internal() crashes" + by rewriting set/getsockopt functions to combine checks with the actual code + and add more NULL checks; this also fixes that CORE_LOCKING used message + passing for set/getsockopt. + + 2014-12-19: Simon Goldschmidt + * opt.h, dhcp.h/.c: prevent dhcp from starting when netif link is down (only + when LWIP_DHCP_CHECK_LINK_UP==1, which is disabled by default for + compatibility reasons) + + 2014-12-17: Simon Goldschmidt + * tcp_out.c: fixed bug #43840 Checksum error for TCP_CHECKSUM_ON_COPY==1 for + no-copy data with odd length + + 2014-12-10: Simon Goldschmidt + * sockets.c, tcp.c, others: fixed bug #43797 set/getsockopt: SO_SNDTIMEO/SO_RCVTIMEO + take int as option but should take timeval (LWIP_SO_SNDRCVTIMEO_STANDARD==0 can + be used to revert to the old 'winsock' style behaviour) + Fixed implementation of SO_ACCEPTCONN to just look at the pcb state + + 2014-12-09: Simon Goldschmidt + * ip4.c: fixed bug #43596 IGMP queries from 0.0.0.0 are discarded + + 2014-10-21: Simon Goldschmidt (patch by Joel Cunningham and Albert Huitsing) + * sockts.c: fixed bugs #41495 Possible threading issue in select() and #43278 + event_callback() handle context switch when calling sys_sem_signal() + + 2014-10-21: Simon Goldschmidt + * api_msg.c: fixed bug #38219 Assert on TCP netconn_write with sndtimeout set + + 2014-09-16: Kevin Cernekee + * dns.c: patch #8480 Fix handling of dns_seqno wraparound + + 2014-09-16: Simon Goldschmidt + * tcp_out.c: fixed bug #43192 tcp_enqueue_flags() should not check TCP_SND_QUEUELEN + when sending FIN + + 2014-09-03: Simon Goldschmidt + * msg_in.c: fixed bug #39355 SNMP Memory Leak in case of error + + 2014-09-02: Simon Goldschmidt + * err.h/.c, sockets.c, api_msg.c: fixed bug #43110 call getpeername() before + listen() will cause a error + + 2014-09-02: Simon Goldschmidt + * sockets.c: fixed bug #42117 lwip_fcntl does not set errno + + 2014-09-02: Simon Goldschmidt + * tcp.c: fixed bug #42299 tcp_abort() leaves freed pcb on tcp_bound_pcbs list + + 2014-08-20: Simon Goldschmidt + * dns.c: fixed bug #42987 lwIP is vulnerable to DNS cache poisoning due to + non-randomized TXIDs + + 2014-06-03: Simon Goldschmidt + * tcp_impl.h, tcp_in.c: fixed bug #37969 SYN packet dropped as short packet in + tcp_input function + + 2014-05-20: Simon Goldschmidt + * tcp_out.c: fixed bug #37184 tcp_write problem for pcbs in the SYN_SENT state + + 2014-05-19: Simon Goldschmidt + * *.h: Fixed bug #35874 reserved identifier violation (removed leading underscores + from header include guards) + + 2014-04-08: Simon Goldschmidt + * tcp.c: Fixed bug #36167 tcp server crash when client closes (maximum window) + + 2014-04-06: Simon Goldschmidt + * tcp_in.c: Fixed bug #36210 lwIP does not elicit an empty ACK when received + unacceptable ACK + + 2014-04-06: Simon Goldschmidt + * dhcp.c, ip4.c/.h, ip6.c/.h, udp.c/.h, ip.h: Fixed bug #41787 DHCP Discovery + is invalid when an IP is set to thet netif. + + 2014-03-14: Simon Goldschmidt + * tcp_out.c: Fixed bug #36153 TCP Cheksum error if LWIP_CHECKSUM_ON_COPY=1 + + 2014-03-11: Simon Goldschmidt (patch by Mason) + * opt.h, sockets.c: fixed bug #35928 BSD sockets functions must set errno for + POSIX-compliance + + 2014-02-27: Simon Goldschmidt + * dhcp.c: fixed bug #40303 DHCP xid renewed when sending a DHCPREQUEST + + 2014-02-27: Simon Goldschmidt + * raw.c: fixed bug #41680 raw socket can not receive IPv6 packet when + IP_SOF_BROADCAST_RECV==1 + + 2014-02-27: Simon Goldschmidt + * api_msg.c, sockets.c: fixed bug #38404 getpeeraddr returns success on + unconnected/listening TCP sockets + + 2014-02-27: Simon Goldschmidt + * sockets.c: fixed bug #41729 Some socket functions return Exyz instead of -1 + + 2014-02-25: Simon Goldschmidt + * ip4.c: fixed bug #39514 ip_route() may return an IPv6-only interface + + 2014-02-25: Simon Goldschmidt, patch by Fatih Asici + * pbuf.c: fixed bug #39356 Wrong increment in pbuf_memfind() + + 2014-02-25: Simon Goldschmidt + * netif.c/.h, udp.c: fixed bug #39225 udp.c uses netif_matches_ip6_addr() incorrectly; + renamed function netif_matches_ip6_addr() to netif_get_ip6_addr_match() + + 2014-02-25: Simon Goldschmidt + * igmp.c: fixed bug #39145 IGMP membership report for 224.0.0.1 + + 2014-02-22: Simon Goldschmidt (patch by Amir Shalem) + * etharp.c, opt.h: fixed bug #34681 Limit ARP queue length by ARP_QUEUE_LEN (=3) + + 2014-02-22: Simon Goldschmidt (patch by Amir Shalem) + * etharp.h/.c: fixed bug #34682 Limit ARP request flood for unresolved entry + + 2014-02-20: Simon Goldschmidt + * tcp_out.c: fixed bug #39683 Assertion "seg->tcphdr not aligned" failed with + MEM_ALIGNMENT = 8 + + 2014-02-20: Simon Goldschmidt + * sockets.c: fixed bug #39882 No function shall set errno to 0 + + 2014-02-20: Simon Goldschmidt + * mib_structs.c: fixed bug #40050 SNMP problem with MIB arrays > 255 + + 2014-02-20: Simon Goldschmidt + * api.h, sockets.c: fixed bug #41499 netconn::recv_avail can overflow + + 2014-01-08: Stathis Voukelatos + * memp_std.h: patch #7928 Fixed size calculation in MALLOC memory pool + creation macro + + 2014-01-18: Brian Fahs + * tcp_out.c: patch #8237: tcp_rexmit_rto fails to update pcb->unsent_oversize + when necessary + + 2014-01-17: Grant Erickson, Jay Logue, Simon Goldschmidt + * ipv6.c, netif.c: patch #7913 Enable Support for IPv6 Loopback + + 2014-01-16: Stathis Voukelatos + * netif.c: patch #7902 Fixed netif_poll() operation when LWIP_LOOPBACK_MAX_PBUFS > 0 + + 2014-01-14: "Freddie Chopin" + * snmp.h, mib2.c: fixed constness and spelling of sysdescr + + 2014-01-14: Simon Goldschmidt (patch by Thomas Faber) + * tcpip.c: patch #8241: Fix implicit declaration of ip_input with + LWIP_TCPIP_CORE_LOCKING_INPUT disabled + + 2014-01-14: chrysn + * timers.c: patch #8244 make timeouts usable reliably from outside of the + timeout routine + + 2014-01-10: Simon Goldschmidt + * ip_frag.c, ip6_frag.c: fixed bug #41041 Potential use-after-free in IPv6 reassembly + + 2014-01-10: Simon Goldschmidt + * memp.c: fixed bug #41188 Alignment error in memp_init() when MEMP_SEPARATE_POOLS==1 + + 2014-01-10: Simon Goldschmidt + * tcp.c: fixed bug #39898 tcp_fasttmr() possible lock due to infinte queue process loop + + 2013-06-29: Simon Goldschmidt + * inet.h, sockets.h: partially fixed bug #37585: IPv6 compatibility (in socket structs) + + 2013-06-29: Simon Goldschmidt + * inet6.h: bug #37585/task #12600: fixed struct in6_addr.s6_addr to conform to spec + + 2013-04-24: patch by Liam + * api_msg.c: patch #8008 Fix a potential null pointer dereference in assert + + 2013-04-24: Simon Goldschmidt + * igmp.c: fixed possible division by zero + + 2013-04-24: Simon Goldschmidt + * ip6.h, some ipv6 C files: fixed bug #38526 Coverity: Recursive Header Inclusion in ip6.h + + 2013-04-24: Simon Goldschmidt (patch by Emil Ljungdahl): + * netif.c: fixed bug #38586 netif_loop_output() "deadlocks" + + 2013-01-15: Simon Goldschmidt + * ip4.c: fixed bug #37665 ip_canforward operates on address in wrong byte order + + 2013-01-15: Simon Goldschmidt + * pbuf.h: fixed bug #38097 pbuf_free_ooseq() warning + + 2013-01-14: Simon Goldschmidt + * dns.c: fixed bug #37705 Possible memory corruption in DNS query + + 2013-01-11: Simon Goldschmidt + * raw.c: fixed bug #38066 Raw pcbs can alter packet without eating it + + 2012-08-22: Simon Goldschmidt + * memp.c: fixed bug #37166: memp_sanity check loops itself + + 2012-08-13: Simon Goldschmidt + * dhcp.c: fixed bug #36645: Calling dhcp_release before dhcp_start + dereferences NULL + + 2012-08-13: Simon Goldschmidt + * msg_out.c: fixed bug #36840 snmp_send_trap() NULL de-reference if traps + configured but no interfaces available + + 2012-08-13: Simon Goldschmidt + * dns.c: fixed bug #36899 DNS TTL 0 is cached for a long time + + 2012-05-11: Simon Goldschmidt (patch by Marty) + * memp.c: fixed bug #36412: memp.c does not compile when + MEMP_OVERFLOW_CHECK > zero and MEMP_SEPARATE_POOLS == 1 + + 2012-05-03: Simon Goldschmidt (patch by Sylvain Rochet) + * ppp.c: fixed bug #36283 (PPP struct used on header size computation and + not packed) + + 2012-05-03: Simon Goldschmidt (patch by David Empson) + * ppp.c: fixed bug #36388 (PPP: checksum-only in last pbuf leads to pbuf with + zero length) + + 2012-03-25: Simon Goldschmidt + * api_msg.c: Fixed bug #35817: do_connect() invalidly signals op_completed + for UDP/RAW with LWIP_TCPIP_CORE_LOCKING==1 + + 2012-03-25: Simon Goldschmidt + * api_msg.h, api_lib.c, api_msg.c, netifapi.c: fixed bug #35931: Name space + pollution in api_msg.c and netifapi.c + + 2011-08-24: Simon Goldschmidt + * inet6.h: fixed bug #34124 struct in6_addr does not conform to the standard + + + +(STABLE-1.4.1) + + ++ New features: + + 2012-03-25: Simon Goldschmidt (idea by Mason) + * posix/*: added posix-compatibility include files posix/netdb.h and posix/sys/socket.h + which are a simple wrapper to the correct lwIP include files. + + 2012-01-16: Simon Goldschmidt + * opt.h, icmp.c: Added option CHECKSUM_GEN_ICMP + + 2011-12-17: Simon Goldschmidt + * ip.h: implemented API functions to access so_options of IP pcbs (UDP, TCP, RAW) + (fixes bug #35061) + + 2011-09-27: Simon Goldschmidt + * opt.h, tcp.c, tcp_in.c: Implemented limiting data on ooseq queue (task #9989) + (define TCP_OOSEQ_MAX_BYTES / TCP_OOSEQ_MAX_PBUFS in lwipopts.h) + + 2011-09-21: Simon Goldschmidt + * opt.h, api.h, api_lib.c, api_msg.h/.c, sockets.c: Implemented timeout on + send (TCP only, bug #33820) + + 2011-09-21: Simon Goldschmidt + * init.c: Converted runtime-sanity-checks into compile-time checks that can + be disabled (since runtime checks can often not be seen on embedded targets) + + 2011-09-11: Simon Goldschmidt + * ppp.h, ppp_impl.h: splitted ppp.h to an internal and external header file + to get a clear separation of which functions an application or port may use + (task #11281) + + 2011-09-11: Simon Goldschmidt + * opt.h, tcp_impl.h, tcp.c, udp.h/.c: Added a config option to randomize + initial local TCP/UDP ports (so that different port ranges are used after + a reboot; bug #33818; this one added tcp_init/udp_init functions again) + + 2011-09-03: Simon Goldschmidt + * dhcp.c: DHCP uses LWIP_RAND() for xid's (bug #30302) + + 2011-08-24: Simon Goldschmidt + * opt.h, netif.h/.c: added netif remove callback (bug #32397) + + 2011-07-26: Simon Goldschmidt + * etharp.c: ETHARP_SUPPORT_VLAN: add support for an external VLAN filter + function instead of only checking for one VLAN (define ETHARP_VLAN_CHECK_FN) + + 2011-07-21: Simon Goldschmidt (patch by hanhui) + * ip4.c, etharp.c, pbuf.h: bug #33634 ip_forward() have a faulty behaviour: + Added pbuf flags to mark incoming packets as link-layer broadcast/multicast. + Also added code to allow ip_forward() to forward non-broadcast packets to + the input netif (set IP_FORWARD_ALLOW_TX_ON_RX_NETIF==1). + + 2011-06-26: Simon Goldschmidt (patch by Cameron Gutman) + * tcp.c, tcp_out.c: bug #33604: added some more asserts to check that + pcb->state != LISTEN + + 2011-05-14: Simon Goldschmidt (patch by Stéphane Lesage) + * tcpip.c/.h: patch #7449 allow tcpip callback from interrupt with static + memory message + + + ++ Bugfixes: + + 2012-09-26: Simon Goldschmidt + * api_msg.c: fixed bug #37405 'err_tcp()' uses already freed 'netconn' object + + 2012-09-26: patch by Henrik Persson + * dhcp.c: patch #7843 Fix corner case with dhcp timeouts + + 2012-09-26: patch by Henrik Persson + * dhcp.c: patch #7840 Segfault in dhcp_parse_reply if no end marker in dhcp packet + + 2012-08-22: Simon Goldschmidt + * memp.c: fixed bug #37166: memp_sanity check loops itself + + 2012-05-08: Simon Goldschmidt + * tcp_out.c: fixed bug: #36380 unsent_oversize mismatch in 1.4.1RC1 (this was + a debug-check issue only) + + 2012-03-27: Simon Goldschmidt + * vj.c: fixed bug #35756 header length calculation problem in ppp/vj.c + + 2012-03-27: Simon Goldschmidt (patch by Mason) + * tcp_out.c: fixed bug #35945: SYN packet should provide the recv MSS not the + send MSS + + 2012-03-22: Simon Goldschmidt + * ip4.c: fixed bug #35927: missing refragmentaion in ip_forward + + 2012-03-20: Simon Goldschmidt (patch by Mason) + * netdb.c: fixed bug #35907: lwip_gethostbyname_r returns an invalid h_addr_list + + 2012-03-12: Simon Goldschmidt (patch by Bostjan Meglic) + * ppp.c: fixed bug #35809: PPP GetMask(): Compiler warning on big endian, + possible bug on little endian system + + 2012-02-23: Simon Goldschmidt + * etharp.c: fixed bug #35595: Impossible to send broadcast without a gateway + (introduced when fixing bug# 33551) + + 2012-02-16: Simon Goldschmidt + * ppp.c: fixed pbuf leak when PPP session is aborted through pppSigHUP() + (bug #35541: PPP Memory Leak) + + 2012-02-16: Simon Goldschmidt + * etharp.c: fixed bug #35531: Impossible to send multicast without a gateway + (introduced when fixing bug# 33551) + + 2012-02-16: Simon Goldschmidt (patch by Stéphane Lesage) + * msg_in.c, msg_out.c: fixed bug #35536 SNMP: error too big response is malformed + + 2012-02-15: Simon Goldschmidt + * init.c: fixed bug #35537: MEMP_NUM_* sanity checks should be disabled with + MEMP_MEM_MALLOC==1 + + 2012-02-12: Simon Goldschmidt + * tcp.h, tcp_in.c, tcp_out.c: partly fixed bug #25882: TCP hangs on + MSS > pcb->snd_wnd (by not creating segments bigger than half the window) + + 2012-02-11: Simon Goldschmidt + * tcp.c: fixed bug #35435: No pcb state check before adding it to time-wait + queue while closing + + 2012-01-22: Simon Goldschmidt + * tcp.c, tcp_in.c: fixed bug #35305: pcb may be freed too early on shutdown(WR) + + 2012-01-21: Simon Goldschmidt + * tcp.c: fixed bug #34636: FIN_WAIT_2 - Incorrect shutdown of TCP pcb + + 2012-01-20: Simon Goldschmidt + * dhcp.c: fixed bug #35151: DHCP asserts on incoming option lengths + + 2012-01-20: Simon Goldschmidt + * pbuf.c: fixed bug #35291: NULL pointer in pbuf_copy + + 2011-11-25: Simon Goldschmidt + * tcp.h/.c, tcp_impl.h, tcp_in.c: fixed bug #31177: tcp timers can corrupt + tcp_active_pcbs in some cases + + 2011-11-23: Simon Goldschmidt + * sys.c: fixed bug #34884: sys_msleep() body needs to be surrounded with + '#ifndef sys_msleep' + + 2011-11-22: Simon Goldschmidt + * netif.c, etharp.h/.c: fixed bug #34684: Clear the arp table cache when + netif is brought down + + 2011-10-28: Simon Goldschmidt + * tcp_in.c: fixed bug #34638: Dead code in tcp_receive - pcb->dupacks + + 2011-10-23: Simon Goldschmidt + * mem.c: fixed bug #34429: possible memory corruption with + LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT set to 1 + + 2011-10-18: Simon Goldschmidt + * arch.h, netdb.c: fixed bug #34592: lwip_gethostbyname_r uses nonstandard + error value + + 2011-10-18: Simon Goldschmidt + * opt.h: fixed default values of TCP_SNDLOWAT and TCP_SNDQUEUELOWAT for small + windows (bug #34176 select after non-blocking send times out) + + 2011-10-18: Simon Goldschmidt + * tcp_impl.h, tcp_out.c: fixed bug #34587: TCP_BUILD_MSS_OPTION doesn't + consider netif->mtu, causes slow network + + 2011-10-18: Simon Goldschmidt + * sockets.c: fixed bug #34581 missing parentheses in udplite sockets code + + 2011-10-18: Simon Goldschmidt + * sockets.h: fixed bug #34580 fcntl() is missing in LWIP_COMPAT_SOCKETS + + 2011-10-17: Simon Goldschmidt + * api_msg.c: fixed bug #34569: shutdown(SHUT_WR) crashes netconn/socket api + + 2011-10-13: Simon Goldschmidt + * tcp_in.c, tcp_out.c: fixed bug #34517 (persist timer is started although no + zero window is received) by starting the persist timer when a zero window is + received, not when we have more data queued for sending than fits into the + window + + 2011-10-13: Simon Goldschmidt + * def.h, timers.c: fixed bug #34541: LWIP_U32_DIFF is unnecessarily complex + + 2011-10-13: Simon Goldschmidt + * sockets.c, api_lib.c: fixed bug #34540: compiler error when CORE_LOCKING is + used and not all protocols are enabled + + 2011-10-12: Simon Goldschmidt + * pbuf.c: fixed bug #34534: Error in sending fragmented IP if MEM_ALIGNMENT > 4 + + 2011-10-09: Simon Goldschmidt + * tcp_out.c: fixed bug #34426: tcp_zero_window_probe() transmits incorrect + byte value when pcb->unacked != NULL + + 2011-10-09: Simon Goldschmidt + * ip4.c: fixed bug #34447 LWIP_IP_ACCEPT_UDP_PORT(dst_port) wrong + + 2011-09-27: Simon Goldschmidt + * tcp_in.c, tcp_out.c: Reset pcb->unsent_oversize in 2 more places... + + 2011-09-27: Simon Goldschmidt + * tcp_in.c: fixed bug #28288: Data after FIN in oos queue + + 2011-09-27: Simon Goldschmidt + * dhcp.c: fixed bug #34406 dhcp_option_hostname() can overflow the pbuf + + 2011-09-24: Simon Goldschmidt + * mem.h: fixed bug #34377 MEM_SIZE_F is not defined if MEM_LIBC_MALLOC==1 + + 2011-09-23: Simon Goldschmidt + * pbuf.h, tcp.c, tcp_in.c: fixed bug #33871: rejecting TCP_EVENT_RECV() for + the last packet including FIN can lose data + + 2011-09-22: Simon Goldschmidt + * tcp_impl.h: fixed bug #34355: nagle does not take snd_buf/snd_queuelen into + account + + 2011-09-21: Simon Goldschmidt + * opt.h: fixed default value of TCP_SND_BUF to not violate the sanity checks + in init.c + + 2011-09-20: Simon Goldschmidt + * timers.c: fixed bug #34337 (possible NULL pointer in sys_check_timeouts) + + 2011-09-11: Simon Goldschmidt + * tcp_out.c: use pcb->mss instead of TCP_MSS for preallocate mss-sized pbufs + (bug #34019) + + 2011-09-09: Simon Goldschmidt + * udp.c: fixed bug #34072: UDP broadcast is received from wrong UDP pcb if + udp port matches + + 2011-09-03: Simon Goldschmidt + * tcp_in.c: fixed bug #33952 PUSH flag in incoming packet is lost when packet + is aggregated and sent to application + + 2011-09-01: Simon Goldschmidt + * opt.h: fixed bug #31809 LWIP_EVENT_API in opts.h is inconsistent compared + to other options + + 2011-09-01: Simon Goldschmidt + * tcp_in.c: fixed bug #34111 RST for ACK to listening pcb has wrong seqno + + 2011-08-24: Simon Goldschmidt + * api_msg.c, sockets.c: fixed bug #33956 Wrong error returned when calling + accept() on UDP connections + + 2011-08-24: Simon Goldschmidt + * sockets.h: fixed bug #34057 socklen_t should be a typedef + + 2011-08-24: Simon Goldschmidt + * pbuf.c: fixed bug #34112 Odd check in pbuf_alloced_custom (typo) + + 2011-08-24: Simon Goldschmidt + * dhcp.c: fixed bug #34122 dhcp: hostname can overflow + + 2011-08-24: Simon Goldschmidt + * netif.c: fixed bug #34121 netif_add/netif_set_ipaddr fail on NULL ipaddr + + 2011-08-22: Simon Goldschmidt + * tcp_out.c: fixed bug #33962 TF_FIN not always set after FIN is sent. (This + merely prevents nagle from not transmitting fast after closing.) + + 2011-07-22: Simon Goldschmidt + * api_lib.c, api_msg.c, sockets.c, api.h: fixed bug #31084 (socket API returns + always EMSGSIZE on non-blocking sockets if data size > send buffers) -> now + lwip_send() sends as much as possible for non-blocking sockets + + 2011-07-22: Simon Goldschmidt + * pbuf.c/.h, timers.c: freeing ooseq pbufs when the pbuf pool is empty implemented + for NO_SYS==1: when not using sys_check_timeouts(), call PBUF_CHECK_FREE_OOSEQ() + at regular intervals from main level. + + 2011-07-21: Simon Goldschmidt + * etharp.c: fixed bug #33551 (ARP entries may time out although in use) by + sending an ARP request when an ARP entry is used in the last minute before + it would time out. + + 2011-07-04: Simon Goldschmidt + * sys_arch.txt: Fixed documentation after changing sys arch prototypes for 1.4.0. + + 2011-06-26: Simon Goldschmidt + * tcp.c: fixed bug #31723 (tcp_kill_prio() kills pcbs with the same prio) by + updating its documentation only. + + 2011-06-26: Simon Goldschmidt + * mem.c: fixed bug #33545: With MEM_USE_POOLS==1, mem_malloc can return an + unaligned pointer. + + 2011-06-26: Simon Goldschmidt + * mem.c: fixed bug #33544 "warning in mem.c in lwip 1.4.0 with NO_SYS=1" + + 2011-05-25: Simon Goldschmidt + * tcp.c: fixed bug #33398 (pointless conversion when checking TCP port range) + + + +(STABLE-1.4.0) + + ++ New features: + + 2011-03-27: Simon Goldschmidt + * tcp_impl.h, tcp_in.c, tcp_out.c: Removed 'dataptr' from 'struct tcp_seg' and + calculate it in tcp_zero_window_probe (the only place where it was used). + + 2010-11-21: Simon Goldschmidt + * dhcp.c/.h: Added a function to deallocate the struct dhcp from a netif + (fixes bug #31525). + + 2010-07-12: Simon Goldschmidt (patch by Stephane Lesage) + * ip.c, udp.c/.h, pbuf.h, sockets.c: task #10495: Added support for + IP_MULTICAST_LOOP at socket- and raw-API level. + + 2010-06-16: Simon Goldschmidt + * ip.c: Added an optional define (LWIP_IP_ACCEPT_UDP_PORT) that can allow + link-layer-addressed UDP traffic to be received while a netif is down (just + like DHCP during configuration) + + 2010-05-22: Simon Goldschmidt + * many many files: bug #27352: removed packing from ip_addr_t, the packed + version is now only used in protocol headers. Added global storage for + current src/dest IP address while in input functions. + + 2010-05-16: Simon Goldschmidt + * def.h: task #10391: Add preprocessor-macros for compile-time htonl + calculation (and use them throughout the stack where applicable) + + 2010-05-16: Simon Goldschmidt + * opt.h, memp_std.h, memp.c, ppp_oe.h/.c: PPPoE now uses its own MEMP pool + instead of the heap (moved struct pppoe_softc from ppp_oe.c to ppp_oe.h) + + 2010-05-16: Simon Goldschmidt + * opt.h, memp_std.h, dns.h/.c: DNS_LOCAL_HOSTLIST_IS_DYNAMIC uses its own + MEMP pool instead of the heap + + 2010-05-13: Simon Goldschmidt + * tcp.c, udp.c: task #6995: Implement SO_REUSEADDR (correctly), added + new option SO_REUSE_RXTOALL to pass received UDP broadcast/multicast + packets to more than one pcb. + + 2010-05-02: Simon Goldschmidt + * netbuf.h/.c, sockets.c, api_msg.c: use checksum-on-copy for sending + UDP data for LWIP_NETIF_TX_SINGLE_PBUF==1 + + 2010-04-30: Simon Goldschmidt + * udp.h/.c, pbuf.h/.c: task #6849: added udp_send(_to/_if) functions that + take a precalculated checksum, added pbuf_fill_chksum() to copy data + into a pbuf and at the same time calculating the checksum for that data + + 2010-04-29: Simon Goldschmidt + * ip_addr.h, etharp.h/.c, autoip.c: Create overridable macros for copying + 2-byte-aligned IP addresses and MAC addresses + + 2010-04-28: Patch by Bill Auerbach + * ip.c: Inline generating IP checksum to save a function call + + 2010-04-14: Simon Goldschmidt + * tcpip.h/.c, timers.c: Added an overridable define to get informed when the + tcpip_thread processes messages or timeouts to implement a watchdog. + + 2010-03-28: Simon Goldschmidt + * ip_frag.c: create a new (contiguous) PBUF_RAM for every outgoing + fragment if LWIP_NETIF_TX_SINGLE_PBUF==1 + + 2010-03-27: Simon Goldschmidt + * etharp.c: Speedup TX by moving code from find_entry to etharp_output/ + etharp_query to prevent unnecessary function calls (inspired by + patch #7135). + + 2010-03-20: Simon Goldschmidt + * opt.h, tcpip.c/.h: Added an option to disable tcpip_(un)timeout code + since the linker cannot do this automatically to save space. + + 2010-03-20: Simon Goldschmidt + * opt.h, etharp.c/.h: Added support for static ARP table entries + + 2010-03-14: Simon Goldschmidt + * tcp_impl.h, tcp_out.c, inet_chksum.h/.c: task #6849: Calculate checksum + when creating TCP segments, not when (re-)transmitting them. + + 2010-03-07: Simon Goldschmidt + * sockets.c: bug #28775 (select/event_callback: only check select_cb_list + on change) plus use SYS_LIGHTWEIGHT_PROT to protect the select code. + This should speed up receiving data on sockets as the select code in + event_callback is only executed when select is waiting. + + 2010-03-06: Simon Goldschmidt + * tcp_out.c: task #7013 (Create option to have all packets delivered to + netif->output in one piece): Always copy to try to create single pbufs + in tcp_write. + + 2010-03-06: Simon Goldschmidt + * api.h, api_lib.c, sockets.c: task #10167 (sockets: speed up TCP recv + by not allocating a netbuf): added function netconn_recv_tcp_pbuf() + for tcp netconns to receive pbufs, not netbufs; use that function + for tcp sockets. + + 2010-03-05: Jakob Ole Stoklundsen / Simon Goldschmidt + * opt.h, tcp.h, tcp_impl.h, tcp.c, tcp_in.c, tcp_out.c: task #7040: + Work on tcp_enqueue: Don't waste memory when chaining segments, + added option TCP_OVERSIZE to prevent creating many small pbufs when + calling tcp_write with many small blocks of data. Instead, pbufs are + allocated larger than needed and the space is used for later calls to + tcp_write. + + 2010-02-21: Simon Goldschmidt + * stats.c/.h: Added const char* name to mem- and memp-stats for easier + debugging. + + 2010-02-21: Simon Goldschmidt + * tcp.h (and usages), added tcp_impl.h: Splitted API and internal + implementation of tcp to make API usage cleare to application programmers + + 2010-02-14: Simon Goldschmidt/Stephane Lesage + * ip_addr.h: Improved some defines working on ip addresses, added faster + macro to copy addresses that cannot be NULL + + 2010-02-13: Simon Goldschmidt + * api.h, api_lib.c, api_msg.c, sockets.c: task #7865 (implement non- + blocking send operation) + + 2010-02-12: Simon Goldschmidt + * sockets.c/.h: Added a minimal version of posix fctl() to have a + standardised way to set O_NONBLOCK for nonblocking sockets. + + 2010-02-12: Simon Goldschmidt + * dhcp.c/.h, autoip.c/.h: task #10139 (Prefer statically allocated + memory): added autoip_set_struct() and dhcp_set_struct() to let autoip + and dhcp work with user-allocated structs instead of callin mem_malloc + + 2010-02-12: Simon Goldschmidt/Jeff Barber + * tcp.c/h: patch #6865 (SO_REUSEADDR for TCP): if pcb.so_options has + SOF_REUSEADDR set, allow binding to endpoint in TIME_WAIT + + 2010-02-12: Simon Goldschmidt + * sys layer: task #10139 (Prefer statically allocated memory): converted + mbox and semaphore functions to take pointers to sys_mbox_t/sys_sem_t; + converted sys_mbox_new/sys_sem_new to take pointers and return err_t; + task #7212: Add Mutex concept in sys_arch (define LWIP_COMPAT_MUTEX + to let sys.h use binary semaphores instead of mutexes - as before) + + 2010-02-09: Simon Goldschmidt (Simon Kallweit) + * timers.c/.h: Added function sys_restart_timeouts() from patch #7085 + (Restart system timeout handling) + + 2010-02-09: Simon Goldschmidt + * netif.c/.h, removed loopif.c/.h: task #10153 (Integrate loopif into + netif.c) - loopif does not have to be created by the port any more, + just define LWIP_HAVE_LOOPIF to 1. + + 2010-02-08: Simon Goldschmidt + * inet.h, ip_addr.c/.h: Added reentrant versions of inet_ntoa/ipaddr_ntoa + inet_ntoa_r/ipaddr_ntoa_r + + 2010-02-08: Simon Goldschmidt + * netif.h: Added netif_s/get_igmp_mac_filter() macros + + 2010-02-05: Simon Goldschmidt + * netif.h: Added function-like macros to get/set the hostname on a netif + + 2010-02-04: Simon Goldschmidt + * nearly every file: Replaced struct ip_addr by typedef ip_addr_t to + make changing the actual implementation behind the typedef easier. + + 2010-02-01: Simon Goldschmidt + * opt.h, memp_std.h, dns.h, netdb.c, memp.c: Let netdb use a memp pool + for allocating memory when getaddrinfo() is called. + + 2010-01-31: Simon Goldschmidt + * dhcp.h, dhcp.c: Reworked the code that parses DHCP options: parse + them once instead of parsing for every option. This also removes + the need for mem_malloc from dhcp_recv and makes it possible to + correctly retrieve the BOOTP file. + + 2010-01-30: simon Goldschmidt + * sockets.c: Use SYS_LIGHTWEIGHT_PROT instead of a semaphore to protect + the sockets array. + + 2010-01-29: Simon Goldschmidt (patch by Laura Garrett) + * api.h, api_msg.c, sockets.c: Added except set support in select + (patch #6860) + + 2010-01-29: Simon Goldschmidt (patch by Laura Garrett) + * api.h, sockets.h, err.h, api_lib.c, api_msg.c, sockets.c, err.c: + Add non-blocking support for connect (partly from patch #6860), + plus many cleanups in socket & netconn API. + + 2010-01-27: Simon Goldschmidt + * opt.h, tcp.h, init.c, api_msg.c: Added TCP_SNDQUEUELOWAT corresponding + to TCP_SNDLOWAT and added tcp_sndqueuelen() - this fixes bug #28605 + + 2010-01-26: Simon Goldschmidt + * snmp: Use memp pools for snmp instead of the heap; added 4 new pools. + + 2010-01-14: Simon Goldschmidt + * ppp.c/.h: Fixed bug #27856: PPP: Set netif link- and status-callback + by adding ppp_set_netif_statuscallback()/ppp_set_netif_linkcallback() + + 2010-01-13: Simon Goldschmidt + * mem.c: The heap now may be moved to user-defined memory by defining + LWIP_RAM_HEAP_POINTER as a void pointer to that memory's address + (patch #6966 and bug #26133) + + 2010-01-10: Simon Goldschmidt (Bill Auerbach) + * opt.h, memp.c: patch #6822 (Add option to place memory pools in + separate arrays) + + 2010-01-10: Simon Goldschmidt + * init.c, igmp.c: patch #6463 (IGMP - Adding Random Delay): added define + LWIP_RAND() for lwip-wide randomization (to be defined in cc.h) + + 2009-12-31: Simon Goldschmidt + * tcpip.c, init.c, memp.c, sys.c, memp_std.h, sys.h, tcpip.h + added timers.c/.h: Separated timer implementation from semaphore/mbox + implementation, moved timer implementation to timers.c/.h, timers are + now only called from tcpip_thread or by explicitly checking them. + (TASK#7235) + + 2009-12-27: Simon Goldschmidt + * opt.h, etharp.h/.c, init.c, tcpip.c: Added an additional option + LWIP_ETHERNET to support ethernet without ARP (necessary for pure PPPoE) + + + ++ Bugfixes: + + 2011-04-20: Simon Goldschmidt + * sys_arch.txt: sys_arch_timeouts() is not needed any more. + + 2011-04-13: Simon Goldschmidt + * tcp.c, udp.c: Fixed bug #33048 (Bad range for IP source port numbers) by + using ports in the IANA private/dynamic range (49152 through 65535). + + 2011-03-29: Simon Goldschmidt, patch by Emil Lhungdahl: + * etharp.h/.c: Fixed broken VLAN support. + + 2011-03-27: Simon Goldschmidt + * tcp.c: Fixed bug #32926 (TCP_RMV(&tcp_bound_pcbs) is called on unbound tcp + pcbs) by checking if the pcb was bound (local_port != 0). + + 2011-03-27: Simon Goldschmidt + * ppp.c: Fixed bug #32280 (ppp: a pbuf is freed twice) + + 2011-03-27: Simon Goldschmidt + * sockets.c: Fixed bug #32906: lwip_connect+lwip_send did not work for udp and + raw pcbs with LWIP_TCPIP_CORE_LOCKING==1. + + 2011-03-27: Simon Goldschmidt + * tcp_out.c: Fixed bug #32820 (Outgoing TCP connections created before route + is present never times out) by starting retransmission timer before checking + route. + + 2011-03-22: Simon Goldschmidt + * ppp.c: Fixed bug #32648 (PPP code crashes when terminating a link) by only + calling sio_read_abort() if the file descriptor is valid. + + 2011-03-14: Simon Goldschmidt + * err.h/.c, sockets.c, api_msg.c: fixed bug #31748 (Calling non-blocking connect + more than once can render a socket useless) since it mainly involves changing + "FATAL" classification of error codes: ERR_USE and ERR_ISCONN just aren't fatal. + + 2011-03-13: Simon Goldschmidt + * sockets.c: fixed bug #32769 (ESHUTDOWN is linux-specific) by fixing + err_to_errno_table (ERR_CLSD: ENOTCONN instead of ESHUTDOWN), ERR_ISCONN: + use EALRADY instead of -1 + + 2011-03-13: Simon Goldschmidt + * api_lib.c: netconn_accept: return ERR_ABRT instead of ERR_CLSD if the + connection has been aborted by err_tcp (since this is not a normal closing + procedure). + + 2011-03-13: Simon Goldschmidt + * tcp.c: tcp_bind: return ERR_VAL instead of ERR_ISCONN when trying to bind + with pcb->state != CLOSED + + 2011-02-17: Simon Goldschmidt + * rawapi.txt: Fixed bug #32561 tcp_poll argument definition out-of-order in + documentation + + 2011-02-17: Simon Goldschmidt + * many files: Added missing U/UL modifiers to fix 16-bit-arch portability. + + 2011-01-24: Simon Goldschmidt + * sockets.c: Fixed bug #31741: lwip_select seems to have threading problems + + 2010-12-02: Simon Goldschmidt + * err.h: Fixed ERR_IS_FATAL so that ERR_WOULDBLOCK is not fatal. + + 2010-11-23: Simon Goldschmidt + * api.h, api_lib.c, api_msg.c, sockets.c: netconn.recv_avail is only used for + LWIP_SO_RCVBUF and ioctl/FIONREAD. + + 2010-11-23: Simon Goldschmidt + * etharp.c: Fixed bug #31720: ARP-queueing: RFC 1122 recommends to queue at + least 1 packet -> ARP_QUEUEING==0 now queues the most recent packet. + + 2010-11-23: Simon Goldschmidt + * tcp_in.c: Fixed bug #30577: tcp_input: don't discard ACK-only packets after + refusing 'refused_data' again. + + 2010-11-22: Simon Goldschmidt + * sockets.c: Fixed bug #31590: getsockopt(... SO_ERROR ...) gives EINPROGRESS + after a successful nonblocking connection. + + 2010-11-22: Simon Goldschmidt + * etharp.c: Fixed bug #31722: IP packets sent with an AutoIP source addr + must be sent link-local + + 2010-11-22: Simon Goldschmidt + * timers.c: patch #7329: tcp_timer_needed prototype was ifdef'ed out for + LWIP_TIMERS==0 + + 2010-11-20: Simon Goldschmidt + * sockets.c: Fixed bug #31170: lwip_setsockopt() does not set socket number + + 2010-11-20: Simon Goldschmidt + * sockets.h: Fixed bug #31304: Changed SHUT_RD, SHUT_WR and SHUT_RDWR to + resemble other stacks. + + 2010-11-20: Simon Goldschmidt + * dns.c: Fixed bug #31535: TCP_SND_QUEUELEN must be at least 2 or else + no-copy TCP writes will never succeed. + + 2010-11-20: Simon Goldschmidt + * dns.c: Fixed bug #31701: Error return value from dns_gethostbyname() does + not match documentation: return ERR_ARG instead of ERR_VAL if not + initialized or wrong argument. + + 2010-10-20: Simon Goldschmidt + * sockets.h: Fixed bug #31385: sizeof(struct sockaddr) is 30 but should be 16 + + 2010-10-05: Simon Goldschmidt + * dhcp.c: Once again fixed #30038: DHCP/AutoIP cooperation failed when + replugging the network cable after an AutoIP address was assigned. + + 2010-08-10: Simon Goldschmidt + * tcp.c: Fixed bug #30728: tcp_new_port() did not check listen pcbs + + 2010-08-03: Simon Goldschmidt + * udp.c, raw.c: Don't chain empty pbufs when sending them (fixes bug #30625) + + 2010-08-01: Simon Goldschmidt (patch by Greg Renda) + * ppp.c: Applied patch #7264 (PPP protocols are rejected incorrectly on big + endian architectures) + + 2010-07-28: Simon Goldschmidt + * api_lib.c, api_msg.c, sockets.c, mib2.c: Fixed compilation with TCP or UDP + disabled. + + 2010-07-27: Simon Goldschmidt + * tcp.c: Fixed bug #30565 (tcp_connect() check bound list): that check did no + harm but never did anything + + 2010-07-21: Simon Goldschmidt + * ip.c: Fixed invalid fix for bug #30402 (CHECKSUM_GEN_IP_INLINE does not + add IP options) + + 2010-07-16: Kieran Mansley + * msg_in.c: Fixed SNMP ASN constant defines to not use ! operator + + 2010-07-10: Simon Goldschmidt + * ip.c: Fixed bug #30402: CHECKSUM_GEN_IP_INLINE does not add IP options + + 2010-06-30: Simon Goldschmidt + * api_msg.c: fixed bug #30300 (shutdown parameter was not initialized in + netconn_delete) + + 2010-06-28: Kieran Mansley + * timers.c remove unportable printing of C function pointers + + 2010-06-24: Simon Goldschmidt + * init.c, timers.c/.h, opt.h, memp_std.h: From patch #7221: added flag + NO_SYS_NO_TIMERS to drop timer support for NO_SYS==1 for easier upgrading + + 2010-06-24: Simon Goldschmidt + * api(_lib).c/.h, api_msg.c/.h, sockets.c/.h: Fixed bug #10088: Correctly + implemented shutdown at socket level. + + 2010-06-21: Simon Goldschmidt + * pbuf.c/.h, ip_frag.c/.h, opt.h, memp_std.h: Fixed bug #29361 (ip_frag has + problems with zero-copy DMA MACs) by adding custom pbufs and implementing + custom pbufs that reference other (original) pbufs. Additionally set + IP_FRAG_USES_STATIC_BUF=0 as default to be on the safe side. + + 2010-06-15: Simon Goldschmidt + * dhcp.c: Fixed bug #29970: DHCP endian issue parsing option responses + + 2010-06-14: Simon Goldschmidt + * autoip.c: Fixed bug #30039: AutoIP does not reuse previous addresses + + 2010-06-12: Simon Goldschmidt + * dhcp.c: Fixed bug #30038: dhcp_network_changed doesn't reset AUTOIP coop + state + + 2010-05-17: Simon Goldschmidt + * netdb.c: Correctly NULL-terminate h_addr_list + + 2010-05-16: Simon Goldschmidt + * def.h/.c: changed the semantics of LWIP_PREFIX_BYTEORDER_FUNCS to prevent + "symbol already defined" i.e. when linking to winsock + + 2010-05-05: Simon Goldschmidt + * def.h, timers.c: Fixed bug #29769 (sys_check_timeouts: sys_now() may + overflow) + + 2010-04-21: Simon Goldschmidt + * api_msg.c: Fixed bug #29617 (sometime cause stall on delete listening + connection) + + 2010-03-28: Luca Ceresoli + * ip_addr.c/.h: patch #7143: Add a few missing const qualifiers + + 2010-03-27: Luca Ceresoli + * mib2.c: patch #7130: remove meaningless const qualifiers + + 2010-03-26: Simon Goldschmidt + * tcp_out.c: Make LWIP_NETIF_TX_SINGLE_PBUF work for TCP, too + + 2010-03-26: Simon Goldschmidt + * various files: Fixed compiling with different options disabled (TCP/UDP), + triggered by bug #29345; don't allocate acceptmbox if LWIP_TCP is disabled + + 2010-03-25: Simon Goldschmidt + * sockets.c: Fixed bug #29332: lwip_select() processes readset incorrectly + + 2010-03-25: Simon Goldschmidt + * tcp_in.c, test_tcp_oos.c: Fixed bug #29080: Correctly handle remote side + overrunning our rcv_wnd in ooseq case. + + 2010-03-22: Simon Goldschmidt + * tcp.c: tcp_listen() did not copy the pcb's prio. + + 2010-03-19: Simon Goldschmidt + * snmp_msg.c: Fixed bug #29256: SNMP Trap address was not correctly set + + 2010-03-14: Simon Goldschmidt + * opt.h, etharp.h: Fixed bug #29148 (Incorrect PBUF_POOL_BUFSIZE for ports + where ETH_PAD_SIZE > 0) by moving definition of ETH_PAD_SIZE to opt.h + and basing PBUF_LINK_HLEN on it. + + 2010-03-08: Simon Goldschmidt + * netif.c, ipv4/ip.c: task #10241 (AutoIP: don't break existing connections + when assiging routable address): when checking incoming packets and + aborting existing connection on address change, filter out link-local + addresses. + + 2010-03-06: Simon Goldschmidt + * sockets.c: Fixed LWIP_NETIF_TX_SINGLE_PBUF for LWIP_TCPIP_CORE_LOCKING + + 2010-03-06: Simon Goldschmidt + * ipv4/ip.c: Don't try to forward link-local addresses + + 2010-03-06: Simon Goldschmidt + * etharp.c: Fixed bug #29087: etharp: don't send packets for LinkLocal- + addresses to gw + + 2010-03-05: Simon Goldschmidt + * dhcp.c: Fixed bug #29072: Correctly set ciaddr based on message-type + and state. + + 2010-03-05: Simon Goldschmidt + * api_msg.c: Correctly set TCP_WRITE_FLAG_MORE when netconn_write is split + into multiple calls to tcp_write. + + 2010-02-21: Simon Goldschmidt + * opt.h, mem.h, dns.c: task #10140: Remove DNS_USES_STATIC_BUF (keep + the implementation of DNS_USES_STATIC_BUF==1) + + 2010-02-20: Simon Goldschmidt + * tcp.h, tcp.c, tcp_in.c, tcp_out.c: Task #10088: Correctly implement + close() vs. shutdown(). Now the application does not get any more + recv callbacks after calling tcp_close(). Added tcp_shutdown(). + + 2010-02-19: Simon Goldschmidt + * mem.c/.h, pbuf.c: Renamed mem_realloc() to mem_trim() to prevent + confusion with realloc() + + 2010-02-15: Simon Goldschmidt/Stephane Lesage + * netif.c/.h: Link status does not depend on LWIP_NETIF_LINK_CALLBACK + (fixes bug #28899) + + 2010-02-14: Simon Goldschmidt + * netif.c: Fixed bug #28877 (Duplicate ARP gratuitous packet with + LWIP_NETIF_LINK_CALLBACK set on) by only sending if both link- and + admin-status of a netif are up + + 2010-02-14: Simon Goldschmidt + * opt.h: Disable ETHARP_TRUST_IP_MAC by default since it slows down packet + reception and is not really necessary + + 2010-02-14: Simon Goldschmidt + * etharp.c/.h: Fixed ARP input processing: only add a new entry if a + request was directed as us (RFC 826, Packet Reception), otherwise + only update existing entries; internalized some functions + + 2010-02-14: Simon Goldschmidt + * netif.h, etharp.c, tcpip.c: Fixed bug #28183 (ARP and TCP/IP cannot be + disabled on netif used for PPPoE) by adding a new netif flag + (NETIF_FLAG_ETHERNET) that tells the stack the device is an ethernet + device but prevents usage of ARP (so that ethernet_input can be used + for PPPoE). + + 2010-02-12: Simon Goldschmidt + * netif.c: netif_set_link_up/down: only do something if the link state + actually changes + + 2010-02-12: Simon Goldschmidt/Stephane Lesage + * api_msg.c: Fixed bug #28865 (Cannot close socket/netconn in non-blocking + connect) + + 2010-02-12: Simon Goldschmidt + * mem.h: Fixed bug #28866 (mem_realloc function defined in mem.h) + + 2010-02-09: Simon Goldschmidt + * api_lib.c, api_msg.c, sockets.c, api.h, api_msg.h: Fixed bug #22110 + (recv() makes receive window update for data that wasn't received by + application) + + 2010-02-09: Simon Goldschmidt/Stephane Lesage + * sockets.c: Fixed bug #28853 (lwip_recvfrom() returns 0 on receive time-out + or any netconn_recv() error) + + 2010-02-09: Simon Goldschmidt + * ppp.c: task #10154 (PPP: Update snmp in/out counters for tx/rx packets) + + 2010-02-09: Simon Goldschmidt + * netif.c: For loopback packets, adjust the stats- and snmp-counters + for the loopback netif. + + 2010-02-08: Simon Goldschmidt + * igmp.c/.h, ip.h: Moved most defines from igmp.h to igmp.c for clarity + since they are not used anywhere else. + + 2010-02-08: Simon Goldschmidt (Stéphane Lesage) + * igmp.c, igmp.h, stats.c, stats.h: Improved IGMP stats + (patch from bug #28798) + + 2010-02-08: Simon Goldschmidt (Stéphane Lesage) + * igmp.c: Fixed bug #28798 (Error in "Max Response Time" processing) and + another bug when LWIP_RAND() returns zero. + + 2010-02-04: Simon Goldschmidt + * nearly every file: Use macros defined in ip_addr.h (some of them new) + to work with IP addresses (preparation for bug #27352 - Change ip_addr + from struct to typedef (u32_t) - and better code). + + 2010-01-31: Simon Goldschmidt + * netif.c: Don't call the link-callback from netif_set_up/down() since + this invalidly retriggers DHCP. + + 2010-01-29: Simon Goldschmidt + * ip_addr.h, inet.h, def.h, inet.c, def.c, more: Cleanly separate the + portability file inet.h and its contents from the stack: moved htonX- + functions to def.h (and the new def.c - they are not ipv4 dependent), + let inet.h depend on ip_addr.h and not the other way round. + This fixes bug #28732. + + 2010-01-28: Kieran Mansley + * tcp.c: Ensure ssthresh >= 2*MSS + + 2010-01-27: Simon Goldschmidt + * tcp.h, tcp.c, tcp_in.c: Fixed bug #27871: Calling tcp_abort() in recv + callback can lead to accessing unallocated memory. As a consequence, + ERR_ABRT means the application has called tcp_abort()! + + 2010-01-25: Simon Goldschmidt + * snmp_structs.h, msg_in.c: Partly fixed bug #22070 (MIB_OBJECT_WRITE_ONLY + not implemented in SNMP): write-only or not-accessible are still + returned by getnext (though not by get) + + 2010-01-24: Simon Goldschmidt + * snmp: Renamed the private mib node from 'private' to 'mib_private' to + not use reserved C/C++ keywords + + 2010-01-23: Simon Goldschmidt + * sockets.c: Fixed bug #28716: select() returns 0 after waiting for less + than 1 ms + + 2010-01-21: Simon Goldschmidt + * tcp.c, api_msg.c: Fixed bug #28651 (tcp_connect: no callbacks called + if tcp_enqueue fails) both in raw- and netconn-API + + 2010-01-19: Simon Goldschmidt + * api_msg.c: Fixed bug #27316: netconn: Possible deadlock in err_tcp + + 2010-01-18: Iordan Neshev/Simon Goldschmidt + * src/netif/ppp: reorganised PPP sourcecode to 2.3.11 including some + bugfix backports from 2.4.x. + + 2010-01-18: Simon Goldschmidt + * mem.c: Fixed bug #28679: mem_realloc calculates mem_stats wrong + + 2010-01-17: Simon Goldschmidt + * api_lib.c, api_msg.c, (api_msg.h, api.h, sockets.c, tcpip.c): + task #10102: "netconn: clean up conn->err threading issues" by adding + error return value to struct api_msg_msg + + 2010-01-17: Simon Goldschmidt + * api.h, api_lib.c, sockets.c: Changed netconn_recv() and netconn_accept() + to return err_t (bugs #27709 and #28087) + + 2010-01-14: Simon Goldschmidt + * ...: Use typedef for function prototypes throughout the stack. + + 2010-01-13: Simon Goldschmidt + * api_msg.h/.c, api_lib.c: Fixed bug #26672 (close connection when receive + window = 0) by correctly draining recvmbox/acceptmbox + + 2010-01-11: Simon Goldschmidt + * pap.c: Fixed bug #13315 (PPP PAP authentication can result in + erroneous callbacks) by copying the code from recent pppd + + 2010-01-10: Simon Goldschmidt + * raw.c: Fixed bug #28506 (raw_bind should filter received packets) + + 2010-01-10: Simon Goldschmidt + * tcp.h/.c: bug #28127 (remove call to tcp_output() from tcp_ack(_now)()) + + 2010-01-08: Simon Goldschmidt + * sockets.c: Fixed bug #28519 (lwip_recvfrom bug with len > 65535) + + 2010-01-08: Simon Goldschmidt + * dns.c: Copy hostname for DNS_LOCAL_HOSTLIST_IS_DYNAMIC==1 since string + passed to dns_local_addhost() might be volatile + + 2010-01-07: Simon Goldschmidt + * timers.c, tcp.h: Call tcp_timer_needed() with NO_SYS==1, too + + 2010-01-06: Simon Goldschmidt + * netdb.h: Fixed bug #28496: missing include guards in netdb.h + + 2009-12-31: Simon Goldschmidt + * many ppp files: Reorganised PPP source code from ucip structure to pppd + structure to easily compare our code against the pppd code (around v2.3.1) + + 2009-12-27: Simon Goldschmidt + * tcp_in.c: Another fix for bug #28241 (ooseq processing) and adapted + unit test + + +(STABLE-1.3.2) + + ++ New features: + + 2009-10-27 Simon Goldschmidt/Stephan Lesage + * netifapi.c/.h: Added netifapi_netif_set_addr() + + 2009-10-07 Simon Goldschmidt/Fabian Koch + * api_msg.c, netbuf.c/.h, opt.h: patch #6888: Patch for UDP Netbufs to + support dest-addr and dest-port (optional: LWIP_NETBUF_RECVINFO) + + 2009-08-26 Simon Goldschmidt/Simon Kallweit + * slipif.c/.h: bug #26397: SLIP polling support + + 2009-08-25 Simon Goldschmidt + * opt.h, etharp.h/.c: task #9033: Support IEEE 802.1q tagged frame (VLAN), + New configuration options ETHARP_SUPPORT_VLAN and ETHARP_VLAN_CHECK. + + 2009-08-25 Simon Goldschmidt + * ip_addr.h, netdb.c: patch #6900: added define ip_ntoa(struct ip_addr*) + + 2009-08-24 Jakob Stoklund Olesen + * autoip.c, dhcp.c, netif.c: patch #6725: Teach AutoIP and DHCP to respond + to netif_set_link_up(). + + 2009-08-23 Simon Goldschmidt + * tcp.h/.c: Added function tcp_debug_state_str() to convert a tcp state + to a human-readable string. + + ++ Bugfixes: + + 2009-12-24: Kieran Mansley + * tcp_in.c Apply patches from Oleg Tyshev to improve OOS processing + (BUG#28241) + + 2009-12-06: Simon Goldschmidt + * ppp.h/.c: Fixed bug #27079 (Yet another leak in PPP): outpacket_buf can + be statically allocated (like in ucip) + + 2009-12-04: Simon Goldschmidt (patch by Ioardan Neshev) + * pap.c: patch #6969: PPP: missing PAP authentication UNTIMEOUT + + 2009-12-03: Simon Goldschmidt + * tcp.h, tcp_in.c, tcp_out.c: Fixed bug #28106: dup ack for fast retransmit + could have non-zero length + + 2009-12-02: Simon Goldschmidt + * tcp_in.c: Fixed bug #27904: TCP sends too many ACKs: delay resetting + tcp_input_pcb until after calling the pcb's callbacks + + 2009-11-29: Simon Goldschmidt + * tcp_in.c: Fixed bug #28054: Two segments with FIN flag on the out-of- + sequence queue, also fixed PBUF_POOL leak in the out-of-sequence code + + 2009-11-29: Simon Goldschmidt + * pbuf.c: Fixed bug #28064: pbuf_alloc(PBUF_POOL) is not thread-safe by + queueing a call into tcpip_thread to free ooseq-bufs if the pool is empty + + 2009-11-26: Simon Goldschmidt + * tcp.h: Fixed bug #28098: Nagle can prevent fast retransmit from sending + segment + + 2009-11-26: Simon Goldschmidt + * tcp.h, sockets.c: Fixed bug #28099: API required to disable Nagle + algorithm at PCB level + + 2009-11-22: Simon Goldschmidt + * tcp_out.c: Fixed bug #27905: FIN isn't combined with data on unsent + + 2009-11-22: Simon Goldschmidt (suggested by Bill Auerbach) + * tcp.c: tcp_alloc: prevent increasing stats.err for MEMP_TCP_PCB when + reusing time-wait pcb + + 2009-11-20: Simon Goldschmidt (patch by Albert Bartel) + * sockets.c: Fixed bug #28062: Data received directly after accepting + does not wake up select + + 2009-11-11: Simon Goldschmidt + * netdb.h: Fixed bug #27994: incorrect define for freeaddrinfo(addrinfo) + + 2009-10-30: Simon Goldschmidt + * opt.h: Increased default value for TCP_MSS to 536, updated default + value for TCP_WND to 4*TCP_MSS to keep delayed ACK working. + + 2009-10-28: Kieran Mansley + * tcp_in.c, tcp_out.c, tcp.h: re-work the fast retransmission code + to follow algorithm from TCP/IP Illustrated + + 2009-10-27: Kieran Mansley + * tcp_in.c: fix BUG#27445: grow cwnd with every duplicate ACK + + 2009-10-25: Simon Goldschmidt + * tcp.h: bug-fix in the TCP_EVENT_RECV macro (has to call tcp_recved if + pcb->recv is NULL to keep rcv_wnd correct) + + 2009-10-25: Simon Goldschmidt + * tcp_in.c: Fixed bug #26251: RST process in TIME_WAIT TCP state + + 2009-10-23: Simon Goldschmidt (David Empson) + * tcp.c: Fixed bug #27783: Silly window avoidance for small window sizes + + 2009-10-21: Simon Goldschmidt + * tcp_in.c: Fixed bug #27215: TCP sent() callback gives leading and + trailing 1 byte len (SYN/FIN) + + 2009-10-21: Simon Goldschmidt + * tcp_out.c: Fixed bug #27315: zero window probe and FIN + + 2009-10-19: Simon Goldschmidt + * dhcp.c/.h: Minor code simplification (don't store received pbuf, change + conditional code to assert where applicable), check pbuf length before + testing for valid reply + + 2009-10-19: Simon Goldschmidt + * dhcp.c: Removed most calls to udp_connect since they aren't necessary + when using udp_sendto_if() - always stay connected to IP_ADDR_ANY. + + 2009-10-16: Simon Goldschmidt + * ip.c: Fixed bug #27390: Source IP check in ip_input() causes it to drop + valid DHCP packets -> allow 0.0.0.0 as source address when LWIP_DHCP is + enabled + + 2009-10-15: Simon Goldschmidt (Oleg Tyshev) + * tcp_in.c: Fixed bug #27329: dupacks by unidirectional data transmit + + 2009-10-15: Simon Goldschmidt + * api_lib.c: Fixed bug #27709: conn->err race condition on netconn_recv() + timeout + + 2009-10-15: Simon Goldschmidt + * autoip.c: Fixed bug #27704: autoip starts with wrong address + LWIP_AUTOIP_CREATE_SEED_ADDR() returned address in host byte order instead + of network byte order + + 2009-10-11 Simon Goldschmidt (Jörg Kesten) + * tcp_out.c: Fixed bug #27504: tcp_enqueue wrongly concatenates segments + which are not consecutive when retransmitting unacked segments + + 2009-10-09 Simon Goldschmidt + * opt.h: Fixed default values of some stats to only be enabled if used + Fixes bug #27338: sys_stats is defined when NO_SYS = 1 + + 2009-08-30 Simon Goldschmidt + * ip.c: Fixed bug bug #27345: "ip_frag() does not use the LWIP_NETIF_LOOPBACK + function" by checking for loopback before calling ip_frag + + 2009-08-25 Simon Goldschmidt + * dhcp.c: fixed invalid dependency to etharp_query if DHCP_DOES_ARP_CHECK==0 + + 2009-08-23 Simon Goldschmidt + * ppp.c: bug #27078: Possible memory leak in pppInit() + + 2009-08-23 Simon Goldschmidt + * netdb.c, dns.c: bug #26657: DNS, if host name is "localhost", result + is error. + + 2009-08-23 Simon Goldschmidt + * opt.h, init.c: bug #26649: TCP fails when TCP_MSS > TCP_SND_BUF + Fixed wrong parenthesis, added check in init.c + + 2009-08-23 Simon Goldschmidt + * ppp.c: bug #27266: wait-state debug message in pppMain occurs every ms + + 2009-08-23 Simon Goldschmidt + * many ppp files: bug #27267: Added include to string.h where needed + + 2009-08-23 Simon Goldschmidt + * tcp.h: patch #6843: tcp.h macro optimization patch (for little endian) + + +(STABLE-1.3.1) + + ++ New features: + + 2009-05-10 Simon Goldschmidt + * opt.h, sockets.c, pbuf.c, netbuf.h, pbuf.h: task #7013: Added option + LWIP_NETIF_TX_SINGLE_PBUF to try to create transmit packets from only + one pbuf to help MACs that don't support scatter-gather DMA. + + 2009-05-09 Simon Goldschmidt + * icmp.h, icmp.c: Shrinked ICMP code, added option to NOT check icoming + ECHO pbuf for size (just use it): LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN + + 2009-05-05 Simon Goldschmidt, Jakob Stoklund Olesen + * ip.h, ip.c: Added ip_current_netif() & ip_current_header() to receive + extended info about the currently received packet. + + 2009-04-27 Simon Goldschmidt + * sys.h: Made SYS_LIGHTWEIGHT_PROT and sys_now() work with NO_SYS=1 + + 2009-04-25 Simon Goldschmidt + * mem.c, opt.h: Added option MEM_USE_POOLS_TRY_BIGGER_POOL to try the next + bigger malloc pool if one is empty (only usable with MEM_USE_POOLS). + + 2009-04-21 Simon Goldschmidt + * dns.c, init.c, dns.h, opt.h: task #7507, patch #6786: DNS supports static + hosts table. New configuration options DNS_LOCAL_HOSTLIST and + DNS_LOCAL_HOSTLIST_IS_DYNAMIC. Also, DNS_LOOKUP_LOCAL_EXTERN() can be defined + as an external function for lookup. + + 2009-04-15 Simon Goldschmidt + * dhcp.c: patch #6763: Global DHCP XID can be redefined to something more unique + + 2009-03-31 Kieran Mansley + * tcp.c, tcp_out.c, tcp_in.c, sys.h, tcp.h, opts.h: add support for + TCP timestamp options, off by default. Rework tcp_enqueue() to + take option flags rather than specified option data + + 2009-02-18 Simon Goldschmidt + * cc.h: Added printf formatter for size_t: SZT_F + + 2009-02-16 Simon Goldschmidt (patch by Rishi Khan) + * icmp.c, opt.h: patch #6539: (configurable) response to broadcast- and multicast + pings + + 2009-02-12 Simon Goldschmidt + * init.h: Added LWIP_VERSION to get the current version of the stack + + 2009-02-11 Simon Goldschmidt (suggested by Gottfried Spitaler) + * opt.h, memp.h/.c: added MEMP_MEM_MALLOC to use mem_malloc/mem_free instead + of the pool allocator (can save code size with MEM_LIBC_MALLOC if libc-malloc + is otherwise used) + + 2009-01-28 Jonathan Larmour (suggested by Bill Bauerbach) + * ipv4/inet_chksum.c, ipv4/lwip/inet_chksum.h: inet_chksum_pseudo_partial() + is only used by UDPLITE at present, so conditionalise it. + + 2008-12-03 Simon Goldschmidt (base on patch from Luca Ceresoli) + * autoip.c: checked in (slightly modified) patch #6683: Customizable AUTOIP + "seed" address. This should reduce AUTOIP conflicts if + LWIP_AUTOIP_CREATE_SEED_ADDR is overridden. + + 2008-10-02 Jonathan Larmour and Rishi Khan + * sockets.c (lwip_accept): Return EWOULDBLOCK if would block on non-blocking + socket. + + 2008-06-30 Simon Goldschmidt + * mem.c, opt.h, stats.h: fixed bug #21433: Calling mem_free/pbuf_free from + interrupt context isn't safe: LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT allows + mem_free to run between mem_malloc iterations. Added illegal counter for + mem stats. + + 2008-06-27 Simon Goldschmidt + * stats.h/.c, some other files: patch #6483: stats module improvement: + Added defines to display each module's statistic individually, added stats + defines for MEM, MEMP and SYS modules, removed (unused) rexmit counter. + + 2008-06-17 Simon Goldschmidt + * err.h: patch #6459: Made err_t overridable to use a more efficient type + (define LWIP_ERR_T in cc.h) + + 2008-06-17 Simon Goldschmidt + * slipif.c: patch #6480: Added a configuration option for slipif for symmetry + to loopif + + 2008-06-17 Simon Goldschmidt (patch by Luca Ceresoli) + * netif.c, loopif.c, ip.c, netif.h, loopif.h, opt.h: Checked in slightly + modified version of patch # 6370: Moved loopif code to netif.c so that + loopback traffic is supported on all netifs (all local IPs). + Added option to limit loopback packets for each netifs. + + + ++ Bugfixes: + 2009-08-12 Kieran Mansley + * tcp_in.c, tcp.c: Fix bug #27209: handle trimming of segments when + out of window or out of order properly + + 2009-08-12 Kieran Mansley + * tcp_in.c: Fix bug #27199: use snd_wl2 instead of snd_wl1 + + 2009-07-28 Simon Goldschmidt + * mem.h: Fixed bug #27105: "realloc() cannot replace mem_realloc()"s + + 2009-07-27 Kieran Mansley + * api.h api_msg.h netdb.h sockets.h: add missing #include directives + + 2009-07-09 Kieran Mansley + * api_msg.c, sockets.c, api.h: BUG23240 use signed counters for + recv_avail and don't increment counters until message successfully + sent to mbox + + 2009-06-25 Kieran Mansley + * api_msg.c api.h: BUG26722: initialise netconn write variables + in netconn_alloc + + 2009-06-25 Kieran Mansley + * tcp.h: BUG26879: set ret value in TCP_EVENT macros when function is not set + + 2009-06-25 Kieran Mansley + * tcp.c, tcp_in.c, tcp_out.c, tcp.h: BUG26301 and BUG26267: correct + simultaneous close behaviour, and make snd_nxt have the same meaning + as in the RFCs. + + 2009-05-12 Simon Goldschmidt + * etharp.h, etharp.c, netif.c: fixed bug #26507: "Gratuitous ARP depends on + arp_table / uses etharp_query" by adding etharp_gratuitous() + + 2009-05-12 Simon Goldschmidt + * ip.h, ip.c, igmp.c: bug #26487: Added ip_output_if_opt that can add IP options + to the IP header (used by igmp_ip_output_if) + + 2009-05-06 Simon Goldschmidt + * inet_chksum.c: On little endian architectures, use LWIP_PLATFORM_HTONS (if + defined) for SWAP_BYTES_IN_WORD to speed up checksumming. + + 2009-05-05 Simon Goldschmidt + * sockets.c: bug #26405: Prematurely released semaphore causes lwip_select() + to crash + + 2009-05-04 Simon Goldschmidt + * init.c: snmp was not initialized in lwip_init() + + 2009-05-04 Frédéric Bernon + * dhcp.c, netbios.c: Changes if IP_SOF_BROADCAST is enabled. + + 2009-05-03 Simon Goldschmidt + * tcp.h: bug #26349: Nagle algorithm doesn't send although segment is full + (and unsent->next == NULL) + + 2009-05-02 Simon Goldschmidt + * tcpip.h, tcpip.c: fixed tcpip_untimeout (does not need the time, broken after + 1.3.0 in CVS only) - fixes compilation of ppp_oe.c + + 2009-05-02 Simon Goldschmidt + * msg_in.c: fixed bug #25636: SNMPSET value is ignored for integer fields + + 2009-05-01 Simon Goldschmidt + * pap.c: bug #21680: PPP upap_rauthnak() drops legal NAK packets + + 2009-05-01 Simon Goldschmidt + * ppp.c: bug #24228: Memory corruption with PPP and DHCP + + 2009-04-29 Frédéric Bernon + * raw.c, udp.c, init.c, opt.h, ip.h, sockets.h: bug #26309: Implement the + SO(F)_BROADCAST filter for all API layers. Avoid the unindented reception + of broadcast packets even when this option wasn't set. Port maintainers + which want to enable this filter have to set IP_SOF_BROADCAST=1 in opt.h. + If you want this option also filter broadcast on recv operations, you also + have to set IP_SOF_BROADCAST_RECV=1 in opt.h. + + 2009-04-28 Simon Goldschmidt, Jakob Stoklund Olesen + * dhcp.c: patch #6721, bugs #25575, #25576: Some small fixes to DHCP and + DHCP/AUTOIP cooperation + + 2009-04-25 Simon Goldschmidt, Oleg Tyshev + * tcp_out.c: bug #24212: Deadlocked tcp_retransmit due to exceeded pcb->cwnd + Fixed by sorting the unsent and unacked queues (segments are inserted at the + right place in tcp_output and tcp_rexmit). + + 2009-04-25 Simon Goldschmidt + * memp.c, mem.c, memp.h, mem_std.h: bug #26213 "Problem with memory allocation + when debugging": memp_sizes contained the wrong sizes (including sanity + regions); memp pools for MEM_USE_POOLS were too small + + 2009-04-24 Simon Goldschmidt, Frédéric Bernon + * inet.c: patch #6765: Fix a small problem with the last changes (incorrect + behavior, with with ip address string not ended by a '\0', a space or a + end of line) + + 2009-04-19 Simon Goldschmidt + * rawapi.txt: Fixed bug #26069: Corrected documentation: if tcp_connect fails, + pcb->err is called, not pcb->connected (with an error code). + + 2009-04-19 Simon Goldschmidt + * tcp_out.c: Fixed bug #26236: "TCP options (timestamp) don't work with + no-copy-tcpwrite": deallocate option data, only concat segments with same flags + + 2009-04-19 Simon Goldschmidt + * tcp_out.c: Fixed bug #25094: "Zero-length pbuf" (options are now allocated + in the header pbuf, not the data pbuf) + + 2009-04-18 Simon Goldschmidt + * api_msg.c: fixed bug #25695: Segmentation fault in do_writemore() + + 2009-04-15 Simon Goldschmidt + * sockets.c: tried to fix bug #23559: lwip_recvfrom problem with tcp + + 2009-04-15 Simon Goldschmidt + * dhcp.c: task #9192: mem_free of dhcp->options_in and dhcp->msg_in + + 2009-04-15 Simon Goldschmidt + * ip.c, ip6.c, tcp_out.c, ip.h: patch #6808: Add a utility function + ip_hinted_output() (for smaller code mainly) + + 2009-04-15 Simon Goldschmidt + * inet.c: patch #6765: Supporting new line characters in inet_aton() + + 2009-04-15 Simon Goldschmidt + * dhcp.c: patch #6764: DHCP rebind and renew did not send hostnam option; + Converted constant OPTION_MAX_MSG_SIZE to netif->mtu, check if netif->mtu + is big enough in dhcp_start + + 2009-04-15 Simon Goldschmidt + * netbuf.c: bug #26027: netbuf_chain resulted in pbuf memory leak + + 2009-04-15 Simon Goldschmidt + * sockets.c, ppp.c: bug #25763: corrected 4 occurrences of SMEMCPY to MEMCPY + + 2009-04-15 Simon Goldschmidt + * sockets.c: bug #26121: set_errno can be overridden + + 2009-04-09 Kieran Mansley (patch from Luca Ceresoli ) + * init.c, opt.h: Patch#6774 TCP_QUEUE_OOSEQ breaks compilation when + LWIP_TCP==0 + + 2009-04-09 Kieran Mansley (patch from Roy Lee ) + * tcp.h: Patch#6802 Add do-while-clauses to those function like + macros in tcp.h + + 2009-03-31 Kieran Mansley + * tcp.c, tcp_in.c, tcp_out.c, tcp.h, opt.h: Rework the way window + updates are calculated and sent (BUG20515) + + * tcp_in.c: cope with SYN packets received during established states, + and retransmission of initial SYN. + + * tcp_out.c: set push bit correctly when tcp segments are merged + + 2009-03-27 Kieran Mansley + * tcp_out.c set window correctly on probes (correcting change made + yesterday) + + 2009-03-26 Kieran Mansley + * tcp.c, tcp_in.c, tcp.h: add tcp_abandon() to cope with dropping + connections where no reset required (bug #25622) + + * tcp_out.c: set TCP_ACK flag on keepalive and zero window probes + (bug #20779) + + 2009-02-18 Simon Goldschmidt (Jonathan Larmour and Bill Auerbach) + * ip_frag.c: patch #6528: the buffer used for IP_FRAG_USES_STATIC_BUF could be + too small depending on MEM_ALIGNMENT + + 2009-02-16 Simon Goldschmidt + * sockets.h/.c, api_*.h/.c: fixed arguments of socket functions to match the standard; + converted size argument of netconn_write to 'size_t' + + 2009-02-16 Simon Goldschmidt + * tcp.h, tcp.c: fixed bug #24440: TCP connection close problem on 64-bit host + by moving accept callback function pointer to TCP_PCB_COMMON + + 2009-02-12 Simon Goldschmidt + * dhcp.c: fixed bug #25345 (DHCPDECLINE is sent with "Maximum message size" + option) + + 2009-02-11 Simon Goldschmidt + * dhcp.c: fixed bug #24480 (releasing old udp_pdb and pbuf in dhcp_start) + + 2009-02-11 Simon Goldschmidt + * opt.h, api_msg.c: added configurable default valud for netconn->recv_bufsize: + RECV_BUFSIZE_DEFAULT (fixes bug #23726: pbuf pool exhaustion on slow recv()) + + 2009-02-10 Simon Goldschmidt + * tcp.c: fixed bug #25467: Listen backlog is not reset on timeout in SYN_RCVD: + Accepts_pending is decrease on a corresponding listen pcb when a connection + in state SYN_RCVD is close. + + 2009-01-28 Jonathan Larmour + * pbuf.c: reclaim pbufs from TCP out-of-sequence segments if we run + out of pool pbufs. + + 2008-12-19 Simon Goldschmidt + * many files: patch #6699: fixed some warnings on platform where sizeof(int) == 2 + + 2008-12-10 Tamas Somogyi, Frédéric Bernon + * sockets.c: fixed bug #25051: lwip_recvfrom problem with udp: fromaddr and + port uses deleted netbuf. + + 2008-10-18 Simon Goldschmidt + * tcp_in.c: fixed bug ##24596: Vulnerability on faulty TCP options length + in tcp_parseopt + + 2008-10-15 Simon Goldschmidt + * ip_frag.c: fixed bug #24517: IP reassembly crashes on unaligned IP headers + by packing the struct ip_reass_helper. + + 2008-10-03 David Woodhouse, Jonathan Larmour + * etharp.c (etharp_arp_input): Fix type aliasing problem copying ip address. + + 2008-10-02 Jonathan Larmour + * dns.c: Hard-code structure sizes, to avoid issues on some compilers where + padding is included. + + 2008-09-30 Jonathan Larmour + * sockets.c (lwip_accept): check addr isn't NULL. If it's valid, do an + assertion check that addrlen isn't NULL. + + 2008-09-30 Jonathan Larmour + * tcp.c: Fix bug #24227, wrong error message in tcp_bind. + + 2008-08-26 Simon Goldschmidt + * inet.h, ip_addr.h: fixed bug #24132: Cross-dependency between ip_addr.h and + inet.h -> moved declaration of struct in_addr from ip_addr.h to inet.h + + 2008-08-14 Simon Goldschmidt + * api_msg.c: fixed bug #23847: do_close_internal references freed memory (when + tcp_close returns != ERR_OK) + + 2008-07-08 Frédéric Bernon + * stats.h: Fix some build bugs introduced with patch #6483 (missing some parameters + in macros, mainly if MEM_STATS=0 and MEMP_STATS=0). + + 2008-06-24 Jonathan Larmour + * tcp_in.c: Fix for bug #23693 as suggested by Art R. Ensure cseg is unused + if tcp_seg_copy fails. + + 2008-06-17 Simon Goldschmidt + * inet_chksum.c: Checked in some ideas of patch #6460 (loop optimizations) + and created defines for swapping bytes and folding u32 to u16. + + 2008-05-30 Kieran Mansley + * tcp_in.c Remove redundant "if" statement, and use real rcv_wnd + rather than rcv_ann_wnd when deciding if packets are in-window. + Contributed by + + 2008-05-30 Kieran Mansley + * mem.h: Fix BUG#23254. Change macro definition of mem_* to allow + passing as function pointers when MEM_LIBC_MALLOC is defined. + + 2008-05-09 Jonathan Larmour + * err.h, err.c, sockets.c: Fix bug #23119: Reorder timeout error code to + stop it being treated as a fatal error. + + 2008-04-15 Simon Goldschmidt + * dhcp.c: fixed bug #22804: dhcp_stop doesn't clear NETIF_FLAG_DHCP + (flag now cleared) + + 2008-03-27 Simon Goldschmidt + * mem.c, tcpip.c, tcpip.h, opt.h: fixed bug #21433 (Calling mem_free/pbuf_free + from interrupt context isn't safe): set LWIP_USE_HEAP_FROM_INTERRUPT to 1 + in lwipopts.h or use pbuf_free_callback(p)/mem_free_callback(m) to free pbufs + or heap memory from interrupt context + + 2008-03-26 Simon Goldschmidt + * tcp_in.c, tcp.c: fixed bug #22249: division by zero could occur if a remote + host sent a zero mss as TCP option. + + +(STABLE-1.3.0) + + ++ New features: + + 2008-03-10 Jonathan Larmour + * inet_chksum.c: Allow choice of one of the sample algorithms to be + made from lwipopts.h. Fix comment on how to override LWIP_CHKSUM. + + 2008-01-22 Frédéric Bernon + * tcp.c, tcp_in.c, tcp.h, opt.h: Rename LWIP_CALCULATE_EFF_SEND_MSS in + TCP_CALCULATE_EFF_SEND_MSS to have coherent TCP options names. + + 2008-01-14 Frédéric Bernon + * rawapi.txt, api_msg.c, tcp.c, tcp_in.c, tcp.h: changes for task #7675 "Enable + to refuse data on a TCP_EVENT_RECV call". Important, behavior changes for the + tcp_recv callback (see rawapi.txt). + + 2008-01-14 Frédéric Bernon, Marc Chaland + * ip.c: Integrate patch #6369" ip_input : checking before realloc". + + 2008-01-12 Frédéric Bernon + * tcpip.h, tcpip.c, api.h, api_lib.c, api_msg.c, sockets.c: replace the field + netconn::sem per netconn::op_completed like suggested for the task #7490 + "Add return value to sys_mbox_post". + + 2008-01-12 Frédéric Bernon + * api_msg.c, opt.h: replace DEFAULT_RECVMBOX_SIZE per DEFAULT_TCP_RECVMBOX_SIZE, + DEFAULT_UDP_RECVMBOX_SIZE and DEFAULT_RAW_RECVMBOX_SIZE (to optimize queues + sizes), like suggested for the task #7490 "Add return value to sys_mbox_post". + + 2008-01-10 Frédéric Bernon + * tcpip.h, tcpip.c: add tcpip_callback_with_block function for the task #7490 + "Add return value to sys_mbox_post". tcpip_callback is always defined as + "blocking" ("block" parameter = 1). + + 2008-01-10 Frédéric Bernon + * tcpip.h, tcpip.c, api.h, api_lib.c, api_msg.c, sockets.c: replace the field + netconn::mbox (sys_mbox_t) per netconn::sem (sys_sem_t) for the task #7490 + "Add return value to sys_mbox_post". + + 2008-01-05 Frédéric Bernon + * sys_arch.txt, api.h, api_lib.c, api_msg.h, api_msg.c, tcpip.c, sys.h, opt.h: + Introduce changes for task #7490 "Add return value to sys_mbox_post" with some + modifications in the sys_mbox api: sys_mbox_new take a "size" parameters which + indicate the number of pointers query by the mailbox. There is three defines + in opt.h to indicate sizes for tcpip::mbox, netconn::recvmbox, and for the + netconn::acceptmbox. Port maintainers, you can decide to just add this new + parameter in your implementation, but to ignore it to keep the previous behavior. + The new sys_mbox_trypost function return a value to know if the mailbox is + full or if the message is posted. Take a look to sys_arch.txt for more details. + This new function is used in tcpip_input (so, can be called in an interrupt + context since the function is not blocking), and in recv_udp and recv_raw. + + 2008-01-04 Frédéric Bernon, Simon Goldschmidt, Jonathan Larmour + * rawapi.txt, api.h, api_lib.c, api_msg.h, api_msg.c, sockets.c, tcp.h, tcp.c, + tcp_in.c, init.c, opt.h: rename backlog options with TCP_ prefix, limit the + "backlog" parameter in an u8_t, 0 is interpreted as "smallest queue", add + documentation in the rawapi.txt file. + + 2007-12-31 Kieran Mansley (based on patch from Per-Henrik Lundbolm) + * tcp.c, tcp_in.c, tcp_out.c, tcp.h: Add TCP persist timer + + 2007-12-31 Frédéric Bernon, Luca Ceresoli + * autoip.c, etharp.c: ip_addr.h: Integrate patch #6348: "Broadcast ARP packets + in autoip". The change in etharp_raw could be removed, since all calls to + etharp_raw use ethbroadcast for the "ethdst_addr" parameter. But it could be + wrong in the future. + + 2007-12-30 Frédéric Bernon, Tom Evans + * ip.c: Fix bug #21846 "LwIP doesn't appear to perform any IP Source Address + Filtering" reported by Tom Evans. + + 2007-12-21 Frédéric Bernon, Simon Goldschmidt, Jonathan Larmour + * tcp.h, opt.h, api.h, api_msg.h, tcp.c, tcp_in.c, api_lib.c, api_msg.c, + sockets.c, init.c: task #7252: Implement TCP listen backlog: Warning: raw API + applications have to call 'tcp_accepted(pcb)' in their accept callback to + keep accepting new connections. + + 2007-12-13 Frédéric Bernon + * api_msg.c, err.h, err.c, sockets.c, dns.c, dns.h: replace "enum dns_result" + by err_t type. Add a new err_t code "ERR_INPROGRESS". + + 2007-12-12 Frédéric Bernon + * dns.h, dns.c, opt.h: move DNS options to the "right" place. Most visibles + are the one which have ram usage. + + 2007-12-05 Frédéric Bernon + * netdb.c: add a LWIP_DNS_API_HOSTENT_STORAGE option to decide to use a static + set of variables (=0) or a local one (=1). In this last case, your port should + provide a function "struct hostent* sys_thread_hostent( struct hostent* h)" + which have to do a copy of "h" and return a pointer ont the "per-thread" copy. + + 2007-12-03 Simon Goldschmidt + * ip.c: ip_input: check if a packet is for inp first before checking all other + netifs on netif_list (speeds up packet receiving in most cases) + + 2007-11-30 Simon Goldschmidt + * udp.c, raw.c: task #7497: Sort lists (pcb, netif, ...) for faster access + UDP: move a (connected) pcb selected for input to the front of the list of + pcbs so that it is found faster next time. Same for RAW pcbs that have eaten + a packet. + + 2007-11-28 Simon Goldschmidt + * etharp.c, stats.c, stats.h, opt.h: Introduced ETHARP_STATS + + 2007-11-25 Simon Goldschmidt + * dhcp.c: dhcp_unfold_reply() uses pbuf_copy_partial instead of its own copy + algorithm. + + 2007-11-24 Simon Goldschmidt + * netdb.h, netdb.c, sockets.h/.c: Moved lwip_gethostbyname from sockets.c + to the new file netdb.c; included lwip_getaddrinfo. + + 2007-11-21 Simon Goldschmidt + * tcp.h, opt.h, tcp.c, tcp_in.c: implemented calculating the effective send-mss + based on the MTU of the netif used to send. Enabled by default. Disable by + setting LWIP_CALCULATE_EFF_SEND_MSS to 0. This fixes bug #21492. + + 2007-11-19 Frédéric Bernon + * api_msg.c, dns.h, dns.c: Implement DNS_DOES_NAME_CHECK option (check if name + received match the name query), implement DNS_USES_STATIC_BUF (the place where + copy dns payload to parse the response), return an error if there is no place + for a new query, and fix some minor problems. + + 2007-11-16 Simon Goldschmidt + * new files: ipv4/inet.c, ipv4/inet_chksum.c, ipv6/inet6.c + removed files: core/inet.c, core/inet6.c + Moved inet files into ipv4/ipv6 directory; splitted inet.c/inet.h into + inet and chksum part; changed includes in all lwIP files as appropriate + + 2007-11-16 Simon Goldschmidt + * api.h, api_msg.h, api_lib.c, api_msg.c, socket.h, socket.c: Added sequential + dns resolver function for netconn api (netconn_gethostbyname) and socket api + (gethostbyname/gethostbyname_r). + + 2007-11-15 Jim Pettinato, Frédéric Bernon + * opt.h, init.c, tcpip.c, dhcp.c, dns.h, dns.c: add DNS client for simple name + requests with RAW api interface. Initialization is done in lwip_init() with + build time options. DNS timer is added in tcpip_thread context. DHCP can set + DNS server ip addresses when options are received. You need to set LWIP_DNS=1 + in your lwipopts.h file (LWIP_DNS=0 in opt.h). DNS_DEBUG can be set to get + some traces with LWIP_DEBUGF. Sanity check have been added. There is a "todo" + list with points to improve. + + 2007-11-06 Simon Goldschmidt + * opt.h, mib2.c: Patch #6215: added ifAdminStatus write support (if explicitly + enabled by defining SNMP_SAFE_REQUESTS to 0); added code to check link status + for ifOperStatus if LWIP_NETIF_LINK_CALLBACK is defined. + + 2007-11-06 Simon Goldschmidt + * api.h, api_msg.h and dependent files: Task #7410: Removed the need to include + core header files in api.h (ip/tcp/udp/raw.h) to hide the internal + implementation from netconn api applications. + + 2007-11-03 Frédéric Bernon + * api.h, api_lib.c, api_msg.c, sockets.c, opt.h: add SO_RCVBUF option for UDP & + RAW netconn. You need to set LWIP_SO_RCVBUF=1 in your lwipopts.h (it's disabled + by default). Netconn API users can use the netconn_recv_bufsize macro to access + it. This is a first release which have to be improve for TCP. Note it used the + netconn::recv_avail which need to be more "thread-safe" (note there is already + the problem for FIONREAD with lwip_ioctl/ioctlsocket). + + 2007-11-01 Frédéric Bernon, Marc Chaland + * sockets.h, sockets.c, api.h, api_lib.c, api_msg.h, api_msg.c, tcp.h, tcp_out.c: + Integrate "patch #6250 : MSG_MORE flag for send". MSG_MORE is used at socket api + layer, NETCONN_MORE at netconn api layer, and TCP_WRITE_FLAG_MORE at raw api + layer. This option enable to delayed TCP PUSH flag on multiple "write" calls. + Note that previous "copy" parameter for "write" APIs is now called "apiflags". + + 2007-10-24 Frédéric Bernon + * api.h, api_lib.c, api_msg.c: Add macro API_EVENT in the same spirit than + TCP_EVENT_xxx macros to get a code more readable. It could also help to remove + some code (like we have talk in "patch #5919 : Create compile switch to remove + select code"), but it could be done later. + + 2007-10-08 Simon Goldschmidt + * many files: Changed initialization: many init functions are not needed any + more since we now rely on the compiler initializing global and static + variables to zero! + + 2007-10-06 Simon Goldschmidt + * ip_frag.c, memp.c, mib2.c, ip_frag.h, memp_std.h, opt.h: Changed IP_REASSEMBLY + to enqueue the received pbufs so that multiple packets can be reassembled + simultaneously and no static reassembly buffer is needed. + + 2007-10-05 Simon Goldschmidt + * tcpip.c, etharp.h, etharp.c: moved ethernet_input from tcpip.c to etharp.c so + all netifs (or ports) can use it. + + 2007-10-05 Frédéric Bernon + * netifapi.h, netifapi.c: add function netifapi_netif_set_default. Change the + common function to reduce a little bit the footprint (for all functions using + only the "netif" parameter). + + 2007-10-03 Frédéric Bernon + * netifapi.h, netifapi.c: add functions netifapi_netif_set_up, netifapi_netif_set_down, + netifapi_autoip_start and netifapi_autoip_stop. Use a common function to reduce + a little bit the footprint (for all functions using only the "netif" parameter). + + 2007-09-15 Frédéric Bernon + * udp.h, udp.c, sockets.c: Changes for "#20503 IGMP Improvement". Add IP_MULTICAST_IF + option in socket API, and a new field "multicast_ip" in "struct udp_pcb" (for + netconn and raw API users), only if LWIP_IGMP=1. Add getsockopt processing for + IP_MULTICAST_TTL and IP_MULTICAST_IF. + + 2007-09-10 Frédéric Bernon + * snmp.h, mib2.c: enable to remove SNMP timer (which consumne several cycles + even when it's not necessary). snmp_agent.txt tell to call snmp_inc_sysuptime() + each 10ms (but, it's intrusive if you use sys_timeout feature). Now, you can + decide to call snmp_add_sysuptime(100) each 1000ms (which is bigger "step", but + call to a lower frequency). Or, you can decide to not call snmp_inc_sysuptime() + or snmp_add_sysuptime(), and to define the SNMP_GET_SYSUPTIME(sysuptime) macro. + This one is undefined by default in mib2.c. SNMP_GET_SYSUPTIME is called inside + snmp_get_sysuptime(u32_t *value), and enable to change "sysuptime" value only + when it's queried (any direct call to "sysuptime" is changed by a call to + snmp_get_sysuptime). + + 2007-09-09 Frédéric Bernon, Bill Florac + * igmp.h, igmp.c, netif.h, netif.c, ip.c: To enable to have interfaces with IGMP, + and others without it, there is a new NETIF_FLAG_IGMP flag to set in netif->flags + if you want IGMP on an interface. igmp_stop() is now called inside netif_remove(). + igmp_report_groups() is now called inside netif_set_link_up() (need to have + LWIP_NETIF_LINK_CALLBACK=1) to resend reports once the link is up (avoid to wait + the next query message to receive the matching multicast streams). + + 2007-09-08 Frédéric Bernon + * sockets.c, ip.h, api.h, tcp.h: declare a "struct ip_pcb" which only contains + IP_PCB. Add in the netconn's "pcb" union a "struct ip_pcb *ip;" (no size change). + Use this new field to access to common pcb fields (ttl, tos, so_options, etc...). + Enable to access to these fields with LWIP_TCP=0. + + 2007-09-05 Frédéric Bernon + * udp.c, ipv4/icmp.c, ipv4/ip.c, ipv6/icmp.c, ipv6/ip6.c, ipv4/icmp.h, + ipv6/icmp.h, opt.h: Integrate "task #7272 : LWIP_ICMP option". The new option + LWIP_ICMP enable/disable ICMP module inside the IP stack (enable per default). + Be careful, disabling ICMP make your product non-compliant to RFC1122, but + help to reduce footprint, and to reduce "visibility" on the Internet. + + 2007-09-05 Frédéric Bernon, Bill Florac + * opt.h, sys.h, tcpip.c, slipif.c, ppp.c, sys_arch.txt: Change parameters list + for sys_thread_new (see "task #7252 : Create sys_thread_new_ex()"). Two new + parameters have to be provided: a task name, and a task stack size. For this + one, since it's platform dependant, you could define the best one for you in + your lwipopts.h. For port maintainers, you can just add these new parameters + in your sys_arch.c file, and but it's not mandatory, use them in your OS + specific functions. + + 2007-09-05 Frédéric Bernon + * inet.c, autoip.c, msg_in.c, msg_out.c, init.c: Move some build time checkings + inside init.c for task #7142 "Sanity check user-configurable values". + + 2007-09-04 Frédéric Bernon, Bill Florac + * igmp.h, igmp.c, memp_std.h, memp.c, init.c, opt.h: Replace mem_malloc call by + memp_malloc, and use a new MEMP_NUM_IGMP_GROUP option (see opt.h to define the + value). It will avoid potential fragmentation problems, use a counter to know + how many times a group is used on an netif, and free it when all applications + leave it. MEMP_NUM_IGMP_GROUP got 8 as default value (and init.c got a sanity + check if LWIP_IGMP!=0). + + 2007-09-03 Frédéric Bernon + * igmp.h, igmp.c, sockets.c, api_msg.c: Changes for "#20503 IGMP Improvement". + Initialize igmp_mac_filter to NULL in netif_add (this field should be set in + the netif's "init" function). Use the "imr_interface" field (for socket layer) + and/or the "interface" field (for netconn layer), for join/leave operations. + The igmp_join/leavegroup first parameter change from a netif to an ipaddr. + This field could be a netif's ipaddr, or "any" (same meaning than ip_addr_isany). + + 2007-08-30 Frédéric Bernon + * Add netbuf.h, netbuf.c, Change api.h, api_lib.c: #7249 "Split netbuf functions + from api/api_lib". Now netbuf API is independant of netconn, and can be used + with other API (application based on raw API, or future "socket2" API). Ports + maintainers just have to add src/api/netbuf.c in their makefile/projects. + + 2007-08-30 Frédéric Bernon, Jonathan Larmour + * init.c: Add first version of lwip_sanity_check for task #7142 "Sanity check + user-configurable values". + + 2007-08-29 Frédéric Bernon + * igmp.h, igmp.c, tcpip.c, init.c, netif.c: change igmp_init and add igmp_start. + igmp_start is call inside netif_add. Now, igmp initialization is in the same + spirit than the others modules. Modify some IGMP debug traces. + + 2007-08-29 Frédéric Bernon + * Add init.h, init.c, Change opt.h, tcpip.c: Task #7213 "Add a lwip_init function" + Add lwip_init function to regroup all modules initializations, and to provide + a place to add code for task #7142 "Sanity check user-configurable values". + Ports maintainers should remove direct initializations calls from their code, + and add init.c in their makefiles. Note that lwip_init() function is called + inside tcpip_init, but can also be used by raw api users since all calls are + disabled when matching options are disabled. Also note that their is new options + in opt.h, you should configure in your lwipopts.h (they are enabled per default). + + 2007-08-26 Marc Boucher + * api_msg.c: do_close_internal(): Reset the callbacks and arg (conn) to NULL + since they can under certain circumstances be called with an invalid conn + pointer after the connection has been closed (and conn has been freed). + + 2007-08-25 Frédéric Bernon (Artem Migaev's Patch) + * netif.h, netif.c: Integrate "patch #6163 : Function to check if link layer is up". + Add a netif_is_link_up() function if LWIP_NETIF_LINK_CALLBACK option is set. + + 2007-08-22 Frédéric Bernon + * netif.h, netif.c, opt.h: Rename LWIP_NETIF_CALLBACK in LWIP_NETIF_STATUS_CALLBACK + to be coherent with new LWIP_NETIF_LINK_CALLBACK option before next release. + + 2007-08-22 Frédéric Bernon + * tcpip.h, tcpip.c, ethernetif.c, opt.h: remove options ETHARP_TCPIP_INPUT & + ETHARP_TCPIP_ETHINPUT, now, only "ethinput" code is supported, even if the + name is tcpip_input (we keep the name of 1.2.0 function). + + 2007-08-17 Jared Grubb + * memp_std.h, memp.h, memp.c, mem.c, stats.c: (Task #7136) Centralize mempool + settings into new memp_std.h and optional user file lwippools.h. This adds + more dynamic mempools, and allows the user to create an arbitrary number of + mempools for mem_malloc. + + 2007-08-16 Marc Boucher + * api_msg.c: Initialize newconn->state to NETCONN_NONE in accept_function; + otherwise it was left to NETCONN_CLOSE and sent_tcp() could prematurely + close the connection. + + 2007-08-16 Marc Boucher + * sockets.c: lwip_accept(): check netconn_peer() error return. + + 2007-08-16 Marc Boucher + * mem.c, mem.h: Added mem_calloc(). + + 2007-08-16 Marc Boucher + * tcpip.c, tcpip.h memp.c, memp.h: Added distinct memp (MEMP_TCPIP_MSG_INPKT) + for input packets to prevent floods from consuming all of MEMP_TCPIP_MSG + and starving other message types. + Renamed MEMP_TCPIP_MSG to MEMP_TCPIP_MSG_API + + 2007-08-16 Marc Boucher + * pbuf.c, pbuf.h, etharp.c, tcp_in.c, sockets.c: Split pbuf flags in pbuf + type and flgs (later renamed to flags). + Use enum pbuf_flag as pbuf_type. Renumber PBUF_FLAG_*. + Improved lwip_recvfrom(). TCP push now propagated. + + 2007-08-16 Marc Boucher + * ethernetif.c, contrib/ports/various: ethbroadcast now a shared global + provided by etharp. + + 2007-08-16 Marc Boucher + * ppp_oe.c ppp_oe.h, auth.c chap.c fsm.c lcp.c ppp.c ppp.h, + etharp.c ethernetif.c, etharp.h, opt.h tcpip.h, tcpip.c: + Added PPPoE support and various PPP improvements. + + 2007-07-25 Simon Goldschmidt + * api_lib.c, ip_frag.c, pbuf.c, api.h, pbuf.h: Introduced pbuf_copy_partial, + making netbuf_copy_partial use this function. + + 2007-07-25 Simon Goldschmidt + * tcp_in.c: Fix bug #20506: Slow start / initial congestion window starts with + 2 * mss (instead of 1 * mss previously) to comply with some newer RFCs and + other stacks. + + 2007-07-13 Jared Grubb (integrated by Frédéric Bernon) + * opt.h, netif.h, netif.c, ethernetif.c: Add new configuration option to add + a link callback in the netif struct, and functions to handle it. Be carefull + for port maintainers to add the NETIF_FLAG_LINK_UP flag (like in ethernetif.c) + if you want to be sure to be compatible with future changes... + + 2007-06-30 Frédéric Bernon + * sockets.h, sockets.c: Implement MSG_PEEK flag for recv/recvfrom functions. + + 2007-06-21 Simon Goldschmidt + * etharp.h, etharp.c: Combined etharp_request with etharp_raw for both + LWIP_AUTOIP =0 and =1 to remove redundant code. + + 2007-06-21 Simon Goldschmidt + * mem.c, memp.c, mem.h, memp.h, opt.h: task #6863: Introduced the option + MEM_USE_POOLS to use 4 pools with different sized elements instead of a + heap. This both prevents memory fragmentation and gives a higher speed + at the cost of more memory consumption. Turned off by default. + + 2007-06-21 Simon Goldschmidt + * api_lib.c, api_msg.c, api.h, api_msg.h: Converted the length argument of + netconn_write (and therefore also api_msg_msg.msg.w.len) from u16_t into + int to be able to send a bigger buffer than 64K with one time (mainly + used from lwip_send). + + 2007-06-21 Simon Goldschmidt + * tcp.h, api_msg.c: Moved the nagle algorithm from netconn_write/do_write + into a define (tcp_output_nagle) in tcp.h to provide it to raw api users, too. + + 2007-06-21 Simon Goldschmidt + * api.h, api_lib.c, api_msg.c: Fixed bug #20021: Moved sendbuf-processing in + netconn_write from api_lib.c to api_msg.c to also prevent multiple context- + changes on low memory or empty send-buffer. + + 2007-06-18 Simon Goldschmidt + * etharp.c, etharp.h: Changed etharp to use a defined hardware address length + of 6 to avoid loading netif->hwaddr_len every time (since this file is only + used for ethernet and struct eth_addr already had a defined length of 6). + + 2007-06-17 Simon Goldschmidt + * sockets.c, sockets.h: Implemented socket options SO_NO_CHECK for UDP sockets + to disable UDP checksum generation on transmit. + + 2007-06-13 Frédéric Bernon, Simon Goldschmidt + * debug.h, api_msg.c: change LWIP_ERROR to use it to check errors like invalid + pointers or parameters, and let the possibility to redefined it in cc.h. Use + this macro to check "conn" parameter in api_msg.c functions. + + 2007-06-11 Simon Goldschmidt + * sockets.c, sockets.h: Added UDP lite support for sockets + + 2007-06-10 Simon Goldschmidt + * udp.h, opt.h, api_msg.c, ip.c, udp.c: Included switch LWIP_UDPLITE (enabled + by default) to switch off UDP-Lite support if not needed (reduces udp.c code + size) + + 2007-06-09 Dominik Spies (integrated by Frédéric Bernon) + * autoip.h, autoip.c, dhcp.h, dhcp.c, netif.h, netif.c, etharp.h, etharp.c, opt.h: + AutoIP implementation available for IPv4, with new options LWIP_AUTOIP and + LWIP_DHCP_AUTOIP_COOP if you want to cooperate with DHCP. Some tips to adapt + (see TODO mark in the source code). + + 2007-06-09 Simon Goldschmidt + * etharp.h, etharp.c, ethernetif.c: Modified order of parameters for + etharp_output() to match netif->output so etharp_output() can be used + directly as netif->output to save one function call. + + 2007-06-08 Simon Goldschmidt + * netif.h, ethernetif.c, slipif.c, loopif.c: Added define + NETIF_INIT_SNMP(netif, type, speed) to initialize per-netif snmp variables, + added initialization of those to ethernetif, slipif and loopif. + + 2007-05-18 Simon Goldschmidt + * opt.h, ip_frag.c, ip_frag.h, ip.c: Added option IP_FRAG_USES_STATIC_BUF + (defaulting to off for now) that can be set to 0 to send fragmented + packets by passing PBUF_REFs down the stack. + + 2007-05-23 Frédéric Bernon + * api_lib.c: Implement SO_RCVTIMEO for accept and recv on TCP + connections, such present in patch #5959. + + 2007-05-23 Frédéric Bernon + * api.h, api_lib.c, api_msg.c, sockets.c: group the different NETCONN_UDPxxx + code in only one part... + + 2007-05-18 Simon Goldschmidt + * opt.h, memp.h, memp.c: Added option MEMP_OVERFLOW_CHECK to check for memp + elements to overflow. This is achieved by adding some bytes before and after + each pool element (increasing their size, of course), filling them with a + prominent value and checking them on freeing the element. + Set it to 2 to also check every element in every pool each time memp_malloc() + or memp_free() is called (slower but more helpful). + + 2007-05-10 Simon Goldschmidt + * opt.h, memp.h, memp.c, pbuf.c (see task #6831): use a new memp pool for + PBUF_POOL pbufs instead of the old pool implementation in pbuf.c to reduce + code size. + + 2007-05-11 Frédéric Bernon + * sockets.c, api_lib.c, api_msg.h, api_msg.c, netifapi.h, netifapi.c, tcpip.c: + Include a function pointer instead of a table index in the message to reduce + footprint. Disable some part of lwip_send and lwip_sendto if some options are + not set (LWIP_TCP, LWIP_UDP, LWIP_RAW). + + 2007-05-10 Simon Goldschmidt + * *.h (except netif/ppp/*.h): Included patch #5448: include '#ifdef __cplusplus + \ extern "C" {' in all header files. Now you can write your application using + the lwIP stack in C++ and simply #include the core files. Note I have left + out the netif/ppp/*h header files for now, since I don't know which files are + included by applications and which are for internal use only. + + 2007-05-09 Simon Goldschmidt + * opt.h, *.c/*.h: Included patch #5920: Create define to override C-library + memcpy. 2 Defines are created: MEMCPY() for normal memcpy, SMEMCPY() for + situations where some compilers might inline the copy and save a function + call. Also replaced all calls to memcpy() with calls to (S)MEMCPY(). + + 2007-05-08 Simon Goldschmidt + * mem.h: If MEM_LIBC_MALLOC==1, allow the defines (e.g. mem_malloc() -> malloc()) + to be overriden in case the C-library malloc implementation is not protected + against concurrent access. + + 2007-05-04 Simon Goldschmidt (Atte Kojo) + * etharp.c: Introduced fast one-entry-cache to speed up ARP lookup when sending + multiple packets to the same host. + + 2007-05-04 Frédéric Bernon, Jonathan Larmour + * sockets.c, api.h, api_lib.c, api_msg.h, api_msg.c: Fix bug #19162 "lwip_sento: a possible + to corrupt remote addr/port connection state". Reduce problems "not enought memory" with + netbuf (if we receive lot of datagrams). Improve lwip_sendto (only one exchange between + sockets api and api_msg which run in tcpip_thread context). Add netconn_sento function. + Warning, if you directly access to "fromaddr" & "fromport" field from netbuf struct, + these fields are now renamed "addr" & "port". + + 2007-04-11 Jonathan Larmour + * sys.h, api_lib.c: Provide new sys_mbox_tryfetch function. Require ports to provide new + sys_arch_mbox_tryfetch function to get a message if one is there, otherwise return + with SYS_MBOX_EMPTY. sys_arch_mbox_tryfetch can be implemented as a function-like macro + by the port in sys_arch.h if desired. + + 2007-04-06 Frédéric Bernon, Simon Goldschmidt + * opt.h, tcpip.h, tcpip.c, netifapi.h, netifapi.c: New configuration option LWIP_NETIF_API + allow to use thread-safe functions to add/remove netif in list, and to start/stop dhcp + clients, using new functions from netifapi.h. Disable as default (no port change to do). + + 2007-04-05 Frédéric Bernon + * sockets.c: remplace ENOBUFS errors on alloc_socket by ENFILE to be more BSD compliant. + + 2007-04-04 Simon Goldschmidt + * arch.h, api_msg.c, dhcp.c, msg_in.c, sockets.c: Introduced #define LWIP_UNUSED_ARG(x) + use this for and architecture-independent form to tell the compiler you intentionally + are not using this variable. Can be overriden in cc.h. + + 2007-03-28 Frédéric Bernon + * opt.h, netif.h, dhcp.h, dhcp.c: New configuration option LWIP_NETIF_HOSTNAME allow to + define a hostname in netif struct (this is just a pointer, so, you can use a hardcoded + string, point on one of your's ethernetif field, or alloc a string you will free yourself). + It will be used by DHCP to register a client hostname, but can also be use when you call + snmp_set_sysname. + + 2007-03-28 Frédéric Bernon + * netif.h, netif.c: A new NETIF_FLAG_ETHARP flag is defined in netif.h, to allow to + initialize a network interface's flag with. It tell this interface is an ethernet + device, and we can use ARP with it to do a "gratuitous ARP" (RFC 3220 "IP Mobility + Support for IPv4" section 4.6) when interface is "up" with netif_set_up(). + + 2007-03-26 Frédéric Bernon, Jonathan Larmour + * opt.h, tcpip.c: New configuration option LWIP_ARP allow to disable ARP init at build + time if you only use PPP or SLIP. The default is enable. Note we don't have to call + etharp_init in your port's initilization sequence if you use tcpip.c, because this call + is done in tcpip_init function. + + 2007-03-22 Frédéric Bernon + * stats.h, stats.c, msg_in.c: Stats counters can be change to u32_t if necessary with the + new option LWIP_STATS_LARGE. If you need this option, define LWIP_STATS_LARGE to 1 in + your lwipopts.h. More, unused counters are not defined in the stats structs, and not + display by stats_display(). Note that some options (SYS_STATS and RAW_STATS) are defined + but never used. Fix msg_in.c with the correct #if test for a stat display. + + 2007-03-21 Kieran Mansley + * netif.c, netif.h: Apply patch#4197 with some changes (originator: rireland@hmgsl.com). + Provides callback on netif up/down state change. + + 2007-03-11 Frédéric Bernon, Mace Gael, Steve Reynolds + * sockets.h, sockets.c, api.h, api_lib.c, api_msg.h, api_msg.c, igmp.h, igmp.c, + ip.c, netif.h, tcpip.c, opt.h: + New configuration option LWIP_IGMP to enable IGMP processing. Based on only one + filter per all network interfaces. Declare a new function in netif to enable to + control the MAC filter (to reduce lwIP traffic processing). + + 2007-03-11 Frédéric Bernon + * tcp.h, tcp.c, sockets.c, tcp_out.c, tcp_in.c, opt.h: Keepalive values can + be configured at run time with LWIP_TCP_KEEPALIVE, but don't change this + unless you know what you're doing (default are RFC1122 compliant). Note + that TCP_KEEPIDLE and TCP_KEEPINTVL have to be set in seconds. + + 2007-03-08 Frédéric Bernon + * tcp.h: Keepalive values can be configured at compile time, but don't change + this unless you know what you're doing (default are RFC1122 compliant). + + 2007-03-08 Frédéric Bernon + * sockets.c, api.h, api_lib.c, tcpip.c, sys.h, sys.c, err.c, opt.h: + Implement LWIP_SO_RCVTIMEO configuration option to enable/disable SO_RCVTIMEO + on UDP sockets/netconn. + + 2007-03-08 Simon Goldschmidt + * snmp_msg.h, msg_in.c: SNMP UDP ports can be configured at compile time. + + 2007-03-06 Frédéric Bernon + * api.h, api_lib.c, sockets.h, sockets.c, tcpip.c, sys.h, sys.c, err.h: + Implement SO_RCVTIMEO on UDP sockets/netconn. + + 2007-02-28 Kieran Mansley (based on patch from Simon Goldschmidt) + * api_lib.c, tcpip.c, memp.c, memp.h: make API msg structs allocated + on the stack and remove the API msg type from memp + + 2007-02-26 Jonathan Larmour (based on patch from Simon Goldschmidt) + * sockets.h, sockets.c: Move socket initialization to new + lwip_socket_init() function. + NOTE: this changes the API with ports. Ports will have to be + updated to call lwip_socket_init() now. + + 2007-02-26 Jonathan Larmour (based on patch from Simon Goldschmidt) + * api_lib.c: Use memcpy in netbuf_copy_partial. + + + ++ Bug fixes: + + 2008-03-17 Frédéric Bernon, Ed Kerekes + * igmp.h, igmp.c: Fix bug #22613 "IGMP iphdr problem" (could have + some problems to fill the IP header on some targets, use now the + ip.h macros to do it). + + 2008-03-13 Frédéric Bernon + * sockets.c: Fix bug #22435 "lwip_recvfrom with TCP break;". Using + (lwip_)recvfrom with valid "from" and "fromlen" parameters, on a + TCP connection caused a crash. Note that using (lwip_)recvfrom + like this is a bit slow and that using (lwip)getpeername is the + good lwip way to do it (so, using recv is faster on tcp sockets). + + 2008-03-12 Frédéric Bernon, Jonathan Larmour + * api_msg.c, contrib/apps/ping.c: Fix bug #22530 "api_msg.c's + recv_raw() does not consume data", and the ping sample (with + LWIP_SOCKET=1, the code did the wrong supposition that lwip_recvfrom + returned the IP payload, without the IP header). + + 2008-03-04 Jonathan Larmour + * mem.c, stats.c, mem.h: apply patch #6414 to avoid compiler errors + and/or warnings on some systems where mem_size_t and size_t differ. + * pbuf.c, ppp.c: Fix warnings on some systems with mem_malloc. + + 2008-03-04 Kieran Mansley (contributions by others) + * Numerous small compiler error/warning fixes from contributions to + mailing list after 1.3.0 release candidate made. + + 2008-01-25 Cui hengbin (integrated by Frédéric Bernon) + * dns.c: Fix bug #22108 "DNS problem" caused by unaligned structures. + + 2008-01-15 Kieran Mansley + * tcp_out.c: BUG20511. Modify persist timer to start when we are + prevented from sending by a small send window, not just a zero + send window. + + 2008-01-09 Jonathan Larmour + * opt.h, ip.c: Rename IP_OPTIONS define to IP_OPTIONS_ALLOWED to avoid + conflict with Linux system headers. + + 2008-01-06 Jonathan Larmour + * dhcp.c: fix bug #19927: "DHCP NACK problem" by clearing any existing set IP + address entirely on receiving a DHCPNAK, and restarting discovery. + + 2007-12-21 Simon Goldschmidt + * sys.h, api_lib.c, api_msg.c, sockets.c: fix bug #21698: "netconn->recv_avail + is not protected" by using new macros for interlocked access to modify/test + netconn->recv_avail. + + 2007-12-20 Kieran Mansley (based on patch from Oleg Tyshev) + * tcp_in.c: fix bug# 21535 (nrtx not reset correctly in SYN_SENT state) + + 2007-12-20 Kieran Mansley (based on patch from Per-Henrik Lundbolm) + * tcp.c, tcp_in.c, tcp_out.c, tcp.h: fix bug #20199 (better handling + of silly window avoidance and prevent lwIP from shrinking the window) + + 2007-12-04 Simon Goldschmidt + * tcp.c, tcp_in.c: fix bug #21699 (segment leak in ooseq processing when last + data packet was lost): add assert that all segment lists are empty in + tcp_pcb_remove before setting pcb to CLOSED state; don't directly set CLOSED + state from LAST_ACK in tcp_process + + 2007-12-02 Simon Goldschmidt + * sockets.h: fix bug #21654: exclude definition of struct timeval from #ifndef FD_SET + If including for system-struct timeval, LWIP_TIMEVAL_PRIVATE now + has to be set to 0 in lwipopts.h + + 2007-12-02 Simon Goldschmidt + * api_msg.c, api_lib.c: fix bug #21656 (recvmbox problem in netconn API): always + allocate a recvmbox in netconn_new_with_proto_and_callback. For a tcp-listen + netconn, this recvmbox is later freed and a new mbox is allocated for acceptmbox. + This is a fix for thread-safety and allocates all items needed for a netconn + when the netconn is created. + + 2007-11-30 Simon Goldschmidt + * udp.c: first attempt to fix bug #21655 (DHCP doesn't work reliably with multiple + netifs): if LWIP_DHCP is enabled, UDP packets to DHCP_CLIENT_PORT are passed + to netif->dhcp->pcb only (if that exists) and not to any other pcb for the same + port (only solution to let UDP pcbs 'bind' to a netif instead of an IP address) + + 2007-11-27 Simon Goldschmidt + * ip.c: fixed bug #21643 (udp_send/raw_send don't fail if netif is down) by + letting ip_route only use netifs that are up. + + 2007-11-27 Simon Goldschmidt + * err.h, api_lib.c, api_msg.c, sockets.c: Changed error handling: ERR_MEM, ERR_BUF + and ERR_RTE are seen as non-fatal, all other errors are fatal. netconns and + sockets block most operations once they have seen a fatal error. + + 2007-11-27 Simon Goldschmidt + * udp.h, udp.c, dhcp.c: Implemented new function udp_sendto_if which takes the + netif to send as an argument (to be able to send on netifs that are down). + + 2007-11-26 Simon Goldschmidt + * tcp_in.c: Fixed bug #21582: pcb->acked accounting can be wrong when ACKs + arrive out-of-order + + 2007-11-21 Simon Goldschmidt + * tcp.h, tcp_out.c, api_msg.c: Fixed bug #20287: tcp_output_nagle sends too early + Fixed the nagle algorithm; nagle now also works for all raw API applications + and has to be explicitly disabled with 'tcp_pcb->flags |= TF_NODELAY' + + 2007-11-12 Frédéric Bernon + * sockets.c, api.h, api_lib.c, api_msg.h, api_msg.c: Fixed bug #20900. Now, most + of the netconn_peer and netconn_addr processing is done inside tcpip_thread + context in do_getaddr. + + 2007-11-10 Simon Goldschmidt + * etharp.c: Fixed bug: assert fired when MEMP_ARP_QUEUE was empty (which can + happen any time). Now the packet simply isn't enqueued when out of memory. + + 2007-11-01 Simon Goldschmidt + * tcp.c, tcp_in.c: Fixed bug #21494: The send mss (pcb->mss) is set to 536 (or + TCP_MSS if that is smaller) as long as no MSS option is received from the + remote host. + + 2007-11-01 Simon Goldschmidt + * tcp.h, tcp.c, tcp_in.c: Fixed bug #21491: The MSS option sent (with SYN) + is now based on TCP_MSS instead of pcb->mss (on passive open now effectively + sending our configured TCP_MSS instead of the one received). + + 2007-11-01 Simon Goldschmidt + * tcp_in.c: Fixed bug #21181: On active open, the initial congestion window was + calculated based on the configured TCP_MSS, not on the MSS option received + with SYN+ACK. + + 2007-10-09 Simon Goldschmidt + * udp.c, inet.c, inet.h: Fixed UDPLite: send: Checksum was always generated too + short and also was generated wrong if checksum coverage != tot_len; + receive: checksum was calculated wrong if checksum coverage != tot_len + + 2007-10-08 Simon Goldschmidt + * mem.c: lfree was not updated in mem_realloc! + + 2007-10-07 Frédéric Bernon + * sockets.c, api.h, api_lib.c: First step to fix "bug #20900 : Potential + crash error problem with netconn_peer & netconn_addr". VERY IMPORTANT: + this change cause an API breakage for netconn_addr, since a parameter + type change. Any compiler should cause an error without any changes in + yours netconn_peer calls (so, it can't be a "silent change"). It also + reduce a little bit the footprint for socket layer (lwip_getpeername & + lwip_getsockname use now a common lwip_getaddrname function since + netconn_peer & netconn_addr have the same parameters). + + 2007-09-20 Simon Goldschmidt + * tcp.c: Fixed bug #21080 (tcp_bind without check pcbs in TIME_WAIT state) + by checking tcp_tw_pcbs also + + 2007-09-19 Simon Goldschmidt + * icmp.c: Fixed bug #21107 (didn't reset IP TTL in ICMP echo replies) + + 2007-09-15 Mike Kleshov + * mem.c: Fixed bug #21077 (inaccuracy in calculation of lwip_stat.mem.used) + + 2007-09-06 Frédéric Bernon + * several-files: replace some #include "arch/cc.h" by "lwip/arch.h", or simply remove + it as long as "lwip/opt.h" is included before (this one include "lwip/debug.h" which + already include "lwip/arch.h"). Like that, default defines are provided by "lwip/arch.h" + if they are not defined in cc.h, in the same spirit than "lwip/opt.h" for lwipopts.h. + + 2007-08-30 Frédéric Bernon + * igmp.h, igmp.c: Some changes to remove some redundant code, add some traces, + and fix some coding style. + + 2007-08-28 Frédéric Bernon + * tcpip.c: Fix TCPIP_MSG_INPKT processing: now, tcpip_input can be used for any + kind of packets. These packets are considered like Ethernet packets (payload + pointing to ethhdr) if the netif got the NETIF_FLAG_ETHARP flag. Else, packets + are considered like IP packets (payload pointing to iphdr). + + 2007-08-27 Frédéric Bernon + * api.h, api_lib.c, api_msg.c: First fix for "bug #20900 : Potential crash error + problem with netconn_peer & netconn_addr". Introduce NETCONN_LISTEN netconn_state + and remove obsolete ones (NETCONN_RECV & NETCONN_ACCEPT). + + 2007-08-24 Kieran Mansley + * inet.c Modify (acc >> 16) test to ((acc >> 16) != 0) to help buggy + compiler (Paradigm C++) + + 2007-08-09 Frédéric Bernon, Bill Florac + * stats.h, stats.c, igmp.h, igmp.c, opt.h: Fix for bug #20503 : IGMP Improvement. + Introduce IGMP_STATS to centralize statistics management. + + 2007-08-09 Frédéric Bernon, Bill Florac + * udp.c: Fix for bug #20503 : IGMP Improvement. Enable to receive a multicast + packet on a udp pcb binded on an netif's IP address, and not on "any". + + 2007-08-09 Frédéric Bernon, Bill Florac + * igmp.h, igmp.c, ip.c: Fix minor changes from bug #20503 : IGMP Improvement. + This is mainly on using lookup/lookfor, and some coding styles... + + 2007-07-26 Frédéric Bernon (and "thedoctor") + * igmp.c: Fix bug #20595 to accept IGMPv3 "Query" messages. + + 2007-07-25 Simon Goldschmidt + * api_msg.c, tcp.c: Another fix for bug #20021: by not returning an error if + tcp_output fails in tcp_close, the code in do_close_internal gets simpler + (tcp_output is called again later from tcp timers). + + 2007-07-25 Simon Goldschmidt + * ip_frag.c: Fixed bug #20429: use the new pbuf_copy_partial instead of the old + copy_from_pbuf, which illegally modified the given pbuf. + + 2007-07-25 Simon Goldschmidt + * tcp_out.c: tcp_enqueue: pcb->snd_queuelen didn't work for chaine PBUF_RAMs: + changed snd_queuelen++ to snd_queuelen += pbuf_clen(p). + + 2007-07-24 Simon Goldschmidt + * api_msg.c, tcp.c: Fix bug #20480: Check the pcb passed to tcp_listen() for the + correct state (must be CLOSED). + + 2007-07-13 Thomas Taranowski (commited by Jared Grubb) + * memp.c: Fix bug #20478: memp_malloc returned NULL+MEMP_SIZE on failed + allocation. It now returns NULL. + + 2007-07-13 Frédéric Bernon + * api_msg.c: Fix bug #20318: api_msg "recv" callbacks don't call pbuf_free in + all error cases. + + 2007-07-13 Frédéric Bernon + * api_msg.c: Fix bug #20315: possible memory leak problem if tcp_listen failed, + because current code doesn't follow rawapi.txt documentation. + + 2007-07-13 Kieran Mansley + * src/core/tcp_in.c Apply patch#5741 from Oleg Tyshev to fix bug in + out of sequence processing of received packets + + 2007-07-03 Simon Goldschmidt + * nearly-all-files: Added assertions where PBUF_RAM pbufs are used and an + assumption is made that this pbuf is in one piece (i.e. not chained). These + assumptions clash with the possibility of converting to fully pool-based + pbuf implementations, where PBUF_RAM pbufs might be chained. + + 2007-07-03 Simon Goldschmidt + * api.h, api_lib.c, api_msg.c: Final fix for bug #20021 and some other problems + when closing tcp netconns: removed conn->sem, less context switches when + closing, both netconn_close and netconn_delete should safely close tcp + connections. + + 2007-07-02 Simon Goldschmidt + * ipv4/ip.h, ipv6/ip.h, opt.h, netif.h, etharp.h, ipv4/ip.c, netif.c, raw.c, + tcp_out.c, udp.c, etharp.c: Added option LWIP_NETIF_HWADDRHINT (default=off) + to cache ARP table indices with each pcb instead of single-entry cache for + the complete stack. + + 2007-07-02 Simon Goldschmidt + * tcp.h, tcp.c, tcp_in.c, tcp_out.c: Added some ASSERTS and casts to prevent + warnings when assigning to smaller types. + + 2007-06-28 Simon Goldschmidt + * tcp_out.c: Added check to prevent tcp_pcb->snd_queuelen from overflowing. + + 2007-06-28 Simon Goldschmidt + * tcp.h: Fixed bug #20287: Fixed nagle algorithm (sending was done too early if + a segment contained chained pbufs) + + 2007-06-28 Frédéric Bernon + * autoip.c: replace most of rand() calls by a macro LWIP_AUTOIP_RAND which compute + a "pseudo-random" value based on netif's MAC and some autoip fields. It's always + possible to define this macro in your own lwipopts.h to always use C library's + rand(). Note that autoip_create_rand_addr doesn't use this macro. + + 2007-06-28 Frédéric Bernon + * netifapi.h, netifapi.c, tcpip.h, tcpip.c: Update code to handle the option + LWIP_TCPIP_CORE_LOCKING, and do some changes to be coherent with last modifications + in api_lib/api_msg (use pointers and not type with table, etc...) + + 2007-06-26 Simon Goldschmidt + * udp.h: Fixed bug #20259: struct udp_hdr was lacking the packin defines. + + 2007-06-25 Simon Goldschmidt + * udp.c: Fixed bug #20253: icmp_dest_unreach was called with a wrong p->payload + for udp packets with no matching pcb. + + 2007-06-25 Simon Goldschmidt + * udp.c: Fixed bug #20220: UDP PCB search in udp_input(): a non-local match + could get udp input packets if the remote side matched. + + 2007-06-13 Simon Goldschmidt + * netif.c: Fixed bug #20180 (TCP pcbs listening on IP_ADDR_ANY could get + changed in netif_set_ipaddr if previous netif->ip_addr.addr was 0. + + 2007-06-13 Simon Goldschmidt + * api_msg.c: pcb_new sets conn->err if protocol is not implemented + -> netconn_new_..() does not allocate a new connection for unsupported + protocols. + + 2007-06-13 Frédéric Bernon, Simon Goldschmidt + * api_lib.c: change return expression in netconn_addr and netconn_peer, because + conn->err was reset to ERR_OK without any reasons (and error was lost)... + + 2007-06-13 Frédéric Bernon, Matthias Weisser + * opt.h, mem.h, mem.c, memp.c, pbuf.c, ip_frag.c, vj.c: Fix bug #20162. Rename + MEM_ALIGN in LWIP_MEM_ALIGN and MEM_ALIGN_SIZE in LWIP_MEM_ALIGN_SIZE to avoid + some macro names collision with some OS macros. + + 2007-06-11 Simon Goldschmidt + * udp.c: UDP Lite: corrected the use of chksum_len (based on RFC3828: if it's 0, + create checksum over the complete packet. On RX, if it's < 8 (and not 0), + discard the packet. Also removed the duplicate 'udphdr->chksum = 0' for both + UDP & UDP Lite. + + 2007-06-11 Srinivas Gollakota & Oleg Tyshev + * tcp_out.c: Fix for bug #20075 : "A problem with keep-alive timer and TCP flags" + where TCP flags wasn't initialized in tcp_keepalive. + + 2007-06-03 Simon Goldschmidt + * udp.c: udp_input(): Input pbuf was not freed if pcb had no recv function + registered, p->payload was modified without modifying p->len if sending + icmp_dest_unreach() (had no negative effect but was definitively wrong). + + 2007-06-03 Simon Goldschmidt + * icmp.c: Corrected bug #19937: For responding to an icmp echo request, icmp + re-used the input pbuf even if that didn't have enough space to include the + link headers. Now the space is tested and a new pbuf is allocated for the + echo response packet if the echo request pbuf isn't big enough. + + 2007-06-01 Simon Goldschmidt + * sockets.c: Checked in patch #5914: Moved sockopt processing into tcpip_thread. + + 2007-05-23 Frédéric Bernon + * api_lib.c, sockets.c: Fixed bug #5958 for netconn_listen (acceptmbox only + allocated by do_listen if success) and netconn_accept errors handling. In + most of api_lib functions, we replace some errors checkings like "if (conn==NULL)" + by ASSERT, except for netconn_delete. + + 2007-05-23 Frédéric Bernon + * api_lib.c: Fixed bug #5957 "Safe-thread problem inside netconn_recv" to return + an error code if it's impossible to fetch a pbuf on a TCP connection (and not + directly close the recvmbox). + + 2007-05-22 Simon Goldschmidt + * tcp.c: Fixed bug #1895 (tcp_bind not correct) by introducing a list of + bound but unconnected (and non-listening) tcp_pcbs. + + 2007-05-22 Frédéric Bernon + * sys.h, sys.c, api_lib.c, tcpip.c: remove sys_mbox_fetch_timeout() (was only + used for LWIP_SO_RCVTIMEO option) and use sys_arch_mbox_fetch() instead of + sys_mbox_fetch() in api files. Now, users SHOULD NOT use internal lwIP features + like "sys_timeout" in their application threads. + + 2007-05-22 Frédéric Bernon + * api.h, api_lib.c, api_msg.h, api_msg.c: change the struct api_msg_msg to see + which parameters are used by which do_xxx function, and to avoid "misusing" + parameters (patch #5938). + + 2007-05-22 Simon Goldschmidt + * api_lib.c, api_msg.c, raw.c, api.h, api_msg.h, raw.h: Included patch #5938: + changed raw_pcb.protocol from u16_t to u8_t since for IPv4 and IPv6, proto + is only 8 bits wide. This affects the api, as there, the protocol was + u16_t, too. + + 2007-05-18 Simon Goldschmidt + * memp.c: addition to patch #5913: smaller pointer was returned but + memp_memory was the same size -> did not save memory. + + 2007-05-16 Simon Goldschmidt + * loopif.c, slipif.c: Fix bug #19729: free pbuf if netif->input() returns + != ERR_OK. + + 2007-05-16 Simon Goldschmidt + * api_msg.c, udp.c: If a udp_pcb has a local_ip set, check if it is the same + as the one of the netif used for sending to prevent sending from old + addresses after a netif address gets changed (partly fixes bug #3168). + + 2007-05-16 Frédéric Bernon + * tcpip.c, igmp.h, igmp.c: Fixed bug "#19800 : IGMP: igmp_tick() will not work + with NO_SYS=1". Note that igmp_init is always in tcpip_thread (and not in + tcpip_init) because we have to be sure that network interfaces are already + added (mac filter is updated only in igmp_init for the moment). + + 2007-05-16 Simon Goldschmidt + * mem.c, memp.c: Removed semaphores from memp, changed sys_sem_wait calls + into sys_arch_sem_wait calls to prevent timers from running while waiting + for the heap. This fixes bug #19167. + + 2007-05-13 Simon Goldschmidt + * tcp.h, sockets.h, sockets.c: Fixed bug from patch #5865 by moving the defines + for socket options (lwip_set/-getsockopt) used with level IPPROTO_TCP from + tcp.h to sockets.h. + + 2007-05-07 Simon Goldschmidt + * mem.c: Another attempt to fix bug #17922. + + 2007-05-04 Simon Goldschmidt + * pbuf.c, pbuf.h, etharp.c: Further update to ARP queueing: Changed pbuf_copy() + implementation so that it can be reused (don't allocate the target + pbuf inside pbuf_copy()). + + 2007-05-04 Simon Goldschmidt + * memp.c: checked in patch #5913: in memp_malloc() we can return memp as mem + to save a little RAM (next pointer of memp is not used while not in pool). + + 2007-05-03 "maq" + * sockets.c: Fix ioctl FIONREAD when some data remains from last recv. + (patch #3574). + + 2007-04-23 Simon Goldschmidt + * loopif.c, loopif.h, opt.h, src/netif/FILES: fix bug #2595: "loopif results + in NULL reference for incoming TCP packets". Loopif has to be configured + (using LWIP_LOOPIF_MULTITHREADING) to directly call netif->input() + (multithreading environments, e.g. netif->input() = tcpip_input()) or + putting packets on a list that is fed to the stack by calling loopif_poll() + (single-thread / NO_SYS / polling environment where e.g. + netif->input() = ip_input). + + 2007-04-17 Jonathan Larmour + * pbuf.c: Use s32_t in pbuf_realloc(), as an s16_t can't reliably hold + the difference between two u16_t's. + * sockets.h: FD_SETSIZE needs to match number of sockets, which is + MEMP_NUM_NETCONN in sockets.c right now. + + 2007-04-12 Jonathan Larmour + * icmp.c: Reset IP header TTL in ICMP ECHO responses (bug #19580). + + 2007-04-12 Kieran Mansley + * tcp.c, tcp_in.c, tcp_out.c, tcp.h: Modify way the retransmission + timer is reset to fix bug#19434, with help from Oleg Tyshev. + + 2007-04-11 Simon Goldschmidt + * etharp.c, pbuf.c, pbuf.h: 3rd fix for bug #11400 (arp-queuing): More pbufs than + previously thought need to be copied (everything but PBUF_ROM!). Cleaned up + pbuf.c: removed functions no needed any more (by etharp). + + 2007-04-11 Kieran Mansley + * inet.c, ip_addr.h, sockets.h, sys.h, tcp.h: Apply patch #5745: Fix + "Constant is long" warnings with 16bit compilers. Contributed by + avatar@mmlab.cse.yzu.edu.tw + + 2007-04-05 Frédéric Bernon, Jonathan Larmour + * api_msg.c: Fix bug #16830: "err_tcp() posts to connection mailbox when no pend on + the mailbox is active". Now, the post is only done during a connect, and do_send, + do_write and do_join_leave_group don't do anything if a previous error was signaled. + + 2007-04-03 Frédéric Bernon + * ip.c: Don't set the IP_DF ("Don't fragment") flag in the IP header in IP output + packets. See patch #5834. + + 2007-03-30 Frédéric Bernon + * api_msg.c: add a "pcb_new" helper function to avoid redundant code, and to add + missing pcb allocations checking (in do_bind, and for each raw_new). Fix style. + + 2007-03-30 Frédéric Bernon + * most of files: prefix all debug.h define with "LWIP_" to avoid any conflict with + others environment defines (these were too "generic"). + + 2007-03-28 Frédéric Bernon + * api.h, api_lib.c, sockets.c: netbuf_ref doesn't check its internal pbuf_alloc call + result and can cause a crash. lwip_send now check netbuf_ref result. + + 2007-03-28 Simon Goldschmidt + * sockets.c Remove "#include " from sockets.c to avoid multiple + definition of macros (in errno.h and lwip/arch.h) if LWIP_PROVIDE_ERRNO is + defined. This is the way it should have been already (looking at + doc/sys_arch.txt) + + 2007-03-28 Kieran Mansley + * opt.h Change default PBUF_POOL_BUFSIZE (again) to accomodate default MSS + + IP and TCP headers *and* physical link headers + + 2007-03-26 Frédéric Bernon (based on patch from Dmitry Potapov) + * api_lib.c: patch for netconn_write(), fixes a possible race condition which cause + to send some garbage. It is not a definitive solution, but the patch does solve + the problem for most cases. + + 2007-03-22 Frédéric Bernon + * api_msg.h, api_msg.c: Remove obsolete API_MSG_ACCEPT and do_accept (never used). + + 2007-03-22 Frédéric Bernon + * api_lib.c: somes resources couldn't be freed if there was errors during + netconn_new_with_proto_and_callback. + + 2007-03-22 Frédéric Bernon + * ethernetif.c: update netif->input calls to check return value. In older ports, + it's a good idea to upgrade them, even if before, there could be another problem + (access to an uninitialized mailbox). + + 2007-03-21 Simon Goldschmidt + * sockets.c: fixed bug #5067 (essentialy a signed/unsigned warning fixed + by casting to unsigned). + + 2007-03-21 Frédéric Bernon + * api_lib.c, api_msg.c, tcpip.c: integrate sys_mbox_fetch(conn->mbox, NULL) calls from + api_lib.c to tcpip.c's tcpip_apimsg(). Now, use a local variable and not a + dynamic one from memp to send tcpip_msg to tcpip_thread in a synchrone call. + Free tcpip_msg from tcpip_apimsg is not done in tcpip_thread. This give a + faster and more reliable communication between api_lib and tcpip. + + 2007-03-21 Frédéric Bernon + * opt.h: Add LWIP_NETIF_CALLBACK (to avoid compiler warning) and set it to 0. + + 2007-03-21 Frédéric Bernon + * api_msg.c, igmp.c, igmp.h: Fix C++ style comments + + 2007-03-21 Kieran Mansley + * opt.h Change default PBUF_POOL_BUFSIZE to accomodate default MSS + + IP and TCP headers + + 2007-03-21 Kieran Mansley + * Fix all uses of pbuf_header to check the return value. In some + cases just assert if it fails as I'm not sure how to fix them, but + this is no worse than before when they would carry on regardless + of the failure. + + 2007-03-21 Kieran Mansley + * sockets.c, igmp.c, igmp.h, memp.h: Fix C++ style comments and + comment out missing header include in icmp.c + + 2007-03-20 Frédéric Bernon + * memp.h, stats.c: Fix stats_display function where memp_names table wasn't + synchronized with memp.h. + + 2007-03-20 Frédéric Bernon + * tcpip.c: Initialize tcpip's mbox, and verify if initialized in tcpip_input, + tcpip_ethinput, tcpip_callback, tcpip_apimsg, to fix a init problem with + network interfaces. Also fix a compiler warning. + + 2007-03-20 Kieran Mansley + * udp.c: Only try and use pbuf_header() to make space for headers if + not a ROM or REF pbuf. + + 2007-03-19 Frédéric Bernon + * api_msg.h, api_msg.c, tcpip.h, tcpip.c: Add return types to tcpip_apimsg() + and api_msg_post(). + + 2007-03-19 Frédéric Bernon + * Remove unimplemented "memp_realloc" function from memp.h. + + 2007-03-11 Simon Goldschmidt + * pbuf.c: checked in patch #5796: pbuf_alloc: len field claculation caused + memory corruption. + + 2007-03-11 Simon Goldschmidt (based on patch from Dmitry Potapov) + * api_lib.c, sockets.c, api.h, api_msg.h, sockets.h: Fixed bug #19251 + (missing `const' qualifier in socket functions), to get more compatible to + standard POSIX sockets. + + 2007-03-11 Frédéric Bernon (based on patch from Dmitry Potapov) + * sockets.c: Add asserts inside bind, connect and sendto to check input + parameters. Remove excessive set_errno() calls after get_socket(), because + errno is set inside of get_socket(). Move last sock_set_errno() inside + lwip_close. + + 2007-03-09 Simon Goldschmidt + * memp.c: Fixed bug #11400: New etharp queueing introduced bug: memp_memory + was allocated too small. + + 2007-03-06 Simon Goldschmidt + * tcpip.c: Initialize dhcp timers in tcpip_thread (if LWIP_DHCP) to protect + the stack from concurrent access. + + 2007-03-06 Frédéric Bernon, Dmitry Potapov + * tcpip.c, ip_frag.c, ethernetif.c: Fix some build problems, and a redundancy + call to "lwip_stats.link.recv++;" in low_level_input() & ethernetif_input(). + + 2007-03-06 Simon Goldschmidt + * ip_frag.c, ip_frag.h: Reduce code size: don't include code in those files + if IP_FRAG == 0 and IP_REASSEMBLY == 0 + + 2007-03-06 Frédéric Bernon, Simon Goldschmidt + * opt.h, ip_frag.h, tcpip.h, tcpip.c, ethernetif.c: add new configuration + option named ETHARP_TCPIP_ETHINPUT, which enable the new tcpip_ethinput. + Allow to do ARP processing for incoming packets inside tcpip_thread + (protecting ARP layer against concurrent access). You can also disable + old code using tcp_input with new define ETHARP_TCPIP_INPUT set to 0. + Older ports have to use tcpip_ethinput. + + 2007-03-06 Simon Goldschmidt (based on patch from Dmitry Potapov) + * err.h, err.c: fixed compiler warning "initialization dircards qualifiers + from pointer target type" + + 2007-03-05 Frédéric Bernon + * opt.h, sockets.h: add new configuration options (LWIP_POSIX_SOCKETS_IO_NAMES, + ETHARP_TRUST_IP_MAC, review SO_REUSE) + + 2007-03-04 Frédéric Bernon + * api_msg.c: Remove some compiler warnings : parameter "pcb" was never + referenced. + + 2007-03-04 Frédéric Bernon + * api_lib.c: Fix "[patch #5764] api_lib.c cleanup: after patch #5687" (from + Dmitry Potapov). + The api_msg struct stay on the stack (not moved to netconn struct). + + 2007-03-04 Simon Goldschmidt (based on patch from Dmitry Potapov) + * pbuf.c: Fix BUG#19168 - pbuf_free can cause deadlock (if + SYS_LIGHTWEIGHT_PROT=1 & freeing PBUF_RAM when mem_sem is not available) + Also fixed cast warning in pbuf_alloc() + + 2007-03-04 Simon Goldschmidt + * etharp.c, etharp.h, memp.c, memp.h, opt.h: Fix BUG#11400 - don't corrupt + existing pbuf chain when enqueuing multiple pbufs to a pending ARP request + + 2007-03-03 Frédéric Bernon + * udp.c: remove obsolete line "static struct udp_pcb *pcb_cache = NULL;" + It is static, and never used in udp.c except udp_init(). + + 2007-03-02 Simon Goldschmidt + * tcpip.c: Moved call to ip_init(), udp_init() and tcp_init() from + tcpip_thread() to tcpip_init(). This way, raw API connections can be + initialized before tcpip_thread is running (e.g. before OS is started) + + 2007-03-02 Frédéric Bernon + * rawapi.txt: Fix documentation mismatch with etharp.h about etharp_tmr's call + interval. + + 2007-02-28 Kieran Mansley + * pbuf.c: Fix BUG#17645 - ensure pbuf payload pointer is not moved + outside the region of the pbuf by pbuf_header() + + 2007-02-28 Kieran Mansley + * sockets.c: Fix BUG#19161 - ensure milliseconds timeout is non-zero + when supplied timeout is also non-zero + +(STABLE-1.2.0) + + 2006-12-05 Leon Woestenberg + * CHANGELOG: Mention STABLE-1.2.0 release. + + ++ New features: + + 2006-12-01 Christiaan Simons + * mem.h, opt.h: Added MEM_LIBC_MALLOC option. + Note this is a workaround. Currently I have no other options left. + + 2006-10-26 Christiaan Simons (accepted patch by Jonathan Larmour) + * ipv4/ip_frag.c: rename MAX_MTU to IP_FRAG_MAX_MTU and move define + to include/lwip/opt.h. + * ipv4/lwip/ip_frag.h: Remove unused IP_REASS_INTERVAL. + Move IP_REASS_MAXAGE and IP_REASS_BUFSIZE to include/lwip/opt.h. + * opt.h: Add above new options. + + 2006-08-18 Christiaan Simons + * tcp_{in,out}.c: added SNMP counters. + * ipv4/ip.c: added SNMP counters. + * ipv4/ip_frag.c: added SNMP counters. + + 2006-08-08 Christiaan Simons + * etharp.{c,h}: added etharp_find_addr() to read + (stable) ethernet/IP address pair from ARP table + + 2006-07-14 Christiaan Simons + * mib_structs.c: added + * include/lwip/snmp_structs.h: added + * netif.{c,h}, netif/ethernetif.c: added SNMP statistics to netif struct + + 2006-07-06 Christiaan Simons + * snmp/asn1_{enc,dec}.c added + * snmp/mib2.c added + * snmp/msg_{in,out}.c added + * include/lwip/snmp_asn1.h added + * include/lwip/snmp_msg.h added + * doc/snmp_agent.txt added + + 2006-03-29 Christiaan Simons + * inet.c, inet.h: Added platform byteswap support. + Added LWIP_PLATFORM_BYTESWAP define (defaults to 0) and + optional LWIP_PLATFORM_HTONS(), LWIP_PLATFORM_HTONL() macros. + + ++ Bug fixes: + + 2006-11-30 Christiaan Simons + * dhcp.c: Fixed false triggers of request_timeout. + + 2006-11-28 Christiaan Simons + * netif.c: In netif_add() fixed missing clear of ip_addr, netmask, gw and flags. + + 2006-10-11 Christiaan Simons + * api_lib.c etharp.c, ip.c, memp.c, stats.c, sys.{c,h} tcp.h: + Partially accepted patch #5449 for ANSI C compatibility / build fixes. + * ipv4/lwip/ip.h ipv6/lwip/ip.h: Corrected UDP-Lite protocol + identifier from 170 to 136 (bug #17574). + + 2006-10-10 Christiaan Simons + * api_msg.c: Fixed Nagle algorithm as reported by Bob Grice. + + 2006-08-17 Christiaan Simons + * udp.c: Fixed bug #17200, added check for broadcast + destinations for PCBs bound to a unicast address. + + 2006-08-07 Christiaan Simons + * api_msg.c: Flushing TCP output in do_close() (bug #15926). + + 2006-06-27 Christiaan Simons + * api_msg.c: Applied patch for cold case (bug #11135). + In accept_function() ensure newconn->callback is always initialized. + + 2006-06-15 Christiaan Simons + * mem.h: added MEM_SIZE_F alias to fix an ancient cold case (bug #1748), + facilitate printing of mem_size_t and u16_t statistics. + + 2006-06-14 Christiaan Simons + * api_msg.c: Applied patch #5146 to handle allocation failures + in accept() by Kevin Lawson. + + 2006-05-26 Christiaan Simons + * api_lib.c: Removed conn->sem creation and destruction + from netconn_write() and added sys_sem_new to netconn_new_*. + +(STABLE-1_1_1) + + 2006-03-03 Christiaan Simons + * ipv4/ip_frag.c: Added bound-checking assertions on ip_reassbitmap + access and added pbuf_alloc() return value checks. + + 2006-01-01 Leon Woestenberg + * tcp_{in,out}.c, tcp_out.c: Removed 'even sndbuf' fix in TCP, which is + now handled by the checksum routine properly. + + 2006-02-27 Leon Woestenberg + * pbuf.c: Fix alignment; pbuf_init() would not work unless + pbuf_pool_memory[] was properly aligned. (Patch by Curt McDowell.) + + 2005-12-20 Leon Woestenberg + * tcp.c: Remove PCBs which stay in LAST_ACK state too long. Patch + submitted by Mitrani Hiroshi. + + 2005-12-15 Christiaan Simons + * inet.c: Disabled the added summing routine to preserve code space. + + 2005-12-14 Leon Woestenberg + * tcp_in.c: Duplicate FIN ACK race condition fix by Kelvin Lawson. + Added Curt McDowell's optimized checksumming routine for future + inclusion. Need to create test case for unaliged, aligned, odd, + even length combination of cases on various endianess machines. + + 2005-12-09 Christiaan Simons + * inet.c: Rewrote standard checksum routine in proper portable C. + + 2005-11-25 Christiaan Simons + * udp.c tcp.c: Removed SO_REUSE hack. Should reside in socket code only. + * *.c: introduced cc.h LWIP_DEBUG formatters matching the u16_t, s16_t, + u32_t, s32_t typedefs. This solves most debug word-length assumes. + + 2005-07-17 Leon Woestenberg + * inet.c: Fixed unaligned 16-bit access in the standard checksum + routine by Peter Jolasson. + * slipif.c: Fixed implementation assumption of single-pbuf datagrams. + + 2005-02-04 Leon Woestenberg + * tcp_out.c: Fixed uninitialized 'queue' referenced in memerr branch. + * tcp_{out|in}.c: Applied patch fixing unaligned access. + + 2005-01-04 Leon Woestenberg + * pbuf.c: Fixed missing semicolon after LWIP_DEBUG statement. + + 2005-01-03 Leon Woestenberg + * udp.c: UDP pcb->recv() was called even when it was NULL. + +(STABLE-1_1_0) + + 2004-12-28 Leon Woestenberg + * etharp.*: Disabled multiple packets on the ARP queue. + This clashes with TCP queueing. + + 2004-11-28 Leon Woestenberg + * etharp.*: Fixed race condition from ARP request to ARP timeout. + Halved the ARP period, doubled the period counts. + ETHARP_MAX_PENDING now should be at least 2. This prevents + the counter from reaching 0 right away (which would allow + too little time for ARP responses to be received). + + 2004-11-25 Leon Woestenberg + * dhcp.c: Decline messages were not multicast but unicast. + * etharp.c: ETHARP_CREATE is renamed to ETHARP_TRY_HARD. + Do not try hard to insert arbitrary packet's source address, + etharp_ip_input() now calls etharp_update() without ETHARP_TRY_HARD. + etharp_query() now always DOES call ETHARP_TRY_HARD so that users + querying an address will see it appear in the cache (DHCP could + suffer from this when a server invalidly gave an in-use address.) + * ipv4/ip_addr.h: Renamed ip_addr_maskcmp() to _netcmp() as we are + comparing network addresses (identifiers), not the network masks + themselves. + * ipv4/ip_addr.c: ip_addr_isbroadcast() now checks that the given + IP address actually belongs to the network of the given interface. + + 2004-11-24 Kieran Mansley + * tcp.c: Increment pcb->snd_buf when ACK is received in SYN_SENT state. + +(STABLE-1_1_0-RC1) + + 2004-10-16 Kieran Mansley + * tcp.c: Add code to tcp_recved() to send an ACK (window update) immediately, + even if one is already pending, if the rcv_wnd is above a threshold + (currently TCP_WND/2). This avoids waiting for a timer to expire to send a + delayed ACK in order to open the window if the stack is only receiving data. + + 2004-09-12 Kieran Mansley + * tcp*.*: Retransmit time-out handling improvement by Sam Jansen. + + 2004-08-20 Tony Mountifield + * etharp.c: Make sure the first pbuf queued on an ARP entry + is properly ref counted. + + 2004-07-27 Tony Mountifield + * debug.h: Added (int) cast in LWIP_DEBUGF() to avoid compiler + warnings about comparison. + * pbuf.c: Stopped compiler complaining of empty if statement + when LWIP_DEBUGF() empty. Closed an unclosed comment. + * tcp.c: Stopped compiler complaining of empty if statement + when LWIP_DEBUGF() empty. + * ip.h Corrected IPH_TOS() macro: returns a byte, so doesn't need htons(). + * inet.c: Added a couple of casts to quiet the compiler. + No need to test isascii(c) before isdigit(c) or isxdigit(c). + + 2004-07-22 Tony Mountifield + * inet.c: Made data types consistent in inet_ntoa(). + Added casts for return values of checksum routines, to pacify compiler. + * ip_frag.c, tcp_out.c, sockets.c, pbuf.c + Small corrections to some debugging statements, to pacify compiler. + + 2004-07-21 Tony Mountifield + * etharp.c: Removed spurious semicolon and added missing end-of-comment. + * ethernetif.c Updated low_level_output() to match prototype for + netif->linkoutput and changed low_level_input() similarly for consistency. + * api_msg.c: Changed recv_raw() from int to u8_t, to match prototype + of raw_recv() in raw.h and so avoid compiler error. + * sockets.c: Added trivial (int) cast to keep compiler happier. + * ip.c, netif.c Changed debug statements to use the tidier ip4_addrN() macros. + +(STABLE-1_0_0) + + ++ Changes: + + 2004-07-05 Leon Woestenberg + * sockets.*: Restructured LWIP_PRIVATE_TIMEVAL. Make sure + your cc.h file defines this either 1 or 0. If non-defined, + defaults to 1. + * .c: Added and includes where used. + * etharp.c: Made some array indices unsigned. + + 2004-06-27 Leon Woestenberg + * netif.*: Added netif_set_up()/down(). + * dhcp.c: Changes to restart program flow. + + 2004-05-07 Leon Woestenberg + * etharp.c: In find_entry(), instead of a list traversal per candidate, do a + single-pass lookup for different candidates. Should exploit locality. + + 2004-04-29 Leon Woestenberg + * tcp*.c: Cleaned up source comment documentation for Doxygen processing. + * opt.h: ETHARP_ALWAYS_INSERT option removed to comply with ARP RFC. + * etharp.c: update_arp_entry() only adds new ARP entries when adviced to by + the caller. This deprecates the ETHARP_ALWAYS_INSERT overrule option. + + ++ Bug fixes: + + 2004-04-27 Leon Woestenberg + * etharp.c: Applied patch of bug #8708 by Toni Mountifield with a solution + suggested by Timmy Brolin. Fix for 32-bit processors that cannot access + non-aligned 32-bit words, such as soms 32-bit TCP/IP header fields. Fix + is to prefix the 14-bit Ethernet headers with two padding bytes. + + 2004-04-23 Leon Woestenberg + * ip_addr.c: Fix in the ip_addr_isbroadcast() check. + * etharp.c: Fixed the case where the packet that initiates the ARP request + is not queued, and gets lost. Fixed the case where the packets destination + address is already known; we now always queue the packet and perform an ARP + request. + +(STABLE-0_7_0) + + ++ Bug fixes: + + * Fixed TCP bug for SYN_SENT to ESTABLISHED state transition. + * Fixed TCP bug in dequeueing of FIN from out of order segment queue. + * Fixed two possible NULL references in rare cases. + +(STABLE-0_6_6) + + ++ Bug fixes: + + * Fixed DHCP which did not include the IP address in DECLINE messages. + + ++ Changes: + + * etharp.c has been hauled over a bit. + +(STABLE-0_6_5) + + ++ Bug fixes: + + * Fixed TCP bug induced by bad window resizing with unidirectional TCP traffic. + * Packets sent from ARP queue had invalid source hardware address. + + ++ Changes: + + * Pass-by ARP requests do now update the cache. + + ++ New features: + + * No longer dependent on ctype.h. + * New socket options. + * Raw IP pcb support. + +(STABLE-0_6_4) + + ++ Bug fixes: + + * Some debug formatters and casts fixed. + * Numereous fixes in PPP. + + ++ Changes: + + * DEBUGF now is LWIP_DEBUGF + * pbuf_dechain() has been re-enabled. + * Mentioned the changed use of CVS branches in README. + +(STABLE-0_6_3) + + ++ Bug fixes: + + * Fixed pool pbuf memory leak in pbuf_alloc(). + Occured if not enough PBUF_POOL pbufs for a packet pbuf chain. + Reported by Savin Zlobec. + + * PBUF_POOL chains had their tot_len field not set for non-first + pbufs. Fixed in pbuf_alloc(). + + ++ New features: + + * Added PPP stack contributed by Marc Boucher + + ++ Changes: + + * Now drops short packets for ICMP/UDP/TCP protocols. More robust. + + * ARP queueuing now queues the latest packet instead of the first. + This is the RFC recommended behaviour, but can be overridden in + lwipopts.h. + +(0.6.2) + + ++ Bugfixes: + + * TCP has been fixed to deal with the new use of the pbuf->ref + counter. + + * DHCP dhcp_inform() crash bug fixed. + + ++ Changes: + + * Removed pbuf_pool_free_cache and pbuf_pool_alloc_cache. Also removed + pbuf_refresh(). This has sped up pbuf pool operations considerably. + Implemented by David Haas. + +(0.6.1) + + ++ New features: + + * The packet buffer implementation has been enhanced to support + zero-copy and copy-on-demand for packet buffers which have their + payloads in application-managed memory. + Implemented by David Haas. + + Use PBUF_REF to make a pbuf refer to RAM. lwIP will use zero-copy + if an outgoing packet can be directly sent on the link, or perform + a copy-on-demand when necessary. + + The application can safely assume the packet is sent, and the RAM + is available to the application directly after calling udp_send() + or similar function. + + ++ Bugfixes: + + * ARP_QUEUEING should now correctly work for all cases, including + PBUF_REF. + Implemented by Leon Woestenberg. + + ++ Changes: + + * IP_ADDR_ANY is no longer a NULL pointer. Instead, it is a pointer + to a '0.0.0.0' IP address. + + * The packet buffer implementation is changed. The pbuf->ref counter + meaning has changed, and several pbuf functions have been + adapted accordingly. + + * netif drivers have to be changed to set the hardware address length field + that must be initialized correctly by the driver (hint: 6 for Ethernet MAC). + See the contrib/ports/c16x cs8900 driver as a driver example. + + * netif's have a dhcp field that must be initialized to NULL by the driver. + See the contrib/ports/c16x cs8900 driver as a driver example. + +(0.5.x) This file has been unmaintained up to 0.6.1. All changes are + logged in CVS but have not been explained here. + +(0.5.3) Changes since version 0.5.2 + + ++ Bugfixes: + + * memp_malloc(MEMP_API_MSG) could fail with multiple application + threads because it wasn't protected by semaphores. + + ++ Other changes: + + * struct ip_addr now packed. + + * The name of the time variable in arp.c has been changed to ctime + to avoid conflicts with the time() function. + +(0.5.2) Changes since version 0.5.1 + + ++ New features: + + * A new TCP function, tcp_tmr(), now handles both TCP timers. + + ++ Bugfixes: + + * A bug in tcp_parseopt() could cause the stack to hang because of a + malformed TCP option. + + * The address of new connections in the accept() function in the BSD + socket library was not handled correctly. + + * pbuf_dechain() did not update the ->tot_len field of the tail. + + * Aborted TCP connections were not handled correctly in all + situations. + + ++ Other changes: + + * All protocol header structs are now packed. + + * The ->len field in the tcp_seg structure now counts the actual + amount of data, and does not add one for SYN and FIN segments. + +(0.5.1) Changes since version 0.5.0 + + ++ New features: + + * Possible to run as a user process under Linux. + + * Preliminary support for cross platform packed structs. + + * ARP timer now implemented. + + ++ Bugfixes: + + * TCP output queue length was badly initialized when opening + connections. + + * TCP delayed ACKs were not sent correctly. + + * Explicit initialization of BSS segment variables. + + * read() in BSD socket library could drop data. + + * Problems with memory alignment. + + * Situations when all TCP buffers were used could lead to + starvation. + + * TCP MSS option wasn't parsed correctly. + + * Problems with UDP checksum calculation. + + * IP multicast address tests had endianess problems. + + * ARP requests had wrong destination hardware address. + + ++ Other changes: + + * struct eth_addr changed from u16_t[3] array to u8_t[6]. + + * A ->linkoutput() member was added to struct netif. + + * TCP and UDP ->dest_* struct members where changed to ->remote_*. + + * ntoh* macros are now null definitions for big endian CPUs. + +(0.5.0) Changes since version 0.4.2 + + ++ New features: + + * Redesigned operating system emulation layer to make porting easier. + + * Better control over TCP output buffers. + + * Documenation added. + + ++ Bugfixes: + + * Locking issues in buffer management. + + * Bugfixes in the sequential API. + + * IP forwarding could cause memory leakage. This has been fixed. + + ++ Other changes: + + * Directory structure somewhat changed; the core/ tree has been + collapsed. + +(0.4.2) Changes since version 0.4.1 + + ++ New features: + + * Experimental ARP implementation added. + + * Skeleton Ethernet driver added. + + * Experimental BSD socket API library added. + + ++ Bugfixes: + + * In very intense situations, memory leakage could occur. This has + been fixed. + + ++ Other changes: + + * Variables named "data" and "code" have been renamed in order to + avoid name conflicts in certain compilers. + + * Variable++ have in appliciable cases been translated to ++variable + since some compilers generate better code in the latter case. + +(0.4.1) Changes since version 0.4 + + ++ New features: + + * TCP: Connection attempts time out earlier than data + transmissions. Nagle algorithm implemented. Push flag set on the + last segment in a burst. + + * UDP: experimental support for UDP-Lite extensions. + + ++ Bugfixes: + + * TCP: out of order segments were in some cases handled incorrectly, + and this has now been fixed. Delayed acknowledgements was broken + in 0.4, has now been fixed. Binding to an address that is in use + now results in an error. Reset connections sometimes hung an + application; this has been fixed. + + * Checksum calculation sometimes failed for chained pbufs with odd + lengths. This has been fixed. + + * API: a lot of bug fixes in the API. The UDP API has been improved + and tested. Error reporting and handling has been + improved. Logical flaws and race conditions for incoming TCP + connections has been found and removed. + + * Memory manager: alignment issues. Reallocating memory sometimes + failed, this has been fixed. + + * Generic library: bcopy was flawed and has been fixed. + + ++ Other changes: + + * API: all datatypes has been changed from generic ones such as + ints, to specified ones such as u16_t. Functions that return + errors now have the correct type (err_t). + + * General: A lot of code cleaned up and debugging code removed. Many + portability issues have been fixed. + + * The license was changed; the advertising clause was removed. + + * C64 port added. + + * Thanks: Huge thanks go to Dagan Galarneau, Horst Garnetzke, Petri + Kosunen, Mikael Caleres, and Frits Wilmink for reporting and + fixing bugs! + +(0.4) Changes since version 0.3.1 + + * Memory management has been radically changed; instead of + allocating memory from a shared heap, memory for objects that are + rapidly allocated and deallocated is now kept in pools. Allocation + and deallocation from those memory pools is very fast. The shared + heap is still present but is used less frequently. + + * The memory, memory pool, and packet buffer subsystems now support + 4-, 2-, or 1-byte alignment. + + * "Out of memory" situations are handled in a more robust way. + + * Stack usage has been reduced. + + * Easier configuration of lwIP parameters such as memory usage, + TTLs, statistics gathering, etc. All configuration parameters are + now kept in a single header file "lwipopts.h". + + * The directory structure has been changed slightly so that all + architecture specific files are kept under the src/arch + hierarchy. + + * Error propagation has been improved, both in the protocol modules + and in the API. + + * The code for the RTXC architecture has been implemented, tested + and put to use. + + * Bugs have been found and corrected in the TCP, UDP, IP, API, and + the Internet checksum modules. + + * Bugs related to porting between a 32-bit and a 16-bit architecture + have been found and corrected. + + * The license has been changed slightly to conform more with the + original BSD license, including the advertisement clause. + +(0.3.1) Changes since version 0.3 + + * Fix of a fatal bug in the buffer management. Pbufs with allocated + RAM never returned the RAM when the pbuf was deallocated. + + * TCP congestion control, window updates and retransmissions did not + work correctly. This has now been fixed. + + * Bugfixes in the API. + +(0.3) Changes since version 0.2 + + * New and improved directory structure. All include files are now + kept in a dedicated include/ directory. + + * The API now has proper error handling. A new function, + netconn_err(), now returns an error code for the connection in + case of errors. + + * Improvements in the memory management subsystem. The system now + keeps a pointer to the lowest free memory block. A new function, + mem_malloc2() tries to allocate memory once, and if it fails tries + to free some memory and retry the allocation. + + * Much testing has been done with limited memory + configurations. lwIP now does a better job when overloaded. + + * Some bugfixes and improvements to the buffer (pbuf) subsystem. + + * Many bugfixes in the TCP code: + + - Fixed a bug in tcp_close(). + + - The TCP receive window was incorrectly closed when out of + sequence segments was received. This has been fixed. + + - Connections are now timed-out of the FIN-WAIT-2 state. + + - The initial congestion window could in some cases be too + large. This has been fixed. + + - The retransmission queue could in some cases be screwed up. This + has been fixed. + + - TCP RST flag now handled correctly. + + - Out of sequence data was in some cases never delivered to the + application. This has been fixed. + + - Retransmitted segments now contain the correct acknowledgment + number and advertised window. + + - TCP retransmission timeout backoffs are not correctly computed + (ala BSD). After a number of retransmissions, TCP now gives up + the connection. + + * TCP connections now are kept on three lists, one for active + connections, one for listening connections, and one for + connections that are in TIME-WAIT. This greatly speeds up the fast + timeout processing for sending delayed ACKs. + + * TCP now provides proper feedback to the application when a + connection has been successfully set up. + + * More comments have been added to the code. The code has also been + somewhat cleaned up. + +(0.2) Initial public release. diff --git a/components/lwip/COPYING b/components/lwip/COPYING new file mode 100755 index 000000000..e23898b5e --- /dev/null +++ b/components/lwip/COPYING @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2001, 2002 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + + diff --git a/components/lwip/Kconfig b/components/lwip/Kconfig new file mode 100644 index 000000000..ee6511e00 --- /dev/null +++ b/components/lwip/Kconfig @@ -0,0 +1,14 @@ +menu "LWIP" + +config LWIP_MAX_SOCKETS + int "Max number of open sockets" + range 1 16 + default 4 + help + Sockets take up a certain amount of memory, and allowing fewer + sockets to be open at the same time conserves memory. Specify + the maximum amount of sockets here. + +endmenu + + diff --git a/components/lwip/Makefile b/components/lwip/Makefile new file mode 100755 index 000000000..b2de346b2 --- /dev/null +++ b/components/lwip/Makefile @@ -0,0 +1,16 @@ +# +# Component Makefile +# +# This Makefile should, at the very least, just include $(SDK_PATH)/make/component.mk. By default, +# this will take the sources in this directory, compile them and link them into +# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable, +# please read the SDK documents if you need to do this. +# + +COMPONENT_ADD_INCLUDEDIRS := include/lwip include/lwip/port + +COMPONENT_SRCDIRS := api apps core/ipv4 core/ipv6 core netif port/freertos port/netif port + +EXTRA_CFLAGS := -Wno-error=address -Waddress -DLWIP_ESP8266 + +include $(SDK_PATH)/make/component.mk diff --git a/components/lwip/README b/components/lwip/README new file mode 100755 index 000000000..495556ef2 --- /dev/null +++ b/components/lwip/README @@ -0,0 +1,86 @@ +INTRODUCTION + +lwIP is a small independent implementation of the TCP/IP protocol +suite that has been developed by Adam Dunkels at the Computer and +Networks Architectures (CNA) lab at the Swedish Institute of Computer +Science (SICS). + +The focus of the lwIP TCP/IP implementation is to reduce the RAM usage +while still having a full scale TCP. This making lwIP suitable for use +in embedded systems with tens of kilobytes of free RAM and room for +around 40 kilobytes of code ROM. + +FEATURES + + * IP (Internet Protocol) including packet forwarding over multiple network + interfaces + * ICMP (Internet Control Message Protocol) for network maintenance and debugging + * IGMP (Internet Group Management Protocol) for multicast traffic management + * UDP (User Datagram Protocol) including experimental UDP-lite extensions + * TCP (Transmission Control Protocol) with congestion control, RTT estimation + and fast recovery/fast retransmit + * Specialized raw/native API for enhanced performance + * Optional Berkeley-like socket API + * DNS (Domain names resolver) + * SNMP (Simple Network Management Protocol) + * DHCP (Dynamic Host Configuration Protocol) + * AUTOIP (for IPv4, conform with RFC 3927) + * PPP (Point-to-Point Protocol) + * ARP (Address Resolution Protocol) for Ethernet + +LICENSE + +lwIP is freely available under a BSD license. + +DEVELOPMENT + +lwIP has grown into an excellent TCP/IP stack for embedded devices, +and developers using the stack often submit bug fixes, improvements, +and additions to the stack to further increase its usefulness. + +Development of lwIP is hosted on Savannah, a central point for +software development, maintenance and distribution. Everyone can +help improve lwIP by use of Savannah's interface, Git and the +mailing list. A core team of developers will commit changes to the +Git source tree. + +The lwIP TCP/IP stack is maintained in the 'lwip' Git module and +contributions (such as platform ports) are in the 'contrib' Git module. + +See doc/savannah.txt for details on Git server access for users and +developers. + +The current Git trees are web-browsable: + http://git.savannah.gnu.org/cgit/lwip.git + http://git.savannah.gnu.org/cgit/lwip/lwip-contrib.git + +Submit patches and bugs via the lwIP project page: + http://savannah.nongnu.org/projects/lwip/ + + +DOCUMENTATION + +The original out-dated homepage of lwIP and Adam Dunkels' papers on +lwIP are at the official lwIP home page: + http://www.sics.se/~adam/lwip/ + +Self documentation of the source code is regularly extracted from the +current Git sources and is available from this web page: + http://www.nongnu.org/lwip/ + +There is now a constantly growin wiki about lwIP at + http://lwip.wikia.com/wiki/LwIP_Wiki + +Also, there are mailing lists you can subscribe at + http://savannah.nongnu.org/mail/?group=lwip +plus searchable archives: + http://lists.nongnu.org/archive/html/lwip-users/ + http://lists.nongnu.org/archive/html/lwip-devel/ + +Reading Adam's papers, the files in docs/, browsing the source code +documentation and browsing the mailing list archives is a good way to +become familiar with the design of lwIP. + +Adam Dunkels +Leon Woestenberg + diff --git a/components/lwip/VERSION b/components/lwip/VERSION new file mode 100644 index 000000000..4276fd51a --- /dev/null +++ b/components/lwip/VERSION @@ -0,0 +1 @@ +bf7fc41e \ No newline at end of file diff --git a/components/lwip/api/api_lib.c b/components/lwip/api/api_lib.c new file mode 100755 index 000000000..c38c76081 --- /dev/null +++ b/components/lwip/api/api_lib.c @@ -0,0 +1,979 @@ +/** + * @file + * Sequential API External module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +/* This is the part of the API that is linked with + the application */ + +#include "lwip/opt.h" + +#if LWIP_NETCONN /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/api.h" +#include "lwip/memp.h" + +#include "lwip/ip.h" +#include "lwip/raw.h" +#include "lwip/udp.h" +#include "lwip/priv/api_msg.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/priv/tcpip_priv.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +#define API_MSG_VAR_REF(name) API_VAR_REF(name) +#define API_MSG_VAR_DECLARE(name) API_VAR_DECLARE(struct api_msg, name) +#define API_MSG_VAR_ALLOC(name) API_VAR_ALLOC(struct api_msg, MEMP_API_MSG, name) +#define API_MSG_VAR_ALLOC_DONTFAIL(name) API_VAR_ALLOC_DONTFAIL(struct api_msg, MEMP_API_MSG, name) +#define API_MSG_VAR_FREE(name) API_VAR_FREE(MEMP_API_MSG, name) + +static err_t netconn_close_shutdown(struct netconn *conn, u8_t how); + +#if !LWIP_TCPIP_CORE_LOCKING +/** + * Call the lower part of a netconn_* function + * This function is then running in the thread context + * of tcpip_thread and has exclusive access to lwIP core code. + * + * @param apimsg a struct containing the function to call and its parameters + * @return ERR_OK if the function was called, another err_t if not + */ +static err_t +tcpip_apimsg(struct api_msg *apimsg) +{ +#ifdef LWIP_DEBUG + /* catch functions that don't set err */ + apimsg->msg.err = ERR_VAL; +#endif +#if LWIP_NETCONN_SEM_PER_THREAD + apimsg->msg.op_completed_sem = LWIP_NETCONN_THREAD_SEM_GET(); + LWIP_ASSERT("netconn semaphore not initialized", + sys_sem_valid(apimsg->msg.op_completed_sem)); +#endif + + if (tcpip_send_api_msg(apimsg->function, &apimsg->msg, LWIP_API_MSG_SEM(&apimsg->msg)) == ERR_OK) { + return apimsg->msg.err; + } + + return ERR_VAL; +} +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + +/** + * Create a new netconn (of a specific type) that has a callback function. + * The corresponding pcb is also created. + * + * @param t the type of 'connection' to create (@see enum netconn_type) + * @param proto the IP protocol for RAW IP pcbs + * @param callback a function to call on status changes (RX available, TX'ed) + * @return a newly allocated struct netconn or + * NULL on memory error + */ +struct netconn* +netconn_new_with_proto_and_callback(enum netconn_type t, u8_t proto, netconn_callback callback) +{ + struct netconn *conn; + API_MSG_VAR_DECLARE(msg); + + conn = netconn_alloc(t, callback); + if (conn != NULL) { + err_t err; + API_MSG_VAR_ALLOC_DONTFAIL(msg); + API_MSG_VAR_REF(msg).msg.msg.n.proto = proto; + API_MSG_VAR_REF(msg).msg.conn = conn; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_newconn, err); + API_MSG_VAR_FREE(msg); + if (err != ERR_OK) { + LWIP_ASSERT("freeing conn without freeing pcb", conn->pcb.tcp == NULL); + LWIP_ASSERT("conn has no recvmbox", sys_mbox_valid(&conn->recvmbox)); +#if LWIP_TCP + LWIP_ASSERT("conn->acceptmbox shouldn't exist", !sys_mbox_valid(&conn->acceptmbox)); +#endif /* LWIP_TCP */ +#if !LWIP_NETCONN_SEM_PER_THREAD + LWIP_ASSERT("conn has no op_completed", sys_sem_valid(&conn->op_completed)); + sys_sem_free(&conn->op_completed); +#endif /* !LWIP_NETCONN_SEM_PER_THREAD */ + sys_mbox_free(&conn->recvmbox); + memp_free(MEMP_NETCONN, conn); + return NULL; + } + } + return conn; +} + +/** + * Close a netconn 'connection' and free its resources. + * UDP and RAW connection are completely closed, TCP pcbs might still be in a waitstate + * after this returns. + * + * @param conn the netconn to delete + * @return ERR_OK if the connection was deleted + */ +err_t +netconn_delete(struct netconn *conn) +{ + err_t err; + API_MSG_VAR_DECLARE(msg); + + /* No ASSERT here because possible to get a (conn == NULL) if we got an accept error */ + if (conn == NULL) { + return ERR_OK; + } + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; +#if LWIP_SO_SNDTIMEO || LWIP_SO_LINGER + /* get the time we started, which is later compared to + sys_now() + conn->send_timeout */ + API_MSG_VAR_REF(msg).msg.msg.sd.time_started = sys_now(); +#else /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ +#if LWIP_TCP + API_MSG_VAR_REF(msg).msg.msg.sd.polls_left = + ((LWIP_TCP_CLOSE_TIMEOUT_MS_DEFAULT + TCP_SLOW_INTERVAL - 1) / TCP_SLOW_INTERVAL) + 1; +#endif /* LWIP_TCP */ +#endif /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_delconn, err); + API_MSG_VAR_FREE(msg); + + if (err != ERR_OK) { + return err; + } + +#if !LWIP_THREAD_SAFE + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("netconn_delete - free conn\n")); + netconn_free(conn); +#endif + + return ERR_OK; +} + +/** + * Get the local or remote IP address and port of a netconn. + * For RAW netconns, this returns the protocol instead of a port! + * + * @param conn the netconn to query + * @param addr a pointer to which to save the IP address + * @param port a pointer to which to save the port (or protocol for RAW) + * @param local 1 to get the local IP address, 0 to get the remote one + * @return ERR_CONN for invalid connections + * ERR_OK if the information was retrieved + */ +err_t +netconn_getaddr(struct netconn *conn, ip_addr_t *addr, u16_t *port, u8_t local) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_getaddr: invalid conn", (conn != NULL), return ERR_ARG;); + LWIP_ERROR("netconn_getaddr: invalid addr", (addr != NULL), return ERR_ARG;); + LWIP_ERROR("netconn_getaddr: invalid port", (port != NULL), return ERR_ARG;); + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.ad.local = local; +#if LWIP_MPU_COMPATIBLE + TCPIP_APIMSG(msg, lwip_netconn_do_getaddr, err); + *addr = msg->msg.msg.ad.ipaddr; + *port = msg->msg.msg.ad.port; +#else /* LWIP_MPU_COMPATIBLE */ + msg.msg.msg.ad.ipaddr = addr; + msg.msg.msg.ad.port = port; + TCPIP_APIMSG(&msg, lwip_netconn_do_getaddr, err); +#endif /* LWIP_MPU_COMPATIBLE */ + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Bind a netconn to a specific local IP address and port. + * Binding one netconn twice might not always be checked correctly! + * + * @param conn the netconn to bind + * @param addr the local IP address to bind the netconn to (use IP_ADDR_ANY + * to bind to all addresses) + * @param port the local port to bind the netconn to (not used for RAW) + * @return ERR_OK if bound, any other err_t on failure + */ +err_t +netconn_bind(struct netconn *conn, const ip_addr_t *addr, u16_t port) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_bind: invalid conn", (conn != NULL), return ERR_ARG;); + + /* Don't propagate NULL pointer (IP_ADDR_ANY alias) to subsequent functions */ + if (addr == NULL) { + addr = IP_ADDR_ANY; + } + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.bc.ipaddr = API_MSG_VAR_REF(addr); + API_MSG_VAR_REF(msg).msg.msg.bc.port = port; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_bind, err); + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Connect a netconn to a specific remote IP address and port. + * + * @param conn the netconn to connect + * @param addr the remote IP address to connect to + * @param port the remote port to connect to (no used for RAW) + * @return ERR_OK if connected, return value of tcp_/udp_/raw_connect otherwise + */ +err_t +netconn_connect(struct netconn *conn, const ip_addr_t *addr, u16_t port) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_connect: invalid conn", (conn != NULL), return ERR_ARG;); + + /* Don't propagate NULL pointer (IP_ADDR_ANY alias) to subsequent functions */ + if (addr == NULL) { + addr = IP_ADDR_ANY; + } + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.bc.ipaddr = API_MSG_VAR_REF(addr); + API_MSG_VAR_REF(msg).msg.msg.bc.port = port; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_connect, err); + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Disconnect a netconn from its current peer (only valid for UDP netconns). + * + * @param conn the netconn to disconnect + * @return TODO: return value is not set here... + */ +err_t +netconn_disconnect(struct netconn *conn) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_disconnect: invalid conn", (conn != NULL), return ERR_ARG;); + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_disconnect, err); + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Set a TCP netconn into listen mode + * + * @param conn the tcp netconn to set to listen mode + * @param backlog the listen backlog, only used if TCP_LISTEN_BACKLOG==1 + * @return ERR_OK if the netconn was set to listen (UDP and RAW netconns + * don't return any error (yet?)) + */ +err_t +netconn_listen_with_backlog(struct netconn *conn, u8_t backlog) +{ +#if LWIP_TCP + API_MSG_VAR_DECLARE(msg); + err_t err; + + /* This does no harm. If TCP_LISTEN_BACKLOG is off, backlog is unused. */ + LWIP_UNUSED_ARG(backlog); + + LWIP_ERROR("netconn_listen: invalid conn", (conn != NULL), return ERR_ARG;); + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; +#if TCP_LISTEN_BACKLOG + API_MSG_VAR_REF(msg).msg.msg.lb.backlog = backlog; +#endif /* TCP_LISTEN_BACKLOG */ + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_listen, err); + API_MSG_VAR_FREE(msg); + + return err; +#else /* LWIP_TCP */ + LWIP_UNUSED_ARG(conn); + LWIP_UNUSED_ARG(backlog); + return ERR_ARG; +#endif /* LWIP_TCP */ +} + +/** + * Accept a new connection on a TCP listening netconn. + * + * @param conn the TCP listen netconn + * @param new_conn pointer where the new connection is stored + * @return ERR_OK if a new connection has been received or an error + * code otherwise + */ +err_t +netconn_accept(struct netconn *conn, struct netconn **new_conn) +{ +#if LWIP_TCP + struct netconn *newconn; + err_t err; +#if TCP_LISTEN_BACKLOG + API_MSG_VAR_DECLARE(msg); +#endif /* TCP_LISTEN_BACKLOG */ + + LWIP_ERROR("netconn_accept: invalid pointer", (new_conn != NULL), return ERR_ARG;); + *new_conn = NULL; + LWIP_ERROR("netconn_accept: invalid conn", (conn != NULL), return ERR_ARG;); + LWIP_ERROR("netconn_accept: invalid acceptmbox", sys_mbox_valid(&conn->acceptmbox), return ERR_ARG;); + + err = conn->last_err; + if (ERR_IS_FATAL(err)) { + /* don't recv on fatal errors: this might block the application task + waiting on acceptmbox forever! */ + return err; + } + +#if LWIP_SO_RCVTIMEO + if (sys_arch_mbox_fetch(&conn->acceptmbox, (void **)&newconn, conn->recv_timeout) == SYS_ARCH_TIMEOUT) { + return ERR_TIMEOUT; + } +#else + sys_arch_mbox_fetch(&conn->acceptmbox, (void **)&newconn, 0); +#endif /* LWIP_SO_RCVTIMEO*/ + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVMINUS, 0); + + if (newconn == NULL) { + /* connection has been aborted */ + /* in this special case, we set the netconn error from application thread, as + on a ready-to-accept listening netconn, there should not be anything running + in tcpip_thread */ + NETCONN_SET_SAFE_ERR(conn, ERR_ABRT); + return ERR_ABRT; + } +#if TCP_LISTEN_BACKLOG + /* Let the stack know that we have accepted the connection. */ + API_MSG_VAR_ALLOC_DONTFAIL(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + /* don't care for the return value of lwip_netconn_do_recv */ + TCPIP_APIMSG_NOERR(&API_MSG_VAR_REF(msg), lwip_netconn_do_recv); + API_MSG_VAR_FREE(msg); +#endif /* TCP_LISTEN_BACKLOG */ + + *new_conn = newconn; + /* don't set conn->last_err: it's only ERR_OK, anyway */ + return ERR_OK; +#else /* LWIP_TCP */ + LWIP_UNUSED_ARG(conn); + LWIP_UNUSED_ARG(new_conn); + return ERR_ARG; +#endif /* LWIP_TCP */ +} + +/** + * Receive data: actual implementation that doesn't care whether pbuf or netbuf + * is received + * + * @param conn the netconn from which to receive data + * @param new_buf pointer where a new pbuf/netbuf is stored when received data + * @return ERR_OK if data has been received, an error code otherwise (timeout, + * memory error or another error) + */ +static err_t +netconn_recv_data(struct netconn *conn, void **new_buf) +{ + void *buf = NULL; + u16_t len; + err_t err; +#if LWIP_TCP + API_MSG_VAR_DECLARE(msg); +#endif /* LWIP_TCP */ + + LWIP_ERROR("netconn_recv: invalid pointer", (new_buf != NULL), return ERR_ARG;); + *new_buf = NULL; + LWIP_ERROR("netconn_recv: invalid conn", (conn != NULL), return ERR_ARG;); +#if LWIP_TCP +#if (LWIP_UDP || LWIP_RAW) + if (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) +#endif /* (LWIP_UDP || LWIP_RAW) */ + { + if (!sys_mbox_valid(&conn->recvmbox)) { + /* This happens when calling this function after receiving FIN */ + return sys_mbox_valid(&conn->acceptmbox) ? ERR_CONN : ERR_CLSD; + } + } +#endif /* LWIP_TCP */ + LWIP_ERROR("netconn_recv: invalid recvmbox", sys_mbox_valid(&conn->recvmbox), return ERR_CONN;); + + err = conn->last_err; + if (ERR_IS_FATAL(err)) { + /* don't recv on fatal errors: this might block the application task + waiting on recvmbox forever! */ + /* @todo: this does not allow us to fetch data that has been put into recvmbox + before the fatal error occurred - is that a problem? */ + return err; + } + +#if LWIP_SO_RCVTIMEO + if (sys_arch_mbox_fetch(&conn->recvmbox, &buf, conn->recv_timeout) == SYS_ARCH_TIMEOUT) { + return ERR_TIMEOUT; + } +#else + sys_arch_mbox_fetch(&conn->recvmbox, &buf, 0); +#endif /* LWIP_SO_RCVTIMEO*/ + +#if LWIP_TCP +#if (LWIP_UDP || LWIP_RAW) + if (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) +#endif /* (LWIP_UDP || LWIP_RAW) */ + { + if (!netconn_get_noautorecved(conn) || (buf == NULL)) { + /* Let the stack know that we have taken the data. */ + /* TODO: Speedup: Don't block and wait for the answer here + (to prevent multiple thread-switches). */ + API_MSG_VAR_ALLOC_DONTFAIL(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + if (buf != NULL) { + API_MSG_VAR_REF(msg).msg.msg.r.len = ((struct pbuf *)buf)->tot_len; + } else { + API_MSG_VAR_REF(msg).msg.msg.r.len = 1; + } + /* don't care for the return value of lwip_netconn_do_recv */ + TCPIP_APIMSG_NOERR(&API_MSG_VAR_REF(msg), lwip_netconn_do_recv); + API_MSG_VAR_FREE(msg); + } + + /* If we are closed, we indicate that we no longer wish to use the socket */ + if (buf == NULL) { + API_EVENT(conn, NETCONN_EVT_RCVMINUS, 0); + /* RX side is closed, so deallocate the recvmbox */ + netconn_close_shutdown(conn, NETCONN_SHUT_RD); + /* Don' store ERR_CLSD as conn->err since we are only half-closed */ + return ERR_CLSD; + } + len = ((struct pbuf *)buf)->tot_len; + } +#endif /* LWIP_TCP */ +#if LWIP_TCP && (LWIP_UDP || LWIP_RAW) + else +#endif /* LWIP_TCP && (LWIP_UDP || LWIP_RAW) */ +#if (LWIP_UDP || LWIP_RAW) + { +#if LWIP_THREAD_SAFE + if (buf == NULL){ + API_EVENT(conn, NETCONN_EVT_RCVMINUS, 0); + return ERR_CLSD; + } +#endif + LWIP_ASSERT("buf != NULL", buf != NULL); + len = netbuf_len((struct netbuf *)buf); + } +#endif /* (LWIP_UDP || LWIP_RAW) */ + +#if LWIP_SO_RCVBUF + SYS_ARCH_DEC(conn->recv_avail, len); +#endif /* LWIP_SO_RCVBUF */ + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVMINUS, len); + + LWIP_DEBUGF(API_LIB_DEBUG, ("netconn_recv_data: received %p, len=%"U16_F"\n", buf, len)); + + *new_buf = buf; + /* don't set conn->last_err: it's only ERR_OK, anyway */ + return ERR_OK; +} + +/** + * Receive data (in form of a pbuf) from a TCP netconn + * + * @param conn the netconn from which to receive data + * @param new_buf pointer where a new pbuf is stored when received data + * @return ERR_OK if data has been received, an error code otherwise (timeout, + * memory error or another error) + * ERR_ARG if conn is not a TCP netconn + */ +err_t +netconn_recv_tcp_pbuf(struct netconn *conn, struct pbuf **new_buf) +{ + LWIP_ERROR("netconn_recv: invalid conn", (conn != NULL) && + NETCONNTYPE_GROUP(netconn_type(conn)) == NETCONN_TCP, return ERR_ARG;); + + return netconn_recv_data(conn, (void **)new_buf); +} + +/** + * Receive data (in form of a netbuf containing a packet buffer) from a netconn + * + * @param conn the netconn from which to receive data + * @param new_buf pointer where a new netbuf is stored when received data + * @return ERR_OK if data has been received, an error code otherwise (timeout, + * memory error or another error) + */ +err_t +netconn_recv(struct netconn *conn, struct netbuf **new_buf) +{ +#if LWIP_TCP + struct netbuf *buf = NULL; + err_t err; +#endif /* LWIP_TCP */ + + LWIP_ERROR("netconn_recv: invalid pointer", (new_buf != NULL), return ERR_ARG;); + *new_buf = NULL; + LWIP_ERROR("netconn_recv: invalid conn", (conn != NULL), return ERR_ARG;); + +#if LWIP_TCP +#if (LWIP_UDP || LWIP_RAW) + if (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) +#endif /* (LWIP_UDP || LWIP_RAW) */ + { + struct pbuf *p = NULL; + /* This is not a listening netconn, since recvmbox is set */ + + buf = (struct netbuf *)memp_malloc(MEMP_NETBUF); + if (buf == NULL) { + return ERR_MEM; + } + + err = netconn_recv_data(conn, (void **)&p); + if (err != ERR_OK) { + memp_free(MEMP_NETBUF, buf); + return err; + } + LWIP_ASSERT("p != NULL", p != NULL); + + buf->p = p; + buf->ptr = p; + buf->port = 0; + ip_addr_set_zero(&buf->addr); + *new_buf = buf; + /* don't set conn->last_err: it's only ERR_OK, anyway */ + return ERR_OK; + } +#endif /* LWIP_TCP */ +#if LWIP_TCP && (LWIP_UDP || LWIP_RAW) + else +#endif /* LWIP_TCP && (LWIP_UDP || LWIP_RAW) */ + { +#if (LWIP_UDP || LWIP_RAW) + return netconn_recv_data(conn, (void **)new_buf); +#endif /* (LWIP_UDP || LWIP_RAW) */ + } +} + +/** + * TCP: update the receive window: by calling this, the application + * tells the stack that it has processed data and is able to accept + * new data. + * ATTENTION: use with care, this is mainly used for sockets! + * Can only be used when calling netconn_set_noautorecved(conn, 1) before. + * + * @param conn the netconn for which to update the receive window + * @param length amount of data processed (ATTENTION: this must be accurate!) + */ +void +netconn_recved(struct netconn *conn, u32_t length) +{ +#if LWIP_TCP + if ((conn != NULL) && (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) && + (netconn_get_noautorecved(conn))) { + API_MSG_VAR_DECLARE(msg); + /* Let the stack know that we have taken the data. */ + /* TODO: Speedup: Don't block and wait for the answer here + (to prevent multiple thread-switches). */ + API_MSG_VAR_ALLOC_DONTFAIL(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.r.len = length; + /* don't care for the return value of lwip_netconn_do_recv */ + TCPIP_APIMSG_NOERR(&API_MSG_VAR_REF(msg), lwip_netconn_do_recv); + API_MSG_VAR_FREE(msg); + } +#else /* LWIP_TCP */ + LWIP_UNUSED_ARG(conn); + LWIP_UNUSED_ARG(length); +#endif /* LWIP_TCP */ +} + +/** + * Send data (in form of a netbuf) to a specific remote IP address and port. + * Only to be used for UDP and RAW netconns (not TCP). + * + * @param conn the netconn over which to send data + * @param buf a netbuf containing the data to send + * @param addr the remote IP address to which to send the data + * @param port the remote port to which to send the data + * @return ERR_OK if data was sent, any other err_t on error + */ +err_t +netconn_sendto(struct netconn *conn, struct netbuf *buf, const ip_addr_t *addr, u16_t port) +{ + if (buf != NULL) { + ip_addr_set(&buf->addr, addr); + buf->port = port; + return netconn_send(conn, buf); + } + return ERR_VAL; +} + +/** + * Send data over a UDP or RAW netconn (that is already connected). + * + * @param conn the UDP or RAW netconn over which to send data + * @param buf a netbuf containing the data to send + * @return ERR_OK if data was sent, any other err_t on error + */ +err_t +netconn_send(struct netconn *conn, struct netbuf *buf) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_send: invalid conn", (conn != NULL), return ERR_ARG;); + + LWIP_DEBUGF(API_LIB_DEBUG, ("netconn_send: sending %"U16_F" bytes\n", buf->p->tot_len)); + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.b = buf; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_send, err); + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Send data over a TCP netconn. + * + * @param conn the TCP netconn over which to send data + * @param dataptr pointer to the application buffer that contains the data to send + * @param size size of the application data to send + * @param apiflags combination of following flags : + * - NETCONN_COPY: data will be copied into memory belonging to the stack + * - NETCONN_MORE: for TCP connection, PSH flag will be set on last segment sent + * - NETCONN_DONTBLOCK: only write the data if all data can be written at once + * @param bytes_written pointer to a location that receives the number of written bytes + * @return ERR_OK if data was sent, any other err_t on error + */ +err_t +netconn_write_partly(struct netconn *conn, const void *dataptr, size_t size, + u8_t apiflags, size_t *bytes_written) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + u8_t dontblock; + + LWIP_ERROR("netconn_write: invalid conn", (conn != NULL), return ERR_ARG;); + LWIP_ERROR("netconn_write: invalid conn->type", (NETCONNTYPE_GROUP(conn->type)== NETCONN_TCP), return ERR_VAL;); + if (size == 0) { + return ERR_OK; + } + dontblock = netconn_is_nonblocking(conn) || (apiflags & NETCONN_DONTBLOCK); + +#ifdef LWIP_ESP8266 + +#ifdef FOR_XIAOMI + if (dontblock && bytes_written) { +#else + if (dontblock && !bytes_written) { +#endif + +#else + if (dontblock && !bytes_written) { +#endif + /* This implies netconn_write() cannot be used for non-blocking send, since + it has no way to return the number of bytes written. */ + return ERR_VAL; + } + + API_MSG_VAR_ALLOC(msg); + /* non-blocking write sends as much */ + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.w.dataptr = dataptr; + API_MSG_VAR_REF(msg).msg.msg.w.apiflags = apiflags; + API_MSG_VAR_REF(msg).msg.msg.w.len = size; +#if LWIP_SO_SNDTIMEO + if (conn->send_timeout != 0) { + /* get the time we started, which is later compared to + sys_now() + conn->send_timeout */ + API_MSG_VAR_REF(msg).msg.msg.w.time_started = sys_now(); + } else { + API_MSG_VAR_REF(msg).msg.msg.w.time_started = 0; + } +#endif /* LWIP_SO_SNDTIMEO */ + + /* For locking the core: this _can_ be delayed on low memory/low send buffer, + but if it is, this is done inside api_msg.c:do_write(), so we can use the + non-blocking version here. */ + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_write, err); + if ((err == ERR_OK) && (bytes_written != NULL)) { + if (dontblock +#if LWIP_SO_SNDTIMEO + || (conn->send_timeout != 0) +#endif /* LWIP_SO_SNDTIMEO */ + ) { + /* nonblocking write: maybe the data has been sent partly */ + *bytes_written = API_MSG_VAR_REF(msg).msg.msg.w.len; + } else { + /* blocking call succeeded: all data has been sent if it */ + *bytes_written = size; + } + } + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Close or shutdown a TCP netconn (doesn't delete it). + * + * @param conn the TCP netconn to close or shutdown + * @param how fully close or only shutdown one side? + * @return ERR_OK if the netconn was closed, any other err_t on error + */ +static err_t +netconn_close_shutdown(struct netconn *conn, u8_t how) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + LWIP_UNUSED_ARG(how); + + LWIP_ERROR("netconn_close: invalid conn", (conn != NULL), return ERR_ARG;); + + API_MSG_VAR_ALLOC(msg); + API_MSG_VAR_REF(msg).msg.conn = conn; +#if LWIP_TCP + /* shutting down both ends is the same as closing */ + API_MSG_VAR_REF(msg).msg.msg.sd.shut = how; +#if LWIP_SO_SNDTIMEO || LWIP_SO_LINGER + /* get the time we started, which is later compared to + sys_now() + conn->send_timeout */ + API_MSG_VAR_REF(msg).msg.msg.sd.time_started = sys_now(); +#else /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + API_MSG_VAR_REF(msg).msg.msg.sd.polls_left = + ((LWIP_TCP_CLOSE_TIMEOUT_MS_DEFAULT + TCP_SLOW_INTERVAL - 1) / TCP_SLOW_INTERVAL) + 1; +#endif /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ +#endif /* LWIP_TCP */ + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_close, err); + API_MSG_VAR_FREE(msg); + + return err; +} + +/** + * Close a TCP netconn (doesn't delete it). + * + * @param conn the TCP netconn to close + * @return ERR_OK if the netconn was closed, any other err_t on error + */ +err_t +netconn_close(struct netconn *conn) +{ + /* shutting down both ends is the same as closing */ + return netconn_close_shutdown(conn, NETCONN_SHUT_RDWR); +} + +/** + * Shut down one or both sides of a TCP netconn (doesn't delete it). + * + * @param conn the TCP netconn to shut down + * @return ERR_OK if the netconn was closed, any other err_t on error + */ +err_t +netconn_shutdown(struct netconn *conn, u8_t shut_rx, u8_t shut_tx) +{ + return netconn_close_shutdown(conn, (shut_rx ? NETCONN_SHUT_RD : 0) | (shut_tx ? NETCONN_SHUT_WR : 0)); +} + +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) +/** + * Join multicast groups for UDP netconns. + * + * @param conn the UDP netconn for which to change multicast addresses + * @param multiaddr IP address of the multicast group to join or leave + * @param netif_addr the IP address of the network interface on which to send + * the igmp message + * @param join_or_leave flag whether to send a join- or leave-message + * @return ERR_OK if the action was taken, any err_t on error + */ +err_t +netconn_join_leave_group(struct netconn *conn, + const ip_addr_t *multiaddr, + const ip_addr_t *netif_addr, + enum netconn_igmp join_or_leave) +{ + API_MSG_VAR_DECLARE(msg); + err_t err; + + LWIP_ERROR("netconn_join_leave_group: invalid conn", (conn != NULL), return ERR_ARG;); + + API_MSG_VAR_ALLOC(msg); + + /* Don't propagate NULL pointer (IP_ADDR_ANY alias) to subsequent functions */ + if (multiaddr == NULL) { + multiaddr = IP_ADDR_ANY; + } + if (netif_addr == NULL) { + netif_addr = IP_ADDR_ANY; + } + + API_MSG_VAR_REF(msg).msg.conn = conn; + API_MSG_VAR_REF(msg).msg.msg.jl.multiaddr = API_MSG_VAR_REF(multiaddr); + API_MSG_VAR_REF(msg).msg.msg.jl.netif_addr = API_MSG_VAR_REF(netif_addr); + API_MSG_VAR_REF(msg).msg.msg.jl.join_or_leave = join_or_leave; + TCPIP_APIMSG(&API_MSG_VAR_REF(msg), lwip_netconn_do_join_leave_group, err); + API_MSG_VAR_FREE(msg); + + return err; +} +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ + +#if LWIP_DNS +/** + * Execute a DNS query, only one IP address is returned + * + * @param name a string representation of the DNS host name to query + * @param addr a preallocated ip_addr_t where to store the resolved IP address + * @return ERR_OK: resolving succeeded + * ERR_MEM: memory error, try again later + * ERR_ARG: dns client not initialized or invalid hostname + * ERR_VAL: dns server response was invalid + */ +#if LWIP_IPV4 && LWIP_IPV6 +err_t +netconn_gethostbyname_addrtype(const char *name, ip_addr_t *addr, u8_t dns_addrtype) +#else +err_t +netconn_gethostbyname(const char *name, ip_addr_t *addr) +#endif +{ + + API_VAR_DECLARE(struct dns_api_msg, msg); +#if !LWIP_MPU_COMPATIBLE + sys_sem_t sem; +#endif /* LWIP_MPU_COMPATIBLE */ + err_t err; + + LWIP_ERROR("netconn_gethostbyname: invalid name", (name != NULL), return ERR_ARG;); + LWIP_ERROR("netconn_gethostbyname: invalid addr", (addr != NULL), return ERR_ARG;); +#if LWIP_MPU_COMPATIBLE + if (strlen(name) >= DNS_MAX_NAME_LENGTH) { + return ERR_ARG; + } +#endif + + API_VAR_ALLOC(struct dns_api_msg, MEMP_DNS_API_MSG, msg); +#if LWIP_MPU_COMPATIBLE + strncpy(API_VAR_REF(msg).name, name, DNS_MAX_NAME_LENGTH-1); + API_VAR_REF(msg).name[DNS_MAX_NAME_LENGTH-1] = 0; +#else /* LWIP_MPU_COMPATIBLE */ + msg.err = &err; + msg.sem = &sem; + API_VAR_REF(msg).addr = API_VAR_REF(addr); + API_VAR_REF(msg).name = name; +#endif /* LWIP_MPU_COMPATIBLE */ +#if LWIP_IPV4 && LWIP_IPV6 + API_VAR_REF(msg).dns_addrtype = dns_addrtype; +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + + +#if LWIP_NETCONN_SEM_PER_THREAD + API_VAR_REF(msg).sem = LWIP_NETCONN_THREAD_SEM_GET(); +#else /* LWIP_NETCONN_SEM_PER_THREAD*/ + err = sys_sem_new(API_EXPR_REF(API_VAR_REF(msg).sem), 0); + if (err != ERR_OK) { + API_VAR_FREE(MEMP_DNS_API_MSG, msg); + return err; + } +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + + err = tcpip_callback(lwip_netconn_do_gethostbyname, &API_VAR_REF(msg)); + if (err != ERR_OK) { +#if !LWIP_NETCONN_SEM_PER_THREAD + sys_sem_free(API_EXPR_REF(API_VAR_REF(msg).sem)); +#endif /* !LWIP_NETCONN_SEM_PER_THREAD */ + + API_VAR_FREE(MEMP_DNS_API_MSG, msg); + return err; + } + + sys_sem_wait(API_EXPR_REF_SEM(API_VAR_REF(msg).sem)); +#if !LWIP_NETCONN_SEM_PER_THREAD + sys_sem_free(API_EXPR_REF(API_VAR_REF(msg).sem)); +#endif /* !LWIP_NETCONN_SEM_PER_THREAD */ + +#if LWIP_MPU_COMPATIBLE + *addr = msg->addr; + err = msg->err; +#endif /* LWIP_MPU_COMPATIBLE */ + + API_VAR_FREE(MEMP_DNS_API_MSG, msg); + + return err; +} +#endif /* LWIP_DNS*/ + +#if LWIP_NETCONN_SEM_PER_THREAD +void +netconn_thread_init(void) +{ + sys_sem_t *sem = LWIP_NETCONN_THREAD_SEM_GET(); + if ((sem == NULL) || !sys_sem_valid(sem)) { + /* call alloc only once */ + LWIP_NETCONN_THREAD_SEM_ALLOC(); + LWIP_ASSERT("LWIP_NETCONN_THREAD_SEM_ALLOC() failed", sys_sem_valid(LWIP_NETCONN_THREAD_SEM_GET())); + } +} + +void +netconn_thread_cleanup(void) +{ + sys_sem_t *sem = LWIP_NETCONN_THREAD_SEM_GET(); + if ((sem != NULL) && sys_sem_valid(sem)) { + /* call free only once */ + LWIP_NETCONN_THREAD_SEM_FREE(); + } +} +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + +#endif /* LWIP_NETCONN */ diff --git a/components/lwip/api/api_msg.c b/components/lwip/api/api_msg.c new file mode 100755 index 000000000..e8e967ef4 --- /dev/null +++ b/components/lwip/api/api_msg.c @@ -0,0 +1,1930 @@ +/** + * @file + * Sequential API Internal module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_NETCONN /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/priv/api_msg.h" + +#include "lwip/ip.h" +#include "lwip/udp.h" +#include "lwip/tcp.h" +#include "lwip/raw.h" + +#include "lwip/memp.h" +#include "lwip/igmp.h" +#include "lwip/dns.h" +#include "lwip/mld6.h" +#include "lwip/priv/tcpip_priv.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/* netconns are polled once per second (e.g. continue write on memory error) */ +#define NETCONN_TCP_POLL_INTERVAL 2 + +#define SET_NONBLOCKING_CONNECT(conn, val) do { if (val) { \ + (conn)->flags |= NETCONN_FLAG_IN_NONBLOCKING_CONNECT; \ +} else { \ + (conn)->flags &= ~ NETCONN_FLAG_IN_NONBLOCKING_CONNECT; }} while(0) +#define IN_NONBLOCKING_CONNECT(conn) (((conn)->flags & NETCONN_FLAG_IN_NONBLOCKING_CONNECT) != 0) + +/* forward declarations */ +#if LWIP_TCP +#if LWIP_TCPIP_CORE_LOCKING +#define WRITE_DELAYED , 1 +#define WRITE_DELAYED_PARAM , u8_t delayed +#else /* LWIP_TCPIP_CORE_LOCKING */ +#define WRITE_DELAYED +#define WRITE_DELAYED_PARAM +#endif /* LWIP_TCPIP_CORE_LOCKING */ +static err_t lwip_netconn_do_writemore(struct netconn *conn WRITE_DELAYED_PARAM); +static err_t lwip_netconn_do_close_internal(struct netconn *conn WRITE_DELAYED_PARAM); +#endif + +#if LWIP_RAW +/** + * Receive callback function for RAW netconns. + * Doesn't 'eat' the packet, only copies it and sends it to + * conn->recvmbox + * + * @see raw.h (struct raw_pcb.recv) for parameters and return value + */ +static u8_t +recv_raw(void *arg, struct raw_pcb *pcb, struct pbuf *p, + const ip_addr_t *addr) +{ + struct pbuf *q; + struct netbuf *buf; + struct netconn *conn; + + LWIP_UNUSED_ARG(addr); + conn = (struct netconn *)arg; + + if ((conn != NULL) && sys_mbox_valid(&conn->recvmbox)) { +#if LWIP_SO_RCVBUF + int recv_avail; + SYS_ARCH_GET(conn->recv_avail, recv_avail); + if ((recv_avail + (int)(p->tot_len)) > conn->recv_bufsize) { + return 0; + } +#endif /* LWIP_SO_RCVBUF */ + /* copy the whole packet into new pbufs */ + q = pbuf_alloc(PBUF_RAW, p->tot_len, PBUF_RAM); + if (q != NULL) { + if (pbuf_copy(q, p) != ERR_OK) { + pbuf_free(q); + q = NULL; + } + } + + if (q != NULL) { + u16_t len; + buf = (struct netbuf *)memp_malloc(MEMP_NETBUF); + if (buf == NULL) { + pbuf_free(q); + return 0; + } + + buf->p = q; + buf->ptr = q; + ip_addr_copy(buf->addr, *ip_current_src_addr()); + buf->port = pcb->protocol; + + len = q->tot_len; + if (sys_mbox_trypost(&conn->recvmbox, buf) != ERR_OK) { + netbuf_delete(buf); + return 0; + } else { +#if LWIP_SO_RCVBUF + SYS_ARCH_INC(conn->recv_avail, len); +#endif /* LWIP_SO_RCVBUF */ + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVPLUS, len); + } + } + } + + return 0; /* do not eat the packet */ +} +#endif /* LWIP_RAW*/ + +#if LWIP_UDP +/** + * Receive callback function for UDP netconns. + * Posts the packet to conn->recvmbox or deletes it on memory error. + * + * @see udp.h (struct udp_pcb.recv) for parameters + */ +static void +recv_udp(void *arg, struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *addr, u16_t port) +{ + struct netbuf *buf; + struct netconn *conn; + u16_t len; +#if LWIP_SO_RCVBUF + int recv_avail; +#endif /* LWIP_SO_RCVBUF */ + + LWIP_UNUSED_ARG(pcb); /* only used for asserts... */ + LWIP_ASSERT("recv_udp must have a pcb argument", pcb != NULL); + LWIP_ASSERT("recv_udp must have an argument", arg != NULL); + conn = (struct netconn *)arg; + LWIP_ASSERT("recv_udp: recv for wrong pcb!", conn->pcb.udp == pcb); + +#if LWIP_SO_RCVBUF + SYS_ARCH_GET(conn->recv_avail, recv_avail); + if ((conn == NULL) || !sys_mbox_valid(&conn->recvmbox) || + ((recv_avail + (int)(p->tot_len)) > conn->recv_bufsize)) { +#else /* LWIP_SO_RCVBUF */ + if ((conn == NULL) || !sys_mbox_valid(&conn->recvmbox)) { +#endif /* LWIP_SO_RCVBUF */ + pbuf_free(p); + return; + } + + buf = (struct netbuf *)memp_malloc(MEMP_NETBUF); + if (buf == NULL) { + pbuf_free(p); + return; + } else { + buf->p = p; + buf->ptr = p; + ip_addr_set(&buf->addr, addr); + buf->port = port; +#if LWIP_NETBUF_RECVINFO + { + /* get the UDP header - always in the first pbuf, ensured by udp_input */ + const struct udp_hdr* udphdr = (const struct udp_hdr*)ip_next_header_ptr(); +#if LWIP_CHECKSUM_ON_COPY + buf->flags = NETBUF_FLAG_DESTADDR; +#endif /* LWIP_CHECKSUM_ON_COPY */ + ip_addr_set(&buf->toaddr, ip_current_dest_addr()); + buf->toport_chksum = udphdr->dest; + } +#endif /* LWIP_NETBUF_RECVINFO */ + } + + len = p->tot_len; + if (sys_mbox_trypost(&conn->recvmbox, buf) != ERR_OK) { + netbuf_delete(buf); + return; + } else { +#if LWIP_SO_RCVBUF + SYS_ARCH_INC(conn->recv_avail, len); +#endif /* LWIP_SO_RCVBUF */ + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVPLUS, len); + } +} +#endif /* LWIP_UDP */ + +#if LWIP_TCP +/** + * Receive callback function for TCP netconns. + * Posts the packet to conn->recvmbox, but doesn't delete it on errors. + * + * @see tcp.h (struct tcp_pcb.recv) for parameters and return value + */ +static err_t +recv_tcp(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) +{ + struct netconn *conn; + u16_t len; + + LWIP_UNUSED_ARG(pcb); + LWIP_ASSERT("recv_tcp must have a pcb argument", pcb != NULL); + LWIP_ASSERT("recv_tcp must have an argument", arg != NULL); + conn = (struct netconn *)arg; + + if (conn == NULL) { + return ERR_VAL; + } + LWIP_ASSERT("recv_tcp: recv for wrong pcb!", conn->pcb.tcp == pcb); + + if (!sys_mbox_valid(&conn->recvmbox)) { + /* recvmbox already deleted */ + if (p != NULL) { + tcp_recved(pcb, p->tot_len); + pbuf_free(p); + } + return ERR_OK; + } + /* Unlike for UDP or RAW pcbs, don't check for available space + using recv_avail since that could break the connection + (data is already ACKed) */ + + /* don't overwrite fatal errors! */ + if (err != ERR_OK) { + NETCONN_SET_SAFE_ERR(conn, err); + } + + if (p != NULL) { + len = p->tot_len; + } else { + len = 0; + } + + if (sys_mbox_trypost(&conn->recvmbox, p) != ERR_OK) { + /* don't deallocate p: it is presented to us later again from tcp_fasttmr! */ + return ERR_MEM; + } else { +#if LWIP_SO_RCVBUF + SYS_ARCH_INC(conn->recv_avail, len); +#endif /* LWIP_SO_RCVBUF */ + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVPLUS, len); + } + + return ERR_OK; +} + +/** + * Poll callback function for TCP netconns. + * Wakes up an application thread that waits for a connection to close + * or data to be sent. The application thread then takes the + * appropriate action to go on. + * + * Signals the conn->sem. + * netconn_close waits for conn->sem if closing failed. + * + * @see tcp.h (struct tcp_pcb.poll) for parameters and return value + */ +static err_t +poll_tcp(void *arg, struct tcp_pcb *pcb) +{ + struct netconn *conn = (struct netconn *)arg; + + LWIP_UNUSED_ARG(pcb); + LWIP_ASSERT("conn != NULL", (conn != NULL)); + + if (conn->state == NETCONN_WRITE) { + lwip_netconn_do_writemore(conn WRITE_DELAYED); + } else if (conn->state == NETCONN_CLOSE) { +#if !LWIP_SO_SNDTIMEO && !LWIP_SO_LINGER + if (conn->current_msg && conn->current_msg->msg.sd.polls_left) { + conn->current_msg->msg.sd.polls_left--; + } +#endif /* !LWIP_SO_SNDTIMEO && !LWIP_SO_LINGER */ + lwip_netconn_do_close_internal(conn WRITE_DELAYED); + } + /* @todo: implement connect timeout here? */ + + /* Did a nonblocking write fail before? Then check available write-space. */ + if (conn->flags & NETCONN_FLAG_CHECK_WRITESPACE) { + /* If the queued byte- or pbuf-count drops below the configured low-water limit, + let select mark this pcb as writable again. */ + if ((conn->pcb.tcp != NULL) && (tcp_sndbuf(conn->pcb.tcp) > TCP_SNDLOWAT) && + (tcp_sndqueuelen(conn->pcb.tcp) < TCP_SNDQUEUELOWAT)) { + conn->flags &= ~NETCONN_FLAG_CHECK_WRITESPACE; + API_EVENT(conn, NETCONN_EVT_SENDPLUS, 0); + } + } + + return ERR_OK; +} + +/** + * Sent callback function for TCP netconns. + * Signals the conn->sem and calls API_EVENT. + * netconn_write waits for conn->sem if send buffer is low. + * + * @see tcp.h (struct tcp_pcb.sent) for parameters and return value + */ +static err_t +sent_tcp(void *arg, struct tcp_pcb *pcb, u16_t len) +{ + struct netconn *conn = (struct netconn *)arg; + + LWIP_UNUSED_ARG(pcb); + LWIP_ASSERT("conn != NULL", (conn != NULL)); + + if (conn) { + if (conn->state == NETCONN_WRITE) { + lwip_netconn_do_writemore(conn WRITE_DELAYED); + } else if (conn->state == NETCONN_CLOSE) { + lwip_netconn_do_close_internal(conn WRITE_DELAYED); + } + + /* If the queued byte- or pbuf-count drops below the configured low-water limit, + let select mark this pcb as writable again. */ + if ((conn->pcb.tcp != NULL) && (tcp_sndbuf(conn->pcb.tcp) > TCP_SNDLOWAT) && + (tcp_sndqueuelen(conn->pcb.tcp) < TCP_SNDQUEUELOWAT)) { + conn->flags &= ~NETCONN_FLAG_CHECK_WRITESPACE; + API_EVENT(conn, NETCONN_EVT_SENDPLUS, len); + } + } + + return ERR_OK; +} + +/** + * Error callback function for TCP netconns. + * Signals conn->sem, posts to all conn mboxes and calls API_EVENT. + * The application thread has then to decide what to do. + * + * @see tcp.h (struct tcp_pcb.err) for parameters + */ +static void +err_tcp(void *arg, err_t err) +{ + struct netconn *conn; + enum netconn_state old_state; + + conn = (struct netconn *)arg; + LWIP_ASSERT("conn != NULL", (conn != NULL)); + + conn->pcb.tcp = NULL; + + /* no check since this is always fatal! */ + SYS_ARCH_SET(conn->last_err, err); + + /* reset conn->state now before waking up other threads */ + old_state = conn->state; + conn->state = NETCONN_NONE; + + /* @todo: the type of NETCONN_EVT created should depend on 'old_state' */ + + /* Notify the user layer about a connection error. Used to signal select. */ + API_EVENT(conn, NETCONN_EVT_ERROR, 0); + /* Try to release selects pending on 'read' or 'write', too. + They will get an error if they actually try to read or write. */ + API_EVENT(conn, NETCONN_EVT_RCVPLUS, 0); + API_EVENT(conn, NETCONN_EVT_SENDPLUS, 0); + + /* pass NULL-message to recvmbox to wake up pending recv */ + if (sys_mbox_valid(&conn->recvmbox)) { + /* use trypost to prevent deadlock */ + sys_mbox_trypost(&conn->recvmbox, NULL); + } + /* pass NULL-message to acceptmbox to wake up pending accept */ + if (sys_mbox_valid(&conn->acceptmbox)) { + /* use trypost to preven deadlock */ + sys_mbox_trypost(&conn->acceptmbox, NULL); + } + + if ((old_state == NETCONN_WRITE) || (old_state == NETCONN_CLOSE) || + (old_state == NETCONN_CONNECT)) { + /* calling lwip_netconn_do_writemore/lwip_netconn_do_close_internal is not necessary + since the pcb has already been deleted! */ + int was_nonblocking_connect = IN_NONBLOCKING_CONNECT(conn); + SET_NONBLOCKING_CONNECT(conn, 0); + + if (!was_nonblocking_connect) { + sys_sem_t* op_completed_sem; + /* set error return code */ + LWIP_ASSERT("conn->current_msg != NULL", conn->current_msg != NULL); + conn->current_msg->err = err; + op_completed_sem = LWIP_API_MSG_SEM(conn->current_msg); + + LWIP_ASSERT("inavlid op_completed_sem", sys_sem_valid(op_completed_sem)); + conn->current_msg = NULL; + /* wake up the waiting task */ + NETCONN_SET_SAFE_ERR(conn, err); + + sys_sem_signal(op_completed_sem); + } + } else { + LWIP_ASSERT("conn->current_msg == NULL", conn->current_msg == NULL); + } +} + +/** + * Setup a tcp_pcb with the correct callback function pointers + * and their arguments. + * + * @param conn the TCP netconn to setup + */ +static void +setup_tcp(struct netconn *conn) +{ + struct tcp_pcb *pcb; + + pcb = conn->pcb.tcp; + tcp_arg(pcb, conn); + tcp_recv(pcb, recv_tcp); + tcp_sent(pcb, sent_tcp); + tcp_poll(pcb, poll_tcp, NETCONN_TCP_POLL_INTERVAL); + tcp_err(pcb, err_tcp); +} + +/** + * Accept callback function for TCP netconns. + * Allocates a new netconn and posts that to conn->acceptmbox. + * + * @see tcp.h (struct tcp_pcb_listen.accept) for parameters and return value + */ +static err_t +accept_function(void *arg, struct tcp_pcb *newpcb, err_t err) +{ + struct netconn *newconn; + struct netconn *conn = (struct netconn *)arg; + + LWIP_DEBUGF(API_MSG_DEBUG, ("accept_function: newpcb->tate: %s\n", tcp_debug_state_str(newpcb->state))); + + if (!sys_mbox_valid(&conn->acceptmbox)) { + LWIP_DEBUGF(API_MSG_DEBUG, ("accept_function: acceptmbox already deleted\n")); + return ERR_VAL; + } + + /* We have to set the callback here even though + * the new socket is unknown. conn->socket is marked as -1. */ + newconn = netconn_alloc(conn->type, conn->callback); + if (newconn == NULL) { + return ERR_MEM; + } + newconn->pcb.tcp = newpcb; + setup_tcp(newconn); + /* no protection: when creating the pcb, the netconn is not yet known + to the application thread */ + newconn->last_err = err; + + if (sys_mbox_trypost(&conn->acceptmbox, newconn) != ERR_OK) { + /* When returning != ERR_OK, the pcb is aborted in tcp_process(), + so do nothing here! */ + /* remove all references to this netconn from the pcb */ + struct tcp_pcb* pcb = newconn->pcb.tcp; + tcp_arg(pcb, NULL); + tcp_recv(pcb, NULL); + tcp_sent(pcb, NULL); + tcp_poll(pcb, NULL, 0); + tcp_err(pcb, NULL); + /* remove reference from to the pcb from this netconn */ + newconn->pcb.tcp = NULL; + /* no need to drain since we know the recvmbox is empty. */ + sys_mbox_free(&newconn->recvmbox); + sys_mbox_set_invalid(&newconn->recvmbox); + netconn_free(newconn); + return ERR_MEM; + } else { + /* Register event with callback */ + API_EVENT(conn, NETCONN_EVT_RCVPLUS, 0); + } + + return ERR_OK; +} +#endif /* LWIP_TCP */ + +/** + * Create a new pcb of a specific type. + * Called from lwip_netconn_do_newconn(). + * + * @param msg the api_msg_msg describing the connection type + * @return msg->conn->err, but the return value is currently ignored + */ +static void +pcb_new(struct api_msg_msg *msg) +{ + LWIP_ASSERT("pcb_new: pcb already allocated", msg->conn->pcb.tcp == NULL); + + /* Allocate a PCB for this connection */ + switch(NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + msg->conn->pcb.raw = raw_new(msg->msg.n.proto); + if (msg->conn->pcb.raw != NULL) { + raw_recv(msg->conn->pcb.raw, recv_raw, msg->conn); + } + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + msg->conn->pcb.udp = udp_new(); + if (msg->conn->pcb.udp != NULL) { +#if LWIP_UDPLITE + if (NETCONNTYPE_ISUDPLITE(msg->conn->type)) { + udp_setflags(msg->conn->pcb.udp, UDP_FLAGS_UDPLITE); + } +#endif /* LWIP_UDPLITE */ + if (NETCONNTYPE_ISUDPNOCHKSUM(msg->conn->type)) { + udp_setflags(msg->conn->pcb.udp, UDP_FLAGS_NOCHKSUM); + } + udp_recv(msg->conn->pcb.udp, recv_udp, msg->conn); + } + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + msg->conn->pcb.tcp = tcp_new(); + if (msg->conn->pcb.tcp != NULL) { + setup_tcp(msg->conn); + } + break; +#endif /* LWIP_TCP */ + default: + /* Unsupported netconn type, e.g. protocol disabled */ + msg->err = ERR_VAL; + return; + } + if (msg->conn->pcb.ip == NULL) { + msg->err = ERR_MEM; + } +#if LWIP_IPV4 && LWIP_IPV6 + else { + if (NETCONNTYPE_ISIPV6(msg->conn->type)) { + /* Convert IPv4 PCB manually to an IPv6 PCB */ + IP_SET_TYPE_VAL(msg->conn->pcb.ip->local_ip, IPADDR_TYPE_V6); + IP_SET_TYPE_VAL(msg->conn->pcb.ip->remote_ip, IPADDR_TYPE_V6); + } + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +} + +/** + * Create a new pcb of a specific type inside a netconn. + * Called from netconn_new_with_proto_and_callback. + * + * @param msg the api_msg_msg describing the connection type + */ +void +lwip_netconn_do_newconn(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + msg->err = ERR_OK; + if (msg->conn->pcb.tcp == NULL) { + pcb_new(msg); + } + /* Else? This "new" connection already has a PCB allocated. */ + /* Is this an error condition? Should it be deleted? */ + /* We currently just are happy and return. */ + + TCPIP_APIMSG_ACK(msg); +} + +/** + * Create a new netconn (of a specific type) that has a callback function. + * The corresponding pcb is NOT created! + * + * @param t the type of 'connection' to create (@see enum netconn_type) + * @param proto the IP protocol for RAW IP pcbs + * @param callback a function to call on status changes (RX available, TX'ed) + * @return a newly allocated struct netconn or + * NULL on memory error + */ +struct netconn* +netconn_alloc(enum netconn_type t, netconn_callback callback) +{ + struct netconn *conn; + int size; + + conn = (struct netconn *)memp_malloc(MEMP_NETCONN); + if (conn == NULL) { + return NULL; + } + + conn->last_err = ERR_OK; + conn->type = t; + conn->pcb.tcp = NULL; + + /* If all sizes are the same, every compiler should optimize this switch to nothing */ + switch(NETCONNTYPE_GROUP(t)) { +#if LWIP_RAW + case NETCONN_RAW: + size = DEFAULT_RAW_RECVMBOX_SIZE; + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + size = DEFAULT_UDP_RECVMBOX_SIZE; + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + size = DEFAULT_TCP_RECVMBOX_SIZE; + break; +#endif /* LWIP_TCP */ + default: + LWIP_ASSERT("netconn_alloc: undefined netconn_type", 0); + goto free_and_return; + } + + if (sys_mbox_new(&conn->recvmbox, size) != ERR_OK) { + goto free_and_return; + } +#if !LWIP_NETCONN_SEM_PER_THREAD + if (sys_sem_new(&conn->op_completed, 0) != ERR_OK) { + sys_mbox_free(&conn->recvmbox); + goto free_and_return; + } +#endif + +#if LWIP_TCP + sys_mbox_set_invalid(&conn->acceptmbox); +#endif + conn->state = NETCONN_NONE; +#if LWIP_SOCKET + /* initialize socket to -1 since 0 is a valid socket */ + conn->socket = -1; +#endif /* LWIP_SOCKET */ + conn->callback = callback; +#if LWIP_TCP + conn->current_msg = NULL; + conn->write_offset = 0; +#endif /* LWIP_TCP */ +#if LWIP_SO_SNDTIMEO + conn->send_timeout = 0; +#endif /* LWIP_SO_SNDTIMEO */ +#if LWIP_SO_RCVTIMEO + conn->recv_timeout = 0; +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVBUF + conn->recv_bufsize = RECV_BUFSIZE_DEFAULT; + conn->recv_avail = 0; +#endif /* LWIP_SO_RCVBUF */ +#if LWIP_SO_LINGER + conn->linger = -1; +#endif /* LWIP_SO_LINGER */ + conn->flags = 0; + return conn; +free_and_return: + memp_free(MEMP_NETCONN, conn); + return NULL; +} + +/** + * Delete a netconn and all its resources. + * The pcb is NOT freed (since we might not be in the right thread context do this). + * + * @param conn the netconn to free + */ +void +netconn_free(struct netconn *conn) +{ + LWIP_ASSERT("PCB must be deallocated outside this function", conn->pcb.tcp == NULL); + LWIP_ASSERT("recvmbox must be deallocated before calling this function", + !sys_mbox_valid(&conn->recvmbox)); +#if LWIP_TCP + LWIP_ASSERT("acceptmbox must be deallocated before calling this function", + !sys_mbox_valid(&conn->acceptmbox)); +#endif /* LWIP_TCP */ + +#if !LWIP_NETCONN_SEM_PER_THREAD + sys_sem_free(&conn->op_completed); + sys_sem_set_invalid(&conn->op_completed); +#endif + + memp_free(MEMP_NETCONN, conn); +} + +/** + * Delete rcvmbox and acceptmbox of a netconn and free the left-over data in + * these mboxes + * + * @param conn the netconn to free + * @bytes_drained bytes drained from recvmbox + * @accepts_drained pending connections drained from acceptmbox + */ +static void +netconn_drain(struct netconn *conn) +{ + void *mem; +#if LWIP_TCP + struct pbuf *p; +#endif /* LWIP_TCP */ + + /* This runs in tcpip_thread, so we don't need to lock against rx packets */ + + /* Delete and drain the recvmbox. */ + if (sys_mbox_valid(&conn->recvmbox)) { + while (sys_mbox_tryfetch(&conn->recvmbox, &mem) != SYS_MBOX_EMPTY) { +#if LWIP_TCP + if (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) { + if (mem != NULL) { + p = (struct pbuf*)mem; + /* pcb might be set to NULL already by err_tcp() */ + if (conn->pcb.tcp != NULL) { + tcp_recved(conn->pcb.tcp, p->tot_len); + } + pbuf_free(p); + } + } else +#endif /* LWIP_TCP */ + { + netbuf_delete((struct netbuf *)mem); + } + } + sys_mbox_free(&conn->recvmbox); + sys_mbox_set_invalid(&conn->recvmbox); + } + + /* Delete and drain the acceptmbox. */ +#if LWIP_TCP + if (sys_mbox_valid(&conn->acceptmbox)) { + while (sys_mbox_tryfetch(&conn->acceptmbox, &mem) != SYS_MBOX_EMPTY) { + struct netconn *newconn = (struct netconn *)mem; + /* Only tcp pcbs have an acceptmbox, so no need to check conn->type */ + /* pcb might be set to NULL already by err_tcp() */ + if (conn->pcb.tcp != NULL) { + tcp_accepted(conn->pcb.tcp); + } + /* drain recvmbox */ + netconn_drain(newconn); + if (newconn->pcb.tcp != NULL) { + tcp_abort(newconn->pcb.tcp); + newconn->pcb.tcp = NULL; + } + netconn_free(newconn); + } + sys_mbox_free(&conn->acceptmbox); + sys_mbox_set_invalid(&conn->acceptmbox); + } +#endif /* LWIP_TCP */ +} + +#if LWIP_TCP +/** + * Internal helper function to close a TCP netconn: since this sometimes + * doesn't work at the first attempt, this function is called from multiple + * places. + * + * @param conn the TCP netconn to close + * [@param delay 1 if called from sent/poll (wake up calling thread on end)] + */ +static err_t +lwip_netconn_do_close_internal(struct netconn *conn WRITE_DELAYED_PARAM) +{ + err_t err; + u8_t shut, shut_rx, shut_tx, close; + u8_t close_finished = 0; + struct tcp_pcb* tpcb; +#if LWIP_SO_LINGER + u8_t linger_wait_required = 0; +#endif /* LWIP_SO_LINGER */ + + LWIP_ASSERT("invalid conn", (conn != NULL)); + LWIP_ASSERT("this is for tcp netconns only", (NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP)); + LWIP_ASSERT("conn must be in state NETCONN_CLOSE", (conn->state == NETCONN_CLOSE)); + LWIP_ASSERT("pcb already closed", (conn->pcb.tcp != NULL)); + LWIP_ASSERT("conn->current_msg != NULL", conn->current_msg != NULL); + + tpcb = conn->pcb.tcp; + shut = conn->current_msg->msg.sd.shut; + shut_rx = shut & NETCONN_SHUT_RD; + shut_tx = shut & NETCONN_SHUT_WR; + /* shutting down both ends is the same as closing + (also if RD or WR side was shut down before already) */ + if (shut == NETCONN_SHUT_RDWR) { + close = 1; + } else if (shut_rx && + ((tpcb->state == FIN_WAIT_1) || + (tpcb->state == FIN_WAIT_2) || + (tpcb->state == CLOSING))) { + close = 1; + } else if (shut_tx && ((tpcb->flags & TF_RXCLOSED) != 0)) { + close = 1; + } else { + close = 0; + } + + /* Set back some callback pointers */ + if (close) { + tcp_arg(tpcb, NULL); + } + if (tpcb->state == LISTEN) { + tcp_accept(tpcb, NULL); + } else { + /* some callbacks have to be reset if tcp_close is not successful */ + if (shut_rx) { + tcp_recv(tpcb, NULL); + tcp_accept(tpcb, NULL); + } + if (shut_tx) { + tcp_sent(tpcb, NULL); + } + if (close) { + tcp_poll(tpcb, NULL, 0); + tcp_err(tpcb, NULL); + } + } + /* Try to close the connection */ + if (close) { +#if LWIP_SO_LINGER + /* check linger possibilites before calling tcp_close */ + err = ERR_OK; + /* linger enabled/required at all? (i.e. is there untransmitted data left?) */ + if ((conn->linger >= 0) && (conn->pcb.tcp->unsent || conn->pcb.tcp->unacked)) { + if ((conn->linger == 0)) { + /* data left but linger prevents waiting */ + tcp_abort(tpcb); + tpcb = NULL; + } else if (conn->linger > 0) { + /* data left and linger says we should wait */ + if (netconn_is_nonblocking(conn)) { + /* data left on a nonblocking netconn -> cannot linger */ + err = ERR_WOULDBLOCK; + } else if ((s32_t)(sys_now() - conn->current_msg->msg.sd.time_started) >= + (conn->linger * 1000)) { + /* data left but linger timeout has expired (this happens on further + calls to this function through poll_tcp */ + tcp_abort(tpcb); + tpcb = NULL; + } else { + /* data left -> need to wait for ACK after successful close */ + linger_wait_required = 1; + } + } + } + if ((err == ERR_OK) && (tpcb != NULL)) +#endif /* LWIP_SO_LINGER */ + { + err = tcp_close(tpcb); + } + } else { + err = tcp_shutdown(tpcb, shut_rx, shut_tx); + } + if (err == ERR_OK) { + close_finished = 1; +#if LWIP_SO_LINGER + if (linger_wait_required) { + /* wait for ACK of all unsent/unacked data by just getting called again */ + close_finished = 0; + err = ERR_INPROGRESS; + } +#endif /* LWIP_SO_LINGER */ + } else { + if (err == ERR_MEM) { + /* Closing failed because of memory shortage */ + if (netconn_is_nonblocking(conn)) { + /* Nonblocking close failed */ + close_finished = 1; + err = ERR_WOULDBLOCK; + } else { + /* Blocking close, check the timeout */ +#if LWIP_SO_SNDTIMEO || LWIP_SO_LINGER + s32_t close_timeout = LWIP_TCP_CLOSE_TIMEOUT_MS_DEFAULT; + /* this is kind of an lwip addition to the standard sockets: we wait + for some time when failing to allocate a segment for the FIN */ +#if LWIP_SO_SNDTIMEO + if (conn->send_timeout > 0) { + close_timeout = conn->send_timeout; + } +#endif /* LWIP_SO_SNDTIMEO */ +#if LWIP_SO_LINGER + if (conn->linger >= 0) { + /* use linger timeout (seconds) */ + close_timeout = conn->linger * 1000U; + } +#endif + if ((s32_t)(sys_now() - conn->current_msg->msg.sd.time_started) >= close_timeout) { +#else /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + if (conn->current_msg->msg.sd.polls_left == 0) { +#endif /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + close_finished = 1; + if (close) { + /* in this case, we want to RST the connection */ + tcp_abort(tpcb); + err = ERR_OK; + } + } + } + } else { + /* Closing failed for a non-memory error: give up */ + close_finished = 1; + } + } + if (close_finished) { + /* Closing done (succeeded, non-memory error, nonblocking error or timeout) */ + sys_sem_t* op_completed_sem = LWIP_API_MSG_SEM(conn->current_msg); + conn->current_msg->err = err; + conn->current_msg = NULL; + conn->state = NETCONN_NONE; + if (err == ERR_OK) { + if (close) { + /* Set back some callback pointers as conn is going away */ + conn->pcb.tcp = NULL; + /* Trigger select() in socket layer. Make sure everybody notices activity + on the connection, error first! */ + API_EVENT(conn, NETCONN_EVT_ERROR, 0); + } + if (shut_rx) { + API_EVENT(conn, NETCONN_EVT_RCVPLUS, 0); + } + if (shut_tx) { + API_EVENT(conn, NETCONN_EVT_SENDPLUS, 0); + } + } + NETCONN_SET_SAFE_ERR(conn, err); +#if LWIP_TCPIP_CORE_LOCKING + if (delayed) +#endif + { + /* wake up the application task */ + sys_sem_signal(op_completed_sem); + } + return ERR_OK; + } + if (!close_finished) { + /* Closing failed and we want to wait: restore some of the callbacks */ + /* Closing of listen pcb will never fail! */ + LWIP_ASSERT("Closing a listen pcb may not fail!", (tpcb->state != LISTEN)); + if (shut_tx) { + tcp_sent(tpcb, sent_tcp); + } + /* when waiting for close, set up poll interval to 500ms */ + tcp_poll(tpcb, poll_tcp, 1); + tcp_err(tpcb, err_tcp); + tcp_arg(tpcb, conn); + /* don't restore recv callback: we don't want to receive any more data */ + } + /* If closing didn't succeed, we get called again either + from poll_tcp or from sent_tcp */ + LWIP_ASSERT("err != ERR_OK", err != ERR_OK); + return err; +} +#endif /* LWIP_TCP */ + +/** + * Delete the pcb inside a netconn. + * Called from netconn_delete. + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_delconn(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + enum netconn_state state = msg->conn->state; + LWIP_ASSERT("netconn state error", /* this only happens for TCP netconns */ + (state == NETCONN_NONE) || (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_TCP)); +#if LWIP_NETCONN_FULLDUPLEX + /* In full duplex mode, blocking write/connect is aborted with ERR_CLSD */ + if (state != NETCONN_NONE) { + if ((state == NETCONN_WRITE) || + ((state == NETCONN_CONNECT) && !IN_NONBLOCKING_CONNECT(msg->conn))) { + /* close requested, abort running write/connect */ + sys_sem_t* op_completed_sem; + LWIP_ASSERT("msg->conn->current_msg != NULL", msg->conn->current_msg != NULL); + op_completed_sem = LWIP_API_MSG_SEM(msg->conn->current_msg); + msg->conn->current_msg->err = ERR_CLSD; + msg->conn->current_msg = NULL; + msg->conn->write_offset = 0; + msg->conn->state = NETCONN_NONE; + NETCONN_SET_SAFE_ERR(msg->conn, ERR_CLSD); + sys_sem_signal(op_completed_sem); + } + } +#else /* LWIP_NETCONN_FULLDUPLEX */ + if (((state != NETCONN_NONE) && + (state != NETCONN_LISTEN) && + (state != NETCONN_CONNECT)) || + ((state == NETCONN_CONNECT) && !IN_NONBLOCKING_CONNECT(msg->conn))) { + /* This means either a blocking write or blocking connect is running + (nonblocking write returns and sets state to NONE) */ + msg->err = ERR_INPROGRESS; + } else +#endif /* LWIP_NETCONN_FULLDUPLEX */ + { + LWIP_ASSERT("blocking connect in progress", + (state != NETCONN_CONNECT) || IN_NONBLOCKING_CONNECT(msg->conn)); + msg->err = ERR_OK; + /* Drain and delete mboxes */ + netconn_drain(msg->conn); + + if (msg->conn->pcb.tcp != NULL) { + + switch (NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + raw_remove(msg->conn->pcb.raw); + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + msg->conn->pcb.udp->recv_arg = NULL; + udp_remove(msg->conn->pcb.udp); + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + LWIP_ASSERT("already writing or closing", msg->conn->current_msg == NULL && + msg->conn->write_offset == 0); + msg->conn->state = NETCONN_CLOSE; + msg->msg.sd.shut = NETCONN_SHUT_RDWR; + msg->conn->current_msg = msg; +#if LWIP_TCPIP_CORE_LOCKING + if (lwip_netconn_do_close_internal(msg->conn, 0) != ERR_OK) { + LWIP_ASSERT("state!", msg->conn->state == NETCONN_CLOSE); + UNLOCK_TCPIP_CORE(); + sys_arch_sem_wait(LWIP_API_MSG_SEM(msg), 0); + LOCK_TCPIP_CORE(); + LWIP_ASSERT("state!", msg->conn->state == NETCONN_NONE); + } +#else /* LWIP_TCPIP_CORE_LOCKING */ + lwip_netconn_do_close_internal(msg->conn); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + /* API_EVENT is called inside lwip_netconn_do_close_internal, before releasing + the application thread, so we can return at this point! */ + return; +#endif /* LWIP_TCP */ + default: + break; + } + msg->conn->pcb.tcp = NULL; + } + /* tcp netconns don't come here! */ + + /* @todo: this lets select make the socket readable and writable, + which is wrong! errfd instead? */ + API_EVENT(msg->conn, NETCONN_EVT_RCVPLUS, 0); + API_EVENT(msg->conn, NETCONN_EVT_SENDPLUS, 0); + } + if (sys_sem_valid(LWIP_API_MSG_SEM(msg))) { + TCPIP_APIMSG_ACK(msg); + } +} + +/** + * Bind a pcb contained in a netconn + * Called from netconn_bind. + * + * @param msg the api_msg_msg pointing to the connection and containing + * the IP address and port to bind to + */ +void +lwip_netconn_do_bind(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (ERR_IS_FATAL(msg->conn->last_err)) { + msg->err = msg->conn->last_err; + } else { + msg->err = ERR_VAL; + if (msg->conn->pcb.tcp != NULL) { + const ip_addr_t *ipaddr = API_EXPR_REF(msg->msg.bc.ipaddr); + +#if LWIP_IPV4 && LWIP_IPV6 + /* "Socket API like" dual-stack support: If IP to bind to is IP6_ADDR_ANY, + * and NETCONN_FLAG_IPV6_V6ONLY is NOT set, use IP_ANY_TYPE to bind + */ + if (ip_addr_cmp(ipaddr, IP6_ADDR_ANY) && + (netconn_get_ipv6only(msg->conn) == 0)) { + /* change PCB type to IPADDR_TYPE_ANY */ + IP_SET_TYPE_VAL(msg->conn->pcb.ip->local_ip, IPADDR_TYPE_ANY); + IP_SET_TYPE_VAL(msg->conn->pcb.ip->remote_ip, IPADDR_TYPE_ANY); + + /* bind to IPADDR_TYPE_ANY */ + ipaddr = IP_ANY_TYPE; + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + + switch (NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + msg->err = raw_bind(msg->conn->pcb.raw, ipaddr); + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + msg->err = udp_bind(msg->conn->pcb.udp, ipaddr, msg->msg.bc.port); + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + msg->err = tcp_bind(msg->conn->pcb.tcp, ipaddr, msg->msg.bc.port); + break; +#endif /* LWIP_TCP */ + default: + break; + } + } + } + TCPIP_APIMSG_ACK(msg); +} + +#if LWIP_TCP +/** + * TCP callback function if a connection (opened by tcp_connect/lwip_netconn_do_connect) has + * been established (or reset by the remote host). + * + * @see tcp.h (struct tcp_pcb.connected) for parameters and return values + */ +static err_t +lwip_netconn_do_connected(void *arg, struct tcp_pcb *pcb, err_t err) +{ + struct netconn *conn; + int was_blocking; + sys_sem_t* op_completed_sem = NULL; + + LWIP_UNUSED_ARG(pcb); + + conn = (struct netconn *)arg; + + if (conn == NULL) { + return ERR_VAL; + } + + LWIP_ASSERT("conn->state == NETCONN_CONNECT", conn->state == NETCONN_CONNECT); + LWIP_ASSERT("(conn->current_msg != NULL) || conn->in_non_blocking_connect", + (conn->current_msg != NULL) || IN_NONBLOCKING_CONNECT(conn)); + + if (conn->current_msg != NULL) { + conn->current_msg->err = err; + op_completed_sem = LWIP_API_MSG_SEM(conn->current_msg); + } + if ((NETCONNTYPE_GROUP(conn->type) == NETCONN_TCP) && (err == ERR_OK)) { + setup_tcp(conn); + } + was_blocking = !IN_NONBLOCKING_CONNECT(conn); + SET_NONBLOCKING_CONNECT(conn, 0); + LWIP_ASSERT("blocking connect state error", + (was_blocking && op_completed_sem != NULL) || + (!was_blocking && op_completed_sem == NULL)); + conn->current_msg = NULL; + conn->state = NETCONN_NONE; + NETCONN_SET_SAFE_ERR(conn, ERR_OK); + API_EVENT(conn, NETCONN_EVT_SENDPLUS, 0); + + if (was_blocking) { + sys_sem_signal(op_completed_sem); + } + return ERR_OK; +} +#endif /* LWIP_TCP */ + +/** + * Connect a pcb contained inside a netconn + * Called from netconn_connect. + * + * @param msg the api_msg_msg pointing to the connection and containing + * the IP address and port to connect to + */ +void +lwip_netconn_do_connect(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (msg->conn->pcb.tcp == NULL) { + /* This may happen when calling netconn_connect() a second time */ + msg->err = ERR_CLSD; + } else { + switch (NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + msg->err = raw_connect(msg->conn->pcb.raw, API_EXPR_REF(msg->msg.bc.ipaddr)); + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + msg->err = udp_connect(msg->conn->pcb.udp, API_EXPR_REF(msg->msg.bc.ipaddr), msg->msg.bc.port); + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + /* Prevent connect while doing any other action. */ + if (msg->conn->state == NETCONN_CONNECT) { + msg->err = ERR_ALREADY; + } else if (msg->conn->state != NETCONN_NONE) { + +#ifdef LWIP_ESP8266 + if( msg->conn->pcb.tcp->state == ESTABLISHED ) + msg->err = ERR_ISCONN; + else + msg->err = ERR_ALREADY; +#else + msg->err = ERR_ISCONN; +#endif + + } else { + setup_tcp(msg->conn); + msg->err = tcp_connect(msg->conn->pcb.tcp, API_EXPR_REF(msg->msg.bc.ipaddr), + msg->msg.bc.port, lwip_netconn_do_connected); + if (msg->err == ERR_OK) { + u8_t non_blocking = netconn_is_nonblocking(msg->conn); + msg->conn->state = NETCONN_CONNECT; + SET_NONBLOCKING_CONNECT(msg->conn, non_blocking); + if (non_blocking) { + msg->err = ERR_INPROGRESS; + } else { + msg->conn->current_msg = msg; + /* sys_sem_signal() is called from lwip_netconn_do_connected (or err_tcp()), + when the connection is established! */ +#if LWIP_TCPIP_CORE_LOCKING + LWIP_ASSERT("state!", msg->conn->state == NETCONN_CONNECT); + UNLOCK_TCPIP_CORE(); + sys_arch_sem_wait(LWIP_API_MSG_SEM(msg), 0); + LOCK_TCPIP_CORE(); + LWIP_ASSERT("state!", msg->conn->state != NETCONN_CONNECT); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + return; + } + } + } + break; +#endif /* LWIP_TCP */ + default: + LWIP_ERROR("Invalid netconn type", 0, do{ msg->err = ERR_VAL; }while(0)); + break; + } + } + /* For all other protocols, netconn_connect() calls TCPIP_APIMSG(), + so use TCPIP_APIMSG_ACK() here. */ + TCPIP_APIMSG_ACK(msg); +} + +/** + * Disconnect a pcb contained inside a netconn + * Only used for UDP netconns. + * Called from netconn_disconnect. + * + * @param msg the api_msg_msg pointing to the connection to disconnect + */ +void +lwip_netconn_do_disconnect(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + +#if LWIP_UDP + if (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_UDP) { + udp_disconnect(msg->conn->pcb.udp); + msg->err = ERR_OK; + } else +#endif /* LWIP_UDP */ + { + msg->err = ERR_VAL; + } + TCPIP_APIMSG_ACK(msg); +} + +#if LWIP_TCP +/** + * Set a TCP pcb contained in a netconn into listen mode + * Called from netconn_listen. + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_listen(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (ERR_IS_FATAL(msg->conn->last_err)) { + msg->err = msg->conn->last_err; + } else { + msg->err = ERR_CONN; + if (msg->conn->pcb.tcp != NULL) { + if (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_TCP) { + if (msg->conn->state == NETCONN_NONE) { + struct tcp_pcb* lpcb; + if (msg->conn->pcb.tcp->state != CLOSED) { + /* connection is not closed, cannot listen */ + msg->err = ERR_VAL; + } else { +#if LWIP_IPV4 && LWIP_IPV6 + /* "Socket API like" dual-stack support: If IP to listen to is IP6_ADDR_ANY, + * and NETCONN_FLAG_IPV6_V6ONLY is NOT set, use IP_ANY_TYPE to listen + */ + if (ip_addr_cmp(&msg->conn->pcb.ip->local_ip, IP6_ADDR_ANY) && + (netconn_get_ipv6only(msg->conn) == 0)) { + /* change PCB type to IPADDR_TYPE_ANY */ + IP_SET_TYPE_VAL(msg->conn->pcb.tcp->local_ip, IPADDR_TYPE_ANY); + IP_SET_TYPE_VAL(msg->conn->pcb.tcp->remote_ip, IPADDR_TYPE_ANY); + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +#if TCP_LISTEN_BACKLOG + lpcb = tcp_listen_with_backlog(msg->conn->pcb.tcp, msg->msg.lb.backlog); +#else /* TCP_LISTEN_BACKLOG */ + lpcb = tcp_listen(msg->conn->pcb.tcp); +#endif /* TCP_LISTEN_BACKLOG */ + + if (lpcb == NULL) { + /* in this case, the old pcb is still allocated */ + msg->err = ERR_MEM; + } else { + /* delete the recvmbox and allocate the acceptmbox */ + if (sys_mbox_valid(&msg->conn->recvmbox)) { + /** @todo: should we drain the recvmbox here? */ + sys_mbox_free(&msg->conn->recvmbox); + sys_mbox_set_invalid(&msg->conn->recvmbox); + } + msg->err = ERR_OK; + if (!sys_mbox_valid(&msg->conn->acceptmbox)) { + msg->err = sys_mbox_new(&msg->conn->acceptmbox, DEFAULT_ACCEPTMBOX_SIZE); + } + if (msg->err == ERR_OK) { + msg->conn->state = NETCONN_LISTEN; + msg->conn->pcb.tcp = lpcb; + tcp_arg(msg->conn->pcb.tcp, msg->conn); + tcp_accept(msg->conn->pcb.tcp, accept_function); + } else { + /* since the old pcb is already deallocated, free lpcb now */ + tcp_close(lpcb); + msg->conn->pcb.tcp = NULL; + } + } + } + } else if (msg->conn->state == NETCONN_LISTEN) { + /* already listening, allow updating of the backlog */ + msg->err = ERR_OK; +#if TCP_LISTEN_BACKLOG + tcp_backlog_set(msg->conn->pcb.tcp, msg->msg.lb.backlog); +#endif /* TCP_LISTEN_BACKLOG */ + } + } else { + msg->err = ERR_ARG; + } + } + } + TCPIP_APIMSG_ACK(msg); +} +#endif /* LWIP_TCP */ + +/** + * Send some data on a RAW or UDP pcb contained in a netconn + * Called from netconn_send + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_send(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (ERR_IS_FATAL(msg->conn->last_err)) { + msg->err = msg->conn->last_err; + } else { + msg->err = ERR_CONN; + if (msg->conn->pcb.tcp != NULL) { + switch (NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + if (ip_addr_isany(&msg->msg.b->addr)) { + msg->err = raw_send(msg->conn->pcb.raw, msg->msg.b->p); + } else { + msg->err = raw_sendto(msg->conn->pcb.raw, msg->msg.b->p, &msg->msg.b->addr); + } + break; +#endif +#if LWIP_UDP + case NETCONN_UDP: +#if LWIP_CHECKSUM_ON_COPY + if (ip_addr_isany(&msg->msg.b->addr) || IP_IS_ANY_TYPE_VAL(msg->msg.b->addr)) { + msg->err = udp_send_chksum(msg->conn->pcb.udp, msg->msg.b->p, + msg->msg.b->flags & NETBUF_FLAG_CHKSUM, msg->msg.b->toport_chksum); + } else { + msg->err = udp_sendto_chksum(msg->conn->pcb.udp, msg->msg.b->p, + &msg->msg.b->addr, msg->msg.b->port, + msg->msg.b->flags & NETBUF_FLAG_CHKSUM, msg->msg.b->toport_chksum); + } +#else /* LWIP_CHECKSUM_ON_COPY */ + if (ip_addr_isany_val(msg->msg.b->addr) || IP_IS_ANY_TYPE_VAL(msg->msg.b->addr)) { + msg->err = udp_send(msg->conn->pcb.udp, msg->msg.b->p); + } else { + msg->err = udp_sendto(msg->conn->pcb.udp, msg->msg.b->p, &msg->msg.b->addr, msg->msg.b->port); + } +#endif /* LWIP_CHECKSUM_ON_COPY */ + break; +#endif /* LWIP_UDP */ + default: + break; + } + } + } + TCPIP_APIMSG_ACK(msg); +} + +#if LWIP_TCP +/** + * Indicate data has been received from a TCP pcb contained in a netconn + * Called from netconn_recv + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_recv(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + msg->err = ERR_OK; + if (msg->conn->pcb.tcp != NULL) { + if (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_TCP) { +#if TCP_LISTEN_BACKLOG + if (msg->conn->pcb.tcp->state == LISTEN) { + tcp_accepted(msg->conn->pcb.tcp); + } else +#endif /* TCP_LISTEN_BACKLOG */ + { + u32_t remaining = msg->msg.r.len; + do { + u16_t recved = (remaining > 0xffff) ? 0xffff : (u16_t)remaining; + tcp_recved(msg->conn->pcb.tcp, recved); + remaining -= recved; + } while (remaining != 0); + } + } + } + TCPIP_APIMSG_ACK(msg); +} + +/** + * See if more data needs to be written from a previous call to netconn_write. + * Called initially from lwip_netconn_do_write. If the first call can't send all data + * (because of low memory or empty send-buffer), this function is called again + * from sent_tcp() or poll_tcp() to send more data. If all data is sent, the + * blocking application thread (waiting in netconn_write) is released. + * + * @param conn netconn (that is currently in state NETCONN_WRITE) to process + * [@param delay 1 if called from sent/poll (wake up calling thread on end)] + * @return ERR_OK + * ERR_MEM if LWIP_TCPIP_CORE_LOCKING=1 and sending hasn't yet finished + */ +static err_t +lwip_netconn_do_writemore(struct netconn *conn WRITE_DELAYED_PARAM) +{ + err_t err; + const void *dataptr; + u16_t len, available; + u8_t write_finished = 0; + size_t diff; + u8_t dontblock; + u8_t apiflags; + + LWIP_ASSERT("conn != NULL", conn != NULL); + LWIP_ASSERT("conn->state == NETCONN_WRITE", (conn->state == NETCONN_WRITE)); + LWIP_ASSERT("conn->current_msg != NULL", conn->current_msg != NULL); + LWIP_ASSERT("conn->pcb.tcp != NULL", conn->pcb.tcp != NULL); + LWIP_ASSERT("conn->write_offset < conn->current_msg->msg.w.len", + conn->write_offset < conn->current_msg->msg.w.len); + + dontblock = netconn_is_nonblocking(conn) || + (conn->current_msg->msg.w.apiflags & NETCONN_DONTBLOCK); + apiflags = conn->current_msg->msg.w.apiflags; + +#if LWIP_SO_SNDTIMEO + if ((conn->send_timeout != 0) && + ((s32_t)(sys_now() - conn->current_msg->msg.w.time_started) >= conn->send_timeout)) { + write_finished = 1; + if (conn->write_offset == 0) { + /* nothing has been written */ + err = ERR_WOULDBLOCK; + conn->current_msg->msg.w.len = 0; + } else { + /* partial write */ + err = ERR_OK; + conn->current_msg->msg.w.len = conn->write_offset; + conn->write_offset = 0; + } + } else +#endif /* LWIP_SO_SNDTIMEO */ + { + dataptr = (const u8_t*)conn->current_msg->msg.w.dataptr + conn->write_offset; + diff = conn->current_msg->msg.w.len - conn->write_offset; + if (diff > 0xffffUL) { /* max_u16_t */ + len = 0xffff; + apiflags |= TCP_WRITE_FLAG_MORE; + } else { + len = (u16_t)diff; + } + available = tcp_sndbuf(conn->pcb.tcp); + if (available < len) { + /* don't try to write more than sendbuf */ + len = available; + if (dontblock) { + if (!len) { + err = ERR_WOULDBLOCK; + goto err_mem; + } + } else { + apiflags |= TCP_WRITE_FLAG_MORE; + } + } + LWIP_ASSERT("lwip_netconn_do_writemore: invalid length!", ((conn->write_offset + len) <= conn->current_msg->msg.w.len)); + err = tcp_write(conn->pcb.tcp, dataptr, len, apiflags); + /* if OK or memory error, check available space */ + if ((err == ERR_OK) || (err == ERR_MEM)) { +err_mem: + if (dontblock && (len < conn->current_msg->msg.w.len)) { + /* non-blocking write did not write everything: mark the pcb non-writable + and let poll_tcp check writable space to mark the pcb writable again */ + API_EVENT(conn, NETCONN_EVT_SENDMINUS, len); + conn->flags |= NETCONN_FLAG_CHECK_WRITESPACE; + } else if ((tcp_sndbuf(conn->pcb.tcp) <= TCP_SNDLOWAT) || + (tcp_sndqueuelen(conn->pcb.tcp) >= TCP_SNDQUEUELOWAT)) { + /* The queued byte- or pbuf-count exceeds the configured low-water limit, + let select mark this pcb as non-writable. */ + API_EVENT(conn, NETCONN_EVT_SENDMINUS, len); + } + } + + if (err == ERR_OK) { + err_t out_err; + conn->write_offset += len; + if ((conn->write_offset == conn->current_msg->msg.w.len) || dontblock) { + /* return sent length */ + conn->current_msg->msg.w.len = conn->write_offset; + /* everything was written */ + write_finished = 1; + } + out_err = tcp_output(conn->pcb.tcp); + if (ERR_IS_FATAL(out_err) || (out_err == ERR_RTE)) { + /* If tcp_output fails with fatal error or no route is found, + don't try writing any more but return the error + to the application thread. */ + err = out_err; + write_finished = 1; + conn->current_msg->msg.w.len = 0; + } + } else if ((err == ERR_MEM) && !dontblock) { + /* If ERR_MEM, we wait for sent_tcp or poll_tcp to be called + we do NOT return to the application thread, since ERR_MEM is + only a temporary error! */ + + /* tcp_write returned ERR_MEM, try tcp_output anyway */ + err_t out_err = tcp_output(conn->pcb.tcp); + if (ERR_IS_FATAL(out_err) || (out_err == ERR_RTE)) { + /* If tcp_output fails with fatal error or no route is found, + don't try writing any more but return the error + to the application thread. */ + err = out_err; + write_finished = 1; + conn->current_msg->msg.w.len = 0; + } else { + } + } else { + /* On errors != ERR_MEM, we don't try writing any more but return + the error to the application thread. */ + write_finished = 1; + conn->current_msg->msg.w.len = 0; + } + } + if (write_finished) { + /* everything was written: set back connection state + and back to application task */ + sys_sem_t* op_completed_sem = LWIP_API_MSG_SEM(conn->current_msg); + + conn->current_msg->err = err; + conn->current_msg = NULL; + conn->write_offset = 0; + conn->state = NETCONN_NONE; + NETCONN_SET_SAFE_ERR(conn, err); +#if LWIP_TCPIP_CORE_LOCKING + if (delayed) +#endif + { + sys_sem_signal(op_completed_sem); + } + } +#if LWIP_TCPIP_CORE_LOCKING + else { + return ERR_MEM; + } +#endif + return ERR_OK; +} +#endif /* LWIP_TCP */ + +/** + * Send some data on a TCP pcb contained in a netconn + * Called from netconn_write + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_write(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (ERR_IS_FATAL(msg->conn->last_err)) { + msg->err = msg->conn->last_err; + } else { + if (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_TCP) { +#if LWIP_TCP + if (msg->conn->state != NETCONN_NONE) { + /* netconn is connecting, closing or in blocking write */ + msg->err = ERR_INPROGRESS; + } else if (msg->conn->pcb.tcp != NULL) { + msg->conn->state = NETCONN_WRITE; + /* set all the variables used by lwip_netconn_do_writemore */ + LWIP_ASSERT("already writing or closing", msg->conn->current_msg == NULL && + msg->conn->write_offset == 0); + LWIP_ASSERT("msg->msg.w.len != 0", msg->msg.w.len != 0); + msg->conn->current_msg = msg; + msg->conn->write_offset = 0; +#if LWIP_TCPIP_CORE_LOCKING + if (lwip_netconn_do_writemore(msg->conn, 0) != ERR_OK) { + LWIP_ASSERT("state!", msg->conn->state == NETCONN_WRITE); + UNLOCK_TCPIP_CORE(); + +#ifdef LWIP_ESP8266 +//#if 0 + sys_arch_sem_wait( LWIP_API_MSG_SND_SEM(msg), 0); +#else + sys_arch_sem_wait(LWIP_API_MSG_SEM(msg), 0); +#endif + + LOCK_TCPIP_CORE(); + LWIP_ASSERT("state!", msg->conn->state != NETCONN_WRITE); + } +#else /* LWIP_TCPIP_CORE_LOCKING */ + lwip_netconn_do_writemore(msg->conn); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + /* for both cases: if lwip_netconn_do_writemore was called, don't ACK the APIMSG + since lwip_netconn_do_writemore ACKs it! */ + return; + } else { + msg->err = ERR_CONN; + } +#else /* LWIP_TCP */ + msg->err = ERR_VAL; +#endif /* LWIP_TCP */ +#if (LWIP_UDP || LWIP_RAW) + } else { + msg->err = ERR_VAL; +#endif /* (LWIP_UDP || LWIP_RAW) */ + } + } + TCPIP_APIMSG_ACK(msg); +} + +/** + * Return a connection's local or remote address + * Called from netconn_getaddr + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_getaddr(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (msg->conn->pcb.ip != NULL) { + if (msg->msg.ad.local) { + ip_addr_copy(API_EXPR_DEREF(msg->msg.ad.ipaddr), + msg->conn->pcb.ip->local_ip); + } else { + ip_addr_copy(API_EXPR_DEREF(msg->msg.ad.ipaddr), + msg->conn->pcb.ip->remote_ip); + } + msg->err = ERR_OK; + switch (NETCONNTYPE_GROUP(msg->conn->type)) { +#if LWIP_RAW + case NETCONN_RAW: + if (msg->msg.ad.local) { + API_EXPR_DEREF(msg->msg.ad.port) = msg->conn->pcb.raw->protocol; + } else { + /* return an error as connecting is only a helper for upper layers */ + msg->err = ERR_CONN; + } + break; +#endif /* LWIP_RAW */ +#if LWIP_UDP + case NETCONN_UDP: + if (msg->msg.ad.local) { + API_EXPR_DEREF(msg->msg.ad.port) = msg->conn->pcb.udp->local_port; + } else { + if ((msg->conn->pcb.udp->flags & UDP_FLAGS_CONNECTED) == 0) { + msg->err = ERR_CONN; + } else { + API_EXPR_DEREF(msg->msg.ad.port) = msg->conn->pcb.udp->remote_port; + } + } + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case NETCONN_TCP: + if ((msg->msg.ad.local == 0) && + ((msg->conn->pcb.tcp->state == CLOSED) || (msg->conn->pcb.tcp->state == LISTEN))) { + /* pcb is not connected and remote name is requested */ + msg->err = ERR_CONN; + } else { + API_EXPR_DEREF(msg->msg.ad.port) = (msg->msg.ad.local ? msg->conn->pcb.tcp->local_port : msg->conn->pcb.tcp->remote_port); + } + break; +#endif /* LWIP_TCP */ + default: + LWIP_ASSERT("invalid netconn_type", 0); + break; + } + } else { + msg->err = ERR_CONN; + } + TCPIP_APIMSG_ACK(msg); +} + +/** + * Close or half-shutdown a TCP pcb contained in a netconn + * Called from netconn_close + * In contrast to closing sockets, the netconn is not deallocated. + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_close(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + +#if LWIP_TCP + enum netconn_state state = msg->conn->state; + /* First check if this is a TCP netconn and if it is in a correct state + (LISTEN doesn't support half shutdown) */ + if ((msg->conn->pcb.tcp != NULL) && + (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_TCP) && + ((msg->msg.sd.shut == NETCONN_SHUT_RDWR) || (state != NETCONN_LISTEN))) { + /* Check if we are in a connected state */ + if (state == NETCONN_CONNECT) { + /* TCP connect in progress: cannot shutdown */ + msg->err = ERR_CONN; + } else if (state == NETCONN_WRITE) { +#if LWIP_NETCONN_FULLDUPLEX + if (msg->msg.sd.shut & NETCONN_SHUT_WR) { + /* close requested, abort running write */ + sys_sem_t* op_completed_sem; + LWIP_ASSERT("msg->conn->current_msg != NULL", msg->conn->current_msg != NULL); + op_completed_sem = LWIP_API_MSG_SEM(msg->conn->current_msg); + msg->conn->current_msg->err = ERR_CLSD; + msg->conn->current_msg = NULL; + msg->conn->write_offset = 0; + msg->conn->state = NETCONN_NONE; + NETCONN_SET_SAFE_ERR(msg->conn, ERR_CLSD); + sys_sem_signal(op_completed_sem); + } else { + LWIP_ASSERT("msg->msg.sd.shut == NETCONN_SHUT_RD", msg->msg.sd.shut == NETCONN_SHUT_RD); + /* In this case, let the write continue and do not interfere with + conn->current_msg or conn->state! */ + msg->err = tcp_shutdown(msg->conn->pcb.tcp, 1, 0); + } +#else /* LWIP_NETCONN_FULLDUPLEX */ + msg->err = ERR_INPROGRESS; +#endif /* LWIP_NETCONN_FULLDUPLEX */ + } else { + if (msg->msg.sd.shut & NETCONN_SHUT_RD) { + /* Drain and delete mboxes */ + netconn_drain(msg->conn); + } + LWIP_ASSERT("already writing or closing", msg->conn->current_msg == NULL && + msg->conn->write_offset == 0); + msg->conn->state = NETCONN_CLOSE; + msg->conn->current_msg = msg; +#if LWIP_TCPIP_CORE_LOCKING + if (lwip_netconn_do_close_internal(msg->conn, 0) != ERR_OK) { + LWIP_ASSERT("state!", msg->conn->state == NETCONN_CLOSE); + UNLOCK_TCPIP_CORE(); + sys_arch_sem_wait(LWIP_API_MSG_SEM(msg), 0); + LOCK_TCPIP_CORE(); + LWIP_ASSERT("state!", msg->conn->state == NETCONN_NONE); + } +#else /* LWIP_TCPIP_CORE_LOCKING */ + lwip_netconn_do_close_internal(msg->conn); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + /* for tcp netconns, lwip_netconn_do_close_internal ACKs the message */ + return; + } + } else +#endif /* LWIP_TCP */ + { + msg->err = ERR_CONN; + } + TCPIP_APIMSG_ACK(msg); +} + +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) +/** + * Join multicast groups for UDP netconns. + * Called from netconn_join_leave_group + * + * @param msg the api_msg_msg pointing to the connection + */ +void +lwip_netconn_do_join_leave_group(void *m) +{ + struct api_msg_msg *msg = (struct api_msg_msg*)m; + + if (ERR_IS_FATAL(msg->conn->last_err)) { + msg->err = msg->conn->last_err; + } else { + if (msg->conn->pcb.tcp != NULL) { + if (NETCONNTYPE_GROUP(msg->conn->type) == NETCONN_UDP) { +#if LWIP_UDP +#if LWIP_IPV6 && LWIP_IPV6_MLD + if (NETCONNTYPE_ISIPV6(msg->conn->type)) { + if (msg->msg.jl.join_or_leave == NETCONN_JOIN) { + msg->err = mld6_joingroup(ip_2_ip6(API_EXPR_REF(msg->msg.jl.netif_addr)), + ip_2_ip6(API_EXPR_REF(msg->msg.jl.multiaddr))); + } else { + msg->err = mld6_leavegroup(ip_2_ip6(API_EXPR_REF(msg->msg.jl.netif_addr)), + ip_2_ip6(API_EXPR_REF(msg->msg.jl.multiaddr))); + } + } + else +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + { +#if LWIP_IGMP + if (msg->msg.jl.join_or_leave == NETCONN_JOIN) { + msg->err = igmp_joingroup(ip_2_ip4(API_EXPR_REF(msg->msg.jl.netif_addr)), + ip_2_ip4(API_EXPR_REF(msg->msg.jl.multiaddr))); + } else { + msg->err = igmp_leavegroup(ip_2_ip4(API_EXPR_REF(msg->msg.jl.netif_addr)), + ip_2_ip4(API_EXPR_REF(msg->msg.jl.multiaddr))); + } +#endif /* LWIP_IGMP */ + } +#endif /* LWIP_UDP */ +#if (LWIP_TCP || LWIP_RAW) + } else { + msg->err = ERR_VAL; +#endif /* (LWIP_TCP || LWIP_RAW) */ + } + } else { + msg->err = ERR_CONN; + } + } + TCPIP_APIMSG_ACK(msg); +} +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ + +#if LWIP_DNS +/** + * Callback function that is called when DNS name is resolved + * (or on timeout). A waiting application thread is waked up by + * signaling the semaphore. + */ +static void +lwip_netconn_do_dns_found(const char *name, const ip_addr_t *ipaddr, void *arg) +{ + struct dns_api_msg *msg = (struct dns_api_msg*)arg; + + /* we trust the internal implementation to be correct :-) */ + LWIP_UNUSED_ARG(name); + + if (ipaddr == NULL) { + /* timeout or memory error */ + API_EXPR_DEREF(msg->err) = ERR_VAL; + } else { + /* address was resolved */ + API_EXPR_DEREF(msg->err) = ERR_OK; + API_EXPR_DEREF(msg->addr) = *ipaddr; + } + /* wake up the application task waiting in netconn_gethostbyname */ + sys_sem_signal(API_EXPR_REF_SEM(msg->sem)); +} + +/** + * Execute a DNS query + * Called from netconn_gethostbyname + * + * @param arg the dns_api_msg pointing to the query + */ +void +lwip_netconn_do_gethostbyname(void *arg) +{ + struct dns_api_msg *msg = (struct dns_api_msg*)arg; + u8_t addrtype = +#if LWIP_IPV4 && LWIP_IPV6 + msg->dns_addrtype; +#else + LWIP_DNS_ADDRTYPE_DEFAULT; +#endif + + API_EXPR_DEREF(msg->err) = dns_gethostbyname_addrtype(msg->name, + API_EXPR_REF(msg->addr), lwip_netconn_do_dns_found, msg, addrtype); + if (API_EXPR_DEREF(msg->err) != ERR_INPROGRESS) { + /* on error or immediate success, wake up the application + * task waiting in netconn_gethostbyname */ + sys_sem_signal(API_EXPR_REF_SEM(msg->sem)); + } +} +#endif /* LWIP_DNS */ + +#endif /* LWIP_NETCONN */ diff --git a/components/lwip/api/err.c b/components/lwip/api/err.c new file mode 100755 index 000000000..f3650f4ca --- /dev/null +++ b/components/lwip/api/err.c @@ -0,0 +1,75 @@ +/** + * @file + * Error Management module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/err.h" + +#ifdef LWIP_DEBUG + +static const char *err_strerr[] = { + "Ok.", /* ERR_OK 0 */ + "Out of memory error.", /* ERR_MEM -1 */ + "Buffer error.", /* ERR_BUF -2 */ + "Timeout.", /* ERR_TIMEOUT -3 */ + "Routing problem.", /* ERR_RTE -4 */ + "Operation in progress.", /* ERR_INPROGRESS -5 */ + "Illegal value.", /* ERR_VAL -6 */ + "Operation would block.", /* ERR_WOULDBLOCK -7 */ + "Address in use.", /* ERR_USE -8 */ + "Already connecting.", /* ERR_ALREADY -9 */ + "Already connected.", /* ERR_ISCONN -10 */ + "Not connected.", /* ERR_CONN -11 */ + "Low-level netif error.", /* ERR_IF -12 */ + "Connection aborted.", /* ERR_ABRT -13 */ + "Connection reset.", /* ERR_RST -14 */ + "Connection closed.", /* ERR_CLSD -15 */ + "Illegal argument." /* ERR_ARG -16 */ +}; + +/** + * Convert an lwip internal error to a string representation. + * + * @param err an lwip internal err_t + * @return a string representation for err + */ +const char * +lwip_strerr(err_t err) +{ + return err_strerr[-err]; +} + +#endif /* LWIP_DEBUG */ diff --git a/components/lwip/api/netbuf.c b/components/lwip/api/netbuf.c new file mode 100755 index 000000000..6c6dc69cc --- /dev/null +++ b/components/lwip/api/netbuf.c @@ -0,0 +1,250 @@ +/** + * @file + * Network buffer management + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_NETCONN /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/netbuf.h" +#include "lwip/memp.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** + * Create (allocate) and initialize a new netbuf. + * The netbuf doesn't yet contain a packet buffer! + * + * @return a pointer to a new netbuf + * NULL on lack of memory + */ +struct +netbuf *netbuf_new(void) +{ + struct netbuf *buf; + + buf = (struct netbuf *)memp_malloc(MEMP_NETBUF); + if (buf != NULL) { + buf->p = NULL; + buf->ptr = NULL; + ip_addr_set_zero(&buf->addr); + buf->port = 0; +#if LWIP_NETBUF_RECVINFO || LWIP_CHECKSUM_ON_COPY +#if LWIP_CHECKSUM_ON_COPY + buf->flags = 0; +#endif /* LWIP_CHECKSUM_ON_COPY */ + buf->toport_chksum = 0; +#if LWIP_NETBUF_RECVINFO + ip_addr_set_zero(&buf->toaddr); +#endif /* LWIP_NETBUF_RECVINFO */ +#endif /* LWIP_NETBUF_RECVINFO || LWIP_CHECKSUM_ON_COPY */ + return buf; + } else { + return NULL; + } +} + +/** + * Deallocate a netbuf allocated by netbuf_new(). + * + * @param buf pointer to a netbuf allocated by netbuf_new() + */ +void +netbuf_delete(struct netbuf *buf) +{ + if (buf != NULL) { + if (buf->p != NULL) { + pbuf_free(buf->p); + buf->p = buf->ptr = NULL; + } + memp_free(MEMP_NETBUF, buf); + } +} + +/** + * Allocate memory for a packet buffer for a given netbuf. + * + * @param buf the netbuf for which to allocate a packet buffer + * @param size the size of the packet buffer to allocate + * @return pointer to the allocated memory + * NULL if no memory could be allocated + */ +void * +netbuf_alloc(struct netbuf *buf, u16_t size) +{ + LWIP_ERROR("netbuf_alloc: invalid buf", (buf != NULL), return NULL;); + + /* Deallocate any previously allocated memory. */ + if (buf->p != NULL) { + pbuf_free(buf->p); + } + buf->p = pbuf_alloc(PBUF_TRANSPORT, size, PBUF_RAM); + if (buf->p == NULL) { + return NULL; + } + LWIP_ASSERT("check that first pbuf can hold size", + (buf->p->len >= size)); + buf->ptr = buf->p; + return buf->p->payload; +} + +/** + * Free the packet buffer included in a netbuf + * + * @param buf pointer to the netbuf which contains the packet buffer to free + */ +void +netbuf_free(struct netbuf *buf) +{ + LWIP_ERROR("netbuf_free: invalid buf", (buf != NULL), return;); + if (buf->p != NULL) { + pbuf_free(buf->p); + } + buf->p = buf->ptr = NULL; +} + +/** + * Let a netbuf reference existing (non-volatile) data. + * + * @param buf netbuf which should reference the data + * @param dataptr pointer to the data to reference + * @param size size of the data + * @return ERR_OK if data is referenced + * ERR_MEM if data couldn't be referenced due to lack of memory + */ +err_t +netbuf_ref(struct netbuf *buf, const void *dataptr, u16_t size) +{ + LWIP_ERROR("netbuf_ref: invalid buf", (buf != NULL), return ERR_ARG;); + if (buf->p != NULL) { + pbuf_free(buf->p); + } + buf->p = pbuf_alloc(PBUF_TRANSPORT, 0, PBUF_REF); + if (buf->p == NULL) { + buf->ptr = NULL; + return ERR_MEM; + } + ((struct pbuf_rom*)buf->p)->payload = dataptr; + buf->p->len = buf->p->tot_len = size; + buf->ptr = buf->p; + return ERR_OK; +} + +/** + * Chain one netbuf to another (@see pbuf_chain) + * + * @param head the first netbuf + * @param tail netbuf to chain after head, freed by this function, may not be reference after returning + */ +void +netbuf_chain(struct netbuf *head, struct netbuf *tail) +{ + LWIP_ERROR("netbuf_ref: invalid head", (head != NULL), return;); + LWIP_ERROR("netbuf_chain: invalid tail", (tail != NULL), return;); + pbuf_cat(head->p, tail->p); + head->ptr = head->p; + memp_free(MEMP_NETBUF, tail); +} + +/** + * Get the data pointer and length of the data inside a netbuf. + * + * @param buf netbuf to get the data from + * @param dataptr pointer to a void pointer where to store the data pointer + * @param len pointer to an u16_t where the length of the data is stored + * @return ERR_OK if the information was retrieved, + * ERR_BUF on error. + */ +err_t +netbuf_data(struct netbuf *buf, void **dataptr, u16_t *len) +{ + LWIP_ERROR("netbuf_data: invalid buf", (buf != NULL), return ERR_ARG;); + LWIP_ERROR("netbuf_data: invalid dataptr", (dataptr != NULL), return ERR_ARG;); + LWIP_ERROR("netbuf_data: invalid len", (len != NULL), return ERR_ARG;); + + if (buf->ptr == NULL) { + return ERR_BUF; + } + *dataptr = buf->ptr->payload; + *len = buf->ptr->len; + return ERR_OK; +} + +/** + * Move the current data pointer of a packet buffer contained in a netbuf + * to the next part. + * The packet buffer itself is not modified. + * + * @param buf the netbuf to modify + * @return -1 if there is no next part + * 1 if moved to the next part but now there is no next part + * 0 if moved to the next part and there are still more parts + */ +s8_t +netbuf_next(struct netbuf *buf) +{ + LWIP_ERROR("netbuf_free: invalid buf", (buf != NULL), return -1;); + if (buf->ptr->next == NULL) { + return -1; + } + buf->ptr = buf->ptr->next; + if (buf->ptr->next == NULL) { + return 1; + } + return 0; +} + +/** + * Move the current data pointer of a packet buffer contained in a netbuf + * to the beginning of the packet. + * The packet buffer itself is not modified. + * + * @param buf the netbuf to modify + */ +void +netbuf_first(struct netbuf *buf) +{ + LWIP_ERROR("netbuf_free: invalid buf", (buf != NULL), return;); + buf->ptr = buf->p; +} + +#endif /* LWIP_NETCONN */ diff --git a/components/lwip/api/netdb.c b/components/lwip/api/netdb.c new file mode 100755 index 000000000..8fd3f4186 --- /dev/null +++ b/components/lwip/api/netdb.c @@ -0,0 +1,415 @@ +/** + * @file + * API functions for name resolving + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Simon Goldschmidt + * + */ + +#include "lwip/netdb.h" + +#if LWIP_DNS && LWIP_SOCKET + +#include "lwip/err.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/ip_addr.h" +#include "lwip/api.h" +#include "lwip/dns.h" + +#include +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** helper struct for gethostbyname_r to access the char* buffer */ +struct gethostbyname_r_helper { + ip_addr_t *addr_list[2]; + ip_addr_t addr; + char *aliases; +}; + +/** h_errno is exported in netdb.h for access by applications. */ +#if LWIP_DNS_API_DECLARE_H_ERRNO +int h_errno; +#endif /* LWIP_DNS_API_DECLARE_H_ERRNO */ + +/** define "hostent" variables storage: 0 if we use a static (but unprotected) + * set of variables for lwip_gethostbyname, 1 if we use a local storage */ +#ifndef LWIP_DNS_API_HOSTENT_STORAGE +#define LWIP_DNS_API_HOSTENT_STORAGE 0 +#endif + +/** define "hostent" variables storage */ +#if LWIP_DNS_API_HOSTENT_STORAGE +#define HOSTENT_STORAGE +#else +#define HOSTENT_STORAGE static +#endif /* LWIP_DNS_API_STATIC_HOSTENT */ + +/** + * Returns an entry containing addresses of address family AF_INET + * for the host with name name. + * Due to dns_gethostbyname limitations, only one address is returned. + * + * @param name the hostname to resolve + * @return an entry containing addresses of address family AF_INET + * for the host with name name + */ +struct hostent* +lwip_gethostbyname(const char *name) +{ + err_t err; + ip_addr_t addr; + + /* buffer variables for lwip_gethostbyname() */ + HOSTENT_STORAGE struct hostent s_hostent; + HOSTENT_STORAGE char *s_aliases; + HOSTENT_STORAGE ip_addr_t s_hostent_addr; + HOSTENT_STORAGE ip_addr_t *s_phostent_addr[2]; + HOSTENT_STORAGE char s_hostname[DNS_MAX_NAME_LENGTH + 1]; + + /* query host IP address */ + err = netconn_gethostbyname(name, &addr); + if (err != ERR_OK) { + LWIP_DEBUGF(DNS_DEBUG, ("lwip_gethostbyname(%s) failed, err=%d\n", name, err)); + h_errno = HOST_NOT_FOUND; + return NULL; + } + + /* fill hostent */ + s_hostent_addr = addr; + s_phostent_addr[0] = &s_hostent_addr; + s_phostent_addr[1] = NULL; + strncpy(s_hostname, name, DNS_MAX_NAME_LENGTH); + s_hostname[DNS_MAX_NAME_LENGTH] = 0; + s_hostent.h_name = s_hostname; + s_aliases = NULL; + s_hostent.h_aliases = &s_aliases; + s_hostent.h_addrtype = AF_INET; + s_hostent.h_length = sizeof(ip_addr_t); + s_hostent.h_addr_list = (char**)&s_phostent_addr; + +#if DNS_DEBUG + /* dump hostent */ + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_name == %s\n", s_hostent.h_name)); + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_aliases == %p\n", (void*)s_hostent.h_aliases)); + /* h_aliases are always empty */ + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_addrtype == %d\n", s_hostent.h_addrtype)); + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_length == %d\n", s_hostent.h_length)); + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_addr_list == %p\n", (void*)s_hostent.h_addr_list)); + if (s_hostent.h_addr_list != NULL) { + u8_t idx; + for (idx=0; s_hostent.h_addr_list[idx]; idx++) { + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_addr_list[%i] == %p\n", idx, s_hostent.h_addr_list[idx])); + LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_addr_list[%i]-> == %s\n", idx, ipaddr_ntoa((ip_addr_t*)s_hostent.h_addr_list[idx]))); + } + } +#endif /* DNS_DEBUG */ + +#if LWIP_DNS_API_HOSTENT_STORAGE + /* this function should return the "per-thread" hostent after copy from s_hostent */ + return sys_thread_hostent(&s_hostent); +#else + return &s_hostent; +#endif /* LWIP_DNS_API_HOSTENT_STORAGE */ +} + +/** + * Thread-safe variant of lwip_gethostbyname: instead of using a static + * buffer, this function takes buffer and errno pointers as arguments + * and uses these for the result. + * + * @param name the hostname to resolve + * @param ret pre-allocated struct where to store the result + * @param buf pre-allocated buffer where to store additional data + * @param buflen the size of buf + * @param result pointer to a hostent pointer that is set to ret on success + * and set to zero on error + * @param h_errnop pointer to an int where to store errors (instead of modifying + * the global h_errno) + * @return 0 on success, non-zero on error, additional error information + * is stored in *h_errnop instead of h_errno to be thread-safe + */ +int +lwip_gethostbyname_r(const char *name, struct hostent *ret, char *buf, + size_t buflen, struct hostent **result, int *h_errnop) +{ + err_t err; + struct gethostbyname_r_helper *h; + char *hostname; + size_t namelen; + int lh_errno; + + if (h_errnop == NULL) { + /* ensure h_errnop is never NULL */ + h_errnop = &lh_errno; + } + + if (result == NULL) { + /* not all arguments given */ + *h_errnop = EINVAL; + return -1; + } + /* first thing to do: set *result to nothing */ + *result = NULL; + if ((name == NULL) || (ret == NULL) || (buf == NULL)) { + /* not all arguments given */ + *h_errnop = EINVAL; + return -1; + } + + namelen = strlen(name); + if (buflen < (sizeof(struct gethostbyname_r_helper) + namelen + 1 + (MEM_ALIGNMENT - 1))) { + /* buf can't hold the data needed + a copy of name */ + *h_errnop = ERANGE; + return -1; + } + + h = (struct gethostbyname_r_helper*)LWIP_MEM_ALIGN(buf); + hostname = ((char*)h) + sizeof(struct gethostbyname_r_helper); + + /* query host IP address */ + err = netconn_gethostbyname(name, &h->addr); + if (err != ERR_OK) { + LWIP_DEBUGF(DNS_DEBUG, ("lwip_gethostbyname(%s) failed, err=%d\n", name, err)); + *h_errnop = HOST_NOT_FOUND; + return -1; + } + + /* copy the hostname into buf */ + MEMCPY(hostname, name, namelen); + hostname[namelen] = 0; + + /* fill hostent */ + h->addr_list[0] = &h->addr; + h->addr_list[1] = NULL; + h->aliases = NULL; + ret->h_name = hostname; + ret->h_aliases = &h->aliases; + ret->h_addrtype = AF_INET; + ret->h_length = sizeof(ip_addr_t); + ret->h_addr_list = (char**)&h->addr_list; + + /* set result != NULL */ + *result = ret; + + /* return success */ + return 0; +} + +/** + * Frees one or more addrinfo structures returned by getaddrinfo(), along with + * any additional storage associated with those structures. If the ai_next field + * of the structure is not null, the entire list of structures is freed. + * + * @param ai struct addrinfo to free + */ +void +lwip_freeaddrinfo(struct addrinfo *ai) +{ + struct addrinfo *next; + + while (ai != NULL) { + next = ai->ai_next; + memp_free(MEMP_NETDB, ai); + ai = next; + } +} + +/** + * Translates the name of a service location (for example, a host name) and/or + * a service name and returns a set of socket addresses and associated + * information to be used in creating a socket with which to address the + * specified service. + * Memory for the result is allocated internally and must be freed by calling + * lwip_freeaddrinfo()! + * + * Due to a limitation in dns_gethostbyname, only the first address of a + * host is returned. + * Also, service names are not supported (only port numbers)! + * + * @param nodename descriptive name or address string of the host + * (may be NULL -> local address) + * @param servname port number as string of NULL + * @param hints structure containing input values that set socktype and protocol + * @param res pointer to a pointer where to store the result (set to NULL on failure) + * @return 0 on success, non-zero on failure + * + * @todo: implement AI_V4MAPPED, AI_ADDRCONFIG + */ +int +lwip_getaddrinfo(const char *nodename, const char *servname, + const struct addrinfo *hints, struct addrinfo **res) +{ + err_t err; + ip_addr_t addr; + struct addrinfo *ai; + struct sockaddr_storage *sa = NULL; + int port_nr = 0; + size_t total_size; + size_t namelen = 0; + int ai_family; + + if (res == NULL) { + return EAI_FAIL; + } + *res = NULL; + if ((nodename == NULL) && (servname == NULL)) { + return EAI_NONAME; + } + + if (hints != NULL) { + ai_family = hints->ai_family; + if ((ai_family != AF_UNSPEC) +#if LWIP_IPV4 + && (ai_family != AF_INET) +#endif /* LWIP_IPV4 */ +#if LWIP_IPV6 + && (ai_family != AF_INET6) +#endif /* LWIP_IPV6 */ + ) { + return EAI_FAMILY; + } + } else { + ai_family = AF_UNSPEC; + } + + if (servname != NULL) { + /* service name specified: convert to port number + * @todo?: currently, only ASCII integers (port numbers) are supported (AI_NUMERICSERV)! */ + port_nr = atoi(servname); + if ((port_nr <= 0) || (port_nr > 0xffff)) { + return EAI_SERVICE; + } + } + + if (nodename != NULL) { + /* service location specified, try to resolve */ + if ((hints != NULL) && (hints->ai_flags & AI_NUMERICHOST)) { + /* no DNS lookup, just parse for an address string */ + if (!ipaddr_aton(nodename, &addr)) { + return EAI_NONAME; + } +#if LWIP_IPV4 && LWIP_IPV6 + if ((IP_IS_V6_VAL(addr) && ai_family == AF_INET) || + (!IP_IS_V6_VAL(addr) && ai_family == AF_INET6)) { + return EAI_NONAME; + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + } else { +#if LWIP_IPV4 && LWIP_IPV6 + /* AF_UNSPEC: prefer IPv4 */ + u8_t type = NETCONN_DNS_IPV4_IPV6; + if (ai_family == AF_INET) { + type = NETCONN_DNS_IPV4; + } else if (ai_family == AF_INET6) { + type = NETCONN_DNS_IPV6; + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + err = netconn_gethostbyname_addrtype(nodename, &addr, type); + if (err != ERR_OK) { + return EAI_FAIL; + } + } + } else { + /* service location specified, use loopback address */ + if ((hints != NULL) && (hints->ai_flags & AI_PASSIVE)) { + ip_addr_set_any(ai_family == AF_INET6, &addr); + } else { + ip_addr_set_loopback(ai_family == AF_INET6, &addr); + } + } + + total_size = sizeof(struct addrinfo) + sizeof(struct sockaddr_storage); + if (nodename != NULL) { + namelen = strlen(nodename); + if (namelen > DNS_MAX_NAME_LENGTH) { + /* invalid name length */ + return EAI_FAIL; + } + LWIP_ASSERT("namelen is too long", total_size + namelen + 1 > total_size); + total_size += namelen + 1; + } + /* If this fails, please report to lwip-devel! :-) */ + LWIP_ASSERT("total_size <= NETDB_ELEM_SIZE: please report this!", + total_size <= NETDB_ELEM_SIZE); + ai = (struct addrinfo *)memp_malloc(MEMP_NETDB); + if (ai == NULL) { + return EAI_MEMORY; + } + memset(ai, 0, total_size); + sa = (struct sockaddr_storage *)(void*)((u8_t*)ai + sizeof(struct addrinfo)); + if (IP_IS_V6_VAL(addr)) { +#if LWIP_IPV6 + struct sockaddr_in6 *sa6 = (struct sockaddr_in6*)sa; + /* set up sockaddr */ + inet6_addr_from_ip6addr(&sa6->sin6_addr, ip_2_ip6(&addr)); + sa6->sin6_family = AF_INET6; + sa6->sin6_len = sizeof(struct sockaddr_in6); + sa6->sin6_port = htons((u16_t)port_nr); + ai->ai_family = AF_INET6; +#endif /* LWIP_IPV6 */ + } else { +#if LWIP_IPV4 + struct sockaddr_in *sa4 = (struct sockaddr_in*)sa; + /* set up sockaddr */ + inet_addr_from_ipaddr(&sa4->sin_addr, ip_2_ip4(&addr)); + sa4->sin_family = AF_INET; + sa4->sin_len = sizeof(struct sockaddr_in); + sa4->sin_port = htons((u16_t)port_nr); + ai->ai_family = AF_INET; +#endif /* LWIP_IPV4 */ + } + + /* set up addrinfo */ + if (hints != NULL) { + /* copy socktype & protocol from hints if specified */ + ai->ai_socktype = hints->ai_socktype; + ai->ai_protocol = hints->ai_protocol; + } + if (nodename != NULL) { + /* copy nodename to canonname if specified */ + ai->ai_canonname = ((char*)ai + sizeof(struct addrinfo) + sizeof(struct sockaddr_storage)); + MEMCPY(ai->ai_canonname, nodename, namelen); + ai->ai_canonname[namelen] = 0; + } + ai->ai_addrlen = sizeof(struct sockaddr_storage); + ai->ai_addr = (struct sockaddr*)sa; + + *res = ai; + + return 0; +} + +#endif /* LWIP_DNS && LWIP_SOCKET */ diff --git a/components/lwip/api/netifapi.c b/components/lwip/api/netifapi.c new file mode 100755 index 000000000..3ddb9f546 --- /dev/null +++ b/components/lwip/api/netifapi.c @@ -0,0 +1,206 @@ +/** + * @file + * Network Interface Sequential API module + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" + +#if LWIP_NETIF_API /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/netifapi.h" +#include "lwip/memp.h" +#include "lwip/priv/tcpip_priv.h" + +#define NETIFAPI_VAR_REF(name) API_VAR_REF(name) +#define NETIFAPI_VAR_DECLARE(name) API_VAR_DECLARE(struct netifapi_msg, name) +#define NETIFAPI_VAR_ALLOC(name) API_VAR_ALLOC(struct netifapi_msg, MEMP_NETIFAPI_MSG, name) +#define NETIFAPI_VAR_FREE(name) API_VAR_FREE(MEMP_NETIFAPI_MSG, name) + +/** + * Call netif_add() inside the tcpip_thread context. + */ +static err_t +netifapi_do_netif_add(struct tcpip_api_call *m) +{ + struct netifapi_msg *msg = (struct netifapi_msg*)m; + + if (!netif_add( msg->netif, +#if LWIP_IPV4 + API_EXPR_REF(msg->msg.add.ipaddr), + API_EXPR_REF(msg->msg.add.netmask), + API_EXPR_REF(msg->msg.add.gw), +#endif /* LWIP_IPV4 */ + msg->msg.add.state, + msg->msg.add.init, + msg->msg.add.input)) { + return ERR_IF; + } else { + return ERR_OK; + } +} + +#if LWIP_IPV4 +/** + * Call netif_set_addr() inside the tcpip_thread context. + */ +static err_t +netifapi_do_netif_set_addr(struct tcpip_api_call *m) +{ + struct netifapi_msg *msg = (struct netifapi_msg*)m; + + netif_set_addr( msg->netif, + API_EXPR_REF(msg->msg.add.ipaddr), + API_EXPR_REF(msg->msg.add.netmask), + API_EXPR_REF(msg->msg.add.gw)); + return ERR_OK; +} +#endif /* LWIP_IPV4 */ + +/** + * Call the "errtfunc" (or the "voidfunc" if "errtfunc" is NULL) inside the + * tcpip_thread context. + */ +static err_t +netifapi_do_netif_common(struct tcpip_api_call *m) +{ + struct netifapi_msg *msg = (struct netifapi_msg*)m; + + if (msg->msg.common.errtfunc != NULL) { + return msg->msg.common.errtfunc(msg->netif); + } else { + msg->msg.common.voidfunc(msg->netif); + return ERR_OK; + } +} + +/** + * Call netif_add() in a thread-safe way by running that function inside the + * tcpip_thread context. + * + * @note for params @see netif_add() + */ +err_t +netifapi_netif_add(struct netif *netif, +#if LWIP_IPV4 + const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, const ip4_addr_t *gw, +#endif /* LWIP_IPV4 */ + void *state, netif_init_fn init, netif_input_fn input) +{ + err_t err; + NETIFAPI_VAR_DECLARE(msg); + NETIFAPI_VAR_ALLOC(msg); + +#if LWIP_IPV4 + if (ipaddr == NULL) { + ipaddr = IP4_ADDR_ANY; + } + if (netmask == NULL) { + netmask = IP4_ADDR_ANY; + } + if (gw == NULL) { + gw = IP4_ADDR_ANY; + } +#endif /* LWIP_IPV4 */ + + NETIFAPI_VAR_REF(msg).netif = netif; +#if LWIP_IPV4 + NETIFAPI_VAR_REF(msg).msg.add.ipaddr = NETIFAPI_VAR_REF(ipaddr); + NETIFAPI_VAR_REF(msg).msg.add.netmask = NETIFAPI_VAR_REF(netmask); + NETIFAPI_VAR_REF(msg).msg.add.gw = NETIFAPI_VAR_REF(gw); +#endif /* LWIP_IPV4 */ + NETIFAPI_VAR_REF(msg).msg.add.state = state; + NETIFAPI_VAR_REF(msg).msg.add.init = init; + NETIFAPI_VAR_REF(msg).msg.add.input = input; + err = tcpip_api_call(netifapi_do_netif_add, &API_VAR_REF(msg).call); + NETIFAPI_VAR_FREE(msg); + return err; +} + +#if LWIP_IPV4 +/** + * Call netif_set_addr() in a thread-safe way by running that function inside the + * tcpip_thread context. + * + * @note for params @see netif_set_addr() + */ +err_t +netifapi_netif_set_addr(struct netif *netif, + const ip4_addr_t *ipaddr, + const ip4_addr_t *netmask, + const ip4_addr_t *gw) +{ + err_t err; + NETIFAPI_VAR_DECLARE(msg); + NETIFAPI_VAR_ALLOC(msg); + + if (ipaddr == NULL) { + ipaddr = IP4_ADDR_ANY; + } + if (netmask == NULL) { + netmask = IP4_ADDR_ANY; + } + if (gw == NULL) { + gw = IP4_ADDR_ANY; + } + + NETIFAPI_VAR_REF(msg).netif = netif; + NETIFAPI_VAR_REF(msg).msg.add.ipaddr = NETIFAPI_VAR_REF(ipaddr); + NETIFAPI_VAR_REF(msg).msg.add.netmask = NETIFAPI_VAR_REF(netmask); + NETIFAPI_VAR_REF(msg).msg.add.gw = NETIFAPI_VAR_REF(gw); + err = tcpip_api_call(netifapi_do_netif_set_addr, &API_VAR_REF(msg).call); + NETIFAPI_VAR_FREE(msg); + return err; +} +#endif /* LWIP_IPV4 */ + +/** + * call the "errtfunc" (or the "voidfunc" if "errtfunc" is NULL) in a thread-safe + * way by running that function inside the tcpip_thread context. + * + * @note use only for functions where there is only "netif" parameter. + */ +err_t +netifapi_netif_common(struct netif *netif, netifapi_void_fn voidfunc, + netifapi_errt_fn errtfunc) +{ + err_t err; + NETIFAPI_VAR_DECLARE(msg); + NETIFAPI_VAR_ALLOC(msg); + + NETIFAPI_VAR_REF(msg).netif = netif; + NETIFAPI_VAR_REF(msg).msg.common.voidfunc = voidfunc; + NETIFAPI_VAR_REF(msg).msg.common.errtfunc = errtfunc; + err = tcpip_api_call(netifapi_do_netif_common, &API_VAR_REF(msg).call); + NETIFAPI_VAR_FREE(msg); + return err; +} + +#endif /* LWIP_NETIF_API */ diff --git a/components/lwip/api/pppapi.c b/components/lwip/api/pppapi.c new file mode 100755 index 000000000..b5dcd144b --- /dev/null +++ b/components/lwip/api/pppapi.c @@ -0,0 +1,371 @@ +/** + * @file + * Point To Point Protocol Sequential API module + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" + +#if LWIP_PPP_API /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pppapi.h" +#include "lwip/priv/tcpip_priv.h" +#include "netif/ppp/pppoe.h" +#include "netif/ppp/pppol2tp.h" +#include "netif/ppp/pppos.h" + + +/** + * Call ppp_set_default() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_set_default(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + ppp_set_default(msg->ppp); + return ERR_OK; +} + +/** + * Call ppp_set_default() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +void +pppapi_set_default(ppp_pcb *pcb) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + tcpip_api_call(pppapi_do_ppp_set_default, &msg.call); +} + + +/** + * Call ppp_set_auth() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_set_auth(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + ppp_set_auth(msg->ppp, msg->msg.setauth.authtype, + msg->msg.setauth.user, msg->msg.setauth.passwd); + return ERR_OK; +} + +/** + * Call ppp_set_auth() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +void +pppapi_set_auth(ppp_pcb *pcb, u8_t authtype, const char *user, const char *passwd) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + msg.msg.msg.setauth.authtype = authtype; + msg.msg.msg.setauth.user = user; + msg.msg.msg.setauth.passwd = passwd; + tcpip_api_call(pppapi_do_ppp_set_auth, &msg.call); +} + + +#if PPP_NOTIFY_PHASE +/** + * Call ppp_set_notify_phase_callback() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_set_notify_phase_callback(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + ppp_set_notify_phase_callback(msg->ppp, msg->msg.setnotifyphasecb.notify_phase_cb); + return ERR_OK; +} + +/** + * Call ppp_set_notify_phase_callback() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +void +pppapi_set_notify_phase_callback(ppp_pcb *pcb, ppp_notify_phase_cb_fn notify_phase_cb) +{ + struct pppapi_msg msg; + msg.function = pppapi_do_ppp_set_notify_phase_callback; + msg.msg.ppp = pcb; + msg.msg.msg.setnotifyphasecb.notify_phase_cb = notify_phase_cb; + tcpip_api_call(pppapi_do_ppp_set_notify_phase_callback, &msg.call); +} +#endif /* PPP_NOTIFY_PHASE */ + + +#if PPPOS_SUPPORT +/** + * Call pppos_create() inside the tcpip_thread context. + */ +static err_t +pppapi_do_pppos_create(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + msg->ppp = pppos_create(msg->msg.serialcreate.pppif, msg->msg.serialcreate.output_cb, + msg->msg.serialcreate.link_status_cb, msg->msg.serialcreate.ctx_cb); + return ERR_OK; +} + +/** + * Call pppos_create() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +ppp_pcb* +pppapi_pppos_create(struct netif *pppif, pppos_output_cb_fn output_cb, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb) +{ + struct pppapi_msg msg; + msg.msg.msg.serialcreate.pppif = pppif; + msg.msg.msg.serialcreate.output_cb = output_cb; + msg.msg.msg.serialcreate.link_status_cb = link_status_cb; + msg.msg.msg.serialcreate.ctx_cb = ctx_cb; + tcpip_api_call(pppapi_do_pppos_create, &msg.call); + return msg.msg.ppp; +} +#endif /* PPPOS_SUPPORT */ + + +#if PPPOE_SUPPORT +/** + * Call pppoe_create() inside the tcpip_thread context. + */ +static err_t +pppapi_do_pppoe_create(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + msg->ppp = pppoe_create(msg->msg.ethernetcreate.pppif, msg->msg.ethernetcreate.ethif, + msg->msg.ethernetcreate.service_name, msg->msg.ethernetcreate.concentrator_name, + msg->msg.ethernetcreate.link_status_cb, msg->msg.ethernetcreate.ctx_cb); + return ERR_OK; +} + +/** + * Call pppoe_create() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +ppp_pcb* +pppapi_pppoe_create(struct netif *pppif, struct netif *ethif, const char *service_name, + const char *concentrator_name, ppp_link_status_cb_fn link_status_cb, + void *ctx_cb) +{ + struct pppapi_msg msg; + msg.msg.msg.ethernetcreate.pppif = pppif; + msg.msg.msg.ethernetcreate.ethif = ethif; + msg.msg.msg.ethernetcreate.service_name = service_name; + msg.msg.msg.ethernetcreate.concentrator_name = concentrator_name; + msg.msg.msg.ethernetcreate.link_status_cb = link_status_cb; + msg.msg.msg.ethernetcreate.ctx_cb = ctx_cb; + tcpip_api_call(pppapi_do_pppoe_create, &msg.call); + return msg.msg.ppp; +} +#endif /* PPPOE_SUPPORT */ + + +#if PPPOL2TP_SUPPORT +/** + * Call pppol2tp_create() inside the tcpip_thread context. + */ +static err_t +pppapi_do_pppol2tp_create(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + msg->ppp = pppol2tp_create(msg->msg.l2tpcreate.pppif, + msg->msg.l2tpcreate.netif, msg->msg.l2tpcreate.ipaddr, msg->msg.l2tpcreate.port, +#if PPPOL2TP_AUTH_SUPPORT + msg->msg.l2tpcreate.secret, + msg->msg.l2tpcreate.secret_len, +#else /* PPPOL2TP_AUTH_SUPPORT */ + NULL, +#endif /* PPPOL2TP_AUTH_SUPPORT */ + msg->msg.l2tpcreate.link_status_cb, msg->msg.l2tpcreate.ctx_cb); + return ERR_OK; +} + +/** + * Call pppol2tp_create() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +ppp_pcb* +pppapi_pppol2tp_create(struct netif *pppif, struct netif *netif, ip_addr_t *ipaddr, u16_t port, + const u8_t *secret, u8_t secret_len, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb) +{ + struct pppapi_msg msg; + msg.msg.msg.l2tpcreate.pppif = pppif; + msg.msg.msg.l2tpcreate.netif = netif; + msg.msg.msg.l2tpcreate.ipaddr = ipaddr; + msg.msg.msg.l2tpcreate.port = port; +#if PPPOL2TP_AUTH_SUPPORT + msg.msg.msg.l2tpcreate.secret = secret; + msg.msg.msg.l2tpcreate.secret_len = secret_len; +#endif /* PPPOL2TP_AUTH_SUPPORT */ + msg.msg.msg.l2tpcreate.link_status_cb = link_status_cb; + msg.msg.msg.l2tpcreate.ctx_cb = ctx_cb; + tcpip_api_call(pppapi_do_pppol2tp_create, &msg.call); + return msg.msg.ppp; +} +#endif /* PPPOL2TP_SUPPORT */ + + +/** + * Call ppp_connect() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_connect(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + return ppp_connect(msg->ppp, msg->msg.connect.holdoff); +} + +/** + * Call ppp_connect() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +err_t +pppapi_connect(ppp_pcb *pcb, u16_t holdoff) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + msg.msg.msg.connect.holdoff = holdoff; + return tcpip_api_call(pppapi_do_ppp_connect, &msg.call); +} + + +#if PPP_SERVER +/** + * Call ppp_listen() inside the tcpip_thread context. + */ +static void +pppapi_do_ppp_listen(struct pppapi_msg_msg *msg) +{ + msg->err = ppp_listen(msg->ppp, msg->msg.listen.addrs); + TCPIP_PPPAPI_ACK(msg); +} + +/** + * Call ppp_listen() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +err_t +pppapi_listen(ppp_pcb *pcb, struct ppp_addrs *addrs) +{ + struct pppapi_msg msg; + msg.function = pppapi_do_ppp_listen; + msg.msg.ppp = pcb; + msg.msg.msg.listen.addrs = addrs; + TCPIP_PPPAPI(&msg); + return msg.msg.err; +} +#endif /* PPP_SERVER */ + + +/** + * Call ppp_close() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_close(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + return ppp_close(msg->ppp, msg->msg.close.nocarrier); +} + +/** + * Call ppp_close() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +err_t +pppapi_close(ppp_pcb *pcb, u8_t nocarrier) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + msg.msg.msg.close.nocarrier = nocarrier; + return tcpip_api_call(pppapi_do_ppp_close, &msg.call); +} + + +/** + * Call ppp_free() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_free(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + return ppp_free(msg->ppp); +} + +/** + * Call ppp_free() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +err_t +pppapi_free(ppp_pcb *pcb) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + return tcpip_api_call(pppapi_do_ppp_free, &msg.call); +} + + +/** + * Call ppp_ioctl() inside the tcpip_thread context. + */ +static err_t +pppapi_do_ppp_ioctl(struct tcpip_api_call *m) +{ + struct pppapi_msg_msg *msg = (struct pppapi_msg_msg *)m; + + return ppp_ioctl(msg->ppp, msg->msg.ioctl.cmd, msg->msg.ioctl.arg); +} + +/** + * Call ppp_ioctl() in a thread-safe way by running that function inside the + * tcpip_thread context. + */ +err_t +pppapi_ioctl(ppp_pcb *pcb, u8_t cmd, void *arg) +{ + struct pppapi_msg msg; + msg.msg.ppp = pcb; + msg.msg.msg.ioctl.cmd = cmd; + msg.msg.msg.ioctl.arg = arg; + return tcpip_api_call(pppapi_do_ppp_ioctl, &msg.call); +} + +#endif /* LWIP_PPP_API */ diff --git a/components/lwip/api/sockets.c b/components/lwip/api/sockets.c new file mode 100755 index 000000000..ee1c9216b --- /dev/null +++ b/components/lwip/api/sockets.c @@ -0,0 +1,3263 @@ +/** + * @file + * Sockets BSD-Like API module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + * Improved by Marc Boucher and David Haas + * + */ + +#include "lwip/opt.h" + +#if LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/sockets.h" +#include "lwip/api.h" +#include "lwip/sys.h" +#include "lwip/igmp.h" +#include "lwip/inet.h" +#include "lwip/tcp.h" +#include "lwip/raw.h" +#include "lwip/udp.h" +#include "lwip/memp.h" +#include "lwip/pbuf.h" +#include "lwip/priv/tcpip_priv.h" +#include "lwip/priv/api_msg.h" +//#include "esp_common.h" +#if LWIP_CHECKSUM_ON_COPY +#include "lwip/inet_chksum.h" +#endif + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/* If the netconn API is not required publicly, then we include the necessary + files here to get the implementation */ +#if !LWIP_NETCONN +#undef LWIP_NETCONN +#define LWIP_NETCONN 1 +#include "api_msg.c" +#include "api_lib.c" +#include "netbuf.c" +#undef LWIP_NETCONN +#define LWIP_NETCONN 0 +#endif + +#if LWIP_IPV4 +#define IP4ADDR_PORT_TO_SOCKADDR(sin, ipaddr, port) do { \ + (sin)->sin_len = sizeof(struct sockaddr_in); \ + (sin)->sin_family = AF_INET; \ + (sin)->sin_port = htons((port)); \ + inet_addr_from_ipaddr(&(sin)->sin_addr, ipaddr); \ + memset((sin)->sin_zero, 0, SIN_ZERO_LEN); }while(0) +#define SOCKADDR4_TO_IP4ADDR_PORT(sin, ipaddr, port) do { \ + inet_addr_to_ipaddr(ip_2_ip4(ipaddr), &((sin)->sin_addr)); \ + (port) = ntohs((sin)->sin_port); }while(0) +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +#define IP6ADDR_PORT_TO_SOCKADDR(sin6, ipaddr, port) do { \ + (sin6)->sin6_len = sizeof(struct sockaddr_in6); \ + (sin6)->sin6_family = AF_INET6; \ + (sin6)->sin6_port = htons((port)); \ + (sin6)->sin6_flowinfo = 0; \ + inet6_addr_from_ip6addr(&(sin6)->sin6_addr, ipaddr); \ + (sin6)->sin6_scope_id = 0; }while(0) +#define SOCKADDR6_TO_IP6ADDR_PORT(sin6, ipaddr, port) do { \ + inet6_addr_to_ip6addr(ip_2_ip6(ipaddr), &((sin6)->sin6_addr)); \ + (port) = ntohs((sin6)->sin6_port); }while(0) +#endif /* LWIP_IPV6 */ + +#if LWIP_IPV4 && LWIP_IPV6 +static void sockaddr_to_ipaddr_port(const struct sockaddr* sockaddr, ip_addr_t* ipaddr, u16_t* port); + +#define IS_SOCK_ADDR_LEN_VALID(namelen) (((namelen) == sizeof(struct sockaddr_in)) || \ + ((namelen) == sizeof(struct sockaddr_in6))) +#define IS_SOCK_ADDR_TYPE_VALID(name) (((name)->sa_family == AF_INET) || \ + ((name)->sa_family == AF_INET6)) +#define SOCK_ADDR_TYPE_MATCH(name, sock) \ + ((((name)->sa_family == AF_INET) && !(NETCONNTYPE_ISIPV6((sock)->conn->type))) || \ + (((name)->sa_family == AF_INET6) && (NETCONNTYPE_ISIPV6((sock)->conn->type)))) +#define IPADDR_PORT_TO_SOCKADDR(sockaddr, ipaddr, port) do { \ + if (IP_IS_V6(ipaddr)) { \ + IP6ADDR_PORT_TO_SOCKADDR((struct sockaddr_in6*)(void*)(sockaddr), ip_2_ip6(ipaddr), port); \ + } else { \ + IP4ADDR_PORT_TO_SOCKADDR((struct sockaddr_in*)(void*)(sockaddr), ip_2_ip4(ipaddr), port); \ + } } while(0) +#define SOCKADDR_TO_IPADDR_PORT(sockaddr, ipaddr, port) sockaddr_to_ipaddr_port(sockaddr, ipaddr, &(port)) +#define DOMAIN_TO_NETCONN_TYPE(domain, type) (((domain) == AF_INET) ? \ + (type) : (enum netconn_type)((type) | NETCONN_TYPE_IPV6)) +#elif LWIP_IPV6 /* LWIP_IPV4 && LWIP_IPV6 */ +#define IS_SOCK_ADDR_LEN_VALID(namelen) ((namelen) == sizeof(struct sockaddr_in6)) +#define IS_SOCK_ADDR_TYPE_VALID(name) ((name)->sa_family == AF_INET6) +#define SOCK_ADDR_TYPE_MATCH(name, sock) 1 +#define IPADDR_PORT_TO_SOCKADDR(sockaddr, ipaddr, port) \ + IP6ADDR_PORT_TO_SOCKADDR((struct sockaddr_in6*)(void*)(sockaddr), ip_2_ip6(ipaddr), port) +#define SOCKADDR_TO_IPADDR_PORT(sockaddr, ipaddr, port) \ + SOCKADDR6_TO_IP6ADDR_PORT((const struct sockaddr_in6*)(const void*)(sockaddr), ipaddr, port) +#define DOMAIN_TO_NETCONN_TYPE(domain, netconn_type) (netconn_type) +#else /*-> LWIP_IPV4: LWIP_IPV4 && LWIP_IPV6 */ +#define IS_SOCK_ADDR_LEN_VALID(namelen) ((namelen) == sizeof(struct sockaddr_in)) +#define IS_SOCK_ADDR_TYPE_VALID(name) ((name)->sa_family == AF_INET) +#define SOCK_ADDR_TYPE_MATCH(name, sock) 1 +#define IPADDR_PORT_TO_SOCKADDR(sockaddr, ipaddr, port) \ + IP4ADDR_PORT_TO_SOCKADDR((struct sockaddr_in*)(void*)(sockaddr), ip_2_ip4(ipaddr), port) +#define SOCKADDR_TO_IPADDR_PORT(sockaddr, ipaddr, port) \ + SOCKADDR4_TO_IP4ADDR_PORT((const struct sockaddr_in*)(const void*)(sockaddr), ipaddr, port) +#define DOMAIN_TO_NETCONN_TYPE(domain, netconn_type) (netconn_type) +#endif /* LWIP_IPV6 */ + +#define IS_SOCK_ADDR_TYPE_VALID_OR_UNSPEC(name) (((name)->sa_family == AF_UNSPEC) || \ + IS_SOCK_ADDR_TYPE_VALID(name)) +#define SOCK_ADDR_TYPE_MATCH_OR_UNSPEC(name, sock) (((name)->sa_family == AF_UNSPEC) || \ + SOCK_ADDR_TYPE_MATCH(name, sock)) +#define IS_SOCK_ADDR_ALIGNED(name) ((((mem_ptr_t)(name)) % 4) == 0) + + +#define LWIP_SOCKOPT_CHECK_OPTLEN(optlen, opttype) do { if ((optlen) < sizeof(opttype)) { return EINVAL; }}while(0) +#define LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, optlen, opttype) do { \ + LWIP_SOCKOPT_CHECK_OPTLEN(optlen, opttype); \ + if ((sock)->conn == NULL) { return EINVAL; } }while(0) +#define LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, opttype) do { \ + LWIP_SOCKOPT_CHECK_OPTLEN(optlen, opttype); \ + if (((sock)->conn == NULL) || ((sock)->conn->pcb.tcp == NULL)) { return EINVAL; } }while(0) +#define LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, opttype, netconntype) do { \ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, opttype); \ + if (NETCONNTYPE_GROUP(netconn_type((sock)->conn)) != netconntype) { return ENOPROTOOPT; } }while(0) + + +#define LWIP_SETGETSOCKOPT_DATA_VAR_REF(name) API_VAR_REF(name) +#define LWIP_SETGETSOCKOPT_DATA_VAR_DECLARE(name) API_VAR_DECLARE(struct lwip_setgetsockopt_data, name) +#define LWIP_SETGETSOCKOPT_DATA_VAR_FREE(name) API_VAR_FREE(MEMP_SOCKET_SETGETSOCKOPT_DATA, name) +#if LWIP_MPU_COMPATIBLE +#define LWIP_SETGETSOCKOPT_DATA_VAR_ALLOC(name, sock) do { \ + name = (struct lwip_setgetsockopt_data *)memp_malloc(MEMP_SOCKET_SETGETSOCKOPT_DATA); \ + if (name == NULL) { \ + sock_set_errno(sock, ENOMEM); \ + return -1; \ + } }while(0) +#else /* LWIP_MPU_COMPATIBLE */ +#define LWIP_SETGETSOCKOPT_DATA_VAR_ALLOC(name, sock) +#endif /* LWIP_MPU_COMPATIBLE */ + +#if LWIP_SO_SNDRCVTIMEO_NONSTANDARD +#define LWIP_SO_SNDRCVTIMEO_OPTTYPE int +#define LWIP_SO_SNDRCVTIMEO_SET(optval, val) (*(int *)(optval) = (val)) +#define LWIP_SO_SNDRCVTIMEO_GET_MS(optval) ((s32_t)*(const int*)(optval)) +#else +#define LWIP_SO_SNDRCVTIMEO_OPTTYPE struct timeval +#define LWIP_SO_SNDRCVTIMEO_SET(optval, val) do { \ + s32_t loc = (val); \ + ((struct timeval *)(optval))->tv_sec = (loc) / 1000U; \ + ((struct timeval *)(optval))->tv_usec = ((loc) % 1000U) * 1000U; }while(0) +#define LWIP_SO_SNDRCVTIMEO_GET_MS(optval) ((((const struct timeval *)(optval))->tv_sec * 1000U) + (((const struct timeval *)(optval))->tv_usec / 1000U)) +#endif + +#define NUM_SOCKETS MEMP_NUM_NETCONN + +/** This is overridable for the rare case where more than 255 threads + * select on the same socket... + */ +#ifndef SELWAIT_T +#define SELWAIT_T u8_t +#endif + +/** Contains all internal pointers and states used for a socket */ +struct lwip_sock { + /** sockets currently are built on netconns, each socket has one netconn */ + struct netconn *conn; + /** data that was left from the previous read */ + void *lastdata; + /** offset in the data that was left from the previous read */ + u16_t lastoffset; + /** number of times data was received, set by event_callback(), + tested by the receive and select functions */ + s16_t rcvevent; + /** number of times data was ACKed (free send buffer), set by event_callback(), + tested by select */ + u16_t sendevent; + /** error happened for this socket, set by event_callback(), tested by select */ + u16_t errevent; + /** last error that occurred on this socket (in fact, all our errnos fit into an u8_t) */ + u8_t err; + +#if LWIP_THREAD_SAFE + /* lock is used to protect state/ref field, however this lock is not a perfect lock, e.g + * taskA and taskB can access sock X, then taskA freed sock X, before taskB detect + * this, taskC reuse sock X, then when taskB try to access sock X, problem may happen. + * A mitigation solution may be, when allocate a socket, alloc the least frequently used + * socket. + */ + sys_mutex_t lock; + + /* can be LWIP_SOCK_OPEN/LWIP_SOCK_CLOSING/LWIP_SOCK_CLOSED */ + u8_t state; + + /* if ref is 0, the sock need/can to be freed */ + s8_t ref; + + /* indicate how long the sock is in LWIP_SOCK_CLOSED status */ + u8_t age; +#endif + + /** counter of how many threads are waiting for this socket using select */ + SELWAIT_T select_waiting; +}; + +#if LWIP_THREAD_SAFE + +#define LWIP_SOCK_OPEN 0 +#define LWIP_SOCK_CLOSING 1 +#define LWIP_SOCK_CLOSED 2 + +#define LWIP_SOCK_LOCK(sock) \ +do{\ + /*LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("l\n"));*/\ + sys_mutex_lock(&sock->lock);\ + /*LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("l ok\n"));*/\ +}while(0) + + +#define LWIP_SOCK_UNLOCK(sock) \ +do{\ + sys_mutex_unlock(&sock->lock);\ + /*LWIP_DEBUGF(THREAD_SAFE_DEBUG1, ("unl\n"));*/\ +}while(0) + +#define LWIP_FREE_SOCK(sock) \ +do{\ + if(sock->conn && NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP){\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("LWIP_FREE_SOCK:free tcp sock\n"));\ + free_socket(sock, 1);\ + } else {\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("LWIP_FREE_SOCK:free non-tcp sock\n"));\ + free_socket(sock, 0);\ + }\ +}while(0) + +#define LWIP_SET_CLOSE_FLAG() \ +do{\ + LWIP_SOCK_LOCK(__sock);\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("mark sock closing\n"));\ + __sock->state = LWIP_SOCK_CLOSING;\ + LWIP_SOCK_UNLOCK(__sock);\ +}while(0) + +#define LWIP_API_LOCK() \ + struct lwip_sock *__sock;\ + int __ret;\ +\ + __sock = get_socket(s);\ + if (!__sock) {\ + return -1;\ + }\ +\ +do{\ + LWIP_SOCK_LOCK(__sock);\ + __sock->ref ++;\ + if (__sock->state != LWIP_SOCK_OPEN) {\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("LWIP_API_LOCK:soc is %d, return\n", __sock->state));\ + __sock->ref --;\ + LWIP_SOCK_UNLOCK(__sock);\ + return -1;\ + }\ +\ + LWIP_SOCK_UNLOCK(__sock);\ +}while(0) + +#define LWIP_API_UNLOCK() \ +do{\ + LWIP_SOCK_LOCK(__sock);\ + __sock->ref --;\ + if (__sock->state == LWIP_SOCK_CLOSING) {\ + if (__sock->ref == 0){\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("LWIP_API_UNLOCK:ref 0, free __sock\n"));\ + LWIP_FREE_SOCK(__sock);\ + LWIP_SOCK_UNLOCK(__sock);\ + return __ret;\ + }\ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("LWIP_API_UNLOCK: soc state is closing, return\n"));\ + LWIP_SOCK_UNLOCK(__sock);\ + return __ret;\ + }\ +\ + LWIP_SOCK_UNLOCK(__sock);\ + return __ret;\ +}while(0) + +#endif + + + +#if LWIP_NETCONN_SEM_PER_THREAD +#define SELECT_SEM_T sys_sem_t* +#define SELECT_SEM_PTR(sem) (sem) +#else /* LWIP_NETCONN_SEM_PER_THREAD */ +#define SELECT_SEM_T sys_sem_t +#define SELECT_SEM_PTR(sem) (&(sem)) +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + +/** Description for a task waiting in select */ +struct lwip_select_cb { + /** Pointer to the next waiting task */ + struct lwip_select_cb *next; + /** Pointer to the previous waiting task */ + struct lwip_select_cb *prev; + /** readset passed to select */ + fd_set *readset; + /** writeset passed to select */ + fd_set *writeset; + /** unimplemented: exceptset passed to select */ + fd_set *exceptset; + /** don't signal the same semaphore twice: set to 1 when signalled */ + int sem_signalled; + /** semaphore to wake up a task waiting for select */ + SELECT_SEM_T sem; +}; + +/** A struct sockaddr replacement that has the same alignment as sockaddr_in/ + * sockaddr_in6 if instantiated. + */ +union sockaddr_aligned { + struct sockaddr sa; +#if LWIP_IPV6 + struct sockaddr_in6 sin6; +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 + struct sockaddr_in sin; +#endif /* LWIP_IPV4 */ +}; + +#if LWIP_IGMP +/* Define the number of IPv4 multicast memberships, default is one per socket */ +#ifndef LWIP_SOCKET_MAX_MEMBERSHIPS +#define LWIP_SOCKET_MAX_MEMBERSHIPS NUM_SOCKETS +#endif + +/* This is to keep track of IP_ADD_MEMBERSHIP calls to drop the membership when + a socket is closed */ +struct lwip_socket_multicast_pair { + /** the socket (+1 to not require initialization) */ + int sa; + /** the interface address */ + ip4_addr_t if_addr; + /** the group address */ + ip4_addr_t multi_addr; +}; + +struct lwip_socket_multicast_pair socket_ipv4_multicast_memberships[LWIP_SOCKET_MAX_MEMBERSHIPS]; + +static int lwip_socket_register_membership(int s, const ip4_addr_t *if_addr, const ip4_addr_t *multi_addr); +static void lwip_socket_unregister_membership(int s, const ip4_addr_t *if_addr, const ip4_addr_t *multi_addr); +static void lwip_socket_drop_registered_memberships(int s); +#endif /* LWIP_IGMP */ + +#ifdef LWIP_ESP8266 +extern size_t system_get_free_heap_size(void); + +#define DELAY_WHEN_MEMORY_NOT_ENOUGH() \ +do{\ + uint8_t _wait_delay = 0;\ + while (system_get_free_heap_size() < HEAP_HIGHWAT){\ + vTaskDelay(_wait_delay/portTICK_RATE_MS);\ + if (_wait_delay < 64) _wait_delay *= 2;\ + }\ +}while(0) + +#else +#define DELAY_WHEN_MEMORY_NOT_ENOUGH() +#endif + +/** The global array of available sockets */ +static struct lwip_sock sockets[NUM_SOCKETS]; +#ifdef LWIP_THREAD_SAFE +static bool sockets_init_flag = false; +#endif +/** The global list of tasks waiting for select */ +static struct lwip_select_cb *select_cb_list; +/** This counter is increased from lwip_select when the list is changed + and checked in event_callback to see if it has changed. */ +static volatile int select_cb_ctr; + +/** Table to quickly map an lwIP error (err_t) to a socket error + * by using -err as an index */ +#ifdef LWIP_ESP8266 +//TO_DO +//static const int err_to_errno_table[] ICACHE_RODATA_ATTR STORE_ATTR = { +static const int err_to_errno_table[] = { +#else +static const int err_to_errno_table[] = { +#endif + 0, /* ERR_OK 0 No error, everything OK. */ + ENOMEM, /* ERR_MEM -1 Out of memory error. */ + ENOBUFS, /* ERR_BUF -2 Buffer error. */ + EWOULDBLOCK, /* ERR_TIMEOUT -3 Timeout */ + EHOSTUNREACH, /* ERR_RTE -4 Routing problem. */ + EINPROGRESS, /* ERR_INPROGRESS -5 Operation in progress */ + EINVAL, /* ERR_VAL -6 Illegal value. */ + EWOULDBLOCK, /* ERR_WOULDBLOCK -7 Operation would block. */ + EADDRINUSE, /* ERR_USE -8 Address in use. */ + +#ifdef LWIP_ESP8266 + EALREADY, /* ERR_ALREADY -9 Already connected. */ + EISCONN, /* ERR_ISCONN -10 Conn already established */ + ECONNABORTED, /* ERR_ABRT -11 Connection aborted. */ + ECONNRESET, /* ERR_RST -12 Connection reset. */ + ENOTCONN, /* ERR_CLSD -13 Connection closed. */ + ENOTCONN, /* ERR_CONN -14 Not connected. */ + EIO, /* ERR_ARG -15 Illegal argument. */ + -1, /* ERR_IF -16 Low-level netif error */ +#else + EALREADY, /* ERR_ALREADY -9 Already connecting. */ + EISCONN, /* ERR_ISCONN -10 Conn already established.*/ + ENOTCONN, /* ERR_CONN -11 Not connected. */ + -1, /* ERR_IF -12 Low-level netif error */ + ECONNABORTED, /* ERR_ABRT -13 Connection aborted. */ + ECONNRESET, /* ERR_RST -14 Connection reset. */ + ENOTCONN, /* ERR_CLSD -15 Connection closed. */ + EIO /* ERR_ARG -16 Illegal argument. */ +#endif +}; + +#define ERR_TO_ERRNO_TABLE_SIZE LWIP_ARRAYSIZE(err_to_errno_table) + +#define err_to_errno(err) \ + ((unsigned)(-(signed)(err)) < ERR_TO_ERRNO_TABLE_SIZE ? \ + err_to_errno_table[-(signed)(err)] : EIO) + +#if LWIP_SOCKET_SET_ERRNO +#ifndef set_errno +#define set_errno(err) do { if (err) { errno = (err); } } while(0) +#endif +#else /* LWIP_SOCKET_SET_ERRNO */ +#define set_errno(err) +#endif /* LWIP_SOCKET_SET_ERRNO */ + +#define sock_set_errno(sk, e) do { \ + const int sockerr = (e); \ + sk->err = (u8_t)sockerr; \ + set_errno(sockerr); \ +} while (0) + +/* Forward declaration of some functions */ +static void event_callback(struct netconn *conn, enum netconn_evt evt, u16_t len); +#if !LWIP_TCPIP_CORE_LOCKING +static void lwip_getsockopt_callback(void *arg); +static void lwip_setsockopt_callback(void *arg); +#endif +static u8_t lwip_getsockopt_impl(int s, int level, int optname, void *optval, socklen_t *optlen); +static u8_t lwip_setsockopt_impl(int s, int level, int optname, const void *optval, socklen_t optlen); + +#if LWIP_IPV4 && LWIP_IPV6 +static void +sockaddr_to_ipaddr_port(const struct sockaddr* sockaddr, ip_addr_t* ipaddr, u16_t* port) +{ + if ((sockaddr->sa_family) == AF_INET6) { + SOCKADDR6_TO_IP6ADDR_PORT((const struct sockaddr_in6*)(const void*)(sockaddr), ipaddr, *port); + ipaddr->type = IPADDR_TYPE_V6; + } else { + SOCKADDR4_TO_IP4ADDR_PORT((const struct sockaddr_in*)(const void*)(sockaddr), ipaddr, *port); + ipaddr->type = IPADDR_TYPE_V4; + } +} +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +/** LWIP_NETCONN_SEM_PER_THREAD==1: initialize thread-local semaphore */ +void +lwip_socket_thread_init(void) +{ + netconn_thread_init(); +} + +/** LWIP_NETCONN_SEM_PER_THREAD==1: destroy thread-local semaphore */ +void +lwip_socket_thread_cleanup(void) +{ + netconn_thread_cleanup(); +} + +/** + * Map a externally used socket index to the internal socket representation. + * + * @param s externally used socket index + * @return struct lwip_sock for the socket or NULL if not found + */ +static struct lwip_sock * +get_socket(int s) +{ + struct lwip_sock *sock; + + s -= LWIP_SOCKET_OFFSET; + + if ((s < 0) || (s >= NUM_SOCKETS)) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("get_socket(%d): invalid\n", s + LWIP_SOCKET_OFFSET)); + set_errno(EBADF); + return NULL; + } + + sock = &sockets[s]; + + if (!sock->conn) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("get_socket(%d): not active\n", s + LWIP_SOCKET_OFFSET)); + set_errno(EBADF); + return NULL; + } + + return sock; +} + +/** + * Same as get_socket but doesn't set errno + * + * @param s externally used socket index + * @return struct lwip_sock for the socket or NULL if not found + */ +static struct lwip_sock * +tryget_socket(int s) +{ + s -= LWIP_SOCKET_OFFSET; + if ((s < 0) || (s >= NUM_SOCKETS)) { + return NULL; + } + if (!sockets[s].conn) { + return NULL; + } + return &sockets[s]; +} + +/** + * Allocate a new socket for a given netconn. + * + * @param newconn the netconn for which to allocate a socket + * @param accepted 1 if socket has been created by accept(), + * 0 if socket has been created by socket() + * @return the index of the new socket; -1 on error + */ +static int +alloc_socket(struct netconn *newconn, int accepted) +{ + int i; + SYS_ARCH_DECL_PROTECT(lev); + +#if LWIP_THREAD_SAFE + bool found = false; + int oldest = -1; + + SYS_ARCH_PROTECT(lev); + + if (sockets_init_flag == false){ + sockets_init_flag = true; + memset(sockets, 0, sizeof(sockets)); + } + + for (i = 0; i < NUM_SOCKETS; ++i) { + sockets[i].age ++; + + if (found == true){ + continue; + } + + if (!sockets[i].conn && (sockets[i].state == LWIP_SOCK_OPEN)) { + found = true; + oldest = i; + continue; + } + + if (!sockets[i].conn){ + if (oldest == -1 || sockets[i].age > sockets[oldest].age){ + oldest = i; + } + } + } + + if ((oldest != -1) && !sockets[oldest].conn) { + found = true; + sockets[oldest].conn = newconn; + } + + SYS_ARCH_UNPROTECT(lev); + + if (found == true) { + sockets[oldest].lastdata = NULL; + sockets[oldest].lastoffset = 0; + sockets[oldest].rcvevent = 0; + + /* TCP sendbuf is empty, but the socket is not yet writable until connected + * (unless it has been created by accept()). */ + sockets[oldest].sendevent = (NETCONNTYPE_GROUP(newconn->type) == NETCONN_TCP ? (accepted != 0) : 1); + sockets[oldest].errevent = 0; + sockets[oldest].err = 0; + sockets[oldest].select_waiting = 0; + + sockets[oldest].state = LWIP_SOCK_OPEN; + sockets[oldest].age = 0; + sockets[oldest].ref = 0; + if (!sockets[oldest].lock){ + /* one time init and never free */ + if (sys_mutex_new(&sockets[oldest].lock) != ERR_OK){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("new sock lock fail\n")); + return -1; + } + } + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("alloc_socket: alloc %d ok\n", oldest)); + + return oldest + LWIP_SOCKET_OFFSET; + } + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("alloc_socket: failed\n")); + +#else + + /* allocate a new socket identifier */ + for (i = 0; i < NUM_SOCKETS; ++i) { + /* Protect socket array */ + SYS_ARCH_PROTECT(lev); + if (!sockets[i].conn) { + sockets[i].conn = newconn; + /* The socket is not yet known to anyone, so no need to protect + after having marked it as used. */ + SYS_ARCH_UNPROTECT(lev); + sockets[i].lastdata = NULL; + sockets[i].lastoffset = 0; + sockets[i].rcvevent = 0; + /* TCP sendbuf is empty, but the socket is not yet writable until connected + * (unless it has been created by accept()). */ + sockets[i].sendevent = (NETCONNTYPE_GROUP(newconn->type) == NETCONN_TCP ? (accepted != 0) : 1); + sockets[i].errevent = 0; + sockets[i].err = 0; + sockets[i].select_waiting = 0; + + return i + LWIP_SOCKET_OFFSET; + } + SYS_ARCH_UNPROTECT(lev); + } + +#endif + + return -1; +} + +/** Free a socket. The socket's netconn must have been + * delete before! + * + * @param sock the socket to free + * @param is_tcp != 0 for TCP sockets, used to free lastdata + */ +static void +free_socket(struct lwip_sock *sock, int is_tcp) +{ + void *lastdata; + SYS_ARCH_DECL_PROTECT(lev); + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("free_sockset:free socket s=%p is_tcp=%d\n", sock, is_tcp)); + lastdata = sock->lastdata; + sock->lastdata = NULL; + sock->lastoffset = 0; + sock->err = 0; +#if LWIP_THREAD_SAFE + if (sock->conn){ + netconn_free(sock->conn); + } + + SYS_ARCH_PROTECT(lev); + sock->age = 0; + sock->conn = NULL; + sock->state = LWIP_SOCK_CLOSED; + SYS_ARCH_UNPROTECT(lev); +#endif + + /* Protect socket array */ + SYS_ARCH_SET(sock->conn, NULL); + /* don't use 'sock' after this line, as another task might have allocated it */ + + if (lastdata != NULL) { + if (is_tcp) { + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("free_sockset:free lastdata pbuf=%p\n", lastdata)); + pbuf_free((struct pbuf *)lastdata); + } else { + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("free_sockset:free lastdata, netbuf=%p\n", lastdata)); + netbuf_delete((struct netbuf *)lastdata); + } + } +} + +/* Below this, the well-known socket functions are implemented. + * Use google.com or opengroup.org to get a good description :-) + * + * Exceptions are documented! + */ + +int +lwip_accept(int s, struct sockaddr *addr, socklen_t *addrlen) +{ + struct lwip_sock *sock, *nsock; + struct netconn *newconn; + ip_addr_t naddr; + u16_t port = 0; + int newsock; + err_t err; + SYS_ARCH_DECL_PROTECT(lev); + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d)...\n", s)); + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (netconn_is_nonblocking(sock->conn) && (sock->rcvevent <= 0)) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d): returning EWOULDBLOCK\n", s)); + sock_set_errno(sock, EWOULDBLOCK); + return -1; + } + + /* wait for a new connection */ + err = netconn_accept(sock->conn, &newconn); + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d): netconn_acept failed, err=%d\n", s, err)); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + sock_set_errno(sock, EOPNOTSUPP); + return EOPNOTSUPP; + } + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + LWIP_ASSERT("newconn != NULL", newconn != NULL); + /* Prevent automatic window updates, we do this on our own! */ + netconn_set_noautorecved(newconn, 1); + + newsock = alloc_socket(newconn, 1); + if (newsock == -1) { + netconn_delete(newconn); + sock_set_errno(sock, ENFILE); + return -1; + } + LWIP_ASSERT("invalid socket index", (newsock >= LWIP_SOCKET_OFFSET) && (newsock < NUM_SOCKETS + LWIP_SOCKET_OFFSET)); + LWIP_ASSERT("newconn->callback == event_callback", newconn->callback == event_callback); + nsock = &sockets[newsock - LWIP_SOCKET_OFFSET]; + + /* See event_callback: If data comes in right away after an accept, even + * though the server task might not have created a new socket yet. + * In that case, newconn->socket is counted down (newconn->socket--), + * so nsock->rcvevent is >= 1 here! + */ + SYS_ARCH_PROTECT(lev); + nsock->rcvevent += (s16_t)(-1 - newconn->socket); + newconn->socket = newsock; + SYS_ARCH_UNPROTECT(lev); + + /* Note that POSIX only requires us to check addr is non-NULL. addrlen must + * not be NULL if addr is valid. + */ + if (addr != NULL) { + union sockaddr_aligned tempaddr; + /* get the IP address and port of the remote host */ + err = netconn_peer(newconn, &naddr, &port); + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d): netconn_peer failed, err=%d\n", s, err)); + netconn_delete(newconn); + free_socket(nsock, 1); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + LWIP_ASSERT("addr valid but addrlen NULL", addrlen != NULL); + + IPADDR_PORT_TO_SOCKADDR(&tempaddr, &naddr, port); + if (*addrlen > tempaddr.sa.sa_len) { + *addrlen = tempaddr.sa.sa_len; + } + MEMCPY(addr, &tempaddr, *addrlen); + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d) returning new sock=%d addr=", s, newsock)); + ip_addr_debug_print_val(SOCKETS_DEBUG, naddr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F"\n", port)); + } else { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d) returning new sock=%d", s, newsock)); + } + + sock_set_errno(sock, 0); + return newsock; +} + +int +lwip_bind(int s, const struct sockaddr *name, socklen_t namelen) +{ + struct lwip_sock *sock; + ip_addr_t local_addr; + u16_t local_port; + err_t err; + + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (!SOCK_ADDR_TYPE_MATCH(name, sock)) { + /* sockaddr does not match socket type (IPv4/IPv6) */ + sock_set_errno(sock, err_to_errno(ERR_VAL)); + return -1; + } + + /* check size, family and alignment of 'name' */ + LWIP_ERROR("lwip_bind: invalid address", (IS_SOCK_ADDR_LEN_VALID(namelen) && + IS_SOCK_ADDR_TYPE_VALID(name) && IS_SOCK_ADDR_ALIGNED(name)), + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + LWIP_UNUSED_ARG(namelen); + + SOCKADDR_TO_IPADDR_PORT(name, &local_addr, local_port); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_bind(%d, addr=", s)); + ip_addr_debug_print_val(SOCKETS_DEBUG, local_addr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", local_port)); + + err = netconn_bind(sock->conn, &local_addr, local_port); + + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_bind(%d) failed, err=%d\n", s, err)); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_bind(%d) succeeded\n", s)); + sock_set_errno(sock, 0); + return 0; +} + +int +lwip_close(int s) +{ + struct lwip_sock *sock; + int is_tcp = 0; + err_t err; + + LWIP_DEBUGF(SOCKETS_DEBUG|THREAD_SAFE_DEBUG, ("lwip_close: (%d)\n", s)); + + sock = get_socket(s); + if (!sock) { + LWIP_DEBUGF(SOCKETS_DEBUG|THREAD_SAFE_DEBUG, ("lwip_close: sock is null, return -1\n")); + return -1; + } + + if (sock->conn != NULL) { + is_tcp = NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP; + LWIP_DEBUGF(SOCKETS_DEBUG|THREAD_SAFE_DEBUG, ("lwip_close: is_tcp=%d\n", is_tcp)); + } else { + LWIP_DEBUGF(SOCKETS_DEBUG|THREAD_SAFE_DEBUG, ("conn is null\n")); + LWIP_ASSERT("lwip_close: sock->lastdata == NULL", sock->lastdata == NULL); + } + +#if LWIP_IGMP + /* drop all possibly joined IGMP memberships */ + lwip_socket_drop_registered_memberships(s); +#endif /* LWIP_IGMP */ + + err = netconn_delete(sock->conn); + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG|THREAD_SAFE_DEBUG, ("netconn_delete fail, ret=%d\n", err)); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + +#if !LWIP_THREAD_SAFE + free_socket(sock, is_tcp); +#endif + + set_errno(0); + return 0; +} + +int +lwip_connect(int s, const struct sockaddr *name, socklen_t namelen) +{ + struct lwip_sock *sock; + err_t err; + + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (!SOCK_ADDR_TYPE_MATCH_OR_UNSPEC(name, sock)) { + /* sockaddr does not match socket type (IPv4/IPv6) */ + sock_set_errno(sock, err_to_errno(ERR_VAL)); + return -1; + } + + LWIP_UNUSED_ARG(namelen); + if (name->sa_family == AF_UNSPEC) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_connect(%d, AF_UNSPEC)\n", s)); + err = netconn_disconnect(sock->conn); + } else { + ip_addr_t remote_addr; + u16_t remote_port; + + /* check size, family and alignment of 'name' */ + LWIP_ERROR("lwip_connect: invalid address", IS_SOCK_ADDR_LEN_VALID(namelen) && + IS_SOCK_ADDR_TYPE_VALID_OR_UNSPEC(name) && IS_SOCK_ADDR_ALIGNED(name), + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + + SOCKADDR_TO_IPADDR_PORT(name, &remote_addr, remote_port); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_connect(%d, addr=", s)); + ip_addr_debug_print_val(SOCKETS_DEBUG, remote_addr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", remote_port)); + + err = netconn_connect(sock->conn, &remote_addr, remote_port); + } + + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_connect(%d) failed, err=%d\n", s, err)); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_connect(%d) succeeded\n", s)); + sock_set_errno(sock, 0); + return 0; +} + +/** + * Set a socket into listen mode. + * The socket may not have been used for another connection previously. + * + * @param s the socket to set to listening mode + * @param backlog (ATTENTION: needs TCP_LISTEN_BACKLOG=1) + * @return 0 on success, non-zero on failure + */ +int +lwip_listen(int s, int backlog) +{ + struct lwip_sock *sock; + err_t err; + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_listen(%d, backlog=%d)\n", s, backlog)); + + sock = get_socket(s); + if (!sock) { + return -1; + } + + /* limit the "backlog" parameter to fit in an u8_t */ + backlog = LWIP_MIN(LWIP_MAX(backlog, 0), 0xff); + + err = netconn_listen_with_backlog(sock->conn, (u8_t)backlog); + + if (err != ERR_OK) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_listen(%d) failed, err=%d\n", s, err)); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + sock_set_errno(sock, EOPNOTSUPP); + return -1; + } + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + + sock_set_errno(sock, 0); + return 0; +} + +int +lwip_recvfrom(int s, void *mem, size_t len, int flags, + struct sockaddr *from, socklen_t *fromlen) +{ + struct lwip_sock *sock; + void *buf = NULL; + struct pbuf *p; + u16_t buflen, copylen; + int off = 0; + u8_t done = 0; + err_t err; + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d, %p, %"SZT_F", 0x%x, ..)\n", s, mem, len, flags)); + sock = get_socket(s); + if (!sock) { + return -1; + } + + do { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom: top while sock->lastdata=%p\n", sock->lastdata)); + /* Check if there is data left from the last recv operation. */ + if (sock->lastdata) { + buf = sock->lastdata; + } else { + /* If this is non-blocking call, then check first */ + if (((flags & MSG_DONTWAIT) || netconn_is_nonblocking(sock->conn)) && + (sock->rcvevent <= 0)) { + if (off > 0) { + /* update receive window */ + netconn_recved(sock->conn, (u32_t)off); + /* already received data, return that */ + sock_set_errno(sock, 0); + return off; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d): returning EWOULDBLOCK\n", s)); + sock_set_errno(sock, EWOULDBLOCK); + return -1; + } + + /* No data was left from the previous operation, so we try to get + some from the network. */ + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { + err = netconn_recv_tcp_pbuf(sock->conn, (struct pbuf **)&buf); + } else { + err = netconn_recv(sock->conn, (struct netbuf **)&buf); + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom: netconn_recv err=%d, netbuf=%p\n", + err, buf)); + + if (err != ERR_OK) { + if (off > 0) { + /* update receive window */ + netconn_recved(sock->conn, (u32_t)off); + if (err == ERR_CLSD) { + /* closed but already received data, ensure select gets the FIN, too */ + event_callback(sock->conn, NETCONN_EVT_RCVPLUS, 0); + } + /* already received data, return that */ + sock_set_errno(sock, 0); + return off; + } + /* We should really do some error checking here. */ + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d): buf == NULL, error is \"%s\"!\n", + s, lwip_strerr(err))); + sock_set_errno(sock, err_to_errno(err)); + if (err == ERR_CLSD) { + return 0; + } else { + return -1; + } + } + LWIP_ASSERT("buf != NULL", buf != NULL); + sock->lastdata = buf; + } + + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { + p = (struct pbuf *)buf; + } else { + p = ((struct netbuf *)buf)->p; + } + buflen = p->tot_len; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom: buflen=%"U16_F" len=%"SZT_F" off=%d sock->lastoffset=%"U16_F"\n", + buflen, len, off, sock->lastoffset)); + + buflen -= sock->lastoffset; + + if (len > buflen) { + copylen = buflen; + } else { + copylen = (u16_t)len; + } + + /* copy the contents of the received buffer into + the supplied memory pointer mem */ + pbuf_copy_partial(p, (u8_t*)mem + off, copylen, sock->lastoffset); + + off += copylen; + + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { + LWIP_ASSERT("invalid copylen, len would underflow", len >= copylen); + len -= copylen; + if ((len <= 0) || + (p->flags & PBUF_FLAG_PUSH) || + (sock->rcvevent <= 0) || + ((flags & MSG_PEEK) != 0)) { + done = 1; + } + } else { + done = 1; + } + + /* Check to see from where the data was.*/ + if (done) { +#if !SOCKETS_DEBUG + if (from && fromlen) +#endif /* !SOCKETS_DEBUG */ + { + u16_t port; + ip_addr_t tmpaddr; + ip_addr_t *fromaddr; + union sockaddr_aligned saddr; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d): addr=", s)); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { + fromaddr = &tmpaddr; + netconn_getaddr(sock->conn, fromaddr, &port, 0); + } else { + port = netbuf_fromport((struct netbuf *)buf); + fromaddr = netbuf_fromaddr((struct netbuf *)buf); + } + IPADDR_PORT_TO_SOCKADDR(&saddr, fromaddr, port); + ip_addr_debug_print(SOCKETS_DEBUG, fromaddr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F" len=%d\n", port, off)); + +#ifdef LWIP_ESP8266 + if (from && fromlen) +#else + +#if SOCKETS_DEBUG + if (from && fromlen) +#endif /* SOCKETS_DEBUG */ + +#endif + { + if (*fromlen > saddr.sa.sa_len) { + *fromlen = saddr.sa.sa_len; + } + MEMCPY(from, &saddr, *fromlen); + +#ifdef LWIP_ESP8266 + } else { + /*fix the code for setting the UDP PROTO's remote infomation by liuh at 2014.8.27*/ + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_UDP){ + sock->conn->pcb.udp->remote_ip.u_addr.ip4.addr = fromaddr->u_addr.ip4.addr; + sock->conn->pcb.udp->remote_port = port; + } +#endif + + } + } + } + + /* If we don't peek the incoming message... */ + if ((flags & MSG_PEEK) == 0) { + /* If this is a TCP socket, check if there is data left in the + buffer. If so, it should be saved in the sock structure for next + time around. */ + if ((NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) && (buflen - copylen > 0)) { + sock->lastdata = buf; + sock->lastoffset += copylen; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom: lastdata now netbuf=%p\n", buf)); + } else { + sock->lastdata = NULL; + sock->lastoffset = 0; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom: deleting netbuf=%p\n", buf)); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { + pbuf_free((struct pbuf *)buf); + } else { + netbuf_delete((struct netbuf *)buf); + } + buf = NULL; + } + } + } while (!done); + + if ((off > 0) && (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) && + ((flags & MSG_PEEK) == 0)) { + /* update receive window */ + netconn_recved(sock->conn, (u32_t)off); + } + sock_set_errno(sock, 0); + return off; +} + + +int +lwip_read(int s, void *mem, size_t len) +{ + return lwip_recvfrom(s, mem, len, 0, NULL, NULL); +} + +int +lwip_recv(int s, void *mem, size_t len, int flags) +{ + return lwip_recvfrom(s, mem, len, flags, NULL, NULL); +} + +int +lwip_send(int s, const void *data, size_t size, int flags) +{ + struct lwip_sock *sock; + err_t err; + u8_t write_flags; + size_t written; + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_send(%d, data=%p, size=%"SZT_F", flags=0x%x)\n", + s, data, size, flags)); + + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { +#if (LWIP_UDP || LWIP_RAW) + return lwip_sendto(s, data, size, flags, NULL, 0); +#else /* (LWIP_UDP || LWIP_RAW) */ + sock_set_errno(sock, err_to_errno(ERR_ARG)); + return -1; +#endif /* (LWIP_UDP || LWIP_RAW) */ + } + + DELAY_WHEN_MEMORY_NOT_ENOUGH(); + + write_flags = NETCONN_COPY | + ((flags & MSG_MORE) ? NETCONN_MORE : 0) | + ((flags & MSG_DONTWAIT) ? NETCONN_DONTBLOCK : 0); + written = 0; + err = netconn_write_partly(sock->conn, data, size, write_flags, &written); + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_send(%d) err=%d written=%"SZT_F"\n", s, err, written)); + sock_set_errno(sock, err_to_errno(err)); + + return (err == ERR_OK ? (int)written : -1); +} + +int +lwip_sendmsg(int s, const struct msghdr *msg, int flags) +{ + struct lwip_sock *sock; + struct netbuf *chain_buf; + u16_t remote_port; + int i; +#if LWIP_TCP + u8_t write_flags; + size_t written; +#endif + int size = 0; + err_t err = ERR_OK; + + sock = get_socket(s); + if (!sock) { + return -1; + } + + LWIP_ERROR("lwip_sendmsg: invalid msghdr", msg != NULL, + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + + LWIP_UNUSED_ARG(msg->msg_control); + LWIP_UNUSED_ARG(msg->msg_controllen); + LWIP_UNUSED_ARG(msg->msg_flags); + LWIP_ERROR("lwip_sendmsg: invalid msghdr iov", (msg->msg_iov != NULL && msg->msg_iovlen != 0), + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { +#if LWIP_TCP + write_flags = NETCONN_COPY | + ((flags & MSG_MORE) ? NETCONN_MORE : 0) | + ((flags & MSG_DONTWAIT) ? NETCONN_DONTBLOCK : 0); + + for (i = 0; i < msg->msg_iovlen; i++) { + written = 0; + err = netconn_write_partly(sock->conn, msg->msg_iov[i].iov_base, msg->msg_iov[i].iov_len, write_flags, &written); + if (err == ERR_OK) { + size += written; + /* check that the entire IO vector was accepected, if not return a partial write */ + if (written != msg->msg_iov[i].iov_len) + break; + } + /* none of this IO vector was accepted, but previous was, return partial write and conceal ERR_WOULDBLOCK */ + else if (err == ERR_WOULDBLOCK && size > 0) { + err = ERR_OK; + /* let ERR_WOULDBLOCK persist on the netconn since we are returning ERR_OK */ + break; + } else { + size = -1; + break; + } + } + sock_set_errno(sock, err_to_errno(err)); + return size; +#else /* LWIP_TCP */ + sock_set_errno(sock, err_to_errno(ERR_ARG)); + return -1; +#endif /* LWIP_TCP */ + } + /* else, UDP and RAW NETCONNs */ +#if LWIP_UDP || LWIP_RAW + + LWIP_UNUSED_ARG(flags); + LWIP_ERROR("lwip_sendmsg: invalid msghdr name", (((msg->msg_name == NULL) && (msg->msg_namelen == 0)) || + IS_SOCK_ADDR_LEN_VALID(msg->msg_namelen)) , + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + + /* initialize chain buffer with destination */ + chain_buf = netbuf_new(); + if (!chain_buf) { + sock_set_errno(sock, err_to_errno(ERR_MEM)); + return -1; + } + if (msg->msg_name) { + SOCKADDR_TO_IPADDR_PORT((const struct sockaddr *)msg->msg_name, &chain_buf->addr, remote_port); + netbuf_fromport(chain_buf) = remote_port; + } +#if LWIP_NETIF_TX_SINGLE_PBUF + for (i = 0; i < msg->msg_iovlen; i++) { + size += msg->msg_iov[i].iov_len; + } + /* Allocate a new netbuf and copy the data into it. */ + if (netbuf_alloc(chain_buf, (u16_t)size) == NULL) { + err = ERR_MEM; + } + else { + /* flatten the IO vectors */ + size_t offset = 0; + for (i = 0; i < msg->msg_iovlen; i++) { + MEMCPY(&((u8_t*)chain_buf->p->payload)[offset], msg->msg_iov[i].iov_base, msg->msg_iov[i].iov_len); + offset += msg->msg_iov[i].iov_len; + } +#if LWIP_CHECKSUM_ON_COPY + { + /* This can be improved by using LWIP_CHKSUM_COPY() and aggregating the checksum for each IO vector */ + u16_t chksum = ~inet_chksum_pbuf(chain_buf->p); + netbuf_set_chksum(chain_buf, chksum); + } +#endif /* LWIP_CHECKSUM_ON_COPY */ + err = ERR_OK; + } +#else /* LWIP_NETIF_TX_SINGLE_PBUF */ + /* create a chained netbuf from the IO vectors. NOTE: we assemble a pbuf chain + manually to avoid having to allocate, chain, and delete a netbuf for each iov */ + for (i = 0; i < msg->msg_iovlen; i++) { + struct pbuf *p = pbuf_alloc(PBUF_TRANSPORT, 0, PBUF_REF); + if (p == NULL) { + err = ERR_MEM; /* let netbuf_delete() cleanup chain_buf */ + break; + } + p->payload = msg->msg_iov[i].iov_base; + LWIP_ASSERT("iov_len < u16_t", msg->msg_iov[i].iov_len <= 0xFFFF); + p->len = p->tot_len = (u16_t)msg->msg_iov[i].iov_len; + /* netbuf empty, add new pbuf */ + if (chain_buf->p == NULL) { + chain_buf->p = chain_buf->ptr = p; + /* add pbuf to existing pbuf chain */ + } else { + pbuf_cat(chain_buf->p, p); + } + } + /* save size of total chain */ + if (err == ERR_OK) { + size = netbuf_len(chain_buf); + } +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ + + if (err == ERR_OK) { + /* send the data */ + err = netconn_send(sock->conn, chain_buf); + } + + /* deallocated the buffer */ + netbuf_delete(chain_buf); + + sock_set_errno(sock, err_to_errno(err)); + return (err == ERR_OK ? size : -1); +#else /* LWIP_UDP || LWIP_RAW */ + sock_set_errno(sock, err_to_errno(ERR_ARG)); + return -1; +#endif /* LWIP_UDP || LWIP_RAW */ +} + +int +lwip_sendto(int s, const void *data, size_t size, int flags, + const struct sockaddr *to, socklen_t tolen) +{ + struct lwip_sock *sock; + err_t err; + u16_t short_size; + u16_t remote_port; + struct netbuf buf; + + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_TCP) { +#if LWIP_TCP + return lwip_send(s, data, size, flags); +#else /* LWIP_TCP */ + LWIP_UNUSED_ARG(flags); + sock_set_errno(sock, err_to_errno(ERR_ARG)); + return -1; +#endif /* LWIP_TCP */ + } + + DELAY_WHEN_MEMORY_NOT_ENOUGH(); + + if ((to != NULL) && !SOCK_ADDR_TYPE_MATCH(to, sock)) { + /* sockaddr does not match socket type (IPv4/IPv6) */ + sock_set_errno(sock, err_to_errno(ERR_VAL)); + return -1; + } + + /* @todo: split into multiple sendto's? */ + LWIP_ASSERT("lwip_sendto: size must fit in u16_t", size <= 0xffff); + short_size = (u16_t)size; + LWIP_ERROR("lwip_sendto: invalid address", (((to == NULL) && (tolen == 0)) || + (IS_SOCK_ADDR_LEN_VALID(tolen) && + IS_SOCK_ADDR_TYPE_VALID(to) && IS_SOCK_ADDR_ALIGNED(to))), + sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); + LWIP_UNUSED_ARG(tolen); + + /* initialize a buffer */ + buf.p = buf.ptr = NULL; +#if LWIP_CHECKSUM_ON_COPY + buf.flags = 0; +#endif /* LWIP_CHECKSUM_ON_COPY */ + if (to) { + SOCKADDR_TO_IPADDR_PORT(to, &buf.addr, remote_port); + } else { + +#ifdef LWIP_ESP8266 + /*fix the code for getting the UDP proto's remote information by liuh at 2014.8.27*/ + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) == NETCONN_UDP){ + buf.addr.u_addr.ip4.addr = sock->conn->pcb.udp->remote_ip.u_addr.ip4.addr; + remote_port = sock->conn->pcb.udp->remote_port; + } else { +#endif + remote_port = 0; + ip_addr_set_any(NETCONNTYPE_ISIPV6(netconn_type(sock->conn)), &buf.addr); +#ifdef LWIP_ESP8266 + } +#endif + + } + netbuf_fromport(&buf) = remote_port; + + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_sendto(%d, data=%p, short_size=%"U16_F", flags=0x%x to=", + s, data, short_size, flags)); + ip_addr_debug_print(SOCKETS_DEBUG, &buf.addr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F"\n", remote_port)); + + /* make the buffer point to the data that should be sent */ +#if LWIP_NETIF_TX_SINGLE_PBUF + /* Allocate a new netbuf and copy the data into it. */ + if (netbuf_alloc(&buf, short_size) == NULL) { + err = ERR_MEM; + } else { +#if LWIP_CHECKSUM_ON_COPY + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_RAW) { + u16_t chksum = LWIP_CHKSUM_COPY(buf.p->payload, data, short_size); + netbuf_set_chksum(&buf, chksum); + } else +#endif /* LWIP_CHECKSUM_ON_COPY */ + { + MEMCPY(buf.p->payload, data, short_size); + } + err = ERR_OK; + } +#else /* LWIP_NETIF_TX_SINGLE_PBUF */ + err = netbuf_ref(&buf, data, short_size); +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ + if (err == ERR_OK) { + /* send the data */ + err = netconn_send(sock->conn, &buf); + } + + /* deallocated the buffer */ + netbuf_free(&buf); + + sock_set_errno(sock, err_to_errno(err)); + return (err == ERR_OK ? short_size : -1); +} + +int +lwip_socket(int domain, int type, int protocol) +{ + struct netconn *conn; + int i; + +#if !LWIP_IPV6 + LWIP_UNUSED_ARG(domain); /* @todo: check this */ +#endif /* LWIP_IPV6 */ + + /* create a netconn */ + switch (type) { + case SOCK_RAW: + conn = netconn_new_with_proto_and_callback(DOMAIN_TO_NETCONN_TYPE(domain, NETCONN_RAW), + (u8_t)protocol, event_callback); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_socket(%s, SOCK_RAW, %d) = ", + domain == PF_INET ? "PF_INET" : "UNKNOWN", protocol)); + break; + case SOCK_DGRAM: + conn = netconn_new_with_callback(DOMAIN_TO_NETCONN_TYPE(domain, + ((protocol == IPPROTO_UDPLITE) ? NETCONN_UDPLITE : NETCONN_UDP)) , + event_callback); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_socket(%s, SOCK_DGRAM, %d) = ", + domain == PF_INET ? "PF_INET" : "UNKNOWN", protocol)); + break; + case SOCK_STREAM: + conn = netconn_new_with_callback(DOMAIN_TO_NETCONN_TYPE(domain, NETCONN_TCP), event_callback); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_socket(%s, SOCK_STREAM, %d) = ", + domain == PF_INET ? "PF_INET" : "UNKNOWN", protocol)); + if (conn != NULL) { + /* Prevent automatic window updates, we do this on our own! */ + netconn_set_noautorecved(conn, 1); + } + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_socket(%d, %d/UNKNOWN, %d) = -1\n", + domain, type, protocol)); + set_errno(EINVAL); + return -1; + } + + if (!conn) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("-1 / ENOBUFS (could not create netconn)\n")); + set_errno(ENOBUFS); + return -1; + } + + i = alloc_socket(conn, 0); + + if (i == -1) { + netconn_delete(conn); + set_errno(ENFILE); + return -1; + } + conn->socket = i; + LWIP_DEBUGF(SOCKETS_DEBUG, ("%d\n", i)); + set_errno(0); + return i; +} + +int +lwip_write(int s, const void *data, size_t size) +{ + return lwip_send(s, data, size, 0); +} + +int +lwip_writev(int s, const struct iovec *iov, int iovcnt) +{ + struct msghdr msg; + + msg.msg_name = NULL; + msg.msg_namelen = 0; + /* Hack: we have to cast via number to cast from 'const' pointer to non-const. + Blame the opengroup standard for this inconsistency. */ + msg.msg_iov = (struct iovec *)(size_t)iov; + msg.msg_iovlen = iovcnt; + msg.msg_control = NULL; + msg.msg_controllen = 0; + msg.msg_flags = 0; + return lwip_sendmsg(s, &msg, 0); +} + +/** + * Go through the readset and writeset lists and see which socket of the sockets + * set in the sets has events. On return, readset, writeset and exceptset have + * the sockets enabled that had events. + * + * @param maxfdp1 the highest socket index in the sets + * @param readset_in: set of sockets to check for read events + * @param writeset_in: set of sockets to check for write events + * @param exceptset_in: set of sockets to check for error events + * @param readset_out: set of sockets that had read events + * @param writeset_out: set of sockets that had write events + * @param exceptset_out: set os sockets that had error events + * @return number of sockets that had events (read/write/exception) (>= 0) + */ +static int +lwip_selscan(int maxfdp1, fd_set *readset_in, fd_set *writeset_in, fd_set *exceptset_in, + fd_set *readset_out, fd_set *writeset_out, fd_set *exceptset_out) +{ + int i, nready = 0; + fd_set lreadset, lwriteset, lexceptset; + struct lwip_sock *sock; + SYS_ARCH_DECL_PROTECT(lev); + + FD_ZERO(&lreadset); + FD_ZERO(&lwriteset); + FD_ZERO(&lexceptset); + + /* Go through each socket in each list to count number of sockets which + currently match */ + for (i = LWIP_SOCKET_OFFSET; i < maxfdp1; i++) { + /* if this FD is not in the set, continue */ + if (!(readset_in && FD_ISSET(i, readset_in)) && + !(writeset_in && FD_ISSET(i, writeset_in)) && + !(exceptset_in && FD_ISSET(i, exceptset_in))) { + continue; + } + /* First get the socket's status (protected)... */ + SYS_ARCH_PROTECT(lev); + sock = tryget_socket(i); + if (sock != NULL) { + void* lastdata = sock->lastdata; + s16_t rcvevent = sock->rcvevent; + u16_t sendevent = sock->sendevent; + u16_t errevent = sock->errevent; + SYS_ARCH_UNPROTECT(lev); + + /* ... then examine it: */ + /* See if netconn of this socket is ready for read */ + if (readset_in && FD_ISSET(i, readset_in) && ((lastdata != NULL) || (rcvevent > 0))) { + FD_SET(i, &lreadset); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_selscan: fd=%d ready for reading\n", i)); + nready++; + } + /* See if netconn of this socket is ready for write */ + if (writeset_in && FD_ISSET(i, writeset_in) && (sendevent != 0)) { + FD_SET(i, &lwriteset); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_selscan: fd=%d ready for writing\n", i)); + nready++; + } + /* See if netconn of this socket had an error */ + if (exceptset_in && FD_ISSET(i, exceptset_in) && (errevent != 0)) { + FD_SET(i, &lexceptset); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_selscan: fd=%d ready for exception\n", i)); + nready++; + } + } else { + SYS_ARCH_UNPROTECT(lev); + /* continue on to next FD in list */ + } + } + /* copy local sets to the ones provided as arguments */ + *readset_out = lreadset; + *writeset_out = lwriteset; + *exceptset_out = lexceptset; + + LWIP_ASSERT("nready >= 0", nready >= 0); + return nready; +} + +int +lwip_select(int maxfdp1, fd_set *readset, fd_set *writeset, fd_set *exceptset, + struct timeval *timeout) +{ + u32_t waitres = 0; + int nready; + fd_set lreadset, lwriteset, lexceptset; + u32_t msectimeout; + struct lwip_select_cb select_cb; + int i; + int maxfdp2; +#if LWIP_NETCONN_SEM_PER_THREAD + int waited = 0; +#endif + SYS_ARCH_DECL_PROTECT(lev); + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_select(%d, %p, %p, %p, tvsec=%"S32_F" tvusec=%"S32_F")\n", + maxfdp1, (void *)readset, (void *) writeset, (void *) exceptset, + timeout ? (s32_t)timeout->tv_sec : (s32_t)-1, + timeout ? (s32_t)timeout->tv_usec : (s32_t)-1)); + + /* Go through each socket in each list to count number of sockets which + currently match */ + nready = lwip_selscan(maxfdp1, readset, writeset, exceptset, &lreadset, &lwriteset, &lexceptset); + + /* If we don't have any current events, then suspend if we are supposed to */ + if (!nready) { + if (timeout && timeout->tv_sec == 0 && timeout->tv_usec == 0) { + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_select: no timeout, returning 0\n")); + /* This is OK as the local fdsets are empty and nready is zero, + or we would have returned earlier. */ + goto return_copy_fdsets; + } + + /* None ready: add our semaphore to list: + We don't actually need any dynamic memory. Our entry on the + list is only valid while we are in this function, so it's ok + to use local variables. */ + + select_cb.next = NULL; + select_cb.prev = NULL; + select_cb.readset = readset; + select_cb.writeset = writeset; + select_cb.exceptset = exceptset; + select_cb.sem_signalled = 0; +#if LWIP_NETCONN_SEM_PER_THREAD + select_cb.sem = LWIP_NETCONN_THREAD_SEM_GET(); +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + if (sys_sem_new(&select_cb.sem, 0) != ERR_OK) { + /* failed to create semaphore */ + set_errno(ENOMEM); + return -1; + } +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + + /* Protect the select_cb_list */ + SYS_ARCH_PROTECT(lev); + + /* Put this select_cb on top of list */ + select_cb.next = select_cb_list; + if (select_cb_list != NULL) { + select_cb_list->prev = &select_cb; + } + select_cb_list = &select_cb; + /* Increasing this counter tells event_callback that the list has changed. */ + select_cb_ctr++; + + /* Now we can safely unprotect */ + SYS_ARCH_UNPROTECT(lev); + + /* Increase select_waiting for each socket we are interested in */ + maxfdp2 = maxfdp1; + for (i = LWIP_SOCKET_OFFSET; i < maxfdp1; i++) { + if ((readset && FD_ISSET(i, readset)) || + (writeset && FD_ISSET(i, writeset)) || + (exceptset && FD_ISSET(i, exceptset))) { + struct lwip_sock *sock; + SYS_ARCH_PROTECT(lev); + sock = tryget_socket(i); + if (sock != NULL) { + sock->select_waiting++; + LWIP_ASSERT("sock->select_waiting > 0", sock->select_waiting > 0); + } else { + /* Not a valid socket */ + nready = -1; + maxfdp2 = i; + SYS_ARCH_UNPROTECT(lev); + break; + } + SYS_ARCH_UNPROTECT(lev); + } + } + + if (nready >= 0) { + /* Call lwip_selscan again: there could have been events between + the last scan (without us on the list) and putting us on the list! */ + nready = lwip_selscan(maxfdp1, readset, writeset, exceptset, &lreadset, &lwriteset, &lexceptset); + if (!nready) { + /* Still none ready, just wait to be woken */ + if (timeout == 0) { + /* Wait forever */ + msectimeout = 0; + } else { + msectimeout = ((timeout->tv_sec * 1000) + ((timeout->tv_usec + 500)/1000)); + if (msectimeout == 0) { + /* Wait 1ms at least (0 means wait forever) */ + msectimeout = 1; + } + } + + waitres = sys_arch_sem_wait(SELECT_SEM_PTR(select_cb.sem), msectimeout); +#if LWIP_NETCONN_SEM_PER_THREAD + waited = 1; +#endif + } + } + + /* Decrease select_waiting for each socket we are interested in */ + for (i = LWIP_SOCKET_OFFSET; i < maxfdp2; i++) { + if ((readset && FD_ISSET(i, readset)) || + (writeset && FD_ISSET(i, writeset)) || + (exceptset && FD_ISSET(i, exceptset))) { + struct lwip_sock *sock; + SYS_ARCH_PROTECT(lev); + sock = tryget_socket(i); + if (sock != NULL) { + /* @todo: what if this is a new socket (reallocated?) in this case, + select_waiting-- would be wrong (a global 'sockalloc' counter, + stored per socket could help) */ + LWIP_ASSERT("sock->select_waiting > 0", sock->select_waiting > 0); + if (sock->select_waiting > 0) { + sock->select_waiting--; + } + } else { + /* Not a valid socket */ + nready = -1; + } + SYS_ARCH_UNPROTECT(lev); + } + } + /* Take us off the list */ + SYS_ARCH_PROTECT(lev); + if (select_cb.next != NULL) { + select_cb.next->prev = select_cb.prev; + } + if (select_cb_list == &select_cb) { + LWIP_ASSERT("select_cb.prev == NULL", select_cb.prev == NULL); + select_cb_list = select_cb.next; + } else { + LWIP_ASSERT("select_cb.prev != NULL", select_cb.prev != NULL); + select_cb.prev->next = select_cb.next; + } + /* Increasing this counter tells event_callback that the list has changed. */ + select_cb_ctr++; + SYS_ARCH_UNPROTECT(lev); + +#if LWIP_NETCONN_SEM_PER_THREAD + if (select_cb.sem_signalled && (!waited || (waitres == SYS_ARCH_TIMEOUT))) { + /* don't leave the thread-local semaphore signalled */ + sys_arch_sem_wait(select_cb.sem, 1); + } +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + sys_sem_free(&select_cb.sem); +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + + if (nready < 0) { + /* This happens when a socket got closed while waiting */ + set_errno(EBADF); + return -1; + } + + if (waitres == SYS_ARCH_TIMEOUT) { + /* Timeout */ + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_select: timeout expired\n")); + /* This is OK as the local fdsets are empty and nready is zero, + or we would have returned earlier. */ + goto return_copy_fdsets; + } + + /* See what's set */ + nready = lwip_selscan(maxfdp1, readset, writeset, exceptset, &lreadset, &lwriteset, &lexceptset); + } + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_select: nready=%d\n", nready)); +return_copy_fdsets: + set_errno(0); + if (readset) { + *readset = lreadset; + } + if (writeset) { + *writeset = lwriteset; + } + if (exceptset) { + *exceptset = lexceptset; + } + return nready; +} + +/** + * Callback registered in the netconn layer for each socket-netconn. + * Processes recvevent (data available) and wakes up tasks waiting for select. + */ +static void +event_callback(struct netconn *conn, enum netconn_evt evt, u16_t len) +{ + int s; + struct lwip_sock *sock; + struct lwip_select_cb *scb; + int last_select_cb_ctr; + SYS_ARCH_DECL_PROTECT(lev); + + LWIP_UNUSED_ARG(len); + + /* Get socket */ + if (conn) { + s = conn->socket; + if (s < 0) { + /* Data comes in right away after an accept, even though + * the server task might not have created a new socket yet. + * Just count down (or up) if that's the case and we + * will use the data later. Note that only receive events + * can happen before the new socket is set up. */ + SYS_ARCH_PROTECT(lev); + if (conn->socket < 0) { + if (evt == NETCONN_EVT_RCVPLUS) { + conn->socket--; + } + SYS_ARCH_UNPROTECT(lev); + return; + } + s = conn->socket; + SYS_ARCH_UNPROTECT(lev); + } + + sock = get_socket(s); + if (!sock) { + return; + } + } else { + return; + } + + SYS_ARCH_PROTECT(lev); + /* Set event as required */ + switch (evt) { + case NETCONN_EVT_RCVPLUS: + sock->rcvevent++; + break; + case NETCONN_EVT_RCVMINUS: + sock->rcvevent--; + break; + case NETCONN_EVT_SENDPLUS: + sock->sendevent = 1; + break; + case NETCONN_EVT_SENDMINUS: + sock->sendevent = 0; + break; + case NETCONN_EVT_ERROR: + sock->errevent = 1; + break; + default: + LWIP_ASSERT("unknown event", 0); + break; + } + + if (sock->select_waiting == 0) { + /* noone is waiting for this socket, no need to check select_cb_list */ + SYS_ARCH_UNPROTECT(lev); + return; + } + + /* Now decide if anyone is waiting for this socket */ + /* NOTE: This code goes through the select_cb_list list multiple times + ONLY IF a select was actually waiting. We go through the list the number + of waiting select calls + 1. This list is expected to be small. */ + + /* At this point, SYS_ARCH is still protected! */ +again: + for (scb = select_cb_list; scb != NULL; scb = scb->next) { + /* remember the state of select_cb_list to detect changes */ + last_select_cb_ctr = select_cb_ctr; + if (scb->sem_signalled == 0) { + /* semaphore not signalled yet */ + int do_signal = 0; + /* Test this select call for our socket */ + if (sock->rcvevent > 0) { + if (scb->readset && FD_ISSET(s, scb->readset)) { + do_signal = 1; + } + } + if (sock->sendevent != 0) { + if (!do_signal && scb->writeset && FD_ISSET(s, scb->writeset)) { + do_signal = 1; + } + } + if (sock->errevent != 0) { + if (!do_signal && scb->exceptset && FD_ISSET(s, scb->exceptset)) { + do_signal = 1; + } + } + if (do_signal) { + scb->sem_signalled = 1; + /* Don't call SYS_ARCH_UNPROTECT() before signaling the semaphore, as this might + lead to the select thread taking itself off the list, invalidating the semaphore. */ + sys_sem_signal(SELECT_SEM_PTR(scb->sem)); + } + } + /* unlock interrupts with each step */ + SYS_ARCH_UNPROTECT(lev); + /* this makes sure interrupt protection time is short */ + SYS_ARCH_PROTECT(lev); + if (last_select_cb_ctr != select_cb_ctr) { + /* someone has changed select_cb_list, restart at the beginning */ + goto again; + } + } + SYS_ARCH_UNPROTECT(lev); +} + +/** + * Unimplemented: Close one end of a full-duplex connection. + * Currently, the full connection is closed. + */ +int +lwip_shutdown(int s, int how) +{ +#ifndef LWIP_ESP8266 + + struct lwip_sock *sock; + err_t err; + u8_t shut_rx = 0, shut_tx = 0; + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_shutdown(%d, how=%d)\n", s, how)); + + sock = get_socket(s); + if (!sock) { + return -1; + } + + if (sock->conn != NULL) { + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + sock_set_errno(sock, EOPNOTSUPP); + return -1; + } + } else { + sock_set_errno(sock, ENOTCONN); + return -1; + } + + if (how == SHUT_RD) { + shut_rx = 1; + } else if (how == SHUT_WR) { + shut_tx = 1; + } else if (how == SHUT_RDWR) { + shut_rx = 1; + shut_tx = 1; + } else { + sock_set_errno(sock, EINVAL); + return -1; + } + err = netconn_shutdown(sock->conn, shut_rx, shut_tx); + + sock_set_errno(sock, err_to_errno(err)); + return (err == ERR_OK ? 0 : -1); +#else + return ERR_OK; +#endif + +} + +static int +lwip_getaddrname(int s, struct sockaddr *name, socklen_t *namelen, u8_t local) +{ + struct lwip_sock *sock; + union sockaddr_aligned saddr; + ip_addr_t naddr; + u16_t port; + err_t err; + + sock = get_socket(s); + if (!sock) { + return -1; + } + + /* get the IP address and port */ + /* @todo: this does not work for IPv6, yet */ + err = netconn_getaddr(sock->conn, &naddr, &port, local); + if (err != ERR_OK) { + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + IPADDR_PORT_TO_SOCKADDR(&saddr, &naddr, port); + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getaddrname(%d, addr=", s)); + ip_addr_debug_print_val(SOCKETS_DEBUG, naddr); + LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", port)); + + if (*namelen > saddr.sa.sa_len) { + *namelen = saddr.sa.sa_len; + } + MEMCPY(name, &saddr, *namelen); + + sock_set_errno(sock, 0); + return 0; +} + +int +lwip_getpeername(int s, struct sockaddr *name, socklen_t *namelen) +{ + return lwip_getaddrname(s, name, namelen, 0); +} + +int +lwip_getsockname(int s, struct sockaddr *name, socklen_t *namelen) +{ + return lwip_getaddrname(s, name, namelen, 1); +} + +int +lwip_getsockopt(int s, int level, int optname, void *optval, socklen_t *optlen) +{ + u8_t err; + struct lwip_sock *sock = get_socket(s); +#if !LWIP_TCPIP_CORE_LOCKING + LWIP_SETGETSOCKOPT_DATA_VAR_DECLARE(data); +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + + if (!sock) { + return -1; + } + + if ((NULL == optval) || (NULL == optlen)) { + sock_set_errno(sock, EFAULT); + return -1; + } + +#if LWIP_TCPIP_CORE_LOCKING + /* core-locking can just call the -impl function */ + LOCK_TCPIP_CORE(); + err = lwip_getsockopt_impl(s, level, optname, optval, optlen); + UNLOCK_TCPIP_CORE(); + +#else /* LWIP_TCPIP_CORE_LOCKING */ + +#if LWIP_MPU_COMPATIBLE + /* MPU_COMPATIBLE copies the optval data, so check for max size here */ + if (*optlen > LWIP_SETGETSOCKOPT_MAXOPTLEN) { + sock_set_errno(sock, ENOBUFS); + return -1; + } +#endif /* LWIP_MPU_COMPATIBLE */ + + LWIP_SETGETSOCKOPT_DATA_VAR_ALLOC(data, sock); + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).s = s; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).level = level; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optname = optname; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optlen = *optlen; +#if !LWIP_MPU_COMPATIBLE + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optval.p = optval; +#endif /* !LWIP_MPU_COMPATIBLE */ + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).err = 0; +#if LWIP_NETCONN_SEM_PER_THREAD + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem = LWIP_NETCONN_THREAD_SEM_GET(); +#else + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem = &sock->conn->op_completed; +#endif + err = tcpip_callback(lwip_getsockopt_callback, &LWIP_SETGETSOCKOPT_DATA_VAR_REF(data)); + if (err != ERR_OK) { + LWIP_SETGETSOCKOPT_DATA_VAR_FREE(data); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + sys_arch_sem_wait((sys_sem_t*)(LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem), 0); + + /* write back optlen and optval */ + *optlen = LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optlen; +#if LWIP_MPU_COMPATIBLE + memcpy(optval, LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optval, + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optlen); +#endif /* LWIP_MPU_COMPATIBLE */ + + /* maybe lwip_getsockopt_internal has changed err */ + err = LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).err; + LWIP_SETGETSOCKOPT_DATA_VAR_FREE(data); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + + sock_set_errno(sock, err); + return err ? -1 : 0; +} + +#if !LWIP_TCPIP_CORE_LOCKING +/** lwip_getsockopt_callback: only used without CORE_LOCKING + * to get into the tcpip_thread + */ +static void +lwip_getsockopt_callback(void *arg) +{ + struct lwip_setgetsockopt_data *data; + LWIP_ASSERT("arg != NULL", arg != NULL); + data = (struct lwip_setgetsockopt_data*)arg; + + data->err = lwip_getsockopt_impl(data->s, data->level, data->optname, +#if LWIP_MPU_COMPATIBLE + data->optval, +#else /* LWIP_MPU_COMPATIBLE */ + data->optval.p, +#endif /* LWIP_MPU_COMPATIBLE */ + &data->optlen); + + sys_sem_signal((sys_sem_t*)(data->completed_sem)); +} +#endif /* LWIP_TCPIP_CORE_LOCKING */ + +/** lwip_getsockopt_impl: the actual implementation of getsockopt: + * same argument as lwip_getsockopt, either called directly or through callback + */ +static u8_t +lwip_getsockopt_impl(int s, int level, int optname, void *optval, socklen_t *optlen) +{ + u8_t err = 0; + struct lwip_sock *sock = tryget_socket(s); + if (!sock) { + return EBADF; + } + + switch (level) { + +/* Level: SOL_SOCKET */ + case SOL_SOCKET: + switch (optname) { + +#if LWIP_TCP + case SO_ACCEPTCONN: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, int); + if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_TCP) { + return ENOPROTOOPT; + } + if ((sock->conn->pcb.tcp != NULL) && (sock->conn->pcb.tcp->state == LISTEN)) { + *(int*)optval = 1; + } else { + *(int*)optval = 0; + } + break; +#endif /* LWIP_TCP */ + + /* The option flags */ + case SO_BROADCAST: + case SO_KEEPALIVE: +#if SO_REUSE + case SO_REUSEADDR: +#endif /* SO_REUSE */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, int); + *(int*)optval = ip_get_option(sock->conn->pcb.ip, optname); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, optname=0x%x, ..) = %s\n", + s, optname, (*(int*)optval?"on":"off"))); + break; + + case SO_TYPE: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, int); + switch (NETCONNTYPE_GROUP(netconn_type(sock->conn))) { + case NETCONN_RAW: + *(int*)optval = SOCK_RAW; + break; + case NETCONN_TCP: + *(int*)optval = SOCK_STREAM; + break; + case NETCONN_UDP: + *(int*)optval = SOCK_DGRAM; + break; + default: /* unrecognized socket type */ + *(int*)optval = netconn_type(sock->conn); + LWIP_DEBUGF(SOCKETS_DEBUG, + ("lwip_getsockopt(%d, SOL_SOCKET, SO_TYPE): unrecognized socket type %d\n", + s, *(int *)optval)); + } /* switch (netconn_type(sock->conn)) */ + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, SO_TYPE) = %d\n", + s, *(int *)optval)); + break; + + case SO_ERROR: + LWIP_SOCKOPT_CHECK_OPTLEN(*optlen, int); + /* only overwrite ERR_OK or temporary errors */ + if (((sock->err == 0) || (sock->err == EINPROGRESS)) && (sock->conn != NULL)) { + sock_set_errno(sock, err_to_errno(sock->conn->last_err)); + } + *(int *)optval = (sock->err == 0xFF ? (int)-1 : (int)sock->err); + sock->err = 0; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, SO_ERROR) = %d\n", + s, *(int *)optval)); + break; + +#if LWIP_SO_SNDTIMEO + case SO_SNDTIMEO: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, LWIP_SO_SNDRCVTIMEO_OPTTYPE); + LWIP_SO_SNDRCVTIMEO_SET(optval, netconn_get_sendtimeout(sock->conn)); + break; +#endif /* LWIP_SO_SNDTIMEO */ +#if LWIP_SO_RCVTIMEO + case SO_RCVTIMEO: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, LWIP_SO_SNDRCVTIMEO_OPTTYPE); + LWIP_SO_SNDRCVTIMEO_SET(optval, netconn_get_recvtimeout(sock->conn)); + break; +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVBUF + case SO_RCVBUF: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, int); + *(int *)optval = netconn_get_recvbufsize(sock->conn); + break; +#endif /* LWIP_SO_RCVBUF */ +#if LWIP_SO_LINGER + case SO_LINGER: + { + s16_t conn_linger; + struct linger* linger = (struct linger*)optval; + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, struct linger); + conn_linger = sock->conn->linger; + if (conn_linger >= 0) { + linger->l_onoff = 1; + linger->l_linger = (int)conn_linger; + } else { + linger->l_onoff = 0; + linger->l_linger = 0; + } + } + break; +#endif /* LWIP_SO_LINGER */ +#if LWIP_UDP + case SO_NO_CHECK: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, *optlen, int, NETCONN_UDP); +#if LWIP_UDPLITE + if ((udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_UDPLITE) != 0) { + /* this flag is only available for UDP, not for UDP lite */ + return EAFNOSUPPORT; + } +#endif /* LWIP_UDPLITE */ + *(int*)optval = (udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_NOCHKSUM) ? 1 : 0; + break; +#endif /* LWIP_UDP*/ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + +/* Level: IPPROTO_IP */ + case IPPROTO_IP: + switch (optname) { + case IP_TTL: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, int); + *(int*)optval = sock->conn->pcb.ip->ttl; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_TTL) = %d\n", + s, *(int *)optval)); + break; + case IP_TOS: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, int); + *(int*)optval = sock->conn->pcb.ip->tos; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_TOS) = %d\n", + s, *(int *)optval)); + break; +#if LWIP_MULTICAST_TX_OPTIONS + case IP_MULTICAST_TTL: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, u8_t); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_UDP) { + return ENOPROTOOPT; + } + *(u8_t*)optval = sock->conn->pcb.udp->mcast_ttl; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_MULTICAST_TTL) = %d\n", + s, *(int *)optval)); + break; + case IP_MULTICAST_IF: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, struct in_addr); + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_UDP) { + return ENOPROTOOPT; + } + inet_addr_from_ipaddr((struct in_addr*)optval, udp_get_multicast_netif_addr(sock->conn->pcb.udp)); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_MULTICAST_IF) = 0x%"X32_F"\n", + s, *(u32_t *)optval)); + break; + case IP_MULTICAST_LOOP: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, u8_t); + if ((sock->conn->pcb.udp->flags & UDP_FLAGS_MULTICAST_LOOP) != 0) { + *(u8_t*)optval = 1; + } else { + *(u8_t*)optval = 0; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_MULTICAST_LOOP) = %d\n", + s, *(int *)optval)); + break; +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + +#if LWIP_TCP +/* Level: IPPROTO_TCP */ + case IPPROTO_TCP: + /* Special case: all IPPROTO_TCP option take an int */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, *optlen, int, NETCONN_TCP); + switch (optname) { + case TCP_NODELAY: + *(int*)optval = tcp_nagle_disabled(sock->conn->pcb.tcp); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, TCP_NODELAY) = %s\n", + s, (*(int*)optval)?"on":"off") ); + break; + case TCP_KEEPALIVE: + *(int*)optval = (int)sock->conn->pcb.tcp->keep_idle; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, TCP_KEEPALIVE) = %d\n", + s, *(int *)optval)); + break; + +#if LWIP_TCP_KEEPALIVE + case TCP_KEEPIDLE: + *(int*)optval = (int)(sock->conn->pcb.tcp->keep_idle/1000); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, TCP_KEEPIDLE) = %d\n", + s, *(int *)optval)); + break; + case TCP_KEEPINTVL: + *(int*)optval = (int)(sock->conn->pcb.tcp->keep_intvl/1000); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, TCP_KEEPINTVL) = %d\n", + s, *(int *)optval)); + break; + case TCP_KEEPCNT: + *(int*)optval = (int)sock->conn->pcb.tcp->keep_cnt; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, TCP_KEEPCNT) = %d\n", + s, *(int *)optval)); + break; +#endif /* LWIP_TCP_KEEPALIVE */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_TCP */ + +#if LWIP_IPV6 +/* Level: IPPROTO_IPV6 */ + case IPPROTO_IPV6: + switch (optname) { + case IPV6_V6ONLY: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, *optlen, int); + /* @todo: this does not work for datagram sockets, yet */ + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + return ENOPROTOOPT; + } + *(int*)optval = (netconn_get_ipv6only(sock->conn) ? 1 : 0); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IPV6, IPV6_V6ONLY) = %d\n", + s, *(int *)optval)); + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IPV6, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_IPV6 */ + +#if LWIP_UDP && LWIP_UDPLITE + /* Level: IPPROTO_UDPLITE */ + case IPPROTO_UDPLITE: + /* Special case: all IPPROTO_UDPLITE option take an int */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, *optlen, int); + /* If this is no UDP lite socket, ignore any options. */ + if (!NETCONNTYPE_ISUDPLITE(netconn_type(sock->conn))) { + return ENOPROTOOPT; + } + switch (optname) { + case UDPLITE_SEND_CSCOV: + *(int*)optval = sock->conn->pcb.udp->chksum_len_tx; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV) = %d\n", + s, (*(int*)optval)) ); + break; + case UDPLITE_RECV_CSCOV: + *(int*)optval = sock->conn->pcb.udp->chksum_len_rx; + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV) = %d\n", + s, (*(int*)optval)) ); + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_UDPLITE, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_UDP */ + /* Level: IPPROTO_RAW */ + case IPPROTO_RAW: + switch (optname) { +#if LWIP_IPV6 && LWIP_RAW + case IPV6_CHECKSUM: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, *optlen, int, NETCONN_RAW); + if (sock->conn->pcb.raw->chksum_reqd == 0) { + *(int *)optval = -1; + } else { + *(int *)optval = sock->conn->pcb.raw->chksum_offset; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_RAW, IPV6_CHECKSUM) = %d\n", + s, (*(int*)optval)) ); + break; +#endif /* LWIP_IPV6 && LWIP_RAW */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_RAW, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, level=0x%x, UNIMPL: optname=0x%x, ..)\n", + s, level, optname)); + err = ENOPROTOOPT; + break; + } /* switch (level) */ + + return err; +} + +int +lwip_setsockopt(int s, int level, int optname, const void *optval, socklen_t optlen) +{ + u8_t err = 0; + struct lwip_sock *sock = get_socket(s); +#if !LWIP_TCPIP_CORE_LOCKING + LWIP_SETGETSOCKOPT_DATA_VAR_DECLARE(data); +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + + if (!sock) { + return -1; + } + + if (NULL == optval) { + sock_set_errno(sock, EFAULT); + return -1; + } + +#if LWIP_TCPIP_CORE_LOCKING + /* core-locking can just call the -impl function */ + LOCK_TCPIP_CORE(); + err = lwip_setsockopt_impl(s, level, optname, optval, optlen); + UNLOCK_TCPIP_CORE(); + +#else /* LWIP_TCPIP_CORE_LOCKING */ + +#if LWIP_MPU_COMPATIBLE + /* MPU_COMPATIBLE copies the optval data, so check for max size here */ + if (optlen > LWIP_SETGETSOCKOPT_MAXOPTLEN) { + sock_set_errno(sock, ENOBUFS); + return -1; + } +#endif /* LWIP_MPU_COMPATIBLE */ + + LWIP_SETGETSOCKOPT_DATA_VAR_ALLOC(data, sock); + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).s = s; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).level = level; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optname = optname; + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optlen = optlen; +#if LWIP_MPU_COMPATIBLE + memcpy(LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optval, optval, optlen); +#else /* LWIP_MPU_COMPATIBLE */ + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).optval.pc = (const void*)optval; +#endif /* LWIP_MPU_COMPATIBLE */ + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).err = 0; +#if LWIP_NETCONN_SEM_PER_THREAD + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem = LWIP_NETCONN_THREAD_SEM_GET(); +#else + LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem = &sock->conn->op_completed; +#endif + err = tcpip_callback(lwip_setsockopt_callback, &LWIP_SETGETSOCKOPT_DATA_VAR_REF(data)); + if (err != ERR_OK) { + LWIP_SETGETSOCKOPT_DATA_VAR_FREE(data); + sock_set_errno(sock, err_to_errno(err)); + return -1; + } + sys_arch_sem_wait((sys_sem_t*)(LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).completed_sem), 0); + + /* maybe lwip_getsockopt_internal has changed err */ + err = LWIP_SETGETSOCKOPT_DATA_VAR_REF(data).err; + LWIP_SETGETSOCKOPT_DATA_VAR_FREE(data); +#endif /* LWIP_TCPIP_CORE_LOCKING */ + + sock_set_errno(sock, err); + return err ? -1 : 0; +} + +#if !LWIP_TCPIP_CORE_LOCKING +/** lwip_setsockopt_callback: only used without CORE_LOCKING + * to get into the tcpip_thread + */ +static void +lwip_setsockopt_callback(void *arg) +{ + struct lwip_setgetsockopt_data *data; + LWIP_ASSERT("arg != NULL", arg != NULL); + data = (struct lwip_setgetsockopt_data*)arg; + + data->err = lwip_setsockopt_impl(data->s, data->level, data->optname, +#if LWIP_MPU_COMPATIBLE + data->optval, +#else /* LWIP_MPU_COMPATIBLE */ + data->optval.pc, +#endif /* LWIP_MPU_COMPATIBLE */ + data->optlen); + + sys_sem_signal((sys_sem_t*)(data->completed_sem)); +} +#endif /* LWIP_TCPIP_CORE_LOCKING */ + +/** lwip_setsockopt_impl: the actual implementation of setsockopt: + * same argument as lwip_setsockopt, either called directly or through callback + */ +static u8_t +lwip_setsockopt_impl(int s, int level, int optname, const void *optval, socklen_t optlen) +{ + u8_t err = 0; + struct lwip_sock *sock = tryget_socket(s); + if (!sock) { + return EBADF; + } + + switch (level) { + +/* Level: SOL_SOCKET */ + case SOL_SOCKET: + switch (optname) { + + /* SO_ACCEPTCONN is get-only */ + + /* The option flags */ + case SO_BROADCAST: + case SO_KEEPALIVE: +#if SO_REUSE + case SO_REUSEADDR: +#endif /* SO_REUSE */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, int); + if (*(const int*)optval) { + ip_set_option(sock->conn->pcb.ip, optname); + } else { + ip_reset_option(sock->conn->pcb.ip, optname); + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, SOL_SOCKET, optname=0x%x, ..) -> %s\n", + s, optname, (*(const int*)optval?"on":"off"))); + break; + + /* SO_TYPE is get-only */ + /* SO_ERROR is get-only */ + +#if LWIP_SO_SNDTIMEO + case SO_SNDTIMEO: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, optlen, LWIP_SO_SNDRCVTIMEO_OPTTYPE); + netconn_set_sendtimeout(sock->conn, LWIP_SO_SNDRCVTIMEO_GET_MS(optval)); + break; +#endif /* LWIP_SO_SNDTIMEO */ +#if LWIP_SO_RCVTIMEO + case SO_RCVTIMEO: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, optlen, LWIP_SO_SNDRCVTIMEO_OPTTYPE); + netconn_set_recvtimeout(sock->conn, (int)LWIP_SO_SNDRCVTIMEO_GET_MS(optval)); + break; +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVBUF + case SO_RCVBUF: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, optlen, int); + netconn_set_recvbufsize(sock->conn, *(const int*)optval); + break; +#endif /* LWIP_SO_RCVBUF */ +#if LWIP_SO_LINGER + case SO_LINGER: + { + const struct linger* linger = (const struct linger*)optval; + LWIP_SOCKOPT_CHECK_OPTLEN_CONN(sock, optlen, struct linger); + if (linger->l_onoff) { + int lingersec = linger->l_linger; + if (lingersec < 0) { + return EINVAL; + } + if (lingersec > 0xFFFF) { + lingersec = 0xFFFF; + } + sock->conn->linger = (s16_t)lingersec; + } else { + sock->conn->linger = -1; + } + } + break; +#endif /* LWIP_SO_LINGER */ +#if LWIP_UDP + case SO_NO_CHECK: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, int, NETCONN_UDP); +#if LWIP_UDPLITE + if ((udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_UDPLITE) != 0) { + /* this flag is only available for UDP, not for UDP lite */ + return EAFNOSUPPORT; + } +#endif /* LWIP_UDPLITE */ + if (*(const int*)optval) { + udp_setflags(sock->conn->pcb.udp, udp_flags(sock->conn->pcb.udp) | UDP_FLAGS_NOCHKSUM); + } else { + udp_setflags(sock->conn->pcb.udp, udp_flags(sock->conn->pcb.udp) & ~UDP_FLAGS_NOCHKSUM); + } + break; +#endif /* LWIP_UDP */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, SOL_SOCKET, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + +/* Level: IPPROTO_IP */ + case IPPROTO_IP: + switch (optname) { + case IP_TTL: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, int); + sock->conn->pcb.ip->ttl = (u8_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IP, IP_TTL, ..) -> %d\n", + s, sock->conn->pcb.ip->ttl)); + break; + case IP_TOS: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, int); + sock->conn->pcb.ip->tos = (u8_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IP, IP_TOS, ..)-> %d\n", + s, sock->conn->pcb.ip->tos)); + break; +#if LWIP_MULTICAST_TX_OPTIONS + case IP_MULTICAST_TTL: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, u8_t, NETCONN_UDP); + sock->conn->pcb.udp->mcast_ttl = (u8_t)(*(const u8_t*)optval); + break; + case IP_MULTICAST_IF: + { + ip4_addr_t if_addr; + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, struct in_addr, NETCONN_UDP); + inet_addr_to_ipaddr(&if_addr, (const struct in_addr*)optval); + udp_set_multicast_netif_addr(sock->conn->pcb.udp, &if_addr); + } + break; + case IP_MULTICAST_LOOP: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, u8_t, NETCONN_UDP); + if (*(const u8_t*)optval) { + udp_setflags(sock->conn->pcb.udp, udp_flags(sock->conn->pcb.udp) | UDP_FLAGS_MULTICAST_LOOP); + } else { + udp_setflags(sock->conn->pcb.udp, udp_flags(sock->conn->pcb.udp) & ~UDP_FLAGS_MULTICAST_LOOP); + } + break; +#endif /* LWIP_MULTICAST_TX_OPTIONS */ +#if LWIP_IGMP + case IP_ADD_MEMBERSHIP: + case IP_DROP_MEMBERSHIP: + { + /* If this is a TCP or a RAW socket, ignore these options. */ + /* @todo: assign membership to this socket so that it is dropped when state the socket */ + err_t igmp_err; + const struct ip_mreq *imr = (const struct ip_mreq *)optval; + ip4_addr_t if_addr; + ip4_addr_t multi_addr; + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, struct ip_mreq, NETCONN_UDP); + inet_addr_to_ipaddr(&if_addr, &imr->imr_interface); + inet_addr_to_ipaddr(&multi_addr, &imr->imr_multiaddr); + if (optname == IP_ADD_MEMBERSHIP) { + if (!lwip_socket_register_membership(s, &if_addr, &multi_addr)) { + /* cannot track membership (out of memory) */ + err = ENOMEM; + igmp_err = ERR_OK; + } else { + igmp_err = igmp_joingroup(&if_addr, &multi_addr); + } + } else { + igmp_err = igmp_leavegroup(&if_addr, &multi_addr); + lwip_socket_unregister_membership(s, &if_addr, &multi_addr); + } + if (igmp_err != ERR_OK) { + err = EADDRNOTAVAIL; + } + } + break; +#endif /* LWIP_IGMP */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IP, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + +#if LWIP_TCP +/* Level: IPPROTO_TCP */ + case IPPROTO_TCP: + /* Special case: all IPPROTO_TCP option take an int */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, int, NETCONN_TCP); + switch (optname) { + case TCP_NODELAY: + if (*(const int*)optval) { + tcp_nagle_disable(sock->conn->pcb.tcp); + } else { + tcp_nagle_enable(sock->conn->pcb.tcp); + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, TCP_NODELAY) -> %s\n", + s, (*(const int *)optval)?"on":"off") ); + break; + case TCP_KEEPALIVE: + sock->conn->pcb.tcp->keep_idle = (u32_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, TCP_KEEPALIVE) -> %"U32_F"\n", + s, sock->conn->pcb.tcp->keep_idle)); + break; + +#if LWIP_TCP_KEEPALIVE + case TCP_KEEPIDLE: + sock->conn->pcb.tcp->keep_idle = 1000*(u32_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, TCP_KEEPIDLE) -> %"U32_F"\n", + s, sock->conn->pcb.tcp->keep_idle)); + break; + case TCP_KEEPINTVL: + sock->conn->pcb.tcp->keep_intvl = 1000*(u32_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, TCP_KEEPINTVL) -> %"U32_F"\n", + s, sock->conn->pcb.tcp->keep_intvl)); + break; + case TCP_KEEPCNT: + sock->conn->pcb.tcp->keep_cnt = (u32_t)(*(const int*)optval); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, TCP_KEEPCNT) -> %"U32_F"\n", + s, sock->conn->pcb.tcp->keep_cnt)); + break; +#endif /* LWIP_TCP_KEEPALIVE */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_TCP*/ + +#if LWIP_IPV6 +/* Level: IPPROTO_IPV6 */ + case IPPROTO_IPV6: + switch (optname) { + case IPV6_V6ONLY: + /* @todo: this does not work for datagram sockets, yet */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, int, NETCONN_TCP); + if (*(const int*)optval) { + netconn_set_ipv6only(sock->conn, 1); + } else { + netconn_set_ipv6only(sock->conn, 0); + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IPV6, IPV6_V6ONLY, ..) -> %d\n", + s, (netconn_get_ipv6only(sock->conn) ? 1 : 0))); + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IPV6, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_IPV6 */ + +#if LWIP_UDP && LWIP_UDPLITE + /* Level: IPPROTO_UDPLITE */ + case IPPROTO_UDPLITE: + /* Special case: all IPPROTO_UDPLITE option take an int */ + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB(sock, optlen, int); + /* If this is no UDP lite socket, ignore any options. */ + if (!NETCONNTYPE_ISUDPLITE(netconn_type(sock->conn))) { + return ENOPROTOOPT; + } + switch (optname) { + case UDPLITE_SEND_CSCOV: + if ((*(const int*)optval != 0) && ((*(const int*)optval < 8) || (*(const int*)optval > 0xffff))) { + /* don't allow illegal values! */ + sock->conn->pcb.udp->chksum_len_tx = 8; + } else { + sock->conn->pcb.udp->chksum_len_tx = (u16_t)*(const int*)optval; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV) -> %d\n", + s, (*(const int*)optval)) ); + break; + case UDPLITE_RECV_CSCOV: + if ((*(const int*)optval != 0) && ((*(const int*)optval < 8) || (*(const int*)optval > 0xffff))) { + /* don't allow illegal values! */ + sock->conn->pcb.udp->chksum_len_rx = 8; + } else { + sock->conn->pcb.udp->chksum_len_rx = (u16_t)*(const int*)optval; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV) -> %d\n", + s, (*(const int*)optval)) ); + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; +#endif /* LWIP_UDP */ + /* Level: IPPROTO_RAW */ + case IPPROTO_RAW: + switch (optname) { +#if LWIP_IPV6 && LWIP_RAW + case IPV6_CHECKSUM: + LWIP_SOCKOPT_CHECK_OPTLEN_CONN_PCB_TYPE(sock, optlen, int, NETCONN_RAW); + if (*(const int *)optval < 0) { + sock->conn->pcb.raw->chksum_reqd = 0; + } else if (*(const int *)optval & 1) { + /* Per RFC3542, odd offsets are not allowed */ + return EINVAL; + } else { + sock->conn->pcb.raw->chksum_reqd = 1; + sock->conn->pcb.raw->chksum_offset = (u16_t)*(const int *)optval; + } + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_RAW, IPV6_CHECKSUM, ..) -> %d\n", + s, sock->conn->pcb.raw->chksum_reqd)); + break; +#endif /* LWIP_IPV6 && LWIP_RAW */ + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_RAW, UNIMPL: optname=0x%x, ..)\n", + s, optname)); + err = ENOPROTOOPT; + break; + } /* switch (optname) */ + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, level=0x%x, UNIMPL: optname=0x%x, ..)\n", + s, level, optname)); + err = ENOPROTOOPT; + break; + } /* switch (level) */ + + return err; +} + +int +lwip_ioctl(int s, long cmd, void *argp) +{ + struct lwip_sock *sock = get_socket(s); + u8_t val; +#if LWIP_SO_RCVBUF + u16_t buflen = 0; + int recv_avail; +#endif /* LWIP_SO_RCVBUF */ + + if (!sock) { + return -1; + } + + switch (cmd) { +#if LWIP_SO_RCVBUF || LWIP_FIONREAD_LINUXMODE + case FIONREAD: + if (!argp) { + sock_set_errno(sock, EINVAL); + return -1; + } +#if LWIP_FIONREAD_LINUXMODE + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + struct pbuf *p; + if (sock->lastdata) { + p = ((struct netbuf *)sock->lastdata)->p; + *((int*)argp) = p->tot_len - sock->lastoffset; + } else { + struct netbuf *rxbuf; + err_t err; + if (sock->rcvevent <= 0) { + *((int*)argp) = 0; + } else { + err = netconn_recv(sock->conn, &rxbuf); + if (err != ERR_OK) { + *((int*)argp) = 0; + } else { + sock->lastdata = rxbuf; + sock->lastoffset = 0; + *((int*)argp) = rxbuf->p->tot_len; + } + } + } + return 0; + } +#endif /* LWIP_FIONREAD_LINUXMODE */ + +#if LWIP_SO_RCVBUF + /* we come here if either LWIP_FIONREAD_LINUXMODE==0 or this is a TCP socket */ + SYS_ARCH_GET(sock->conn->recv_avail, recv_avail); + if (recv_avail < 0) { + recv_avail = 0; + } + *((int*)argp) = recv_avail; + + /* Check if there is data left from the last recv operation. /maq 041215 */ + if (sock->lastdata) { + struct pbuf *p = (struct pbuf *)sock->lastdata; + if (NETCONNTYPE_GROUP(netconn_type(sock->conn)) != NETCONN_TCP) { + p = ((struct netbuf *)p)->p; + } + buflen = p->tot_len; + buflen -= sock->lastoffset; + + *((int*)argp) += buflen; + } + + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_ioctl(%d, FIONREAD, %p) = %"U16_F"\n", s, argp, *((u16_t*)argp))); + sock_set_errno(sock, 0); + return 0; +#else /* LWIP_SO_RCVBUF */ + break; +#endif /* LWIP_SO_RCVBUF */ +#endif /* LWIP_SO_RCVBUF || LWIP_FIONREAD_LINUXMODE */ + + case (long)FIONBIO: + val = 0; + if (argp && *(u32_t*)argp) { + val = 1; + } + netconn_set_nonblocking(sock->conn, val); + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_ioctl(%d, FIONBIO, %d)\n", s, val)); + sock_set_errno(sock, 0); + return 0; + + default: + break; + } /* switch (cmd) */ + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_ioctl(%d, UNIMPL: 0x%lx, %p)\n", s, cmd, argp)); + sock_set_errno(sock, ENOSYS); /* not yet implemented */ + return -1; +} + +/** A minimal implementation of fcntl. + * Currently only the commands F_GETFL and F_SETFL are implemented. + * Only the flag O_NONBLOCK is implemented. + */ +int +lwip_fcntl(int s, int cmd, int val) +{ + struct lwip_sock *sock = get_socket(s); + int ret = -1; + + if (!sock) { + return -1; + } + + switch (cmd) { + case F_GETFL: + ret = netconn_is_nonblocking(sock->conn) ? O_NONBLOCK : 0; + sock_set_errno(sock, 0); + break; + case F_SETFL: + if ((val & ~O_NONBLOCK) == 0) { + /* only O_NONBLOCK, all other bits are zero */ + netconn_set_nonblocking(sock->conn, val & O_NONBLOCK); + ret = 0; + sock_set_errno(sock, 0); + } else { + sock_set_errno(sock, ENOSYS); /* not yet implemented */ + } + break; + default: + LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_fcntl(%d, UNIMPL: %d, %d)\n", s, cmd, val)); + sock_set_errno(sock, ENOSYS); /* not yet implemented */ + break; + } + return ret; +} + +#if LWIP_IGMP +/** Register a new IGMP membership. On socket close, the membership is dropped automatically. + * + * ATTENTION: this function is called from tcpip_thread (or under CORE_LOCK). + * + * @return 1 on success, 0 on failure + */ +static int +lwip_socket_register_membership(int s, const ip4_addr_t *if_addr, const ip4_addr_t *multi_addr) +{ + /* s+1 is stored in the array to prevent having to initialize the array + (default initialization is to 0) */ + int sa = s + 1; + int i; + + for (i = 0; i < LWIP_SOCKET_MAX_MEMBERSHIPS; i++) { + if (socket_ipv4_multicast_memberships[i].sa == 0) { + socket_ipv4_multicast_memberships[i].sa = sa; + ip4_addr_copy(socket_ipv4_multicast_memberships[i].if_addr, *if_addr); + ip4_addr_copy(socket_ipv4_multicast_memberships[i].multi_addr, *multi_addr); + return 1; + } + } + return 0; +} + +/** Unregister a previously registered membership. This prevents dropping the membership + * on socket close. + * + * ATTENTION: this function is called from tcpip_thread (or under CORE_LOCK). + */ +static void +lwip_socket_unregister_membership(int s, const ip4_addr_t *if_addr, const ip4_addr_t *multi_addr) +{ + /* s+1 is stored in the array to prevent having to initialize the array + (default initialization is to 0) */ + int sa = s + 1; + int i; + + for (i = 0; i < LWIP_SOCKET_MAX_MEMBERSHIPS; i++) { + if ((socket_ipv4_multicast_memberships[i].sa == sa) && + ip4_addr_cmp(&socket_ipv4_multicast_memberships[i].if_addr, if_addr) && + ip4_addr_cmp(&socket_ipv4_multicast_memberships[i].multi_addr, multi_addr)) { + socket_ipv4_multicast_memberships[i].sa = 0; + ip4_addr_set_zero(&socket_ipv4_multicast_memberships[i].if_addr); + ip4_addr_set_zero(&socket_ipv4_multicast_memberships[i].multi_addr); + return; + } + } +} + +/** Drop all memberships of a socket that were not dropped explicitly via setsockopt. + * + * ATTENTION: this function is NOT called from tcpip_thread (or under CORE_LOCK). + */ +static void lwip_socket_drop_registered_memberships(int s) +{ + /* s+1 is stored in the array to prevent having to initialize the array + (default initialization is to 0) */ + int sa = s + 1; + int i; + + LWIP_ASSERT("socket has no netconn", sockets[s].conn != NULL); + + for (i = 0; i < LWIP_SOCKET_MAX_MEMBERSHIPS; i++) { + if (socket_ipv4_multicast_memberships[i].sa == sa) { + ip_addr_t multi_addr, if_addr; + ip_addr_copy_from_ip4(multi_addr, socket_ipv4_multicast_memberships[i].multi_addr); + ip_addr_copy_from_ip4(if_addr, socket_ipv4_multicast_memberships[i].if_addr); + socket_ipv4_multicast_memberships[i].sa = 0; + ip4_addr_set_zero(&socket_ipv4_multicast_memberships[i].if_addr); + ip4_addr_set_zero(&socket_ipv4_multicast_memberships[i].multi_addr); + + netconn_join_leave_group(sockets[s].conn, &multi_addr, &if_addr, NETCONN_LEAVE); + } + } +} +#endif /* LWIP_IGMP */ + +#if LWIP_THREAD_SAFE + +int +lwip_sendto_r(int s, const void *data, size_t size, int flags, + const struct sockaddr *to, socklen_t tolen) +{ + LWIP_API_LOCK(); + __ret = lwip_sendto(s, data, size, flags, to, tolen); + LWIP_API_UNLOCK(); +} + +int +lwip_send_r(int s, const void *data, size_t size, int flags) +{ + LWIP_API_LOCK(); + __ret = lwip_send(s, data, size, flags); + LWIP_API_UNLOCK(); +} + +int +lwip_recvfrom_r(int s, void *mem, size_t len, int flags, + struct sockaddr *from, socklen_t *fromlen) +{ + LWIP_API_LOCK(); + __ret = lwip_recvfrom(s, mem, len, flags, from, fromlen); + LWIP_API_UNLOCK(); +} + +int +lwip_recv_r(int s, void *mem, size_t len, int flags) +{ + return lwip_recvfrom_r(s, mem, len, flags, NULL, NULL); +} + +int +lwip_read_r(int s, void *mem, size_t len) +{ + return lwip_recvfrom_r(s, mem, len, 0, NULL, NULL); +} + +int +lwip_sendmsg_r(int s, const struct msghdr *msg, int flags) +{ + LWIP_API_LOCK(); + __ret = lwip_sendmsg(s, msg, flags); + LWIP_API_UNLOCK(); +} + +int +lwip_write_r(int s, const void *data, size_t size) +{ + return lwip_send_r(s, data, size, 0); +} + +int +lwip_writev_r(int s, const struct iovec *iov, int iovcnt) +{ + struct msghdr msg; + + msg.msg_name = NULL; + msg.msg_namelen = 0; + /* Hack: we have to cast via number to cast from 'const' pointer to non-const. + Blame the opengroup standard for this inconsistency. */ + msg.msg_iov = (struct iovec *)(size_t)iov; + msg.msg_iovlen = iovcnt; + msg.msg_control = NULL; + msg.msg_controllen = 0; + msg.msg_flags = 0; + return lwip_sendmsg_r(s, &msg, 0); +} + +int +lwip_connect_r(int s, const struct sockaddr *name, socklen_t namelen) +{ + LWIP_API_LOCK(); + __ret = lwip_connect(s, name, namelen); + LWIP_API_UNLOCK(); +} + +int +lwip_listen_r(int s, int backlog) +{ + LWIP_API_LOCK(); + __ret = lwip_listen(s, backlog); + LWIP_API_UNLOCK(); +} + +int +lwip_bind_r(int s, const struct sockaddr *name, socklen_t namelen) +{ + LWIP_API_LOCK(); + __ret = lwip_bind(s, name, namelen); + LWIP_API_UNLOCK(); +} + +int +lwip_accept_r(int s, struct sockaddr *addr, socklen_t *addrlen) +{ + LWIP_API_LOCK(); + __ret = lwip_accept(s, addr, addrlen); + LWIP_API_UNLOCK(); +} + +int +lwip_ioctl_r(int s, long cmd, void *argp) +{ + LWIP_API_LOCK(); + __ret = lwip_ioctl(s, cmd, argp); + LWIP_API_UNLOCK(); +} + +int +lwip_fcntl_r(int s, int cmd, int val) +{ + LWIP_API_LOCK(); + __ret = lwip_fcntl(s, cmd, val); + LWIP_API_UNLOCK(); +} + +int +lwip_setsockopt_r(int s, int level, int optname, const void *optval, socklen_t optlen) +{ + LWIP_API_LOCK(); + __ret = lwip_setsockopt(s, level, optname, optval, optlen); + LWIP_API_UNLOCK(); +} + +int +lwip_getsockopt_r(int s, int level, int optname, void *optval, socklen_t *optlen) +{ + LWIP_API_LOCK(); + __ret = lwip_getsockopt(s, level, optname, optval, optlen); + LWIP_API_UNLOCK(); +} + +int +lwip_getpeername_r(int s, struct sockaddr *name, socklen_t *namelen) +{ + LWIP_API_LOCK(); + __ret = lwip_getpeername(s, name, namelen); + LWIP_API_UNLOCK(); +} + +int +lwip_getsockname_r(int s, struct sockaddr *name, socklen_t *namelen) +{ + LWIP_API_LOCK(); + __ret = lwip_getsockname(s, name, namelen); + LWIP_API_UNLOCK(); +} + +int +lwip_close_r(int s) +{ + LWIP_API_LOCK(); + LWIP_SET_CLOSE_FLAG(); + __ret = lwip_close(s); + LWIP_API_UNLOCK(); +} + +int +lwip_shutdown_r(int s, int how) +{ + LWIP_API_LOCK(); + __ret = lwip_shutdown(s, how); + LWIP_API_UNLOCK(); +} + +#endif + +#endif /* LWIP_SOCKET */ diff --git a/components/lwip/api/tcpip.c b/components/lwip/api/tcpip.c new file mode 100755 index 000000000..f0c4c476e --- /dev/null +++ b/components/lwip/api/tcpip.c @@ -0,0 +1,569 @@ +/** + * @file + * Sequential API Main thread module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if !NO_SYS /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/priv/tcpip_priv.h" +#include "lwip/priv/api_msg.h" +#include "lwip/sys.h" +#include "lwip/memp.h" +#include "lwip/mem.h" +#include "lwip/init.h" +#include "lwip/ip.h" +#include "lwip/pbuf.h" +#include "netif/etharp.h" + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +#define TCPIP_MSG_VAR_REF(name) API_VAR_REF(name) +#define TCPIP_MSG_VAR_DECLARE(name) API_VAR_DECLARE(struct tcpip_msg, name) +#define TCPIP_MSG_VAR_ALLOC(name) API_VAR_ALLOC(struct tcpip_msg, MEMP_TCPIP_MSG_API, name) +#define TCPIP_MSG_VAR_FREE(name) API_VAR_FREE(MEMP_TCPIP_MSG_API, name) + +/* global variables */ +#ifdef PERF +uint32 g_rx_post_mbox_fail_cnt = 0; +#endif +static tcpip_init_done_fn tcpip_init_done; +static void *tcpip_init_done_arg; +static sys_mbox_t mbox; + +#if LWIP_TCPIP_CORE_LOCKING +/** The global semaphore to lock the stack. */ +sys_mutex_t lock_tcpip_core; +#endif /* LWIP_TCPIP_CORE_LOCKING */ + + +/** + * The main lwIP thread. This thread has exclusive access to lwIP core functions + * (unless access to them is not locked). Other threads communicate with this + * thread using message boxes. + * + * It also starts all the timers to make sure they are running in the right + * thread context. + * + * @param arg unused argument + */ +static void +tcpip_thread(void *arg) +{ + + + struct tcpip_msg *msg; + LWIP_UNUSED_ARG(arg); + + if (tcpip_init_done != NULL) { + tcpip_init_done(tcpip_init_done_arg); + } + + + + LOCK_TCPIP_CORE(); + while (1) { + + + /* MAIN Loop */ + UNLOCK_TCPIP_CORE(); + LWIP_TCPIP_THREAD_ALIVE(); + /* wait for a message, timeouts are processed while waiting */ + sys_timeouts_mbox_fetch(&mbox, (void **)&msg); + LOCK_TCPIP_CORE(); + + + + if (msg == NULL) { + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: invalid message: NULL\n")); + LWIP_ASSERT("tcpip_thread: invalid message", 0); + + continue; + } + + + + + switch (msg->type) { +#if !LWIP_TCPIP_CORE_LOCKING + case TCPIP_MSG_API: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: API message %p\n", (void *)msg)); + msg->msg.api.function(msg->msg.api.msg); + break; + case TCPIP_MSG_API_CALL: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: API CALL message %p\n", (void *)msg)); + msg->msg.api_call->err = msg->msg.api_call->function(msg->msg.api_call); +#if LWIP_NETCONN_SEM_PER_THREAD + sys_sem_signal(msg->msg.api_call->sem); +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + sys_sem_signal(&msg->msg.api_call->sem); +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + break; +#endif /* LWIP_TCPIP_CORE_LOCKING */ + +#if !LWIP_TCPIP_CORE_LOCKING_INPUT + case TCPIP_MSG_INPKT: + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: PACKET %p\n", (void *)msg)); + +#ifdef LWIP_ESP8266 +//#if 0 + if(msg->msg.inp.p != NULL && msg->msg.inp.netif != NULL) { +#endif + msg->msg.inp.input_fn(msg->msg.inp.p, msg->msg.inp.netif); +#ifdef LWIP_ESP8266 +//#if 0 + } +#endif + + memp_free(MEMP_TCPIP_MSG_INPKT, msg); + + break; +#endif /* LWIP_TCPIP_CORE_LOCKING_INPUT */ + +#if LWIP_TCPIP_TIMEOUT + case TCPIP_MSG_TIMEOUT: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: TIMEOUT %p\n", (void *)msg)); + sys_timeout(msg->msg.tmo.msecs, msg->msg.tmo.h, msg->msg.tmo.arg); + memp_free(MEMP_TCPIP_MSG_API, msg); + break; + case TCPIP_MSG_UNTIMEOUT: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: UNTIMEOUT %p\n", (void *)msg)); + sys_untimeout(msg->msg.tmo.h, msg->msg.tmo.arg); + memp_free(MEMP_TCPIP_MSG_API, msg); + break; +#endif /* LWIP_TCPIP_TIMEOUT */ + + case TCPIP_MSG_CALLBACK: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: CALLBACK %p\n", (void *)msg)); + msg->msg.cb.function(msg->msg.cb.ctx); + memp_free(MEMP_TCPIP_MSG_API, msg); + break; + + case TCPIP_MSG_CALLBACK_STATIC: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: CALLBACK_STATIC %p\n", (void *)msg)); + msg->msg.cb.function(msg->msg.cb.ctx); + break; + + default: + + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: invalid message: %d\n", msg->type)); + LWIP_ASSERT("tcpip_thread: invalid message", 0); + break; + } + + } +} + +/** + * Pass a received packet to tcpip_thread for input processing + * + * @param p the received packet + * @param inp the network interface on which the packet was received + * @param input_fn input function to call + */ +err_t +tcpip_inpkt(struct pbuf *p, struct netif *inp, netif_input_fn input_fn) +{ +#if LWIP_TCPIP_CORE_LOCKING_INPUT + err_t ret; + LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_inpkt: PACKET %p/%p\n", (void *)p, (void *)inp)); + LOCK_TCPIP_CORE(); + ret = input_fn(p, inp); + UNLOCK_TCPIP_CORE(); + return ret; +#else /* LWIP_TCPIP_CORE_LOCKING_INPUT */ + struct tcpip_msg *msg; + + if (!sys_mbox_valid_val(mbox)) { + return ERR_VAL; + } + msg = (struct tcpip_msg *)memp_malloc(MEMP_TCPIP_MSG_INPKT); + if (msg == NULL) { + return ERR_MEM; + } + + msg->type = TCPIP_MSG_INPKT; + msg->msg.inp.p = p; + msg->msg.inp.netif = inp; + msg->msg.inp.input_fn = input_fn; + if (sys_mbox_trypost(&mbox, msg) != ERR_OK) { +#ifdef PERF + g_rx_post_mbox_fail_cnt ++; +#endif + memp_free(MEMP_TCPIP_MSG_INPKT, msg); + return ERR_MEM; + } + return ERR_OK; +#endif /* LWIP_TCPIP_CORE_LOCKING_INPUT */ +} + +/** + * Pass a received packet to tcpip_thread for input processing with + * ethernet_input or ip_input + * + * @param p the received packet, p->payload pointing to the Ethernet header or + * to an IP header (if inp doesn't have NETIF_FLAG_ETHARP or + * NETIF_FLAG_ETHERNET flags) + * @param inp the network interface on which the packet was received + */ +err_t +tcpip_input(struct pbuf *p, struct netif *inp) +{ +#if LWIP_ETHERNET + if (inp->flags & (NETIF_FLAG_ETHARP | NETIF_FLAG_ETHERNET)) { + return tcpip_inpkt(p, inp, ethernet_input); + } else +#endif /* LWIP_ETHERNET */ + return tcpip_inpkt(p, inp, ip_input); +} + +/** + * Call a specific function in the thread context of + * tcpip_thread for easy access synchronization. + * A function called in that way may access lwIP core code + * without fearing concurrent access. + * + * @param f the function to call + * @param ctx parameter passed to f + * @param block 1 to block until the request is posted, 0 to non-blocking mode + * @return ERR_OK if the function was called, another err_t if not + */ +err_t +tcpip_callback_with_block(tcpip_callback_fn function, void *ctx, u8_t block) +{ + struct tcpip_msg *msg; + + if (sys_mbox_valid_val(mbox)) { + msg = (struct tcpip_msg *)memp_malloc(MEMP_TCPIP_MSG_API); + if (msg == NULL) { + return ERR_MEM; + } + + msg->type = TCPIP_MSG_CALLBACK; + msg->msg.cb.function = function; + msg->msg.cb.ctx = ctx; + if (block) { + sys_mbox_post(&mbox, msg); + } else { + if (sys_mbox_trypost(&mbox, msg) != ERR_OK) { + memp_free(MEMP_TCPIP_MSG_API, msg); + return ERR_MEM; + } + } + return ERR_OK; + } + return ERR_VAL; +} + +#if LWIP_TCPIP_TIMEOUT +/** + * call sys_timeout in tcpip_thread + * + * @param msec time in milliseconds for timeout + * @param h function to be called on timeout + * @param arg argument to pass to timeout function h + * @return ERR_MEM on memory error, ERR_OK otherwise + */ +err_t +tcpip_timeout(u32_t msecs, sys_timeout_handler h, void *arg) +{ + struct tcpip_msg *msg; + + if (sys_mbox_valid_val(mbox)) { + msg = (struct tcpip_msg *)memp_malloc(MEMP_TCPIP_MSG_API); + if (msg == NULL) { + return ERR_MEM; + } + + msg->type = TCPIP_MSG_TIMEOUT; + msg->msg.tmo.msecs = msecs; + msg->msg.tmo.h = h; + msg->msg.tmo.arg = arg; + sys_mbox_post(&mbox, msg); + return ERR_OK; + } + return ERR_VAL; +} + +/** + * call sys_untimeout in tcpip_thread + * + * @param msec time in milliseconds for timeout + * @param h function to be called on timeout + * @param arg argument to pass to timeout function h + * @return ERR_MEM on memory error, ERR_OK otherwise + */ +err_t +tcpip_untimeout(sys_timeout_handler h, void *arg) +{ + struct tcpip_msg *msg; + + if (sys_mbox_valid_val(mbox)) { + msg = (struct tcpip_msg *)memp_malloc(MEMP_TCPIP_MSG_API); + if (msg == NULL) { + return ERR_MEM; + } + + msg->type = TCPIP_MSG_UNTIMEOUT; + msg->msg.tmo.h = h; + msg->msg.tmo.arg = arg; + sys_mbox_post(&mbox, msg); + return ERR_OK; + } + return ERR_VAL; +} +#endif /* LWIP_TCPIP_TIMEOUT */ + + +#if !LWIP_TCPIP_CORE_LOCKING +/** + * Generic way to dispatch an API message in TCPIP thread. + * + * @param fn function to be called from TCPIP thread + * @param apimsg argument to API function + * @param sem semaphore to wait on + * @return ERR_OK if the function was called, another err_t if not + */ +err_t +tcpip_send_api_msg(tcpip_callback_fn fn, void *apimsg, sys_sem_t* sem) +{ + LWIP_ASSERT("semaphore not initialized", sys_sem_valid(sem)); + + if (sys_mbox_valid_val(mbox)) { + TCPIP_MSG_VAR_DECLARE(msg); + + TCPIP_MSG_VAR_ALLOC(msg); + TCPIP_MSG_VAR_REF(msg).type = TCPIP_MSG_API; + TCPIP_MSG_VAR_REF(msg).msg.api.function = fn; + TCPIP_MSG_VAR_REF(msg).msg.api.msg = apimsg; + sys_mbox_post(&mbox, &TCPIP_MSG_VAR_REF(msg)); + sys_arch_sem_wait(sem, 0); + TCPIP_MSG_VAR_FREE(msg); + + return ERR_OK; + } + return ERR_VAL; +} +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + +err_t tcpip_api_call(tcpip_api_call_fn fn, struct tcpip_api_call *call) +{ +#if LWIP_TCPIP_CORE_LOCKING + err_t err; + LOCK_TCPIP_CORE(); + err = fn(call); + UNLOCK_TCPIP_CORE(); + return err; +#else + if (sys_mbox_valid_val(mbox)) { + TCPIP_MSG_VAR_DECLARE(msg); + err_t err; + +#if LWIP_NETCONN_SEM_PER_THREAD + call->sem = LWIP_NETCONN_THREAD_SEM_GET(); +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + err = sys_sem_new(&call->sem, 0); + if (err != ERR_OK) { + return err; + } +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + + TCPIP_MSG_VAR_ALLOC(msg); + TCPIP_MSG_VAR_REF(msg).type = TCPIP_MSG_API_CALL; + TCPIP_MSG_VAR_REF(msg).msg.api_call = call; + TCPIP_MSG_VAR_REF(msg).msg.api_call->function = fn; + sys_mbox_post(&mbox, &TCPIP_MSG_VAR_REF(msg)); +#if LWIP_NETCONN_SEM_PER_THREAD + sys_arch_sem_wait(call->sem, 0); +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + sys_arch_sem_wait(&call->sem, 0); + sys_sem_free(&call->sem); +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + TCPIP_MSG_VAR_FREE(msg); + return ERR_OK; + } + return ERR_VAL; +#endif +} + +/** + * Allocate a structure for a static callback message and initialize it. + * This is intended to be used to send "static" messages from interrupt context. + * + * @param function the function to call + * @param ctx parameter passed to function + * @return a struct pointer to pass to tcpip_trycallback(). + */ +struct tcpip_callback_msg* +tcpip_callbackmsg_new(tcpip_callback_fn function, void *ctx) +{ + struct tcpip_msg *msg = (struct tcpip_msg *)memp_malloc(MEMP_TCPIP_MSG_API); + if (msg == NULL) { + return NULL; + } + msg->type = TCPIP_MSG_CALLBACK_STATIC; + msg->msg.cb.function = function; + msg->msg.cb.ctx = ctx; + return (struct tcpip_callback_msg*)msg; +} + +/** + * Free a callback message allocated by tcpip_callbackmsg_new(). + * + * @param msg the message to free + */ +void +tcpip_callbackmsg_delete(struct tcpip_callback_msg* msg) +{ + memp_free(MEMP_TCPIP_MSG_API, msg); +} + +/** + * Try to post a callback-message to the tcpip_thread mbox + * This is intended to be used to send "static" messages from interrupt context. + * + * @param msg pointer to the message to post + * @return sys_mbox_trypost() return code + */ +err_t +tcpip_trycallback(struct tcpip_callback_msg* msg) +{ + if (!sys_mbox_valid_val(mbox)) { + return ERR_VAL; + } + return sys_mbox_trypost(&mbox, msg); +} + +/** + * Initialize this module: + * - initialize all sub modules + * - start the tcpip_thread + * + * @param initfunc a function to call when tcpip_thread is running and finished initializing + * @param arg argument to pass to initfunc + */ +void +tcpip_init(tcpip_init_done_fn initfunc, void *arg) +{ + + lwip_init(); + + tcpip_init_done = initfunc; + tcpip_init_done_arg = arg; + if (sys_mbox_new(&mbox, TCPIP_MBOX_SIZE) != ERR_OK) { + LWIP_ASSERT("failed to create tcpip_thread mbox", 0); + } +#if LWIP_TCPIP_CORE_LOCKING + if (sys_mutex_new(&lock_tcpip_core) != ERR_OK) { + LWIP_ASSERT("failed to create lock_tcpip_core", 0); + } +#endif /* LWIP_TCPIP_CORE_LOCKING */ + + +#ifdef LWIP_ESP8266 + sys_thread_t xLwipTaskHandle = sys_thread_new(TCPIP_THREAD_NAME + , tcpip_thread, NULL, TCPIP_THREAD_STACKSIZE, TCPIP_THREAD_PRIO); + + printf("tcpip_task_hdlxxx : %x, prio:%d,stack:%d\n", + (u32_t)xLwipTaskHandle,TCPIP_THREAD_PRIO,TCPIP_THREAD_STACKSIZE); +#else + sys_thread_new(TCPIP_THREAD_NAME, tcpip_thread, NULL, TCPIP_THREAD_STACKSIZE, TCPIP_THREAD_PRIO); +#endif + +} + +/** + * Simple callback function used with tcpip_callback to free a pbuf + * (pbuf_free has a wrong signature for tcpip_callback) + * + * @param p The pbuf (chain) to be dereferenced. + */ +static void +pbuf_free_int(void *p) +{ + struct pbuf *q = (struct pbuf *)p; + pbuf_free(q); +} + +/** + * A simple wrapper function that allows you to free a pbuf from interrupt context. + * + * @param p The pbuf (chain) to be dereferenced. + * @return ERR_OK if callback could be enqueued, an err_t if not + */ +err_t +pbuf_free_callback(struct pbuf *p) +{ + return tcpip_callback_with_block(pbuf_free_int, p, 0); +} + +/** + * A simple wrapper function that allows you to free heap memory from + * interrupt context. + * + * @param m the heap memory to free + * @return ERR_OK if callback could be enqueued, an err_t if not + */ + +#ifdef LWIP_ESP8266 +//#if 0 +static void mem_free_local(void *arg) +{ + mem_free(arg); +} +err_t mem_free_callback(void *m) +{ + return tcpip_callback_with_block(mem_free_local, m, 0); + +#else +err_t mem_free_callback(void *m) +{ +#endif + + return tcpip_callback_with_block(mem_free, m, 0); +} + +#endif /* !NO_SYS */ diff --git a/components/lwip/apps/dhcpserver.c b/components/lwip/apps/dhcpserver.c new file mode 100644 index 000000000..3b9795c5a --- /dev/null +++ b/components/lwip/apps/dhcpserver.c @@ -0,0 +1,2485 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +//#include "esp_common.h" +#include +#include +#include "lwip/inet.h" +#include "lwip/err.h" +#include "lwip/pbuf.h" +#include "lwip/udp.h" +#include "lwip/mem.h" +#include "lwip/ip_addr.h" +#include "apps/dhcpserver.h" + +#include "tcpip_adapter.h" + +#ifdef LWIP_ESP8266 + +enum dyc_dhcps_flags{ + DHCPS_STARTED = 0x00, + DHCPS_STOP = 0x01, + _END +} DhcpsFlags = DHCPS_STOP; + +#define DHCPS_MAX_LEASE 0x64 +#define BOOTP_BROADCAST 0x8000 + +#define DHCP_REQUEST 1 +#define DHCP_REPLY 2 +#define DHCP_HTYPE_ETHERNET 1 +#define DHCP_HLEN_ETHERNET 6 +#define DHCP_MSG_LEN 236 + +#define DHCPS_SERVER_PORT 67 +#define DHCPS_CLIENT_PORT 68 + +#define DHCPDISCOVER 1 +#define DHCPOFFER 2 +#define DHCPREQUEST 3 +#define DHCPDECLINE 4 +#define DHCPACK 5 +#define DHCPNAK 6 +#define DHCPRELEASE 7 + +#define DHCP_OPTION_SUBNET_MASK 1 +#define DHCP_OPTION_ROUTER 3 +#define DHCP_OPTION_DNS_SERVER 6 +#define DHCP_OPTION_REQ_IPADDR 50 +#define DHCP_OPTION_LEASE_TIME 51 +#define DHCP_OPTION_MSG_TYPE 53 +#define DHCP_OPTION_SERVER_ID 54 +#define DHCP_OPTION_INTERFACE_MTU 26 +#define DHCP_OPTION_PERFORM_ROUTER_DISCOVERY 31 +#define DHCP_OPTION_BROADCAST_ADDRESS 28 +#define DHCP_OPTION_REQ_LIST 55 +#define DHCP_OPTION_END 255 + +//#define USE_CLASS_B_NET 1 +#define DHCPS_DEBUG 0 +#define DHCPS_LOG printf + +#define DYC_DHCP_CRASH //os_printf + + +#define MAX_STATION_NUM 8 + +#define DHCPS_STATE_OFFER 1 +#define DHCPS_STATE_DECLINE 2 +#define DHCPS_STATE_ACK 3 +#define DHCPS_STATE_NAK 4 +#define DHCPS_STATE_IDLE 5 +#define DHCPS_STATE_RELEASE 6 + + + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +//////////////////////////////////////////////////////////////////////////////////// +//static const uint8_t xid[4] = {0xad, 0xde, 0x12, 0x23}; +//static u8_t old_xid[4] = {0}; +static const u32_t magic_cookie = 0x63538263; +//static const u32_t magic_cookie = 0x63538263; +//static const char magic_cookie[] = {0x63,0x82,0x53,0x63}; +//static const u32_t magic_cookie = 0x63538263; +//static const u32_t magic_cookie_temp = 0x63538263; + +/* +ip_2_ip4(ipaddr) +IP_IS_V6(dest) +IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4) +*/ + + +static struct udp_pcb *pcb_dhcps = NULL; +static ip4_addr_t broadcast_dhcps; +static ip4_addr_t server_address; +static ip4_addr_t client_address; //added +static ip4_addr_t client_address_plus; + +static struct dhcps_lease dhcps_lease; +//static bool dhcps_lease_flag = true; +static list_node *plist = NULL; +static u8_t offer = 0xFF; +static bool renew = false; +#define DHCPS_LEASE_TIME_DEF (120) +u32_t dhcps_lease_time = DHCPS_LEASE_TIME_DEF; //minute + + + +static enum dyc_dhcps_flags get_dhcps_status(void ) +{ + return DhcpsFlags; +} +/****************************************************************************** + * FunctionName : node_insert_to_list + * Description : insert the node to the list + * Parameters : arg -- Additional argument to pass to the callback function + * Returns : none +*******************************************************************************/ +void node_insert_to_list(list_node **phead, list_node* pinsert) +{ + list_node *plist = NULL; + struct dhcps_pool *pdhcps_pool = NULL; + struct dhcps_pool *pdhcps_node = NULL; + if (*phead == NULL) + *phead = pinsert; + else { + plist = *phead; + pdhcps_node = pinsert->pnode; + pdhcps_pool = plist->pnode; + + if(pdhcps_node->ip.addr < pdhcps_pool->ip.addr) { + pinsert->pnext = plist; + *phead = pinsert; + } else { + while (plist->pnext != NULL) { + pdhcps_pool = plist->pnext->pnode; + if (pdhcps_node->ip.addr < pdhcps_pool->ip.addr) { + pinsert->pnext = plist->pnext; + plist->pnext = pinsert; + break; + } + plist = plist->pnext; + } + + if(plist->pnext == NULL) { + plist->pnext = pinsert; + } + } + } +// pinsert->pnext = NULL; +} + +/****************************************************************************** + * FunctionName : node_delete_from_list + * Description : remove the node from list + * Parameters : arg -- Additional argument to pass to the callback function + * Returns : none +*******************************************************************************/ +void node_remove_from_list(list_node **phead, list_node* pdelete) +{ + list_node *plist = NULL; + + plist = *phead; + if (plist == NULL){ + *phead = NULL; + } else { + if (plist == pdelete){ + *phead = plist->pnext; + pdelete->pnext = NULL; + } else { + while (plist != NULL) { + if (plist->pnext == pdelete){ + plist->pnext = pdelete->pnext; + pdelete->pnext = NULL; + } + plist = plist->pnext; + } + } + } +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ��DHCP msg��Ϣ�ṹ���������� + * + * @param optptr -- DHCP msg��Ϣλ�� + * @param type -- Ҫ��ӵ�����option + * + * @return uint8_t* ����DHCP msgƫ�Ƶ�ַ + */ +/////////////////////////////////////////////////////////////////////////////////// +static u8_t* add_msg_type(u8_t *optptr, u8_t type) +{ + *optptr++ = DHCP_OPTION_MSG_TYPE; + *optptr++ = 1; + *optptr++ = type; + return optptr; +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ��DHCP msg�ṹ������offerӦ������ + * + * @param optptr -- DHCP msg��Ϣλ�� + * + * @return uint8_t* ����DHCP msgƫ�Ƶ�ַ + */ +/////////////////////////////////////////////////////////////////////////////////// +static u8_t* add_offer_options(u8_t *optptr) +{ + ip4_addr_t ipadd; + + ipadd.addr = *( (u32_t *) &server_address); + +#ifdef USE_CLASS_B_NET + *optptr++ = DHCP_OPTION_SUBNET_MASK; + *optptr++ = 4; //length + *optptr++ = 255; + *optptr++ = 240; + *optptr++ = 0; + *optptr++ = 0; +#else + *optptr++ = DHCP_OPTION_SUBNET_MASK; + *optptr++ = 4; + *optptr++ = 255; + *optptr++ = 255; + *optptr++ = 255; + *optptr++ = 0; +#endif + + *optptr++ = DHCP_OPTION_LEASE_TIME; + *optptr++ = 4; + *optptr++ = ((DHCPS_LEASE_TIMER * 60) >> 24) & 0xFF; + *optptr++ = ((DHCPS_LEASE_TIMER * 60) >> 16) & 0xFF; + *optptr++ = ((DHCPS_LEASE_TIMER * 60) >> 8) & 0xFF; + *optptr++ = ((DHCPS_LEASE_TIMER * 60) >> 0) & 0xFF; + + *optptr++ = DHCP_OPTION_SERVER_ID; + *optptr++ = 4; + *optptr++ = ip4_addr1( &ipadd); + *optptr++ = ip4_addr2( &ipadd); + *optptr++ = ip4_addr3( &ipadd); + *optptr++ = ip4_addr4( &ipadd); + + if (dhcps_router_enabled(offer)){ + struct ip_info if_ip; + //bzero(&if_ip, sizeof(struct ip_info)); + memset(&if_ip ,0x00, sizeof(struct ip_info)); + + tcpip_adapter_get_ip_info(WIFI_IF_AP, &if_ip); + + *optptr++ = DHCP_OPTION_ROUTER; + *optptr++ = 4; + *optptr++ = ip4_addr1( &if_ip.gw); + *optptr++ = ip4_addr2( &if_ip.gw); + *optptr++ = ip4_addr3( &if_ip.gw); + *optptr++ = ip4_addr4( &if_ip.gw); + } + +#ifdef USE_DNS + *optptr++ = DHCP_OPTION_DNS_SERVER; + *optptr++ = 4; + *optptr++ = ip4_addr1( &ipadd); + *optptr++ = ip4_addr2( &ipadd); + *optptr++ = ip4_addr3( &ipadd); + *optptr++ = ip4_addr4( &ipadd); +#endif + +#ifdef CLASS_B_NET + *optptr++ = DHCP_OPTION_BROADCAST_ADDRESS; + *optptr++ = 4; + *optptr++ = ip4_addr1( &ipadd); + *optptr++ = 255; + *optptr++ = 255; + *optptr++ = 255; +#else + *optptr++ = DHCP_OPTION_BROADCAST_ADDRESS; + *optptr++ = 4; + *optptr++ = ip4_addr1( &ipadd); + *optptr++ = ip4_addr2( &ipadd); + *optptr++ = ip4_addr3( &ipadd); + *optptr++ = 255; +#endif + + *optptr++ = DHCP_OPTION_INTERFACE_MTU; + *optptr++ = 2; +#ifdef CLASS_B_NET + *optptr++ = 0x05; + *optptr++ = 0xdc; +#else + *optptr++ = 0x02; + *optptr++ = 0x40; +#endif + + *optptr++ = DHCP_OPTION_PERFORM_ROUTER_DISCOVERY; + *optptr++ = 1; + *optptr++ = 0x00; + + *optptr++ = 43; + *optptr++ = 6; + + *optptr++ = 0x01; + *optptr++ = 4; + *optptr++ = 0x00; + *optptr++ = 0x00; + *optptr++ = 0x00; + *optptr++ = 0x02; + + return optptr; +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ��DHCP msg�ṹ����ӽ����־���� + * + * @param optptr -- DHCP msg��Ϣλ�� + * + * @return uint8_t* ����DHCP msgƫ�Ƶ�ַ + */ +/////////////////////////////////////////////////////////////////////////////////// +static u8_t* add_end(u8_t *optptr) +{ + + *optptr++ = DHCP_OPTION_END; + return optptr; +} +/////////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////////// +static void create_msg(struct dhcps_msg *m) +{ + ip4_addr_t client; + + + client.addr = *( (uint32_t *) &client_address); + + m->op = DHCP_REPLY; + + m->htype = DHCP_HTYPE_ETHERNET; + + m->hlen = 6; + + m->hops = 0; +// os_memcpy((char *) xid, (char *) m->xid, sizeof(m->xid)); + m->secs = 0; + m->flags = htons(BOOTP_BROADCAST); + + memcpy((char *) m->yiaddr, (char *) &client.addr, sizeof(m->yiaddr)); + + memset((char *) m->ciaddr, 0, sizeof(m->ciaddr)); + + memset((char *) m->siaddr, 0, sizeof(m->siaddr)); + + memset((char *) m->giaddr, 0, sizeof(m->giaddr)); + + memset((char *) m->sname, 0, sizeof(m->sname)); + + memset((char *) m->file, 0, sizeof(m->file)); + + memset((char *) m->options, 0, sizeof(m->options)); + +// u32_t temp = 0x63538263; + // u8 *log_temp = (u8 *)&temp; +//DYC_DHCP_CRASH("l:%0x,%0x,%0x,%0x,",log_temp[0],log_temp[1],log_temp[2],log_temp[3]); + +u32_t magic_cookie_temp = magic_cookie; + +//extern bool system_get_string_from_flash(void *flash_str, void* ram_str,uint8 ram_str_len); +//system_get_string_from_flash((void *)(&magic_cookie), (void *)(&magic_cookie_temp),4); +//os_printf("ck_tmp3:%08X\n",magic_cookie_temp); + + //memcpy((char *) m->options, &magic_cookie, sizeof(magic_cookie)); + memcpy((char *) m->options, &magic_cookie_temp, sizeof(magic_cookie_temp)); +// DYC_DHCP_CRASH("m,"); +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ����һ��OFFER + * + * @param -- m ָ����Ҫ���͵�DHCP msg���� + */ +/////////////////////////////////////////////////////////////////////////////////// +static void send_offer(struct dhcps_msg *m) +{ + u8_t *end; + struct pbuf *p, *q; + u8_t *data; + u16_t cnt=0; + u16_t i; + err_t SendOffer_err_t; + create_msg(m); + + end = add_msg_type(&m->options[4], DHCPOFFER); + end = add_offer_options(end); + end = add_end(end); + + p = pbuf_alloc(PBUF_TRANSPORT, sizeof(struct dhcps_msg), PBUF_RAM); +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_offer>>p->ref = %d\n", p->ref); +#endif + if(p != NULL){ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_offer>>pbuf_alloc succeed\n"); + DHCPS_LOG("dhcps: send_offer>>p->tot_len = %d\n", p->tot_len); + DHCPS_LOG("dhcps: send_offer>>p->len = %d\n", p->len); +#endif + q = p; + while(q != NULL){ + data = (u8_t *)q->payload; + for(i=0; ilen; i++) + { + data[i] = ((u8_t *) m)[cnt++]; +#if DHCPS_DEBUG + DHCPS_LOG("%02x ",data[i]); + if((i+1)%16 == 0){ + DHCPS_LOG("\n"); + } +#endif + } + + q = q->next; + } + }else{ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_offer>>pbuf_alloc failed\n"); +#endif + return; + } + + ip_addr_t ip_temp = IPADDR4_INIT(0x0); + ip4_addr_set(ip_2_ip4(&ip_temp), &broadcast_dhcps); + SendOffer_err_t = udp_sendto( pcb_dhcps, p, &ip_temp, DHCPS_CLIENT_PORT ); +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_offer>>udp_sendto result %x\n",SendOffer_err_t); +#endif + if(p->ref != 0){ +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_offer>>free pbuf\n"); +#endif + pbuf_free(p); + } +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ����һ��NAK��Ϣ + * + * @param m ָ����Ҫ���͵�DHCP msg���� + */ +/////////////////////////////////////////////////////////////////////////////////// +static void send_nak(struct dhcps_msg *m) +{ + u8_t *end; + struct pbuf *p, *q; + u8_t *data; + u16_t cnt=0; + u16_t i; + err_t SendNak_err_t; + create_msg(m); + + end = add_msg_type(&m->options[4], DHCPNAK); + end = add_end(end); + + p = pbuf_alloc(PBUF_TRANSPORT, sizeof(struct dhcps_msg), PBUF_RAM); +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_nak>>p->ref = %d\n", p->ref); +#endif + if(p != NULL){ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_nak>>pbuf_alloc succeed\n"); + DHCPS_LOG("dhcps: send_nak>>p->tot_len = %d\n", p->tot_len); + DHCPS_LOG("dhcps: send_nak>>p->len = %d\n", p->len); +#endif + q = p; + while(q != NULL){ + data = (u8_t *)q->payload; + for(i=0; ilen; i++) + { + data[i] = ((u8_t *) m)[cnt++]; +#if DHCPS_DEBUG + DHCPS_LOG("%02x ",data[i]); + if((i+1)%16 == 0){ + DHCPS_LOG("\n"); + } +#endif + } + + q = q->next; + } + }else{ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_nak>>pbuf_alloc failed\n"); +#endif + return; + } + + ip_addr_t ip_temp = IPADDR4_INIT(0x0); + ip4_addr_set(ip_2_ip4(&ip_temp), &broadcast_dhcps); + SendNak_err_t = udp_sendto( pcb_dhcps, p, &ip_temp, DHCPS_CLIENT_PORT ); +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_nak>>udp_sendto result %x\n",SendNak_err_t); +#endif + if(p->ref != 0){ +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_nak>>free pbuf\n"); +#endif + pbuf_free(p); + } +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ����һ��ACK��DHCP�ͻ��� + * + * @param m ָ����Ҫ���͵�DHCP msg���� + */ +/////////////////////////////////////////////////////////////////////////////////// +static void send_ack(struct dhcps_msg *m) +{ + u8_t *end; + struct pbuf *p, *q; + u8_t *data; + u16_t cnt=0; + u16_t i; + err_t SendAck_err_t; + create_msg(m); + + end = add_msg_type(&m->options[4], DHCPACK); + end = add_offer_options(end); + end = add_end(end); + + p = pbuf_alloc(PBUF_TRANSPORT, sizeof(struct dhcps_msg), PBUF_RAM); +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_ack>>p->ref = %d\n", p->ref); +#endif + if(p != NULL){ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_ack>>pbuf_alloc succeed\n"); + DHCPS_LOG("dhcps: send_ack>>p->tot_len = %d\n", p->tot_len); + DHCPS_LOG("dhcps: send_ack>>p->len = %d\n", p->len); +#endif + q = p; + while(q != NULL){ + data = (u8_t *)q->payload; + for(i=0; ilen; i++) + { + data[i] = ((u8_t *) m)[cnt++]; +#if DHCPS_DEBUG + DHCPS_LOG("%02x ",data[i]); + if((i+1)%16 == 0){ + DHCPS_LOG("\n"); + } +#endif + } + + q = q->next; + } + }else{ + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_ack>>pbuf_alloc failed\n"); +#endif + return; + } + + ip_addr_t ip_temp = IPADDR4_INIT(0x0); + ip4_addr_set(ip_2_ip4(&ip_temp), &broadcast_dhcps); + SendAck_err_t = udp_sendto( pcb_dhcps, p, &ip_temp, DHCPS_CLIENT_PORT ); +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: send_ack>>udp_sendto result %x\n",SendAck_err_t); +#endif + + if(p->ref != 0){ +#if DHCPS_DEBUG + DHCPS_LOG("udhcp: send_ack>>free pbuf\n"); +#endif + pbuf_free(p); + } +} +/////////////////////////////////////////////////////////////////////////////////// +/* + * ����DHCP�ͻ��˷�����DHCP����������Ϣ�����Բ�ͬ��DHCP��������������Ӧ��Ӧ�� + * + * @param optptr DHCP msg��������� + * @param len ��������Ĵ��?(byte) + * + * @return uint8_t ���ش�����DHCP Server״ֵ̬ + */ +/////////////////////////////////////////////////////////////////////////////////// +static u8_t parse_options(u8_t *optptr, s16_t len) +{ + ip4_addr_t client; + bool is_dhcp_parse_end = false; + struct dhcps_state s; + + client.addr = *( (uint32_t *) &client_address);// Ҫ�����DHCP�ͻ��˵�IP + + u8_t *end = optptr + len; + u16_t type = 0; + + s.state = DHCPS_STATE_IDLE; + + while (optptr < end) { +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: (s16_t)*optptr = %d\n", (s16_t)*optptr); +#endif + switch ((s16_t) *optptr) { + + case DHCP_OPTION_MSG_TYPE: //53 + type = *(optptr + 2); + break; + + case DHCP_OPTION_REQ_IPADDR://50 + if( memcmp( (char *) &client.addr, (char *) optptr+2,4)==0 ) { +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCP_OPTION_REQ_IPADDR = 0 ok\n"); +#endif + s.state = DHCPS_STATE_ACK; + }else { +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCP_OPTION_REQ_IPADDR != 0 err\n"); +#endif + s.state = DHCPS_STATE_NAK; + } + break; + case DHCP_OPTION_END: + { + is_dhcp_parse_end = true; + } + break; + } + + if(is_dhcp_parse_end){ + break; + } + + optptr += optptr[1] + 2; + } + + switch (type){ + + case DHCPDISCOVER://1 + s.state = DHCPS_STATE_OFFER; +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCPD_STATE_OFFER\n"); +#endif + break; + + case DHCPREQUEST://3 + if ( !(s.state == DHCPS_STATE_ACK || s.state == DHCPS_STATE_NAK) ) { + if(renew == true) { + s.state = DHCPS_STATE_ACK; + } else { + s.state = DHCPS_STATE_NAK; + } +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCPD_STATE_NAK\n"); +#endif + } + break; + + case DHCPDECLINE://4 + s.state = DHCPS_STATE_IDLE; +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCPD_STATE_IDLE\n"); +#endif + break; + + case DHCPRELEASE://7 + s.state = DHCPS_STATE_RELEASE; +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: DHCPD_STATE_IDLE\n"); +#endif + break; + } +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: return s.state = %d\n", s.state); +#endif + return s.state; +} +/////////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////////// +static s16_t parse_msg(struct dhcps_msg *m, u16_t len) +{ + +//u32 magic_cookie_temp = magic_cookie; +//extern bool system_get_string_from_flash(void *flash_str, void* ram_str,uint8 ram_str_len); +//system_get_string_from_flash((void *)(&magic_cookie), (void *)(&magic_cookie_temp),4); +//os_printf("ck_tmp4:%08X\n",magic_cookie_temp); + + if(memcmp((char *)m->options, + &magic_cookie, + sizeof(magic_cookie)) == 0){ +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: len = %d\n", len); +#endif + + ip4_addr_t addr_tmp; +// memcpy((char *)old_xid, (char *)m->xid, sizeof(m->xid)); + + struct dhcps_pool *pdhcps_pool = NULL; + list_node *pnode = NULL; + list_node *pback_node = NULL; + ip4_addr_t first_address; + bool flag = false; + +// POOL_START: + first_address.addr = dhcps_lease.start_ip.addr; + client_address.addr = client_address_plus.addr; + renew = false; +// addr_tmp.addr = htonl(client_address_plus.addr); +// addr_tmp.addr++; +// client_address_plus.addr = htonl(addr_tmp.addr); + for (pback_node = plist; pback_node != NULL;pback_node = pback_node->pnext) { + pdhcps_pool = pback_node->pnode; + if (memcmp(pdhcps_pool->mac, m->chaddr, sizeof(pdhcps_pool->mac)) == 0){ +// os_printf("the same device request ip\n"); + if (memcmp(&pdhcps_pool->ip.addr, m->ciaddr, sizeof(pdhcps_pool->ip.addr)) == 0) { + renew = true; + } + client_address.addr = pdhcps_pool->ip.addr; + pdhcps_pool->lease_timer = DHCPS_LEASE_TIMER; + pnode = pback_node; + goto POOL_CHECK; + } else if (pdhcps_pool->ip.addr == client_address_plus.addr){ +// client_address.addr = client_address_plus.addr; +// os_printf("the ip addr has been request\n"); + addr_tmp.addr = htonl(client_address_plus.addr); + addr_tmp.addr++; + client_address_plus.addr = htonl(addr_tmp.addr); + client_address.addr = client_address_plus.addr; + } + + if(flag == false) { // search the fisrt unused ip + if(first_address.addr < pdhcps_pool->ip.addr) { + flag = true; + } else { + addr_tmp.addr = htonl(first_address.addr); + addr_tmp.addr++; + first_address.addr = htonl(addr_tmp.addr); + } + } + } + if (client_address_plus.addr > dhcps_lease.end_ip.addr) { + client_address.addr = first_address.addr; + } + if (client_address.addr > dhcps_lease.end_ip.addr) { + client_address_plus.addr = dhcps_lease.start_ip.addr; + pdhcps_pool = NULL; + pnode = NULL; + } else { + pdhcps_pool = (struct dhcps_pool *)malloc(sizeof(struct dhcps_pool)); + memset(pdhcps_pool ,0x00 ,sizeof(struct dhcps_pool)); + + pdhcps_pool->ip.addr = client_address.addr; + memcpy(pdhcps_pool->mac, m->chaddr, sizeof(pdhcps_pool->mac)); + pdhcps_pool->lease_timer = DHCPS_LEASE_TIMER; + pnode = (list_node *)malloc(sizeof(list_node )); + memset(pnode ,0x00 ,sizeof(list_node)); + + pnode->pnode = pdhcps_pool; + pnode->pnext = NULL; + node_insert_to_list(&plist,pnode); + if (client_address.addr == dhcps_lease.end_ip.addr) { + client_address_plus.addr = dhcps_lease.start_ip.addr; + } else { + addr_tmp.addr = htonl(client_address.addr); + addr_tmp.addr++; + client_address_plus.addr = htonl(addr_tmp.addr); + } + } + + POOL_CHECK: + if ((client_address.addr > dhcps_lease.end_ip.addr) || (ip4_addr_isany(&client_address))){ + if(pnode != NULL) { + node_remove_from_list(&plist,pnode); + free(pnode); + pnode = NULL; + } + + if (pdhcps_pool != NULL) { + free(pdhcps_pool); + pdhcps_pool = NULL; + } +// client_address_plus.addr = dhcps_lease.start_ip.addr; + return 4; + } + + s16_t ret = parse_options(&m->options[4], len);; + + if(ret == DHCPS_STATE_RELEASE) { + if(pnode != NULL) { + node_remove_from_list(&plist,pnode); + free(pnode); + pnode = NULL; + } + + if (pdhcps_pool != NULL) { + free(pdhcps_pool); + pdhcps_pool = NULL; + } + memset(&client_address,0x0,sizeof(client_address)); + } + +//TO_DO , set (ap-> sta) ip_addr no use. +//if ( tcpip_dep_set_ip_info(STATION_IF, struct ip_info *if_ip) == false ) + //return 0; +//if (wifi_softap_set_station_info(m->chaddr, &client_address) == false) { + // return 0; + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: xid changed\n"); + DHCPS_LOG("dhcps: client_address.addr = %x\n", client_address.addr); +#endif + return ret; + } + return 0; +} + + +static void handle_dhcp(void *arg, + struct udp_pcb *pcb, + struct pbuf *p, + const ip_addr_t *addr, + u16_t port) +{ + struct dhcps_msg *pmsg_dhcps = NULL; + s16_t tlen; + u16_t i; + u16_t dhcps_msg_cnt=0; + u8_t *p_dhcps_msg = NULL; + u8_t *data; + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> receive a packet\n"); +#endif + if (p==NULL) return; + + pmsg_dhcps = (struct dhcps_msg *)malloc(sizeof(struct dhcps_msg)); + memset(pmsg_dhcps ,0x00 ,sizeof(struct dhcps_msg)); + + if (NULL == pmsg_dhcps){ + pbuf_free(p); + return; + } + p_dhcps_msg = (u8_t *)pmsg_dhcps; + tlen = p->tot_len; + data = p->payload; + +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> p->tot_len = %d\n", tlen); + DHCPS_LOG("dhcps: handle_dhcp-> p->len = %d\n", p->len); +#endif + + for(i=0; ilen; i++){ + p_dhcps_msg[dhcps_msg_cnt++] = data[i]; +#if DHCPS_DEBUG + DHCPS_LOG("%02x ",data[i]); + if((i+1)%16 == 0){ + DHCPS_LOG("\n"); + } +#endif + } + + if(p->next != NULL) { +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> p->next != NULL\n"); + DHCPS_LOG("dhcps: handle_dhcp-> p->next->tot_len = %d\n",p->next->tot_len); + DHCPS_LOG("dhcps: handle_dhcp-> p->next->len = %d\n",p->next->len); +#endif + + data = p->next->payload; + for(i=0; inext->len; i++){ + p_dhcps_msg[dhcps_msg_cnt++] = data[i]; +#if DHCPS_DEBUG + DHCPS_LOG("%02x ",data[i]); + if((i+1)%16 == 0){ + DHCPS_LOG("\n"); + } +#endif + } + } + + /* + * DHCP �ͻ���������Ϣ���� + */ +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> parse_msg(p)\n"); +#endif + + switch(parse_msg(pmsg_dhcps, tlen - 240)) { + case DHCPS_STATE_OFFER://1 +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> DHCPD_STATE_OFFER\n"); +#endif + send_offer(pmsg_dhcps); + break; + case DHCPS_STATE_ACK://3 +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> DHCPD_STATE_ACK\n"); +#endif + send_ack(pmsg_dhcps); + break; + case DHCPS_STATE_NAK://4 +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> DHCPD_STATE_NAK\n"); +#endif + send_nak(pmsg_dhcps); + break; + default : + break; + } +#if DHCPS_DEBUG + DHCPS_LOG("dhcps: handle_dhcp-> pbuf_free(p)\n"); +#endif + pbuf_free(p); + free(pmsg_dhcps); + pmsg_dhcps = NULL; +} +/////////////////////////////////////////////////////////////////////////////////// +static void wifi_softap_init_dhcps_lease(u32_t ip) +{ + u32_t softap_ip = 0,local_ip = 0; + u32_t start_ip = 0; + u32_t end_ip = 0; + if (dhcps_lease.enable == true) { + softap_ip = htonl(ip); + start_ip = htonl(dhcps_lease.start_ip.addr); + end_ip = htonl(dhcps_lease.end_ip.addr); + /*config ip information can't contain local ip*/ + if ((start_ip <= softap_ip) && (softap_ip <= end_ip)) { + dhcps_lease.enable = false; + } else { + /*config ip information must be in the same segment as the local ip*/ + softap_ip >>= 8; + if (((start_ip >> 8 != softap_ip) || (end_ip >> 8 != softap_ip)) + || (end_ip - start_ip > DHCPS_MAX_LEASE)) { + dhcps_lease.enable = false; + } + } + } + + if (dhcps_lease.enable == false) { + local_ip = softap_ip = htonl(ip); + softap_ip &= 0xFFFFFF00; + local_ip &= 0xFF; + if (local_ip >= 0x80) + local_ip -= DHCPS_MAX_LEASE; + else + local_ip ++; + + bzero(&dhcps_lease, sizeof(dhcps_lease)); + dhcps_lease.start_ip.addr = softap_ip | local_ip; + dhcps_lease.end_ip.addr = softap_ip | (local_ip + DHCPS_MAX_LEASE - 1); + dhcps_lease.start_ip.addr = htonl(dhcps_lease.start_ip.addr); + dhcps_lease.end_ip.addr= htonl(dhcps_lease.end_ip.addr); + } +// os_printf("start_ip = 0x%x, end_ip = 0x%x\n",dhcps_lease.start_ip, dhcps_lease.end_ip); +} + + +/////////////////////////////////////////////////////////////////////////////////// +void dhcps_start(struct netif *netif) +{ + struct netif * apnetif =netif; + + + if(apnetif->dhcps_pcb != NULL) { + udp_remove(apnetif->dhcps_pcb); + } + pcb_dhcps = udp_new(); + if (pcb_dhcps == NULL) { + printf("dhcps_start(): could not obtain pcb\n"); + } + apnetif->dhcps_pcb = pcb_dhcps; + + IP4_ADDR(&broadcast_dhcps, 255, 255, 255, 255); + + server_address = netif->ip_addr.u_addr.ip4; + wifi_softap_init_dhcps_lease( server_address.addr ); + + client_address_plus.addr = dhcps_lease.start_ip.addr; + + udp_bind(pcb_dhcps, IP_ADDR_ANY, DHCPS_SERVER_PORT); + udp_recv(pcb_dhcps, handle_dhcp, NULL); +#if DHCPS_DEBUG + DHCPS_LOG("dhcps:dhcps_start->udp_recv function Set a receive callback handle_dhcp for UDP_PCB pcb_dhcps\n"); +#endif + DhcpsFlags = DHCPS_STARTED; + +} + +void dhcps_stop(struct netif *netif ) +{ + struct netif * apnetif = netif; + if(apnetif == NULL) + { + printf("dhcps_stop: apnetif == NULL\n"); + return; + } + udp_disconnect(pcb_dhcps); +// dhcps_lease_flag = true; + if(apnetif->dhcps_pcb != NULL) { + udp_remove(apnetif->dhcps_pcb); + apnetif->dhcps_pcb = NULL; + } + + list_node *pnode = NULL; + list_node *pback_node = NULL; + pnode = plist; + while (pnode != NULL) { + pback_node = pnode; + pnode = pback_node->pnext; + node_remove_from_list(&plist, pback_node); + free(pback_node->pnode); + pback_node->pnode = NULL; + free(pback_node); + pback_node = NULL; + } + DhcpsFlags = DHCPS_STOP; +} + +bool wifi_softap_set_dhcps_lease(struct dhcps_lease *please) +{ + +// NOT USE + struct ip_info info; + u32_t softap_ip = 0; + u32_t start_ip = 0; + u32_t end_ip = 0; + + //uint8 opmode = wifi_get_opmode(); + //uint8 opmode = 0; + //if (opmode == STATION_MODE || opmode == NULL_MODE) { + //return false; + //} + if (please == NULL || get_dhcps_status() == DHCPS_STARTED) + return false; + + if(please->enable) { + struct ip_info ip_info; + memset(&ip_info, 0x00, sizeof(struct ip_info)); + tcpip_adapter_get_ip_info(WIFI_IF_AP, &info); + + softap_ip = htonl(info.ip.addr); + start_ip = htonl(please->start_ip.addr); + end_ip = htonl(please->end_ip.addr); + + /*config ip information can't contain local ip*/ + if ((start_ip <= softap_ip) && (softap_ip <= end_ip)) + return false; + + /*config ip information must be in the same segment as the local ip*/ + softap_ip >>= 8; + if ((start_ip >> 8 != softap_ip) + || (end_ip >> 8 != softap_ip)) { + return false; + } + + if (end_ip - start_ip > DHCPS_MAX_LEASE) + return false; + + memset(&dhcps_lease, 0x00, sizeof(dhcps_lease)); + // dhcps_lease.start_ip.addr = start_ip; + // dhcps_lease.end_ip.addr = end_ip; + dhcps_lease.start_ip.addr = please->start_ip.addr; + dhcps_lease.end_ip.addr = please->end_ip.addr; + } + dhcps_lease.enable = please->enable; +// dhcps_lease_flag = false; + return true; +} + +/****************************************************************************** + * FunctionName : wifi_softap_get_dhcps_lease + * Description : get the lease information of DHCP server + * Parameters : please -- Additional argument to get the lease information, + * Little-Endian. + * Returns : true or false +*******************************************************************************/ +bool wifi_softap_get_dhcps_lease(struct dhcps_lease *please) +{ + + if (NULL == please) + return false; + if (dhcps_lease.enable == false){ + if (get_dhcps_status() == DHCPS_STOP) + return false; + } else { + ; + } + please->start_ip.addr = dhcps_lease.start_ip.addr; + please->end_ip.addr = dhcps_lease.end_ip.addr; + return true; +} + +static void kill_oldest_dhcps_pool(void) +{ + list_node *pre = NULL, *p = NULL; + list_node *minpre = NULL, *minp = NULL; + struct dhcps_pool *pdhcps_pool = NULL, *pmin_pool = NULL; + pre = plist; + p = pre->pnext; + minpre = pre; + minp = p; + while (p != NULL){ + pdhcps_pool = p->pnode; + pmin_pool = minp->pnode; + if (pdhcps_pool->lease_timer < pmin_pool->lease_timer){ + minp = p; + minpre = pre; + } + pre = p; + p = p->pnext; + } + minpre->pnext = minp->pnext; + free(minp->pnode); + minp->pnode = NULL; + free(minp); + minp = NULL; +} + +void dhcps_coarse_tmr(void) +{ + u8_t num_dhcps_pool = 0; + list_node *pback_node = NULL; + list_node *pnode = NULL; + struct dhcps_pool *pdhcps_pool = NULL; + pnode = plist; + while (pnode != NULL) { + pdhcps_pool = pnode->pnode; + pdhcps_pool->lease_timer --; + if (pdhcps_pool->lease_timer == 0){ + pback_node = pnode; + pnode = pback_node->pnext; + node_remove_from_list(&plist,pback_node); + free(pback_node->pnode); + pback_node->pnode = NULL; + free(pback_node); + pback_node = NULL; + } else { + pnode = pnode ->pnext; + num_dhcps_pool ++; + } + } + + if (num_dhcps_pool >= MAX_STATION_NUM) + kill_oldest_dhcps_pool(); +} + +bool wifi_softap_set_dhcps_offer_option(u8_t level, void* optarg) +{ + bool offer_flag = true; + u8_t option = 0; + + if (optarg == NULL && get_dhcps_status() == false) + return false; + + if (level <= OFFER_START || level >= OFFER_END) + return false; + + switch (level){ + case OFFER_ROUTER: + offer = (*(u8_t *)optarg) & 0x01; + offer_flag = true; + break; + default : + offer_flag = false; + break; + } + return offer_flag; +} + +bool wifi_softap_set_dhcps_lease_time(u32_t minute) +{ + + if (get_dhcps_status() == DHCPS_STARTED) { + return false; + } + + if(minute == 0) { + return false; + } + dhcps_lease_time = minute; + return true; +} + +bool wifi_softap_reset_dhcps_lease_time(void) +{ + + if (get_dhcps_status() == DHCPS_STARTED) { + return false; + } + dhcps_lease_time = DHCPS_LEASE_TIME_DEF; + return true; +} + +u32_t wifi_softap_get_dhcps_lease_time(void) // minute +{ + return dhcps_lease_time; +} +#else +#include +#include +#include +#include "lwip/sys.h" +#include +#include +static os_timer_t micros_overflow_timer; +static uint32_t micros_at_last_overflow_tick = 0; +static uint32_t micros_overflow_count = 0; + +void micros_overflow_tick(void* arg) +{ + uint32_t m = system_get_time(); + if(m < micros_at_last_overflow_tick) + ++micros_overflow_count; + micros_at_last_overflow_tick = m; +} + +unsigned long millis() +{ + uint32_t m = system_get_time(); + uint32_t c = micros_overflow_count + ((m < micros_at_last_overflow_tick) ? 1 : 0); + return c * 4294967 + m / 1000; +} + +unsigned long micros() +{ + return system_get_time(); +} + +void dhcps_set_default_time(void) +{ + os_timer_disarm(µs_overflow_timer); + os_timer_setfn(µs_overflow_timer, (os_timer_func_t*) µs_overflow_tick, 0); + os_timer_arm(µs_overflow_timer, 60000, 1); +} + +time_t time(time_t * t) +{ + time_t seconds = millis(); + if (t) + { + *t = seconds; + } + return seconds; +} + +/* + * Initialize the binding list. + */ + +void +dhcp_binding_list_init (binding_list *list) +{ + STAILQ_INIT(list); +} + +/* + * Create a new binding + * + * The binding is added to the binding list, + * and a pointer to the binding is returned for further manipulations. + */ + +address_binding * +dhcp_binding_add (binding_list *list, uint32_t address, uint8_t *cident, uint8_t cident_len, int is_static) +{ + // fill binding + address_binding *binding = calloc(1, sizeof(*binding)); + + binding->address = address; + binding->cident_len = cident_len; + memcpy(binding->cident, cident, cident_len); + + binding->is_static = is_static; + + // add to binding list + STAILQ_INSERT_HEAD(list, binding, pointers); + + return binding; +} + +/* + * Updated bindings status, i.e. set to EXPIRED the status of the + * expired bindings. + */ + +void +dhcp_binding_statuses_update (binding_list *list) +{ + address_binding *binding, *binding_temp; + + STAILQ_FOREACH_SAFE(binding, list, pointers, binding_temp) + { + if(binding->binding_time + binding->lease_time < time(NULL)) + { + binding->status = EXPIRED; + } + } +} + +/* + * Search a static or dynamic binding having the given client identifier. + * + * If the is_static option is true a static binding will be searched, + * otherwise a dynamic one. If status is not zero, an binding with that + * status will be searched. + */ + +address_binding * +dhcp_binding_search (binding_list *list, uint8_t *cident, uint8_t cident_len, int is_static, int status) +{ + address_binding *binding, *binding_temp; + + STAILQ_FOREACH_SAFE(binding, list, pointers, binding_temp) + { + if((binding->is_static == is_static || is_static == STATIC_OR_DYNAMIC) && + binding->cident_len == cident_len && + memcmp(binding->cident, cident, cident_len) == 0) + { + if(status == 0) + return binding; + else if(status == binding->status) + return binding; + } + } + + return NULL; +} + +/* + * Get an available free address + * + * If a zero address is returned, no more address are available. + */ + +static uint32_t +dhcp_binding_take_free_address (pool_indexes *indexes) +{ + if(indexes->current <= indexes->last) + { + uint32_t address = indexes->current; + indexes->current = htonl(ntohl(indexes->current) + 1); + return address; + + } + else + return 0; +} + +/* + * Create a new dynamic binding or reuse an expired one. + * + * An attemp will be made to assign to the client the requested IP address + * contained in the address option. An address equals to zero means that no + * specific address has been requested. + * + * If the dynamic pool of addresses is full a NULL pointer will be returned. + */ + +address_binding * +dhcp_binding_new_dynamic (binding_list *list, pool_indexes *indexes, uint32_t address, uint8_t *cident, uint8_t cident_len) +{ + address_binding *binding, *binding_temp; + address_binding *found_binding = NULL; + + if (address != 0) + { + + STAILQ_FOREACH_SAFE(binding, list, pointers, binding_temp) + { + // search a previous binding using the requested IP address + + if(binding->address == address) + { + found_binding = binding; + break; + } + } + } + + if(found_binding != NULL && + !found_binding->is_static && + found_binding->status != PENDING && + found_binding->status != ASSOCIATED) + { + + // the requested IP address is available (reuse an expired association) + return found_binding; + + } + else + { + + /* the requested IP address is already in use, or no address has been + requested, or the address requested has never been allocated + (we do not support this last case and just return the next + available address!). */ + + uint32_t address = dhcp_binding_take_free_address(indexes); + + if(address != 0) + return dhcp_binding_add(list, address, cident, cident_len, 0); + + else // search any previously assigned address which is expired + { + + STAILQ_FOREACH_SAFE(binding, list, pointers, binding_temp) + { + if(!binding->is_static && + found_binding->status != PENDING && + found_binding->status != ASSOCIATED) + return binding; + } + + // if executions reach here no more addresses are available + return NULL; + } + } +} + +/* + * Delete an binding list and deallocate its memory. + * Deallocate even the list elements. + */ + +static void +dhcp_binding_list_delete (binding_list *list) +{ + address_binding *opt = STAILQ_FIRST(list); + address_binding *tmp; + + while (opt != NULL) + { + tmp = STAILQ_NEXT(opt, pointers); + free(opt); + opt = tmp; + } + + STAILQ_INIT(list); +} + +/* Value parsing functions: + * + * Parse the string pointed by s, and allocate the + * pointer p to contain the parsed data. + * + * On success return the size of the parsed data, + * on error return zero. + */ + +static int dhcp_option_byte (char *s, void **p); +static int dhcp_option_byte_list (char *s, void **p); +static int dhcp_option_short (char *s, void **p); +static int dhcp_option_short_list (char *s, void **p); +static int dhcp_option_long (char *s, void **p); +static int dhcp_option_string (char *s, void **p); +static int dhcp_option_ip (char *s, void **p); +static int dhcp_option_ip_list (char *s, void **p); + +/* Global pool */ +static const uint8_t dhcp_option_magic[4] = {0x63, 0x82, 0x53, 0x63}; +static address_pool dhcp_address_pool = {0}; + +/* + * Mapping table between DHCP options and + * functions that parse their value. + */ +static struct +{ + char *name; + int (*f) (char *, void **); +} dhcp_option_info [256] = +{ + [PAD] { "PAD", NULL }, + [END] { "END", NULL }, + [SUBNET_MASK] { "SUBNET_MASK", dhcp_option_ip }, + [TIME_OFFSET] { "TIME_OFFSET", dhcp_option_long }, + [ROUTER] { "ROUTER", dhcp_option_ip_list }, + [TIME_SERVER] { "TIME_SERVER", dhcp_option_ip_list }, + [NAME_SERVER] { "NAME_SERVER", dhcp_option_ip_list }, + [DOMAIN_NAME_SERVER] { "DOMAIN_NAME_SERVER", dhcp_option_ip_list }, + [LOG_SERVER] { "LOG_SERVER", dhcp_option_ip_list }, + [COOKIE_SERVER] { "COOKIE_SERVER", dhcp_option_ip_list }, + [LPR_SERVER] { "LPR_SERVER", dhcp_option_ip_list }, + [IMPRESS_SERVER] { "IMPRESS_SERVER", dhcp_option_ip_list }, + [RESOURCE_LOCATION_SERVER] { "RESOURCE_LOCATION_SERVER", dhcp_option_ip_list }, + [HOST_NAME] { "HOST_NAME", dhcp_option_string }, + [BOOT_FILE_SIZE] { "BOOT_FILE_SIZE", dhcp_option_short }, + [MERIT_DUMP_FILE] { "MERIT_DUMP_FILE", dhcp_option_string }, + [DOMAIN_NAME] { "DOMAIN_NAME", dhcp_option_string }, + [SWAP_SERVER] { "SWAP_SERVER", dhcp_option_ip }, + [ROOT_PATH] { "ROOT_PATH", dhcp_option_string }, + [EXTENSIONS_PATH] { "EXTENSIONS_PATH", dhcp_option_string }, + [IP_FORWARDING] { "IP_FORWARDING", dhcp_option_byte }, + [NON_LOCAL_SOURCE_ROUTING] { "NON_LOCAL_SOURCE_ROUTING", dhcp_option_byte }, + [POLICY_FILTER] { "POLICY_FILTER", dhcp_option_ip_list }, + [MAXIMUM_DATAGRAM_REASSEMBLY_SIZE] { "MAXIMUM_DATAGRAM_REASSEMBLY_SIZE", dhcp_option_short }, + [DEFAULT_IP_TIME_TO_LIVE] { "DEFAULT_IP_TIME_TO_LIVE", dhcp_option_byte }, + [PATH_MTU_AGING_TIMEOUT] { "PATH_MTU_AGING_TIMEOUT", dhcp_option_long }, + [PATH_MTU_PLATEAU_TABLE] { "PATH_MTU_PLATEAU_TABLE", dhcp_option_short_list }, + [INTERFACE_MTU] { "INTERFACE_MTU", dhcp_option_short }, + [ALL_SUBNETS_ARE_LOCAL] { "ALL_SUBNETS_ARE_LOCAL", dhcp_option_byte }, + [BROADCAST_ADDRESS] { "BROADCAST_ADDRESS", dhcp_option_ip }, + [PERFORM_MASK_DISCOVERY] { "PERFORM_MASK_DISCOVERY", dhcp_option_byte }, + [MASK_SUPPLIER] { "MASK_SUPPLIER", dhcp_option_byte }, + [PERFORM_ROUTER_DISCOVERY] { "PERFORM_ROUTER_DISCOVERY", dhcp_option_byte }, + [ROUTER_SOLICITATION_ADDRESS] { "ROUTER_SOLICITATION_ADDRESS", dhcp_option_ip }, + [STATIC_ROUTE] { "STATIC_ROUTE", dhcp_option_ip_list }, + [TRAILER_ENCAPSULATION] { "TRAILER_ENCAPSULATION", dhcp_option_byte }, + [ARP_CACHE_TIMEOUT] { "ARP_CACHE_TIMEOUT", dhcp_option_long }, + [ETHERNET_ENCAPSULATION] { "ETHERNET_ENCAPSULATION", dhcp_option_byte }, + [TCP_DEFAULT_TTL] { "TCP_DEFAULT_TTL", dhcp_option_byte }, + [TCP_KEEPALIVE_INTERVAL] { "TCP_KEEPALIVE_INTERVAL", dhcp_option_long }, + [TCP_KEEPALIVE_GARBAGE] { "TCP_KEEPALIVE_GARBAGE", dhcp_option_byte }, + [NETWORK_INFORMATION_SERVICE_DOMAIN] { "NETWORK_INFORMATION_SERVICE_DOMAIN", dhcp_option_string }, + [NETWORK_INFORMATION_SERVERS] { "NETWORK_INFORMATION_SERVERS", dhcp_option_ip_list }, + [NETWORK_TIME_PROTOCOL_SERVERS] { "NETWORK_TIME_PROTOCOL_SERVERS", dhcp_option_ip_list }, + [VENDOR_SPECIFIC_INFORMATION] { "VENDOR_SPECIFIC_INFORMATION", dhcp_option_byte_list }, + [NETBIOS_OVER_TCP_IP_NAME_SERVER] { "NETBIOS_OVER_TCP_IP_NAME_SERVER", dhcp_option_ip_list }, + [NETBIOS_OVER_TCP_IP_DATAGRAM_DISTRIBUTION_SERVER] { "NETBIOS_OVER_TCP_IP_DATAGRAM_DISTRIBUTION_SERVER", dhcp_option_ip_list }, + [NETBIOS_OVER_TCP_IP_NODE_TYPE] { "NETBIOS_OVER_TCP_IP_NODE_TYPE", dhcp_option_byte }, + [NETBIOS_OVER_TCP_IP_SCOPE] { "NETBIOS_OVER_TCP_IP_SCOPE", dhcp_option_string }, + [X_WINDOW_SYSTEM_FONT_SERVER] { "X_WINDOW_SYSTEM_FONT_SERVER", dhcp_option_ip_list }, + [X_WINDOW_SYSTEM_DISPLAY_MANAGER] { "X_WINDOW_SYSTEM_DISPLAY_MANAGER", dhcp_option_ip_list }, + [NETWORK_INFORMATION_SERVICE_PLUS_DOMAIN] { "NETWORK_INFORMATION_SERVICE_PLUS_DOMAIN", dhcp_option_string }, + [NETWORK_INFORMATION_SERVICE_PLUS_SERVERS] { "NETWORK_INFORMATION_SERVICE_PLUS_SERVERS", dhcp_option_ip_list }, + [MOBILE_IP_HOME_AGENT] { "MOBILE_IP_HOME_AGENT", dhcp_option_ip_list }, + [SMTP_SERVER] { "SMTP_SERVER", dhcp_option_ip_list }, + [POP3_SERVER] { "POP3_SERVER", dhcp_option_ip_list }, + [NNTP_SERVER] { "NNTP_SERVER", dhcp_option_ip_list }, + [DEFAULT_WWW_SERVER] { "DEFAULT_WWW_SERVER", dhcp_option_ip_list }, + [DEFAULT_FINGER_SERVER] { "DEFAULT_FINGER_SERVER", dhcp_option_ip_list }, + [DEFAULT_IRC_SERVER] { "DEFAULT_IRC_SERVER", dhcp_option_ip_list }, + [STREETTALK_SERVER] { "STREETTALK_SERVER", dhcp_option_ip_list }, + [STREETTALK_DIRECTORY_ASSISTANCE_SERVER] { "STREETTALK_DIRECTORY_ASSISTANCE_SERVER", dhcp_option_ip_list }, + [REQUESTED_IP_ADDRESS] { "REQUESTED_IP_ADDRESS", NULL }, + [IP_ADDRESS_LEASE_TIME] { "IP_ADDRESS_LEASE_TIME", dhcp_option_long }, + [OPTION_OVERLOAD] { "OPTION_OVERLOAD", dhcp_option_byte }, + [TFTP_SERVER_NAME] { "TFTP_SERVER_NAME", dhcp_option_string }, + [BOOTFILE_NAME] { "BOOTFILE_NAME", dhcp_option_string }, + [DHCP_MESSAGE_TYPE] { "DHCP_MESSAGE_TYPE", NULL }, + [SERVER_IDENTIFIER] { "SERVER_IDENTIFIER", dhcp_option_ip }, + [PARAMETER_REQUEST_LIST] { "PARAMETER_REQUEST_LIST", NULL }, + [MESSAGE] { "MESSAGE", NULL }, + [MAXIMUM_DHCP_MESSAGE_SIZE] { "MAXIMUM_DHCP_MESSAGE_SIZE", NULL }, + [RENEWAL_T1_TIME_VALUE] { "RENEWAL_T1_TIME_VALUE", dhcp_option_long }, + [REBINDING_T2_TIME_VALUE] { "REBINDING_T2_TIME_VALUE", dhcp_option_long }, + [VENDOR_CLASS_IDENTIFIER] { "VENDOR_CLASS_IDENTIFIER", NULL }, + [CLIENT_IDENTIFIER] { "CLIENT_IDENTIFIER", NULL }, + + [USER_CLASS] { "USER_CLASS", NULL }, + [FQDN] { "FQDN", NULL }, + [DHCP_AGENT_OPTIONS] { "DHCP_AGENT_OPTIONS", NULL }, + [NDS_SERVERS] { "NDS_SERVERS", NULL }, + [NDS_TREE_NAME] { "NDS_TREE_NAME", NULL }, + [NDS_CONTEXT] { "NDS_CONTEXT", NULL }, + [CLIENT_LAST_TRANSACTION_TIME] { "CLIENT_LAST_TRANSACTION_TIME", NULL }, + [ASSOCIATED_IP] { "ASSOCIATED_IP", NULL }, + [USER_AUTHENTICATION_PROTOCOL] { "USER_AUTHENTICATION_PROTOCOL", NULL }, + [AUTO_CONFIGURE] { "AUTO_CONFIGURE", NULL }, + [NAME_SERVICE_SEARCH] { "NAME_SERVICE_SEARCH", dhcp_option_string }, + [SUBNET_SELECTION] { "SUBNET_SELECTION", NULL }, + [DOMAIN_SEARCH] { "DOMAIN_SEARCH", dhcp_option_string }, + [CLASSLESS_ROUTE] { "CLASSLESS_ROUTE", dhcp_option_string }, +}; + +/* Value parsing functions */ + +static int +dhcp_option_byte (char *s, void **p) +{ + *p = malloc(sizeof(uint8_t)); + uint8_t n = ((uint8_t) strtol(s, NULL, 0)); + memcpy(*p, &n, sizeof(n)); + + return sizeof(uint8_t); +} + +static int +dhcp_option_byte_list (char *s, void **p) +{ + *p = malloc(strlen(s) * sizeof(uint8_t)); // slightly over the strictly requested size + + int count = 0; + + char *s2 = strdup(s); + char *s3 = strtok(s2, ", "); + + while(s3 != NULL) + { + + uint8_t n = ((uint8_t) strtol(s3, NULL, 0)); + + memcpy(((uint8_t *) *p) + count, &n, sizeof(uint8_t)); + + count += sizeof(uint8_t); + s3 = strtok(NULL, " "); + } + + free(s2); + + return count; +} + +static int +dhcp_option_short (char *s, void **p) +{ + *p = malloc(sizeof(uint16_t)); + uint16_t n = ((uint16_t) strtol(s, NULL, 0)); + memcpy(*p, &n, sizeof(n)); + + return sizeof(uint16_t); +} + +static int +dhcp_option_short_list (char *s, void **p) +{ + *p = malloc(strlen(s) * sizeof(uint16_t)); // slightly over the strictly requested size + + int count = 0; + + char *s2 = strdup(s); + char *s3 = strtok(s2, ", "); + + while(s3 != NULL) + { + + uint16_t n = ((uint16_t) strtol(s3, NULL, 0)); + + memcpy(((uint8_t *) *p) + count, &n, sizeof(uint16_t)); + + count += sizeof(uint16_t); + s3 = strtok(NULL, " "); + } + + free(s2); + + return count; +} + +static int +dhcp_option_long (char *s, void **p) +{ + *p = malloc(sizeof(uint32_t)); + uint32_t n = strtol(s, NULL, 0); + memcpy(*p, &n, sizeof(n)); + + return sizeof(uint32_t); +} + +static int +dhcp_option_string (char *s, void **p) +{ + *p = strdup(s); + + return strlen(s); +} + +static int +dhcp_option_ip (char *s, void **p) +{ + struct sockaddr_in ip; + + *p = malloc(sizeof(uint32_t)); + + if (inet_aton(s, &ip.sin_addr) == 0) // error: invalid IP address + { + free(*p); + return 0; + } + + memcpy(*p, &ip.sin_addr, sizeof(uint32_t)); + + return sizeof(uint32_t); +} + +static int +dhcp_option_ip_list (char *s, void **p) +{ + *p = malloc(strlen(s) * sizeof(uint32_t) / 4); // slightly over the strictly required size + + int count = 0; + + char *s2 = strdup(s); + char *s3 = strtok(s2, ", "); + + while(s3 != NULL) + { + struct sockaddr_in ip; + + if (inet_aton(s3, &ip.sin_addr) == 0) // error: invalid IP address + { + free(*p); + return 0; + } + + memcpy(((uint8_t *) *p) + count, &ip.sin_addr, sizeof(uint32_t)); + + count += sizeof(uint32_t); + s3 = strtok(NULL, " "); + } + + free(s2); + + return count; +} + +/* Option-related functions */ + +/* + * Given the name of the option and its value as strings, + * fill the dhcp_option structure pointed by opt. + * + * On success return the parsed option id, + * otherwise return zero. + */ +static uint8_t +dhcp_option_parse (dhcp_option *opt, char *name, char *value) +{ + int (*f) (char *, void **); + int id; + + uint8_t len; + uint8_t *p; + + for (id = 0; id < 256; id++) // search the option by name + { + if (dhcp_option_info[id].name && + strcmp(dhcp_option_info[id].name, name) == 0) break; + } + + if (id == 256) // not found + { + log_info("Unsupported DHCP option '%s'", name); + return 0; + } + + f = dhcp_option_info[id].f; + + if (f == NULL) // no parsing function available + { + log_info("Unsupported DHCP option '%s'", name); + return 0; + } + + len = f(value, (void **)&p); // parse the value + + if(len == 0) // error parsing the value + return 0; + + // structure filling + opt->id = id; + opt->len = len; + memcpy(opt->data, p, len); + + free(p); + + return opt->id; +} + +/* + * Initialize an option list. + */ + +static void +dhcp_option_list_init (dhcp_option_list *list) +{ + STAILQ_INIT(list); +} + +/* + * Given a list of options search an option having + * the passed option id, and returns a pointer to it. + * + * If the option is not present the function returns NULL. + */ + +static dhcp_option * +dhcp_option_search (dhcp_option_list *list, uint8_t id) +{ + dhcp_option *opt, *opt_temp; + + STAILQ_FOREACH_SAFE(opt, list, pointers, opt_temp) + { + + if(opt->id == id) + return opt; + + } + + return NULL; +} + +/* + * Print options in list. + */ + +static void +dhcp_option_print (dhcp_option_list *list) +{ + dhcp_option *opt, *opt_temp; + int i=0; + + STAILQ_FOREACH_SAFE(opt, list, pointers, opt_temp) + { + + printf("options[%d]=%d (%s)\n", i++, opt->id, + dhcp_option_info[opt->id].name); + + } +} + + +/* + * Append the provided option to the list. + * + * Always allocate new memory, that must be freed later... + */ + +static void +dhcp_option_append (dhcp_option_list *list, dhcp_option *opt) +{ + dhcp_option *nopt = calloc(1, sizeof(*nopt)); + memcpy(nopt, opt, 2 + opt->len); + + STAILQ_INSERT_TAIL(list, nopt, pointers); +} + +/* + * Parse the options contained in a DHCP message into a list. + * + * Return 1 on success, 0 if the options are malformed. + */ + +static int +dhcp_option_parse_to_list (dhcp_option_list *list, dhcp_option *opts, size_t len) +{ + dhcp_option *opt, *end; + + opt = opts; + end = (dhcp_option *)(((uint8_t *)opts) + len); + + if (len < 4 || + memcmp(opt, dhcp_option_magic, sizeof(dhcp_option_magic)) != 0) + return 0; + + opt = (dhcp_option *)(((uint8_t *) opt) + 4); + + while (opt < end && + opt->id != END) // TODO: check also valid option sizes + { + + if ((dhcp_option *)(((uint8_t *) opt) + 2 + opt->len) >= end) + return 0; // the len field is too long + + dhcp_option_append(list, opt); + + opt = (dhcp_option *)(((uint8_t *) opt) + 2 + opt->len); + } + + if (opt < end && opt->id == END) + return 1; + + return 0; +} + +/* + * Serialize a list of options, to be inserted directly inside + * the options section of a DHCP message. + * + * Return 0 on error, the total serialized len on success. + */ + +static size_t +dhcp_option_list_serialize (dhcp_option_list *list, uint8_t *buf, size_t len) +{ + uint8_t *p = buf; + + if (len < 4) + return 0; + + memcpy(p, dhcp_option_magic, sizeof(dhcp_option_magic)); + p += 4; + len -= 4; + + dhcp_option *opt, *opt_temp; + + STAILQ_FOREACH_SAFE(opt, list, pointers, opt_temp) + { + + if (len <= 2 + opt->len) + return 0; + + memcpy(p, opt, 2 + opt->len); + p += 2 + opt->len; + len -= 2 + opt->len; + + } + + if (len < 1) + return 0; + + *p = END; + + p++; + len--; + + return p - buf; +} + +/* + * Delete an option list and deallocate its memory. + * Deallocate even the list elements. + */ + +static void +dhcp_option_list_delete (dhcp_option_list *list) +{ + dhcp_option *opt = STAILQ_FIRST(list); + dhcp_option *tmp; + + while (opt != NULL) + { + tmp = STAILQ_NEXT(opt, pointers); + free(opt); + opt = tmp; + } + + STAILQ_INIT(list); +} + +static void dhcp_options_default_fill(dhcp_option_list *list, dhcp_option_list *reply_opts) +{ + dhcp_option *opt, *opt_temp; + int i = 0; + + STAILQ_FOREACH_SAFE(opt, list, pointers, opt_temp) + { + log_info("options[%d]=%d (%s)\n", i++, opt->id, dhcp_option_info[opt->id].name); + + if (opt != NULL) + dhcp_option_append(reply_opts, opt); + } +} + +static void +dhcp_options_requested_fill (dhcp_option *requested_opts, dhcp_option_list *reply_opts) +{ + uint8_t len = requested_opts->len; + uint8_t *id = requested_opts->data; + + int i = 0; + for (i = 0; i < len; i++) + { + if(id[i] != 0) + { + dhcp_option *opt = dhcp_option_search(&dhcp_address_pool.options, id[i]); + + if(opt != NULL) + dhcp_option_append(reply_opts, opt); + } + } + dhcp_option_print(reply_opts); +} + +static bool dhcp_options_add(char* name, char* value) +{ + uint8_t id = 0; + bool flags = true; + REQUIRE_ACTION(name, add_error, flags = false); + REQUIRE_ACTION(value, add_error, flags = false); + dhcp_option *option = calloc(1, sizeof(*option)); + REQUIRE_ACTION(option, add_error, flags = false); + id = dhcp_option_parse(option, name, value); + if (id == 0) + { + log_info( "error: invalid dhcp option specified: %s,%s",name, value); + REQUIRE_ACTION(option, add_error, flags = false); + } + + dhcp_option_append(&dhcp_address_pool.options, option); + + if(option->id == IP_ADDRESS_LEASE_TIME) + dhcp_address_pool.lease_time = ntohl(*((uint32_t *)option->data)); + +add_error: + free(option); + return flags; +} + +/* + * Message handling routines. + */ + +static uint8_t dhcp_request_expand (dhcps_msg *request, size_t len) +{ + dhcp_option_list_init(&request->opts); + + if (request->hdr.hlen < 1 || request->hdr.hlen > 16) + return 0; + + if (dhcp_option_parse_to_list(&request->opts, (dhcp_option *)request->hdr.options, len - DHCP_HEADER_SIZE) == 0) + return 0; + + dhcp_option *type_opt = dhcp_option_search(&request->opts, DHCP_MESSAGE_TYPE); + + if (type_opt == NULL) + return 0; + + uint8_t type = type_opt->data[0]; + + return type; +} + +static int +dhcp_reply_init (dhcps_msg *request, dhcps_msg *reply) +{ + memset(&reply->hdr, 0, sizeof(reply->hdr)); + + dhcp_option_list_init(&reply->opts); + + reply->hdr.op = BOOTREPLY; + + reply->hdr.htype = request->hdr.htype; + reply->hdr.hlen = request->hdr.hlen; + + reply->hdr.xid = request->hdr.xid; + reply->hdr.flags = request->hdr.flags; + + reply->hdr.giaddr = request->hdr.giaddr; + + memcpy(reply->hdr.chaddr, request->hdr.chaddr, request->hdr.hlen); + + return 1; +} + +static int dhcp_reply_send(struct udp_pcb *pcb, ip_addr_t *addr, dhcps_msg *reply) +{ + size_t len = 0, ret = 0; + struct pbuf *p = NULL, *q = NULL; + u8_t *data = NULL; + u16_t cnt = 0; + u16_t i = 0; + + len = dhcp_option_list_serialize(&reply->opts, reply->hdr.options, sizeof(reply->hdr) - DHCP_HEADER_SIZE); + len += DHCP_HEADER_SIZE; + + dhcp_option *type_opt = dhcp_option_search(&reply->opts, DHCP_MESSAGE_TYPE); + if (type_opt == NULL) + return -1; + +// if (type_opt->data[0] == DHCP_OFFER) + addr->u_addr.ip4.addr = INADDR_BROADCAST; +// else +// ip4_addr_set(ip_2_ip4(addr), &reply->hdr.yiaddr); // use the address assigned by us + + if (reply->hdr.yiaddr.addr != 0) + { + log_info("send_dhcp_reply %s\n", inet_ntoa(*addr)); + } + + p = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + + if (p != NULL) + { + q = p; + while (q != NULL) + { + data = (u8_t *)q->payload; + for (i = 0; i< q->len; i++) + { + data[i] = ((u8_t *) reply)[cnt++]; + } + + q = q->next; + } + } + else + { + return 0; + } + + ret = udp_sendto(pcb, p, addr, BOOTPC); + log_info("dhcp_send %d %d\n", ret, p->ref); + if(p->ref != 0) + { + pbuf_free(p); + } + + return ret; +} + +static int +dhcp_reply_fill (dhcps_msg *request, dhcps_msg *reply, + address_binding *binding, uint8_t type) +{ + static dhcp_option type_opt, server_id_opt; + + type_opt.id = DHCP_MESSAGE_TYPE; + type_opt.len = 1; + type_opt.data[0] = type; + dhcp_option_append(&reply->opts, &type_opt); + + server_id_opt.id = SERVER_IDENTIFIER; + server_id_opt.len = 4; + memcpy(server_id_opt.data, &dhcp_address_pool.server_id, sizeof(dhcp_address_pool.server_id)); + dhcp_option_append(&reply->opts, &server_id_opt); + + if(binding != NULL) + { + reply->hdr.yiaddr.addr = binding->address; + } + + if (type != DHCPS_NAK) + { + dhcp_option *requested_opts = dhcp_option_search(&request->opts, PARAMETER_REQUEST_LIST); + + if (requested_opts) + dhcp_options_default_fill(&dhcp_address_pool.options, &reply->opts); + } + + return type; +} + +static int +dhcp_discover (dhcps_msg *request, dhcps_msg *reply) +{ + address_binding *binding = NULL; + binding = dhcp_binding_search(&dhcp_address_pool.bindings, request->hdr.chaddr, request->hdr.hlen, STATIC, EMPTY); + + if (binding) + { + /* a static binding has been configured for this client */ + log_info("%s %d %p",__FILE__, __LINE__, binding); + } + else + { + /* use dynamic pool */ + /* If an address is available, the new address SHOULD be chosen as follows: */ + binding = dhcp_binding_search(&dhcp_address_pool.bindings, request->hdr.chaddr,request->hdr.hlen, DYNAMIC, EMPTY); + + if (binding) + { + /* The client's current address as recorded in the client's current + binding, ELSE */ + + /* The client's previous address as recorded in the client's (now + expired or released) binding, if that address is in the server's + pool of available addresses and not already allocated, ELSE */ + log_info("%s %d %p",__FILE__, __LINE__, binding); + } + else + { + /* The address requested in the 'Requested IP Address' option, if that + address is valid and not already allocated, ELSE */ + + /* A new address allocated from the server's pool of available + addresses; the address is selected based on the subnet from which + the message was received (if 'giaddr' is 0) or on the address of + the relay agent that forwarded the message ('giaddr' when not 0). */ + + /* extract requested IP address */ + uint32_t address = 0; + dhcp_option *address_opt = dhcp_option_search(&request->opts, REQUESTED_IP_ADDRESS); + + if (address_opt != NULL) + memcpy(&address, address_opt->data, sizeof(address)); + + binding = dhcp_binding_new_dynamic(&dhcp_address_pool.bindings, &dhcp_address_pool.indexes, address, request->hdr.chaddr, request->hdr.hlen); + + if (binding == NULL) + { + log_info("Can not offer an address, no address available."); + return 0; + } + } + } + + if (binding->binding_time + binding->lease_time < time(NULL)) + { + log_info("%s %d %p",__FILE__, __LINE__, binding); + binding->status = PENDING; + binding->binding_time = time(NULL); + binding->lease_time = dhcp_address_pool.pending_time; + } + + return dhcp_reply_fill(request, reply, binding, DHCPS_OFFER); +} + +static int +dhcp_request (dhcps_msg *request, dhcps_msg *reply) +{ + address_binding *binding = dhcp_binding_search(&dhcp_address_pool.bindings, request->hdr.chaddr, request->hdr.hlen, STATIC_OR_DYNAMIC, PENDING); + + uint32_t server_id = 0; + dhcp_option *server_id_opt = dhcp_option_search(&request->opts, SERVER_IDENTIFIER); + + if (server_id_opt != NULL) + memcpy(&server_id, server_id_opt->data, sizeof(server_id)); + + if (server_id == dhcp_address_pool.server_id) + { + /* this request is an answer to our offer */ + if (binding != NULL) + { + log_info("Ack, associated"); + + binding->status = ASSOCIATED; + binding->lease_time = dhcp_address_pool.lease_time; + + return dhcp_reply_fill(request, reply, binding, DHCPS_ACK); + } + else + { + log_info("Nak, not associated"); + + return dhcp_reply_fill(request, reply, NULL, DHCPS_NAK); + } + + } + else if (server_id != 0) + { + /* this request is an answer to another offer */ + + binding->status = EMPTY; + binding->lease_time = 0; + + return 0; + } + + return 0; +} + +static int +dhcp_decline (dhcps_msg *request, dhcps_msg *reply) +{ + address_binding *binding = NULL; + binding = dhcp_binding_search(&dhcp_address_pool.bindings, request->hdr.chaddr, request->hdr.hlen, STATIC_OR_DYNAMIC, PENDING); + if(binding != NULL) + { + binding->status = EMPTY; + } + + return 0; +} + +static int +dhcp_release (dhcps_msg *request, dhcps_msg *reply) +{ + address_binding *binding = NULL; + binding = dhcp_binding_search(&dhcp_address_pool.bindings, request->hdr.chaddr, request->hdr.hlen, STATIC_OR_DYNAMIC, ASSOCIATED); + if(binding != NULL) + { + binding->status = RELEASED; + } + + return 0; +} + +static int +dhcp_inform (dhcps_msg *request, dhcps_msg *reply) +{ + return dhcp_reply_fill(request, reply, NULL, DHCPS_ACK); +} + +/** + * If an incoming DHCP message is in response to us, then trigger the state machine. + * + * Dispatch client DHCP messages to the correct handling routines + * + */ +static void dhcp_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port) +{ + struct netif *netif = ip_current_input_netif(); + + struct pbuf *pthis = NULL; + + LWIP_UNUSED_ARG(arg); + LWIP_ASSERT("invalid server address type", !IP_IS_V6(addr)); + /* prevent warnings about unused arguments */ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(addr); + LWIP_UNUSED_ARG(port); + uint8_t type = 0; + dhcps_msg *request = calloc(1, sizeof(dhcps_msg)); + REQUIRE_ACTION(request, free_pbuf_and_return, 0); + dhcps_msg *reply = calloc(1, sizeof(dhcps_msg)); + REQUIRE_ACTION(reply, free_pbuf_and_return, 0); + size_t len = 0; + len = pbuf_copy_partial(p, &request->hdr, p->tot_len, 0); + if (len < DHCP_HEADER_SIZE + 5) + { + goto free_pbuf_and_return; + } + else + { + if (request->hdr.op != BOOTREQUEST) + { + goto free_pbuf_and_return; + } + else + { + type = dhcp_request_expand(request, len); + dhcp_reply_init(request, reply); + switch (type) + { + case DHCPS_DISCOVER: + type = dhcp_discover(request, reply); + break; + + case DHCPS_REQUEST: + type = dhcp_request(request, reply); + break; + + case DHCPS_DECLINE: + type = dhcp_decline(request, reply); + break; + + case DHCPS_RELEASE: + type = dhcp_release(request, reply); + break; + + case DHCPS_INFORM: + type = dhcp_inform(request, reply); + break; + + default: + log_info("%s.%u: request with invalid DHCP message type option",inet_ntoa(addr), port); + break; + } + + if (type != DHCP_NONE) + dhcp_reply_send(pcb, (ip_addr_t *)addr, reply); + + dhcp_option_list_delete(&request->opts); + dhcp_option_list_delete(&reply->opts); + } + } + +free_pbuf_and_return: + if (request != NULL) + free(request); + + if (reply != NULL) + free(reply); + pbuf_free(p); +} + +void dhcps_set_default_option(struct dhcps_lease *pool_addr) +{ + ip4_addr_t server_ip, broadcast, dns; + REQUIRE_ASSERT(pool_addr); + address_pool *dhcps_addr_pool = &dhcp_address_pool; + + if (dhcps_addr_pool->flags){ + + } else{ + dhcp_option_list_init(&dhcps_addr_pool->options); + dhcps_addr_pool->flags = true; + } + + /* Load configuration */ + dhcps_option_set(IP_ADDRESS_LEASE_TIME, "36000"); + dhcps_option_set(SUBNET_MASK, inet_ntoa(pool_addr->net_mask)); + + server_ip.addr = dhcps_addr_pool->server_id; + dhcps_option_set(ROUTER, inet_ntoa(server_ip)); + + broadcast.addr = server_ip.addr | ~(pool_addr->net_mask.addr); + dhcps_option_set(BROADCAST_ADDRESS,inet_ntoa(broadcast)); + + dns.addr = DHCP_SERVER_OPENDNS; + dhcps_option_set(DOMAIN_NAME_SERVER, inet_ntoa(dns)); +} + +static void dhcps_set_default_binding(address_pool *pool_addr) +{ + REQUIRE_ASSERT(pool_addr); + dhcp_binding_list_init(&pool_addr->bindings); +} + +static address_pool* dhcps_try_open_socket(address_pool *pool_addr) +{ + REQUIRE_ASSERT(pool_addr); + pool_addr->socket = udp_new(); + REQUIRE_ASSERT(pool_addr->socket); + udp_bind(pool_addr->socket, IP_ADDR_ANY, BOOTPS); + udp_recv(pool_addr->socket, dhcp_recv, pool_addr); + return pool_addr; +} + +void dhcps_start(struct netif *netif, struct dhcps_lease *lease_pool) +{ + REQUIRE_ASSERT(netif); + REQUIRE_ASSERT(lease_pool); + + dhcp_address_pool.server_id = netif->ip_addr.u_addr.ip4.addr; + dhcps_set_default_time(); + dhcps_set_default_binding(&dhcp_address_pool); + dhcps_set_default_option(lease_pool); + dhcps_try_open_socket(&dhcp_address_pool); +} + +void dhcps_stop(struct netif *netif ) +{ + dhcp_binding_list_delete(&dhcp_address_pool.bindings); + dhcp_option_list_delete(&dhcp_address_pool.options); + udp_remove(dhcp_address_pool.socket); + dhcp_address_pool.flags = false; +// memset(&dhcp_address_pool, 0, sizeof(address_pool)); +} + +bool dhcps_lease_set(struct dhcps_lease *please) +{ + REQUIRE_ASSERT(please); + + dhcp_address_pool.indexes.first = please->start_ip.addr; + dhcp_address_pool.indexes.last = please->end_ip.addr; + dhcp_address_pool.indexes.current = please->start_ip.addr; + + return true; +} + +bool dhcps_lease_get(struct dhcps_lease *please) +{ + REQUIRE_ASSERT(please); + please->start_ip.addr = dhcp_address_pool.indexes.first; + please->end_ip.addr = dhcp_address_pool.indexes.last; + please->net_mask.addr = inet_addr("255.255.255.0"); + return true; +} + +bool dhcps_option_set(u8_t opt_id, void* optarg) +{ + if (dhcp_address_pool.flags){ + dhcp_option *opt = dhcp_option_search(&dhcp_address_pool.options, opt_id); + if (opt) + { + opt->len = strlen(optarg); + memset(opt->data, 0, sizeof(opt->data)); + memcpy(opt->data, optarg, opt->len); + return true; + } + else + { + return dhcp_options_add(dhcp_option_info[opt_id].name, optarg); + } + } else{ + dhcp_option_list_init(&dhcp_address_pool.options); + dhcp_address_pool.flags = true; + return dhcp_options_add(dhcp_option_info[opt_id].name, optarg); + } +} + +bool wifi_softap_set_dhcps_lease(struct dhcps_lease *please) +{ + return false; +} + +bool wifi_softap_set_dhcps_lease_time(u32_t minute) +{ + return false; +} + +#endif /*ifdef LWIP_ESP8266*/ + + + + + diff --git a/components/lwip/core/def.c b/components/lwip/core/def.c new file mode 100755 index 000000000..bb4b8e01f --- /dev/null +++ b/components/lwip/core/def.c @@ -0,0 +1,108 @@ +/** + * @file + * Common functions used throughout the stack. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Simon Goldschmidt + * + */ + +#include "lwip/opt.h" +#include "lwip/def.h" + +/** + * These are reference implementations of the byte swapping functions. + * Again with the aim of being simple, correct and fully portable. + * Byte swapping is the second thing you would want to optimize. You will + * need to port it to your architecture and in your cc.h: + * + * #define LWIP_PLATFORM_BYTESWAP 1 + * #define LWIP_PLATFORM_HTONS(x) + * #define LWIP_PLATFORM_HTONL(x) + * + * Note ntohs() and ntohl() are merely references to the htonx counterparts. + */ + +#if (LWIP_PLATFORM_BYTESWAP == 0) && (BYTE_ORDER == LITTLE_ENDIAN) + +/** + * Convert an u16_t from host- to network byte order. + * + * @param n u16_t in host byte order + * @return n in network byte order + */ +u16_t +lwip_htons(u16_t n) +{ + return ((n & 0xff) << 8) | ((n & 0xff00) >> 8); +} + +/** + * Convert an u16_t from network- to host byte order. + * + * @param n u16_t in network byte order + * @return n in host byte order + */ +u16_t +lwip_ntohs(u16_t n) +{ + return lwip_htons(n); +} + +/** + * Convert an u32_t from host- to network byte order. + * + * @param n u32_t in host byte order + * @return n in network byte order + */ +u32_t +lwip_htonl(u32_t n) +{ + return ((n & 0xff) << 24) | + ((n & 0xff00) << 8) | + ((n & 0xff0000UL) >> 8) | + ((n & 0xff000000UL) >> 24); +} + +/** + * Convert an u32_t from network- to host byte order. + * + * @param n u32_t in network byte order + * @return n in host byte order + */ +u32_t +lwip_ntohl(u32_t n) +{ + return lwip_htonl(n); +} + +#endif /* (LWIP_PLATFORM_BYTESWAP == 0) && (BYTE_ORDER == LITTLE_ENDIAN) */ diff --git a/components/lwip/core/dns.c b/components/lwip/core/dns.c new file mode 100755 index 000000000..da8ac95b8 --- /dev/null +++ b/components/lwip/core/dns.c @@ -0,0 +1,1500 @@ +/** + * @file + * DNS - host name to IP address resolver. + * + */ + +/** + + * This file implements a DNS host name to IP address resolver. + + * Port to lwIP from uIP + * by Jim Pettinato April 2007 + + * security fixes and more by Simon Goldschmidt + + * uIP version Copyright (c) 2002-2003, Adam Dunkels. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote + * products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS + * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE + * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, + * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * + * DNS.C + * + * The lwIP DNS resolver functions are used to lookup a host name and + * map it to a numerical IP address. It maintains a list of resolved + * hostnames that can be queried with the dns_lookup() function. + * New hostnames can be resolved using the dns_query() function. + * + * The lwIP version of the resolver also adds a non-blocking version of + * gethostbyname() that will work with a raw API application. This function + * checks for an IP address string first and converts it if it is valid. + * gethostbyname() then does a dns_lookup() to see if the name is + * already in the table. If so, the IP is returned. If not, a query is + * issued and the function returns with a ERR_INPROGRESS status. The app + * using the dns client must then go into a waiting state. + * + * Once a hostname has been resolved (or found to be non-existent), + * the resolver code calls a specified callback function (which + * must be implemented by the module that uses the resolver). + */ + +/*----------------------------------------------------------------------------- + * RFC 1035 - Domain names - implementation and specification + * RFC 2181 - Clarifications to the DNS Specification + *----------------------------------------------------------------------------*/ + +/** @todo: define good default values (rfc compliance) */ +/** @todo: improve answer parsing, more checkings... */ +/** @todo: check RFC1035 - 7.3. Processing responses */ + +/*----------------------------------------------------------------------------- + * Includes + *----------------------------------------------------------------------------*/ + +#include "lwip/opt.h" + +#if LWIP_DNS /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/udp.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/dns.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/** Random generator function to create random TXIDs and source ports for queries */ +#ifndef DNS_RAND_TXID +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_XID) != 0) +#define DNS_RAND_TXID LWIP_RAND +#else +static u16_t dns_txid; +#define DNS_RAND_TXID() (++dns_txid) +#endif +#endif + +/** Limits the source port to be >= 1024 by default */ +#ifndef DNS_PORT_ALLOWED +#define DNS_PORT_ALLOWED(port) ((port) >= 1024) +#endif + +/** DNS server port address */ +#ifndef DNS_SERVER_PORT +#define DNS_SERVER_PORT 53 +#endif + +/** DNS maximum number of retries when asking for a name, before "timeout". */ +#ifndef DNS_MAX_RETRIES +#define DNS_MAX_RETRIES 4 +#endif + +/** DNS resource record max. TTL (one week as default) */ +#ifndef DNS_MAX_TTL +#define DNS_MAX_TTL 604800 +#endif + +/* The number of parallel requests (i.e. calls to dns_gethostbyname + * that cannot be answered from the DNS table. + * This is set to the table size by default. + */ +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING) != 0) +#ifndef DNS_MAX_REQUESTS +#define DNS_MAX_REQUESTS DNS_TABLE_SIZE +#endif +#else +/* In this configuration, both arrays have to have the same size and are used + * like one entry (used/free) */ +#define DNS_MAX_REQUESTS DNS_TABLE_SIZE +#endif + +/* The number of UDP source ports used in parallel */ +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) +#ifndef DNS_MAX_SOURCE_PORTS +#define DNS_MAX_SOURCE_PORTS DNS_MAX_REQUESTS +#endif +#else +#ifdef DNS_MAX_SOURCE_PORTS +#undef DNS_MAX_SOURCE_PORTS +#endif +#define DNS_MAX_SOURCE_PORTS 1 +#endif + +#if LWIP_IPV4 && LWIP_IPV6 +#define LWIP_DNS_ADDRTYPE_IS_IPV6(t) (((t) == LWIP_DNS_ADDRTYPE_IPV6_IPV4) || ((t) == LWIP_DNS_ADDRTYPE_IPV6)) +#define LWIP_DNS_ADDRTYPE_MATCH_IP(t, ip) (IP_IS_V6_VAL(ip) ? LWIP_DNS_ADDRTYPE_IS_IPV6(t) : (!LWIP_DNS_ADDRTYPE_IS_IPV6(t))) +#define LWIP_DNS_ADDRTYPE_ARG(x) , x +#define LWIP_DNS_ADDRTYPE_ARG_OR_ZERO(x) x +#define LWIP_DNS_SET_ADDRTYPE(x, y) do { x = y; } while(0) +#else +#if LWIP_IPV6 +#define LWIP_DNS_ADDRTYPE_IS_IPV6(t) 1 +#else +#define LWIP_DNS_ADDRTYPE_IS_IPV6(t) 0 +#endif +#define LWIP_DNS_ADDRTYPE_MATCH_IP(t, ip) 1 +#define LWIP_DNS_ADDRTYPE_ARG(x) +#define LWIP_DNS_ADDRTYPE_ARG_OR_ZERO(x) 0 +#define LWIP_DNS_SET_ADDRTYPE(x, y) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +/** DNS field TYPE used for "Resource Records" */ +#define DNS_RRTYPE_A 1 /* a host address */ +#define DNS_RRTYPE_NS 2 /* an authoritative name server */ +#define DNS_RRTYPE_MD 3 /* a mail destination (Obsolete - use MX) */ +#define DNS_RRTYPE_MF 4 /* a mail forwarder (Obsolete - use MX) */ +#define DNS_RRTYPE_CNAME 5 /* the canonical name for an alias */ +#define DNS_RRTYPE_SOA 6 /* marks the start of a zone of authority */ +#define DNS_RRTYPE_MB 7 /* a mailbox domain name (EXPERIMENTAL) */ +#define DNS_RRTYPE_MG 8 /* a mail group member (EXPERIMENTAL) */ +#define DNS_RRTYPE_MR 9 /* a mail rename domain name (EXPERIMENTAL) */ +#define DNS_RRTYPE_NULL 10 /* a null RR (EXPERIMENTAL) */ +#define DNS_RRTYPE_WKS 11 /* a well known service description */ +#define DNS_RRTYPE_PTR 12 /* a domain name pointer */ +#define DNS_RRTYPE_HINFO 13 /* host information */ +#define DNS_RRTYPE_MINFO 14 /* mailbox or mail list information */ +#define DNS_RRTYPE_MX 15 /* mail exchange */ +#define DNS_RRTYPE_TXT 16 /* text strings */ +#define DNS_RRTYPE_AAAA 28 /* IPv6 address */ + +/** DNS field CLASS used for "Resource Records" */ +#define DNS_RRCLASS_IN 1 /* the Internet */ +#define DNS_RRCLASS_CS 2 /* the CSNET class (Obsolete - used only for examples in some obsolete RFCs) */ +#define DNS_RRCLASS_CH 3 /* the CHAOS class */ +#define DNS_RRCLASS_HS 4 /* Hesiod [Dyer 87] */ +#define DNS_RRCLASS_FLUSH 0x800 /* Flush bit */ + +/* DNS protocol flags */ +#define DNS_FLAG1_RESPONSE 0x80 +#define DNS_FLAG1_OPCODE_STATUS 0x10 +#define DNS_FLAG1_OPCODE_INVERSE 0x08 +#define DNS_FLAG1_OPCODE_STANDARD 0x00 +#define DNS_FLAG1_AUTHORATIVE 0x04 +#define DNS_FLAG1_TRUNC 0x02 +#define DNS_FLAG1_RD 0x01 +#define DNS_FLAG2_RA 0x80 +#define DNS_FLAG2_ERR_MASK 0x0f +#define DNS_FLAG2_ERR_NONE 0x00 +#define DNS_FLAG2_ERR_NAME 0x03 + +/* DNS protocol states */ +#define DNS_STATE_UNUSED 0 +#define DNS_STATE_NEW 1 +#define DNS_STATE_ASKING 2 +#define DNS_STATE_DONE 3 + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +/** DNS message header */ +struct dns_hdr { + PACK_STRUCT_FIELD(u16_t id); + PACK_STRUCT_FLD_8(u8_t flags1); + PACK_STRUCT_FLD_8(u8_t flags2); + PACK_STRUCT_FIELD(u16_t numquestions); + PACK_STRUCT_FIELD(u16_t numanswers); + PACK_STRUCT_FIELD(u16_t numauthrr); + PACK_STRUCT_FIELD(u16_t numextrarr); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif +#define SIZEOF_DNS_HDR 12 + +/** DNS query message structure. + No packing needed: only used locally on the stack. */ +struct dns_query { + /* DNS query record starts with either a domain name or a pointer + to a name already present somewhere in the packet. */ + u16_t type; + u16_t cls; +}; +#define SIZEOF_DNS_QUERY 4 + +/** DNS answer message structure. + No packing needed: only used locally on the stack. */ +struct dns_answer { + /* DNS answer record starts with either a domain name or a pointer + to a name already present somewhere in the packet. */ + u16_t type; + u16_t cls; + u32_t ttl; + u16_t len; +}; +#define SIZEOF_DNS_ANSWER 10 +/* maximum allowed size for the struct due to non-packed */ +#define SIZEOF_DNS_ANSWER_ASSERT 12 + +/** DNS table entry */ +struct dns_table_entry { + u32_t ttl; + ip_addr_t ipaddr; + u16_t txid; + u8_t state; + u8_t server_idx; + u8_t tmr; + u8_t retries; + u8_t seqno; +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) + u8_t pcb_idx; +#endif + char name[DNS_MAX_NAME_LENGTH]; +#if LWIP_IPV4 && LWIP_IPV6 + u8_t reqaddrtype; +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +}; + +/** DNS request table entry: used when dns_gehostbyname cannot answer the + * request from the DNS table */ +struct dns_req_entry { + /* pointer to callback on DNS query done */ + dns_found_callback found; + /* argument passed to the callback function */ + void *arg; +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING) != 0) + u8_t dns_table_idx; +#endif +#if LWIP_IPV4 && LWIP_IPV6 + u8_t reqaddrtype; +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +}; + +#if DNS_LOCAL_HOSTLIST + +#if DNS_LOCAL_HOSTLIST_IS_DYNAMIC +/** Local host-list. For hostnames in this list, no + * external name resolution is performed */ +static struct local_hostlist_entry *local_hostlist_dynamic; +#else /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + +/** Defining this allows the local_hostlist_static to be placed in a different + * linker section (e.g. FLASH) */ +#ifndef DNS_LOCAL_HOSTLIST_STORAGE_PRE +#define DNS_LOCAL_HOSTLIST_STORAGE_PRE static +#endif /* DNS_LOCAL_HOSTLIST_STORAGE_PRE */ +/** Defining this allows the local_hostlist_static to be placed in a different + * linker section (e.g. FLASH) */ +#ifndef DNS_LOCAL_HOSTLIST_STORAGE_POST +#define DNS_LOCAL_HOSTLIST_STORAGE_POST +#endif /* DNS_LOCAL_HOSTLIST_STORAGE_POST */ +DNS_LOCAL_HOSTLIST_STORAGE_PRE struct local_hostlist_entry local_hostlist_static[] + DNS_LOCAL_HOSTLIST_STORAGE_POST = DNS_LOCAL_HOSTLIST_INIT; + +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + +static void dns_init_local(void); +#endif /* DNS_LOCAL_HOSTLIST */ + + +/* forward declarations */ +static void dns_recv(void *s, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port); +static void dns_check_entries(void); +static void dns_call_found(u8_t idx, ip_addr_t* addr); + +/*----------------------------------------------------------------------------- + * Globals + *----------------------------------------------------------------------------*/ + +/* DNS variables */ +static struct udp_pcb *dns_pcbs[DNS_MAX_SOURCE_PORTS]; +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) +static u8_t dns_last_pcb_idx; +#endif +static u8_t dns_seqno; +static struct dns_table_entry dns_table[DNS_TABLE_SIZE]; +static struct dns_req_entry dns_requests[DNS_MAX_REQUESTS]; +static ip_addr_t dns_servers[DNS_MAX_SERVERS]; + +#ifndef LWIP_DNS_STRICMP +#define LWIP_DNS_STRICMP(str1, str2) dns_stricmp(str1, str2) +/** + * A small but sufficient implementation for case insensitive strcmp. + * This can be defined to e.g. stricmp for windows or strcasecmp for linux. */ +static int +dns_stricmp(const char* str1, const char* str2) +{ + char c1, c2; + + do { + c1 = *str1++; + c2 = *str2++; + if (c1 != c2) { + char c1_upc = c1 | 0x20; + if ((c1_upc >= 'a') && (c1_upc <= 'z')) { + /* characters are not equal an one is in the alphabet range: + downcase both chars and check again */ + char c2_upc = c2 | 0x20; + if (c1_upc != c2_upc) { + /* still not equal */ + /* don't care for < or > */ + return 1; + } + } else { + /* characters are not equal but none is in the alphabet range */ + return 1; + } + } + } while (c1 != 0); + return 0; +} +#endif /* LWIP_DNS_STRICMP */ + +/** + * Initialize the resolver: set up the UDP pcb and configure the default server + * (if DNS_SERVER_ADDRESS is set). + */ +void +dns_init(void) +{ +#ifdef DNS_SERVER_ADDRESS + /* initialize default DNS server address */ + ip_addr_t dnsserver; + DNS_SERVER_ADDRESS(&dnsserver); + dns_setserver(0, &dnsserver); +#endif /* DNS_SERVER_ADDRESS */ + + LWIP_ASSERT("sanity check SIZEOF_DNS_QUERY", + sizeof(struct dns_query) == SIZEOF_DNS_QUERY); + LWIP_ASSERT("sanity check SIZEOF_DNS_ANSWER", + sizeof(struct dns_answer) <= SIZEOF_DNS_ANSWER_ASSERT); + + LWIP_DEBUGF(DNS_DEBUG, ("dns_init: initializing\n")); + + /* if dns client not yet initialized... */ +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) == 0) + if (dns_pcbs[0] == NULL) { + dns_pcbs[0] = udp_new_ip_type(IPADDR_TYPE_ANY); + LWIP_ASSERT("dns_pcbs[0] != NULL", dns_pcbs[0] != NULL); + + /* initialize DNS table not needed (initialized to zero since it is a + * global variable) */ + LWIP_ASSERT("For implicit initialization to work, DNS_STATE_UNUSED needs to be 0", + DNS_STATE_UNUSED == 0); + + /* initialize DNS client */ + udp_bind(dns_pcbs[0], IP_ANY_TYPE, 0); + udp_recv(dns_pcbs[0], dns_recv, NULL); + } +#endif + +#if DNS_LOCAL_HOSTLIST + dns_init_local(); +#endif +} + +/** + * Initialize one of the DNS servers. + * + * @param numdns the index of the DNS server to set must be < DNS_MAX_SERVERS + * @param dnsserver IP address of the DNS server to set + */ +void +dns_setserver(u8_t numdns, const ip_addr_t *dnsserver) +{ + if (numdns < DNS_MAX_SERVERS) { + if (dnsserver != NULL) { + dns_servers[numdns] = (*dnsserver); + } else { + dns_servers[numdns] = *IP_ADDR_ANY; + } + } +} + +/** + * Obtain one of the currently configured DNS server. + * + * @param numdns the index of the DNS server + * @return IP address of the indexed DNS server or "ip_addr_any" if the DNS + * server has not been configured. + */ +ip_addr_t +dns_getserver(u8_t numdns) +{ + if (numdns < DNS_MAX_SERVERS) { + return dns_servers[numdns]; + } else { + return *IP_ADDR_ANY; + } +} + +/** + * The DNS resolver client timer - handle retries and timeouts and should + * be called every DNS_TMR_INTERVAL milliseconds (every second by default). + */ +void +dns_tmr(void) +{ + LWIP_DEBUGF(DNS_DEBUG, ("dns_tmr: dns_check_entries\n")); + dns_check_entries(); +} + +#if DNS_LOCAL_HOSTLIST +static void +dns_init_local(void) +{ +#if DNS_LOCAL_HOSTLIST_IS_DYNAMIC && defined(DNS_LOCAL_HOSTLIST_INIT) + size_t i; + struct local_hostlist_entry *entry; + /* Dynamic: copy entries from DNS_LOCAL_HOSTLIST_INIT to list */ + struct local_hostlist_entry local_hostlist_init[] = DNS_LOCAL_HOSTLIST_INIT; + size_t namelen; + for (i = 0; i < sizeof(local_hostlist_init) / sizeof(struct local_hostlist_entry); i++) { + struct local_hostlist_entry *init_entry = &local_hostlist_init[i]; + LWIP_ASSERT("invalid host name (NULL)", init_entry->name != NULL); + namelen = strlen(init_entry->name); + LWIP_ASSERT("namelen <= DNS_LOCAL_HOSTLIST_MAX_NAMELEN", namelen <= DNS_LOCAL_HOSTLIST_MAX_NAMELEN); + entry = (struct local_hostlist_entry *)memp_malloc(MEMP_LOCALHOSTLIST); + LWIP_ASSERT("mem-error in dns_init_local", entry != NULL); + if (entry != NULL) { + char* entry_name = (char*)entry + sizeof(struct local_hostlist_entry); + MEMCPY(entry_name, init_entry->name, namelen); + entry_name[namelen] = 0; + entry->name = entry_name; + entry->addr = init_entry->addr; + entry->next = local_hostlist_dynamic; + local_hostlist_dynamic = entry; + } + } +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC && defined(DNS_LOCAL_HOSTLIST_INIT) */ +} + +/** + * Scans the local host-list for a hostname. + * + * @param hostname Hostname to look for in the local host-list + * @param addr the first IP address for the hostname in the local host-list or + * IPADDR_NONE if not found. + * @return ERR_OK if found, ERR_ARG if not found + */ +static err_t +dns_lookup_local(const char *hostname, ip_addr_t *addr LWIP_DNS_ADDRTYPE_ARG(u8_t dns_addrtype)) +{ +#if DNS_LOCAL_HOSTLIST_IS_DYNAMIC + struct local_hostlist_entry *entry = local_hostlist_dynamic; + while (entry != NULL) { + if ((LWIP_DNS_STRICMP(entry->name, hostname) == 0) && + LWIP_DNS_ADDRTYPE_MATCH_IP(dns_addrtype, entry->addr)) { + if (addr) { + ip_addr_copy(*addr, entry->addr); + } + return ERR_OK; + } + entry = entry->next; + } +#else /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + size_t i; + for (i = 0; i < sizeof(local_hostlist_static) / sizeof(struct local_hostlist_entry); i++) { + if ((LWIP_DNS_STRICMP(local_hostlist_static[i].name, hostname) == 0) && + LWIP_DNS_ADDRTYPE_MATCH_IP(dns_addrtype, local_hostlist_static[i].addr)) { + if (addr) { + ip_addr_copy(*addr, local_hostlist_static[i].addr); + } + return ERR_OK; + } + } +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + return ERR_ARG; +} + +#if DNS_LOCAL_HOSTLIST_IS_DYNAMIC +/** Remove all entries from the local host-list for a specific hostname + * and/or IP address + * + * @param hostname hostname for which entries shall be removed from the local + * host-list + * @param addr address for which entries shall be removed from the local host-list + * @return the number of removed entries + */ +int +dns_local_removehost(const char *hostname, const ip_addr_t *addr) +{ + int removed = 0; + struct local_hostlist_entry *entry = local_hostlist_dynamic; + struct local_hostlist_entry *last_entry = NULL; + while (entry != NULL) { + if (((hostname == NULL) || !LWIP_DNS_STRICMP(entry->name, hostname)) && + ((addr == NULL) || ip_addr_cmp(&entry->addr, addr))) { + struct local_hostlist_entry *free_entry; + if (last_entry != NULL) { + last_entry->next = entry->next; + } else { + local_hostlist_dynamic = entry->next; + } + free_entry = entry; + entry = entry->next; + memp_free(MEMP_LOCALHOSTLIST, free_entry); + removed++; + } else { + last_entry = entry; + entry = entry->next; + } + } + return removed; +} + +/** + * Add a hostname/IP address pair to the local host-list. + * Duplicates are not checked. + * + * @param hostname hostname of the new entry + * @param addr IP address of the new entry + * @return ERR_OK if succeeded or ERR_MEM on memory error + */ +err_t +dns_local_addhost(const char *hostname, const ip_addr_t *addr) +{ + struct local_hostlist_entry *entry; + size_t namelen; + char* entry_name; + LWIP_ASSERT("invalid host name (NULL)", hostname != NULL); + namelen = strlen(hostname); + LWIP_ASSERT("namelen <= DNS_LOCAL_HOSTLIST_MAX_NAMELEN", namelen <= DNS_LOCAL_HOSTLIST_MAX_NAMELEN); + entry = (struct local_hostlist_entry *)memp_malloc(MEMP_LOCALHOSTLIST); + if (entry == NULL) { + return ERR_MEM; + } + entry_name = (char*)entry + sizeof(struct local_hostlist_entry); + MEMCPY(entry_name, hostname, namelen); + entry_name[namelen] = 0; + entry->name = entry_name; + ip_addr_copy(entry->addr, *addr); + entry->next = local_hostlist_dynamic; + local_hostlist_dynamic = entry; + return ERR_OK; +} +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC*/ +#endif /* DNS_LOCAL_HOSTLIST */ + +/** + * Look up a hostname in the array of known hostnames. + * + * @note This function only looks in the internal array of known + * hostnames, it does not send out a query for the hostname if none + * was found. The function dns_enqueue() can be used to send a query + * for a hostname. + * + * @param name the hostname to look up + * @param addr the hostname's IP address, as u32_t (instead of ip_addr_t to + * better check for failure: != IPADDR_NONE) or IPADDR_NONE if the hostname + * was not found in the cached dns_table. + * @return ERR_OK if found, ERR_ARG if not found + */ +static err_t +dns_lookup(const char *name, ip_addr_t *addr LWIP_DNS_ADDRTYPE_ARG(u8_t dns_addrtype)) +{ + u8_t i; +#if DNS_LOCAL_HOSTLIST || defined(DNS_LOOKUP_LOCAL_EXTERN) +#endif /* DNS_LOCAL_HOSTLIST || defined(DNS_LOOKUP_LOCAL_EXTERN) */ +#if DNS_LOCAL_HOSTLIST + if (dns_lookup_local(name, addr LWIP_DNS_ADDRTYPE_ARG(dns_addrtype)) == ERR_OK) { + return ERR_OK; + } +#endif /* DNS_LOCAL_HOSTLIST */ +#ifdef DNS_LOOKUP_LOCAL_EXTERN + if (DNS_LOOKUP_LOCAL_EXTERN(name, addr, LWIP_DNS_ADDRTYPE_ARG_OR_ZERO(dns_addrtype))) { + return ERR_OK; + } +#endif /* DNS_LOOKUP_LOCAL_EXTERN */ + + /* Walk through name list, return entry if found. If not, return NULL. */ + for (i = 0; i < DNS_TABLE_SIZE; ++i) { + if ((dns_table[i].state == DNS_STATE_DONE) && + (LWIP_DNS_STRICMP(name, dns_table[i].name) == 0) && + LWIP_DNS_ADDRTYPE_MATCH_IP(dns_addrtype, dns_table[i].ipaddr)) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_lookup: \"%s\": found = ", name)); + ip_addr_debug_print(DNS_DEBUG, &(dns_table[i].ipaddr)); + LWIP_DEBUGF(DNS_DEBUG, ("\n")); + if (addr) { + ip_addr_copy(*addr, dns_table[i].ipaddr); + } + return ERR_OK; + } + } + + return ERR_ARG; +} + +/** + * Compare the "dotted" name "query" with the encoded name "response" + * to make sure an answer from the DNS server matches the current dns_table + * entry (otherwise, answers might arrive late for hostname not on the list + * any more). + * + * @param query hostname (not encoded) from the dns_table + * @param p pbuf containing the encoded hostname in the DNS response + * @param start_offset offset into p where the name starts + * @return 0xFFFF: names differ, other: names equal -> offset behind name + */ +static u16_t +dns_compare_name(char *query, struct pbuf* p, u16_t start_offset) +{ + unsigned char n; + u16_t response_offset = start_offset; + + do { + n = pbuf_get_at(p, response_offset++); + /** @see RFC 1035 - 4.1.4. Message compression */ + if ((n & 0xc0) == 0xc0) { + /* Compressed name: cannot be equal since we don't send them */ + return 0xFFFF; + } else { + /* Not compressed name */ + while (n > 0) { + if ((*query) != pbuf_get_at(p, response_offset)) { + return 0xFFFF; + } + ++response_offset; + ++query; + --n; + } + ++query; + } + } while (pbuf_get_at(p, response_offset) != 0); + + return response_offset + 1; +} + +/** + * Walk through a compact encoded DNS name and return the end of the name. + * + * @param p pbuf containing the name + * @param query_idx start index into p pointing to encoded DNS name in the DNS server response + * @return index to end of the name + */ +static u16_t +dns_parse_name(struct pbuf* p, u16_t query_idx) +{ + unsigned char n; + + do { + n = pbuf_get_at(p, query_idx++); + /** @see RFC 1035 - 4.1.4. Message compression */ + if ((n & 0xc0) == 0xc0) { + /* Compressed name */ + break; + } else { + /* Not compressed name */ + while (n > 0) { + ++query_idx; + --n; + } + } + } while (pbuf_get_at(p, query_idx) != 0); + + return query_idx + 1; +} + +/** + * Send a DNS query packet. + * + * @param idx the DNS table entry index for which to send a request + * @return ERR_OK if packet is sent; an err_t indicating the problem otherwise + */ +static err_t +dns_send(u8_t idx) +{ + err_t err; + struct dns_hdr hdr; + struct dns_query qry; + struct pbuf *p; + u16_t query_idx, copy_len; + const char *hostname, *hostname_part; + u8_t n; + u8_t pcb_idx; + struct dns_table_entry* entry = &dns_table[idx]; + + LWIP_DEBUGF(DNS_DEBUG, ("dns_send: dns_servers[%"U16_F"] \"%s\": request\n", + (u16_t)(entry->server_idx), entry->name)); + LWIP_ASSERT("dns server out of array", entry->server_idx < DNS_MAX_SERVERS); + if (ip_addr_isany_val(dns_servers[entry->server_idx])) { + /* DNS server not valid anymore, e.g. PPP netif has been shut down */ + /* call specified callback function if provided */ + dns_call_found(idx, NULL); + /* flush this entry */ + entry->state = DNS_STATE_UNUSED; + return ERR_OK; + } + + /* if here, we have either a new query or a retry on a previous query to process */ + p = pbuf_alloc(PBUF_TRANSPORT, (u16_t)(SIZEOF_DNS_HDR + strlen(entry->name) + 2 + + SIZEOF_DNS_QUERY), PBUF_RAM); + if (p != NULL) { + /* fill dns header */ + memset(&hdr, 0, SIZEOF_DNS_HDR); + hdr.id = htons(entry->txid); + hdr.flags1 = DNS_FLAG1_RD; + hdr.numquestions = PP_HTONS(1); + pbuf_take(p, &hdr, SIZEOF_DNS_HDR); + hostname = entry->name; + --hostname; + + /* convert hostname into suitable query format. */ + query_idx = SIZEOF_DNS_HDR; + do { + ++hostname; + hostname_part = hostname; + for (n = 0; *hostname != '.' && *hostname != 0; ++hostname) { + ++n; + } + copy_len = (u16_t)(hostname - hostname_part); + pbuf_put_at(p, query_idx, n); + pbuf_take_at(p, hostname_part, copy_len, query_idx + 1); + query_idx += n + 1; + } while (*hostname != 0); + pbuf_put_at(p, query_idx, 0); + query_idx++; + + /* fill dns query */ + if (LWIP_DNS_ADDRTYPE_IS_IPV6(entry->reqaddrtype)) { + qry.type = PP_HTONS(DNS_RRTYPE_AAAA); + } else { + qry.type = PP_HTONS(DNS_RRTYPE_A); + } + qry.cls = PP_HTONS(DNS_RRCLASS_IN); + pbuf_take_at(p, &qry, SIZEOF_DNS_QUERY, query_idx); + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) + pcb_idx = entry->pcb_idx; +#else + pcb_idx = 0; +#endif + /* send dns packet */ + LWIP_DEBUGF(DNS_DEBUG, ("sending DNS request ID %d for name \"%s\" to server %d\r\n", + entry->txid, entry->name, entry->server_idx)); + err = udp_sendto(dns_pcbs[pcb_idx], p, &dns_servers[entry->server_idx], DNS_SERVER_PORT); + + /* free pbuf */ + pbuf_free(p); + } else { + err = ERR_MEM; + } + + return err; +} + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) +static struct udp_pcb* +dns_alloc_random_port(void) +{ + err_t err; + struct udp_pcb* ret; + + ret = udp_new_ip_type(IPADDR_TYPE_ANY); + if (ret == NULL) { + /* out of memory, have to reuse an existing pcb */ + return NULL; + } + do { + u16_t port = (u16_t)DNS_RAND_TXID(); + if (!DNS_PORT_ALLOWED(port)) { + /* this port is not allowed, try again */ + err = ERR_USE; + continue; + } + err = udp_bind(ret, IP_ANY_TYPE, port); + } while (err == ERR_USE); + if (err != ERR_OK) { + udp_remove(ret); + return NULL; + } + udp_recv(ret, dns_recv, NULL); + return ret; +} + +/** + * dns_alloc_pcb() - allocates a new pcb (or reuses an existing one) to be used + * for sending a request + * + * @return an index into dns_pcbs + */ +static u8_t +dns_alloc_pcb(void) +{ + u8_t i; + u8_t idx; + + for (i = 0; i < DNS_MAX_SOURCE_PORTS; i++) { + if (dns_pcbs[i] == NULL) { + break; + } + } + if (i < DNS_MAX_SOURCE_PORTS) { + dns_pcbs[i] = dns_alloc_random_port(); + if (dns_pcbs[i] != NULL) { + /* succeeded */ + dns_last_pcb_idx = i; + return i; + } + } + /* if we come here, creating a new UDP pcb failed, so we have to use + an already existing one */ + for (i = 0, idx = dns_last_pcb_idx + 1; i < DNS_MAX_SOURCE_PORTS; i++, idx++) { + if (idx >= DNS_MAX_SOURCE_PORTS) { + idx = 0; + } + if (dns_pcbs[idx] != NULL) { + dns_last_pcb_idx = idx; + return idx; + } + } + return DNS_MAX_SOURCE_PORTS; +} +#endif /* ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) */ + +/** + * dns_call_found() - call the found callback and check if there are duplicate + * entries for the given hostname. If there are any, their found callback will + * be called and they will be removed. + * + * @param idx dns table index of the entry that is resolved or removed + * @param addr IP address for the hostname (or NULL on error or memory shortage) + */ +static void +dns_call_found(u8_t idx, ip_addr_t* addr) +{ +#if ((LWIP_DNS_SECURE & (LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING | LWIP_DNS_SECURE_RAND_SRC_PORT)) != 0) + u8_t i; +#endif + +#if LWIP_IPV4 && LWIP_IPV6 + if (addr != NULL) { + /* check that address type matches the request and adapt the table entry */ + if (IP_IS_V6_VAL(*addr)) { + LWIP_ASSERT("invalid response", LWIP_DNS_ADDRTYPE_IS_IPV6(dns_table[idx].reqaddrtype)); + dns_table[idx].reqaddrtype = LWIP_DNS_ADDRTYPE_IPV6; + } else { + LWIP_ASSERT("invalid response", !LWIP_DNS_ADDRTYPE_IS_IPV6(dns_table[idx].reqaddrtype)); + dns_table[idx].reqaddrtype = LWIP_DNS_ADDRTYPE_IPV4; + } + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING) != 0) + for (i = 0; i < DNS_MAX_REQUESTS; i++) { + if (dns_requests[i].found && (dns_requests[i].dns_table_idx == idx)) { + (*dns_requests[i].found)(dns_table[idx].name, addr, dns_requests[i].arg); + /* flush this entry */ + dns_requests[i].found = NULL; + } + } +#else + if (dns_requests[idx].found) { + (*dns_requests[idx].found)(dns_table[idx].name, addr, dns_requests[idx].arg); + } + dns_requests[idx].found = NULL; +#endif +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) + /* close the pcb used unless other request are using it */ + for (i = 0; i < DNS_MAX_REQUESTS; i++) { + if (i == idx) { + continue; /* only check other requests */ + } + if (dns_table[i].state == DNS_STATE_ASKING) { + if (dns_table[i].pcb_idx == dns_table[idx].pcb_idx) { + /* another request is still using the same pcb */ + dns_table[idx].pcb_idx = DNS_MAX_SOURCE_PORTS; + break; + } + } + } + if (dns_table[idx].pcb_idx < DNS_MAX_SOURCE_PORTS) { + /* if we come here, the pcb is not used any more and can be removed */ + udp_remove(dns_pcbs[dns_table[idx].pcb_idx]); + dns_pcbs[dns_table[idx].pcb_idx] = NULL; + dns_table[idx].pcb_idx = DNS_MAX_SOURCE_PORTS; + } +#endif +} + +/* Create a query transmission ID that is unique for all outstanding queries */ +static u16_t +dns_create_txid(void) +{ + u16_t txid; + u8_t i; + +again: + txid = (u16_t)DNS_RAND_TXID(); + + /* check whether the ID is unique */ + for (i = 0; i < DNS_TABLE_SIZE; i++) { + if ((dns_table[i].state == DNS_STATE_ASKING) && + (dns_table[i].txid == txid)) { + /* ID already used by another pending query */ + goto again; + } + } + + return txid; +} + +/** + * dns_check_entry() - see if entry has not yet been queried and, if so, sends out a query. + * Check an entry in the dns_table: + * - send out query for new entries + * - retry old pending entries on timeout (also with different servers) + * - remove completed entries from the table if their TTL has expired + * + * @param i index of the dns_table entry to check + */ +static void +dns_check_entry(u8_t i) +{ + err_t err; + struct dns_table_entry *entry = &dns_table[i]; + + LWIP_ASSERT("array index out of bounds", i < DNS_TABLE_SIZE); + + switch (entry->state) { + + case DNS_STATE_NEW: { + u16_t txid; + /* initialize new entry */ + txid = dns_create_txid(); + entry->txid = txid; + entry->state = DNS_STATE_ASKING; + entry->server_idx = 0; + entry->tmr = 1; + entry->retries = 0; + + /* send DNS packet for this entry */ + err = dns_send(i); + if (err != ERR_OK) { + LWIP_DEBUGF(DNS_DEBUG | LWIP_DBG_LEVEL_WARNING, + ("dns_send returned error: %s\n", lwip_strerr(err))); + } + break; + } + + case DNS_STATE_ASKING: + if (--entry->tmr == 0) { + if (++entry->retries == DNS_MAX_RETRIES) { + if ((entry->server_idx + 1 < DNS_MAX_SERVERS) && !ip_addr_isany_val(dns_servers[entry->server_idx + 1])) { + /* change of server */ + entry->server_idx++; + entry->tmr = 1; + entry->retries = 0; + } else { + LWIP_DEBUGF(DNS_DEBUG, ("dns_check_entry: \"%s\": timeout\n", entry->name)); + /* call specified callback function if provided */ + dns_call_found(i, NULL); + /* flush this entry */ + entry->state = DNS_STATE_UNUSED; + break; + } + } else { + /* wait longer for the next retry */ + entry->tmr = entry->retries; + } + + /* send DNS packet for this entry */ + err = dns_send(i); + if (err != ERR_OK) { + LWIP_DEBUGF(DNS_DEBUG | LWIP_DBG_LEVEL_WARNING, + ("dns_send returned error: %s\n", lwip_strerr(err))); + } + } + break; + case DNS_STATE_DONE: + /* if the time to live is nul */ + if ((entry->ttl == 0) || (--entry->ttl == 0)) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_check_entry: \"%s\": flush\n", entry->name)); + /* flush this entry, there cannot be any related pending entries in this state */ + entry->state = DNS_STATE_UNUSED; + } + break; + case DNS_STATE_UNUSED: + /* nothing to do */ + break; + default: + LWIP_ASSERT("unknown dns_table entry state:", 0); + break; + } +} + +/** + * Call dns_check_entry for each entry in dns_table - check all entries. + */ +static void +dns_check_entries(void) +{ + u8_t i; + + for (i = 0; i < DNS_TABLE_SIZE; ++i) { + dns_check_entry(i); + } +} + +/** + * Receive input function for DNS response packets arriving for the dns UDP pcb. + * + * @params see udp.h + */ +static void +dns_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port) +{ + u8_t i, entry_idx = DNS_TABLE_SIZE; + u16_t txid; + u16_t res_idx; + struct dns_hdr hdr; + struct dns_answer ans; + struct dns_query qry; + u16_t nquestions, nanswers; + + LWIP_UNUSED_ARG(arg); + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(port); + + /* is the dns message big enough ? */ + if (p->tot_len < (SIZEOF_DNS_HDR + SIZEOF_DNS_QUERY)) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: pbuf too small\n")); + /* free pbuf and return */ + goto memerr; + } + + /* copy dns payload inside static buffer for processing */ + if (pbuf_copy_partial(p, &hdr, SIZEOF_DNS_HDR, 0) == SIZEOF_DNS_HDR) { + /* Match the ID in the DNS header with the name table. */ + txid = htons(hdr.id); + for (i = 0; i < DNS_TABLE_SIZE; i++) { + struct dns_table_entry *entry = &dns_table[i]; + entry_idx = i; + if ((entry->state == DNS_STATE_ASKING) && + (entry->txid == txid)) { + u8_t dns_err; + /* This entry is now completed. */ + +#ifndef LWIP_ESP8266 + entry->state = DNS_STATE_DONE; +#endif + dns_err = hdr.flags2 & DNS_FLAG2_ERR_MASK; + + /* We only care about the question(s) and the answers. The authrr + and the extrarr are simply discarded. */ + nquestions = htons(hdr.numquestions); + nanswers = htons(hdr.numanswers); + + /* Check for error. If so, call callback to inform. */ + if (((hdr.flags1 & DNS_FLAG1_RESPONSE) == 0) || (dns_err != 0) || (nquestions != 1)) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": error in flags\n", entry->name)); + /* call callback to indicate error, clean up memory and return */ +#ifndef LWIP_ESP8266 + goto responseerr; + } +#else + goto memerr; + } + entry->state = DNS_STATE_DONE; +#endif + + + /* Check whether response comes from the same network address to which the + question was sent. (RFC 5452) */ + if (!ip_addr_cmp(addr, &dns_servers[entry->server_idx])) { + /* call callback to indicate error, clean up memory and return */ + goto responseerr; + } + + /* Check if the name in the "question" part match with the name in the entry and + skip it if equal. */ + res_idx = dns_compare_name(entry->name, p, SIZEOF_DNS_HDR); + if (res_idx == 0xFFFF) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response not match to query\n", entry->name)); + /* call callback to indicate error, clean up memory and return */ + goto responseerr; + } + + /* check if "question" part matches the request */ + pbuf_copy_partial(p, &qry, SIZEOF_DNS_QUERY, res_idx); + if ((qry.cls != PP_HTONS(DNS_RRCLASS_IN)) || + (LWIP_DNS_ADDRTYPE_IS_IPV6(entry->reqaddrtype) && (qry.type != PP_HTONS(DNS_RRTYPE_AAAA))) || + (!LWIP_DNS_ADDRTYPE_IS_IPV6(entry->reqaddrtype) && (qry.type != PP_HTONS(DNS_RRTYPE_A)))) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response not match to query\n", entry->name)); + /* call callback to indicate error, clean up memory and return */ + goto responseerr; + } + /* skip the rest of the "question" part */ + res_idx += SIZEOF_DNS_QUERY; + + while ((nanswers > 0) && (res_idx < p->tot_len)) { + /* skip answer resource record's host name */ + res_idx = dns_parse_name(p, res_idx); + + /* Check for IP address type and Internet class. Others are discarded. */ + pbuf_copy_partial(p, &ans, SIZEOF_DNS_ANSWER, res_idx); + if (ans.cls == PP_HTONS(DNS_RRCLASS_IN)) { +#if LWIP_IPV4 + if ((ans.type == PP_HTONS(DNS_RRTYPE_A)) && (ans.len == PP_HTONS(sizeof(ip4_addr_t)))) { +#if LWIP_IPV4 && LWIP_IPV6 + if (!LWIP_DNS_ADDRTYPE_IS_IPV6(entry->reqaddrtype)) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + { + ip4_addr_t ip4addr; + res_idx += SIZEOF_DNS_ANSWER; + /* read the answer resource record's TTL, and maximize it if needed */ + entry->ttl = ntohl(ans.ttl); + if (entry->ttl > DNS_MAX_TTL) { + entry->ttl = DNS_MAX_TTL; + } + /* read the IP address after answer resource record's header */ + pbuf_copy_partial(p, &ip4addr, sizeof(ip4_addr_t), res_idx); + ip_addr_copy_from_ip4(entry->ipaddr, ip4addr); + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response = ", entry->name)); + ip_addr_debug_print(DNS_DEBUG, (&(entry->ipaddr))); + LWIP_DEBUGF(DNS_DEBUG, ("\n")); + /* call specified callback function if provided */ + dns_call_found(entry_idx, &entry->ipaddr); + if (entry->ttl == 0) { + /* RFC 883, page 29: "Zero values are + interpreted to mean that the RR can only be used for the + transaction in progress, and should not be cached." + -> flush this entry now */ + goto flushentry; + } + /* deallocate memory and return */ + goto memerr; + } + } +#endif /* LWIP_IPV4 */ +#if LWIP_IPV6 + if ((ans.type == PP_HTONS(DNS_RRTYPE_AAAA)) && (ans.len == PP_HTONS(sizeof(ip6_addr_t)))) { +#if LWIP_IPV4 && LWIP_IPV6 + if (LWIP_DNS_ADDRTYPE_IS_IPV6(entry->reqaddrtype)) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + { + ip6_addr_t ip6addr; + res_idx += SIZEOF_DNS_ANSWER; + /* read the answer resource record's TTL, and maximize it if needed */ + entry->ttl = ntohl(ans.ttl); + if (entry->ttl > DNS_MAX_TTL) { + entry->ttl = DNS_MAX_TTL; + } + /* read the IP address after answer resource record's header */ + pbuf_copy_partial(p, &ip6addr, sizeof(ip6_addr_t), res_idx); + ip_addr_copy_from_ip6(entry->ipaddr, ip6addr); + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response = ", entry->name)); + ip_addr_debug_print(DNS_DEBUG, (&(entry->ipaddr))); + LWIP_DEBUGF(DNS_DEBUG, (" AAAA\n")); + /* call specified callback function if provided */ + dns_call_found(entry_idx, &entry->ipaddr); + if (entry->ttl == 0) { + /* RFC 883, page 29: "Zero values are + interpreted to mean that the RR can only be used for the + transaction in progress, and should not be cached." + -> flush this entry now */ + goto flushentry; + } + /* deallocate memory and return */ + goto memerr; + } + } +#endif /* LWIP_IPV6 */ + } + /* skip this answer */ + res_idx += SIZEOF_DNS_ANSWER + htons(ans.len); + --nanswers; + } +#if LWIP_IPV4 && LWIP_IPV6 + if ((entry->reqaddrtype == LWIP_DNS_ADDRTYPE_IPV4_IPV6) || + (entry->reqaddrtype == LWIP_DNS_ADDRTYPE_IPV6_IPV4)) { + if (entry->reqaddrtype == LWIP_DNS_ADDRTYPE_IPV4_IPV6) { + /* IPv4 failed, try IPv6 */ + entry->reqaddrtype = LWIP_DNS_ADDRTYPE_IPV6; + } else { + /* IPv6 failed, try IPv4 */ + entry->reqaddrtype = LWIP_DNS_ADDRTYPE_IPV4; + } + pbuf_free(p); + entry->state = DNS_STATE_NEW; + dns_check_entry(entry_idx); + return; + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": error in response\n", entry->name)); + /* call callback to indicate error, clean up memory and return */ + goto responseerr; + } + } + } + + /* deallocate memory and return */ + goto memerr; + +responseerr: + /* ERROR: call specified callback function with NULL as name to indicate an error */ + dns_call_found(entry_idx, NULL); +flushentry: + /* flush this entry */ + dns_table[entry_idx].state = DNS_STATE_UNUSED; + +memerr: + /* free pbuf */ + pbuf_free(p); + return; +} + +/** + * Queues a new hostname to resolve and sends out a DNS query for that hostname + * + * @param name the hostname that is to be queried + * @param hostnamelen length of the hostname + * @param found a callback function to be called on success, failure or timeout + * @param callback_arg argument to pass to the callback function + * @return @return a err_t return code. + */ +static err_t +dns_enqueue(const char *name, size_t hostnamelen, dns_found_callback found, + void *callback_arg LWIP_DNS_ADDRTYPE_ARG(u8_t dns_addrtype)) +{ + u8_t i; + u8_t lseq, lseqi; + struct dns_table_entry *entry = NULL; + size_t namelen; + struct dns_req_entry* req; + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING) != 0) + u8_t r; + /* check for duplicate entries */ + for (i = 0; i < DNS_TABLE_SIZE; i++) { + if ((dns_table[i].state == DNS_STATE_ASKING) && + (LWIP_DNS_STRICMP(name, dns_table[i].name) == 0)) { +#if LWIP_IPV4 && LWIP_IPV6 + if (dns_table[i].reqaddrtype != dns_addrtype) { + /* requested address types don't match + this can lead to 2 concurrent requests, but mixing the address types + for the same host should not be that common */ + continue; + } +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + /* this is a duplicate entry, find a free request entry */ + for (r = 0; r < DNS_MAX_REQUESTS; r++) { + if (dns_requests[r].found == 0) { + dns_requests[r].found = found; + dns_requests[r].arg = callback_arg; + dns_requests[r].dns_table_idx = i; + LWIP_DNS_SET_ADDRTYPE(dns_requests[r].reqaddrtype, dns_addrtype); + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": duplicate request\n", name)); + return ERR_INPROGRESS; + } + } + } + } + /* no duplicate entries found */ +#endif + + /* search an unused entry, or the oldest one */ + lseq = 0; + lseqi = DNS_TABLE_SIZE; + for (i = 0; i < DNS_TABLE_SIZE; ++i) { + entry = &dns_table[i]; + /* is it an unused entry ? */ + if (entry->state == DNS_STATE_UNUSED) { + break; + } + /* check if this is the oldest completed entry */ + if (entry->state == DNS_STATE_DONE) { + if ((u8_t)(dns_seqno - entry->seqno) > lseq) { + lseq = dns_seqno - entry->seqno; + lseqi = i; + } + } + } + + /* if we don't have found an unused entry, use the oldest completed one */ + if (i == DNS_TABLE_SIZE) { + if ((lseqi >= DNS_TABLE_SIZE) || (dns_table[lseqi].state != DNS_STATE_DONE)) { + /* no entry can be used now, table is full */ + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": DNS entries table is full\n", name)); + return ERR_MEM; + } else { + /* use the oldest completed one */ + i = lseqi; + entry = &dns_table[i]; + } + } + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING) != 0) + /* find a free request entry */ + req = NULL; + for (r = 0; r < DNS_MAX_REQUESTS; r++) { + if (dns_requests[r].found == NULL) { + req = &dns_requests[r]; + break; + } + } + if (req == NULL) { + /* no request entry can be used now, table is full */ + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": DNS request entries table is full\n", name)); + return ERR_MEM; + } + req->dns_table_idx = i; +#else + /* in this configuration, the entry index is the same as the request index */ + req = &dns_requests[i]; +#endif + + /* use this entry */ + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": use DNS entry %"U16_F"\n", name, (u16_t)(i))); + + /* fill the entry */ + entry->state = DNS_STATE_NEW; + entry->seqno = dns_seqno; + LWIP_DNS_SET_ADDRTYPE(entry->reqaddrtype, dns_addrtype); + LWIP_DNS_SET_ADDRTYPE(req->reqaddrtype, dns_addrtype); + req->found = found; + req->arg = callback_arg; + namelen = LWIP_MIN(hostnamelen, DNS_MAX_NAME_LENGTH-1); + MEMCPY(entry->name, name, namelen); + entry->name[namelen] = 0; + +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) != 0) + entry->pcb_idx = dns_alloc_pcb(); + if (entry->pcb_idx >= DNS_MAX_SOURCE_PORTS) { + /* failed to get a UDP pcb */ + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": failed to allocate a pcb\n", name)); + entry->state = DNS_STATE_UNUSED; + req->found = NULL; + return ERR_MEM; + } + LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": use DNS pcb %"U16_F"\n", name, (u16_t)(entry->pcb_idx))); +#endif + + dns_seqno++; + + /* force to send query without waiting timer */ + dns_check_entry(i); + + /* dns query is enqueued */ + return ERR_INPROGRESS; +} + +/** + * Resolve a hostname (string) into an IP address. + * NON-BLOCKING callback version for use with raw API!!! + * + * Returns immediately with one of err_t return codes: + * - ERR_OK if hostname is a valid IP address string or the host + * name is already in the local names table. + * - ERR_INPROGRESS enqueue a request to be sent to the DNS server + * for resolution if no errors are present. + * - ERR_ARG: dns client not initialized or invalid hostname + * + * @param hostname the hostname that is to be queried + * @param addr pointer to a ip_addr_t where to store the address if it is already + * cached in the dns_table (only valid if ERR_OK is returned!) + * @param found a callback function to be called on success, failure or timeout (only if + * ERR_INPROGRESS is returned!) + * @param callback_arg argument to pass to the callback function + * @return a err_t return code. + */ +err_t +dns_gethostbyname(const char *hostname, ip_addr_t *addr, dns_found_callback found, + void *callback_arg) +{ + return dns_gethostbyname_addrtype(hostname, addr, found, callback_arg, LWIP_DNS_ADDRTYPE_DEFAULT); +} + +/** Like dns_gethostbyname, but returned address type can be controlled: + * @param dns_addrtype: - LWIP_DNS_ADDRTYPE_IPV4_IPV6: try to resolve IPv4 first, try IPv6 if IPv4 fails only + * - LWIP_DNS_ADDRTYPE_IPV6_IPV4: try to resolve IPv6 first, try IPv4 if IPv6 fails only + * - LWIP_DNS_ADDRTYPE_IPV4: try to resolve IPv4 only + * - LWIP_DNS_ADDRTYPE_IPV6: try to resolve IPv6 only + */ +err_t +dns_gethostbyname_addrtype(const char *hostname, ip_addr_t *addr, dns_found_callback found, + void *callback_arg, u8_t dns_addrtype) +{ + size_t hostnamelen; + /* not initialized or no valid server yet, or invalid addr pointer + * or invalid hostname or invalid hostname length */ + if ((addr == NULL) || + (!hostname) || (!hostname[0])) { + return ERR_ARG; + } +#if ((LWIP_DNS_SECURE & LWIP_DNS_SECURE_RAND_SRC_PORT) == 0) + if (dns_pcbs[0] == NULL) { + return ERR_ARG; + } +#endif + hostnamelen = strlen(hostname); + if (hostnamelen >= DNS_MAX_NAME_LENGTH) { + LWIP_DEBUGF(DNS_DEBUG, ("dns_gethostbyname: name too long to resolve")); + return ERR_ARG; + } + + +#if LWIP_HAVE_LOOPIF + if (strcmp(hostname, "localhost") == 0) { + ip_addr_set_loopback(LWIP_DNS_ADDRTYPE_IS_IPV6(dns_addrtype), addr); + return ERR_OK; + } +#endif /* LWIP_HAVE_LOOPIF */ + + /* host name already in octet notation? set ip addr and return ERR_OK */ + if (ipaddr_aton(hostname, addr)) { +#if LWIP_IPV4 && LWIP_IPV6 + if ((IP_IS_V6(addr) && (dns_addrtype != LWIP_DNS_ADDRTYPE_IPV4)) || + (!IP_IS_V6(addr) && (dns_addrtype != LWIP_DNS_ADDRTYPE_IPV6))) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + { + return ERR_OK; + } + } + /* already have this address cached? */ + if (dns_lookup(hostname, addr LWIP_DNS_ADDRTYPE_ARG(dns_addrtype)) == ERR_OK) { + return ERR_OK; + } +#if LWIP_IPV4 && LWIP_IPV6 + if ((dns_addrtype == LWIP_DNS_ADDRTYPE_IPV4_IPV6) || (dns_addrtype == LWIP_DNS_ADDRTYPE_IPV6_IPV4)) { + /* fallback to 2nd IP type and try again to lookup */ + u8_t fallback; + if (dns_addrtype == LWIP_DNS_ADDRTYPE_IPV4_IPV6) { + fallback = LWIP_DNS_ADDRTYPE_IPV6; + } else { + fallback = LWIP_DNS_ADDRTYPE_IPV4; + } + if (dns_lookup(hostname, addr LWIP_DNS_ADDRTYPE_ARG(fallback)) == ERR_OK) { + return ERR_OK; + } + } +#else /* LWIP_IPV4 && LWIP_IPV6 */ + LWIP_UNUSED_ARG(dns_addrtype); +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + + /* prevent calling found callback if no server is set, return error instead */ + if (ip_addr_isany_val(dns_servers[0])) { + return ERR_VAL; + } + + /* queue query with specified callback */ + return dns_enqueue(hostname, hostnamelen, found, callback_arg LWIP_DNS_ADDRTYPE_ARG(dns_addrtype)); +} + +#endif /* LWIP_DNS */ diff --git a/components/lwip/core/inet_chksum.c b/components/lwip/core/inet_chksum.c new file mode 100755 index 000000000..bcaa3dc82 --- /dev/null +++ b/components/lwip/core/inet_chksum.c @@ -0,0 +1,612 @@ +/** + * @file + * Incluse internet checksum functions. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/inet_chksum.h" +#include "lwip/def.h" +#include "lwip/ip_addr.h" + +#include +#include + +/* These are some reference implementations of the checksum algorithm, with the + * aim of being simple, correct and fully portable. Checksumming is the + * first thing you would want to optimize for your platform. If you create + * your own version, link it in and in your cc.h put: + * + * #define LWIP_CHKSUM + * + * Or you can select from the implementations below by defining + * LWIP_CHKSUM_ALGORITHM to 1, 2 or 3. + */ + +#ifndef LWIP_CHKSUM +# define LWIP_CHKSUM lwip_standard_chksum +# ifndef LWIP_CHKSUM_ALGORITHM +# define LWIP_CHKSUM_ALGORITHM 2 +# endif +u16_t lwip_standard_chksum(const void *dataptr, int len); +#endif +/* If none set: */ +#ifndef LWIP_CHKSUM_ALGORITHM +# define LWIP_CHKSUM_ALGORITHM 0 +#endif + +#if (LWIP_CHKSUM_ALGORITHM == 1) /* Version #1 */ +/** + * lwip checksum + * + * @param dataptr points to start of data to be summed at any boundary + * @param len length of data to be summed + * @return host order (!) lwip checksum (non-inverted Internet sum) + * + * @note accumulator size limits summable length to 64k + * @note host endianess is irrelevant (p3 RFC1071) + */ +u16_t +lwip_standard_chksum(const void *dataptr, int len) +{ + u32_t acc; + u16_t src; + const u8_t *octetptr; + + acc = 0; + /* dataptr may be at odd or even addresses */ + octetptr = (const u8_t*)dataptr; + while (len > 1) { + /* declare first octet as most significant + thus assume network order, ignoring host order */ + src = (*octetptr) << 8; + octetptr++; + /* declare second octet as least significant */ + src |= (*octetptr); + octetptr++; + acc += src; + len -= 2; + } + if (len > 0) { + /* accumulate remaining octet */ + src = (*octetptr) << 8; + acc += src; + } + /* add deferred carry bits */ + acc = (acc >> 16) + (acc & 0x0000ffffUL); + if ((acc & 0xffff0000UL) != 0) { + acc = (acc >> 16) + (acc & 0x0000ffffUL); + } + /* This maybe a little confusing: reorder sum using htons() + instead of ntohs() since it has a little less call overhead. + The caller must invert bits for Internet sum ! */ + return htons((u16_t)acc); +} +#endif + +#if (LWIP_CHKSUM_ALGORITHM == 2) /* Alternative version #2 */ +/* + * Curt McDowell + * Broadcom Corp. + * csm@broadcom.com + * + * IP checksum two bytes at a time with support for + * unaligned buffer. + * Works for len up to and including 0x20000. + * by Curt McDowell, Broadcom Corp. 12/08/2005 + * + * @param dataptr points to start of data to be summed at any boundary + * @param len length of data to be summed + * @return host order (!) lwip checksum (non-inverted Internet sum) + */ +u16_t +lwip_standard_chksum(const void *dataptr, int len) +{ + const u8_t *pb = (const u8_t *)dataptr; + const u16_t *ps; + u16_t t = 0; + u32_t sum = 0; + int odd = ((mem_ptr_t)pb & 1); + + /* Get aligned to u16_t */ + if (odd && len > 0) { + ((u8_t *)&t)[1] = *pb++; + len--; + } + + /* Add the bulk of the data */ + ps = (const u16_t *)(const void *)pb; + while (len > 1) { + sum += *ps++; + len -= 2; + } + + /* Consume left-over byte, if any */ + if (len > 0) { + ((u8_t *)&t)[0] = *(const u8_t *)ps; + } + + /* Add end bytes */ + sum += t; + + /* Fold 32-bit sum to 16 bits + calling this twice is probably faster than if statements... */ + sum = FOLD_U32T(sum); + sum = FOLD_U32T(sum); + + /* Swap if alignment was odd */ + if (odd) { + sum = SWAP_BYTES_IN_WORD(sum); + } + + return (u16_t)sum; +} +#endif + +#if (LWIP_CHKSUM_ALGORITHM == 3) /* Alternative version #3 */ +/** + * An optimized checksum routine. Basically, it uses loop-unrolling on + * the checksum loop, treating the head and tail bytes specially, whereas + * the inner loop acts on 8 bytes at a time. + * + * @arg start of buffer to be checksummed. May be an odd byte address. + * @len number of bytes in the buffer to be checksummed. + * @return host order (!) lwip checksum (non-inverted Internet sum) + * + * by Curt McDowell, Broadcom Corp. December 8th, 2005 + */ +u16_t +lwip_standard_chksum(const void *dataptr, int len) +{ + const u8_t *pb = (const u8_t *)dataptr; + const u16_t *ps; + u16_t t = 0; + const u32_t *pl; + u32_t sum = 0, tmp; + /* starts at odd byte address? */ + int odd = ((mem_ptr_t)pb & 1); + + if (odd && len > 0) { + ((u8_t *)&t)[1] = *pb++; + len--; + } + + ps = (const u16_t *)(const void*)pb; + + if (((mem_ptr_t)ps & 3) && len > 1) { + sum += *ps++; + len -= 2; + } + + pl = (const u32_t *)(const void*)ps; + + while (len > 7) { + tmp = sum + *pl++; /* ping */ + if (tmp < sum) { + tmp++; /* add back carry */ + } + + sum = tmp + *pl++; /* pong */ + if (sum < tmp) { + sum++; /* add back carry */ + } + + len -= 8; + } + + /* make room in upper bits */ + sum = FOLD_U32T(sum); + + ps = (const u16_t *)pl; + + /* 16-bit aligned word remaining? */ + while (len > 1) { + sum += *ps++; + len -= 2; + } + + /* dangling tail byte remaining? */ + if (len > 0) { /* include odd byte */ + ((u8_t *)&t)[0] = *(const u8_t *)ps; + } + + sum += t; /* add end bytes */ + + /* Fold 32-bit sum to 16 bits + calling this twice is probably faster than if statements... */ + sum = FOLD_U32T(sum); + sum = FOLD_U32T(sum); + + if (odd) { + sum = SWAP_BYTES_IN_WORD(sum); + } + + return (u16_t)sum; +} +#endif + +/** Parts of the pseudo checksum which are common to IPv4 and IPv6 */ +static u16_t +inet_cksum_pseudo_base(struct pbuf *p, u8_t proto, u16_t proto_len, u32_t acc) +{ + struct pbuf *q; + u8_t swapped = 0; + + /* iterate through all pbuf in chain */ + for (q = p; q != NULL; q = q->next) { + LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): checksumming pbuf %p (has next %p) \n", + (void *)q, (void *)q->next)); + acc += LWIP_CHKSUM(q->payload, q->len); + /*LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): unwrapped lwip_chksum()=%"X32_F" \n", acc));*/ + /* just executing this next line is probably faster that the if statement needed + to check whether we really need to execute it, and does no harm */ + acc = FOLD_U32T(acc); + if (q->len % 2 != 0) { + swapped = 1 - swapped; + acc = SWAP_BYTES_IN_WORD(acc); + } + /*LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): wrapped lwip_chksum()=%"X32_F" \n", acc));*/ + } + + if (swapped) { + acc = SWAP_BYTES_IN_WORD(acc); + } + + acc += (u32_t)htons((u16_t)proto); + acc += (u32_t)htons(proto_len); + + /* Fold 32-bit sum to 16 bits + calling this twice is probably faster than if statements... */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): pbuf chain lwip_chksum()=%"X32_F"\n", acc)); + return (u16_t)~(acc & 0xffffUL); +} + +#if LWIP_IPV4 +/* inet_chksum_pseudo: + * + * Calculates the IPv4 pseudo Internet checksum used by TCP and UDP for a pbuf chain. + * IP addresses are expected to be in network byte order. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ip address (used for checksum of pseudo header) + * @param dst destination ip address (used for checksum of pseudo header) + * @param proto ip protocol (used for checksum of pseudo header) + * @param proto_len length of the ip data part (used for checksum of pseudo header) + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +inet_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip4_addr_t *src, const ip4_addr_t *dest) +{ + u32_t acc; + u32_t addr; + + addr = ip4_addr_get_u32(src); + acc = (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + addr = ip4_addr_get_u32(dest); + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + /* fold down to 16 bits */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + + return inet_cksum_pseudo_base(p, proto, proto_len, acc); +} +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +/** + * Calculates the checksum with IPv6 pseudo header used by TCP and UDP for a pbuf chain. + * IPv6 addresses are expected to be in network byte order. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ipv6 address (used for checksum of pseudo header) + * @param dst destination ipv6 address (used for checksum of pseudo header) + * @param proto ipv6 protocol/next header (used for checksum of pseudo header) + * @param proto_len length of the ipv6 payload (used for checksum of pseudo header) + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +ip6_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip6_addr_t *src, const ip6_addr_t *dest) +{ + u32_t acc = 0; + u32_t addr; + u8_t addr_part; + + for (addr_part = 0; addr_part < 4; addr_part++) { + addr = src->addr[addr_part]; + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + addr = dest->addr[addr_part]; + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + } + /* fold down to 16 bits */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + + return inet_cksum_pseudo_base(p, proto, proto_len, acc); +} +#endif /* LWIP_IPV6 */ + +/* ip_chksum_pseudo: + * + * Calculates the IPv4 or IPv6 pseudo Internet checksum used by TCP and UDP for a pbuf chain. + * IP addresses are expected to be in network byte order. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ip address (used for checksum of pseudo header) + * @param dst destination ip address (used for checksum of pseudo header) + * @param proto ip protocol (used for checksum of pseudo header) + * @param proto_len length of the ip data part (used for checksum of pseudo header) + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +ip_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip_addr_t *src, const ip_addr_t *dest) +{ +#if LWIP_IPV6 + if (IP_IS_V6(dest)) { + return ip6_chksum_pseudo(p, proto, proto_len, ip_2_ip6(src), ip_2_ip6(dest)); + } +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 && LWIP_IPV6 + else +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +#if LWIP_IPV4 + { + return inet_chksum_pseudo(p, proto, proto_len, ip_2_ip4(src), ip_2_ip4(dest)); + } +#endif /* LWIP_IPV4 */ +} + +/** Parts of the pseudo checksum which are common to IPv4 and IPv6 */ +static u16_t +inet_cksum_pseudo_partial_base(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, u32_t acc) +{ + struct pbuf *q; + u8_t swapped = 0; + u16_t chklen; + + /* iterate through all pbuf in chain */ + for (q = p; (q != NULL) && (chksum_len > 0); q = q->next) { + LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): checksumming pbuf %p (has next %p) \n", + (void *)q, (void *)q->next)); + chklen = q->len; + if (chklen > chksum_len) { + chklen = chksum_len; + } + acc += LWIP_CHKSUM(q->payload, chklen); + chksum_len -= chklen; + LWIP_ASSERT("delete me", chksum_len < 0x7fff); + /*LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): unwrapped lwip_chksum()=%"X32_F" \n", acc));*/ + /* fold the upper bit down */ + acc = FOLD_U32T(acc); + if (q->len % 2 != 0) { + swapped = 1 - swapped; + acc = SWAP_BYTES_IN_WORD(acc); + } + /*LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): wrapped lwip_chksum()=%"X32_F" \n", acc));*/ + } + + if (swapped) { + acc = SWAP_BYTES_IN_WORD(acc); + } + + acc += (u32_t)htons((u16_t)proto); + acc += (u32_t)htons(proto_len); + + /* Fold 32-bit sum to 16 bits + calling this twice is probably faster than if statements... */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + LWIP_DEBUGF(INET_DEBUG, ("inet_chksum_pseudo(): pbuf chain lwip_chksum()=%"X32_F"\n", acc)); + return (u16_t)~(acc & 0xffffUL); +} + +#if LWIP_IPV4 +/* inet_chksum_pseudo_partial: + * + * Calculates the IPv4 pseudo Internet checksum used by TCP and UDP for a pbuf chain. + * IP addresses are expected to be in network byte order. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ip address (used for checksum of pseudo header) + * @param dst destination ip address (used for checksum of pseudo header) + * @param proto ip protocol (used for checksum of pseudo header) + * @param proto_len length of the ip data part (used for checksum of pseudo header) + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +inet_chksum_pseudo_partial(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, const ip4_addr_t *src, const ip4_addr_t *dest) +{ + u32_t acc; + u32_t addr; + + addr = ip4_addr_get_u32(src); + acc = (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + addr = ip4_addr_get_u32(dest); + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + /* fold down to 16 bits */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + + return inet_cksum_pseudo_partial_base(p, proto, proto_len, chksum_len, acc); +} +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +/** + * Calculates the checksum with IPv6 pseudo header used by TCP and UDP for a pbuf chain. + * IPv6 addresses are expected to be in network byte order. Will only compute for a + * portion of the payload. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ipv6 address (used for checksum of pseudo header) + * @param dst destination ipv6 address (used for checksum of pseudo header) + * @param proto ipv6 protocol/next header (used for checksum of pseudo header) + * @param proto_len length of the ipv6 payload (used for checksum of pseudo header) + * @param chksum_len number of payload bytes used to compute chksum + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +ip6_chksum_pseudo_partial(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, const ip6_addr_t *src, const ip6_addr_t *dest) +{ + u32_t acc = 0; + u32_t addr; + u8_t addr_part; + + for (addr_part = 0; addr_part < 4; addr_part++) { + addr = src->addr[addr_part]; + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + addr = dest->addr[addr_part]; + acc += (addr & 0xffffUL); + acc += ((addr >> 16) & 0xffffUL); + } + /* fold down to 16 bits */ + acc = FOLD_U32T(acc); + acc = FOLD_U32T(acc); + + return inet_cksum_pseudo_partial_base(p, proto, proto_len, chksum_len, acc); +} +#endif /* LWIP_IPV6 */ + +/* ip_chksum_pseudo_partial: + * + * Calculates the IPv4 or IPv6 pseudo Internet checksum used by TCP and UDP for a pbuf chain. + * + * @param p chain of pbufs over that a checksum should be calculated (ip data part) + * @param src source ip address (used for checksum of pseudo header) + * @param dst destination ip address (used for checksum of pseudo header) + * @param proto ip protocol (used for checksum of pseudo header) + * @param proto_len length of the ip data part (used for checksum of pseudo header) + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +ip_chksum_pseudo_partial(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, const ip_addr_t *src, const ip_addr_t *dest) +{ +#if LWIP_IPV6 + if (IP_IS_V6(dest)) { + return ip6_chksum_pseudo_partial(p, proto, proto_len, chksum_len, ip_2_ip6(src), ip_2_ip6(dest)); + } +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 && LWIP_IPV6 + else +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +#if LWIP_IPV4 + { + return inet_chksum_pseudo_partial(p, proto, proto_len, chksum_len, ip_2_ip4(src), ip_2_ip4(dest)); + } +#endif /* LWIP_IPV4 */ +} + +/* inet_chksum: + * + * Calculates the Internet checksum over a portion of memory. Used primarily for IP + * and ICMP. + * + * @param dataptr start of the buffer to calculate the checksum (no alignment needed) + * @param len length of the buffer to calculate the checksum + * @return checksum (as u16_t) to be saved directly in the protocol header + */ + +u16_t +inet_chksum(const void *dataptr, u16_t len) +{ + return (u16_t)~(unsigned int)LWIP_CHKSUM(dataptr, len); +} + +/** + * Calculate a checksum over a chain of pbufs (without pseudo-header, much like + * inet_chksum only pbufs are used). + * + * @param p pbuf chain over that the checksum should be calculated + * @return checksum (as u16_t) to be saved directly in the protocol header + */ +u16_t +inet_chksum_pbuf(struct pbuf *p) +{ + u32_t acc; + struct pbuf *q; + u8_t swapped; + + acc = 0; + swapped = 0; + for (q = p; q != NULL; q = q->next) { + acc += LWIP_CHKSUM(q->payload, q->len); + acc = FOLD_U32T(acc); + if (q->len % 2 != 0) { + swapped = 1 - swapped; + acc = SWAP_BYTES_IN_WORD(acc); + } + } + + if (swapped) { + acc = SWAP_BYTES_IN_WORD(acc); + } + return (u16_t)~(acc & 0xffffUL); +} + +/* These are some implementations for LWIP_CHKSUM_COPY, which copies data + * like MEMCPY but generates a checksum at the same time. Since this is a + * performance-sensitive function, you might want to create your own version + * in assembly targeted at your hardware by defining it in lwipopts.h: + * #define LWIP_CHKSUM_COPY(dst, src, len) your_chksum_copy(dst, src, len) + */ + +#if (LWIP_CHKSUM_COPY_ALGORITHM == 1) /* Version #1 */ +/** Safe but slow: first call MEMCPY, then call LWIP_CHKSUM. + * For architectures with big caches, data might still be in cache when + * generating the checksum after copying. + */ +u16_t +lwip_chksum_copy(void *dst, const void *src, u16_t len) +{ + MEMCPY(dst, src, len); + return LWIP_CHKSUM(dst, len); +} +#endif /* (LWIP_CHKSUM_COPY_ALGORITHM == 1) */ diff --git a/components/lwip/core/init.c b/components/lwip/core/init.c new file mode 100755 index 000000000..2a410d0e4 --- /dev/null +++ b/components/lwip/core/init.c @@ -0,0 +1,378 @@ +/** + * @file + * Modules initialization + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/init.h" +#include "lwip/stats.h" +#include "lwip/sys.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/pbuf.h" +#include "lwip/netif.h" +#include "lwip/sockets.h" +#include "lwip/ip.h" +#include "lwip/raw.h" +#include "lwip/udp.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/autoip.h" +#include "lwip/igmp.h" +#include "lwip/dns.h" +#include "lwip/timers.h" +#include "netif/etharp.h" +#include "lwip/ip6.h" +#include "lwip/nd6.h" +#include "lwip/mld6.h" +#include "lwip/api.h" +#include "netif/ppp/ppp_impl.h" + +#ifndef PERF +/* Compile-time sanity checks for configuration errors. + * These can be done independently of LWIP_DEBUG, without penalty. + */ +#ifndef BYTE_ORDER + #error "BYTE_ORDER is not defined, you have to define it in your cc.h" +#endif +#if (!IP_SOF_BROADCAST && IP_SOF_BROADCAST_RECV) + #error "If you want to use broadcast filter per pcb on recv operations, you have to define IP_SOF_BROADCAST=1 in your lwipopts.h" +#endif +#if (!LWIP_UDP && LWIP_UDPLITE) + #error "If you want to use UDP Lite, you have to define LWIP_UDP=1 in your lwipopts.h" +#endif +#if (!LWIP_UDP && LWIP_DHCP) + #error "If you want to use DHCP, you have to define LWIP_UDP=1 in your lwipopts.h" +#endif +#if (!LWIP_UDP && LWIP_MULTICAST_TX_OPTIONS) + #error "If you want to use IGMP/LWIP_MULTICAST_TX_OPTIONS, you have to define LWIP_UDP=1 in your lwipopts.h" +#endif +#if (!LWIP_UDP && LWIP_DNS) + #error "If you want to use DNS, you have to define LWIP_UDP=1 in your lwipopts.h" +#endif +#if !MEMP_MEM_MALLOC /* MEMP_NUM_* checks are disabled when not using the pool allocator */ +#if (LWIP_ARP && ARP_QUEUEING && (MEMP_NUM_ARP_QUEUE<=0)) + #error "If you want to use ARP Queueing, you have to define MEMP_NUM_ARP_QUEUE>=1 in your lwipopts.h" +#endif +#if (LWIP_RAW && (MEMP_NUM_RAW_PCB<=0)) + #error "If you want to use RAW, you have to define MEMP_NUM_RAW_PCB>=1 in your lwipopts.h" +#endif +#if (LWIP_UDP && (MEMP_NUM_UDP_PCB<=0)) + #error "If you want to use UDP, you have to define MEMP_NUM_UDP_PCB>=1 in your lwipopts.h" +#endif +#if (LWIP_TCP && (MEMP_NUM_TCP_PCB<=0)) + #error "If you want to use TCP, you have to define MEMP_NUM_TCP_PCB>=1 in your lwipopts.h" +#endif +#if (LWIP_IGMP && (MEMP_NUM_IGMP_GROUP<=1)) + #error "If you want to use IGMP, you have to define MEMP_NUM_IGMP_GROUP>1 in your lwipopts.h" +#endif +#if (LWIP_IGMP && !LWIP_MULTICAST_TX_OPTIONS) + #error "If you want to use IGMP, you have to define LWIP_MULTICAST_TX_OPTIONS==1 in your lwipopts.h" +#endif +#if (LWIP_IGMP && !LWIP_IPV4) + #error "IGMP needs LWIP_IPV4 enabled in your lwipopts.h" +#endif +#if (LWIP_MULTICAST_TX_OPTIONS && !LWIP_IPV4) + #error "LWIP_MULTICAST_TX_OPTIONS needs LWIP_IPV4 enabled in your lwipopts.h" +#endif +#if ((LWIP_NETCONN || LWIP_SOCKET) && (MEMP_NUM_TCPIP_MSG_API<=0)) + #error "If you want to use Sequential API, you have to define MEMP_NUM_TCPIP_MSG_API>=1 in your lwipopts.h" +#endif +/* There must be sufficient timeouts, taking into account requirements of the subsystems. */ +#if LWIP_TIMERS && (MEMP_NUM_SYS_TIMEOUT < (LWIP_TCP + IP_REASSEMBLY + LWIP_ARP + (2*LWIP_DHCP) + LWIP_AUTOIP + LWIP_IGMP + LWIP_DNS + PPP_SUPPORT + (LWIP_IPV6 ? (1 + LWIP_IPV6_REASS + LWIP_IPV6_MLD) : 0))) + #error "MEMP_NUM_SYS_TIMEOUT is too low to accomodate all required timeouts" +#endif +#if (IP_REASSEMBLY && (MEMP_NUM_REASSDATA > IP_REASS_MAX_PBUFS)) + #error "MEMP_NUM_REASSDATA > IP_REASS_MAX_PBUFS doesn't make sense since each struct ip_reassdata must hold 2 pbufs at least!" +#endif +#endif /* !MEMP_MEM_MALLOC */ + +#if LWIP_WND_SCALE +//#if (LWIP_TCP && (TCP_WND > 0xffffffff)) + //#error "If you want to use TCP, TCP_WND must fit in an u32_t, so, you have to reduce it in your lwipopts.h" +//#endif +#if (LWIP_TCP && LWIP_WND_SCALE && (TCP_RCV_SCALE > 14)) + #error "The maximum valid window scale value is 14!" +#endif +//#if (LWIP_TCP && (TCP_WND > (0xFFFFU << TCP_RCV_SCALE))) + //#error "TCP_WND is bigger than the configured LWIP_WND_SCALE allows!" +//#endif +//#if (LWIP_TCP && ((TCP_WND >> TCP_RCV_SCALE) == 0)) + //#error "TCP_WND is too small for the configured LWIP_WND_SCALE (results in zero window)!" +//#endif +#else /* LWIP_WND_SCALE */ + +#ifndef LWIP_ESP8266 +#if (LWIP_TCP && (TCP_WND > 0xffff)) + #error "If you want to use TCP, TCP_WND must fit in an u16_t, so, you have to reduce it in your lwipopts.h (or enable window scaling)" +#endif +#endif + +#endif /* LWIP_WND_SCALE */ +#if (LWIP_TCP && (TCP_SND_QUEUELEN > 0xffff)) + #error "If you want to use TCP, TCP_SND_QUEUELEN must fit in an u16_t, so, you have to reduce it in your lwipopts.h" +#endif +#if (LWIP_TCP && (TCP_SND_QUEUELEN < 2)) + #error "TCP_SND_QUEUELEN must be at least 2 for no-copy TCP writes to work" +#endif + +#ifndef LWIP_ESP8266 +#if (LWIP_TCP && ((TCP_MAXRTX > 12) || (TCP_SYNMAXRTX > 12))) + #error "If you want to use TCP, TCP_MAXRTX and TCP_SYNMAXRTX must less or equal to 12 (due to tcp_backoff table), so, you have to reduce them in your lwipopts.h" +#endif +#endif + +#if (LWIP_TCP && TCP_LISTEN_BACKLOG && ((TCP_DEFAULT_LISTEN_BACKLOG < 0) || (TCP_DEFAULT_LISTEN_BACKLOG > 0xff))) + #error "If you want to use TCP backlog, TCP_DEFAULT_LISTEN_BACKLOG must fit into an u8_t" +#endif +#if (LWIP_NETIF_API && (NO_SYS==1)) + #error "If you want to use NETIF API, you have to define NO_SYS=0 in your lwipopts.h" +#endif +#if ((LWIP_SOCKET || LWIP_NETCONN) && (NO_SYS==1)) + #error "If you want to use Sequential API, you have to define NO_SYS=0 in your lwipopts.h" +#endif +#if (LWIP_PPP_API && (NO_SYS==1)) + #error "If you want to use PPP API, you have to define NO_SYS=0 in your lwipopts.h" +#endif +#if (LWIP_PPP_API && (PPP_SUPPORT==0)) + #error "If you want to use PPP API, you have to enable PPP_SUPPORT in your lwipopts.h" +#endif +#if (((!LWIP_DHCP) || (!LWIP_AUTOIP)) && LWIP_DHCP_AUTOIP_COOP) + #error "If you want to use DHCP/AUTOIP cooperation mode, you have to define LWIP_DHCP=1 and LWIP_AUTOIP=1 in your lwipopts.h" +#endif +#if (((!LWIP_DHCP) || (!LWIP_ARP)) && DHCP_DOES_ARP_CHECK) + #error "If you want to use DHCP ARP checking, you have to define LWIP_DHCP=1 and LWIP_ARP=1 in your lwipopts.h" +#endif +#if (!LWIP_ARP && LWIP_AUTOIP) + #error "If you want to use AUTOIP, you have to define LWIP_ARP=1 in your lwipopts.h" +#endif +#if (LWIP_TCP && ((LWIP_EVENT_API && LWIP_CALLBACK_API) || (!LWIP_EVENT_API && !LWIP_CALLBACK_API))) + #error "One and exactly one of LWIP_EVENT_API and LWIP_CALLBACK_API has to be enabled in your lwipopts.h" +#endif +#if (MEM_LIBC_MALLOC && MEM_USE_POOLS) + #error "MEM_LIBC_MALLOC and MEM_USE_POOLS may not both be simultaneously enabled in your lwipopts.h" +#endif +#if (MEM_USE_POOLS && !MEMP_USE_CUSTOM_POOLS) + #error "MEM_USE_POOLS requires custom pools (MEMP_USE_CUSTOM_POOLS) to be enabled in your lwipopts.h" +#endif +#if (PBUF_POOL_BUFSIZE <= MEM_ALIGNMENT) + #error "PBUF_POOL_BUFSIZE must be greater than MEM_ALIGNMENT or the offset may take the full first pbuf" +#endif +#if (DNS_LOCAL_HOSTLIST && !DNS_LOCAL_HOSTLIST_IS_DYNAMIC && !(defined(DNS_LOCAL_HOSTLIST_INIT))) + #error "you have to define define DNS_LOCAL_HOSTLIST_INIT {{'host1', 0x123}, {'host2', 0x234}} to initialize DNS_LOCAL_HOSTLIST" +#endif +#if PPP_SUPPORT && !PPPOS_SUPPORT && !PPPOE_SUPPORT && !PPPOL2TP_SUPPORT + #error "PPP_SUPPORT needs at least one of PPPOS_SUPPORT, PPPOE_SUPPORT or PPPOL2TP_SUPPORT turned on" +#endif +#if PPP_SUPPORT && !PPP_IPV4_SUPPORT && !PPP_IPV6_SUPPORT + #error "PPP_SUPPORT needs PPP_IPV4_SUPPORT and/or PPP_IPV6_SUPPORT turned on" +#endif +#if PPP_SUPPORT && PPP_IPV4_SUPPORT && !LWIP_IPV4 + #error "PPP_IPV4_SUPPORT needs LWIP_IPV4 turned on" +#endif +#if PPP_SUPPORT && PPP_IPV6_SUPPORT && !LWIP_IPV6 + #error "PPP_IPV6_SUPPORT needs LWIP_IPV6 turned on" +#endif +#if !LWIP_ETHERNET && (LWIP_ARP || PPPOE_SUPPORT) + #error "LWIP_ETHERNET needs to be turned on for LWIP_ARP or PPPOE_SUPPORT" +#endif +#if (LWIP_IGMP || LWIP_IPV6) && !defined(LWIP_RAND) + #error "When using IGMP or IPv6, LWIP_RAND() needs to be defined to a random-function returning an u32_t random value" +#endif +#if LWIP_TCPIP_CORE_LOCKING_INPUT && !LWIP_TCPIP_CORE_LOCKING + #error "When using LWIP_TCPIP_CORE_LOCKING_INPUT, LWIP_TCPIP_CORE_LOCKING must be enabled, too" +#endif +#if LWIP_TCP && LWIP_NETIF_TX_SINGLE_PBUF && !TCP_OVERSIZE + #error "LWIP_NETIF_TX_SINGLE_PBUF needs TCP_OVERSIZE enabled to create single-pbuf TCP packets" +#endif +#if IP_FRAG && IP_FRAG_USES_STATIC_BUF && LWIP_NETIF_TX_SINGLE_PBUF + #error "LWIP_NETIF_TX_SINGLE_PBUF does not work with IP_FRAG_USES_STATIC_BUF==1 as that creates pbuf queues" +#endif +#if LWIP_NETCONN && LWIP_TCP +#if NETCONN_COPY != TCP_WRITE_FLAG_COPY + #error "NETCONN_COPY != TCP_WRITE_FLAG_COPY" +#endif +#if NETCONN_MORE != TCP_WRITE_FLAG_MORE + #error "NETCONN_MORE != TCP_WRITE_FLAG_MORE" +#endif +#endif /* LWIP_NETCONN && LWIP_TCP */ +#if LWIP_SOCKET +/* Check that the SO_* socket options and SOF_* lwIP-internal flags match */ +#if SO_REUSEADDR != SOF_REUSEADDR + #error "WARNING: SO_REUSEADDR != SOF_REUSEADDR" +#endif +#if SO_KEEPALIVE != SOF_KEEPALIVE + #error "WARNING: SO_KEEPALIVE != SOF_KEEPALIVE" +#endif +#if SO_BROADCAST != SOF_BROADCAST + #error "WARNING: SO_BROADCAST != SOF_BROADCAST" +#endif +#endif /* LWIP_SOCKET */ + + +/* Compile-time checks for deprecated options. + */ +#ifdef MEMP_NUM_TCPIP_MSG + #error "MEMP_NUM_TCPIP_MSG option is deprecated. Remove it from your lwipopts.h." +#endif +#ifdef TCP_REXMIT_DEBUG + #error "TCP_REXMIT_DEBUG option is deprecated. Remove it from your lwipopts.h." +#endif +#ifdef RAW_STATS + #error "RAW_STATS option is deprecated. Remove it from your lwipopts.h." +#endif +#ifdef ETHARP_QUEUE_FIRST + #error "ETHARP_QUEUE_FIRST option is deprecated. Remove it from your lwipopts.h." +#endif +#ifdef ETHARP_ALWAYS_INSERT + #error "ETHARP_ALWAYS_INSERT option is deprecated. Remove it from your lwipopts.h." +#endif + +#ifndef LWIP_DISABLE_TCP_SANITY_CHECKS +#define LWIP_DISABLE_TCP_SANITY_CHECKS 0 +#endif +#ifndef LWIP_DISABLE_MEMP_SANITY_CHECKS +#define LWIP_DISABLE_MEMP_SANITY_CHECKS 0 +#endif + +/* MEMP sanity checks */ +#if !LWIP_DISABLE_MEMP_SANITY_CHECKS +#if LWIP_NETCONN +#if MEMP_MEM_MALLOC +#if !MEMP_NUM_NETCONN && LWIP_SOCKET +#error "lwip_sanity_check: WARNING: MEMP_NUM_NETCONN cannot be 0 when using sockets!" +#endif +#else /* MEMP_MEM_MALLOC */ +#if MEMP_NUM_NETCONN > (MEMP_NUM_TCP_PCB+MEMP_NUM_TCP_PCB_LISTEN+MEMP_NUM_UDP_PCB+MEMP_NUM_RAW_PCB) +#error "lwip_sanity_check: WARNING: MEMP_NUM_NETCONN should be less than the sum of MEMP_NUM_{TCP,RAW,UDP}_PCB+MEMP_NUM_TCP_PCB_LISTEN. If you know what you are doing, define LWIP_DISABLE_MEMP_SANITY_CHECKS to 1 to disable this error." +#endif +#endif /* MEMP_MEM_MALLOC */ +#endif /* LWIP_NETCONN */ +#endif /* !LWIP_DISABLE_MEMP_SANITY_CHECKS */ + +/* TCP sanity checks */ +#if !LWIP_DISABLE_TCP_SANITY_CHECKS +#if LWIP_TCP +#if !MEMP_MEM_MALLOC && (MEMP_NUM_TCP_SEG < TCP_SND_QUEUELEN) + #error "lwip_sanity_check: WARNING: MEMP_NUM_TCP_SEG should be at least as big as TCP_SND_QUEUELEN. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#if TCP_SND_BUF < (2 * TCP_MSS) + #error "lwip_sanity_check: WARNING: TCP_SND_BUF must be at least as much as (2 * TCP_MSS) for things to work smoothly. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#if TCP_SND_QUEUELEN < (2 * (TCP_SND_BUF / TCP_MSS)) + #error "lwip_sanity_check: WARNING: TCP_SND_QUEUELEN must be at least as much as (2 * TCP_SND_BUF/TCP_MSS) for things to work. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#if TCP_SNDLOWAT >= TCP_SND_BUF + #error "lwip_sanity_check: WARNING: TCP_SNDLOWAT must be less than TCP_SND_BUF. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#if TCP_SNDLOWAT >= (0xFFFF - (4 * TCP_MSS)) + #error "lwip_sanity_check: WARNING: TCP_SNDLOWAT must at least be 4*MSS below u16_t overflow!" +#endif +#if TCP_SNDQUEUELOWAT >= TCP_SND_QUEUELEN + #error "lwip_sanity_check: WARNING: TCP_SNDQUEUELOWAT must be less than TCP_SND_QUEUELEN. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#if !MEMP_MEM_MALLOC && (PBUF_POOL_BUFSIZE <= (PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN + PBUF_TRANSPORT_HLEN)) + #error "lwip_sanity_check: WARNING: PBUF_POOL_BUFSIZE does not provide enough space for protocol headers. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif + +#ifndef LWIP_ESP8266 +#if !MEMP_MEM_MALLOC && (TCP_WND > (PBUF_POOL_SIZE * (PBUF_POOL_BUFSIZE - (PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN + PBUF_TRANSPORT_HLEN)))) + #error "lwip_sanity_check: WARNING: TCP_WND is larger than space provided by PBUF_POOL_SIZE * (PBUF_POOL_BUFSIZE - protocol headers). If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif + +#if TCP_WND < TCP_MSS + #error "lwip_sanity_check: WARNING: TCP_WND is smaller than MSS. If you know what you are doing, define LWIP_DISABLE_TCP_SANITY_CHECKS to 1 to disable this error." +#endif +#endif + +#endif /* LWIP_TCP */ +#endif /* !LWIP_DISABLE_TCP_SANITY_CHECKS */ +#endif + +/** + * Initialize all modules. + */ +void +lwip_init(void) +{ +#ifdef LWIP_ESP8266 +// MEMP_NUM_TCP_PCB = 5; +// TCP_WND = (4 * TCP_MSS); +// TCP_MAXRTX = 12; +// TCP_SYNMAXRTX = 6; +#endif + + /* Modules initialization */ + stats_init(); +#if !NO_SYS + sys_init(); +#endif /* !NO_SYS */ + mem_init(); + memp_init(); + pbuf_init(); + netif_init(); +#if LWIP_IPV4 + ip_init(); +#if LWIP_ARP + etharp_init(); +#endif /* LWIP_ARP */ +#endif /* LWIP_IPV4 */ +#if LWIP_RAW + raw_init(); +#endif /* LWIP_RAW */ +#if LWIP_UDP + udp_init(); +#endif /* LWIP_UDP */ +#if LWIP_TCP + tcp_init(); +#endif /* LWIP_TCP */ +#if LWIP_AUTOIP + autoip_init(); +#endif /* LWIP_AUTOIP */ +#if LWIP_IGMP + igmp_init(); +#endif /* LWIP_IGMP */ +#if LWIP_DNS + dns_init(); +#endif /* LWIP_DNS */ +#if PPP_SUPPORT + ppp_init(); +#endif + +#if LWIP_TIMERS + sys_timeouts_init(); +#endif /* LWIP_TIMERS */ +} diff --git a/components/lwip/core/ip.c b/components/lwip/core/ip.c new file mode 100755 index 000000000..aa42fba76 --- /dev/null +++ b/components/lwip/core/ip.c @@ -0,0 +1,101 @@ +/** + * @file ip.c + * Common IPv4 and IPv6 code + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 || LWIP_IPV6 + +#include "lwip/ip_addr.h" +#include "lwip/ip.h" + +/** Global data for both IPv4 and IPv6 */ +struct ip_globals ip_data; + +#if LWIP_IPV4 && LWIP_IPV6 + +const ip_addr_t ip_addr_any_type = IPADDR_ANY_TYPE_INIT; + +/** Convert IP address string (both versions) to numeric. + * The version is auto-detected from the string. + * + * @param cp IP address string to convert + * @param addr conversion result is stored here + * @return 1 on success, 0 on error + */ +int +ipaddr_aton(const char *cp, ip_addr_t *addr) +{ + if (cp != NULL) { + const char* c; + for (c = cp; *c != 0; c++) { + if (*c == ':') { + /* contains a colon: IPv6 address */ + if (addr) { + IP_SET_TYPE_VAL(*addr, IPADDR_TYPE_V6); + } + return ip6addr_aton(cp, ip_2_ip6(addr)); + } else if (*c == '.') { + /* contains a dot: IPv4 address */ + break; + } + } + /* call ip4addr_aton as fallback or if IPv4 was found */ + if (addr) { + IP_SET_TYPE_VAL(*addr, IPADDR_TYPE_V4); + } + return ip4addr_aton(cp, ip_2_ip4(addr)); + } + return 0; +} + +/* If both IP versions are enabled, this function can dispatch packets to the correct one. */ +err_t +ip_input(struct pbuf *p, struct netif *inp) +{ + if (p != NULL) { + if (IP_HDR_GET_VERSION(p->payload) == 6) { + return ip6_input(p, inp); + } + return ip4_input(p, inp); + } + return ERR_VAL; +} + +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +#endif /* LWIP_IPV4 || LWIP_IPV6 */ diff --git a/components/lwip/core/ipv4/autoip.c b/components/lwip/core/ipv4/autoip.c new file mode 100755 index 000000000..391e8eeae --- /dev/null +++ b/components/lwip/core/ipv4/autoip.c @@ -0,0 +1,549 @@ +/** + * @file + * AutoIP Automatic LinkLocal IP Configuration + * + */ + +/* + * + * Copyright (c) 2007 Dominik Spies + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * Author: Dominik Spies + * + * This is a AutoIP implementation for the lwIP TCP/IP stack. It aims to conform + * with RFC 3927. + * + * + * Please coordinate changes and requests with Dominik Spies + * + */ + +/******************************************************************************* + * USAGE: + * + * define LWIP_AUTOIP 1 in your lwipopts.h + * + * If you don't use tcpip.c (so, don't call, you don't call tcpip_init): + * - First, call autoip_init(). + * - call autoip_tmr() all AUTOIP_TMR_INTERVAL msces, + * that should be defined in autoip.h. + * I recommend a value of 100. The value must divide 1000 with a remainder almost 0. + * Possible values are 1000, 500, 333, 250, 200, 166, 142, 125, 111, 100 .... + * + * Without DHCP: + * - Call autoip_start() after netif_add(). + * + * With DHCP: + * - define LWIP_DHCP_AUTOIP_COOP 1 in your lwipopts.h. + * - Configure your DHCP Client. + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 && LWIP_AUTOIP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/mem.h" +/* #include "lwip/udp.h" */ +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/autoip.h" +#include "netif/etharp.h" + +#include +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/* 169.254.0.0 */ +#define AUTOIP_NET 0xA9FE0000 +/* 169.254.1.0 */ +#define AUTOIP_RANGE_START (AUTOIP_NET | 0x0100) +/* 169.254.254.255 */ +#define AUTOIP_RANGE_END (AUTOIP_NET | 0xFEFF) + + +/** Pseudo random macro based on netif informations. + * You could use "rand()" from the C Library if you define LWIP_AUTOIP_RAND in lwipopts.h */ +#ifndef LWIP_AUTOIP_RAND +#define LWIP_AUTOIP_RAND(netif) ( (((u32_t)((netif->hwaddr[5]) & 0xff) << 24) | \ + ((u32_t)((netif->hwaddr[3]) & 0xff) << 16) | \ + ((u32_t)((netif->hwaddr[2]) & 0xff) << 8) | \ + ((u32_t)((netif->hwaddr[4]) & 0xff))) + \ + (netif->autoip?netif->autoip->tried_llipaddr:0)) +#endif /* LWIP_AUTOIP_RAND */ + +/** + * Macro that generates the initial IP address to be tried by AUTOIP. + * If you want to override this, define it to something else in lwipopts.h. + */ +#ifndef LWIP_AUTOIP_CREATE_SEED_ADDR +#define LWIP_AUTOIP_CREATE_SEED_ADDR(netif) \ + htonl(AUTOIP_RANGE_START + ((u32_t)(((u8_t)(netif->hwaddr[4])) | \ + ((u32_t)((u8_t)(netif->hwaddr[5]))) << 8))) +#endif /* LWIP_AUTOIP_CREATE_SEED_ADDR */ + +/* static functions */ +static void autoip_handle_arp_conflict(struct netif *netif); + +/* creates a pseudo random LL IP-Address for a network interface */ +static void autoip_create_addr(struct netif *netif, ip4_addr_t *ipaddr); + +/* sends an ARP probe */ +static err_t autoip_arp_probe(struct netif *netif); + +/* sends an ARP announce */ +static err_t autoip_arp_announce(struct netif *netif); + +/* configure interface for use with current LL IP-Address */ +static err_t autoip_bind(struct netif *netif); + +/* start sending probes for llipaddr */ +static void autoip_start_probing(struct netif *netif); + + +/** Set a statically allocated struct autoip to work with. + * Using this prevents autoip_start to allocate it using mem_malloc. + * + * @param netif the netif for which to set the struct autoip + * @param dhcp (uninitialised) dhcp struct allocated by the application + */ +void +autoip_set_struct(struct netif *netif, struct autoip *autoip) +{ + LWIP_ASSERT("netif != NULL", netif != NULL); + LWIP_ASSERT("autoip != NULL", autoip != NULL); + LWIP_ASSERT("netif already has a struct autoip set", netif->autoip == NULL); + + /* clear data structure */ + memset(autoip, 0, sizeof(struct autoip)); + /* autoip->state = AUTOIP_STATE_OFF; */ + netif->autoip = autoip; +} + +/** Restart AutoIP client and check the next address (conflict detected) + * + * @param netif The netif under AutoIP control + */ +static void +autoip_restart(struct netif *netif) +{ + netif->autoip->tried_llipaddr++; + autoip_start(netif); +} + +/** + * Handle a IP address conflict after an ARP conflict detection + */ +static void +autoip_handle_arp_conflict(struct netif *netif) +{ + /* Somehow detect if we are defending or retreating */ + unsigned char defend = 1; /* tbd */ + + if (defend) { + if (netif->autoip->lastconflict > 0) { + /* retreat, there was a conflicting ARP in the last + * DEFEND_INTERVAL seconds + */ + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_handle_arp_conflict(): we are defending, but in DEFEND_INTERVAL, retreating\n")); + + /* TODO: close all TCP sessions */ + autoip_restart(netif); + } else { + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_handle_arp_conflict(): we are defend, send ARP Announce\n")); + autoip_arp_announce(netif); + netif->autoip->lastconflict = DEFEND_INTERVAL * AUTOIP_TICKS_PER_SECOND; + } + } else { + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_handle_arp_conflict(): we do not defend, retreating\n")); + /* TODO: close all TCP sessions */ + autoip_restart(netif); + } +} + +/** + * Create an IP-Address out of range 169.254.1.0 to 169.254.254.255 + * + * @param netif network interface on which create the IP-Address + * @param ipaddr ip address to initialize + */ +static void +autoip_create_addr(struct netif *netif, ip4_addr_t *ipaddr) +{ + /* Here we create an IP-Address out of range 169.254.1.0 to 169.254.254.255 + * compliant to RFC 3927 Section 2.1 + * We have 254 * 256 possibilities */ + + u32_t addr = ntohl(LWIP_AUTOIP_CREATE_SEED_ADDR(netif)); + addr += netif->autoip->tried_llipaddr; + addr = AUTOIP_NET | (addr & 0xffff); + /* Now, 169.254.0.0 <= addr <= 169.254.255.255 */ + + if (addr < AUTOIP_RANGE_START) { + addr += AUTOIP_RANGE_END - AUTOIP_RANGE_START + 1; + } + if (addr > AUTOIP_RANGE_END) { + addr -= AUTOIP_RANGE_END - AUTOIP_RANGE_START + 1; + } + LWIP_ASSERT("AUTOIP address not in range", (addr >= AUTOIP_RANGE_START) && + (addr <= AUTOIP_RANGE_END)); + ip4_addr_set_u32(ipaddr, htonl(addr)); + + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_create_addr(): tried_llipaddr=%"U16_F", %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + (u16_t)(netif->autoip->tried_llipaddr), ip4_addr1_16(ipaddr), ip4_addr2_16(ipaddr), + ip4_addr3_16(ipaddr), ip4_addr4_16(ipaddr))); +} + +/** + * Sends an ARP probe from a network interface + * + * @param netif network interface used to send the probe + */ +static err_t +autoip_arp_probe(struct netif *netif) +{ + return etharp_raw(netif, (struct eth_addr *)netif->hwaddr, ðbroadcast, + (struct eth_addr *)netif->hwaddr, IP4_ADDR_ANY, ðzero, + &netif->autoip->llipaddr, ARP_REQUEST); +} + +/** + * Sends an ARP announce from a network interface + * + * @param netif network interface used to send the announce + */ +static err_t +autoip_arp_announce(struct netif *netif) +{ + return etharp_raw(netif, (struct eth_addr *)netif->hwaddr, ðbroadcast, + (struct eth_addr *)netif->hwaddr, &netif->autoip->llipaddr, ðzero, + &netif->autoip->llipaddr, ARP_REQUEST); +} + +/** + * Configure interface for use with current LL IP-Address + * + * @param netif network interface to configure with current LL IP-Address + */ +static err_t +autoip_bind(struct netif *netif) +{ + struct autoip *autoip = netif->autoip; + ip4_addr_t sn_mask, gw_addr; + + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_bind(netif=%p) %c%c%"U16_F" %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num, + ip4_addr1_16(&autoip->llipaddr), ip4_addr2_16(&autoip->llipaddr), + ip4_addr3_16(&autoip->llipaddr), ip4_addr4_16(&autoip->llipaddr))); + + IP4_ADDR(&sn_mask, 255, 255, 0, 0); + IP4_ADDR(&gw_addr, 0, 0, 0, 0); + + netif_set_addr(netif, &autoip->llipaddr, &sn_mask, &gw_addr); + /* interface is used by routing now that an address is set */ + + return ERR_OK; +} + +/** + * Start AutoIP client + * + * @param netif network interface on which start the AutoIP client + */ +err_t +autoip_start(struct netif *netif) +{ + struct autoip *autoip = netif->autoip; + err_t result = ERR_OK; + + LWIP_ERROR("netif is not up, old style port?", netif_is_up(netif), return ERR_ARG;); + + /* Set IP-Address, Netmask and Gateway to 0 to make sure that + * ARP Packets are formed correctly + */ + netif_set_addr(netif, IP4_ADDR_ANY, IP4_ADDR_ANY, IP4_ADDR_ANY); + + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_start(netif=%p) %c%c%"U16_F"\n", (void*)netif, netif->name[0], + netif->name[1], (u16_t)netif->num)); + if (autoip == NULL) { + /* no AutoIP client attached yet? */ + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_start(): starting new AUTOIP client\n")); + autoip = (struct autoip *)mem_malloc(sizeof(struct autoip)); + if (autoip == NULL) { + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_start(): could not allocate autoip\n")); + return ERR_MEM; + } + memset(autoip, 0, sizeof(struct autoip)); + /* store this AutoIP client in the netif */ + netif->autoip = autoip; + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, ("autoip_start(): allocated autoip")); + } else { + autoip->state = AUTOIP_STATE_OFF; + autoip->ttw = 0; + autoip->sent_num = 0; + ip4_addr_set_zero(&autoip->llipaddr); + autoip->lastconflict = 0; + } + + autoip_create_addr(netif, &(autoip->llipaddr)); + autoip_start_probing(netif); + + return result; +} + +static void +autoip_start_probing(struct netif *netif) +{ + struct autoip *autoip = netif->autoip; + + autoip->state = AUTOIP_STATE_PROBING; + autoip->sent_num = 0; + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_start_probing(): changing state to PROBING: %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(&netif->autoip->llipaddr), ip4_addr2_16(&netif->autoip->llipaddr), + ip4_addr3_16(&netif->autoip->llipaddr), ip4_addr4_16(&netif->autoip->llipaddr))); + + /* time to wait to first probe, this is randomly + * chosen out of 0 to PROBE_WAIT seconds. + * compliant to RFC 3927 Section 2.2.1 + */ + autoip->ttw = (u16_t)(LWIP_AUTOIP_RAND(netif) % (PROBE_WAIT * AUTOIP_TICKS_PER_SECOND)); + + /* + * if we tried more then MAX_CONFLICTS we must limit our rate for + * acquiring and probing address + * compliant to RFC 3927 Section 2.2.1 + */ + if (autoip->tried_llipaddr > MAX_CONFLICTS) { + autoip->ttw = RATE_LIMIT_INTERVAL * AUTOIP_TICKS_PER_SECOND; + } +} + +/** + * Handle a possible change in the network configuration. + * + * If there is an AutoIP address configured, take the interface down + * and begin probing with the same address. + */ +void +autoip_network_changed(struct netif *netif) +{ + if (netif->autoip && netif->autoip->state != AUTOIP_STATE_OFF) { + autoip_start_probing(netif); + } +} + +/** + * Stop AutoIP client + * + * @param netif network interface on which stop the AutoIP client + */ +err_t +autoip_stop(struct netif *netif) +{ + if (netif->autoip) { + netif->autoip->state = AUTOIP_STATE_OFF; + if (ip4_addr_islinklocal(netif_ip4_addr(netif))) { + netif_set_addr(netif, IP4_ADDR_ANY, IP4_ADDR_ANY, IP4_ADDR_ANY); + } + } + return ERR_OK; +} + +/** + * Has to be called in loop every AUTOIP_TMR_INTERVAL milliseconds + */ +void +autoip_tmr(void) +{ + struct netif *netif = netif_list; + /* loop through netif's */ + while (netif != NULL) { + /* only act on AutoIP configured interfaces */ + if (netif->autoip != NULL) { + if (netif->autoip->lastconflict > 0) { + netif->autoip->lastconflict--; + } + + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_tmr() AutoIP-State: %"U16_F", ttw=%"U16_F"\n", + (u16_t)(netif->autoip->state), netif->autoip->ttw)); + + switch(netif->autoip->state) { + case AUTOIP_STATE_PROBING: + if (netif->autoip->ttw > 0) { + netif->autoip->ttw--; + } else { + if (netif->autoip->sent_num >= PROBE_NUM) { + netif->autoip->state = AUTOIP_STATE_ANNOUNCING; + netif->autoip->sent_num = 0; + netif->autoip->ttw = ANNOUNCE_WAIT * AUTOIP_TICKS_PER_SECOND; + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_tmr(): changing state to ANNOUNCING: %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(&netif->autoip->llipaddr), ip4_addr2_16(&netif->autoip->llipaddr), + ip4_addr3_16(&netif->autoip->llipaddr), ip4_addr4_16(&netif->autoip->llipaddr))); + } else { + autoip_arp_probe(netif); + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_tmr() PROBING Sent Probe\n")); + netif->autoip->sent_num++; + /* calculate time to wait to next probe */ + netif->autoip->ttw = (u16_t)((LWIP_AUTOIP_RAND(netif) % + ((PROBE_MAX - PROBE_MIN) * AUTOIP_TICKS_PER_SECOND) ) + + PROBE_MIN * AUTOIP_TICKS_PER_SECOND); + } + } + break; + + case AUTOIP_STATE_ANNOUNCING: + if (netif->autoip->ttw > 0) { + netif->autoip->ttw--; + } else { + if (netif->autoip->sent_num == 0) { + /* We are here the first time, so we waited ANNOUNCE_WAIT seconds + * Now we can bind to an IP address and use it. + * + * autoip_bind calls netif_set_addr. This triggers a gratuitous ARP + * which counts as an announcement. + */ + autoip_bind(netif); + } else { + autoip_arp_announce(netif); + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, + ("autoip_tmr() ANNOUNCING Sent Announce\n")); + } + netif->autoip->ttw = ANNOUNCE_INTERVAL * AUTOIP_TICKS_PER_SECOND; + netif->autoip->sent_num++; + + if (netif->autoip->sent_num >= ANNOUNCE_NUM) { + netif->autoip->state = AUTOIP_STATE_BOUND; + netif->autoip->sent_num = 0; + netif->autoip->ttw = 0; + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("autoip_tmr(): changing state to BOUND: %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(&netif->autoip->llipaddr), ip4_addr2_16(&netif->autoip->llipaddr), + ip4_addr3_16(&netif->autoip->llipaddr), ip4_addr4_16(&netif->autoip->llipaddr))); + } + } + break; + + default: + /* nothing to do in other states */ + break; + } + } + /* proceed to next network interface */ + netif = netif->next; + } +} + +/** + * Handles every incoming ARP Packet, called by etharp_arp_input. + * + * @param netif network interface to use for autoip processing + * @param hdr Incoming ARP packet + */ +void +autoip_arp_reply(struct netif *netif, struct etharp_hdr *hdr) +{ + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, ("autoip_arp_reply()\n")); + if ((netif->autoip != NULL) && (netif->autoip->state != AUTOIP_STATE_OFF)) { + /* when ip.src == llipaddr && hw.src != netif->hwaddr + * + * when probing ip.dst == llipaddr && hw.src != netif->hwaddr + * we have a conflict and must solve it + */ + ip4_addr_t sipaddr, dipaddr; + struct eth_addr netifaddr; + ETHADDR16_COPY(netifaddr.addr, netif->hwaddr); + + /* Copy struct ip4_addr2 to aligned ip4_addr, to support compilers without + * structure packing (not using structure copy which breaks strict-aliasing rules). + */ + IPADDR2_COPY(&sipaddr, &hdr->sipaddr); + IPADDR2_COPY(&dipaddr, &hdr->dipaddr); + + if ((netif->autoip->state == AUTOIP_STATE_PROBING) || + ((netif->autoip->state == AUTOIP_STATE_ANNOUNCING) && + (netif->autoip->sent_num == 0))) { + /* RFC 3927 Section 2.2.1: + * from beginning to after ANNOUNCE_WAIT + * seconds we have a conflict if + * ip.src == llipaddr OR + * ip.dst == llipaddr && hw.src != own hwaddr + */ + if ((ip4_addr_cmp(&sipaddr, &netif->autoip->llipaddr)) || + (ip4_addr_cmp(&dipaddr, &netif->autoip->llipaddr) && + !eth_addr_cmp(&netifaddr, &hdr->shwaddr))) { + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE | LWIP_DBG_LEVEL_WARNING, + ("autoip_arp_reply(): Probe Conflict detected\n")); + autoip_restart(netif); + } + } else { + /* RFC 3927 Section 2.5: + * in any state we have a conflict if + * ip.src == llipaddr && hw.src != own hwaddr + */ + if (ip4_addr_cmp(&sipaddr, &netif->autoip->llipaddr) && + !eth_addr_cmp(&netifaddr, &hdr->shwaddr)) { + LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE | LWIP_DBG_LEVEL_WARNING, + ("autoip_arp_reply(): Conflicting ARP-Packet detected\n")); + autoip_handle_arp_conflict(netif); + } + } + } +} + +/** check if AutoIP supplied netif->ip_addr + * + * @param netif the netif to check + * @return 1 if AutoIP supplied netif->ip_addr (state BOUND), + * 0 otherwise + */ +u8_t +autoip_supplied_address(struct netif *netif) +{ + if ((netif != NULL) && (netif->autoip != NULL)) { + if (netif->autoip->state == AUTOIP_STATE_BOUND) { + return 1; + } + } + return 0; +} + +#endif /* LWIP_IPV4 && LWIP_AUTOIP */ diff --git a/components/lwip/core/ipv4/dhcp.c b/components/lwip/core/ipv4/dhcp.c new file mode 100755 index 000000000..d13b55710 --- /dev/null +++ b/components/lwip/core/ipv4/dhcp.c @@ -0,0 +1,1941 @@ +/** + * @file + * Dynamic Host Configuration Protocol client + * + */ + +/* + * Copyright (c) 2001-2004 Leon Woestenberg + * Copyright (c) 2001-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * The Swedish Institute of Computer Science and Adam Dunkels + * are specifically granted permission to redistribute this + * source code. + * + * Author: Leon Woestenberg + * + * This is a DHCP client for the lwIP TCP/IP stack. It aims to conform + * with RFC 2131 and RFC 2132. + * + * TODO: + * - Support for interfaces other than Ethernet (SLIP, PPP, ...) + * + * Please coordinate changes and requests with Leon Woestenberg + * + * + * Integration with your code: + * + * In lwip/dhcp.h + * #define DHCP_COARSE_TIMER_SECS (recommended 60 which is a minute) + * #define DHCP_FINE_TIMER_MSECS (recommended 500 which equals TCP coarse timer) + * + * Then have your application call dhcp_coarse_tmr() and + * dhcp_fine_tmr() on the defined intervals. + * + * dhcp_start(struct netif *netif); + * starts a DHCP client instance which configures the interface by + * obtaining an IP address lease and maintaining it. + * + * Use dhcp_release(netif) to end the lease and use dhcp_stop(netif) + * to remove the DHCP client. + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 && LWIP_DHCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/stats.h" +#include "lwip/mem.h" +#include "lwip/udp.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/def.h" +#include "lwip/dhcp.h" +#include "lwip/autoip.h" +#include "lwip/dns.h" +#include "netif/etharp.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/** DHCP_CREATE_RAND_XID: if this is set to 1, the xid is created using + * LWIP_RAND() (this overrides DHCP_GLOBAL_XID) + */ +#ifndef DHCP_CREATE_RAND_XID +#define DHCP_CREATE_RAND_XID 1 +#endif + +/** Default for DHCP_GLOBAL_XID is 0xABCD0000 + * This can be changed by defining DHCP_GLOBAL_XID and DHCP_GLOBAL_XID_HEADER, e.g. + * #define DHCP_GLOBAL_XID_HEADER "stdlib.h" + * #define DHCP_GLOBAL_XID rand() + */ +#ifdef DHCP_GLOBAL_XID_HEADER +#include DHCP_GLOBAL_XID_HEADER /* include optional starting XID generation prototypes */ +#endif + +/** DHCP_OPTION_MAX_MSG_SIZE is set to the MTU + * MTU is checked to be big enough in dhcp_start */ +#define DHCP_MAX_MSG_LEN(netif) (netif->mtu) +#define DHCP_MAX_MSG_LEN_MIN_REQUIRED 576 +/** Minimum length for reply before packet is parsed */ +#define DHCP_MIN_REPLY_LEN 44 + +#define REBOOT_TRIES 2 + +/** Option handling: options are parsed in dhcp_parse_reply + * and saved in an array where other functions can load them from. + * This might be moved into the struct dhcp (not necessarily since + * lwIP is single-threaded and the array is only used while in recv + * callback). */ +#define DHCP_OPTION_IDX_OVERLOAD 0 +#define DHCP_OPTION_IDX_MSG_TYPE 1 +#define DHCP_OPTION_IDX_SERVER_ID 2 +#define DHCP_OPTION_IDX_LEASE_TIME 3 +#define DHCP_OPTION_IDX_T1 4 +#define DHCP_OPTION_IDX_T2 5 +#define DHCP_OPTION_IDX_SUBNET_MASK 6 +#define DHCP_OPTION_IDX_ROUTER 7 +#define DHCP_OPTION_IDX_DNS_SERVER 8 +#if LWIP_DHCP_GET_NTP_SRV +#define DHCP_OPTION_IDX_NTP_SERVER (DHCP_OPTION_IDX_DNS_SERVER + DNS_MAX_SERVERS) +#define DHCP_OPTION_IDX_MAX (DHCP_OPTION_IDX_NTP_SERVER + LWIP_DHCP_MAX_NTP_SERVERS) +#else /* LWIP_DHCP_GET_NTP_SRV */ +#define DHCP_OPTION_IDX_MAX (DHCP_OPTION_IDX_DNS_SERVER + DNS_MAX_SERVERS) +#endif /* LWIP_DHCP_GET_NTP_SRV */ + +/** Holds the decoded option values, only valid while in dhcp_recv. + @todo: move this into struct dhcp? */ +u32_t dhcp_rx_options_val[DHCP_OPTION_IDX_MAX]; +/** Holds a flag which option was received and is contained in dhcp_rx_options_val, + only valid while in dhcp_recv. + @todo: move this into struct dhcp? */ +u8_t dhcp_rx_options_given[DHCP_OPTION_IDX_MAX]; + +static u8_t dhcp_discover_select_options[] = { + DHCP_OPTION_SUBNET_MASK, + DHCP_OPTION_ROUTER, + DHCP_OPTION_BROADCAST, + DHCP_OPTION_DNS_SERVER + +#ifdef LWIP_ESP8266 +/**add options for support more router by liuHan**/ + , DHCP_OPTION_DOMAIN_NAME, + DHCP_OPTION_NB_TINS, + DHCP_OPTION_NB_TINT, + DHCP_OPTION_NB_TIS, + DHCP_OPTION_PRD, + DHCP_OPTION_STATIC_ROUTER, + DHCP_OPTION_CLASSLESS_STATIC_ROUTER, + DHCP_OPTION_VSN +#endif + +#if LWIP_DHCP_GET_NTP_SRV + , DHCP_OPTION_NTP +#endif /* LWIP_DHCP_GET_NTP_SRV */ + }; + +#ifdef DHCP_GLOBAL_XID +static u32_t xid; +static u8_t xid_initialised; +#endif /* DHCP_GLOBAL_XID */ + +#define dhcp_option_given(dhcp, idx) (dhcp_rx_options_given[idx] != 0) +#define dhcp_got_option(dhcp, idx) (dhcp_rx_options_given[idx] = 1) +#define dhcp_clear_option(dhcp, idx) (dhcp_rx_options_given[idx] = 0) +#define dhcp_clear_all_options(dhcp) (memset(dhcp_rx_options_given, 0, sizeof(dhcp_rx_options_given))) +#define dhcp_get_option_value(dhcp, idx) (dhcp_rx_options_val[idx]) +#define dhcp_set_option_value(dhcp, idx, val) (dhcp_rx_options_val[idx] = (val)) + +static struct udp_pcb *dhcp_pcb; +static u8_t dhcp_pcb_refcount; + +/* DHCP client state machine functions */ +static err_t dhcp_discover(struct netif *netif); +static err_t dhcp_select(struct netif *netif); +static void dhcp_bind(struct netif *netif); +#if DHCP_DOES_ARP_CHECK +static err_t dhcp_decline(struct netif *netif); +#endif /* DHCP_DOES_ARP_CHECK */ +static err_t dhcp_rebind(struct netif *netif); +static err_t dhcp_reboot(struct netif *netif); +static void dhcp_set_state(struct dhcp *dhcp, u8_t new_state); + +/* receive, unfold, parse and free incoming messages */ +static void dhcp_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port); + +/* set the DHCP timers */ +static void dhcp_timeout(struct netif *netif); +static void dhcp_t1_timeout(struct netif *netif); +static void dhcp_t2_timeout(struct netif *netif); + +/* build outgoing messages */ +/* create a DHCP message, fill in common headers */ +static err_t dhcp_create_msg(struct netif *netif, struct dhcp *dhcp, u8_t message_type); +/* free a DHCP request */ +static void dhcp_delete_msg(struct dhcp *dhcp); +/* add a DHCP option (type, then length in bytes) */ +static void dhcp_option(struct dhcp *dhcp, u8_t option_type, u8_t option_len); +/* add option values */ +static void dhcp_option_byte(struct dhcp *dhcp, u8_t value); +static void dhcp_option_short(struct dhcp *dhcp, u16_t value); +static void dhcp_option_long(struct dhcp *dhcp, u32_t value); +#if LWIP_NETIF_HOSTNAME +static void dhcp_option_hostname(struct dhcp *dhcp, struct netif *netif); +#endif /* LWIP_NETIF_HOSTNAME */ +/* always add the DHCP options trailer to end and pad */ +static void dhcp_option_trailer(struct dhcp *dhcp); + +/** Ensure DHCP PCB is allocated and bound */ +static err_t +dhcp_inc_pcb_refcount(void) +{ + if(dhcp_pcb_refcount == 0) { + LWIP_ASSERT("dhcp_inc_pcb_refcount(): memory leak", dhcp_pcb == NULL); + + /* allocate UDP PCB */ + dhcp_pcb = udp_new(); + + if(dhcp_pcb == NULL) { + return ERR_MEM; + } + + ip_set_option(dhcp_pcb, SOF_BROADCAST); + + /* set up local and remote port for the pcb -> listen on all interfaces on all src/dest IPs */ + udp_bind(dhcp_pcb, IP_ADDR_ANY, DHCP_CLIENT_PORT); + udp_connect(dhcp_pcb, IP_ADDR_ANY, DHCP_SERVER_PORT); + udp_recv(dhcp_pcb, dhcp_recv, NULL); + } + + dhcp_pcb_refcount++; + + return ERR_OK; +} + +/** Free DHCP PCB if the last netif stops using it */ +static void +dhcp_dec_pcb_refcount(void) +{ + LWIP_ASSERT("dhcp_pcb_refcount(): refcount error", (dhcp_pcb_refcount > 0)); + dhcp_pcb_refcount--; + + if(dhcp_pcb_refcount == 0) { + udp_remove(dhcp_pcb); + dhcp_pcb = NULL; + } +} + +/** + * Back-off the DHCP client (because of a received NAK response). + * + * Back-off the DHCP client because of a received NAK. Receiving a + * NAK means the client asked for something non-sensible, for + * example when it tries to renew a lease obtained on another network. + * + * We clear any existing set IP address and restart DHCP negotiation + * afresh (as per RFC2131 3.2.3). + * + * @param netif the netif under DHCP control + */ +static void +dhcp_handle_nak(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_handle_nak(netif=%p) %c%c%"U16_F"\n", + (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num)); + /* remove IP address from interface (must no longer be used, as per RFC2131) */ + netif_set_addr(netif, IP4_ADDR_ANY, IP4_ADDR_ANY, IP4_ADDR_ANY); + /* Change to a defined state */ + dhcp_set_state(dhcp, DHCP_STATE_BACKING_OFF); + /* We can immediately restart discovery */ + dhcp_discover(netif); +} + +#if DHCP_DOES_ARP_CHECK +/** + * Checks if the offered IP address is already in use. + * + * It does so by sending an ARP request for the offered address and + * entering CHECKING state. If no ARP reply is received within a small + * interval, the address is assumed to be free for use by us. + * + * @param netif the netif under DHCP control + */ +static void +dhcp_check(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + u16_t msecs; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_check(netif=%p) %c%c\n", (void *)netif, (s16_t)netif->name[0], + (s16_t)netif->name[1])); + dhcp_set_state(dhcp, DHCP_STATE_CHECKING); + /* create an ARP query for the offered IP address, expecting that no host + responds, as the IP address should not be in use. */ + result = etharp_query(netif, &dhcp->offered_ip_addr, NULL); + if (result != ERR_OK) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("dhcp_check: could not perform ARP query\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + msecs = 500; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_check(): set request timeout %"U16_F" msecs\n", msecs)); +} +#endif /* DHCP_DOES_ARP_CHECK */ + +/** + * Remember the configuration offered by a DHCP server. + * + * @param netif the netif under DHCP control + */ +static void +dhcp_handle_offer(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_handle_offer(netif=%p) %c%c%"U16_F"\n", + (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num)); + /* obtain the server address */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_SERVER_ID)) { + ip_addr_set_ip4_u32(&dhcp->server_ip_addr, htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_SERVER_ID))); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_handle_offer(): server 0x%08"X32_F"\n", + ip4_addr_get_u32(ip_2_ip4(&dhcp->server_ip_addr)))); + /* remember offered address */ + ip4_addr_copy(dhcp->offered_ip_addr, dhcp->msg_in->yiaddr); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_handle_offer(): offer for 0x%08"X32_F"\n", + ip4_addr_get_u32(&dhcp->offered_ip_addr))); + + dhcp_select(netif); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("dhcp_handle_offer(netif=%p) did not get server ID!\n", (void*)netif)); + } +} + +/** + * Select a DHCP server offer out of all offers. + * + * Simply select the first offer received. + * + * @param netif the netif under DHCP control + * @return lwIP specific error (see error.h) + */ +static err_t +dhcp_select(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + u16_t msecs; + u8_t i; + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_select(netif=%p) %c%c%"U16_F"\n", (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num)); + dhcp_set_state(dhcp, DHCP_STATE_REQUESTING); + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_REQUEST); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(dhcp, DHCP_MAX_MSG_LEN(netif)); + + /* MUST request the offered IP address */ + dhcp_option(dhcp, DHCP_OPTION_REQUESTED_IP, 4); + dhcp_option_long(dhcp, ntohl(ip4_addr_get_u32(&dhcp->offered_ip_addr))); + + dhcp_option(dhcp, DHCP_OPTION_SERVER_ID, 4); + dhcp_option_long(dhcp, ntohl(ip4_addr_get_u32(ip_2_ip4(&dhcp->server_ip_addr)))); + + dhcp_option(dhcp, DHCP_OPTION_PARAMETER_REQUEST_LIST, sizeof(dhcp_discover_select_options)); + for (i = 0; i < sizeof(dhcp_discover_select_options); i++) { + dhcp_option_byte(dhcp, dhcp_discover_select_options[i]); + } + +#if LWIP_NETIF_HOSTNAME + dhcp_option_hostname(dhcp, netif); +#endif /* LWIP_NETIF_HOSTNAME */ + + dhcp_option_trailer(dhcp); + /* shrink the pbuf to the actual content length */ + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + /* send broadcast to any DHCP server */ + udp_sendto_if_src(dhcp_pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif, IP_ADDR_ANY); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_select: REQUESTING\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("dhcp_select: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + msecs = (dhcp->tries < 6 ? 1 << dhcp->tries : 60) * 1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_select(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} + +/** + * The DHCP timer that checks for lease renewal/rebind timeouts. + */ +void +dhcp_coarse_tmr(void) +{ + struct netif *netif = netif_list; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_coarse_tmr()\n")); + /* iterate through all network interfaces */ + while (netif != NULL) { + /* only act on DHCP configured interfaces */ + struct dhcp* dhcp = netif->dhcp; + if ((dhcp != NULL) && (dhcp->state != DHCP_STATE_OFF)) { + /* compare lease time to expire timeout */ + if (dhcp->t0_timeout && (++dhcp->lease_used == dhcp->t0_timeout)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_coarse_tmr(): t0 timeout\n")); + /* this clients' lease time has expired */ + dhcp_release(netif); + dhcp_discover(netif); + /* timer is active (non zero), and triggers (zeroes) now? */ + } else if (dhcp->t2_rebind_time && (dhcp->t2_rebind_time-- == 1)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_coarse_tmr(): t2 timeout\n")); + /* this clients' rebind timeout triggered */ + dhcp_t2_timeout(netif); + /* timer is active (non zero), and triggers (zeroes) now */ + } else if (dhcp->t1_renew_time && (dhcp->t1_renew_time-- == 1)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_coarse_tmr(): t1 timeout\n")); + /* this clients' renewal timeout triggered */ + dhcp_t1_timeout(netif); + } + } + /* proceed to next netif */ + netif = netif->next; + } +} + +/** + * DHCP transaction timeout handling + * + * A DHCP server is expected to respond within a short period of time. + * This timer checks whether an outstanding DHCP request is timed out. + */ +void +dhcp_fine_tmr(void) +{ + struct netif *netif = netif_list; + /* loop through netif's */ + while (netif != NULL) { + /* only act on DHCP configured interfaces */ + if (netif->dhcp != NULL) { + +//#ifdef LWIP_ESP8266 + /*add DHCP retries processing by LiuHan*/ +#if 0 + if (DHCP_MAXRTX != 0) { + if (netif->dhcp->tries >= DHCP_MAXRTX){ + //os_printf("DHCP timeout\n"); + if (netif->dhcp_event != NULL) + netif->dhcp_event(); + break; + } + } + +#endif + + /* timer is active (non zero), and is about to trigger now */ + if (netif->dhcp->request_timeout > 1) { + netif->dhcp->request_timeout--; + } + else if (netif->dhcp->request_timeout == 1) { + netif->dhcp->request_timeout--; + /* { netif->dhcp->request_timeout == 0 } */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_fine_tmr(): request timeout\n")); + /* this client's request timeout triggered */ + dhcp_timeout(netif); + } + } + /* proceed to next network interface */ + netif = netif->next; + } +} + +/** + * A DHCP negotiation transaction, or ARP request, has timed out. + * + * The timer that was started with the DHCP or ARP request has + * timed out, indicating no response was received in time. + * + * @param netif the netif under DHCP control + */ +static void +dhcp_timeout(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_timeout()\n")); + /* back-off period has passed, or server selection timed out */ + if ((dhcp->state == DHCP_STATE_BACKING_OFF) || (dhcp->state == DHCP_STATE_SELECTING)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_timeout(): restarting discovery\n")); + dhcp_discover(netif); + /* receiving the requested lease timed out */ + } else if (dhcp->state == DHCP_STATE_REQUESTING) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): REQUESTING, DHCP request timed out\n")); + if (dhcp->tries <= 5) { + dhcp_select(netif); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): REQUESTING, releasing, restarting\n")); + dhcp_release(netif); + dhcp_discover(netif); + } +#if DHCP_DOES_ARP_CHECK + /* received no ARP reply for the offered address (which is good) */ + } else if (dhcp->state == DHCP_STATE_CHECKING) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): CHECKING, ARP request timed out\n")); + if (dhcp->tries <= 1) { + dhcp_check(netif); + /* no ARP replies on the offered address, + looks like the IP address is indeed free */ + } else { + /* bind the interface to the offered address */ + dhcp_bind(netif); + } +#endif /* DHCP_DOES_ARP_CHECK */ + } else if (dhcp->state == DHCP_STATE_REBOOTING) { + if (dhcp->tries < REBOOT_TRIES) { + dhcp_reboot(netif); + } else { + dhcp_discover(netif); + } + } +} + +/** + * The renewal period has timed out. + * + * @param netif the netif under DHCP control + */ +static void +dhcp_t1_timeout(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_t1_timeout()\n")); + if ((dhcp->state == DHCP_STATE_REQUESTING) || (dhcp->state == DHCP_STATE_BOUND) || + (dhcp->state == DHCP_STATE_RENEWING)) { + /* just retry to renew - note that the rebind timer (t2) will + * eventually time-out if renew tries fail. */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("dhcp_t1_timeout(): must renew\n")); + /* This slightly different to RFC2131: DHCPREQUEST will be sent from state + DHCP_STATE_RENEWING, not DHCP_STATE_BOUND */ + dhcp_renew(netif); + /* Calculate next timeout */ + if (((netif->dhcp->t2_timeout - dhcp->lease_used) / 2) >= ((60 + DHCP_COARSE_TIMER_SECS / 2) / DHCP_COARSE_TIMER_SECS)) + { + netif->dhcp->t1_renew_time = ((netif->dhcp->t2_timeout - dhcp->lease_used) / 2); + } + } +} + +/** + * The rebind period has timed out. + * + * @param netif the netif under DHCP control + */ +static void +dhcp_t2_timeout(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_t2_timeout()\n")); + if ((dhcp->state == DHCP_STATE_REQUESTING) || (dhcp->state == DHCP_STATE_BOUND) || + (dhcp->state == DHCP_STATE_RENEWING) || (dhcp->state == DHCP_STATE_REBINDING)) { + /* just retry to rebind */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + ("dhcp_t2_timeout(): must rebind\n")); + /* This slightly different to RFC2131: DHCPREQUEST will be sent from state + DHCP_STATE_REBINDING, not DHCP_STATE_BOUND */ + dhcp_rebind(netif); + /* Calculate next timeout */ + if (((netif->dhcp->t0_timeout - dhcp->lease_used) / 2) >= ((60 + DHCP_COARSE_TIMER_SECS / 2) / DHCP_COARSE_TIMER_SECS)) + { + netif->dhcp->t2_rebind_time = ((netif->dhcp->t0_timeout - dhcp->lease_used) / 2); + } + } +} + +/** + * Handle a DHCP ACK packet + * + * @param netif the netif under DHCP control + */ +static void +dhcp_handle_ack(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; +#if LWIP_DNS || LWIP_DHCP_GET_NTP_SRV + u8_t n; +#endif /* LWIP_DNS || LWIP_DHCP_GET_NTP_SRV */ +#if LWIP_DHCP_GET_NTP_SRV + ip4_addr_t ntp_server_addrs[LWIP_DHCP_MAX_NTP_SERVERS]; +#endif + + /* clear options we might not get from the ACK */ + ip4_addr_set_zero(&dhcp->offered_sn_mask); + ip4_addr_set_zero(&dhcp->offered_gw_addr); +#if LWIP_DHCP_BOOTP_FILE + ip4_addr_set_zero(&dhcp->offered_si_addr); +#endif /* LWIP_DHCP_BOOTP_FILE */ + + /* lease time given? */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_LEASE_TIME)) { + /* remember offered lease time */ + dhcp->offered_t0_lease = dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_LEASE_TIME); + } + /* renewal period given? */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_T1)) { + /* remember given renewal period */ + dhcp->offered_t1_renew = dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_T1); + } else { + /* calculate safe periods for renewal */ + dhcp->offered_t1_renew = dhcp->offered_t0_lease / 2; + } + + /* renewal period given? */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_T2)) { + /* remember given rebind period */ + dhcp->offered_t2_rebind = dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_T2); + } else { + /* calculate safe periods for rebinding (offered_t0_lease * 0.875 -> 87.5%)*/ + dhcp->offered_t2_rebind = (dhcp->offered_t0_lease * 7U) / 8U; + } + + /* (y)our internet address */ + ip4_addr_copy(dhcp->offered_ip_addr, dhcp->msg_in->yiaddr); + +#if LWIP_DHCP_BOOTP_FILE + /* copy boot server address, + boot file name copied in dhcp_parse_reply if not overloaded */ + ip_addr_copy(dhcp->offered_si_addr, dhcp->msg_in->siaddr); +#endif /* LWIP_DHCP_BOOTP_FILE */ + + /* subnet mask given? */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_SUBNET_MASK)) { + /* remember given subnet mask */ + ip4_addr_set_u32(&dhcp->offered_sn_mask, htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_SUBNET_MASK))); + dhcp->subnet_mask_given = 1; + } else { + dhcp->subnet_mask_given = 0; + } + + /* gateway router */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_ROUTER)) { + ip4_addr_set_u32(&dhcp->offered_gw_addr, htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_ROUTER))); + } + +#if LWIP_DHCP_GET_NTP_SRV + /* NTP servers */ + for (n = 0; (n < LWIP_DHCP_MAX_NTP_SERVERS) && dhcp_option_given(dhcp, DHCP_OPTION_IDX_NTP_SERVER + n); n++) { + ip4_addr_set_u32(&ntp_server_addrs[n], htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_NTP_SERVER + n))); + } + dhcp_set_ntp_servers(n, ntp_server_addrs); +#endif /* LWIP_DHCP_GET_NTP_SRV */ + +#if LWIP_DNS + /* DNS servers */ + for (n = 0; (n < DNS_MAX_SERVERS) && dhcp_option_given(dhcp, DHCP_OPTION_IDX_DNS_SERVER + n); n++) { + ip_addr_t dns_addr; + ip_addr_set_ip4_u32(&dns_addr, htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_DNS_SERVER + n))); + dns_setserver(n, &dns_addr); + } +#endif /* LWIP_DNS */ +} + +/** Set a statically allocated struct dhcp to work with. + * Using this prevents dhcp_start to allocate it using mem_malloc. + * + * @param netif the netif for which to set the struct dhcp + * @param dhcp (uninitialised) dhcp struct allocated by the application + */ +void +dhcp_set_struct(struct netif *netif, struct dhcp *dhcp) +{ + LWIP_ASSERT("netif != NULL", netif != NULL); + LWIP_ASSERT("dhcp != NULL", dhcp != NULL); + LWIP_ASSERT("netif already has a struct dhcp set", netif->dhcp == NULL); + + /* clear data structure */ + memset(dhcp, 0, sizeof(struct dhcp)); + /* dhcp_set_state(&dhcp, DHCP_STATE_OFF); */ + netif->dhcp = dhcp; +} + +/** Removes a struct dhcp from a netif. + * + * ATTENTION: Only use this when not using dhcp_set_struct() to allocate the + * struct dhcp since the memory is passed back to the heap. + * + * @param netif the netif from which to remove the struct dhcp + */ +void dhcp_cleanup(struct netif *netif) +{ + LWIP_ASSERT("netif != NULL", netif != NULL); + + if (netif->dhcp != NULL) { + mem_free(netif->dhcp); + netif->dhcp = NULL; + } +} + +/** + * Start DHCP negotiation for a network interface. + * + * If no DHCP client instance was attached to this interface, + * a new client is created first. If a DHCP client instance + * was already present, it restarts negotiation. + * + * @param netif The lwIP network interface + * @return lwIP error code + * - ERR_OK - No error + * - ERR_MEM - Out of memory + */ +err_t +dhcp_start(struct netif *netif) +{ + struct dhcp *dhcp; + err_t result; + + LWIP_ERROR("netif != NULL", (netif != NULL), return ERR_ARG;); + LWIP_ERROR("netif is not up, old style port?", netif_is_up(netif), return ERR_ARG;); + dhcp = netif->dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_start(netif=%p) %c%c%"U16_F"\n", (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num)); + + /* check hwtype of the netif */ + if ((netif->flags & NETIF_FLAG_ETHARP) == 0) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): No ETHARP netif\n")); + return ERR_ARG; + } + + /* check MTU of the netif */ + if (netif->mtu < DHCP_MAX_MSG_LEN_MIN_REQUIRED) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): Cannot use this netif with DHCP: MTU is too small\n")); + return ERR_MEM; + } + + /* no DHCP client attached yet? */ + if (dhcp == NULL) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): starting new DHCP client\n")); + dhcp = (struct dhcp *)mem_malloc(sizeof(struct dhcp)); + if (dhcp == NULL) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): could not allocate dhcp\n")); + return ERR_MEM; + } + + /* store this dhcp client in the netif */ + netif->dhcp = dhcp; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): allocated dhcp")); + /* already has DHCP client attached */ + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_start(): restarting DHCP configuration\n")); + LWIP_ASSERT("pbuf p_out wasn't freed", dhcp->p_out == NULL); + LWIP_ASSERT("reply wasn't freed", dhcp->msg_in == NULL ); + + if(dhcp->pcb_allocated != 0) { + dhcp_dec_pcb_refcount(); /* free DHCP PCB if not needed any more */ + } + /* dhcp is cleared below, no need to reset flag*/ + } + + /* clear data structure */ + memset(dhcp, 0, sizeof(struct dhcp)); + /* dhcp_set_state(&dhcp, DHCP_STATE_OFF); */ + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): starting DHCP configuration\n")); + + if(dhcp_inc_pcb_refcount() != ERR_OK) { /* ensure DHCP PCB is allocated */ + return ERR_MEM; + } + dhcp->pcb_allocated = 1; + +#if LWIP_DHCP_CHECK_LINK_UP + if (!netif_is_link_up(netif)) { + /* set state INIT and wait for dhcp_network_changed() to call dhcp_discover() */ + dhcp_set_state(dhcp, DHCP_STATE_INIT); + return ERR_OK; + } +#endif /* LWIP_DHCP_CHECK_LINK_UP */ + + + /* (re)start the DHCP negotiation */ + result = dhcp_discover(netif); + if (result != ERR_OK) { + /* free resources allocated above */ + dhcp_stop(netif); + return ERR_MEM; + } + return result; +} + +/** + * Inform a DHCP server of our manual configuration. + * + * This informs DHCP servers of our fixed IP address configuration + * by sending an INFORM message. It does not involve DHCP address + * configuration, it is just here to be nice to the network. + * + * @param netif The lwIP network interface + */ +void +dhcp_inform(struct netif *netif) +{ + struct dhcp dhcp; + err_t result = ERR_OK; + + LWIP_ERROR("netif != NULL", (netif != NULL), return;); + + if(dhcp_inc_pcb_refcount() != ERR_OK) { /* ensure DHCP PCB is allocated */ + return; + } + + memset(&dhcp, 0, sizeof(struct dhcp)); + dhcp_set_state(&dhcp, DHCP_STATE_INFORMING); + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, &dhcp, DHCP_INFORM); + if (result == ERR_OK) { + dhcp_option(&dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(&dhcp, DHCP_MAX_MSG_LEN(netif)); + + dhcp_option_trailer(&dhcp); + + pbuf_realloc(dhcp.p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp.options_out_len); + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_inform: INFORMING\n")); + + udp_sendto_if(dhcp_pcb, dhcp.p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif); + + dhcp_delete_msg(&dhcp); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_inform: could not allocate DHCP request\n")); + } + + dhcp_dec_pcb_refcount(); /* delete DHCP PCB if not needed any more */ +} + +/** Handle a possible change in the network configuration. + * + * This enters the REBOOTING state to verify that the currently bound + * address is still valid. + */ +void +dhcp_network_changed(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + if (!dhcp) + return; + switch (dhcp->state) { + case DHCP_STATE_REBINDING: + case DHCP_STATE_RENEWING: + case DHCP_STATE_BOUND: + case DHCP_STATE_REBOOTING: + dhcp->tries = 0; + dhcp_reboot(netif); + break; + case DHCP_STATE_OFF: + /* stay off */ + break; + default: + /* INIT/REQUESTING/CHECKING/BACKING_OFF restart with new 'rid' because the + state changes, SELECTING: continue with current 'rid' as we stay in the + same state */ +#if LWIP_DHCP_AUTOIP_COOP + if (dhcp->autoip_coop_state == DHCP_AUTOIP_COOP_STATE_ON) { + autoip_stop(netif); + dhcp->autoip_coop_state = DHCP_AUTOIP_COOP_STATE_OFF; + } +#endif /* LWIP_DHCP_AUTOIP_COOP */ + /* ensure we start with short timeouts, even if already discovering */ + dhcp->tries = 0; + dhcp_discover(netif); + break; + } +} + +#if DHCP_DOES_ARP_CHECK +/** + * Match an ARP reply with the offered IP address. + * + * @param netif the network interface on which the reply was received + * @param addr The IP address we received a reply from + */ +void dhcp_arp_reply(struct netif *netif, const ip4_addr_t *addr) +{ + LWIP_ERROR("netif != NULL", (netif != NULL), return;); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_arp_reply()\n")); + /* is a DHCP client doing an ARP check? */ + if ((netif->dhcp != NULL) && (netif->dhcp->state == DHCP_STATE_CHECKING)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_arp_reply(): CHECKING, arp reply for 0x%08"X32_F"\n", + ip4_addr_get_u32(addr))); + /* did a host respond with the address we + were offered by the DHCP server? */ + if (ip4_addr_cmp(addr, &netif->dhcp->offered_ip_addr)) { + /* we will not accept the offered address */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE | LWIP_DBG_LEVEL_WARNING, + ("dhcp_arp_reply(): arp reply matched with offered address, declining\n")); + dhcp_decline(netif); + } + } +} + +/** + * Decline an offered lease. + * + * Tell the DHCP server we do not accept the offered address. + * One reason to decline the lease is when we find out the address + * is already in use by another host (through ARP). + * + * @param netif the netif under DHCP control + */ +static err_t +dhcp_decline(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result = ERR_OK; + u16_t msecs; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_decline()\n")); + dhcp_set_state(dhcp, DHCP_STATE_BACKING_OFF); + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_DECLINE); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_REQUESTED_IP, 4); + dhcp_option_long(dhcp, ntohl(ip4_addr_get_u32(&dhcp->offered_ip_addr))); + + dhcp_option_trailer(dhcp); + /* resize pbuf to reflect true size of options */ + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + /* per section 4.4.4, broadcast DECLINE messages */ + udp_sendto_if_src(dhcp_pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif, IP_ADDR_ANY); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_decline: BACKING OFF\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("dhcp_decline: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + msecs = 10*1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_decline(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} +#endif /* DHCP_DOES_ARP_CHECK */ + + +/** + * Start the DHCP process, discover a DHCP server. + * + * @param netif the netif under DHCP control + */ +static err_t +dhcp_discover(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result = ERR_OK; + u16_t msecs; + u8_t i; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover()\n")); + ip4_addr_set_any(&dhcp->offered_ip_addr); + dhcp_set_state(dhcp, DHCP_STATE_SELECTING); + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_DISCOVER); + if (result == ERR_OK) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover: making request\n")); + + dhcp_option(dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(dhcp, DHCP_MAX_MSG_LEN(netif)); + +#ifdef LWIP_ESP8266 +#if LWIP_NETIF_HOSTNAME + dhcp_option_hostname(dhcp, netif); +#endif /* LWIP_NETIF_HOSTNAME */ +#endif + + dhcp_option(dhcp, DHCP_OPTION_PARAMETER_REQUEST_LIST, sizeof(dhcp_discover_select_options)); + for (i = 0; i < sizeof(dhcp_discover_select_options); i++) { + dhcp_option_byte(dhcp, dhcp_discover_select_options[i]); + } + dhcp_option_trailer(dhcp); + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover: realloc()ing\n")); + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover: sendto(DISCOVER, IP_ADDR_BROADCAST, DHCP_SERVER_PORT)\n")); + udp_sendto_if_src(dhcp_pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif, IP_ADDR_ANY); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover: deleting()ing\n")); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_discover: SELECTING\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_discover: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } +#if LWIP_DHCP_AUTOIP_COOP + if (dhcp->tries >= LWIP_DHCP_AUTOIP_COOP_TRIES && dhcp->autoip_coop_state == DHCP_AUTOIP_COOP_STATE_OFF) { + dhcp->autoip_coop_state = DHCP_AUTOIP_COOP_STATE_ON; + autoip_start(netif); + } +#endif /* LWIP_DHCP_AUTOIP_COOP */ + msecs = (dhcp->tries < 6 ? 1 << dhcp->tries : 60) * 1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_discover(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} + + +/** + * Bind the interface to the offered IP address. + * + * @param netif network interface to bind to the offered address + */ +static void +dhcp_bind(struct netif *netif) +{ + u32_t timeout; + struct dhcp *dhcp; + ip4_addr_t sn_mask, gw_addr; + LWIP_ERROR("dhcp_bind: netif != NULL", (netif != NULL), return;); + dhcp = netif->dhcp; + LWIP_ERROR("dhcp_bind: dhcp != NULL", (dhcp != NULL), return;); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_bind(netif=%p) %c%c%"U16_F"\n", (void*)netif, netif->name[0], netif->name[1], (u16_t)netif->num)); + + /* reset time used of lease */ + dhcp->lease_used = 0; + + if (dhcp->offered_t0_lease != 0xffffffffUL) { + /* set renewal period timer */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_bind(): t0 renewal timer %"U32_F" secs\n", dhcp->offered_t0_lease)); + timeout = (dhcp->offered_t0_lease + DHCP_COARSE_TIMER_SECS / 2) / DHCP_COARSE_TIMER_SECS; + if (timeout > 0xffff) { + timeout = 0xffff; + } + dhcp->t0_timeout = (u16_t)timeout; + if (dhcp->t0_timeout == 0) { + dhcp->t0_timeout = 1; + } + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_bind(): set request timeout %"U32_F" msecs\n", dhcp->offered_t0_lease*1000)); + } + + /* temporary DHCP lease? */ + if (dhcp->offered_t1_renew != 0xffffffffUL) { + /* set renewal period timer */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_bind(): t1 renewal timer %"U32_F" secs\n", dhcp->offered_t1_renew)); + timeout = (dhcp->offered_t1_renew + DHCP_COARSE_TIMER_SECS / 2) / DHCP_COARSE_TIMER_SECS; + if (timeout > 0xffff) { + timeout = 0xffff; + } + dhcp->t1_timeout = (u16_t)timeout; + if (dhcp->t1_timeout == 0) { + dhcp->t1_timeout = 1; + } + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_bind(): set request timeout %"U32_F" msecs\n", dhcp->offered_t1_renew*1000)); + dhcp->t1_renew_time = dhcp->t1_timeout; + } + /* set renewal period timer */ + if (dhcp->offered_t2_rebind != 0xffffffffUL) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_bind(): t2 rebind timer %"U32_F" secs\n", dhcp->offered_t2_rebind)); + timeout = (dhcp->offered_t2_rebind + DHCP_COARSE_TIMER_SECS / 2) / DHCP_COARSE_TIMER_SECS; + if (timeout > 0xffff) { + timeout = 0xffff; + } + dhcp->t2_timeout = (u16_t)timeout; + if (dhcp->t2_timeout == 0) { + dhcp->t2_timeout = 1; + } + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_bind(): set request timeout %"U32_F" msecs\n", dhcp->offered_t2_rebind*1000)); + dhcp->t2_rebind_time = dhcp->t2_timeout; + } + + /* If we have sub 1 minute lease, t2 and t1 will kick in at the same time. */ + if ((dhcp->t1_timeout >= dhcp->t2_timeout) && (dhcp->t2_timeout > 0)) { + dhcp->t1_timeout = 0; + } + + if (dhcp->subnet_mask_given) { + /* copy offered network mask */ + ip4_addr_copy(sn_mask, dhcp->offered_sn_mask); + } else { + /* subnet mask not given, choose a safe subnet mask given the network class */ + u8_t first_octet = ip4_addr1(&dhcp->offered_ip_addr); + if (first_octet <= 127) { + ip4_addr_set_u32(&sn_mask, PP_HTONL(0xff000000UL)); + } else if (first_octet >= 192) { + ip4_addr_set_u32(&sn_mask, PP_HTONL(0xffffff00UL)); + } else { + ip4_addr_set_u32(&sn_mask, PP_HTONL(0xffff0000UL)); + } + } + + ip4_addr_copy(gw_addr, dhcp->offered_gw_addr); + /* gateway address not given? */ + if (ip4_addr_isany_val(gw_addr)) { + /* copy network address */ + ip4_addr_get_network(&gw_addr, &dhcp->offered_ip_addr, &sn_mask); + /* use first host address on network as gateway */ + ip4_addr_set_u32(&gw_addr, ip4_addr_get_u32(&gw_addr) | PP_HTONL(0x00000001UL)); + } + +#if LWIP_DHCP_AUTOIP_COOP + if (dhcp->autoip_coop_state == DHCP_AUTOIP_COOP_STATE_ON) { + autoip_stop(netif); + dhcp->autoip_coop_state = DHCP_AUTOIP_COOP_STATE_OFF; + } +#endif /* LWIP_DHCP_AUTOIP_COOP */ + + /* Espressif add start. */ + /* back up old ip/netmask/gw */ + ip4_addr_t ip, mask, gw; + ip4_addr_set(&ip, ip_2_ip4(&netif->ip_addr)); + ip4_addr_set(&mask, ip_2_ip4(&netif->netmask)); + ip4_addr_set(&gw, ip_2_ip4(&netif->gw)); + /* Espressif add end. */ + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_bind(): IP: 0x%08"X32_F" SN: 0x%08"X32_F" GW: 0x%08"X32_F"\n", + ip4_addr_get_u32(&dhcp->offered_ip_addr), ip4_addr_get_u32(&sn_mask), ip4_addr_get_u32(&gw_addr))); + netif_set_addr(netif, &dhcp->offered_ip_addr, &sn_mask, &gw_addr); + /* interface is used by routing now that an address is set */ + +#ifdef LWIP_ESP8266 + /* use old ip/mask/gw to check whether ip/mask/gw changed */ +// extern void system_station_got_ip_set(ip4_addr_t *ip, ip4_addr_t *mask, ip4_addr_t *gw); +// system_station_got_ip_set(&ip, &mask, &gw); +#endif + + /* use old ip/mask/gw to check whether ip/mask/gw changed */ +// extern void system_station_got_ip_set(ip4_addr_t *ip, ip4_addr_t *mask, ip4_addr_t *gw); +// system_station_got_ip_set(&ip, &mask, &gw); + + /* netif is now bound to DHCP leased address */ + dhcp_set_state(dhcp, DHCP_STATE_BOUND); + +} + +/** + * Renew an existing DHCP lease at the involved DHCP server. + * + * @param netif network interface which must renew its lease + */ +err_t +dhcp_renew(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + u16_t msecs; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_renew()\n")); + dhcp_set_state(dhcp, DHCP_STATE_RENEWING); + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_REQUEST); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(dhcp, DHCP_MAX_MSG_LEN(netif)); + +#if LWIP_NETIF_HOSTNAME + dhcp_option_hostname(dhcp, netif); +#endif /* LWIP_NETIF_HOSTNAME */ + + /* append DHCP message trailer */ + dhcp_option_trailer(dhcp); + + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + udp_sendto_if(dhcp_pcb, dhcp->p_out, &dhcp->server_ip_addr, DHCP_SERVER_PORT, netif); + dhcp_delete_msg(dhcp); + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_renew: RENEWING\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_renew: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + /* back-off on retries, but to a maximum of 20 seconds */ + msecs = dhcp->tries < 10 ? dhcp->tries * 2000 : 20 * 1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_renew(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} + +/** + * Rebind with a DHCP server for an existing DHCP lease. + * + * @param netif network interface which must rebind with a DHCP server + */ +static err_t +dhcp_rebind(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + u16_t msecs; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_rebind()\n")); + dhcp_set_state(dhcp, DHCP_STATE_REBINDING); + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_REQUEST); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(dhcp, DHCP_MAX_MSG_LEN(netif)); + +#if LWIP_NETIF_HOSTNAME + dhcp_option_hostname(dhcp, netif); +#endif /* LWIP_NETIF_HOSTNAME */ + + dhcp_option_trailer(dhcp); + + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + /* broadcast to server */ + udp_sendto_if(dhcp_pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_rebind: REBINDING\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_rebind: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + msecs = dhcp->tries < 10 ? dhcp->tries * 1000 : 10 * 1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_rebind(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} + +/** + * Enter REBOOTING state to verify an existing lease + * + * @param netif network interface which must reboot + */ +static err_t +dhcp_reboot(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + u16_t msecs; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_reboot()\n")); + dhcp_set_state(dhcp, DHCP_STATE_REBOOTING); + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_REQUEST); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_MAX_MSG_SIZE, DHCP_OPTION_MAX_MSG_SIZE_LEN); + dhcp_option_short(dhcp, 576); + + dhcp_option(dhcp, DHCP_OPTION_REQUESTED_IP, 4); + dhcp_option_long(dhcp, ntohl(ip4_addr_get_u32(&dhcp->offered_ip_addr))); + + dhcp_option_trailer(dhcp); + + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + /* broadcast to server */ + udp_sendto_if(dhcp_pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_reboot: REBOOTING\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_reboot: could not allocate DHCP request\n")); + } + if (dhcp->tries < 255) { + dhcp->tries++; + } + msecs = dhcp->tries < 10 ? dhcp->tries * 1000 : 10 * 1000; + dhcp->request_timeout = (msecs + DHCP_FINE_TIMER_MSECS - 1) / DHCP_FINE_TIMER_MSECS; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_reboot(): set request timeout %"U16_F" msecs\n", msecs)); + return result; +} + + +/** + * Release a DHCP lease. + * + * @param netif network interface which must release its lease + */ +err_t +dhcp_release(struct netif *netif) +{ + struct dhcp *dhcp = netif->dhcp; + err_t result; + ip_addr_t server_ip_addr; + u8_t is_dhcp_supplied_address; + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_release()\n")); + if (dhcp == NULL) { + return ERR_ARG; + } + ip_addr_copy(server_ip_addr, dhcp->server_ip_addr); + + is_dhcp_supplied_address = dhcp_supplied_address(netif); + + /* idle DHCP client */ + dhcp_set_state(dhcp, DHCP_STATE_OFF); + /* clean old DHCP offer */ + ip_addr_set_zero_ip4(&dhcp->server_ip_addr); + ip4_addr_set_zero(&dhcp->offered_ip_addr); + ip4_addr_set_zero(&dhcp->offered_sn_mask); + ip4_addr_set_zero(&dhcp->offered_gw_addr); +#if LWIP_DHCP_BOOTP_FILE + ip4_addr_set_zero(&dhcp->offered_si_addr); +#endif /* LWIP_DHCP_BOOTP_FILE */ + dhcp->offered_t0_lease = dhcp->offered_t1_renew = dhcp->offered_t2_rebind = 0; + dhcp->t1_renew_time = dhcp->t2_rebind_time = dhcp->lease_used = dhcp->t0_timeout = 0; + + if (!is_dhcp_supplied_address) { + /* don't issue release message when address is not dhcp-assigned */ + return ERR_OK; + } + + /* create and initialize the DHCP message header */ + result = dhcp_create_msg(netif, dhcp, DHCP_RELEASE); + if (result == ERR_OK) { + dhcp_option(dhcp, DHCP_OPTION_SERVER_ID, 4); + dhcp_option_long(dhcp, ntohl(ip4_addr_get_u32(ip_2_ip4(&server_ip_addr)))); + + dhcp_option_trailer(dhcp); + + pbuf_realloc(dhcp->p_out, sizeof(struct dhcp_msg) - DHCP_OPTIONS_LEN + dhcp->options_out_len); + + udp_sendto_if(dhcp_pcb, dhcp->p_out, &server_ip_addr, DHCP_SERVER_PORT, netif); + dhcp_delete_msg(dhcp); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_release: RELEASED, DHCP_STATE_OFF\n")); + } else { + /* sending release failed, but that's not a problem since the correct behaviour of dhcp does not rely on release */ + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_release: could not allocate DHCP request\n")); + } + /* remove IP address from interface (prevents routing from selecting this interface) */ + netif_set_addr(netif, IP4_ADDR_ANY, IP4_ADDR_ANY, IP4_ADDR_ANY); + + return result; +} + +/** + * Remove the DHCP client from the interface. + * + * @param netif The network interface to stop DHCP on + */ +void +dhcp_stop(struct netif *netif) +{ + struct dhcp *dhcp; + LWIP_ERROR("dhcp_stop: netif != NULL", (netif != NULL), return;); + dhcp = netif->dhcp; + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_stop()\n")); + /* netif is DHCP configured? */ + if (dhcp != NULL) { +#if LWIP_DHCP_AUTOIP_COOP + if (dhcp->autoip_coop_state == DHCP_AUTOIP_COOP_STATE_ON) { + autoip_stop(netif); + dhcp->autoip_coop_state = DHCP_AUTOIP_COOP_STATE_OFF; + } +#endif /* LWIP_DHCP_AUTOIP_COOP */ + + LWIP_ASSERT("reply wasn't freed", dhcp->msg_in == NULL); + dhcp_set_state(dhcp, DHCP_STATE_OFF); + + if(dhcp->pcb_allocated != 0) { + dhcp_dec_pcb_refcount(); /* free DHCP PCB if not needed any more */ + dhcp->pcb_allocated = 0; + } + } +} + +/* + * Set the DHCP state of a DHCP client. + * + * If the state changed, reset the number of tries. + */ +static void +dhcp_set_state(struct dhcp *dhcp, u8_t new_state) +{ + if (new_state != dhcp->state) { + dhcp->state = new_state; + dhcp->tries = 0; + dhcp->request_timeout = 0; + } +} + +/* + * Concatenate an option type and length field to the outgoing + * DHCP message. + * + */ +static void +dhcp_option(struct dhcp *dhcp, u8_t option_type, u8_t option_len) +{ + LWIP_ASSERT("dhcp_option: dhcp->options_out_len + 2 + option_len <= DHCP_OPTIONS_LEN", dhcp->options_out_len + 2U + option_len <= DHCP_OPTIONS_LEN); + dhcp->msg_out->options[dhcp->options_out_len++] = option_type; + dhcp->msg_out->options[dhcp->options_out_len++] = option_len; +} +/* + * Concatenate a single byte to the outgoing DHCP message. + * + */ +static void +dhcp_option_byte(struct dhcp *dhcp, u8_t value) +{ + LWIP_ASSERT("dhcp_option_byte: dhcp->options_out_len < DHCP_OPTIONS_LEN", dhcp->options_out_len < DHCP_OPTIONS_LEN); + dhcp->msg_out->options[dhcp->options_out_len++] = value; +} + +static void +dhcp_option_short(struct dhcp *dhcp, u16_t value) +{ + LWIP_ASSERT("dhcp_option_short: dhcp->options_out_len + 2 <= DHCP_OPTIONS_LEN", dhcp->options_out_len + 2U <= DHCP_OPTIONS_LEN); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t)((value & 0xff00U) >> 8); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t) (value & 0x00ffU); +} + +static void +dhcp_option_long(struct dhcp *dhcp, u32_t value) +{ + LWIP_ASSERT("dhcp_option_long: dhcp->options_out_len + 4 <= DHCP_OPTIONS_LEN", dhcp->options_out_len + 4U <= DHCP_OPTIONS_LEN); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t)((value & 0xff000000UL) >> 24); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t)((value & 0x00ff0000UL) >> 16); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t)((value & 0x0000ff00UL) >> 8); + dhcp->msg_out->options[dhcp->options_out_len++] = (u8_t)((value & 0x000000ffUL)); +} + +#if LWIP_NETIF_HOSTNAME +static void +dhcp_option_hostname(struct dhcp *dhcp, struct netif *netif) +{ + if (netif->hostname != NULL) { + size_t namelen = strlen(netif->hostname); + if (namelen > 0) { + u8_t len; + const char *p = netif->hostname; + /* Shrink len to available bytes (need 2 bytes for OPTION_HOSTNAME + and 1 byte for trailer) */ + size_t available = DHCP_OPTIONS_LEN - dhcp->options_out_len - 3; + LWIP_ASSERT("DHCP: hostname is too long!", namelen <= available); + len = LWIP_MIN(namelen, available); + dhcp_option(dhcp, DHCP_OPTION_HOSTNAME, len); + while (len--) { + dhcp_option_byte(dhcp, *p++); + } + } + } +} +#endif /* LWIP_NETIF_HOSTNAME */ + +/** + * Extract the DHCP message and the DHCP options. + * + * Extract the DHCP message and the DHCP options, each into a contiguous + * piece of memory. As a DHCP message is variable sized by its options, + * and also allows overriding some fields for options, the easy approach + * is to first unfold the options into a contiguous piece of memory, and + * use that further on. + * + */ +static err_t +dhcp_parse_reply(struct dhcp *dhcp, struct pbuf *p) +{ + u8_t *options; + u16_t offset; + u16_t offset_max; + u16_t options_idx; + u16_t options_idx_max; + struct pbuf *q; + int parse_file_as_options = 0; + int parse_sname_as_options = 0; + + /* clear received options */ + dhcp_clear_all_options(dhcp); + /* check that beginning of dhcp_msg (up to and including chaddr) is in first pbuf */ + if (p->len < DHCP_SNAME_OFS) { + return ERR_BUF; + } + dhcp->msg_in = (struct dhcp_msg *)p->payload; +#if LWIP_DHCP_BOOTP_FILE + /* clear boot file name */ + dhcp->boot_file_name[0] = 0; +#endif /* LWIP_DHCP_BOOTP_FILE */ + + /* parse options */ + + /* start with options field */ + options_idx = DHCP_OPTIONS_OFS; + /* parse options to the end of the received packet */ + options_idx_max = p->tot_len; +again: + q = p; + while ((q != NULL) && (options_idx >= q->len)) { + options_idx -= q->len; + options_idx_max -= q->len; + q = q->next; + } + if (q == NULL) { + return ERR_BUF; + } + offset = options_idx; + offset_max = options_idx_max; + options = (u8_t*)q->payload; + /* at least 1 byte to read and no end marker, then at least 3 bytes to read? */ + while ((q != NULL) && (options[offset] != DHCP_OPTION_END) && (offset < offset_max)) { + u8_t op = options[offset]; + u8_t len; + u8_t decode_len = 0; + int decode_idx = -1; + u16_t val_offset = offset + 2; + /* len byte might be in the next pbuf */ + if (offset + 1 < q->len) { + len = options[offset + 1]; + } else { + len = (q->next != NULL ? ((u8_t*)q->next->payload)[0] : 0); + } + /* LWIP_DEBUGF(DHCP_DEBUG, ("msg_offset=%"U16_F", q->len=%"U16_F, msg_offset, q->len)); */ + decode_len = len; + switch(op) { + /* case(DHCP_OPTION_END): handled above */ + case(DHCP_OPTION_PAD): + /* special option: no len encoded */ + decode_len = len = 0; + /* will be increased below */ + offset--; + break; + case(DHCP_OPTION_SUBNET_MASK): + LWIP_ERROR("len == 4", len == 4, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_SUBNET_MASK; + break; + case(DHCP_OPTION_ROUTER): + decode_len = 4; /* only copy the first given router */ + LWIP_ERROR("len >= decode_len", len >= decode_len, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_ROUTER; + break; + case(DHCP_OPTION_DNS_SERVER): + /* special case: there might be more than one server */ + LWIP_ERROR("len % 4 == 0", len % 4 == 0, return ERR_VAL;); + /* limit number of DNS servers */ + decode_len = LWIP_MIN(len, 4 * DNS_MAX_SERVERS); + LWIP_ERROR("len >= decode_len", len >= decode_len, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_DNS_SERVER; + break; + case(DHCP_OPTION_LEASE_TIME): + LWIP_ERROR("len == 4", len == 4, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_LEASE_TIME; + break; +#if LWIP_DHCP_GET_NTP_SRV + case(DHCP_OPTION_NTP): + /* special case: there might be more than one server */ + LWIP_ERROR("len % 4 == 0", len % 4 == 0, return ERR_VAL;); + /* limit number of NTP servers */ + decode_len = LWIP_MIN(len, 4 * LWIP_DHCP_MAX_NTP_SERVERS); + LWIP_ERROR("len >= decode_len", len >= decode_len, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_NTP_SERVER; + break; +#endif /* LWIP_DHCP_GET_NTP_SRV*/ + case(DHCP_OPTION_OVERLOAD): + LWIP_ERROR("len == 1", len == 1, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_OVERLOAD; + break; + case(DHCP_OPTION_MESSAGE_TYPE): + LWIP_ERROR("len == 1", len == 1, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_MSG_TYPE; + break; + case(DHCP_OPTION_SERVER_ID): + LWIP_ERROR("len == 4", len == 4, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_SERVER_ID; + break; + case(DHCP_OPTION_T1): + LWIP_ERROR("len == 4", len == 4, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_T1; + break; + case(DHCP_OPTION_T2): + LWIP_ERROR("len == 4", len == 4, return ERR_VAL;); + decode_idx = DHCP_OPTION_IDX_T2; + break; + default: + decode_len = 0; + LWIP_DEBUGF(DHCP_DEBUG, ("skipping option %"U16_F" in options\n", op)); + break; + } + offset += len + 2; + if (decode_len > 0) { + u32_t value = 0; + u16_t copy_len; +decode_next: + LWIP_ASSERT("check decode_idx", decode_idx >= 0 && decode_idx < DHCP_OPTION_IDX_MAX); + if (!dhcp_option_given(dhcp, decode_idx)) { + copy_len = LWIP_MIN(decode_len, 4); + pbuf_copy_partial(q, &value, copy_len, val_offset); + if (decode_len > 4) { + /* decode more than one u32_t */ + LWIP_ERROR("decode_len % 4 == 0", decode_len % 4 == 0, return ERR_VAL;); + dhcp_got_option(dhcp, decode_idx); + dhcp_set_option_value(dhcp, decode_idx, htonl(value)); + decode_len -= 4; + val_offset += 4; + decode_idx++; + goto decode_next; + } else if (decode_len == 4) { + value = ntohl(value); + } else { + LWIP_ERROR("invalid decode_len", decode_len == 1, return ERR_VAL;); + value = ((u8_t*)&value)[0]; + } + dhcp_got_option(dhcp, decode_idx); + dhcp_set_option_value(dhcp, decode_idx, value); + } + } + if (offset >= q->len) { + offset -= q->len; + offset_max -= q->len; + if ((offset < offset_max) && offset_max) { + q = q->next; + LWIP_ASSERT("next pbuf was null", q); + options = (u8_t*)q->payload; + } else { + /* We've run out of bytes, probably no end marker. Don't proceed. */ + break; + } + } + } + /* is this an overloaded message? */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_OVERLOAD)) { + u32_t overload = dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_OVERLOAD); + dhcp_clear_option(dhcp, DHCP_OPTION_IDX_OVERLOAD); + if (overload == DHCP_OVERLOAD_FILE) { + parse_file_as_options = 1; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("overloaded file field\n")); + } else if (overload == DHCP_OVERLOAD_SNAME) { + parse_sname_as_options = 1; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("overloaded sname field\n")); + } else if (overload == DHCP_OVERLOAD_SNAME_FILE) { + parse_sname_as_options = 1; + parse_file_as_options = 1; + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("overloaded sname and file field\n")); + } else { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("invalid overload option: %d\n", (int)overload)); + } +#if LWIP_DHCP_BOOTP_FILE + if (!parse_file_as_options) { + /* only do this for ACK messages */ + if (dhcp_option_given(dhcp, DHCP_OPTION_IDX_MSG_TYPE) && + (dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_MSG_TYPE) == DHCP_ACK)) + /* copy bootp file name, don't care for sname (server hostname) */ + pbuf_copy_partial(p, dhcp->boot_file_name, DHCP_FILE_LEN-1, DHCP_FILE_OFS); + /* make sure the string is really NULL-terminated */ + dhcp->boot_file_name[DHCP_FILE_LEN-1] = 0; + } +#endif /* LWIP_DHCP_BOOTP_FILE */ + } + if (parse_file_as_options) { + /* if both are overloaded, parse file first and then sname (RFC 2131 ch. 4.1) */ + parse_file_as_options = 0; + options_idx = DHCP_FILE_OFS; + options_idx_max = DHCP_FILE_OFS + DHCP_FILE_LEN; + goto again; + } else if (parse_sname_as_options) { + parse_sname_as_options = 0; + options_idx = DHCP_SNAME_OFS; + options_idx_max = DHCP_SNAME_OFS + DHCP_SNAME_LEN; + goto again; + } + return ERR_OK; +} + +/** + * If an incoming DHCP message is in response to us, then trigger the state machine + */ +static void +dhcp_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port) +{ + struct netif *netif = ip_current_input_netif(); + struct dhcp *dhcp = netif->dhcp; + struct dhcp_msg *reply_msg = (struct dhcp_msg *)p->payload; + u8_t msg_type; + u8_t i; + + LWIP_UNUSED_ARG(arg); + + /* Caught DHCP message from netif that does not have DHCP enabled? -> not interested */ + if((dhcp == NULL) || (dhcp->pcb_allocated == 0)) { + goto free_pbuf_and_return; + } + + LWIP_ASSERT("invalid server address type", !IP_IS_V6(addr)); + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_recv(pbuf = %p) from DHCP server %"U16_F".%"U16_F".%"U16_F".%"U16_F" port %"U16_F"\n", (void*)p, + ip4_addr1_16(ip_2_ip4(addr)), ip4_addr2_16(ip_2_ip4(addr)), ip4_addr3_16(ip_2_ip4(addr)), ip4_addr4_16(ip_2_ip4(addr)), port)); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("pbuf->len = %"U16_F"\n", p->len)); + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("pbuf->tot_len = %"U16_F"\n", p->tot_len)); + /* prevent warnings about unused arguments */ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(addr); + LWIP_UNUSED_ARG(port); + + LWIP_ASSERT("reply wasn't freed", dhcp->msg_in == NULL); + + if (p->len < DHCP_MIN_REPLY_LEN) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("DHCP reply message or pbuf too short\n")); + goto free_pbuf_and_return; + } + + if (reply_msg->op != DHCP_BOOTREPLY) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("not a DHCP reply message, but type %"U16_F"\n", (u16_t)reply_msg->op)); + goto free_pbuf_and_return; + } + /* iterate through hardware address and match against DHCP message */ + for (i = 0; i < netif->hwaddr_len && i < NETIF_MAX_HWADDR_LEN && i < DHCP_CHADDR_LEN; i++) { + if (netif->hwaddr[i] != reply_msg->chaddr[i]) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("netif->hwaddr[%"U16_F"]==%02"X16_F" != reply_msg->chaddr[%"U16_F"]==%02"X16_F"\n", + (u16_t)i, (u16_t)netif->hwaddr[i], (u16_t)i, (u16_t)reply_msg->chaddr[i])); + goto free_pbuf_and_return; + } + } + /* match transaction ID against what we expected */ + if (ntohl(reply_msg->xid) != dhcp->xid) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("transaction id mismatch reply_msg->xid(%"X32_F")!=dhcp->xid(%"X32_F")\n",ntohl(reply_msg->xid),dhcp->xid)); + goto free_pbuf_and_return; + } + /* option fields could be unfold? */ + if (dhcp_parse_reply(dhcp, p) != ERR_OK) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("problem unfolding DHCP message - too short on memory?\n")); + goto free_pbuf_and_return; + } + + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("searching DHCP_OPTION_MESSAGE_TYPE\n")); + /* obtain pointer to DHCP message type */ + if (!dhcp_option_given(dhcp, DHCP_OPTION_IDX_MSG_TYPE)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("DHCP_OPTION_MESSAGE_TYPE option not found\n")); + goto free_pbuf_and_return; + } + + /* read DHCP message type */ + msg_type = (u8_t)dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_MSG_TYPE); + /* message type is DHCP ACK? */ + if (msg_type == DHCP_ACK) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("DHCP_ACK received\n")); + /* in requesting state? */ + if (dhcp->state == DHCP_STATE_REQUESTING) { + dhcp_handle_ack(netif); +#if DHCP_DOES_ARP_CHECK + /* check if the acknowledged lease address is already in use */ + dhcp_check(netif); +#else + /* bind interface to the acknowledged lease address */ + dhcp_bind(netif); +#endif + } + /* already bound to the given lease address? */ + else if ((dhcp->state == DHCP_STATE_REBOOTING) || (dhcp->state == DHCP_STATE_REBINDING) || + (dhcp->state == DHCP_STATE_RENEWING)) { + dhcp_bind(netif); + } + } + /* received a DHCP_NAK in appropriate state? */ + else if ((msg_type == DHCP_NAK) && + ((dhcp->state == DHCP_STATE_REBOOTING) || (dhcp->state == DHCP_STATE_REQUESTING) || + (dhcp->state == DHCP_STATE_REBINDING) || (dhcp->state == DHCP_STATE_RENEWING ))) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("DHCP_NAK received\n")); + dhcp_handle_nak(netif); + } + /* received a DHCP_OFFER in DHCP_STATE_SELECTING state? */ + else if ((msg_type == DHCP_OFFER) && (dhcp->state == DHCP_STATE_SELECTING)) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("DHCP_OFFER received in DHCP_STATE_SELECTING state\n")); + dhcp->request_timeout = 0; + /* remember offered lease */ + dhcp_handle_offer(netif); + } +free_pbuf_and_return: + dhcp->msg_in = NULL; + pbuf_free(p); +} + +/** + * Create a DHCP request, fill in common headers + * + * @param netif the netif under DHCP control + * @param dhcp dhcp control struct + * @param message_type message type of the request + */ +static err_t +dhcp_create_msg(struct netif *netif, struct dhcp *dhcp, u8_t message_type) +{ + u16_t i; +#ifndef DHCP_GLOBAL_XID + /** default global transaction identifier starting value (easy to match + * with a packet analyser). We simply increment for each new request. + * Predefine DHCP_GLOBAL_XID to a better value or a function call to generate one + * at runtime, any supporting function prototypes can be defined in DHCP_GLOBAL_XID_HEADER */ +#if DHCP_CREATE_RAND_XID && defined(LWIP_RAND) + static u32_t xid; +#else /* DHCP_CREATE_RAND_XID && defined(LWIP_RAND) */ + static u32_t xid = 0xABCD0000; +#endif /* DHCP_CREATE_RAND_XID && defined(LWIP_RAND) */ +#else + if (!xid_initialised) { + xid = DHCP_GLOBAL_XID; + xid_initialised = !xid_initialised; + } +#endif + LWIP_ERROR("dhcp_create_msg: netif != NULL", (netif != NULL), return ERR_ARG;); + LWIP_ERROR("dhcp_create_msg: dhcp != NULL", (dhcp != NULL), return ERR_VAL;); + LWIP_ASSERT("dhcp_create_msg: dhcp->p_out == NULL", dhcp->p_out == NULL); + LWIP_ASSERT("dhcp_create_msg: dhcp->msg_out == NULL", dhcp->msg_out == NULL); + dhcp->p_out = pbuf_alloc(PBUF_TRANSPORT, sizeof(struct dhcp_msg), PBUF_RAM); + if (dhcp->p_out == NULL) { + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("dhcp_create_msg(): could not allocate pbuf\n")); + return ERR_MEM; + } + LWIP_ASSERT("dhcp_create_msg: check that first pbuf can hold struct dhcp_msg", + (dhcp->p_out->len >= sizeof(struct dhcp_msg))); + + /* DHCP_REQUEST should reuse 'xid' from DHCPOFFER */ + if (message_type != DHCP_REQUEST) { + /* reuse transaction identifier in retransmissions */ + if (dhcp->tries == 0) { +#if DHCP_CREATE_RAND_XID && defined(LWIP_RAND) + xid = LWIP_RAND(); +#else /* DHCP_CREATE_RAND_XID && defined(LWIP_RAND) */ + xid++; +#endif /* DHCP_CREATE_RAND_XID && defined(LWIP_RAND) */ + } + dhcp->xid = xid; + } + LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, + ("transaction id xid(%"X32_F")\n", xid)); + + dhcp->msg_out = (struct dhcp_msg *)dhcp->p_out->payload; + + dhcp->msg_out->op = DHCP_BOOTREQUEST; + /* TODO: make link layer independent */ + dhcp->msg_out->htype = DHCP_HTYPE_ETH; + dhcp->msg_out->hlen = netif->hwaddr_len; + dhcp->msg_out->hops = 0; + dhcp->msg_out->xid = htonl(dhcp->xid); + dhcp->msg_out->secs = 0; + /* we don't need the broadcast flag since we can receive unicast traffic + before being fully configured! */ + dhcp->msg_out->flags = 0; + ip4_addr_set_zero(&dhcp->msg_out->ciaddr); + /* set ciaddr to netif->ip_addr based on message_type and state */ + if ((message_type == DHCP_INFORM) || (message_type == DHCP_DECLINE) || (message_type == DHCP_RELEASE) || + ((message_type == DHCP_REQUEST) && /* DHCP_STATE_BOUND not used for sending! */ + ((dhcp->state== DHCP_STATE_RENEWING) || dhcp->state== DHCP_STATE_REBINDING))) { + ip4_addr_copy(dhcp->msg_out->ciaddr, *netif_ip4_addr(netif)); + } + ip4_addr_set_zero(&dhcp->msg_out->yiaddr); + ip4_addr_set_zero(&dhcp->msg_out->siaddr); + ip4_addr_set_zero(&dhcp->msg_out->giaddr); + for (i = 0; i < DHCP_CHADDR_LEN; i++) { + /* copy netif hardware address, pad with zeroes */ + dhcp->msg_out->chaddr[i] = (i < netif->hwaddr_len && i < NETIF_MAX_HWADDR_LEN) ? netif->hwaddr[i] : 0/* pad byte*/; + } + for (i = 0; i < DHCP_SNAME_LEN; i++) { + dhcp->msg_out->sname[i] = 0; + } + for (i = 0; i < DHCP_FILE_LEN; i++) { + dhcp->msg_out->file[i] = 0; + } + dhcp->msg_out->cookie = PP_HTONL(DHCP_MAGIC_COOKIE); + dhcp->options_out_len = 0; + /* fill options field with an incrementing array (for debugging purposes) */ + for (i = 0; i < DHCP_OPTIONS_LEN; i++) { + dhcp->msg_out->options[i] = (u8_t)i; /* for debugging only, no matter if truncated */ + } + /* Add option MESSAGE_TYPE */ + dhcp_option(dhcp, DHCP_OPTION_MESSAGE_TYPE, DHCP_OPTION_MESSAGE_TYPE_LEN); + dhcp_option_byte(dhcp, message_type); + return ERR_OK; +} + +/** + * Free previously allocated memory used to send a DHCP request. + * + * @param dhcp the dhcp struct to free the request from + */ +static void +dhcp_delete_msg(struct dhcp *dhcp) +{ + LWIP_ERROR("dhcp_delete_msg: dhcp != NULL", (dhcp != NULL), return;); + LWIP_ASSERT("dhcp_delete_msg: dhcp->p_out != NULL", dhcp->p_out != NULL); + LWIP_ASSERT("dhcp_delete_msg: dhcp->msg_out != NULL", dhcp->msg_out != NULL); + if (dhcp->p_out != NULL) { + pbuf_free(dhcp->p_out); + } + dhcp->p_out = NULL; + dhcp->msg_out = NULL; +} + +/** + * Add a DHCP message trailer + * + * Adds the END option to the DHCP message, and if + * necessary, up to three padding bytes. + * + * @param dhcp DHCP state structure + */ +static void +dhcp_option_trailer(struct dhcp *dhcp) +{ + LWIP_ERROR("dhcp_option_trailer: dhcp != NULL", (dhcp != NULL), return;); + LWIP_ASSERT("dhcp_option_trailer: dhcp->msg_out != NULL\n", dhcp->msg_out != NULL); + LWIP_ASSERT("dhcp_option_trailer: dhcp->options_out_len < DHCP_OPTIONS_LEN\n", dhcp->options_out_len < DHCP_OPTIONS_LEN); + dhcp->msg_out->options[dhcp->options_out_len++] = DHCP_OPTION_END; + /* packet is too small, or not 4 byte aligned? */ + while (((dhcp->options_out_len < DHCP_MIN_OPTIONS_LEN) || (dhcp->options_out_len & 3)) && + (dhcp->options_out_len < DHCP_OPTIONS_LEN)) { + /* add a fill/padding byte */ + dhcp->msg_out->options[dhcp->options_out_len++] = 0; + } +} + +/** check if DHCP supplied netif->ip_addr + * + * @param netif the netif to check + * @return 1 if DHCP supplied netif->ip_addr (states BOUND or RENEWING), + * 0 otherwise + */ +u8_t +dhcp_supplied_address(struct netif *netif) +{ + if ((netif != NULL) && (netif->dhcp != NULL)) { + if ((netif->dhcp->state == DHCP_STATE_BOUND) || + (netif->dhcp->state == DHCP_STATE_RENEWING)) { + return 1; + } + } + return 0; +} + +#endif /* LWIP_IPV4 && LWIP_DHCP */ diff --git a/components/lwip/core/ipv4/icmp.c b/components/lwip/core/ipv4/icmp.c new file mode 100755 index 000000000..c492ed75f --- /dev/null +++ b/components/lwip/core/ipv4/icmp.c @@ -0,0 +1,391 @@ +/** + * @file + * ICMP - Internet Control Message Protocol + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +/* Some ICMP messages should be passed to the transport protocols. This + is not implemented. */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 && LWIP_ICMP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/icmp.h" +#include "lwip/inet_chksum.h" +#include "lwip/ip.h" +#include "lwip/def.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** Small optimization: set to 0 if incoming PBUF_POOL pbuf always can be + * used to modify and send a response packet (and to 1 if this is not the case, + * e.g. when link header is stripped of when receiving) */ +#ifndef LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN +#define LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN 1 +#endif /* LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN */ + +/* The amount of data from the original packet to return in a dest-unreachable */ +#define ICMP_DEST_UNREACH_DATASIZE 8 + +static void icmp_send_response(struct pbuf *p, u8_t type, u8_t code); + +/** + * Processes ICMP input packets, called from ip_input(). + * + * Currently only processes icmp echo requests and sends + * out the echo response. + * + * @param p the icmp echo request packet, p->payload pointing to the icmp header + * @param inp the netif on which this packet was received + */ +void +icmp_input(struct pbuf *p, struct netif *inp) +{ + u8_t type; +#ifdef LWIP_DEBUG + u8_t code; +#endif /* LWIP_DEBUG */ + struct icmp_echo_hdr *iecho; + const struct ip_hdr *iphdr_in; + s16_t hlen; + const ip4_addr_t* src; + + ICMP_STATS_INC(icmp.recv); + MIB2_STATS_INC(mib2.icmpinmsgs); + + iphdr_in = ip4_current_header(); + hlen = IPH_HL(iphdr_in) * 4; + if (p->len < sizeof(u16_t)*2) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: short ICMP (%"U16_F" bytes) received\n", p->tot_len)); + goto lenerr; + } + + type = *((u8_t *)p->payload); +#ifdef LWIP_DEBUG + code = *(((u8_t *)p->payload)+1); +#endif /* LWIP_DEBUG */ + switch (type) { + case ICMP_ER: + /* This is OK, echo reply might have been parsed by a raw PCB + (as obviously, an echo request has been sent, too). */ + MIB2_STATS_INC(mib2.icmpinechoreps); + break; + case ICMP_ECHO: + MIB2_STATS_INC(mib2.icmpinechos); + src = ip4_current_dest_addr(); + /* multicast destination address? */ + if (ip4_addr_ismulticast(ip4_current_dest_addr())) { +#if LWIP_MULTICAST_PING + /* For multicast, use address of receiving interface as source address */ + src = netif_ip4_addr(inp); +#else /* LWIP_MULTICAST_PING */ + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: Not echoing to multicast pings\n")); + goto icmperr; +#endif /* LWIP_MULTICAST_PING */ + } + /* broadcast destination address? */ + if (ip4_addr_isbroadcast(ip4_current_dest_addr(), ip_current_netif())) { +#if LWIP_BROADCAST_PING + /* For broadcast, use address of receiving interface as source address */ + src = netif_ip4_addr(inp); +#else /* LWIP_BROADCAST_PING */ + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: Not echoing to broadcast pings\n")); + goto icmperr; +#endif /* LWIP_BROADCAST_PING */ + } + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: ping\n")); + if (p->tot_len < sizeof(struct icmp_echo_hdr)) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: bad ICMP echo received\n")); + goto lenerr; + } +#if CHECKSUM_CHECK_ICMP + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_CHECK_ICMP) { + if (inet_chksum_pbuf(p) != 0) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: checksum failed for received ICMP echo\n")); + pbuf_free(p); + ICMP_STATS_INC(icmp.chkerr); + MIB2_STATS_INC(mib2.icmpinerrors); + return; + } + } +#endif +#if LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN + if (pbuf_header(p, (PBUF_IP_HLEN + PBUF_LINK_HLEN + PBUF_LINK_ENCAPSULATION_HLEN))) { + /* p is not big enough to contain link headers + * allocate a new one and copy p into it + */ + struct pbuf *r; + /* allocate new packet buffer with space for link headers */ + r = pbuf_alloc(PBUF_LINK, p->tot_len + hlen, PBUF_RAM); + if (r == NULL) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: allocating new pbuf failed\n")); + goto icmperr; + } + LWIP_ASSERT("check that first pbuf can hold struct the ICMP header", + (r->len >= hlen + sizeof(struct icmp_echo_hdr))); + /* copy the ip header */ + MEMCPY(r->payload, iphdr_in, hlen); + /* switch r->payload back to icmp header */ + if (pbuf_header(r, -hlen)) { + LWIP_ASSERT("icmp_input: moving r->payload to icmp header failed\n", 0); + pbuf_free(r); + goto icmperr; + } + /* copy the rest of the packet without ip header */ + if (pbuf_copy(r, p) != ERR_OK) { + LWIP_ASSERT("icmp_input: copying to new pbuf failed\n", 0); + pbuf_free(r); + goto icmperr; + } + /* free the original p */ + pbuf_free(p); + /* we now have an identical copy of p that has room for link headers */ + p = r; + } else { + /* restore p->payload to point to icmp header */ + if (pbuf_header(p, -(s16_t)(PBUF_IP_HLEN + PBUF_LINK_HLEN + PBUF_LINK_ENCAPSULATION_HLEN))) { + LWIP_ASSERT("icmp_input: restoring original p->payload failed\n", 0); + goto icmperr; + } + } +#endif /* LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN */ + /* At this point, all checks are OK. */ + /* We generate an answer by switching the dest and src ip addresses, + * setting the icmp type to ECHO_RESPONSE and updating the checksum. */ + iecho = (struct icmp_echo_hdr *)p->payload; + if (pbuf_header(p, hlen)) { + LWIP_ASSERT("Can't move over header in packet", 0); + } else { + err_t ret; + struct ip_hdr *iphdr = (struct ip_hdr*)p->payload; + ip4_addr_copy(iphdr->src, *src); + ip4_addr_copy(iphdr->dest, *ip4_current_src_addr()); + ICMPH_TYPE_SET(iecho, ICMP_ER); +#if CHECKSUM_GEN_ICMP + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_GEN_ICMP) { + /* adjust the checksum */ + if (iecho->chksum > PP_HTONS(0xffffU - (ICMP_ECHO << 8))) { + iecho->chksum += PP_HTONS(ICMP_ECHO << 8) + 1; + } else { + iecho->chksum += PP_HTONS(ICMP_ECHO << 8); + } + } +#if LWIP_CHECKSUM_CTRL_PER_NETIF + else { + iecho->chksum = 0; + } +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF */ +#else /* CHECKSUM_GEN_ICMP */ + iecho->chksum = 0; +#endif /* CHECKSUM_GEN_ICMP */ + + /* Set the correct TTL and recalculate the header checksum. */ + IPH_TTL_SET(iphdr, ICMP_TTL); + IPH_CHKSUM_SET(iphdr, 0); +#if CHECKSUM_GEN_IP + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_GEN_IP) { + IPH_CHKSUM_SET(iphdr, inet_chksum(iphdr, IP_HLEN)); + } +#endif /* CHECKSUM_GEN_IP */ + + ICMP_STATS_INC(icmp.xmit); + /* increase number of messages attempted to send */ + MIB2_STATS_INC(mib2.icmpoutmsgs); + /* increase number of echo replies attempted to send */ + MIB2_STATS_INC(mib2.icmpoutechoreps); + + /* send an ICMP packet */ + ret = ip4_output_if(p, src, IP_HDRINCL, + ICMP_TTL, 0, IP_PROTO_ICMP, inp); + if (ret != ERR_OK) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: ip_output_if returned an error: %s\n", lwip_strerr(ret))); + } + } + break; + default: + if (type == ICMP_DUR) { + MIB2_STATS_INC(mib2.icmpindestunreachs); + } else if (type == ICMP_TE) { + MIB2_STATS_INC(mib2.icmpindestunreachs); + } else if (type == ICMP_PP) { + MIB2_STATS_INC(mib2.icmpinparmprobs); + } else if (type == ICMP_SQ) { + MIB2_STATS_INC(mib2.icmpinsrcquenchs); + } else if (type == ICMP_RD) { + MIB2_STATS_INC(mib2.icmpinredirects); + } else if (type == ICMP_TS) { + MIB2_STATS_INC(mib2.icmpintimestamps); + } else if (type == ICMP_TSR) { + MIB2_STATS_INC(mib2.icmpintimestampreps); + } else if (type == ICMP_AM) { + MIB2_STATS_INC(mib2.icmpinaddrmasks); + } else if (type == ICMP_AMR) { + MIB2_STATS_INC(mib2.icmpinaddrmaskreps); + } + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: ICMP type %"S16_F" code %"S16_F" not supported.\n", + (s16_t)type, (s16_t)code)); + ICMP_STATS_INC(icmp.proterr); + ICMP_STATS_INC(icmp.drop); + } + pbuf_free(p); + return; +lenerr: + pbuf_free(p); + ICMP_STATS_INC(icmp.lenerr); + MIB2_STATS_INC(mib2.icmpinerrors); + return; +#if LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN || !LWIP_MULTICAST_PING || !LWIP_BROADCAST_PING +icmperr: + pbuf_free(p); + ICMP_STATS_INC(icmp.err); + MIB2_STATS_INC(mib2.icmpinerrors); + return; +#endif /* LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN || !LWIP_MULTICAST_PING || !LWIP_BROADCAST_PING */ +} + +/** + * Send an icmp 'destination unreachable' packet, called from ip_input() if + * the transport layer protocol is unknown and from udp_input() if the local + * port is not bound. + * + * @param p the input packet for which the 'unreachable' should be sent, + * p->payload pointing to the IP header + * @param t type of the 'unreachable' packet + */ +void +icmp_dest_unreach(struct pbuf *p, enum icmp_dur_type t) +{ + MIB2_STATS_INC(mib2.icmpoutdestunreachs); + icmp_send_response(p, ICMP_DUR, t); +} + +#if IP_FORWARD || IP_REASSEMBLY +/** + * Send a 'time exceeded' packet, called from ip_forward() if TTL is 0. + * + * @param p the input packet for which the 'time exceeded' should be sent, + * p->payload pointing to the IP header + * @param t type of the 'time exceeded' packet + */ +void +icmp_time_exceeded(struct pbuf *p, enum icmp_te_type t) +{ + MIB2_STATS_INC(mib2.icmpouttimeexcds); + icmp_send_response(p, ICMP_TE, t); +} + +#endif /* IP_FORWARD || IP_REASSEMBLY */ + +/** + * Send an icmp packet in response to an incoming packet. + * + * @param p the input packet for which the 'unreachable' should be sent, + * p->payload pointing to the IP header + * @param type Type of the ICMP header + * @param code Code of the ICMP header + */ +static void +icmp_send_response(struct pbuf *p, u8_t type, u8_t code) +{ + struct pbuf *q; + struct ip_hdr *iphdr; + /* we can use the echo header here */ + struct icmp_echo_hdr *icmphdr; + ip4_addr_t iphdr_src; + struct netif *netif; + + /* increase number of messages attempted to send */ + MIB2_STATS_INC(mib2.icmpoutmsgs); + + /* ICMP header + IP header + 8 bytes of data */ + q = pbuf_alloc(PBUF_IP, sizeof(struct icmp_echo_hdr) + IP_HLEN + ICMP_DEST_UNREACH_DATASIZE, + PBUF_RAM); + if (q == NULL) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_time_exceeded: failed to allocate pbuf for ICMP packet.\n")); + MIB2_STATS_INC(mib2.icmpouterrors); + return; + } + LWIP_ASSERT("check that first pbuf can hold icmp message", + (q->len >= (sizeof(struct icmp_echo_hdr) + IP_HLEN + ICMP_DEST_UNREACH_DATASIZE))); + + iphdr = (struct ip_hdr *)p->payload; + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_time_exceeded from ")); + ip4_addr_debug_print_val(ICMP_DEBUG, iphdr->src); + LWIP_DEBUGF(ICMP_DEBUG, (" to ")); + ip4_addr_debug_print_val(ICMP_DEBUG, iphdr->dest); + LWIP_DEBUGF(ICMP_DEBUG, ("\n")); + + icmphdr = (struct icmp_echo_hdr *)q->payload; + icmphdr->type = type; + icmphdr->code = code; + icmphdr->id = 0; + icmphdr->seqno = 0; + + /* copy fields from original packet */ + SMEMCPY((u8_t *)q->payload + sizeof(struct icmp_echo_hdr), (u8_t *)p->payload, + IP_HLEN + ICMP_DEST_UNREACH_DATASIZE); + + ip4_addr_copy(iphdr_src, iphdr->src); +#ifdef LWIP_HOOK_IP4_ROUTE_SRC + { + ip4_addr_t iphdr_dst; + ip4_addr_copy(iphdr_dst, iphdr->dest); + netif = ip4_route_src(&iphdr_src, &iphdr_dst); + } +#else + netif = ip4_route(&iphdr_src); +#endif + if (netif != NULL) { + /* calculate checksum */ + icmphdr->chksum = 0; +#if CHECKSUM_GEN_ICMP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP) { + icmphdr->chksum = inet_chksum(icmphdr, q->len); + } +#endif + ICMP_STATS_INC(icmp.xmit); + ip4_output_if(q, NULL, &iphdr_src, ICMP_TTL, 0, IP_PROTO_ICMP, netif); + } + pbuf_free(q); +} + +#endif /* LWIP_IPV4 && LWIP_ICMP */ diff --git a/components/lwip/core/ipv4/igmp.c b/components/lwip/core/ipv4/igmp.c new file mode 100755 index 000000000..d75fe15fd --- /dev/null +++ b/components/lwip/core/ipv4/igmp.c @@ -0,0 +1,832 @@ +/** + * @file + * IGMP - Internet Group Management Protocol + * + */ + +/* + * Copyright (c) 2002 CITEL Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of CITEL Technologies Ltd nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY CITEL TECHNOLOGIES AND CONTRIBUTORS ``AS IS'' + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL CITEL TECHNOLOGIES OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is a contribution to the lwIP TCP/IP stack. + * The Swedish Institute of Computer Science and Adam Dunkels + * are specifically granted permission to redistribute this + * source code. +*/ + +/*------------------------------------------------------------- +Note 1) +Although the rfc requires V1 AND V2 capability +we will only support v2 since now V1 is very old (August 1989) +V1 can be added if required + +a debug print and statistic have been implemented to +show this up. +------------------------------------------------------------- +------------------------------------------------------------- +Note 2) +A query for a specific group address (as opposed to ALLHOSTS) +has now been implemented as I am unsure if it is required + +a debug print and statistic have been implemented to +show this up. +------------------------------------------------------------- +------------------------------------------------------------- +Note 3) +The router alert rfc 2113 is implemented in outgoing packets +but not checked rigorously incoming +------------------------------------------------------------- +Steve Reynolds +------------------------------------------------------------*/ + +/*----------------------------------------------------------------------------- + * RFC 988 - Host extensions for IP multicasting - V0 + * RFC 1054 - Host extensions for IP multicasting - + * RFC 1112 - Host extensions for IP multicasting - V1 + * RFC 2236 - Internet Group Management Protocol, Version 2 - V2 <- this code is based on this RFC (it's the "de facto" standard) + * RFC 3376 - Internet Group Management Protocol, Version 3 - V3 + * RFC 4604 - Using Internet Group Management Protocol Version 3... - V3+ + * RFC 2113 - IP Router Alert Option - + *----------------------------------------------------------------------------*/ + +/*----------------------------------------------------------------------------- + * Includes + *----------------------------------------------------------------------------*/ + +#include "lwip/opt.h" + +#if LWIP_IPV4 && LWIP_IGMP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/igmp.h" +#include "lwip/debug.h" +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/ip.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/stats.h" + +#include "string.h" + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/* + * IGMP constants + */ +#define IGMP_TTL 1 +#define IGMP_MINLEN 8 +#define ROUTER_ALERT 0x9404U +#define ROUTER_ALERTLEN 4 + +/* + * IGMP message types, including version number. + */ +#define IGMP_MEMB_QUERY 0x11 /* Membership query */ +#define IGMP_V1_MEMB_REPORT 0x12 /* Ver. 1 membership report */ +#define IGMP_V2_MEMB_REPORT 0x16 /* Ver. 2 membership report */ +#define IGMP_LEAVE_GROUP 0x17 /* Leave-group message */ + +/* Group membership states */ +#define IGMP_GROUP_NON_MEMBER 0 +#define IGMP_GROUP_DELAYING_MEMBER 1 +#define IGMP_GROUP_IDLE_MEMBER 2 + +/** + * IGMP packet format. + */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct igmp_msg { + PACK_STRUCT_FLD_8(u8_t igmp_msgtype); + PACK_STRUCT_FLD_8(u8_t igmp_maxresp); + PACK_STRUCT_FIELD(u16_t igmp_checksum); + PACK_STRUCT_FLD_S(ip4_addr_p_t igmp_group_address); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + + +static struct igmp_group *igmp_lookup_group(struct netif *ifp, const ip4_addr_t *addr); +static err_t igmp_remove_group(struct igmp_group *group); +static void igmp_timeout( struct igmp_group *group); +static void igmp_start_timer(struct igmp_group *group, u8_t max_time); +static void igmp_delaying_member(struct igmp_group *group, u8_t maxresp); +static err_t igmp_ip_output_if(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, struct netif *netif); +static void igmp_send(struct igmp_group *group, u8_t type); + + +static struct igmp_group* igmp_group_list; +static ip4_addr_t allsystems; +static ip4_addr_t allrouters; + + +/** + * Initialize the IGMP module + */ +void +igmp_init(void) +{ + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_init: initializing\n")); + + IP4_ADDR(&allsystems, 224, 0, 0, 1); + IP4_ADDR(&allrouters, 224, 0, 0, 2); +} + +/** + * Start IGMP processing on interface + * + * @param netif network interface on which start IGMP processing + */ +err_t +igmp_start(struct netif *netif) +{ + struct igmp_group* group; + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_start: starting IGMP processing on if %p\n", (void*)netif)); + group = igmp_lookup_group(netif, &allsystems); + + if (group != NULL) { + group->group_state = IGMP_GROUP_IDLE_MEMBER; + group->use++; + + /* Allow the igmp messages at the MAC level */ + if (netif->igmp_mac_filter != NULL) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_start: igmp_mac_filter(ADD ")); + ip4_addr_debug_print_val(IGMP_DEBUG, allsystems); + LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", (void*)netif)); + netif->igmp_mac_filter(netif, &allsystems, IGMP_ADD_MAC_FILTER); + } + return ERR_OK; + } + return ERR_MEM; +} + +/** + * Stop IGMP processing on interface + * + * @param netif network interface on which stop IGMP processing + */ +err_t +igmp_stop(struct netif *netif) +{ + struct igmp_group *group = igmp_group_list; + struct igmp_group *prev = NULL; + struct igmp_group *next; + + /* look for groups joined on this interface further down the list */ + while (group != NULL) { + next = group->next; + /* is it a group joined on this interface? */ + if (group->netif == netif) { + /* is it the first group of the list? */ + if (group == igmp_group_list) { + igmp_group_list = next; + } + /* is there a "previous" group defined? */ + if (prev != NULL) { + prev->next = next; + } + /* disable the group at the MAC level */ + if (netif->igmp_mac_filter != NULL) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_stop: igmp_mac_filter(DEL ")); + ip4_addr_debug_print(IGMP_DEBUG, &group->group_address); + LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", (void*)netif)); + netif->igmp_mac_filter(netif, &(group->group_address), IGMP_DEL_MAC_FILTER); + } + /* free group */ + memp_free(MEMP_IGMP_GROUP, group); + } else { + /* change the "previous" */ + prev = group; + } + /* move to "next" */ + group = next; + } + return ERR_OK; +} + +/** + * Report IGMP memberships for this interface + * + * @param netif network interface on which report IGMP memberships + */ +void +igmp_report_groups(struct netif *netif) +{ + struct igmp_group *group = igmp_group_list; + + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_report_groups: sending IGMP reports on if %p\n", (void*)netif)); + + while (group != NULL) { + if ((group->netif == netif) && (!(ip4_addr_cmp(&(group->group_address), &allsystems)))) { + igmp_delaying_member(group, IGMP_JOIN_DELAYING_MEMBER_TMR); + } + group = group->next; + } +} + +/** + * Search for a group in the global igmp_group_list + * + * @param ifp the network interface for which to look + * @param addr the group ip address to search for + * @return a struct igmp_group* if the group has been found, + * NULL if the group wasn't found. + */ +struct igmp_group * +igmp_lookfor_group(struct netif *ifp, const ip4_addr_t *addr) +{ + struct igmp_group *group = igmp_group_list; + + while (group != NULL) { + if ((group->netif == ifp) && (ip4_addr_cmp(&(group->group_address), addr))) { + return group; + } + group = group->next; + } + + /* to be clearer, we return NULL here instead of + * 'group' (which is also NULL at this point). + */ + return NULL; +} + +/** + * Search for a specific igmp group and create a new one if not found- + * + * @param ifp the network interface for which to look + * @param addr the group ip address to search + * @return a struct igmp_group*, + * NULL on memory error. + */ +struct igmp_group * +igmp_lookup_group(struct netif *ifp, const ip4_addr_t *addr) +{ + struct igmp_group *group; + /* Search if the group already exists */ + group = igmp_lookfor_group(ifp, addr); + + if (group != NULL) { + /* Group already exists. */ + return group; + } + + /* Group doesn't exist yet, create a new one */ + group = (struct igmp_group *)memp_malloc(MEMP_IGMP_GROUP); + if (group != NULL) { + group->netif = ifp; + ip4_addr_set(&(group->group_address), addr); + group->timer = 0; /* Not running */ + group->group_state = IGMP_GROUP_NON_MEMBER; + group->last_reporter_flag = 0; + group->use = 0; + group->next = igmp_group_list; + + igmp_group_list = group; + } + + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_lookup_group: %sallocated a new group with address ", (group?"":"impossible to "))); + ip4_addr_debug_print(IGMP_DEBUG, addr); + LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", (void*)ifp)); + + return group; +} + +/** + * Remove a group in the global igmp_group_list + * + * @param group the group to remove from the global igmp_group_list + * @return ERR_OK if group was removed from the list, an err_t otherwise + */ +static err_t +igmp_remove_group(struct igmp_group *group) +{ + err_t err = ERR_OK; + + /* Is it the first group? */ + if (igmp_group_list == group) { + igmp_group_list = group->next; + } else { + /* look for group further down the list */ + struct igmp_group *tmpGroup; + for (tmpGroup = igmp_group_list; tmpGroup != NULL; tmpGroup = tmpGroup->next) { + if (tmpGroup->next == group) { + tmpGroup->next = group->next; + break; + } + } + /* Group not found in the global igmp_group_list */ + if (tmpGroup == NULL) { + err = ERR_ARG; + } + } + /* free group */ + memp_free(MEMP_IGMP_GROUP, group); + + return err; +} + +/** + * Called from ip_input() if a new IGMP packet is received. + * + * @param p received igmp packet, p->payload pointing to the igmp header + * @param inp network interface on which the packet was received + * @param dest destination ip address of the igmp packet + */ +void +igmp_input(struct pbuf *p, struct netif *inp, const ip4_addr_t *dest) +{ + struct igmp_msg* igmp; + struct igmp_group* group; + struct igmp_group* groupref; + + IGMP_STATS_INC(igmp.recv); + + /* Note that the length CAN be greater than 8 but only 8 are used - All are included in the checksum */ + if (p->len < IGMP_MINLEN) { + pbuf_free(p); + IGMP_STATS_INC(igmp.lenerr); + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: length error\n")); + return; + } + + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: message from ")); + ip4_addr_debug_print(IGMP_DEBUG, &(ip4_current_header()->src)); + LWIP_DEBUGF(IGMP_DEBUG, (" to address ")); + ip4_addr_debug_print(IGMP_DEBUG, &(ip4_current_header()->dest)); + LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", (void*)inp)); + + /* Now calculate and check the checksum */ + igmp = (struct igmp_msg *)p->payload; + if (inet_chksum(igmp, p->len)) { + pbuf_free(p); + IGMP_STATS_INC(igmp.chkerr); + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: checksum error\n")); + return; + } + + /* Packet is ok so find an existing group */ + group = igmp_lookfor_group(inp, dest); /* use the destination IP address of incoming packet */ + + /* If group can be found or create... */ + if (!group) { + pbuf_free(p); + IGMP_STATS_INC(igmp.drop); + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: IGMP frame not for us\n")); + return; + } + + /* NOW ACT ON THE INCOMING MESSAGE TYPE... */ + switch (igmp->igmp_msgtype) { + case IGMP_MEMB_QUERY: + /* IGMP_MEMB_QUERY to the "all systems" address ? */ + if ((ip4_addr_cmp(dest, &allsystems)) && ip4_addr_isany(&igmp->igmp_group_address)) { + /* THIS IS THE GENERAL QUERY */ + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: General IGMP_MEMB_QUERY on \"ALL SYSTEMS\" address (224.0.0.1) [igmp_maxresp=%i]\n", (int)(igmp->igmp_maxresp))); + + if (igmp->igmp_maxresp == 0) { + IGMP_STATS_INC(igmp.rx_v1); + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: got an all hosts query with time== 0 - this is V1 and not implemented - treat as v2\n")); + igmp->igmp_maxresp = IGMP_V1_DELAYING_MEMBER_TMR; + } else { + IGMP_STATS_INC(igmp.rx_general); + } + + groupref = igmp_group_list; + while (groupref) { + /* Do not send messages on the all systems group address! */ + if ((groupref->netif == inp) && (!(ip4_addr_cmp(&(groupref->group_address), &allsystems)))) { + igmp_delaying_member(groupref, igmp->igmp_maxresp); + } + groupref = groupref->next; + } + } else { + /* IGMP_MEMB_QUERY to a specific group ? */ + if (!ip4_addr_isany(&igmp->igmp_group_address)) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: IGMP_MEMB_QUERY to a specific group ")); + ip4_addr_debug_print(IGMP_DEBUG, &igmp->igmp_group_address); + if (ip4_addr_cmp(dest, &allsystems)) { + ip4_addr_t groupaddr; + LWIP_DEBUGF(IGMP_DEBUG, (" using \"ALL SYSTEMS\" address (224.0.0.1) [igmp_maxresp=%i]\n", (int)(igmp->igmp_maxresp))); + /* we first need to re-look for the group since we used dest last time */ + ip4_addr_copy(groupaddr, igmp->igmp_group_address); + group = igmp_lookfor_group(inp, &groupaddr); + } else { + LWIP_DEBUGF(IGMP_DEBUG, (" with the group address as destination [igmp_maxresp=%i]\n", (int)(igmp->igmp_maxresp))); + } + + if (group != NULL) { + IGMP_STATS_INC(igmp.rx_group); + igmp_delaying_member(group, igmp->igmp_maxresp); + } else { + IGMP_STATS_INC(igmp.drop); + } + } else { + IGMP_STATS_INC(igmp.proterr); + } + } + break; + case IGMP_V2_MEMB_REPORT: + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: IGMP_V2_MEMB_REPORT\n")); + IGMP_STATS_INC(igmp.rx_report); + if (group->group_state == IGMP_GROUP_DELAYING_MEMBER) { + /* This is on a specific group we have already looked up */ + group->timer = 0; /* stopped */ + group->group_state = IGMP_GROUP_IDLE_MEMBER; + group->last_reporter_flag = 0; + } + break; + default: + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: unexpected msg %d in state %d on group %p on if %p\n", + igmp->igmp_msgtype, group->group_state, (void*)&group, (void*)group->netif)); + IGMP_STATS_INC(igmp.proterr); + break; + } + + pbuf_free(p); + return; +} + +/** + * Join a group on one network interface. + * + * @param ifaddr ip address of the network interface which should join a new group + * @param groupaddr the ip address of the group which to join + * @return ERR_OK if group was joined on the netif(s), an err_t otherwise + */ +err_t +igmp_joingroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr) +{ + err_t err = ERR_VAL; /* no matching interface */ + struct netif *netif; + + /* make sure it is multicast address */ + LWIP_ERROR("igmp_joingroup: attempt to join non-multicast address", ip4_addr_ismulticast(groupaddr), return ERR_VAL;); + LWIP_ERROR("igmp_joingroup: attempt to join allsystems address", (!ip4_addr_cmp(groupaddr, &allsystems)), return ERR_VAL;); + + /* loop through netif's */ + netif = netif_list; + while (netif != NULL) { + /* Should we join this interface ? */ + if ((netif->flags & NETIF_FLAG_IGMP) && ((ip4_addr_isany(ifaddr) || ip4_addr_cmp(netif_ip4_addr(netif), ifaddr)))) { + err = igmp_joingroup_netif(netif, groupaddr); + if (err != ERR_OK) { + /* Return an error even if some network interfaces are joined */ + /** @todo undo any other netif already joined */ + return err; + } + } + /* proceed to next network interface */ + netif = netif->next; + } + + return err; +} + +/** + * Join a group on one network interface. + * + * @param netif the network interface which should join a new group + * @param groupaddr the ip address of the group which to join + * @return ERR_OK if group was joined on the netif, an err_t otherwise + */ +err_t +igmp_joingroup_netif(struct netif *netif, const ip4_addr_t *groupaddr) +{ + struct igmp_group *group; + + /* make sure it is multicast address */ + LWIP_ERROR("igmp_joingroup_netif: attempt to join non-multicast address", ip4_addr_ismulticast(groupaddr), return ERR_VAL;); + LWIP_ERROR("igmp_joingroup_netif: attempt to join allsystems address", (!ip4_addr_cmp(groupaddr, &allsystems)), return ERR_VAL;); + + /* make sure it is an igmp-enabled netif */ + LWIP_ERROR("igmp_joingroup_netif: attempt to join on non-IGMP netif", netif->flags & NETIF_FLAG_IGMP, return ERR_VAL;); + + /* find group or create a new one if not found */ + group = igmp_lookup_group(netif, groupaddr); + + if (group != NULL) { + /* This should create a new group, check the state to make sure */ + if (group->group_state != IGMP_GROUP_NON_MEMBER) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup_netif: join to group not in state IGMP_GROUP_NON_MEMBER\n")); + } else { + /* OK - it was new group */ + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup_netif: join to new group: ")); + ip4_addr_debug_print(IGMP_DEBUG, groupaddr); + LWIP_DEBUGF(IGMP_DEBUG, ("\n")); + + /* If first use of the group, allow the group at the MAC level */ + if ((group->use==0) && (netif->igmp_mac_filter != NULL)) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup_netif: igmp_mac_filter(ADD ")); + ip4_addr_debug_print(IGMP_DEBUG, groupaddr); + LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", (void*)netif)); + netif->igmp_mac_filter(netif, groupaddr, IGMP_ADD_MAC_FILTER); + } + + IGMP_STATS_INC(igmp.tx_join); + igmp_send(group, IGMP_V2_MEMB_REPORT); + + igmp_start_timer(group, IGMP_JOIN_DELAYING_MEMBER_TMR); + + /* Need to work out where this timer comes from */ + group->group_state = IGMP_GROUP_DELAYING_MEMBER; + } + /* Increment group use */ + group->use++; + /* Join on this interface */ + return ERR_OK; + } else { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup_netif: Not enough memory to join to group\n")); + return ERR_MEM; + } +} + +/** + * Leave a group on one network interface. + * + * @param ifaddr ip address of the network interface which should leave a group + * @param groupaddr the ip address of the group which to leave + * @return ERR_OK if group was left on the netif(s), an err_t otherwise + */ +err_t +igmp_leavegroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr) +{ + err_t err = ERR_VAL; /* no matching interface */ + struct netif *netif; + + /* make sure it is multicast address */ + LWIP_ERROR("igmp_leavegroup: attempt to leave non-multicast address", ip4_addr_ismulticast(groupaddr), return ERR_VAL;); + LWIP_ERROR("igmp_leavegroup: attempt to leave allsystems address", (!ip4_addr_cmp(groupaddr, &allsystems)), return ERR_VAL;); + + /* loop through netif's */ + netif = netif_list; + while (netif != NULL) { + /* Should we leave this interface ? */ + if ((netif->flags & NETIF_FLAG_IGMP) && ((ip4_addr_isany(ifaddr) || ip4_addr_cmp(netif_ip4_addr(netif), ifaddr)))) { + err_t res = igmp_leavegroup_netif(netif, groupaddr); + if (err != ERR_OK) { + /* Store this result if we have not yet gotten a success */ + err = res; + } + } + /* proceed to next network interface */ + netif = netif->next; + } + + return err; +} + +/** + * Leave a group on one network interface. + * + * @param netif the network interface which should leave a group + * @param groupaddr the ip address of the group which to leave + * @return ERR_OK if group was left on the netif, an err_t otherwise + */ +err_t +igmp_leavegroup_netif(struct netif *netif, const ip4_addr_t *groupaddr) +{ + struct igmp_group *group; + + /* make sure it is multicast address */ + LWIP_ERROR("igmp_leavegroup_netif: attempt to leave non-multicast address", ip4_addr_ismulticast(groupaddr), return ERR_VAL;); + LWIP_ERROR("igmp_leavegroup_netif: attempt to leave allsystems address", (!ip4_addr_cmp(groupaddr, &allsystems)), return ERR_VAL;); + + /* make sure it is an igmp-enabled netif */ + LWIP_ERROR("igmp_leavegroup_netif: attempt to leave on non-IGMP netif", netif->flags & NETIF_FLAG_IGMP, return ERR_VAL;); + + /* find group */ + group = igmp_lookfor_group(netif, groupaddr); + + if (group != NULL) { + /* Only send a leave if the flag is set according to the state diagram */ + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup_netif: Leaving group: ")); + ip4_addr_debug_print(IGMP_DEBUG, groupaddr); + LWIP_DEBUGF(IGMP_DEBUG, ("\n")); + + /* If there is no other use of the group */ + if (group->use <= 1) { + /* If we are the last reporter for this group */ + if (group->last_reporter_flag) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup_netif: sending leaving group\n")); + IGMP_STATS_INC(igmp.tx_leave); + igmp_send(group, IGMP_LEAVE_GROUP); + } + + /* Disable the group at the MAC level */ + if (netif->igmp_mac_filter != NULL) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup_netif: igmp_mac_filter(DEL ")); + ip4_addr_debug_print(IGMP_DEBUG, groupaddr); + LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", (void*)netif)); + netif->igmp_mac_filter(netif, groupaddr, IGMP_DEL_MAC_FILTER); + } + + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup_netif: remove group: ")); + ip4_addr_debug_print(IGMP_DEBUG, groupaddr); + LWIP_DEBUGF(IGMP_DEBUG, ("\n")); + + /* Free the group */ + igmp_remove_group(group); + } else { + /* Decrement group use */ + group->use--; + } + return ERR_OK; + } else { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup_netif: not member of group\n")); + return ERR_VAL; + } +} + +/** + * The igmp timer function (both for NO_SYS=1 and =0) + * Should be called every IGMP_TMR_INTERVAL milliseconds (100 ms is default). + */ +void +igmp_tmr(void) +{ + struct igmp_group *group = igmp_group_list; + + while (group != NULL) { + if (group->timer > 0) { + group->timer--; + if (group->timer == 0) { + igmp_timeout(group); + } + } + group = group->next; + } +} + +/** + * Called if a timeout for one group is reached. + * Sends a report for this group. + * + * @param group an igmp_group for which a timeout is reached + */ +static void +igmp_timeout(struct igmp_group *group) +{ + /* If the state is IGMP_GROUP_DELAYING_MEMBER then we send a report for this group + (unless it is the allsystems group) */ + if ((group->group_state == IGMP_GROUP_DELAYING_MEMBER) && + (!(ip4_addr_cmp(&(group->group_address), &allsystems)))) { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_timeout: report membership for group with address ")); + ip4_addr_debug_print(IGMP_DEBUG, &(group->group_address)); + LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", (void*)group->netif)); + + IGMP_STATS_INC(igmp.tx_report); + igmp_send(group, IGMP_V2_MEMB_REPORT); + } +} + +/** + * Start a timer for an igmp group + * + * @param group the igmp_group for which to start a timer + * @param max_time the time in multiples of IGMP_TMR_INTERVAL (decrease with + * every call to igmp_tmr()) + */ +static void +igmp_start_timer(struct igmp_group *group, u8_t max_time) +{ +#ifdef LWIP_RAND + group->timer = max_time > 2 ? (LWIP_RAND() % max_time) : 1; +#else /* LWIP_RAND */ + /* ATTENTION: use this only if absolutely necessary! */ + group->timer = max_time / 2; +#endif /* LWIP_RAND */ + + if (group->timer == 0) { + group->timer = 1; + } +} + +/** + * Delaying membership report for a group if necessary + * + * @param group the igmp_group for which "delaying" membership report + * @param maxresp query delay + */ +static void +igmp_delaying_member(struct igmp_group *group, u8_t maxresp) +{ + if ((group->group_state == IGMP_GROUP_IDLE_MEMBER) || + ((group->group_state == IGMP_GROUP_DELAYING_MEMBER) && + ((group->timer == 0) || (maxresp < group->timer)))) { + igmp_start_timer(group, maxresp); + group->group_state = IGMP_GROUP_DELAYING_MEMBER; + } +} + + +/** + * Sends an IP packet on a network interface. This function constructs the IP header + * and calculates the IP header checksum. If the source IP address is NULL, + * the IP address of the outgoing network interface is filled in as source address. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an IP + header and p->payload points to that IP header) + * @param src the source IP address to send from (if src == IP_ADDR_ANY, the + * IP address of the netif used to send is used as source address) + * @param dest the destination IP address to send the packet to + * @param ttl the TTL value to be set in the IP header + * @param proto the PROTOCOL to be set in the IP header + * @param netif the netif on which to send this packet + * @return ERR_OK if the packet was sent OK + * ERR_BUF if p doesn't have enough space for IP/LINK headers + * returns errors returned by netif->output + */ +static err_t +igmp_ip_output_if(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, struct netif *netif) +{ + /* This is the "router alert" option */ + u16_t ra[2]; + ra[0] = PP_HTONS(ROUTER_ALERT); + ra[1] = 0x0000; /* Router shall examine packet */ + IGMP_STATS_INC(igmp.xmit); + return ip4_output_if_opt(p, src, dest, IGMP_TTL, 0, IP_PROTO_IGMP, netif, ra, ROUTER_ALERTLEN); +} + +/** + * Send an igmp packet to a specific group. + * + * @param group the group to which to send the packet + * @param type the type of igmp packet to send + */ +static void +igmp_send(struct igmp_group *group, u8_t type) +{ + struct pbuf* p = NULL; + struct igmp_msg* igmp = NULL; + ip4_addr_t src = *IP4_ADDR_ANY; + ip4_addr_t* dest = NULL; + + /* IP header + "router alert" option + IGMP header */ + p = pbuf_alloc(PBUF_TRANSPORT, IGMP_MINLEN, PBUF_RAM); + + if (p) { + igmp = (struct igmp_msg *)p->payload; + LWIP_ASSERT("igmp_send: check that first pbuf can hold struct igmp_msg", + (p->len >= sizeof(struct igmp_msg))); + ip4_addr_copy(src, *netif_ip4_addr(group->netif)); + + if (type == IGMP_V2_MEMB_REPORT) { + dest = &(group->group_address); + ip4_addr_copy(igmp->igmp_group_address, group->group_address); + group->last_reporter_flag = 1; /* Remember we were the last to report */ + } else { + if (type == IGMP_LEAVE_GROUP) { + dest = &allrouters; + ip4_addr_copy(igmp->igmp_group_address, group->group_address); + } + } + + if ((type == IGMP_V2_MEMB_REPORT) || (type == IGMP_LEAVE_GROUP)) { + igmp->igmp_msgtype = type; + igmp->igmp_maxresp = 0; + igmp->igmp_checksum = 0; + igmp->igmp_checksum = inet_chksum(igmp, IGMP_MINLEN); + + igmp_ip_output_if(p, &src, dest, group->netif); + } + + pbuf_free(p); + } else { + LWIP_DEBUGF(IGMP_DEBUG, ("igmp_send: not enough memory for igmp_send\n")); + IGMP_STATS_INC(igmp.memerr); + } +} + +#endif /* LWIP_IPV4 && LWIP_IGMP */ diff --git a/components/lwip/core/ipv4/ip4.c b/components/lwip/core/ipv4/ip4.c new file mode 100755 index 000000000..5f1e77a5e --- /dev/null +++ b/components/lwip/core/ipv4/ip4.c @@ -0,0 +1,1085 @@ +/** + * @file + * This is the IPv4 layer implementation for incoming and outgoing IP traffic. + * + * @see ip_frag.c + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 + +#include "lwip/ip.h" +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/ip_frag.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/icmp.h" +#include "lwip/igmp.h" +#include "lwip/raw.h" +#include "lwip/udp.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/dhcp.h" +#include "lwip/autoip.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** Set this to 0 in the rare case of wanting to call an extra function to + * generate the IP checksum (in contrast to calculating it on-the-fly). */ +#ifndef LWIP_INLINE_IP_CHKSUM +#if LWIP_CHECKSUM_CTRL_PER_NETIF +#define LWIP_INLINE_IP_CHKSUM 0 +#else /* LWIP_CHECKSUM_CTRL_PER_NETIF */ +#define LWIP_INLINE_IP_CHKSUM 1 +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF */ +#endif + +#if LWIP_INLINE_IP_CHKSUM && CHECKSUM_GEN_IP +#define CHECKSUM_GEN_IP_INLINE 1 +#else +#define CHECKSUM_GEN_IP_INLINE 0 +#endif + +#if LWIP_DHCP || defined(LWIP_IP_ACCEPT_UDP_PORT) +#define IP_ACCEPT_LINK_LAYER_ADDRESSING 1 + +/** Some defines for DHCP to let link-layer-addressed packets through while the + * netif is down. + * To use this in your own application/protocol, define LWIP_IP_ACCEPT_UDP_PORT(port) + * to return 1 if the port is accepted and 0 if the port is not accepted. + */ +#if LWIP_DHCP && defined(LWIP_IP_ACCEPT_UDP_PORT) +/* accept DHCP client port and custom port */ +#define IP_ACCEPT_LINK_LAYER_ADDRESSED_PORT(port) (((port) == PP_NTOHS(DHCP_CLIENT_PORT)) \ + || (LWIP_IP_ACCEPT_UDP_PORT(port))) +#elif defined(LWIP_IP_ACCEPT_UDP_PORT) /* LWIP_DHCP && defined(LWIP_IP_ACCEPT_UDP_PORT) */ +/* accept custom port only */ +#define IP_ACCEPT_LINK_LAYER_ADDRESSED_PORT(port) (LWIP_IP_ACCEPT_UDP_PORT(port)) +#else /* LWIP_DHCP && defined(LWIP_IP_ACCEPT_UDP_PORT) */ +/* accept DHCP client port only */ +#define IP_ACCEPT_LINK_LAYER_ADDRESSED_PORT(port) ((port) == PP_NTOHS(DHCP_CLIENT_PORT)) +#endif /* LWIP_DHCP && defined(LWIP_IP_ACCEPT_UDP_PORT) */ + +#else /* LWIP_DHCP */ +#define IP_ACCEPT_LINK_LAYER_ADDRESSING 0 +#endif /* LWIP_DHCP */ + +/** The IP header ID of the next outgoing IP packet */ +static u16_t ip_id; + +#if LWIP_MULTICAST_TX_OPTIONS +/** The default netif used for multicast */ +static struct netif* ip4_default_multicast_netif; + +/** Set a default netif for IPv4 multicast. */ +void +ip4_set_default_multicast_netif(struct netif* default_multicast_netif) +{ + ip4_default_multicast_netif = default_multicast_netif; +} +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + +#ifdef LWIP_HOOK_IP4_ROUTE_SRC +/** + * Source based IPv4 routing must be fully implemented in + * LWIP_HOOK_IP4_ROUTE_SRC(). This function only provides he parameters. + */ +struct netif * +ip4_route_src(const ip4_addr_t *dest, const ip4_addr_t *src) +{ + if (src != NULL) { + /* when src==NULL, the hook is called from ip4_route(dest) */ + struct netif *netif = LWIP_HOOK_IP4_ROUTE_SRC(dest, src); + if (netif != NULL) { + return netif; + } + } + return ip4_route(dest); +} +#endif /* LWIP_HOOK_IP4_ROUTE_SRC */ + +/** + * Finds the appropriate network interface for a given IP address. It + * searches the list of network interfaces linearly. A match is found + * if the masked IP address of the network interface equals the masked + * IP address given to the function. + * + * @param dest the destination IP address for which to find the route + * @return the netif on which to send to reach dest + */ +struct netif * +ip4_route(const ip4_addr_t *dest) +{ +#ifdef LWIP_ESP8266 + struct netif *non_default_netif = NULL; +#endif + struct netif *netif; + +#if LWIP_MULTICAST_TX_OPTIONS + /* Use administratively selected interface for multicast by default */ + if (ip4_addr_ismulticast(dest) && ip4_default_multicast_netif) { + return ip4_default_multicast_netif; + } +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + + /* iterate through netifs */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + /* is the netif up, does it have a link and a valid address? */ + if (netif_is_up(netif) && netif_is_link_up(netif) && !ip4_addr_isany_val(*netif_ip4_addr(netif))) { + /* network mask matches? */ + if (ip4_addr_netcmp(dest, netif_ip4_addr(netif), netif_ip4_netmask(netif))) { + /* return netif on which to forward IP packet */ + return netif; + } + /* gateway matches on a non broadcast interface? (i.e. peer in a point to point interface) */ + if (((netif->flags & NETIF_FLAG_BROADCAST) == 0) && ip4_addr_cmp(dest, netif_ip4_gw(netif))) { + /* return netif on which to forward IP packet */ + return netif; + } + + if (netif != netif_default){ + non_default_netif = netif; + } + } + } + +#ifdef LWIP_ESP8266 + if (non_default_netif && !ip4_addr_isbroadcast(dest, non_default_netif)){ + return non_default_netif; + } +#endif + +#if LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF + /* loopif is disabled, looopback traffic is passed through any netif */ + if (ip4_addr_isloopback(dest)) { + /* don't check for link on loopback traffic */ + if (netif_is_up(netif_default)) { + return netif_default; + } + /* default netif is not up, just use any netif for loopback traffic */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (netif_is_up(netif)) { + return netif; + } + } + return NULL; + } +#endif /* LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF */ + +#ifdef LWIP_HOOK_IP4_ROUTE_SRC + netif = LWIP_HOOK_IP4_ROUTE_SRC(dest, NULL); + if (netif != NULL) { + return netif; + } +#elif defined(LWIP_HOOK_IP4_ROUTE) + netif = LWIP_HOOK_IP4_ROUTE(dest); + if (netif != NULL) { + return netif; + } +#endif + + if ((netif_default == NULL) || !netif_is_up(netif_default) || !netif_is_link_up(netif_default) || + ip4_addr_isany_val(*netif_ip4_addr(netif_default))) { + /* No matching netif found and default netif is not usable. + If this is not good enough for you, use LWIP_HOOK_IP4_ROUTE() */ + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip4_route: No route to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(dest), ip4_addr2_16(dest), ip4_addr3_16(dest), ip4_addr4_16(dest))); + IP_STATS_INC(ip.rterr); + MIB2_STATS_INC(mib2.ipoutnoroutes); + return NULL; + } + + return netif_default; +} + +#if IP_FORWARD +/** + * Determine whether an IP address is in a reserved set of addresses + * that may not be forwarded, or whether datagrams to that destination + * may be forwarded. + * @param p the packet to forward + * @param dest the destination IP address + * @return 1: can forward 0: discard + */ +static int +ip4_canforward(struct pbuf *p) +{ + u32_t addr = htonl(ip4_addr_get_u32(ip4_current_dest_addr())); + + if (p->flags & PBUF_FLAG_LLBCAST) { + /* don't route link-layer broadcasts */ + return 0; + } + if ((p->flags & PBUF_FLAG_LLMCAST) && !IP_MULTICAST(addr)) { + /* don't route link-layer multicasts unless the destination address is an IP + multicast address */ + return 0; + } + if (IP_EXPERIMENTAL(addr)) { + return 0; + } + if (IP_CLASSA(addr)) { + u32_t net = addr & IP_CLASSA_NET; + if ((net == 0) || (net == ((u32_t)IP_LOOPBACKNET << IP_CLASSA_NSHIFT))) { + /* don't route loopback packets */ + return 0; + } + } + return 1; +} + +/** + * Forwards an IP packet. It finds an appropriate route for the + * packet, decrements the TTL value of the packet, adjusts the + * checksum and outputs the packet on the appropriate interface. + * + * @param p the packet to forward (p->payload points to IP header) + * @param iphdr the IP header of the input packet + * @param inp the netif on which this packet was received + */ +static void +ip4_forward(struct pbuf *p, struct ip_hdr *iphdr, struct netif *inp) +{ + struct netif *netif; + + PERF_START; + + if (!ip4_canforward(p)) { + goto return_noroute; + } + + /* RFC3927 2.7: do not forward link-local addresses */ + if (ip4_addr_islinklocal(ip4_current_dest_addr())) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_forward: not forwarding LLA %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(ip4_current_dest_addr()), ip4_addr2_16(ip4_current_dest_addr()), + ip4_addr3_16(ip4_current_dest_addr()), ip4_addr4_16(ip4_current_dest_addr()))); + goto return_noroute; + } + + /* Find network interface where to forward this IP packet to. */ + netif = ip4_route_src(ip4_current_dest_addr(), ip4_current_src_addr()); + if (netif == NULL) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_forward: no forwarding route for %"U16_F".%"U16_F".%"U16_F".%"U16_F" found\n", + ip4_addr1_16(ip4_current_dest_addr()), ip4_addr2_16(ip4_current_dest_addr()), + ip4_addr3_16(ip4_current_dest_addr()), ip4_addr4_16(ip4_current_dest_addr()))); + /* @todo: send ICMP_DUR_NET? */ + goto return_noroute; + } +#if !IP_FORWARD_ALLOW_TX_ON_RX_NETIF + /* Do not forward packets onto the same network interface on which + * they arrived. */ + if (netif == inp) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_forward: not bouncing packets back on incoming interface.\n")); + goto return_noroute; + } +#endif /* IP_FORWARD_ALLOW_TX_ON_RX_NETIF */ + + /* decrement TTL */ + IPH_TTL_SET(iphdr, IPH_TTL(iphdr) - 1); + /* send ICMP if TTL == 0 */ + if (IPH_TTL(iphdr) == 0) { + MIB2_STATS_INC(mib2.ipinhdrerrors); +#if LWIP_ICMP + /* Don't send ICMP messages in response to ICMP messages */ + if (IPH_PROTO(iphdr) != IP_PROTO_ICMP) { + icmp_time_exceeded(p, ICMP_TE_TTL); + } +#endif /* LWIP_ICMP */ + return; + } + + /* Incrementally update the IP checksum. */ + if (IPH_CHKSUM(iphdr) >= PP_HTONS(0xffffU - 0x100)) { + IPH_CHKSUM_SET(iphdr, IPH_CHKSUM(iphdr) + PP_HTONS(0x100) + 1); + } else { + IPH_CHKSUM_SET(iphdr, IPH_CHKSUM(iphdr) + PP_HTONS(0x100)); + } + + LWIP_DEBUGF(IP_DEBUG, ("ip4_forward: forwarding packet to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(ip4_current_dest_addr()), ip4_addr2_16(ip4_current_dest_addr()), + ip4_addr3_16(ip4_current_dest_addr()), ip4_addr4_16(ip4_current_dest_addr()))); + + IP_STATS_INC(ip.fw); + MIB2_STATS_INC(mib2.ipforwdatagrams); + IP_STATS_INC(ip.xmit); + + PERF_STOP("ip4_forward"); + /* don't fragment if interface has mtu set to 0 [loopif] */ + if (netif->mtu && (p->tot_len > netif->mtu)) { + if ((IPH_OFFSET(iphdr) & PP_NTOHS(IP_DF)) == 0) { +#if IP_FRAG + ip4_frag(p, netif, ip4_current_dest_addr()); +#else /* IP_FRAG */ + /* @todo: send ICMP Destination Unreachable code 13 "Communication administratively prohibited"? */ +#endif /* IP_FRAG */ + } else { +#if LWIP_ICMP + /* send ICMP Destination Unreachable code 4: "Fragmentation Needed and DF Set" */ + icmp_dest_unreach(p, ICMP_DUR_FRAG); +#endif /* LWIP_ICMP */ + } + return; + } + /* transmit pbuf on chosen interface */ + netif->output(netif, p, ip4_current_dest_addr()); + return; +return_noroute: + MIB2_STATS_INC(mib2.ipoutnoroutes); +} +#endif /* IP_FORWARD */ + +/** + * This function is called by the network interface device driver when + * an IP packet is received. The function does the basic checks of the + * IP header such as packet size being at least larger than the header + * size etc. If the packet was not destined for us, the packet is + * forwarded (using ip_forward). The IP checksum is always checked. + * + * Finally, the packet is sent to the upper layer protocol input function. + * + * @param p the received IP packet (p->payload points to IP header) + * @param inp the netif on which this packet was received + * @return ERR_OK if the packet was processed (could return ERR_* if it wasn't + * processed, but currently always returns ERR_OK) + */ +err_t +ip4_input(struct pbuf *p, struct netif *inp) +{ + struct ip_hdr *iphdr; + struct netif *netif; + u16_t iphdr_hlen; + u16_t iphdr_len; +#if IP_ACCEPT_LINK_LAYER_ADDRESSING || LWIP_IGMP + int check_ip_src = 1; +#endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING || LWIP_IGMP */ + + IP_STATS_INC(ip.recv); + MIB2_STATS_INC(mib2.ipinreceives); + + /* identify the IP header */ + iphdr = (struct ip_hdr *)p->payload; + if (IPH_V(iphdr) != 4) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_WARNING, ("IP packet dropped due to bad version number %"U16_F"\n", IPH_V(iphdr))); + ip4_debug_print(p); + pbuf_free(p); + IP_STATS_INC(ip.err); + IP_STATS_INC(ip.drop); + MIB2_STATS_INC(mib2.ipinhdrerrors); + return ERR_OK; + } + +#ifdef LWIP_HOOK_IP4_INPUT + if (LWIP_HOOK_IP4_INPUT(p, inp)) { + /* the packet has been eaten */ + return ERR_OK; + } +#endif + + /* obtain IP header length in number of 32-bit words */ + iphdr_hlen = IPH_HL(iphdr); + /* calculate IP header length in bytes */ + iphdr_hlen *= 4; + /* obtain ip length in bytes */ + iphdr_len = ntohs(IPH_LEN(iphdr)); + + /* Trim pbuf. This is especially required for packets < 60 bytes. */ + if (iphdr_len < p->tot_len) { + pbuf_realloc(p, iphdr_len); + } + + /* header length exceeds first pbuf length, or ip length exceeds total pbuf length? */ + if ((iphdr_hlen > p->len) || (iphdr_len > p->tot_len)) { + if (iphdr_hlen > p->len) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IP header (len %"U16_F") does not fit in first pbuf (len %"U16_F"), IP packet dropped.\n", + iphdr_hlen, p->len)); + } + if (iphdr_len > p->tot_len) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IP (len %"U16_F") is longer than pbuf (len %"U16_F"), IP packet dropped.\n", + iphdr_len, p->tot_len)); + } + /* free (drop) packet pbufs */ + pbuf_free(p); + IP_STATS_INC(ip.lenerr); + IP_STATS_INC(ip.drop); + MIB2_STATS_INC(mib2.ipindiscards); + return ERR_OK; + } + + /* verify checksum */ +#if CHECKSUM_CHECK_IP + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_CHECK_IP) { + if (inet_chksum(iphdr, iphdr_hlen) != 0) { + + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("Checksum (0x%"X16_F") failed, IP packet dropped.\n", inet_chksum(iphdr, iphdr_hlen))); + ip4_debug_print(p); + pbuf_free(p); + IP_STATS_INC(ip.chkerr); + IP_STATS_INC(ip.drop); + MIB2_STATS_INC(mib2.ipinhdrerrors); + return ERR_OK; + } + } +#endif + + /* copy IP addresses to aligned ip_addr_t */ + ip_addr_copy_from_ip4(ip_data.current_iphdr_dest, iphdr->dest); + ip_addr_copy_from_ip4(ip_data.current_iphdr_src, iphdr->src); + + /* match packet against an interface, i.e. is this packet for us? */ + if (ip4_addr_ismulticast(ip4_current_dest_addr())) { +#if LWIP_IGMP + if ((inp->flags & NETIF_FLAG_IGMP) && (igmp_lookfor_group(inp, ip4_current_dest_addr()))) { + /* IGMP snooping switches need 0.0.0.0 to be allowed as source address (RFC 4541) */ + ip4_addr_t allsystems; + IP4_ADDR(&allsystems, 224, 0, 0, 1); + if (ip4_addr_cmp(ip4_current_dest_addr(), &allsystems) && + ip4_addr_isany(ip4_current_src_addr())) { + check_ip_src = 0; + } + netif = inp; + } else { + netif = NULL; + } +#else /* LWIP_IGMP */ + if ((netif_is_up(inp)) && (!ip4_addr_isany_val(*netif_ip4_addr(inp)))) { + netif = inp; + } else { + netif = NULL; + } +#endif /* LWIP_IGMP */ + } else { + /* start trying with inp. if that's not acceptable, start walking the + list of configured netifs. + 'first' is used as a boolean to mark whether we started walking the list */ + int first = 1; + netif = inp; + do { + LWIP_DEBUGF(IP_DEBUG, ("ip_input: iphdr->dest 0x%"X32_F" netif->ip_addr 0x%"X32_F" (0x%"X32_F", 0x%"X32_F", 0x%"X32_F")\n", + ip4_addr_get_u32(&iphdr->dest), ip4_addr_get_u32(netif_ip4_addr(netif)), + ip4_addr_get_u32(&iphdr->dest) & ip4_addr_get_u32(netif_ip4_netmask(netif)), + ip4_addr_get_u32(netif_ip4_addr(netif)) & ip4_addr_get_u32(netif_ip4_netmask(netif)), + ip4_addr_get_u32(&iphdr->dest) & ~ip4_addr_get_u32(netif_ip4_netmask(netif)))); + + /* interface is up and configured? */ + if ((netif_is_up(netif)) && (!ip4_addr_isany_val(*netif_ip4_addr(netif)))) { + /* unicast to this interface address? */ + if (ip4_addr_cmp(ip4_current_dest_addr(), netif_ip4_addr(netif)) || + /* or broadcast on this interface network address? */ + ip4_addr_isbroadcast(ip4_current_dest_addr(), netif) +#if LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF + || (ip4_addr_get_u32(ip4_current_dest_addr()) == PP_HTONL(IPADDR_LOOPBACK)) +#endif /* LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF */ + ) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_input: packet accepted on interface %c%c\n", + netif->name[0], netif->name[1])); + /* break out of for loop */ + break; + } +#if LWIP_AUTOIP + /* connections to link-local addresses must persist after changing + the netif's address (RFC3927 ch. 1.9) */ + if ((netif->autoip != NULL) && + ip4_addr_cmp(ip4_current_dest_addr(), &(netif->autoip->llipaddr))) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_input: LLA packet accepted on interface %c%c\n", + netif->name[0], netif->name[1])); + /* break out of for loop */ + break; + } +#endif /* LWIP_AUTOIP */ + } + if (first) { + first = 0; + netif = netif_list; + } else { + netif = netif->next; + } + if (netif == inp) { + netif = netif->next; + } + } while (netif != NULL); + } + +#if IP_ACCEPT_LINK_LAYER_ADDRESSING + /* Pass DHCP messages regardless of destination address. DHCP traffic is addressed + * using link layer addressing (such as Ethernet MAC) so we must not filter on IP. + * According to RFC 1542 section 3.1.1, referred by RFC 2131). + * + * If you want to accept private broadcast communication while a netif is down, + * define LWIP_IP_ACCEPT_UDP_PORT(dst_port), e.g.: + * + * #define LWIP_IP_ACCEPT_UDP_PORT(dst_port) ((dst_port) == PP_NTOHS(12345)) + */ + if (netif == NULL) { + /* remote port is DHCP server? */ + if (IPH_PROTO(iphdr) == IP_PROTO_UDP) { + struct udp_hdr *udphdr = (struct udp_hdr *)((u8_t *)iphdr + iphdr_hlen); + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_TRACE, ("ip4_input: UDP packet to DHCP client port %"U16_F"\n", + ntohs(udphdr->dest))); + if (IP_ACCEPT_LINK_LAYER_ADDRESSED_PORT(udphdr->dest)) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_TRACE, ("ip4_input: DHCP packet accepted.\n")); + netif = inp; + check_ip_src = 0; + } + } + } +#endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING */ + + /* broadcast or multicast packet source address? Compliant with RFC 1122: 3.2.1.3 */ +#if LWIP_IGMP || IP_ACCEPT_LINK_LAYER_ADDRESSING + if (check_ip_src +#if IP_ACCEPT_LINK_LAYER_ADDRESSING + /* DHCP servers need 0.0.0.0 to be allowed as source address (RFC 1.1.2.2: 3.2.1.3/a) */ + && !ip4_addr_isany_val(*ip4_current_src_addr()) +#endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING */ + ) +#endif /* LWIP_IGMP || IP_ACCEPT_LINK_LAYER_ADDRESSING */ + { + if ((ip4_addr_isbroadcast(ip4_current_src_addr(), inp)) || + (ip4_addr_ismulticast(ip4_current_src_addr()))) { + /* packet source is not valid */ + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("ip4_input: packet source is not valid.\n")); + /* free (drop) packet pbufs */ + pbuf_free(p); + IP_STATS_INC(ip.drop); + MIB2_STATS_INC(mib2.ipinaddrerrors); + MIB2_STATS_INC(mib2.ipindiscards); + return ERR_OK; + } + } + + /* packet not for us? */ + if (netif == NULL) { + /* packet not for us, route or discard */ + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_TRACE, ("ip4_input: packet not for us.\n")); +#if IP_FORWARD + /* non-broadcast packet? */ + if (!ip4_addr_isbroadcast(ip4_current_dest_addr(), inp)) { + /* try to forward IP packet on (other) interfaces */ + ip4_forward(p, iphdr, inp); + } else +#endif /* IP_FORWARD */ + { + MIB2_STATS_INC(mib2.ipinaddrerrors); + MIB2_STATS_INC(mib2.ipindiscards); + } + pbuf_free(p); + return ERR_OK; + } + /* packet consists of multiple fragments? */ + if ((IPH_OFFSET(iphdr) & PP_HTONS(IP_OFFMASK | IP_MF)) != 0) { +#if IP_REASSEMBLY /* packet fragment reassembly code present? */ + LWIP_DEBUGF(IP_DEBUG, ("IP packet is a fragment (id=0x%04"X16_F" tot_len=%"U16_F" len=%"U16_F" MF=%"U16_F" offset=%"U16_F"), calling ip4_reass()\n", + ntohs(IPH_ID(iphdr)), p->tot_len, ntohs(IPH_LEN(iphdr)), !!(IPH_OFFSET(iphdr) & PP_HTONS(IP_MF)), (ntohs(IPH_OFFSET(iphdr)) & IP_OFFMASK)*8)); + /* reassemble the packet*/ + p = ip4_reass(p); + /* packet not fully reassembled yet? */ + if (p == NULL) { + return ERR_OK; + } + iphdr = (struct ip_hdr *)p->payload; +#else /* IP_REASSEMBLY == 0, no packet fragment reassembly code present */ + pbuf_free(p); + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("IP packet dropped since it was fragmented (0x%"X16_F") (while IP_REASSEMBLY == 0).\n", + ntohs(IPH_OFFSET(iphdr)))); + IP_STATS_INC(ip.opterr); + IP_STATS_INC(ip.drop); + /* unsupported protocol feature */ + MIB2_STATS_INC(mib2.ipinunknownprotos); + return ERR_OK; +#endif /* IP_REASSEMBLY */ + } + +#if IP_OPTIONS_ALLOWED == 0 /* no support for IP options in the IP header? */ + +#if LWIP_IGMP + /* there is an extra "router alert" option in IGMP messages which we allow for but do not police */ + if ((iphdr_hlen > IP_HLEN) && (IPH_PROTO(iphdr) != IP_PROTO_IGMP)) { +#else + if (iphdr_hlen > IP_HLEN) { +#endif /* LWIP_IGMP */ + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("IP packet dropped since there were IP options (while IP_OPTIONS_ALLOWED == 0).\n")); + pbuf_free(p); + IP_STATS_INC(ip.opterr); + IP_STATS_INC(ip.drop); + /* unsupported protocol feature */ + MIB2_STATS_INC(mib2.ipinunknownprotos); + return ERR_OK; + } +#endif /* IP_OPTIONS_ALLOWED == 0 */ + + /* send to upper layers */ + LWIP_DEBUGF(IP_DEBUG, ("ip4_input: \n")); + ip4_debug_print(p); + LWIP_DEBUGF(IP_DEBUG, ("ip4_input: p->len %"U16_F" p->tot_len %"U16_F"\n", p->len, p->tot_len)); + + ip_data.current_netif = netif; + ip_data.current_input_netif = inp; + ip_data.current_ip4_header = iphdr; + ip_data.current_ip_header_tot_len = IPH_HL(iphdr) * 4; + +#if LWIP_RAW + /* raw input did not eat the packet? */ + if (raw_input(p, inp) == 0) +#endif /* LWIP_RAW */ + { + pbuf_header(p, -(s16_t)iphdr_hlen); /* Move to payload, no check necessary. */ + + switch (IPH_PROTO(iphdr)) { +#if LWIP_UDP + case IP_PROTO_UDP: +#if LWIP_UDPLITE + case IP_PROTO_UDPLITE: +#endif /* LWIP_UDPLITE */ + MIB2_STATS_INC(mib2.ipindelivers); + udp_input(p, inp); + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case IP_PROTO_TCP: + MIB2_STATS_INC(mib2.ipindelivers); + tcp_input(p, inp); + break; +#endif /* LWIP_TCP */ +#if LWIP_ICMP + case IP_PROTO_ICMP: + MIB2_STATS_INC(mib2.ipindelivers); + icmp_input(p, inp); + break; +#endif /* LWIP_ICMP */ +#if LWIP_IGMP + case IP_PROTO_IGMP: + igmp_input(p, inp, ip4_current_dest_addr()); + break; +#endif /* LWIP_IGMP */ + default: +#if LWIP_ICMP + /* send ICMP destination protocol unreachable unless is was a broadcast */ + if (!ip4_addr_isbroadcast(ip4_current_dest_addr(), netif) && + !ip4_addr_ismulticast(ip4_current_dest_addr())) { + pbuf_header_force(p, iphdr_hlen); /* Move to ip header, no check necessary. */ + p->payload = iphdr; + icmp_dest_unreach(p, ICMP_DUR_PROTO); + } +#endif /* LWIP_ICMP */ + pbuf_free(p); + + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("Unsupported transport protocol %"U16_F"\n", IPH_PROTO(iphdr))); + + IP_STATS_INC(ip.proterr); + IP_STATS_INC(ip.drop); + MIB2_STATS_INC(mib2.ipinunknownprotos); + } + } + + /* @todo: this is not really necessary... */ + ip_data.current_netif = NULL; + ip_data.current_input_netif = NULL; + ip_data.current_ip4_header = NULL; + ip_data.current_ip_header_tot_len = 0; + ip4_addr_set_any(ip4_current_src_addr()); + ip4_addr_set_any(ip4_current_dest_addr()); + + return ERR_OK; +} + +/** + * Sends an IP packet on a network interface. This function constructs + * the IP header and calculates the IP header checksum. If the source + * IP address is NULL, the IP address of the outgoing network + * interface is filled in as source address. + * If the destination IP address is IP_HDRINCL, p is assumed to already + * include an IP header and p->payload points to it instead of the data. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an IP + header and p->payload points to that IP header) + * @param src the source IP address to send from (if src == IP_ADDR_ANY, the + * IP address of the netif used to send is used as source address) + * @param dest the destination IP address to send the packet to + * @param ttl the TTL value to be set in the IP header + * @param tos the TOS value to be set in the IP header + * @param proto the PROTOCOL to be set in the IP header + * @param netif the netif on which to send this packet + * @return ERR_OK if the packet was sent OK + * ERR_BUF if p doesn't have enough space for IP/LINK headers + * returns errors returned by netif->output + * + * @note ip_id: RFC791 "some host may be able to simply use + * unique identifiers independent of destination" + */ +err_t +ip4_output_if(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, + u8_t proto, struct netif *netif) +{ +#if IP_OPTIONS_SEND + return ip4_output_if_opt(p, src, dest, ttl, tos, proto, netif, NULL, 0); +} + +/** + * Same as ip_output_if() but with the possibility to include IP options: + * + * @ param ip_options pointer to the IP options, copied into the IP header + * @ param optlen length of ip_options + */ +err_t +ip4_output_if_opt(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif, void *ip_options, + u16_t optlen) +{ +#endif /* IP_OPTIONS_SEND */ + const ip4_addr_t *src_used = src; + if (dest != IP_HDRINCL) { + if (ip4_addr_isany(src)) { + src_used = netif_ip4_addr(netif); + } + } + +#if IP_OPTIONS_SEND + return ip4_output_if_opt_src(p, src_used, dest, ttl, tos, proto, netif, + ip_options, optlen); +#else /* IP_OPTIONS_SEND */ + return ip4_output_if_src(p, src_used, dest, ttl, tos, proto, netif); +#endif /* IP_OPTIONS_SEND */ +} + +/** + * Same as ip_output_if() but 'src' address is not replaced by netif address + * when it is 'any'. + */ +err_t +ip4_output_if_src(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, + u8_t proto, struct netif *netif) +{ +#if IP_OPTIONS_SEND + return ip4_output_if_opt_src(p, src, dest, ttl, tos, proto, netif, NULL, 0); +} + +/** + * Same as ip_output_if_opt() but 'src' address is not replaced by netif address + * when it is 'any'. + */ +err_t +ip4_output_if_opt_src(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif, void *ip_options, + u16_t optlen) +{ +#endif /* IP_OPTIONS_SEND */ + struct ip_hdr *iphdr; + ip4_addr_t dest_addr; +#if CHECKSUM_GEN_IP_INLINE + u32_t chk_sum = 0; +#endif /* CHECKSUM_GEN_IP_INLINE */ + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + MIB2_STATS_INC(mib2.ipoutrequests); + + /* Should the IP header be generated or is it already included in p? */ + if (dest != IP_HDRINCL) { + u16_t ip_hlen = IP_HLEN; +#if IP_OPTIONS_SEND + u16_t optlen_aligned = 0; + if (optlen != 0) { +#if CHECKSUM_GEN_IP_INLINE + int i; +#endif /* CHECKSUM_GEN_IP_INLINE */ + /* round up to a multiple of 4 */ + optlen_aligned = ((optlen + 3) & ~3); + ip_hlen += optlen_aligned; + /* First write in the IP options */ + if (pbuf_header(p, optlen_aligned)) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip4_output_if_opt: not enough room for IP options in pbuf\n")); + IP_STATS_INC(ip.err); + MIB2_STATS_INC(mib2.ipoutdiscards); + return ERR_BUF; + } + MEMCPY(p->payload, ip_options, optlen); + if (optlen < optlen_aligned) { + /* zero the remaining bytes */ + memset(((char*)p->payload) + optlen, 0, optlen_aligned - optlen); + } +#if CHECKSUM_GEN_IP_INLINE + for (i = 0; i < optlen_aligned/2; i++) { + chk_sum += ((u16_t*)p->payload)[i]; + } +#endif /* CHECKSUM_GEN_IP_INLINE */ + } +#endif /* IP_OPTIONS_SEND */ + /* generate IP header */ + if (pbuf_header(p, IP_HLEN)) { + LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip4_output: not enough room for IP header in pbuf\n")); + + IP_STATS_INC(ip.err); + MIB2_STATS_INC(mib2.ipoutdiscards); + return ERR_BUF; + } + + iphdr = (struct ip_hdr *)p->payload; + LWIP_ASSERT("check that first pbuf can hold struct ip_hdr", + (p->len >= sizeof(struct ip_hdr))); + + IPH_TTL_SET(iphdr, ttl); + IPH_PROTO_SET(iphdr, proto); +#if CHECKSUM_GEN_IP_INLINE + chk_sum += LWIP_MAKE_U16(proto, ttl); +#endif /* CHECKSUM_GEN_IP_INLINE */ + + /* dest cannot be NULL here */ + ip4_addr_copy(iphdr->dest, *dest); +#if CHECKSUM_GEN_IP_INLINE + chk_sum += ip4_addr_get_u32(&iphdr->dest) & 0xFFFF; + chk_sum += ip4_addr_get_u32(&iphdr->dest) >> 16; +#endif /* CHECKSUM_GEN_IP_INLINE */ + + IPH_VHL_SET(iphdr, 4, ip_hlen / 4); + IPH_TOS_SET(iphdr, tos); +#if CHECKSUM_GEN_IP_INLINE + chk_sum += LWIP_MAKE_U16(tos, iphdr->_v_hl); +#endif /* CHECKSUM_GEN_IP_INLINE */ + IPH_LEN_SET(iphdr, htons(p->tot_len)); +#if CHECKSUM_GEN_IP_INLINE + chk_sum += iphdr->_len; +#endif /* CHECKSUM_GEN_IP_INLINE */ + IPH_OFFSET_SET(iphdr, 0); + IPH_ID_SET(iphdr, htons(ip_id)); +#if CHECKSUM_GEN_IP_INLINE + chk_sum += iphdr->_id; +#endif /* CHECKSUM_GEN_IP_INLINE */ + ++ip_id; + + if (src == NULL) { + ip4_addr_copy(iphdr->src, *IP4_ADDR_ANY); + } else { + /* src cannot be NULL here */ + ip4_addr_copy(iphdr->src, *src); + } + +#if CHECKSUM_GEN_IP_INLINE + chk_sum += ip4_addr_get_u32(&iphdr->src) & 0xFFFF; + chk_sum += ip4_addr_get_u32(&iphdr->src) >> 16; + chk_sum = (chk_sum >> 16) + (chk_sum & 0xFFFF); + chk_sum = (chk_sum >> 16) + chk_sum; + chk_sum = ~chk_sum; + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_IP) { + iphdr->_chksum = (u16_t)chk_sum; /* network order */ + } +#if LWIP_CHECKSUM_CTRL_PER_NETIF + else { + IPH_CHKSUM_SET(iphdr, 0); + } +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF*/ +#else /* CHECKSUM_GEN_IP_INLINE */ + IPH_CHKSUM_SET(iphdr, 0); +#if CHECKSUM_GEN_IP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_IP) { + IPH_CHKSUM_SET(iphdr, inet_chksum(iphdr, ip_hlen)); + } +#endif /* CHECKSUM_GEN_IP */ +#endif /* CHECKSUM_GEN_IP_INLINE */ + } else { + /* IP header already included in p */ + iphdr = (struct ip_hdr *)p->payload; + ip4_addr_copy(dest_addr, iphdr->dest); + dest = &dest_addr; + } + + IP_STATS_INC(ip.xmit); + + LWIP_DEBUGF(IP_DEBUG, ("ip4_output_if: %c%c%"U16_F"\n", netif->name[0], netif->name[1], netif->num)); + ip4_debug_print(p); + +#if ENABLE_LOOPBACK + if (ip4_addr_cmp(dest, netif_ip4_addr(netif)) +#if !LWIP_HAVE_LOOPIF + || ip4_addr_isloopback(dest) +#endif /* !LWIP_HAVE_LOOPIF */ + ) { + /* Packet to self, enqueue it for loopback */ + LWIP_DEBUGF(IP_DEBUG, ("netif_loop_output()")); + return netif_loop_output(netif, p); + } +#if LWIP_MULTICAST_TX_OPTIONS + if ((p->flags & PBUF_FLAG_MCASTLOOP) != 0) { + netif_loop_output(netif, p); + } +#endif /* LWIP_MULTICAST_TX_OPTIONS */ +#endif /* ENABLE_LOOPBACK */ +#if IP_FRAG + /* don't fragment if interface has mtu set to 0 [loopif] */ + if (netif->mtu && (p->tot_len > netif->mtu)) { + return ip4_frag(p, netif, dest); + } +#endif /* IP_FRAG */ + + LWIP_DEBUGF(IP_DEBUG, ("ip4_output_if: call netif->output()\n")); + return netif->output(netif, p, dest); +} + +/** + * Simple interface to ip_output_if. It finds the outgoing network + * interface and calls upon ip_output_if to do the actual work. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an IP + header and p->payload points to that IP header) + * @param src the source IP address to send from (if src == IP_ADDR_ANY, the + * IP address of the netif used to send is used as source address) + * @param dest the destination IP address to send the packet to + * @param ttl the TTL value to be set in the IP header + * @param tos the TOS value to be set in the IP header + * @param proto the PROTOCOL to be set in the IP header + * + * @return ERR_RTE if no route is found + * see ip_output_if() for more return values + */ +err_t +ip4_output(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto) +{ + struct netif *netif; + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + if ((netif = ip4_route_src(dest, src)) == NULL) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_output: No route to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(dest), ip4_addr2_16(dest), ip4_addr3_16(dest), ip4_addr4_16(dest))); + IP_STATS_INC(ip.rterr); + return ERR_RTE; + } + + return ip4_output_if(p, src, dest, ttl, tos, proto, netif); +} + +#if LWIP_NETIF_HWADDRHINT +/** Like ip_output, but takes and addr_hint pointer that is passed on to netif->addr_hint + * before calling ip_output_if. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an IP + header and p->payload points to that IP header) + * @param src the source IP address to send from (if src == IP_ADDR_ANY, the + * IP address of the netif used to send is used as source address) + * @param dest the destination IP address to send the packet to + * @param ttl the TTL value to be set in the IP header + * @param tos the TOS value to be set in the IP header + * @param proto the PROTOCOL to be set in the IP header + * @param addr_hint address hint pointer set to netif->addr_hint before + * calling ip_output_if() + * + * @return ERR_RTE if no route is found + * see ip_output_if() for more return values + */ +err_t +ip4_output_hinted(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, u8_t *addr_hint) +{ + struct netif *netif; + err_t err; + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + if ((netif = ip4_route_src(dest, src)) == NULL) { + LWIP_DEBUGF(IP_DEBUG, ("ip4_output: No route to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(dest), ip4_addr2_16(dest), ip4_addr3_16(dest), ip4_addr4_16(dest))); + IP_STATS_INC(ip.rterr); + return ERR_RTE; + } + + NETIF_SET_HWADDRHINT(netif, addr_hint); + err = ip4_output_if(p, src, dest, ttl, tos, proto, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + + return err; +} +#endif /* LWIP_NETIF_HWADDRHINT*/ + +#if IP_DEBUG +/* Print an IP header by using LWIP_DEBUGF + * @param p an IP packet, p->payload pointing to the IP header + */ +void +ip4_debug_print(struct pbuf *p) +{ + struct ip_hdr *iphdr = (struct ip_hdr *)p->payload; + + LWIP_DEBUGF(IP_DEBUG, ("IP header:\n")); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP_DEBUG, ("|%2"S16_F" |%2"S16_F" | 0x%02"X16_F" | %5"U16_F" | (v, hl, tos, len)\n", + IPH_V(iphdr), + IPH_HL(iphdr), + IPH_TOS(iphdr), + ntohs(IPH_LEN(iphdr)))); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP_DEBUG, ("| %5"U16_F" |%"U16_F"%"U16_F"%"U16_F"| %4"U16_F" | (id, flags, offset)\n", + ntohs(IPH_ID(iphdr)), + ntohs(IPH_OFFSET(iphdr)) >> 15 & 1, + ntohs(IPH_OFFSET(iphdr)) >> 14 & 1, + ntohs(IPH_OFFSET(iphdr)) >> 13 & 1, + ntohs(IPH_OFFSET(iphdr)) & IP_OFFMASK)); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP_DEBUG, ("| %3"U16_F" | %3"U16_F" | 0x%04"X16_F" | (ttl, proto, chksum)\n", + IPH_TTL(iphdr), + IPH_PROTO(iphdr), + ntohs(IPH_CHKSUM(iphdr)))); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP_DEBUG, ("| %3"U16_F" | %3"U16_F" | %3"U16_F" | %3"U16_F" | (src)\n", + ip4_addr1_16(&iphdr->src), + ip4_addr2_16(&iphdr->src), + ip4_addr3_16(&iphdr->src), + ip4_addr4_16(&iphdr->src))); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP_DEBUG, ("| %3"U16_F" | %3"U16_F" | %3"U16_F" | %3"U16_F" | (dest)\n", + ip4_addr1_16(&iphdr->dest), + ip4_addr2_16(&iphdr->dest), + ip4_addr3_16(&iphdr->dest), + ip4_addr4_16(&iphdr->dest))); + LWIP_DEBUGF(IP_DEBUG, ("+-------------------------------+\n")); +} +#endif /* IP_DEBUG */ + +#endif /* LWIP_IPV4 */ diff --git a/components/lwip/core/ipv4/ip4_addr.c b/components/lwip/core/ipv4/ip4_addr.c new file mode 100755 index 000000000..3053cf087 --- /dev/null +++ b/components/lwip/core/ipv4/ip4_addr.c @@ -0,0 +1,372 @@ +/** + * @file + * This is the IPv4 address tools implementation. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 + +#include "lwip/ip_addr.h" +#include "lwip/netif.h" + +/* used by IP_ADDR_ANY and IP_ADDR_BROADCAST in ip_addr.h */ + +#ifdef LWIP_ESP8266 +//TO_DO +//const ip_addr_t ip_addr_any ICACHE_RODATA_ATTR STORE_ATTR = IPADDR4_INIT(IPADDR_ANY); +//const ip_addr_t ip_addr_broadcast ICACHE_RODATA_ATTR STORE_ATTR = IPADDR4_INIT(IPADDR_BROADCAST); +const ip_addr_t ip_addr_any = IPADDR4_INIT(IPADDR_ANY); +const ip_addr_t ip_addr_broadcast = IPADDR4_INIT(IPADDR_BROADCAST); +#else +const ip_addr_t ip_addr_any = IPADDR4_INIT(IPADDR_ANY); +const ip_addr_t ip_addr_broadcast = IPADDR4_INIT(IPADDR_BROADCAST); +#endif + + +/** + * Determine if an address is a broadcast address on a network interface + * + * @param addr address to be checked + * @param netif the network interface against which the address is checked + * @return returns non-zero if the address is a broadcast address + */ +u8_t +ip4_addr_isbroadcast_u32(u32_t addr, const struct netif *netif) +{ + ip4_addr_t ipaddr; + ip4_addr_set_u32(&ipaddr, addr); + + /* all ones (broadcast) or all zeroes (old skool broadcast) */ + if ((~addr == IPADDR_ANY) || + (addr == IPADDR_ANY)) { + return 1; + /* no broadcast support on this network interface? */ + } else if ((netif->flags & NETIF_FLAG_BROADCAST) == 0) { + /* the given address cannot be a broadcast address + * nor can we check against any broadcast addresses */ + return 0; + /* address matches network interface address exactly? => no broadcast */ + } else if (addr == ip4_addr_get_u32(netif_ip4_addr(netif))) { + return 0; + /* on the same (sub) network... */ + } else if (ip4_addr_netcmp(&ipaddr, netif_ip4_addr(netif), netif_ip4_netmask(netif)) + /* ...and host identifier bits are all ones? =>... */ + && ((addr & ~ip4_addr_get_u32(netif_ip4_netmask(netif))) == + (IPADDR_BROADCAST & ~ip4_addr_get_u32(netif_ip4_netmask(netif))))) { + /* => network broadcast address */ + return 1; + } else { + return 0; + } +} + +/** Checks if a netmask is valid (starting with ones, then only zeros) + * + * @param netmask the IPv4 netmask to check (in network byte order!) + * @return 1 if the netmask is valid, 0 if it is not + */ +u8_t +ip4_addr_netmask_valid(u32_t netmask) +{ + u32_t mask; + u32_t nm_hostorder = lwip_htonl(netmask); + + /* first, check for the first zero */ + for (mask = 1UL << 31 ; mask != 0; mask >>= 1) { + if ((nm_hostorder & mask) == 0) { + break; + } + } + /* then check that there is no one */ + for (; mask != 0; mask >>= 1) { + if ((nm_hostorder & mask) != 0) { + /* there is a one after the first zero -> invalid */ + return 0; + } + } + /* no one after the first zero -> valid */ + return 1; +} + +/* Here for now until needed in other places in lwIP */ +#ifndef isprint +#define in_range(c, lo, up) ((u8_t)c >= lo && (u8_t)c <= up) +#define isprint(c) in_range(c, 0x20, 0x7f) +#define isdigit(c) in_range(c, '0', '9') +#define isxdigit(c) (isdigit(c) || in_range(c, 'a', 'f') || in_range(c, 'A', 'F')) +#define islower(c) in_range(c, 'a', 'z') +#define isspace(c) (c == ' ' || c == '\f' || c == '\n' || c == '\r' || c == '\t' || c == '\v') +#endif + +/** + * Ascii internet address interpretation routine. + * The value returned is in network order. + * + * @param cp IP address in ascii representation (e.g. "127.0.0.1") + * @return ip address in network order + */ +u32_t +ipaddr_addr(const char *cp) +{ + ip4_addr_t val; + + if (ip4addr_aton(cp, &val)) { + return ip4_addr_get_u32(&val); + } + return (IPADDR_NONE); +} + +/** + * Check whether "cp" is a valid ascii representation + * of an Internet address and convert to a binary address. + * Returns 1 if the address is valid, 0 if not. + * This replaces inet_addr, the return value from which + * cannot distinguish between failure and a local broadcast address. + * + * @param cp IP address in ascii representation (e.g. "127.0.0.1") + * @param addr pointer to which to save the ip address in network order + * @return 1 if cp could be converted to addr, 0 on failure + */ +int +ip4addr_aton(const char *cp, ip4_addr_t *addr) +{ + u32_t val; + u8_t base; + char c; + u32_t parts[4]; + u32_t *pp = parts; + +#ifdef LWIP_ESP8266 +//#if 0 + char ch; + unsigned long cutoff; + int cutlim; +#endif + + c = *cp; + for (;;) { + /* + * Collect number up to ``.''. + * Values are specified as for C: + * 0x=hex, 0=octal, 1-9=decimal. + */ + if (!isdigit(c)) { + return 0; + } + val = 0; + base = 10; + if (c == '0') { + c = *++cp; + if (c == 'x' || c == 'X') { + base = 16; + c = *++cp; + } else { + base = 8; + } + } + +#ifdef LWIP_ESP8266 +//#if 0 + cutoff =(unsigned long)0xffffffff / (unsigned long)base; + cutlim =(unsigned long)0xffffffff % (unsigned long)base; + for (;;) { + if (isdigit(c)) { + ch = (int)(c - '0'); + if (val > cutoff || (val == cutoff && ch > cutlim)) + return (0); + val = (val * base) + (int)(c - '0'); + c = *++cp; + } else if (base == 16 && isxdigit(c)) { + ch = (int)(c + 10 - (islower(c) ? 'a' : 'A')); + if (val > cutoff || (val == cutoff && ch > cutlim)) + return (0); + val = (val << 4) | (int)(c + 10 - (islower(c) ? 'a' : 'A')); + c = *++cp; + } else + break; + } +#else + for (;;) { + if (isdigit(c)) { + val = (val * base) + (int)(c - '0'); + c = *++cp; + } else if (base == 16 && isxdigit(c)) { + val = (val << 4) | (int)(c + 10 - (islower(c) ? 'a' : 'A')); + c = *++cp; + } else { + break; + } + } +#endif + + if (c == '.') { + /* + * Internet format: + * a.b.c.d + * a.b.c (with c treated as 16 bits) + * a.b (with b treated as 24 bits) + */ + if (pp >= parts + 3) { + return 0; + } + *pp++ = val; + c = *++cp; + } else { + break; + } + } + /* + * Check for trailing characters. + */ + if (c != '\0' && !isspace(c)) { + return 0; + } + /* + * Concoct the address according to + * the number of parts specified. + */ + switch (pp - parts + 1) { + + case 0: + return 0; /* initial nondigit */ + + case 1: /* a -- 32 bits */ + break; + + case 2: /* a.b -- 8.24 bits */ + if (val > 0xffffffUL) { + return 0; + } + if (parts[0] > 0xff) { + return 0; + } + val |= parts[0] << 24; + break; + + case 3: /* a.b.c -- 8.8.16 bits */ + if (val > 0xffff) { + return 0; + } + if ((parts[0] > 0xff) || (parts[1] > 0xff)) { + return 0; + } + val |= (parts[0] << 24) | (parts[1] << 16); + break; + + case 4: /* a.b.c.d -- 8.8.8.8 bits */ + if (val > 0xff) { + return 0; + } + if ((parts[0] > 0xff) || (parts[1] > 0xff) || (parts[2] > 0xff)) { + return 0; + } + val |= (parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8); + break; + default: + LWIP_ASSERT("unhandled", 0); + break; + } + if (addr) { + ip4_addr_set_u32(addr, htonl(val)); + } + return 1; +} + +/** + * Convert numeric IP address into decimal dotted ASCII representation. + * returns ptr to static buffer; not reentrant! + * + * @param addr ip address in network order to convert + * @return pointer to a global static (!) buffer that holds the ASCII + * representation of addr + */ +char* +ip4addr_ntoa(const ip4_addr_t *addr) +{ + static char str[IP4ADDR_STRLEN_MAX]; + return ip4addr_ntoa_r(addr, str, IP4ADDR_STRLEN_MAX); +} + +/** + * Same as ipaddr_ntoa, but reentrant since a user-supplied buffer is used. + * + * @param addr ip address in network order to convert + * @param buf target buffer where the string is stored + * @param buflen length of buf + * @return either pointer to buf which now holds the ASCII + * representation of addr or NULL if buf was too small + */ +char* +ip4addr_ntoa_r(const ip4_addr_t *addr, char *buf, int buflen) +{ + u32_t s_addr; + char inv[3]; + char *rp; + u8_t *ap; + u8_t rem; + u8_t n; + u8_t i; + int len = 0; + + s_addr = ip4_addr_get_u32(addr); + + rp = buf; + ap = (u8_t *)&s_addr; + for (n = 0; n < 4; n++) { + i = 0; + do { + rem = *ap % (u8_t)10; + *ap /= (u8_t)10; + inv[i++] = '0' + rem; + } while (*ap); + while (i--) { + if (len++ >= buflen) { + return NULL; + } + *rp++ = inv[i]; + } + if (len++ >= buflen) { + return NULL; + } + *rp++ = '.'; + ap++; + } + *--rp = 0; + return buf; +} + +#endif /* LWIP_IPV4 */ diff --git a/components/lwip/core/ipv4/ip_frag.c b/components/lwip/core/ipv4/ip_frag.c new file mode 100755 index 000000000..1e6b053e6 --- /dev/null +++ b/components/lwip/core/ipv4/ip_frag.c @@ -0,0 +1,902 @@ +/** + * @file + * This is the IPv4 packet segmentation and reassembly implementation. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Jani Monoses + * Simon Goldschmidt + * original reassembly code by Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV4 + +#include "lwip/ip_frag.h" +#include "lwip/def.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/stats.h" +#include "lwip/icmp.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +#if IP_REASSEMBLY +/** + * The IP reassembly code currently has the following limitations: + * - IP header options are not supported + * - fragments must not overlap (e.g. due to different routes), + * currently, overlapping or duplicate fragments are thrown away + * if IP_REASS_CHECK_OVERLAP=1 (the default)! + * + * @todo: work with IP header options + */ + +/** Setting this to 0, you can turn off checking the fragments for overlapping + * regions. The code gets a little smaller. Only use this if you know that + * overlapping won't occur on your network! */ +#ifndef IP_REASS_CHECK_OVERLAP +#define IP_REASS_CHECK_OVERLAP 1 +#endif /* IP_REASS_CHECK_OVERLAP */ + +/** Set to 0 to prevent freeing the oldest datagram when the reassembly buffer is + * full (IP_REASS_MAX_PBUFS pbufs are enqueued). The code gets a little smaller. + * Datagrams will be freed by timeout only. Especially useful when MEMP_NUM_REASSDATA + * is set to 1, so one datagram can be reassembled at a time, only. */ +#ifndef IP_REASS_FREE_OLDEST +#define IP_REASS_FREE_OLDEST 1 +#endif /* IP_REASS_FREE_OLDEST */ + +#define IP_REASS_FLAG_LASTFRAG 0x01 + +/** This is a helper struct which holds the starting + * offset and the ending offset of this fragment to + * easily chain the fragments. + * It has the same packing requirements as the IP header, since it replaces + * the IP header in memory in incoming fragments (after copying it) to keep + * track of the various fragments. (-> If the IP header doesn't need packing, + * this struct doesn't need packing, too.) + */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip_reass_helper { + PACK_STRUCT_FIELD(struct pbuf *next_pbuf); + PACK_STRUCT_FIELD(u16_t start); + PACK_STRUCT_FIELD(u16_t end); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define IP_ADDRESSES_AND_ID_MATCH(iphdrA, iphdrB) \ + (ip4_addr_cmp(&(iphdrA)->src, &(iphdrB)->src) && \ + ip4_addr_cmp(&(iphdrA)->dest, &(iphdrB)->dest) && \ + IPH_ID(iphdrA) == IPH_ID(iphdrB)) ? 1 : 0 + +/* global variables */ +static struct ip_reassdata *reassdatagrams; +static u16_t ip_reass_pbufcount; + +/* function prototypes */ +static void ip_reass_dequeue_datagram(struct ip_reassdata *ipr, struct ip_reassdata *prev); +static int ip_reass_free_complete_datagram(struct ip_reassdata *ipr, struct ip_reassdata *prev); + +/** + * Reassembly timer base function + * for both NO_SYS == 0 and 1 (!). + * + * Should be called every 1000 msec (defined by IP_TMR_INTERVAL). + */ +void +ip_reass_tmr(void) +{ + struct ip_reassdata *r, *prev = NULL; + + r = reassdatagrams; + while (r != NULL) { + /* Decrement the timer. Once it reaches 0, + * clean up the incomplete fragment assembly */ + if (r->timer > 0) { + r->timer--; + LWIP_DEBUGF(IP_REASS_DEBUG, ("ip_reass_tmr: timer dec %"U16_F"\n",(u16_t)r->timer)); + prev = r; + r = r->next; + } else { + /* reassembly timed out */ + struct ip_reassdata *tmp; + LWIP_DEBUGF(IP_REASS_DEBUG, ("ip_reass_tmr: timer timed out\n")); + tmp = r; + /* get the next pointer before freeing */ + r = r->next; + /* free the helper struct and all enqueued pbufs */ + ip_reass_free_complete_datagram(tmp, prev); + } + } +} + +/** + * Free a datagram (struct ip_reassdata) and all its pbufs. + * Updates the total count of enqueued pbufs (ip_reass_pbufcount), + * SNMP counters and sends an ICMP time exceeded packet. + * + * @param ipr datagram to free + * @param prev the previous datagram in the linked list + * @return the number of pbufs freed + */ +static int +ip_reass_free_complete_datagram(struct ip_reassdata *ipr, struct ip_reassdata *prev) +{ + u16_t pbufs_freed = 0; + u8_t clen; + struct pbuf *p; + struct ip_reass_helper *iprh; + + LWIP_ASSERT("prev != ipr", prev != ipr); + if (prev != NULL) { + LWIP_ASSERT("prev->next == ipr", prev->next == ipr); + } + + MIB2_STATS_INC(mib2.ipreasmfails); +#if LWIP_ICMP + iprh = (struct ip_reass_helper *)ipr->p->payload; + if (iprh->start == 0) { + /* The first fragment was received, send ICMP time exceeded. */ + /* First, de-queue the first pbuf from r->p. */ + p = ipr->p; + ipr->p = iprh->next_pbuf; + /* Then, copy the original header into it. */ + SMEMCPY(p->payload, &ipr->iphdr, IP_HLEN); + icmp_time_exceeded(p, ICMP_TE_FRAG); + clen = pbuf_clen(p); + LWIP_ASSERT("pbufs_freed + clen <= 0xffff", pbufs_freed + clen <= 0xffff); + pbufs_freed += clen; + pbuf_free(p); + } +#endif /* LWIP_ICMP */ + + /* First, free all received pbufs. The individual pbufs need to be released + separately as they have not yet been chained */ + p = ipr->p; + while (p != NULL) { + struct pbuf *pcur; + iprh = (struct ip_reass_helper *)p->payload; + pcur = p; + /* get the next pointer before freeing */ + p = iprh->next_pbuf; + clen = pbuf_clen(pcur); + LWIP_ASSERT("pbufs_freed + clen <= 0xffff", pbufs_freed + clen <= 0xffff); + pbufs_freed += clen; + pbuf_free(pcur); + } + /* Then, unchain the struct ip_reassdata from the list and free it. */ + ip_reass_dequeue_datagram(ipr, prev); + LWIP_ASSERT("ip_reass_pbufcount >= clen", ip_reass_pbufcount >= pbufs_freed); + ip_reass_pbufcount -= pbufs_freed; + + return pbufs_freed; +} + +#if IP_REASS_FREE_OLDEST +/** + * Free the oldest datagram to make room for enqueueing new fragments. + * The datagram 'fraghdr' belongs to is not freed! + * + * @param fraghdr IP header of the current fragment + * @param pbufs_needed number of pbufs needed to enqueue + * (used for freeing other datagrams if not enough space) + * @return the number of pbufs freed + */ +static int +ip_reass_remove_oldest_datagram(struct ip_hdr *fraghdr, int pbufs_needed) +{ + /* @todo Can't we simply remove the last datagram in the + * linked list behind reassdatagrams? + */ + struct ip_reassdata *r, *oldest, *prev, *oldest_prev; + int pbufs_freed = 0, pbufs_freed_current; + int other_datagrams; + + /* Free datagrams until being allowed to enqueue 'pbufs_needed' pbufs, + * but don't free the datagram that 'fraghdr' belongs to! */ + do { + oldest = NULL; + prev = NULL; + oldest_prev = NULL; + other_datagrams = 0; + r = reassdatagrams; + while (r != NULL) { + if (!IP_ADDRESSES_AND_ID_MATCH(&r->iphdr, fraghdr)) { + /* Not the same datagram as fraghdr */ + other_datagrams++; + if (oldest == NULL) { + oldest = r; + oldest_prev = prev; + } else if (r->timer <= oldest->timer) { + /* older than the previous oldest */ + oldest = r; + oldest_prev = prev; + } + } + if (r->next != NULL) { + prev = r; + } + r = r->next; + } + if (oldest != NULL) { + pbufs_freed_current = ip_reass_free_complete_datagram(oldest, oldest_prev); + pbufs_freed += pbufs_freed_current; + } + } while ((pbufs_freed < pbufs_needed) && (other_datagrams > 1)); + return pbufs_freed; +} +#endif /* IP_REASS_FREE_OLDEST */ + +/** + * Enqueues a new fragment into the fragment queue + * @param fraghdr points to the new fragments IP hdr + * @param clen number of pbufs needed to enqueue (used for freeing other datagrams if not enough space) + * @return A pointer to the queue location into which the fragment was enqueued + */ +static struct ip_reassdata* +ip_reass_enqueue_new_datagram(struct ip_hdr *fraghdr, int clen) +{ + struct ip_reassdata* ipr; +#if ! IP_REASS_FREE_OLDEST + LWIP_UNUSED_ARG(clen); +#endif + + /* No matching previous fragment found, allocate a new reassdata struct */ + ipr = (struct ip_reassdata *)memp_malloc(MEMP_REASSDATA); + if (ipr == NULL) { +#if IP_REASS_FREE_OLDEST + if (ip_reass_remove_oldest_datagram(fraghdr, clen) >= clen) { + ipr = (struct ip_reassdata *)memp_malloc(MEMP_REASSDATA); + } + if (ipr == NULL) +#endif /* IP_REASS_FREE_OLDEST */ + { + IPFRAG_STATS_INC(ip_frag.memerr); + LWIP_DEBUGF(IP_REASS_DEBUG,("Failed to alloc reassdata struct\n")); + return NULL; + } + } + memset(ipr, 0, sizeof(struct ip_reassdata)); + ipr->timer = IP_REASS_MAXAGE; + + /* enqueue the new structure to the front of the list */ + ipr->next = reassdatagrams; + reassdatagrams = ipr; + /* copy the ip header for later tests and input */ + /* @todo: no ip options supported? */ + SMEMCPY(&(ipr->iphdr), fraghdr, IP_HLEN); + return ipr; +} + +/** + * Dequeues a datagram from the datagram queue. Doesn't deallocate the pbufs. + * @param ipr points to the queue entry to dequeue + */ +static void +ip_reass_dequeue_datagram(struct ip_reassdata *ipr, struct ip_reassdata *prev) +{ + /* dequeue the reass struct */ + if (reassdatagrams == ipr) { + /* it was the first in the list */ + reassdatagrams = ipr->next; + } else { + /* it wasn't the first, so it must have a valid 'prev' */ + LWIP_ASSERT("sanity check linked list", prev != NULL); + prev->next = ipr->next; + } + + /* now we can free the ip_reassdata struct */ + memp_free(MEMP_REASSDATA, ipr); +} + +/** + * Chain a new pbuf into the pbuf list that composes the datagram. The pbuf list + * will grow over time as new pbufs are rx. + * Also checks that the datagram passes basic continuity checks (if the last + * fragment was received at least once). + * @param root_p points to the 'root' pbuf for the current datagram being assembled. + * @param new_p points to the pbuf for the current fragment + * @return 0 if invalid, >0 otherwise + */ +static int +ip_reass_chain_frag_into_datagram_and_validate(struct ip_reassdata *ipr, struct pbuf *new_p) +{ + struct ip_reass_helper *iprh, *iprh_tmp, *iprh_prev=NULL; + struct pbuf *q; + u16_t offset,len; + struct ip_hdr *fraghdr; + int valid = 1; + + /* Extract length and fragment offset from current fragment */ + fraghdr = (struct ip_hdr*)new_p->payload; + len = ntohs(IPH_LEN(fraghdr)) - IPH_HL(fraghdr) * 4; + offset = (ntohs(IPH_OFFSET(fraghdr)) & IP_OFFMASK) * 8; + + /* overwrite the fragment's ip header from the pbuf with our helper struct, + * and setup the embedded helper structure. */ + /* make sure the struct ip_reass_helper fits into the IP header */ + LWIP_ASSERT("sizeof(struct ip_reass_helper) <= IP_HLEN", + sizeof(struct ip_reass_helper) <= IP_HLEN); + iprh = (struct ip_reass_helper*)new_p->payload; + iprh->next_pbuf = NULL; + iprh->start = offset; + iprh->end = offset + len; + + /* Iterate through until we either get to the end of the list (append), + * or we find one with a larger offset (insert). */ + for (q = ipr->p; q != NULL;) { + iprh_tmp = (struct ip_reass_helper*)q->payload; + if (iprh->start < iprh_tmp->start) { + /* the new pbuf should be inserted before this */ + iprh->next_pbuf = q; + if (iprh_prev != NULL) { + /* not the fragment with the lowest offset */ +#if IP_REASS_CHECK_OVERLAP + if ((iprh->start < iprh_prev->end) || (iprh->end > iprh_tmp->start)) { + /* fragment overlaps with previous or following, throw away */ + goto freepbuf; + } +#endif /* IP_REASS_CHECK_OVERLAP */ + iprh_prev->next_pbuf = new_p; + } else { + /* fragment with the lowest offset */ + ipr->p = new_p; + } + break; + } else if (iprh->start == iprh_tmp->start) { + /* received the same datagram twice: no need to keep the datagram */ + goto freepbuf; +#if IP_REASS_CHECK_OVERLAP + } else if (iprh->start < iprh_tmp->end) { + /* overlap: no need to keep the new datagram */ + goto freepbuf; +#endif /* IP_REASS_CHECK_OVERLAP */ + } else { + /* Check if the fragments received so far have no holes. */ + if (iprh_prev != NULL) { + if (iprh_prev->end != iprh_tmp->start) { + /* There is a fragment missing between the current + * and the previous fragment */ + valid = 0; + } + } + } + q = iprh_tmp->next_pbuf; + iprh_prev = iprh_tmp; + } + + /* If q is NULL, then we made it to the end of the list. Determine what to do now */ + if (q == NULL) { + if (iprh_prev != NULL) { + /* this is (for now), the fragment with the highest offset: + * chain it to the last fragment */ +#if IP_REASS_CHECK_OVERLAP + LWIP_ASSERT("check fragments don't overlap", iprh_prev->end <= iprh->start); +#endif /* IP_REASS_CHECK_OVERLAP */ + iprh_prev->next_pbuf = new_p; + if (iprh_prev->end != iprh->start) { + valid = 0; + } + } else { +#if IP_REASS_CHECK_OVERLAP + LWIP_ASSERT("no previous fragment, this must be the first fragment!", + ipr->p == NULL); +#endif /* IP_REASS_CHECK_OVERLAP */ + /* this is the first fragment we ever received for this ip datagram */ + ipr->p = new_p; + } + } + + /* At this point, the validation part begins: */ + /* If we already received the last fragment */ + if ((ipr->flags & IP_REASS_FLAG_LASTFRAG) != 0) { + /* and had no holes so far */ + if (valid) { + /* then check if the rest of the fragments is here */ + /* Check if the queue starts with the first datagram */ + if ((ipr->p == NULL) || (((struct ip_reass_helper*)ipr->p->payload)->start != 0)) { + valid = 0; + } else { + /* and check that there are no holes after this datagram */ + iprh_prev = iprh; + q = iprh->next_pbuf; + while (q != NULL) { + iprh = (struct ip_reass_helper*)q->payload; + if (iprh_prev->end != iprh->start) { + valid = 0; + break; + } + iprh_prev = iprh; + q = iprh->next_pbuf; + } + /* if still valid, all fragments are received + * (because to the MF==0 already arrived */ + if (valid) { + LWIP_ASSERT("sanity check", ipr->p != NULL); + LWIP_ASSERT("sanity check", + ((struct ip_reass_helper*)ipr->p->payload) != iprh); + LWIP_ASSERT("validate_datagram:next_pbuf!=NULL", + iprh->next_pbuf == NULL); + LWIP_ASSERT("validate_datagram:datagram end!=datagram len", + iprh->end == ipr->datagram_len); + } + } + } + /* If valid is 0 here, there are some fragments missing in the middle + * (since MF == 0 has already arrived). Such datagrams simply time out if + * no more fragments are received... */ + return valid; + } + /* If we come here, not all fragments were received, yet! */ + return 0; /* not yet valid! */ +#if IP_REASS_CHECK_OVERLAP +freepbuf: + ip_reass_pbufcount -= pbuf_clen(new_p); + pbuf_free(new_p); + return 0; +#endif /* IP_REASS_CHECK_OVERLAP */ +} + +/** + * Reassembles incoming IP fragments into an IP datagram. + * + * @param p points to a pbuf chain of the fragment + * @return NULL if reassembly is incomplete, ? otherwise + */ +struct pbuf * +ip4_reass(struct pbuf *p) +{ + struct pbuf *r; + struct ip_hdr *fraghdr; + struct ip_reassdata *ipr; + struct ip_reass_helper *iprh; + u16_t offset, len; + u8_t clen; + + IPFRAG_STATS_INC(ip_frag.recv); + MIB2_STATS_INC(mib2.ipreasmreqds); + + fraghdr = (struct ip_hdr*)p->payload; + + if ((IPH_HL(fraghdr) * 4) != IP_HLEN) { + LWIP_DEBUGF(IP_REASS_DEBUG,("ip4_reass: IP options currently not supported!\n")); + IPFRAG_STATS_INC(ip_frag.err); + goto nullreturn; + } + + offset = (ntohs(IPH_OFFSET(fraghdr)) & IP_OFFMASK) * 8; + len = ntohs(IPH_LEN(fraghdr)) - IPH_HL(fraghdr) * 4; + + /* Check if we are allowed to enqueue more datagrams. */ + clen = pbuf_clen(p); + if ((ip_reass_pbufcount + clen) > IP_REASS_MAX_PBUFS) { +#if IP_REASS_FREE_OLDEST + if (!ip_reass_remove_oldest_datagram(fraghdr, clen) || + ((ip_reass_pbufcount + clen) > IP_REASS_MAX_PBUFS)) +#endif /* IP_REASS_FREE_OLDEST */ + { + /* No datagram could be freed and still too many pbufs enqueued */ + LWIP_DEBUGF(IP_REASS_DEBUG,("ip4_reass: Overflow condition: pbufct=%d, clen=%d, MAX=%d\n", + ip_reass_pbufcount, clen, IP_REASS_MAX_PBUFS)); + IPFRAG_STATS_INC(ip_frag.memerr); + /* @todo: send ICMP time exceeded here? */ + /* drop this pbuf */ + goto nullreturn; + } + } + + /* Look for the datagram the fragment belongs to in the current datagram queue, + * remembering the previous in the queue for later dequeueing. */ + for (ipr = reassdatagrams; ipr != NULL; ipr = ipr->next) { + /* Check if the incoming fragment matches the one currently present + in the reassembly buffer. If so, we proceed with copying the + fragment into the buffer. */ + if (IP_ADDRESSES_AND_ID_MATCH(&ipr->iphdr, fraghdr)) { + LWIP_DEBUGF(IP_REASS_DEBUG, ("ip4_reass: matching previous fragment ID=%"X16_F"\n", + ntohs(IPH_ID(fraghdr)))); + IPFRAG_STATS_INC(ip_frag.cachehit); + break; + } + } + + if (ipr == NULL) { + /* Enqueue a new datagram into the datagram queue */ + ipr = ip_reass_enqueue_new_datagram(fraghdr, clen); + /* Bail if unable to enqueue */ + if (ipr == NULL) { + goto nullreturn; + } + } else { + if (((ntohs(IPH_OFFSET(fraghdr)) & IP_OFFMASK) == 0) && + ((ntohs(IPH_OFFSET(&ipr->iphdr)) & IP_OFFMASK) != 0)) { + /* ipr->iphdr is not the header from the first fragment, but fraghdr is + * -> copy fraghdr into ipr->iphdr since we want to have the header + * of the first fragment (for ICMP time exceeded and later, for copying + * all options, if supported)*/ + SMEMCPY(&ipr->iphdr, fraghdr, IP_HLEN); + } + } + /* Track the current number of pbufs current 'in-flight', in order to limit + the number of fragments that may be enqueued at any one time */ + ip_reass_pbufcount += clen; + + /* At this point, we have either created a new entry or pointing + * to an existing one */ + + /* check for 'no more fragments', and update queue entry*/ + if ((IPH_OFFSET(fraghdr) & PP_NTOHS(IP_MF)) == 0) { + ipr->flags |= IP_REASS_FLAG_LASTFRAG; + ipr->datagram_len = offset + len; + LWIP_DEBUGF(IP_REASS_DEBUG, + ("ip4_reass: last fragment seen, total len %"S16_F"\n", + ipr->datagram_len)); + } + /* find the right place to insert this pbuf */ + /* @todo: trim pbufs if fragments are overlapping */ + if (ip_reass_chain_frag_into_datagram_and_validate(ipr, p)) { + struct ip_reassdata *ipr_prev; + /* the totally last fragment (flag more fragments = 0) was received at least + * once AND all fragments are received */ + ipr->datagram_len += IP_HLEN; + + /* save the second pbuf before copying the header over the pointer */ + r = ((struct ip_reass_helper*)ipr->p->payload)->next_pbuf; + + /* copy the original ip header back to the first pbuf */ + fraghdr = (struct ip_hdr*)(ipr->p->payload); + SMEMCPY(fraghdr, &ipr->iphdr, IP_HLEN); + IPH_LEN_SET(fraghdr, htons(ipr->datagram_len)); + IPH_OFFSET_SET(fraghdr, 0); + IPH_CHKSUM_SET(fraghdr, 0); + /* @todo: do we need to set/calculate the correct checksum? */ +#if CHECKSUM_GEN_IP + IF__NETIF_CHECKSUM_ENABLED(ip_current_input_netif(), NETIF_CHECKSUM_GEN_IP) { + IPH_CHKSUM_SET(fraghdr, inet_chksum(fraghdr, IP_HLEN)); + } +#endif /* CHECKSUM_GEN_IP */ + + p = ipr->p; + + /* chain together the pbufs contained within the reass_data list. */ + while (r != NULL) { + iprh = (struct ip_reass_helper*)r->payload; + + /* hide the ip header for every succeeding fragment */ + pbuf_header(r, -IP_HLEN); + pbuf_cat(p, r); + r = iprh->next_pbuf; + } + + /* find the previous entry in the linked list */ + if (ipr == reassdatagrams) { + ipr_prev = NULL; + } else { + for (ipr_prev = reassdatagrams; ipr_prev != NULL; ipr_prev = ipr_prev->next) { + if (ipr_prev->next == ipr) { + break; + } + } + } + + /* release the sources allocate for the fragment queue entry */ + ip_reass_dequeue_datagram(ipr, ipr_prev); + + /* and adjust the number of pbufs currently queued for reassembly. */ + ip_reass_pbufcount -= pbuf_clen(p); + + MIB2_STATS_INC(mib2.ipreasmoks); + + /* Return the pbuf chain */ + return p; + } + /* the datagram is not (yet?) reassembled completely */ + LWIP_DEBUGF(IP_REASS_DEBUG,("ip_reass_pbufcount: %d out\n", ip_reass_pbufcount)); + return NULL; + +nullreturn: + LWIP_DEBUGF(IP_REASS_DEBUG,("ip4_reass: nullreturn\n")); + IPFRAG_STATS_INC(ip_frag.drop); + pbuf_free(p); + return NULL; +} +#endif /* IP_REASSEMBLY */ + +#if IP_FRAG +#if IP_FRAG_USES_STATIC_BUF +static u8_t buf[LWIP_MEM_ALIGN_SIZE(IP_FRAG_MAX_MTU + MEM_ALIGNMENT - 1)]; +#else /* IP_FRAG_USES_STATIC_BUF */ + +#if !LWIP_NETIF_TX_SINGLE_PBUF +/** Allocate a new struct pbuf_custom_ref */ +static struct pbuf_custom_ref* +ip_frag_alloc_pbuf_custom_ref(void) +{ + return (struct pbuf_custom_ref*)memp_malloc(MEMP_FRAG_PBUF); +} + +/** Free a struct pbuf_custom_ref */ +static void +ip_frag_free_pbuf_custom_ref(struct pbuf_custom_ref* p) +{ + LWIP_ASSERT("p != NULL", p != NULL); + memp_free(MEMP_FRAG_PBUF, p); +} + +/** Free-callback function to free a 'struct pbuf_custom_ref', called by + * pbuf_free. */ +static void +ipfrag_free_pbuf_custom(struct pbuf *p) +{ + struct pbuf_custom_ref *pcr = (struct pbuf_custom_ref*)p; + LWIP_ASSERT("pcr != NULL", pcr != NULL); + LWIP_ASSERT("pcr == p", (void*)pcr == (void*)p); + if (pcr->original != NULL) { + pbuf_free(pcr->original); + } + ip_frag_free_pbuf_custom_ref(pcr); +} +#endif /* !LWIP_NETIF_TX_SINGLE_PBUF */ +#endif /* IP_FRAG_USES_STATIC_BUF */ + +/** + * Fragment an IP datagram if too large for the netif. + * + * Chop the datagram in MTU sized chunks and send them in order + * by using a fixed size static memory buffer (PBUF_REF) or + * point PBUF_REFs into p (depending on IP_FRAG_USES_STATIC_BUF). + * + * @param p ip packet to send + * @param netif the netif on which to send + * @param dest destination ip address to which to send + * + * @return ERR_OK if sent successfully, err_t otherwise + */ +err_t +ip4_frag(struct pbuf *p, struct netif *netif, const ip4_addr_t *dest) +{ + struct pbuf *rambuf; +#if IP_FRAG_USES_STATIC_BUF + struct pbuf *header; +#else +#if !LWIP_NETIF_TX_SINGLE_PBUF + struct pbuf *newpbuf; +#endif + struct ip_hdr *original_iphdr; +#endif + struct ip_hdr *iphdr; + u16_t nfb; + u16_t left, cop; + u16_t mtu = netif->mtu; + u16_t ofo, omf; + u16_t last; + u16_t poff = IP_HLEN; + u16_t tmp; +#if !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF + u16_t newpbuflen = 0; + u16_t left_to_copy; +#endif + + /* Get a RAM based MTU sized pbuf */ +#if IP_FRAG_USES_STATIC_BUF + /* When using a static buffer, we use a PBUF_REF, which we will + * use to reference the packet (without link header). + * Layer and length is irrelevant. + */ + rambuf = pbuf_alloc(PBUF_LINK, 0, PBUF_REF); + if (rambuf == NULL) { + LWIP_DEBUGF(IP_REASS_DEBUG, ("ip_frag: pbuf_alloc(PBUF_LINK, 0, PBUF_REF) failed\n")); + goto memerr; + } + rambuf->tot_len = rambuf->len = mtu; + rambuf->payload = LWIP_MEM_ALIGN((void *)buf); + + /* Copy the IP header in it */ + iphdr = (struct ip_hdr *)rambuf->payload; + SMEMCPY(iphdr, p->payload, IP_HLEN); +#else /* IP_FRAG_USES_STATIC_BUF */ + original_iphdr = (struct ip_hdr *)p->payload; + iphdr = original_iphdr; +#endif /* IP_FRAG_USES_STATIC_BUF */ + + /* Save original offset */ + tmp = ntohs(IPH_OFFSET(iphdr)); + ofo = tmp & IP_OFFMASK; + omf = tmp & IP_MF; + + left = p->tot_len - IP_HLEN; + + nfb = (mtu - IP_HLEN) / 8; + + while (left) { + last = (left <= mtu - IP_HLEN); + + /* Set new offset and MF flag */ + tmp = omf | (IP_OFFMASK & (ofo)); + if (!last) { + tmp = tmp | IP_MF; + } + + /* Fill this fragment */ + cop = last ? left : nfb * 8; + +#if IP_FRAG_USES_STATIC_BUF + poff += pbuf_copy_partial(p, (u8_t*)iphdr + IP_HLEN, cop, poff); +#else /* IP_FRAG_USES_STATIC_BUF */ +#if LWIP_NETIF_TX_SINGLE_PBUF + rambuf = pbuf_alloc(PBUF_IP, cop, PBUF_RAM); + if (rambuf == NULL) { + goto memerr; + } + LWIP_ASSERT("this needs a pbuf in one piece!", + (rambuf->len == rambuf->tot_len) && (rambuf->next == NULL)); + poff += pbuf_copy_partial(p, rambuf->payload, cop, poff); + /* make room for the IP header */ + if (pbuf_header(rambuf, IP_HLEN)) { + pbuf_free(rambuf); + goto memerr; + } + /* fill in the IP header */ + SMEMCPY(rambuf->payload, original_iphdr, IP_HLEN); + iphdr = (struct ip_hdr*)rambuf->payload; +#else /* LWIP_NETIF_TX_SINGLE_PBUF */ + /* When not using a static buffer, create a chain of pbufs. + * The first will be a PBUF_RAM holding the link and IP header. + * The rest will be PBUF_REFs mirroring the pbuf chain to be fragged, + * but limited to the size of an mtu. + */ + rambuf = pbuf_alloc(PBUF_LINK, IP_HLEN, PBUF_RAM); + if (rambuf == NULL) { + goto memerr; + } + LWIP_ASSERT("this needs a pbuf in one piece!", + (p->len >= (IP_HLEN))); + SMEMCPY(rambuf->payload, original_iphdr, IP_HLEN); + iphdr = (struct ip_hdr *)rambuf->payload; + + /* Can just adjust p directly for needed offset. */ + p->payload = (u8_t *)p->payload + poff; + p->len -= poff; + + left_to_copy = cop; + while (left_to_copy) { + struct pbuf_custom_ref *pcr; + newpbuflen = (left_to_copy < p->len) ? left_to_copy : p->len; + /* Is this pbuf already empty? */ + if (!newpbuflen) { + p = p->next; + continue; + } + pcr = ip_frag_alloc_pbuf_custom_ref(); + if (pcr == NULL) { + pbuf_free(rambuf); + goto memerr; + } + /* Mirror this pbuf, although we might not need all of it. */ + newpbuf = pbuf_alloced_custom(PBUF_RAW, newpbuflen, PBUF_REF, &pcr->pc, p->payload, newpbuflen); + if (newpbuf == NULL) { + ip_frag_free_pbuf_custom_ref(pcr); + pbuf_free(rambuf); + goto memerr; + } + pbuf_ref(p); + pcr->original = p; + pcr->pc.custom_free_function = ipfrag_free_pbuf_custom; + + /* Add it to end of rambuf's chain, but using pbuf_cat, not pbuf_chain + * so that it is removed when pbuf_dechain is later called on rambuf. + */ + pbuf_cat(rambuf, newpbuf); + left_to_copy -= newpbuflen; + if (left_to_copy) { + p = p->next; + } + } + poff = newpbuflen; +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ +#endif /* IP_FRAG_USES_STATIC_BUF */ + + /* Correct header */ + IPH_OFFSET_SET(iphdr, htons(tmp)); + IPH_LEN_SET(iphdr, htons(cop + IP_HLEN)); + IPH_CHKSUM_SET(iphdr, 0); +#if CHECKSUM_GEN_IP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_IP) { + IPH_CHKSUM_SET(iphdr, inet_chksum(iphdr, IP_HLEN)); + } +#endif /* CHECKSUM_GEN_IP */ + +#if IP_FRAG_USES_STATIC_BUF + if (last) { + pbuf_realloc(rambuf, left + IP_HLEN); + } + + /* This part is ugly: we alloc a RAM based pbuf for + * the link level header for each chunk and then + * free it. A PBUF_ROM style pbuf for which pbuf_header + * worked would make things simpler. + */ + header = pbuf_alloc(PBUF_LINK, 0, PBUF_RAM); + if (header != NULL) { + pbuf_chain(header, rambuf); + netif->output(netif, header, dest); + IPFRAG_STATS_INC(ip_frag.xmit); + MIB2_STATS_INC(mib2.ipfragcreates); + pbuf_free(header); + } else { + LWIP_DEBUGF(IP_REASS_DEBUG, ("ip_frag: pbuf_alloc() for header failed\n")); + pbuf_free(rambuf); + goto memerr; + } +#else /* IP_FRAG_USES_STATIC_BUF */ + /* No need for separate header pbuf - we allowed room for it in rambuf + * when allocated. + */ + netif->output(netif, rambuf, dest); + IPFRAG_STATS_INC(ip_frag.xmit); + + /* Unfortunately we can't reuse rambuf - the hardware may still be + * using the buffer. Instead we free it (and the ensuing chain) and + * recreate it next time round the loop. If we're lucky the hardware + * will have already sent the packet, the free will really free, and + * there will be zero memory penalty. + */ + + pbuf_free(rambuf); +#endif /* IP_FRAG_USES_STATIC_BUF */ + left -= cop; + ofo += nfb; + } +#if IP_FRAG_USES_STATIC_BUF + pbuf_free(rambuf); +#endif /* IP_FRAG_USES_STATIC_BUF */ + MIB2_STATS_INC(mib2.ipfragoks); + return ERR_OK; +memerr: + MIB2_STATS_INC(mib2.ipfragfails); + return ERR_MEM; +} +#endif /* IP_FRAG */ + +#endif /* LWIP_IPV4 */ diff --git a/components/lwip/core/ipv6/README b/components/lwip/core/ipv6/README new file mode 100755 index 000000000..362000486 --- /dev/null +++ b/components/lwip/core/ipv6/README @@ -0,0 +1 @@ +IPv6 support in lwIP is very experimental. diff --git a/components/lwip/core/ipv6/dhcp6.c b/components/lwip/core/ipv6/dhcp6.c new file mode 100755 index 000000000..f27a725e3 --- /dev/null +++ b/components/lwip/core/ipv6/dhcp6.c @@ -0,0 +1,50 @@ +/** + * @file + * + * DHCPv6. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 && LWIP_IPV6_DHCP6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/ip6_addr.h" +#include "lwip/def.h" + + +#endif /* LWIP_IPV6 && LWIP_IPV6_DHCP6 */ diff --git a/components/lwip/core/ipv6/ethip6.c b/components/lwip/core/ipv6/ethip6.c new file mode 100755 index 000000000..36aa9523e --- /dev/null +++ b/components/lwip/core/ipv6/ethip6.c @@ -0,0 +1,159 @@ +/** + * @file + * + * Ethernet output for IPv6. Uses ND tables for link-layer addressing. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 && LWIP_ETHERNET + +#include "lwip/ethip6.h" +#include "lwip/nd6.h" +#include "lwip/pbuf.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/icmp6.h" +#include "netif/ethernet.h" + +#include + +/** + * Send an IPv6 packet on the network using netif->linkoutput + * The ethernet header is filled in before sending. + * + * @params netif the lwIP network interface on which to send the packet + * @params p the packet to send, p->payload pointing to the (uninitialized) ethernet header + * @params src the source MAC address to be copied into the ethernet header + * @params dst the destination MAC address to be copied into the ethernet header + * @return ERR_OK if the packet was sent, any other err_t on failure + */ +static err_t +ethip6_send(struct netif *netif, struct pbuf *p, struct eth_addr *src, struct eth_addr *dst) +{ + struct eth_hdr *ethhdr = (struct eth_hdr *)p->payload; + + LWIP_ASSERT("netif->hwaddr_len must be 6 for ethip6!", + (netif->hwaddr_len == 6)); + SMEMCPY(ðhdr->dest, dst, 6); + SMEMCPY(ðhdr->src, src, 6); + ethhdr->type = PP_HTONS(ETHTYPE_IPV6); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("ethip6_send: sending packet %p\n", (void *)p)); + /* send the packet */ + return netif->linkoutput(netif, p); +} + +/** + * Resolve and fill-in Ethernet address header for outgoing IPv6 packet. + * + * For IPv6 multicast, corresponding Ethernet addresses + * are selected and the packet is transmitted on the link. + * + * For unicast addresses, ... + * + * @TODO anycast addresses + * + * @param netif The lwIP network interface which the IP packet will be sent on. + * @param q The pbuf(s) containing the IP packet to be sent. + * @param ip6addr The IP address of the packet destination. + * + * @return + * - ERR_RTE No route to destination (no gateway to external networks), + * or the return type of either etharp_query() or etharp_send_ip(). + */ +err_t +ethip6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr) +{ + struct eth_addr dest; + s8_t i; + + /* make room for Ethernet header - should not fail */ + if (pbuf_header(q, sizeof(struct eth_hdr)) != 0) { + /* bail out */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("etharp_output: could not allocate room for header.\n")); + return ERR_BUF; + } + + /* multicast destination IP address? */ + if (ip6_addr_ismulticast(ip6addr)) { + /* Hash IP multicast address to MAC address.*/ + dest.addr[0] = 0x33; + dest.addr[1] = 0x33; + dest.addr[2] = ((const u8_t *)(&(ip6addr->addr[3])))[0]; + dest.addr[3] = ((const u8_t *)(&(ip6addr->addr[3])))[1]; + dest.addr[4] = ((const u8_t *)(&(ip6addr->addr[3])))[2]; + dest.addr[5] = ((const u8_t *)(&(ip6addr->addr[3])))[3]; + + /* Send out. */ + return ethip6_send(netif, q, (struct eth_addr*)(netif->hwaddr), &dest); + } + + /* We have a unicast destination IP address */ + /* TODO anycast? */ + /* Get next hop record. */ + i = nd6_get_next_hop_entry(ip6addr, netif); + if (i < 0) { + /* failed to get a next hop neighbor record. */ + return ERR_MEM; + } + + /* Now that we have a destination record, send or queue the packet. */ + if (neighbor_cache[i].state == ND6_STALE) { + /* Switch to delay state. */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + /* TODO should we send or queue if PROBE? send for now, to let unicast NS pass. */ + if ((neighbor_cache[i].state == ND6_REACHABLE) || + (neighbor_cache[i].state == ND6_DELAY) || + (neighbor_cache[i].state == ND6_PROBE)) { + + /* Send out. */ + SMEMCPY(dest.addr, neighbor_cache[i].lladdr, 6); + return ethip6_send(netif, q, (struct eth_addr*)(netif->hwaddr), &dest); + } + + /* We should queue packet on this interface. */ + pbuf_header(q, -(s16_t)SIZEOF_ETH_HDR); + return nd6_queue_packet(i, q); +} + +#endif /* LWIP_IPV6 && LWIP_ETHERNET */ diff --git a/components/lwip/core/ipv6/icmp6.c b/components/lwip/core/ipv6/icmp6.c new file mode 100755 index 000000000..0a17da33e --- /dev/null +++ b/components/lwip/core/ipv6/icmp6.c @@ -0,0 +1,353 @@ +/** + * @file + * + * IPv6 version of ICMP, as per RFC 4443. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_ICMP6 && LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/icmp6.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#include "lwip/pbuf.h" +#include "lwip/netif.h" +#include "lwip/nd6.h" +#include "lwip/mld6.h" +#include "lwip/ip.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#ifndef LWIP_ICMP6_DATASIZE +#define LWIP_ICMP6_DATASIZE 8 +#endif +#if LWIP_ICMP6_DATASIZE == 0 +#define LWIP_ICMP6_DATASIZE 8 +#endif + +/* Forward declarations */ +static void icmp6_send_response(struct pbuf *p, u8_t code, u32_t data, u8_t type); + + +/** + * Process an input ICMPv6 message. Called by ip6_input. + * + * Will generate a reply for echo requests. Other messages are forwarded + * to nd6_input, or mld6_input. + * + * @param p the mld packet, p->payload pointing to the icmpv6 header + * @param inp the netif on which this packet was received + */ +void +icmp6_input(struct pbuf *p, struct netif *inp) +{ + struct icmp6_hdr *icmp6hdr; + struct pbuf * r; + const ip6_addr_t * reply_src; + + ICMP6_STATS_INC(icmp6.recv); + + /* Check that ICMPv6 header fits in payload */ + if (p->len < sizeof(struct icmp6_hdr)) { + /* drop short packets */ + pbuf_free(p); + ICMP6_STATS_INC(icmp6.lenerr); + ICMP6_STATS_INC(icmp6.drop); + return; + } + + icmp6hdr = (struct icmp6_hdr *)p->payload; + +#if CHECKSUM_CHECK_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_CHECK_ICMP6) { + if (ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->tot_len, ip6_current_src_addr(), + ip6_current_dest_addr()) != 0) { + /* Checksum failed */ + pbuf_free(p); + ICMP6_STATS_INC(icmp6.chkerr); + ICMP6_STATS_INC(icmp6.drop); + return; + } + } +#endif /* CHECKSUM_CHECK_ICMP6 */ + + switch (icmp6hdr->type) { + case ICMP6_TYPE_NA: /* Neighbor advertisement */ + case ICMP6_TYPE_NS: /* Neighbor solicitation */ + case ICMP6_TYPE_RA: /* Router advertisement */ + case ICMP6_TYPE_RD: /* Redirect */ + case ICMP6_TYPE_PTB: /* Packet too big */ + nd6_input(p, inp); + return; + break; + case ICMP6_TYPE_RS: +#if LWIP_IPV6_FORWARD + /* TODO implement router functionality */ +#endif + break; +#if LWIP_IPV6_MLD + case ICMP6_TYPE_MLQ: + case ICMP6_TYPE_MLR: + case ICMP6_TYPE_MLD: + mld6_input(p, inp); + return; + break; +#endif + case ICMP6_TYPE_EREQ: +#if !LWIP_MULTICAST_PING + /* multicast destination address? */ + if (ip6_addr_ismulticast(ip6_current_dest_addr())) { + /* drop */ + pbuf_free(p); + ICMP6_STATS_INC(icmp6.drop); + return; + } +#endif /* LWIP_MULTICAST_PING */ + + /* Allocate reply. */ + r = pbuf_alloc(PBUF_IP, p->tot_len, PBUF_RAM); + if (r == NULL) { + /* drop */ + pbuf_free(p); + ICMP6_STATS_INC(icmp6.memerr); + return; + } + + /* Copy echo request. */ + if (pbuf_copy(r, p) != ERR_OK) { + /* drop */ + pbuf_free(p); + pbuf_free(r); + ICMP6_STATS_INC(icmp6.err); + return; + } + + /* Determine reply source IPv6 address. */ +#if LWIP_MULTICAST_PING + if (ip6_addr_ismulticast(ip6_current_dest_addr())) { + reply_src = ip_2_ip6(ip6_select_source_address(inp, ip6_current_src_addr())); + if (reply_src == NULL) { + /* drop */ + pbuf_free(p); + pbuf_free(r); + ICMP6_STATS_INC(icmp6.rterr); + return; + } + } + else +#endif /* LWIP_MULTICAST_PING */ + { + reply_src = ip6_current_dest_addr(); + } + + /* Set fields in reply. */ + ((struct icmp6_echo_hdr *)(r->payload))->type = ICMP6_TYPE_EREP; + ((struct icmp6_echo_hdr *)(r->payload))->chksum = 0; +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_GEN_ICMP6) { + ((struct icmp6_echo_hdr *)(r->payload))->chksum = ip6_chksum_pseudo(r, + IP6_NEXTH_ICMP6, r->tot_len, reply_src, ip6_current_src_addr()); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + /* Send reply. */ + ICMP6_STATS_INC(icmp6.xmit); + ip6_output_if(r, reply_src, ip6_current_src_addr(), + LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, inp); + pbuf_free(r); + + break; + default: + ICMP6_STATS_INC(icmp6.proterr); + ICMP6_STATS_INC(icmp6.drop); + break; + } + + pbuf_free(p); +} + + +/** + * Send an icmpv6 'destination unreachable' packet. + * + * @param p the input packet for which the 'unreachable' should be sent, + * p->payload pointing to the IPv6 header + * @param c ICMPv6 code for the unreachable type + */ +void +icmp6_dest_unreach(struct pbuf *p, enum icmp6_dur_code c) +{ + icmp6_send_response(p, c, 0, ICMP6_TYPE_DUR); +} + +/** + * Send an icmpv6 'packet too big' packet. + * + * @param p the input packet for which the 'packet too big' should be sent, + * p->payload pointing to the IPv6 header + * @param mtu the maximum mtu that we can accept + */ +void +icmp6_packet_too_big(struct pbuf *p, u32_t mtu) +{ + icmp6_send_response(p, 0, mtu, ICMP6_TYPE_PTB); +} + +/** + * Send an icmpv6 'time exceeded' packet. + * + * @param p the input packet for which the 'unreachable' should be sent, + * p->payload pointing to the IPv6 header + * @param c ICMPv6 code for the time exceeded type + */ +void +icmp6_time_exceeded(struct pbuf *p, enum icmp6_te_code c) +{ + icmp6_send_response(p, c, 0, ICMP6_TYPE_TE); +} + +/** + * Send an icmpv6 'parameter problem' packet. + * + * @param p the input packet for which the 'param problem' should be sent, + * p->payload pointing to the IP header + * @param c ICMPv6 code for the param problem type + * @param pointer the pointer to the byte where the parameter is found + */ +void +icmp6_param_problem(struct pbuf *p, enum icmp6_pp_code c, u32_t pointer) +{ + icmp6_send_response(p, c, pointer, ICMP6_TYPE_PP); +} + +/** + * Send an ICMPv6 packet in response to an incoming packet. + * + * @param p the input packet for which the response should be sent, + * p->payload pointing to the IPv6 header + * @param code Code of the ICMPv6 header + * @param data Additional 32-bit parameter in the ICMPv6 header + * @param type Type of the ICMPv6 header + */ +static void +icmp6_send_response(struct pbuf *p, u8_t code, u32_t data, u8_t type) +{ + struct pbuf *q; + struct icmp6_hdr *icmp6hdr; + const ip6_addr_t *reply_src; + ip6_addr_t *reply_dest; + ip6_addr_t reply_src_local, reply_dest_local; + struct ip6_hdr *ip6hdr; + struct netif *netif; + + /* ICMPv6 header + IPv6 header + data */ + q = pbuf_alloc(PBUF_IP, sizeof(struct icmp6_hdr) + IP6_HLEN + LWIP_ICMP6_DATASIZE, + PBUF_RAM); + if (q == NULL) { + LWIP_DEBUGF(ICMP_DEBUG, ("icmp_time_exceeded: failed to allocate pbuf for ICMPv6 packet.\n")); + ICMP6_STATS_INC(icmp6.memerr); + return; + } + LWIP_ASSERT("check that first pbuf can hold icmp 6message", + (q->len >= (sizeof(struct icmp6_hdr) + IP6_HLEN + LWIP_ICMP6_DATASIZE))); + + icmp6hdr = (struct icmp6_hdr *)q->payload; + icmp6hdr->type = type; + icmp6hdr->code = code; + icmp6hdr->data = data; + + /* copy fields from original packet */ + SMEMCPY((u8_t *)q->payload + sizeof(struct icmp6_hdr), (u8_t *)p->payload, + IP6_HLEN + LWIP_ICMP6_DATASIZE); + + /* Get the destination address and netif for this ICMP message. */ + if ((ip_current_netif() == NULL) || + ((code == ICMP6_TE_FRAG) && (type == ICMP6_TYPE_TE))) { + /* Special case, as ip6_current_xxx is either NULL, or points + * to a different packet than the one that expired. + * We must use the addresses that are stored in the expired packet. */ + ip6hdr = (struct ip6_hdr *)p->payload; + /* copy from packed address to aligned address */ + ip6_addr_copy(reply_dest_local, ip6hdr->src); + ip6_addr_copy(reply_src_local, ip6hdr->dest); + reply_dest = &reply_dest_local; + reply_src = &reply_src_local; + netif = ip6_route(reply_src, reply_dest); + if (netif == NULL) { + /* drop */ + pbuf_free(q); + ICMP6_STATS_INC(icmp6.rterr); + return; + } + } + else { + netif = ip_current_netif(); + reply_dest = ip6_current_src_addr(); + + /* Select an address to use as source. */ + reply_src = ip_2_ip6(ip6_select_source_address(netif, reply_dest)); + if (reply_src == NULL) { + /* drop */ + pbuf_free(q); + ICMP6_STATS_INC(icmp6.rterr); + return; + } + } + + /* calculate checksum */ + icmp6hdr->chksum = 0; +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP6) { + icmp6hdr->chksum = ip6_chksum_pseudo(q, IP6_NEXTH_ICMP6, q->tot_len, + reply_src, reply_dest); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + ICMP6_STATS_INC(icmp6.xmit); + ip6_output_if(q, reply_src, reply_dest, LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, netif); + pbuf_free(q); +} + +#endif /* LWIP_ICMP6 && LWIP_IPV6 */ diff --git a/components/lwip/core/ipv6/inet6.c b/components/lwip/core/ipv6/inet6.c new file mode 100755 index 000000000..d9a992c22 --- /dev/null +++ b/components/lwip/core/ipv6/inet6.c @@ -0,0 +1,53 @@ +/** + * @file + * + * INET v6 addresses. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 && LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/inet.h" + +/** This variable is initialized by the system to contain the wildcard IPv6 address. + */ +const struct in6_addr in6addr_any = IN6ADDR_ANY_INIT; + +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/ipv6/ip6.c b/components/lwip/core/ipv6/ip6.c new file mode 100755 index 000000000..056d33355 --- /dev/null +++ b/components/lwip/core/ipv6/ip6.c @@ -0,0 +1,1104 @@ +/** + * @file + * + * IPv6 layer. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/netif.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/ip6_frag.h" +#include "lwip/icmp6.h" +#include "lwip/raw.h" +#include "lwip/udp.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/dhcp6.h" +#include "lwip/nd6.h" +#include "lwip/mld6.h" +#include "lwip/debug.h" +#include "lwip/stats.h" + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/** + * Finds the appropriate network interface for a given IPv6 address. It tries to select + * a netif following a sequence of heuristics: + * 1) if there is only 1 netif, return it + * 2) if the destination is a link-local address, try to match the src address to a netif. + * this is a tricky case because with multiple netifs, link-local addresses only have + * meaning within a particular subnet/link. + * 3) tries to match the destination subnet to a configured address + * 4) tries to find a router + * 5) tries to match the source address to the netif + * 6) returns the default netif, if configured + * + * @param src the source IPv6 address, if known + * @param dest the destination IPv6 address for which to find the route + * @return the netif on which to send to reach dest + */ +struct netif * +ip6_route(const ip6_addr_t *src, const ip6_addr_t *dest) +{ + struct netif *netif; + s8_t i; + + /* If single netif configuration, fast return. */ + if ((netif_list != NULL) && (netif_list->next == NULL)) { + if (!netif_is_up(netif_list) || !netif_is_link_up(netif_list)) { + return NULL; + } + return netif_list; + } + + /* Special processing for link-local addresses. */ + if (ip6_addr_islinklocal(dest)) { + if (ip6_addr_isany(src)) { + /* Use default netif, if Up. */ + if (!netif_is_up(netif_default) || !netif_is_link_up(netif_default)) { + return NULL; + } + return netif_default; + } + + /* Try to find the netif for the source address, checking that link is up. */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (!netif_is_up(netif) || !netif_is_link_up(netif)) { + continue; + } + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_cmp(src, netif_ip6_addr(netif, i))) { + return netif; + } + } + } + + /* netif not found, use default netif, if up */ + if (!netif_is_up(netif_default) || !netif_is_link_up(netif_default)) { + return NULL; + } + return netif_default; + } + + /* we come here for non-link-local addresses */ +#ifdef LWIP_HOOK_IP6_ROUTE + netif = LWIP_HOOK_IP6_ROUTE(src, dest); + if (netif != NULL) { + return netif; + } +#endif + + /* See if the destination subnet matches a configured address. */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (!netif_is_up(netif) || !netif_is_link_up(netif)) { + continue; + } + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_netcmp(dest, netif_ip6_addr(netif, i))) { + return netif; + } + } + } + + /* Get the netif for a suitable router. */ + i = nd6_select_router(dest, NULL); + if (i >= 0) { + if (default_router_list[i].neighbor_entry != NULL) { + if (default_router_list[i].neighbor_entry->netif != NULL) { + if (netif_is_up(default_router_list[i].neighbor_entry->netif) && netif_is_link_up(default_router_list[i].neighbor_entry->netif)) { + return default_router_list[i].neighbor_entry->netif; + } + } + } + } + + /* try with the netif that matches the source address. */ + if (!ip6_addr_isany(src)) { + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (!netif_is_up(netif) || !netif_is_link_up(netif)) { + continue; + } + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_cmp(src, netif_ip6_addr(netif, i))) { + return netif; + } + } + } + } + +#if LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF + /* loopif is disabled, loopback traffic is passed through any netif */ + if (ip6_addr_isloopback(dest)) { + /* don't check for link on loopback traffic */ + if (netif_is_up(netif_default)) { + return netif_default; + } + /* default netif is not up, just use any netif for loopback traffic */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (netif_is_up(netif)) { + return netif; + } + } + return NULL; + } +#endif /* LWIP_NETIF_LOOPBACK && !LWIP_HAVE_LOOPIF */ + + /* no matching netif found, use default netif, if up */ + if ((netif_default == NULL) || !netif_is_up(netif_default) || !netif_is_link_up(netif_default)) { + return NULL; + } + return netif_default; +} + +/** + * Select the best IPv6 source address for a given destination + * IPv6 address. Loosely follows RFC 3484. "Strong host" behavior + * is assumed. + * + * @param netif the netif on which to send a packet + * @param dest the destination we are trying to reach + * @return the most suitable source address to use, or NULL if no suitable + * source address is found + */ +const ip_addr_t * +ip6_select_source_address(struct netif *netif, const ip6_addr_t * dest) +{ + const ip_addr_t *src = NULL; + u8_t i; + + /* If dest is link-local, choose a link-local source. */ + if (ip6_addr_islinklocal(dest) || ip6_addr_ismulticast_linklocal(dest) || ip6_addr_ismulticast_iflocal(dest)) { + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_islinklocal(netif_ip6_addr(netif, i))) { + return netif_ip_addr6(netif, i); + } + } + } + + /* Choose a site-local with matching prefix. */ + if (ip6_addr_issitelocal(dest) || ip6_addr_ismulticast_sitelocal(dest)) { + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_issitelocal(netif_ip6_addr(netif, i)) && + ip6_addr_netcmp(dest, netif_ip6_addr(netif, i))) { + return netif_ip_addr6(netif, i); + } + } + } + + /* Choose a unique-local with matching prefix. */ + if (ip6_addr_isuniquelocal(dest) || ip6_addr_ismulticast_orglocal(dest)) { + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_isuniquelocal(netif_ip6_addr(netif, i)) && + ip6_addr_netcmp(dest, netif_ip6_addr(netif, i))) { + return netif_ip_addr6(netif, i); + } + } + } + + /* Choose a global with best matching prefix. */ + if (ip6_addr_isglobal(dest) || ip6_addr_ismulticast_global(dest)) { + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_isglobal(netif_ip6_addr(netif, i))) { + if (src == NULL) { + src = netif_ip_addr6(netif, i); + } + else { + /* Replace src only if we find a prefix match. */ + /* TODO find longest matching prefix. */ + if ((!(ip6_addr_netcmp(ip_2_ip6(src), dest))) && + ip6_addr_netcmp(netif_ip6_addr(netif, i), dest)) { + src = netif_ip_addr6(netif, i); + } + } + } + } + if (src != NULL) { + return src; + } + } + + /* Last resort: see if arbitrary prefix matches. */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_netcmp(dest, netif_ip6_addr(netif, i))) { + return netif_ip_addr6(netif, i); + } + } + + return NULL; +} + +#if LWIP_IPV6_FORWARD +/** + * Forwards an IPv6 packet. It finds an appropriate route for the + * packet, decrements the HL value of the packet, and outputs + * the packet on the appropriate interface. + * + * @param p the packet to forward (p->payload points to IP header) + * @param iphdr the IPv6 header of the input packet + * @param inp the netif on which this packet was received + */ +static void +ip6_forward(struct pbuf *p, struct ip6_hdr *iphdr, struct netif *inp) +{ + struct netif *netif; + + /* do not forward link-local addresses */ + if (ip6_addr_islinklocal(ip6_current_dest_addr())) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_forward: not forwarding link-local address.\n")); + IP6_STATS_INC(ip6.rterr); + IP6_STATS_INC(ip6.drop); + return; + } + + /* Find network interface where to forward this IP packet to. */ + netif = ip6_route(IP6_ADDR_ANY6, ip6_current_dest_addr()); + if (netif == NULL) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_forward: no route for %"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F"\n", + IP6_ADDR_BLOCK1(ip6_current_dest_addr()), + IP6_ADDR_BLOCK2(ip6_current_dest_addr()), + IP6_ADDR_BLOCK3(ip6_current_dest_addr()), + IP6_ADDR_BLOCK4(ip6_current_dest_addr()), + IP6_ADDR_BLOCK5(ip6_current_dest_addr()), + IP6_ADDR_BLOCK6(ip6_current_dest_addr()), + IP6_ADDR_BLOCK7(ip6_current_dest_addr()), + IP6_ADDR_BLOCK8(ip6_current_dest_addr()))); +#if LWIP_ICMP6 + /* Don't send ICMP messages in response to ICMP messages */ + if (IP6H_NEXTH(iphdr) != IP6_NEXTH_ICMP6) { + icmp6_dest_unreach(p, ICMP6_DUR_NO_ROUTE); + } +#endif /* LWIP_ICMP6 */ + IP6_STATS_INC(ip6.rterr); + IP6_STATS_INC(ip6.drop); + return; + } + /* Do not forward packets onto the same network interface on which + * they arrived. */ + if (netif == inp) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_forward: not bouncing packets back on incoming interface.\n")); + IP6_STATS_INC(ip6.rterr); + IP6_STATS_INC(ip6.drop); + return; + } + + /* decrement HL */ + IP6H_HOPLIM_SET(iphdr, IP6H_HOPLIM(iphdr) - 1); + /* send ICMP6 if HL == 0 */ + if (IP6H_HOPLIM(iphdr) == 0) { +#if LWIP_ICMP6 + /* Don't send ICMP messages in response to ICMP messages */ + if (IP6H_NEXTH(iphdr) != IP6_NEXTH_ICMP6) { + icmp6_time_exceeded(p, ICMP6_TE_HL); + } +#endif /* LWIP_ICMP6 */ + IP6_STATS_INC(ip6.drop); + return; + } + + if (netif->mtu && (p->tot_len > netif->mtu)) { +#if LWIP_ICMP6 + /* Don't send ICMP messages in response to ICMP messages */ + if (IP6H_NEXTH(iphdr) != IP6_NEXTH_ICMP6) { + icmp6_packet_too_big(p, netif->mtu); + } +#endif /* LWIP_ICMP6 */ + IP6_STATS_INC(ip6.drop); + return; + } + + LWIP_DEBUGF(IP6_DEBUG, ("ip6_forward: forwarding packet to %"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F"\n", + IP6_ADDR_BLOCK1(ip6_current_dest_addr()), + IP6_ADDR_BLOCK2(ip6_current_dest_addr()), + IP6_ADDR_BLOCK3(ip6_current_dest_addr()), + IP6_ADDR_BLOCK4(ip6_current_dest_addr()), + IP6_ADDR_BLOCK5(ip6_current_dest_addr()), + IP6_ADDR_BLOCK6(ip6_current_dest_addr()), + IP6_ADDR_BLOCK7(ip6_current_dest_addr()), + IP6_ADDR_BLOCK8(ip6_current_dest_addr()))); + + /* transmit pbuf on chosen interface */ + netif->output_ip6(netif, p, ip6_current_dest_addr()); + IP6_STATS_INC(ip6.fw); + IP6_STATS_INC(ip6.xmit); + return; +} +#endif /* LWIP_IPV6_FORWARD */ + +/** + * This function is called by the network interface device driver when + * an IPv6 packet is received. The function does the basic checks of the + * IP header such as packet size being at least larger than the header + * size etc. If the packet was not destined for us, the packet is + * forwarded (using ip6_forward). + * + * Finally, the packet is sent to the upper layer protocol input function. + * + * @param p the received IPv6 packet (p->payload points to IPv6 header) + * @param inp the netif on which this packet was received + * @return ERR_OK if the packet was processed (could return ERR_* if it wasn't + * processed, but currently always returns ERR_OK) + */ +err_t +ip6_input(struct pbuf *p, struct netif *inp) +{ + struct ip6_hdr *ip6hdr; + struct netif *netif; + u8_t nexth; + u16_t hlen; /* the current header length */ + u8_t i; +#if 0 /*IP_ACCEPT_LINK_LAYER_ADDRESSING*/ + @todo + int check_ip_src=1; +#endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING */ + + IP6_STATS_INC(ip6.recv); + + /* identify the IP header */ + ip6hdr = (struct ip6_hdr *)p->payload; + if (IP6H_V(ip6hdr) != 6) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_WARNING, ("IPv6 packet dropped due to bad version number %"U32_F"\n", + IP6H_V(ip6hdr))); + pbuf_free(p); + IP6_STATS_INC(ip6.err); + IP6_STATS_INC(ip6.drop); + return ERR_OK; + } + +#ifdef LWIP_HOOK_IP6_INPUT + if (LWIP_HOOK_IP6_INPUT(p, inp)) { + /* the packet has been eaten */ + return ERR_OK; + } +#endif + + /* header length exceeds first pbuf length, or ip length exceeds total pbuf length? */ + if ((IP6_HLEN > p->len) || ((IP6H_PLEN(ip6hdr) + IP6_HLEN) > p->tot_len)) { + if (IP6_HLEN > p->len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 header (len %"U16_F") does not fit in first pbuf (len %"U16_F"), IP packet dropped.\n", + IP6_HLEN, p->len)); + } + if ((IP6H_PLEN(ip6hdr) + IP6_HLEN) > p->tot_len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 (plen %"U16_F") is longer than pbuf (len %"U16_F"), IP packet dropped.\n", + IP6H_PLEN(ip6hdr) + IP6_HLEN, p->tot_len)); + } + /* free (drop) packet pbufs */ + pbuf_free(p); + IP6_STATS_INC(ip6.lenerr); + IP6_STATS_INC(ip6.drop); + return ERR_OK; + } + + /* Trim pbuf. This should have been done at the netif layer, + * but we'll do it anyway just to be sure that its done. */ + pbuf_realloc(p, IP6_HLEN + IP6H_PLEN(ip6hdr)); + + /* copy IP addresses to aligned ip6_addr_t */ + ip_addr_copy_from_ip6(ip_data.current_iphdr_dest, ip6hdr->dest); + ip_addr_copy_from_ip6(ip_data.current_iphdr_src, ip6hdr->src); + + /* current header pointer. */ + ip_data.current_ip6_header = ip6hdr; + + /* In netif, used in case we need to send ICMPv6 packets back. */ + ip_data.current_netif = inp; + ip_data.current_input_netif = inp; + + /* match packet against an interface, i.e. is this packet for us? */ + if (ip6_addr_ismulticast(ip6_current_dest_addr())) { + /* Always joined to multicast if-local and link-local all-nodes group. */ + if (ip6_addr_isallnodes_iflocal(ip6_current_dest_addr()) || + ip6_addr_isallnodes_linklocal(ip6_current_dest_addr())) { + netif = inp; + } +#if LWIP_IPV6_MLD + else if (mld6_lookfor_group(inp, ip6_current_dest_addr())) { + netif = inp; + } +#else /* LWIP_IPV6_MLD */ + else if (ip6_addr_issolicitednode(ip6_current_dest_addr())) { + /* Filter solicited node packets when MLD is not enabled + * (for Neighbor discovery). */ + netif = NULL; + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(inp, i)) && + ip6_addr_cmp_solicitednode(ip6_current_dest_addr(), netif_ip6_addr(inp, i))) { + netif = inp; + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: solicited node packet accepted on interface %c%c\n", + netif->name[0], netif->name[1])); + break; + } + } + } +#endif /* LWIP_IPV6_MLD */ + else { + netif = NULL; + } + } else { + /* start trying with inp. if that's not acceptable, start walking the + list of configured netifs. + 'first' is used as a boolean to mark whether we started walking the list */ + int first = 1; + netif = inp; + do { + /* interface is up? */ + if (netif_is_up(netif)) { + /* unicast to this interface address? address configured? */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_cmp(ip6_current_dest_addr(), netif_ip6_addr(netif, i))) { + /* exit outer loop */ + goto netif_found; + } + } + } + if (ip6_addr_islinklocal(ip6_current_dest_addr())) { + /* Do not match link-local addresses to other netifs. */ + netif = NULL; + break; + } + if (first) { + first = 0; + netif = netif_list; + } else { + netif = netif->next; + } + if (netif == inp) { + netif = netif->next; + } + } while (netif != NULL); +netif_found: + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet accepted on interface %c%c\n", + netif ? netif->name[0] : 'X', netif? netif->name[1] : 'X')); + } + + /* "::" packet source address? (used in duplicate address detection) */ + if (ip6_addr_isany(ip6_current_src_addr()) && + (!ip6_addr_issolicitednode(ip6_current_dest_addr()))) { + /* packet source is not valid */ + /* free (drop) packet pbufs */ + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with src ANY_ADDRESS dropped\n")); + pbuf_free(p); + IP6_STATS_INC(ip6.drop); + goto ip6_input_cleanup; + } + + /* packet not for us? */ + if (netif == NULL) { + /* packet not for us, route or discard */ + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_TRACE, ("ip6_input: packet not for us.\n")); +#if LWIP_IPV6_FORWARD + /* non-multicast packet? */ + if (!ip6_addr_ismulticast(ip6_current_dest_addr())) { + /* try to forward IP packet on (other) interfaces */ + ip6_forward(p, ip6hdr, inp); + } +#endif /* LWIP_IPV6_FORWARD */ + pbuf_free(p); + goto ip6_input_cleanup; + } + + /* current netif pointer. */ + ip_data.current_netif = netif; + + /* Save next header type. */ + nexth = IP6H_NEXTH(ip6hdr); + + /* Init header length. */ + hlen = ip_data.current_ip_header_tot_len = IP6_HLEN; + + /* Move to payload. */ + pbuf_header(p, -IP6_HLEN); + + /* Process known option extension headers, if present. */ + while (nexth != IP6_NEXTH_NONE) + { + switch (nexth) { + case IP6_NEXTH_HOPBYHOP: + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with Hop-by-Hop options header\n")); + /* Get next header type. */ + nexth = *((u8_t *)p->payload); + + /* Get the header length. */ + hlen = 8 * (1 + *((u8_t *)p->payload + 1)); + ip_data.current_ip_header_tot_len += hlen; + + /* Skip over this header. */ + if (hlen > p->len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 options header (hlen %"U16_F") does not fit in first pbuf (len %"U16_F"), IPv6 packet dropped.\n", + hlen, p->len)); + /* free (drop) packet pbufs */ + pbuf_free(p); + IP6_STATS_INC(ip6.lenerr); + IP6_STATS_INC(ip6.drop); + goto ip6_input_cleanup; + } + + pbuf_header(p, -(s16_t)hlen); + break; + case IP6_NEXTH_DESTOPTS: + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with Destination options header\n")); + /* Get next header type. */ + nexth = *((u8_t *)p->payload); + + /* Get the header length. */ + hlen = 8 * (1 + *((u8_t *)p->payload + 1)); + ip_data.current_ip_header_tot_len += hlen; + + /* Skip over this header. */ + if (hlen > p->len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 options header (hlen %"U16_F") does not fit in first pbuf (len %"U16_F"), IPv6 packet dropped.\n", + hlen, p->len)); + /* free (drop) packet pbufs */ + pbuf_free(p); + IP6_STATS_INC(ip6.lenerr); + IP6_STATS_INC(ip6.drop); + goto ip6_input_cleanup; + } + + pbuf_header(p, -(s16_t)hlen); + break; + case IP6_NEXTH_ROUTING: + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with Routing header\n")); + /* Get next header type. */ + nexth = *((u8_t *)p->payload); + + /* Get the header length. */ + hlen = 8 * (1 + *((u8_t *)p->payload + 1)); + ip_data.current_ip_header_tot_len += hlen; + + /* Skip over this header. */ + if (hlen > p->len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 options header (hlen %"U16_F") does not fit in first pbuf (len %"U16_F"), IPv6 packet dropped.\n", + hlen, p->len)); + /* free (drop) packet pbufs */ + pbuf_free(p); + IP6_STATS_INC(ip6.lenerr); + IP6_STATS_INC(ip6.drop); + goto ip6_input_cleanup; + } + + pbuf_header(p, -(s16_t)hlen); + break; + + case IP6_NEXTH_FRAGMENT: + { + struct ip6_frag_hdr * frag_hdr; + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with Fragment header\n")); + + frag_hdr = (struct ip6_frag_hdr *)p->payload; + + /* Get next header type. */ + nexth = frag_hdr->_nexth; + + /* Fragment Header length. */ + hlen = 8; + ip_data.current_ip_header_tot_len += hlen; + + /* Make sure this header fits in current pbuf. */ + if (hlen > p->len) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("IPv6 options header (hlen %"U16_F") does not fit in first pbuf (len %"U16_F"), IPv6 packet dropped.\n", + hlen, p->len)); + /* free (drop) packet pbufs */ + pbuf_free(p); + IP6_FRAG_STATS_INC(ip6_frag.lenerr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto ip6_input_cleanup; + } + + /* Offset == 0 and more_fragments == 0? */ + if ((frag_hdr->_fragment_offset & + PP_HTONS(IP6_FRAG_OFFSET_MASK | IP6_FRAG_MORE_FLAG)) == 0) { + /* This is a 1-fragment packet, usually a packet that we have + * already reassembled. Skip this header anc continue. */ + pbuf_header(p, -(s16_t)hlen); + } else { +#if LWIP_IPV6_REASS + + /* reassemble the packet */ + p = ip6_reass(p); + /* packet not fully reassembled yet? */ + if (p == NULL) { + goto ip6_input_cleanup; + } + + /* Returned p point to IPv6 header. + * Update all our variables and pointers and continue. */ + ip6hdr = (struct ip6_hdr *)p->payload; + nexth = IP6H_NEXTH(ip6hdr); + hlen = ip_data.current_ip_header_tot_len = IP6_HLEN; + pbuf_header(p, -IP6_HLEN); + +#else /* LWIP_IPV6_REASS */ + /* free (drop) packet pbufs */ + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: packet with Fragment header dropped (with LWIP_IPV6_REASS==0)\n")); + pbuf_free(p); + IP6_STATS_INC(ip6.opterr); + IP6_STATS_INC(ip6.drop); + goto ip6_input_cleanup; +#endif /* LWIP_IPV6_REASS */ + } + break; + } + default: + goto options_done; + break; + } + } +options_done: + + /* p points to IPv6 header again. */ + pbuf_header_force(p, ip_data.current_ip_header_tot_len); + + /* send to upper layers */ + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: \n")); + ip6_debug_print(p); + LWIP_DEBUGF(IP6_DEBUG, ("ip6_input: p->len %"U16_F" p->tot_len %"U16_F"\n", p->len, p->tot_len)); + +#if LWIP_RAW + /* raw input did not eat the packet? */ + if (raw_input(p, inp) == 0) +#endif /* LWIP_RAW */ + { + switch (nexth) { + case IP6_NEXTH_NONE: + pbuf_free(p); + break; +#if LWIP_UDP + case IP6_NEXTH_UDP: +#if LWIP_UDPLITE + case IP6_NEXTH_UDPLITE: +#endif /* LWIP_UDPLITE */ + /* Point to payload. */ + pbuf_header(p, -(s16_t)ip_data.current_ip_header_tot_len); + udp_input(p, inp); + break; +#endif /* LWIP_UDP */ +#if LWIP_TCP + case IP6_NEXTH_TCP: + /* Point to payload. */ + pbuf_header(p, -(s16_t)ip_data.current_ip_header_tot_len); + tcp_input(p, inp); + break; +#endif /* LWIP_TCP */ +#if LWIP_ICMP6 + case IP6_NEXTH_ICMP6: + /* Point to payload. */ + pbuf_header(p, -(s16_t)ip_data.current_ip_header_tot_len); + icmp6_input(p, inp); + break; +#endif /* LWIP_ICMP */ + default: +#if LWIP_ICMP6 + /* send ICMP parameter problem unless it was a multicast or ICMPv6 */ + if ((!ip6_addr_ismulticast(ip6_current_dest_addr())) && + (IP6H_NEXTH(ip6hdr) != IP6_NEXTH_ICMP6)) { + icmp6_param_problem(p, ICMP6_PP_HEADER, ip_data.current_ip_header_tot_len - hlen); + } +#endif /* LWIP_ICMP */ + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip6_input: Unsupported transport protocol %"U16_F"\n", IP6H_NEXTH(ip6hdr))); + pbuf_free(p); + IP6_STATS_INC(ip6.proterr); + IP6_STATS_INC(ip6.drop); + break; + } + } + +ip6_input_cleanup: + ip_data.current_netif = NULL; + ip_data.current_input_netif = NULL; + ip_data.current_ip6_header = NULL; + ip_data.current_ip_header_tot_len = 0; + ip6_addr_set_zero(ip6_current_src_addr()); + ip6_addr_set_zero(ip6_current_dest_addr()); + + return ERR_OK; +} + + +/** + * Sends an IPv6 packet on a network interface. This function constructs + * the IPv6 header. If the source IPv6 address is NULL, the IPv6 "ANY" address is + * used as source (usually during network startup). If the source IPv6 address it + * IP6_ADDR_ANY, the most appropriate IPv6 address of the outgoing network + * interface is filled in as source address. If the destination IPv6 address is + * IP_HDRINCL, p is assumed to already include an IPv6 header and p->payload points + * to it instead of the data. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an + IPv6 header and p->payload points to that IPv6 header) + * @param src the source IPv6 address to send from (if src == IP6_ADDR_ANY, an + * IP address of the netif is selected and used as source address. + * if src == NULL, IP6_ADDR_ANY is used as source) + * @param dest the destination IPv6 address to send the packet to + * @param hl the Hop Limit value to be set in the IPv6 header + * @param tc the Traffic Class value to be set in the IPv6 header + * @param nexth the Next Header to be set in the IPv6 header + * @param netif the netif on which to send this packet + * @return ERR_OK if the packet was sent OK + * ERR_BUF if p doesn't have enough space for IPv6/LINK headers + * returns errors returned by netif->output + */ +err_t +ip6_output_if(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, + u8_t nexth, struct netif *netif) +{ + const ip6_addr_t *src_used = src; + if (dest != IP_HDRINCL) { + if (src != NULL && ip6_addr_isany(src)) { + src = ip_2_ip6(ip6_select_source_address(netif, dest)); + if ((src == NULL) || ip6_addr_isany(src)) { + /* No appropriate source address was found for this packet. */ + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip6_output: No suitable source address for packet.\n")); + IP6_STATS_INC(ip6.rterr); + return ERR_RTE; + } + } + } + return ip6_output_if_src(p, src_used, dest, hl, tc, nexth, netif); +} + +/** + * Same as ip6_output_if() but 'src' address is not replaced by netif address + * when it is 'any'. + */ +err_t +ip6_output_if_src(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, + u8_t nexth, struct netif *netif) +{ + struct ip6_hdr *ip6hdr; + ip6_addr_t dest_addr; + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + /* Should the IPv6 header be generated or is it already included in p? */ + if (dest != IP_HDRINCL) { + /* generate IPv6 header */ + if (pbuf_header(p, IP6_HLEN)) { + LWIP_DEBUGF(IP6_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip6_output: not enough room for IPv6 header in pbuf\n")); + IP6_STATS_INC(ip6.err); + return ERR_BUF; + } + + ip6hdr = (struct ip6_hdr *)p->payload; + LWIP_ASSERT("check that first pbuf can hold struct ip6_hdr", + (p->len >= sizeof(struct ip6_hdr))); + + IP6H_HOPLIM_SET(ip6hdr, hl); + IP6H_NEXTH_SET(ip6hdr, nexth); + + /* dest cannot be NULL here */ + ip6_addr_copy(ip6hdr->dest, *dest); + + IP6H_VTCFL_SET(ip6hdr, 6, tc, 0); + IP6H_PLEN_SET(ip6hdr, p->tot_len - IP6_HLEN); + + if (src == NULL) { + src = IP6_ADDR_ANY6; + } + /* src cannot be NULL here */ + ip6_addr_copy(ip6hdr->src, *src); + + } else { + /* IP header already included in p */ + ip6hdr = (struct ip6_hdr *)p->payload; + ip6_addr_copy(dest_addr, ip6hdr->dest); + dest = &dest_addr; + } + + IP6_STATS_INC(ip6.xmit); + + LWIP_DEBUGF(IP6_DEBUG, ("ip6_output_if: %c%c%"U16_F"\n", netif->name[0], netif->name[1], netif->num)); + ip6_debug_print(p); + +#if ENABLE_LOOPBACK + { + int i; +#if !LWIP_HAVE_LOOPIF + if (ip6_addr_isloopback(dest)) { + return netif_loop_output(netif, p); + } +#endif /* !LWIP_HAVE_LOOPIF */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_cmp(dest, netif_ip6_addr(netif, i))) { + /* Packet to self, enqueue it for loopback */ + LWIP_DEBUGF(IP6_DEBUG, ("netif_loop_output()\n")); + return netif_loop_output(netif, p); + } + } + } +#endif /* ENABLE_LOOPBACK */ +#if LWIP_IPV6_FRAG + /* don't fragment if interface has mtu set to 0 [loopif] */ + if (netif->mtu && (p->tot_len > nd6_get_destination_mtu(dest, netif))) { + return ip6_frag(p, netif, dest); + } +#endif /* LWIP_IPV6_FRAG */ + + LWIP_DEBUGF(IP6_DEBUG, ("netif->output_ip6()\n")); + return netif->output_ip6(netif, p, dest); +} + +/** + * Simple interface to ip6_output_if. It finds the outgoing network + * interface and calls upon ip6_output_if to do the actual work. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an + IPv6 header and p->payload points to that IPv6 header) + * @param src the source IPv6 address to send from (if src == IP6_ADDR_ANY, an + * IP address of the netif is selected and used as source address. + * if src == NULL, IP6_ADDR_ANY is used as source) + * @param dest the destination IPv6 address to send the packet to + * @param hl the Hop Limit value to be set in the IPv6 header + * @param tc the Traffic Class value to be set in the IPv6 header + * @param nexth the Next Header to be set in the IPv6 header + * + * @return ERR_RTE if no route is found + * see ip_output_if() for more return values + */ +err_t +ip6_output(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth) +{ + struct netif *netif; + struct ip6_hdr *ip6hdr; + ip6_addr_t src_addr, dest_addr; + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + if (dest != IP_HDRINCL) { + netif = ip6_route(src, dest); + } else { + /* IP header included in p, read addresses. */ + ip6hdr = (struct ip6_hdr *)p->payload; + ip6_addr_copy(src_addr, ip6hdr->src); + ip6_addr_copy(dest_addr, ip6hdr->dest); + netif = ip6_route(&src_addr, &dest_addr); + } + + if (netif == NULL) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_output: no route for %"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F"\n", + IP6_ADDR_BLOCK1(dest), + IP6_ADDR_BLOCK2(dest), + IP6_ADDR_BLOCK3(dest), + IP6_ADDR_BLOCK4(dest), + IP6_ADDR_BLOCK5(dest), + IP6_ADDR_BLOCK6(dest), + IP6_ADDR_BLOCK7(dest), + IP6_ADDR_BLOCK8(dest))); + IP6_STATS_INC(ip6.rterr); + return ERR_RTE; + } + + return ip6_output_if(p, src, dest, hl, tc, nexth, netif); +} + + +#if LWIP_NETIF_HWADDRHINT +/** Like ip6_output, but takes and addr_hint pointer that is passed on to netif->addr_hint + * before calling ip6_output_if. + * + * @param p the packet to send (p->payload points to the data, e.g. next + protocol header; if dest == IP_HDRINCL, p already includes an + IPv6 header and p->payload points to that IPv6 header) + * @param src the source IPv6 address to send from (if src == IP6_ADDR_ANY, an + * IP address of the netif is selected and used as source address. + * if src == NULL, IP6_ADDR_ANY is used as source) + * @param dest the destination IPv6 address to send the packet to + * @param hl the Hop Limit value to be set in the IPv6 header + * @param tc the Traffic Class value to be set in the IPv6 header + * @param nexth the Next Header to be set in the IPv6 header + * @param addr_hint address hint pointer set to netif->addr_hint before + * calling ip_output_if() + * + * @return ERR_RTE if no route is found + * see ip_output_if() for more return values + */ +err_t +ip6_output_hinted(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth, u8_t *addr_hint) +{ + struct netif *netif; + struct ip6_hdr *ip6hdr; + ip6_addr_t src_addr, dest_addr; + err_t err; + + LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p); + + if (dest != IP_HDRINCL) { + netif = ip6_route(src, dest); + } else { + /* IP header included in p, read addresses. */ + ip6hdr = (struct ip6_hdr *)p->payload; + ip6_addr_copy(src_addr, ip6hdr->src); + ip6_addr_copy(dest_addr, ip6hdr->dest); + netif = ip6_route(&src_addr, &dest_addr); + } + + if (netif == NULL) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_output: no route for %"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F":%"X16_F"\n", + IP6_ADDR_BLOCK1(dest), + IP6_ADDR_BLOCK2(dest), + IP6_ADDR_BLOCK3(dest), + IP6_ADDR_BLOCK4(dest), + IP6_ADDR_BLOCK5(dest), + IP6_ADDR_BLOCK6(dest), + IP6_ADDR_BLOCK7(dest), + IP6_ADDR_BLOCK8(dest))); + IP6_STATS_INC(ip6.rterr); + return ERR_RTE; + } + + NETIF_SET_HWADDRHINT(netif, addr_hint); + err = ip6_output_if(p, src, dest, hl, tc, nexth, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + + return err; +} +#endif /* LWIP_NETIF_HWADDRHINT*/ + +#if LWIP_IPV6_MLD +/** + * Add a hop-by-hop options header with a router alert option and padding. + * + * Used by MLD when sending a Multicast listener report/done message. + * + * @param p the packet to which we will prepend the options header + * @param nexth the next header protocol number (e.g. IP6_NEXTH_ICMP6) + * @param value the value of the router alert option data (e.g. IP6_ROUTER_ALERT_VALUE_MLD) + * @return ERR_OK if hop-by-hop header was added, ERR_* otherwise + */ +err_t +ip6_options_add_hbh_ra(struct pbuf * p, u8_t nexth, u8_t value) +{ + struct ip6_hbh_hdr * hbh_hdr; + + /* Move pointer to make room for hop-by-hop options header. */ + if (pbuf_header(p, sizeof(struct ip6_hbh_hdr))) { + LWIP_DEBUGF(IP6_DEBUG, ("ip6_options: no space for options header\n")); + IP6_STATS_INC(ip6.err); + return ERR_BUF; + } + + hbh_hdr = (struct ip6_hbh_hdr *)p->payload; + + /* Set fields. */ + hbh_hdr->_nexth = nexth; + hbh_hdr->_hlen = 0; + hbh_hdr->_ra_opt_type = IP6_ROUTER_ALERT_OPTION; + hbh_hdr->_ra_opt_dlen = 2; + hbh_hdr->_ra_opt_data = value; + hbh_hdr->_padn_opt_type = IP6_PADN_ALERT_OPTION; + hbh_hdr->_padn_opt_dlen = 0; + + return ERR_OK; +} +#endif /* LWIP_IPV6_MLD */ + +#if IP6_DEBUG +/* Print an IPv6 header by using LWIP_DEBUGF + * @param p an IPv6 packet, p->payload pointing to the IPv6 header + */ +void +ip6_debug_print(struct pbuf *p) +{ + struct ip6_hdr *ip6hdr = (struct ip6_hdr *)p->payload; + + LWIP_DEBUGF(IP6_DEBUG, ("IPv6 header:\n")); + LWIP_DEBUGF(IP6_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP6_DEBUG, ("| %2"U16_F" | %3"U16_F" | %7"U32_F" | (ver, class, flow)\n", + IP6H_V(ip6hdr), + IP6H_TC(ip6hdr), + IP6H_FL(ip6hdr))); + LWIP_DEBUGF(IP6_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP6_DEBUG, ("| %5"U16_F" | %3"U16_F" | %3"U16_F" | (plen, nexth, hopl)\n", + IP6H_PLEN(ip6hdr), + IP6H_NEXTH(ip6hdr), + IP6H_HOPLIM(ip6hdr))); + LWIP_DEBUGF(IP6_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP6_DEBUG, ("| %4"X32_F" | %4"X32_F" | %4"X32_F" | %4"X32_F" | (src)\n", + IP6_ADDR_BLOCK1(&(ip6hdr->src)), + IP6_ADDR_BLOCK2(&(ip6hdr->src)), + IP6_ADDR_BLOCK3(&(ip6hdr->src)), + IP6_ADDR_BLOCK4(&(ip6hdr->src)))); + LWIP_DEBUGF(IP6_DEBUG, ("| %4"X32_F" | %4"X32_F" | %4"X32_F" | %4"X32_F" |\n", + IP6_ADDR_BLOCK5(&(ip6hdr->src)), + IP6_ADDR_BLOCK6(&(ip6hdr->src)), + IP6_ADDR_BLOCK7(&(ip6hdr->src)), + IP6_ADDR_BLOCK8(&(ip6hdr->src)))); + LWIP_DEBUGF(IP6_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(IP6_DEBUG, ("| %4"X32_F" | %4"X32_F" | %4"X32_F" | %4"X32_F" | (dest)\n", + IP6_ADDR_BLOCK1(&(ip6hdr->dest)), + IP6_ADDR_BLOCK2(&(ip6hdr->dest)), + IP6_ADDR_BLOCK3(&(ip6hdr->dest)), + IP6_ADDR_BLOCK4(&(ip6hdr->dest)))); + LWIP_DEBUGF(IP6_DEBUG, ("| %4"X32_F" | %4"X32_F" | %4"X32_F" | %4"X32_F" |\n", + IP6_ADDR_BLOCK5(&(ip6hdr->dest)), + IP6_ADDR_BLOCK6(&(ip6hdr->dest)), + IP6_ADDR_BLOCK7(&(ip6hdr->dest)), + IP6_ADDR_BLOCK8(&(ip6hdr->dest)))); + LWIP_DEBUGF(IP6_DEBUG, ("+-------------------------------+\n")); +} +#endif /* IP6_DEBUG */ + +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/ipv6/ip6_addr.c b/components/lwip/core/ipv6/ip6_addr.c new file mode 100755 index 000000000..44d576070 --- /dev/null +++ b/components/lwip/core/ipv6/ip6_addr.c @@ -0,0 +1,292 @@ +/** + * @file + * + * IPv6 addresses. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * Functions for handling IPv6 addresses. + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/ip_addr.h" +#include "lwip/def.h" + +/* used by IP6_ADDR_ANY(6) in ip6_addr.h */ +const ip_addr_t ip6_addr_any = IPADDR6_INIT(0ul, 0ul, 0ul, 0ul); + +#ifndef isprint +#define in_range(c, lo, up) ((u8_t)c >= lo && (u8_t)c <= up) +#define isprint(c) in_range(c, 0x20, 0x7f) +#define isdigit(c) in_range(c, '0', '9') +#define isxdigit(c) (isdigit(c) || in_range(c, 'a', 'f') || in_range(c, 'A', 'F')) +#define islower(c) in_range(c, 'a', 'z') +#define isspace(c) (c == ' ' || c == '\f' || c == '\n' || c == '\r' || c == '\t' || c == '\v') +#define xchar(i) ((i) < 10 ? '0' + (i) : 'A' + (i) - 10) +#endif + +/** + * Check whether "cp" is a valid ascii representation + * of an IPv6 address and convert to a binary address. + * Returns 1 if the address is valid, 0 if not. + * + * @param cp IPv6 address in ascii representation (e.g. "FF01::1") + * @param addr pointer to which to save the ip address in network order + * @return 1 if cp could be converted to addr, 0 on failure + */ +int +ip6addr_aton(const char *cp, ip6_addr_t *addr) +{ + u32_t addr_index, zero_blocks, current_block_index, current_block_value; + const char * s; + + /* Count the number of colons, to count the number of blocks in a "::" sequence + zero_blocks may be 1 even if there are no :: sequences */ + zero_blocks = 8; + for (s = cp; *s != 0; s++) { + if (*s == ':') { + zero_blocks--; + } else if (!isxdigit(*s)) { + break; + } + } + + /* parse each block */ + addr_index = 0; + current_block_index = 0; + current_block_value = 0; + for (s = cp; *s != 0; s++) { + if (*s == ':') { + if (addr) { + if (current_block_index & 0x1) { + addr->addr[addr_index++] |= current_block_value; + } + else { + addr->addr[addr_index] = current_block_value << 16; + } + } + current_block_index++; + current_block_value = 0; + if (current_block_index > 7) { + /* address too long! */ + return 0; + } + if (s[1] == ':') { + if (s[2] == ':') { + /* invalid format: three successive colons */ + return 0; + } + s++; + /* "::" found, set zeros */ + while (zero_blocks > 0) { + zero_blocks--; + if (current_block_index & 0x1) { + addr_index++; + } else { + if (addr) { + addr->addr[addr_index] = 0; + } + } + current_block_index++; + if (current_block_index > 7) { + /* address too long! */ + return 0; + } + } + } + } else if (isxdigit(*s)) { + /* add current digit */ + current_block_value = (current_block_value << 4) + + (isdigit(*s) ? *s - '0' : + 10 + (islower(*s) ? *s - 'a' : *s - 'A')); + } else { + /* unexpected digit, space? CRLF? */ + break; + } + } + + if (addr) { + if (current_block_index & 0x1) { + addr->addr[addr_index++] |= current_block_value; + } + else { + addr->addr[addr_index] = current_block_value << 16; + } + } + + /* convert to network byte order. */ + if (addr) { + for (addr_index = 0; addr_index < 4; addr_index++) { + addr->addr[addr_index] = htonl(addr->addr[addr_index]); + } + } + + if (current_block_index != 7) { + return 0; + } + + return 1; +} + +/** + * Convert numeric IPv6 address into ASCII representation. + * returns ptr to static buffer; not reentrant! + * + * @param addr ip6 address in network order to convert + * @return pointer to a global static (!) buffer that holds the ASCII + * representation of addr + */ +char * +ip6addr_ntoa(const ip6_addr_t *addr) +{ + static char str[40]; + return ip6addr_ntoa_r(addr, str, 40); +} + +/** + * Same as ipaddr_ntoa, but reentrant since a user-supplied buffer is used. + * + * @param addr ip6 address in network order to convert + * @param buf target buffer where the string is stored + * @param buflen length of buf + * @return either pointer to buf which now holds the ASCII + * representation of addr or NULL if buf was too small + */ +char * +ip6addr_ntoa_r(const ip6_addr_t *addr, char *buf, int buflen) +{ + u32_t current_block_index, current_block_value, next_block_value; + s32_t i; + u8_t zero_flag, empty_block_flag; + + i = 0; + empty_block_flag = 0; /* used to indicate a zero chain for "::' */ + + for (current_block_index = 0; current_block_index < 8; current_block_index++) { + /* get the current 16-bit block */ + current_block_value = htonl(addr->addr[current_block_index >> 1]); + if ((current_block_index & 0x1) == 0) { + current_block_value = current_block_value >> 16; + } + current_block_value &= 0xffff; + + /* Check for empty block. */ + if (current_block_value == 0) { + if (current_block_index == 7) { + /* special case, we must render a ':' for the last block. */ + buf[i++] = ':'; + if (i >= buflen) { + return NULL; + } + break; + } + if (empty_block_flag == 0) { + /* generate empty block "::", but only if more than one contiguous zero block, + * according to current formatting suggestions RFC 5952. */ + next_block_value = htonl(addr->addr[(current_block_index + 1) >> 1]); + if ((current_block_index & 0x1) == 0x01) { + next_block_value = next_block_value >> 16; + } + next_block_value &= 0xffff; + if (next_block_value == 0) { + empty_block_flag = 1; + buf[i++] = ':'; + if (i >= buflen) { + return NULL; + } + continue; /* move on to next block. */ + } + } else if (empty_block_flag == 1) { + /* move on to next block. */ + continue; + } + } else if (empty_block_flag == 1) { + /* Set this flag value so we don't produce multiple empty blocks. */ + empty_block_flag = 2; + } + + if (current_block_index > 0) { + buf[i++] = ':'; + if (i >= buflen) { + return NULL; + } + } + + if ((current_block_value & 0xf000) == 0) { + zero_flag = 1; + } else { + buf[i++] = xchar(((current_block_value & 0xf000) >> 12)); + zero_flag = 0; + if (i >= buflen) { + return NULL; + } + } + + if (((current_block_value & 0xf00) == 0) && (zero_flag)) { + /* do nothing */ + } else { + buf[i++] = xchar(((current_block_value & 0xf00) >> 8)); + zero_flag = 0; + if (i >= buflen) { + return NULL; + } + } + + if (((current_block_value & 0xf0) == 0) && (zero_flag)) { + /* do nothing */ + } + else { + buf[i++] = xchar(((current_block_value & 0xf0) >> 4)); + zero_flag = 0; + if (i >= buflen) { + return NULL; + } + } + + buf[i++] = xchar((current_block_value & 0xf)); + if (i >= buflen) { + return NULL; + } + } + + buf[i] = 0; + + return buf; +} + +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/ipv6/ip6_frag.c b/components/lwip/core/ipv6/ip6_frag.c new file mode 100755 index 000000000..0792c2e1b --- /dev/null +++ b/components/lwip/core/ipv6/ip6_frag.c @@ -0,0 +1,778 @@ +/** + * @file + * + * IPv6 fragmentation and reassembly. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" +#include "lwip/ip6_frag.h" +#include "lwip/ip6.h" +#include "lwip/icmp6.h" +#include "lwip/nd6.h" +#include "lwip/ip.h" + +#include "lwip/pbuf.h" +#include "lwip/memp.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +#if LWIP_IPV6 && LWIP_IPV6_REASS /* don't build if not configured for use in lwipopts.h */ + + +/** Setting this to 0, you can turn off checking the fragments for overlapping + * regions. The code gets a little smaller. Only use this if you know that + * overlapping won't occur on your network! */ +#ifndef IP_REASS_CHECK_OVERLAP +#define IP_REASS_CHECK_OVERLAP 1 +#endif /* IP_REASS_CHECK_OVERLAP */ + +/** Set to 0 to prevent freeing the oldest datagram when the reassembly buffer is + * full (IP_REASS_MAX_PBUFS pbufs are enqueued). The code gets a little smaller. + * Datagrams will be freed by timeout only. Especially useful when MEMP_NUM_REASSDATA + * is set to 1, so one datagram can be reassembled at a time, only. */ +#ifndef IP_REASS_FREE_OLDEST +#define IP_REASS_FREE_OLDEST 1 +#endif /* IP_REASS_FREE_OLDEST */ + +#if IPV6_FRAG_COPYHEADER +#define IPV6_FRAG_REQROOM ((s16_t)(sizeof(struct ip6_reass_helper) - IP6_FRAG_HLEN)) +#endif + +#define IP_REASS_FLAG_LASTFRAG 0x01 + +/** This is a helper struct which holds the starting + * offset and the ending offset of this fragment to + * easily chain the fragments. + * It has the same packing requirements as the IPv6 header, since it replaces + * the Fragment Header in memory in incoming fragments to keep + * track of the various fragments. + */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip6_reass_helper { + PACK_STRUCT_FIELD(struct pbuf *next_pbuf); + PACK_STRUCT_FIELD(u16_t start); + PACK_STRUCT_FIELD(u16_t end); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/* static variables */ +static struct ip6_reassdata *reassdatagrams; +static u16_t ip6_reass_pbufcount; + +/* Forward declarations. */ +static void ip6_reass_free_complete_datagram(struct ip6_reassdata *ipr); +#if IP_REASS_FREE_OLDEST +static void ip6_reass_remove_oldest_datagram(struct ip6_reassdata *ipr, int pbufs_needed); +#endif /* IP_REASS_FREE_OLDEST */ + +void +ip6_reass_tmr(void) +{ + struct ip6_reassdata *r, *tmp; + +#if !IPV6_FRAG_COPYHEADER + LWIP_ASSERT("sizeof(struct ip6_reass_helper) <= IP6_FRAG_HLEN, set IPV6_FRAG_COPYHEADER to 1", + sizeof(struct ip6_reass_helper) <= IP6_FRAG_HLEN); +#endif /* !IPV6_FRAG_COPYHEADER */ + + r = reassdatagrams; + while (r != NULL) { + /* Decrement the timer. Once it reaches 0, + * clean up the incomplete fragment assembly */ + if (r->timer > 0) { + r->timer--; + r = r->next; + } else { + /* reassembly timed out */ + tmp = r; + /* get the next pointer before freeing */ + r = r->next; + /* free the helper struct and all enqueued pbufs */ + ip6_reass_free_complete_datagram(tmp); + } + } +} + +/** + * Free a datagram (struct ip6_reassdata) and all its pbufs. + * Updates the total count of enqueued pbufs (ip6_reass_pbufcount), + * sends an ICMP time exceeded packet. + * + * @param ipr datagram to free + */ +static void +ip6_reass_free_complete_datagram(struct ip6_reassdata *ipr) +{ + struct ip6_reassdata *prev; + u16_t pbufs_freed = 0; + u8_t clen; + struct pbuf *p; + struct ip6_reass_helper *iprh; + +#if LWIP_ICMP6 + iprh = (struct ip6_reass_helper *)ipr->p->payload; + if (iprh->start == 0) { + /* The first fragment was received, send ICMP time exceeded. */ + /* First, de-queue the first pbuf from r->p. */ + p = ipr->p; + ipr->p = iprh->next_pbuf; + /* Then, move back to the original ipv6 header (we are now pointing to Fragment header). + This cannot fail since we already checked when receiving this fragment. */ + if (pbuf_header_force(p, (s16_t)((u8_t*)p->payload - (u8_t*)IPV6_FRAG_HDRREF(ipr->iphdr)))) { + LWIP_ASSERT("ip6_reass_free: moving p->payload to ip6 header failed\n", 0); + } + else { + icmp6_time_exceeded(p, ICMP6_TE_FRAG); + } + clen = pbuf_clen(p); + LWIP_ASSERT("pbufs_freed + clen <= 0xffff", pbufs_freed + clen <= 0xffff); + pbufs_freed += clen; + pbuf_free(p); + } +#endif /* LWIP_ICMP6 */ + + /* First, free all received pbufs. The individual pbufs need to be released + separately as they have not yet been chained */ + p = ipr->p; + while (p != NULL) { + struct pbuf *pcur; + iprh = (struct ip6_reass_helper *)p->payload; + pcur = p; + /* get the next pointer before freeing */ + p = iprh->next_pbuf; + clen = pbuf_clen(pcur); + LWIP_ASSERT("pbufs_freed + clen <= 0xffff", pbufs_freed + clen <= 0xffff); + pbufs_freed += clen; + pbuf_free(pcur); + } + + /* Then, unchain the struct ip6_reassdata from the list and free it. */ + if (ipr == reassdatagrams) { + reassdatagrams = ipr->next; + } else { + prev = reassdatagrams; + while (prev != NULL) { + if (prev->next == ipr) { + break; + } + prev = prev->next; + } + if (prev != NULL) { + prev->next = ipr->next; + } + } + memp_free(MEMP_IP6_REASSDATA, ipr); + + /* Finally, update number of pbufs in reassembly queue */ + LWIP_ASSERT("ip_reass_pbufcount >= clen", ip6_reass_pbufcount >= pbufs_freed); + ip6_reass_pbufcount -= pbufs_freed; +} + +#if IP_REASS_FREE_OLDEST +/** + * Free the oldest datagram to make room for enqueueing new fragments. + * The datagram ipr is not freed! + * + * @param ipr ip6_reassdata for the current fragment + * @param pbufs_needed number of pbufs needed to enqueue + * (used for freeing other datagrams if not enough space) + */ +static void +ip6_reass_remove_oldest_datagram(struct ip6_reassdata *ipr, int pbufs_needed) +{ + struct ip6_reassdata *r, *oldest; + + /* Free datagrams until being allowed to enqueue 'pbufs_needed' pbufs, + * but don't free the current datagram! */ + do { + r = oldest = reassdatagrams; + while (r != NULL) { + if (r != ipr) { + if (r->timer <= oldest->timer) { + /* older than the previous oldest */ + oldest = r; + } + } + r = r->next; + } + if (oldest == ipr) { + /* nothing to free, ipr is the only element on the list */ + return; + } + if (oldest != NULL) { + ip6_reass_free_complete_datagram(oldest); + } + } while (((ip6_reass_pbufcount + pbufs_needed) > IP_REASS_MAX_PBUFS) && (reassdatagrams != NULL)); +} +#endif /* IP_REASS_FREE_OLDEST */ + +/** + * Reassembles incoming IPv6 fragments into an IPv6 datagram. + * + * @param p points to the IPv6 Fragment Header + * @param len the length of the payload (after Fragment Header) + * @return NULL if reassembly is incomplete, pbuf pointing to + * IPv6 Header if reassembly is complete + */ +struct pbuf * +ip6_reass(struct pbuf *p) +{ + struct ip6_reassdata *ipr, *ipr_prev; + struct ip6_reass_helper *iprh, *iprh_tmp, *iprh_prev=NULL; + struct ip6_frag_hdr * frag_hdr; + u16_t offset, len; + u8_t clen, valid = 1; + struct pbuf *q; + + IP6_FRAG_STATS_INC(ip6_frag.recv); + + LWIP_ASSERT("ip6_frag_hdr must be in the first pbuf, not chained", + (const void*)ip6_current_header() == ((u8_t*)p->payload) - IP6_HLEN); + + frag_hdr = (struct ip6_frag_hdr *) p->payload; + + clen = pbuf_clen(p); + + offset = ntohs(frag_hdr->_fragment_offset); + + /* Calculate fragment length from IPv6 payload length. + * Adjust for headers before Fragment Header. + * And finally adjust by Fragment Header length. */ + len = ntohs(ip6_current_header()->_plen); + len -= (u16_t)(((u8_t*)p->payload - (const u8_t*)ip6_current_header()) - IP6_HLEN); + len -= IP6_FRAG_HLEN; + + /* Look for the datagram the fragment belongs to in the current datagram queue, + * remembering the previous in the queue for later dequeueing. */ + for (ipr = reassdatagrams, ipr_prev = NULL; ipr != NULL; ipr = ipr->next) { + /* Check if the incoming fragment matches the one currently present + in the reassembly buffer. If so, we proceed with copying the + fragment into the buffer. */ + if ((frag_hdr->_identification == ipr->identification) && + ip6_addr_cmp(ip6_current_src_addr(), &(IPV6_FRAG_HDRREF(ipr->iphdr)->src)) && + ip6_addr_cmp(ip6_current_dest_addr(), &(IPV6_FRAG_HDRREF(ipr->iphdr)->dest))) { + IP6_FRAG_STATS_INC(ip6_frag.cachehit); + break; + } + ipr_prev = ipr; + } + + if (ipr == NULL) { + /* Enqueue a new datagram into the datagram queue */ + ipr = (struct ip6_reassdata *)memp_malloc(MEMP_IP6_REASSDATA); + if (ipr == NULL) { +#if IP_REASS_FREE_OLDEST + /* Make room and try again. */ + ip6_reass_remove_oldest_datagram(ipr, clen); + ipr = (struct ip6_reassdata *)memp_malloc(MEMP_IP6_REASSDATA); + if (ipr != NULL) { + /* re-search ipr_prev since it might have been removed */ + for (ipr_prev = reassdatagrams; ipr_prev != NULL; ipr_prev = ipr_prev->next) { + if (ipr_prev->next == ipr) { + break; + } + } + } else +#endif /* IP_REASS_FREE_OLDEST */ + { + IP6_FRAG_STATS_INC(ip6_frag.memerr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; + } + } + + memset(ipr, 0, sizeof(struct ip6_reassdata)); + ipr->timer = IP_REASS_MAXAGE; + + /* enqueue the new structure to the front of the list */ + ipr->next = reassdatagrams; + reassdatagrams = ipr; + + /* Use the current IPv6 header for src/dest address reference. + * Eventually, we will replace it when we get the first fragment + * (it might be this one, in any case, it is done later). */ +#if IPV6_FRAG_COPYHEADER + MEMCPY(&ipr->iphdr, ip6_current_header(), IP6_HLEN); +#else /* IPV6_FRAG_COPYHEADER */ + /* need to use the none-const pointer here: */ + ipr->iphdr = ip_data.current_ip6_header; +#endif /* IPV6_FRAG_COPYHEADER */ + + /* copy the fragmented packet id. */ + ipr->identification = frag_hdr->_identification; + + /* copy the nexth field */ + ipr->nexth = frag_hdr->_nexth; + } + + /* Check if we are allowed to enqueue more datagrams. */ + if ((ip6_reass_pbufcount + clen) > IP_REASS_MAX_PBUFS) { +#if IP_REASS_FREE_OLDEST + ip6_reass_remove_oldest_datagram(ipr, clen); + if ((ip6_reass_pbufcount + clen) <= IP_REASS_MAX_PBUFS) { + /* re-search ipr_prev since it might have been removed */ + for (ipr_prev = reassdatagrams; ipr_prev != NULL; ipr_prev = ipr_prev->next) { + if (ipr_prev->next == ipr) { + break; + } + } + } else +#endif /* IP_REASS_FREE_OLDEST */ + { + /* @todo: send ICMPv6 time exceeded here? */ + /* drop this pbuf */ + IP6_FRAG_STATS_INC(ip6_frag.memerr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; + } + } + + /* Overwrite Fragment Header with our own helper struct. */ +#if IPV6_FRAG_COPYHEADER + if (IPV6_FRAG_REQROOM > 0) { + /* Make room for struct ip6_reass_helper (only required if sizeof(void*) > 4). + This cannot fail since we already checked when receiving this fragment. */ + err_t hdrerr = pbuf_header_force(p, IPV6_FRAG_REQROOM); + LWIP_ASSERT("no room for struct ip6_reass_helper", hdrerr == ERR_OK); + } +#else /* IPV6_FRAG_COPYHEADER */ + LWIP_ASSERT("sizeof(struct ip6_reass_helper) <= IP6_FRAG_HLEN, set IPV6_FRAG_COPYHEADER to 1", + sizeof(struct ip6_reass_helper) <= IP6_FRAG_HLEN); +#endif /* IPV6_FRAG_COPYHEADER */ + iprh = (struct ip6_reass_helper *)p->payload; + iprh->next_pbuf = NULL; + iprh->start = (offset & IP6_FRAG_OFFSET_MASK); + iprh->end = (offset & IP6_FRAG_OFFSET_MASK) + len; + + /* find the right place to insert this pbuf */ + /* Iterate through until we either get to the end of the list (append), + * or we find on with a larger offset (insert). */ + for (q = ipr->p; q != NULL;) { + iprh_tmp = (struct ip6_reass_helper*)q->payload; + if (iprh->start < iprh_tmp->start) { +#if IP_REASS_CHECK_OVERLAP + if (iprh->end > iprh_tmp->start) { + /* fragment overlaps with following, throw away */ + IP6_FRAG_STATS_INC(ip6_frag.proterr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; + } + if (iprh_prev != NULL) { + if (iprh->start < iprh_prev->end) { + /* fragment overlaps with previous, throw away */ + IP6_FRAG_STATS_INC(ip6_frag.proterr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; + } + } +#endif /* IP_REASS_CHECK_OVERLAP */ + /* the new pbuf should be inserted before this */ + iprh->next_pbuf = q; + if (iprh_prev != NULL) { + /* not the fragment with the lowest offset */ + iprh_prev->next_pbuf = p; + } else { + /* fragment with the lowest offset */ + ipr->p = p; + } + break; + } else if (iprh->start == iprh_tmp->start) { + /* received the same datagram twice: no need to keep the datagram */ + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; +#if IP_REASS_CHECK_OVERLAP + } else if (iprh->start < iprh_tmp->end) { + /* overlap: no need to keep the new datagram */ + IP6_FRAG_STATS_INC(ip6_frag.proterr); + IP6_FRAG_STATS_INC(ip6_frag.drop); + goto nullreturn; +#endif /* IP_REASS_CHECK_OVERLAP */ + } else { + /* Check if the fragments received so far have no gaps. */ + if (iprh_prev != NULL) { + if (iprh_prev->end != iprh_tmp->start) { + /* There is a fragment missing between the current + * and the previous fragment */ + valid = 0; + } + } + } + q = iprh_tmp->next_pbuf; + iprh_prev = iprh_tmp; + } + + /* If q is NULL, then we made it to the end of the list. Determine what to do now */ + if (q == NULL) { + if (iprh_prev != NULL) { + /* this is (for now), the fragment with the highest offset: + * chain it to the last fragment */ +#if IP_REASS_CHECK_OVERLAP + LWIP_ASSERT("check fragments don't overlap", iprh_prev->end <= iprh->start); +#endif /* IP_REASS_CHECK_OVERLAP */ + iprh_prev->next_pbuf = p; + if (iprh_prev->end != iprh->start) { + valid = 0; + } + } else { +#if IP_REASS_CHECK_OVERLAP + LWIP_ASSERT("no previous fragment, this must be the first fragment!", + ipr->p == NULL); +#endif /* IP_REASS_CHECK_OVERLAP */ + /* this is the first fragment we ever received for this ip datagram */ + ipr->p = p; + } + } + + /* Track the current number of pbufs current 'in-flight', in order to limit + the number of fragments that may be enqueued at any one time */ + ip6_reass_pbufcount += clen; + + /* Remember IPv6 header if this is the first fragment. */ + if (iprh->start == 0) { +#if IPV6_FRAG_COPYHEADER + if (iprh->next_pbuf != NULL) { + MEMCPY(&ipr->iphdr, ip6_current_header(), IP6_HLEN); + } +#else /* IPV6_FRAG_COPYHEADER */ + /* need to use the none-const pointer here: */ + ipr->iphdr = ip_data.current_ip6_header; +#endif /* IPV6_FRAG_COPYHEADER */ + } + + /* If this is the last fragment, calculate total packet length. */ + if ((offset & IP6_FRAG_MORE_FLAG) == 0) { + ipr->datagram_len = iprh->end; + } + + /* Additional validity tests: we have received first and last fragment. */ + iprh_tmp = (struct ip6_reass_helper*)ipr->p->payload; + if (iprh_tmp->start != 0) { + valid = 0; + } + if (ipr->datagram_len == 0) { + valid = 0; + } + + /* Final validity test: no gaps between current and last fragment. */ + iprh_prev = iprh; + q = iprh->next_pbuf; + while ((q != NULL) && valid) { + iprh = (struct ip6_reass_helper*)q->payload; + if (iprh_prev->end != iprh->start) { + valid = 0; + break; + } + iprh_prev = iprh; + q = iprh->next_pbuf; + } + + if (valid) { + /* All fragments have been received */ + struct ip6_hdr* iphdr_ptr; + + /* chain together the pbufs contained within the ip6_reassdata list. */ + iprh = (struct ip6_reass_helper*) ipr->p->payload; + while (iprh != NULL) { + struct pbuf* next_pbuf = iprh->next_pbuf; + if (next_pbuf != NULL) { + /* Save next helper struct (will be hidden in next step). */ + iprh_tmp = (struct ip6_reass_helper*)next_pbuf->payload; + + /* hide the fragment header for every succeeding fragment */ + pbuf_header(next_pbuf, -IP6_FRAG_HLEN); +#if IPV6_FRAG_COPYHEADER + if (IPV6_FRAG_REQROOM > 0) { + /* hide the extra bytes borrowed from ip6_hdr for struct ip6_reass_helper */ + err_t hdrerr = pbuf_header(next_pbuf, -(s16_t)(IPV6_FRAG_REQROOM)); + LWIP_ASSERT("no room for struct ip6_reass_helper", hdrerr == ERR_OK); + } +#endif + pbuf_cat(ipr->p, next_pbuf); + } + else { + iprh_tmp = NULL; + } + + iprh = iprh_tmp; + } + +#if IPV6_FRAG_COPYHEADER + if (IPV6_FRAG_REQROOM > 0) { + /* get back room for struct ip6_reass_helper (only required if sizeof(void*) > 4) */ + err_t hdrerr = pbuf_header(ipr->p, -(s16_t)(IPV6_FRAG_REQROOM)); + LWIP_ASSERT("no room for struct ip6_reass_helper", hdrerr == ERR_OK); + } + iphdr_ptr = (struct ip6_hdr*)((u8_t*)ipr->p->payload - IP6_HLEN); + MEMCPY(iphdr_ptr, &ipr->iphdr, IP6_HLEN); +#else + iphdr_ptr = ipr->iphdr; +#endif + + /* Adjust datagram length by adding header lengths. */ + ipr->datagram_len += (u16_t)(((u8_t*)ipr->p->payload - (u8_t*)iphdr_ptr) + + IP6_FRAG_HLEN + - IP6_HLEN); + + /* Set payload length in ip header. */ + iphdr_ptr->_plen = htons(ipr->datagram_len); + + /* Get the first pbuf. */ + p = ipr->p; + + /* Restore Fragment Header in first pbuf. Mark as "single fragment" + * packet. Restore nexth. */ + frag_hdr = (struct ip6_frag_hdr *) p->payload; + frag_hdr->_nexth = ipr->nexth; + frag_hdr->reserved = 0; + frag_hdr->_fragment_offset = 0; + frag_hdr->_identification = 0; + + /* release the sources allocate for the fragment queue entry */ + if (reassdatagrams == ipr) { + /* it was the first in the list */ + reassdatagrams = ipr->next; + } else { + /* it wasn't the first, so it must have a valid 'prev' */ + LWIP_ASSERT("sanity check linked list", ipr_prev != NULL); + ipr_prev->next = ipr->next; + } + memp_free(MEMP_IP6_REASSDATA, ipr); + + /* adjust the number of pbufs currently queued for reassembly. */ + ip6_reass_pbufcount -= pbuf_clen(p); + + /* Move pbuf back to IPv6 header. + This cannot fail since we already checked when receiving this fragment. */ + if (pbuf_header_force(p, (s16_t)((u8_t*)p->payload - (u8_t*)iphdr_ptr))) { + LWIP_ASSERT("ip6_reass: moving p->payload to ip6 header failed\n", 0); + pbuf_free(p); + return NULL; + } + + /* Return the pbuf chain */ + return p; + } + /* the datagram is not (yet?) reassembled completely */ + return NULL; + +nullreturn: + pbuf_free(p); + return NULL; +} + +#endif /* LWIP_IPV6 && LWIP_IPV6_REASS */ + +#if LWIP_IPV6 && LWIP_IPV6_FRAG + +/** Allocate a new struct pbuf_custom_ref */ +static struct pbuf_custom_ref* +ip6_frag_alloc_pbuf_custom_ref(void) +{ + return (struct pbuf_custom_ref*)memp_malloc(MEMP_FRAG_PBUF); +} + +/** Free a struct pbuf_custom_ref */ +static void +ip6_frag_free_pbuf_custom_ref(struct pbuf_custom_ref* p) +{ + LWIP_ASSERT("p != NULL", p != NULL); + memp_free(MEMP_FRAG_PBUF, p); +} + +/** Free-callback function to free a 'struct pbuf_custom_ref', called by + * pbuf_free. */ +static void +ip6_frag_free_pbuf_custom(struct pbuf *p) +{ + struct pbuf_custom_ref *pcr = (struct pbuf_custom_ref*)p; + LWIP_ASSERT("pcr != NULL", pcr != NULL); + LWIP_ASSERT("pcr == p", (void*)pcr == (void*)p); + if (pcr->original != NULL) { + pbuf_free(pcr->original); + } + ip6_frag_free_pbuf_custom_ref(pcr); +} + +/** + * Fragment an IPv6 datagram if too large for the netif or path MTU. + * + * Chop the datagram in MTU sized chunks and send them in order + * by pointing PBUF_REFs into p + * + * @param p ipv6 packet to send + * @param netif the netif on which to send + * @param dest destination ipv6 address to which to send + * + * @return ERR_OK if sent successfully, err_t otherwise + */ +err_t +ip6_frag(struct pbuf *p, struct netif *netif, const ip6_addr_t *dest) +{ + struct ip6_hdr *original_ip6hdr; + struct ip6_hdr *ip6hdr; + struct ip6_frag_hdr * frag_hdr; + struct pbuf *rambuf; + struct pbuf *newpbuf; + static u32_t identification; + u16_t nfb; + u16_t left, cop; + u16_t mtu; + u16_t fragment_offset = 0; + u16_t last; + u16_t poff = IP6_HLEN; + u16_t newpbuflen = 0; + u16_t left_to_copy; + + identification++; + + original_ip6hdr = (struct ip6_hdr *)p->payload; + + mtu = nd6_get_destination_mtu(dest, netif); + + /* TODO we assume there are no options in the unfragmentable part (IPv6 header). */ + left = p->tot_len - IP6_HLEN; + + nfb = (mtu - (IP6_HLEN + IP6_FRAG_HLEN)) & IP6_FRAG_OFFSET_MASK; + + while (left) { + last = (left <= nfb); + + /* Fill this fragment */ + cop = last ? left : nfb; + + /* When not using a static buffer, create a chain of pbufs. + * The first will be a PBUF_RAM holding the link, IPv6, and Fragment header. + * The rest will be PBUF_REFs mirroring the pbuf chain to be fragged, + * but limited to the size of an mtu. + */ + rambuf = pbuf_alloc(PBUF_LINK, IP6_HLEN + IP6_FRAG_HLEN, PBUF_RAM); + if (rambuf == NULL) { + IP6_FRAG_STATS_INC(ip6_frag.memerr); + return ERR_MEM; + } + LWIP_ASSERT("this needs a pbuf in one piece!", + (p->len >= (IP6_HLEN + IP6_FRAG_HLEN))); + SMEMCPY(rambuf->payload, original_ip6hdr, IP6_HLEN); + ip6hdr = (struct ip6_hdr *)rambuf->payload; + frag_hdr = (struct ip6_frag_hdr *)((u8_t*)rambuf->payload + IP6_HLEN); + + /* Can just adjust p directly for needed offset. */ + p->payload = (u8_t *)p->payload + poff; + p->len -= poff; + p->tot_len -= poff; + + left_to_copy = cop; + while (left_to_copy) { + struct pbuf_custom_ref *pcr; + newpbuflen = (left_to_copy < p->len) ? left_to_copy : p->len; + /* Is this pbuf already empty? */ + if (!newpbuflen) { + p = p->next; + continue; + } + pcr = ip6_frag_alloc_pbuf_custom_ref(); + if (pcr == NULL) { + pbuf_free(rambuf); + IP6_FRAG_STATS_INC(ip6_frag.memerr); + return ERR_MEM; + } + /* Mirror this pbuf, although we might not need all of it. */ + newpbuf = pbuf_alloced_custom(PBUF_RAW, newpbuflen, PBUF_REF, &pcr->pc, p->payload, newpbuflen); + if (newpbuf == NULL) { + ip6_frag_free_pbuf_custom_ref(pcr); + pbuf_free(rambuf); + IP6_FRAG_STATS_INC(ip6_frag.memerr); + return ERR_MEM; + } + pbuf_ref(p); + pcr->original = p; + pcr->pc.custom_free_function = ip6_frag_free_pbuf_custom; + + /* Add it to end of rambuf's chain, but using pbuf_cat, not pbuf_chain + * so that it is removed when pbuf_dechain is later called on rambuf. + */ + pbuf_cat(rambuf, newpbuf); + left_to_copy -= newpbuflen; + if (left_to_copy) { + p = p->next; + } + } + poff = newpbuflen; + + /* Set headers */ + frag_hdr->_nexth = original_ip6hdr->_nexth; + frag_hdr->reserved = 0; + frag_hdr->_fragment_offset = htons((fragment_offset & IP6_FRAG_OFFSET_MASK) | (last ? 0 : IP6_FRAG_MORE_FLAG)); + frag_hdr->_identification = htonl(identification); + + IP6H_NEXTH_SET(ip6hdr, IP6_NEXTH_FRAGMENT); + IP6H_PLEN_SET(ip6hdr, cop + IP6_FRAG_HLEN); + + /* No need for separate header pbuf - we allowed room for it in rambuf + * when allocated. + */ + IP6_FRAG_STATS_INC(ip6_frag.xmit); + netif->output_ip6(netif, rambuf, dest); + + /* Unfortunately we can't reuse rambuf - the hardware may still be + * using the buffer. Instead we free it (and the ensuing chain) and + * recreate it next time round the loop. If we're lucky the hardware + * will have already sent the packet, the free will really free, and + * there will be zero memory penalty. + */ + + pbuf_free(rambuf); + left -= cop; + fragment_offset += cop; + } + return ERR_OK; +} + +#endif /* LWIP_IPV6 && LWIP_IPV6_FRAG */ diff --git a/components/lwip/core/ipv6/mld6.c b/components/lwip/core/ipv6/mld6.c new file mode 100755 index 000000000..6a2d55c54 --- /dev/null +++ b/components/lwip/core/ipv6/mld6.c @@ -0,0 +1,593 @@ +/** + * @file + * + * Multicast listener discovery for IPv6. Aims to be compliant with RFC 2710. + * No support for MLDv2. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +/* Based on igmp.c implementation of igmp v2 protocol */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 && LWIP_IPV6_MLD /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/mld6.h" +#include "lwip/icmp6.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/ip.h" +#include "lwip/inet_chksum.h" +#include "lwip/pbuf.h" +#include "lwip/netif.h" +#include "lwip/memp.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/* + * MLD constants + */ +#define MLD6_HL 1 +#define MLD6_JOIN_DELAYING_MEMBER_TMR_MS (500) + +#define MLD6_GROUP_NON_MEMBER 0 +#define MLD6_GROUP_DELAYING_MEMBER 1 +#define MLD6_GROUP_IDLE_MEMBER 2 + + +/* The list of joined groups. */ +static struct mld_group* mld_group_list; + + +/* Forward declarations. */ +static struct mld_group * mld6_new_group(struct netif *ifp, const ip6_addr_t *addr); +static err_t mld6_free_group(struct mld_group *group); +static void mld6_delayed_report(struct mld_group *group, u16_t maxresp); +static void mld6_send(struct mld_group *group, u8_t type); + + +/** + * Stop MLD processing on interface + * + * @param netif network interface on which stop MLD processing + */ +err_t +mld6_stop(struct netif *netif) +{ + struct mld_group *group = mld_group_list; + struct mld_group *prev = NULL; + struct mld_group *next; + + /* look for groups joined on this interface further down the list */ + while (group != NULL) { + next = group->next; + /* is it a group joined on this interface? */ + if (group->netif == netif) { + /* is it the first group of the list? */ + if (group == mld_group_list) { + mld_group_list = next; + } + /* is there a "previous" group defined? */ + if (prev != NULL) { + prev->next = next; + } + /* disable the group at the MAC level */ + if (netif->mld_mac_filter != NULL) { + netif->mld_mac_filter(netif, &(group->group_address), MLD6_DEL_MAC_FILTER); + } + /* free group */ + memp_free(MEMP_MLD6_GROUP, group); + } else { + /* change the "previous" */ + prev = group; + } + /* move to "next" */ + group = next; + } + return ERR_OK; +} + +/** + * Report MLD memberships for this interface + * + * @param netif network interface on which report MLD memberships + */ +void +mld6_report_groups(struct netif *netif) +{ + struct mld_group *group = mld_group_list; + + while (group != NULL) { + if (group->netif == netif) { + mld6_delayed_report(group, MLD6_JOIN_DELAYING_MEMBER_TMR_MS); + } + group = group->next; + } +} + +/** + * Search for a group that is joined on a netif + * + * @param ifp the network interface for which to look + * @param addr the group ipv6 address to search for + * @return a struct mld_group* if the group has been found, + * NULL if the group wasn't found. + */ +struct mld_group * +mld6_lookfor_group(struct netif *ifp, const ip6_addr_t *addr) +{ + struct mld_group *group = mld_group_list; + + while (group != NULL) { + if ((group->netif == ifp) && (ip6_addr_cmp(&(group->group_address), addr))) { + return group; + } + group = group->next; + } + + return NULL; +} + + +/** + * create a new group + * + * @param ifp the network interface for which to create + * @param addr the new group ipv6 + * @return a struct mld_group*, + * NULL on memory error. + */ +static struct mld_group * +mld6_new_group(struct netif *ifp, const ip6_addr_t *addr) +{ + struct mld_group *group; + + group = (struct mld_group *)memp_malloc(MEMP_MLD6_GROUP); + if (group != NULL) { + group->netif = ifp; + ip6_addr_set(&(group->group_address), addr); + group->timer = 0; /* Not running */ + group->group_state = MLD6_GROUP_IDLE_MEMBER; + group->last_reporter_flag = 0; + group->use = 0; + group->next = mld_group_list; + + mld_group_list = group; + } + + return group; +} + +/** + * Remove a group in the mld_group_list and free + * + * @param group the group to remove + * @return ERR_OK if group was removed from the list, an err_t otherwise + */ +static err_t +mld6_free_group(struct mld_group *group) +{ + err_t err = ERR_OK; + + /* Is it the first group? */ + if (mld_group_list == group) { + mld_group_list = group->next; + } else { + /* look for group further down the list */ + struct mld_group *tmpGroup; + for (tmpGroup = mld_group_list; tmpGroup != NULL; tmpGroup = tmpGroup->next) { + if (tmpGroup->next == group) { + tmpGroup->next = group->next; + break; + } + } + /* Group not find group */ + if (tmpGroup == NULL) { + err = ERR_ARG; + } + } + /* free group */ + memp_free(MEMP_MLD6_GROUP, group); + + return err; +} + + +/** + * Process an input MLD message. Called by icmp6_input. + * + * @param p the mld packet, p->payload pointing to the icmpv6 header + * @param inp the netif on which this packet was received + */ +void +mld6_input(struct pbuf *p, struct netif *inp) +{ + struct mld_header * mld_hdr; + struct mld_group* group; + + MLD6_STATS_INC(mld6.recv); + + /* Check that mld header fits in packet. */ + if (p->len < sizeof(struct mld_header)) { + /* TODO debug message */ + pbuf_free(p); + MLD6_STATS_INC(mld6.lenerr); + MLD6_STATS_INC(mld6.drop); + return; + } + + mld_hdr = (struct mld_header *)p->payload; + + switch (mld_hdr->type) { + case ICMP6_TYPE_MLQ: /* Multicast listener query. */ + /* Is it a general query? */ + if (ip6_addr_isallnodes_linklocal(ip6_current_dest_addr()) && + ip6_addr_isany(&(mld_hdr->multicast_address))) { + MLD6_STATS_INC(mld6.rx_general); + /* Report all groups, except all nodes group, and if-local groups. */ + group = mld_group_list; + while (group != NULL) { + if ((group->netif == inp) && + (!(ip6_addr_ismulticast_iflocal(&(group->group_address)))) && + (!(ip6_addr_isallnodes_linklocal(&(group->group_address))))) { + mld6_delayed_report(group, mld_hdr->max_resp_delay); + } + group = group->next; + } + } else { + /* Have we joined this group? + * We use IP6 destination address to have a memory aligned copy. + * mld_hdr->multicast_address should be the same. */ + MLD6_STATS_INC(mld6.rx_group); + group = mld6_lookfor_group(inp, ip6_current_dest_addr()); + if (group != NULL) { + /* Schedule a report. */ + mld6_delayed_report(group, mld_hdr->max_resp_delay); + } + } + break; /* ICMP6_TYPE_MLQ */ + case ICMP6_TYPE_MLR: /* Multicast listener report. */ + /* Have we joined this group? + * We use IP6 destination address to have a memory aligned copy. + * mld_hdr->multicast_address should be the same. */ + MLD6_STATS_INC(mld6.rx_report); + group = mld6_lookfor_group(inp, ip6_current_dest_addr()); + if (group != NULL) { + /* If we are waiting to report, cancel it. */ + if (group->group_state == MLD6_GROUP_DELAYING_MEMBER) { + group->timer = 0; /* stopped */ + group->group_state = MLD6_GROUP_IDLE_MEMBER; + group->last_reporter_flag = 0; + } + } + break; /* ICMP6_TYPE_MLR */ + case ICMP6_TYPE_MLD: /* Multicast listener done. */ + /* Do nothing, router will query us. */ + break; /* ICMP6_TYPE_MLD */ + default: + MLD6_STATS_INC(mld6.proterr); + MLD6_STATS_INC(mld6.drop); + break; + } + + pbuf_free(p); +} + +/** + * Join a group on a network interface. + * + * @param srcaddr ipv6 address of the network interface which should + * join a new group. If IP6_ADDR_ANY, join on all netifs + * @param groupaddr the ipv6 address of the group to join + * @return ERR_OK if group was joined on the netif(s), an err_t otherwise + */ +err_t +mld6_joingroup(const ip6_addr_t *srcaddr, const ip6_addr_t *groupaddr) +{ + err_t err = ERR_VAL; /* no matching interface */ + struct netif *netif; + + /* loop through netif's */ + netif = netif_list; + while (netif != NULL) { + /* Should we join this interface ? */ + if (ip6_addr_isany(srcaddr) || + netif_get_ip6_addr_match(netif, srcaddr) >= 0) { + err = mld6_joingroup_netif(netif, groupaddr); + if (err != ERR_OK) { + return err; + } + } + + /* proceed to next network interface */ + netif = netif->next; + } + + return err; +} + +/** + * Join a group on a network interface. + * + * @param netif the network interface which should join a new group. + * @param groupaddr the ipv6 address of the group to join + * @return ERR_OK if group was joined on the netif, an err_t otherwise + */ +err_t +mld6_joingroup_netif(struct netif *netif, const ip6_addr_t *groupaddr) +{ + struct mld_group *group; + + /* find group or create a new one if not found */ + group = mld6_lookfor_group(netif, groupaddr); + + if (group == NULL) { + /* Joining a new group. Create a new group entry. */ + group = mld6_new_group(netif, groupaddr); + if (group == NULL) { + return ERR_MEM; + } + + /* Activate this address on the MAC layer. */ + if (netif->mld_mac_filter != NULL) { + netif->mld_mac_filter(netif, groupaddr, MLD6_ADD_MAC_FILTER); + } + + /* Report our membership. */ + MLD6_STATS_INC(mld6.tx_report); + mld6_send(group, ICMP6_TYPE_MLR); + mld6_delayed_report(group, MLD6_JOIN_DELAYING_MEMBER_TMR_MS); + } + + /* Increment group use */ + group->use++; + return ERR_OK; +} + +/** + * Leave a group on a network interface. + * + * @param srcaddr ipv6 address of the network interface which should + * leave the group. If IP6_ISANY, leave on all netifs + * @param groupaddr the ipv6 address of the group to leave + * @return ERR_OK if group was left on the netif(s), an err_t otherwise + */ +err_t +mld6_leavegroup(const ip6_addr_t *srcaddr, const ip6_addr_t *groupaddr) +{ + err_t err = ERR_VAL; /* no matching interface */ + struct netif *netif; + + /* loop through netif's */ + netif = netif_list; + while (netif != NULL) { + /* Should we leave this interface ? */ + if (ip6_addr_isany(srcaddr) || + netif_get_ip6_addr_match(netif, srcaddr) >= 0) { + err_t res = mld6_leavegroup_netif(netif, groupaddr); + if (err != ERR_OK) { + /* Store this result if we have not yet gotten a success */ + err = res; + } + } + /* proceed to next network interface */ + netif = netif->next; + } + + return err; +} + +/** + * Leave a group on a network interface. + * + * @param netif the network interface which should leave the group. + * @param groupaddr the ipv6 address of the group to leave + * @return ERR_OK if group was left on the netif, an err_t otherwise + */ +err_t +mld6_leavegroup_netif(struct netif *netif, const ip6_addr_t *groupaddr) +{ + struct mld_group *group; + + /* find group */ + group = mld6_lookfor_group(netif, groupaddr); + + if (group != NULL) { + /* Leave if there is no other use of the group */ + if (group->use <= 1) { + /* If we are the last reporter for this group */ + if (group->last_reporter_flag) { + MLD6_STATS_INC(mld6.tx_leave); + mld6_send(group, ICMP6_TYPE_MLD); + } + + /* Disable the group at the MAC level */ + if (netif->mld_mac_filter != NULL) { + netif->mld_mac_filter(netif, groupaddr, MLD6_DEL_MAC_FILTER); + } + + /* Free the group */ + mld6_free_group(group); + } else { + /* Decrement group use */ + group->use--; + } + + /* Left group */ + return ERR_OK; + } + + /* Group not found */ + return ERR_VAL; +} + + +/** + * Periodic timer for mld processing. Must be called every + * MLD6_TMR_INTERVAL milliseconds (100). + * + * When a delaying member expires, a membership report is sent. + */ +void +mld6_tmr(void) +{ + struct mld_group *group = mld_group_list; + + while (group != NULL) { + if (group->timer > 0) { + group->timer--; + if (group->timer == 0) { + /* If the state is MLD6_GROUP_DELAYING_MEMBER then we send a report for this group */ + if (group->group_state == MLD6_GROUP_DELAYING_MEMBER) { + MLD6_STATS_INC(mld6.tx_report); + mld6_send(group, ICMP6_TYPE_MLR); + group->group_state = MLD6_GROUP_IDLE_MEMBER; + } + } + } + group = group->next; + } +} + +/** + * Schedule a delayed membership report for a group + * + * @param group the mld_group for which "delaying" membership report + * should be sent + * @param maxresp the max resp delay provided in the query + */ +static void +mld6_delayed_report(struct mld_group *group, u16_t maxresp) +{ + /* Convert maxresp from milliseconds to tmr ticks */ + maxresp = maxresp / MLD6_TMR_INTERVAL; + if (maxresp == 0) { + maxresp = 1; + } + +#ifdef LWIP_RAND + /* Randomize maxresp. (if LWIP_RAND is supported) */ + maxresp = LWIP_RAND() % maxresp; + if (maxresp == 0) { + maxresp = 1; + } +#endif /* LWIP_RAND */ + + /* Apply timer value if no report has been scheduled already. */ + if ((group->group_state == MLD6_GROUP_IDLE_MEMBER) || + ((group->group_state == MLD6_GROUP_DELAYING_MEMBER) && + ((group->timer == 0) || (maxresp < group->timer)))) { + group->timer = maxresp; + group->group_state = MLD6_GROUP_DELAYING_MEMBER; + } +} + +/** + * Send a MLD message (report or done). + * + * An IPv6 hop-by-hop options header with a router alert option + * is prepended. + * + * @param group the group to report or quit + * @param type ICMP6_TYPE_MLR (report) or ICMP6_TYPE_MLD (done) + */ +static void +mld6_send(struct mld_group *group, u8_t type) +{ + struct mld_header * mld_hdr; + struct pbuf * p; + const ip6_addr_t * src_addr; + + /* Allocate a packet. Size is MLD header + IPv6 Hop-by-hop options header. */ + p = pbuf_alloc(PBUF_IP, sizeof(struct mld_header) + sizeof(struct ip6_hbh_hdr), PBUF_RAM); + if (p == NULL) { + MLD6_STATS_INC(mld6.memerr); + return; + } + + /* Move to make room for Hop-by-hop options header. */ + if (pbuf_header(p, -IP6_HBH_HLEN)) { + pbuf_free(p); + MLD6_STATS_INC(mld6.lenerr); + return; + } + + /* Select our source address. */ + if (!ip6_addr_isvalid(netif_ip6_addr_state(group->netif, 0))) { + /* This is a special case, when we are performing duplicate address detection. + * We must join the multicast group, but we don't have a valid address yet. */ + src_addr = IP6_ADDR_ANY6; + } else { + /* Use link-local address as source address. */ + src_addr = netif_ip6_addr(group->netif, 0); + } + + /* MLD message header pointer. */ + mld_hdr = (struct mld_header *)p->payload; + + /* Set fields. */ + mld_hdr->type = type; + mld_hdr->code = 0; + mld_hdr->chksum = 0; + mld_hdr->max_resp_delay = 0; + mld_hdr->reserved = 0; + ip6_addr_set(&(mld_hdr->multicast_address), &(group->group_address)); + +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(group->netif, NETIF_CHECKSUM_GEN_ICMP6) { + mld_hdr->chksum = ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->len, + src_addr, &(group->group_address)); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + /* Add hop-by-hop headers options: router alert with MLD value. */ + ip6_options_add_hbh_ra(p, IP6_NEXTH_ICMP6, IP6_ROUTER_ALERT_VALUE_MLD); + + /* Send the packet out. */ + MLD6_STATS_INC(mld6.xmit); + ip6_output_if(p, (ip6_addr_isany(src_addr)) ? NULL : src_addr, &(group->group_address), + MLD6_HL, 0, IP6_NEXTH_HOPBYHOP, group->netif); + pbuf_free(p); +} + +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/ipv6/nd6.c b/components/lwip/core/ipv6/nd6.c new file mode 100755 index 000000000..39e7bfed0 --- /dev/null +++ b/components/lwip/core/ipv6/nd6.c @@ -0,0 +1,1846 @@ +/** + * @file + * + * Neighbor discovery and stateless address autoconfiguration for IPv6. + * Aims to be compliant with RFC 4861 (Neighbor discovery) and RFC 4862 + * (Address autoconfiguration). + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/nd6.h" +#include "lwip/pbuf.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/icmp6.h" +#include "lwip/mld6.h" +#include "lwip/ip.h" +#include "lwip/stats.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/* Router tables. */ +struct nd6_neighbor_cache_entry neighbor_cache[LWIP_ND6_NUM_NEIGHBORS]; +struct nd6_destination_cache_entry destination_cache[LWIP_ND6_NUM_DESTINATIONS]; +struct nd6_prefix_list_entry prefix_list[LWIP_ND6_NUM_PREFIXES]; +struct nd6_router_list_entry default_router_list[LWIP_ND6_NUM_ROUTERS]; + +/* Default values, can be updated by a RA message. */ +u32_t reachable_time = LWIP_ND6_REACHABLE_TIME; +u32_t retrans_timer = LWIP_ND6_RETRANS_TIMER; /* TODO implement this value in timer */ + +/* Index for cache entries. */ +static u8_t nd6_cached_neighbor_index; +static u8_t nd6_cached_destination_index; + +/* Multicast address holder. */ +static ip6_addr_t multicast_address; + +/* Static buffer to parse RA packet options (size of a prefix option, biggest option) */ +static u8_t nd6_ra_buffer[sizeof(struct prefix_option)]; + +/* Forward declarations. */ +static s8_t nd6_find_neighbor_cache_entry(const ip6_addr_t * ip6addr); +static s8_t nd6_new_neighbor_cache_entry(void); +static void nd6_free_neighbor_cache_entry(s8_t i); +static s8_t nd6_find_destination_cache_entry(const ip6_addr_t * ip6addr); +static s8_t nd6_new_destination_cache_entry(void); +static s8_t nd6_is_prefix_in_netif(const ip6_addr_t * ip6addr, struct netif * netif); +static s8_t nd6_get_router(const ip6_addr_t * router_addr, struct netif * netif); +static s8_t nd6_new_router(const ip6_addr_t * router_addr, struct netif * netif); +static s8_t nd6_get_onlink_prefix(ip6_addr_t * prefix, struct netif * netif); +static s8_t nd6_new_onlink_prefix(ip6_addr_t * prefix, struct netif * netif); + +#define ND6_SEND_FLAG_MULTICAST_DEST 0x01 +#define ND6_SEND_FLAG_ALLNODES_DEST 0x02 +static void nd6_send_ns(struct netif * netif, const ip6_addr_t * target_addr, u8_t flags); +static void nd6_send_na(struct netif * netif, const ip6_addr_t * target_addr, u8_t flags); +#if LWIP_IPV6_SEND_ROUTER_SOLICIT +static err_t nd6_send_rs(struct netif * netif); +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + +#if LWIP_ND6_QUEUEING +static void nd6_free_q(struct nd6_q_entry *q); +#else /* LWIP_ND6_QUEUEING */ +#define nd6_free_q(q) pbuf_free(q) +#endif /* LWIP_ND6_QUEUEING */ +static void nd6_send_q(s8_t i); + + +/** + * Process an incoming neighbor discovery message + * + * @param p the nd packet, p->payload pointing to the icmpv6 header + * @param inp the netif on which this packet was received + */ +void +nd6_input(struct pbuf *p, struct netif *inp) +{ + u8_t msg_type; + s8_t i; + + ND6_STATS_INC(nd6.recv); + + msg_type = *((u8_t *)p->payload); + switch (msg_type) { + case ICMP6_TYPE_NA: /* Neighbor Advertisement. */ + { + struct na_header * na_hdr; + struct lladdr_option * lladdr_opt; + + /* Check that na header fits in packet. */ + if (p->len < (sizeof(struct na_header))) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + na_hdr = (struct na_header *)p->payload; + + /* Unsolicited NA?*/ + if (ip6_addr_ismulticast(ip6_current_dest_addr())) { + /* This is an unsolicited NA. + * link-layer changed? + * part of DAD mechanism? */ + + /* Check that link-layer address option also fits in packet. */ + if (p->len < (sizeof(struct na_header) + 2)) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct na_header)); + + if (p->len < (sizeof(struct na_header) + (lladdr_opt->length << 3))) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + /* Override ip6_current_dest_addr() so that we have an aligned copy. */ + ip6_addr_set(ip6_current_dest_addr(), &(na_hdr->target_address)); + +#if LWIP_IPV6_DUP_DETECT_ATTEMPTS + /* If the target address matches this netif, it is a DAD response. */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (!ip6_addr_isinvalid(netif_ip6_addr_state(inp, i)) && + ip6_addr_cmp(ip6_current_dest_addr(), netif_ip6_addr(inp, i))) { + /* We are using a duplicate address. */ + netif_ip6_addr_set_state(inp, i, IP6_ADDR_INVALID); + +#if LWIP_IPV6_MLD + /* Leave solicited node multicast group. */ + ip6_addr_set_solicitednode(&multicast_address, netif_ip6_addr(inp, i)->addr[3]); + mld6_leavegroup(netif_ip6_addr(inp, i), &multicast_address); +#endif /* LWIP_IPV6_MLD */ + +#if LWIP_IPV6_AUTOCONFIG + /* Check to see if this address was autoconfigured. */ + if (!ip6_addr_islinklocal(ip6_current_dest_addr())) { + i = nd6_get_onlink_prefix(ip6_current_dest_addr(), inp); + if (i >= 0) { + /* Mark this prefix as duplicate, so that we don't use it + * to generate this address again. */ + prefix_list[i].flags |= ND6_PREFIX_AUTOCONFIG_ADDRESS_DUPLICATE; + } + } +#endif /* LWIP_IPV6_AUTOCONFIG */ + + pbuf_free(p); + return; + } + } +#endif /* LWIP_IPV6_DUP_DETECT_ATTEMPTS */ + + /* This is an unsolicited NA, most likely there was a LLADDR change. */ + i = nd6_find_neighbor_cache_entry(ip6_current_dest_addr()); + if (i >= 0) { + if (na_hdr->flags & ND6_FLAG_OVERRIDE) { + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + } + } + } else { + /* This is a solicited NA. + * neighbor address resolution response? + * neighbor unreachability detection response? */ + + /* Override ip6_current_dest_addr() so that we have an aligned copy. */ + ip6_addr_set(ip6_current_dest_addr(), &(na_hdr->target_address)); + + /* Find the cache entry corresponding to this na. */ + i = nd6_find_neighbor_cache_entry(ip6_current_dest_addr()); + if (i < 0) { + /* We no longer care about this target address. drop it. */ + pbuf_free(p); + return; + } + + /* Update cache entry. */ + neighbor_cache[i].netif = inp; + neighbor_cache[i].counter.reachable_time = reachable_time; + if ((na_hdr->flags & ND6_FLAG_OVERRIDE) || + (neighbor_cache[i].state == ND6_INCOMPLETE)) { + /* Check that link-layer address option also fits in packet. */ + if (p->len < (sizeof(struct na_header) + 2)) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct na_header)); + + if (p->len < (sizeof(struct na_header) + (lladdr_opt->length << 3))) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + } + neighbor_cache[i].state = ND6_REACHABLE; + + /* Send queued packets, if any. */ + if (neighbor_cache[i].q != NULL) { + nd6_send_q(i); + } + } + + break; /* ICMP6_TYPE_NA */ + } + case ICMP6_TYPE_NS: /* Neighbor solicitation. */ + { + struct ns_header * ns_hdr; + struct lladdr_option * lladdr_opt; + u8_t accepted; + + /* Check that ns header fits in packet. */ + if (p->len < sizeof(struct ns_header)) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + ns_hdr = (struct ns_header *)p->payload; + + /* Check if there is a link-layer address provided. Only point to it if in this buffer. */ + if (p->len >= (sizeof(struct ns_header) + 2)) { + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct ns_header)); + if (p->len < (sizeof(struct ns_header) + (lladdr_opt->length << 3))) { + lladdr_opt = NULL; + } + } else { + lladdr_opt = NULL; + } + + /* Check if the target address is configured on the receiving netif. */ + accepted = 0; + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; ++i) { + if ((ip6_addr_isvalid(netif_ip6_addr_state(inp, i)) || + (ip6_addr_istentative(netif_ip6_addr_state(inp, i)) && + ip6_addr_isany(ip6_current_src_addr()))) && + ip6_addr_cmp(&(ns_hdr->target_address), netif_ip6_addr(inp, i))) { + accepted = 1; + break; + } + } + + /* NS not for us? */ + if (!accepted) { + pbuf_free(p); + return; + } + + /* Check for ANY address in src (DAD algorithm). */ + if (ip6_addr_isany(ip6_current_src_addr())) { + /* Sender is validating this address. */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; ++i) { + if (!ip6_addr_isinvalid(netif_ip6_addr_state(inp, i)) && + ip6_addr_cmp(&(ns_hdr->target_address), netif_ip6_addr(inp, i))) { + /* Send a NA back so that the sender does not use this address. */ + nd6_send_na(inp, netif_ip6_addr(inp, i), ND6_FLAG_OVERRIDE | ND6_SEND_FLAG_ALLNODES_DEST); + if (ip6_addr_istentative(netif_ip6_addr_state(inp, i))) { + /* We shouldn't use this address either. */ + netif_ip6_addr_set_state(inp, i, IP6_ADDR_INVALID); + } + } + } + } else { + /* Sender is trying to resolve our address. */ + /* Verify that they included their own link-layer address. */ + if (lladdr_opt == NULL) { + /* Not a valid message. */ + pbuf_free(p); + ND6_STATS_INC(nd6.proterr); + ND6_STATS_INC(nd6.drop); + return; + } + + i = nd6_find_neighbor_cache_entry(ip6_current_src_addr()); + if (i>= 0) { + /* We already have a record for the solicitor. */ + if (neighbor_cache[i].state == ND6_INCOMPLETE) { + neighbor_cache[i].netif = inp; + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + + /* Delay probe in case we get confirmation of reachability from upper layer (TCP). */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + } else { + /* Add their IPv6 address and link-layer address to neighbor cache. + * We will need it at least to send a unicast NA message, but most + * likely we will also be communicating with this node soon. */ + i = nd6_new_neighbor_cache_entry(); + if (i < 0) { + /* We couldn't assign a cache entry for this neighbor. + * we won't be able to reply. drop it. */ + pbuf_free(p); + ND6_STATS_INC(nd6.memerr); + return; + } + neighbor_cache[i].netif = inp; + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + ip6_addr_set(&(neighbor_cache[i].next_hop_address), ip6_current_src_addr()); + + /* Receiving a message does not prove reachability: only in one direction. + * Delay probe in case we get confirmation of reachability from upper layer (TCP). */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + + /* Override ip6_current_dest_addr() so that we have an aligned copy. */ + ip6_addr_set(ip6_current_dest_addr(), &(ns_hdr->target_address)); + + /* Send back a NA for us. Allocate the reply pbuf. */ + nd6_send_na(inp, ip6_current_dest_addr(), ND6_FLAG_SOLICITED | ND6_FLAG_OVERRIDE); + } + + break; /* ICMP6_TYPE_NS */ + } + case ICMP6_TYPE_RA: /* Router Advertisement. */ + { + struct ra_header * ra_hdr; + u8_t * buffer; /* Used to copy options. */ + u16_t offset; + + /* Check that RA header fits in packet. */ + if (p->len < sizeof(struct ra_header)) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + ra_hdr = (struct ra_header *)p->payload; + + /* If we are sending RS messages, stop. */ +#if LWIP_IPV6_SEND_ROUTER_SOLICIT + /* ensure at least one solicitation is sent */ + if ((inp->rs_count < LWIP_ND6_MAX_MULTICAST_SOLICIT) || + (nd6_send_rs(inp) == ERR_OK)) { + inp->rs_count = 0; + } +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + + /* Get the matching default router entry. */ + i = nd6_get_router(ip6_current_src_addr(), inp); + if (i < 0) { + /* Create a new router entry. */ + i = nd6_new_router(ip6_current_src_addr(), inp); + } + + if (i < 0) { + /* Could not create a new router entry. */ + pbuf_free(p); + ND6_STATS_INC(nd6.memerr); + return; + } + + /* Re-set invalidation timer. */ + default_router_list[i].invalidation_timer = htons(ra_hdr->router_lifetime); + + /* Re-set default timer values. */ +#if LWIP_ND6_ALLOW_RA_UPDATES + if (ra_hdr->retrans_timer > 0) { + retrans_timer = htonl(ra_hdr->retrans_timer); + } + if (ra_hdr->reachable_time > 0) { + reachable_time = htonl(ra_hdr->reachable_time); + } +#endif /* LWIP_ND6_ALLOW_RA_UPDATES */ + + /* TODO set default hop limit... */ + /* ra_hdr->current_hop_limit;*/ + + /* Update flags in local entry (incl. preference). */ + default_router_list[i].flags = ra_hdr->flags; + + /* Offset to options. */ + offset = sizeof(struct ra_header); + + /* Process each option. */ + while ((p->tot_len - offset) > 0) { + if (p->len == p->tot_len) { + /* no need to copy from contiguous pbuf */ + buffer = &((u8_t*)p->payload)[offset]; + } else { + buffer = nd6_ra_buffer; + pbuf_copy_partial(p, buffer, sizeof(struct prefix_option), offset); + } + switch (buffer[0]) { + case ND6_OPTION_TYPE_SOURCE_LLADDR: + { + struct lladdr_option * lladdr_opt; + lladdr_opt = (struct lladdr_option *)buffer; + if ((default_router_list[i].neighbor_entry != NULL) && + (default_router_list[i].neighbor_entry->state == ND6_INCOMPLETE)) { + SMEMCPY(default_router_list[i].neighbor_entry->lladdr, lladdr_opt->addr, inp->hwaddr_len); + default_router_list[i].neighbor_entry->state = ND6_REACHABLE; + default_router_list[i].neighbor_entry->counter.reachable_time = reachable_time; + } + break; + } + case ND6_OPTION_TYPE_MTU: + { + struct mtu_option * mtu_opt; + mtu_opt = (struct mtu_option *)buffer; + if (htonl(mtu_opt->mtu) >= 1280) { +#if LWIP_ND6_ALLOW_RA_UPDATES + inp->mtu = (u16_t)htonl(mtu_opt->mtu); +#endif /* LWIP_ND6_ALLOW_RA_UPDATES */ + } + break; + } + case ND6_OPTION_TYPE_PREFIX_INFO: + { + struct prefix_option * prefix_opt; + prefix_opt = (struct prefix_option *)buffer; + + if (prefix_opt->flags & ND6_PREFIX_FLAG_ON_LINK) { + /* Add to on-link prefix list. */ + s8_t prefix; + + /* Get a memory-aligned copy of the prefix. */ + ip6_addr_set(ip6_current_dest_addr(), &(prefix_opt->prefix)); + + /* find cache entry for this prefix. */ + prefix = nd6_get_onlink_prefix(ip6_current_dest_addr(), inp); + if (prefix < 0) { + /* Create a new cache entry. */ + prefix = nd6_new_onlink_prefix(ip6_current_dest_addr(), inp); + } + if (prefix >= 0) { + prefix_list[prefix].invalidation_timer = htonl(prefix_opt->valid_lifetime); + +#if LWIP_IPV6_AUTOCONFIG + if (prefix_opt->flags & ND6_PREFIX_FLAG_AUTONOMOUS) { + /* Mark prefix as autonomous, so that address autoconfiguration can take place. + * Only OR flag, so that we don't over-write other flags (such as ADDRESS_DUPLICATE)*/ + prefix_list[prefix].flags |= ND6_PREFIX_AUTOCONFIG_AUTONOMOUS; + } +#endif /* LWIP_IPV6_AUTOCONFIG */ + } + } + + break; + } + case ND6_OPTION_TYPE_ROUTE_INFO: + /* TODO implement preferred routes. + struct route_option * route_opt; + route_opt = (struct route_option *)buffer;*/ + + break; + default: + /* Unrecognized option, abort. */ + ND6_STATS_INC(nd6.proterr); + break; + } + offset += 8 * ((u16_t)buffer[1]); + } + + break; /* ICMP6_TYPE_RA */ + } + case ICMP6_TYPE_RD: /* Redirect */ + { + struct redirect_header * redir_hdr; + struct lladdr_option * lladdr_opt; + + /* Check that Redir header fits in packet. */ + if (p->len < sizeof(struct redirect_header)) { + /* TODO debug message */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + redir_hdr = (struct redirect_header *)p->payload; + + if (p->len >= (sizeof(struct redirect_header) + 2)) { + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct redirect_header)); + if (p->len < (sizeof(struct redirect_header) + (lladdr_opt->length << 3))) { + lladdr_opt = NULL; + } + } else { + lladdr_opt = NULL; + } + + /* Copy original destination address to current source address, to have an aligned copy. */ + ip6_addr_set(ip6_current_src_addr(), &(redir_hdr->destination_address)); + + /* Find dest address in cache */ + i = nd6_find_destination_cache_entry(ip6_current_src_addr()); + if (i < 0) { + /* Destination not in cache, drop packet. */ + pbuf_free(p); + return; + } + + /* Set the new target address. */ + ip6_addr_set(&(destination_cache[i].next_hop_addr), &(redir_hdr->target_address)); + + /* If Link-layer address of other router is given, try to add to neighbor cache. */ + if (lladdr_opt != NULL) { + if (lladdr_opt->type == ND6_OPTION_TYPE_TARGET_LLADDR) { + /* Copy target address to current source address, to have an aligned copy. */ + ip6_addr_set(ip6_current_src_addr(), &(redir_hdr->target_address)); + + i = nd6_find_neighbor_cache_entry(ip6_current_src_addr()); + if (i < 0) { + i = nd6_new_neighbor_cache_entry(); + if (i >= 0) { + neighbor_cache[i].netif = inp; + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + ip6_addr_set(&(neighbor_cache[i].next_hop_address), ip6_current_src_addr()); + + /* Receiving a message does not prove reachability: only in one direction. + * Delay probe in case we get confirmation of reachability from upper layer (TCP). */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + } + if (i >= 0) { + if (neighbor_cache[i].state == ND6_INCOMPLETE) { + MEMCPY(neighbor_cache[i].lladdr, lladdr_opt->addr, inp->hwaddr_len); + /* Receiving a message does not prove reachability: only in one direction. + * Delay probe in case we get confirmation of reachability from upper layer (TCP). */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + } + } + } + break; /* ICMP6_TYPE_RD */ + } + case ICMP6_TYPE_PTB: /* Packet too big */ + { + struct icmp6_hdr *icmp6hdr; /* Packet too big message */ + struct ip6_hdr * ip6hdr; /* IPv6 header of the packet which caused the error */ + u32_t pmtu; + + /* Check that ICMPv6 header + IPv6 header fit in payload */ + if (p->len < (sizeof(struct icmp6_hdr) + IP6_HLEN)) { + /* drop short packets */ + pbuf_free(p); + ND6_STATS_INC(nd6.lenerr); + ND6_STATS_INC(nd6.drop); + return; + } + + icmp6hdr = (struct icmp6_hdr *)p->payload; + ip6hdr = (struct ip6_hdr *)((u8_t*)p->payload + sizeof(struct icmp6_hdr)); + + /* Copy original destination address to current source address, to have an aligned copy. */ + ip6_addr_set(ip6_current_src_addr(), &(ip6hdr->dest)); + + /* Look for entry in destination cache. */ + i = nd6_find_destination_cache_entry(ip6_current_src_addr()); + if (i < 0) { + /* Destination not in cache, drop packet. */ + pbuf_free(p); + return; + } + + /* Change the Path MTU. */ + pmtu = htonl(icmp6hdr->data); + destination_cache[i].pmtu = (u16_t)LWIP_MIN(pmtu, 0xFFFF); + + break; /* ICMP6_TYPE_PTB */ + } + + default: + ND6_STATS_INC(nd6.proterr); + ND6_STATS_INC(nd6.drop); + break; /* default */ + } + + pbuf_free(p); +} + + +/** + * Periodic timer for Neighbor discovery functions: + * + * - Update neighbor reachability states + * - Update destination cache entries age + * - Update invalidation timers of default routers and on-link prefixes + * - Perform duplicate address detection (DAD) for our addresses + * - Send router solicitations + */ +void +nd6_tmr(void) +{ + s8_t i; + struct netif * netif; + + /* Process neighbor entries. */ + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + switch (neighbor_cache[i].state) { + case ND6_INCOMPLETE: + if ((neighbor_cache[i].counter.probes_sent >= LWIP_ND6_MAX_MULTICAST_SOLICIT) && + (!neighbor_cache[i].isrouter)) { + /* Retries exceeded. */ + nd6_free_neighbor_cache_entry(i); + } else { + /* Send a NS for this entry. */ + neighbor_cache[i].counter.probes_sent++; + nd6_send_ns(neighbor_cache[i].netif, &(neighbor_cache[i].next_hop_address), ND6_SEND_FLAG_MULTICAST_DEST); + } + break; + case ND6_REACHABLE: + /* Send queued packets, if any are left. Should have been sent already. */ + if (neighbor_cache[i].q != NULL) { + nd6_send_q(i); + } + if (neighbor_cache[i].counter.reachable_time <= ND6_TMR_INTERVAL) { + /* Change to stale state. */ + neighbor_cache[i].state = ND6_STALE; + neighbor_cache[i].counter.stale_time = 0; + } else { + neighbor_cache[i].counter.reachable_time -= ND6_TMR_INTERVAL; + } + break; + case ND6_STALE: + neighbor_cache[i].counter.stale_time += ND6_TMR_INTERVAL; + break; + case ND6_DELAY: + if (neighbor_cache[i].counter.delay_time <= ND6_TMR_INTERVAL) { + /* Change to PROBE state. */ + neighbor_cache[i].state = ND6_PROBE; + neighbor_cache[i].counter.probes_sent = 0; + } else { + neighbor_cache[i].counter.delay_time -= ND6_TMR_INTERVAL; + } + break; + case ND6_PROBE: + if ((neighbor_cache[i].counter.probes_sent >= LWIP_ND6_MAX_MULTICAST_SOLICIT) && + (!neighbor_cache[i].isrouter)) { + /* Retries exceeded. */ + nd6_free_neighbor_cache_entry(i); + } else { + /* Send a NS for this entry. */ + neighbor_cache[i].counter.probes_sent++; + nd6_send_ns(neighbor_cache[i].netif, &(neighbor_cache[i].next_hop_address), 0); + } + break; + case ND6_NO_ENTRY: + default: + /* Do nothing. */ + break; + } + } + + /* Process destination entries. */ + for (i = 0; i < LWIP_ND6_NUM_DESTINATIONS; i++) { + destination_cache[i].age++; + } + + /* Process router entries. */ + for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) { + if (default_router_list[i].neighbor_entry != NULL) { + /* Active entry. */ + if (default_router_list[i].invalidation_timer > 0) { + default_router_list[i].invalidation_timer -= ND6_TMR_INTERVAL / 1000; + } + if (default_router_list[i].invalidation_timer < ND6_TMR_INTERVAL / 1000) { + /* Less than 1 second remaining. Clear this entry. */ + default_router_list[i].neighbor_entry->isrouter = 0; + default_router_list[i].neighbor_entry = NULL; + default_router_list[i].invalidation_timer = 0; + default_router_list[i].flags = 0; + } + } + } + + /* Process prefix entries. */ + for (i = 0; i < LWIP_ND6_NUM_PREFIXES; i++) { + if (prefix_list[i].netif != NULL) { + if (prefix_list[i].invalidation_timer < ND6_TMR_INTERVAL / 1000) { + /* Entry timed out, remove it */ + prefix_list[i].invalidation_timer = 0; + +#if LWIP_IPV6_AUTOCONFIG + /* If any addresses were configured with this prefix, remove them */ + if (prefix_list[i].flags & ND6_PREFIX_AUTOCONFIG_ADDRESS_GENERATED) + { + s8_t j; + + for (j = 1; j < LWIP_IPV6_NUM_ADDRESSES; j++) { + if ((netif_ip6_addr_state(prefix_list[i].netif, j) != IP6_ADDR_INVALID) && + ip6_addr_netcmp(&prefix_list[i].prefix, netif_ip6_addr(prefix_list[i].netif, j))) { + netif_ip6_addr_set_state(prefix_list[i].netif, j, IP6_ADDR_INVALID); + prefix_list[i].flags = 0; + + /* Exit loop. */ + break; + } + } + } +#endif /* LWIP_IPV6_AUTOCONFIG */ + + prefix_list[i].netif = NULL; + prefix_list[i].flags = 0; + } else { + prefix_list[i].invalidation_timer -= ND6_TMR_INTERVAL / 1000; + +#if LWIP_IPV6_AUTOCONFIG + /* Initiate address autoconfiguration for this prefix, if conditions are met. */ + if (prefix_list[i].netif->ip6_autoconfig_enabled && + (prefix_list[i].flags & ND6_PREFIX_AUTOCONFIG_AUTONOMOUS) && + !(prefix_list[i].flags & ND6_PREFIX_AUTOCONFIG_ADDRESS_GENERATED)) { + s8_t j; + /* Try to get an address on this netif that is invalid. + * Skip 0 index (link-local address) */ + for (j = 1; j < LWIP_IPV6_NUM_ADDRESSES; j++) { + if (netif_ip6_addr_state(prefix_list[i].netif, j) == IP6_ADDR_INVALID) { + /* Generate an address using this prefix and interface ID from link-local address. */ + IP_ADDR6(&prefix_list[i].netif->ip6_addr[j], + prefix_list[i].prefix.addr[0], prefix_list[i].prefix.addr[1], + netif_ip6_addr(prefix_list[i].netif, 0)->addr[2], netif_ip6_addr(prefix_list[i].netif, 0)->addr[3]); + + /* Mark it as tentative (DAD will be performed if configured). */ + netif_ip6_addr_set_state(prefix_list[i].netif, j, IP6_ADDR_TENTATIVE); + + /* Mark this prefix with ADDRESS_GENERATED, so that we don't try again. */ + prefix_list[i].flags |= ND6_PREFIX_AUTOCONFIG_ADDRESS_GENERATED; + + /* Exit loop. */ + break; + } + } + } +#endif /* LWIP_IPV6_AUTOCONFIG */ + } + } + } + + + /* Process our own addresses, if DAD configured. */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; ++i) { + if (ip6_addr_istentative(netif->ip6_addr_state[i])) { + if ((netif->ip6_addr_state[i] & 0x07) >= LWIP_IPV6_DUP_DETECT_ATTEMPTS) { + /* No NA received in response. Mark address as valid. */ + netif->ip6_addr_state[i] = IP6_ADDR_PREFERRED; + /* TODO implement preferred and valid lifetimes. */ + } else if (netif->flags & NETIF_FLAG_UP) { +#if LWIP_IPV6_MLD + if ((netif->ip6_addr_state[i] & 0x07) == 0) { + /* Join solicited node multicast group. */ + ip6_addr_set_solicitednode(&multicast_address, netif_ip6_addr(netif, i)->addr[3]); + mld6_joingroup(netif_ip6_addr(netif, i), &multicast_address); + } +#endif /* LWIP_IPV6_MLD */ + /* Send a NS for this address. */ + nd6_send_ns(netif, netif_ip6_addr(netif, i), ND6_SEND_FLAG_MULTICAST_DEST); + (netif->ip6_addr_state[i])++; + /* TODO send max 1 NS per tmr call? enable return*/ + /*return;*/ + } + } + } + } + +#if LWIP_IPV6_SEND_ROUTER_SOLICIT + /* Send router solicitation messages, if necessary. */ + for (netif = netif_list; netif != NULL; netif = netif->next) { + if ((netif->rs_count > 0) && (netif->flags & NETIF_FLAG_UP) && + (!ip6_addr_isinvalid(netif_ip6_addr_state(netif, 0)))) { + if (nd6_send_rs(netif) == ERR_OK) { + netif->rs_count--; + } + } + } +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + +} + +/** + * Send a neighbor solicitation message + * + * @param netif the netif on which to send the message + * @param target_addr the IPv6 target address for the ND message + * @param flags one of ND6_SEND_FLAG_* + */ +static void +nd6_send_ns(struct netif * netif, const ip6_addr_t * target_addr, u8_t flags) +{ + struct ns_header * ns_hdr; + struct lladdr_option * lladdr_opt; + struct pbuf * p; + const ip6_addr_t * src_addr; + u16_t lladdr_opt_len; + + if (ip6_addr_isvalid(netif_ip6_addr_state(netif,0))) { + /* Use link-local address as source address. */ + src_addr = netif_ip6_addr(netif, 0); + } else { + src_addr = IP6_ADDR_ANY6; + } + + /* Allocate a packet. */ + lladdr_opt_len = ((netif->hwaddr_len + 2) >> 3) + (((netif->hwaddr_len + 2) & 0x07) ? 1 : 0); + p = pbuf_alloc(PBUF_IP, sizeof(struct ns_header) + (lladdr_opt_len << 3), PBUF_RAM); + if (p == NULL) { + ND6_STATS_INC(nd6.memerr); + return; + } + + /* Set fields. */ + ns_hdr = (struct ns_header *)p->payload; + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct ns_header)); + + ns_hdr->type = ICMP6_TYPE_NS; + ns_hdr->code = 0; + ns_hdr->chksum = 0; + ns_hdr->reserved = 0; + ip6_addr_set(&(ns_hdr->target_address), target_addr); + + lladdr_opt->type = ND6_OPTION_TYPE_SOURCE_LLADDR; + lladdr_opt->length = (u8_t)lladdr_opt_len; + SMEMCPY(lladdr_opt->addr, netif->hwaddr, netif->hwaddr_len); + + /* Generate the solicited node address for the target address. */ + if (flags & ND6_SEND_FLAG_MULTICAST_DEST) { + ip6_addr_set_solicitednode(&multicast_address, target_addr->addr[3]); + target_addr = &multicast_address; + } + +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP6) { + ns_hdr->chksum = ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->len, src_addr, + target_addr); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + /* Send the packet out. */ + ND6_STATS_INC(nd6.xmit); + ip6_output_if(p, (src_addr == IP6_ADDR_ANY6) ? NULL : src_addr, target_addr, + LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, netif); + pbuf_free(p); +} + +/** + * Send a neighbor advertisement message + * + * @param netif the netif on which to send the message + * @param target_addr the IPv6 target address for the ND message + * @param flags one of ND6_SEND_FLAG_* + */ +static void +nd6_send_na(struct netif * netif, const ip6_addr_t * target_addr, u8_t flags) +{ + struct na_header * na_hdr; + struct lladdr_option * lladdr_opt; + struct pbuf * p; + const ip6_addr_t * src_addr; + const ip6_addr_t * dest_addr; + u16_t lladdr_opt_len; + + /* Use link-local address as source address. */ + /* src_addr = &(netif->ip6_addr[0]); */ + /* Use target address as source address. */ + src_addr = target_addr; + + /* Allocate a packet. */ + lladdr_opt_len = ((netif->hwaddr_len + 2) >> 3) + (((netif->hwaddr_len + 2) & 0x07) ? 1 : 0); + p = pbuf_alloc(PBUF_IP, sizeof(struct na_header) + (lladdr_opt_len << 3), PBUF_RAM); + if (p == NULL) { + ND6_STATS_INC(nd6.memerr); + return; + } + + /* Set fields. */ + na_hdr = (struct na_header *)p->payload; + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct na_header)); + + na_hdr->type = ICMP6_TYPE_NA; + na_hdr->code = 0; + na_hdr->chksum = 0; + na_hdr->flags = flags & 0xf0; + na_hdr->reserved[0] = 0; + na_hdr->reserved[1] = 0; + na_hdr->reserved[2] = 0; + ip6_addr_set(&(na_hdr->target_address), target_addr); + + lladdr_opt->type = ND6_OPTION_TYPE_TARGET_LLADDR; + lladdr_opt->length = (u8_t)lladdr_opt_len; + SMEMCPY(lladdr_opt->addr, netif->hwaddr, netif->hwaddr_len); + + /* Generate the solicited node address for the target address. */ + if (flags & ND6_SEND_FLAG_MULTICAST_DEST) { + ip6_addr_set_solicitednode(&multicast_address, target_addr->addr[3]); + dest_addr = &multicast_address; + } else if (flags & ND6_SEND_FLAG_ALLNODES_DEST) { + ip6_addr_set_allnodes_linklocal(&multicast_address); + dest_addr = &multicast_address; + } else { + dest_addr = ip6_current_src_addr(); + } + +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP6) { + na_hdr->chksum = ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->len, src_addr, + dest_addr); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + /* Send the packet out. */ + ND6_STATS_INC(nd6.xmit); + ip6_output_if(p, src_addr, dest_addr, + LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, netif); + pbuf_free(p); +} + +#if LWIP_IPV6_SEND_ROUTER_SOLICIT +/** + * Send a router solicitation message + * + * @param netif the netif on which to send the message + */ +static err_t +nd6_send_rs(struct netif * netif) +{ + struct rs_header * rs_hdr; + struct lladdr_option * lladdr_opt; + struct pbuf * p; + const ip6_addr_t * src_addr; + err_t err; + u16_t lladdr_opt_len = 0; + + /* Link-local source address, or unspecified address? */ + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, 0))) { + src_addr = netif_ip6_addr(netif, 0); + } else { + src_addr = IP6_ADDR_ANY6; + } + + /* Generate the all routers target address. */ + ip6_addr_set_allrouters_linklocal(&multicast_address); + + /* Allocate a packet. */ + if (src_addr != IP6_ADDR_ANY6) { + lladdr_opt_len = ((netif->hwaddr_len + 2) >> 3) + (((netif->hwaddr_len + 2) & 0x07) ? 1 : 0); + } + p = pbuf_alloc(PBUF_IP, sizeof(struct rs_header) + (lladdr_opt_len << 3), PBUF_RAM); + if (p == NULL) { + ND6_STATS_INC(nd6.memerr); + return ERR_BUF; + } + + /* Set fields. */ + rs_hdr = (struct rs_header *)p->payload; + + rs_hdr->type = ICMP6_TYPE_RS; + rs_hdr->code = 0; + rs_hdr->chksum = 0; + rs_hdr->reserved = 0; + + if (src_addr != IP6_ADDR_ANY6) { + /* Include our hw address. */ + lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct rs_header)); + lladdr_opt->type = ND6_OPTION_TYPE_SOURCE_LLADDR; + lladdr_opt->length = (u8_t)lladdr_opt_len; + SMEMCPY(lladdr_opt->addr, netif->hwaddr, netif->hwaddr_len); + } + +#if CHECKSUM_GEN_ICMP6 + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_ICMP6) { + rs_hdr->chksum = ip6_chksum_pseudo(p, IP6_NEXTH_ICMP6, p->len, src_addr, + &multicast_address); + } +#endif /* CHECKSUM_GEN_ICMP6 */ + + /* Send the packet out. */ + ND6_STATS_INC(nd6.xmit); + + err = ip6_output_if(p, (src_addr == IP6_ADDR_ANY6) ? NULL : src_addr, &multicast_address, + LWIP_ICMP6_HL, 0, IP6_NEXTH_ICMP6, netif); + pbuf_free(p); + + return err; +} +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + +/** + * Search for a neighbor cache entry + * + * @param ip6addr the IPv6 address of the neighbor + * @return The neighbor cache entry index that matched, -1 if no + * entry is found + */ +static s8_t +nd6_find_neighbor_cache_entry(const ip6_addr_t * ip6addr) +{ + s8_t i; + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if (ip6_addr_cmp(ip6addr, &(neighbor_cache[i].next_hop_address))) { + return i; + } + } + return -1; +} + +/** + * Create a new neighbor cache entry. + * + * If no unused entry is found, will try to recycle an old entry + * according to ad-hoc "age" heuristic. + * + * @return The neighbor cache entry index that was created, -1 if no + * entry could be created + */ +static s8_t +nd6_new_neighbor_cache_entry(void) +{ + s8_t i; + s8_t j; + u32_t time; + + + /* First, try to find an empty entry. */ + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if (neighbor_cache[i].state == ND6_NO_ENTRY) { + return i; + } + } + + /* We need to recycle an entry. in general, do not recycle if it is a router. */ + + /* Next, try to find a Stale entry. */ + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ((neighbor_cache[i].state == ND6_STALE) && + (!neighbor_cache[i].isrouter)) { + nd6_free_neighbor_cache_entry(i); + return i; + } + } + + /* Next, try to find a Probe entry. */ + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ((neighbor_cache[i].state == ND6_PROBE) && + (!neighbor_cache[i].isrouter)) { + nd6_free_neighbor_cache_entry(i); + return i; + } + } + + /* Next, try to find a Delayed entry. */ + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ((neighbor_cache[i].state == ND6_DELAY) && + (!neighbor_cache[i].isrouter)) { + nd6_free_neighbor_cache_entry(i); + return i; + } + } + + /* Next, try to find the oldest reachable entry. */ + time = 0xfffffffful; + j = -1; + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ((neighbor_cache[i].state == ND6_REACHABLE) && + (!neighbor_cache[i].isrouter)) { + if (neighbor_cache[i].counter.reachable_time < time) { + j = i; + time = neighbor_cache[i].counter.reachable_time; + } + } + } + if (j >= 0) { + nd6_free_neighbor_cache_entry(j); + return j; + } + + /* Next, find oldest incomplete entry without queued packets. */ + time = 0; + j = -1; + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ( + (neighbor_cache[i].q == NULL) && + (neighbor_cache[i].state == ND6_INCOMPLETE) && + (!neighbor_cache[i].isrouter)) { + if (neighbor_cache[i].counter.probes_sent >= time) { + j = i; + time = neighbor_cache[i].counter.probes_sent; + } + } + } + if (j >= 0) { + nd6_free_neighbor_cache_entry(j); + return j; + } + + /* Next, find oldest incomplete entry with queued packets. */ + time = 0; + j = -1; + for (i = 0; i < LWIP_ND6_NUM_NEIGHBORS; i++) { + if ((neighbor_cache[i].state == ND6_INCOMPLETE) && + (!neighbor_cache[i].isrouter)) { + if (neighbor_cache[i].counter.probes_sent >= time) { + j = i; + time = neighbor_cache[i].counter.probes_sent; + } + } + } + if (j >= 0) { + nd6_free_neighbor_cache_entry(j); + return j; + } + + /* No more entries to try. */ + return -1; +} + +/** + * Will free any resources associated with a neighbor cache + * entry, and will mark it as unused. + * + * @param i the neighbor cache entry index to free + */ +static void +nd6_free_neighbor_cache_entry(s8_t i) +{ + if ((i < 0) || (i >= LWIP_ND6_NUM_NEIGHBORS)) { + return; + } + if (neighbor_cache[i].isrouter) { + /* isrouter needs to be cleared before deleting a neighbor cache entry */ + return; + } + + /* Free any queued packets. */ + if (neighbor_cache[i].q != NULL) { + nd6_free_q(neighbor_cache[i].q); + neighbor_cache[i].q = NULL; + } + + neighbor_cache[i].state = ND6_NO_ENTRY; + neighbor_cache[i].isrouter = 0; + neighbor_cache[i].netif = NULL; + neighbor_cache[i].counter.reachable_time = 0; + ip6_addr_set_zero(&(neighbor_cache[i].next_hop_address)); +} + +/** + * Search for a destination cache entry + * + * @param ip6addr the IPv6 address of the destination + * @return The destination cache entry index that matched, -1 if no + * entry is found + */ +static s8_t +nd6_find_destination_cache_entry(const ip6_addr_t * ip6addr) +{ + s8_t i; + for (i = 0; i < LWIP_ND6_NUM_DESTINATIONS; i++) { + if (ip6_addr_cmp(ip6addr, &(destination_cache[i].destination_addr))) { + return i; + } + } + return -1; +} + +/** + * Create a new destination cache entry. If no unused entry is found, + * will recycle oldest entry. + * + * @return The destination cache entry index that was created, -1 if no + * entry was created + */ +static s8_t +nd6_new_destination_cache_entry(void) +{ + s8_t i, j; + u32_t age; + + /* Find an empty entry. */ + for (i = 0; i < LWIP_ND6_NUM_DESTINATIONS; i++) { + if (ip6_addr_isany(&(destination_cache[i].destination_addr))) { + return i; + } + } + + /* Find oldest entry. */ + age = 0; + j = LWIP_ND6_NUM_DESTINATIONS - 1; + for (i = 0; i < LWIP_ND6_NUM_DESTINATIONS; i++) { + if (destination_cache[i].age > age) { + j = i; + } + } + + return j; +} + +/** + * Determine whether an address matches an on-link prefix. + * + * @param ip6addr the IPv6 address to match + * @return 1 if the address is on-link, 0 otherwise + */ +static s8_t +nd6_is_prefix_in_netif(const ip6_addr_t * ip6addr, struct netif * netif) +{ + s8_t i; + for (i = 0; i < LWIP_ND6_NUM_PREFIXES; i++) { + if ((prefix_list[i].netif == netif) && + (prefix_list[i].invalidation_timer > 0) && + ip6_addr_netcmp(ip6addr, &(prefix_list[i].prefix))) { + return 1; + } + } + /* Check to see if address prefix matches a (manually?) configured address. */ + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (ip6_addr_isvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_netcmp(ip6addr, netif_ip6_addr(netif, i))) { + return 1; + } + } + return 0; +} + +/** + * Select a default router for a destination. + * + * @param ip6addr the destination address + * @param netif the netif for the outgoing packet, if known + * @return the default router entry index, or -1 if no suitable + * router is found + */ +s8_t +nd6_select_router(const ip6_addr_t * ip6addr, struct netif * netif) +{ + s8_t i; + /* last_router is used for round-robin router selection (as recommended + * in RFC). This is more robust in case one router is not reachable, + * we are not stuck trying to resolve it. */ + static s8_t last_router; + (void)ip6addr; /* TODO match preferred routes!! (must implement ND6_OPTION_TYPE_ROUTE_INFO) */ + + /* TODO: implement default router preference */ + + /* Look for reachable routers. */ + for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) { + if (++last_router >= LWIP_ND6_NUM_ROUTERS) { + last_router = 0; + } + if ((default_router_list[i].neighbor_entry != NULL) && + (netif != NULL ? netif == default_router_list[i].neighbor_entry->netif : 1) && + (default_router_list[i].invalidation_timer > 0) && + (default_router_list[i].neighbor_entry->state == ND6_REACHABLE)) { + return i; + } + } + + /* Look for router in other reachability states, but still valid according to timer. */ + for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) { + if (++last_router >= LWIP_ND6_NUM_ROUTERS) { + last_router = 0; + } + if ((default_router_list[i].neighbor_entry != NULL) && + (netif != NULL ? netif == default_router_list[i].neighbor_entry->netif : 1) && + (default_router_list[i].invalidation_timer > 0)) { + return i; + } + } + + /* Look for any router for which we have any information at all. */ + for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) { + if (++last_router >= LWIP_ND6_NUM_ROUTERS) { + last_router = 0; + } + if (default_router_list[i].neighbor_entry != NULL && + (netif != NULL ? netif == default_router_list[i].neighbor_entry->netif : 1)) { + return i; + } + } + + /* no suitable router found. */ + return -1; +} + +/** + * Find an entry for a default router. + * + * @param router_addr the IPv6 address of the router + * @param netif the netif on which the router is found, if known + * @return the index of the router entry, or -1 if not found + */ +static s8_t +nd6_get_router(const ip6_addr_t * router_addr, struct netif * netif) +{ + s8_t i; + + /* Look for router. */ + for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) { + if ((default_router_list[i].neighbor_entry != NULL) && + ((netif != NULL) ? netif == default_router_list[i].neighbor_entry->netif : 1) && + ip6_addr_cmp(router_addr, &(default_router_list[i].neighbor_entry->next_hop_address))) { + return i; + } + } + + /* router not found. */ + return -1; +} + +/** + * Create a new entry for a default router. + * + * @param router_addr the IPv6 address of the router + * @param netif the netif on which the router is connected, if known + * @return the index on the router table, or -1 if could not be created + */ +static s8_t +nd6_new_router(const ip6_addr_t * router_addr, struct netif * netif) +{ + s8_t router_index; + s8_t neighbor_index; + + /* Do we have a neighbor entry for this router? */ + neighbor_index = nd6_find_neighbor_cache_entry(router_addr); + if (neighbor_index < 0) { + /* Create a neighbor entry for this router. */ + neighbor_index = nd6_new_neighbor_cache_entry(); + if (neighbor_index < 0) { + /* Could not create neighbor entry for this router. */ + return -1; + } + ip6_addr_set(&(neighbor_cache[neighbor_index].next_hop_address), router_addr); + neighbor_cache[neighbor_index].netif = netif; + neighbor_cache[neighbor_index].q = NULL; + neighbor_cache[neighbor_index].state = ND6_INCOMPLETE; + neighbor_cache[neighbor_index].counter.probes_sent = 0; + } + + /* Mark neighbor as router. */ + neighbor_cache[neighbor_index].isrouter = 1; + + /* Look for empty entry. */ + for (router_index = 0; router_index < LWIP_ND6_NUM_ROUTERS; router_index++) { + if (default_router_list[router_index].neighbor_entry == NULL) { + default_router_list[router_index].neighbor_entry = &(neighbor_cache[neighbor_index]); + return router_index; + } + } + + /* Could not create a router entry. */ + + /* Mark neighbor entry as not-router. Entry might be useful as neighbor still. */ + neighbor_cache[neighbor_index].isrouter = 0; + + /* router not found. */ + return -1; +} + +/** + * Find the cached entry for an on-link prefix. + * + * @param prefix the IPv6 prefix that is on-link + * @param netif the netif on which the prefix is on-link + * @return the index on the prefix table, or -1 if not found + */ +static s8_t +nd6_get_onlink_prefix(ip6_addr_t * prefix, struct netif * netif) +{ + s8_t i; + + /* Look for prefix in list. */ + for (i = 0; i < LWIP_ND6_NUM_PREFIXES; ++i) { + if ((ip6_addr_netcmp(&(prefix_list[i].prefix), prefix)) && + (prefix_list[i].netif == netif)) { + return i; + } + } + + /* Entry not available. */ + return -1; +} + +/** + * Creates a new entry for an on-link prefix. + * + * @param prefix the IPv6 prefix that is on-link + * @param netif the netif on which the prefix is on-link + * @return the index on the prefix table, or -1 if not created + */ +static s8_t +nd6_new_onlink_prefix(ip6_addr_t * prefix, struct netif * netif) +{ + s8_t i; + + /* Create new entry. */ + for (i = 0; i < LWIP_ND6_NUM_PREFIXES; ++i) { + if ((prefix_list[i].netif == NULL) || + (prefix_list[i].invalidation_timer == 0)) { + /* Found empty prefix entry. */ + prefix_list[i].netif = netif; + ip6_addr_set(&(prefix_list[i].prefix), prefix); +#if LWIP_IPV6_AUTOCONFIG + prefix_list[i].flags = 0; +#endif /* LWIP_IPV6_AUTOCONFIG */ + return i; + } + } + + /* Entry not available. */ + return -1; +} + +/** + * Determine the next hop for a destination. Will determine if the + * destination is on-link, else a suitable on-link router is selected. + * + * The last entry index is cached for fast entry search. + * + * @param ip6addr the destination address + * @param netif the netif on which the packet will be sent + * @return the neighbor cache entry for the next hop, ERR_RTE if no + * suitable next hop was found, ERR_MEM if no cache entry + * could be created + */ +s8_t +nd6_get_next_hop_entry(const ip6_addr_t * ip6addr, struct netif * netif) +{ + s8_t i; + +#if LWIP_NETIF_HWADDRHINT + if (netif->addr_hint != NULL) { + /* per-pcb cached entry was given */ + u8_t addr_hint = *(netif->addr_hint); + if (addr_hint < LWIP_ND6_NUM_DESTINATIONS) { + nd6_cached_destination_index = addr_hint; + } + } +#endif /* LWIP_NETIF_HWADDRHINT */ + + /* Look for ip6addr in destination cache. */ + if (ip6_addr_cmp(ip6addr, &(destination_cache[nd6_cached_destination_index].destination_addr))) { + /* the cached entry index is the right one! */ + /* do nothing. */ + ND6_STATS_INC(nd6.cachehit); + } else { + /* Search destination cache. */ + i = nd6_find_destination_cache_entry(ip6addr); + if (i >= 0) { + /* found destination entry. make it our new cached index. */ + nd6_cached_destination_index = i; + } else { + /* Not found. Create a new destination entry. */ + i = nd6_new_destination_cache_entry(); + if (i >= 0) { + /* got new destination entry. make it our new cached index. */ + nd6_cached_destination_index = i; + } else { + /* Could not create a destination cache entry. */ + return ERR_MEM; + } + + /* Copy dest address to destination cache. */ + ip6_addr_set(&(destination_cache[nd6_cached_destination_index].destination_addr), ip6addr); + + /* Now find the next hop. is it a neighbor? */ + if (ip6_addr_islinklocal(ip6addr) || + nd6_is_prefix_in_netif(ip6addr, netif)) { + /* Destination in local link. */ + destination_cache[nd6_cached_destination_index].pmtu = netif->mtu; + ip6_addr_copy(destination_cache[nd6_cached_destination_index].next_hop_addr, destination_cache[nd6_cached_destination_index].destination_addr); + } else { + /* We need to select a router. */ + i = nd6_select_router(ip6addr, netif); + if (i < 0) { + /* No router found. */ + ip6_addr_set_any(&(destination_cache[nd6_cached_destination_index].destination_addr)); + return ERR_RTE; + } + destination_cache[nd6_cached_destination_index].pmtu = netif->mtu; /* Start with netif mtu, correct through ICMPv6 if necessary */ + ip6_addr_copy(destination_cache[nd6_cached_destination_index].next_hop_addr, default_router_list[i].neighbor_entry->next_hop_address); + } + } + } + +#if LWIP_NETIF_HWADDRHINT + if (netif->addr_hint != NULL) { + /* per-pcb cached entry was given */ + *(netif->addr_hint) = nd6_cached_destination_index; + } +#endif /* LWIP_NETIF_HWADDRHINT */ + + /* Look in neighbor cache for the next-hop address. */ + if (ip6_addr_cmp(&(destination_cache[nd6_cached_destination_index].next_hop_addr), + &(neighbor_cache[nd6_cached_neighbor_index].next_hop_address))) { + /* Cache hit. */ + /* Do nothing. */ + ND6_STATS_INC(nd6.cachehit); + } else { + i = nd6_find_neighbor_cache_entry(&(destination_cache[nd6_cached_destination_index].next_hop_addr)); + if (i >= 0) { + /* Found a matching record, make it new cached entry. */ + nd6_cached_neighbor_index = i; + } else { + /* Neighbor not in cache. Make a new entry. */ + i = nd6_new_neighbor_cache_entry(); + if (i >= 0) { + /* got new neighbor entry. make it our new cached index. */ + nd6_cached_neighbor_index = i; + } else { + /* Could not create a neighbor cache entry. */ + return ERR_MEM; + } + + /* Initialize fields. */ + ip6_addr_copy(neighbor_cache[i].next_hop_address, + destination_cache[nd6_cached_destination_index].next_hop_addr); + neighbor_cache[i].isrouter = 0; + neighbor_cache[i].netif = netif; + neighbor_cache[i].state = ND6_INCOMPLETE; + neighbor_cache[i].counter.probes_sent = 0; + } + } + + /* Reset this destination's age. */ + destination_cache[nd6_cached_destination_index].age = 0; + + return nd6_cached_neighbor_index; +} + +/** + * Queue a packet for a neighbor. + * + * @param neighbor_index the index in the neighbor cache table + * @param q packet to be queued + * @return ERR_OK if succeeded, ERR_MEM if out of memory + */ +err_t +nd6_queue_packet(s8_t neighbor_index, struct pbuf * q) +{ + err_t result = ERR_MEM; + struct pbuf *p; + int copy_needed = 0; +#if LWIP_ND6_QUEUEING + struct nd6_q_entry *new_entry, *r; +#endif /* LWIP_ND6_QUEUEING */ + + if ((neighbor_index < 0) || (neighbor_index >= LWIP_ND6_NUM_NEIGHBORS)) { + return ERR_ARG; + } + + /* IF q includes a PBUF_REF, PBUF_POOL or PBUF_RAM, we have no choice but + * to copy the whole queue into a new PBUF_RAM (see bug #11400) + * PBUF_ROMs can be left as they are, since ROM must not get changed. */ + p = q; + while (p) { + if (p->type != PBUF_ROM) { + copy_needed = 1; + break; + } + p = p->next; + } + if (copy_needed) { + /* copy the whole packet into new pbufs */ + p = pbuf_alloc(PBUF_LINK, q->tot_len, PBUF_RAM); + while ((p == NULL) && (neighbor_cache[neighbor_index].q != NULL)) { + /* Free oldest packet (as per RFC recommendation) */ +#if LWIP_ND6_QUEUEING + r = neighbor_cache[neighbor_index].q; + neighbor_cache[neighbor_index].q = r->next; + r->next = NULL; + nd6_free_q(r); +#else /* LWIP_ND6_QUEUEING */ + pbuf_free(neighbor_cache[neighbor_index].q); + neighbor_cache[neighbor_index].q = NULL; +#endif /* LWIP_ND6_QUEUEING */ + p = pbuf_alloc(PBUF_LINK, q->tot_len, PBUF_RAM); + } + if (p != NULL) { + if (pbuf_copy(p, q) != ERR_OK) { + pbuf_free(p); + p = NULL; + } + } + } else { + /* referencing the old pbuf is enough */ + p = q; + pbuf_ref(p); + } + /* packet was copied/ref'd? */ + if (p != NULL) { + /* queue packet ... */ +#if LWIP_ND6_QUEUEING + /* allocate a new nd6 queue entry */ + new_entry = (struct nd6_q_entry *)memp_malloc(MEMP_ND6_QUEUE); + if ((new_entry == NULL) && (neighbor_cache[neighbor_index].q != NULL)) { + /* Free oldest packet (as per RFC recommendation) */ + r = neighbor_cache[neighbor_index].q; + neighbor_cache[neighbor_index].q = r->next; + r->next = NULL; + nd6_free_q(r); + new_entry = (struct nd6_q_entry *)memp_malloc(MEMP_ND6_QUEUE); + } + if (new_entry != NULL) { + new_entry->next = NULL; + new_entry->p = p; + if (neighbor_cache[neighbor_index].q != NULL) { + /* queue was already existent, append the new entry to the end */ + r = neighbor_cache[neighbor_index].q; + while (r->next != NULL) { + r = r->next; + } + r->next = new_entry; + } else { + /* queue did not exist, first item in queue */ + neighbor_cache[neighbor_index].q = new_entry; + } + LWIP_DEBUGF(LWIP_DBG_TRACE, ("ipv6: queued packet %p on neighbor entry %"S16_F"\n", (void *)p, (s16_t)neighbor_index)); + result = ERR_OK; + } else { + /* the pool MEMP_ND6_QUEUE is empty */ + pbuf_free(p); + LWIP_DEBUGF(LWIP_DBG_TRACE, ("ipv6: could not queue a copy of packet %p (out of memory)\n", (void *)p)); + /* { result == ERR_MEM } through initialization */ + } +#else /* LWIP_ND6_QUEUEING */ + /* Queue a single packet. If an older packet is already queued, free it as per RFC. */ + if (neighbor_cache[neighbor_index].q != NULL) { + pbuf_free(neighbor_cache[neighbor_index].q); + } + neighbor_cache[neighbor_index].q = p; + LWIP_DEBUGF(LWIP_DBG_TRACE, ("ipv6: queued packet %p on neighbor entry %"S16_F"\n", (void *)p, (s16_t)neighbor_index)); + result = ERR_OK; +#endif /* LWIP_ND6_QUEUEING */ + } else { + LWIP_DEBUGF(LWIP_DBG_TRACE, ("ipv6: could not queue a copy of packet %p (out of memory)\n", (void *)q)); + /* { result == ERR_MEM } through initialization */ + } + + return result; +} + +#if LWIP_ND6_QUEUEING +/** + * Free a complete queue of nd6 q entries + * + * @param q a queue of nd6_q_entry to free + */ +static void +nd6_free_q(struct nd6_q_entry *q) +{ + struct nd6_q_entry *r; + LWIP_ASSERT("q != NULL", q != NULL); + LWIP_ASSERT("q->p != NULL", q->p != NULL); + while (q) { + r = q; + q = q->next; + LWIP_ASSERT("r->p != NULL", (r->p != NULL)); + pbuf_free(r->p); + memp_free(MEMP_ND6_QUEUE, r); + } +} +#endif /* LWIP_ND6_QUEUEING */ + +/** + * Send queued packets for a neighbor + * + * @param i the neighbor to send packets to + */ +static void +nd6_send_q(s8_t i) +{ + struct ip6_hdr *ip6hdr; +#if LWIP_ND6_QUEUEING + struct nd6_q_entry *q; +#endif /* LWIP_ND6_QUEUEING */ + + if ((i < 0) || (i >= LWIP_ND6_NUM_NEIGHBORS)) { + return; + } + +#if LWIP_ND6_QUEUEING + while (neighbor_cache[i].q != NULL) { + /* remember first in queue */ + q = neighbor_cache[i].q; + /* pop first item off the queue */ + neighbor_cache[i].q = q->next; + /* Get ipv6 header. */ + ip6hdr = (struct ip6_hdr *)(q->p->payload); + /* Override ip6_current_dest_addr() so that we have an aligned copy. */ + ip6_addr_set(ip6_current_dest_addr(), &(ip6hdr->dest)); + /* send the queued IPv6 packet */ + (neighbor_cache[i].netif)->output_ip6(neighbor_cache[i].netif, q->p, ip6_current_dest_addr()); + /* free the queued IP packet */ + pbuf_free(q->p); + /* now queue entry can be freed */ + memp_free(MEMP_ND6_QUEUE, q); + } +#else /* LWIP_ND6_QUEUEING */ + if (neighbor_cache[i].q != NULL) { + /* Get ipv6 header. */ + ip6hdr = (struct ip6_hdr *)(neighbor_cache[i].q->payload); + /* Override ip6_current_dest_addr() so that we have an aligned copy. */ + ip6_addr_set(ip6_current_dest_addr(), &(ip6hdr->dest)); + /* send the queued IPv6 packet */ + (neighbor_cache[i].netif)->output_ip6(neighbor_cache[i].netif, neighbor_cache[i].q, ip6_current_dest_addr()); + /* free the queued IP packet */ + pbuf_free(neighbor_cache[i].q); + neighbor_cache[i].q = NULL; + } +#endif /* LWIP_ND6_QUEUEING */ +} + + +/** + * Get the Path MTU for a destination. + * + * @param ip6addr the destination address + * @param netif the netif on which the packet will be sent + * @return the Path MTU, if known, or the netif default MTU + */ +u16_t +nd6_get_destination_mtu(const ip6_addr_t * ip6addr, struct netif * netif) +{ + s8_t i; + + i = nd6_find_destination_cache_entry(ip6addr); + if (i >= 0) { + if (destination_cache[i].pmtu > 0) { + return destination_cache[i].pmtu; + } + } + + if (netif != NULL) { + return netif->mtu; + } + + return 1280; /* Minimum MTU */ +} + + +#if LWIP_ND6_TCP_REACHABILITY_HINTS +/** + * Provide the Neighbor discovery process with a hint that a + * destination is reachable. Called by tcp_receive when ACKs are + * received or sent (as per RFC). This is useful to avoid sending + * NS messages every 30 seconds. + * + * @param ip6addr the destination address which is know to be reachable + * by an upper layer protocol (TCP) + */ +void +nd6_reachability_hint(const ip6_addr_t * ip6addr) +{ + s8_t i; + + /* Find destination in cache. */ + if (ip6_addr_cmp(ip6addr, &(destination_cache[nd6_cached_destination_index].destination_addr))) { + i = nd6_cached_destination_index; + ND6_STATS_INC(nd6.cachehit); + } else { + i = nd6_find_destination_cache_entry(ip6addr); + } + if (i < 0) { + return; + } + + /* Find next hop neighbor in cache. */ + if (ip6_addr_cmp(&(destination_cache[i].next_hop_addr), &(neighbor_cache[nd6_cached_neighbor_index].next_hop_address))) { + i = nd6_cached_neighbor_index; + ND6_STATS_INC(nd6.cachehit); + } else { + i = nd6_find_neighbor_cache_entry(&(destination_cache[i].next_hop_addr)); + } + if (i < 0) { + return; + } + + /* For safety: don't set as reachable if we don't have a LL address yet. Misuse protection. */ + if (neighbor_cache[i].state == ND6_INCOMPLETE || neighbor_cache[i].state == ND6_NO_ENTRY) { + return; + } + + /* Set reachability state. */ + neighbor_cache[i].state = ND6_REACHABLE; + neighbor_cache[i].counter.reachable_time = reachable_time; +} +#endif /* LWIP_ND6_TCP_REACHABILITY_HINTS */ + +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/mem.c b/components/lwip/core/mem.c new file mode 100755 index 000000000..42df6daeb --- /dev/null +++ b/components/lwip/core/mem.c @@ -0,0 +1,686 @@ +/** + * @file + * Dynamic memory manager + * + * This is a lightweight replacement for the standard C library malloc(). + * + * If you want to use the standard C library malloc() instead, define + * MEM_LIBC_MALLOC to 1 in your lwipopts.h + * + * To let mem_malloc() use pools (prevents fragmentation and is much faster than + * a heap but might waste some memory), define MEM_USE_POOLS to 1, define + * MEM_USE_CUSTOM_POOLS to 1 and create a file "lwippools.h" that includes a list + * of pools like this (more pools can be added between _START and _END): + * + * Define three pools with sizes 256, 512, and 1512 bytes + * LWIP_MALLOC_MEMPOOL_START + * LWIP_MALLOC_MEMPOOL(20, 256) + * LWIP_MALLOC_MEMPOOL(10, 512) + * LWIP_MALLOC_MEMPOOL(5, 1512) + * LWIP_MALLOC_MEMPOOL_END + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * Simon Goldschmidt + * + */ + +#include "lwip/opt.h" + +#if !MEM_LIBC_MALLOC /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/sys.h" +#include "lwip/stats.h" +#include "lwip/err.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#if MEM_USE_POOLS + +#if MEMP_MEM_MALLOC +#error MEM_USE_POOLS and MEMP_MEM_MALLOC cannot be used together +#endif + +/* lwIP head implemented with different sized pools */ + +/** + * Allocate memory: determine the smallest pool that is big enough + * to contain an element of 'size' and get an element from that pool. + * + * @param size the size in bytes of the memory needed + * @return a pointer to the allocated memory or NULL if the pool is empty + */ +void * +mem_malloc(mem_size_t size) +{ + void *ret; + struct memp_malloc_helper *element; + memp_t poolnr; + mem_size_t required_size = size + LWIP_MEM_ALIGN_SIZE(sizeof(struct memp_malloc_helper)); + + for (poolnr = MEMP_POOL_FIRST; poolnr <= MEMP_POOL_LAST; poolnr = (memp_t)(poolnr + 1)) { +#if MEM_USE_POOLS_TRY_BIGGER_POOL +again: +#endif /* MEM_USE_POOLS_TRY_BIGGER_POOL */ + /* is this pool big enough to hold an element of the required size + plus a struct memp_malloc_helper that saves the pool this element came from? */ + if (required_size <= memp_pools[poolnr]->size) { + break; + } + } + if (poolnr > MEMP_POOL_LAST) { + LWIP_ASSERT("mem_malloc(): no pool is that big!", 0); + return NULL; + } + element = (struct memp_malloc_helper*)memp_malloc(poolnr); + if (element == NULL) { + /* No need to DEBUGF or ASSERT: This error is already + taken care of in memp.c */ +#if MEM_USE_POOLS_TRY_BIGGER_POOL + /** Try a bigger pool if this one is empty! */ + if (poolnr < MEMP_POOL_LAST) { + poolnr++; + goto again; + } +#endif /* MEM_USE_POOLS_TRY_BIGGER_POOL */ + return NULL; + } + + /* save the pool number this element came from */ + element->poolnr = poolnr; + /* and return a pointer to the memory directly after the struct memp_malloc_helper */ + ret = (u8_t*)element + LWIP_MEM_ALIGN_SIZE(sizeof(struct memp_malloc_helper)); + +#if MEMP_OVERFLOW_CHECK + /* initialize unused memory */ + element->size = size; + memset((u8_t*)ret + size, 0xcd, memp_pools[poolnr]->size - size); +#endif /* MEMP_OVERFLOW_CHECK */ + return ret; +} + +/** + * Free memory previously allocated by mem_malloc. Loads the pool number + * and calls memp_free with that pool number to put the element back into + * its pool + * + * @param rmem the memory element to free + */ +void +mem_free(void *rmem) +{ + struct memp_malloc_helper *hmem; + + LWIP_ASSERT("rmem != NULL", (rmem != NULL)); + LWIP_ASSERT("rmem == MEM_ALIGN(rmem)", (rmem == LWIP_MEM_ALIGN(rmem))); + + /* get the original struct memp_malloc_helper */ + hmem = (struct memp_malloc_helper*)(void*)((u8_t*)rmem - LWIP_MEM_ALIGN_SIZE(sizeof(struct memp_malloc_helper))); + + LWIP_ASSERT("hmem != NULL", (hmem != NULL)); + LWIP_ASSERT("hmem == MEM_ALIGN(hmem)", (hmem == LWIP_MEM_ALIGN(hmem))); + LWIP_ASSERT("hmem->poolnr < MEMP_MAX", (hmem->poolnr < MEMP_MAX)); + +#if MEMP_OVERFLOW_CHECK + { + u16_t i; + LWIP_ASSERT("MEM_USE_POOLS: invalid chunk size", + hmem->size <= memp_pools[hmem->poolnr]->size); + /* check that unused memory remained untouched */ + for (i = hmem->size; i < memp_pools[hmem->poolnr]->size; i++) { + u8_t data = *((u8_t*)rmem + i); + LWIP_ASSERT("MEM_USE_POOLS: mem overflow detected", data == 0xcd); + } + } +#endif /* MEMP_OVERFLOW_CHECK */ + + /* and put it in the pool we saved earlier */ + memp_free(hmem->poolnr, hmem); +} + +#else /* MEM_USE_POOLS */ +/* lwIP replacement for your libc malloc() */ + +/** + * The heap is made up as a list of structs of this type. + * This does not have to be aligned since for getting its size, + * we only use the macro SIZEOF_STRUCT_MEM, which automatically aligns. + */ +struct mem { + /** index (-> ram[next]) of the next struct */ + mem_size_t next; + /** index (-> ram[prev]) of the previous struct */ + mem_size_t prev; + /** 1: this area is used; 0: this area is unused */ + u8_t used; +}; + +/** All allocated blocks will be MIN_SIZE bytes big, at least! + * MIN_SIZE can be overridden to suit your needs. Smaller values save space, + * larger values could prevent too small blocks to fragment the RAM too much. */ +#ifndef MIN_SIZE +#define MIN_SIZE 12 +#endif /* MIN_SIZE */ +/* some alignment macros: we define them here for better source code layout */ +#define MIN_SIZE_ALIGNED LWIP_MEM_ALIGN_SIZE(MIN_SIZE) +#define SIZEOF_STRUCT_MEM LWIP_MEM_ALIGN_SIZE(sizeof(struct mem)) +#define MEM_SIZE_ALIGNED LWIP_MEM_ALIGN_SIZE(MEM_SIZE) + +/** If you want to relocate the heap to external memory, simply define + * LWIP_RAM_HEAP_POINTER as a void-pointer to that location. + * If so, make sure the memory at that location is big enough (see below on + * how that space is calculated). */ +#ifndef LWIP_RAM_HEAP_POINTER +/** the heap. we need one struct mem at the end and some room for alignment */ +u8_t ram_heap[MEM_SIZE_ALIGNED + (2U*SIZEOF_STRUCT_MEM) + MEM_ALIGNMENT]; +#define LWIP_RAM_HEAP_POINTER ram_heap +#endif /* LWIP_RAM_HEAP_POINTER */ + +/** pointer to the heap (ram_heap): for alignment, ram is now a pointer instead of an array */ +static u8_t *ram; +/** the last entry, always unused! */ +static struct mem *ram_end; +/** pointer to the lowest free block, this is used for faster search */ +static struct mem *lfree; + +/** concurrent access protection */ +#if !NO_SYS +static sys_mutex_t mem_mutex; +#endif + +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + +static volatile u8_t mem_free_count; + +/* Allow mem_free from other (e.g. interrupt) context */ +#define LWIP_MEM_FREE_DECL_PROTECT() SYS_ARCH_DECL_PROTECT(lev_free) +#define LWIP_MEM_FREE_PROTECT() SYS_ARCH_PROTECT(lev_free) +#define LWIP_MEM_FREE_UNPROTECT() SYS_ARCH_UNPROTECT(lev_free) +#define LWIP_MEM_ALLOC_DECL_PROTECT() SYS_ARCH_DECL_PROTECT(lev_alloc) +#define LWIP_MEM_ALLOC_PROTECT() SYS_ARCH_PROTECT(lev_alloc) +#define LWIP_MEM_ALLOC_UNPROTECT() SYS_ARCH_UNPROTECT(lev_alloc) + +#else /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + +/* Protect the heap only by using a semaphore */ +#define LWIP_MEM_FREE_DECL_PROTECT() +#define LWIP_MEM_FREE_PROTECT() sys_mutex_lock(&mem_mutex) +#define LWIP_MEM_FREE_UNPROTECT() sys_mutex_unlock(&mem_mutex) +/* mem_malloc is protected using semaphore AND LWIP_MEM_ALLOC_PROTECT */ +#define LWIP_MEM_ALLOC_DECL_PROTECT() +#define LWIP_MEM_ALLOC_PROTECT() +#define LWIP_MEM_ALLOC_UNPROTECT() + +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + + +/** + * "Plug holes" by combining adjacent empty struct mems. + * After this function is through, there should not exist + * one empty struct mem pointing to another empty struct mem. + * + * @param mem this points to a struct mem which just has been freed + * @internal this function is only called by mem_free() and mem_trim() + * + * This assumes access to the heap is protected by the calling function + * already. + */ +static void +plug_holes(struct mem *mem) +{ + struct mem *nmem; + struct mem *pmem; + + LWIP_ASSERT("plug_holes: mem >= ram", (u8_t *)mem >= ram); + LWIP_ASSERT("plug_holes: mem < ram_end", (u8_t *)mem < (u8_t *)ram_end); + LWIP_ASSERT("plug_holes: mem->used == 0", mem->used == 0); + + /* plug hole forward */ + LWIP_ASSERT("plug_holes: mem->next <= MEM_SIZE_ALIGNED", mem->next <= MEM_SIZE_ALIGNED); + + nmem = (struct mem *)(void *)&ram[mem->next]; + if (mem != nmem && nmem->used == 0 && (u8_t *)nmem != (u8_t *)ram_end) { + /* if mem->next is unused and not end of ram, combine mem and mem->next */ + if (lfree == nmem) { + lfree = mem; + } + mem->next = nmem->next; + ((struct mem *)(void *)&ram[nmem->next])->prev = (mem_size_t)((u8_t *)mem - ram); + } + + /* plug hole backward */ + pmem = (struct mem *)(void *)&ram[mem->prev]; + if (pmem != mem && pmem->used == 0) { + /* if mem->prev is unused, combine mem and mem->prev */ + if (lfree == mem) { + lfree = pmem; + } + pmem->next = mem->next; + ((struct mem *)(void *)&ram[mem->next])->prev = (mem_size_t)((u8_t *)pmem - ram); + } +} + +/** + * Zero the heap and initialize start, end and lowest-free + */ +void +mem_init(void) +{ + struct mem *mem; + + LWIP_ASSERT("Sanity check alignment", + (SIZEOF_STRUCT_MEM & (MEM_ALIGNMENT-1)) == 0); + + /* align the heap */ + ram = (u8_t *)LWIP_MEM_ALIGN(LWIP_RAM_HEAP_POINTER); + /* initialize the start of the heap */ + mem = (struct mem *)(void *)ram; + mem->next = MEM_SIZE_ALIGNED; + mem->prev = 0; + mem->used = 0; + /* initialize the end of the heap */ + ram_end = (struct mem *)(void *)&ram[MEM_SIZE_ALIGNED]; + ram_end->used = 1; + ram_end->next = MEM_SIZE_ALIGNED; + ram_end->prev = MEM_SIZE_ALIGNED; + + /* initialize the lowest-free pointer to the start of the heap */ + lfree = (struct mem *)(void *)ram; + + MEM_STATS_AVAIL(avail, MEM_SIZE_ALIGNED); + + if (sys_mutex_new(&mem_mutex) != ERR_OK) { + LWIP_ASSERT("failed to create mem_mutex", 0); + } +} + +/** + * Put a struct mem back on the heap + * + * @param rmem is the data portion of a struct mem as returned by a previous + * call to mem_malloc() + */ +void +mem_free(void *rmem) +{ + struct mem *mem; + LWIP_MEM_FREE_DECL_PROTECT(); + + if (rmem == NULL) { + LWIP_DEBUGF(MEM_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("mem_free(p == NULL) was called.\n")); + return; + } + LWIP_ASSERT("mem_free: sanity check alignment", (((mem_ptr_t)rmem) & (MEM_ALIGNMENT-1)) == 0); + + LWIP_ASSERT("mem_free: legal memory", (u8_t *)rmem >= (u8_t *)ram && + (u8_t *)rmem < (u8_t *)ram_end); + + if ((u8_t *)rmem < (u8_t *)ram || (u8_t *)rmem >= (u8_t *)ram_end) { + SYS_ARCH_DECL_PROTECT(lev); + LWIP_DEBUGF(MEM_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("mem_free: illegal memory\n")); + /* protect mem stats from concurrent access */ + SYS_ARCH_PROTECT(lev); + MEM_STATS_INC(illegal); + SYS_ARCH_UNPROTECT(lev); + return; + } + /* protect the heap from concurrent access */ + LWIP_MEM_FREE_PROTECT(); + /* Get the corresponding struct mem ... */ + mem = (struct mem *)(void *)((u8_t *)rmem - SIZEOF_STRUCT_MEM); + /* ... which has to be in a used state ... */ + LWIP_ASSERT("mem_free: mem->used", mem->used); + /* ... and is now unused. */ + mem->used = 0; + + if (mem < lfree) { + /* the newly freed struct is now the lowest */ + lfree = mem; + } + + MEM_STATS_DEC_USED(used, mem->next - (mem_size_t)(((u8_t *)mem - ram))); + + /* finally, see if prev or next are free also */ + plug_holes(mem); +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + mem_free_count = 1; +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + LWIP_MEM_FREE_UNPROTECT(); +} + +/** + * Shrink memory returned by mem_malloc(). + * + * @param rmem pointer to memory allocated by mem_malloc the is to be shrinked + * @param newsize required size after shrinking (needs to be smaller than or + * equal to the previous size) + * @return for compatibility reasons: is always == rmem, at the moment + * or NULL if newsize is > old size, in which case rmem is NOT touched + * or freed! + */ +void * +mem_trim(void *rmem, mem_size_t newsize) +{ + mem_size_t size; + mem_size_t ptr, ptr2; + struct mem *mem, *mem2; + /* use the FREE_PROTECT here: it protects with sem OR SYS_ARCH_PROTECT */ + LWIP_MEM_FREE_DECL_PROTECT(); + + /* Expand the size of the allocated memory region so that we can + adjust for alignment. */ + newsize = LWIP_MEM_ALIGN_SIZE(newsize); + + if (newsize < MIN_SIZE_ALIGNED) { + /* every data block must be at least MIN_SIZE_ALIGNED long */ + newsize = MIN_SIZE_ALIGNED; + } + + if (newsize > MEM_SIZE_ALIGNED) { + return NULL; + } + + LWIP_ASSERT("mem_trim: legal memory", (u8_t *)rmem >= (u8_t *)ram && + (u8_t *)rmem < (u8_t *)ram_end); + + if ((u8_t *)rmem < (u8_t *)ram || (u8_t *)rmem >= (u8_t *)ram_end) { + SYS_ARCH_DECL_PROTECT(lev); + LWIP_DEBUGF(MEM_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("mem_trim: illegal memory\n")); + /* protect mem stats from concurrent access */ + SYS_ARCH_PROTECT(lev); + MEM_STATS_INC(illegal); + SYS_ARCH_UNPROTECT(lev); + return rmem; + } + /* Get the corresponding struct mem ... */ + mem = (struct mem *)(void *)((u8_t *)rmem - SIZEOF_STRUCT_MEM); + /* ... and its offset pointer */ + ptr = (mem_size_t)((u8_t *)mem - ram); + + size = mem->next - ptr - SIZEOF_STRUCT_MEM; + LWIP_ASSERT("mem_trim can only shrink memory", newsize <= size); + if (newsize > size) { + /* not supported */ + return NULL; + } + if (newsize == size) { + /* No change in size, simply return */ + return rmem; + } + + /* protect the heap from concurrent access */ + LWIP_MEM_FREE_PROTECT(); + + mem2 = (struct mem *)(void *)&ram[mem->next]; + if (mem2->used == 0) { + /* The next struct is unused, we can simply move it at little */ + mem_size_t next; + /* remember the old next pointer */ + next = mem2->next; + /* create new struct mem which is moved directly after the shrinked mem */ + ptr2 = ptr + SIZEOF_STRUCT_MEM + newsize; + if (lfree == mem2) { + lfree = (struct mem *)(void *)&ram[ptr2]; + } + mem2 = (struct mem *)(void *)&ram[ptr2]; + mem2->used = 0; + /* restore the next pointer */ + mem2->next = next; + /* link it back to mem */ + mem2->prev = ptr; + /* link mem to it */ + mem->next = ptr2; + /* last thing to restore linked list: as we have moved mem2, + * let 'mem2->next->prev' point to mem2 again. but only if mem2->next is not + * the end of the heap */ + if (mem2->next != MEM_SIZE_ALIGNED) { + ((struct mem *)(void *)&ram[mem2->next])->prev = ptr2; + } + MEM_STATS_DEC_USED(used, (size - newsize)); + /* no need to plug holes, we've already done that */ + } else if (newsize + SIZEOF_STRUCT_MEM + MIN_SIZE_ALIGNED <= size) { + /* Next struct is used but there's room for another struct mem with + * at least MIN_SIZE_ALIGNED of data. + * Old size ('size') must be big enough to contain at least 'newsize' plus a struct mem + * ('SIZEOF_STRUCT_MEM') with some data ('MIN_SIZE_ALIGNED'). + * @todo we could leave out MIN_SIZE_ALIGNED. We would create an empty + * region that couldn't hold data, but when mem->next gets freed, + * the 2 regions would be combined, resulting in more free memory */ + ptr2 = ptr + SIZEOF_STRUCT_MEM + newsize; + mem2 = (struct mem *)(void *)&ram[ptr2]; + if (mem2 < lfree) { + lfree = mem2; + } + mem2->used = 0; + mem2->next = mem->next; + mem2->prev = ptr; + mem->next = ptr2; + if (mem2->next != MEM_SIZE_ALIGNED) { + ((struct mem *)(void *)&ram[mem2->next])->prev = ptr2; + } + MEM_STATS_DEC_USED(used, (size - newsize)); + /* the original mem->next is used, so no need to plug holes! */ + } + /* else { + next struct mem is used but size between mem and mem2 is not big enough + to create another struct mem + -> don't do anyhting. + -> the remaining space stays unused since it is too small + } */ +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + mem_free_count = 1; +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + LWIP_MEM_FREE_UNPROTECT(); + return rmem; +} + +/** + * Adam's mem_malloc() plus solution for bug #17922 + * Allocate a block of memory with a minimum of 'size' bytes. + * + * @param size is the minimum size of the requested block in bytes. + * @return pointer to allocated memory or NULL if no free memory was found. + * + * Note that the returned value will always be aligned (as defined by MEM_ALIGNMENT). + */ +void * +mem_malloc(mem_size_t size) +{ + mem_size_t ptr, ptr2; + struct mem *mem, *mem2; +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + u8_t local_mem_free_count = 0; +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + LWIP_MEM_ALLOC_DECL_PROTECT(); + + if (size == 0) { + return NULL; + } + + /* Expand the size of the allocated memory region so that we can + adjust for alignment. */ + size = LWIP_MEM_ALIGN_SIZE(size); + + if (size < MIN_SIZE_ALIGNED) { + /* every data block must be at least MIN_SIZE_ALIGNED long */ + size = MIN_SIZE_ALIGNED; + } + + if (size > MEM_SIZE_ALIGNED) { + return NULL; + } + + /* protect the heap from concurrent access */ + sys_mutex_lock(&mem_mutex); + LWIP_MEM_ALLOC_PROTECT(); +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + /* run as long as a mem_free disturbed mem_malloc or mem_trim */ + do { + local_mem_free_count = 0; +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + + /* Scan through the heap searching for a free block that is big enough, + * beginning with the lowest free block. + */ + for (ptr = (mem_size_t)((u8_t *)lfree - ram); ptr < MEM_SIZE_ALIGNED - size; + ptr = ((struct mem *)(void *)&ram[ptr])->next) { + mem = (struct mem *)(void *)&ram[ptr]; +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + mem_free_count = 0; + LWIP_MEM_ALLOC_UNPROTECT(); + /* allow mem_free or mem_trim to run */ + LWIP_MEM_ALLOC_PROTECT(); + if (mem_free_count != 0) { + /* If mem_free or mem_trim have run, we have to restart since they + could have altered our current struct mem. */ + local_mem_free_count = 1; + break; + } +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + + if ((!mem->used) && + (mem->next - (ptr + SIZEOF_STRUCT_MEM)) >= size) { + /* mem is not used and at least perfect fit is possible: + * mem->next - (ptr + SIZEOF_STRUCT_MEM) gives us the 'user data size' of mem */ + + if (mem->next - (ptr + SIZEOF_STRUCT_MEM) >= (size + SIZEOF_STRUCT_MEM + MIN_SIZE_ALIGNED)) { + /* (in addition to the above, we test if another struct mem (SIZEOF_STRUCT_MEM) containing + * at least MIN_SIZE_ALIGNED of data also fits in the 'user data space' of 'mem') + * -> split large block, create empty remainder, + * remainder must be large enough to contain MIN_SIZE_ALIGNED data: if + * mem->next - (ptr + (2*SIZEOF_STRUCT_MEM)) == size, + * struct mem would fit in but no data between mem2 and mem2->next + * @todo we could leave out MIN_SIZE_ALIGNED. We would create an empty + * region that couldn't hold data, but when mem->next gets freed, + * the 2 regions would be combined, resulting in more free memory + */ + ptr2 = ptr + SIZEOF_STRUCT_MEM + size; + /* create mem2 struct */ + mem2 = (struct mem *)(void *)&ram[ptr2]; + mem2->used = 0; + mem2->next = mem->next; + mem2->prev = ptr; + /* and insert it between mem and mem->next */ + mem->next = ptr2; + mem->used = 1; + + if (mem2->next != MEM_SIZE_ALIGNED) { + ((struct mem *)(void *)&ram[mem2->next])->prev = ptr2; + } + MEM_STATS_INC_USED(used, (size + SIZEOF_STRUCT_MEM)); + } else { + /* (a mem2 struct does no fit into the user data space of mem and mem->next will always + * be used at this point: if not we have 2 unused structs in a row, plug_holes should have + * take care of this). + * -> near fit or exact fit: do not split, no mem2 creation + * also can't move mem->next directly behind mem, since mem->next + * will always be used at this point! + */ + mem->used = 1; + MEM_STATS_INC_USED(used, mem->next - (mem_size_t)((u8_t *)mem - ram)); + } +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT +mem_malloc_adjust_lfree: +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + if (mem == lfree) { + struct mem *cur = lfree; + /* Find next free block after mem and update lowest free pointer */ + while (cur->used && cur != ram_end) { +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + mem_free_count = 0; + LWIP_MEM_ALLOC_UNPROTECT(); + /* prevent high interrupt latency... */ + LWIP_MEM_ALLOC_PROTECT(); + if (mem_free_count != 0) { + /* If mem_free or mem_trim have run, we have to restart since they + could have altered our current struct mem or lfree. */ + goto mem_malloc_adjust_lfree; + } +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + cur = (struct mem *)(void *)&ram[cur->next]; + } + lfree = cur; + LWIP_ASSERT("mem_malloc: !lfree->used", ((lfree == ram_end) || (!lfree->used))); + } + LWIP_MEM_ALLOC_UNPROTECT(); + sys_mutex_unlock(&mem_mutex); + LWIP_ASSERT("mem_malloc: allocated memory not above ram_end.", + (mem_ptr_t)mem + SIZEOF_STRUCT_MEM + size <= (mem_ptr_t)ram_end); + LWIP_ASSERT("mem_malloc: allocated memory properly aligned.", + ((mem_ptr_t)mem + SIZEOF_STRUCT_MEM) % MEM_ALIGNMENT == 0); + LWIP_ASSERT("mem_malloc: sanity check alignment", + (((mem_ptr_t)mem) & (MEM_ALIGNMENT-1)) == 0); + + return (u8_t *)mem + SIZEOF_STRUCT_MEM; + } + } +#if LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT + /* if we got interrupted by a mem_free, try again */ + } while (local_mem_free_count != 0); +#endif /* LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT */ + LWIP_DEBUGF(MEM_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("mem_malloc: could not allocate %"S16_F" bytes\n", (s16_t)size)); + MEM_STATS_INC(err); + LWIP_MEM_ALLOC_UNPROTECT(); + sys_mutex_unlock(&mem_mutex); + return NULL; +} + +#endif /* MEM_USE_POOLS */ +/** + * Contiguously allocates enough space for count objects that are size bytes + * of memory each and returns a pointer to the allocated memory. + * + * The allocated memory is filled with bytes of value zero. + * + * @param count number of objects to allocate + * @param size size of the objects to allocate + * @return pointer to allocated memory / NULL pointer if there is an error + */ +void *mem_calloc(mem_size_t count, mem_size_t size) +{ + void *p; + + /* allocate 'count' objects of size 'size' */ + p = mem_malloc(count * size); + if (p) { + /* zero the memory */ + memset(p, 0, (size_t)count * (size_t)size); + } + return p; +} + +#endif /* !MEM_LIBC_MALLOC */ diff --git a/components/lwip/core/memp.c b/components/lwip/core/memp.c new file mode 100755 index 000000000..a5169abc8 --- /dev/null +++ b/components/lwip/core/memp.c @@ -0,0 +1,436 @@ +/** + * @file + * Dynamic pool memory manager + * + * lwIP has dedicated pools for many structures (netconn, protocol control blocks, + * packet buffers, ...). All these pools are managed here. + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/memp.h" +#include "lwip/pbuf.h" +#include "lwip/udp.h" +#include "lwip/raw.h" +#include "lwip/igmp.h" +#include "lwip/api.h" +#include "lwip/priv/api_msg.h" +#include "lwip/sockets.h" +#include "lwip/sys.h" +#include "lwip/timers.h" +#include "lwip/stats.h" +#include "netif/etharp.h" +#include "lwip/ip_frag.h" +#include "lwip/dns.h" +#include "lwip/netdb.h" +#include "netif/ppp/ppp.h" +#include "netif/ppp/pppos.h" +#include "netif/ppp/pppoe.h" +#include "netif/ppp/pppol2tp.h" +#include "lwip/nd6.h" +#include "lwip/ip6_frag.h" +#include "lwip/mld6.h" +#include "lwip/tcp.h" +#include "lwip/tcpip.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/priv/tcpip_priv.h" +#include "lwip/netifapi.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#define LWIP_MEMPOOL(name,num,size,desc) LWIP_MEMPOOL_DECLARE(name,num,size,desc) +#include "lwip/priv/memp_std.h" + +const struct memp_desc* const memp_pools[MEMP_MAX] = { +#define LWIP_MEMPOOL(name,num,size,desc) &memp_ ## name, +#include "lwip/priv/memp_std.h" +}; + +#if !MEMP_MEM_MALLOC /* don't build if not configured for use in lwipopts.h */ + +#if MEMP_SANITY_CHECK +/** + * Check that memp-lists don't form a circle, using "Floyd's cycle-finding algorithm". + */ +static int +memp_sanity(const struct memp_desc *desc) +{ + struct memp *t, *h; + + t = *desc->tab; + if (t != NULL) { + for (h = t->next; (t != NULL) && (h != NULL); t = t->next, + h = ((h->next != NULL) ? h->next->next : NULL)) { + if (t == h) { + return 0; + } + } + } + + return 1; +} +#endif /* MEMP_SANITY_CHECK*/ + +#if MEMP_OVERFLOW_CHECK + +/** + * Check if a memp element was victim of an overflow + * (e.g. the restricted area after it has been altered) + * + * @param p the memp element to check + * @param memp_type the pool p comes from + */ +static void +memp_overflow_check_element_overflow(struct memp *p, const struct memp_desc *desc) +{ + u16_t k; + u8_t *m; +#if MEMP_SANITY_REGION_AFTER_ALIGNED > 0 + m = (u8_t*)p + MEMP_SIZE + desc->size; + for (k = 0; k < MEMP_SANITY_REGION_AFTER_ALIGNED; k++) { + if (m[k] != 0xcd) { + char errstr[128] = "detected memp overflow in pool "; + strcat(errstr, desc->desc); + LWIP_ASSERT(errstr, 0); + } + } +#endif +} + +/** + * Check if a memp element was victim of an underflow + * (e.g. the restricted area before it has been altered) + * + * @param p the memp element to check + * @param memp_type the pool p comes from + */ +static void +memp_overflow_check_element_underflow(struct memp *p, const struct memp_desc *desc) +{ + u16_t k; + u8_t *m; +#if MEMP_SANITY_REGION_BEFORE_ALIGNED > 0 + m = (u8_t*)p + MEMP_SIZE - MEMP_SANITY_REGION_BEFORE_ALIGNED; + for (k = 0; k < MEMP_SANITY_REGION_BEFORE_ALIGNED; k++) { + if (m[k] != 0xcd) { + char errstr[128] = "detected memp underflow in pool "; + strcat(errstr, desc->desc); + LWIP_ASSERT(errstr, 0); + } + } +#endif +} + +/** + * Do an overflow check for all elements in every pool. + * + * @see memp_overflow_check_element for a description of the check + */ +static void +memp_overflow_check_all(void) +{ + u16_t i, j; + struct memp *p; + + for (i = 0; i < MEMP_MAX; ++i) { + p = (struct memp *)(size_t)(memp_pools[i]->base); + for (j = 0; j < memp_pools[i]->num; ++j) { + memp_overflow_check_element_overflow(p, memp_pools[i]); + memp_overflow_check_element_underflow(p, memp_pools[i]); + p = (struct memp*)(size_t)((u8_t*)p + MEMP_SIZE + memp_pools[i]->size + MEMP_SANITY_REGION_AFTER_ALIGNED); + } + } +} + +/** + * Initialize the restricted areas of all memp elements in every pool. + */ +static void +memp_overflow_init(const struct memp_desc *desc) +{ + u16_t i; + struct memp *p; + u8_t *m; + + p = (struct memp *)(size_t)(desc->base); + for (i = 0; i < desc->num; ++i) { +#if MEMP_SANITY_REGION_BEFORE_ALIGNED > 0 + m = (u8_t*)p + MEMP_SIZE - MEMP_SANITY_REGION_BEFORE_ALIGNED; + memset(m, 0xcd, MEMP_SANITY_REGION_BEFORE_ALIGNED); +#endif +#if MEMP_SANITY_REGION_AFTER_ALIGNED > 0 + m = (u8_t*)p + MEMP_SIZE + desc->size; + memset(m, 0xcd, MEMP_SANITY_REGION_AFTER_ALIGNED); +#endif + p = (struct memp*)(size_t)((u8_t*)p + MEMP_SIZE + desc->size + MEMP_SANITY_REGION_AFTER_ALIGNED); + } +} +#endif /* MEMP_OVERFLOW_CHECK */ + + +void +memp_init_pool(const struct memp_desc *desc) +{ + int i; + struct memp *memp; + + *desc->tab = NULL; + memp = (struct memp*)LWIP_MEM_ALIGN(desc->base); + /* create a linked list of memp elements */ + for (i = 0; i < desc->num; ++i) { + memp->next = *desc->tab; + *desc->tab = memp; + memp = (struct memp *)(void *)((u8_t *)memp + MEMP_SIZE + desc->size +#if MEMP_OVERFLOW_CHECK + + MEMP_SANITY_REGION_AFTER_ALIGNED +#endif + ); + } + +#if MEMP_OVERFLOW_CHECK + memp_overflow_init(desc); +#endif /* MEMP_OVERFLOW_CHECK */ +} + +/** + * Initialize this module. + * + * Carves out memp_memory into linked lists for each pool-type. + */ +void +memp_init(void) +{ + u16_t i; + + for (i = 0; i < MEMP_MAX; ++i) { + MEMP_STATS_AVAIL(used, i, 0); + MEMP_STATS_AVAIL(max, i, 0); + MEMP_STATS_AVAIL(err, i, 0); + MEMP_STATS_AVAIL(avail, i, memp_pools[i]->num); + } + + /* for every pool: */ + for (i = 0; i < MEMP_MAX; ++i) { + memp_init_pool(memp_pools[i]); + } + +#if MEMP_OVERFLOW_CHECK + /* check everything a first time to see if it worked */ + memp_overflow_check_all(); +#endif /* MEMP_OVERFLOW_CHECK */ +} + +void * +#if !MEMP_OVERFLOW_CHECK +memp_malloc_pool(const struct memp_desc *desc) +#else +memp_malloc_pool_fn(const struct memp_desc *desc, const char* file, const int line) +#endif +{ + struct memp *memp; + SYS_ARCH_DECL_PROTECT(old_level); + + SYS_ARCH_PROTECT(old_level); + + memp = *desc->tab; + +#if MEMP_OVERFLOW_CHECK == 1 + memp_overflow_check_element_overflow(memp, desc); + memp_overflow_check_element_underflow(memp, desc); +#endif /* MEMP_OVERFLOW_CHECK */ + + if (memp != NULL) { + *desc->tab = memp->next; +#if MEMP_OVERFLOW_CHECK + memp->next = NULL; + memp->file = file; + memp->line = line; +#endif /* MEMP_OVERFLOW_CHECK */ + LWIP_ASSERT("memp_malloc: memp properly aligned", + ((mem_ptr_t)memp % MEM_ALIGNMENT) == 0); + memp = (struct memp*)(void *)((u8_t*)memp + MEMP_SIZE); + } + + SYS_ARCH_UNPROTECT(old_level); + + return memp; +} + +/** + * Get an element from a specific pool. + * + * @param type the pool to get an element from + * + * the debug version has two more parameters: + * @param file file name calling this function + * @param line number of line where this function is called + * + * @return a pointer to the allocated memory or a NULL pointer on error + */ +void * +#if !MEMP_OVERFLOW_CHECK +memp_malloc(memp_t type) +#else +memp_malloc_fn(memp_t type, const char* file, const int line) +#endif +{ + void *memp; + SYS_ARCH_DECL_PROTECT(old_level); + + LWIP_ERROR("memp_malloc: type < MEMP_MAX", (type < MEMP_MAX), return NULL;); + + SYS_ARCH_PROTECT(old_level); + +#if MEMP_OVERFLOW_CHECK >= 2 + memp_overflow_check_all(); +#endif /* MEMP_OVERFLOW_CHECK >= 2 */ + +#if !MEMP_OVERFLOW_CHECK + memp = memp_malloc_pool(memp_pools[type]); +#else + memp = memp_malloc_pool_fn(memp_pools[type], file, line); +#endif + + if (memp != NULL) { + MEMP_STATS_INC(used, type); + if(MEMP_STATS_GET(used, type) > MEMP_STATS_GET(max, type)) { + MEMP_STATS_AVAIL(max, type, MEMP_STATS_GET(used, type)); + } + } else { + LWIP_DEBUGF(MEMP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("memp_malloc: out of memory in pool %s\n", memp_pools[type]->desc)); + MEMP_STATS_INC(err, type); + } + + SYS_ARCH_UNPROTECT(old_level); + + return memp; +} + +static void +#ifdef LWIP_HOOK_MEMP_AVAILABLE +do_memp_free_pool(const struct memp_desc* desc, void *mem, struct memp **old_first) +#else +do_memp_free_pool(const struct memp_desc* desc, void *mem) +#endif +{ + struct memp *memp; + SYS_ARCH_DECL_PROTECT(old_level); + + LWIP_ASSERT("memp_free: mem properly aligned", + ((mem_ptr_t)mem % MEM_ALIGNMENT) == 0); + + memp = (struct memp *)(void *)((u8_t*)mem - MEMP_SIZE); + + SYS_ARCH_PROTECT(old_level); + +#if MEMP_OVERFLOW_CHECK == 1 + memp_overflow_check_element_overflow(memp, desc); + memp_overflow_check_element_underflow(memp, desc); +#endif /* MEMP_OVERFLOW_CHECK */ + + memp->next = *desc->tab; + +#ifdef LWIP_HOOK_MEMP_AVAILABLE + if (old_first) + *old_first = *desc->tab; +#endif + + *desc->tab = memp; + +#if MEMP_SANITY_CHECK + LWIP_ASSERT("memp sanity", memp_sanity(desc)); +#endif /* MEMP_SANITY_CHECK */ + + SYS_ARCH_UNPROTECT(old_level); +} + +void +memp_free_pool(const struct memp_desc* desc, void *mem) +{ + if ((desc == NULL) || (mem == NULL)) { + return; + } + +#ifdef LWIP_HOOK_MEMP_AVAILABLE + do_memp_free_pool(desc, mem, NULL); +#else + do_memp_free_pool(desc, mem); +#endif +} + +/** + * Put an element back into its pool. + * + * @param type the pool where to put mem + * @param mem the memp element to free + */ +void +memp_free(memp_t type, void *mem) +{ +#ifdef LWIP_HOOK_MEMP_AVAILABLE + struct memp *old_first; +#endif + SYS_ARCH_DECL_PROTECT(old_level); + + LWIP_ERROR("memp_free: type < MEMP_MAX", (type < MEMP_MAX), return;); + + SYS_ARCH_PROTECT(old_level); + +#if MEMP_OVERFLOW_CHECK >= 2 + memp_overflow_check_all(); +#endif /* MEMP_OVERFLOW_CHECK >= 2 */ + + MEMP_STATS_DEC(used, type); + +#ifdef LWIP_HOOK_MEMP_AVAILABLE + do_memp_free_pool(memp_pools[type], mem, &old_first); +#else + do_memp_free_pool(memp_pools[type], mem); +#endif + + SYS_ARCH_UNPROTECT(old_level); + +#ifdef LWIP_HOOK_MEMP_AVAILABLE + if (old_first == NULL) { + LWIP_HOOK_MEMP_AVAILABLE(type); + } +#endif +} + +#endif /* MEMP_MEM_MALLOC */ diff --git a/components/lwip/core/netif.c b/components/lwip/core/netif.c new file mode 100755 index 000000000..42309f1a3 --- /dev/null +++ b/components/lwip/core/netif.c @@ -0,0 +1,1090 @@ +/** + * @file + * lwIP network interface abstraction + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/def.h" +#include "lwip/ip_addr.h" +#include "lwip/ip6_addr.h" +#include "lwip/netif.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/udp.h" +#include "lwip/snmp.h" +#include "lwip/igmp.h" +#include "netif/etharp.h" +#include "lwip/stats.h" +#include "lwip/sys.h" +#if ENABLE_LOOPBACK +#include "lwip/sys.h" +#if LWIP_NETIF_LOOPBACK_MULTITHREADING +#include "lwip/tcpip.h" +#endif /* LWIP_NETIF_LOOPBACK_MULTITHREADING */ +#endif /* ENABLE_LOOPBACK */ + +#if LWIP_AUTOIP +#include "lwip/autoip.h" +#endif /* LWIP_AUTOIP */ +#if LWIP_DHCP +#include "lwip/dhcp.h" +#endif /* LWIP_DHCP */ +#if LWIP_IPV6_DHCP6 +#include "lwip/dhcp6.h" +#endif /* LWIP_IPV6_DHCP6 */ +#if LWIP_IPV6_MLD +#include "lwip/mld6.h" +#endif /* LWIP_IPV6_MLD */ + +#if LWIP_NETIF_STATUS_CALLBACK +#define NETIF_STATUS_CALLBACK(n) do{ if (n->status_callback) { (n->status_callback)(n); }}while(0) +#else +#define NETIF_STATUS_CALLBACK(n) +#endif /* LWIP_NETIF_STATUS_CALLBACK */ + +#if LWIP_NETIF_LINK_CALLBACK +#define NETIF_LINK_CALLBACK(n) do{ if (n->link_callback) { (n->link_callback)(n); }}while(0) +#else +#define NETIF_LINK_CALLBACK(n) +#endif /* LWIP_NETIF_LINK_CALLBACK */ + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +struct netif *netif_list; +struct netif *netif_default; + +static u8_t netif_num; + +#define NETIF_REPORT_TYPE_IPV4 0x01 +#define NETIF_REPORT_TYPE_IPV6 0x02 +static void netif_issue_reports(struct netif* netif, u8_t report_type); + +#if LWIP_IPV6 +static err_t netif_null_output_ip6(struct netif *netif, struct pbuf *p, const ip6_addr_t *ipaddr); +#endif /* LWIP_IPV6 */ + +#if LWIP_HAVE_LOOPIF +#if LWIP_IPV4 +static err_t netif_loop_output_ipv4(struct netif *netif, struct pbuf *p, const ip4_addr_t* addr); +#endif +#if LWIP_IPV6 +static err_t netif_loop_output_ipv6(struct netif *netif, struct pbuf *p, const ip6_addr_t* addr); +#endif + + +static struct netif loop_netif; + +/** + * Initialize a lwip network interface structure for a loopback interface + * + * @param netif the lwip network interface structure for this loopif + * @return ERR_OK if the loopif is initialized + * ERR_MEM if private data couldn't be allocated + */ +static err_t +netif_loopif_init(struct netif *netif) +{ + /* initialize the snmp variables and counters inside the struct netif + * ifSpeed: no assumption can be made! + */ + MIB2_INIT_NETIF(netif, snmp_ifType_softwareLoopback, 0); + + netif->name[0] = 'l'; + netif->name[1] = 'o'; +#if LWIP_IPV4 + netif->output = netif_loop_output_ipv4; +#endif +#if LWIP_IPV6 + netif->output_ip6 = netif_loop_output_ipv6; +#endif +#if LWIP_LOOPIF_MULTICAST + netif->flags |= NETIF_FLAG_IGMP; +#endif + return ERR_OK; +} +#endif /* LWIP_HAVE_LOOPIF */ + +void +netif_init(void) +{ +#if LWIP_HAVE_LOOPIF +#if LWIP_IPV4 +#define LOOPIF_ADDRINIT &loop_ipaddr, &loop_netmask, &loop_gw, + ip4_addr_t loop_ipaddr, loop_netmask, loop_gw; + IP4_ADDR(&loop_gw, 127,0,0,1); + IP4_ADDR(&loop_ipaddr, 127,0,0,1); + IP4_ADDR(&loop_netmask, 255,0,0,0); +#else /* LWIP_IPV4 */ +#define LOOPIF_ADDRINIT +#endif /* LWIP_IPV4 */ + +#if NO_SYS + netif_add(&loop_netif, LOOPIF_ADDRINIT NULL, netif_loopif_init, ip_input); +#else /* NO_SYS */ + netif_add(&loop_netif, LOOPIF_ADDRINIT NULL, netif_loopif_init, tcpip_input); +#endif /* NO_SYS */ + +#if LWIP_IPV6 + IP_ADDR6(loop_netif.ip6_addr, 0, 0, 0, PP_HTONL(0x00000001UL)); + loop_netif.ip6_addr_state[0] = IP6_ADDR_VALID; +#endif /* LWIP_IPV6 */ + + netif_set_link_up(&loop_netif); + netif_set_up(&loop_netif); + +#endif /* LWIP_HAVE_LOOPIF */ +} + +/** + * Add a network interface to the list of lwIP netifs. + * + * @param netif a pre-allocated netif structure + * @param ipaddr IP address for the new netif + * @param netmask network mask for the new netif + * @param gw default gateway IP address for the new netif + * @param state opaque data passed to the new netif + * @param init callback function that initializes the interface + * @param input callback function that is called to pass + * ingress packets up in the protocol layer stack. + * + * @return netif, or NULL if failed. + */ +struct netif * +netif_add(struct netif *netif, +#if LWIP_IPV4 + const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, const ip4_addr_t *gw, +#endif /* LWIP_IPV4 */ + void *state, netif_init_fn init, netif_input_fn input) +{ +#if LWIP_IPV6 + u32_t i; +#endif + + LWIP_ASSERT("No init function given", init != NULL); + + /* reset new interface configuration state */ +#if LWIP_IPV4 + ip_addr_set_zero_ip4(&netif->ip_addr); + ip_addr_set_zero_ip4(&netif->netmask); + ip_addr_set_zero_ip4(&netif->gw); +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + ip_addr_set_zero_ip6(&netif->ip6_addr[i]); + netif_ip6_addr_set_state(netif, i, IP6_ADDR_INVALID); + } + netif->output_ip6 = netif_null_output_ip6; +#endif /* LWIP_IPV6 */ + + + NETIF_SET_CHECKSUM_CTRL(netif, NETIF_CHECKSUM_ENABLE_ALL); + netif->flags = 0; + +#if LWIP_DHCP + /* netif not under DHCP control by default */ + netif->dhcp = NULL; + +#ifdef LWIP_ESP8266 + netif->dhcps_pcb = NULL; +#endif + +#endif /* LWIP_DHCP */ + + +#if LWIP_AUTOIP + /* netif not under AutoIP control by default */ + netif->autoip = NULL; +#endif /* LWIP_AUTOIP */ +#if LWIP_IPV6_AUTOCONFIG + +#ifdef LWIP_ESP8266 +//#if 0 + netif->ip6_autoconfig_enabled = 1; +#else + /* IPv6 address autoconfiguration not enabled by default */ + netif->ip6_autoconfig_enabled = 0; +#endif + +#endif /* LWIP_IPV6_AUTOCONFIG */ + + +#if LWIP_IPV6_SEND_ROUTER_SOLICIT + netif->rs_count = LWIP_ND6_MAX_MULTICAST_SOLICIT; +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ +#if LWIP_IPV6_DHCP6 + /* netif not under DHCPv6 control by default */ + netif->dhcp6 = NULL; +#endif /* LWIP_IPV6_DHCP6 */ +#if LWIP_NETIF_STATUS_CALLBACK + netif->status_callback = NULL; +#endif /* LWIP_NETIF_STATUS_CALLBACK */ +#if LWIP_NETIF_LINK_CALLBACK + netif->link_callback = NULL; +#endif /* LWIP_NETIF_LINK_CALLBACK */ +#if LWIP_IGMP + netif->igmp_mac_filter = NULL; +#endif /* LWIP_IGMP */ +#if LWIP_IPV6 && LWIP_IPV6_MLD + netif->mld_mac_filter = NULL; +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ +#if ENABLE_LOOPBACK + netif->loop_first = NULL; + netif->loop_last = NULL; +#endif /* ENABLE_LOOPBACK */ + + + /* remember netif specific state information data */ + netif->state = state; + netif->num = netif_num++; + netif->input = input; + NETIF_SET_HWADDRHINT(netif, NULL); +#if ENABLE_LOOPBACK && LWIP_LOOPBACK_MAX_PBUFS + netif->loop_cnt_current = 0; +#endif /* ENABLE_LOOPBACK && LWIP_LOOPBACK_MAX_PBUFS */ + +#if LWIP_IPV4 + netif_set_addr(netif, ipaddr, netmask, gw); +#endif /* LWIP_IPV4 */ + + + /* call user specified initialization function for netif */ + if (init(netif) != ERR_OK) { + return NULL; + } + + /* add this netif to the list */ + netif->next = netif_list; + netif_list = netif; + mib2_netif_added(netif); + +#if LWIP_IGMP + /* start IGMP processing */ + if (netif->flags & NETIF_FLAG_IGMP) { + igmp_start(netif); + } +#endif /* LWIP_IGMP */ + + LWIP_DEBUGF(NETIF_DEBUG, ("netif: added interface %c%c IP", + netif->name[0], netif->name[1])); +#if LWIP_IPV4 + LWIP_DEBUGF(NETIF_DEBUG, (" addr ")); + ip4_addr_debug_print(NETIF_DEBUG, ipaddr); + LWIP_DEBUGF(NETIF_DEBUG, (" netmask ")); + ip4_addr_debug_print(NETIF_DEBUG, netmask); + LWIP_DEBUGF(NETIF_DEBUG, (" gw ")); + ip4_addr_debug_print(NETIF_DEBUG, gw); +#endif /* LWIP_IPV4 */ + LWIP_DEBUGF(NETIF_DEBUG, ("\n")); + + return netif; +} + +typedef int (*netif_addr_change_cb_t)(struct netif *netif); +static netif_addr_change_cb_t g_netif_addr_change_cb = NULL; + +void netif_reg_addr_change_cb(void *cb) +{ + g_netif_addr_change_cb = (netif_addr_change_cb_t)cb; +} + +#if LWIP_IPV4 +/** + * Change IP address configuration for a network interface (including netmask + * and default gateway). + * + * @param netif the network interface to change + * @param ipaddr the new IP address + * @param netmask the new netmask + * @param gw the new default gateway + */ +void +netif_set_addr(struct netif *netif, const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, + const ip4_addr_t *gw) +{ + netif_set_netmask(netif, netmask); + netif_set_gw(netif, gw); + /* set ipaddr last to ensure netmask/gw have been set when status callback is called */ + netif_set_ipaddr(netif, ipaddr); + if (g_netif_addr_change_cb){ + g_netif_addr_change_cb(netif); + } +} + +#endif /* LWIP_IPV4*/ + +/** + * Remove a network interface from the list of lwIP netifs. + * + * @param netif the network interface to remove + */ +void +netif_remove(struct netif *netif) +{ + if (netif == NULL) { + return; + } + +#if LWIP_IPV4 + if (!ip4_addr_isany_val(*netif_ip4_addr(netif))) { +#if LWIP_TCP + tcp_netif_ipv4_addr_changed(netif_ip4_addr(netif), NULL); +#endif /* LWIP_TCP */ + /* cannot do this for UDP, as there is no 'err' callback in udp pcbs */ + } + +#if LWIP_IGMP + /* stop IGMP processing */ + if (netif->flags & NETIF_FLAG_IGMP) { + igmp_stop(netif); + } +#endif /* LWIP_IGMP */ +#endif /* LWIP_IPV4*/ + +#if LWIP_IPV6 && LWIP_IPV6_MLD + /* stop MLD processing */ + mld6_stop(netif); +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + if (netif_is_up(netif)) { + /* set netif down before removing (call callback function) */ + netif_set_down(netif); + } + + mib2_remove_ip4(netif); + + /* this netif is default? */ + if (netif_default == netif) { + /* reset default netif */ + netif_set_default(NULL); + } + /* is it the first netif? */ + if (netif_list == netif) { + netif_list = netif->next; + } else { + /* look for netif further down the list */ + struct netif * tmp_netif; + for (tmp_netif = netif_list; tmp_netif != NULL; tmp_netif = tmp_netif->next) { + if (tmp_netif->next == netif) { + tmp_netif->next = netif->next; + break; + } + } + if (tmp_netif == NULL) { + return; /* netif is not on the list */ + } + } + mib2_netif_removed(netif); +#if LWIP_NETIF_REMOVE_CALLBACK + if (netif->remove_callback) { + netif->remove_callback(netif); + } +#endif /* LWIP_NETIF_REMOVE_CALLBACK */ + LWIP_DEBUGF( NETIF_DEBUG, ("netif_remove: removed netif\n") ); +} + +/** + * Find a network interface by searching for its name + * + * @param name the name of the netif (like netif->name) plus concatenated number + * in ascii representation (e.g. 'en0') + */ +struct netif * +netif_find(const char *name) +{ + struct netif *netif; + u8_t num; + + if (name == NULL) { + return NULL; + } + + num = name[2] - '0'; + + for (netif = netif_list; netif != NULL; netif = netif->next) { + if (num == netif->num && + name[0] == netif->name[0] && + name[1] == netif->name[1]) { + LWIP_DEBUGF(NETIF_DEBUG, ("netif_find: found %c%c\n", name[0], name[1])); + return netif; + } + } + LWIP_DEBUGF(NETIF_DEBUG, ("netif_find: didn't find %c%c\n", name[0], name[1])); + return NULL; +} + +#if LWIP_IPV4 +/** + * Change the IP address of a network interface + * + * @param netif the network interface to change + * @param ipaddr the new IP address + * + * @note call netif_set_addr() if you also want to change netmask and + * default gateway + */ +void +netif_set_ipaddr(struct netif *netif, const ip4_addr_t *ipaddr) +{ + ip4_addr_t new_addr = (ipaddr ? *ipaddr : *IP4_ADDR_ANY); + /* address is actually being changed? */ + if (ip4_addr_cmp(&new_addr, netif_ip4_addr(netif)) == 0) { + LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_STATE, ("netif_set_ipaddr: netif address being changed\n")); +#if LWIP_TCP + tcp_netif_ipv4_addr_changed(netif_ip4_addr(netif), ipaddr); +#endif /* LWIP_TCP */ +#if LWIP_UDP + udp_netif_ipv4_addr_changed(netif_ip4_addr(netif), ipaddr); +#endif /* LWIP_UDP */ + + mib2_remove_ip4(netif); + mib2_remove_route_ip4(0, netif); + /* set new IP address to netif */ + ip4_addr_set(ip_2_ip4(&netif->ip_addr), ipaddr); + IP_SET_TYPE_VAL(netif->ip_addr, IPADDR_TYPE_V4); + mib2_add_ip4(netif); + mib2_add_route_ip4(0, netif); + + netif_issue_reports(netif, NETIF_REPORT_TYPE_IPV4); + + NETIF_STATUS_CALLBACK(netif); + } + + LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("netif: IP address of interface %c%c set to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + netif->name[0], netif->name[1], + ip4_addr1_16(netif_ip4_addr(netif)), + ip4_addr2_16(netif_ip4_addr(netif)), + ip4_addr3_16(netif_ip4_addr(netif)), + ip4_addr4_16(netif_ip4_addr(netif)))); +} + +/** + * Change the default gateway for a network interface + * + * @param netif the network interface to change + * @param gw the new default gateway + * + * @note call netif_set_addr() if you also want to change ip address and netmask + */ +void +netif_set_gw(struct netif *netif, const ip4_addr_t *gw) +{ + ip4_addr_set(ip_2_ip4(&netif->gw), gw); + IP_SET_TYPE_VAL(netif->gw, IPADDR_TYPE_V4); + LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("netif: GW address of interface %c%c set to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + netif->name[0], netif->name[1], + ip4_addr1_16(netif_ip4_gw(netif)), + ip4_addr2_16(netif_ip4_gw(netif)), + ip4_addr3_16(netif_ip4_gw(netif)), + ip4_addr4_16(netif_ip4_gw(netif)))); +} + +/** + * Change the netmask of a network interface + * + * @param netif the network interface to change + * @param netmask the new netmask + * + * @note call netif_set_addr() if you also want to change ip address and + * default gateway + */ +void +netif_set_netmask(struct netif *netif, const ip4_addr_t *netmask) +{ + mib2_remove_route_ip4(0, netif); + /* set new netmask to netif */ + ip4_addr_set(ip_2_ip4(&netif->netmask), netmask); + IP_SET_TYPE_VAL(netif->netmask, IPADDR_TYPE_V4); + mib2_add_route_ip4(0, netif); + LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("netif: netmask of interface %c%c set to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + netif->name[0], netif->name[1], + ip4_addr1_16(netif_ip4_netmask(netif)), + ip4_addr2_16(netif_ip4_netmask(netif)), + ip4_addr3_16(netif_ip4_netmask(netif)), + ip4_addr4_16(netif_ip4_netmask(netif)))); +} +#endif /* LWIP_IPV4 */ + +/** + * Set a network interface as the default network interface + * (used to output all packets for which no specific route is found) + * + * @param netif the default network interface + */ +void +netif_set_default(struct netif *netif) +{ + if (netif == NULL) { + /* remove default route */ + mib2_remove_route_ip4(1, netif); + } else { + /* install default route */ + mib2_add_route_ip4(1, netif); + } + netif_default = netif; + LWIP_DEBUGF(NETIF_DEBUG, ("netif: setting default interface %c%c\n", + netif ? netif->name[0] : '\'', netif ? netif->name[1] : '\'')); +} + +/** + * Bring an interface up, available for processing + * traffic. + */ +void +netif_set_up(struct netif *netif) +{ + if (!(netif->flags & NETIF_FLAG_UP)) { + netif->flags |= NETIF_FLAG_UP; + + MIB2_COPY_SYSUPTIME_TO(&netif->ts); + + NETIF_STATUS_CALLBACK(netif); + + if (netif->flags & NETIF_FLAG_LINK_UP) { + netif_issue_reports(netif, NETIF_REPORT_TYPE_IPV4|NETIF_REPORT_TYPE_IPV6); + } + } +} + +/** Send ARP/IGMP/MLD/RS events, e.g. on link-up/netif-up or addr-change + */ +static void +netif_issue_reports(struct netif* netif, u8_t report_type) +{ +#if LWIP_IPV4 + if ((report_type & NETIF_REPORT_TYPE_IPV4) && + !ip4_addr_isany_val(*netif_ip4_addr(netif))) { +#if LWIP_ARP + /* For Ethernet network interfaces, we would like to send a "gratuitous ARP" */ + if (netif->flags & (NETIF_FLAG_ETHARP)) { + etharp_gratuitous(netif); + } +#endif /* LWIP_ARP */ + +#if LWIP_IGMP + /* resend IGMP memberships */ + if (netif->flags & NETIF_FLAG_IGMP) { + igmp_report_groups(netif); + } +#endif /* LWIP_IGMP */ + } +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 + if (report_type & NETIF_REPORT_TYPE_IPV6) { +#if LWIP_IPV6_MLD + /* send mld memberships */ + mld6_report_groups(netif); +#endif /* LWIP_IPV6_MLD */ +#if LWIP_IPV6_SEND_ROUTER_SOLICIT + /* Send Router Solicitation messages. */ + netif->rs_count = LWIP_ND6_MAX_MULTICAST_SOLICIT; +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + } +#endif /* LWIP_IPV6 */ +} + +/** + * Bring an interface down, disabling any traffic processing. + */ +void +netif_set_down(struct netif *netif) +{ + if (netif->flags & NETIF_FLAG_UP) { + netif->flags &= ~NETIF_FLAG_UP; + MIB2_COPY_SYSUPTIME_TO(&netif->ts); + +#if LWIP_IPV4 && LWIP_ARP + if (netif->flags & NETIF_FLAG_ETHARP) { + etharp_cleanup_netif(netif); + } +#endif /* LWIP_IPV4 && LWIP_ARP */ + NETIF_STATUS_CALLBACK(netif); + } +} + +#if LWIP_NETIF_STATUS_CALLBACK +/** + * Set callback to be called when interface is brought up/down or address is changed while up + */ +void +netif_set_status_callback(struct netif *netif, netif_status_callback_fn status_callback) +{ + if (netif) { + netif->status_callback = status_callback; + } +} +#endif /* LWIP_NETIF_STATUS_CALLBACK */ + +#if LWIP_NETIF_REMOVE_CALLBACK +/** + * Set callback to be called when the interface has been removed + */ +void +netif_set_remove_callback(struct netif *netif, netif_status_callback_fn remove_callback) +{ + if (netif) { + netif->remove_callback = remove_callback; + } +} +#endif /* LWIP_NETIF_REMOVE_CALLBACK */ + +/** + * Called by a driver when its link goes up + */ +void +netif_set_link_up(struct netif *netif) +{ + if (!(netif->flags & NETIF_FLAG_LINK_UP)) { + netif->flags |= NETIF_FLAG_LINK_UP; + +#if LWIP_DHCP + if (netif->dhcp) { + dhcp_network_changed(netif); + } +#endif /* LWIP_DHCP */ + +#if LWIP_AUTOIP + if (netif->autoip) { + autoip_network_changed(netif); + } +#endif /* LWIP_AUTOIP */ + + if (netif->flags & NETIF_FLAG_UP) { + netif_issue_reports(netif, NETIF_REPORT_TYPE_IPV4|NETIF_REPORT_TYPE_IPV6); + } + NETIF_LINK_CALLBACK(netif); + } +} + +/** + * Called by a driver when its link goes down + */ +void +netif_set_link_down(struct netif *netif ) +{ + if (netif->flags & NETIF_FLAG_LINK_UP) { + netif->flags &= ~NETIF_FLAG_LINK_UP; + NETIF_LINK_CALLBACK(netif); + } +} + +#if LWIP_NETIF_LINK_CALLBACK +/** + * Set callback to be called when link is brought up/down + */ +void +netif_set_link_callback(struct netif *netif, netif_status_callback_fn link_callback) +{ + if (netif) { + netif->link_callback = link_callback; + } +} +#endif /* LWIP_NETIF_LINK_CALLBACK */ + +#if ENABLE_LOOPBACK +/** + * Send an IP packet to be received on the same netif (loopif-like). + * The pbuf is simply copied and handed back to netif->input. + * In multithreaded mode, this is done directly since netif->input must put + * the packet on a queue. + * In callback mode, the packet is put on an internal queue and is fed to + * netif->input by netif_poll(). + * + * @param netif the lwip network interface structure + * @param p the (IP) packet to 'send' + * @return ERR_OK if the packet has been sent + * ERR_MEM if the pbuf used to copy the packet couldn't be allocated + */ +err_t +netif_loop_output(struct netif *netif, struct pbuf *p) +{ + struct pbuf *r; + err_t err; + struct pbuf *last; +#if LWIP_LOOPBACK_MAX_PBUFS + u8_t clen = 0; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ + /* If we have a loopif, SNMP counters are adjusted for it, + * if not they are adjusted for 'netif'. */ +#if MIB2_STATS +#if LWIP_HAVE_LOOPIF + struct netif *stats_if = &loop_netif; +#else /* LWIP_HAVE_LOOPIF */ + struct netif *stats_if = netif; +#endif /* LWIP_HAVE_LOOPIF */ +#endif /* MIB2_STATS */ + SYS_ARCH_DECL_PROTECT(lev); + + /* Allocate a new pbuf */ + r = pbuf_alloc(PBUF_LINK, p->tot_len, PBUF_RAM); + if (r == NULL) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(stats_if, ifoutdiscards); + return ERR_MEM; + } +#if LWIP_LOOPBACK_MAX_PBUFS + clen = pbuf_clen(r); + /* check for overflow or too many pbuf on queue */ + if (((netif->loop_cnt_current + clen) < netif->loop_cnt_current) || + ((netif->loop_cnt_current + clen) > LWIP_LOOPBACK_MAX_PBUFS)) { + pbuf_free(r); + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(stats_if, ifoutdiscards); + return ERR_MEM; + } + netif->loop_cnt_current += clen; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ + + /* Copy the whole pbuf queue p into the single pbuf r */ + if ((err = pbuf_copy(r, p)) != ERR_OK) { + pbuf_free(r); + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(stats_if, ifoutdiscards); + return err; + } + + /* Put the packet on a linked list which gets emptied through calling + netif_poll(). */ + + /* let last point to the last pbuf in chain r */ + for (last = r; last->next != NULL; last = last->next); + + SYS_ARCH_PROTECT(lev); + if (netif->loop_first != NULL) { + LWIP_ASSERT("if first != NULL, last must also be != NULL", netif->loop_last != NULL); + netif->loop_last->next = r; + netif->loop_last = last; + } else { + netif->loop_first = r; + netif->loop_last = last; + } + SYS_ARCH_UNPROTECT(lev); + + LINK_STATS_INC(link.xmit); + MIB2_STATS_NETIF_ADD(stats_if, ifoutoctets, p->tot_len); + MIB2_STATS_NETIF_INC(stats_if, ifoutucastpkts); + +#if LWIP_NETIF_LOOPBACK_MULTITHREADING + /* For multithreading environment, schedule a call to netif_poll */ + tcpip_callback_with_block((tcpip_callback_fn)netif_poll, netif, 0); +#endif /* LWIP_NETIF_LOOPBACK_MULTITHREADING */ + + return ERR_OK; +} + +#if LWIP_HAVE_LOOPIF +#if LWIP_IPV4 +static err_t +netif_loop_output_ipv4(struct netif *netif, struct pbuf *p, const ip4_addr_t* addr) +{ + LWIP_UNUSED_ARG(addr); + return netif_loop_output(netif, p); +} +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +static err_t +netif_loop_output_ipv6(struct netif *netif, struct pbuf *p, const ip6_addr_t* addr) +{ + LWIP_UNUSED_ARG(addr); + return netif_loop_output(netif, p); +} +#endif /* LWIP_IPV6 */ +#endif /* LWIP_HAVE_LOOPIF */ + + +/** + * Call netif_poll() in the main loop of your application. This is to prevent + * reentering non-reentrant functions like tcp_input(). Packets passed to + * netif_loop_output() are put on a list that is passed to netif->input() by + * netif_poll(). + */ +void +netif_poll(struct netif *netif) +{ + struct pbuf *in; + /* If we have a loopif, SNMP counters are adjusted for it, + * if not they are adjusted for 'netif'. */ +#if MIB2_STATS +#if LWIP_HAVE_LOOPIF + struct netif *stats_if = &loop_netif; +#else /* LWIP_HAVE_LOOPIF */ + struct netif *stats_if = netif; +#endif /* LWIP_HAVE_LOOPIF */ +#endif /* MIB2_STATS */ + SYS_ARCH_DECL_PROTECT(lev); + + do { + /* Get a packet from the list. With SYS_LIGHTWEIGHT_PROT=1, this is protected */ + SYS_ARCH_PROTECT(lev); + in = netif->loop_first; + if (in != NULL) { + struct pbuf *in_end = in; +#if LWIP_LOOPBACK_MAX_PBUFS + u8_t clen = 1; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ + while (in_end->len != in_end->tot_len) { + LWIP_ASSERT("bogus pbuf: len != tot_len but next == NULL!", in_end->next != NULL); + in_end = in_end->next; +#if LWIP_LOOPBACK_MAX_PBUFS + clen++; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ + } +#if LWIP_LOOPBACK_MAX_PBUFS + /* adjust the number of pbufs on queue */ + LWIP_ASSERT("netif->loop_cnt_current underflow", + ((netif->loop_cnt_current - clen) < netif->loop_cnt_current)); + netif->loop_cnt_current -= clen; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ + + /* 'in_end' now points to the last pbuf from 'in' */ + if (in_end == netif->loop_last) { + /* this was the last pbuf in the list */ + netif->loop_first = netif->loop_last = NULL; + } else { + /* pop the pbuf off the list */ + netif->loop_first = in_end->next; + LWIP_ASSERT("should not be null since first != last!", netif->loop_first != NULL); + } + /* De-queue the pbuf from its successors on the 'loop_' list. */ + in_end->next = NULL; + } + SYS_ARCH_UNPROTECT(lev); + + if (in != NULL) { + LINK_STATS_INC(link.recv); + MIB2_STATS_NETIF_ADD(stats_if, ifinoctets, in->tot_len); + MIB2_STATS_NETIF_INC(stats_if, ifinucastpkts); + /* loopback packets are always IP packets! */ + if (ip_input(in, netif) != ERR_OK) { + pbuf_free(in); + } + /* Don't reference the packet any more! */ + in = NULL; + } + /* go on while there is a packet on the list */ + } while (netif->loop_first != NULL); +} + +#if !LWIP_NETIF_LOOPBACK_MULTITHREADING +/** + * Calls netif_poll() for every netif on the netif_list. + */ +void +netif_poll_all(void) +{ + struct netif *netif = netif_list; + /* loop through netifs */ + while (netif != NULL) { + netif_poll(netif); + /* proceed to next network interface */ + netif = netif->next; + } +} +#endif /* !LWIP_NETIF_LOOPBACK_MULTITHREADING */ +#endif /* ENABLE_LOOPBACK */ + +#if LWIP_IPV6 +/** Checks if a specific address is assigned to the netif and returns its + * index. + * + * @param netif the netif to check + * @param ip6addr the IPv6 address to find + * @return >= 0: address found, this is its index + * -1: address not found on this netif + */ +s8_t +netif_get_ip6_addr_match(struct netif *netif, const ip6_addr_t *ip6addr) +{ + s8_t i; + for (i = 0; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (!ip6_addr_isinvalid(netif_ip6_addr_state(netif, i)) && + ip6_addr_cmp(netif_ip6_addr(netif, i), ip6addr)) { + return i; + } + } + return -1; +} + +/** Create a link-local IPv6 address on a netif (stored in slot 0) + * + * @param netif the netif to create the address on + * @param from_mac_48bit if != 0, assume hwadr is a 48-bit MAC address (std conversion) + * if == 0, use hwaddr directly as interface ID + */ +void +netif_create_ip6_linklocal_address(struct netif *netif, u8_t from_mac_48bit) +{ + u8_t i, addr_index; + + /* Link-local prefix. */ + ip_2_ip6(&netif->ip6_addr[0])->addr[0] = PP_HTONL(0xfe800000ul); + ip_2_ip6(&netif->ip6_addr[0])->addr[1] = 0; + + /* Generate interface ID. */ + if (from_mac_48bit) { + /* Assume hwaddr is a 48-bit IEEE 802 MAC. Convert to EUI-64 address. Complement Group bit. */ + ip_2_ip6(&netif->ip6_addr[0])->addr[2] = htonl((((u32_t)(netif->hwaddr[0] ^ 0x02)) << 24) | + ((u32_t)(netif->hwaddr[1]) << 16) | + ((u32_t)(netif->hwaddr[2]) << 8) | + (0xff)); + ip_2_ip6(&netif->ip6_addr[0])->addr[3] = htonl((0xfeul << 24) | + ((u32_t)(netif->hwaddr[3]) << 16) | + ((u32_t)(netif->hwaddr[4]) << 8) | + (netif->hwaddr[5])); + } else { + /* Use hwaddr directly as interface ID. */ + ip_2_ip6(&netif->ip6_addr[0])->addr[2] = 0; + ip_2_ip6(&netif->ip6_addr[0])->addr[3] = 0; + + addr_index = 3; + for (i = 0; (i < 8) && (i < netif->hwaddr_len); i++) { + if (i == 4) { + addr_index--; + } + ip_2_ip6(&netif->ip6_addr[0])->addr[addr_index] |= ((u32_t)(netif->hwaddr[netif->hwaddr_len - i - 1])) << (8 * (i & 0x03)); + } + } + +#ifdef LWIP_ESP8266 + ip6_addr_set( ip_2_ip6(&netif->link_local_addr), ip_2_ip6(&netif->ip6_addr[0]) ); +#endif + + /* Set address state. */ +#if LWIP_IPV6_DUP_DETECT_ATTEMPTS + /* Will perform duplicate address detection (DAD). */ + netif->ip6_addr_state[0] = IP6_ADDR_TENTATIVE; +#else + /* Consider address valid. */ + netif->ip6_addr_state[0] = IP6_ADDR_PREFERRED; +#endif /* LWIP_IPV6_AUTOCONFIG */ +} + +/** This function allows for the easy addition of a new IPv6 address to an interface. + * It takes care of finding an empty slot and then sets the address tentative + * (to make sure that all the subsequent processing happens). + * + * @param netif netif to add the address on + * @param ip6addr address to add + * @param chosen_idx if != NULL, the chosen IPv6 address index will be stored here + */ +err_t +netif_add_ip6_address(struct netif *netif, const ip6_addr_t *ip6addr, s8_t *chosen_idx) +{ + s8_t i; + + i = netif_get_ip6_addr_match(netif, ip6addr); + if (i >= 0) { + /* Address already added */ + if (chosen_idx != NULL) { + *chosen_idx = i; + } + return ERR_OK; + } + + /* Find a free slot -- musn't be the first one (reserved for link local) */ + for (i = 1; i < LWIP_IPV6_NUM_ADDRESSES; i++) { + if (!ip6_addr_isvalid(netif->ip6_addr_state[i])) { + ip_addr_copy_from_ip6(netif->ip6_addr[i], *ip6addr); + netif_ip6_addr_set_state(netif, i, IP6_ADDR_TENTATIVE); + if (chosen_idx != NULL) { + *chosen_idx = i; + } + return ERR_OK; + } + } + + if (chosen_idx != NULL) { + *chosen_idx = -1; + } + return ERR_VAL; +} + + +#ifdef LWIP_ESP8266 +void +netif_create_ip4_linklocal_address(struct netif * netif) +{ +#if 1 + ip_addr_t linklocal; + ip_addr_t linklocal_mask; + ip4_addr_t addr = {0}; + /* Link-local prefix and mask. */ + IP4_ADDR(ip_2_ip4(&linklocal), 169, 254, 0, 0); + IP4_ADDR(ip_2_ip4(&linklocal_mask), 255, 255, 0, 0); + + if (!ip4_addr_netcmp( ip_2_ip4(&linklocal), ip_2_ip4(&netif->link_local_addr), ip_2_ip4(&linklocal_mask) ) && + !ip4_addr_isany(ip_2_ip4(&netif->ip_addr)) ) { + IP4_ADDR( ip_2_ip4(&netif->link_local_addr), 169, 254, ip4_addr3( ip_2_ip4(&netif->ip_addr) ) + , ip4_addr4( ip_2_ip4(&netif->ip_addr) ) ); + return; + } + + while ( !(addr.addr) || !ip4_addr4(&addr) ) + //os_get_random((unsigned char *)&addr, sizeof(addr)); + addr.addr = LWIP_RAND(); + + + if ( ip_2_ip4(&netif->netmask)->addr > IP_CLASSB_NET && + !ip4_addr_isany( ip_2_ip4(&netif->ip_addr) )) { // random host address + IP4_ADDR( ip_2_ip4(&netif->link_local_addr), 169, 254, ip4_addr3( ip_2_ip4(&netif->ip_addr)) + , ip4_addr4(&addr)); + } else { + IP4_ADDR( ip_2_ip4(&netif->link_local_addr), 169, 254, ip4_addr3(&addr), ip4_addr4(&addr) ); + } +#endif +} + +#endif + + +/** Dummy IPv6 output function for netifs not supporting IPv6 + */ +static err_t +netif_null_output_ip6(struct netif *netif, struct pbuf *p, const ip6_addr_t *ipaddr) +{ + LWIP_UNUSED_ARG(netif); + LWIP_UNUSED_ARG(p); + LWIP_UNUSED_ARG(ipaddr); + + return ERR_IF; +} +#endif /* LWIP_IPV6 */ diff --git a/components/lwip/core/pbuf.c b/components/lwip/core/pbuf.c new file mode 100755 index 000000000..e35f8a6b7 --- /dev/null +++ b/components/lwip/core/pbuf.c @@ -0,0 +1,1396 @@ +/** + * @file + * Packet buffer management + * + * Packets are built from the pbuf data structure. It supports dynamic + * memory allocation for packet contents or can reference externally + * managed packet contents both in RAM and ROM. Quick allocation for + * incoming packets is provided through pools with fixed sized pbufs. + * + * A packet may span over multiple pbufs, chained as a singly linked + * list. This is called a "pbuf chain". + * + * Multiple packets may be queued, also using this singly linked list. + * This is called a "packet queue". + * + * So, a packet queue consists of one or more pbuf chains, each of + * which consist of one or more pbufs. CURRENTLY, PACKET QUEUES ARE + * NOT SUPPORTED!!! Use helper structs to queue multiple packets. + * + * The differences between a pbuf chain and a packet queue are very + * precise but subtle. + * + * The last pbuf of a packet has a ->tot_len field that equals the + * ->len field. It can be found by traversing the list. If the last + * pbuf of a packet has a ->next field other than NULL, more packets + * are on the queue. + * + * Therefore, looping through a pbuf of a single packet, has an + * loop end condition (tot_len == p->len), NOT (next == NULL). + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/stats.h" +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/pbuf.h" +#include "lwip/sys.h" +#if LWIP_TCP && TCP_QUEUE_OOSEQ +#include "lwip/priv/tcp_priv.h" +#endif +#if LWIP_CHECKSUM_ON_COPY +#include "lwip/inet_chksum.h" +#endif + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#ifdef LWIP_ESP8266 +#define EP_OFFSET 0 +#endif + +#define SIZEOF_STRUCT_PBUF LWIP_MEM_ALIGN_SIZE(sizeof(struct pbuf)) +/* Since the pool is created in memp, PBUF_POOL_BUFSIZE will be automatically + aligned there. Therefore, PBUF_POOL_BUFSIZE_ALIGNED can be used here. */ +#define PBUF_POOL_BUFSIZE_ALIGNED LWIP_MEM_ALIGN_SIZE(PBUF_POOL_BUFSIZE) + +#if !LWIP_TCP || !TCP_QUEUE_OOSEQ || !PBUF_POOL_FREE_OOSEQ +#define PBUF_POOL_IS_EMPTY() +#else /* !LWIP_TCP || !TCP_QUEUE_OOSEQ || !PBUF_POOL_FREE_OOSEQ */ + +#if !NO_SYS +#ifndef PBUF_POOL_FREE_OOSEQ_QUEUE_CALL +#include "lwip/tcpip.h" +#define PBUF_POOL_FREE_OOSEQ_QUEUE_CALL() do { \ + if (tcpip_callback_with_block(pbuf_free_ooseq_callback, NULL, 0) != ERR_OK) { \ + SYS_ARCH_PROTECT(old_level); \ + pbuf_free_ooseq_pending = 0; \ + SYS_ARCH_UNPROTECT(old_level); \ + } } while(0) +#endif /* PBUF_POOL_FREE_OOSEQ_QUEUE_CALL */ +#endif /* !NO_SYS */ + +volatile u8_t pbuf_free_ooseq_pending; +#define PBUF_POOL_IS_EMPTY() pbuf_pool_is_empty() + +/** + * Attempt to reclaim some memory from queued out-of-sequence TCP segments + * if we run out of pool pbufs. It's better to give priority to new packets + * if we're running out. + * + * This must be done in the correct thread context therefore this function + * can only be used with NO_SYS=0 and through tcpip_callback. + */ +#if !NO_SYS +static +#endif /* !NO_SYS */ +void +pbuf_free_ooseq(void) +{ + struct tcp_pcb* pcb; + SYS_ARCH_SET(pbuf_free_ooseq_pending, 0); + + for (pcb = tcp_active_pcbs; NULL != pcb; pcb = pcb->next) { + if (NULL != pcb->ooseq) { + /** Free the ooseq pbufs of one PCB only */ + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_free_ooseq: freeing out-of-sequence pbufs\n")); + tcp_segs_free(pcb->ooseq); + pcb->ooseq = NULL; + return; + } + } +} + +#if !NO_SYS +/** + * Just a callback function for tcpip_callback() that calls pbuf_free_ooseq(). + */ +static void +pbuf_free_ooseq_callback(void *arg) +{ + LWIP_UNUSED_ARG(arg); + pbuf_free_ooseq(); +} +#endif /* !NO_SYS */ + +/** Queue a call to pbuf_free_ooseq if not already queued. */ +static void +pbuf_pool_is_empty(void) +{ +#ifndef PBUF_POOL_FREE_OOSEQ_QUEUE_CALL + SYS_ARCH_SET(pbuf_free_ooseq_pending, 1); +#else /* PBUF_POOL_FREE_OOSEQ_QUEUE_CALL */ + u8_t queued; + SYS_ARCH_DECL_PROTECT(old_level); + SYS_ARCH_PROTECT(old_level); + queued = pbuf_free_ooseq_pending; + pbuf_free_ooseq_pending = 1; + SYS_ARCH_UNPROTECT(old_level); + + if (!queued) { + /* queue a call to pbuf_free_ooseq if not already queued */ + PBUF_POOL_FREE_OOSEQ_QUEUE_CALL(); + } +#endif /* PBUF_POOL_FREE_OOSEQ_QUEUE_CALL */ +} +#endif /* !LWIP_TCP || !TCP_QUEUE_OOSEQ || !PBUF_POOL_FREE_OOSEQ */ + +/** + * Allocates a pbuf of the given type (possibly a chain for PBUF_POOL type). + * + * The actual memory allocated for the pbuf is determined by the + * layer at which the pbuf is allocated and the requested size + * (from the size parameter). + * + * @param layer flag to define header size + * @param length size of the pbuf's payload + * @param type this parameter decides how and where the pbuf + * should be allocated as follows: + * + * - PBUF_RAM: buffer memory for pbuf is allocated as one large + * chunk. This includes protocol headers as well. + * - PBUF_ROM: no buffer memory is allocated for the pbuf, even for + * protocol headers. Additional headers must be prepended + * by allocating another pbuf and chain in to the front of + * the ROM pbuf. It is assumed that the memory used is really + * similar to ROM in that it is immutable and will not be + * changed. Memory which is dynamic should generally not + * be attached to PBUF_ROM pbufs. Use PBUF_REF instead. + * - PBUF_REF: no buffer memory is allocated for the pbuf, even for + * protocol headers. It is assumed that the pbuf is only + * being used in a single thread. If the pbuf gets queued, + * then pbuf_take should be called to copy the buffer. + * - PBUF_POOL: the pbuf is allocated as a pbuf chain, with pbufs from + * the pbuf pool that is allocated during pbuf_init(). + * + * @return the allocated pbuf. If multiple pbufs where allocated, this + * is the first pbuf of a pbuf chain. + */ +struct pbuf * +pbuf_alloc(pbuf_layer layer, u16_t length, pbuf_type type) +{ + struct pbuf *p, *q, *r; + +#ifdef LWIP_ESP8266 + u16_t offset = 0; +#else + u16_t offset; +#endif + + s32_t rem_len; /* remaining length */ + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_alloc(length=%"U16_F")\n", length)); + + /* determine header offset */ + switch (layer) { + case PBUF_TRANSPORT: + /* add room for transport (often TCP) layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN + PBUF_TRANSPORT_HLEN; + +#ifdef LWIP_ESP8266 //TO_DO + offset += EP_OFFSET; +#endif + + break; + case PBUF_IP: + /* add room for IP layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN; + +#ifdef LWIP_ESP8266 //TO_DO + offset += EP_OFFSET; +#endif + + break; + case PBUF_LINK: + /* add room for link layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN; + +#ifdef LWIP_ESP8266 //TO_DO + /* + * 1. LINK_HLEN 14Byte will be remove in WLAN layer + * 2. IEEE80211_HDR_MAX_LEN needs 40 bytes. + * 3. encryption needs exra 4 bytes ahead of actual data payload, and require + * DAddr and SAddr to be 4-byte aligned. + * 4. TRANSPORT and IP are all 20, 4 bytes aligned, nice... + * 5. LCC add 6 bytes more, We don't consider WAPI yet... + * 6. define LWIP_MEM_ALIGN to be 4 Byte aligned, pbuf struct is 16B, Only thing may be + * matter is ether_hdr is not 4B aligned. + * + * So, we need extra (40 + 4 - 14) = 30 and it's happen to be 4-Byte aligned + * + * 1. lwip + * | empty 30B | eth_hdr (14B) | payload ...| + * total: 44B ahead payload + * 2. net80211 + * | max 80211 hdr, 32B | ccmp/tkip iv (8B) | sec rsv(4B) | payload ...| + * total: 40B ahead sec_rsv and 44B ahead payload + * + */ + offset += EP_OFFSET; //remove LINK hdr in wlan +#endif + + break; + case PBUF_RAW_TX: + /* add room for encapsulating link layer headers (e.g. 802.11) */ + offset = PBUF_LINK_ENCAPSULATION_HLEN; + break; + case PBUF_RAW: + offset = 0; + +#ifdef LWIP_ESP8266 //TO_DO + offset += EP_OFFSET; +#endif + + break; + default: + LWIP_ASSERT("pbuf_alloc: bad pbuf layer", 0); + return NULL; + } + + switch (type) { + case PBUF_POOL: + /* allocate head of pbuf chain into p */ + p = (struct pbuf *)memp_malloc(MEMP_PBUF_POOL); + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_alloc: allocated pbuf %p\n", (void *)p)); + if (p == NULL) { + PBUF_POOL_IS_EMPTY(); + return NULL; + } + p->type = type; + p->next = NULL; + + /* make the payload pointer point 'offset' bytes into pbuf data memory */ + p->payload = LWIP_MEM_ALIGN((void *)((u8_t *)p + (SIZEOF_STRUCT_PBUF + offset))); + LWIP_ASSERT("pbuf_alloc: pbuf p->payload properly aligned", + ((mem_ptr_t)p->payload % MEM_ALIGNMENT) == 0); + /* the total length of the pbuf chain is the requested size */ + p->tot_len = length; + /* set the length of the first pbuf in the chain */ + p->len = LWIP_MIN(length, PBUF_POOL_BUFSIZE_ALIGNED - LWIP_MEM_ALIGN_SIZE(offset)); + LWIP_ASSERT("check p->payload + p->len does not overflow pbuf", + ((u8_t*)p->payload + p->len <= + (u8_t*)p + SIZEOF_STRUCT_PBUF + PBUF_POOL_BUFSIZE_ALIGNED)); + LWIP_ASSERT("PBUF_POOL_BUFSIZE must be bigger than MEM_ALIGNMENT", + (PBUF_POOL_BUFSIZE_ALIGNED - LWIP_MEM_ALIGN_SIZE(offset)) > 0 ); + /* set reference count (needed here in case we fail) */ + p->ref = 1; + + /* now allocate the tail of the pbuf chain */ + + /* remember first pbuf for linkage in next iteration */ + r = p; + /* remaining length to be allocated */ + rem_len = length - p->len; + /* any remaining pbufs to be allocated? */ + while (rem_len > 0) { + q = (struct pbuf *)memp_malloc(MEMP_PBUF_POOL); + if (q == NULL) { + PBUF_POOL_IS_EMPTY(); + /* free chain so far allocated */ + pbuf_free(p); + /* bail out unsuccessfully */ + return NULL; + } + q->type = type; + q->flags = 0; + q->next = NULL; + /* make previous pbuf point to this pbuf */ + r->next = q; + /* set total length of this pbuf and next in chain */ + LWIP_ASSERT("rem_len < max_u16_t", rem_len < 0xffff); + q->tot_len = (u16_t)rem_len; + /* this pbuf length is pool size, unless smaller sized tail */ + q->len = LWIP_MIN((u16_t)rem_len, PBUF_POOL_BUFSIZE_ALIGNED); + q->payload = (void *)((u8_t *)q + SIZEOF_STRUCT_PBUF); + LWIP_ASSERT("pbuf_alloc: pbuf q->payload properly aligned", + ((mem_ptr_t)q->payload % MEM_ALIGNMENT) == 0); + LWIP_ASSERT("check p->payload + p->len does not overflow pbuf", + ((u8_t*)p->payload + p->len <= + (u8_t*)p + SIZEOF_STRUCT_PBUF + PBUF_POOL_BUFSIZE_ALIGNED)); + q->ref = 1; + /* calculate remaining length to be allocated */ + rem_len -= q->len; + /* remember this pbuf for linkage in next iteration */ + r = q; + } + /* end of chain */ + /*r->next = NULL;*/ + + break; + case PBUF_RAM: + /* If pbuf is to be allocated in RAM, allocate memory for it. */ + p = (struct pbuf*)mem_malloc(LWIP_MEM_ALIGN_SIZE(SIZEOF_STRUCT_PBUF + offset) + LWIP_MEM_ALIGN_SIZE(length)); + if (p == NULL) { + return NULL; + } + /* Set up internal structure of the pbuf. */ + p->payload = LWIP_MEM_ALIGN((void *)((u8_t *)p + SIZEOF_STRUCT_PBUF + offset)); + p->len = p->tot_len = length; + p->next = NULL; + p->type = type; + + LWIP_ASSERT("pbuf_alloc: pbuf->payload properly aligned", + ((mem_ptr_t)p->payload % MEM_ALIGNMENT) == 0); + break; + /* pbuf references existing (non-volatile static constant) ROM payload? */ + case PBUF_ROM: + /* pbuf references existing (externally allocated) RAM payload? */ + case PBUF_REF: + /* only allocate memory for the pbuf structure */ + p = (struct pbuf *)memp_malloc(MEMP_PBUF); + if (p == NULL) { + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("pbuf_alloc: Could not allocate MEMP_PBUF for PBUF_%s.\n", + (type == PBUF_ROM) ? "ROM" : "REF")); + return NULL; + } + /* caller must set this field properly, afterwards */ + p->payload = NULL; + p->len = p->tot_len = length; + p->next = NULL; + p->type = type; + break; + default: + LWIP_ASSERT("pbuf_alloc: erroneous type", 0); + return NULL; + } + /* set reference count */ + p->ref = 1; + /* set flags */ + p->flags = 0; + +#ifdef LWIP_ESP8266 + p->eb = NULL; +#endif + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_alloc(length=%"U16_F") == %p\n", length, (void *)p)); + return p; +} + +#if LWIP_SUPPORT_CUSTOM_PBUF +/** Initialize a custom pbuf (already allocated). + * + * @param layer flag to define header size + * @param length size of the pbuf's payload + * @param type type of the pbuf (only used to treat the pbuf accordingly, as + * this function allocates no memory) + * @param p pointer to the custom pbuf to initialize (already allocated) + * @param payload_mem pointer to the buffer that is used for payload and headers, + * must be at least big enough to hold 'length' plus the header size, + * may be NULL if set later. + * ATTENTION: The caller is responsible for correct alignment of this buffer!! + * @param payload_mem_len the size of the 'payload_mem' buffer, must be at least + * big enough to hold 'length' plus the header size + */ +struct pbuf* +pbuf_alloced_custom(pbuf_layer l, u16_t length, pbuf_type type, struct pbuf_custom *p, + void *payload_mem, u16_t payload_mem_len) +{ + u16_t offset; + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_alloced_custom(length=%"U16_F")\n", length)); + + /* determine header offset */ + switch (l) { + case PBUF_TRANSPORT: + /* add room for transport (often TCP) layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN + PBUF_TRANSPORT_HLEN; + break; + case PBUF_IP: + /* add room for IP layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN + PBUF_IP_HLEN; + break; + case PBUF_LINK: + /* add room for link layer header */ + offset = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN; + break; + case PBUF_RAW_TX: + /* add room for encapsulating link layer headers (e.g. 802.11) */ + offset = PBUF_LINK_ENCAPSULATION_HLEN; + break; + case PBUF_RAW: + offset = 0; + break; + default: + LWIP_ASSERT("pbuf_alloced_custom: bad pbuf layer", 0); + return NULL; + } + + if (LWIP_MEM_ALIGN_SIZE(offset) + length > payload_mem_len) { + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_LEVEL_WARNING, ("pbuf_alloced_custom(length=%"U16_F") buffer too short\n", length)); + return NULL; + } + + p->pbuf.next = NULL; + if (payload_mem != NULL) { + p->pbuf.payload = (u8_t *)payload_mem + LWIP_MEM_ALIGN_SIZE(offset); + } else { + p->pbuf.payload = NULL; + } + p->pbuf.flags = PBUF_FLAG_IS_CUSTOM; + p->pbuf.len = p->pbuf.tot_len = length; + p->pbuf.type = type; + p->pbuf.ref = 1; + return &p->pbuf; +} +#endif /* LWIP_SUPPORT_CUSTOM_PBUF */ + +/** + * Shrink a pbuf chain to a desired length. + * + * @param p pbuf to shrink. + * @param new_len desired new length of pbuf chain + * + * Depending on the desired length, the first few pbufs in a chain might + * be skipped and left unchanged. The new last pbuf in the chain will be + * resized, and any remaining pbufs will be freed. + * + * @note If the pbuf is ROM/REF, only the ->tot_len and ->len fields are adjusted. + * @note May not be called on a packet queue. + * + * @note Despite its name, pbuf_realloc cannot grow the size of a pbuf (chain). + */ +void +pbuf_realloc(struct pbuf *p, u16_t new_len) +{ + struct pbuf *q; + u16_t rem_len; /* remaining length */ + s32_t grow; + + LWIP_ASSERT("pbuf_realloc: p != NULL", p != NULL); + LWIP_ASSERT("pbuf_realloc: sane p->type", p->type == PBUF_POOL || + p->type == PBUF_ROM || + p->type == PBUF_RAM || + p->type == PBUF_REF); + + /* desired length larger than current length? */ + if (new_len >= p->tot_len) { + /* enlarging not yet supported */ + return; + } + + /* the pbuf chain grows by (new_len - p->tot_len) bytes + * (which may be negative in case of shrinking) */ + grow = new_len - p->tot_len; + + /* first, step over any pbufs that should remain in the chain */ + rem_len = new_len; + q = p; + /* should this pbuf be kept? */ + while (rem_len > q->len) { + /* decrease remaining length by pbuf length */ + rem_len -= q->len; + /* decrease total length indicator */ + LWIP_ASSERT("grow < max_u16_t", grow < 0xffff); + q->tot_len += (u16_t)grow; + /* proceed to next pbuf in chain */ + q = q->next; + LWIP_ASSERT("pbuf_realloc: q != NULL", q != NULL); + } + /* we have now reached the new last pbuf (in q) */ + /* rem_len == desired length for pbuf q */ + + /* shrink allocated memory for PBUF_RAM */ + /* (other types merely adjust their length fields */ + if ((q->type == PBUF_RAM) && (rem_len != q->len) +#if LWIP_SUPPORT_CUSTOM_PBUF + && ((q->flags & PBUF_FLAG_IS_CUSTOM) == 0) +#endif /* LWIP_SUPPORT_CUSTOM_PBUF */ + ) { + /* reallocate and adjust the length of the pbuf that will be split */ + q = (struct pbuf *)mem_trim(q, (u16_t)((u8_t *)q->payload - (u8_t *)q) + rem_len); + LWIP_ASSERT("mem_trim returned q == NULL", q != NULL); + } + /* adjust length fields for new last pbuf */ + q->len = rem_len; + q->tot_len = q->len; + + /* any remaining pbufs in chain? */ + if (q->next != NULL) { + /* free remaining pbufs in chain */ + pbuf_free(q->next); + } + /* q is last packet in chain */ + q->next = NULL; + +} + +/** + * Adjusts the payload pointer to hide or reveal headers in the payload. + * @see pbuf_header. + * + * @param p pbuf to change the header size. + * @param header_size_increment Number of bytes to increment header size. + * @param force Allow 'header_size_increment > 0' for PBUF_REF/PBUF_ROM types + * + * @return non-zero on failure, zero on success. + * + */ +static u8_t +pbuf_header_impl(struct pbuf *p, s16_t header_size_increment, u8_t force) +{ + u16_t type; + void *payload; + u16_t increment_magnitude; + + LWIP_ASSERT("p != NULL", p != NULL); + if ((header_size_increment == 0) || (p == NULL)) { + return 0; + } + + if (header_size_increment < 0) { + increment_magnitude = -header_size_increment; + /* Check that we aren't going to move off the end of the pbuf */ + LWIP_ERROR("increment_magnitude <= p->len", (increment_magnitude <= p->len), return 1;); + } else { + increment_magnitude = header_size_increment; +#if 0 + /* Can't assert these as some callers speculatively call + pbuf_header() to see if it's OK. Will return 1 below instead. */ + /* Check that we've got the correct type of pbuf to work with */ + LWIP_ASSERT("p->type == PBUF_RAM || p->type == PBUF_POOL", + p->type == PBUF_RAM || p->type == PBUF_POOL); + /* Check that we aren't going to move off the beginning of the pbuf */ + LWIP_ASSERT("p->payload - increment_magnitude >= p + SIZEOF_STRUCT_PBUF", + (u8_t *)p->payload - increment_magnitude >= (u8_t *)p + SIZEOF_STRUCT_PBUF); +#endif + } + + type = p->type; + /* remember current payload pointer */ + payload = p->payload; + + /* pbuf types containing payloads? */ + if (type == PBUF_RAM || type == PBUF_POOL) { + /* set new payload pointer */ + p->payload = (u8_t *)p->payload - header_size_increment; + /* boundary check fails? */ + if ((u8_t *)p->payload < (u8_t *)p + SIZEOF_STRUCT_PBUF) { + LWIP_DEBUGF( PBUF_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("pbuf_header: failed as %p < %p (not enough space for new header size)\n", + (void *)p->payload, (void *)(p + 1))); + /* restore old payload pointer */ + p->payload = payload; + /* bail out unsuccessfully */ + return 1; + } + /* pbuf types referring to external payloads? */ + } else if (type == PBUF_REF || type == PBUF_ROM) { + /* hide a header in the payload? */ + if ((header_size_increment < 0) && (increment_magnitude <= p->len)) { + /* increase payload pointer */ + p->payload = (u8_t *)p->payload - header_size_increment; + } else if ((header_size_increment > 0) && force) { + p->payload = (u8_t *)p->payload - header_size_increment; + } else { + /* cannot expand payload to front (yet!) + * bail out unsuccessfully */ + return 1; + } + } else { + /* Unknown type */ + LWIP_ASSERT("bad pbuf type", 0); + return 1; + } + /* modify pbuf length fields */ + p->len += header_size_increment; + p->tot_len += header_size_increment; + + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_header: old %p new %p (%"S16_F")\n", + (void *)payload, (void *)p->payload, header_size_increment)); + + return 0; +} + +/** + * Adjusts the payload pointer to hide or reveal headers in the payload. + * + * Adjusts the ->payload pointer so that space for a header + * (dis)appears in the pbuf payload. + * + * The ->payload, ->tot_len and ->len fields are adjusted. + * + * @param p pbuf to change the header size. + * @param header_size_increment Number of bytes to increment header size which + * increases the size of the pbuf. New space is on the front. + * (Using a negative value decreases the header size.) + * If hdr_size_inc is 0, this function does nothing and returns successful. + * + * PBUF_ROM and PBUF_REF type buffers cannot have their sizes increased, so + * the call will fail. A check is made that the increase in header size does + * not move the payload pointer in front of the start of the buffer. + * @return non-zero on failure, zero on success. + * + */ +u8_t +pbuf_header(struct pbuf *p, s16_t header_size_increment) +{ + return pbuf_header_impl(p, header_size_increment, 0); +} + +/** + * Same as pbuf_header but does not check if 'header_size > 0' is allowed. + * This is used internally only, to allow PBUF_REF for RX. + */ +u8_t +pbuf_header_force(struct pbuf *p, s16_t header_size_increment) +{ + return pbuf_header_impl(p, header_size_increment, 1); +} + +/** + * Dereference a pbuf chain or queue and deallocate any no-longer-used + * pbufs at the head of this chain or queue. + * + * Decrements the pbuf reference count. If it reaches zero, the pbuf is + * deallocated. + * + * For a pbuf chain, this is repeated for each pbuf in the chain, + * up to the first pbuf which has a non-zero reference count after + * decrementing. So, when all reference counts are one, the whole + * chain is free'd. + * + * @param p The pbuf (chain) to be dereferenced. + * + * @return the number of pbufs that were de-allocated + * from the head of the chain. + * + * @note MUST NOT be called on a packet queue (Not verified to work yet). + * @note the reference counter of a pbuf equals the number of pointers + * that refer to the pbuf (or into the pbuf). + * + * @internal examples: + * + * Assuming existing chains a->b->c with the following reference + * counts, calling pbuf_free(a) results in: + * + * 1->2->3 becomes ...1->3 + * 3->3->3 becomes 2->3->3 + * 1->1->2 becomes ......1 + * 2->1->1 becomes 1->1->1 + * 1->1->1 becomes ....... + * + */ +u8_t +pbuf_free(struct pbuf *p) +{ + u16_t type; + struct pbuf *q; + u8_t count; + + if (p == NULL) { + LWIP_ASSERT("p != NULL", p != NULL); + /* if assertions are disabled, proceed with debug output */ + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("pbuf_free(p == NULL) was called.\n")); + return 0; + } + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_free(%p)\n", (void *)p)); + + PERF_START; + + LWIP_ASSERT("pbuf_free: sane type", + p->type == PBUF_RAM || p->type == PBUF_ROM || + p->type == PBUF_REF || p->type == PBUF_POOL); + + count = 0; + /* de-allocate all consecutive pbufs from the head of the chain that + * obtain a zero reference count after decrementing*/ + while (p != NULL) { + u16_t ref; + SYS_ARCH_DECL_PROTECT(old_level); + /* Since decrementing ref cannot be guaranteed to be a single machine operation + * we must protect it. We put the new ref into a local variable to prevent + * further protection. */ + SYS_ARCH_PROTECT(old_level); + /* all pbufs in a chain are referenced at least once */ + LWIP_ASSERT("pbuf_free: p->ref > 0", p->ref > 0); + /* decrease reference count (number of pointers to pbuf) */ + ref = --(p->ref); + SYS_ARCH_UNPROTECT(old_level); + /* this pbuf is no longer referenced to? */ + if (ref == 0) { + /* remember next pbuf in chain for next iteration */ + q = p->next; + LWIP_DEBUGF( PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_free: deallocating %p\n", (void *)p)); + type = p->type; +#if LWIP_SUPPORT_CUSTOM_PBUF + /* is this a custom pbuf? */ + if ((p->flags & PBUF_FLAG_IS_CUSTOM) != 0) { + struct pbuf_custom *pc = (struct pbuf_custom*)p; + LWIP_ASSERT("pc->custom_free_function != NULL", pc->custom_free_function != NULL); + pc->custom_free_function(p); + } else +#endif /* LWIP_SUPPORT_CUSTOM_PBUF */ + { + /* is this a pbuf from the pool? */ + if (type == PBUF_POOL) { + memp_free(MEMP_PBUF_POOL, p); + /* is this a ROM or RAM referencing pbuf? */ + } else if (type == PBUF_ROM || type == PBUF_REF) { + +#ifdef LWIP_ESP8266 + extern void system_pp_recycle_rx_pkt(void*); + if (type == PBUF_REF && p->eb != NULL ) system_pp_recycle_rx_pkt(p->eb); +#endif + + memp_free(MEMP_PBUF, p); + /* type == PBUF_RAM */ + } else { + mem_free(p); + } + } + count++; + /* proceed to next pbuf */ + p = q; + /* p->ref > 0, this pbuf is still referenced to */ + /* (and so the remaining pbufs in chain as well) */ + } else { + LWIP_DEBUGF( PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_free: %p has ref %"U16_F", ending here.\n", (void *)p, ref)); + /* stop walking through the chain */ + p = NULL; + } + } + PERF_STOP("pbuf_free"); + /* return number of de-allocated pbufs */ + return count; +} + +/** + * Count number of pbufs in a chain + * + * @param p first pbuf of chain + * @return the number of pbufs in a chain + */ + +u8_t +pbuf_clen(struct pbuf *p) +{ + u8_t len; + + len = 0; + while (p != NULL) { + ++len; + p = p->next; + } + return len; +} + +/** + * Increment the reference count of the pbuf. + * + * @param p pbuf to increase reference counter of + * + */ +void +pbuf_ref(struct pbuf *p) +{ + SYS_ARCH_DECL_PROTECT(old_level); + /* pbuf given? */ + if (p != NULL) { + SYS_ARCH_PROTECT(old_level); + ++(p->ref); + SYS_ARCH_UNPROTECT(old_level); + } +} + +/** + * Concatenate two pbufs (each may be a pbuf chain) and take over + * the caller's reference of the tail pbuf. + * + * @note The caller MAY NOT reference the tail pbuf afterwards. + * Use pbuf_chain() for that purpose. + * + * @see pbuf_chain() + */ + +void +pbuf_cat(struct pbuf *h, struct pbuf *t) +{ + struct pbuf *p; + + LWIP_ERROR("(h != NULL) && (t != NULL) (programmer violates API)", + ((h != NULL) && (t != NULL)), return;); + + /* proceed to last pbuf of chain */ + for (p = h; p->next != NULL; p = p->next) { + /* add total length of second chain to all totals of first chain */ + p->tot_len += t->tot_len; + } + /* { p is last pbuf of first h chain, p->next == NULL } */ + LWIP_ASSERT("p->tot_len == p->len (of last pbuf in chain)", p->tot_len == p->len); + LWIP_ASSERT("p->next == NULL", p->next == NULL); + /* add total length of second chain to last pbuf total of first chain */ + p->tot_len += t->tot_len; + /* chain last pbuf of head (p) with first of tail (t) */ + p->next = t; + /* p->next now references t, but the caller will drop its reference to t, + * so netto there is no change to the reference count of t. + */ +} + +/** + * Chain two pbufs (or pbuf chains) together. + * + * The caller MUST call pbuf_free(t) once it has stopped + * using it. Use pbuf_cat() instead if you no longer use t. + * + * @param h head pbuf (chain) + * @param t tail pbuf (chain) + * @note The pbufs MUST belong to the same packet. + * @note MAY NOT be called on a packet queue. + * + * The ->tot_len fields of all pbufs of the head chain are adjusted. + * The ->next field of the last pbuf of the head chain is adjusted. + * The ->ref field of the first pbuf of the tail chain is adjusted. + * + */ +void +pbuf_chain(struct pbuf *h, struct pbuf *t) +{ + pbuf_cat(h, t); + /* t is now referenced by h */ + pbuf_ref(t); + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_chain: %p references %p\n", (void *)h, (void *)t)); +} + +/** + * Dechains the first pbuf from its succeeding pbufs in the chain. + * + * Makes p->tot_len field equal to p->len. + * @param p pbuf to dechain + * @return remainder of the pbuf chain, or NULL if it was de-allocated. + * @note May not be called on a packet queue. + */ +struct pbuf * +pbuf_dechain(struct pbuf *p) +{ + struct pbuf *q; + u8_t tail_gone = 1; + /* tail */ + q = p->next; + /* pbuf has successor in chain? */ + if (q != NULL) { + /* assert tot_len invariant: (p->tot_len == p->len + (p->next? p->next->tot_len: 0) */ + LWIP_ASSERT("p->tot_len == p->len + q->tot_len", q->tot_len == p->tot_len - p->len); + /* enforce invariant if assertion is disabled */ + q->tot_len = p->tot_len - p->len; + /* decouple pbuf from remainder */ + p->next = NULL; + /* total length of pbuf p is its own length only */ + p->tot_len = p->len; + /* q is no longer referenced by p, free it */ + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_dechain: unreferencing %p\n", (void *)q)); + tail_gone = pbuf_free(q); + if (tail_gone > 0) { + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, + ("pbuf_dechain: deallocated %p (as it is no longer referenced)\n", (void *)q)); + } + /* return remaining tail or NULL if deallocated */ + } + /* assert tot_len invariant: (p->tot_len == p->len + (p->next? p->next->tot_len: 0) */ + LWIP_ASSERT("p->tot_len == p->len", p->tot_len == p->len); + return ((tail_gone > 0) ? NULL : q); +} + +/** + * + * Create PBUF_RAM copies of pbufs. + * + * Used to queue packets on behalf of the lwIP stack, such as + * ARP based queueing. + * + * @note You MUST explicitly use p = pbuf_take(p); + * + * @note Only one packet is copied, no packet queue! + * + * @param p_to pbuf destination of the copy + * @param p_from pbuf source of the copy + * + * @return ERR_OK if pbuf was copied + * ERR_ARG if one of the pbufs is NULL or p_to is not big + * enough to hold p_from + */ +err_t +pbuf_copy(struct pbuf *p_to, struct pbuf *p_from) +{ + u16_t offset_to=0, offset_from=0, len; + + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_copy(%p, %p)\n", + (void*)p_to, (void*)p_from)); + + /* is the target big enough to hold the source? */ + LWIP_ERROR("pbuf_copy: target not big enough to hold source", ((p_to != NULL) && + (p_from != NULL) && (p_to->tot_len >= p_from->tot_len)), return ERR_ARG;); + + /* iterate through pbuf chain */ + do + { + /* copy one part of the original chain */ + if ((p_to->len - offset_to) >= (p_from->len - offset_from)) { + /* complete current p_from fits into current p_to */ + len = p_from->len - offset_from; + } else { + /* current p_from does not fit into current p_to */ + len = p_to->len - offset_to; + } + MEMCPY((u8_t*)p_to->payload + offset_to, (u8_t*)p_from->payload + offset_from, len); + offset_to += len; + offset_from += len; + LWIP_ASSERT("offset_to <= p_to->len", offset_to <= p_to->len); + LWIP_ASSERT("offset_from <= p_from->len", offset_from <= p_from->len); + if (offset_from >= p_from->len) { + /* on to next p_from (if any) */ + offset_from = 0; + p_from = p_from->next; + } + if (offset_to == p_to->len) { + /* on to next p_to (if any) */ + offset_to = 0; + p_to = p_to->next; + LWIP_ERROR("p_to != NULL", (p_to != NULL) || (p_from == NULL) , return ERR_ARG;); + } + + if ((p_from != NULL) && (p_from->len == p_from->tot_len)) { + /* don't copy more than one packet! */ + LWIP_ERROR("pbuf_copy() does not allow packet queues!", + (p_from->next == NULL), return ERR_VAL;); + } + if ((p_to != NULL) && (p_to->len == p_to->tot_len)) { + /* don't copy more than one packet! */ + LWIP_ERROR("pbuf_copy() does not allow packet queues!", + (p_to->next == NULL), return ERR_VAL;); + } + } while (p_from); + LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_copy: end of chain reached.\n")); + return ERR_OK; +} + +/** + * Copy (part of) the contents of a packet buffer + * to an application supplied buffer. + * + * @param buf the pbuf from which to copy data + * @param dataptr the application supplied buffer + * @param len length of data to copy (dataptr must be big enough). No more + * than buf->tot_len will be copied, irrespective of len + * @param offset offset into the packet buffer from where to begin copying len bytes + * @return the number of bytes copied, or 0 on failure + */ +u16_t +pbuf_copy_partial(struct pbuf *buf, void *dataptr, u16_t len, u16_t offset) +{ + struct pbuf *p; + u16_t left; + u16_t buf_copy_len; + u16_t copied_total = 0; + + LWIP_ERROR("pbuf_copy_partial: invalid buf", (buf != NULL), return 0;); + LWIP_ERROR("pbuf_copy_partial: invalid dataptr", (dataptr != NULL), return 0;); + + left = 0; + + if ((buf == NULL) || (dataptr == NULL)) { + return 0; + } + + /* Note some systems use byte copy if dataptr or one of the pbuf payload pointers are unaligned. */ + for (p = buf; len != 0 && p != NULL; p = p->next) { + if ((offset != 0) && (offset >= p->len)) { + /* don't copy from this buffer -> on to the next */ + offset -= p->len; + } else { + /* copy from this buffer. maybe only partially. */ + buf_copy_len = p->len - offset; + if (buf_copy_len > len) + buf_copy_len = len; + /* copy the necessary parts of the buffer */ + MEMCPY(&((char*)dataptr)[left], &((char*)p->payload)[offset], buf_copy_len); + copied_total += buf_copy_len; + left += buf_copy_len; + len -= buf_copy_len; + offset = 0; + } + } + return copied_total; +} + +#if LWIP_TCP && TCP_QUEUE_OOSEQ && LWIP_WND_SCALE +/** + * This method modifies a 'pbuf chain', so that its total length is + * smaller than 64K. The remainder of the original pbuf chain is stored + * in *rest. + * This function never creates new pbufs, but splits an existing chain + * in two parts. The tot_len of the modified packet queue will likely be + * smaller than 64K. + * 'packet queues' are not supported by this function. + * + * @param p the pbuf queue to be split + * @param rest pointer to store the remainder (after the first 64K) + */ +void pbuf_split_64k(struct pbuf *p, struct pbuf **rest) +{ + *rest = NULL; + if ((p != NULL) && (p->next != NULL)) { + u16_t tot_len_front = p->len; + struct pbuf *i = p; + struct pbuf *r = p->next; + + /* continue until the total length (summed up as u16_t) overflows */ + while ((r != NULL) && ((u16_t)(tot_len_front + r->len) > tot_len_front)) { + tot_len_front += r->len; + i = r; + r = r->next; + } + /* i now points to last packet of the first segment. Set next + pointer to NULL */ + i->next = NULL; + + if (r != NULL) { + /* Update the tot_len field in the first part */ + for (i = p; i != NULL; i = i->next) { + i->tot_len -= r->tot_len; + LWIP_ASSERT("tot_len/len mismatch in last pbuf", + (i->next != NULL) || (i->tot_len == i->len)); + } + if (p->flags & PBUF_FLAG_TCP_FIN) { + r->flags |= PBUF_FLAG_TCP_FIN; + } + + /* tot_len field in rest does not need modifications */ + /* reference counters do not need modifications */ + *rest = r; + } + } +} +#endif /* LWIP_TCP && TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + +/** + * Skip a number of bytes at the start of a pbuf + * + * @param in input pbuf + * @param in_offset offset to skip + * @param out_offset resulting offset in the returned pbuf + * @return the pbuf in the queue where the offset is + */ +struct pbuf* +pbuf_skip(struct pbuf* in, u16_t in_offset, u16_t* out_offset) +{ + u16_t offset_left = in_offset; + struct pbuf* q = in; + + /* get the correct pbuf */ + while ((q != NULL) && (q->len <= offset_left)) { + offset_left -= q->len; + q = q->next; + } + if (out_offset != NULL) { + *out_offset = offset_left; + } + return q; +} + +/** + * Copy application supplied data into a pbuf. + * This function can only be used to copy the equivalent of buf->tot_len data. + * + * @param buf pbuf to fill with data + * @param dataptr application supplied data buffer + * @param len length of the application supplied data buffer + * + * @return ERR_OK if successful, ERR_MEM if the pbuf is not big enough + */ +err_t +pbuf_take(struct pbuf *buf, const void *dataptr, u16_t len) +{ + struct pbuf *p; + u16_t buf_copy_len; + u16_t total_copy_len = len; + u16_t copied_total = 0; + + LWIP_ERROR("pbuf_take: invalid buf", (buf != NULL), return ERR_ARG;); + LWIP_ERROR("pbuf_take: invalid dataptr", (dataptr != NULL), return ERR_ARG;); + LWIP_ERROR("pbuf_take: buf not large enough", (buf->tot_len >= len), return ERR_MEM;); + + if ((buf == NULL) || (dataptr == NULL) || (buf->tot_len < len)) { + return ERR_ARG; + } + + /* Note some systems use byte copy if dataptr or one of the pbuf payload pointers are unaligned. */ + for (p = buf; total_copy_len != 0; p = p->next) { + LWIP_ASSERT("pbuf_take: invalid pbuf", p != NULL); + buf_copy_len = total_copy_len; + if (buf_copy_len > p->len) { + /* this pbuf cannot hold all remaining data */ + buf_copy_len = p->len; + } + /* copy the necessary parts of the buffer */ + MEMCPY(p->payload, &((const char*)dataptr)[copied_total], buf_copy_len); + total_copy_len -= buf_copy_len; + copied_total += buf_copy_len; + } + LWIP_ASSERT("did not copy all data", total_copy_len == 0 && copied_total == len); + return ERR_OK; +} + +/** + * Same as pbuf_take() but puts data at an offset + * + * @param buf pbuf to fill with data + * @param dataptr application supplied data buffer + * @param len length of the application supplied data buffer + * + * @return ERR_OK if successful, ERR_MEM if the pbuf is not big enough + */ +err_t +pbuf_take_at(struct pbuf *buf, const void *dataptr, u16_t len, u16_t offset) +{ + u16_t target_offset; + struct pbuf* q = pbuf_skip(buf, offset, &target_offset); + + /* return requested data if pbuf is OK */ + if ((q != NULL) && (q->tot_len >= target_offset + len)) { + u16_t remaining_len = len; + const u8_t* src_ptr = (const u8_t*)dataptr; + /* copy the part that goes into the first pbuf */ + u16_t first_copy_len = LWIP_MIN(q->len - target_offset, len); + MEMCPY(((u8_t*)q->payload) + target_offset, dataptr, first_copy_len); + remaining_len -= first_copy_len; + src_ptr += first_copy_len; + if (remaining_len > 0) { + return pbuf_take(q->next, src_ptr, remaining_len); + } + return ERR_OK; + } + return ERR_MEM; +} + +/** + * Creates a single pbuf out of a queue of pbufs. + * + * @remark: Either the source pbuf 'p' is freed by this function or the original + * pbuf 'p' is returned, therefore the caller has to check the result! + * + * @param p the source pbuf + * @param layer pbuf_layer of the new pbuf + * + * @return a new, single pbuf (p->next is NULL) + * or the old pbuf if allocation fails + */ +struct pbuf* +pbuf_coalesce(struct pbuf *p, pbuf_layer layer) +{ + struct pbuf *q; + err_t err; + if (p->next == NULL) { + return p; + } + q = pbuf_alloc(layer, p->tot_len, PBUF_RAM); + if (q == NULL) { + /* @todo: what do we do now? */ + return p; + } + err = pbuf_copy(q, p); + LWIP_ASSERT("pbuf_copy failed", err == ERR_OK); + pbuf_free(p); + return q; +} + +#if LWIP_CHECKSUM_ON_COPY +/** + * Copies data into a single pbuf (*not* into a pbuf queue!) and updates + * the checksum while copying + * + * @param p the pbuf to copy data into + * @param start_offset offset of p->payload where to copy the data to + * @param dataptr data to copy into the pbuf + * @param len length of data to copy into the pbuf + * @param chksum pointer to the checksum which is updated + * @return ERR_OK if successful, another error if the data does not fit + * within the (first) pbuf (no pbuf queues!) + */ +err_t +pbuf_fill_chksum(struct pbuf *p, u16_t start_offset, const void *dataptr, + u16_t len, u16_t *chksum) +{ + u32_t acc; + u16_t copy_chksum; + char *dst_ptr; + LWIP_ASSERT("p != NULL", p != NULL); + LWIP_ASSERT("dataptr != NULL", dataptr != NULL); + LWIP_ASSERT("chksum != NULL", chksum != NULL); + LWIP_ASSERT("len != 0", len != 0); + + if ((start_offset >= p->len) || (start_offset + len > p->len)) { + return ERR_ARG; + } + + dst_ptr = ((char*)p->payload) + start_offset; + copy_chksum = LWIP_CHKSUM_COPY(dst_ptr, dataptr, len); + if ((start_offset & 1) != 0) { + copy_chksum = SWAP_BYTES_IN_WORD(copy_chksum); + } + acc = *chksum; + acc += copy_chksum; + *chksum = FOLD_U32T(acc); + return ERR_OK; +} +#endif /* LWIP_CHECKSUM_ON_COPY */ + + /** Get one byte from the specified position in a pbuf + * WARNING: returns zero for offset >= p->tot_len + * + * @param p pbuf to parse + * @param offset offset into p of the byte to return + * @return byte at an offset into p OR ZERO IF 'offset' >= p->tot_len + */ +u8_t +pbuf_get_at(struct pbuf* p, u16_t offset) +{ + u16_t q_idx; + struct pbuf* q = pbuf_skip(p, offset, &q_idx); + + /* return requested data if pbuf is OK */ + if ((q != NULL) && (q->len > q_idx)) { + return ((u8_t*)q->payload)[q_idx]; + } + return 0; +} + + /** Put one byte to the specified position in a pbuf + * WARNING: silently ignores offset >= p->tot_len + * + * @param p pbuf to fill + * @param offset offset into p of the byte to write + * @param data byte to write at an offset into p + */ +void +pbuf_put_at(struct pbuf* p, u16_t offset, u8_t data) +{ + u16_t q_idx; + struct pbuf* q = pbuf_skip(p, offset, &q_idx); + + /* write requested data if pbuf is OK */ + if ((q != NULL) && (q->len > q_idx)) { + ((u8_t*)q->payload)[q_idx] = data; + } +} + +/** Compare pbuf contents at specified offset with memory s2, both of length n + * + * @param p pbuf to compare + * @param offset offset into p at which to start comparing + * @param s2 buffer to compare + * @param n length of buffer to compare + * @return zero if equal, nonzero otherwise + * (0xffff if p is too short, diffoffset+1 otherwise) + */ +u16_t +pbuf_memcmp(struct pbuf* p, u16_t offset, const void* s2, u16_t n) +{ + u16_t start = offset; + struct pbuf* q = p; + + /* get the correct pbuf */ + while ((q != NULL) && (q->len <= start)) { + start -= q->len; + q = q->next; + } + /* return requested data if pbuf is OK */ + if ((q != NULL) && (q->len > start)) { + u16_t i; + for (i = 0; i < n; i++) { + u8_t a = pbuf_get_at(q, start + i); + u8_t b = ((const u8_t*)s2)[i]; + if (a != b) { + return i+1; + } + } + return 0; + } + return 0xffff; +} + +/** Find occurrence of mem (with length mem_len) in pbuf p, starting at offset + * start_offset. + * + * @param p pbuf to search, maximum length is 0xFFFE since 0xFFFF is used as + * return value 'not found' + * @param mem search for the contents of this buffer + * @param mem_len length of 'mem' + * @param start_offset offset into p at which to start searching + * @return 0xFFFF if substr was not found in p or the index where it was found + */ +u16_t +pbuf_memfind(struct pbuf* p, const void* mem, u16_t mem_len, u16_t start_offset) +{ + u16_t i; + u16_t max = p->tot_len - mem_len; + if (p->tot_len >= mem_len + start_offset) { + for (i = start_offset; i <= max; i++) { + u16_t plus = pbuf_memcmp(p, i, mem, mem_len); + if (plus == 0) { + return i; + } + } + } + return 0xFFFF; +} + +/** Find occurrence of substr with length substr_len in pbuf p, start at offset + * start_offset + * WARNING: in contrast to strstr(), this one does not stop at the first \0 in + * the pbuf/source string! + * + * @param p pbuf to search, maximum length is 0xFFFE since 0xFFFF is used as + * return value 'not found' + * @param substr string to search for in p, maximum length is 0xFFFE + * @return 0xFFFF if substr was not found in p or the index where it was found + */ +u16_t +pbuf_strstr(struct pbuf* p, const char* substr) +{ + size_t substr_len; + if ((substr == NULL) || (substr[0] == 0) || (p->tot_len == 0xFFFF)) { + return 0xFFFF; + } + substr_len = strlen(substr); + if (substr_len >= 0xFFFF) { + return 0xFFFF; + } + return pbuf_memfind(p, substr, (u16_t)substr_len, 0); +} diff --git a/components/lwip/core/raw.c b/components/lwip/core/raw.c new file mode 100755 index 000000000..72a58d381 --- /dev/null +++ b/components/lwip/core/raw.c @@ -0,0 +1,483 @@ +/** + * @file + * Implementation of raw protocol PCBs for low-level handling of + * different types of protocols besides (or overriding) those + * already available in lwIP. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_RAW /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/memp.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/raw.h" +#include "lwip/stats.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/** The list of RAW PCBs */ +static struct raw_pcb *raw_pcbs; + +static u8_t +raw_input_match(struct raw_pcb *pcb, u8_t broadcast) +{ + LWIP_UNUSED_ARG(broadcast); /* in IPv6 only case */ + + /* Dual-stack: PCBs listening to any IP type also listen to any IP address */ + if(IP_IS_ANY_TYPE_VAL(pcb->local_ip)) { +#if LWIP_IPV4 && IP_SOF_BROADCAST_RECV + if((broadcast != 0) && !ip_get_option(pcb, SOF_BROADCAST)) { + return 0; + } +#endif /* LWIP_IPV4 && IP_SOF_BROADCAST_RECV */ + return 1; + } + + /* Only need to check PCB if incoming IP version matches PCB IP version */ + if(IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ip_current_dest_addr())) { +#if LWIP_IPV4 + /* Special case: IPv4 broadcast: receive all broadcasts + * Note: broadcast variable can only be 1 if it is an IPv4 broadcast */ + if(broadcast != 0) { +#if IP_SOF_BROADCAST_RECV + if(ip_get_option(pcb, SOF_BROADCAST)) +#endif /* IP_SOF_BROADCAST_RECV */ + { + if(ip4_addr_isany(ip_2_ip4(&pcb->local_ip))) { + return 1; + } + } + } else +#endif /* LWIP_IPV4 */ + /* Handle IPv4 and IPv6: catch all or exact match */ + if(ip_addr_isany(&pcb->local_ip) || + ip_addr_cmp(&pcb->local_ip, ip_current_dest_addr())) { + return 1; + } + } + + return 0; +} + +/** + * Determine if in incoming IP packet is covered by a RAW PCB + * and if so, pass it to a user-provided receive callback function. + * + * Given an incoming IP datagram (as a chain of pbufs) this function + * finds a corresponding RAW PCB and calls the corresponding receive + * callback function. + * + * @param p pbuf to be demultiplexed to a RAW PCB. + * @param inp network interface on which the datagram was received. + * @return - 1 if the packet has been eaten by a RAW PCB receive + * callback function. The caller MAY NOT not reference the + * packet any longer, and MAY NOT call pbuf_free(). + * @return - 0 if packet is not eaten (pbuf is still referenced by the + * caller). + * + */ +u8_t +raw_input(struct pbuf *p, struct netif *inp) +{ + struct raw_pcb *pcb, *prev; + s16_t proto; + u8_t eaten = 0; + u8_t broadcast = ip_addr_isbroadcast(ip_current_dest_addr(), ip_current_netif()); + + LWIP_UNUSED_ARG(inp); + +#if LWIP_IPV6 +#if LWIP_IPV4 + if (IP_HDR_GET_VERSION(p->payload) == 6) +#endif /* LWIP_IPV4 */ + { + struct ip6_hdr *ip6hdr = (struct ip6_hdr *)p->payload; + proto = IP6H_NEXTH(ip6hdr); + } +#if LWIP_IPV4 + else +#endif /* LWIP_IPV4 */ +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 + { + proto = IPH_PROTO((struct ip_hdr *)p->payload); + } +#endif /* LWIP_IPV4 */ + + prev = NULL; + pcb = raw_pcbs; + /* loop through all raw pcbs until the packet is eaten by one */ + /* this allows multiple pcbs to match against the packet by design */ + while ((eaten == 0) && (pcb != NULL)) { + if ((pcb->protocol == proto) && raw_input_match(pcb, broadcast)) { + /* receive callback function available? */ + if (pcb->recv != NULL) { +#ifndef LWIP_NOASSERT + void* old_payload = p->payload; +#endif + /* the receive callback function did not eat the packet? */ + eaten = pcb->recv(pcb->recv_arg, pcb, p, ip_current_src_addr()); + if (eaten != 0) { + /* receive function ate the packet */ + p = NULL; + eaten = 1; + if (prev != NULL) { + /* move the pcb to the front of raw_pcbs so that is + found faster next time */ + prev->next = pcb->next; + pcb->next = raw_pcbs; + raw_pcbs = pcb; + } + } else { + /* sanity-check that the receive callback did not alter the pbuf */ + LWIP_ASSERT("raw pcb recv callback altered pbuf payload pointer without eating packet", + p->payload == old_payload); + } + } + /* no receive callback function was set for this raw PCB */ + } + /* drop the packet */ + prev = pcb; + pcb = pcb->next; + } + return eaten; +} + +/** + * Bind a RAW PCB. + * + * @param pcb RAW PCB to be bound with a local address ipaddr. + * @param ipaddr local IP address to bind with. Use IP_ADDR_ANY to + * bind to all local interfaces. + * + * @return lwIP error code. + * - ERR_OK. Successful. No error occurred. + * - ERR_USE. The specified IP address is already bound to by + * another RAW PCB. + * + * @see raw_disconnect() + */ +err_t +raw_bind(struct raw_pcb *pcb, const ip_addr_t *ipaddr) +{ + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + ip_addr_set_ipaddr(&pcb->local_ip, ipaddr); + return ERR_OK; +} + +/** + * Connect an RAW PCB. This function is required by upper layers + * of lwip. Using the raw api you could use raw_sendto() instead + * + * This will associate the RAW PCB with the remote address. + * + * @param pcb RAW PCB to be connected with remote address ipaddr and port. + * @param ipaddr remote IP address to connect with. + * + * @return lwIP error code + * + * @see raw_disconnect() and raw_sendto() + */ +err_t +raw_connect(struct raw_pcb *pcb, const ip_addr_t *ipaddr) +{ + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + ip_addr_set_ipaddr(&pcb->remote_ip, ipaddr); + return ERR_OK; +} + +/** + * Set the callback function for received packets that match the + * raw PCB's protocol and binding. + * + * The callback function MUST either + * - eat the packet by calling pbuf_free() and returning non-zero. The + * packet will not be passed to other raw PCBs or other protocol layers. + * - not free the packet, and return zero. The packet will be matched + * against further PCBs and/or forwarded to another protocol layers. + * + * @return non-zero if the packet was free()d, zero if the packet remains + * available for others. + */ +void +raw_recv(struct raw_pcb *pcb, raw_recv_fn recv, void *recv_arg) +{ + /* remember recv() callback and user data */ + pcb->recv = recv; + pcb->recv_arg = recv_arg; +} + +/** + * Send the raw IP packet to the given address. Note that actually you cannot + * modify the IP headers (this is inconsistent with the receive callback where + * you actually get the IP headers), you can only specify the IP payload here. + * It requires some more changes in lwIP. (there will be a raw_send() function + * then.) + * + * @param pcb the raw pcb which to send + * @param p the IP payload to send + * @param ipaddr the destination address of the IP packet + * + */ +err_t +raw_sendto(struct raw_pcb *pcb, struct pbuf *p, const ip_addr_t *ipaddr) +{ + err_t err; + struct netif *netif; + const ip_addr_t *src_ip; + struct pbuf *q; /* q will be sent down the stack */ + s16_t header_size; + const ip_addr_t *dst_ip = ipaddr; + + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, ipaddr)) { + return ERR_VAL; + } + + LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_TRACE, ("raw_sendto\n")); + + header_size = ( +#if LWIP_IPV4 && LWIP_IPV6 + IP_IS_V6(ipaddr) ? IP6_HLEN : IP_HLEN); +#elif LWIP_IPV4 + IP_HLEN); +#else + IP6_HLEN); +#endif + + /* not enough space to add an IP header to first pbuf in given p chain? */ + if (pbuf_header(p, header_size)) { + /* allocate header in new pbuf */ + q = pbuf_alloc(PBUF_IP, 0, PBUF_RAM); + /* new header pbuf could not be allocated? */ + if (q == NULL) { + LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("raw_sendto: could not allocate header\n")); + return ERR_MEM; + } + if (p->tot_len != 0) { + /* chain header q in front of given pbuf p */ + pbuf_chain(q, p); + } + /* { first pbuf q points to header pbuf } */ + LWIP_DEBUGF(RAW_DEBUG, ("raw_sendto: added header pbuf %p before given pbuf %p\n", (void *)q, (void *)p)); + } else { + /* first pbuf q equals given pbuf */ + q = p; + if (pbuf_header(q, -header_size)) { + LWIP_ASSERT("Can't restore header we just removed!", 0); + return ERR_MEM; + } + } + + netif = ip_route(&pcb->local_ip, dst_ip); + if (netif == NULL) { + LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_LEVEL_WARNING, ("raw_sendto: No route to ")); + ip_addr_debug_print(RAW_DEBUG | LWIP_DBG_LEVEL_WARNING, dst_ip); + /* free any temporary header pbuf allocated by pbuf_header() */ + if (q != p) { + pbuf_free(q); + } + return ERR_RTE; + } + +#if IP_SOF_BROADCAST + if (!IP_IS_V6(ipaddr)) + { + /* broadcast filter? */ + if (!ip_get_option(pcb, SOF_BROADCAST) && ip_addr_isbroadcast(ipaddr, netif)) { + LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_LEVEL_WARNING, ("raw_sendto: SOF_BROADCAST not enabled on pcb %p\n", (void *)pcb)); + /* free any temporary header pbuf allocated by pbuf_header() */ + if (q != p) { + pbuf_free(q); + } + return ERR_VAL; + } + } +#endif /* IP_SOF_BROADCAST */ + + if (ip_addr_isany(&pcb->local_ip)) { + /* use outgoing network interface IP address as source address */ + src_ip = ip_netif_get_local_ip(netif, dst_ip); +#if LWIP_IPV6 + if (src_ip == NULL) { + if (q != p) { + pbuf_free(q); + } + return ERR_RTE; + } +#endif /* LWIP_IPV6 */ + } else { + /* use RAW PCB local IP address as source address */ + src_ip = &pcb->local_ip; + } + +#if LWIP_IPV6 + /* If requested, based on the IPV6_CHECKSUM socket option per RFC3542, + compute the checksum and update the checksum in the payload. */ + if (IP_IS_V6(dst_ip) && pcb->chksum_reqd) { + u16_t chksum = ip6_chksum_pseudo(p, pcb->protocol, p->tot_len, ip_2_ip6(src_ip), ip_2_ip6(dst_ip)); + LWIP_ASSERT("Checksum must fit into first pbuf", p->len >= (pcb->chksum_offset + 2)); + SMEMCPY(((u8_t *)p->payload) + pcb->chksum_offset, &chksum, sizeof(u16_t)); + } +#endif + + NETIF_SET_HWADDRHINT(netif, &pcb->addr_hint); + err = ip_output_if(q, src_ip, dst_ip, pcb->ttl, pcb->tos, pcb->protocol, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + + /* did we chain a header earlier? */ + if (q != p) { + /* free the header */ + pbuf_free(q); + } + return err; +} + +/** + * Send the raw IP packet to the address given by raw_connect() + * + * @param pcb the raw pcb which to send + * @param p the IP payload to send + * + */ +err_t +raw_send(struct raw_pcb *pcb, struct pbuf *p) +{ + return raw_sendto(pcb, p, &pcb->remote_ip); +} + +/** + * Remove an RAW PCB. + * + * @param pcb RAW PCB to be removed. The PCB is removed from the list of + * RAW PCB's and the data structure is freed from memory. + * + * @see raw_new() + */ +void +raw_remove(struct raw_pcb *pcb) +{ + struct raw_pcb *pcb2; + /* pcb to be removed is first in list? */ + if (raw_pcbs == pcb) { + /* make list start at 2nd pcb */ + raw_pcbs = raw_pcbs->next; + /* pcb not 1st in list */ + } else { + for (pcb2 = raw_pcbs; pcb2 != NULL; pcb2 = pcb2->next) { + /* find pcb in raw_pcbs list */ + if (pcb2->next != NULL && pcb2->next == pcb) { + /* remove pcb from list */ + pcb2->next = pcb->next; + break; + } + } + } + memp_free(MEMP_RAW_PCB, pcb); +} + +/** + * Create a RAW PCB. + * + * @return The RAW PCB which was created. NULL if the PCB data structure + * could not be allocated. + * + * @param proto the protocol number of the IPs payload (e.g. IP_PROTO_ICMP) + * + * @see raw_remove() + */ +struct raw_pcb * +raw_new(u8_t proto) +{ + struct raw_pcb *pcb; + + LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_TRACE, ("raw_new\n")); + + pcb = (struct raw_pcb *)memp_malloc(MEMP_RAW_PCB); + /* could allocate RAW PCB? */ + if (pcb != NULL) { + /* initialize PCB to all zeroes */ + memset(pcb, 0, sizeof(struct raw_pcb)); + pcb->protocol = proto; + pcb->ttl = RAW_TTL; + pcb->next = raw_pcbs; + raw_pcbs = pcb; + } + return pcb; +} + +/** + * Create a RAW PCB for IPv6. + * + * @return The RAW PCB which was created. NULL if the PCB data structure + * could not be allocated. + * + * @param type IP address type, see IPADDR_TYPE_XX definitions. + * @param proto the protocol number (next header) of the IPv6 packet payload + * (e.g. IP6_NEXTH_ICMP6) + * + * @see raw_remove() + */ +struct raw_pcb * +raw_new_ip_type(u8_t type, u8_t proto) +{ + struct raw_pcb *pcb; + pcb = raw_new(proto); +#if LWIP_IPV4 && LWIP_IPV6 + if(pcb != NULL) { + IP_SET_TYPE_VAL(pcb->local_ip, type); + IP_SET_TYPE_VAL(pcb->remote_ip, type); + } +#else /* LWIP_IPV4 && LWIP_IPV6 */ + LWIP_UNUSED_ARG(type); +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + return pcb; +} + +#endif /* LWIP_RAW */ diff --git a/components/lwip/core/stats.c b/components/lwip/core/stats.c new file mode 100755 index 000000000..77ac3c675 --- /dev/null +++ b/components/lwip/core/stats.c @@ -0,0 +1,188 @@ +/** + * @file + * Statistics module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_STATS /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/stats.h" +#include "lwip/mem.h" +#include "lwip/debug.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +struct stats_ lwip_stats; + +#if defined(LWIP_DEBUG) || LWIP_STATS_DISPLAY +#if MEMP_STATS +static const char * memp_names[] = { +#define LWIP_MEMPOOL(name,num,size,desc) desc, +#include "lwip/priv/memp_std.h" +}; +#endif /* MEMP_STATS */ +#endif /* LWIP_DEBUG || LWIP_STATS_DISPLAY */ + +void +stats_init(void) +{ +#ifdef LWIP_DEBUG +#if MEMP_STATS + int i; + for (i = 0; i < MEMP_MAX; i++) { + lwip_stats.memp[i].name = memp_names[i]; + } +#endif /* MEMP_STATS */ +#if MEM_STATS + lwip_stats.mem.name = "MEM"; +#endif /* MEM_STATS */ +#endif /* LWIP_DEBUG */ +} + +#if LWIP_STATS_DISPLAY +void +stats_display_proto(struct stats_proto *proto, const char *name) +{ + LWIP_PLATFORM_DIAG(("\n%s\n\t", name)); + LWIP_PLATFORM_DIAG(("xmit: %"STAT_COUNTER_F"\n\t", proto->xmit)); + LWIP_PLATFORM_DIAG(("recv: %"STAT_COUNTER_F"\n\t", proto->recv)); + LWIP_PLATFORM_DIAG(("fw: %"STAT_COUNTER_F"\n\t", proto->fw)); + LWIP_PLATFORM_DIAG(("drop: %"STAT_COUNTER_F"\n\t", proto->drop)); + LWIP_PLATFORM_DIAG(("chkerr: %"STAT_COUNTER_F"\n\t", proto->chkerr)); + LWIP_PLATFORM_DIAG(("lenerr: %"STAT_COUNTER_F"\n\t", proto->lenerr)); + LWIP_PLATFORM_DIAG(("memerr: %"STAT_COUNTER_F"\n\t", proto->memerr)); + LWIP_PLATFORM_DIAG(("rterr: %"STAT_COUNTER_F"\n\t", proto->rterr)); + LWIP_PLATFORM_DIAG(("proterr: %"STAT_COUNTER_F"\n\t", proto->proterr)); + LWIP_PLATFORM_DIAG(("opterr: %"STAT_COUNTER_F"\n\t", proto->opterr)); + LWIP_PLATFORM_DIAG(("err: %"STAT_COUNTER_F"\n\t", proto->err)); + LWIP_PLATFORM_DIAG(("cachehit: %"STAT_COUNTER_F"\n", proto->cachehit)); +} + +#if IGMP_STATS || MLD6_STATS +void +stats_display_igmp(struct stats_igmp *igmp, const char *name) +{ + LWIP_PLATFORM_DIAG(("\n%s\n\t", name)); + LWIP_PLATFORM_DIAG(("xmit: %"STAT_COUNTER_F"\n\t", igmp->xmit)); + LWIP_PLATFORM_DIAG(("recv: %"STAT_COUNTER_F"\n\t", igmp->recv)); + LWIP_PLATFORM_DIAG(("drop: %"STAT_COUNTER_F"\n\t", igmp->drop)); + LWIP_PLATFORM_DIAG(("chkerr: %"STAT_COUNTER_F"\n\t", igmp->chkerr)); + LWIP_PLATFORM_DIAG(("lenerr: %"STAT_COUNTER_F"\n\t", igmp->lenerr)); + LWIP_PLATFORM_DIAG(("memerr: %"STAT_COUNTER_F"\n\t", igmp->memerr)); + LWIP_PLATFORM_DIAG(("proterr: %"STAT_COUNTER_F"\n\t", igmp->proterr)); + LWIP_PLATFORM_DIAG(("rx_v1: %"STAT_COUNTER_F"\n\t", igmp->rx_v1)); + LWIP_PLATFORM_DIAG(("rx_group: %"STAT_COUNTER_F"\n\t", igmp->rx_group)); + LWIP_PLATFORM_DIAG(("rx_general: %"STAT_COUNTER_F"\n\t", igmp->rx_general)); + LWIP_PLATFORM_DIAG(("rx_report: %"STAT_COUNTER_F"\n\t", igmp->rx_report)); + LWIP_PLATFORM_DIAG(("tx_join: %"STAT_COUNTER_F"\n\t", igmp->tx_join)); + LWIP_PLATFORM_DIAG(("tx_leave: %"STAT_COUNTER_F"\n\t", igmp->tx_leave)); + LWIP_PLATFORM_DIAG(("tx_report: %"STAT_COUNTER_F"\n\t", igmp->tx_report)); +} +#endif /* IGMP_STATS || MLD6_STATS */ + +#if MEM_STATS || MEMP_STATS +void +stats_display_mem(struct stats_mem *mem, const char *name) +{ + LWIP_PLATFORM_DIAG(("\nMEM %s\n\t", name)); + LWIP_PLATFORM_DIAG(("avail: %"U32_F"\n\t", (u32_t)mem->avail)); + LWIP_PLATFORM_DIAG(("used: %"U32_F"\n\t", (u32_t)mem->used)); + LWIP_PLATFORM_DIAG(("max: %"U32_F"\n\t", (u32_t)mem->max)); + LWIP_PLATFORM_DIAG(("err: %"U32_F"\n", (u32_t)mem->err)); +} + +#if MEMP_STATS +void +stats_display_memp(struct stats_mem *mem, int index) +{ + if (index < MEMP_MAX) { + stats_display_mem(mem, memp_names[index]); + } +} +#endif /* MEMP_STATS */ +#endif /* MEM_STATS || MEMP_STATS */ + +#if SYS_STATS +void +stats_display_sys(struct stats_sys *sys) +{ + LWIP_PLATFORM_DIAG(("\nSYS\n\t")); + LWIP_PLATFORM_DIAG(("sem.used: %"U32_F"\n\t", (u32_t)sys->sem.used)); + LWIP_PLATFORM_DIAG(("sem.max: %"U32_F"\n\t", (u32_t)sys->sem.max)); + LWIP_PLATFORM_DIAG(("sem.err: %"U32_F"\n\t", (u32_t)sys->sem.err)); + LWIP_PLATFORM_DIAG(("mutex.used: %"U32_F"\n\t", (u32_t)sys->mutex.used)); + LWIP_PLATFORM_DIAG(("mutex.max: %"U32_F"\n\t", (u32_t)sys->mutex.max)); + LWIP_PLATFORM_DIAG(("mutex.err: %"U32_F"\n\t", (u32_t)sys->mutex.err)); + LWIP_PLATFORM_DIAG(("mbox.used: %"U32_F"\n\t", (u32_t)sys->mbox.used)); + LWIP_PLATFORM_DIAG(("mbox.max: %"U32_F"\n\t", (u32_t)sys->mbox.max)); + LWIP_PLATFORM_DIAG(("mbox.err: %"U32_F"\n\t", (u32_t)sys->mbox.err)); +} +#endif /* SYS_STATS */ + +void +stats_display(void) +{ + s16_t i; + + LINK_STATS_DISPLAY(); + ETHARP_STATS_DISPLAY(); + IPFRAG_STATS_DISPLAY(); + IP6_FRAG_STATS_DISPLAY(); + IP_STATS_DISPLAY(); + ND6_STATS_DISPLAY(); + IP6_STATS_DISPLAY(); + IGMP_STATS_DISPLAY(); + MLD6_STATS_DISPLAY(); + ICMP_STATS_DISPLAY(); + ICMP6_STATS_DISPLAY(); + UDP_STATS_DISPLAY(); + TCP_STATS_DISPLAY(); + MEM_STATS_DISPLAY(); + for (i = 0; i < MEMP_MAX; i++) { + MEMP_STATS_DISPLAY(i); + } + SYS_STATS_DISPLAY(); +} +#endif /* LWIP_STATS_DISPLAY */ + +#endif /* LWIP_STATS */ + diff --git a/components/lwip/core/sys.c b/components/lwip/core/sys.c new file mode 100755 index 000000000..f17773726 --- /dev/null +++ b/components/lwip/core/sys.c @@ -0,0 +1,68 @@ +/** + * @file + * lwIP Operating System abstraction + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/sys.h" + +/* Most of the functions defined in sys.h must be implemented in the + * architecture-dependent file sys_arch.c */ + +#if !NO_SYS + +#ifndef sys_msleep +/** + * Sleep for some ms. Timeouts are NOT processed while sleeping. + * + * @param ms number of milliseconds to sleep + */ +void +sys_msleep(u32_t ms) +{ + if (ms > 0) { + sys_sem_t delaysem; + err_t err = sys_sem_new(&delaysem, 0); + if (err == ERR_OK) { + sys_arch_sem_wait(&delaysem, ms); + sys_sem_free(&delaysem); + } + } +} +#endif /* sys_msleep */ + +#endif /* !NO_SYS */ diff --git a/components/lwip/core/tcp.c b/components/lwip/core/tcp.c new file mode 100755 index 000000000..e8fda52c8 --- /dev/null +++ b/components/lwip/core/tcp.c @@ -0,0 +1,2155 @@ +/** + * @file + * Transmission Control Protocol for IP + * + * This file contains common functions for the TCP implementation, such as functinos + * for manipulating the data structures and the TCP timer functions. TCP functions + * related to input and output is found in tcp_in.c and tcp_out.c respectively. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/tcp.h" +#include "lwip/priv/tcp_priv.h" +#include "lwip/debug.h" +#include "lwip/stats.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/nd6.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#ifndef TCP_LOCAL_PORT_RANGE_START +/* From http://www.iana.org/assignments/port-numbers: + "The Dynamic and/or Private Ports are those from 49152 through 65535" */ +#define TCP_LOCAL_PORT_RANGE_START 0xc000 +#define TCP_LOCAL_PORT_RANGE_END 0xffff +#define TCP_ENSURE_LOCAL_PORT_RANGE(port) ((u16_t)(((port) & ~TCP_LOCAL_PORT_RANGE_START) + TCP_LOCAL_PORT_RANGE_START)) +#endif + +#if LWIP_TCP_KEEPALIVE +#define TCP_KEEP_DUR(pcb) ((pcb)->keep_cnt * (pcb)->keep_intvl) +#define TCP_KEEP_INTVL(pcb) ((pcb)->keep_intvl) +#else /* LWIP_TCP_KEEPALIVE */ +#define TCP_KEEP_DUR(pcb) TCP_MAXIDLE +#define TCP_KEEP_INTVL(pcb) TCP_KEEPINTVL_DEFAULT +#endif /* LWIP_TCP_KEEPALIVE */ + +#ifdef LWIP_ESP8266 +//TO_DO +//char tcp_state_str[12]; +//const char tcp_state_str_rodata[][12] ICACHE_RODATA_ATTR STORE_ATTR = { +const char * const tcp_state_str[] = { +#else +const char * const tcp_state_str[] = { +#endif + "CLOSED", + "LISTEN", + "SYN_SENT", + "SYN_RCVD", + "ESTABLISHED", + "FIN_WAIT_1", + "FIN_WAIT_2", + "CLOSE_WAIT", + "CLOSING", + "LAST_ACK", + "TIME_WAIT" +}; + + +/* last local TCP port */ +#ifdef LWIP_ESP8266 +static s16_t tcp_port = TCP_LOCAL_PORT_RANGE_START; +#else +static u16_t tcp_port = TCP_LOCAL_PORT_RANGE_START; +#endif + +/* Incremented every coarse grained timer shot (typically every 500 ms). */ +u32_t tcp_ticks; + +#ifdef LWIP_ESP8266 +//TO_DO +//const u8_t tcp_backoff[13] ICACHE_RODATA_ATTR STORE_ATTR ={ 1, 2, 3, 4, 5, 6, 7, 7, 7, 7, 7, 7, 7}; +//const u8_t tcp_persist_backoff[7] ICACHE_RODATA_ATTR STORE_ATTR = { 3, 6, 12, 24, 48, 96, 120 }; + +const u8_t tcp_backoff[13] = { 1, 2, 3, 4, 5, 6, 7, 7, 7, 7, 7, 7, 7}; +const u8_t tcp_persist_backoff[7] = { 3, 6, 12, 24, 48, 96, 120 }; +#else +const u8_t tcp_backoff[13] = { 1, 2, 3, 4, 5, 6, 7, 7, 7, 7, 7, 7, 7}; + /* Times per slowtmr hits */ +const u8_t tcp_persist_backoff[7] = { 3, 6, 12, 24, 48, 96, 120 }; +#endif + + +/* The TCP PCB lists. */ + +/** List of all TCP PCBs bound but not yet (connected || listening) */ +struct tcp_pcb *tcp_bound_pcbs; +/** List of all TCP PCBs in LISTEN state */ +union tcp_listen_pcbs_t tcp_listen_pcbs; +/** List of all TCP PCBs that are in a state in which + * they accept or send data. */ +struct tcp_pcb *tcp_active_pcbs; +/** List of all TCP PCBs in TIME-WAIT state */ +struct tcp_pcb *tcp_tw_pcbs; + +/** An array with all (non-temporary) PCB lists, mainly used for smaller code size */ +#ifdef LWIP_ESP8266 +//TO_DO +//struct tcp_pcb ** const tcp_pcb_lists[] ICACHE_RODATA_ATTR STORE_ATTR = {&tcp_listen_pcbs.pcbs, &tcp_bound_pcbs, + // &tcp_active_pcbs, &tcp_tw_pcbs}; +struct tcp_pcb ** const tcp_pcb_lists[] = {&tcp_listen_pcbs.pcbs, &tcp_bound_pcbs, + &tcp_active_pcbs, &tcp_tw_pcbs}; + +#else +struct tcp_pcb ** const tcp_pcb_lists[] = {&tcp_listen_pcbs.pcbs, &tcp_bound_pcbs, + &tcp_active_pcbs, &tcp_tw_pcbs}; +#endif + + +u8_t tcp_active_pcbs_changed; + +/** Timer counter to handle calling slow-timer from tcp_tmr() */ +static u8_t tcp_timer; +static u8_t tcp_timer_ctr; +static u16_t tcp_new_port(void); + +/** + * Initialize this module. + */ +void +tcp_init(void) +{ +#if LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND) + tcp_port = TCP_ENSURE_LOCAL_PORT_RANGE(LWIP_RAND()); +#endif /* LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND) */ +} + +/** + * Called periodically to dispatch TCP timers. + */ +void +tcp_tmr(void) +{ + /* Call tcp_fasttmr() every 250 ms */ + tcp_fasttmr(); + + if (++tcp_timer & 1) { + /* Call tcp_slowtmr() every 500 ms, i.e., every other timer + tcp_tmr() is called. */ + tcp_slowtmr(); + } +} + +/** + * Closes the TX side of a connection held by the PCB. + * For tcp_close(), a RST is sent if the application didn't receive all data + * (tcp_recved() not called for all data passed to recv callback). + * + * Listening pcbs are freed and may not be referenced any more. + * Connection pcbs are freed if not yet connected and may not be referenced + * any more. If a connection is established (at least SYN received or in + * a closing state), the connection is closed, and put in a closing state. + * The pcb is then automatically freed in tcp_slowtmr(). It is therefore + * unsafe to reference it. + * + * @param pcb the tcp_pcb to close + * @return ERR_OK if connection has been closed + * another err_t if closing failed and pcb is not freed + */ +static err_t +tcp_close_shutdown(struct tcp_pcb *pcb, u8_t rst_on_unacked_data) +{ + err_t err; + + if (rst_on_unacked_data && ((pcb->state == ESTABLISHED) || (pcb->state == CLOSE_WAIT))) { + if ((pcb->refused_data != NULL) || (pcb->rcv_wnd != TCP_WND_MAX(pcb))) { + /* Not all data received by application, send RST to tell the remote + side about this. */ + LWIP_ASSERT("pcb->flags & TF_RXCLOSED", pcb->flags & TF_RXCLOSED); + + /* don't call tcp_abort here: we must not deallocate the pcb since + that might not be expected when calling tcp_close */ + tcp_rst(pcb->snd_nxt, pcb->rcv_nxt, &pcb->local_ip, &pcb->remote_ip, + pcb->local_port, pcb->remote_port); + + tcp_pcb_purge(pcb); + TCP_RMV_ACTIVE(pcb); + if (pcb->state == ESTABLISHED) { + /* move to TIME_WAIT since we close actively */ + pcb->state = TIME_WAIT; + TCP_REG(&tcp_tw_pcbs, pcb); + } else { + /* CLOSE_WAIT: deallocate the pcb since we already sent a RST for it */ + if (tcp_input_pcb == pcb) { + /* prevent using a deallocated pcb: free it from tcp_input later */ + tcp_trigger_input_pcb_close(); + } else { + memp_free(MEMP_TCP_PCB, pcb); + } + } + return ERR_OK; + } + } + + switch (pcb->state) { + case CLOSED: + /* Closing a pcb in the CLOSED state might seem erroneous, + * however, it is in this state once allocated and as yet unused + * and the user needs some way to free it should the need arise. + * Calling tcp_close() with a pcb that has already been closed, (i.e. twice) + * or for a pcb that has been used and then entered the CLOSED state + * is erroneous, but this should never happen as the pcb has in those cases + * been freed, and so any remaining handles are bogus. */ + err = ERR_OK; + if (pcb->local_port != 0) { + TCP_RMV(&tcp_bound_pcbs, pcb); + } + memp_free(MEMP_TCP_PCB, pcb); + pcb = NULL; + break; + case LISTEN: + err = ERR_OK; + tcp_pcb_remove(&tcp_listen_pcbs.pcbs, pcb); + memp_free(MEMP_TCP_PCB_LISTEN, pcb); + pcb = NULL; + break; + case SYN_SENT: + err = ERR_OK; + TCP_PCB_REMOVE_ACTIVE(pcb); + memp_free(MEMP_TCP_PCB, pcb); + pcb = NULL; + MIB2_STATS_INC(mib2.tcpattemptfails); + break; + case SYN_RCVD: + err = tcp_send_fin(pcb); + if (err == ERR_OK) { + MIB2_STATS_INC(mib2.tcpattemptfails); + pcb->state = FIN_WAIT_1; + } + break; + case ESTABLISHED: + err = tcp_send_fin(pcb); + if (err == ERR_OK) { + MIB2_STATS_INC(mib2.tcpestabresets); + pcb->state = FIN_WAIT_1; + } + break; + case CLOSE_WAIT: + err = tcp_send_fin(pcb); + if (err == ERR_OK) { + MIB2_STATS_INC(mib2.tcpestabresets); + pcb->state = LAST_ACK; + } + break; + default: + /* Has already been closed, do nothing. */ + err = ERR_OK; + pcb = NULL; + break; + } + + if (pcb != NULL && err == ERR_OK) { + /* To ensure all data has been sent when tcp_close returns, we have + to make sure tcp_output doesn't fail. + Since we don't really have to ensure all data has been sent when tcp_close + returns (unsent data is sent from tcp timer functions, also), we don't care + for the return value of tcp_output for now. */ + tcp_output(pcb); + } + return err; +} + +/** + * Closes the connection held by the PCB. + * + * Listening pcbs are freed and may not be referenced any more. + * Connection pcbs are freed if not yet connected and may not be referenced + * any more. If a connection is established (at least SYN received or in + * a closing state), the connection is closed, and put in a closing state. + * The pcb is then automatically freed in tcp_slowtmr(). It is therefore + * unsafe to reference it (unless an error is returned). + * + * @param pcb the tcp_pcb to close + * @return ERR_OK if connection has been closed + * another err_t if closing failed and pcb is not freed + */ +err_t +tcp_close(struct tcp_pcb *pcb) +{ + LWIP_DEBUGF(TCP_DEBUG, ("tcp_close: closing in ")); + tcp_debug_print_state(pcb->state); + + if (pcb->state != LISTEN) { + /* Set a flag not to receive any more data... */ + pcb->flags |= TF_RXCLOSED; + } + /* ... and close */ + return tcp_close_shutdown(pcb, 1); +} + +/** + * Causes all or part of a full-duplex connection of this PCB to be shut down. + * This doesn't deallocate the PCB unless shutting down both sides! + * Shutting down both sides is the same as calling tcp_close, so if it succeds, + * the PCB should not be referenced any more. + * + * @param pcb PCB to shutdown + * @param shut_rx shut down receive side if this is != 0 + * @param shut_tx shut down send side if this is != 0 + * @return ERR_OK if shutdown succeeded (or the PCB has already been shut down) + * another err_t on error. + */ +err_t +tcp_shutdown(struct tcp_pcb *pcb, int shut_rx, int shut_tx) +{ + if (pcb->state == LISTEN) { + return ERR_CONN; + } + if (shut_rx) { + /* shut down the receive side: set a flag not to receive any more data... */ + pcb->flags |= TF_RXCLOSED; + if (shut_tx) { + /* shutting down the tx AND rx side is the same as closing for the raw API */ + return tcp_close_shutdown(pcb, 1); + } + /* ... and free buffered data */ + if (pcb->refused_data != NULL) { + pbuf_free(pcb->refused_data); + pcb->refused_data = NULL; + } + } + if (shut_tx) { + /* This can't happen twice since if it succeeds, the pcb's state is changed. + Only close in these states as the others directly deallocate the PCB */ + switch (pcb->state) { + case SYN_RCVD: + case ESTABLISHED: + case CLOSE_WAIT: + return tcp_close_shutdown(pcb, (u8_t)shut_rx); + default: + /* Not (yet?) connected, cannot shutdown the TX side as that would bring us + into CLOSED state, where the PCB is deallocated. */ + return ERR_CONN; + } + } + return ERR_OK; +} + +/** + * Abandons a connection and optionally sends a RST to the remote + * host. Deletes the local protocol control block. This is done when + * a connection is killed because of shortage of memory. + * + * @param pcb the tcp_pcb to abort + * @param reset boolean to indicate whether a reset should be sent + */ +void +tcp_abandon(struct tcp_pcb *pcb, int reset) +{ + u32_t seqno, ackno; +#if LWIP_CALLBACK_API + tcp_err_fn errf; +#endif /* LWIP_CALLBACK_API */ + void *errf_arg; + + /* pcb->state LISTEN not allowed here */ + LWIP_ASSERT("don't call tcp_abort/tcp_abandon for listen-pcbs", + pcb->state != LISTEN); + /* Figure out on which TCP PCB list we are, and remove us. If we + are in an active state, call the receive function associated with + the PCB with a NULL argument, and send an RST to the remote end. */ + if (pcb->state == TIME_WAIT) { + tcp_pcb_remove(&tcp_tw_pcbs, pcb); + memp_free(MEMP_TCP_PCB, pcb); + } else { + int send_rst = 0; + u16_t local_port = 0; + seqno = pcb->snd_nxt; + ackno = pcb->rcv_nxt; +#if LWIP_CALLBACK_API + errf = pcb->errf; +#endif /* LWIP_CALLBACK_API */ + errf_arg = pcb->callback_arg; + if ((pcb->state == CLOSED) && (pcb->local_port != 0)) { + /* bound, not yet opened */ + TCP_RMV(&tcp_bound_pcbs, pcb); + } else { + send_rst = reset; + local_port = pcb->local_port; + TCP_PCB_REMOVE_ACTIVE(pcb); + } + if (pcb->unacked != NULL) { + tcp_segs_free(pcb->unacked); + } + if (pcb->unsent != NULL) { + tcp_segs_free(pcb->unsent); + } +#if TCP_QUEUE_OOSEQ + if (pcb->ooseq != NULL) { + tcp_segs_free(pcb->ooseq); + } +#endif /* TCP_QUEUE_OOSEQ */ + if (send_rst) { + LWIP_DEBUGF(TCP_RST_DEBUG, ("tcp_abandon: sending RST\n")); + tcp_rst(seqno, ackno, &pcb->local_ip, &pcb->remote_ip, local_port, pcb->remote_port); + } + memp_free(MEMP_TCP_PCB, pcb); + TCP_EVENT_ERR(errf, errf_arg, ERR_ABRT); + } +} + +/** + * Aborts the connection by sending a RST (reset) segment to the remote + * host. The pcb is deallocated. This function never fails. + * + * ATTENTION: When calling this from one of the TCP callbacks, make + * sure you always return ERR_ABRT (and never return ERR_ABRT otherwise + * or you will risk accessing deallocated memory or memory leaks! + * + * @param pcb the tcp pcb to abort + */ +void +tcp_abort(struct tcp_pcb *pcb) +{ + tcp_abandon(pcb, 1); +} + +/** + * Binds the connection to a local port number and IP address. If the + * IP address is not given (i.e., ipaddr == NULL), the IP address of + * the outgoing network interface is used instead. + * + * @param pcb the tcp_pcb to bind (no check is done whether this pcb is + * already bound!) + * @param ipaddr the local ip address to bind to (use IP_ADDR_ANY to bind + * to any local address + * @param port the local port to bind to + * @return ERR_USE if the port is already in use + * ERR_VAL if bind failed because the PCB is not in a valid state + * ERR_OK if bound + */ +err_t +tcp_bind(struct tcp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port) +{ + int i; + int max_pcb_list = NUM_TCP_PCB_LISTS; + struct tcp_pcb *cpcb; + +#if LWIP_IPV4 + /* Don't propagate NULL pointer (IPv4 ANY) to subsequent functions */ + if (ipaddr == NULL) { + ipaddr = IP_ADDR_ANY; + } +#endif /* LWIP_IPV4 */ + + /* still need to check for ipaddr == NULL in IPv6 only case */ + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + + LWIP_ERROR("tcp_bind: can only bind in state CLOSED", pcb->state == CLOSED, return ERR_VAL); + +#if SO_REUSE + /* Unless the REUSEADDR flag is set, + we have to check the pcbs in TIME-WAIT state, also. + We do not dump TIME_WAIT pcb's; they can still be matched by incoming + packets using both local and remote IP addresses and ports to distinguish. + */ + if (ip_get_option(pcb, SOF_REUSEADDR)) { + max_pcb_list = NUM_TCP_PCB_LISTS_NO_TIME_WAIT; + } +#endif /* SO_REUSE */ + + if (port == 0) { + port = tcp_new_port(); + if (port == 0) { + return ERR_BUF; + } + } else { + /* Check if the address already is in use (on all lists) */ + for (i = 0; i < max_pcb_list; i++) { + for (cpcb = *tcp_pcb_lists[i]; cpcb != NULL; cpcb = cpcb->next) { + if (cpcb->local_port == port) { +#if SO_REUSE + /* Omit checking for the same port if both pcbs have REUSEADDR set. + For SO_REUSEADDR, the duplicate-check for a 5-tuple is done in + tcp_connect. */ + if (!ip_get_option(pcb, SOF_REUSEADDR) || + !ip_get_option(cpcb, SOF_REUSEADDR)) +#endif /* SO_REUSE */ + { + /* @todo: check accept_any_ip_version */ + if ((IP_IS_V6(ipaddr) == IP_IS_V6_VAL(cpcb->local_ip)) && + (ip_addr_isany(&cpcb->local_ip) || + ip_addr_isany(ipaddr) || + ip_addr_cmp(&cpcb->local_ip, ipaddr))) { + return ERR_USE; + } + } + } + } + } + } + + if (!ip_addr_isany(ipaddr)) { + ip_addr_set(&pcb->local_ip, ipaddr); + } + pcb->local_port = port; + TCP_REG(&tcp_bound_pcbs, pcb); + LWIP_DEBUGF(TCP_DEBUG, ("tcp_bind: bind to port %"U16_F"\n", port)); + return ERR_OK; +} +#if LWIP_CALLBACK_API +/** + * Default accept callback if no accept callback is specified by the user. + */ +static err_t +tcp_accept_null(void *arg, struct tcp_pcb *pcb, err_t err) +{ + LWIP_UNUSED_ARG(arg); + LWIP_UNUSED_ARG(err); + + tcp_abort(pcb); + + return ERR_ABRT; +} +#endif /* LWIP_CALLBACK_API */ + +/** + * Set the state of the connection to be LISTEN, which means that it + * is able to accept incoming connections. The protocol control block + * is reallocated in order to consume less memory. Setting the + * connection to LISTEN is an irreversible process. + * + * @param pcb the original tcp_pcb + * @param backlog the incoming connections queue limit + * @return tcp_pcb used for listening, consumes less memory. + * + * @note The original tcp_pcb is freed. This function therefore has to be + * called like this: + * tpcb = tcp_listen(tpcb); + */ +struct tcp_pcb * +tcp_listen_with_backlog(struct tcp_pcb *pcb, u8_t backlog) +{ + struct tcp_pcb_listen *lpcb; + + LWIP_UNUSED_ARG(backlog); + LWIP_ERROR("tcp_listen: pcb already connected", pcb->state == CLOSED, return NULL); + + /* already listening? */ + if (pcb->state == LISTEN) { + return pcb; + } +#if SO_REUSE + if (ip_get_option(pcb, SOF_REUSEADDR)) { + /* Since SOF_REUSEADDR allows reusing a local address before the pcb's usage + is declared (listen-/connection-pcb), we have to make sure now that + this port is only used once for every local IP. */ + for (lpcb = tcp_listen_pcbs.listen_pcbs; lpcb != NULL; lpcb = lpcb->next) { + if ((lpcb->local_port == pcb->local_port) && + ip_addr_cmp(&lpcb->local_ip, &pcb->local_ip)) { + /* this address/port is already used */ + return NULL; + } + } + } +#endif /* SO_REUSE */ + lpcb = (struct tcp_pcb_listen *)memp_malloc(MEMP_TCP_PCB_LISTEN); + if (lpcb == NULL) { + return NULL; + } + lpcb->callback_arg = pcb->callback_arg; + lpcb->local_port = pcb->local_port; + lpcb->state = LISTEN; + lpcb->prio = pcb->prio; + lpcb->so_options = pcb->so_options; + lpcb->ttl = pcb->ttl; + lpcb->tos = pcb->tos; +#if LWIP_IPV4 && LWIP_IPV6 + IP_SET_TYPE_VAL(lpcb->remote_ip, pcb->local_ip.type); +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + ip_addr_copy(lpcb->local_ip, pcb->local_ip); + if (pcb->local_port != 0) { + TCP_RMV(&tcp_bound_pcbs, pcb); + } + memp_free(MEMP_TCP_PCB, pcb); +#if LWIP_CALLBACK_API + lpcb->accept = tcp_accept_null; +#endif /* LWIP_CALLBACK_API */ +#if TCP_LISTEN_BACKLOG + lpcb->accepts_pending = 0; + tcp_backlog_set(lpcb, backlog); +#endif /* TCP_LISTEN_BACKLOG */ + TCP_REG(&tcp_listen_pcbs.pcbs, (struct tcp_pcb *)lpcb); + return (struct tcp_pcb *)lpcb; +} + +/** + * Update the state that tracks the available window space to advertise. + * + * Returns how much extra window would be advertised if we sent an + * update now. + */ +u32_t tcp_update_rcv_ann_wnd(struct tcp_pcb *pcb) +{ + u32_t new_right_edge = pcb->rcv_nxt + pcb->rcv_wnd; + + if (TCP_SEQ_GEQ(new_right_edge, pcb->rcv_ann_right_edge + LWIP_MIN((TCP_WND / 2), pcb->mss))) { + /* we can advertise more window */ + pcb->rcv_ann_wnd = pcb->rcv_wnd; + return new_right_edge - pcb->rcv_ann_right_edge; + } else { + if (TCP_SEQ_GT(pcb->rcv_nxt, pcb->rcv_ann_right_edge)) { + /* Can happen due to other end sending out of advertised window, + * but within actual available (but not yet advertised) window */ + pcb->rcv_ann_wnd = 0; + } else { + /* keep the right edge of window constant */ + u32_t new_rcv_ann_wnd = pcb->rcv_ann_right_edge - pcb->rcv_nxt; +#if !LWIP_WND_SCALE + LWIP_ASSERT("new_rcv_ann_wnd <= 0xffff", new_rcv_ann_wnd <= 0xffff); +#endif + pcb->rcv_ann_wnd = (tcpwnd_size_t)new_rcv_ann_wnd; + } + return 0; + } +} + +/** + * This function should be called by the application when it has + * processed the data. The purpose is to advertise a larger window + * when the data has been processed. + * + * @param pcb the tcp_pcb for which data is read + * @param len the amount of bytes that have been read by the application + */ +void +tcp_recved(struct tcp_pcb *pcb, u16_t len) +{ + int wnd_inflation; + + /* pcb->state LISTEN not allowed here */ + LWIP_ASSERT("don't call tcp_recved for listen-pcbs", + pcb->state != LISTEN); + + pcb->rcv_wnd += len; + if (pcb->rcv_wnd > TCP_WND_MAX(pcb)) { + pcb->rcv_wnd = TCP_WND_MAX(pcb); + } else if (pcb->rcv_wnd == 0) { + /* rcv_wnd overflowed */ + if ((pcb->state == CLOSE_WAIT) || (pcb->state == LAST_ACK)) { + /* In passive close, we allow this, since the FIN bit is added to rcv_wnd + by the stack itself, since it is not mandatory for an application + to call tcp_recved() for the FIN bit, but e.g. the netconn API does so. */ + pcb->rcv_wnd = TCP_WND_MAX(pcb); + } else { + LWIP_ASSERT("tcp_recved: len wrapped rcv_wnd\n", 0); + } + } + + wnd_inflation = tcp_update_rcv_ann_wnd(pcb); + + /* If the change in the right edge of window is significant (default + * watermark is TCP_WND/4), then send an explicit update now. + * Otherwise wait for a packet to be sent in the normal course of + * events (or more window to be available later) */ + if (wnd_inflation >= TCP_WND_UPDATE_THRESHOLD) { + tcp_ack_now(pcb); + tcp_output(pcb); + } + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_recved: received %"U16_F" bytes, wnd %"TCPWNDSIZE_F" (%"TCPWNDSIZE_F").\n", + len, pcb->rcv_wnd, TCP_WND_MAX(pcb) - pcb->rcv_wnd)); +} + +/** + * Allocate a new local TCP port. + * + * @return a new (free) local TCP port number + */ +static u16_t +tcp_new_port(void) +{ + u8_t i; + u16_t n = 0; + struct tcp_pcb *pcb; + +again: + +#ifdef LWIP_ESP8266 + tcp_port = system_get_time(); + if (tcp_port < 0) + tcp_port = LWIP_RAND() - tcp_port; + tcp_port %= TCP_LOCAL_PORT_RANGE_START; +#else + if (tcp_port++ == TCP_LOCAL_PORT_RANGE_END) { + tcp_port = TCP_LOCAL_PORT_RANGE_START; + } +#endif + + /* Check all PCB lists. */ + for (i = 0; i < NUM_TCP_PCB_LISTS; i++) { + for (pcb = *tcp_pcb_lists[i]; pcb != NULL; pcb = pcb->next) { + if (pcb->local_port == tcp_port) { + if (++n > (TCP_LOCAL_PORT_RANGE_END - TCP_LOCAL_PORT_RANGE_START)) { + return 0; + } + goto again; + } + } + } + return tcp_port; +} + +/** + * Connects to another host. The function given as the "connected" + * argument will be called when the connection has been established. + * + * @param pcb the tcp_pcb used to establish the connection + * @param ipaddr the remote ip address to connect to + * @param port the remote tcp port to connect to + * @param connected callback function to call when connected (on error, + the err calback will be called) + * @return ERR_VAL if invalid arguments are given + * ERR_OK if connect request has been sent + * other err_t values if connect request couldn't be sent + */ +err_t +tcp_connect(struct tcp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port, + tcp_connected_fn connected) +{ + err_t ret; + u32_t iss; + u16_t old_local_port; + + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + + LWIP_ERROR("tcp_connect: can only connect from state CLOSED", pcb->state == CLOSED, return ERR_ISCONN); + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_connect to port %"U16_F"\n", port)); + ip_addr_set(&pcb->remote_ip, ipaddr); + pcb->remote_port = port; + + /* check if we have a route to the remote host */ + if (ip_addr_isany(&pcb->local_ip)) { + /* no local IP address set, yet. */ + struct netif *netif; + const ip_addr_t *local_ip; + ip_route_get_local_ip(&pcb->local_ip, &pcb->remote_ip, netif, local_ip); + if ((netif == NULL) || (local_ip == NULL)) { + /* Don't even try to send a SYN packet if we have no route + since that will fail. */ + return ERR_RTE; + } + /* Use the address as local address of the pcb. */ + ip_addr_copy(pcb->local_ip, *local_ip); + } + + old_local_port = pcb->local_port; + if (pcb->local_port == 0) { + pcb->local_port = tcp_new_port(); + if (pcb->local_port == 0) { + return ERR_BUF; + } + } else { +#if SO_REUSE + if (ip_get_option(pcb, SOF_REUSEADDR)) { + /* Since SOF_REUSEADDR allows reusing a local address, we have to make sure + now that the 5-tuple is unique. */ + struct tcp_pcb *cpcb; + int i; + /* Don't check listen- and bound-PCBs, check active- and TIME-WAIT PCBs. */ + for (i = 2; i < NUM_TCP_PCB_LISTS; i++) { + for (cpcb = *tcp_pcb_lists[i]; cpcb != NULL; cpcb = cpcb->next) { + if ((cpcb->local_port == pcb->local_port) && + (cpcb->remote_port == port) && + ip_addr_cmp(&cpcb->local_ip, &pcb->local_ip) && + ip_addr_cmp(&cpcb->remote_ip, ipaddr)) { + /* linux returns EISCONN here, but ERR_USE should be OK for us */ + return ERR_USE; + } + } + } + } +#endif /* SO_REUSE */ + } + + iss = tcp_next_iss(); + pcb->rcv_nxt = 0; + pcb->snd_nxt = iss; + pcb->lastack = iss - 1; + pcb->snd_lbb = iss - 1; + /* Start with a window that does not need scaling. When window scaling is + enabled and used, the window is enlarged when both sides agree on scaling. */ + pcb->rcv_wnd = pcb->rcv_ann_wnd = TCPWND_MIN16(TCP_WND); + pcb->rcv_ann_right_edge = pcb->rcv_nxt; + pcb->snd_wnd = TCP_WND; + /* As initial send MSS, we use TCP_MSS but limit it to 536. + The send MSS is updated when an MSS option is received. */ + pcb->mss = (TCP_MSS > 536) ? 536 : TCP_MSS; +#if TCP_CALCULATE_EFF_SEND_MSS + pcb->mss = tcp_eff_send_mss(pcb->mss, &pcb->local_ip, &pcb->remote_ip); +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + pcb->cwnd = 1; + pcb->ssthresh = TCP_WND; +#if LWIP_CALLBACK_API + pcb->connected = connected; +#else /* LWIP_CALLBACK_API */ + LWIP_UNUSED_ARG(connected); +#endif /* LWIP_CALLBACK_API */ + + /* Send a SYN together with the MSS option. */ + ret = tcp_enqueue_flags(pcb, TCP_SYN); + if (ret == ERR_OK) { + /* SYN segment was enqueued, changed the pcbs state now */ + pcb->state = SYN_SENT; + if (old_local_port != 0) { + TCP_RMV(&tcp_bound_pcbs, pcb); + } + TCP_REG_ACTIVE(pcb); + MIB2_STATS_INC(mib2.tcpactiveopens); + + tcp_output(pcb); + } + return ret; +} + +/** + * Called every 500 ms and implements the retransmission timer and the timer that + * removes PCBs that have been in TIME-WAIT for enough time. It also increments + * various timers such as the inactivity timer in each PCB. + * + * Automatically called from tcp_tmr(). + */ +void +tcp_slowtmr(void) +{ + struct tcp_pcb *pcb, *prev; + tcpwnd_size_t eff_wnd; + u8_t pcb_remove; /* flag if a PCB should be removed */ + u8_t pcb_reset; /* flag if a RST should be sent when removing */ + err_t err; + + err = ERR_OK; + + ++tcp_ticks; + ++tcp_timer_ctr; + +tcp_slowtmr_start: + /* Steps through all of the active PCBs. */ + prev = NULL; + pcb = tcp_active_pcbs; + if (pcb == NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: no active pcbs\n")); + } + while (pcb != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: processing active pcb\n")); + LWIP_ASSERT("tcp_slowtmr: active pcb->state != CLOSED\n", pcb->state != CLOSED); + LWIP_ASSERT("tcp_slowtmr: active pcb->state != LISTEN\n", pcb->state != LISTEN); + LWIP_ASSERT("tcp_slowtmr: active pcb->state != TIME-WAIT\n", pcb->state != TIME_WAIT); + if (pcb->last_timer == tcp_timer_ctr) { + /* skip this pcb, we have already processed it */ + pcb = pcb->next; + continue; + } + pcb->last_timer = tcp_timer_ctr; + + pcb_remove = 0; + pcb_reset = 0; + + if (pcb->state == SYN_SENT && pcb->nrtx == TCP_SYNMAXRTX) { + ++pcb_remove; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: max SYN retries reached\n")); + } + else if (pcb->nrtx == TCP_MAXRTX) { + ++pcb_remove; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: max DATA retries reached\n")); + } else { + if (pcb->persist_backoff > 0) { + + /* If snd_wnd is zero, use persist timer to send 1 byte probes + * instead of using the standard retransmission mechanism. */ +#ifdef LWIP_ESP8266 +//NEED TO DO + //u8_t backoff_cnt = system_get_data_of_array_8(tcp_persist_backoff, pcb->persist_backoff-1); + u8_t backoff_cnt = tcp_persist_backoff[pcb->persist_backoff-1]; +#else + u8_t backoff_cnt = tcp_persist_backoff[pcb->persist_backoff-1]; +#endif + + if (pcb->persist_cnt < backoff_cnt) { + pcb->persist_cnt++; + } + if (pcb->persist_cnt >= backoff_cnt) { + if (tcp_zero_window_probe(pcb) == ERR_OK) { + pcb->persist_cnt = 0; + if (pcb->persist_backoff < sizeof(tcp_persist_backoff)) { + pcb->persist_backoff++; + } + } + } + } else { + /* Increase the retransmission timer if it is running */ + if (pcb->rtime >= 0) { + ++pcb->rtime; + } + + if (pcb->unacked != NULL && pcb->rtime >= pcb->rto) { + /* Time for a retransmission. */ + LWIP_DEBUGF(TCP_RTO_DEBUG, ("tcp_slowtmr: rtime %"S16_F + " pcb->rto %"S16_F"\n", + pcb->rtime, pcb->rto)); + + /* Double retransmission time-out unless we are trying to + * connect to somebody (i.e., we are in SYN_SENT). */ + if (pcb->state != SYN_SENT) { + +#ifdef LWIP_ESP8266 +//TO_DO +// pcb->rto = ((pcb->sa >> 3) + pcb->sv) << system_get_data_of_array_8(tcp_backoff, pcb->nrtx); + pcb->rto = ((pcb->sa >> 3) + pcb->sv) << tcp_backoff[pcb->nrtx]; +#else + pcb->rto = ((pcb->sa >> 3) + pcb->sv) << tcp_backoff[pcb->nrtx]; +#endif + + } + + /* Reset the retransmission timer. */ + pcb->rtime = 0; + + /* Reduce congestion window and ssthresh. */ + eff_wnd = LWIP_MIN(pcb->cwnd, pcb->snd_wnd); + pcb->ssthresh = eff_wnd >> 1; + if (pcb->ssthresh < (tcpwnd_size_t)(pcb->mss << 1)) { + pcb->ssthresh = (pcb->mss << 1); + } + pcb->cwnd = pcb->mss; + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_slowtmr: cwnd %"TCPWNDSIZE_F + " ssthresh %"TCPWNDSIZE_F"\n", + pcb->cwnd, pcb->ssthresh)); + + /* The following needs to be called AFTER cwnd is set to one + mss - STJ */ + tcp_rexmit_rto(pcb); + } + } + } + /* Check if this PCB has stayed too long in FIN-WAIT-2 */ + if (pcb->state == FIN_WAIT_2) { + /* If this PCB is in FIN_WAIT_2 because of SHUT_WR don't let it time out. */ + if (pcb->flags & TF_RXCLOSED) { + /* PCB was fully closed (either through close() or SHUT_RDWR): + normal FIN-WAIT timeout handling. */ + if ((u32_t)(tcp_ticks - pcb->tmr) > + TCP_FIN_WAIT_TIMEOUT / TCP_SLOW_INTERVAL) { + ++pcb_remove; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: removing pcb stuck in FIN-WAIT-2\n")); + } + } + } + + /* Check if KEEPALIVE should be sent */ + if (ip_get_option(pcb, SOF_KEEPALIVE) && + ((pcb->state == ESTABLISHED) || + (pcb->state == CLOSE_WAIT))) { + if ((u32_t)(tcp_ticks - pcb->tmr) > + (pcb->keep_idle + TCP_KEEP_DUR(pcb)) / TCP_SLOW_INTERVAL) + { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: KEEPALIVE timeout. Aborting connection to ")); + ip_addr_debug_print(TCP_DEBUG, &pcb->remote_ip); + LWIP_DEBUGF(TCP_DEBUG, ("\n")); + + ++pcb_remove; + ++pcb_reset; + } else if ((u32_t)(tcp_ticks - pcb->tmr) > + (pcb->keep_idle + pcb->keep_cnt_sent * TCP_KEEP_INTVL(pcb)) + / TCP_SLOW_INTERVAL) + { + err = tcp_keepalive(pcb); + if (err == ERR_OK) { + pcb->keep_cnt_sent++; + } + } + } + + /* If this PCB has queued out of sequence data, but has been + inactive for too long, will drop the data (it will eventually + be retransmitted). */ +#if TCP_QUEUE_OOSEQ + if (pcb->ooseq != NULL && + (u32_t)tcp_ticks - pcb->tmr >= pcb->rto * TCP_OOSEQ_TIMEOUT) { + tcp_segs_free(pcb->ooseq); + pcb->ooseq = NULL; + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_slowtmr: dropping OOSEQ queued data\n")); + } +#endif /* TCP_QUEUE_OOSEQ */ + + /* Check if this PCB has stayed too long in SYN-RCVD */ + if (pcb->state == SYN_RCVD) { + if ((u32_t)(tcp_ticks - pcb->tmr) > + TCP_SYN_RCVD_TIMEOUT / TCP_SLOW_INTERVAL) { + ++pcb_remove; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: removing pcb stuck in SYN-RCVD\n")); + } + } + + /* Check if this PCB has stayed too long in LAST-ACK */ + if (pcb->state == LAST_ACK) { + if ((u32_t)(tcp_ticks - pcb->tmr) > 2 * TCP_MSL / TCP_SLOW_INTERVAL) { + ++pcb_remove; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: removing pcb stuck in LAST-ACK\n")); + } + } + + /* If the PCB should be removed, do it. */ + if (pcb_remove) { + struct tcp_pcb *pcb2; + tcp_err_fn err_fn; + void *err_arg; + tcp_pcb_purge(pcb); + /* Remove PCB from tcp_active_pcbs list. */ + if (prev != NULL) { + LWIP_ASSERT("tcp_slowtmr: middle tcp != tcp_active_pcbs", pcb != tcp_active_pcbs); + prev->next = pcb->next; + } else { + /* This PCB was the first. */ + LWIP_ASSERT("tcp_slowtmr: first pcb == tcp_active_pcbs", tcp_active_pcbs == pcb); + tcp_active_pcbs = pcb->next; + } + + if (pcb_reset) { + tcp_rst(pcb->snd_nxt, pcb->rcv_nxt, &pcb->local_ip, &pcb->remote_ip, + pcb->local_port, pcb->remote_port); + } + + err_fn = pcb->errf; + err_arg = pcb->callback_arg; + pcb2 = pcb; + pcb = pcb->next; + memp_free(MEMP_TCP_PCB, pcb2); + + tcp_active_pcbs_changed = 0; + TCP_EVENT_ERR(err_fn, err_arg, ERR_ABRT); + if (tcp_active_pcbs_changed) { + goto tcp_slowtmr_start; + } + } else { + /* get the 'next' element now and work with 'prev' below (in case of abort) */ + prev = pcb; + pcb = pcb->next; + + /* We check if we should poll the connection. */ + ++prev->polltmr; + if (prev->polltmr >= prev->pollinterval) { + prev->polltmr = 0; + LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: polling application\n")); + tcp_active_pcbs_changed = 0; + TCP_EVENT_POLL(prev, err); + if (tcp_active_pcbs_changed) { + goto tcp_slowtmr_start; + } + /* if err == ERR_ABRT, 'prev' is already deallocated */ + if (err == ERR_OK) { + tcp_output(prev); + } + } + } + } + + + /* Steps through all of the TIME-WAIT PCBs. */ + prev = NULL; + pcb = tcp_tw_pcbs; + while (pcb != NULL) { + LWIP_ASSERT("tcp_slowtmr: TIME-WAIT pcb->state == TIME-WAIT", pcb->state == TIME_WAIT); + pcb_remove = 0; + + /* Check if this PCB has stayed long enough in TIME-WAIT */ + if ((u32_t)(tcp_ticks - pcb->tmr) > 2 * TCP_MSL / TCP_SLOW_INTERVAL) { + ++pcb_remove; + } + + /* If the PCB should be removed, do it. */ + if (pcb_remove) { + struct tcp_pcb *pcb2; + tcp_pcb_purge(pcb); + /* Remove PCB from tcp_tw_pcbs list. */ + if (prev != NULL) { + LWIP_ASSERT("tcp_slowtmr: middle tcp != tcp_tw_pcbs", pcb != tcp_tw_pcbs); + prev->next = pcb->next; + } else { + /* This PCB was the first. */ + LWIP_ASSERT("tcp_slowtmr: first pcb == tcp_tw_pcbs", tcp_tw_pcbs == pcb); + tcp_tw_pcbs = pcb->next; + } + pcb2 = pcb; + pcb = pcb->next; + memp_free(MEMP_TCP_PCB, pcb2); + } else { + prev = pcb; + pcb = pcb->next; + } + } +} + +/** + * Is called every TCP_FAST_INTERVAL (250 ms) and process data previously + * "refused" by upper layer (application) and sends delayed ACKs. + * + * Automatically called from tcp_tmr(). + */ +void +tcp_fasttmr(void) +{ + struct tcp_pcb *pcb; + + ++tcp_timer_ctr; + +tcp_fasttmr_start: + pcb = tcp_active_pcbs; + + while (pcb != NULL) { + if (pcb->last_timer != tcp_timer_ctr) { + struct tcp_pcb *next; + pcb->last_timer = tcp_timer_ctr; + /* send delayed ACKs */ + if (pcb->flags & TF_ACK_DELAY) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_fasttmr: delayed ACK\n")); + tcp_ack_now(pcb); + tcp_output(pcb); + pcb->flags &= ~(TF_ACK_DELAY | TF_ACK_NOW); + } + + next = pcb->next; + + /* If there is data which was previously "refused" by upper layer */ + if (pcb->refused_data != NULL) { + tcp_active_pcbs_changed = 0; + tcp_process_refused_data(pcb); + if (tcp_active_pcbs_changed) { + /* application callback has changed the pcb list: restart the loop */ + goto tcp_fasttmr_start; + } + } + pcb = next; + } else { + pcb = pcb->next; + } + } +} + +/** Call tcp_output for all active pcbs that have TF_NAGLEMEMERR set */ +void +tcp_txnow(void) +{ + struct tcp_pcb *pcb; + + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->flags & TF_NAGLEMEMERR) { + tcp_output(pcb); + } + } +} + +/** Pass pcb->refused_data to the recv callback */ +err_t +tcp_process_refused_data(struct tcp_pcb *pcb) +{ +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + struct pbuf *rest; + while (pcb->refused_data != NULL) +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + { + err_t err; + u8_t refused_flags = pcb->refused_data->flags; + /* set pcb->refused_data to NULL in case the callback frees it and then + closes the pcb */ + struct pbuf *refused_data = pcb->refused_data; +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + pbuf_split_64k(refused_data, &rest); + pcb->refused_data = rest; +#else /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + pcb->refused_data = NULL; +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + /* Notify again application with data previously received. */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: notify kept packet\n")); + TCP_EVENT_RECV(pcb, refused_data, ERR_OK, err); + if (err == ERR_OK) { + /* did refused_data include a FIN? */ + if (refused_flags & PBUF_FLAG_TCP_FIN +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + && (rest == NULL) +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + ) { + /* correct rcv_wnd as the application won't call tcp_recved() + for the FIN's seqno */ + if (pcb->rcv_wnd != TCP_WND_MAX(pcb)) { + pcb->rcv_wnd++; + } + TCP_EVENT_CLOSED(pcb, err); + if (err == ERR_ABRT) { + return ERR_ABRT; + } + } + } else if (err == ERR_ABRT) { + /* if err == ERR_ABRT, 'pcb' is already deallocated */ + /* Drop incoming packets because pcb is "full" (only if the incoming + segment contains data). */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: drop incoming packets, because pcb is \"full\"\n")); + return ERR_ABRT; + } else { + /* data is still refused, pbuf is still valid (go on for ACK-only packets) */ +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + if (rest != NULL) { + pbuf_cat(refused_data, rest); + } +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + pcb->refused_data = refused_data; + return ERR_INPROGRESS; + } + } + return ERR_OK; +} + +/** + * Deallocates a list of TCP segments (tcp_seg structures). + * + * @param seg tcp_seg list of TCP segments to free + */ +void +tcp_segs_free(struct tcp_seg *seg) +{ + while (seg != NULL) { + struct tcp_seg *next = seg->next; + tcp_seg_free(seg); + seg = next; + } +} + +/** + * Frees a TCP segment (tcp_seg structure). + * + * @param seg single tcp_seg to free + */ +void +tcp_seg_free(struct tcp_seg *seg) +{ + if (seg != NULL) { + if (seg->p != NULL) { + pbuf_free(seg->p); +#if TCP_DEBUG + seg->p = NULL; +#endif /* TCP_DEBUG */ + } + memp_free(MEMP_TCP_SEG, seg); + } +} + +/** + * Sets the priority of a connection. + * + * @param pcb the tcp_pcb to manipulate + * @param prio new priority + */ +void +tcp_setprio(struct tcp_pcb *pcb, u8_t prio) +{ + pcb->prio = prio; +} + +#if TCP_QUEUE_OOSEQ +/** + * Returns a copy of the given TCP segment. + * The pbuf and data are not copied, only the pointers + * + * @param seg the old tcp_seg + * @return a copy of seg + */ +struct tcp_seg * +tcp_seg_copy(struct tcp_seg *seg) +{ + struct tcp_seg *cseg; + + cseg = (struct tcp_seg *)memp_malloc(MEMP_TCP_SEG); + if (cseg == NULL) { + return NULL; + } + SMEMCPY((u8_t *)cseg, (const u8_t *)seg, sizeof(struct tcp_seg)); + pbuf_ref(cseg->p); + return cseg; +} +#endif /* TCP_QUEUE_OOSEQ */ + +#if LWIP_CALLBACK_API +/** + * Default receive callback that is called if the user didn't register + * a recv callback for the pcb. + */ +err_t +tcp_recv_null(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) +{ + LWIP_UNUSED_ARG(arg); + if (p != NULL) { + tcp_recved(pcb, p->tot_len); + pbuf_free(p); + } else if (err == ERR_OK) { + return tcp_close(pcb); + } + return ERR_OK; +} +#endif /* LWIP_CALLBACK_API */ + +/** + * Kills the oldest active connection that has the same or lower priority than + * 'prio'. + * + * @param prio minimum priority + */ +static void +tcp_kill_prio(u8_t prio) +{ + struct tcp_pcb *pcb, *inactive; + u32_t inactivity; + u8_t mprio; + + mprio = LWIP_MIN(TCP_PRIO_MAX, prio); + + /* We kill the oldest active connection that has lower priority than prio. */ + inactivity = 0; + inactive = NULL; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->prio <= mprio && + (u32_t)(tcp_ticks - pcb->tmr) >= inactivity) { + inactivity = tcp_ticks - pcb->tmr; + inactive = pcb; + mprio = pcb->prio; + } + } + if (inactive != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_kill_prio: killing oldest PCB %p (%"S32_F")\n", + (void *)inactive, inactivity)); + tcp_abort(inactive); + } +} + +/** + * Kills the oldest connection that is in specific state. + * Called from tcp_alloc() for LAST_ACK and CLOSING if no more connections are available. + */ +static void +tcp_kill_state(enum tcp_state state) +{ + struct tcp_pcb *pcb, *inactive; + u32_t inactivity; + + LWIP_ASSERT("invalid state", (state == CLOSING) || (state == LAST_ACK)); + + inactivity = 0; + inactive = NULL; + /* Go through the list of active pcbs and get the oldest pcb that is in state + CLOSING/LAST_ACK. */ + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->state == state) { + if ((u32_t)(tcp_ticks - pcb->tmr) >= inactivity) { + inactivity = tcp_ticks - pcb->tmr; + inactive = pcb; + } + } + } + if (inactive != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_kill_closing: killing oldest %s PCB %p (%"S32_F")\n", + tcp_state_str[state], (void *)inactive, inactivity)); + /* Don't send a RST, since no data is lost. */ + tcp_abandon(inactive, 0); + } +} + +/** + * Kills the oldest connection that is in TIME_WAIT state. + * Called from tcp_alloc() if no more connections are available. + */ +static void +tcp_kill_timewait(void) +{ + struct tcp_pcb *pcb, *inactive; + u32_t inactivity; + + inactivity = 0; + inactive = NULL; + /* Go through the list of TIME_WAIT pcbs and get the oldest pcb. */ + for (pcb = tcp_tw_pcbs; pcb != NULL; pcb = pcb->next) { + if ((u32_t)(tcp_ticks - pcb->tmr) >= inactivity) { + inactivity = tcp_ticks - pcb->tmr; + inactive = pcb; + } + } + if (inactive != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_kill_timewait: killing oldest TIME-WAIT PCB %p (%"S32_F")\n", + (void *)inactive, inactivity)); + tcp_abort(inactive); + } +} + +#ifdef LWIP_ESP8266 +/** + * Kills the oldest connection that is in FIN_WAIT_2 state. + * Called from tcp_alloc() if no more connections are available. + */ +static void tcp_kill_finwait2(void) +{ + struct tcp_pcb *pcb, *inactive; + u32_t inactivity; + /* Go through the list of FIN_WAIT_2 pcbs and get the oldest pcb. */ + inactivity = 0; + inactive = NULL; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->state == FIN_WAIT_2) { + if ((u32_t) (tcp_ticks - pcb->tmr) >= inactivity) { + inactivity = tcp_ticks - pcb->tmr; + inactive = pcb; + } + } + } + if (inactive != NULL) { + tcp_pcb_remove(&tcp_active_pcbs, inactive); + memp_free(MEMP_TCP_PCB, inactive); + } +} + +/** + * Kills the oldest connection that is in LAST_ACK state. + * Called from tcp_alloc() if no more connections are available. + */ +static void tcp_kill_lastack(void) +{ + struct tcp_pcb *pcb, *inactive; + u32_t inactivity; + /* Go through the list of LAST_ACK pcbs and get the oldest pcb. */ + inactivity = 0; + inactive = NULL; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->state == LAST_ACK) { + if ((u32_t) (tcp_ticks - pcb->tmr) >= inactivity) { + inactivity = tcp_ticks - pcb->tmr; + inactive = pcb; + } + } + } + if (inactive != NULL) { + tcp_pcb_remove(&tcp_active_pcbs, inactive); + memp_free(MEMP_TCP_PCB, inactive); + } +} +#endif + + + +/** + * Allocate a new tcp_pcb structure. + * + * @param prio priority for the new pcb + * @return a new tcp_pcb that initially is in state CLOSED + */ +struct tcp_pcb * +tcp_alloc(u8_t prio) +{ + struct tcp_pcb *pcb; + u32_t iss; + +#ifdef LWIP_ESP8266 + /*Kills the oldest connection that is in TIME_WAIT state.*/ + u8_t time_wait_num = 0; + for(pcb = tcp_tw_pcbs; pcb != NULL; pcb = pcb->next) { + time_wait_num ++; + } + + if (time_wait_num >= MEMP_NUM_TCP_PCB) + tcp_kill_timewait(); + + /*Kills the oldest connection that is in FIN_WAIT_2 state.*/ + time_wait_num = 0; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next){ + if (pcb->state == FIN_WAIT_2) + time_wait_num ++; + } + + if (time_wait_num >= MEMP_NUM_TCP_PCB) + tcp_kill_finwait2(); + + /*Kills the oldest connection that is in LAST_ACK state.*/ + time_wait_num = 0; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next){ + if (pcb->state == LAST_ACK) + time_wait_num ++; + } + + if (time_wait_num >= MEMP_NUM_TCP_PCB) + tcp_kill_lastack(); +#endif + + pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB); + if (pcb == NULL) { + /* Try killing oldest connection in TIME-WAIT. */ + LWIP_DEBUGF(TCP_DEBUG, ("tcp_alloc: killing off oldest TIME-WAIT connection\n")); + tcp_kill_timewait(); + /* Try to allocate a tcp_pcb again. */ + pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB); + if (pcb == NULL) { + /* Try killing oldest connection in LAST-ACK (these wouldn't go to TIME-WAIT). */ + LWIP_DEBUGF(TCP_DEBUG, ("tcp_alloc: killing off oldest LAST-ACK connection\n")); + tcp_kill_state(LAST_ACK); + /* Try to allocate a tcp_pcb again. */ + pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB); + if (pcb == NULL) { + /* Try killing oldest connection in CLOSING. */ + LWIP_DEBUGF(TCP_DEBUG, ("tcp_alloc: killing off oldest CLOSING connection\n")); + tcp_kill_state(CLOSING); + /* Try to allocate a tcp_pcb again. */ + pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB); + if (pcb == NULL) { + /* Try killing active connections with lower priority than the new one. */ + LWIP_DEBUGF(TCP_DEBUG, ("tcp_alloc: killing connection with prio lower than %d\n", prio)); + tcp_kill_prio(prio); + /* Try to allocate a tcp_pcb again. */ + pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB); + if (pcb != NULL) { + /* adjust err stats: memp_malloc failed multiple times before */ + MEMP_STATS_DEC(err, MEMP_TCP_PCB); + } + } + if (pcb != NULL) { + /* adjust err stats: memp_malloc failed multiple times before */ + MEMP_STATS_DEC(err, MEMP_TCP_PCB); + } + } + if (pcb != NULL) { + /* adjust err stats: memp_malloc failed multiple times before */ + MEMP_STATS_DEC(err, MEMP_TCP_PCB); + } + } + if (pcb != NULL) { + /* adjust err stats: memp_malloc failed above */ + MEMP_STATS_DEC(err, MEMP_TCP_PCB); + } + } + if (pcb != NULL) { + memset(pcb, 0, sizeof(struct tcp_pcb)); + pcb->prio = prio; + pcb->snd_buf = TCP_SND_BUF; + pcb->snd_queuelen = 0; + /* Start with a window that does not need scaling. When window scaling is + enabled and used, the window is enlarged when both sides agree on scaling. */ + pcb->rcv_wnd = pcb->rcv_ann_wnd = TCPWND_MIN16(TCP_WND); +#if LWIP_WND_SCALE + /* snd_scale and rcv_scale are zero unless both sides agree to use scaling */ + pcb->snd_scale = 0; + pcb->rcv_scale = 0; +#endif + pcb->tos = 0; + pcb->ttl = TCP_TTL; + /* As initial send MSS, we use TCP_MSS but limit it to 536. + The send MSS is updated when an MSS option is received. */ + pcb->mss = (TCP_MSS > 536) ? 536 : TCP_MSS; + pcb->rto = 3000 / TCP_SLOW_INTERVAL; + pcb->sa = 0; + pcb->sv = 3000 / TCP_SLOW_INTERVAL; + pcb->rtime = -1; + pcb->cwnd = 1; + iss = tcp_next_iss(); + pcb->snd_wl2 = iss; + pcb->snd_nxt = iss; + pcb->lastack = iss; + pcb->snd_lbb = iss; + pcb->tmr = tcp_ticks; + pcb->last_timer = tcp_timer_ctr; + + pcb->polltmr = 0; + +#if LWIP_CALLBACK_API + pcb->recv = tcp_recv_null; +#endif /* LWIP_CALLBACK_API */ + + /* Init KEEPALIVE timer */ + pcb->keep_idle = TCP_KEEPIDLE_DEFAULT; + +#if LWIP_TCP_KEEPALIVE + pcb->keep_intvl = TCP_KEEPINTVL_DEFAULT; + pcb->keep_cnt = TCP_KEEPCNT_DEFAULT; +#endif /* LWIP_TCP_KEEPALIVE */ + + pcb->keep_cnt_sent = 0; + } + return pcb; +} + +/** + * Creates a new TCP protocol control block but doesn't place it on + * any of the TCP PCB lists. + * The pcb is not put on any list until binding using tcp_bind(). + * + * @internal: Maybe there should be a idle TCP PCB list where these + * PCBs are put on. Port reservation using tcp_bind() is implemented but + * allocated pcbs that are not bound can't be killed automatically if wanting + * to allocate a pcb with higher prio (@see tcp_kill_prio()) + * + * @return a new tcp_pcb that initially is in state CLOSED + */ +struct tcp_pcb * +tcp_new(void) +{ + return tcp_alloc(TCP_PRIO_NORMAL); +} + +/** + * Creates a new TCP protocol control block but doesn't + * place it on any of the TCP PCB lists. + * The pcb is not put on any list until binding using tcp_bind(). + * + * @param type IP address type, see IPADDR_TYPE_XX definitions. + * @return a new tcp_pcb that initially is in state CLOSED + */ +struct tcp_pcb * +tcp_new_ip_type(u8_t type) +{ + struct tcp_pcb * pcb; + pcb = tcp_alloc(TCP_PRIO_NORMAL); +#if LWIP_IPV4 && LWIP_IPV6 + if(pcb != NULL) { + IP_SET_TYPE_VAL(pcb->local_ip, type); + IP_SET_TYPE_VAL(pcb->remote_ip, type); + } +#else + LWIP_UNUSED_ARG(type); +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + return pcb; +} + +/** + * Used to specify the argument that should be passed callback + * functions. + * + * @param pcb tcp_pcb to set the callback argument + * @param arg void pointer argument to pass to callback functions + */ +void +tcp_arg(struct tcp_pcb *pcb, void *arg) +{ + /* This function is allowed to be called for both listen pcbs and + connection pcbs. */ + pcb->callback_arg = arg; +} +#if LWIP_CALLBACK_API + +/** + * Used to specify the function that should be called when a TCP + * connection receives data. + * + * @param pcb tcp_pcb to set the recv callback + * @param recv callback function to call for this pcb when data is received + */ +void +tcp_recv(struct tcp_pcb *pcb, tcp_recv_fn recv) +{ + LWIP_ASSERT("invalid socket state for recv callback", pcb->state != LISTEN); + pcb->recv = recv; +} + +/** + * Used to specify the function that should be called when TCP data + * has been successfully delivered to the remote host. + * + * @param pcb tcp_pcb to set the sent callback + * @param sent callback function to call for this pcb when data is successfully sent + */ +void +tcp_sent(struct tcp_pcb *pcb, tcp_sent_fn sent) +{ + LWIP_ASSERT("invalid socket state for sent callback", pcb->state != LISTEN); + pcb->sent = sent; +} + +/** + * Used to specify the function that should be called when a fatal error + * has occurred on the connection. + * + * @param pcb tcp_pcb to set the err callback + * @param err callback function to call for this pcb when a fatal error + * has occurred on the connection + */ +void +tcp_err(struct tcp_pcb *pcb, tcp_err_fn err) +{ + LWIP_ASSERT("invalid socket state for err callback", pcb->state != LISTEN); + pcb->errf = err; +} + +/** + * Used for specifying the function that should be called when a + * LISTENing connection has been connected to another host. + * + * @param pcb tcp_pcb to set the accept callback + * @param accept callback function to call for this pcb when LISTENing + * connection has been connected to another host + */ +void +tcp_accept(struct tcp_pcb *pcb, tcp_accept_fn accept) +{ + /* This function is allowed to be called for both listen pcbs and + connection pcbs. */ + pcb->accept = accept; +} +#endif /* LWIP_CALLBACK_API */ + + +/** + * Used to specify the function that should be called periodically + * from TCP. The interval is specified in terms of the TCP coarse + * timer interval, which is called twice a second. + * + */ +void +tcp_poll(struct tcp_pcb *pcb, tcp_poll_fn poll, u8_t interval) +{ + LWIP_ASSERT("invalid socket state for poll", pcb->state != LISTEN); +#if LWIP_CALLBACK_API + pcb->poll = poll; +#else /* LWIP_CALLBACK_API */ + LWIP_UNUSED_ARG(poll); +#endif /* LWIP_CALLBACK_API */ + pcb->pollinterval = interval; +} + +/** + * Purges a TCP PCB. Removes any buffered data and frees the buffer memory + * (pcb->ooseq, pcb->unsent and pcb->unacked are freed). + * + * @param pcb tcp_pcb to purge. The pcb itself is not deallocated! + */ +void +tcp_pcb_purge(struct tcp_pcb *pcb) +{ + if (pcb->state != CLOSED && + pcb->state != TIME_WAIT && + pcb->state != LISTEN) { + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_pcb_purge\n")); + +#if TCP_LISTEN_BACKLOG + if (pcb->state == SYN_RCVD) { + /* Need to find the corresponding listen_pcb and decrease its accepts_pending */ + struct tcp_pcb_listen *lpcb; + LWIP_ASSERT("tcp_pcb_purge: pcb->state == SYN_RCVD but tcp_listen_pcbs is NULL", + tcp_listen_pcbs.listen_pcbs != NULL); + for (lpcb = tcp_listen_pcbs.listen_pcbs; lpcb != NULL; lpcb = lpcb->next) { + if ((lpcb->local_port == pcb->local_port) && + (IP_IS_V6_VAL(pcb->local_ip) == IP_IS_V6_VAL(lpcb->local_ip)) && + (ip_addr_isany(&lpcb->local_ip) || + ip_addr_cmp(&pcb->local_ip, &lpcb->local_ip))) { + /* port and address of the listen pcb match the timed-out pcb */ + LWIP_ASSERT("tcp_pcb_purge: listen pcb does not have accepts pending", + lpcb->accepts_pending > 0); + lpcb->accepts_pending--; + break; + } + } + } +#endif /* TCP_LISTEN_BACKLOG */ + + + if (pcb->refused_data != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_pcb_purge: data left on ->refused_data\n")); + pbuf_free(pcb->refused_data); + pcb->refused_data = NULL; + } + if (pcb->unsent != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_pcb_purge: not all data sent\n")); + } + if (pcb->unacked != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_pcb_purge: data left on ->unacked\n")); + } +#if TCP_QUEUE_OOSEQ + if (pcb->ooseq != NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_pcb_purge: data left on ->ooseq\n")); + } + tcp_segs_free(pcb->ooseq); + pcb->ooseq = NULL; +#endif /* TCP_QUEUE_OOSEQ */ + + /* Stop the retransmission timer as it will expect data on unacked + queue if it fires */ + pcb->rtime = -1; + + tcp_segs_free(pcb->unsent); + tcp_segs_free(pcb->unacked); + pcb->unacked = pcb->unsent = NULL; +#if TCP_OVERSIZE + pcb->unsent_oversize = 0; +#endif /* TCP_OVERSIZE */ + } +} + +/** + * Purges the PCB and removes it from a PCB list. Any delayed ACKs are sent first. + * + * @param pcblist PCB list to purge. + * @param pcb tcp_pcb to purge. The pcb itself is NOT deallocated! + */ +void +tcp_pcb_remove(struct tcp_pcb **pcblist, struct tcp_pcb *pcb) +{ + TCP_RMV(pcblist, pcb); + + tcp_pcb_purge(pcb); + + /* if there is an outstanding delayed ACKs, send it */ + if (pcb->state != TIME_WAIT && + pcb->state != LISTEN && + pcb->flags & TF_ACK_DELAY) { + pcb->flags |= TF_ACK_NOW; + tcp_output(pcb); + } + + if (pcb->state != LISTEN) { + LWIP_ASSERT("unsent segments leaking", pcb->unsent == NULL); + LWIP_ASSERT("unacked segments leaking", pcb->unacked == NULL); +#if TCP_QUEUE_OOSEQ + LWIP_ASSERT("ooseq segments leaking", pcb->ooseq == NULL); +#endif /* TCP_QUEUE_OOSEQ */ + } + + pcb->state = CLOSED; + /* reset the local port to prevent the pcb from being 'bound' */ + pcb->local_port = 0; + + LWIP_ASSERT("tcp_pcb_remove: tcp_pcbs_sane()", tcp_pcbs_sane()); +} + +/** + * Calculates a new initial sequence number for new connections. + * + * @return u32_t pseudo random sequence number + */ +u32_t +tcp_next_iss(void) +{ + static u32_t iss = 6510; + + iss += tcp_ticks; /* XXX */ + return iss; +} + +#if TCP_CALCULATE_EFF_SEND_MSS +/** + * Calculates the effective send mss that can be used for a specific IP address + * by using ip_route to determine the netif used to send to the address and + * calculating the minimum of TCP_MSS and that netif's mtu (if set). + */ +u16_t +tcp_eff_send_mss_impl(u16_t sendmss, const ip_addr_t *dest +#if LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING + , const ip_addr_t *src +#endif /* LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING */ + ) +{ + u16_t mss_s; + struct netif *outif; + s16_t mtu; + + outif = ip_route(src, dest); +#if LWIP_IPV6 +#if LWIP_IPV4 + if (IP_IS_V6(dest)) +#endif /* LWIP_IPV4 */ + { + /* First look in destination cache, to see if there is a Path MTU. */ + mtu = nd6_get_destination_mtu(ip_2_ip6(dest), outif); + } +#if LWIP_IPV4 + else +#endif /* LWIP_IPV4 */ +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 + { + if (outif == NULL) { + return sendmss; + } + mtu = outif->mtu; + } +#endif /* LWIP_IPV4 */ + + if (mtu != 0) { +#if LWIP_IPV6 +#if LWIP_IPV4 + if (IP_IS_V6(dest)) +#endif /* LWIP_IPV4 */ + { + mss_s = mtu - IP6_HLEN - TCP_HLEN; + } +#if LWIP_IPV4 + else +#endif /* LWIP_IPV4 */ +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 + { + mss_s = mtu - IP_HLEN - TCP_HLEN; + } +#endif /* LWIP_IPV4 */ + /* RFC 1122, chap 4.2.2.6: + * Eff.snd.MSS = min(SendMSS+20, MMS_S) - TCPhdrsize - IPoptionsize + * We correct for TCP options in tcp_write(), and don't support IP options. + */ + sendmss = LWIP_MIN(sendmss, mss_s); + } + return sendmss; +} +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + +#if LWIP_IPV4 +/** Helper function for tcp_netif_ipv4_addr_changed() that iterates a pcb list */ +static void +tcp_netif_ipv4_addr_changed_pcblist(const ip4_addr_t* old_addr, struct tcp_pcb* pcb_list) +{ + struct tcp_pcb *pcb; + pcb = pcb_list; + while (pcb != NULL) { + /* PCB bound to current local interface address? */ + if (!IP_IS_V6_VAL(pcb->local_ip) && ip4_addr_cmp(ip_2_ip4(&pcb->local_ip), old_addr) +#if LWIP_AUTOIP + /* connections to link-local addresses must persist (RFC3927 ch. 1.9) */ + && !ip4_addr_islinklocal(ip_2_ip4(&pcb->local_ip)) +#endif /* LWIP_AUTOIP */ + ) { + /* this connection must be aborted */ + struct tcp_pcb *next = pcb->next; + LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_STATE, ("netif_set_ipaddr: aborting TCP pcb %p\n", (void *)pcb)); + tcp_abort(pcb); + pcb = next; + } else { + pcb = pcb->next; + } + } +} + +/** This function is called from netif.c when address is changed or netif is removed + * + * @param old_addr IPv4 address of the netif before change + * @param new_addr IPv4 address of the netif after change or NULL if netif has been removed + */ +void tcp_netif_ipv4_addr_changed(const ip4_addr_t* old_addr, const ip4_addr_t* new_addr) +{ + struct tcp_pcb_listen *lpcb, *next; + + tcp_netif_ipv4_addr_changed_pcblist(old_addr, tcp_active_pcbs); + tcp_netif_ipv4_addr_changed_pcblist(old_addr, tcp_bound_pcbs); + + if (!ip4_addr_isany(new_addr)) { + /* PCB bound to current local interface address? */ + for (lpcb = tcp_listen_pcbs.listen_pcbs; lpcb != NULL; lpcb = next) { + next = lpcb->next; + /* Is this an IPv4 pcb? */ + if (!IP_IS_V6_VAL(lpcb->local_ip)) { + /* PCB bound to current local interface address? */ + if ((!(ip4_addr_isany(ip_2_ip4(&lpcb->local_ip)))) && + (ip4_addr_cmp(ip_2_ip4(&lpcb->local_ip), old_addr))) { + /* The PCB is listening to the old ipaddr and + * is set to listen to the new one instead */ + ip_addr_copy_from_ip4(lpcb->local_ip, *new_addr); + } + } + } + } +} +#endif /* LWIP_IPV4 */ + +const char* +tcp_debug_state_str(enum tcp_state s) +{ +#ifdef LWIP_ESP8266 +//TO_DO + //system_get_string_from_flash(tcp_state_str_rodata[s], tcp_state_str, 12); + //return tcp_state_str; + return tcp_state_str[s]; +#else + return tcp_state_str[s]; +#endif +} + +#if TCP_DEBUG || TCP_INPUT_DEBUG || TCP_OUTPUT_DEBUG +/** + * Print a tcp header for debugging purposes. + * + * @param tcphdr pointer to a struct tcp_hdr + */ +void +tcp_debug_print(struct tcp_hdr *tcphdr) +{ + LWIP_DEBUGF(TCP_DEBUG, ("TCP header:\n")); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(TCP_DEBUG, ("| %5"U16_F" | %5"U16_F" | (src port, dest port)\n", + ntohs(tcphdr->src), ntohs(tcphdr->dest))); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(TCP_DEBUG, ("| %010"U32_F" | (seq no)\n", + ntohl(tcphdr->seqno))); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(TCP_DEBUG, ("| %010"U32_F" | (ack no)\n", + ntohl(tcphdr->ackno))); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(TCP_DEBUG, ("| %2"U16_F" | |%"U16_F"%"U16_F"%"U16_F"%"U16_F"%"U16_F"%"U16_F"| %5"U16_F" | (hdrlen, flags (", + TCPH_HDRLEN(tcphdr), + TCPH_FLAGS(tcphdr) >> 5 & 1, + TCPH_FLAGS(tcphdr) >> 4 & 1, + TCPH_FLAGS(tcphdr) >> 3 & 1, + TCPH_FLAGS(tcphdr) >> 2 & 1, + TCPH_FLAGS(tcphdr) >> 1 & 1, + TCPH_FLAGS(tcphdr) & 1, + ntohs(tcphdr->wnd))); + tcp_debug_print_flags(TCPH_FLAGS(tcphdr)); + LWIP_DEBUGF(TCP_DEBUG, ("), win)\n")); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(TCP_DEBUG, ("| 0x%04"X16_F" | %5"U16_F" | (chksum, urgp)\n", + ntohs(tcphdr->chksum), ntohs(tcphdr->urgp))); + LWIP_DEBUGF(TCP_DEBUG, ("+-------------------------------+\n")); +} + +/** + * Print a tcp state for debugging purposes. + * + * @param s enum tcp_state to print + */ +void +tcp_debug_print_state(enum tcp_state s) +{ + LWIP_DEBUGF(TCP_DEBUG, ("State: %s\n", tcp_state_str[s])); +} + +/** + * Print tcp flags for debugging purposes. + * + * @param flags tcp flags, all active flags are printed + */ +void +tcp_debug_print_flags(u8_t flags) +{ + if (flags & TCP_FIN) { + LWIP_DEBUGF(TCP_DEBUG, ("FIN ")); + } + if (flags & TCP_SYN) { + LWIP_DEBUGF(TCP_DEBUG, ("SYN ")); + } + if (flags & TCP_RST) { + LWIP_DEBUGF(TCP_DEBUG, ("RST ")); + } + if (flags & TCP_PSH) { + LWIP_DEBUGF(TCP_DEBUG, ("PSH ")); + } + if (flags & TCP_ACK) { + LWIP_DEBUGF(TCP_DEBUG, ("ACK ")); + } + if (flags & TCP_URG) { + LWIP_DEBUGF(TCP_DEBUG, ("URG ")); + } + if (flags & TCP_ECE) { + LWIP_DEBUGF(TCP_DEBUG, ("ECE ")); + } + if (flags & TCP_CWR) { + LWIP_DEBUGF(TCP_DEBUG, ("CWR ")); + } + LWIP_DEBUGF(TCP_DEBUG, ("\n")); +} + +/** + * Print all tcp_pcbs in every list for debugging purposes. + */ +void +tcp_debug_print_pcbs(void) +{ + struct tcp_pcb *pcb; + LWIP_DEBUGF(TCP_DEBUG, ("Active PCB states:\n")); + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_DEBUGF(TCP_DEBUG, ("Local port %"U16_F", foreign port %"U16_F" snd_nxt %"U32_F" rcv_nxt %"U32_F" ", + pcb->local_port, pcb->remote_port, + pcb->snd_nxt, pcb->rcv_nxt)); + tcp_debug_print_state(pcb->state); + } + LWIP_DEBUGF(TCP_DEBUG, ("Listen PCB states:\n")); + for (pcb = (struct tcp_pcb *)tcp_listen_pcbs.pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_DEBUGF(TCP_DEBUG, ("Local port %"U16_F", foreign port %"U16_F" snd_nxt %"U32_F" rcv_nxt %"U32_F" ", + pcb->local_port, pcb->remote_port, + pcb->snd_nxt, pcb->rcv_nxt)); + tcp_debug_print_state(pcb->state); + } + LWIP_DEBUGF(TCP_DEBUG, ("TIME-WAIT PCB states:\n")); + for (pcb = tcp_tw_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_DEBUGF(TCP_DEBUG, ("Local port %"U16_F", foreign port %"U16_F" snd_nxt %"U32_F" rcv_nxt %"U32_F" ", + pcb->local_port, pcb->remote_port, + pcb->snd_nxt, pcb->rcv_nxt)); + tcp_debug_print_state(pcb->state); + } +} + +/** + * Check state consistency of the tcp_pcb lists. + */ +s16_t +tcp_pcbs_sane(void) +{ + struct tcp_pcb *pcb; + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_ASSERT("tcp_pcbs_sane: active pcb->state != CLOSED", pcb->state != CLOSED); + LWIP_ASSERT("tcp_pcbs_sane: active pcb->state != LISTEN", pcb->state != LISTEN); + LWIP_ASSERT("tcp_pcbs_sane: active pcb->state != TIME-WAIT", pcb->state != TIME_WAIT); + } + for (pcb = tcp_tw_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_ASSERT("tcp_pcbs_sane: tw pcb->state == TIME-WAIT", pcb->state == TIME_WAIT); + } + return 1; +} +#endif /* TCP_DEBUG */ + +#endif /* LWIP_TCP */ diff --git a/components/lwip/core/tcp_in.c b/components/lwip/core/tcp_in.c new file mode 100755 index 000000000..25d740385 --- /dev/null +++ b/components/lwip/core/tcp_in.c @@ -0,0 +1,1802 @@ +/** + * @file + * Transmission Control Protocol, incoming traffic + * + * The input processing functions of the TCP layer. + * + * These functions are generally called in the order (ip_input() ->) + * tcp_input() -> * tcp_process() -> tcp_receive() (-> application). + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/priv/tcp_priv.h" +#include "lwip/def.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/inet_chksum.h" +#include "lwip/stats.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#if LWIP_ND6_TCP_REACHABILITY_HINTS +#include "lwip/nd6.h" +#endif /* LWIP_ND6_TCP_REACHABILITY_HINTS */ + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** Initial CWND calculation as defined RFC 2581 */ +#define LWIP_TCP_CALC_INITIAL_CWND(mss) LWIP_MIN((4U * (mss)), LWIP_MAX((2U * (mss)), 4380U)); +/** Initial slow start threshold value: we use the full window */ +#define LWIP_TCP_INITIAL_SSTHRESH(pcb) ((pcb)->snd_wnd) + +/* These variables are global to all functions involved in the input + processing of TCP segments. They are set by the tcp_input() + function. */ +static struct tcp_seg inseg; +static struct tcp_hdr *tcphdr; +static u16_t tcphdr_optlen; +static u16_t tcphdr_opt1len; +static u8_t* tcphdr_opt2; +static u16_t tcp_optidx; +static u32_t seqno, ackno; +static u8_t flags; +static u16_t tcplen; + +static u8_t recv_flags; +static struct pbuf *recv_data; + +struct tcp_pcb *tcp_input_pcb; + +/* Forward declarations. */ +static err_t tcp_process(struct tcp_pcb *pcb); +static void tcp_receive(struct tcp_pcb *pcb); +static void tcp_parseopt(struct tcp_pcb *pcb); + +static err_t tcp_listen_input(struct tcp_pcb_listen *pcb); +static err_t tcp_timewait_input(struct tcp_pcb *pcb); + +/** + * The initial input processing of TCP. It verifies the TCP header, demultiplexes + * the segment between the PCBs and passes it on to tcp_process(), which implements + * the TCP finite state machine. This function is called by the IP layer (in + * ip_input()). + * + * @param p received TCP segment to process (p->payload pointing to the TCP header) + * @param inp network interface on which this segment was received + */ +void +tcp_input(struct pbuf *p, struct netif *inp) +{ + struct tcp_pcb *pcb, *prev; + struct tcp_pcb_listen *lpcb; +#if SO_REUSE + struct tcp_pcb *lpcb_prev = NULL; + struct tcp_pcb_listen *lpcb_any = NULL; +#endif /* SO_REUSE */ + u8_t hdrlen; + err_t err; + + LWIP_UNUSED_ARG(inp); + + PERF_START; + + TCP_STATS_INC(tcp.recv); + MIB2_STATS_INC(mib2.tcpinsegs); + + tcphdr = (struct tcp_hdr *)p->payload; + +#if TCP_INPUT_DEBUG + tcp_debug_print(tcphdr); +#endif + + /* Check that TCP header fits in payload */ + if (p->len < sizeof(struct tcp_hdr)) { + /* drop short packets */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: short packet (%"U16_F" bytes) discarded\n", p->tot_len)); + TCP_STATS_INC(tcp.lenerr); + goto dropped; + } + + /* Don't even process incoming broadcasts/multicasts. */ + if (ip_addr_isbroadcast(ip_current_dest_addr(), ip_current_netif()) || + ip_addr_ismulticast(ip_current_dest_addr())) { + TCP_STATS_INC(tcp.proterr); + goto dropped; + } + +#if CHECKSUM_CHECK_TCP + IF__NETIF_CHECKSUM_ENABLED(inp, NETIF_CHECKSUM_CHECK_TCP) { + /* Verify TCP checksum. */ + u16_t chksum = ip_chksum_pseudo(p, IP_PROTO_TCP, p->tot_len, + ip_current_src_addr(), ip_current_dest_addr()); + if (chksum != 0) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: packet discarded due to failing checksum 0x%04"X16_F"\n", + chksum)); + tcp_debug_print(tcphdr); + TCP_STATS_INC(tcp.chkerr); + goto dropped; + } + } +#endif /* CHECKSUM_CHECK_TCP */ + + /* Move the payload pointer in the pbuf so that it points to the + TCP data instead of the TCP header. */ + hdrlen = TCPH_HDRLEN(tcphdr); + tcphdr_optlen = tcphdr_opt1len = (hdrlen * 4) - TCP_HLEN; + tcphdr_opt2 = NULL; + if (p->len < hdrlen * 4) { + if (p->len >= TCP_HLEN) { + /* TCP header fits into first pbuf, options don't - data is in the next pbuf */ + u16_t optlen = tcphdr_opt1len; + pbuf_header(p, -TCP_HLEN); /* cannot fail */ + LWIP_ASSERT("tcphdr_opt1len >= p->len", tcphdr_opt1len >= p->len); + LWIP_ASSERT("p->next != NULL", p->next != NULL); + tcphdr_opt1len = p->len; + if (optlen > tcphdr_opt1len) { + s16_t opt2len; + /* options continue in the next pbuf: set p to zero length and hide the + options in the next pbuf (adjusting p->tot_len) */ + u8_t phret = pbuf_header(p, -(s16_t)tcphdr_opt1len); + LWIP_ASSERT("phret == 0", phret == 0); + if(tcphdr_optlen - tcphdr_opt1len > p->tot_len) { + /* drop short packets */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: short packet (%"U16_F" bytes) discarded\n", p->tot_len)); + TCP_STATS_INC(tcp.lenerr); + goto dropped; + } + tcphdr_opt2 = (u8_t*)p->next->payload; + opt2len = optlen - tcphdr_opt1len; + phret = pbuf_header(p->next, -opt2len); + LWIP_ASSERT("phret == 0", phret == 0); + /* p->next->payload now points to the TCP data */ + /* manually adjust p->tot_len to changed p->next->tot_len change */ + p->tot_len -= opt2len; + } + LWIP_ASSERT("p->len == 0", p->len == 0); + } else { + /* drop short packets */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: short packet\n")); + TCP_STATS_INC(tcp.lenerr); + goto dropped; + } + } else { + pbuf_header(p, -(hdrlen * 4)); /* cannot fail */ + } + + /* Convert fields in TCP header to host byte order. */ + tcphdr->src = ntohs(tcphdr->src); + tcphdr->dest = ntohs(tcphdr->dest); + seqno = tcphdr->seqno = ntohl(tcphdr->seqno); + ackno = tcphdr->ackno = ntohl(tcphdr->ackno); + tcphdr->wnd = ntohs(tcphdr->wnd); + + flags = TCPH_FLAGS(tcphdr); + tcplen = p->tot_len + ((flags & (TCP_FIN | TCP_SYN)) ? 1 : 0); + + /* Demultiplex an incoming segment. First, we check if it is destined + for an active connection. */ + prev = NULL; + + for (pcb = tcp_active_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_ASSERT("tcp_input: active pcb->state != CLOSED", pcb->state != CLOSED); + LWIP_ASSERT("tcp_input: active pcb->state != TIME-WAIT", pcb->state != TIME_WAIT); + LWIP_ASSERT("tcp_input: active pcb->state != LISTEN", pcb->state != LISTEN); + if (pcb->remote_port == tcphdr->src && + pcb->local_port == tcphdr->dest && + ip_addr_cmp(&pcb->remote_ip, ip_current_src_addr()) && + ip_addr_cmp(&pcb->local_ip, ip_current_dest_addr())) { + /* Move this PCB to the front of the list so that subsequent + lookups will be faster (we exploit locality in TCP segment + arrivals). */ + LWIP_ASSERT("tcp_input: pcb->next != pcb (before cache)", pcb->next != pcb); + if (prev != NULL) { + prev->next = pcb->next; + pcb->next = tcp_active_pcbs; + tcp_active_pcbs = pcb; + } else { + TCP_STATS_INC(tcp.cachehit); + } + LWIP_ASSERT("tcp_input: pcb->next != pcb (after cache)", pcb->next != pcb); + break; + } + prev = pcb; + } + + if (pcb == NULL) { + /* If it did not go to an active connection, we check the connections + in the TIME-WAIT state. */ + for (pcb = tcp_tw_pcbs; pcb != NULL; pcb = pcb->next) { + LWIP_ASSERT("tcp_input: TIME-WAIT pcb->state == TIME-WAIT", pcb->state == TIME_WAIT); + if (pcb->remote_port == tcphdr->src && + pcb->local_port == tcphdr->dest && + ip_addr_cmp(&pcb->remote_ip, ip_current_src_addr()) && + ip_addr_cmp(&pcb->local_ip, ip_current_dest_addr())) { + /* We don't really care enough to move this PCB to the front + of the list since we are not very likely to receive that + many segments for connections in TIME-WAIT. */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: packed for TIME_WAITing connection.\n")); + tcp_timewait_input(pcb); + pbuf_free(p); + return; + } + } + + /* Finally, if we still did not get a match, we check all PCBs that + are LISTENing for incoming connections. */ + prev = NULL; + for (lpcb = tcp_listen_pcbs.listen_pcbs; lpcb != NULL; lpcb = lpcb->next) { + if (lpcb->local_port == tcphdr->dest) { + if (IP_IS_ANY_TYPE_VAL(lpcb->local_ip)) { + /* found an ANY TYPE (IPv4/IPv6) match */ +#if SO_REUSE + lpcb_any = lpcb; + lpcb_prev = prev; +#else /* SO_REUSE */ + break; +#endif /* SO_REUSE */ + } else if (IP_ADDR_PCB_VERSION_MATCH_EXACT(lpcb, ip_current_dest_addr())) { + if (ip_addr_cmp(&lpcb->local_ip, ip_current_dest_addr())) { + /* found an exact match */ + break; + } else if (ip_addr_isany(&lpcb->local_ip)) { + /* found an ANY-match */ +#if SO_REUSE + lpcb_any = lpcb; + lpcb_prev = prev; +#else /* SO_REUSE */ + break; + #endif /* SO_REUSE */ + } + } + } + prev = (struct tcp_pcb *)lpcb; + } +#if SO_REUSE + /* first try specific local IP */ + if (lpcb == NULL) { + /* only pass to ANY if no specific local IP has been found */ + lpcb = lpcb_any; + prev = lpcb_prev; + } +#endif /* SO_REUSE */ + if (lpcb != NULL) { + /* Move this PCB to the front of the list so that subsequent + lookups will be faster (we exploit locality in TCP segment + arrivals). */ + if (prev != NULL) { + ((struct tcp_pcb_listen *)prev)->next = lpcb->next; + /* our successor is the remainder of the listening list */ + lpcb->next = tcp_listen_pcbs.listen_pcbs; + /* put this listening pcb at the head of the listening list */ + tcp_listen_pcbs.listen_pcbs = lpcb; + } else { + TCP_STATS_INC(tcp.cachehit); + } + + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: packed for LISTENing connection.\n")); + tcp_listen_input(lpcb); + pbuf_free(p); + return; + } + } + +#if TCP_INPUT_DEBUG + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("+-+-+-+-+-+-+-+-+-+-+-+-+-+- tcp_input: flags ")); + tcp_debug_print_flags(TCPH_FLAGS(tcphdr)); + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("-+-+-+-+-+-+-+-+-+-+-+-+-+-+\n")); +#endif /* TCP_INPUT_DEBUG */ + + + if (pcb != NULL) { + +#ifdef LWIP_ESP8266 +//No Need Any more +/* + extern char RxNodeNum(void); + if(RxNodeNum() <= 2) + { +extern void pbuf_free_ooseq(void); + pbuf_free_ooseq(); + } +*/ +#endif + + + /* The incoming segment belongs to a connection. */ +#if TCP_INPUT_DEBUG + tcp_debug_print_state(pcb->state); +#endif /* TCP_INPUT_DEBUG */ + + /* Set up a tcp_seg structure. */ + inseg.next = NULL; + inseg.len = p->tot_len; + inseg.p = p; + inseg.tcphdr = tcphdr; + + recv_data = NULL; + recv_flags = 0; + + if (flags & TCP_PSH) { + p->flags |= PBUF_FLAG_PUSH; + } + + /* If there is data which was previously "refused" by upper layer */ + if (pcb->refused_data != NULL) { + if ((tcp_process_refused_data(pcb) == ERR_ABRT) || + ((pcb->refused_data != NULL) && (tcplen > 0))) { + /* pcb has been aborted or refused data is still refused and the new + segment contains data */ + TCP_STATS_INC(tcp.drop); + MIB2_STATS_INC(mib2.tcpinerrs); + goto aborted; + } + } + tcp_input_pcb = pcb; + err = tcp_process(pcb); + /* A return value of ERR_ABRT means that tcp_abort() was called + and that the pcb has been freed. If so, we don't do anything. */ + if (err != ERR_ABRT) { + if (recv_flags & TF_RESET) { + /* TF_RESET means that the connection was reset by the other + end. We then call the error callback to inform the + application that the connection is dead before we + deallocate the PCB. */ + TCP_EVENT_ERR(pcb->errf, pcb->callback_arg, ERR_RST); + tcp_pcb_remove(&tcp_active_pcbs, pcb); + memp_free(MEMP_TCP_PCB, pcb); + } else { + err = ERR_OK; + /* If the application has registered a "sent" function to be + called when new send buffer space is available, we call it + now. */ + if (pcb->acked > 0) { + u16_t acked; +#if LWIP_WND_SCALE + /* pcb->acked is u32_t but the sent callback only takes a u16_t, + so we might have to call it multiple times. */ + u32_t pcb_acked = pcb->acked; + while (pcb_acked > 0) { + acked = (u16_t)LWIP_MIN(pcb_acked, 0xffffu); + pcb_acked -= acked; +#else + { + acked = pcb->acked; +#endif + TCP_EVENT_SENT(pcb, (u16_t)acked, err); + if (err == ERR_ABRT) { + goto aborted; + } + } + } + if (recv_flags & TF_CLOSED) { + /* The connection has been closed and we will deallocate the + PCB. */ + if (!(pcb->flags & TF_RXCLOSED)) { + /* Connection closed although the application has only shut down the + tx side: call the PCB's err callback and indicate the closure to + ensure the application doesn't continue using the PCB. */ + TCP_EVENT_ERR(pcb->errf, pcb->callback_arg, ERR_CLSD); + } + tcp_pcb_remove(&tcp_active_pcbs, pcb); + memp_free(MEMP_TCP_PCB, pcb); + goto aborted; + } +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + while (recv_data != NULL) { + struct pbuf *rest = NULL; + pbuf_split_64k(recv_data, &rest); +#else /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + if (recv_data != NULL) { +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + + LWIP_ASSERT("pcb->refused_data == NULL", pcb->refused_data == NULL); + if (pcb->flags & TF_RXCLOSED) { + /* received data although already closed -> abort (send RST) to + notify the remote host that not all data has been processed */ + pbuf_free(recv_data); +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + if (rest != NULL) { + pbuf_free(rest); + } +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + tcp_abort(pcb); + goto aborted; + } + + /* Notify application that data has been received. */ + TCP_EVENT_RECV(pcb, recv_data, ERR_OK, err); + if (err == ERR_ABRT) { +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + if (rest != NULL) { + pbuf_free(rest); + } +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + goto aborted; + } + + /* If the upper layer can't receive this data, store it */ + if (err != ERR_OK) { +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + if (rest != NULL) { + pbuf_cat(recv_data, rest); + } +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + pcb->refused_data = recv_data; + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: keep incoming packet, because pcb is \"full\"\n")); +#if TCP_QUEUE_OOSEQ && LWIP_WND_SCALE + break; + } else { + /* Upper layer received the data, go on with the rest if > 64K */ + recv_data = rest; +#endif /* TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + } + } + + /* If a FIN segment was received, we call the callback + function with a NULL buffer to indicate EOF. */ + if (recv_flags & TF_GOT_FIN) { + if (pcb->refused_data != NULL) { + /* Delay this if we have refused data. */ + pcb->refused_data->flags |= PBUF_FLAG_TCP_FIN; + } else { + /* correct rcv_wnd as the application won't call tcp_recved() + for the FIN's seqno */ + if (pcb->rcv_wnd != TCP_WND_MAX(pcb)) { + pcb->rcv_wnd++; + } + TCP_EVENT_CLOSED(pcb, err); + if (err == ERR_ABRT) { + goto aborted; + } + } + } + + tcp_input_pcb = NULL; + /* Try to send something out. */ + tcp_output(pcb); +#if TCP_INPUT_DEBUG +#if TCP_DEBUG + tcp_debug_print_state(pcb->state); +#endif /* TCP_DEBUG */ +#endif /* TCP_INPUT_DEBUG */ + } + } + /* Jump target if pcb has been aborted in a callback (by calling tcp_abort()). + Below this line, 'pcb' may not be dereferenced! */ +aborted: + tcp_input_pcb = NULL; + recv_data = NULL; + + /* give up our reference to inseg.p */ + if (inseg.p != NULL) + { + pbuf_free(inseg.p); + inseg.p = NULL; + } + } else { + + /* If no matching PCB was found, send a TCP RST (reset) to the + sender. */ + LWIP_DEBUGF(TCP_RST_DEBUG, ("tcp_input: no PCB match found, resetting.\n")); + if (!(TCPH_FLAGS(tcphdr) & TCP_RST)) { + TCP_STATS_INC(tcp.proterr); + TCP_STATS_INC(tcp.drop); + tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), + ip_current_src_addr(), tcphdr->dest, tcphdr->src); + } + pbuf_free(p); + } + + LWIP_ASSERT("tcp_input: tcp_pcbs_sane()", tcp_pcbs_sane()); + PERF_STOP("tcp_input"); + return; +dropped: + TCP_STATS_INC(tcp.drop); + MIB2_STATS_INC(mib2.tcpinerrs); + pbuf_free(p); +} + +/** + * Called by tcp_input() when a segment arrives for a listening + * connection (from tcp_input()). + * + * @param pcb the tcp_pcb_listen for which a segment arrived + * @return ERR_OK if the segment was processed + * another err_t on error + * + * @note the return value is not (yet?) used in tcp_input() + * @note the segment which arrived is saved in global variables, therefore only the pcb + * involved is passed as a parameter to this function + */ +static err_t +tcp_listen_input(struct tcp_pcb_listen *pcb) +{ + struct tcp_pcb *npcb; + err_t rc; + + if (flags & TCP_RST) { + /* An incoming RST should be ignored. Return. */ + return ERR_OK; + } + + /* In the LISTEN state, we check for incoming SYN segments, + creates a new PCB, and responds with a SYN|ACK. */ + if (flags & TCP_ACK) { + /* For incoming segments with the ACK flag set, respond with a + RST. */ + LWIP_DEBUGF(TCP_RST_DEBUG, ("tcp_listen_input: ACK in LISTEN, sending reset\n")); + tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), + ip_current_src_addr(), tcphdr->dest, tcphdr->src); + } else if (flags & TCP_SYN) { + LWIP_DEBUGF(TCP_DEBUG, ("TCP connection request %"U16_F" -> %"U16_F".\n", tcphdr->src, tcphdr->dest)); +#if TCP_LISTEN_BACKLOG + if (pcb->accepts_pending >= pcb->backlog) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_listen_input: listen backlog exceeded for port %"U16_F"\n", tcphdr->dest)); + return ERR_ABRT; + } +#endif /* TCP_LISTEN_BACKLOG */ + npcb = tcp_alloc(pcb->prio); + /* If a new PCB could not be created (probably due to lack of memory), + we don't do anything, but rely on the sender will retransmit the + SYN at a time when we have more memory available. */ + if (npcb == NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_listen_input: could not allocate PCB\n")); + TCP_STATS_INC(tcp.memerr); + return ERR_MEM; + } +#if TCP_LISTEN_BACKLOG + pcb->accepts_pending++; +#endif /* TCP_LISTEN_BACKLOG */ + /* Set up the new PCB. */ + ip_addr_copy(npcb->local_ip, *ip_current_dest_addr()); + ip_addr_copy(npcb->remote_ip, *ip_current_src_addr()); + npcb->local_port = pcb->local_port; + npcb->remote_port = tcphdr->src; + npcb->state = SYN_RCVD; + npcb->rcv_nxt = seqno + 1; + npcb->rcv_ann_right_edge = npcb->rcv_nxt; + npcb->snd_wl1 = seqno - 1;/* initialise to seqno-1 to force window update */ + npcb->callback_arg = pcb->callback_arg; +#if LWIP_CALLBACK_API + npcb->accept = pcb->accept; +#endif /* LWIP_CALLBACK_API */ + /* inherit socket options */ + npcb->so_options = pcb->so_options & SOF_INHERITED; + /* Register the new PCB so that we can begin receiving segments + for it. */ + TCP_REG_ACTIVE(npcb); + + /* Parse any options in the SYN. */ + tcp_parseopt(npcb); + npcb->snd_wnd = SND_WND_SCALE(npcb, tcphdr->wnd); + npcb->snd_wnd_max = npcb->snd_wnd; + npcb->ssthresh = LWIP_TCP_INITIAL_SSTHRESH(npcb); + +#if TCP_CALCULATE_EFF_SEND_MSS + npcb->mss = tcp_eff_send_mss(npcb->mss, &npcb->local_ip, &npcb->remote_ip); +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + + MIB2_STATS_INC(mib2.tcppassiveopens); + + /* Send a SYN|ACK together with the MSS option. */ + rc = tcp_enqueue_flags(npcb, TCP_SYN | TCP_ACK); + if (rc != ERR_OK) { + tcp_abandon(npcb, 0); + return rc; + } + return tcp_output(npcb); + } + return ERR_OK; +} + +/** + * Called by tcp_input() when a segment arrives for a connection in + * TIME_WAIT. + * + * @param pcb the tcp_pcb for which a segment arrived + * + * @note the segment which arrived is saved in global variables, therefore only the pcb + * involved is passed as a parameter to this function + */ +static err_t +tcp_timewait_input(struct tcp_pcb *pcb) +{ + /* RFC 1337: in TIME_WAIT, ignore RST and ACK FINs + any 'acceptable' segments */ + /* RFC 793 3.9 Event Processing - Segment Arrives: + * - first check sequence number - we skip that one in TIME_WAIT (always + * acceptable since we only send ACKs) + * - second check the RST bit (... return) */ + if (flags & TCP_RST) { + return ERR_OK; + } + /* - fourth, check the SYN bit, */ + if (flags & TCP_SYN) { + /* If an incoming segment is not acceptable, an acknowledgment + should be sent in reply */ + if (TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, pcb->rcv_nxt + pcb->rcv_wnd)) { + /* If the SYN is in the window it is an error, send a reset */ + tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), + ip_current_src_addr(), tcphdr->dest, tcphdr->src); + return ERR_OK; + } + } else if (flags & TCP_FIN) { + /* - eighth, check the FIN bit: Remain in the TIME-WAIT state. + Restart the 2 MSL time-wait timeout.*/ + pcb->tmr = tcp_ticks; + } + + if ((tcplen > 0)) { + /* Acknowledge data, FIN or out-of-window SYN */ + pcb->flags |= TF_ACK_NOW; + return tcp_output(pcb); + } + return ERR_OK; +} + +/** + * Implements the TCP state machine. Called by tcp_input. In some + * states tcp_receive() is called to receive data. The tcp_seg + * argument will be freed by the caller (tcp_input()) unless the + * recv_data pointer in the pcb is set. + * + * @param pcb the tcp_pcb for which a segment arrived + * + * @note the segment which arrived is saved in global variables, therefore only the pcb + * involved is passed as a parameter to this function + */ +static err_t +tcp_process(struct tcp_pcb *pcb) +{ + struct tcp_seg *rseg; + u8_t acceptable = 0; + err_t err; + + err = ERR_OK; + + /* Process incoming RST segments. */ + if (flags & TCP_RST) { + /* First, determine if the reset is acceptable. */ + if (pcb->state == SYN_SENT) { + if (ackno == pcb->snd_nxt) { + acceptable = 1; + } + } else { + if (TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, + pcb->rcv_nxt + pcb->rcv_wnd)) { + acceptable = 1; + } + } + + if (acceptable) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_process: Connection RESET\n")); + LWIP_ASSERT("tcp_input: pcb->state != CLOSED", pcb->state != CLOSED); + recv_flags |= TF_RESET; + pcb->flags &= ~TF_ACK_DELAY; + return ERR_RST; + } else { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_process: unacceptable reset seqno %"U32_F" rcv_nxt %"U32_F"\n", + seqno, pcb->rcv_nxt)); + LWIP_DEBUGF(TCP_DEBUG, ("tcp_process: unacceptable reset seqno %"U32_F" rcv_nxt %"U32_F"\n", + seqno, pcb->rcv_nxt)); + return ERR_OK; + } + } + + if ((flags & TCP_SYN) && (pcb->state != SYN_SENT && pcb->state != SYN_RCVD)) { + /* Cope with new connection attempt after remote end crashed */ + tcp_ack_now(pcb); + return ERR_OK; + } + + if ((pcb->flags & TF_RXCLOSED) == 0) { + /* Update the PCB (in)activity timer unless rx is closed (see tcp_shutdown) */ + pcb->tmr = tcp_ticks; + } + pcb->keep_cnt_sent = 0; + + tcp_parseopt(pcb); + + /* Do different things depending on the TCP state. */ + switch (pcb->state) { + case SYN_SENT: + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("SYN-SENT: ackno %"U32_F" pcb->snd_nxt %"U32_F" unacked %"U32_F"\n", ackno, + pcb->snd_nxt, ntohl(pcb->unacked->tcphdr->seqno))); + /* received SYN ACK with expected sequence number? */ + if ((flags & TCP_ACK) && (flags & TCP_SYN) + && ackno == ntohl(pcb->unacked->tcphdr->seqno) + 1) { + pcb->snd_buf++; + pcb->rcv_nxt = seqno + 1; + pcb->rcv_ann_right_edge = pcb->rcv_nxt; + pcb->lastack = ackno; + pcb->snd_wnd = SND_WND_SCALE(pcb, tcphdr->wnd); + pcb->snd_wnd_max = pcb->snd_wnd; + pcb->snd_wl1 = seqno - 1; /* initialise to seqno - 1 to force window update */ + pcb->state = ESTABLISHED; + +#if TCP_CALCULATE_EFF_SEND_MSS + pcb->mss = tcp_eff_send_mss(pcb->mss, &pcb->local_ip, &pcb->remote_ip); +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + + /* Set ssthresh again after changing 'mss' and 'snd_wnd' */ + pcb->ssthresh = LWIP_TCP_INITIAL_SSTHRESH(pcb); + + pcb->cwnd = LWIP_TCP_CALC_INITIAL_CWND(pcb->mss); + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_process (SENT): cwnd %"TCPWNDSIZE_F + " ssthresh %"TCPWNDSIZE_F"\n", + pcb->cwnd, pcb->ssthresh)); + LWIP_ASSERT("pcb->snd_queuelen > 0", (pcb->snd_queuelen > 0)); + --pcb->snd_queuelen; + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_process: SYN-SENT --queuelen %"TCPWNDSIZE_F"\n", (tcpwnd_size_t)pcb->snd_queuelen)); + rseg = pcb->unacked; + pcb->unacked = rseg->next; + tcp_seg_free(rseg); + + /* If there's nothing left to acknowledge, stop the retransmit + timer, otherwise reset it to start again */ + if (pcb->unacked == NULL) { + pcb->rtime = -1; + } else { + pcb->rtime = 0; + pcb->nrtx = 0; + } + + /* Call the user specified function to call when successfully + * connected. */ + TCP_EVENT_CONNECTED(pcb, ERR_OK, err); + if (err == ERR_ABRT) { + return ERR_ABRT; + } + tcp_ack_now(pcb); + } + /* received ACK? possibly a half-open connection */ + else if (flags & TCP_ACK) { + /* send a RST to bring the other side in a non-synchronized state. */ + tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), + ip_current_src_addr(), tcphdr->dest, tcphdr->src); + } + break; + case SYN_RCVD: + if (flags & TCP_ACK) { + /* expected ACK number? */ + if (TCP_SEQ_BETWEEN(ackno, pcb->lastack+1, pcb->snd_nxt)) { + pcb->state = ESTABLISHED; + LWIP_DEBUGF(TCP_DEBUG, ("TCP connection established %"U16_F" -> %"U16_F".\n", inseg.tcphdr->src, inseg.tcphdr->dest)); +#if LWIP_CALLBACK_API + LWIP_ASSERT("pcb->accept != NULL", pcb->accept != NULL); +#endif + /* Call the accept function. */ + TCP_EVENT_ACCEPT(pcb, ERR_OK, err); + if (err != ERR_OK) { + /* If the accept function returns with an error, we abort + * the connection. */ + /* Already aborted? */ + if (err != ERR_ABRT) { + tcp_abort(pcb); + } + return ERR_ABRT; + } + /* If there was any data contained within this ACK, + * we'd better pass it on to the application as well. */ + tcp_receive(pcb); + + /* passive open: update initial ssthresh now that the correct window is + known: if the remote side supports window scaling, the window sent + with the initial SYN can be smaller than the one used later */ + pcb->ssthresh = LWIP_TCP_INITIAL_SSTHRESH(pcb); + + /* Prevent ACK for SYN to generate a sent event */ + if (pcb->acked != 0) { + pcb->acked--; + } + + pcb->cwnd = LWIP_TCP_CALC_INITIAL_CWND(pcb->mss); + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_process (SYN_RCVD): cwnd %"TCPWNDSIZE_F + " ssthresh %"TCPWNDSIZE_F"\n", + pcb->cwnd, pcb->ssthresh)); + + if (recv_flags & TF_GOT_FIN) { + tcp_ack_now(pcb); + pcb->state = CLOSE_WAIT; + } + } else { + /* incorrect ACK number, send RST */ + tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), + ip_current_src_addr(), tcphdr->dest, tcphdr->src); + } + } else if ((flags & TCP_SYN) && (seqno == pcb->rcv_nxt - 1)) { + /* Looks like another copy of the SYN - retransmit our SYN-ACK */ + tcp_rexmit(pcb); + } + break; + case CLOSE_WAIT: + /* FALLTHROUGH */ + case ESTABLISHED: + tcp_receive(pcb); + if (recv_flags & TF_GOT_FIN) { /* passive close */ + tcp_ack_now(pcb); + pcb->state = CLOSE_WAIT; + } + break; + case FIN_WAIT_1: + tcp_receive(pcb); + if (recv_flags & TF_GOT_FIN) { + if ((flags & TCP_ACK) && (ackno == pcb->snd_nxt)) { + LWIP_DEBUGF(TCP_DEBUG, + ("TCP connection closed: FIN_WAIT_1 %"U16_F" -> %"U16_F".\n", inseg.tcphdr->src, inseg.tcphdr->dest)); + tcp_ack_now(pcb); + tcp_pcb_purge(pcb); + TCP_RMV_ACTIVE(pcb); + pcb->state = TIME_WAIT; + TCP_REG(&tcp_tw_pcbs, pcb); + } else { + tcp_ack_now(pcb); + pcb->state = CLOSING; + } + } else if ((flags & TCP_ACK) && (ackno == pcb->snd_nxt)) { + pcb->state = FIN_WAIT_2; + } + break; + case FIN_WAIT_2: + tcp_receive(pcb); + if (recv_flags & TF_GOT_FIN) { + LWIP_DEBUGF(TCP_DEBUG, ("TCP connection closed: FIN_WAIT_2 %"U16_F" -> %"U16_F".\n", inseg.tcphdr->src, inseg.tcphdr->dest)); + tcp_ack_now(pcb); + tcp_pcb_purge(pcb); + TCP_RMV_ACTIVE(pcb); + pcb->state = TIME_WAIT; + TCP_REG(&tcp_tw_pcbs, pcb); + } + break; + case CLOSING: + tcp_receive(pcb); + if (flags & TCP_ACK && ackno == pcb->snd_nxt) { + LWIP_DEBUGF(TCP_DEBUG, ("TCP connection closed: CLOSING %"U16_F" -> %"U16_F".\n", inseg.tcphdr->src, inseg.tcphdr->dest)); + tcp_pcb_purge(pcb); + TCP_RMV_ACTIVE(pcb); + pcb->state = TIME_WAIT; + TCP_REG(&tcp_tw_pcbs, pcb); + } + break; + case LAST_ACK: + tcp_receive(pcb); + if (flags & TCP_ACK && ackno == pcb->snd_nxt) { + LWIP_DEBUGF(TCP_DEBUG, ("TCP connection closed: LAST_ACK %"U16_F" -> %"U16_F".\n", inseg.tcphdr->src, inseg.tcphdr->dest)); + /* bugfix #21699: don't set pcb->state to CLOSED here or we risk leaking segments */ + recv_flags |= TF_CLOSED; + } + break; + default: + break; + } + return ERR_OK; +} + +#if TCP_QUEUE_OOSEQ +/** + * Insert segment into the list (segments covered with new one will be deleted) + * + * Called from tcp_receive() + */ +static void +tcp_oos_insert_segment(struct tcp_seg *cseg, struct tcp_seg *next) +{ + struct tcp_seg *old_seg; + + if (TCPH_FLAGS(cseg->tcphdr) & TCP_FIN) { + /* received segment overlaps all following segments */ + tcp_segs_free(next); + next = NULL; + } else { + /* delete some following segments + oos queue may have segments with FIN flag */ + while (next && + TCP_SEQ_GEQ((seqno + cseg->len), + (next->tcphdr->seqno + next->len))) { + /* cseg with FIN already processed */ + if (TCPH_FLAGS(next->tcphdr) & TCP_FIN) { + TCPH_SET_FLAG(cseg->tcphdr, TCP_FIN); + } + old_seg = next; + next = next->next; + tcp_seg_free(old_seg); + } + if (next && + TCP_SEQ_GT(seqno + cseg->len, next->tcphdr->seqno)) { + /* We need to trim the incoming segment. */ + cseg->len = (u16_t)(next->tcphdr->seqno - seqno); + pbuf_realloc(cseg->p, cseg->len); + } + } + cseg->next = next; +} +#endif /* TCP_QUEUE_OOSEQ */ + +/** + * Called by tcp_process. Checks if the given segment is an ACK for outstanding + * data, and if so frees the memory of the buffered data. Next, it places the + * segment on any of the receive queues (pcb->recved or pcb->ooseq). If the segment + * is buffered, the pbuf is referenced by pbuf_ref so that it will not be freed until + * it has been removed from the buffer. + * + * If the incoming segment constitutes an ACK for a segment that was used for RTT + * estimation, the RTT is estimated here as well. + * + * Called from tcp_process(). + */ +static void +tcp_receive(struct tcp_pcb *pcb) +{ + struct tcp_seg *next; +#if TCP_QUEUE_OOSEQ + struct tcp_seg *prev, *cseg; +#endif /* TCP_QUEUE_OOSEQ */ + struct pbuf *p; + s32_t off; + s16_t m; + u32_t right_wnd_edge; + u16_t new_tot_len; + int found_dupack = 0; +#if TCP_OOSEQ_MAX_BYTES || TCP_OOSEQ_MAX_PBUFS + u32_t ooseq_blen; + u16_t ooseq_qlen; +#endif /* TCP_OOSEQ_MAX_BYTES || TCP_OOSEQ_MAX_PBUFS */ + + LWIP_ASSERT("tcp_receive: wrong state", pcb->state >= ESTABLISHED); + + if (flags & TCP_ACK) { + right_wnd_edge = pcb->snd_wnd + pcb->snd_wl2; + + /* Update window. */ + if (TCP_SEQ_LT(pcb->snd_wl1, seqno) || + (pcb->snd_wl1 == seqno && TCP_SEQ_LT(pcb->snd_wl2, ackno)) || + (pcb->snd_wl2 == ackno && (u32_t)SND_WND_SCALE(pcb, tcphdr->wnd) > pcb->snd_wnd)) { + pcb->snd_wnd = SND_WND_SCALE(pcb, tcphdr->wnd); + /* keep track of the biggest window announced by the remote host to calculate + the maximum segment size */ + if (pcb->snd_wnd_max < pcb->snd_wnd) { + pcb->snd_wnd_max = pcb->snd_wnd; + } + pcb->snd_wl1 = seqno; + pcb->snd_wl2 = ackno; + if (pcb->snd_wnd == 0) { + if (pcb->persist_backoff == 0) { + /* start persist timer */ + pcb->persist_cnt = 0; + pcb->persist_backoff = 1; + } + } else if (pcb->persist_backoff > 0) { + /* stop persist timer */ + pcb->persist_backoff = 0; + } + LWIP_DEBUGF(TCP_WND_DEBUG, ("tcp_receive: window update %"TCPWNDSIZE_F"\n", pcb->snd_wnd)); +#if TCP_WND_DEBUG + } else { + if (pcb->snd_wnd != (tcpwnd_size_t)SND_WND_SCALE(pcb, tcphdr->wnd)) { + LWIP_DEBUGF(TCP_WND_DEBUG, + ("tcp_receive: no window update lastack %"U32_F" ackno %" + U32_F" wl1 %"U32_F" seqno %"U32_F" wl2 %"U32_F"\n", + pcb->lastack, ackno, pcb->snd_wl1, seqno, pcb->snd_wl2)); + } +#endif /* TCP_WND_DEBUG */ + } + + /* (From Stevens TCP/IP Illustrated Vol II, p970.) Its only a + * duplicate ack if: + * 1) It doesn't ACK new data + * 2) length of received packet is zero (i.e. no payload) + * 3) the advertised window hasn't changed + * 4) There is outstanding unacknowledged data (retransmission timer running) + * 5) The ACK is == biggest ACK sequence number so far seen (snd_una) + * + * If it passes all five, should process as a dupack: + * a) dupacks < 3: do nothing + * b) dupacks == 3: fast retransmit + * c) dupacks > 3: increase cwnd + * + * If it only passes 1-3, should reset dupack counter (and add to + * stats, which we don't do in lwIP) + * + * If it only passes 1, should reset dupack counter + * + */ + + /* Clause 1 */ + if (TCP_SEQ_LEQ(ackno, pcb->lastack)) { + pcb->acked = 0; + /* Clause 2 */ + if (tcplen == 0) { + /* Clause 3 */ + if (pcb->snd_wl2 + pcb->snd_wnd == right_wnd_edge) { + /* Clause 4 */ + if (pcb->rtime >= 0) { + /* Clause 5 */ + if (pcb->lastack == ackno) { + found_dupack = 1; + if ((u8_t)(pcb->dupacks + 1) > pcb->dupacks) { + ++pcb->dupacks; + } + if (pcb->dupacks > 3) { + /* Inflate the congestion window, but not if it means that + the value overflows. */ + if ((tcpwnd_size_t)(pcb->cwnd + pcb->mss) > pcb->cwnd) { + pcb->cwnd += pcb->mss; + } + } else if (pcb->dupacks == 3) { + /* Do fast retransmit */ + tcp_rexmit_fast(pcb); + } + } + } + } + } + /* If Clause (1) or more is true, but not a duplicate ack, reset + * count of consecutive duplicate acks */ + if (!found_dupack) { + pcb->dupacks = 0; + } + } else if (TCP_SEQ_BETWEEN(ackno, pcb->lastack+1, pcb->snd_nxt)) { + /* We come here when the ACK acknowledges new data. */ + + /* Reset the "IN Fast Retransmit" flag, since we are no longer + in fast retransmit. Also reset the congestion window to the + slow start threshold. */ + if (pcb->flags & TF_INFR) { + pcb->flags &= ~TF_INFR; + pcb->cwnd = pcb->ssthresh; + } + + /* Reset the number of retransmissions. */ + pcb->nrtx = 0; + + /* Reset the retransmission time-out. */ + pcb->rto = (pcb->sa >> 3) + pcb->sv; + + /* Update the send buffer space. Diff between the two can never exceed 64K + unless window scaling is used. */ + pcb->acked = (tcpwnd_size_t)(ackno - pcb->lastack); + + pcb->snd_buf += pcb->acked; + + /* Reset the fast retransmit variables. */ + pcb->dupacks = 0; + pcb->lastack = ackno; + + /* Update the congestion control variables (cwnd and + ssthresh). */ + if (pcb->state >= ESTABLISHED) { + if (pcb->cwnd < pcb->ssthresh) { + if ((tcpwnd_size_t)(pcb->cwnd + pcb->mss) > pcb->cwnd) { + pcb->cwnd += pcb->mss; + } + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_receive: slow start cwnd %"TCPWNDSIZE_F"\n", pcb->cwnd)); + } else { + tcpwnd_size_t new_cwnd = (pcb->cwnd + pcb->mss * pcb->mss / pcb->cwnd); + if (new_cwnd > pcb->cwnd) { + pcb->cwnd = new_cwnd; + } + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_receive: congestion avoidance cwnd %"TCPWNDSIZE_F"\n", pcb->cwnd)); + } + } + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: ACK for %"U32_F", unacked->seqno %"U32_F":%"U32_F"\n", + ackno, + pcb->unacked != NULL? + ntohl(pcb->unacked->tcphdr->seqno): 0, + pcb->unacked != NULL? + ntohl(pcb->unacked->tcphdr->seqno) + TCP_TCPLEN(pcb->unacked): 0)); + + /* Remove segment from the unacknowledged list if the incoming + ACK acknowledges them. */ + while (pcb->unacked != NULL && + TCP_SEQ_LEQ(ntohl(pcb->unacked->tcphdr->seqno) + + TCP_TCPLEN(pcb->unacked), ackno)) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: removing %"U32_F":%"U32_F" from pcb->unacked\n", + ntohl(pcb->unacked->tcphdr->seqno), + ntohl(pcb->unacked->tcphdr->seqno) + + TCP_TCPLEN(pcb->unacked))); + + next = pcb->unacked; + pcb->unacked = pcb->unacked->next; + + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_receive: queuelen %"TCPWNDSIZE_F" ... ", (tcpwnd_size_t)pcb->snd_queuelen)); + LWIP_ASSERT("pcb->snd_queuelen >= pbuf_clen(next->p)", (pcb->snd_queuelen >= pbuf_clen(next->p))); + /* Prevent ACK for FIN to generate a sent event */ + if ((pcb->acked != 0) && ((TCPH_FLAGS(next->tcphdr) & TCP_FIN) != 0)) { + pcb->acked--; + } + + pcb->snd_queuelen -= pbuf_clen(next->p); + tcp_seg_free(next); + + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("%"TCPWNDSIZE_F" (after freeing unacked)\n", (tcpwnd_size_t)pcb->snd_queuelen)); + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_receive: valid queue length", pcb->unacked != NULL || + pcb->unsent != NULL); + } + } + + /* If there's nothing left to acknowledge, stop the retransmit + timer, otherwise reset it to start again */ + if (pcb->unacked == NULL) { + pcb->rtime = -1; + } else { + pcb->rtime = 0; + } + + pcb->polltmr = 0; + +#if LWIP_IPV6 && LWIP_ND6_TCP_REACHABILITY_HINTS + if (ip_current_is_v6()) { + /* Inform neighbor reachability of forward progress. */ + nd6_reachability_hint(ip6_current_src_addr()); + } +#endif /* LWIP_IPV6 && LWIP_ND6_TCP_REACHABILITY_HINTS*/ + } else { + /* Out of sequence ACK, didn't really ack anything */ + pcb->acked = 0; + tcp_send_empty_ack(pcb); + } + + /* We go through the ->unsent list to see if any of the segments + on the list are acknowledged by the ACK. This may seem + strange since an "unsent" segment shouldn't be acked. The + rationale is that lwIP puts all outstanding segments on the + ->unsent list after a retransmission, so these segments may + in fact have been sent once. */ + while (pcb->unsent != NULL && + TCP_SEQ_BETWEEN(ackno, ntohl(pcb->unsent->tcphdr->seqno) + + TCP_TCPLEN(pcb->unsent), pcb->snd_nxt)) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: removing %"U32_F":%"U32_F" from pcb->unsent\n", + ntohl(pcb->unsent->tcphdr->seqno), ntohl(pcb->unsent->tcphdr->seqno) + + TCP_TCPLEN(pcb->unsent))); + + next = pcb->unsent; + pcb->unsent = pcb->unsent->next; +#if TCP_OVERSIZE + if (pcb->unsent == NULL) { + pcb->unsent_oversize = 0; + } +#endif /* TCP_OVERSIZE */ + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_receive: queuelen %"TCPWNDSIZE_F" ... ", (tcpwnd_size_t)pcb->snd_queuelen)); + LWIP_ASSERT("pcb->snd_queuelen >= pbuf_clen(next->p)", (pcb->snd_queuelen >= pbuf_clen(next->p))); + /* Prevent ACK for FIN to generate a sent event */ + if ((pcb->acked != 0) && ((TCPH_FLAGS(next->tcphdr) & TCP_FIN) != 0)) { + pcb->acked--; + } + pcb->snd_queuelen -= pbuf_clen(next->p); + tcp_seg_free(next); + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("%"TCPWNDSIZE_F" (after freeing unsent)\n", (tcpwnd_size_t)pcb->snd_queuelen)); + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_receive: valid queue length", + pcb->unacked != NULL || pcb->unsent != NULL); + } + } + /* End of ACK for new data processing. */ + + LWIP_DEBUGF(TCP_RTO_DEBUG, ("tcp_receive: pcb->rttest %"U32_F" rtseq %"U32_F" ackno %"U32_F"\n", + pcb->rttest, pcb->rtseq, ackno)); + + /* RTT estimation calculations. This is done by checking if the + incoming segment acknowledges the segment we use to take a + round-trip time measurement. */ + if (pcb->rttest && TCP_SEQ_LT(pcb->rtseq, ackno)) { + /* diff between this shouldn't exceed 32K since this are tcp timer ticks + and a round-trip shouldn't be that long... */ + m = (s16_t)(tcp_ticks - pcb->rttest); + + LWIP_DEBUGF(TCP_RTO_DEBUG, ("tcp_receive: experienced rtt %"U16_F" ticks (%"U16_F" msec).\n", + m, m * TCP_SLOW_INTERVAL)); + + /* This is taken directly from VJs original code in his paper */ + m = m - (pcb->sa >> 3); + pcb->sa += m; + if (m < 0) { + m = -m; + } + m = m - (pcb->sv >> 2); + pcb->sv += m; + pcb->rto = (pcb->sa >> 3) + pcb->sv; + + LWIP_DEBUGF(TCP_RTO_DEBUG, ("tcp_receive: RTO %"U16_F" (%"U16_F" milliseconds)\n", + pcb->rto, pcb->rto * TCP_SLOW_INTERVAL)); + + pcb->rttest = 0; + } + } + + /* If the incoming segment contains data, we must process it + further unless the pcb already received a FIN. + (RFC 793, chapter 3.9, "SEGMENT ARRIVES" in states CLOSE-WAIT, CLOSING, + LAST-ACK and TIME-WAIT: "Ignore the segment text.") */ + if ((tcplen > 0) && (pcb->state < CLOSE_WAIT)) { + /* This code basically does three things: + + +) If the incoming segment contains data that is the next + in-sequence data, this data is passed to the application. This + might involve trimming the first edge of the data. The rcv_nxt + variable and the advertised window are adjusted. + + +) If the incoming segment has data that is above the next + sequence number expected (->rcv_nxt), the segment is placed on + the ->ooseq queue. This is done by finding the appropriate + place in the ->ooseq queue (which is ordered by sequence + number) and trim the segment in both ends if needed. An + immediate ACK is sent to indicate that we received an + out-of-sequence segment. + + +) Finally, we check if the first segment on the ->ooseq queue + now is in sequence (i.e., if rcv_nxt >= ooseq->seqno). If + rcv_nxt > ooseq->seqno, we must trim the first edge of the + segment on ->ooseq before we adjust rcv_nxt. The data in the + segments that are now on sequence are chained onto the + incoming segment so that we only need to call the application + once. + */ + + /* First, we check if we must trim the first edge. We have to do + this if the sequence number of the incoming segment is less + than rcv_nxt, and the sequence number plus the length of the + segment is larger than rcv_nxt. */ + /* if (TCP_SEQ_LT(seqno, pcb->rcv_nxt)) { + if (TCP_SEQ_LT(pcb->rcv_nxt, seqno + tcplen)) {*/ + if (TCP_SEQ_BETWEEN(pcb->rcv_nxt, seqno + 1, seqno + tcplen - 1)) { + /* Trimming the first edge is done by pushing the payload + pointer in the pbuf downwards. This is somewhat tricky since + we do not want to discard the full contents of the pbuf up to + the new starting point of the data since we have to keep the + TCP header which is present in the first pbuf in the chain. + + What is done is really quite a nasty hack: the first pbuf in + the pbuf chain is pointed to by inseg.p. Since we need to be + able to deallocate the whole pbuf, we cannot change this + inseg.p pointer to point to any of the later pbufs in the + chain. Instead, we point the ->payload pointer in the first + pbuf to data in one of the later pbufs. We also set the + inseg.data pointer to point to the right place. This way, the + ->p pointer will still point to the first pbuf, but the + ->p->payload pointer will point to data in another pbuf. + + After we are done with adjusting the pbuf pointers we must + adjust the ->data pointer in the seg and the segment + length.*/ + + off = pcb->rcv_nxt - seqno; + p = inseg.p; + LWIP_ASSERT("inseg.p != NULL", inseg.p); + LWIP_ASSERT("insane offset!", (off < 0x7fff)); + if (inseg.p->len < off) { + LWIP_ASSERT("pbuf too short!", (((s32_t)inseg.p->tot_len) >= off)); + new_tot_len = (u16_t)(inseg.p->tot_len - off); + while (p->len < off) { + off -= p->len; + /* KJM following line changed (with addition of new_tot_len var) + to fix bug #9076 + inseg.p->tot_len -= p->len; */ + p->tot_len = new_tot_len; + p->len = 0; + p = p->next; + } + if (pbuf_header(p, (s16_t)-off)) { + /* Do we need to cope with this failing? Assert for now */ + LWIP_ASSERT("pbuf_header failed", 0); + } + } else { + if (pbuf_header(inseg.p, (s16_t)-off)) { + /* Do we need to cope with this failing? Assert for now */ + LWIP_ASSERT("pbuf_header failed", 0); + } + } + inseg.len -= (u16_t)(pcb->rcv_nxt - seqno); + inseg.tcphdr->seqno = seqno = pcb->rcv_nxt; + } + else { + if (TCP_SEQ_LT(seqno, pcb->rcv_nxt)) { + /* the whole segment is < rcv_nxt */ + /* must be a duplicate of a packet that has already been correctly handled */ + + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: duplicate seqno %"U32_F"\n", seqno)); + tcp_ack_now(pcb); + } + } + + /* The sequence number must be within the window (above rcv_nxt + and below rcv_nxt + rcv_wnd) in order to be further + processed. */ + if (TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, + pcb->rcv_nxt + pcb->rcv_wnd - 1)) { + if (pcb->rcv_nxt == seqno) { + /* The incoming segment is the next in sequence. We check if + we have to trim the end of the segment and update rcv_nxt + and pass the data to the application. */ + tcplen = TCP_TCPLEN(&inseg); + + if (tcplen > pcb->rcv_wnd) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, + ("tcp_receive: other end overran receive window" + "seqno %"U32_F" len %"U16_F" right edge %"U32_F"\n", + seqno, tcplen, pcb->rcv_nxt + pcb->rcv_wnd)); + if (TCPH_FLAGS(inseg.tcphdr) & TCP_FIN) { + /* Must remove the FIN from the header as we're trimming + * that byte of sequence-space from the packet */ + TCPH_FLAGS_SET(inseg.tcphdr, TCPH_FLAGS(inseg.tcphdr) & ~(unsigned int)TCP_FIN); + } + /* Adjust length of segment to fit in the window. */ + TCPWND_CHECK16(pcb->rcv_wnd); + inseg.len = (u16_t)pcb->rcv_wnd; + if (TCPH_FLAGS(inseg.tcphdr) & TCP_SYN) { + inseg.len -= 1; + } + pbuf_realloc(inseg.p, inseg.len); + tcplen = TCP_TCPLEN(&inseg); + LWIP_ASSERT("tcp_receive: segment not trimmed correctly to rcv_wnd\n", + (seqno + tcplen) == (pcb->rcv_nxt + pcb->rcv_wnd)); + } +#if TCP_QUEUE_OOSEQ + /* Received in-sequence data, adjust ooseq data if: + - FIN has been received or + - inseq overlaps with ooseq */ + if (pcb->ooseq != NULL) { + if (TCPH_FLAGS(inseg.tcphdr) & TCP_FIN) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, + ("tcp_receive: received in-order FIN, binning ooseq queue\n")); + /* Received in-order FIN means anything that was received + * out of order must now have been received in-order, so + * bin the ooseq queue */ + while (pcb->ooseq != NULL) { + struct tcp_seg *old_ooseq = pcb->ooseq; + pcb->ooseq = pcb->ooseq->next; + tcp_seg_free(old_ooseq); + } + } else { + next = pcb->ooseq; + /* Remove all segments on ooseq that are covered by inseg already. + * FIN is copied from ooseq to inseg if present. */ + while (next && + TCP_SEQ_GEQ(seqno + tcplen, + next->tcphdr->seqno + next->len)) { + /* inseg cannot have FIN here (already processed above) */ + if (TCPH_FLAGS(next->tcphdr) & TCP_FIN && + (TCPH_FLAGS(inseg.tcphdr) & TCP_SYN) == 0) { + TCPH_SET_FLAG(inseg.tcphdr, TCP_FIN); + tcplen = TCP_TCPLEN(&inseg); + } + prev = next; + next = next->next; + tcp_seg_free(prev); + } + /* Now trim right side of inseg if it overlaps with the first + * segment on ooseq */ + if (next && + TCP_SEQ_GT(seqno + tcplen, + next->tcphdr->seqno)) { + /* inseg cannot have FIN here (already processed above) */ + inseg.len = (u16_t)(next->tcphdr->seqno - seqno); + if (TCPH_FLAGS(inseg.tcphdr) & TCP_SYN) { + inseg.len -= 1; + } + pbuf_realloc(inseg.p, inseg.len); + tcplen = TCP_TCPLEN(&inseg); + LWIP_ASSERT("tcp_receive: segment not trimmed correctly to ooseq queue\n", + (seqno + tcplen) == next->tcphdr->seqno); + } + pcb->ooseq = next; + } + } +#endif /* TCP_QUEUE_OOSEQ */ + + pcb->rcv_nxt = seqno + tcplen; + + /* Update the receiver's (our) window. */ + LWIP_ASSERT("tcp_receive: tcplen > rcv_wnd\n", pcb->rcv_wnd >= tcplen); + pcb->rcv_wnd -= tcplen; + + tcp_update_rcv_ann_wnd(pcb); + + /* If there is data in the segment, we make preparations to + pass this up to the application. The ->recv_data variable + is used for holding the pbuf that goes to the + application. The code for reassembling out-of-sequence data + chains its data on this pbuf as well. + + If the segment was a FIN, we set the TF_GOT_FIN flag that will + be used to indicate to the application that the remote side has + closed its end of the connection. */ + if (inseg.p->tot_len > 0) { + recv_data = inseg.p; + /* Since this pbuf now is the responsibility of the + application, we delete our reference to it so that we won't + (mistakingly) deallocate it. */ + inseg.p = NULL; + } + if (TCPH_FLAGS(inseg.tcphdr) & TCP_FIN) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: received FIN.\n")); + recv_flags |= TF_GOT_FIN; + } + +#if TCP_QUEUE_OOSEQ + /* We now check if we have segments on the ->ooseq queue that + are now in sequence. */ + while (pcb->ooseq != NULL && + pcb->ooseq->tcphdr->seqno == pcb->rcv_nxt) { + + cseg = pcb->ooseq; + seqno = pcb->ooseq->tcphdr->seqno; + + pcb->rcv_nxt += TCP_TCPLEN(cseg); + LWIP_ASSERT("tcp_receive: ooseq tcplen > rcv_wnd\n", + pcb->rcv_wnd >= TCP_TCPLEN(cseg)); + pcb->rcv_wnd -= TCP_TCPLEN(cseg); + + tcp_update_rcv_ann_wnd(pcb); + + if (cseg->p->tot_len > 0) { + /* Chain this pbuf onto the pbuf that we will pass to + the application. */ + /* With window scaling, this can overflow recv_data->tot_len, but + that's not a problem since we explicitly fix that before passing + recv_data to the application. */ + if (recv_data) { + pbuf_cat(recv_data, cseg->p); + } else { + recv_data = cseg->p; + } + cseg->p = NULL; + } + if (TCPH_FLAGS(cseg->tcphdr) & TCP_FIN) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_receive: dequeued FIN.\n")); + recv_flags |= TF_GOT_FIN; + if (pcb->state == ESTABLISHED) { /* force passive close or we can move to active close */ + pcb->state = CLOSE_WAIT; + } + } + + pcb->ooseq = cseg->next; + tcp_seg_free(cseg); + } +#endif /* TCP_QUEUE_OOSEQ */ + + + /* Acknowledge the segment(s). */ + tcp_ack(pcb); + +#if LWIP_IPV6 && LWIP_ND6_TCP_REACHABILITY_HINTS + if (ip_current_is_v6()) { + /* Inform neighbor reachability of forward progress. */ + nd6_reachability_hint(ip6_current_src_addr()); + } +#endif /* LWIP_IPV6 && LWIP_ND6_TCP_REACHABILITY_HINTS*/ + + } else { + /* We get here if the incoming segment is out-of-sequence. */ + tcp_send_empty_ack(pcb); +#if TCP_QUEUE_OOSEQ + /* We queue the segment on the ->ooseq queue. */ + if (pcb->ooseq == NULL) { + pcb->ooseq = tcp_seg_copy(&inseg); + } else { + /* If the queue is not empty, we walk through the queue and + try to find a place where the sequence number of the + incoming segment is between the sequence numbers of the + previous and the next segment on the ->ooseq queue. That is + the place where we put the incoming segment. If needed, we + trim the second edges of the previous and the incoming + segment so that it will fit into the sequence. + + If the incoming segment has the same sequence number as a + segment on the ->ooseq queue, we discard the segment that + contains less data. */ + + prev = NULL; + for (next = pcb->ooseq; next != NULL; next = next->next) { + if (seqno == next->tcphdr->seqno) { + /* The sequence number of the incoming segment is the + same as the sequence number of the segment on + ->ooseq. We check the lengths to see which one to + discard. */ + if (inseg.len > next->len) { + /* The incoming segment is larger than the old + segment. We replace some segments with the new + one. */ + cseg = tcp_seg_copy(&inseg); + if (cseg != NULL) { + if (prev != NULL) { + prev->next = cseg; + } else { + pcb->ooseq = cseg; + } + tcp_oos_insert_segment(cseg, next); + } + break; + } else { + /* Either the lengths are the same or the incoming + segment was smaller than the old one; in either + case, we ditch the incoming segment. */ + break; + } + } else { + if (prev == NULL) { + if (TCP_SEQ_LT(seqno, next->tcphdr->seqno)) { + /* The sequence number of the incoming segment is lower + than the sequence number of the first segment on the + queue. We put the incoming segment first on the + queue. */ + cseg = tcp_seg_copy(&inseg); + if (cseg != NULL) { + pcb->ooseq = cseg; + tcp_oos_insert_segment(cseg, next); + } + break; + } + } else { + /*if (TCP_SEQ_LT(prev->tcphdr->seqno, seqno) && + TCP_SEQ_LT(seqno, next->tcphdr->seqno)) {*/ + if (TCP_SEQ_BETWEEN(seqno, prev->tcphdr->seqno+1, next->tcphdr->seqno-1)) { + /* The sequence number of the incoming segment is in + between the sequence numbers of the previous and + the next segment on ->ooseq. We trim trim the previous + segment, delete next segments that included in received segment + and trim received, if needed. */ + cseg = tcp_seg_copy(&inseg); + if (cseg != NULL) { + if (TCP_SEQ_GT(prev->tcphdr->seqno + prev->len, seqno)) { + /* We need to trim the prev segment. */ + prev->len = (u16_t)(seqno - prev->tcphdr->seqno); + pbuf_realloc(prev->p, prev->len); + } + prev->next = cseg; + tcp_oos_insert_segment(cseg, next); + } + break; + } + } + /* If the "next" segment is the last segment on the + ooseq queue, we add the incoming segment to the end + of the list. */ + if (next->next == NULL && + TCP_SEQ_GT(seqno, next->tcphdr->seqno)) { + if (TCPH_FLAGS(next->tcphdr) & TCP_FIN) { + /* segment "next" already contains all data */ + break; + } + next->next = tcp_seg_copy(&inseg); + if (next->next != NULL) { + if (TCP_SEQ_GT(next->tcphdr->seqno + next->len, seqno)) { + /* We need to trim the last segment. */ + next->len = (u16_t)(seqno - next->tcphdr->seqno); + pbuf_realloc(next->p, next->len); + } + /* check if the remote side overruns our receive window */ + if (TCP_SEQ_GT((u32_t)tcplen + seqno, pcb->rcv_nxt + (u32_t)pcb->rcv_wnd)) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, + ("tcp_receive: other end overran receive window" + "seqno %"U32_F" len %"U16_F" right edge %"U32_F"\n", + seqno, tcplen, pcb->rcv_nxt + pcb->rcv_wnd)); + if (TCPH_FLAGS(next->next->tcphdr) & TCP_FIN) { + /* Must remove the FIN from the header as we're trimming + * that byte of sequence-space from the packet */ + TCPH_FLAGS_SET(next->next->tcphdr, TCPH_FLAGS(next->next->tcphdr) & ~TCP_FIN); + } + /* Adjust length of segment to fit in the window. */ + next->next->len = (u16_t)(pcb->rcv_nxt + pcb->rcv_wnd - seqno); + pbuf_realloc(next->next->p, next->next->len); + tcplen = TCP_TCPLEN(next->next); + LWIP_ASSERT("tcp_receive: segment not trimmed correctly to rcv_wnd\n", + (seqno + tcplen) == (pcb->rcv_nxt + pcb->rcv_wnd)); + } + } + break; + } + } + prev = next; + } + } +#if TCP_OOSEQ_MAX_BYTES || TCP_OOSEQ_MAX_PBUFS + /* Check that the data on ooseq doesn't exceed one of the limits + and throw away everything above that limit. */ + ooseq_blen = 0; + ooseq_qlen = 0; + prev = NULL; + for (next = pcb->ooseq; next != NULL; prev = next, next = next->next) { + struct pbuf *p = next->p; + ooseq_blen += p->tot_len; + ooseq_qlen += pbuf_clen(p); + if ((ooseq_blen > TCP_OOSEQ_MAX_BYTES) || + (ooseq_qlen > TCP_OOSEQ_MAX_PBUFS)) { + /* too much ooseq data, dump this and everything after it */ + tcp_segs_free(next); + if (prev == NULL) { + /* first ooseq segment is too much, dump the whole queue */ + pcb->ooseq = NULL; + } else { + /* just dump 'next' and everything after it */ + prev->next = NULL; + } + break; + } + } +#endif /* TCP_OOSEQ_MAX_BYTES || TCP_OOSEQ_MAX_PBUFS */ +#endif /* TCP_QUEUE_OOSEQ */ + } + } else { + /* The incoming segment is not within the window. */ + tcp_send_empty_ack(pcb); + } + } else { + /* Segments with length 0 is taken care of here. Segments that + fall out of the window are ACKed. */ + if (!TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, pcb->rcv_nxt + pcb->rcv_wnd - 1)) { + tcp_ack_now(pcb); + } + } +} + +static u8_t +tcp_getoptbyte(void) +{ + if ((tcphdr_opt2 == NULL) || (tcp_optidx < tcphdr_opt1len)) { + u8_t* opts = (u8_t *)tcphdr + TCP_HLEN; + return opts[tcp_optidx++]; + } else { + u8_t idx = (u8_t)(tcp_optidx++ - tcphdr_opt1len); + return tcphdr_opt2[idx]; + } +} + +/** + * Parses the options contained in the incoming segment. + * + * Called from tcp_listen_input() and tcp_process(). + * Currently, only the MSS option is supported! + * + * @param pcb the tcp_pcb for which a segment arrived + */ +static void +tcp_parseopt(struct tcp_pcb *pcb) +{ + u8_t data; + u16_t mss; +#if LWIP_TCP_TIMESTAMPS + u32_t tsval; +#endif + + /* Parse the TCP MSS option, if present. */ + if (tcphdr_optlen != 0) { + for (tcp_optidx = 0; tcp_optidx < tcphdr_optlen; ) { + u8_t opt = tcp_getoptbyte(); + switch (opt) { + case LWIP_TCP_OPT_EOL: + /* End of options. */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: EOL\n")); + return; + case LWIP_TCP_OPT_NOP: + /* NOP option. */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: NOP\n")); + break; + case LWIP_TCP_OPT_MSS: + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: MSS\n")); + if (tcp_getoptbyte() != LWIP_TCP_OPT_LEN_MSS || (tcp_optidx - 2 + LWIP_TCP_OPT_LEN_MSS) > tcphdr_optlen) { + /* Bad length */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); + return; + } + /* An MSS option with the right option length. */ + mss = (tcp_getoptbyte() << 8); + mss |= tcp_getoptbyte(); + /* Limit the mss to the configured TCP_MSS and prevent division by zero */ + pcb->mss = ((mss > TCP_MSS) || (mss == 0)) ? TCP_MSS : mss; + break; +#if LWIP_WND_SCALE + case LWIP_TCP_OPT_WS: + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: WND_SCALE\n")); + if (tcp_getoptbyte() != LWIP_TCP_OPT_LEN_WS || (tcp_optidx - 2 + LWIP_TCP_OPT_LEN_WS) > tcphdr_optlen) { + /* Bad length */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); + return; + } + /* If syn was received with wnd scale option, + activate wnd scale opt, but only if this is not a retransmission */ + if ((flags & TCP_SYN) && !(pcb->flags & TF_WND_SCALE)) { + /* An WND_SCALE option with the right option length. */ + data = tcp_getoptbyte(); + pcb->snd_scale = data; + if (pcb->snd_scale > 14U) { + pcb->snd_scale = 14U; + } + pcb->rcv_scale = TCP_RCV_SCALE; + pcb->flags |= TF_WND_SCALE; + /* window scaling is enabled, we can use the full receive window */ + LWIP_ASSERT("window not at default value", pcb->rcv_wnd == TCPWND_MIN16(TCP_WND)); + LWIP_ASSERT("window not at default value", pcb->rcv_ann_wnd == TCPWND_MIN16(TCP_WND)); + pcb->rcv_wnd = pcb->rcv_ann_wnd = TCP_WND; + } + break; +#endif +#if LWIP_TCP_TIMESTAMPS + case LWIP_TCP_OPT_TS: + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: TS\n")); + if (tcp_getoptbyte() != LWIP_TCP_OPT_LEN_TS || (tcp_optidx - 2 + LWIP_TCP_OPT_LEN_TS) > tcphdr_optlen) { + /* Bad length */ + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); + return; + } + /* TCP timestamp option with valid length */ + tsval = tcp_getoptbyte(); + tsval |= (tcp_getoptbyte() << 8); + tsval |= (tcp_getoptbyte() << 16); + tsval |= (tcp_getoptbyte() << 24); + if (flags & TCP_SYN) { + pcb->ts_recent = ntohl(tsval); + /* Enable sending timestamps in every segment now that we know + the remote host supports it. */ + pcb->flags |= TF_TIMESTAMP; + } else if (TCP_SEQ_BETWEEN(pcb->ts_lastacksent, seqno, seqno+tcplen)) { + pcb->ts_recent = ntohl(tsval); + } + /* Advance to next option (6 bytes already read) */ + tcp_optidx += LWIP_TCP_OPT_LEN_TS - 6; + break; +#endif + default: + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: other\n")); + data = tcp_getoptbyte(); + if (data < 2) { + LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); + /* If the length field is zero, the options are malformed + and we don't process them further. */ + return; + } + /* All other options have a length field, so that we easily + can skip past them. */ + tcp_optidx += data - 2; + } + } + } +} + +void +tcp_trigger_input_pcb_close(void) +{ + recv_flags |= TF_CLOSED; +} + +#endif /* LWIP_TCP */ diff --git a/components/lwip/core/tcp_out.c b/components/lwip/core/tcp_out.c new file mode 100755 index 000000000..aac02e4eb --- /dev/null +++ b/components/lwip/core/tcp_out.c @@ -0,0 +1,1614 @@ +/** + * @file + * Transmission Control Protocol, outgoing traffic + * + * The output functions of TCP. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/priv/tcp_priv.h" +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/memp.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/inet_chksum.h" +#include "lwip/stats.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#if LWIP_TCP_TIMESTAMPS +#include "lwip/sys.h" +#endif + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +/* Define some copy-macros for checksum-on-copy so that the code looks + nicer by preventing too many ifdef's. */ +#if TCP_CHECKSUM_ON_COPY +#define TCP_DATA_COPY(dst, src, len, seg) do { \ + tcp_seg_add_chksum(LWIP_CHKSUM_COPY(dst, src, len), \ + len, &seg->chksum, &seg->chksum_swapped); \ + seg->flags |= TF_SEG_DATA_CHECKSUMMED; } while(0) +#define TCP_DATA_COPY2(dst, src, len, chksum, chksum_swapped) \ + tcp_seg_add_chksum(LWIP_CHKSUM_COPY(dst, src, len), len, chksum, chksum_swapped); +#else /* TCP_CHECKSUM_ON_COPY*/ +#define TCP_DATA_COPY(dst, src, len, seg) MEMCPY(dst, src, len) +#define TCP_DATA_COPY2(dst, src, len, chksum, chksum_swapped) MEMCPY(dst, src, len) +#endif /* TCP_CHECKSUM_ON_COPY*/ + +/** Define this to 1 for an extra check that the output checksum is valid + * (usefule when the checksum is generated by the application, not the stack) */ +#ifndef TCP_CHECKSUM_ON_COPY_SANITY_CHECK +#define TCP_CHECKSUM_ON_COPY_SANITY_CHECK 0 +#endif +/* Allow to override the failure of sanity check from warning to e.g. hard failure */ +#if TCP_CHECKSUM_ON_COPY_SANITY_CHECK +#ifndef TCP_CHECKSUM_ON_COPY_SANITY_CHECK_FAIL +#define TCP_CHECKSUM_ON_COPY_SANITY_CHECK_FAIL(msg) LWIP_DEBUGF(TCP_DEBUG | LWIP_DBG_LEVEL_WARNING, msg) +#endif +#endif + +#if TCP_OVERSIZE +/** The size of segment pbufs created when TCP_OVERSIZE is enabled */ +#ifndef TCP_OVERSIZE_CALC_LENGTH +#define TCP_OVERSIZE_CALC_LENGTH(length) ((length) + TCP_OVERSIZE) +#endif +#endif + +/* Forward declarations.*/ +static err_t tcp_output_segment(struct tcp_seg *seg, struct tcp_pcb *pcb); + +/** Allocate a pbuf and create a tcphdr at p->payload, used for output + * functions other than the default tcp_output -> tcp_output_segment + * (e.g. tcp_send_empty_ack, etc.) + * + * @param pcb tcp pcb for which to send a packet (used to initialize tcp_hdr) + * @param optlen length of header-options + * @param datalen length of tcp data to reserve in pbuf + * @param seqno_be seqno in network byte order (big-endian) + * @return pbuf with p->payload being the tcp_hdr + */ +static struct pbuf * +tcp_output_alloc_header(struct tcp_pcb *pcb, u16_t optlen, u16_t datalen, + u32_t seqno_be /* already in network byte order */) +{ + struct tcp_hdr *tcphdr; + struct pbuf *p = pbuf_alloc(PBUF_IP, TCP_HLEN + optlen + datalen, PBUF_RAM); + if (p != NULL) { + LWIP_ASSERT("check that first pbuf can hold struct tcp_hdr", + (p->len >= TCP_HLEN + optlen)); + tcphdr = (struct tcp_hdr *)p->payload; + tcphdr->src = htons(pcb->local_port); + tcphdr->dest = htons(pcb->remote_port); + tcphdr->seqno = seqno_be; + tcphdr->ackno = htonl(pcb->rcv_nxt); + TCPH_HDRLEN_FLAGS_SET(tcphdr, (5 + optlen / 4), TCP_ACK); + tcphdr->wnd = htons(TCPWND_MIN16(RCV_WND_SCALE(pcb, pcb->rcv_ann_wnd))); + tcphdr->chksum = 0; + tcphdr->urgp = 0; + + /* If we're sending a packet, update the announced right window edge */ + pcb->rcv_ann_right_edge = pcb->rcv_nxt + pcb->rcv_ann_wnd; + } + return p; +} + +/** + * Called by tcp_close() to send a segment including FIN flag but not data. + * + * @param pcb the tcp_pcb over which to send a segment + * @return ERR_OK if sent, another err_t otherwise + */ +err_t +tcp_send_fin(struct tcp_pcb *pcb) +{ + /* first, try to add the fin to the last unsent segment */ + if (pcb->unsent != NULL) { + struct tcp_seg *last_unsent; + for (last_unsent = pcb->unsent; last_unsent->next != NULL; + last_unsent = last_unsent->next); + + if ((TCPH_FLAGS(last_unsent->tcphdr) & (TCP_SYN | TCP_FIN | TCP_RST)) == 0) { + /* no SYN/FIN/RST flag in the header, we can add the FIN flag */ + TCPH_SET_FLAG(last_unsent->tcphdr, TCP_FIN); + pcb->flags |= TF_FIN; + return ERR_OK; + } + } + /* no data, no length, flags, copy=1, no optdata */ + return tcp_enqueue_flags(pcb, TCP_FIN); +} + +/** + * Create a TCP segment with prefilled header. + * + * Called by tcp_write and tcp_enqueue_flags. + * + * @param pcb Protocol control block for the TCP connection. + * @param p pbuf that is used to hold the TCP header. + * @param flags TCP flags for header. + * @param seqno TCP sequence number of this packet + * @param optflags options to include in TCP header + * @return a new tcp_seg pointing to p, or NULL. + * The TCP header is filled in except ackno and wnd. + * p is freed on failure. + */ +static struct tcp_seg * +tcp_create_segment(struct tcp_pcb *pcb, struct pbuf *p, u8_t flags, u32_t seqno, u8_t optflags) +{ + struct tcp_seg *seg; + u8_t optlen = LWIP_TCP_OPT_LENGTH(optflags); + + if ((seg = (struct tcp_seg *)memp_malloc(MEMP_TCP_SEG)) == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_create_segment: no memory.\n")); + pbuf_free(p); + return NULL; + } + seg->flags = optflags; + seg->next = NULL; + seg->p = p; + LWIP_ASSERT("p->tot_len >= optlen", p->tot_len >= optlen); + seg->len = p->tot_len - optlen; +#if TCP_OVERSIZE_DBGCHECK + seg->oversize_left = 0; +#endif /* TCP_OVERSIZE_DBGCHECK */ +#if TCP_CHECKSUM_ON_COPY + seg->chksum = 0; + seg->chksum_swapped = 0; + /* check optflags */ + LWIP_ASSERT("invalid optflags passed: TF_SEG_DATA_CHECKSUMMED", + (optflags & TF_SEG_DATA_CHECKSUMMED) == 0); +#endif /* TCP_CHECKSUM_ON_COPY */ + + /* build TCP header */ + if (pbuf_header(p, TCP_HLEN)) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_create_segment: no room for TCP header in pbuf.\n")); + TCP_STATS_INC(tcp.err); + tcp_seg_free(seg); + return NULL; + } + seg->tcphdr = (struct tcp_hdr *)seg->p->payload; + seg->tcphdr->src = htons(pcb->local_port); + seg->tcphdr->dest = htons(pcb->remote_port); + seg->tcphdr->seqno = htonl(seqno); + /* ackno is set in tcp_output */ + TCPH_HDRLEN_FLAGS_SET(seg->tcphdr, (5 + optlen / 4), flags); + /* wnd and chksum are set in tcp_output */ + seg->tcphdr->urgp = 0; + return seg; +} + +/** + * Allocate a PBUF_RAM pbuf, perhaps with extra space at the end. + * + * This function is like pbuf_alloc(layer, length, PBUF_RAM) except + * there may be extra bytes available at the end. + * + * @param layer flag to define header size. + * @param length size of the pbuf's payload. + * @param max_length maximum usable size of payload+oversize. + * @param oversize pointer to a u16_t that will receive the number of usable tail bytes. + * @param pcb The TCP connection that willo enqueue the pbuf. + * @param apiflags API flags given to tcp_write. + * @param first_seg true when this pbuf will be used in the first enqueued segment. + */ +#if TCP_OVERSIZE +static struct pbuf * +tcp_pbuf_prealloc(pbuf_layer layer, u16_t length, u16_t max_length, + u16_t *oversize, struct tcp_pcb *pcb, u8_t apiflags, + u8_t first_seg) +{ + struct pbuf *p; + u16_t alloc = length; + +#if LWIP_NETIF_TX_SINGLE_PBUF + LWIP_UNUSED_ARG(max_length); + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(apiflags); + LWIP_UNUSED_ARG(first_seg); + /* always create MSS-sized pbufs */ + alloc = max_length; +#else /* LWIP_NETIF_TX_SINGLE_PBUF */ + if (length < max_length) { + /* Should we allocate an oversized pbuf, or just the minimum + * length required? If tcp_write is going to be called again + * before this segment is transmitted, we want the oversized + * buffer. If the segment will be transmitted immediately, we can + * save memory by allocating only length. We use a simple + * heuristic based on the following information: + * + * Did the user set TCP_WRITE_FLAG_MORE? + * + * Will the Nagle algorithm defer transmission of this segment? + */ + if ((apiflags & TCP_WRITE_FLAG_MORE) || + (!(pcb->flags & TF_NODELAY) && + (!first_seg || + pcb->unsent != NULL || + pcb->unacked != NULL))) { + alloc = LWIP_MIN(max_length, LWIP_MEM_ALIGN_SIZE(TCP_OVERSIZE_CALC_LENGTH(length))); + } + } +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ + p = pbuf_alloc(layer, alloc, PBUF_RAM); + if (p == NULL) { + return NULL; + } + LWIP_ASSERT("need unchained pbuf", p->next == NULL); + *oversize = p->len - length; + /* trim p->len to the currently used size */ + p->len = p->tot_len = length; + return p; +} +#else /* TCP_OVERSIZE */ +#define tcp_pbuf_prealloc(layer, length, mx, os, pcb, api, fst) pbuf_alloc((layer), (length), PBUF_RAM) +#endif /* TCP_OVERSIZE */ + +#if TCP_CHECKSUM_ON_COPY +/** Add a checksum of newly added data to the segment */ +static void +tcp_seg_add_chksum(u16_t chksum, u16_t len, u16_t *seg_chksum, + u8_t *seg_chksum_swapped) +{ + u32_t helper; + /* add chksum to old chksum and fold to u16_t */ + helper = chksum + *seg_chksum; + chksum = FOLD_U32T(helper); + if ((len & 1) != 0) { + *seg_chksum_swapped = 1 - *seg_chksum_swapped; + chksum = SWAP_BYTES_IN_WORD(chksum); + } + *seg_chksum = chksum; +} +#endif /* TCP_CHECKSUM_ON_COPY */ + +/** Checks if tcp_write is allowed or not (checks state, snd_buf and snd_queuelen). + * + * @param pcb the tcp pcb to check for + * @param len length of data to send (checked agains snd_buf) + * @return ERR_OK if tcp_write is allowed to proceed, another err_t otherwise + */ +static err_t +tcp_write_checks(struct tcp_pcb *pcb, u16_t len) +{ + /* connection is in invalid state for data transmission? */ + if ((pcb->state != ESTABLISHED) && + (pcb->state != CLOSE_WAIT) && + (pcb->state != SYN_SENT) && + (pcb->state != SYN_RCVD)) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_STATE | LWIP_DBG_LEVEL_SEVERE, ("tcp_write() called in invalid state\n")); + return ERR_CONN; + } else if (len == 0) { + return ERR_OK; + } + + /* fail on too much data */ + if (len > pcb->snd_buf) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("tcp_write: too much data (len=%"U16_F" > snd_buf=%"TCPWNDSIZE_F")\n", + len, pcb->snd_buf)); + pcb->flags |= TF_NAGLEMEMERR; + return ERR_MEM; + } + + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_write: queuelen: %"TCPWNDSIZE_F"\n", (tcpwnd_size_t)pcb->snd_queuelen)); + + /* If total number of pbufs on the unsent/unacked queues exceeds the + * configured maximum, return an error */ + /* check for configured max queuelen and possible overflow */ + if ((pcb->snd_queuelen >= TCP_SND_QUEUELEN) || (pcb->snd_queuelen > TCP_SNDQUEUELEN_OVERFLOW)) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("tcp_write: too long queue %"U16_F" (max %"U16_F")\n", + pcb->snd_queuelen, TCP_SND_QUEUELEN)); + TCP_STATS_INC(tcp.memerr); + pcb->flags |= TF_NAGLEMEMERR; + return ERR_MEM; + } + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_write: pbufs on queue => at least one queue non-empty", + pcb->unacked != NULL || pcb->unsent != NULL); + } else { + LWIP_ASSERT("tcp_write: no pbufs on queue => both queues empty", + pcb->unacked == NULL && pcb->unsent == NULL); + } + return ERR_OK; +} + +/** + * Write data for sending (but does not send it immediately). + * + * It waits in the expectation of more data being sent soon (as + * it can send them more efficiently by combining them together). + * To prompt the system to send data now, call tcp_output() after + * calling tcp_write(). + * + * @param pcb Protocol control block for the TCP connection to enqueue data for. + * @param arg Pointer to the data to be enqueued for sending. + * @param len Data length in bytes + * @param apiflags combination of following flags : + * - TCP_WRITE_FLAG_COPY (0x01) data will be copied into memory belonging to the stack + * - TCP_WRITE_FLAG_MORE (0x02) for TCP connection, PSH flag will not be set on last segment sent, + * @return ERR_OK if enqueued, another err_t on error + */ +err_t +tcp_write(struct tcp_pcb *pcb, const void *arg, u16_t len, u8_t apiflags) +{ + struct pbuf *concat_p = NULL; + struct tcp_seg *last_unsent = NULL, *seg = NULL, *prev_seg = NULL, *queue = NULL; + u16_t pos = 0; /* position in 'arg' data */ + u16_t queuelen; + u8_t optlen = 0; + u8_t optflags = 0; +#if TCP_OVERSIZE + u16_t oversize = 0; + u16_t oversize_used = 0; +#endif /* TCP_OVERSIZE */ +#if TCP_CHECKSUM_ON_COPY + u16_t concat_chksum = 0; + u8_t concat_chksum_swapped = 0; + u16_t concat_chksummed = 0; +#endif /* TCP_CHECKSUM_ON_COPY */ + err_t err; + /* don't allocate segments bigger than half the maximum window we ever received */ + u16_t mss_local = LWIP_MIN(pcb->mss, TCPWND_MIN16(pcb->snd_wnd_max/2)); + mss_local = mss_local ? mss_local : pcb->mss; + +#if LWIP_NETIF_TX_SINGLE_PBUF + /* Always copy to try to create single pbufs for TX */ + apiflags |= TCP_WRITE_FLAG_COPY; +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ + + LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_write(pcb=%p, data=%p, len=%"U16_F", apiflags=%"U16_F")\n", + (void *)pcb, arg, len, (u16_t)apiflags)); + LWIP_ERROR("tcp_write: arg == NULL (programmer violates API)", + arg != NULL, return ERR_ARG;); + + err = tcp_write_checks(pcb, len); + if (err != ERR_OK) { + return err; + } + queuelen = pcb->snd_queuelen; + +#if LWIP_TCP_TIMESTAMPS + if ((pcb->flags & TF_TIMESTAMP)) { + /* Make sure the timestamp option is only included in data segments if we + agreed about it with the remote host. */ + optflags = TF_SEG_OPTS_TS; + optlen = LWIP_TCP_OPT_LENGTH(TF_SEG_OPTS_TS); + /* ensure that segments can hold at least one data byte... */ + mss_local = LWIP_MAX(mss_local, LWIP_TCP_OPT_LEN_TS + 1); + } +#endif /* LWIP_TCP_TIMESTAMPS */ + + + /* + * TCP segmentation is done in three phases with increasing complexity: + * + * 1. Copy data directly into an oversized pbuf. + * 2. Chain a new pbuf to the end of pcb->unsent. + * 3. Create new segments. + * + * We may run out of memory at any point. In that case we must + * return ERR_MEM and not change anything in pcb. Therefore, all + * changes are recorded in local variables and committed at the end + * of the function. Some pcb fields are maintained in local copies: + * + * queuelen = pcb->snd_queuelen + * oversize = pcb->unsent_oversize + * + * These variables are set consistently by the phases: + * + * seg points to the last segment tampered with. + * + * pos records progress as data is segmented. + */ + + /* Find the tail of the unsent queue. */ + if (pcb->unsent != NULL) { + u16_t space; + u16_t unsent_optlen; + + /* @todo: this could be sped up by keeping last_unsent in the pcb */ + for (last_unsent = pcb->unsent; last_unsent->next != NULL; + last_unsent = last_unsent->next); + + /* Usable space at the end of the last unsent segment */ + unsent_optlen = LWIP_TCP_OPT_LENGTH(last_unsent->flags); + LWIP_ASSERT("mss_local is too small", mss_local >= last_unsent->len + unsent_optlen); + space = mss_local - (last_unsent->len + unsent_optlen); + + /* + * Phase 1: Copy data directly into an oversized pbuf. + * + * The number of bytes copied is recorded in the oversize_used + * variable. The actual copying is done at the bottom of the + * function. + */ +#if TCP_OVERSIZE +#if TCP_OVERSIZE_DBGCHECK + /* check that pcb->unsent_oversize matches last_unsent->unsent_oversize */ + LWIP_ASSERT("unsent_oversize mismatch (pcb vs. last_unsent)", + pcb->unsent_oversize == last_unsent->oversize_left); +#endif /* TCP_OVERSIZE_DBGCHECK */ + oversize = pcb->unsent_oversize; + if (oversize > 0) { + LWIP_ASSERT("inconsistent oversize vs. space", oversize_used <= space); + seg = last_unsent; + oversize_used = oversize < len ? oversize : len; + pos += oversize_used; + oversize -= oversize_used; + space -= oversize_used; + } + /* now we are either finished or oversize is zero */ + LWIP_ASSERT("inconsistend oversize vs. len", (oversize == 0) || (pos == len)); +#endif /* TCP_OVERSIZE */ + + /* + * Phase 2: Chain a new pbuf to the end of pcb->unsent. + * + * We don't extend segments containing SYN/FIN flags or options + * (len==0). The new pbuf is kept in concat_p and pbuf_cat'ed at + * the end. + */ + if ((pos < len) && (space > 0) && (last_unsent->len > 0)) { + u16_t seglen = space < len - pos ? space : len - pos; + seg = last_unsent; + + /* Create a pbuf with a copy or reference to seglen bytes. We + * can use PBUF_RAW here since the data appears in the middle of + * a segment. A header will never be prepended. */ + if (apiflags & TCP_WRITE_FLAG_COPY) { + /* Data is copied */ + if ((concat_p = tcp_pbuf_prealloc(PBUF_RAW, seglen, space, &oversize, pcb, apiflags, 1)) == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("tcp_write : could not allocate memory for pbuf copy size %"U16_F"\n", + seglen)); + goto memerr; + } +#if TCP_OVERSIZE_DBGCHECK + last_unsent->oversize_left += oversize; +#endif /* TCP_OVERSIZE_DBGCHECK */ + TCP_DATA_COPY2(concat_p->payload, (const u8_t*)arg + pos, seglen, &concat_chksum, &concat_chksum_swapped); +#if TCP_CHECKSUM_ON_COPY + concat_chksummed += seglen; +#endif /* TCP_CHECKSUM_ON_COPY */ + } else { + /* Data is not copied */ + if ((concat_p = pbuf_alloc(PBUF_RAW, seglen, PBUF_ROM)) == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("tcp_write: could not allocate memory for zero-copy pbuf\n")); + goto memerr; + } +#if TCP_CHECKSUM_ON_COPY + /* calculate the checksum of nocopy-data */ + tcp_seg_add_chksum(~inet_chksum((const u8_t*)arg + pos, seglen), seglen, + &concat_chksum, &concat_chksum_swapped); + concat_chksummed += seglen; +#endif /* TCP_CHECKSUM_ON_COPY */ + /* reference the non-volatile payload data */ + ((struct pbuf_rom*)concat_p)->payload = (const u8_t*)arg + pos; + } + + pos += seglen; + queuelen += pbuf_clen(concat_p); + } + } else { +#if TCP_OVERSIZE + LWIP_ASSERT("unsent_oversize mismatch (pcb->unsent is NULL)", + pcb->unsent_oversize == 0); +#endif /* TCP_OVERSIZE */ + } + + /* + * Phase 3: Create new segments. + * + * The new segments are chained together in the local 'queue' + * variable, ready to be appended to pcb->unsent. + */ + while (pos < len) { + struct pbuf *p; + u16_t left = len - pos; + u16_t max_len = mss_local - optlen; + u16_t seglen = left > max_len ? max_len : left; +#if TCP_CHECKSUM_ON_COPY + u16_t chksum = 0; + u8_t chksum_swapped = 0; +#endif /* TCP_CHECKSUM_ON_COPY */ + + if (apiflags & TCP_WRITE_FLAG_COPY) { + /* If copy is set, memory should be allocated and data copied + * into pbuf */ + if ((p = tcp_pbuf_prealloc(PBUF_TRANSPORT, seglen + optlen, mss_local, &oversize, pcb, apiflags, queue == NULL)) == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_write : could not allocate memory for pbuf copy size %"U16_F"\n", seglen)); + goto memerr; + } + LWIP_ASSERT("tcp_write: check that first pbuf can hold the complete seglen", + (p->len >= seglen)); + TCP_DATA_COPY2((char *)p->payload + optlen, (const u8_t*)arg + pos, seglen, &chksum, &chksum_swapped); + } else { + /* Copy is not set: First allocate a pbuf for holding the data. + * Since the referenced data is available at least until it is + * sent out on the link (as it has to be ACKed by the remote + * party) we can safely use PBUF_ROM instead of PBUF_REF here. + */ + struct pbuf *p2; +#if TCP_OVERSIZE + LWIP_ASSERT("oversize == 0", oversize == 0); +#endif /* TCP_OVERSIZE */ + if ((p2 = pbuf_alloc(PBUF_TRANSPORT, seglen, PBUF_ROM)) == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_write: could not allocate memory for zero-copy pbuf\n")); + goto memerr; + } +#if TCP_CHECKSUM_ON_COPY + /* calculate the checksum of nocopy-data */ + chksum = ~inet_chksum((const u8_t*)arg + pos, seglen); + if (seglen & 1) { + chksum_swapped = 1; + chksum = SWAP_BYTES_IN_WORD(chksum); + } +#endif /* TCP_CHECKSUM_ON_COPY */ + /* reference the non-volatile payload data */ + ((struct pbuf_rom*)p2)->payload = (const u8_t*)arg + pos; + + /* Second, allocate a pbuf for the headers. */ + if ((p = pbuf_alloc(PBUF_TRANSPORT, optlen, PBUF_RAM)) == NULL) { + /* If allocation fails, we have to deallocate the data pbuf as + * well. */ + pbuf_free(p2); + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_write: could not allocate memory for header pbuf\n")); + goto memerr; + } + /* Concatenate the headers and data pbufs together. */ + pbuf_cat(p/*header*/, p2/*data*/); + } + + queuelen += pbuf_clen(p); + + /* Now that there are more segments queued, we check again if the + * length of the queue exceeds the configured maximum or + * overflows. */ + if ((queuelen > TCP_SND_QUEUELEN) || (queuelen > TCP_SNDQUEUELEN_OVERFLOW)) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("tcp_write: queue too long %"U16_F" (%d)\n", + queuelen, (int)TCP_SND_QUEUELEN)); + pbuf_free(p); + goto memerr; + } + + if ((seg = tcp_create_segment(pcb, p, 0, pcb->snd_lbb + pos, optflags)) == NULL) { + goto memerr; + } +#if TCP_OVERSIZE_DBGCHECK + seg->oversize_left = oversize; +#endif /* TCP_OVERSIZE_DBGCHECK */ +#if TCP_CHECKSUM_ON_COPY + seg->chksum = chksum; + seg->chksum_swapped = chksum_swapped; + seg->flags |= TF_SEG_DATA_CHECKSUMMED; +#endif /* TCP_CHECKSUM_ON_COPY */ + + /* first segment of to-be-queued data? */ + if (queue == NULL) { + queue = seg; + } else { + /* Attach the segment to the end of the queued segments */ + LWIP_ASSERT("prev_seg != NULL", prev_seg != NULL); + prev_seg->next = seg; + } + /* remember last segment of to-be-queued data for next iteration */ + prev_seg = seg; + + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_TRACE, ("tcp_write: queueing %"U32_F":%"U32_F"\n", + ntohl(seg->tcphdr->seqno), + ntohl(seg->tcphdr->seqno) + TCP_TCPLEN(seg))); + + pos += seglen; + } + + /* + * All three segmentation phases were successful. We can commit the + * transaction. + */ + + /* + * Phase 1: If data has been added to the preallocated tail of + * last_unsent, we update the length fields of the pbuf chain. + */ +#if TCP_OVERSIZE + if (oversize_used > 0) { + struct pbuf *p; + /* Bump tot_len of whole chain, len of tail */ + for (p = last_unsent->p; p; p = p->next) { + p->tot_len += oversize_used; + if (p->next == NULL) { + TCP_DATA_COPY((char *)p->payload + p->len, arg, oversize_used, last_unsent); + p->len += oversize_used; + } + } + last_unsent->len += oversize_used; +#if TCP_OVERSIZE_DBGCHECK + LWIP_ASSERT("last_unsent->oversize_left >= oversize_used", + last_unsent->oversize_left >= oversize_used); + last_unsent->oversize_left -= oversize_used; +#endif /* TCP_OVERSIZE_DBGCHECK */ + } + pcb->unsent_oversize = oversize; +#endif /* TCP_OVERSIZE */ + + /* + * Phase 2: concat_p can be concatenated onto last_unsent->p + */ + if (concat_p != NULL) { + LWIP_ASSERT("tcp_write: cannot concatenate when pcb->unsent is empty", + (last_unsent != NULL)); + pbuf_cat(last_unsent->p, concat_p); + last_unsent->len += concat_p->tot_len; +#if TCP_CHECKSUM_ON_COPY + if (concat_chksummed) { + /*if concat checksumm swapped - swap it back */ + if (concat_chksum_swapped) { + concat_chksum = SWAP_BYTES_IN_WORD(concat_chksum); + } + tcp_seg_add_chksum(concat_chksum, concat_chksummed, &last_unsent->chksum, + &last_unsent->chksum_swapped); + last_unsent->flags |= TF_SEG_DATA_CHECKSUMMED; + } +#endif /* TCP_CHECKSUM_ON_COPY */ + } + + /* + * Phase 3: Append queue to pcb->unsent. Queue may be NULL, but that + * is harmless + */ + if (last_unsent == NULL) { + pcb->unsent = queue; + } else { + last_unsent->next = queue; + } + + /* + * Finally update the pcb state. + */ + pcb->snd_lbb += len; + pcb->snd_buf -= len; + pcb->snd_queuelen = queuelen; + + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_write: %"S16_F" (after enqueued)\n", + pcb->snd_queuelen)); + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_write: valid queue length", + pcb->unacked != NULL || pcb->unsent != NULL); + } + + /* Set the PSH flag in the last segment that we enqueued. */ + if (seg != NULL && seg->tcphdr != NULL && ((apiflags & TCP_WRITE_FLAG_MORE)==0)) { + TCPH_SET_FLAG(seg->tcphdr, TCP_PSH); + } + + return ERR_OK; +memerr: + pcb->flags |= TF_NAGLEMEMERR; + TCP_STATS_INC(tcp.memerr); + + if (concat_p != NULL) { + pbuf_free(concat_p); + } + if (queue != NULL) { + tcp_segs_free(queue); + } + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_write: valid queue length", pcb->unacked != NULL || + pcb->unsent != NULL); + } + LWIP_DEBUGF(TCP_QLEN_DEBUG | LWIP_DBG_STATE, ("tcp_write: %"S16_F" (with mem err)\n", pcb->snd_queuelen)); + return ERR_MEM; +} + +/** + * Enqueue TCP options for transmission. + * + * Called by tcp_connect(), tcp_listen_input(), and tcp_send_ctrl(). + * + * @param pcb Protocol control block for the TCP connection. + * @param flags TCP header flags to set in the outgoing segment. + * @param optdata pointer to TCP options, or NULL. + * @param optlen length of TCP options in bytes. + */ +err_t +tcp_enqueue_flags(struct tcp_pcb *pcb, u8_t flags) +{ + struct pbuf *p; + struct tcp_seg *seg; + u8_t optflags = 0; + u8_t optlen = 0; + + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_enqueue_flags: queuelen: %"U16_F"\n", (u16_t)pcb->snd_queuelen)); + + LWIP_ASSERT("tcp_enqueue_flags: need either TCP_SYN or TCP_FIN in flags (programmer violates API)", + (flags & (TCP_SYN | TCP_FIN)) != 0); + + /* check for configured max queuelen and possible overflow (FIN flag should always come through!) */ + if (((pcb->snd_queuelen >= TCP_SND_QUEUELEN) || (pcb->snd_queuelen > TCP_SNDQUEUELEN_OVERFLOW)) && + ((flags & TCP_FIN) == 0)) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("tcp_enqueue_flags: too long queue %"U16_F" (max %"U16_F")\n", + pcb->snd_queuelen, TCP_SND_QUEUELEN)); + TCP_STATS_INC(tcp.memerr); + pcb->flags |= TF_NAGLEMEMERR; + return ERR_MEM; + } + + if (flags & TCP_SYN) { + optflags = TF_SEG_OPTS_MSS; +#if LWIP_WND_SCALE + if ((pcb->state != SYN_RCVD) || (pcb->flags & TF_WND_SCALE)) { + /* In a (sent in state SYN_RCVD), the window scale option may only + be sent if we received a window scale option from the remote host. */ + optflags |= TF_SEG_OPTS_WND_SCALE; + } +#endif /* LWIP_WND_SCALE */ + } +#if LWIP_TCP_TIMESTAMPS + if ((pcb->flags & TF_TIMESTAMP)) { + /* Make sure the timestamp option is only included in data segments if we + agreed about it with the remote host. */ + optflags |= TF_SEG_OPTS_TS; + } +#endif /* LWIP_TCP_TIMESTAMPS */ + optlen = LWIP_TCP_OPT_LENGTH(optflags); + + /* tcp_enqueue_flags is always called with either SYN or FIN in flags. + * We need one available snd_buf byte to do that. + * This means we can't send FIN while snd_buf==0. A better fix would be to + * not include SYN and FIN sequence numbers in the snd_buf count. */ + if (pcb->snd_buf == 0) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_LEVEL_SEVERE, ("tcp_enqueue_flags: no send buffer available\n")); + TCP_STATS_INC(tcp.memerr); + return ERR_MEM; + } + + /* Allocate pbuf with room for TCP header + options */ + if ((p = pbuf_alloc(PBUF_TRANSPORT, optlen, PBUF_RAM)) == NULL) { + pcb->flags |= TF_NAGLEMEMERR; + TCP_STATS_INC(tcp.memerr); + return ERR_MEM; + } + LWIP_ASSERT("tcp_enqueue_flags: check that first pbuf can hold optlen", + (p->len >= optlen)); + + /* Allocate memory for tcp_seg, and fill in fields. */ + if ((seg = tcp_create_segment(pcb, p, flags, pcb->snd_lbb, optflags)) == NULL) { + pcb->flags |= TF_NAGLEMEMERR; + TCP_STATS_INC(tcp.memerr); + return ERR_MEM; + } + LWIP_ASSERT("seg->tcphdr not aligned", ((mem_ptr_t)seg->tcphdr % LWIP_MIN(MEM_ALIGNMENT, 4)) == 0); + LWIP_ASSERT("tcp_enqueue_flags: invalid segment length", seg->len == 0); + + LWIP_DEBUGF(TCP_OUTPUT_DEBUG | LWIP_DBG_TRACE, + ("tcp_enqueue_flags: queueing %"U32_F":%"U32_F" (0x%"X16_F")\n", + ntohl(seg->tcphdr->seqno), + ntohl(seg->tcphdr->seqno) + TCP_TCPLEN(seg), + (u16_t)flags)); + + /* Now append seg to pcb->unsent queue */ + if (pcb->unsent == NULL) { + pcb->unsent = seg; + } else { + struct tcp_seg *useg; + for (useg = pcb->unsent; useg->next != NULL; useg = useg->next); + useg->next = seg; + } +#if TCP_OVERSIZE + /* The new unsent tail has no space */ + pcb->unsent_oversize = 0; +#endif /* TCP_OVERSIZE */ + + /* SYN and FIN bump the sequence number */ + if ((flags & TCP_SYN) || (flags & TCP_FIN)) { + pcb->snd_lbb++; + /* optlen does not influence snd_buf */ + pcb->snd_buf--; + } + if (flags & TCP_FIN) { + pcb->flags |= TF_FIN; + } + + /* update number of segments on the queues */ + pcb->snd_queuelen += pbuf_clen(seg->p); + LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_enqueue_flags: %"S16_F" (after enqueued)\n", pcb->snd_queuelen)); + if (pcb->snd_queuelen != 0) { + LWIP_ASSERT("tcp_enqueue_flags: invalid queue length", + pcb->unacked != NULL || pcb->unsent != NULL); + } + + return ERR_OK; +} + +#if LWIP_TCP_TIMESTAMPS +/* Build a timestamp option (12 bytes long) at the specified options pointer) + * + * @param pcb tcp_pcb + * @param opts option pointer where to store the timestamp option + */ +static void +tcp_build_timestamp_option(struct tcp_pcb *pcb, u32_t *opts) +{ + /* Pad with two NOP options to make everything nicely aligned */ + opts[0] = PP_HTONL(0x0101080A); + opts[1] = htonl(sys_now()); + opts[2] = htonl(pcb->ts_recent); +} +#endif + +#if LWIP_WND_SCALE +/** Build a window scale option (3 bytes long) at the specified options pointer) + * + * @param opts option pointer where to store the window scale option + */ +static void +tcp_build_wnd_scale_option(u32_t *opts) +{ + /* Pad with one NOP option to make everything nicely aligned */ + opts[0] = PP_HTONL(0x01030300 | TCP_RCV_SCALE); +} +#endif + +/** Send an ACK without data. + * + * @param pcb Protocol control block for the TCP connection to send the ACK + */ +err_t +tcp_send_empty_ack(struct tcp_pcb *pcb) +{ + err_t err; + struct pbuf *p; + u8_t optlen = 0; + struct netif *netif; +#if LWIP_TCP_TIMESTAMPS || CHECKSUM_GEN_TCP + struct tcp_hdr *tcphdr; +#endif /* LWIP_TCP_TIMESTAMPS || CHECKSUM_GEN_TCP */ + +#if LWIP_TCP_TIMESTAMPS + if (pcb->flags & TF_TIMESTAMP) { + optlen = LWIP_TCP_OPT_LENGTH(TF_SEG_OPTS_TS); + } +#endif + + p = tcp_output_alloc_header(pcb, optlen, 0, htonl(pcb->snd_nxt)); + if (p == NULL) { + /* let tcp_fasttmr retry sending this ACK */ + pcb->flags |= (TF_ACK_DELAY | TF_ACK_NOW); + LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_output: (ACK) could not allocate pbuf\n")); + return ERR_BUF; + } +#if LWIP_TCP_TIMESTAMPS || CHECKSUM_GEN_TCP + tcphdr = (struct tcp_hdr *)p->payload; +#endif /* LWIP_TCP_TIMESTAMPS || CHECKSUM_GEN_TCP */ + LWIP_DEBUGF(TCP_OUTPUT_DEBUG, + ("tcp_output: sending ACK for %"U32_F"\n", pcb->rcv_nxt)); + + /* NB. MSS and window scale options are only sent on SYNs, so ignore them here */ +#if LWIP_TCP_TIMESTAMPS + pcb->ts_lastacksent = pcb->rcv_nxt; + + if (pcb->flags & TF_TIMESTAMP) { + tcp_build_timestamp_option(pcb, (u32_t *)(tcphdr + 1)); + } +#endif + + netif = ip_route(&pcb->local_ip, &pcb->remote_ip); + if (netif == NULL) { + err = ERR_RTE; + } else { +#if CHECKSUM_GEN_TCP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_TCP) { + tcphdr->chksum = ip_chksum_pseudo(p, IP_PROTO_TCP, p->tot_len, + &pcb->local_ip, &pcb->remote_ip); + } +#endif + NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint)); + err = ip_output_if(p, &pcb->local_ip, &pcb->remote_ip, + pcb->ttl, pcb->tos, IP_PROTO_TCP, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + } + pbuf_free(p); + + if (err != ERR_OK) { + /* let tcp_fasttmr retry sending this ACK */ + pcb->flags |= (TF_ACK_DELAY | TF_ACK_NOW); + } else { + /* remove ACK flags from the PCB, as we sent an empty ACK now */ + pcb->flags &= ~(TF_ACK_DELAY | TF_ACK_NOW); + } + + return err; +} + +/** + * Find out what we can send and send it + * + * @param pcb Protocol control block for the TCP connection to send data + * @return ERR_OK if data has been sent or nothing to send + * another err_t on error + */ +err_t +tcp_output(struct tcp_pcb *pcb) +{ + struct tcp_seg *seg, *useg; + u32_t wnd, snd_nxt; + err_t err; +#if TCP_CWND_DEBUG + s16_t i = 0; +#endif /* TCP_CWND_DEBUG */ + + + /* pcb->state LISTEN not allowed here */ + LWIP_ASSERT("don't call tcp_output for listen-pcbs", + pcb->state != LISTEN); + + /* First, check if we are invoked by the TCP input processing + code. If so, we do not output anything. Instead, we rely on the + input processing code to call us when input processing is done + with. */ + if (tcp_input_pcb == pcb) { + + return ERR_OK; + } + + wnd = LWIP_MIN(pcb->snd_wnd, pcb->cwnd); + + seg = pcb->unsent; + + /* If the TF_ACK_NOW flag is set and no data will be sent (either + * because the ->unsent queue is empty or because the window does + * not allow it), construct an empty ACK segment and send it. + * + * If data is to be sent, we will just piggyback the ACK (see below). + */ + if (pcb->flags & TF_ACK_NOW && + (seg == NULL || + ntohl(seg->tcphdr->seqno) - pcb->lastack + seg->len > wnd)) { + return tcp_send_empty_ack(pcb); + } + + /* useg should point to last segment on unacked queue */ + useg = pcb->unacked; + if (useg != NULL) { + for (; useg->next != NULL; useg = useg->next); + } + +#if TCP_OUTPUT_DEBUG + if (seg == NULL) { + LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_output: nothing to send (%p)\n", + (void*)pcb->unsent)); + } +#endif /* TCP_OUTPUT_DEBUG */ +#if TCP_CWND_DEBUG + if (seg == NULL) { + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_output: snd_wnd %"TCPWNDSIZE_F + ", cwnd %"TCPWNDSIZE_F", wnd %"U32_F + ", seg == NULL, ack %"U32_F"\n", + pcb->snd_wnd, pcb->cwnd, wnd, pcb->lastack)); + } else { + LWIP_DEBUGF(TCP_CWND_DEBUG, + ("tcp_output: snd_wnd %"TCPWNDSIZE_F", cwnd %"TCPWNDSIZE_F", wnd %"U32_F + ", effwnd %"U32_F", seq %"U32_F", ack %"U32_F"\n", + pcb->snd_wnd, pcb->cwnd, wnd, + ntohl(seg->tcphdr->seqno) - pcb->lastack + seg->len, + ntohl(seg->tcphdr->seqno), pcb->lastack)); + } +#endif /* TCP_CWND_DEBUG */ + /* data available and window allows it to be sent? */ + while (seg != NULL && + ntohl(seg->tcphdr->seqno) - pcb->lastack + seg->len <= wnd) { + LWIP_ASSERT("RST not expected here!", + (TCPH_FLAGS(seg->tcphdr) & TCP_RST) == 0); + /* Stop sending if the nagle algorithm would prevent it + * Don't stop: + * - if tcp_write had a memory error before (prevent delayed ACK timeout) or + * - if FIN was already enqueued for this PCB (SYN is always alone in a segment - + * either seg->next != NULL or pcb->unacked == NULL; + * RST is no sent using tcp_write/tcp_output. + */ + if((tcp_do_output_nagle(pcb) == 0) && + ((pcb->flags & (TF_NAGLEMEMERR | TF_FIN)) == 0)) { + break; + } +#if TCP_CWND_DEBUG + LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_output: snd_wnd %"TCPWNDSIZE_F", cwnd %"TCPWNDSIZE_F", wnd %"U32_F", effwnd %"U32_F", seq %"U32_F", ack %"U32_F", i %"S16_F"\n", + pcb->snd_wnd, pcb->cwnd, wnd, + ntohl(seg->tcphdr->seqno) + seg->len - + pcb->lastack, + ntohl(seg->tcphdr->seqno), pcb->lastack, i)); + ++i; +#endif /* TCP_CWND_DEBUG */ + + if (pcb->state != SYN_SENT) { + TCPH_SET_FLAG(seg->tcphdr, TCP_ACK); + } + +#if TCP_OVERSIZE_DBGCHECK + seg->oversize_left = 0; +#endif /* TCP_OVERSIZE_DBGCHECK */ + err = tcp_output_segment(seg, pcb); + if (err != ERR_OK) { + /* segment could not be sent, for whatever reason */ + pcb->flags |= TF_NAGLEMEMERR; + return err; + } + pcb->unsent = seg->next; + if (pcb->state != SYN_SENT) { + pcb->flags &= ~(TF_ACK_DELAY | TF_ACK_NOW); + } + snd_nxt = ntohl(seg->tcphdr->seqno) + TCP_TCPLEN(seg); + if (TCP_SEQ_LT(pcb->snd_nxt, snd_nxt)) { + pcb->snd_nxt = snd_nxt; + } + /* put segment on unacknowledged list if length > 0 */ + if (TCP_TCPLEN(seg) > 0) { + seg->next = NULL; + /* unacked list is empty? */ + if (pcb->unacked == NULL) { + pcb->unacked = seg; + useg = seg; + /* unacked list is not empty? */ + } else { + /* In the case of fast retransmit, the packet should not go to the tail + * of the unacked queue, but rather somewhere before it. We need to check for + * this case. -STJ Jul 27, 2004 */ + if (TCP_SEQ_LT(ntohl(seg->tcphdr->seqno), ntohl(useg->tcphdr->seqno))) { + /* add segment to before tail of unacked list, keeping the list sorted */ + struct tcp_seg **cur_seg = &(pcb->unacked); + while (*cur_seg && + TCP_SEQ_LT(ntohl((*cur_seg)->tcphdr->seqno), ntohl(seg->tcphdr->seqno))) { + cur_seg = &((*cur_seg)->next ); + } + seg->next = (*cur_seg); + (*cur_seg) = seg; + } else { + /* add segment to tail of unacked list */ + useg->next = seg; + useg = useg->next; + } + } + /* do not queue empty segments on the unacked list */ + } else { + tcp_seg_free(seg); + } + seg = pcb->unsent; + } +#if TCP_OVERSIZE + if (pcb->unsent == NULL) { + /* last unsent has been removed, reset unsent_oversize */ + pcb->unsent_oversize = 0; + } +#endif /* TCP_OVERSIZE */ + + pcb->flags &= ~TF_NAGLEMEMERR; + return ERR_OK; +} + +/** + * Called by tcp_output() to actually send a TCP segment over IP. + * + * @param seg the tcp_seg to send + * @param pcb the tcp_pcb for the TCP connection used to send the segment + */ +static err_t +tcp_output_segment(struct tcp_seg *seg, struct tcp_pcb *pcb) +{ + err_t err; + u16_t len; + u32_t *opts; + struct netif *netif; + + /** @bug Exclude retransmitted segments from this count. */ + MIB2_STATS_INC(mib2.tcpoutsegs); + + /* The TCP header has already been constructed, but the ackno and + wnd fields remain. */ + seg->tcphdr->ackno = htonl(pcb->rcv_nxt); + + /* advertise our receive window size in this TCP segment */ +#if LWIP_WND_SCALE + if (seg->flags & TF_SEG_OPTS_WND_SCALE) { + /* The Window field in a SYN segment itself (the only type where we send + the window scale option) is never scaled. */ + seg->tcphdr->wnd = htons(TCPWND_MIN16(pcb->rcv_ann_wnd)); + } else +#endif /* LWIP_WND_SCALE */ + { + seg->tcphdr->wnd = htons(TCPWND_MIN16(RCV_WND_SCALE(pcb, pcb->rcv_ann_wnd))); + } + + pcb->rcv_ann_right_edge = pcb->rcv_nxt + pcb->rcv_ann_wnd; + + /* Add any requested options. NB MSS option is only set on SYN + packets, so ignore it here */ + opts = (u32_t *)(void *)(seg->tcphdr + 1); + if (seg->flags & TF_SEG_OPTS_MSS) { + u16_t mss; +#if TCP_CALCULATE_EFF_SEND_MSS + mss = tcp_eff_send_mss(TCP_MSS, &pcb->local_ip, &pcb->remote_ip); +#else /* TCP_CALCULATE_EFF_SEND_MSS */ + mss = TCP_MSS; +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + *opts = TCP_BUILD_MSS_OPTION(mss); + opts += 1; + } +#if LWIP_TCP_TIMESTAMPS + pcb->ts_lastacksent = pcb->rcv_nxt; + + if (seg->flags & TF_SEG_OPTS_TS) { + tcp_build_timestamp_option(pcb, opts); + opts += 3; + } +#endif +#if LWIP_WND_SCALE + if (seg->flags & TF_SEG_OPTS_WND_SCALE) { + tcp_build_wnd_scale_option(opts); + opts += 1; + } +#endif + + /* Set retransmission timer running if it is not currently enabled + This must be set before checking the route. */ + if (pcb->rtime == -1) { + pcb->rtime = 0; + } + + netif = ip_route(&pcb->local_ip, &pcb->remote_ip); + if (netif == NULL) { + return ERR_RTE; + } + + /* If we don't have a local IP address, we get one from netif */ + if (ip_addr_isany(&pcb->local_ip)) { + const ip_addr_t *local_ip = ip_netif_get_local_ip(netif, &pcb->remote_ip); + if (local_ip == NULL) { + return ERR_RTE; + } + ip_addr_copy(pcb->local_ip, *local_ip); + } + + if (pcb->rttest == 0) { + pcb->rttest = tcp_ticks; + pcb->rtseq = ntohl(seg->tcphdr->seqno); + + LWIP_DEBUGF(TCP_RTO_DEBUG, ("tcp_output_segment: rtseq %"U32_F"\n", pcb->rtseq)); + } + LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_output_segment: %"U32_F":%"U32_F"\n", + htonl(seg->tcphdr->seqno), htonl(seg->tcphdr->seqno) + + seg->len)); + + len = (u16_t)((u8_t *)seg->tcphdr - (u8_t *)seg->p->payload); + + seg->p->len -= len; + seg->p->tot_len -= len; + + seg->p->payload = seg->tcphdr; + + seg->tcphdr->chksum = 0; +#if CHECKSUM_GEN_TCP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_TCP) { +#if TCP_CHECKSUM_ON_COPY + u32_t acc; +#if TCP_CHECKSUM_ON_COPY_SANITY_CHECK + u16_t chksum_slow = ip_chksum_pseudo(seg->p, IP_PROTO_TCP, + seg->p->tot_len, &pcb->local_ip, &pcb->remote_ip); +#endif /* TCP_CHECKSUM_ON_COPY_SANITY_CHECK */ + if ((seg->flags & TF_SEG_DATA_CHECKSUMMED) == 0) { + LWIP_ASSERT("data included but not checksummed", + seg->p->tot_len == (TCPH_HDRLEN(seg->tcphdr) * 4)); + } + + /* rebuild TCP header checksum (TCP header changes for retransmissions!) */ + acc = ip_chksum_pseudo_partial(seg->p, IP_PROTO_TCP, + seg->p->tot_len, TCPH_HDRLEN(seg->tcphdr) * 4, &pcb->local_ip, &pcb->remote_ip); + /* add payload checksum */ + if (seg->chksum_swapped) { + seg->chksum = SWAP_BYTES_IN_WORD(seg->chksum); + seg->chksum_swapped = 0; + } + acc += (u16_t)~(seg->chksum); + seg->tcphdr->chksum = FOLD_U32T(acc); +#if TCP_CHECKSUM_ON_COPY_SANITY_CHECK + if (chksum_slow != seg->tcphdr->chksum) { + TCP_CHECKSUM_ON_COPY_SANITY_CHECK_FAIL( + ("tcp_output_segment: calculated checksum is %"X16_F" instead of %"X16_F"\n", + seg->tcphdr->chksum, chksum_slow)); + seg->tcphdr->chksum = chksum_slow; + } +#endif /* TCP_CHECKSUM_ON_COPY_SANITY_CHECK */ +#else /* TCP_CHECKSUM_ON_COPY */ + seg->tcphdr->chksum = ip_chksum_pseudo(seg->p, IP_PROTO_TCP, + seg->p->tot_len, &pcb->local_ip, &pcb->remote_ip); +#endif /* TCP_CHECKSUM_ON_COPY */ + } +#endif /* CHECKSUM_GEN_TCP */ + TCP_STATS_INC(tcp.xmit); + + NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint)); + err = ip_output_if(seg->p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, + pcb->tos, IP_PROTO_TCP, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + return err; +} + +/** + * Send a TCP RESET packet (empty segment with RST flag set) either to + * abort a connection or to show that there is no matching local connection + * for a received segment. + * + * Called by tcp_abort() (to abort a local connection), tcp_input() (if no + * matching local pcb was found), tcp_listen_input() (if incoming segment + * has ACK flag set) and tcp_process() (received segment in the wrong state) + * + * Since a RST segment is in most cases not sent for an active connection, + * tcp_rst() has a number of arguments that are taken from a tcp_pcb for + * most other segment output functions. + * + * @param seqno the sequence number to use for the outgoing segment + * @param ackno the acknowledge number to use for the outgoing segment + * @param local_ip the local IP address to send the segment from + * @param remote_ip the remote IP address to send the segment to + * @param local_port the local TCP port to send the segment from + * @param remote_port the remote TCP port to send the segment to + */ +void +tcp_rst(u32_t seqno, u32_t ackno, + const ip_addr_t *local_ip, const ip_addr_t *remote_ip, + u16_t local_port, u16_t remote_port) +{ + struct pbuf *p; + struct tcp_hdr *tcphdr; + struct netif *netif; + p = pbuf_alloc(PBUF_IP, TCP_HLEN, PBUF_RAM); + if (p == NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_rst: could not allocate memory for pbuf\n")); + return; + } + LWIP_ASSERT("check that first pbuf can hold struct tcp_hdr", + (p->len >= sizeof(struct tcp_hdr))); + + tcphdr = (struct tcp_hdr *)p->payload; + tcphdr->src = htons(local_port); + tcphdr->dest = htons(remote_port); + tcphdr->seqno = htonl(seqno); + tcphdr->ackno = htonl(ackno); + TCPH_HDRLEN_FLAGS_SET(tcphdr, TCP_HLEN/4, TCP_RST | TCP_ACK); +#if LWIP_WND_SCALE + tcphdr->wnd = PP_HTONS(((TCP_WND >> TCP_RCV_SCALE) & 0xFFFF)); +#else + tcphdr->wnd = PP_HTONS(TCP_WND); +#endif + tcphdr->chksum = 0; + tcphdr->urgp = 0; + + TCP_STATS_INC(tcp.xmit); + MIB2_STATS_INC(mib2.tcpoutrsts); + + netif = ip_route(local_ip, remote_ip); + if (netif != NULL) { +#if CHECKSUM_GEN_TCP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_TCP) { + tcphdr->chksum = ip_chksum_pseudo(p, IP_PROTO_TCP, p->tot_len, + local_ip, remote_ip); + } +#endif + /* Send output with hardcoded TTL/HL since we have no access to the pcb */ + ip_output_if(p, local_ip, remote_ip, TCP_TTL, 0, IP_PROTO_TCP, netif); + } + pbuf_free(p); + LWIP_DEBUGF(TCP_RST_DEBUG, ("tcp_rst: seqno %"U32_F" ackno %"U32_F".\n", seqno, ackno)); +} + +/** + * Requeue all unacked segments for retransmission + * + * Called by tcp_slowtmr() for slow retransmission. + * + * @param pcb the tcp_pcb for which to re-enqueue all unacked segments + */ +void +tcp_rexmit_rto(struct tcp_pcb *pcb) +{ + struct tcp_seg *seg; + + if (pcb->unacked == NULL) { + return; + } + + /* Move all unacked segments to the head of the unsent queue */ + for (seg = pcb->unacked; seg->next != NULL; seg = seg->next); + /* concatenate unsent queue after unacked queue */ + seg->next = pcb->unsent; +#if TCP_OVERSIZE_DBGCHECK + /* if last unsent changed, we need to update unsent_oversize */ + if (pcb->unsent == NULL) { + pcb->unsent_oversize = seg->oversize_left; + } +#endif /* TCP_OVERSIZE_DBGCHECK */ + /* unsent queue is the concatenated queue (of unacked, unsent) */ + pcb->unsent = pcb->unacked; + /* unacked queue is now empty */ + pcb->unacked = NULL; + + /* increment number of retransmissions */ + ++pcb->nrtx; + + /* Don't take any RTT measurements after retransmitting. */ + pcb->rttest = 0; + + /* Do the actual retransmission */ + tcp_output(pcb); +} + +/** + * Requeue the first unacked segment for retransmission + * + * Called by tcp_receive() for fast retramsmit. + * + * @param pcb the tcp_pcb for which to retransmit the first unacked segment + */ +void +tcp_rexmit(struct tcp_pcb *pcb) +{ + struct tcp_seg *seg; + struct tcp_seg **cur_seg; + + if (pcb->unacked == NULL) { + return; + } + + /* Move the first unacked segment to the unsent queue */ + /* Keep the unsent queue sorted. */ + seg = pcb->unacked; + pcb->unacked = seg->next; + + cur_seg = &(pcb->unsent); + while (*cur_seg && + TCP_SEQ_LT(ntohl((*cur_seg)->tcphdr->seqno), ntohl(seg->tcphdr->seqno))) { + cur_seg = &((*cur_seg)->next ); + } + seg->next = *cur_seg; + *cur_seg = seg; +#if TCP_OVERSIZE + if (seg->next == NULL) { + /* the retransmitted segment is last in unsent, so reset unsent_oversize */ + pcb->unsent_oversize = 0; + } +#endif /* TCP_OVERSIZE */ + + ++pcb->nrtx; + + /* Don't take any rtt measurements after retransmitting. */ + pcb->rttest = 0; + + /* Do the actual retransmission. */ + MIB2_STATS_INC(mib2.tcpretranssegs); + /* No need to call tcp_output: we are always called from tcp_input() + and thus tcp_output directly returns. */ +} + + +/** + * Handle retransmission after three dupacks received + * + * @param pcb the tcp_pcb for which to retransmit the first unacked segment + */ +void +tcp_rexmit_fast(struct tcp_pcb *pcb) +{ + if (pcb->unacked != NULL && !(pcb->flags & TF_INFR)) { + /* This is fast retransmit. Retransmit the first unacked segment. */ + LWIP_DEBUGF(TCP_FR_DEBUG, + ("tcp_receive: dupacks %"U16_F" (%"U32_F + "), fast retransmit %"U32_F"\n", + (u16_t)pcb->dupacks, pcb->lastack, + ntohl(pcb->unacked->tcphdr->seqno))); + tcp_rexmit(pcb); + + /* Set ssthresh to half of the minimum of the current + * cwnd and the advertised window */ + if (pcb->cwnd > pcb->snd_wnd) { + pcb->ssthresh = pcb->snd_wnd / 2; + } else { + pcb->ssthresh = pcb->cwnd / 2; + } + + /* The minimum value for ssthresh should be 2 MSS */ + if (pcb->ssthresh < (2U * pcb->mss)) { + LWIP_DEBUGF(TCP_FR_DEBUG, + ("tcp_receive: The minimum value for ssthresh %"TCPWNDSIZE_F + " should be min 2 mss %"U16_F"...\n", + pcb->ssthresh, 2*pcb->mss)); + pcb->ssthresh = 2*pcb->mss; + } + + pcb->cwnd = pcb->ssthresh + 3 * pcb->mss; + pcb->flags |= TF_INFR; + } +} + + +/** + * Send keepalive packets to keep a connection active although + * no data is sent over it. + * + * Called by tcp_slowtmr() + * + * @param pcb the tcp_pcb for which to send a keepalive packet + */ +err_t +tcp_keepalive(struct tcp_pcb *pcb) +{ + err_t err; + struct pbuf *p; + struct netif *netif; + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_keepalive: sending KEEPALIVE probe to ")); + ip_addr_debug_print(TCP_DEBUG, &pcb->remote_ip); + LWIP_DEBUGF(TCP_DEBUG, ("\n")); + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_keepalive: tcp_ticks %"U32_F" pcb->tmr %"U32_F" pcb->keep_cnt_sent %"U16_F"\n", + tcp_ticks, pcb->tmr, pcb->keep_cnt_sent)); + + p = tcp_output_alloc_header(pcb, 0, 0, htonl(pcb->snd_nxt - 1)); + if (p == NULL) { + LWIP_DEBUGF(TCP_DEBUG, + ("tcp_keepalive: could not allocate memory for pbuf\n")); + return ERR_MEM; + } + netif = ip_route(&pcb->local_ip, &pcb->remote_ip); + if (netif == NULL) { + err = ERR_RTE; + } else { +#if CHECKSUM_GEN_TCP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_TCP) { + struct tcp_hdr *tcphdr = (struct tcp_hdr *)p->payload; + tcphdr->chksum = ip_chksum_pseudo(p, IP_PROTO_TCP, p->tot_len, + &pcb->local_ip, &pcb->remote_ip); + } +#endif /* CHECKSUM_GEN_TCP */ + TCP_STATS_INC(tcp.xmit); + + /* Send output to IP */ + NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint)); + err = ip_output_if(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, 0, IP_PROTO_TCP, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + } + pbuf_free(p); + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_keepalive: seqno %"U32_F" ackno %"U32_F" err %d.\n", + pcb->snd_nxt - 1, pcb->rcv_nxt, (int)err)); + return err; +} + + +/** + * Send persist timer zero-window probes to keep a connection active + * when a window update is lost. + * + * Called by tcp_slowtmr() + * + * @param pcb the tcp_pcb for which to send a zero-window probe packet + */ +err_t +tcp_zero_window_probe(struct tcp_pcb *pcb) +{ + err_t err; + struct pbuf *p; + struct tcp_hdr *tcphdr; + struct tcp_seg *seg; + u16_t len; + u8_t is_fin; + struct netif *netif; + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_zero_window_probe: sending ZERO WINDOW probe to ")); + ip_addr_debug_print(TCP_DEBUG, &pcb->remote_ip); + LWIP_DEBUGF(TCP_DEBUG, ("\n")); + + LWIP_DEBUGF(TCP_DEBUG, + ("tcp_zero_window_probe: tcp_ticks %"U32_F + " pcb->tmr %"U32_F" pcb->keep_cnt_sent %"U16_F"\n", + tcp_ticks, pcb->tmr, pcb->keep_cnt_sent)); + + seg = pcb->unacked; + + if (seg == NULL) { + seg = pcb->unsent; + } + if (seg == NULL) { + /* nothing to send, zero window probe not needed */ + return ERR_OK; + } + + is_fin = ((TCPH_FLAGS(seg->tcphdr) & TCP_FIN) != 0) && (seg->len == 0); + /* we want to send one seqno: either FIN or data (no options) */ + len = is_fin ? 0 : 1; + + p = tcp_output_alloc_header(pcb, 0, len, seg->tcphdr->seqno); + if (p == NULL) { + LWIP_DEBUGF(TCP_DEBUG, ("tcp_zero_window_probe: no memory for pbuf\n")); + return ERR_MEM; + } + tcphdr = (struct tcp_hdr *)p->payload; + + if (is_fin) { + /* FIN segment, no data */ + TCPH_FLAGS_SET(tcphdr, TCP_ACK | TCP_FIN); + } else { + /* Data segment, copy in one byte from the head of the unacked queue */ + char *d = ((char *)p->payload + TCP_HLEN); + /* Depending on whether the segment has already been sent (unacked) or not + (unsent), seg->p->payload points to the IP header or TCP header. + Ensure we copy the first TCP data byte: */ + pbuf_copy_partial(seg->p, d, 1, seg->p->tot_len - seg->len); + } + + netif = ip_route(&pcb->local_ip, &pcb->remote_ip); + if (netif == NULL) { + err = ERR_RTE; + } else { +#if CHECKSUM_GEN_TCP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_TCP) { + tcphdr->chksum = ip_chksum_pseudo(p, IP_PROTO_TCP, p->tot_len, + &pcb->local_ip, &pcb->remote_ip); + } +#endif + TCP_STATS_INC(tcp.xmit); + + /* Send output to IP */ + NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint)); + err = ip_output_if(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, + 0, IP_PROTO_TCP, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + } + + pbuf_free(p); + + LWIP_DEBUGF(TCP_DEBUG, ("tcp_zero_window_probe: seqno %"U32_F + " ackno %"U32_F" err %d.\n", + pcb->snd_nxt - 1, pcb->rcv_nxt, (int)err)); + return err; +} +#endif /* LWIP_TCP */ diff --git a/components/lwip/core/timers.c b/components/lwip/core/timers.c new file mode 100755 index 000000000..0a361474e --- /dev/null +++ b/components/lwip/core/timers.c @@ -0,0 +1,614 @@ +/** + * @file + * Stack-internal timers implementation. + * This file includes timer callbacks for stack-internal timers as well as + * functions to set up or stop timers and check for expired timers. + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * Simon Goldschmidt + * + */ + +#include "lwip/opt.h" + +#include "lwip/timers.h" +#include "lwip/priv/tcp_priv.h" + +#if LWIP_TIMERS + +#include "lwip/def.h" +#include "lwip/memp.h" +#include "lwip/priv/tcpip_priv.h" + +#include "lwip/ip_frag.h" +#include "netif/etharp.h" +#include "lwip/dhcp.h" +#include "lwip/autoip.h" +#include "lwip/igmp.h" +#include "lwip/dns.h" +#include "lwip/nd6.h" +#include "lwip/ip6_frag.h" +#include "lwip/mld6.h" +#include "lwip/sys.h" +#include "lwip/pbuf.h" + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +/** The one and only timeout list */ +static struct sys_timeo *next_timeout; +#if NO_SYS +static u32_t timeouts_last_time; +#endif /* NO_SYS */ + +#if LWIP_TCP +/** global variable that shows if the tcp timer is currently scheduled or not */ +static int tcpip_tcp_timer_active; + +/** + * Timer callback function that calls tcp_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +tcpip_tcp_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + + /* call TCP timer handler */ + tcp_tmr(); + /* timer still needed? */ + if (tcp_active_pcbs || tcp_tw_pcbs) { + /* restart timer */ + sys_timeout(TCP_TMR_INTERVAL, tcpip_tcp_timer, NULL); + } else { + /* disable timer */ + tcpip_tcp_timer_active = 0; + } +} + +/** + * Called from TCP_REG when registering a new PCB: + * the reason is to have the TCP timer only running when + * there are active (or time-wait) PCBs. + */ +void +tcp_timer_needed(void) +{ + /* timer is off but needed again? */ + if (!tcpip_tcp_timer_active && (tcp_active_pcbs || tcp_tw_pcbs)) { + /* enable and start timer */ + tcpip_tcp_timer_active = 1; + sys_timeout(TCP_TMR_INTERVAL, tcpip_tcp_timer, NULL); + } +} +#endif /* LWIP_TCP */ + +#if LWIP_IPV4 +#if IP_REASSEMBLY +/** + * Timer callback function that calls ip_reass_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +ip_reass_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: ip_reass_tmr()\n")); + ip_reass_tmr(); + sys_timeout(IP_TMR_INTERVAL, ip_reass_timer, NULL); +} +#endif /* IP_REASSEMBLY */ + +#if LWIP_ARP +/** + * Timer callback function that calls etharp_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +arp_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: etharp_tmr()\n")); + etharp_tmr(); + sys_timeout(ARP_TMR_INTERVAL, arp_timer, NULL); +} +#endif /* LWIP_ARP */ + +#if LWIP_DHCP +/** + * Timer callback function that calls dhcp_coarse_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +dhcp_timer_coarse(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: dhcp_coarse_tmr()\n")); + dhcp_coarse_tmr(); + +#ifdef LWIP_ESP8266 + extern void dhcps_coarse_tmr(void); + dhcps_coarse_tmr(); +#endif + + sys_timeout(DHCP_COARSE_TIMER_MSECS, dhcp_timer_coarse, NULL); +} + +/** + * Timer callback function that calls dhcp_fine_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +dhcp_timer_fine(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: dhcp_fine_tmr()\n")); + dhcp_fine_tmr(); + sys_timeout(DHCP_FINE_TIMER_MSECS, dhcp_timer_fine, NULL); +} +#endif /* LWIP_DHCP */ + +#if LWIP_AUTOIP +/** + * Timer callback function that calls autoip_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +autoip_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: autoip_tmr()\n")); + autoip_tmr(); + sys_timeout(AUTOIP_TMR_INTERVAL, autoip_timer, NULL); +} +#endif /* LWIP_AUTOIP */ + +#if LWIP_IGMP +/** + * Timer callback function that calls igmp_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +igmp_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: igmp_tmr()\n")); + igmp_tmr(); + sys_timeout(IGMP_TMR_INTERVAL, igmp_timer, NULL); +} +#endif /* LWIP_IGMP */ +#endif /* LWIP_IPV4 */ + +#if LWIP_DNS +/** + * Timer callback function that calls dns_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +dns_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: dns_tmr()\n")); + dns_tmr(); + sys_timeout(DNS_TMR_INTERVAL, dns_timer, NULL); +} +#endif /* LWIP_DNS */ + +#if LWIP_IPV6 +/** + * Timer callback function that calls nd6_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +nd6_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: nd6_tmr()\n")); + nd6_tmr(); + sys_timeout(ND6_TMR_INTERVAL, nd6_timer, NULL); +} + +#if LWIP_IPV6_REASS +/** + * Timer callback function that calls ip6_reass_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +ip6_reass_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: ip6_reass_tmr()\n")); + ip6_reass_tmr(); + sys_timeout(IP6_REASS_TMR_INTERVAL, ip6_reass_timer, NULL); +} +#endif /* LWIP_IPV6_REASS */ + +#if LWIP_IPV6_MLD +/** + * Timer callback function that calls mld6_tmr() and reschedules itself. + * + * @param arg unused argument + */ +static void +mld6_timer(void *arg) +{ + LWIP_UNUSED_ARG(arg); + LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: mld6_tmr()\n")); + mld6_tmr(); + sys_timeout(MLD6_TMR_INTERVAL, mld6_timer, NULL); +} +#endif /* LWIP_IPV6_MLD */ +#endif /* LWIP_IPV6 */ + +/** Initialize this module */ +void sys_timeouts_init(void) +{ +#if LWIP_IPV4 +#if IP_REASSEMBLY + sys_timeout(IP_TMR_INTERVAL, ip_reass_timer, NULL); +#endif /* IP_REASSEMBLY */ +#if LWIP_ARP + sys_timeout(ARP_TMR_INTERVAL, arp_timer, NULL); +#endif /* LWIP_ARP */ +#if LWIP_DHCP + +#ifdef LWIP_ESP8266 + // DHCP_MAXRTX = 0; +#endif + + + + sys_timeout(DHCP_COARSE_TIMER_MSECS, dhcp_timer_coarse, NULL); + sys_timeout(DHCP_FINE_TIMER_MSECS, dhcp_timer_fine, NULL); +#endif /* LWIP_DHCP */ +#if LWIP_AUTOIP + sys_timeout(AUTOIP_TMR_INTERVAL, autoip_timer, NULL); +#endif /* LWIP_AUTOIP */ +#if LWIP_IGMP + sys_timeout(IGMP_TMR_INTERVAL, igmp_timer, NULL); +#endif /* LWIP_IGMP */ +#endif /* LWIP_IPV4 */ + +#if LWIP_DNS + sys_timeout(DNS_TMR_INTERVAL, dns_timer, NULL); +#endif /* LWIP_DNS */ + +#if LWIP_IPV6 + sys_timeout(ND6_TMR_INTERVAL, nd6_timer, NULL); +#if LWIP_IPV6_REASS + sys_timeout(IP6_REASS_TMR_INTERVAL, ip6_reass_timer, NULL); +#endif /* LWIP_IPV6_REASS */ +#if LWIP_IPV6_MLD + sys_timeout(MLD6_TMR_INTERVAL, mld6_timer, NULL); +#endif /* LWIP_IPV6_MLD */ +#endif /* LWIP_IPV6 */ + +#if NO_SYS + /* Initialise timestamp for sys_check_timeouts */ + timeouts_last_time = sys_now(); +#endif +} + +/** + * Create a one-shot timer (aka timeout). Timeouts are processed in the + * following cases: + * - while waiting for a message using sys_timeouts_mbox_fetch() + * - by calling sys_check_timeouts() (NO_SYS==1 only) + * + * @param msecs time in milliseconds after that the timer should expire + * @param handler callback function to call when msecs have elapsed + * @param arg argument to pass to the callback function + */ +#if LWIP_DEBUG_TIMERNAMES +void +sys_timeout_debug(u32_t msecs, sys_timeout_handler handler, void *arg, const char* handler_name) +#else /* LWIP_DEBUG_TIMERNAMES */ + +#ifdef LWIP_ESP8266 + u32_t LwipTimOutLim = 0; // For light sleep. time out. limit is 3000ms +#endif + +void +sys_timeout(u32_t msecs, sys_timeout_handler handler, void *arg) +#endif /* LWIP_DEBUG_TIMERNAMES */ +{ + struct sys_timeo *timeout, *t; +#if NO_SYS + u32_t now, diff; +#endif + + timeout = (struct sys_timeo *)memp_malloc(MEMP_SYS_TIMEOUT); + if (timeout == NULL) { + LWIP_ASSERT("sys_timeout: timeout != NULL, pool MEMP_SYS_TIMEOUT is empty", timeout != NULL); + return; + } + +#if NO_SYS + now = sys_now(); + if (next_timeout == NULL) { + diff = 0; + timeouts_last_time = now; + } else { + diff = now - timeouts_last_time; + } +#endif + + timeout->next = NULL; + timeout->h = handler; + timeout->arg = arg; + +#ifdef LWIP_ESP8266 + if(msecs < LwipTimOutLim) + msecs = LwipTimOutLim; +#endif + +#if NO_SYS + timeout->time = msecs + diff; +#else + timeout->time = msecs; +#endif +#if LWIP_DEBUG_TIMERNAMES + timeout->handler_name = handler_name; + LWIP_DEBUGF(TIMERS_DEBUG, ("sys_timeout: %p msecs=%"U32_F" handler=%s arg=%p\n", + (void *)timeout, msecs, handler_name, (void *)arg)); +#endif /* LWIP_DEBUG_TIMERNAMES */ + + if (next_timeout == NULL) { + next_timeout = timeout; + return; + } + + if (next_timeout->time > msecs) { + next_timeout->time -= msecs; + timeout->next = next_timeout; + next_timeout = timeout; + } else { + for (t = next_timeout; t != NULL; t = t->next) { + timeout->time -= t->time; + if (t->next == NULL || t->next->time > timeout->time) { + if (t->next != NULL) { + t->next->time -= timeout->time; + } + timeout->next = t->next; + t->next = timeout; + break; + } + } + } +} + +/** + * Go through timeout list (for this task only) and remove the first matching + * entry (subsequent entries remain untouched), even though the timeout has not + * triggered yet. + * + * @param handler callback function that would be called by the timeout + * @param arg callback argument that would be passed to handler +*/ +void +sys_untimeout(sys_timeout_handler handler, void *arg) +{ + struct sys_timeo *prev_t, *t; + + if (next_timeout == NULL) { + return; + } + + for (t = next_timeout, prev_t = NULL; t != NULL; prev_t = t, t = t->next) { + if ((t->h == handler) && (t->arg == arg)) { + /* We have a match */ + /* Unlink from previous in list */ + if (prev_t == NULL) { + next_timeout = t->next; + } else { + prev_t->next = t->next; + } + /* If not the last one, add time of this one back to next */ + if (t->next != NULL) { + t->next->time += t->time; + } + memp_free(MEMP_SYS_TIMEOUT, t); + return; + } + } + return; +} + +#if NO_SYS + +/** Handle timeouts for NO_SYS==1 (i.e. without using + * tcpip_thread/sys_timeouts_mbox_fetch(). Uses sys_now() to call timeout + * handler functions when timeouts expire. + * + * Must be called periodically from your main loop. + */ +void +sys_check_timeouts(void) +{ + if (next_timeout) { + struct sys_timeo *tmptimeout; + u32_t diff; + sys_timeout_handler handler; + void *arg; + u8_t had_one; + u32_t now; + + now = sys_now(); + /* this cares for wraparounds */ + diff = now - timeouts_last_time; + do { +#if PBUF_POOL_FREE_OOSEQ + PBUF_CHECK_FREE_OOSEQ(); +#endif /* PBUF_POOL_FREE_OOSEQ */ + had_one = 0; + tmptimeout = next_timeout; + if (tmptimeout && (tmptimeout->time <= diff)) { + /* timeout has expired */ + had_one = 1; + timeouts_last_time += tmptimeout->time; + diff -= tmptimeout->time; + next_timeout = tmptimeout->next; + handler = tmptimeout->h; + arg = tmptimeout->arg; +#if LWIP_DEBUG_TIMERNAMES + if (handler != NULL) { + LWIP_DEBUGF(TIMERS_DEBUG, ("sct calling h=%s arg=%p\n", + tmptimeout->handler_name, arg)); + } +#endif /* LWIP_DEBUG_TIMERNAMES */ + memp_free(MEMP_SYS_TIMEOUT, tmptimeout); + if (handler != NULL) { + handler(arg); + } + } + /* repeat until all expired timers have been called */ + } while (had_one); + } +} + +/** Set back the timestamp of the last call to sys_check_timeouts() + * This is necessary if sys_check_timeouts() hasn't been called for a long + * time (e.g. while saving energy) to prevent all timer functions of that + * period being called. + */ +void +sys_restart_timeouts(void) +{ + timeouts_last_time = sys_now(); +} + +/** Return the time left before the next timeout is due. If no timeouts are + * enqueued, returns 0xffffffff + */ +u32_t +sys_timeouts_sleeptime(void) +{ + u32_t diff; + if (next_timeout == NULL) { + return 0xffffffff; + } + diff = sys_now() - timeouts_last_time; + if (diff > next_timeout->time) { + return 0; + } else { + return next_timeout->time - diff; + } +} + +#else /* NO_SYS */ + +/** + * Wait (forever) for a message to arrive in an mbox. + * While waiting, timeouts are processed. + * + * @param mbox the mbox to fetch the message from + * @param msg the place to store the message + */ +void +sys_timeouts_mbox_fetch(sys_mbox_t *mbox, void **msg) +{ + u32_t time_needed; + struct sys_timeo *tmptimeout; + sys_timeout_handler handler; + void *arg; + + again: + if (!next_timeout) { + time_needed = sys_arch_mbox_fetch(mbox, msg, 0); + } else { + if (next_timeout->time > 0) { + time_needed = sys_arch_mbox_fetch(mbox, msg, next_timeout->time); + } else { + time_needed = SYS_ARCH_TIMEOUT; + } + + if (time_needed == SYS_ARCH_TIMEOUT) { + /* If time == SYS_ARCH_TIMEOUT, a timeout occurred before a message + could be fetched. We should now call the timeout handler and + deallocate the memory allocated for the timeout. */ + tmptimeout = next_timeout; + next_timeout = tmptimeout->next; + handler = tmptimeout->h; + arg = tmptimeout->arg; +#if LWIP_DEBUG_TIMERNAMES + if (handler != NULL) { + LWIP_DEBUGF(TIMERS_DEBUG, ("stmf calling h=%s arg=%p\n", + tmptimeout->handler_name, arg)); + } +#endif /* LWIP_DEBUG_TIMERNAMES */ + memp_free(MEMP_SYS_TIMEOUT, tmptimeout); + if (handler != NULL) { + /* For LWIP_TCPIP_CORE_LOCKING, lock the core before calling the + timeout handler function. */ + LOCK_TCPIP_CORE(); + handler(arg); + UNLOCK_TCPIP_CORE(); + } + LWIP_TCPIP_THREAD_ALIVE(); + + /* We try again to fetch a message from the mbox. */ + goto again; + } else { + /* If time != SYS_ARCH_TIMEOUT, a message was received before the timeout + occured. The time variable is set to the number of + milliseconds we waited for the message. */ + if (time_needed < next_timeout->time) { + next_timeout->time -= time_needed; + } else { + next_timeout->time = 0; + } + } + } +} + +#endif /* NO_SYS */ + +#else /* LWIP_TIMERS */ +/* Satisfy the TCP code which calls this function */ +void +tcp_timer_needed(void) +{ +} +#endif /* LWIP_TIMERS */ diff --git a/components/lwip/core/udp.c b/components/lwip/core/udp.c new file mode 100755 index 000000000..e44ab7e73 --- /dev/null +++ b/components/lwip/core/udp.c @@ -0,0 +1,1198 @@ +/** + * @file + * User Datagram Protocol module + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + + +/* udp.c + * + * The code for the User Datagram Protocol UDP & UDPLite (RFC 3828). + * + */ + +/* @todo Check the use of '(struct udp_pcb).chksum_len_rx'! + */ + +#include "lwip/opt.h" + +#if LWIP_UDP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/udp.h" +#include "lwip/def.h" +#include "lwip/memp.h" +#include "lwip/inet_chksum.h" +#include "lwip/ip_addr.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/inet_chksum.h" +#include "lwip/netif.h" +#include "lwip/icmp.h" +#include "lwip/icmp6.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" +#include "lwip/dhcp.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + + +#ifndef UDP_LOCAL_PORT_RANGE_START +/* From http://www.iana.org/assignments/port-numbers: + "The Dynamic and/or Private Ports are those from 49152 through 65535" */ +#define UDP_LOCAL_PORT_RANGE_START 0xc000 +#define UDP_LOCAL_PORT_RANGE_END 0xffff +#define UDP_ENSURE_LOCAL_PORT_RANGE(port) ((u16_t)(((port) & ~UDP_LOCAL_PORT_RANGE_START) + UDP_LOCAL_PORT_RANGE_START)) +#endif + +/* last local UDP port */ +static u16_t udp_port = UDP_LOCAL_PORT_RANGE_START; + +/* The list of UDP PCBs */ +/* exported in udp.h (was static) */ +struct udp_pcb *udp_pcbs; + +/** + * Initialize this module. + */ +void +udp_init(void) +{ +#if LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND) + udp_port = UDP_ENSURE_LOCAL_PORT_RANGE(LWIP_RAND()); +#endif /* LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND) */ +} + +/** + * Allocate a new local UDP port. + * + * @return a new (free) local UDP port number + */ +static u16_t +udp_new_port(void) +{ + u16_t n = 0; + struct udp_pcb *pcb; + +again: + if (udp_port++ == UDP_LOCAL_PORT_RANGE_END) { + udp_port = UDP_LOCAL_PORT_RANGE_START; + } + /* Check all PCBs. */ + for (pcb = udp_pcbs; pcb != NULL; pcb = pcb->next) { + if (pcb->local_port == udp_port) { + if (++n > (UDP_LOCAL_PORT_RANGE_END - UDP_LOCAL_PORT_RANGE_START)) { + return 0; + } + goto again; + } + } + return udp_port; +#if 0 + struct udp_pcb *ipcb = udp_pcbs; + while ((ipcb != NULL) && (udp_port != UDP_LOCAL_PORT_RANGE_END)) { + if (ipcb->local_port == udp_port) { + /* port is already used by another udp_pcb */ + udp_port++; + /* restart scanning all udp pcbs */ + ipcb = udp_pcbs; + } else { + /* go on with next udp pcb */ + ipcb = ipcb->next; + } + } + if (ipcb != NULL) { + return 0; + } + return udp_port; +#endif +} + +/** Common code to see if the current input packet matches the pcb + * (current input packet is accessed via ip(4/6)_current_* macros) + * + * @param pcb pcb to check + * @param inp network interface on which the datagram was received (only used for IPv4) + * @param broadcast 1 if his is an IPv4 broadcast (global or subnet-only), 0 otherwise (only used for IPv4) + * @return 1 on match, 0 otherwise + */ +static u8_t +udp_input_local_match(struct udp_pcb *pcb, struct netif *inp, u8_t broadcast) +{ + LWIP_UNUSED_ARG(inp); /* in IPv6 only case */ + LWIP_UNUSED_ARG(broadcast); /* in IPv6 only case */ + + /* Dual-stack: PCBs listening to any IP type also listen to any IP address */ + if(IP_IS_ANY_TYPE_VAL(pcb->local_ip)) { +#if LWIP_IPV4 && IP_SOF_BROADCAST_RECV + if((broadcast != 0) && !ip_get_option(pcb, SOF_BROADCAST)) { + return 0; + } +#endif /* LWIP_IPV4 && IP_SOF_BROADCAST_RECV */ + return 1; + } + + /* Only need to check PCB if incoming IP version matches PCB IP version */ + if(IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ip_current_dest_addr())) { + LWIP_ASSERT("UDP PCB: inconsistent local/remote IP versions", IP_IS_V6_VAL(pcb->local_ip) == IP_IS_V6_VAL(pcb->remote_ip)); + +#if LWIP_IPV4 + /* Special case: IPv4 broadcast: all or broadcasts in my subnet + * Note: broadcast variable can only be 1 if it is an IPv4 broadcast */ + if(broadcast != 0) { +#if IP_SOF_BROADCAST_RECV + if(ip_get_option(pcb, SOF_BROADCAST)) +#endif /* IP_SOF_BROADCAST_RECV */ + { + if(ip4_addr_isany(ip_2_ip4(&pcb->local_ip)) || + ((ip4_current_dest_addr()->addr == IPADDR_BROADCAST)) || + ip4_addr_netcmp(ip_2_ip4(&pcb->local_ip), ip4_current_dest_addr(), netif_ip4_netmask(inp))) { + return 1; + } + } + } else +#endif /* LWIP_IPV4 */ + /* Handle IPv4 and IPv6: all, multicast or exact match */ + if(ip_addr_isany(&pcb->local_ip) || +#if LWIP_IPV6_MLD + (ip_current_is_v6() && ip6_addr_ismulticast(ip6_current_dest_addr())) || +#endif /* LWIP_IPV6_MLD */ +#if LWIP_IGMP + (!ip_current_is_v6() && ip4_addr_ismulticast(ip4_current_dest_addr())) || +#endif /* LWIP_IGMP */ + ip_addr_cmp(&pcb->local_ip, ip_current_dest_addr())) { + return 1; + } + } + + return 0; +} + +/** + * Process an incoming UDP datagram. + * + * Given an incoming UDP datagram (as a chain of pbufs) this function + * finds a corresponding UDP PCB and hands over the pbuf to the pcbs + * recv function. If no pcb is found or the datagram is incorrect, the + * pbuf is freed. + * + * @param p pbuf to be demultiplexed to a UDP PCB (p->payload pointing to the UDP header) + * @param inp network interface on which the datagram was received. + * + */ +void +udp_input(struct pbuf *p, struct netif *inp) +{ + struct udp_hdr *udphdr; + struct udp_pcb *pcb, *prev; + struct udp_pcb *uncon_pcb; + u16_t src, dest; + u8_t broadcast; + u8_t for_us = 0; + + LWIP_UNUSED_ARG(inp); + + PERF_START; + + UDP_STATS_INC(udp.recv); + + /* Check minimum length (UDP header) */ + if (p->len < UDP_HLEN) { + /* drop short packets */ + LWIP_DEBUGF(UDP_DEBUG, + ("udp_input: short UDP datagram (%"U16_F" bytes) discarded\n", p->tot_len)); + UDP_STATS_INC(udp.lenerr); + UDP_STATS_INC(udp.drop); + MIB2_STATS_INC(mib2.udpinerrors); + pbuf_free(p); + goto end; + } + + udphdr = (struct udp_hdr *)p->payload; + + /* is broadcast packet ? */ + broadcast = ip_addr_isbroadcast(ip_current_dest_addr(), ip_current_netif()); + + LWIP_DEBUGF(UDP_DEBUG, ("udp_input: received datagram of length %"U16_F"\n", p->tot_len)); + + /* convert src and dest ports to host byte order */ + src = ntohs(udphdr->src); + dest = ntohs(udphdr->dest); + + udp_debug_print(udphdr); + + /* print the UDP source and destination */ + LWIP_DEBUGF(UDP_DEBUG, ("udp (")); + ip_addr_debug_print(UDP_DEBUG, ip_current_dest_addr()); + LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F") <-- (", ntohs(udphdr->dest))); + ip_addr_debug_print(UDP_DEBUG, ip_current_src_addr()); + LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F")\n", ntohs(udphdr->src))); + + pcb = NULL; + prev = NULL; + uncon_pcb = NULL; + /* Iterate through the UDP pcb list for a matching pcb. + * 'Perfect match' pcbs (connected to the remote port & ip address) are + * preferred. If no perfect match is found, the first unconnected pcb that + * matches the local port and ip address gets the datagram. */ + for (pcb = udp_pcbs; pcb != NULL; pcb = pcb->next) { + /* print the PCB local and remote address */ + LWIP_DEBUGF(UDP_DEBUG, ("pcb (")); + ip_addr_debug_print(UDP_DEBUG, &pcb->local_ip); + LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F") <-- (", pcb->local_port)); + ip_addr_debug_print(UDP_DEBUG, &pcb->remote_ip); + LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F")\n", pcb->remote_port)); + + /* compare PCB local addr+port to UDP destination addr+port */ + if ((pcb->local_port == dest) && + (udp_input_local_match(pcb, inp, broadcast) != 0)) { + if ((uncon_pcb == NULL) && + ((pcb->flags & UDP_FLAGS_CONNECTED) == 0)) { + /* the first unconnected matching PCB */ + uncon_pcb = pcb; + } + + /* compare PCB remote addr+port to UDP source addr+port */ + if ((pcb->remote_port == src) && + (ip_addr_isany_val(pcb->remote_ip) || + ip_addr_cmp(&pcb->remote_ip, ip_current_src_addr()))) { + /* the first fully matching PCB */ + if (prev != NULL) { + /* move the pcb to the front of udp_pcbs so that is + found faster next time */ + prev->next = pcb->next; + pcb->next = udp_pcbs; + udp_pcbs = pcb; + } else { + UDP_STATS_INC(udp.cachehit); + } + break; + } + } + + prev = pcb; + } + /* no fully matching pcb found? then look for an unconnected pcb */ + if (pcb == NULL) { + pcb = uncon_pcb; + } + + /* Check checksum if this is a match or if it was directed at us. */ + if (pcb != NULL) { + for_us = 1; + } else { +#if LWIP_IPV6 + if (ip_current_is_v6()) { + for_us = netif_get_ip6_addr_match(inp, ip6_current_dest_addr()) >= 0; + } +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 + if (!ip_current_is_v6()) { + for_us = ip4_addr_cmp(netif_ip4_addr(inp), ip4_current_dest_addr()); + } +#endif /* LWIP_IPV4 */ + } + + if (for_us) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_input: calculating checksum\n")); +#if CHECKSUM_CHECK_UDP + IF__NETIF_CHECKSUM_ENABLED(inp, CHECKSUM_CHECK_UDP) { +#if LWIP_UDPLITE + if (ip_current_header_proto() == IP_PROTO_UDPLITE) { + /* Do the UDP Lite checksum */ + u16_t chklen = ntohs(udphdr->len); + if (chklen < sizeof(struct udp_hdr)) { + if (chklen == 0) { + /* For UDP-Lite, checksum length of 0 means checksum + over the complete packet (See RFC 3828 chap. 3.1) */ + chklen = p->tot_len; + } else { + /* At least the UDP-Lite header must be covered by the + checksum! (Again, see RFC 3828 chap. 3.1) */ + goto chkerr; + } + } + if (ip_chksum_pseudo_partial(p, IP_PROTO_UDPLITE, + p->tot_len, chklen, + ip_current_src_addr(), ip_current_dest_addr()) != 0) { + goto chkerr; + } + } else +#endif /* LWIP_UDPLITE */ + { + if (udphdr->chksum != 0) { + if (ip_chksum_pseudo(p, IP_PROTO_UDP, p->tot_len, + ip_current_src_addr(), + ip_current_dest_addr()) != 0) { + goto chkerr; + } + } + } + } +#endif /* CHECKSUM_CHECK_UDP */ + if (pbuf_header(p, -UDP_HLEN)) { + /* Can we cope with this failing? Just assert for now */ + LWIP_ASSERT("pbuf_header failed\n", 0); + UDP_STATS_INC(udp.drop); + MIB2_STATS_INC(mib2.udpinerrors); + pbuf_free(p); + goto end; + } + + if (pcb != NULL) { + MIB2_STATS_INC(mib2.udpindatagrams); +#if SO_REUSE && SO_REUSE_RXTOALL + if (ip_get_option(pcb, SOF_REUSEADDR) && + (broadcast || ip_addr_ismulticast(ip_current_dest_addr()))) { + /* pass broadcast- or multicast packets to all multicast pcbs + if SOF_REUSEADDR is set on the first match */ + struct udp_pcb *mpcb; + u8_t p_header_changed = 0; + s16_t hdrs_len = (s16_t)(ip_current_header_tot_len() + UDP_HLEN); + for (mpcb = udp_pcbs; mpcb != NULL; mpcb = mpcb->next) { + if (mpcb != pcb) { + /* compare PCB local addr+port to UDP destination addr+port */ + if ((mpcb->local_port == dest) && + (udp_input_local_match(mpcb, inp, broadcast) != 0)) { + /* pass a copy of the packet to all local matches */ + if (mpcb->recv != NULL) { + struct pbuf *q; + /* for that, move payload to IP header again */ + if (p_header_changed == 0) { + pbuf_header_force(p, hdrs_len); + p_header_changed = 1; + } + q = pbuf_alloc(PBUF_RAW, p->tot_len, PBUF_RAM); + if (q != NULL) { + err_t err = pbuf_copy(q, p); + if (err == ERR_OK) { + /* move payload to UDP data */ + pbuf_header(q, -hdrs_len); + mpcb->recv(mpcb->recv_arg, mpcb, q, ip_current_src_addr(), src); + } + } + } + } + } + } + if (p_header_changed) { + /* and move payload to UDP data again */ + pbuf_header(p, -hdrs_len); + } + } +#endif /* SO_REUSE && SO_REUSE_RXTOALL */ + /* callback */ + if (pcb->recv != NULL) { + /* now the recv function is responsible for freeing p */ + pcb->recv(pcb->recv_arg, pcb, p, ip_current_src_addr(), src); + } else { + /* no recv function registered? then we have to free the pbuf! */ + pbuf_free(p); + goto end; + } + } else { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_input: not for us.\n")); + +#if LWIP_ICMP || LWIP_ICMP6 + /* No match was found, send ICMP destination port unreachable unless + destination address was broadcast/multicast. */ + if (!broadcast && !ip_addr_ismulticast(ip_current_dest_addr())) { + /* move payload pointer back to ip header */ + pbuf_header_force(p, ip_current_header_tot_len() + UDP_HLEN); + icmp_port_unreach(ip_current_is_v6(), p); + } +#endif /* LWIP_ICMP || LWIP_ICMP6 */ + UDP_STATS_INC(udp.proterr); + UDP_STATS_INC(udp.drop); + MIB2_STATS_INC(mib2.udpnoports); + pbuf_free(p); + } + } else { + pbuf_free(p); + } +end: + PERF_STOP("udp_input"); + return; +#if CHECKSUM_CHECK_UDP +chkerr: + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("udp_input: UDP (or UDP Lite) datagram discarded due to failing checksum\n")); + UDP_STATS_INC(udp.chkerr); + UDP_STATS_INC(udp.drop); + MIB2_STATS_INC(mib2.udpinerrors); + pbuf_free(p); + PERF_STOP("udp_input"); +#endif /* CHECKSUM_CHECK_UDP */ +} + +/** + * Send data using UDP. + * + * @param pcb UDP PCB used to send the data. + * @param p chain of pbuf's to be sent. + * + * The datagram will be sent to the current remote_ip & remote_port + * stored in pcb. If the pcb is not bound to a port, it will + * automatically be bound to a random port. + * + * @return lwIP error code. + * - ERR_OK. Successful. No error occurred. + * - ERR_MEM. Out of memory. + * - ERR_RTE. Could not find route to destination address. + * - ERR_VAL. No PCB or PCB is dual-stack + * - More errors could be returned by lower protocol layers. + * + * @see udp_disconnect() udp_sendto() + */ +err_t +udp_send(struct udp_pcb *pcb, struct pbuf *p) +{ + if ((pcb == NULL) || IP_IS_ANY_TYPE_VAL(pcb->remote_ip)) { + return ERR_VAL; + } + + /* send to the packet using remote ip and port stored in the pcb */ + return udp_sendto(pcb, p, &pcb->remote_ip, pcb->remote_port); +} + +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP +/** Same as udp_send() but with checksum + */ +err_t +udp_send_chksum(struct udp_pcb *pcb, struct pbuf *p, + u8_t have_chksum, u16_t chksum) +{ + if ((pcb == NULL) || IP_IS_ANY_TYPE_VAL(pcb->remote_ip)) { + return ERR_VAL; + } + + /* send to the packet using remote ip and port stored in the pcb */ + return udp_sendto_chksum(pcb, p, &pcb->remote_ip, pcb->remote_port, + have_chksum, chksum); +} +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + +/** + * Send data to a specified address using UDP. + * + * @param pcb UDP PCB used to send the data. + * @param p chain of pbuf's to be sent. + * @param dst_ip Destination IP address. + * @param dst_port Destination UDP port. + * + * dst_ip & dst_port are expected to be in the same byte order as in the pcb. + * + * If the PCB already has a remote address association, it will + * be restored after the data is sent. + * + * @return lwIP error code (@see udp_send for possible error codes) + * + * @see udp_disconnect() udp_send() + */ +err_t +udp_sendto(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port) +{ +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP + return udp_sendto_chksum(pcb, p, dst_ip, dst_port, 0, 0); +} + +/** Same as udp_sendto(), but with checksum */ +err_t +udp_sendto_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, + u16_t dst_port, u8_t have_chksum, u16_t chksum) +{ +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + struct netif *netif; + const ip_addr_t *dst_ip_route = dst_ip; + + if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) { + return ERR_VAL; + } + + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_send\n")); + +#if LWIP_IPV6 || (LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS) + if (ip_addr_ismulticast(dst_ip_route)) { +#if LWIP_IPV6 + if (IP_IS_V6(dst_ip)) { + /* For multicast, find a netif based on source address. */ + dst_ip_route = &pcb->local_ip; + } else +#endif /* LWIP_IPV6 */ + { +#if LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS + /* IPv4 does not use source-based routing by default, so we use an + administratively selected interface for multicast by default. + However, this can be overridden by setting an interface address + in pcb->multicast_ip that is used for routing. */ + if (!ip_addr_isany_val(pcb->multicast_ip) && + !ip4_addr_cmp(ip_2_ip4(&pcb->multicast_ip), IP4_ADDR_BROADCAST)) { + dst_ip_route = &pcb->multicast_ip; + } +#endif /* LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS */ + } + } +#endif /* LWIP_IPV6 || (LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS) */ + + /* find the outgoing network interface for this packet */ + netif = ip_route(&pcb->local_ip, dst_ip_route); + + /* no outgoing network interface could be found? */ + if (netif == NULL) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: No route to ")); + ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, dst_ip); + LWIP_DEBUGF(UDP_DEBUG, ("\n")); + UDP_STATS_INC(udp.rterr); + return ERR_RTE; + } +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP + return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, have_chksum, chksum); +#else /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + return udp_sendto_if(pcb, p, dst_ip, dst_port, netif); +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ +} + +/** + * Send data to a specified address using UDP. + * The netif used for sending can be specified. + * + * This function exists mainly for DHCP, to be able to send UDP packets + * on a netif that is still down. + * + * @param pcb UDP PCB used to send the data. + * @param p chain of pbuf's to be sent. + * @param dst_ip Destination IP address. + * @param dst_port Destination UDP port. + * @param netif the netif used for sending. + * + * dst_ip & dst_port are expected to be in the same byte order as in the pcb. + * + * @return lwIP error code (@see udp_send for possible error codes) + * + * @see udp_disconnect() udp_send() + */ +err_t +udp_sendto_if(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif) +{ +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP + return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, 0, 0); +} + +/** Same as udp_sendto_if(), but with checksum */ +err_t +udp_sendto_if_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, + u16_t dst_port, struct netif *netif, u8_t have_chksum, + u16_t chksum) +{ +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + const ip_addr_t *src_ip; + + if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) { + return ERR_VAL; + } + + /* PCB local address is IP_ANY_ADDR? */ +#if LWIP_IPV6 + if (IP_IS_V6(dst_ip)) { + if (ip6_addr_isany(ip_2_ip6(&pcb->local_ip))) { + src_ip = ip6_select_source_address(netif, ip_2_ip6(dst_ip)); + if (src_ip == NULL) { + /* No suitable source address was found. */ + return ERR_RTE; + } + } else { + /* use UDP PCB local IPv6 address as source address, if still valid. */ + if (netif_get_ip6_addr_match(netif, ip_2_ip6(&pcb->local_ip)) < 0) { + /* Address isn't valid anymore. */ + return ERR_RTE; + } + src_ip = &pcb->local_ip; + } + } +#endif /* LWIP_IPV6 */ +#if LWIP_IPV4 && LWIP_IPV6 + else +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +#if LWIP_IPV4 + if (ip4_addr_isany(ip_2_ip4(&pcb->local_ip))) { + /* use outgoing network interface IP address as source address */ + src_ip = netif_ip_addr4(netif); + } else { + /* check if UDP PCB local IP address is correct + * this could be an old address if netif->ip_addr has changed */ + if (!ip4_addr_cmp(ip_2_ip4(&(pcb->local_ip)), netif_ip4_addr(netif))) { + /* local_ip doesn't match, drop the packet */ + return ERR_VAL; + } + /* use UDP PCB local IP address as source address */ + src_ip = &pcb->local_ip; + } +#endif /* LWIP_IPV4 */ +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP + return udp_sendto_if_src_chksum(pcb, p, dst_ip, dst_port, netif, have_chksum, chksum, src_ip); +#else /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + return udp_sendto_if_src(pcb, p, dst_ip, dst_port, netif, src_ip); +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ +} + +/** Same as udp_sendto_if(), but with source address */ +err_t +udp_sendto_if_src(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, const ip_addr_t *src_ip) +{ +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP + return udp_sendto_if_src_chksum(pcb, p, dst_ip, dst_port, netif, 0, 0, src_ip); +} + +/** Same as udp_sendto_if_src(), but with checksum */ +err_t +udp_sendto_if_src_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip, + u16_t dst_port, struct netif *netif, u8_t have_chksum, + u16_t chksum, const ip_addr_t *src_ip) +{ +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + struct udp_hdr *udphdr; + err_t err; + struct pbuf *q; /* q will be sent down the stack */ + u8_t ip_proto; + u8_t ttl; + + if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, src_ip) || + !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) { + return ERR_VAL; + } + +#if LWIP_IPV4 && IP_SOF_BROADCAST + /* broadcast filter? */ + if (!ip_get_option(pcb, SOF_BROADCAST) && +#if LWIP_IPV6 + !IP_IS_V6(dst_ip) && +#endif /* LWIP_IPV6 */ + ip_addr_isbroadcast(dst_ip, netif)) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, + ("udp_sendto_if: SOF_BROADCAST not enabled on pcb %p\n", (void *)pcb)); + return ERR_VAL; + } +#endif /* LWIP_IPV4 && IP_SOF_BROADCAST */ + + /* if the PCB is not yet bound to a port, bind it here */ + if (pcb->local_port == 0) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_send: not yet bound to a port, binding now\n")); + err = udp_bind(pcb, &pcb->local_ip, pcb->local_port); + if (err != ERR_OK) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: forced port bind failed\n")); + return err; + } + } + + /* not enough space to add an UDP header to first pbuf in given p chain? */ + if (pbuf_header(p, UDP_HLEN)) { + /* allocate header in a separate new pbuf */ + q = pbuf_alloc(PBUF_IP, UDP_HLEN, PBUF_RAM); + /* new header pbuf could not be allocated? */ + if (q == NULL) { + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: could not allocate header\n")); + return ERR_MEM; + } + if (p->tot_len != 0) { + /* chain header q in front of given pbuf p (only if p contains data) */ + pbuf_chain(q, p); + } + /* first pbuf q points to header pbuf */ + LWIP_DEBUGF(UDP_DEBUG, + ("udp_send: added header pbuf %p before given pbuf %p\n", (void *)q, (void *)p)); + } else { + /* adding space for header within p succeeded */ + /* first pbuf q equals given pbuf */ + q = p; + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: added header in given pbuf %p\n", (void *)p)); + } + LWIP_ASSERT("check that first pbuf can hold struct udp_hdr", + (q->len >= sizeof(struct udp_hdr))); + /* q now represents the packet to be sent */ + udphdr = (struct udp_hdr *)q->payload; + udphdr->src = htons(pcb->local_port); + udphdr->dest = htons(dst_port); + /* in UDP, 0 checksum means 'no checksum' */ + udphdr->chksum = 0x0000; + + /* Multicast Loop? */ +#if (LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS) || (LWIP_IPV6 && LWIP_IPV6_MLD) + if (((pcb->flags & UDP_FLAGS_MULTICAST_LOOP) != 0) && ip_addr_ismulticast(dst_ip)) { + q->flags |= PBUF_FLAG_MCASTLOOP; + } +#endif /* (LWIP_IPV4 && LWIP_MULTICAST_TX_OPTIONS) || (LWIP_IPV6 && LWIP_IPV6_MLD) */ + + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: sending datagram of length %"U16_F"\n", q->tot_len)); + +#if LWIP_UDPLITE + /* UDP Lite protocol? */ + if (pcb->flags & UDP_FLAGS_UDPLITE) { + u16_t chklen, chklen_hdr; + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP LITE packet length %"U16_F"\n", q->tot_len)); + /* set UDP message length in UDP header */ + chklen_hdr = chklen = pcb->chksum_len_tx; + if ((chklen < sizeof(struct udp_hdr)) || (chklen > q->tot_len)) { + if (chklen != 0) { + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP LITE pcb->chksum_len is illegal: %"U16_F"\n", chklen)); + } + /* For UDP-Lite, checksum length of 0 means checksum + over the complete packet. (See RFC 3828 chap. 3.1) + At least the UDP-Lite header must be covered by the + checksum, therefore, if chksum_len has an illegal + value, we generate the checksum over the complete + packet to be safe. */ + chklen_hdr = 0; + chklen = q->tot_len; + } + udphdr->len = htons(chklen_hdr); + /* calculate checksum */ +#if CHECKSUM_GEN_UDP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_UDP) { +#if LWIP_CHECKSUM_ON_COPY + if (have_chksum) { + chklen = UDP_HLEN; + } +#endif /* LWIP_CHECKSUM_ON_COPY */ + udphdr->chksum = ip_chksum_pseudo_partial(q, IP_PROTO_UDPLITE, + q->tot_len, chklen, src_ip, dst_ip); +#if LWIP_CHECKSUM_ON_COPY + if (have_chksum) { + u32_t acc; + acc = udphdr->chksum + (u16_t)~(chksum); + udphdr->chksum = FOLD_U32T(acc); + } +#endif /* LWIP_CHECKSUM_ON_COPY */ + + /* chksum zero must become 0xffff, as zero means 'no checksum' */ + if (udphdr->chksum == 0x0000) { + udphdr->chksum = 0xffff; + } + } +#endif /* CHECKSUM_GEN_UDP */ + + ip_proto = IP_PROTO_UDPLITE; + } else +#endif /* LWIP_UDPLITE */ + { /* UDP */ + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP packet length %"U16_F"\n", q->tot_len)); + udphdr->len = htons(q->tot_len); + /* calculate checksum */ +#if CHECKSUM_GEN_UDP + IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_UDP) { + /* Checksum is mandatory over IPv6. */ + if (IP_IS_V6(dst_ip) || (pcb->flags & UDP_FLAGS_NOCHKSUM) == 0) { + u16_t udpchksum; +#if LWIP_CHECKSUM_ON_COPY + if (have_chksum) { + u32_t acc; + udpchksum = ip_chksum_pseudo_partial(q, IP_PROTO_UDP, + q->tot_len, UDP_HLEN, src_ip, dst_ip); + acc = udpchksum + (u16_t)~(chksum); + udpchksum = FOLD_U32T(acc); + } else +#endif /* LWIP_CHECKSUM_ON_COPY */ + { + udpchksum = ip_chksum_pseudo(q, IP_PROTO_UDP, q->tot_len, + src_ip, dst_ip); + } + + /* chksum zero must become 0xffff, as zero means 'no checksum' */ + if (udpchksum == 0x0000) { + udpchksum = 0xffff; + } + udphdr->chksum = udpchksum; + } + } +#endif /* CHECKSUM_GEN_UDP */ + ip_proto = IP_PROTO_UDP; + } + + /* Determine TTL to use */ +#if LWIP_MULTICAST_TX_OPTIONS + ttl = (ip_addr_ismulticast(dst_ip) ? pcb->mcast_ttl : pcb->ttl); +#else /* LWIP_MULTICAST_TX_OPTIONS */ + ttl = pcb->ttl; +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP checksum 0x%04"X16_F"\n", udphdr->chksum)); + LWIP_DEBUGF(UDP_DEBUG, ("udp_send: ip_output_if (,,,,0x%02"X16_F",)\n", (u16_t)ip_proto)); + /* output to IP */ + NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint)); + err = ip_output_if_src(q, src_ip, dst_ip, ttl, pcb->tos, ip_proto, netif); + NETIF_SET_HWADDRHINT(netif, NULL); + + /* TODO: must this be increased even if error occurred? */ + MIB2_STATS_INC(mib2.udpoutdatagrams); + + /* did we chain a separate header pbuf earlier? */ + if (q != p) { + /* free the header pbuf */ + pbuf_free(q); + q = NULL; + /* p is still referenced by the caller, and will live on */ + } + + UDP_STATS_INC(udp.xmit); + return err; +} + +/** + * Bind an UDP PCB. + * + * @param pcb UDP PCB to be bound with a local address ipaddr and port. + * @param ipaddr local IP address to bind with. Use IP_ADDR_ANY to + * bind to all local interfaces. + * @param port local UDP port to bind with. Use 0 to automatically bind + * to a random port between UDP_LOCAL_PORT_RANGE_START and + * UDP_LOCAL_PORT_RANGE_END. + * + * ipaddr & port are expected to be in the same byte order as in the pcb. + * + * @return lwIP error code. + * - ERR_OK. Successful. No error occurred. + * - ERR_USE. The specified ipaddr and port are already bound to by + * another UDP PCB. + * + * @see udp_disconnect() + */ +err_t +udp_bind(struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port) +{ + struct udp_pcb *ipcb; + u8_t rebind; + +#if LWIP_IPV4 + /* Don't propagate NULL pointer (IPv4 ANY) to subsequent functions */ + if (ipaddr == NULL) { + ipaddr = IP_ADDR_ANY; + } +#endif /* LWIP_IPV4 */ + + /* still need to check for ipaddr == NULL in IPv6 only case */ + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_bind(ipaddr = ")); + ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE, ipaddr); + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, (", port = %"U16_F")\n", port)); + + rebind = 0; + /* Check for double bind and rebind of the same pcb */ + for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) { + /* is this UDP PCB already on active list? */ + if (pcb == ipcb) { + rebind = 1; + break; + } + } + + /* no port specified? */ + if (port == 0) { + port = udp_new_port(); + if (port == 0) { + /* no more ports available in local range */ + LWIP_DEBUGF(UDP_DEBUG, ("udp_bind: out of free UDP ports\n")); + return ERR_USE; + } + } else { + for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) { + if (pcb != ipcb) { + /* By default, we don't allow to bind to a port that any other udp + PCB is already bound to, unless *all* PCBs with that port have tha + REUSEADDR flag set. */ +#if SO_REUSE + if (!ip_get_option(pcb, SOF_REUSEADDR) || + !ip_get_option(ipcb, SOF_REUSEADDR)) +#endif /* SO_REUSE */ + { + /* port matches that of PCB in list and REUSEADDR not set -> reject */ + if ((ipcb->local_port == port) && (IP_IS_V6(ipaddr) == IP_IS_V6_VAL(ipcb->local_ip)) && + /* IP address matches, or one is IP_ADDR_ANY? */ + (ip_addr_isany(&ipcb->local_ip) || + ip_addr_isany(ipaddr) || + ip_addr_cmp(&ipcb->local_ip, ipaddr))) { + /* other PCB already binds to this local IP and port */ + LWIP_DEBUGF(UDP_DEBUG, + ("udp_bind: local port %"U16_F" already bound by another pcb\n", port)); + return ERR_USE; + } + } + } + } + } + + ip_addr_set_ipaddr(&pcb->local_ip, ipaddr); + + pcb->local_port = port; + mib2_udp_bind(pcb); + /* pcb not active yet? */ + if (rebind == 0) { + /* place the PCB on the active list if not already there */ + pcb->next = udp_pcbs; + udp_pcbs = pcb; + } + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("udp_bind: bound to ")); + ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, &pcb->local_ip); + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, (", port %"U16_F")\n", pcb->local_port)); + return ERR_OK; +} + +/** + * Connect an UDP PCB. + * + * This will associate the UDP PCB with the remote address. + * + * @param pcb UDP PCB to be connected with remote address ipaddr and port. + * @param ipaddr remote IP address to connect with. + * @param port remote UDP port to connect with. + * + * @return lwIP error code + * + * ipaddr & port are expected to be in the same byte order as in the pcb. + * + * The udp pcb is bound to a random local port if not already bound. + * + * @see udp_disconnect() + */ +err_t +udp_connect(struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port) +{ + struct udp_pcb *ipcb; + + if ((pcb == NULL) || (ipaddr == NULL) || !IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) { + return ERR_VAL; + } + + if (pcb->local_port == 0) { + err_t err = udp_bind(pcb, &pcb->local_ip, pcb->local_port); + if (err != ERR_OK) { + return err; + } + } + + ip_addr_set_ipaddr(&pcb->remote_ip, ipaddr); + pcb->remote_port = port; + pcb->flags |= UDP_FLAGS_CONNECTED; + + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("udp_connect: connected to ")); + ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, + &pcb->remote_ip); + LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, (", port %"U16_F")\n", pcb->remote_port)); + + /* Insert UDP PCB into the list of active UDP PCBs. */ + for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) { + if (pcb == ipcb) { + /* already on the list, just return */ + return ERR_OK; + } + } + /* PCB not yet on the list, add PCB now */ + pcb->next = udp_pcbs; + udp_pcbs = pcb; + return ERR_OK; +} + +/** + * Disconnect a UDP PCB + * + * @param pcb the udp pcb to disconnect. + */ +void +udp_disconnect(struct udp_pcb *pcb) +{ + /* reset remote address association */ + ip_addr_set_any(IP_IS_V6_VAL(pcb->remote_ip), &pcb->remote_ip); + pcb->remote_port = 0; + /* mark PCB as unconnected */ + pcb->flags &= ~UDP_FLAGS_CONNECTED; +} + +/** + * Set a receive callback for a UDP PCB + * + * This callback will be called when receiving a datagram for the pcb. + * + * @param pcb the pcb for which to set the recv callback + * @param recv function pointer of the callback function + * @param recv_arg additional argument to pass to the callback function + */ +void +udp_recv(struct udp_pcb *pcb, udp_recv_fn recv, void *recv_arg) +{ + /* remember recv() callback and user data */ + pcb->recv = recv; + pcb->recv_arg = recv_arg; +} + +/** + * Remove an UDP PCB. + * + * @param pcb UDP PCB to be removed. The PCB is removed from the list of + * UDP PCB's and the data structure is freed from memory. + * + * @see udp_new() + */ +void +udp_remove(struct udp_pcb *pcb) +{ + struct udp_pcb *pcb2; + + mib2_udp_unbind(pcb); + /* pcb to be removed is first in list? */ + if (udp_pcbs == pcb) { + /* make list start at 2nd pcb */ + udp_pcbs = udp_pcbs->next; + /* pcb not 1st in list */ + } else { + for (pcb2 = udp_pcbs; pcb2 != NULL; pcb2 = pcb2->next) { + /* find pcb in udp_pcbs list */ + if (pcb2->next != NULL && pcb2->next == pcb) { + /* remove pcb from list */ + pcb2->next = pcb->next; + break; + } + } + } + memp_free(MEMP_UDP_PCB, pcb); +} + +/** + * Create a UDP PCB. + * + * @return The UDP PCB which was created. NULL if the PCB data structure + * could not be allocated. + * + * @see udp_remove() + */ +struct udp_pcb * +udp_new(void) +{ + struct udp_pcb *pcb; + pcb = (struct udp_pcb *)memp_malloc(MEMP_UDP_PCB); + /* could allocate UDP PCB? */ + if (pcb != NULL) { + /* UDP Lite: by initializing to all zeroes, chksum_len is set to 0 + * which means checksum is generated over the whole datagram per default + * (recommended as default by RFC 3828). */ + /* initialize PCB to all zeroes */ + memset(pcb, 0, sizeof(struct udp_pcb)); + pcb->ttl = UDP_TTL; +#if LWIP_MULTICAST_TX_OPTIONS + pcb->mcast_ttl = UDP_TTL; +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + } + return pcb; +} + +/** + * Create a UDP PCB for specific IP type. + * + * @param type IP address type, see IPADDR_TYPE_XX definitions. + * @return The UDP PCB which was created. NULL if the PCB data structure + * could not be allocated. + * + * @see udp_remove() + */ +struct udp_pcb * +udp_new_ip_type(u8_t type) +{ + struct udp_pcb *pcb; + pcb = udp_new(); +#if LWIP_IPV4 && LWIP_IPV6 + if(pcb != NULL) { + IP_SET_TYPE_VAL(pcb->local_ip, type); + IP_SET_TYPE_VAL(pcb->remote_ip, type); + } +#else + LWIP_UNUSED_ARG(type); +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + return pcb; +} + +#if LWIP_IPV4 +/** This function is called from netif.c when address is changed + * + * @param old_addr IPv4 address of the netif before change + * @param new_addr IPv4 address of the netif after change + */ +void udp_netif_ipv4_addr_changed(const ip4_addr_t* old_addr, const ip4_addr_t* new_addr) +{ + struct udp_pcb* upcb; + + if (!ip4_addr_isany(new_addr)) { + for (upcb = udp_pcbs; upcb != NULL; upcb = upcb->next) { + /* Is this an IPv4 pcb? */ + if (!IP_IS_V6_VAL(upcb->local_ip)) { + /* PCB bound to current local interface address? */ + if (!ip4_addr_isany(ip_2_ip4(&upcb->local_ip)) && + ip4_addr_cmp(ip_2_ip4(&upcb->local_ip), old_addr)) { + /* The PCB is bound to the old ipaddr and + * is set to bound to the new one instead */ + ip_addr_copy_from_ip4(upcb->local_ip, *new_addr); + } + } + } + } +} +#endif /* LWIP_IPV4 */ + +#if UDP_DEBUG +/** + * Print UDP header information for debug purposes. + * + * @param udphdr pointer to the udp header in memory. + */ +void +udp_debug_print(struct udp_hdr *udphdr) +{ + LWIP_DEBUGF(UDP_DEBUG, ("UDP header:\n")); + LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(UDP_DEBUG, ("| %5"U16_F" | %5"U16_F" | (src port, dest port)\n", + ntohs(udphdr->src), ntohs(udphdr->dest))); + LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n")); + LWIP_DEBUGF(UDP_DEBUG, ("| %5"U16_F" | 0x%04"X16_F" | (len, chksum)\n", + ntohs(udphdr->len), ntohs(udphdr->chksum))); + LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n")); +} +#endif /* UDP_DEBUG */ + +#endif /* LWIP_UDP */ diff --git a/components/lwip/include/lwip/apps/dhcpserver.h b/components/lwip/include/lwip/apps/dhcpserver.h new file mode 100644 index 000000000..a0099e32d --- /dev/null +++ b/components/lwip/include/lwip/apps/dhcpserver.h @@ -0,0 +1,494 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef __DHCPS_H__ +#define __DHCPS_H__ + +#include "lwip/ip_addr.h" +//#include "esp_common.h" +#define USE_DNS +/* Here for now until needed in other places in lwIP */ +#ifndef isprint +#define in_range(c, lo, up) ((u8_t)c >= lo && (u8_t)c <= up) +#define isprint(c) in_range(c, 0x20, 0x7f) +#define isdigit(c) in_range(c, '0', '9') +#define isxdigit(c) (isdigit(c) || in_range(c, 'a', 'f') || in_range(c, 'A', 'F')) +#define islower(c) in_range(c, 'a', 'z') +#define isspace(c) (c == ' ' || c == '\f' || c == '\n' || c == '\r' || c == '\t' || c == '\v') +#endif + +#ifdef LWIP_ESP8266 + +typedef struct dhcps_state{ + s16_t state; +} dhcps_state; + +typedef struct dhcps_msg { + u8_t op, htype, hlen, hops; + u8_t xid[4]; + u16_t secs, flags; + u8_t ciaddr[4]; + u8_t yiaddr[4]; + u8_t siaddr[4]; + u8_t giaddr[4]; + u8_t chaddr[16]; + u8_t sname[64]; + u8_t file[128]; + u8_t options[312]; +}dhcps_msg; + +struct dhcps_lease { + bool enable; + ip4_addr_t start_ip; + ip4_addr_t end_ip; +}; + +enum dhcps_offer_option{ + OFFER_START = 0x00, + OFFER_ROUTER = 0x01, + OFFER_END +}; + +struct dhcps_pool{ + ip4_addr_t ip; + u8_t mac[6]; + u32_t lease_timer; +}; + +typedef struct _list_node{ + void *pnode; + struct _list_node *pnext; +}list_node; + +extern u32_t dhcps_lease_time; +#define DHCPS_LEASE_TIMER dhcps_lease_time //0x05A0 + +#define dhcps_router_enabled(offer) ((offer & OFFER_ROUTER) != 0) +void dhcps_start(struct netif *netif); +void dhcps_stop(struct netif *netif); + +#else +#include "lwip/opt.h" + +#include "lwip/netif.h" +#include "lwip/udp.h" + +/** DHCP DEBUG INFO **/ +#define DHCPS_DEBUG 1 +#if DHCPS_DEBUG +#define log_info(message, ...) do { \ + os_printf((message), ##__VA_ARGS__); \ + os_printf("\n"); \ + } while(0); + +#else +#define log_info(message, ...) +#endif + +#if (!defined(unlikely)) +#define unlikely(Expression) !!(Expression) +#endif + +#define REQUIRE_ASSERT(Expression) do{if (!(Expression)) log_info("%d\n", __LINE__);}while(0) + +#define REQUIRE_ACTION(Expression,Label,Action) \ + do{\ + if (unlikely(!(Expression))) \ + {\ + log_info("%d\n", __LINE__);\ + {Action;}\ + goto Label;\ + }\ + }while(0) + +#define REQUIRE_NOERROR(Expression,Label) \ + do{\ + int LocalError;\ + LocalError = (int)Expression;\ + if (unlikely(LocalError != 0)) \ + {\ + log_info("%d 0x%x\n", __LINE__, LocalError);\ + goto Label;\ + }\ + }while(0) + +#define REQUIRE_NOERROR_ACTION(Expression,Label,Action) \ + do{\ + int LocalError;\ + LocalError = (int)Expression;\ + if (unlikely(LocalError != 0)) \ + {\ + log_info("%d\n", __LINE__);\ + {Action;}\ + goto Label;\ + }\ + }while(0) + +#define DHCP_OK 0 +#define DHCP_FAIL -1 +#define DHCP_SERVER_OPENDNS 0xd043dede /* OpenDNS DNS server 208.67.222.222 */ + +/* DHCP message */ +/* + * Code ID of DHCP and BOOTP options + * as defined in RFC 2132 + */ +typedef enum +{ + DHCP_NONE = 0, + DHCPS_DISCOVER = 1, + DHCPS_OFFER = 2, + DHCPS_REQUEST = 3, + DHCPS_DECLINE = 4, + DHCPS_ACK = 5, + DHCPS_NAK = 6, + DHCPS_RELEASE = 7, + DHCPS_INFORM = 8, + DHCP_FORCE_RENEW = 9, + DHCP_LEASE_QUERY = 10, + DHCP_LEASE_UNASSIGNED = 11, + DHCP_LEASE_UNKNOWN = 12, + DHCP_LEASE_ACTIVE = 13, +} dhcp_msg_type; + +typedef enum +{ + BOOTPS = 67, + BOOTPC = 68 +} ports; + +typedef enum +{ + BOOTREQUEST = 1, + BOOTREPLY = 2, +} op_types; + +typedef enum +{ + ETHERNET = 0x01, + ETHERNET_LAN = 0x06, + ETHEFDDI = 0x08, + ETHEIEEE1394 = 0x18 +} hardware_types; + +typedef enum +{ + DHCPS_CHADDR_LEN = 16U, + DHCPS_SNAME_LEN = 64U, + DHCPS_FILE_LEN = 128U, + DHCP_HEADER_SIZE = 236U // without size of options +} head_size; + +typedef struct dhcps +{ + /** transaction identifier of last sent request */ + u32_t xid; + /** incoming msg */ + struct dhcps_msg *msg_in; + /** track PCB allocation state */ + u8_t pcb_allocated; + /** current DHCP state machine state */ + u8_t state; + /** retries of current request */ + u8_t tries; +#if LWIP_DHCP_AUTOIP_COOP + u8_t autoip_coop_state; +#endif + u8_t subnet_mask_given; + + struct pbuf *p_out; /* pbuf of outcoming msg */ + struct dhcp_msg *msg_out; /* outgoing msg */ + u16_t options_out_len; /* outgoing msg options length */ + u16_t request_timeout; /* #ticks with period DHCP_FINE_TIMER_SECS for request timeout */ + u16_t t1_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for renewal time */ + u16_t t2_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for rebind time */ + u16_t t1_renew_time; /* #ticks with period DHCP_COARSE_TIMER_SECS until next renew try */ + u16_t t2_rebind_time; /* #ticks with period DHCP_COARSE_TIMER_SECS until next rebind try */ + u16_t lease_used; /* #ticks with period DHCP_COARSE_TIMER_SECS since last received DHCP ack */ + u16_t t0_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for lease time */ + ip_addr_t server_ip_addr; /* dhcp server address that offered this lease (ip_addr_t because passed to UDP) */ + ip4_addr_t offered_ip_addr; + ip4_addr_t offered_sn_mask; + ip4_addr_t offered_gw_addr; + + u32_t offered_t0_lease; /* lease period (in seconds) */ + u32_t offered_t1_renew; /* recommended renew time (usually 50% of lease period) */ + u32_t offered_t2_rebind; /* recommended rebind time (usually 87.5 of lease period) */ +#if LWIP_DHCP_BOOTP_FILE + ip_addr_t offered_si_addr; + char boot_file_name[DHCP_FILE_LEN]; +#endif /* LWIP_DHCP_BOOTPFILE */ + +} dhcps; + +typedef struct dhcp_message +{ + PACK_STRUCT_FLD_8(u8_t op); + PACK_STRUCT_FLD_8(u8_t htype); + PACK_STRUCT_FLD_8(u8_t hlen); + PACK_STRUCT_FLD_8(u8_t hops); + PACK_STRUCT_FIELD(u32_t xid); + PACK_STRUCT_FIELD(u16_t secs); + PACK_STRUCT_FIELD(u16_t flags); + PACK_STRUCT_FLD_S(ip4_addr_p_t ciaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t yiaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t siaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t giaddr); + PACK_STRUCT_FLD_8(u8_t chaddr[DHCPS_CHADDR_LEN]); + PACK_STRUCT_FLD_8(u8_t sname[DHCPS_SNAME_LEN]); + PACK_STRUCT_FLD_8(u8_t file[DHCPS_FILE_LEN]); +// PACK_STRUCT_FIELD(u32_t cookie); +#define DHCPS_MIN_OPTIONS_LEN 312U + /** make sure user does not configure this too small */ +#if ((defined(DHCPS_OPTIONS_LEN)) && (DHCPS_OPTIONS_LEN < DHCPS_MIN_OPTIONS_LEN)) +#undef DHCPS_OPTIONS_LEN +#endif + /** allow this to be configured in lwipopts.h, but not too small */ +#if (!defined(DHCPS_OPTIONS_LEN)) + /** set this to be sufficient for your options in outgoing DHCP msgs */ +#define DHCPS_OPTIONS_LEN DHCPS_MIN_OPTIONS_LEN +#endif + PACK_STRUCT_FLD_8(u8_t options[DHCPS_OPTIONS_LEN]); +} dhcp_message; + +/** DHCP OPTIONS CODE **/ +typedef enum +{ + /* RFC 1497 Vendor Extensions */ + + PAD = 0, + END = 255, + + SUBNET_MASK = 1, + TIME_OFFSET = 2, + ROUTER = 3, + TIME_SERVER = 4, + NAME_SERVER = 5, + DOMAIN_NAME_SERVER = 6, + LOG_SERVER = 7, + COOKIE_SERVER = 8, + LPR_SERVER = 9, + IMPRESS_SERVER = 10, + RESOURCE_LOCATION_SERVER = 11, + HOST_NAME = 12, + BOOT_FILE_SIZE = 13, + MERIT_DUMP_FILE = 14, + DOMAIN_NAME = 15, + SWAP_SERVER = 16, + ROOT_PATH = 17, + EXTENSIONS_PATH = 18, + + /* IP Layer Parameters per Host */ + + IP_FORWARDING = 19, + NON_LOCAL_SOURCE_ROUTING = 20, + POLICY_FILTER = 21, + MAXIMUM_DATAGRAM_REASSEMBLY_SIZE = 22, + DEFAULT_IP_TIME_TO_LIVE = 23, + PATH_MTU_AGING_TIMEOUT = 24, + PATH_MTU_PLATEAU_TABLE = 25, + + /* IP Layer Parameters per Interface */ + + INTERFACE_MTU = 26, + ALL_SUBNETS_ARE_LOCAL = 27, + BROADCAST_ADDRESS = 28, + PERFORM_MASK_DISCOVERY = 29, + MASK_SUPPLIER = 30, + PERFORM_ROUTER_DISCOVERY = 31, + ROUTER_SOLICITATION_ADDRESS = 32, + STATIC_ROUTE = 33, + + /* Link Layer Parameters per Interface */ + + TRAILER_ENCAPSULATION = 34, + ARP_CACHE_TIMEOUT = 35, + ETHERNET_ENCAPSULATION = 36, + + /* TCP Parameters */ + + TCP_DEFAULT_TTL = 37, + TCP_KEEPALIVE_INTERVAL = 38, + TCP_KEEPALIVE_GARBAGE = 39, + + /* Application and Service Parameters */ + + NETWORK_INFORMATION_SERVICE_DOMAIN = 40, + NETWORK_INFORMATION_SERVERS = 41, + NETWORK_TIME_PROTOCOL_SERVERS = 42, + VENDOR_SPECIFIC_INFORMATION = 43, + NETBIOS_OVER_TCP_IP_NAME_SERVER = 44, + NETBIOS_OVER_TCP_IP_DATAGRAM_DISTRIBUTION_SERVER = 45, + NETBIOS_OVER_TCP_IP_NODE_TYPE = 46, + NETBIOS_OVER_TCP_IP_SCOPE = 47, + X_WINDOW_SYSTEM_FONT_SERVER = 48, + X_WINDOW_SYSTEM_DISPLAY_MANAGER = 49, + NETWORK_INFORMATION_SERVICE_PLUS_DOMAIN = 64, + NETWORK_INFORMATION_SERVICE_PLUS_SERVERS = 65, + MOBILE_IP_HOME_AGENT = 68, + SMTP_SERVER = 69, + POP3_SERVER = 70, + NNTP_SERVER = 71, + DEFAULT_WWW_SERVER = 72, + DEFAULT_FINGER_SERVER = 73, + DEFAULT_IRC_SERVER = 74, + STREETTALK_SERVER = 75, + STREETTALK_DIRECTORY_ASSISTANCE_SERVER = 76, + + /* DHCP Extensions */ + + REQUESTED_IP_ADDRESS = 50, + IP_ADDRESS_LEASE_TIME = 51, + OPTION_OVERLOAD = 52, + TFTP_SERVER_NAME = 66, + BOOTFILE_NAME = 67, + DHCP_MESSAGE_TYPE = 53, + SERVER_IDENTIFIER = 54, + PARAMETER_REQUEST_LIST = 55, + MESSAGE = 56, + MAXIMUM_DHCP_MESSAGE_SIZE = 57, + RENEWAL_T1_TIME_VALUE = 58, + REBINDING_T2_TIME_VALUE = 59, + VENDOR_CLASS_IDENTIFIER = 60, + CLIENT_IDENTIFIER = 61, + + USER_CLASS = 77, + FQDN = 81, + DHCP_AGENT_OPTIONS = 82, + NDS_SERVERS = 85, + NDS_TREE_NAME = 86, + NDS_CONTEXT = 87, + CLIENT_LAST_TRANSACTION_TIME = 91, + ASSOCIATED_IP = 92, + USER_AUTHENTICATION_PROTOCOL = 98, + AUTO_CONFIGURE = 116, + NAME_SERVICE_SEARCH = 117, + SUBNET_SELECTION = 118, + DOMAIN_SEARCH = 119, + CLASSLESS_ROUTE = 121, +} dhcp_msg_option; + +typedef struct dhcp_option +{ + uint8_t id; // option id + uint8_t len; // option length + uint8_t data[256]; // option data + + STAILQ_ENTRY(dhcp_option) pointers; // pointers, see queue(3) +} dhcp_option; + +typedef STAILQ_HEAD(dhcp_option_list_, dhcp_option) DHCP_OPTION_LIST; +typedef struct dhcp_option_list_ dhcp_option_list; + +/* + * Header to manage the database of address bindings. + */ + +// static association or dynamic +enum +{ + DYNAMIC = 0, + STATIC = 1, + STATIC_OR_DYNAMIC = 2 +}; + +// binding status +enum +{ + EMPTY = 0, + ASSOCIATED, + PENDINGD, + EXPIRED, + RELEASED +}; + +/* + * IP address used to delimitate an address pool. + */ +typedef struct pool_indexes +{ + uint32_t first; // first address of the pool + uint32_t last; // last address of the pool + uint32_t current; // current available address +}pool_indexes; + +/* + * The bindings are organized as a double linked list + * using the standard queue(3) library + */ +typedef struct address_binding +{ + uint32_t address; // address + uint8_t cident_len; // client identifier len + uint8_t cident[256]; // client identifier + + time_t binding_time; // time of binding + time_t lease_time; // duration of lease + + int status; // binding status + int is_static; // check if it is a static binding + + STAILQ_ENTRY(address_binding) pointers; // list pointers, see queue(3) +}address_binding; + +typedef STAILQ_HEAD(binding_list_, address_binding) BINDING_LIST_HEAD; +typedef struct binding_list_ binding_list; + +/* + * Global association pool. + * + * The (static or dynamic) associations tables of the DHCP server, + * are maintained in this global structure. + * + * Note: all the IP addresses are in host order, + * to allow an easy manipulation. + */ + +typedef struct address_pool +{ + uint32_t server_id; // this server id (IP address) + uint32_t netmask; // network mask + uint32_t gateway; // network gateway + + char device[16]; // network device to use + + pool_indexes indexes; // used to delimitate a pool of available addresses + + time_t lease_time; // default lease time + time_t pending_time; // duration of a binding in the pending state + struct udp_pcb *socket; // + bool flags; + + dhcp_option_list options; // options for this pool, see queue + + binding_list bindings; // associated addresses, see queue(3) +}address_pool; + +/* + * Internal representation of a DHCP message, + * with options parsed into a list... + */ +typedef struct dhcps_msg +{ + dhcp_message hdr; + dhcp_option_list opts; +} dhcps_msg; + +bool dhcps_option_set(u8_t opt_id, void* optarg); +void dhcps_start(struct netif *netif, struct dhcps_lease *lease_pool); +void dhcps_stop(struct netif *netif); +bool dhcps_lease_set(struct dhcps_lease *please); +bool dhcps_lease_get(struct dhcps_lease *please); + +#endif +#endif diff --git a/components/lwip/include/lwip/lwip/api.h b/components/lwip/include/lwip/lwip/api.h new file mode 100755 index 000000000..985eb76d4 --- /dev/null +++ b/components/lwip/include/lwip/lwip/api.h @@ -0,0 +1,368 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_API_H +#define LWIP_HDR_API_H + +#include "lwip/opt.h" + +#if LWIP_NETCONN || LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ +/* Note: Netconn API is always available when sockets are enabled - + * sockets are implemented on top of them */ + +#include /* for size_t */ + +#include "lwip/netbuf.h" +#include "lwip/sys.h" +#include "lwip/ip_addr.h" +#include "lwip/err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* Throughout this file, IP addresses and port numbers are expected to be in + * the same byte order as in the corresponding pcb. + */ + +/* Flags for netconn_write (u8_t) */ +#define NETCONN_NOFLAG 0x00 +#define NETCONN_NOCOPY 0x00 /* Only for source code compatibility */ +#define NETCONN_COPY 0x01 +#define NETCONN_MORE 0x02 +#define NETCONN_DONTBLOCK 0x04 + +/* Flags for struct netconn.flags (u8_t) */ +/** Should this netconn avoid blocking? */ +#define NETCONN_FLAG_NON_BLOCKING 0x02 +/** Was the last connect action a non-blocking one? */ +#define NETCONN_FLAG_IN_NONBLOCKING_CONNECT 0x04 +/** If this is set, a TCP netconn must call netconn_recved() to update + the TCP receive window (done automatically if not set). */ +#define NETCONN_FLAG_NO_AUTO_RECVED 0x08 +/** If a nonblocking write has been rejected before, poll_tcp needs to + check if the netconn is writable again */ +#define NETCONN_FLAG_CHECK_WRITESPACE 0x10 +#if LWIP_IPV6 +/** If this flag is set then only IPv6 communication is allowed on the + netconn. As per RFC#3493 this features defaults to OFF allowing + dual-stack usage by default. */ +#define NETCONN_FLAG_IPV6_V6ONLY 0x20 +#endif /* LWIP_IPV6 */ + + + /* Helpers to process several netconn_types by the same code */ +#define NETCONNTYPE_GROUP(t) ((t)&0xF0) +#define NETCONNTYPE_DATAGRAM(t) ((t)&0xE0) +#if LWIP_IPV6 +#define NETCONN_TYPE_IPV6 0x08 +#define NETCONNTYPE_ISIPV6(t) (((t)&NETCONN_TYPE_IPV6) != 0) +#define NETCONNTYPE_ISUDPLITE(t) (((t)&0xF3) == NETCONN_UDPLITE) +#define NETCONNTYPE_ISUDPNOCHKSUM(t) (((t)&0xF3) == NETCONN_UDPNOCHKSUM) +#else /* LWIP_IPV6 */ +#define NETCONNTYPE_ISUDPLITE(t) ((t) == NETCONN_UDPLITE) +#define NETCONNTYPE_ISUDPNOCHKSUM(t) ((t) == NETCONN_UDPNOCHKSUM) +#endif /* LWIP_IPV6 */ + +/** Protocol family and type of the netconn */ +enum netconn_type { + NETCONN_INVALID = 0, + /* NETCONN_TCP Group */ + NETCONN_TCP = 0x10, +#if LWIP_IPV6 + NETCONN_TCP_IPV6 = NETCONN_TCP | NETCONN_TYPE_IPV6 /* 0x18 */, +#endif /* LWIP_IPV6 */ + /* NETCONN_UDP Group */ + NETCONN_UDP = 0x20, + NETCONN_UDPLITE = 0x21, + NETCONN_UDPNOCHKSUM = 0x22, + +#if LWIP_IPV6 + NETCONN_UDP_IPV6 = NETCONN_UDP | NETCONN_TYPE_IPV6 /* 0x28 */, + NETCONN_UDPLITE_IPV6 = NETCONN_UDPLITE | NETCONN_TYPE_IPV6 /* 0x29 */, + NETCONN_UDPNOCHKSUM_IPV6 = NETCONN_UDPNOCHKSUM | NETCONN_TYPE_IPV6 /* 0x2a */, +#endif /* LWIP_IPV6 */ + + /* NETCONN_RAW Group */ + NETCONN_RAW = 0x40 +#if LWIP_IPV6 + , NETCONN_RAW_IPV6 = NETCONN_RAW | NETCONN_TYPE_IPV6 /* 0x48 */ +#endif /* LWIP_IPV6 */ +}; + +/** Current state of the netconn. Non-TCP netconns are always + * in state NETCONN_NONE! */ +enum netconn_state { + NETCONN_NONE, + NETCONN_WRITE, + NETCONN_LISTEN, + NETCONN_CONNECT, + NETCONN_CLOSE +}; + +/** Use to inform the callback function about changes */ +enum netconn_evt { + NETCONN_EVT_RCVPLUS, + NETCONN_EVT_RCVMINUS, + NETCONN_EVT_SENDPLUS, + NETCONN_EVT_SENDMINUS, + NETCONN_EVT_ERROR +}; + +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) +/** Used for netconn_join_leave_group() */ +enum netconn_igmp { + NETCONN_JOIN, + NETCONN_LEAVE +}; +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ + +#if LWIP_DNS +/* Used for netconn_gethostbyname_addrtype(), these should match the DNS_ADDRTYPE defines in dns.h */ +#define NETCONN_DNS_DEFAULT NETCONN_DNS_IPV4_IPV6 +#define NETCONN_DNS_IPV4 0 +#define NETCONN_DNS_IPV6 1 +#define NETCONN_DNS_IPV4_IPV6 2 /* try to resolve IPv4 first, try IPv6 if IPv4 fails only */ +#define NETCONN_DNS_IPV6_IPV4 3 /* try to resolve IPv6 first, try IPv4 if IPv6 fails only */ +#endif /* LWIP_DNS */ + +/* forward-declare some structs to avoid to include their headers */ +struct ip_pcb; +struct tcp_pcb; +struct udp_pcb; +struct raw_pcb; +struct netconn; +struct api_msg_msg; + +/** A callback prototype to inform about events for a netconn */ +typedef void (* netconn_callback)(struct netconn *, enum netconn_evt, u16_t len); + +/** A netconn descriptor */ +struct netconn { + /** type of the netconn (TCP, UDP or RAW) */ + enum netconn_type type; + /** current state of the netconn */ + enum netconn_state state; + /** the lwIP internal protocol control block */ + union { + struct ip_pcb *ip; + struct tcp_pcb *tcp; + struct udp_pcb *udp; + struct raw_pcb *raw; + } pcb; + /** the last error this netconn had */ + err_t last_err; + +#if !LWIP_NETCONN_SEM_PER_THREAD + /** sem that is used to synchronously execute functions in the core context */ + sys_sem_t op_completed; + +#ifdef LWIP_ESP8266 + sys_sem_t snd_op_completed; //only for snd semphore +#endif + +#endif + + /** mbox where received packets are stored until they are fetched + by the netconn application thread (can grow quite big) */ + sys_mbox_t recvmbox; +#if LWIP_TCP + /** mbox where new connections are stored until processed + by the application thread */ + sys_mbox_t acceptmbox; +#endif /* LWIP_TCP */ + /** only used for socket layer */ +#if LWIP_SOCKET + int socket; +#endif /* LWIP_SOCKET */ +#if LWIP_SO_SNDTIMEO + /** timeout to wait for sending data (which means enqueueing data for sending + in internal buffers) in milliseconds */ + s32_t send_timeout; +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVTIMEO + /** timeout in milliseconds to wait for new data to be received + (or connections to arrive for listening netconns) */ + int recv_timeout; +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVBUF + /** maximum amount of bytes queued in recvmbox + not used for TCP: adjust TCP_WND instead! */ + int recv_bufsize; + /** number of bytes currently in recvmbox to be received, + tested against recv_bufsize to limit bytes on recvmbox + for UDP and RAW, used for FIONREAD */ + int recv_avail; +#endif /* LWIP_SO_RCVBUF */ +#if LWIP_SO_LINGER + /** values <0 mean linger is disabled, values > 0 are seconds to linger */ + s16_t linger; +#endif /* LWIP_SO_LINGER */ + /** flags holding more netconn-internal state, see NETCONN_FLAG_* defines */ + u8_t flags; +#if LWIP_TCP + /** TCP: when data passed to netconn_write doesn't fit into the send buffer, + this temporarily stores how much is already sent. */ + size_t write_offset; + /** TCP: when data passed to netconn_write doesn't fit into the send buffer, + this temporarily stores the message. + Also used during connect and close. */ + struct api_msg_msg *current_msg; +#endif /* LWIP_TCP */ + /** A callback function that is informed about events for this netconn */ + netconn_callback callback; +}; + +/** Register an Network connection event */ +#define API_EVENT(c,e,l) if (c->callback) { \ + (*c->callback)(c, e, l); \ + } + +/** Set conn->last_err to err but don't overwrite fatal errors */ +#define NETCONN_SET_SAFE_ERR(conn, err) do { if ((conn) != NULL) { \ + SYS_ARCH_DECL_PROTECT(netconn_set_safe_err_lev); \ + SYS_ARCH_PROTECT(netconn_set_safe_err_lev); \ + if (!ERR_IS_FATAL((conn)->last_err)) { \ + (conn)->last_err = err; \ + } \ + SYS_ARCH_UNPROTECT(netconn_set_safe_err_lev); \ +}} while(0); + +/* Network connection functions: */ +#define netconn_new(t) netconn_new_with_proto_and_callback(t, 0, NULL) +#define netconn_new_with_callback(t, c) netconn_new_with_proto_and_callback(t, 0, c) +struct netconn *netconn_new_with_proto_and_callback(enum netconn_type t, u8_t proto, + netconn_callback callback); +err_t netconn_delete(struct netconn *conn); +/** Get the type of a netconn (as enum netconn_type). */ +#define netconn_type(conn) (conn->type) + +err_t netconn_getaddr(struct netconn *conn, ip_addr_t *addr, + u16_t *port, u8_t local); +#define netconn_peer(c,i,p) netconn_getaddr(c,i,p,0) +#define netconn_addr(c,i,p) netconn_getaddr(c,i,p,1) + +err_t netconn_bind(struct netconn *conn, const ip_addr_t *addr, u16_t port); +err_t netconn_connect(struct netconn *conn, const ip_addr_t *addr, u16_t port); +err_t netconn_disconnect (struct netconn *conn); +err_t netconn_listen_with_backlog(struct netconn *conn, u8_t backlog); +#define netconn_listen(conn) netconn_listen_with_backlog(conn, TCP_DEFAULT_LISTEN_BACKLOG) +err_t netconn_accept(struct netconn *conn, struct netconn **new_conn); +err_t netconn_recv(struct netconn *conn, struct netbuf **new_buf); +err_t netconn_recv_tcp_pbuf(struct netconn *conn, struct pbuf **new_buf); +void netconn_recved(struct netconn *conn, u32_t length); +err_t netconn_sendto(struct netconn *conn, struct netbuf *buf, + const ip_addr_t *addr, u16_t port); +err_t netconn_send(struct netconn *conn, struct netbuf *buf); +err_t netconn_write_partly(struct netconn *conn, const void *dataptr, size_t size, + u8_t apiflags, size_t *bytes_written); +#define netconn_write(conn, dataptr, size, apiflags) \ + netconn_write_partly(conn, dataptr, size, apiflags, NULL) +err_t netconn_close(struct netconn *conn); +err_t netconn_shutdown(struct netconn *conn, u8_t shut_rx, u8_t shut_tx); + +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) +err_t netconn_join_leave_group(struct netconn *conn, const ip_addr_t *multiaddr, + const ip_addr_t *netif_addr, enum netconn_igmp join_or_leave); +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ +#if LWIP_DNS +#if LWIP_IPV4 && LWIP_IPV6 +err_t netconn_gethostbyname_addrtype(const char *name, ip_addr_t *addr, u8_t dns_addrtype); +#define netconn_gethostbyname(name, addr) netconn_gethostbyname_addrtype(name, addr, NETCONN_DNS_DEFAULT) +#else /* LWIP_IPV4 && LWIP_IPV6 */ +err_t netconn_gethostbyname(const char *name, ip_addr_t *addr); +#define netconn_gethostbyname_addrtype(name, addr, dns_addrtype) netconn_gethostbyname(name, addr) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ +#endif /* LWIP_DNS */ + +#define netconn_err(conn) ((conn)->last_err) +#define netconn_recv_bufsize(conn) ((conn)->recv_bufsize) + +/** Set the blocking status of netconn calls (@todo: write/send is missing) */ +#define netconn_set_nonblocking(conn, val) do { if(val) { \ + (conn)->flags |= NETCONN_FLAG_NON_BLOCKING; \ +} else { \ + (conn)->flags &= ~ NETCONN_FLAG_NON_BLOCKING; }} while(0) +/** Get the blocking status of netconn calls (@todo: write/send is missing) */ +#define netconn_is_nonblocking(conn) (((conn)->flags & NETCONN_FLAG_NON_BLOCKING) != 0) + +/** TCP: Set the no-auto-recved status of netconn calls (see NETCONN_FLAG_NO_AUTO_RECVED) */ +#define netconn_set_noautorecved(conn, val) do { if(val) { \ + (conn)->flags |= NETCONN_FLAG_NO_AUTO_RECVED; \ +} else { \ + (conn)->flags &= ~ NETCONN_FLAG_NO_AUTO_RECVED; }} while(0) +/** TCP: Get the no-auto-recved status of netconn calls (see NETCONN_FLAG_NO_AUTO_RECVED) */ +#define netconn_get_noautorecved(conn) (((conn)->flags & NETCONN_FLAG_NO_AUTO_RECVED) != 0) + +#if LWIP_IPV6 +/** TCP: Set the IPv6 ONLY status of netconn calls (see NETCONN_FLAG_IPV6_V6ONLY) */ +#define netconn_set_ipv6only(conn, val) do { if(val) { \ + (conn)->flags |= NETCONN_FLAG_IPV6_V6ONLY; \ +} else { \ + (conn)->flags &= ~ NETCONN_FLAG_IPV6_V6ONLY; }} while(0) +/** TCP: Get the IPv6 ONLY status of netconn calls (see NETCONN_FLAG_IPV6_V6ONLY) */ +#define netconn_get_ipv6only(conn) (((conn)->flags & NETCONN_FLAG_IPV6_V6ONLY) != 0) +#endif /* LWIP_IPV6 */ + +#if LWIP_SO_SNDTIMEO +/** Set the send timeout in milliseconds */ +#define netconn_set_sendtimeout(conn, timeout) ((conn)->send_timeout = (timeout)) +/** Get the send timeout in milliseconds */ +#define netconn_get_sendtimeout(conn) ((conn)->send_timeout) +#endif /* LWIP_SO_SNDTIMEO */ +#if LWIP_SO_RCVTIMEO +/** Set the receive timeout in milliseconds */ +#define netconn_set_recvtimeout(conn, timeout) ((conn)->recv_timeout = (timeout)) +/** Get the receive timeout in milliseconds */ +#define netconn_get_recvtimeout(conn) ((conn)->recv_timeout) +#endif /* LWIP_SO_RCVTIMEO */ +#if LWIP_SO_RCVBUF +/** Set the receive buffer in bytes */ +#define netconn_set_recvbufsize(conn, recvbufsize) ((conn)->recv_bufsize = (recvbufsize)) +/** Get the receive buffer in bytes */ +#define netconn_get_recvbufsize(conn) ((conn)->recv_bufsize) +#endif /* LWIP_SO_RCVBUF*/ + +#if LWIP_NETCONN_SEM_PER_THREAD +void netconn_thread_init(void); +void netconn_thread_cleanup(void); +#else /* LWIP_NETCONN_SEM_PER_THREAD */ +#define netconn_thread_init() +#define netconn_thread_cleanup() +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_NETCONN || LWIP_SOCKET */ + +#endif /* LWIP_HDR_API_H */ diff --git a/components/lwip/include/lwip/lwip/arch.h b/components/lwip/include/lwip/lwip/arch.h new file mode 100755 index 000000000..7b99c2606 --- /dev/null +++ b/components/lwip/include/lwip/lwip/arch.h @@ -0,0 +1,233 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_ARCH_H +#define LWIP_HDR_ARCH_H + +#ifndef LITTLE_ENDIAN +#define LITTLE_ENDIAN 1234 +#endif + +#ifndef BIG_ENDIAN +#define BIG_ENDIAN 4321 +#endif + +#include "arch/cc.h" + +/** Temporary: define format string for size_t if not defined in cc.h */ +#ifndef SZT_F +#define SZT_F U32_F +#endif /* SZT_F */ +/** Temporary upgrade helper: define format string for u8_t as hex if not + defined in cc.h */ +#ifndef X8_F +#define X8_F "02x" +#endif /* X8_F */ + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef PACK_STRUCT_BEGIN +#define PACK_STRUCT_BEGIN +#endif /* PACK_STRUCT_BEGIN */ + +#ifndef PACK_STRUCT_END +#define PACK_STRUCT_END +#endif /* PACK_STRUCT_END */ + +#ifndef PACK_STRUCT_STRUCT +#define PACK_STRUCT_STRUCT +#endif /* PACK_STRUCT_STRUCT */ + +#ifndef PACK_STRUCT_FIELD +#define PACK_STRUCT_FIELD(x) x +#endif /* PACK_STRUCT_FIELD */ + +/* Used for struct fields of u8_t, + * where some compilers warn that packing is not necessary */ +#ifndef PACK_STRUCT_FLD_8 +#define PACK_STRUCT_FLD_8(x) PACK_STRUCT_FIELD(x) +#endif /* PACK_STRUCT_FLD_8 */ + +/* Used for struct fields of that are packed structs themself, + * where some compilers warn that packing is not necessary */ +#ifndef PACK_STRUCT_FLD_S +#define PACK_STRUCT_FLD_S(x) PACK_STRUCT_FIELD(x) +#endif /* PACK_STRUCT_FLD_S */ + + +#ifndef LWIP_UNUSED_ARG +#define LWIP_UNUSED_ARG(x) (void)x +#endif /* LWIP_UNUSED_ARG */ + + +#ifdef LWIP_PROVIDE_ERRNO + +#define EPERM 1 /* Operation not permitted */ +#define ENOENT 2 /* No such file or directory */ +#define ESRCH 3 /* No such process */ +#define EINTR 4 /* Interrupted system call */ +#define EIO 5 /* I/O error */ +#define ENXIO 6 /* No such device or address */ +#define E2BIG 7 /* Arg list too long */ +#define ENOEXEC 8 /* Exec format error */ +#define EBADF 9 /* Bad file number */ +#define ECHILD 10 /* No child processes */ +#define EAGAIN 11 /* Try again */ +#define ENOMEM 12 /* Out of memory */ +#define EACCES 13 /* Permission denied */ +#define EFAULT 14 /* Bad address */ +#define ENOTBLK 15 /* Block device required */ +#define EBUSY 16 /* Device or resource busy */ +#define EEXIST 17 /* File exists */ +#define EXDEV 18 /* Cross-device link */ +#define ENODEV 19 /* No such device */ +#define ENOTDIR 20 /* Not a directory */ +#define EISDIR 21 /* Is a directory */ +#define EINVAL 22 /* Invalid argument */ +#define ENFILE 23 /* File table overflow */ +#define EMFILE 24 /* Too many open files */ +#define ENOTTY 25 /* Not a typewriter */ +#define ETXTBSY 26 /* Text file busy */ +#define EFBIG 27 /* File too large */ +#define ENOSPC 28 /* No space left on device */ +#define ESPIPE 29 /* Illegal seek */ +#define EROFS 30 /* Read-only file system */ +#define EMLINK 31 /* Too many links */ +#define EPIPE 32 /* Broken pipe */ +#define EDOM 33 /* Math argument out of domain of func */ +#define ERANGE 34 /* Math result not representable */ +#define EDEADLK 35 /* Resource deadlock would occur */ +#define ENAMETOOLONG 36 /* File name too long */ +#define ENOLCK 37 /* No record locks available */ +#define ENOSYS 38 /* Function not implemented */ +#define ENOTEMPTY 39 /* Directory not empty */ +#define ELOOP 40 /* Too many symbolic links encountered */ +#define EWOULDBLOCK EAGAIN /* Operation would block */ +#define ENOMSG 42 /* No message of desired type */ +#define EIDRM 43 /* Identifier removed */ +#define ECHRNG 44 /* Channel number out of range */ +#define EL2NSYNC 45 /* Level 2 not synchronized */ +#define EL3HLT 46 /* Level 3 halted */ +#define EL3RST 47 /* Level 3 reset */ +#define ELNRNG 48 /* Link number out of range */ +#define EUNATCH 49 /* Protocol driver not attached */ +#define ENOCSI 50 /* No CSI structure available */ +#define EL2HLT 51 /* Level 2 halted */ +#define EBADE 52 /* Invalid exchange */ +#define EBADR 53 /* Invalid request descriptor */ +#define EXFULL 54 /* Exchange full */ +#define ENOANO 55 /* No anode */ +#define EBADRQC 56 /* Invalid request code */ +#define EBADSLT 57 /* Invalid slot */ + +#define EDEADLOCK EDEADLK + +#define EBFONT 59 /* Bad font file format */ +#define ENOSTR 60 /* Device not a stream */ +#define ENODATA 61 /* No data available */ +#define ETIME 62 /* Timer expired */ +#define ENOSR 63 /* Out of streams resources */ +#define ENONET 64 /* Machine is not on the network */ +#define ENOPKG 65 /* Package not installed */ +#define EREMOTE 66 /* Object is remote */ +#define ENOLINK 67 /* Link has been severed */ +#define EADV 68 /* Advertise error */ +#define ESRMNT 69 /* Srmount error */ +#define ECOMM 70 /* Communication error on send */ +#define EPROTO 71 /* Protocol error */ +#define EMULTIHOP 72 /* Multihop attempted */ +#define EDOTDOT 73 /* RFS specific error */ +#define EBADMSG 74 /* Not a data message */ +#define EOVERFLOW 75 /* Value too large for defined data type */ +#define ENOTUNIQ 76 /* Name not unique on network */ +#define EBADFD 77 /* File descriptor in bad state */ +#define EREMCHG 78 /* Remote address changed */ +#define ELIBACC 79 /* Can not access a needed shared library */ +#define ELIBBAD 80 /* Accessing a corrupted shared library */ +#define ELIBSCN 81 /* .lib section in a.out corrupted */ +#define ELIBMAX 82 /* Attempting to link in too many shared libraries */ +#define ELIBEXEC 83 /* Cannot exec a shared library directly */ +#define EILSEQ 84 /* Illegal byte sequence */ +#define ERESTART 85 /* Interrupted system call should be restarted */ +#define ESTRPIPE 86 /* Streams pipe error */ +#define EUSERS 87 /* Too many users */ +#define ENOTSOCK 88 /* Socket operation on non-socket */ +#define EDESTADDRREQ 89 /* Destination address required */ +#define EMSGSIZE 90 /* Message too long */ +#define EPROTOTYPE 91 /* Protocol wrong type for socket */ +#define ENOPROTOOPT 92 /* Protocol not available */ +#define EPROTONOSUPPORT 93 /* Protocol not supported */ +#define ESOCKTNOSUPPORT 94 /* Socket type not supported */ +#define EOPNOTSUPP 95 /* Operation not supported on transport endpoint */ +#define EPFNOSUPPORT 96 /* Protocol family not supported */ +#define EAFNOSUPPORT 97 /* Address family not supported by protocol */ +#define EADDRINUSE 98 /* Address already in use */ +#define EADDRNOTAVAIL 99 /* Cannot assign requested address */ +#define ENETDOWN 100 /* Network is down */ +#define ENETUNREACH 101 /* Network is unreachable */ +#define ENETRESET 102 /* Network dropped connection because of reset */ +#define ECONNABORTED 103 /* Software caused connection abort */ +#define ECONNRESET 104 /* Connection reset by peer */ +#define ENOBUFS 105 /* No buffer space available */ +#define EISCONN 106 /* Transport endpoint is already connected */ +#define ENOTCONN 107 /* Transport endpoint is not connected */ +#define ESHUTDOWN 108 /* Cannot send after transport endpoint shutdown */ +#define ETOOMANYREFS 109 /* Too many references: cannot splice */ +#define ETIMEDOUT 110 /* Connection timed out */ +#define ECONNREFUSED 111 /* Connection refused */ +#define EHOSTDOWN 112 /* Host is down */ +#define EHOSTUNREACH 113 /* No route to host */ +#define EALREADY 114 /* Operation already in progress */ +#define EINPROGRESS 115 /* Operation now in progress */ +#define ESTALE 116 /* Stale NFS file handle */ +#define EUCLEAN 117 /* Structure needs cleaning */ +#define ENOTNAM 118 /* Not a XENIX named type file */ +#define ENAVAIL 119 /* No XENIX semaphores available */ +#define EISNAM 120 /* Is a named type file */ +#define EREMOTEIO 121 /* Remote I/O error */ +#define EDQUOT 122 /* Quota exceeded */ + +#define ENOMEDIUM 123 /* No medium found */ +#define EMEDIUMTYPE 124 /* Wrong medium type */ + +#ifndef errno +extern int errno; +#endif + +#endif /* LWIP_PROVIDE_ERRNO */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_ARCH_H */ diff --git a/components/lwip/include/lwip/lwip/autoip.h b/components/lwip/include/lwip/lwip/autoip.h new file mode 100755 index 000000000..c89fe3ff1 --- /dev/null +++ b/components/lwip/include/lwip/lwip/autoip.h @@ -0,0 +1,124 @@ +/** + * @file + * + * AutoIP Automatic LinkLocal IP Configuration + */ + +/* + * + * Copyright (c) 2007 Dominik Spies + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * Author: Dominik Spies + * + * This is a AutoIP implementation for the lwIP TCP/IP stack. It aims to conform + * with RFC 3927. + * + * + * Please coordinate changes and requests with Dominik Spies + * + */ + +#ifndef LWIP_HDR_AUTOIP_H +#define LWIP_HDR_AUTOIP_H + +#include "lwip/opt.h" + +#if LWIP_IPV4 && LWIP_AUTOIP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/netif.h" +/* #include "lwip/udp.h" */ +#include "netif/etharp.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* AutoIP Timing */ +#define AUTOIP_TMR_INTERVAL 100 +#define AUTOIP_TICKS_PER_SECOND (1000 / AUTOIP_TMR_INTERVAL) + +/* RFC 3927 Constants */ +#define PROBE_WAIT 1 /* second (initial random delay) */ +#define PROBE_MIN 1 /* second (minimum delay till repeated probe) */ +#define PROBE_MAX 2 /* seconds (maximum delay till repeated probe) */ +#define PROBE_NUM 3 /* (number of probe packets) */ +#define ANNOUNCE_NUM 2 /* (number of announcement packets) */ +#define ANNOUNCE_INTERVAL 2 /* seconds (time between announcement packets) */ +#define ANNOUNCE_WAIT 2 /* seconds (delay before announcing) */ +#define MAX_CONFLICTS 10 /* (max conflicts before rate limiting) */ +#define RATE_LIMIT_INTERVAL 60 /* seconds (delay between successive attempts) */ +#define DEFEND_INTERVAL 10 /* seconds (min. wait between defensive ARPs) */ + +/* AutoIP client states */ +#define AUTOIP_STATE_OFF 0 +#define AUTOIP_STATE_PROBING 1 +#define AUTOIP_STATE_ANNOUNCING 2 +#define AUTOIP_STATE_BOUND 3 + +struct autoip +{ + ip4_addr_t llipaddr; /* the currently selected, probed, announced or used LL IP-Address */ + u8_t state; /* current AutoIP state machine state */ + u8_t sent_num; /* sent number of probes or announces, dependent on state */ + u16_t ttw; /* ticks to wait, tick is AUTOIP_TMR_INTERVAL long */ + u8_t lastconflict; /* ticks until a conflict can be solved by defending */ + u8_t tried_llipaddr; /* total number of probed/used Link Local IP-Addresses */ +}; + + +#define autoip_init() /* Compatibility define, no init needed. */ + +/** Set a struct autoip allocated by the application to work with */ +void autoip_set_struct(struct netif *netif, struct autoip *autoip); + +/** Remove a struct autoip previously set to the netif using autoip_set_struct() */ +#define autoip_remove_struct(netif) do { (netif)->autoip = NULL; } while (0) + +/** Start AutoIP client */ +err_t autoip_start(struct netif *netif); + +/** Stop AutoIP client */ +err_t autoip_stop(struct netif *netif); + +/** Handles every incoming ARP Packet, called by etharp_arp_input */ +void autoip_arp_reply(struct netif *netif, struct etharp_hdr *hdr); + +/** Has to be called in loop every AUTOIP_TMR_INTERVAL milliseconds */ +void autoip_tmr(void); + +/** Handle a possible change in the network configuration */ +void autoip_network_changed(struct netif *netif); + +/** check if AutoIP supplied netif->ip_addr */ +u8_t autoip_supplied_address(struct netif *netif); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV4 && LWIP_AUTOIP */ + +#endif /* LWIP_HDR_AUTOIP_H */ diff --git a/components/lwip/include/lwip/lwip/debug.h b/components/lwip/include/lwip/lwip/debug.h new file mode 100755 index 000000000..973a633d9 --- /dev/null +++ b/components/lwip/include/lwip/lwip/debug.h @@ -0,0 +1,117 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_DEBUG_H +#define LWIP_HDR_DEBUG_H + +#include "lwip/arch.h" +#include "lwip/opt.h" + +/** lower two bits indicate debug level + * - 0 all + * - 1 warning + * - 2 serious + * - 3 severe + */ +#define LWIP_DBG_LEVEL_ALL 0x00 +#define LWIP_DBG_LEVEL_OFF LWIP_DBG_LEVEL_ALL /* compatibility define only */ +#define LWIP_DBG_LEVEL_WARNING 0x01 /* bad checksums, dropped packets, ... */ +#define LWIP_DBG_LEVEL_SERIOUS 0x02 /* memory allocation failures, ... */ +#define LWIP_DBG_LEVEL_SEVERE 0x03 +#define LWIP_DBG_MASK_LEVEL 0x03 + +/** flag for LWIP_DEBUGF to enable that debug message */ +#define LWIP_DBG_ON 0x80U +/** flag for LWIP_DEBUGF to disable that debug message */ +#define LWIP_DBG_OFF 0x00U + +/** flag for LWIP_DEBUGF indicating a tracing message (to follow program flow) */ +#define LWIP_DBG_TRACE 0x40U +/** flag for LWIP_DEBUGF indicating a state debug message (to follow module states) */ +#define LWIP_DBG_STATE 0x20U +/** flag for LWIP_DEBUGF indicating newly added code, not thoroughly tested yet */ +#define LWIP_DBG_FRESH 0x10U +/** flag for LWIP_DEBUGF to halt after printing this debug message */ +#define LWIP_DBG_HALT 0x08U + +/** + * LWIP_NOASSERT: Disable LWIP_ASSERT checks. + * -- To disable assertions define LWIP_NOASSERT in arch/cc.h. + */ +#ifndef LWIP_NOASSERT +#define LWIP_ASSERT(message, assertion) do { if(!(assertion)) \ + LWIP_PLATFORM_ASSERT(message); } while(0) +#ifndef LWIP_PLATFORM_ASSERT +#error "If you want to use LWIP_ASSERT, LWIP_PLATFORM_ASSERT(message) needs to be defined in your arch/cc.h" +#endif +#else /* LWIP_NOASSERT */ +#define LWIP_ASSERT(message, assertion) +#endif /* LWIP_NOASSERT */ + +/** if "expression" isn't true, then print "message" and execute "handler" expression */ +#ifndef LWIP_ERROR +#ifndef LWIP_NOASSERT +#define LWIP_PLATFORM_ERROR(message) LWIP_PLATFORM_ASSERT(message) +#elif defined LWIP_DEBUG +#define LWIP_PLATFORM_ERROR(message) LWIP_PLATFORM_DIAG((message)) +#else +#define LWIP_PLATFORM_ERROR(message) +#endif + +#define LWIP_ERROR(message, expression, handler) do { if (!(expression)) { \ + LWIP_PLATFORM_ERROR(message); handler;}} while(0) +#endif /* LWIP_ERROR */ + +#ifdef LWIP_DEBUG +#ifndef LWIP_PLATFORM_DIAG +#error "If you want to use LWIP_DEBUG, LWIP_PLATFORM_DIAG(message) needs to be defined in your arch/cc.h" +#endif +/** print debug message only if debug message type is enabled... + * AND is of correct type AND is at least LWIP_DBG_LEVEL + */ +#define LWIP_DEBUGF(debug, message) do { \ + if ( \ + ((debug) & LWIP_DBG_ON) && \ + ((debug) & LWIP_DBG_TYPES_ON) && \ + ((s16_t)((debug) & LWIP_DBG_MASK_LEVEL) >= LWIP_DBG_MIN_LEVEL)) { \ + LWIP_PLATFORM_DIAG(message); \ + if ((debug) & LWIP_DBG_HALT) { \ + while(1); \ + } \ + } \ + } while(0) + +#else /* LWIP_DEBUG */ +#define LWIP_DEBUGF(debug, message) +#endif /* LWIP_DEBUG */ + +#endif /* LWIP_HDR_DEBUG_H */ + diff --git a/components/lwip/include/lwip/lwip/def.h b/components/lwip/include/lwip/lwip/def.h new file mode 100755 index 000000000..49571363c --- /dev/null +++ b/components/lwip/include/lwip/lwip/def.h @@ -0,0 +1,132 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_DEF_H +#define LWIP_HDR_DEF_H + +/* arch.h might define NULL already */ +#include "lwip/arch.h" +#include "lwip/opt.h" +#if LWIP_PERF +#include "arch/perf.h" +#else /* LWIP_PERF */ +#define PERF_START /* null definition */ +#define PERF_STOP(x) /* null definition */ +#endif /* LWIP_PERF */ + +#ifdef __cplusplus +extern "C" { +#endif + +#define LWIP_MAX(x , y) (((x) > (y)) ? (x) : (y)) +#define LWIP_MIN(x , y) (((x) < (y)) ? (x) : (y)) + +/* Get the number of entries in an array ('x' must NOT be a pointer!) */ +#define LWIP_ARRAYSIZE(x) (sizeof(x)/sizeof((x)[0])) + +#ifndef NULL +#define NULL ((void *)0) +#endif + +/* Endianess-optimized shifting of two u8_t to create one u16_t */ +#if BYTE_ORDER == LITTLE_ENDIAN +#define LWIP_MAKE_U16(a, b) ((a << 8) | b) +#else +#define LWIP_MAKE_U16(a, b) ((b << 8) | a) +#endif + +#ifndef LWIP_PLATFORM_BYTESWAP +#define LWIP_PLATFORM_BYTESWAP 0 +#endif + +#ifndef LWIP_PREFIX_BYTEORDER_FUNCS +/* workaround for naming collisions on some platforms */ + +#ifdef htons +#undef htons +#endif /* htons */ +#ifdef htonl +#undef htonl +#endif /* htonl */ +#ifdef ntohs +#undef ntohs +#endif /* ntohs */ +#ifdef ntohl +#undef ntohl +#endif /* ntohl */ + +#define htons(x) lwip_htons(x) +#define ntohs(x) lwip_ntohs(x) +#define htonl(x) lwip_htonl(x) +#define ntohl(x) lwip_ntohl(x) +#endif /* LWIP_PREFIX_BYTEORDER_FUNCS */ + +#if BYTE_ORDER == BIG_ENDIAN +#define lwip_htons(x) (x) +#define lwip_ntohs(x) (x) +#define lwip_htonl(x) (x) +#define lwip_ntohl(x) (x) +#define PP_HTONS(x) (x) +#define PP_NTOHS(x) (x) +#define PP_HTONL(x) (x) +#define PP_NTOHL(x) (x) +#else /* BYTE_ORDER != BIG_ENDIAN */ +#if LWIP_PLATFORM_BYTESWAP +#define lwip_htons(x) LWIP_PLATFORM_HTONS(x) +#define lwip_ntohs(x) LWIP_PLATFORM_HTONS(x) +#define lwip_htonl(x) LWIP_PLATFORM_HTONL(x) +#define lwip_ntohl(x) LWIP_PLATFORM_HTONL(x) +#else /* LWIP_PLATFORM_BYTESWAP */ +u16_t lwip_htons(u16_t x); +u16_t lwip_ntohs(u16_t x); +u32_t lwip_htonl(u32_t x); +u32_t lwip_ntohl(u32_t x); +#endif /* LWIP_PLATFORM_BYTESWAP */ + +/* These macros should be calculated by the preprocessor and are used + with compile-time constants only (so that there is no little-endian + overhead at runtime). */ +#define PP_HTONS(x) ((((x) & 0xff) << 8) | (((x) & 0xff00) >> 8)) +#define PP_NTOHS(x) PP_HTONS(x) +#define PP_HTONL(x) ((((x) & 0xff) << 24) | \ + (((x) & 0xff00) << 8) | \ + (((x) & 0xff0000UL) >> 8) | \ + (((x) & 0xff000000UL) >> 24)) +#define PP_NTOHL(x) PP_HTONL(x) + +#endif /* BYTE_ORDER == BIG_ENDIAN */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_DEF_H */ + diff --git a/components/lwip/include/lwip/lwip/dhcp.h b/components/lwip/include/lwip/lwip/dhcp.h new file mode 100755 index 000000000..57b635957 --- /dev/null +++ b/components/lwip/include/lwip/lwip/dhcp.h @@ -0,0 +1,298 @@ +/* + * Copyright (c) 2001-2004 Leon Woestenberg + * Copyright (c) 2001-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Leon Woestenberg + * + */ +#ifndef LWIP_HDR_DHCP_H +#define LWIP_HDR_DHCP_H + +#include "lwip/opt.h" + +#if LWIP_DHCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/netif.h" +#include "lwip/udp.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** period (in seconds) of the application calling dhcp_coarse_tmr() */ +#define DHCP_COARSE_TIMER_SECS 60 +/** period (in milliseconds) of the application calling dhcp_coarse_tmr() */ +#define DHCP_COARSE_TIMER_MSECS (DHCP_COARSE_TIMER_SECS * 1000UL) +/** period (in milliseconds) of the application calling dhcp_fine_tmr() */ +#define DHCP_FINE_TIMER_MSECS 500 + +#define DHCP_CHADDR_LEN 16U +#define DHCP_SNAME_LEN 64U +#define DHCP_FILE_LEN 128U + +struct dhcp +{ + /** transaction identifier of last sent request */ + u32_t xid; + /** incoming msg */ + struct dhcp_msg *msg_in; + /** track PCB allocation state */ + u8_t pcb_allocated; + /** current DHCP state machine state */ + u8_t state; + /** retries of current request */ + u8_t tries; +#if LWIP_DHCP_AUTOIP_COOP + u8_t autoip_coop_state; +#endif + u8_t subnet_mask_given; + + struct pbuf *p_out; /* pbuf of outcoming msg */ + struct dhcp_msg *msg_out; /* outgoing msg */ + u16_t options_out_len; /* outgoing msg options length */ + u16_t request_timeout; /* #ticks with period DHCP_FINE_TIMER_SECS for request timeout */ + u16_t t1_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for renewal time */ + u16_t t2_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for rebind time */ + u16_t t1_renew_time; /* #ticks with period DHCP_COARSE_TIMER_SECS until next renew try */ + u16_t t2_rebind_time; /* #ticks with period DHCP_COARSE_TIMER_SECS until next rebind try */ + u16_t lease_used; /* #ticks with period DHCP_COARSE_TIMER_SECS since last received DHCP ack */ + u16_t t0_timeout; /* #ticks with period DHCP_COARSE_TIMER_SECS for lease time */ + ip_addr_t server_ip_addr; /* dhcp server address that offered this lease (ip_addr_t because passed to UDP) */ + ip4_addr_t offered_ip_addr; + ip4_addr_t offered_sn_mask; + ip4_addr_t offered_gw_addr; + + u32_t offered_t0_lease; /* lease period (in seconds) */ + u32_t offered_t1_renew; /* recommended renew time (usually 50% of lease period) */ + u32_t offered_t2_rebind; /* recommended rebind time (usually 87.5 of lease period) */ +#if LWIP_DHCP_BOOTP_FILE + ip_addr_t offered_si_addr; + char boot_file_name[DHCP_FILE_LEN]; +#endif /* LWIP_DHCP_BOOTPFILE */ +}; + +/* MUST be compiled with "pack structs" or equivalent! */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +/** minimum set of fields of any DHCP message */ +struct dhcp_msg +{ + PACK_STRUCT_FLD_8(u8_t op); + PACK_STRUCT_FLD_8(u8_t htype); + PACK_STRUCT_FLD_8(u8_t hlen); + PACK_STRUCT_FLD_8(u8_t hops); + PACK_STRUCT_FIELD(u32_t xid); + PACK_STRUCT_FIELD(u16_t secs); + PACK_STRUCT_FIELD(u16_t flags); + PACK_STRUCT_FLD_S(ip4_addr_p_t ciaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t yiaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t siaddr); + PACK_STRUCT_FLD_S(ip4_addr_p_t giaddr); + PACK_STRUCT_FLD_8(u8_t chaddr[DHCP_CHADDR_LEN]); + PACK_STRUCT_FLD_8(u8_t sname[DHCP_SNAME_LEN]); + PACK_STRUCT_FLD_8(u8_t file[DHCP_FILE_LEN]); + PACK_STRUCT_FIELD(u32_t cookie); +#define DHCP_MIN_OPTIONS_LEN 68U +/** make sure user does not configure this too small */ +#if ((defined(DHCP_OPTIONS_LEN)) && (DHCP_OPTIONS_LEN < DHCP_MIN_OPTIONS_LEN)) +# undef DHCP_OPTIONS_LEN +#endif +/** allow this to be configured in lwipopts.h, but not too small */ +#if (!defined(DHCP_OPTIONS_LEN)) +/** set this to be sufficient for your options in outgoing DHCP msgs */ +# define DHCP_OPTIONS_LEN DHCP_MIN_OPTIONS_LEN +#endif + PACK_STRUCT_FLD_8(u8_t options[DHCP_OPTIONS_LEN]); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +void dhcp_set_struct(struct netif *netif, struct dhcp *dhcp); +/** Remove a struct dhcp previously set to the netif using dhcp_set_struct() */ +#define dhcp_remove_struct(netif) do { (netif)->dhcp = NULL; } while(0) +void dhcp_cleanup(struct netif *netif); +/** start DHCP configuration */ +err_t dhcp_start(struct netif *netif); +/** enforce early lease renewal (not needed normally)*/ +err_t dhcp_renew(struct netif *netif); +/** release the DHCP lease, usually called before dhcp_stop()*/ +err_t dhcp_release(struct netif *netif); +/** stop DHCP configuration */ +void dhcp_stop(struct netif *netif); +/** inform server of our manual IP address */ +void dhcp_inform(struct netif *netif); +/** Handle a possible change in the network configuration */ +void dhcp_network_changed(struct netif *netif); + +/** if enabled, check whether the offered IP address is not in use, using ARP */ +#if DHCP_DOES_ARP_CHECK +void dhcp_arp_reply(struct netif *netif, const ip4_addr_t *addr); +#endif + +/** check if DHCP supplied netif->ip_addr */ +u8_t dhcp_supplied_address(struct netif *netif); + +/** to be called every minute */ +void dhcp_coarse_tmr(void); +/** to be called every half second */ +void dhcp_fine_tmr(void); + +/** DHCP message item offsets and length */ +#define DHCP_OP_OFS 0 +#define DHCP_HTYPE_OFS 1 +#define DHCP_HLEN_OFS 2 +#define DHCP_HOPS_OFS 3 +#define DHCP_XID_OFS 4 +#define DHCP_SECS_OFS 8 +#define DHCP_FLAGS_OFS 10 +#define DHCP_CIADDR_OFS 12 +#define DHCP_YIADDR_OFS 16 +#define DHCP_SIADDR_OFS 20 +#define DHCP_GIADDR_OFS 24 +#define DHCP_CHADDR_OFS 28 +#define DHCP_SNAME_OFS 44 +#define DHCP_FILE_OFS 108 +#define DHCP_MSG_LEN 236 + +#define DHCP_COOKIE_OFS DHCP_MSG_LEN +#define DHCP_OPTIONS_OFS (DHCP_MSG_LEN + 4) + +#define DHCP_CLIENT_PORT 68 +#define DHCP_SERVER_PORT 67 + +/** DHCP client states */ +#define DHCP_STATE_OFF 0 +#define DHCP_STATE_REQUESTING 1 +#define DHCP_STATE_INIT 2 +#define DHCP_STATE_REBOOTING 3 +#define DHCP_STATE_REBINDING 4 +#define DHCP_STATE_RENEWING 5 +#define DHCP_STATE_SELECTING 6 +#define DHCP_STATE_INFORMING 7 +#define DHCP_STATE_CHECKING 8 +/** not yet implemented #define DHCP_STATE_PERMANENT 9 */ +#define DHCP_STATE_BOUND 10 +/** not yet implemented #define DHCP_STATE_RELEASING 11 */ +#define DHCP_STATE_BACKING_OFF 12 + +/** AUTOIP cooperation flags */ +#define DHCP_AUTOIP_COOP_STATE_OFF 0 +#define DHCP_AUTOIP_COOP_STATE_ON 1 + +#define DHCP_BOOTREQUEST 1 +#define DHCP_BOOTREPLY 2 + +/** DHCP message types */ +#define DHCP_DISCOVER 1 +#define DHCP_OFFER 2 +#define DHCP_REQUEST 3 +#define DHCP_DECLINE 4 +#define DHCP_ACK 5 +#define DHCP_NAK 6 +#define DHCP_RELEASE 7 +#define DHCP_INFORM 8 + +/** DHCP hardware type, currently only ethernet is supported */ +#define DHCP_HTYPE_ETH 1 + +#define DHCP_MAGIC_COOKIE 0x63825363UL + +/* This is a list of options for BOOTP and DHCP, see RFC 2132 for descriptions */ + +/** BootP options */ +#define DHCP_OPTION_PAD 0 +#define DHCP_OPTION_SUBNET_MASK 1 /* RFC 2132 3.3 */ +#define DHCP_OPTION_ROUTER 3 +#define DHCP_OPTION_DNS_SERVER 6 +#define DHCP_OPTION_HOSTNAME 12 +#define DHCP_OPTION_IP_TTL 23 +#define DHCP_OPTION_MTU 26 +#define DHCP_OPTION_BROADCAST 28 +#define DHCP_OPTION_TCP_TTL 37 +#define DHCP_OPTION_NTP 42 +#define DHCP_OPTION_END 255 + +#ifdef LWIP_ESP8266 +/**add options for support more router by liuHan**/ +#define DHCP_OPTION_DOMAIN_NAME 15 +#define DHCP_OPTION_PRD 31 +#define DHCP_OPTION_STATIC_ROUTER 33 +#define DHCP_OPTION_VSN 43 +#define DHCP_OPTION_NB_TINS 44 +#define DHCP_OPTION_NB_TINT 46 +#define DHCP_OPTION_NB_TIS 47 +#define DHCP_OPTION_CLASSLESS_STATIC_ROUTER 121 +#endif + + + +/** DHCP options */ +#define DHCP_OPTION_REQUESTED_IP 50 /* RFC 2132 9.1, requested IP address */ +#define DHCP_OPTION_LEASE_TIME 51 /* RFC 2132 9.2, time in seconds, in 4 bytes */ +#define DHCP_OPTION_OVERLOAD 52 /* RFC2132 9.3, use file and/or sname field for options */ + +#define DHCP_OPTION_MESSAGE_TYPE 53 /* RFC 2132 9.6, important for DHCP */ +#define DHCP_OPTION_MESSAGE_TYPE_LEN 1 + +#define DHCP_OPTION_SERVER_ID 54 /* RFC 2132 9.7, server IP address */ +#define DHCP_OPTION_PARAMETER_REQUEST_LIST 55 /* RFC 2132 9.8, requested option types */ + +#define DHCP_OPTION_MAX_MSG_SIZE 57 /* RFC 2132 9.10, message size accepted >= 576 */ +#define DHCP_OPTION_MAX_MSG_SIZE_LEN 2 + +#define DHCP_OPTION_T1 58 /* T1 renewal time */ +#define DHCP_OPTION_T2 59 /* T2 rebinding time */ +#define DHCP_OPTION_US 60 +#define DHCP_OPTION_CLIENT_ID 61 +#define DHCP_OPTION_TFTP_SERVERNAME 66 +#define DHCP_OPTION_BOOTFILE 67 + +/** possible combinations of overloading the file and sname fields with options */ +#define DHCP_OVERLOAD_NONE 0 +#define DHCP_OVERLOAD_FILE 1 +#define DHCP_OVERLOAD_SNAME 2 +#define DHCP_OVERLOAD_SNAME_FILE 3 + +#if LWIP_DHCP_GET_NTP_SRV +/** This function must exist, in other to add offered NTP servers to + * the NTP (or SNTP) engine. + * See LWIP_DHCP_MAX_NTP_SERVERS */ +extern void dhcp_set_ntp_servers(u8_t num_ntp_servers, const ip4_addr_t* ntp_server_addrs); +#endif /* LWIP_DHCP_GET_NTP_SRV */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_DHCP */ + +#endif /*LWIP_HDR_DHCP_H*/ diff --git a/components/lwip/include/lwip/lwip/dhcp6.h b/components/lwip/include/lwip/lwip/dhcp6.h new file mode 100755 index 000000000..345bcf00e --- /dev/null +++ b/components/lwip/include/lwip/lwip/dhcp6.h @@ -0,0 +1,58 @@ +/** + * @file + * + * IPv6 address autoconfiguration as per RFC 4862. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * IPv6 address autoconfiguration as per RFC 4862. + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_IP6_DHCP6_H +#define LWIP_HDR_IP6_DHCP6_H + +#include "lwip/opt.h" + +#if LWIP_IPV6_DHCP6 /* don't build if not configured for use in lwipopts.h */ + + +struct dhcp6 +{ + /*TODO: implement DHCP6*/ +}; + +#endif /* LWIP_IPV6_DHCP6 */ + +#endif /* LWIP_HDR_IP6_DHCP6_H */ diff --git a/components/lwip/include/lwip/lwip/dns.h b/components/lwip/include/lwip/lwip/dns.h new file mode 100755 index 000000000..1ceed0d88 --- /dev/null +++ b/components/lwip/include/lwip/lwip/dns.h @@ -0,0 +1,118 @@ +/** + * lwip DNS resolver header file. + + * Author: Jim Pettinato + * April 2007 + + * ported from uIP resolv.c Copyright (c) 2002-2003, Adam Dunkels. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote + * products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS + * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE + * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, + * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LWIP_HDR_DNS_H +#define LWIP_HDR_DNS_H + +#include "lwip/opt.h" + +#ifdef LWIP_ESP8266 +#include "lwip/err.h" +#endif + + +#if LWIP_DNS + +#include "lwip/ip_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** DNS timer period */ +#define DNS_TMR_INTERVAL 1000 + +/* DNS resolve types: */ +#define LWIP_DNS_ADDRTYPE_IPV4 0 +#define LWIP_DNS_ADDRTYPE_IPV6 1 +#define LWIP_DNS_ADDRTYPE_IPV4_IPV6 2 /* try to resolve IPv4 first, try IPv6 if IPv4 fails only */ +#define LWIP_DNS_ADDRTYPE_IPV6_IPV4 3 /* try to resolve IPv6 first, try IPv4 if IPv6 fails only */ +#if LWIP_IPV4 && LWIP_IPV6 +#ifndef LWIP_DNS_ADDRTYPE_DEFAULT +#define LWIP_DNS_ADDRTYPE_DEFAULT LWIP_DNS_ADDRTYPE_IPV4_IPV6 +#endif +#elif defined(LWIP_IPV4) +#define LWIP_DNS_ADDRTYPE_DEFAULT LWIP_DNS_ADDRTYPE_IPV4 +#else +#define LWIP_DNS_ADDRTYPE_DEFAULT LWIP_DNS_ADDRTYPE_IPV6 +#endif + +#if DNS_LOCAL_HOSTLIST +/** struct used for local host-list */ +struct local_hostlist_entry { + /** static hostname */ + const char *name; + /** static host address in network byteorder */ + ip_addr_t addr; + struct local_hostlist_entry *next; +}; +#if DNS_LOCAL_HOSTLIST_IS_DYNAMIC +#ifndef DNS_LOCAL_HOSTLIST_MAX_NAMELEN +#define DNS_LOCAL_HOSTLIST_MAX_NAMELEN DNS_MAX_NAME_LENGTH +#endif +#define LOCALHOSTLIST_ELEM_SIZE ((sizeof(struct local_hostlist_entry) + DNS_LOCAL_HOSTLIST_MAX_NAMELEN + 1)) +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ +#endif /* DNS_LOCAL_HOSTLIST */ + +/** Callback which is invoked when a hostname is found. + * A function of this type must be implemented by the application using the DNS resolver. + * @param name pointer to the name that was looked up. + * @param ipaddr pointer to an ip_addr_t containing the IP address of the hostname, + * or NULL if the name could not be found (or on any other error). + * @param callback_arg a user-specified callback argument passed to dns_gethostbyname +*/ +typedef void (*dns_found_callback)(const char *name, const ip_addr_t *ipaddr, void *callback_arg); + +void dns_init(void); +void dns_tmr(void); +void dns_setserver(u8_t numdns, const ip_addr_t *dnsserver); +ip_addr_t dns_getserver(u8_t numdns); +err_t dns_gethostbyname(const char *hostname, ip_addr_t *addr, + dns_found_callback found, void *callback_arg); +err_t dns_gethostbyname_addrtype(const char *hostname, ip_addr_t *addr, + dns_found_callback found, void *callback_arg, + u8_t dns_addrtype); + + +#if DNS_LOCAL_HOSTLIST && DNS_LOCAL_HOSTLIST_IS_DYNAMIC +int dns_local_removehost(const char *hostname, const ip_addr_t *addr); +err_t dns_local_addhost(const char *hostname, const ip_addr_t *addr); +#endif /* DNS_LOCAL_HOSTLIST && DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_DNS */ + +#endif /* LWIP_HDR_DNS_H */ diff --git a/components/lwip/include/lwip/lwip/err.h b/components/lwip/include/lwip/lwip/err.h new file mode 100755 index 000000000..26fb91db9 --- /dev/null +++ b/components/lwip/include/lwip/lwip/err.h @@ -0,0 +1,95 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_ERR_H +#define LWIP_HDR_ERR_H + +#include "lwip/opt.h" +#include "lwip/arch.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** Define LWIP_ERR_T in cc.h if you want to use + * a different type for your platform (must be signed). */ +#ifdef LWIP_ERR_T +typedef LWIP_ERR_T err_t; +#else /* LWIP_ERR_T */ +typedef s8_t err_t; +#endif /* LWIP_ERR_T*/ + +/* Definitions for error constants. */ + +#define ERR_OK 0 /* No error, everything OK. */ +#define ERR_MEM -1 /* Out of memory error. */ +#define ERR_BUF -2 /* Buffer error. */ +#define ERR_TIMEOUT -3 /* Timeout. */ +#define ERR_RTE -4 /* Routing problem. */ +#define ERR_INPROGRESS -5 /* Operation in progress */ +#define ERR_VAL -6 /* Illegal value. */ +#define ERR_WOULDBLOCK -7 /* Operation would block. */ +#define ERR_USE -8 /* Address in use. */ + + +#ifdef LWIP_ESP8266 +#define ERR_ALREADY -9 /* Already connected. */ +#define ERR_ISCONN -10 /* Conn already established.*/ +#define ERR_IS_FATAL(e) ((e) < ERR_ISCONN) +#define ERR_ABRT -11 /* Connection aborted. */ +#define ERR_RST -12 /* Connection reset. */ +#define ERR_CLSD -13 /* Connection closed. */ +#define ERR_CONN -14 /* Not connected. */ +#define ERR_ARG -15 /* Illegal argument. */ +#define ERR_IF -16 /* Low-level netif error */ +#else +#define ERR_ALREADY -9 /* Already connecting. */ +#define ERR_ISCONN -10 /* Conn already established.*/ +#define ERR_CONN -11 /* Not connected. */ +#define ERR_IF -12 /* Low-level netif error */ +#define ERR_IS_FATAL(e) ((e) <= ERR_ABRT) +#define ERR_ABRT -13 /* Connection aborted. */ +#define ERR_RST -14 /* Connection reset. */ +#define ERR_CLSD -15 /* Connection closed. */ +#define ERR_ARG -16 /* Illegal argument. */ +#endif + +#ifdef LWIP_DEBUG +extern const char *lwip_strerr(err_t err); +#else +#define lwip_strerr(x) "" +#endif /* LWIP_DEBUG */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_ERR_H */ diff --git a/components/lwip/include/lwip/lwip/ethip6.h b/components/lwip/include/lwip/lwip/ethip6.h new file mode 100755 index 000000000..5e88dffd0 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ethip6.h @@ -0,0 +1,68 @@ +/** + * @file + * + * Ethernet output for IPv6. Uses ND tables for link-layer addressing. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_ETHIP6_H +#define LWIP_HDR_ETHIP6_H + +#include "lwip/opt.h" + +#if LWIP_IPV6 && LWIP_ETHERNET /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/netif.h" + + +#ifdef __cplusplus +extern "C" { +#endif + + +err_t ethip6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6 && LWIP_ETHERNET */ + +#endif /* LWIP_HDR_ETHIP6_H */ diff --git a/components/lwip/include/lwip/lwip/icmp.h b/components/lwip/include/lwip/lwip/icmp.h new file mode 100755 index 000000000..af3a45508 --- /dev/null +++ b/components/lwip/include/lwip/lwip/icmp.h @@ -0,0 +1,137 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_ICMP_H +#define LWIP_HDR_ICMP_H + +#include "lwip/opt.h" +#include "lwip/pbuf.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" + +#if LWIP_IPV6 && LWIP_ICMP6 +#include "lwip/icmp6.h" +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#define ICMP_ER 0 /* echo reply */ +#define ICMP_DUR 3 /* destination unreachable */ +#define ICMP_SQ 4 /* source quench */ +#define ICMP_RD 5 /* redirect */ +#define ICMP_ECHO 8 /* echo */ +#define ICMP_TE 11 /* time exceeded */ +#define ICMP_PP 12 /* parameter problem */ +#define ICMP_TS 13 /* timestamp */ +#define ICMP_TSR 14 /* timestamp reply */ +#define ICMP_IRQ 15 /* information request */ +#define ICMP_IR 16 /* information reply */ +#define ICMP_AM 17 /* address mask request */ +#define ICMP_AMR 18 /* address mask reply */ + +enum icmp_dur_type { + ICMP_DUR_NET = 0, /* net unreachable */ + ICMP_DUR_HOST = 1, /* host unreachable */ + ICMP_DUR_PROTO = 2, /* protocol unreachable */ + ICMP_DUR_PORT = 3, /* port unreachable */ + ICMP_DUR_FRAG = 4, /* fragmentation needed and DF set */ + ICMP_DUR_SR = 5 /* source route failed */ +}; + +enum icmp_te_type { + ICMP_TE_TTL = 0, /* time to live exceeded in transit */ + ICMP_TE_FRAG = 1 /* fragment reassembly time exceeded */ +}; + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +/** This is the standard ICMP header only that the u32_t data + * is split to two u16_t like ICMP echo needs it. + * This header is also used for other ICMP types that do not + * use the data part. + */ +PACK_STRUCT_BEGIN +struct icmp_echo_hdr { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u16_t id); + PACK_STRUCT_FIELD(u16_t seqno); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define ICMPH_TYPE(hdr) ((hdr)->type) +#define ICMPH_CODE(hdr) ((hdr)->code) + +/** Combines type and code to an u16_t */ +#define ICMPH_TYPE_SET(hdr, t) ((hdr)->type = (t)) +#define ICMPH_CODE_SET(hdr, c) ((hdr)->code = (c)) + + +#if LWIP_IPV4 && LWIP_ICMP /* don't build if not configured for use in lwipopts.h */ + +void icmp_input(struct pbuf *p, struct netif *inp); +void icmp_dest_unreach(struct pbuf *p, enum icmp_dur_type t); +void icmp_time_exceeded(struct pbuf *p, enum icmp_te_type t); + +#endif /* LWIP_IPV4 && LWIP_ICMP */ + +#if LWIP_IPV4 && LWIP_IPV6 +#if LWIP_ICMP && LWIP_ICMP6 +#define icmp_port_unreach(isipv6, pbuf) ((isipv6) ? \ + icmp6_dest_unreach(pbuf, ICMP6_DUR_PORT) : \ + icmp_dest_unreach(pbuf, ICMP_DUR_PORT)) +#elif LWIP_ICMP +#define icmp_port_unreach(isipv6, pbuf) do{ if(!(isipv6)) { icmp_dest_unreach(pbuf, ICMP_DUR_PORT);}}while(0) +#elif LWIP_ICMP6 +#define icmp_port_unreach(isipv6, pbuf) do{ if(isipv6) { icmp6_dest_unreach(pbuf, ICMP6_DUR_PORT);}}while(0) +#else +#define icmp_port_unreach(isipv6, pbuf) +#endif +#elif LWIP_IPV6 && LWIP_ICMP6 +#define icmp_port_unreach(isipv6, pbuf) icmp6_dest_unreach(pbuf, ICMP6_DUR_PORT) +#elif LWIP_IPV4 && LWIP_ICMP +#define icmp_port_unreach(isipv6, pbuf) icmp_dest_unreach(pbuf, ICMP_DUR_PORT) +#else /* (LWIP_IPV6 && LWIP_ICMP6) || (LWIP_IPV4 && LWIP_ICMP) */ +#define icmp_port_unreach(isipv6, pbuf) +#endif /* (LWIP_IPV6 && LWIP_ICMP6) || (LWIP_IPV4 && LWIP_ICMP) LWIP_IPV4*/ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_ICMP_H */ diff --git a/components/lwip/include/lwip/lwip/icmp6.h b/components/lwip/include/lwip/lwip/icmp6.h new file mode 100755 index 000000000..9d57103fc --- /dev/null +++ b/components/lwip/include/lwip/lwip/icmp6.h @@ -0,0 +1,152 @@ +/** + * @file + * + * IPv6 version of ICMP, as per RFC 4443. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ +#ifndef LWIP_HDR_ICMP6_H +#define LWIP_HDR_ICMP6_H + +#include "lwip/opt.h" +#include "lwip/pbuf.h" +#include "lwip/ip6_addr.h" +#include "lwip/netif.h" + + +#ifdef __cplusplus +extern "C" { +#endif + +enum icmp6_type { + ICMP6_TYPE_DUR = 1, /* Destination unreachable */ + ICMP6_TYPE_PTB = 2, /* Packet too big */ + ICMP6_TYPE_TE = 3, /* Time exceeded */ + ICMP6_TYPE_PP = 4, /* Parameter problem */ + ICMP6_TYPE_PE1 = 100, /* Private experimentation */ + ICMP6_TYPE_PE2 = 101, /* Private experimentation */ + ICMP6_TYPE_RSV_ERR = 127, /* Reserved for expansion of error messages */ + + ICMP6_TYPE_EREQ = 128, /* Echo request */ + ICMP6_TYPE_EREP = 129, /* Echo reply */ + ICMP6_TYPE_MLQ = 130, /* Multicast listener query */ + ICMP6_TYPE_MLR = 131, /* Multicast listener report */ + ICMP6_TYPE_MLD = 132, /* Multicast listener done */ + ICMP6_TYPE_RS = 133, /* Router solicitation */ + ICMP6_TYPE_RA = 134, /* Router advertisement */ + ICMP6_TYPE_NS = 135, /* Neighbor solicitation */ + ICMP6_TYPE_NA = 136, /* Neighbor advertisement */ + ICMP6_TYPE_RD = 137, /* Redirect */ + ICMP6_TYPE_MRA = 151, /* Multicast router advertisement */ + ICMP6_TYPE_MRS = 152, /* Multicast router solicitation */ + ICMP6_TYPE_MRT = 153, /* Multicast router termination */ + ICMP6_TYPE_PE3 = 200, /* Private experimentation */ + ICMP6_TYPE_PE4 = 201, /* Private experimentation */ + ICMP6_TYPE_RSV_INF = 255 /* Reserved for expansion of informational messages */ +}; + +enum icmp6_dur_code { + ICMP6_DUR_NO_ROUTE = 0, /* No route to destination */ + ICMP6_DUR_PROHIBITED = 1, /* Communication with destination administratively prohibited */ + ICMP6_DUR_SCOPE = 2, /* Beyond scope of source address */ + ICMP6_DUR_ADDRESS = 3, /* Address unreachable */ + ICMP6_DUR_PORT = 4, /* Port unreachable */ + ICMP6_DUR_POLICY = 5, /* Source address failed ingress/egress policy */ + ICMP6_DUR_REJECT_ROUTE = 6 /* Reject route to destination */ +}; + +enum icmp6_te_code { + ICMP6_TE_HL = 0, /* Hop limit exceeded in transit */ + ICMP6_TE_FRAG = 1 /* Fragment reassembly time exceeded */ +}; + +enum icmp6_pp_code { + ICMP6_PP_FIELD = 0, /* Erroneous header field encountered */ + ICMP6_PP_HEADER = 1, /* Unrecognized next header type encountered */ + ICMP6_PP_OPTION = 2 /* Unrecognized IPv6 option encountered */ +}; + +/** This is the standard ICMP6 header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct icmp6_hdr { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u32_t data); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** This is the ICMP6 header adapted for echo req/resp. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct icmp6_echo_hdr { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u16_t id); + PACK_STRUCT_FIELD(u16_t seqno); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + + +#if LWIP_ICMP6 && LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +void icmp6_input(struct pbuf *p, struct netif *inp); +void icmp6_dest_unreach(struct pbuf *p, enum icmp6_dur_code c); +void icmp6_packet_too_big(struct pbuf *p, u32_t mtu); +void icmp6_time_exceeded(struct pbuf *p, enum icmp6_te_code c); +void icmp6_param_problem(struct pbuf *p, enum icmp6_pp_code c, u32_t pointer); + +#endif /* LWIP_ICMP6 && LWIP_IPV6 */ + + +#ifdef __cplusplus +} +#endif + + +#endif /* LWIP_HDR_ICMP6_H */ diff --git a/components/lwip/include/lwip/lwip/igmp.h b/components/lwip/include/lwip/lwip/igmp.h new file mode 100755 index 000000000..bff1a6135 --- /dev/null +++ b/components/lwip/include/lwip/lwip/igmp.h @@ -0,0 +1,108 @@ +/* + * Copyright (c) 2002 CITEL Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of CITEL Technologies Ltd nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY CITEL TECHNOLOGIES AND CONTRIBUTORS ``AS IS'' + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL CITEL TECHNOLOGIES OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is a contribution to the lwIP TCP/IP stack. + * The Swedish Institute of Computer Science and Adam Dunkels + * are specifically granted permission to redistribute this + * source code. +*/ + +#ifndef LWIP_HDR_IGMP_H +#define LWIP_HDR_IGMP_H + +#include "lwip/opt.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/pbuf.h" + +#if LWIP_IPV4 && LWIP_IGMP /* don't build if not configured for use in lwipopts.h */ + +#ifdef __cplusplus +extern "C" { +#endif + + +/* IGMP timer */ +#define IGMP_TMR_INTERVAL 100 /* Milliseconds */ +#define IGMP_V1_DELAYING_MEMBER_TMR (1000/IGMP_TMR_INTERVAL) +#define IGMP_JOIN_DELAYING_MEMBER_TMR (500 /IGMP_TMR_INTERVAL) + +/* MAC Filter Actions, these are passed to a netif's + * igmp_mac_filter callback function. */ +#define IGMP_DEL_MAC_FILTER 0 +#define IGMP_ADD_MAC_FILTER 1 + + +/** + * igmp group structure - there is + * a list of groups for each interface + * these should really be linked from the interface, but + * if we keep them separate we will not affect the lwip original code + * too much + * + * There will be a group for the all systems group address but this + * will not run the state machine as it is used to kick off reports + * from all the other groups + */ +struct igmp_group { + /** next link */ + struct igmp_group *next; + /** interface on which the group is active */ + struct netif *netif; + /** multicast address */ + ip4_addr_t group_address; + /** signifies we were the last person to report */ + u8_t last_reporter_flag; + /** current state of the group */ + u8_t group_state; + /** timer for reporting, negative is OFF */ + u16_t timer; + /** counter of simultaneous uses */ + u8_t use; +}; + +/* Prototypes */ +void igmp_init(void); +err_t igmp_start(struct netif *netif); +err_t igmp_stop(struct netif *netif); +void igmp_report_groups(struct netif *netif); +struct igmp_group *igmp_lookfor_group(struct netif *ifp, const ip4_addr_t *addr); +void igmp_input(struct pbuf *p, struct netif *inp, const ip4_addr_t *dest); +err_t igmp_joingroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr); +err_t igmp_joingroup_netif(struct netif *netif, const ip4_addr_t *groupaddr); +err_t igmp_leavegroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr); +err_t igmp_leavegroup_netif(struct netif *netif, const ip4_addr_t *groupaddr); +void igmp_tmr(void); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV4 && LWIP_IGMP */ + +#endif /* LWIP_HDR_IGMP_H */ diff --git a/components/lwip/include/lwip/lwip/inet.h b/components/lwip/include/lwip/lwip/inet.h new file mode 100755 index 000000000..036cd988d --- /dev/null +++ b/components/lwip/include/lwip/lwip/inet.h @@ -0,0 +1,172 @@ +/** + * @file + * This file (together with sockets.h) aims to provide structs and functions from + * - arpa/inet.h + * - netinet/in.h + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_INET_H +#define LWIP_HDR_INET_H + +#include "lwip/opt.h" +#include "lwip/def.h" +#include "lwip/ip_addr.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* If your port already typedef's in_addr_t, define IN_ADDR_T_DEFINED + to prevent this code from redefining it. */ +#if !defined(in_addr_t) && !defined(IN_ADDR_T_DEFINED) +typedef u32_t in_addr_t; +#endif + +struct in_addr { + in_addr_t s_addr; +}; + +struct in6_addr { + union { + u32_t u32_addr[4]; + u8_t u8_addr[16]; + } un; +#define s6_addr un.u8_addr +}; + +/** 255.255.255.255 */ +#define INADDR_NONE IPADDR_NONE +/** 127.0.0.1 */ +#define INADDR_LOOPBACK IPADDR_LOOPBACK +/** 0.0.0.0 */ +#define INADDR_ANY IPADDR_ANY +/** 255.255.255.255 */ +#define INADDR_BROADCAST IPADDR_BROADCAST + +/** This macro can be used to initialize a variable of type struct in6_addr + to the IPv6 wildcard address. */ +#define IN6ADDR_ANY_INIT {{{0,0,0,0}}} +/** This macro can be used to initialize a variable of type struct in6_addr + to the IPv6 loopback address. */ +#define IN6ADDR_LOOPBACK_INIT {{{0,0,0,PP_HTONL(1)}}} +/** This variable is initialized by the system to contain the wildcard IPv6 address. */ +extern const struct in6_addr in6addr_any; + +/* Definitions of the bits in an (IPv4) Internet address integer. + + On subnets, host and network parts are found according to + the subnet mask, not these masks. */ +#define IN_CLASSA(a) IP_CLASSA(a) +#define IN_CLASSA_NET IP_CLASSA_NET +#define IN_CLASSA_NSHIFT IP_CLASSA_NSHIFT +#define IN_CLASSA_HOST IP_CLASSA_HOST +#define IN_CLASSA_MAX IP_CLASSA_MAX + +#define IN_CLASSB(b) IP_CLASSB(b) +#define IN_CLASSB_NET IP_CLASSB_NET +#define IN_CLASSB_NSHIFT IP_CLASSB_NSHIFT +#define IN_CLASSB_HOST IP_CLASSB_HOST +#define IN_CLASSB_MAX IP_CLASSB_MAX + +#define IN_CLASSC(c) IP_CLASSC(c) +#define IN_CLASSC_NET IP_CLASSC_NET +#define IN_CLASSC_NSHIFT IP_CLASSC_NSHIFT +#define IN_CLASSC_HOST IP_CLASSC_HOST +#define IN_CLASSC_MAX IP_CLASSC_MAX + +#define IN_CLASSD(d) IP_CLASSD(d) +#define IN_CLASSD_NET IP_CLASSD_NET /* These ones aren't really */ +#define IN_CLASSD_NSHIFT IP_CLASSD_NSHIFT /* net and host fields, but */ +#define IN_CLASSD_HOST IP_CLASSD_HOST /* routing needn't know. */ +#define IN_CLASSD_MAX IP_CLASSD_MAX + +#define IN_MULTICAST(a) IP_MULTICAST(a) + +#define IN_EXPERIMENTAL(a) IP_EXPERIMENTAL(a) +#define IN_BADCLASS(a) IP_BADCLASS(a) + +#define IN_LOOPBACKNET IP_LOOPBACKNET + + +#ifndef INET_ADDRSTRLEN +#define INET_ADDRSTRLEN IP4ADDR_STRLEN_MAX +#endif +#if LWIP_IPV6 +#ifndef INET6_ADDRSTRLEN +#define INET6_ADDRSTRLEN IP6ADDR_STRLEN_MAX +#endif +#endif + +#if LWIP_IPV4 + +#define inet_addr_from_ipaddr(target_inaddr, source_ipaddr) ((target_inaddr)->s_addr = ip4_addr_get_u32(source_ipaddr)) +#define inet_addr_to_ipaddr(target_ipaddr, source_inaddr) (ip4_addr_set_u32(target_ipaddr, (source_inaddr)->s_addr)) +/* ATTENTION: the next define only works because both s_addr and ip_addr_t are an u32_t effectively! */ +#define inet_addr_to_ipaddr_p(target_ipaddr_p, source_inaddr) ((target_ipaddr_p) = (ip_addr_t*)&((source_inaddr)->s_addr)) + +/* directly map this to the lwip internal functions */ +#define inet_addr(cp) ipaddr_addr(cp) +#define inet_aton(cp, addr) ip4addr_aton(cp, (ip4_addr_t*)addr) +#define inet_ntoa(addr) ip4addr_ntoa((const ip4_addr_t*)&(addr)) +#define inet_ntoa_r(addr, buf, buflen) ip4addr_ntoa_r((const ip4_addr_t*)&(addr), buf, buflen) + +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +#define inet6_addr_from_ip6addr(target_in6addr, source_ip6addr) {(target_in6addr)->un.u32_addr[0] = (source_ip6addr)->addr[0]; \ + (target_in6addr)->un.u32_addr[1] = (source_ip6addr)->addr[1]; \ + (target_in6addr)->un.u32_addr[2] = (source_ip6addr)->addr[2]; \ + (target_in6addr)->un.u32_addr[3] = (source_ip6addr)->addr[3];} +#define inet6_addr_to_ip6addr(target_ip6addr, source_in6addr) {(target_ip6addr)->addr[0] = (source_in6addr)->un.u32_addr[0]; \ + (target_ip6addr)->addr[1] = (source_in6addr)->un.u32_addr[1]; \ + (target_ip6addr)->addr[2] = (source_in6addr)->un.u32_addr[2]; \ + (target_ip6addr)->addr[3] = (source_in6addr)->un.u32_addr[3];} +/* ATTENTION: the next define only works because both in6_addr and ip6_addr_t are an u32_t[4] effectively! */ +#define inet6_addr_to_ip6addr_p(target_ip6addr_p, source_in6addr) ((target_ip6addr_p) = (ip6_addr_t*)(source_in6addr)) + +/* directly map this to the lwip internal functions */ +#define inet6_aton(cp, addr) ip6addr_aton(cp, (ip6_addr_t*)addr) +#define inet6_ntoa(addr) ip6addr_ntoa((const ip6_addr_t*)&(addr)) +#define inet6_ntoa_r(addr, buf, buflen) ip6addr_ntoa_r((const ip6_addr_t*)&(addr), buf, buflen) + +#endif /* LWIP_IPV6 */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_INET_H */ diff --git a/components/lwip/include/lwip/lwip/inet_chksum.h b/components/lwip/include/lwip/lwip/inet_chksum.h new file mode 100755 index 000000000..1766f4b5d --- /dev/null +++ b/components/lwip/include/lwip/lwip/inet_chksum.h @@ -0,0 +1,106 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_INET_CHKSUM_H +#define LWIP_HDR_INET_CHKSUM_H + +#include "lwip/opt.h" + +#include "lwip/pbuf.h" +#include "lwip/ip_addr.h" + +/** Swap the bytes in an u16_t: much like htons() for little-endian */ +#ifndef SWAP_BYTES_IN_WORD +#if LWIP_PLATFORM_BYTESWAP && (BYTE_ORDER == LITTLE_ENDIAN) +/* little endian and PLATFORM_BYTESWAP defined */ +#define SWAP_BYTES_IN_WORD(w) LWIP_PLATFORM_HTONS(w) +#else /* LWIP_PLATFORM_BYTESWAP && (BYTE_ORDER == LITTLE_ENDIAN) */ +/* can't use htons on big endian (or PLATFORM_BYTESWAP not defined)... */ +#define SWAP_BYTES_IN_WORD(w) (((w) & 0xff) << 8) | (((w) & 0xff00) >> 8) +#endif /* LWIP_PLATFORM_BYTESWAP && (BYTE_ORDER == LITTLE_ENDIAN)*/ +#endif /* SWAP_BYTES_IN_WORD */ + +/** Split an u32_t in two u16_ts and add them up */ +#ifndef FOLD_U32T +#define FOLD_U32T(u) (((u) >> 16) + ((u) & 0x0000ffffUL)) +#endif + +#if LWIP_CHECKSUM_ON_COPY +/** Function-like macro: same as MEMCPY but returns the checksum of copied data + as u16_t */ +# ifndef LWIP_CHKSUM_COPY +# define LWIP_CHKSUM_COPY(dst, src, len) lwip_chksum_copy(dst, src, len) +# ifndef LWIP_CHKSUM_COPY_ALGORITHM +# define LWIP_CHKSUM_COPY_ALGORITHM 1 +# endif /* LWIP_CHKSUM_COPY_ALGORITHM */ +# else /* LWIP_CHKSUM_COPY */ +# define LWIP_CHKSUM_COPY_ALGORITHM 0 +# endif /* LWIP_CHKSUM_COPY */ +#else /* LWIP_CHECKSUM_ON_COPY */ +# define LWIP_CHKSUM_COPY_ALGORITHM 0 +#endif /* LWIP_CHECKSUM_ON_COPY */ + +#ifdef __cplusplus +extern "C" { +#endif + +u16_t inet_chksum(const void *dataptr, u16_t len); +u16_t inet_chksum_pbuf(struct pbuf *p); +#if LWIP_CHKSUM_COPY_ALGORITHM +u16_t lwip_chksum_copy(void *dst, const void *src, u16_t len); +#endif /* LWIP_CHKSUM_COPY_ALGORITHM */ + +#if LWIP_IPV4 +u16_t inet_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip4_addr_t *src, const ip4_addr_t *dest); +u16_t inet_chksum_pseudo_partial(struct pbuf *p, u8_t proto, + u16_t proto_len, u16_t chksum_len, const ip4_addr_t *src, const ip4_addr_t *dest); +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +u16_t ip6_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip6_addr_t *src, const ip6_addr_t *dest); +u16_t ip6_chksum_pseudo_partial(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, const ip6_addr_t *src, const ip6_addr_t *dest); +#endif /* LWIP_IPV6 */ + + +u16_t ip_chksum_pseudo(struct pbuf *p, u8_t proto, u16_t proto_len, + const ip_addr_t *src, const ip_addr_t *dest); +u16_t ip_chksum_pseudo_partial(struct pbuf *p, u8_t proto, u16_t proto_len, + u16_t chksum_len, const ip_addr_t *src, const ip_addr_t *dest); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_INET_H */ + diff --git a/components/lwip/include/lwip/lwip/init.h b/components/lwip/include/lwip/lwip/init.h new file mode 100755 index 000000000..70351b86f --- /dev/null +++ b/components/lwip/include/lwip/lwip/init.h @@ -0,0 +1,72 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_INIT_H +#define LWIP_HDR_INIT_H + +#include "lwip/opt.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** X.x.x: Major version of the stack */ +#define LWIP_VERSION_MAJOR 1U +/** x.X.x: Minor version of the stack */ +#define LWIP_VERSION_MINOR 5U +/** x.x.X: Revision of the stack */ +#define LWIP_VERSION_REVISION 0U +/** For release candidates, this is set to 1..254 + * For official releases, this is set to 255 (LWIP_RC_RELEASE) + * For development versions (Git), this is set to 0 (LWIP_RC_DEVELOPMENT) */ +#define LWIP_VERSION_RC 0U + +/** LWIP_VERSION_RC is set to LWIP_RC_RELEASE for official releases */ +#define LWIP_RC_RELEASE 255U +/** LWIP_VERSION_RC is set to LWIP_RC_DEVELOPMENT for Git versions */ +#define LWIP_RC_DEVELOPMENT 0U + +#define LWIP_VERSION_IS_RELEASE (LWIP_VERSION_RC == LWIP_RC_RELEASE) +#define LWIP_VERSION_IS_DEVELOPMENT (LWIP_VERSION_RC == LWIP_RC_DEVELOPMENT) +#define LWIP_VERSION_IS_RC ((LWIP_VERSION_RC != LWIP_RC_RELEASE) && (LWIP_VERSION_RC != LWIP_RC_DEVELOPMENT)) + +/** Provides the version of the stack */ +#define LWIP_VERSION (LWIP_VERSION_MAJOR << 24 | LWIP_VERSION_MINOR << 16 | \ + LWIP_VERSION_REVISION << 8 | LWIP_VERSION_RC) + +/* Modules initialization */ +void lwip_init(void); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_INIT_H */ diff --git a/components/lwip/include/lwip/lwip/ip.h b/components/lwip/include/lwip/lwip/ip.h new file mode 100755 index 000000000..d42fe6811 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip.h @@ -0,0 +1,304 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_IP_H__ +#define LWIP_HDR_IP_H__ + +#include "lwip/opt.h" + +#include "lwip/def.h" +#include "lwip/pbuf.h" +#include "lwip/ip_addr.h" +#include "lwip/err.h" +#include "lwip/netif.h" +#include "lwip/ip4.h" +#include "lwip/ip6.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define IP_PROTO_ICMP 1 +#define IP_PROTO_IGMP 2 +#define IP_PROTO_UDP 17 +#define IP_PROTO_UDPLITE 136 +#define IP_PROTO_TCP 6 + +/** This operates on a void* by loading the first byte */ +#define IP_HDR_GET_VERSION(ptr) ((*(u8_t*)(ptr)) >> 4) + +/* This is passed as the destination address to ip_output_if (not + to ip_output), meaning that an IP header already is constructed + in the pbuf. This is used when TCP retransmits. */ +#ifdef IP_HDRINCL +#undef IP_HDRINCL +#endif /* IP_HDRINCL */ +#define IP_HDRINCL NULL + +/** pbufs passed to IP must have a ref-count of 1 as their payload pointer + gets altered as the packet is passed down the stack */ +#ifndef LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX +#define LWIP_IP_CHECK_PBUF_REF_COUNT_FOR_TX(p) LWIP_ASSERT("p->ref == 1", (p)->ref == 1) +#endif + +#if LWIP_NETIF_HWADDRHINT +#define IP_PCB_ADDRHINT ;u8_t addr_hint +#else +#define IP_PCB_ADDRHINT +#endif /* LWIP_NETIF_HWADDRHINT */ + +/* This is the common part of all PCB types. It needs to be at the + beginning of a PCB type definition. It is located here so that + changes to this common part are made in one location instead of + having to change all PCB structs. */ +#define IP_PCB \ + /* ip addresses in network byte order */ \ + ip_addr_t local_ip; \ + ip_addr_t remote_ip; \ + /* Socket options */ \ + u8_t so_options; \ + /* Type Of Service */ \ + u8_t tos; \ + /* Time To Live */ \ + u8_t ttl \ + /* link layer address resolution hint */ \ + IP_PCB_ADDRHINT + +struct ip_pcb { +/* Common members of all PCB types */ + IP_PCB; +}; + +/* + * Option flags per-socket. These are the same like SO_XXX in sockets.h + */ +#define SOF_REUSEADDR 0x04U /* allow local address reuse */ +#define SOF_KEEPALIVE 0x08U /* keep connections alive */ +#define SOF_BROADCAST 0x20U /* permit to send and to receive broadcast messages (see IP_SOF_BROADCAST option) */ + +/* These flags are inherited (e.g. from a listen-pcb to a connection-pcb): */ +#define SOF_INHERITED (SOF_REUSEADDR|SOF_KEEPALIVE) + +/* Global variables of this module, kept in a struct for efficient access using base+index. */ +struct ip_globals +{ + /** The interface that accepted the packet for the current callback invocation. */ + struct netif *current_netif; + /** The interface that received the packet for the current callback invocation. */ + struct netif *current_input_netif; +#if LWIP_IPV4 + /** Header of the input packet currently being processed. */ + struct ip_hdr *current_ip4_header; +#endif /* LWIP_IPV4 */ +#if LWIP_IPV6 + /** Header of the input IPv6 packet currently being processed. */ + struct ip6_hdr *current_ip6_header; +#endif /* LWIP_IPV6 */ + /** Total header length of current_ip4/6_header (i.e. after this, the UDP/TCP header starts) */ + u16_t current_ip_header_tot_len; + /** Source IP address of current_header */ + ip_addr_t current_iphdr_src; + /** Destination IP address of current_header */ + ip_addr_t current_iphdr_dest; +}; +extern struct ip_globals ip_data; + + +/** Get the interface that accepted the current packet. + * This may or may not be the receiving netif, depending on your netif/network setup. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip_current_netif() (ip_data.current_netif) +/** Get the interface that received the current packet. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip_current_input_netif() (ip_data.current_input_netif) +/** Total header length of ip(6)_current_header() (i.e. after this, the UDP/TCP header starts) */ +#define ip_current_header_tot_len() (ip_data.current_ip_header_tot_len) +/** Source IP address of current_header */ +#define ip_current_src_addr() (&ip_data.current_iphdr_src) +/** Destination IP address of current_header */ +#define ip_current_dest_addr() (&ip_data.current_iphdr_dest) + +#if LWIP_IPV4 && LWIP_IPV6 +/** Get the IPv4 header of the current packet. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip4_current_header() ((const struct ip_hdr*)(ip_data.current_ip4_header)) +/** Get the IPv6 header of the current packet. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip6_current_header() ((const struct ip6_hdr*)(ip_data.current_ip6_header)) +/** Returns TRUE if the current IP input packet is IPv6, FALSE if it is IPv4 */ +#define ip_current_is_v6() (ip6_current_header() != NULL) +/** Source IPv6 address of current_header */ +#define ip6_current_src_addr() (ip_2_ip6(&ip_data.current_iphdr_src)) +/** Destination IPv6 address of current_header */ +#define ip6_current_dest_addr() (ip_2_ip6(&ip_data.current_iphdr_dest)) +/** Get the transport layer protocol */ +#define ip_current_header_proto() (ip_current_is_v6() ? \ + IP6H_NEXTH(ip6_current_header()) :\ + IPH_PROTO(ip4_current_header())) +/** Get the transport layer header */ +#define ip_next_header_ptr() ((const void*)((ip_current_is_v6() ? \ + (const u8_t*)ip6_current_header() : (const u8_t*)ip4_current_header()) + ip_current_header_tot_len())) + +/** Source IP4 address of current_header */ +#define ip4_current_src_addr() (ip_2_ip4(&ip_data.current_iphdr_src)) +/** Destination IP4 address of current_header */ +#define ip4_current_dest_addr() (ip_2_ip4(&ip_data.current_iphdr_dest)) + +#elif LWIP_IPV4 /* LWIP_IPV4 && LWIP_IPV6 */ + +/** Get the IPv4 header of the current packet. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip4_current_header() ((const struct ip_hdr*)(ip_data.current_ip4_header)) +/** Always returns FALSE when only supporting IPv4 only */ +#define ip_current_is_v6() 0 +/** Get the transport layer protocol */ +#define ip_current_header_proto() IPH_PROTO(ip4_current_header()) +/** Get the transport layer header */ +#define ip_next_header_ptr() ((const void*)((const u8_t*)ip4_current_header() + ip_current_header_tot_len())) +/** Source IP4 address of current_header */ +#define ip4_current_src_addr() (&ip_data.current_iphdr_src) +/** Destination IP4 address of current_header */ +#define ip4_current_dest_addr() (&ip_data.current_iphdr_dest) + +#elif LWIP_IPV6 /* LWIP_IPV4 && LWIP_IPV6 */ + +/** Get the IPv6 header of the current packet. + * This function must only be called from a receive callback (udp_recv, + * raw_recv, tcp_accept). It will return NULL otherwise. */ +#define ip6_current_header() ((const struct ip6_hdr*)(ip_data.current_ip6_header)) +/** Always returns TRUE when only supporting IPv6 only */ +#define ip_current_is_v6() 1 +/** Get the transport layer protocol */ +#define ip_current_header_proto() IP6H_NEXTH(ip6_current_header()) +/** Get the transport layer header */ +#define ip_next_header_ptr() ((const void*)((const u8_t*)ip6_current_header())) +/** Source IP6 address of current_header */ +#define ip6_current_src_addr() (&ip_data.current_iphdr_src) +/** Destination IP6 address of current_header */ +#define ip6_current_dest_addr() (&ip_data.current_iphdr_dest) + +#endif /* LWIP_IPV6 */ + +/** Union source address of current_header */ +#define ip_current_src_addr() (&ip_data.current_iphdr_src) +/** Union destination address of current_header */ +#define ip_current_dest_addr() (&ip_data.current_iphdr_dest) + +/** Gets an IP pcb option (SOF_* flags) */ +#define ip_get_option(pcb, opt) ((pcb)->so_options & (opt)) +/** Sets an IP pcb option (SOF_* flags) */ +#define ip_set_option(pcb, opt) ((pcb)->so_options |= (opt)) +/** Resets an IP pcb option (SOF_* flags) */ +#define ip_reset_option(pcb, opt) ((pcb)->so_options &= ~(opt)) + +#if LWIP_IPV4 && LWIP_IPV6 +#define ip_output(p, src, dest, ttl, tos, proto) \ + (IP_IS_V6(dest) ? \ + ip6_output(p, ip_2_ip6(src), ip_2_ip6(dest), ttl, tos, proto) : \ + ip4_output(p, ip_2_ip4(src), ip_2_ip4(dest), ttl, tos, proto)) +#define ip_output_if(p, src, dest, ttl, tos, proto, netif) \ + (IP_IS_V6(dest) ? \ + ip6_output_if(p, ip_2_ip6(src), ip_2_ip6(dest), ttl, tos, proto, netif) : \ + ip4_output_if(p, ip_2_ip4(src), ip_2_ip4(dest), ttl, tos, proto, netif)) +#define ip_output_if_src(p, src, dest, ttl, tos, proto, netif) \ + (IP_IS_V6(dest) ? \ + ip6_output_if_src(p, ip_2_ip6(src), ip_2_ip6(dest), ttl, tos, proto, netif) : \ + ip4_output_if_src(p, ip_2_ip4(src), ip_2_ip4(dest), ttl, tos, proto, netif)) +#define ip_output_hinted(p, src, dest, ttl, tos, proto, addr_hint) \ + (IP_IS_V6(dest) ? \ + ip6_output_hinted(p, ip_2_ip6(src), ip_2_ip6(dest), ttl, tos, proto, addr_hint) : \ + ip4_output_hinted(p, ip_2_ip4(src), ip_2_ip4(dest), ttl, tos, proto, addr_hint)) +#define ip_route(src, dest) \ + (IP_IS_V6(dest) ? \ + ip6_route(ip_2_ip6(src), ip_2_ip6(dest)) : \ + ip4_route_src(ip_2_ip4(dest), ip_2_ip4(src))) +#define ip_netif_get_local_ip(netif, dest) (IP_IS_V6(dest) ? \ + ip6_netif_get_local_ip(netif, ip_2_ip6(dest)) : \ + ip4_netif_get_local_ip(netif)) +#define ip_debug_print(is_ipv6, p) ((is_ipv6) ? ip6_debug_print(p) : ip4_debug_print(p)) + +err_t ip_input(struct pbuf *p, struct netif *inp); + +#elif LWIP_IPV4 /* LWIP_IPV4 && LWIP_IPV6 */ + +#define ip_output(p, src, dest, ttl, tos, proto) \ + ip4_output(p, src, dest, ttl, tos, proto) +#define ip_output_if(p, src, dest, ttl, tos, proto, netif) \ + ip4_output_if(p, src, dest, ttl, tos, proto, netif) +#define ip_output_if_src(p, src, dest, ttl, tos, proto, netif) \ + ip4_output_if_src(p, src, dest, ttl, tos, proto, netif) +#define ip_output_hinted(p, src, dest, ttl, tos, proto, addr_hint) \ + ip4_output_hinted(p, src, dest, ttl, tos, proto, addr_hint) +#define ip_route(src, dest) \ + ip4_route_src(dest, src) +#define ip_netif_get_local_ip(netif, dest) \ + ip4_netif_get_local_ip(netif) +#define ip_debug_print(is_ipv6, p) ip4_debug_print(p) + +#define ip_input ip4_input + +#elif LWIP_IPV6 /* LWIP_IPV4 && LWIP_IPV6 */ + +#define ip_output(p, src, dest, ttl, tos, proto) \ + ip6_output(p, src, dest, ttl, tos, proto) +#define ip_output_if(p, src, dest, ttl, tos, proto, netif) \ + ip6_output_if(p, src, dest, ttl, tos, proto, netif) +#define ip_output_if_src(p, src, dest, ttl, tos, proto, netif) \ + ip6_output_if_src(p, src, dest, ttl, tos, proto, netif) +#define ip_output_hinted(p, src, dest, ttl, tos, proto, addr_hint) \ + ip6_output_hinted(p, src, dest, ttl, tos, proto, addr_hint) +#define ip_route(src, dest) \ + ip6_route(src, dest) +#define ip_netif_get_local_ip(netif, dest) \ + ip6_netif_get_local_ip(netif, dest) +#define ip_debug_print(is_ipv6, p) ip6_debug_print(p) + +#define ip_input ip6_input + +#endif /* LWIP_IPV6 */ + +#define ip_route_get_local_ip(src, dest, netif, ipaddr) do { \ + (netif) = ip_route(src, dest); \ + (ipaddr) = ip_netif_get_local_ip(netif, dest); \ +}while(0) + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_IP_H__ */ + + diff --git a/components/lwip/include/lwip/lwip/ip4.h b/components/lwip/include/lwip/lwip/ip4.h new file mode 100755 index 000000000..e69e55c75 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip4.h @@ -0,0 +1,161 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_IP4_H +#define LWIP_HDR_IP4_H + +#include "lwip/opt.h" + +#if LWIP_IPV4 + +#include "lwip/def.h" +#include "lwip/pbuf.h" +#include "lwip/ip4_addr.h" +#include "lwip/err.h" +#include "lwip/netif.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef LWIP_HOOK_IP4_ROUTE_SRC +#define LWIP_IPV4_SRC_ROUTING 1 +#else +#define LWIP_IPV4_SRC_ROUTING 0 +#endif + +/** Currently, the function ip_output_if_opt() is only used with IGMP */ +#define IP_OPTIONS_SEND (LWIP_IPV4 && LWIP_IGMP) + +#define IP_HLEN 20 + + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip_hdr { + /* version / header length */ + PACK_STRUCT_FLD_8(u8_t _v_hl); + /* type of service */ + PACK_STRUCT_FLD_8(u8_t _tos); + /* total length */ + PACK_STRUCT_FIELD(u16_t _len); + /* identification */ + PACK_STRUCT_FIELD(u16_t _id); + /* fragment offset field */ + PACK_STRUCT_FIELD(u16_t _offset); +#define IP_RF 0x8000U /* reserved fragment flag */ +#define IP_DF 0x4000U /* don't fragment flag */ +#define IP_MF 0x2000U /* more fragments flag */ +#define IP_OFFMASK 0x1fffU /* mask for fragmenting bits */ + /* time to live */ + PACK_STRUCT_FLD_8(u8_t _ttl); + /* protocol*/ + PACK_STRUCT_FLD_8(u8_t _proto); + /* checksum */ + PACK_STRUCT_FIELD(u16_t _chksum); + /* source and destination IP addresses */ + PACK_STRUCT_FLD_S(ip4_addr_p_t src); + PACK_STRUCT_FLD_S(ip4_addr_p_t dest); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define IPH_V(hdr) ((hdr)->_v_hl >> 4) +#define IPH_HL(hdr) ((hdr)->_v_hl & 0x0f) +#define IPH_TOS(hdr) ((hdr)->_tos) +#define IPH_LEN(hdr) ((hdr)->_len) +#define IPH_ID(hdr) ((hdr)->_id) +#define IPH_OFFSET(hdr) ((hdr)->_offset) +#define IPH_TTL(hdr) ((hdr)->_ttl) +#define IPH_PROTO(hdr) ((hdr)->_proto) +#define IPH_CHKSUM(hdr) ((hdr)->_chksum) + +#define IPH_VHL_SET(hdr, v, hl) (hdr)->_v_hl = (u8_t)((((v) << 4) | (hl))) +#define IPH_TOS_SET(hdr, tos) (hdr)->_tos = (tos) +#define IPH_LEN_SET(hdr, len) (hdr)->_len = (len) +#define IPH_ID_SET(hdr, id) (hdr)->_id = (id) +#define IPH_OFFSET_SET(hdr, off) (hdr)->_offset = (off) +#define IPH_TTL_SET(hdr, ttl) (hdr)->_ttl = (u8_t)(ttl) +#define IPH_PROTO_SET(hdr, proto) (hdr)->_proto = (u8_t)(proto) +#define IPH_CHKSUM_SET(hdr, chksum) (hdr)->_chksum = (chksum) + +#define ip_init() /* Compatibility define, no init needed. */ +struct netif *ip4_route(const ip4_addr_t *dest); +#if LWIP_IPV4_SRC_ROUTING +struct netif *ip4_route_src(const ip4_addr_t *dest, const ip4_addr_t *src); +#else /* LWIP_IPV4_SRC_ROUTING */ +#define ip4_route_src(dest, src) ip4_route(dest) +#endif /* LWIP_IPV4_SRC_ROUTING */ +err_t ip4_input(struct pbuf *p, struct netif *inp); +err_t ip4_output(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto); +err_t ip4_output_if(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif); +err_t ip4_output_if_src(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif); +#if LWIP_NETIF_HWADDRHINT +err_t ip4_output_hinted(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, u8_t *addr_hint); +#endif /* LWIP_NETIF_HWADDRHINT */ +#if IP_OPTIONS_SEND +err_t ip4_output_if_opt(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif, void *ip_options, + u16_t optlen); +err_t ip4_output_if_opt_src(struct pbuf *p, const ip4_addr_t *src, const ip4_addr_t *dest, + u8_t ttl, u8_t tos, u8_t proto, struct netif *netif, void *ip_options, + u16_t optlen); +#endif /* IP_OPTIONS_SEND */ + +#if LWIP_MULTICAST_TX_OPTIONS +void ip4_set_default_multicast_netif(struct netif* default_multicast_netif); +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + +#define ip4_netif_get_local_ip(netif) (((netif) != NULL) ? netif_ip_addr4(netif) : NULL) + +#if IP_DEBUG +void ip4_debug_print(struct pbuf *p); +#else +#define ip4_debug_print(p) +#endif /* IP_DEBUG */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV4 */ + +#endif /* LWIP_HDR_IP_H */ + + diff --git a/components/lwip/include/lwip/lwip/ip4_addr.h b/components/lwip/include/lwip/lwip/ip4_addr.h new file mode 100755 index 000000000..9483a2f7b --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip4_addr.h @@ -0,0 +1,253 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_IP4_ADDR_H +#define LWIP_HDR_IP4_ADDR_H + +#include "lwip/opt.h" +#include "lwip/def.h" + +#if LWIP_IPV4 + +#ifdef __cplusplus +extern "C" { +#endif + +/* This is the aligned version of ip4_addr_t, + used as local variable, on the stack, etc. */ +struct ip4_addr { + u32_t addr; +}; + +/* This is the packed version of ip4_addr_t, + used in network headers that are itself packed */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip4_addr_packed { + PACK_STRUCT_FIELD(u32_t addr); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** ip4_addr_t uses a struct for convenience only, so that the same defines can + * operate both on ip4_addr_t as well as on ip4_addr_p_t. */ +typedef struct ip4_addr ip4_addr_t; +typedef struct ip4_addr_packed ip4_addr_p_t; + +/* + * struct ipaddr2 is used in the definition of the ARP packet format in + * order to support compilers that don't have structure packing. + */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip4_addr2 { + PACK_STRUCT_FIELD(u16_t addrw[2]); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/* Forward declaration to not include netif.h */ +struct netif; + +/** 255.255.255.255 */ +#define IPADDR_NONE ((u32_t)0xffffffffUL) +/** 127.0.0.1 */ +#define IPADDR_LOOPBACK ((u32_t)0x7f000001UL) +/** 0.0.0.0 */ +#define IPADDR_ANY ((u32_t)0x00000000UL) +/** 255.255.255.255 */ +#define IPADDR_BROADCAST ((u32_t)0xffffffffUL) + +/* Definitions of the bits in an Internet address integer. + + On subnets, host and network parts are found according to + the subnet mask, not these masks. */ +#define IP_CLASSA(a) ((((u32_t)(a)) & 0x80000000UL) == 0) +#define IP_CLASSA_NET 0xff000000 +#define IP_CLASSA_NSHIFT 24 +#define IP_CLASSA_HOST (0xffffffff & ~IP_CLASSA_NET) +#define IP_CLASSA_MAX 128 + +#define IP_CLASSB(a) ((((u32_t)(a)) & 0xc0000000UL) == 0x80000000UL) +#define IP_CLASSB_NET 0xffff0000 +#define IP_CLASSB_NSHIFT 16 +#define IP_CLASSB_HOST (0xffffffff & ~IP_CLASSB_NET) +#define IP_CLASSB_MAX 65536 + +#define IP_CLASSC(a) ((((u32_t)(a)) & 0xe0000000UL) == 0xc0000000UL) +#define IP_CLASSC_NET 0xffffff00 +#define IP_CLASSC_NSHIFT 8 +#define IP_CLASSC_HOST (0xffffffff & ~IP_CLASSC_NET) + +#define IP_CLASSD(a) (((u32_t)(a) & 0xf0000000UL) == 0xe0000000UL) +#define IP_CLASSD_NET 0xf0000000 /* These ones aren't really */ +#define IP_CLASSD_NSHIFT 28 /* net and host fields, but */ +#define IP_CLASSD_HOST 0x0fffffff /* routing needn't know. */ +#define IP_MULTICAST(a) IP_CLASSD(a) + +#define IP_EXPERIMENTAL(a) (((u32_t)(a) & 0xf0000000UL) == 0xf0000000UL) +#define IP_BADCLASS(a) (((u32_t)(a) & 0xf0000000UL) == 0xf0000000UL) + +#define IP_LOOPBACKNET 127 /* official! */ + + +#if BYTE_ORDER == BIG_ENDIAN +/** Set an IP address given by the four byte-parts */ +#define IP4_ADDR(ipaddr, a,b,c,d) \ + (ipaddr)->addr = ((u32_t)((a) & 0xff) << 24) | \ + ((u32_t)((b) & 0xff) << 16) | \ + ((u32_t)((c) & 0xff) << 8) | \ + (u32_t)((d) & 0xff) +#else +/** Set an IP address given by the four byte-parts. + Little-endian version that prevents the use of htonl. */ +#define IP4_ADDR(ipaddr, a,b,c,d) \ + (ipaddr)->addr = ((u32_t)((d) & 0xff) << 24) | \ + ((u32_t)((c) & 0xff) << 16) | \ + ((u32_t)((b) & 0xff) << 8) | \ + (u32_t)((a) & 0xff) +#endif + +/** MEMCPY-like copying of IP addresses where addresses are known to be + * 16-bit-aligned if the port is correctly configured (so a port could define + * this to copying 2 u16_t's) - no NULL-pointer-checking needed. */ +#ifndef IPADDR2_COPY +#define IPADDR2_COPY(dest, src) SMEMCPY(dest, src, sizeof(ip4_addr_t)) +#endif + +/** Copy IP address - faster than ip4_addr_set: no NULL check */ +#define ip4_addr_copy(dest, src) ((dest).addr = (src).addr) +/** Safely copy one IP address to another (src may be NULL) */ +#define ip4_addr_set(dest, src) ((dest)->addr = \ + ((src) == NULL ? 0 : \ + (src)->addr)) +/** Set complete address to zero */ +#define ip4_addr_set_zero(ipaddr) ((ipaddr)->addr = 0) +/** Set address to IPADDR_ANY (no need for htonl()) */ +#define ip4_addr_set_any(ipaddr) ((ipaddr)->addr = IPADDR_ANY) +/** Set address to loopback address */ +#define ip4_addr_set_loopback(ipaddr) ((ipaddr)->addr = PP_HTONL(IPADDR_LOOPBACK)) +/** Check if an address is in the loopback region */ +#define ip4_addr_isloopback(ipaddr) (((ipaddr)->addr & PP_HTONL(IP_CLASSA_NET)) == PP_HTONL(((u32_t)IP_LOOPBACKNET) << 24)) +/** Safely copy one IP address to another and change byte order + * from host- to network-order. */ +#define ip4_addr_set_hton(dest, src) ((dest)->addr = \ + ((src) == NULL ? 0:\ + htonl((src)->addr))) +/** IPv4 only: set the IP address given as an u32_t */ +#define ip4_addr_set_u32(dest_ipaddr, src_u32) ((dest_ipaddr)->addr = (src_u32)) +/** IPv4 only: get the IP address as an u32_t */ +#define ip4_addr_get_u32(src_ipaddr) ((src_ipaddr)->addr) + +/** Get the network address by combining host address with netmask */ +#define ip4_addr_get_network(target, host, netmask) do { ((target)->addr = ((host)->addr) & ((netmask)->addr)); } while(0) + +/** + * Determine if two address are on the same network. + * + * @arg addr1 IP address 1 + * @arg addr2 IP address 2 + * @arg mask network identifier mask + * @return !0 if the network identifiers of both address match + */ +#define ip4_addr_netcmp(addr1, addr2, mask) (((addr1)->addr & \ + (mask)->addr) == \ + ((addr2)->addr & \ + (mask)->addr)) +#define ip4_addr_cmp(addr1, addr2) ((addr1)->addr == (addr2)->addr) + +#define ip4_addr_isany_val(addr1) ((addr1).addr == IPADDR_ANY) +#define ip4_addr_isany(addr1) ((addr1) == NULL || ip4_addr_isany_val(*(addr1))) + +#define ip4_addr_isbroadcast(addr1, netif) ip4_addr_isbroadcast_u32((addr1)->addr, netif) +u8_t ip4_addr_isbroadcast_u32(u32_t addr, const struct netif *netif); + +#define ip_addr_netmask_valid(netmask) ip4_addr_netmask_valid((netmask)->addr) +u8_t ip4_addr_netmask_valid(u32_t netmask); + +#define ip4_addr_ismulticast(addr1) (((addr1)->addr & PP_HTONL(0xf0000000UL)) == PP_HTONL(0xe0000000UL)) + +#define ip4_addr_islinklocal(addr1) (((addr1)->addr & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xa9fe0000UL)) + +#define ip4_addr_debug_print_parts(debug, a, b, c, d) \ + LWIP_DEBUGF(debug, ("%" U16_F ".%" U16_F ".%" U16_F ".%" U16_F, a, b, c, d)) +#define ip4_addr_debug_print(debug, ipaddr) \ + ip4_addr_debug_print_parts(debug, \ + (ipaddr) != NULL ? ip4_addr1_16(ipaddr) : 0, \ + (ipaddr) != NULL ? ip4_addr2_16(ipaddr) : 0, \ + (ipaddr) != NULL ? ip4_addr3_16(ipaddr) : 0, \ + (ipaddr) != NULL ? ip4_addr4_16(ipaddr) : 0) +#define ip4_addr_debug_print_val(debug, ipaddr) \ + ip4_addr_debug_print_parts(debug, \ + ip4_addr1_16(&(ipaddr)), \ + ip4_addr2_16(&(ipaddr)), \ + ip4_addr3_16(&(ipaddr)), \ + ip4_addr4_16(&(ipaddr))) + +/* Get one byte from the 4-byte address */ +#define ip4_addr1(ipaddr) (((const u8_t*)(&(ipaddr)->addr))[0]) +#define ip4_addr2(ipaddr) (((const u8_t*)(&(ipaddr)->addr))[1]) +#define ip4_addr3(ipaddr) (((const u8_t*)(&(ipaddr)->addr))[2]) +#define ip4_addr4(ipaddr) (((const u8_t*)(&(ipaddr)->addr))[3]) +/* These are cast to u16_t, with the intent that they are often arguments + * to printf using the U16_F format from cc.h. */ +#define ip4_addr1_16(ipaddr) ((u16_t)ip4_addr1(ipaddr)) +#define ip4_addr2_16(ipaddr) ((u16_t)ip4_addr2(ipaddr)) +#define ip4_addr3_16(ipaddr) ((u16_t)ip4_addr3(ipaddr)) +#define ip4_addr4_16(ipaddr) ((u16_t)ip4_addr4(ipaddr)) + +#define IP4ADDR_STRLEN_MAX 16 +#define IPADDR_STRLEN_MAX IP4ADDR_STRLEN_MAX + +/** For backwards compatibility */ +#define ip_ntoa(ipaddr) ipaddr_ntoa(ipaddr) + +u32_t ipaddr_addr(const char *cp); +int ip4addr_aton(const char *cp, ip4_addr_t *addr); +/** returns ptr to static buffer; not reentrant! */ +char *ip4addr_ntoa(const ip4_addr_t *addr); +char *ip4addr_ntoa_r(const ip4_addr_t *addr, char *buf, int buflen); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV4 */ + +#endif /* LWIP_HDR_IP_ADDR_H */ diff --git a/components/lwip/include/lwip/lwip/ip6.h b/components/lwip/include/lwip/lwip/ip6.h new file mode 100755 index 000000000..f1ffb6b73 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip6.h @@ -0,0 +1,197 @@ +/** + * @file + * + * IPv6 layer. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ +#ifndef LWIP_HDR_IP6_H +#define LWIP_HDR_IP6_H + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/ip6_addr.h" +#include "lwip/def.h" +#include "lwip/pbuf.h" +#include "lwip/netif.h" + +#include "lwip/err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define IP6_HLEN 40 + +#define IP6_NEXTH_HOPBYHOP 0 +#define IP6_NEXTH_TCP 6 +#define IP6_NEXTH_UDP 17 +#define IP6_NEXTH_ENCAPS 41 +#define IP6_NEXTH_ROUTING 43 +#define IP6_NEXTH_FRAGMENT 44 +#define IP6_NEXTH_ICMP6 58 +#define IP6_NEXTH_NONE 59 +#define IP6_NEXTH_DESTOPTS 60 +#define IP6_NEXTH_UDPLITE 136 + + +/* The IPv6 header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip6_hdr { + /* version / traffic class / flow label */ + PACK_STRUCT_FIELD(u32_t _v_tc_fl); + /* payload length */ + PACK_STRUCT_FIELD(u16_t _plen); + /* next header */ + PACK_STRUCT_FLD_8(u8_t _nexth); + /* hop limit */ + PACK_STRUCT_FLD_8(u8_t _hoplim); + /* source and destination IP addresses */ + PACK_STRUCT_FLD_S(ip6_addr_p_t src); + PACK_STRUCT_FLD_S(ip6_addr_p_t dest); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/* Hop-by-hop router alert option. */ +#define IP6_HBH_HLEN 8 +#define IP6_PAD1_OPTION 0 +#define IP6_PADN_ALERT_OPTION 1 +#define IP6_ROUTER_ALERT_OPTION 5 +#define IP6_ROUTER_ALERT_VALUE_MLD 0 +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip6_hbh_hdr { + /* next header */ + PACK_STRUCT_FLD_8(u8_t _nexth); + /* header length */ + PACK_STRUCT_FLD_8(u8_t _hlen); + /* router alert option type */ + PACK_STRUCT_FLD_8(u8_t _ra_opt_type); + /* router alert option data len */ + PACK_STRUCT_FLD_8(u8_t _ra_opt_dlen); + /* router alert option data */ + PACK_STRUCT_FIELD(u16_t _ra_opt_data); + /* PadN option type */ + PACK_STRUCT_FLD_8(u8_t _padn_opt_type); + /* PadN option data len */ + PACK_STRUCT_FLD_8(u8_t _padn_opt_dlen); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/* Fragment header. */ +#define IP6_FRAG_HLEN 8 +#define IP6_FRAG_OFFSET_MASK 0xfff8 +#define IP6_FRAG_MORE_FLAG 0x0001 +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip6_frag_hdr { + /* next header */ + PACK_STRUCT_FLD_8(u8_t _nexth); + /* reserved */ + PACK_STRUCT_FLD_8(u8_t reserved); + /* fragment offset */ + PACK_STRUCT_FIELD(u16_t _fragment_offset); + /* fragmented packet identification */ + PACK_STRUCT_FIELD(u32_t _identification); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define IP6H_V(hdr) ((ntohl((hdr)->_v_tc_fl) >> 28) & 0x0f) +#define IP6H_TC(hdr) ((ntohl((hdr)->_v_tc_fl) >> 20) & 0xff) +#define IP6H_FL(hdr) (ntohl((hdr)->_v_tc_fl) & 0x000fffff) +#define IP6H_PLEN(hdr) (ntohs((hdr)->_plen)) +#define IP6H_NEXTH(hdr) ((hdr)->_nexth) +#define IP6H_NEXTH_P(hdr) ((u8_t *)(hdr) + 6) +#define IP6H_HOPLIM(hdr) ((hdr)->_hoplim) + +#define IP6H_VTCFL_SET(hdr, v, tc, fl) (hdr)->_v_tc_fl = (htonl((((u32_t)(v)) << 28) | (((u32_t)(tc)) << 20) | (fl))) +#define IP6H_PLEN_SET(hdr, plen) (hdr)->_plen = htons(plen) +#define IP6H_NEXTH_SET(hdr, nexth) (hdr)->_nexth = (nexth) +#define IP6H_HOPLIM_SET(hdr, hl) (hdr)->_hoplim = (u8_t)(hl) + + +struct netif *ip6_route(const ip6_addr_t *src, const ip6_addr_t *dest); +const ip_addr_t *ip6_select_source_address(struct netif *netif, const ip6_addr_t * dest); +err_t ip6_input(struct pbuf *p, struct netif *inp); +err_t ip6_output(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth); +err_t ip6_output_if(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth, struct netif *netif); +err_t ip6_output_if_src(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth, struct netif *netif); +#if LWIP_NETIF_HWADDRHINT +err_t ip6_output_hinted(struct pbuf *p, const ip6_addr_t *src, const ip6_addr_t *dest, + u8_t hl, u8_t tc, u8_t nexth, u8_t *addr_hint); +#endif /* LWIP_NETIF_HWADDRHINT */ +#if LWIP_IPV6_MLD +err_t ip6_options_add_hbh_ra(struct pbuf * p, u8_t nexth, u8_t value); +#endif /* LWIP_IPV6_MLD */ + +#define ip6_netif_get_local_ip(netif, dest) (((netif) != NULL) ? \ + ip6_select_source_address(netif, dest) : NULL) + +#if IP6_DEBUG +void ip6_debug_print(struct pbuf *p); +#else +#define ip6_debug_print(p) +#endif /* IP6_DEBUG */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6 */ + +#endif /* LWIP_HDR_IP6_H */ diff --git a/components/lwip/include/lwip/lwip/ip6_addr.h b/components/lwip/include/lwip/lwip/ip6_addr.h new file mode 100755 index 000000000..a75d89485 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip6_addr.h @@ -0,0 +1,301 @@ +/** + * @file + * + * IPv6 addresses. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * Structs and macros for handling IPv6 addresses. + * + * Please coordinate changes and requests with Ivan Delamer + * + */ +#ifndef LWIP_HDR_IP6_ADDR_H +#define LWIP_HDR_IP6_ADDR_H + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + + +#ifdef __cplusplus +extern "C" { +#endif + + +/* This is the aligned version of ip6_addr_t, + used as local variable, on the stack, etc. */ +struct ip6_addr { + u32_t addr[4]; +}; + +/* This is the packed version of ip6_addr_t, + used in network headers that are itself packed */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ip6_addr_packed { + PACK_STRUCT_FIELD(u32_t addr[4]); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +typedef struct ip6_addr ip6_addr_t; +typedef struct ip6_addr_packed ip6_addr_p_t; + + +#if BYTE_ORDER == BIG_ENDIAN +/** Set an IPv6 partial address given by byte-parts. */ +#define IP6_ADDR_PART(ip6addr, index, a,b,c,d) \ + (ip6addr)->addr[index] = ((u32_t)((a) & 0xff) << 24) | \ + ((u32_t)((b) & 0xff) << 16) | \ + ((u32_t)((c) & 0xff) << 8) | \ + (u32_t)((d) & 0xff) +#else +/** Set an IPv6 partial address given by byte-parts. +Little-endian version, stored in network order (no htonl). */ +#define IP6_ADDR_PART(ip6addr, index, a,b,c,d) \ + (ip6addr)->addr[index] = ((u32_t)((d) & 0xff) << 24) | \ + ((u32_t)((c) & 0xff) << 16) | \ + ((u32_t)((b) & 0xff) << 8) | \ + (u32_t)((a) & 0xff) +#endif + +/** Set a full IPv6 address by passing the 4 u32_t indices in network byte order + (use PP_HTONL() for constants) */ +#define IP6_ADDR(ip6addr, idx0, idx1, idx2, idx3) do { \ + (ip6addr)->addr[0] = idx0; \ + (ip6addr)->addr[1] = idx1; \ + (ip6addr)->addr[2] = idx2; \ + (ip6addr)->addr[3] = idx3; } while(0) + +/** Access address in 16-bit block */ +#define IP6_ADDR_BLOCK1(ip6addr) ((u16_t)(htonl((ip6addr)->addr[0]) >> 16) & 0xffff) +#define IP6_ADDR_BLOCK2(ip6addr) ((u16_t)(htonl((ip6addr)->addr[0])) & 0xffff) +#define IP6_ADDR_BLOCK3(ip6addr) ((u16_t)(htonl((ip6addr)->addr[1]) >> 16) & 0xffff) +#define IP6_ADDR_BLOCK4(ip6addr) ((u16_t)(htonl((ip6addr)->addr[1])) & 0xffff) +#define IP6_ADDR_BLOCK5(ip6addr) ((u16_t)(htonl((ip6addr)->addr[2]) >> 16) & 0xffff) +#define IP6_ADDR_BLOCK6(ip6addr) ((u16_t)(htonl((ip6addr)->addr[2])) & 0xffff) +#define IP6_ADDR_BLOCK7(ip6addr) ((u16_t)(htonl((ip6addr)->addr[3]) >> 16) & 0xffff) +#define IP6_ADDR_BLOCK8(ip6addr) ((u16_t)(htonl((ip6addr)->addr[3])) & 0xffff) + +/** Copy IPv6 address - faster than ip6_addr_set: no NULL check */ +#define ip6_addr_copy(dest, src) do{(dest).addr[0] = (src).addr[0]; \ + (dest).addr[1] = (src).addr[1]; \ + (dest).addr[2] = (src).addr[2]; \ + (dest).addr[3] = (src).addr[3];}while(0) +/** Safely copy one IPv6 address to another (src may be NULL) */ +#define ip6_addr_set(dest, src) do{(dest)->addr[0] = (src) == NULL ? 0 : (src)->addr[0]; \ + (dest)->addr[1] = (src) == NULL ? 0 : (src)->addr[1]; \ + (dest)->addr[2] = (src) == NULL ? 0 : (src)->addr[2]; \ + (dest)->addr[3] = (src) == NULL ? 0 : (src)->addr[3];}while(0) + +/** Set complete address to zero */ +#define ip6_addr_set_zero(ip6addr) do{(ip6addr)->addr[0] = 0; \ + (ip6addr)->addr[1] = 0; \ + (ip6addr)->addr[2] = 0; \ + (ip6addr)->addr[3] = 0;}while(0) + +/** Set address to ipv6 'any' (no need for htonl()) */ +#define ip6_addr_set_any(ip6addr) ip6_addr_set_zero(ip6addr) +/** Set address to ipv6 loopback address */ +#define ip6_addr_set_loopback(ip6addr) do{(ip6addr)->addr[0] = 0; \ + (ip6addr)->addr[1] = 0; \ + (ip6addr)->addr[2] = 0; \ + (ip6addr)->addr[3] = PP_HTONL(0x00000001UL);}while(0) +/** Safely copy one IPv6 address to another and change byte order + * from host- to network-order. */ +#define ip6_addr_set_hton(dest, src) do{(dest)->addr[0] = (src) == NULL ? 0 : htonl((src)->addr[0]); \ + (dest)->addr[1] = (src) == NULL ? 0 : htonl((src)->addr[1]); \ + (dest)->addr[2] = (src) == NULL ? 0 : htonl((src)->addr[2]); \ + (dest)->addr[3] = (src) == NULL ? 0 : htonl((src)->addr[3]);}while(0) + + +/** + * Determine if two IPv6 address are on the same network. + * + * @arg addr1 IPv6 address 1 + * @arg addr2 IPv6 address 2 + * @return !0 if the network identifiers of both address match + */ +#define ip6_addr_netcmp(addr1, addr2) (((addr1)->addr[0] == (addr2)->addr[0]) && \ + ((addr1)->addr[1] == (addr2)->addr[1])) + +#define ip6_addr_cmp(addr1, addr2) (((addr1)->addr[0] == (addr2)->addr[0]) && \ + ((addr1)->addr[1] == (addr2)->addr[1]) && \ + ((addr1)->addr[2] == (addr2)->addr[2]) && \ + ((addr1)->addr[3] == (addr2)->addr[3])) + +#define ip6_get_subnet_id(ip6addr) (htonl((ip6addr)->addr[2]) & 0x0000ffffUL) + +#define ip6_addr_isany_val(ip6addr) (((ip6addr).addr[0] == 0) && \ + ((ip6addr).addr[1] == 0) && \ + ((ip6addr).addr[2] == 0) && \ + ((ip6addr).addr[3] == 0)) +#define ip6_addr_isany(ip6addr) (((ip6addr) == NULL) || ip6_addr_isany_val(*(ip6addr))) + +#define ip6_addr_isloopback(ip6addr) (((ip6addr)->addr[0] == 0UL) && \ + ((ip6addr)->addr[1] == 0UL) && \ + ((ip6addr)->addr[2] == 0UL) && \ + ((ip6addr)->addr[3] == PP_HTONL(0x00000001UL))) + +#define ip6_addr_isglobal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xe0000000UL)) == PP_HTONL(0x20000000UL)) + +#define ip6_addr_islinklocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffc00000UL)) == PP_HTONL(0xfe800000UL)) + +#define ip6_addr_issitelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xffc00000UL)) == PP_HTONL(0xfec00000UL)) + +#define ip6_addr_isuniquelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xfe000000UL)) == PP_HTONL(0xfc000000UL)) + +#define ip6_addr_ismulticast(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff000000UL)) == PP_HTONL(0xff000000UL)) +#define ip6_addr_multicast_transient_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00100000UL)) +#define ip6_addr_multicast_prefix_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00200000UL)) +#define ip6_addr_multicast_rendezvous_flag(ip6addr) ((ip6addr)->addr[0] & PP_HTONL(0x00400000UL)) +#define ip6_addr_multicast_scope(ip6addr) ((htonl((ip6addr)->addr[0]) >> 16) & 0xf) +#define IP6_MULTICAST_SCOPE_RESERVED 0x0 +#define IP6_MULTICAST_SCOPE_RESERVED0 0x0 +#define IP6_MULTICAST_SCOPE_INTERFACE_LOCAL 0x1 +#define IP6_MULTICAST_SCOPE_LINK_LOCAL 0x2 +#define IP6_MULTICAST_SCOPE_RESERVED3 0x3 +#define IP6_MULTICAST_SCOPE_ADMIN_LOCAL 0x4 +#define IP6_MULTICAST_SCOPE_SITE_LOCAL 0x5 +#define IP6_MULTICAST_SCOPE_ORGANIZATION_LOCAL 0x8 +#define IP6_MULTICAST_SCOPE_GLOBAL 0xe +#define IP6_MULTICAST_SCOPE_RESERVEDF 0xf +#define ip6_addr_ismulticast_iflocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff010000UL)) +#define ip6_addr_ismulticast_linklocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff020000UL)) +#define ip6_addr_ismulticast_adminlocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff040000UL)) +#define ip6_addr_ismulticast_sitelocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff050000UL)) +#define ip6_addr_ismulticast_orglocal(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff080000UL)) +#define ip6_addr_ismulticast_global(ip6addr) (((ip6addr)->addr[0] & PP_HTONL(0xff8f0000UL)) == PP_HTONL(0xff0e0000UL)) + +/* TODO define get/set for well-know multicast addresses, e.g. ff02::1 */ +#define ip6_addr_isallnodes_iflocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff010000UL)) && \ + ((ip6addr)->addr[1] == 0UL) && \ + ((ip6addr)->addr[2] == 0UL) && \ + ((ip6addr)->addr[3] == PP_HTONL(0x00000001UL))) + +#define ip6_addr_isallnodes_linklocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \ + ((ip6addr)->addr[1] == 0UL) && \ + ((ip6addr)->addr[2] == 0UL) && \ + ((ip6addr)->addr[3] == PP_HTONL(0x00000001UL))) +#define ip6_addr_set_allnodes_linklocal(ip6addr) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \ + (ip6addr)->addr[1] = 0; \ + (ip6addr)->addr[2] = 0; \ + (ip6addr)->addr[3] = PP_HTONL(0x00000001UL);}while(0) + +#define ip6_addr_isallrouters_linklocal(ip6addr) (((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \ + ((ip6addr)->addr[1] == 0UL) && \ + ((ip6addr)->addr[2] == 0UL) && \ + ((ip6addr)->addr[3] == PP_HTONL(0x00000002UL))) +#define ip6_addr_set_allrouters_linklocal(ip6addr) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \ + (ip6addr)->addr[1] = 0; \ + (ip6addr)->addr[2] = 0; \ + (ip6addr)->addr[3] = PP_HTONL(0x00000002UL);}while(0) + +#define ip6_addr_issolicitednode(ip6addr) ( ((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \ + ((ip6addr)->addr[2] == PP_HTONL(0x00000001UL)) && \ + (((ip6addr)->addr[3] & PP_HTONL(0xff000000UL)) == PP_HTONL(0xff000000UL)) ) + +#define ip6_addr_set_solicitednode(ip6addr, if_id) do{(ip6addr)->addr[0] = PP_HTONL(0xff020000UL); \ + (ip6addr)->addr[1] = 0; \ + (ip6addr)->addr[2] = PP_HTONL(0x00000001UL); \ + (ip6addr)->addr[3] = (PP_HTONL(0xff000000UL) | (if_id));}while(0) + +#define ip6_addr_cmp_solicitednode(ip6addr, sn_addr) (((ip6addr)->addr[0] == PP_HTONL(0xff020000UL)) && \ + ((ip6addr)->addr[1] == 0) && \ + ((ip6addr)->addr[2] == PP_HTONL(0x00000001UL)) && \ + ((ip6addr)->addr[3] == (PP_HTONL(0xff000000UL) | (sn_addr)->addr[3]))) + +/* IPv6 address states. */ +#define IP6_ADDR_INVALID 0x00 +#define IP6_ADDR_TENTATIVE 0x08 +#define IP6_ADDR_TENTATIVE_1 0x09 /* 1 probe sent */ +#define IP6_ADDR_TENTATIVE_2 0x0a /* 2 probes sent */ +#define IP6_ADDR_TENTATIVE_3 0x0b /* 3 probes sent */ +#define IP6_ADDR_TENTATIVE_4 0x0c /* 4 probes sent */ +#define IP6_ADDR_TENTATIVE_5 0x0d /* 5 probes sent */ +#define IP6_ADDR_TENTATIVE_6 0x0e /* 6 probes sent */ +#define IP6_ADDR_TENTATIVE_7 0x0f /* 7 probes sent */ +#define IP6_ADDR_VALID 0x10 +#define IP6_ADDR_PREFERRED 0x30 +#define IP6_ADDR_DEPRECATED 0x50 + +#define ip6_addr_isinvalid(addr_state) (addr_state == IP6_ADDR_INVALID) +#define ip6_addr_istentative(addr_state) (addr_state & IP6_ADDR_TENTATIVE) +#define ip6_addr_isvalid(addr_state) (addr_state & IP6_ADDR_VALID) /* Include valid, preferred, and deprecated. */ +#define ip6_addr_ispreferred(addr_state) (addr_state == IP6_ADDR_PREFERRED) +#define ip6_addr_isdeprecated(addr_state) (addr_state == IP6_ADDR_DEPRECATED) + +#define ip6_addr_debug_print_parts(debug, a, b, c, d, e, f, g, h) \ + LWIP_DEBUGF(debug, ("%" X16_F ":%" X16_F ":%" X16_F ":%" X16_F ":%" X16_F ":%" X16_F ":%" X16_F ":%" X16_F, \ + a, b, c, d, e, f, g, h)) +#define ip6_addr_debug_print(debug, ipaddr) \ + ip6_addr_debug_print_parts(debug, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK1(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK2(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK3(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK4(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK5(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK6(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK7(ipaddr) : 0, \ + (ipaddr) != NULL ? IP6_ADDR_BLOCK8(ipaddr) : 0) +#define ip6_addr_debug_print_val(debug, ipaddr) \ + ip6_addr_debug_print_parts(debug, \ + IP6_ADDR_BLOCK1(&(ipaddr)), \ + IP6_ADDR_BLOCK2(&(ipaddr)), \ + IP6_ADDR_BLOCK3(&(ipaddr)), \ + IP6_ADDR_BLOCK4(&(ipaddr)), \ + IP6_ADDR_BLOCK5(&(ipaddr)), \ + IP6_ADDR_BLOCK6(&(ipaddr)), \ + IP6_ADDR_BLOCK7(&(ipaddr)), \ + IP6_ADDR_BLOCK8(&(ipaddr))) + +#define IP6ADDR_STRLEN_MAX 46 + +int ip6addr_aton(const char *cp, ip6_addr_t *addr); +/** returns ptr to static buffer; not reentrant! */ +char *ip6addr_ntoa(const ip6_addr_t *addr); +char *ip6addr_ntoa_r(const ip6_addr_t *addr, char *buf, int buflen); + + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6 */ + +#endif /* LWIP_HDR_IP6_ADDR_H */ diff --git a/components/lwip/include/lwip/lwip/ip6_frag.h b/components/lwip/include/lwip/lwip/ip6_frag.h new file mode 100755 index 000000000..16336e587 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip6_frag.h @@ -0,0 +1,120 @@ +/** + * @file + * + * IPv6 fragmentation and reassembly. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ +#ifndef LWIP_HDR_IP6_FRAG_H +#define LWIP_HDR_IP6_FRAG_H + +#include "lwip/opt.h" +#include "lwip/pbuf.h" +#include "lwip/ip6_addr.h" +#include "lwip/ip6.h" +#include "lwip/netif.h" + +#ifdef __cplusplus +extern "C" { +#endif + + +#if LWIP_IPV6 && LWIP_IPV6_REASS /* don't build if not configured for use in lwipopts.h */ + +/** IP6_FRAG_COPYHEADER==1: for platforms where sizeof(void*) > 4, this needs to + * be enabled (to not overwrite part of the data). When enabled, the IPv6 header + * is copied instead of referencing it, which gives more room for struct ip6_reass_helper */ +#ifndef IPV6_FRAG_COPYHEADER +#define IPV6_FRAG_COPYHEADER 0 +#endif + +/* The IPv6 reassembly timer interval in milliseconds. */ +#define IP6_REASS_TMR_INTERVAL 1000 + +/* Copy the complete header of the first fragment to struct ip6_reassdata + or just point to its original location in the first pbuf? */ +#if IPV6_FRAG_COPYHEADER +#define IPV6_FRAG_HDRPTR +#define IPV6_FRAG_HDRREF(hdr) (&(hdr)) +#else /* IPV6_FRAG_COPYHEADER */ +#define IPV6_FRAG_HDRPTR * +#define IPV6_FRAG_HDRREF(hdr) (hdr) +#endif /* IPV6_FRAG_COPYHEADER */ + +/* IPv6 reassembly helper struct. + * This is exported because memp needs to know the size. + */ +struct ip6_reassdata { + struct ip6_reassdata *next; + struct pbuf *p; + struct ip6_hdr IPV6_FRAG_HDRPTR iphdr; + u32_t identification; + u16_t datagram_len; + u8_t nexth; + u8_t timer; +}; + +#define ip6_reass_init() /* Compatibility define */ +void ip6_reass_tmr(void); +struct pbuf * ip6_reass(struct pbuf *p); + +#endif /* LWIP_IPV6 && LWIP_IPV6_REASS */ + +#if LWIP_IPV6 && LWIP_IPV6_FRAG /* don't build if not configured for use in lwipopts.h */ + +/** A custom pbuf that holds a reference to another pbuf, which is freed + * when this custom pbuf is freed. This is used to create a custom PBUF_REF + * that points into the original pbuf. */ +#ifndef LWIP_PBUF_CUSTOM_REF_DEFINED +#define LWIP_PBUF_CUSTOM_REF_DEFINED +struct pbuf_custom_ref { + /** 'base class' */ + struct pbuf_custom pc; + /** pointer to the original pbuf that is referenced */ + struct pbuf *original; +}; +#endif /* LWIP_PBUF_CUSTOM_REF_DEFINED */ + +err_t ip6_frag(struct pbuf *p, struct netif *netif, const ip6_addr_t *dest); + +#endif /* LWIP_IPV6 && LWIP_IPV6_FRAG */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_IP6_FRAG_H */ diff --git a/components/lwip/include/lwip/lwip/ip_addr.h b/components/lwip/include/lwip/lwip/ip_addr.h new file mode 100755 index 000000000..1e1ffb3f1 --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip_addr.h @@ -0,0 +1,291 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_IP_ADDR_H__ +#define LWIP_HDR_IP_ADDR_H__ + +#include "lwip/opt.h" +#include "lwip/def.h" + +#include "lwip/ip4_addr.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** These are the values for ip_addr_t.type */ +#define IPADDR_TYPE_V4 0U +#define IPADDR_TYPE_V6 6U +#define IPADDR_TYPE_ANY 46U + +#if LWIP_IPV4 && LWIP_IPV6 +/** A union struct for both IP version's addresses. + * ATTENTION: watch out for its size when adding IPv6 address scope! + */ +typedef struct _ip_addr { + union { + ip6_addr_t ip6; + ip4_addr_t ip4; + } u_addr; + u8_t type; +} ip_addr_t; + +extern const ip_addr_t ip_addr_any_type; + +#define IPADDR4_INIT(u32val) { { { { u32val, 0ul, 0ul, 0ul } } }, IPADDR_TYPE_V4 } +#define IPADDR6_INIT(a, b, c, d) { { { { a, b, c, d } } }, IPADDR_TYPE_V6 } + +#define IP_IS_ANY_TYPE_VAL(ipaddr) (IP_GET_TYPE(&ipaddr) == IPADDR_TYPE_ANY) +#define IPADDR_ANY_TYPE_INIT { { { { 0ul, 0ul, 0ul, 0ul } } }, IPADDR_TYPE_ANY } + +#define IP_IS_V6_VAL(ipaddr) (IP_GET_TYPE(&ipaddr) == IPADDR_TYPE_V6) +#define IP_IS_V6(ipaddr) (((ipaddr) != NULL) && IP_IS_V6_VAL(*(ipaddr))) +#define IP_SET_TYPE_VAL(ipaddr, iptype) do { (ipaddr).type = (iptype); }while(0) +#define IP_SET_TYPE(ipaddr, iptype) do { if((ipaddr) != NULL) { IP_SET_TYPE_VAL(*(ipaddr), iptype); }}while(0) +#define IP_GET_TYPE(ipaddr) ((ipaddr)->type) + +#define IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr) (IP_GET_TYPE(&pcb->local_ip) == IP_GET_TYPE(ipaddr)) +#define IP_ADDR_PCB_VERSION_MATCH(pcb, ipaddr) (IP_IS_ANY_TYPE_VAL(pcb->local_ip) || IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr)) + +/* Convert generic ip address to specific protocol version */ +#define ip_2_ip6(ipaddr) (&((ipaddr)->u_addr.ip6)) +#define ip_2_ip4(ipaddr) (&((ipaddr)->u_addr.ip4)) + +#define IP_ADDR4(ipaddr,a,b,c,d) do { IP4_ADDR(ip_2_ip4(ipaddr),a,b,c,d); \ + IP_SET_TYPE_VAL(*(ipaddr), IPADDR_TYPE_V4); } while(0) +#define IP_ADDR6(ipaddr,i0,i1,i2,i3) do { IP6_ADDR(ip_2_ip6(ipaddr),i0,i1,i2,i3); \ + IP_SET_TYPE_VAL(*(ipaddr), IPADDR_TYPE_V6); } while(0) + +#define ip_addr_copy(dest, src) do{ IP_SET_TYPE_VAL(dest, IP_GET_TYPE(&src)); if(IP_IS_V6_VAL(src)){ \ + ip6_addr_copy(*ip_2_ip6(&(dest)), *ip_2_ip6(&(src))); }else{ \ + ip4_addr_copy(*ip_2_ip4(&(dest)), *ip_2_ip4(&(src))); }}while(0) +#define ip_addr_copy_from_ip6(dest, src) do{ \ + ip6_addr_copy(*ip_2_ip6(&(dest)), src); IP_SET_TYPE_VAL(dest, IPADDR_TYPE_V6); }while(0) +#define ip_addr_copy_from_ip4(dest, src) do{ \ + ip4_addr_copy(*ip_2_ip4(&(dest)), src); IP_SET_TYPE_VAL(dest, IPADDR_TYPE_V4); }while(0) +#define ip_addr_set_ip4_u32(ipaddr, val) do{if(ipaddr){ip4_addr_set_u32(ip_2_ip4(ipaddr), val); \ + IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0) +#define ip_addr_get_ip4_u32(ipaddr) (((ipaddr) && !IP_IS_V6(ipaddr)) ? \ + ip4_addr_get_u32(ip_2_ip4(ipaddr)) : 0) + +#define ip_addr_set(dest, src) do{ IP_SET_TYPE(dest, IP_GET_TYPE(src)); if(IP_IS_V6(src)){ \ + ip6_addr_set(ip_2_ip6(dest), ip_2_ip6(src)); }else{ \ + ip4_addr_set(ip_2_ip4(dest), ip_2_ip4(src)); }}while(0) + +#define ip_addr_set_ipaddr(dest, src) ip_addr_set(dest, src) +#define ip_addr_set_zero(ipaddr) do{ \ + ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, 0); }while(0) +#define ip_addr_set_zero_ip4(ipaddr) do{ \ + ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }while(0) +#define ip_addr_set_zero_ip6(ipaddr) do{ \ + ip6_addr_set_zero(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }while(0) +#define ip_addr_set_any(is_ipv6, ipaddr) do{if(is_ipv6){ \ + ip6_addr_set_any(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }else{ \ + ip4_addr_set_any(ip_2_ip4(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0) +#define ip_addr_set_loopback(is_ipv6, ipaddr) do{if(is_ipv6){ \ + ip6_addr_set_loopback(ip_2_ip6(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V6); }else{ \ + ip4_addr_set_loopback(ip_2_ip4(ipaddr)); IP_SET_TYPE(ipaddr, IPADDR_TYPE_V4); }}while(0) +#define ip_addr_set_hton(dest, src) do{if(IP_IS_V6(src)){ \ + ip6_addr_set_hton(ip_2_ip6(ipaddr), (src)); IP_SET_TYPE(dest, IPADDR_TYPE_V6); }else{ \ + ip4_addr_set_hton(ip_2_ip4(ipaddr), (src)); IP_SET_TYPE(dest, IPADDR_TYPE_V4); }}while(0) +#define ip_addr_get_network(target, host, netmask) do{if(IP_IS_V6(host)){ \ + ip4_addr_set_zero(ip_2_ip4(target)); IP_SET_TYPE(target, IPADDR_TYPE_V6); } else { \ + ip4_addr_get_network(ip_2_ip4(target), ip_2_ip4(host), ip_2_ip4(netmask)); IP_SET_TYPE(target, IPADDR_TYPE_V4); }}while(0) +#define ip_addr_netcmp(addr1, addr2, mask) ((IP_IS_V6(addr1) && IP_IS_V6(addr2)) ? \ + 0 : \ + ip4_addr_netcmp(ip_2_ip4(addr1), ip_2_ip4(addr2), mask)) +#define ip_addr_cmp(addr1, addr2) ((IP_GET_TYPE(addr1) != IP_GET_TYPE(addr2)) ? 0 : (IP_IS_V6_VAL(*(addr1)) ? \ + ip6_addr_cmp(ip_2_ip6(addr1), ip_2_ip6(addr2)) : \ + ip4_addr_cmp(ip_2_ip4(addr1), ip_2_ip4(addr2)))) +#define ip_addr_isany(ipaddr) ((IP_IS_V6(ipaddr)) ? \ + ip6_addr_isany(ip_2_ip6(ipaddr)) : \ + ip4_addr_isany(ip_2_ip4(ipaddr))) +#define ip_addr_isany_val(ipaddr) ((IP_IS_V6_VAL(ipaddr)) ? \ + ip6_addr_isany_val(*ip_2_ip6(&(ipaddr))) : \ + ip4_addr_isany_val(*ip_2_ip4(&(ipaddr)))) +#define ip_addr_isbroadcast(ipaddr, netif) ((IP_IS_V6(ipaddr)) ? \ + 0 : \ + ip4_addr_isbroadcast(ip_2_ip4(ipaddr), netif)) +#define ip_addr_ismulticast(ipaddr) ((IP_IS_V6(ipaddr)) ? \ + ip6_addr_ismulticast(ip_2_ip6(ipaddr)) : \ + ip4_addr_ismulticast(ip_2_ip4(ipaddr))) +#define ip_addr_isloopback(ipaddr) ((IP_IS_V6(ipaddr)) ? \ + ip6_addr_isloopback(ip_2_ip6(ipaddr)) : \ + ip4_addr_isloopback(ip_2_ip4(ipaddr))) +#define ip_addr_islinklocal(ipaddr) ((IP_IS_V6(ipaddr)) ? \ + ip6_addr_islinklocal(ip_2_ip6(ipaddr)) : \ + ip4_addr_islinklocal(ip_2_ip4(ipaddr))) +#define ip_addr_debug_print(debug, ipaddr) do { if(IP_IS_V6(ipaddr)) { \ + ip6_addr_debug_print(debug, ip_2_ip6(ipaddr)); } else { \ + ip4_addr_debug_print(debug, ip_2_ip4(ipaddr)); }}while(0) +#define ip_addr_debug_print_val(debug, ipaddr) do { if(IP_IS_V6_VAL(ipaddr)) { \ + ip6_addr_debug_print_val(debug, *ip_2_ip6(&(ipaddr))); } else { \ + ip4_addr_debug_print_val(debug, *ip_2_ip4(&(ipaddr))); }}while(0) +#define ipaddr_ntoa(addr) (((addr) == NULL) ? "NULL" : \ + ((IP_IS_V6(addr)) ? ip6addr_ntoa(ip_2_ip6(addr)) : ip4addr_ntoa(ip_2_ip4(addr)))) +#define ipaddr_ntoa_r(addr, buf, buflen) (((addr) == NULL) ? "NULL" : \ + ((IP_IS_V6(addr)) ? ip6addr_ntoa_r(ip_2_ip6(addr), buf, buflen) : ip4addr_ntoa_r(ip_2_ip4(addr), buf, buflen))) +int ipaddr_aton(const char *cp, ip_addr_t *addr); + +#else /* LWIP_IPV4 && LWIP_IPV6 */ + +#define IP_ADDR_PCB_VERSION_MATCH(addr, pcb) 1 +#define IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ipaddr) 1 + +#if LWIP_IPV4 + +typedef ip4_addr_t ip_addr_t; +#define IPADDR4_INIT(u32val) { u32val } +#define IP_IS_V6_VAL(ipaddr) 0 +#define IP_IS_V6(ipaddr) 0 +#define IP_IS_ANY_TYPE_VAL(ipaddr) 0 +#define IP_SET_TYPE_VAL(ipaddr, iptype) +#define IP_SET_TYPE(ipaddr, iptype) +#define IP_GET_TYPE(ipaddr) IPADDR_TYPE_V4 +#define ip_2_ip4(ipaddr) (ipaddr) +#define IP_ADDR4(ipaddr,a,b,c,d) IP4_ADDR(ipaddr,a,b,c,d) + +#define ip_addr_copy(dest, src) ip4_addr_copy(dest, src) +#define ip_addr_copy_from_ip4(dest, src) ip4_addr_copy(dest, src) +#define ip_addr_set_ip4_u32(ipaddr, val) ip4_addr_set_u32(ip_2_ip4(ipaddr), val) +#define ip_addr_get_ip4_u32(ipaddr) ip4_addr_get_u32(ip_2_ip4(ipaddr)) +#define ip_addr_set(dest, src) ip4_addr_set(dest, src) +#define ip_addr_set_ipaddr(dest, src) ip4_addr_set(dest, src) +#define ip_addr_set_zero(ipaddr) ip4_addr_set_zero(ipaddr) +#define ip_addr_set_zero_ip4(ipaddr) ip4_addr_set_zero(ipaddr) +#define ip_addr_set_any(is_ipv6, ipaddr) ip4_addr_set_any(ipaddr) +#define ip_addr_set_loopback(is_ipv6, ipaddr) ip4_addr_set_loopback(ipaddr) +#define ip_addr_set_hton(dest, src) ip4_addr_set_hton(dest, src) +#define ip_addr_get_network(target, host, mask) ip4_addr_get_network(target, host, mask) +#define ip_addr_netcmp(addr1, addr2, mask) ip4_addr_netcmp(addr1, addr2, mask) +#define ip_addr_cmp(addr1, addr2) ip4_addr_cmp(addr1, addr2) +#define ip_addr_isany(ipaddr) ip4_addr_isany(ipaddr) +#define ip_addr_isany_val(ipaddr) ip4_addr_isany_val(ipaddr) +#define ip_addr_isloopback(ipaddr) ip4_addr_isloopback(ipaddr) +#define ip_addr_islinklocal(ipaddr) ip4_addr_islinklocal(ipaddr) +#define ip_addr_isbroadcast(addr, netif) ip4_addr_isbroadcast(addr, netif) +#define ip_addr_ismulticast(ipaddr) ip4_addr_ismulticast(ipaddr) +#define ip_addr_debug_print(debug, ipaddr) ip4_addr_debug_print(debug, ipaddr) +#define ip_addr_debug_print_val(debug, ipaddr) ip4_addr_debug_print_val(debug, ipaddr) +#define ipaddr_ntoa(ipaddr) ip4addr_ntoa(ipaddr) +#define ipaddr_ntoa_r(ipaddr, buf, buflen) ip4addr_ntoa_r(ipaddr, buf, buflen) +#define ipaddr_aton(cp, addr) ip4addr_aton(cp, addr) + +#else /* LWIP_IPV4 */ + +typedef ip6_addr_t ip_addr_t; +#define IPADDR6_INIT(a, b, c, d) { { a, b, c, d } } +#define IP_IS_V6_VAL(ipaddr) 1 +#define IP_IS_V6(ipaddr) 1 +#define IP_IS_ANY_TYPE_VAL(ipaddr) 0 +#define IP_SET_TYPE_VAL(ipaddr, iptype) +#define IP_SET_TYPE(ipaddr, iptype) +#define IP_GET_TYPE(ipaddr) IPADDR_TYPE_V6 +#define ip_2_ip6(ipaddr) (ipaddr) +#define IP_ADDR6(ipaddr,i0,i1,i2,i3) IP6_ADDR(ipaddr,i0,i1,i2,i3) + +#define ip_addr_copy(dest, src) ip6_addr_copy(dest, src) +#define ip_addr_copy_from_ip6(dest, src) ip6_addr_copy(dest, src) +#define ip_addr_set(dest, src) ip6_addr_set(dest, src) +#define ip_addr_set_ipaddr(dest, src) ip6_addr_set(dest, src) +#define ip_addr_set_zero(ipaddr) ip6_addr_set_zero(ipaddr) +#define ip_addr_set_zero_ip6(ipaddr) ip6_addr_set_zero(ipaddr) +#define ip_addr_set_any(is_ipv6, ipaddr) ip6_addr_set_any(ipaddr) +#define ip_addr_set_loopback(is_ipv6, ipaddr) ip6_addr_set_loopback(ipaddr) +#define ip_addr_set_hton(dest, src) ip6_addr_set_hton(dest, src) +#define ip_addr_get_network(target, host, mask) ip6_addr_set_zero(target) +#define ip_addr_netcmp(addr1, addr2, mask) 0 +#define ip_addr_cmp(addr1, addr2) ip6_addr_cmp(addr1, addr2) +#define ip_addr_isany(ipaddr) ip6_addr_isany(ipaddr) +#define ip_addr_isany_val(ipaddr) ip6_addr_isany_val(ipaddr) +#define ip_addr_isloopback(ipaddr) ip6_addr_isloopback(ipaddr) +#define ip_addr_islinklocal(ipaddr) ip6_addr_islinklocal(ipaddr) +#define ip_addr_isbroadcast(addr, netif) 0 +#define ip_addr_ismulticast(ipaddr) ip6_addr_ismulticast(ipaddr) +#define ip_addr_debug_print(debug, ipaddr) ip6_addr_debug_print(debug, ipaddr) +#define ip_addr_debug_print_val(debug, ipaddr) ip6_addr_debug_print_val(debug, ipaddr) +#define ipaddr_ntoa(ipaddr) ip6addr_ntoa(ipaddr) +#define ipaddr_ntoa_r(ipaddr, buf, buflen) ip6addr_ntoa_r(ipaddr, buf, buflen) +#define ipaddr_aton(cp, addr) ip6addr_aton(cp, addr) + +#endif /* LWIP_IPV4 */ +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +#if LWIP_IPV4 + +extern const ip_addr_t ip_addr_any; +extern const ip_addr_t ip_addr_broadcast; + +/** IP_ADDR_ can be used as a fixed/const ip_addr_t + * for the IPv4 wildcard and the broadcast address + */ +#define IP_ADDR_ANY (&ip_addr_any) +#define IP_ADDR_BROADCAST (&ip_addr_broadcast) +/** IP4_ADDR_ can be used as a fixed/const ip4_addr_t + * for the wildcard and the broadcast address + */ +#define IP4_ADDR_ANY (ip_2_ip4(&ip_addr_any)) +#define IP4_ADDR_BROADCAST (ip_2_ip4(&ip_addr_broadcast)) + +#endif /* LWIP_IPV4*/ + +#if LWIP_IPV6 + +extern const ip_addr_t ip6_addr_any; + +/** IP6_ADDR_ANY can be used as a fixed ip_addr_t + * for the IPv6 wildcard address + */ +#define IP6_ADDR_ANY (&ip6_addr_any) +/** IP6_ADDR_ANY6 can be used as a fixed ip6_addr_t + * for the IPv6 wildcard address + */ +#define IP6_ADDR_ANY6 (ip_2_ip6(&ip6_addr_any)) + +#if !LWIP_IPV4 +/** Just a little upgrade-helper for IPv6-only configurations: */ +#define IP_ADDR_ANY IP6_ADDR_ANY +#endif /* !LWIP_IPV4 */ + +#endif + +#if LWIP_IPV4 && LWIP_IPV6 +#define IP_ANY_TYPE (&ip_addr_any_type) +#else +#define IP_ANY_TYPE IP_ADDR_ANY +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_IP_ADDR_H__ */ diff --git a/components/lwip/include/lwip/lwip/ip_frag.h b/components/lwip/include/lwip/lwip/ip_frag.h new file mode 100755 index 000000000..deeb2f4ef --- /dev/null +++ b/components/lwip/include/lwip/lwip/ip_frag.h @@ -0,0 +1,95 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Jani Monoses + * + */ + +#ifndef LWIP_HDR_IP_FRAG_H +#define LWIP_HDR_IP_FRAG_H + +#include "lwip/opt.h" +#include "lwip/err.h" +#include "lwip/pbuf.h" +#include "lwip/netif.h" +#include "lwip/ip_addr.h" +#include "lwip/ip.h" + +#if LWIP_IPV4 + +#ifdef __cplusplus +extern "C" { +#endif + +#if IP_REASSEMBLY +/* The IP reassembly timer interval in milliseconds. */ +#define IP_TMR_INTERVAL 1000 + +/* IP reassembly helper struct. + * This is exported because memp needs to know the size. + */ +struct ip_reassdata { + struct ip_reassdata *next; + struct pbuf *p; + struct ip_hdr iphdr; + u16_t datagram_len; + u8_t flags; + u8_t timer; +}; + +void ip_reass_init(void); +void ip_reass_tmr(void); +struct pbuf * ip4_reass(struct pbuf *p); +#endif /* IP_REASSEMBLY */ + +#if IP_FRAG +#if !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF +/** A custom pbuf that holds a reference to another pbuf, which is freed + * when this custom pbuf is freed. This is used to create a custom PBUF_REF + * that points into the original pbuf. */ +#ifndef LWIP_PBUF_CUSTOM_REF_DEFINED +#define LWIP_PBUF_CUSTOM_REF_DEFINED +struct pbuf_custom_ref { + /** 'base class' */ + struct pbuf_custom pc; + /** pointer to the original pbuf that is referenced */ + struct pbuf *original; +}; +#endif /* LWIP_PBUF_CUSTOM_REF_DEFINED */ +#endif /* !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF */ + +err_t ip4_frag(struct pbuf *p, struct netif *netif, const ip4_addr_t *dest); +#endif /* IP_FRAG */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV4 */ + +#endif /* LWIP_HDR_IP_FRAG_H */ diff --git a/components/lwip/include/lwip/lwip/mem.h b/components/lwip/include/lwip/lwip/mem.h new file mode 100755 index 000000000..ca76f6632 --- /dev/null +++ b/components/lwip/include/lwip/lwip/mem.h @@ -0,0 +1,162 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_MEM_H +#define LWIP_HDR_MEM_H + +#include "lwip/opt.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if MEM_LIBC_MALLOC + +#include /* for size_t */ + +typedef size_t mem_size_t; +#define MEM_SIZE_F SZT_F + +/* aliases for C library malloc() */ +#define mem_init() +/* in case C library malloc() needs extra protection, + * allow these defines to be overridden. + */ + +#ifndef MEMLEAK_DEBUG + +#ifndef mem_free +#define mem_free free +#endif +#ifndef mem_malloc +#define mem_malloc malloc +#endif +#ifndef mem_calloc +#define mem_calloc calloc +#endif + +/* DYC_NEED_TO_DO_LATER +#ifndef mem_realloc +#define mem_realloc +#endif +#ifndef mem_zalloc +#define mem_zalloc +#endif +*/ + +#else +/* +#ifndef mem_free +#define mem_free(s) \ + do{\ + const char *file = mem_debug_file;\ + vPortFree(s, file, __LINE__);\ + }while(0) +#endif +#ifndef mem_malloc +#define mem_malloc(s) ({const char *file = mem_debug_file; pvPortMalloc(s, file, __LINE__);}) +#endif +#ifndef mem_calloc +#define mem_calloc(s) ({const char *file = mem_debug_file; pvPortCalloc(s, file, __LINE__);}) +#endif +#ifndef mem_realloc +#define mem_realloc(p, s) ({const char *file = mem_debug_file; pvPortRealloc(p, s, file, __LINE__);}) +#endif +#ifndef mem_zalloc +#define mem_zalloc(s) ({const char *file = mem_debug_file; pvPortZalloc(s, file, __LINE__);}) +#endif +*/ +#endif + + + +/* Since there is no C library allocation function to shrink memory without + moving it, define this to nothing. */ +#ifndef mem_trim +#define mem_trim(mem, size) (mem) +#endif +#else /* MEM_LIBC_MALLOC */ + +/* MEM_SIZE would have to be aligned, but using 64000 here instead of + * 65535 leaves some room for alignment... + */ +#if MEM_SIZE > 64000L +typedef u32_t mem_size_t; +#define MEM_SIZE_F U32_F +#else +typedef u16_t mem_size_t; +#define MEM_SIZE_F U16_F +#endif /* MEM_SIZE > 64000 */ + +#if MEM_USE_POOLS +/** mem_init is not used when using pools instead of a heap */ +#define mem_init() +/** mem_trim is not used when using pools instead of a heap: + we can't free part of a pool element and don't want to copy the rest */ +#define mem_trim(mem, size) (mem) +#else /* MEM_USE_POOLS */ +/* lwIP alternative malloc */ +void mem_init(void); +void *mem_trim(void *mem, mem_size_t size); +#endif /* MEM_USE_POOLS */ +void *mem_malloc(mem_size_t size); +void *mem_calloc(mem_size_t count, mem_size_t size); +void mem_free(void *mem); +#endif /* MEM_LIBC_MALLOC */ + +/** Calculate memory size for an aligned buffer - returns the next highest + * multiple of MEM_ALIGNMENT (e.g. LWIP_MEM_ALIGN_SIZE(3) and + * LWIP_MEM_ALIGN_SIZE(4) will both yield 4 for MEM_ALIGNMENT == 4). + */ +#ifndef LWIP_MEM_ALIGN_SIZE +#define LWIP_MEM_ALIGN_SIZE(size) (((size) + MEM_ALIGNMENT - 1U) & ~(MEM_ALIGNMENT-1U)) +#endif + +/** Calculate safe memory size for an aligned buffer when using an unaligned + * type as storage. This includes a safety-margin on (MEM_ALIGNMENT - 1) at the + * start (e.g. if buffer is u8_t[] and actual data will be u32_t*) + */ +#ifndef LWIP_MEM_ALIGN_BUFFER +#define LWIP_MEM_ALIGN_BUFFER(size) (((size) + MEM_ALIGNMENT - 1U)) +#endif + +/** Align a memory pointer to the alignment defined by MEM_ALIGNMENT + * so that ADDR % MEM_ALIGNMENT == 0 + */ +#ifndef LWIP_MEM_ALIGN +#define LWIP_MEM_ALIGN(addr) ((void *)(((mem_ptr_t)(addr) + MEM_ALIGNMENT - 1) & ~(mem_ptr_t)(MEM_ALIGNMENT-1))) +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_MEM_H */ diff --git a/components/lwip/include/lwip/lwip/memp.h b/components/lwip/include/lwip/lwip/memp.h new file mode 100755 index 000000000..d7463f2b3 --- /dev/null +++ b/components/lwip/include/lwip/lwip/memp.h @@ -0,0 +1,133 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef LWIP_HDR_MEMP_H +#define LWIP_HDR_MEMP_H + +#ifdef __cplusplus +extern "C" { +#endif + +/* run once with empty definition to handle all custom includes in lwippools.h */ +#define LWIP_MEMPOOL(name,num,size,desc) +#include "lwip/priv/memp_std.h" + +/* Create the list of all memory pools managed by memp. MEMP_MAX represents a NULL pool at the end */ +typedef enum { +#define LWIP_MEMPOOL(name,num,size,desc) MEMP_##name, +#include "lwip/priv/memp_std.h" + MEMP_MAX +} memp_t; + +#include "lwip/priv/memp_priv.h" + +/* Private mempools example: + * .h: only when pool is used in multiple .c files: LWIP_MEMPOOL_PROTOTYPE(my_private_pool); + * .c: + * - in global variables section: LWIP_MEMPOOL_DECLARE(my_private_pool, 10, sizeof(foo), "Some description") + * - call ONCE before using pool (e.g. in some init() function): LWIP_MEMPOOL_INIT(my_private_pool); + * - allocate: void* my_new_mem = LWIP_MEMPOOL_ALLOC(my_private_pool); + * - free: LWIP_MEMPOOL_FREE(my_private_pool, my_new_mem); + * + * To relocate a pool, declare it as extern in cc.h. Example for GCC: + * extern u8_t __attribute__((section(".onchip_mem"))) memp_memory_my_private_pool[]; + */ + +extern const struct memp_desc* const memp_pools[MEMP_MAX]; + +#define LWIP_MEMPOOL_PROTOTYPE(name) extern const struct memp_desc memp_ ## name + +#if MEMP_MEM_MALLOC + +#include "lwip/mem.h" + +#define memp_init() +#define memp_malloc(type) mem_malloc(memp_pools[type]->size) +#define memp_free(type, mem) mem_free(mem) + +#define LWIP_MEMPOOL_DECLARE(name,num,size,desc) \ + const struct memp_desc memp_ ## name = { \ + LWIP_MEM_ALIGN_SIZE(size) \ + }; + +#define LWIP_MEMPOOL_INIT(name) +#define LWIP_MEMPOOL_ALLOC(name) mem_malloc(memp_ ## name.size) +#define LWIP_MEMPOOL_FREE(name, x) mem_free(x) + +#else /* MEMP_MEM_MALLOC */ + +#define LWIP_MEMPOOL_DECLARE(name,num,size,desc) u8_t memp_memory_ ## name ## _base \ + [((num) * (MEMP_SIZE + MEMP_ALIGN_SIZE(size)))]; \ + \ + static struct memp *memp_tab_ ## name; \ + \ + const struct memp_desc memp_ ## name = { \ + LWIP_MEM_ALIGN_SIZE(size), \ + (num), \ + DECLARE_LWIP_MEMPOOL_DESC(desc) \ + memp_memory_ ## name ## _base, \ + &memp_tab_ ## name \ + }; + +#define LWIP_MEMPOOL_INIT(name) memp_init_pool(&memp_ ## name) +#define LWIP_MEMPOOL_ALLOC(name) memp_malloc_pool(&memp_ ## name) +#define LWIP_MEMPOOL_FREE(name, x) memp_free_pool(&memp_ ## name, (x)) + +#if MEM_USE_POOLS +/** This structure is used to save the pool one element came from. */ +struct memp_malloc_helper +{ + memp_t poolnr; +#if MEMP_OVERFLOW_CHECK + u16_t size; +#endif /* MEMP_OVERFLOW_CHECK */ +}; + +#endif /* MEM_USE_POOLS */ + +void memp_init(void); + +#if MEMP_OVERFLOW_CHECK +void *memp_malloc_fn(memp_t type, const char* file, const int line); +#define memp_malloc(t) memp_malloc_fn((t), __FILE__, __LINE__) +#else +void *memp_malloc(memp_t type); +#endif +void memp_free(memp_t type, void *mem); + +#endif /* MEMP_MEM_MALLOC */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_MEMP_H */ diff --git a/components/lwip/include/lwip/lwip/mld6.h b/components/lwip/include/lwip/lwip/mld6.h new file mode 100755 index 000000000..a54dd49e9 --- /dev/null +++ b/components/lwip/include/lwip/lwip/mld6.h @@ -0,0 +1,119 @@ +/** + * @file + * + * Multicast listener discovery for IPv6. Aims to be compliant with RFC 2710. + * No support for MLDv2. + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_MLD6_H +#define LWIP_HDR_MLD6_H + +#include "lwip/opt.h" + +#if LWIP_IPV6_MLD && LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/netif.h" + + +#ifdef __cplusplus +extern "C" { +#endif + +struct mld_group { + /** next link */ + struct mld_group *next; + /** interface on which the group is active */ + struct netif *netif; + /** multicast address */ + ip6_addr_t group_address; + /** signifies we were the last person to report */ + u8_t last_reporter_flag; + /** current state of the group */ + u8_t group_state; + /** timer for reporting */ + u16_t timer; + /** counter of simultaneous uses */ + u8_t use; +}; + +/** Multicast listener report/query/done message header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct mld_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u16_t max_resp_delay); + PACK_STRUCT_FIELD(u16_t reserved); + PACK_STRUCT_FLD_S(ip6_addr_p_t multicast_address); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define MLD6_TMR_INTERVAL 100 /* Milliseconds */ + +/* MAC Filter Actions, these are passed to a netif's + * mld_mac_filter callback function. */ +#define MLD6_DEL_MAC_FILTER 0 +#define MLD6_ADD_MAC_FILTER 1 + + +err_t mld6_stop(struct netif *netif); +void mld6_report_groups(struct netif *netif); +void mld6_tmr(void); +struct mld_group *mld6_lookfor_group(struct netif *ifp, const ip6_addr_t *addr); +void mld6_input(struct pbuf *p, struct netif *inp); +err_t mld6_joingroup(const ip6_addr_t *srcaddr, const ip6_addr_t *groupaddr); +err_t mld6_joingroup_netif(struct netif *netif, const ip6_addr_t *groupaddr); +err_t mld6_leavegroup(const ip6_addr_t *srcaddr, const ip6_addr_t *groupaddr); +err_t mld6_leavegroup_netif(struct netif *netif, const ip6_addr_t *groupaddr); + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6_MLD && LWIP_IPV6 */ + +#endif /* LWIP_HDR_MLD6_H */ diff --git a/components/lwip/include/lwip/lwip/nd6.h b/components/lwip/include/lwip/lwip/nd6.h new file mode 100755 index 000000000..d0646f1b4 --- /dev/null +++ b/components/lwip/include/lwip/lwip/nd6.h @@ -0,0 +1,361 @@ +/** + * @file + * + * Neighbor discovery and stateless address autoconfiguration for IPv6. + * Aims to be compliant with RFC 4861 (Neighbor discovery) and RFC 4862 + * (Address autoconfiguration). + */ + +/* + * Copyright (c) 2010 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_ND6_H +#define LWIP_HDR_ND6_H + +#include "lwip/opt.h" + +#if LWIP_IPV6 /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" +#include "lwip/netif.h" + + +#ifdef __cplusplus +extern "C" { +#endif + +/* Struct for tables. */ +struct nd6_neighbor_cache_entry { + ip6_addr_t next_hop_address; + struct netif * netif; + u8_t lladdr[NETIF_MAX_HWADDR_LEN]; + /*u32_t pmtu;*/ +#if LWIP_ND6_QUEUEING + /** Pointer to queue of pending outgoing packets on this entry. */ + struct nd6_q_entry *q; +#else /* LWIP_ND6_QUEUEING */ + /** Pointer to a single pending outgoing packet on this entry. */ + struct pbuf *q; +#endif /* LWIP_ND6_QUEUEING */ + u8_t state; + u8_t isrouter; + union { + u32_t reachable_time; + u32_t delay_time; + u32_t probes_sent; + u32_t stale_time; + } counter; +}; + +struct nd6_destination_cache_entry { + ip6_addr_t destination_addr; + ip6_addr_t next_hop_addr; + u16_t pmtu; + u32_t age; +}; + +struct nd6_prefix_list_entry { + ip6_addr_t prefix; + struct netif * netif; + u32_t invalidation_timer; +#if LWIP_IPV6_AUTOCONFIG + u8_t flags; +#define ND6_PREFIX_AUTOCONFIG_AUTONOMOUS 0x01 +#define ND6_PREFIX_AUTOCONFIG_ADDRESS_GENERATED 0x02 +#define ND6_PREFIX_AUTOCONFIG_ADDRESS_DUPLICATE 0x04 +#endif /* LWIP_IPV6_AUTOCONFIG */ +}; + +struct nd6_router_list_entry { + struct nd6_neighbor_cache_entry * neighbor_entry; + u32_t invalidation_timer; + u8_t flags; +}; + + +enum nd6_neighbor_cache_entry_state { + ND6_NO_ENTRY = 0, + ND6_INCOMPLETE, + ND6_REACHABLE, + ND6_STALE, + ND6_DELAY, + ND6_PROBE +}; + +#if LWIP_ND6_QUEUEING +/** struct for queueing outgoing packets for unknown address + * defined here to be accessed by memp.h + */ +struct nd6_q_entry { + struct nd6_q_entry *next; + struct pbuf *p; +}; +#endif /* LWIP_ND6_QUEUEING */ + +/** Neighbor solicitation message header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ns_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u32_t reserved); + PACK_STRUCT_FLD_S(ip6_addr_p_t target_address); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Neighbor advertisement message header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct na_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FLD_8(u8_t flags); + PACK_STRUCT_FLD_8(u8_t reserved[3]); + PACK_STRUCT_FLD_S(ip6_addr_p_t target_address); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif +#define ND6_FLAG_ROUTER (0x80) +#define ND6_FLAG_SOLICITED (0x40) +#define ND6_FLAG_OVERRIDE (0x20) + +/** Router solicitation message header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct rs_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u32_t reserved); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Router advertisement message header. */ +#define ND6_RA_FLAG_MANAGED_ADDR_CONFIG (0x80) +#define ND6_RA_FLAG_OTHER_CONFIG (0x40) +#define ND6_RA_FLAG_HOME_AGENT (0x20) +#define ND6_RA_PREFERENCE_MASK (0x18) +#define ND6_RA_PREFERENCE_HIGH (0x08) +#define ND6_RA_PREFERENCE_MEDIUM (0x00) +#define ND6_RA_PREFERENCE_LOW (0x18) +#define ND6_RA_PREFERENCE_DISABLED (0x10) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct ra_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FLD_8(u8_t current_hop_limit); + PACK_STRUCT_FLD_8(u8_t flags); + PACK_STRUCT_FIELD(u16_t router_lifetime); + PACK_STRUCT_FIELD(u32_t reachable_time); + PACK_STRUCT_FIELD(u32_t retrans_timer); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Redirect message header. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct redirect_header { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u32_t reserved); + PACK_STRUCT_FLD_S(ip6_addr_p_t target_address); + PACK_STRUCT_FLD_S(ip6_addr_p_t destination_address); + /* Options follow. */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Link-layer address option. */ +#define ND6_OPTION_TYPE_SOURCE_LLADDR (0x01) +#define ND6_OPTION_TYPE_TARGET_LLADDR (0x02) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct lladdr_option { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t length); + PACK_STRUCT_FLD_8(u8_t addr[NETIF_MAX_HWADDR_LEN]); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Prefix information option. */ +#define ND6_OPTION_TYPE_PREFIX_INFO (0x03) +#define ND6_PREFIX_FLAG_ON_LINK (0x80) +#define ND6_PREFIX_FLAG_AUTONOMOUS (0x40) +#define ND6_PREFIX_FLAG_ROUTER_ADDRESS (0x20) +#define ND6_PREFIX_FLAG_SITE_PREFIX (0x10) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct prefix_option { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t length); + PACK_STRUCT_FLD_8(u8_t prefix_length); + PACK_STRUCT_FLD_8(u8_t flags); + PACK_STRUCT_FIELD(u32_t valid_lifetime); + PACK_STRUCT_FIELD(u32_t preferred_lifetime); + PACK_STRUCT_FLD_8(u8_t reserved2[3]); + PACK_STRUCT_FLD_8(u8_t site_prefix_length); + PACK_STRUCT_FLD_S(ip6_addr_p_t prefix); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Redirected header option. */ +#define ND6_OPTION_TYPE_REDIR_HDR (0x04) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct redirected_header_option { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t length); + PACK_STRUCT_FLD_8(u8_t reserved[6]); + /* Portion of redirected packet follows. */ + /* PACK_STRUCT_FLD_8(u8_t redirected[8]); */ +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** MTU option. */ +#define ND6_OPTION_TYPE_MTU (0x05) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct mtu_option { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t length); + PACK_STRUCT_FIELD(u16_t reserved); + PACK_STRUCT_FIELD(u32_t mtu); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** Route information option. */ +#define ND6_OPTION_TYPE_ROUTE_INFO (24) +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct route_option { + PACK_STRUCT_FLD_8(u8_t type); + PACK_STRUCT_FLD_8(u8_t length); + PACK_STRUCT_FLD_8(u8_t prefix_length); + PACK_STRUCT_FLD_8(u8_t preference); + PACK_STRUCT_FIELD(u32_t route_lifetime); + PACK_STRUCT_FLD_S(ip6_addr_p_t prefix); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +/** 1 second period */ +#define ND6_TMR_INTERVAL 1000 + +/* Router tables. */ +/* TODO make these static? and entries accessible through API? */ +extern struct nd6_neighbor_cache_entry neighbor_cache[]; +extern struct nd6_destination_cache_entry destination_cache[]; +extern struct nd6_prefix_list_entry prefix_list[]; +extern struct nd6_router_list_entry default_router_list[]; + +/* Default values, can be updated by a RA message. */ +extern u32_t reachable_time; +extern u32_t retrans_timer; + +void nd6_tmr(void); +void nd6_input(struct pbuf *p, struct netif *inp); +s8_t nd6_get_next_hop_entry(const ip6_addr_t * ip6addr, struct netif * netif); +s8_t nd6_select_router(const ip6_addr_t * ip6addr, struct netif * netif); +u16_t nd6_get_destination_mtu(const ip6_addr_t * ip6addr, struct netif * netif); +err_t nd6_queue_packet(s8_t neighbor_index, struct pbuf * p); +#if LWIP_ND6_TCP_REACHABILITY_HINTS +void nd6_reachability_hint(const ip6_addr_t * ip6addr); +#endif /* LWIP_ND6_TCP_REACHABILITY_HINTS */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6 */ + +#endif /* LWIP_HDR_ND6_H */ diff --git a/components/lwip/include/lwip/lwip/netbuf.h b/components/lwip/include/lwip/lwip/netbuf.h new file mode 100755 index 000000000..8875e12d8 --- /dev/null +++ b/components/lwip/include/lwip/lwip/netbuf.h @@ -0,0 +1,112 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_NETBUF_H +#define LWIP_HDR_NETBUF_H + +#include "lwip/opt.h" + +#if LWIP_NETCONN || LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ +/* Note: Netconn API is always available when sockets are enabled - + * sockets are implemented on top of them */ + +#include "lwip/pbuf.h" +#include "lwip/ip_addr.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** This netbuf has dest-addr/port set */ +#define NETBUF_FLAG_DESTADDR 0x01 +/** This netbuf includes a checksum */ +#define NETBUF_FLAG_CHKSUM 0x02 + +struct netbuf { + struct pbuf *p, *ptr; + ip_addr_t addr; + u16_t port; +#if LWIP_NETBUF_RECVINFO || LWIP_CHECKSUM_ON_COPY +#if LWIP_CHECKSUM_ON_COPY + u8_t flags; +#endif /* LWIP_CHECKSUM_ON_COPY */ + u16_t toport_chksum; +#if LWIP_NETBUF_RECVINFO + ip_addr_t toaddr; +#endif /* LWIP_NETBUF_RECVINFO */ +#endif /* LWIP_NETBUF_RECVINFO || LWIP_CHECKSUM_ON_COPY */ +}; + +/* Network buffer functions: */ +struct netbuf * netbuf_new (void); +void netbuf_delete (struct netbuf *buf); +void * netbuf_alloc (struct netbuf *buf, u16_t size); +void netbuf_free (struct netbuf *buf); +err_t netbuf_ref (struct netbuf *buf, + const void *dataptr, u16_t size); +void netbuf_chain (struct netbuf *head, struct netbuf *tail); + +err_t netbuf_data (struct netbuf *buf, + void **dataptr, u16_t *len); +s8_t netbuf_next (struct netbuf *buf); +void netbuf_first (struct netbuf *buf); + + +#define netbuf_copy_partial(buf, dataptr, len, offset) \ + pbuf_copy_partial((buf)->p, (dataptr), (len), (offset)) +#define netbuf_copy(buf,dataptr,len) netbuf_copy_partial(buf, dataptr, len, 0) +#define netbuf_take(buf, dataptr, len) pbuf_take((buf)->p, dataptr, len) +#define netbuf_len(buf) ((buf)->p->tot_len) +#define netbuf_fromaddr(buf) (&((buf)->addr)) +#define netbuf_set_fromaddr(buf, fromaddr) ip_addr_set(&((buf)->addr), fromaddr) +#define netbuf_fromport(buf) ((buf)->port) +#if LWIP_NETBUF_RECVINFO +#define netbuf_destaddr(buf) (&((buf)->toaddr)) +#define netbuf_set_destaddr(buf, destaddr) ip_addr_set(&((buf)->toaddr), destaddr) +#if LWIP_CHECKSUM_ON_COPY +#define netbuf_destport(buf) (((buf)->flags & NETBUF_FLAG_DESTADDR) ? (buf)->toport_chksum : 0) +#else /* LWIP_CHECKSUM_ON_COPY */ +#define netbuf_destport(buf) ((buf)->toport_chksum) +#endif /* LWIP_CHECKSUM_ON_COPY */ +#endif /* LWIP_NETBUF_RECVINFO */ +#if LWIP_CHECKSUM_ON_COPY +#define netbuf_set_chksum(buf, chksum) do { (buf)->flags = NETBUF_FLAG_CHKSUM; \ + (buf)->toport_chksum = chksum; } while(0) +#endif /* LWIP_CHECKSUM_ON_COPY */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_NETCONN || LWIP_SOCKET */ + +#endif /* LWIP_HDR_NETBUF_H */ diff --git a/components/lwip/include/lwip/lwip/netdb.h b/components/lwip/include/lwip/lwip/netdb.h new file mode 100755 index 000000000..144a6e0bd --- /dev/null +++ b/components/lwip/include/lwip/lwip/netdb.h @@ -0,0 +1,142 @@ +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Simon Goldschmidt + * + */ +#ifndef LWIP_HDR_NETDB_H +#define LWIP_HDR_NETDB_H + +#include "lwip/opt.h" + +#if LWIP_DNS && LWIP_SOCKET + +#include /* for size_t */ + +#include "lwip/inet.h" +#include "lwip/sockets.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* some rarely used options */ +#ifndef LWIP_DNS_API_DECLARE_H_ERRNO +#define LWIP_DNS_API_DECLARE_H_ERRNO 1 +#endif + +#ifndef LWIP_DNS_API_DEFINE_ERRORS +#define LWIP_DNS_API_DEFINE_ERRORS 1 +#endif + +#ifndef LWIP_DNS_API_DEFINE_FLAGS +#define LWIP_DNS_API_DEFINE_FLAGS 1 +#endif + +#ifndef LWIP_DNS_API_DECLARE_STRUCTS +#define LWIP_DNS_API_DECLARE_STRUCTS 1 +#endif + +#if LWIP_DNS_API_DEFINE_ERRORS +/** Errors used by the DNS API functions, h_errno can be one of them */ +#define EAI_NONAME 200 +#define EAI_SERVICE 201 +#define EAI_FAIL 202 +#define EAI_MEMORY 203 +#define EAI_FAMILY 204 + +#define HOST_NOT_FOUND 210 +#define NO_DATA 211 +#define NO_RECOVERY 212 +#define TRY_AGAIN 213 +#endif /* LWIP_DNS_API_DEFINE_ERRORS */ + +#if LWIP_DNS_API_DEFINE_FLAGS +/* input flags for struct addrinfo */ +#define AI_PASSIVE 0x01 +#define AI_CANONNAME 0x02 +#define AI_NUMERICHOST 0x04 +#define AI_NUMERICSERV 0x08 +#define AI_V4MAPPED 0x10 +#define AI_ALL 0x20 +#define AI_ADDRCONFIG 0x40 +#endif /* LWIP_DNS_API_DEFINE_FLAGS */ + +#if LWIP_DNS_API_DECLARE_STRUCTS +struct hostent { + char *h_name; /* Official name of the host. */ + char **h_aliases; /* A pointer to an array of pointers to alternative host names, + terminated by a null pointer. */ + int h_addrtype; /* Address type. */ + int h_length; /* The length, in bytes, of the address. */ + char **h_addr_list; /* A pointer to an array of pointers to network addresses (in + network byte order) for the host, terminated by a null pointer. */ +#define h_addr h_addr_list[0] /* for backward compatibility */ +}; + +struct addrinfo { + int ai_flags; /* Input flags. */ + int ai_family; /* Address family of socket. */ + int ai_socktype; /* Socket type. */ + int ai_protocol; /* Protocol of socket. */ + socklen_t ai_addrlen; /* Length of socket address. */ + struct sockaddr *ai_addr; /* Socket address of socket. */ + char *ai_canonname; /* Canonical name of service location. */ + struct addrinfo *ai_next; /* Pointer to next in list. */ +}; +#endif /* LWIP_DNS_API_DECLARE_STRUCTS */ + +#define NETDB_ELEM_SIZE (sizeof(struct addrinfo) + sizeof(struct sockaddr_storage) + DNS_MAX_NAME_LENGTH + 1) + +#if LWIP_DNS_API_DECLARE_H_ERRNO +/* application accessible error code set by the DNS API functions */ +extern int h_errno; +#endif /* LWIP_DNS_API_DECLARE_H_ERRNO*/ + +struct hostent *lwip_gethostbyname(const char *name); +int lwip_gethostbyname_r(const char *name, struct hostent *ret, char *buf, + size_t buflen, struct hostent **result, int *h_errnop); +void lwip_freeaddrinfo(struct addrinfo *ai); +int lwip_getaddrinfo(const char *nodename, + const char *servname, + const struct addrinfo *hints, + struct addrinfo **res); + +#if LWIP_COMPAT_SOCKETS +#define gethostbyname(name) lwip_gethostbyname(name) +#define gethostbyname_r(name, ret, buf, buflen, result, h_errnop) \ + lwip_gethostbyname_r(name, ret, buf, buflen, result, h_errnop) +#define freeaddrinfo(addrinfo) lwip_freeaddrinfo(addrinfo) +#define getaddrinfo(nodname, servname, hints, res) \ + lwip_getaddrinfo(nodname, servname, hints, res) +#endif /* LWIP_COMPAT_SOCKETS */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_DNS && LWIP_SOCKET */ + +#endif /* LWIP_HDR_NETDB_H */ diff --git a/components/lwip/include/lwip/lwip/netif.h b/components/lwip/include/lwip/lwip/netif.h new file mode 100755 index 000000000..99066a5a1 --- /dev/null +++ b/components/lwip/include/lwip/lwip/netif.h @@ -0,0 +1,447 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_NETIF_H +#define LWIP_HDR_NETIF_H + +#include "lwip/opt.h" + +#define ENABLE_LOOPBACK (LWIP_NETIF_LOOPBACK || LWIP_HAVE_LOOPIF) + +#include "lwip/err.h" + +#include "lwip/ip_addr.h" + +#include "lwip/def.h" +#include "lwip/pbuf.h" +#include "lwip/stats.h" + +#if LWIP_DHCP +struct dhcp; +#endif +#if LWIP_AUTOIP +struct autoip; +#endif +#if LWIP_IPV6_DHCP6 +struct dhcp6; +#endif /* LWIP_IPV6_DHCP6 */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Throughout this file, IP addresses are expected to be in + * the same byte order as in IP_PCB. */ + +/** Must be the maximum of all used hardware address lengths + across all types of interfaces in use. + This does not have to be changed, normally. */ +#ifndef NETIF_MAX_HWADDR_LEN +#define NETIF_MAX_HWADDR_LEN 6U +#endif + +/** Whether the network interface is 'up'. This is + * a software flag used to control whether this network + * interface is enabled and processes traffic. + * It must be set by the startup code before this netif can be used + * (also for dhcp/autoip). + */ +#define NETIF_FLAG_UP 0x01U +/** If set, the netif has broadcast capability. + * Set by the netif driver in its init function. */ +#define NETIF_FLAG_BROADCAST 0x02U +/** If set, the interface has an active link + * (set by the network interface driver). + * Either set by the netif driver in its init function (if the link + * is up at that time) or at a later point once the link comes up + * (if link detection is supported by the hardware). */ +#define NETIF_FLAG_LINK_UP 0x04U +/** If set, the netif is an ethernet device using ARP. + * Set by the netif driver in its init function. + * Used to check input packet types and use of DHCP. */ +#define NETIF_FLAG_ETHARP 0x08U +/** If set, the netif is an ethernet device. It might not use + * ARP or TCP/IP if it is used for PPPoE only. + */ +#define NETIF_FLAG_ETHERNET 0x10U +/** If set, the netif has IGMP capability. + * Set by the netif driver in its init function. */ +#define NETIF_FLAG_IGMP 0x20U +/** If set, the netif has MLD6 capability. + * Set by the netif driver in its init function. */ +#define NETIF_FLAG_MLD6 0x40U + +#if LWIP_CHECKSUM_CTRL_PER_NETIF +#define NETIF_CHECKSUM_GEN_IP 0x0001 +#define NETIF_CHECKSUM_GEN_UDP 0x0002 +#define NETIF_CHECKSUM_GEN_TCP 0x0004 +#define NETIF_CHECKSUM_GEN_ICMP 0x0008 +#define NETIF_CHECKSUM_GEN_ICMP6 0x0010 +#define NETIF_CHECKSUM_CHECK_IP 0x0100 +#define NETIF_CHECKSUM_CHECK_UDP 0x0200 +#define NETIF_CHECKSUM_CHECK_TCP 0x0400 +#define NETIF_CHECKSUM_CHECK_ICMP 0x0800 +#define NETIF_CHECKSUM_CHECK_ICMP6 0x1000 +#define NETIF_CHECKSUM_ENABLE_ALL 0xFFFF +#define NETIF_CHECKSUM_DISABLE_ALL 0x0000 +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF */ + +struct netif; + +/** Function prototype for netif init functions. Set up flags and output/linkoutput + * callback functions in this function. + * + * @param netif The netif to initialize + */ +typedef err_t (*netif_init_fn)(struct netif *netif); +/** Function prototype for netif->input functions. This function is saved as 'input' + * callback function in the netif struct. Call it when a packet has been received. + * + * @param p The received packet, copied into a pbuf + * @param inp The netif which received the packet + */ +typedef err_t (*netif_input_fn)(struct pbuf *p, struct netif *inp); + +#if LWIP_IPV4 +/** Function prototype for netif->output functions. Called by lwIP when a packet + * shall be sent. For ethernet netif, set this to 'etharp_output' and set + * 'linkoutput'. + * + * @param netif The netif which shall send a packet + * @param p The packet to send (p->payload points to IP header) + * @param ipaddr The IP address to which the packet shall be sent + */ +typedef err_t (*netif_output_fn)(struct netif *netif, struct pbuf *p, + const ip4_addr_t *ipaddr); +#endif /* LWIP_IPV4*/ + +#if LWIP_IPV6 +/** Function prototype for netif->output_ip6 functions. Called by lwIP when a packet + * shall be sent. For ethernet netif, set this to 'ethip6_output' and set + * 'linkoutput'. + * + * @param netif The netif which shall send a packet + * @param p The packet to send (p->payload points to IP header) + * @param ipaddr The IPv6 address to which the packet shall be sent + */ +typedef err_t (*netif_output_ip6_fn)(struct netif *netif, struct pbuf *p, + const ip6_addr_t *ipaddr); +#endif /* LWIP_IPV6 */ + +/** Function prototype for netif->linkoutput functions. Only used for ethernet + * netifs. This function is called by ARP when a packet shall be sent. + * + * @param netif The netif which shall send a packet + * @param p The packet to send (raw ethernet packet) + */ +typedef err_t (*netif_linkoutput_fn)(struct netif *netif, struct pbuf *p); +/** Function prototype for netif status- or link-callback functions. */ +typedef void (*netif_status_callback_fn)(struct netif *netif); +#if LWIP_IPV4 && LWIP_IGMP +/** Function prototype for netif igmp_mac_filter functions */ +typedef err_t (*netif_igmp_mac_filter_fn)(struct netif *netif, + const ip4_addr_t *group, u8_t action); +#endif /* LWIP_IPV4 && LWIP_IGMP */ +#if LWIP_IPV6 && LWIP_IPV6_MLD +/** Function prototype for netif mld_mac_filter functions */ +typedef err_t (*netif_mld_mac_filter_fn)(struct netif *netif, + const ip6_addr_t *group, u8_t action); +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + + +#ifdef LWIP_ESP8266 +/*add DHCP event processing by LiuHan*/ +typedef void (*dhcp_event_fn)(void); +#endif + + +/** Generic data structure used for all lwIP network interfaces. + * The following fields should be filled in by the initialization + * function for the device driver: hwaddr_len, hwaddr[], mtu, flags */ +struct netif { + /** pointer to next in linked list */ + struct netif *next; + +#ifdef LWIP_ESP8266 +//ip_addr_t is changed by marco IPV4, IPV6 + ip_addr_t link_local_addr; +#endif + +#if LWIP_IPV4 + /** IP address configuration in network byte order */ + ip_addr_t ip_addr; + ip_addr_t netmask; + ip_addr_t gw; +#endif /* LWIP_IPV4 */ +#if LWIP_IPV6 + /** Array of IPv6 addresses for this netif. */ + ip_addr_t ip6_addr[LWIP_IPV6_NUM_ADDRESSES]; + /** The state of each IPv6 address (Tentative, Preferred, etc). + * @see ip6_addr.h */ + u8_t ip6_addr_state[LWIP_IPV6_NUM_ADDRESSES]; +#endif /* LWIP_IPV6 */ + /** This function is called by the network device driver + * to pass a packet up the TCP/IP stack. */ + netif_input_fn input; +#if LWIP_IPV4 + /** This function is called by the IP module when it wants + * to send a packet on the interface. This function typically + * first resolves the hardware address, then sends the packet. */ + netif_output_fn output; +#endif /* LWIP_IPV4 */ + /** This function is called by the ARP module when it wants + * to send a packet on the interface. This function outputs + * the pbuf as-is on the link medium. */ + netif_linkoutput_fn linkoutput; +#if LWIP_IPV6 + /** This function is called by the IPv6 module when it wants + * to send a packet on the interface. This function typically + * first resolves the hardware address, then sends the packet. */ + netif_output_ip6_fn output_ip6; +#endif /* LWIP_IPV6 */ +#if LWIP_NETIF_STATUS_CALLBACK + /** This function is called when the netif state is set to up or down + */ + netif_status_callback_fn status_callback; +#endif /* LWIP_NETIF_STATUS_CALLBACK */ +#if LWIP_NETIF_LINK_CALLBACK + /** This function is called when the netif link is set to up or down + */ + netif_status_callback_fn link_callback; +#endif /* LWIP_NETIF_LINK_CALLBACK */ +#if LWIP_NETIF_REMOVE_CALLBACK + /** This function is called when the netif has been removed */ + netif_status_callback_fn remove_callback; +#endif /* LWIP_NETIF_REMOVE_CALLBACK */ + /** This field can be set by the device driver and could point + * to state information for the device. */ + void *state; +#if LWIP_DHCP + /** the DHCP client state information for this netif */ + struct dhcp *dhcp; + +#ifdef LWIP_ESP8266 + struct udp_pcb *dhcps_pcb; + dhcp_event_fn dhcp_event; +#endif + +#endif /* LWIP_DHCP */ + +#if LWIP_AUTOIP + /** the AutoIP client state information for this netif */ + struct autoip *autoip; +#endif + +#if LWIP_IPV6_AUTOCONFIG + /** is this netif enabled for IPv6 autoconfiguration */ + u8_t ip6_autoconfig_enabled; +#endif /* LWIP_IPV6_AUTOCONFIG */ + +#if LWIP_IPV6_SEND_ROUTER_SOLICIT + /** Number of Router Solicitation messages that remain to be sent. */ + u8_t rs_count; +#endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ + +#if LWIP_IPV6_DHCP6 + /** the DHCPv6 client state information for this netif */ + struct dhcp6 *dhcp6; +#endif /* LWIP_IPV6_DHCP6 */ + +#if LWIP_NETIF_HOSTNAME + /* the hostname for this netif, NULL is a valid value */ + const char* hostname; +#endif /* LWIP_NETIF_HOSTNAME */ + +#if LWIP_CHECKSUM_CTRL_PER_NETIF + u16_t chksum_flags; +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF*/ + + /** maximum transfer unit (in bytes) */ + u16_t mtu; + /** number of bytes used in hwaddr */ + u8_t hwaddr_len; + /** link level hardware address of this interface */ + u8_t hwaddr[NETIF_MAX_HWADDR_LEN]; + /** flags (see NETIF_FLAG_ above) */ + u8_t flags; + /** descriptive abbreviation */ + char name[2]; + /** number of this interface */ + u8_t num; + +#if MIB2_STATS + /** link type (from "snmp_ifType" enum from snmp_mib2.h) */ + u8_t link_type; + /** (estimate) link speed */ + u32_t link_speed; + /** timestamp at last change made (up/down) */ + u32_t ts; + /** counters */ + struct stats_mib2_netif_ctrs mib2_counters; +#endif /* MIB2_STATS */ + +#if LWIP_IPV4 && LWIP_IGMP + /** This function could be called to add or delete an entry in the multicast + filter table of the ethernet MAC.*/ + netif_igmp_mac_filter_fn igmp_mac_filter; +#endif /* LWIP_IPV4 && LWIP_IGMP */ + +#if LWIP_IPV6 && LWIP_IPV6_MLD + /** This function could be called to add or delete an entry in the IPv6 multicast + filter table of the ethernet MAC. */ + netif_mld_mac_filter_fn mld_mac_filter; +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + +#if LWIP_NETIF_HWADDRHINT + u8_t *addr_hint; +#endif /* LWIP_NETIF_HWADDRHINT */ +#if ENABLE_LOOPBACK + /* List of packets to be queued for ourselves. */ + struct pbuf *loop_first; + struct pbuf *loop_last; +#if LWIP_LOOPBACK_MAX_PBUFS + u16_t loop_cnt_current; +#endif /* LWIP_LOOPBACK_MAX_PBUFS */ +#endif /* ENABLE_LOOPBACK */ +}; + +#if LWIP_CHECKSUM_CTRL_PER_NETIF +#define NETIF_SET_CHECKSUM_CTRL(netif, chksumflags) do { \ + (netif)->chksum_flags = chksumflags; } while(0) +#define IF__NETIF_CHECKSUM_ENABLED(netif, chksumflag) if (((netif) == NULL) || (((netif)->chksum_flags & (chksumflag)) != 0)) +#else /* LWIP_CHECKSUM_CTRL_PER_NETIF */ +#define NETIF_SET_CHECKSUM_CTRL(netif, chksumflags) +#define IF__NETIF_CHECKSUM_ENABLED(netif, chksumflag) +#endif /* LWIP_CHECKSUM_CTRL_PER_NETIF */ + +/** The list of network interfaces. */ +extern struct netif *netif_list; +/** The default network interface. */ +extern struct netif *netif_default; + +void netif_init(void); + +struct netif *netif_add(struct netif *netif, +#if LWIP_IPV4 + const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, const ip4_addr_t *gw, +#endif /* LWIP_IPV4 */ + void *state, netif_init_fn init, netif_input_fn input); +#if LWIP_IPV4 +void netif_set_addr(struct netif *netif, const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, + const ip4_addr_t *gw); +#endif /* LWIP_IPV4 */ +void netif_remove(struct netif * netif); + +/* Returns a network interface given its name. The name is of the form + "et0", where the first two letters are the "name" field in the + netif structure, and the digit is in the num field in the same + structure. */ +struct netif *netif_find(const char *name); + +void netif_set_default(struct netif *netif); + +#if LWIP_IPV4 +void netif_set_ipaddr(struct netif *netif, const ip4_addr_t *ipaddr); +void netif_set_netmask(struct netif *netif, const ip4_addr_t *netmask); +void netif_set_gw(struct netif *netif, const ip4_addr_t *gw); +#define netif_ip4_addr(netif) ((const ip4_addr_t*)ip_2_ip4(&((netif)->ip_addr))) +#define netif_ip4_netmask(netif) ((const ip4_addr_t*)ip_2_ip4(&((netif)->netmask))) +#define netif_ip4_gw(netif) ((const ip4_addr_t*)ip_2_ip4(&((netif)->gw))) +#define netif_ip_addr4(netif) ((const ip_addr_t*)&((netif)->ip_addr)) +#define netif_ip_gw4(netif) ((const ip_addr_t*)&((netif)->gw)) +#endif /* LWIP_IPV4 */ + +void netif_set_up(struct netif *netif); +void netif_set_down(struct netif *netif); +/** Ask if an interface is up */ +#define netif_is_up(netif) (((netif)->flags & NETIF_FLAG_UP) ? (u8_t)1 : (u8_t)0) + +#if LWIP_NETIF_STATUS_CALLBACK +void netif_set_status_callback(struct netif *netif, netif_status_callback_fn status_callback); +#endif /* LWIP_NETIF_STATUS_CALLBACK */ +#if LWIP_NETIF_REMOVE_CALLBACK +void netif_set_remove_callback(struct netif *netif, netif_status_callback_fn remove_callback); +#endif /* LWIP_NETIF_REMOVE_CALLBACK */ + +void netif_set_link_up(struct netif *netif); +void netif_set_link_down(struct netif *netif); +/** Ask if a link is up */ +#define netif_is_link_up(netif) (((netif)->flags & NETIF_FLAG_LINK_UP) ? (u8_t)1 : (u8_t)0) + +#if LWIP_NETIF_LINK_CALLBACK +void netif_set_link_callback(struct netif *netif, netif_status_callback_fn link_callback); +#endif /* LWIP_NETIF_LINK_CALLBACK */ + +#if LWIP_NETIF_HOSTNAME +#define netif_set_hostname(netif, name) do { if((netif) != NULL) { (netif)->hostname = name; }}while(0) +#define netif_get_hostname(netif) (((netif) != NULL) ? ((netif)->hostname) : NULL) +#endif /* LWIP_NETIF_HOSTNAME */ + +#if LWIP_IGMP +#define netif_set_igmp_mac_filter(netif, function) do { if((netif) != NULL) { (netif)->igmp_mac_filter = function; }}while(0) +#define netif_get_igmp_mac_filter(netif) (((netif) != NULL) ? ((netif)->igmp_mac_filter) : NULL) +#endif /* LWIP_IGMP */ + +#if LWIP_IPV6 && LWIP_IPV6_MLD +#define netif_set_mld_mac_filter(netif, function) do { if((netif) != NULL) { (netif)->mld_mac_filter = function; }}while(0) +#define netif_get_mld_mac_filter(netif) (((netif) != NULL) ? ((netif)->mld_mac_filter) : NULL) +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + +#if ENABLE_LOOPBACK +err_t netif_loop_output(struct netif *netif, struct pbuf *p); +void netif_poll(struct netif *netif); +#if !LWIP_NETIF_LOOPBACK_MULTITHREADING +void netif_poll_all(void); +#endif /* !LWIP_NETIF_LOOPBACK_MULTITHREADING */ +#endif /* ENABLE_LOOPBACK */ + +#if LWIP_IPV6 +#define netif_ip_addr6(netif, i) ((const ip_addr_t*)(&((netif)->ip6_addr[i]))) +#define netif_ip6_addr(netif, i) ((const ip6_addr_t*)ip_2_ip6(&((netif)->ip6_addr[i]))) +#define netif_ip6_addr_set(netif, i, addr6) do { ip6_addr_set(ip_2_ip6(&((netif)->ip6_addr[i])), addr6); IP_SET_TYPE_VAL((netif)->ip6_addr[i], IPADDR_TYPE_V6); } while(0) +#define netif_ip6_addr_state(netif, i) ((netif)->ip6_addr_state[i]) +#define netif_ip6_addr_set_state(netif, i, state) ((netif)->ip6_addr_state[i] = (state)) +s8_t netif_get_ip6_addr_match(struct netif *netif, const ip6_addr_t *ip6addr); +void netif_create_ip6_linklocal_address(struct netif *netif, u8_t from_mac_48bit); +err_t netif_add_ip6_address(struct netif *netif, const ip6_addr_t *ip6addr, s8_t *chosen_idx); +#endif /* LWIP_IPV6 */ + +#if LWIP_NETIF_HWADDRHINT +#define NETIF_SET_HWADDRHINT(netif, hint) ((netif)->addr_hint = (hint)) +#else /* LWIP_NETIF_HWADDRHINT */ +#define NETIF_SET_HWADDRHINT(netif, hint) +#endif /* LWIP_NETIF_HWADDRHINT */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_NETIF_H */ diff --git a/components/lwip/include/lwip/lwip/netifapi.h b/components/lwip/include/lwip/lwip/netifapi.h new file mode 100755 index 000000000..b09316be6 --- /dev/null +++ b/components/lwip/include/lwip/lwip/netifapi.h @@ -0,0 +1,108 @@ +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ +#ifndef LWIP_HDR_NETIFAPI_H +#define LWIP_HDR_NETIFAPI_H + +#include "lwip/opt.h" + +#if LWIP_NETIF_API /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/sys.h" +#include "lwip/netif.h" +#include "lwip/dhcp.h" +#include "lwip/autoip.h" +#include "lwip/priv/tcpip_priv.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if LWIP_MPU_COMPATIBLE +#define NETIFAPI_IPADDR_DEF(type, m) type m +#else /* LWIP_MPU_COMPATIBLE */ +#define NETIFAPI_IPADDR_DEF(type, m) const type * m +#endif /* LWIP_MPU_COMPATIBLE */ + +typedef void (*netifapi_void_fn)(struct netif *netif); +typedef err_t (*netifapi_errt_fn)(struct netif *netif); + +struct netifapi_msg { + struct tcpip_api_call call; + struct netif *netif; + union { + struct { +#if LWIP_IPV4 + NETIFAPI_IPADDR_DEF(ip4_addr_t, ipaddr); + NETIFAPI_IPADDR_DEF(ip4_addr_t, netmask); + NETIFAPI_IPADDR_DEF(ip4_addr_t, gw); +#endif /* LWIP_IPV4 */ + void *state; + netif_init_fn init; + netif_input_fn input; + } add; + struct { + netifapi_void_fn voidfunc; + netifapi_errt_fn errtfunc; + } common; + } msg; +}; + + +/* API for application */ +err_t netifapi_netif_add(struct netif *netif, +#if LWIP_IPV4 + const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, const ip4_addr_t *gw, +#endif /* LWIP_IPV4 */ + void *state, netif_init_fn init, netif_input_fn input); + +#if LWIP_IPV4 +err_t netifapi_netif_set_addr(struct netif *netif, const ip4_addr_t *ipaddr, + const ip4_addr_t *netmask, const ip4_addr_t *gw); +#endif /* LWIP_IPV4*/ + +err_t netifapi_netif_common(struct netif *netif, netifapi_void_fn voidfunc, + netifapi_errt_fn errtfunc); + +#define netifapi_netif_remove(n) netifapi_netif_common(n, netif_remove, NULL) +#define netifapi_netif_set_up(n) netifapi_netif_common(n, netif_set_up, NULL) +#define netifapi_netif_set_down(n) netifapi_netif_common(n, netif_set_down, NULL) +#define netifapi_netif_set_default(n) netifapi_netif_common(n, netif_set_default, NULL) +#define netifapi_dhcp_start(n) netifapi_netif_common(n, NULL, dhcp_start) +#define netifapi_dhcp_stop(n) netifapi_netif_common(n, dhcp_stop, NULL) +#define netifapi_dhcp_inform(n) netifapi_netif_common(n, dhcp_inform, NULL) +#define netifapi_dhcp_renew(n) netifapi_netif_common(n, NULL, dhcp_renew) +#define netifapi_dhcp_release(n) netifapi_netif_common(n, NULL, dhcp_release) +#define netifapi_autoip_start(n) netifapi_netif_common(n, NULL, autoip_start) +#define netifapi_autoip_stop(n) netifapi_netif_common(n, NULL, autoip_stop) + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_NETIF_API */ + +#endif /* LWIP_HDR_NETIFAPI_H */ diff --git a/components/lwip/include/lwip/lwip/opt.h b/components/lwip/include/lwip/lwip/opt.h new file mode 100755 index 000000000..76fff8805 --- /dev/null +++ b/components/lwip/include/lwip/lwip/opt.h @@ -0,0 +1,3015 @@ +/** + * @file + * + * lwIP Options Configuration + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_OPT_H +#define LWIP_HDR_OPT_H + +/* + * Include user defined options first. Anything not defined in these files + * will be set to standard values. Override anything you don't like! + */ +#include "lwipopts.h" +#include "lwip/debug.h" + +/* + ----------------------------------------------- + ---------- Platform specific locking ---------- + ----------------------------------------------- +*/ + +/** + * SYS_LIGHTWEIGHT_PROT==1: if you want inter-task protection for certain + * critical regions during buffer allocation, deallocation and memory + * allocation and deallocation. + */ +#ifndef SYS_LIGHTWEIGHT_PROT +#define SYS_LIGHTWEIGHT_PROT 0 +#endif + +/** + * NO_SYS==1: Provides VERY minimal functionality. Otherwise, + * use lwIP facilities. + */ +#ifndef NO_SYS +#define NO_SYS 0 +#endif + +/** + * NO_SYS_NO_TIMERS==1: Drop support for sys_timeout when NO_SYS==1 + * Mainly for compatibility to old versions. + */ +#ifndef NO_SYS_NO_TIMERS +#define NO_SYS_NO_TIMERS 0 +#endif + +/** + * MEMCPY: override this if you have a faster implementation at hand than the + * one included in your C library + */ +#ifndef MEMCPY +#define MEMCPY(dst,src,len) memcpy(dst,src,len) +#endif + +/** + * SMEMCPY: override this with care! Some compilers (e.g. gcc) can inline a + * call to memcpy() if the length is known at compile time and is small. + */ +#ifndef SMEMCPY +#define SMEMCPY(dst,src,len) memcpy(dst,src,len) +#endif + +/** + * LWIP_MPU_COMPATIBLE: enables special memory management mechanism + * which makes lwip able to work on MPU (Memory Protection Unit) system + * by not passing stack-pointers to other threads + * (this decreases performance) + */ +#ifndef LWIP_MPU_COMPATIBLE +#define LWIP_MPU_COMPATIBLE 0 +#endif + +/* + ------------------------------------ + ---------- Memory options ---------- + ------------------------------------ +*/ +/** + * MEM_LIBC_MALLOC==1: Use malloc/free/realloc provided by your C-library + * instead of the lwip internal allocator. Can save code size if you + * already use it. + */ +#ifndef MEM_LIBC_MALLOC +#define MEM_LIBC_MALLOC 0 +#endif + +/** +* MEMP_MEM_MALLOC==1: Use mem_malloc/mem_free instead of the lwip pool allocator. +* Especially useful with MEM_LIBC_MALLOC but handle with care regarding execution +* speed and usage from interrupts! +*/ +#ifndef MEMP_MEM_MALLOC +#define MEMP_MEM_MALLOC 0 +#endif + +/** + * MEM_ALIGNMENT: should be set to the alignment of the CPU + * 4 byte alignment -> #define MEM_ALIGNMENT 4 + * 2 byte alignment -> #define MEM_ALIGNMENT 2 + */ +#ifndef MEM_ALIGNMENT +#define MEM_ALIGNMENT 1 +#endif + +/** + * MEM_SIZE: the size of the heap memory. If the application will send + * a lot of data that needs to be copied, this should be set high. + */ +#ifndef MEM_SIZE +#define MEM_SIZE 1600 +#endif + +/** + * MEMP_OVERFLOW_CHECK: memp overflow protection reserves a configurable + * amount of bytes before and after each memp element in every pool and fills + * it with a prominent default value. + * MEMP_OVERFLOW_CHECK == 0 no checking + * MEMP_OVERFLOW_CHECK == 1 checks each element when it is freed + * MEMP_OVERFLOW_CHECK >= 2 checks each element in every pool every time + * memp_malloc() or memp_free() is called (useful but slow!) + */ +#ifndef MEMP_OVERFLOW_CHECK +#define MEMP_OVERFLOW_CHECK 0 +#endif + +/** + * MEMP_SANITY_CHECK==1: run a sanity check after each memp_free() to make + * sure that there are no cycles in the linked lists. + */ +#ifndef MEMP_SANITY_CHECK +#define MEMP_SANITY_CHECK 0 +#endif + +/** + * MEM_USE_POOLS==1: Use an alternative to malloc() by allocating from a set + * of memory pools of various sizes. When mem_malloc is called, an element of + * the smallest pool that can provide the length needed is returned. + * To use this, MEMP_USE_CUSTOM_POOLS also has to be enabled. + */ +#ifndef MEM_USE_POOLS +#define MEM_USE_POOLS 0 +#endif + +/** + * MEM_USE_POOLS_TRY_BIGGER_POOL==1: if one malloc-pool is empty, try the next + * bigger pool - WARNING: THIS MIGHT WASTE MEMORY but it can make a system more + * reliable. */ +#ifndef MEM_USE_POOLS_TRY_BIGGER_POOL +#define MEM_USE_POOLS_TRY_BIGGER_POOL 0 +#endif + +/** + * MEMP_USE_CUSTOM_POOLS==1: whether to include a user file lwippools.h + * that defines additional pools beyond the "standard" ones required + * by lwIP. If you set this to 1, you must have lwippools.h in your + * include path somewhere. + */ +#ifndef MEMP_USE_CUSTOM_POOLS +#define MEMP_USE_CUSTOM_POOLS 0 +#endif + +/** + * Set this to 1 if you want to free PBUF_RAM pbufs (or call mem_free()) from + * interrupt context (or another context that doesn't allow waiting for a + * semaphore). + * If set to 1, mem_malloc will be protected by a semaphore and SYS_ARCH_PROTECT, + * while mem_free will only use SYS_ARCH_PROTECT. mem_malloc SYS_ARCH_UNPROTECTs + * with each loop so that mem_free can run. + * + * ATTENTION: As you can see from the above description, this leads to dis-/ + * enabling interrupts often, which can be slow! Also, on low memory, mem_malloc + * can need longer. + * + * If you don't want that, at least for NO_SYS=0, you can still use the following + * functions to enqueue a deallocation call which then runs in the tcpip_thread + * context: + * - pbuf_free_callback(p); + * - mem_free_callback(m); + */ +#ifndef LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT +#define LWIP_ALLOW_MEM_FREE_FROM_OTHER_CONTEXT 0 +#endif + +/* + ------------------------------------------------ + ---------- Internal Memory Pool Sizes ---------- + ------------------------------------------------ +*/ +/** + * MEMP_NUM_PBUF: the number of memp struct pbufs (used for PBUF_ROM and PBUF_REF). + * If the application sends a lot of data out of ROM (or other static memory), + * this should be set high. + */ +#ifndef MEMP_NUM_PBUF +#define MEMP_NUM_PBUF 16 +#endif + +/** + * MEMP_NUM_RAW_PCB: Number of raw connection PCBs + * (requires the LWIP_RAW option) + */ +#ifndef MEMP_NUM_RAW_PCB +#define MEMP_NUM_RAW_PCB 4 +#endif + +/** + * MEMP_NUM_UDP_PCB: the number of UDP protocol control blocks. One + * per active UDP "connection". + * (requires the LWIP_UDP option) + */ +#ifndef MEMP_NUM_UDP_PCB +#define MEMP_NUM_UDP_PCB 4 +#endif + +/** + * MEMP_NUM_TCP_PCB: the number of simultaneously active TCP connections. + * (requires the LWIP_TCP option) + */ +#ifndef MEMP_NUM_TCP_PCB +#define MEMP_NUM_TCP_PCB 5 +#endif + +/** + * MEMP_NUM_TCP_PCB_LISTEN: the number of listening TCP connections. + * (requires the LWIP_TCP option) + */ +#ifndef MEMP_NUM_TCP_PCB_LISTEN +#define MEMP_NUM_TCP_PCB_LISTEN 8 +#endif + +/** + * MEMP_NUM_TCP_SEG: the number of simultaneously queued TCP segments. + * (requires the LWIP_TCP option) + */ +#ifndef MEMP_NUM_TCP_SEG +#define MEMP_NUM_TCP_SEG 16 +#endif + +/** + * MEMP_NUM_REASSDATA: the number of IP packets simultaneously queued for + * reassembly (whole packets, not fragments!) + */ +#ifndef MEMP_NUM_REASSDATA +#define MEMP_NUM_REASSDATA 5 +#endif + +/** + * MEMP_NUM_FRAG_PBUF: the number of IP fragments simultaneously sent + * (fragments, not whole packets!). + * This is only used with IP_FRAG_USES_STATIC_BUF==0 and + * LWIP_NETIF_TX_SINGLE_PBUF==0 and only has to be > 1 with DMA-enabled MACs + * where the packet is not yet sent when netif->output returns. + */ +#ifndef MEMP_NUM_FRAG_PBUF +#define MEMP_NUM_FRAG_PBUF 15 +#endif + +/** + * MEMP_NUM_ARP_QUEUE: the number of simultaneously queued outgoing + * packets (pbufs) that are waiting for an ARP request (to resolve + * their destination address) to finish. + * (requires the ARP_QUEUEING option) + */ +#ifndef MEMP_NUM_ARP_QUEUE +#define MEMP_NUM_ARP_QUEUE 30 +#endif + +/** + * MEMP_NUM_IGMP_GROUP: The number of multicast groups whose network interfaces + * can be members at the same time (one per netif - allsystems group -, plus one + * per netif membership). + * (requires the LWIP_IGMP option) + */ +#ifndef MEMP_NUM_IGMP_GROUP +#define MEMP_NUM_IGMP_GROUP 8 +#endif + +/** + * MEMP_NUM_SYS_TIMEOUT: the number of simultaneously active timeouts. + * The default number of timeouts is calculated here for all enabled modules. + * The formula expects settings to be either '0' or '1'. + */ +#ifndef MEMP_NUM_SYS_TIMEOUT +#define MEMP_NUM_SYS_TIMEOUT (LWIP_TCP + IP_REASSEMBLY + LWIP_ARP + (2*LWIP_DHCP) + LWIP_AUTOIP + LWIP_IGMP + LWIP_DNS + (PPP_SUPPORT*6*MEMP_NUM_PPP_PCB) + (LWIP_IPV6 ? (1 + LWIP_IPV6_REASS + LWIP_IPV6_MLD) : 0)) +#endif + +/** + * MEMP_NUM_NETBUF: the number of struct netbufs. + * (only needed if you use the sequential API, like api_lib.c) + */ +#ifndef MEMP_NUM_NETBUF +#define MEMP_NUM_NETBUF 2 +#endif + +/** + * MEMP_NUM_NETCONN: the number of struct netconns. + * (only needed if you use the sequential API, like api_lib.c) + */ +#ifndef MEMP_NUM_NETCONN +#define MEMP_NUM_NETCONN 4 +#endif + +/** + * MEMP_NUM_TCPIP_MSG_API: the number of struct tcpip_msg, which are used + * for callback/timeout API communication. + * (only needed if you use tcpip.c) + */ +#ifndef MEMP_NUM_TCPIP_MSG_API +#define MEMP_NUM_TCPIP_MSG_API 8 +#endif + +/** + * MEMP_NUM_TCPIP_MSG_INPKT: the number of struct tcpip_msg, which are used + * for incoming packets. + * (only needed if you use tcpip.c) + */ +#ifndef MEMP_NUM_TCPIP_MSG_INPKT +#define MEMP_NUM_TCPIP_MSG_INPKT 8 +#endif + +/** + * MEMP_NUM_NETDB: the number of concurrently running lwip_addrinfo() calls + * (before freeing the corresponding memory using lwip_freeaddrinfo()). + */ +#ifndef MEMP_NUM_NETDB +#define MEMP_NUM_NETDB 1 +#endif + +/** + * MEMP_NUM_LOCALHOSTLIST: the number of host entries in the local host list + * if DNS_LOCAL_HOSTLIST_IS_DYNAMIC==1. + */ +#ifndef MEMP_NUM_LOCALHOSTLIST +#define MEMP_NUM_LOCALHOSTLIST 1 +#endif + +/** + * MEMP_NUM_PPP_PCB: the number of simultaneously active PPP + * connections (requires the PPP_SUPPORT option) + */ +#ifndef MEMP_NUM_PPP_PCB +#define MEMP_NUM_PPP_PCB 1 +#endif + +/** + * MEMP_NUM_PPPOS_INTERFACES: the number of concurrently active PPPoS + * interfaces (only used with PPPOS_SUPPORT==1) + */ +#ifndef MEMP_NUM_PPPOS_INTERFACES +#define MEMP_NUM_PPPOS_INTERFACES MEMP_NUM_PPP_PCB +#endif + +/** + * MEMP_NUM_PPPOE_INTERFACES: the number of concurrently active PPPoE + * interfaces (only used with PPPOE_SUPPORT==1) + */ +#ifndef MEMP_NUM_PPPOE_INTERFACES +#define MEMP_NUM_PPPOE_INTERFACES 1 +#endif + +/** + * MEMP_NUM_PPPOL2TP_INTERFACES: the number of concurrently active PPPoL2TP + * interfaces (only used with PPPOL2TP_SUPPORT==1) + */ +#ifndef MEMP_NUM_PPPOL2TP_INTERFACES +#define MEMP_NUM_PPPOL2TP_INTERFACES 1 +#endif + +/** + * PBUF_POOL_SIZE: the number of buffers in the pbuf pool. + */ +#ifndef PBUF_POOL_SIZE +#define PBUF_POOL_SIZE 16 +#endif + +/** MEMP_NUM_API_MSG: the number of concurrently active calls to various + * socket, netconn, and tcpip functions + */ +#ifndef MEMP_NUM_API_MSG +#define MEMP_NUM_API_MSG MEMP_NUM_TCPIP_MSG_API +#endif + +/** MEMP_NUM_DNS_API_MSG: the number of concurrently active calls to netconn_gethostbyname + */ +#ifndef MEMP_NUM_DNS_API_MSG +#define MEMP_NUM_DNS_API_MSG MEMP_NUM_TCPIP_MSG_API +#endif + +/** MEMP_NUM_SOCKET_SETGETSOCKOPT_DATA: the number of concurrently active calls + * to getsockopt/setsockopt + */ +#ifndef MEMP_NUM_SOCKET_SETGETSOCKOPT_DATA +#define MEMP_NUM_SOCKET_SETGETSOCKOPT_DATA MEMP_NUM_TCPIP_MSG_API +#endif + +/** MEMP_NUM_NETIFAPI_MSG: the number of concurrently active calls to the + * netifapi functions + */ +#ifndef MEMP_NUM_NETIFAPI_MSG +#define MEMP_NUM_NETIFAPI_MSG MEMP_NUM_TCPIP_MSG_API +#endif + +/* + --------------------------------- + ---------- ARP options ---------- + --------------------------------- +*/ +/** + * LWIP_ARP==1: Enable ARP functionality. + */ +#ifndef LWIP_ARP +#define LWIP_ARP 1 +#endif + +/** + * ARP_TABLE_SIZE: Number of active MAC-IP address pairs cached. + */ +#ifndef ARP_TABLE_SIZE +#define ARP_TABLE_SIZE 10 +#endif + +/** the time an ARP entry stays valid after its last update, + * for ARP_TMR_INTERVAL = 1000, this is + * (60 * 5) seconds = 5 minutes. + */ +#ifndef ARP_MAXAGE +#define ARP_MAXAGE 300 +#endif + +/** + * ARP_QUEUEING==1: Multiple outgoing packets are queued during hardware address + * resolution. By default, only the most recent packet is queued per IP address. + * This is sufficient for most protocols and mainly reduces TCP connection + * startup time. Set this to 1 if you know your application sends more than one + * packet in a row to an IP address that is not in the ARP cache. + */ +#ifndef ARP_QUEUEING +#define ARP_QUEUEING 0 +#endif + +/** The maximum number of packets which may be queued for each + * unresolved address by other network layers. Defaults to 3, 0 means disabled. + * Old packets are dropped, new packets are queued. + */ +#ifndef ARP_QUEUE_LEN +#define ARP_QUEUE_LEN 3 +#endif + +/** + * ETHARP_TRUST_IP_MAC==1: Incoming IP packets cause the ARP table to be + * updated with the source MAC and IP addresses supplied in the packet. + * You may want to disable this if you do not trust LAN peers to have the + * correct addresses, or as a limited approach to attempt to handle + * spoofing. If disabled, lwIP will need to make a new ARP request if + * the peer is not already in the ARP table, adding a little latency. + * The peer *is* in the ARP table if it requested our address before. + * Also notice that this slows down input processing of every IP packet! + */ +#ifndef ETHARP_TRUST_IP_MAC +#define ETHARP_TRUST_IP_MAC 0 +#endif + +/** + * ETHARP_SUPPORT_VLAN==1: support receiving and sending ethernet packets with + * VLAN header. See the description of LWIP_HOOK_VLAN_CHECK and + * LWIP_HOOK_VLAN_SET hooks to check/set VLAN headers. + * Additionally, you can define ETHARP_VLAN_CHECK to an u16_t VLAN ID to check. + * If ETHARP_VLAN_CHECK is defined, only VLAN-traffic for this VLAN is accepted. + * If ETHARP_VLAN_CHECK is not defined, all traffic is accepted. + * Alternatively, define a function/define ETHARP_VLAN_CHECK_FN(eth_hdr, vlan) + * that returns 1 to accept a packet or 0 to drop a packet. + */ +#ifndef ETHARP_SUPPORT_VLAN +#define ETHARP_SUPPORT_VLAN 0 +#endif + +/** LWIP_ETHERNET==1: enable ethernet support for PPPoE even though ARP + * might be disabled + */ +#ifndef LWIP_ETHERNET +#define LWIP_ETHERNET (LWIP_ARP || PPPOE_SUPPORT) +#endif + +/** ETH_PAD_SIZE: number of bytes added before the ethernet header to ensure + * alignment of payload after that header. Since the header is 14 bytes long, + * without this padding e.g. addresses in the IP header will not be aligned + * on a 32-bit boundary, so setting this to 2 can speed up 32-bit-platforms. + */ +#ifndef ETH_PAD_SIZE +#define ETH_PAD_SIZE 0 +#endif + +/** ETHARP_SUPPORT_STATIC_ENTRIES==1: enable code to support static ARP table + * entries (using etharp_add_static_entry/etharp_remove_static_entry). + */ +#ifndef ETHARP_SUPPORT_STATIC_ENTRIES +#define ETHARP_SUPPORT_STATIC_ENTRIES 0 +#endif + +/** ETHARP_TABLE_MATCH_NETIF==1: Match netif for ARP table entries. + * If disabled, duplicate IP address on multiple netifs are not supported + * (but this should only occur for AutoIP). + */ +#ifndef ETHARP_TABLE_MATCH_NETIF +#define ETHARP_TABLE_MATCH_NETIF 0 +#endif + +/* + -------------------------------- + ---------- IP options ---------- + -------------------------------- +*/ +/** + * LWIP_IPV4==1: Enable IPv4 + */ +#ifndef LWIP_IPV4 +#define LWIP_IPV4 1 +#endif + +/** + * IP_FORWARD==1: Enables the ability to forward IP packets across network + * interfaces. If you are going to run lwIP on a device with only one network + * interface, define this to 0. + */ +#ifndef IP_FORWARD +#define IP_FORWARD 0 +#endif + +/** + * IP_REASSEMBLY==1: Reassemble incoming fragmented IP packets. Note that + * this option does not affect outgoing packet sizes, which can be controlled + * via IP_FRAG. + */ +#ifndef IP_REASSEMBLY +#define IP_REASSEMBLY 1 +#endif + +/** + * IP_FRAG==1: Fragment outgoing IP packets if their size exceeds MTU. Note + * that this option does not affect incoming packet sizes, which can be + * controlled via IP_REASSEMBLY. + */ +#ifndef IP_FRAG +#define IP_FRAG 1 +#endif + +#if !LWIP_IPV4 +/* disable IPv4 extensions when IPv4 is disabled */ +#undef IP_FORWARD +#define IP_FORWARD 0 +#undef IP_REASSEMBLY +#define IP_REASSEMBLY 0 +#undef IP_FRAG +#define IP_FRAG 0 +#endif /* !LWIP_IPV4 */ + +/** + * IP_OPTIONS_ALLOWED: Defines the behavior for IP options. + * IP_OPTIONS_ALLOWED==0: All packets with IP options are dropped. + * IP_OPTIONS_ALLOWED==1: IP options are allowed (but not parsed). + */ +#ifndef IP_OPTIONS_ALLOWED +#define IP_OPTIONS_ALLOWED 1 +#endif + +/** + * IP_REASS_MAXAGE: Maximum time (in multiples of IP_TMR_INTERVAL - so seconds, normally) + * a fragmented IP packet waits for all fragments to arrive. If not all fragments arrived + * in this time, the whole packet is discarded. + */ +#ifndef IP_REASS_MAXAGE +#define IP_REASS_MAXAGE 3 +#endif + +/** + * IP_REASS_MAX_PBUFS: Total maximum amount of pbufs waiting to be reassembled. + * Since the received pbufs are enqueued, be sure to configure + * PBUF_POOL_SIZE > IP_REASS_MAX_PBUFS so that the stack is still able to receive + * packets even if the maximum amount of fragments is enqueued for reassembly! + */ +#ifndef IP_REASS_MAX_PBUFS +#define IP_REASS_MAX_PBUFS 10 +#endif + +/** + * IP_FRAG_USES_STATIC_BUF==1: Use a static MTU-sized buffer for IP + * fragmentation. Otherwise pbufs are allocated and reference the original + * packet data to be fragmented (or with LWIP_NETIF_TX_SINGLE_PBUF==1, + * new PBUF_RAM pbufs are used for fragments). + * ATTENTION: IP_FRAG_USES_STATIC_BUF==1 may not be used for DMA-enabled MACs! + */ +#ifndef IP_FRAG_USES_STATIC_BUF +#define IP_FRAG_USES_STATIC_BUF 0 +#endif + +/** + * IP_FRAG_MAX_MTU: Assumed max MTU on any interface for IP frag buffer + * (requires IP_FRAG_USES_STATIC_BUF==1) + */ +#if IP_FRAG_USES_STATIC_BUF && !defined(IP_FRAG_MAX_MTU) +#define IP_FRAG_MAX_MTU 1500 +#endif + +/** + * IP_DEFAULT_TTL: Default value for Time-To-Live used by transport layers. + */ +#ifndef IP_DEFAULT_TTL +#define IP_DEFAULT_TTL 255 +#endif + +/** + * IP_SOF_BROADCAST=1: Use the SOF_BROADCAST field to enable broadcast + * filter per pcb on udp and raw send operations. To enable broadcast filter + * on recv operations, you also have to set IP_SOF_BROADCAST_RECV=1. + */ +#ifndef IP_SOF_BROADCAST +#define IP_SOF_BROADCAST 0 +#endif + +/** + * IP_SOF_BROADCAST_RECV (requires IP_SOF_BROADCAST=1) enable the broadcast + * filter on recv operations. + */ +#ifndef IP_SOF_BROADCAST_RECV +#define IP_SOF_BROADCAST_RECV 0 +#endif + +/** + * IP_FORWARD_ALLOW_TX_ON_RX_NETIF==1: allow ip_forward() to send packets back + * out on the netif where it was received. This should only be used for + * wireless networks. + * ATTENTION: When this is 1, make sure your netif driver correctly marks incoming + * link-layer-broadcast/multicast packets as such using the corresponding pbuf flags! + */ +#ifndef IP_FORWARD_ALLOW_TX_ON_RX_NETIF +#define IP_FORWARD_ALLOW_TX_ON_RX_NETIF 0 +#endif + +/** + * LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS==1: randomize the local port for the first + * local TCP/UDP pcb (default==0). This can prevent creating predictable port + * numbers after booting a device. + */ +#ifndef LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS +#define LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS 0 +#endif + +/* + ---------------------------------- + ---------- ICMP options ---------- + ---------------------------------- +*/ +/** + * LWIP_ICMP==1: Enable ICMP module inside the IP stack. + * Be careful, disable that make your product non-compliant to RFC1122 + */ +#ifndef LWIP_ICMP +#define LWIP_ICMP 1 +#endif + +/** + * ICMP_TTL: Default value for Time-To-Live used by ICMP packets. + */ +#ifndef ICMP_TTL +#define ICMP_TTL (IP_DEFAULT_TTL) +#endif + +/** + * LWIP_BROADCAST_PING==1: respond to broadcast pings (default is unicast only) + */ +#ifndef LWIP_BROADCAST_PING +#define LWIP_BROADCAST_PING 0 +#endif + +/** + * LWIP_MULTICAST_PING==1: respond to multicast pings (default is unicast only) + */ +#ifndef LWIP_MULTICAST_PING +#define LWIP_MULTICAST_PING 0 +#endif + +/* + --------------------------------- + ---------- RAW options ---------- + --------------------------------- +*/ +/** + * LWIP_RAW==1: Enable application layer to hook into the IP layer itself. + */ +#ifndef LWIP_RAW +#define LWIP_RAW 0 +#endif + +/** + * LWIP_RAW==1: Enable application layer to hook into the IP layer itself. + */ +#ifndef RAW_TTL +#define RAW_TTL (IP_DEFAULT_TTL) +#endif + +/* + ---------------------------------- + ---------- DHCP options ---------- + ---------------------------------- +*/ +/** + * LWIP_DHCP==1: Enable DHCP module. + */ +#ifndef LWIP_DHCP +#define LWIP_DHCP 0 +#endif +#if !LWIP_IPV4 +/* disable DHCP when IPv4 is disabled */ +#undef LWIP_DHCP +#define LWIP_DHCP 0 +#endif /* !LWIP_IPV4 */ + +/** + * DHCP_DOES_ARP_CHECK==1: Do an ARP check on the offered address. + */ +#ifndef DHCP_DOES_ARP_CHECK +#define DHCP_DOES_ARP_CHECK ((LWIP_DHCP) && (LWIP_ARP)) +#endif + +/** + * LWIP_DHCP_CHECK_LINK_UP==1: dhcp_start() only really starts if the netif has + * NETIF_FLAG_LINK_UP set in its flags. As this is only an optimization and + * netif drivers might not set this flag, the default is off. If enabled, + * netif_set_link_up() must be called to continue dhcp starting. + */ +#ifndef LWIP_DHCP_CHECK_LINK_UP +#define LWIP_DHCP_CHECK_LINK_UP 0 +#endif + +/** + * LWIP_DHCP_BOOTP_FILE==1: Store offered_si_addr and boot_file_name. + */ +#ifndef LWIP_DHCP_BOOTP_FILE +#define LWIP_DHCP_BOOTP_FILE 0 +#endif + +/** + * LWIP_DHCP_GETS_NTP==1: Request NTP servers with discover/select. For each + * response packet, an callback is called, which has to be provided by the port: + * void dhcp_set_ntp_servers(u8_t num_ntp_servers, ip_addr_t* ntp_server_addrs); +*/ +#ifndef LWIP_DHCP_GET_NTP_SRV +#define LWIP_DHCP_GET_NTP_SRV 0 +#endif + +/** + * The maximum of NTP servers requested + */ +#ifndef LWIP_DHCP_MAX_NTP_SERVERS +#define LWIP_DHCP_MAX_NTP_SERVERS 1 +#endif + +/* + ------------------------------------ + ---------- AUTOIP options ---------- + ------------------------------------ +*/ +/** + * LWIP_AUTOIP==1: Enable AUTOIP module. + */ +#ifndef LWIP_AUTOIP +#define LWIP_AUTOIP 0 +#endif +#if !LWIP_IPV4 +/* disable AUTOIP when IPv4 is disabled */ +#undef LWIP_AUTOIP +#define LWIP_AUTOIP 0 +#endif /* !LWIP_IPV4 */ + +/** + * LWIP_DHCP_AUTOIP_COOP==1: Allow DHCP and AUTOIP to be both enabled on + * the same interface at the same time. + */ +#ifndef LWIP_DHCP_AUTOIP_COOP +#define LWIP_DHCP_AUTOIP_COOP 0 +#endif + +/** + * LWIP_DHCP_AUTOIP_COOP_TRIES: Set to the number of DHCP DISCOVER probes + * that should be sent before falling back on AUTOIP. This can be set + * as low as 1 to get an AutoIP address very quickly, but you should + * be prepared to handle a changing IP address when DHCP overrides + * AutoIP. + */ +#ifndef LWIP_DHCP_AUTOIP_COOP_TRIES +#define LWIP_DHCP_AUTOIP_COOP_TRIES 9 +#endif + +/* + ---------------------------------- + ----- SNMP MIB2 support ----- + ---------------------------------- +*/ +/** + * LWIP_MIB2_CALLBACKS==1: Turn on SNMP MIB2 callbacks. + * Turn this on to get callbacks needed to implement MIB2. + * Usually MIB2_STATS should be enabled, too. + */ +#ifndef LWIP_MIB2_CALLBACKS +#define LWIP_MIB2_CALLBACKS 0 +#endif + +/* + ---------------------------------- + ----- Multicast/IGMP options ----- + ---------------------------------- +*/ +/** + * LWIP_IGMP==1: Turn on IGMP module. + */ +#ifndef LWIP_IGMP +#define LWIP_IGMP 1 +#endif +#if !LWIP_IPV4 +#undef LWIP_IGMP +#define LWIP_IGMP 0 +#endif + +/** + * LWIP_MULTICAST_TX_OPTIONS==1: Enable multicast TX support like the socket options + * IP_MULTICAST_TTL/IP_MULTICAST_IF/IP_MULTICAST_LOOP + */ +#ifndef LWIP_MULTICAST_TX_OPTIONS +#define LWIP_MULTICAST_TX_OPTIONS LWIP_IGMP +#endif + +/* + ---------------------------------- + ---------- DNS options ----------- + ---------------------------------- +*/ +/** + * LWIP_DNS==1: Turn on DNS module. UDP must be available for DNS + * transport. + */ +#ifndef LWIP_DNS +#define LWIP_DNS 0 +#endif + +/** DNS maximum number of entries to maintain locally. */ +#ifndef DNS_TABLE_SIZE +#define DNS_TABLE_SIZE 4 +#endif + +/** DNS maximum host name length supported in the name table. */ +#ifndef DNS_MAX_NAME_LENGTH +#define DNS_MAX_NAME_LENGTH 256 +#endif + +/** The maximum of DNS servers + * The first server can be initialized automatically by defining + * DNS_SERVER_ADDRESS(ipaddr), where 'ipaddr' is an 'ip_addr_t*' + */ +#ifndef DNS_MAX_SERVERS +#define DNS_MAX_SERVERS 2 +#endif + +/** DNS do a name checking between the query and the response. */ +#ifndef DNS_DOES_NAME_CHECK +#define DNS_DOES_NAME_CHECK 1 +#endif + +/** LWIP_DNS_SECURE: controls the security level of the DNS implementation + * Use all DNS security features by default. + * This is overridable but should only be needed by very small targets + * or when using against non standard DNS servers. */ +#ifndef LWIP_DNS_SECURE +#define LWIP_DNS_SECURE (LWIP_DNS_SECURE_RAND_XID | LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING | LWIP_DNS_SECURE_RAND_SRC_PORT) +#endif +/* A list of DNS security features follows */ +#define LWIP_DNS_SECURE_RAND_XID 1 +#define LWIP_DNS_SECURE_NO_MULTIPLE_OUTSTANDING 2 +#define LWIP_DNS_SECURE_RAND_SRC_PORT 4 + +/** DNS_LOCAL_HOSTLIST: Implements a local host-to-address list. If enabled, + * you have to define + * #define DNS_LOCAL_HOSTLIST_INIT {{"host1", 0x123}, {"host2", 0x234}} + * (an array of structs name/address, where address is an u32_t in network + * byte order). + * + * Instead, you can also use an external function: + * #define DNS_LOOKUP_LOCAL_EXTERN(x) extern u32_t my_lookup_function(const char *name) + * that returns the IP address or INADDR_NONE if not found. + */ +#ifndef DNS_LOCAL_HOSTLIST +#define DNS_LOCAL_HOSTLIST 0 +#endif /* DNS_LOCAL_HOSTLIST */ + +/** If this is turned on, the local host-list can be dynamically changed + * at runtime. */ +#ifndef DNS_LOCAL_HOSTLIST_IS_DYNAMIC +#define DNS_LOCAL_HOSTLIST_IS_DYNAMIC 0 +#endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + +/* + --------------------------------- + ---------- UDP options ---------- + --------------------------------- +*/ +/** + * LWIP_UDP==1: Turn on UDP. + */ +#ifndef LWIP_UDP +#define LWIP_UDP 1 +#endif + +/** + * LWIP_UDPLITE==1: Turn on UDP-Lite. (Requires LWIP_UDP) + */ +#ifndef LWIP_UDPLITE +#define LWIP_UDPLITE 0 +#endif + +/** + * UDP_TTL: Default Time-To-Live value. + */ +#ifndef UDP_TTL +#define UDP_TTL (IP_DEFAULT_TTL) +#endif + +/** + * LWIP_NETBUF_RECVINFO==1: append destination addr and port to every netbuf. + */ +#ifndef LWIP_NETBUF_RECVINFO +#define LWIP_NETBUF_RECVINFO 0 +#endif + +/* + --------------------------------- + ---------- TCP options ---------- + --------------------------------- +*/ +/** + * LWIP_TCP==1: Turn on TCP. + */ +#ifndef LWIP_TCP +#define LWIP_TCP 1 +#endif + +/** + * TCP_TTL: Default Time-To-Live value. + */ +#ifndef TCP_TTL +#define TCP_TTL (IP_DEFAULT_TTL) +#endif + +/** + * TCP_WND: The size of a TCP window. This must be at least + * (2 * TCP_MSS) for things to work well + */ +#ifndef TCP_WND +#define TCP_WND (4 * TCP_MSS) +#endif + +/** + * TCP_MAXRTX: Maximum number of retransmissions of data segments. + */ +#ifndef TCP_MAXRTX +#define TCP_MAXRTX 12 +#endif + +/** + * TCP_SYNMAXRTX: Maximum number of retransmissions of SYN segments. + */ +#ifndef TCP_SYNMAXRTX +#define TCP_SYNMAXRTX 6 +#endif + +/** + * TCP_QUEUE_OOSEQ==1: TCP will queue segments that arrive out of order. + * Define to 0 if your device is low on memory. + */ +#ifndef TCP_QUEUE_OOSEQ +#define TCP_QUEUE_OOSEQ (LWIP_TCP) +#endif + +/** + * TCP_MSS: TCP Maximum segment size. (default is 536, a conservative default, + * you might want to increase this.) + * For the receive side, this MSS is advertised to the remote side + * when opening a connection. For the transmit size, this MSS sets + * an upper limit on the MSS advertised by the remote host. + */ +#ifndef TCP_MSS +#define TCP_MSS 536 +#endif + +/** + * TCP_CALCULATE_EFF_SEND_MSS: "The maximum size of a segment that TCP really + * sends, the 'effective send MSS,' MUST be the smaller of the send MSS (which + * reflects the available reassembly buffer size at the remote host) and the + * largest size permitted by the IP layer" (RFC 1122) + * Setting this to 1 enables code that checks TCP_MSS against the MTU of the + * netif used for a connection and limits the MSS if it would be too big otherwise. + */ +#ifndef TCP_CALCULATE_EFF_SEND_MSS +#define TCP_CALCULATE_EFF_SEND_MSS 1 +#endif + + +/** + * TCP_SND_BUF: TCP sender buffer space (bytes). + * To achieve good performance, this should be at least 2 * TCP_MSS. + */ +#ifndef TCP_SND_BUF +#define TCP_SND_BUF (2 * TCP_MSS) +#endif + +/** + * TCP_SND_QUEUELEN: TCP sender buffer space (pbufs). This must be at least + * as much as (2 * TCP_SND_BUF/TCP_MSS) for things to work. + */ +#ifndef TCP_SND_QUEUELEN +#define TCP_SND_QUEUELEN ((4 * (TCP_SND_BUF) + (TCP_MSS - 1))/(TCP_MSS)) +#endif + +/** + * TCP_SNDLOWAT: TCP writable space (bytes). This must be less than + * TCP_SND_BUF. It is the amount of space which must be available in the + * TCP snd_buf for select to return writable (combined with TCP_SNDQUEUELOWAT). + */ +#ifndef TCP_SNDLOWAT +#define TCP_SNDLOWAT LWIP_MIN(LWIP_MAX(((TCP_SND_BUF)/2), (2 * TCP_MSS) + 1), (TCP_SND_BUF) - 1) +#endif + +/** + * TCP_SNDQUEUELOWAT: TCP writable bufs (pbuf count). This must be less + * than TCP_SND_QUEUELEN. If the number of pbufs queued on a pcb drops below + * this number, select returns writable (combined with TCP_SNDLOWAT). + */ +#ifndef TCP_SNDQUEUELOWAT +#define TCP_SNDQUEUELOWAT LWIP_MAX(((TCP_SND_QUEUELEN)/2), 5) +#endif + +/** + * TCP_OOSEQ_MAX_BYTES: The maximum number of bytes queued on ooseq per pcb. + * Default is 0 (no limit). Only valid for TCP_QUEUE_OOSEQ==0. + */ +#ifndef TCP_OOSEQ_MAX_BYTES +#define TCP_OOSEQ_MAX_BYTES 0 +#endif + +/** + * TCP_OOSEQ_MAX_PBUFS: The maximum number of pbufs queued on ooseq per pcb. + * Default is 0 (no limit). Only valid for TCP_QUEUE_OOSEQ==0. + */ +#ifndef TCP_OOSEQ_MAX_PBUFS +#define TCP_OOSEQ_MAX_PBUFS 0 +#endif + +/** + * TCP_LISTEN_BACKLOG: Enable the backlog option for tcp listen pcb. + */ +#ifndef TCP_LISTEN_BACKLOG +#define TCP_LISTEN_BACKLOG 0 +#endif + +/** + * The maximum allowed backlog for TCP listen netconns. + * This backlog is used unless another is explicitly specified. + * 0xff is the maximum (u8_t). + */ +#ifndef TCP_DEFAULT_LISTEN_BACKLOG +#define TCP_DEFAULT_LISTEN_BACKLOG 0xff +#endif + +/** + * TCP_OVERSIZE: The maximum number of bytes that tcp_write may + * allocate ahead of time in an attempt to create shorter pbuf chains + * for transmission. The meaningful range is 0 to TCP_MSS. Some + * suggested values are: + * + * 0: Disable oversized allocation. Each tcp_write() allocates a new + pbuf (old behaviour). + * 1: Allocate size-aligned pbufs with minimal excess. Use this if your + * scatter-gather DMA requires aligned fragments. + * 128: Limit the pbuf/memory overhead to 20%. + * TCP_MSS: Try to create unfragmented TCP packets. + * TCP_MSS/4: Try to create 4 fragments or less per TCP packet. + */ +#ifndef TCP_OVERSIZE +#define TCP_OVERSIZE TCP_MSS +#endif + +/** + * LWIP_TCP_TIMESTAMPS==1: support the TCP timestamp option. + * The timestamp option is currently only used to help remote hosts, it is not + * really used locally. Therefore, it is only enabled when a TS option is + * received in the initial SYN packet from a remote host. + */ +#ifndef LWIP_TCP_TIMESTAMPS +#define LWIP_TCP_TIMESTAMPS 0 +#endif + +/** + * TCP_WND_UPDATE_THRESHOLD: difference in window to trigger an + * explicit window update + */ +#ifndef TCP_WND_UPDATE_THRESHOLD +#define TCP_WND_UPDATE_THRESHOLD LWIP_MIN((TCP_WND / 4), (TCP_MSS * 4)) +#endif + +/** + * LWIP_EVENT_API and LWIP_CALLBACK_API: Only one of these should be set to 1. + * LWIP_EVENT_API==1: The user defines lwip_tcp_event() to receive all + * events (accept, sent, etc) that happen in the system. + * LWIP_CALLBACK_API==1: The PCB callback function is called directly + * for the event. This is the default. + */ +#if !defined(LWIP_EVENT_API) && !defined(LWIP_CALLBACK_API) +#define LWIP_EVENT_API 0 +#define LWIP_CALLBACK_API 1 +#endif + +/** + * LWIP_WND_SCALE and TCP_RCV_SCALE: + * Set LWIP_WND_SCALE to 1 to enable window scaling. + * Set TCP_RCV_SCALE to the desired scaling factor (shift count in the + * range of [0..14]). + * When LWIP_WND_SCALE is enabled but TCP_RCV_SCALE is 0, we can use a large + * send window while having a small receive window only. + */ +#ifndef LWIP_WND_SCALE +#define LWIP_WND_SCALE 0 +#define TCP_RCV_SCALE 0 +#endif + + +/* + ---------------------------------- + ---------- Pbuf options ---------- + ---------------------------------- +*/ +/** + * PBUF_LINK_HLEN: the number of bytes that should be allocated for a + * link level header. The default is 14, the standard value for + * Ethernet. + */ +#ifndef PBUF_LINK_HLEN +#ifdef LWIP_HOOK_VLAN_SET +#define PBUF_LINK_HLEN (18 + ETH_PAD_SIZE) +#else /* LWIP_HOOK_VLAN_SET */ +#define PBUF_LINK_HLEN (14 + ETH_PAD_SIZE) +#endif /* LWIP_HOOK_VLAN_SET */ +#endif + +/** + * PBUF_LINK_ENCAPSULATION_HLEN: the number of bytes that should be allocated + * for an additional encapsulation header before ethernet headers (e.g. 802.11) + */ +#ifndef PBUF_LINK_ENCAPSULATION_HLEN +#define PBUF_LINK_ENCAPSULATION_HLEN 0 +#endif + +/** + * PBUF_POOL_BUFSIZE: the size of each pbuf in the pbuf pool. The default is + * designed to accommodate single full size TCP frame in one pbuf, including + * TCP_MSS, IP header, and link header. + */ +#ifndef PBUF_POOL_BUFSIZE +#define PBUF_POOL_BUFSIZE LWIP_MEM_ALIGN_SIZE(TCP_MSS+40+PBUF_LINK_ENCAPSULATION_HLEN+PBUF_LINK_HLEN) +#endif + +/* + ------------------------------------------------ + ---------- Network Interfaces options ---------- + ------------------------------------------------ +*/ +/** + * LWIP_NETIF_HOSTNAME==1: use DHCP_OPTION_HOSTNAME with netif's hostname + * field. + */ +#ifndef LWIP_NETIF_HOSTNAME +#define LWIP_NETIF_HOSTNAME 0 +#endif + +/** + * LWIP_NETIF_API==1: Support netif api (in netifapi.c) + */ +#ifndef LWIP_NETIF_API +#define LWIP_NETIF_API 0 +#endif + +/** + * LWIP_NETIF_STATUS_CALLBACK==1: Support a callback function whenever an interface + * changes its up/down status (i.e., due to DHCP IP acquisition) + */ +#ifndef LWIP_NETIF_STATUS_CALLBACK +#define LWIP_NETIF_STATUS_CALLBACK 0 +#endif + +/** + * LWIP_NETIF_LINK_CALLBACK==1: Support a callback function from an interface + * whenever the link changes (i.e., link down) + */ +#ifndef LWIP_NETIF_LINK_CALLBACK +#define LWIP_NETIF_LINK_CALLBACK 0 +#endif + +/** + * LWIP_NETIF_REMOVE_CALLBACK==1: Support a callback function that is called + * when a netif has been removed + */ +#ifndef LWIP_NETIF_REMOVE_CALLBACK +#define LWIP_NETIF_REMOVE_CALLBACK 0 +#endif + +/** + * LWIP_NETIF_HWADDRHINT==1: Cache link-layer-address hints (e.g. table + * indices) in struct netif. TCP and UDP can make use of this to prevent + * scanning the ARP table for every sent packet. While this is faster for big + * ARP tables or many concurrent connections, it might be counterproductive + * if you have a tiny ARP table or if there never are concurrent connections. + */ +#ifndef LWIP_NETIF_HWADDRHINT +#define LWIP_NETIF_HWADDRHINT 0 +#endif + +/** + * LWIP_NETIF_LOOPBACK==1: Support sending packets with a destination IP + * address equal to the netif IP address, looping them back up the stack. + */ +#ifndef LWIP_NETIF_LOOPBACK +#define LWIP_NETIF_LOOPBACK 0 +#endif + +/** + * LWIP_LOOPBACK_MAX_PBUFS: Maximum number of pbufs on queue for loopback + * sending for each netif (0 = disabled) + */ +#ifndef LWIP_LOOPBACK_MAX_PBUFS +#define LWIP_LOOPBACK_MAX_PBUFS 0 +#endif + +/** + * LWIP_NETIF_LOOPBACK_MULTITHREADING: Indicates whether threading is enabled in + * the system, as netifs must change how they behave depending on this setting + * for the LWIP_NETIF_LOOPBACK option to work. + * Setting this is needed to avoid reentering non-reentrant functions like + * tcp_input(). + * LWIP_NETIF_LOOPBACK_MULTITHREADING==1: Indicates that the user is using a + * multithreaded environment like tcpip.c. In this case, netif->input() + * is called directly. + * LWIP_NETIF_LOOPBACK_MULTITHREADING==0: Indicates a polling (or NO_SYS) setup. + * The packets are put on a list and netif_poll() must be called in + * the main application loop. + */ +#ifndef LWIP_NETIF_LOOPBACK_MULTITHREADING +#define LWIP_NETIF_LOOPBACK_MULTITHREADING (!NO_SYS) +#endif + +/** + * LWIP_NETIF_TX_SINGLE_PBUF: if this is set to 1, lwIP tries to put all data + * to be sent into one single pbuf. This is for compatibility with DMA-enabled + * MACs that do not support scatter-gather. + * Beware that this might involve CPU-memcpy before transmitting that would not + * be needed without this flag! Use this only if you need to! + * + * @todo: TCP and IP-frag do not work with this, yet: + */ +#ifndef LWIP_NETIF_TX_SINGLE_PBUF +#define LWIP_NETIF_TX_SINGLE_PBUF 0 +#endif /* LWIP_NETIF_TX_SINGLE_PBUF */ + +/* + ------------------------------------ + ---------- LOOPIF options ---------- + ------------------------------------ +*/ +/** + * LWIP_HAVE_LOOPIF==1: Support loop interface (127.0.0.1). + * This is only needed when no real netifs are available. If at least one other + * netif is available, loopback traffic uses this netif. + */ +#ifndef LWIP_HAVE_LOOPIF +#define LWIP_HAVE_LOOPIF LWIP_NETIF_LOOPBACK +#endif + +/** + * LWIP_LOOPIF_MULTICAST==1: Support multicast/IGMP on loop interface (127.0.0.1). + */ +#ifndef LWIP_LOOPIF_MULTICAST +#define LWIP_LOOPIF_MULTICAST 0 +#endif + +/* + ------------------------------------ + ---------- SLIPIF options ---------- + ------------------------------------ +*/ +/** + * LWIP_HAVE_SLIPIF==1: Support slip interface and slipif.c + */ +#ifndef LWIP_HAVE_SLIPIF +#define LWIP_HAVE_SLIPIF 0 +#endif + +/* + ------------------------------------ + ---------- Thread options ---------- + ------------------------------------ +*/ +/** + * TCPIP_THREAD_NAME: The name assigned to the main tcpip thread. + */ +#ifndef TCPIP_THREAD_NAME +#define TCPIP_THREAD_NAME "tcpip_thread" +#endif + +/** + * TCPIP_THREAD_STACKSIZE: The stack size used by the main tcpip thread. + * The stack size value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef TCPIP_THREAD_STACKSIZE +#define TCPIP_THREAD_STACKSIZE 0 +#endif + +/** + * TCPIP_THREAD_PRIO: The priority assigned to the main tcpip thread. + * The priority value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef TCPIP_THREAD_PRIO +#define TCPIP_THREAD_PRIO 1 +#endif + +/** + * TCPIP_MBOX_SIZE: The mailbox size for the tcpip thread messages + * The queue size value itself is platform-dependent, but is passed to + * sys_mbox_new() when tcpip_init is called. + */ +#ifndef TCPIP_MBOX_SIZE +#define TCPIP_MBOX_SIZE 0 +#endif + +/** + * SLIPIF_THREAD_NAME: The name assigned to the slipif_loop thread. + */ +#ifndef SLIPIF_THREAD_NAME +#define SLIPIF_THREAD_NAME "slipif_loop" +#endif + +/** + * SLIP_THREAD_STACKSIZE: The stack size used by the slipif_loop thread. + * The stack size value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef SLIPIF_THREAD_STACKSIZE +#define SLIPIF_THREAD_STACKSIZE 0 +#endif + +/** + * SLIPIF_THREAD_PRIO: The priority assigned to the slipif_loop thread. + * The priority value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef SLIPIF_THREAD_PRIO +#define SLIPIF_THREAD_PRIO 1 +#endif + +/** + * DEFAULT_THREAD_NAME: The name assigned to any other lwIP thread. + */ +#ifndef DEFAULT_THREAD_NAME +#define DEFAULT_THREAD_NAME "lwIP" +#endif + +/** + * DEFAULT_THREAD_STACKSIZE: The stack size used by any other lwIP thread. + * The stack size value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef DEFAULT_THREAD_STACKSIZE +#define DEFAULT_THREAD_STACKSIZE 0 +#endif + +/** + * DEFAULT_THREAD_PRIO: The priority assigned to any other lwIP thread. + * The priority value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#ifndef DEFAULT_THREAD_PRIO +#define DEFAULT_THREAD_PRIO 1 +#endif + +/** + * DEFAULT_RAW_RECVMBOX_SIZE: The mailbox size for the incoming packets on a + * NETCONN_RAW. The queue size value itself is platform-dependent, but is passed + * to sys_mbox_new() when the recvmbox is created. + */ +#ifndef DEFAULT_RAW_RECVMBOX_SIZE +#define DEFAULT_RAW_RECVMBOX_SIZE 0 +#endif + +/** + * DEFAULT_UDP_RECVMBOX_SIZE: The mailbox size for the incoming packets on a + * NETCONN_UDP. The queue size value itself is platform-dependent, but is passed + * to sys_mbox_new() when the recvmbox is created. + */ +#ifndef DEFAULT_UDP_RECVMBOX_SIZE +#define DEFAULT_UDP_RECVMBOX_SIZE 0 +#endif + +/** + * DEFAULT_TCP_RECVMBOX_SIZE: The mailbox size for the incoming packets on a + * NETCONN_TCP. The queue size value itself is platform-dependent, but is passed + * to sys_mbox_new() when the recvmbox is created. + */ +#ifndef DEFAULT_TCP_RECVMBOX_SIZE +#define DEFAULT_TCP_RECVMBOX_SIZE 0 +#endif + +/** + * DEFAULT_ACCEPTMBOX_SIZE: The mailbox size for the incoming connections. + * The queue size value itself is platform-dependent, but is passed to + * sys_mbox_new() when the acceptmbox is created. + */ +#ifndef DEFAULT_ACCEPTMBOX_SIZE +#define DEFAULT_ACCEPTMBOX_SIZE 0 +#endif + +/* + ---------------------------------------------- + ---------- Sequential layer options ---------- + ---------------------------------------------- +*/ +/** + * LWIP_TCPIP_CORE_LOCKING: (EXPERIMENTAL!) + * Don't use it if you're not an active lwIP project member + */ +#ifndef LWIP_TCPIP_CORE_LOCKING +#define LWIP_TCPIP_CORE_LOCKING 0 +#endif + +/** + * LWIP_TCPIP_CORE_LOCKING_INPUT: (EXPERIMENTAL!) + * Don't use it if you're not an active lwIP project member + */ +#ifndef LWIP_TCPIP_CORE_LOCKING_INPUT +#define LWIP_TCPIP_CORE_LOCKING_INPUT 0 +#endif + +/** + * LWIP_NETCONN==1: Enable Netconn API (require to use api_lib.c) + */ +#ifndef LWIP_NETCONN +#define LWIP_NETCONN 1 +#endif + +/** LWIP_TCPIP_TIMEOUT==1: Enable tcpip_timeout/tcpip_untimeout to create + * timers running in tcpip_thread from another thread. + */ +#ifndef LWIP_TCPIP_TIMEOUT +#define LWIP_TCPIP_TIMEOUT 0 +#endif + +/** LWIP_NETCONN_SEM_PER_THREAD==1: Use one (thread-local) semaphore per + * thread calling socket/netconn functions instead of allocating one + * semaphore per netconn (and per select etc.) + * ATTENTION: a thread-local semaphore for API calls is needed: + * - LWIP_NETCONN_THREAD_SEM_GET() returning a sys_sem_t* + * - LWIP_NETCONN_THREAD_SEM_ALLOC() creating the semaphore + * - LWIP_NETCONN_THREAD_SEM_FREE() freeing the semaphore + * The latter 2 can be invoked up by calling netconn_thread_init()/netconn_thread_cleanup(). + * Ports may call these for threads created with sys_thread_new(). + */ +#ifndef LWIP_NETCONN_SEM_PER_THREAD +#define LWIP_NETCONN_SEM_PER_THREAD 0 +#endif + +/** LWIP_NETCONN_FULLDUPLEX==1: Enable code that allows reading from one thread, + * writing from a 2nd thread and closing from a 3rd thread at the same time. + * ATTENTION: This is currently really alpha! Some requirements: + * - LWIP_NETCONN_SEM_PER_THREAD==1 is required to use one socket/netconn from + * multiple threads at once + * - sys_mbox_free() has to unblock receive tasks waiting on recvmbox/acceptmbox + * and prevent a task pending on this during/after deletion + */ +#ifndef LWIP_NETCONN_FULLDUPLEX +#define LWIP_NETCONN_FULLDUPLEX 0 +#endif + +/* + ------------------------------------ + ---------- Socket options ---------- + ------------------------------------ +*/ +/** + * LWIP_SOCKET==1: Enable Socket API (require to use sockets.c) + */ +#ifndef LWIP_SOCKET +#define LWIP_SOCKET 1 +#endif + +/* LWIP_SOCKET_SET_ERRNO==1: Set errno when socket functions cannot complete + * successfully, as required by POSIX. Default is POSIX-compliant. + */ +#ifndef LWIP_SOCKET_SET_ERRNO +#define LWIP_SOCKET_SET_ERRNO 1 +#endif + +/** + * LWIP_COMPAT_SOCKETS==1: Enable BSD-style sockets functions names through defines. + * LWIP_COMPAT_SOCKETS==2: Same as ==1 but correctly named functions are created. + * While this helps code completion, it might conflict with existing libraries. + * (only used if you use sockets.c) + */ +#ifndef LWIP_COMPAT_SOCKETS +#define LWIP_COMPAT_SOCKETS 1 +#endif + +/** + * LWIP_POSIX_SOCKETS_IO_NAMES==1: Enable POSIX-style sockets functions names. + * Disable this option if you use a POSIX operating system that uses the same + * names (read, write & close). (only used if you use sockets.c) + */ +#ifndef LWIP_POSIX_SOCKETS_IO_NAMES +#define LWIP_POSIX_SOCKETS_IO_NAMES 1 +#endif + +/** + * LWIP_SOCKET_OFFSET==n: Increases the file descriptor number created by LwIP with n. + * This can be useful when there are multiple APIs which create file descriptors. + * When they all start with a different offset and you won't make them overlap you can + * re implement read/write/close/ioctl/fnctl to send the requested action to the right + * library (sharing select will need more work though). + */ +#ifndef LWIP_SOCKET_OFFSET +#define LWIP_SOCKET_OFFSET 0 +#endif + +/** + * LWIP_TCP_KEEPALIVE==1: Enable TCP_KEEPIDLE, TCP_KEEPINTVL and TCP_KEEPCNT + * options processing. Note that TCP_KEEPIDLE and TCP_KEEPINTVL have to be set + * in seconds. (does not require sockets.c, and will affect tcp.c) + */ +#ifndef LWIP_TCP_KEEPALIVE +#define LWIP_TCP_KEEPALIVE 0 +#endif + +/** + * LWIP_SO_SNDTIMEO==1: Enable send timeout for sockets/netconns and + * SO_SNDTIMEO processing. + */ +#ifndef LWIP_SO_SNDTIMEO +#define LWIP_SO_SNDTIMEO 0 +#endif + +/** + * LWIP_SO_RCVTIMEO==1: Enable receive timeout for sockets/netconns and + * SO_RCVTIMEO processing. + */ +#ifndef LWIP_SO_RCVTIMEO +#define LWIP_SO_RCVTIMEO 0 +#endif + +/** + * LWIP_SO_SNDRCVTIMEO_NONSTANDARD==1: SO_RCVTIMEO/SO_SNDTIMEO take an int + * (milliseconds, much like winsock does) instead of a struct timeval (default). + */ +#ifndef LWIP_SO_SNDRCVTIMEO_NONSTANDARD +#define LWIP_SO_SNDRCVTIMEO_NONSTANDARD 0 +#endif + +/** + * LWIP_SO_RCVBUF==1: Enable SO_RCVBUF processing. + */ +#ifndef LWIP_SO_RCVBUF +#define LWIP_SO_RCVBUF 0 +#endif + +/** + * LWIP_SO_LINGER==1: Enable SO_LINGER processing. + */ +#ifndef LWIP_SO_LINGER +#define LWIP_SO_LINGER 0 +#endif + +/** + * If LWIP_SO_RCVBUF is used, this is the default value for recv_bufsize. + */ +#ifndef RECV_BUFSIZE_DEFAULT +#define RECV_BUFSIZE_DEFAULT INT_MAX +#endif + +/** + * By default, TCP socket/netconn close waits 20 seconds max to send the FIN + */ +#ifndef LWIP_TCP_CLOSE_TIMEOUT_MS_DEFAULT +#define LWIP_TCP_CLOSE_TIMEOUT_MS_DEFAULT 20000 +#endif + +/** + * SO_REUSE==1: Enable SO_REUSEADDR option. + */ +#ifndef SO_REUSE +#define SO_REUSE 0 +#endif + +/** + * SO_REUSE_RXTOALL==1: Pass a copy of incoming broadcast/multicast packets + * to all local matches if SO_REUSEADDR is turned on. + * WARNING: Adds a memcpy for every packet if passing to more than one pcb! + */ +#ifndef SO_REUSE_RXTOALL +#define SO_REUSE_RXTOALL 0 +#endif + +/** + * LWIP_FIONREAD_LINUXMODE==0 (default): ioctl/FIONREAD returns the amount of + * pending data in the network buffer. This is the way windows does it. It's + * the default for lwIP since it is smaller. + * LWIP_FIONREAD_LINUXMODE==1: ioctl/FIONREAD returns the size of the next + * pending datagram in bytes. This is the way linux does it. This code is only + * here for compatibility. + */ +#ifndef LWIP_FIONREAD_LINUXMODE +#define LWIP_FIONREAD_LINUXMODE 0 +#endif + +/* + ---------------------------------------- + ---------- Statistics options ---------- + ---------------------------------------- +*/ +/** + * LWIP_STATS==1: Enable statistics collection in lwip_stats. + */ +#ifndef LWIP_STATS +#define LWIP_STATS 1 +#endif + +#if LWIP_STATS + +/** + * LWIP_STATS_DISPLAY==1: Compile in the statistics output functions. + */ +#ifndef LWIP_STATS_DISPLAY +#define LWIP_STATS_DISPLAY 0 +#endif + +/** + * LINK_STATS==1: Enable link stats. + */ +#ifndef LINK_STATS +#define LINK_STATS 1 +#endif + +/** + * ETHARP_STATS==1: Enable etharp stats. + */ +#ifndef ETHARP_STATS +#define ETHARP_STATS (LWIP_ARP) +#endif + +/** + * IP_STATS==1: Enable IP stats. + */ +#ifndef IP_STATS +#define IP_STATS 1 +#endif + +/** + * IPFRAG_STATS==1: Enable IP fragmentation stats. Default is + * on if using either frag or reass. + */ +#ifndef IPFRAG_STATS +#define IPFRAG_STATS (IP_REASSEMBLY || IP_FRAG) +#endif + +/** + * ICMP_STATS==1: Enable ICMP stats. + */ +#ifndef ICMP_STATS +#define ICMP_STATS 1 +#endif + +/** + * IGMP_STATS==1: Enable IGMP stats. + */ +#ifndef IGMP_STATS +#define IGMP_STATS (LWIP_IGMP) +#endif + +/** + * UDP_STATS==1: Enable UDP stats. Default is on if + * UDP enabled, otherwise off. + */ +#ifndef UDP_STATS +#define UDP_STATS (LWIP_UDP) +#endif + +/** + * TCP_STATS==1: Enable TCP stats. Default is on if TCP + * enabled, otherwise off. + */ +#ifndef TCP_STATS +#define TCP_STATS (LWIP_TCP) +#endif + +/** + * MEM_STATS==1: Enable mem.c stats. + */ +#ifndef MEM_STATS +#define MEM_STATS ((MEM_LIBC_MALLOC == 0) && (MEM_USE_POOLS == 0)) +#endif + +/** + * MEMP_STATS==1: Enable memp.c pool stats. + */ +#ifndef MEMP_STATS +#define MEMP_STATS (MEMP_MEM_MALLOC == 0) +#endif + +/** + * SYS_STATS==1: Enable system stats (sem and mbox counts, etc). + */ +#ifndef SYS_STATS +#define SYS_STATS (NO_SYS == 0) +#endif + +/** + * IP6_STATS==1: Enable IPv6 stats. + */ +#ifndef IP6_STATS +#define IP6_STATS (LWIP_IPV6) +#endif + +/** + * ICMP6_STATS==1: Enable ICMP for IPv6 stats. + */ +#ifndef ICMP6_STATS +#define ICMP6_STATS (LWIP_IPV6 && LWIP_ICMP6) +#endif + +/** + * IP6_FRAG_STATS==1: Enable IPv6 fragmentation stats. + */ +#ifndef IP6_FRAG_STATS +#define IP6_FRAG_STATS (LWIP_IPV6 && (LWIP_IPV6_FRAG || LWIP_IPV6_REASS)) +#endif + +/** + * MLD6_STATS==1: Enable MLD for IPv6 stats. + */ +#ifndef MLD6_STATS +#define MLD6_STATS (LWIP_IPV6 && LWIP_IPV6_MLD) +#endif + +/** + * ND6_STATS==1: Enable Neighbor discovery for IPv6 stats. + */ +#ifndef ND6_STATS +#define ND6_STATS (LWIP_IPV6) +#endif + +/** + * MIB2_STATS==1: Stats for SNMP MIB2. + */ +#ifndef MIB2_STATS +#define MIB2_STATS 0 +#endif + +#else + +#define LINK_STATS 0 +#define ETHARP_STATS 0 +#define IP_STATS 0 +#define IPFRAG_STATS 0 +#define ICMP_STATS 0 +#define IGMP_STATS 0 +#define UDP_STATS 0 +#define TCP_STATS 0 +#define MEM_STATS 0 +#define MEMP_STATS 0 +#define SYS_STATS 0 +#define LWIP_STATS_DISPLAY 0 +#define IP6_STATS 0 +#define ICMP6_STATS 0 +#define IP6_FRAG_STATS 0 +#define MLD6_STATS 0 +#define ND6_STATS 0 +#define MIB2_STATS 0 + +#endif /* LWIP_STATS */ + +/* + --------------------------------- + ---------- PPP options ---------- + --------------------------------- +*/ + +/** + * PPP_SUPPORT==1: Enable PPP. + */ +#ifndef PPP_SUPPORT +#define PPP_SUPPORT 0 +#endif + +/** + * PPPOE_SUPPORT==1: Enable PPP Over Ethernet + */ +#ifndef PPPOE_SUPPORT +#define PPPOE_SUPPORT 0 +#endif + +/** + * PPPOL2TP_SUPPORT==1: Enable PPP Over L2TP + */ +#ifndef PPPOL2TP_SUPPORT +#define PPPOL2TP_SUPPORT 0 +#endif + +/** + * PPPOL2TP_AUTH_SUPPORT==1: Enable PPP Over L2TP Auth (enable MD5 support) + */ +#ifndef PPPOL2TP_AUTH_SUPPORT +#define PPPOL2TP_AUTH_SUPPORT PPPOL2TP_SUPPORT +#endif + +/** + * PPPOS_SUPPORT==1: Enable PPP Over Serial + */ +#ifndef PPPOS_SUPPORT +#define PPPOS_SUPPORT PPP_SUPPORT +#endif + +/** + * LWIP_PPP_API==1: Enable PPP API (in pppapi.c) + */ +#ifndef LWIP_PPP_API +#define LWIP_PPP_API (PPP_SUPPORT && (NO_SYS == 0)) +#endif + +#if PPP_SUPPORT + +/** + * PPP_INPROC_IRQ_SAFE==1 call pppos_input() using tcpip_callback(). + * + * Please read the "PPPoS input path" chapter in the PPP documentation about this option. + */ +#ifndef PPP_INPROC_IRQ_SAFE +#define PPP_INPROC_IRQ_SAFE 0 +#endif + +/** + * PRINTPKT_SUPPORT==1: Enable PPP print packet support + * + * Mandatory for debugging, it displays exchanged packet content in debug trace. + */ +#ifndef PRINTPKT_SUPPORT +#define PRINTPKT_SUPPORT 0 +#endif + +/** + * PPP_IPV4_SUPPORT==1: Enable PPP IPv4 support + */ +#ifndef PPP_IPV4_SUPPORT +#define PPP_IPV4_SUPPORT (LWIP_IPV4) +#endif + +/** + * PPP_IPV6_SUPPORT==1: Enable PPP IPv6 support + */ +#ifndef PPP_IPV6_SUPPORT +#define PPP_IPV6_SUPPORT (LWIP_IPV6) +#endif + +/** + * PPP_NOTIFY_PHASE==1: Support PPP notify phase support + * + * PPP notify phase support allows you to set a callback which is + * called on change of the internal PPP state machine. + * + * This can be used for example to set a LED pattern depending on the + * current phase of the PPP session. + */ +#ifndef PPP_NOTIFY_PHASE +#define PPP_NOTIFY_PHASE 0 +#endif + +/** + * pbuf_type PPP is using for LCP, PAP, CHAP, EAP, CCP, IPCP and IP6CP packets. + * + * Memory allocated must be single buffered for PPP to works, it requires pbuf + * that are not going to be chained when allocated. This requires setting + * PBUF_POOL_BUFSIZE to at least 512 bytes, which is quite huge for small systems. + * + * Setting PPP_USE_PBUF_RAM to 1 makes PPP use memory from heap where continuous + * buffers are required, allowing you to use a smaller PBUF_POOL_BUFSIZE. + */ +#ifndef PPP_USE_PBUF_RAM +#define PPP_USE_PBUF_RAM 0 +#endif + +/** + * PPP_FCS_TABLE: Keep a 256*2 byte table to speed up FCS calculation for PPPoS + */ +#ifndef PPP_FCS_TABLE +#define PPP_FCS_TABLE 1 +#endif + +/** + * PAP_SUPPORT==1: Support PAP. + */ +#ifndef PAP_SUPPORT +#define PAP_SUPPORT 0 +#endif + +/** + * CHAP_SUPPORT==1: Support CHAP. + */ +#ifndef CHAP_SUPPORT +#define CHAP_SUPPORT 0 +#endif + +/** + * MSCHAP_SUPPORT==1: Support MSCHAP. + */ +#ifndef MSCHAP_SUPPORT +#define MSCHAP_SUPPORT 0 +#endif +#if MSCHAP_SUPPORT +/* MSCHAP requires CHAP support */ +#undef CHAP_SUPPORT +#define CHAP_SUPPORT 1 +#endif /* MSCHAP_SUPPORT */ + +/** + * EAP_SUPPORT==1: Support EAP. + */ +#ifndef EAP_SUPPORT +#define EAP_SUPPORT 0 +#endif + +/** + * CCP_SUPPORT==1: Support CCP. + */ +#ifndef CCP_SUPPORT +#define CCP_SUPPORT 0 +#endif + +/** + * MPPE_SUPPORT==1: Support MPPE. + */ +#ifndef MPPE_SUPPORT +#define MPPE_SUPPORT 0 +#endif +#if MPPE_SUPPORT +/* MPPE requires CCP support */ +#undef CCP_SUPPORT +#define CCP_SUPPORT 1 +/* MPPE requires MSCHAP support */ +#undef MSCHAP_SUPPORT +#define MSCHAP_SUPPORT 1 +/* MSCHAP requires CHAP support */ +#undef CHAP_SUPPORT +#define CHAP_SUPPORT 1 +#endif /* MPPE_SUPPORT */ + +/** + * CBCP_SUPPORT==1: Support CBCP. CURRENTLY NOT SUPPORTED! DO NOT SET! + */ +#ifndef CBCP_SUPPORT +#define CBCP_SUPPORT 0 +#endif + +/** + * ECP_SUPPORT==1: Support ECP. CURRENTLY NOT SUPPORTED! DO NOT SET! + */ +#ifndef ECP_SUPPORT +#define ECP_SUPPORT 0 +#endif + +/** + * DEMAND_SUPPORT==1: Support dial on demand. CURRENTLY NOT SUPPORTED! DO NOT SET! + */ +#ifndef DEMAND_SUPPORT +#define DEMAND_SUPPORT 0 +#endif + +/** + * LQR_SUPPORT==1: Support Link Quality Report. Do nothing except exchanging some LCP packets. + */ +#ifndef LQR_SUPPORT +#define LQR_SUPPORT 0 +#endif + +/** + * PPP_SERVER==1: Enable PPP server support (waiting for incoming PPP session). + * + * Currently only supported for PPPoS. + */ +#ifndef PPP_SERVER +#define PPP_SERVER 0 +#endif + +#if PPP_SERVER +/* + * PPP_OUR_NAME: Our name for authentication purposes + */ +#ifndef PPP_OUR_NAME +#define PPP_OUR_NAME "lwIP" +#endif +#endif /* PPP_SERVER */ + +/** + * VJ_SUPPORT==1: Support VJ header compression. + */ +#ifndef VJ_SUPPORT +#define VJ_SUPPORT 1 +#endif +/* VJ compression is only supported for IPv4 over PPPoS. */ +#if !PPPOS_SUPPORT || !PPP_IPV4_SUPPORT +#undef VJ_SUPPORT +#define VJ_SUPPORT 0 +#endif /* !PPPOS_SUPPORT */ + +/** + * PPP_MD5_RANDM==1: Use MD5 for better randomness. + * Enabled by default if CHAP, EAP, or L2TP AUTH support is enabled. + */ +#ifndef PPP_MD5_RANDM +#define PPP_MD5_RANDM (CHAP_SUPPORT || EAP_SUPPORT || PPPOL2TP_AUTH_SUPPORT) +#endif + +/** + * PolarSSL library, used if necessary and not previously disabled + * + * + * lwIP contains some files fetched from the latest BSD release of + * the PolarSSL project for ciphers and encryption methods we need for lwIP + * PPP support. + * + * The PolarSSL files were cleaned to contain only the necessary struct + * fields and functions needed for lwIP. + * + * The PolarSSL API was not changed at all, so if you are already using + * PolarSSL you can choose to skip the compilation of the included PolarSSL + * library into lwIP: + * + * The following defines are available for flexibility: + * + * LWIP_INCLUDED_POLARSSL_MD4 ; Use lwIP internal PolarSSL for MD4 + * LWIP_INCLUDED_POLARSSL_MD5 ; Use lwIP internal PolarSSL for MD5 + * LWIP_INCLUDED_POLARSSL_SHA1 ; Use lwIP internal PolarSSL for SHA1 + * LWIP_INCLUDED_POLARSSL_DES ; Use lwIP internal PolarSSL for DES + * + * If set (=1), the default if required by another enabled PPP feature unless + * explicitly set to 0, using included lwIP PolarSSL. + * + * If clear (=0), not needed or using external PolarSSL. + * + * Beware of the stack requirements which can be a lot larger if you are not + * using our cleaned PolarSSL library. + */ + +/* CHAP, EAP, L2TP AUTH and MD5 Random require MD5 support */ +#if CHAP_SUPPORT || EAP_SUPPORT || PPPOL2TP_AUTH_SUPPORT || PPP_MD5_RANDM +#ifndef LWIP_INCLUDED_POLARSSL_MD5 +#define LWIP_INCLUDED_POLARSSL_MD5 1 +#endif /* LWIP_INCLUDED_POLARSSL_MD5 */ +#endif /* CHAP_SUPPORT || EAP_SUPPORT || PPPOL2TP_AUTH_SUPPORT || PPP_MD5_RANDM */ + +#if MSCHAP_SUPPORT +/* MSCHAP require MD4 support */ +#ifndef LWIP_INCLUDED_POLARSSL_MD4 +#define LWIP_INCLUDED_POLARSSL_MD4 1 +#endif /* LWIP_INCLUDED_POLARSSL_MD4 */ +/* MSCHAP require SHA1 support */ +#ifndef LWIP_INCLUDED_POLARSSL_SHA1 +#define LWIP_INCLUDED_POLARSSL_SHA1 1 +#endif /* LWIP_INCLUDED_POLARSSL_SHA1 */ +/* MSCHAP require DES support */ +#ifndef LWIP_INCLUDED_POLARSSL_DES +#define LWIP_INCLUDED_POLARSSL_DES 1 +#endif /* LWIP_INCLUDED_POLARSSL_DES */ +/* MS-CHAP support is required for MPPE */ +#if MPPE_SUPPORT +/* MPPE require ARC4 support */ +#ifndef LWIP_INCLUDED_POLARSSL_ARC4 +#define LWIP_INCLUDED_POLARSSL_ARC4 1 +#endif /* LWIP_INCLUDED_POLARSSL_ARC4*/ +#endif /* MPPE_SUPPORT */ +#endif /* MSCHAP_SUPPORT */ + +/* Default value if unset */ +#ifndef LWIP_INCLUDED_POLARSSL_MD4 +#define LWIP_INCLUDED_POLARSSL_MD4 0 +#endif /* LWIP_INCLUDED_POLARSSL_MD4 */ +#ifndef LWIP_INCLUDED_POLARSSL_MD5 +#define LWIP_INCLUDED_POLARSSL_MD5 0 +#endif /* LWIP_INCLUDED_POLARSSL_MD5 */ +#ifndef LWIP_INCLUDED_POLARSSL_SHA1 +#define LWIP_INCLUDED_POLARSSL_SHA1 0 +#endif /* LWIP_INCLUDED_POLARSSL_SHA1 */ +#ifndef LWIP_INCLUDED_POLARSSL_DES +#define LWIP_INCLUDED_POLARSSL_DES 0 +#endif /* LWIP_INCLUDED_POLARSSL_DES */ +#ifndef LWIP_INCLUDED_POLARSSL_ARC4 +#define LWIP_INCLUDED_POLARSSL_ARC4 0 +#endif /* LWIP_INCLUDED_POLARSSL_ARC4 */ + +/* + * PPP Timeouts + */ + +/** + * FSM_DEFTIMEOUT: Timeout time in seconds + */ +#ifndef FSM_DEFTIMEOUT +#define FSM_DEFTIMEOUT 6 +#endif + +/** + * FSM_DEFMAXTERMREQS: Maximum Terminate-Request transmissions + */ +#ifndef FSM_DEFMAXTERMREQS +#define FSM_DEFMAXTERMREQS 2 +#endif + +/** + * FSM_DEFMAXCONFREQS: Maximum Configure-Request transmissions + */ +#ifndef FSM_DEFMAXCONFREQS +#define FSM_DEFMAXCONFREQS 10 +#endif + +/** + * FSM_DEFMAXNAKLOOPS: Maximum number of nak loops + */ +#ifndef FSM_DEFMAXNAKLOOPS +#define FSM_DEFMAXNAKLOOPS 5 +#endif + +/** + * UPAP_DEFTIMEOUT: Timeout (seconds) for retransmitting req + */ +#ifndef UPAP_DEFTIMEOUT +#define UPAP_DEFTIMEOUT 6 +#endif + +/** + * UPAP_DEFTRANSMITS: Maximum number of auth-reqs to send + */ +#ifndef UPAP_DEFTRANSMITS +#define UPAP_DEFTRANSMITS 10 +#endif + +#if PPP_SERVER +/** + * UPAP_DEFREQTIME: Time to wait for auth-req from peer + */ +#ifndef UPAP_DEFREQTIME +#define UPAP_DEFREQTIME 30 +#endif +#endif /* PPP_SERVER */ + +/** + * CHAP_DEFTIMEOUT: Timeout (seconds) for retransmitting req + */ +#ifndef CHAP_DEFTIMEOUT +#define CHAP_DEFTIMEOUT 6 +#endif + +/** + * CHAP_DEFTRANSMITS: max # times to send challenge + */ +#ifndef CHAP_DEFTRANSMITS +#define CHAP_DEFTRANSMITS 10 +#endif + +#if PPP_SERVER +/** + * CHAP_DEFRECHALLENGETIME: If this option is > 0, rechallenge the peer every n seconds + */ +#ifndef CHAP_DEFRECHALLENGETIME +#define CHAP_DEFRECHALLENGETIME 0 +#endif +#endif /* PPP_SERVER */ + +/** + * EAP_DEFREQTIME: Time to wait for peer request + */ +#ifndef EAP_DEFREQTIME +#define EAP_DEFREQTIME 6 +#endif + +/** + * EAP_DEFALLOWREQ: max # times to accept requests + */ +#ifndef EAP_DEFALLOWREQ +#define EAP_DEFALLOWREQ 10 +#endif + +#if PPP_SERVER +/** + * EAP_DEFTIMEOUT: Timeout (seconds) for rexmit + */ +#ifndef EAP_DEFTIMEOUT +#define EAP_DEFTIMEOUT 6 +#endif + +/** + * EAP_DEFTRANSMITS: max # times to transmit + */ +#ifndef EAP_DEFTRANSMITS +#define EAP_DEFTRANSMITS 10 +#endif +#endif /* PPP_SERVER */ + +/** + * LCP_DEFLOOPBACKFAIL: Default number of times we receive our magic number from the peer + * before deciding the link is looped-back. + */ +#ifndef LCP_DEFLOOPBACKFAIL +#define LCP_DEFLOOPBACKFAIL 10 +#endif + +/** + * LCP_ECHOINTERVAL: Interval in seconds between keepalive echo requests, 0 to disable. + */ +#ifndef LCP_ECHOINTERVAL +#define LCP_ECHOINTERVAL 0 +#endif + +/** + * LCP_MAXECHOFAILS: Number of unanswered echo requests before failure. + */ +#ifndef LCP_MAXECHOFAILS +#define LCP_MAXECHOFAILS 3 +#endif + +/** + * PPP_MAXIDLEFLAG: Max Xmit idle time (in ms) before resend flag char. + */ +#ifndef PPP_MAXIDLEFLAG +#define PPP_MAXIDLEFLAG 100 +#endif + +/** + * PPP Packet sizes + */ + +/** + * PPP_MRU: Default MRU + */ +#ifndef PPP_MRU +#define PPP_MRU 1500 +#endif + +/** + * PPP_DEFMRU: Default MRU to try + */ +#ifndef PPP_DEFMRU +#define PPP_DEFMRU 1500 +#endif + +/** + * PPP_MAXMRU: Normally limit MRU to this (pppd default = 16384) + */ +#ifndef PPP_MAXMRU +#define PPP_MAXMRU 1500 +#endif + +/** + * PPP_MINMRU: No MRUs below this + */ +#ifndef PPP_MINMRU +#define PPP_MINMRU 128 +#endif + +/** + * PPPOL2TP_DEFMRU: Default MTU and MRU for L2TP + * Default = 1500 - PPPoE(6) - PPP Protocol(2) - IPv4 header(20) - UDP Header(8) + * - L2TP Header(6) - HDLC Header(2) - PPP Protocol(2) - MPPE Header(2) - PPP Protocol(2) + */ +#if PPPOL2TP_SUPPORT +#ifndef PPPOL2TP_DEFMRU +#define PPPOL2TP_DEFMRU 1450 +#endif +#endif /* PPPOL2TP_SUPPORT */ + +/** + * MAXNAMELEN: max length of hostname or name for auth + */ +#ifndef MAXNAMELEN +#define MAXNAMELEN 256 +#endif + +/** + * MAXSECRETLEN: max length of password or secret + */ +#ifndef MAXSECRETLEN +#define MAXSECRETLEN 256 +#endif + +#endif /* PPP_SUPPORT */ + +/* + -------------------------------------- + ---------- Checksum options ---------- + -------------------------------------- +*/ + +/** + * LWIP_CHECKSUM_CTRL_PER_NETIF==1: Checksum generation/check can be enabled/disabled + * per netif. + * ATTENTION: if enabled, the CHECKSUM_GEN_* and CHECKSUM_CHECK_* defines must be enabled! + */ +#ifndef LWIP_CHECKSUM_CTRL_PER_NETIF +#define LWIP_CHECKSUM_CTRL_PER_NETIF 0 +#endif + +/** + * CHECKSUM_GEN_IP==1: Generate checksums in software for outgoing IP packets. + */ +#ifndef CHECKSUM_GEN_IP +#define CHECKSUM_GEN_IP 1 +#endif + +/** + * CHECKSUM_GEN_UDP==1: Generate checksums in software for outgoing UDP packets. + */ +#ifndef CHECKSUM_GEN_UDP +#define CHECKSUM_GEN_UDP 1 +#endif + +/** + * CHECKSUM_GEN_TCP==1: Generate checksums in software for outgoing TCP packets. + */ +#ifndef CHECKSUM_GEN_TCP +#define CHECKSUM_GEN_TCP 1 +#endif + +/** + * CHECKSUM_GEN_ICMP==1: Generate checksums in software for outgoing ICMP packets. + */ +#ifndef CHECKSUM_GEN_ICMP +#define CHECKSUM_GEN_ICMP 1 +#endif + +/** + * CHECKSUM_GEN_ICMP6==1: Generate checksums in software for outgoing ICMP6 packets. + */ +#ifndef CHECKSUM_GEN_ICMP6 +#define CHECKSUM_GEN_ICMP6 1 +#endif + +/** + * CHECKSUM_CHECK_IP==1: Check checksums in software for incoming IP packets. + */ +#ifndef CHECKSUM_CHECK_IP +#define CHECKSUM_CHECK_IP 1 +#endif + +/** + * CHECKSUM_CHECK_UDP==1: Check checksums in software for incoming UDP packets. + */ +#ifndef CHECKSUM_CHECK_UDP +#define CHECKSUM_CHECK_UDP 1 +#endif + +/** + * CHECKSUM_CHECK_TCP==1: Check checksums in software for incoming TCP packets. + */ +#ifndef CHECKSUM_CHECK_TCP +#define CHECKSUM_CHECK_TCP 1 +#endif + +/** + * CHECKSUM_CHECK_ICMP==1: Check checksums in software for incoming ICMP packets. + */ +#ifndef CHECKSUM_CHECK_ICMP +#define CHECKSUM_CHECK_ICMP 1 +#endif + +/** + * CHECKSUM_CHECK_ICMP6==1: Check checksums in software for incoming ICMPv6 packets + */ +#ifndef CHECKSUM_CHECK_ICMP6 +#define CHECKSUM_CHECK_ICMP6 1 +#endif + +/** + * LWIP_CHECKSUM_ON_COPY==1: Calculate checksum when copying data from + * application buffers to pbufs. + */ +#ifndef LWIP_CHECKSUM_ON_COPY +#define LWIP_CHECKSUM_ON_COPY 0 +#endif + +/* + --------------------------------------- + ---------- IPv6 options --------------- + --------------------------------------- +*/ +/** + * LWIP_IPV6==1: Enable IPv6 + */ +#ifndef LWIP_IPV6 +#define LWIP_IPV6 0 +#endif + +/** + * LWIP_IPV6_NUM_ADDRESSES: Number of IPv6 addresses per netif. + */ +#ifndef LWIP_IPV6_NUM_ADDRESSES +#define LWIP_IPV6_NUM_ADDRESSES 3 +#endif + +/** + * LWIP_IPV6_FORWARD==1: Forward IPv6 packets across netifs + */ +#ifndef LWIP_IPV6_FORWARD +#define LWIP_IPV6_FORWARD 0 +#endif + +/** + * LWIP_ICMP6==1: Enable ICMPv6 (mandatory per RFC) + */ +#ifndef LWIP_ICMP6 +#define LWIP_ICMP6 (LWIP_IPV6) +#endif + +/** + * LWIP_ICMP6_DATASIZE: bytes from original packet to send back in + * ICMPv6 error messages. + */ +#ifndef LWIP_ICMP6_DATASIZE +#define LWIP_ICMP6_DATASIZE 8 +#endif + +/** + * LWIP_ICMP6_HL: default hop limit for ICMPv6 messages + */ +#ifndef LWIP_ICMP6_HL +#define LWIP_ICMP6_HL 255 +#endif + +/** + * LWIP_IPV6_MLD==1: Enable multicast listener discovery protocol. + */ +#ifndef LWIP_IPV6_MLD +#define LWIP_IPV6_MLD (LWIP_IPV6) +#endif + +/** + * MEMP_NUM_MLD6_GROUP: Max number of IPv6 multicast that can be joined. + */ +#ifndef MEMP_NUM_MLD6_GROUP +#define MEMP_NUM_MLD6_GROUP 4 +#endif + +/** + * LWIP_IPV6_FRAG==1: Fragment outgoing IPv6 packets that are too big. + */ +#ifndef LWIP_IPV6_FRAG +#define LWIP_IPV6_FRAG 0 +#endif + +/** + * LWIP_IPV6_REASS==1: reassemble incoming IPv6 packets that fragmented + */ +#ifndef LWIP_IPV6_REASS +#define LWIP_IPV6_REASS (LWIP_IPV6) +#endif + +/** + * LWIP_ND6_QUEUEING==1: queue outgoing IPv6 packets while MAC address + * is being resolved. + */ +#ifndef LWIP_ND6_QUEUEING +#define LWIP_ND6_QUEUEING (LWIP_IPV6) +#endif + +/** + * MEMP_NUM_ND6_QUEUE: Max number of IPv6 packets to queue during MAC resolution. + */ +#ifndef MEMP_NUM_ND6_QUEUE +#define MEMP_NUM_ND6_QUEUE 20 +#endif + +/** + * LWIP_ND6_NUM_NEIGHBORS: Number of entries in IPv6 neighbor cache + */ +#ifndef LWIP_ND6_NUM_NEIGHBORS +#define LWIP_ND6_NUM_NEIGHBORS 10 +#endif + +/** + * LWIP_ND6_NUM_DESTINATIONS: number of entries in IPv6 destination cache + */ +#ifndef LWIP_ND6_NUM_DESTINATIONS +#define LWIP_ND6_NUM_DESTINATIONS 10 +#endif + +/** + * LWIP_ND6_NUM_PREFIXES: number of entries in IPv6 on-link prefixes cache + */ +#ifndef LWIP_ND6_NUM_PREFIXES +#define LWIP_ND6_NUM_PREFIXES 5 +#endif + +/** + * LWIP_ND6_NUM_ROUTERS: number of entries in IPv6 default router cache + */ +#ifndef LWIP_ND6_NUM_ROUTERS +#define LWIP_ND6_NUM_ROUTERS 3 +#endif + +/** + * LWIP_ND6_MAX_MULTICAST_SOLICIT: max number of multicast solicit messages to send + * (neighbor solicit and router solicit) + */ +#ifndef LWIP_ND6_MAX_MULTICAST_SOLICIT +#define LWIP_ND6_MAX_MULTICAST_SOLICIT 3 +#endif + +/** + * LWIP_ND6_MAX_UNICAST_SOLICIT: max number of unicast neighbor solicitation messages + * to send during neighbor reachability detection. + */ +#ifndef LWIP_ND6_MAX_UNICAST_SOLICIT +#define LWIP_ND6_MAX_UNICAST_SOLICIT 3 +#endif + +/** + * Unused: See ND RFC (time in milliseconds). + */ +#ifndef LWIP_ND6_MAX_ANYCAST_DELAY_TIME +#define LWIP_ND6_MAX_ANYCAST_DELAY_TIME 1000 +#endif + +/** + * Unused: See ND RFC + */ +#ifndef LWIP_ND6_MAX_NEIGHBOR_ADVERTISEMENT +#define LWIP_ND6_MAX_NEIGHBOR_ADVERTISEMENT 3 +#endif + +/** + * LWIP_ND6_REACHABLE_TIME: default neighbor reachable time (in milliseconds). + * May be updated by router advertisement messages. + */ +#ifndef LWIP_ND6_REACHABLE_TIME +#define LWIP_ND6_REACHABLE_TIME 30000 +#endif + +/** + * LWIP_ND6_RETRANS_TIMER: default retransmission timer for solicitation messages + */ +#ifndef LWIP_ND6_RETRANS_TIMER +#define LWIP_ND6_RETRANS_TIMER 1000 +#endif + +/** + * LWIP_ND6_DELAY_FIRST_PROBE_TIME: Delay before first unicast neighbor solicitation + * message is sent, during neighbor reachability detection. + */ +#ifndef LWIP_ND6_DELAY_FIRST_PROBE_TIME +#define LWIP_ND6_DELAY_FIRST_PROBE_TIME 5000 +#endif + +/** + * LWIP_ND6_ALLOW_RA_UPDATES==1: Allow Router Advertisement messages to update + * Reachable time and retransmission timers, and netif MTU. + */ +#ifndef LWIP_ND6_ALLOW_RA_UPDATES +#define LWIP_ND6_ALLOW_RA_UPDATES 1 +#endif + +/** + * LWIP_IPV6_SEND_ROUTER_SOLICIT==1: Send router solicitation messages during + * network startup. + */ +#ifndef LWIP_IPV6_SEND_ROUTER_SOLICIT +#define LWIP_IPV6_SEND_ROUTER_SOLICIT 1 +#endif + +/** + * LWIP_ND6_TCP_REACHABILITY_HINTS==1: Allow TCP to provide Neighbor Discovery + * with reachability hints for connected destinations. This helps avoid sending + * unicast neighbor solicitation messages. + */ +#ifndef LWIP_ND6_TCP_REACHABILITY_HINTS +#define LWIP_ND6_TCP_REACHABILITY_HINTS 1 +#endif + +/** + * LWIP_IPV6_AUTOCONFIG==1: Enable stateless address autoconfiguration as per RFC 4862. + */ +#ifndef LWIP_IPV6_AUTOCONFIG +#define LWIP_IPV6_AUTOCONFIG (LWIP_IPV6) +#endif + +/** + * LWIP_IPV6_DUP_DETECT_ATTEMPTS: Number of duplicate address detection attempts. + */ +#ifndef LWIP_IPV6_DUP_DETECT_ATTEMPTS +#define LWIP_IPV6_DUP_DETECT_ATTEMPTS 1 +#endif + +/** + * LWIP_IPV6_DHCP6==1: enable DHCPv6 stateful address autoconfiguration. + */ +#ifndef LWIP_IPV6_DHCP6 +#define LWIP_IPV6_DHCP6 0 +#endif + +/* + --------------------------------------- + ---------- Hook options --------------- + --------------------------------------- +*/ + +/* Hooks are undefined by default, define them to a function if you need them. */ + +/** + * LWIP_HOOK_IP4_INPUT(pbuf, input_netif): + * - called from ip_input() (IPv4) + * - pbuf: received struct pbuf passed to ip_input() + * - input_netif: struct netif on which the packet has been received + * Return values: + * - 0: Hook has not consumed the packet, packet is processed as normal + * - != 0: Hook has consumed the packet. + * If the hook consumed the packet, 'pbuf' is in the responsibility of the hook + * (i.e. free it when done). + */ + +/** + * LWIP_HOOK_IP4_ROUTE(dest): + * - called from ip_route() (IPv4) + * - dest: destination IPv4 address + * Returns the destination netif or NULL if no destination netif is found. In + * that case, ip_route() continues as normal. + */ + +/** + * LWIP_HOOK_IP4_ROUTE_SRC(dest, src): + * - source-based routing for IPv4 (see LWIP_HOOK_IP4_ROUTE(), src may be NULL) + */ + +/** + * LWIP_HOOK_ETHARP_GET_GW(netif, dest): + * - called from etharp_output() (IPv4) + * - netif: the netif used for sending + * - dest: the destination IPv4 address + * Returns the IPv4 address of the gateway to handle the specified destination + * IPv4 address. If NULL is returned, the netif's default gateway is used. + * The returned address MUST be reachable on the specified netif! + * This function is meant to implement advanced IPv4 routing together with + * LWIP_HOOK_IP4_ROUTE(). The actual routing/gateway table implementation is + * not part of lwIP but can e.g. be hidden in the netif's state argument. +*/ + +/** + * LWIP_HOOK_IP6_INPUT(pbuf, input_netif): + * - called from ip6_input() (IPv6) + * - pbuf: received struct pbuf passed to ip6_input() + * - input_netif: struct netif on which the packet has been received + * Return values: + * - 0: Hook has not consumed the packet, packet is processed as normal + * - != 0: Hook has consumed the packet. + * If the hook consumed the packet, 'pbuf' is in the responsibility of the hook + * (i.e. free it when done). + */ + +/** + * LWIP_HOOK_IP6_ROUTE(src, dest): + * - called from ip6_route() (IPv6) + * - src: sourc IPv6 address + * - dest: destination IPv6 address + * Returns the destination netif or NULL if no destination netif is found. In + * that case, ip6_route() continues as normal. + */ + +/** + * LWIP_HOOK_VLAN_CHECK(netif, eth_hdr, vlan_hdr): + * - called from ethernet_input() if VLAN support is enabled + * - netif: struct netif on which the packet has been received + * - eth_hdr: struct eth_hdr of the packet + * - vlan_hdr: struct eth_vlan_hdr of the packet + * Return values: + * - 0: Packet must be dropped. + * - != 0: Packet must be accepted. + */ + +/** + * LWIP_HOOK_VLAN_SET(netif, eth_hdr, vlan_hdr): + * - called from etharp_raw() and etharp_send_ip() if VLAN support is enabled + * - netif: struct netif that the packet will be sent through + * - eth_hdr: struct eth_hdr of the packet + * - vlan_hdr: struct eth_vlan_hdr of the packet + * Return values: + * - 0: Packet shall not contain VLAN header. + * - != 0: Packet shall contain VLAN header. + * Hook can be used to set prio_vid field of vlan_hdr. + */ + +/** + * LWIP_HOOK_MEMP_AVAILABLE(memp_t_type): + * - called from memp_free() when a memp pool was empty and an item is now available + */ + +/* + --------------------------------------- + ---------- Debugging options ---------- + --------------------------------------- +*/ +/** + * LWIP_DBG_MIN_LEVEL: After masking, the value of the debug is + * compared against this value. If it is smaller, then debugging + * messages are written. + */ +#ifndef LWIP_DBG_MIN_LEVEL +#define LWIP_DBG_MIN_LEVEL LWIP_DBG_LEVEL_ALL +#endif + +/** + * LWIP_DBG_TYPES_ON: A mask that can be used to globally enable/disable + * debug messages of certain types. + */ +#ifndef LWIP_DBG_TYPES_ON +#define LWIP_DBG_TYPES_ON LWIP_DBG_ON +#endif + +/** + * ETHARP_DEBUG: Enable debugging in etharp.c. + */ +#ifndef ETHARP_DEBUG +#define ETHARP_DEBUG LWIP_DBG_OFF +#endif + +/** + * NETIF_DEBUG: Enable debugging in netif.c. + */ +#ifndef NETIF_DEBUG +#define NETIF_DEBUG LWIP_DBG_OFF +#endif + +/** + * PBUF_DEBUG: Enable debugging in pbuf.c. + */ +#ifndef PBUF_DEBUG +#define PBUF_DEBUG LWIP_DBG_OFF +#endif + +/** + * API_LIB_DEBUG: Enable debugging in api_lib.c. + */ +#ifndef API_LIB_DEBUG +#define API_LIB_DEBUG LWIP_DBG_OFF +#endif + +/** + * API_MSG_DEBUG: Enable debugging in api_msg.c. + */ +#ifndef API_MSG_DEBUG +#define API_MSG_DEBUG LWIP_DBG_OFF +#endif + +/** + * SOCKETS_DEBUG: Enable debugging in sockets.c. + */ +#ifndef SOCKETS_DEBUG +#define SOCKETS_DEBUG LWIP_DBG_OFF +#endif + +/** + * ICMP_DEBUG: Enable debugging in icmp.c. + */ +#ifndef ICMP_DEBUG +#define ICMP_DEBUG LWIP_DBG_OFF +#endif + +/** + * IGMP_DEBUG: Enable debugging in igmp.c. + */ +#ifndef IGMP_DEBUG +#define IGMP_DEBUG LWIP_DBG_OFF +#endif + +/** + * INET_DEBUG: Enable debugging in inet.c. + */ +#ifndef INET_DEBUG +#define INET_DEBUG LWIP_DBG_OFF +#endif + +/** + * IP_DEBUG: Enable debugging for IP. + */ +#ifndef IP_DEBUG +#define IP_DEBUG LWIP_DBG_OFF +#endif + +/** + * IP_REASS_DEBUG: Enable debugging in ip_frag.c for both frag & reass. + */ +#ifndef IP_REASS_DEBUG +#define IP_REASS_DEBUG LWIP_DBG_OFF +#endif + +/** + * RAW_DEBUG: Enable debugging in raw.c. + */ +#ifndef RAW_DEBUG +#define RAW_DEBUG LWIP_DBG_OFF +#endif + +/** + * MEM_DEBUG: Enable debugging in mem.c. + */ +#ifndef MEM_DEBUG +#define MEM_DEBUG LWIP_DBG_OFF +#endif + +/** + * MEMP_DEBUG: Enable debugging in memp.c. + */ +#ifndef MEMP_DEBUG +#define MEMP_DEBUG LWIP_DBG_OFF +#endif + +/** + * SYS_DEBUG: Enable debugging in sys.c. + */ +#ifndef SYS_DEBUG +#define SYS_DEBUG LWIP_DBG_OFF +#endif + +/** + * TIMERS_DEBUG: Enable debugging in timers.c. + */ +#ifndef TIMERS_DEBUG +#define TIMERS_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_DEBUG: Enable debugging for TCP. + */ +#ifndef TCP_DEBUG +#define TCP_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_INPUT_DEBUG: Enable debugging in tcp_in.c for incoming debug. + */ +#ifndef TCP_INPUT_DEBUG +#define TCP_INPUT_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_FR_DEBUG: Enable debugging in tcp_in.c for fast retransmit. + */ +#ifndef TCP_FR_DEBUG +#define TCP_FR_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_RTO_DEBUG: Enable debugging in TCP for retransmit + * timeout. + */ +#ifndef TCP_RTO_DEBUG +#define TCP_RTO_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_CWND_DEBUG: Enable debugging for TCP congestion window. + */ +#ifndef TCP_CWND_DEBUG +#define TCP_CWND_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_WND_DEBUG: Enable debugging in tcp_in.c for window updating. + */ +#ifndef TCP_WND_DEBUG +#define TCP_WND_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_OUTPUT_DEBUG: Enable debugging in tcp_out.c output functions. + */ +#ifndef TCP_OUTPUT_DEBUG +#define TCP_OUTPUT_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_RST_DEBUG: Enable debugging for TCP with the RST message. + */ +#ifndef TCP_RST_DEBUG +#define TCP_RST_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCP_QLEN_DEBUG: Enable debugging for TCP queue lengths. + */ +#ifndef TCP_QLEN_DEBUG +#define TCP_QLEN_DEBUG LWIP_DBG_OFF +#endif + +/** + * UDP_DEBUG: Enable debugging in UDP. + */ +#ifndef UDP_DEBUG +#define UDP_DEBUG LWIP_DBG_OFF +#endif + +/** + * TCPIP_DEBUG: Enable debugging in tcpip.c. + */ +#ifndef TCPIP_DEBUG +#define TCPIP_DEBUG LWIP_DBG_OFF +#endif + +/** + * PPP_DEBUG: Enable debugging for PPP. + */ +#ifndef PPP_DEBUG +#define PPP_DEBUG LWIP_DBG_OFF +#endif + +/** + * SLIP_DEBUG: Enable debugging in slipif.c. + */ +#ifndef SLIP_DEBUG +#define SLIP_DEBUG LWIP_DBG_OFF +#endif + +/** + * DHCP_DEBUG: Enable debugging in dhcp.c. + */ +#ifndef DHCP_DEBUG +#define DHCP_DEBUG LWIP_DBG_OFF +#endif + +/** + * AUTOIP_DEBUG: Enable debugging in autoip.c. + */ +#ifndef AUTOIP_DEBUG +#define AUTOIP_DEBUG LWIP_DBG_OFF +#endif + +/** + * DNS_DEBUG: Enable debugging for DNS. + */ +#ifndef DNS_DEBUG +#define DNS_DEBUG LWIP_DBG_OFF +#endif + +/** + * IP6_DEBUG: Enable debugging for IPv6. + */ +#ifndef IP6_DEBUG +#define IP6_DEBUG LWIP_DBG_OFF +#endif + +/* + -------------------------------------------------- + ---------- Performance tracking options ---------- + -------------------------------------------------- +*/ +/** + * LWIP_PERF: Enable performance testing for lwIP + * (if enabled, arch/perf.h is included) + */ +#ifndef LWIP_PERF +#define LWIP_PERF 0 +#endif + +#ifndef THREAD_SAFE_DEBUG +#define THREAD_SAFE_DEBUG 0 +#endif + +#endif /* LWIP_HDR_OPT_H */ diff --git a/components/lwip/include/lwip/lwip/pbuf.h b/components/lwip/include/lwip/lwip/pbuf.h new file mode 100755 index 000000000..aaf5e294a --- /dev/null +++ b/components/lwip/include/lwip/lwip/pbuf.h @@ -0,0 +1,231 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef LWIP_HDR_PBUF_H +#define LWIP_HDR_PBUF_H + +#include "lwip/opt.h" +#include "lwip/err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** LWIP_SUPPORT_CUSTOM_PBUF==1: Custom pbufs behave much like their pbuf type + * but they are allocated by external code (initialised by calling + * pbuf_alloced_custom()) and when pbuf_free gives up their last reference, they + * are freed by calling pbuf_custom->custom_free_function(). + * Currently, the pbuf_custom code is only needed for one specific configuration + * of IP_FRAG, unless required by external driver/application code. */ +#ifndef LWIP_SUPPORT_CUSTOM_PBUF +#define LWIP_SUPPORT_CUSTOM_PBUF ((IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF) || (LWIP_IPV6 && LWIP_IPV6_FRAG)) +#endif + +/* @todo: We need a mechanism to prevent wasting memory in every pbuf + (TCP vs. UDP, IPv4 vs. IPv6: UDP/IPv4 packets may waste up to 28 bytes) */ + +#define PBUF_TRANSPORT_HLEN 20 +#if LWIP_IPV6 +#define PBUF_IP_HLEN 40 +#else +#define PBUF_IP_HLEN 20 +#endif + +typedef enum { + PBUF_TRANSPORT, + PBUF_IP, + PBUF_LINK, + PBUF_RAW_TX, + PBUF_RAW +} pbuf_layer; + +typedef enum { + /** pbuf data is stored in RAM, used for TX mostly, struct pbuf and its payload + are allocated in one piece of contiguous memory (so the first payload byte + can be calculated from struct pbuf) + pbuf_alloc() allocates PBUF_RAM pbufs as unchained pbufs (although that might + change in future versions) */ + PBUF_RAM, + /** pbuf data is stored in ROM, i.e. struct pbuf and its payload are located in + totally different memory areas. Since it points to ROM, payload does not + have to be copied when queued for transmission. */ + PBUF_ROM, + /** pbuf comes from the pbuf pool. Much like PBUF_ROM but payload might change + so it has to be duplicated when queued before transmitting, depending on + who has a 'ref' to it. */ + PBUF_REF, + /** pbuf payload refers to RAM. This one comes from a pool and should be used + for RX. Payload can be chained (scatter-gather RX) but like PBUF_RAM, struct + pbuf and its payload are allocated in one piece of contiguous memory (so + the first payload byte can be calculated from struct pbuf) */ + PBUF_POOL +} pbuf_type; + + +/** indicates this packet's data should be immediately passed to the application */ +#define PBUF_FLAG_PUSH 0x01U +/** indicates this is a custom pbuf: pbuf_free calls pbuf_custom->custom_free_function() + when the last reference is released (plus custom PBUF_RAM cannot be trimmed) */ +#define PBUF_FLAG_IS_CUSTOM 0x02U +/** indicates this pbuf is UDP multicast to be looped back */ +#define PBUF_FLAG_MCASTLOOP 0x04U +/** indicates this pbuf was received as link-level broadcast */ +#define PBUF_FLAG_LLBCAST 0x08U +/** indicates this pbuf was received as link-level multicast */ +#define PBUF_FLAG_LLMCAST 0x10U +/** indicates this pbuf includes a TCP FIN flag */ +#define PBUF_FLAG_TCP_FIN 0x20U + +struct pbuf { + /** next pbuf in singly linked pbuf chain */ + struct pbuf *next; + + /** pointer to the actual data in the buffer */ + void *payload; + + /** + * total length of this buffer and all next buffers in chain + * belonging to the same packet. + * + * For non-queue packet chains this is the invariant: + * p->tot_len == p->len + (p->next? p->next->tot_len: 0) + */ + u16_t tot_len; + + /** length of this buffer */ + u16_t len; + + /** pbuf_type as u8_t instead of enum to save space */ + u8_t /*pbuf_type*/ type; + + /** misc flags */ + u8_t flags; + + /** + * the reference count always equals the number of pointers + * that refer to this pbuf. This can be pointers from an application, + * the stack itself, or pbuf->next pointers from a chain. + */ + u16_t ref; + +#ifdef LWIP_ESP8266 + void *eb; +#endif +}; + + +/** Helper struct for const-correctness only. + * The only meaning of this one is to provide a const payload pointer + * for PBUF_ROM type. + */ +struct pbuf_rom { + /** next pbuf in singly linked pbuf chain */ + struct pbuf *next; + + /** pointer to the actual data in the buffer */ + const void *payload; +}; + +#if LWIP_SUPPORT_CUSTOM_PBUF +/** Prototype for a function to free a custom pbuf */ +typedef void (*pbuf_free_custom_fn)(struct pbuf *p); + +/** A custom pbuf: like a pbuf, but following a function pointer to free it. */ +struct pbuf_custom { + /** The actual pbuf */ + struct pbuf pbuf; + /** This function is called when pbuf_free deallocates this pbuf(_custom) */ + pbuf_free_custom_fn custom_free_function; +}; +#endif /* LWIP_SUPPORT_CUSTOM_PBUF */ + +#if LWIP_TCP && TCP_QUEUE_OOSEQ +/** Define this to 0 to prevent freeing ooseq pbufs when the PBUF_POOL is empty */ +#ifndef PBUF_POOL_FREE_OOSEQ +#define PBUF_POOL_FREE_OOSEQ 1 +#endif /* PBUF_POOL_FREE_OOSEQ */ +#if NO_SYS && PBUF_POOL_FREE_OOSEQ +extern volatile u8_t pbuf_free_ooseq_pending; +void pbuf_free_ooseq(void); +/** When not using sys_check_timeouts(), call PBUF_CHECK_FREE_OOSEQ() + at regular intervals from main level to check if ooseq pbufs need to be + freed! */ +#define PBUF_CHECK_FREE_OOSEQ() do { if(pbuf_free_ooseq_pending) { \ + /* pbuf_alloc() reported PBUF_POOL to be empty -> try to free some \ + ooseq queued pbufs now */ \ + pbuf_free_ooseq(); }}while(0) +#endif /* NO_SYS && PBUF_POOL_FREE_OOSEQ*/ +#endif /* LWIP_TCP && TCP_QUEUE_OOSEQ */ + +/* Initializes the pbuf module. This call is empty for now, but may not be in future. */ +#define pbuf_init() + +struct pbuf *pbuf_alloc(pbuf_layer l, u16_t length, pbuf_type type); +#if LWIP_SUPPORT_CUSTOM_PBUF +struct pbuf *pbuf_alloced_custom(pbuf_layer l, u16_t length, pbuf_type type, + struct pbuf_custom *p, void *payload_mem, + u16_t payload_mem_len); +#endif /* LWIP_SUPPORT_CUSTOM_PBUF */ +void pbuf_realloc(struct pbuf *p, u16_t size); +u8_t pbuf_header(struct pbuf *p, s16_t header_size); +u8_t pbuf_header_force(struct pbuf *p, s16_t header_size); +void pbuf_ref(struct pbuf *p); +u8_t pbuf_free(struct pbuf *p); +u8_t pbuf_clen(struct pbuf *p); +void pbuf_cat(struct pbuf *head, struct pbuf *tail); +void pbuf_chain(struct pbuf *head, struct pbuf *tail); +struct pbuf *pbuf_dechain(struct pbuf *p); +err_t pbuf_copy(struct pbuf *p_to, struct pbuf *p_from); +u16_t pbuf_copy_partial(struct pbuf *p, void *dataptr, u16_t len, u16_t offset); +err_t pbuf_take(struct pbuf *buf, const void *dataptr, u16_t len); +err_t pbuf_take_at(struct pbuf *buf, const void *dataptr, u16_t len, u16_t offset); +struct pbuf *pbuf_skip(struct pbuf* in, u16_t in_offset, u16_t* out_offset); +struct pbuf *pbuf_coalesce(struct pbuf *p, pbuf_layer layer); +#if LWIP_CHECKSUM_ON_COPY +err_t pbuf_fill_chksum(struct pbuf *p, u16_t start_offset, const void *dataptr, + u16_t len, u16_t *chksum); +#endif /* LWIP_CHECKSUM_ON_COPY */ +#if LWIP_TCP && TCP_QUEUE_OOSEQ && LWIP_WND_SCALE +void pbuf_split_64k(struct pbuf *p, struct pbuf **rest); +#endif /* LWIP_TCP && TCP_QUEUE_OOSEQ && LWIP_WND_SCALE */ + +u8_t pbuf_get_at(struct pbuf* p, u16_t offset); +void pbuf_put_at(struct pbuf* p, u16_t offset, u8_t data); +u16_t pbuf_memcmp(struct pbuf* p, u16_t offset, const void* s2, u16_t n); +u16_t pbuf_memfind(struct pbuf* p, const void* mem, u16_t mem_len, u16_t start_offset); +u16_t pbuf_strstr(struct pbuf* p, const char* substr); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_PBUF_H */ diff --git a/components/lwip/include/lwip/lwip/pppapi.h b/components/lwip/include/lwip/lwip/pppapi.h new file mode 100755 index 000000000..3ddf3daf9 --- /dev/null +++ b/components/lwip/include/lwip/lwip/pppapi.h @@ -0,0 +1,148 @@ +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#ifndef __LWIP_PPPAPI_H__ +#define __LWIP_PPPAPI_H__ + +#include "lwip/opt.h" + +#if LWIP_PPP_API /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/sys.h" +#include "lwip/netif.h" +#include "lwip/priv/tcpip_priv.h" +#include "netif/ppp/ppp.h" +#if PPPOS_SUPPORT +#include "netif/ppp/pppos.h" +#endif /* PPPOS_SUPPORT */ + +#ifdef __cplusplus +extern "C" { +#endif + +struct pppapi_msg_msg { + ppp_pcb *ppp; + union { + struct { + u8_t authtype; + const char *user; + const char *passwd; + } setauth; +#if PPP_NOTIFY_PHASE + struct { + ppp_notify_phase_cb_fn notify_phase_cb; + } setnotifyphasecb; +#endif /* PPP_NOTIFY_PHASE */ +#if PPPOS_SUPPORT + struct { + struct netif *pppif; + pppos_output_cb_fn output_cb; + ppp_link_status_cb_fn link_status_cb; + void *ctx_cb; + } serialcreate; +#endif /* PPPOS_SUPPORT */ +#if PPPOE_SUPPORT + struct { + struct netif *pppif; + struct netif *ethif; + const char *service_name; + const char *concentrator_name; + ppp_link_status_cb_fn link_status_cb; + void *ctx_cb; + } ethernetcreate; +#endif /* PPPOE_SUPPORT */ +#if PPPOL2TP_SUPPORT + struct { + struct netif *pppif; + struct netif *netif; + ip_addr_t *ipaddr; + u16_t port; +#if PPPOL2TP_AUTH_SUPPORT + const u8_t *secret; + u8_t secret_len; +#endif /* PPPOL2TP_AUTH_SUPPORT */ + ppp_link_status_cb_fn link_status_cb; + void *ctx_cb; + } l2tpcreate; +#endif /* PPPOL2TP_SUPPORT */ + struct { + u16_t holdoff; + } connect; +#if PPP_SERVER + struct { + struct ppp_addrs *addrs; + } listen; +#endif /* PPP_SERVER */ + struct { + u8_t nocarrier; + } close; + struct { + u8_t cmd; + void *arg; + } ioctl; + } msg; +}; + +struct pppapi_msg { + struct tcpip_api_call call; + struct pppapi_msg_msg msg; +}; + +/* API for application */ +void pppapi_set_default(ppp_pcb *pcb); +void pppapi_set_auth(ppp_pcb *pcb, u8_t authtype, const char *user, const char *passwd); +#if PPP_NOTIFY_PHASE +void pppapi_set_notify_phase_callback(ppp_pcb *pcb, ppp_notify_phase_cb_fn notify_phase_cb); +#endif /* PPP_NOTIFY_PHASE */ +#if PPPOS_SUPPORT +ppp_pcb *pppapi_pppos_create(struct netif *pppif, pppos_output_cb_fn output_cb, ppp_link_status_cb_fn link_status_cb, void *ctx_cb); +#endif /* PPPOS_SUPPORT */ +#if PPPOE_SUPPORT +ppp_pcb *pppapi_pppoe_create(struct netif *pppif, struct netif *ethif, const char *service_name, + const char *concentrator_name, ppp_link_status_cb_fn link_status_cb, + void *ctx_cb); +#endif /* PPPOE_SUPPORT */ +#if PPPOL2TP_SUPPORT +ppp_pcb *pppapi_pppol2tp_create(struct netif *pppif, struct netif *netif, ip_addr_t *ipaddr, u16_t port, + const u8_t *secret, u8_t secret_len, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb); +#endif /* PPPOL2TP_SUPPORT */ +err_t pppapi_connect(ppp_pcb *pcb, u16_t holdoff); +#if PPP_SERVER +err_t pppapi_listen(ppp_pcb *pcb, struct ppp_addrs *addrs); +#endif /* PPP_SERVER */ +err_t pppapi_close(ppp_pcb *pcb, u8_t nocarrier); +err_t pppapi_free(ppp_pcb *pcb); +err_t pppapi_ioctl(ppp_pcb *pcb, u8_t cmd, void *arg); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_PPP_API */ + +#endif /* __LWIP_PPPAPI_H__ */ diff --git a/components/lwip/include/lwip/lwip/priv/api_msg.h b/components/lwip/include/lwip/lwip/priv/api_msg.h new file mode 100755 index 000000000..dceff82d6 --- /dev/null +++ b/components/lwip/include/lwip/lwip/priv/api_msg.h @@ -0,0 +1,260 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_API_MSG_H +#define LWIP_HDR_API_MSG_H + +#include "lwip/opt.h" + +#if LWIP_NETCONN || LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ +/* Note: Netconn API is always available when sockets are enabled - + * sockets are implemented on top of them */ + +#include /* for size_t */ + +#include "lwip/ip_addr.h" +#include "lwip/err.h" +#include "lwip/sys.h" +#include "lwip/igmp.h" +#include "lwip/api.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if LWIP_MPU_COMPATIBLE +#define API_MSG_M_DEF(m) m +#define API_MSG_M_DEF_C(t, m) t m +#if LWIP_NETCONN_SEM_PER_THREAD +#define API_MSG_M_DEF_SEM(m) *m +#else +#define API_MSG_M_DEF_SEM(m) API_MSG_M_DEF(m) +#endif +#else /* LWIP_MPU_COMPATIBLE */ +#define API_MSG_M_DEF(m) *m +#define API_MSG_M_DEF_C(t, m) const t * m +#define API_MSG_M_DEF_SEM(m) API_MSG_M_DEF(m) +#endif /* LWIP_MPU_COMPATIBLE */ + +/* For the netconn API, these values are use as a bitmask! */ +#define NETCONN_SHUT_RD 1 +#define NETCONN_SHUT_WR 2 +#define NETCONN_SHUT_RDWR (NETCONN_SHUT_RD | NETCONN_SHUT_WR) + +/* IP addresses and port numbers are expected to be in + * the same byte order as in the corresponding pcb. + */ +/** This struct includes everything that is necessary to execute a function + for a netconn in another thread context (mainly used to process netconns + in the tcpip_thread context to be thread safe). */ +struct api_msg_msg { + /** The netconn which to process - always needed: it includes the semaphore + which is used to block the application thread until the function finished. */ + struct netconn *conn; + /** The return value of the function executed in tcpip_thread. */ + err_t err; + /** Depending on the executed function, one of these union members is used */ + union { + /** used for lwip_netconn_do_send */ + struct netbuf *b; + /** used for lwip_netconn_do_newconn */ + struct { + u8_t proto; + } n; + /** used for lwip_netconn_do_bind and lwip_netconn_do_connect */ + struct { + API_MSG_M_DEF_C(ip_addr_t, ipaddr); + u16_t port; + } bc; + /** used for lwip_netconn_do_getaddr */ + struct { + ip_addr_t API_MSG_M_DEF(ipaddr); + u16_t API_MSG_M_DEF(port); + u8_t local; + } ad; + /** used for lwip_netconn_do_write */ + struct { + const void *dataptr; + size_t len; + u8_t apiflags; +#if LWIP_SO_SNDTIMEO + u32_t time_started; +#endif /* LWIP_SO_SNDTIMEO */ + } w; + /** used for lwip_netconn_do_recv */ + struct { + u32_t len; + } r; +#if LWIP_TCP + /** used for lwip_netconn_do_close (/shutdown) */ + struct { + u8_t shut; +#if LWIP_SO_SNDTIMEO || LWIP_SO_LINGER + u32_t time_started; +#else /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + u8_t polls_left; +#endif /* LWIP_SO_SNDTIMEO || LWIP_SO_LINGER */ + } sd; +#endif /* LWIP_TCP */ +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) + /** used for lwip_netconn_do_join_leave_group */ + struct { + API_MSG_M_DEF_C(ip_addr_t, multiaddr); + API_MSG_M_DEF_C(ip_addr_t, netif_addr); + enum netconn_igmp join_or_leave; + } jl; +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ +#if TCP_LISTEN_BACKLOG + struct { + u8_t backlog; + } lb; +#endif /* TCP_LISTEN_BACKLOG */ + } msg; +#if LWIP_NETCONN_SEM_PER_THREAD + sys_sem_t* op_completed_sem; +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ +}; + +#if LWIP_NETCONN_SEM_PER_THREAD +#define LWIP_API_MSG_SEM(msg) ((msg)->op_completed_sem) +#else /* LWIP_NETCONN_SEM_PER_THREAD */ +#define LWIP_API_MSG_SEM(msg) (&(msg)->conn->op_completed) +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + + +/** This struct contains a function to execute in another thread context and + a struct api_msg_msg that serves as an argument for this function. + This is passed to tcpip_apimsg to execute functions in tcpip_thread context. */ +struct api_msg { + /** function to execute in tcpip_thread context */ + void (* function)(void *msg); + /** arguments for this function */ + struct api_msg_msg msg; +}; + +#if LWIP_DNS +/** As lwip_netconn_do_gethostbyname requires more arguments but doesn't require a netconn, + it has its own struct (to avoid struct api_msg getting bigger than necessary). + lwip_netconn_do_gethostbyname must be called using tcpip_callback instead of tcpip_apimsg + (see netconn_gethostbyname). */ +struct dns_api_msg { + /** Hostname to query or dotted IP address string */ +#if LWIP_MPU_COMPATIBLE + char name[DNS_MAX_NAME_LENGTH]; +#else /* LWIP_MPU_COMPATIBLE */ + const char *name; +#endif /* LWIP_MPU_COMPATIBLE */ + /** The resolved address is stored here */ + ip_addr_t API_MSG_M_DEF(addr); +#if LWIP_IPV4 && LWIP_IPV6 + /** Type of resolve call */ + u8_t dns_addrtype; +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + /** This semaphore is posted when the name is resolved, the application thread + should wait on it. */ + sys_sem_t API_MSG_M_DEF_SEM(sem); + /** Errors are given back here */ + err_t API_MSG_M_DEF(err); +}; +#endif /* LWIP_DNS */ + +#if LWIP_NETCONN_SEM_PER_THREAD +#ifdef LWIP_ESP8266 +#define LWIP_NETCONN_THREAD_SEM_GET() sys_thread_sem() +#define LWIP_NETCONN_THREAD_SEM_ALLOC() +#define LWIP_NETCONN_THREAD_SEM_FREE() +#endif +#endif + +#if LWIP_TCPIP_CORE_LOCKING +#ifdef LWIP_DEBUG +#define TCIP_APIMSG_SET_ERR(m, e) (m)->msg.err = e /* catch functions that don't set err */ +#else +#define TCIP_APIMSG_SET_ERR(m, e) +#endif +#if LWIP_NETCONN_SEM_PER_THREAD +#define TCPIP_APIMSG_SET_SEM(m) ((m)->msg.op_completed_sem = LWIP_NETCONN_THREAD_SEM_GET()) +#else +#define TCPIP_APIMSG_SET_SEM(m) +#endif +#define TCPIP_APIMSG_NOERR(m,f) do { \ + TCIP_APIMSG_SET_ERR(m, ERR_VAL); \ + TCPIP_APIMSG_SET_SEM(m); \ + LOCK_TCPIP_CORE(); \ + f(&((m)->msg)); \ + UNLOCK_TCPIP_CORE(); \ +} while(0) +#define TCPIP_APIMSG(m,f,e) do { \ + TCPIP_APIMSG_NOERR(m,f); \ + (e) = (m)->msg.err; \ +} while(0) +#define TCPIP_APIMSG_ACK(m) NETCONN_SET_SAFE_ERR((m)->conn, (m)->err) +#else /* LWIP_TCPIP_CORE_LOCKING */ +#define TCPIP_APIMSG_NOERR(m,f) do { (m)->function = f; tcpip_apimsg(m); } while(0) +#define TCPIP_APIMSG(m,f,e) do { (m)->function = f; (e) = tcpip_apimsg(m); } while(0) +#define TCPIP_APIMSG_ACK(m) do { NETCONN_SET_SAFE_ERR((m)->conn, (m)->err); sys_sem_signal(LWIP_API_MSG_SEM(m)); } while(0) + +#ifdef LWIP_ESP8266 +#define TCPIP_APIMSG_ACK_SND(m) do { NETCONN_SET_SAFE_ERR((m)->conn, (m)->err); sys_sem_signal(LWIP_API_MSG_SND_SEM(m)); } while(0) +#endif + +#endif /* LWIP_TCPIP_CORE_LOCKING */ + +void lwip_netconn_do_newconn (void *m); +void lwip_netconn_do_delconn (void *m); +void lwip_netconn_do_bind (void *m); +void lwip_netconn_do_connect (void *m); +void lwip_netconn_do_disconnect (void *m); +void lwip_netconn_do_listen (void *m); +void lwip_netconn_do_send (void *m); +void lwip_netconn_do_recv (void *m); +void lwip_netconn_do_write (void *m); +void lwip_netconn_do_getaddr (void *m); +void lwip_netconn_do_close (void *m); +void lwip_netconn_do_shutdown (void *m); +#if LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) +void lwip_netconn_do_join_leave_group(void *m); +#endif /* LWIP_IGMP || (LWIP_IPV6 && LWIP_IPV6_MLD) */ + +#if LWIP_DNS +void lwip_netconn_do_gethostbyname(void *arg); +#endif /* LWIP_DNS */ + +struct netconn* netconn_alloc(enum netconn_type t, netconn_callback callback); +void netconn_free(struct netconn *conn); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_NETCONN || LWIP_SOCKET */ + +#endif /* LWIP_HDR_API_MSG_H */ diff --git a/components/lwip/include/lwip/lwip/priv/memp_priv.h b/components/lwip/include/lwip/lwip/priv/memp_priv.h new file mode 100755 index 000000000..34edb9d97 --- /dev/null +++ b/components/lwip/include/lwip/lwip/priv/memp_priv.h @@ -0,0 +1,163 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef LWIP_HDR_MEMP_PRIV_H +#define LWIP_HDR_MEMP_PRIV_H + +#include "lwip/opt.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#include "lwip/mem.h" + +#if MEMP_OVERFLOW_CHECK +/* if MEMP_OVERFLOW_CHECK is turned on, we reserve some bytes at the beginning + * and at the end of each element, initialize them as 0xcd and check + * them later. */ +/* If MEMP_OVERFLOW_CHECK is >= 2, on every call to memp_malloc or memp_free, + * every single element in each pool is checked! + * This is VERY SLOW but also very helpful. */ +/* MEMP_SANITY_REGION_BEFORE and MEMP_SANITY_REGION_AFTER can be overridden in + * lwipopts.h to change the amount reserved for checking. */ +#ifndef MEMP_SANITY_REGION_BEFORE +#define MEMP_SANITY_REGION_BEFORE 16 +#endif /* MEMP_SANITY_REGION_BEFORE*/ +#if MEMP_SANITY_REGION_BEFORE > 0 +#define MEMP_SANITY_REGION_BEFORE_ALIGNED LWIP_MEM_ALIGN_SIZE(MEMP_SANITY_REGION_BEFORE) +#else +#define MEMP_SANITY_REGION_BEFORE_ALIGNED 0 +#endif /* MEMP_SANITY_REGION_BEFORE*/ +#ifndef MEMP_SANITY_REGION_AFTER +#define MEMP_SANITY_REGION_AFTER 16 +#endif /* MEMP_SANITY_REGION_AFTER*/ +#if MEMP_SANITY_REGION_AFTER > 0 +#define MEMP_SANITY_REGION_AFTER_ALIGNED LWIP_MEM_ALIGN_SIZE(MEMP_SANITY_REGION_AFTER) +#else +#define MEMP_SANITY_REGION_AFTER_ALIGNED 0 +#endif /* MEMP_SANITY_REGION_AFTER*/ + +/* MEMP_SIZE: save space for struct memp and for sanity check */ +#define MEMP_SIZE (LWIP_MEM_ALIGN_SIZE(sizeof(struct memp)) + MEMP_SANITY_REGION_BEFORE_ALIGNED) +#define MEMP_ALIGN_SIZE(x) (LWIP_MEM_ALIGN_SIZE(x) + MEMP_SANITY_REGION_AFTER_ALIGNED) + +#else /* MEMP_OVERFLOW_CHECK */ + +/* No sanity checks + * We don't need to preserve the struct memp while not allocated, so we + * can save a little space and set MEMP_SIZE to 0. + */ +#define MEMP_SIZE 0 +#define MEMP_ALIGN_SIZE(x) (LWIP_MEM_ALIGN_SIZE(x)) + +#endif /* MEMP_OVERFLOW_CHECK */ + +struct memp { + struct memp *next; +#if MEMP_OVERFLOW_CHECK + const char *file; + int line; +#endif /* MEMP_OVERFLOW_CHECK */ +}; + +#if MEM_USE_POOLS +/* Use a helper type to get the start and end of the user "memory pools" for mem_malloc */ +typedef enum { + /* Get the first (via: + MEMP_POOL_HELPER_START = ((u8_t) 1*MEMP_POOL_A + 0*MEMP_POOL_B + 0*MEMP_POOL_C + 0)*/ + MEMP_POOL_HELPER_FIRST = ((u8_t) +#define LWIP_MEMPOOL(name,num,size,desc) +#define LWIP_MALLOC_MEMPOOL_START 1 +#define LWIP_MALLOC_MEMPOOL(num, size) * MEMP_POOL_##size + 0 +#define LWIP_MALLOC_MEMPOOL_END +#include "lwip/priv/memp_std.h" + ) , + /* Get the last (via: + MEMP_POOL_HELPER_END = ((u8_t) 0 + MEMP_POOL_A*0 + MEMP_POOL_B*0 + MEMP_POOL_C*1) */ + MEMP_POOL_HELPER_LAST = ((u8_t) +#define LWIP_MEMPOOL(name,num,size,desc) +#define LWIP_MALLOC_MEMPOOL_START +#define LWIP_MALLOC_MEMPOOL(num, size) 0 + MEMP_POOL_##size * +#define LWIP_MALLOC_MEMPOOL_END 1 +#include "lwip/priv/memp_std.h" + ) +} memp_pool_helper_t; + +/* The actual start and stop values are here (cast them over) + We use this helper type and these defines so we can avoid using const memp_t values */ +#define MEMP_POOL_FIRST ((memp_t) MEMP_POOL_HELPER_FIRST) +#define MEMP_POOL_LAST ((memp_t) MEMP_POOL_HELPER_LAST) +#endif /* MEM_USE_POOLS */ + +struct memp_desc { + /** Element size */ + u16_t size; + +#if !MEMP_MEM_MALLOC + /** Number of elements */ + u16_t num; + +#if defined(LWIP_DEBUG) || MEMP_OVERFLOW_CHECK + /** Textual description */ + const char *desc; +#endif /* LWIP_DEBUG || MEMP_OVERFLOW_CHECK */ + + /** Base */ + u8_t *base; + + /** First free element of each pool. Elements form a linked list. */ + struct memp **tab; +#endif /* MEMP_MEM_MALLOC */ +}; + +#ifdef LWIP_DEBUG +#define DECLARE_LWIP_MEMPOOL_DESC(desc) (desc), +#else +#define DECLARE_LWIP_MEMPOOL_DESC(desc) +#endif + +void memp_init_pool(const struct memp_desc *desc); + +#if MEMP_OVERFLOW_CHECK +void *memp_malloc_pool_fn(const struct memp_desc* desc, const char* file, const int line); +#define memp_malloc_pool(d) memp_malloc_pool_fn((d), __FILE__, __LINE__) +#else +void *memp_malloc_pool(const struct memp_desc *desc); +#endif +void memp_free_pool(const struct memp_desc* desc, void *mem); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_MEMP_PRIV_H */ diff --git a/components/lwip/include/lwip/lwip/priv/memp_std.h b/components/lwip/include/lwip/lwip/priv/memp_std.h new file mode 100755 index 000000000..4def116d8 --- /dev/null +++ b/components/lwip/include/lwip/lwip/priv/memp_std.h @@ -0,0 +1,151 @@ +/* + * SETUP: Make sure we define everything we will need. + * + * We have create three types of pools: + * 1) MEMPOOL - standard pools + * 2) MALLOC_MEMPOOL - to be used by mem_malloc in mem.c + * 3) PBUF_MEMPOOL - a mempool of pbuf's, so include space for the pbuf struct + * + * If the include'r doesn't require any special treatment of each of the types + * above, then will declare #2 & #3 to be just standard mempools. + */ +#ifndef LWIP_MALLOC_MEMPOOL +/* This treats "malloc pools" just like any other pool. + The pools are a little bigger to provide 'size' as the amount of user data. */ +#define LWIP_MALLOC_MEMPOOL(num, size) LWIP_MEMPOOL(POOL_##size, num, (size + LWIP_MEM_ALIGN_SIZE(sizeof(struct memp_malloc_helper))), "MALLOC_"#size) +#define LWIP_MALLOC_MEMPOOL_START +#define LWIP_MALLOC_MEMPOOL_END +#endif /* LWIP_MALLOC_MEMPOOL */ + +#ifndef LWIP_PBUF_MEMPOOL +/* This treats "pbuf pools" just like any other pool. + * Allocates buffers for a pbuf struct AND a payload size */ +#define LWIP_PBUF_MEMPOOL(name, num, payload, desc) LWIP_MEMPOOL(name, num, (MEMP_ALIGN_SIZE(sizeof(struct pbuf)) + MEMP_ALIGN_SIZE(payload)), desc) +#endif /* LWIP_PBUF_MEMPOOL */ + + +/* + * A list of internal pools used by LWIP. + * + * LWIP_MEMPOOL(pool_name, number_elements, element_size, pool_description) + * creates a pool name MEMP_pool_name. description is used in stats.c + */ +#if LWIP_RAW +LWIP_MEMPOOL(RAW_PCB, MEMP_NUM_RAW_PCB, sizeof(struct raw_pcb), "RAW_PCB") +#endif /* LWIP_RAW */ + +#if LWIP_UDP +LWIP_MEMPOOL(UDP_PCB, MEMP_NUM_UDP_PCB, sizeof(struct udp_pcb), "UDP_PCB") +#endif /* LWIP_UDP */ + +#if LWIP_TCP +LWIP_MEMPOOL(TCP_PCB, MEMP_NUM_TCP_PCB, sizeof(struct tcp_pcb), "TCP_PCB") +LWIP_MEMPOOL(TCP_PCB_LISTEN, MEMP_NUM_TCP_PCB_LISTEN, sizeof(struct tcp_pcb_listen), "TCP_PCB_LISTEN") +LWIP_MEMPOOL(TCP_SEG, MEMP_NUM_TCP_SEG, sizeof(struct tcp_seg), "TCP_SEG") +#endif /* LWIP_TCP */ + +#if LWIP_IPV4 && IP_REASSEMBLY +LWIP_MEMPOOL(REASSDATA, MEMP_NUM_REASSDATA, sizeof(struct ip_reassdata), "REASSDATA") +#endif /* LWIP_IPV4 && IP_REASSEMBLY */ +#if (IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF) || (LWIP_IPV6 && LWIP_IPV6_FRAG) +LWIP_MEMPOOL(FRAG_PBUF, MEMP_NUM_FRAG_PBUF, sizeof(struct pbuf_custom_ref),"FRAG_PBUF") +#endif /* IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF */ + +#if LWIP_NETCONN || LWIP_SOCKET +LWIP_MEMPOOL(NETBUF, MEMP_NUM_NETBUF, sizeof(struct netbuf), "NETBUF") +LWIP_MEMPOOL(NETCONN, MEMP_NUM_NETCONN, sizeof(struct netconn), "NETCONN") +#endif /* LWIP_NETCONN || LWIP_SOCKET */ + +#if NO_SYS==0 +LWIP_MEMPOOL(TCPIP_MSG_API, MEMP_NUM_TCPIP_MSG_API, sizeof(struct tcpip_msg), "TCPIP_MSG_API") +#if LWIP_MPU_COMPATIBLE +LWIP_MEMPOOL(API_MSG, MEMP_NUM_API_MSG, sizeof(struct api_msg), "API_MSG") +#if LWIP_DNS +LWIP_MEMPOOL(DNS_API_MSG, MEMP_NUM_DNS_API_MSG, sizeof(struct dns_api_msg), "DNS_API_MSG") +#endif +#if LWIP_SOCKET && !LWIP_TCPIP_CORE_LOCKING +LWIP_MEMPOOL(SOCKET_SETGETSOCKOPT_DATA, MEMP_NUM_SOCKET_SETGETSOCKOPT_DATA, sizeof(struct lwip_setgetsockopt_data), "SOCKET_SETGETSOCKOPT_DATA") +#endif +#if LWIP_NETIF_API +LWIP_MEMPOOL(NETIFAPI_MSG, MEMP_NUM_NETIFAPI_MSG, sizeof(struct netifapi_msg), "NETIFAPI_MSG") +#endif +#endif /* LWIP_MPU_COMPATIBLE */ +#if !LWIP_TCPIP_CORE_LOCKING_INPUT +LWIP_MEMPOOL(TCPIP_MSG_INPKT,MEMP_NUM_TCPIP_MSG_INPKT, sizeof(struct tcpip_msg), "TCPIP_MSG_INPKT") +#endif /* !LWIP_TCPIP_CORE_LOCKING_INPUT */ +#endif /* NO_SYS==0 */ + +#if LWIP_IPV4 && LWIP_ARP && ARP_QUEUEING +LWIP_MEMPOOL(ARP_QUEUE, MEMP_NUM_ARP_QUEUE, sizeof(struct etharp_q_entry), "ARP_QUEUE") +#endif /* LWIP_IPV4 && LWIP_ARP && ARP_QUEUEING */ + +#if LWIP_IGMP +LWIP_MEMPOOL(IGMP_GROUP, MEMP_NUM_IGMP_GROUP, sizeof(struct igmp_group), "IGMP_GROUP") +#endif /* LWIP_IGMP */ + +#if (!NO_SYS || (NO_SYS && !NO_SYS_NO_TIMERS)) /* LWIP_TIMERS */ +LWIP_MEMPOOL(SYS_TIMEOUT, MEMP_NUM_SYS_TIMEOUT, sizeof(struct sys_timeo), "SYS_TIMEOUT") +#endif /* LWIP_TIMERS */ + +#if LWIP_DNS && LWIP_SOCKET +LWIP_MEMPOOL(NETDB, MEMP_NUM_NETDB, NETDB_ELEM_SIZE, "NETDB") +#endif /* LWIP_DNS && LWIP_SOCKET */ +#if LWIP_DNS && DNS_LOCAL_HOSTLIST && DNS_LOCAL_HOSTLIST_IS_DYNAMIC +LWIP_MEMPOOL(LOCALHOSTLIST, MEMP_NUM_LOCALHOSTLIST, LOCALHOSTLIST_ELEM_SIZE, "LOCALHOSTLIST") +#endif /* LWIP_DNS && DNS_LOCAL_HOSTLIST && DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ + +#if PPP_SUPPORT +LWIP_MEMPOOL(PPP_PCB, MEMP_NUM_PPP_PCB, sizeof(ppp_pcb), "PPP_PCB") +#if PPPOS_SUPPORT +LWIP_MEMPOOL(PPPOS_PCB, MEMP_NUM_PPPOS_INTERFACES, sizeof(pppos_pcb), "PPPOS_PCB") +#endif /* PPPOS_SUPPORT */ +#if PPPOE_SUPPORT +LWIP_MEMPOOL(PPPOE_IF, MEMP_NUM_PPPOE_INTERFACES, sizeof(struct pppoe_softc), "PPPOE_IF") +#endif /* PPPOE_SUPPORT */ +#if PPPOL2TP_SUPPORT +LWIP_MEMPOOL(PPPOL2TP_PCB, MEMP_NUM_PPPOL2TP_INTERFACES, sizeof(pppol2tp_pcb), "PPPOL2TP_PCB") +#endif /* PPPOL2TP_SUPPORT */ +#endif /* PPP_SUPPORT */ + +#if LWIP_IPV6 && LWIP_ND6_QUEUEING +LWIP_MEMPOOL(ND6_QUEUE, MEMP_NUM_ND6_QUEUE, sizeof(struct nd6_q_entry), "ND6_QUEUE") +#endif /* LWIP_IPV6 && LWIP_ND6_QUEUEING */ + +#if LWIP_IPV6 && LWIP_IPV6_REASS +LWIP_MEMPOOL(IP6_REASSDATA, MEMP_NUM_REASSDATA, sizeof(struct ip6_reassdata), "IP6_REASSDATA") +#endif /* LWIP_IPV6 && LWIP_IPV6_REASS */ + +#if LWIP_IPV6 && LWIP_IPV6_MLD +LWIP_MEMPOOL(MLD6_GROUP, MEMP_NUM_MLD6_GROUP, sizeof(struct mld_group), "MLD6_GROUP") +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + + +/* + * A list of pools of pbuf's used by LWIP. + * + * LWIP_PBUF_MEMPOOL(pool_name, number_elements, pbuf_payload_size, pool_description) + * creates a pool name MEMP_pool_name. description is used in stats.c + * This allocates enough space for the pbuf struct and a payload. + * (Example: pbuf_payload_size=0 allocates only size for the struct) + */ +LWIP_PBUF_MEMPOOL(PBUF, MEMP_NUM_PBUF, 0, "PBUF_REF/ROM") +LWIP_PBUF_MEMPOOL(PBUF_POOL, PBUF_POOL_SIZE, PBUF_POOL_BUFSIZE, "PBUF_POOL") + + +/* + * Allow for user-defined pools; this must be explicitly set in lwipopts.h + * since the default is to NOT look for lwippools.h + */ +#if MEMP_USE_CUSTOM_POOLS +#include "lwippools.h" +#endif /* MEMP_USE_CUSTOM_POOLS */ + +/* + * REQUIRED CLEANUP: Clear up so we don't get "multiply defined" error later + * (#undef is ignored for something that is not defined) + */ +#undef LWIP_MEMPOOL +#undef LWIP_MALLOC_MEMPOOL +#undef LWIP_MALLOC_MEMPOOL_START +#undef LWIP_MALLOC_MEMPOOL_END +#undef LWIP_PBUF_MEMPOOL diff --git a/components/lwip/include/lwip/lwip/priv/tcp_priv.h b/components/lwip/include/lwip/lwip/priv/tcp_priv.h new file mode 100755 index 000000000..b5261b445 --- /dev/null +++ b/components/lwip/include/lwip/lwip/priv/tcp_priv.h @@ -0,0 +1,545 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_TCP_IMPL_H +#define LWIP_HDR_TCP_IMPL_H + +#include "lwip/opt.h" + +#if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/tcp.h" +#include "lwip/mem.h" +#include "lwip/pbuf.h" +#include "lwip/ip.h" +#include "lwip/icmp.h" +#include "lwip/err.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* Functions for interfacing with TCP: */ + +/* Lower layer interface to TCP: */ +void tcp_init (void); /* Initialize this module. */ +void tcp_tmr (void); /* Must be called every + TCP_TMR_INTERVAL + ms. (Typically 250 ms). */ +/* It is also possible to call these two functions at the right + intervals (instead of calling tcp_tmr()). */ +void tcp_slowtmr (void); +void tcp_fasttmr (void); + +/* Call this from a netif driver (watch out for threading issues!) that has + returned a memory error on transmit and now has free buffers to send more. + This iterates all active pcbs that had an error and tries to call + tcp_output, so use this with care as it might slow down the system. */ +void tcp_txnow (void); + +/* Only used by IP to pass a TCP segment to TCP: */ +void tcp_input (struct pbuf *p, struct netif *inp); +/* Used within the TCP code only: */ +struct tcp_pcb * tcp_alloc (u8_t prio); +void tcp_abandon (struct tcp_pcb *pcb, int reset); +err_t tcp_send_empty_ack(struct tcp_pcb *pcb); +void tcp_rexmit (struct tcp_pcb *pcb); +void tcp_rexmit_rto (struct tcp_pcb *pcb); +void tcp_rexmit_fast (struct tcp_pcb *pcb); +u32_t tcp_update_rcv_ann_wnd(struct tcp_pcb *pcb); +err_t tcp_process_refused_data(struct tcp_pcb *pcb); + +/** + * This is the Nagle algorithm: try to combine user data to send as few TCP + * segments as possible. Only send if + * - no previously transmitted data on the connection remains unacknowledged or + * - the TF_NODELAY flag is set (nagle algorithm turned off for this pcb) or + * - the only unsent segment is at least pcb->mss bytes long (or there is more + * than one unsent segment - with lwIP, this can happen although unsent->len < mss) + * - or if we are in fast-retransmit (TF_INFR) + */ +#define tcp_do_output_nagle(tpcb) ((((tpcb)->unacked == NULL) || \ + ((tpcb)->flags & (TF_NODELAY | TF_INFR)) || \ + (((tpcb)->unsent != NULL) && (((tpcb)->unsent->next != NULL) || \ + ((tpcb)->unsent->len >= (tpcb)->mss))) || \ + ((tcp_sndbuf(tpcb) == 0) || (tcp_sndqueuelen(tpcb) >= TCP_SND_QUEUELEN)) \ + ) ? 1 : 0) +#define tcp_output_nagle(tpcb) (tcp_do_output_nagle(tpcb) ? tcp_output(tpcb) : ERR_OK) + + +#define TCP_SEQ_LT(a,b) ((s32_t)((u32_t)(a) - (u32_t)(b)) < 0) +#define TCP_SEQ_LEQ(a,b) ((s32_t)((u32_t)(a) - (u32_t)(b)) <= 0) +#define TCP_SEQ_GT(a,b) ((s32_t)((u32_t)(a) - (u32_t)(b)) > 0) +#define TCP_SEQ_GEQ(a,b) ((s32_t)((u32_t)(a) - (u32_t)(b)) >= 0) +/* is b<=a<=c? */ +#if 0 /* see bug #10548 */ +#define TCP_SEQ_BETWEEN(a,b,c) ((c)-(b) >= (a)-(b)) +#endif +#define TCP_SEQ_BETWEEN(a,b,c) (TCP_SEQ_GEQ(a,b) && TCP_SEQ_LEQ(a,c)) +#define TCP_FIN 0x01U +#define TCP_SYN 0x02U +#define TCP_RST 0x04U +#define TCP_PSH 0x08U +#define TCP_ACK 0x10U +#define TCP_URG 0x20U +#define TCP_ECE 0x40U +#define TCP_CWR 0x80U + +#define TCP_FLAGS 0x3fU + +/* Length of the TCP header, excluding options. */ +#define TCP_HLEN 20 + +#ifndef TCP_TMR_INTERVAL +#define TCP_TMR_INTERVAL 250 /* The TCP timer interval in milliseconds. */ +#endif /* TCP_TMR_INTERVAL */ + +#ifndef TCP_FAST_INTERVAL +#define TCP_FAST_INTERVAL TCP_TMR_INTERVAL /* the fine grained timeout in milliseconds */ +#endif /* TCP_FAST_INTERVAL */ + +#ifndef TCP_SLOW_INTERVAL +#define TCP_SLOW_INTERVAL (2*TCP_TMR_INTERVAL) /* the coarse grained timeout in milliseconds */ +#endif /* TCP_SLOW_INTERVAL */ + +#define TCP_FIN_WAIT_TIMEOUT 20000 /* milliseconds */ +#define TCP_SYN_RCVD_TIMEOUT 20000 /* milliseconds */ + +#define TCP_OOSEQ_TIMEOUT 6U /* x RTO */ + +#ifndef TCP_MSL +#define TCP_MSL 60000UL /* The maximum segment lifetime in milliseconds */ +#endif + +/* Keepalive values, compliant with RFC 1122. Don't change this unless you know what you're doing */ +#ifndef TCP_KEEPIDLE_DEFAULT +#define TCP_KEEPIDLE_DEFAULT 7200000UL /* Default KEEPALIVE timer in milliseconds */ +#endif + +#ifndef TCP_KEEPINTVL_DEFAULT +#define TCP_KEEPINTVL_DEFAULT 75000UL /* Default Time between KEEPALIVE probes in milliseconds */ +#endif + +#ifndef TCP_KEEPCNT_DEFAULT +#define TCP_KEEPCNT_DEFAULT 9U /* Default Counter for KEEPALIVE probes */ +#endif + +#define TCP_MAXIDLE TCP_KEEPCNT_DEFAULT * TCP_KEEPINTVL_DEFAULT /* Maximum KEEPALIVE probe time */ + +/* Fields are (of course) in network byte order. + * Some fields are converted to host byte order in tcp_input(). + */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct tcp_hdr { + PACK_STRUCT_FIELD(u16_t src); + PACK_STRUCT_FIELD(u16_t dest); + PACK_STRUCT_FIELD(u32_t seqno); + PACK_STRUCT_FIELD(u32_t ackno); + PACK_STRUCT_FIELD(u16_t _hdrlen_rsvd_flags); + PACK_STRUCT_FIELD(u16_t wnd); + PACK_STRUCT_FIELD(u16_t chksum); + PACK_STRUCT_FIELD(u16_t urgp); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define TCPH_HDRLEN(phdr) (ntohs((phdr)->_hdrlen_rsvd_flags) >> 12) +#define TCPH_FLAGS(phdr) (ntohs((phdr)->_hdrlen_rsvd_flags) & TCP_FLAGS) + +#define TCPH_HDRLEN_SET(phdr, len) (phdr)->_hdrlen_rsvd_flags = htons(((len) << 12) | TCPH_FLAGS(phdr)) +#define TCPH_FLAGS_SET(phdr, flags) (phdr)->_hdrlen_rsvd_flags = (((phdr)->_hdrlen_rsvd_flags & PP_HTONS(~TCP_FLAGS)) | htons(flags)) +#define TCPH_HDRLEN_FLAGS_SET(phdr, len, flags) (phdr)->_hdrlen_rsvd_flags = htons(((len) << 12) | (flags)) + +#define TCPH_SET_FLAG(phdr, flags ) (phdr)->_hdrlen_rsvd_flags = ((phdr)->_hdrlen_rsvd_flags | htons(flags)) +#define TCPH_UNSET_FLAG(phdr, flags) (phdr)->_hdrlen_rsvd_flags = ((phdr)->_hdrlen_rsvd_flags & ~htons(flags)) + +#define TCP_TCPLEN(seg) ((seg)->len + (((TCPH_FLAGS((seg)->tcphdr) & (TCP_FIN | TCP_SYN)) != 0) ? 1U : 0U)) + +/** Flags used on input processing, not on pcb->flags +*/ +#define TF_RESET (u8_t)0x08U /* Connection was reset. */ +#define TF_CLOSED (u8_t)0x10U /* Connection was successfully closed. */ +#define TF_GOT_FIN (u8_t)0x20U /* Connection was closed by the remote end. */ + + +#if LWIP_EVENT_API + +#define TCP_EVENT_ACCEPT(pcb,err,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_ACCEPT, NULL, 0, err) +#define TCP_EVENT_SENT(pcb,space,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_SENT, NULL, space, ERR_OK) +#define TCP_EVENT_RECV(pcb,p,err,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_RECV, (p), 0, (err)) +#define TCP_EVENT_CLOSED(pcb,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_RECV, NULL, 0, ERR_OK) +#define TCP_EVENT_CONNECTED(pcb,err,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_CONNECTED, NULL, 0, (err)) +#define TCP_EVENT_POLL(pcb,ret) ret = lwip_tcp_event((pcb)->callback_arg, (pcb),\ + LWIP_EVENT_POLL, NULL, 0, ERR_OK) +#define TCP_EVENT_ERR(errf,arg,err) lwip_tcp_event((arg), NULL, \ + LWIP_EVENT_ERR, NULL, 0, (err)) + +#else /* LWIP_EVENT_API */ + +#define TCP_EVENT_ACCEPT(pcb,err,ret) \ + do { \ + if((pcb)->accept != NULL) \ + (ret) = (pcb)->accept((pcb)->callback_arg,(pcb),(err)); \ + else (ret) = ERR_ARG; \ + } while (0) + +#define TCP_EVENT_SENT(pcb,space,ret) \ + do { \ + if((pcb)->sent != NULL) \ + (ret) = (pcb)->sent((pcb)->callback_arg,(pcb),(space)); \ + else (ret) = ERR_OK; \ + } while (0) + +#define TCP_EVENT_RECV(pcb,p,err,ret) \ + do { \ + if((pcb)->recv != NULL) { \ + (ret) = (pcb)->recv((pcb)->callback_arg,(pcb),(p),(err));\ + } else { \ + (ret) = tcp_recv_null(NULL, (pcb), (p), (err)); \ + } \ + } while (0) + +#define TCP_EVENT_CLOSED(pcb,ret) \ + do { \ + if(((pcb)->recv != NULL)) { \ + (ret) = (pcb)->recv((pcb)->callback_arg,(pcb),NULL,ERR_OK);\ + } else { \ + (ret) = ERR_OK; \ + } \ + } while (0) + +#define TCP_EVENT_CONNECTED(pcb,err,ret) \ + do { \ + if((pcb)->connected != NULL) \ + (ret) = (pcb)->connected((pcb)->callback_arg,(pcb),(err)); \ + else (ret) = ERR_OK; \ + } while (0) + +#define TCP_EVENT_POLL(pcb,ret) \ + do { \ + if((pcb)->poll != NULL) \ + (ret) = (pcb)->poll((pcb)->callback_arg,(pcb)); \ + else (ret) = ERR_OK; \ + } while (0) + +#define TCP_EVENT_ERR(errf,arg,err) \ + do { \ + if((errf) != NULL) \ + (errf)((arg),(err)); \ + } while (0) + +#endif /* LWIP_EVENT_API */ + +/** Enabled extra-check for TCP_OVERSIZE if LWIP_DEBUG is enabled */ +#if TCP_OVERSIZE && defined(LWIP_DEBUG) +#define TCP_OVERSIZE_DBGCHECK 1 +#else +#define TCP_OVERSIZE_DBGCHECK 0 +#endif + +/** Don't generate checksum on copy if CHECKSUM_GEN_TCP is disabled */ +#define TCP_CHECKSUM_ON_COPY (LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_TCP) + +/* This structure represents a TCP segment on the unsent, unacked and ooseq queues */ +struct tcp_seg { + struct tcp_seg *next; /* used when putting segments on a queue */ + struct pbuf *p; /* buffer containing data + TCP header */ + u16_t len; /* the TCP length of this segment */ +#if TCP_OVERSIZE_DBGCHECK + u16_t oversize_left; /* Extra bytes available at the end of the last + pbuf in unsent (used for asserting vs. + tcp_pcb.unsent_oversized only) */ +#endif /* TCP_OVERSIZE_DBGCHECK */ +#if TCP_CHECKSUM_ON_COPY + u16_t chksum; + u8_t chksum_swapped; +#endif /* TCP_CHECKSUM_ON_COPY */ + u8_t flags; +#define TF_SEG_OPTS_MSS (u8_t)0x01U /* Include MSS option. */ +#define TF_SEG_OPTS_TS (u8_t)0x02U /* Include timestamp option. */ +#define TF_SEG_DATA_CHECKSUMMED (u8_t)0x04U /* ALL data (not the header) is + checksummed into 'chksum' */ +#define TF_SEG_OPTS_WND_SCALE (u8_t)0x08U /* Include WND SCALE option */ + struct tcp_hdr *tcphdr; /* the TCP header */ +}; + +#define LWIP_TCP_OPT_EOL 0 +#define LWIP_TCP_OPT_NOP 1 +#define LWIP_TCP_OPT_MSS 2 +#define LWIP_TCP_OPT_WS 3 +#define LWIP_TCP_OPT_TS 8 + +#define LWIP_TCP_OPT_LEN_MSS 4 +#if LWIP_TCP_TIMESTAMPS +#define LWIP_TCP_OPT_LEN_TS 10 +#define LWIP_TCP_OPT_LEN_TS_OUT 12 /* aligned for output (includes NOP padding) */ +#else +#define LWIP_TCP_OPT_LEN_TS_OUT 0 +#endif +#if LWIP_WND_SCALE +#define LWIP_TCP_OPT_LEN_WS 3 +#define LWIP_TCP_OPT_LEN_WS_OUT 4 /* aligned for output (includes NOP padding) */ +#else +#define LWIP_TCP_OPT_LEN_WS_OUT 0 +#endif + +#define LWIP_TCP_OPT_LENGTH(flags) \ + (flags & TF_SEG_OPTS_MSS ? LWIP_TCP_OPT_LEN_MSS : 0) + \ + (flags & TF_SEG_OPTS_TS ? LWIP_TCP_OPT_LEN_TS_OUT : 0) + \ + (flags & TF_SEG_OPTS_WND_SCALE ? LWIP_TCP_OPT_LEN_WS_OUT : 0) + +/** This returns a TCP header option for MSS in an u32_t */ +#define TCP_BUILD_MSS_OPTION(mss) htonl(0x02040000 | ((mss) & 0xFFFF)) + +#if LWIP_WND_SCALE +#define TCPWNDSIZE_F U32_F +#define TCPWND_MAX 0xFFFFFFFFU +#define TCPWND_CHECK16(x) LWIP_ASSERT("window size > 0xFFFF", (x) <= 0xFFFF) +#define TCPWND_MIN16(x) ((u16_t)LWIP_MIN((x), 0xFFFF)) +#else /* LWIP_WND_SCALE */ +#define TCPWNDSIZE_F U16_F +#define TCPWND_MAX 0xFFFFU +#define TCPWND_CHECK16(x) +#define TCPWND_MIN16(x) x +#endif /* LWIP_WND_SCALE */ + +/* Global variables: */ +extern struct tcp_pcb *tcp_input_pcb; +extern u32_t tcp_ticks; +extern u8_t tcp_active_pcbs_changed; + +/* The TCP PCB lists. */ +union tcp_listen_pcbs_t { /* List of all TCP PCBs in LISTEN state. */ + struct tcp_pcb_listen *listen_pcbs; + struct tcp_pcb *pcbs; +}; +extern struct tcp_pcb *tcp_bound_pcbs; +extern union tcp_listen_pcbs_t tcp_listen_pcbs; +extern struct tcp_pcb *tcp_active_pcbs; /* List of all TCP PCBs that are in a + state in which they accept or send + data. */ +extern struct tcp_pcb *tcp_tw_pcbs; /* List of all TCP PCBs in TIME-WAIT. */ + +#define NUM_TCP_PCB_LISTS_NO_TIME_WAIT 3 +#define NUM_TCP_PCB_LISTS 4 +extern struct tcp_pcb ** const tcp_pcb_lists[NUM_TCP_PCB_LISTS]; + +/* Axioms about the above lists: + 1) Every TCP PCB that is not CLOSED is in one of the lists. + 2) A PCB is only in one of the lists. + 3) All PCBs in the tcp_listen_pcbs list is in LISTEN state. + 4) All PCBs in the tcp_tw_pcbs list is in TIME-WAIT state. +*/ +/* Define two macros, TCP_REG and TCP_RMV that registers a TCP PCB + with a PCB list or removes a PCB from a list, respectively. */ +#ifndef TCP_DEBUG_PCB_LISTS +#define TCP_DEBUG_PCB_LISTS 0 +#endif +#if TCP_DEBUG_PCB_LISTS +#define TCP_REG(pcbs, npcb) do {\ + struct tcp_pcb *tcp_tmp_pcb; \ + LWIP_DEBUGF(TCP_DEBUG, ("TCP_REG %p local port %d\n", (npcb), (npcb)->local_port)); \ + for (tcp_tmp_pcb = *(pcbs); \ + tcp_tmp_pcb != NULL; \ + tcp_tmp_pcb = tcp_tmp_pcb->next) { \ + LWIP_ASSERT("TCP_REG: already registered\n", tcp_tmp_pcb != (npcb)); \ + } \ + LWIP_ASSERT("TCP_REG: pcb->state != CLOSED", ((pcbs) == &tcp_bound_pcbs) || ((npcb)->state != CLOSED)); \ + (npcb)->next = *(pcbs); \ + LWIP_ASSERT("TCP_REG: npcb->next != npcb", (npcb)->next != (npcb)); \ + *(pcbs) = (npcb); \ + LWIP_ASSERT("TCP_RMV: tcp_pcbs sane", tcp_pcbs_sane()); \ + tcp_timer_needed(); \ + } while(0) +#define TCP_RMV(pcbs, npcb) do { \ + struct tcp_pcb *tcp_tmp_pcb; \ + LWIP_ASSERT("TCP_RMV: pcbs != NULL", *(pcbs) != NULL); \ + LWIP_DEBUGF(TCP_DEBUG, ("TCP_RMV: removing %p from %p\n", (npcb), *(pcbs))); \ + if(*(pcbs) == (npcb)) { \ + *(pcbs) = (*pcbs)->next; \ + } else for (tcp_tmp_pcb = *(pcbs); tcp_tmp_pcb != NULL; tcp_tmp_pcb = tcp_tmp_pcb->next) { \ + if(tcp_tmp_pcb->next == (npcb)) { \ + tcp_tmp_pcb->next = (npcb)->next; \ + break; \ + } \ + } \ + (npcb)->next = NULL; \ + LWIP_ASSERT("TCP_RMV: tcp_pcbs sane", tcp_pcbs_sane()); \ + LWIP_DEBUGF(TCP_DEBUG, ("TCP_RMV: removed %p from %p\n", (npcb), *(pcbs))); \ + } while(0) + +#else /* LWIP_DEBUG */ + +#define TCP_REG(pcbs, npcb) \ + do { \ + (npcb)->next = *pcbs; \ + *(pcbs) = (npcb); \ + tcp_timer_needed(); \ + } while (0) + +#define TCP_RMV(pcbs, npcb) \ + do { \ + if(*(pcbs) == (npcb)) { \ + (*(pcbs)) = (*pcbs)->next; \ + } \ + else { \ + struct tcp_pcb *tcp_tmp_pcb; \ + for (tcp_tmp_pcb = *pcbs; \ + tcp_tmp_pcb != NULL; \ + tcp_tmp_pcb = tcp_tmp_pcb->next) { \ + if(tcp_tmp_pcb->next == (npcb)) { \ + tcp_tmp_pcb->next = (npcb)->next; \ + break; \ + } \ + } \ + } \ + (npcb)->next = NULL; \ + } while(0) + +#endif /* LWIP_DEBUG */ + +#define TCP_REG_ACTIVE(npcb) \ + do { \ + TCP_REG(&tcp_active_pcbs, npcb); \ + tcp_active_pcbs_changed = 1; \ + } while (0) + +#define TCP_RMV_ACTIVE(npcb) \ + do { \ + TCP_RMV(&tcp_active_pcbs, npcb); \ + tcp_active_pcbs_changed = 1; \ + } while (0) + +#define TCP_PCB_REMOVE_ACTIVE(pcb) \ + do { \ + tcp_pcb_remove(&tcp_active_pcbs, pcb); \ + tcp_active_pcbs_changed = 1; \ + } while (0) + + +/* Internal functions: */ +struct tcp_pcb *tcp_pcb_copy(struct tcp_pcb *pcb); +void tcp_pcb_purge(struct tcp_pcb *pcb); +void tcp_pcb_remove(struct tcp_pcb **pcblist, struct tcp_pcb *pcb); + +void tcp_segs_free(struct tcp_seg *seg); +void tcp_seg_free(struct tcp_seg *seg); +struct tcp_seg *tcp_seg_copy(struct tcp_seg *seg); + +#define tcp_ack(pcb) \ + do { \ + if((pcb)->flags & TF_ACK_DELAY) { \ + (pcb)->flags &= ~TF_ACK_DELAY; \ + (pcb)->flags |= TF_ACK_NOW; \ + } \ + else { \ + (pcb)->flags |= TF_ACK_DELAY; \ + } \ + } while (0) + +#define tcp_ack_now(pcb) \ + do { \ + (pcb)->flags |= TF_ACK_NOW; \ + } while (0) + +err_t tcp_send_fin(struct tcp_pcb *pcb); +err_t tcp_enqueue_flags(struct tcp_pcb *pcb, u8_t flags); + +void tcp_rexmit_seg(struct tcp_pcb *pcb, struct tcp_seg *seg); + +void tcp_rst(u32_t seqno, u32_t ackno, + const ip_addr_t *local_ip, const ip_addr_t *remote_ip, + u16_t local_port, u16_t remote_port); + +u32_t tcp_next_iss(void); + +err_t tcp_keepalive(struct tcp_pcb *pcb); +err_t tcp_zero_window_probe(struct tcp_pcb *pcb); +void tcp_trigger_input_pcb_close(void); + +#if TCP_CALCULATE_EFF_SEND_MSS +u16_t tcp_eff_send_mss_impl(u16_t sendmss, const ip_addr_t *dest +#if LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING + , const ip_addr_t *src +#endif /* LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING */ + ); +#if LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING +#define tcp_eff_send_mss(sendmss, src, dest) tcp_eff_send_mss_impl(sendmss, dest, src) +#else /* LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING */ +#define tcp_eff_send_mss(sendmss, src, dest) tcp_eff_send_mss_impl(sendmss, dest) +#endif /* LWIP_IPV6 || LWIP_IPV4_SRC_ROUTING */ +#endif /* TCP_CALCULATE_EFF_SEND_MSS */ + +#if LWIP_CALLBACK_API +err_t tcp_recv_null(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); +#endif /* LWIP_CALLBACK_API */ + +#if TCP_DEBUG || TCP_INPUT_DEBUG || TCP_OUTPUT_DEBUG +void tcp_debug_print(struct tcp_hdr *tcphdr); +void tcp_debug_print_flags(u8_t flags); +void tcp_debug_print_state(enum tcp_state s); +void tcp_debug_print_pcbs(void); +s16_t tcp_pcbs_sane(void); +#else +# define tcp_debug_print(tcphdr) +# define tcp_debug_print_flags(flags) +# define tcp_debug_print_state(s) +# define tcp_debug_print_pcbs() +# define tcp_pcbs_sane() 1 +#endif /* TCP_DEBUG */ + +/** External function (implemented in timers.c), called when TCP detects + * that a timer is needed (i.e. active- or time-wait-pcb found). */ +void tcp_timer_needed(void); + +#if LWIP_IPV4 +void tcp_netif_ipv4_addr_changed(const ip4_addr_t* old_addr, const ip4_addr_t* new_addr); +#endif /* LWIP_IPV4 */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_TCP */ + +#endif /* LWIP_HDR_TCP_H */ diff --git a/components/lwip/include/lwip/lwip/priv/tcpip_priv.h b/components/lwip/include/lwip/lwip/priv/tcpip_priv.h new file mode 100755 index 000000000..cc1c54ebb --- /dev/null +++ b/components/lwip/include/lwip/lwip/priv/tcpip_priv.h @@ -0,0 +1,163 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_TCPIP_PRIV_H +#define LWIP_HDR_TCPIP_PRIV_H + +#include "lwip/opt.h" + +#if !NO_SYS /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/tcpip.h" +#include "lwip/sys.h" +#include "lwip/timers.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct pbuf; +struct netif; + +/** Define this to something that triggers a watchdog. This is called from + * tcpip_thread after processing a message. */ +#ifndef LWIP_TCPIP_THREAD_ALIVE +#define LWIP_TCPIP_THREAD_ALIVE() +#endif + +#if LWIP_TCPIP_CORE_LOCKING +/** The global semaphore to lock the stack. */ +extern sys_mutex_t lock_tcpip_core; +#define LOCK_TCPIP_CORE() sys_mutex_lock(&lock_tcpip_core) +#define UNLOCK_TCPIP_CORE() sys_mutex_unlock(&lock_tcpip_core) +#else /* LWIP_TCPIP_CORE_LOCKING */ +#define LOCK_TCPIP_CORE() +#define UNLOCK_TCPIP_CORE() +#endif /* LWIP_TCPIP_CORE_LOCKING */ + +#if LWIP_MPU_COMPATIBLE +#define API_VAR_REF(name) (*(name)) +#define API_VAR_DECLARE(type, name) type * name +#define API_VAR_ALLOC(type, pool, name) do { \ + name = (type *)memp_malloc(pool); \ + if (name == NULL) { \ + return ERR_MEM; \ + } \ + } while(0) +#define API_VAR_ALLOC_DONTFAIL(type, pool, name) do { \ + name = (type *)memp_malloc(pool); \ + LWIP_ASSERT("pool empty", name != NULL); \ + } while(0) +#define API_VAR_FREE(pool, name) memp_free(pool, name) +#define API_EXPR_REF(expr) &(expr) +#if LWIP_NETCONN_SEM_PER_THREAD +#define API_EXPR_REF_SEM(expr) (expr) +#else +#define API_EXPR_REF_SEM(expr) API_EXPR_REF(expr) +#endif +#define API_EXPR_DEREF(expr) expr +#else /* LWIP_MPU_COMPATIBLE */ +#define API_VAR_REF(name) name +#define API_VAR_DECLARE(type, name) type name +#define API_VAR_ALLOC(type, pool, name) +#define API_VAR_ALLOC_DONTFAIL(type, pool, name) +#define API_VAR_FREE(pool, name) +#define API_EXPR_REF(expr) expr +#define API_EXPR_REF_SEM(expr) API_EXPR_REF(expr) +#define API_EXPR_DEREF(expr) *(expr) +#endif /* LWIP_MPU_COMPATIBLE */ + +#if !LWIP_TCPIP_CORE_LOCKING +err_t tcpip_send_api_msg(tcpip_callback_fn fn, void *apimsg, sys_sem_t* sem); +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + +struct tcpip_api_call; +typedef err_t (*tcpip_api_call_fn)(struct tcpip_api_call* call); +struct tcpip_api_call +{ + tcpip_api_call_fn function; +#if !LWIP_TCPIP_CORE_LOCKING +#if LWIP_NETCONN_SEM_PER_THREAD + sys_sem_t *sem; +#else /* LWIP_NETCONN_SEM_PER_THREAD */ + sys_sem_t sem; +#endif /* LWIP_NETCONN_SEM_PER_THREAD */ + err_t err; +#endif /* !LWIP_TCPIP_CORE_LOCKING */ +}; +err_t tcpip_api_call(tcpip_api_call_fn fn, struct tcpip_api_call *call); + +enum tcpip_msg_type { + TCPIP_MSG_API, + TCPIP_MSG_API_CALL, + TCPIP_MSG_INPKT, +#if LWIP_TCPIP_TIMEOUT + TCPIP_MSG_TIMEOUT, + TCPIP_MSG_UNTIMEOUT, +#endif /* LWIP_TCPIP_TIMEOUT */ + TCPIP_MSG_CALLBACK, + TCPIP_MSG_CALLBACK_STATIC +}; + +struct tcpip_msg { + enum tcpip_msg_type type; + union { + struct { + tcpip_callback_fn function; + void* msg; + } api; + struct tcpip_api_call *api_call; + struct { + struct pbuf *p; + struct netif *netif; + netif_input_fn input_fn; + } inp; + struct { + tcpip_callback_fn function; + void *ctx; + } cb; +#if LWIP_TCPIP_TIMEOUT + struct { + u32_t msecs; + sys_timeout_handler h; + void *arg; + } tmo; +#endif /* LWIP_TCPIP_TIMEOUT */ + } msg; +}; + +#ifdef __cplusplus +} +#endif + +#endif /* !NO_SYS */ + +#endif /* LWIP_HDR_TCPIP_PRIV_H */ diff --git a/components/lwip/include/lwip/lwip/raw.h b/components/lwip/include/lwip/lwip/raw.h new file mode 100755 index 000000000..474fdc154 --- /dev/null +++ b/components/lwip/include/lwip/lwip/raw.h @@ -0,0 +1,109 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_RAW_H +#define LWIP_HDR_RAW_H + +#include "lwip/opt.h" + +#if LWIP_RAW /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/def.h" +#include "lwip/ip.h" +#include "lwip/ip_addr.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct raw_pcb; + +/** Function prototype for raw pcb receive callback functions. + * @param arg user supplied argument (raw_pcb.recv_arg) + * @param pcb the raw_pcb which received data + * @param p the packet buffer that was received + * @param addr the remote IP address from which the packet was received + * @return 1 if the packet was 'eaten' (aka. deleted), + * 0 if the packet lives on + * If returning 1, the callback is responsible for freeing the pbuf + * if it's not used any more. + */ +typedef u8_t (*raw_recv_fn)(void *arg, struct raw_pcb *pcb, struct pbuf *p, + const ip_addr_t *addr); + +struct raw_pcb { + /* Common members of all PCB types */ + IP_PCB; + + struct raw_pcb *next; + + u8_t protocol; + + /** receive callback function */ + raw_recv_fn recv; + /* user-supplied argument for the recv callback */ + void *recv_arg; +#if LWIP_IPV6 + /* fields for handling checksum computations as per RFC3542. */ + u16_t chksum_offset; + u8_t chksum_reqd; +#endif +}; + +/* The following functions is the application layer interface to the + RAW code. */ +struct raw_pcb * raw_new (u8_t proto); +struct raw_pcb * raw_new_ip_type(u8_t type, u8_t proto); +void raw_remove (struct raw_pcb *pcb); +err_t raw_bind (struct raw_pcb *pcb, const ip_addr_t *ipaddr); +err_t raw_connect (struct raw_pcb *pcb, const ip_addr_t *ipaddr); + +err_t raw_sendto (struct raw_pcb *pcb, struct pbuf *p, const ip_addr_t *ipaddr); +err_t raw_send (struct raw_pcb *pcb, struct pbuf *p); + +void raw_recv (struct raw_pcb *pcb, raw_recv_fn recv, void *recv_arg); + +/* The following functions are the lower layer interface to RAW. */ +u8_t raw_input (struct pbuf *p, struct netif *inp); +#define raw_init() /* Compatibility define, no init needed. */ + +/* for compatibility with older implementation */ +#define raw_new_ip6(proto) raw_new_ip_type(IPADDR_TYPE_V6, proto) + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_RAW */ + +#endif /* LWIP_HDR_RAW_H */ diff --git a/components/lwip/include/lwip/lwip/sio.h b/components/lwip/include/lwip/lwip/sio.h new file mode 100755 index 000000000..09cf799ab --- /dev/null +++ b/components/lwip/include/lwip/lwip/sio.h @@ -0,0 +1,141 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + */ + +/* + * This is the interface to the platform specific serial IO module + * It needs to be implemented by those platforms which need SLIP or PPP + */ + +#ifndef SIO_H +#define SIO_H + +#include "lwip/arch.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* If you want to define sio_fd_t elsewhere or differently, + define this in your cc.h file. */ +#ifndef __sio_fd_t_defined +typedef void * sio_fd_t; +#endif + +/* The following functions can be defined to something else in your cc.h file + or be implemented in your custom sio.c file. */ + +#ifndef sio_open +/** + * Opens a serial device for communication. + * + * @param devnum device number + * @return handle to serial device if successful, NULL otherwise + */ +sio_fd_t sio_open(u8_t devnum); +#endif + +#ifndef sio_send +/** + * Sends a single character to the serial device. + * + * @param c character to send + * @param fd serial device handle + * + * @note This function will block until the character can be sent. + */ +void sio_send(u8_t c, sio_fd_t fd); +#endif + +#ifndef sio_recv +/** + * Receives a single character from the serial device. + * + * @param fd serial device handle + * + * @note This function will block until a character is received. + */ +u8_t sio_recv(sio_fd_t fd); +#endif + +#ifndef sio_read +/** + * Reads from the serial device. + * + * @param fd serial device handle + * @param data pointer to data buffer for receiving + * @param len maximum length (in bytes) of data to receive + * @return number of bytes actually received - may be 0 if aborted by sio_read_abort + * + * @note This function will block until data can be received. The blocking + * can be cancelled by calling sio_read_abort(). + */ +u32_t sio_read(sio_fd_t fd, u8_t *data, u32_t len); +#endif + +#ifndef sio_tryread +/** + * Tries to read from the serial device. Same as sio_read but returns + * immediately if no data is available and never blocks. + * + * @param fd serial device handle + * @param data pointer to data buffer for receiving + * @param len maximum length (in bytes) of data to receive + * @return number of bytes actually received + */ +u32_t sio_tryread(sio_fd_t fd, u8_t *data, u32_t len); +#endif + +#ifndef sio_write +/** + * Writes to the serial device. + * + * @param fd serial device handle + * @param data pointer to data to send + * @param len length (in bytes) of data to send + * @return number of bytes actually sent + * + * @note This function will block until all data can be sent. + */ +u32_t sio_write(sio_fd_t fd, u8_t *data, u32_t len); +#endif + +#ifndef sio_read_abort +/** + * Aborts a blocking sio_read() call. + * + * @param fd serial device handle + */ +void sio_read_abort(sio_fd_t fd); +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* SIO_H */ diff --git a/components/lwip/include/lwip/lwip/snmp.h b/components/lwip/include/lwip/lwip/snmp.h new file mode 100755 index 000000000..07368cc68 --- /dev/null +++ b/components/lwip/include/lwip/lwip/snmp.h @@ -0,0 +1,195 @@ +/** + * @file + * MIB2 callback functions called from throughout the stack to integrate a MIB2 + * into lwIP (together with MIB2_STATS). + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Dirk Ziegelmeier + * + */ +#ifndef LWIP_HDR_SNMP_H +#define LWIP_HDR_SNMP_H + +#include "lwip/opt.h" +#include "lwip/ip_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct udp_pcb; +struct netif; + +/* MIB2 statistics functions */ +#if MIB2_STATS /* don't build if not configured for use in lwipopts.h */ +/** + * @see RFC1213, "MIB-II, 6. Definitions" + */ +enum snmp_ifType { + snmp_ifType_other=1, /* none of the following */ + snmp_ifType_regular1822, + snmp_ifType_hdh1822, + snmp_ifType_ddn_x25, + snmp_ifType_rfc877_x25, + snmp_ifType_ethernet_csmacd, + snmp_ifType_iso88023_csmacd, + snmp_ifType_iso88024_tokenBus, + snmp_ifType_iso88025_tokenRing, + snmp_ifType_iso88026_man, + snmp_ifType_starLan, + snmp_ifType_proteon_10Mbit, + snmp_ifType_proteon_80Mbit, + snmp_ifType_hyperchannel, + snmp_ifType_fddi, + snmp_ifType_lapb, + snmp_ifType_sdlc, + snmp_ifType_ds1, /* T-1 */ + snmp_ifType_e1, /* european equiv. of T-1 */ + snmp_ifType_basicISDN, + snmp_ifType_primaryISDN, /* proprietary serial */ + snmp_ifType_propPointToPointSerial, + snmp_ifType_ppp, + snmp_ifType_softwareLoopback, + snmp_ifType_eon, /* CLNP over IP [11] */ + snmp_ifType_ethernet_3Mbit, + snmp_ifType_nsip, /* XNS over IP */ + snmp_ifType_slip, /* generic SLIP */ + snmp_ifType_ultra, /* ULTRA technologies */ + snmp_ifType_ds3, /* T-3 */ + snmp_ifType_sip, /* SMDS */ + snmp_ifType_frame_relay +}; + +/* This macro has a precision of ~49 days because sys_now returns u32_t. #define your own if you want ~490 days. */ +#ifndef MIB2_COPY_SYSUPTIME_TO +#define MIB2_COPY_SYSUPTIME_TO(ptrToVal) (*(ptrToVal) = (sys_now() / 10)) +#endif + +#define MIB2_STATS_NETIF_INC(n, x) do { ++(n)->mib2_counters.x; } while(0) +#define MIB2_STATS_NETIF_ADD(n, x, val) do { (n)->mib2_counters.x += (val); } while(0) + +#define MIB2_INIT_NETIF(netif, type, speed) do { \ + /* use "snmp_ifType" enum from snmp_mib2.h for "type", snmp_ifType_ethernet_csmacd by example */ \ + (netif)->link_type = (type); \ + /* your link speed here (units: bits per second) */ \ + (netif)->link_speed = (speed);\ + (netif)->ts = 0; \ + (netif)->mib2_counters.ifinoctets = 0; \ + (netif)->mib2_counters.ifinucastpkts = 0; \ + (netif)->mib2_counters.ifinnucastpkts = 0; \ + (netif)->mib2_counters.ifindiscards = 0; \ + (netif)->mib2_counters.ifinerrors = 0; \ + (netif)->mib2_counters.ifinunknownprotos = 0; \ + (netif)->mib2_counters.ifoutoctets = 0; \ + (netif)->mib2_counters.ifoutucastpkts = 0; \ + (netif)->mib2_counters.ifoutnucastpkts = 0; \ + (netif)->mib2_counters.ifoutdiscards = 0; \ + (netif)->mib2_counters.ifouterrors = 0; } while(0) +#else /* MIB2_STATS */ +#ifndef MIB2_COPY_SYSUPTIME_TO +#define MIB2_COPY_SYSUPTIME_TO(ptrToVal) +#endif +#define MIB2_INIT_NETIF(netif, type, speed) +#define MIB2_STATS_NETIF_INC(n, x) +#define MIB2_STATS_NETIF_ADD(n, x, val) +#endif /* MIB2_STATS */ + +/* LWIP MIB2 callbacks */ +#if LWIP_MIB2_CALLBACKS /* don't build if not configured for use in lwipopts.h */ +/* network interface */ +void mib2_netif_added(struct netif *ni); +void mib2_netif_removed(struct netif *ni); + +#if LWIP_IPV4 && LWIP_ARP +/* ARP (for atTable and ipNetToMediaTable) */ +void mib2_add_arp_entry(struct netif *ni, ip4_addr_t *ip); +void mib2_remove_arp_entry(struct netif *ni, ip4_addr_t *ip); +#else /* LWIP_IPV4 && LWIP_ARP */ +#define mib2_add_arp_entry(ni,ip) +#define mib2_remove_arp_entry(ni,ip) +#endif /* LWIP_IPV4 && LWIP_ARP */ + +/* IP */ +#if LWIP_IPV4 +void mib2_add_ip4(struct netif *ni); +void mib2_remove_ip4(struct netif *ni); +void mib2_add_route_ip4(u8_t dflt, struct netif *ni); +void mib2_remove_route_ip4(u8_t dflt, struct netif *ni); +#endif /* LWIP_IPV4 */ + +/* UDP */ +#if LWIP_UDP +void mib2_udp_bind(struct udp_pcb *pcb); +void mib2_udp_unbind(struct udp_pcb *pcb); +#endif /* LWIP_UDP */ + +#else /* LWIP_MIB2_CALLBACKS */ +/* LWIP_MIB2_CALLBACKS support not available */ +/* define everything to be empty */ + +/* network interface */ +#define mib2_netif_added(ni) +#define mib2_netif_removed(ni) + +/* ARP */ +#define mib2_add_arp_entry(ni,ip) +#define mib2_remove_arp_entry(ni,ip) + +/* IP */ +#define mib2_add_ip4(ni) +#define mib2_remove_ip4(ni) +#define mib2_add_route_ip4(dflt, ni) +#define mib2_remove_route_ip4(dflt, ni) + +/* UDP */ +#define mib2_udp_bind(pcb) +#define mib2_udp_unbind(pcb) +#endif /* LWIP_MIB2_CALLBACKS */ + +/* for source-code compatibility reasons only, can be removed (not used internally) */ +#define NETIF_INIT_SNMP MIB2_INIT_NETIF +#define snmp_add_ifinoctets(ni,value) MIB2_STATS_NETIF_ADD(ni, ifinoctets, value) +#define snmp_inc_ifinucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifinucastpkts) +#define snmp_inc_ifinnucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifinnucastpkts) +#define snmp_inc_ifindiscards(ni) MIB2_STATS_NETIF_INC(ni, ifindiscards) +#define snmp_inc_ifinerrors(ni) MIB2_STATS_NETIF_INC(ni, ifinerrors) +#define snmp_inc_ifinunknownprotos(ni) MIB2_STATS_NETIF_INC(ni, ifinunknownprotos) +#define snmp_add_ifoutoctets(ni,value) MIB2_STATS_NETIF_ADD(ni, ifoutoctets, value) +#define snmp_inc_ifoutucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifoutucastpkts) +#define snmp_inc_ifoutnucastpkts(ni) MIB2_STATS_NETIF_INC(ni, ifoutnucastpkts) +#define snmp_inc_ifoutdiscards(ni) MIB2_STATS_NETIF_INC(ni, ifoutdiscards) +#define snmp_inc_ifouterrors(ni) MIB2_STATS_NETIF_INC(ni, ifouterrors) + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_SNMP_H */ diff --git a/components/lwip/include/lwip/lwip/sockets.h b/components/lwip/include/lwip/lwip/sockets.h new file mode 100755 index 000000000..b79e3b7f5 --- /dev/null +++ b/components/lwip/include/lwip/lwip/sockets.h @@ -0,0 +1,624 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + + +#ifndef LWIP_HDR_SOCKETS_H +#define LWIP_HDR_SOCKETS_H + +#include "lwip/opt.h" + +#if LWIP_SOCKET /* don't build if not configured for use in lwipopts.h */ + +#include /* for size_t */ + +#include "lwip/ip_addr.h" +#include "lwip/err.h" +#include "lwip/inet.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* If your port already typedef's sa_family_t, define SA_FAMILY_T_DEFINED + to prevent this code from redefining it. */ +#if !defined(sa_family_t) && !defined(SA_FAMILY_T_DEFINED) +typedef u8_t sa_family_t; +#endif +/* If your port already typedef's in_port_t, define IN_PORT_T_DEFINED + to prevent this code from redefining it. */ +#if !defined(in_port_t) && !defined(IN_PORT_T_DEFINED) +typedef u16_t in_port_t; +#endif + +#if LWIP_IPV4 +/* members are in network byte order */ +struct sockaddr_in { + u8_t sin_len; + sa_family_t sin_family; + in_port_t sin_port; + struct in_addr sin_addr; +#define SIN_ZERO_LEN 8 + char sin_zero[SIN_ZERO_LEN]; +}; +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +struct sockaddr_in6 { + u8_t sin6_len; /* length of this structure */ + sa_family_t sin6_family; /* AF_INET6 */ + in_port_t sin6_port; /* Transport layer port # */ + u32_t sin6_flowinfo; /* IPv6 flow information */ + struct in6_addr sin6_addr; /* IPv6 address */ + u32_t sin6_scope_id; /* Set of interfaces for scope */ +}; +#endif /* LWIP_IPV6 */ + +struct sockaddr { + u8_t sa_len; + sa_family_t sa_family; + char sa_data[14]; +}; + +struct sockaddr_storage { + u8_t s2_len; + sa_family_t ss_family; + char s2_data1[2]; + u32_t s2_data2[3]; +#if LWIP_IPV6 + u32_t s2_data3[3]; +#endif /* LWIP_IPV6 */ +}; + +/* If your port already typedef's socklen_t, define SOCKLEN_T_DEFINED + to prevent this code from redefining it. */ +#if !defined(socklen_t) && !defined(SOCKLEN_T_DEFINED) +typedef u32_t socklen_t; +#endif + +struct lwip_sock; + +#if !LWIP_TCPIP_CORE_LOCKING +/** Maximum optlen used by setsockopt/getsockopt */ +#define LWIP_SETGETSOCKOPT_MAXOPTLEN 16 + +/** This struct is used to pass data to the set/getsockopt_internal + * functions running in tcpip_thread context (only a void* is allowed) */ +struct lwip_setgetsockopt_data { + /** socket index for which to change options */ + int s; + /** level of the option to process */ + int level; + /** name of the option to process */ + int optname; + /** set: value to set the option to + * get: value of the option is stored here */ +#if LWIP_MPU_COMPATIBLE + u8_t optval[LWIP_SETGETSOCKOPT_MAXOPTLEN]; +#else + union { + void *p; + const void *pc; + } optval; +#endif + /** size of *optval */ + socklen_t optlen; + /** if an error occurs, it is temporarily stored here */ + err_t err; + /** semaphore to wake up the calling task */ + void* completed_sem; +}; +#endif /* !LWIP_TCPIP_CORE_LOCKING */ + +#if !defined(iovec) +struct iovec { + void *iov_base; + size_t iov_len; +}; +#endif + +struct msghdr { + void *msg_name; + socklen_t msg_namelen; + struct iovec *msg_iov; + int msg_iovlen; + void *msg_control; + socklen_t msg_controllen; + int msg_flags; +}; + +/* Socket protocol types (TCP/UDP/RAW) */ +#define SOCK_STREAM 1 +#define SOCK_DGRAM 2 +#define SOCK_RAW 3 + +/* + * Option flags per-socket. These must match the SOF_ flags in ip.h (checked in init.c) + */ +#define SO_REUSEADDR 0x0004 /* Allow local address reuse */ +#define SO_KEEPALIVE 0x0008 /* keep connections alive */ +#define SO_BROADCAST 0x0020 /* permit to send and to receive broadcast messages (see IP_SOF_BROADCAST option) */ + + +/* + * Additional options, not kept in so_options. + */ +#define SO_DEBUG 0x0001 /* Unimplemented: turn on debugging info recording */ +#define SO_ACCEPTCONN 0x0002 /* socket has had listen() */ +#define SO_DONTROUTE 0x0010 /* Unimplemented: just use interface addresses */ +#define SO_USELOOPBACK 0x0040 /* Unimplemented: bypass hardware when possible */ +#define SO_LINGER 0x0080 /* linger on close if data present */ +#define SO_DONTLINGER ((int)(~SO_LINGER)) +#define SO_OOBINLINE 0x0100 /* Unimplemented: leave received OOB data in line */ +#define SO_REUSEPORT 0x0200 /* Unimplemented: allow local address & port reuse */ +#define SO_SNDBUF 0x1001 /* Unimplemented: send buffer size */ +#define SO_RCVBUF 0x1002 /* receive buffer size */ +#define SO_SNDLOWAT 0x1003 /* Unimplemented: send low-water mark */ +#define SO_RCVLOWAT 0x1004 /* Unimplemented: receive low-water mark */ +#define SO_SNDTIMEO 0x1005 /* send timeout */ +#define SO_RCVTIMEO 0x1006 /* receive timeout */ +#define SO_ERROR 0x1007 /* get error status and clear */ +#define SO_TYPE 0x1008 /* get socket type */ +#define SO_CONTIMEO 0x1009 /* Unimplemented: connect timeout */ +#define SO_NO_CHECK 0x100a /* don't create UDP checksum */ + + +/* + * Structure used for manipulating linger option. + */ +struct linger { + int l_onoff; /* option on/off */ + int l_linger; /* linger time in seconds */ +}; + +/* + * Level number for (get/set)sockopt() to apply to socket itself. + */ +#define SOL_SOCKET 0xfff /* options for socket level */ + + +#define AF_UNSPEC 0 +#define AF_INET 2 +#if LWIP_IPV6 +#define AF_INET6 10 +#else /* LWIP_IPV6 */ +#define AF_INET6 AF_UNSPEC +#endif /* LWIP_IPV6 */ +#define PF_INET AF_INET +#define PF_INET6 AF_INET6 +#define PF_UNSPEC AF_UNSPEC + +#define IPPROTO_IP 0 +#define IPPROTO_ICMP 1 +#define IPPROTO_TCP 6 +#define IPPROTO_UDP 17 +#if LWIP_IPV6 +#define IPPROTO_IPV6 41 +#define IPPROTO_ICMPV6 58 +#endif /* LWIP_IPV6 */ +#define IPPROTO_UDPLITE 136 +#define IPPROTO_RAW 255 + +/* Flags we can use with send and recv. */ +#define MSG_PEEK 0x01 /* Peeks at an incoming message */ +#define MSG_WAITALL 0x02 /* Unimplemented: Requests that the function block until the full amount of data requested can be returned */ +#define MSG_OOB 0x04 /* Unimplemented: Requests out-of-band data. The significance and semantics of out-of-band data are protocol-specific */ +#define MSG_DONTWAIT 0x08 /* Nonblocking i/o for this operation only */ +#define MSG_MORE 0x10 /* Sender will send more */ + + +/* + * Options for level IPPROTO_IP + */ +#define IP_TOS 1 +#define IP_TTL 2 + +#if LWIP_TCP +/* + * Options for level IPPROTO_TCP + */ +#define TCP_NODELAY 0x01 /* don't delay send to coalesce packets */ +#define TCP_KEEPALIVE 0x02 /* send KEEPALIVE probes when idle for pcb->keep_idle milliseconds */ +#define TCP_KEEPIDLE 0x03 /* set pcb->keep_idle - Same as TCP_KEEPALIVE, but use seconds for get/setsockopt */ +#define TCP_KEEPINTVL 0x04 /* set pcb->keep_intvl - Use seconds for get/setsockopt */ +#define TCP_KEEPCNT 0x05 /* set pcb->keep_cnt - Use number of probes sent for get/setsockopt */ +#endif /* LWIP_TCP */ + +#if LWIP_IPV6 +/* + * Options for level IPPROTO_IPV6 + */ +#define IPV6_CHECKSUM 7 /* RFC3542: calculate and insert the ICMPv6 checksum for raw sockets. */ +#define IPV6_V6ONLY 27 /* RFC3493: boolean control to restrict AF_INET6 sockets to IPv6 communications only. */ +#endif /* LWIP_IPV6 */ + +#if LWIP_UDP && LWIP_UDPLITE +/* + * Options for level IPPROTO_UDPLITE + */ +#define UDPLITE_SEND_CSCOV 0x01 /* sender checksum coverage */ +#define UDPLITE_RECV_CSCOV 0x02 /* minimal receiver checksum coverage */ +#endif /* LWIP_UDP && LWIP_UDPLITE*/ + + +#if LWIP_MULTICAST_TX_OPTIONS +/* + * Options and types for UDP multicast traffic handling + */ +#define IP_MULTICAST_TTL 5 +#define IP_MULTICAST_IF 6 +#define IP_MULTICAST_LOOP 7 +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + +#if LWIP_IGMP +/* + * Options and types related to multicast membership + */ +#define IP_ADD_MEMBERSHIP 3 +#define IP_DROP_MEMBERSHIP 4 + +typedef struct ip_mreq { + struct in_addr imr_multiaddr; /* IP multicast address of group */ + struct in_addr imr_interface; /* local IP address of interface */ +} ip_mreq; +#endif /* LWIP_IGMP */ + +/* + * The Type of Service provides an indication of the abstract + * parameters of the quality of service desired. These parameters are + * to be used to guide the selection of the actual service parameters + * when transmitting a datagram through a particular network. Several + * networks offer service precedence, which somehow treats high + * precedence traffic as more important than other traffic (generally + * by accepting only traffic above a certain precedence at time of high + * load). The major choice is a three way tradeoff between low-delay, + * high-reliability, and high-throughput. + * The use of the Delay, Throughput, and Reliability indications may + * increase the cost (in some sense) of the service. In many networks + * better performance for one of these parameters is coupled with worse + * performance on another. Except for very unusual cases at most two + * of these three indications should be set. + */ +#define IPTOS_TOS_MASK 0x1E +#define IPTOS_TOS(tos) ((tos) & IPTOS_TOS_MASK) +#define IPTOS_LOWDELAY 0x10 +#define IPTOS_THROUGHPUT 0x08 +#define IPTOS_RELIABILITY 0x04 +#define IPTOS_LOWCOST 0x02 +#define IPTOS_MINCOST IPTOS_LOWCOST + +/* + * The Network Control precedence designation is intended to be used + * within a network only. The actual use and control of that + * designation is up to each network. The Internetwork Control + * designation is intended for use by gateway control originators only. + * If the actual use of these precedence designations is of concern to + * a particular network, it is the responsibility of that network to + * control the access to, and use of, those precedence designations. + */ +#define IPTOS_PREC_MASK 0xe0 +#define IPTOS_PREC(tos) ((tos) & IPTOS_PREC_MASK) +#define IPTOS_PREC_NETCONTROL 0xe0 +#define IPTOS_PREC_INTERNETCONTROL 0xc0 +#define IPTOS_PREC_CRITIC_ECP 0xa0 +#define IPTOS_PREC_FLASHOVERRIDE 0x80 +#define IPTOS_PREC_FLASH 0x60 +#define IPTOS_PREC_IMMEDIATE 0x40 +#define IPTOS_PREC_PRIORITY 0x20 +#define IPTOS_PREC_ROUTINE 0x00 + + +/* + * Commands for ioctlsocket(), taken from the BSD file fcntl.h. + * lwip_ioctl only supports FIONREAD and FIONBIO, for now + * + * Ioctl's have the command encoded in the lower word, + * and the size of any in or out parameters in the upper + * word. The high 2 bits of the upper word are used + * to encode the in/out status of the parameter; for now + * we restrict parameters to at most 128 bytes. + */ +#if !defined(FIONREAD) || !defined(FIONBIO) +#define IOCPARM_MASK 0x7fU /* parameters must be < 128 bytes */ +#define IOC_VOID 0x20000000UL /* no parameters */ +#define IOC_OUT 0x40000000UL /* copy out parameters */ +#define IOC_IN 0x80000000UL /* copy in parameters */ +#define IOC_INOUT (IOC_IN|IOC_OUT) + /* 0x20000000 distinguishes new & + old ioctl's */ +#define _IO(x,y) (IOC_VOID|((x)<<8)|(y)) + +#define _IOR(x,y,t) (IOC_OUT|(((long)sizeof(t)&IOCPARM_MASK)<<16)|((x)<<8)|(y)) + +#define _IOW(x,y,t) (IOC_IN|(((long)sizeof(t)&IOCPARM_MASK)<<16)|((x)<<8)|(y)) +#endif /* !defined(FIONREAD) || !defined(FIONBIO) */ + +#ifndef FIONREAD +#define FIONREAD _IOR('f', 127, unsigned long) /* get # bytes to read */ +#endif +#ifndef FIONBIO +#define FIONBIO _IOW('f', 126, unsigned long) /* set/clear non-blocking i/o */ +#endif + +/* Socket I/O Controls: unimplemented */ +#ifndef SIOCSHIWAT +#define SIOCSHIWAT _IOW('s', 0, unsigned long) /* set high watermark */ +#define SIOCGHIWAT _IOR('s', 1, unsigned long) /* get high watermark */ +#define SIOCSLOWAT _IOW('s', 2, unsigned long) /* set low watermark */ +#define SIOCGLOWAT _IOR('s', 3, unsigned long) /* get low watermark */ +#define SIOCATMARK _IOR('s', 7, unsigned long) /* at oob mark? */ +#endif + +/* commands for fnctl */ +#ifndef F_GETFL +#define F_GETFL 3 +#endif +#ifndef F_SETFL +#define F_SETFL 4 +#endif + +/* File status flags and file access modes for fnctl, + these are bits in an int. */ +#ifndef O_NONBLOCK +#define O_NONBLOCK 1 /* nonblocking I/O */ +#endif +#ifndef O_NDELAY +#define O_NDELAY 1 /* same as O_NONBLOCK, for compatibility */ +#endif + +#ifndef SHUT_RD + #define SHUT_RD 0 + #define SHUT_WR 1 + #define SHUT_RDWR 2 +#endif + +/* FD_SET used for lwip_select */ +#ifndef FD_SET +#undef FD_SETSIZE +/* Make FD_SETSIZE match NUM_SOCKETS in socket.c */ +#define FD_SETSIZE MEMP_NUM_NETCONN +#define FDSETSAFESET(n, code) do { \ + if (((n) - LWIP_SOCKET_OFFSET < MEMP_NUM_NETCONN) && (((int)(n) - LWIP_SOCKET_OFFSET) >= 0)) { \ + code; }} while(0) +#define FDSETSAFEGET(n, code) (((n) - LWIP_SOCKET_OFFSET < MEMP_NUM_NETCONN) && (((int)(n) - LWIP_SOCKET_OFFSET) >= 0) ?\ + (code) : 0) +#define FD_SET(n, p) FDSETSAFESET(n, (p)->fd_bits[((n)-LWIP_SOCKET_OFFSET)/8] |= (1 << (((n)-LWIP_SOCKET_OFFSET) & 7))) +#define FD_CLR(n, p) FDSETSAFESET(n, (p)->fd_bits[((n)-LWIP_SOCKET_OFFSET)/8] &= ~(1 << (((n)-LWIP_SOCKET_OFFSET) & 7))) +#define FD_ISSET(n,p) FDSETSAFEGET(n, (p)->fd_bits[((n)-LWIP_SOCKET_OFFSET)/8] & (1 << (((n)-LWIP_SOCKET_OFFSET) & 7))) +#define FD_ZERO(p) memset((void*)(p), 0, sizeof(*(p))) + +typedef struct fd_set +{ + unsigned char fd_bits [(FD_SETSIZE+7)/8]; +} fd_set; + +#elif LWIP_SOCKET_OFFSET +#error LWIP_SOCKET_OFFSET does not work with external FD_SET! +#endif /* FD_SET */ + +/** LWIP_TIMEVAL_PRIVATE: if you want to use the struct timeval provided + * by your system, set this to 0 and include in cc.h */ +#ifndef LWIP_TIMEVAL_PRIVATE +#define LWIP_TIMEVAL_PRIVATE 1 +#endif + +#if LWIP_TIMEVAL_PRIVATE +struct timeval { + long tv_sec; /* seconds */ + long tv_usec; /* and microseconds */ +}; +#endif /* LWIP_TIMEVAL_PRIVATE */ + +#define lwip_socket_init() /* Compatibility define, no init needed. */ +void lwip_socket_thread_init(void); /* LWIP_NETCONN_SEM_PER_THREAD==1: initialize thread-local semaphore */ +void lwip_socket_thread_cleanup(void); /* LWIP_NETCONN_SEM_PER_THREAD==1: destroy thread-local semaphore */ + +#if LWIP_COMPAT_SOCKETS == 2 + + +/* This helps code parsers/code completion by not having the COMPAT functions as defines */ +#define lwip_accept accept +#define lwip_bind bind +#define lwip_shutdown shutdown +#define lwip_getpeername getpeername +#define lwip_getsockname getsockname +#define lwip_setsockopt setsockopt +#define lwip_getsockopt getsockopt +#define lwip_close closesocket +#define lwip_connect connect +#define lwip_listen listen +#define lwip_recv recv +#define lwip_recvfrom recvfrom +#define lwip_send send +#define lwip_sendmsg sendmsg +#define lwip_sendto sendto +#define lwip_socket socket +#define lwip_select select +#define lwip_ioctlsocket ioctl + +#if LWIP_POSIX_SOCKETS_IO_NAMES +#define lwip_read read +#define lwip_write write +#define lwip_writev writev +#undef lwip_close +#define lwip_close close +#define closesocket(s) close(s) +#define lwip_fcntl fcntl +#define lwip_ioctl ioctl +#endif /* LWIP_POSIX_SOCKETS_IO_NAMES */ +#endif /* LWIP_COMPAT_SOCKETS == 2 */ + +int lwip_accept(int s, struct sockaddr *addr, socklen_t *addrlen); +int lwip_bind(int s, const struct sockaddr *name, socklen_t namelen); +int lwip_shutdown(int s, int how); +int lwip_getpeername (int s, struct sockaddr *name, socklen_t *namelen); +int lwip_getsockname (int s, struct sockaddr *name, socklen_t *namelen); +int lwip_getsockopt (int s, int level, int optname, void *optval, socklen_t *optlen); +int lwip_setsockopt (int s, int level, int optname, const void *optval, socklen_t optlen); +int lwip_close(int s); +int lwip_connect(int s, const struct sockaddr *name, socklen_t namelen); +int lwip_listen(int s, int backlog); +int lwip_recv(int s, void *mem, size_t len, int flags); +int lwip_read(int s, void *mem, size_t len); +int lwip_recvfrom(int s, void *mem, size_t len, int flags, + struct sockaddr *from, socklen_t *fromlen); +int lwip_send(int s, const void *dataptr, size_t size, int flags); +int lwip_sendmsg(int s, const struct msghdr *message, int flags); +int lwip_sendto(int s, const void *dataptr, size_t size, int flags, + const struct sockaddr *to, socklen_t tolen); +int lwip_socket(int domain, int type, int protocol); +int lwip_write(int s, const void *dataptr, size_t size); +int lwip_writev(int s, const struct iovec *iov, int iovcnt); +int lwip_select(int maxfdp1, fd_set *readset, fd_set *writeset, fd_set *exceptset, + struct timeval *timeout); +int lwip_ioctl(int s, long cmd, void *argp); +int lwip_fcntl(int s, int cmd, int val); + +#if LWIP_COMPAT_SOCKETS +#if LWIP_COMPAT_SOCKETS != 2 + +#ifdef LWIP_THREAD_SAFE + +int lwip_accept_r(int s, struct sockaddr *addr, socklen_t *addrlen); +int lwip_bind_r(int s, const struct sockaddr *name, socklen_t namelen); +int lwip_shutdown_r(int s, int how); +int lwip_getpeername_r (int s, struct sockaddr *name, socklen_t *namelen); +int lwip_getsockname_r (int s, struct sockaddr *name, socklen_t *namelen); +int lwip_getsockopt_r (int s, int level, int optname, void *optval, socklen_t *optlen); +int lwip_setsockopt_r (int s, int level, int optname, const void *optval, socklen_t optlen); +int lwip_close_r(int s); +int lwip_connect_r(int s, const struct sockaddr *name, socklen_t namelen); +int lwip_listen_r(int s, int backlog); +int lwip_recv_r(int s, void *mem, size_t len, int flags); +int lwip_read_r(int s, void *mem, size_t len); +int lwip_recvfrom_r(int s, void *mem, size_t len, int flags, + struct sockaddr *from, socklen_t *fromlen); +int lwip_send_r(int s, const void *dataptr, size_t size, int flags); +int lwip_sendmsg_r(int s, const struct msghdr *message, int flags); +int lwip_sendto_r(int s, const void *dataptr, size_t size, int flags, + const struct sockaddr *to, socklen_t tolen); +int lwip_socket(int domain, int type, int protocol); +int lwip_write_r(int s, const void *dataptr, size_t size); +int lwip_writev_r(int s, const struct iovec *iov, int iovcnt); +int lwip_select(int maxfdp1, fd_set *readset, fd_set *writeset, fd_set *exceptset, + struct timeval *timeout); +int lwip_ioctl_r(int s, long cmd, void *argp); +int lwip_fcntl_r(int s, int cmd, int val); + +#define accept(s,addr,addrlen) lwip_accept_r(s,addr,addrlen) +#define bind(s,name,namelen) lwip_bind_r(s,name,namelen) +#define shutdown(s,how) lwip_shutdown_r(s,how) +#define getpeername(s,name,namelen) lwip_getpeername_r(s,name,namelen) +#define getsockname(s,name,namelen) lwip_getsockname_r(s,name,namelen) +#define setsockopt(s,level,optname,opval,optlen) lwip_setsockopt_r(s,level,optname,opval,optlen) +#define getsockopt(s,level,optname,opval,optlen) lwip_getsockopt_r(s,level,optname,opval,optlen) +#define closesocket(s) lwip_close_r(s) +#define connect(s,name,namelen) lwip_connect_r(s,name,namelen) +#define listen(s,backlog) lwip_listen_r(s,backlog) +#define recv(s,mem,len,flags) lwip_recv_r(s,mem,len,flags) +#define recvfrom(s,mem,len,flags,from,fromlen) lwip_recvfrom_r(s,mem,len,flags,from,fromlen) +#define send(s,dataptr,size,flags) lwip_send_r(s,dataptr,size,flags) +#define sendmsg(s,message,flags) lwip_sendmsg_r(s,message,flags) +#define sendto(s,dataptr,size,flags,to,tolen) lwip_sendto_r(s,dataptr,size,flags,to,tolen) +#define socket(domain,type,protocol) lwip_socket(domain,type,protocol) +#define select(maxfdp1,readset,writeset,exceptset,timeout) lwip_select(maxfdp1,readset,writeset,exceptset,timeout) +#define ioctlsocket(s,cmd,argp) lwip_ioctl_r(s,cmd,argp) + +#if LWIP_POSIX_SOCKETS_IO_NAMES +#define read(s,mem,len) lwip_read_r(s,mem,len) +#define write(s,dataptr,len) lwip_write_r(s,dataptr,len) +#define writev(s,iov,iovcnt) lwip_writev_r(s,iov,iovcnt) +#define close(s) lwip_close_r(s) +#define fcntl(s,cmd,val) lwip_fcntl_r(s,cmd,val) +#define ioctl(s,cmd,argp) lwip_ioctl_r(s,cmd,argp) +#endif /* LWIP_POSIX_SOCKETS_IO_NAMES */ + +#else + +#define accept(s,addr,addrlen) lwip_accept(s,addr,addrlen) +#define bind(s,name,namelen) lwip_bind(s,name,namelen) +#define shutdown(s,how) lwip_shutdown(s,how) +#define getpeername(s,name,namelen) lwip_getpeername(s,name,namelen) +#define getsockname(s,name,namelen) lwip_getsockname(s,name,namelen) +#define setsockopt(s,level,optname,opval,optlen) lwip_setsockopt(s,level,optname,opval,optlen) +#define getsockopt(s,level,optname,opval,optlen) lwip_getsockopt(s,level,optname,opval,optlen) +#define closesocket(s) lwip_close(s) +#define connect(s,name,namelen) lwip_connect(s,name,namelen) +#define listen(s,backlog) lwip_listen(s,backlog) +#define recv(s,mem,len,flags) lwip_recv(s,mem,len,flags) +#define recvfrom(s,mem,len,flags,from,fromlen) lwip_recvfrom(s,mem,len,flags,from,fromlen) +#define send(s,dataptr,size,flags) lwip_send(s,dataptr,size,flags) +#define sendmsg(s,message,flags) lwip_sendmsg(s,message,flags) +#define sendto(s,dataptr,size,flags,to,tolen) lwip_sendto(s,dataptr,size,flags,to,tolen) +#define socket(domain,type,protocol) lwip_socket(domain,type,protocol) +#define select(maxfdp1,readset,writeset,exceptset,timeout) lwip_select(maxfdp1,readset,writeset,exceptset,timeout) +#define ioctlsocket(s,cmd,argp) lwip_ioctl(s,cmd,argp) + +#if LWIP_POSIX_SOCKETS_IO_NAMES +#define read(s,mem,len) lwip_read(s,mem,len) +#define write(s,dataptr,len) lwip_write(s,dataptr,len) +#define writev(s,iov,iovcnt) lwip_writev(s,iov,iovcnt) +#define close(s) lwip_close(s) +#define fcntl(s,cmd,val) lwip_fcntl(s,cmd,val) +#define ioctl(s,cmd,argp) lwip_ioctl(s,cmd,argp) +#endif /* LWIP_POSIX_SOCKETS_IO_NAMES */ +#endif /* LWIP_THREAD_SAFE */ + +#endif /* LWIP_COMPAT_SOCKETS != 2 */ + +#if LWIP_IPV4 && LWIP_IPV6 +#define inet_ntop(af,src,dst,size) \ + (((af) == AF_INET6) ? ip6addr_ntoa_r((const ip6_addr_t*)(src),(dst),(size)) \ + : (((af) == AF_INET) ? ip4addr_ntoa_r((const ip4_addr_t*)(src),(dst),(size)) : NULL)) +#define inet_pton(af,src,dst) \ + (((af) == AF_INET6) ? ip6addr_aton((src),(ip6_addr_t*)(dst)) \ + : (((af) == AF_INET) ? ip4addr_aton((src),(ip4_addr_t*)(dst)) : 0)) +#elif LWIP_IPV4 /* LWIP_IPV4 && LWIP_IPV6 */ +#define inet_ntop(af,src,dst,size) \ + (((af) == AF_INET) ? ip4addr_ntoa_r((const ip4_addr_t*)(src),(dst),(size)) : NULL) +#define inet_pton(af,src,dst) \ + (((af) == AF_INET) ? ip4addr_aton((src),(ip4_addr_t*)(dst)) : 0) +#else /* LWIP_IPV4 && LWIP_IPV6 */ +#define inet_ntop(af,src,dst,size) \ + (((af) == AF_INET6) ? ip6addr_ntoa_r((const ip6_addr_t*)(src),(dst),(size)) : NULL) +#define inet_pton(af,src,dst) \ + (((af) == AF_INET6) ? ip6addr_aton((src),(ip6_addr_t*)(dst)) : 0) +#endif /* LWIP_IPV4 && LWIP_IPV6 */ + +#endif /* LWIP_COMPAT_SOCKETS */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_SOCKET */ + +#endif /* LWIP_HDR_SOCKETS_H */ diff --git a/components/lwip/include/lwip/lwip/stats.h b/components/lwip/include/lwip/lwip/stats.h new file mode 100755 index 000000000..176723d27 --- /dev/null +++ b/components/lwip/include/lwip/lwip/stats.h @@ -0,0 +1,462 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_STATS_H +#define LWIP_HDR_STATS_H + +#include "lwip/opt.h" + +#include "lwip/mem.h" +#include "lwip/memp.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if LWIP_STATS + +#ifndef LWIP_STATS_LARGE +#define LWIP_STATS_LARGE 0 +#endif + +#if LWIP_STATS_LARGE +#define STAT_COUNTER u32_t +#define STAT_COUNTER_F U32_F +#else +#define STAT_COUNTER u16_t +#define STAT_COUNTER_F U16_F +#endif + +struct stats_proto { + STAT_COUNTER xmit; /* Transmitted packets. */ + STAT_COUNTER recv; /* Received packets. */ + STAT_COUNTER fw; /* Forwarded packets. */ + STAT_COUNTER drop; /* Dropped packets. */ + STAT_COUNTER chkerr; /* Checksum error. */ + STAT_COUNTER lenerr; /* Invalid length error. */ + STAT_COUNTER memerr; /* Out of memory error. */ + STAT_COUNTER rterr; /* Routing error. */ + STAT_COUNTER proterr; /* Protocol error. */ + STAT_COUNTER opterr; /* Error in options. */ + STAT_COUNTER err; /* Misc error. */ + STAT_COUNTER cachehit; +}; + +struct stats_igmp { + STAT_COUNTER xmit; /* Transmitted packets. */ + STAT_COUNTER recv; /* Received packets. */ + STAT_COUNTER drop; /* Dropped packets. */ + STAT_COUNTER chkerr; /* Checksum error. */ + STAT_COUNTER lenerr; /* Invalid length error. */ + STAT_COUNTER memerr; /* Out of memory error. */ + STAT_COUNTER proterr; /* Protocol error. */ + STAT_COUNTER rx_v1; /* Received v1 frames. */ + STAT_COUNTER rx_group; /* Received group-specific queries. */ + STAT_COUNTER rx_general; /* Received general queries. */ + STAT_COUNTER rx_report; /* Received reports. */ + STAT_COUNTER tx_join; /* Sent joins. */ + STAT_COUNTER tx_leave; /* Sent leaves. */ + STAT_COUNTER tx_report; /* Sent reports. */ +}; + +struct stats_mem { +#ifdef LWIP_DEBUG + const char *name; +#endif /* LWIP_DEBUG */ + STAT_COUNTER err; + mem_size_t avail; + mem_size_t used; + mem_size_t max; + STAT_COUNTER illegal; +}; + +struct stats_syselem { + STAT_COUNTER used; + STAT_COUNTER max; + STAT_COUNTER err; +}; + +struct stats_sys { + struct stats_syselem sem; + struct stats_syselem mutex; + struct stats_syselem mbox; +}; + +struct stats_mib2 { + /* IP */ + u32_t ipinhdrerrors; + u32_t ipinaddrerrors; + u32_t ipinunknownprotos; + u32_t ipindiscards; + u32_t ipindelivers; + u32_t ipoutrequests; + u32_t ipoutdiscards; + u32_t ipoutnoroutes; + u32_t ipreasmoks; + u32_t ipreasmfails; + u32_t ipfragoks; + u32_t ipfragfails; + u32_t ipfragcreates; + u32_t ipreasmreqds; + u32_t ipforwdatagrams; + u32_t ipinreceives; + + /* TCP */ + u32_t tcpactiveopens; + u32_t tcppassiveopens; + u32_t tcpattemptfails; + u32_t tcpestabresets; + u32_t tcpoutsegs; + u32_t tcpretranssegs; + u32_t tcpinsegs; + u32_t tcpinerrs; + u32_t tcpoutrsts; + + /* UDP */ + u32_t udpindatagrams; + u32_t udpnoports; + u32_t udpinerrors; + u32_t udpoutdatagrams; + + /* ICMP */ + u32_t icmpinmsgs; + u32_t icmpinerrors; + u32_t icmpindestunreachs; + u32_t icmpintimeexcds; + u32_t icmpinparmprobs; + u32_t icmpinsrcquenchs; + u32_t icmpinredirects; + u32_t icmpinechos; + u32_t icmpinechoreps; + u32_t icmpintimestamps; + u32_t icmpintimestampreps; + u32_t icmpinaddrmasks; + u32_t icmpinaddrmaskreps; + u32_t icmpoutmsgs; + u32_t icmpouterrors; + u32_t icmpoutdestunreachs; + u32_t icmpouttimeexcds; + u32_t icmpoutechos; /* can be incremented by user application ('ping') */ + u32_t icmpoutechoreps; +}; + +struct stats_mib2_netif_ctrs { + /* The total number of octets received on the interface, including framing characters */ + u32_t ifinoctets; + /* The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were + * not addressed to a multicast or broadcast address at this sub-layer */ + u32_t ifinucastpkts; + /* The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were + * addressed to a multicast or broadcast address at this sub-layer */ + u32_t ifinnucastpkts; + /* The number of inbound packets which were chosen to be discarded even though no errors had + * been detected to prevent their being deliverable to a higher-layer protocol. One possible + * reason for discarding such a packet could be to free up buffer space */ + u32_t ifindiscards; + /* For packet-oriented interfaces, the number of inbound packets that contained errors + * preventing them from being deliverable to a higher-layer protocol. For character- + * oriented or fixed-length interfaces, the number of inbound transmission units that + * contained errors preventing them from being deliverable to a higher-layer protocol. */ + u32_t ifinerrors; + /* For packet-oriented interfaces, the number of packets received via the interface which + * were discarded because of an unknown or unsupported protocol. For character-oriented + * or fixed-length interfaces that support protocol multiplexing the number of transmission + * units received via the interface which were discarded because of an unknown or unsupported + * protocol. For any interface that does not support protocol multiplexing, this counter will + * always be 0 */ + u32_t ifinunknownprotos; + /* The total number of octets transmitted out of the interface, including framing characters. */ + u32_t ifoutoctets; + /* The total number of packets that higher-level protocols requested be transmitted, and + * which were not addressed to a multicast or broadcast address at this sub-layer, including + * those that were discarded or not sent. */ + u32_t ifoutucastpkts; + /* The total number of packets that higher-level protocols requested be transmitted, and which + * were addressed to a multicast or broadcast address at this sub-layer, including + * those that were discarded or not sent. */ + u32_t ifoutnucastpkts; + /* The number of outbound packets which were chosen to be discarded even though no errors had + * been detected to prevent their being transmitted. One possible reason for discarding + * such a packet could be to free up buffer space. */ + u32_t ifoutdiscards; + /* For packet-oriented interfaces, the number of outbound packets that could not be transmitted + * because of errors. For character-oriented or fixed-length interfaces, the number of outbound + * transmission units that could not be transmitted because of errors. */ + u32_t ifouterrors; +}; + +struct stats_ { +#if LINK_STATS + struct stats_proto link; +#endif +#if ETHARP_STATS + struct stats_proto etharp; +#endif +#if IPFRAG_STATS + struct stats_proto ip_frag; +#endif +#if IP_STATS + struct stats_proto ip; +#endif +#if ICMP_STATS + struct stats_proto icmp; +#endif +#if IGMP_STATS + struct stats_igmp igmp; +#endif +#if UDP_STATS + struct stats_proto udp; +#endif +#if TCP_STATS + struct stats_proto tcp; +#endif +#if MEM_STATS + struct stats_mem mem; +#endif +#if MEMP_STATS + struct stats_mem memp[MEMP_MAX]; +#endif +#if SYS_STATS + struct stats_sys sys; +#endif +#if IP6_STATS + struct stats_proto ip6; +#endif +#if ICMP6_STATS + struct stats_proto icmp6; +#endif +#if IP6_FRAG_STATS + struct stats_proto ip6_frag; +#endif +#if MLD6_STATS + struct stats_igmp mld6; +#endif +#if ND6_STATS + struct stats_proto nd6; +#endif +#if MIB2_STATS + struct stats_mib2 mib2; +#endif +}; + +extern struct stats_ lwip_stats; + +void stats_init(void); + +#define STATS_INC(x) ++lwip_stats.x +#define STATS_DEC(x) --lwip_stats.x +#define STATS_INC_USED(x, y) do { lwip_stats.x.used += y; \ + if (lwip_stats.x.max < lwip_stats.x.used) { \ + lwip_stats.x.max = lwip_stats.x.used; \ + } \ + } while(0) +#define STATS_GET(x) lwip_stats.x +#else /* LWIP_STATS */ +#define stats_init() +#define STATS_INC(x) +#define STATS_DEC(x) +#define STATS_INC_USED(x) +#endif /* LWIP_STATS */ + +#if TCP_STATS +#define TCP_STATS_INC(x) STATS_INC(x) +#define TCP_STATS_DISPLAY() stats_display_proto(&lwip_stats.tcp, "TCP") +#else +#define TCP_STATS_INC(x) +#define TCP_STATS_DISPLAY() +#endif + +#if UDP_STATS +#define UDP_STATS_INC(x) STATS_INC(x) +#define UDP_STATS_DISPLAY() stats_display_proto(&lwip_stats.udp, "UDP") +#else +#define UDP_STATS_INC(x) +#define UDP_STATS_DISPLAY() +#endif + +#if ICMP_STATS +#define ICMP_STATS_INC(x) STATS_INC(x) +#define ICMP_STATS_DISPLAY() stats_display_proto(&lwip_stats.icmp, "ICMP") +#else +#define ICMP_STATS_INC(x) +#define ICMP_STATS_DISPLAY() +#endif + +#if IGMP_STATS +#define IGMP_STATS_INC(x) STATS_INC(x) +#define IGMP_STATS_DISPLAY() stats_display_igmp(&lwip_stats.igmp, "IGMP") +#else +#define IGMP_STATS_INC(x) +#define IGMP_STATS_DISPLAY() +#endif + +#if IP_STATS +#define IP_STATS_INC(x) STATS_INC(x) +#define IP_STATS_DISPLAY() stats_display_proto(&lwip_stats.ip, "IP") +#else +#define IP_STATS_INC(x) +#define IP_STATS_DISPLAY() +#endif + +#if IPFRAG_STATS +#define IPFRAG_STATS_INC(x) STATS_INC(x) +#define IPFRAG_STATS_DISPLAY() stats_display_proto(&lwip_stats.ip_frag, "IP_FRAG") +#else +#define IPFRAG_STATS_INC(x) +#define IPFRAG_STATS_DISPLAY() +#endif + +#if ETHARP_STATS +#define ETHARP_STATS_INC(x) STATS_INC(x) +#define ETHARP_STATS_DISPLAY() stats_display_proto(&lwip_stats.etharp, "ETHARP") +#else +#define ETHARP_STATS_INC(x) +#define ETHARP_STATS_DISPLAY() +#endif + +#if LINK_STATS +#define LINK_STATS_INC(x) STATS_INC(x) +#define LINK_STATS_DISPLAY() stats_display_proto(&lwip_stats.link, "LINK") +#else +#define LINK_STATS_INC(x) +#define LINK_STATS_DISPLAY() +#endif + +#if MEM_STATS +#define MEM_STATS_AVAIL(x, y) lwip_stats.mem.x = y +#define MEM_STATS_INC(x) STATS_INC(mem.x) +#define MEM_STATS_INC_USED(x, y) STATS_INC_USED(mem, y) +#define MEM_STATS_DEC_USED(x, y) lwip_stats.mem.x -= y +#define MEM_STATS_DISPLAY() stats_display_mem(&lwip_stats.mem, "HEAP") +#else +#define MEM_STATS_AVAIL(x, y) +#define MEM_STATS_INC(x) +#define MEM_STATS_INC_USED(x, y) +#define MEM_STATS_DEC_USED(x, y) +#define MEM_STATS_DISPLAY() +#endif + +#if MEMP_STATS +#define MEMP_STATS_AVAIL(x, i, y) lwip_stats.memp[i].x = y +#define MEMP_STATS_INC(x, i) STATS_INC(memp[i].x) +#define MEMP_STATS_DEC(x, i) STATS_DEC(memp[i].x) +#define MEMP_STATS_INC_USED(x, i) STATS_INC_USED(memp[i], 1) +#define MEMP_STATS_DISPLAY(i) stats_display_memp(&lwip_stats.memp[i], i) +#define MEMP_STATS_GET(x, i) STATS_GET(memp[i].x) +#else +#define MEMP_STATS_AVAIL(x, i, y) +#define MEMP_STATS_INC(x, i) +#define MEMP_STATS_DEC(x, i) +#define MEMP_STATS_INC_USED(x, i) +#define MEMP_STATS_DISPLAY(i) +#define MEMP_STATS_GET(x, i) 0 +#endif + +#if SYS_STATS +#define SYS_STATS_INC(x) STATS_INC(sys.x) +#define SYS_STATS_DEC(x) STATS_DEC(sys.x) +#define SYS_STATS_INC_USED(x) STATS_INC_USED(sys.x, 1) +#define SYS_STATS_DISPLAY() stats_display_sys(&lwip_stats.sys) +#else +#define SYS_STATS_INC(x) +#define SYS_STATS_DEC(x) +#define SYS_STATS_INC_USED(x) +#define SYS_STATS_DISPLAY() +#endif + +#if IP6_STATS +#define IP6_STATS_INC(x) STATS_INC(x) +#define IP6_STATS_DISPLAY() stats_display_proto(&lwip_stats.ip6, "IPv6") +#else +#define IP6_STATS_INC(x) +#define IP6_STATS_DISPLAY() +#endif + +#if ICMP6_STATS +#define ICMP6_STATS_INC(x) STATS_INC(x) +#define ICMP6_STATS_DISPLAY() stats_display_proto(&lwip_stats.icmp6, "ICMPv6") +#else +#define ICMP6_STATS_INC(x) +#define ICMP6_STATS_DISPLAY() +#endif + +#if IP6_FRAG_STATS +#define IP6_FRAG_STATS_INC(x) STATS_INC(x) +#define IP6_FRAG_STATS_DISPLAY() stats_display_proto(&lwip_stats.ip6_frag, "IPv6 FRAG") +#else +#define IP6_FRAG_STATS_INC(x) +#define IP6_FRAG_STATS_DISPLAY() +#endif + +#if MLD6_STATS +#define MLD6_STATS_INC(x) STATS_INC(x) +#define MLD6_STATS_DISPLAY() stats_display_igmp(&lwip_stats.mld6, "MLDv1") +#else +#define MLD6_STATS_INC(x) +#define MLD6_STATS_DISPLAY() +#endif + +#if ND6_STATS +#define ND6_STATS_INC(x) STATS_INC(x) +#define ND6_STATS_DISPLAY() stats_display_proto(&lwip_stats.nd6, "ND") +#else +#define ND6_STATS_INC(x) +#define ND6_STATS_DISPLAY() +#endif + +#if MIB2_STATS +#define MIB2_STATS_INC(x) STATS_INC(x) +#else +#define MIB2_STATS_INC(x) +#endif + +/* Display of statistics */ +#if LWIP_STATS_DISPLAY +void stats_display(void); +void stats_display_proto(struct stats_proto *proto, const char *name); +void stats_display_igmp(struct stats_igmp *igmp, const char *name); +void stats_display_mem(struct stats_mem *mem, const char *name); +void stats_display_memp(struct stats_mem *mem, int index); +void stats_display_sys(struct stats_sys *sys); +#else /* LWIP_STATS_DISPLAY */ +#define stats_display() +#define stats_display_proto(proto, name) +#define stats_display_igmp(igmp, name) +#define stats_display_mem(mem, name) +#define stats_display_memp(mem, index) +#define stats_display_sys(sys) +#endif /* LWIP_STATS_DISPLAY */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_STATS_H */ diff --git a/components/lwip/include/lwip/lwip/sys.h b/components/lwip/include/lwip/lwip/sys.h new file mode 100755 index 000000000..86d0f3b33 --- /dev/null +++ b/components/lwip/include/lwip/lwip/sys.h @@ -0,0 +1,362 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_SYS_H +#define LWIP_HDR_SYS_H + +#include "lwip/opt.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if NO_SYS + +/* For a totally minimal and standalone system, we provide null + definitions of the sys_ functions. */ +typedef u8_t sys_sem_t; +typedef u8_t sys_mutex_t; +typedef u8_t sys_mbox_t; + +#define sys_sem_new(s, c) ERR_OK +#define sys_sem_signal(s) +#define sys_sem_wait(s) +#define sys_arch_sem_wait(s,t) +#define sys_sem_free(s) +#define sys_sem_valid(s) 0 +#define sys_sem_valid_val(s) 0 +#define sys_sem_set_invalid(s) +#define sys_sem_set_invalid_val(s) +#define sys_mutex_new(mu) ERR_OK +#define sys_mutex_lock(mu) +#define sys_mutex_unlock(mu) +#define sys_mutex_free(mu) +#define sys_mutex_valid(mu) 0 +#define sys_mutex_set_invalid(mu) +#define sys_mbox_new(m, s) ERR_OK +#define sys_mbox_fetch(m,d) +#define sys_mbox_tryfetch(m,d) +#define sys_mbox_post(m,d) +#define sys_mbox_trypost(m,d) +#define sys_mbox_free(m) +#define sys_mbox_valid(m) +#define sys_mbox_valid_val(m) +#define sys_mbox_set_invalid(m) +#define sys_mbox_set_invalid_val(m) + +#define sys_thread_new(n,t,a,s,p) + +#define sys_msleep(t) + +#else /* NO_SYS */ + +/** Return code for timeouts from sys_arch_mbox_fetch and sys_arch_sem_wait */ +#define SYS_ARCH_TIMEOUT 0xffffffffUL + +/** sys_mbox_tryfetch() returns SYS_MBOX_EMPTY if appropriate. + * For now we use the same magic value, but we allow this to change in future. + */ +#define SYS_MBOX_EMPTY SYS_ARCH_TIMEOUT + +#include "lwip/err.h" +#include "arch/sys_arch.h" + +/** Function prototype for thread functions */ +typedef void (*lwip_thread_fn)(void *arg); + +/* Function prototypes for functions to be implemented by platform ports + (in sys_arch.c) */ + +/* Mutex functions: */ + +/** Define LWIP_COMPAT_MUTEX if the port has no mutexes and binary semaphores + should be used instead */ +#ifndef LWIP_COMPAT_MUTEX +#define LWIP_COMPAT_MUTEX 0 +#endif + +#if LWIP_COMPAT_MUTEX +/* for old ports that don't have mutexes: define them to binary semaphores */ +#define sys_mutex_t sys_sem_t +#define sys_mutex_new(mutex) sys_sem_new(mutex, 1) +#define sys_mutex_lock(mutex) sys_sem_wait(mutex) +#define sys_mutex_unlock(mutex) sys_sem_signal(mutex) +#define sys_mutex_free(mutex) sys_sem_free(mutex) +#define sys_mutex_valid(mutex) sys_sem_valid(mutex) +#define sys_mutex_set_invalid(mutex) sys_sem_set_invalid(mutex) + +#else /* LWIP_COMPAT_MUTEX */ + +/** Create a new mutex + * @param mutex pointer to the mutex to create + * @return a new mutex */ +err_t sys_mutex_new(sys_mutex_t *mutex); +/** Lock a mutex + * @param mutex the mutex to lock */ +void sys_mutex_lock(sys_mutex_t *mutex); +/** Unlock a mutex + * @param mutex the mutex to unlock */ +void sys_mutex_unlock(sys_mutex_t *mutex); +/** Delete a semaphore + * @param mutex the mutex to delete */ +void sys_mutex_free(sys_mutex_t *mutex); +#ifndef sys_mutex_valid +/** Check if a mutex is valid/allocated: return 1 for valid, 0 for invalid */ +int sys_mutex_valid(sys_mutex_t *mutex); +#endif +#ifndef sys_mutex_set_invalid +/** Set a mutex invalid so that sys_mutex_valid returns 0 */ +void sys_mutex_set_invalid(sys_mutex_t *mutex); +#endif +#endif /* LWIP_COMPAT_MUTEX */ + +/* Semaphore functions: */ + +/** Create a new semaphore + * @param sem pointer to the semaphore to create + * @param count initial count of the semaphore + * @return ERR_OK if successful, another err_t otherwise */ +err_t sys_sem_new(sys_sem_t *sem, u8_t count); +/** Signals a semaphore + * @param sem the semaphore to signal */ +void sys_sem_signal(sys_sem_t *sem); +/** Wait for a semaphore for the specified timeout + * @param sem the semaphore to wait for + * @param timeout timeout in milliseconds to wait (0 = wait forever) + * @return time (in milliseconds) waited for the semaphore + * or SYS_ARCH_TIMEOUT on timeout */ +u32_t sys_arch_sem_wait(sys_sem_t *sem, u32_t timeout); +/** Delete a semaphore + * @param sem semaphore to delete */ +void sys_sem_free(sys_sem_t *sem); +/** Wait for a semaphore - forever/no timeout */ +#define sys_sem_wait(sem) sys_arch_sem_wait(sem, 0) +#ifndef sys_sem_valid +/** Check if a semaphore is valid/allocated: return 1 for valid, 0 for invalid */ +int sys_sem_valid(sys_sem_t *sem); +#endif +#ifndef sys_sem_set_invalid +/** Set a semaphore invalid so that sys_sem_valid returns 0 */ +void sys_sem_set_invalid(sys_sem_t *sem); +#endif +#ifndef sys_sem_valid_val +/** Same as sys_sem_valid() but taking a value, not a pointer */ +#define sys_sem_valid_val(sem) sys_sem_valid(&(sem)) +#endif +#ifndef sys_sem_set_invalid_val +/** Same as sys_sem_set_invalid() but taking a value, not a pointer */ +#define sys_sem_set_invalid_val(sem) sys_sem_set_invalid(&(sem)) +#endif + +/* Time functions. */ +#ifndef sys_msleep +void sys_msleep(u32_t ms); /* only has a (close to) 1 ms resolution. */ +#endif + +/* Mailbox functions. */ + +/** Create a new mbox of specified size + * @param mbox pointer to the mbox to create + * @param size (minimum) number of messages in this mbox + * @return ERR_OK if successful, another err_t otherwise */ +err_t sys_mbox_new(sys_mbox_t *mbox, int size); +/** Post a message to an mbox - may not fail + * -> blocks if full, only used from tasks not from ISR + * @param mbox mbox to posts the message + * @param msg message to post (ATTENTION: can be NULL) */ +void sys_mbox_post(sys_mbox_t *mbox, void *msg); +/** Try to post a message to an mbox - may fail if full or ISR + * @param mbox mbox to posts the message + * @param msg message to post (ATTENTION: can be NULL) */ +err_t sys_mbox_trypost(sys_mbox_t *mbox, void *msg); +/** Wait for a new message to arrive in the mbox + * @param mbox mbox to get a message from + * @param msg pointer where the message is stored + * @param timeout maximum time (in milliseconds) to wait for a message (0 = wait forever) + * @return time (in milliseconds) waited for a message, may be 0 if not waited + or SYS_ARCH_TIMEOUT on timeout + * The returned time has to be accurate to prevent timer jitter! */ +u32_t sys_arch_mbox_fetch(sys_mbox_t *mbox, void **msg, u32_t timeout); +/* Allow port to override with a macro, e.g. special timeout for sys_arch_mbox_fetch() */ +#ifndef sys_arch_mbox_tryfetch +/** Wait for a new message to arrive in the mbox + * @param mbox mbox to get a message from + * @param msg pointer where the message is stored + * @return 0 (milliseconds) if a message has been received + * or SYS_MBOX_EMPTY if the mailbox is empty */ +u32_t sys_arch_mbox_tryfetch(sys_mbox_t *mbox, void **msg); +#endif +/** For now, we map straight to sys_arch implementation. */ +#define sys_mbox_tryfetch(mbox, msg) sys_arch_mbox_tryfetch(mbox, msg) +/** Delete an mbox + * @param mbox mbox to delete */ +void sys_mbox_free(sys_mbox_t *mbox); +#define sys_mbox_fetch(mbox, msg) sys_arch_mbox_fetch(mbox, msg, 0) +#ifndef sys_mbox_valid +/** Check if an mbox is valid/allocated: return 1 for valid, 0 for invalid */ +int sys_mbox_valid(sys_mbox_t *mbox); +#endif +#ifndef sys_mbox_set_invalid +/** Set an mbox invalid so that sys_mbox_valid returns 0 */ +void sys_mbox_set_invalid(sys_mbox_t *mbox); +#endif +#ifndef sys_mbox_valid_val +/** Same as sys_mbox_valid() but taking a value, not a pointer */ +#define sys_mbox_valid_val(mbox) sys_mbox_valid(&(mbox)) +#endif +#ifndef sys_mbox_set_invalid_val +/** Same as sys_mbox_set_invalid() but taking a value, not a pointer */ +#define sys_mbox_set_invalid_val(mbox) sys_mbox_set_invalid(&(mbox)) +#endif + + +/** The only thread function: + * Creates a new thread + * ATTENTION: although this function returns a value, it MUST NOT FAIL (ports have to assert this!) + * @param name human-readable name for the thread (used for debugging purposes) + * @param thread thread-function + * @param arg parameter passed to 'thread' + * @param stacksize stack size in bytes for the new thread (may be ignored by ports) + * @param prio priority of the new thread (may be ignored by ports) */ +sys_thread_t sys_thread_new(const char *name, lwip_thread_fn thread, void *arg, int stacksize, int prio); + +#endif /* NO_SYS */ + +/* sys_init() must be called before anything else. */ +void sys_init(void); + +#ifndef sys_jiffies +/** Ticks/jiffies since power up. */ +u32_t sys_jiffies(void); +#endif + +/** Returns the current time in milliseconds, + * may be the same as sys_jiffies or at least based on it. */ +u32_t sys_now(void); + +/* Critical Region Protection */ +/* These functions must be implemented in the sys_arch.c file. + In some implementations they can provide a more light-weight protection + mechanism than using semaphores. Otherwise semaphores can be used for + implementation */ +#ifndef SYS_ARCH_PROTECT +/** SYS_LIGHTWEIGHT_PROT + * define SYS_LIGHTWEIGHT_PROT in lwipopts.h if you want inter-task protection + * for certain critical regions during buffer allocation, deallocation and memory + * allocation and deallocation. + */ +#if SYS_LIGHTWEIGHT_PROT + +/** SYS_ARCH_DECL_PROTECT + * declare a protection variable. This macro will default to defining a variable of + * type sys_prot_t. If a particular port needs a different implementation, then + * this macro may be defined in sys_arch.h. + */ +#define SYS_ARCH_DECL_PROTECT(lev) sys_prot_t lev +/** SYS_ARCH_PROTECT + * Perform a "fast" protect. This could be implemented by + * disabling interrupts for an embedded system or by using a semaphore or + * mutex. The implementation should allow calling SYS_ARCH_PROTECT when + * already protected. The old protection level is returned in the variable + * "lev". This macro will default to calling the sys_arch_protect() function + * which should be implemented in sys_arch.c. If a particular port needs a + * different implementation, then this macro may be defined in sys_arch.h + */ +#define SYS_ARCH_PROTECT(lev) lev = sys_arch_protect() +/** SYS_ARCH_UNPROTECT + * Perform a "fast" set of the protection level to "lev". This could be + * implemented by setting the interrupt level to "lev" within the MACRO or by + * using a semaphore or mutex. This macro will default to calling the + * sys_arch_unprotect() function which should be implemented in + * sys_arch.c. If a particular port needs a different implementation, then + * this macro may be defined in sys_arch.h + */ +#define SYS_ARCH_UNPROTECT(lev) sys_arch_unprotect(lev) +sys_prot_t sys_arch_protect(void); +void sys_arch_unprotect(sys_prot_t pval); + +#else + +#define SYS_ARCH_DECL_PROTECT(lev) +#define SYS_ARCH_PROTECT(lev) +#define SYS_ARCH_UNPROTECT(lev) + +#endif /* SYS_LIGHTWEIGHT_PROT */ + +#endif /* SYS_ARCH_PROTECT */ + +/* + * Macros to set/get and increase/decrease variables in a thread-safe way. + * Use these for accessing variable that are used from more than one thread. + */ + +#ifndef SYS_ARCH_INC +#define SYS_ARCH_INC(var, val) do { \ + SYS_ARCH_DECL_PROTECT(old_level); \ + SYS_ARCH_PROTECT(old_level); \ + var += val; \ + SYS_ARCH_UNPROTECT(old_level); \ + } while(0) +#endif /* SYS_ARCH_INC */ + +#ifndef SYS_ARCH_DEC +#define SYS_ARCH_DEC(var, val) do { \ + SYS_ARCH_DECL_PROTECT(old_level); \ + SYS_ARCH_PROTECT(old_level); \ + var -= val; \ + SYS_ARCH_UNPROTECT(old_level); \ + } while(0) +#endif /* SYS_ARCH_DEC */ + +#ifndef SYS_ARCH_GET +#define SYS_ARCH_GET(var, ret) do { \ + SYS_ARCH_DECL_PROTECT(old_level); \ + SYS_ARCH_PROTECT(old_level); \ + ret = var; \ + SYS_ARCH_UNPROTECT(old_level); \ + } while(0) +#endif /* SYS_ARCH_GET */ + +#ifndef SYS_ARCH_SET +#define SYS_ARCH_SET(var, val) do { \ + SYS_ARCH_DECL_PROTECT(old_level); \ + SYS_ARCH_PROTECT(old_level); \ + var = val; \ + SYS_ARCH_UNPROTECT(old_level); \ + } while(0) +#endif /* SYS_ARCH_SET */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_SYS_H */ diff --git a/components/lwip/include/lwip/lwip/tcp.h b/components/lwip/include/lwip/lwip/tcp.h new file mode 100755 index 000000000..d52040f99 --- /dev/null +++ b/components/lwip/include/lwip/lwip/tcp.h @@ -0,0 +1,411 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_TCP_H +#define LWIP_HDR_TCP_H + +#include "lwip/opt.h" + +#if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/mem.h" +#include "lwip/pbuf.h" +#include "lwip/ip.h" +#include "lwip/icmp.h" +#include "lwip/err.h" +#include "lwip/ip6.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct tcp_pcb; + +/** Function prototype for tcp accept callback functions. Called when a new + * connection can be accepted on a listening pcb. + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param newpcb The new connection pcb + * @param err An error code if there has been an error accepting. + * Only return ERR_ABRT if you have called tcp_abort from within the + * callback function! + */ +typedef err_t (*tcp_accept_fn)(void *arg, struct tcp_pcb *newpcb, err_t err); + +/** Function prototype for tcp receive callback functions. Called when data has + * been received. + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param tpcb The connection pcb which received data + * @param p The received data (or NULL when the connection has been closed!) + * @param err An error code if there has been an error receiving + * Only return ERR_ABRT if you have called tcp_abort from within the + * callback function! + */ +typedef err_t (*tcp_recv_fn)(void *arg, struct tcp_pcb *tpcb, + struct pbuf *p, err_t err); + +/** Function prototype for tcp sent callback functions. Called when sent data has + * been acknowledged by the remote side. Use it to free corresponding resources. + * This also means that the pcb has now space available to send new data. + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param tpcb The connection pcb for which data has been acknowledged + * @param len The amount of bytes acknowledged + * @return ERR_OK: try to send some data by calling tcp_output + * Only return ERR_ABRT if you have called tcp_abort from within the + * callback function! + */ +typedef err_t (*tcp_sent_fn)(void *arg, struct tcp_pcb *tpcb, + u16_t len); + +/** Function prototype for tcp poll callback functions. Called periodically as + * specified by @see tcp_poll. + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param tpcb tcp pcb + * @return ERR_OK: try to send some data by calling tcp_output + * Only return ERR_ABRT if you have called tcp_abort from within the + * callback function! + */ +typedef err_t (*tcp_poll_fn)(void *arg, struct tcp_pcb *tpcb); + +/** Function prototype for tcp error callback functions. Called when the pcb + * receives a RST or is unexpectedly closed for any other reason. + * + * @note The corresponding pcb is already freed when this callback is called! + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param err Error code to indicate why the pcb has been closed + * ERR_ABRT: aborted through tcp_abort or by a TCP timer + * ERR_RST: the connection was reset by the remote host + */ +typedef void (*tcp_err_fn)(void *arg, err_t err); + +/** Function prototype for tcp connected callback functions. Called when a pcb + * is connected to the remote side after initiating a connection attempt by + * calling tcp_connect(). + * + * @param arg Additional argument to pass to the callback function (@see tcp_arg()) + * @param tpcb The connection pcb which is connected + * @param err An unused error code, always ERR_OK currently ;-) TODO! + * Only return ERR_ABRT if you have called tcp_abort from within the + * callback function! + * + * @note When a connection attempt fails, the error callback is currently called! + */ +typedef err_t (*tcp_connected_fn)(void *arg, struct tcp_pcb *tpcb, err_t err); + +#if LWIP_WND_SCALE +#define RCV_WND_SCALE(pcb, wnd) (((wnd) >> (pcb)->rcv_scale)) +#define SND_WND_SCALE(pcb, wnd) (((wnd) << (pcb)->snd_scale)) +#define TCPWND16(x) ((u16_t)LWIP_MIN((x), 0xFFFF)) +#define TCP_WND_MAX(pcb) ((tcpwnd_size_t)(((pcb)->flags & TF_WND_SCALE) ? TCP_WND : TCPWND16(TCP_WND))) +typedef u32_t tcpwnd_size_t; +typedef u16_t tcpflags_t; +#else +#define RCV_WND_SCALE(pcb, wnd) (wnd) +#define SND_WND_SCALE(pcb, wnd) (wnd) +#define TCPWND16(x) (x) +#define TCP_WND_MAX(pcb) TCP_WND +typedef u16_t tcpwnd_size_t; +typedef u8_t tcpflags_t; +#endif + +enum tcp_state { + CLOSED = 0, + LISTEN = 1, + SYN_SENT = 2, + SYN_RCVD = 3, + ESTABLISHED = 4, + FIN_WAIT_1 = 5, + FIN_WAIT_2 = 6, + CLOSE_WAIT = 7, + CLOSING = 8, + LAST_ACK = 9, + TIME_WAIT = 10 +}; + +#if LWIP_CALLBACK_API + /* Function to call when a listener has been connected. + * @param arg user-supplied argument (tcp_pcb.callback_arg) + * @param pcb a new tcp_pcb that now is connected + * @param err an error argument (TODO: that is current always ERR_OK?) + * @return ERR_OK: accept the new connection, + * any other err_t aborts the new connection + */ +#define DEF_ACCEPT_CALLBACK tcp_accept_fn accept; +#else /* LWIP_CALLBACK_API */ +#define DEF_ACCEPT_CALLBACK +#endif /* LWIP_CALLBACK_API */ + +/** + * members common to struct tcp_pcb and struct tcp_listen_pcb + */ +#define TCP_PCB_COMMON(type) \ + type *next; /* for the linked list */ \ + void *callback_arg; \ + /* the accept callback for listen- and normal pcbs, if LWIP_CALLBACK_API */ \ + DEF_ACCEPT_CALLBACK \ + enum tcp_state state; /* TCP state */ \ + u8_t prio; \ + /* ports are in host byte order */ \ + u16_t local_port + + +/* the TCP protocol control block */ +struct tcp_pcb { +/** common PCB members */ + IP_PCB; +/** protocol specific PCB members */ + TCP_PCB_COMMON(struct tcp_pcb); + + /* ports are in host byte order */ + u16_t remote_port; + + tcpflags_t flags; +#define TF_ACK_DELAY 0x01U /* Delayed ACK. */ +#define TF_ACK_NOW 0x02U /* Immediate ACK. */ +#define TF_INFR 0x04U /* In fast recovery. */ +#define TF_TIMESTAMP 0x08U /* Timestamp option enabled */ +#define TF_RXCLOSED 0x10U /* rx closed by tcp_shutdown */ +#define TF_FIN 0x20U /* Connection was closed locally (FIN segment enqueued). */ +#define TF_NODELAY 0x40U /* Disable Nagle algorithm */ +#define TF_NAGLEMEMERR 0x80U /* nagle enabled, memerr, try to output to prevent delayed ACK to happen */ +#if LWIP_WND_SCALE +#define TF_WND_SCALE 0x0100U /* Window Scale option enabled */ +#endif + + /* the rest of the fields are in host byte order + as we have to do some math with them */ + + /* Timers */ + u8_t polltmr, pollinterval; + u8_t last_timer; + u32_t tmr; + + /* receiver variables */ + u32_t rcv_nxt; /* next seqno expected */ + tcpwnd_size_t rcv_wnd; /* receiver window available */ + tcpwnd_size_t rcv_ann_wnd; /* receiver window to announce */ + u32_t rcv_ann_right_edge; /* announced right edge of window */ + + /* Retransmission timer. */ + s16_t rtime; + + u16_t mss; /* maximum segment size */ + + /* RTT (round trip time) estimation variables */ + u32_t rttest; /* RTT estimate in 500ms ticks */ + u32_t rtseq; /* sequence number being timed */ + s16_t sa, sv; /* @todo document this */ + + s16_t rto; /* retransmission time-out */ + u8_t nrtx; /* number of retransmissions */ + + /* fast retransmit/recovery */ + u8_t dupacks; + u32_t lastack; /* Highest acknowledged seqno. */ + + /* congestion avoidance/control variables */ + tcpwnd_size_t cwnd; + tcpwnd_size_t ssthresh; + + /* sender variables */ + u32_t snd_nxt; /* next new seqno to be sent */ + u32_t snd_wl1, snd_wl2; /* Sequence and acknowledgement numbers of last + window update. */ + u32_t snd_lbb; /* Sequence number of next byte to be buffered. */ + tcpwnd_size_t snd_wnd; /* sender window */ + tcpwnd_size_t snd_wnd_max; /* the maximum sender window announced by the remote host */ + + tcpwnd_size_t acked; + + tcpwnd_size_t snd_buf; /* Available buffer space for sending (in bytes). */ +#define TCP_SNDQUEUELEN_OVERFLOW (0xffffU-3) + u16_t snd_queuelen; /* Number of pbufs currently in the send buffer. */ + +#if TCP_OVERSIZE + /* Extra bytes available at the end of the last pbuf in unsent. */ + u16_t unsent_oversize; +#endif /* TCP_OVERSIZE */ + + /* These are ordered by sequence number: */ + struct tcp_seg *unsent; /* Unsent (queued) segments. */ + struct tcp_seg *unacked; /* Sent but unacknowledged segments. */ +#if TCP_QUEUE_OOSEQ + struct tcp_seg *ooseq; /* Received out of sequence segments. */ +#endif /* TCP_QUEUE_OOSEQ */ + + struct pbuf *refused_data; /* Data previously received but not yet taken by upper layer */ + +#if LWIP_CALLBACK_API + /* Function to be called when more send buffer space is available. */ + tcp_sent_fn sent; + /* Function to be called when (in-sequence) data has arrived. */ + tcp_recv_fn recv; + /* Function to be called when a connection has been set up. */ + tcp_connected_fn connected; + /* Function which is called periodically. */ + tcp_poll_fn poll; + /* Function to be called whenever a fatal error occurs. */ + tcp_err_fn errf; +#endif /* LWIP_CALLBACK_API */ + +#if LWIP_TCP_TIMESTAMPS + u32_t ts_lastacksent; + u32_t ts_recent; +#endif /* LWIP_TCP_TIMESTAMPS */ + + /* idle time before KEEPALIVE is sent */ + u32_t keep_idle; +#if LWIP_TCP_KEEPALIVE + u32_t keep_intvl; + u32_t keep_cnt; +#endif /* LWIP_TCP_KEEPALIVE */ + + /* Persist timer counter */ + u8_t persist_cnt; + /* Persist timer back-off */ + u8_t persist_backoff; + + /* KEEPALIVE counter */ + u8_t keep_cnt_sent; + +#if LWIP_WND_SCALE + u8_t snd_scale; + u8_t rcv_scale; +#endif +}; + +struct tcp_pcb_listen { +/* Common members of all PCB types */ + IP_PCB; +/* Protocol specific PCB members */ + TCP_PCB_COMMON(struct tcp_pcb_listen); + +#if TCP_LISTEN_BACKLOG + u8_t backlog; + u8_t accepts_pending; +#endif /* TCP_LISTEN_BACKLOG */ +}; + +#if LWIP_EVENT_API + +enum lwip_event { + LWIP_EVENT_ACCEPT, + LWIP_EVENT_SENT, + LWIP_EVENT_RECV, + LWIP_EVENT_CONNECTED, + LWIP_EVENT_POLL, + LWIP_EVENT_ERR +}; + +err_t lwip_tcp_event(void *arg, struct tcp_pcb *pcb, + enum lwip_event, + struct pbuf *p, + u16_t size, + err_t err); + +#endif /* LWIP_EVENT_API */ + +/* Application program's interface: */ +struct tcp_pcb * tcp_new (void); +struct tcp_pcb * tcp_new_ip_type (u8_t type); + +void tcp_arg (struct tcp_pcb *pcb, void *arg); +void tcp_accept (struct tcp_pcb *pcb, tcp_accept_fn accept); +void tcp_recv (struct tcp_pcb *pcb, tcp_recv_fn recv); +void tcp_sent (struct tcp_pcb *pcb, tcp_sent_fn sent); +void tcp_poll (struct tcp_pcb *pcb, tcp_poll_fn poll, u8_t interval); +void tcp_err (struct tcp_pcb *pcb, tcp_err_fn err); + +#define tcp_mss(pcb) (((pcb)->flags & TF_TIMESTAMP) ? ((pcb)->mss - 12) : (pcb)->mss) +#define tcp_sndbuf(pcb) (TCPWND16((pcb)->snd_buf)) +#define tcp_sndqueuelen(pcb) ((pcb)->snd_queuelen) +#define tcp_nagle_disable(pcb) ((pcb)->flags |= TF_NODELAY) +#define tcp_nagle_enable(pcb) ((pcb)->flags = (tcpflags_t)((pcb)->flags & ~TF_NODELAY)) +#define tcp_nagle_disabled(pcb) (((pcb)->flags & TF_NODELAY) != 0) + +#if TCP_LISTEN_BACKLOG +#define tcp_accepted(pcb) do { \ + LWIP_ASSERT("pcb->state == LISTEN (called for wrong pcb?)", pcb->state == LISTEN); \ + (((struct tcp_pcb_listen *)(pcb))->accepts_pending--); } while(0) +#define tcp_backlog_set(pcb, new_backlog) do { \ + LWIP_ASSERT("pcb->state == LISTEN (called for wrong pcb?)", (pcb)->state == LISTEN); \ + ((struct tcp_pcb_listen *)(pcb))->backlog = ((new_backlog) ? (new_backlog) : 1); } while(0) +#else /* TCP_LISTEN_BACKLOG */ +#define tcp_accepted(pcb) LWIP_ASSERT("pcb->state == LISTEN (called for wrong pcb?)", \ + (pcb)->state == LISTEN) +#endif /* TCP_LISTEN_BACKLOG */ + +void tcp_recved (struct tcp_pcb *pcb, u16_t len); +err_t tcp_bind (struct tcp_pcb *pcb, const ip_addr_t *ipaddr, + u16_t port); +err_t tcp_connect (struct tcp_pcb *pcb, const ip_addr_t *ipaddr, + u16_t port, tcp_connected_fn connected); + +struct tcp_pcb * tcp_listen_with_backlog(struct tcp_pcb *pcb, u8_t backlog); +#define tcp_listen(pcb) tcp_listen_with_backlog(pcb, TCP_DEFAULT_LISTEN_BACKLOG) + +void tcp_abort (struct tcp_pcb *pcb); +err_t tcp_close (struct tcp_pcb *pcb); +err_t tcp_shutdown(struct tcp_pcb *pcb, int shut_rx, int shut_tx); + +/* Flags for "apiflags" parameter in tcp_write */ +#define TCP_WRITE_FLAG_COPY 0x01 +#define TCP_WRITE_FLAG_MORE 0x02 + +err_t tcp_write (struct tcp_pcb *pcb, const void *dataptr, u16_t len, + u8_t apiflags); + +void tcp_setprio (struct tcp_pcb *pcb, u8_t prio); + +#define TCP_PRIO_MIN 1 +#define TCP_PRIO_NORMAL 64 +#define TCP_PRIO_MAX 127 + +err_t tcp_output (struct tcp_pcb *pcb); + + +const char* tcp_debug_state_str(enum tcp_state s); + +/* for compatibility with older implementation */ +#define tcp_new_ip6() tcp_new_ip_type(IPADDR_TYPE_V6) + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_TCP */ + +#endif /* LWIP_HDR_TCP_H */ diff --git a/components/lwip/include/lwip/lwip/tcpip.h b/components/lwip/include/lwip/lwip/tcpip.h new file mode 100755 index 000000000..c1235865a --- /dev/null +++ b/components/lwip/include/lwip/lwip/tcpip.h @@ -0,0 +1,85 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_TCPIP_H +#define LWIP_HDR_TCPIP_H + +#include "lwip/opt.h" + +#if !NO_SYS /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/err.h" +#include "lwip/timers.h" +#include "lwip/netif.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct pbuf; +struct netif; + +/** Function prototype for the init_done function passed to tcpip_init */ +typedef void (*tcpip_init_done_fn)(void *arg); +/** Function prototype for functions passed to tcpip_callback() */ +typedef void (*tcpip_callback_fn)(void *ctx); + +/* Forward declarations */ +struct tcpip_callback_msg; + +void tcpip_init(tcpip_init_done_fn tcpip_init_done, void *arg); + +err_t tcpip_inpkt(struct pbuf *p, struct netif *inp, netif_input_fn input_fn); +err_t tcpip_input(struct pbuf *p, struct netif *inp); + +err_t tcpip_callback_with_block(tcpip_callback_fn function, void *ctx, u8_t block); +#define tcpip_callback(f, ctx) tcpip_callback_with_block(f, ctx, 1) + +struct tcpip_callback_msg* tcpip_callbackmsg_new(tcpip_callback_fn function, void *ctx); +void tcpip_callbackmsg_delete(struct tcpip_callback_msg* msg); +err_t tcpip_trycallback(struct tcpip_callback_msg* msg); + +/* free pbufs or heap memory from another context without blocking */ +err_t pbuf_free_callback(struct pbuf *p); +err_t mem_free_callback(void *m); + +#if LWIP_TCPIP_TIMEOUT +err_t tcpip_timeout(u32_t msecs, sys_timeout_handler h, void *arg); +err_t tcpip_untimeout(sys_timeout_handler h, void *arg); +#endif /* LWIP_TCPIP_TIMEOUT */ + +#ifdef __cplusplus +} +#endif + +#endif /* !NO_SYS */ + +#endif /* LWIP_HDR_TCPIP_H */ diff --git a/components/lwip/include/lwip/lwip/timers.h b/components/lwip/include/lwip/lwip/timers.h new file mode 100755 index 000000000..d735392dd --- /dev/null +++ b/components/lwip/include/lwip/lwip/timers.h @@ -0,0 +1,101 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * Simon Goldschmidt + * + */ +#ifndef LWIP_HDR_TIMERS_H +#define LWIP_HDR_TIMERS_H + +#include "lwip/opt.h" + +/* Timers are not supported when NO_SYS==1 and NO_SYS_NO_TIMERS==1 */ +#define LWIP_TIMERS (!NO_SYS || (NO_SYS && !NO_SYS_NO_TIMERS)) + +#if LWIP_TIMERS + +#include "lwip/err.h" +#if !NO_SYS +#include "lwip/sys.h" +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef LWIP_DEBUG_TIMERNAMES +#ifdef LWIP_DEBUG +#define LWIP_DEBUG_TIMERNAMES SYS_DEBUG +#else /* LWIP_DEBUG */ +#define LWIP_DEBUG_TIMERNAMES 0 +#endif /* LWIP_DEBUG*/ +#endif + +/** Function prototype for a timeout callback function. Register such a function + * using sys_timeout(). + * + * @param arg Additional argument to pass to the function - set up by sys_timeout() + */ +typedef void (* sys_timeout_handler)(void *arg); + +struct sys_timeo { + struct sys_timeo *next; + u32_t time; + sys_timeout_handler h; + void *arg; +#if LWIP_DEBUG_TIMERNAMES + const char* handler_name; +#endif /* LWIP_DEBUG_TIMERNAMES */ +}; + +void sys_timeouts_init(void); + +#if LWIP_DEBUG_TIMERNAMES +void sys_timeout_debug(u32_t msecs, sys_timeout_handler handler, void *arg, const char* handler_name); +#define sys_timeout(msecs, handler, arg) sys_timeout_debug(msecs, handler, arg, #handler) +#else /* LWIP_DEBUG_TIMERNAMES */ +void sys_timeout(u32_t msecs, sys_timeout_handler handler, void *arg); +#endif /* LWIP_DEBUG_TIMERNAMES */ + +void sys_untimeout(sys_timeout_handler handler, void *arg); +#if NO_SYS +void sys_check_timeouts(void); +void sys_restart_timeouts(void); +u32_t sys_timeouts_sleeptime(void); +#else /* NO_SYS */ +void sys_timeouts_mbox_fetch(sys_mbox_t *mbox, void **msg); +#endif /* NO_SYS */ + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_TIMERS */ +#endif /* LWIP_HDR_TIMERS_H */ diff --git a/components/lwip/include/lwip/lwip/udp.h b/components/lwip/include/lwip/lwip/udp.h new file mode 100755 index 000000000..a370d3f9b --- /dev/null +++ b/components/lwip/include/lwip/lwip/udp.h @@ -0,0 +1,194 @@ +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_UDP_H +#define LWIP_HDR_UDP_H + +#include "lwip/opt.h" + +#if LWIP_UDP /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/netif.h" +#include "lwip/ip_addr.h" +#include "lwip/ip.h" +#include "lwip/ip6_addr.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define UDP_HLEN 8 + +/* Fields are (of course) in network byte order. */ +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct udp_hdr { + PACK_STRUCT_FIELD(u16_t src); + PACK_STRUCT_FIELD(u16_t dest); /* src/dest UDP ports */ + PACK_STRUCT_FIELD(u16_t len); + PACK_STRUCT_FIELD(u16_t chksum); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define UDP_FLAGS_NOCHKSUM 0x01U +#define UDP_FLAGS_UDPLITE 0x02U +#define UDP_FLAGS_CONNECTED 0x04U +#define UDP_FLAGS_MULTICAST_LOOP 0x08U + +struct udp_pcb; + +/** Function prototype for udp pcb receive callback functions + * addr and port are in same byte order as in the pcb + * The callback is responsible for freeing the pbuf + * if it's not used any more. + * + * ATTENTION: Be aware that 'addr' might point into the pbuf 'p' so freeing this pbuf + * can make 'addr' invalid, too. + * + * @param arg user supplied argument (udp_pcb.recv_arg) + * @param pcb the udp_pcb which received data + * @param p the packet buffer that was received + * @param addr the remote IP address from which the packet was received + * @param port the remote port from which the packet was received + */ +typedef void (*udp_recv_fn)(void *arg, struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *addr, u16_t port); + +struct udp_pcb { +/* Common members of all PCB types */ + IP_PCB; + +/* Protocol specific PCB members */ + + struct udp_pcb *next; + + u8_t flags; + /** ports are in host byte order */ + u16_t local_port, remote_port; + +#if LWIP_MULTICAST_TX_OPTIONS + /** outgoing network interface for multicast packets */ + ip_addr_t multicast_ip; + /** TTL for outgoing multicast packets */ + u8_t mcast_ttl; +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + +#if LWIP_UDPLITE + /** used for UDP_LITE only */ + u16_t chksum_len_rx, chksum_len_tx; +#endif /* LWIP_UDPLITE */ + + /** receive callback function */ + udp_recv_fn recv; + /** user-supplied argument for the recv callback */ + void *recv_arg; +}; +/* udp_pcbs export for external reference (e.g. SNMP agent) */ +extern struct udp_pcb *udp_pcbs; + +/* The following functions is the application layer interface to the + UDP code. */ +struct udp_pcb * udp_new (void); +struct udp_pcb * udp_new_ip_type(u8_t type); +void udp_remove (struct udp_pcb *pcb); +err_t udp_bind (struct udp_pcb *pcb, const ip_addr_t *ipaddr, + u16_t port); +err_t udp_connect (struct udp_pcb *pcb, const ip_addr_t *ipaddr, + u16_t port); +void udp_disconnect (struct udp_pcb *pcb); +void udp_recv (struct udp_pcb *pcb, udp_recv_fn recv, + void *recv_arg); +err_t udp_sendto_if (struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, + struct netif *netif); +err_t udp_sendto_if_src(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, + struct netif *netif, const ip_addr_t *src_ip); +err_t udp_sendto (struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port); +err_t udp_send (struct udp_pcb *pcb, struct pbuf *p); + +#if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP +err_t udp_sendto_if_chksum(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, + struct netif *netif, u8_t have_chksum, + u16_t chksum); +err_t udp_sendto_chksum(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, + u8_t have_chksum, u16_t chksum); +err_t udp_send_chksum(struct udp_pcb *pcb, struct pbuf *p, + u8_t have_chksum, u16_t chksum); +err_t udp_sendto_if_src_chksum(struct udp_pcb *pcb, struct pbuf *p, + const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, + u8_t have_chksum, u16_t chksum, const ip_addr_t *src_ip); +#endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */ + +#define udp_flags(pcb) ((pcb)->flags) +#define udp_setflags(pcb, f) ((pcb)->flags = (f)) + +/* The following functions are the lower layer interface to UDP. */ +void udp_input (struct pbuf *p, struct netif *inp); + +void udp_init (void); + +/* for compatibility with older implementation */ +#define udp_new_ip6() udp_new_ip_type(IPADDR_TYPE_V6) + +#if LWIP_MULTICAST_TX_OPTIONS +#define udp_set_multicast_netif_addr(pcb, ip4addr) ip_addr_copy_from_ip4((pcb)->multicast_ip, *(ip4addr)) +#define udp_get_multicast_netif_addr(pcb) ip_2_ip4(&(pcb)->multicast_ip) +#define udp_set_multicast_ttl(pcb, value) do { (pcb)->mcast_ttl = value; } while(0) +#define udp_get_multicast_ttl(pcb) ((pcb)->mcast_ttl) +#endif /* LWIP_MULTICAST_TX_OPTIONS */ + +#if UDP_DEBUG +void udp_debug_print(struct udp_hdr *udphdr); +#else +#define udp_debug_print(udphdr) +#endif + +#if LWIP_IPV4 +void udp_netif_ipv4_addr_changed(const ip4_addr_t* old_addr, const ip4_addr_t* new_addr); +#endif /* LWIP_IPV4 */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_UDP */ + +#endif /* LWIP_HDR_UDP_H */ diff --git a/components/lwip/include/lwip/netif/etharp.h b/components/lwip/include/lwip/netif/etharp.h new file mode 100755 index 000000000..e745dcc3e --- /dev/null +++ b/components/lwip/include/lwip/netif/etharp.h @@ -0,0 +1,143 @@ +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * Copyright (c) 2003-2004 Leon Woestenberg + * Copyright (c) 2003-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef LWIP_HDR_NETIF_ETHARP_H +#define LWIP_HDR_NETIF_ETHARP_H + +#include "lwip/opt.h" + +#if LWIP_ARP || LWIP_ETHERNET /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/ip4_addr.h" +#include "lwip/netif.h" +#include "lwip/ip4.h" +#include "netif/ethernet.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#if LWIP_IPV4 && LWIP_ARP /* don't build if not configured for use in lwipopts.h */ + +#ifndef ETHARP_HWADDR_LEN +#define ETHARP_HWADDR_LEN ETH_HWADDR_LEN +#endif + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +/** the ARP message, see RFC 826 ("Packet format") */ +struct etharp_hdr { + PACK_STRUCT_FIELD(u16_t hwtype); + PACK_STRUCT_FIELD(u16_t proto); + PACK_STRUCT_FLD_8(u8_t hwlen); + PACK_STRUCT_FLD_8(u8_t protolen); + PACK_STRUCT_FIELD(u16_t opcode); + PACK_STRUCT_FLD_S(struct eth_addr shwaddr); + PACK_STRUCT_FLD_S(struct ip4_addr2 sipaddr); + PACK_STRUCT_FLD_S(struct eth_addr dhwaddr); + PACK_STRUCT_FLD_S(struct ip4_addr2 dipaddr); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define SIZEOF_ETHARP_HDR 28 + +#define SIZEOF_ETHARP_PACKET (SIZEOF_ETH_HDR + SIZEOF_ETHARP_HDR) +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) +#define SIZEOF_ETHARP_PACKET_TX (SIZEOF_ETHARP_PACKET + SIZEOF_VLAN_HDR) +#else /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ +#define SIZEOF_ETHARP_PACKET_TX SIZEOF_ETHARP_PACKET +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + +/** 1 seconds period */ +#define ARP_TMR_INTERVAL 1000 + +/** ARP message types (opcodes) */ +#define ARP_REQUEST 1 +#define ARP_REPLY 2 + +#if ARP_QUEUEING +/** struct for queueing outgoing packets for unknown address + * defined here to be accessed by memp.h + */ +struct etharp_q_entry { + struct etharp_q_entry *next; + struct pbuf *p; +}; +#endif /* ARP_QUEUEING */ + +#define etharp_init() /* Compatibility define, no init needed. */ +void etharp_tmr(void); +s8_t etharp_find_addr(struct netif *netif, const ip4_addr_t *ipaddr, + struct eth_addr **eth_ret, const ip4_addr_t **ip_ret); +u8_t etharp_get_entry(u8_t i, ip4_addr_t **ipaddr, struct netif **netif, struct eth_addr **eth_ret); +err_t etharp_output(struct netif *netif, struct pbuf *q, const ip4_addr_t *ipaddr); +err_t etharp_query(struct netif *netif, const ip4_addr_t *ipaddr, struct pbuf *q); +err_t etharp_request(struct netif *netif, const ip4_addr_t *ipaddr); +/** For Ethernet network interfaces, we might want to send "gratuitous ARP"; + * this is an ARP packet sent by a node in order to spontaneously cause other + * nodes to update an entry in their ARP cache. + * From RFC 3220 "IP Mobility Support for IPv4" section 4.6. */ +#define etharp_gratuitous(netif) etharp_request((netif), netif_ip4_addr(netif)) +void etharp_cleanup_netif(struct netif *netif); + +#if ETHARP_SUPPORT_STATIC_ENTRIES +err_t etharp_add_static_entry(const ip4_addr_t *ipaddr, struct eth_addr *ethaddr); +err_t etharp_remove_static_entry(const ip4_addr_t *ipaddr); +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + +#if LWIP_AUTOIP +err_t etharp_raw(struct netif *netif, const struct eth_addr *ethsrc_addr, + const struct eth_addr *ethdst_addr, + const struct eth_addr *hwsrc_addr, const ip4_addr_t *ipsrc_addr, + const struct eth_addr *hwdst_addr, const ip4_addr_t *ipdst_addr, + const u16_t opcode); +#endif /* LWIP_AUTOIP */ + +#endif /* LWIP_IPV4 && LWIP_ARP */ + +void etharp_arp_input(struct netif *netif, struct eth_addr *ethaddr, struct pbuf *p); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_ARP || LWIP_ETHERNET */ + +#endif /* LWIP_HDR_NETIF_ETHARP_H */ diff --git a/components/lwip/include/lwip/netif/ethernet.h b/components/lwip/include/lwip/netif/ethernet.h new file mode 100755 index 000000000..17623e4ad --- /dev/null +++ b/components/lwip/include/lwip/netif/ethernet.h @@ -0,0 +1,171 @@ +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * Copyright (c) 2003-2004 Leon Woestenberg + * Copyright (c) 2003-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef LWIP_HDR_NETIF_ETHERNET_H +#define LWIP_HDR_NETIF_ETHERNET_H + +#include "lwip/opt.h" + +#include "lwip/pbuf.h" +#include "lwip/netif.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef ETH_HWADDR_LEN +#ifdef ETHARP_HWADDR_LEN +#define ETH_HWADDR_LEN ETHARP_HWADDR_LEN /* compatibility mode */ +#else +#define ETH_HWADDR_LEN 6 +#endif +#endif + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct eth_addr { + PACK_STRUCT_FLD_8(u8_t addr[ETH_HWADDR_LEN]); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +/** Ethernet header */ +struct eth_hdr { +#if ETH_PAD_SIZE + PACK_STRUCT_FLD_8(u8_t padding[ETH_PAD_SIZE]); +#endif + PACK_STRUCT_FLD_S(struct eth_addr dest); + PACK_STRUCT_FLD_S(struct eth_addr src); + PACK_STRUCT_FIELD(u16_t type); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define SIZEOF_ETH_HDR (14 + ETH_PAD_SIZE) + +#if ETHARP_SUPPORT_VLAN + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +/** VLAN header inserted between ethernet header and payload + * if 'type' in ethernet header is ETHTYPE_VLAN. + * See IEEE802.Q */ +struct eth_vlan_hdr { + PACK_STRUCT_FIELD(u16_t prio_vid); + PACK_STRUCT_FIELD(u16_t tpid); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#define SIZEOF_VLAN_HDR 4 +#define VLAN_ID(vlan_hdr) (htons((vlan_hdr)->prio_vid) & 0xFFF) + +#endif /* ETHARP_SUPPORT_VLAN */ + +/* A list of often ethtypes (although lwIP does not use all of them): */ +#define ETHTYPE_IP 0x0800U /* Internet protocol v4 */ +#define ETHTYPE_ARP 0x0806U /* Address resolution protocol */ +#define ETHTYPE_WOL 0x0842U /* Wake on lan */ +#define ETHTYPE_VLAN 0x8100U /* Virtual local area network */ +#define ETHTYPE_IPV6 0x86DDU /* Internet protocol v6 */ +#define ETHTYPE_PPPOEDISC 0x8863U /* PPP Over Ethernet Discovery Stage */ +#define ETHTYPE_PPPOE 0x8864U /* PPP Over Ethernet Session Stage */ +#define ETHTYPE_JUMBO 0x8870U /* Jumbo Frames */ +#define ETHTYPE_PROFINET 0x8892U /* Process field network */ +#define ETHTYPE_ETHERCAT 0x88A4U /* Ethernet for control automation technology */ +#define ETHTYPE_LLDP 0x88CCU /* Link layer discovery protocol */ +#define ETHTYPE_SERCOS 0x88CDU /* Serial real-time communication system */ +#define ETHTYPE_PTP 0x88F7U /* Precision time protocol */ +#define ETHTYPE_QINQ 0x9100U /* Q-in-Q, 802.1ad */ + +/** The 24-bit IANA IPv4-multicast OUI is 01-00-5e: */ +#define LL_IP4_MULTICAST_ADDR_0 0x01 +#define LL_IP4_MULTICAST_ADDR_1 0x00 +#define LL_IP4_MULTICAST_ADDR_2 0x5e + +/** IPv6 multicast uses this prefix */ +#define LL_IP6_MULTICAST_ADDR_0 0x33 +#define LL_IP6_MULTICAST_ADDR_1 0x33 + +/** MEMCPY-like macro to copy to/from struct eth_addr's that are local variables + * or known to be 32-bit aligned within the protocol header. */ +#ifndef ETHADDR32_COPY +#define ETHADDR32_COPY(dst, src) SMEMCPY(dst, src, ETH_HWADDR_LEN) +#endif + +/** MEMCPY-like macro to copy to/from struct eth_addr's that are no local + * variables and known to be 16-bit aligned within the protocol header. */ +#ifndef ETHADDR16_COPY +#define ETHADDR16_COPY(dst, src) SMEMCPY(dst, src, ETH_HWADDR_LEN) +#endif + +#if LWIP_ARP || LWIP_ETHERNET + +/** Define this to 1 and define LWIP_ARP_FILTER_NETIF_FN(pbuf, netif, type) + * to a filter function that returns the correct netif when using multiple + * netifs on one hardware interface where the netif's low-level receive + * routine cannot decide for the correct netif (e.g. when mapping multiple + * IP addresses to one hardware interface). + */ +#ifndef LWIP_ARP_FILTER_NETIF +#define LWIP_ARP_FILTER_NETIF 0 +#endif + +err_t ethernet_input(struct pbuf *p, struct netif *netif); + +#define eth_addr_cmp(addr1, addr2) (memcmp((addr1)->addr, (addr2)->addr, ETH_HWADDR_LEN) == 0) + +extern const struct eth_addr ethbroadcast, ethzero; + +#endif /* LWIP_ARP || LWIP_ETHERNET */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_NETIF_ETHERNET_H */ diff --git a/components/lwip/include/lwip/netif/lowpan6.h b/components/lwip/include/lwip/netif/lowpan6.h new file mode 100755 index 000000000..215529389 --- /dev/null +++ b/components/lwip/include/lwip/netif/lowpan6.h @@ -0,0 +1,84 @@ +/** + * @file + * + * 6LowPAN output for IPv6. Uses ND tables for link-layer addressing. Fragments packets to 6LowPAN units. + */ + +/* + * Copyright (c) 2015 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_LOWPAN6_H +#define LWIP_HDR_LOWPAN6_H + +#include "netif/lowpan6_opts.h" + +#if LWIP_IPV6 && LWIP_6LOWPAN /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/ip.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** 1 second period */ +#define LOWPAN6_TMR_INTERVAL 1000 + +void lowpan6_tmr(void); + +err_t lowpan6_set_context(u8_t index, const ip6_addr_t * context); +err_t lowpan6_set_short_addr(u8_t addr_high, u8_t addr_low); + +#if LWIP_IPV4 +err_t lowpan4_output(struct netif *netif, struct pbuf *q, const ip4_addr_t *ipaddr); +#endif /* LWIP_IPV4 */ +err_t lowpan6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr); +err_t lowpan6_input(struct pbuf * p, struct netif *netif); +err_t lowpan6_if_init(struct netif *netif); + +/* pan_id in network byte order. */ +err_t lowpan6_set_pan_id(u16_t pan_id); + +err_t tcpip_6lowpan_input(struct pbuf *p, struct netif *inp); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_IPV6 && LWIP_6LOWPAN */ + +#endif /* LWIP_HDR_LOWPAN6_H */ diff --git a/components/lwip/include/lwip/netif/lowpan6_opts.h b/components/lwip/include/lwip/netif/lowpan6_opts.h new file mode 100755 index 000000000..6a7695759 --- /dev/null +++ b/components/lwip/include/lwip/netif/lowpan6_opts.h @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2015 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#ifndef LWIP_HDR_LOWPAN6_OPTS_H +#define LWIP_HDR_LOWPAN6_OPTS_H + +#include "lwip/opt.h" + +#ifndef LWIP_6LOWPAN +#define LWIP_6LOWPAN 0 +#endif + +#ifndef LWIP_6LOWPAN_NUM_CONTEXTS +#define LWIP_6LOWPAN_NUM_CONTEXTS 10 +#endif + +#ifndef LWIP_6LOWPAN_INFER_SHORT_ADDRESS +#define LWIP_6LOWPAN_INFER_SHORT_ADDRESS 1 +#endif + +#ifndef LWIP_6LOWPAN_IPHC +#define LWIP_6LOWPAN_IPHC 1 +#endif + +#ifndef LWIP_6LOWPAN_HW_CRC +#define LWIP_6LOWPAN_HW_CRC 1 +#endif + +#ifndef LOWPAN6_DEBUG +#define LOWPAN6_DEBUG LWIP_DBG_OFF +#endif + +#endif /* LWIP_HDR_LOWPAN6_OPTS_H */ diff --git a/components/lwip/include/lwip/netif/ppp/ccp.h b/components/lwip/include/lwip/netif/ppp/ccp.h new file mode 100755 index 000000000..a8eab9c0a --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ccp.h @@ -0,0 +1,156 @@ +/* + * ccp.h - Definitions for PPP Compression Control Protocol. + * + * Copyright (c) 1994-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: ccp.h,v 1.12 2004/11/04 10:02:26 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CCP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef CCP_H +#define CCP_H + +/* + * CCP codes. + */ + +#define CCP_CONFREQ 1 +#define CCP_CONFACK 2 +#define CCP_TERMREQ 5 +#define CCP_TERMACK 6 +#define CCP_RESETREQ 14 +#define CCP_RESETACK 15 + +/* + * Max # bytes for a CCP option + */ + +#define CCP_MAX_OPTION_LENGTH 32 + +/* + * Parts of a CCP packet. + */ + +#define CCP_CODE(dp) ((dp)[0]) +#define CCP_ID(dp) ((dp)[1]) +#define CCP_LENGTH(dp) (((dp)[2] << 8) + (dp)[3]) +#define CCP_HDRLEN 4 + +#define CCP_OPT_CODE(dp) ((dp)[0]) +#define CCP_OPT_LENGTH(dp) ((dp)[1]) +#define CCP_OPT_MINLEN 2 + +#if BSDCOMPRESS_SUPPORT +/* + * Definitions for BSD-Compress. + */ + +#define CI_BSD_COMPRESS 21 /* config. option for BSD-Compress */ +#define CILEN_BSD_COMPRESS 3 /* length of config. option */ + +/* Macros for handling the 3rd byte of the BSD-Compress config option. */ +#define BSD_NBITS(x) ((x) & 0x1F) /* number of bits requested */ +#define BSD_VERSION(x) ((x) >> 5) /* version of option format */ +#define BSD_CURRENT_VERSION 1 /* current version number */ +#define BSD_MAKE_OPT(v, n) (((v) << 5) | (n)) + +#define BSD_MIN_BITS 9 /* smallest code size supported */ +#define BSD_MAX_BITS 15 /* largest code size supported */ +#endif /* BSDCOMPRESS_SUPPORT */ + +#if DEFLATE_SUPPORT +/* + * Definitions for Deflate. + */ + +#define CI_DEFLATE 26 /* config option for Deflate */ +#define CI_DEFLATE_DRAFT 24 /* value used in original draft RFC */ +#define CILEN_DEFLATE 4 /* length of its config option */ + +#define DEFLATE_MIN_SIZE 9 +#define DEFLATE_MAX_SIZE 15 +#define DEFLATE_METHOD_VAL 8 +#define DEFLATE_SIZE(x) (((x) >> 4) + 8) +#define DEFLATE_METHOD(x) ((x) & 0x0F) +#define DEFLATE_MAKE_OPT(w) ((((w) - 8) << 4) + DEFLATE_METHOD_VAL) +#define DEFLATE_CHK_SEQUENCE 0 +#endif /* DEFLATE_SUPPORT */ + +#if MPPE_SUPPORT +/* + * Definitions for MPPE. + */ + +#define CI_MPPE 18 /* config option for MPPE */ +#define CILEN_MPPE 6 /* length of config option */ +#endif /* MPPE_SUPPORT */ + +#if PREDICTOR_SUPPORT +/* + * Definitions for other, as yet unsupported, compression methods. + */ + +#define CI_PREDICTOR_1 1 /* config option for Predictor-1 */ +#define CILEN_PREDICTOR_1 2 /* length of its config option */ +#define CI_PREDICTOR_2 2 /* config option for Predictor-2 */ +#define CILEN_PREDICTOR_2 2 /* length of its config option */ +#endif /* PREDICTOR_SUPPORT */ + +typedef struct ccp_options { +#if DEFLATE_SUPPORT + unsigned int deflate :1; /* do Deflate? */ + unsigned int deflate_correct :1; /* use correct code for deflate? */ + unsigned int deflate_draft :1; /* use draft RFC code for deflate? */ +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + unsigned int bsd_compress :1; /* do BSD Compress? */ +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + unsigned int predictor_1 :1; /* do Predictor-1? */ + unsigned int predictor_2 :1; /* do Predictor-2? */ +#endif /* PREDICTOR_SUPPORT */ + +#if MPPE_SUPPORT + u8_t mppe; /* MPPE bitfield */ +#endif /* MPPE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + u_short bsd_bits; /* # bits/code for BSD Compress */ +#endif /* BSDCOMPRESS_SUPPORT */ +#if DEFLATE_SUPPORT + u_short deflate_size; /* lg(window size) for Deflate */ +#endif /* DEFLATE_SUPPORT */ + u8_t method; /* code for chosen compression method */ +} ccp_options; + +extern const struct protent ccp_protent; + +void ccp_resetrequest(ppp_pcb *pcb); /* Issue a reset-request. */ + +#endif /* CCP_H */ +#endif /* PPP_SUPPORT && CCP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/chap-md5.h b/components/lwip/include/lwip/netif/ppp/chap-md5.h new file mode 100755 index 000000000..a05a157d0 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/chap-md5.h @@ -0,0 +1,36 @@ +/* + * chap-md5.h - New CHAP/MD5 implementation. + * + * Copyright (c) 2003 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +extern const struct chap_digest_type md5_digest; + +#endif /* PPP_SUPPORT && CHAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/chap-new.h b/components/lwip/include/lwip/netif/ppp/chap-new.h new file mode 100755 index 000000000..9b7c04875 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/chap-new.h @@ -0,0 +1,192 @@ +/* + * chap-new.c - New CHAP implementation. + * + * Copyright (c) 2003 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef CHAP_H +#define CHAP_H + +#include "ppp.h" + +/* + * CHAP packets begin with a standard header with code, id, len (2 bytes). + */ +#define CHAP_HDRLEN 4 + +/* + * Values for the code field. + */ +#define CHAP_CHALLENGE 1 +#define CHAP_RESPONSE 2 +#define CHAP_SUCCESS 3 +#define CHAP_FAILURE 4 + +/* + * CHAP digest codes. + */ +#define CHAP_MD5 5 +#if MSCHAP_SUPPORT +#define CHAP_MICROSOFT 0x80 +#define CHAP_MICROSOFT_V2 0x81 +#endif /* MSCHAP_SUPPORT */ + +/* + * Semi-arbitrary limits on challenge and response fields. + */ +#define MAX_CHALLENGE_LEN 64 +#define MAX_RESPONSE_LEN 64 + +/* + * These limits apply to challenge and response packets we send. + * The +4 is the +1 that we actually need rounded up. + */ +#define CHAL_MAX_PKTLEN (PPP_HDRLEN + CHAP_HDRLEN + 4 + MAX_CHALLENGE_LEN + MAXNAMELEN) +#define RESP_MAX_PKTLEN (PPP_HDRLEN + CHAP_HDRLEN + 4 + MAX_RESPONSE_LEN + MAXNAMELEN) + +/* bitmask of supported algorithms */ +#if MSCHAP_SUPPORT +#define MDTYPE_MICROSOFT_V2 0x1 +#define MDTYPE_MICROSOFT 0x2 +#endif /* MSCHAP_SUPPORT */ +#define MDTYPE_MD5 0x4 +#define MDTYPE_NONE 0 + +#if MSCHAP_SUPPORT +/* Return the digest alg. ID for the most preferred digest type. */ +#define CHAP_DIGEST(mdtype) \ + ((mdtype) & MDTYPE_MD5)? CHAP_MD5: \ + ((mdtype) & MDTYPE_MICROSOFT_V2)? CHAP_MICROSOFT_V2: \ + ((mdtype) & MDTYPE_MICROSOFT)? CHAP_MICROSOFT: \ + 0 +#else /* !MSCHAP_SUPPORT */ +#define CHAP_DIGEST(mdtype) \ + ((mdtype) & MDTYPE_MD5)? CHAP_MD5: \ + 0 +#endif /* MSCHAP_SUPPORT */ + +/* Return the bit flag (lsb set) for our most preferred digest type. */ +#define CHAP_MDTYPE(mdtype) ((mdtype) ^ ((mdtype) - 1)) & (mdtype) + +/* Return the bit flag for a given digest algorithm ID. */ +#if MSCHAP_SUPPORT +#define CHAP_MDTYPE_D(digest) \ + ((digest) == CHAP_MICROSOFT_V2)? MDTYPE_MICROSOFT_V2: \ + ((digest) == CHAP_MICROSOFT)? MDTYPE_MICROSOFT: \ + ((digest) == CHAP_MD5)? MDTYPE_MD5: \ + 0 +#else /* !MSCHAP_SUPPORT */ +#define CHAP_MDTYPE_D(digest) \ + ((digest) == CHAP_MD5)? MDTYPE_MD5: \ + 0 +#endif /* MSCHAP_SUPPORT */ + +/* Can we do the requested digest? */ +#if MSCHAP_SUPPORT +#define CHAP_CANDIGEST(mdtype, digest) \ + ((digest) == CHAP_MICROSOFT_V2)? (mdtype) & MDTYPE_MICROSOFT_V2: \ + ((digest) == CHAP_MICROSOFT)? (mdtype) & MDTYPE_MICROSOFT: \ + ((digest) == CHAP_MD5)? (mdtype) & MDTYPE_MD5: \ + 0 +#else /* !MSCHAP_SUPPORT */ +#define CHAP_CANDIGEST(mdtype, digest) \ + ((digest) == CHAP_MD5)? (mdtype) & MDTYPE_MD5: \ + 0 +#endif /* MSCHAP_SUPPORT */ + +/* + * The code for each digest type has to supply one of these. + */ +struct chap_digest_type { + int code; + +#if PPP_SERVER + /* + * Note: challenge and response arguments below are formatted as + * a length byte followed by the actual challenge/response data. + */ + void (*generate_challenge)(ppp_pcb *pcb, unsigned char *challenge); + int (*verify_response)(ppp_pcb *pcb, int id, const char *name, + const unsigned char *secret, int secret_len, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space); +#endif /* PPP_SERVER */ + void (*make_response)(ppp_pcb *pcb, unsigned char *response, int id, const char *our_name, + const unsigned char *challenge, const char *secret, int secret_len, + unsigned char *priv); + int (*check_success)(ppp_pcb *pcb, unsigned char *pkt, int len, unsigned char *priv); + void (*handle_failure)(ppp_pcb *pcb, unsigned char *pkt, int len); +}; + +/* + * Each interface is described by chap structure. + */ +#if CHAP_SUPPORT +typedef struct chap_client_state { + u8_t flags; + const char *name; + const struct chap_digest_type *digest; + unsigned char priv[64]; /* private area for digest's use */ +} chap_client_state; + +#if PPP_SERVER +typedef struct chap_server_state { + u8_t flags; + u8_t id; + const char *name; + const struct chap_digest_type *digest; + int challenge_xmits; + int challenge_pktlen; + unsigned char challenge[CHAL_MAX_PKTLEN]; +} chap_server_state; +#endif /* PPP_SERVER */ +#endif /* CHAP_SUPPORT */ + +#if 0 /* UNUSED */ +/* Hook for a plugin to validate CHAP challenge */ +extern int (*chap_verify_hook)(char *name, char *ourname, int id, + const struct chap_digest_type *digest, + unsigned char *challenge, unsigned char *response, + char *message, int message_space); +#endif /* UNUSED */ + +#if PPP_SERVER +/* Called by authentication code to start authenticating the peer. */ +extern void chap_auth_peer(ppp_pcb *pcb, const char *our_name, int digest_code); +#endif /* PPP_SERVER */ + +/* Called by auth. code to start authenticating us to the peer. */ +extern void chap_auth_with_peer(ppp_pcb *pcb, const char *our_name, int digest_code); + +/* Represents the CHAP protocol to the main pppd code */ +extern const struct protent chap_protent; + +#endif /* CHAP_H */ +#endif /* PPP_SUPPORT && CHAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/chap_ms.h b/components/lwip/include/lwip/netif/ppp/chap_ms.h new file mode 100755 index 000000000..709bb8991 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/chap_ms.h @@ -0,0 +1,44 @@ +/* + * chap_ms.h - Challenge Handshake Authentication Protocol definitions. + * + * Copyright (c) 1995 Eric Rosenquist. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: chap_ms.h,v 1.13 2004/11/15 22:13:26 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MSCHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef __CHAPMS_INCLUDE__ + +extern const struct chap_digest_type chapms_digest; +extern const struct chap_digest_type chapms2_digest; + +#define __CHAPMS_INCLUDE__ +#endif /* __CHAPMS_INCLUDE__ */ + +#endif /* PPP_SUPPORT && MSCHAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/eap.h b/components/lwip/include/lwip/netif/ppp/eap.h new file mode 100755 index 000000000..7dfd67636 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/eap.h @@ -0,0 +1,169 @@ +/* + * eap.h - Extensible Authentication Protocol for PPP (RFC 2284) + * + * Copyright (c) 2001 by Sun Microsystems, Inc. + * All rights reserved. + * + * Non-exclusive rights to redistribute, modify, translate, and use + * this software in source and binary forms, in whole or in part, is + * hereby granted, provided that the above copyright notice is + * duplicated in any source form, and that neither the name of the + * copyright holder nor the author is used to endorse or promote + * products derived from this software. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. + * + * Original version by James Carlson + * + * $Id: eap.h,v 1.2 2003/06/11 23:56:26 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && EAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPP_EAP_H +#define PPP_EAP_H + +#include "ppp.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * Packet header = Code, id, length. + */ +#define EAP_HEADERLEN 4 + + +/* EAP message codes. */ +#define EAP_REQUEST 1 +#define EAP_RESPONSE 2 +#define EAP_SUCCESS 3 +#define EAP_FAILURE 4 + +/* EAP types */ +#define EAPT_IDENTITY 1 +#define EAPT_NOTIFICATION 2 +#define EAPT_NAK 3 /* (response only) */ +#define EAPT_MD5CHAP 4 +#define EAPT_OTP 5 /* One-Time Password; RFC 1938 */ +#define EAPT_TOKEN 6 /* Generic Token Card */ +/* 7 and 8 are unassigned. */ +#define EAPT_RSA 9 /* RSA Public Key Authentication */ +#define EAPT_DSS 10 /* DSS Unilateral */ +#define EAPT_KEA 11 /* KEA */ +#define EAPT_KEA_VALIDATE 12 /* KEA-VALIDATE */ +#define EAPT_TLS 13 /* EAP-TLS */ +#define EAPT_DEFENDER 14 /* Defender Token (AXENT) */ +#define EAPT_W2K 15 /* Windows 2000 EAP */ +#define EAPT_ARCOT 16 /* Arcot Systems */ +#define EAPT_CISCOWIRELESS 17 /* Cisco Wireless */ +#define EAPT_NOKIACARD 18 /* Nokia IP smart card */ +#define EAPT_SRP 19 /* Secure Remote Password */ +/* 20 is deprecated */ + +/* EAP SRP-SHA1 Subtypes */ +#define EAPSRP_CHALLENGE 1 /* Request 1 - Challenge */ +#define EAPSRP_CKEY 1 /* Response 1 - Client Key */ +#define EAPSRP_SKEY 2 /* Request 2 - Server Key */ +#define EAPSRP_CVALIDATOR 2 /* Response 2 - Client Validator */ +#define EAPSRP_SVALIDATOR 3 /* Request 3 - Server Validator */ +#define EAPSRP_ACK 3 /* Response 3 - final ack */ +#define EAPSRP_LWRECHALLENGE 4 /* Req/resp 4 - Lightweight rechal */ + +#define SRPVAL_EBIT 0x00000001 /* Use shared key for ECP */ + +#define SRP_PSEUDO_ID "pseudo_" +#define SRP_PSEUDO_LEN 7 + +#define MD5_SIGNATURE_SIZE 16 +#define EAP_MIN_CHALLENGE_LENGTH 17 +#define EAP_MAX_CHALLENGE_LENGTH 24 +#define EAP_MIN_MAX_POWER_OF_TWO_CHALLENGE_LENGTH 3 /* 2^3-1 = 7, 17+7 = 24 */ + +#define EAP_STATES \ + "Initial", "Pending", "Closed", "Listen", "Identify", \ + "SRP1", "SRP2", "SRP3", "MD5Chall", "Open", "SRP4", "BadAuth" + +#define eap_client_active(pcb) ((pcb)->eap.es_client.ea_state == eapListen) +#if PPP_SERVER +#define eap_server_active(pcb) \ + ((pcb)->eap.es_server.ea_state >= eapIdentify && \ + (pcb)->eap.es_server.ea_state <= eapMD5Chall) +#endif /* PPP_SERVER */ + +/* + * Complete EAP state for one PPP session. + */ +enum eap_state_code { + eapInitial = 0, /* No EAP authentication yet requested */ + eapPending, /* Waiting for LCP (no timer) */ + eapClosed, /* Authentication not in use */ + eapListen, /* Client ready (and timer running) */ + eapIdentify, /* EAP Identify sent */ + eapSRP1, /* Sent EAP SRP-SHA1 Subtype 1 */ + eapSRP2, /* Sent EAP SRP-SHA1 Subtype 2 */ + eapSRP3, /* Sent EAP SRP-SHA1 Subtype 3 */ + eapMD5Chall, /* Sent MD5-Challenge */ + eapOpen, /* Completed authentication */ + eapSRP4, /* Sent EAP SRP-SHA1 Subtype 4 */ + eapBadAuth /* Failed authentication */ +}; + +struct eap_auth { + const char *ea_name; /* Our name */ + char ea_peer[MAXNAMELEN +1]; /* Peer's name */ + void *ea_session; /* Authentication library linkage */ + u_char *ea_skey; /* Shared encryption key */ + u_short ea_namelen; /* Length of our name */ + u_short ea_peerlen; /* Length of peer's name */ + enum eap_state_code ea_state; + u_char ea_id; /* Current id */ + u_char ea_requests; /* Number of Requests sent/received */ + u_char ea_responses; /* Number of Responses */ + u_char ea_type; /* One of EAPT_* */ + u32_t ea_keyflags; /* SRP shared key usage flags */ +}; + +#ifndef EAP_MAX_CHALLENGE_LENGTH +#define EAP_MAX_CHALLENGE_LENGTH 24 +#endif +typedef struct eap_state { + struct eap_auth es_client; /* Client (authenticatee) data */ +#if PPP_SERVER + struct eap_auth es_server; /* Server (authenticator) data */ +#endif /* PPP_SERVER */ + int es_savedtime; /* Saved timeout */ + int es_rechallenge; /* EAP rechallenge interval */ + int es_lwrechallenge; /* SRP lightweight rechallenge inter */ + u8_t es_usepseudo; /* Use SRP Pseudonym if offered one */ + int es_usedpseudo; /* Set if we already sent PN */ + int es_challen; /* Length of challenge string */ + u_char es_challenge[EAP_MAX_CHALLENGE_LENGTH]; +} eap_state; + +/* + * Timeouts. + */ +#if 0 /* moved to opt.h */ +#define EAP_DEFTIMEOUT 3 /* Timeout (seconds) for rexmit */ +#define EAP_DEFTRANSMITS 10 /* max # times to transmit */ +#define EAP_DEFREQTIME 20 /* Time to wait for peer request */ +#define EAP_DEFALLOWREQ 20 /* max # times to accept requests */ +#endif /* moved to opt.h */ + +void eap_authwithpeer(ppp_pcb *pcb, const char *localname); +void eap_authpeer(ppp_pcb *pcb, const char *localname); + +extern const struct protent eap_protent; + +#ifdef __cplusplus +} +#endif + +#endif /* PPP_EAP_H */ + +#endif /* PPP_SUPPORT && EAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/ecp.h b/components/lwip/include/lwip/netif/ppp/ecp.h new file mode 100755 index 000000000..cba6678ed --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ecp.h @@ -0,0 +1,50 @@ +/* + * ecp.h - Definitions for PPP Encryption Control Protocol. + * + * Copyright (c) 2002 Google, Inc. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: ecp.h,v 1.2 2003/01/10 07:12:36 fcusack Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && ECP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +typedef struct ecp_options { + bool required; /* Is ECP required? */ + unsigned enctype; /* Encryption type */ +} ecp_options; + +extern fsm ecp_fsm[]; +extern ecp_options ecp_wantoptions[]; +extern ecp_options ecp_gotoptions[]; +extern ecp_options ecp_allowoptions[]; +extern ecp_options ecp_hisoptions[]; + +extern const struct protent ecp_protent; + +#endif /* PPP_SUPPORT && ECP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/eui64.h b/components/lwip/include/lwip/netif/ppp/eui64.h new file mode 100755 index 000000000..dffb5e415 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/eui64.h @@ -0,0 +1,94 @@ +/* + * eui64.h - EUI64 routines for IPv6CP. + * + * Copyright (c) 1999 Tommi Komulainen. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Tommi Komulainen + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: eui64.h,v 1.6 2002/12/04 23:03:32 paulus Exp $ +*/ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV6_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef __EUI64_H__ +#define __EUI64_H__ + +/* + * TODO: + * + * Maybe this should be done by processing struct in6_addr directly... + */ +typedef union +{ + u8_t e8[8]; + u16_t e16[4]; + u32_t e32[2]; +} eui64_t; + +#define eui64_iszero(e) (((e).e32[0] | (e).e32[1]) == 0) +#define eui64_equals(e, o) (((e).e32[0] == (o).e32[0]) && \ + ((e).e32[1] == (o).e32[1])) +#define eui64_zero(e) (e).e32[0] = (e).e32[1] = 0; + +#define eui64_copy(s, d) memcpy(&(d), &(s), sizeof(eui64_t)) + +#define eui64_magic(e) do { \ + (e).e32[0] = magic(); \ + (e).e32[1] = magic(); \ + (e).e8[0] &= ~2; \ + } while (0) +#define eui64_magic_nz(x) do { \ + eui64_magic(x); \ + } while (eui64_iszero(x)) +#define eui64_magic_ne(x, y) do { \ + eui64_magic(x); \ + } while (eui64_equals(x, y)) + +#define eui64_get(ll, cp) do { \ + eui64_copy((*cp), (ll)); \ + (cp) += sizeof(eui64_t); \ + } while (0) + +#define eui64_put(ll, cp) do { \ + eui64_copy((ll), (*cp)); \ + (cp) += sizeof(eui64_t); \ + } while (0) + +#define eui64_set32(e, l) do { \ + (e).e32[0] = 0; \ + (e).e32[1] = htonl(l); \ + } while (0) +#define eui64_setlo32(e, l) eui64_set32(e, l) + +char *eui64_ntoa(eui64_t); /* Returns ascii representation of id */ + +#endif /* __EUI64_H__ */ +#endif /* PPP_SUPPORT && PPP_IPV6_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/fsm.h b/components/lwip/include/lwip/netif/ppp/fsm.h new file mode 100755 index 000000000..fc0a4b106 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/fsm.h @@ -0,0 +1,175 @@ +/* + * fsm.h - {Link, IP} Control Protocol Finite State Machine definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: fsm.h,v 1.10 2004/11/13 02:28:15 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef FSM_H +#define FSM_H + +#include "ppp.h" + +/* + * Packet header = Code, id, length. + */ +#define HEADERLEN 4 + + +/* + * CP (LCP, IPCP, etc.) codes. + */ +#define CONFREQ 1 /* Configuration Request */ +#define CONFACK 2 /* Configuration Ack */ +#define CONFNAK 3 /* Configuration Nak */ +#define CONFREJ 4 /* Configuration Reject */ +#define TERMREQ 5 /* Termination Request */ +#define TERMACK 6 /* Termination Ack */ +#define CODEREJ 7 /* Code Reject */ + + +/* + * Each FSM is described by an fsm structure and fsm callbacks. + */ +typedef struct fsm { + ppp_pcb *pcb; /* PPP Interface */ + const struct fsm_callbacks *callbacks; /* Callback routines */ + const char *term_reason; /* Reason for closing protocol */ + u8_t seen_ack; /* Have received valid Ack/Nak/Rej to Req */ + /* -- This is our only flag, we might use u_int :1 if we have more flags */ + u16_t protocol; /* Data Link Layer Protocol field value */ + u8_t state; /* State */ + u8_t flags; /* Contains option bits */ + u8_t id; /* Current id */ + u8_t reqid; /* Current request id */ + u8_t retransmits; /* Number of retransmissions left */ + u8_t nakloops; /* Number of nak loops since last ack */ + u8_t rnakloops; /* Number of naks received */ + u8_t maxnakloops; /* Maximum number of nak loops tolerated + (necessary because IPCP require a custom large max nak loops value) */ + u8_t term_reason_len; /* Length of term_reason */ +} fsm; + + +typedef struct fsm_callbacks { + void (*resetci) /* Reset our Configuration Information */ + (fsm *); + int (*cilen) /* Length of our Configuration Information */ + (fsm *); + void (*addci) /* Add our Configuration Information */ + (fsm *, u_char *, int *); + int (*ackci) /* ACK our Configuration Information */ + (fsm *, u_char *, int); + int (*nakci) /* NAK our Configuration Information */ + (fsm *, u_char *, int, int); + int (*rejci) /* Reject our Configuration Information */ + (fsm *, u_char *, int); + int (*reqci) /* Request peer's Configuration Information */ + (fsm *, u_char *, int *, int); + void (*up) /* Called when fsm reaches PPP_FSM_OPENED state */ + (fsm *); + void (*down) /* Called when fsm leaves PPP_FSM_OPENED state */ + (fsm *); + void (*starting) /* Called when we want the lower layer */ + (fsm *); + void (*finished) /* Called when we don't want the lower layer */ + (fsm *); + void (*protreject) /* Called when Protocol-Reject received */ + (int); + void (*retransmit) /* Retransmission is necessary */ + (fsm *); + int (*extcode) /* Called when unknown code received */ + (fsm *, int, int, u_char *, int); + const char *proto_name; /* String name for protocol (for messages) */ +} fsm_callbacks; + + +/* + * Link states. + */ +#define PPP_FSM_INITIAL 0 /* Down, hasn't been opened */ +#define PPP_FSM_STARTING 1 /* Down, been opened */ +#define PPP_FSM_CLOSED 2 /* Up, hasn't been opened */ +#define PPP_FSM_STOPPED 3 /* Open, waiting for down event */ +#define PPP_FSM_CLOSING 4 /* Terminating the connection, not open */ +#define PPP_FSM_STOPPING 5 /* Terminating, but open */ +#define PPP_FSM_REQSENT 6 /* We've sent a Config Request */ +#define PPP_FSM_ACKRCVD 7 /* We've received a Config Ack */ +#define PPP_FSM_ACKSENT 8 /* We've sent a Config Ack */ +#define PPP_FSM_OPENED 9 /* Connection available */ + + +/* + * Flags - indicate options controlling FSM operation + */ +#define OPT_PASSIVE 1 /* Don't die if we don't get a response */ +#define OPT_RESTART 2 /* Treat 2nd OPEN as DOWN, UP */ +#define OPT_SILENT 4 /* Wait for peer to speak first */ + + +/* + * Timeouts. + */ +#if 0 /* moved to opt.h */ +#define DEFTIMEOUT 3 /* Timeout time in seconds */ +#define DEFMAXTERMREQS 2 /* Maximum Terminate-Request transmissions */ +#define DEFMAXCONFREQS 10 /* Maximum Configure-Request transmissions */ +#define DEFMAXNAKLOOPS 5 /* Maximum number of nak loops */ +#endif /* moved to opt.h */ + + +/* + * Prototypes + */ +void fsm_init(fsm *f); +void fsm_lowerup(fsm *f); +void fsm_lowerdown(fsm *f); +void fsm_open(fsm *f); +void fsm_close(fsm *f, const char *reason); +void fsm_input(fsm *f, u_char *inpacket, int l); +void fsm_protreject(fsm *f); +void fsm_sdata(fsm *f, u_char code, u_char id, const u_char *data, int datalen); + + +#endif /* FSM_H */ +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/ipcp.h b/components/lwip/include/lwip/netif/ppp/ipcp.h new file mode 100755 index 000000000..298f8dc66 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ipcp.h @@ -0,0 +1,126 @@ +/* + * ipcp.h - IP Control Protocol definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: ipcp.h,v 1.14 2002/12/04 23:03:32 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV4_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef IPCP_H +#define IPCP_H + +/* + * Options. + */ +#define CI_ADDRS 1 /* IP Addresses */ +#if VJ_SUPPORT +#define CI_COMPRESSTYPE 2 /* Compression Type */ +#endif /* VJ_SUPPORT */ +#define CI_ADDR 3 + +#if LWIP_DNS +#define CI_MS_DNS1 129 /* Primary DNS value */ +#define CI_MS_DNS2 131 /* Secondary DNS value */ +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ +#define CI_MS_WINS1 130 /* Primary WINS value */ +#define CI_MS_WINS2 132 /* Secondary WINS value */ +#endif /* UNUSED - WINS */ + +#if VJ_SUPPORT +#define MAX_STATES 16 /* from slcompress.h */ + +#define IPCP_VJMODE_OLD 1 /* "old" mode (option # = 0x0037) */ +#define IPCP_VJMODE_RFC1172 2 /* "old-rfc"mode (option # = 0x002d) */ +#define IPCP_VJMODE_RFC1332 3 /* "new-rfc"mode (option # = 0x002d, */ + /* maxslot and slot number compression) */ + +#define IPCP_VJ_COMP 0x002d /* current value for VJ compression option*/ +#define IPCP_VJ_COMP_OLD 0x0037 /* "old" (i.e, broken) value for VJ */ + /* compression option*/ +#endif /* VJ_SUPPORT */ + +typedef struct ipcp_options { + unsigned int neg_addr :1; /* Negotiate IP Address? */ + unsigned int old_addrs :1; /* Use old (IP-Addresses) option? */ + unsigned int req_addr :1; /* Ask peer to send IP address? */ +#if 0 /* UNUSED */ + unsigned int default_route :1; /* Assign default route through interface? */ + unsigned int replace_default_route :1; /* Replace default route through interface? */ +#endif /* UNUSED */ +#if 0 /* UNUSED - PROXY ARP */ + unsigned int proxy_arp :1; /* Make proxy ARP entry for peer? */ +#endif /* UNUSED - PROXY ARP */ +#if VJ_SUPPORT + unsigned int neg_vj :1; /* Van Jacobson Compression? */ + unsigned int old_vj :1; /* use old (short) form of VJ option? */ + unsigned int cflag :1; +#endif /* VJ_SUPPORT */ + unsigned int accept_local :1; /* accept peer's value for ouraddr */ + unsigned int accept_remote :1; /* accept peer's value for hisaddr */ +#if LWIP_DNS + unsigned int req_dns1 :1; /* Ask peer to send primary DNS address? */ + unsigned int req_dns2 :1; /* Ask peer to send secondary DNS address? */ +#endif /* LWIP_DNS */ + + u32_t ouraddr, hisaddr; /* Addresses in NETWORK BYTE ORDER */ +#if LWIP_DNS + u32_t dnsaddr[2]; /* Primary and secondary MS DNS entries */ +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ + u32_t winsaddr[2]; /* Primary and secondary MS WINS entries */ +#endif /* UNUSED - WINS */ + +#if VJ_SUPPORT + u16_t vj_protocol; /* protocol value to use in VJ option */ + u8_t maxslotindex; /* values for RFC1332 VJ compression neg. */ +#endif /* VJ_SUPPORT */ +} ipcp_options; + +#if 0 /* UNUSED, already defined by lwIP */ +char *ip_ntoa (u32_t); +#endif /* UNUSED, already defined by lwIP */ + +extern const struct protent ipcp_protent; + +#endif /* IPCP_H */ +#endif /* PPP_SUPPORT && PPP_IPV4_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/ipv6cp.h b/components/lwip/include/lwip/netif/ppp/ipv6cp.h new file mode 100755 index 000000000..540a7d180 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ipv6cp.h @@ -0,0 +1,183 @@ +/* + * ipv6cp.h - PPP IPV6 Control Protocol. + * + * Copyright (c) 1999 Tommi Komulainen. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Tommi Komulainen + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + */ + +/* Original version, based on RFC2023 : + + Copyright (c) 1995, 1996, 1997 Francis.Dupont@inria.fr, INRIA Rocquencourt, + Alain.Durand@imag.fr, IMAG, + Jean-Luc.Richier@imag.fr, IMAG-LSR. + + Copyright (c) 1998, 1999 Francis.Dupont@inria.fr, GIE DYADE, + Alain.Durand@imag.fr, IMAG, + Jean-Luc.Richier@imag.fr, IMAG-LSR. + + Ce travail a été fait au sein du GIE DYADE (Groupement d'Intérêt + Économique ayant pour membres BULL S.A. et l'INRIA). + + Ce logiciel informatique est disponible aux conditions + usuelles dans la recherche, c'est-à-dire qu'il peut + être utilisé, copié, modifié, distribué à l'unique + condition que ce texte soit conservé afin que + l'origine de ce logiciel soit reconnue. + + Le nom de l'Institut National de Recherche en Informatique + et en Automatique (INRIA), de l'IMAG, ou d'une personne morale + ou physique ayant participé à l'élaboration de ce logiciel ne peut + être utilisé sans son accord préalable explicite. + + Ce logiciel est fourni tel quel sans aucune garantie, + support ou responsabilité d'aucune sorte. + Ce logiciel est dérivé de sources d'origine + "University of California at Berkeley" et + "Digital Equipment Corporation" couvertes par des copyrights. + + L'Institut d'Informatique et de Mathématiques Appliquées de Grenoble (IMAG) + est une fédération d'unités mixtes de recherche du CNRS, de l'Institut National + Polytechnique de Grenoble et de l'Université Joseph Fourier regroupant + sept laboratoires dont le laboratoire Logiciels, Systèmes, Réseaux (LSR). + + This work has been done in the context of GIE DYADE (joint R & D venture + between BULL S.A. and INRIA). + + This software is available with usual "research" terms + with the aim of retain credits of the software. + Permission to use, copy, modify and distribute this software for any + purpose and without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies, + and the name of INRIA, IMAG, or any contributor not be used in advertising + or publicity pertaining to this material without the prior explicit + permission. The software is provided "as is" without any + warranties, support or liabilities of any kind. + This software is derived from source code from + "University of California at Berkeley" and + "Digital Equipment Corporation" protected by copyrights. + + Grenoble's Institute of Computer Science and Applied Mathematics (IMAG) + is a federation of seven research units funded by the CNRS, National + Polytechnic Institute of Grenoble and University Joseph Fourier. + The research unit in Software, Systems, Networks (LSR) is member of IMAG. +*/ + +/* + * Derived from : + * + * + * ipcp.h - IP Control Protocol definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: ipv6cp.h,v 1.7 2002/12/04 23:03:32 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV6_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef IPV6CP_H +#define IPV6CP_H + +#include "eui64.h" + +/* + * Options. + */ +#define CI_IFACEID 1 /* Interface Identifier */ +#ifdef IPV6CP_COMP +#define CI_COMPRESSTYPE 2 /* Compression Type */ +#endif /* IPV6CP_COMP */ + +/* No compression types yet defined. + *#define IPV6CP_COMP 0x004f + */ +typedef struct ipv6cp_options { + unsigned int neg_ifaceid :1; /* Negotiate interface identifier? */ + unsigned int req_ifaceid :1; /* Ask peer to send interface identifier? */ + unsigned int accept_local :1; /* accept peer's value for iface id? */ + unsigned int opt_local :1; /* ourtoken set by option */ + unsigned int opt_remote :1; /* histoken set by option */ + unsigned int use_ip :1; /* use IP as interface identifier */ +#if 0 + unsigned int use_persistent :1; /* use uniquely persistent value for address */ +#endif +#ifdef IPV6CP_COMP + unsigned int neg_vj :1; /* Van Jacobson Compression? */ +#endif /* IPV6CP_COMP */ + +#ifdef IPV6CP_COMP + u_short vj_protocol; /* protocol value to use in VJ option */ +#endif /* IPV6CP_COMP */ + eui64_t ourid, hisid; /* Interface identifiers */ +} ipv6cp_options; + +extern const struct protent ipv6cp_protent; + +#endif /* IPV6CP_H */ +#endif /* PPP_SUPPORT && PPP_IPV6_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/lcp.h b/components/lwip/include/lwip/netif/ppp/lcp.h new file mode 100755 index 000000000..04970699a --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/lcp.h @@ -0,0 +1,169 @@ +/* + * lcp.h - Link Control Protocol definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: lcp.h,v 1.20 2004/11/14 22:53:42 carlsonj Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef LCP_H +#define LCP_H + +#include "ppp.h" + +/* + * Options. + */ +#define CI_VENDOR 0 /* Vendor Specific */ +#define CI_MRU 1 /* Maximum Receive Unit */ +#define CI_ASYNCMAP 2 /* Async Control Character Map */ +#define CI_AUTHTYPE 3 /* Authentication Type */ +#define CI_QUALITY 4 /* Quality Protocol */ +#define CI_MAGICNUMBER 5 /* Magic Number */ +#define CI_PCOMPRESSION 7 /* Protocol Field Compression */ +#define CI_ACCOMPRESSION 8 /* Address/Control Field Compression */ +#define CI_FCSALTERN 9 /* FCS-Alternatives */ +#define CI_SDP 10 /* Self-Describing-Pad */ +#define CI_NUMBERED 11 /* Numbered-Mode */ +#define CI_CALLBACK 13 /* callback */ +#define CI_MRRU 17 /* max reconstructed receive unit; multilink */ +#define CI_SSNHF 18 /* short sequence numbers for multilink */ +#define CI_EPDISC 19 /* endpoint discriminator */ +#define CI_MPPLUS 22 /* Multi-Link-Plus-Procedure */ +#define CI_LDISC 23 /* Link-Discriminator */ +#define CI_LCPAUTH 24 /* LCP Authentication */ +#define CI_COBS 25 /* Consistent Overhead Byte Stuffing */ +#define CI_PREFELIS 26 /* Prefix Elision */ +#define CI_MPHDRFMT 27 /* MP Header Format */ +#define CI_I18N 28 /* Internationalization */ +#define CI_SDL 29 /* Simple Data Link */ + +/* + * LCP-specific packet types (code numbers). + */ +#define PROTREJ 8 /* Protocol Reject */ +#define ECHOREQ 9 /* Echo Request */ +#define ECHOREP 10 /* Echo Reply */ +#define DISCREQ 11 /* Discard Request */ +#define IDENTIF 12 /* Identification */ +#define TIMEREM 13 /* Time Remaining */ + +/* Value used as data for CI_CALLBACK option */ +#define CBCP_OPT 6 /* Use callback control protocol */ + +#if 0 /* moved to opt.h */ +#define DEFMRU 1500 /* Try for this */ +#define MINMRU 128 /* No MRUs below this */ +#define MAXMRU 16384 /* Normally limit MRU to this */ +#endif /* moved to opt.h */ + +/* An endpoint discriminator, used with multilink. */ +#define MAX_ENDP_LEN 20 /* maximum length of discriminator value */ +struct epdisc { + unsigned char class_; /* -- The word "class" is reserved in C++. */ + unsigned char length; + unsigned char value[MAX_ENDP_LEN]; +}; + +/* + * The state of options is described by an lcp_options structure. + */ +typedef struct lcp_options { + unsigned int passive :1; /* Don't die if we don't get a response */ + unsigned int silent :1; /* Wait for the other end to start first */ + unsigned int restart :1; /* Restart vs. exit after close */ + unsigned int neg_mru :1; /* Negotiate the MRU? */ + unsigned int neg_asyncmap :1; /* Negotiate the async map? */ +#if PAP_SUPPORT + unsigned int neg_upap :1; /* Ask for UPAP authentication? */ +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + unsigned int neg_chap :1; /* Ask for CHAP authentication? */ +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + unsigned int neg_eap :1; /* Ask for EAP authentication? */ +#endif /* EAP_SUPPORT */ + unsigned int neg_magicnumber :1; /* Ask for magic number? */ + unsigned int neg_pcompression :1; /* HDLC Protocol Field Compression? */ + unsigned int neg_accompression :1; /* HDLC Address/Control Field Compression? */ +#if LQR_SUPPORT + unsigned int neg_lqr :1; /* Negotiate use of Link Quality Reports */ +#endif /* LQR_SUPPORT */ + unsigned int neg_cbcp :1; /* Negotiate use of CBCP */ +#ifdef HAVE_MULTILINK + unsigned int neg_mrru :1; /* negotiate multilink MRRU */ +#endif /* HAVE_MULTILINK */ + unsigned int neg_ssnhf :1; /* negotiate short sequence numbers */ + unsigned int neg_endpoint :1; /* negotiate endpoint discriminator */ + + u16_t mru; /* Value of MRU */ +#ifdef HAVE_MULTILINK + u16_t mrru; /* Value of MRRU, and multilink enable */ +#endif /* MULTILINK */ +#if CHAP_SUPPORT + u8_t chap_mdtype; /* which MD types (hashing algorithm) */ +#endif /* CHAP_SUPPORT */ + u32_t asyncmap; /* Value of async map */ + u32_t magicnumber; + u8_t numloops; /* Number of loops during magic number neg. */ +#if LQR_SUPPORT + u32_t lqr_period; /* Reporting period for LQR 1/100ths second */ +#endif /* LQR_SUPPORT */ + struct epdisc endpoint; /* endpoint discriminator */ +} lcp_options; + +void lcp_open(ppp_pcb *pcb); +void lcp_close(ppp_pcb *pcb, const char *reason); +void lcp_lowerup(ppp_pcb *pcb); +void lcp_lowerdown(ppp_pcb *pcb); +void lcp_sprotrej(ppp_pcb *pcb, u_char *p, int len); /* send protocol reject */ + +extern const struct protent lcp_protent; + +#if 0 /* moved to opt.h */ +/* Default number of times we receive our magic number from the peer + before deciding the link is looped-back. */ +#define DEFLOOPBACKFAIL 10 +#endif /* moved to opt.h */ + +#endif /* LCP_H */ +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/magic.h b/components/lwip/include/lwip/netif/ppp/magic.h new file mode 100755 index 000000000..678ff724d --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/magic.h @@ -0,0 +1,122 @@ +/* + * magic.h - PPP Magic Number definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: magic.h,v 1.5 2003/06/11 23:56:26 paulus Exp $ + */ +/***************************************************************************** +* randm.h - Random number generator header file. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* Copyright (c) 1998 Global Election Systems Inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 98-05-29 Guy Lancaster , Global Election Systems Inc. +* Extracted from avos. +*****************************************************************************/ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef MAGIC_H +#define MAGIC_H + +/*********************** +*** PUBLIC FUNCTIONS *** +***********************/ + +/* + * Initialize the random number generator. + */ +void magic_init(void); + +/* + * Randomize our random seed value. To be called for truely random events + * such as user operations and network traffic. + */ +void magic_randomize(void); + +/* + * Return a new random number. + */ +u32_t magic(void); /* Returns the next magic number */ + +/* + * Fill buffer with random bytes + * + * Use the random pool to generate random data. This degrades to pseudo + * random when used faster than randomness is supplied using magic_churnrand(). + * Thus it's important to make sure that the results of this are not + * published directly because one could predict the next result to at + * least some degree. Also, it's important to get a good seed before + * the first use. + */ +void magic_random_bytes(unsigned char *buf, u32_t buf_len); + +/* + * Return a new random number between 0 and (2^pow)-1 included. + */ +u32_t magic_pow(u8_t pow); + +#endif /* MAGIC_H */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/mppe.h b/components/lwip/include/lwip/netif/ppp/mppe.h new file mode 100755 index 000000000..93086955c --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/mppe.h @@ -0,0 +1,177 @@ +/* + * mppe.h - Definitions for MPPE + * + * Copyright (c) 2008 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MPPE_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef MPPE_H +#define MPPE_H + +#if LWIP_INCLUDED_POLARSSL_ARC4 +#include "netif/ppp/polarssl/arc4.h" +#else +#include "polarssl/arc4.h" +#endif + +#define MPPE_PAD 4 /* MPPE growth per frame */ +#define MPPE_MAX_KEY_LEN 16 /* largest key length (128-bit) */ + +/* option bits for ccp_options.mppe */ +#define MPPE_OPT_40 0x01 /* 40 bit */ +#define MPPE_OPT_128 0x02 /* 128 bit */ +#define MPPE_OPT_STATEFUL 0x04 /* stateful mode */ +/* unsupported opts */ +#define MPPE_OPT_56 0x08 /* 56 bit */ +#define MPPE_OPT_MPPC 0x10 /* MPPC compression */ +#define MPPE_OPT_D 0x20 /* Unknown */ +#define MPPE_OPT_UNSUPPORTED (MPPE_OPT_56|MPPE_OPT_MPPC|MPPE_OPT_D) +#define MPPE_OPT_UNKNOWN 0x40 /* Bits !defined in RFC 3078 were set */ + +/* + * This is not nice ... the alternative is a bitfield struct though. + * And unfortunately, we cannot share the same bits for the option + * names above since C and H are the same bit. We could do a u_int32 + * but then we have to do a htonl() all the time and/or we still need + * to know which octet is which. + */ +#define MPPE_C_BIT 0x01 /* MPPC */ +#define MPPE_D_BIT 0x10 /* Obsolete, usage unknown */ +#define MPPE_L_BIT 0x20 /* 40-bit */ +#define MPPE_S_BIT 0x40 /* 128-bit */ +#define MPPE_M_BIT 0x80 /* 56-bit, not supported */ +#define MPPE_H_BIT 0x01 /* Stateless (in a different byte) */ + +/* Does not include H bit; used for least significant octet only. */ +#define MPPE_ALL_BITS (MPPE_D_BIT|MPPE_L_BIT|MPPE_S_BIT|MPPE_M_BIT|MPPE_H_BIT) + +/* Build a CI from mppe opts (see RFC 3078) */ +#define MPPE_OPTS_TO_CI(opts, ci) \ + do { \ + u_char *ptr = ci; /* u_char[4] */ \ + \ + /* H bit */ \ + if (opts & MPPE_OPT_STATEFUL) \ + *ptr++ = 0x0; \ + else \ + *ptr++ = MPPE_H_BIT; \ + *ptr++ = 0; \ + *ptr++ = 0; \ + \ + /* S,L bits */ \ + *ptr = 0; \ + if (opts & MPPE_OPT_128) \ + *ptr |= MPPE_S_BIT; \ + if (opts & MPPE_OPT_40) \ + *ptr |= MPPE_L_BIT; \ + /* M,D,C bits not supported */ \ + } while (/* CONSTCOND */ 0) + +/* The reverse of the above */ +#define MPPE_CI_TO_OPTS(ci, opts) \ + do { \ + const u_char *ptr = ci; /* u_char[4] */ \ + \ + opts = 0; \ + \ + /* H bit */ \ + if (!(ptr[0] & MPPE_H_BIT)) \ + opts |= MPPE_OPT_STATEFUL; \ + \ + /* S,L bits */ \ + if (ptr[3] & MPPE_S_BIT) \ + opts |= MPPE_OPT_128; \ + if (ptr[3] & MPPE_L_BIT) \ + opts |= MPPE_OPT_40; \ + \ + /* M,D,C bits */ \ + if (ptr[3] & MPPE_M_BIT) \ + opts |= MPPE_OPT_56; \ + if (ptr[3] & MPPE_D_BIT) \ + opts |= MPPE_OPT_D; \ + if (ptr[3] & MPPE_C_BIT) \ + opts |= MPPE_OPT_MPPC; \ + \ + /* Other bits */ \ + if (ptr[0] & ~MPPE_H_BIT) \ + opts |= MPPE_OPT_UNKNOWN; \ + if (ptr[1] || ptr[2]) \ + opts |= MPPE_OPT_UNKNOWN; \ + if (ptr[3] & ~MPPE_ALL_BITS) \ + opts |= MPPE_OPT_UNKNOWN; \ + } while (/* CONSTCOND */ 0) + +/* Shared MPPE padding between MSCHAP and MPPE */ +#define SHA1_PAD_SIZE 40 + +static const u8_t mppe_sha1_pad1[SHA1_PAD_SIZE] = { + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 +}; +static const u8_t mppe_sha1_pad2[SHA1_PAD_SIZE] = { + 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, + 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, + 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, + 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2 +}; + +/* + * State for an MPPE (de)compressor. + */ +typedef struct ppp_mppe_state { + arc4_context arc4; + u8_t master_key[MPPE_MAX_KEY_LEN]; + u8_t session_key[MPPE_MAX_KEY_LEN]; + u8_t keylen; /* key length in bytes */ + /* NB: 128-bit == 16, 40-bit == 8! + * If we want to support 56-bit, the unit has to change to bits + */ + u8_t bits; /* MPPE control bits */ + u16_t ccount; /* 12-bit coherency count (seqno) */ + u16_t sanity_errors; /* take down LCP if too many */ + unsigned int stateful :1; /* stateful mode flag */ + unsigned int discard :1; /* stateful mode packet loss flag */ +} ppp_mppe_state; + +void mppe_set_key(ppp_pcb *pcb, ppp_mppe_state *state, u8_t *key); +void mppe_init(ppp_pcb *pcb, ppp_mppe_state *state, u8_t options); +void mppe_comp_reset(ppp_pcb *pcb, ppp_mppe_state *state); +err_t mppe_compress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb, u16_t protocol); +void mppe_decomp_reset(ppp_pcb *pcb, ppp_mppe_state *state); +err_t mppe_decompress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb); + +#endif /* MPPE_H */ +#endif /* PPP_SUPPORT && MPPE_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/polarssl/arc4.h b/components/lwip/include/lwip/netif/ppp/polarssl/arc4.h new file mode 100755 index 000000000..95d9b34a9 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/polarssl/arc4.h @@ -0,0 +1,81 @@ +/** + * \file arc4.h + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if LWIP_INCLUDED_POLARSSL_ARC4 + +#ifndef LWIP_INCLUDED_POLARSSL_ARC4_H +#define LWIP_INCLUDED_POLARSSL_ARC4_H + +/** + * \brief ARC4 context structure + */ +typedef struct +{ + int x; /*!< permutation index */ + int y; /*!< permutation index */ + unsigned char m[256]; /*!< permutation table */ +} +arc4_context; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \brief ARC4 key schedule + * + * \param ctx ARC4 context to be initialized + * \param key the secret key + * \param keylen length of the key + */ +void arc4_setup( arc4_context *ctx, unsigned char *key, int keylen ); + +/** + * \brief ARC4 cipher function + * + * \param ctx ARC4 context + * \param buf buffer to be processed + * \param buflen amount of data in buf + */ +void arc4_crypt( arc4_context *ctx, unsigned char *buf, int buflen ); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_INCLUDED_POLARSSL_ARC4_H */ + +#endif /* LWIP_INCLUDED_POLARSSL_ARC4 */ diff --git a/components/lwip/include/lwip/netif/ppp/polarssl/des.h b/components/lwip/include/lwip/netif/ppp/polarssl/des.h new file mode 100755 index 000000000..d0858bd82 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/polarssl/des.h @@ -0,0 +1,92 @@ +/** + * \file des.h + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if LWIP_INCLUDED_POLARSSL_DES + +#ifndef LWIP_INCLUDED_POLARSSL_DES_H +#define LWIP_INCLUDED_POLARSSL_DES_H + +#define DES_ENCRYPT 1 +#define DES_DECRYPT 0 + +/** + * \brief DES context structure + */ +typedef struct +{ + int mode; /*!< encrypt/decrypt */ + unsigned long sk[32]; /*!< DES subkeys */ +} +des_context; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \brief DES key schedule (56-bit, encryption) + * + * \param ctx DES context to be initialized + * \param key 8-byte secret key + */ +void des_setkey_enc( des_context *ctx, unsigned char key[8] ); + +/** + * \brief DES key schedule (56-bit, decryption) + * + * \param ctx DES context to be initialized + * \param key 8-byte secret key + */ +void des_setkey_dec( des_context *ctx, unsigned char key[8] ); + +/** + * \brief DES-ECB block encryption/decryption + * + * \param ctx DES context + * \param input 64-bit input block + * \param output 64-bit output block + */ +void des_crypt_ecb( des_context *ctx, + const unsigned char input[8], + unsigned char output[8] ); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_INCLUDED_POLARSSL_DES_H */ + +#endif /* LWIP_INCLUDED_POLARSSL_DES */ diff --git a/components/lwip/include/lwip/netif/ppp/polarssl/md4.h b/components/lwip/include/lwip/netif/ppp/polarssl/md4.h new file mode 100755 index 000000000..a382f85a8 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/polarssl/md4.h @@ -0,0 +1,97 @@ +/** + * \file md4.h + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if LWIP_INCLUDED_POLARSSL_MD4 + +#ifndef LWIP_INCLUDED_POLARSSL_MD4_H +#define LWIP_INCLUDED_POLARSSL_MD4_H + +/** + * \brief MD4 context structure + */ +typedef struct +{ + unsigned long total[2]; /*!< number of bytes processed */ + unsigned long state[4]; /*!< intermediate digest state */ + unsigned char buffer[64]; /*!< data block being processed */ +} +md4_context; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \brief MD4 context setup + * + * \param ctx context to be initialized + */ +void md4_starts( md4_context *ctx ); + +/** + * \brief MD4 process buffer + * + * \param ctx MD4 context + * \param input buffer holding the data + * \param ilen length of the input data + */ +void md4_update( md4_context *ctx, const unsigned char *input, int ilen ); + +/** + * \brief MD4 final digest + * + * \param ctx MD4 context + * \param output MD4 checksum result + */ +void md4_finish( md4_context *ctx, unsigned char output[16] ); + +/** + * \brief Output = MD4( input buffer ) + * + * \param input buffer holding the data + * \param ilen length of the input data + * \param output MD4 checksum result + */ +void md4( unsigned char *input, int ilen, unsigned char output[16] ); + + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_INCLUDED_POLARSSL_MD4_H */ + +#endif /* LWIP_INCLUDED_POLARSSL_MD4 */ diff --git a/components/lwip/include/lwip/netif/ppp/polarssl/md5.h b/components/lwip/include/lwip/netif/ppp/polarssl/md5.h new file mode 100755 index 000000000..a299d98cb --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/polarssl/md5.h @@ -0,0 +1,96 @@ +/** + * \file md5.h + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if LWIP_INCLUDED_POLARSSL_MD5 + +#ifndef LWIP_INCLUDED_POLARSSL_MD5_H +#define LWIP_INCLUDED_POLARSSL_MD5_H + +/** + * \brief MD5 context structure + */ +typedef struct +{ + unsigned long total[2]; /*!< number of bytes processed */ + unsigned long state[4]; /*!< intermediate digest state */ + unsigned char buffer[64]; /*!< data block being processed */ +} +md5_context; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \brief MD5 context setup + * + * \param ctx context to be initialized + */ +void md5_starts( md5_context *ctx ); + +/** + * \brief MD5 process buffer + * + * \param ctx MD5 context + * \param input buffer holding the data + * \param ilen length of the input data + */ +void md5_update( md5_context *ctx, const unsigned char *input, int ilen ); + +/** + * \brief MD5 final digest + * + * \param ctx MD5 context + * \param output MD5 checksum result + */ +void md5_finish( md5_context *ctx, unsigned char output[16] ); + +/** + * \brief Output = MD5( input buffer ) + * + * \param input buffer holding the data + * \param ilen length of the input data + * \param output MD5 checksum result + */ +void md5( unsigned char *input, int ilen, unsigned char output[16] ); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_INCLUDED_POLARSSL_MD5_H */ + +#endif /* LWIP_INCLUDED_POLARSSL_MD5 */ diff --git a/components/lwip/include/lwip/netif/ppp/polarssl/sha1.h b/components/lwip/include/lwip/netif/ppp/polarssl/sha1.h new file mode 100755 index 000000000..56d947c26 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/polarssl/sha1.h @@ -0,0 +1,96 @@ +/** + * \file sha1.h + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if LWIP_INCLUDED_POLARSSL_SHA1 + +#ifndef LWIP_INCLUDED_POLARSSL_SHA1_H +#define LWIP_INCLUDED_POLARSSL_SHA1_H + +/** + * \brief SHA-1 context structure + */ +typedef struct +{ + unsigned long total[2]; /*!< number of bytes processed */ + unsigned long state[5]; /*!< intermediate digest state */ + unsigned char buffer[64]; /*!< data block being processed */ +} +sha1_context; + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \brief SHA-1 context setup + * + * \param ctx context to be initialized + */ +void sha1_starts( sha1_context *ctx ); + +/** + * \brief SHA-1 process buffer + * + * \param ctx SHA-1 context + * \param input buffer holding the data + * \param ilen length of the input data + */ +void sha1_update( sha1_context *ctx, const unsigned char *input, int ilen ); + +/** + * \brief SHA-1 final digest + * + * \param ctx SHA-1 context + * \param output SHA-1 checksum result + */ +void sha1_finish( sha1_context *ctx, unsigned char output[20] ); + +/** + * \brief Output = SHA-1( input buffer ) + * + * \param input buffer holding the data + * \param ilen length of the input data + * \param output SHA-1 checksum result + */ +void sha1( unsigned char *input, int ilen, unsigned char output[20] ); + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_INCLUDED_POLARSSL_SHA1_H */ + +#endif /* LWIP_INCLUDED_POLARSSL_SHA1 */ diff --git a/components/lwip/include/lwip/netif/ppp/ppp.h b/components/lwip/include/lwip/netif/ppp/ppp.h new file mode 100755 index 000000000..4a5020547 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ppp.h @@ -0,0 +1,573 @@ +/***************************************************************************** +* ppp.h - Network Point to Point Protocol header file. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* portions Copyright (c) 1997 Global Election Systems Inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 97-11-05 Guy Lancaster , Global Election Systems Inc. +* Original derived from BSD codes. +*****************************************************************************/ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPP_H +#define PPP_H + +#include "lwip/def.h" +#include "lwip/stats.h" +#include "lwip/mem.h" +#include "lwip/netif.h" +#include "lwip/sys.h" +#include "lwip/sio.h" +#include "lwip/timers.h" +#if PPP_IPV6_SUPPORT +#include "lwip/ip6_addr.h" +#endif /* PPP_IPV6_SUPPORT */ + +/* Disable non-working or rarely used PPP feature, so rarely that we don't want to bloat opt.h with them */ +#ifndef PPP_OPTIONS +#define PPP_OPTIONS 0 +#endif + +#ifndef PPP_NOTIFY +#define PPP_NOTIFY 0 +#endif + +#ifndef PPP_REMOTENAME +#define PPP_REMOTENAME 0 +#endif + +#ifndef PPP_IDLETIMELIMIT +#define PPP_IDLETIMELIMIT 0 +#endif + +#ifndef PPP_LCP_ADAPTIVE +#define PPP_LCP_ADAPTIVE 0 +#endif + +#ifndef PPP_MAXCONNECT +#define PPP_MAXCONNECT 0 +#endif + +#ifndef PPP_ALLOWED_ADDRS +#define PPP_ALLOWED_ADDRS 0 +#endif + +#ifndef PPP_PROTOCOLNAME +#define PPP_PROTOCOLNAME 0 +#endif + +#ifndef PPP_STATS_SUPPORT +#define PPP_STATS_SUPPORT 0 +#endif + +#ifndef DEFLATE_SUPPORT +#define DEFLATE_SUPPORT 0 +#endif + +#ifndef BSDCOMPRESS_SUPPORT +#define BSDCOMPRESS_SUPPORT 0 +#endif + +#ifndef PREDICTOR_SUPPORT +#define PREDICTOR_SUPPORT 0 +#endif + +/************************* +*** PUBLIC DEFINITIONS *** +*************************/ + +/* + * The basic PPP frame. + */ +#define PPP_HDRLEN 4 /* octets for standard ppp header */ +#define PPP_FCSLEN 2 /* octets for FCS */ + +/* + * Values for phase. + */ +#define PPP_PHASE_DEAD 0 +#define PPP_PHASE_INITIALIZE 1 +#define PPP_PHASE_SERIALCONN 2 +#define PPP_PHASE_DORMANT 3 +#define PPP_PHASE_ESTABLISH 4 +#define PPP_PHASE_AUTHENTICATE 5 +#define PPP_PHASE_CALLBACK 6 +#define PPP_PHASE_NETWORK 7 +#define PPP_PHASE_RUNNING 8 +#define PPP_PHASE_TERMINATE 9 +#define PPP_PHASE_DISCONNECT 10 +#define PPP_PHASE_HOLDOFF 11 +#define PPP_PHASE_MASTER 12 + +/* Error codes. */ +#define PPPERR_NONE 0 /* No error. */ +#define PPPERR_PARAM 1 /* Invalid parameter. */ +#define PPPERR_OPEN 2 /* Unable to open PPP session. */ +#define PPPERR_DEVICE 3 /* Invalid I/O device for PPP. */ +#define PPPERR_ALLOC 4 /* Unable to allocate resources. */ +#define PPPERR_USER 5 /* User interrupt. */ +#define PPPERR_CONNECT 6 /* Connection lost. */ +#define PPPERR_AUTHFAIL 7 /* Failed authentication challenge. */ +#define PPPERR_PROTOCOL 8 /* Failed to meet protocol. */ +#define PPPERR_PEERDEAD 9 /* Connection timeout */ +#define PPPERR_IDLETIMEOUT 10 /* Idle Timeout */ +#define PPPERR_CONNECTTIME 11 /* Max connect time reached */ +#define PPPERR_LOOPBACK 12 /* Loopback detected */ + +/* Whether auth support is enabled at all */ +#define PPP_AUTH_SUPPORT (PAP_SUPPORT || CHAP_SUPPORT || EAP_SUPPORT) + +/************************ +*** PUBLIC DATA TYPES *** +************************/ + +/* + * Other headers require ppp_pcb definition for prototypes, but ppp_pcb + * require some structure definition from other headers as well, we are + * fixing the dependency loop here by declaring the ppp_pcb type then + * by including headers containing necessary struct definition for ppp_pcb + */ +typedef struct ppp_pcb_s ppp_pcb; + +/* Type definitions for BSD code. */ +#ifndef __u_char_defined +typedef unsigned long u_long; +typedef unsigned int u_int; +typedef unsigned short u_short; +typedef unsigned char u_char; +#endif + +#include "fsm.h" +#include "lcp.h" +#if CCP_SUPPORT +#include "ccp.h" +#endif /* CCP_SUPPORT */ +#if MPPE_SUPPORT +#include "mppe.h" +#endif /* MPPE_SUPPORT */ +#if PPP_IPV4_SUPPORT +#include "ipcp.h" +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT +#include "ipv6cp.h" +#endif /* PPP_IPV6_SUPPORT */ +#if PAP_SUPPORT +#include "upap.h" +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT +#include "chap-new.h" +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT +#include "eap.h" +#endif /* EAP_SUPPORT */ +#if VJ_SUPPORT +#include "vj.h" +#endif /* VJ_SUPPORT */ + +/* Link status callback function prototype */ +typedef void (*ppp_link_status_cb_fn)(ppp_pcb *pcb, int err_code, void *ctx); + +/* + * PPP configuration. + */ +typedef struct ppp_settings_s { + +#if PPP_SERVER && PPP_AUTH_SUPPORT + unsigned int auth_required :1; /* Peer is required to authenticate */ + unsigned int null_login :1; /* Username of "" and a password of "" are acceptable */ +#endif /* PPP_SERVER && PPP_AUTH_SUPPORT */ +#if PPP_REMOTENAME + unsigned int explicit_remote :1; /* remote_name specified with remotename opt */ +#endif /* PPP_REMOTENAME */ +#if PAP_SUPPORT + unsigned int refuse_pap :1; /* Don't proceed auth. with PAP */ +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + unsigned int refuse_chap :1; /* Don't proceed auth. with CHAP */ +#endif /* CHAP_SUPPORT */ +#if MSCHAP_SUPPORT + unsigned int refuse_mschap :1; /* Don't proceed auth. with MS-CHAP */ + unsigned int refuse_mschap_v2 :1; /* Don't proceed auth. with MS-CHAPv2 */ +#endif /* MSCHAP_SUPPORT */ +#if EAP_SUPPORT + unsigned int refuse_eap :1; /* Don't proceed auth. with EAP */ +#endif /* EAP_SUPPORT */ +#if LWIP_DNS + unsigned int usepeerdns :1; /* Ask peer for DNS adds */ +#endif /* LWIP_DNS */ + unsigned int persist :1; /* Persist mode, always try to open the connection */ +#if PRINTPKT_SUPPORT + unsigned int hide_password :1; /* Hide password in dumped packets */ +#endif /* PRINTPKT_SUPPORT */ + unsigned int noremoteip :1; /* Let him have no IP address */ + unsigned int lax_recv :1; /* accept control chars in asyncmap */ + unsigned int noendpoint :1; /* don't send/accept endpoint discriminator */ +#if PPP_LCP_ADAPTIVE + unsigned int lcp_echo_adaptive :1; /* request echo only if the link was idle */ +#endif /* PPP_LCP_ADAPTIVE */ +#if MPPE_SUPPORT + unsigned int require_mppe :1; /* Require MPPE (Microsoft Point to Point Encryption) */ + unsigned int refuse_mppe_40 :1; /* Allow MPPE 40-bit mode? */ + unsigned int refuse_mppe_128 :1; /* Allow MPPE 128-bit mode? */ + unsigned int refuse_mppe_stateful :1; /* Allow MPPE stateful mode? */ +#endif /* MPPE_SUPPORT */ + + u16_t listen_time; /* time to listen first (ms), waiting for peer to send LCP packet */ + +#if PPP_IDLETIMELIMIT + u16_t idle_time_limit; /* Disconnect if idle for this many seconds */ +#endif /* PPP_IDLETIMELIMIT */ +#if PPP_MAXCONNECT + u32_t maxconnect; /* Maximum connect time (seconds) */ +#endif /* PPP_MAXCONNECT */ + +#if PPP_AUTH_SUPPORT + /* auth data */ + const char *user; /* Username for PAP */ + const char *passwd; /* Password for PAP, secret for CHAP */ +#if PPP_REMOTENAME + char remote_name[MAXNAMELEN + 1]; /* Peer's name for authentication */ +#endif /* PPP_REMOTENAME */ + +#if PAP_SUPPORT + u8_t pap_timeout_time; /* Timeout (seconds) for auth-req retrans. */ + u8_t pap_max_transmits; /* Number of auth-reqs sent */ +#if PPP_SERVER + u8_t pap_req_timeout; /* Time to wait for auth-req from peer */ +#endif /* PPP_SERVER */ +#endif /* PAP_SUPPPORT */ + +#if CHAP_SUPPORT + u8_t chap_timeout_time; /* Timeout (seconds) for retransmitting req */ + u8_t chap_max_transmits; /* max # times to send challenge */ +#if PPP_SERVER + u8_t chap_rechallenge_time; /* Time to wait for auth-req from peer */ +#endif /* PPP_SERVER */ +#endif /* CHAP_SUPPPORT */ + +#if EAP_SUPPORT + u8_t eap_req_time; /* Time to wait (for retransmit/fail) */ + u8_t eap_allow_req; /* Max Requests allowed */ +#if PPP_SERVER + u8_t eap_timeout_time; /* Time to wait (for retransmit/fail) */ + u8_t eap_max_transmits; /* Max Requests allowed */ +#endif /* PPP_SERVER */ +#endif /* EAP_SUPPORT */ + +#endif /* PPP_AUTH_SUPPORT */ + + u8_t fsm_timeout_time; /* Timeout time in seconds */ + u8_t fsm_max_conf_req_transmits; /* Maximum Configure-Request transmissions */ + u8_t fsm_max_term_transmits; /* Maximum Terminate-Request transmissions */ + u8_t fsm_max_nak_loops; /* Maximum number of nak loops tolerated */ + + u8_t lcp_loopbackfail; /* Number of times we receive our magic number from the peer + before deciding the link is looped-back. */ + u8_t lcp_echo_interval; /* Interval between LCP echo-requests */ + u8_t lcp_echo_fails; /* Tolerance to unanswered echo-requests */ + +} ppp_settings; + +#if PPP_SERVER +struct ppp_addrs { +#if PPP_IPV4_SUPPORT + ip4_addr_t our_ipaddr, his_ipaddr, netmask; +#if LWIP_DNS + ip4_addr_t dns1, dns2; +#endif /* LWIP_DNS */ +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT + ip6_addr_t our6_ipaddr, his6_ipaddr; +#endif /* PPP_IPV6_SUPPORT */ +}; +#endif /* PPP_SERVER */ + +/* + * PPP interface control block. + */ +struct ppp_pcb_s { + /* -- below are data that will NOT be cleared between two sessions */ + ppp_settings settings; + const struct link_callbacks *link_cb; + void *link_ctx_cb; + void (*link_status_cb)(ppp_pcb *pcb, int err_code, void *ctx); /* Status change callback */ +#if PPP_NOTIFY_PHASE + void (*notify_phase_cb)(ppp_pcb *pcb, u8_t phase, void *ctx); /* Notify phase callback */ +#endif /* PPP_NOTIFY_PHASE */ + void *ctx_cb; /* Callbacks optional pointer */ + struct netif *netif; /* PPP interface */ + + /* -- below are data that will be cleared between two sessions */ + + /* + * phase must be the first member of cleared members, because it is used to know + * which part must not be cleared. + */ + u8_t phase; /* where the link is at */ + u8_t err_code; /* Code indicating why interface is down. */ + + /* flags */ +#if PPP_IPV4_SUPPORT + unsigned int ipcp_is_open :1; /* haven't called np_finished() */ + unsigned int ipcp_is_up :1; /* have called ipcp_up() */ + unsigned int if4_up :1; /* True when the IPv4 interface is up. */ +#if 0 /* UNUSED - PROXY ARP */ + unsigned int proxy_arp_set :1; /* Have created proxy arp entry */ +#endif /* UNUSED - PROXY ARP */ +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT + unsigned int ipv6cp_is_up :1; /* have called ip6cp_up() */ + unsigned int if6_up :1; /* True when the IPv6 interface is up. */ +#endif /* PPP_IPV6_SUPPORT */ + unsigned int lcp_echo_timer_running :1; /* set if a timer is running */ +#if VJ_SUPPORT + unsigned int vj_enabled :1; /* Flag indicating VJ compression enabled. */ +#endif /* VJ_SUPPORT */ +#if CCP_SUPPORT + unsigned int ccp_all_rejected :1; /* we rejected all peer's options */ +#endif /* CCP_SUPPORT */ +#if MPPE_SUPPORT + unsigned int mppe_keys_set :1; /* Have the MPPE keys been set? */ +#endif /* MPPE_SUPPORT */ + +#if PPP_AUTH_SUPPORT + /* auth data */ +#if PPP_SERVER && defined(HAVE_MULTILINK) + char peer_authname[MAXNAMELEN + 1]; /* The name by which the peer authenticated itself to us. */ +#endif /* PPP_SERVER && defined(HAVE_MULTILINK) */ + u16_t auth_pending; /* Records which authentication operations haven't completed yet. */ + u16_t auth_done; /* Records which authentication operations have been completed. */ + +#if PAP_SUPPORT + upap_state upap; /* PAP data */ +#endif /* PAP_SUPPORT */ + +#if CHAP_SUPPORT + chap_client_state chap_client; /* CHAP client data */ +#if PPP_SERVER + chap_server_state chap_server; /* CHAP server data */ +#endif /* PPP_SERVER */ +#endif /* CHAP_SUPPORT */ + +#if EAP_SUPPORT + eap_state eap; /* EAP data */ +#endif /* EAP_SUPPORT */ +#endif /* PPP_AUTH_SUPPORT */ + + fsm lcp_fsm; /* LCP fsm structure */ + lcp_options lcp_wantoptions; /* Options that we want to request */ + lcp_options lcp_gotoptions; /* Options that peer ack'd */ + lcp_options lcp_allowoptions; /* Options we allow peer to request */ + lcp_options lcp_hisoptions; /* Options that we ack'd */ + u16_t peer_mru; /* currently negotiated peer MRU */ + u8_t lcp_echos_pending; /* Number of outstanding echo msgs */ + u8_t lcp_echo_number; /* ID number of next echo frame */ + + u8_t num_np_open; /* Number of network protocols which we have opened. */ + u8_t num_np_up; /* Number of network protocols which have come up. */ + +#if VJ_SUPPORT + struct vjcompress vj_comp; /* Van Jacobson compression header. */ +#endif /* VJ_SUPPORT */ + +#if CCP_SUPPORT + fsm ccp_fsm; /* CCP fsm structure */ + ccp_options ccp_wantoptions; /* what to request the peer to use */ + ccp_options ccp_gotoptions; /* what the peer agreed to do */ + ccp_options ccp_allowoptions; /* what we'll agree to do */ + ccp_options ccp_hisoptions; /* what we agreed to do */ + u8_t ccp_localstate; /* Local state (mainly for handling reset-reqs and reset-acks). */ + u8_t ccp_receive_method; /* Method chosen on receive path */ + u8_t ccp_transmit_method; /* Method chosen on transmit path */ +#if MPPE_SUPPORT + ppp_mppe_state mppe_comp; /* MPPE "compressor" structure */ + ppp_mppe_state mppe_decomp; /* MPPE "decompressor" structure */ +#endif /* MPPE_SUPPORT */ +#endif /* CCP_SUPPORT */ + +#if PPP_IPV4_SUPPORT + fsm ipcp_fsm; /* IPCP fsm structure */ + ipcp_options ipcp_wantoptions; /* Options that we want to request */ + ipcp_options ipcp_gotoptions; /* Options that peer ack'd */ + ipcp_options ipcp_allowoptions; /* Options we allow peer to request */ + ipcp_options ipcp_hisoptions; /* Options that we ack'd */ +#endif /* PPP_IPV4_SUPPORT */ + +#if PPP_IPV6_SUPPORT + fsm ipv6cp_fsm; /* IPV6CP fsm structure */ + ipv6cp_options ipv6cp_wantoptions; /* Options that we want to request */ + ipv6cp_options ipv6cp_gotoptions; /* Options that peer ack'd */ + ipv6cp_options ipv6cp_allowoptions; /* Options we allow peer to request */ + ipv6cp_options ipv6cp_hisoptions; /* Options that we ack'd */ +#endif /* PPP_IPV6_SUPPORT */ +}; + +/************************ + *** PUBLIC FUNCTIONS *** + ************************/ + +/* + * Set auth helper, optional, you can either fill ppp_pcb->settings. + * + * Warning: Using PPPAUTHTYPE_ANY might have security consequences. + * RFC 1994 says: + * + * In practice, within or associated with each PPP server, there is a + * database which associates "user" names with authentication + * information ("secrets"). It is not anticipated that a particular + * named user would be authenticated by multiple methods. This would + * make the user vulnerable to attacks which negotiate the least secure + * method from among a set (such as PAP rather than CHAP). If the same + * secret was used, PAP would reveal the secret to be used later with + * CHAP. + * + * Instead, for each user name there should be an indication of exactly + * one method used to authenticate that user name. If a user needs to + * make use of different authentication methods under different + * circumstances, then distinct user names SHOULD be employed, each of + * which identifies exactly one authentication method. + * + */ +#define PPPAUTHTYPE_NONE 0x00 +#define PPPAUTHTYPE_PAP 0x01 +#define PPPAUTHTYPE_CHAP 0x02 +#define PPPAUTHTYPE_MSCHAP 0x04 +#define PPPAUTHTYPE_MSCHAP_V2 0x08 +#define PPPAUTHTYPE_EAP 0x10 +#define PPPAUTHTYPE_ANY 0xff +void ppp_set_auth(ppp_pcb *pcb, u8_t authtype, const char *user, const char *passwd); + +/* + * Set a PPP interface as the default network interface + * (used to output all packets for which no specific route is found). + */ +#define ppp_set_default(ppp) netif_set_default(ppp->netif) + +#if PPP_NOTIFY_PHASE +/* + * Set a PPP notify phase callback. + * + * This can be used for example to set a LED pattern depending on the + * current phase of the PPP session. + */ +typedef void (*ppp_notify_phase_cb_fn)(ppp_pcb *pcb, u8_t phase, void *ctx); +void ppp_set_notify_phase_callback(ppp_pcb *pcb, ppp_notify_phase_cb_fn notify_phase_cb); +#endif /* PPP_NOTIFY_PHASE */ + +/* + * Initiate a PPP connection. + * + * This can only be called if PPP is in the dead phase. + * + * Holdoff is the time to wait (in seconds) before initiating + * the connection. + * + * If this port connects to a modem, the modem connection must be + * established before calling this. + */ +err_t ppp_connect(ppp_pcb *pcb, u16_t holdoff); + +#if PPP_SERVER +/* + * Listen for an incoming PPP connection. + * + * This can only be called if PPP is in the dead phase. + * + * Local and remote interface IP addresses, as well as DNS are + * provided through a previously filled struct ppp_addrs. + * + * If this port connects to a modem, the modem connection must be + * established before calling this. + */ +err_t ppp_listen(ppp_pcb *pcb, struct ppp_addrs *addrs); +#endif /* PPP_SERVER */ + +/* + * Initiate the end of a PPP connection. + * Any outstanding packets in the queues are dropped. + * + * Setting nocarrier to 1 close the PPP connection without initiating the + * shutdown procedure. Always using nocarrier = 0 is still recommended, + * this is going to take a little longer time if your link is down, but + * is a safer choice for the PPP state machine. + * + * Return 0 on success, an error code on failure. + */ +err_t ppp_close(ppp_pcb *pcb, u8_t nocarrier); + +/* + * Release the control block. + * + * This can only be called if PPP is in the dead phase. + * + * You must use ppp_close() before if you wish to terminate + * an established PPP session. + * + * Return 0 on success, an error code on failure. + */ +err_t ppp_free(ppp_pcb *pcb); + +/* + * PPP IOCTL commands. + * + * Get the up status - 0 for down, non-zero for up. The argument must + * point to an int. + */ +#define PPPCTLG_UPSTATUS 0 + +/* + * Get the PPP error code. The argument must point to an int. + * Returns a PPPERR_* value. + */ +#define PPPCTLG_ERRCODE 1 + +/* + * Get the fd associated with a PPP over serial + */ +#define PPPCTLG_FD 2 + +/* + * Get and set parameters for the given connection. + * Return 0 on success, an error code on failure. + */ +err_t ppp_ioctl(ppp_pcb *pcb, u8_t cmd, void *arg); + +/* Get the PPP netif interface */ +#define ppp_netif(ppp) (ppp->netif) + +/* Set an lwIP-style status-callback for the selected PPP device */ +#define ppp_set_netif_statuscallback(ppp, status_cb) \ + netif_set_status_callback(ppp->netif, status_cb); + +/* Set an lwIP-style link-callback for the selected PPP device */ +#define ppp_set_netif_linkcallback(ppp, link_cb) \ + netif_set_link_callback(ppp->netif, link_cb); + +#endif /* PPP_H */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/ppp_impl.h b/components/lwip/include/lwip/netif/ppp/ppp_impl.h new file mode 100755 index 000000000..324f4b058 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/ppp_impl.h @@ -0,0 +1,632 @@ +/***************************************************************************** +* ppp.h - Network Point to Point Protocol header file. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* portions Copyright (c) 1997 Global Election Systems Inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 97-11-05 Guy Lancaster , Global Election Systems Inc. +* Original derived from BSD codes. +*****************************************************************************/ +#ifndef LWIP_HDR_PPP_IMPL_H +#define LWIP_HDR_PPP_IMPL_H + +#include "lwip/opt.h" + +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifdef PPP_INCLUDE_SETTINGS_HEADER +#include "ppp_settings.h" +#endif + +#include /* formats */ +#include +#include +#include /* strtol() */ + +#include "lwip/netif.h" +#include "lwip/def.h" +#include "lwip/timers.h" + +#include "ppp.h" +#include "pppdebug.h" + +/* + * Memory used for control packets. + * + * PPP_CTRL_PBUF_MAX_SIZE is the amount of memory we allocate when we + * cannot figure out how much we are going to use before filling the buffer. + */ +#if PPP_USE_PBUF_RAM +#define PPP_CTRL_PBUF_TYPE PBUF_RAM +#define PPP_CTRL_PBUF_MAX_SIZE 512 +#else /* PPP_USE_PBUF_RAM */ +#define PPP_CTRL_PBUF_TYPE PBUF_POOL +#define PPP_CTRL_PBUF_MAX_SIZE PBUF_POOL_BUFSIZE +#endif /* PPP_USE_PBUF_RAM */ + +/* + * The basic PPP frame. + */ +#define PPP_ADDRESS(p) (((u_char *)(p))[0]) +#define PPP_CONTROL(p) (((u_char *)(p))[1]) +#define PPP_PROTOCOL(p) ((((u_char *)(p))[2] << 8) + ((u_char *)(p))[3]) + +/* + * Significant octet values. + */ +#define PPP_ALLSTATIONS 0xff /* All-Stations broadcast address */ +#define PPP_UI 0x03 /* Unnumbered Information */ +#define PPP_FLAG 0x7e /* Flag Sequence */ +#define PPP_ESCAPE 0x7d /* Asynchronous Control Escape */ +#define PPP_TRANS 0x20 /* Asynchronous transparency modifier */ + +/* + * Protocol field values. + */ +#define PPP_IP 0x21 /* Internet Protocol */ +#if 0 /* UNUSED */ +#define PPP_AT 0x29 /* AppleTalk Protocol */ +#define PPP_IPX 0x2b /* IPX protocol */ +#endif /* UNUSED */ +#if VJ_SUPPORT +#define PPP_VJC_COMP 0x2d /* VJ compressed TCP */ +#define PPP_VJC_UNCOMP 0x2f /* VJ uncompressed TCP */ +#endif /* VJ_SUPPORT */ +#if PPP_IPV6_SUPPORT +#define PPP_IPV6 0x57 /* Internet Protocol Version 6 */ +#endif /* PPP_IPV6_SUPPORT */ +#if CCP_SUPPORT +#define PPP_COMP 0xfd /* compressed packet */ +#endif /* CCP_SUPPORT */ +#define PPP_IPCP 0x8021 /* IP Control Protocol */ +#if 0 /* UNUSED */ +#define PPP_ATCP 0x8029 /* AppleTalk Control Protocol */ +#define PPP_IPXCP 0x802b /* IPX Control Protocol */ +#endif /* UNUSED */ +#if PPP_IPV6_SUPPORT +#define PPP_IPV6CP 0x8057 /* IPv6 Control Protocol */ +#endif /* PPP_IPV6_SUPPORT */ +#if CCP_SUPPORT +#define PPP_CCP 0x80fd /* Compression Control Protocol */ +#endif /* CCP_SUPPORT */ +#if ECP_SUPPORT +#define PPP_ECP 0x8053 /* Encryption Control Protocol */ +#endif /* ECP_SUPPORT */ +#define PPP_LCP 0xc021 /* Link Control Protocol */ +#if PAP_SUPPORT +#define PPP_PAP 0xc023 /* Password Authentication Protocol */ +#endif /* PAP_SUPPORT */ +#if LQR_SUPPORT +#define PPP_LQR 0xc025 /* Link Quality Report protocol */ +#endif /* LQR_SUPPORT */ +#if CHAP_SUPPORT +#define PPP_CHAP 0xc223 /* Cryptographic Handshake Auth. Protocol */ +#endif /* CHAP_SUPPORT */ +#if CBCP_SUPPORT +#define PPP_CBCP 0xc029 /* Callback Control Protocol */ +#endif /* CBCP_SUPPORT */ +#if EAP_SUPPORT +#define PPP_EAP 0xc227 /* Extensible Authentication Protocol */ +#endif /* EAP_SUPPORT */ + +/* + * The following struct gives the addresses of procedures to call + * for a particular lower link level protocol. + */ +struct link_callbacks { + /* Start a connection (e.g. Initiate discovery phase) */ + err_t (*connect) (ppp_pcb *pcb, void *ctx); +#if PPP_SERVER + /* Listen for an incoming connection (Passive mode) */ + err_t (*listen) (ppp_pcb *pcb, void *ctx, struct ppp_addrs *addrs); +#endif /* PPP_SERVER */ + /* End a connection (i.e. initiate disconnect phase) */ + void (*disconnect) (ppp_pcb *pcb, void *ctx); + /* Free lower protocol control block */ + err_t (*free) (ppp_pcb *pcb, void *ctx); + /* Write a pbuf to a ppp link, only used from PPP functions to send PPP packets. */ + err_t (*write)(ppp_pcb *pcb, void *ctx, struct pbuf *p); + /* Send a packet from lwIP core (IPv4 or IPv6) */ + err_t (*netif_output)(ppp_pcb *pcb, void *ctx, struct pbuf *p, u_short protocol); + /* configure the transmit-side characteristics of the PPP interface */ + void (*send_config)(ppp_pcb *pcb, void *ctx, u32_t accm, int pcomp, int accomp); + /* confire the receive-side characteristics of the PPP interface */ + void (*recv_config)(ppp_pcb *pcb, void *ctx, u32_t accm, int pcomp, int accomp); +}; + +/* + * What to do with network protocol (NP) packets. + */ +enum NPmode { + NPMODE_PASS, /* pass the packet through */ + NPMODE_DROP, /* silently drop the packet */ + NPMODE_ERROR, /* return an error */ + NPMODE_QUEUE /* save it up for later. */ +}; + +/* + * Statistics. + */ +#if PPP_STATS_SUPPORT +struct pppstat { + unsigned int ppp_ibytes; /* bytes received */ + unsigned int ppp_ipackets; /* packets received */ + unsigned int ppp_ierrors; /* receive errors */ + unsigned int ppp_obytes; /* bytes sent */ + unsigned int ppp_opackets; /* packets sent */ + unsigned int ppp_oerrors; /* transmit errors */ +}; + +#if VJ_SUPPORT +struct vjstat { + unsigned int vjs_packets; /* outbound packets */ + unsigned int vjs_compressed; /* outbound compressed packets */ + unsigned int vjs_searches; /* searches for connection state */ + unsigned int vjs_misses; /* times couldn't find conn. state */ + unsigned int vjs_uncompressedin; /* inbound uncompressed packets */ + unsigned int vjs_compressedin; /* inbound compressed packets */ + unsigned int vjs_errorin; /* inbound unknown type packets */ + unsigned int vjs_tossed; /* inbound packets tossed because of error */ +}; +#endif /* VJ_SUPPORT */ + +struct ppp_stats { + struct pppstat p; /* basic PPP statistics */ +#if VJ_SUPPORT + struct vjstat vj; /* VJ header compression statistics */ +#endif /* VJ_SUPPORT */ +}; + +#if CCP_SUPPORT +struct compstat { + unsigned int unc_bytes; /* total uncompressed bytes */ + unsigned int unc_packets; /* total uncompressed packets */ + unsigned int comp_bytes; /* compressed bytes */ + unsigned int comp_packets; /* compressed packets */ + unsigned int inc_bytes; /* incompressible bytes */ + unsigned int inc_packets; /* incompressible packets */ + unsigned int ratio; /* recent compression ratio << 8 */ +}; + +struct ppp_comp_stats { + struct compstat c; /* packet compression statistics */ + struct compstat d; /* packet decompression statistics */ +}; +#endif /* CCP_SUPPORT */ + +#endif /* PPP_STATS_SUPPORT */ + +#if PPP_IDLETIMELIMIT +/* + * The following structure records the time in seconds since + * the last NP packet was sent or received. + */ +struct ppp_idle { + time_t xmit_idle; /* time since last NP packet sent */ + time_t recv_idle; /* time since last NP packet received */ +}; +#endif /* PPP_IDLETIMELIMIT */ + +/* values for epdisc.class */ +#define EPD_NULL 0 /* null discriminator, no data */ +#define EPD_LOCAL 1 +#define EPD_IP 2 +#define EPD_MAC 3 +#define EPD_MAGIC 4 +#define EPD_PHONENUM 5 + +/* + * Global variables. + */ +#ifdef HAVE_MULTILINK +extern u8_t multilink; /* enable multilink operation */ +extern u8_t doing_multilink; +extern u8_t multilink_master; +extern u8_t bundle_eof; +extern u8_t bundle_terminating; +#endif + +#ifdef MAXOCTETS +extern unsigned int maxoctets; /* Maximum octetes per session (in bytes) */ +extern int maxoctets_dir; /* Direction : + 0 - in+out (default) + 1 - in + 2 - out + 3 - max(in,out) */ +extern int maxoctets_timeout; /* Timeout for check of octets limit */ +#define PPP_OCTETS_DIRECTION_SUM 0 +#define PPP_OCTETS_DIRECTION_IN 1 +#define PPP_OCTETS_DIRECTION_OUT 2 +#define PPP_OCTETS_DIRECTION_MAXOVERAL 3 +/* same as previos, but little different on RADIUS side */ +#define PPP_OCTETS_DIRECTION_MAXSESSION 4 +#endif + +/* Data input may be used by CCP and ECP, remove this entry + * from struct protent to save some flash + */ +#define PPP_DATAINPUT 0 + +/* + * The following struct gives the addresses of procedures to call + * for a particular protocol. + */ +struct protent { + u_short protocol; /* PPP protocol number */ + /* Initialization procedure */ + void (*init) (ppp_pcb *pcb); + /* Process a received packet */ + void (*input) (ppp_pcb *pcb, u_char *pkt, int len); + /* Process a received protocol-reject */ + void (*protrej) (ppp_pcb *pcb); + /* Lower layer has come up */ + void (*lowerup) (ppp_pcb *pcb); + /* Lower layer has gone down */ + void (*lowerdown) (ppp_pcb *pcb); + /* Open the protocol */ + void (*open) (ppp_pcb *pcb); + /* Close the protocol */ + void (*close) (ppp_pcb *pcb, const char *reason); +#if PRINTPKT_SUPPORT + /* Print a packet in readable form */ + int (*printpkt) (const u_char *pkt, int len, + void (*printer) (void *, const char *, ...), + void *arg); +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + /* Process a received data packet */ + void (*datainput) (ppp_pcb *pcb, u_char *pkt, int len); +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + const char *name; /* Text name of protocol */ + const char *data_name; /* Text name of corresponding data protocol */ +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + option_t *options; /* List of command-line options */ + /* Check requested options, assign defaults */ + void (*check_options) (void); +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + /* Configure interface for demand-dial */ + int (*demand_conf) (int unit); + /* Say whether to bring up link for this pkt */ + int (*active_pkt) (u_char *pkt, int len); +#endif /* DEMAND_SUPPORT */ +}; + +/* Table of pointers to supported protocols */ +extern const struct protent* const protocols[]; + + +/* Values for auth_pending, auth_done */ +#if PAP_SUPPORT +#define PAP_WITHPEER 0x1 +#define PAP_PEER 0x2 +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT +#define CHAP_WITHPEER 0x4 +#define CHAP_PEER 0x8 +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT +#define EAP_WITHPEER 0x10 +#define EAP_PEER 0x20 +#endif /* EAP_SUPPORT */ + +/* Values for auth_done only */ +#if CHAP_SUPPORT +#define CHAP_MD5_WITHPEER 0x40 +#define CHAP_MD5_PEER 0x80 +#if MSCHAP_SUPPORT +#define CHAP_MS_SHIFT 8 /* LSB position for MS auths */ +#define CHAP_MS_WITHPEER 0x100 +#define CHAP_MS_PEER 0x200 +#define CHAP_MS2_WITHPEER 0x400 +#define CHAP_MS2_PEER 0x800 +#endif /* MSCHAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ + +/* Supported CHAP protocols */ +#if CHAP_SUPPORT + +#if MSCHAP_SUPPORT +#define CHAP_MDTYPE_SUPPORTED (MDTYPE_MICROSOFT_V2 | MDTYPE_MICROSOFT | MDTYPE_MD5) +#else /* MSCHAP_SUPPORT */ +#define CHAP_MDTYPE_SUPPORTED (MDTYPE_MD5) +#endif /* MSCHAP_SUPPORT */ + +#else /* CHAP_SUPPORT */ +#define CHAP_MDTYPE_SUPPORTED (MDTYPE_NONE) +#endif /* CHAP_SUPPORT */ + +#if PPP_STATS_SUPPORT +/* + * PPP statistics structure + */ +struct pppd_stats { + unsigned int bytes_in; + unsigned int bytes_out; + unsigned int pkts_in; + unsigned int pkts_out; +}; +#endif /* PPP_STATS_SUPPORT */ + + +/* + * PPP private functions + */ + +/* + * Functions called from lwIP core. + */ + +/* initialize the PPP subsystem */ +int ppp_init(void); + + +/* + * Functions called from PPP link protocols. + */ + +/* Create a new PPP control block */ +ppp_pcb *ppp_new(struct netif *pppif, const struct link_callbacks *callbacks, void *link_ctx_cb, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb); + +/* Set a PPP PCB to its initial state */ +void ppp_clear(ppp_pcb *pcb); + +/* Initiate LCP open request */ +void ppp_start(ppp_pcb *pcb); + +/* Called when link failed to setup */ +void ppp_link_failed(ppp_pcb *pcb); + +/* Called when link is normally down (i.e. it was asked to end) */ +void ppp_link_end(ppp_pcb *pcb); + +/* function called to process input packet */ +void ppp_input(ppp_pcb *pcb, struct pbuf *pb); + +/* helper function, merge a pbuf chain into one pbuf */ +struct pbuf *ppp_singlebuf(struct pbuf *p); + + +/* + * Functions called by PPP protocols. + */ + +/* function called by all PPP subsystems to send packets */ +err_t ppp_write(ppp_pcb *pcb, struct pbuf *p); + +/* functions called by auth.c link_terminated() */ +void ppp_link_terminated(ppp_pcb *pcb); + +void new_phase(ppp_pcb *pcb, int p); + +int ppp_send_config(ppp_pcb *pcb, int mtu, u32_t accm, int pcomp, int accomp); +int ppp_recv_config(ppp_pcb *pcb, int mru, u32_t accm, int pcomp, int accomp); + +#if PPP_IPV4_SUPPORT +int sifaddr(ppp_pcb *pcb, u32_t our_adr, u32_t his_adr, u32_t netmask); +int cifaddr(ppp_pcb *pcb, u32_t our_adr, u32_t his_adr); +#if 0 /* UNUSED - PROXY ARP */ +int sifproxyarp(ppp_pcb *pcb, u32_t his_adr); +int cifproxyarp(ppp_pcb *pcb, u32_t his_adr); +#endif /* UNUSED - PROXY ARP */ +#if LWIP_DNS +int sdns(ppp_pcb *pcb, u32_t ns1, u32_t ns2); +int cdns(ppp_pcb *pcb, u32_t ns1, u32_t ns2); +#endif /* LWIP_DNS */ +#if VJ_SUPPORT +int sifvjcomp(ppp_pcb *pcb, int vjcomp, int cidcomp, int maxcid); +#endif /* VJ_SUPPORT */ +int sifup(ppp_pcb *pcb); +int sifdown (ppp_pcb *pcb); +u32_t get_mask(u32_t addr); +#endif /* PPP_IPV4_SUPPORT */ + +#if PPP_IPV6_SUPPORT +int sif6addr(ppp_pcb *pcb, eui64_t our_eui64, eui64_t his_eui64); +int cif6addr(ppp_pcb *pcb, eui64_t our_eui64, eui64_t his_eui64); +int sif6up(ppp_pcb *pcb); +int sif6down (ppp_pcb *pcb); +#endif /* PPP_IPV6_SUPPORT */ + +#if DEMAND_SUPPORT +int sifnpmode(ppp_pcb *pcb, int proto, enum NPmode mode); +#endif /* DEMAND_SUPPORt */ + +void netif_set_mtu(ppp_pcb *pcb, int mtu); +int netif_get_mtu(ppp_pcb *pcb); + +#if CCP_SUPPORT +#if 0 /* unused */ +int ccp_test(ppp_pcb *pcb, u_char *opt_ptr, int opt_len, int for_transmit); +#endif /* unused */ +void ccp_set(ppp_pcb *pcb, u8_t isopen, u8_t isup, u8_t receive_method, u8_t transmit_method); +void ccp_reset_comp(ppp_pcb *pcb); +void ccp_reset_decomp(ppp_pcb *pcb); +#if 0 /* unused */ +int ccp_fatal_error(ppp_pcb *pcb); +#endif /* unused */ +#endif /* CCP_SUPPORT */ + +#if PPP_IDLETIMELIMIT +int get_idle_time(ppp_pcb *pcb, struct ppp_idle *ip); +#endif /* PPP_IDLETIMELIMIT */ + +#if DEMAND_SUPPORT +int get_loop_output(void); +#endif /* DEMAND_SUPPORT */ + +/* Optional protocol names list, to make our messages a little more informative. */ +#if PPP_PROTOCOLNAME +const char * protocol_name(int proto); +#endif /* PPP_PROTOCOLNAME */ + +/* Optional stats support, to get some statistics on the PPP interface */ +#if PPP_STATS_SUPPORT +void print_link_stats(void); /* Print stats, if available */ +void reset_link_stats(int u); /* Reset (init) stats when link goes up */ +void update_link_stats(int u); /* Get stats at link termination */ +#endif /* PPP_STATS_SUPPORT */ + + + +/* + * Inline versions of get/put char/short/long. + * Pointer is advanced; we assume that both arguments + * are lvalues and will already be in registers. + * cp MUST be u_char *. + */ +#define GETCHAR(c, cp) { \ + (c) = *(cp)++; \ +} +#define PUTCHAR(c, cp) { \ + *(cp)++ = (u_char) (c); \ +} +#define GETSHORT(s, cp) { \ + (s) = *(cp)++ << 8; \ + (s) |= *(cp)++; \ +} +#define PUTSHORT(s, cp) { \ + *(cp)++ = (u_char) ((s) >> 8); \ + *(cp)++ = (u_char) (s); \ +} +#define GETLONG(l, cp) { \ + (l) = *(cp)++ << 8; \ + (l) |= *(cp)++; (l) <<= 8; \ + (l) |= *(cp)++; (l) <<= 8; \ + (l) |= *(cp)++; \ +} +#define PUTLONG(l, cp) { \ + *(cp)++ = (u_char) ((l) >> 24); \ + *(cp)++ = (u_char) ((l) >> 16); \ + *(cp)++ = (u_char) ((l) >> 8); \ + *(cp)++ = (u_char) (l); \ +} + +#define INCPTR(n, cp) ((cp) += (n)) +#define DECPTR(n, cp) ((cp) -= (n)) + +/* + * System dependent definitions for user-level 4.3BSD UNIX implementation. + */ +#define TIMEOUT(f, a, t) do { sys_untimeout((f), (a)); sys_timeout((t)*1000, (f), (a)); } while(0) +#define TIMEOUTMS(f, a, t) do { sys_untimeout((f), (a)); sys_timeout((t), (f), (a)); } while(0) +#define UNTIMEOUT(f, a) sys_untimeout((f), (a)) + +#define BZERO(s, n) memset(s, 0, n) +#define BCMP(s1, s2, l) memcmp(s1, s2, l) + +#define PRINTMSG(m, l) { ppp_info("Remote message: %0.*v", l, m); } + +/* + * MAKEHEADER - Add Header fields to a packet. + */ +#define MAKEHEADER(p, t) { \ + PUTCHAR(PPP_ALLSTATIONS, p); \ + PUTCHAR(PPP_UI, p); \ + PUTSHORT(t, p); } + +/* Procedures exported from auth.c */ +void link_required(ppp_pcb *pcb); /* we are starting to use the link */ +void link_terminated(ppp_pcb *pcb); /* we are finished with the link */ +void link_down(ppp_pcb *pcb); /* the LCP layer has left the Opened state */ +void upper_layers_down(ppp_pcb *pcb); /* take all NCPs down */ +void link_established(ppp_pcb *pcb); /* the link is up; authenticate now */ +void start_networks(ppp_pcb *pcb); /* start all the network control protos */ +void continue_networks(ppp_pcb *pcb); /* start network [ip, etc] control protos */ +#if PPP_AUTH_SUPPORT +#if PPP_SERVER +int auth_check_passwd(ppp_pcb *pcb, char *auser, int userlen, char *apasswd, int passwdlen, const char **msg, int *msglen); + /* check the user name and passwd against configuration */ +void auth_peer_fail(ppp_pcb *pcb, int protocol); + /* peer failed to authenticate itself */ +void auth_peer_success(ppp_pcb *pcb, int protocol, int prot_flavor, const char *name, int namelen); + /* peer successfully authenticated itself */ +#endif /* PPP_SERVER */ +void auth_withpeer_fail(ppp_pcb *pcb, int protocol); + /* we failed to authenticate ourselves */ +void auth_withpeer_success(ppp_pcb *pcb, int protocol, int prot_flavor); + /* we successfully authenticated ourselves */ +#endif /* PPP_AUTH_SUPPORT */ +void np_up(ppp_pcb *pcb, int proto); /* a network protocol has come up */ +void np_down(ppp_pcb *pcb, int proto); /* a network protocol has gone down */ +void np_finished(ppp_pcb *pcb, int proto); /* a network protocol no longer needs link */ +#if PPP_AUTH_SUPPORT +int get_secret(ppp_pcb *pcb, const char *client, const char *server, char *secret, int *secret_len, int am_server); + /* get "secret" for chap */ +#endif /* PPP_AUTH_SUPPORT */ + +/* Procedures exported from ipcp.c */ +/* int parse_dotted_ip (char *, u32_t *); */ + +/* Procedures exported from demand.c */ +#if DEMAND_SUPPORT +void demand_conf (void); /* config interface(s) for demand-dial */ +void demand_block (void); /* set all NPs to queue up packets */ +void demand_unblock (void); /* set all NPs to pass packets */ +void demand_discard (void); /* set all NPs to discard packets */ +void demand_rexmit (int, u32_t); /* retransmit saved frames for an NP*/ +int loop_chars (unsigned char *, int); /* process chars from loopback */ +int loop_frame (unsigned char *, int); /* should we bring link up? */ +#endif /* DEMAND_SUPPORT */ + +/* Procedures exported from multilink.c */ +#ifdef HAVE_MULTILINK +void mp_check_options (void); /* Check multilink-related options */ +int mp_join_bundle (void); /* join our link to an appropriate bundle */ +void mp_exit_bundle (void); /* have disconnected our link from bundle */ +void mp_bundle_terminated (void); +char *epdisc_to_str (struct epdisc *); /* string from endpoint discrim. */ +int str_to_epdisc (struct epdisc *, char *); /* endpt disc. from str */ +#else +#define mp_bundle_terminated() /* nothing */ +#define mp_exit_bundle() /* nothing */ +#define doing_multilink 0 +#define multilink_master 0 +#endif + +/* Procedures exported from utils.c. */ +void ppp_print_string(const u_char *p, int len, void (*printer) (void *, const char *, ...), void *arg); /* Format a string for output */ +int ppp_slprintf(char *buf, int buflen, const char *fmt, ...); /* sprintf++ */ +int ppp_vslprintf(char *buf, int buflen, const char *fmt, va_list args); /* vsprintf++ */ +size_t ppp_strlcpy(char *dest, const char *src, size_t len); /* safe strcpy */ +size_t ppp_strlcat(char *dest, const char *src, size_t len); /* safe strncpy */ +void ppp_dbglog(const char *fmt, ...); /* log a debug message */ +void ppp_info(const char *fmt, ...); /* log an informational message */ +void ppp_notice(const char *fmt, ...); /* log a notice-level message */ +void ppp_warn(const char *fmt, ...); /* log a warning message */ +void ppp_error(const char *fmt, ...); /* log an error message */ +void ppp_fatal(const char *fmt, ...); /* log an error message and die(1) */ +#if PRINTPKT_SUPPORT +void ppp_dump_packet(const char *tag, unsigned char *p, int len); + /* dump packet to debug log if interesting */ +#endif /* PRINTPKT_SUPPORT */ + + +#endif /* PPP_SUPPORT */ +#endif /* LWIP_HDR_PPP_IMPL_H */ diff --git a/components/lwip/include/lwip/netif/ppp/pppcrypt.h b/components/lwip/include/lwip/netif/ppp/pppcrypt.h new file mode 100755 index 000000000..ef2e87de1 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/pppcrypt.h @@ -0,0 +1,43 @@ +/* + * pppcrypt.c - PPP/DES linkage for MS-CHAP and EAP SRP-SHA1 + * + * Extracted from chap_ms.c by James Carlson. + * + * Copyright (c) 1995 Eric Rosenquist. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MSCHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPPCRYPT_H +#define PPPCRYPT_H + +void pppcrypt_56_to_64_bit_key(u_char *key, u_char *des_key); + +#endif /* PPPCRYPT_H */ + +#endif /* PPP_SUPPORT && MSCHAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/pppdebug.h b/components/lwip/include/lwip/netif/ppp/pppdebug.h new file mode 100755 index 000000000..e35c8e090 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/pppdebug.h @@ -0,0 +1,80 @@ +/***************************************************************************** +* pppdebug.h - System debugging utilities. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* portions Copyright (c) 1998 Global Election Systems Inc. +* portions Copyright (c) 2001 by Cognizant Pty Ltd. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY (please don't use tabs!) +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 98-07-29 Guy Lancaster , Global Election Systems Inc. +* Original. +* +***************************************************************************** +*/ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPPDEBUG_H +#define PPPDEBUG_H + +/* Trace levels. */ +#define LOG_CRITICAL (PPP_DEBUG | LWIP_DBG_LEVEL_SEVERE) +#define LOG_ERR (PPP_DEBUG | LWIP_DBG_LEVEL_SEVERE) +#define LOG_NOTICE (PPP_DEBUG | LWIP_DBG_LEVEL_WARNING) +#define LOG_WARNING (PPP_DEBUG | LWIP_DBG_LEVEL_WARNING) +#define LOG_INFO (PPP_DEBUG) +#define LOG_DETAIL (PPP_DEBUG) +#define LOG_DEBUG (PPP_DEBUG) + +#if PPP_DEBUG + +#define MAINDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define SYSDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define FSMDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define LCPDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define IPCPDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define IPV6CPDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define UPAPDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define CHAPDEBUG(a) LWIP_DEBUGF(LWIP_DBG_LEVEL_WARNING, a) +#define PPPDEBUG(a, b) LWIP_DEBUGF(a, b) + +#else /* PPP_DEBUG */ + +#define MAINDEBUG(a) +#define SYSDEBUG(a) +#define FSMDEBUG(a) +#define LCPDEBUG(a) +#define IPCPDEBUG(a) +#define IPV6CPDEBUG(a) +#define UPAPDEBUG(a) +#define CHAPDEBUG(a) +#define PPPDEBUG(a, b) + +#endif /* PPP_DEBUG */ + +#endif /* PPPDEBUG_H */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/pppoe.h b/components/lwip/include/lwip/netif/ppp/pppoe.h new file mode 100755 index 000000000..b1dd2fd9c --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/pppoe.h @@ -0,0 +1,179 @@ +/***************************************************************************** +* pppoe.h - PPP Over Ethernet implementation for lwIP. +* +* Copyright (c) 2006 by Marc Boucher, Services Informatiques (MBSI) inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 06-01-01 Marc Boucher +* Ported to lwIP. +*****************************************************************************/ + + + +/* based on NetBSD: if_pppoe.c,v 1.64 2006/01/31 23:50:15 martin Exp */ + +/*- + * Copyright (c) 2002 The NetBSD Foundation, Inc. + * All rights reserved. + * + * This code is derived from software contributed to The NetBSD Foundation + * by Martin Husemann . + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the NetBSD + * Foundation, Inc. and its contributors. + * 4. Neither the name of The NetBSD Foundation nor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS + * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS + * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOE_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPP_OE_H +#define PPP_OE_H + +#include "ppp.h" +#include "netif/etharp.h" + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct pppoehdr { + PACK_STRUCT_FLD_8(u8_t vertype); + PACK_STRUCT_FLD_8(u8_t code); + PACK_STRUCT_FIELD(u16_t session); + PACK_STRUCT_FIELD(u16_t plen); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct pppoetag { + PACK_STRUCT_FIELD(u16_t tag); + PACK_STRUCT_FIELD(u16_t len); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif + + +#define PPPOE_STATE_INITIAL 0 +#define PPPOE_STATE_PADI_SENT 1 +#define PPPOE_STATE_PADR_SENT 2 +#define PPPOE_STATE_SESSION 3 +/* passive */ +#define PPPOE_STATE_PADO_SENT 1 + +#define PPPOE_HEADERLEN sizeof(struct pppoehdr) +#define PPPOE_VERTYPE 0x11 /* VER=1, TYPE = 1 */ + +#define PPPOE_TAG_EOL 0x0000 /* end of list */ +#define PPPOE_TAG_SNAME 0x0101 /* service name */ +#define PPPOE_TAG_ACNAME 0x0102 /* access concentrator name */ +#define PPPOE_TAG_HUNIQUE 0x0103 /* host unique */ +#define PPPOE_TAG_ACCOOKIE 0x0104 /* AC cookie */ +#define PPPOE_TAG_VENDOR 0x0105 /* vendor specific */ +#define PPPOE_TAG_RELAYSID 0x0110 /* relay session id */ +#define PPPOE_TAG_SNAME_ERR 0x0201 /* service name error */ +#define PPPOE_TAG_ACSYS_ERR 0x0202 /* AC system error */ +#define PPPOE_TAG_GENERIC_ERR 0x0203 /* gerneric error */ + +#define PPPOE_CODE_PADI 0x09 /* Active Discovery Initiation */ +#define PPPOE_CODE_PADO 0x07 /* Active Discovery Offer */ +#define PPPOE_CODE_PADR 0x19 /* Active Discovery Request */ +#define PPPOE_CODE_PADS 0x65 /* Active Discovery Session confirmation */ +#define PPPOE_CODE_PADT 0xA7 /* Active Discovery Terminate */ + +#ifndef PPPOE_MAX_AC_COOKIE_LEN +#define PPPOE_MAX_AC_COOKIE_LEN 64 +#endif + +struct pppoe_softc { + struct pppoe_softc *next; + struct netif *sc_ethif; /* ethernet interface we are using */ + ppp_pcb *pcb; /* PPP PCB */ + + struct eth_addr sc_dest; /* hardware address of concentrator */ + u16_t sc_session; /* PPPoE session id */ + u8_t sc_state; /* discovery phase or session connected */ + +#ifdef PPPOE_TODO + u8_t *sc_service_name; /* if != NULL: requested name of service */ + u8_t *sc_concentrator_name; /* if != NULL: requested concentrator id */ +#endif /* PPPOE_TODO */ + u8_t sc_ac_cookie[PPPOE_MAX_AC_COOKIE_LEN]; /* content of AC cookie we must echo back */ + u8_t sc_ac_cookie_len; /* length of cookie data */ +#ifdef PPPOE_SERVER + u8_t *sc_hunique; /* content of host unique we must echo back */ + u8_t sc_hunique_len; /* length of host unique */ +#endif + u8_t sc_padi_retried; /* number of PADI retries already done */ + u8_t sc_padr_retried; /* number of PADR retries already done */ +}; + + +#define pppoe_init() /* compatibility define, no initialization needed */ + +ppp_pcb *pppoe_create(struct netif *pppif, + struct netif *ethif, + const char *service_name, const char *concentrator_name, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb); + +/* + * Functions called from lwIP + * DO NOT CALL FROM lwIP USER APPLICATION. + */ +void pppoe_disc_input(struct netif *netif, struct pbuf *p); +void pppoe_data_input(struct netif *netif, struct pbuf *p); + +#endif /* PPP_OE_H */ + +#endif /* PPP_SUPPORT && PPPOE_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/pppol2tp.h b/components/lwip/include/lwip/netif/ppp/pppol2tp.h new file mode 100755 index 000000000..097b4d189 --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/pppol2tp.h @@ -0,0 +1,201 @@ +/** + * @file + * Network Point to Point Protocol over Layer 2 Tunneling Protocol header file. + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOL2TP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPPOL2TP_H_ +#define PPPOL2TP_H_ + +#include "ppp.h" + +/* Timeout */ +#define PPPOL2TP_CONTROL_TIMEOUT (5*1000) /* base for quick timeout calculation */ +#define PPPOL2TP_SLOW_RETRY (60*1000) /* persistent retry interval */ + +#define PPPOL2TP_MAXSCCRQ 4 /* retry SCCRQ four times (quickly) */ +#define PPPOL2TP_MAXICRQ 4 /* retry IRCQ four times */ +#define PPPOL2TP_MAXICCN 4 /* retry ICCN four times */ + +/* L2TP header flags */ +#define PPPOL2TP_HEADERFLAG_CONTROL 0x8000 +#define PPPOL2TP_HEADERFLAG_LENGTH 0x4000 +#define PPPOL2TP_HEADERFLAG_SEQUENCE 0x0800 +#define PPPOL2TP_HEADERFLAG_OFFSET 0x0200 +#define PPPOL2TP_HEADERFLAG_PRIORITY 0x0100 +#define PPPOL2TP_HEADERFLAG_VERSION 0x0002 + +/* Mandatory bits for control: Control, Length, Sequence, Version 2 */ +#define PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY (PPPOL2TP_HEADERFLAG_CONTROL|PPPOL2TP_HEADERFLAG_LENGTH|PPPOL2TP_HEADERFLAG_SEQUENCE|PPPOL2TP_HEADERFLAG_VERSION) +/* Forbidden bits for control: Offset, Priority */ +#define PPPOL2TP_HEADERFLAG_CONTROL_FORBIDDEN (PPPOL2TP_HEADERFLAG_OFFSET|PPPOL2TP_HEADERFLAG_PRIORITY) + +/* Mandatory bits for data: Version 2 */ +#define PPPOL2TP_HEADERFLAG_DATA_MANDATORY (PPPOL2TP_HEADERFLAG_VERSION) + +/* AVP (Attribute Value Pair) header */ +#define PPPOL2TP_AVPHEADERFLAG_MANDATORY 0x8000 +#define PPPOL2TP_AVPHEADERFLAG_HIDDEN 0x4000 +#define PPPOL2TP_AVPHEADERFLAG_LENGTHMASK 0x03ff + +/* -- AVP - Message type */ +#define PPPOL2TP_AVPTYPE_MESSAGE 0 /* Message type */ + +/* Control Connection Management */ +#define PPPOL2TP_MESSAGETYPE_SCCRQ 1 /* Start Control Connection Request */ +#define PPPOL2TP_MESSAGETYPE_SCCRP 2 /* Start Control Connection Reply */ +#define PPPOL2TP_MESSAGETYPE_SCCCN 3 /* Start Control Connection Connected */ +#define PPPOL2TP_MESSAGETYPE_STOPCCN 4 /* Stop Control Connection Notification */ +#define PPPOL2TP_MESSAGETYPE_HELLO 6 /* Hello */ +/* Call Management */ +#define PPPOL2TP_MESSAGETYPE_OCRQ 7 /* Outgoing Call Request */ +#define PPPOL2TP_MESSAGETYPE_OCRP 8 /* Outgoing Call Reply */ +#define PPPOL2TP_MESSAGETYPE_OCCN 9 /* Outgoing Call Connected */ +#define PPPOL2TP_MESSAGETYPE_ICRQ 10 /* Incoming Call Request */ +#define PPPOL2TP_MESSAGETYPE_ICRP 11 /* Incoming Call Reply */ +#define PPPOL2TP_MESSAGETYPE_ICCN 12 /* Incoming Call Connected */ +#define PPPOL2TP_MESSAGETYPE_CDN 14 /* Call Disconnect Notify */ +/* Error reporting */ +#define PPPOL2TP_MESSAGETYPE_WEN 15 /* WAN Error Notify */ +/* PPP Session Control */ +#define PPPOL2TP_MESSAGETYPE_SLI 16 /* Set Link Info */ + +/* -- AVP - Result code */ +#define PPPOL2TP_AVPTYPE_RESULTCODE 1 /* Result code */ +#define PPPOL2TP_RESULTCODE 1 /* General request to clear control connection */ + +/* -- AVP - Protocol version (!= L2TP Header version) */ +#define PPPOL2TP_AVPTYPE_VERSION 2 +#define PPPOL2TP_VERSION 0x0100 /* L2TP Protocol version 1, revision 0 */ + +/* -- AVP - Framing capabilities */ +#define PPPOL2TP_AVPTYPE_FRAMINGCAPABILITIES 3 /* Bearer capabilities */ +#define PPPOL2TP_FRAMINGCAPABILITIES 0x00000003 /* Async + Sync framing */ + +/* -- AVP - Bearer capabilities */ +#define PPPOL2TP_AVPTYPE_BEARERCAPABILITIES 4 /* Bearer capabilities */ +#define PPPOL2TP_BEARERCAPABILITIES 0x00000003 /* Analog + Digital Access */ + +/* -- AVP - Tie breaker */ +#define PPPOL2TP_AVPTYPE_TIEBREAKER 5 + +/* -- AVP - Host name */ +#define PPPOL2TP_AVPTYPE_HOSTNAME 7 /* Host name */ +#define PPPOL2TP_HOSTNAME "lwIP" /* FIXME: make it configurable */ + +/* -- AVP - Vendor name */ +#define PPPOL2TP_AVPTYPE_VENDORNAME 8 /* Vendor name */ +#define PPPOL2TP_VENDORNAME "lwIP" /* FIXME: make it configurable */ + +/* -- AVP - Assign tunnel ID */ +#define PPPOL2TP_AVPTYPE_TUNNELID 9 /* Assign Tunnel ID */ + +/* -- AVP - Receive window size */ +#define PPPOL2TP_AVPTYPE_RECEIVEWINDOWSIZE 10 /* Receive window size */ +#define PPPOL2TP_RECEIVEWINDOWSIZE 8 /* FIXME: make it configurable */ + +/* -- AVP - Challenge */ +#define PPPOL2TP_AVPTYPE_CHALLENGE 11 /* Challenge */ + +/* -- AVP - Cause code */ +#define PPPOL2TP_AVPTYPE_CAUSECODE 12 /* Cause code*/ + +/* -- AVP - Challenge response */ +#define PPPOL2TP_AVPTYPE_CHALLENGERESPONSE 13 /* Challenge response */ +#define PPPOL2TP_AVPTYPE_CHALLENGERESPONSE_SIZE 16 + +/* -- AVP - Assign session ID */ +#define PPPOL2TP_AVPTYPE_SESSIONID 14 /* Assign Session ID */ + +/* -- AVP - Call serial number */ +#define PPPOL2TP_AVPTYPE_CALLSERIALNUMBER 15 /* Call Serial Number */ + +/* -- AVP - Framing type */ +#define PPPOL2TP_AVPTYPE_FRAMINGTYPE 19 /* Framing Type */ +#define PPPOL2TP_FRAMINGTYPE 0x00000001 /* Sync framing */ + +/* -- AVP - TX Connect Speed */ +#define PPPOL2TP_AVPTYPE_TXCONNECTSPEED 24 /* TX Connect Speed */ +#define PPPOL2TP_TXCONNECTSPEED 100000000 /* Connect speed: 100 Mbits/s */ + +/* L2TP Session state */ +#define PPPOL2TP_STATE_INITIAL 0 +#define PPPOL2TP_STATE_SCCRQ_SENT 1 +#define PPPOL2TP_STATE_ICRQ_SENT 2 +#define PPPOL2TP_STATE_ICCN_SENT 3 +#define PPPOL2TP_STATE_DATA 4 + +#define PPPOL2TP_OUTPUT_DATA_HEADER_LEN 6 /* Our data header len */ + +/* + * PPPoL2TP interface control block. + */ +typedef struct pppol2tp_pcb_s pppol2tp_pcb; +struct pppol2tp_pcb_s { + ppp_pcb *ppp; /* PPP PCB */ + u8_t phase; /* L2TP phase */ + struct udp_pcb *udp; /* UDP L2TP Socket */ + struct netif *netif; /* Output interface, used as a default route */ + ip_addr_t remote_ip; /* LNS IP Address */ + u16_t remote_port; /* LNS port */ +#if PPPOL2TP_AUTH_SUPPORT + const u8_t *secret; /* Secret string */ + u8_t secret_len; /* Secret string length */ + u8_t secret_rv[16]; /* Random vector */ + u8_t challenge_hash[16]; /* Challenge response */ + u8_t send_challenge; /* Boolean whether the next sent packet should contains a challenge response */ +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + u16_t tunnel_port; /* Tunnel port */ + u16_t our_ns; /* NS to peer */ + u16_t peer_nr; /* NR from peer */ + u16_t peer_ns; /* NS from peer */ + u16_t source_tunnel_id; /* Tunnel ID assigned by peer */ + u16_t remote_tunnel_id; /* Tunnel ID assigned to peer */ + u16_t source_session_id; /* Session ID assigned by peer */ + u16_t remote_session_id; /* Session ID assigned to peer */ + + u8_t sccrq_retried; /* number of SCCRQ retries already done */ + u8_t icrq_retried; /* number of ICRQ retries already done */ + u8_t iccn_retried; /* number of ICCN retries already done */ +}; + + +/* Create a new L2TP session. */ +ppp_pcb *pppol2tp_create(struct netif *pppif, + struct netif *netif, ip_addr_t *ipaddr, u16_t port, + const u8_t *secret, u8_t secret_len, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb); + +#endif /* PPPOL2TP_H_ */ +#endif /* PPP_SUPPORT && PPPOL2TP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/pppos.h b/components/lwip/include/lwip/netif/ppp/pppos.h new file mode 100755 index 000000000..39b2b7d0c --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/pppos.h @@ -0,0 +1,119 @@ +/** + * @file + * Network Point to Point Protocol over Serial header file. + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOS_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef PPPOS_H +#define PPPOS_H + +#include "lwip/sys.h" +#include "lwip/sio.h" + +#include "ppp.h" +#include "vj.h" + +/* PPP packet parser states. Current state indicates operation yet to be + * completed. */ +enum { + PDIDLE = 0, /* Idle state - waiting. */ + PDSTART, /* Process start flag. */ + PDADDRESS, /* Process address field. */ + PDCONTROL, /* Process control field. */ + PDPROTOCOL1, /* Process protocol field 1. */ + PDPROTOCOL2, /* Process protocol field 2. */ + PDDATA /* Process data byte. */ +}; + +/* PPPoS serial output callback function prototype */ +typedef u32_t (*pppos_output_cb_fn)(ppp_pcb *pcb, u8_t *data, u32_t len, void *ctx); + +/* + * Extended asyncmap - allows any character to be escaped. + */ +typedef u8_t ext_accm[32]; + +/* + * PPPoS interface control block. + */ +typedef struct pppos_pcb_s pppos_pcb; +struct pppos_pcb_s { + /* -- below are data that will NOT be cleared between two sessions */ + ppp_pcb *ppp; /* PPP PCB */ + pppos_output_cb_fn output_cb; /* PPP serial output callback */ + + /* -- below are data that will be cleared between two sessions + * + * last_xmit must be the first member of cleared members, because it is + * used to know which part must not be cleared. + */ + u32_t last_xmit; /* Time of last transmission. */ + ext_accm out_accm; /* Async-Ctl-Char-Map for output. */ + + /* flags */ + unsigned int open :1; /* Set if PPPoS is open */ + unsigned int pcomp :1; /* Does peer accept protocol compression? */ + unsigned int accomp :1; /* Does peer accept addr/ctl compression? */ + + /* PPPoS rx */ + ext_accm in_accm; /* Async-Ctl-Char-Map for input. */ + struct pbuf *in_head, *in_tail; /* The input packet. */ + u16_t in_protocol; /* The input protocol code. */ + u16_t in_fcs; /* Input Frame Check Sequence value. */ + u8_t in_state; /* The input process state. */ + u8_t in_escaped; /* Escape next character. */ +}; + +/* Create a new PPPoS session. */ +ppp_pcb *pppos_create(struct netif *pppif, pppos_output_cb_fn output_cb, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb); + +#if !NO_SYS && !PPP_INPROC_IRQ_SAFE +/* Pass received raw characters to PPPoS to be decoded through lwIP TCPIP thread. */ +err_t pppos_input_tcpip(ppp_pcb *ppp, u8_t *s, int l); +#endif /* !NO_SYS && !PPP_INPROC_IRQ_SAFE */ + +/* PPP over Serial: this is the input function to be called for received data. */ +void pppos_input(ppp_pcb *ppp, u8_t* data, int len); + + +/* + * Functions called from lwIP + * DO NOT CALL FROM lwIP USER APPLICATION. + */ +#if !NO_SYS && !PPP_INPROC_IRQ_SAFE +err_t pppos_input_sys(struct pbuf *p, struct netif *inp); +#endif /* !NO_SYS && !PPP_INPROC_IRQ_SAFE */ + +#endif /* PPPOS_H */ +#endif /* PPP_SUPPORT && PPPOL2TP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/upap.h b/components/lwip/include/lwip/netif/ppp/upap.h new file mode 100755 index 000000000..bb9309bdb --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/upap.h @@ -0,0 +1,123 @@ +/* + * upap.h - User/Password Authentication Protocol definitions. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: upap.h,v 1.8 2002/12/04 23:03:33 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef UPAP_H +#define UPAP_H + +#include "ppp.h" + +/* + * Packet header = Code, id, length. + */ +#define UPAP_HEADERLEN 4 + + +/* + * UPAP codes. + */ +#define UPAP_AUTHREQ 1 /* Authenticate-Request */ +#define UPAP_AUTHACK 2 /* Authenticate-Ack */ +#define UPAP_AUTHNAK 3 /* Authenticate-Nak */ + + +/* + * Client states. + */ +#define UPAPCS_INITIAL 0 /* Connection down */ +#define UPAPCS_CLOSED 1 /* Connection up, haven't requested auth */ +#define UPAPCS_PENDING 2 /* Connection down, have requested auth */ +#define UPAPCS_AUTHREQ 3 /* We've sent an Authenticate-Request */ +#define UPAPCS_OPEN 4 /* We've received an Ack */ +#define UPAPCS_BADAUTH 5 /* We've received a Nak */ + +/* + * Server states. + */ +#define UPAPSS_INITIAL 0 /* Connection down */ +#define UPAPSS_CLOSED 1 /* Connection up, haven't requested auth */ +#define UPAPSS_PENDING 2 /* Connection down, have requested auth */ +#define UPAPSS_LISTEN 3 /* Listening for an Authenticate */ +#define UPAPSS_OPEN 4 /* We've sent an Ack */ +#define UPAPSS_BADAUTH 5 /* We've sent a Nak */ + + +/* + * Timeouts. + */ +#if 0 /* moved to opt.h */ +#define UPAP_DEFTIMEOUT 3 /* Timeout (seconds) for retransmitting req */ +#define UPAP_DEFREQTIME 30 /* Time to wait for auth-req from peer */ +#endif /* moved to opt.h */ + +/* + * Each interface is described by upap structure. + */ +#if PAP_SUPPORT +typedef struct upap_state { + const char *us_user; /* User */ + u8_t us_userlen; /* User length */ + const char *us_passwd; /* Password */ + u8_t us_passwdlen; /* Password length */ + u8_t us_clientstate; /* Client state */ +#if PPP_SERVER + u8_t us_serverstate; /* Server state */ +#endif /* PPP_SERVER */ + u8_t us_id; /* Current id */ + u8_t us_transmits; /* Number of auth-reqs sent */ +} upap_state; +#endif /* PAP_SUPPORT */ + + +void upap_authwithpeer(ppp_pcb *pcb, const char *user, const char *password); +#if PPP_SERVER +void upap_authpeer(ppp_pcb *pcb); +#endif /* PPP_SERVER */ + +extern const struct protent pap_protent; + +#endif /* UPAP_H */ +#endif /* PPP_SUPPORT && PAP_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/ppp/vj.h b/components/lwip/include/lwip/netif/ppp/vj.h new file mode 100755 index 000000000..f2e1f8b4b --- /dev/null +++ b/components/lwip/include/lwip/netif/ppp/vj.h @@ -0,0 +1,161 @@ +/* + * Definitions for tcp compression routines. + * + * $Id: vj.h,v 1.7 2010/02/22 17:52:09 goldsimon Exp $ + * + * Copyright (c) 1989 Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by the University of California, Berkeley. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. + * + * Van Jacobson (van@helios.ee.lbl.gov), Dec 31, 1989: + * - Initial distribution. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && VJ_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#ifndef VJ_H +#define VJ_H + +#include "lwip/ip.h" +#include "lwip/priv/tcp_priv.h" + +#define MAX_SLOTS 16 /* must be > 2 and < 256 */ +#define MAX_HDR 128 + +/* + * Compressed packet format: + * + * The first octet contains the packet type (top 3 bits), TCP + * 'push' bit, and flags that indicate which of the 4 TCP sequence + * numbers have changed (bottom 5 bits). The next octet is a + * conversation number that associates a saved IP/TCP header with + * the compressed packet. The next two octets are the TCP checksum + * from the original datagram. The next 0 to 15 octets are + * sequence number changes, one change per bit set in the header + * (there may be no changes and there are two special cases where + * the receiver implicitly knows what changed -- see below). + * + * There are 5 numbers which can change (they are always inserted + * in the following order): TCP urgent pointer, window, + * acknowlegement, sequence number and IP ID. (The urgent pointer + * is different from the others in that its value is sent, not the + * change in value.) Since typical use of SLIP links is biased + * toward small packets (see comments on MTU/MSS below), changes + * use a variable length coding with one octet for numbers in the + * range 1 - 255 and 3 octets (0, MSB, LSB) for numbers in the + * range 256 - 65535 or 0. (If the change in sequence number or + * ack is more than 65535, an uncompressed packet is sent.) + */ + +/* + * Packet types (must not conflict with IP protocol version) + * + * The top nibble of the first octet is the packet type. There are + * three possible types: IP (not proto TCP or tcp with one of the + * control flags set); uncompressed TCP (a normal IP/TCP packet but + * with the 8-bit protocol field replaced by an 8-bit connection id -- + * this type of packet syncs the sender & receiver); and compressed + * TCP (described above). + * + * LSB of 4-bit field is TCP "PUSH" bit (a worthless anachronism) and + * is logically part of the 4-bit "changes" field that follows. Top + * three bits are actual packet type. For backward compatibility + * and in the interest of conserving bits, numbers are chosen so the + * IP protocol version number (4) which normally appears in this nibble + * means "IP packet". + */ + +/* packet types */ +#define TYPE_IP 0x40 +#define TYPE_UNCOMPRESSED_TCP 0x70 +#define TYPE_COMPRESSED_TCP 0x80 +#define TYPE_ERROR 0x00 + +/* Bits in first octet of compressed packet */ +#define NEW_C 0x40 /* flag bits for what changed in a packet */ +#define NEW_I 0x20 +#define NEW_S 0x08 +#define NEW_A 0x04 +#define NEW_W 0x02 +#define NEW_U 0x01 + +/* reserved, special-case values of above */ +#define SPECIAL_I (NEW_S|NEW_W|NEW_U) /* echoed interactive traffic */ +#define SPECIAL_D (NEW_S|NEW_A|NEW_W|NEW_U) /* unidirectional data */ +#define SPECIALS_MASK (NEW_S|NEW_A|NEW_W|NEW_U) + +#define TCP_PUSH_BIT 0x10 + + +/* + * "state" data for each active tcp conversation on the wire. This is + * basically a copy of the entire IP/TCP header from the last packet + * we saw from the conversation together with a small identifier + * the transmit & receive ends of the line use to locate saved header. + */ +struct cstate { + struct cstate *cs_next; /* next most recently used state (xmit only) */ + u16_t cs_hlen; /* size of hdr (receive only) */ + u8_t cs_id; /* connection # associated with this state */ + u8_t cs_filler; + union { + char csu_hdr[MAX_HDR]; + struct ip_hdr csu_ip; /* ip/tcp hdr from most recent packet */ + } vjcs_u; +}; +#define cs_ip vjcs_u.csu_ip +#define cs_hdr vjcs_u.csu_hdr + + +struct vjstat { + u32_t vjs_packets; /* outbound packets */ + u32_t vjs_compressed; /* outbound compressed packets */ + u32_t vjs_searches; /* searches for connection state */ + u32_t vjs_misses; /* times couldn't find conn. state */ + u32_t vjs_uncompressedin; /* inbound uncompressed packets */ + u32_t vjs_compressedin; /* inbound compressed packets */ + u32_t vjs_errorin; /* inbound unknown type packets */ + u32_t vjs_tossed; /* inbound packets tossed because of error */ +}; + +/* + * all the state data for one serial line (we need one of these per line). + */ +struct vjcompress { + struct cstate *last_cs; /* most recently used tstate */ + u8_t last_recv; /* last rcvd conn. id */ + u8_t last_xmit; /* last sent conn. id */ + u16_t flags; + u8_t maxSlotIndex; + u8_t compressSlot; /* Flag indicating OK to compress slot ID. */ +#if LINK_STATS + struct vjstat stats; +#endif + struct cstate tstate[MAX_SLOTS]; /* xmit connection states */ + struct cstate rstate[MAX_SLOTS]; /* receive connection states */ +}; + +/* flag values */ +#define VJF_TOSS 1U /* tossing rcvd frames because of input err */ + +extern void vj_compress_init (struct vjcompress *comp); +extern u8_t vj_compress_tcp (struct vjcompress *comp, struct pbuf **pb); +extern void vj_uncompress_err (struct vjcompress *comp); +extern int vj_uncompress_uncomp(struct pbuf *nb, struct vjcompress *comp); +extern int vj_uncompress_tcp (struct pbuf **nb, struct vjcompress *comp); + +#endif /* VJ_H */ + +#endif /* PPP_SUPPORT && VJ_SUPPORT */ diff --git a/components/lwip/include/lwip/netif/slipif.h b/components/lwip/include/lwip/netif/slipif.h new file mode 100755 index 000000000..d164d4486 --- /dev/null +++ b/components/lwip/include/lwip/netif/slipif.h @@ -0,0 +1,81 @@ +/* + * Copyright (c) 2001, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef LWIP_HDR_NETIF_SLIPIF_H +#define LWIP_HDR_NETIF_SLIPIF_H + +#include "lwip/opt.h" +#include "lwip/netif.h" + +/** Set this to 1 to start a thread that blocks reading on the serial line + * (using sio_read()). + */ +#ifndef SLIP_USE_RX_THREAD +#define SLIP_USE_RX_THREAD !NO_SYS +#endif + +/** Set this to 1 to enable functions to pass in RX bytes from ISR context. + * If enabled, slipif_received_byte[s]() process incoming bytes and put assembled + * packets on a queue, which is fed into lwIP from slipif_poll(). + * If disabled, slipif_poll() polls the serial line (using sio_tryread()). + */ +#ifndef SLIP_RX_FROM_ISR +#define SLIP_RX_FROM_ISR 0 +#endif + +/** Set this to 1 (default for SLIP_RX_FROM_ISR) to queue incoming packets + * received by slipif_received_byte[s]() as long as PBUF_POOL pbufs are available. + * If disabled, packets will be dropped if more than one packet is received. + */ +#ifndef SLIP_RX_QUEUE +#define SLIP_RX_QUEUE SLIP_RX_FROM_ISR +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +err_t slipif_init(struct netif * netif); +void slipif_poll(struct netif *netif); +#if SLIP_RX_FROM_ISR +void slipif_process_rxqueue(struct netif *netif); +void slipif_received_byte(struct netif *netif, u8_t data); +void slipif_received_bytes(struct netif *netif, u8_t *data, u8_t len); +#endif /* SLIP_RX_FROM_ISR */ + +#ifdef __cplusplus +} +#endif + +#endif /* LWIP_HDR_NETIF_SLIPIF_H */ + diff --git a/components/lwip/include/lwip/port/arch/cc.h b/components/lwip/include/lwip/port/arch/cc.h new file mode 100644 index 000000000..8e98502cc --- /dev/null +++ b/components/lwip/include/lwip/port/arch/cc.h @@ -0,0 +1,77 @@ +/* + * Copyright (c) 2001, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef __ARCH_CC_H__ +#define __ARCH_CC_H__ + +#include + +#include "arch/sys_arch.h" + +#define BYTE_ORDER LITTLE_ENDIAN + +typedef uint8_t u8_t; +typedef int8_t s8_t; +typedef uint16_t u16_t; +typedef int16_t s16_t; +typedef uint32_t u32_t; +typedef int32_t s32_t; + +typedef unsigned long mem_ptr_t; +typedef int sys_prot_t; + +#define S16_F "d" +#define U16_F "d" +#define X16_F "x" + +#define S32_F "d" +#define U32_F "d" +#define X32_F "x" + +#define PACK_STRUCT_FIELD(x) x +#define PACK_STRUCT_STRUCT __attribute__((packed)) +#define PACK_STRUCT_BEGIN +#define PACK_STRUCT_END + +#include + +#define LWIP_PLATFORM_DIAG(x) do {printf x;} while(0) +#define LWIP_PLATFORM_ASSERT(x) do {printf(x); sys_arch_assert(__FILE__, __LINE__);} while(0) + +//#define LWIP_DEBUG +#define LWIP_NOASSERT +//#define LWIP_ERROR + +#define LWIP_PROVIDE_ERRNO + +#endif /* __ARCH_CC_H__ */ diff --git a/components/lwip/include/lwip/port/arch/perf.h b/components/lwip/include/lwip/port/arch/perf.h new file mode 100644 index 000000000..089facac1 --- /dev/null +++ b/components/lwip/include/lwip/port/arch/perf.h @@ -0,0 +1,40 @@ +/* + * Copyright (c) 2001, Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ +#ifndef __PERF_H__ +#define __PERF_H__ + +#define PERF_START /* null definition */ +#define PERF_STOP(x) /* null definition */ + +#endif /* __PERF_H__ */ diff --git a/components/lwip/include/lwip/port/arch/sys_arch.h b/components/lwip/include/lwip/port/arch/sys_arch.h new file mode 100644 index 000000000..a78dd5a3f --- /dev/null +++ b/components/lwip/include/lwip/port/arch/sys_arch.h @@ -0,0 +1,73 @@ +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#ifndef __SYS_ARCH_H__ +#define __SYS_ARCH_H__ + +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "freertos/queue.h" +#include "freertos/semphr.h" + +typedef xSemaphoreHandle sys_sem_t; +typedef xSemaphoreHandle sys_mutex_t; +typedef xTaskHandle sys_thread_t; + +typedef struct sys_mbox_s { + xQueueHandle os_mbox; + sys_mutex_t lock; + uint8_t alive; +}* sys_mbox_t; + + +#define LWIP_COMPAT_MUTEX 0 + +#if !LWIP_COMPAT_MUTEX +#define sys_mutex_valid( x ) ( ( ( *x ) == NULL) ? pdFALSE : pdTRUE ) +#define sys_mutex_set_invalid( x ) ( ( *x ) = NULL ) +#endif + +#define sys_mbox_valid( x ) ( ( ( *x ) == NULL) ? pdFALSE : pdTRUE ) +#define sys_mbox_set_invalid( x ) ( ( *x ) = NULL ) + +#define sys_sem_valid( x ) ( ( ( *x ) == NULL) ? pdFALSE : pdTRUE ) +#define sys_sem_set_invalid( x ) ( ( *x ) = NULL ) + +void sys_arch_assert(const char *file, int line); +uint32_t system_get_time(void); +sys_sem_t* sys_thread_sem(void); +void sys_delay_ms(uint32_t ms); + + + +#endif /* __SYS_ARCH_H__ */ + diff --git a/components/lwip/include/lwip/port/lwipopts.h b/components/lwip/include/lwip/port/lwipopts.h new file mode 100755 index 000000000..4958034d7 --- /dev/null +++ b/components/lwip/include/lwip/port/lwipopts.h @@ -0,0 +1,526 @@ +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Simon Goldschmidt + * + */ +#ifndef __LWIPOPTS_H__ +#define __LWIPOPTS_H__ + +#include + + +/* + ----------------------------------------------- + ---------- Platform specific locking ---------- + ----------------------------------------------- +*/ +/** + * SYS_LIGHTWEIGHT_PROT==1: if you want inter-task protection for certain + * critical regions during buffer allocation, deallocation and memory + * allocation and deallocation. + */ +#define SYS_LIGHTWEIGHT_PROT 1 + +/** + * MEMCPY: override this if you have a faster implementation at hand than the + * one included in your C library + */ +#define MEMCPY(dst,src,len) memcpy(dst,src,len) + +/** + * SMEMCPY: override this with care! Some compilers (e.g. gcc) can inline a + * call to memcpy() if the length is known at compile time and is small. + */ +#define SMEMCPY(dst,src,len) memcpy(dst,src,len) + +extern unsigned long os_random(void); +#define LWIP_RAND rand +/* + ------------------------------------ + ---------- Memory options ---------- + ------------------------------------ +*/ +/** + * MEM_LIBC_MALLOC==1: Use malloc/free/realloc provided by your C-library + * instead of the lwip internal allocator. Can save code size if you + * already use it. + */ +#define MEM_LIBC_MALLOC 1 + +/** +* MEMP_MEM_MALLOC==1: Use mem_malloc/mem_free instead of the lwip pool allocator. +* Especially useful with MEM_LIBC_MALLOC but handle with care regarding execution +* speed and usage from interrupts! +*/ +#define MEMP_MEM_MALLOC 1 + +/** + * MEM_ALIGNMENT: should be set to the alignment of the CPU + * 4 byte alignment -> #define MEM_ALIGNMENT 4 + * 2 byte alignment -> #define MEM_ALIGNMENT 2 + */ +#define MEM_ALIGNMENT 4 + +/* + ------------------------------------------------ + ---------- Internal Memory Pool Sizes ---------- + ------------------------------------------------ +*/ +/** + * MEMP_NUM_TCP_PCB: the number of simulatenously active TCP connections. + * (requires the LWIP_TCP option) + */ +#define MEMP_NUM_TCP_PCB 5 + +/** + * MEMP_NUM_NETCONN: the number of struct netconns. + * (only needed if you use the sequential API, like api_lib.c) + */ +#define MEMP_NUM_NETCONN 10 + +/* + -------------------------------- + ---------- ARP options ------- + -------------------------------- +*/ +/** + * ARP_QUEUEING==1: Multiple outgoing packets are queued during hardware address + * resolution. By default, only the most recent packet is queued per IP address. + * This is sufficient for most protocols and mainly reduces TCP connection + * startup time. Set this to 1 if you know your application sends more than one + * packet in a row to an IP address that is not in the ARP cache. + */ +#define ARP_QUEUEING 1 + +/* + -------------------------------- + ---------- IP options ---------- + -------------------------------- +*/ +/** + * IP_REASSEMBLY==1: Reassemble incoming fragmented IP packets. Note that + * this option does not affect outgoing packet sizes, which can be controlled + * via IP_FRAG. + */ +#define IP_REASSEMBLY 0 + +/** + * IP_FRAG==1: Fragment outgoing IP packets if their size exceeds MTU. Note + * that this option does not affect incoming packet sizes, which can be + * controlled via IP_REASSEMBLY. + */ +#define IP_FRAG 0 + +/** + * IP_REASS_MAXAGE: Maximum time (in multiples of IP_TMR_INTERVAL - so seconds, normally) + * a fragmented IP packet waits for all fragments to arrive. If not all fragments arrived + * in this time, the whole packet is discarded. + */ +#define IP_REASS_MAXAGE 3 + +/** + * IP_REASS_MAX_PBUFS: Total maximum amount of pbufs waiting to be reassembled. + * Since the received pbufs are enqueued, be sure to configure + * PBUF_POOL_SIZE > IP_REASS_MAX_PBUFS so that the stack is still able to receive + * packets even if the maximum amount of fragments is enqueued for reassembly! + */ +#define IP_REASS_MAX_PBUFS 10 + +/* + ---------------------------------- + ---------- ICMP options ---------- + ---------------------------------- +*/ + +/* + --------------------------------- + ---------- RAW options ---------- + --------------------------------- +*/ + +/* + ---------------------------------- + ---------- DHCP options ---------- + ---------------------------------- +*/ +/** + * LWIP_DHCP==1: Enable DHCP module. + */ +#define LWIP_DHCP 1 + + +#define DHCP_MAXRTX 0 //(*(volatile uint32*)0x600011E0) +/* + ------------------------------------ + ---------- AUTOIP options ---------- + ------------------------------------ +*/ +/* + ---------------------------------- + ---------- SNMP options ---------- + ---------------------------------- +*/ +/* + ---------------------------------- + ---------- IGMP options ---------- + ---------------------------------- +*/ +/** + * LWIP_IGMP==1: Turn on IGMP module. + */ +#define LWIP_IGMP 1 + +/* + ---------------------------------- + ---------- DNS options ----------- + ---------------------------------- +*/ +/** + * LWIP_DNS==1: Turn on DNS module. UDP must be available for DNS + * transport. + */ +#define LWIP_DNS 1 + +/* + --------------------------------- + ---------- UDP options ---------- + --------------------------------- +*/ +/* + --------------------------------- + ---------- TCP options ---------- + --------------------------------- +*/ +/** + * TCP_WND: The size of a TCP window. This must be at least + * (2 * TCP_MSS) for things to work well + */ +#ifdef PERF + +extern unsigned char misc_prof_get_tcpw(void); +extern unsigned char misc_prof_get_tcp_snd_buf(void); +#define TCP_WND (misc_prof_get_tcpw()*TCP_MSS) +#define TCP_SND_BUF (misc_prof_get_tcp_snd_buf()*TCP_MSS) + +#else + +#define TCP_WND (4 * TCP_MSS) +#define TCP_SND_BUF (2 * TCP_MSS) + +#endif + + +/** + * TCP_QUEUE_OOSEQ==1: TCP will queue segments that arrive out of order. + * Define to 0 if your device is low on memory. + */ +#define TCP_QUEUE_OOSEQ 1 + +/* + * LWIP_EVENT_API==1: The user defines lwip_tcp_event() to receive all + * events (accept, sent, etc) that happen in the system. + * LWIP_CALLBACK_API==1: The PCB callback function is called directly + * for the event. This is the default. +*/ +#define TCP_MSS 1460 + +/** + * TCP_MAXRTX: Maximum number of retransmissions of data segments. + */ +#define TCP_MAXRTX 12 //(*(volatile uint32*)0x600011E8) + +/** + * TCP_SYNMAXRTX: Maximum number of retransmissions of SYN segments. + */ +#define TCP_SYNMAXRTX 6 //(*(volatile uint32*)0x600011E4) + +/** + * TCP_LISTEN_BACKLOG: Enable the backlog option for tcp listen pcb. + */ +#define TCP_LISTEN_BACKLOG 1 + +/* + ---------------------------------- + ---------- Pbuf options ---------- + ---------------------------------- +*/ + +/* + ------------------------------------------------ + ---------- Network Interfaces options ---------- + ------------------------------------------------ +*/ + +/** + * LWIP_NETIF_HOSTNAME==1: use DHCP_OPTION_HOSTNAME with netif's hostname + * field. + */ +#define LWIP_NETIF_HOSTNAME 1 + +/** + * LWIP_NETIF_TX_SINGLE_PBUF: if this is set to 1, lwIP tries to put all data + * to be sent into one single pbuf. This is for compatibility with DMA-enabled + * MACs that do not support scatter-gather. + * Beware that this might involve CPU-memcpy before transmitting that would not + * be needed without this flag! Use this only if you need to! + * + * @todo: TCP and IP-frag do not work with this, yet: + */ +#define LWIP_NETIF_TX_SINGLE_PBUF 1 + +/* + ------------------------------------ + ---------- LOOPIF options ---------- + ------------------------------------ +*/ + +/* + ------------------------------------ + ---------- SLIPIF options ---------- + ------------------------------------ +*/ + +/* + ------------------------------------ + ---------- Thread options ---------- + ------------------------------------ +*/ +/** + * TCPIP_THREAD_NAME: The name assigned to the main tcpip thread. + */ +#define TCPIP_THREAD_NAME "tiT" + +/** + * TCPIP_THREAD_STACKSIZE: The stack size used by the main tcpip thread. + * The stack size value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#define TCPIP_THREAD_STACKSIZE 2048 //not ok:384 + +/** + * TCPIP_THREAD_PRIO: The priority assigned to the main tcpip thread. + * The priority value itself is platform-dependent, but is passed to + * sys_thread_new() when the thread is created. + */ +#define TCPIP_THREAD_PRIO (configMAX_PRIORITIES-5) + +/** + * TCPIP_MBOX_SIZE: The mailbox size for the tcpip thread messages + * The queue size value itself is platform-dependent, but is passed to + * sys_mbox_new() when tcpip_init is called. + */ +#define TCPIP_MBOX_SIZE 16 + +/** + * DEFAULT_UDP_RECVMBOX_SIZE: The mailbox size for the incoming packets on a + * NETCONN_UDP. The queue size value itself is platform-dependent, but is passed + * to sys_mbox_new() when the recvmbox is created. + */ +#define DEFAULT_UDP_RECVMBOX_SIZE 16 + +/** + * DEFAULT_TCP_RECVMBOX_SIZE: The mailbox size for the incoming packets on a + * NETCONN_TCP. The queue size value itself is platform-dependent, but is passed + * to sys_mbox_new() when the recvmbox is created. + */ +#define DEFAULT_TCP_RECVMBOX_SIZE 16 +//#define DEFAULT_TCP_RECVMBOX_SIZE 6 + +/** + * DEFAULT_ACCEPTMBOX_SIZE: The mailbox size for the incoming connections. + * The queue size value itself is platform-dependent, but is passed to + * sys_mbox_new() when the acceptmbox is created. + */ +#define DEFAULT_ACCEPTMBOX_SIZE 6 + +/* + ---------------------------------------------- + ---------- Sequential layer options ---------- + ---------------------------------------------- +*/ +/** + * LWIP_TCPIP_CORE_LOCKING: (EXPERIMENTAL!) + * Don't use it if you're not an active lwIP project member + */ +#define LWIP_TCPIP_CORE_LOCKING 0 + +/* + ------------------------------------ + ---------- Socket options ---------- + ------------------------------------ +*/ +/** + * LWIP_SO_SNDTIMEO==1: Enable send timeout for sockets/netconns and + * SO_SNDTIMEO processing. + */ +#define LWIP_SO_SNDTIMEO 1 + +/** + * LWIP_SO_RCVTIMEO==1: Enable receive timeout for sockets/netconns and + * SO_RCVTIMEO processing. + */ +#define LWIP_SO_RCVTIMEO 1 + +/** + * LWIP_TCP_KEEPALIVE==1: Enable TCP_KEEPIDLE, TCP_KEEPINTVL and TCP_KEEPCNT + * options processing. Note that TCP_KEEPIDLE and TCP_KEEPINTVL have to be set + * in seconds. (does not require sockets.c, and will affect tcp.c) + */ +#define LWIP_TCP_KEEPALIVE 1 + +/** + * LWIP_SO_RCVBUF==1: Enable SO_RCVBUF processing. + */ +#define LWIP_SO_RCVBUF 0 + +/** + * SO_REUSE==1: Enable SO_REUSEADDR option. + */ +#define SO_REUSE 0 + +/* + ---------------------------------------- + ---------- Statistics options ---------- + ---------------------------------------- +*/ +/** + * LWIP_STATS==1: Enable statistics collection in lwip_stats. + */ +#define LWIP_STATS 0 + +/* + --------------------------------- + ---------- PPP options ---------- + --------------------------------- +*/ + +/* + -------------------------------------- + ---------- Checksum options ---------- + -------------------------------------- +*/ + +/* + --------------------------------------- + ---------- IPv6 options --------------- + --------------------------------------- +*/ +/** + * LWIP_IPV6==1: Enable IPv6 + */ +#define LWIP_IPV6 1 + +/* + --------------------------------------- + ---------- Hook options --------------- + --------------------------------------- +*/ + +/* + --------------------------------------- + ---------- Debugging options ---------- + --------------------------------------- +*/ +/** + * ETHARP_DEBUG: Enable debugging in etharp.c. + */ +#define ETHARP_DEBUG LWIP_DBG_OFF + +/** + * NETIF_DEBUG: Enable debugging in netif.c. + */ +#define NETIF_DEBUG LWIP_DBG_OFF + +/** + * PBUF_DEBUG: Enable debugging in pbuf.c. + */ +#define PBUF_DEBUG LWIP_DBG_OFF + +/** + * API_LIB_DEBUG: Enable debugging in api_lib.c. + */ +#define API_LIB_DEBUG LWIP_DBG_OFF + +/** + * SOCKETS_DEBUG: Enable debugging in sockets.c. + */ +#define SOCKETS_DEBUG LWIP_DBG_OFF + +/** + * ICMP_DEBUG: Enable debugging in icmp.c. + */ +#define ICMP_DEBUG LWIP_DBG_OFF + +/** + * IP_DEBUG: Enable debugging for IP. + */ +#define IP_DEBUG LWIP_DBG_OFF + +/** + * MEMP_DEBUG: Enable debugging in memp.c. + */ +#define MEMP_DEBUG LWIP_DBG_OFF + +/** + * TCP_INPUT_DEBUG: Enable debugging in tcp_in.c for incoming debug. + */ +#define TCP_INPUT_DEBUG LWIP_DBG_OFF + +/** + * TCP_OUTPUT_DEBUG: Enable debugging in tcp_out.c output functions. + */ +#define TCP_OUTPUT_DEBUG LWIP_DBG_OFF + +/** + * TCPIP_DEBUG: Enable debugging in tcpip.c. + */ +#define TCPIP_DEBUG LWIP_DBG_OFF + +/** + * DHCP_DEBUG: Enable debugging in dhcp.c. + */ +#define DHCP_DEBUG LWIP_DBG_OFF +//#define LWIP_DEBUG 1 +//#define TCP_DEBUG LWIP_DBG_ON +#define THREAD_SAFE_DEBUG LWIP_DBG_OFF +#define LWIP_THREAD_SAFE 1 + +#define CHECKSUM_CHECK_UDP 0 +#define CHECKSUM_CHECK_IP 0 + +#define HEAP_HIGHWAT 6*1024 + +#define LWIP_NETCONN_FULLDUPLEX 1 +#define LWIP_NETCONN_SEM_PER_THREAD 1 + + + +#define SOC_SEND_LOG //printf + +#endif /* __LWIPOPTS_H__ */ diff --git a/components/lwip/include/lwip/port/netif/wlanif.h b/components/lwip/include/lwip/port/netif/wlanif.h new file mode 100755 index 000000000..f9e322ebd --- /dev/null +++ b/components/lwip/include/lwip/port/netif/wlanif.h @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2010-2011 Espressif System + * +*/ + +#ifndef _WLAN_LWIP_IF_H_ +#define _WLAN_LWIP_IF_H_ + +#include "esp_wifi.h" + +#include "lwip/err.h" + +err_t wlanif_init(struct netif *netif); + +void wlanif_input(struct netif *netif, void *buffer, u16_t len, void* eb); + +bool ieee80211_output(wifi_interface_t wifi_if, void *buffer, u16_t len); + +wifi_interface_t wifi_get_interface(void *dev); + +void netif_reg_addr_change_cb(void* cb); + +#endif /* _WLAN_LWIP_IF_H_ */ diff --git a/components/lwip/include/lwip/posix/netdb.h b/components/lwip/include/lwip/posix/netdb.h new file mode 100755 index 000000000..12d4c7f56 --- /dev/null +++ b/components/lwip/include/lwip/posix/netdb.h @@ -0,0 +1,33 @@ +/** + * @file + * This file is a posix wrapper for lwip/netdb.h. + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/netdb.h" diff --git a/components/lwip/include/lwip/posix/sys/socket.h b/components/lwip/include/lwip/posix/sys/socket.h new file mode 100755 index 000000000..0ed9baf3d --- /dev/null +++ b/components/lwip/include/lwip/posix/sys/socket.h @@ -0,0 +1,33 @@ +/** + * @file + * This file is a posix wrapper for lwip/sockets.h. + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/sockets.h" diff --git a/components/lwip/netif/FILES b/components/lwip/netif/FILES new file mode 100755 index 000000000..501edac3f --- /dev/null +++ b/components/lwip/netif/FILES @@ -0,0 +1,31 @@ +This directory contains generic network interface device drivers that +do not contain any hardware or architecture specific code. The files +are: + +etharp.c + Implements the ARP (Address Resolution Protocol) over + Ethernet. The code in this file should be used together with + Ethernet device drivers. Note that this module has been + largely made Ethernet independent so you should be able to + adapt this for other link layers (such as Firewire). + +ethernetif.c + An example of how an Ethernet device driver could look. This + file can be used as a "skeleton" for developing new Ethernet + network device drivers. It uses the etharp.c ARP code. + +loopif.c + A "loopback" network interface driver. It requires configuration + through the define LWIP_LOOPIF_MULTITHREADING (see opt.h). + +slipif.c + A generic implementation of the SLIP (Serial Line IP) + protocol. It requires a sio (serial I/O) module to work. + +lowpan6.c + 6LoWPAN implementation + +ppp/ Point-to-Point Protocol stack + The lwIP PPP support is based from pppd (http://ppp.samba.org) with + huge changes to match code size and memory requirements for embedded + devices. Please read ppp/PPPD_FOLLOWUP for a detailed explanation. diff --git a/components/lwip/netif/etharp.c b/components/lwip/netif/etharp.c new file mode 100755 index 000000000..5891c5cfd --- /dev/null +++ b/components/lwip/netif/etharp.c @@ -0,0 +1,1385 @@ +/** + * @file + * Address Resolution Protocol module for IP over Ethernet + * + * Functionally, ARP is divided into two parts. The first maps an IP address + * to a physical address when sending a packet, and the second part answers + * requests from other machines for our physical address. + * + * This implementation complies with RFC 826 (Ethernet ARP). It supports + * Gratuitious ARP from RFC3220 (IP Mobility Support for IPv4) section 4.6 + * if an interface calls etharp_gratuitous(our_netif) upon address change. + */ + +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * Copyright (c) 2003-2004 Leon Woestenberg + * Copyright (c) 2003-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" + +#if LWIP_ARP || LWIP_ETHERNET + +#include "netif/etharp.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" +#include "lwip/dhcp.h" +#include "lwip/autoip.h" + +#include + +#ifdef MEMLEAK_DEBUG +static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; +#endif + +#if LWIP_IPV4 && LWIP_ARP /* don't build if not configured for use in lwipopts.h */ + +/** Re-request a used ARP entry 1 minute before it would expire to prevent + * breaking a steadily used connection because the ARP entry timed out. */ +#define ARP_AGE_REREQUEST_USED_UNICAST (ARP_MAXAGE - 30) +#define ARP_AGE_REREQUEST_USED_BROADCAST (ARP_MAXAGE - 15) + +/** the time an ARP entry stays pending after first request, + * for ARP_TMR_INTERVAL = 1000, this is + * 10 seconds. + * + * @internal Keep this number at least 2, otherwise it might + * run out instantly if the timeout occurs directly after a request. + */ +#define ARP_MAXPENDING 5 + +#define HWTYPE_ETHERNET 1 + +enum etharp_state { + ETHARP_STATE_EMPTY = 0, + ETHARP_STATE_PENDING, + ETHARP_STATE_STABLE, + ETHARP_STATE_STABLE_REREQUESTING_1, + ETHARP_STATE_STABLE_REREQUESTING_2 +#if ETHARP_SUPPORT_STATIC_ENTRIES + ,ETHARP_STATE_STATIC +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ +}; + +struct etharp_entry { +#if ARP_QUEUEING + /** Pointer to queue of pending outgoing packets on this ARP entry. */ + struct etharp_q_entry *q; +#else /* ARP_QUEUEING */ + /** Pointer to a single pending outgoing packet on this ARP entry. */ + struct pbuf *q; +#endif /* ARP_QUEUEING */ + ip4_addr_t ipaddr; + struct netif *netif; + struct eth_addr ethaddr; + u16_t ctime; + u8_t state; +}; + +static struct etharp_entry arp_table[ARP_TABLE_SIZE]; + +#if !LWIP_NETIF_HWADDRHINT +static u8_t etharp_cached_entry; +#endif /* !LWIP_NETIF_HWADDRHINT */ + +/** Try hard to create a new entry - we want the IP address to appear in + the cache (even if this means removing an active entry or so). */ +#define ETHARP_FLAG_TRY_HARD 1 +#define ETHARP_FLAG_FIND_ONLY 2 +#if ETHARP_SUPPORT_STATIC_ENTRIES +#define ETHARP_FLAG_STATIC_ENTRY 4 +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + +#if LWIP_NETIF_HWADDRHINT +#define ETHARP_SET_HINT(netif, hint) if (((netif) != NULL) && ((netif)->addr_hint != NULL)) \ + *((netif)->addr_hint) = (hint); +#else /* LWIP_NETIF_HWADDRHINT */ +#define ETHARP_SET_HINT(netif, hint) (etharp_cached_entry = (hint)) +#endif /* LWIP_NETIF_HWADDRHINT */ + + +/* Some checks, instead of etharp_init(): */ +#if (LWIP_ARP && (ARP_TABLE_SIZE > 0x7f)) + #error "ARP_TABLE_SIZE must fit in an s8_t, you have to reduce it in your lwipopts.h" +#endif + + +static err_t etharp_request_dst(struct netif *netif, const ip4_addr_t *ipaddr, const struct eth_addr* hw_dst_addr); + + +#if ARP_QUEUEING +/** + * Free a complete queue of etharp entries + * + * @param q a qeueue of etharp_q_entry's to free + */ +static void +free_etharp_q(struct etharp_q_entry *q) +{ + struct etharp_q_entry *r; + LWIP_ASSERT("q != NULL", q != NULL); + LWIP_ASSERT("q->p != NULL", q->p != NULL); + while (q) { + r = q; + q = q->next; + LWIP_ASSERT("r->p != NULL", (r->p != NULL)); + pbuf_free(r->p); + memp_free(MEMP_ARP_QUEUE, r); + } +} +#else /* ARP_QUEUEING */ + +/** Compatibility define: free the queued pbuf */ +#define free_etharp_q(q) pbuf_free(q) + +#endif /* ARP_QUEUEING */ + +/** Clean up ARP table entries */ +static void +etharp_free_entry(int i) +{ + /* remove from SNMP ARP index tree */ + mib2_remove_arp_entry(arp_table[i].netif, &arp_table[i].ipaddr); + /* and empty packet queue */ + if (arp_table[i].q != NULL) { + /* remove all queued packets */ + LWIP_DEBUGF(ETHARP_DEBUG, ("etharp_free_entry: freeing entry %"U16_F", packet queue %p.\n", (u16_t)i, (void *)(arp_table[i].q))); + free_etharp_q(arp_table[i].q); + arp_table[i].q = NULL; + } + /* recycle entry for re-use */ + arp_table[i].state = ETHARP_STATE_EMPTY; +#ifdef LWIP_DEBUG + /* for debugging, clean out the complete entry */ + arp_table[i].ctime = 0; + arp_table[i].netif = NULL; + ip4_addr_set_zero(&arp_table[i].ipaddr); + arp_table[i].ethaddr = ethzero; +#endif /* LWIP_DEBUG */ +} + +/** + * Clears expired entries in the ARP table. + * + * This function should be called every ARP_TMR_INTERVAL milliseconds (1 second), + * in order to expire entries in the ARP table. + */ +void +etharp_tmr(void) +{ + u8_t i; + + LWIP_DEBUGF(ETHARP_DEBUG, ("etharp_timer\n")); + /* remove expired entries from the ARP table */ + for (i = 0; i < ARP_TABLE_SIZE; ++i) { + u8_t state = arp_table[i].state; + if (state != ETHARP_STATE_EMPTY +#if ETHARP_SUPPORT_STATIC_ENTRIES + && (state != ETHARP_STATE_STATIC) +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + ) { + arp_table[i].ctime++; + if ((arp_table[i].ctime >= ARP_MAXAGE) || + ((arp_table[i].state == ETHARP_STATE_PENDING) && + (arp_table[i].ctime >= ARP_MAXPENDING))) { + /* pending or stable entry has become old! */ + LWIP_DEBUGF(ETHARP_DEBUG, ("etharp_timer: expired %s entry %"U16_F".\n", + arp_table[i].state >= ETHARP_STATE_STABLE ? "stable" : "pending", (u16_t)i)); + /* clean up entries that have just been expired */ + etharp_free_entry(i); + } else if (arp_table[i].state == ETHARP_STATE_STABLE_REREQUESTING_1) { + /* Don't send more than one request every 2 seconds. */ + arp_table[i].state = ETHARP_STATE_STABLE_REREQUESTING_2; + } else if (arp_table[i].state == ETHARP_STATE_STABLE_REREQUESTING_2) { + /* Reset state to stable, so that the next transmitted packet will + re-send an ARP request. */ + arp_table[i].state = ETHARP_STATE_STABLE; + } else if (arp_table[i].state == ETHARP_STATE_PENDING) { + /* still pending, resend an ARP query */ + etharp_request(arp_table[i].netif, &arp_table[i].ipaddr); + } + } + } +} + +/** + * Search the ARP table for a matching or new entry. + * + * If an IP address is given, return a pending or stable ARP entry that matches + * the address. If no match is found, create a new entry with this address set, + * but in state ETHARP_EMPTY. The caller must check and possibly change the + * state of the returned entry. + * + * If ipaddr is NULL, return a initialized new entry in state ETHARP_EMPTY. + * + * In all cases, attempt to create new entries from an empty entry. If no + * empty entries are available and ETHARP_FLAG_TRY_HARD flag is set, recycle + * old entries. Heuristic choose the least important entry for recycling. + * + * @param ipaddr IP address to find in ARP cache, or to add if not found. + * @param flags @see definition of ETHARP_FLAG_* + * @param netif netif related to this address (used for NETIF_HWADDRHINT) + * + * @return The ARP entry index that matched or is created, ERR_MEM if no + * entry is found or could be recycled. + */ +static s8_t +etharp_find_entry(const ip4_addr_t *ipaddr, u8_t flags, struct netif* netif) +{ + s8_t old_pending = ARP_TABLE_SIZE, old_stable = ARP_TABLE_SIZE; + s8_t empty = ARP_TABLE_SIZE; + u8_t i = 0; + /* oldest entry with packets on queue */ + s8_t old_queue = ARP_TABLE_SIZE; + /* its age */ + u16_t age_queue = 0, age_pending = 0, age_stable = 0; + + LWIP_UNUSED_ARG(netif); + + /** + * a) do a search through the cache, remember candidates + * b) select candidate entry + * c) create new entry + */ + + /* a) in a single search sweep, do all of this + * 1) remember the first empty entry (if any) + * 2) remember the oldest stable entry (if any) + * 3) remember the oldest pending entry without queued packets (if any) + * 4) remember the oldest pending entry with queued packets (if any) + * 5) search for a matching IP entry, either pending or stable + * until 5 matches, or all entries are searched for. + */ + + for (i = 0; i < ARP_TABLE_SIZE; ++i) { + u8_t state = arp_table[i].state; + /* no empty entry found yet and now we do find one? */ + if ((empty == ARP_TABLE_SIZE) && (state == ETHARP_STATE_EMPTY)) { + LWIP_DEBUGF(ETHARP_DEBUG, ("etharp_find_entry: found empty entry %"U16_F"\n", (u16_t)i)); + /* remember first empty entry */ + empty = i; + } else if (state != ETHARP_STATE_EMPTY) { + LWIP_ASSERT("state == ETHARP_STATE_PENDING || state >= ETHARP_STATE_STABLE", + state == ETHARP_STATE_PENDING || state >= ETHARP_STATE_STABLE); + /* if given, does IP address match IP address in ARP entry? */ + if (ipaddr && ip4_addr_cmp(ipaddr, &arp_table[i].ipaddr) +#if ETHARP_TABLE_MATCH_NETIF + && ((netif == NULL) || (netif == arp_table[i].netif)) +#endif /* ETHARP_TABLE_MATCH_NETIF */ + ) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: found matching entry %"U16_F"\n", (u16_t)i)); + /* found exact IP address match, simply bail out */ + return i; + } + /* pending entry? */ + if (state == ETHARP_STATE_PENDING) { + /* pending with queued packets? */ + if (arp_table[i].q != NULL) { + if (arp_table[i].ctime >= age_queue) { + old_queue = i; + age_queue = arp_table[i].ctime; + } + } else + /* pending without queued packets? */ + { + if (arp_table[i].ctime >= age_pending) { + old_pending = i; + age_pending = arp_table[i].ctime; + } + } + /* stable entry? */ + } else if (state >= ETHARP_STATE_STABLE) { +#if ETHARP_SUPPORT_STATIC_ENTRIES + /* don't record old_stable for static entries since they never expire */ + if (state < ETHARP_STATE_STATIC) +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + { + /* remember entry with oldest stable entry in oldest, its age in maxtime */ + if (arp_table[i].ctime >= age_stable) { + old_stable = i; + age_stable = arp_table[i].ctime; + } + } + } + } + } + /* { we have no match } => try to create a new entry */ + + /* don't create new entry, only search? */ + if (((flags & ETHARP_FLAG_FIND_ONLY) != 0) || + /* or no empty entry found and not allowed to recycle? */ + ((empty == ARP_TABLE_SIZE) && ((flags & ETHARP_FLAG_TRY_HARD) == 0))) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: no empty entry found and not allowed to recycle\n")); + return (s8_t)ERR_MEM; + } + + /* b) choose the least destructive entry to recycle: + * 1) empty entry + * 2) oldest stable entry + * 3) oldest pending entry without queued packets + * 4) oldest pending entry with queued packets + * + * { ETHARP_FLAG_TRY_HARD is set at this point } + */ + + /* 1) empty entry available? */ + if (empty < ARP_TABLE_SIZE) { + i = empty; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: selecting empty entry %"U16_F"\n", (u16_t)i)); + } else { + /* 2) found recyclable stable entry? */ + if (old_stable < ARP_TABLE_SIZE) { + /* recycle oldest stable*/ + i = old_stable; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: selecting oldest stable entry %"U16_F"\n", (u16_t)i)); + /* no queued packets should exist on stable entries */ + LWIP_ASSERT("arp_table[i].q == NULL", arp_table[i].q == NULL); + /* 3) found recyclable pending entry without queued packets? */ + } else if (old_pending < ARP_TABLE_SIZE) { + /* recycle oldest pending */ + i = old_pending; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: selecting oldest pending entry %"U16_F" (without queue)\n", (u16_t)i)); + /* 4) found recyclable pending entry with queued packets? */ + } else if (old_queue < ARP_TABLE_SIZE) { + /* recycle oldest pending (queued packets are free in etharp_free_entry) */ + i = old_queue; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: selecting oldest pending entry %"U16_F", freeing packet queue %p\n", (u16_t)i, (void *)(arp_table[i].q))); + /* no empty or recyclable entries found */ + } else { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_find_entry: no empty or recyclable entries found\n")); + return (s8_t)ERR_MEM; + } + + /* { empty or recyclable entry found } */ + LWIP_ASSERT("i < ARP_TABLE_SIZE", i < ARP_TABLE_SIZE); + etharp_free_entry(i); + } + + LWIP_ASSERT("i < ARP_TABLE_SIZE", i < ARP_TABLE_SIZE); + LWIP_ASSERT("arp_table[i].state == ETHARP_STATE_EMPTY", + arp_table[i].state == ETHARP_STATE_EMPTY); + + /* IP address given? */ + if (ipaddr != NULL) { + /* set IP address */ + ip4_addr_copy(arp_table[i].ipaddr, *ipaddr); + } + arp_table[i].ctime = 0; +#if ETHARP_TABLE_MATCH_NETIF + arp_table[i].netif = netif; +#endif /* ETHARP_TABLE_MATCH_NETIF*/ + return (err_t)i; +} + +/** + * Send an IP packet on the network using netif->linkoutput + * The ethernet header is filled in before sending. + * + * @params netif the lwIP network interface on which to send the packet + * @params p the packet to send, p->payload pointing to the (uninitialized) ethernet header + * @params src the source MAC address to be copied into the ethernet header + * @params dst the destination MAC address to be copied into the ethernet header + * @return ERR_OK if the packet was sent, any other err_t on failure + */ +static err_t +etharp_send_ip(struct netif *netif, struct pbuf *p, struct eth_addr *src, const struct eth_addr *dst) +{ + struct eth_hdr *ethhdr = (struct eth_hdr *)p->payload; +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + struct eth_vlan_hdr *vlanhdr; +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + + LWIP_ASSERT("netif->hwaddr_len must be the same as ETH_HWADDR_LEN for etharp!", + (netif->hwaddr_len == ETH_HWADDR_LEN)); +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + ethhdr->type = PP_HTONS(ETHTYPE_VLAN); + vlanhdr = (struct eth_vlan_hdr*)(((u8_t*)ethhdr) + SIZEOF_ETH_HDR); + vlanhdr->prio_vid = 0; + vlanhdr->tpid = PP_HTONS(ETHTYPE_IP); + if (!LWIP_HOOK_VLAN_SET(netif, ethhdr, vlanhdr)) { + /* packet shall not contain VLAN header, so hide it and set correct ethertype */ + pbuf_header(p, -SIZEOF_VLAN_HDR); + ethhdr = (struct eth_hdr *)p->payload; +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + ethhdr->type = PP_HTONS(ETHTYPE_IP); +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + } +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + ETHADDR32_COPY(ðhdr->dest, dst); + ETHADDR16_COPY(ðhdr->src, src); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_send_ip: sending packet %p\n", (void *)p)); + /* send the packet */ + return netif->linkoutput(netif, p); +} + +/** + * Update (or insert) a IP/MAC address pair in the ARP cache. + * + * If a pending entry is resolved, any queued packets will be sent + * at this point. + * + * @param netif netif related to this entry (used for NETIF_ADDRHINT) + * @param ipaddr IP address of the inserted ARP entry. + * @param ethaddr Ethernet address of the inserted ARP entry. + * @param flags @see definition of ETHARP_FLAG_* + * + * @return + * - ERR_OK Successfully updated ARP cache. + * - ERR_MEM If we could not add a new ARP entry when ETHARP_FLAG_TRY_HARD was set. + * - ERR_ARG Non-unicast address given, those will not appear in ARP cache. + * + * @see pbuf_free() + */ +static err_t +etharp_update_arp_entry(struct netif *netif, const ip4_addr_t *ipaddr, struct eth_addr *ethaddr, u8_t flags) +{ + s8_t i; + LWIP_ASSERT("netif->hwaddr_len == ETH_HWADDR_LEN", netif->hwaddr_len == ETH_HWADDR_LEN); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_update_arp_entry: %"U16_F".%"U16_F".%"U16_F".%"U16_F" - %02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F"\n", + ip4_addr1_16(ipaddr), ip4_addr2_16(ipaddr), ip4_addr3_16(ipaddr), ip4_addr4_16(ipaddr), + ethaddr->addr[0], ethaddr->addr[1], ethaddr->addr[2], + ethaddr->addr[3], ethaddr->addr[4], ethaddr->addr[5])); + /* non-unicast address? */ + if (ip4_addr_isany(ipaddr) || + ip4_addr_isbroadcast(ipaddr, netif) || + ip4_addr_ismulticast(ipaddr)) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_update_arp_entry: will not add non-unicast IP address to ARP cache\n")); + return ERR_ARG; + } + /* find or create ARP entry */ + i = etharp_find_entry(ipaddr, flags, netif); + /* bail out if no entry could be found */ + if (i < 0) { + return (err_t)i; + } + +#if ETHARP_SUPPORT_STATIC_ENTRIES + if (flags & ETHARP_FLAG_STATIC_ENTRY) { + /* record static type */ + arp_table[i].state = ETHARP_STATE_STATIC; + } else +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + { + /* mark it stable */ + arp_table[i].state = ETHARP_STATE_STABLE; + } + + /* record network interface */ + arp_table[i].netif = netif; + /* insert in SNMP ARP index tree */ + mib2_add_arp_entry(netif, &arp_table[i].ipaddr); + + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_update_arp_entry: updating stable entry %"S16_F"\n", (s16_t)i)); + /* update address */ + ETHADDR32_COPY(&arp_table[i].ethaddr, ethaddr); + /* reset time stamp */ + arp_table[i].ctime = 0; + /* this is where we will send out queued packets! */ +#if ARP_QUEUEING + while (arp_table[i].q != NULL) { + struct pbuf *p; + /* remember remainder of queue */ + struct etharp_q_entry *q = arp_table[i].q; + /* pop first item off the queue */ + arp_table[i].q = q->next; + /* get the packet pointer */ + p = q->p; + /* now queue entry can be freed */ + memp_free(MEMP_ARP_QUEUE, q); +#else /* ARP_QUEUEING */ + if (arp_table[i].q != NULL) { + struct pbuf *p = arp_table[i].q; + arp_table[i].q = NULL; +#endif /* ARP_QUEUEING */ + /* send the queued IP packet */ + etharp_send_ip(netif, p, (struct eth_addr*)(netif->hwaddr), ethaddr); + /* free the queued IP packet */ + pbuf_free(p); + } + return ERR_OK; +} + +#if ETHARP_SUPPORT_STATIC_ENTRIES +/** Add a new static entry to the ARP table. If an entry exists for the + * specified IP address, this entry is overwritten. + * If packets are queued for the specified IP address, they are sent out. + * + * @param ipaddr IP address for the new static entry + * @param ethaddr ethernet address for the new static entry + * @return @see return values of etharp_add_static_entry + */ +err_t +etharp_add_static_entry(const ip4_addr_t *ipaddr, struct eth_addr *ethaddr) +{ + struct netif *netif; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_add_static_entry: %"U16_F".%"U16_F".%"U16_F".%"U16_F" - %02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F"\n", + ip4_addr1_16(ipaddr), ip4_addr2_16(ipaddr), ip4_addr3_16(ipaddr), ip4_addr4_16(ipaddr), + ethaddr->addr[0], ethaddr->addr[1], ethaddr->addr[2], + ethaddr->addr[3], ethaddr->addr[4], ethaddr->addr[5])); + + netif = ip4_route(ipaddr); + if (netif == NULL) { + return ERR_RTE; + } + + return etharp_update_arp_entry(netif, ipaddr, ethaddr, ETHARP_FLAG_TRY_HARD | ETHARP_FLAG_STATIC_ENTRY); +} + +/** Remove a static entry from the ARP table previously added with a call to + * etharp_add_static_entry. + * + * @param ipaddr IP address of the static entry to remove + * @return ERR_OK: entry removed + * ERR_MEM: entry wasn't found + * ERR_ARG: entry wasn't a static entry but a dynamic one + */ +err_t +etharp_remove_static_entry(const ip4_addr_t *ipaddr) +{ + s8_t i; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_remove_static_entry: %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", + ip4_addr1_16(ipaddr), ip4_addr2_16(ipaddr), ip4_addr3_16(ipaddr), ip4_addr4_16(ipaddr))); + + /* find or create ARP entry */ + i = etharp_find_entry(ipaddr, ETHARP_FLAG_FIND_ONLY, NULL); + /* bail out if no entry could be found */ + if (i < 0) { + return (err_t)i; + } + + if (arp_table[i].state != ETHARP_STATE_STATIC) { + /* entry wasn't a static entry, cannot remove it */ + return ERR_ARG; + } + /* entry found, free it */ + etharp_free_entry(i); + return ERR_OK; +} +#endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ + +/** + * Remove all ARP table entries of the specified netif. + * + * @param netif points to a network interface + */ +void etharp_cleanup_netif(struct netif *netif) +{ + u8_t i; + + for (i = 0; i < ARP_TABLE_SIZE; ++i) { + u8_t state = arp_table[i].state; + if ((state != ETHARP_STATE_EMPTY) && (arp_table[i].netif == netif)) { + etharp_free_entry(i); + } + } +} + +/** + * Finds (stable) ethernet/IP address pair from ARP table + * using interface and IP address index. + * @note the addresses in the ARP table are in network order! + * + * @param netif points to interface index + * @param ipaddr points to the (network order) IP address index + * @param eth_ret points to return pointer + * @param ip_ret points to return pointer + * @return table index if found, -1 otherwise + */ +s8_t +etharp_find_addr(struct netif *netif, const ip4_addr_t *ipaddr, + struct eth_addr **eth_ret, const ip4_addr_t **ip_ret) +{ + s8_t i; + + LWIP_ASSERT("eth_ret != NULL && ip_ret != NULL", + eth_ret != NULL && ip_ret != NULL); + + LWIP_UNUSED_ARG(netif); + + i = etharp_find_entry(ipaddr, ETHARP_FLAG_FIND_ONLY, netif); + if ((i >= 0) && (arp_table[i].state >= ETHARP_STATE_STABLE)) { + *eth_ret = &arp_table[i].ethaddr; + *ip_ret = &arp_table[i].ipaddr; + return i; + } + return -1; +} + +/** + * Possibility to iterate over stable ARP table entries + * + * @param i entry number, 0 to ARP_TABLE_SIZE + * @param ipaddr return value: IP address + * @param netif return value: points to interface + * @param eth_ret return value: ETH address + * @return 1 on valid index, 0 otherwise + */ +u8_t +etharp_get_entry(u8_t i, ip4_addr_t **ipaddr, struct netif **netif, struct eth_addr **eth_ret) +{ + LWIP_ASSERT("ipaddr != NULL", ipaddr != NULL); + LWIP_ASSERT("netif != NULL", netif != NULL); + LWIP_ASSERT("eth_ret != NULL", eth_ret != NULL); + + if((i < ARP_TABLE_SIZE) && (arp_table[i].state >= ETHARP_STATE_STABLE)) { + *ipaddr = &arp_table[i].ipaddr; + *netif = arp_table[i].netif; + *eth_ret = &arp_table[i].ethaddr; + return 1; + } else { + return 0; + } +} + +#if ETHARP_TRUST_IP_MAC +/** + * Updates the ARP table using the given IP packet. + * + * Uses the incoming IP packet's source address to update the + * ARP cache for the local network. The function does not alter + * or free the packet. This function must be called before the + * packet p is passed to the IP layer. + * + * @param netif The lwIP network interface on which the IP packet pbuf arrived. + * @param p The IP packet that arrived on netif. + * + * @return NULL + * + * @see pbuf_free() + */ +static void +etharp_ip_input(struct netif *netif, struct pbuf *p) +{ + struct eth_hdr *ethhdr; + struct ip_hdr *iphdr; + ip4_addr_t iphdr_src; + LWIP_ERROR("netif != NULL", (netif != NULL), return;); + + /* Only insert an entry if the source IP address of the + incoming IP packet comes from a host on the local network. */ + ethhdr = (struct eth_hdr *)p->payload; + iphdr = (struct ip_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR); +#if ETHARP_SUPPORT_VLAN + if (ethhdr->type == PP_HTONS(ETHTYPE_VLAN)) { + iphdr = (struct ip_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR); + } +#endif /* ETHARP_SUPPORT_VLAN */ + + ip4_addr_copy(iphdr_src, iphdr->src); + + /* source is not on the local network? */ + if (!ip4_addr_netcmp(&iphdr_src, netif_ip4_addr(netif), netif_ip4_netmask(netif))) { + /* do nothing */ + return; + } + + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_ip_input: updating ETHARP table.\n")); + /* update the source IP address in the cache, if present */ + /* @todo We could use ETHARP_FLAG_TRY_HARD if we think we are going to talk + * back soon (for example, if the destination IP address is ours. */ + etharp_update_arp_entry(netif, &iphdr_src, &(ethhdr->src), ETHARP_FLAG_FIND_ONLY); +} +#endif /* ETHARP_TRUST_IP_MAC */ + +/** + * Responds to ARP requests to us. Upon ARP replies to us, add entry to cache + * send out queued IP packets. Updates cache with snooped address pairs. + * + * Should be called for incoming ARP packets. The pbuf in the argument + * is freed by this function. + * + * @param netif The lwIP network interface on which the ARP packet pbuf arrived. + * @param ethaddr Ethernet address of netif. + * @param p The ARP packet that arrived on netif. Is freed by this function. + * + * @return NULL + * + * @see pbuf_free() + */ +void +etharp_arp_input(struct netif *netif, struct eth_addr *ethaddr, struct pbuf *p) +{ + struct etharp_hdr *hdr; + struct eth_hdr *ethhdr; + /* these are aligned properly, whereas the ARP header fields might not be */ + ip4_addr_t sipaddr, dipaddr; + u8_t for_us; +#if LWIP_AUTOIP + const u8_t * ethdst_hwaddr; +#endif /* LWIP_AUTOIP */ + + LWIP_ERROR("netif != NULL", (netif != NULL), return;); + + /* drop short ARP packets: we have to check for p->len instead of p->tot_len here + since a struct etharp_hdr is pointed to p->payload, so it musn't be chained! */ + if (p->len < SIZEOF_ETHARP_PACKET) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("etharp_arp_input: packet dropped, too short (%"S16_F"/%"S16_F")\n", p->tot_len, + (s16_t)SIZEOF_ETHARP_PACKET)); + ETHARP_STATS_INC(etharp.lenerr); + ETHARP_STATS_INC(etharp.drop); + pbuf_free(p); + return; + } + + ethhdr = (struct eth_hdr *)p->payload; + hdr = (struct etharp_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR); +#if ETHARP_SUPPORT_VLAN + if (ethhdr->type == PP_HTONS(ETHTYPE_VLAN)) { + hdr = (struct etharp_hdr *)(((u8_t*)ethhdr) + SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR); + } +#endif /* ETHARP_SUPPORT_VLAN */ + + /* RFC 826 "Packet Reception": */ + if ((hdr->hwtype != PP_HTONS(HWTYPE_ETHERNET)) || + (hdr->hwlen != ETH_HWADDR_LEN) || + (hdr->protolen != sizeof(ip4_addr_t)) || + (hdr->proto != PP_HTONS(ETHTYPE_IP))) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("etharp_arp_input: packet dropped, wrong hw type, hwlen, proto, protolen or ethernet type (%"U16_F"/%"U16_F"/%"U16_F"/%"U16_F")\n", + hdr->hwtype, hdr->hwlen, hdr->proto, hdr->protolen)); + ETHARP_STATS_INC(etharp.proterr); + ETHARP_STATS_INC(etharp.drop); + pbuf_free(p); + return; + } + ETHARP_STATS_INC(etharp.recv); + +#if LWIP_AUTOIP + /* We have to check if a host already has configured our random + * created link local address and continuously check if there is + * a host with this IP-address so we can detect collisions */ + autoip_arp_reply(netif, hdr); +#endif /* LWIP_AUTOIP */ + + /* Copy struct ip4_addr2 to aligned ip4_addr, to support compilers without + * structure packing (not using structure copy which breaks strict-aliasing rules). */ + IPADDR2_COPY(&sipaddr, &hdr->sipaddr); + IPADDR2_COPY(&dipaddr, &hdr->dipaddr); + + /* this interface is not configured? */ + if (ip4_addr_isany_val(*netif_ip4_addr(netif))) { + for_us = 0; + } else { + /* ARP packet directed to us? */ + for_us = (u8_t)ip4_addr_cmp(&dipaddr, netif_ip4_addr(netif)); + } + + /* ARP message directed to us? + -> add IP address in ARP cache; assume requester wants to talk to us, + can result in directly sending the queued packets for this host. + ARP message not directed to us? + -> update the source IP address in the cache, if present */ + etharp_update_arp_entry(netif, &sipaddr, &(hdr->shwaddr), + for_us ? ETHARP_FLAG_TRY_HARD : ETHARP_FLAG_FIND_ONLY); + + /* now act on the message itself */ + switch (hdr->opcode) { + /* ARP request? */ + case PP_HTONS(ARP_REQUEST): + /* ARP request. If it asked for our address, we send out a + * reply. In any case, we time-stamp any existing ARP entry, + * and possibly send out an IP packet that was queued on it. */ + + LWIP_DEBUGF (ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: incoming ARP request\n")); + /* ARP request for our address? */ + if (for_us) { + + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: replying to ARP request for our IP address\n")); + /* Re-use pbuf to send ARP reply. + Since we are re-using an existing pbuf, we can't call etharp_raw since + that would allocate a new pbuf. */ + hdr->opcode = htons(ARP_REPLY); + + IPADDR2_COPY(&hdr->dipaddr, &hdr->sipaddr); + IPADDR2_COPY(&hdr->sipaddr, netif_ip4_addr(netif)); + + LWIP_ASSERT("netif->hwaddr_len must be the same as ETH_HWADDR_LEN for etharp!", + (netif->hwaddr_len == ETH_HWADDR_LEN)); +#if LWIP_AUTOIP + /* If we are using Link-Local, all ARP packets that contain a Link-Local + * 'sender IP address' MUST be sent using link-layer broadcast instead of + * link-layer unicast. (See RFC3927 Section 2.5, last paragraph) */ + ethdst_hwaddr = ip4_addr_islinklocal(netif_ip4_addr(netif)) ? (const u8_t*)(ethbroadcast.addr) : hdr->shwaddr.addr; +#endif /* LWIP_AUTOIP */ + + ETHADDR16_COPY(&hdr->dhwaddr, &hdr->shwaddr); +#if LWIP_AUTOIP + ETHADDR16_COPY(ðhdr->dest, ethdst_hwaddr); +#else /* LWIP_AUTOIP */ + ETHADDR16_COPY(ðhdr->dest, &hdr->shwaddr); +#endif /* LWIP_AUTOIP */ + ETHADDR16_COPY(&hdr->shwaddr, ethaddr); + ETHADDR16_COPY(ðhdr->src, ethaddr); + + /* hwtype, hwaddr_len, proto, protolen and the type in the ethernet header + are already correct, we tested that before */ + + /* return ARP reply */ + netif->linkoutput(netif, p); + /* we are not configured? */ + } else if (ip4_addr_isany_val(*netif_ip4_addr(netif))) { + /* { for_us == 0 and netif->ip_addr.addr == 0 } */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: we are unconfigured, ARP request ignored.\n")); + /* request was not directed to us */ + } else { + /* { for_us == 0 and netif->ip_addr.addr != 0 } */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: ARP request was not for us.\n")); + } + break; + case PP_HTONS(ARP_REPLY): + /* ARP reply. We already updated the ARP cache earlier. */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: incoming ARP reply\n")); +#if (LWIP_DHCP && DHCP_DOES_ARP_CHECK) + /* DHCP wants to know about ARP replies from any host with an + * IP address also offered to us by the DHCP server. We do not + * want to take a duplicate IP address on a single network. + * @todo How should we handle redundant (fail-over) interfaces? */ + dhcp_arp_reply(netif, &sipaddr); +#endif /* (LWIP_DHCP && DHCP_DOES_ARP_CHECK) */ + break; + default: + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_arp_input: ARP unknown opcode type %"S16_F"\n", htons(hdr->opcode))); + ETHARP_STATS_INC(etharp.err); + break; + } + /* free ARP packet */ + pbuf_free(p); +} + +/** Just a small helper function that sends a pbuf to an ethernet address + * in the arp_table specified by the index 'arp_idx'. + */ +static err_t +etharp_output_to_arp_index(struct netif *netif, struct pbuf *q, u8_t arp_idx) +{ + LWIP_ASSERT("arp_table[arp_idx].state >= ETHARP_STATE_STABLE", + arp_table[arp_idx].state >= ETHARP_STATE_STABLE); + /* if arp table entry is about to expire: re-request it, + but only if its state is ETHARP_STATE_STABLE to prevent flooding the + network with ARP requests if this address is used frequently. */ + if (arp_table[arp_idx].state == ETHARP_STATE_STABLE) { + if (arp_table[arp_idx].ctime >= ARP_AGE_REREQUEST_USED_BROADCAST) { + /* issue a standard request using broadcast */ + if (etharp_request(netif, &arp_table[arp_idx].ipaddr) == ERR_OK) { + arp_table[arp_idx].state = ETHARP_STATE_STABLE_REREQUESTING_1; + } + } else if (arp_table[arp_idx].ctime >= ARP_AGE_REREQUEST_USED_UNICAST) { + /* issue a unicast request (for 15 seconds) to prevent unnecessary broadcast */ + if (etharp_request_dst(netif, &arp_table[arp_idx].ipaddr, &arp_table[arp_idx].ethaddr) == ERR_OK) { + arp_table[arp_idx].state = ETHARP_STATE_STABLE_REREQUESTING_1; + } + } + } + + return etharp_send_ip(netif, q, (struct eth_addr*)(netif->hwaddr), + &arp_table[arp_idx].ethaddr); +} + +/** + * Resolve and fill-in Ethernet address header for outgoing IP packet. + * + * For IP multicast and broadcast, corresponding Ethernet addresses + * are selected and the packet is transmitted on the link. + * + * For unicast addresses, the packet is submitted to etharp_query(). In + * case the IP address is outside the local network, the IP address of + * the gateway is used. + * + * @param netif The lwIP network interface which the IP packet will be sent on. + * @param q The pbuf(s) containing the IP packet to be sent. + * @param ipaddr The IP address of the packet destination. + * + * @return + * - ERR_RTE No route to destination (no gateway to external networks), + * or the return type of either etharp_query() or etharp_send_ip(). + */ +err_t +etharp_output(struct netif *netif, struct pbuf *q, const ip4_addr_t *ipaddr) +{ + const struct eth_addr *dest; + struct eth_addr mcastaddr; + const ip4_addr_t *dst_addr = ipaddr; + + LWIP_ASSERT("netif != NULL", netif != NULL); + LWIP_ASSERT("q != NULL", q != NULL); + LWIP_ASSERT("ipaddr != NULL", ipaddr != NULL); + + /* make room for Ethernet header - should not fail */ +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + if (pbuf_header(q, sizeof(struct eth_hdr) + SIZEOF_VLAN_HDR) != 0) { +#else /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + if (pbuf_header(q, sizeof(struct eth_hdr)) != 0) { +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + /* bail out */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("etharp_output: could not allocate room for header.\n")); + LINK_STATS_INC(link.lenerr); + return ERR_BUF; + } + + /* Determine on destination hardware address. Broadcasts and multicasts + * are special, other IP addresses are looked up in the ARP table. */ + + /* broadcast destination IP address? */ + if (ip4_addr_isbroadcast(ipaddr, netif)) { + /* broadcast on Ethernet also */ + dest = (const struct eth_addr *)ðbroadcast; + /* multicast destination IP address? */ + } else if (ip4_addr_ismulticast(ipaddr)) { + /* Hash IP multicast address to MAC address.*/ + mcastaddr.addr[0] = LL_IP4_MULTICAST_ADDR_0; + mcastaddr.addr[1] = LL_IP4_MULTICAST_ADDR_1; + mcastaddr.addr[2] = LL_IP4_MULTICAST_ADDR_2; + mcastaddr.addr[3] = ip4_addr2(ipaddr) & 0x7f; + mcastaddr.addr[4] = ip4_addr3(ipaddr); + mcastaddr.addr[5] = ip4_addr4(ipaddr); + /* destination Ethernet address is multicast */ + dest = &mcastaddr; + /* unicast destination IP address? */ + } else { + s8_t i; + /* outside local network? if so, this can neither be a global broadcast nor + a subnet broadcast. */ + if (!ip4_addr_netcmp(ipaddr, netif_ip4_addr(netif), netif_ip4_netmask(netif)) && + !ip4_addr_islinklocal(ipaddr)) { +#if LWIP_AUTOIP + struct ip_hdr *iphdr = (struct ip_hdr*)((u8_t*)q->payload + +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + SIZEOF_VLAN_HDR + +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + sizeof(struct eth_hdr)); + /* According to RFC 3297, chapter 2.6.2 (Forwarding Rules), a packet with + a link-local source address must always be "directly to its destination + on the same physical link. The host MUST NOT send the packet to any + router for forwarding". */ + if (!ip4_addr_islinklocal(&iphdr->src)) +#endif /* LWIP_AUTOIP */ + { +#ifdef LWIP_HOOK_ETHARP_GET_GW + /* For advanced routing, a single default gateway might not be enough, so get + the IP address of the gateway to handle the current destination address. */ + dst_addr = LWIP_HOOK_ETHARP_GET_GW(netif, ipaddr); + if (dst_addr == NULL) +#endif /* LWIP_HOOK_ETHARP_GET_GW */ + { + /* interface has default gateway? */ + if (!ip4_addr_isany_val(*netif_ip4_gw(netif))) { + /* send to hardware address of default gateway IP address */ + dst_addr = netif_ip4_gw(netif); + /* no default gateway available */ + } else { + /* no route to destination error (default gateway missing) */ + return ERR_RTE; + } + } + } + } +#if LWIP_NETIF_HWADDRHINT + if (netif->addr_hint != NULL) { + /* per-pcb cached entry was given */ + u8_t etharp_cached_entry = *(netif->addr_hint); + if (etharp_cached_entry < ARP_TABLE_SIZE) { +#endif /* LWIP_NETIF_HWADDRHINT */ + if ((arp_table[etharp_cached_entry].state >= ETHARP_STATE_STABLE) && + (ip4_addr_cmp(dst_addr, &arp_table[etharp_cached_entry].ipaddr))) { + /* the per-pcb-cached entry is stable and the right one! */ + ETHARP_STATS_INC(etharp.cachehit); + return etharp_output_to_arp_index(netif, q, etharp_cached_entry); + } +#if LWIP_NETIF_HWADDRHINT + } + } +#endif /* LWIP_NETIF_HWADDRHINT */ + + /* find stable entry: do this here since this is a critical path for + throughput and etharp_find_entry() is kind of slow */ + for (i = 0; i < ARP_TABLE_SIZE; i++) { + if ((arp_table[i].state >= ETHARP_STATE_STABLE) && + (ip4_addr_cmp(dst_addr, &arp_table[i].ipaddr))) { + /* found an existing, stable entry */ + ETHARP_SET_HINT(netif, i); + return etharp_output_to_arp_index(netif, q, i); + } + } + /* no stable entry found, use the (slower) query function: + queue on destination Ethernet address belonging to ipaddr */ + return etharp_query(netif, dst_addr, q); + } + + /* continuation for multicast/broadcast destinations */ + /* obtain source Ethernet address of the given interface */ + /* send packet directly on the link */ + return etharp_send_ip(netif, q, (struct eth_addr*)(netif->hwaddr), dest); +} + +/** + * Send an ARP request for the given IP address and/or queue a packet. + * + * If the IP address was not yet in the cache, a pending ARP cache entry + * is added and an ARP request is sent for the given address. The packet + * is queued on this entry. + * + * If the IP address was already pending in the cache, a new ARP request + * is sent for the given address. The packet is queued on this entry. + * + * If the IP address was already stable in the cache, and a packet is + * given, it is directly sent and no ARP request is sent out. + * + * If the IP address was already stable in the cache, and no packet is + * given, an ARP request is sent out. + * + * @param netif The lwIP network interface on which ipaddr + * must be queried for. + * @param ipaddr The IP address to be resolved. + * @param q If non-NULL, a pbuf that must be delivered to the IP address. + * q is not freed by this function. + * + * @note q must only be ONE packet, not a packet queue! + * + * @return + * - ERR_BUF Could not make room for Ethernet header. + * - ERR_MEM Hardware address unknown, and no more ARP entries available + * to query for address or queue the packet. + * - ERR_MEM Could not queue packet due to memory shortage. + * - ERR_RTE No route to destination (no gateway to external networks). + * - ERR_ARG Non-unicast address given, those will not appear in ARP cache. + * + */ +err_t +etharp_query(struct netif *netif, const ip4_addr_t *ipaddr, struct pbuf *q) +{ + struct eth_addr * srcaddr = (struct eth_addr *)netif->hwaddr; + err_t result = ERR_MEM; + int is_new_entry = 0; + s8_t i; /* ARP entry index */ + + /* non-unicast address? */ + if (ip4_addr_isbroadcast(ipaddr, netif) || + ip4_addr_ismulticast(ipaddr) || + ip4_addr_isany(ipaddr)) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: will not add non-unicast IP address to ARP cache\n")); + return ERR_ARG; + } + + /* find entry in ARP cache, ask to create entry if queueing packet */ + i = etharp_find_entry(ipaddr, ETHARP_FLAG_TRY_HARD, netif); + + /* could not find or create entry? */ + if (i < 0) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: could not create ARP entry\n")); + if (q) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: packet dropped\n")); + ETHARP_STATS_INC(etharp.memerr); + } + return (err_t)i; + } + + /* mark a fresh entry as pending (we just sent a request) */ + if (arp_table[i].state == ETHARP_STATE_EMPTY) { + is_new_entry = 1; + arp_table[i].state = ETHARP_STATE_PENDING; + /* record network interface for re-sending arp request in etharp_tmr */ + arp_table[i].netif = netif; + } + + /* { i is either a STABLE or (new or existing) PENDING entry } */ + LWIP_ASSERT("arp_table[i].state == PENDING or STABLE", + ((arp_table[i].state == ETHARP_STATE_PENDING) || + (arp_table[i].state >= ETHARP_STATE_STABLE))); + + /* do we have a new entry? or an implicit query request? */ + if (is_new_entry || (q == NULL)) { + /* try to resolve it; send out ARP request */ + result = etharp_request(netif, ipaddr); + if (result != ERR_OK) { + /* ARP request couldn't be sent */ + /* We don't re-send arp request in etharp_tmr, but we still queue packets, + since this failure could be temporary, and the next packet calling + etharp_query again could lead to sending the queued packets. */ + } + if (q == NULL) { + return result; + } + } + + /* packet given? */ + LWIP_ASSERT("q != NULL", q != NULL); + /* stable entry? */ + if (arp_table[i].state >= ETHARP_STATE_STABLE) { + /* we have a valid IP->Ethernet address mapping */ + ETHARP_SET_HINT(netif, i); + /* send the packet */ + result = etharp_send_ip(netif, q, srcaddr, &(arp_table[i].ethaddr)); + /* pending entry? (either just created or already pending */ + } else if (arp_table[i].state == ETHARP_STATE_PENDING) { + /* entry is still pending, queue the given packet 'q' */ + struct pbuf *p; + int copy_needed = 0; + /* IF q includes a PBUF_REF, PBUF_POOL or PBUF_RAM, we have no choice but + * to copy the whole queue into a new PBUF_RAM (see bug #11400) + * PBUF_ROMs can be left as they are, since ROM must not get changed. */ + p = q; + while (p) { + LWIP_ASSERT("no packet queues allowed!", (p->len != p->tot_len) || (p->next == 0)); + if (p->type != PBUF_ROM) { + copy_needed = 1; + break; + } + p = p->next; + } + if (copy_needed) { + /* copy the whole packet into new pbufs */ + p = pbuf_alloc(PBUF_RAW_TX, p->tot_len, PBUF_RAM); + if (p != NULL) { + if (pbuf_copy(p, q) != ERR_OK) { + pbuf_free(p); + p = NULL; + } + } + } else { + /* referencing the old pbuf is enough */ + p = q; + pbuf_ref(p); + } + /* packet could be taken over? */ + if (p != NULL) { + /* queue packet ... */ +#if ARP_QUEUEING + struct etharp_q_entry *new_entry; + /* allocate a new arp queue entry */ + new_entry = (struct etharp_q_entry *)memp_malloc(MEMP_ARP_QUEUE); + if (new_entry != NULL) { + unsigned int qlen = 0; + new_entry->next = 0; + new_entry->p = p; + if (arp_table[i].q != NULL) { + /* queue was already existent, append the new entry to the end */ + struct etharp_q_entry *r; + r = arp_table[i].q; + qlen++; + while (r->next != NULL) { + r = r->next; + qlen++; + } + r->next = new_entry; + } else { + /* queue did not exist, first item in queue */ + arp_table[i].q = new_entry; + } +#if ARP_QUEUE_LEN + if (qlen >= ARP_QUEUE_LEN) { + struct etharp_q_entry *old; + old = arp_table[i].q; + arp_table[i].q = arp_table[i].q->next; + pbuf_free(old->p); + memp_free(MEMP_ARP_QUEUE, old); + } +#endif + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: queued packet %p on ARP entry %"S16_F"\n", (void *)q, (s16_t)i)); + result = ERR_OK; + } else { + /* the pool MEMP_ARP_QUEUE is empty */ + pbuf_free(p); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: could not queue a copy of PBUF_REF packet %p (out of memory)\n", (void *)q)); + result = ERR_MEM; + } +#else /* ARP_QUEUEING */ + /* always queue one packet per ARP request only, freeing a previously queued packet */ + if (arp_table[i].q != NULL) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: dropped previously queued packet %p for ARP entry %"S16_F"\n", (void *)q, (s16_t)i)); + pbuf_free(arp_table[i].q); + } + arp_table[i].q = p; + result = ERR_OK; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: queued packet %p on ARP entry %"S16_F"\n", (void *)q, (s16_t)i)); +#endif /* ARP_QUEUEING */ + } else { + ETHARP_STATS_INC(etharp.memerr); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_query: could not queue a copy of PBUF_REF packet %p (out of memory)\n", (void *)q)); + result = ERR_MEM; + } + } + return result; +} + +/** + * Send a raw ARP packet (opcode and all addresses can be modified) + * + * @param netif the lwip network interface on which to send the ARP packet + * @param ethsrc_addr the source MAC address for the ethernet header + * @param ethdst_addr the destination MAC address for the ethernet header + * @param hwsrc_addr the source MAC address for the ARP protocol header + * @param ipsrc_addr the source IP address for the ARP protocol header + * @param hwdst_addr the destination MAC address for the ARP protocol header + * @param ipdst_addr the destination IP address for the ARP protocol header + * @param opcode the type of the ARP packet + * @return ERR_OK if the ARP packet has been sent + * ERR_MEM if the ARP packet couldn't be allocated + * any other err_t on failure + */ +#if !LWIP_AUTOIP +static +#endif /* LWIP_AUTOIP */ +err_t +etharp_raw(struct netif *netif, const struct eth_addr *ethsrc_addr, + const struct eth_addr *ethdst_addr, + const struct eth_addr *hwsrc_addr, const ip4_addr_t *ipsrc_addr, + const struct eth_addr *hwdst_addr, const ip4_addr_t *ipdst_addr, + const u16_t opcode) +{ + struct pbuf *p; + err_t result = ERR_OK; + struct eth_hdr *ethhdr; +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + struct eth_vlan_hdr *vlanhdr; +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + struct etharp_hdr *hdr; +#if LWIP_AUTOIP + const u8_t * ethdst_hwaddr; +#endif /* LWIP_AUTOIP */ + + LWIP_ASSERT("netif != NULL", netif != NULL); + + /* allocate a pbuf for the outgoing ARP request packet */ + p = pbuf_alloc(PBUF_RAW_TX, SIZEOF_ETHARP_PACKET_TX, PBUF_RAM); + /* could allocate a pbuf for an ARP request? */ + if (p == NULL) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, + ("etharp_raw: could not allocate pbuf for ARP request.\n")); + ETHARP_STATS_INC(etharp.memerr); + return ERR_MEM; + } + LWIP_ASSERT("check that first pbuf can hold struct etharp_hdr", + (p->len >= SIZEOF_ETHARP_PACKET_TX)); + + ethhdr = (struct eth_hdr *)p->payload; +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + vlanhdr = (struct eth_vlan_hdr*)(((u8_t*)ethhdr) + SIZEOF_ETH_HDR); + hdr = (struct etharp_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR); +#else /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + hdr = (struct etharp_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR); +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_raw: sending raw ARP packet.\n")); + hdr->opcode = htons(opcode); + + LWIP_ASSERT("netif->hwaddr_len must be the same as ETH_HWADDR_LEN for etharp!", + (netif->hwaddr_len == ETH_HWADDR_LEN)); +#if LWIP_AUTOIP + /* If we are using Link-Local, all ARP packets that contain a Link-Local + * 'sender IP address' MUST be sent using link-layer broadcast instead of + * link-layer unicast. (See RFC3927 Section 2.5, last paragraph) */ + ethdst_hwaddr = ip4_addr_islinklocal(ipsrc_addr) ? (const u8_t*)(ethbroadcast.addr) : ethdst_addr->addr; +#endif /* LWIP_AUTOIP */ + /* Write the ARP MAC-Addresses */ + ETHADDR16_COPY(&hdr->shwaddr, hwsrc_addr); + ETHADDR16_COPY(&hdr->dhwaddr, hwdst_addr); + /* Copy struct ip4_addr2 to aligned ip4_addr, to support compilers without + * structure packing. */ + IPADDR2_COPY(&hdr->sipaddr, ipsrc_addr); + IPADDR2_COPY(&hdr->dipaddr, ipdst_addr); + + hdr->hwtype = PP_HTONS(HWTYPE_ETHERNET); + hdr->proto = PP_HTONS(ETHTYPE_IP); + /* set hwlen and protolen */ + hdr->hwlen = ETH_HWADDR_LEN; + hdr->protolen = sizeof(ip4_addr_t); + +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + ethhdr->type = PP_HTONS(ETHTYPE_VLAN); + vlanhdr->tpid = PP_HTONS(ETHTYPE_ARP); + vlanhdr->prio_vid = 0; + if (!LWIP_HOOK_VLAN_SET(netif, ethhdr, vlanhdr)) { + /* packet shall not contain VLAN header, so hide it and set correct ethertype */ + pbuf_header(p, -SIZEOF_VLAN_HDR); + ethhdr = (struct eth_hdr *)p->payload; +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + ethhdr->type = PP_HTONS(ETHTYPE_ARP); +#if ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) + } +#endif /* ETHARP_SUPPORT_VLAN && defined(LWIP_HOOK_VLAN_SET) */ + + /* Write the Ethernet MAC-Addresses */ +#if LWIP_AUTOIP + ETHADDR16_COPY(ðhdr->dest, ethdst_hwaddr); +#else /* LWIP_AUTOIP */ + ETHADDR16_COPY(ðhdr->dest, ethdst_addr); +#endif /* LWIP_AUTOIP */ + ETHADDR16_COPY(ðhdr->src, ethsrc_addr); + + /* send ARP query */ + result = netif->linkoutput(netif, p); + ETHARP_STATS_INC(etharp.xmit); + /* free ARP query packet */ + pbuf_free(p); + p = NULL; + /* could not allocate pbuf for ARP request */ + + return result; +} + +/** + * Send an ARP request packet asking for ipaddr to a specific eth address. + * Used to send unicast request to refresh the ARP table just before an entry + * times out + * + * @param netif the lwip network interface on which to send the request + * @param ipaddr the IP address for which to ask + * @param hw_dst_addr the ethernet address to send this packet to + * @return ERR_OK if the request has been sent + * ERR_MEM if the ARP packet couldn't be allocated + * any other err_t on failure + */ +static err_t +etharp_request_dst(struct netif *netif, const ip4_addr_t *ipaddr, const struct eth_addr* hw_dst_addr) +{ + return etharp_raw(netif, (struct eth_addr *)netif->hwaddr, hw_dst_addr, + (struct eth_addr *)netif->hwaddr, netif_ip4_addr(netif), ðzero, + ipaddr, ARP_REQUEST); +} + +/** + * Send an ARP request packet asking for ipaddr. + * + * @param netif the lwip network interface on which to send the request + * @param ipaddr the IP address for which to ask + * @return ERR_OK if the request has been sent + * ERR_MEM if the ARP packet couldn't be allocated + * any other err_t on failure + */ +err_t +etharp_request(struct netif *netif, const ip4_addr_t *ipaddr) +{ + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_request: sending ARP request.\n")); + return etharp_request_dst(netif, ipaddr, ðbroadcast); +} +#endif /* LWIP_IPV4 && LWIP_ARP */ + +#endif /* LWIP_ARP || LWIP_ETHERNET */ diff --git a/components/lwip/netif/ethernet.c b/components/lwip/netif/ethernet.c new file mode 100755 index 000000000..6d843913d --- /dev/null +++ b/components/lwip/netif/ethernet.c @@ -0,0 +1,222 @@ +/** + * @file + * Ethernet common functions + */ + +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * Copyright (c) 2003-2004 Leon Woestenberg + * Copyright (c) 2003-2004 Axon Digital Design B.V., The Netherlands. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" + +#if LWIP_ARP || LWIP_ETHERNET + +#include "netif/ethernet.h" +#include "lwip/def.h" +#include "lwip/stats.h" +#include "netif/etharp.h" +#include "lwip/ip.h" +#include "lwip/snmp.h" + +#include + +#if PPPOE_SUPPORT +#include "netif/ppp/pppoe.h" +#endif /* PPPOE_SUPPORT */ + +const struct eth_addr ethbroadcast = {{0xff,0xff,0xff,0xff,0xff,0xff}}; +const struct eth_addr ethzero = {{0,0,0,0,0,0}}; + +/** + * Process received ethernet frames. Using this function instead of directly + * calling ip_input and passing ARP frames through etharp in ethernetif_input, + * the ARP cache is protected from concurrent access. + * + * @param p the received packet, p->payload pointing to the ethernet header + * @param netif the network interface on which the packet was received + */ +err_t +ethernet_input(struct pbuf *p, struct netif *netif) +{ + struct eth_hdr* ethhdr; + u16_t type; +#if LWIP_ARP || ETHARP_SUPPORT_VLAN || LWIP_IPV6 + s16_t ip_hdr_offset = SIZEOF_ETH_HDR; +#endif /* LWIP_ARP || ETHARP_SUPPORT_VLAN */ + + if (p->len <= SIZEOF_ETH_HDR) { + /* a packet with only an ethernet header (or less) is not valid for us */ + ETHARP_STATS_INC(etharp.proterr); + ETHARP_STATS_INC(etharp.drop); + MIB2_STATS_NETIF_INC(netif, ifinerrors); + goto free_and_return; + } + + /* points to packet payload, which starts with an Ethernet header */ + ethhdr = (struct eth_hdr *)p->payload; + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, + ("ethernet_input: dest:%"X8_F":%"X8_F":%"X8_F":%"X8_F":%"X8_F":%"X8_F", src:%"X8_F":%"X8_F":%"X8_F":%"X8_F":%"X8_F":%"X8_F", type:%"X16_F"\n", + (unsigned)ethhdr->dest.addr[0], (unsigned)ethhdr->dest.addr[1], (unsigned)ethhdr->dest.addr[2], + (unsigned)ethhdr->dest.addr[3], (unsigned)ethhdr->dest.addr[4], (unsigned)ethhdr->dest.addr[5], + (unsigned)ethhdr->src.addr[0], (unsigned)ethhdr->src.addr[1], (unsigned)ethhdr->src.addr[2], + (unsigned)ethhdr->src.addr[3], (unsigned)ethhdr->src.addr[4], (unsigned)ethhdr->src.addr[5], + (unsigned)htons(ethhdr->type))); + + type = ethhdr->type; +#if ETHARP_SUPPORT_VLAN + if (type == PP_HTONS(ETHTYPE_VLAN)) { + struct eth_vlan_hdr *vlan = (struct eth_vlan_hdr*)(((char*)ethhdr) + SIZEOF_ETH_HDR); + if (p->len <= SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR) { + /* a packet with only an ethernet/vlan header (or less) is not valid for us */ + ETHARP_STATS_INC(etharp.proterr); + ETHARP_STATS_INC(etharp.drop); + MIB2_STATS_NETIF_INC(netif, ifinerrors); + goto free_and_return; + } +#if defined(LWIP_HOOK_VLAN_CHECK) || defined(ETHARP_VLAN_CHECK) || defined(ETHARP_VLAN_CHECK_FN) /* if not, allow all VLANs */ +#ifdef LWIP_HOOK_VLAN_CHECK + if (!LWIP_HOOK_VLAN_CHECK(netif, ethhdr, vlan)) { +#elif defined(ETHARP_VLAN_CHECK_FN) + if (!ETHARP_VLAN_CHECK_FN(ethhdr, vlan)) { +#elif defined(ETHARP_VLAN_CHECK) + if (VLAN_ID(vlan) != ETHARP_VLAN_CHECK) { +#endif + /* silently ignore this packet: not for our VLAN */ + pbuf_free(p); + return ERR_OK; + } +#endif /* defined(LWIP_HOOK_VLAN_CHECK) || defined(ETHARP_VLAN_CHECK) || defined(ETHARP_VLAN_CHECK_FN) */ + type = vlan->tpid; + ip_hdr_offset = SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR; + } +#endif /* ETHARP_SUPPORT_VLAN */ + +#if LWIP_ARP_FILTER_NETIF + netif = LWIP_ARP_FILTER_NETIF_FN(p, netif, htons(type)); +#endif /* LWIP_ARP_FILTER_NETIF*/ + + if (ethhdr->dest.addr[0] & 1) { + /* this might be a multicast or broadcast packet */ + if (ethhdr->dest.addr[0] == LL_IP4_MULTICAST_ADDR_0) { +#if LWIP_IPV4 + if ((ethhdr->dest.addr[1] == LL_IP4_MULTICAST_ADDR_1) && + (ethhdr->dest.addr[2] == LL_IP4_MULTICAST_ADDR_2)) { + /* mark the pbuf as link-layer multicast */ + p->flags |= PBUF_FLAG_LLMCAST; + } +#endif /* LWIP_IPV4 */ + } +#if LWIP_IPV6 + else if ((ethhdr->dest.addr[0] == LL_IP6_MULTICAST_ADDR_0) && + (ethhdr->dest.addr[1] == LL_IP6_MULTICAST_ADDR_1)) { + /* mark the pbuf as link-layer multicast */ + p->flags |= PBUF_FLAG_LLMCAST; + } +#endif /* LWIP_IPV6 */ + else if (eth_addr_cmp(ðhdr->dest, ðbroadcast)) { + /* mark the pbuf as link-layer broadcast */ + p->flags |= PBUF_FLAG_LLBCAST; + } + } + + switch (type) { +#if LWIP_IPV4 && LWIP_ARP + /* IP packet? */ + case PP_HTONS(ETHTYPE_IP): + if (!(netif->flags & NETIF_FLAG_ETHARP)) { + goto free_and_return; + } +#if ETHARP_TRUST_IP_MAC + /* update ARP table */ + etharp_ip_input(netif, p); +#endif /* ETHARP_TRUST_IP_MAC */ + /* skip Ethernet header */ + if ((p->len < ip_hdr_offset) || pbuf_header(p, (s16_t)-ip_hdr_offset)) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("ethernet_input: IPv4 packet dropped, too short (%"S16_F"/%"S16_F")\n", + p->tot_len, ip_hdr_offset)); + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("Can't move over header in packet")); + goto free_and_return; + } else { + /* pass to IP layer */ + ip4_input(p, netif); + } + break; + + case PP_HTONS(ETHTYPE_ARP): + if (!(netif->flags & NETIF_FLAG_ETHARP)) { + goto free_and_return; + } + /* pass p to ARP module */ + etharp_arp_input(netif, (struct eth_addr*)(netif->hwaddr), p); + break; +#endif /* LWIP_IPV4 && LWIP_ARP */ +#if PPPOE_SUPPORT + case PP_HTONS(ETHTYPE_PPPOEDISC): /* PPP Over Ethernet Discovery Stage */ + pppoe_disc_input(netif, p); + break; + + case PP_HTONS(ETHTYPE_PPPOE): /* PPP Over Ethernet Session Stage */ + pppoe_data_input(netif, p); + break; +#endif /* PPPOE_SUPPORT */ + +#if LWIP_IPV6 + case PP_HTONS(ETHTYPE_IPV6): /* IPv6 */ + /* skip Ethernet header */ + if ((p->len < ip_hdr_offset) || pbuf_header(p, (s16_t)-ip_hdr_offset)) { + LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, + ("ethernet_input: IPv6 packet dropped, too short (%"S16_F"/%"S16_F")\n", + p->tot_len, ip_hdr_offset)); + goto free_and_return; + } else { + /* pass to IPv6 layer */ + ip6_input(p, netif); + } + break; +#endif /* LWIP_IPV6 */ + + default: + ETHARP_STATS_INC(etharp.proterr); + ETHARP_STATS_INC(etharp.drop); + MIB2_STATS_NETIF_INC(netif, ifinunknownprotos); + goto free_and_return; + } + + /* This means the pbuf is freed or consumed, + so the caller doesn't have to free it again */ + return ERR_OK; + +free_and_return: + pbuf_free(p); + return ERR_OK; +} +#endif /* LWIP_ARP || LWIP_ETHERNET */ diff --git a/components/lwip/netif/ethernetif.c b/components/lwip/netif/ethernetif.c new file mode 100755 index 000000000..b42483878 --- /dev/null +++ b/components/lwip/netif/ethernetif.c @@ -0,0 +1,339 @@ +/** + * @file + * Ethernet Interface Skeleton + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +/* + * This file is a skeleton for developing Ethernet network interface + * drivers for lwIP. Add code to the low_level functions and do a + * search-and-replace for the word "ethernetif" to replace it with + * something that better describes your network interface. + */ + +#include "lwip/opt.h" + +#if 0 /* don't build, this is only a skeleton, see previous comment */ + +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/pbuf.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" +#include "lwip/ethip6.h" +#include "netif/etharp.h" +#include "netif/ppp/pppoe.h" + +/* Define those to better describe your network interface. */ +#define IFNAME0 'e' +#define IFNAME1 'n' + +/** + * Helper struct to hold private data used to operate your ethernet interface. + * Keeping the ethernet address of the MAC in this struct is not necessary + * as it is already kept in the struct netif. + * But this is only an example, anyway... + */ +struct ethernetif { + struct eth_addr *ethaddr; + /* Add whatever per-interface state that is needed here. */ +}; + +/* Forward declarations. */ +static void ethernetif_input(struct netif *netif); + +/** + * In this function, the hardware should be initialized. + * Called from ethernetif_init(). + * + * @param netif the already initialized lwip network interface structure + * for this ethernetif + */ +static void +low_level_init(struct netif *netif) +{ + struct ethernetif *ethernetif = netif->state; + + /* set MAC hardware address length */ + netif->hwaddr_len = ETHARP_HWADDR_LEN; + + /* set MAC hardware address */ + netif->hwaddr[0] = ; + ... + netif->hwaddr[5] = ; + + /* maximum transfer unit */ + netif->mtu = 1500; + + /* device capabilities */ + /* don't set NETIF_FLAG_ETHARP if this device is not an ethernet one */ + netif->flags = NETIF_FLAG_BROADCAST | NETIF_FLAG_ETHARP | NETIF_FLAG_LINK_UP; + +#if LWIP_IGMP + netif->flags |= NETIF_FLAG_IGMP; +#endif + +#if LWIP_IPV6 && LWIP_IPV6_MLD + /* + * For hardware/netifs that implement MAC filtering. + * All-nodes link-local is handled by default, so we must let the hardware know + * to allow multicast packets in. + * Should set mld_mac_filter previously. */ + if (netif->mld_mac_filter != NULL) { + ip6_addr_t ip6_allnodes_ll; + ip6_addr_set_allnodes_linklocal(&ip6_allnodes_ll); + netif->mld_mac_filter(netif, &ip6_allnodes_ll, MLD6_ADD_MAC_FILTER); + } +#endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ + + /* Do whatever else is needed to initialize interface. */ +} + +/** + * This function should do the actual transmission of the packet. The packet is + * contained in the pbuf that is passed to the function. This pbuf + * might be chained. + * + * @param netif the lwip network interface structure for this ethernetif + * @param p the MAC packet to send (e.g. IP packet including MAC addresses and type) + * @return ERR_OK if the packet could be sent + * an err_t value if the packet couldn't be sent + * + * @note Returning ERR_MEM here if a DMA queue of your MAC is full can lead to + * strange results. You might consider waiting for space in the DMA queue + * to become available since the stack doesn't retry to send a packet + * dropped because of memory failure (except for the TCP timers). + */ + +static err_t +low_level_output(struct netif *netif, struct pbuf *p) +{ + struct ethernetif *ethernetif = netif->state; + struct pbuf *q; + + initiate transfer(); + +#if ETH_PAD_SIZE + pbuf_header(p, -ETH_PAD_SIZE); /* drop the padding word */ +#endif + + for (q = p; q != NULL; q = q->next) { + /* Send the data from the pbuf to the interface, one pbuf at a + time. The size of the data in each pbuf is kept in the ->len + variable. */ + send data from(q->payload, q->len); + } + + signal that packet should be sent(); + +#if ETH_PAD_SIZE + pbuf_header(p, ETH_PAD_SIZE); /* reclaim the padding word */ +#endif + + LINK_STATS_INC(link.xmit); + + return ERR_OK; +} + +/** + * Should allocate a pbuf and transfer the bytes of the incoming + * packet from the interface into the pbuf. + * + * @param netif the lwip network interface structure for this ethernetif + * @return a pbuf filled with the received packet (including MAC header) + * NULL on memory error + */ +static struct pbuf * +low_level_input(struct netif *netif) +{ + struct ethernetif *ethernetif = netif->state; + struct pbuf *p, *q; + u16_t len; + + /* Obtain the size of the packet and put it into the "len" + variable. */ + len = ; + +#if ETH_PAD_SIZE + len += ETH_PAD_SIZE; /* allow room for Ethernet padding */ +#endif + + /* We allocate a pbuf chain of pbufs from the pool. */ + p = pbuf_alloc(PBUF_RAW, len, PBUF_POOL); + + if (p != NULL) { + +#if ETH_PAD_SIZE + pbuf_header(p, -ETH_PAD_SIZE); /* drop the padding word */ +#endif + + /* We iterate over the pbuf chain until we have read the entire + * packet into the pbuf. */ + for (q = p; q != NULL; q = q->next) { + /* Read enough bytes to fill this pbuf in the chain. The + * available data in the pbuf is given by the q->len + * variable. + * This does not necessarily have to be a memcpy, you can also preallocate + * pbufs for a DMA-enabled MAC and after receiving truncate it to the + * actually received size. In this case, ensure the tot_len member of the + * pbuf is the sum of the chained pbuf len members. + */ + read data into(q->payload, q->len); + } + acknowledge that packet has been read(); + +#if ETH_PAD_SIZE + pbuf_header(p, ETH_PAD_SIZE); /* reclaim the padding word */ +#endif + + LINK_STATS_INC(link.recv); + } else { + drop packet(); + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + } + + return p; +} + +/** + * This function should be called when a packet is ready to be read + * from the interface. It uses the function low_level_input() that + * should handle the actual reception of bytes from the network + * interface. Then the type of the received packet is determined and + * the appropriate input function is called. + * + * @param netif the lwip network interface structure for this ethernetif + */ +static void +ethernetif_input(struct netif *netif) +{ + struct ethernetif *ethernetif; + struct eth_hdr *ethhdr; + struct pbuf *p; + + ethernetif = netif->state; + + /* move received packet into a new pbuf */ + p = low_level_input(netif); + /* no packet could be read, silently ignore this */ + if (p == NULL) return; + /* points to packet payload, which starts with an Ethernet header */ + ethhdr = p->payload; + + switch (htons(ethhdr->type)) { + /* IP or ARP packet? */ + case ETHTYPE_IP: + case ETHTYPE_IPV6: + case ETHTYPE_ARP: +#if PPPOE_SUPPORT + /* PPPoE packet? */ + case ETHTYPE_PPPOEDISC: + case ETHTYPE_PPPOE: +#endif /* PPPOE_SUPPORT */ + /* full packet send to tcpip_thread to process */ + if (netif->input(p, netif)!=ERR_OK) + { LWIP_DEBUGF(NETIF_DEBUG, ("ethernetif_input: IP input error\n")); + pbuf_free(p); + p = NULL; + } + break; + + default: + pbuf_free(p); + p = NULL; + break; + } +} + +/** + * Should be called at the beginning of the program to set up the + * network interface. It calls the function low_level_init() to do the + * actual setup of the hardware. + * + * This function should be passed as a parameter to netif_add(). + * + * @param netif the lwip network interface structure for this ethernetif + * @return ERR_OK if the loopif is initialized + * ERR_MEM if private data couldn't be allocated + * any other err_t on error + */ +err_t +ethernetif_init(struct netif *netif) +{ + struct ethernetif *ethernetif; + + LWIP_ASSERT("netif != NULL", (netif != NULL)); + + ethernetif = mem_malloc(sizeof(struct ethernetif)); + if (ethernetif == NULL) { + LWIP_DEBUGF(NETIF_DEBUG, ("ethernetif_init: out of memory\n")); + return ERR_MEM; + } + +#if LWIP_NETIF_HOSTNAME + /* Initialize interface hostname */ + netif->hostname = "lwip"; +#endif /* LWIP_NETIF_HOSTNAME */ + + /* + * Initialize the snmp variables and counters inside the struct netif. + * The last argument should be replaced with your link speed, in units + * of bits per second. + */ + MIB2_INIT_NETIF(netif, snmp_ifType_ethernet_csmacd, LINK_SPEED_OF_YOUR_NETIF_IN_BPS); + + netif->state = ethernetif; + netif->name[0] = IFNAME0; + netif->name[1] = IFNAME1; + /* We directly use etharp_output() here to save a function call. + * You can instead declare your own function an call etharp_output() + * from it if you have to do some checks before sending (e.g. if link + * is available...) */ + netif->output = etharp_output; +#if LWIP_IPV6 + netif->output_ip6 = ethip6_output; +#endif /* LWIP_IPV6 */ + netif->linkoutput = low_level_output; + + ethernetif->ethaddr = (struct eth_addr *)&(netif->hwaddr[0]); + + /* initialize the hardware */ + low_level_init(netif); + + return ERR_OK; +} + +#endif /* 0 */ diff --git a/components/lwip/netif/lowpan6.c b/components/lwip/netif/lowpan6.c new file mode 100755 index 000000000..15d10278f --- /dev/null +++ b/components/lwip/netif/lowpan6.c @@ -0,0 +1,1196 @@ +/** + * @file + * + * 6LowPAN output for IPv6. Uses ND tables for link-layer addressing. Fragments packets to 6LowPAN units. + */ + +/* + * Copyright (c) 2015 Inico Technologies Ltd. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Ivan Delamer + * + * + * Please coordinate changes and requests with Ivan Delamer + * + */ + +#include "netif/lowpan6.h" + +#if LWIP_IPV6 && LWIP_6LOWPAN + +#include "lwip/ip.h" +#include "lwip/pbuf.h" +#include "lwip/ip_addr.h" +#include "lwip/netif.h" +#include "lwip/nd6.h" +#include "lwip/mem.h" +#include "lwip/udp.h" +#include "lwip/tcpip.h" +#include "lwip/snmp.h" + +#include + +struct ieee_802154_addr { + u8_t addr_len; + u8_t addr[8]; +}; + +/** This is a helper struct. + */ +struct lowpan6_reass_helper { + struct pbuf *pbuf; + struct lowpan6_reass_helper *next_packet; + u8_t timer; + struct ieee_802154_addr sender_addr; + u16_t datagram_size; + u16_t datagram_tag; +}; + +static struct lowpan6_reass_helper * reass_list; + +#if LWIP_6LOWPAN_NUM_CONTEXTS > 0 +static ip6_addr_t lowpan6_context[LWIP_6LOWPAN_NUM_CONTEXTS]; +#endif + +static u16_t ieee_802154_pan_id; + +static const struct ieee_802154_addr ieee_802154_broadcast = {2, {0xff, 0xff}}; + +#if LWIP_6LOWPAN_INFER_SHORT_ADDRESS +static struct ieee_802154_addr short_mac_addr = {2, {0,0}}; +#endif /* LWIP_6LOWPAN_INFER_SHORT_ADDRESS */ + +static err_t dequeue_datagram(struct lowpan6_reass_helper *lrh); + +/** + * Periodic timer for 6LowPAN functions: + * + * - Remove incomplete/old packets + */ +void +lowpan6_tmr(void) +{ + struct lowpan6_reass_helper *lrh, *lrh_temp; + + lrh = reass_list; + while (lrh != NULL) { + lrh_temp = lrh->next_packet; + if ((--lrh->timer) == 0) { + dequeue_datagram(lrh); + pbuf_free(lrh->pbuf); + mem_free(lrh); + } + lrh = lrh_temp; + } +} + +/** + * Removes a datagram from the reassembly queue. + **/ +static err_t +dequeue_datagram(struct lowpan6_reass_helper *lrh) +{ + struct lowpan6_reass_helper *lrh_temp; + + if (reass_list == lrh) { + reass_list = reass_list->next_packet; + } else { + lrh_temp = reass_list; + while (lrh_temp != NULL) { + if (lrh_temp->next_packet == lrh) { + lrh_temp->next_packet = lrh->next_packet; + break; + } + lrh_temp = lrh_temp->next_packet; + } + } + + return ERR_OK; +} + +static s8_t +lowpan6_context_lookup(const ip6_addr_t *ip6addr) +{ + s8_t i; + + for (i = 0; i < LWIP_6LOWPAN_NUM_CONTEXTS; i++) { + if (ip6_addr_netcmp(&lowpan6_context[i], ip6addr)) { + return i; + } + } + + return -1; +} + +/* Determine compression mode for unicast address. */ +static s8_t +lowpan6_get_address_mode(const ip6_addr_t *ip6addr, const struct ieee_802154_addr *mac_addr) +{ + if (mac_addr->addr_len == 2) { + if ((ip6addr->addr[2] == (u32_t)PP_HTONL(0x000000ff)) && + ((ip6addr->addr[3] & PP_HTONL(0xffff0000)) == PP_NTOHL(0xfe000000))) { + if ((ip6addr->addr[3] & PP_HTONL(0x0000ffff)) == ntohl((mac_addr->addr[0] << 8) | mac_addr->addr[1])) { + return 3; + } + } + } else if (mac_addr->addr_len == 8) { + if ((ip6addr->addr[2] == ntohl(((mac_addr->addr[0] ^ 2) << 24) | (mac_addr->addr[1] << 16) | mac_addr->addr[2] << 8 | mac_addr->addr[3])) && + (ip6addr->addr[3] == ntohl((mac_addr->addr[4] << 24) | (mac_addr->addr[5] << 16) | mac_addr->addr[6] << 8 | mac_addr->addr[7]))) { + return 3; + } + } + + if ((ip6addr->addr[2] == PP_HTONL(0x000000ffUL)) && + ((ip6addr->addr[3] & PP_HTONL(0xffff0000)) == PP_NTOHL(0xfe000000UL))) { + return 2; + } + + return 1; +} + +/* Determine compression mode for multicast address. */ +static s8_t +lowpan6_get_address_mode_mc(const ip6_addr_t *ip6addr) +{ + if ((ip6addr->addr[0] == PP_HTONL(0xff020000)) && + (ip6addr->addr[1] == 0) && + (ip6addr->addr[2] == 0) && + ((ip6addr->addr[3] & PP_HTONL(0xffffff00)) == 0)) { + return 3; + } else if (((ip6addr->addr[0] & PP_HTONL(0xff00ffff)) == PP_HTONL(0xff000000)) && + (ip6addr->addr[1] == 0)) { + if ((ip6addr->addr[2] == 0) && + ((ip6addr->addr[3] & PP_HTONL(0xff000000)) == 0)) { + return 2; + } else if ((ip6addr->addr[2] & PP_HTONL(0xffffff00)) == 0) { + return 1; + } + } + + return 0; +} + +/* + * Encapsulates data into IEEE 802.15.4 frames. + * Fragments an IPv6 datagram into 6LowPAN units, which fit into IEEE 802.15.4 frames. + * If configured, will compress IPv6 and or UDP headers. + * */ +static err_t +lowpan6_frag(struct netif *netif, struct pbuf *p, const struct ieee_802154_addr *src, const struct ieee_802154_addr *dst) +{ + struct pbuf * p_frag; + u16_t frag_len, remaining_len; + u8_t * buffer; + u8_t ieee_header_len; + u8_t lowpan6_header_len; + s8_t i; + static u8_t frame_seq_num; + static u16_t datagram_tag; + u16_t datagram_offset; + err_t err = ERR_IF; + + /* We'll use a dedicated pbuf for building 6LowPAN fragments. */ + p_frag = pbuf_alloc(PBUF_RAW, 127, PBUF_RAM); + if (p_frag == NULL) { + MIB2_STATS_NETIF_INC(netif, ifoutdiscards); + return ERR_MEM; + } + + /* Write IEEE 802.15.4 header. */ + buffer = (u8_t*)p_frag->payload; + ieee_header_len = 0; + if (dst == &ieee_802154_broadcast) { + buffer[ieee_header_len++] = 0x01; /* data packet, no ack required. */ + } else { + buffer[ieee_header_len++] = 0x21; /* data packet, ack required. */ + } + buffer[ieee_header_len] = (0x00 << 4); /* 2003 frame version */ + buffer[ieee_header_len] |= (dst->addr_len == 2) ? (0x02 << 2) : (0x03 << 2); /* destination addressing mode */ + buffer[ieee_header_len] |= (src->addr_len == 2) ? (0x02 << 6) : (0x03 << 6); /* source addressing mode */ + ieee_header_len++; + buffer[ieee_header_len++] = frame_seq_num++; + + buffer[ieee_header_len++] = ieee_802154_pan_id & 0xff; /* pan id */ + buffer[ieee_header_len++] = (ieee_802154_pan_id >> 8) & 0xff; /* pan id */ + i = dst->addr_len; + while (i-- > 0) { + buffer[ieee_header_len++] = dst->addr[i]; + } + + buffer[ieee_header_len++] = ieee_802154_pan_id & 0xff; /* pan id */ + buffer[ieee_header_len++] = (ieee_802154_pan_id >> 8) & 0xff; /* pan id */ + i = src->addr_len; + while (i-- > 0) { + buffer[ieee_header_len++] = src->addr[i]; + } + +#if LWIP_6LOWPAN_IPHC + /* Perform 6LowPAN IPv6 header compression according to RFC 6282 */ + { + struct ip6_hdr *ip6hdr; + + /* Point to ip6 header and align copies of src/dest addresses. */ + ip6hdr = (struct ip6_hdr *)p->payload; + ip_addr_copy_from_ip6(ip_data.current_iphdr_dest, ip6hdr->dest); + ip_addr_copy_from_ip6(ip_data.current_iphdr_src, ip6hdr->src); + + /* Basic length of 6LowPAN header, set dispatch and clear fields. */ + lowpan6_header_len = 2; + buffer[ieee_header_len] = 0x60; + buffer[ieee_header_len + 1] = 0; + + /* Determine whether there will be a Context Identifier Extension byte or not. + * If so, set it already. */ +#if LWIP_6LOWPAN_NUM_CONTEXTS > 0 + buffer[ieee_header_len + 2] = 0; + + i = lowpan6_context_lookup(ip_2_ip6(&ip_data.current_iphdr_src)); + if (i >= 0) { + /* Stateful source address compression. */ + buffer[ieee_header_len + 1] |= 0x40; + buffer[ieee_header_len + 2] |= (i & 0x0f) << 4; + } + + i = lowpan6_context_lookup(ip_2_ip6(&ip_data.current_iphdr_dest)); + if (i >= 0) { + /* Stateful destination address compression. */ + buffer[ieee_header_len + 1] |= 0x04; + buffer[ieee_header_len + 2] |= i & 0x0f; + } + + if (buffer[ieee_header_len + 2] != 0x00) { + /* Context identifier extension byte is appended. */ + buffer[ieee_header_len + 1] |= 0x80; + lowpan6_header_len++; + } +#endif /* LWIP_6LOWPAN_NUM_CONTEXTS > 0 */ + + /* Determine TF field: Traffic Class, Flow Label */ + if (IP6H_FL(ip6hdr) == 0) { + /* Flow label is elided. */ + buffer[ieee_header_len] |= 0x10; + if (IP6H_TC(ip6hdr) == 0) { + /* Traffic class (ECN+DSCP) elided too. */ + buffer[ieee_header_len] |= 0x08; + } else { + /* Traffic class (ECN+DSCP) appended. */ + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_TC(ip6hdr); + } + } else { + if (((IP6H_TC(ip6hdr) & 0x3f) == 0)) { + /* DSCP portion of Traffic Class is elided, ECN and FL are appended (3 bytes) */ + buffer[ieee_header_len] |= 0x08; + + buffer[ieee_header_len + lowpan6_header_len] = IP6H_TC(ip6hdr) & 0xc0; + buffer[ieee_header_len + lowpan6_header_len++] |= (IP6H_FL(ip6hdr) >> 16) & 0x0f; + buffer[ieee_header_len + lowpan6_header_len++] = (IP6H_FL(ip6hdr) >> 8) & 0xff; + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_FL(ip6hdr) & 0xff; + } else { + /* Traffic class and flow label are appended (4 bytes) */ + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_TC(ip6hdr); + buffer[ieee_header_len + lowpan6_header_len++] = (IP6H_FL(ip6hdr) >> 16) & 0x0f; + buffer[ieee_header_len + lowpan6_header_len++] = (IP6H_FL(ip6hdr) >> 8) & 0xff; + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_FL(ip6hdr) & 0xff; + } + } + + /* Compress NH? + * Only if UDP for now. TODO support other NH compression. */ + if (IP6H_NEXTH(ip6hdr) == IP6_NEXTH_UDP) { + buffer[ieee_header_len] |= 0x04; + } else { + /* append nexth. */ + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_NEXTH(ip6hdr); + } + + /* Compress hop limit? */ + if (IP6H_HOPLIM(ip6hdr) == 255) { + buffer[ieee_header_len] |= 0x03; + } else if (IP6H_HOPLIM(ip6hdr) == 64) { + buffer[ieee_header_len] |= 0x02; + } else if (IP6H_HOPLIM(ip6hdr) == 1) { + buffer[ieee_header_len] |= 0x01; + } else { + /* append hop limit */ + buffer[ieee_header_len + lowpan6_header_len++] = IP6H_HOPLIM(ip6hdr); + } + + /* Compress source address */ + if (((buffer[ieee_header_len + 1] & 0x40) != 0) || + (ip6_addr_islinklocal(ip_2_ip6(&ip_data.current_iphdr_src)))) { + /* Context-based or link-local source address compression. */ + i = lowpan6_get_address_mode(ip_2_ip6(&ip_data.current_iphdr_src), src); + buffer[ieee_header_len + 1] |= (i & 0x03) << 4; + if (i == 1) { + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 16, 8); + lowpan6_header_len += 8; + } else if (i == 2) { + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 22, 2); + lowpan6_header_len += 2; + } + } else if (ip6_addr_isany(ip_2_ip6(&ip_data.current_iphdr_src))) { + /* Special case: mark SAC and leave SAM=0 */ + buffer[ieee_header_len + 1] |= 0x40; + } else { + /* Append full address. */ + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 8, 16); + lowpan6_header_len += 16; + } + + /* Compress destination address */ + if (ip6_addr_ismulticast(ip_2_ip6(&ip_data.current_iphdr_dest))) { + /* TODO support stateful multicast address compression */ + + buffer[ieee_header_len + 1] |= 0x08; + + i = lowpan6_get_address_mode_mc(ip_2_ip6(&ip_data.current_iphdr_dest)); + buffer[ieee_header_len + 1] |= i & 0x03; + if (i == 0) { + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 24, 16); + lowpan6_header_len += 16; + } else if (i == 1) { + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[25]; + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 35, 5); + lowpan6_header_len += 5; + } else if (i == 2) { + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[25]; + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 37, 3); + lowpan6_header_len += 3; + } else if (i == 3) { + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[39]; + } + } else if (((buffer[ieee_header_len + 1] & 0x04) != 0) || + (ip6_addr_islinklocal(ip_2_ip6(&ip_data.current_iphdr_dest)))) { + /* Context-based or link-local destination address compression. */ + i = lowpan6_get_address_mode(ip_2_ip6(&ip_data.current_iphdr_dest), dst); + buffer[ieee_header_len + 1] |= i & 0x03; + if (i == 1) { + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 32, 8); + lowpan6_header_len += 8; + } else if (i == 2) { + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 38, 2); + lowpan6_header_len += 2; + } + } else { + /* Append full address. */ + MEMCPY(buffer + ieee_header_len + lowpan6_header_len, (u8_t*)p->payload + 24, 16); + lowpan6_header_len += 16; + } + + /* Move to payload. */ + pbuf_header(p, -IP6_HLEN); + + /* Compress UDP header? */ + if (IP6H_NEXTH(ip6hdr) == IP6_NEXTH_UDP) { + /* TODO support optional checksum compression */ + + buffer[ieee_header_len + lowpan6_header_len] = 0xf0; + + /* determine port compression mode. */ + if ((((u8_t *)p->payload)[0] == 0xf0) && ((((u8_t *)p->payload)[1] & 0xf0) == 0xb0) && + (((u8_t *)p->payload)[2] == 0xf0) && ((((u8_t *)p->payload)[3] & 0xf0) == 0xb0)) { + /* Compress source and dest ports. */ + buffer[ieee_header_len + lowpan6_header_len++] |= 0x03; + buffer[ieee_header_len + lowpan6_header_len++] = ((((u8_t *)p->payload)[1] & 0x0f) << 4) | (((u8_t *)p->payload)[3] & 0x0f); + } else if (((u8_t *)p->payload)[0] == 0xf0) { + /* Compress source port. */ + buffer[ieee_header_len + lowpan6_header_len++] |= 0x02; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[1]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[2]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[3]; + } else if (((u8_t *)p->payload)[2] == 0xf0) { + /* Compress dest port. */ + buffer[ieee_header_len + lowpan6_header_len++] |= 0x01; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[0]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[1]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[3]; + } else { + /* append full ports. */ + lowpan6_header_len++; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[0]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[1]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[2]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[3]; + } + + /* elide length and copy checksum */ + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[6]; + buffer[ieee_header_len + lowpan6_header_len++] = ((u8_t *)p->payload)[7]; + + pbuf_header(p, -UDP_HLEN); + } + } + +#else /* LWIP_6LOWPAN_HC */ + /* Send uncompressed IPv6 header with appropriate dispatch byte. */ + lowpan6_header_len = 1; + buffer[ieee_header_len] = 0x41; /* IPv6 dispatch */ +#endif /* LWIP_6LOWPAN_HC */ + + /* Calculate remaining packet length */ + remaining_len = p->tot_len; + + if (remaining_len > 0x7FF) { + MIB2_STATS_NETIF_INC(netif, ifoutdiscards); + /* datagram_size must fit into 11 bit */ + pbuf_free(p_frag); + return ERR_VAL; + } + + /* Fragment, or 1 packet? */ + if (remaining_len > (127 - ieee_header_len - lowpan6_header_len - 3)) { /* 127 - header - 1 byte dispatch - 2 bytes CRC */ + /* We must move the 6LowPAN header to make room for the FRAG header. */ + i = lowpan6_header_len; + while (i-- != 0) { + buffer[ieee_header_len + i + 4] = buffer[ieee_header_len + i]; + } + + /* Now we need to fragment the packet. FRAG1 header first */ + buffer[ieee_header_len] = 0xc0 | (((p->tot_len + lowpan6_header_len) >> 8) & 0x7); + buffer[ieee_header_len + 1] = (p->tot_len + lowpan6_header_len) & 0xff; + + datagram_tag++; + buffer[ieee_header_len + 2] = datagram_tag & 0xff; + buffer[ieee_header_len + 3] = (datagram_tag >> 8) & 0xff; + + /* Fragment follows. */ + frag_len = (127 - ieee_header_len - 4 - 2) & 0xf8; + + pbuf_copy_partial(p, buffer + ieee_header_len + lowpan6_header_len + 4, frag_len - lowpan6_header_len, 0); + remaining_len -= frag_len - lowpan6_header_len; + datagram_offset = frag_len; + + /* 2 bytes CRC */ +#if LWIP_6LOWPAN_HW_CRC + /* Leave blank, will be filled by HW. */ +#else /* LWIP_6LOWPAN_HW_CRC */ + /* TODO calculate CRC */ +#endif /* LWIP_6LOWPAN_HW_CRC */ + + /* Calculate frame length */ + p_frag->len = p_frag->tot_len = ieee_header_len + 4 + frag_len + 2; /* add 2 dummy bytes for crc*/ + + /* send the packet */ + MIB2_STATS_NETIF_ADD(netif, ifoutoctets, p_frag->tot_len); + LWIP_DEBUGF(LOWPAN6_DEBUG | LWIP_DBG_TRACE, ("lowpan6_send: sending packet %p\n", (void *)p)); + err = netif->linkoutput(netif, p_frag); + + while ((remaining_len > 0) && (err == ERR_OK)) { + /* new frame, new seq num for ACK */ + buffer[2] = frame_seq_num++; + + buffer[ieee_header_len] |= 0x20; /* Change FRAG1 to FRAGN */ + + buffer[ieee_header_len + 4] = (u8_t)(datagram_offset >> 3); /* datagram offset in FRAGN header (datagram_offset is max. 11 bit) */ + + frag_len = (127 - ieee_header_len - 5 - 2) & 0xf8; + if (frag_len > remaining_len) { + frag_len = remaining_len; + } + + pbuf_copy_partial(p, buffer + ieee_header_len + 5, frag_len, p->tot_len - remaining_len); + remaining_len -= frag_len; + datagram_offset += frag_len; + + /* 2 bytes CRC */ +#if LWIP_6LOWPAN_HW_CRC + /* Leave blank, will be filled by HW. */ +#else /* LWIP_6LOWPAN_HW_CRC */ + /* TODO calculate CRC */ +#endif /* LWIP_6LOWPAN_HW_CRC */ + + /* Calculate frame length */ + p_frag->len = p_frag->tot_len = frag_len + 5 + ieee_header_len + 2; + + /* send the packet */ + MIB2_STATS_NETIF_ADD(netif, ifoutoctets, p_frag->tot_len); + LWIP_DEBUGF(LOWPAN6_DEBUG | LWIP_DBG_TRACE, ("lowpan6_send: sending packet %p\n", (void *)p)); + err = netif->linkoutput(netif, p_frag); + } + } else { + /* It fits in one frame. */ + frag_len = remaining_len; + + /* Copy IPv6 packet */ + pbuf_copy_partial(p, buffer + ieee_header_len + lowpan6_header_len, frag_len, 0); + remaining_len = 0; + + /* 2 bytes CRC */ +#if LWIP_6LOWPAN_HW_CRC + /* Leave blank, will be filled by HW. */ +#else /* LWIP_6LOWPAN_HW_CRC */ + /* TODO calculate CRC */ +#endif /* LWIP_6LOWPAN_HW_CRC */ + + /* Calculate frame length */ + p_frag->len = p_frag->tot_len = frag_len + lowpan6_header_len + ieee_header_len + 2; + + /* send the packet */ + MIB2_STATS_NETIF_ADD(netif, ifoutoctets, p_frag->tot_len); + LWIP_DEBUGF(LOWPAN6_DEBUG | LWIP_DBG_TRACE, ("lowpan6_send: sending packet %p\n", (void *)p)); + err = netif->linkoutput(netif, p_frag); + } + + pbuf_free(p_frag); + + return err; +} + +err_t +lowpan6_set_context(u8_t idx, const ip6_addr_t * context) +{ + if (idx >= LWIP_6LOWPAN_NUM_CONTEXTS) { + return ERR_ARG; + } + + ip6_addr_set(&lowpan6_context[idx], context); + + return ERR_OK; +} + +#if LWIP_6LOWPAN_INFER_SHORT_ADDRESS +err_t +lowpan6_set_short_addr(u8_t addr_high, u8_t addr_low) +{ + short_mac_addr.addr[0] = addr_high; + short_mac_addr.addr[1] = addr_low; + + return ERR_OK; +} +#endif /* LWIP_6LOWPAN_INFER_SHORT_ADDRESS */ + +#if LWIP_IPV4 +err_t +lowpan4_output(struct netif *netif, struct pbuf *q, const ip4_addr_t *ipaddr) +{ + (void)netif; + (void)q; + (void)ipaddr; + + return ERR_IF; +} +#endif /* LWIP_IPV4 */ + +/** + * Resolve and fill-in IEEE 802.15.4 address header for outgoing IPv6 packet. + * + * Perform Header Compression and fragment if necessary. + * + * @param netif The lwIP network interface which the IP packet will be sent on. + * @param q The pbuf(s) containing the IP packet to be sent. + * @param ip6addr The IP address of the packet destination. + * + * @return + */ +err_t +lowpan6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr) +{ + s8_t i; + struct ieee_802154_addr src, dest; +#if LWIP_6LOWPAN_INFER_SHORT_ADDRESS + ip6_addr_t ip6_src; + struct ip6_hdr * ip6_hdr; +#endif /* LWIP_6LOWPAN_INFER_SHORT_ADDRESS */ + +#if LWIP_6LOWPAN_INFER_SHORT_ADDRESS + /* Check if we can compress source address (use aligned copy) */ + ip6_hdr = (struct ip6_hdr *)q->payload; + ip6_addr_set(&ip6_src, &ip6_hdr->src); + if (lowpan6_get_address_mode(&ip6_src, &short_mac_addr) == 3) { + src.addr_len = 2; + src.addr[0] = short_mac_addr.addr[0]; + src.addr[1] = short_mac_addr.addr[1]; + } else +#endif /* LWIP_6LOWPAN_INFER_SHORT_ADDRESS */ + { + src.addr_len = netif->hwaddr_len; + SMEMCPY(src.addr, netif->hwaddr, netif->hwaddr_len); + } + + /* multicast destination IP address? */ + if (ip6_addr_ismulticast(ip6addr)) { + MIB2_STATS_NETIF_INC(netif, ifoutnucastpkts); + /* We need to send to the broadcast address.*/ + return lowpan6_frag(netif, q, &src, &ieee_802154_broadcast); + } + + /* We have a unicast destination IP address */ + /* TODO anycast? */ + +#if LWIP_6LOWPAN_INFER_SHORT_ADDRESS + if (src.addr_len == 2) { + /* If source address was compressable to short_mac_addr, and dest has same subnet and + * is also compressable to 2-bytes, assume we can infer dest as a short address too. */ + dest.addr_len = 2; + dest.addr[0] = ((u8_t *)q->payload)[38]; + dest.addr[1] = ((u8_t *)q->payload)[39]; + if ((src.addr_len == 2) && (ip6_addr_netcmp(&ip6_hdr->src, &ip6_hdr->dest)) && + (lowpan6_get_address_mode(ip6addr, &dest) == 3)) { + MIB2_STATS_NETIF_INC(netif, ifoutucastpkts); + return lowpan6_frag(netif, q, &src, &dest); + } + } +#endif /* LWIP_6LOWPAN_INFER_SHORT_ADDRESS */ + + + /* Get next hop record. */ + i = nd6_get_next_hop_entry(ip6addr, netif); + if (i < 0) { + MIB2_STATS_NETIF_INC(netif, ifoutdiscards); + /* failed to get a next hop neighbor record. */ + return ERR_MEM; + } + + /* Now that we have a destination record, send or queue the packet. */ + if (neighbor_cache[i].state == ND6_STALE) { + /* Switch to delay state. */ + neighbor_cache[i].state = ND6_DELAY; + neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME; + } + /* TODO should we send or queue if PROBE? send for now, to let unicast NS pass. */ + if ((neighbor_cache[i].state == ND6_REACHABLE) || + (neighbor_cache[i].state == ND6_DELAY) || + (neighbor_cache[i].state == ND6_PROBE)) { + + /* Send out. */ + dest.addr_len = netif->hwaddr_len; + SMEMCPY(dest.addr, neighbor_cache[i].lladdr, netif->hwaddr_len); + MIB2_STATS_NETIF_INC(netif, ifoutucastpkts); + return lowpan6_frag(netif, q, &src, &dest); + } + + /* We should queue packet on this interface. */ + return nd6_queue_packet(i, q); +} + +static struct pbuf * +lowpan6_decompress(struct pbuf * p, struct ieee_802154_addr * src, struct ieee_802154_addr * dest) +{ + struct pbuf * q; + u8_t * lowpan6_buffer; + s8_t lowpan6_offset; + struct ip6_hdr *ip6hdr; + s8_t i; + s8_t ip6_offset = IP6_HLEN; + + + q = pbuf_alloc(PBUF_IP, p->len + IP6_HLEN + UDP_HLEN, PBUF_POOL); + if (q == NULL) { + pbuf_free(p); + return NULL; + } + + lowpan6_buffer = (u8_t *)p->payload; + ip6hdr = (struct ip6_hdr *)q->payload; + + lowpan6_offset = 2; + if (lowpan6_buffer[1] & 0x80) { + lowpan6_offset++; + } + + /* Set IPv6 version, traffic class and flow label. */ + if ((lowpan6_buffer[0] & 0x18) == 0x00) { + IP6H_VTCFL_SET(ip6hdr, 6, lowpan6_buffer[lowpan6_offset], ((lowpan6_buffer[lowpan6_offset+1] & 0x0f) << 16) | (lowpan6_buffer[lowpan6_offset + 2] << 8) | lowpan6_buffer[lowpan6_offset+3]); + lowpan6_offset += 4; + } else if ((lowpan6_buffer[0] & 0x18) == 0x08) { + IP6H_VTCFL_SET(ip6hdr, 6, lowpan6_buffer[lowpan6_offset] & 0xc0, ((lowpan6_buffer[lowpan6_offset] & 0x0f) << 16) | (lowpan6_buffer[lowpan6_offset + 1] << 8) | lowpan6_buffer[lowpan6_offset+2]); + lowpan6_offset += 3; + } else if ((lowpan6_buffer[0] & 0x18) == 0x10) { + IP6H_VTCFL_SET(ip6hdr, 6, lowpan6_buffer[lowpan6_offset],0); + lowpan6_offset += 1; + } else if ((lowpan6_buffer[0] & 0x18) == 0x18) { + IP6H_VTCFL_SET(ip6hdr, 6, 0, 0); + } + + /* Set Next Header */ + if ((lowpan6_buffer[0] & 0x04) == 0x00) { + IP6H_NEXTH_SET(ip6hdr, lowpan6_buffer[lowpan6_offset++]); + } else { + /* We should fill this later with NHC decoding */ + IP6H_NEXTH_SET(ip6hdr, 0); + } + + /* Set Hop Limit */ + if ((lowpan6_buffer[0] & 0x03) == 0x00) { + IP6H_HOPLIM_SET(ip6hdr, lowpan6_buffer[lowpan6_offset++]); + } else if ((lowpan6_buffer[0] & 0x03) == 0x01) { + IP6H_HOPLIM_SET(ip6hdr, 1); + } else if ((lowpan6_buffer[0] & 0x03) == 0x02) { + IP6H_HOPLIM_SET(ip6hdr, 64); + } else if ((lowpan6_buffer[0] & 0x03) == 0x03) { + IP6H_HOPLIM_SET(ip6hdr, 255); + } + + /* Source address decoding. */ + if ((lowpan6_buffer[1] & 0x40) == 0x00) { + /* Stateless compression */ + if ((lowpan6_buffer[1] & 0x30) == 0x00) { + /* copy full address */ + MEMCPY(&ip6hdr->src.addr[0], lowpan6_buffer + lowpan6_offset, 16); + lowpan6_offset += 16; + } else if ((lowpan6_buffer[1] & 0x30) == 0x10) { + ip6hdr->src.addr[0] = PP_HTONL(0xfe800000UL); + ip6hdr->src.addr[1] = 0; + MEMCPY(&ip6hdr->src.addr[2], lowpan6_buffer + lowpan6_offset, 8); + lowpan6_offset += 8; + } else if ((lowpan6_buffer[1] & 0x30) == 0x20) { + ip6hdr->src.addr[0] = PP_HTONL(0xfe800000UL); + ip6hdr->src.addr[1] = 0; + ip6hdr->src.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->src.addr[3] = htonl(0xfe000000UL | (lowpan6_buffer[lowpan6_offset] << 8) | + lowpan6_buffer[lowpan6_offset+1]); + lowpan6_offset += 2; + } else if ((lowpan6_buffer[1] & 0x30) == 0x30) { + ip6hdr->src.addr[0] = PP_HTONL(0xfe800000UL); + ip6hdr->src.addr[1] = 0; + if (src->addr_len == 2) { + ip6hdr->src.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->src.addr[3] = htonl(0xfe000000UL | (src->addr[0] << 8) | src->addr[1]); + } else { + ip6hdr->src.addr[2] = htonl(((src->addr[0] ^ 2) << 24) | (src->addr[1] << 16) | + (src->addr[2] << 8) | src->addr[3]); + ip6hdr->src.addr[3] = htonl((src->addr[4] << 24) | (src->addr[5] << 16) | + (src->addr[6] << 8) | src->addr[7]); + } + } + } else { + /* Stateful compression */ + if ((lowpan6_buffer[1] & 0x30) == 0x00) { + /* ANY address */ + ip6hdr->src.addr[0] = 0; + ip6hdr->src.addr[1] = 0; + ip6hdr->src.addr[2] = 0; + ip6hdr->src.addr[3] = 0; + } else { + /* Set prefix from context info */ + if (lowpan6_buffer[1] & 0x80) { + i = (lowpan6_buffer[2] >> 4) & 0x0f; + } else { + i = 0; + } + if (i >= LWIP_6LOWPAN_NUM_CONTEXTS) { + /* Error */ + pbuf_free(p); + pbuf_free(q); + return NULL; + } + + ip6hdr->src.addr[0] = lowpan6_context[i].addr[0]; + ip6hdr->src.addr[1] = lowpan6_context[i].addr[1]; + } + + if ((lowpan6_buffer[1] & 0x30) == 0x10) { + MEMCPY(&ip6hdr->src.addr[2], lowpan6_buffer + lowpan6_offset, 8); + lowpan6_offset += 8; + } else if ((lowpan6_buffer[1] & 0x30) == 0x20) { + ip6hdr->src.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->src.addr[3] = htonl(0xfe000000UL | (lowpan6_buffer[lowpan6_offset] << 8) | lowpan6_buffer[lowpan6_offset+1]); + lowpan6_offset += 2; + } else if ((lowpan6_buffer[1] & 0x30) == 0x30) { + if (src->addr_len == 2) { + ip6hdr->src.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->src.addr[3] = htonl(0xfe000000UL | (src->addr[0] << 8) | src->addr[1]); + } else { + ip6hdr->src.addr[2] = htonl(((src->addr[0] ^ 2) << 24) | (src->addr[1] << 16) | (src->addr[2] << 8) | src->addr[3]); + ip6hdr->src.addr[3] = htonl((src->addr[4] << 24) | (src->addr[5] << 16) | (src->addr[6] << 8) | src->addr[7]); + } + } + } + + /* Destination address decoding. */ + if (lowpan6_buffer[1] & 0x08) { + /* Multicast destination */ + if (lowpan6_buffer[1] & 0x04) { + /* TODO support stateful multicast addressing */ + pbuf_free(p); + pbuf_free(q); + return NULL; + } + + if ((lowpan6_buffer[1] & 0x03) == 0x00) { + /* copy full address */ + MEMCPY(&ip6hdr->dest.addr[0], lowpan6_buffer + lowpan6_offset, 16); + lowpan6_offset += 16; + } else if ((lowpan6_buffer[1] & 0x03) == 0x01) { + ip6hdr->dest.addr[0] = htonl(0xff000000UL | (lowpan6_buffer[lowpan6_offset++] << 16)); + ip6hdr->dest.addr[1] = 0; + ip6hdr->dest.addr[2] = htonl(lowpan6_buffer[lowpan6_offset++]); + ip6hdr->dest.addr[3] = htonl((lowpan6_buffer[lowpan6_offset] << 24) | (lowpan6_buffer[lowpan6_offset + 1] << 16) | (lowpan6_buffer[lowpan6_offset + 2] << 8) | lowpan6_buffer[lowpan6_offset + 3]); + lowpan6_offset += 4; + } else if ((lowpan6_buffer[1] & 0x03) == 0x02) { + ip6hdr->dest.addr[0] = htonl(0xff000000UL | lowpan6_buffer[lowpan6_offset++]); + ip6hdr->dest.addr[1] = 0; + ip6hdr->dest.addr[2] = 0; + ip6hdr->dest.addr[3] = htonl((lowpan6_buffer[lowpan6_offset] << 16) | (lowpan6_buffer[lowpan6_offset + 1] << 8) | lowpan6_buffer[lowpan6_offset + 2]); + lowpan6_offset += 3; + } else if ((lowpan6_buffer[1] & 0x03) == 0x03) { + ip6hdr->dest.addr[0] = PP_HTONL(0xff020000UL); + ip6hdr->dest.addr[1] = 0; + ip6hdr->dest.addr[2] = 0; + ip6hdr->dest.addr[3] = htonl(lowpan6_buffer[lowpan6_offset++]); + } + + } else { + if (lowpan6_buffer[1] & 0x04) { + /* Stateful destination compression */ + /* Set prefix from context info */ + if (lowpan6_buffer[1] & 0x80) { + i = lowpan6_buffer[2] & 0x0f; + } else { + i = 0; + } + if (i >= LWIP_6LOWPAN_NUM_CONTEXTS) { + /* Error */ + pbuf_free(p); + pbuf_free(q); + return NULL; + } + + ip6hdr->dest.addr[0] = lowpan6_context[i].addr[0]; + ip6hdr->dest.addr[1] = lowpan6_context[i].addr[1]; + } else { + /* Link local address compression */ + ip6hdr->dest.addr[0] = PP_HTONL(0xfe800000UL); + ip6hdr->dest.addr[1] = 0; + } + + if ((lowpan6_buffer[1] & 0x03) == 0x00) { + /* copy full address */ + MEMCPY(&ip6hdr->dest.addr[0], lowpan6_buffer + lowpan6_offset, 16); + lowpan6_offset += 16; + } else if ((lowpan6_buffer[1] & 0x03) == 0x01) { + MEMCPY(&ip6hdr->dest.addr[2], lowpan6_buffer + lowpan6_offset, 8); + lowpan6_offset += 8; + } else if ((lowpan6_buffer[1] & 0x03) == 0x02) { + ip6hdr->dest.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->dest.addr[3] = htonl(0xfe000000UL | (lowpan6_buffer[lowpan6_offset] << 8) | lowpan6_buffer[lowpan6_offset + 1]); + lowpan6_offset += 2; + } else if ((lowpan6_buffer[1] & 0x03) == 0x03) { + if (dest->addr_len == 2) { + ip6hdr->dest.addr[2] = PP_HTONL(0x000000ffUL); + ip6hdr->dest.addr[3] = htonl(0xfe000000UL | (dest->addr[0] << 8) | dest->addr[1]); + } else { + ip6hdr->dest.addr[2] = htonl(((dest->addr[0] ^ 2) << 24) | (dest->addr[1] << 16) | dest->addr[2] << 8 | dest->addr[3]); + ip6hdr->dest.addr[3] = htonl((dest->addr[4] << 24) | (dest->addr[5] << 16) | dest->addr[6] << 8 | dest->addr[7]); + } + } + } + + + /* Next Header Compression (NHC) decoding? */ + if (lowpan6_buffer[0] & 0x04) { + if ((lowpan6_buffer[lowpan6_offset] & 0xf8) == 0xf0) { + struct udp_hdr *udphdr; + + /* UDP compression */ + IP6H_NEXTH_SET(ip6hdr, IP6_NEXTH_UDP); + udphdr = (struct udp_hdr *)((u8_t *)q->payload + ip6_offset); + + if (lowpan6_buffer[lowpan6_offset] & 0x04) { + /* TODO support checksum decompress */ + pbuf_free(p); + pbuf_free(q); + return NULL; + } + + /* Decompress ports */ + i = lowpan6_buffer[lowpan6_offset++] & 0x03; + if (i == 0) { + udphdr->src = htons(lowpan6_buffer[lowpan6_offset] << 8 | lowpan6_buffer[lowpan6_offset + 1]); + udphdr->dest = htons(lowpan6_buffer[lowpan6_offset + 2] << 8 | lowpan6_buffer[lowpan6_offset + 3]); + lowpan6_offset += 4; + } else if (i == 0x01) { + udphdr->src = htons(lowpan6_buffer[lowpan6_offset] << 8 | lowpan6_buffer[lowpan6_offset + 1]); + udphdr->dest = htons(0xf000 | lowpan6_buffer[lowpan6_offset + 2]); + lowpan6_offset += 3; + } else if (i == 0x02) { + udphdr->src = htons(0xf000 | lowpan6_buffer[lowpan6_offset]); + udphdr->dest = htons(lowpan6_buffer[lowpan6_offset + 1] << 8 | lowpan6_buffer[lowpan6_offset + 2]); + lowpan6_offset += 3; + } else if (i == 0x03) { + udphdr->src = htons(0xf0b0 | ((lowpan6_buffer[lowpan6_offset] >> 4) & 0x0f)); + udphdr->dest = htons(0xf0b0 | (lowpan6_buffer[lowpan6_offset] & 0x0f)); + lowpan6_offset += 1; + } + + udphdr->chksum = htons(lowpan6_buffer[lowpan6_offset] << 8 | lowpan6_buffer[lowpan6_offset + 1]); + lowpan6_offset += 2; + udphdr->len = htons(p->tot_len - lowpan6_offset + UDP_HLEN); + + ip6_offset += UDP_HLEN; + } else { + /* TODO support NHC other than UDP */ + pbuf_free(p); + pbuf_free(q); + return NULL; + } + } + + /* Now we copy leftover contents from p to q, so we have all L2 and L3 headers (and L4?) in a single PBUF. + * Replace p with q, and free p */ + pbuf_header(p, -lowpan6_offset); + MEMCPY((u8_t*)q->payload + ip6_offset, p->payload, p->len); + q->len = q->tot_len = ip6_offset + p->len; + if (p->next != NULL) { + pbuf_cat(q, p->next); + } + p->next = NULL; + pbuf_free(p); + + /* Infer IPv6 payload length for header */ + IP6H_PLEN_SET(ip6hdr, q->tot_len - IP6_HLEN); + + /* all done */ + return q; +} + +err_t +lowpan6_input(struct pbuf * p, struct netif *netif) +{ + u8_t * puc; + s8_t i; + struct ieee_802154_addr src, dest; + u16_t datagram_size, datagram_offset, datagram_tag; + struct lowpan6_reass_helper *lrh, *lrh_temp; + + MIB2_STATS_NETIF_ADD(netif, ifinoctets, p->tot_len); + + /* Analyze header. TODO validate. */ + puc = (u8_t*)p->payload; + datagram_offset = 5; + if ((puc[1] & 0x0c) == 0x0c) { + dest.addr_len = 8; + for (i = 0; i < 8; i++) { + dest.addr[i] = puc[datagram_offset + 7 - i]; + } + datagram_offset += 8; + } else { + dest.addr_len = 2; + dest.addr[0] = puc[datagram_offset + 1]; + dest.addr[1] = puc[datagram_offset]; + datagram_offset += 2; + } + + datagram_offset += 2; /* skip PAN ID. */ + + if ((puc[1] & 0xc0) == 0xc0) { + src.addr_len = 8; + for (i = 0; i < 8; i++) { + src.addr[i] = puc[datagram_offset + 7 - i]; + } + datagram_offset += 8; + } else { + src.addr_len = 2; + src.addr[0] = puc[datagram_offset + 1]; + src.addr[1] = puc[datagram_offset]; + datagram_offset += 2; + } + + pbuf_header(p, -datagram_offset); /* hide IEEE802.15.4 header. */ + + /* Check dispatch. */ + puc = (u8_t*)p->payload; + + if ((*puc & 0xf8) == 0xc0) { + /* FRAG1 dispatch. add this packet to reassembly list. */ + datagram_size = ((u16_t)(puc[0] & 0x07) << 8) | (u16_t)puc[1]; + datagram_tag = ((u16_t)puc[2] << 8) | (u16_t)puc[3]; + + /* check for duplicate */ + lrh = reass_list; + while (lrh != NULL) { + if ((lrh->sender_addr.addr_len == src.addr_len) && + (memcmp(lrh->sender_addr.addr, src.addr, src.addr_len) == 0)) { + /* address match with packet in reassembly. */ + if ((datagram_tag == lrh->datagram_tag) && (datagram_size == lrh->datagram_size)) { + MIB2_STATS_NETIF_INC(netif, ifindiscards); + /* duplicate fragment. */ + pbuf_free(p); + return ERR_OK; + } else { + /* We are receiving the start of a new datagram. Discard old one (incomplete). */ + lrh_temp = lrh->next_packet; + dequeue_datagram(lrh); + pbuf_free(lrh->pbuf); + mem_free(lrh); + + /* Check next datagram in queue. */ + lrh = lrh_temp; + } + } else { + /* Check next datagram in queue. */ + lrh = lrh->next_packet; + } + } + + pbuf_header(p, -4); /* hide frag1 dispatch */ + + lrh = (struct lowpan6_reass_helper *) mem_malloc(sizeof(struct lowpan6_reass_helper)); + if (lrh == NULL) { + MIB2_STATS_NETIF_INC(netif, ifindiscards); + pbuf_free(p); + return ERR_MEM; + } + + lrh->sender_addr.addr_len = src.addr_len; + for (i = 0; i < src.addr_len; i++) { + lrh->sender_addr.addr[i] = src.addr[i]; + } + lrh->datagram_size = datagram_size; + lrh->datagram_tag = datagram_tag; + lrh->pbuf = p; + lrh->next_packet = reass_list; + lrh->timer = 2; + reass_list = lrh; + + return ERR_OK; + } else if ((*puc & 0xf8) == 0xe0) { + /* FRAGN dispatch, find packet being reassembled. */ + datagram_size = ((u16_t)(puc[0] & 0x07) << 8) | (u16_t)puc[1]; + datagram_tag = ((u16_t)puc[2] << 8) | (u16_t)puc[3]; + datagram_offset = (u16_t)puc[4] << 3; + pbuf_header(p, -5); /* hide frag1 dispatch */ + + for (lrh = reass_list; lrh != NULL; lrh = lrh->next_packet) { + if ((lrh->sender_addr.addr_len == src.addr_len) && + (memcmp(lrh->sender_addr.addr, src.addr, src.addr_len) == 0) && + (datagram_tag == lrh->datagram_tag) && + (datagram_size == lrh->datagram_size)) { + break; + } + } + if (lrh == NULL) { + /* rogue fragment */ + MIB2_STATS_NETIF_INC(netif, ifindiscards); + pbuf_free(p); + return ERR_OK; + } + + if (lrh->pbuf->tot_len < datagram_offset) { + /* duplicate, ignore. */ + pbuf_free(p); + return ERR_OK; + } else if (lrh->pbuf->tot_len > datagram_offset) { + MIB2_STATS_NETIF_INC(netif, ifindiscards); + /* We have missed a fragment. Delete whole reassembly. */ + dequeue_datagram(lrh); + pbuf_free(lrh->pbuf); + mem_free(lrh); + pbuf_free(p); + return ERR_OK; + } + pbuf_cat(lrh->pbuf, p); + p = NULL; + + /* is packet now complete?*/ + if (lrh->pbuf->tot_len >= lrh->datagram_size) { + /* dequeue from reass list. */ + dequeue_datagram(lrh); + + /* get pbuf */ + p = lrh->pbuf; + + /* release helper */ + mem_free(lrh); + } else { + return ERR_OK; + } + } + + if (p == NULL) { + return ERR_OK; + } + + /* We have a complete packet, check dispatch for headers. */ + puc = (u8_t*)p->payload; + + if (*puc == 0x41) { + /* This is a complete IPv6 packet, just skip dispatch byte. */ + pbuf_header(p, -1); /* hide dispatch byte. */ + } else if ((*puc & 0xe0 )== 0x60) { + /* IPv6 headers are compressed using IPHC. */ + p = lowpan6_decompress(p, &src, &dest); + if (p == NULL) { + MIB2_STATS_NETIF_INC(netif, ifindiscards); + return ERR_OK; + } + } else { + MIB2_STATS_NETIF_INC(netif, ifindiscards); + pbuf_free(p); + return ERR_OK; + } + + /* @todo: distinguish unicast/multicast */ + MIB2_STATS_NETIF_INC(netif, ifinucastpkts); + + return ip6_input(p, netif); +} + +err_t +lowpan6_if_init(struct netif *netif) +{ + netif->name[0] = 'L'; + netif->name[1] = '6'; +#if LWIP_IPV4 + netif->output = lowpan4_output; +#endif /* LWIP_IPV4 */ + netif->output_ip6 = lowpan6_output; + + MIB2_INIT_NETIF(netif, snmp_ifType_other, 0); + + /* maximum transfer unit */ + netif->mtu = 1280; + + /* broadcast capability */ + netif->flags = NETIF_FLAG_BROADCAST /* | NETIF_FLAG_LOWPAN6 */; + + return ERR_OK; +} + +err_t +lowpan6_set_pan_id(u16_t pan_id) +{ + ieee_802154_pan_id = pan_id; + + return ERR_OK; +} + +/** + * Pass a received packet to tcpip_thread for input processing + * + * @param p the received packet, p->payload pointing to the + * IEEE 802.15.4 header. + * @param inp the network interface on which the packet was received + */ +err_t +tcpip_6lowpan_input(struct pbuf *p, struct netif *inp) +{ + return tcpip_inpkt(p, inp, lowpan6_input); +} + +#endif /* LWIP_IPV6 && LWIP_6LOWPAN */ diff --git a/components/lwip/netif/ppp/PPPD_FOLLOWUP b/components/lwip/netif/ppp/PPPD_FOLLOWUP new file mode 100755 index 000000000..4a82915db --- /dev/null +++ b/components/lwip/netif/ppp/PPPD_FOLLOWUP @@ -0,0 +1,382 @@ +The lwIP PPP support is based from pppd 2.4.5 (http://ppp.samba.org) with +huge changes to match code size and memory requirements for embedded devices. + +Anyway, pppd has a mature codebase for years and the average commit count +is getting low on their Git repositories, meaning that we can follow what +is happening on their side and merge what is relevant for lwIP. + +So, here is the pppd follow up, so that we don't get away too far from pppd. + + +== Patch fetched from from pppd Debian packages == + +This has nothing to do with pppd, but we merged some good patch from +Debian and this is a good place to be. + +- LCP adaptive echo, so that we don't send LCP echo request if we + are receiving data from peer, can be enabled by setting PPP_LCP_ADAPTIVE + to true. + +- IPCP no/replace default route option, were added in the early stage of + the ppp port, but it wasn't really helpful and was disabled when adding + the new API ppp_set_default() call, which gives the lwIP user control over + which one is the default interface, it was actually a requirement if you + are doing PPP over PPP (i.e. PPPoL2TP, VPN link, over PPPoE, ADSL link). + +- using rp-pppoe pppd exits with EXIT_OK after receiving a timeout waiting + for PADO due to no modem attached, bug reported to pppd bug tracker, fixed + in Debian but not in the latest (at the time when the port were started) + pppd release. + + +== Commits on pppd == + +2010-03-06 - Document +ipv6 and ipv6cp-accept-local + e7537958aee79b3f653c601e903cb31d78fb7dcc + +Don't care. + + +2010-03-06 - Install pppol2tp plugins with sane permissions + 406215672cfadc03017341fe03802d1c7294b903 + +Don't care. + + +2010-03-07 - pppd: Terminate correctly if lcp_lowerup delayed calling + fsm_lowerup + 3eb9e810cfa515543655659b72dde30c54fea0a5 + +Merged 2012-05-17. + + +2010-03-07 - rp_pppoe: Copy acName and pppd_pppoe_service after option parsing + cab58617fd9d328029fffabc788020264b4fa91f + +Don't care, is a patch for pppd/plugins/rp-pppoe/plugin.c which is not part +of the port. + + +2010-08-23 - set and reset options to control environment variables + for scripts. + 2b6310fd24dba8e0fca8999916a162f0a1842a84 + +We can't fork processes in embedded, therefore all the pppd process run +feature is disabled in the port, so we don't care about the new +"environment variables" pppd feature. + + +2010-08-23 - Nit: use _exit when exec fails and restrict values to 0-255 + per POSIX. + 2b4ea140432eeba5a007c0d4e6236bd0e0c12ba4 + +Again, we are not running as a heavy process, so all exit() or _exit() calls +were removed. + + +2010-08-23 - Fix quote handling in configuration files to be more like shell + quoting. + 3089132cdf5b58dbdfc2daf08ec5c08eb47f8aca + +We are not parsing config file, all the filesystem I/O stuff were disabled +in our port. + + +2010-08-24 - rp-pppoe: allow MTU to be increased up to 1500 + fd1dcdf758418f040da3ed801ab001b5e46854e7 + +Only concern changes on RP-PPPoE plugin, which we don't use. + + +2010-09-11 - chat: Allow TIMEOUT value to come from environment variable + ae80bf833e48a6202f44a935a68083ae52ad3824 + +See 2b6310fd24dba8e0fca8999916a162f0a1842a84. + + +2011-03-05 - pppdump: Fix printfs with insufficient arguments + 7b8db569642c83ba3283745034f2e2c95e459423 + +pppdump is a ppp tool outside pppd source tree. + + +2012-05-06 - pppd: Don't unconditionally disable VJ compression under Linux + d8a66adf98a0e525cf38031b42098d539da6eeb6 + +Patch for sys-linux.c, which we don't use. + + +2012-05-20 - Remove old version of Linux if_pppol2tp.h + c41092dd4c49267f232f6cba3d31c6c68bfdf68d + +Not in the port. + + +2012-05-20 - pppd: Make MSCHAP-v2 cope better with packet loss + 08ef47ca532294eb428238c831616748940e24a2 + +This is an interesting patch. However it consumes much more memory for +MSCHAP and I am not sure if the benefit worth it. The PPP client can +always start the authentication again if it failed for whatever reason. + + +2012-05-20 - scripts: Make poff ignore extra arguments to pppd + 18f515f32c9f5723a9c2c912601e04335106534b + +Again, we are not running scripts. + + +2012-05-20 - rp-pppoe plugin: Print leading zeros in MAC address + f5dda0cfc220c4b52e26144096d729e27b30f0f7 + +Again, we are not using the RP-PPPoE plugin. + + +2012-05-20 - pppd: Notify IPv6 up/down as we do for IPv4 + 845cda8fa18939cf56e60b073f63a7efa65336fc + +This is just a patch that adds plugins hooks for IPv6, the plugin interface +was disabled because we don't have .so plugins in embedded. + + +2012-05-20 - pppd: Enable IPV6 by default and fix some warnings + 0b6118239615e98959f7e0b4e746bdd197533248 + +Change on Makefile for IPv6, warnings were already cleared during port. + + +2012-05-20 - contrib: Fix pppgetpass.gtk compilation + 80a8e2ce257ca12cce723519a0f20ea1d663b14a + +Change on Makefile, don't care. + + +2012-05-20 - pppd: Don't crash if crypt() returns NULL + 04c4348108d847e034dd91066cc6843f60d71731 + +We are using the PolarSSL DES implementation that does not return NULL. + + +2012-05-20 - pppd: Eliminate some warnings + c44ae5e6a7338c96eb463881fe709b2dfaffe568 + +Again, we are handling compilation warnings on our own. + + +2012-05-20 - rp-pppoe plugin: Import some fixes from rp-pppoe-3.10 + 1817d83e51a411044e730ba89ebdb0480e1c8cd4 + +Once more, we are not using the RP-PPPoE plugin. + + +2013-01-23 - pppd: Clarify circumstances where DNS1/DNS2 environment variables are set + cf2f5c9538b9400ade23446a194729b0a4113b3a + +Documentation only. + + +2013-02-03 - ppp: ignore unrecognised radiusclient configuration directives + 7f736dde0da3c19855997d9e67370e351e15e923 + +Radius plugin, not in the port. + + +2013-02-03 - pppd: Take out unused %r conversion completely + 356d8d558d844412119aa18c8e5a113bc6459c7b + +Merged 2014-04-15. + + +2013-02-03 - pppd: Arrange to use logwtmp from libutil on Linux + 9617a7eb137f4fee62799a677a9ecf8d834db3f5 + +Patch for sys-linux.c, which we don't use. + + +2013-02-03 - pppdump: Eliminate some compiler warnings + 3e3acf1ba2b3046c072a42c19164788a9e419bd1 + +pppdump is a ppp tool outside pppd source tree. + + +2013-02-03 - chat: Correct spelling errors in the man page + 8dea1b969d266ccbf6f3a8c5474eb6dcd8838e3b + +Documentation only. + + +2013-02-03 - pppd: Fix spelling errors in man page + 9e05a25d76b3f83096c661678010320df673df6b + +Documentation only. + + +2013-02-03 - plugins/passprompt: Fix potential out-of-bounds array reference + 8edb889b753056a691a3e4b217a110a35f9fdedb + +Plugin patch, we do not have plugins. + + +2013-02-03 - chat: Fix *roff errors in the man page + a7c3489eeaf44e83ce592143c7c8a5b5c29f4c48 + +Documentation only. + + +2013-03-02 - pppd: Fix man page description of case when remote IP address isn't known + 224841f4799f4f1e2e71bc490c54448d66740f4f + +Documentation only. + + +2013-03-02 - pppd: Add master_detach option + 398ed2585640d198c53e736ee5bbd67f7ce8168e + +Option for multilink support, we do not support multilink and this option +is about detaching from the terminal, which is out of the embedded scope. + + +2013-03-11 - pppd: Default exit status to EXIT_CONNECT_FAILED during connection phase + 225361d64ae737afdc8cb57579a2f33525461bc9 + +Commented out in our port, and already fixed by a previously applied Debian patch. + + +2013-03-11 - pppstats: Fix undefined macro in man page + d16a3985eade5280b8e171f5dd0670a91cba0d39 + +Documentation only. + + +2013-05-11 - plugins/radius: Handle bindaddr keyword in radiusclient.conf + d883b2dbafeed3ebd9d7a56ab1469373bd001a3b + +Radius plugin, not in the port. + + +2013-06-09 - pppoatm: Remove explicit loading of pppoatm kernel module + 52cd43a84bea524033b918b603698104f221bbb7 + +PPPoATM plugin, not in the port. + + +2013-06-09 - pppd: Fix segfault in update_db_entry() + 37476164f15a45015310b9d4b197c2d7db1f7f8f + +We do not use the samba db. + + +2013-06-09 - chat: Fix some text that was intended to be literal + cd9683676618adcee8add2c3cfa3382341b5a1f6 + +Documentation only. + + +2013-06-09 - README.pppoe: Minor semantic fix + b5b8898af6fd3d44e873cfc66810ace5f1f47e17 + +Documentation only. + + +2013-06-10 - radius: Handle additional attributes + 2f581cd986a56f2ec4a95abad4f8297a1b10d7e2 + +Radius plugin, not in the port. + + +2013-06-10 - chat, pppd: Use \e instead of \\ in man pages + 8d6942415d22f6ca4377340ca26e345c3f5fa5db + +Documentation only. + + +2014-01-02 - pppd: Don't crash if NULL pointer passed to vslprintf for %q or %v + 906814431bddeb2061825fa1ebad1a967b6d87a9 + +Merged 2014-04-15. + + +2014-01-02 - pppd: Accept IPCP ConfAck packets containing MS-WINS options + a243f217f1c6ac1aa7793806bc88590d077f490a + +Merged 2014-04-15. + + +2014-01-02 - config: Update Solaris compiler options and enable CHAPMS and IPV6 + 99c46caaed01b7edba87962aa52b77fad61bfd7b + +Solaris port, don't care. + + +2014-01-02 - Update README and patchlevel for 2.4.6 release + 4043750fca36e7e0eb90d702e048ad1da4929418 + +Just release stuff. + + +2014-02-18 - pppd: Add option "stop-bits" to set number of serial port stop bits. + ad993a20ee485f0d0e2ac4105221641b200da6e2 + +Low level serial port, not in the port. + + +2014-03-09 - pppd: Separate IPv6 handling for sifup/sifdown + b04d2dc6df5c6b5650fea44250d58757ee3dac4a + +Reimplemented. + + +2014-03-09 - pppol2tp: Connect up/down events to notifiers and add IPv6 ones + fafbe50251efc7d6b4a8be652d085316e112b34f + +Not in the port. + + +2014-03-09 - pppd: Add declarations to eliminate compile warnings + 50967962addebe15c7a7e63116ff46a0441dc464 + +We are handling compilation warnings on our own + + +2014-03-09 - pppd: Eliminate some unnecessary ifdefs + de8da14d845ee6db9236ccfddabf1d8ebf045ddb + +We mostly did that previously. Anyway, merged 2014-12-24. + + +2014-08-01 - radius: Fix realms-config-file option + 880a81be7c8e0fe8567227bc17a1bff3ea035943 + +Radius plugin, not in the port. + + +2014-08-01 - pppd: Eliminate potential integer overflow in option parsing + 7658e8257183f062dc01f87969c140707c7e52cb + +pppd config file parser, not in the port. + + +2014-08-01 - pppd: Eliminate memory leak with multiple instances of a string option + b94b7fbbaa0589aa6ec5fdc733aeb9ff294d2656 + +pppd config file parser, not in the port. + + +2014-08-01 - pppd: Fix a stack variable overflow in MSCHAP-v2 + 36733a891fb56594fcee580f667b33a64b990981 + +This fixes a bug introduced in 08ef47ca ("pppd: Make MSCHAP-v2 cope better with packet loss"). + +We didn't merge 08ef47ca ;-) + + +2014-08-01 - winbind plugin: Add -DMPPE=1 to eliminate compiler warnings + 2b05e22c62095e97dd0a97e4b5588402c2185071 + +Linux plugin, not in the port. + + +2014-08-09 - Update README and patchlevel for 2.4.7 release + 6e8eaa7a78b31cdab2edf140a9c8afdb02ffaca5 + +Just release stuff. diff --git a/components/lwip/netif/ppp/auth.c b/components/lwip/netif/ppp/auth.c new file mode 100755 index 000000000..2f611d571 --- /dev/null +++ b/components/lwip/netif/ppp/auth.c @@ -0,0 +1,2497 @@ +/* + * auth.c - PPP authentication and phase control. + * + * Copyright (c) 1993-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * Derived from main.c, which is: + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#if defined(_PATH_LASTLOG) && defined(__linux__) +#include +#endif + +#include +#include +#include + +#ifdef HAS_SHADOW +#include +#ifndef PW_PPP +#define PW_PPP PW_LOGIN +#endif +#endif + +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/lcp.h" +#if CCP_SUPPORT +#include "netif/ppp/ccp.h" +#endif /* CCP_SUPPORT */ +#if ECP_SUPPORT +#include "netif/ppp/ecp.h" +#endif /* ECP_SUPPORT */ +#include "netif/ppp/ipcp.h" +#if PAP_SUPPORT +#include "netif/ppp/upap.h" +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT +#include "netif/ppp/chap-new.h" +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT +#include "netif/ppp/eap.h" +#endif /* EAP_SUPPORT */ +#if CBCP_SUPPORT +#include "netif/ppp/cbcp.h" +#endif + +#if 0 /* UNUSED */ +#include "session.h" +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +/* Bits in scan_authfile return value */ +#define NONWILD_SERVER 1 +#define NONWILD_CLIENT 2 + +#define ISWILD(word) (word[0] == '*' && word[1] == 0) +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +/* List of addresses which the peer may use. */ +static struct permitted_ip *addresses[NUM_PPP]; + +/* Wordlist giving addresses which the peer may use + without authenticating itself. */ +static struct wordlist *noauth_addrs; + +/* Remote telephone number, if available */ +char remote_number[MAXNAMELEN]; + +/* Wordlist giving remote telephone numbers which may connect. */ +static struct wordlist *permitted_numbers; + +/* Extra options to apply, from the secrets file entry for the peer. */ +static struct wordlist *extra_options; +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +/* Set if we require authentication only because we have a default route. */ +static bool default_auth; + +/* Hook to enable a plugin to control the idle time limit */ +int (*idle_time_hook) (struct ppp_idle *) = NULL; + +/* Hook for a plugin to say whether we can possibly authenticate any peer */ +int (*pap_check_hook) (void) = NULL; + +/* Hook for a plugin to check the PAP user and password */ +int (*pap_auth_hook) (char *user, char *passwd, char **msgp, + struct wordlist **paddrs, + struct wordlist **popts) = NULL; + +/* Hook for a plugin to know about the PAP user logout */ +void (*pap_logout_hook) (void) = NULL; + +/* Hook for a plugin to get the PAP password for authenticating us */ +int (*pap_passwd_hook) (char *user, char *passwd) = NULL; + +/* Hook for a plugin to say if we can possibly authenticate a peer using CHAP */ +int (*chap_check_hook) (void) = NULL; + +/* Hook for a plugin to get the CHAP password for authenticating us */ +int (*chap_passwd_hook) (char *user, char *passwd) = NULL; + +/* Hook for a plugin to say whether it is OK if the peer + refuses to authenticate. */ +int (*null_auth_hook) (struct wordlist **paddrs, + struct wordlist **popts) = NULL; + +int (*allowed_address_hook) (u32_t addr) = NULL; +#endif /* UNUSED */ + +#ifdef HAVE_MULTILINK +/* Hook for plugin to hear when an interface joins a multilink bundle */ +void (*multilink_join_hook) (void) = NULL; +#endif + +#if PPP_NOTIFY +/* A notifier for when the peer has authenticated itself, + and we are proceeding to the network phase. */ +struct notifier *auth_up_notifier = NULL; + +/* A notifier for when the link goes down. */ +struct notifier *link_down_notifier = NULL; +#endif /* PPP_NOTIFY */ + +/* + * Option variables. + */ +#if 0 /* MOVED TO ppp_settings */ +bool uselogin = 0; /* Use /etc/passwd for checking PAP */ +bool session_mgmt = 0; /* Do session management (login records) */ +bool cryptpap = 0; /* Passwords in pap-secrets are encrypted */ +bool refuse_pap = 0; /* Don't wanna auth. ourselves with PAP */ +bool refuse_chap = 0; /* Don't wanna auth. ourselves with CHAP */ +bool refuse_eap = 0; /* Don't wanna auth. ourselves with EAP */ +#if MSCHAP_SUPPORT +bool refuse_mschap = 0; /* Don't wanna auth. ourselves with MS-CHAP */ +bool refuse_mschap_v2 = 0; /* Don't wanna auth. ourselves with MS-CHAPv2 */ +#else /* MSCHAP_SUPPORT */ +bool refuse_mschap = 1; /* Don't wanna auth. ourselves with MS-CHAP */ +bool refuse_mschap_v2 = 1; /* Don't wanna auth. ourselves with MS-CHAPv2 */ +#endif /* MSCHAP_SUPPORT */ +bool usehostname = 0; /* Use hostname for our_name */ +bool auth_required = 0; /* Always require authentication from peer */ +bool allow_any_ip = 0; /* Allow peer to use any IP address */ +bool explicit_remote = 0; /* User specified explicit remote name */ +bool explicit_user = 0; /* Set if "user" option supplied */ +bool explicit_passwd = 0; /* Set if "password" option supplied */ +char remote_name[MAXNAMELEN]; /* Peer's name for authentication */ +static char *uafname; /* name of most recent +ua file */ + +extern char *crypt (const char *, const char *); +#endif /* UNUSED */ +/* Prototypes for procedures local to this file. */ + +static void network_phase(ppp_pcb *pcb); +#if PPP_IDLETIMELIMIT +static void check_idle(void *arg); +#endif /* PPP_IDLETIMELIMIT */ +#if PPP_MAXCONNECT +static void connect_time_expired(void *arg); +#endif /* PPP_MAXCONNECT */ +#if 0 /* UNUSED */ +static int null_login (int); +/* static int get_pap_passwd (char *); */ +static int have_pap_secret (int *); +static int have_chap_secret (char *, char *, int, int *); +static int have_srp_secret (char *client, char *server, int need_ip, + int *lacks_ipp); +static int ip_addr_check (u32_t, struct permitted_ip *); +static int scan_authfile (FILE *, char *, char *, char *, + struct wordlist **, struct wordlist **, + char *, int); +static void free_wordlist (struct wordlist *); +static void set_allowed_addrs (int, struct wordlist *, struct wordlist *); +static int some_ip_ok (struct wordlist *); +static int setupapfile (char **); +static int privgroup (char **); +static int set_noauth_addr (char **); +static int set_permitted_number (char **); +static void check_access (FILE *, char *); +static int wordlist_count (struct wordlist *); +#endif /* UNUSED */ + +#ifdef MAXOCTETS +static void check_maxoctets (void *); +#endif + +#if PPP_OPTIONS +/* + * Authentication-related options. + */ +option_t auth_options[] = { + { "auth", o_bool, &auth_required, + "Require authentication from peer", OPT_PRIO | 1 }, + { "noauth", o_bool, &auth_required, + "Don't require peer to authenticate", OPT_PRIOSUB | OPT_PRIV, + &allow_any_ip }, + { "require-pap", o_bool, &lcp_wantoptions[0].neg_upap, + "Require PAP authentication from peer", + OPT_PRIOSUB | 1, &auth_required }, + { "+pap", o_bool, &lcp_wantoptions[0].neg_upap, + "Require PAP authentication from peer", + OPT_ALIAS | OPT_PRIOSUB | 1, &auth_required }, + { "require-chap", o_bool, &auth_required, + "Require CHAP authentication from peer", + OPT_PRIOSUB | OPT_A2OR | MDTYPE_MD5, + &lcp_wantoptions[0].chap_mdtype }, + { "+chap", o_bool, &auth_required, + "Require CHAP authentication from peer", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2OR | MDTYPE_MD5, + &lcp_wantoptions[0].chap_mdtype }, +#if MSCHAP_SUPPORT + { "require-mschap", o_bool, &auth_required, + "Require MS-CHAP authentication from peer", + OPT_PRIOSUB | OPT_A2OR | MDTYPE_MICROSOFT, + &lcp_wantoptions[0].chap_mdtype }, + { "+mschap", o_bool, &auth_required, + "Require MS-CHAP authentication from peer", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2OR | MDTYPE_MICROSOFT, + &lcp_wantoptions[0].chap_mdtype }, + { "require-mschap-v2", o_bool, &auth_required, + "Require MS-CHAPv2 authentication from peer", + OPT_PRIOSUB | OPT_A2OR | MDTYPE_MICROSOFT_V2, + &lcp_wantoptions[0].chap_mdtype }, + { "+mschap-v2", o_bool, &auth_required, + "Require MS-CHAPv2 authentication from peer", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2OR | MDTYPE_MICROSOFT_V2, + &lcp_wantoptions[0].chap_mdtype }, +#endif /* MSCHAP_SUPPORT */ +#if 0 + { "refuse-pap", o_bool, &refuse_pap, + "Don't agree to auth to peer with PAP", 1 }, + { "-pap", o_bool, &refuse_pap, + "Don't allow PAP authentication with peer", OPT_ALIAS | 1 }, + { "refuse-chap", o_bool, &refuse_chap, + "Don't agree to auth to peer with CHAP", + OPT_A2CLRB | MDTYPE_MD5, + &lcp_allowoptions[0].chap_mdtype }, + { "-chap", o_bool, &refuse_chap, + "Don't allow CHAP authentication with peer", + OPT_ALIAS | OPT_A2CLRB | MDTYPE_MD5, + &lcp_allowoptions[0].chap_mdtype }, +#endif +#if MSCHAP_SUPPORT +#if 0 + { "refuse-mschap", o_bool, &refuse_mschap, + "Don't agree to auth to peer with MS-CHAP", + OPT_A2CLRB | MDTYPE_MICROSOFT, + &lcp_allowoptions[0].chap_mdtype }, + { "-mschap", o_bool, &refuse_mschap, + "Don't allow MS-CHAP authentication with peer", + OPT_ALIAS | OPT_A2CLRB | MDTYPE_MICROSOFT, + &lcp_allowoptions[0].chap_mdtype }, + { "refuse-mschap-v2", o_bool, &refuse_mschap_v2, + "Don't agree to auth to peer with MS-CHAPv2", + OPT_A2CLRB | MDTYPE_MICROSOFT_V2, + &lcp_allowoptions[0].chap_mdtype }, + { "-mschap-v2", o_bool, &refuse_mschap_v2, + "Don't allow MS-CHAPv2 authentication with peer", + OPT_ALIAS | OPT_A2CLRB | MDTYPE_MICROSOFT_V2, + &lcp_allowoptions[0].chap_mdtype }, +#endif +#endif /* MSCHAP_SUPPORT*/ +#if EAP_SUPPORT + { "require-eap", o_bool, &lcp_wantoptions[0].neg_eap, + "Require EAP authentication from peer", OPT_PRIOSUB | 1, + &auth_required }, +#if 0 + { "refuse-eap", o_bool, &refuse_eap, + "Don't agree to authenticate to peer with EAP", 1 }, +#endif +#endif /* EAP_SUPPORT */ + { "name", o_string, our_name, + "Set local name for authentication", + OPT_PRIO | OPT_PRIV | OPT_STATIC, NULL, MAXNAMELEN }, + + { "+ua", o_special, (void *)setupapfile, + "Get PAP user and password from file", + OPT_PRIO | OPT_A2STRVAL, &uafname }, + +#if 0 + { "user", o_string, user, + "Set name for auth with peer", OPT_PRIO | OPT_STATIC, + &explicit_user, MAXNAMELEN }, + + { "password", o_string, passwd, + "Password for authenticating us to the peer", + OPT_PRIO | OPT_STATIC | OPT_HIDE, + &explicit_passwd, MAXSECRETLEN }, +#endif + + { "usehostname", o_bool, &usehostname, + "Must use hostname for authentication", 1 }, + + { "remotename", o_string, remote_name, + "Set remote name for authentication", OPT_PRIO | OPT_STATIC, + &explicit_remote, MAXNAMELEN }, + + { "login", o_bool, &uselogin, + "Use system password database for PAP", OPT_A2COPY | 1 , + &session_mgmt }, + { "enable-session", o_bool, &session_mgmt, + "Enable session accounting for remote peers", OPT_PRIV | 1 }, + + { "papcrypt", o_bool, &cryptpap, + "PAP passwords are encrypted", 1 }, + + { "privgroup", o_special, (void *)privgroup, + "Allow group members to use privileged options", OPT_PRIV | OPT_A2LIST }, + + { "allow-ip", o_special, (void *)set_noauth_addr, + "Set IP address(es) which can be used without authentication", + OPT_PRIV | OPT_A2LIST }, + + { "remotenumber", o_string, remote_number, + "Set remote telephone number for authentication", OPT_PRIO | OPT_STATIC, + NULL, MAXNAMELEN }, + + { "allow-number", o_special, (void *)set_permitted_number, + "Set telephone number(s) which are allowed to connect", + OPT_PRIV | OPT_A2LIST }, + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +#if 0 /* UNUSED */ +/* + * setupapfile - specifies UPAP info for authenticating with peer. + */ +static int +setupapfile(argv) + char **argv; +{ + FILE *ufile; + int l; + uid_t euid; + char u[MAXNAMELEN], p[MAXSECRETLEN]; + char *fname; + + lcp_allowoptions[0].neg_upap = 1; + + /* open user info file */ + fname = strdup(*argv); + if (fname == NULL) + novm("+ua file name"); + euid = geteuid(); + if (seteuid(getuid()) == -1) { + option_error("unable to reset uid before opening %s: %m", fname); + return 0; + } + ufile = fopen(fname, "r"); + if (seteuid(euid) == -1) + fatal("unable to regain privileges: %m"); + if (ufile == NULL) { + option_error("unable to open user login data file %s", fname); + return 0; + } + check_access(ufile, fname); + uafname = fname; + + /* get username */ + if (fgets(u, MAXNAMELEN - 1, ufile) == NULL + || fgets(p, MAXSECRETLEN - 1, ufile) == NULL) { + fclose(ufile); + option_error("unable to read user login data file %s", fname); + return 0; + } + fclose(ufile); + + /* get rid of newlines */ + l = strlen(u); + if (l > 0 && u[l-1] == '\n') + u[l-1] = 0; + l = strlen(p); + if (l > 0 && p[l-1] == '\n') + p[l-1] = 0; + + if (override_value("user", option_priority, fname)) { + strlcpy(ppp_settings.user, u, sizeof(ppp_settings.user)); + explicit_user = 1; + } + if (override_value("passwd", option_priority, fname)) { + strlcpy(ppp_settings.passwd, p, sizeof(ppp_settings.passwd)); + explicit_passwd = 1; + } + + return (1); +} + +/* + * privgroup - allow members of the group to have privileged access. + */ +static int +privgroup(argv) + char **argv; +{ + struct group *g; + int i; + + g = getgrnam(*argv); + if (g == 0) { + option_error("group %s is unknown", *argv); + return 0; + } + for (i = 0; i < ngroups; ++i) { + if (groups[i] == g->gr_gid) { + privileged = 1; + break; + } + } + return 1; +} + + +/* + * set_noauth_addr - set address(es) that can be used without authentication. + * Equivalent to specifying an entry like `"" * "" addr' in pap-secrets. + */ +static int +set_noauth_addr(argv) + char **argv; +{ + char *addr = *argv; + int l = strlen(addr) + 1; + struct wordlist *wp; + + wp = (struct wordlist *) malloc(sizeof(struct wordlist) + l); + if (wp == NULL) + novm("allow-ip argument"); + wp->word = (char *) (wp + 1); + wp->next = noauth_addrs; + MEMCPY(wp->word, addr, l); + noauth_addrs = wp; + return 1; +} + + +/* + * set_permitted_number - set remote telephone number(s) that may connect. + */ +static int +set_permitted_number(argv) + char **argv; +{ + char *number = *argv; + int l = strlen(number) + 1; + struct wordlist *wp; + + wp = (struct wordlist *) malloc(sizeof(struct wordlist) + l); + if (wp == NULL) + novm("allow-number argument"); + wp->word = (char *) (wp + 1); + wp->next = permitted_numbers; + MEMCPY(wp->word, number, l); + permitted_numbers = wp; + return 1; +} +#endif + +/* + * An Open on LCP has requested a change from Dead to Establish phase. + */ +void link_required(ppp_pcb *pcb) { + LWIP_UNUSED_ARG(pcb); +} + +#if 0 +/* + * Bring the link up to the point of being able to do ppp. + */ +void start_link(unit) + int unit; +{ + ppp_pcb *pcb = &ppp_pcb_list[unit]; + char *msg; + + status = EXIT_NEGOTIATION_FAILED; + new_phase(pcb, PPP_PHASE_SERIALCONN); + + hungup = 0; + devfd = the_channel->connect(); + msg = "Connect script failed"; + if (devfd < 0) + goto fail; + + /* set up the serial device as a ppp interface */ + /* + * N.B. we used to do tdb_writelock/tdb_writeunlock around this + * (from establish_ppp to set_ifunit). However, we won't be + * doing the set_ifunit in multilink mode, which is the only time + * we need the atomicity that the tdb_writelock/tdb_writeunlock + * gives us. Thus we don't need the tdb_writelock/tdb_writeunlock. + */ + fd_ppp = the_channel->establish_ppp(devfd); + msg = "ppp establishment failed"; + if (fd_ppp < 0) { + status = EXIT_FATAL_ERROR; + goto disconnect; + } + + if (!demand && ifunit >= 0) + set_ifunit(1); + + /* + * Start opening the connection and wait for + * incoming events (reply, timeout, etc.). + */ + if (ifunit >= 0) + ppp_notice("Connect: %s <--> %s", ifname, ppp_devnam); + else + ppp_notice("Starting negotiation on %s", ppp_devnam); + add_fd(fd_ppp); + + new_phase(pcb, PPP_PHASE_ESTABLISH); + + lcp_lowerup(pcb); + return; + + disconnect: + new_phase(pcb, PPP_PHASE_DISCONNECT); + if (the_channel->disconnect) + the_channel->disconnect(); + + fail: + new_phase(pcb, PPP_PHASE_DEAD); + if (the_channel->cleanup) + (*the_channel->cleanup)(); +} +#endif + +/* + * LCP has terminated the link; go to the Dead phase and take the + * physical layer down. + */ +void link_terminated(ppp_pcb *pcb) { + if (pcb->phase == PPP_PHASE_DEAD || pcb->phase == PPP_PHASE_MASTER) + return; + new_phase(pcb, PPP_PHASE_DISCONNECT); + +#if 0 /* UNUSED */ + if (pap_logout_hook) { + pap_logout_hook(); + } + session_end(devnam); +#endif /* UNUSED */ + + if (!doing_multilink) { + ppp_notice("Connection terminated."); +#if PPP_STATS_SUPPORT + print_link_stats(); +#endif /* PPP_STATS_SUPPORT */ + } else + ppp_notice("Link terminated."); + + lcp_lowerdown(pcb); + + new_phase(pcb, PPP_PHASE_DEAD); + ppp_link_terminated(pcb); +#if 0 + /* + * Delete pid files before disestablishing ppp. Otherwise it + * can happen that another pppd gets the same unit and then + * we delete its pid file. + */ + if (!doing_multilink && !demand) + remove_pidfiles(); + + /* + * If we may want to bring the link up again, transfer + * the ppp unit back to the loopback. Set the + * real serial device back to its normal mode of operation. + */ + if (fd_ppp >= 0) { + remove_fd(fd_ppp); + clean_check(); + the_channel->disestablish_ppp(devfd); + if (doing_multilink) + mp_exit_bundle(); + fd_ppp = -1; + } + if (!hungup) + lcp_lowerdown(pcb); + if (!doing_multilink && !demand) + script_unsetenv("IFNAME"); + + /* + * Run disconnector script, if requested. + * XXX we may not be able to do this if the line has hung up! + */ + if (devfd >= 0 && the_channel->disconnect) { + the_channel->disconnect(); + devfd = -1; + } + if (the_channel->cleanup) + (*the_channel->cleanup)(); + + if (doing_multilink && multilink_master) { + if (!bundle_terminating) + new_phase(pcb, PPP_PHASE_MASTER); + else + mp_bundle_terminated(); + } else + new_phase(pcb, PPP_PHASE_DEAD); +#endif +} + +/* + * LCP has gone down; it will either die or try to re-establish. + */ +void link_down(ppp_pcb *pcb) { +#if PPP_NOTIFY + notify(link_down_notifier, 0); +#endif /* PPP_NOTIFY */ + + if (!doing_multilink) { + upper_layers_down(pcb); + if (pcb->phase != PPP_PHASE_DEAD && pcb->phase != PPP_PHASE_MASTER) + new_phase(pcb, PPP_PHASE_ESTABLISH); + } + /* XXX if doing_multilink, should do something to stop + network-layer traffic on the link */ +} + +void upper_layers_down(ppp_pcb *pcb) { + int i; + const struct protent *protp; + + for (i = 0; (protp = protocols[i]) != NULL; ++i) { + if (protp->protocol != PPP_LCP && protp->lowerdown != NULL) + (*protp->lowerdown)(pcb); + if (protp->protocol < 0xC000 && protp->close != NULL) + (*protp->close)(pcb, "LCP down"); + } + pcb->num_np_open = 0; + pcb->num_np_up = 0; +} + +/* + * The link is established. + * Proceed to the Dead, Authenticate or Network phase as appropriate. + */ +void link_established(ppp_pcb *pcb) { +#if PPP_AUTH_SUPPORT + int auth; +#if PPP_SERVER + lcp_options *wo = &pcb->lcp_wantoptions; + lcp_options *go = &pcb->lcp_gotoptions; +#endif /* PPP_SERVER */ + lcp_options *ho = &pcb->lcp_hisoptions; +#endif /* PPP_AUTH_SUPPORT */ + int i; + const struct protent *protp; + + /* + * Tell higher-level protocols that LCP is up. + */ + if (!doing_multilink) { + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->protocol != PPP_LCP + && protp->lowerup != NULL) + (*protp->lowerup)(pcb); + } + +#if PPP_AUTH_SUPPORT +#if PPP_SERVER +#if PPP_ALLOWED_ADDRS + if (!auth_required && noauth_addrs != NULL) + set_allowed_addrs(unit, NULL, NULL); +#endif /* PPP_ALLOWED_ADDRS */ + + if (pcb->settings.auth_required && !(0 +#if PAP_SUPPORT + || go->neg_upap +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + || go->neg_chap +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + || go->neg_eap +#endif /* EAP_SUPPORT */ + )) { + +#if PPP_ALLOWED_ADDRS + /* + * We wanted the peer to authenticate itself, and it refused: + * if we have some address(es) it can use without auth, fine, + * otherwise treat it as though it authenticated with PAP using + * a username of "" and a password of "". If that's not OK, + * boot it out. + */ + if (noauth_addrs != NULL) { + set_allowed_addrs(unit, NULL, NULL); + } else +#endif /* PPP_ALLOWED_ADDRS */ + if (!wo->neg_upap || !pcb->settings.null_login) { + ppp_warn("peer refused to authenticate: terminating link"); +#if 0 /* UNUSED */ + status = EXIT_PEER_AUTH_FAILED; +#endif /* UNUSED */ + pcb->err_code = PPPERR_AUTHFAIL; + lcp_close(pcb, "peer refused to authenticate"); + return; + } + } +#endif /* PPP_SERVER */ + + new_phase(pcb, PPP_PHASE_AUTHENTICATE); + auth = 0; +#if PPP_SERVER +#if EAP_SUPPORT + if (go->neg_eap) { + eap_authpeer(pcb, PPP_OUR_NAME); + auth |= EAP_PEER; + } else +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT + if (go->neg_chap) { + chap_auth_peer(pcb, PPP_OUR_NAME, CHAP_DIGEST(go->chap_mdtype)); + auth |= CHAP_PEER; + } else +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + if (go->neg_upap) { + upap_authpeer(pcb); + auth |= PAP_PEER; + } else +#endif /* PAP_SUPPORT */ + {} +#endif /* PPP_SERVER */ + +#if EAP_SUPPORT + if (ho->neg_eap) { + eap_authwithpeer(pcb, pcb->settings.user); + auth |= EAP_WITHPEER; + } else +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT + if (ho->neg_chap) { + chap_auth_with_peer(pcb, pcb->settings.user, CHAP_DIGEST(ho->chap_mdtype)); + auth |= CHAP_WITHPEER; + } else +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + if (ho->neg_upap) { + upap_authwithpeer(pcb, pcb->settings.user, pcb->settings.passwd); + auth |= PAP_WITHPEER; + } else +#endif /* PAP_SUPPORT */ + {} + + pcb->auth_pending = auth; + pcb->auth_done = 0; + + if (!auth) +#endif /* PPP_AUTH_SUPPORT */ + network_phase(pcb); +} + +/* + * Proceed to the network phase. + */ +static void network_phase(ppp_pcb *pcb) { +#if CBCP_SUPPORT + ppp_pcb *pcb = &ppp_pcb_list[unit]; +#endif +#if 0 /* UNUSED */ + lcp_options *go = &lcp_gotoptions[unit]; +#endif /* UNUSED */ + +#if 0 /* UNUSED */ + /* Log calling number. */ + if (*remote_number) + ppp_notice("peer from calling number %q authorized", remote_number); +#endif /* UNUSED */ + +#if PPP_NOTIFY + /* + * If the peer had to authenticate, notify it now. + */ + if (0 +#if CHAP_SUPPORT + || go->neg_chap +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + || go->neg_upap +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + || go->neg_eap +#endif /* EAP_SUPPORT */ + ) { + notify(auth_up_notifier, 0); + } +#endif /* PPP_NOTIFY */ + +#if CBCP_SUPPORT + /* + * If we negotiated callback, do it now. + */ + if (go->neg_cbcp) { + new_phase(pcb, PPP_PHASE_CALLBACK); + (*cbcp_protent.open)(pcb); + return; + } +#endif + +#if PPP_OPTIONS + /* + * Process extra options from the secrets file + */ + if (extra_options) { + options_from_list(extra_options, 1); + free_wordlist(extra_options); + extra_options = 0; + } +#endif /* PPP_OPTIONS */ + start_networks(pcb); +} + +void start_networks(ppp_pcb *pcb) { +#if CCP_SUPPORT || ECP_SUPPORT + int i; + const struct protent *protp; +#endif /* CCP_SUPPORT || ECP_SUPPORT */ + + new_phase(pcb, PPP_PHASE_NETWORK); + +#ifdef HAVE_MULTILINK + if (multilink) { + if (mp_join_bundle()) { + if (multilink_join_hook) + (*multilink_join_hook)(); + if (updetach && !nodetach) + detach(); + return; + } + } +#endif /* HAVE_MULTILINK */ + +#ifdef PPP_FILTER + if (!demand) + set_filters(&pass_filter, &active_filter); +#endif +#if CCP_SUPPORT || ECP_SUPPORT + /* Start CCP and ECP */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if ( + (0 +#if ECP_SUPPORT + || protp->protocol == PPP_ECP +#endif /* ECP_SUPPORT */ +#if CCP_SUPPORT + || protp->protocol == PPP_CCP +#endif /* CCP_SUPPORT */ + ) + && protp->open != NULL) + (*protp->open)(pcb); +#endif /* CCP_SUPPORT || ECP_SUPPORT */ + + /* + * Bring up other network protocols iff encryption is not required. + */ + if (1 +#if ECP_SUPPORT + && !ecp_gotoptions[unit].required +#endif /* ECP_SUPPORT */ +#if MPPE_SUPPORT + && !pcb->ccp_gotoptions.mppe +#endif /* MPPE_SUPPORT */ + ) + continue_networks(pcb); +} + +void continue_networks(ppp_pcb *pcb) { + int i; + const struct protent *protp; + + /* + * Start the "real" network protocols. + */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->protocol < 0xC000 +#if CCP_SUPPORT + && protp->protocol != PPP_CCP +#endif /* CCP_SUPPORT */ +#if ECP_SUPPORT + && protp->protocol != PPP_ECP +#endif /* ECP_SUPPORT */ + && protp->open != NULL) { + (*protp->open)(pcb); + ++pcb->num_np_open; + } + + if (pcb->num_np_open == 0) + /* nothing to do */ + lcp_close(pcb, "No network protocols running"); +} + +#if PPP_AUTH_SUPPORT +#if PPP_SERVER +/* + * auth_check_passwd - Check the user name and passwd against configuration. + * + * returns: + * 0: Authentication failed. + * 1: Authentication succeeded. + * In either case, msg points to an appropriate message and msglen to the message len. + */ +int auth_check_passwd(ppp_pcb *pcb, char *auser, int userlen, char *apasswd, int passwdlen, const char **msg, int *msglen) { + int secretuserlen; + int secretpasswdlen; + + if (pcb->settings.user && pcb->settings.passwd) { + secretuserlen = (int)strlen(pcb->settings.user); + secretpasswdlen = (int)strlen(pcb->settings.passwd); + if (secretuserlen == userlen + && secretpasswdlen == passwdlen + && !memcmp(auser, pcb->settings.user, userlen) + && !memcmp(apasswd, pcb->settings.passwd, passwdlen) ) { + *msg = "Login ok"; + *msglen = sizeof("Login ok")-1; + return 1; + } + } + + *msg = "Login incorrect"; + *msglen = sizeof("Login incorrect")-1; + return 0; +} + +/* + * The peer has failed to authenticate himself using `protocol'. + */ +void auth_peer_fail(ppp_pcb *pcb, int protocol) { + LWIP_UNUSED_ARG(protocol); + /* + * Authentication failure: take the link down + */ +#if 0 /* UNUSED */ + status = EXIT_PEER_AUTH_FAILED; +#endif /* UNUSED */ + pcb->err_code = PPPERR_AUTHFAIL; + lcp_close(pcb, "Authentication failed"); +} + +/* + * The peer has been successfully authenticated using `protocol'. + */ +void auth_peer_success(ppp_pcb *pcb, int protocol, int prot_flavor, const char *name, int namelen) { + int bit; +#ifndef HAVE_MULTILINK + LWIP_UNUSED_ARG(name); + LWIP_UNUSED_ARG(namelen); +#endif /* HAVE_MULTILINK */ + + switch (protocol) { +#if CHAP_SUPPORT + case PPP_CHAP: + bit = CHAP_PEER; + switch (prot_flavor) { + case CHAP_MD5: + bit |= CHAP_MD5_PEER; + break; +#if MSCHAP_SUPPORT + case CHAP_MICROSOFT: + bit |= CHAP_MS_PEER; + break; + case CHAP_MICROSOFT_V2: + bit |= CHAP_MS2_PEER; + break; +#endif /* MSCHAP_SUPPORT */ + default: + break; + } + break; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + case PPP_PAP: + bit = PAP_PEER; + break; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + case PPP_EAP: + bit = EAP_PEER; + break; +#endif /* EAP_SUPPORT */ + default: + ppp_warn("auth_peer_success: unknown protocol %x", protocol); + return; + } + +#ifdef HAVE_MULTILINK + /* + * Save the authenticated name of the peer for later. + */ + if (namelen > (int)sizeof(pcb->peer_authname) - 1) + namelen = (int)sizeof(pcb->peer_authname) - 1; + MEMCPY(pcb->peer_authname, name, namelen); + pcb->peer_authname[namelen] = 0; +#endif /* HAVE_MULTILINK */ +#if 0 /* UNUSED */ + script_setenv("PEERNAME", , 0); +#endif /* UNUSED */ + + /* Save the authentication method for later. */ + pcb->auth_done |= bit; + + /* + * If there is no more authentication still to be done, + * proceed to the network (or callback) phase. + */ + if ((pcb->auth_pending &= ~bit) == 0) + network_phase(pcb); +} +#endif /* PPP_SERVER */ + +/* + * We have failed to authenticate ourselves to the peer using `protocol'. + */ +void auth_withpeer_fail(ppp_pcb *pcb, int protocol) { + LWIP_UNUSED_ARG(protocol); + /* + * We've failed to authenticate ourselves to our peer. + * + * Some servers keep sending CHAP challenges, but there + * is no point in persisting without any way to get updated + * authentication secrets. + * + * He'll probably take the link down, and there's not much + * we can do except wait for that. + */ + pcb->err_code = PPPERR_AUTHFAIL; + lcp_close(pcb, "Failed to authenticate ourselves to peer"); +} + +/* + * We have successfully authenticated ourselves with the peer using `protocol'. + */ +void auth_withpeer_success(ppp_pcb *pcb, int protocol, int prot_flavor) { + int bit; + const char *prot = ""; + + switch (protocol) { +#if CHAP_SUPPORT + case PPP_CHAP: + bit = CHAP_WITHPEER; + prot = "CHAP"; + switch (prot_flavor) { + case CHAP_MD5: + bit |= CHAP_MD5_WITHPEER; + break; +#if MSCHAP_SUPPORT + case CHAP_MICROSOFT: + bit |= CHAP_MS_WITHPEER; + break; + case CHAP_MICROSOFT_V2: + bit |= CHAP_MS2_WITHPEER; + break; +#endif /* MSCHAP_SUPPORT */ + default: + break; + } + break; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + case PPP_PAP: + bit = PAP_WITHPEER; + prot = "PAP"; + break; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + case PPP_EAP: + bit = EAP_WITHPEER; + prot = "EAP"; + break; +#endif /* EAP_SUPPORT */ + default: + ppp_warn("auth_withpeer_success: unknown protocol %x", protocol); + bit = 0; + /* no break */ + } + + ppp_notice("%s authentication succeeded", prot); + + /* Save the authentication method for later. */ + pcb->auth_done |= bit; + + /* + * If there is no more authentication still being done, + * proceed to the network (or callback) phase. + */ + if ((pcb->auth_pending &= ~bit) == 0) + network_phase(pcb); +} +#endif /* PPP_AUTH_SUPPORT */ + + +/* + * np_up - a network protocol has come up. + */ +void np_up(ppp_pcb *pcb, int proto) { +#if PPP_IDLETIMELIMIT + int tlim; +#endif /* PPP_IDLETIMELIMIT */ + LWIP_UNUSED_ARG(proto); + + if (pcb->num_np_up == 0) { + /* + * At this point we consider that the link has come up successfully. + */ + new_phase(pcb, PPP_PHASE_RUNNING); + +#if PPP_IDLETIMELIMIT +#if 0 /* UNUSED */ + if (idle_time_hook != 0) + tlim = (*idle_time_hook)(NULL); + else +#endif /* UNUSED */ + tlim = pcb->settings.idle_time_limit; + if (tlim > 0) + TIMEOUT(check_idle, (void*)pcb, tlim); +#endif /* PPP_IDLETIMELIMIT */ + +#if PPP_MAXCONNECT + /* + * Set a timeout to close the connection once the maximum + * connect time has expired. + */ + if (pcb->settings.maxconnect > 0) + TIMEOUT(connect_time_expired, (void*)pcb, pcb->settings.maxconnect); +#endif /* PPP_MAXCONNECT */ + +#ifdef MAXOCTETS + if (maxoctets > 0) + TIMEOUT(check_maxoctets, NULL, maxoctets_timeout); +#endif + +#if 0 /* Unused */ + /* + * Detach now, if the updetach option was given. + */ + if (updetach && !nodetach) + detach(); +#endif /* Unused */ + } + ++pcb->num_np_up; +} + +/* + * np_down - a network protocol has gone down. + */ +void np_down(ppp_pcb *pcb, int proto) { + LWIP_UNUSED_ARG(proto); + if (--pcb->num_np_up == 0) { +#if PPP_IDLETIMELIMIT + UNTIMEOUT(check_idle, (void*)pcb); +#endif /* PPP_IDLETIMELIMIT */ +#if PPP_MAXCONNECT + UNTIMEOUT(connect_time_expired, NULL); +#endif /* PPP_MAXCONNECT */ +#ifdef MAXOCTETS + UNTIMEOUT(check_maxoctets, NULL); +#endif + new_phase(pcb, PPP_PHASE_NETWORK); + } +} + +/* + * np_finished - a network protocol has finished using the link. + */ +void np_finished(ppp_pcb *pcb, int proto) { + LWIP_UNUSED_ARG(proto); + if (--pcb->num_np_open <= 0) { + /* no further use for the link: shut up shop. */ + lcp_close(pcb, "No network protocols running"); + } +} + +#ifdef MAXOCTETS +static void +check_maxoctets(arg) + void *arg; +{ +#if PPP_STATS_SUPPORT + unsigned int used; + + update_link_stats(ifunit); + link_stats_valid=0; + + switch(maxoctets_dir) { + case PPP_OCTETS_DIRECTION_IN: + used = link_stats.bytes_in; + break; + case PPP_OCTETS_DIRECTION_OUT: + used = link_stats.bytes_out; + break; + case PPP_OCTETS_DIRECTION_MAXOVERAL: + case PPP_OCTETS_DIRECTION_MAXSESSION: + used = (link_stats.bytes_in > link_stats.bytes_out) ? link_stats.bytes_in : link_stats.bytes_out; + break; + default: + used = link_stats.bytes_in+link_stats.bytes_out; + break; + } + if (used > maxoctets) { + ppp_notice("Traffic limit reached. Limit: %u Used: %u", maxoctets, used); + status = EXIT_TRAFFIC_LIMIT; + lcp_close(pcb, "Traffic limit"); +#if 0 /* UNUSED */ + need_holdoff = 0; +#endif /* UNUSED */ + } else { + TIMEOUT(check_maxoctets, NULL, maxoctets_timeout); + } +#endif /* PPP_STATS_SUPPORT */ +} +#endif /* MAXOCTETS */ + +#if PPP_IDLETIMELIMIT +/* + * check_idle - check whether the link has been idle for long + * enough that we can shut it down. + */ +static void check_idle(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + struct ppp_idle idle; + time_t itime; + int tlim; + + if (!get_idle_time(pcb, &idle)) + return; +#if 0 /* UNUSED */ + if (idle_time_hook != 0) { + tlim = idle_time_hook(&idle); + } else { +#endif /* UNUSED */ + itime = LWIP_MIN(idle.xmit_idle, idle.recv_idle); + tlim = pcb->settings.idle_time_limit - itime; +#if 0 /* UNUSED */ + } +#endif /* UNUSED */ + if (tlim <= 0) { + /* link is idle: shut it down. */ + ppp_notice("Terminating connection due to lack of activity."); + pcb->err_code = PPPERR_IDLETIMEOUT; + lcp_close(pcb, "Link inactive"); +#if 0 /* UNUSED */ + need_holdoff = 0; +#endif /* UNUSED */ + } else { + TIMEOUT(check_idle, (void*)pcb, tlim); + } +} +#endif /* PPP_IDLETIMELIMIT */ + +#if PPP_MAXCONNECT +/* + * connect_time_expired - log a message and close the connection. + */ +static void connect_time_expired(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + ppp_info("Connect time expired"); + pcb->err_code = PPPERR_CONNECTTIME; + lcp_close(pcb, "Connect time expired"); /* Close connection */ +} +#endif /* PPP_MAXCONNECT */ + +#if PPP_OPTIONS +/* + * auth_check_options - called to check authentication options. + */ +void +auth_check_options() +{ + lcp_options *wo = &lcp_wantoptions[0]; + int can_auth; + int lacks_ip; + + /* Default our_name to hostname, and user to our_name */ + if (our_name[0] == 0 || usehostname) + strlcpy(our_name, hostname, sizeof(our_name)); + /* If a blank username was explicitly given as an option, trust + the user and don't use our_name */ + if (ppp_settings.user[0] == 0 && !explicit_user) + strlcpy(ppp_settings.user, our_name, sizeof(ppp_settings.user)); + + /* + * If we have a default route, require the peer to authenticate + * unless the noauth option was given or the real user is root. + */ + if (!auth_required && !allow_any_ip && have_route_to(0) && !privileged) { + auth_required = 1; + default_auth = 1; + } + +#if CHAP_SUPPORT + /* If we selected any CHAP flavors, we should probably negotiate it. :-) */ + if (wo->chap_mdtype) + wo->neg_chap = 1; +#endif /* CHAP_SUPPORT */ + + /* If authentication is required, ask peer for CHAP, PAP, or EAP. */ + if (auth_required) { + allow_any_ip = 0; + if (1 +#if CHAP_SUPPORT + && !wo->neg_chap +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + && !wo->neg_upap +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + && !wo->neg_eap +#endif /* EAP_SUPPORT */ + ) { +#if CHAP_SUPPORT + wo->neg_chap = CHAP_MDTYPE_SUPPORTED != MDTYPE_NONE; + wo->chap_mdtype = CHAP_MDTYPE_SUPPORTED; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + wo->neg_upap = 1; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + wo->neg_eap = 1; +#endif /* EAP_SUPPORT */ + } + } else { +#if CHAP_SUPPORT + wo->neg_chap = 0; + wo->chap_mdtype = MDTYPE_NONE; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + wo->neg_upap = 0; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + wo->neg_eap = 0; +#endif /* EAP_SUPPORT */ + } + + /* + * Check whether we have appropriate secrets to use + * to authenticate the peer. Note that EAP can authenticate by way + * of a CHAP-like exchanges as well as SRP. + */ + lacks_ip = 0; +#if PAP_SUPPORT + can_auth = wo->neg_upap && (uselogin || have_pap_secret(&lacks_ip)); +#else + can_auth = 0; +#endif /* PAP_SUPPORT */ + if (!can_auth && (0 +#if CHAP_SUPPORT + || wo->neg_chap +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + || wo->neg_eap +#endif /* EAP_SUPPORT */ + )) { +#if CHAP_SUPPORT + can_auth = have_chap_secret((explicit_remote? remote_name: NULL), + our_name, 1, &lacks_ip); +#else + can_auth = 0; +#endif + } + if (!can_auth +#if EAP_SUPPORT + && wo->neg_eap +#endif /* EAP_SUPPORT */ + ) { + can_auth = have_srp_secret((explicit_remote? remote_name: NULL), + our_name, 1, &lacks_ip); + } + + if (auth_required && !can_auth && noauth_addrs == NULL) { + if (default_auth) { + option_error( +"By default the remote system is required to authenticate itself"); + option_error( +"(because this system has a default route to the internet)"); + } else if (explicit_remote) + option_error( +"The remote system (%s) is required to authenticate itself", + remote_name); + else + option_error( +"The remote system is required to authenticate itself"); + option_error( +"but I couldn't find any suitable secret (password) for it to use to do so."); + if (lacks_ip) + option_error( +"(None of the available passwords would let it use an IP address.)"); + + exit(1); + } + + /* + * Early check for remote number authorization. + */ + if (!auth_number()) { + ppp_warn("calling number %q is not authorized", remote_number); + exit(EXIT_CNID_AUTH_FAILED); + } +} +#endif /* PPP_OPTIONS */ + +#if 0 /* UNUSED */ +/* + * auth_reset - called when LCP is starting negotiations to recheck + * authentication options, i.e. whether we have appropriate secrets + * to use for authenticating ourselves and/or the peer. + */ +void +auth_reset(unit) + int unit; +{ + lcp_options *go = &lcp_gotoptions[unit]; + lcp_options *ao = &lcp_allowoptions[unit]; + int hadchap; + + hadchap = -1; + ao->neg_upap = !refuse_pap && (passwd[0] != 0 || get_pap_passwd(NULL)); + ao->neg_chap = (!refuse_chap || !refuse_mschap || !refuse_mschap_v2) + && (passwd[0] != 0 || + (hadchap = have_chap_secret(user, (explicit_remote? remote_name: + NULL), 0, NULL))); + ao->neg_eap = !refuse_eap && ( + passwd[0] != 0 || + (hadchap == 1 || (hadchap == -1 && have_chap_secret(user, + (explicit_remote? remote_name: NULL), 0, NULL))) || + have_srp_secret(user, (explicit_remote? remote_name: NULL), 0, NULL)); + + hadchap = -1; + if (go->neg_upap && !uselogin && !have_pap_secret(NULL)) + go->neg_upap = 0; + if (go->neg_chap) { + if (!(hadchap = have_chap_secret((explicit_remote? remote_name: NULL), + our_name, 1, NULL))) + go->neg_chap = 0; + } + if (go->neg_eap && + (hadchap == 0 || (hadchap == -1 && + !have_chap_secret((explicit_remote? remote_name: NULL), our_name, + 1, NULL))) && + !have_srp_secret((explicit_remote? remote_name: NULL), our_name, 1, + NULL)) + go->neg_eap = 0; +} + +/* + * check_passwd - Check the user name and passwd against the PAP secrets + * file. If requested, also check against the system password database, + * and login the user if OK. + * + * returns: + * UPAP_AUTHNAK: Authentication failed. + * UPAP_AUTHACK: Authentication succeeded. + * In either case, msg points to an appropriate message. + */ +int +check_passwd(unit, auser, userlen, apasswd, passwdlen, msg) + int unit; + char *auser; + int userlen; + char *apasswd; + int passwdlen; + char **msg; +{ + return UPAP_AUTHNAK; + int ret; + char *filename; + FILE *f; + struct wordlist *addrs = NULL, *opts = NULL; + char passwd[256], user[256]; + char secret[MAXWORDLEN]; + static int attempts = 0; + + /* + * Make copies of apasswd and auser, then null-terminate them. + * If there are unprintable characters in the password, make + * them visible. + */ + slprintf(ppp_settings.passwd, sizeof(ppp_settings.passwd), "%.*v", passwdlen, apasswd); + slprintf(ppp_settings.user, sizeof(ppp_settings.user), "%.*v", userlen, auser); + *msg = ""; + + /* + * Check if a plugin wants to handle this. + */ + if (pap_auth_hook) { + ret = (*pap_auth_hook)(ppp_settings.user, ppp_settings.passwd, msg, &addrs, &opts); + if (ret >= 0) { + /* note: set_allowed_addrs() saves opts (but not addrs): + don't free it! */ + if (ret) + set_allowed_addrs(unit, addrs, opts); + else if (opts != 0) + free_wordlist(opts); + if (addrs != 0) + free_wordlist(addrs); + BZERO(ppp_settings.passwd, sizeof(ppp_settings.passwd)); + return ret? UPAP_AUTHACK: UPAP_AUTHNAK; + } + } + + /* + * Open the file of pap secrets and scan for a suitable secret + * for authenticating this user. + */ + filename = _PATH_UPAPFILE; + addrs = opts = NULL; + ret = UPAP_AUTHNAK; + f = fopen(filename, "r"); + if (f == NULL) { + ppp_error("Can't open PAP password file %s: %m", filename); + + } else { + check_access(f, filename); + if (scan_authfile(f, ppp_settings.user, our_name, secret, &addrs, &opts, filename, 0) < 0) { + ppp_warn("no PAP secret found for %s", user); + } else { + /* + * If the secret is "@login", it means to check + * the password against the login database. + */ + int login_secret = strcmp(secret, "@login") == 0; + ret = UPAP_AUTHACK; + if (uselogin || login_secret) { + /* login option or secret is @login */ + if (session_full(ppp_settings.user, ppp_settings.passwd, devnam, msg) == 0) { + ret = UPAP_AUTHNAK; + } + } else if (session_mgmt) { + if (session_check(ppp_settings.user, NULL, devnam, NULL) == 0) { + ppp_warn("Peer %q failed PAP Session verification", user); + ret = UPAP_AUTHNAK; + } + } + if (secret[0] != 0 && !login_secret) { + /* password given in pap-secrets - must match */ + if ((cryptpap || strcmp(ppp_settings.passwd, secret) != 0) + && strcmp(crypt(ppp_settings.passwd, secret), secret) != 0) + ret = UPAP_AUTHNAK; + } + } + fclose(f); + } + + if (ret == UPAP_AUTHNAK) { + if (**msg == 0) + *msg = "Login incorrect"; + /* + * XXX can we ever get here more than once?? + * Frustrate passwd stealer programs. + * Allow 10 tries, but start backing off after 3 (stolen from login). + * On 10'th, drop the connection. + */ + if (attempts++ >= 10) { + ppp_warn("%d LOGIN FAILURES ON %s, %s", attempts, devnam, user); + lcp_close(pcb, "login failed"); + } + if (attempts > 3) + sleep((u_int) (attempts - 3) * 5); + if (opts != NULL) + free_wordlist(opts); + + } else { + attempts = 0; /* Reset count */ + if (**msg == 0) + *msg = "Login ok"; + set_allowed_addrs(unit, addrs, opts); + } + + if (addrs != NULL) + free_wordlist(addrs); + BZERO(ppp_settings.passwd, sizeof(ppp_settings.passwd)); + BZERO(secret, sizeof(secret)); + + return ret; +} + +/* + * null_login - Check if a username of "" and a password of "" are + * acceptable, and iff so, set the list of acceptable IP addresses + * and return 1. + */ +static int +null_login(unit) + int unit; +{ + char *filename; + FILE *f; + int i, ret; + struct wordlist *addrs, *opts; + char secret[MAXWORDLEN]; + + /* + * Check if a plugin wants to handle this. + */ + ret = -1; + if (null_auth_hook) + ret = (*null_auth_hook)(&addrs, &opts); + + /* + * Open the file of pap secrets and scan for a suitable secret. + */ + if (ret <= 0) { + filename = _PATH_UPAPFILE; + addrs = NULL; + f = fopen(filename, "r"); + if (f == NULL) + return 0; + check_access(f, filename); + + i = scan_authfile(f, "", our_name, secret, &addrs, &opts, filename, 0); + ret = i >= 0 && secret[0] == 0; + BZERO(secret, sizeof(secret)); + fclose(f); + } + + if (ret) + set_allowed_addrs(unit, addrs, opts); + else if (opts != 0) + free_wordlist(opts); + if (addrs != 0) + free_wordlist(addrs); + + return ret; +} + +/* + * get_pap_passwd - get a password for authenticating ourselves with + * our peer using PAP. Returns 1 on success, 0 if no suitable password + * could be found. + * Assumes passwd points to MAXSECRETLEN bytes of space (if non-null). + */ +static int +get_pap_passwd(passwd) + char *passwd; +{ + char *filename; + FILE *f; + int ret; + char secret[MAXWORDLEN]; + + /* + * Check whether a plugin wants to supply this. + */ + if (pap_passwd_hook) { + ret = (*pap_passwd_hook)(ppp_settings,user, ppp_settings.passwd); + if (ret >= 0) + return ret; + } + + filename = _PATH_UPAPFILE; + f = fopen(filename, "r"); + if (f == NULL) + return 0; + check_access(f, filename); + ret = scan_authfile(f, user, + (remote_name[0]? remote_name: NULL), + secret, NULL, NULL, filename, 0); + fclose(f); + if (ret < 0) + return 0; + if (passwd != NULL) + strlcpy(passwd, secret, MAXSECRETLEN); + BZERO(secret, sizeof(secret)); + return 1; +} + +/* + * have_pap_secret - check whether we have a PAP file with any + * secrets that we could possibly use for authenticating the peer. + */ +static int +have_pap_secret(lacks_ipp) + int *lacks_ipp; +{ + FILE *f; + int ret; + char *filename; + struct wordlist *addrs; + + /* let the plugin decide, if there is one */ + if (pap_check_hook) { + ret = (*pap_check_hook)(); + if (ret >= 0) + return ret; + } + + filename = _PATH_UPAPFILE; + f = fopen(filename, "r"); + if (f == NULL) + return 0; + + ret = scan_authfile(f, (explicit_remote? remote_name: NULL), our_name, + NULL, &addrs, NULL, filename, 0); + fclose(f); + if (ret >= 0 && !some_ip_ok(addrs)) { + if (lacks_ipp != 0) + *lacks_ipp = 1; + ret = -1; + } + if (addrs != 0) + free_wordlist(addrs); + + return ret >= 0; +} + +/* + * have_chap_secret - check whether we have a CHAP file with a + * secret that we could possibly use for authenticating `client' + * on `server'. Either can be the null string, meaning we don't + * know the identity yet. + */ +static int +have_chap_secret(client, server, need_ip, lacks_ipp) + char *client; + char *server; + int need_ip; + int *lacks_ipp; +{ + FILE *f; + int ret; + char *filename; + struct wordlist *addrs; + + if (chap_check_hook) { + ret = (*chap_check_hook)(); + if (ret >= 0) { + return ret; + } + } + + filename = _PATH_CHAPFILE; + f = fopen(filename, "r"); + if (f == NULL) + return 0; + + if (client != NULL && client[0] == 0) + client = NULL; + else if (server != NULL && server[0] == 0) + server = NULL; + + ret = scan_authfile(f, client, server, NULL, &addrs, NULL, filename, 0); + fclose(f); + if (ret >= 0 && need_ip && !some_ip_ok(addrs)) { + if (lacks_ipp != 0) + *lacks_ipp = 1; + ret = -1; + } + if (addrs != 0) + free_wordlist(addrs); + + return ret >= 0; +} + +/* + * have_srp_secret - check whether we have a SRP file with a + * secret that we could possibly use for authenticating `client' + * on `server'. Either can be the null string, meaning we don't + * know the identity yet. + */ +static int +have_srp_secret(client, server, need_ip, lacks_ipp) + char *client; + char *server; + int need_ip; + int *lacks_ipp; +{ + FILE *f; + int ret; + char *filename; + struct wordlist *addrs; + + filename = _PATH_SRPFILE; + f = fopen(filename, "r"); + if (f == NULL) + return 0; + + if (client != NULL && client[0] == 0) + client = NULL; + else if (server != NULL && server[0] == 0) + server = NULL; + + ret = scan_authfile(f, client, server, NULL, &addrs, NULL, filename, 0); + fclose(f); + if (ret >= 0 && need_ip && !some_ip_ok(addrs)) { + if (lacks_ipp != 0) + *lacks_ipp = 1; + ret = -1; + } + if (addrs != 0) + free_wordlist(addrs); + + return ret >= 0; +} +#endif /* UNUSED */ + +#if PPP_AUTH_SUPPORT +/* + * get_secret - open the CHAP secret file and return the secret + * for authenticating the given client on the given server. + * (We could be either client or server). + */ +int get_secret(ppp_pcb *pcb, const char *client, const char *server, char *secret, int *secret_len, int am_server) { + int len; + LWIP_UNUSED_ARG(server); + LWIP_UNUSED_ARG(am_server); + + if (!client || !client[0] || !pcb->settings.user || !pcb->settings.passwd || strcmp(client, pcb->settings.user)) { + return 0; + } + + len = (int)strlen(pcb->settings.passwd); + if (len > MAXSECRETLEN) { + ppp_error("Secret for %s on %s is too long", client, server); + len = MAXSECRETLEN; + } + + MEMCPY(secret, pcb->settings.passwd, len); + *secret_len = len; + return 1; + +#if 0 /* UNUSED */ + FILE *f; + int ret, len; + char *filename; + struct wordlist *addrs, *opts; + char secbuf[MAXWORDLEN]; + struct wordlist *addrs; + addrs = NULL; + + if (!am_server && ppp_settings.passwd[0] != 0) { + strlcpy(secbuf, ppp_settings.passwd, sizeof(secbuf)); + } else if (!am_server && chap_passwd_hook) { + if ( (*chap_passwd_hook)(client, secbuf) < 0) { + ppp_error("Unable to obtain CHAP password for %s on %s from plugin", + client, server); + return 0; + } + } else { + filename = _PATH_CHAPFILE; + addrs = NULL; + secbuf[0] = 0; + + f = fopen(filename, "r"); + if (f == NULL) { + ppp_error("Can't open chap secret file %s: %m", filename); + return 0; + } + check_access(f, filename); + + ret = scan_authfile(f, client, server, secbuf, &addrs, &opts, filename, 0); + fclose(f); + if (ret < 0) + return 0; + + if (am_server) + set_allowed_addrs(unit, addrs, opts); + else if (opts != 0) + free_wordlist(opts); + if (addrs != 0) + free_wordlist(addrs); + } + + len = strlen(secbuf); + if (len > MAXSECRETLEN) { + ppp_error("Secret for %s on %s is too long", client, server); + len = MAXSECRETLEN; + } + MEMCPY(secret, secbuf, len); + BZERO(secbuf, sizeof(secbuf)); + *secret_len = len; + + return 1; +#endif /* UNUSED */ +} +#endif /* PPP_AUTH_SUPPORT */ + + +#if 0 /* UNUSED */ +/* + * get_srp_secret - open the SRP secret file and return the secret + * for authenticating the given client on the given server. + * (We could be either client or server). + */ +int +get_srp_secret(unit, client, server, secret, am_server) + int unit; + char *client; + char *server; + char *secret; + int am_server; +{ + FILE *fp; + int ret; + char *filename; + struct wordlist *addrs, *opts; + + if (!am_server && ppp_settings.passwd[0] != '\0') { + strlcpy(secret, ppp_settings.passwd, MAXWORDLEN); + } else { + filename = _PATH_SRPFILE; + addrs = NULL; + + fp = fopen(filename, "r"); + if (fp == NULL) { + ppp_error("Can't open srp secret file %s: %m", filename); + return 0; + } + check_access(fp, filename); + + secret[0] = '\0'; + ret = scan_authfile(fp, client, server, secret, &addrs, &opts, + filename, am_server); + fclose(fp); + if (ret < 0) + return 0; + + if (am_server) + set_allowed_addrs(unit, addrs, opts); + else if (opts != NULL) + free_wordlist(opts); + if (addrs != NULL) + free_wordlist(addrs); + } + + return 1; +} + +/* + * set_allowed_addrs() - set the list of allowed addresses. + * Also looks for `--' indicating options to apply for this peer + * and leaves the following words in extra_options. + */ +static void +set_allowed_addrs(unit, addrs, opts) + int unit; + struct wordlist *addrs; + struct wordlist *opts; +{ + int n; + struct wordlist *ap, **plink; + struct permitted_ip *ip; + char *ptr_word, *ptr_mask; + struct hostent *hp; + struct netent *np; + u32_t a, mask, ah, offset; + struct ipcp_options *wo = &ipcp_wantoptions[unit]; + u32_t suggested_ip = 0; + + if (addresses[unit] != NULL) + free(addresses[unit]); + addresses[unit] = NULL; + if (extra_options != NULL) + free_wordlist(extra_options); + extra_options = opts; + + /* + * Count the number of IP addresses given. + */ + n = wordlist_count(addrs) + wordlist_count(noauth_addrs); + if (n == 0) + return; + ip = (struct permitted_ip *) malloc((n + 1) * sizeof(struct permitted_ip)); + if (ip == 0) + return; + + /* temporarily append the noauth_addrs list to addrs */ + for (plink = &addrs; *plink != NULL; plink = &(*plink)->next) + ; + *plink = noauth_addrs; + + n = 0; + for (ap = addrs; ap != NULL; ap = ap->next) { + /* "-" means no addresses authorized, "*" means any address allowed */ + ptr_word = ap->word; + if (strcmp(ptr_word, "-") == 0) + break; + if (strcmp(ptr_word, "*") == 0) { + ip[n].permit = 1; + ip[n].base = ip[n].mask = 0; + ++n; + break; + } + + ip[n].permit = 1; + if (*ptr_word == '!') { + ip[n].permit = 0; + ++ptr_word; + } + + mask = ~ (u32_t) 0; + offset = 0; + ptr_mask = strchr (ptr_word, '/'); + if (ptr_mask != NULL) { + int bit_count; + char *endp; + + bit_count = (int) strtol (ptr_mask+1, &endp, 10); + if (bit_count <= 0 || bit_count > 32) { + ppp_warn("invalid address length %v in auth. address list", + ptr_mask+1); + continue; + } + bit_count = 32 - bit_count; /* # bits in host part */ + if (*endp == '+') { + offset = ifunit + 1; + ++endp; + } + if (*endp != 0) { + ppp_warn("invalid address length syntax: %v", ptr_mask+1); + continue; + } + *ptr_mask = '\0'; + mask <<= bit_count; + } + + hp = gethostbyname(ptr_word); + if (hp != NULL && hp->h_addrtype == AF_INET) { + a = *(u32_t *)hp->h_addr; + } else { + np = getnetbyname (ptr_word); + if (np != NULL && np->n_addrtype == AF_INET) { + a = htonl ((u32_t)np->n_net); + if (ptr_mask == NULL) { + /* calculate appropriate mask for net */ + ah = ntohl(a); + if (IN_CLASSA(ah)) + mask = IN_CLASSA_NET; + else if (IN_CLASSB(ah)) + mask = IN_CLASSB_NET; + else if (IN_CLASSC(ah)) + mask = IN_CLASSC_NET; + } + } else { + a = inet_addr (ptr_word); + } + } + + if (ptr_mask != NULL) + *ptr_mask = '/'; + + if (a == (u32_t)-1L) { + ppp_warn("unknown host %s in auth. address list", ap->word); + continue; + } + if (offset != 0) { + if (offset >= ~mask) { + ppp_warn("interface unit %d too large for subnet %v", + ifunit, ptr_word); + continue; + } + a = htonl((ntohl(a) & mask) + offset); + mask = ~(u32_t)0; + } + ip[n].mask = htonl(mask); + ip[n].base = a & ip[n].mask; + ++n; + if (~mask == 0 && suggested_ip == 0) + suggested_ip = a; + } + *plink = NULL; + + ip[n].permit = 0; /* make the last entry forbid all addresses */ + ip[n].base = 0; /* to terminate the list */ + ip[n].mask = 0; + + addresses[unit] = ip; + + /* + * If the address given for the peer isn't authorized, or if + * the user hasn't given one, AND there is an authorized address + * which is a single host, then use that if we find one. + */ + if (suggested_ip != 0 + && (wo->hisaddr == 0 || !auth_ip_addr(unit, wo->hisaddr))) { + wo->hisaddr = suggested_ip; + /* + * Do we insist on this address? No, if there are other + * addresses authorized than the suggested one. + */ + if (n > 1) + wo->accept_remote = 1; + } +} + +/* + * auth_ip_addr - check whether the peer is authorized to use + * a given IP address. Returns 1 if authorized, 0 otherwise. + */ +int +auth_ip_addr(unit, addr) + int unit; + u32_t addr; +{ + int ok; + + /* don't allow loopback or multicast address */ + if (bad_ip_adrs(addr)) + return 0; + + if (allowed_address_hook) { + ok = allowed_address_hook(addr); + if (ok >= 0) return ok; + } + + if (addresses[unit] != NULL) { + ok = ip_addr_check(addr, addresses[unit]); + if (ok >= 0) + return ok; + } + + if (auth_required) + return 0; /* no addresses authorized */ + return allow_any_ip || privileged || !have_route_to(addr); +} + +static int +ip_addr_check(addr, addrs) + u32_t addr; + struct permitted_ip *addrs; +{ + for (; ; ++addrs) + if ((addr & addrs->mask) == addrs->base) + return addrs->permit; +} + +/* + * bad_ip_adrs - return 1 if the IP address is one we don't want + * to use, such as an address in the loopback net or a multicast address. + * addr is in network byte order. + */ +int +bad_ip_adrs(addr) + u32_t addr; +{ + addr = ntohl(addr); + return (addr >> IN_CLASSA_NSHIFT) == IN_LOOPBACKNET + || IN_MULTICAST(addr) || IN_BADCLASS(addr); +} + +/* + * some_ip_ok - check a wordlist to see if it authorizes any + * IP address(es). + */ +static int +some_ip_ok(addrs) + struct wordlist *addrs; +{ + for (; addrs != 0; addrs = addrs->next) { + if (addrs->word[0] == '-') + break; + if (addrs->word[0] != '!') + return 1; /* some IP address is allowed */ + } + return 0; +} + +/* + * auth_number - check whether the remote number is allowed to connect. + * Returns 1 if authorized, 0 otherwise. + */ +int +auth_number() +{ + struct wordlist *wp = permitted_numbers; + int l; + + /* Allow all if no authorization list. */ + if (!wp) + return 1; + + /* Allow if we have a match in the authorization list. */ + while (wp) { + /* trailing '*' wildcard */ + l = strlen(wp->word); + if ((wp->word)[l - 1] == '*') + l--; + if (!strncasecmp(wp->word, remote_number, l)) + return 1; + wp = wp->next; + } + + return 0; +} + +/* + * check_access - complain if a secret file has too-liberal permissions. + */ +static void +check_access(f, filename) + FILE *f; + char *filename; +{ + struct stat sbuf; + + if (fstat(fileno(f), &sbuf) < 0) { + ppp_warn("cannot stat secret file %s: %m", filename); + } else if ((sbuf.st_mode & (S_IRWXG | S_IRWXO)) != 0) { + ppp_warn("Warning - secret file %s has world and/or group access", + filename); + } +} + +/* + * scan_authfile - Scan an authorization file for a secret suitable + * for authenticating `client' on `server'. The return value is -1 + * if no secret is found, otherwise >= 0. The return value has + * NONWILD_CLIENT set if the secret didn't have "*" for the client, and + * NONWILD_SERVER set if the secret didn't have "*" for the server. + * Any following words on the line up to a "--" (i.e. address authorization + * info) are placed in a wordlist and returned in *addrs. Any + * following words (extra options) are placed in a wordlist and + * returned in *opts. + * We assume secret is NULL or points to MAXWORDLEN bytes of space. + * Flags are non-zero if we need two colons in the secret in order to + * match. + */ +static int +scan_authfile(f, client, server, secret, addrs, opts, filename, flags) + FILE *f; + char *client; + char *server; + char *secret; + struct wordlist **addrs; + struct wordlist **opts; + char *filename; + int flags; +{ + int newline, xxx; + int got_flag, best_flag; + FILE *sf; + struct wordlist *ap, *addr_list, *alist, **app; + char word[MAXWORDLEN]; + char atfile[MAXWORDLEN]; + char lsecret[MAXWORDLEN]; + char *cp; + + if (addrs != NULL) + *addrs = NULL; + if (opts != NULL) + *opts = NULL; + addr_list = NULL; + if (!getword(f, word, &newline, filename)) + return -1; /* file is empty??? */ + newline = 1; + best_flag = -1; + for (;;) { + /* + * Skip until we find a word at the start of a line. + */ + while (!newline && getword(f, word, &newline, filename)) + ; + if (!newline) + break; /* got to end of file */ + + /* + * Got a client - check if it's a match or a wildcard. + */ + got_flag = 0; + if (client != NULL && strcmp(word, client) != 0 && !ISWILD(word)) { + newline = 0; + continue; + } + if (!ISWILD(word)) + got_flag = NONWILD_CLIENT; + + /* + * Now get a server and check if it matches. + */ + if (!getword(f, word, &newline, filename)) + break; + if (newline) + continue; + if (!ISWILD(word)) { + if (server != NULL && strcmp(word, server) != 0) + continue; + got_flag |= NONWILD_SERVER; + } + + /* + * Got some sort of a match - see if it's better than what + * we have already. + */ + if (got_flag <= best_flag) + continue; + + /* + * Get the secret. + */ + if (!getword(f, word, &newline, filename)) + break; + if (newline) + continue; + + /* + * SRP-SHA1 authenticator should never be reading secrets from + * a file. (Authenticatee may, though.) + */ + if (flags && ((cp = strchr(word, ':')) == NULL || + strchr(cp + 1, ':') == NULL)) + continue; + + if (secret != NULL) { + /* + * Special syntax: @/pathname means read secret from file. + */ + if (word[0] == '@' && word[1] == '/') { + strlcpy(atfile, word+1, sizeof(atfile)); + if ((sf = fopen(atfile, "r")) == NULL) { + ppp_warn("can't open indirect secret file %s", atfile); + continue; + } + check_access(sf, atfile); + if (!getword(sf, word, &xxx, atfile)) { + ppp_warn("no secret in indirect secret file %s", atfile); + fclose(sf); + continue; + } + fclose(sf); + } + strlcpy(lsecret, word, sizeof(lsecret)); + } + + /* + * Now read address authorization info and make a wordlist. + */ + app = &alist; + for (;;) { + if (!getword(f, word, &newline, filename) || newline) + break; + ap = (struct wordlist *) + malloc(sizeof(struct wordlist) + strlen(word) + 1); + if (ap == NULL) + novm("authorized addresses"); + ap->word = (char *) (ap + 1); + strcpy(ap->word, word); + *app = ap; + app = &ap->next; + } + *app = NULL; + + /* + * This is the best so far; remember it. + */ + best_flag = got_flag; + if (addr_list) + free_wordlist(addr_list); + addr_list = alist; + if (secret != NULL) + strlcpy(secret, lsecret, MAXWORDLEN); + + if (!newline) + break; + } + + /* scan for a -- word indicating the start of options */ + for (app = &addr_list; (ap = *app) != NULL; app = &ap->next) + if (strcmp(ap->word, "--") == 0) + break; + /* ap = start of options */ + if (ap != NULL) { + ap = ap->next; /* first option */ + free(*app); /* free the "--" word */ + *app = NULL; /* terminate addr list */ + } + if (opts != NULL) + *opts = ap; + else if (ap != NULL) + free_wordlist(ap); + if (addrs != NULL) + *addrs = addr_list; + else if (addr_list != NULL) + free_wordlist(addr_list); + + return best_flag; +} + +/* + * wordlist_count - return the number of items in a wordlist + */ +static int +wordlist_count(wp) + struct wordlist *wp; +{ + int n; + + for (n = 0; wp != NULL; wp = wp->next) + ++n; + return n; +} + +/* + * free_wordlist - release memory allocated for a wordlist. + */ +static void +free_wordlist(wp) + struct wordlist *wp; +{ + struct wordlist *next; + + while (wp != NULL) { + next = wp->next; + free(wp); + wp = next; + } +} +#endif /* UNUSED */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/netif/ppp/ccp.c b/components/lwip/netif/ppp/ccp.c new file mode 100755 index 000000000..873cd68a4 --- /dev/null +++ b/components/lwip/netif/ppp/ccp.c @@ -0,0 +1,1741 @@ +/* + * ccp.c - PPP Compression Control Protocol. + * + * Copyright (c) 1994-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CCP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include +#include + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/ccp.h" + +#if MPPE_SUPPORT +#include "netif/ppp/lcp.h" /* lcp_close(), lcp_fsm */ +#include "netif/ppp/mppe.h" /* mppe_init() */ +#endif /* MPPE_SUPPORT */ + +/* + * Unfortunately there is a bug in zlib which means that using a + * size of 8 (window size = 256) for Deflate compression will cause + * buffer overruns and kernel crashes in the deflate module. + * Until this is fixed we only accept sizes in the range 9 .. 15. + * Thanks to James Carlson for pointing this out. + */ +#define DEFLATE_MIN_WORKS 9 + +/* + * Command-line options. + */ +#if PPP_OPTIONS +static int setbsdcomp (char **); +static int setdeflate (char **); +static char bsd_value[8]; +static char deflate_value[8]; + +/* + * Option variables. + */ +#if MPPE_SUPPORT +bool refuse_mppe_stateful = 1; /* Allow stateful mode? */ +#endif /* MPPE_SUPPORT */ + +static option_t ccp_option_list[] = { + { "noccp", o_bool, &ccp_protent.enabled_flag, + "Disable CCP negotiation" }, + { "-ccp", o_bool, &ccp_protent.enabled_flag, + "Disable CCP negotiation", OPT_ALIAS }, + + { "bsdcomp", o_special, (void *)setbsdcomp, + "Request BSD-Compress packet compression", + OPT_PRIO | OPT_A2STRVAL | OPT_STATIC, bsd_value }, + { "nobsdcomp", o_bool, &ccp_wantoptions[0].bsd_compress, + "don't allow BSD-Compress", OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].bsd_compress }, + { "-bsdcomp", o_bool, &ccp_wantoptions[0].bsd_compress, + "don't allow BSD-Compress", OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].bsd_compress }, + + { "deflate", o_special, (void *)setdeflate, + "request Deflate compression", + OPT_PRIO | OPT_A2STRVAL | OPT_STATIC, deflate_value }, + { "nodeflate", o_bool, &ccp_wantoptions[0].deflate, + "don't allow Deflate compression", OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].deflate }, + { "-deflate", o_bool, &ccp_wantoptions[0].deflate, + "don't allow Deflate compression", OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].deflate }, + + { "nodeflatedraft", o_bool, &ccp_wantoptions[0].deflate_draft, + "don't use draft deflate #", OPT_A2COPY, + &ccp_allowoptions[0].deflate_draft }, + + { "predictor1", o_bool, &ccp_wantoptions[0].predictor_1, + "request Predictor-1", OPT_PRIO | 1 }, + { "nopredictor1", o_bool, &ccp_wantoptions[0].predictor_1, + "don't allow Predictor-1", OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].predictor_1 }, + { "-predictor1", o_bool, &ccp_wantoptions[0].predictor_1, + "don't allow Predictor-1", OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLR, + &ccp_allowoptions[0].predictor_1 }, + +#if MPPE_SUPPORT + /* MPPE options are symmetrical ... we only set wantoptions here */ + { "require-mppe", o_bool, &ccp_wantoptions[0].mppe, + "require MPPE encryption", + OPT_PRIO | MPPE_OPT_40 | MPPE_OPT_128 }, + { "+mppe", o_bool, &ccp_wantoptions[0].mppe, + "require MPPE encryption", + OPT_ALIAS | OPT_PRIO | MPPE_OPT_40 | MPPE_OPT_128 }, + { "nomppe", o_bool, &ccp_wantoptions[0].mppe, + "don't allow MPPE encryption", OPT_PRIO }, + { "-mppe", o_bool, &ccp_wantoptions[0].mppe, + "don't allow MPPE encryption", OPT_ALIAS | OPT_PRIO }, + + /* We use ccp_allowoptions[0].mppe as a junk var ... it is reset later */ + { "require-mppe-40", o_bool, &ccp_allowoptions[0].mppe, + "require MPPE 40-bit encryption", OPT_PRIO | OPT_A2OR | MPPE_OPT_40, + &ccp_wantoptions[0].mppe }, + { "+mppe-40", o_bool, &ccp_allowoptions[0].mppe, + "require MPPE 40-bit encryption", OPT_PRIO | OPT_A2OR | MPPE_OPT_40, + &ccp_wantoptions[0].mppe }, + { "nomppe-40", o_bool, &ccp_allowoptions[0].mppe, + "don't allow MPPE 40-bit encryption", + OPT_PRIOSUB | OPT_A2CLRB | MPPE_OPT_40, &ccp_wantoptions[0].mppe }, + { "-mppe-40", o_bool, &ccp_allowoptions[0].mppe, + "don't allow MPPE 40-bit encryption", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLRB | MPPE_OPT_40, + &ccp_wantoptions[0].mppe }, + + { "require-mppe-128", o_bool, &ccp_allowoptions[0].mppe, + "require MPPE 128-bit encryption", OPT_PRIO | OPT_A2OR | MPPE_OPT_128, + &ccp_wantoptions[0].mppe }, + { "+mppe-128", o_bool, &ccp_allowoptions[0].mppe, + "require MPPE 128-bit encryption", + OPT_ALIAS | OPT_PRIO | OPT_A2OR | MPPE_OPT_128, + &ccp_wantoptions[0].mppe }, + { "nomppe-128", o_bool, &ccp_allowoptions[0].mppe, + "don't allow MPPE 128-bit encryption", + OPT_PRIOSUB | OPT_A2CLRB | MPPE_OPT_128, &ccp_wantoptions[0].mppe }, + { "-mppe-128", o_bool, &ccp_allowoptions[0].mppe, + "don't allow MPPE 128-bit encryption", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLRB | MPPE_OPT_128, + &ccp_wantoptions[0].mppe }, + + /* strange one; we always request stateless, but will we allow stateful? */ + { "mppe-stateful", o_bool, &refuse_mppe_stateful, + "allow MPPE stateful mode", OPT_PRIO }, + { "nomppe-stateful", o_bool, &refuse_mppe_stateful, + "disallow MPPE stateful mode", OPT_PRIO | 1 }, +#endif /* MPPE_SUPPORT */ + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points from main code. + */ +static void ccp_init(ppp_pcb *pcb); +static void ccp_open(ppp_pcb *pcb); +static void ccp_close(ppp_pcb *pcb, const char *reason); +static void ccp_lowerup(ppp_pcb *pcb); +static void ccp_lowerdown(ppp_pcb *pcb); +static void ccp_input(ppp_pcb *pcb, u_char *pkt, int len); +static void ccp_protrej(ppp_pcb *pcb); +#if PRINTPKT_SUPPORT +static int ccp_printpkt(const u_char *p, int plen, void (*printer) (void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT +static void ccp_datainput(ppp_pcb *pcb, u_char *pkt, int len); +#endif /* PPP_DATAINPUT */ + +const struct protent ccp_protent = { + PPP_CCP, + ccp_init, + ccp_input, + ccp_protrej, + ccp_lowerup, + ccp_lowerdown, + ccp_open, + ccp_close, +#if PRINTPKT_SUPPORT + ccp_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + ccp_datainput, +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "CCP", + "Compressed", +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + ccp_option_list, + NULL, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, + NULL +#endif /* DEMAND_SUPPORT */ +}; + +/* + * Callbacks for fsm code. + */ +static void ccp_resetci (fsm *); +static int ccp_cilen (fsm *); +static void ccp_addci (fsm *, u_char *, int *); +static int ccp_ackci (fsm *, u_char *, int); +static int ccp_nakci (fsm *, u_char *, int, int); +static int ccp_rejci (fsm *, u_char *, int); +static int ccp_reqci (fsm *, u_char *, int *, int); +static void ccp_up (fsm *); +static void ccp_down (fsm *); +static int ccp_extcode (fsm *, int, int, u_char *, int); +static void ccp_rack_timeout (void *); +static const char *method_name (ccp_options *, ccp_options *); + +static const fsm_callbacks ccp_callbacks = { + ccp_resetci, + ccp_cilen, + ccp_addci, + ccp_ackci, + ccp_nakci, + ccp_rejci, + ccp_reqci, + ccp_up, + ccp_down, + NULL, + NULL, + NULL, + NULL, + ccp_extcode, + "CCP" +}; + +/* + * Do we want / did we get any compression? + */ +static int ccp_anycompress(ccp_options *opt) { + return (0 +#if DEFLATE_SUPPORT + || (opt)->deflate +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + || (opt)->bsd_compress +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + || (opt)->predictor_1 || (opt)->predictor_2 +#endif /* PREDICTOR_SUPPORT */ +#if MPPE_SUPPORT + || (opt)->mppe +#endif /* MPPE_SUPPORT */ + ); +} + +/* + * Local state (mainly for handling reset-reqs and reset-acks). + */ +#define RACK_PENDING 1 /* waiting for reset-ack */ +#define RREQ_REPEAT 2 /* send another reset-req if no reset-ack */ + +#define RACKTIMEOUT 1 /* second */ + +#if PPP_OPTIONS +/* + * Option parsing + */ +static int +setbsdcomp(argv) + char **argv; +{ + int rbits, abits; + char *str, *endp; + + str = *argv; + abits = rbits = strtol(str, &endp, 0); + if (endp != str && *endp == ',') { + str = endp + 1; + abits = strtol(str, &endp, 0); + } + if (*endp != 0 || endp == str) { + option_error("invalid parameter '%s' for bsdcomp option", *argv); + return 0; + } + if ((rbits != 0 && (rbits < BSD_MIN_BITS || rbits > BSD_MAX_BITS)) + || (abits != 0 && (abits < BSD_MIN_BITS || abits > BSD_MAX_BITS))) { + option_error("bsdcomp option values must be 0 or %d .. %d", + BSD_MIN_BITS, BSD_MAX_BITS); + return 0; + } + if (rbits > 0) { + ccp_wantoptions[0].bsd_compress = 1; + ccp_wantoptions[0].bsd_bits = rbits; + } else + ccp_wantoptions[0].bsd_compress = 0; + if (abits > 0) { + ccp_allowoptions[0].bsd_compress = 1; + ccp_allowoptions[0].bsd_bits = abits; + } else + ccp_allowoptions[0].bsd_compress = 0; + ppp_slprintf(bsd_value, sizeof(bsd_value), + rbits == abits? "%d": "%d,%d", rbits, abits); + + return 1; +} + +static int +setdeflate(argv) + char **argv; +{ + int rbits, abits; + char *str, *endp; + + str = *argv; + abits = rbits = strtol(str, &endp, 0); + if (endp != str && *endp == ',') { + str = endp + 1; + abits = strtol(str, &endp, 0); + } + if (*endp != 0 || endp == str) { + option_error("invalid parameter '%s' for deflate option", *argv); + return 0; + } + if ((rbits != 0 && (rbits < DEFLATE_MIN_SIZE || rbits > DEFLATE_MAX_SIZE)) + || (abits != 0 && (abits < DEFLATE_MIN_SIZE + || abits > DEFLATE_MAX_SIZE))) { + option_error("deflate option values must be 0 or %d .. %d", + DEFLATE_MIN_SIZE, DEFLATE_MAX_SIZE); + return 0; + } + if (rbits == DEFLATE_MIN_SIZE || abits == DEFLATE_MIN_SIZE) { + if (rbits == DEFLATE_MIN_SIZE) + rbits = DEFLATE_MIN_WORKS; + if (abits == DEFLATE_MIN_SIZE) + abits = DEFLATE_MIN_WORKS; + warn("deflate option value of %d changed to %d to avoid zlib bug", + DEFLATE_MIN_SIZE, DEFLATE_MIN_WORKS); + } + if (rbits > 0) { + ccp_wantoptions[0].deflate = 1; + ccp_wantoptions[0].deflate_size = rbits; + } else + ccp_wantoptions[0].deflate = 0; + if (abits > 0) { + ccp_allowoptions[0].deflate = 1; + ccp_allowoptions[0].deflate_size = abits; + } else + ccp_allowoptions[0].deflate = 0; + ppp_slprintf(deflate_value, sizeof(deflate_value), + rbits == abits? "%d": "%d,%d", rbits, abits); + + return 1; +} +#endif /* PPP_OPTIONS */ + +/* + * ccp_init - initialize CCP. + */ +static void ccp_init(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; + ccp_options *wo = &pcb->ccp_wantoptions; + ccp_options *ao = &pcb->ccp_allowoptions; + + f->pcb = pcb; + f->protocol = PPP_CCP; + f->callbacks = &ccp_callbacks; + fsm_init(f); + +#if 0 /* Not necessary, everything is cleared in ppp_clear() */ + memset(wo, 0, sizeof(*wo)); + memset(go, 0, sizeof(*go)); + memset(ao, 0, sizeof(*ao)); + memset(ho, 0, sizeof(*ho)); +#endif /* 0 */ + +#if DEFLATE_SUPPORT + wo->deflate = 1; + wo->deflate_size = DEFLATE_MAX_SIZE; + wo->deflate_correct = 1; + wo->deflate_draft = 1; + ao->deflate = 1; + ao->deflate_size = DEFLATE_MAX_SIZE; + ao->deflate_correct = 1; + ao->deflate_draft = 1; +#endif /* DEFLATE_SUPPORT */ + +#if BSDCOMPRESS_SUPPORT + wo->bsd_compress = 1; + wo->bsd_bits = BSD_MAX_BITS; + ao->bsd_compress = 1; + ao->bsd_bits = BSD_MAX_BITS; +#endif /* BSDCOMPRESS_SUPPORT */ + +#if PREDICTOR_SUPPORT + ao->predictor_1 = 1; +#endif /* PREDICTOR_SUPPORT */ + +#if MPPE_SUPPORT + if (pcb->settings.require_mppe) { + wo->mppe = ao->mppe = + (pcb->settings.refuse_mppe_40 ? 0 : MPPE_OPT_40) + | (pcb->settings.refuse_mppe_128 ? 0 : MPPE_OPT_128); + } +#endif /* MPPE_SUPPORT */ +} + +/* + * ccp_open - CCP is allowed to come up. + */ +static void ccp_open(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; + ccp_options *go = &pcb->ccp_gotoptions; + + if (f->state != PPP_FSM_OPENED) + ccp_set(pcb, 1, 0, 0, 0); + + /* + * Find out which compressors the kernel supports before + * deciding whether to open in silent mode. + */ + ccp_resetci(f); + if (!ccp_anycompress(go)) + f->flags |= OPT_SILENT; + + fsm_open(f); +} + +/* + * ccp_close - Terminate CCP. + */ +static void ccp_close(ppp_pcb *pcb, const char *reason) { + fsm *f = &pcb->ccp_fsm; + ccp_set(pcb, 0, 0, 0, 0); + fsm_close(f, reason); +} + +/* + * ccp_lowerup - we may now transmit CCP packets. + */ +static void ccp_lowerup(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; + fsm_lowerup(f); +} + +/* + * ccp_lowerdown - we may not transmit CCP packets. + */ +static void ccp_lowerdown(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; + fsm_lowerdown(f); +} + +/* + * ccp_input - process a received CCP packet. + */ +static void ccp_input(ppp_pcb *pcb, u_char *p, int len) { + fsm *f = &pcb->ccp_fsm; + ccp_options *go = &pcb->ccp_gotoptions; + int oldstate; + + /* + * Check for a terminate-request so we can print a message. + */ + oldstate = f->state; + fsm_input(f, p, len); + if (oldstate == PPP_FSM_OPENED && p[0] == TERMREQ && f->state != PPP_FSM_OPENED) { + ppp_notice("Compression disabled by peer."); +#if MPPE_SUPPORT + if (go->mppe) { + ppp_error("MPPE disabled, closing LCP"); + lcp_close(pcb, "MPPE disabled by peer"); + } +#endif /* MPPE_SUPPORT */ + } + + /* + * If we get a terminate-ack and we're not asking for compression, + * close CCP. + */ + if (oldstate == PPP_FSM_REQSENT && p[0] == TERMACK + && !ccp_anycompress(go)) + ccp_close(pcb, "No compression negotiated"); +} + +/* + * Handle a CCP-specific code. + */ +static int ccp_extcode(fsm *f, int code, int id, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + LWIP_UNUSED_ARG(p); + LWIP_UNUSED_ARG(len); + + switch (code) { + case CCP_RESETREQ: + if (f->state != PPP_FSM_OPENED) + break; + ccp_reset_comp(pcb); + /* send a reset-ack, which the transmitter will see and + reset its compression state. */ + fsm_sdata(f, CCP_RESETACK, id, NULL, 0); + break; + + case CCP_RESETACK: + if ((pcb->ccp_localstate & RACK_PENDING) && id == f->reqid) { + pcb->ccp_localstate &= ~(RACK_PENDING | RREQ_REPEAT); + UNTIMEOUT(ccp_rack_timeout, f); + ccp_reset_decomp(pcb); + } + break; + + default: + return 0; + } + + return 1; +} + +/* + * ccp_protrej - peer doesn't talk CCP. + */ +static void ccp_protrej(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; +#if MPPE_SUPPORT + ccp_options *go = &pcb->ccp_gotoptions; +#endif /* MPPE_SUPPORT */ + + ccp_set(pcb, 0, 0, 0, 0); + fsm_lowerdown(f); + +#if MPPE_SUPPORT + if (go->mppe) { + ppp_error("MPPE required but peer negotiation failed"); + lcp_close(pcb, "MPPE required but peer negotiation failed"); + } +#endif /* MPPE_SUPPORT */ + +} + +/* + * ccp_resetci - initialize at start of negotiation. + */ +static void ccp_resetci(fsm *f) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + ccp_options *wo = &pcb->ccp_wantoptions; +#if DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT || PREDICTOR_SUPPORT + u_char opt_buf[CCP_MAX_OPTION_LENGTH]; +#endif /* DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT || PREDICTOR_SUPPORT */ +#if DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT + int res; +#endif /* DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT */ + + *go = *wo; + pcb->ccp_all_rejected = 0; + +#if MPPE_SUPPORT + if (go->mppe) { + ccp_options *ao = &pcb->ccp_allowoptions; + int auth_mschap_bits = pcb->auth_done; + int numbits; + + /* + * Start with a basic sanity check: mschap[v2] auth must be in + * exactly one direction. RFC 3079 says that the keys are + * 'derived from the credentials of the peer that initiated the call', + * however the PPP protocol doesn't have such a concept, and pppd + * cannot get this info externally. Instead we do the best we can. + * NB: If MPPE is required, all other compression opts are invalid. + * So, we return right away if we can't do it. + */ + + /* Leave only the mschap auth bits set */ + auth_mschap_bits &= (CHAP_MS_WITHPEER | CHAP_MS_PEER | + CHAP_MS2_WITHPEER | CHAP_MS2_PEER); + /* Count the mschap auths */ + auth_mschap_bits >>= CHAP_MS_SHIFT; + numbits = 0; + do { + numbits += auth_mschap_bits & 1; + auth_mschap_bits >>= 1; + } while (auth_mschap_bits); + if (numbits > 1) { + ppp_error("MPPE required, but auth done in both directions."); + lcp_close(pcb, "MPPE required but not available"); + return; + } + if (!numbits) { + ppp_error("MPPE required, but MS-CHAP[v2] auth not performed."); + lcp_close(pcb, "MPPE required but not available"); + return; + } + + /* A plugin (eg radius) may not have obtained key material. */ + if (!pcb->mppe_keys_set) { + ppp_error("MPPE required, but keys are not available. " + "Possible plugin problem?"); + lcp_close(pcb, "MPPE required but not available"); + return; + } + + /* LM auth not supported for MPPE */ + if (pcb->auth_done & (CHAP_MS_WITHPEER | CHAP_MS_PEER)) { + /* This might be noise */ + if (go->mppe & MPPE_OPT_40) { + ppp_notice("Disabling 40-bit MPPE; MS-CHAP LM not supported"); + go->mppe &= ~MPPE_OPT_40; + wo->mppe &= ~MPPE_OPT_40; + } + } + + /* Last check: can we actually negotiate something? */ + if (!(go->mppe & (MPPE_OPT_40 | MPPE_OPT_128))) { + /* Could be misconfig, could be 40-bit disabled above. */ + ppp_error("MPPE required, but both 40-bit and 128-bit disabled."); + lcp_close(pcb, "MPPE required but not available"); + return; + } + + /* sync options */ + ao->mppe = go->mppe; + /* MPPE is not compatible with other compression types */ +#if BSDCOMPRESS_SUPPORT + ao->bsd_compress = go->bsd_compress = 0; +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + ao->predictor_1 = go->predictor_1 = 0; + ao->predictor_2 = go->predictor_2 = 0; +#endif /* PREDICTOR_SUPPORT */ +#if DEFLATE_SUPPORT + ao->deflate = go->deflate = 0; +#endif /* DEFLATE_SUPPORT */ + } +#endif /* MPPE_SUPPORT */ + + /* + * Check whether the kernel knows about the various + * compression methods we might request. + */ +#if BSDCOMPRESS_SUPPORT + /* FIXME: we don't need to test if BSD compress is available + * if BSDCOMPRESS_SUPPORT is set, it is. + */ + if (go->bsd_compress) { + opt_buf[0] = CI_BSD_COMPRESS; + opt_buf[1] = CILEN_BSD_COMPRESS; + for (;;) { + if (go->bsd_bits < BSD_MIN_BITS) { + go->bsd_compress = 0; + break; + } + opt_buf[2] = BSD_MAKE_OPT(BSD_CURRENT_VERSION, go->bsd_bits); + res = ccp_test(pcb, opt_buf, CILEN_BSD_COMPRESS, 0); + if (res > 0) { + break; + } else if (res < 0) { + go->bsd_compress = 0; + break; + } + go->bsd_bits--; + } + } +#endif /* BSDCOMPRESS_SUPPORT */ +#if DEFLATE_SUPPORT + /* FIXME: we don't need to test if deflate is available + * if DEFLATE_SUPPORT is set, it is. + */ + if (go->deflate) { + if (go->deflate_correct) { + opt_buf[0] = CI_DEFLATE; + opt_buf[1] = CILEN_DEFLATE; + opt_buf[3] = DEFLATE_CHK_SEQUENCE; + for (;;) { + if (go->deflate_size < DEFLATE_MIN_WORKS) { + go->deflate_correct = 0; + break; + } + opt_buf[2] = DEFLATE_MAKE_OPT(go->deflate_size); + res = ccp_test(pcb, opt_buf, CILEN_DEFLATE, 0); + if (res > 0) { + break; + } else if (res < 0) { + go->deflate_correct = 0; + break; + } + go->deflate_size--; + } + } + if (go->deflate_draft) { + opt_buf[0] = CI_DEFLATE_DRAFT; + opt_buf[1] = CILEN_DEFLATE; + opt_buf[3] = DEFLATE_CHK_SEQUENCE; + for (;;) { + if (go->deflate_size < DEFLATE_MIN_WORKS) { + go->deflate_draft = 0; + break; + } + opt_buf[2] = DEFLATE_MAKE_OPT(go->deflate_size); + res = ccp_test(pcb, opt_buf, CILEN_DEFLATE, 0); + if (res > 0) { + break; + } else if (res < 0) { + go->deflate_draft = 0; + break; + } + go->deflate_size--; + } + } + if (!go->deflate_correct && !go->deflate_draft) + go->deflate = 0; + } +#endif /* DEFLATE_SUPPORT */ +#if PREDICTOR_SUPPORT + /* FIXME: we don't need to test if predictor is available, + * if PREDICTOR_SUPPORT is set, it is. + */ + if (go->predictor_1) { + opt_buf[0] = CI_PREDICTOR_1; + opt_buf[1] = CILEN_PREDICTOR_1; + if (ccp_test(pcb, opt_buf, CILEN_PREDICTOR_1, 0) <= 0) + go->predictor_1 = 0; + } + if (go->predictor_2) { + opt_buf[0] = CI_PREDICTOR_2; + opt_buf[1] = CILEN_PREDICTOR_2; + if (ccp_test(pcb, opt_buf, CILEN_PREDICTOR_2, 0) <= 0) + go->predictor_2 = 0; + } +#endif /* PREDICTOR_SUPPORT */ +} + +/* + * ccp_cilen - Return total length of our configuration info. + */ +static int ccp_cilen(fsm *f) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + + return 0 +#if BSDCOMPRESS_SUPPORT + + (go->bsd_compress? CILEN_BSD_COMPRESS: 0) +#endif /* BSDCOMPRESS_SUPPORT */ +#if DEFLATE_SUPPORT + + (go->deflate && go->deflate_correct? CILEN_DEFLATE: 0) + + (go->deflate && go->deflate_draft? CILEN_DEFLATE: 0) +#endif /* DEFLATE_SUPPORT */ +#if PREDICTOR_SUPPORT + + (go->predictor_1? CILEN_PREDICTOR_1: 0) + + (go->predictor_2? CILEN_PREDICTOR_2: 0) +#endif /* PREDICTOR_SUPPORT */ +#if MPPE_SUPPORT + + (go->mppe? CILEN_MPPE: 0) +#endif /* MPPE_SUPPORT */ + ; +} + +/* + * ccp_addci - put our requests in a packet. + */ +static void ccp_addci(fsm *f, u_char *p, int *lenp) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + u_char *p0 = p; + + /* + * Add the compression types that we can receive, in decreasing + * preference order. + */ +#if MPPE_SUPPORT + if (go->mppe) { + p[0] = CI_MPPE; + p[1] = CILEN_MPPE; + MPPE_OPTS_TO_CI(go->mppe, &p[2]); + mppe_init(pcb, &pcb->mppe_decomp, go->mppe); + p += CILEN_MPPE; + } +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + if (go->deflate) { + if (go->deflate_correct) { + p[0] = CI_DEFLATE; + p[1] = CILEN_DEFLATE; + p[2] = DEFLATE_MAKE_OPT(go->deflate_size); + p[3] = DEFLATE_CHK_SEQUENCE; + p += CILEN_DEFLATE; + } + if (go->deflate_draft) { + p[0] = CI_DEFLATE_DRAFT; + p[1] = CILEN_DEFLATE; + p[2] = p[2 - CILEN_DEFLATE]; + p[3] = DEFLATE_CHK_SEQUENCE; + p += CILEN_DEFLATE; + } + } +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + if (go->bsd_compress) { + p[0] = CI_BSD_COMPRESS; + p[1] = CILEN_BSD_COMPRESS; + p[2] = BSD_MAKE_OPT(BSD_CURRENT_VERSION, go->bsd_bits); + p += CILEN_BSD_COMPRESS; + } +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + /* XXX Should Predictor 2 be preferable to Predictor 1? */ + if (go->predictor_1) { + p[0] = CI_PREDICTOR_1; + p[1] = CILEN_PREDICTOR_1; + p += CILEN_PREDICTOR_1; + } + if (go->predictor_2) { + p[0] = CI_PREDICTOR_2; + p[1] = CILEN_PREDICTOR_2; + p += CILEN_PREDICTOR_2; + } +#endif /* PREDICTOR_SUPPORT */ + + go->method = (p > p0)? p0[0]: 0; + + *lenp = p - p0; +} + +/* + * ccp_ackci - process a received configure-ack, and return + * 1 iff the packet was OK. + */ +static int ccp_ackci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; +#if BSDCOMPRESS_SUPPORT || PREDICTOR_SUPPORT + u_char *p0 = p; +#endif /* BSDCOMPRESS_SUPPORT || PREDICTOR_SUPPORT */ + +#if MPPE_SUPPORT + if (go->mppe) { + u_char opt_buf[CILEN_MPPE]; + + opt_buf[0] = CI_MPPE; + opt_buf[1] = CILEN_MPPE; + MPPE_OPTS_TO_CI(go->mppe, &opt_buf[2]); + if (len < CILEN_MPPE || memcmp(opt_buf, p, CILEN_MPPE)) + return 0; + p += CILEN_MPPE; + len -= CILEN_MPPE; + /* XXX Cope with first/fast ack */ + if (len == 0) + return 1; + } +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + if (go->deflate) { + if (len < CILEN_DEFLATE + || p[0] != (go->deflate_correct? CI_DEFLATE: CI_DEFLATE_DRAFT) + || p[1] != CILEN_DEFLATE + || p[2] != DEFLATE_MAKE_OPT(go->deflate_size) + || p[3] != DEFLATE_CHK_SEQUENCE) + return 0; + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + /* XXX Cope with first/fast ack */ + if (len == 0) + return 1; + if (go->deflate_correct && go->deflate_draft) { + if (len < CILEN_DEFLATE + || p[0] != CI_DEFLATE_DRAFT + || p[1] != CILEN_DEFLATE + || p[2] != DEFLATE_MAKE_OPT(go->deflate_size) + || p[3] != DEFLATE_CHK_SEQUENCE) + return 0; + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + } + } +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + if (go->bsd_compress) { + if (len < CILEN_BSD_COMPRESS + || p[0] != CI_BSD_COMPRESS || p[1] != CILEN_BSD_COMPRESS + || p[2] != BSD_MAKE_OPT(BSD_CURRENT_VERSION, go->bsd_bits)) + return 0; + p += CILEN_BSD_COMPRESS; + len -= CILEN_BSD_COMPRESS; + /* XXX Cope with first/fast ack */ + if (p == p0 && len == 0) + return 1; + } +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + if (go->predictor_1) { + if (len < CILEN_PREDICTOR_1 + || p[0] != CI_PREDICTOR_1 || p[1] != CILEN_PREDICTOR_1) + return 0; + p += CILEN_PREDICTOR_1; + len -= CILEN_PREDICTOR_1; + /* XXX Cope with first/fast ack */ + if (p == p0 && len == 0) + return 1; + } + if (go->predictor_2) { + if (len < CILEN_PREDICTOR_2 + || p[0] != CI_PREDICTOR_2 || p[1] != CILEN_PREDICTOR_2) + return 0; + p += CILEN_PREDICTOR_2; + len -= CILEN_PREDICTOR_2; + /* XXX Cope with first/fast ack */ + if (p == p0 && len == 0) + return 1; + } +#endif /* PREDICTOR_SUPPORT */ + + if (len != 0) + return 0; + return 1; +} + +/* + * ccp_nakci - process received configure-nak. + * Returns 1 iff the nak was OK. + */ +static int ccp_nakci(fsm *f, u_char *p, int len, int treat_as_reject) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + ccp_options no; /* options we've seen already */ + ccp_options try_; /* options to ask for next time */ + LWIP_UNUSED_ARG(treat_as_reject); +#if !MPPE_SUPPORT && !DEFLATE_SUPPORT && !BSDCOMPRESS_SUPPORT + LWIP_UNUSED_ARG(p); + LWIP_UNUSED_ARG(len); +#endif /* !MPPE_SUPPORT && !DEFLATE_SUPPORT && !BSDCOMPRESS_SUPPORT */ + + memset(&no, 0, sizeof(no)); + try_ = *go; + +#if MPPE_SUPPORT + if (go->mppe && len >= CILEN_MPPE + && p[0] == CI_MPPE && p[1] == CILEN_MPPE) { + no.mppe = 1; + /* + * Peer wants us to use a different strength or other setting. + * Fail if we aren't willing to use his suggestion. + */ + MPPE_CI_TO_OPTS(&p[2], try_.mppe); + if ((try_.mppe & MPPE_OPT_STATEFUL) && pcb->settings.refuse_mppe_stateful) { + ppp_error("Refusing MPPE stateful mode offered by peer"); + try_.mppe = 0; + } else if (((go->mppe | MPPE_OPT_STATEFUL) & try_.mppe) != try_.mppe) { + /* Peer must have set options we didn't request (suggest) */ + try_.mppe = 0; + } + + if (!try_.mppe) { + ppp_error("MPPE required but peer negotiation failed"); + lcp_close(pcb, "MPPE required but peer negotiation failed"); + } + } +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + if (go->deflate && len >= CILEN_DEFLATE + && p[0] == (go->deflate_correct? CI_DEFLATE: CI_DEFLATE_DRAFT) + && p[1] == CILEN_DEFLATE) { + no.deflate = 1; + /* + * Peer wants us to use a different code size or something. + * Stop asking for Deflate if we don't understand his suggestion. + */ + if (DEFLATE_METHOD(p[2]) != DEFLATE_METHOD_VAL + || DEFLATE_SIZE(p[2]) < DEFLATE_MIN_WORKS + || p[3] != DEFLATE_CHK_SEQUENCE) + try_.deflate = 0; + else if (DEFLATE_SIZE(p[2]) < go->deflate_size) + try_.deflate_size = DEFLATE_SIZE(p[2]); + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + if (go->deflate_correct && go->deflate_draft + && len >= CILEN_DEFLATE && p[0] == CI_DEFLATE_DRAFT + && p[1] == CILEN_DEFLATE) { + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + } + } +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + if (go->bsd_compress && len >= CILEN_BSD_COMPRESS + && p[0] == CI_BSD_COMPRESS && p[1] == CILEN_BSD_COMPRESS) { + no.bsd_compress = 1; + /* + * Peer wants us to use a different number of bits + * or a different version. + */ + if (BSD_VERSION(p[2]) != BSD_CURRENT_VERSION) + try_.bsd_compress = 0; + else if (BSD_NBITS(p[2]) < go->bsd_bits) + try_.bsd_bits = BSD_NBITS(p[2]); + p += CILEN_BSD_COMPRESS; + len -= CILEN_BSD_COMPRESS; + } +#endif /* BSDCOMPRESS_SUPPORT */ + + /* + * Predictor-1 and 2 have no options, so they can't be Naked. + * + * There may be remaining options but we ignore them. + */ + + if (f->state != PPP_FSM_OPENED) + *go = try_; + return 1; +} + +/* + * ccp_rejci - reject some of our suggested compression methods. + */ +static int ccp_rejci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + ccp_options try_; /* options to request next time */ + + try_ = *go; + + /* + * Cope with empty configure-rejects by ceasing to send + * configure-requests. + */ + if (len == 0 && pcb->ccp_all_rejected) + return -1; + +#if MPPE_SUPPORT + if (go->mppe && len >= CILEN_MPPE + && p[0] == CI_MPPE && p[1] == CILEN_MPPE) { + ppp_error("MPPE required but peer refused"); + lcp_close(pcb, "MPPE required but peer refused"); + p += CILEN_MPPE; + len -= CILEN_MPPE; + } +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + if (go->deflate_correct && len >= CILEN_DEFLATE + && p[0] == CI_DEFLATE && p[1] == CILEN_DEFLATE) { + if (p[2] != DEFLATE_MAKE_OPT(go->deflate_size) + || p[3] != DEFLATE_CHK_SEQUENCE) + return 0; /* Rej is bad */ + try_.deflate_correct = 0; + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + } + if (go->deflate_draft && len >= CILEN_DEFLATE + && p[0] == CI_DEFLATE_DRAFT && p[1] == CILEN_DEFLATE) { + if (p[2] != DEFLATE_MAKE_OPT(go->deflate_size) + || p[3] != DEFLATE_CHK_SEQUENCE) + return 0; /* Rej is bad */ + try_.deflate_draft = 0; + p += CILEN_DEFLATE; + len -= CILEN_DEFLATE; + } + if (!try_.deflate_correct && !try_.deflate_draft) + try_.deflate = 0; +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + if (go->bsd_compress && len >= CILEN_BSD_COMPRESS + && p[0] == CI_BSD_COMPRESS && p[1] == CILEN_BSD_COMPRESS) { + if (p[2] != BSD_MAKE_OPT(BSD_CURRENT_VERSION, go->bsd_bits)) + return 0; + try_.bsd_compress = 0; + p += CILEN_BSD_COMPRESS; + len -= CILEN_BSD_COMPRESS; + } +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + if (go->predictor_1 && len >= CILEN_PREDICTOR_1 + && p[0] == CI_PREDICTOR_1 && p[1] == CILEN_PREDICTOR_1) { + try_.predictor_1 = 0; + p += CILEN_PREDICTOR_1; + len -= CILEN_PREDICTOR_1; + } + if (go->predictor_2 && len >= CILEN_PREDICTOR_2 + && p[0] == CI_PREDICTOR_2 && p[1] == CILEN_PREDICTOR_2) { + try_.predictor_2 = 0; + p += CILEN_PREDICTOR_2; + len -= CILEN_PREDICTOR_2; + } +#endif /* PREDICTOR_SUPPORT */ + + if (len != 0) + return 0; + + if (f->state != PPP_FSM_OPENED) + *go = try_; + + return 1; +} + +/* + * ccp_reqci - processed a received configure-request. + * Returns CONFACK, CONFNAK or CONFREJ and the packet modified + * appropriately. + */ +static int ccp_reqci(fsm *f, u_char *p, int *lenp, int dont_nak) { + ppp_pcb *pcb = f->pcb; + ccp_options *ho = &pcb->ccp_hisoptions; + ccp_options *ao = &pcb->ccp_allowoptions; + int ret, newret; +#if DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT + int res; + int nb; +#endif /* DEFLATE_SUPPORT || BSDCOMPRESS_SUPPORT */ + u_char *p0, *retp; + int len, clen, type; +#if MPPE_SUPPORT + u8_t rej_for_ci_mppe = 1; /* Are we rejecting based on a bad/missing */ + /* CI_MPPE, or due to other options? */ +#endif /* MPPE_SUPPORT */ + + ret = CONFACK; + retp = p0 = p; + len = *lenp; + + memset(ho, 0, sizeof(ccp_options)); + ho->method = (len > 0)? p[0]: 0; + + while (len > 0) { + newret = CONFACK; + if (len < 2 || p[1] < 2 || p[1] > len) { + /* length is bad */ + clen = len; + newret = CONFREJ; + + } else { + type = p[0]; + clen = p[1]; + + switch (type) { +#if MPPE_SUPPORT + case CI_MPPE: + if (!ao->mppe || clen != CILEN_MPPE) { + newret = CONFREJ; + break; + } + MPPE_CI_TO_OPTS(&p[2], ho->mppe); + + /* Nak if anything unsupported or unknown are set. */ + if (ho->mppe & MPPE_OPT_UNSUPPORTED) { + newret = CONFNAK; + ho->mppe &= ~MPPE_OPT_UNSUPPORTED; + } + if (ho->mppe & MPPE_OPT_UNKNOWN) { + newret = CONFNAK; + ho->mppe &= ~MPPE_OPT_UNKNOWN; + } + + /* Check state opt */ + if (ho->mppe & MPPE_OPT_STATEFUL) { + /* + * We can Nak and request stateless, but it's a + * lot easier to just assume the peer will request + * it if he can do it; stateful mode is bad over + * the Internet -- which is where we expect MPPE. + */ + if (pcb->settings.refuse_mppe_stateful) { + ppp_error("Refusing MPPE stateful mode offered by peer"); + newret = CONFREJ; + break; + } + } + + /* Find out which of {S,L} are set. */ + if ((ho->mppe & MPPE_OPT_128) + && (ho->mppe & MPPE_OPT_40)) { + /* Both are set, negotiate the strongest. */ + newret = CONFNAK; + if (ao->mppe & MPPE_OPT_128) + ho->mppe &= ~MPPE_OPT_40; + else if (ao->mppe & MPPE_OPT_40) + ho->mppe &= ~MPPE_OPT_128; + else { + newret = CONFREJ; + break; + } + } else if (ho->mppe & MPPE_OPT_128) { + if (!(ao->mppe & MPPE_OPT_128)) { + newret = CONFREJ; + break; + } + } else if (ho->mppe & MPPE_OPT_40) { + if (!(ao->mppe & MPPE_OPT_40)) { + newret = CONFREJ; + break; + } + } else { + /* Neither are set. */ + /* We cannot accept this. */ + newret = CONFNAK; + /* Give the peer our idea of what can be used, + so it can choose and confirm */ + ho->mppe = ao->mppe; + } + + /* rebuild the opts */ + MPPE_OPTS_TO_CI(ho->mppe, &p[2]); + if (newret == CONFACK) { + int mtu; + + mppe_init(pcb, &pcb->mppe_comp, ho->mppe); + /* + * We need to decrease the interface MTU by MPPE_PAD + * because MPPE frames **grow**. The kernel [must] + * allocate MPPE_PAD extra bytes in xmit buffers. + */ + mtu = netif_get_mtu(pcb); + if (mtu) + netif_set_mtu(pcb, mtu - MPPE_PAD); + else + newret = CONFREJ; + } + + /* + * We have accepted MPPE or are willing to negotiate + * MPPE parameters. A CONFREJ is due to subsequent + * (non-MPPE) processing. + */ + rej_for_ci_mppe = 0; + break; +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + case CI_DEFLATE: + case CI_DEFLATE_DRAFT: + if (!ao->deflate || clen != CILEN_DEFLATE + || (!ao->deflate_correct && type == CI_DEFLATE) + || (!ao->deflate_draft && type == CI_DEFLATE_DRAFT)) { + newret = CONFREJ; + break; + } + + ho->deflate = 1; + ho->deflate_size = nb = DEFLATE_SIZE(p[2]); + if (DEFLATE_METHOD(p[2]) != DEFLATE_METHOD_VAL + || p[3] != DEFLATE_CHK_SEQUENCE + || nb > ao->deflate_size || nb < DEFLATE_MIN_WORKS) { + newret = CONFNAK; + if (!dont_nak) { + p[2] = DEFLATE_MAKE_OPT(ao->deflate_size); + p[3] = DEFLATE_CHK_SEQUENCE; + /* fall through to test this #bits below */ + } else + break; + } + + /* + * Check whether we can do Deflate with the window + * size they want. If the window is too big, reduce + * it until the kernel can cope and nak with that. + * We only check this for the first option. + */ + if (p == p0) { + for (;;) { + res = ccp_test(pcb, p, CILEN_DEFLATE, 1); + if (res > 0) + break; /* it's OK now */ + if (res < 0 || nb == DEFLATE_MIN_WORKS || dont_nak) { + newret = CONFREJ; + p[2] = DEFLATE_MAKE_OPT(ho->deflate_size); + break; + } + newret = CONFNAK; + --nb; + p[2] = DEFLATE_MAKE_OPT(nb); + } + } + break; +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + case CI_BSD_COMPRESS: + if (!ao->bsd_compress || clen != CILEN_BSD_COMPRESS) { + newret = CONFREJ; + break; + } + + ho->bsd_compress = 1; + ho->bsd_bits = nb = BSD_NBITS(p[2]); + if (BSD_VERSION(p[2]) != BSD_CURRENT_VERSION + || nb > ao->bsd_bits || nb < BSD_MIN_BITS) { + newret = CONFNAK; + if (!dont_nak) { + p[2] = BSD_MAKE_OPT(BSD_CURRENT_VERSION, ao->bsd_bits); + /* fall through to test this #bits below */ + } else + break; + } + + /* + * Check whether we can do BSD-Compress with the code + * size they want. If the code size is too big, reduce + * it until the kernel can cope and nak with that. + * We only check this for the first option. + */ + if (p == p0) { + for (;;) { + res = ccp_test(pcb, p, CILEN_BSD_COMPRESS, 1); + if (res > 0) + break; + if (res < 0 || nb == BSD_MIN_BITS || dont_nak) { + newret = CONFREJ; + p[2] = BSD_MAKE_OPT(BSD_CURRENT_VERSION, + ho->bsd_bits); + break; + } + newret = CONFNAK; + --nb; + p[2] = BSD_MAKE_OPT(BSD_CURRENT_VERSION, nb); + } + } + break; +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + case CI_PREDICTOR_1: + if (!ao->predictor_1 || clen != CILEN_PREDICTOR_1) { + newret = CONFREJ; + break; + } + + ho->predictor_1 = 1; + if (p == p0 + && ccp_test(pcb, p, CILEN_PREDICTOR_1, 1) <= 0) { + newret = CONFREJ; + } + break; + + case CI_PREDICTOR_2: + if (!ao->predictor_2 || clen != CILEN_PREDICTOR_2) { + newret = CONFREJ; + break; + } + + ho->predictor_2 = 1; + if (p == p0 + && ccp_test(pcb, p, CILEN_PREDICTOR_2, 1) <= 0) { + newret = CONFREJ; + } + break; +#endif /* PREDICTOR_SUPPORT */ + + default: + newret = CONFREJ; + } + } + + if (newret == CONFNAK && dont_nak) + newret = CONFREJ; + if (!(newret == CONFACK || (newret == CONFNAK && ret == CONFREJ))) { + /* we're returning this option */ + if (newret == CONFREJ && ret == CONFNAK) + retp = p0; + ret = newret; + if (p != retp) + MEMCPY(retp, p, clen); + retp += clen; + } + + p += clen; + len -= clen; + } + + if (ret != CONFACK) { + if (ret == CONFREJ && *lenp == retp - p0) + pcb->ccp_all_rejected = 1; + else + *lenp = retp - p0; + } +#if MPPE_SUPPORT + if (ret == CONFREJ && ao->mppe && rej_for_ci_mppe) { + ppp_error("MPPE required but peer negotiation failed"); + lcp_close(pcb, "MPPE required but peer negotiation failed"); + } +#endif /* MPPE_SUPPORT */ + return ret; +} + +/* + * Make a string name for a compression method (or 2). + */ +static const char *method_name(ccp_options *opt, ccp_options *opt2) { + static char result[64]; +#if !DEFLATE_SUPPORT && !BSDCOMPRESS_SUPPORT + LWIP_UNUSED_ARG(opt2); +#endif /* !DEFLATE_SUPPORT && !BSDCOMPRESS_SUPPORT */ + + if (!ccp_anycompress(opt)) + return "(none)"; + switch (opt->method) { +#if MPPE_SUPPORT + case CI_MPPE: + { + char *p = result; + char *q = result + sizeof(result); /* 1 past result */ + + ppp_slprintf(p, q - p, "MPPE "); + p += 5; + if (opt->mppe & MPPE_OPT_128) { + ppp_slprintf(p, q - p, "128-bit "); + p += 8; + } + if (opt->mppe & MPPE_OPT_40) { + ppp_slprintf(p, q - p, "40-bit "); + p += 7; + } + if (opt->mppe & MPPE_OPT_STATEFUL) + ppp_slprintf(p, q - p, "stateful"); + else + ppp_slprintf(p, q - p, "stateless"); + + break; + } +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + case CI_DEFLATE: + case CI_DEFLATE_DRAFT: + if (opt2 != NULL && opt2->deflate_size != opt->deflate_size) + ppp_slprintf(result, sizeof(result), "Deflate%s (%d/%d)", + (opt->method == CI_DEFLATE_DRAFT? "(old#)": ""), + opt->deflate_size, opt2->deflate_size); + else + ppp_slprintf(result, sizeof(result), "Deflate%s (%d)", + (opt->method == CI_DEFLATE_DRAFT? "(old#)": ""), + opt->deflate_size); + break; +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + case CI_BSD_COMPRESS: + if (opt2 != NULL && opt2->bsd_bits != opt->bsd_bits) + ppp_slprintf(result, sizeof(result), "BSD-Compress (%d/%d)", + opt->bsd_bits, opt2->bsd_bits); + else + ppp_slprintf(result, sizeof(result), "BSD-Compress (%d)", + opt->bsd_bits); + break; +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + case CI_PREDICTOR_1: + return "Predictor 1"; + case CI_PREDICTOR_2: + return "Predictor 2"; +#endif /* PREDICTOR_SUPPORT */ + default: + ppp_slprintf(result, sizeof(result), "Method %d", opt->method); + } + return result; +} + +/* + * CCP has come up - inform the kernel driver and log a message. + */ +static void ccp_up(fsm *f) { + ppp_pcb *pcb = f->pcb; + ccp_options *go = &pcb->ccp_gotoptions; + ccp_options *ho = &pcb->ccp_hisoptions; + char method1[64]; + + ccp_set(pcb, 1, 1, go->method, ho->method); + if (ccp_anycompress(go)) { + if (ccp_anycompress(ho)) { + if (go->method == ho->method) { + ppp_notice("%s compression enabled", method_name(go, ho)); + } else { + ppp_strlcpy(method1, method_name(go, NULL), sizeof(method1)); + ppp_notice("%s / %s compression enabled", + method1, method_name(ho, NULL)); + } + } else + ppp_notice("%s receive compression enabled", method_name(go, NULL)); + } else if (ccp_anycompress(ho)) + ppp_notice("%s transmit compression enabled", method_name(ho, NULL)); +#if MPPE_SUPPORT + if (go->mppe) { + continue_networks(pcb); /* Bring up IP et al */ + } +#endif /* MPPE_SUPPORT */ +} + +/* + * CCP has gone down - inform the kernel driver. + */ +static void ccp_down(fsm *f) { + ppp_pcb *pcb = f->pcb; +#if MPPE_SUPPORT + ccp_options *go = &pcb->ccp_gotoptions; +#endif /* MPPE_SUPPORT */ + + if (pcb->ccp_localstate & RACK_PENDING) + UNTIMEOUT(ccp_rack_timeout, f); + pcb->ccp_localstate = 0; + ccp_set(pcb, 1, 0, 0, 0); +#if MPPE_SUPPORT + if (go->mppe) { + go->mppe = 0; + if (pcb->lcp_fsm.state == PPP_FSM_OPENED) { + /* If LCP is not already going down, make sure it does. */ + ppp_error("MPPE disabled"); + lcp_close(pcb, "MPPE disabled"); + } + } +#endif /* MPPE_SUPPORT */ +} + +#if PRINTPKT_SUPPORT +/* + * Print the contents of a CCP packet. + */ +static const char* const ccp_codenames[] = { + "ConfReq", "ConfAck", "ConfNak", "ConfRej", + "TermReq", "TermAck", "CodeRej", + NULL, NULL, NULL, NULL, NULL, NULL, + "ResetReq", "ResetAck", +}; + +static int ccp_printpkt(const u_char *p, int plen, void (*printer) (void *, const char *, ...), void *arg) { + const u_char *p0, *optend; + int code, id, len; + int optlen; + + p0 = p; + if (plen < HEADERLEN) + return 0; + code = p[0]; + id = p[1]; + len = (p[2] << 8) + p[3]; + if (len < HEADERLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)(sizeof(ccp_codenames) / sizeof(char *)) + && ccp_codenames[code-1] != NULL) + printer(arg, " %s", ccp_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= HEADERLEN; + p += HEADERLEN; + + switch (code) { + case CONFREQ: + case CONFACK: + case CONFNAK: + case CONFREJ: + /* print list of possible compression methods */ + while (len >= 2) { + code = p[0]; + optlen = p[1]; + if (optlen < 2 || optlen > len) + break; + printer(arg, " <"); + len -= optlen; + optend = p + optlen; + switch (code) { +#if MPPE_SUPPORT + case CI_MPPE: + if (optlen >= CILEN_MPPE) { + u_char mppe_opts; + + MPPE_CI_TO_OPTS(&p[2], mppe_opts); + printer(arg, "mppe %s %s %s %s %s %s%s", + (p[2] & MPPE_H_BIT)? "+H": "-H", + (p[5] & MPPE_M_BIT)? "+M": "-M", + (p[5] & MPPE_S_BIT)? "+S": "-S", + (p[5] & MPPE_L_BIT)? "+L": "-L", + (p[5] & MPPE_D_BIT)? "+D": "-D", + (p[5] & MPPE_C_BIT)? "+C": "-C", + (mppe_opts & MPPE_OPT_UNKNOWN)? " +U": ""); + if (mppe_opts & MPPE_OPT_UNKNOWN) + printer(arg, " (%.2x %.2x %.2x %.2x)", + p[2], p[3], p[4], p[5]); + p += CILEN_MPPE; + } + break; +#endif /* MPPE_SUPPORT */ +#if DEFLATE_SUPPORT + case CI_DEFLATE: + case CI_DEFLATE_DRAFT: + if (optlen >= CILEN_DEFLATE) { + printer(arg, "deflate%s %d", + (code == CI_DEFLATE_DRAFT? "(old#)": ""), + DEFLATE_SIZE(p[2])); + if (DEFLATE_METHOD(p[2]) != DEFLATE_METHOD_VAL) + printer(arg, " method %d", DEFLATE_METHOD(p[2])); + if (p[3] != DEFLATE_CHK_SEQUENCE) + printer(arg, " check %d", p[3]); + p += CILEN_DEFLATE; + } + break; +#endif /* DEFLATE_SUPPORT */ +#if BSDCOMPRESS_SUPPORT + case CI_BSD_COMPRESS: + if (optlen >= CILEN_BSD_COMPRESS) { + printer(arg, "bsd v%d %d", BSD_VERSION(p[2]), + BSD_NBITS(p[2])); + p += CILEN_BSD_COMPRESS; + } + break; +#endif /* BSDCOMPRESS_SUPPORT */ +#if PREDICTOR_SUPPORT + case CI_PREDICTOR_1: + if (optlen >= CILEN_PREDICTOR_1) { + printer(arg, "predictor 1"); + p += CILEN_PREDICTOR_1; + } + break; + case CI_PREDICTOR_2: + if (optlen >= CILEN_PREDICTOR_2) { + printer(arg, "predictor 2"); + p += CILEN_PREDICTOR_2; + } + break; +#endif /* PREDICTOR_SUPPORT */ + default: + break; + } + while (p < optend) + printer(arg, " %.2x", *p++); + printer(arg, ">"); + } + break; + + case TERMACK: + case TERMREQ: + if (len > 0 && *p >= ' ' && *p < 0x7f) { + ppp_print_string(p, len, printer, arg); + p += len; + len = 0; + } + break; + default: + break; + } + + /* dump out the rest of the packet in hex */ + while (--len >= 0) + printer(arg, " %.2x", *p++); + + return p - p0; +} +#endif /* PRINTPKT_SUPPORT */ + +#if PPP_DATAINPUT +/* + * We have received a packet that the decompressor failed to + * decompress. Here we would expect to issue a reset-request, but + * Motorola has a patent on resetting the compressor as a result of + * detecting an error in the decompressed data after decompression. + * (See US patent 5,130,993; international patent publication number + * WO 91/10289; Australian patent 73296/91.) + * + * So we ask the kernel whether the error was detected after + * decompression; if it was, we take CCP down, thus disabling + * compression :-(, otherwise we issue the reset-request. + */ +static void ccp_datainput(ppp_pcb *pcb, u_char *pkt, int len) { + fsm *f; +#if MPPE_SUPPORT + ccp_options *go = &pcb->ccp_gotoptions; +#endif /* MPPE_SUPPORT */ + LWIP_UNUSED_ARG(pkt); + LWIP_UNUSED_ARG(len); + + f = &pcb->ccp_fsm; + if (f->state == PPP_FSM_OPENED) { + if (ccp_fatal_error(pcb)) { + /* + * Disable compression by taking CCP down. + */ + ppp_error("Lost compression sync: disabling compression"); + ccp_close(pcb, "Lost compression sync"); +#if MPPE_SUPPORT + /* + * If we were doing MPPE, we must also take the link down. + */ + if (go->mppe) { + ppp_error("Too many MPPE errors, closing LCP"); + lcp_close(pcb, "Too many MPPE errors"); + } +#endif /* MPPE_SUPPORT */ + } else { + /* + * Send a reset-request to reset the peer's compressor. + * We don't do that if we are still waiting for an + * acknowledgement to a previous reset-request. + */ + if (!(pcb->ccp_localstate & RACK_PENDING)) { + fsm_sdata(f, CCP_RESETREQ, f->reqid = ++f->id, NULL, 0); + TIMEOUT(ccp_rack_timeout, f, RACKTIMEOUT); + pcb->ccp_localstate |= RACK_PENDING; + } else + pcb->ccp_localstate |= RREQ_REPEAT; + } + } +} +#endif /* PPP_DATAINPUT */ + +/* + * We have received a packet that the decompressor failed to + * decompress. Issue a reset-request. + */ +void ccp_resetrequest(ppp_pcb *pcb) { + fsm *f = &pcb->ccp_fsm; + + if (f->state != PPP_FSM_OPENED) + return; + + /* + * Send a reset-request to reset the peer's compressor. + * We don't do that if we are still waiting for an + * acknowledgement to a previous reset-request. + */ + if (!(pcb->ccp_localstate & RACK_PENDING)) { + fsm_sdata(f, CCP_RESETREQ, f->reqid = ++f->id, NULL, 0); + TIMEOUT(ccp_rack_timeout, f, RACKTIMEOUT); + pcb->ccp_localstate |= RACK_PENDING; + } else + pcb->ccp_localstate |= RREQ_REPEAT; +} + +/* + * Timeout waiting for reset-ack. + */ +static void ccp_rack_timeout(void *arg) { + fsm *f = (fsm*)arg; + ppp_pcb *pcb = f->pcb; + + if (f->state == PPP_FSM_OPENED && (pcb->ccp_localstate & RREQ_REPEAT)) { + fsm_sdata(f, CCP_RESETREQ, f->reqid, NULL, 0); + TIMEOUT(ccp_rack_timeout, f, RACKTIMEOUT); + pcb->ccp_localstate &= ~RREQ_REPEAT; + } else + pcb->ccp_localstate &= ~RACK_PENDING; +} + +#endif /* PPP_SUPPORT && CCP_SUPPORT */ diff --git a/components/lwip/netif/ppp/chap-md5.c b/components/lwip/netif/ppp/chap-md5.c new file mode 100755 index 000000000..6e3a9d7c2 --- /dev/null +++ b/components/lwip/netif/ppp/chap-md5.c @@ -0,0 +1,127 @@ +/* + * chap-md5.c - New CHAP/MD5 implementation. + * + * Copyright (c) 2003 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/chap-new.h" +#include "netif/ppp/chap-md5.h" +#include "netif/ppp/magic.h" + +#if LWIP_INCLUDED_POLARSSL_MD5 +#include "netif/ppp/polarssl/md5.h" +#else +#include "polarssl/md5.h" +#endif + +#define MD5_HASH_SIZE 16 +#define MD5_MIN_CHALLENGE 17 +#define MD5_MAX_CHALLENGE 24 +#define MD5_MIN_MAX_POWER_OF_TWO_CHALLENGE 3 /* 2^3-1 = 7, 17+7 = 24 */ + +#if PPP_SERVER +static void chap_md5_generate_challenge(ppp_pcb *pcb, unsigned char *cp) { + int clen; + LWIP_UNUSED_ARG(pcb); + + clen = MD5_MIN_CHALLENGE + magic_pow(MD5_MIN_MAX_POWER_OF_TWO_CHALLENGE); + *cp++ = clen; + magic_random_bytes(cp, clen); +} + +static int chap_md5_verify_response(ppp_pcb *pcb, int id, const char *name, + const unsigned char *secret, int secret_len, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space) { + md5_context ctx; + unsigned char idbyte = id; + unsigned char hash[MD5_HASH_SIZE]; + int challenge_len, response_len; + LWIP_UNUSED_ARG(name); + LWIP_UNUSED_ARG(pcb); + + challenge_len = *challenge++; + response_len = *response++; + if (response_len == MD5_HASH_SIZE) { + /* Generate hash of ID, secret, challenge */ + md5_starts(&ctx); + md5_update(&ctx, &idbyte, 1); + md5_update(&ctx, secret, secret_len); + md5_update(&ctx, challenge, challenge_len); + md5_finish(&ctx, hash); + + /* Test if our hash matches the peer's response */ + if (memcmp(hash, response, MD5_HASH_SIZE) == 0) { + ppp_slprintf(message, message_space, "Access granted"); + return 1; + } + } + ppp_slprintf(message, message_space, "Access denied"); + return 0; +} +#endif /* PPP_SERVER */ + +static void chap_md5_make_response(ppp_pcb *pcb, unsigned char *response, int id, const char *our_name, + const unsigned char *challenge, const char *secret, int secret_len, + unsigned char *private_) { + md5_context ctx; + unsigned char idbyte = id; + int challenge_len = *challenge++; + LWIP_UNUSED_ARG(our_name); + LWIP_UNUSED_ARG(private_); + LWIP_UNUSED_ARG(pcb); + + md5_starts(&ctx); + md5_update(&ctx, &idbyte, 1); + md5_update(&ctx, (const u_char *)secret, secret_len); + md5_update(&ctx, challenge, challenge_len); + md5_finish(&ctx, &response[1]); + response[0] = MD5_HASH_SIZE; +} + +const struct chap_digest_type md5_digest = { + CHAP_MD5, /* code */ +#if PPP_SERVER + chap_md5_generate_challenge, + chap_md5_verify_response, +#endif /* PPP_SERVER */ + chap_md5_make_response, + NULL, /* check_success */ + NULL, /* handle_failure */ +}; + +#endif /* PPP_SUPPORT && CHAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/chap-new.c b/components/lwip/netif/ppp/chap-new.c new file mode 100755 index 000000000..f0753976a --- /dev/null +++ b/components/lwip/netif/ppp/chap-new.c @@ -0,0 +1,677 @@ +/* + * chap-new.c - New CHAP implementation. + * + * Copyright (c) 2003 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && CHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#if 0 /* UNUSED */ +#include "session.h" +#endif /* UNUSED */ + +#include "netif/ppp/chap-new.h" +#include "netif/ppp/chap-md5.h" +#if MSCHAP_SUPPORT +#include "netif/ppp/chap_ms.h" +#endif +#include "netif/ppp/magic.h" + +#if 0 /* UNUSED */ +/* Hook for a plugin to validate CHAP challenge */ +int (*chap_verify_hook)(const char *name, const char *ourname, int id, + const struct chap_digest_type *digest, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space) = NULL; +#endif /* UNUSED */ + +#if PPP_OPTIONS +/* + * Command-line options. + */ +static option_t chap_option_list[] = { + { "chap-restart", o_int, &chap_timeout_time, + "Set timeout for CHAP", OPT_PRIO }, + { "chap-max-challenge", o_int, &pcb->settings.chap_max_transmits, + "Set max #xmits for challenge", OPT_PRIO }, + { "chap-interval", o_int, &pcb->settings.chap_rechallenge_time, + "Set interval for rechallenge", OPT_PRIO }, + { NULL } +}; +#endif /* PPP_OPTIONS */ + + +/* Values for flags in chap_client_state and chap_server_state */ +#define LOWERUP 1 +#define AUTH_STARTED 2 +#define AUTH_DONE 4 +#define AUTH_FAILED 8 +#define TIMEOUT_PENDING 0x10 +#define CHALLENGE_VALID 0x20 + +/* + * Prototypes. + */ +static void chap_init(ppp_pcb *pcb); +static void chap_lowerup(ppp_pcb *pcb); +static void chap_lowerdown(ppp_pcb *pcb); +#if PPP_SERVER +static void chap_timeout(void *arg); +static void chap_generate_challenge(ppp_pcb *pcb); +static void chap_handle_response(ppp_pcb *pcb, int code, + unsigned char *pkt, int len); +static int chap_verify_response(ppp_pcb *pcb, const char *name, const char *ourname, int id, + const struct chap_digest_type *digest, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space); +#endif /* PPP_SERVER */ +static void chap_respond(ppp_pcb *pcb, int id, + unsigned char *pkt, int len); +static void chap_handle_status(ppp_pcb *pcb, int code, int id, + unsigned char *pkt, int len); +static void chap_protrej(ppp_pcb *pcb); +static void chap_input(ppp_pcb *pcb, unsigned char *pkt, int pktlen); +#if PRINTPKT_SUPPORT +static int chap_print_pkt(const unsigned char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ + +/* List of digest types that we know about */ +static const struct chap_digest_type* const chap_digests[] = { + &md5_digest, +#if MSCHAP_SUPPORT + &chapms_digest, + &chapms2_digest, +#endif /* MSCHAP_SUPPORT */ + NULL +}; + +/* + * chap_init - reset to initial state. + */ +static void chap_init(ppp_pcb *pcb) { + LWIP_UNUSED_ARG(pcb); + +#if 0 /* Not necessary, everything is cleared in ppp_clear() */ + memset(&pcb->chap_client, 0, sizeof(chap_client_state)); +#if PPP_SERVER + memset(&pcb->chap_server, 0, sizeof(chap_server_state)); +#endif /* PPP_SERVER */ +#endif /* 0 */ +} + +/* + * chap_lowerup - we can start doing stuff now. + */ +static void chap_lowerup(ppp_pcb *pcb) { + + pcb->chap_client.flags |= LOWERUP; +#if PPP_SERVER + pcb->chap_server.flags |= LOWERUP; + if (pcb->chap_server.flags & AUTH_STARTED) + chap_timeout(pcb); +#endif /* PPP_SERVER */ +} + +static void chap_lowerdown(ppp_pcb *pcb) { + + pcb->chap_client.flags = 0; +#if PPP_SERVER + if (pcb->chap_server.flags & TIMEOUT_PENDING) + UNTIMEOUT(chap_timeout, pcb); + pcb->chap_server.flags = 0; +#endif /* PPP_SERVER */ +} + +#if PPP_SERVER +/* + * chap_auth_peer - Start authenticating the peer. + * If the lower layer is already up, we start sending challenges, + * otherwise we wait for the lower layer to come up. + */ +void chap_auth_peer(ppp_pcb *pcb, const char *our_name, int digest_code) { + const struct chap_digest_type *dp; + int i; + + if (pcb->chap_server.flags & AUTH_STARTED) { + ppp_error("CHAP: peer authentication already started!"); + return; + } + for (i = 0; (dp = chap_digests[i]) != NULL; ++i) + if (dp->code == digest_code) + break; + if (dp == NULL) + ppp_fatal("CHAP digest 0x%x requested but not available", + digest_code); + + pcb->chap_server.digest = dp; + pcb->chap_server.name = our_name; + /* Start with a random ID value */ + pcb->chap_server.id = magic(); + pcb->chap_server.flags |= AUTH_STARTED; + if (pcb->chap_server.flags & LOWERUP) + chap_timeout(pcb); +} +#endif /* PPP_SERVER */ + +/* + * chap_auth_with_peer - Prepare to authenticate ourselves to the peer. + * There isn't much to do until we receive a challenge. + */ +void chap_auth_with_peer(ppp_pcb *pcb, const char *our_name, int digest_code) { + const struct chap_digest_type *dp; + int i; + + if(NULL == our_name) + return; + + if (pcb->chap_client.flags & AUTH_STARTED) { + ppp_error("CHAP: authentication with peer already started!"); + return; + } + for (i = 0; (dp = chap_digests[i]) != NULL; ++i) + if (dp->code == digest_code) + break; + + if (dp == NULL) + ppp_fatal("CHAP digest 0x%x requested but not available", + digest_code); + + pcb->chap_client.digest = dp; + pcb->chap_client.name = our_name; + pcb->chap_client.flags |= AUTH_STARTED; +} + +#if PPP_SERVER +/* + * chap_timeout - It's time to send another challenge to the peer. + * This could be either a retransmission of a previous challenge, + * or a new challenge to start re-authentication. + */ +static void chap_timeout(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + struct pbuf *p; + + pcb->chap_server.flags &= ~TIMEOUT_PENDING; + if ((pcb->chap_server.flags & CHALLENGE_VALID) == 0) { + pcb->chap_server.challenge_xmits = 0; + chap_generate_challenge(pcb); + pcb->chap_server.flags |= CHALLENGE_VALID; + } else if (pcb->chap_server.challenge_xmits >= pcb->settings.chap_max_transmits) { + pcb->chap_server.flags &= ~CHALLENGE_VALID; + pcb->chap_server.flags |= AUTH_DONE | AUTH_FAILED; + auth_peer_fail(pcb, PPP_CHAP); + return; + } + + p = pbuf_alloc(PBUF_RAW, (u16_t)(pcb->chap_server.challenge_pktlen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + MEMCPY(p->payload, pcb->chap_server.challenge, pcb->chap_server.challenge_pktlen); + ppp_write(pcb, p); + ++pcb->chap_server.challenge_xmits; + pcb->chap_server.flags |= TIMEOUT_PENDING; + TIMEOUT(chap_timeout, arg, pcb->settings.chap_timeout_time); +} + +/* + * chap_generate_challenge - generate a challenge string and format + * the challenge packet in pcb->chap_server.challenge_pkt. + */ +static void chap_generate_challenge(ppp_pcb *pcb) { + int clen = 1, nlen, len; + unsigned char *p; + + p = pcb->chap_server.challenge; + MAKEHEADER(p, PPP_CHAP); + p += CHAP_HDRLEN; + pcb->chap_server.digest->generate_challenge(pcb, p); + clen = *p; + nlen = strlen(pcb->chap_server.name); + memcpy(p + 1 + clen, pcb->chap_server.name, nlen); + + len = CHAP_HDRLEN + 1 + clen + nlen; + pcb->chap_server.challenge_pktlen = PPP_HDRLEN + len; + + p = pcb->chap_server.challenge + PPP_HDRLEN; + p[0] = CHAP_CHALLENGE; + p[1] = ++pcb->chap_server.id; + p[2] = len >> 8; + p[3] = len; +} + +/* + * chap_handle_response - check the response to our challenge. + */ +static void chap_handle_response(ppp_pcb *pcb, int id, + unsigned char *pkt, int len) { + int response_len, ok, mlen; + const unsigned char *response; + unsigned char *outp; + struct pbuf *p; + const char *name = NULL; /* initialized to shut gcc up */ +#if 0 /* UNUSED */ + int (*verifier)(const char *, const char *, int, const struct chap_digest_type *, + const unsigned char *, const unsigned char *, char *, int); +#endif /* UNUSED */ + char rname[MAXNAMELEN+1]; + char message[256]; + + if ((pcb->chap_server.flags & LOWERUP) == 0) + return; + if (id != pcb->chap_server.challenge[PPP_HDRLEN+1] || len < 2) + return; + if (pcb->chap_server.flags & CHALLENGE_VALID) { + response = pkt; + GETCHAR(response_len, pkt); + len -= response_len + 1; /* length of name */ + name = (char *)pkt + response_len; + if (len < 0) + return; + + if (pcb->chap_server.flags & TIMEOUT_PENDING) { + pcb->chap_server.flags &= ~TIMEOUT_PENDING; + UNTIMEOUT(chap_timeout, pcb); + } +#if PPP_REMOTENAME + if (pcb->settings.explicit_remote) { + name = pcb->remote_name; + } else +#endif /* PPP_REMOTENAME */ + { + /* Null terminate and clean remote name. */ + ppp_slprintf(rname, sizeof(rname), "%.*v", len, name); + name = rname; + } + +#if 0 /* UNUSED */ + if (chap_verify_hook) + verifier = chap_verify_hook; + else + verifier = chap_verify_response; + ok = (*verifier)(name, pcb->chap_server.name, id, pcb->chap_server.digest, + pcb->chap_server.challenge + PPP_HDRLEN + CHAP_HDRLEN, + response, pcb->chap_server.message, sizeof(pcb->chap_server.message)); +#endif /* UNUSED */ + ok = chap_verify_response(pcb, name, pcb->chap_server.name, id, pcb->chap_server.digest, + pcb->chap_server.challenge + PPP_HDRLEN + CHAP_HDRLEN, + response, message, sizeof(message)); +#if 0 /* UNUSED */ + if (!ok || !auth_number()) { +#endif /* UNUSED */ + if (!ok) { + pcb->chap_server.flags |= AUTH_FAILED; + ppp_warn("Peer %q failed CHAP authentication", name); + } + } else if ((pcb->chap_server.flags & AUTH_DONE) == 0) + return; + + /* send the response */ + mlen = strlen(message); + len = CHAP_HDRLEN + mlen; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN +len), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (unsigned char *)p->payload; + MAKEHEADER(outp, PPP_CHAP); + + outp[0] = (pcb->chap_server.flags & AUTH_FAILED)? CHAP_FAILURE: CHAP_SUCCESS; + outp[1] = id; + outp[2] = len >> 8; + outp[3] = len; + if (mlen > 0) + memcpy(outp + CHAP_HDRLEN, message, mlen); + ppp_write(pcb, p); + + if (pcb->chap_server.flags & CHALLENGE_VALID) { + pcb->chap_server.flags &= ~CHALLENGE_VALID; + if (!(pcb->chap_server.flags & AUTH_DONE) && !(pcb->chap_server.flags & AUTH_FAILED)) { + +#if 0 /* UNUSED */ + /* + * Auth is OK, so now we need to check session restrictions + * to ensure everything is OK, but only if we used a + * plugin, and only if we're configured to check. This + * allows us to do PAM checks on PPP servers that + * authenticate against ActiveDirectory, and use AD for + * account info (like when using Winbind integrated with + * PAM). + */ + if (session_mgmt && + session_check(name, NULL, devnam, NULL) == 0) { + pcb->chap_server.flags |= AUTH_FAILED; + ppp_warn("Peer %q failed CHAP Session verification", name); + } +#endif /* UNUSED */ + + } + if (pcb->chap_server.flags & AUTH_FAILED) { + auth_peer_fail(pcb, PPP_CHAP); + } else { + if ((pcb->chap_server.flags & AUTH_DONE) == 0) + auth_peer_success(pcb, PPP_CHAP, + pcb->chap_server.digest->code, + name, strlen(name)); + if (pcb->settings.chap_rechallenge_time) { + pcb->chap_server.flags |= TIMEOUT_PENDING; + TIMEOUT(chap_timeout, pcb, + pcb->settings.chap_rechallenge_time); + } + } + pcb->chap_server.flags |= AUTH_DONE; + } +} + +/* + * chap_verify_response - check whether the peer's response matches + * what we think it should be. Returns 1 if it does (authentication + * succeeded), or 0 if it doesn't. + */ +static int chap_verify_response(ppp_pcb *pcb, const char *name, const char *ourname, int id, + const struct chap_digest_type *digest, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space) { + int ok; + unsigned char secret[MAXSECRETLEN]; + int secret_len; + + /* Get the secret that the peer is supposed to know */ + if (!get_secret(pcb, name, ourname, (char *)secret, &secret_len, 1)) { + ppp_error("No CHAP secret found for authenticating %q", name); + return 0; + } + ok = digest->verify_response(pcb, id, name, secret, secret_len, challenge, + response, message, message_space); + memset(secret, 0, sizeof(secret)); + + return ok; +} +#endif /* PPP_SERVER */ + +/* + * chap_respond - Generate and send a response to a challenge. + */ +static void chap_respond(ppp_pcb *pcb, int id, + unsigned char *pkt, int len) { + int clen, nlen; + int secret_len; + struct pbuf *p; + u_char *outp; + char rname[MAXNAMELEN+1]; + char secret[MAXSECRETLEN+1]; + + p = pbuf_alloc(PBUF_RAW, (u16_t)(RESP_MAX_PKTLEN), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + if ((pcb->chap_client.flags & (LOWERUP | AUTH_STARTED)) != (LOWERUP | AUTH_STARTED)) + return; /* not ready */ + if (len < 2 || len < pkt[0] + 1) + return; /* too short */ + clen = pkt[0]; + nlen = len - (clen + 1); + + /* Null terminate and clean remote name. */ + ppp_slprintf(rname, sizeof(rname), "%.*v", nlen, pkt + clen + 1); + +#if PPP_REMOTENAME + /* Microsoft doesn't send their name back in the PPP packet */ + if (pcb->settings.explicit_remote || (pcb->settings.remote_name[0] != 0 && rname[0] == 0)) + strlcpy(rname, pcb->settings.remote_name, sizeof(rname)); +#endif /* PPP_REMOTENAME */ + + /* get secret for authenticating ourselves with the specified host */ + if (!get_secret(pcb, pcb->chap_client.name, rname, secret, &secret_len, 0)) { + secret_len = 0; /* assume null secret if can't find one */ + ppp_warn("No CHAP secret found for authenticating us to %q", rname); + } + + outp = (u_char*)p->payload; + MAKEHEADER(outp, PPP_CHAP); + outp += CHAP_HDRLEN; + + pcb->chap_client.digest->make_response(pcb, outp, id, pcb->chap_client.name, pkt, + secret, secret_len, pcb->chap_client.priv); + memset(secret, 0, secret_len); + + clen = *outp; + nlen = strlen(pcb->chap_client.name); + memcpy(outp + clen + 1, pcb->chap_client.name, nlen); + + outp = (u_char*)p->payload + PPP_HDRLEN; + len = CHAP_HDRLEN + clen + 1 + nlen; + outp[0] = CHAP_RESPONSE; + outp[1] = id; + outp[2] = len >> 8; + outp[3] = len; + + pbuf_realloc(p, PPP_HDRLEN + len); + ppp_write(pcb, p); +} + +static void chap_handle_status(ppp_pcb *pcb, int code, int id, + unsigned char *pkt, int len) { + const char *msg = NULL; + LWIP_UNUSED_ARG(id); + + if ((pcb->chap_client.flags & (AUTH_DONE|AUTH_STARTED|LOWERUP)) + != (AUTH_STARTED|LOWERUP)) + return; + pcb->chap_client.flags |= AUTH_DONE; + + if (code == CHAP_SUCCESS) { + /* used for MS-CHAP v2 mutual auth, yuck */ + if (pcb->chap_client.digest->check_success != NULL) { + if (!(*pcb->chap_client.digest->check_success)(pcb, pkt, len, pcb->chap_client.priv)) + code = CHAP_FAILURE; + } else + msg = "CHAP authentication succeeded"; + } else { + if (pcb->chap_client.digest->handle_failure != NULL) + (*pcb->chap_client.digest->handle_failure)(pcb, pkt, len); + else + msg = "CHAP authentication failed"; + } + if (msg) { + if (len > 0) + ppp_info("%s: %.*v", msg, len, pkt); + else + ppp_info("%s", msg); + } + if (code == CHAP_SUCCESS) + auth_withpeer_success(pcb, PPP_CHAP, pcb->chap_client.digest->code); + else { + pcb->chap_client.flags |= AUTH_FAILED; + ppp_error("CHAP authentication failed"); + auth_withpeer_fail(pcb, PPP_CHAP); + } +} + +static void chap_input(ppp_pcb *pcb, unsigned char *pkt, int pktlen) { + unsigned char code, id; + int len; + + if (pktlen < CHAP_HDRLEN) + return; + GETCHAR(code, pkt); + GETCHAR(id, pkt); + GETSHORT(len, pkt); + if (len < CHAP_HDRLEN || len > pktlen) + return; + len -= CHAP_HDRLEN; + + switch (code) { + case CHAP_CHALLENGE: + chap_respond(pcb, id, pkt, len); + break; +#if PPP_SERVER + case CHAP_RESPONSE: + chap_handle_response(pcb, id, pkt, len); + break; +#endif /* PPP_SERVER */ + case CHAP_FAILURE: + case CHAP_SUCCESS: + chap_handle_status(pcb, code, id, pkt, len); + break; + default: + break; + } +} + +static void chap_protrej(ppp_pcb *pcb) { + +#if PPP_SERVER + if (pcb->chap_server.flags & TIMEOUT_PENDING) { + pcb->chap_server.flags &= ~TIMEOUT_PENDING; + UNTIMEOUT(chap_timeout, pcb); + } + if (pcb->chap_server.flags & AUTH_STARTED) { + pcb->chap_server.flags = 0; + auth_peer_fail(pcb, PPP_CHAP); + } +#endif /* PPP_SERVER */ + if ((pcb->chap_client.flags & (AUTH_STARTED|AUTH_DONE)) == AUTH_STARTED) { + pcb->chap_client.flags &= ~AUTH_STARTED; + ppp_error("CHAP authentication failed due to protocol-reject"); + auth_withpeer_fail(pcb, PPP_CHAP); + } +} + +#if PRINTPKT_SUPPORT +/* + * chap_print_pkt - print the contents of a CHAP packet. + */ +static const char* const chap_code_names[] = { + "Challenge", "Response", "Success", "Failure" +}; + +static int chap_print_pkt(const unsigned char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg) { + int code, id, len; + int clen, nlen; + unsigned char x; + + if (plen < CHAP_HDRLEN) + return 0; + GETCHAR(code, p); + GETCHAR(id, p); + GETSHORT(len, p); + if (len < CHAP_HDRLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)sizeof(chap_code_names) / (int)sizeof(char *)) + printer(arg, " %s", chap_code_names[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= CHAP_HDRLEN; + switch (code) { + case CHAP_CHALLENGE: + case CHAP_RESPONSE: + if (len < 1) + break; + clen = p[0]; + if (len < clen + 1) + break; + ++p; + nlen = len - clen - 1; + printer(arg, " <"); + for (; clen > 0; --clen) { + GETCHAR(x, p); + printer(arg, "%.2x", x); + } + printer(arg, ">, name = "); + ppp_print_string(p, nlen, printer, arg); + break; + case CHAP_FAILURE: + case CHAP_SUCCESS: + printer(arg, " "); + ppp_print_string(p, len, printer, arg); + break; + default: + for (clen = len; clen > 0; --clen) { + GETCHAR(x, p); + printer(arg, " %.2x", x); + } + /* no break */ + } + + return len + CHAP_HDRLEN; +} +#endif /* PRINTPKT_SUPPORT */ + +const struct protent chap_protent = { + PPP_CHAP, + chap_init, + chap_input, + chap_protrej, + chap_lowerup, + chap_lowerdown, + NULL, /* open */ + NULL, /* close */ +#if PRINTPKT_SUPPORT + chap_print_pkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, /* datainput */ +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "CHAP", /* name */ + NULL, /* data_name */ +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + chap_option_list, + NULL, /* check_options */ +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, + NULL +#endif /* DEMAND_SUPPORT */ +}; + +#endif /* PPP_SUPPORT && CHAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/chap_ms.c b/components/lwip/netif/ppp/chap_ms.c new file mode 100755 index 000000000..550c95d12 --- /dev/null +++ b/components/lwip/netif/ppp/chap_ms.c @@ -0,0 +1,954 @@ +/* + * chap_ms.c - Microsoft MS-CHAP compatible implementation. + * + * Copyright (c) 1995 Eric Rosenquist. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +/* + * Modifications by Lauri Pesonen / lpesonen@clinet.fi, april 1997 + * + * Implemented LANManager type password response to MS-CHAP challenges. + * Now pppd provides both NT style and LANMan style blocks, and the + * prefered is set by option "ms-lanman". Default is to use NT. + * The hash text (StdText) was taken from Win95 RASAPI32.DLL. + * + * You should also use DOMAIN\\USERNAME as described in README.MSCHAP80 + */ + +/* + * Modifications by Frank Cusack, frank@google.com, March 2002. + * + * Implemented MS-CHAPv2 functionality, heavily based on sample + * implementation in RFC 2759. Implemented MPPE functionality, + * heavily based on sample implementation in RFC 3079. + * + * Copyright (c) 2002 Google, Inc. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MSCHAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#include +#include +#include +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/chap-new.h" +#include "netif/ppp/chap_ms.h" +#include "netif/ppp/pppcrypt.h" +#include "netif/ppp/magic.h" +#if MPPE_SUPPORT +#include "netif/ppp/mppe.h" /* For mppe_sha1_pad*, mppe_set_key() */ +#endif /* MPPE_SUPPORT */ + +#if LWIP_INCLUDED_POLARSSL_MD4 +#include "netif/ppp/polarssl/md4.h" +#else +#include "polarssl/md4.h" +#endif + +#if LWIP_INCLUDED_POLARSSL_SHA1 +#include "netif/ppp/polarssl/sha1.h" +#else +#include "polarssl/sha1.h" +#endif + +#if LWIP_INCLUDED_POLARSSL_DES +#include "netif/ppp/polarssl/des.h" +#else +#include "polarssl/des.h" +#endif + +#define SHA1_SIGNATURE_SIZE 20 +#define MD4_SIGNATURE_SIZE 16 /* 16 bytes in a MD4 message digest */ +#define MAX_NT_PASSWORD 256 /* Max (Unicode) chars in an NT pass */ + +#define MS_CHAP_RESPONSE_LEN 49 /* Response length for MS-CHAP */ +#define MS_CHAP2_RESPONSE_LEN 49 /* Response length for MS-CHAPv2 */ +#define MS_AUTH_RESPONSE_LENGTH 40 /* MS-CHAPv2 authenticator response, */ + /* as ASCII */ + +/* Error codes for MS-CHAP failure messages. */ +#define MS_CHAP_ERROR_RESTRICTED_LOGON_HOURS 646 +#define MS_CHAP_ERROR_ACCT_DISABLED 647 +#define MS_CHAP_ERROR_PASSWD_EXPIRED 648 +#define MS_CHAP_ERROR_NO_DIALIN_PERMISSION 649 +#define MS_CHAP_ERROR_AUTHENTICATION_FAILURE 691 +#define MS_CHAP_ERROR_CHANGING_PASSWORD 709 + +/* + * Offsets within the response field for MS-CHAP + */ +#define MS_CHAP_LANMANRESP 0 +#define MS_CHAP_LANMANRESP_LEN 24 +#define MS_CHAP_NTRESP 24 +#define MS_CHAP_NTRESP_LEN 24 +#define MS_CHAP_USENT 48 + +/* + * Offsets within the response field for MS-CHAP2 + */ +#define MS_CHAP2_PEER_CHALLENGE 0 +#define MS_CHAP2_PEER_CHAL_LEN 16 +#define MS_CHAP2_RESERVED_LEN 8 +#define MS_CHAP2_NTRESP 24 +#define MS_CHAP2_NTRESP_LEN 24 +#define MS_CHAP2_FLAGS 48 + +#if MPPE_SUPPORT +#if 0 /* UNUSED */ +/* These values are the RADIUS attribute values--see RFC 2548. */ +#define MPPE_ENC_POL_ENC_ALLOWED 1 +#define MPPE_ENC_POL_ENC_REQUIRED 2 +#define MPPE_ENC_TYPES_RC4_40 2 +#define MPPE_ENC_TYPES_RC4_128 4 + +/* used by plugins (using above values) */ +extern void set_mppe_enc_types(int, int); +#endif /* UNUSED */ +#endif /* MPPE_SUPPORT */ + +/* Are we the authenticator or authenticatee? For MS-CHAPv2 key derivation. */ +#define MS_CHAP2_AUTHENTICATEE 0 +#define MS_CHAP2_AUTHENTICATOR 1 + +static void ascii2unicode (const char[], int, u_char[]); +static void NTPasswordHash (u_char *, int, u_char[MD4_SIGNATURE_SIZE]); +static void ChallengeResponse (const u_char *, const u_char *, u_char[24]); +static void ChallengeHash (const u_char[16], const u_char *, const char *, u_char[8]); +static void ChapMS_NT (const u_char *, const char *, int, u_char[24]); +static void ChapMS2_NT (const u_char *, const u_char[16], const char *, const char *, int, + u_char[24]); +static void GenerateAuthenticatorResponsePlain + (const char*, int, u_char[24], const u_char[16], const u_char *, + const char *, u_char[41]); +#ifdef MSLANMAN +static void ChapMS_LANMan (u_char *, char *, int, u_char *); +#endif + +static void GenerateAuthenticatorResponse(const u_char PasswordHashHash[MD4_SIGNATURE_SIZE], + u_char NTResponse[24], const u_char PeerChallenge[16], + const u_char *rchallenge, const char *username, + u_char authResponse[MS_AUTH_RESPONSE_LENGTH+1]); + +#if MPPE_SUPPORT +static void Set_Start_Key (ppp_pcb *pcb, const u_char *, const char *, int); +static void SetMasterKeys (ppp_pcb *pcb, const char *, int, u_char[24], int); +#endif /* MPPE_SUPPORT */ + +static void ChapMS (ppp_pcb *pcb, const u_char *, const char *, int, u_char *); +static void ChapMS2 (ppp_pcb *pcb, const u_char *, const u_char *, const char *, const char *, int, + u_char *, u_char[MS_AUTH_RESPONSE_LENGTH+1], int); + +#ifdef MSLANMAN +bool ms_lanman = 0; /* Use LanMan password instead of NT */ + /* Has meaning only with MS-CHAP challenges */ +#endif + +#if MPPE_SUPPORT +#ifdef DEBUGMPPEKEY +/* For MPPE debug */ +/* Use "[]|}{?/><,`!2&&(" (sans quotes) for RFC 3079 MS-CHAPv2 test value */ +static char *mschap_challenge = NULL; +/* Use "!@\#$%^&*()_+:3|~" (sans quotes, backslash is to escape #) for ... */ +static char *mschap2_peer_challenge = NULL; +#endif + +#include "netif/ppp/fsm.h" /* Need to poke MPPE options */ +#include "netif/ppp/ccp.h" +#endif /* MPPE_SUPPORT */ + +#if PPP_OPTIONS +/* + * Command-line options. + */ +static option_t chapms_option_list[] = { +#ifdef MSLANMAN + { "ms-lanman", o_bool, &ms_lanman, + "Use LanMan passwd when using MS-CHAP", 1 }, +#endif +#ifdef DEBUGMPPEKEY + { "mschap-challenge", o_string, &mschap_challenge, + "specify CHAP challenge" }, + { "mschap2-peer-challenge", o_string, &mschap2_peer_challenge, + "specify CHAP peer challenge" }, +#endif + { NULL } +}; +#endif /* PPP_OPTIONS */ + +#if PPP_SERVER +/* + * chapms_generate_challenge - generate a challenge for MS-CHAP. + * For MS-CHAP the challenge length is fixed at 8 bytes. + * The length goes in challenge[0] and the actual challenge starts + * at challenge[1]. + */ +static void chapms_generate_challenge(ppp_pcb *pcb, unsigned char *challenge) { + LWIP_UNUSED_ARG(pcb); + + *challenge++ = 8; +#ifdef DEBUGMPPEKEY + if (mschap_challenge && strlen(mschap_challenge) == 8) + memcpy(challenge, mschap_challenge, 8); + else +#endif + magic_random_bytes(challenge, 8); +} + +static void chapms2_generate_challenge(ppp_pcb *pcb, unsigned char *challenge) { + LWIP_UNUSED_ARG(pcb); + + *challenge++ = 16; +#ifdef DEBUGMPPEKEY + if (mschap_challenge && strlen(mschap_challenge) == 16) + memcpy(challenge, mschap_challenge, 16); + else +#endif + magic_random_bytes(challenge, 16); +} + +static int chapms_verify_response(ppp_pcb *pcb, int id, const char *name, + const unsigned char *secret, int secret_len, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space) { + unsigned char md[MS_CHAP_RESPONSE_LEN]; + int diff; + int challenge_len, response_len; + LWIP_UNUSED_ARG(id); + LWIP_UNUSED_ARG(name); + + challenge_len = *challenge++; /* skip length, is 8 */ + response_len = *response++; + if (response_len != MS_CHAP_RESPONSE_LEN) + goto bad; + +#ifndef MSLANMAN + if (!response[MS_CHAP_USENT]) { + /* Should really propagate this into the error packet. */ + ppp_notice("Peer request for LANMAN auth not supported"); + goto bad; + } +#endif + + /* Generate the expected response. */ + ChapMS(pcb, (const u_char *)challenge, (const char *)secret, secret_len, md); + +#ifdef MSLANMAN + /* Determine which part of response to verify against */ + if (!response[MS_CHAP_USENT]) + diff = memcmp(&response[MS_CHAP_LANMANRESP], + &md[MS_CHAP_LANMANRESP], MS_CHAP_LANMANRESP_LEN); + else +#endif + diff = memcmp(&response[MS_CHAP_NTRESP], &md[MS_CHAP_NTRESP], + MS_CHAP_NTRESP_LEN); + + if (diff == 0) { + ppp_slprintf(message, message_space, "Access granted"); + return 1; + } + + bad: + /* See comments below for MS-CHAP V2 */ + ppp_slprintf(message, message_space, "E=691 R=1 C=%0.*B V=0", + challenge_len, challenge); + return 0; +} + +static int chapms2_verify_response(ppp_pcb *pcb, int id, const char *name, + const unsigned char *secret, int secret_len, + const unsigned char *challenge, const unsigned char *response, + char *message, int message_space) { + unsigned char md[MS_CHAP2_RESPONSE_LEN]; + char saresponse[MS_AUTH_RESPONSE_LENGTH+1]; + int challenge_len, response_len; + LWIP_UNUSED_ARG(id); + + challenge_len = *challenge++; /* skip length, is 16 */ + response_len = *response++; + if (response_len != MS_CHAP2_RESPONSE_LEN) + goto bad; /* not even the right length */ + + /* Generate the expected response and our mutual auth. */ + ChapMS2(pcb, (const u_char*)challenge, (const u_char*)&response[MS_CHAP2_PEER_CHALLENGE], name, + (const char *)secret, secret_len, md, + (unsigned char *)saresponse, MS_CHAP2_AUTHENTICATOR); + + /* compare MDs and send the appropriate status */ + /* + * Per RFC 2759, success message must be formatted as + * "S= M=" + * where + * is the Authenticator Response (mutual auth) + * is a text message + * + * However, some versions of Windows (win98 tested) do not know + * about the M= part (required per RFC 2759) and flag + * it as an error (reported incorrectly as an encryption error + * to the user). Since the RFC requires it, and it can be + * useful information, we supply it if the peer is a conforming + * system. Luckily (?), win98 sets the Flags field to 0x04 + * (contrary to RFC requirements) so we can use that to + * distinguish between conforming and non-conforming systems. + * + * Special thanks to Alex Swiridov for + * help debugging this. + */ + if (memcmp(&md[MS_CHAP2_NTRESP], &response[MS_CHAP2_NTRESP], + MS_CHAP2_NTRESP_LEN) == 0) { + if (response[MS_CHAP2_FLAGS]) + ppp_slprintf(message, message_space, "S=%s", saresponse); + else + ppp_slprintf(message, message_space, "S=%s M=%s", + saresponse, "Access granted"); + return 1; + } + + bad: + /* + * Failure message must be formatted as + * "E=e R=r C=c V=v M=m" + * where + * e = error code (we use 691, ERROR_AUTHENTICATION_FAILURE) + * r = retry (we use 1, ok to retry) + * c = challenge to use for next response, we reuse previous + * v = Change Password version supported, we use 0 + * m = text message + * + * The M=m part is only for MS-CHAPv2. Neither win2k nor + * win98 (others untested) display the message to the user anyway. + * They also both ignore the E=e code. + * + * Note that it's safe to reuse the same challenge as we don't + * actually accept another response based on the error message + * (and no clients try to resend a response anyway). + * + * Basically, this whole bit is useless code, even the small + * implementation here is only because of overspecification. + */ + ppp_slprintf(message, message_space, "E=691 R=1 C=%0.*B V=0 M=%s", + challenge_len, challenge, "Access denied"); + return 0; +} +#endif /* PPP_SERVER */ + +static void chapms_make_response(ppp_pcb *pcb, unsigned char *response, int id, const char *our_name, + const unsigned char *challenge, const char *secret, int secret_len, + unsigned char *private_) { + LWIP_UNUSED_ARG(id); + LWIP_UNUSED_ARG(our_name); + LWIP_UNUSED_ARG(private_); + challenge++; /* skip length, should be 8 */ + *response++ = MS_CHAP_RESPONSE_LEN; + ChapMS(pcb, challenge, secret, secret_len, response); +} + +static void chapms2_make_response(ppp_pcb *pcb, unsigned char *response, int id, const char *our_name, + const unsigned char *challenge, const char *secret, int secret_len, + unsigned char *private_) { + LWIP_UNUSED_ARG(id); + challenge++; /* skip length, should be 16 */ + *response++ = MS_CHAP2_RESPONSE_LEN; + ChapMS2(pcb, challenge, +#ifdef DEBUGMPPEKEY + mschap2_peer_challenge, +#else + NULL, +#endif + our_name, secret, secret_len, response, private_, + MS_CHAP2_AUTHENTICATEE); +} + +static int chapms2_check_success(ppp_pcb *pcb, unsigned char *msg, int len, unsigned char *private_) { + LWIP_UNUSED_ARG(pcb); + + if ((len < MS_AUTH_RESPONSE_LENGTH + 2) || + strncmp((char *)msg, "S=", 2) != 0) { + /* Packet does not start with "S=" */ + ppp_error("MS-CHAPv2 Success packet is badly formed."); + return 0; + } + msg += 2; + len -= 2; + if (len < MS_AUTH_RESPONSE_LENGTH + || memcmp(msg, private_, MS_AUTH_RESPONSE_LENGTH)) { + /* Authenticator Response did not match expected. */ + ppp_error("MS-CHAPv2 mutual authentication failed."); + return 0; + } + /* Authenticator Response matches. */ + msg += MS_AUTH_RESPONSE_LENGTH; /* Eat it */ + len -= MS_AUTH_RESPONSE_LENGTH; + if ((len >= 3) && !strncmp((char *)msg, " M=", 3)) { + msg += 3; /* Eat the delimiter */ + } else if (len) { + /* Packet has extra text which does not begin " M=" */ + ppp_error("MS-CHAPv2 Success packet is badly formed."); + return 0; + } + return 1; +} + +static void chapms_handle_failure(ppp_pcb *pcb, unsigned char *inp, int len) { + int err; + const char *p; + char msg[64]; + LWIP_UNUSED_ARG(pcb); + + /* We want a null-terminated string for strxxx(). */ + len = LWIP_MIN(len, 63); + MEMCPY(msg, inp, len); + msg[len] = 0; + p = msg; + + /* + * Deal with MS-CHAP formatted failure messages; just print the + * M= part (if any). For MS-CHAP we're not really supposed + * to use M=, but it shouldn't hurt. See + * chapms[2]_verify_response. + */ + if (!strncmp(p, "E=", 2)) + err = strtol(p+2, NULL, 10); /* Remember the error code. */ + else + goto print_msg; /* Message is badly formatted. */ + + if (len && ((p = strstr(p, " M=")) != NULL)) { + /* M= field found. */ + p += 3; + } else { + /* No M=; use the error code. */ + switch (err) { + case MS_CHAP_ERROR_RESTRICTED_LOGON_HOURS: + p = "E=646 Restricted logon hours"; + break; + + case MS_CHAP_ERROR_ACCT_DISABLED: + p = "E=647 Account disabled"; + break; + + case MS_CHAP_ERROR_PASSWD_EXPIRED: + p = "E=648 Password expired"; + break; + + case MS_CHAP_ERROR_NO_DIALIN_PERMISSION: + p = "E=649 No dialin permission"; + break; + + case MS_CHAP_ERROR_AUTHENTICATION_FAILURE: + p = "E=691 Authentication failure"; + break; + + case MS_CHAP_ERROR_CHANGING_PASSWORD: + /* Should never see this, we don't support Change Password. */ + p = "E=709 Error changing password"; + break; + + default: + ppp_error("Unknown MS-CHAP authentication failure: %.*v", + len, inp); + return; + } + } +print_msg: + if (p != NULL) + ppp_error("MS-CHAP authentication failed: %v", p); +} + +static void ChallengeResponse(const u_char *challenge, + const u_char PasswordHash[MD4_SIGNATURE_SIZE], + u_char response[24]) { + u_char ZPasswordHash[21]; + des_context des; + u_char des_key[8]; + + BZERO(ZPasswordHash, sizeof(ZPasswordHash)); + MEMCPY(ZPasswordHash, PasswordHash, MD4_SIGNATURE_SIZE); + +#if 0 + dbglog("ChallengeResponse - ZPasswordHash %.*B", + sizeof(ZPasswordHash), ZPasswordHash); +#endif + + pppcrypt_56_to_64_bit_key(ZPasswordHash + 0, des_key); + des_setkey_enc(&des, des_key); + des_crypt_ecb(&des, challenge, response +0); + + pppcrypt_56_to_64_bit_key(ZPasswordHash + 7, des_key); + des_setkey_enc(&des, des_key); + des_crypt_ecb(&des, challenge, response +8); + + pppcrypt_56_to_64_bit_key(ZPasswordHash + 14, des_key); + des_setkey_enc(&des, des_key); + des_crypt_ecb(&des, challenge, response +16); + +#if 0 + dbglog("ChallengeResponse - response %.24B", response); +#endif +} + +static void ChallengeHash(const u_char PeerChallenge[16], const u_char *rchallenge, + const char *username, u_char Challenge[8]) { + sha1_context sha1Context; + u_char sha1Hash[SHA1_SIGNATURE_SIZE]; + const char *user; + + /* remove domain from "domain\username" */ + if ((user = strrchr(username, '\\')) != NULL) + ++user; + else + user = username; + + sha1_starts(&sha1Context); + sha1_update(&sha1Context, PeerChallenge, 16); + sha1_update(&sha1Context, rchallenge, 16); + sha1_update(&sha1Context, (const unsigned char*)user, strlen(user)); + sha1_finish(&sha1Context, sha1Hash); + + MEMCPY(Challenge, sha1Hash, 8); +} + +/* + * Convert the ASCII version of the password to Unicode. + * This implicitly supports 8-bit ISO8859/1 characters. + * This gives us the little-endian representation, which + * is assumed by all M$ CHAP RFCs. (Unicode byte ordering + * is machine-dependent.) + */ +static void ascii2unicode(const char ascii[], int ascii_len, u_char unicode[]) { + int i; + + BZERO(unicode, ascii_len * 2); + for (i = 0; i < ascii_len; i++) + unicode[i * 2] = (u_char) ascii[i]; +} + +static void NTPasswordHash(u_char *secret, int secret_len, u_char hash[MD4_SIGNATURE_SIZE]) { + md4_context md4Context; + + md4_starts(&md4Context); + md4_update(&md4Context, secret, secret_len); + md4_finish(&md4Context, hash); +} + +static void ChapMS_NT(const u_char *rchallenge, const char *secret, int secret_len, + u_char NTResponse[24]) { + u_char unicodePassword[MAX_NT_PASSWORD * 2]; + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + + /* Hash the Unicode version of the secret (== password). */ + ascii2unicode(secret, secret_len, unicodePassword); + NTPasswordHash(unicodePassword, secret_len * 2, PasswordHash); + + ChallengeResponse(rchallenge, PasswordHash, NTResponse); +} + +static void ChapMS2_NT(const u_char *rchallenge, const u_char PeerChallenge[16], const char *username, + const char *secret, int secret_len, u_char NTResponse[24]) { + u_char unicodePassword[MAX_NT_PASSWORD * 2]; + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + u_char Challenge[8]; + + ChallengeHash(PeerChallenge, rchallenge, username, Challenge); + + /* Hash the Unicode version of the secret (== password). */ + ascii2unicode(secret, secret_len, unicodePassword); + NTPasswordHash(unicodePassword, secret_len * 2, PasswordHash); + + ChallengeResponse(Challenge, PasswordHash, NTResponse); +} + +#ifdef MSLANMAN +static u_char *StdText = (u_char *)"KGS!@#$%"; /* key from rasapi32.dll */ + +static void ChapMS_LANMan(u_char *rchallenge, char *secret, int secret_len, + unsigned char *response) { + int i; + u_char UcasePassword[MAX_NT_PASSWORD]; /* max is actually 14 */ + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + des_context des; + u_char des_key[8]; + + /* LANMan password is case insensitive */ + BZERO(UcasePassword, sizeof(UcasePassword)); + for (i = 0; i < secret_len; i++) + UcasePassword[i] = (u_char)toupper(secret[i]); + + pppcrypt_56_to_64_bit_key(UcasePassword +0, des_key); + des_setkey_enc(&des, des_key); + des_crypt_ecb(&des, StdText, PasswordHash +0); + + pppcrypt_56_to_64_bit_key(UcasePassword +7, des_key); + des_setkey_enc(&des, des_key); + des_crypt_ecb(&des, StdText, PasswordHash +8); + + ChallengeResponse(rchallenge, PasswordHash, &response[MS_CHAP_LANMANRESP]); +} +#endif + + +static void GenerateAuthenticatorResponse(const u_char PasswordHashHash[MD4_SIGNATURE_SIZE], + u_char NTResponse[24], const u_char PeerChallenge[16], + const u_char *rchallenge, const char *username, + u_char authResponse[MS_AUTH_RESPONSE_LENGTH+1]) { + /* + * "Magic" constants used in response generation, from RFC 2759. + */ + static const u_char Magic1[39] = /* "Magic server to client signing constant" */ + { 0x4D, 0x61, 0x67, 0x69, 0x63, 0x20, 0x73, 0x65, 0x72, 0x76, + 0x65, 0x72, 0x20, 0x74, 0x6F, 0x20, 0x63, 0x6C, 0x69, 0x65, + 0x6E, 0x74, 0x20, 0x73, 0x69, 0x67, 0x6E, 0x69, 0x6E, 0x67, + 0x20, 0x63, 0x6F, 0x6E, 0x73, 0x74, 0x61, 0x6E, 0x74 }; + static const u_char Magic2[41] = /* "Pad to make it do more than one iteration" */ + { 0x50, 0x61, 0x64, 0x20, 0x74, 0x6F, 0x20, 0x6D, 0x61, 0x6B, + 0x65, 0x20, 0x69, 0x74, 0x20, 0x64, 0x6F, 0x20, 0x6D, 0x6F, + 0x72, 0x65, 0x20, 0x74, 0x68, 0x61, 0x6E, 0x20, 0x6F, 0x6E, + 0x65, 0x20, 0x69, 0x74, 0x65, 0x72, 0x61, 0x74, 0x69, 0x6F, + 0x6E }; + + int i; + sha1_context sha1Context; + u_char Digest[SHA1_SIGNATURE_SIZE]; + u_char Challenge[8]; + + sha1_starts(&sha1Context); + sha1_update(&sha1Context, PasswordHashHash, MD4_SIGNATURE_SIZE); + sha1_update(&sha1Context, NTResponse, 24); + sha1_update(&sha1Context, Magic1, sizeof(Magic1)); + sha1_finish(&sha1Context, Digest); + + ChallengeHash(PeerChallenge, rchallenge, username, Challenge); + + sha1_starts(&sha1Context); + sha1_update(&sha1Context, Digest, sizeof(Digest)); + sha1_update(&sha1Context, Challenge, sizeof(Challenge)); + sha1_update(&sha1Context, Magic2, sizeof(Magic2)); + sha1_finish(&sha1Context, Digest); + + /* Convert to ASCII hex string. */ + for (i = 0; i < LWIP_MAX((MS_AUTH_RESPONSE_LENGTH / 2), (int)sizeof(Digest)); i++) + sprintf((char *)&authResponse[i * 2], "%02X", Digest[i]); +} + + +static void GenerateAuthenticatorResponsePlain( + const char *secret, int secret_len, + u_char NTResponse[24], const u_char PeerChallenge[16], + const u_char *rchallenge, const char *username, + u_char authResponse[MS_AUTH_RESPONSE_LENGTH+1]) { + u_char unicodePassword[MAX_NT_PASSWORD * 2]; + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + u_char PasswordHashHash[MD4_SIGNATURE_SIZE]; + + /* Hash (x2) the Unicode version of the secret (== password). */ + ascii2unicode(secret, secret_len, unicodePassword); + NTPasswordHash(unicodePassword, secret_len * 2, PasswordHash); + NTPasswordHash(PasswordHash, sizeof(PasswordHash), + PasswordHashHash); + + GenerateAuthenticatorResponse(PasswordHashHash, NTResponse, PeerChallenge, + rchallenge, username, authResponse); +} + + +#if MPPE_SUPPORT +/* + * Set mppe_xxxx_key from MS-CHAP credentials. (see RFC 3079) + */ +static void Set_Start_Key(ppp_pcb *pcb, const u_char *rchallenge, const char *secret, int secret_len) { + u_char unicodePassword[MAX_NT_PASSWORD * 2]; + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + u_char PasswordHashHash[MD4_SIGNATURE_SIZE]; + sha1_context sha1Context; + u_char Digest[SHA1_SIGNATURE_SIZE]; /* >= MPPE_MAX_KEY_LEN */ + + /* Hash (x2) the Unicode version of the secret (== password). */ + ascii2unicode(secret, secret_len, unicodePassword); + NTPasswordHash(unicodePassword, secret_len * 2, PasswordHash); + NTPasswordHash(PasswordHash, sizeof(PasswordHash), PasswordHashHash); + + sha1_starts(&sha1Context); + sha1_update(&sha1Context, PasswordHashHash, MD4_SIGNATURE_SIZE); + sha1_update(&sha1Context, PasswordHashHash, MD4_SIGNATURE_SIZE); + sha1_update(&sha1Context, rchallenge, 8); + sha1_finish(&sha1Context, Digest); + + /* Same key in both directions. */ + mppe_set_key(pcb, &pcb->mppe_comp, Digest); + mppe_set_key(pcb, &pcb->mppe_decomp, Digest); + + pcb->mppe_keys_set = 1; +} + +/* + * Set mppe_xxxx_key from MS-CHAPv2 credentials. (see RFC 3079) + */ +static void SetMasterKeys(ppp_pcb *pcb, const char *secret, int secret_len, u_char NTResponse[24], int IsServer) { + u_char unicodePassword[MAX_NT_PASSWORD * 2]; + u_char PasswordHash[MD4_SIGNATURE_SIZE]; + u_char PasswordHashHash[MD4_SIGNATURE_SIZE]; + sha1_context sha1Context; + u_char MasterKey[SHA1_SIGNATURE_SIZE]; /* >= MPPE_MAX_KEY_LEN */ + u_char Digest[SHA1_SIGNATURE_SIZE]; /* >= MPPE_MAX_KEY_LEN */ + const u_char *s; + + /* "This is the MPPE Master Key" */ + static const u_char Magic1[27] = + { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x74, + 0x68, 0x65, 0x20, 0x4d, 0x50, 0x50, 0x45, 0x20, 0x4d, + 0x61, 0x73, 0x74, 0x65, 0x72, 0x20, 0x4b, 0x65, 0x79 }; + /* "On the client side, this is the send key; " + "on the server side, it is the receive key." */ + static const u_char Magic2[84] = + { 0x4f, 0x6e, 0x20, 0x74, 0x68, 0x65, 0x20, 0x63, 0x6c, 0x69, + 0x65, 0x6e, 0x74, 0x20, 0x73, 0x69, 0x64, 0x65, 0x2c, 0x20, + 0x74, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x74, 0x68, + 0x65, 0x20, 0x73, 0x65, 0x6e, 0x64, 0x20, 0x6b, 0x65, 0x79, + 0x3b, 0x20, 0x6f, 0x6e, 0x20, 0x74, 0x68, 0x65, 0x20, 0x73, + 0x65, 0x72, 0x76, 0x65, 0x72, 0x20, 0x73, 0x69, 0x64, 0x65, + 0x2c, 0x20, 0x69, 0x74, 0x20, 0x69, 0x73, 0x20, 0x74, 0x68, + 0x65, 0x20, 0x72, 0x65, 0x63, 0x65, 0x69, 0x76, 0x65, 0x20, + 0x6b, 0x65, 0x79, 0x2e }; + /* "On the client side, this is the receive key; " + "on the server side, it is the send key." */ + static const u_char Magic3[84] = + { 0x4f, 0x6e, 0x20, 0x74, 0x68, 0x65, 0x20, 0x63, 0x6c, 0x69, + 0x65, 0x6e, 0x74, 0x20, 0x73, 0x69, 0x64, 0x65, 0x2c, 0x20, + 0x74, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x74, 0x68, + 0x65, 0x20, 0x72, 0x65, 0x63, 0x65, 0x69, 0x76, 0x65, 0x20, + 0x6b, 0x65, 0x79, 0x3b, 0x20, 0x6f, 0x6e, 0x20, 0x74, 0x68, + 0x65, 0x20, 0x73, 0x65, 0x72, 0x76, 0x65, 0x72, 0x20, 0x73, + 0x69, 0x64, 0x65, 0x2c, 0x20, 0x69, 0x74, 0x20, 0x69, 0x73, + 0x20, 0x74, 0x68, 0x65, 0x20, 0x73, 0x65, 0x6e, 0x64, 0x20, + 0x6b, 0x65, 0x79, 0x2e }; + + /* Hash (x2) the Unicode version of the secret (== password). */ + ascii2unicode(secret, secret_len, unicodePassword); + NTPasswordHash(unicodePassword, secret_len * 2, PasswordHash); + NTPasswordHash(PasswordHash, sizeof(PasswordHash), PasswordHashHash); + + sha1_starts(&sha1Context); + sha1_update(&sha1Context, PasswordHashHash, MD4_SIGNATURE_SIZE); + sha1_update(&sha1Context, NTResponse, 24); + sha1_update(&sha1Context, Magic1, sizeof(Magic1)); + sha1_finish(&sha1Context, MasterKey); + + /* + * generate send key + */ + if (IsServer) + s = Magic3; + else + s = Magic2; + sha1_starts(&sha1Context); + sha1_update(&sha1Context, MasterKey, 16); + sha1_update(&sha1Context, mppe_sha1_pad1, SHA1_PAD_SIZE); + sha1_update(&sha1Context, s, 84); + sha1_update(&sha1Context, mppe_sha1_pad2, SHA1_PAD_SIZE); + sha1_finish(&sha1Context, Digest); + + mppe_set_key(pcb, &pcb->mppe_comp, Digest); + + /* + * generate recv key + */ + if (IsServer) + s = Magic2; + else + s = Magic3; + sha1_starts(&sha1Context); + sha1_update(&sha1Context, MasterKey, 16); + sha1_update(&sha1Context, mppe_sha1_pad1, SHA1_PAD_SIZE); + sha1_update(&sha1Context, s, 84); + sha1_update(&sha1Context, mppe_sha1_pad2, SHA1_PAD_SIZE); + sha1_finish(&sha1Context, Digest); + + mppe_set_key(pcb, &pcb->mppe_decomp, Digest); + + pcb->mppe_keys_set = 1; +} + +#endif /* MPPE_SUPPORT */ + + +static void ChapMS(ppp_pcb *pcb, const u_char *rchallenge, const char *secret, int secret_len, + unsigned char *response) { +#if !MPPE_SUPPORT + LWIP_UNUSED_ARG(pcb); +#endif /* !MPPE_SUPPORT */ + BZERO(response, MS_CHAP_RESPONSE_LEN); + + ChapMS_NT(rchallenge, secret, secret_len, &response[MS_CHAP_NTRESP]); + +#ifdef MSLANMAN + ChapMS_LANMan(rchallenge, secret, secret_len, + &response[MS_CHAP_LANMANRESP]); + + /* preferred method is set by option */ + response[MS_CHAP_USENT] = !ms_lanman; +#else + response[MS_CHAP_USENT] = 1; +#endif + +#if MPPE_SUPPORT + Set_Start_Key(pcb, rchallenge, secret, secret_len); +#endif /* MPPE_SUPPORT */ +} + + +/* + * If PeerChallenge is NULL, one is generated and the PeerChallenge + * field of response is filled in. Call this way when generating a response. + * If PeerChallenge is supplied, it is copied into the PeerChallenge field. + * Call this way when verifying a response (or debugging). + * Do not call with PeerChallenge = response. + * + * The PeerChallenge field of response is then used for calculation of the + * Authenticator Response. + */ +static void ChapMS2(ppp_pcb *pcb, const u_char *rchallenge, const u_char *PeerChallenge, + const char *user, const char *secret, int secret_len, unsigned char *response, + u_char authResponse[], int authenticator) { + /* ARGSUSED */ + LWIP_UNUSED_ARG(authenticator); +#if !MPPE_SUPPORT + LWIP_UNUSED_ARG(pcb); +#endif /* !MPPE_SUPPORT */ + + BZERO(response, MS_CHAP2_RESPONSE_LEN); + + /* Generate the Peer-Challenge if requested, or copy it if supplied. */ + if (!PeerChallenge) + magic_random_bytes(&response[MS_CHAP2_PEER_CHALLENGE], MS_CHAP2_PEER_CHAL_LEN); + else + MEMCPY(&response[MS_CHAP2_PEER_CHALLENGE], PeerChallenge, + MS_CHAP2_PEER_CHAL_LEN); + + /* Generate the NT-Response */ + ChapMS2_NT(rchallenge, &response[MS_CHAP2_PEER_CHALLENGE], user, + secret, secret_len, &response[MS_CHAP2_NTRESP]); + + /* Generate the Authenticator Response. */ + GenerateAuthenticatorResponsePlain(secret, secret_len, + &response[MS_CHAP2_NTRESP], + &response[MS_CHAP2_PEER_CHALLENGE], + rchallenge, user, authResponse); + +#if MPPE_SUPPORT + SetMasterKeys(pcb, secret, secret_len, + &response[MS_CHAP2_NTRESP], authenticator); +#endif /* MPPE_SUPPORT */ +} + +#if 0 /* UNUSED */ +#if MPPE_SUPPORT +/* + * Set MPPE options from plugins. + */ +void set_mppe_enc_types(int policy, int types) { + /* Early exit for unknown policies. */ + if (policy != MPPE_ENC_POL_ENC_ALLOWED || + policy != MPPE_ENC_POL_ENC_REQUIRED) + return; + + /* Don't modify MPPE if it's optional and wasn't already configured. */ + if (policy == MPPE_ENC_POL_ENC_ALLOWED && !ccp_wantoptions[0].mppe) + return; + + /* + * Disable undesirable encryption types. Note that we don't ENABLE + * any encryption types, to avoid overriding manual configuration. + */ + switch(types) { + case MPPE_ENC_TYPES_RC4_40: + ccp_wantoptions[0].mppe &= ~MPPE_OPT_128; /* disable 128-bit */ + break; + case MPPE_ENC_TYPES_RC4_128: + ccp_wantoptions[0].mppe &= ~MPPE_OPT_40; /* disable 40-bit */ + break; + default: + break; + } +} +#endif /* MPPE_SUPPORT */ +#endif /* UNUSED */ + +const struct chap_digest_type chapms_digest = { + CHAP_MICROSOFT, /* code */ +#if PPP_SERVER + chapms_generate_challenge, + chapms_verify_response, +#endif /* PPP_SERVER */ + chapms_make_response, + NULL, /* check_success */ + chapms_handle_failure, +}; + +const struct chap_digest_type chapms2_digest = { + CHAP_MICROSOFT_V2, /* code */ +#if PPP_SERVER + chapms2_generate_challenge, + chapms2_verify_response, +#endif /* PPP_SERVER */ + chapms2_make_response, + chapms2_check_success, + chapms_handle_failure, +}; + +#endif /* PPP_SUPPORT && MSCHAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/demand.c b/components/lwip/netif/ppp/demand.c new file mode 100755 index 000000000..1cd9b6145 --- /dev/null +++ b/components/lwip/netif/ppp/demand.c @@ -0,0 +1,465 @@ +/* + * demand.c - Support routines for demand-dialling. + * + * Copyright (c) 1996-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && DEMAND_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#ifdef PPP_FILTER +#include +#endif + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/ipcp.h" +#include "netif/ppp/lcp.h" + +char *frame; +int framelen; +int framemax; +int escape_flag; +int flush_flag; +int fcs; + +struct packet { + int length; + struct packet *next; + unsigned char data[1]; +}; + +struct packet *pend_q; +struct packet *pend_qtail; + +static int active_packet (unsigned char *, int); + +/* + * demand_conf - configure the interface for doing dial-on-demand. + */ +void +demand_conf() +{ + int i; + const struct protent *protp; + +/* framemax = lcp_allowoptions[0].mru; + if (framemax < PPP_MRU) */ + framemax = PPP_MRU; + framemax += PPP_HDRLEN + PPP_FCSLEN; + frame = malloc(framemax); + if (frame == NULL) + novm("demand frame"); + framelen = 0; + pend_q = NULL; + escape_flag = 0; + flush_flag = 0; + fcs = PPP_INITFCS; + + netif_set_mtu(pcb, LWIP_MIN(lcp_allowoptions[0].mru, PPP_MRU)); + if (ppp_send_config(pcb, PPP_MRU, (u32_t) 0, 0, 0) < 0 + || ppp_recv_config(pcb, PPP_MRU, (u32_t) 0, 0, 0) < 0) + fatal("Couldn't set up demand-dialled PPP interface: %m"); + +#ifdef PPP_FILTER + set_filters(&pass_filter, &active_filter); +#endif + + /* + * Call the demand_conf procedure for each protocol that's got one. + */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->demand_conf != NULL) + ((*protp->demand_conf)(pcb)); +/* FIXME: find a way to die() here */ +#if 0 + if (!((*protp->demand_conf)(pcb))) + die(1); +#endif +} + + +/* + * demand_block - set each network protocol to block further packets. + */ +void +demand_block() +{ + int i; + const struct protent *protp; + + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->demand_conf != NULL) + sifnpmode(pcb, protp->protocol & ~0x8000, NPMODE_QUEUE); + get_loop_output(); +} + +/* + * demand_discard - set each network protocol to discard packets + * with an error. + */ +void +demand_discard() +{ + struct packet *pkt, *nextpkt; + int i; + const struct protent *protp; + + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->demand_conf != NULL) + sifnpmode(pcb, protp->protocol & ~0x8000, NPMODE_ERROR); + get_loop_output(); + + /* discard all saved packets */ + for (pkt = pend_q; pkt != NULL; pkt = nextpkt) { + nextpkt = pkt->next; + free(pkt); + } + pend_q = NULL; + framelen = 0; + flush_flag = 0; + escape_flag = 0; + fcs = PPP_INITFCS; +} + +/* + * demand_unblock - set each enabled network protocol to pass packets. + */ +void +demand_unblock() +{ + int i; + const struct protent *protp; + + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->demand_conf != NULL) + sifnpmode(pcb, protp->protocol & ~0x8000, NPMODE_PASS); +} + +/* + * FCS lookup table as calculated by genfcstab. + */ +static u_short fcstab[256] = { + 0x0000, 0x1189, 0x2312, 0x329b, 0x4624, 0x57ad, 0x6536, 0x74bf, + 0x8c48, 0x9dc1, 0xaf5a, 0xbed3, 0xca6c, 0xdbe5, 0xe97e, 0xf8f7, + 0x1081, 0x0108, 0x3393, 0x221a, 0x56a5, 0x472c, 0x75b7, 0x643e, + 0x9cc9, 0x8d40, 0xbfdb, 0xae52, 0xdaed, 0xcb64, 0xf9ff, 0xe876, + 0x2102, 0x308b, 0x0210, 0x1399, 0x6726, 0x76af, 0x4434, 0x55bd, + 0xad4a, 0xbcc3, 0x8e58, 0x9fd1, 0xeb6e, 0xfae7, 0xc87c, 0xd9f5, + 0x3183, 0x200a, 0x1291, 0x0318, 0x77a7, 0x662e, 0x54b5, 0x453c, + 0xbdcb, 0xac42, 0x9ed9, 0x8f50, 0xfbef, 0xea66, 0xd8fd, 0xc974, + 0x4204, 0x538d, 0x6116, 0x709f, 0x0420, 0x15a9, 0x2732, 0x36bb, + 0xce4c, 0xdfc5, 0xed5e, 0xfcd7, 0x8868, 0x99e1, 0xab7a, 0xbaf3, + 0x5285, 0x430c, 0x7197, 0x601e, 0x14a1, 0x0528, 0x37b3, 0x263a, + 0xdecd, 0xcf44, 0xfddf, 0xec56, 0x98e9, 0x8960, 0xbbfb, 0xaa72, + 0x6306, 0x728f, 0x4014, 0x519d, 0x2522, 0x34ab, 0x0630, 0x17b9, + 0xef4e, 0xfec7, 0xcc5c, 0xddd5, 0xa96a, 0xb8e3, 0x8a78, 0x9bf1, + 0x7387, 0x620e, 0x5095, 0x411c, 0x35a3, 0x242a, 0x16b1, 0x0738, + 0xffcf, 0xee46, 0xdcdd, 0xcd54, 0xb9eb, 0xa862, 0x9af9, 0x8b70, + 0x8408, 0x9581, 0xa71a, 0xb693, 0xc22c, 0xd3a5, 0xe13e, 0xf0b7, + 0x0840, 0x19c9, 0x2b52, 0x3adb, 0x4e64, 0x5fed, 0x6d76, 0x7cff, + 0x9489, 0x8500, 0xb79b, 0xa612, 0xd2ad, 0xc324, 0xf1bf, 0xe036, + 0x18c1, 0x0948, 0x3bd3, 0x2a5a, 0x5ee5, 0x4f6c, 0x7df7, 0x6c7e, + 0xa50a, 0xb483, 0x8618, 0x9791, 0xe32e, 0xf2a7, 0xc03c, 0xd1b5, + 0x2942, 0x38cb, 0x0a50, 0x1bd9, 0x6f66, 0x7eef, 0x4c74, 0x5dfd, + 0xb58b, 0xa402, 0x9699, 0x8710, 0xf3af, 0xe226, 0xd0bd, 0xc134, + 0x39c3, 0x284a, 0x1ad1, 0x0b58, 0x7fe7, 0x6e6e, 0x5cf5, 0x4d7c, + 0xc60c, 0xd785, 0xe51e, 0xf497, 0x8028, 0x91a1, 0xa33a, 0xb2b3, + 0x4a44, 0x5bcd, 0x6956, 0x78df, 0x0c60, 0x1de9, 0x2f72, 0x3efb, + 0xd68d, 0xc704, 0xf59f, 0xe416, 0x90a9, 0x8120, 0xb3bb, 0xa232, + 0x5ac5, 0x4b4c, 0x79d7, 0x685e, 0x1ce1, 0x0d68, 0x3ff3, 0x2e7a, + 0xe70e, 0xf687, 0xc41c, 0xd595, 0xa12a, 0xb0a3, 0x8238, 0x93b1, + 0x6b46, 0x7acf, 0x4854, 0x59dd, 0x2d62, 0x3ceb, 0x0e70, 0x1ff9, + 0xf78f, 0xe606, 0xd49d, 0xc514, 0xb1ab, 0xa022, 0x92b9, 0x8330, + 0x7bc7, 0x6a4e, 0x58d5, 0x495c, 0x3de3, 0x2c6a, 0x1ef1, 0x0f78 +}; + +/* + * loop_chars - process characters received from the loopback. + * Calls loop_frame when a complete frame has been accumulated. + * Return value is 1 if we need to bring up the link, 0 otherwise. + */ +int +loop_chars(p, n) + unsigned char *p; + int n; +{ + int c, rv; + + rv = 0; + +/* check for synchronous connection... */ + + if ( (p[0] == 0xFF) && (p[1] == 0x03) ) { + rv = loop_frame(p,n); + return rv; + } + + for (; n > 0; --n) { + c = *p++; + if (c == PPP_FLAG) { + if (!escape_flag && !flush_flag + && framelen > 2 && fcs == PPP_GOODFCS) { + framelen -= 2; + if (loop_frame((unsigned char *)frame, framelen)) + rv = 1; + } + framelen = 0; + flush_flag = 0; + escape_flag = 0; + fcs = PPP_INITFCS; + continue; + } + if (flush_flag) + continue; + if (escape_flag) { + c ^= PPP_TRANS; + escape_flag = 0; + } else if (c == PPP_ESCAPE) { + escape_flag = 1; + continue; + } + if (framelen >= framemax) { + flush_flag = 1; + continue; + } + frame[framelen++] = c; + fcs = PPP_FCS(fcs, c); + } + return rv; +} + +/* + * loop_frame - given a frame obtained from the loopback, + * decide whether to bring up the link or not, and, if we want + * to transmit this frame later, put it on the pending queue. + * Return value is 1 if we need to bring up the link, 0 otherwise. + * We assume that the kernel driver has already applied the + * pass_filter, so we won't get packets it rejected. + * We apply the active_filter to see if we want this packet to + * bring up the link. + */ +int +loop_frame(frame, len) + unsigned char *frame; + int len; +{ + struct packet *pkt; + + /* dbglog("from loop: %P", frame, len); */ + if (len < PPP_HDRLEN) + return 0; + if ((PPP_PROTOCOL(frame) & 0x8000) != 0) + return 0; /* shouldn't get any of these anyway */ + if (!active_packet(frame, len)) + return 0; + + pkt = (struct packet *) malloc(sizeof(struct packet) + len); + if (pkt != NULL) { + pkt->length = len; + pkt->next = NULL; + memcpy(pkt->data, frame, len); + if (pend_q == NULL) + pend_q = pkt; + else + pend_qtail->next = pkt; + pend_qtail = pkt; + } + return 1; +} + +/* + * demand_rexmit - Resend all those frames which we got via the + * loopback, now that the real serial link is up. + */ +void +demand_rexmit(proto, newip) + int proto; + u32_t newip; +{ + struct packet *pkt, *prev, *nextpkt; + unsigned short checksum; + unsigned short pkt_checksum = 0; + unsigned iphdr; + struct timeval tv; + char cv = 0; + char ipstr[16]; + + prev = NULL; + pkt = pend_q; + pend_q = NULL; + tv.tv_sec = 1; + tv.tv_usec = 0; + select(0,NULL,NULL,NULL,&tv); /* Sleep for 1 Seconds */ + for (; pkt != NULL; pkt = nextpkt) { + nextpkt = pkt->next; + if (PPP_PROTOCOL(pkt->data) == proto) { + if ( (proto == PPP_IP) && newip ) { + /* Get old checksum */ + + iphdr = (pkt->data[4] & 15) << 2; + checksum = *((unsigned short *) (pkt->data+14)); + if (checksum == 0xFFFF) { + checksum = 0; + } + + + if (pkt->data[13] == 17) { + pkt_checksum = *((unsigned short *) (pkt->data+10+iphdr)); + if (pkt_checksum) { + cv = 1; + if (pkt_checksum == 0xFFFF) { + pkt_checksum = 0; + } + } + else { + cv = 0; + } + } + + if (pkt->data[13] == 6) { + pkt_checksum = *((unsigned short *) (pkt->data+20+iphdr)); + cv = 1; + if (pkt_checksum == 0xFFFF) { + pkt_checksum = 0; + } + } + + /* Delete old Source-IP-Address */ + checksum -= *((unsigned short *) (pkt->data+16)) ^ 0xFFFF; + checksum -= *((unsigned short *) (pkt->data+18)) ^ 0xFFFF; + + pkt_checksum -= *((unsigned short *) (pkt->data+16)) ^ 0xFFFF; + pkt_checksum -= *((unsigned short *) (pkt->data+18)) ^ 0xFFFF; + + /* Change Source-IP-Address */ + * ((u32_t *) (pkt->data + 16)) = newip; + + /* Add new Source-IP-Address */ + checksum += *((unsigned short *) (pkt->data+16)) ^ 0xFFFF; + checksum += *((unsigned short *) (pkt->data+18)) ^ 0xFFFF; + + pkt_checksum += *((unsigned short *) (pkt->data+16)) ^ 0xFFFF; + pkt_checksum += *((unsigned short *) (pkt->data+18)) ^ 0xFFFF; + + /* Write new checksum */ + if (!checksum) { + checksum = 0xFFFF; + } + *((unsigned short *) (pkt->data+14)) = checksum; + if (pkt->data[13] == 6) { + *((unsigned short *) (pkt->data+20+iphdr)) = pkt_checksum; + } + if (cv && (pkt->data[13] == 17) ) { + *((unsigned short *) (pkt->data+10+iphdr)) = pkt_checksum; + } + + /* Log Packet */ + strcpy(ipstr,inet_ntoa(*( (struct in_addr *) (pkt->data+16)))); + if (pkt->data[13] == 1) { + syslog(LOG_INFO,"Open ICMP %s -> %s\n", + ipstr, + inet_ntoa(*( (struct in_addr *) (pkt->data+20)))); + } else { + syslog(LOG_INFO,"Open %s %s:%d -> %s:%d\n", + pkt->data[13] == 6 ? "TCP" : "UDP", + ipstr, + ntohs(*( (short *) (pkt->data+iphdr+4))), + inet_ntoa(*( (struct in_addr *) (pkt->data+20))), + ntohs(*( (short *) (pkt->data+iphdr+6)))); + } + } + output(pcb, pkt->data, pkt->length); + free(pkt); + } else { + if (prev == NULL) + pend_q = pkt; + else + prev->next = pkt; + prev = pkt; + } + } + pend_qtail = prev; + if (prev != NULL) + prev->next = NULL; +} + +/* + * Scan a packet to decide whether it is an "active" packet, + * that is, whether it is worth bringing up the link for. + */ +static int +active_packet(p, len) + unsigned char *p; + int len; +{ + int proto, i; + const struct protent *protp; + + if (len < PPP_HDRLEN) + return 0; + proto = PPP_PROTOCOL(p); +#ifdef PPP_FILTER + p[0] = 1; /* outbound packet indicator */ + if ((pass_filter.bf_len != 0 + && bpf_filter(pass_filter.bf_insns, p, len, len) == 0) + || (active_filter.bf_len != 0 + && bpf_filter(active_filter.bf_insns, p, len, len) == 0)) { + p[0] = 0xff; + return 0; + } + p[0] = 0xff; +#endif + for (i = 0; (protp = protocols[i]) != NULL; ++i) { + if (protp->protocol < 0xC000 && (protp->protocol & ~0x8000) == proto) { + if (protp->active_pkt == NULL) + return 1; + return (*protp->active_pkt)(p, len); + } + } + return 0; /* not a supported protocol !!?? */ +} + +#endif /* PPP_SUPPORT && DEMAND_SUPPORT */ diff --git a/components/lwip/netif/ppp/eap.c b/components/lwip/netif/ppp/eap.c new file mode 100755 index 000000000..588206524 --- /dev/null +++ b/components/lwip/netif/ppp/eap.c @@ -0,0 +1,2429 @@ +/* + * eap.c - Extensible Authentication Protocol for PPP (RFC 2284) + * + * Copyright (c) 2001 by Sun Microsystems, Inc. + * All rights reserved. + * + * Non-exclusive rights to redistribute, modify, translate, and use + * this software in source and binary forms, in whole or in part, is + * hereby granted, provided that the above copyright notice is + * duplicated in any source form, and that neither the name of the + * copyright holder nor the author is used to endorse or promote + * products derived from this software. + * + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. + * + * Original version by James Carlson + * + * This implementation of EAP supports MD5-Challenge and SRP-SHA1 + * authentication styles. Note that support of MD5-Challenge is a + * requirement of RFC 2284, and that it's essentially just a + * reimplementation of regular RFC 1994 CHAP using EAP messages. + * + * As an authenticator ("server"), there are multiple phases for each + * style. In the first phase of each style, the unauthenticated peer + * name is queried using the EAP Identity request type. If the + * "remotename" option is used, then this phase is skipped, because + * the peer's name is presumed to be known. + * + * For MD5-Challenge, there are two phases, and the second phase + * consists of sending the challenge itself and handling the + * associated response. + * + * For SRP-SHA1, there are four phases. The second sends 's', 'N', + * and 'g'. The reply contains 'A'. The third sends 'B', and the + * reply contains 'M1'. The forth sends the 'M2' value. + * + * As an authenticatee ("client"), there's just a single phase -- + * responding to the queries generated by the peer. EAP is an + * authenticator-driven protocol. + * + * Based on draft-ietf-pppext-eap-srp-03.txt. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && EAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include "netif/ppp/ppp_impl.h" + +#if LWIP_INCLUDED_POLARSSL_MD5 +#include "netif/ppp/polarssl/md5.h" +#else +#include "polarssl/md5.h" +#endif + +#include "netif/ppp/eap.h" +#include "netif/ppp/magic.h" + +#ifdef USE_SRP +#include +#include +#include +#include "netif/ppp/pppcrypt.h" +#endif /* USE_SRP */ + +#ifndef SHA_DIGESTSIZE +#define SHA_DIGESTSIZE 20 +#endif + +#ifdef USE_SRP +static char *pn_secret = NULL; /* Pseudonym generating secret */ +#endif + +#if PPP_OPTIONS +/* + * Command-line options. + */ +static option_t eap_option_list[] = { + { "eap-restart", o_int, &eap_states[0].es_server.ea_timeout, + "Set retransmit timeout for EAP Requests (server)" }, + { "eap-max-sreq", o_int, &eap_states[0].es_server.ea_maxrequests, + "Set max number of EAP Requests sent (server)" }, + { "eap-timeout", o_int, &eap_states[0].es_client.ea_timeout, + "Set time limit for peer EAP authentication" }, + { "eap-max-rreq", o_int, &eap_states[0].es_client.ea_maxrequests, + "Set max number of EAP Requests allows (client)" }, + { "eap-interval", o_int, &eap_states[0].es_rechallenge, + "Set interval for EAP rechallenge" }, +#ifdef USE_SRP + { "srp-interval", o_int, &eap_states[0].es_lwrechallenge, + "Set interval for SRP lightweight rechallenge" }, + { "srp-pn-secret", o_string, &pn_secret, + "Long term pseudonym generation secret" }, + { "srp-use-pseudonym", o_bool, &eap_states[0].es_usepseudo, + "Use pseudonym if offered one by server", 1 }, +#endif + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points. + */ +static void eap_init(ppp_pcb *pcb); +static void eap_input(ppp_pcb *pcb, u_char *inp, int inlen); +static void eap_protrej(ppp_pcb *pcb); +static void eap_lowerup(ppp_pcb *pcb); +static void eap_lowerdown(ppp_pcb *pcb); +#if PRINTPKT_SUPPORT +static int eap_printpkt(const u_char *inp, int inlen, + void (*)(void *arg, const char *fmt, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ + +const struct protent eap_protent = { + PPP_EAP, /* protocol number */ + eap_init, /* initialization procedure */ + eap_input, /* process a received packet */ + eap_protrej, /* process a received protocol-reject */ + eap_lowerup, /* lower layer has gone up */ + eap_lowerdown, /* lower layer has gone down */ + NULL, /* open the protocol */ + NULL, /* close the protocol */ +#if PRINTPKT_SUPPORT + eap_printpkt, /* print a packet in readable form */ +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, /* process a received data packet */ +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "EAP", /* text name of protocol */ + NULL, /* text name of corresponding data protocol */ +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + eap_option_list, /* list of command-line options */ + NULL, /* check requested options; assign defaults */ +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, /* configure interface for demand-dial */ + NULL /* say whether to bring up link for this pkt */ +#endif /* DEMAND_SUPPORT */ +}; + +#ifdef USE_SRP +/* + * A well-known 2048 bit modulus. + */ +static const u_char wkmodulus[] = { + 0xAC, 0x6B, 0xDB, 0x41, 0x32, 0x4A, 0x9A, 0x9B, + 0xF1, 0x66, 0xDE, 0x5E, 0x13, 0x89, 0x58, 0x2F, + 0xAF, 0x72, 0xB6, 0x65, 0x19, 0x87, 0xEE, 0x07, + 0xFC, 0x31, 0x92, 0x94, 0x3D, 0xB5, 0x60, 0x50, + 0xA3, 0x73, 0x29, 0xCB, 0xB4, 0xA0, 0x99, 0xED, + 0x81, 0x93, 0xE0, 0x75, 0x77, 0x67, 0xA1, 0x3D, + 0xD5, 0x23, 0x12, 0xAB, 0x4B, 0x03, 0x31, 0x0D, + 0xCD, 0x7F, 0x48, 0xA9, 0xDA, 0x04, 0xFD, 0x50, + 0xE8, 0x08, 0x39, 0x69, 0xED, 0xB7, 0x67, 0xB0, + 0xCF, 0x60, 0x95, 0x17, 0x9A, 0x16, 0x3A, 0xB3, + 0x66, 0x1A, 0x05, 0xFB, 0xD5, 0xFA, 0xAA, 0xE8, + 0x29, 0x18, 0xA9, 0x96, 0x2F, 0x0B, 0x93, 0xB8, + 0x55, 0xF9, 0x79, 0x93, 0xEC, 0x97, 0x5E, 0xEA, + 0xA8, 0x0D, 0x74, 0x0A, 0xDB, 0xF4, 0xFF, 0x74, + 0x73, 0x59, 0xD0, 0x41, 0xD5, 0xC3, 0x3E, 0xA7, + 0x1D, 0x28, 0x1E, 0x44, 0x6B, 0x14, 0x77, 0x3B, + 0xCA, 0x97, 0xB4, 0x3A, 0x23, 0xFB, 0x80, 0x16, + 0x76, 0xBD, 0x20, 0x7A, 0x43, 0x6C, 0x64, 0x81, + 0xF1, 0xD2, 0xB9, 0x07, 0x87, 0x17, 0x46, 0x1A, + 0x5B, 0x9D, 0x32, 0xE6, 0x88, 0xF8, 0x77, 0x48, + 0x54, 0x45, 0x23, 0xB5, 0x24, 0xB0, 0xD5, 0x7D, + 0x5E, 0xA7, 0x7A, 0x27, 0x75, 0xD2, 0xEC, 0xFA, + 0x03, 0x2C, 0xFB, 0xDB, 0xF5, 0x2F, 0xB3, 0x78, + 0x61, 0x60, 0x27, 0x90, 0x04, 0xE5, 0x7A, 0xE6, + 0xAF, 0x87, 0x4E, 0x73, 0x03, 0xCE, 0x53, 0x29, + 0x9C, 0xCC, 0x04, 0x1C, 0x7B, 0xC3, 0x08, 0xD8, + 0x2A, 0x56, 0x98, 0xF3, 0xA8, 0xD0, 0xC3, 0x82, + 0x71, 0xAE, 0x35, 0xF8, 0xE9, 0xDB, 0xFB, 0xB6, + 0x94, 0xB5, 0xC8, 0x03, 0xD8, 0x9F, 0x7A, 0xE4, + 0x35, 0xDE, 0x23, 0x6D, 0x52, 0x5F, 0x54, 0x75, + 0x9B, 0x65, 0xE3, 0x72, 0xFC, 0xD6, 0x8E, 0xF2, + 0x0F, 0xA7, 0x11, 0x1F, 0x9E, 0x4A, 0xFF, 0x73 +}; +#endif + +#if PPP_SERVER +/* Local forward declarations. */ +static void eap_server_timeout(void *arg); +#endif /* PPP_SERVER */ + +/* + * Convert EAP state code to printable string for debug. + */ +static const char * eap_state_name(enum eap_state_code esc) +{ + static const char *state_names[] = { EAP_STATES }; + + return (state_names[(int)esc]); +} + +/* + * eap_init - Initialize state for an EAP user. This is currently + * called once by main() during start-up. + */ +static void eap_init(ppp_pcb *pcb) { + + BZERO(&pcb->eap, sizeof(eap_state)); +#if PPP_SERVER + pcb->eap.es_server.ea_id = magic(); +#endif /* PPP_SERVER */ +} + +/* + * eap_client_timeout - Give up waiting for the peer to send any + * Request messages. + */ +static void eap_client_timeout(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (!eap_client_active(pcb)) + return; + + ppp_error("EAP: timeout waiting for Request from peer"); + auth_withpeer_fail(pcb, PPP_EAP); + pcb->eap.es_client.ea_state = eapBadAuth; +} + +/* + * eap_authwithpeer - Authenticate to our peer (behave as client). + * + * Start client state and wait for requests. This is called only + * after eap_lowerup. + */ +void eap_authwithpeer(ppp_pcb *pcb, const char *localname) { + + if(NULL == localname) + return; + + /* Save the peer name we're given */ + pcb->eap.es_client.ea_name = localname; + pcb->eap.es_client.ea_namelen = strlen(localname); + + pcb->eap.es_client.ea_state = eapListen; + + /* + * Start a timer so that if the other end just goes + * silent, we don't sit here waiting forever. + */ + if (pcb->settings.eap_req_time > 0) + TIMEOUT(eap_client_timeout, pcb, + pcb->settings.eap_req_time); +} + +#if PPP_SERVER +/* + * Format a standard EAP Failure message and send it to the peer. + * (Server operation) + */ +static void eap_send_failure(ppp_pcb *pcb) { + struct pbuf *p; + u_char *outp; + + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + EAP_HEADERLEN), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_FAILURE, outp); + pcb->eap.es_server.ea_id++; + PUTCHAR(pcb->eap.es_server.ea_id, outp); + PUTSHORT(EAP_HEADERLEN, outp); + + ppp_write(pcb, p); + + pcb->eap.es_server.ea_state = eapBadAuth; + auth_peer_fail(pcb, PPP_EAP); +} + +/* + * Format a standard EAP Success message and send it to the peer. + * (Server operation) + */ +static void eap_send_success(ppp_pcb *pcb) { + struct pbuf *p; + u_char *outp; + + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + EAP_HEADERLEN), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_SUCCESS, outp); + pcb->eap.es_server.ea_id++; + PUTCHAR(pcb->eap.es_server.ea_id, outp); + PUTSHORT(EAP_HEADERLEN, outp); + + ppp_write(pcb, p); + + auth_peer_success(pcb, PPP_EAP, 0, + pcb->eap.es_server.ea_peer, pcb->eap.es_server.ea_peerlen); +} +#endif /* PPP_SERVER */ + +#ifdef USE_SRP +/* + * Set DES key according to pseudonym-generating secret and current + * date. + */ +static bool +pncrypt_setkey(int timeoffs) +{ + struct tm *tp; + char tbuf[9]; + SHA1_CTX ctxt; + u_char dig[SHA_DIGESTSIZE]; + time_t reftime; + + if (pn_secret == NULL) + return (0); + reftime = time(NULL) + timeoffs; + tp = localtime(&reftime); + SHA1Init(&ctxt); + SHA1Update(&ctxt, pn_secret, strlen(pn_secret)); + strftime(tbuf, sizeof (tbuf), "%Y%m%d", tp); + SHA1Update(&ctxt, tbuf, strlen(tbuf)); + SHA1Final(dig, &ctxt); + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + return (DesSetkey(dig)); +} + +static char base64[] = +"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; + +struct b64state { + u32_t bs_bits; + int bs_offs; +}; + +static int +b64enc(bs, inp, inlen, outp) +struct b64state *bs; +u_char *inp; +int inlen; +u_char *outp; +{ + int outlen = 0; + + while (inlen > 0) { + bs->bs_bits = (bs->bs_bits << 8) | *inp++; + inlen--; + bs->bs_offs += 8; + if (bs->bs_offs >= 24) { + *outp++ = base64[(bs->bs_bits >> 18) & 0x3F]; + *outp++ = base64[(bs->bs_bits >> 12) & 0x3F]; + *outp++ = base64[(bs->bs_bits >> 6) & 0x3F]; + *outp++ = base64[bs->bs_bits & 0x3F]; + outlen += 4; + bs->bs_offs = 0; + bs->bs_bits = 0; + } + } + return (outlen); +} + +static int +b64flush(bs, outp) +struct b64state *bs; +u_char *outp; +{ + int outlen = 0; + + if (bs->bs_offs == 8) { + *outp++ = base64[(bs->bs_bits >> 2) & 0x3F]; + *outp++ = base64[(bs->bs_bits << 4) & 0x3F]; + outlen = 2; + } else if (bs->bs_offs == 16) { + *outp++ = base64[(bs->bs_bits >> 10) & 0x3F]; + *outp++ = base64[(bs->bs_bits >> 4) & 0x3F]; + *outp++ = base64[(bs->bs_bits << 2) & 0x3F]; + outlen = 3; + } + bs->bs_offs = 0; + bs->bs_bits = 0; + return (outlen); +} + +static int +b64dec(bs, inp, inlen, outp) +struct b64state *bs; +u_char *inp; +int inlen; +u_char *outp; +{ + int outlen = 0; + char *cp; + + while (inlen > 0) { + if ((cp = strchr(base64, *inp++)) == NULL) + break; + bs->bs_bits = (bs->bs_bits << 6) | (cp - base64); + inlen--; + bs->bs_offs += 6; + if (bs->bs_offs >= 8) { + *outp++ = bs->bs_bits >> (bs->bs_offs - 8); + outlen++; + bs->bs_offs -= 8; + } + } + return (outlen); +} +#endif /* USE_SRP */ + +#if PPP_SERVER +/* + * Assume that current waiting server state is complete and figure + * next state to use based on available authentication data. 'status' + * indicates if there was an error in handling the last query. It is + * 0 for success and non-zero for failure. + */ +static void eap_figure_next_state(ppp_pcb *pcb, int status) { +#ifdef USE_SRP + unsigned char secbuf[MAXSECRETLEN], clear[8], *sp, *dp; + struct t_pw tpw; + struct t_confent *tce, mytce; + char *cp, *cp2; + struct t_server *ts; + int id, i, plen, toffs; + u_char vals[2]; + struct b64state bs; +#endif /* USE_SRP */ + + pcb->settings.eap_timeout_time = pcb->eap.es_savedtime; + switch (pcb->eap.es_server.ea_state) { + case eapBadAuth: + return; + + case eapIdentify: +#ifdef USE_SRP + /* Discard any previous session. */ + ts = (struct t_server *)pcb->eap.es_server.ea_session; + if (ts != NULL) { + t_serverclose(ts); + pcb->eap.es_server.ea_session = NULL; + pcb->eap.es_server.ea_skey = NULL; + } +#endif /* USE_SRP */ + if (status != 0) { + pcb->eap.es_server.ea_state = eapBadAuth; + break; + } +#ifdef USE_SRP + /* If we've got a pseudonym, try to decode to real name. */ + if (pcb->eap.es_server.ea_peerlen > SRP_PSEUDO_LEN && + strncmp(pcb->eap.es_server.ea_peer, SRP_PSEUDO_ID, + SRP_PSEUDO_LEN) == 0 && + (pcb->eap.es_server.ea_peerlen - SRP_PSEUDO_LEN) * 3 / 4 < + sizeof (secbuf)) { + BZERO(&bs, sizeof (bs)); + plen = b64dec(&bs, + pcb->eap.es_server.ea_peer + SRP_PSEUDO_LEN, + pcb->eap.es_server.ea_peerlen - SRP_PSEUDO_LEN, + secbuf); + toffs = 0; + for (i = 0; i < 5; i++) { + pncrypt_setkey(toffs); + toffs -= 86400; + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + if (!DesDecrypt(secbuf, clear)) { + ppp_dbglog("no DES here; cannot decode " + "pseudonym"); + return; + } + id = *(unsigned char *)clear; + if (id + 1 <= plen && id + 9 > plen) + break; + } + if (plen % 8 == 0 && i < 5) { + /* + * Note that this is always shorter than the + * original stored string, so there's no need + * to realloc. + */ + if ((i = plen = *(unsigned char *)clear) > 7) + i = 7; + pcb->eap.es_server.ea_peerlen = plen; + dp = (unsigned char *)pcb->eap.es_server.ea_peer; + MEMCPY(dp, clear + 1, i); + plen -= i; + dp += i; + sp = secbuf + 8; + while (plen > 0) { + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + (void) DesDecrypt(sp, dp); + sp += 8; + dp += 8; + plen -= 8; + } + pcb->eap.es_server.ea_peer[ + pcb->eap.es_server.ea_peerlen] = '\0'; + ppp_dbglog("decoded pseudonym to \"%.*q\"", + pcb->eap.es_server.ea_peerlen, + pcb->eap.es_server.ea_peer); + } else { + ppp_dbglog("failed to decode real name"); + /* Stay in eapIdentfy state; requery */ + break; + } + } + /* Look up user in secrets database. */ + if (get_srp_secret(pcb->eap.es_unit, pcb->eap.es_server.ea_peer, + pcb->eap.es_server.ea_name, (char *)secbuf, 1) != 0) { + /* Set up default in case SRP entry is bad */ + pcb->eap.es_server.ea_state = eapMD5Chall; + /* Get t_confent based on index in srp-secrets */ + id = strtol((char *)secbuf, &cp, 10); + if (*cp++ != ':' || id < 0) + break; + if (id == 0) { + mytce.index = 0; + mytce.modulus.data = (u_char *)wkmodulus; + mytce.modulus.len = sizeof (wkmodulus); + mytce.generator.data = (u_char *)"\002"; + mytce.generator.len = 1; + tce = &mytce; + } else if ((tce = gettcid(id)) != NULL) { + /* + * Client will have to verify this modulus/ + * generator combination, and that will take + * a while. Lengthen the timeout here. + */ + if (pcb->settings.eap_timeout_time > 0 && + pcb->settings.eap_timeout_time < 30) + pcb->settings.eap_timeout_time = 30; + } else { + break; + } + if ((cp2 = strchr(cp, ':')) == NULL) + break; + *cp2++ = '\0'; + tpw.pebuf.name = pcb->eap.es_server.ea_peer; + tpw.pebuf.password.len = t_fromb64((char *)tpw.pwbuf, + cp); + tpw.pebuf.password.data = tpw.pwbuf; + tpw.pebuf.salt.len = t_fromb64((char *)tpw.saltbuf, + cp2); + tpw.pebuf.salt.data = tpw.saltbuf; + if ((ts = t_serveropenraw(&tpw.pebuf, tce)) == NULL) + break; + pcb->eap.es_server.ea_session = (void *)ts; + pcb->eap.es_server.ea_state = eapSRP1; + vals[0] = pcb->eap.es_server.ea_id + 1; + vals[1] = EAPT_SRP; + t_serveraddexdata(ts, vals, 2); + /* Generate B; must call before t_servergetkey() */ + t_servergenexp(ts); + break; + } +#endif /* USE_SRP */ + pcb->eap.es_server.ea_state = eapMD5Chall; + break; + + case eapSRP1: +#ifdef USE_SRP + ts = (struct t_server *)pcb->eap.es_server.ea_session; + if (ts != NULL && status != 0) { + t_serverclose(ts); + pcb->eap.es_server.ea_session = NULL; + pcb->eap.es_server.ea_skey = NULL; + } +#endif /* USE_SRP */ + if (status == 1) { + pcb->eap.es_server.ea_state = eapMD5Chall; + } else if (status != 0 || pcb->eap.es_server.ea_session == NULL) { + pcb->eap.es_server.ea_state = eapBadAuth; + } else { + pcb->eap.es_server.ea_state = eapSRP2; + } + break; + + case eapSRP2: +#ifdef USE_SRP + ts = (struct t_server *)pcb->eap.es_server.ea_session; + if (ts != NULL && status != 0) { + t_serverclose(ts); + pcb->eap.es_server.ea_session = NULL; + pcb->eap.es_server.ea_skey = NULL; + } +#endif /* USE_SRP */ + if (status != 0 || pcb->eap.es_server.ea_session == NULL) { + pcb->eap.es_server.ea_state = eapBadAuth; + } else { + pcb->eap.es_server.ea_state = eapSRP3; + } + break; + + case eapSRP3: + case eapSRP4: +#ifdef USE_SRP + ts = (struct t_server *)pcb->eap.es_server.ea_session; + if (ts != NULL && status != 0) { + t_serverclose(ts); + pcb->eap.es_server.ea_session = NULL; + pcb->eap.es_server.ea_skey = NULL; + } +#endif /* USE_SRP */ + if (status != 0 || pcb->eap.es_server.ea_session == NULL) { + pcb->eap.es_server.ea_state = eapBadAuth; + } else { + pcb->eap.es_server.ea_state = eapOpen; + } + break; + + case eapMD5Chall: + if (status != 0) { + pcb->eap.es_server.ea_state = eapBadAuth; + } else { + pcb->eap.es_server.ea_state = eapOpen; + } + break; + + default: + pcb->eap.es_server.ea_state = eapBadAuth; + break; + } + if (pcb->eap.es_server.ea_state == eapBadAuth) + eap_send_failure(pcb); +} + +/* + * Format an EAP Request message and send it to the peer. Message + * type depends on current state. (Server operation) + */ +static void eap_send_request(ppp_pcb *pcb) { + struct pbuf *p; + u_char *outp; + u_char *lenloc; + int outlen; + int len; + const char *str; +#ifdef USE_SRP + struct t_server *ts; + u_char clear[8], cipher[8], dig[SHA_DIGESTSIZE], *optr, *cp; + int i, j; + struct b64state b64; + SHA1_CTX ctxt; +#endif /* USE_SRP */ + + /* Handle both initial auth and restart */ + if (pcb->eap.es_server.ea_state < eapIdentify && + pcb->eap.es_server.ea_state != eapInitial) { + pcb->eap.es_server.ea_state = eapIdentify; +#if PPP_REMOTENAME + if (pcb->settings.explicit_remote && pcb->remote_name) { + /* + * If we already know the peer's + * unauthenticated name, then there's no + * reason to ask. Go to next state instead. + */ + int len = (int)strlen(pcb->remote_name); + if (len > MAXNAMELEN) { + len = MAXNAMELEN; + } + MEMCPY(pcb->eap.es_server.ea_peer, pcb->remote_name, len); + pcb->eap.es_server.ea_peer[len] = '\0'; + pcb->eap.es_server.ea_peerlen = len; + eap_figure_next_state(pcb, 0); + } +#endif /* PPP_REMOTENAME */ + } + + if (pcb->settings.eap_max_transmits > 0 && + pcb->eap.es_server.ea_requests >= pcb->settings.eap_max_transmits) { + if (pcb->eap.es_server.ea_responses > 0) + ppp_error("EAP: too many Requests sent"); + else + ppp_error("EAP: no response to Requests"); + eap_send_failure(pcb); + return; + } + + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_CTRL_PBUF_MAX_SIZE), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_REQUEST, outp); + PUTCHAR(pcb->eap.es_server.ea_id, outp); + lenloc = outp; + INCPTR(2, outp); + + switch (pcb->eap.es_server.ea_state) { + case eapIdentify: + PUTCHAR(EAPT_IDENTITY, outp); + str = "Name"; + len = strlen(str); + MEMCPY(outp, str, len); + INCPTR(len, outp); + break; + + case eapMD5Chall: + PUTCHAR(EAPT_MD5CHAP, outp); + /* + * pick a random challenge length between + * EAP_MIN_CHALLENGE_LENGTH and EAP_MAX_CHALLENGE_LENGTH + */ + pcb->eap.es_challen = EAP_MIN_CHALLENGE_LENGTH + + magic_pow(EAP_MIN_MAX_POWER_OF_TWO_CHALLENGE_LENGTH); + PUTCHAR(pcb->eap.es_challen, outp); + magic_random_bytes(pcb->eap.es_challenge, pcb->eap.es_challen); + MEMCPY(outp, pcb->eap.es_challenge, pcb->eap.es_challen); + INCPTR(pcb->eap.es_challen, outp); + MEMCPY(outp, pcb->eap.es_server.ea_name, pcb->eap.es_server.ea_namelen); + INCPTR(pcb->eap.es_server.ea_namelen, outp); + break; + +#ifdef USE_SRP + case eapSRP1: + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(EAPSRP_CHALLENGE, outp); + + PUTCHAR(pcb->eap.es_server.ea_namelen, outp); + MEMCPY(outp, pcb->eap.es_server.ea_name, pcb->eap.es_server.ea_namelen); + INCPTR(pcb->eap.es_server.ea_namelen, outp); + + ts = (struct t_server *)pcb->eap.es_server.ea_session; + assert(ts != NULL); + PUTCHAR(ts->s.len, outp); + MEMCPY(outp, ts->s.data, ts->s.len); + INCPTR(ts->s.len, outp); + + if (ts->g.len == 1 && ts->g.data[0] == 2) { + PUTCHAR(0, outp); + } else { + PUTCHAR(ts->g.len, outp); + MEMCPY(outp, ts->g.data, ts->g.len); + INCPTR(ts->g.len, outp); + } + + if (ts->n.len != sizeof (wkmodulus) || + BCMP(ts->n.data, wkmodulus, sizeof (wkmodulus)) != 0) { + MEMCPY(outp, ts->n.data, ts->n.len); + INCPTR(ts->n.len, outp); + } + break; + + case eapSRP2: + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(EAPSRP_SKEY, outp); + + ts = (struct t_server *)pcb->eap.es_server.ea_session; + assert(ts != NULL); + MEMCPY(outp, ts->B.data, ts->B.len); + INCPTR(ts->B.len, outp); + break; + + case eapSRP3: + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(EAPSRP_SVALIDATOR, outp); + PUTLONG(SRPVAL_EBIT, outp); + ts = (struct t_server *)pcb->eap.es_server.ea_session; + assert(ts != NULL); + MEMCPY(outp, t_serverresponse(ts), SHA_DIGESTSIZE); + INCPTR(SHA_DIGESTSIZE, outp); + + if (pncrypt_setkey(0)) { + /* Generate pseudonym */ + optr = outp; + cp = (unsigned char *)pcb->eap.es_server.ea_peer; + if ((j = i = pcb->eap.es_server.ea_peerlen) > 7) + j = 7; + clear[0] = i; + MEMCPY(clear + 1, cp, j); + i -= j; + cp += j; + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + if (!DesEncrypt(clear, cipher)) { + ppp_dbglog("no DES here; not generating pseudonym"); + break; + } + BZERO(&b64, sizeof (b64)); + outp++; /* space for pseudonym length */ + outp += b64enc(&b64, cipher, 8, outp); + while (i >= 8) { + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + (void) DesEncrypt(cp, cipher); + outp += b64enc(&b64, cipher, 8, outp); + cp += 8; + i -= 8; + } + if (i > 0) { + MEMCPY(clear, cp, i); + cp += i; + magic_random_bytes(cp, 8-i); + /* FIXME: if we want to do SRP, we need to find a way to pass the PolarSSL des_context instead of using static memory */ + (void) DesEncrypt(clear, cipher); + outp += b64enc(&b64, cipher, 8, outp); + } + outp += b64flush(&b64, outp); + + /* Set length and pad out to next 20 octet boundary */ + i = outp - optr - 1; + *optr = i; + i %= SHA_DIGESTSIZE; + if (i != 0) { + magic_random_bytes(outp, SHA_DIGESTSIZE-i); + INCPTR(SHA_DIGESTSIZE-i, outp); + } + + /* Obscure the pseudonym with SHA1 hash */ + SHA1Init(&ctxt); + SHA1Update(&ctxt, &pcb->eap.es_server.ea_id, 1); + SHA1Update(&ctxt, pcb->eap.es_server.ea_skey, + SESSION_KEY_LEN); + SHA1Update(&ctxt, pcb->eap.es_server.ea_peer, + pcb->eap.es_server.ea_peerlen); + while (optr < outp) { + SHA1Final(dig, &ctxt); + cp = dig; + while (cp < dig + SHA_DIGESTSIZE) + *optr++ ^= *cp++; + SHA1Init(&ctxt); + SHA1Update(&ctxt, &pcb->eap.es_server.ea_id, 1); + SHA1Update(&ctxt, pcb->eap.es_server.ea_skey, + SESSION_KEY_LEN); + SHA1Update(&ctxt, optr - SHA_DIGESTSIZE, + SHA_DIGESTSIZE); + } + } + break; + + case eapSRP4: + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(EAPSRP_LWRECHALLENGE, outp); + pcb->eap.es_challen = EAP_MIN_CHALLENGE_LENGTH + + magic_pow(EAP_MIN_MAX_POWER_OF_TWO_CHALLENGE_LENGTH); + magic_random_bytes(pcb->eap.es_challenge, pcb->eap.es_challen); + MEMCPY(outp, pcb->eap.es_challenge, pcb->eap.es_challen); + INCPTR(pcb->eap.es_challen, outp); + break; +#endif /* USE_SRP */ + + default: + return; + } + + outlen = (outp - (unsigned char*)p->payload) - PPP_HDRLEN; + PUTSHORT(outlen, lenloc); + + pbuf_realloc(p, outlen + PPP_HDRLEN); + ppp_write(pcb, p); + + pcb->eap.es_server.ea_requests++; + + if (pcb->settings.eap_timeout_time > 0) + TIMEOUT(eap_server_timeout, pcb, pcb->settings.eap_timeout_time); +} + +/* + * eap_authpeer - Authenticate our peer (behave as server). + * + * Start server state and send first request. This is called only + * after eap_lowerup. + */ +void eap_authpeer(ppp_pcb *pcb, const char *localname) { + + /* Save the name we're given. */ + pcb->eap.es_server.ea_name = localname; + pcb->eap.es_server.ea_namelen = strlen(localname); + + pcb->eap.es_savedtime = pcb->settings.eap_timeout_time; + + /* Lower layer up yet? */ + if (pcb->eap.es_server.ea_state == eapInitial || + pcb->eap.es_server.ea_state == eapPending) { + pcb->eap.es_server.ea_state = eapPending; + return; + } + + pcb->eap.es_server.ea_state = eapPending; + + /* ID number not updated here intentionally; hashed into M1 */ + eap_send_request(pcb); +} + +/* + * eap_server_timeout - Retransmission timer for sending Requests + * expired. + */ +static void eap_server_timeout(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (!eap_server_active(pcb)) + return; + + /* EAP ID number must not change on timeout. */ + eap_send_request(pcb); +} + +/* + * When it's time to send rechallenge the peer, this timeout is + * called. Once the rechallenge is successful, the response handler + * will restart the timer. If it fails, then the link is dropped. + */ +static void eap_rechallenge(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (pcb->eap.es_server.ea_state != eapOpen && + pcb->eap.es_server.ea_state != eapSRP4) + return; + + pcb->eap.es_server.ea_requests = 0; + pcb->eap.es_server.ea_state = eapIdentify; + eap_figure_next_state(pcb, 0); + pcb->eap.es_server.ea_id++; + eap_send_request(pcb); +} + +static void srp_lwrechallenge(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (pcb->eap.es_server.ea_state != eapOpen || + pcb->eap.es_server.ea_type != EAPT_SRP) + return; + + pcb->eap.es_server.ea_requests = 0; + pcb->eap.es_server.ea_state = eapSRP4; + pcb->eap.es_server.ea_id++; + eap_send_request(pcb); +} +#endif /* PPP_SERVER */ + +/* + * eap_lowerup - The lower layer is now up. + * + * This is called before either eap_authpeer or eap_authwithpeer. See + * link_established() in auth.c. All that's necessary here is to + * return to closed state so that those two routines will do the right + * thing. + */ +static void eap_lowerup(ppp_pcb *pcb) { + pcb->eap.es_client.ea_state = eapClosed; +#if PPP_SERVER + pcb->eap.es_server.ea_state = eapClosed; +#endif /* PPP_SERVER */ +} + +/* + * eap_lowerdown - The lower layer is now down. + * + * Cancel all timeouts and return to initial state. + */ +static void eap_lowerdown(ppp_pcb *pcb) { + + if (eap_client_active(pcb) && pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, pcb); + } +#if PPP_SERVER + if (eap_server_active(pcb)) { + if (pcb->settings.eap_timeout_time > 0) { + UNTIMEOUT(eap_server_timeout, pcb); + } + } else { + if ((pcb->eap.es_server.ea_state == eapOpen || + pcb->eap.es_server.ea_state == eapSRP4) && + pcb->eap.es_rechallenge > 0) { + UNTIMEOUT(eap_rechallenge, (void *)pcb); + } + if (pcb->eap.es_server.ea_state == eapOpen && + pcb->eap.es_lwrechallenge > 0) { + UNTIMEOUT(srp_lwrechallenge, (void *)pcb); + } + } + + pcb->eap.es_client.ea_state = pcb->eap.es_server.ea_state = eapInitial; + pcb->eap.es_client.ea_requests = pcb->eap.es_server.ea_requests = 0; +#endif /* PPP_SERVER */ +} + +/* + * eap_protrej - Peer doesn't speak this protocol. + * + * This shouldn't happen. If it does, it represents authentication + * failure. + */ +static void eap_protrej(ppp_pcb *pcb) { + + if (eap_client_active(pcb)) { + ppp_error("EAP authentication failed due to Protocol-Reject"); + auth_withpeer_fail(pcb, PPP_EAP); + } +#if PPP_SERVER + if (eap_server_active(pcb)) { + ppp_error("EAP authentication of peer failed on Protocol-Reject"); + auth_peer_fail(pcb, PPP_EAP); + } +#endif /* PPP_SERVER */ + eap_lowerdown(pcb); +} + +/* + * Format and send a regular EAP Response message. + */ +static void eap_send_response(ppp_pcb *pcb, u_char id, u_char typenum, const u_char *str, int lenstr) { + struct pbuf *p; + u_char *outp; + int msglen; + + msglen = EAP_HEADERLEN + sizeof (u_char) + lenstr; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + msglen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_RESPONSE, outp); + PUTCHAR(id, outp); + pcb->eap.es_client.ea_id = id; + PUTSHORT(msglen, outp); + PUTCHAR(typenum, outp); + if (lenstr > 0) { + MEMCPY(outp, str, lenstr); + } + + ppp_write(pcb, p); +} + +/* + * Format and send an MD5-Challenge EAP Response message. + */ +static void eap_chap_response(ppp_pcb *pcb, u_char id, u_char *hash, const char *name, int namelen) { + struct pbuf *p; + u_char *outp; + int msglen; + + msglen = EAP_HEADERLEN + 2 * sizeof (u_char) + MD5_SIGNATURE_SIZE + + namelen; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + msglen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_RESPONSE, outp); + PUTCHAR(id, outp); + pcb->eap.es_client.ea_id = id; + PUTSHORT(msglen, outp); + PUTCHAR(EAPT_MD5CHAP, outp); + PUTCHAR(MD5_SIGNATURE_SIZE, outp); + MEMCPY(outp, hash, MD5_SIGNATURE_SIZE); + INCPTR(MD5_SIGNATURE_SIZE, outp); + if (namelen > 0) { + MEMCPY(outp, name, namelen); + } + + ppp_write(pcb, p); +} + +#ifdef USE_SRP +/* + * Format and send a SRP EAP Response message. + */ +static void +eap_srp_response(esp, id, subtypenum, str, lenstr) +eap_state *esp; +u_char id; +u_char subtypenum; +u_char *str; +int lenstr; +{ + ppp_pcb *pcb = &ppp_pcb_list[pcb->eap.es_unit]; + struct pbuf *p; + u_char *outp; + int msglen; + + msglen = EAP_HEADERLEN + 2 * sizeof (u_char) + lenstr; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + msglen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_RESPONSE, outp); + PUTCHAR(id, outp); + pcb->eap.es_client.ea_id = id; + PUTSHORT(msglen, outp); + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(subtypenum, outp); + if (lenstr > 0) { + MEMCPY(outp, str, lenstr); + } + + ppp_write(pcb, p); +} + +/* + * Format and send a SRP EAP Client Validator Response message. + */ +static void +eap_srpval_response(esp, id, flags, str) +eap_state *esp; +u_char id; +u32_t flags; +u_char *str; +{ + ppp_pcb *pcb = &ppp_pcb_list[pcb->eap.es_unit]; + struct pbuf *p; + u_char *outp; + int msglen; + + msglen = EAP_HEADERLEN + 2 * sizeof (u_char) + sizeof (u32_t) + + SHA_DIGESTSIZE; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + msglen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_RESPONSE, outp); + PUTCHAR(id, outp); + pcb->eap.es_client.ea_id = id; + PUTSHORT(msglen, outp); + PUTCHAR(EAPT_SRP, outp); + PUTCHAR(EAPSRP_CVALIDATOR, outp); + PUTLONG(flags, outp); + MEMCPY(outp, str, SHA_DIGESTSIZE); + + ppp_write(pcb, p); +} +#endif /* USE_SRP */ + +static void eap_send_nak(ppp_pcb *pcb, u_char id, u_char type) { + struct pbuf *p; + u_char *outp; + int msglen; + + msglen = EAP_HEADERLEN + 2 * sizeof (u_char); + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN + msglen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + + MAKEHEADER(outp, PPP_EAP); + + PUTCHAR(EAP_RESPONSE, outp); + PUTCHAR(id, outp); + pcb->eap.es_client.ea_id = id; + PUTSHORT(msglen, outp); + PUTCHAR(EAPT_NAK, outp); + PUTCHAR(type, outp); + + ppp_write(pcb, p); +} + +#ifdef USE_SRP +static char * +name_of_pn_file() +{ + char *user, *path, *file; + struct passwd *pw; + size_t pl; + static bool pnlogged = 0; + + pw = getpwuid(getuid()); + if (pw == NULL || (user = pw->pw_dir) == NULL || user[0] == 0) { + errno = EINVAL; + return (NULL); + } + file = _PATH_PSEUDONYM; + pl = strlen(user) + strlen(file) + 2; + path = malloc(pl); + if (path == NULL) + return (NULL); + (void) slprintf(path, pl, "%s/%s", user, file); + if (!pnlogged) { + ppp_dbglog("pseudonym file: %s", path); + pnlogged = 1; + } + return (path); +} + +static int +open_pn_file(modebits) +mode_t modebits; +{ + char *path; + int fd, err; + + if ((path = name_of_pn_file()) == NULL) + return (-1); + fd = open(path, modebits, S_IRUSR | S_IWUSR); + err = errno; + free(path); + errno = err; + return (fd); +} + +static void +remove_pn_file() +{ + char *path; + + if ((path = name_of_pn_file()) != NULL) { + (void) unlink(path); + (void) free(path); + } +} + +static void +write_pseudonym(esp, inp, len, id) +eap_state *esp; +u_char *inp; +int len, id; +{ + u_char val; + u_char *datp, *digp; + SHA1_CTX ctxt; + u_char dig[SHA_DIGESTSIZE]; + int dsize, fd, olen = len; + + /* + * Do the decoding by working backwards. This eliminates the need + * to save the decoded output in a separate buffer. + */ + val = id; + while (len > 0) { + if ((dsize = len % SHA_DIGESTSIZE) == 0) + dsize = SHA_DIGESTSIZE; + len -= dsize; + datp = inp + len; + SHA1Init(&ctxt); + SHA1Update(&ctxt, &val, 1); + SHA1Update(&ctxt, pcb->eap.es_client.ea_skey, SESSION_KEY_LEN); + if (len > 0) { + SHA1Update(&ctxt, datp, SHA_DIGESTSIZE); + } else { + SHA1Update(&ctxt, pcb->eap.es_client.ea_name, + pcb->eap.es_client.ea_namelen); + } + SHA1Final(dig, &ctxt); + for (digp = dig; digp < dig + SHA_DIGESTSIZE; digp++) + *datp++ ^= *digp; + } + + /* Now check that the result is sane */ + if (olen <= 0 || *inp + 1 > olen) { + ppp_dbglog("EAP: decoded pseudonym is unusable <%.*B>", olen, inp); + return; + } + + /* Save it away */ + fd = open_pn_file(O_WRONLY | O_CREAT | O_TRUNC); + if (fd < 0) { + ppp_dbglog("EAP: error saving pseudonym: %m"); + return; + } + len = write(fd, inp + 1, *inp); + if (close(fd) != -1 && len == *inp) { + ppp_dbglog("EAP: saved pseudonym"); + pcb->eap.es_usedpseudo = 0; + } else { + ppp_dbglog("EAP: failed to save pseudonym"); + remove_pn_file(); + } +} +#endif /* USE_SRP */ + +/* + * eap_request - Receive EAP Request message (client mode). + */ +static void eap_request(ppp_pcb *pcb, u_char *inp, int id, int len) { + u_char typenum; + u_char vallen; + int secret_len; + char secret[MAXSECRETLEN]; + char rhostname[MAXNAMELEN]; + md5_context mdContext; + u_char hash[MD5_SIGNATURE_SIZE]; +#ifdef USE_SRP + struct t_client *tc; + struct t_num sval, gval, Nval, *Ap, Bval; + u_char vals[2]; + SHA1_CTX ctxt; + u_char dig[SHA_DIGESTSIZE]; + int fd; +#endif /* USE_SRP */ + + /* + * Note: we update es_client.ea_id *only if* a Response + * message is being generated. Otherwise, we leave it the + * same for duplicate detection purposes. + */ + + pcb->eap.es_client.ea_requests++; + if (pcb->settings.eap_allow_req != 0 && + pcb->eap.es_client.ea_requests > pcb->settings.eap_allow_req) { + ppp_info("EAP: received too many Request messages"); + if (pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, pcb); + } + auth_withpeer_fail(pcb, PPP_EAP); + return; + } + + if (len <= 0) { + ppp_error("EAP: empty Request message discarded"); + return; + } + + GETCHAR(typenum, inp); + len--; + + switch (typenum) { + case EAPT_IDENTITY: + if (len > 0) + ppp_info("EAP: Identity prompt \"%.*q\"", len, inp); +#ifdef USE_SRP + if (pcb->eap.es_usepseudo && + (pcb->eap.es_usedpseudo == 0 || + (pcb->eap.es_usedpseudo == 1 && + id == pcb->eap.es_client.ea_id))) { + pcb->eap.es_usedpseudo = 1; + /* Try to get a pseudonym */ + if ((fd = open_pn_file(O_RDONLY)) >= 0) { + strcpy(rhostname, SRP_PSEUDO_ID); + len = read(fd, rhostname + SRP_PSEUDO_LEN, + sizeof (rhostname) - SRP_PSEUDO_LEN); + /* XXX NAI unsupported */ + if (len > 0) { + eap_send_response(pcb, id, typenum, + rhostname, len + SRP_PSEUDO_LEN); + } + (void) close(fd); + if (len > 0) + break; + } + } + /* Stop using pseudonym now. */ + if (pcb->eap.es_usepseudo && pcb->eap.es_usedpseudo != 2) { + remove_pn_file(); + pcb->eap.es_usedpseudo = 2; + } +#endif /* USE_SRP */ + eap_send_response(pcb, id, typenum, (const u_char*)pcb->eap.es_client.ea_name, + pcb->eap.es_client.ea_namelen); + break; + + case EAPT_NOTIFICATION: + if (len > 0) + ppp_info("EAP: Notification \"%.*q\"", len, inp); + eap_send_response(pcb, id, typenum, NULL, 0); + break; + + case EAPT_NAK: + /* + * Avoid the temptation to send Response Nak in reply + * to Request Nak here. It can only lead to trouble. + */ + ppp_warn("EAP: unexpected Nak in Request; ignored"); + /* Return because we're waiting for something real. */ + return; + + case EAPT_MD5CHAP: + if (len < 1) { + ppp_error("EAP: received MD5-Challenge with no data"); + /* Bogus request; wait for something real. */ + return; + } + GETCHAR(vallen, inp); + len--; + if (vallen < 8 || vallen > len) { + ppp_error("EAP: MD5-Challenge with bad length %d (8..%d)", + vallen, len); + /* Try something better. */ + eap_send_nak(pcb, id, EAPT_SRP); + break; + } + + /* Not so likely to happen. */ + if (vallen >= len + sizeof (rhostname)) { + ppp_dbglog("EAP: trimming really long peer name down"); + MEMCPY(rhostname, inp + vallen, sizeof (rhostname) - 1); + rhostname[sizeof (rhostname) - 1] = '\0'; + } else { + MEMCPY(rhostname, inp + vallen, len - vallen); + rhostname[len - vallen] = '\0'; + } + +#if PPP_REMOTENAME + /* In case the remote doesn't give us his name. */ + if (pcb->settings.explicit_remote || + (pcb->settings.remote_name[0] != '\0' && vallen == len)) + strlcpy(rhostname, pcb->settings.remote_name, sizeof (rhostname)); +#endif /* PPP_REMOTENAME */ + + /* + * Get the secret for authenticating ourselves with + * the specified host. + */ + if (!get_secret(pcb, pcb->eap.es_client.ea_name, + rhostname, secret, &secret_len, 0)) { + ppp_dbglog("EAP: no MD5 secret for auth to %q", rhostname); + eap_send_nak(pcb, id, EAPT_SRP); + break; + } + md5_starts(&mdContext); + typenum = id; + md5_update(&mdContext, &typenum, 1); + md5_update(&mdContext, (u_char *)secret, secret_len); + BZERO(secret, sizeof (secret)); + md5_update(&mdContext, inp, vallen); + md5_finish(&mdContext, hash); + eap_chap_response(pcb, id, hash, pcb->eap.es_client.ea_name, + pcb->eap.es_client.ea_namelen); + break; + +#ifdef USE_SRP + case EAPT_SRP: + if (len < 1) { + ppp_error("EAP: received empty SRP Request"); + /* Bogus request; wait for something real. */ + return; + } + + /* Get subtype */ + GETCHAR(vallen, inp); + len--; + switch (vallen) { + case EAPSRP_CHALLENGE: + tc = NULL; + if (pcb->eap.es_client.ea_session != NULL) { + tc = (struct t_client *)pcb->eap.es_client. + ea_session; + /* + * If this is a new challenge, then start + * over with a new client session context. + * Otherwise, just resend last response. + */ + if (id != pcb->eap.es_client.ea_id) { + t_clientclose(tc); + pcb->eap.es_client.ea_session = NULL; + tc = NULL; + } + } + /* No session key just yet */ + pcb->eap.es_client.ea_skey = NULL; + if (tc == NULL) { + int rhostnamelen; + + GETCHAR(vallen, inp); + len--; + if (vallen >= len) { + ppp_error("EAP: badly-formed SRP Challenge" + " (name)"); + /* Ignore badly-formed messages */ + return; + } + MEMCPY(rhostname, inp, vallen); + rhostname[vallen] = '\0'; + INCPTR(vallen, inp); + len -= vallen; + + /* + * In case the remote doesn't give us his name, + * use configured name. + */ + if (explicit_remote || + (remote_name[0] != '\0' && vallen == 0)) { + strlcpy(rhostname, remote_name, + sizeof (rhostname)); + } + + rhostnamelen = (int)strlen(rhostname); + if (rhostnamelen > MAXNAMELEN) { + rhostnamelen = MAXNAMELEN; + } + MEMCPY(pcb->eap.es_client.ea_peer, rhostname, rhostnamelen); + pcb->eap.es_client.ea_peer[rhostnamelen] = '\0'; + pcb->eap.es_client.ea_peerlen = rhostnamelen; + + GETCHAR(vallen, inp); + len--; + if (vallen >= len) { + ppp_error("EAP: badly-formed SRP Challenge" + " (s)"); + /* Ignore badly-formed messages */ + return; + } + sval.data = inp; + sval.len = vallen; + INCPTR(vallen, inp); + len -= vallen; + + GETCHAR(vallen, inp); + len--; + if (vallen > len) { + ppp_error("EAP: badly-formed SRP Challenge" + " (g)"); + /* Ignore badly-formed messages */ + return; + } + /* If no generator present, then use value 2 */ + if (vallen == 0) { + gval.data = (u_char *)"\002"; + gval.len = 1; + } else { + gval.data = inp; + gval.len = vallen; + } + INCPTR(vallen, inp); + len -= vallen; + + /* + * If no modulus present, then use well-known + * value. + */ + if (len == 0) { + Nval.data = (u_char *)wkmodulus; + Nval.len = sizeof (wkmodulus); + } else { + Nval.data = inp; + Nval.len = len; + } + tc = t_clientopen(pcb->eap.es_client.ea_name, + &Nval, &gval, &sval); + if (tc == NULL) { + eap_send_nak(pcb, id, EAPT_MD5CHAP); + break; + } + pcb->eap.es_client.ea_session = (void *)tc; + + /* Add Challenge ID & type to verifier */ + vals[0] = id; + vals[1] = EAPT_SRP; + t_clientaddexdata(tc, vals, 2); + } + Ap = t_clientgenexp(tc); + eap_srp_response(esp, id, EAPSRP_CKEY, Ap->data, + Ap->len); + break; + + case EAPSRP_SKEY: + tc = (struct t_client *)pcb->eap.es_client.ea_session; + if (tc == NULL) { + ppp_warn("EAP: peer sent Subtype 2 without 1"); + eap_send_nak(pcb, id, EAPT_MD5CHAP); + break; + } + if (pcb->eap.es_client.ea_skey != NULL) { + /* + * ID number should not change here. Warn + * if it does (but otherwise ignore). + */ + if (id != pcb->eap.es_client.ea_id) { + ppp_warn("EAP: ID changed from %d to %d " + "in SRP Subtype 2 rexmit", + pcb->eap.es_client.ea_id, id); + } + } else { + if (get_srp_secret(pcb->eap.es_unit, + pcb->eap.es_client.ea_name, + pcb->eap.es_client.ea_peer, secret, 0) == 0) { + /* + * Can't work with this peer because + * the secret is missing. Just give + * up. + */ + eap_send_nak(pcb, id, EAPT_MD5CHAP); + break; + } + Bval.data = inp; + Bval.len = len; + t_clientpasswd(tc, secret); + BZERO(secret, sizeof (secret)); + pcb->eap.es_client.ea_skey = + t_clientgetkey(tc, &Bval); + if (pcb->eap.es_client.ea_skey == NULL) { + /* Server is rogue; stop now */ + ppp_error("EAP: SRP server is rogue"); + goto client_failure; + } + } + eap_srpval_response(esp, id, SRPVAL_EBIT, + t_clientresponse(tc)); + break; + + case EAPSRP_SVALIDATOR: + tc = (struct t_client *)pcb->eap.es_client.ea_session; + if (tc == NULL || pcb->eap.es_client.ea_skey == NULL) { + ppp_warn("EAP: peer sent Subtype 3 without 1/2"); + eap_send_nak(pcb, id, EAPT_MD5CHAP); + break; + } + /* + * If we're already open, then this ought to be a + * duplicate. Otherwise, check that the server is + * who we think it is. + */ + if (pcb->eap.es_client.ea_state == eapOpen) { + if (id != pcb->eap.es_client.ea_id) { + ppp_warn("EAP: ID changed from %d to %d " + "in SRP Subtype 3 rexmit", + pcb->eap.es_client.ea_id, id); + } + } else { + len -= sizeof (u32_t) + SHA_DIGESTSIZE; + if (len < 0 || t_clientverify(tc, inp + + sizeof (u32_t)) != 0) { + ppp_error("EAP: SRP server verification " + "failed"); + goto client_failure; + } + GETLONG(pcb->eap.es_client.ea_keyflags, inp); + /* Save pseudonym if user wants it. */ + if (len > 0 && pcb->eap.es_usepseudo) { + INCPTR(SHA_DIGESTSIZE, inp); + write_pseudonym(esp, inp, len, id); + } + } + /* + * We've verified our peer. We're now mostly done, + * except for waiting on the regular EAP Success + * message. + */ + eap_srp_response(esp, id, EAPSRP_ACK, NULL, 0); + break; + + case EAPSRP_LWRECHALLENGE: + if (len < 4) { + ppp_warn("EAP: malformed Lightweight rechallenge"); + return; + } + SHA1Init(&ctxt); + vals[0] = id; + SHA1Update(&ctxt, vals, 1); + SHA1Update(&ctxt, pcb->eap.es_client.ea_skey, + SESSION_KEY_LEN); + SHA1Update(&ctxt, inp, len); + SHA1Update(&ctxt, pcb->eap.es_client.ea_name, + pcb->eap.es_client.ea_namelen); + SHA1Final(dig, &ctxt); + eap_srp_response(esp, id, EAPSRP_LWRECHALLENGE, dig, + SHA_DIGESTSIZE); + break; + + default: + ppp_error("EAP: unknown SRP Subtype %d", vallen); + eap_send_nak(pcb, id, EAPT_MD5CHAP); + break; + } + break; +#endif /* USE_SRP */ + + default: + ppp_info("EAP: unknown authentication type %d; Naking", typenum); + eap_send_nak(pcb, id, EAPT_SRP); + break; + } + + if (pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, pcb); + TIMEOUT(eap_client_timeout, pcb, + pcb->settings.eap_req_time); + } + return; + +#ifdef USE_SRP +client_failure: + pcb->eap.es_client.ea_state = eapBadAuth; + if (pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, (void *)esp); + } + pcb->eap.es_client.ea_session = NULL; + t_clientclose(tc); + auth_withpeer_fail(pcb, PPP_EAP); +#endif /* USE_SRP */ +} + +#if PPP_SERVER +/* + * eap_response - Receive EAP Response message (server mode). + */ +static void eap_response(ppp_pcb *pcb, u_char *inp, int id, int len) { + u_char typenum; + u_char vallen; + int secret_len; + char secret[MAXSECRETLEN]; + char rhostname[MAXNAMELEN]; + md5_context mdContext; + u_char hash[MD5_SIGNATURE_SIZE]; +#ifdef USE_SRP + struct t_server *ts; + struct t_num A; + SHA1_CTX ctxt; + u_char dig[SHA_DIGESTSIZE]; +#endif /* USE_SRP */ + + if (pcb->eap.es_server.ea_id != id) { + ppp_dbglog("EAP: discarding Response %d; expected ID %d", id, + pcb->eap.es_server.ea_id); + return; + } + + pcb->eap.es_server.ea_responses++; + + if (len <= 0) { + ppp_error("EAP: empty Response message discarded"); + return; + } + + GETCHAR(typenum, inp); + len--; + + switch (typenum) { + case EAPT_IDENTITY: + if (pcb->eap.es_server.ea_state != eapIdentify) { + ppp_dbglog("EAP discarding unwanted Identify \"%.q\"", len, + inp); + break; + } + ppp_info("EAP: unauthenticated peer name \"%.*q\"", len, inp); + if (len > MAXNAMELEN) { + len = MAXNAMELEN; + } + MEMCPY(pcb->eap.es_server.ea_peer, inp, len); + pcb->eap.es_server.ea_peer[len] = '\0'; + pcb->eap.es_server.ea_peerlen = len; + eap_figure_next_state(pcb, 0); + break; + + case EAPT_NOTIFICATION: + ppp_dbglog("EAP unexpected Notification; response discarded"); + break; + + case EAPT_NAK: + if (len < 1) { + ppp_info("EAP: Nak Response with no suggested protocol"); + eap_figure_next_state(pcb, 1); + break; + } + + GETCHAR(vallen, inp); + len--; + + if ( +#if PPP_REMOTENAME + !pcb->explicit_remote && +#endif /* PPP_REMOTENAME */ + pcb->eap.es_server.ea_state == eapIdentify){ + /* Peer cannot Nak Identify Request */ + eap_figure_next_state(pcb, 1); + break; + } + + switch (vallen) { + case EAPT_SRP: + /* Run through SRP validator selection again. */ + pcb->eap.es_server.ea_state = eapIdentify; + eap_figure_next_state(pcb, 0); + break; + + case EAPT_MD5CHAP: + pcb->eap.es_server.ea_state = eapMD5Chall; + break; + + default: + ppp_dbglog("EAP: peer requesting unknown Type %d", vallen); + switch (pcb->eap.es_server.ea_state) { + case eapSRP1: + case eapSRP2: + case eapSRP3: + pcb->eap.es_server.ea_state = eapMD5Chall; + break; + case eapMD5Chall: + case eapSRP4: + pcb->eap.es_server.ea_state = eapIdentify; + eap_figure_next_state(pcb, 0); + break; + default: + break; + } + break; + } + break; + + case EAPT_MD5CHAP: + if (pcb->eap.es_server.ea_state != eapMD5Chall) { + ppp_error("EAP: unexpected MD5-Response"); + eap_figure_next_state(pcb, 1); + break; + } + if (len < 1) { + ppp_error("EAP: received MD5-Response with no data"); + eap_figure_next_state(pcb, 1); + break; + } + GETCHAR(vallen, inp); + len--; + if (vallen != 16 || vallen > len) { + ppp_error("EAP: MD5-Response with bad length %d", vallen); + eap_figure_next_state(pcb, 1); + break; + } + + /* Not so likely to happen. */ + if (vallen >= len + sizeof (rhostname)) { + ppp_dbglog("EAP: trimming really long peer name down"); + MEMCPY(rhostname, inp + vallen, sizeof (rhostname) - 1); + rhostname[sizeof (rhostname) - 1] = '\0'; + } else { + MEMCPY(rhostname, inp + vallen, len - vallen); + rhostname[len - vallen] = '\0'; + } + +#if PPP_REMOTENAME + /* In case the remote doesn't give us his name. */ + if (explicit_remote || + (remote_name[0] != '\0' && vallen == len)) + strlcpy(rhostname, remote_name, sizeof (rhostname)); +#endif /* PPP_REMOTENAME */ + + /* + * Get the secret for authenticating the specified + * host. + */ + if (!get_secret(pcb, rhostname, + pcb->eap.es_server.ea_name, secret, &secret_len, 1)) { + ppp_dbglog("EAP: no MD5 secret for auth of %q", rhostname); + eap_send_failure(pcb); + break; + } + md5_starts(&mdContext); + md5_update(&mdContext, &pcb->eap.es_server.ea_id, 1); + md5_update(&mdContext, (u_char *)secret, secret_len); + BZERO(secret, sizeof (secret)); + md5_update(&mdContext, pcb->eap.es_challenge, pcb->eap.es_challen); + md5_finish(&mdContext, hash); + if (BCMP(hash, inp, MD5_SIGNATURE_SIZE) != 0) { + eap_send_failure(pcb); + break; + } + pcb->eap.es_server.ea_type = EAPT_MD5CHAP; + eap_send_success(pcb); + eap_figure_next_state(pcb, 0); + if (pcb->eap.es_rechallenge != 0) + TIMEOUT(eap_rechallenge, pcb, pcb->eap.es_rechallenge); + break; + +#ifdef USE_SRP + case EAPT_SRP: + if (len < 1) { + ppp_error("EAP: empty SRP Response"); + eap_figure_next_state(pcb, 1); + break; + } + GETCHAR(typenum, inp); + len--; + switch (typenum) { + case EAPSRP_CKEY: + if (pcb->eap.es_server.ea_state != eapSRP1) { + ppp_error("EAP: unexpected SRP Subtype 1 Response"); + eap_figure_next_state(pcb, 1); + break; + } + A.data = inp; + A.len = len; + ts = (struct t_server *)pcb->eap.es_server.ea_session; + assert(ts != NULL); + pcb->eap.es_server.ea_skey = t_servergetkey(ts, &A); + if (pcb->eap.es_server.ea_skey == NULL) { + /* Client's A value is bogus; terminate now */ + ppp_error("EAP: bogus A value from client"); + eap_send_failure(pcb); + } else { + eap_figure_next_state(pcb, 0); + } + break; + + case EAPSRP_CVALIDATOR: + if (pcb->eap.es_server.ea_state != eapSRP2) { + ppp_error("EAP: unexpected SRP Subtype 2 Response"); + eap_figure_next_state(pcb, 1); + break; + } + if (len < sizeof (u32_t) + SHA_DIGESTSIZE) { + ppp_error("EAP: M1 length %d < %d", len, + sizeof (u32_t) + SHA_DIGESTSIZE); + eap_figure_next_state(pcb, 1); + break; + } + GETLONG(pcb->eap.es_server.ea_keyflags, inp); + ts = (struct t_server *)pcb->eap.es_server.ea_session; + assert(ts != NULL); + if (t_serververify(ts, inp)) { + ppp_info("EAP: unable to validate client identity"); + eap_send_failure(pcb); + break; + } + eap_figure_next_state(pcb, 0); + break; + + case EAPSRP_ACK: + if (pcb->eap.es_server.ea_state != eapSRP3) { + ppp_error("EAP: unexpected SRP Subtype 3 Response"); + eap_send_failure(esp); + break; + } + pcb->eap.es_server.ea_type = EAPT_SRP; + eap_send_success(pcb, esp); + eap_figure_next_state(pcb, 0); + if (pcb->eap.es_rechallenge != 0) + TIMEOUT(eap_rechallenge, pcb, + pcb->eap.es_rechallenge); + if (pcb->eap.es_lwrechallenge != 0) + TIMEOUT(srp_lwrechallenge, pcb, + pcb->eap.es_lwrechallenge); + break; + + case EAPSRP_LWRECHALLENGE: + if (pcb->eap.es_server.ea_state != eapSRP4) { + ppp_info("EAP: unexpected SRP Subtype 4 Response"); + return; + } + if (len != SHA_DIGESTSIZE) { + ppp_error("EAP: bad Lightweight rechallenge " + "response"); + return; + } + SHA1Init(&ctxt); + vallen = id; + SHA1Update(&ctxt, &vallen, 1); + SHA1Update(&ctxt, pcb->eap.es_server.ea_skey, + SESSION_KEY_LEN); + SHA1Update(&ctxt, pcb->eap.es_challenge, pcb->eap.es_challen); + SHA1Update(&ctxt, pcb->eap.es_server.ea_peer, + pcb->eap.es_server.ea_peerlen); + SHA1Final(dig, &ctxt); + if (BCMP(dig, inp, SHA_DIGESTSIZE) != 0) { + ppp_error("EAP: failed Lightweight rechallenge"); + eap_send_failure(pcb); + break; + } + pcb->eap.es_server.ea_state = eapOpen; + if (pcb->eap.es_lwrechallenge != 0) + TIMEOUT(srp_lwrechallenge, esp, + pcb->eap.es_lwrechallenge); + break; + } + break; +#endif /* USE_SRP */ + + default: + /* This can't happen. */ + ppp_error("EAP: unknown Response type %d; ignored", typenum); + return; + } + + if (pcb->settings.eap_timeout_time > 0) { + UNTIMEOUT(eap_server_timeout, pcb); + } + + if (pcb->eap.es_server.ea_state != eapBadAuth && + pcb->eap.es_server.ea_state != eapOpen) { + pcb->eap.es_server.ea_id++; + eap_send_request(pcb); + } +} +#endif /* PPP_SERVER */ + +/* + * eap_success - Receive EAP Success message (client mode). + */ +static void eap_success(ppp_pcb *pcb, u_char *inp, int id, int len) { + LWIP_UNUSED_ARG(id); + + if (pcb->eap.es_client.ea_state != eapOpen && !eap_client_active(pcb)) { + ppp_dbglog("EAP unexpected success message in state %s (%d)", + eap_state_name(pcb->eap.es_client.ea_state), + pcb->eap.es_client.ea_state); + return; + } + + if (pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, pcb); + } + + if (len > 0) { + /* This is odd. The spec doesn't allow for this. */ + PRINTMSG(inp, len); + } + + pcb->eap.es_client.ea_state = eapOpen; + auth_withpeer_success(pcb, PPP_EAP, 0); +} + +/* + * eap_failure - Receive EAP Failure message (client mode). + */ +static void eap_failure(ppp_pcb *pcb, u_char *inp, int id, int len) { + LWIP_UNUSED_ARG(id); + + if (!eap_client_active(pcb)) { + ppp_dbglog("EAP unexpected failure message in state %s (%d)", + eap_state_name(pcb->eap.es_client.ea_state), + pcb->eap.es_client.ea_state); + } + + if (pcb->settings.eap_req_time > 0) { + UNTIMEOUT(eap_client_timeout, pcb); + } + + if (len > 0) { + /* This is odd. The spec doesn't allow for this. */ + PRINTMSG(inp, len); + } + + pcb->eap.es_client.ea_state = eapBadAuth; + + ppp_error("EAP: peer reports authentication failure"); + auth_withpeer_fail(pcb, PPP_EAP); +} + +/* + * eap_input - Handle received EAP message. + */ +static void eap_input(ppp_pcb *pcb, u_char *inp, int inlen) { + u_char code, id; + int len; + + /* + * Parse header (code, id and length). If packet too short, + * drop it. + */ + if (inlen < EAP_HEADERLEN) { + ppp_error("EAP: packet too short: %d < %d", inlen, EAP_HEADERLEN); + return; + } + GETCHAR(code, inp); + GETCHAR(id, inp); + GETSHORT(len, inp); + if (len < EAP_HEADERLEN || len > inlen) { + ppp_error("EAP: packet has illegal length field %d (%d..%d)", len, + EAP_HEADERLEN, inlen); + return; + } + len -= EAP_HEADERLEN; + + /* Dispatch based on message code */ + switch (code) { + case EAP_REQUEST: + eap_request(pcb, inp, id, len); + break; + +#if PPP_SERVER + case EAP_RESPONSE: + eap_response(pcb, inp, id, len); + break; +#endif /* PPP_SERVER */ + + case EAP_SUCCESS: + eap_success(pcb, inp, id, len); + break; + + case EAP_FAILURE: + eap_failure(pcb, inp, id, len); + break; + + default: /* XXX Need code reject */ + /* Note: it's not legal to send EAP Nak here. */ + ppp_warn("EAP: unknown code %d received", code); + break; + } +} + +#if PRINTPKT_SUPPORT +/* + * eap_printpkt - print the contents of an EAP packet. + */ +static const char* const eap_codenames[] = { + "Request", "Response", "Success", "Failure" +}; + +static const char* const eap_typenames[] = { + "Identity", "Notification", "Nak", "MD5-Challenge", + "OTP", "Generic-Token", NULL, NULL, + "RSA", "DSS", "KEA", "KEA-Validate", + "TLS", "Defender", "Windows 2000", "Arcot", + "Cisco", "Nokia", "SRP" +}; + +static int eap_printpkt(const u_char *inp, int inlen, void (*printer) (void *, const char *, ...), void *arg) { + int code, id, len, rtype, vallen; + const u_char *pstart; + u32_t uval; + + if (inlen < EAP_HEADERLEN) + return (0); + pstart = inp; + GETCHAR(code, inp); + GETCHAR(id, inp); + GETSHORT(len, inp); + if (len < EAP_HEADERLEN || len > inlen) + return (0); + + if (code >= 1 && code <= (int)sizeof(eap_codenames) / (int)sizeof(char *)) + printer(arg, " %s", eap_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= EAP_HEADERLEN; + switch (code) { + case EAP_REQUEST: + if (len < 1) { + printer(arg, " "); + break; + } + GETCHAR(rtype, inp); + len--; + if (rtype >= 1 && + rtype <= (int)sizeof (eap_typenames) / (int)sizeof (char *)) + printer(arg, " %s", eap_typenames[rtype-1]); + else + printer(arg, " type=0x%x", rtype); + switch (rtype) { + case EAPT_IDENTITY: + case EAPT_NOTIFICATION: + if (len > 0) { + printer(arg, " "); + INCPTR(len, inp); + len = 0; + } else { + printer(arg, " "); + } + break; + + case EAPT_MD5CHAP: + if (len <= 0) + break; + GETCHAR(vallen, inp); + len--; + if (vallen > len) + goto truncated; + printer(arg, " ", vallen, inp); + INCPTR(vallen, inp); + len -= vallen; + if (len > 0) { + printer(arg, " "); + INCPTR(len, inp); + len = 0; + } else { + printer(arg, " "); + } + break; + + case EAPT_SRP: + if (len < 3) + goto truncated; + GETCHAR(vallen, inp); + len--; + printer(arg, "-%d", vallen); + switch (vallen) { + case EAPSRP_CHALLENGE: + GETCHAR(vallen, inp); + len--; + if (vallen >= len) + goto truncated; + if (vallen > 0) { + printer(arg, " "); + } else { + printer(arg, " "); + } + INCPTR(vallen, inp); + len -= vallen; + GETCHAR(vallen, inp); + len--; + if (vallen >= len) + goto truncated; + printer(arg, " ", vallen, inp); + INCPTR(vallen, inp); + len -= vallen; + GETCHAR(vallen, inp); + len--; + if (vallen > len) + goto truncated; + if (vallen == 0) { + printer(arg, " "); + } else { + printer(arg, " ", vallen, inp); + } + INCPTR(vallen, inp); + len -= vallen; + if (len == 0) { + printer(arg, " "); + } else { + printer(arg, " ", len, inp); + INCPTR(len, inp); + len = 0; + } + break; + + case EAPSRP_SKEY: + printer(arg, " ", len, inp); + INCPTR(len, inp); + len = 0; + break; + + case EAPSRP_SVALIDATOR: + if (len < (int)sizeof (u32_t)) + break; + GETLONG(uval, inp); + len -= sizeof (u32_t); + if (uval & SRPVAL_EBIT) { + printer(arg, " E"); + uval &= ~SRPVAL_EBIT; + } + if (uval != 0) { + printer(arg, " f<%X>", uval); + } + if ((vallen = len) > SHA_DIGESTSIZE) + vallen = SHA_DIGESTSIZE; + printer(arg, " ", len, inp, + len < SHA_DIGESTSIZE ? "?" : ""); + INCPTR(vallen, inp); + len -= vallen; + if (len > 0) { + printer(arg, " ", len, inp); + INCPTR(len, inp); + len = 0; + } + break; + + case EAPSRP_LWRECHALLENGE: + printer(arg, " ", len, inp); + INCPTR(len, inp); + len = 0; + break; + default: + break; + } + break; + default: + break; + } + break; + + case EAP_RESPONSE: + if (len < 1) + break; + GETCHAR(rtype, inp); + len--; + if (rtype >= 1 && + rtype <= (int)sizeof (eap_typenames) / (int)sizeof (char *)) + printer(arg, " %s", eap_typenames[rtype-1]); + else + printer(arg, " type=0x%x", rtype); + switch (rtype) { + case EAPT_IDENTITY: + if (len > 0) { + printer(arg, " "); + INCPTR(len, inp); + len = 0; + } + break; + + case EAPT_NAK: + if (len <= 0) { + printer(arg, " "); + break; + } + GETCHAR(rtype, inp); + len--; + printer(arg, " = 1 && + rtype < (int)sizeof (eap_typenames) / (int)sizeof (char *)) + printer(arg, " (%s)", eap_typenames[rtype-1]); + printer(arg, ">"); + break; + + case EAPT_MD5CHAP: + if (len <= 0) { + printer(arg, " "); + break; + } + GETCHAR(vallen, inp); + len--; + if (vallen > len) + goto truncated; + printer(arg, " ", vallen, inp); + INCPTR(vallen, inp); + len -= vallen; + if (len > 0) { + printer(arg, " "); + INCPTR(len, inp); + len = 0; + } else { + printer(arg, " "); + } + break; + + case EAPT_SRP: + if (len < 1) + goto truncated; + GETCHAR(vallen, inp); + len--; + printer(arg, "-%d", vallen); + switch (vallen) { + case EAPSRP_CKEY: + printer(arg, " ", len, inp); + INCPTR(len, inp); + len = 0; + break; + + case EAPSRP_CVALIDATOR: + if (len < (int)sizeof (u32_t)) + break; + GETLONG(uval, inp); + len -= sizeof (u32_t); + if (uval & SRPVAL_EBIT) { + printer(arg, " E"); + uval &= ~SRPVAL_EBIT; + } + if (uval != 0) { + printer(arg, " f<%X>", uval); + } + printer(arg, " ", len, inp, + len == SHA_DIGESTSIZE ? "" : "?"); + INCPTR(len, inp); + len = 0; + break; + + case EAPSRP_ACK: + break; + + case EAPSRP_LWRECHALLENGE: + printer(arg, " ", len, inp, + len == SHA_DIGESTSIZE ? "" : "?"); + if ((vallen = len) > SHA_DIGESTSIZE) + vallen = SHA_DIGESTSIZE; + INCPTR(vallen, inp); + len -= vallen; + break; + default: + break; + } + break; + default: + break; + } + break; + + case EAP_SUCCESS: /* No payload expected for these! */ + case EAP_FAILURE: + default: + break; + + truncated: + printer(arg, " "); + break; + } + + if (len > 8) + printer(arg, "%8B...", inp); + else if (len > 0) + printer(arg, "%.*B", len, inp); + INCPTR(len, inp); + + return (inp - pstart); +} +#endif /* PRINTPKT_SUPPORT */ + +#endif /* PPP_SUPPORT && EAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/ecp.c b/components/lwip/netif/ppp/ecp.c new file mode 100755 index 000000000..4f1dee333 --- /dev/null +++ b/components/lwip/netif/ppp/ecp.c @@ -0,0 +1,191 @@ +/* + * ecp.c - PPP Encryption Control Protocol. + * + * Copyright (c) 2002 Google, Inc. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * Derived from ccp.c, which is: + * + * Copyright (c) 1994-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && ECP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/ecp.h" + +#if PPP_OPTIONS +static option_t ecp_option_list[] = { + { "noecp", o_bool, &ecp_protent.enabled_flag, + "Disable ECP negotiation" }, + { "-ecp", o_bool, &ecp_protent.enabled_flag, + "Disable ECP negotiation", OPT_ALIAS }, + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points from main code. + */ +static void ecp_init (int unit); +/* +static void ecp_open (int unit); +static void ecp_close (int unit, char *); +static void ecp_lowerup (int unit); +static void ecp_lowerdown (int); +static void ecp_input (int unit, u_char *pkt, int len); +static void ecp_protrej (int unit); +*/ +#if PRINTPKT_SUPPORT +static int ecp_printpkt (const u_char *pkt, int len, + void (*printer) (void *, char *, ...), + void *arg); +#endif /* PRINTPKT_SUPPORT */ +/* +static void ecp_datainput (int unit, u_char *pkt, int len); +*/ + +const struct protent ecp_protent = { + PPP_ECP, + ecp_init, + NULL, /* ecp_input, */ + NULL, /* ecp_protrej, */ + NULL, /* ecp_lowerup, */ + NULL, /* ecp_lowerdown, */ + NULL, /* ecp_open, */ + NULL, /* ecp_close, */ +#if PRINTPKT_SUPPORT + ecp_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, /* ecp_datainput, */ +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "ECP", + "Encrypted", +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + ecp_option_list, + NULL, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, + NULL +#endif /* DEMAND_SUPPORT */ +}; + +fsm ecp_fsm[NUM_PPP]; +ecp_options ecp_wantoptions[NUM_PPP]; /* what to request the peer to use */ +ecp_options ecp_gotoptions[NUM_PPP]; /* what the peer agreed to do */ +ecp_options ecp_allowoptions[NUM_PPP]; /* what we'll agree to do */ +ecp_options ecp_hisoptions[NUM_PPP]; /* what we agreed to do */ + +static const fsm_callbacks ecp_callbacks = { + NULL, /* ecp_resetci, */ + NULL, /* ecp_cilen, */ + NULL, /* ecp_addci, */ + NULL, /* ecp_ackci, */ + NULL, /* ecp_nakci, */ + NULL, /* ecp_rejci, */ + NULL, /* ecp_reqci, */ + NULL, /* ecp_up, */ + NULL, /* ecp_down, */ + NULL, + NULL, + NULL, + NULL, + NULL, /* ecp_extcode, */ + "ECP" +}; + +/* + * ecp_init - initialize ECP. + */ +static void +ecp_init(unit) + int unit; +{ + fsm *f = &ecp_fsm[unit]; + + f->unit = unit; + f->protocol = PPP_ECP; + f->callbacks = &ecp_callbacks; + fsm_init(f); + +#if 0 /* Not necessary, everything is cleared in ppp_clear() */ + memset(&ecp_wantoptions[unit], 0, sizeof(ecp_options)); + memset(&ecp_gotoptions[unit], 0, sizeof(ecp_options)); + memset(&ecp_allowoptions[unit], 0, sizeof(ecp_options)); + memset(&ecp_hisoptions[unit], 0, sizeof(ecp_options)); +#endif /* 0 */ + +} + + +#if PRINTPKT_SUPPORT +static int +ecp_printpkt(p, plen, printer, arg) + const u_char *p; + int plen; + void (*printer) (void *, char *, ...); + void *arg; +{ + return 0; +} +#endif /* PRINTPKT_SUPPORT */ + +#endif /* PPP_SUPPORT && ECP_SUPPORT */ diff --git a/components/lwip/netif/ppp/eui64.c b/components/lwip/netif/ppp/eui64.c new file mode 100755 index 000000000..e042eb4cb --- /dev/null +++ b/components/lwip/netif/ppp/eui64.c @@ -0,0 +1,56 @@ +/* + * eui64.c - EUI64 routines for IPv6CP. + * + * Copyright (c) 1999 Tommi Komulainen. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Tommi Komulainen + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: eui64.c,v 1.6 2002/12/04 23:03:32 paulus Exp $ + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV6_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/eui64.h" + +/* + * eui64_ntoa - Make an ascii representation of an interface identifier + */ +char *eui64_ntoa(eui64_t e) { + static char buf[20]; + + sprintf(buf, "%02x%02x:%02x%02x:%02x%02x:%02x%02x", + e.e8[0], e.e8[1], e.e8[2], e.e8[3], + e.e8[4], e.e8[5], e.e8[6], e.e8[7]); + return buf; +} + +#endif /* PPP_SUPPORT && PPP_IPV6_SUPPORT */ diff --git a/components/lwip/netif/ppp/fsm.c b/components/lwip/netif/ppp/fsm.c new file mode 100755 index 000000000..d7c514224 --- /dev/null +++ b/components/lwip/netif/ppp/fsm.c @@ -0,0 +1,799 @@ +/* + * fsm.c - {Link, IP} Control Protocol Finite State Machine. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +/* + * TODO: + * Randomize fsm id on link/init. + * Deal with variable outgoing MTU. + */ + +#if 0 /* UNUSED */ +#include +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" + +static void fsm_timeout (void *); +static void fsm_rconfreq(fsm *f, u_char id, u_char *inp, int len); +static void fsm_rconfack(fsm *f, int id, u_char *inp, int len); +static void fsm_rconfnakrej(fsm *f, int code, int id, u_char *inp, int len); +static void fsm_rtermreq(fsm *f, int id, u_char *p, int len); +static void fsm_rtermack(fsm *f); +static void fsm_rcoderej(fsm *f, u_char *inp, int len); +static void fsm_sconfreq(fsm *f, int retransmit); + +#define PROTO_NAME(f) ((f)->callbacks->proto_name) + +/* + * fsm_init - Initialize fsm. + * + * Initialize fsm state. + */ +void fsm_init(fsm *f) { + ppp_pcb *pcb = f->pcb; + f->state = PPP_FSM_INITIAL; + f->flags = 0; + f->id = 0; /* XXX Start with random id? */ + f->maxnakloops = pcb->settings.fsm_max_nak_loops; + f->term_reason_len = 0; +} + + +/* + * fsm_lowerup - The lower layer is up. + */ +void fsm_lowerup(fsm *f) { + switch( f->state ){ + case PPP_FSM_INITIAL: + f->state = PPP_FSM_CLOSED; + break; + + case PPP_FSM_STARTING: + if( f->flags & OPT_SILENT ) + f->state = PPP_FSM_STOPPED; + else { + /* Send an initial configure-request */ + fsm_sconfreq(f, 0); + f->state = PPP_FSM_REQSENT; + } + break; + + default: + FSMDEBUG(("%s: Up event in state %d!", PROTO_NAME(f), f->state)); + /* no break */ + } +} + + +/* + * fsm_lowerdown - The lower layer is down. + * + * Cancel all timeouts and inform upper layers. + */ +void fsm_lowerdown(fsm *f) { + switch( f->state ){ + case PPP_FSM_CLOSED: + f->state = PPP_FSM_INITIAL; + break; + + case PPP_FSM_STOPPED: + f->state = PPP_FSM_STARTING; + if( f->callbacks->starting ) + (*f->callbacks->starting)(f); + break; + + case PPP_FSM_CLOSING: + f->state = PPP_FSM_INITIAL; + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + break; + + case PPP_FSM_STOPPING: + case PPP_FSM_REQSENT: + case PPP_FSM_ACKRCVD: + case PPP_FSM_ACKSENT: + f->state = PPP_FSM_STARTING; + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + break; + + case PPP_FSM_OPENED: + if( f->callbacks->down ) + (*f->callbacks->down)(f); + f->state = PPP_FSM_STARTING; + break; + + default: + FSMDEBUG(("%s: Down event in state %d!", PROTO_NAME(f), f->state)); + /* no break */ + } +} + + +/* + * fsm_open - Link is allowed to come up. + */ +void fsm_open(fsm *f) { + switch( f->state ){ + case PPP_FSM_INITIAL: + f->state = PPP_FSM_STARTING; + if( f->callbacks->starting ) + (*f->callbacks->starting)(f); + break; + + case PPP_FSM_CLOSED: + if( f->flags & OPT_SILENT ) + f->state = PPP_FSM_STOPPED; + else { + /* Send an initial configure-request */ + fsm_sconfreq(f, 0); + f->state = PPP_FSM_REQSENT; + } + break; + + case PPP_FSM_CLOSING: + f->state = PPP_FSM_STOPPING; + /* fall through */ + /* no break */ + case PPP_FSM_STOPPED: + case PPP_FSM_OPENED: + if( f->flags & OPT_RESTART ){ + fsm_lowerdown(f); + fsm_lowerup(f); + } + break; + default: + break; + } +} + +/* + * terminate_layer - Start process of shutting down the FSM + * + * Cancel any timeout running, notify upper layers we're done, and + * send a terminate-request message as configured. + */ +static void terminate_layer(fsm *f, int nextstate) { + ppp_pcb *pcb = f->pcb; + + if( f->state != PPP_FSM_OPENED ) + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + else if( f->callbacks->down ) + (*f->callbacks->down)(f); /* Inform upper layers we're down */ + + /* Init restart counter and send Terminate-Request */ + f->retransmits = pcb->settings.fsm_max_term_transmits; + fsm_sdata(f, TERMREQ, f->reqid = ++f->id, + (const u_char *) f->term_reason, f->term_reason_len); + + if (f->retransmits == 0) { + /* + * User asked for no terminate requests at all; just close it. + * We've already fired off one Terminate-Request just to be nice + * to the peer, but we're not going to wait for a reply. + */ + f->state = nextstate == PPP_FSM_CLOSING ? PPP_FSM_CLOSED : PPP_FSM_STOPPED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + return; + } + + TIMEOUT(fsm_timeout, f, pcb->settings.fsm_timeout_time); + --f->retransmits; + + f->state = nextstate; +} + +/* + * fsm_close - Start closing connection. + * + * Cancel timeouts and either initiate close or possibly go directly to + * the PPP_FSM_CLOSED state. + */ +void fsm_close(fsm *f, const char *reason) { + f->term_reason = reason; + f->term_reason_len = (reason == NULL? 0: LWIP_MIN(strlen(reason), 0xFF) ); + switch( f->state ){ + case PPP_FSM_STARTING: + f->state = PPP_FSM_INITIAL; + break; + case PPP_FSM_STOPPED: + f->state = PPP_FSM_CLOSED; + break; + case PPP_FSM_STOPPING: + f->state = PPP_FSM_CLOSING; + break; + + case PPP_FSM_REQSENT: + case PPP_FSM_ACKRCVD: + case PPP_FSM_ACKSENT: + case PPP_FSM_OPENED: + terminate_layer(f, PPP_FSM_CLOSING); + break; + default: + break; + } +} + + +/* + * fsm_timeout - Timeout expired. + */ +static void fsm_timeout(void *arg) { + fsm *f = (fsm *) arg; + ppp_pcb *pcb = f->pcb; + + switch (f->state) { + case PPP_FSM_CLOSING: + case PPP_FSM_STOPPING: + if( f->retransmits <= 0 ){ + /* + * We've waited for an ack long enough. Peer probably heard us. + */ + f->state = (f->state == PPP_FSM_CLOSING)? PPP_FSM_CLOSED: PPP_FSM_STOPPED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + } else { + /* Send Terminate-Request */ + fsm_sdata(f, TERMREQ, f->reqid = ++f->id, + (const u_char *) f->term_reason, f->term_reason_len); + TIMEOUT(fsm_timeout, f, pcb->settings.fsm_timeout_time); + --f->retransmits; + } + break; + + case PPP_FSM_REQSENT: + case PPP_FSM_ACKRCVD: + case PPP_FSM_ACKSENT: + if (f->retransmits <= 0) { + ppp_warn("%s: timeout sending Config-Requests", PROTO_NAME(f)); + f->state = PPP_FSM_STOPPED; + if( (f->flags & OPT_PASSIVE) == 0 && f->callbacks->finished ) + (*f->callbacks->finished)(f); + + } else { + /* Retransmit the configure-request */ + if (f->callbacks->retransmit) + (*f->callbacks->retransmit)(f); + fsm_sconfreq(f, 1); /* Re-send Configure-Request */ + if( f->state == PPP_FSM_ACKRCVD ) + f->state = PPP_FSM_REQSENT; + } + break; + + default: + FSMDEBUG(("%s: Timeout event in state %d!", PROTO_NAME(f), f->state)); + /* no break */ + } +} + + +/* + * fsm_input - Input packet. + */ +void fsm_input(fsm *f, u_char *inpacket, int l) { + u_char *inp; + u_char code, id; + int len; + + /* + * Parse header (code, id and length). + * If packet too short, drop it. + */ + inp = inpacket; + if (l < HEADERLEN) { + FSMDEBUG(("fsm_input(%x): Rcvd short header.", f->protocol)); + return; + } + GETCHAR(code, inp); + GETCHAR(id, inp); + GETSHORT(len, inp); + if (len < HEADERLEN) { + FSMDEBUG(("fsm_input(%x): Rcvd illegal length.", f->protocol)); + return; + } + if (len > l) { + FSMDEBUG(("fsm_input(%x): Rcvd short packet.", f->protocol)); + return; + } + len -= HEADERLEN; /* subtract header length */ + + if( f->state == PPP_FSM_INITIAL || f->state == PPP_FSM_STARTING ){ + FSMDEBUG(("fsm_input(%x): Rcvd packet in state %d.", + f->protocol, f->state)); + return; + } + + /* + * Action depends on code. + */ + switch (code) { + case CONFREQ: + fsm_rconfreq(f, id, inp, len); + break; + + case CONFACK: + fsm_rconfack(f, id, inp, len); + break; + + case CONFNAK: + case CONFREJ: + fsm_rconfnakrej(f, code, id, inp, len); + break; + + case TERMREQ: + fsm_rtermreq(f, id, inp, len); + break; + + case TERMACK: + fsm_rtermack(f); + break; + + case CODEREJ: + fsm_rcoderej(f, inp, len); + break; + + default: + if( !f->callbacks->extcode + || !(*f->callbacks->extcode)(f, code, id, inp, len) ) + fsm_sdata(f, CODEREJ, ++f->id, inpacket, len + HEADERLEN); + break; + } +} + + +/* + * fsm_rconfreq - Receive Configure-Request. + */ +static void fsm_rconfreq(fsm *f, u_char id, u_char *inp, int len) { + int code, reject_if_disagree; + + switch( f->state ){ + case PPP_FSM_CLOSED: + /* Go away, we're closed */ + fsm_sdata(f, TERMACK, id, NULL, 0); + return; + case PPP_FSM_CLOSING: + case PPP_FSM_STOPPING: + return; + + case PPP_FSM_OPENED: + /* Go down and restart negotiation */ + if( f->callbacks->down ) + (*f->callbacks->down)(f); /* Inform upper layers */ + fsm_sconfreq(f, 0); /* Send initial Configure-Request */ + f->state = PPP_FSM_REQSENT; + break; + + case PPP_FSM_STOPPED: + /* Negotiation started by our peer */ + fsm_sconfreq(f, 0); /* Send initial Configure-Request */ + f->state = PPP_FSM_REQSENT; + break; + default: + break; + } + + /* + * Pass the requested configuration options + * to protocol-specific code for checking. + */ + if (f->callbacks->reqci){ /* Check CI */ + reject_if_disagree = (f->nakloops >= f->maxnakloops); + code = (*f->callbacks->reqci)(f, inp, &len, reject_if_disagree); + } else if (len) + code = CONFREJ; /* Reject all CI */ + else + code = CONFACK; + + /* send the Ack, Nak or Rej to the peer */ + fsm_sdata(f, code, id, inp, len); + + if (code == CONFACK) { + if (f->state == PPP_FSM_ACKRCVD) { + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + f->state = PPP_FSM_OPENED; + if (f->callbacks->up) + (*f->callbacks->up)(f); /* Inform upper layers */ + } else + f->state = PPP_FSM_ACKSENT; + f->nakloops = 0; + + } else { + /* we sent CONFACK or CONFREJ */ + if (f->state != PPP_FSM_ACKRCVD) + f->state = PPP_FSM_REQSENT; + if( code == CONFNAK ) + ++f->nakloops; + } +} + + +/* + * fsm_rconfack - Receive Configure-Ack. + */ +static void fsm_rconfack(fsm *f, int id, u_char *inp, int len) { + ppp_pcb *pcb = f->pcb; + + if (id != f->reqid || f->seen_ack) /* Expected id? */ + return; /* Nope, toss... */ + if( !(f->callbacks->ackci? (*f->callbacks->ackci)(f, inp, len): + (len == 0)) ){ + /* Ack is bad - ignore it */ + ppp_error("Received bad configure-ack: %P", inp, len); + return; + } + f->seen_ack = 1; + f->rnakloops = 0; + + switch (f->state) { + case PPP_FSM_CLOSED: + case PPP_FSM_STOPPED: + fsm_sdata(f, TERMACK, id, NULL, 0); + break; + + case PPP_FSM_REQSENT: + f->state = PPP_FSM_ACKRCVD; + f->retransmits = pcb->settings.fsm_max_conf_req_transmits; + break; + + case PPP_FSM_ACKRCVD: + /* Huh? an extra valid Ack? oh well... */ + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + fsm_sconfreq(f, 0); + f->state = PPP_FSM_REQSENT; + break; + + case PPP_FSM_ACKSENT: + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + f->state = PPP_FSM_OPENED; + f->retransmits = pcb->settings.fsm_max_conf_req_transmits; + if (f->callbacks->up) + (*f->callbacks->up)(f); /* Inform upper layers */ + break; + + case PPP_FSM_OPENED: + /* Go down and restart negotiation */ + if (f->callbacks->down) + (*f->callbacks->down)(f); /* Inform upper layers */ + fsm_sconfreq(f, 0); /* Send initial Configure-Request */ + f->state = PPP_FSM_REQSENT; + break; + default: + break; + } +} + + +/* + * fsm_rconfnakrej - Receive Configure-Nak or Configure-Reject. + */ +static void fsm_rconfnakrej(fsm *f, int code, int id, u_char *inp, int len) { + int ret; + int treat_as_reject; + + if (id != f->reqid || f->seen_ack) /* Expected id? */ + return; /* Nope, toss... */ + + if (code == CONFNAK) { + ++f->rnakloops; + treat_as_reject = (f->rnakloops >= f->maxnakloops); + if (f->callbacks->nakci == NULL + || !(ret = f->callbacks->nakci(f, inp, len, treat_as_reject))) { + ppp_error("Received bad configure-nak: %P", inp, len); + return; + } + } else { + f->rnakloops = 0; + if (f->callbacks->rejci == NULL + || !(ret = f->callbacks->rejci(f, inp, len))) { + ppp_error("Received bad configure-rej: %P", inp, len); + return; + } + } + + f->seen_ack = 1; + + switch (f->state) { + case PPP_FSM_CLOSED: + case PPP_FSM_STOPPED: + fsm_sdata(f, TERMACK, id, NULL, 0); + break; + + case PPP_FSM_REQSENT: + case PPP_FSM_ACKSENT: + /* They didn't agree to what we wanted - try another request */ + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + if (ret < 0) + f->state = PPP_FSM_STOPPED; /* kludge for stopping CCP */ + else + fsm_sconfreq(f, 0); /* Send Configure-Request */ + break; + + case PPP_FSM_ACKRCVD: + /* Got a Nak/reject when we had already had an Ack?? oh well... */ + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + fsm_sconfreq(f, 0); + f->state = PPP_FSM_REQSENT; + break; + + case PPP_FSM_OPENED: + /* Go down and restart negotiation */ + if (f->callbacks->down) + (*f->callbacks->down)(f); /* Inform upper layers */ + fsm_sconfreq(f, 0); /* Send initial Configure-Request */ + f->state = PPP_FSM_REQSENT; + break; + default: + break; + } +} + + +/* + * fsm_rtermreq - Receive Terminate-Req. + */ +static void fsm_rtermreq(fsm *f, int id, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + + switch (f->state) { + case PPP_FSM_ACKRCVD: + case PPP_FSM_ACKSENT: + f->state = PPP_FSM_REQSENT; /* Start over but keep trying */ + break; + + case PPP_FSM_OPENED: + if (len > 0) { + ppp_info("%s terminated by peer (%0.*v)", PROTO_NAME(f), len, p); + } else + ppp_info("%s terminated by peer", PROTO_NAME(f)); + f->retransmits = 0; + f->state = PPP_FSM_STOPPING; + if (f->callbacks->down) + (*f->callbacks->down)(f); /* Inform upper layers */ + TIMEOUT(fsm_timeout, f, pcb->settings.fsm_timeout_time); + break; + default: + break; + } + + fsm_sdata(f, TERMACK, id, NULL, 0); +} + + +/* + * fsm_rtermack - Receive Terminate-Ack. + */ +static void fsm_rtermack(fsm *f) { + switch (f->state) { + case PPP_FSM_CLOSING: + UNTIMEOUT(fsm_timeout, f); + f->state = PPP_FSM_CLOSED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + break; + case PPP_FSM_STOPPING: + UNTIMEOUT(fsm_timeout, f); + f->state = PPP_FSM_STOPPED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + break; + + case PPP_FSM_ACKRCVD: + f->state = PPP_FSM_REQSENT; + break; + + case PPP_FSM_OPENED: + if (f->callbacks->down) + (*f->callbacks->down)(f); /* Inform upper layers */ + fsm_sconfreq(f, 0); + f->state = PPP_FSM_REQSENT; + break; + default: + break; + } +} + + +/* + * fsm_rcoderej - Receive an Code-Reject. + */ +static void fsm_rcoderej(fsm *f, u_char *inp, int len) { + u_char code, id; + + if (len < HEADERLEN) { + FSMDEBUG(("fsm_rcoderej: Rcvd short Code-Reject packet!")); + return; + } + GETCHAR(code, inp); + GETCHAR(id, inp); + ppp_warn("%s: Rcvd Code-Reject for code %d, id %d", PROTO_NAME(f), code, id); + + if( f->state == PPP_FSM_ACKRCVD ) + f->state = PPP_FSM_REQSENT; +} + + +/* + * fsm_protreject - Peer doesn't speak this protocol. + * + * Treat this as a catastrophic error (RXJ-). + */ +void fsm_protreject(fsm *f) { + switch( f->state ){ + case PPP_FSM_CLOSING: + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + /* fall through */ + /* no break */ + case PPP_FSM_CLOSED: + f->state = PPP_FSM_CLOSED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + break; + + case PPP_FSM_STOPPING: + case PPP_FSM_REQSENT: + case PPP_FSM_ACKRCVD: + case PPP_FSM_ACKSENT: + UNTIMEOUT(fsm_timeout, f); /* Cancel timeout */ + /* fall through */ + /* no break */ + case PPP_FSM_STOPPED: + f->state = PPP_FSM_STOPPED; + if( f->callbacks->finished ) + (*f->callbacks->finished)(f); + break; + + case PPP_FSM_OPENED: + terminate_layer(f, PPP_FSM_STOPPING); + break; + + default: + FSMDEBUG(("%s: Protocol-reject event in state %d!", + PROTO_NAME(f), f->state)); + /* no break */ + } +} + + +/* + * fsm_sconfreq - Send a Configure-Request. + */ +static void fsm_sconfreq(fsm *f, int retransmit) { + ppp_pcb *pcb = f->pcb; + struct pbuf *p; + u_char *outp; + int cilen; + + if( f->state != PPP_FSM_REQSENT && f->state != PPP_FSM_ACKRCVD && f->state != PPP_FSM_ACKSENT ){ + /* Not currently negotiating - reset options */ + if( f->callbacks->resetci ) + (*f->callbacks->resetci)(f); + f->nakloops = 0; + f->rnakloops = 0; + } + + if( !retransmit ){ + /* New request - reset retransmission counter, use new ID */ + f->retransmits = pcb->settings.fsm_max_conf_req_transmits; + f->reqid = ++f->id; + } + + f->seen_ack = 0; + + /* + * Make up the request packet + */ + if( f->callbacks->cilen && f->callbacks->addci ){ + cilen = (*f->callbacks->cilen)(f); + if( cilen > pcb->peer_mru - HEADERLEN ) + cilen = pcb->peer_mru - HEADERLEN; + } else + cilen = 0; + + p = pbuf_alloc(PBUF_RAW, (u16_t)(cilen + HEADERLEN + PPP_HDRLEN), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + /* send the request to our peer */ + outp = (u_char*)p->payload; + MAKEHEADER(outp, f->protocol); + PUTCHAR(CONFREQ, outp); + PUTCHAR(f->reqid, outp); + PUTSHORT(cilen + HEADERLEN, outp); + if (cilen != 0) { + (*f->callbacks->addci)(f, outp, &cilen); + LWIP_ASSERT("cilen == p->len - HEADERLEN - PPP_HDRLEN", cilen == p->len - HEADERLEN - PPP_HDRLEN); + } + + ppp_write(pcb, p); + + /* start the retransmit timer */ + --f->retransmits; + TIMEOUT(fsm_timeout, f, pcb->settings.fsm_timeout_time); +} + + +/* + * fsm_sdata - Send some data. + * + * Used for all packets sent to our peer by this module. + */ +void fsm_sdata(fsm *f, u_char code, u_char id, const u_char *data, int datalen) { + ppp_pcb *pcb = f->pcb; + struct pbuf *p; + u_char *outp; + int outlen; + + /* Adjust length to be smaller than MTU */ + if (datalen > pcb->peer_mru - HEADERLEN) + datalen = pcb->peer_mru - HEADERLEN; + outlen = datalen + HEADERLEN; + + p = pbuf_alloc(PBUF_RAW, (u16_t)(outlen + PPP_HDRLEN), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + if (datalen) /* && data != outp + PPP_HDRLEN + HEADERLEN) -- was only for fsm_sconfreq() */ + MEMCPY(outp + PPP_HDRLEN + HEADERLEN, data, datalen); + MAKEHEADER(outp, f->protocol); + PUTCHAR(code, outp); + PUTCHAR(id, outp); + PUTSHORT(outlen, outp); + ppp_write(pcb, p); +} + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/netif/ppp/ipcp.c b/components/lwip/netif/ppp/ipcp.c new file mode 100755 index 000000000..5dc65f6f5 --- /dev/null +++ b/components/lwip/netif/ppp/ipcp.c @@ -0,0 +1,2408 @@ +/* + * ipcp.c - PPP IP Control Protocol. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV4_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +/* + * TODO: + */ + +#if 0 /* UNUSED */ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/ipcp.h" + +#if 0 /* UNUSED */ +/* global vars */ +u32_t netmask = 0; /* IP netmask to set on interface */ +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +bool disable_defaultip = 0; /* Don't use hostname for default IP adrs */ +#endif /* UNUSED */ + +#if 0 /* moved to ppp_settings */ +bool noremoteip = 0; /* Let him have no IP address */ +#endif /* moved to ppp_setting */ + +#if 0 /* UNUSED */ +/* Hook for a plugin to know when IP protocol has come up */ +void (*ip_up_hook) (void) = NULL; + +/* Hook for a plugin to know when IP protocol has come down */ +void (*ip_down_hook) (void) = NULL; + +/* Hook for a plugin to choose the remote IP address */ +void (*ip_choose_hook) (u32_t *) = NULL; +#endif /* UNUSED */ + +#if PPP_NOTIFY +/* Notifiers for when IPCP goes up and down */ +struct notifier *ip_up_notifier = NULL; +struct notifier *ip_down_notifier = NULL; +#endif /* PPP_NOTIFY */ + +/* local vars */ +#if 0 /* moved to ppp_pcb */ +static int default_route_set[NUM_PPP]; /* Have set up a default route */ +static int proxy_arp_set[NUM_PPP]; /* Have created proxy arp entry */ +static int ipcp_is_up; /* have called np_up() */ +static int ipcp_is_open; /* haven't called np_finished() */ +static bool ask_for_local; /* request our address from peer */ +#endif /* moved to ppp_pcb */ +#if 0 /* UNUSED */ +static char vj_value[8]; /* string form of vj option value */ +static char netmask_str[20]; /* string form of netmask value */ +#endif /* UNUSED */ + +/* + * Callbacks for fsm code. (CI = Configuration Information) + */ +static void ipcp_resetci(fsm *f); /* Reset our CI */ +static int ipcp_cilen(fsm *f); /* Return length of our CI */ +static void ipcp_addci(fsm *f, u_char *ucp, int *lenp); /* Add our CI */ +static int ipcp_ackci(fsm *f, u_char *p, int len); /* Peer ack'd our CI */ +static int ipcp_nakci(fsm *f, u_char *p, int len, int treat_as_reject);/* Peer nak'd our CI */ +static int ipcp_rejci(fsm *f, u_char *p, int len); /* Peer rej'd our CI */ +static int ipcp_reqci(fsm *f, u_char *inp, int *len, int reject_if_disagree); /* Rcv CI */ +static void ipcp_up(fsm *f); /* We're UP */ +static void ipcp_down(fsm *f); /* We're DOWN */ +static void ipcp_finished(fsm *f); /* Don't need lower layer */ + +static const fsm_callbacks ipcp_callbacks = { /* IPCP callback routines */ + ipcp_resetci, /* Reset our Configuration Information */ + ipcp_cilen, /* Length of our Configuration Information */ + ipcp_addci, /* Add our Configuration Information */ + ipcp_ackci, /* ACK our Configuration Information */ + ipcp_nakci, /* NAK our Configuration Information */ + ipcp_rejci, /* Reject our Configuration Information */ + ipcp_reqci, /* Request peer's Configuration Information */ + ipcp_up, /* Called when fsm reaches OPENED state */ + ipcp_down, /* Called when fsm leaves OPENED state */ + NULL, /* Called when we want the lower layer up */ + ipcp_finished, /* Called when we want the lower layer down */ + NULL, /* Called when Protocol-Reject received */ + NULL, /* Retransmission is necessary */ + NULL, /* Called to handle protocol-specific codes */ + "IPCP" /* String name of protocol */ +}; + +/* + * Command-line options. + */ +#if PPP_OPTIONS +static int setvjslots (char **); +static int setdnsaddr (char **); +static int setwinsaddr (char **); +static int setnetmask (char **); +int setipaddr (char *, char **, int); + +static void printipaddr (option_t *, void (*)(void *, char *,...),void *); + +static option_t ipcp_option_list[] = { + { "noip", o_bool, &ipcp_protent.enabled_flag, + "Disable IP and IPCP" }, + { "-ip", o_bool, &ipcp_protent.enabled_flag, + "Disable IP and IPCP", OPT_ALIAS }, + + { "novj", o_bool, &ipcp_wantoptions[0].neg_vj, + "Disable VJ compression", OPT_A2CLR, &ipcp_allowoptions[0].neg_vj }, + { "-vj", o_bool, &ipcp_wantoptions[0].neg_vj, + "Disable VJ compression", OPT_ALIAS | OPT_A2CLR, + &ipcp_allowoptions[0].neg_vj }, + + { "novjccomp", o_bool, &ipcp_wantoptions[0].cflag, + "Disable VJ connection-ID compression", OPT_A2CLR, + &ipcp_allowoptions[0].cflag }, + { "-vjccomp", o_bool, &ipcp_wantoptions[0].cflag, + "Disable VJ connection-ID compression", OPT_ALIAS | OPT_A2CLR, + &ipcp_allowoptions[0].cflag }, + + { "vj-max-slots", o_special, (void *)setvjslots, + "Set maximum VJ header slots", + OPT_PRIO | OPT_A2STRVAL | OPT_STATIC, vj_value }, + + { "ipcp-accept-local", o_bool, &ipcp_wantoptions[0].accept_local, + "Accept peer's address for us", 1 }, + { "ipcp-accept-remote", o_bool, &ipcp_wantoptions[0].accept_remote, + "Accept peer's address for it", 1 }, + + { "ipparam", o_string, &ipparam, + "Set ip script parameter", OPT_PRIO }, + + { "noipdefault", o_bool, &disable_defaultip, + "Don't use name for default IP adrs", 1 }, + + { "ms-dns", 1, (void *)setdnsaddr, + "DNS address for the peer's use" }, + { "ms-wins", 1, (void *)setwinsaddr, + "Nameserver for SMB over TCP/IP for peer" }, + + { "ipcp-restart", o_int, &ipcp_fsm[0].timeouttime, + "Set timeout for IPCP", OPT_PRIO }, + { "ipcp-max-terminate", o_int, &ipcp_fsm[0].maxtermtransmits, + "Set max #xmits for term-reqs", OPT_PRIO }, + { "ipcp-max-configure", o_int, &ipcp_fsm[0].maxconfreqtransmits, + "Set max #xmits for conf-reqs", OPT_PRIO }, + { "ipcp-max-failure", o_int, &ipcp_fsm[0].maxnakloops, + "Set max #conf-naks for IPCP", OPT_PRIO }, + + { "defaultroute", o_bool, &ipcp_wantoptions[0].default_route, + "Add default route", OPT_ENABLE|1, &ipcp_allowoptions[0].default_route }, + { "nodefaultroute", o_bool, &ipcp_allowoptions[0].default_route, + "disable defaultroute option", OPT_A2CLR, + &ipcp_wantoptions[0].default_route }, + { "-defaultroute", o_bool, &ipcp_allowoptions[0].default_route, + "disable defaultroute option", OPT_ALIAS | OPT_A2CLR, + &ipcp_wantoptions[0].default_route }, + + { "replacedefaultroute", o_bool, + &ipcp_wantoptions[0].replace_default_route, + "Replace default route", 1 + }, + { "noreplacedefaultroute", o_bool, + &ipcp_allowoptions[0].replace_default_route, + "Never replace default route", OPT_A2COPY, + &ipcp_wantoptions[0].replace_default_route }, + { "proxyarp", o_bool, &ipcp_wantoptions[0].proxy_arp, + "Add proxy ARP entry", OPT_ENABLE|1, &ipcp_allowoptions[0].proxy_arp }, + { "noproxyarp", o_bool, &ipcp_allowoptions[0].proxy_arp, + "disable proxyarp option", OPT_A2CLR, + &ipcp_wantoptions[0].proxy_arp }, + { "-proxyarp", o_bool, &ipcp_allowoptions[0].proxy_arp, + "disable proxyarp option", OPT_ALIAS | OPT_A2CLR, + &ipcp_wantoptions[0].proxy_arp }, + + { "usepeerdns", o_bool, &usepeerdns, + "Ask peer for DNS address(es)", 1 }, + + { "netmask", o_special, (void *)setnetmask, + "set netmask", OPT_PRIO | OPT_A2STRVAL | OPT_STATIC, netmask_str }, + + { "ipcp-no-addresses", o_bool, &ipcp_wantoptions[0].old_addrs, + "Disable old-style IP-Addresses usage", OPT_A2CLR, + &ipcp_allowoptions[0].old_addrs }, + { "ipcp-no-address", o_bool, &ipcp_wantoptions[0].neg_addr, + "Disable IP-Address usage", OPT_A2CLR, + &ipcp_allowoptions[0].neg_addr }, + + { "noremoteip", o_bool, &noremoteip, + "Allow peer to have no IP address", 1 }, + + { "nosendip", o_bool, &ipcp_wantoptions[0].neg_addr, + "Don't send our IP address to peer", OPT_A2CLR, + &ipcp_wantoptions[0].old_addrs}, + + { "IP addresses", o_wild, (void *) &setipaddr, + "set local and remote IP addresses", + OPT_NOARG | OPT_A2PRINTER, (void *) &printipaddr }, + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points from main code. + */ +static void ipcp_init(ppp_pcb *pcb); +static void ipcp_open(ppp_pcb *pcb); +static void ipcp_close(ppp_pcb *pcb, const char *reason); +static void ipcp_lowerup(ppp_pcb *pcb); +static void ipcp_lowerdown(ppp_pcb *pcb); +static void ipcp_input(ppp_pcb *pcb, u_char *p, int len); +static void ipcp_protrej(ppp_pcb *pcb); +#if PRINTPKT_SUPPORT +static int ipcp_printpkt(const u_char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS +static void ip_check_options (void); +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT +static int ip_demand_conf (int); +static int ip_active_pkt (u_char *, int); +#endif /* DEMAND_SUPPORT */ +#if 0 /* UNUSED */ +static void create_resolv (u32_t, u32_t); +#endif /* UNUSED */ + +const struct protent ipcp_protent = { + PPP_IPCP, + ipcp_init, + ipcp_input, + ipcp_protrej, + ipcp_lowerup, + ipcp_lowerdown, + ipcp_open, + ipcp_close, +#if PRINTPKT_SUPPORT + ipcp_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "IPCP", + "IP", +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + ipcp_option_list, + ip_check_options, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + ip_demand_conf, + ip_active_pkt +#endif /* DEMAND_SUPPORT */ +}; + +static void ipcp_clear_addrs(ppp_pcb *pcb, u32_t ouraddr, u32_t hisaddr, u8_t replacedefaultroute); + +/* + * Lengths of configuration options. + */ +#define CILEN_VOID 2 +#define CILEN_COMPRESS 4 /* min length for compression protocol opt. */ +#define CILEN_VJ 6 /* length for RFC1332 Van-Jacobson opt. */ +#define CILEN_ADDR 6 /* new-style single address option */ +#define CILEN_ADDRS 10 /* old-style dual address option */ + + +#define CODENAME(x) ((x) == CONFACK ? "ACK" : \ + (x) == CONFNAK ? "NAK" : "REJ") + +#if 0 /* UNUSED, already defined by lwIP */ +/* + * Make a string representation of a network IP address. + */ +char * +ip_ntoa(ipaddr) +u32_t ipaddr; +{ + static char b[64]; + + slprintf(b, sizeof(b), "%I", ipaddr); + return b; +} +#endif /* UNUSED, already defined by lwIP */ + +/* + * Option parsing. + */ +#if PPP_OPTIONS +/* + * setvjslots - set maximum number of connection slots for VJ compression + */ +static int +setvjslots(argv) + char **argv; +{ + int value; + +/* FIXME: found what int_option() did */ +#if PPP_OPTIONS + if (!int_option(*argv, &value)) + return 0; +#endif /* PPP_OPTIONS */ + + if (value < 2 || value > 16) { + option_error("vj-max-slots value must be between 2 and 16"); + return 0; + } + ipcp_wantoptions [0].maxslotindex = + ipcp_allowoptions[0].maxslotindex = value - 1; + slprintf(vj_value, sizeof(vj_value), "%d", value); + return 1; +} + +/* + * setdnsaddr - set the dns address(es) + */ +static int +setdnsaddr(argv) + char **argv; +{ + u32_t dns; + struct hostent *hp; + + dns = inet_addr(*argv); + if (dns == (u32_t) -1) { + if ((hp = gethostbyname(*argv)) == NULL) { + option_error("invalid address parameter '%s' for ms-dns option", + *argv); + return 0; + } + dns = *(u32_t *)hp->h_addr; + } + + /* We take the last 2 values given, the 2nd-last as the primary + and the last as the secondary. If only one is given it + becomes both primary and secondary. */ + if (ipcp_allowoptions[0].dnsaddr[1] == 0) + ipcp_allowoptions[0].dnsaddr[0] = dns; + else + ipcp_allowoptions[0].dnsaddr[0] = ipcp_allowoptions[0].dnsaddr[1]; + + /* always set the secondary address value. */ + ipcp_allowoptions[0].dnsaddr[1] = dns; + + return (1); +} + +/* + * setwinsaddr - set the wins address(es) + * This is primrarly used with the Samba package under UNIX or for pointing + * the caller to the existing WINS server on a Windows NT platform. + */ +static int +setwinsaddr(argv) + char **argv; +{ + u32_t wins; + struct hostent *hp; + + wins = inet_addr(*argv); + if (wins == (u32_t) -1) { + if ((hp = gethostbyname(*argv)) == NULL) { + option_error("invalid address parameter '%s' for ms-wins option", + *argv); + return 0; + } + wins = *(u32_t *)hp->h_addr; + } + + /* We take the last 2 values given, the 2nd-last as the primary + and the last as the secondary. If only one is given it + becomes both primary and secondary. */ + if (ipcp_allowoptions[0].winsaddr[1] == 0) + ipcp_allowoptions[0].winsaddr[0] = wins; + else + ipcp_allowoptions[0].winsaddr[0] = ipcp_allowoptions[0].winsaddr[1]; + + /* always set the secondary address value. */ + ipcp_allowoptions[0].winsaddr[1] = wins; + + return (1); +} + +/* + * setipaddr - Set the IP address + * If doit is 0, the call is to check whether this option is + * potentially an IP address specification. + * Not static so that plugins can call it to set the addresses + */ +int +setipaddr(arg, argv, doit) + char *arg; + char **argv; + int doit; +{ + struct hostent *hp; + char *colon; + u32_t local, remote; + ipcp_options *wo = &ipcp_wantoptions[0]; + static int prio_local = 0, prio_remote = 0; + + /* + * IP address pair separated by ":". + */ + if ((colon = strchr(arg, ':')) == NULL) + return 0; + if (!doit) + return 1; + + /* + * If colon first character, then no local addr. + */ + if (colon != arg && option_priority >= prio_local) { + *colon = '\0'; + if ((local = inet_addr(arg)) == (u32_t) -1) { + if ((hp = gethostbyname(arg)) == NULL) { + option_error("unknown host: %s", arg); + return 0; + } + local = *(u32_t *)hp->h_addr; + } + if (bad_ip_adrs(local)) { + option_error("bad local IP address %s", ip_ntoa(local)); + return 0; + } + if (local != 0) + wo->ouraddr = local; + *colon = ':'; + prio_local = option_priority; + } + + /* + * If colon last character, then no remote addr. + */ + if (*++colon != '\0' && option_priority >= prio_remote) { + if ((remote = inet_addr(colon)) == (u32_t) -1) { + if ((hp = gethostbyname(colon)) == NULL) { + option_error("unknown host: %s", colon); + return 0; + } + remote = *(u32_t *)hp->h_addr; + if (remote_name[0] == 0) + strlcpy(remote_name, colon, sizeof(remote_name)); + } + if (bad_ip_adrs(remote)) { + option_error("bad remote IP address %s", ip_ntoa(remote)); + return 0; + } + if (remote != 0) + wo->hisaddr = remote; + prio_remote = option_priority; + } + + return 1; +} + +static void +printipaddr(opt, printer, arg) + option_t *opt; + void (*printer) (void *, char *, ...); + void *arg; +{ + ipcp_options *wo = &ipcp_wantoptions[0]; + + if (wo->ouraddr != 0) + printer(arg, "%I", wo->ouraddr); + printer(arg, ":"); + if (wo->hisaddr != 0) + printer(arg, "%I", wo->hisaddr); +} + +/* + * setnetmask - set the netmask to be used on the interface. + */ +static int +setnetmask(argv) + char **argv; +{ + u32_t mask; + int n; + char *p; + + /* + * Unfortunately, if we use inet_addr, we can't tell whether + * a result of all 1s is an error or a valid 255.255.255.255. + */ + p = *argv; + n = parse_dotted_ip(p, &mask); + + mask = htonl(mask); + + if (n == 0 || p[n] != 0 || (netmask & ~mask) != 0) { + option_error("invalid netmask value '%s'", *argv); + return 0; + } + + netmask = mask; + slprintf(netmask_str, sizeof(netmask_str), "%I", mask); + + return (1); +} + +int +parse_dotted_ip(p, vp) + char *p; + u32_t *vp; +{ + int n; + u32_t v, b; + char *endp, *p0 = p; + + v = 0; + for (n = 3;; --n) { + b = strtoul(p, &endp, 0); + if (endp == p) + return 0; + if (b > 255) { + if (n < 3) + return 0; + /* accept e.g. 0xffffff00 */ + *vp = b; + return endp - p0; + } + v |= b << (n * 8); + p = endp; + if (n == 0) + break; + if (*p != '.') + return 0; + ++p; + } + *vp = v; + return p - p0; +} +#endif /* PPP_OPTIONS */ + +/* + * ipcp_init - Initialize IPCP. + */ +static void ipcp_init(ppp_pcb *pcb) { + fsm *f = &pcb->ipcp_fsm; + + ipcp_options *wo = &pcb->ipcp_wantoptions; + ipcp_options *ao = &pcb->ipcp_allowoptions; + + f->pcb = pcb; + f->protocol = PPP_IPCP; + f->callbacks = &ipcp_callbacks; + fsm_init(f); + + /* + * Some 3G modems use repeated IPCP NAKs as a way of stalling + * until they can contact a server on the network, so we increase + * the default number of NAKs we accept before we start treating + * them as rejects. + */ + f->maxnakloops = 100; + +#if 0 /* Not necessary, everything is cleared in ppp_clear() */ + memset(wo, 0, sizeof(*wo)); + memset(ao, 0, sizeof(*ao)); +#endif /* 0 */ + + wo->neg_addr = wo->old_addrs = 1; +#if VJ_SUPPORT + wo->neg_vj = 1; + wo->vj_protocol = IPCP_VJ_COMP; + wo->maxslotindex = MAX_STATES - 1; /* really max index */ + wo->cflag = 1; +#endif /* VJ_SUPPORT */ + +#if 0 /* UNUSED */ + /* wanting default route by default */ + wo->default_route = 1; +#endif /* UNUSED */ + + ao->neg_addr = ao->old_addrs = 1; +#if VJ_SUPPORT + /* max slots and slot-id compression are currently hardwired in */ + /* ppp_if.c to 16 and 1, this needs to be changed (among other */ + /* things) gmc */ + + ao->neg_vj = 1; + ao->maxslotindex = MAX_STATES - 1; + ao->cflag = 1; +#endif /* #if VJ_SUPPORT */ + +#if 0 /* UNUSED */ + /* + * XXX These control whether the user may use the proxyarp + * and defaultroute options. + */ + ao->proxy_arp = 1; + ao->default_route = 1; +#endif /* UNUSED */ +} + + +/* + * ipcp_open - IPCP is allowed to come up. + */ +static void ipcp_open(ppp_pcb *pcb) { + fsm *f = &pcb->ipcp_fsm; + fsm_open(f); + pcb->ipcp_is_open = 1; +} + + +/* + * ipcp_close - Take IPCP down. + */ +static void ipcp_close(ppp_pcb *pcb, const char *reason) { + fsm *f = &pcb->ipcp_fsm; + fsm_close(f, reason); +} + + +/* + * ipcp_lowerup - The lower layer is up. + */ +static void ipcp_lowerup(ppp_pcb *pcb) { + fsm *f = &pcb->ipcp_fsm; + fsm_lowerup(f); +} + + +/* + * ipcp_lowerdown - The lower layer is down. + */ +static void ipcp_lowerdown(ppp_pcb *pcb) { + fsm *f = &pcb->ipcp_fsm; + fsm_lowerdown(f); +} + + +/* + * ipcp_input - Input IPCP packet. + */ +static void ipcp_input(ppp_pcb *pcb, u_char *p, int len) { + fsm *f = &pcb->ipcp_fsm; + fsm_input(f, p, len); +} + + +/* + * ipcp_protrej - A Protocol-Reject was received for IPCP. + * + * Pretend the lower layer went down, so we shut up. + */ +static void ipcp_protrej(ppp_pcb *pcb) { + fsm *f = &pcb->ipcp_fsm; + fsm_lowerdown(f); +} + + +/* + * ipcp_resetci - Reset our CI. + * Called by fsm_sconfreq, Send Configure Request. + */ +static void ipcp_resetci(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipcp_options *wo = &pcb->ipcp_wantoptions; + ipcp_options *go = &pcb->ipcp_gotoptions; + ipcp_options *ao = &pcb->ipcp_allowoptions; + + wo->req_addr = (wo->neg_addr || wo->old_addrs) && + (ao->neg_addr || ao->old_addrs); + if (wo->ouraddr == 0) + wo->accept_local = 1; + if (wo->hisaddr == 0) + wo->accept_remote = 1; +#if LWIP_DNS + wo->req_dns1 = wo->req_dns2 = pcb->settings.usepeerdns; /* Request DNS addresses from the peer */ +#endif /* LWIP_DNS */ + *go = *wo; +#if 0 /* UNUSED */ + /* We don't need ask_for_local, this is only useful for setup which + * can determine the local IP address from the system hostname. + */ + if (!ask_for_local) + go->ouraddr = 0; +#endif /* UNUSED */ +#if 0 /* UNUSED */ + if (ip_choose_hook) { + ip_choose_hook(&wo->hisaddr); + if (wo->hisaddr) { + wo->accept_remote = 0; + } + } +#endif /* UNUSED */ + BZERO(&pcb->ipcp_hisoptions, sizeof(ipcp_options)); +} + + +/* + * ipcp_cilen - Return length of our CI. + * Called by fsm_sconfreq, Send Configure Request. + */ +static int ipcp_cilen(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipcp_options *go = &pcb->ipcp_gotoptions; +#if VJ_SUPPORT + ipcp_options *wo = &pcb->ipcp_wantoptions; +#endif /* VJ_SUPPORT */ + ipcp_options *ho = &pcb->ipcp_hisoptions; + +#define LENCIADDRS(neg) (neg ? CILEN_ADDRS : 0) +#if VJ_SUPPORT +#define LENCIVJ(neg, old) (neg ? (old? CILEN_COMPRESS : CILEN_VJ) : 0) +#endif /* VJ_SUPPORT */ +#define LENCIADDR(neg) (neg ? CILEN_ADDR : 0) +#if LWIP_DNS +#define LENCIDNS(neg) LENCIADDR(neg) +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ +#define LENCIWINS(neg) LENCIADDR(neg) +#endif /* UNUSED - WINS */ + + /* + * First see if we want to change our options to the old + * forms because we have received old forms from the peer. + */ + if (go->neg_addr && go->old_addrs && !ho->neg_addr && ho->old_addrs) + go->neg_addr = 0; + +#if VJ_SUPPORT + if (wo->neg_vj && !go->neg_vj && !go->old_vj) { + /* try an older style of VJ negotiation */ + /* use the old style only if the peer did */ + if (ho->neg_vj && ho->old_vj) { + go->neg_vj = 1; + go->old_vj = 1; + go->vj_protocol = ho->vj_protocol; + } + } +#endif /* VJ_SUPPORT */ + + return (LENCIADDRS(!go->neg_addr && go->old_addrs) + +#if VJ_SUPPORT + LENCIVJ(go->neg_vj, go->old_vj) + +#endif /* VJ_SUPPORT */ + LENCIADDR(go->neg_addr) + +#if LWIP_DNS + LENCIDNS(go->req_dns1) + + LENCIDNS(go->req_dns2) + +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ + LENCIWINS(go->winsaddr[0]) + + LENCIWINS(go->winsaddr[1]) + +#endif /* UNUSED - WINS */ + 0); +} + + +/* + * ipcp_addci - Add our desired CIs to a packet. + * Called by fsm_sconfreq, Send Configure Request. + */ +static void ipcp_addci(fsm *f, u_char *ucp, int *lenp) { + ppp_pcb *pcb = f->pcb; + ipcp_options *go = &pcb->ipcp_gotoptions; + int len = *lenp; + +#define ADDCIADDRS(opt, neg, val1, val2) \ + if (neg) { \ + if (len >= CILEN_ADDRS) { \ + u32_t l; \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_ADDRS, ucp); \ + l = ntohl(val1); \ + PUTLONG(l, ucp); \ + l = ntohl(val2); \ + PUTLONG(l, ucp); \ + len -= CILEN_ADDRS; \ + } else \ + go->old_addrs = 0; \ + } + +#if VJ_SUPPORT +#define ADDCIVJ(opt, neg, val, old, maxslotindex, cflag) \ + if (neg) { \ + int vjlen = old? CILEN_COMPRESS : CILEN_VJ; \ + if (len >= vjlen) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(vjlen, ucp); \ + PUTSHORT(val, ucp); \ + if (!old) { \ + PUTCHAR(maxslotindex, ucp); \ + PUTCHAR(cflag, ucp); \ + } \ + len -= vjlen; \ + } else \ + neg = 0; \ + } +#endif /* VJ_SUPPORT */ + +#define ADDCIADDR(opt, neg, val) \ + if (neg) { \ + if (len >= CILEN_ADDR) { \ + u32_t l; \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_ADDR, ucp); \ + l = ntohl(val); \ + PUTLONG(l, ucp); \ + len -= CILEN_ADDR; \ + } else \ + neg = 0; \ + } + +#if LWIP_DNS +#define ADDCIDNS(opt, neg, addr) \ + if (neg) { \ + if (len >= CILEN_ADDR) { \ + u32_t l; \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_ADDR, ucp); \ + l = ntohl(addr); \ + PUTLONG(l, ucp); \ + len -= CILEN_ADDR; \ + } else \ + neg = 0; \ + } +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ +#define ADDCIWINS(opt, addr) \ + if (addr) { \ + if (len >= CILEN_ADDR) { \ + u32_t l; \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_ADDR, ucp); \ + l = ntohl(addr); \ + PUTLONG(l, ucp); \ + len -= CILEN_ADDR; \ + } else \ + addr = 0; \ + } +#endif /* UNUSED - WINS */ + + ADDCIADDRS(CI_ADDRS, !go->neg_addr && go->old_addrs, go->ouraddr, + go->hisaddr); + +#if VJ_SUPPORT + ADDCIVJ(CI_COMPRESSTYPE, go->neg_vj, go->vj_protocol, go->old_vj, + go->maxslotindex, go->cflag); +#endif /* VJ_SUPPORT */ + + ADDCIADDR(CI_ADDR, go->neg_addr, go->ouraddr); + +#if LWIP_DNS + ADDCIDNS(CI_MS_DNS1, go->req_dns1, go->dnsaddr[0]); + + ADDCIDNS(CI_MS_DNS2, go->req_dns2, go->dnsaddr[1]); +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ + ADDCIWINS(CI_MS_WINS1, go->winsaddr[0]); + + ADDCIWINS(CI_MS_WINS2, go->winsaddr[1]); +#endif /* UNUSED - WINS */ + + *lenp -= len; +} + + +/* + * ipcp_ackci - Ack our CIs. + * Called by fsm_rconfack, Receive Configure ACK. + * + * Returns: + * 0 - Ack was bad. + * 1 - Ack was good. + */ +static int ipcp_ackci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ipcp_options *go = &pcb->ipcp_gotoptions; + u_short cilen, citype; + u32_t cilong; +#if VJ_SUPPORT + u_short cishort; + u_char cimaxslotindex, cicflag; +#endif /* VJ_SUPPORT */ + + /* + * CIs must be in exactly the same order that we sent... + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ + +#define ACKCIADDRS(opt, neg, val1, val2) \ + if (neg) { \ + u32_t l; \ + if ((len -= CILEN_ADDRS) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_ADDRS || \ + citype != opt) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + if (val1 != cilong) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + if (val2 != cilong) \ + goto bad; \ + } + +#if VJ_SUPPORT +#define ACKCIVJ(opt, neg, val, old, maxslotindex, cflag) \ + if (neg) { \ + int vjlen = old? CILEN_COMPRESS : CILEN_VJ; \ + if ((len -= vjlen) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != vjlen || \ + citype != opt) \ + goto bad; \ + GETSHORT(cishort, p); \ + if (cishort != val) \ + goto bad; \ + if (!old) { \ + GETCHAR(cimaxslotindex, p); \ + if (cimaxslotindex != maxslotindex) \ + goto bad; \ + GETCHAR(cicflag, p); \ + if (cicflag != cflag) \ + goto bad; \ + } \ + } +#endif /* VJ_SUPPORT */ + +#define ACKCIADDR(opt, neg, val) \ + if (neg) { \ + u32_t l; \ + if ((len -= CILEN_ADDR) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_ADDR || \ + citype != opt) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + if (val != cilong) \ + goto bad; \ + } + +#if LWIP_DNS +#define ACKCIDNS(opt, neg, addr) \ + if (neg) { \ + u32_t l; \ + if ((len -= CILEN_ADDR) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_ADDR || citype != opt) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + if (addr != cilong) \ + goto bad; \ + } +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ +#define ACKCIWINS(opt, addr) \ + if (addr) { \ + u32_t l; \ + if ((len -= CILEN_ADDR) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_ADDR || citype != opt) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + if (addr != cilong) \ + goto bad; \ + } +#endif /* UNUSED - WINS */ + + ACKCIADDRS(CI_ADDRS, !go->neg_addr && go->old_addrs, go->ouraddr, + go->hisaddr); + +#if VJ_SUPPORT + ACKCIVJ(CI_COMPRESSTYPE, go->neg_vj, go->vj_protocol, go->old_vj, + go->maxslotindex, go->cflag); +#endif /* VJ_SUPPORT */ + + ACKCIADDR(CI_ADDR, go->neg_addr, go->ouraddr); + +#if LWIP_DNS + ACKCIDNS(CI_MS_DNS1, go->req_dns1, go->dnsaddr[0]); + + ACKCIDNS(CI_MS_DNS2, go->req_dns2, go->dnsaddr[1]); +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ + ACKCIWINS(CI_MS_WINS1, go->winsaddr[0]); + + ACKCIWINS(CI_MS_WINS2, go->winsaddr[1]); +#endif /* UNUSED - WINS */ + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + return (1); + +bad: + IPCPDEBUG(("ipcp_ackci: received bad Ack!")); + return (0); +} + +/* + * ipcp_nakci - Peer has sent a NAK for some of our CIs. + * This should not modify any state if the Nak is bad + * or if IPCP is in the OPENED state. + * Calback from fsm_rconfnakrej - Receive Configure-Nak or Configure-Reject. + * + * Returns: + * 0 - Nak was bad. + * 1 - Nak was good. + */ +static int ipcp_nakci(fsm *f, u_char *p, int len, int treat_as_reject) { + ppp_pcb *pcb = f->pcb; + ipcp_options *go = &pcb->ipcp_gotoptions; + u_char citype, cilen, *next; +#if VJ_SUPPORT + u_char cimaxslotindex, cicflag; + u_short cishort; +#endif /* VJ_SUPPORT */ + u32_t ciaddr1, ciaddr2, l; +#if LWIP_DNS + u32_t cidnsaddr; +#endif /* LWIP_DNS */ + ipcp_options no; /* options we've seen Naks for */ + ipcp_options try_; /* options to request next time */ + + BZERO(&no, sizeof(no)); + try_ = *go; + + /* + * Any Nak'd CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define NAKCIADDRS(opt, neg, code) \ + if ((neg) && \ + (cilen = p[1]) == CILEN_ADDRS && \ + len >= cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + ciaddr1 = htonl(l); \ + GETLONG(l, p); \ + ciaddr2 = htonl(l); \ + no.old_addrs = 1; \ + code \ + } + +#if VJ_SUPPORT +#define NAKCIVJ(opt, neg, code) \ + if (go->neg && \ + ((cilen = p[1]) == CILEN_COMPRESS || cilen == CILEN_VJ) && \ + len >= cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + no.neg = 1; \ + code \ + } +#endif /* VJ_SUPPORT */ + +#define NAKCIADDR(opt, neg, code) \ + if (go->neg && \ + (cilen = p[1]) == CILEN_ADDR && \ + len >= cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + ciaddr1 = htonl(l); \ + no.neg = 1; \ + code \ + } + +#if LWIP_DNS +#define NAKCIDNS(opt, neg, code) \ + if (go->neg && \ + ((cilen = p[1]) == CILEN_ADDR) && \ + len >= cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + cidnsaddr = htonl(l); \ + no.neg = 1; \ + code \ + } +#endif /* LWIP_DNS */ + + /* + * Accept the peer's idea of {our,his} address, if different + * from our idea, only if the accept_{local,remote} flag is set. + */ + NAKCIADDRS(CI_ADDRS, !go->neg_addr && go->old_addrs, + if (treat_as_reject) { + try_.old_addrs = 0; + } else { + if (go->accept_local && ciaddr1) { + /* take his idea of our address */ + try_.ouraddr = ciaddr1; + } + if (go->accept_remote && ciaddr2) { + /* take his idea of his address */ + try_.hisaddr = ciaddr2; + } + } + ); + +#if VJ_SUPPORT + /* + * Accept the peer's value of maxslotindex provided that it + * is less than what we asked for. Turn off slot-ID compression + * if the peer wants. Send old-style compress-type option if + * the peer wants. + */ + NAKCIVJ(CI_COMPRESSTYPE, neg_vj, + if (treat_as_reject) { + try_.neg_vj = 0; + } else if (cilen == CILEN_VJ) { + GETCHAR(cimaxslotindex, p); + GETCHAR(cicflag, p); + if (cishort == IPCP_VJ_COMP) { + try_.old_vj = 0; + if (cimaxslotindex < go->maxslotindex) + try_.maxslotindex = cimaxslotindex; + if (!cicflag) + try_.cflag = 0; + } else { + try_.neg_vj = 0; + } + } else { + if (cishort == IPCP_VJ_COMP || cishort == IPCP_VJ_COMP_OLD) { + try_.old_vj = 1; + try_.vj_protocol = cishort; + } else { + try_.neg_vj = 0; + } + } + ); +#endif /* VJ_SUPPORT */ + + NAKCIADDR(CI_ADDR, neg_addr, + if (treat_as_reject) { + try_.neg_addr = 0; + try_.old_addrs = 0; + } else if (go->accept_local && ciaddr1) { + /* take his idea of our address */ + try_.ouraddr = ciaddr1; + } + ); + +#if LWIP_DNS + NAKCIDNS(CI_MS_DNS1, req_dns1, + if (treat_as_reject) { + try_.req_dns1 = 0; + } else { + try_.dnsaddr[0] = cidnsaddr; + } + ); + + NAKCIDNS(CI_MS_DNS2, req_dns2, + if (treat_as_reject) { + try_.req_dns2 = 0; + } else { + try_.dnsaddr[1] = cidnsaddr; + } + ); +#endif /* #if LWIP_DNS */ + + /* + * There may be remaining CIs, if the peer is requesting negotiation + * on an option that we didn't include in our request packet. + * If they want to negotiate about IP addresses, we comply. + * If they want us to ask for compression, we refuse. + * If they want us to ask for ms-dns, we do that, since some + * peers get huffy if we don't. + */ + while (len >= CILEN_VOID) { + GETCHAR(citype, p); + GETCHAR(cilen, p); + if ( cilen < CILEN_VOID || (len -= cilen) < 0 ) + goto bad; + next = p + cilen - 2; + + switch (citype) { +#if VJ_SUPPORT + case CI_COMPRESSTYPE: + if (go->neg_vj || no.neg_vj || + (cilen != CILEN_VJ && cilen != CILEN_COMPRESS)) + goto bad; + no.neg_vj = 1; + break; +#endif /* VJ_SUPPORT */ + case CI_ADDRS: + if ((!go->neg_addr && go->old_addrs) || no.old_addrs + || cilen != CILEN_ADDRS) + goto bad; + try_.neg_addr = 0; + GETLONG(l, p); + ciaddr1 = htonl(l); + if (ciaddr1 && go->accept_local) + try_.ouraddr = ciaddr1; + GETLONG(l, p); + ciaddr2 = htonl(l); + if (ciaddr2 && go->accept_remote) + try_.hisaddr = ciaddr2; + no.old_addrs = 1; + break; + case CI_ADDR: + if (go->neg_addr || no.neg_addr || cilen != CILEN_ADDR) + goto bad; + try_.old_addrs = 0; + GETLONG(l, p); + ciaddr1 = htonl(l); + if (ciaddr1 && go->accept_local) + try_.ouraddr = ciaddr1; + if (try_.ouraddr != 0) + try_.neg_addr = 1; + no.neg_addr = 1; + break; +#if LWIP_DNS + case CI_MS_DNS1: + if (go->req_dns1 || no.req_dns1 || cilen != CILEN_ADDR) + goto bad; + GETLONG(l, p); + try_.dnsaddr[0] = htonl(l); + try_.req_dns1 = 1; + no.req_dns1 = 1; + break; + case CI_MS_DNS2: + if (go->req_dns2 || no.req_dns2 || cilen != CILEN_ADDR) + goto bad; + GETLONG(l, p); + try_.dnsaddr[1] = htonl(l); + try_.req_dns2 = 1; + no.req_dns2 = 1; + break; +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ + case CI_MS_WINS1: + case CI_MS_WINS2: + if (cilen != CILEN_ADDR) + goto bad; + GETLONG(l, p); + ciaddr1 = htonl(l); + if (ciaddr1) + try_.winsaddr[citype == CI_MS_WINS2] = ciaddr1; + break; +#endif /* UNUSED - WINS */ + default: + break; + } + p = next; + } + + /* + * OK, the Nak is good. Now we can update state. + * If there are any remaining options, we ignore them. + */ + if (f->state != PPP_FSM_OPENED) + *go = try_; + + return 1; + +bad: + IPCPDEBUG(("ipcp_nakci: received bad Nak!")); + return 0; +} + + +/* + * ipcp_rejci - Reject some of our CIs. + * Callback from fsm_rconfnakrej. + */ +static int ipcp_rejci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ipcp_options *go = &pcb->ipcp_gotoptions; + u_char cilen; +#if VJ_SUPPORT + u_char cimaxslotindex, ciflag; + u_short cishort; +#endif /* VJ_SUPPORT */ + u32_t cilong; + ipcp_options try_; /* options to request next time */ + + try_ = *go; + /* + * Any Rejected CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define REJCIADDRS(opt, neg, val1, val2) \ + if ((neg) && \ + (cilen = p[1]) == CILEN_ADDRS && \ + len >= cilen && \ + p[0] == opt) { \ + u32_t l; \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + cilong = htonl(l); \ + /* Check rejected value. */ \ + if (cilong != val1) \ + goto bad; \ + GETLONG(l, p); \ + cilong = htonl(l); \ + /* Check rejected value. */ \ + if (cilong != val2) \ + goto bad; \ + try_.old_addrs = 0; \ + } + +#if VJ_SUPPORT +#define REJCIVJ(opt, neg, val, old, maxslot, cflag) \ + if (go->neg && \ + p[1] == (old? CILEN_COMPRESS : CILEN_VJ) && \ + len >= p[1] && \ + p[0] == opt) { \ + len -= p[1]; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + /* Check rejected value. */ \ + if (cishort != val) \ + goto bad; \ + if (!old) { \ + GETCHAR(cimaxslotindex, p); \ + if (cimaxslotindex != maxslot) \ + goto bad; \ + GETCHAR(ciflag, p); \ + if (ciflag != cflag) \ + goto bad; \ + } \ + try_.neg = 0; \ + } +#endif /* VJ_SUPPORT */ + +#define REJCIADDR(opt, neg, val) \ + if (go->neg && \ + (cilen = p[1]) == CILEN_ADDR && \ + len >= cilen && \ + p[0] == opt) { \ + u32_t l; \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + cilong = htonl(l); \ + /* Check rejected value. */ \ + if (cilong != val) \ + goto bad; \ + try_.neg = 0; \ + } + +#if LWIP_DNS +#define REJCIDNS(opt, neg, dnsaddr) \ + if (go->neg && \ + ((cilen = p[1]) == CILEN_ADDR) && \ + len >= cilen && \ + p[0] == opt) { \ + u32_t l; \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + cilong = htonl(l); \ + /* Check rejected value. */ \ + if (cilong != dnsaddr) \ + goto bad; \ + try_.neg = 0; \ + } +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ +#define REJCIWINS(opt, addr) \ + if (addr && \ + ((cilen = p[1]) == CILEN_ADDR) && \ + len >= cilen && \ + p[0] == opt) { \ + u32_t l; \ + len -= cilen; \ + INCPTR(2, p); \ + GETLONG(l, p); \ + cilong = htonl(l); \ + /* Check rejected value. */ \ + if (cilong != addr) \ + goto bad; \ + try_.winsaddr[opt == CI_MS_WINS2] = 0; \ + } +#endif /* UNUSED - WINS */ + + REJCIADDRS(CI_ADDRS, !go->neg_addr && go->old_addrs, + go->ouraddr, go->hisaddr); + +#if VJ_SUPPORT + REJCIVJ(CI_COMPRESSTYPE, neg_vj, go->vj_protocol, go->old_vj, + go->maxslotindex, go->cflag); +#endif /* VJ_SUPPORT */ + + REJCIADDR(CI_ADDR, neg_addr, go->ouraddr); + +#if LWIP_DNS + REJCIDNS(CI_MS_DNS1, req_dns1, go->dnsaddr[0]); + + REJCIDNS(CI_MS_DNS2, req_dns2, go->dnsaddr[1]); +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ + REJCIWINS(CI_MS_WINS1, go->winsaddr[0]); + + REJCIWINS(CI_MS_WINS2, go->winsaddr[1]); +#endif /* UNUSED - WINS */ + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + /* + * Now we can update state. + */ + if (f->state != PPP_FSM_OPENED) + *go = try_; + return 1; + +bad: + IPCPDEBUG(("ipcp_rejci: received bad Reject!")); + return 0; +} + + +/* + * ipcp_reqci - Check the peer's requested CIs and send appropriate response. + * Callback from fsm_rconfreq, Receive Configure Request + * + * Returns: CONFACK, CONFNAK or CONFREJ and input packet modified + * appropriately. If reject_if_disagree is non-zero, doesn't return + * CONFNAK; returns CONFREJ if it can't return CONFACK. + * + * inp = Requested CIs + * len = Length of requested CIs + */ +static int ipcp_reqci(fsm *f, u_char *inp, int *len, int reject_if_disagree) { + ppp_pcb *pcb = f->pcb; + ipcp_options *wo = &pcb->ipcp_wantoptions; + ipcp_options *ho = &pcb->ipcp_hisoptions; + ipcp_options *ao = &pcb->ipcp_allowoptions; + u_char *cip, *next; /* Pointer to current and next CIs */ + u_short cilen, citype; /* Parsed len, type */ +#if VJ_SUPPORT + u_short cishort; /* Parsed short value */ +#endif /* VJ_SUPPORT */ + u32_t tl, ciaddr1, ciaddr2;/* Parsed address values */ + int rc = CONFACK; /* Final packet return code */ + int orc; /* Individual option return code */ + u_char *p; /* Pointer to next char to parse */ + u_char *ucp = inp; /* Pointer to current output char */ + int l = *len; /* Length left */ +#if VJ_SUPPORT + u_char maxslotindex, cflag; +#endif /* VJ_SUPPORT */ +#if LWIP_DNS + int d; +#endif /* LWIP_DNS */ + + /* + * Reset all his options. + */ + BZERO(ho, sizeof(*ho)); + + /* + * Process all his options. + */ + next = inp; + while (l) { + orc = CONFACK; /* Assume success */ + cip = p = next; /* Remember begining of CI */ + if (l < 2 || /* Not enough data for CI header or */ + p[1] < 2 || /* CI length too small or */ + p[1] > l) { /* CI length too big? */ + IPCPDEBUG(("ipcp_reqci: bad CI length!")); + orc = CONFREJ; /* Reject bad CI */ + cilen = l; /* Reject till end of packet */ + l = 0; /* Don't loop again */ + goto endswitch; + } + GETCHAR(citype, p); /* Parse CI type */ + GETCHAR(cilen, p); /* Parse CI length */ + l -= cilen; /* Adjust remaining length */ + next += cilen; /* Step to next CI */ + + switch (citype) { /* Check CI type */ + case CI_ADDRS: + if (!ao->old_addrs || ho->neg_addr || + cilen != CILEN_ADDRS) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + + /* + * If he has no address, or if we both have his address but + * disagree about it, then NAK it with our idea. + * In particular, if we don't know his address, but he does, + * then accept it. + */ + GETLONG(tl, p); /* Parse source address (his) */ + ciaddr1 = htonl(tl); + if (ciaddr1 != wo->hisaddr + && (ciaddr1 == 0 || !wo->accept_remote)) { + orc = CONFNAK; + if (!reject_if_disagree) { + DECPTR(sizeof(u32_t), p); + tl = ntohl(wo->hisaddr); + PUTLONG(tl, p); + } + } else if (ciaddr1 == 0 && wo->hisaddr == 0) { + /* + * If neither we nor he knows his address, reject the option. + */ + orc = CONFREJ; + wo->req_addr = 0; /* don't NAK with 0.0.0.0 later */ + break; + } + + /* + * If he doesn't know our address, or if we both have our address + * but disagree about it, then NAK it with our idea. + */ + GETLONG(tl, p); /* Parse desination address (ours) */ + ciaddr2 = htonl(tl); + if (ciaddr2 != wo->ouraddr) { + if (ciaddr2 == 0 || !wo->accept_local) { + orc = CONFNAK; + if (!reject_if_disagree) { + DECPTR(sizeof(u32_t), p); + tl = ntohl(wo->ouraddr); + PUTLONG(tl, p); + } + } else { + wo->ouraddr = ciaddr2; /* accept peer's idea */ + } + } + + ho->old_addrs = 1; + ho->hisaddr = ciaddr1; + ho->ouraddr = ciaddr2; + break; + + case CI_ADDR: + if (!ao->neg_addr || ho->old_addrs || + cilen != CILEN_ADDR) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + + /* + * If he has no address, or if we both have his address but + * disagree about it, then NAK it with our idea. + * In particular, if we don't know his address, but he does, + * then accept it. + */ + GETLONG(tl, p); /* Parse source address (his) */ + ciaddr1 = htonl(tl); + if (ciaddr1 != wo->hisaddr + && (ciaddr1 == 0 || !wo->accept_remote)) { + orc = CONFNAK; + if (!reject_if_disagree) { + DECPTR(sizeof(u32_t), p); + tl = ntohl(wo->hisaddr); + PUTLONG(tl, p); + } + } else if (ciaddr1 == 0 && wo->hisaddr == 0) { + /* + * Don't ACK an address of 0.0.0.0 - reject it instead. + */ + orc = CONFREJ; + wo->req_addr = 0; /* don't NAK with 0.0.0.0 later */ + break; + } + + ho->neg_addr = 1; + ho->hisaddr = ciaddr1; + break; + +#if LWIP_DNS + case CI_MS_DNS1: + case CI_MS_DNS2: + /* Microsoft primary or secondary DNS request */ + d = citype == CI_MS_DNS2; + + /* If we do not have a DNS address then we cannot send it */ + if (ao->dnsaddr[d] == 0 || + cilen != CILEN_ADDR) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + GETLONG(tl, p); + if (htonl(tl) != ao->dnsaddr[d]) { + DECPTR(sizeof(u32_t), p); + tl = ntohl(ao->dnsaddr[d]); + PUTLONG(tl, p); + orc = CONFNAK; + } + break; +#endif /* LWIP_DNS */ + +#if 0 /* UNUSED - WINS */ + case CI_MS_WINS1: + case CI_MS_WINS2: + /* Microsoft primary or secondary WINS request */ + d = citype == CI_MS_WINS2; + + /* If we do not have a DNS address then we cannot send it */ + if (ao->winsaddr[d] == 0 || + cilen != CILEN_ADDR) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + GETLONG(tl, p); + if (htonl(tl) != ao->winsaddr[d]) { + DECPTR(sizeof(u32_t), p); + tl = ntohl(ao->winsaddr[d]); + PUTLONG(tl, p); + orc = CONFNAK; + } + break; +#endif /* UNUSED - WINS */ + +#if VJ_SUPPORT + case CI_COMPRESSTYPE: + if (!ao->neg_vj || + (cilen != CILEN_VJ && cilen != CILEN_COMPRESS)) { + orc = CONFREJ; + break; + } + GETSHORT(cishort, p); + + if (!(cishort == IPCP_VJ_COMP || + (cishort == IPCP_VJ_COMP_OLD && cilen == CILEN_COMPRESS))) { + orc = CONFREJ; + break; + } + + ho->neg_vj = 1; + ho->vj_protocol = cishort; + if (cilen == CILEN_VJ) { + GETCHAR(maxslotindex, p); + if (maxslotindex > ao->maxslotindex) { + orc = CONFNAK; + if (!reject_if_disagree){ + DECPTR(1, p); + PUTCHAR(ao->maxslotindex, p); + } + } + GETCHAR(cflag, p); + if (cflag && !ao->cflag) { + orc = CONFNAK; + if (!reject_if_disagree){ + DECPTR(1, p); + PUTCHAR(wo->cflag, p); + } + } + ho->maxslotindex = maxslotindex; + ho->cflag = cflag; + } else { + ho->old_vj = 1; + ho->maxslotindex = MAX_STATES - 1; + ho->cflag = 1; + } + break; +#endif /* VJ_SUPPORT */ + + default: + orc = CONFREJ; + break; + } +endswitch: + if (orc == CONFACK && /* Good CI */ + rc != CONFACK) /* but prior CI wasnt? */ + continue; /* Don't send this one */ + + if (orc == CONFNAK) { /* Nak this CI? */ + if (reject_if_disagree) /* Getting fed up with sending NAKs? */ + orc = CONFREJ; /* Get tough if so */ + else { + if (rc == CONFREJ) /* Rejecting prior CI? */ + continue; /* Don't send this one */ + if (rc == CONFACK) { /* Ack'd all prior CIs? */ + rc = CONFNAK; /* Not anymore... */ + ucp = inp; /* Backup */ + } + } + } + + if (orc == CONFREJ && /* Reject this CI */ + rc != CONFREJ) { /* but no prior ones? */ + rc = CONFREJ; + ucp = inp; /* Backup */ + } + + /* Need to move CI? */ + if (ucp != cip) + MEMCPY(ucp, cip, cilen); /* Move it */ + + /* Update output pointer */ + INCPTR(cilen, ucp); + } + + /* + * If we aren't rejecting this packet, and we want to negotiate + * their address, and they didn't send their address, then we + * send a NAK with a CI_ADDR option appended. We assume the + * input buffer is long enough that we can append the extra + * option safely. + */ + if (rc != CONFREJ && !ho->neg_addr && !ho->old_addrs && + wo->req_addr && !reject_if_disagree && !pcb->settings.noremoteip) { + if (rc == CONFACK) { + rc = CONFNAK; + ucp = inp; /* reset pointer */ + wo->req_addr = 0; /* don't ask again */ + } + PUTCHAR(CI_ADDR, ucp); + PUTCHAR(CILEN_ADDR, ucp); + tl = ntohl(wo->hisaddr); + PUTLONG(tl, ucp); + } + + *len = ucp - inp; /* Compute output length */ + IPCPDEBUG(("ipcp: returning Configure-%s", CODENAME(rc))); + return (rc); /* Return final code */ +} + + +#if 0 /* UNUSED */ +/* + * ip_check_options - check that any IP-related options are OK, + * and assign appropriate defaults. + */ +static void +ip_check_options() +{ + struct hostent *hp; + u32_t local; + ipcp_options *wo = &ipcp_wantoptions[0]; + + /* + * Default our local IP address based on our hostname. + * If local IP address already given, don't bother. + */ + if (wo->ouraddr == 0 && !disable_defaultip) { + /* + * Look up our hostname (possibly with domain name appended) + * and take the first IP address as our local IP address. + * If there isn't an IP address for our hostname, too bad. + */ + wo->accept_local = 1; /* don't insist on this default value */ + if ((hp = gethostbyname(hostname)) != NULL) { + local = *(u32_t *)hp->h_addr; + if (local != 0 && !bad_ip_adrs(local)) + wo->ouraddr = local; + } + } + ask_for_local = wo->ouraddr != 0 || !disable_defaultip; +} +#endif /* UNUSED */ + +#if DEMAND_SUPPORT +/* + * ip_demand_conf - configure the interface as though + * IPCP were up, for use with dial-on-demand. + */ +static int +ip_demand_conf(u) + int u; +{ + ppp_pcb *pcb = &ppp_pcb_list[u]; + ipcp_options *wo = &ipcp_wantoptions[u]; + + if (wo->hisaddr == 0 && !pcb->settings.noremoteip) { + /* make up an arbitrary address for the peer */ + wo->hisaddr = htonl(0x0a707070 + ifunit); + wo->accept_remote = 1; + } + if (wo->ouraddr == 0) { + /* make up an arbitrary address for us */ + wo->ouraddr = htonl(0x0a404040 + ifunit); + wo->accept_local = 1; + ask_for_local = 0; /* don't tell the peer this address */ + } + if (!sifaddr(pcb, wo->ouraddr, wo->hisaddr, get_mask(wo->ouraddr))) + return 0; + if (!sifup(pcb)) + return 0; + if (!sifnpmode(pcb, PPP_IP, NPMODE_QUEUE)) + return 0; +#if 0 /* UNUSED */ + if (wo->default_route) + if (sifdefaultroute(pcb, wo->ouraddr, wo->hisaddr, + wo->replace_default_route)) + default_route_set[u] = 1; +#endif /* UNUSED */ +#if 0 /* UNUSED - PROXY ARP */ + if (wo->proxy_arp) + if (sifproxyarp(pcb, wo->hisaddr)) + proxy_arp_set[u] = 1; +#endif /* UNUSED - PROXY ARP */ + + ppp_notice("local IP address %I", wo->ouraddr); + if (wo->hisaddr) + ppp_notice("remote IP address %I", wo->hisaddr); + + return 1; +} +#endif /* DEMAND_SUPPORT */ + +/* + * ipcp_up - IPCP has come UP. + * + * Configure the IP network interface appropriately and bring it up. + */ +static void ipcp_up(fsm *f) { + ppp_pcb *pcb = f->pcb; + u32_t mask; + ipcp_options *ho = &pcb->ipcp_hisoptions; + ipcp_options *go = &pcb->ipcp_gotoptions; + ipcp_options *wo = &pcb->ipcp_wantoptions; + + IPCPDEBUG(("ipcp: up")); + + /* + * We must have a non-zero IP address for both ends of the link. + */ + if (!ho->neg_addr && !ho->old_addrs) + ho->hisaddr = wo->hisaddr; + + if (!(go->neg_addr || go->old_addrs) && (wo->neg_addr || wo->old_addrs) + && wo->ouraddr != 0) { + ppp_error("Peer refused to agree to our IP address"); + ipcp_close(f->pcb, "Refused our IP address"); + return; + } + if (go->ouraddr == 0) { + ppp_error("Could not determine local IP address"); + ipcp_close(f->pcb, "Could not determine local IP address"); + return; + } + if (ho->hisaddr == 0 && !pcb->settings.noremoteip) { + ho->hisaddr = htonl(0x0a404040); + ppp_warn("Could not determine remote IP address: defaulting to %I", + ho->hisaddr); + } +#if 0 /* UNUSED */ + script_setenv("IPLOCAL", ip_ntoa(go->ouraddr), 0); + if (ho->hisaddr != 0) + script_setenv("IPREMOTE", ip_ntoa(ho->hisaddr), 1); +#endif /* UNUSED */ + +#if LWIP_DNS + if (!go->req_dns1) + go->dnsaddr[0] = 0; + if (!go->req_dns2) + go->dnsaddr[1] = 0; +#if 0 /* UNUSED */ + if (go->dnsaddr[0]) + script_setenv("DNS1", ip_ntoa(go->dnsaddr[0]), 0); + if (go->dnsaddr[1]) + script_setenv("DNS2", ip_ntoa(go->dnsaddr[1]), 0); +#endif /* UNUSED */ + if (pcb->settings.usepeerdns && (go->dnsaddr[0] || go->dnsaddr[1])) { + sdns(pcb, go->dnsaddr[0], go->dnsaddr[1]); +#if 0 /* UNUSED */ + script_setenv("USEPEERDNS", "1", 0); + create_resolv(go->dnsaddr[0], go->dnsaddr[1]); +#endif /* UNUSED */ + } +#endif /* LWIP_DNS */ + +/* FIXME: check why it fails, just to know */ +#if 0 /* Unused */ + /* + * Check that the peer is allowed to use the IP address it wants. + */ + if (ho->hisaddr != 0 && !auth_ip_addr(f->unit, ho->hisaddr)) { + ppp_error("Peer is not authorized to use remote address %I", ho->hisaddr); + ipcp_close(f->unit, "Unauthorized remote IP address"); + return; + } +#endif /* Unused */ + +#if VJ_SUPPORT + /* set tcp compression */ + sifvjcomp(pcb, ho->neg_vj, ho->cflag, ho->maxslotindex); +#endif /* VJ_SUPPORT */ + +#if DEMAND_SUPPORT + /* + * If we are doing dial-on-demand, the interface is already + * configured, so we put out any saved-up packets, then set the + * interface to pass IP packets. + */ + if (demand) { + if (go->ouraddr != wo->ouraddr || ho->hisaddr != wo->hisaddr) { + ipcp_clear_addrs(f->unit, wo->ouraddr, wo->hisaddr, + wo->replace_default_route); + if (go->ouraddr != wo->ouraddr) { + ppp_warn("Local IP address changed to %I", go->ouraddr); + script_setenv("OLDIPLOCAL", ip_ntoa(wo->ouraddr), 0); + wo->ouraddr = go->ouraddr; + } else + script_unsetenv("OLDIPLOCAL"); + if (ho->hisaddr != wo->hisaddr && wo->hisaddr != 0) { + ppp_warn("Remote IP address changed to %I", ho->hisaddr); + script_setenv("OLDIPREMOTE", ip_ntoa(wo->hisaddr), 0); + wo->hisaddr = ho->hisaddr; + } else + script_unsetenv("OLDIPREMOTE"); + + /* Set the interface to the new addresses */ + mask = get_mask(go->ouraddr); + if (!sifaddr(pcb, go->ouraddr, ho->hisaddr, mask)) { +#if PPP_DEBUG + ppp_warn("Interface configuration failed"); +#endif /* PPP_DEBUG */ + ipcp_close(f->unit, "Interface configuration failed"); + return; + } + + /* assign a default route through the interface if required */ + if (ipcp_wantoptions[f->unit].default_route) + if (sifdefaultroute(pcb, go->ouraddr, ho->hisaddr, + wo->replace_default_route)) + default_route_set[f->unit] = 1; + +#if 0 /* UNUSED - PROXY ARP */ + /* Make a proxy ARP entry if requested. */ + if (ho->hisaddr != 0 && ipcp_wantoptions[f->unit].proxy_arp) + if (sifproxyarp(pcb, ho->hisaddr)) + proxy_arp_set[f->unit] = 1; +#endif /* UNUSED - PROXY ARP */ + + } + demand_rexmit(PPP_IP,go->ouraddr); + sifnpmode(pcb, PPP_IP, NPMODE_PASS); + + } else +#endif /* DEMAND_SUPPORT */ + { + /* + * Set IP addresses and (if specified) netmask. + */ + mask = get_mask(go->ouraddr); + +#if !(defined(SVR4) && (defined(SNI) || defined(__USLC__))) + if (!sifaddr(pcb, go->ouraddr, ho->hisaddr, mask)) { +#if PPP_DEBUG + ppp_warn("Interface configuration failed"); +#endif /* PPP_DEBUG */ + ipcp_close(f->pcb, "Interface configuration failed"); + return; + } +#endif + + /* bring the interface up for IP */ + if (!sifup(pcb)) { +#if PPP_DEBUG + ppp_warn("Interface failed to come up"); +#endif /* PPP_DEBUG */ + ipcp_close(f->pcb, "Interface configuration failed"); + return; + } + +#if (defined(SVR4) && (defined(SNI) || defined(__USLC__))) + if (!sifaddr(pcb, go->ouraddr, ho->hisaddr, mask)) { +#if PPP_DEBUG + ppp_warn("Interface configuration failed"); +#endif /* PPP_DEBUG */ + ipcp_close(f->unit, "Interface configuration failed"); + return; + } +#endif +#if DEMAND_SUPPORT + sifnpmode(pcb, PPP_IP, NPMODE_PASS); +#endif /* DEMAND_SUPPORT */ + +#if 0 /* UNUSED */ + /* assign a default route through the interface if required */ + if (wo->default_route) + if (sifdefaultroute(pcb, go->ouraddr, ho->hisaddr, + wo->replace_default_route)) + pcb->default_route_set = 1; +#endif /* UNUSED */ + +#if 0 /* UNUSED - PROXY ARP */ + /* Make a proxy ARP entry if requested. */ + if (ho->hisaddr != 0 && wo->proxy_arp) + if (sifproxyarp(pcb, ho->hisaddr)) + pcb->proxy_arp_set = 1; +#endif /* UNUSED - PROXY ARP */ + + wo->ouraddr = go->ouraddr; + + ppp_notice("local IP address %I", go->ouraddr); + if (ho->hisaddr != 0) + ppp_notice("remote IP address %I", ho->hisaddr); +#if LWIP_DNS + if (go->dnsaddr[0]) + ppp_notice("primary DNS address %I", go->dnsaddr[0]); + if (go->dnsaddr[1]) + ppp_notice("secondary DNS address %I", go->dnsaddr[1]); +#endif /* LWIP_DNS */ + } + +#if PPP_STATS_SUPPORT + reset_link_stats(f->unit); +#endif /* PPP_STATS_SUPPORT */ + + np_up(pcb, PPP_IP); + pcb->ipcp_is_up = 1; + +#if PPP_NOTIFY + notify(ip_up_notifier, 0); +#endif /* PPP_NOTIFY */ +#if 0 /* UNUSED */ + if (ip_up_hook) + ip_up_hook(); +#endif /* UNUSED */ +} + + +/* + * ipcp_down - IPCP has gone DOWN. + * + * Take the IP network interface down, clear its addresses + * and delete routes through it. + */ +static void ipcp_down(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipcp_options *ho = &pcb->ipcp_hisoptions; + ipcp_options *go = &pcb->ipcp_gotoptions; + + IPCPDEBUG(("ipcp: down")); +#if PPP_STATS_SUPPORT + /* XXX a bit IPv4-centric here, we only need to get the stats + * before the interface is marked down. */ + /* XXX more correct: we must get the stats before running the notifiers, + * at least for the radius plugin */ + update_link_stats(f->unit); +#endif /* PPP_STATS_SUPPORT */ +#if PPP_NOTIFY + notify(ip_down_notifier, 0); +#endif /* PPP_NOTIFY */ +#if 0 /* UNUSED */ + if (ip_down_hook) + ip_down_hook(); +#endif /* UNUSED */ + if (pcb->ipcp_is_up) { + pcb->ipcp_is_up = 0; + np_down(pcb, PPP_IP); + } +#if VJ_SUPPORT + sifvjcomp(pcb, 0, 0, 0); +#endif /* VJ_SUPPORT */ + +#if PPP_STATS_SUPPORT + print_link_stats(); /* _after_ running the notifiers and ip_down_hook(), + * because print_link_stats() sets link_stats_valid + * to 0 (zero) */ +#endif /* PPP_STATS_SUPPORT */ + +#if DEMAND_SUPPORT + /* + * If we are doing dial-on-demand, set the interface + * to queue up outgoing packets (for now). + */ + if (demand) { + sifnpmode(pcb, PPP_IP, NPMODE_QUEUE); + } else +#endif /* DEMAND_SUPPORT */ + { +#if DEMAND_SUPPORT + sifnpmode(pcb, PPP_IP, NPMODE_DROP); +#endif /* DEMAND_SUPPORT */ + sifdown(pcb); + ipcp_clear_addrs(pcb, go->ouraddr, + ho->hisaddr, 0); +#if LWIP_DNS + cdns(pcb, go->dnsaddr[0], go->dnsaddr[1]); +#endif /* LWIP_DNS */ + } +} + + +/* + * ipcp_clear_addrs() - clear the interface addresses, routes, + * proxy arp entries, etc. + */ +static void ipcp_clear_addrs(ppp_pcb *pcb, u32_t ouraddr, u32_t hisaddr, u8_t replacedefaultroute) { + LWIP_UNUSED_ARG(replacedefaultroute); + +#if 0 /* UNUSED - PROXY ARP */ + if (pcb->proxy_arp_set) { + cifproxyarp(pcb, hisaddr); + pcb->proxy_arp_set = 0; + } +#endif /* UNUSED - PROXY ARP */ +#if 0 /* UNUSED */ + /* If replacedefaultroute, sifdefaultroute will be called soon + * with replacedefaultroute set and that will overwrite the current + * default route. This is the case only when doing demand, otherwise + * during demand, this cifdefaultroute would restore the old default + * route which is not what we want in this case. In the non-demand + * case, we'll delete the default route and restore the old if there + * is one saved by an sifdefaultroute with replacedefaultroute. + */ + if (!replacedefaultroute && pcb->default_route_set) { + cifdefaultroute(pcb, ouraddr, hisaddr); + pcb->default_route_set = 0; + } +#endif /* UNUSED */ + cifaddr(pcb, ouraddr, hisaddr); +} + + +/* + * ipcp_finished - possibly shut down the lower layers. + */ +static void ipcp_finished(fsm *f) { + ppp_pcb *pcb = f->pcb; + if (pcb->ipcp_is_open) { + pcb->ipcp_is_open = 0; + np_finished(pcb, PPP_IP); + } +} + + +#if 0 /* UNUSED */ +/* + * create_resolv - create the replacement resolv.conf file + */ +static void +create_resolv(peerdns1, peerdns2) + u32_t peerdns1, peerdns2; +{ + +} +#endif /* UNUSED */ + +#if PRINTPKT_SUPPORT +/* + * ipcp_printpkt - print the contents of an IPCP packet. + */ +static const char* const ipcp_codenames[] = { + "ConfReq", "ConfAck", "ConfNak", "ConfRej", + "TermReq", "TermAck", "CodeRej" +}; + +static int ipcp_printpkt(const u_char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg) { + int code, id, len, olen; + const u_char *pstart, *optend; +#if VJ_SUPPORT + u_short cishort; +#endif /* VJ_SUPPORT */ + u32_t cilong; + + if (plen < HEADERLEN) + return 0; + pstart = p; + GETCHAR(code, p); + GETCHAR(id, p); + GETSHORT(len, p); + if (len < HEADERLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)sizeof(ipcp_codenames) / (int)sizeof(char *)) + printer(arg, " %s", ipcp_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= HEADERLEN; + switch (code) { + case CONFREQ: + case CONFACK: + case CONFNAK: + case CONFREJ: + /* print option list */ + while (len >= 2) { + GETCHAR(code, p); + GETCHAR(olen, p); + p -= 2; + if (olen < 2 || olen > len) { + break; + } + printer(arg, " <"); + len -= olen; + optend = p + olen; + switch (code) { + case CI_ADDRS: + if (olen == CILEN_ADDRS) { + p += 2; + GETLONG(cilong, p); + printer(arg, "addrs %I", htonl(cilong)); + GETLONG(cilong, p); + printer(arg, " %I", htonl(cilong)); + } + break; +#if VJ_SUPPORT + case CI_COMPRESSTYPE: + if (olen >= CILEN_COMPRESS) { + p += 2; + GETSHORT(cishort, p); + printer(arg, "compress "); + switch (cishort) { + case IPCP_VJ_COMP: + printer(arg, "VJ"); + break; + case IPCP_VJ_COMP_OLD: + printer(arg, "old-VJ"); + break; + default: + printer(arg, "0x%x", cishort); + } + } + break; +#endif /* VJ_SUPPORT */ + case CI_ADDR: + if (olen == CILEN_ADDR) { + p += 2; + GETLONG(cilong, p); + printer(arg, "addr %I", htonl(cilong)); + } + break; +#if LWIP_DNS + case CI_MS_DNS1: + case CI_MS_DNS2: + p += 2; + GETLONG(cilong, p); + printer(arg, "ms-dns%d %I", (code == CI_MS_DNS1? 1: 2), + htonl(cilong)); + break; +#endif /* LWIP_DNS */ +#if 0 /* UNUSED - WINS */ + case CI_MS_WINS1: + case CI_MS_WINS2: + p += 2; + GETLONG(cilong, p); + printer(arg, "ms-wins %I", htonl(cilong)); + break; +#endif /* UNUSED - WINS */ + default: + break; + } + while (p < optend) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + printer(arg, ">"); + } + break; + + case TERMACK: + case TERMREQ: + if (len > 0 && *p >= ' ' && *p < 0x7f) { + printer(arg, " "); + ppp_print_string(p, len, printer, arg); + p += len; + len = 0; + } + break; + default: + break; + } + + /* print the rest of the bytes in the packet */ + for (; len > 0; --len) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + + return p - pstart; +} +#endif /* PRINTPKT_SUPPORT */ + +#if DEMAND_SUPPORT +/* + * ip_active_pkt - see if this IP packet is worth bringing the link up for. + * We don't bring the link up for IP fragments or for TCP FIN packets + * with no data. + */ +#define IP_HDRLEN 20 /* bytes */ +#define IP_OFFMASK 0x1fff +#ifndef IPPROTO_TCP +#define IPPROTO_TCP 6 +#endif +#define TCP_HDRLEN 20 +#define TH_FIN 0x01 + +/* + * We use these macros because the IP header may be at an odd address, + * and some compilers might use word loads to get th_off or ip_hl. + */ + +#define net_short(x) (((x)[0] << 8) + (x)[1]) +#define get_iphl(x) (((unsigned char *)(x))[0] & 0xF) +#define get_ipoff(x) net_short((unsigned char *)(x) + 6) +#define get_ipproto(x) (((unsigned char *)(x))[9]) +#define get_tcpoff(x) (((unsigned char *)(x))[12] >> 4) +#define get_tcpflags(x) (((unsigned char *)(x))[13]) + +static int +ip_active_pkt(pkt, len) + u_char *pkt; + int len; +{ + u_char *tcp; + int hlen; + + len -= PPP_HDRLEN; + pkt += PPP_HDRLEN; + if (len < IP_HDRLEN) + return 0; + if ((get_ipoff(pkt) & IP_OFFMASK) != 0) + return 0; + if (get_ipproto(pkt) != IPPROTO_TCP) + return 1; + hlen = get_iphl(pkt) * 4; + if (len < hlen + TCP_HDRLEN) + return 0; + tcp = pkt + hlen; + if ((get_tcpflags(tcp) & TH_FIN) != 0 && len == hlen + get_tcpoff(tcp) * 4) + return 0; + return 1; +} +#endif /* DEMAND_SUPPORT */ + +#endif /* PPP_SUPPORT && PPP_IPV4_SUPPORT */ diff --git a/components/lwip/netif/ppp/ipv6cp.c b/components/lwip/netif/ppp/ipv6cp.c new file mode 100755 index 000000000..71ac9d7d3 --- /dev/null +++ b/components/lwip/netif/ppp/ipv6cp.c @@ -0,0 +1,1533 @@ +/* + * ipv6cp.c - PPP IPV6 Control Protocol. + * + * Copyright (c) 1999 Tommi Komulainen. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Tommi Komulainen + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + */ + +/* Original version, based on RFC2023 : + + Copyright (c) 1995, 1996, 1997 Francis.Dupont@inria.fr, INRIA Rocquencourt, + Alain.Durand@imag.fr, IMAG, + Jean-Luc.Richier@imag.fr, IMAG-LSR. + + Copyright (c) 1998, 1999 Francis.Dupont@inria.fr, GIE DYADE, + Alain.Durand@imag.fr, IMAG, + Jean-Luc.Richier@imag.fr, IMAG-LSR. + + Ce travail a été fait au sein du GIE DYADE (Groupement d'Intérêt + Économique ayant pour membres BULL S.A. et l'INRIA). + + Ce logiciel informatique est disponible aux conditions + usuelles dans la recherche, c'est-à-dire qu'il peut + être utilisé, copié, modifié, distribué à l'unique + condition que ce texte soit conservé afin que + l'origine de ce logiciel soit reconnue. + + Le nom de l'Institut National de Recherche en Informatique + et en Automatique (INRIA), de l'IMAG, ou d'une personne morale + ou physique ayant participé à l'élaboration de ce logiciel ne peut + être utilisé sans son accord préalable explicite. + + Ce logiciel est fourni tel quel sans aucune garantie, + support ou responsabilité d'aucune sorte. + Ce logiciel est dérivé de sources d'origine + "University of California at Berkeley" et + "Digital Equipment Corporation" couvertes par des copyrights. + + L'Institut d'Informatique et de Mathématiques Appliquées de Grenoble (IMAG) + est une fédération d'unités mixtes de recherche du CNRS, de l'Institut National + Polytechnique de Grenoble et de l'Université Joseph Fourier regroupant + sept laboratoires dont le laboratoire Logiciels, Systèmes, Réseaux (LSR). + + This work has been done in the context of GIE DYADE (joint R & D venture + between BULL S.A. and INRIA). + + This software is available with usual "research" terms + with the aim of retain credits of the software. + Permission to use, copy, modify and distribute this software for any + purpose and without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies, + and the name of INRIA, IMAG, or any contributor not be used in advertising + or publicity pertaining to this material without the prior explicit + permission. The software is provided "as is" without any + warranties, support or liabilities of any kind. + This software is derived from source code from + "University of California at Berkeley" and + "Digital Equipment Corporation" protected by copyrights. + + Grenoble's Institute of Computer Science and Applied Mathematics (IMAG) + is a federation of seven research units funded by the CNRS, National + Polytechnic Institute of Grenoble and University Joseph Fourier. + The research unit in Software, Systems, Networks (LSR) is member of IMAG. +*/ + +/* + * Derived from : + * + * + * ipcp.c - PPP IP Control Protocol. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * + * $Id: ipv6cp.c,v 1.21 2005/08/25 23:59:34 paulus Exp $ + */ + +/* + * TODO: + * + * Proxy Neighbour Discovery. + * + * Better defines for selecting the ordering of + * interface up / set address. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPP_IPV6_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/fsm.h" +#include "netif/ppp/ipcp.h" +#include "netif/ppp/ipv6cp.h" +#include "netif/ppp/magic.h" + +/* global vars */ +#if 0 /* UNUSED */ +int no_ifaceid_neg = 0; +#endif /* UNUSED */ + +/* + * Callbacks for fsm code. (CI = Configuration Information) + */ +static void ipv6cp_resetci(fsm *f); /* Reset our CI */ +static int ipv6cp_cilen(fsm *f); /* Return length of our CI */ +static void ipv6cp_addci(fsm *f, u_char *ucp, int *lenp); /* Add our CI */ +static int ipv6cp_ackci(fsm *f, u_char *p, int len); /* Peer ack'd our CI */ +static int ipv6cp_nakci(fsm *f, u_char *p, int len, int treat_as_reject); /* Peer nak'd our CI */ +static int ipv6cp_rejci(fsm *f, u_char *p, int len); /* Peer rej'd our CI */ +static int ipv6cp_reqci(fsm *f, u_char *inp, int *len, int reject_if_disagree); /* Rcv CI */ +static void ipv6cp_up(fsm *f); /* We're UP */ +static void ipv6cp_down(fsm *f); /* We're DOWN */ +static void ipv6cp_finished(fsm *f); /* Don't need lower layer */ + +static const fsm_callbacks ipv6cp_callbacks = { /* IPV6CP callback routines */ + ipv6cp_resetci, /* Reset our Configuration Information */ + ipv6cp_cilen, /* Length of our Configuration Information */ + ipv6cp_addci, /* Add our Configuration Information */ + ipv6cp_ackci, /* ACK our Configuration Information */ + ipv6cp_nakci, /* NAK our Configuration Information */ + ipv6cp_rejci, /* Reject our Configuration Information */ + ipv6cp_reqci, /* Request peer's Configuration Information */ + ipv6cp_up, /* Called when fsm reaches OPENED state */ + ipv6cp_down, /* Called when fsm leaves OPENED state */ + NULL, /* Called when we want the lower layer up */ + ipv6cp_finished, /* Called when we want the lower layer down */ + NULL, /* Called when Protocol-Reject received */ + NULL, /* Retransmission is necessary */ + NULL, /* Called to handle protocol-specific codes */ + "IPV6CP" /* String name of protocol */ +}; + +#if PPP_OPTIONS +/* + * Command-line options. + */ +static int setifaceid(char **arg)); +static void printifaceid(option_t *, + void (*)(void *, char *, ...), void *)); + +static option_t ipv6cp_option_list[] = { + { "ipv6", o_special, (void *)setifaceid, + "Set interface identifiers for IPV6", + OPT_A2PRINTER, (void *)printifaceid }, + + { "+ipv6", o_bool, &ipv6cp_protent.enabled_flag, + "Enable IPv6 and IPv6CP", OPT_PRIO | 1 }, + { "noipv6", o_bool, &ipv6cp_protent.enabled_flag, + "Disable IPv6 and IPv6CP", OPT_PRIOSUB }, + { "-ipv6", o_bool, &ipv6cp_protent.enabled_flag, + "Disable IPv6 and IPv6CP", OPT_PRIOSUB | OPT_ALIAS }, + + { "ipv6cp-accept-local", o_bool, &ipv6cp_allowoptions[0].accept_local, + "Accept peer's interface identifier for us", 1 }, + + { "ipv6cp-use-ipaddr", o_bool, &ipv6cp_allowoptions[0].use_ip, + "Use (default) IPv4 address as interface identifier", 1 }, + + { "ipv6cp-use-persistent", o_bool, &ipv6cp_wantoptions[0].use_persistent, + "Use uniquely-available persistent value for link local address", 1 }, + + { "ipv6cp-restart", o_int, &ipv6cp_fsm[0].timeouttime, + "Set timeout for IPv6CP", OPT_PRIO }, + { "ipv6cp-max-terminate", o_int, &ipv6cp_fsm[0].maxtermtransmits, + "Set max #xmits for term-reqs", OPT_PRIO }, + { "ipv6cp-max-configure", o_int, &ipv6cp_fsm[0].maxconfreqtransmits, + "Set max #xmits for conf-reqs", OPT_PRIO }, + { "ipv6cp-max-failure", o_int, &ipv6cp_fsm[0].maxnakloops, + "Set max #conf-naks for IPv6CP", OPT_PRIO }, + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points from main code. + */ +static void ipv6cp_init(ppp_pcb *pcb); +static void ipv6cp_open(ppp_pcb *pcb); +static void ipv6cp_close(ppp_pcb *pcb, const char *reason); +static void ipv6cp_lowerup(ppp_pcb *pcb); +static void ipv6cp_lowerdown(ppp_pcb *pcb); +static void ipv6cp_input(ppp_pcb *pcb, u_char *p, int len); +static void ipv6cp_protrej(ppp_pcb *pcb); +#if PPP_OPTIONS +static void ipv6_check_options(void); +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT +static int ipv6_demand_conf(int u); +#endif /* DEMAND_SUPPORT */ +#if PRINTPKT_SUPPORT +static int ipv6cp_printpkt(const u_char *p, int plen, + void (*printer)(void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ +#if DEMAND_SUPPORT +static int ipv6_active_pkt(u_char *pkt, int len); +#endif /* DEMAND_SUPPORT */ + +const struct protent ipv6cp_protent = { + PPP_IPV6CP, + ipv6cp_init, + ipv6cp_input, + ipv6cp_protrej, + ipv6cp_lowerup, + ipv6cp_lowerdown, + ipv6cp_open, + ipv6cp_close, +#if PRINTPKT_SUPPORT + ipv6cp_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "IPV6CP", + "IPV6", +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + ipv6cp_option_list, + ipv6_check_options, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + ipv6_demand_conf, + ipv6_active_pkt +#endif /* DEMAND_SUPPORT */ +}; + +static void ipv6cp_clear_addrs(ppp_pcb *pcb, eui64_t ourid, eui64_t hisid); +#if 0 /* UNUSED */ +static void ipv6cp_script(char *)); +static void ipv6cp_script_done(void *)); +#endif /* UNUSED */ + +/* + * Lengths of configuration options. + */ +#define CILEN_VOID 2 +#define CILEN_COMPRESS 4 /* length for RFC2023 compress opt. */ +#define CILEN_IFACEID 10 /* RFC2472, interface identifier */ + +#define CODENAME(x) ((x) == CONFACK ? "ACK" : \ + (x) == CONFNAK ? "NAK" : "REJ") + +#if 0 /* UNUSED */ +/* + * This state variable is used to ensure that we don't + * run an ipcp-up/down script while one is already running. + */ +static enum script_state { + s_down, + s_up, +} ipv6cp_script_state; +static pid_t ipv6cp_script_pid; +#endif /* UNUSED */ + +static char *llv6_ntoa(eui64_t ifaceid); + +#if PPP_OPTIONS +/* + * setifaceid - set the interface identifiers manually + */ +static int +setifaceid(argv) + char **argv; +{ + char *comma, *arg, c; + ipv6cp_options *wo = &ipv6cp_wantoptions[0]; + struct in6_addr addr; + static int prio_local, prio_remote; + +#define VALIDID(a) ( (((a).s6_addr32[0] == 0) && ((a).s6_addr32[1] == 0)) && \ + (((a).s6_addr32[2] != 0) || ((a).s6_addr32[3] != 0)) ) + + arg = *argv; + if ((comma = strchr(arg, ',')) == NULL) + comma = arg + strlen(arg); + + /* + * If comma first character, then no local identifier + */ + if (comma != arg) { + c = *comma; + *comma = '\0'; + + if (inet_pton(AF_INET6, arg, &addr) == 0 || !VALIDID(addr)) { + option_error("Illegal interface identifier (local): %s", arg); + return 0; + } + + if (option_priority >= prio_local) { + eui64_copy(addr.s6_addr32[2], wo->ourid); + wo->opt_local = 1; + prio_local = option_priority; + } + *comma = c; + } + + /* + * If comma last character, the no remote identifier + */ + if (*comma != 0 && *++comma != '\0') { + if (inet_pton(AF_INET6, comma, &addr) == 0 || !VALIDID(addr)) { + option_error("Illegal interface identifier (remote): %s", comma); + return 0; + } + if (option_priority >= prio_remote) { + eui64_copy(addr.s6_addr32[2], wo->hisid); + wo->opt_remote = 1; + prio_remote = option_priority; + } + } + + if (override_value("+ipv6", option_priority, option_source)) + ipv6cp_protent.enabled_flag = 1; + return 1; +} + +static void +printifaceid(opt, printer, arg) + option_t *opt; + void (*printer)(void *, char *, ...)); + void *arg; +{ + ipv6cp_options *wo = &ipv6cp_wantoptions[0]; + + if (wo->opt_local) + printer(arg, "%s", llv6_ntoa(wo->ourid)); + printer(arg, ","); + if (wo->opt_remote) + printer(arg, "%s", llv6_ntoa(wo->hisid)); +} +#endif /* PPP_OPTIONS */ + +/* + * Make a string representation of a network address. + */ +static char * +llv6_ntoa(eui64_t ifaceid) +{ + static char b[26]; + + sprintf(b, "fe80::%02x%02x:%02x%02x:%02x%02x:%02x%02x", + ifaceid.e8[0], ifaceid.e8[1], ifaceid.e8[2], ifaceid.e8[3], + ifaceid.e8[4], ifaceid.e8[5], ifaceid.e8[6], ifaceid.e8[7]); + + return b; +} + + +/* + * ipv6cp_init - Initialize IPV6CP. + */ +static void ipv6cp_init(ppp_pcb *pcb) { + fsm *f = &pcb->ipv6cp_fsm; + ipv6cp_options *wo = &pcb->ipv6cp_wantoptions; + ipv6cp_options *ao = &pcb->ipv6cp_allowoptions; + + f->pcb = pcb; + f->protocol = PPP_IPV6CP; + f->callbacks = &ipv6cp_callbacks; + fsm_init(f); + +#if 0 /* Not necessary, everything is cleared in ppp_clear() */ + memset(wo, 0, sizeof(*wo)); + memset(ao, 0, sizeof(*ao)); +#endif /* 0 */ + + wo->accept_local = 1; + wo->neg_ifaceid = 1; + ao->neg_ifaceid = 1; + +#ifdef IPV6CP_COMP + wo->neg_vj = 1; + ao->neg_vj = 1; + wo->vj_protocol = IPV6CP_COMP; +#endif + +} + + +/* + * ipv6cp_open - IPV6CP is allowed to come up. + */ +static void ipv6cp_open(ppp_pcb *pcb) { + fsm_open(&pcb->ipv6cp_fsm); +} + + +/* + * ipv6cp_close - Take IPV6CP down. + */ +static void ipv6cp_close(ppp_pcb *pcb, const char *reason) { + fsm_close(&pcb->ipv6cp_fsm, reason); +} + + +/* + * ipv6cp_lowerup - The lower layer is up. + */ +static void ipv6cp_lowerup(ppp_pcb *pcb) { + fsm_lowerup(&pcb->ipv6cp_fsm); +} + + +/* + * ipv6cp_lowerdown - The lower layer is down. + */ +static void ipv6cp_lowerdown(ppp_pcb *pcb) { + fsm_lowerdown(&pcb->ipv6cp_fsm); +} + + +/* + * ipv6cp_input - Input IPV6CP packet. + */ +static void ipv6cp_input(ppp_pcb *pcb, u_char *p, int len) { + fsm_input(&pcb->ipv6cp_fsm, p, len); +} + + +/* + * ipv6cp_protrej - A Protocol-Reject was received for IPV6CP. + * + * Pretend the lower layer went down, so we shut up. + */ +static void ipv6cp_protrej(ppp_pcb *pcb) { + fsm_lowerdown(&pcb->ipv6cp_fsm); +} + + +/* + * ipv6cp_resetci - Reset our CI. + */ +static void ipv6cp_resetci(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *wo = &pcb->ipv6cp_wantoptions; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + ipv6cp_options *ao = &pcb->ipv6cp_allowoptions; + + wo->req_ifaceid = wo->neg_ifaceid && ao->neg_ifaceid; + + if (!wo->opt_local) { + eui64_magic_nz(wo->ourid); + } + + *go = *wo; + eui64_zero(go->hisid); /* last proposed interface identifier */ +} + + +/* + * ipv6cp_cilen - Return length of our CI. + */ +static int ipv6cp_cilen(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + +#ifdef IPV6CP_COMP +#define LENCIVJ(neg) (neg ? CILEN_COMPRESS : 0) +#endif /* IPV6CP_COMP */ +#define LENCIIFACEID(neg) (neg ? CILEN_IFACEID : 0) + + return (LENCIIFACEID(go->neg_ifaceid) + +#ifdef IPV6CP_COMP + LENCIVJ(go->neg_vj) + +#endif /* IPV6CP_COMP */ + 0); +} + + +/* + * ipv6cp_addci - Add our desired CIs to a packet. + */ +static void ipv6cp_addci(fsm *f, u_char *ucp, int *lenp) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + int len = *lenp; + +#ifdef IPV6CP_COMP +#define ADDCIVJ(opt, neg, val) \ + if (neg) { \ + int vjlen = CILEN_COMPRESS; \ + if (len >= vjlen) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(vjlen, ucp); \ + PUTSHORT(val, ucp); \ + len -= vjlen; \ + } else \ + neg = 0; \ + } +#endif /* IPV6CP_COMP */ + +#define ADDCIIFACEID(opt, neg, val1) \ + if (neg) { \ + int idlen = CILEN_IFACEID; \ + if (len >= idlen) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(idlen, ucp); \ + eui64_put(val1, ucp); \ + len -= idlen; \ + } else \ + neg = 0; \ + } + + ADDCIIFACEID(CI_IFACEID, go->neg_ifaceid, go->ourid); + +#ifdef IPV6CP_COMP + ADDCIVJ(CI_COMPRESSTYPE, go->neg_vj, go->vj_protocol); +#endif /* IPV6CP_COMP */ + + *lenp -= len; +} + + +/* + * ipv6cp_ackci - Ack our CIs. + * + * Returns: + * 0 - Ack was bad. + * 1 - Ack was good. + */ +static int ipv6cp_ackci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + u_short cilen, citype; +#ifdef IPV6CP_COMP + u_short cishort; +#endif /* IPV6CP_COMP */ + eui64_t ifaceid; + + /* + * CIs must be in exactly the same order that we sent... + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ + +#ifdef IPV6CP_COMP +#define ACKCIVJ(opt, neg, val) \ + if (neg) { \ + int vjlen = CILEN_COMPRESS; \ + if ((len -= vjlen) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != vjlen || \ + citype != opt) \ + goto bad; \ + GETSHORT(cishort, p); \ + if (cishort != val) \ + goto bad; \ + } +#endif /* IPV6CP_COMP */ + +#define ACKCIIFACEID(opt, neg, val1) \ + if (neg) { \ + int idlen = CILEN_IFACEID; \ + if ((len -= idlen) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != idlen || \ + citype != opt) \ + goto bad; \ + eui64_get(ifaceid, p); \ + if (! eui64_equals(val1, ifaceid)) \ + goto bad; \ + } + + ACKCIIFACEID(CI_IFACEID, go->neg_ifaceid, go->ourid); + +#ifdef IPV6CP_COMP + ACKCIVJ(CI_COMPRESSTYPE, go->neg_vj, go->vj_protocol); +#endif /* IPV6CP_COMP */ + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + return (1); + +bad: + IPV6CPDEBUG(("ipv6cp_ackci: received bad Ack!")); + return (0); +} + +/* + * ipv6cp_nakci - Peer has sent a NAK for some of our CIs. + * This should not modify any state if the Nak is bad + * or if IPV6CP is in the OPENED state. + * + * Returns: + * 0 - Nak was bad. + * 1 - Nak was good. + */ +static int ipv6cp_nakci(fsm *f, u_char *p, int len, int treat_as_reject) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + u_char citype, cilen, *next; +#ifdef IPV6CP_COMP + u_short cishort; +#endif /* IPV6CP_COMP */ + eui64_t ifaceid; + ipv6cp_options no; /* options we've seen Naks for */ + ipv6cp_options try_; /* options to request next time */ + + BZERO(&no, sizeof(no)); + try_ = *go; + + /* + * Any Nak'd CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define NAKCIIFACEID(opt, neg, code) \ + if (go->neg && \ + len >= (cilen = CILEN_IFACEID) && \ + p[1] == cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + eui64_get(ifaceid, p); \ + no.neg = 1; \ + code \ + } + +#ifdef IPV6CP_COMP +#define NAKCIVJ(opt, neg, code) \ + if (go->neg && \ + ((cilen = p[1]) == CILEN_COMPRESS) && \ + len >= cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + no.neg = 1; \ + code \ + } +#endif /* IPV6CP_COMP */ + + /* + * Accept the peer's idea of {our,his} interface identifier, if different + * from our idea, only if the accept_{local,remote} flag is set. + */ + NAKCIIFACEID(CI_IFACEID, neg_ifaceid, + if (treat_as_reject) { + try_.neg_ifaceid = 0; + } else if (go->accept_local) { + while (eui64_iszero(ifaceid) || + eui64_equals(ifaceid, go->hisid)) /* bad luck */ + eui64_magic(ifaceid); + try_.ourid = ifaceid; + IPV6CPDEBUG(("local LL address %s", llv6_ntoa(ifaceid))); + } + ); + +#ifdef IPV6CP_COMP + NAKCIVJ(CI_COMPRESSTYPE, neg_vj, + { + if (cishort == IPV6CP_COMP && !treat_as_reject) { + try_.vj_protocol = cishort; + } else { + try_.neg_vj = 0; + } + } + ); +#endif /* IPV6CP_COMP */ + + /* + * There may be remaining CIs, if the peer is requesting negotiation + * on an option that we didn't include in our request packet. + * If they want to negotiate about interface identifier, we comply. + * If they want us to ask for compression, we refuse. + */ + while (len >= CILEN_VOID) { + GETCHAR(citype, p); + GETCHAR(cilen, p); + if ( cilen < CILEN_VOID || (len -= cilen) < 0 ) + goto bad; + next = p + cilen - 2; + + switch (citype) { +#ifdef IPV6CP_COMP + case CI_COMPRESSTYPE: + if (go->neg_vj || no.neg_vj || + (cilen != CILEN_COMPRESS)) + goto bad; + no.neg_vj = 1; + break; +#endif /* IPV6CP_COMP */ + case CI_IFACEID: + if (go->neg_ifaceid || no.neg_ifaceid || cilen != CILEN_IFACEID) + goto bad; + try_.neg_ifaceid = 1; + eui64_get(ifaceid, p); + if (go->accept_local) { + while (eui64_iszero(ifaceid) || + eui64_equals(ifaceid, go->hisid)) /* bad luck */ + eui64_magic(ifaceid); + try_.ourid = ifaceid; + } + no.neg_ifaceid = 1; + break; + default: + break; + } + p = next; + } + + /* If there is still anything left, this packet is bad. */ + if (len != 0) + goto bad; + + /* + * OK, the Nak is good. Now we can update state. + */ + if (f->state != PPP_FSM_OPENED) + *go = try_; + + return 1; + +bad: + IPV6CPDEBUG(("ipv6cp_nakci: received bad Nak!")); + return 0; +} + + +/* + * ipv6cp_rejci - Reject some of our CIs. + */ +static int ipv6cp_rejci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + u_char cilen; +#ifdef IPV6CP_COMP + u_short cishort; +#endif /* IPV6CP_COMP */ + eui64_t ifaceid; + ipv6cp_options try_; /* options to request next time */ + + try_ = *go; + /* + * Any Rejected CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define REJCIIFACEID(opt, neg, val1) \ + if (go->neg && \ + len >= (cilen = CILEN_IFACEID) && \ + p[1] == cilen && \ + p[0] == opt) { \ + len -= cilen; \ + INCPTR(2, p); \ + eui64_get(ifaceid, p); \ + /* Check rejected value. */ \ + if (! eui64_equals(ifaceid, val1)) \ + goto bad; \ + try_.neg = 0; \ + } + +#ifdef IPV6CP_COMP +#define REJCIVJ(opt, neg, val) \ + if (go->neg && \ + p[1] == CILEN_COMPRESS && \ + len >= p[1] && \ + p[0] == opt) { \ + len -= p[1]; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + /* Check rejected value. */ \ + if (cishort != val) \ + goto bad; \ + try_.neg = 0; \ + } +#endif /* IPV6CP_COMP */ + + REJCIIFACEID(CI_IFACEID, neg_ifaceid, go->ourid); + +#ifdef IPV6CP_COMP + REJCIVJ(CI_COMPRESSTYPE, neg_vj, go->vj_protocol); +#endif /* IPV6CP_COMP */ + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + /* + * Now we can update state. + */ + if (f->state != PPP_FSM_OPENED) + *go = try_; + return 1; + +bad: + IPV6CPDEBUG(("ipv6cp_rejci: received bad Reject!")); + return 0; +} + + +/* + * ipv6cp_reqci - Check the peer's requested CIs and send appropriate response. + * + * Returns: CONFACK, CONFNAK or CONFREJ and input packet modified + * appropriately. If reject_if_disagree is non-zero, doesn't return + * CONFNAK; returns CONFREJ if it can't return CONFACK. + * + * inp = Requested CIs + * len = Length of requested CIs + * + */ +static int ipv6cp_reqci(fsm *f, u_char *inp, int *len, int reject_if_disagree) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *wo = &pcb->ipv6cp_wantoptions; + ipv6cp_options *ho = &pcb->ipv6cp_hisoptions; + ipv6cp_options *ao = &pcb->ipv6cp_allowoptions; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + u_char *cip, *next; /* Pointer to current and next CIs */ + u_short cilen, citype; /* Parsed len, type */ +#ifdef IPV6CP_COMP + u_short cishort; /* Parsed short value */ +#endif /* IPV6CP_COMP */ + eui64_t ifaceid; /* Parsed interface identifier */ + int rc = CONFACK; /* Final packet return code */ + int orc; /* Individual option return code */ + u_char *p; /* Pointer to next char to parse */ + u_char *ucp = inp; /* Pointer to current output char */ + int l = *len; /* Length left */ + + /* + * Reset all his options. + */ + BZERO(ho, sizeof(*ho)); + + /* + * Process all his options. + */ + next = inp; + while (l) { + orc = CONFACK; /* Assume success */ + cip = p = next; /* Remember begining of CI */ + if (l < 2 || /* Not enough data for CI header or */ + p[1] < 2 || /* CI length too small or */ + p[1] > l) { /* CI length too big? */ + IPV6CPDEBUG(("ipv6cp_reqci: bad CI length!")); + orc = CONFREJ; /* Reject bad CI */ + cilen = l; /* Reject till end of packet */ + l = 0; /* Don't loop again */ + goto endswitch; + } + GETCHAR(citype, p); /* Parse CI type */ + GETCHAR(cilen, p); /* Parse CI length */ + l -= cilen; /* Adjust remaining length */ + next += cilen; /* Step to next CI */ + + switch (citype) { /* Check CI type */ + case CI_IFACEID: + IPV6CPDEBUG(("ipv6cp: received interface identifier ")); + + if (!ao->neg_ifaceid || + cilen != CILEN_IFACEID) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + + /* + * If he has no interface identifier, or if we both have same + * identifier then NAK it with new idea. + * In particular, if we don't know his identifier, but he does, + * then accept it. + */ + eui64_get(ifaceid, p); + IPV6CPDEBUG(("(%s)", llv6_ntoa(ifaceid))); + if (eui64_iszero(ifaceid) && eui64_iszero(go->ourid)) { + orc = CONFREJ; /* Reject CI */ + break; + } + if (!eui64_iszero(wo->hisid) && + !eui64_equals(ifaceid, wo->hisid) && + eui64_iszero(go->hisid)) { + + orc = CONFNAK; + ifaceid = wo->hisid; + go->hisid = ifaceid; + DECPTR(sizeof(ifaceid), p); + eui64_put(ifaceid, p); + } else + if (eui64_iszero(ifaceid) || eui64_equals(ifaceid, go->ourid)) { + orc = CONFNAK; + if (eui64_iszero(go->hisid)) /* first time, try option */ + ifaceid = wo->hisid; + while (eui64_iszero(ifaceid) || + eui64_equals(ifaceid, go->ourid)) /* bad luck */ + eui64_magic(ifaceid); + go->hisid = ifaceid; + DECPTR(sizeof(ifaceid), p); + eui64_put(ifaceid, p); + } + + ho->neg_ifaceid = 1; + ho->hisid = ifaceid; + break; + +#ifdef IPV6CP_COMP + case CI_COMPRESSTYPE: + IPV6CPDEBUG(("ipv6cp: received COMPRESSTYPE ")); + if (!ao->neg_vj || + (cilen != CILEN_COMPRESS)) { + orc = CONFREJ; + break; + } + GETSHORT(cishort, p); + IPV6CPDEBUG(("(%d)", cishort)); + + if (!(cishort == IPV6CP_COMP)) { + orc = CONFREJ; + break; + } + + ho->neg_vj = 1; + ho->vj_protocol = cishort; + break; +#endif /* IPV6CP_COMP */ + + default: + orc = CONFREJ; + break; + } + +endswitch: + IPV6CPDEBUG((" (%s)\n", CODENAME(orc))); + + if (orc == CONFACK && /* Good CI */ + rc != CONFACK) /* but prior CI wasnt? */ + continue; /* Don't send this one */ + + if (orc == CONFNAK) { /* Nak this CI? */ + if (reject_if_disagree) /* Getting fed up with sending NAKs? */ + orc = CONFREJ; /* Get tough if so */ + else { + if (rc == CONFREJ) /* Rejecting prior CI? */ + continue; /* Don't send this one */ + if (rc == CONFACK) { /* Ack'd all prior CIs? */ + rc = CONFNAK; /* Not anymore... */ + ucp = inp; /* Backup */ + } + } + } + + if (orc == CONFREJ && /* Reject this CI */ + rc != CONFREJ) { /* but no prior ones? */ + rc = CONFREJ; + ucp = inp; /* Backup */ + } + + /* Need to move CI? */ + if (ucp != cip) + MEMCPY(ucp, cip, cilen); /* Move it */ + + /* Update output pointer */ + INCPTR(cilen, ucp); + } + + /* + * If we aren't rejecting this packet, and we want to negotiate + * their identifier and they didn't send their identifier, then we + * send a NAK with a CI_IFACEID option appended. We assume the + * input buffer is long enough that we can append the extra + * option safely. + */ + if (rc != CONFREJ && !ho->neg_ifaceid && + wo->req_ifaceid && !reject_if_disagree) { + if (rc == CONFACK) { + rc = CONFNAK; + ucp = inp; /* reset pointer */ + wo->req_ifaceid = 0; /* don't ask again */ + } + PUTCHAR(CI_IFACEID, ucp); + PUTCHAR(CILEN_IFACEID, ucp); + eui64_put(wo->hisid, ucp); + } + + *len = ucp - inp; /* Compute output length */ + IPV6CPDEBUG(("ipv6cp: returning Configure-%s", CODENAME(rc))); + return (rc); /* Return final code */ +} + +#if PPP_OPTIONS +/* + * ipv6_check_options - check that any IP-related options are OK, + * and assign appropriate defaults. + */ +static void ipv6_check_options() { + ipv6cp_options *wo = &ipv6cp_wantoptions[0]; + + if (!ipv6cp_protent.enabled_flag) + return; + + /* + * Persistent link-local id is only used when user has not explicitly + * configure/hard-code the id + */ + if ((wo->use_persistent) && (!wo->opt_local) && (!wo->opt_remote)) { + + /* + * On systems where there are no Ethernet interfaces used, there + * may be other ways to obtain a persistent id. Right now, it + * will fall back to using magic [see eui64_magic] below when + * an EUI-48 from MAC address can't be obtained. Other possibilities + * include obtaining EEPROM serial numbers, or some other unique + * yet persistent number. On Sparc platforms, this is possible, + * but too bad there's no standards yet for x86 machines. + */ + if (ether_to_eui64(&wo->ourid)) { + wo->opt_local = 1; + } + } + + if (!wo->opt_local) { /* init interface identifier */ + if (wo->use_ip && eui64_iszero(wo->ourid)) { + eui64_setlo32(wo->ourid, ntohl(ipcp_wantoptions[0].ouraddr)); + if (!eui64_iszero(wo->ourid)) + wo->opt_local = 1; + } + + while (eui64_iszero(wo->ourid)) + eui64_magic(wo->ourid); + } + + if (!wo->opt_remote) { + if (wo->use_ip && eui64_iszero(wo->hisid)) { + eui64_setlo32(wo->hisid, ntohl(ipcp_wantoptions[0].hisaddr)); + if (!eui64_iszero(wo->hisid)) + wo->opt_remote = 1; + } + } + + if (demand && (eui64_iszero(wo->ourid) || eui64_iszero(wo->hisid))) { + option_error("local/remote LL address required for demand-dialling\n"); + exit(1); + } +} +#endif /* PPP_OPTIONS */ + +#if DEMAND_SUPPORT +/* + * ipv6_demand_conf - configure the interface as though + * IPV6CP were up, for use with dial-on-demand. + */ +static int ipv6_demand_conf(int u) { + ipv6cp_options *wo = &ipv6cp_wantoptions[u]; + + if (!sif6up(u)) + return 0; + + if (!sif6addr(u, wo->ourid, wo->hisid)) + return 0; + + if (!sifnpmode(u, PPP_IPV6, NPMODE_QUEUE)) + return 0; + + ppp_notice("ipv6_demand_conf"); + ppp_notice("local LL address %s", llv6_ntoa(wo->ourid)); + ppp_notice("remote LL address %s", llv6_ntoa(wo->hisid)); + + return 1; +} +#endif /* DEMAND_SUPPORT */ + + +/* + * ipv6cp_up - IPV6CP has come UP. + * + * Configure the IPv6 network interface appropriately and bring it up. + */ +static void ipv6cp_up(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *wo = &pcb->ipv6cp_wantoptions; + ipv6cp_options *ho = &pcb->ipv6cp_hisoptions; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + + IPV6CPDEBUG(("ipv6cp: up")); + + /* + * We must have a non-zero LL address for both ends of the link. + */ + if (!ho->neg_ifaceid) + ho->hisid = wo->hisid; + +#if 0 /* UNUSED */ + if(!no_ifaceid_neg) { +#endif /* UNUSED */ + if (eui64_iszero(ho->hisid)) { + ppp_error("Could not determine remote LL address"); + ipv6cp_close(f->pcb, "Could not determine remote LL address"); + return; + } + if (eui64_iszero(go->ourid)) { + ppp_error("Could not determine local LL address"); + ipv6cp_close(f->pcb, "Could not determine local LL address"); + return; + } + if (eui64_equals(go->ourid, ho->hisid)) { + ppp_error("local and remote LL addresses are equal"); + ipv6cp_close(f->pcb, "local and remote LL addresses are equal"); + return; + } +#if 0 /* UNUSED */ + } +#endif /* UNUSED */ +#if 0 /* UNUSED */ + script_setenv("LLLOCAL", llv6_ntoa(go->ourid), 0); + script_setenv("LLREMOTE", llv6_ntoa(ho->hisid), 0); +#endif /* UNUSED */ + +#ifdef IPV6CP_COMP + /* set tcp compression */ + sif6comp(f->unit, ho->neg_vj); +#endif + +#if DEMAND_SUPPORT + /* + * If we are doing dial-on-demand, the interface is already + * configured, so we put out any saved-up packets, then set the + * interface to pass IPv6 packets. + */ + if (demand) { + if (! eui64_equals(go->ourid, wo->ourid) || + ! eui64_equals(ho->hisid, wo->hisid)) { + if (! eui64_equals(go->ourid, wo->ourid)) + warn("Local LL address changed to %s", + llv6_ntoa(go->ourid)); + if (! eui64_equals(ho->hisid, wo->hisid)) + warn("Remote LL address changed to %s", + llv6_ntoa(ho->hisid)); + ipv6cp_clear_addrs(f->pcb, go->ourid, ho->hisid); + + /* Set the interface to the new addresses */ + if (!sif6addr(f->pcb, go->ourid, ho->hisid)) { + if (debug) + warn("sif6addr failed"); + ipv6cp_close(f->unit, "Interface configuration failed"); + return; + } + + } + demand_rexmit(PPP_IPV6); + sifnpmode(f->unit, PPP_IPV6, NPMODE_PASS); + + } else +#endif /* DEMAND_SUPPORT */ + { + /* + * Set LL addresses + */ + if (!sif6addr(f->pcb, go->ourid, ho->hisid)) { + PPPDEBUG(LOG_DEBUG, ("sif6addr failed")); + ipv6cp_close(f->pcb, "Interface configuration failed"); + return; + } + + /* bring the interface up for IPv6 */ + if (!sif6up(f->pcb)) { + PPPDEBUG(LOG_DEBUG, ("sif6up failed (IPV6)")); + ipv6cp_close(f->pcb, "Interface configuration failed"); + return; + } +#if DEMAND_SUPPORT + sifnpmode(f->pcb, PPP_IPV6, NPMODE_PASS); +#endif /* DEMAND_SUPPORT */ + + ppp_notice("local LL address %s", llv6_ntoa(go->ourid)); + ppp_notice("remote LL address %s", llv6_ntoa(ho->hisid)); + } + + np_up(f->pcb, PPP_IPV6); + pcb->ipv6cp_is_up = 1; + +#if 0 /* UNUSED */ + /* + * Execute the ipv6-up script, like this: + * /etc/ppp/ipv6-up interface tty speed local-LL remote-LL + */ + if (ipv6cp_script_state == s_down && ipv6cp_script_pid == 0) { + ipv6cp_script_state = s_up; + ipv6cp_script(_PATH_IPV6UP); + } +#endif /* UNUSED */ +} + + +/* + * ipv6cp_down - IPV6CP has gone DOWN. + * + * Take the IPv6 network interface down, clear its addresses + * and delete routes through it. + */ +static void ipv6cp_down(fsm *f) { + ppp_pcb *pcb = f->pcb; + ipv6cp_options *go = &pcb->ipv6cp_gotoptions; + ipv6cp_options *ho = &pcb->ipv6cp_hisoptions; + + IPV6CPDEBUG(("ipv6cp: down")); +#if PPP_STATS_SUPPORT + update_link_stats(f->unit); +#endif /* PPP_STATS_SUPPORT */ + if (pcb->ipv6cp_is_up) { + pcb->ipv6cp_is_up = 0; + np_down(f->pcb, PPP_IPV6); + } +#ifdef IPV6CP_COMP + sif6comp(f->unit, 0); +#endif + +#if DEMAND_SUPPORT + /* + * If we are doing dial-on-demand, set the interface + * to queue up outgoing packets (for now). + */ + if (demand) { + sifnpmode(f->pcb, PPP_IPV6, NPMODE_QUEUE); + } else +#endif /* DEMAND_SUPPORT */ + { +#if DEMAND_SUPPORT + sifnpmode(f->pcb, PPP_IPV6, NPMODE_DROP); +#endif /* DEMAND_SUPPORT */ + ipv6cp_clear_addrs(f->pcb, + go->ourid, + ho->hisid); + sif6down(f->pcb); + } + +#if 0 /* UNUSED */ + /* Execute the ipv6-down script */ + if (ipv6cp_script_state == s_up && ipv6cp_script_pid == 0) { + ipv6cp_script_state = s_down; + ipv6cp_script(_PATH_IPV6DOWN); + } +#endif /* UNUSED */ +} + + +/* + * ipv6cp_clear_addrs() - clear the interface addresses, routes, + * proxy neighbour discovery entries, etc. + */ +static void ipv6cp_clear_addrs(ppp_pcb *pcb, eui64_t ourid, eui64_t hisid) { + cif6addr(pcb, ourid, hisid); +} + + +/* + * ipv6cp_finished - possibly shut down the lower layers. + */ +static void ipv6cp_finished(fsm *f) { + np_finished(f->pcb, PPP_IPV6); +} + + +#if 0 /* UNUSED */ +/* + * ipv6cp_script_done - called when the ipv6-up or ipv6-down script + * has finished. + */ +static void +ipv6cp_script_done(arg) + void *arg; +{ + ipv6cp_script_pid = 0; + switch (ipv6cp_script_state) { + case s_up: + if (ipv6cp_fsm[0].state != PPP_FSM_OPENED) { + ipv6cp_script_state = s_down; + ipv6cp_script(_PATH_IPV6DOWN); + } + break; + case s_down: + if (ipv6cp_fsm[0].state == PPP_FSM_OPENED) { + ipv6cp_script_state = s_up; + ipv6cp_script(_PATH_IPV6UP); + } + break; + } +} + + +/* + * ipv6cp_script - Execute a script with arguments + * interface-name tty-name speed local-LL remote-LL. + */ +static void +ipv6cp_script(script) + char *script; +{ + char strspeed[32], strlocal[32], strremote[32]; + char *argv[8]; + + sprintf(strspeed, "%d", baud_rate); + strcpy(strlocal, llv6_ntoa(ipv6cp_gotoptions[0].ourid)); + strcpy(strremote, llv6_ntoa(ipv6cp_hisoptions[0].hisid)); + + argv[0] = script; + argv[1] = ifname; + argv[2] = devnam; + argv[3] = strspeed; + argv[4] = strlocal; + argv[5] = strremote; + argv[6] = ipparam; + argv[7] = NULL; + + ipv6cp_script_pid = run_program(script, argv, 0, ipv6cp_script_done, + NULL, 0); +} +#endif /* UNUSED */ + +#if PRINTPKT_SUPPORT +/* + * ipv6cp_printpkt - print the contents of an IPV6CP packet. + */ +static const char* const ipv6cp_codenames[] = { + "ConfReq", "ConfAck", "ConfNak", "ConfRej", + "TermReq", "TermAck", "CodeRej" +}; + +static int ipv6cp_printpkt(const u_char *p, int plen, + void (*printer)(void *, const char *, ...), void *arg) { + int code, id, len, olen; + const u_char *pstart, *optend; +#ifdef IPV6CP_COMP + u_short cishort; +#endif /* IPV6CP_COMP */ + eui64_t ifaceid; + + if (plen < HEADERLEN) + return 0; + pstart = p; + GETCHAR(code, p); + GETCHAR(id, p); + GETSHORT(len, p); + if (len < HEADERLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)sizeof(ipv6cp_codenames) / (int)sizeof(char *)) + printer(arg, " %s", ipv6cp_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= HEADERLEN; + switch (code) { + case CONFREQ: + case CONFACK: + case CONFNAK: + case CONFREJ: + /* print option list */ + while (len >= 2) { + GETCHAR(code, p); + GETCHAR(olen, p); + p -= 2; + if (olen < 2 || olen > len) { + break; + } + printer(arg, " <"); + len -= olen; + optend = p + olen; + switch (code) { +#ifdef IPV6CP_COMP + case CI_COMPRESSTYPE: + if (olen >= CILEN_COMPRESS) { + p += 2; + GETSHORT(cishort, p); + printer(arg, "compress "); + printer(arg, "0x%x", cishort); + } + break; +#endif /* IPV6CP_COMP */ + case CI_IFACEID: + if (olen == CILEN_IFACEID) { + p += 2; + eui64_get(ifaceid, p); + printer(arg, "addr %s", llv6_ntoa(ifaceid)); + } + break; + default: + break; + } + while (p < optend) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + printer(arg, ">"); + } + break; + + case TERMACK: + case TERMREQ: + if (len > 0 && *p >= ' ' && *p < 0x7f) { + printer(arg, " "); + ppp_print_string(p, len, printer, arg); + p += len; + len = 0; + } + break; + default: + break; + } + + /* print the rest of the bytes in the packet */ + for (; len > 0; --len) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + + return p - pstart; +} +#endif /* PRINTPKT_SUPPORT */ + +#if DEMAND_SUPPORT +/* + * ipv6_active_pkt - see if this IP packet is worth bringing the link up for. + * We don't bring the link up for IP fragments or for TCP FIN packets + * with no data. + */ +#define IP6_HDRLEN 40 /* bytes */ +#define IP6_NHDR_FRAG 44 /* fragment IPv6 header */ +#define TCP_HDRLEN 20 +#define TH_FIN 0x01 + +/* + * We use these macros because the IP header may be at an odd address, + * and some compilers might use word loads to get th_off or ip_hl. + */ + +#define get_ip6nh(x) (((unsigned char *)(x))[6]) +#define get_tcpoff(x) (((unsigned char *)(x))[12] >> 4) +#define get_tcpflags(x) (((unsigned char *)(x))[13]) + +static int ipv6_active_pkt(u_char *pkt, int len) { + u_char *tcp; + + len -= PPP_HDRLEN; + pkt += PPP_HDRLEN; + if (len < IP6_HDRLEN) + return 0; + if (get_ip6nh(pkt) == IP6_NHDR_FRAG) + return 0; + if (get_ip6nh(pkt) != IPPROTO_TCP) + return 1; + if (len < IP6_HDRLEN + TCP_HDRLEN) + return 0; + tcp = pkt + IP6_HDRLEN; + if ((get_tcpflags(tcp) & TH_FIN) != 0 && len == IP6_HDRLEN + get_tcpoff(tcp) * 4) + return 0; + return 1; +} +#endif /* DEMAND_SUPPORT */ + +#endif /* PPP_SUPPORT && PPP_IPV6_SUPPORT */ diff --git a/components/lwip/netif/ppp/lcp.c b/components/lwip/netif/ppp/lcp.c new file mode 100755 index 000000000..1e4798064 --- /dev/null +++ b/components/lwip/netif/ppp/lcp.c @@ -0,0 +1,2786 @@ +/* + * lcp.c - PPP Link Control Protocol. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +/* + * TODO: + */ + +#if 0 /* UNUSED */ +#include +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/lcp.h" +#if CHAP_SUPPORT +#include "netif/ppp/chap-new.h" +#endif /* CHAP_SUPPORT */ +#include "netif/ppp/magic.h" + +/* + * When the link comes up we want to be able to wait for a short while, + * or until seeing some input from the peer, before starting to send + * configure-requests. We do this by delaying the fsm_lowerup call. + */ +/* steal a bit in fsm flags word */ +#define DELAYED_UP 0x80 + +static void lcp_delayed_up(void *arg); + +/* + * LCP-related command-line options. + */ +#if 0 /* UNUSED */ +int lcp_echo_interval = 0; /* Interval between LCP echo-requests */ +int lcp_echo_fails = 0; /* Tolerance to unanswered echo-requests */ +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +/* options */ +static u_int lcp_echo_interval = LCP_ECHOINTERVAL; /* Interval between LCP echo-requests */ +static u_int lcp_echo_fails = LCP_MAXECHOFAILS; /* Tolerance to unanswered echo-requests */ +#endif /* UNUSED */ + +#if 0 /* UNUSED */ +#if PPP_LCP_ADAPTIVE +bool lcp_echo_adaptive = 0; /* request echo only if the link was idle */ +#endif +bool lax_recv = 0; /* accept control chars in asyncmap */ +bool noendpoint = 0; /* don't send/accept endpoint discriminator */ +#endif /* UNUSED */ + +#if PPP_OPTIONS +static int noopt (char **); +#endif /* PPP_OPTIONS */ + +#ifdef HAVE_MULTILINK +static int setendpoint (char **); +static void printendpoint (option_t *, void (*)(void *, char *, ...), + void *); +#endif /* HAVE_MULTILINK */ + +#if PPP_OPTIONS +static option_t lcp_option_list[] = { + /* LCP options */ + { "-all", o_special_noarg, (void *)noopt, + "Don't request/allow any LCP options" }, + + { "noaccomp", o_bool, &lcp_wantoptions[0].neg_accompression, + "Disable address/control compression", + OPT_A2CLR, &lcp_allowoptions[0].neg_accompression }, + { "-ac", o_bool, &lcp_wantoptions[0].neg_accompression, + "Disable address/control compression", + OPT_ALIAS | OPT_A2CLR, &lcp_allowoptions[0].neg_accompression }, + + { "asyncmap", o_uint32, &lcp_wantoptions[0].asyncmap, + "Set asyncmap (for received packets)", + OPT_OR, &lcp_wantoptions[0].neg_asyncmap }, + { "-as", o_uint32, &lcp_wantoptions[0].asyncmap, + "Set asyncmap (for received packets)", + OPT_ALIAS | OPT_OR, &lcp_wantoptions[0].neg_asyncmap }, + { "default-asyncmap", o_uint32, &lcp_wantoptions[0].asyncmap, + "Disable asyncmap negotiation", + OPT_OR | OPT_NOARG | OPT_VAL(~0U) | OPT_A2CLR, + &lcp_allowoptions[0].neg_asyncmap }, + { "-am", o_uint32, &lcp_wantoptions[0].asyncmap, + "Disable asyncmap negotiation", + OPT_ALIAS | OPT_OR | OPT_NOARG | OPT_VAL(~0U) | OPT_A2CLR, + &lcp_allowoptions[0].neg_asyncmap }, + + { "nomagic", o_bool, &lcp_wantoptions[0].neg_magicnumber, + "Disable magic number negotiation (looped-back line detection)", + OPT_A2CLR, &lcp_allowoptions[0].neg_magicnumber }, + { "-mn", o_bool, &lcp_wantoptions[0].neg_magicnumber, + "Disable magic number negotiation (looped-back line detection)", + OPT_ALIAS | OPT_A2CLR, &lcp_allowoptions[0].neg_magicnumber }, + + { "mru", o_int, &lcp_wantoptions[0].mru, + "Set MRU (maximum received packet size) for negotiation", + OPT_PRIO, &lcp_wantoptions[0].neg_mru }, + { "default-mru", o_bool, &lcp_wantoptions[0].neg_mru, + "Disable MRU negotiation (use default 1500)", + OPT_PRIOSUB | OPT_A2CLR, &lcp_allowoptions[0].neg_mru }, + { "-mru", o_bool, &lcp_wantoptions[0].neg_mru, + "Disable MRU negotiation (use default 1500)", + OPT_ALIAS | OPT_PRIOSUB | OPT_A2CLR, &lcp_allowoptions[0].neg_mru }, + + { "mtu", o_int, &lcp_allowoptions[0].mru, + "Set our MTU", OPT_LIMITS, NULL, MAXMRU, MINMRU }, + + { "nopcomp", o_bool, &lcp_wantoptions[0].neg_pcompression, + "Disable protocol field compression", + OPT_A2CLR, &lcp_allowoptions[0].neg_pcompression }, + { "-pc", o_bool, &lcp_wantoptions[0].neg_pcompression, + "Disable protocol field compression", + OPT_ALIAS | OPT_A2CLR, &lcp_allowoptions[0].neg_pcompression }, + + { "passive", o_bool, &lcp_wantoptions[0].passive, + "Set passive mode", 1 }, + { "-p", o_bool, &lcp_wantoptions[0].passive, + "Set passive mode", OPT_ALIAS | 1 }, + + { "silent", o_bool, &lcp_wantoptions[0].silent, + "Set silent mode", 1 }, + + { "lcp-echo-failure", o_int, &lcp_echo_fails, + "Set number of consecutive echo failures to indicate link failure", + OPT_PRIO }, + { "lcp-echo-interval", o_int, &lcp_echo_interval, + "Set time in seconds between LCP echo requests", OPT_PRIO }, +#if PPP_LCP_ADAPTIVE + { "lcp-echo-adaptive", o_bool, &lcp_echo_adaptive, + "Suppress LCP echo requests if traffic was received", 1 }, +#endif + { "lcp-restart", o_int, &lcp_fsm[0].timeouttime, + "Set time in seconds between LCP retransmissions", OPT_PRIO }, + { "lcp-max-terminate", o_int, &lcp_fsm[0].maxtermtransmits, + "Set maximum number of LCP terminate-request transmissions", OPT_PRIO }, + { "lcp-max-configure", o_int, &lcp_fsm[0].maxconfreqtransmits, + "Set maximum number of LCP configure-request transmissions", OPT_PRIO }, + { "lcp-max-failure", o_int, &lcp_fsm[0].maxnakloops, + "Set limit on number of LCP configure-naks", OPT_PRIO }, + + { "receive-all", o_bool, &lax_recv, + "Accept all received control characters", 1 }, + +#ifdef HAVE_MULTILINK + { "mrru", o_int, &lcp_wantoptions[0].mrru, + "Maximum received packet size for multilink bundle", + OPT_PRIO, &lcp_wantoptions[0].neg_mrru }, + + { "mpshortseq", o_bool, &lcp_wantoptions[0].neg_ssnhf, + "Use short sequence numbers in multilink headers", + OPT_PRIO | 1, &lcp_allowoptions[0].neg_ssnhf }, + { "nompshortseq", o_bool, &lcp_wantoptions[0].neg_ssnhf, + "Don't use short sequence numbers in multilink headers", + OPT_PRIOSUB | OPT_A2CLR, &lcp_allowoptions[0].neg_ssnhf }, + + { "endpoint", o_special, (void *) setendpoint, + "Endpoint discriminator for multilink", + OPT_PRIO | OPT_A2PRINTER, (void *) printendpoint }, +#endif /* HAVE_MULTILINK */ + + { "noendpoint", o_bool, &noendpoint, + "Don't send or accept multilink endpoint discriminator", 1 }, + + {NULL} +}; +#endif /* PPP_OPTIONS */ + +/* + * Callbacks for fsm code. (CI = Configuration Information) + */ +static void lcp_resetci(fsm *f); /* Reset our CI */ +static int lcp_cilen(fsm *f); /* Return length of our CI */ +static void lcp_addci(fsm *f, u_char *ucp, int *lenp); /* Add our CI to pkt */ +static int lcp_ackci(fsm *f, u_char *p, int len); /* Peer ack'd our CI */ +static int lcp_nakci(fsm *f, u_char *p, int len, int treat_as_reject); /* Peer nak'd our CI */ +static int lcp_rejci(fsm *f, u_char *p, int len); /* Peer rej'd our CI */ +static int lcp_reqci(fsm *f, u_char *inp, int *lenp, int reject_if_disagree); /* Rcv peer CI */ +static void lcp_up(fsm *f); /* We're UP */ +static void lcp_down(fsm *f); /* We're DOWN */ +static void lcp_starting (fsm *); /* We need lower layer up */ +static void lcp_finished (fsm *); /* We need lower layer down */ +static int lcp_extcode(fsm *f, int code, int id, u_char *inp, int len); +static void lcp_rprotrej(fsm *f, u_char *inp, int len); + +/* + * routines to send LCP echos to peer + */ + +static void lcp_echo_lowerup(ppp_pcb *pcb); +static void lcp_echo_lowerdown(ppp_pcb *pcb); +static void LcpEchoTimeout(void *arg); +static void lcp_received_echo_reply(fsm *f, int id, u_char *inp, int len); +static void LcpSendEchoRequest(fsm *f); +static void LcpLinkFailure(fsm *f); +static void LcpEchoCheck(fsm *f); + +static const fsm_callbacks lcp_callbacks = { /* LCP callback routines */ + lcp_resetci, /* Reset our Configuration Information */ + lcp_cilen, /* Length of our Configuration Information */ + lcp_addci, /* Add our Configuration Information */ + lcp_ackci, /* ACK our Configuration Information */ + lcp_nakci, /* NAK our Configuration Information */ + lcp_rejci, /* Reject our Configuration Information */ + lcp_reqci, /* Request peer's Configuration Information */ + lcp_up, /* Called when fsm reaches OPENED state */ + lcp_down, /* Called when fsm leaves OPENED state */ + lcp_starting, /* Called when we want the lower layer up */ + lcp_finished, /* Called when we want the lower layer down */ + NULL, /* Called when Protocol-Reject received */ + NULL, /* Retransmission is necessary */ + lcp_extcode, /* Called to handle LCP-specific codes */ + "LCP" /* String name of protocol */ +}; + +/* + * Protocol entry points. + * Some of these are called directly. + */ + +static void lcp_init(ppp_pcb *pcb); +static void lcp_input(ppp_pcb *pcb, u_char *p, int len); +static void lcp_protrej(ppp_pcb *pcb); +#if PRINTPKT_SUPPORT +static int lcp_printpkt(const u_char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ + +const struct protent lcp_protent = { + PPP_LCP, + lcp_init, + lcp_input, + lcp_protrej, + lcp_lowerup, + lcp_lowerdown, + lcp_open, + lcp_close, +#if PRINTPKT_SUPPORT + lcp_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "LCP", + NULL, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + lcp_option_list, + NULL, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, + NULL +#endif /* DEMAND_SUPPORT */ +}; + +/* + * Length of each type of configuration option (in octets) + */ +#define CILEN_VOID 2 +#define CILEN_CHAR 3 +#define CILEN_SHORT 4 /* CILEN_VOID + 2 */ +#if CHAP_SUPPORT +#define CILEN_CHAP 5 /* CILEN_VOID + 2 + 1 */ +#endif /* CHAP_SUPPORT */ +#define CILEN_LONG 6 /* CILEN_VOID + 4 */ +#if LQR_SUPPORT +#define CILEN_LQR 8 /* CILEN_VOID + 2 + 4 */ +#endif /* LQR_SUPPORT */ +#define CILEN_CBCP 3 + +#define CODENAME(x) ((x) == CONFACK ? "ACK" : \ + (x) == CONFNAK ? "NAK" : "REJ") + +#if PPP_OPTIONS +/* + * noopt - Disable all options (why?). + */ +static int +noopt(argv) + char **argv; +{ + BZERO((char *) &lcp_wantoptions[0], sizeof (struct lcp_options)); + BZERO((char *) &lcp_allowoptions[0], sizeof (struct lcp_options)); + + return (1); +} +#endif /* PPP_OPTIONS */ + +#ifdef HAVE_MULTILINK +static int +setendpoint(argv) + char **argv; +{ + if (str_to_epdisc(&lcp_wantoptions[0].endpoint, *argv)) { + lcp_wantoptions[0].neg_endpoint = 1; + return 1; + } + option_error("Can't parse '%s' as an endpoint discriminator", *argv); + return 0; +} + +static void +printendpoint(opt, printer, arg) + option_t *opt; + void (*printer) (void *, char *, ...); + void *arg; +{ + printer(arg, "%s", epdisc_to_str(&lcp_wantoptions[0].endpoint)); +} +#endif /* HAVE_MULTILINK */ + +/* + * lcp_init - Initialize LCP. + */ +static void lcp_init(ppp_pcb *pcb) { + fsm *f = &pcb->lcp_fsm; + lcp_options *wo = &pcb->lcp_wantoptions; + lcp_options *ao = &pcb->lcp_allowoptions; + + f->pcb = pcb; + f->protocol = PPP_LCP; + f->callbacks = &lcp_callbacks; + + fsm_init(f); + + BZERO(wo, sizeof(*wo)); + wo->neg_mru = 1; + wo->mru = PPP_DEFMRU; + wo->neg_asyncmap = 1; + wo->neg_magicnumber = 1; + wo->neg_pcompression = 1; + wo->neg_accompression = 1; + + BZERO(ao, sizeof(*ao)); + ao->neg_mru = 1; + ao->mru = PPP_MAXMRU; + ao->neg_asyncmap = 1; +#if CHAP_SUPPORT + ao->neg_chap = 1; + ao->chap_mdtype = CHAP_MDTYPE_SUPPORTED; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + ao->neg_upap = 1; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + ao->neg_eap = 1; +#endif /* EAP_SUPPORT */ + ao->neg_magicnumber = 1; + ao->neg_pcompression = 1; + ao->neg_accompression = 1; + ao->neg_endpoint = 1; +} + + +/* + * lcp_open - LCP is allowed to come up. + */ +void lcp_open(ppp_pcb *pcb) { + fsm *f = &pcb->lcp_fsm; + lcp_options *wo = &pcb->lcp_wantoptions; + + f->flags &= ~(OPT_PASSIVE | OPT_SILENT); + if (wo->passive) + f->flags |= OPT_PASSIVE; + if (wo->silent) + f->flags |= OPT_SILENT; + fsm_open(f); +} + + +/* + * lcp_close - Take LCP down. + */ +void lcp_close(ppp_pcb *pcb, const char *reason) { + fsm *f = &pcb->lcp_fsm; + int oldstate; + + if (pcb->phase != PPP_PHASE_DEAD && pcb->phase != PPP_PHASE_MASTER) + new_phase(pcb, PPP_PHASE_TERMINATE); + + if (f->flags & DELAYED_UP) { + UNTIMEOUT(lcp_delayed_up, f); + f->state = PPP_FSM_STOPPED; + } + oldstate = f->state; + + fsm_close(f, reason); + if (oldstate == PPP_FSM_STOPPED && (f->flags & (OPT_PASSIVE|OPT_SILENT|DELAYED_UP))) { + /* + * This action is not strictly according to the FSM in RFC1548, + * but it does mean that the program terminates if you do a + * lcp_close() when a connection hasn't been established + * because we are in passive/silent mode or because we have + * delayed the fsm_lowerup() call and it hasn't happened yet. + */ + f->flags &= ~DELAYED_UP; + lcp_finished(f); + } +} + + +/* + * lcp_lowerup - The lower layer is up. + */ +void lcp_lowerup(ppp_pcb *pcb) { + lcp_options *wo = &pcb->lcp_wantoptions; + fsm *f = &pcb->lcp_fsm; + /* + * Don't use A/C or protocol compression on transmission, + * but accept A/C and protocol compressed packets + * if we are going to ask for A/C and protocol compression. + */ + if (ppp_send_config(pcb, PPP_MRU, 0xffffffff, 0, 0) < 0 + || ppp_recv_config(pcb, PPP_MRU, (pcb->settings.lax_recv? 0: 0xffffffff), + wo->neg_pcompression, wo->neg_accompression) < 0) + return; + pcb->peer_mru = PPP_MRU; + + if (pcb->settings.listen_time != 0) { + f->flags |= DELAYED_UP; + TIMEOUTMS(lcp_delayed_up, f, pcb->settings.listen_time); + } else + fsm_lowerup(f); +} + + +/* + * lcp_lowerdown - The lower layer is down. + */ +void lcp_lowerdown(ppp_pcb *pcb) { + fsm *f = &pcb->lcp_fsm; + + if (f->flags & DELAYED_UP) { + f->flags &= ~DELAYED_UP; + UNTIMEOUT(lcp_delayed_up, f); + } else + fsm_lowerdown(f); +} + + +/* + * lcp_delayed_up - Bring the lower layer up now. + */ +static void lcp_delayed_up(void *arg) { + fsm *f = (fsm*)arg; + + if (f->flags & DELAYED_UP) { + f->flags &= ~DELAYED_UP; + fsm_lowerup(f); + } +} + + +/* + * lcp_input - Input LCP packet. + */ +static void lcp_input(ppp_pcb *pcb, u_char *p, int len) { + fsm *f = &pcb->lcp_fsm; + + if (f->flags & DELAYED_UP) { + f->flags &= ~DELAYED_UP; + UNTIMEOUT(lcp_delayed_up, f); + fsm_lowerup(f); + } + fsm_input(f, p, len); +} + +/* + * lcp_extcode - Handle a LCP-specific code. + */ +static int lcp_extcode(fsm *f, int code, int id, u_char *inp, int len) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u_char *magp; + + switch( code ){ + case PROTREJ: + lcp_rprotrej(f, inp, len); + break; + + case ECHOREQ: + if (f->state != PPP_FSM_OPENED) + break; + magp = inp; + PUTLONG(go->magicnumber, magp); + fsm_sdata(f, ECHOREP, id, inp, len); + break; + + case ECHOREP: + lcp_received_echo_reply(f, id, inp, len); + break; + + case DISCREQ: + case IDENTIF: + case TIMEREM: + break; + + default: + return 0; + } + return 1; +} + + +/* + * lcp_rprotrej - Receive an Protocol-Reject. + * + * Figure out which protocol is rejected and inform it. + */ +static void lcp_rprotrej(fsm *f, u_char *inp, int len) { + int i; + const struct protent *protp; + u_short prot; +#if PPP_PROTOCOLNAME + const char *pname; +#endif /* PPP_PROTOCOLNAME */ + + if (len < 2) { + LCPDEBUG(("lcp_rprotrej: Rcvd short Protocol-Reject packet!")); + return; + } + + GETSHORT(prot, inp); + + /* + * Protocol-Reject packets received in any state other than the LCP + * OPENED state SHOULD be silently discarded. + */ + if( f->state != PPP_FSM_OPENED ){ + LCPDEBUG(("Protocol-Reject discarded: LCP in state %d", f->state)); + return; + } + +#if PPP_PROTOCOLNAME + pname = protocol_name(prot); +#endif /* PPP_PROTOCOLNAME */ + + /* + * Upcall the proper Protocol-Reject routine. + */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (protp->protocol == prot) { +#if PPP_PROTOCOLNAME + if (pname != NULL) + ppp_dbglog("Protocol-Reject for '%s' (0x%x) received", pname, + prot); + else +#endif /* PPP_PROTOCOLNAME */ + ppp_dbglog("Protocol-Reject for 0x%x received", prot); + (*protp->protrej)(f->pcb); + return; + } + +#if PPP_PROTOCOLNAME + if (pname != NULL) + ppp_warn("Protocol-Reject for unsupported protocol '%s' (0x%x)", pname, + prot); + else +#endif /* #if PPP_PROTOCOLNAME */ + ppp_warn("Protocol-Reject for unsupported protocol 0x%x", prot); +} + + +/* + * lcp_protrej - A Protocol-Reject was received. + */ +/*ARGSUSED*/ +static void lcp_protrej(ppp_pcb *pcb) { + /* + * Can't reject LCP! + */ + ppp_error("Received Protocol-Reject for LCP!"); + fsm_protreject(&pcb->lcp_fsm); +} + + +/* + * lcp_sprotrej - Send a Protocol-Reject for some protocol. + */ +void lcp_sprotrej(ppp_pcb *pcb, u_char *p, int len) { + fsm *f = &pcb->lcp_fsm; + /* + * Send back the protocol and the information field of the + * rejected packet. We only get here if LCP is in the OPENED state. + */ +#if 0 + p += 2; + len -= 2; +#endif + + fsm_sdata(f, PROTREJ, ++f->id, + p, len); +} + + +/* + * lcp_resetci - Reset our CI. + */ +static void lcp_resetci(fsm *f) { + ppp_pcb *pcb = f->pcb; + lcp_options *wo = &pcb->lcp_wantoptions; + lcp_options *go = &pcb->lcp_gotoptions; + lcp_options *ao = &pcb->lcp_allowoptions; + +#if PPP_AUTH_SUPPORT + + /* note: default value is true for allow options */ + if (pcb->settings.user && pcb->settings.passwd) { +#if PAP_SUPPORT + if (pcb->settings.refuse_pap) { + ao->neg_upap = 0; + } +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + if (pcb->settings.refuse_chap) { + ao->chap_mdtype &= ~MDTYPE_MD5; + } +#if MSCHAP_SUPPORT + if (pcb->settings.refuse_mschap) { + ao->chap_mdtype &= ~MDTYPE_MICROSOFT; + } + if (pcb->settings.refuse_mschap_v2) { + ao->chap_mdtype &= ~MDTYPE_MICROSOFT_V2; + } +#endif /* MSCHAP_SUPPORT */ + ao->neg_chap = (ao->chap_mdtype != MDTYPE_NONE); +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + if (pcb->settings.refuse_eap) { + ao->neg_eap = 0; + } +#endif /* EAP_SUPPORT */ + +#if PPP_SERVER + /* note: default value is false for wanted options */ + if (pcb->settings.auth_required) { +#if PAP_SUPPORT + if (!pcb->settings.refuse_pap) { + wo->neg_upap = 1; + } +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + if (!pcb->settings.refuse_chap) { + wo->chap_mdtype |= MDTYPE_MD5; + } +#if MSCHAP_SUPPORT + if (!pcb->settings.refuse_mschap) { + wo->chap_mdtype |= MDTYPE_MICROSOFT; + } + if (!pcb->settings.refuse_mschap_v2) { + wo->chap_mdtype |= MDTYPE_MICROSOFT_V2; + } +#endif /* MSCHAP_SUPPORT */ + wo->neg_chap = (wo->chap_mdtype != MDTYPE_NONE); +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + if (!pcb->settings.refuse_eap) { + wo->neg_eap = 1; + } +#endif /* EAP_SUPPORT */ + } +#endif /* PPP_SERVER */ + + } else { +#if PAP_SUPPORT + ao->neg_upap = 0; +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + ao->neg_chap = 0; + ao->chap_mdtype = MDTYPE_NONE; +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + ao->neg_eap = 0; +#endif /* EAP_SUPPORT */ + } + + PPPDEBUG(LOG_DEBUG, ("ppp: auth protocols:")); +#if PAP_SUPPORT + PPPDEBUG(LOG_DEBUG, (" PAP=%d", ao->neg_upap)); +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + PPPDEBUG(LOG_DEBUG, (" CHAP=%d CHAP_MD5=%d", ao->neg_chap, !!(ao->chap_mdtype&MDTYPE_MD5))); +#if MSCHAP_SUPPORT + PPPDEBUG(LOG_DEBUG, (" CHAP_MS=%d CHAP_MS2=%d", !!(ao->chap_mdtype&MDTYPE_MICROSOFT), !!(ao->chap_mdtype&MDTYPE_MICROSOFT_V2))); +#endif /* MSCHAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + PPPDEBUG(LOG_DEBUG, (" EAP=%d", ao->neg_eap)); +#endif /* EAP_SUPPORT */ + PPPDEBUG(LOG_DEBUG, ("\n")); + +#endif /* PPP_AUTH_SUPPORT */ + + wo->magicnumber = magic(); + wo->numloops = 0; + *go = *wo; +#ifdef HAVE_MULTILINK + if (!multilink) { + go->neg_mrru = 0; +#endif /* HAVE_MULTILINK */ + go->neg_ssnhf = 0; + go->neg_endpoint = 0; +#ifdef HAVE_MULTILINK + } +#endif /* HAVE_MULTILINK */ + if (pcb->settings.noendpoint) + ao->neg_endpoint = 0; + pcb->peer_mru = PPP_MRU; +#if 0 /* UNUSED */ + auth_reset(pcb); +#endif /* UNUSED */ +} + + +/* + * lcp_cilen - Return length of our CI. + */ +static int lcp_cilen(fsm *f) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + +#define LENCIVOID(neg) ((neg) ? CILEN_VOID : 0) +#if CHAP_SUPPORT +#define LENCICHAP(neg) ((neg) ? CILEN_CHAP : 0) +#endif /* CHAP_SUPPORT */ +#define LENCISHORT(neg) ((neg) ? CILEN_SHORT : 0) +#define LENCILONG(neg) ((neg) ? CILEN_LONG : 0) +#if LQR_SUPPORT +#define LENCILQR(neg) ((neg) ? CILEN_LQR: 0) +#endif /* LQR_SUPPORT */ +#define LENCICBCP(neg) ((neg) ? CILEN_CBCP: 0) + /* + * NB: we only ask for one of CHAP, UPAP, or EAP, even if we will + * accept more than one. We prefer EAP first, then CHAP, then + * PAP. + */ + return (LENCISHORT(go->neg_mru && go->mru != PPP_DEFMRU) + + LENCILONG(go->neg_asyncmap && go->asyncmap != 0xFFFFFFFF) + +#if EAP_SUPPORT + LENCISHORT(go->neg_eap) + +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT + LENCICHAP(!go->neg_eap && go->neg_chap) + +#endif /* EAP_SUPPORT */ +#if !EAP_SUPPORT + LENCICHAP(go->neg_chap) + +#endif /* !EAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT && CHAP_SUPPORT + LENCISHORT(!go->neg_eap && !go->neg_chap && go->neg_upap) + +#endif /* EAP_SUPPORT && CHAP_SUPPORT */ +#if EAP_SUPPORT && !CHAP_SUPPORT + LENCISHORT(!go->neg_eap && go->neg_upap) + +#endif /* EAP_SUPPORT && !CHAP_SUPPORT */ +#if !EAP_SUPPORT && CHAP_SUPPORT + LENCISHORT(!go->neg_chap && go->neg_upap) + +#endif /* !EAP_SUPPORT && CHAP_SUPPORT */ +#if !EAP_SUPPORT && !CHAP_SUPPORT + LENCISHORT(go->neg_upap) + +#endif /* !EAP_SUPPORT && !CHAP_SUPPORT */ +#endif /* PAP_SUPPORT */ +#if LQR_SUPPORT + LENCILQR(go->neg_lqr) + +#endif /* LQR_SUPPORT */ + LENCICBCP(go->neg_cbcp) + + LENCILONG(go->neg_magicnumber) + + LENCIVOID(go->neg_pcompression) + + LENCIVOID(go->neg_accompression) + +#ifdef HAVE_MULTILINK + LENCISHORT(go->neg_mrru) + +#endif /* HAVE_MULTILINK */ + LENCIVOID(go->neg_ssnhf) + + (go->neg_endpoint? CILEN_CHAR + go->endpoint.length: 0)); +} + + +/* + * lcp_addci - Add our desired CIs to a packet. + */ +static void lcp_addci(fsm *f, u_char *ucp, int *lenp) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u_char *start_ucp = ucp; + +#define ADDCIVOID(opt, neg) \ + if (neg) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_VOID, ucp); \ + } +#define ADDCISHORT(opt, neg, val) \ + if (neg) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_SHORT, ucp); \ + PUTSHORT(val, ucp); \ + } +#if CHAP_SUPPORT +#define ADDCICHAP(opt, neg, val) \ + if (neg) { \ + PUTCHAR((opt), ucp); \ + PUTCHAR(CILEN_CHAP, ucp); \ + PUTSHORT(PPP_CHAP, ucp); \ + PUTCHAR((CHAP_DIGEST(val)), ucp); \ + } +#endif /* CHAP_SUPPORT */ +#define ADDCILONG(opt, neg, val) \ + if (neg) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_LONG, ucp); \ + PUTLONG(val, ucp); \ + } +#if LQR_SUPPORT +#define ADDCILQR(opt, neg, val) \ + if (neg) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_LQR, ucp); \ + PUTSHORT(PPP_LQR, ucp); \ + PUTLONG(val, ucp); \ + } +#endif /* LQR_SUPPORT */ +#define ADDCICHAR(opt, neg, val) \ + if (neg) { \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_CHAR, ucp); \ + PUTCHAR(val, ucp); \ + } +#define ADDCIENDP(opt, neg, class, val, len) \ + if (neg) { \ + int i; \ + PUTCHAR(opt, ucp); \ + PUTCHAR(CILEN_CHAR + len, ucp); \ + PUTCHAR(class, ucp); \ + for (i = 0; i < len; ++i) \ + PUTCHAR(val[i], ucp); \ + } + + ADDCISHORT(CI_MRU, go->neg_mru && go->mru != PPP_DEFMRU, go->mru); + ADDCILONG(CI_ASYNCMAP, go->neg_asyncmap && go->asyncmap != 0xFFFFFFFF, + go->asyncmap); +#if EAP_SUPPORT + ADDCISHORT(CI_AUTHTYPE, go->neg_eap, PPP_EAP); +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT + ADDCICHAP(CI_AUTHTYPE, !go->neg_eap && go->neg_chap, go->chap_mdtype); +#endif /* EAP_SUPPORT */ +#if !EAP_SUPPORT + ADDCICHAP(CI_AUTHTYPE, go->neg_chap, go->chap_mdtype); +#endif /* !EAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT && CHAP_SUPPORT + ADDCISHORT(CI_AUTHTYPE, !go->neg_eap && !go->neg_chap && go->neg_upap, PPP_PAP); +#endif /* EAP_SUPPORT && CHAP_SUPPORT */ +#if EAP_SUPPORT && !CHAP_SUPPORT + ADDCISHORT(CI_AUTHTYPE, !go->neg_eap && go->neg_upap, PPP_PAP); +#endif /* EAP_SUPPORT && !CHAP_SUPPORT */ +#if !EAP_SUPPORT && CHAP_SUPPORT + ADDCISHORT(CI_AUTHTYPE, !go->neg_chap && go->neg_upap, PPP_PAP); +#endif /* !EAP_SUPPORT && CHAP_SUPPORT */ +#if !EAP_SUPPORT && !CHAP_SUPPORT + ADDCISHORT(CI_AUTHTYPE, go->neg_upap, PPP_PAP); +#endif /* !EAP_SUPPORT && !CHAP_SUPPORT */ +#endif /* PAP_SUPPORT */ +#if LQR_SUPPORT + ADDCILQR(CI_QUALITY, go->neg_lqr, go->lqr_period); +#endif /* LQR_SUPPORT */ + ADDCICHAR(CI_CALLBACK, go->neg_cbcp, CBCP_OPT); + ADDCILONG(CI_MAGICNUMBER, go->neg_magicnumber, go->magicnumber); + ADDCIVOID(CI_PCOMPRESSION, go->neg_pcompression); + ADDCIVOID(CI_ACCOMPRESSION, go->neg_accompression); +#ifdef HAVE_MULTILINK + ADDCISHORT(CI_MRRU, go->neg_mrru, go->mrru); +#endif + ADDCIVOID(CI_SSNHF, go->neg_ssnhf); + ADDCIENDP(CI_EPDISC, go->neg_endpoint, go->endpoint.class_, + go->endpoint.value, go->endpoint.length); + + if (ucp - start_ucp != *lenp) { + /* this should never happen, because peer_mtu should be 1500 */ + ppp_error("Bug in lcp_addci: wrong length"); + } +} + + +/* + * lcp_ackci - Ack our CIs. + * This should not modify any state if the Ack is bad. + * + * Returns: + * 0 - Ack was bad. + * 1 - Ack was good. + */ +static int lcp_ackci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u_char cilen, citype, cichar; + u_short cishort; + u32_t cilong; + + /* + * CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define ACKCIVOID(opt, neg) \ + if (neg) { \ + if ((len -= CILEN_VOID) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_VOID || \ + citype != opt) \ + goto bad; \ + } +#define ACKCISHORT(opt, neg, val) \ + if (neg) { \ + if ((len -= CILEN_SHORT) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_SHORT || \ + citype != opt) \ + goto bad; \ + GETSHORT(cishort, p); \ + if (cishort != val) \ + goto bad; \ + } +#define ACKCICHAR(opt, neg, val) \ + if (neg) { \ + if ((len -= CILEN_CHAR) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_CHAR || \ + citype != opt) \ + goto bad; \ + GETCHAR(cichar, p); \ + if (cichar != val) \ + goto bad; \ + } +#if CHAP_SUPPORT +#define ACKCICHAP(opt, neg, val) \ + if (neg) { \ + if ((len -= CILEN_CHAP) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_CHAP || \ + citype != (opt)) \ + goto bad; \ + GETSHORT(cishort, p); \ + if (cishort != PPP_CHAP) \ + goto bad; \ + GETCHAR(cichar, p); \ + if (cichar != (CHAP_DIGEST(val))) \ + goto bad; \ + } +#endif /* CHAP_SUPPORT */ +#define ACKCILONG(opt, neg, val) \ + if (neg) { \ + if ((len -= CILEN_LONG) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_LONG || \ + citype != opt) \ + goto bad; \ + GETLONG(cilong, p); \ + if (cilong != val) \ + goto bad; \ + } +#if LQR_SUPPORT +#define ACKCILQR(opt, neg, val) \ + if (neg) { \ + if ((len -= CILEN_LQR) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_LQR || \ + citype != opt) \ + goto bad; \ + GETSHORT(cishort, p); \ + if (cishort != PPP_LQR) \ + goto bad; \ + GETLONG(cilong, p); \ + if (cilong != val) \ + goto bad; \ + } +#endif /* LQR_SUPPORT */ +#define ACKCIENDP(opt, neg, class, val, vlen) \ + if (neg) { \ + int i; \ + if ((len -= CILEN_CHAR + vlen) < 0) \ + goto bad; \ + GETCHAR(citype, p); \ + GETCHAR(cilen, p); \ + if (cilen != CILEN_CHAR + vlen || \ + citype != opt) \ + goto bad; \ + GETCHAR(cichar, p); \ + if (cichar != class) \ + goto bad; \ + for (i = 0; i < vlen; ++i) { \ + GETCHAR(cichar, p); \ + if (cichar != val[i]) \ + goto bad; \ + } \ + } + + ACKCISHORT(CI_MRU, go->neg_mru && go->mru != PPP_DEFMRU, go->mru); + ACKCILONG(CI_ASYNCMAP, go->neg_asyncmap && go->asyncmap != 0xFFFFFFFF, + go->asyncmap); +#if EAP_SUPPORT + ACKCISHORT(CI_AUTHTYPE, go->neg_eap, PPP_EAP); +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT + ACKCICHAP(CI_AUTHTYPE, !go->neg_eap && go->neg_chap, go->chap_mdtype); +#endif /* EAP_SUPPORT */ +#if !EAP_SUPPORT + ACKCICHAP(CI_AUTHTYPE, go->neg_chap, go->chap_mdtype); +#endif /* !EAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT /* cannot be improved, embedding a directive within macro arguments is not portable */ +#if EAP_SUPPORT && CHAP_SUPPORT + ACKCISHORT(CI_AUTHTYPE, !go->neg_eap && !go->neg_chap && go->neg_upap, PPP_PAP); +#endif /* EAP_SUPPORT && CHAP_SUPPORT */ +#if EAP_SUPPORT && !CHAP_SUPPORT + ACKCISHORT(CI_AUTHTYPE, !go->neg_eap && go->neg_upap, PPP_PAP); +#endif /* EAP_SUPPORT && !CHAP_SUPPORT */ +#if !EAP_SUPPORT && CHAP_SUPPORT + ACKCISHORT(CI_AUTHTYPE, !go->neg_chap && go->neg_upap, PPP_PAP); +#endif /* !EAP_SUPPORT && CHAP_SUPPORT */ +#if !EAP_SUPPORT && !CHAP_SUPPORT + ACKCISHORT(CI_AUTHTYPE, go->neg_upap, PPP_PAP); +#endif /* !EAP_SUPPORT && !CHAP_SUPPORT */ +#endif /* PAP_SUPPORT */ +#if LQR_SUPPORT + ACKCILQR(CI_QUALITY, go->neg_lqr, go->lqr_period); +#endif /* LQR_SUPPORT */ + ACKCICHAR(CI_CALLBACK, go->neg_cbcp, CBCP_OPT); + ACKCILONG(CI_MAGICNUMBER, go->neg_magicnumber, go->magicnumber); + ACKCIVOID(CI_PCOMPRESSION, go->neg_pcompression); + ACKCIVOID(CI_ACCOMPRESSION, go->neg_accompression); +#ifdef HAVE_MULTILINK + ACKCISHORT(CI_MRRU, go->neg_mrru, go->mrru); +#endif /* HAVE_MULTILINK */ + ACKCIVOID(CI_SSNHF, go->neg_ssnhf); + ACKCIENDP(CI_EPDISC, go->neg_endpoint, go->endpoint.class_, + go->endpoint.value, go->endpoint.length); + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + return (1); +bad: + LCPDEBUG(("lcp_acki: received bad Ack!")); + return (0); +} + + +/* + * lcp_nakci - Peer has sent a NAK for some of our CIs. + * This should not modify any state if the Nak is bad + * or if LCP is in the OPENED state. + * + * Returns: + * 0 - Nak was bad. + * 1 - Nak was good. + */ +static int lcp_nakci(fsm *f, u_char *p, int len, int treat_as_reject) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + lcp_options *wo = &pcb->lcp_wantoptions; + u_char citype, cichar, *next; + u_short cishort; + u32_t cilong; + lcp_options no; /* options we've seen Naks for */ + lcp_options try_; /* options to request next time */ + int looped_back = 0; + int cilen; + + BZERO(&no, sizeof(no)); + try_ = *go; + + /* + * Any Nak'd CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define NAKCIVOID(opt, neg) \ + if (go->neg && \ + len >= CILEN_VOID && \ + p[1] == CILEN_VOID && \ + p[0] == opt) { \ + len -= CILEN_VOID; \ + INCPTR(CILEN_VOID, p); \ + no.neg = 1; \ + try_.neg = 0; \ + } +#if CHAP_SUPPORT +#define NAKCICHAP(opt, neg, code) \ + if (go->neg && \ + len >= CILEN_CHAP && \ + p[1] == CILEN_CHAP && \ + p[0] == opt) { \ + len -= CILEN_CHAP; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETCHAR(cichar, p); \ + no.neg = 1; \ + code \ + } +#endif /* CHAP_SUPPORT */ +#define NAKCICHAR(opt, neg, code) \ + if (go->neg && \ + len >= CILEN_CHAR && \ + p[1] == CILEN_CHAR && \ + p[0] == opt) { \ + len -= CILEN_CHAR; \ + INCPTR(2, p); \ + GETCHAR(cichar, p); \ + no.neg = 1; \ + code \ + } +#define NAKCISHORT(opt, neg, code) \ + if (go->neg && \ + len >= CILEN_SHORT && \ + p[1] == CILEN_SHORT && \ + p[0] == opt) { \ + len -= CILEN_SHORT; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + no.neg = 1; \ + code \ + } +#define NAKCILONG(opt, neg, code) \ + if (go->neg && \ + len >= CILEN_LONG && \ + p[1] == CILEN_LONG && \ + p[0] == opt) { \ + len -= CILEN_LONG; \ + INCPTR(2, p); \ + GETLONG(cilong, p); \ + no.neg = 1; \ + code \ + } +#if LQR_SUPPORT +#define NAKCILQR(opt, neg, code) \ + if (go->neg && \ + len >= CILEN_LQR && \ + p[1] == CILEN_LQR && \ + p[0] == opt) { \ + len -= CILEN_LQR; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETLONG(cilong, p); \ + no.neg = 1; \ + code \ + } +#endif /* LQR_SUPPORT */ +#define NAKCIENDP(opt, neg) \ + if (go->neg && \ + len >= CILEN_CHAR && \ + p[0] == opt && \ + p[1] >= CILEN_CHAR && \ + p[1] <= len) { \ + len -= p[1]; \ + INCPTR(p[1], p); \ + no.neg = 1; \ + try_.neg = 0; \ + } + + /* + * NOTE! There must be no assignments to individual fields of *go in + * the code below. Any such assignment is a BUG! + */ + /* + * We don't care if they want to send us smaller packets than + * we want. Therefore, accept any MRU less than what we asked for, + * but then ignore the new value when setting the MRU in the kernel. + * If they send us a bigger MRU than what we asked, accept it, up to + * the limit of the default MRU we'd get if we didn't negotiate. + */ + if (go->neg_mru && go->mru != PPP_DEFMRU) { + NAKCISHORT(CI_MRU, neg_mru, + if (cishort <= wo->mru || cishort <= PPP_DEFMRU) + try_.mru = cishort; + ); + } + + /* + * Add any characters they want to our (receive-side) asyncmap. + */ + if (go->neg_asyncmap && go->asyncmap != 0xFFFFFFFF) { + NAKCILONG(CI_ASYNCMAP, neg_asyncmap, + try_.asyncmap = go->asyncmap | cilong; + ); + } + + /* + * If they've nak'd our authentication-protocol, check whether + * they are proposing a different protocol, or a different + * hash algorithm for CHAP. + */ + if ((0 +#if CHAP_SUPPORT + || go->neg_chap +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + || go->neg_upap +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + || go->neg_eap +#endif /* EAP_SUPPORT */ + ) + && len >= CILEN_SHORT + && p[0] == CI_AUTHTYPE && p[1] >= CILEN_SHORT && p[1] <= len) { + cilen = p[1]; + len -= cilen; +#if CHAP_SUPPORT + no.neg_chap = go->neg_chap; +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + no.neg_upap = go->neg_upap; +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + no.neg_eap = go->neg_eap; +#endif /* EAP_SUPPORT */ + INCPTR(2, p); + GETSHORT(cishort, p); + +#if PAP_SUPPORT + if (cishort == PPP_PAP && cilen == CILEN_SHORT) { +#if EAP_SUPPORT + /* If we were asking for EAP, then we need to stop that. */ + if (go->neg_eap) + try_.neg_eap = 0; + else +#endif /* EAP_SUPPORT */ + +#if CHAP_SUPPORT + /* If we were asking for CHAP, then we need to stop that. */ + if (go->neg_chap) + try_.neg_chap = 0; + else +#endif /* CHAP_SUPPORT */ + + /* + * If we weren't asking for CHAP or EAP, then we were asking for + * PAP, in which case this Nak is bad. + */ + goto bad; + } else +#endif /* PAP_SUPPORT */ + +#if CHAP_SUPPORT + if (cishort == PPP_CHAP && cilen == CILEN_CHAP) { + GETCHAR(cichar, p); +#if EAP_SUPPORT + /* Stop asking for EAP, if we were. */ + if (go->neg_eap) { + try_.neg_eap = 0; + /* Try to set up to use their suggestion, if possible */ + if (CHAP_CANDIGEST(go->chap_mdtype, cichar)) + try_.chap_mdtype = CHAP_MDTYPE_D(cichar); + } else +#endif /* EAP_SUPPORT */ + if (go->neg_chap) { + /* + * We were asking for our preferred algorithm, they must + * want something different. + */ + if (cichar != CHAP_DIGEST(go->chap_mdtype)) { + if (CHAP_CANDIGEST(go->chap_mdtype, cichar)) { + /* Use their suggestion if we support it ... */ + try_.chap_mdtype = CHAP_MDTYPE_D(cichar); + } else { + /* ... otherwise, try our next-preferred algorithm. */ + try_.chap_mdtype &= ~(CHAP_MDTYPE(try_.chap_mdtype)); + if (try_.chap_mdtype == MDTYPE_NONE) /* out of algos */ + try_.neg_chap = 0; + } + } else { + /* + * Whoops, they Nak'd our algorithm of choice + * but then suggested it back to us. + */ + goto bad; + } + } else { + /* + * Stop asking for PAP if we were asking for it. + */ +#if PAP_SUPPORT + try_.neg_upap = 0; +#endif /* PAP_SUPPORT */ + } + + } else +#endif /* CHAP_SUPPORT */ + { + +#if EAP_SUPPORT + /* + * If we were asking for EAP, and they're Conf-Naking EAP, + * well, that's just strange. Nobody should do that. + */ + if (cishort == PPP_EAP && cilen == CILEN_SHORT && go->neg_eap) + ppp_dbglog("Unexpected Conf-Nak for EAP"); + + /* + * We don't recognize what they're suggesting. + * Stop asking for what we were asking for. + */ + if (go->neg_eap) + try_.neg_eap = 0; + else +#endif /* EAP_SUPPORT */ + +#if CHAP_SUPPORT + if (go->neg_chap) + try_.neg_chap = 0; + else +#endif /* CHAP_SUPPORT */ + +#if PAP_SUPPORT + if(1) + try_.neg_upap = 0; + else +#endif /* PAP_SUPPORT */ + {} + + p += cilen - CILEN_SHORT; + } + } + +#if LQR_SUPPORT + /* + * If they can't cope with our link quality protocol, we'll have + * to stop asking for LQR. We haven't got any other protocol. + * If they Nak the reporting period, take their value XXX ? + */ + NAKCILQR(CI_QUALITY, neg_lqr, + if (cishort != PPP_LQR) + try_.neg_lqr = 0; + else + try_.lqr_period = cilong; + ); +#endif /* LQR_SUPPORT */ + + /* + * Only implementing CBCP...not the rest of the callback options + */ + NAKCICHAR(CI_CALLBACK, neg_cbcp, + try_.neg_cbcp = 0; + (void)cichar; /* if CHAP support is not compiled, cichar is set but not used, which makes some compilers complaining */ + ); + + /* + * Check for a looped-back line. + */ + NAKCILONG(CI_MAGICNUMBER, neg_magicnumber, + try_.magicnumber = magic(); + looped_back = 1; + ); + + /* + * Peer shouldn't send Nak for protocol compression or + * address/control compression requests; they should send + * a Reject instead. If they send a Nak, treat it as a Reject. + */ + NAKCIVOID(CI_PCOMPRESSION, neg_pcompression); + NAKCIVOID(CI_ACCOMPRESSION, neg_accompression); + +#ifdef HAVE_MULTILINK + /* + * Nak for MRRU option - accept their value if it is smaller + * than the one we want. + */ + if (go->neg_mrru) { + NAKCISHORT(CI_MRRU, neg_mrru, + if (treat_as_reject) + try_.neg_mrru = 0; + else if (cishort <= wo->mrru) + try_.mrru = cishort; + ); + } +#else /* HAVE_MULTILINK */ + LWIP_UNUSED_ARG(treat_as_reject); +#endif /* HAVE_MULTILINK */ + + /* + * Nak for short sequence numbers shouldn't be sent, treat it + * like a reject. + */ + NAKCIVOID(CI_SSNHF, neg_ssnhf); + + /* + * Nak of the endpoint discriminator option is not permitted, + * treat it like a reject. + */ + NAKCIENDP(CI_EPDISC, neg_endpoint); + + /* + * There may be remaining CIs, if the peer is requesting negotiation + * on an option that we didn't include in our request packet. + * If we see an option that we requested, or one we've already seen + * in this packet, then this packet is bad. + * If we wanted to respond by starting to negotiate on the requested + * option(s), we could, but we don't, because except for the + * authentication type and quality protocol, if we are not negotiating + * an option, it is because we were told not to. + * For the authentication type, the Nak from the peer means + * `let me authenticate myself with you' which is a bit pointless. + * For the quality protocol, the Nak means `ask me to send you quality + * reports', but if we didn't ask for them, we don't want them. + * An option we don't recognize represents the peer asking to + * negotiate some option we don't support, so ignore it. + */ + while (len >= CILEN_VOID) { + GETCHAR(citype, p); + GETCHAR(cilen, p); + if (cilen < CILEN_VOID || (len -= cilen) < 0) + goto bad; + next = p + cilen - 2; + + switch (citype) { + case CI_MRU: + if ((go->neg_mru && go->mru != PPP_DEFMRU) + || no.neg_mru || cilen != CILEN_SHORT) + goto bad; + GETSHORT(cishort, p); + if (cishort < PPP_DEFMRU) { + try_.neg_mru = 1; + try_.mru = cishort; + } + break; + case CI_ASYNCMAP: + if ((go->neg_asyncmap && go->asyncmap != 0xFFFFFFFF) + || no.neg_asyncmap || cilen != CILEN_LONG) + goto bad; + break; + case CI_AUTHTYPE: + if (0 +#if CHAP_SUPPORT + || go->neg_chap || no.neg_chap +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + || go->neg_upap || no.neg_upap +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + || go->neg_eap || no.neg_eap +#endif /* EAP_SUPPORT */ + ) + goto bad; + break; + case CI_MAGICNUMBER: + if (go->neg_magicnumber || no.neg_magicnumber || + cilen != CILEN_LONG) + goto bad; + break; + case CI_PCOMPRESSION: + if (go->neg_pcompression || no.neg_pcompression + || cilen != CILEN_VOID) + goto bad; + break; + case CI_ACCOMPRESSION: + if (go->neg_accompression || no.neg_accompression + || cilen != CILEN_VOID) + goto bad; + break; +#if LQR_SUPPORT + case CI_QUALITY: + if (go->neg_lqr || no.neg_lqr || cilen != CILEN_LQR) + goto bad; + break; +#endif /* LQR_SUPPORT */ +#ifdef HAVE_MULTILINK + case CI_MRRU: + if (go->neg_mrru || no.neg_mrru || cilen != CILEN_SHORT) + goto bad; + break; +#endif /* HAVE_MULTILINK */ + case CI_SSNHF: + if (go->neg_ssnhf || no.neg_ssnhf || cilen != CILEN_VOID) + goto bad; + try_.neg_ssnhf = 1; + break; + case CI_EPDISC: + if (go->neg_endpoint || no.neg_endpoint || cilen < CILEN_CHAR) + goto bad; + break; + default: + break; + } + p = next; + } + + /* + * OK, the Nak is good. Now we can update state. + * If there are any options left we ignore them. + */ + if (f->state != PPP_FSM_OPENED) { + if (looped_back) { + if (++try_.numloops >= pcb->settings.lcp_loopbackfail) { + ppp_notice("Serial line is looped back."); + pcb->err_code = PPPERR_LOOPBACK; + lcp_close(f->pcb, "Loopback detected"); + } + } else + try_.numloops = 0; + *go = try_; + } + + return 1; + +bad: + LCPDEBUG(("lcp_nakci: received bad Nak!")); + return 0; +} + + +/* + * lcp_rejci - Peer has Rejected some of our CIs. + * This should not modify any state if the Reject is bad + * or if LCP is in the OPENED state. + * + * Returns: + * 0 - Reject was bad. + * 1 - Reject was good. + */ +static int lcp_rejci(fsm *f, u_char *p, int len) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u_char cichar; + u_short cishort; + u32_t cilong; + lcp_options try_; /* options to request next time */ + + try_ = *go; + + /* + * Any Rejected CIs must be in exactly the same order that we sent. + * Check packet length and CI length at each step. + * If we find any deviations, then this packet is bad. + */ +#define REJCIVOID(opt, neg) \ + if (go->neg && \ + len >= CILEN_VOID && \ + p[1] == CILEN_VOID && \ + p[0] == opt) { \ + len -= CILEN_VOID; \ + INCPTR(CILEN_VOID, p); \ + try_.neg = 0; \ + } +#define REJCISHORT(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_SHORT && \ + p[1] == CILEN_SHORT && \ + p[0] == opt) { \ + len -= CILEN_SHORT; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + /* Check rejected value. */ \ + if (cishort != val) \ + goto bad; \ + try_.neg = 0; \ + } + +#if CHAP_SUPPORT && EAP_SUPPORT && PAP_SUPPORT +#define REJCICHAP(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_CHAP && \ + p[1] == CILEN_CHAP && \ + p[0] == opt) { \ + len -= CILEN_CHAP; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETCHAR(cichar, p); \ + /* Check rejected value. */ \ + if ((cishort != PPP_CHAP) || (cichar != (CHAP_DIGEST(val)))) \ + goto bad; \ + try_.neg = 0; \ + try_.neg_eap = try_.neg_upap = 0; \ + } +#endif /* CHAP_SUPPORT && EAP_SUPPORT && PAP_SUPPORT */ + +#if CHAP_SUPPORT && !EAP_SUPPORT && PAP_SUPPORT +#define REJCICHAP(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_CHAP && \ + p[1] == CILEN_CHAP && \ + p[0] == opt) { \ + len -= CILEN_CHAP; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETCHAR(cichar, p); \ + /* Check rejected value. */ \ + if ((cishort != PPP_CHAP) || (cichar != (CHAP_DIGEST(val)))) \ + goto bad; \ + try_.neg = 0; \ + try_.neg_upap = 0; \ + } +#endif /* CHAP_SUPPORT && !EAP_SUPPORT && PAP_SUPPORT */ + +#if CHAP_SUPPORT && EAP_SUPPORT && !PAP_SUPPORT +#define REJCICHAP(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_CHAP && \ + p[1] == CILEN_CHAP && \ + p[0] == opt) { \ + len -= CILEN_CHAP; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETCHAR(cichar, p); \ + /* Check rejected value. */ \ + if ((cishort != PPP_CHAP) || (cichar != (CHAP_DIGEST(val)))) \ + goto bad; \ + try_.neg = 0; \ + try_.neg_eap = 0; \ + } +#endif /* CHAP_SUPPORT && EAP_SUPPORT && !PAP_SUPPORT */ + +#if CHAP_SUPPORT && !EAP_SUPPORT && !PAP_SUPPORT +#define REJCICHAP(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_CHAP && \ + p[1] == CILEN_CHAP && \ + p[0] == opt) { \ + len -= CILEN_CHAP; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETCHAR(cichar, p); \ + /* Check rejected value. */ \ + if ((cishort != PPP_CHAP) || (cichar != (CHAP_DIGEST(val)))) \ + goto bad; \ + try_.neg = 0; \ + } +#endif /* CHAP_SUPPORT && !EAP_SUPPORT && !PAP_SUPPORT */ + +#define REJCILONG(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_LONG && \ + p[1] == CILEN_LONG && \ + p[0] == opt) { \ + len -= CILEN_LONG; \ + INCPTR(2, p); \ + GETLONG(cilong, p); \ + /* Check rejected value. */ \ + if (cilong != val) \ + goto bad; \ + try_.neg = 0; \ + } +#if LQR_SUPPORT +#define REJCILQR(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_LQR && \ + p[1] == CILEN_LQR && \ + p[0] == opt) { \ + len -= CILEN_LQR; \ + INCPTR(2, p); \ + GETSHORT(cishort, p); \ + GETLONG(cilong, p); \ + /* Check rejected value. */ \ + if (cishort != PPP_LQR || cilong != val) \ + goto bad; \ + try_.neg = 0; \ + } +#endif /* LQR_SUPPORT */ +#define REJCICBCP(opt, neg, val) \ + if (go->neg && \ + len >= CILEN_CBCP && \ + p[1] == CILEN_CBCP && \ + p[0] == opt) { \ + len -= CILEN_CBCP; \ + INCPTR(2, p); \ + GETCHAR(cichar, p); \ + /* Check rejected value. */ \ + if (cichar != val) \ + goto bad; \ + try_.neg = 0; \ + } +#define REJCIENDP(opt, neg, class, val, vlen) \ + if (go->neg && \ + len >= CILEN_CHAR + vlen && \ + p[0] == opt && \ + p[1] == CILEN_CHAR + vlen) { \ + int i; \ + len -= CILEN_CHAR + vlen; \ + INCPTR(2, p); \ + GETCHAR(cichar, p); \ + if (cichar != class) \ + goto bad; \ + for (i = 0; i < vlen; ++i) { \ + GETCHAR(cichar, p); \ + if (cichar != val[i]) \ + goto bad; \ + } \ + try_.neg = 0; \ + } + + REJCISHORT(CI_MRU, neg_mru, go->mru); + REJCILONG(CI_ASYNCMAP, neg_asyncmap, go->asyncmap); +#if EAP_SUPPORT + REJCISHORT(CI_AUTHTYPE, neg_eap, PPP_EAP); + if (!go->neg_eap) { +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT + REJCICHAP(CI_AUTHTYPE, neg_chap, go->chap_mdtype); + if (!go->neg_chap) { +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + REJCISHORT(CI_AUTHTYPE, neg_upap, PPP_PAP); +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + } +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + } +#endif /* EAP_SUPPORT */ +#if LQR_SUPPORT + REJCILQR(CI_QUALITY, neg_lqr, go->lqr_period); +#endif /* LQR_SUPPORT */ + REJCICBCP(CI_CALLBACK, neg_cbcp, CBCP_OPT); + REJCILONG(CI_MAGICNUMBER, neg_magicnumber, go->magicnumber); + REJCIVOID(CI_PCOMPRESSION, neg_pcompression); + REJCIVOID(CI_ACCOMPRESSION, neg_accompression); +#ifdef HAVE_MULTILINK + REJCISHORT(CI_MRRU, neg_mrru, go->mrru); +#endif /* HAVE_MULTILINK */ + REJCIVOID(CI_SSNHF, neg_ssnhf); + REJCIENDP(CI_EPDISC, neg_endpoint, go->endpoint.class_, + go->endpoint.value, go->endpoint.length); + + /* + * If there are any remaining CIs, then this packet is bad. + */ + if (len != 0) + goto bad; + /* + * Now we can update state. + */ + if (f->state != PPP_FSM_OPENED) + *go = try_; + return 1; + +bad: + LCPDEBUG(("lcp_rejci: received bad Reject!")); + return 0; +} + + +/* + * lcp_reqci - Check the peer's requested CIs and send appropriate response. + * + * Returns: CONFACK, CONFNAK or CONFREJ and input packet modified + * appropriately. If reject_if_disagree is non-zero, doesn't return + * CONFNAK; returns CONFREJ if it can't return CONFACK. + * + * inp = Requested CIs + * lenp = Length of requested CIs + */ +static int lcp_reqci(fsm *f, u_char *inp, int *lenp, int reject_if_disagree) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + lcp_options *ho = &pcb->lcp_hisoptions; + lcp_options *ao = &pcb->lcp_allowoptions; + u_char *cip, *next; /* Pointer to current and next CIs */ + int cilen, citype, cichar; /* Parsed len, type, char value */ + u_short cishort; /* Parsed short value */ + u32_t cilong; /* Parse long value */ + int rc = CONFACK; /* Final packet return code */ + int orc; /* Individual option return code */ + u_char *p; /* Pointer to next char to parse */ + u_char *rejp; /* Pointer to next char in reject frame */ + struct pbuf *nakp; /* Nak buffer */ + u_char *nakoutp; /* Pointer to next char in Nak frame */ + int l = *lenp; /* Length left */ + + /* + * Reset all his options. + */ + BZERO(ho, sizeof(*ho)); + + /* + * Process all his options. + */ + next = inp; + nakp = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_CTRL_PBUF_MAX_SIZE), PPP_CTRL_PBUF_TYPE); + if(NULL == nakp) + return 0; + if(nakp->tot_len != nakp->len) { + pbuf_free(nakp); + return 0; + } + + nakoutp = (u_char*)nakp->payload; + rejp = inp; + while (l) { + orc = CONFACK; /* Assume success */ + cip = p = next; /* Remember begining of CI */ + if (l < 2 || /* Not enough data for CI header or */ + p[1] < 2 || /* CI length too small or */ + p[1] > l) { /* CI length too big? */ + LCPDEBUG(("lcp_reqci: bad CI length!")); + orc = CONFREJ; /* Reject bad CI */ + cilen = l; /* Reject till end of packet */ + l = 0; /* Don't loop again */ + citype = 0; + goto endswitch; + } + GETCHAR(citype, p); /* Parse CI type */ + GETCHAR(cilen, p); /* Parse CI length */ + l -= cilen; /* Adjust remaining length */ + next += cilen; /* Step to next CI */ + + switch (citype) { /* Check CI type */ + case CI_MRU: + if (!ao->neg_mru || /* Allow option? */ + cilen != CILEN_SHORT) { /* Check CI length */ + orc = CONFREJ; /* Reject CI */ + break; + } + GETSHORT(cishort, p); /* Parse MRU */ + + /* + * He must be able to receive at least our minimum. + * No need to check a maximum. If he sends a large number, + * we'll just ignore it. + */ + if (cishort < PPP_MINMRU) { + orc = CONFNAK; /* Nak CI */ + PUTCHAR(CI_MRU, nakoutp); + PUTCHAR(CILEN_SHORT, nakoutp); + PUTSHORT(PPP_MINMRU, nakoutp); /* Give him a hint */ + break; + } + ho->neg_mru = 1; /* Remember he sent MRU */ + ho->mru = cishort; /* And remember value */ + break; + + case CI_ASYNCMAP: + if (!ao->neg_asyncmap || + cilen != CILEN_LONG) { + orc = CONFREJ; + break; + } + GETLONG(cilong, p); + + /* + * Asyncmap must have set at least the bits + * which are set in lcp_allowoptions[unit].asyncmap. + */ + if ((ao->asyncmap & ~cilong) != 0) { + orc = CONFNAK; + PUTCHAR(CI_ASYNCMAP, nakoutp); + PUTCHAR(CILEN_LONG, nakoutp); + PUTLONG(ao->asyncmap | cilong, nakoutp); + break; + } + ho->neg_asyncmap = 1; + ho->asyncmap = cilong; + break; + + case CI_AUTHTYPE: + if (cilen < CILEN_SHORT || + !(0 +#if PAP_SUPPORT + || ao->neg_upap +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + || ao->neg_chap +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + || ao->neg_eap +#endif /* EAP_SUPPORT */ + )) { + /* + * Reject the option if we're not willing to authenticate. + */ + ppp_dbglog("No auth is possible"); + orc = CONFREJ; + break; + } + GETSHORT(cishort, p); + + /* + * Authtype must be PAP, CHAP, or EAP. + * + * Note: if more than one of ao->neg_upap, ao->neg_chap, and + * ao->neg_eap are set, and the peer sends a Configure-Request + * with two or more authenticate-protocol requests, then we will + * reject the second request. + * Whether we end up doing CHAP, UPAP, or EAP depends then on + * the ordering of the CIs in the peer's Configure-Request. + */ + +#if PAP_SUPPORT + if (cishort == PPP_PAP) { + /* we've already accepted CHAP or EAP */ + if (0 +#if CHAP_SUPPORT + || ho->neg_chap +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + || ho->neg_eap +#endif /* EAP_SUPPORT */ + || cilen != CILEN_SHORT) { + LCPDEBUG(("lcp_reqci: rcvd AUTHTYPE PAP, rejecting...")); + orc = CONFREJ; + break; + } + if (!ao->neg_upap) { /* we don't want to do PAP */ + orc = CONFNAK; /* NAK it and suggest CHAP or EAP */ + PUTCHAR(CI_AUTHTYPE, nakoutp); +#if EAP_SUPPORT + if (ao->neg_eap) { + PUTCHAR(CILEN_SHORT, nakoutp); + PUTSHORT(PPP_EAP, nakoutp); + } else { +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT + PUTCHAR(CILEN_CHAP, nakoutp); + PUTSHORT(PPP_CHAP, nakoutp); + PUTCHAR(CHAP_DIGEST(ao->chap_mdtype), nakoutp); +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + } +#endif /* EAP_SUPPORT */ + break; + } + ho->neg_upap = 1; + break; + } +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + if (cishort == PPP_CHAP) { + /* we've already accepted PAP or EAP */ + if ( +#if PAP_SUPPORT + ho->neg_upap || +#endif /* PAP_SUPPORT */ +#if EAP_SUPPORT + ho->neg_eap || +#endif /* EAP_SUPPORT */ + cilen != CILEN_CHAP) { + LCPDEBUG(("lcp_reqci: rcvd AUTHTYPE CHAP, rejecting...")); + orc = CONFREJ; + break; + } + if (!ao->neg_chap) { /* we don't want to do CHAP */ + orc = CONFNAK; /* NAK it and suggest EAP or PAP */ + PUTCHAR(CI_AUTHTYPE, nakoutp); + PUTCHAR(CILEN_SHORT, nakoutp); +#if EAP_SUPPORT + if (ao->neg_eap) { + PUTSHORT(PPP_EAP, nakoutp); + } else +#endif /* EAP_SUPPORT */ +#if PAP_SUPPORT + if(1) { + PUTSHORT(PPP_PAP, nakoutp); + } + else +#endif /* PAP_SUPPORT */ + {} + break; + } + GETCHAR(cichar, p); /* get digest type */ + if (!(CHAP_CANDIGEST(ao->chap_mdtype, cichar))) { + /* + * We can't/won't do the requested type, + * suggest something else. + */ + orc = CONFNAK; + PUTCHAR(CI_AUTHTYPE, nakoutp); + PUTCHAR(CILEN_CHAP, nakoutp); + PUTSHORT(PPP_CHAP, nakoutp); + PUTCHAR(CHAP_DIGEST(ao->chap_mdtype), nakoutp); + break; + } + ho->chap_mdtype = CHAP_MDTYPE_D(cichar); /* save md type */ + ho->neg_chap = 1; + break; + } +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + if (cishort == PPP_EAP) { + /* we've already accepted CHAP or PAP */ + if ( +#if CHAP_SUPPORT + ho->neg_chap || +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + ho->neg_upap || +#endif /* PAP_SUPPORT */ + cilen != CILEN_SHORT) { + LCPDEBUG(("lcp_reqci: rcvd AUTHTYPE EAP, rejecting...")); + orc = CONFREJ; + break; + } + if (!ao->neg_eap) { /* we don't want to do EAP */ + orc = CONFNAK; /* NAK it and suggest CHAP or PAP */ + PUTCHAR(CI_AUTHTYPE, nakoutp); +#if CHAP_SUPPORT + if (ao->neg_chap) { + PUTCHAR(CILEN_CHAP, nakoutp); + PUTSHORT(PPP_CHAP, nakoutp); + PUTCHAR(CHAP_DIGEST(ao->chap_mdtype), nakoutp); + } else +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + if(1) { + PUTCHAR(CILEN_SHORT, nakoutp); + PUTSHORT(PPP_PAP, nakoutp); + } else +#endif /* PAP_SUPPORT */ + {} + break; + } + ho->neg_eap = 1; + break; + } +#endif /* EAP_SUPPORT */ + + /* + * We don't recognize the protocol they're asking for. + * Nak it with something we're willing to do. + * (At this point we know ao->neg_upap || ao->neg_chap || + * ao->neg_eap.) + */ + orc = CONFNAK; + PUTCHAR(CI_AUTHTYPE, nakoutp); + +#if EAP_SUPPORT + if (ao->neg_eap) { + PUTCHAR(CILEN_SHORT, nakoutp); + PUTSHORT(PPP_EAP, nakoutp); + } else +#endif /* EAP_SUPPORT */ +#if CHAP_SUPPORT + if (ao->neg_chap) { + PUTCHAR(CILEN_CHAP, nakoutp); + PUTSHORT(PPP_CHAP, nakoutp); + PUTCHAR(CHAP_DIGEST(ao->chap_mdtype), nakoutp); + } else +#endif /* CHAP_SUPPORT */ +#if PAP_SUPPORT + if(1) { + PUTCHAR(CILEN_SHORT, nakoutp); + PUTSHORT(PPP_PAP, nakoutp); + } else +#endif /* PAP_SUPPORT */ + {} + break; + +#if LQR_SUPPORT + case CI_QUALITY: + if (!ao->neg_lqr || + cilen != CILEN_LQR) { + orc = CONFREJ; + break; + } + + GETSHORT(cishort, p); + GETLONG(cilong, p); + + /* + * Check the protocol and the reporting period. + * XXX When should we Nak this, and what with? + */ + if (cishort != PPP_LQR) { + orc = CONFNAK; + PUTCHAR(CI_QUALITY, nakoutp); + PUTCHAR(CILEN_LQR, nakoutp); + PUTSHORT(PPP_LQR, nakoutp); + PUTLONG(ao->lqr_period, nakoutp); + break; + } + break; +#endif /* LQR_SUPPORT */ + + case CI_MAGICNUMBER: + if (!(ao->neg_magicnumber || go->neg_magicnumber) || + cilen != CILEN_LONG) { + orc = CONFREJ; + break; + } + GETLONG(cilong, p); + + /* + * He must have a different magic number. + */ + if (go->neg_magicnumber && + cilong == go->magicnumber) { + cilong = magic(); /* Don't put magic() inside macro! */ + orc = CONFNAK; + PUTCHAR(CI_MAGICNUMBER, nakoutp); + PUTCHAR(CILEN_LONG, nakoutp); + PUTLONG(cilong, nakoutp); + break; + } + ho->neg_magicnumber = 1; + ho->magicnumber = cilong; + break; + + + case CI_PCOMPRESSION: + if (!ao->neg_pcompression || + cilen != CILEN_VOID) { + orc = CONFREJ; + break; + } + ho->neg_pcompression = 1; + break; + + case CI_ACCOMPRESSION: + if (!ao->neg_accompression || + cilen != CILEN_VOID) { + orc = CONFREJ; + break; + } + ho->neg_accompression = 1; + break; + +#ifdef HAVE_MULTILINK + case CI_MRRU: + if (!ao->neg_mrru + || !multilink + || cilen != CILEN_SHORT) { + orc = CONFREJ; + break; + } + + GETSHORT(cishort, p); + /* possibly should insist on a minimum/maximum MRRU here */ + ho->neg_mrru = 1; + ho->mrru = cishort; + break; +#endif /* HAVE_MULTILINK */ + + case CI_SSNHF: + if (!ao->neg_ssnhf +#ifdef HAVE_MULTILINK + || !multilink +#endif /* HAVE_MULTILINK */ + || cilen != CILEN_VOID) { + orc = CONFREJ; + break; + } + ho->neg_ssnhf = 1; + break; + + case CI_EPDISC: + if (!ao->neg_endpoint || + cilen < CILEN_CHAR || + cilen > CILEN_CHAR + MAX_ENDP_LEN) { + orc = CONFREJ; + break; + } + GETCHAR(cichar, p); + cilen -= CILEN_CHAR; + ho->neg_endpoint = 1; + ho->endpoint.class_ = cichar; + ho->endpoint.length = cilen; + MEMCPY(ho->endpoint.value, p, cilen); + INCPTR(cilen, p); + break; + + default: + LCPDEBUG(("lcp_reqci: rcvd unknown option %d", citype)); + orc = CONFREJ; + break; + } + +endswitch: + if (orc == CONFACK && /* Good CI */ + rc != CONFACK) /* but prior CI wasnt? */ + continue; /* Don't send this one */ + + if (orc == CONFNAK) { /* Nak this CI? */ + if (reject_if_disagree /* Getting fed up with sending NAKs? */ + && citype != CI_MAGICNUMBER) { + orc = CONFREJ; /* Get tough if so */ + } else { + if (rc == CONFREJ) /* Rejecting prior CI? */ + continue; /* Don't send this one */ + rc = CONFNAK; + } + } + if (orc == CONFREJ) { /* Reject this CI */ + rc = CONFREJ; + if (cip != rejp) /* Need to move rejected CI? */ + MEMCPY(rejp, cip, cilen); /* Move it */ + INCPTR(cilen, rejp); /* Update output pointer */ + } + } + + /* + * If we wanted to send additional NAKs (for unsent CIs), the + * code would go here. The extra NAKs would go at *nakoutp. + * At present there are no cases where we want to ask the + * peer to negotiate an option. + */ + + switch (rc) { + case CONFACK: + *lenp = next - inp; + break; + case CONFNAK: + /* + * Copy the Nak'd options from the nak buffer to the caller's buffer. + */ + *lenp = nakoutp - (u_char*)nakp->payload; + MEMCPY(inp, nakp->payload, *lenp); + break; + case CONFREJ: + *lenp = rejp - inp; + break; + default: + break; + } + + pbuf_free(nakp); + LCPDEBUG(("lcp_reqci: returning CONF%s.", CODENAME(rc))); + return (rc); /* Return final code */ +} + + +/* + * lcp_up - LCP has come UP. + */ +static void lcp_up(fsm *f) { + ppp_pcb *pcb = f->pcb; + lcp_options *wo = &pcb->lcp_wantoptions; + lcp_options *ho = &pcb->lcp_hisoptions; + lcp_options *go = &pcb->lcp_gotoptions; + lcp_options *ao = &pcb->lcp_allowoptions; + int mtu, mru; + + if (!go->neg_magicnumber) + go->magicnumber = 0; + if (!ho->neg_magicnumber) + ho->magicnumber = 0; + + /* + * Set our MTU to the smaller of the MTU we wanted and + * the MRU our peer wanted. If we negotiated an MRU, + * set our MRU to the larger of value we wanted and + * the value we got in the negotiation. + * Note on the MTU: the link MTU can be the MRU the peer wanted, + * the interface MTU is set to the lowest of that, the + * MTU we want to use, and our link MRU. + */ + mtu = ho->neg_mru? ho->mru: PPP_MRU; + mru = go->neg_mru? LWIP_MAX(wo->mru, go->mru): PPP_MRU; +#ifdef HAVE_MULTILINK + if (!(multilink && go->neg_mrru && ho->neg_mrru)) +#endif /* HAVE_MULTILINK */ + netif_set_mtu(pcb, LWIP_MIN(LWIP_MIN(mtu, mru), ao->mru)); + ppp_send_config(pcb, mtu, + (ho->neg_asyncmap? ho->asyncmap: 0xffffffff), + ho->neg_pcompression, ho->neg_accompression); + ppp_recv_config(pcb, mru, + (pcb->settings.lax_recv? 0: go->neg_asyncmap? go->asyncmap: 0xffffffff), + go->neg_pcompression, go->neg_accompression); + + if (ho->neg_mru) + pcb->peer_mru = ho->mru; + + lcp_echo_lowerup(f->pcb); /* Enable echo messages */ + + link_established(pcb); +} + + +/* + * lcp_down - LCP has gone DOWN. + * + * Alert other protocols. + */ +static void lcp_down(fsm *f) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + + lcp_echo_lowerdown(f->pcb); + + link_down(pcb); + + ppp_send_config(pcb, PPP_MRU, 0xffffffff, 0, 0); + ppp_recv_config(pcb, PPP_MRU, + (go->neg_asyncmap? go->asyncmap: 0xffffffff), + go->neg_pcompression, go->neg_accompression); + pcb->peer_mru = PPP_MRU; +} + + +/* + * lcp_starting - LCP needs the lower layer up. + */ +static void lcp_starting(fsm *f) { + ppp_pcb *pcb = f->pcb; + link_required(pcb); +} + + +/* + * lcp_finished - LCP has finished with the lower layer. + */ +static void lcp_finished(fsm *f) { + ppp_pcb *pcb = f->pcb; + link_terminated(pcb); +} + + +#if PRINTPKT_SUPPORT +/* + * lcp_printpkt - print the contents of an LCP packet. + */ +static const char* const lcp_codenames[] = { + "ConfReq", "ConfAck", "ConfNak", "ConfRej", + "TermReq", "TermAck", "CodeRej", "ProtRej", + "EchoReq", "EchoRep", "DiscReq", "Ident", + "TimeRem" +}; + +static int lcp_printpkt(const u_char *p, int plen, + void (*printer) (void *, const char *, ...), void *arg) { + int code, id, len, olen, i; + const u_char *pstart, *optend; + u_short cishort; + u32_t cilong; + + if (plen < HEADERLEN) + return 0; + pstart = p; + GETCHAR(code, p); + GETCHAR(id, p); + GETSHORT(len, p); + if (len < HEADERLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)sizeof(lcp_codenames) / (int)sizeof(char *)) + printer(arg, " %s", lcp_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= HEADERLEN; + switch (code) { + case CONFREQ: + case CONFACK: + case CONFNAK: + case CONFREJ: + /* print option list */ + while (len >= 2) { + GETCHAR(code, p); + GETCHAR(olen, p); + p -= 2; + if (olen < 2 || olen > len) { + break; + } + printer(arg, " <"); + len -= olen; + optend = p + olen; + switch (code) { + case CI_MRU: + if (olen == CILEN_SHORT) { + p += 2; + GETSHORT(cishort, p); + printer(arg, "mru %d", cishort); + } + break; + case CI_ASYNCMAP: + if (olen == CILEN_LONG) { + p += 2; + GETLONG(cilong, p); + printer(arg, "asyncmap 0x%x", cilong); + } + break; + case CI_AUTHTYPE: + if (olen >= CILEN_SHORT) { + p += 2; + printer(arg, "auth "); + GETSHORT(cishort, p); + switch (cishort) { +#if PAP_SUPPORT + case PPP_PAP: + printer(arg, "pap"); + break; +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + case PPP_CHAP: + printer(arg, "chap"); + if (p < optend) { + switch (*p) { + case CHAP_MD5: + printer(arg, " MD5"); + ++p; + break; +#if MSCHAP_SUPPORT + case CHAP_MICROSOFT: + printer(arg, " MS"); + ++p; + break; + + case CHAP_MICROSOFT_V2: + printer(arg, " MS-v2"); + ++p; + break; +#endif /* MSCHAP_SUPPORT */ + default: + break; + } + } + break; +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + case PPP_EAP: + printer(arg, "eap"); + break; +#endif /* EAP_SUPPORT */ + default: + printer(arg, "0x%x", cishort); + } + } + break; +#if LQR_SUPPORT + case CI_QUALITY: + if (olen >= CILEN_SHORT) { + p += 2; + printer(arg, "quality "); + GETSHORT(cishort, p); + switch (cishort) { + case PPP_LQR: + printer(arg, "lqr"); + break; + default: + printer(arg, "0x%x", cishort); + } + } + break; +#endif /* LQR_SUPPORT */ + case CI_CALLBACK: + if (olen >= CILEN_CHAR) { + p += 2; + printer(arg, "callback "); + GETCHAR(cishort, p); + switch (cishort) { + case CBCP_OPT: + printer(arg, "CBCP"); + break; + default: + printer(arg, "0x%x", cishort); + } + } + break; + case CI_MAGICNUMBER: + if (olen == CILEN_LONG) { + p += 2; + GETLONG(cilong, p); + printer(arg, "magic 0x%x", cilong); + } + break; + case CI_PCOMPRESSION: + if (olen == CILEN_VOID) { + p += 2; + printer(arg, "pcomp"); + } + break; + case CI_ACCOMPRESSION: + if (olen == CILEN_VOID) { + p += 2; + printer(arg, "accomp"); + } + break; + case CI_MRRU: + if (olen == CILEN_SHORT) { + p += 2; + GETSHORT(cishort, p); + printer(arg, "mrru %d", cishort); + } + break; + case CI_SSNHF: + if (olen == CILEN_VOID) { + p += 2; + printer(arg, "ssnhf"); + } + break; + case CI_EPDISC: +#ifdef HAVE_MULTILINK + if (olen >= CILEN_CHAR) { + struct epdisc epd; + p += 2; + GETCHAR(epd.class, p); + epd.length = olen - CILEN_CHAR; + if (epd.length > MAX_ENDP_LEN) + epd.length = MAX_ENDP_LEN; + if (epd.length > 0) { + MEMCPY(epd.value, p, epd.length); + p += epd.length; + } + printer(arg, "endpoint [%s]", epdisc_to_str(&epd)); + } +#else + printer(arg, "endpoint"); +#endif + break; + default: + break; + } + while (p < optend) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + printer(arg, ">"); + } + break; + + case TERMACK: + case TERMREQ: + if (len > 0 && *p >= ' ' && *p < 0x7f) { + printer(arg, " "); + ppp_print_string(p, len, printer, arg); + p += len; + len = 0; + } + break; + + case ECHOREQ: + case ECHOREP: + case DISCREQ: + if (len >= 4) { + GETLONG(cilong, p); + printer(arg, " magic=0x%x", cilong); + len -= 4; + } + break; + + case IDENTIF: + case TIMEREM: + if (len >= 4) { + GETLONG(cilong, p); + printer(arg, " magic=0x%x", cilong); + len -= 4; + } + if (code == TIMEREM) { + if (len < 4) + break; + GETLONG(cilong, p); + printer(arg, " seconds=%u", cilong); + len -= 4; + } + if (len > 0) { + printer(arg, " "); + ppp_print_string(p, len, printer, arg); + p += len; + len = 0; + } + break; + default: + break; + } + + /* print the rest of the bytes in the packet */ + for (i = 0; i < len && i < 32; ++i) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + if (i < len) { + printer(arg, " ..."); + p += len - i; + } + + return p - pstart; +} +#endif /* PRINTPKT_SUPPORT */ + +/* + * Time to shut down the link because there is nothing out there. + */ + +static void LcpLinkFailure(fsm *f) { + ppp_pcb *pcb = f->pcb; + if (f->state == PPP_FSM_OPENED) { + ppp_info("No response to %d echo-requests", pcb->lcp_echos_pending); + ppp_notice("Serial link appears to be disconnected."); + pcb->err_code = PPPERR_PEERDEAD; + lcp_close(pcb, "Peer not responding"); + } +} + +/* + * Timer expired for the LCP echo requests from this process. + */ + +static void LcpEchoCheck(fsm *f) { + ppp_pcb *pcb = f->pcb; + + LcpSendEchoRequest (f); + if (f->state != PPP_FSM_OPENED) + return; + + /* + * Start the timer for the next interval. + */ + if (pcb->lcp_echo_timer_running) + ppp_warn("assertion lcp_echo_timer_running==0 failed"); + TIMEOUT (LcpEchoTimeout, f, pcb->settings.lcp_echo_interval); + pcb->lcp_echo_timer_running = 1; +} + +/* + * LcpEchoTimeout - Timer expired on the LCP echo + */ + +static void LcpEchoTimeout(void *arg) { + fsm *f = (fsm*)arg; + ppp_pcb *pcb = f->pcb; + if (pcb->lcp_echo_timer_running != 0) { + pcb->lcp_echo_timer_running = 0; + LcpEchoCheck ((fsm *) arg); + } +} + +/* + * LcpEchoReply - LCP has received a reply to the echo + */ + +static void lcp_received_echo_reply(fsm *f, int id, u_char *inp, int len) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u32_t magic_val; + LWIP_UNUSED_ARG(id); + + /* Check the magic number - don't count replies from ourselves. */ + if (len < 4) { + ppp_dbglog("lcp: received short Echo-Reply, length %d", len); + return; + } + GETLONG(magic_val, inp); + if (go->neg_magicnumber + && magic_val == go->magicnumber) { + ppp_warn("appear to have received our own echo-reply!"); + return; + } + + /* Reset the number of outstanding echo frames */ + pcb->lcp_echos_pending = 0; +} + +/* + * LcpSendEchoRequest - Send an echo request frame to the peer + */ + +static void LcpSendEchoRequest(fsm *f) { + ppp_pcb *pcb = f->pcb; + lcp_options *go = &pcb->lcp_gotoptions; + u32_t lcp_magic; + u_char pkt[4], *pktp; + + /* + * Detect the failure of the peer at this point. + */ + if (pcb->settings.lcp_echo_fails != 0) { + if (pcb->lcp_echos_pending >= pcb->settings.lcp_echo_fails) { + LcpLinkFailure(f); + pcb->lcp_echos_pending = 0; + } + } + +#if PPP_LCP_ADAPTIVE + /* + * If adaptive echos have been enabled, only send the echo request if + * no traffic was received since the last one. + */ + if (pcb->settings.lcp_echo_adaptive) { + static unsigned int last_pkts_in = 0; + +#if PPP_STATS_SUPPORT + update_link_stats(f->unit); + link_stats_valid = 0; +#endif /* PPP_STATS_SUPPORT */ + + if (link_stats.pkts_in != last_pkts_in) { + last_pkts_in = link_stats.pkts_in; + return; + } + } +#endif + + /* + * Make and send the echo request frame. + */ + if (f->state == PPP_FSM_OPENED) { + lcp_magic = go->magicnumber; + pktp = pkt; + PUTLONG(lcp_magic, pktp); + fsm_sdata(f, ECHOREQ, pcb->lcp_echo_number++, pkt, pktp - pkt); + ++pcb->lcp_echos_pending; + } +} + +/* + * lcp_echo_lowerup - Start the timer for the LCP frame + */ + +static void lcp_echo_lowerup(ppp_pcb *pcb) { + fsm *f = &pcb->lcp_fsm; + + /* Clear the parameters for generating echo frames */ + pcb->lcp_echos_pending = 0; + pcb->lcp_echo_number = 0; + pcb->lcp_echo_timer_running = 0; + + /* If a timeout interval is specified then start the timer */ + if (pcb->settings.lcp_echo_interval != 0) + LcpEchoCheck (f); +} + +/* + * lcp_echo_lowerdown - Stop the timer for the LCP frame + */ + +static void lcp_echo_lowerdown(ppp_pcb *pcb) { + fsm *f = &pcb->lcp_fsm; + + if (pcb->lcp_echo_timer_running != 0) { + UNTIMEOUT (LcpEchoTimeout, f); + pcb->lcp_echo_timer_running = 0; + } +} + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/netif/ppp/magic.c b/components/lwip/netif/ppp/magic.c new file mode 100755 index 000000000..826386cf1 --- /dev/null +++ b/components/lwip/netif/ppp/magic.c @@ -0,0 +1,294 @@ +/* + * magic.c - PPP Magic Number routines. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ +/***************************************************************************** +* randm.c - Random number generator program file. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* Copyright (c) 1998 by Global Election Systems Inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 98-06-03 Guy Lancaster , Global Election Systems Inc. +* Extracted from avos. +*****************************************************************************/ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/magic.h" + +#if PPP_MD5_RANDM /* Using MD5 for better randomness if enabled */ + +#if LWIP_INCLUDED_POLARSSL_MD5 +#include "netif/ppp/polarssl/md5.h" +#else +#include "polarssl/md5.h" +#endif + +#define MD5_HASH_SIZE 16 +static char magic_randpool[MD5_HASH_SIZE]; /* Pool of randomness. */ +static long magic_randcount; /* Pseudo-random incrementer */ +static u32_t magic_randomseed; /* Seed used for random number generation. */ + +/* + * Churn the randomness pool on a random event. Call this early and often + * on random and semi-random system events to build randomness in time for + * usage. For randomly timed events, pass a null pointer and a zero length + * and this will use the system timer and other sources to add randomness. + * If new random data is available, pass a pointer to that and it will be + * included. + * + * Ref: Applied Cryptography 2nd Ed. by Bruce Schneier p. 427 + */ +static void magic_churnrand(char *rand_data, u32_t rand_len) { + md5_context md5_ctx; + + /* LWIP_DEBUGF(LOG_INFO, ("magic_churnrand: %u@%P\n", rand_len, rand_data)); */ + md5_starts(&md5_ctx); + md5_update(&md5_ctx, (u_char *)magic_randpool, sizeof(magic_randpool)); + if (rand_data) { + md5_update(&md5_ctx, (u_char *)rand_data, rand_len); + } else { + struct { + /* INCLUDE fields for any system sources of randomness */ + u32_t jiffies; +#ifdef LWIP_RAND + u32_t rand; +#endif /* LWIP_RAND */ + } sys_data; + magic_randomseed += sys_jiffies(); + sys_data.jiffies = magic_randomseed; +#ifdef LWIP_RAND + sys_data.rand = LWIP_RAND(); +#endif /* LWIP_RAND */ + /* Load sys_data fields here. */ + md5_update(&md5_ctx, (u_char *)&sys_data, sizeof(sys_data)); + } + md5_finish(&md5_ctx, (u_char *)magic_randpool); +/* LWIP_DEBUGF(LOG_INFO, ("magic_churnrand: -> 0\n")); */ +} + +/* + * Initialize the random number generator. + */ +void magic_init(void) { + magic_churnrand(NULL, 0); +} + +/* + * Randomize our random seed value. + */ +void magic_randomize(void) { + magic_churnrand(NULL, 0); +} + +/* + * magic_random_bytes - Fill a buffer with random bytes. + * + * Use the random pool to generate random data. This degrades to pseudo + * random when used faster than randomness is supplied using magic_churnrand(). + * Note: It's important that there be sufficient randomness in magic_randpool + * before this is called for otherwise the range of the result may be + * narrow enough to make a search feasible. + * + * Ref: Applied Cryptography 2nd Ed. by Bruce Schneier p. 427 + * + * XXX Why does he not just call magic_churnrand() for each block? Probably + * so that you don't ever publish the seed which could possibly help + * predict future values. + * XXX Why don't we preserve md5 between blocks and just update it with + * magic_randcount each time? Probably there is a weakness but I wish that + * it was documented. + */ +void magic_random_bytes(unsigned char *buf, u32_t buf_len) { + md5_context md5_ctx; + u_char tmp[MD5_HASH_SIZE]; + u32_t n; + + while (buf_len > 0) { + md5_starts(&md5_ctx); + md5_update(&md5_ctx, (u_char *)magic_randpool, sizeof(magic_randpool)); + md5_update(&md5_ctx, (u_char *)&magic_randcount, sizeof(magic_randcount)); + md5_finish(&md5_ctx, tmp); + magic_randcount++; + n = LWIP_MIN(buf_len, MD5_HASH_SIZE); + MEMCPY(buf, tmp, n); + buf += n; + buf_len -= n; + } +} + +/* + * Return a new random number. + */ +u32_t magic(void) { + u32_t new_rand; + + magic_random_bytes((unsigned char *)&new_rand, sizeof(new_rand)); + + return new_rand; +} + +#else /* PPP_MD5_RANDM */ + +/*****************************/ +/*** LOCAL DATA STRUCTURES ***/ +/*****************************/ +#ifndef LWIP_RAND +static int magic_randomized; /* Set when truely randomized. */ +#endif /* LWIP_RAND */ +static u32_t magic_randomseed; /* Seed used for random number generation. */ + + +/***********************************/ +/*** PUBLIC FUNCTION DEFINITIONS ***/ +/***********************************/ + +/* + * Initialize the random number generator. + * + * Here we attempt to compute a random number seed but even if + * it isn't random, we'll randomize it later. + * + * The current method uses the fields from the real time clock, + * the idle process counter, the millisecond counter, and the + * hardware timer tick counter. When this is invoked + * in startup(), then the idle counter and timer values may + * repeat after each boot and the real time clock may not be + * operational. Thus we call it again on the first random + * event. + */ +void magic_init(void) { + magic_randomseed += sys_jiffies(); +#ifndef LWIP_RAND + /* Initialize the Borland random number generator. */ + srand((unsigned)magic_randomseed); +#endif /* LWIP_RAND */ +} + +/* + * magic_init - Initialize the magic number generator. + * + * Randomize our random seed value. Here we use the fact that + * this function is called at *truely random* times by the polling + * and network functions. Here we only get 16 bits of new random + * value but we use the previous value to randomize the other 16 + * bits. + */ +void magic_randomize(void) { +#ifndef LWIP_RAND + if (!magic_randomized) { + magic_randomized = !0; + magic_init(); + /* The initialization function also updates the seed. */ + } else { +#endif /* LWIP_RAND */ + magic_randomseed += sys_jiffies(); +#ifndef LWIP_RAND + } +#endif /* LWIP_RAND */ +} + +/* + * Return a new random number. + * + * Here we use the Borland rand() function to supply a pseudo random + * number which we make truely random by combining it with our own + * seed which is randomized by truely random events. + * Thus the numbers will be truely random unless there have been no + * operator or network events in which case it will be pseudo random + * seeded by the real time clock. + */ +u32_t magic(void) { +#ifdef LWIP_RAND + return LWIP_RAND() + magic_randomseed; +#else /* LWIP_RAND */ + return ((u32_t)rand() << 16) + (u32_t)rand() + magic_randomseed; +#endif /* LWIP_RAND */ +} + +/* + * magic_random_bytes - Fill a buffer with random bytes. + */ +void magic_random_bytes(unsigned char *buf, u32_t buf_len) { + u32_t new_rand, n; + + while (buf_len > 0) { + new_rand = magic(); + n = LWIP_MIN(buf_len, sizeof(new_rand)); + MEMCPY(buf, &new_rand, n); + buf += n; + buf_len -= n; + } +} +#endif /* PPP_MD5_RANDM */ + +/* + * Return a new random number between 0 and (2^pow)-1 included. + */ +u32_t magic_pow(u8_t pow) { + return magic() & ~(~0UL<. + * Copyright (c) 2002,2003,2004 Google, Inc. + * All rights reserved. + * + * License: + * Permission to use, copy, modify, and distribute this software and its + * documentation is hereby granted, provided that the above copyright + * notice appears in all copies. This software is provided without any + * warranty, express or implied. + * + * Changelog: + * 08/12/05 - Matt Domsch + * Only need extra skb padding on transmit, not receive. + * 06/18/04 - Matt Domsch , Oleg Makarenko + * Use Linux kernel 2.6 arc4 and sha1 routines rather than + * providing our own. + * 2/15/04 - TS: added #include and testing for Kernel + * version before using + * MOD_DEC_USAGE_COUNT/MOD_INC_USAGE_COUNT which are + * deprecated in 2.6 + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MPPE_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include + +#include "lwip/err.h" + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/ccp.h" +#include "netif/ppp/mppe.h" +#include "netif/ppp/pppdebug.h" + +#if LWIP_INCLUDED_POLARSSL_SHA1 +#include "netif/ppp/polarssl/sha1.h" +#else +#include "polarssl/sha1.h" +#endif + +#if LWIP_INCLUDED_POLARSSL_ARC4 +#include "netif/ppp/polarssl/arc4.h" +#else +#include "polarssl/arc4.h" +#endif + +#define SHA1_SIGNATURE_SIZE 20 + +/* ppp_mppe_state.bits definitions */ +#define MPPE_BIT_A 0x80 /* Encryption table were (re)inititalized */ +#define MPPE_BIT_B 0x40 /* MPPC only (not implemented) */ +#define MPPE_BIT_C 0x20 /* MPPC only (not implemented) */ +#define MPPE_BIT_D 0x10 /* This is an encrypted frame */ + +#define MPPE_BIT_FLUSHED MPPE_BIT_A +#define MPPE_BIT_ENCRYPTED MPPE_BIT_D + +#define MPPE_BITS(p) ((p)[0] & 0xf0) +#define MPPE_CCOUNT(p) ((((p)[0] & 0x0f) << 8) + (p)[1]) +#define MPPE_CCOUNT_SPACE 0x1000 /* The size of the ccount space */ + +#define MPPE_OVHD 2 /* MPPE overhead/packet */ +#define SANITY_MAX 1600 /* Max bogon factor we will tolerate */ + +/* + * Perform the MPPE rekey algorithm, from RFC 3078, sec. 7.3. + * Well, not what's written there, but rather what they meant. + */ +static void mppe_rekey(ppp_mppe_state * state, int initial_key) +{ + sha1_context sha1_ctx; + u8_t sha1_digest[SHA1_SIGNATURE_SIZE]; + + /* + * Key Derivation, from RFC 3078, RFC 3079. + * Equivalent to Get_Key() for MS-CHAP as described in RFC 3079. + */ + sha1_starts(&sha1_ctx); + sha1_update(&sha1_ctx, state->master_key, state->keylen); + sha1_update(&sha1_ctx, mppe_sha1_pad1, SHA1_PAD_SIZE); + sha1_update(&sha1_ctx, state->session_key, state->keylen); + sha1_update(&sha1_ctx, mppe_sha1_pad2, SHA1_PAD_SIZE); + sha1_finish(&sha1_ctx, sha1_digest); + MEMCPY(state->session_key, sha1_digest, state->keylen); + + if (!initial_key) { + arc4_setup(&state->arc4, sha1_digest, state->keylen); + arc4_crypt(&state->arc4, state->session_key, state->keylen); + } + if (state->keylen == 8) { + /* See RFC 3078 */ + state->session_key[0] = 0xd1; + state->session_key[1] = 0x26; + state->session_key[2] = 0x9e; + } + arc4_setup(&state->arc4, state->session_key, state->keylen); +} + +/* + * Set key, used by MSCHAP before mppe_init() is actually called by CCP so we + * don't have to keep multiple copies of keys. + */ +void mppe_set_key(ppp_pcb *pcb, ppp_mppe_state *state, u8_t *key) { + LWIP_UNUSED_ARG(pcb); + MEMCPY(state->master_key, key, MPPE_MAX_KEY_LEN); +} + +/* + * Initialize (de)compressor state. + */ +void +mppe_init(ppp_pcb *pcb, ppp_mppe_state *state, u8_t options) +{ +#if PPP_DEBUG + const u8_t *debugstr = (const u8_t*)"mppe_comp_init"; + if (&pcb->mppe_decomp == state) { + debugstr = (const u8_t*)"mppe_decomp_init"; + } +#endif /* PPP_DEBUG */ + + /* Save keys. */ + MEMCPY(state->session_key, state->master_key, sizeof(state->master_key)); + + if (options & MPPE_OPT_128) + state->keylen = 16; + else if (options & MPPE_OPT_40) + state->keylen = 8; + else { + PPPDEBUG(LOG_DEBUG, ("%s[%d]: unknown key length\n", debugstr, + pcb->netif->num)); + lcp_close(pcb, "MPPE required but peer negotiation failed"); + return; + } + if (options & MPPE_OPT_STATEFUL) + state->stateful = 1; + + /* Generate the initial session key. */ + mppe_rekey(state, 1); + +#if PPP_DEBUG + { + int i; + char mkey[sizeof(state->master_key) * 2 + 1]; + char skey[sizeof(state->session_key) * 2 + 1]; + + PPPDEBUG(LOG_DEBUG, ("%s[%d]: initialized with %d-bit %s mode\n", + debugstr, pcb->netif->num, (state->keylen == 16) ? 128 : 40, + (state->stateful) ? "stateful" : "stateless")); + + for (i = 0; i < (int)sizeof(state->master_key); i++) + sprintf(mkey + i * 2, "%02x", state->master_key[i]); + for (i = 0; i < (int)sizeof(state->session_key); i++) + sprintf(skey + i * 2, "%02x", state->session_key[i]); + PPPDEBUG(LOG_DEBUG, + ("%s[%d]: keys: master: %s initial session: %s\n", + debugstr, pcb->netif->num, mkey, skey)); + } +#endif /* PPP_DEBUG */ + + /* + * Initialize the coherency count. The initial value is not specified + * in RFC 3078, but we can make a reasonable assumption that it will + * start at 0. Setting it to the max here makes the comp/decomp code + * do the right thing (determined through experiment). + */ + state->ccount = MPPE_CCOUNT_SPACE - 1; + + /* + * Note that even though we have initialized the key table, we don't + * set the FLUSHED bit. This is contrary to RFC 3078, sec. 3.1. + */ + state->bits = MPPE_BIT_ENCRYPTED; +} + +/* + * We received a CCP Reset-Request (actually, we are sending a Reset-Ack), + * tell the compressor to rekey. Note that we MUST NOT rekey for + * every CCP Reset-Request; we only rekey on the next xmit packet. + * We might get multiple CCP Reset-Requests if our CCP Reset-Ack is lost. + * So, rekeying for every CCP Reset-Request is broken as the peer will not + * know how many times we've rekeyed. (If we rekey and THEN get another + * CCP Reset-Request, we must rekey again.) + */ +void mppe_comp_reset(ppp_pcb *pcb, ppp_mppe_state *state) +{ + LWIP_UNUSED_ARG(pcb); + state->bits |= MPPE_BIT_FLUSHED; +} + +/* + * Compress (encrypt) a packet. + * It's strange to call this a compressor, since the output is always + * MPPE_OVHD + 2 bytes larger than the input. + */ +err_t +mppe_compress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb, u16_t protocol) +{ + struct pbuf *n, *np; + u8_t *pl; + err_t err; + + LWIP_UNUSED_ARG(pcb); + + /* TCP stack requires that we don't change the packet payload, therefore we copy + * the whole packet before encryption. + */ + np = pbuf_alloc(PBUF_RAW, MPPE_OVHD + sizeof(protocol) + (*pb)->tot_len, PBUF_POOL); + if (!np) { + return ERR_MEM; + } + + /* Hide MPPE header + protocol */ + pbuf_header(np, -(s16_t)(MPPE_OVHD + sizeof(protocol))); + + if ((err = pbuf_copy(np, *pb)) != ERR_OK) { + pbuf_free(np); + return err; + } + + /* Reveal MPPE header + protocol */ + pbuf_header(np, (s16_t)(MPPE_OVHD + sizeof(protocol))); + + *pb = np; + pl = (u8_t*)np->payload; + + state->ccount = (state->ccount + 1) % MPPE_CCOUNT_SPACE; + PPPDEBUG(LOG_DEBUG, ("mppe_compress[%d]: ccount %d\n", pcb->netif->num, state->ccount)); + /* FIXME: use PUT* macros */ + pl[0] = state->ccount>>8; + pl[1] = state->ccount; + + if (!state->stateful || /* stateless mode */ + ((state->ccount & 0xff) == 0xff) || /* "flag" packet */ + (state->bits & MPPE_BIT_FLUSHED)) { /* CCP Reset-Request */ + /* We must rekey */ + if (state->stateful) { + PPPDEBUG(LOG_DEBUG, ("mppe_compress[%d]: rekeying\n", pcb->netif->num)); + } + mppe_rekey(state, 0); + state->bits |= MPPE_BIT_FLUSHED; + } + pl[0] |= state->bits; + state->bits &= ~MPPE_BIT_FLUSHED; /* reset for next xmit */ + pl += MPPE_OVHD; + + /* Add protocol */ + /* FIXME: add PFC support */ + pl[0] = protocol >> 8; + pl[1] = protocol; + + /* Hide MPPE header */ + pbuf_header(np, -(s16_t)MPPE_OVHD); + + /* Encrypt packet */ + for (n = np; n != NULL; n = n->next) { + arc4_crypt(&state->arc4, (u8_t*)n->payload, n->len); + if (n->tot_len == n->len) { + break; + } + } + + /* Reveal MPPE header */ + pbuf_header(np, (s16_t)MPPE_OVHD); + + return ERR_OK; +} + +/* + * We received a CCP Reset-Ack. Just ignore it. + */ +void mppe_decomp_reset(ppp_pcb *pcb, ppp_mppe_state *state) +{ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(state); + return; +} + +/* + * Decompress (decrypt) an MPPE packet. + */ +err_t +mppe_decompress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb) +{ + struct pbuf *n0 = *pb, *n; + u8_t *pl; + u16_t ccount; + u8_t flushed; + + /* MPPE Header */ + if (n0->len < MPPE_OVHD) { + PPPDEBUG(LOG_DEBUG, + ("mppe_decompress[%d]: short pkt (%d)\n", + pcb->netif->num, n0->len)); + state->sanity_errors += 100; + goto sanity_error; + } + + pl = (u8_t*)n0->payload; + flushed = MPPE_BITS(pl) & MPPE_BIT_FLUSHED; + ccount = MPPE_CCOUNT(pl); + PPPDEBUG(LOG_DEBUG, ("mppe_decompress[%d]: ccount %d\n", + pcb->netif->num, ccount)); + + /* sanity checks -- terminate with extreme prejudice */ + if (!(MPPE_BITS(pl) & MPPE_BIT_ENCRYPTED)) { + PPPDEBUG(LOG_DEBUG, + ("mppe_decompress[%d]: ENCRYPTED bit not set!\n", + pcb->netif->num)); + state->sanity_errors += 100; + goto sanity_error; + } + if (!state->stateful && !flushed) { + PPPDEBUG(LOG_DEBUG, ("mppe_decompress[%d]: FLUSHED bit not set in " + "stateless mode!\n", pcb->netif->num)); + state->sanity_errors += 100; + goto sanity_error; + } + if (state->stateful && ((ccount & 0xff) == 0xff) && !flushed) { + PPPDEBUG(LOG_DEBUG, ("mppe_decompress[%d]: FLUSHED bit not set on " + "flag packet!\n", pcb->netif->num)); + state->sanity_errors += 100; + goto sanity_error; + } + + /* + * Check the coherency count. + */ + + if (!state->stateful) { + /* Discard late packet */ + if ((ccount - state->ccount) % MPPE_CCOUNT_SPACE > MPPE_CCOUNT_SPACE / 2) { + state->sanity_errors++; + goto sanity_error; + } + + /* RFC 3078, sec 8.1. Rekey for every packet. */ + while (state->ccount != ccount) { + mppe_rekey(state, 0); + state->ccount = (state->ccount + 1) % MPPE_CCOUNT_SPACE; + } + } else { + /* RFC 3078, sec 8.2. */ + if (!state->discard) { + /* normal state */ + state->ccount = (state->ccount + 1) % MPPE_CCOUNT_SPACE; + if (ccount != state->ccount) { + /* + * (ccount > state->ccount) + * Packet loss detected, enter the discard state. + * Signal the peer to rekey (by sending a CCP Reset-Request). + */ + state->discard = 1; + ccp_resetrequest(pcb); + return ERR_BUF; + } + } else { + /* discard state */ + if (!flushed) { + /* ccp.c will be silent (no additional CCP Reset-Requests). */ + return ERR_BUF; + } else { + /* Rekey for every missed "flag" packet. */ + while ((ccount & ~0xff) != + (state->ccount & ~0xff)) { + mppe_rekey(state, 0); + state->ccount = + (state->ccount + + 256) % MPPE_CCOUNT_SPACE; + } + + /* reset */ + state->discard = 0; + state->ccount = ccount; + /* + * Another problem with RFC 3078 here. It implies that the + * peer need not send a Reset-Ack packet. But RFC 1962 + * requires it. Hopefully, M$ does send a Reset-Ack; even + * though it isn't required for MPPE synchronization, it is + * required to reset CCP state. + */ + } + } + if (flushed) + mppe_rekey(state, 0); + } + + /* Hide MPPE header */ + pbuf_header(n0, -(s16_t)(MPPE_OVHD)); + + /* Decrypt the packet. */ + for (n = n0; n != NULL; n = n->next) { + arc4_crypt(&state->arc4, (u8_t*)n->payload, n->len); + if (n->tot_len == n->len) { + break; + } + } + + /* good packet credit */ + state->sanity_errors >>= 1; + + return ERR_OK; + +sanity_error: + if (state->sanity_errors >= SANITY_MAX) { + /* + * Take LCP down if the peer is sending too many bogons. + * We don't want to do this for a single or just a few + * instances since it could just be due to packet corruption. + */ + lcp_close(pcb, "Too many MPPE errors"); + } + return ERR_BUF; +} + +#endif /* PPP_SUPPORT && MPPE_SUPPORT */ diff --git a/components/lwip/netif/ppp/multilink.c b/components/lwip/netif/ppp/multilink.c new file mode 100755 index 000000000..3bea516a5 --- /dev/null +++ b/components/lwip/netif/ppp/multilink.c @@ -0,0 +1,609 @@ +/* + * multilink.c - support routines for multilink. + * + * Copyright (c) 2000-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && defined(HAVE_MULTILINK) /* don't build if not configured for use in lwipopts.h */ + +/* Multilink support + * + * Multilink uses Samba TDB (Trivial Database Library), which + * we cannot port, because it needs a filesystem. + * + * We have to choose between doing a memory-shared TDB-clone, + * or dropping multilink support at all. + */ + +#include +#include +#include +#include +#include +#include +#include +#include + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/lcp.h" +#include "netif/ppp/tdb.h" + +bool endpoint_specified; /* user gave explicit endpoint discriminator */ +char *bundle_id; /* identifier for our bundle */ +char *blinks_id; /* key for the list of links */ +bool doing_multilink; /* multilink was enabled and agreed to */ +bool multilink_master; /* we own the multilink bundle */ + +extern TDB_CONTEXT *pppdb; +extern char db_key[]; + +static void make_bundle_links (int append); +static void remove_bundle_link (void); +static void iterate_bundle_links (void (*func) (char *)); + +static int get_default_epdisc (struct epdisc *); +static int parse_num (char *str, const char *key, int *valp); +static int owns_unit (TDB_DATA pid, int unit); + +#define set_ip_epdisc(ep, addr) do { \ + ep->length = 4; \ + ep->value[0] = addr >> 24; \ + ep->value[1] = addr >> 16; \ + ep->value[2] = addr >> 8; \ + ep->value[3] = addr; \ +} while (0) + +#define LOCAL_IP_ADDR(addr) \ + (((addr) & 0xff000000) == 0x0a000000 /* 10.x.x.x */ \ + || ((addr) & 0xfff00000) == 0xac100000 /* 172.16.x.x */ \ + || ((addr) & 0xffff0000) == 0xc0a80000) /* 192.168.x.x */ + +#define process_exists(n) (kill((n), 0) == 0 || errno != ESRCH) + +void +mp_check_options() +{ + lcp_options *wo = &lcp_wantoptions[0]; + lcp_options *ao = &lcp_allowoptions[0]; + + doing_multilink = 0; + if (!multilink) + return; + /* if we're doing multilink, we have to negotiate MRRU */ + if (!wo->neg_mrru) { + /* mrru not specified, default to mru */ + wo->mrru = wo->mru; + wo->neg_mrru = 1; + } + ao->mrru = ao->mru; + ao->neg_mrru = 1; + + if (!wo->neg_endpoint && !noendpoint) { + /* get a default endpoint value */ + wo->neg_endpoint = get_default_epdisc(&wo->endpoint); + } +} + +/* + * Make a new bundle or join us to an existing bundle + * if we are doing multilink. + */ +int +mp_join_bundle() +{ + lcp_options *go = &lcp_gotoptions[0]; + lcp_options *ho = &lcp_hisoptions[0]; + lcp_options *ao = &lcp_allowoptions[0]; + int unit, pppd_pid; + int l, mtu; + char *p; + TDB_DATA key, pid, rec; + + if (doing_multilink) { + /* have previously joined a bundle */ + if (!go->neg_mrru || !ho->neg_mrru) { + notice("oops, didn't get multilink on renegotiation"); + lcp_close(pcb, "multilink required"); + return 0; + } + /* XXX should check the peer_authname and ho->endpoint + are the same as previously */ + return 0; + } + + if (!go->neg_mrru || !ho->neg_mrru) { + /* not doing multilink */ + if (go->neg_mrru) + notice("oops, multilink negotiated only for receive"); + mtu = ho->neg_mru? ho->mru: PPP_MRU; + if (mtu > ao->mru) + mtu = ao->mru; + if (demand) { + /* already have a bundle */ + cfg_bundle(0, 0, 0, 0); + netif_set_mtu(pcb, mtu); + return 0; + } + make_new_bundle(0, 0, 0, 0); + set_ifunit(1); + netif_set_mtu(pcb, mtu); + return 0; + } + + doing_multilink = 1; + + /* + * Find the appropriate bundle or join a new one. + * First we make up a name for the bundle. + * The length estimate is worst-case assuming every + * character has to be quoted. + */ + l = 4 * strlen(peer_authname) + 10; + if (ho->neg_endpoint) + l += 3 * ho->endpoint.length + 8; + if (bundle_name) + l += 3 * strlen(bundle_name) + 2; + bundle_id = malloc(l); + if (bundle_id == 0) + novm("bundle identifier"); + + p = bundle_id; + p += slprintf(p, l-1, "BUNDLE=\"%q\"", peer_authname); + if (ho->neg_endpoint || bundle_name) + *p++ = '/'; + if (ho->neg_endpoint) + p += slprintf(p, bundle_id+l-p, "%s", + epdisc_to_str(&ho->endpoint)); + if (bundle_name) + p += slprintf(p, bundle_id+l-p, "/%v", bundle_name); + + /* Make the key for the list of links belonging to the bundle */ + l = p - bundle_id; + blinks_id = malloc(l + 7); + if (blinks_id == NULL) + novm("bundle links key"); + slprintf(blinks_id, l + 7, "BUNDLE_LINKS=%s", bundle_id + 7); + + /* + * For demand mode, we only need to configure the bundle + * and attach the link. + */ + mtu = LWIP_MIN(ho->mrru, ao->mru); + if (demand) { + cfg_bundle(go->mrru, ho->mrru, go->neg_ssnhf, ho->neg_ssnhf); + netif_set_mtu(pcb, mtu); + script_setenv("BUNDLE", bundle_id + 7, 1); + return 0; + } + + /* + * Check if the bundle ID is already in the database. + */ + unit = -1; + lock_db(); + key.dptr = bundle_id; + key.dsize = p - bundle_id; + pid = tdb_fetch(pppdb, key); + if (pid.dptr != NULL) { + /* bundle ID exists, see if the pppd record exists */ + rec = tdb_fetch(pppdb, pid); + if (rec.dptr != NULL && rec.dsize > 0) { + /* make sure the string is null-terminated */ + rec.dptr[rec.dsize-1] = 0; + /* parse the interface number */ + parse_num(rec.dptr, "IFNAME=ppp", &unit); + /* check the pid value */ + if (!parse_num(rec.dptr, "PPPD_PID=", &pppd_pid) + || !process_exists(pppd_pid) + || !owns_unit(pid, unit)) + unit = -1; + free(rec.dptr); + } + free(pid.dptr); + } + + if (unit >= 0) { + /* attach to existing unit */ + if (bundle_attach(unit)) { + set_ifunit(0); + script_setenv("BUNDLE", bundle_id + 7, 0); + make_bundle_links(1); + unlock_db(); + info("Link attached to %s", ifname); + return 1; + } + /* attach failed because bundle doesn't exist */ + } + + /* we have to make a new bundle */ + make_new_bundle(go->mrru, ho->mrru, go->neg_ssnhf, ho->neg_ssnhf); + set_ifunit(1); + netif_set_mtu(pcb, mtu); + script_setenv("BUNDLE", bundle_id + 7, 1); + make_bundle_links(pcb); + unlock_db(); + info("New bundle %s created", ifname); + multilink_master = 1; + return 0; +} + +void mp_exit_bundle() +{ + lock_db(); + remove_bundle_link(); + unlock_db(); +} + +static void sendhup(char *str) +{ + int pid; + + if (parse_num(str, "PPPD_PID=", &pid) && pid != getpid()) { + if (debug) + dbglog("sending SIGHUP to process %d", pid); + kill(pid, SIGHUP); + } +} + +void mp_bundle_terminated() +{ + TDB_DATA key; + + bundle_terminating = 1; + upper_layers_down(pcb); + notice("Connection terminated."); +#if PPP_STATS_SUPPORT + print_link_stats(); +#endif /* PPP_STATS_SUPPORT */ + if (!demand) { + remove_pidfiles(); + script_unsetenv("IFNAME"); + } + + lock_db(); + destroy_bundle(); + iterate_bundle_links(sendhup); + key.dptr = blinks_id; + key.dsize = strlen(blinks_id); + tdb_delete(pppdb, key); + unlock_db(); + + new_phase(PPP_PHASE_DEAD); + + doing_multilink = 0; + multilink_master = 0; +} + +static void make_bundle_links(int append) +{ + TDB_DATA key, rec; + char *p; + char entry[32]; + int l; + + key.dptr = blinks_id; + key.dsize = strlen(blinks_id); + slprintf(entry, sizeof(entry), "%s;", db_key); + p = entry; + if (append) { + rec = tdb_fetch(pppdb, key); + if (rec.dptr != NULL && rec.dsize > 0) { + rec.dptr[rec.dsize-1] = 0; + if (strstr(rec.dptr, db_key) != NULL) { + /* already in there? strange */ + warn("link entry already exists in tdb"); + return; + } + l = rec.dsize + strlen(entry); + p = malloc(l); + if (p == NULL) + novm("bundle link list"); + slprintf(p, l, "%s%s", rec.dptr, entry); + } else { + warn("bundle link list not found"); + } + if (rec.dptr != NULL) + free(rec.dptr); + } + rec.dptr = p; + rec.dsize = strlen(p) + 1; + if (tdb_store(pppdb, key, rec, TDB_REPLACE)) + error("couldn't %s bundle link list", + append? "update": "create"); + if (p != entry) + free(p); +} + +static void remove_bundle_link() +{ + TDB_DATA key, rec; + char entry[32]; + char *p, *q; + int l; + + key.dptr = blinks_id; + key.dsize = strlen(blinks_id); + slprintf(entry, sizeof(entry), "%s;", db_key); + + rec = tdb_fetch(pppdb, key); + if (rec.dptr == NULL || rec.dsize <= 0) { + if (rec.dptr != NULL) + free(rec.dptr); + return; + } + rec.dptr[rec.dsize-1] = 0; + p = strstr(rec.dptr, entry); + if (p != NULL) { + q = p + strlen(entry); + l = strlen(q) + 1; + memmove(p, q, l); + rec.dsize = p - rec.dptr + l; + if (tdb_store(pppdb, key, rec, TDB_REPLACE)) + error("couldn't update bundle link list (removal)"); + } + free(rec.dptr); +} + +static void iterate_bundle_links(void (*func)(char *)) +{ + TDB_DATA key, rec, pp; + char *p, *q; + + key.dptr = blinks_id; + key.dsize = strlen(blinks_id); + rec = tdb_fetch(pppdb, key); + if (rec.dptr == NULL || rec.dsize <= 0) { + error("bundle link list not found (iterating list)"); + if (rec.dptr != NULL) + free(rec.dptr); + return; + } + p = rec.dptr; + p[rec.dsize-1] = 0; + while ((q = strchr(p, ';')) != NULL) { + *q = 0; + key.dptr = p; + key.dsize = q - p; + pp = tdb_fetch(pppdb, key); + if (pp.dptr != NULL && pp.dsize > 0) { + pp.dptr[pp.dsize-1] = 0; + func(pp.dptr); + } + if (pp.dptr != NULL) + free(pp.dptr); + p = q + 1; + } + free(rec.dptr); +} + +static int +parse_num(str, key, valp) + char *str; + const char *key; + int *valp; +{ + char *p, *endp; + int i; + + p = strstr(str, key); + if (p != 0) { + p += strlen(key); + i = strtol(p, &endp, 10); + if (endp != p && (*endp == 0 || *endp == ';')) { + *valp = i; + return 1; + } + } + return 0; +} + +/* + * Check whether the pppd identified by `key' still owns ppp unit `unit'. + */ +static int +owns_unit(key, unit) + TDB_DATA key; + int unit; +{ + char ifkey[32]; + TDB_DATA kd, vd; + int ret = 0; + + slprintf(ifkey, sizeof(ifkey), "IFNAME=ppp%d", unit); + kd.dptr = ifkey; + kd.dsize = strlen(ifkey); + vd = tdb_fetch(pppdb, kd); + if (vd.dptr != NULL) { + ret = vd.dsize == key.dsize + && memcmp(vd.dptr, key.dptr, vd.dsize) == 0; + free(vd.dptr); + } + return ret; +} + +static int +get_default_epdisc(ep) + struct epdisc *ep; +{ + char *p; + struct hostent *hp; + u32_t addr; + + /* First try for an ethernet MAC address */ + p = get_first_ethernet(); + if (p != 0 && get_if_hwaddr(ep->value, p) >= 0) { + ep->class = EPD_MAC; + ep->length = 6; + return 1; + } + + /* see if our hostname corresponds to a reasonable IP address */ + hp = gethostbyname(hostname); + if (hp != NULL) { + addr = *(u32_t *)hp->h_addr; + if (!bad_ip_adrs(addr)) { + addr = ntohl(addr); + if (!LOCAL_IP_ADDR(addr)) { + ep->class = EPD_IP; + set_ip_epdisc(ep, addr); + return 1; + } + } + } + + return 0; +} + +/* + * epdisc_to_str - make a printable string from an endpoint discriminator. + */ + +static char *endp_class_names[] = { + "null", "local", "IP", "MAC", "magic", "phone" +}; + +char * +epdisc_to_str(ep) + struct epdisc *ep; +{ + static char str[MAX_ENDP_LEN*3+8]; + u_char *p = ep->value; + int i, mask = 0; + char *q, c, c2; + + if (ep->class == EPD_NULL && ep->length == 0) + return "null"; + if (ep->class == EPD_IP && ep->length == 4) { + u32_t addr; + + GETLONG(addr, p); + slprintf(str, sizeof(str), "IP:%I", htonl(addr)); + return str; + } + + c = ':'; + c2 = '.'; + if (ep->class == EPD_MAC && ep->length == 6) + c2 = ':'; + else if (ep->class == EPD_MAGIC && (ep->length % 4) == 0) + mask = 3; + q = str; + if (ep->class <= EPD_PHONENUM) + q += slprintf(q, sizeof(str)-1, "%s", + endp_class_names[ep->class]); + else + q += slprintf(q, sizeof(str)-1, "%d", ep->class); + c = ':'; + for (i = 0; i < ep->length && i < MAX_ENDP_LEN; ++i) { + if ((i & mask) == 0) { + *q++ = c; + c = c2; + } + q += slprintf(q, str + sizeof(str) - q, "%.2x", ep->value[i]); + } + return str; +} + +static int hexc_val(int c) +{ + if (c >= 'a') + return c - 'a' + 10; + if (c >= 'A') + return c - 'A' + 10; + return c - '0'; +} + +int +str_to_epdisc(ep, str) + struct epdisc *ep; + char *str; +{ + int i, l; + char *p, *endp; + + for (i = EPD_NULL; i <= EPD_PHONENUM; ++i) { + int sl = strlen(endp_class_names[i]); + if (strncasecmp(str, endp_class_names[i], sl) == 0) { + str += sl; + break; + } + } + if (i > EPD_PHONENUM) { + /* not a class name, try a decimal class number */ + i = strtol(str, &endp, 10); + if (endp == str) + return 0; /* can't parse class number */ + str = endp; + } + ep->class = i; + if (*str == 0) { + ep->length = 0; + return 1; + } + if (*str != ':' && *str != '.') + return 0; + ++str; + + if (i == EPD_IP) { + u32_t addr; + i = parse_dotted_ip(str, &addr); + if (i == 0 || str[i] != 0) + return 0; + set_ip_epdisc(ep, addr); + return 1; + } + if (i == EPD_MAC && get_if_hwaddr(ep->value, str) >= 0) { + ep->length = 6; + return 1; + } + + p = str; + for (l = 0; l < MAX_ENDP_LEN; ++l) { + if (*str == 0) + break; + if (p <= str) + for (p = str; isxdigit(*p); ++p) + ; + i = p - str; + if (i == 0) + return 0; + ep->value[l] = hexc_val(*str++); + if ((i & 1) == 0) + ep->value[l] = (ep->value[l] << 4) + hexc_val(*str++); + if (*str == ':' || *str == '.') + ++str; + } + if (*str != 0 || (ep->class == EPD_MAC && l != 6)) + return 0; + ep->length = l; + return 1; +} + +#endif /* PPP_SUPPORT && HAVE_MULTILINK */ diff --git a/components/lwip/netif/ppp/polarssl/README b/components/lwip/netif/ppp/polarssl/README new file mode 100755 index 000000000..ff6e44db2 --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/README @@ -0,0 +1,33 @@ +About PolarSSL files into lwIP PPP support +------------------------------------------ + +This folder contains some files fetched from the latest BSD release of +the PolarSSL project for ciphers and encryption methods we need for lwIP +PPP support. + +The PolarSSL files were cleaned to contain only the necessary struct +fields and functions needed for lwIP. + + +The PolarSSL API was not changed at all, so if you are already using +PolarSSL you can choose to skip the compilation of the included PolarSSL +library into lwIP: + +The following defines are available for flexibility: + +LWIP_INCLUDED_POLARSSL_MD4 ; Use lwIP internal PolarSSL for MD4 +LWIP_INCLUDED_POLARSSL_MD5 ; Use lwIP internal PolarSSL for MD5 +LWIP_INCLUDED_POLARSSL_SHA1 ; Use lwIP internal PolarSSL for SHA1 +LWIP_INCLUDED_POLARSSL_DES ; Use lwIP internal PolarSSL for DES +LWIP_INCLUDED_POLARSSL_ARC4 ; Use lwIP internal PolarSSL for ARC4 + +If set (=1), the default if required by another enabled PPP feature unless +explicitly set to 0, using included lwIP PolarSSL. + +If clear (=0), not needed or using external PolarSSL. + +Beware of the stack requirements which can be a lot larger if you are not +using our cleaned PolarSSL library. + + +PolarSSL project website: http://polarssl.org/ diff --git a/components/lwip/netif/ppp/polarssl/arc4.c b/components/lwip/netif/ppp/polarssl/arc4.c new file mode 100755 index 000000000..ca5000e7f --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/arc4.c @@ -0,0 +1,101 @@ +/* + * An implementation of the ARCFOUR algorithm + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +/* + * The ARCFOUR algorithm was publicly disclosed on 94/09. + * + * http://groups.google.com/group/sci.crypt/msg/10a300c9d21afca0 + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_ARC4 + +#include "netif/ppp/polarssl/arc4.h" +/* + * ARC4 key schedule + */ +void arc4_setup( arc4_context *ctx, unsigned char *key, int keylen ) +{ + int i, j, k, a; + unsigned char *m; + + ctx->x = 0; + ctx->y = 0; + m = ctx->m; + + for( i = 0; i < 256; i++ ) + m[i] = (unsigned char) i; + + j = k = 0; + + for( i = 0; i < 256; i++, k++ ) + { + if( k >= keylen ) k = 0; + + a = m[i]; + j = ( j + a + key[k] ) & 0xFF; + m[i] = m[j]; + m[j] = (unsigned char) a; + } +} + +/* + * ARC4 cipher function + */ +void arc4_crypt( arc4_context *ctx, unsigned char *buf, int buflen ) +{ + int i, x, y, a, b; + unsigned char *m; + + x = ctx->x; + y = ctx->y; + m = ctx->m; + + for( i = 0; i < buflen; i++ ) + { + x = ( x + 1 ) & 0xFF; a = m[x]; + y = ( y + a ) & 0xFF; b = m[y]; + + m[x] = (unsigned char) b; + m[y] = (unsigned char) a; + + buf[i] = (unsigned char) + ( buf[i] ^ m[(unsigned char)( a + b )] ); + } + + ctx->x = x; + ctx->y = y; +} + +#endif /* PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_DES */ diff --git a/components/lwip/netif/ppp/polarssl/des.c b/components/lwip/netif/ppp/polarssl/des.c new file mode 100755 index 000000000..0d6af8496 --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/des.c @@ -0,0 +1,422 @@ +/* + * FIPS-46-3 compliant Triple-DES implementation + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +/* + * DES, on which TDES is based, was originally designed by Horst Feistel + * at IBM in 1974, and was adopted as a standard by NIST (formerly NBS). + * + * http://csrc.nist.gov/publications/fips/fips46-3/fips46-3.pdf + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_DES + +#include "netif/ppp/polarssl/des.h" + +/* + * 32-bit integer manipulation macros (big endian) + */ +#ifndef GET_ULONG_BE +#define GET_ULONG_BE(n,b,i) \ +{ \ + (n) = ( (unsigned long) (b)[(i) ] << 24 ) \ + | ( (unsigned long) (b)[(i) + 1] << 16 ) \ + | ( (unsigned long) (b)[(i) + 2] << 8 ) \ + | ( (unsigned long) (b)[(i) + 3] ); \ +} +#endif + +#ifndef PUT_ULONG_BE +#define PUT_ULONG_BE(n,b,i) \ +{ \ + (b)[(i) ] = (unsigned char) ( (n) >> 24 ); \ + (b)[(i) + 1] = (unsigned char) ( (n) >> 16 ); \ + (b)[(i) + 2] = (unsigned char) ( (n) >> 8 ); \ + (b)[(i) + 3] = (unsigned char) ( (n) ); \ +} +#endif + +/* + * Expanded DES S-boxes + */ +static const unsigned long SB1[64] = +{ + 0x01010400, 0x00000000, 0x00010000, 0x01010404, + 0x01010004, 0x00010404, 0x00000004, 0x00010000, + 0x00000400, 0x01010400, 0x01010404, 0x00000400, + 0x01000404, 0x01010004, 0x01000000, 0x00000004, + 0x00000404, 0x01000400, 0x01000400, 0x00010400, + 0x00010400, 0x01010000, 0x01010000, 0x01000404, + 0x00010004, 0x01000004, 0x01000004, 0x00010004, + 0x00000000, 0x00000404, 0x00010404, 0x01000000, + 0x00010000, 0x01010404, 0x00000004, 0x01010000, + 0x01010400, 0x01000000, 0x01000000, 0x00000400, + 0x01010004, 0x00010000, 0x00010400, 0x01000004, + 0x00000400, 0x00000004, 0x01000404, 0x00010404, + 0x01010404, 0x00010004, 0x01010000, 0x01000404, + 0x01000004, 0x00000404, 0x00010404, 0x01010400, + 0x00000404, 0x01000400, 0x01000400, 0x00000000, + 0x00010004, 0x00010400, 0x00000000, 0x01010004 +}; + +static const unsigned long SB2[64] = +{ + 0x80108020, 0x80008000, 0x00008000, 0x00108020, + 0x00100000, 0x00000020, 0x80100020, 0x80008020, + 0x80000020, 0x80108020, 0x80108000, 0x80000000, + 0x80008000, 0x00100000, 0x00000020, 0x80100020, + 0x00108000, 0x00100020, 0x80008020, 0x00000000, + 0x80000000, 0x00008000, 0x00108020, 0x80100000, + 0x00100020, 0x80000020, 0x00000000, 0x00108000, + 0x00008020, 0x80108000, 0x80100000, 0x00008020, + 0x00000000, 0x00108020, 0x80100020, 0x00100000, + 0x80008020, 0x80100000, 0x80108000, 0x00008000, + 0x80100000, 0x80008000, 0x00000020, 0x80108020, + 0x00108020, 0x00000020, 0x00008000, 0x80000000, + 0x00008020, 0x80108000, 0x00100000, 0x80000020, + 0x00100020, 0x80008020, 0x80000020, 0x00100020, + 0x00108000, 0x00000000, 0x80008000, 0x00008020, + 0x80000000, 0x80100020, 0x80108020, 0x00108000 +}; + +static const unsigned long SB3[64] = +{ + 0x00000208, 0x08020200, 0x00000000, 0x08020008, + 0x08000200, 0x00000000, 0x00020208, 0x08000200, + 0x00020008, 0x08000008, 0x08000008, 0x00020000, + 0x08020208, 0x00020008, 0x08020000, 0x00000208, + 0x08000000, 0x00000008, 0x08020200, 0x00000200, + 0x00020200, 0x08020000, 0x08020008, 0x00020208, + 0x08000208, 0x00020200, 0x00020000, 0x08000208, + 0x00000008, 0x08020208, 0x00000200, 0x08000000, + 0x08020200, 0x08000000, 0x00020008, 0x00000208, + 0x00020000, 0x08020200, 0x08000200, 0x00000000, + 0x00000200, 0x00020008, 0x08020208, 0x08000200, + 0x08000008, 0x00000200, 0x00000000, 0x08020008, + 0x08000208, 0x00020000, 0x08000000, 0x08020208, + 0x00000008, 0x00020208, 0x00020200, 0x08000008, + 0x08020000, 0x08000208, 0x00000208, 0x08020000, + 0x00020208, 0x00000008, 0x08020008, 0x00020200 +}; + +static const unsigned long SB4[64] = +{ + 0x00802001, 0x00002081, 0x00002081, 0x00000080, + 0x00802080, 0x00800081, 0x00800001, 0x00002001, + 0x00000000, 0x00802000, 0x00802000, 0x00802081, + 0x00000081, 0x00000000, 0x00800080, 0x00800001, + 0x00000001, 0x00002000, 0x00800000, 0x00802001, + 0x00000080, 0x00800000, 0x00002001, 0x00002080, + 0x00800081, 0x00000001, 0x00002080, 0x00800080, + 0x00002000, 0x00802080, 0x00802081, 0x00000081, + 0x00800080, 0x00800001, 0x00802000, 0x00802081, + 0x00000081, 0x00000000, 0x00000000, 0x00802000, + 0x00002080, 0x00800080, 0x00800081, 0x00000001, + 0x00802001, 0x00002081, 0x00002081, 0x00000080, + 0x00802081, 0x00000081, 0x00000001, 0x00002000, + 0x00800001, 0x00002001, 0x00802080, 0x00800081, + 0x00002001, 0x00002080, 0x00800000, 0x00802001, + 0x00000080, 0x00800000, 0x00002000, 0x00802080 +}; + +static const unsigned long SB5[64] = +{ + 0x00000100, 0x02080100, 0x02080000, 0x42000100, + 0x00080000, 0x00000100, 0x40000000, 0x02080000, + 0x40080100, 0x00080000, 0x02000100, 0x40080100, + 0x42000100, 0x42080000, 0x00080100, 0x40000000, + 0x02000000, 0x40080000, 0x40080000, 0x00000000, + 0x40000100, 0x42080100, 0x42080100, 0x02000100, + 0x42080000, 0x40000100, 0x00000000, 0x42000000, + 0x02080100, 0x02000000, 0x42000000, 0x00080100, + 0x00080000, 0x42000100, 0x00000100, 0x02000000, + 0x40000000, 0x02080000, 0x42000100, 0x40080100, + 0x02000100, 0x40000000, 0x42080000, 0x02080100, + 0x40080100, 0x00000100, 0x02000000, 0x42080000, + 0x42080100, 0x00080100, 0x42000000, 0x42080100, + 0x02080000, 0x00000000, 0x40080000, 0x42000000, + 0x00080100, 0x02000100, 0x40000100, 0x00080000, + 0x00000000, 0x40080000, 0x02080100, 0x40000100 +}; + +static const unsigned long SB6[64] = +{ + 0x20000010, 0x20400000, 0x00004000, 0x20404010, + 0x20400000, 0x00000010, 0x20404010, 0x00400000, + 0x20004000, 0x00404010, 0x00400000, 0x20000010, + 0x00400010, 0x20004000, 0x20000000, 0x00004010, + 0x00000000, 0x00400010, 0x20004010, 0x00004000, + 0x00404000, 0x20004010, 0x00000010, 0x20400010, + 0x20400010, 0x00000000, 0x00404010, 0x20404000, + 0x00004010, 0x00404000, 0x20404000, 0x20000000, + 0x20004000, 0x00000010, 0x20400010, 0x00404000, + 0x20404010, 0x00400000, 0x00004010, 0x20000010, + 0x00400000, 0x20004000, 0x20000000, 0x00004010, + 0x20000010, 0x20404010, 0x00404000, 0x20400000, + 0x00404010, 0x20404000, 0x00000000, 0x20400010, + 0x00000010, 0x00004000, 0x20400000, 0x00404010, + 0x00004000, 0x00400010, 0x20004010, 0x00000000, + 0x20404000, 0x20000000, 0x00400010, 0x20004010 +}; + +static const unsigned long SB7[64] = +{ + 0x00200000, 0x04200002, 0x04000802, 0x00000000, + 0x00000800, 0x04000802, 0x00200802, 0x04200800, + 0x04200802, 0x00200000, 0x00000000, 0x04000002, + 0x00000002, 0x04000000, 0x04200002, 0x00000802, + 0x04000800, 0x00200802, 0x00200002, 0x04000800, + 0x04000002, 0x04200000, 0x04200800, 0x00200002, + 0x04200000, 0x00000800, 0x00000802, 0x04200802, + 0x00200800, 0x00000002, 0x04000000, 0x00200800, + 0x04000000, 0x00200800, 0x00200000, 0x04000802, + 0x04000802, 0x04200002, 0x04200002, 0x00000002, + 0x00200002, 0x04000000, 0x04000800, 0x00200000, + 0x04200800, 0x00000802, 0x00200802, 0x04200800, + 0x00000802, 0x04000002, 0x04200802, 0x04200000, + 0x00200800, 0x00000000, 0x00000002, 0x04200802, + 0x00000000, 0x00200802, 0x04200000, 0x00000800, + 0x04000002, 0x04000800, 0x00000800, 0x00200002 +}; + +static const unsigned long SB8[64] = +{ + 0x10001040, 0x00001000, 0x00040000, 0x10041040, + 0x10000000, 0x10001040, 0x00000040, 0x10000000, + 0x00040040, 0x10040000, 0x10041040, 0x00041000, + 0x10041000, 0x00041040, 0x00001000, 0x00000040, + 0x10040000, 0x10000040, 0x10001000, 0x00001040, + 0x00041000, 0x00040040, 0x10040040, 0x10041000, + 0x00001040, 0x00000000, 0x00000000, 0x10040040, + 0x10000040, 0x10001000, 0x00041040, 0x00040000, + 0x00041040, 0x00040000, 0x10041000, 0x00001000, + 0x00000040, 0x10040040, 0x00001000, 0x00041040, + 0x10001000, 0x00000040, 0x10000040, 0x10040000, + 0x10040040, 0x10000000, 0x00040000, 0x10001040, + 0x00000000, 0x10041040, 0x00040040, 0x10000040, + 0x10040000, 0x10001000, 0x10001040, 0x00000000, + 0x10041040, 0x00041000, 0x00041000, 0x00001040, + 0x00001040, 0x00040040, 0x10000000, 0x10041000 +}; + +/* + * PC1: left and right halves bit-swap + */ +static const unsigned long LHs[16] = +{ + 0x00000000, 0x00000001, 0x00000100, 0x00000101, + 0x00010000, 0x00010001, 0x00010100, 0x00010101, + 0x01000000, 0x01000001, 0x01000100, 0x01000101, + 0x01010000, 0x01010001, 0x01010100, 0x01010101 +}; + +static const unsigned long RHs[16] = +{ + 0x00000000, 0x01000000, 0x00010000, 0x01010000, + 0x00000100, 0x01000100, 0x00010100, 0x01010100, + 0x00000001, 0x01000001, 0x00010001, 0x01010001, + 0x00000101, 0x01000101, 0x00010101, 0x01010101, +}; + +/* + * Initial Permutation macro + */ +#define DES_IP(X,Y) \ +{ \ + T = ((X >> 4) ^ Y) & 0x0F0F0F0F; Y ^= T; X ^= (T << 4); \ + T = ((X >> 16) ^ Y) & 0x0000FFFF; Y ^= T; X ^= (T << 16); \ + T = ((Y >> 2) ^ X) & 0x33333333; X ^= T; Y ^= (T << 2); \ + T = ((Y >> 8) ^ X) & 0x00FF00FF; X ^= T; Y ^= (T << 8); \ + Y = ((Y << 1) | (Y >> 31)) & 0xFFFFFFFF; \ + T = (X ^ Y) & 0xAAAAAAAA; Y ^= T; X ^= T; \ + X = ((X << 1) | (X >> 31)) & 0xFFFFFFFF; \ +} + +/* + * Final Permutation macro + */ +#define DES_FP(X,Y) \ +{ \ + X = ((X << 31) | (X >> 1)) & 0xFFFFFFFF; \ + T = (X ^ Y) & 0xAAAAAAAA; X ^= T; Y ^= T; \ + Y = ((Y << 31) | (Y >> 1)) & 0xFFFFFFFF; \ + T = ((Y >> 8) ^ X) & 0x00FF00FF; X ^= T; Y ^= (T << 8); \ + T = ((Y >> 2) ^ X) & 0x33333333; X ^= T; Y ^= (T << 2); \ + T = ((X >> 16) ^ Y) & 0x0000FFFF; Y ^= T; X ^= (T << 16); \ + T = ((X >> 4) ^ Y) & 0x0F0F0F0F; Y ^= T; X ^= (T << 4); \ +} + +/* + * DES round macro + */ +#define DES_ROUND(X,Y) \ +{ \ + T = *SK++ ^ X; \ + Y ^= SB8[ (T ) & 0x3F ] ^ \ + SB6[ (T >> 8) & 0x3F ] ^ \ + SB4[ (T >> 16) & 0x3F ] ^ \ + SB2[ (T >> 24) & 0x3F ]; \ + \ + T = *SK++ ^ ((X << 28) | (X >> 4)); \ + Y ^= SB7[ (T ) & 0x3F ] ^ \ + SB5[ (T >> 8) & 0x3F ] ^ \ + SB3[ (T >> 16) & 0x3F ] ^ \ + SB1[ (T >> 24) & 0x3F ]; \ +} + +#define SWAP(a,b) { unsigned long t = a; a = b; b = t; t = 0; } + +static void des_setkey( unsigned long SK[32], unsigned char key[8] ) +{ + int i; + unsigned long X, Y, T; + + GET_ULONG_BE( X, key, 0 ); + GET_ULONG_BE( Y, key, 4 ); + + /* + * Permuted Choice 1 + */ + T = ((Y >> 4) ^ X) & 0x0F0F0F0F; X ^= T; Y ^= (T << 4); + T = ((Y ) ^ X) & 0x10101010; X ^= T; Y ^= (T ); + + X = (LHs[ (X ) & 0xF] << 3) | (LHs[ (X >> 8) & 0xF ] << 2) + | (LHs[ (X >> 16) & 0xF] << 1) | (LHs[ (X >> 24) & 0xF ] ) + | (LHs[ (X >> 5) & 0xF] << 7) | (LHs[ (X >> 13) & 0xF ] << 6) + | (LHs[ (X >> 21) & 0xF] << 5) | (LHs[ (X >> 29) & 0xF ] << 4); + + Y = (RHs[ (Y >> 1) & 0xF] << 3) | (RHs[ (Y >> 9) & 0xF ] << 2) + | (RHs[ (Y >> 17) & 0xF] << 1) | (RHs[ (Y >> 25) & 0xF ] ) + | (RHs[ (Y >> 4) & 0xF] << 7) | (RHs[ (Y >> 12) & 0xF ] << 6) + | (RHs[ (Y >> 20) & 0xF] << 5) | (RHs[ (Y >> 28) & 0xF ] << 4); + + X &= 0x0FFFFFFF; + Y &= 0x0FFFFFFF; + + /* + * calculate subkeys + */ + for( i = 0; i < 16; i++ ) + { + if( i < 2 || i == 8 || i == 15 ) + { + X = ((X << 1) | (X >> 27)) & 0x0FFFFFFF; + Y = ((Y << 1) | (Y >> 27)) & 0x0FFFFFFF; + } + else + { + X = ((X << 2) | (X >> 26)) & 0x0FFFFFFF; + Y = ((Y << 2) | (Y >> 26)) & 0x0FFFFFFF; + } + + *SK++ = ((X << 4) & 0x24000000) | ((X << 28) & 0x10000000) + | ((X << 14) & 0x08000000) | ((X << 18) & 0x02080000) + | ((X << 6) & 0x01000000) | ((X << 9) & 0x00200000) + | ((X >> 1) & 0x00100000) | ((X << 10) & 0x00040000) + | ((X << 2) & 0x00020000) | ((X >> 10) & 0x00010000) + | ((Y >> 13) & 0x00002000) | ((Y >> 4) & 0x00001000) + | ((Y << 6) & 0x00000800) | ((Y >> 1) & 0x00000400) + | ((Y >> 14) & 0x00000200) | ((Y ) & 0x00000100) + | ((Y >> 5) & 0x00000020) | ((Y >> 10) & 0x00000010) + | ((Y >> 3) & 0x00000008) | ((Y >> 18) & 0x00000004) + | ((Y >> 26) & 0x00000002) | ((Y >> 24) & 0x00000001); + + *SK++ = ((X << 15) & 0x20000000) | ((X << 17) & 0x10000000) + | ((X << 10) & 0x08000000) | ((X << 22) & 0x04000000) + | ((X >> 2) & 0x02000000) | ((X << 1) & 0x01000000) + | ((X << 16) & 0x00200000) | ((X << 11) & 0x00100000) + | ((X << 3) & 0x00080000) | ((X >> 6) & 0x00040000) + | ((X << 15) & 0x00020000) | ((X >> 4) & 0x00010000) + | ((Y >> 2) & 0x00002000) | ((Y << 8) & 0x00001000) + | ((Y >> 14) & 0x00000808) | ((Y >> 9) & 0x00000400) + | ((Y ) & 0x00000200) | ((Y << 7) & 0x00000100) + | ((Y >> 7) & 0x00000020) | ((Y >> 3) & 0x00000011) + | ((Y << 2) & 0x00000004) | ((Y >> 21) & 0x00000002); + } +} + +/* + * DES key schedule (56-bit, encryption) + */ +void des_setkey_enc( des_context *ctx, unsigned char key[8] ) +{ + des_setkey( ctx->sk, key ); +} + +/* + * DES key schedule (56-bit, decryption) + */ +void des_setkey_dec( des_context *ctx, unsigned char key[8] ) +{ + int i; + + des_setkey( ctx->sk, key ); + + for( i = 0; i < 16; i += 2 ) + { + SWAP( ctx->sk[i ], ctx->sk[30 - i] ); + SWAP( ctx->sk[i + 1], ctx->sk[31 - i] ); + } +} + +/* + * DES-ECB block encryption/decryption + */ +void des_crypt_ecb( des_context *ctx, + const unsigned char input[8], + unsigned char output[8] ) +{ + int i; + unsigned long X, Y, T, *SK; + + SK = ctx->sk; + + GET_ULONG_BE( X, input, 0 ); + GET_ULONG_BE( Y, input, 4 ); + + DES_IP( X, Y ); + + for( i = 0; i < 8; i++ ) + { + DES_ROUND( Y, X ); + DES_ROUND( X, Y ); + } + + DES_FP( Y, X ); + + PUT_ULONG_BE( Y, output, 0 ); + PUT_ULONG_BE( X, output, 4 ); +} + +#endif /* PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_DES */ diff --git a/components/lwip/netif/ppp/polarssl/md4.c b/components/lwip/netif/ppp/polarssl/md4.c new file mode 100755 index 000000000..b134cba92 --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/md4.c @@ -0,0 +1,281 @@ +/* + * RFC 1186/1320 compliant MD4 implementation + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +/* + * The MD4 algorithm was designed by Ron Rivest in 1990. + * + * http://www.ietf.org/rfc/rfc1186.txt + * http://www.ietf.org/rfc/rfc1320.txt + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_MD4 + +#include "netif/ppp/polarssl/md4.h" + +#include + +/* + * 32-bit integer manipulation macros (little endian) + */ +#ifndef GET_ULONG_LE +#define GET_ULONG_LE(n,b,i) \ +{ \ + (n) = ( (unsigned long) (b)[(i) ] ) \ + | ( (unsigned long) (b)[(i) + 1] << 8 ) \ + | ( (unsigned long) (b)[(i) + 2] << 16 ) \ + | ( (unsigned long) (b)[(i) + 3] << 24 ); \ +} +#endif + +#ifndef PUT_ULONG_LE +#define PUT_ULONG_LE(n,b,i) \ +{ \ + (b)[(i) ] = (unsigned char) ( (n) ); \ + (b)[(i) + 1] = (unsigned char) ( (n) >> 8 ); \ + (b)[(i) + 2] = (unsigned char) ( (n) >> 16 ); \ + (b)[(i) + 3] = (unsigned char) ( (n) >> 24 ); \ +} +#endif + +/* + * MD4 context setup + */ +void md4_starts( md4_context *ctx ) +{ + ctx->total[0] = 0; + ctx->total[1] = 0; + + ctx->state[0] = 0x67452301; + ctx->state[1] = 0xEFCDAB89; + ctx->state[2] = 0x98BADCFE; + ctx->state[3] = 0x10325476; +} + +static void md4_process( md4_context *ctx, const unsigned char data[64] ) +{ + unsigned long X[16], A, B, C, D; + + GET_ULONG_LE( X[ 0], data, 0 ); + GET_ULONG_LE( X[ 1], data, 4 ); + GET_ULONG_LE( X[ 2], data, 8 ); + GET_ULONG_LE( X[ 3], data, 12 ); + GET_ULONG_LE( X[ 4], data, 16 ); + GET_ULONG_LE( X[ 5], data, 20 ); + GET_ULONG_LE( X[ 6], data, 24 ); + GET_ULONG_LE( X[ 7], data, 28 ); + GET_ULONG_LE( X[ 8], data, 32 ); + GET_ULONG_LE( X[ 9], data, 36 ); + GET_ULONG_LE( X[10], data, 40 ); + GET_ULONG_LE( X[11], data, 44 ); + GET_ULONG_LE( X[12], data, 48 ); + GET_ULONG_LE( X[13], data, 52 ); + GET_ULONG_LE( X[14], data, 56 ); + GET_ULONG_LE( X[15], data, 60 ); + +#define S(x,n) ((x << n) | ((x & 0xFFFFFFFF) >> (32 - n))) + + A = ctx->state[0]; + B = ctx->state[1]; + C = ctx->state[2]; + D = ctx->state[3]; + +#define F(x, y, z) ((x & y) | ((~x) & z)) +#define P(a,b,c,d,x,s) { a += F(b,c,d) + x; a = S(a,s); } + + P( A, B, C, D, X[ 0], 3 ); + P( D, A, B, C, X[ 1], 7 ); + P( C, D, A, B, X[ 2], 11 ); + P( B, C, D, A, X[ 3], 19 ); + P( A, B, C, D, X[ 4], 3 ); + P( D, A, B, C, X[ 5], 7 ); + P( C, D, A, B, X[ 6], 11 ); + P( B, C, D, A, X[ 7], 19 ); + P( A, B, C, D, X[ 8], 3 ); + P( D, A, B, C, X[ 9], 7 ); + P( C, D, A, B, X[10], 11 ); + P( B, C, D, A, X[11], 19 ); + P( A, B, C, D, X[12], 3 ); + P( D, A, B, C, X[13], 7 ); + P( C, D, A, B, X[14], 11 ); + P( B, C, D, A, X[15], 19 ); + +#undef P +#undef F + +#define F(x,y,z) ((x & y) | (x & z) | (y & z)) +#define P(a,b,c,d,x,s) { a += F(b,c,d) + x + 0x5A827999; a = S(a,s); } + + P( A, B, C, D, X[ 0], 3 ); + P( D, A, B, C, X[ 4], 5 ); + P( C, D, A, B, X[ 8], 9 ); + P( B, C, D, A, X[12], 13 ); + P( A, B, C, D, X[ 1], 3 ); + P( D, A, B, C, X[ 5], 5 ); + P( C, D, A, B, X[ 9], 9 ); + P( B, C, D, A, X[13], 13 ); + P( A, B, C, D, X[ 2], 3 ); + P( D, A, B, C, X[ 6], 5 ); + P( C, D, A, B, X[10], 9 ); + P( B, C, D, A, X[14], 13 ); + P( A, B, C, D, X[ 3], 3 ); + P( D, A, B, C, X[ 7], 5 ); + P( C, D, A, B, X[11], 9 ); + P( B, C, D, A, X[15], 13 ); + +#undef P +#undef F + +#define F(x,y,z) (x ^ y ^ z) +#define P(a,b,c,d,x,s) { a += F(b,c,d) + x + 0x6ED9EBA1; a = S(a,s); } + + P( A, B, C, D, X[ 0], 3 ); + P( D, A, B, C, X[ 8], 9 ); + P( C, D, A, B, X[ 4], 11 ); + P( B, C, D, A, X[12], 15 ); + P( A, B, C, D, X[ 2], 3 ); + P( D, A, B, C, X[10], 9 ); + P( C, D, A, B, X[ 6], 11 ); + P( B, C, D, A, X[14], 15 ); + P( A, B, C, D, X[ 1], 3 ); + P( D, A, B, C, X[ 9], 9 ); + P( C, D, A, B, X[ 5], 11 ); + P( B, C, D, A, X[13], 15 ); + P( A, B, C, D, X[ 3], 3 ); + P( D, A, B, C, X[11], 9 ); + P( C, D, A, B, X[ 7], 11 ); + P( B, C, D, A, X[15], 15 ); + +#undef F +#undef P + + ctx->state[0] += A; + ctx->state[1] += B; + ctx->state[2] += C; + ctx->state[3] += D; +} + +/* + * MD4 process buffer + */ +void md4_update( md4_context *ctx, const unsigned char *input, int ilen ) +{ + int fill; + unsigned long left; + + if( ilen <= 0 ) + return; + + left = ctx->total[0] & 0x3F; + fill = 64 - left; + + ctx->total[0] += ilen; + ctx->total[0] &= 0xFFFFFFFF; + + if( ctx->total[0] < (unsigned long) ilen ) + ctx->total[1]++; + + if( left && ilen >= fill ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, fill ); + md4_process( ctx, ctx->buffer ); + input += fill; + ilen -= fill; + left = 0; + } + + while( ilen >= 64 ) + { + md4_process( ctx, input ); + input += 64; + ilen -= 64; + } + + if( ilen > 0 ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, ilen ); + } +} + +static const unsigned char md4_padding[64] = +{ + 0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 +}; + +/* + * MD4 final digest + */ +void md4_finish( md4_context *ctx, unsigned char output[16] ) +{ + unsigned long last, padn; + unsigned long high, low; + unsigned char msglen[8]; + + high = ( ctx->total[0] >> 29 ) + | ( ctx->total[1] << 3 ); + low = ( ctx->total[0] << 3 ); + + PUT_ULONG_LE( low, msglen, 0 ); + PUT_ULONG_LE( high, msglen, 4 ); + + last = ctx->total[0] & 0x3F; + padn = ( last < 56 ) ? ( 56 - last ) : ( 120 - last ); + + md4_update( ctx, md4_padding, padn ); + md4_update( ctx, msglen, 8 ); + + PUT_ULONG_LE( ctx->state[0], output, 0 ); + PUT_ULONG_LE( ctx->state[1], output, 4 ); + PUT_ULONG_LE( ctx->state[2], output, 8 ); + PUT_ULONG_LE( ctx->state[3], output, 12 ); +} + +/* + * output = MD4( input buffer ) + */ +void md4( unsigned char *input, int ilen, unsigned char output[16] ) +{ + md4_context ctx; + + md4_starts( &ctx ); + md4_update( &ctx, input, ilen ); + md4_finish( &ctx, output ); +} + +#endif /* PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_MD4 */ diff --git a/components/lwip/netif/ppp/polarssl/md5.c b/components/lwip/netif/ppp/polarssl/md5.c new file mode 100755 index 000000000..ba103c4c2 --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/md5.c @@ -0,0 +1,300 @@ +/* + * RFC 1321 compliant MD5 implementation + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +/* + * The MD5 algorithm was designed by Ron Rivest in 1991. + * + * http://www.ietf.org/rfc/rfc1321.txt + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_MD5 + +#include "netif/ppp/polarssl/md5.h" + +#include + +/* + * 32-bit integer manipulation macros (little endian) + */ +#ifndef GET_ULONG_LE +#define GET_ULONG_LE(n,b,i) \ +{ \ + (n) = ( (unsigned long) (b)[(i) ] ) \ + | ( (unsigned long) (b)[(i) + 1] << 8 ) \ + | ( (unsigned long) (b)[(i) + 2] << 16 ) \ + | ( (unsigned long) (b)[(i) + 3] << 24 ); \ +} +#endif + +#ifndef PUT_ULONG_LE +#define PUT_ULONG_LE(n,b,i) \ +{ \ + (b)[(i) ] = (unsigned char) ( (n) ); \ + (b)[(i) + 1] = (unsigned char) ( (n) >> 8 ); \ + (b)[(i) + 2] = (unsigned char) ( (n) >> 16 ); \ + (b)[(i) + 3] = (unsigned char) ( (n) >> 24 ); \ +} +#endif + +/* + * MD5 context setup + */ +void md5_starts( md5_context *ctx ) +{ + ctx->total[0] = 0; + ctx->total[1] = 0; + + ctx->state[0] = 0x67452301; + ctx->state[1] = 0xEFCDAB89; + ctx->state[2] = 0x98BADCFE; + ctx->state[3] = 0x10325476; +} + +static void md5_process( md5_context *ctx, const unsigned char data[64] ) +{ + unsigned long X[16], A, B, C, D; + + GET_ULONG_LE( X[ 0], data, 0 ); + GET_ULONG_LE( X[ 1], data, 4 ); + GET_ULONG_LE( X[ 2], data, 8 ); + GET_ULONG_LE( X[ 3], data, 12 ); + GET_ULONG_LE( X[ 4], data, 16 ); + GET_ULONG_LE( X[ 5], data, 20 ); + GET_ULONG_LE( X[ 6], data, 24 ); + GET_ULONG_LE( X[ 7], data, 28 ); + GET_ULONG_LE( X[ 8], data, 32 ); + GET_ULONG_LE( X[ 9], data, 36 ); + GET_ULONG_LE( X[10], data, 40 ); + GET_ULONG_LE( X[11], data, 44 ); + GET_ULONG_LE( X[12], data, 48 ); + GET_ULONG_LE( X[13], data, 52 ); + GET_ULONG_LE( X[14], data, 56 ); + GET_ULONG_LE( X[15], data, 60 ); + +#define S(x,n) ((x << n) | ((x & 0xFFFFFFFF) >> (32 - n))) + +#define P(a,b,c,d,k,s,t) \ +{ \ + a += F(b,c,d) + X[k] + t; a = S(a,s) + b; \ +} + + A = ctx->state[0]; + B = ctx->state[1]; + C = ctx->state[2]; + D = ctx->state[3]; + +#define F(x,y,z) (z ^ (x & (y ^ z))) + + P( A, B, C, D, 0, 7, 0xD76AA478 ); + P( D, A, B, C, 1, 12, 0xE8C7B756 ); + P( C, D, A, B, 2, 17, 0x242070DB ); + P( B, C, D, A, 3, 22, 0xC1BDCEEE ); + P( A, B, C, D, 4, 7, 0xF57C0FAF ); + P( D, A, B, C, 5, 12, 0x4787C62A ); + P( C, D, A, B, 6, 17, 0xA8304613 ); + P( B, C, D, A, 7, 22, 0xFD469501 ); + P( A, B, C, D, 8, 7, 0x698098D8 ); + P( D, A, B, C, 9, 12, 0x8B44F7AF ); + P( C, D, A, B, 10, 17, 0xFFFF5BB1 ); + P( B, C, D, A, 11, 22, 0x895CD7BE ); + P( A, B, C, D, 12, 7, 0x6B901122 ); + P( D, A, B, C, 13, 12, 0xFD987193 ); + P( C, D, A, B, 14, 17, 0xA679438E ); + P( B, C, D, A, 15, 22, 0x49B40821 ); + +#undef F + +#define F(x,y,z) (y ^ (z & (x ^ y))) + + P( A, B, C, D, 1, 5, 0xF61E2562 ); + P( D, A, B, C, 6, 9, 0xC040B340 ); + P( C, D, A, B, 11, 14, 0x265E5A51 ); + P( B, C, D, A, 0, 20, 0xE9B6C7AA ); + P( A, B, C, D, 5, 5, 0xD62F105D ); + P( D, A, B, C, 10, 9, 0x02441453 ); + P( C, D, A, B, 15, 14, 0xD8A1E681 ); + P( B, C, D, A, 4, 20, 0xE7D3FBC8 ); + P( A, B, C, D, 9, 5, 0x21E1CDE6 ); + P( D, A, B, C, 14, 9, 0xC33707D6 ); + P( C, D, A, B, 3, 14, 0xF4D50D87 ); + P( B, C, D, A, 8, 20, 0x455A14ED ); + P( A, B, C, D, 13, 5, 0xA9E3E905 ); + P( D, A, B, C, 2, 9, 0xFCEFA3F8 ); + P( C, D, A, B, 7, 14, 0x676F02D9 ); + P( B, C, D, A, 12, 20, 0x8D2A4C8A ); + +#undef F + +#define F(x,y,z) (x ^ y ^ z) + + P( A, B, C, D, 5, 4, 0xFFFA3942 ); + P( D, A, B, C, 8, 11, 0x8771F681 ); + P( C, D, A, B, 11, 16, 0x6D9D6122 ); + P( B, C, D, A, 14, 23, 0xFDE5380C ); + P( A, B, C, D, 1, 4, 0xA4BEEA44 ); + P( D, A, B, C, 4, 11, 0x4BDECFA9 ); + P( C, D, A, B, 7, 16, 0xF6BB4B60 ); + P( B, C, D, A, 10, 23, 0xBEBFBC70 ); + P( A, B, C, D, 13, 4, 0x289B7EC6 ); + P( D, A, B, C, 0, 11, 0xEAA127FA ); + P( C, D, A, B, 3, 16, 0xD4EF3085 ); + P( B, C, D, A, 6, 23, 0x04881D05 ); + P( A, B, C, D, 9, 4, 0xD9D4D039 ); + P( D, A, B, C, 12, 11, 0xE6DB99E5 ); + P( C, D, A, B, 15, 16, 0x1FA27CF8 ); + P( B, C, D, A, 2, 23, 0xC4AC5665 ); + +#undef F + +#define F(x,y,z) (y ^ (x | ~z)) + + P( A, B, C, D, 0, 6, 0xF4292244 ); + P( D, A, B, C, 7, 10, 0x432AFF97 ); + P( C, D, A, B, 14, 15, 0xAB9423A7 ); + P( B, C, D, A, 5, 21, 0xFC93A039 ); + P( A, B, C, D, 12, 6, 0x655B59C3 ); + P( D, A, B, C, 3, 10, 0x8F0CCC92 ); + P( C, D, A, B, 10, 15, 0xFFEFF47D ); + P( B, C, D, A, 1, 21, 0x85845DD1 ); + P( A, B, C, D, 8, 6, 0x6FA87E4F ); + P( D, A, B, C, 15, 10, 0xFE2CE6E0 ); + P( C, D, A, B, 6, 15, 0xA3014314 ); + P( B, C, D, A, 13, 21, 0x4E0811A1 ); + P( A, B, C, D, 4, 6, 0xF7537E82 ); + P( D, A, B, C, 11, 10, 0xBD3AF235 ); + P( C, D, A, B, 2, 15, 0x2AD7D2BB ); + P( B, C, D, A, 9, 21, 0xEB86D391 ); + +#undef F + + ctx->state[0] += A; + ctx->state[1] += B; + ctx->state[2] += C; + ctx->state[3] += D; +} + +/* + * MD5 process buffer + */ +void md5_update( md5_context *ctx, const unsigned char *input, int ilen ) +{ + int fill; + unsigned long left; + + if( ilen <= 0 ) + return; + + left = ctx->total[0] & 0x3F; + fill = 64 - left; + + ctx->total[0] += ilen; + ctx->total[0] &= 0xFFFFFFFF; + + if( ctx->total[0] < (unsigned long) ilen ) + ctx->total[1]++; + + if( left && ilen >= fill ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, fill ); + md5_process( ctx, ctx->buffer ); + input += fill; + ilen -= fill; + left = 0; + } + + while( ilen >= 64 ) + { + md5_process( ctx, input ); + input += 64; + ilen -= 64; + } + + if( ilen > 0 ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, ilen ); + } +} + +static const unsigned char md5_padding[64] = +{ + 0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 +}; + +/* + * MD5 final digest + */ +void md5_finish( md5_context *ctx, unsigned char output[16] ) +{ + unsigned long last, padn; + unsigned long high, low; + unsigned char msglen[8]; + + high = ( ctx->total[0] >> 29 ) + | ( ctx->total[1] << 3 ); + low = ( ctx->total[0] << 3 ); + + PUT_ULONG_LE( low, msglen, 0 ); + PUT_ULONG_LE( high, msglen, 4 ); + + last = ctx->total[0] & 0x3F; + padn = ( last < 56 ) ? ( 56 - last ) : ( 120 - last ); + + md5_update( ctx, md5_padding, padn ); + md5_update( ctx, msglen, 8 ); + + PUT_ULONG_LE( ctx->state[0], output, 0 ); + PUT_ULONG_LE( ctx->state[1], output, 4 ); + PUT_ULONG_LE( ctx->state[2], output, 8 ); + PUT_ULONG_LE( ctx->state[3], output, 12 ); +} + +/* + * output = MD5( input buffer ) + */ +void md5( unsigned char *input, int ilen, unsigned char output[16] ) +{ + md5_context ctx; + + md5_starts( &ctx ); + md5_update( &ctx, input, ilen ); + md5_finish( &ctx, output ); +} + +#endif /* PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_MD5 */ diff --git a/components/lwip/netif/ppp/polarssl/sha1.c b/components/lwip/netif/ppp/polarssl/sha1.c new file mode 100755 index 000000000..313b75647 --- /dev/null +++ b/components/lwip/netif/ppp/polarssl/sha1.c @@ -0,0 +1,335 @@ +/* + * FIPS-180-1 compliant SHA-1 implementation + * + * Based on XySSL: Copyright (C) 2006-2008 Christophe Devine + * + * Copyright (C) 2009 Paul Bakker + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the names of PolarSSL or XySSL nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ +/* + * The SHA-1 standard was published by NIST in 1993. + * + * http://www.itl.nist.gov/fipspubs/fip180-1.htm + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_SHA1 + +#include "netif/ppp/polarssl/sha1.h" + +#include + +/* + * 32-bit integer manipulation macros (big endian) + */ +#ifndef GET_ULONG_BE +#define GET_ULONG_BE(n,b,i) \ +{ \ + (n) = ( (unsigned long) (b)[(i) ] << 24 ) \ + | ( (unsigned long) (b)[(i) + 1] << 16 ) \ + | ( (unsigned long) (b)[(i) + 2] << 8 ) \ + | ( (unsigned long) (b)[(i) + 3] ); \ +} +#endif + +#ifndef PUT_ULONG_BE +#define PUT_ULONG_BE(n,b,i) \ +{ \ + (b)[(i) ] = (unsigned char) ( (n) >> 24 ); \ + (b)[(i) + 1] = (unsigned char) ( (n) >> 16 ); \ + (b)[(i) + 2] = (unsigned char) ( (n) >> 8 ); \ + (b)[(i) + 3] = (unsigned char) ( (n) ); \ +} +#endif + +/* + * SHA-1 context setup + */ +void sha1_starts( sha1_context *ctx ) +{ + ctx->total[0] = 0; + ctx->total[1] = 0; + + ctx->state[0] = 0x67452301; + ctx->state[1] = 0xEFCDAB89; + ctx->state[2] = 0x98BADCFE; + ctx->state[3] = 0x10325476; + ctx->state[4] = 0xC3D2E1F0; +} + +static void sha1_process( sha1_context *ctx, const unsigned char data[64] ) +{ + unsigned long temp, W[16], A, B, C, D, E; + + GET_ULONG_BE( W[ 0], data, 0 ); + GET_ULONG_BE( W[ 1], data, 4 ); + GET_ULONG_BE( W[ 2], data, 8 ); + GET_ULONG_BE( W[ 3], data, 12 ); + GET_ULONG_BE( W[ 4], data, 16 ); + GET_ULONG_BE( W[ 5], data, 20 ); + GET_ULONG_BE( W[ 6], data, 24 ); + GET_ULONG_BE( W[ 7], data, 28 ); + GET_ULONG_BE( W[ 8], data, 32 ); + GET_ULONG_BE( W[ 9], data, 36 ); + GET_ULONG_BE( W[10], data, 40 ); + GET_ULONG_BE( W[11], data, 44 ); + GET_ULONG_BE( W[12], data, 48 ); + GET_ULONG_BE( W[13], data, 52 ); + GET_ULONG_BE( W[14], data, 56 ); + GET_ULONG_BE( W[15], data, 60 ); + +#define S(x,n) ((x << n) | ((x & 0xFFFFFFFF) >> (32 - n))) + +#define R(t) \ +( \ + temp = W[(t - 3) & 0x0F] ^ W[(t - 8) & 0x0F] ^ \ + W[(t - 14) & 0x0F] ^ W[ t & 0x0F], \ + ( W[t & 0x0F] = S(temp,1) ) \ +) + +#define P(a,b,c,d,e,x) \ +{ \ + e += S(a,5) + F(b,c,d) + K + x; b = S(b,30); \ +} + + A = ctx->state[0]; + B = ctx->state[1]; + C = ctx->state[2]; + D = ctx->state[3]; + E = ctx->state[4]; + +#define F(x,y,z) (z ^ (x & (y ^ z))) +#define K 0x5A827999 + + P( A, B, C, D, E, W[0] ); + P( E, A, B, C, D, W[1] ); + P( D, E, A, B, C, W[2] ); + P( C, D, E, A, B, W[3] ); + P( B, C, D, E, A, W[4] ); + P( A, B, C, D, E, W[5] ); + P( E, A, B, C, D, W[6] ); + P( D, E, A, B, C, W[7] ); + P( C, D, E, A, B, W[8] ); + P( B, C, D, E, A, W[9] ); + P( A, B, C, D, E, W[10] ); + P( E, A, B, C, D, W[11] ); + P( D, E, A, B, C, W[12] ); + P( C, D, E, A, B, W[13] ); + P( B, C, D, E, A, W[14] ); + P( A, B, C, D, E, W[15] ); + P( E, A, B, C, D, R(16) ); + P( D, E, A, B, C, R(17) ); + P( C, D, E, A, B, R(18) ); + P( B, C, D, E, A, R(19) ); + +#undef K +#undef F + +#define F(x,y,z) (x ^ y ^ z) +#define K 0x6ED9EBA1 + + P( A, B, C, D, E, R(20) ); + P( E, A, B, C, D, R(21) ); + P( D, E, A, B, C, R(22) ); + P( C, D, E, A, B, R(23) ); + P( B, C, D, E, A, R(24) ); + P( A, B, C, D, E, R(25) ); + P( E, A, B, C, D, R(26) ); + P( D, E, A, B, C, R(27) ); + P( C, D, E, A, B, R(28) ); + P( B, C, D, E, A, R(29) ); + P( A, B, C, D, E, R(30) ); + P( E, A, B, C, D, R(31) ); + P( D, E, A, B, C, R(32) ); + P( C, D, E, A, B, R(33) ); + P( B, C, D, E, A, R(34) ); + P( A, B, C, D, E, R(35) ); + P( E, A, B, C, D, R(36) ); + P( D, E, A, B, C, R(37) ); + P( C, D, E, A, B, R(38) ); + P( B, C, D, E, A, R(39) ); + +#undef K +#undef F + +#define F(x,y,z) ((x & y) | (z & (x | y))) +#define K 0x8F1BBCDC + + P( A, B, C, D, E, R(40) ); + P( E, A, B, C, D, R(41) ); + P( D, E, A, B, C, R(42) ); + P( C, D, E, A, B, R(43) ); + P( B, C, D, E, A, R(44) ); + P( A, B, C, D, E, R(45) ); + P( E, A, B, C, D, R(46) ); + P( D, E, A, B, C, R(47) ); + P( C, D, E, A, B, R(48) ); + P( B, C, D, E, A, R(49) ); + P( A, B, C, D, E, R(50) ); + P( E, A, B, C, D, R(51) ); + P( D, E, A, B, C, R(52) ); + P( C, D, E, A, B, R(53) ); + P( B, C, D, E, A, R(54) ); + P( A, B, C, D, E, R(55) ); + P( E, A, B, C, D, R(56) ); + P( D, E, A, B, C, R(57) ); + P( C, D, E, A, B, R(58) ); + P( B, C, D, E, A, R(59) ); + +#undef K +#undef F + +#define F(x,y,z) (x ^ y ^ z) +#define K 0xCA62C1D6 + + P( A, B, C, D, E, R(60) ); + P( E, A, B, C, D, R(61) ); + P( D, E, A, B, C, R(62) ); + P( C, D, E, A, B, R(63) ); + P( B, C, D, E, A, R(64) ); + P( A, B, C, D, E, R(65) ); + P( E, A, B, C, D, R(66) ); + P( D, E, A, B, C, R(67) ); + P( C, D, E, A, B, R(68) ); + P( B, C, D, E, A, R(69) ); + P( A, B, C, D, E, R(70) ); + P( E, A, B, C, D, R(71) ); + P( D, E, A, B, C, R(72) ); + P( C, D, E, A, B, R(73) ); + P( B, C, D, E, A, R(74) ); + P( A, B, C, D, E, R(75) ); + P( E, A, B, C, D, R(76) ); + P( D, E, A, B, C, R(77) ); + P( C, D, E, A, B, R(78) ); + P( B, C, D, E, A, R(79) ); + +#undef K +#undef F + + ctx->state[0] += A; + ctx->state[1] += B; + ctx->state[2] += C; + ctx->state[3] += D; + ctx->state[4] += E; +} + +/* + * SHA-1 process buffer + */ +void sha1_update( sha1_context *ctx, const unsigned char *input, int ilen ) +{ + int fill; + unsigned long left; + + if( ilen <= 0 ) + return; + + left = ctx->total[0] & 0x3F; + fill = 64 - left; + + ctx->total[0] += ilen; + ctx->total[0] &= 0xFFFFFFFF; + + if( ctx->total[0] < (unsigned long) ilen ) + ctx->total[1]++; + + if( left && ilen >= fill ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, fill ); + sha1_process( ctx, ctx->buffer ); + input += fill; + ilen -= fill; + left = 0; + } + + while( ilen >= 64 ) + { + sha1_process( ctx, input ); + input += 64; + ilen -= 64; + } + + if( ilen > 0 ) + { + MEMCPY( (void *) (ctx->buffer + left), + input, ilen ); + } +} + +static const unsigned char sha1_padding[64] = +{ + 0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 +}; + +/* + * SHA-1 final digest + */ +void sha1_finish( sha1_context *ctx, unsigned char output[20] ) +{ + unsigned long last, padn; + unsigned long high, low; + unsigned char msglen[8]; + + high = ( ctx->total[0] >> 29 ) + | ( ctx->total[1] << 3 ); + low = ( ctx->total[0] << 3 ); + + PUT_ULONG_BE( high, msglen, 0 ); + PUT_ULONG_BE( low, msglen, 4 ); + + last = ctx->total[0] & 0x3F; + padn = ( last < 56 ) ? ( 56 - last ) : ( 120 - last ); + + sha1_update( ctx, sha1_padding, padn ); + sha1_update( ctx, msglen, 8 ); + + PUT_ULONG_BE( ctx->state[0], output, 0 ); + PUT_ULONG_BE( ctx->state[1], output, 4 ); + PUT_ULONG_BE( ctx->state[2], output, 8 ); + PUT_ULONG_BE( ctx->state[3], output, 12 ); + PUT_ULONG_BE( ctx->state[4], output, 16 ); +} + +/* + * output = SHA-1( input buffer ) + */ +void sha1( unsigned char *input, int ilen, unsigned char output[20] ) +{ + sha1_context ctx; + + sha1_starts( &ctx ); + sha1_update( &ctx, input, ilen ); + sha1_finish( &ctx, output ); +} + +#endif /* PPP_SUPPORT && LWIP_INCLUDED_POLARSSL_SHA1 */ diff --git a/components/lwip/netif/ppp/ppp.c b/components/lwip/netif/ppp/ppp.c new file mode 100755 index 000000000..031556ad0 --- /dev/null +++ b/components/lwip/netif/ppp/ppp.c @@ -0,0 +1,1600 @@ +/***************************************************************************** +* ppp.c - Network Point to Point Protocol program file. +* +* Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. +* portions Copyright (c) 1997 by Global Election Systems Inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 03-01-01 Marc Boucher +* Ported to lwIP. +* 97-11-05 Guy Lancaster , Global Election Systems Inc. +* Original. +*****************************************************************************/ + +/* + * ppp_defs.h - PPP definitions. + * + * if_pppvar.h - private structures and declarations for PPP. + * + * Copyright (c) 1994 The Australian National University. + * All rights reserved. + * + * Permission to use, copy, modify, and distribute this software and its + * documentation is hereby granted, provided that the above copyright + * notice appears in all copies. This software is provided without any + * warranty, express or implied. The Australian National University + * makes no representations about the suitability of this software for + * any purpose. + * + * IN NO EVENT SHALL THE AUSTRALIAN NATIONAL UNIVERSITY BE LIABLE TO ANY + * PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES + * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF + * THE AUSTRALIAN NATIONAL UNIVERSITY HAVE BEEN ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * THE AUSTRALIAN NATIONAL UNIVERSITY SPECIFICALLY DISCLAIMS ANY WARRANTIES, + * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS + * ON AN "AS IS" BASIS, AND THE AUSTRALIAN NATIONAL UNIVERSITY HAS NO + * OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, + * OR MODIFICATIONS. + */ + +/* + * if_ppp.h - Point-to-Point Protocol definitions. + * + * Copyright (c) 1989 Carnegie Mellon University. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by Carnegie Mellon University. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/pbuf.h" +#include "lwip/stats.h" +#include "lwip/sys.h" +#include "lwip/tcpip.h" +#include "lwip/api.h" +#include "lwip/snmp.h" +#include "lwip/sio.h" +#include "lwip/sys.h" +#include "lwip/ip4.h" /* for ip4_input() */ +#if PPP_IPV6_SUPPORT +#include "lwip/ip6.h" /* for ip6_input() */ +#endif /* PPP_IPV6_SUPPORT */ +#include "lwip/dns.h" + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/pppos.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/lcp.h" +#include "netif/ppp/magic.h" + +#if PAP_SUPPORT +#include "netif/ppp/upap.h" +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT +#include "netif/ppp/chap-new.h" +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT +#include "netif/ppp/eap.h" +#endif /* EAP_SUPPORT */ +#if CCP_SUPPORT +#include "netif/ppp/ccp.h" +#endif /* CCP_SUPPORT */ +#if MPPE_SUPPORT +#include "netif/ppp/mppe.h" +#endif /* MPPE_SUPPORT */ +#if ECP_SUPPORT +#include "netif/ppp/ecp.h" +#endif /* EAP_SUPPORT */ +#if VJ_SUPPORT +#include "netif/ppp/vj.h" +#endif /* VJ_SUPPORT */ +#if PPP_IPV4_SUPPORT +#include "netif/ppp/ipcp.h" +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT +#include "netif/ppp/ipv6cp.h" +#endif /* PPP_IPV6_SUPPORT */ + +/*************************/ +/*** LOCAL DEFINITIONS ***/ +/*************************/ + +/* FIXME: add stats per PPP session */ +#if PPP_STATS_SUPPORT +static struct timeval start_time; /* Time when link was started. */ +static struct pppd_stats old_link_stats; +struct pppd_stats link_stats; +unsigned link_connect_time; +int link_stats_valid; +#endif /* PPP_STATS_SUPPORT */ + +/* + * PPP Data Link Layer "protocol" table. + * One entry per supported protocol. + * The last entry must be NULL. + */ +const struct protent* const protocols[] = { + &lcp_protent, +#if PAP_SUPPORT + &pap_protent, +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + &chap_protent, +#endif /* CHAP_SUPPORT */ +#if CBCP_SUPPORT + &cbcp_protent, +#endif /* CBCP_SUPPORT */ +#if PPP_IPV4_SUPPORT + &ipcp_protent, +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT + &ipv6cp_protent, +#endif /* PPP_IPV6_SUPPORT */ +#if CCP_SUPPORT + &ccp_protent, +#endif /* CCP_SUPPORT */ +#if ECP_SUPPORT + &ecp_protent, +#endif /* ECP_SUPPORT */ +#ifdef AT_CHANGE + &atcp_protent, +#endif /* AT_CHANGE */ +#if EAP_SUPPORT + &eap_protent, +#endif /* EAP_SUPPORT */ + NULL +}; + +/* Prototypes for procedures local to this file. */ +static void ppp_do_connect(void *arg); +static err_t ppp_netif_init_cb(struct netif *netif); +#if LWIP_IPV4 +static err_t ppp_netif_output_ip4(struct netif *netif, struct pbuf *pb, const ip4_addr_t *ipaddr); +#endif /* LWIP_IPV4 */ +#if PPP_IPV6_SUPPORT +static err_t ppp_netif_output_ip6(struct netif *netif, struct pbuf *pb, const ip6_addr_t *ipaddr); +#endif /* PPP_IPV6_SUPPORT */ +static err_t ppp_netif_output(struct netif *netif, struct pbuf *pb, u16_t protocol); + +/***********************************/ +/*** PUBLIC FUNCTION DEFINITIONS ***/ +/***********************************/ +void ppp_set_auth(ppp_pcb *pcb, u8_t authtype, const char *user, const char *passwd) { +#if PPP_AUTH_SUPPORT +#if PAP_SUPPORT + pcb->settings.refuse_pap = !(authtype & PPPAUTHTYPE_PAP); +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + pcb->settings.refuse_chap = !(authtype & PPPAUTHTYPE_CHAP); +#if MSCHAP_SUPPORT + pcb->settings.refuse_mschap = !(authtype & PPPAUTHTYPE_MSCHAP); + pcb->settings.refuse_mschap_v2 = !(authtype & PPPAUTHTYPE_MSCHAP_V2); +#endif /* MSCHAP_SUPPORT */ +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + pcb->settings.refuse_eap = !(authtype & PPPAUTHTYPE_EAP); +#endif /* EAP_SUPPORT */ + pcb->settings.user = user; + pcb->settings.passwd = passwd; +#else /* PPP_AUTH_SUPPORT */ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(authtype); + LWIP_UNUSED_ARG(user); + LWIP_UNUSED_ARG(passwd); +#endif /* PPP_AUTH_SUPPORT */ +} + +#if PPP_NOTIFY_PHASE +void ppp_set_notify_phase_callback(ppp_pcb *pcb, ppp_notify_phase_cb_fn notify_phase_cb) { + pcb->notify_phase_cb = notify_phase_cb; + notify_phase_cb(pcb, pcb->phase, pcb->ctx_cb); +} +#endif /* PPP_NOTIFY_PHASE */ + +/* + * Initiate a PPP connection. + * + * This can only be called if PPP is in the dead phase. + * + * Holdoff is the time to wait (in seconds) before initiating + * the connection. + * + * If this port connects to a modem, the modem connection must be + * established before calling this. + */ +err_t ppp_connect(ppp_pcb *pcb, u16_t holdoff) { + if (pcb->phase != PPP_PHASE_DEAD) { + return ERR_ALREADY; + } + + PPPDEBUG(LOG_DEBUG, ("ppp_connect[%d]: holdoff=%d\n", pcb->netif->num, holdoff)); + + if (holdoff == 0) { + return pcb->link_cb->connect(pcb, pcb->link_ctx_cb); + } + + new_phase(pcb, PPP_PHASE_HOLDOFF); + sys_timeout((u32_t)(holdoff*1000), ppp_do_connect, pcb); + return ERR_OK; +} + +#if PPP_SERVER +/* + * Listen for an incoming PPP connection. + * + * This can only be called if PPP is in the dead phase. + * + * Local and remote interface IP addresses, as well as DNS are + * provided through a previously filled struct ppp_addrs. + * + * If this port connects to a modem, the modem connection must be + * established before calling this. + */ +err_t ppp_listen(ppp_pcb *pcb, struct ppp_addrs *addrs) { + if (pcb->phase != PPP_PHASE_DEAD) { + return ERR_ALREADY; + } + + PPPDEBUG(LOG_DEBUG, ("ppp_listen[%d]\n", pcb->netif->num)); + + if (pcb->link_cb->listen) { + return pcb->link_cb->listen(pcb, pcb->link_ctx_cb, addrs); + } + return ERR_IF; +} +#endif /* PPP_SERVER */ + +/* + * Initiate the end of a PPP connection. + * Any outstanding packets in the queues are dropped. + * + * Setting nocarrier to 1 close the PPP connection without initiating the + * shutdown procedure. Always using nocarrier = 0 is still recommended, + * this is going to take a little longer time if your link is down, but + * is a safer choice for the PPP state machine. + * + * Return 0 on success, an error code on failure. + */ +err_t +ppp_close(ppp_pcb *pcb, u8_t nocarrier) +{ + pcb->err_code = PPPERR_USER; + + /* holdoff phase, cancel the reconnection */ + if (pcb->phase == PPP_PHASE_HOLDOFF) { + sys_untimeout(ppp_do_connect, pcb); + new_phase(pcb, PPP_PHASE_DEAD); + } + + /* dead phase, nothing to do, call the status callback to be consistent */ + if (pcb->phase == PPP_PHASE_DEAD) { + pcb->link_status_cb(pcb, pcb->err_code, pcb->ctx_cb); + return ERR_OK; + } + + /* + * Only accept carrier lost signal on the stable running phase in order + * to prevent changing the PPP phase FSM in transition phases. + * + * Always using nocarrier = 0 is still recommended, this is going to + * take a little longer time, but is a safer choice from FSM point of view. + */ + if (nocarrier && pcb->phase == PPP_PHASE_RUNNING) { + PPPDEBUG(LOG_DEBUG, ("ppp_close[%d]: carrier lost -> lcp_lowerdown\n", pcb->netif->num)); + lcp_lowerdown(pcb); + /* forced link termination, this will leave us at PPP_PHASE_DEAD. */ + link_terminated(pcb); + return ERR_OK; + } + + /* Disconnect */ + PPPDEBUG(LOG_DEBUG, ("ppp_close[%d]: kill_link -> lcp_close\n", pcb->netif->num)); + /* LCP close request, this will leave us at PPP_PHASE_DEAD. */ + lcp_close(pcb, "User request"); + return ERR_OK; +} + +/* + * Release the control block. + * + * This can only be called if PPP is in the dead phase. + * + * You must use ppp_close() before if you wish to terminate + * an established PPP session. + * + * Return 0 on success, an error code on failure. + */ +err_t ppp_free(ppp_pcb *pcb) { + err_t err; + if (pcb->phase != PPP_PHASE_DEAD) { + return ERR_CONN; + } + + PPPDEBUG(LOG_DEBUG, ("ppp_free[%d]\n", pcb->netif->num)); + + netif_remove(pcb->netif); + + err = pcb->link_cb->free(pcb, pcb->link_ctx_cb); + + memp_free(MEMP_PPP_PCB, pcb); + return err; +} + +/* Get and set parameters for the given connection. + * Return 0 on success, an error code on failure. */ +err_t +ppp_ioctl(ppp_pcb *pcb, u8_t cmd, void *arg) +{ + if (pcb == NULL) { + return ERR_VAL; + } + + switch(cmd) { + case PPPCTLG_UPSTATUS: /* Get the PPP up status. */ + if (!arg) { + goto fail; + } + *(int *)arg = (int)(0 +#if PPP_IPV4_SUPPORT + || pcb->if4_up +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT + || pcb->if6_up +#endif /* PPP_IPV6_SUPPORT */ + ); + return ERR_OK; + + case PPPCTLG_ERRCODE: /* Get the PPP error code. */ + if (!arg) { + goto fail; + } + *(int *)arg = (int)(pcb->err_code); + return ERR_OK; + + default: + goto fail; + } + +fail: + return ERR_VAL; +} + + +/**********************************/ +/*** LOCAL FUNCTION DEFINITIONS ***/ +/**********************************/ + +static void ppp_do_connect(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + LWIP_ASSERT("pcb->phase == PPP_PHASE_DEAD || pcb->phase == PPP_PHASE_HOLDOFF", pcb->phase == PPP_PHASE_DEAD || pcb->phase == PPP_PHASE_HOLDOFF); + + pcb->link_cb->connect(pcb, pcb->link_ctx_cb); +} + +/* + * ppp_netif_init_cb - netif init callback + */ +static err_t ppp_netif_init_cb(struct netif *netif) { + netif->name[0] = 'p'; + netif->name[1] = 'p'; +#if LWIP_IPV4 + /* FIXME: change that when netif_null_output_ip4() will materialize */ + netif->output = ppp_netif_output_ip4; +#endif /* LWIP_IPV4 */ +#if PPP_IPV6_SUPPORT + netif->output_ip6 = ppp_netif_output_ip6; +#endif /* PPP_IPV6_SUPPORT */ + netif->flags = NETIF_FLAG_UP; +#if LWIP_NETIF_HOSTNAME + /* @todo: Initialize interface hostname */ + /* netif_set_hostname(netif, "lwip"); */ +#endif /* LWIP_NETIF_HOSTNAME */ + return ERR_OK; +} + +#if LWIP_IPV4 +/* + * Send an IPv4 packet on the given connection. + */ +static err_t ppp_netif_output_ip4(struct netif *netif, struct pbuf *pb, const ip4_addr_t *ipaddr) { + LWIP_UNUSED_ARG(ipaddr); +#if PPP_IPV4_SUPPORT + return ppp_netif_output(netif, pb, PPP_IP); +#else /* PPP_IPV4_SUPPORT */ + LWIP_UNUSED_ARG(netif); + LWIP_UNUSED_ARG(pb); + return ERR_IF; +#endif /* PPP_IPV4_SUPPORT */ +} +#endif /* LWIP_IPV4 */ + +#if PPP_IPV6_SUPPORT +/* + * Send an IPv6 packet on the given connection. + */ +static err_t ppp_netif_output_ip6(struct netif *netif, struct pbuf *pb, const ip6_addr_t *ipaddr) { + LWIP_UNUSED_ARG(ipaddr); + return ppp_netif_output(netif, pb, PPP_IPV6); +} +#endif /* PPP_IPV6_SUPPORT */ + +static err_t ppp_netif_output(struct netif *netif, struct pbuf *pb, u16_t protocol) { + ppp_pcb *pcb = (ppp_pcb*)netif->state; + err_t err; + struct pbuf *fpb = NULL; + + /* Check that the link is up. */ + if (0 +#if PPP_IPV4_SUPPORT + || (protocol == PPP_IP && !pcb->if4_up) +#endif /* PPP_IPV4_SUPPORT */ +#if PPP_IPV6_SUPPORT + || (protocol == PPP_IPV6 && !pcb->if6_up) +#endif /* PPP_IPV6_SUPPORT */ + ) { + PPPDEBUG(LOG_ERR, ("ppp_netif_output[%d]: link not up\n", pcb->netif->num)); + goto err_rte_drop; + } + +#if MPPE_SUPPORT + /* If MPPE is required, refuse any IP packet until we are able to crypt them. */ + if (pcb->settings.require_mppe && pcb->ccp_transmit_method != CI_MPPE) { + PPPDEBUG(LOG_ERR, ("ppp_netif_output[%d]: MPPE required, not up\n", pcb->netif->num)); + goto err_rte_drop; + } +#endif /* MPPE_SUPPORT */ + +#if VJ_SUPPORT && LWIP_TCP + /* + * Attempt Van Jacobson header compression if VJ is configured and + * this is an IP packet. + */ + if (protocol == PPP_IP && pcb->vj_enabled) { + switch (vj_compress_tcp(&pcb->vj_comp, &pb)) { + case TYPE_IP: + /* No change... + protocol = PPP_IP; */ + break; + case TYPE_COMPRESSED_TCP: + /* vj_compress_tcp() returns a new allocated pbuf, indicate we should free + * our duplicated pbuf later */ + fpb = pb; + protocol = PPP_VJC_COMP; + break; + case TYPE_UNCOMPRESSED_TCP: + /* vj_compress_tcp() returns a new allocated pbuf, indicate we should free + * our duplicated pbuf later */ + fpb = pb; + protocol = PPP_VJC_UNCOMP; + break; + default: + PPPDEBUG(LOG_WARNING, ("ppp_netif_output[%d]: bad IP packet\n", pcb->netif->num)); + LINK_STATS_INC(link.proterr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(pcb->netif, ifoutdiscards); + return ERR_VAL; + } + } +#endif /* VJ_SUPPORT && LWIP_TCP */ + +#if CCP_SUPPORT + switch (pcb->ccp_transmit_method) { + case 0: + break; /* Don't compress */ +#if MPPE_SUPPORT + case CI_MPPE: + if ((err = mppe_compress(pcb, &pcb->mppe_comp, &pb, protocol)) != ERR_OK) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(netif, ifoutdiscards); + goto err; + } + /* if VJ compressor returned a new allocated pbuf, free it */ + if (fpb) { + pbuf_free(fpb); + } + /* mppe_compress() returns a new allocated pbuf, indicate we should free + * our duplicated pbuf later */ + fpb = pb; + protocol = PPP_COMP; + break; +#endif /* MPPE_SUPPORT */ + default: + PPPDEBUG(LOG_ERR, ("ppp_netif_output[%d]: bad CCP transmit method\n", pcb->netif->num)); + goto err_rte_drop; /* Cannot really happen, we only negotiate what we are able to do */ + } +#endif /* CCP_SUPPORT */ + + err = pcb->link_cb->netif_output(pcb, pcb->link_ctx_cb, pb, protocol); + goto err; + +err_rte_drop: + err = ERR_RTE; + LINK_STATS_INC(link.rterr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(netif, ifoutdiscards); +err: + if (fpb) { + pbuf_free(fpb); + } + return err; +} + +/************************************/ +/*** PRIVATE FUNCTION DEFINITIONS ***/ +/************************************/ + +/* Initialize the PPP subsystem. */ +int ppp_init(void) { + + /* + * Initialize magic number generator now so that protocols may + * use magic numbers in initialization. + */ + magic_init(); + + return 0; +} + +/* + * Create a new PPP control block. + * + * This initializes the PPP control block but does not + * attempt to negotiate the LCP session. + * + * Return a new PPP connection control block pointer + * on success or a null pointer on failure. + */ +ppp_pcb *ppp_new(struct netif *pppif, const struct link_callbacks *callbacks, void *link_ctx_cb, ppp_link_status_cb_fn link_status_cb, void *ctx_cb) { + ppp_pcb *pcb; + + /* PPP is single-threaded: without a callback, + * there is no way to know when the link is up. */ + if (link_status_cb == NULL) { + return NULL; + } + + pcb = (ppp_pcb*)memp_malloc(MEMP_PPP_PCB); + if (pcb == NULL) { + return NULL; + } + + memset(pcb, 0, sizeof(ppp_pcb)); + + /* default configuration */ +#if LWIP_DNS + pcb->settings.usepeerdns = 1; +#endif /* LWIP_DNS */ + +#if PAP_SUPPORT + pcb->settings.pap_timeout_time = UPAP_DEFTIMEOUT; + pcb->settings.pap_max_transmits = UPAP_DEFTRANSMITS; +#if PPP_SERVER + pcb->settings.pap_req_timeout = UPAP_DEFREQTIME; +#endif /* PPP_SERVER */ +#endif /* PAP_SUPPORT */ + +#if CHAP_SUPPORT + pcb->settings.chap_timeout_time = CHAP_DEFTIMEOUT; + pcb->settings.chap_max_transmits = CHAP_DEFTRANSMITS; +#if PPP_SERVER + pcb->settings.chap_rechallenge_time = CHAP_DEFRECHALLENGETIME; +#endif /* PPP_SERVER */ +#endif /* CHAP_SUPPPORT */ + +#if EAP_SUPPORT + pcb->settings.eap_req_time = EAP_DEFREQTIME; + pcb->settings.eap_allow_req = EAP_DEFALLOWREQ; +#if PPP_SERVER + pcb->settings.eap_timeout_time = EAP_DEFTIMEOUT; + pcb->settings.eap_max_transmits = EAP_DEFTRANSMITS; +#endif /* PPP_SERVER */ +#endif /* EAP_SUPPORT */ + +#if MPPE_SUPPORT + pcb->settings.refuse_mppe_stateful = 1; +#endif /* MPPE_SUPPORT */ + + pcb->settings.lcp_loopbackfail = LCP_DEFLOOPBACKFAIL; + pcb->settings.lcp_echo_interval = LCP_ECHOINTERVAL; + pcb->settings.lcp_echo_fails = LCP_MAXECHOFAILS; + + pcb->settings.fsm_timeout_time = FSM_DEFTIMEOUT; + pcb->settings.fsm_max_conf_req_transmits = FSM_DEFMAXCONFREQS; + pcb->settings.fsm_max_term_transmits = FSM_DEFMAXTERMREQS; + pcb->settings.fsm_max_nak_loops = FSM_DEFMAXNAKLOOPS; + + pcb->netif = pppif; + MIB2_INIT_NETIF(pppif, snmp_ifType_ppp, 0); + if (!netif_add(pcb->netif, +#if LWIP_IPV4 + IP4_ADDR_ANY, IP4_ADDR_BROADCAST, IP4_ADDR_ANY, +#endif /* LWIP_IPV4 */ + (void *)pcb, ppp_netif_init_cb, NULL)) { + memp_free(MEMP_PPP_PCB, pcb); + PPPDEBUG(LOG_ERR, ("ppp_new: netif_add failed\n")); + return NULL; + } + + pcb->link_cb = callbacks; + pcb->link_ctx_cb = link_ctx_cb; + pcb->link_status_cb = link_status_cb; + pcb->ctx_cb = ctx_cb; + new_phase(pcb, PPP_PHASE_DEAD); + return pcb; +} + +/* Set a PPP PCB to its initial state */ +void ppp_clear(ppp_pcb *pcb) { + const struct protent *protp; + int i; + + LWIP_ASSERT("pcb->phase == PPP_PHASE_DEAD || pcb->phase == PPP_PHASE_HOLDOFF", pcb->phase == PPP_PHASE_DEAD || pcb->phase == PPP_PHASE_HOLDOFF); + +#if PPP_STATS_SUPPORT + link_stats_valid = 0; +#endif /* PPP_STATS_SUPPORT */ + + memset(&pcb->phase, 0, sizeof(ppp_pcb) - ( (char*)&((ppp_pcb*)0)->phase - (char*)0 ) ); + + /* + * Initialize each protocol. + */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) { + (*protp->init)(pcb); + } + +#if VJ_SUPPORT && LWIP_TCP + vj_compress_init(&pcb->vj_comp); +#endif /* VJ_SUPPORT && LWIP_TCP */ + + new_phase(pcb, PPP_PHASE_INITIALIZE); +} + +/** Initiate LCP open request */ +void ppp_start(ppp_pcb *pcb) { + PPPDEBUG(LOG_DEBUG, ("ppp_start[%d]\n", pcb->netif->num)); + lcp_open(pcb); /* Start protocol */ + lcp_lowerup(pcb); + PPPDEBUG(LOG_DEBUG, ("ppp_start[%d]: finished\n", pcb->netif->num)); +} + +/** Called when link failed to setup */ +void ppp_link_failed(ppp_pcb *pcb) { + PPPDEBUG(LOG_DEBUG, ("ppp_failed[%d]\n", pcb->netif->num)); + new_phase(pcb, PPP_PHASE_DEAD); + pcb->err_code = PPPERR_OPEN; + pcb->link_status_cb(pcb, pcb->err_code, pcb->ctx_cb); +} + +/** Called when link is normally down (i.e. it was asked to end) */ +void ppp_link_end(ppp_pcb *pcb) { + PPPDEBUG(LOG_DEBUG, ("ppp_end[%d]\n", pcb->netif->num)); + if (pcb->err_code == PPPERR_NONE) { + pcb->err_code = PPPERR_CONNECT; + } + pcb->link_status_cb(pcb, pcb->err_code, pcb->ctx_cb); +} + +/* + * Pass the processed input packet to the appropriate handler. + * This function and all handlers run in the context of the tcpip_thread + */ +void ppp_input(ppp_pcb *pcb, struct pbuf *pb) { + u16_t protocol; +#if PPP_DEBUG && PPP_PROTOCOLNAME + const char *pname; +#endif /* PPP_DEBUG && PPP_PROTOCOLNAME */ + + magic_randomize(); + + if (pb->len < 2) { + PPPDEBUG(LOG_ERR, ("ppp_input[%d]: packet too short\n", pcb->netif->num)); + goto drop; + } + protocol = (((u8_t *)pb->payload)[0] << 8) | ((u8_t*)pb->payload)[1]; + +#if PRINTPKT_SUPPORT + ppp_dump_packet("rcvd", (unsigned char *)pb->payload, pb->len); +#endif /* PRINTPKT_SUPPORT */ + + pbuf_header(pb, -(s16_t)sizeof(protocol)); + + LINK_STATS_INC(link.recv); + MIB2_STATS_NETIF_INC(pcb->netif, ifinucastpkts); + MIB2_STATS_NETIF_ADD(pcb->netif, ifinoctets, pb->tot_len); + + /* + * Toss all non-LCP packets unless LCP is OPEN. + */ + if (protocol != PPP_LCP && pcb->lcp_fsm.state != PPP_FSM_OPENED) { + ppp_dbglog("Discarded non-LCP packet when LCP not open"); + goto drop; + } + + /* + * Until we get past the authentication phase, toss all packets + * except LCP, LQR and authentication packets. + */ + if (pcb->phase <= PPP_PHASE_AUTHENTICATE + && !(protocol == PPP_LCP +#if LQR_SUPPORT + || protocol == PPP_LQR +#endif /* LQR_SUPPORT */ +#if PAP_SUPPORT + || protocol == PPP_PAP +#endif /* PAP_SUPPORT */ +#if CHAP_SUPPORT + || protocol == PPP_CHAP +#endif /* CHAP_SUPPORT */ +#if EAP_SUPPORT + || protocol == PPP_EAP +#endif /* EAP_SUPPORT */ + )) { + ppp_dbglog("discarding proto 0x%x in phase %d", protocol, pcb->phase); + goto drop; + } + +#if CCP_SUPPORT +#if MPPE_SUPPORT + /* + * MPPE is required and unencrypted data has arrived (this + * should never happen!). We should probably drop the link if + * the protocol is in the range of what should be encrypted. + * At the least, we drop this packet. + */ + if (pcb->settings.require_mppe && protocol != PPP_COMP && protocol < 0x8000) { + PPPDEBUG(LOG_ERR, ("ppp_input[%d]: MPPE required, received unencrypted data!\n", pcb->netif->num)); + goto drop; + } +#endif /* MPPE_SUPPORT */ + + if (protocol == PPP_COMP) { + u8_t *pl; + + switch (pcb->ccp_receive_method) { +#if MPPE_SUPPORT + case CI_MPPE: + if (mppe_decompress(pcb, &pcb->mppe_decomp, &pb) != ERR_OK) { + goto drop; + } + break; +#endif /* MPPE_SUPPORT */ + default: + PPPDEBUG(LOG_ERR, ("ppp_input[%d]: bad CCP receive method\n", pcb->netif->num)); + goto drop; /* Cannot really happen, we only negotiate what we are able to do */ + } + + /* Assume no PFC */ + if (pb->len < 2) { + goto drop; + } + + /* Extract and hide protocol (do PFC decompression if necessary) */ + pl = (u8_t*)pb->payload; + if (pl[0] & 0x01) { + protocol = pl[0]; + pbuf_header(pb, -(s16_t)1); + } else { + protocol = (pl[0] << 8) | pl[1]; + pbuf_header(pb, -(s16_t)2); + } + } +#endif /* CCP_SUPPORT */ + + switch(protocol) { + +#if PPP_IPV4_SUPPORT + case PPP_IP: /* Internet Protocol */ + PPPDEBUG(LOG_INFO, ("ppp_input[%d]: ip in pbuf len=%d\n", pcb->netif->num, pb->tot_len)); + ip4_input(pb, pcb->netif); + return; +#endif /* PPP_IPV4_SUPPORT */ + +#if PPP_IPV6_SUPPORT + case PPP_IPV6: /* Internet Protocol Version 6 */ + PPPDEBUG(LOG_INFO, ("ppp_input[%d]: ip6 in pbuf len=%d\n", pcb->netif->num, pb->tot_len)); + ip6_input(pb, pcb->netif); + return; +#endif /* PPP_IPV6_SUPPORT */ + +#if VJ_SUPPORT && LWIP_TCP + case PPP_VJC_COMP: /* VJ compressed TCP */ + /* + * Clip off the VJ header and prepend the rebuilt TCP/IP header and + * pass the result to IP. + */ + PPPDEBUG(LOG_INFO, ("ppp_input[%d]: vj_comp in pbuf len=%d\n", pcb->netif->num, pb->tot_len)); + if (pcb->vj_enabled && vj_uncompress_tcp(&pb, &pcb->vj_comp) >= 0) { + ip4_input(pb, pcb->netif); + return; + } + /* Something's wrong so drop it. */ + PPPDEBUG(LOG_WARNING, ("ppp_input[%d]: Dropping VJ compressed\n", pcb->netif->num)); + break; + + case PPP_VJC_UNCOMP: /* VJ uncompressed TCP */ + /* + * Process the TCP/IP header for VJ header compression and then pass + * the packet to IP. + */ + PPPDEBUG(LOG_INFO, ("ppp_input[%d]: vj_un in pbuf len=%d\n", pcb->netif->num, pb->tot_len)); + if (pcb->vj_enabled && vj_uncompress_uncomp(pb, &pcb->vj_comp) >= 0) { + ip4_input(pb, pcb->netif); + return; + } + /* Something's wrong so drop it. */ + PPPDEBUG(LOG_WARNING, ("ppp_input[%d]: Dropping VJ uncompressed\n", pcb->netif->num)); + break; +#endif /* VJ_SUPPORT && LWIP_TCP */ + + default: { + int i; + const struct protent *protp; + + /* + * Upcall the proper protocol input routine. + */ + for (i = 0; (protp = protocols[i]) != NULL; ++i) { + if (protp->protocol == protocol) { + pb = ppp_singlebuf(pb); + (*protp->input)(pcb, (u8_t*)pb->payload, pb->len); + goto out; + } +#if 0 /* UNUSED + * + * This is actually a (hacked?) way for the Linux kernel to pass a data + * packet to pppd. pppd in normal condition only do signaling + * (LCP, PAP, CHAP, IPCP, ...) and does not handle any data packet at all. + * + * We don't even need this interface, which is only there because of PPP + * interface limitation between Linux kernel and pppd. For MPPE, which uses + * CCP to negotiate although it is not really a (de)compressor, we added + * ccp_resetrequest() in CCP and MPPE input data flow is calling either + * ccp_resetrequest() or lcp_close() if the issue is, respectively, non-fatal + * or fatal, this is what ccp_datainput() really do. + */ + if (protocol == (protp->protocol & ~0x8000) + && protp->datainput != NULL) { + (*protp->datainput)(pcb, pb->payload, pb->len); + goto out; + } +#endif /* UNUSED */ + } + +#if PPP_DEBUG +#if PPP_PROTOCOLNAME + pname = protocol_name(protocol); + if (pname != NULL) { + ppp_warn("Unsupported protocol '%s' (0x%x) received", pname, protocol); + } else +#endif /* PPP_PROTOCOLNAME */ + ppp_warn("Unsupported protocol 0x%x received", protocol); +#endif /* PPP_DEBUG */ + pbuf_header(pb, (s16_t)sizeof(protocol)); + lcp_sprotrej(pcb, (u8_t*)pb->payload, pb->len); + } + break; + } + +drop: + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(pcb->netif, ifindiscards); + +out: + pbuf_free(pb); +} + +/* merge a pbuf chain into one pbuf */ +struct pbuf *ppp_singlebuf(struct pbuf *p) { + struct pbuf *q, *b; + u8_t *pl; + + if(p->tot_len == p->len) { + return p; + } + + q = pbuf_alloc(PBUF_RAW, p->tot_len, PBUF_RAM); + if(!q) { + PPPDEBUG(LOG_ERR, + ("ppp_singlebuf: unable to alloc new buf (%d)\n", p->tot_len)); + return p; /* live dangerously */ + } + + for(b = p, pl = (u8_t*)q->payload; b != NULL; b = b->next) { + MEMCPY(pl, b->payload, b->len); + pl += b->len; + } + + pbuf_free(p); + + return q; +} + +/* + * Write a pbuf to a ppp link, only used from PPP functions + * to send PPP packets. + * + * IPv4 and IPv6 packets from lwIP are sent, respectively, + * with ppp_netif_output_ip4() and ppp_netif_output_ip6() + * functions (which are callbacks of the netif PPP interface). + * + * RETURN: >= 0 Number of characters written + * -1 Failed to write to device + */ +err_t ppp_write(ppp_pcb *pcb, struct pbuf *p) { +#if PRINTPKT_SUPPORT + ppp_dump_packet("sent", (unsigned char *)p->payload+2, p->len-2); +#endif /* PRINTPKT_SUPPORT */ + return pcb->link_cb->write(pcb, pcb->link_ctx_cb, p); +} + +void ppp_link_terminated(ppp_pcb *pcb) { + PPPDEBUG(LOG_DEBUG, ("ppp_link_terminated[%d]\n", pcb->netif->num)); + pcb->link_cb->disconnect(pcb, pcb->link_ctx_cb); + PPPDEBUG(LOG_DEBUG, ("ppp_link_terminated[%d]: finished.\n", pcb->netif->num)); +} + + +/************************************************************************ + * Functions called by various PPP subsystems to configure + * the PPP interface or change the PPP phase. + */ + +/* + * new_phase - signal the start of a new phase of pppd's operation. + */ +void new_phase(ppp_pcb *pcb, int p) { + pcb->phase = p; + PPPDEBUG(LOG_DEBUG, ("ppp phase changed[%d]: phase=%d\n", pcb->netif->num, pcb->phase)); +#if PPP_NOTIFY_PHASE + if (pcb->notify_phase_cb != NULL) { + pcb->notify_phase_cb(pcb, p, pcb->ctx_cb); + } +#endif /* PPP_NOTIFY_PHASE */ +} + +/* + * ppp_send_config - configure the transmit-side characteristics of + * the ppp interface. + */ +int ppp_send_config(ppp_pcb *pcb, int mtu, u32_t accm, int pcomp, int accomp) { + LWIP_UNUSED_ARG(mtu); + /* pcb->mtu = mtu; -- set correctly with netif_set_mtu */ + + if (pcb->link_cb->send_config) { + pcb->link_cb->send_config(pcb, pcb->link_ctx_cb, accm, pcomp, accomp); + } + + PPPDEBUG(LOG_INFO, ("ppp_send_config[%d]\n", pcb->netif->num) ); + return 0; +} + +/* + * ppp_recv_config - configure the receive-side characteristics of + * the ppp interface. + */ +int ppp_recv_config(ppp_pcb *pcb, int mru, u32_t accm, int pcomp, int accomp) { + LWIP_UNUSED_ARG(mru); + + if (pcb->link_cb->recv_config) { + pcb->link_cb->recv_config(pcb, pcb->link_ctx_cb, accm, pcomp, accomp); + } + + PPPDEBUG(LOG_INFO, ("ppp_recv_config[%d]\n", pcb->netif->num)); + return 0; +} + +#if PPP_IPV4_SUPPORT +/* + * sifaddr - Config the interface IP addresses and netmask. + */ +int sifaddr(ppp_pcb *pcb, u32_t our_adr, u32_t his_adr, u32_t netmask) { + ip4_addr_t ip, nm, gw; + + ip4_addr_set_u32(&ip, our_adr); + ip4_addr_set_u32(&nm, netmask); + ip4_addr_set_u32(&gw, his_adr); + netif_set_addr(pcb->netif, &ip, &nm, &gw); + return 1; +} + +/******************************************************************** + * + * cifaddr - Clear the interface IP addresses, and delete routes + * through the interface if possible. + */ +int cifaddr(ppp_pcb *pcb, u32_t our_adr, u32_t his_adr) { + LWIP_UNUSED_ARG(our_adr); + LWIP_UNUSED_ARG(his_adr); + + netif_set_addr(pcb->netif, IP4_ADDR_ANY, IP4_ADDR_BROADCAST, IP4_ADDR_ANY); + return 1; +} + +#if 0 /* UNUSED - PROXY ARP */ +/******************************************************************** + * + * sifproxyarp - Make a proxy ARP entry for the peer. + */ + +int sifproxyarp(ppp_pcb *pcb, u32_t his_adr) { + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(his_adr); + return 0; +} + +/******************************************************************** + * + * cifproxyarp - Delete the proxy ARP entry for the peer. + */ + +int cifproxyarp(ppp_pcb *pcb, u32_t his_adr) { + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(his_adr); + return 0; +} +#endif /* UNUSED - PROXY ARP */ + +#if LWIP_DNS +/* + * sdns - Config the DNS servers + */ +int sdns(ppp_pcb *pcb, u32_t ns1, u32_t ns2) { + ip_addr_t ns; + LWIP_UNUSED_ARG(pcb); + + ip_addr_set_ip4_u32(&ns, ns1); + dns_setserver(0, &ns); + ip_addr_set_ip4_u32(&ns, ns2); + dns_setserver(1, &ns); + return 1; +} + +/******************************************************************** + * + * cdns - Clear the DNS servers + */ +int cdns(ppp_pcb *pcb, u32_t ns1, u32_t ns2) { + ip_addr_t nsa, nsb; + LWIP_UNUSED_ARG(pcb); + + nsa = dns_getserver(0); + ip_addr_set_ip4_u32(&nsb, ns1); + if (ip_addr_cmp(&nsa, &nsb)) { + dns_setserver(0, IP_ADDR_ANY); + } + nsa = dns_getserver(1); + ip_addr_set_ip4_u32(&nsb, ns2); + if (ip_addr_cmp(&nsa, &nsb)) { + dns_setserver(1, IP_ADDR_ANY); + } + return 1; +} +#endif /* LWIP_DNS */ + +#if VJ_SUPPORT +/******************************************************************** + * + * sifvjcomp - config tcp header compression + */ +int sifvjcomp(ppp_pcb *pcb, int vjcomp, int cidcomp, int maxcid) { + pcb->vj_enabled = vjcomp; + pcb->vj_comp.compressSlot = cidcomp; + pcb->vj_comp.maxSlotIndex = maxcid; + PPPDEBUG(LOG_INFO, ("sifvjcomp[%d]: VJ compress enable=%d slot=%d max slot=%d\n", + pcb->netif->num, vjcomp, cidcomp, maxcid)); + return 0; +} +#endif /* VJ_SUPPORT */ + +/* + * sifup - Config the interface up and enable IP packets to pass. + */ +int sifup(ppp_pcb *pcb) { + pcb->if4_up = 1; + pcb->err_code = PPPERR_NONE; + netif_set_link_up(pcb->netif); + + PPPDEBUG(LOG_DEBUG, ("sifup[%d]: err_code=%d\n", pcb->netif->num, pcb->err_code)); + pcb->link_status_cb(pcb, pcb->err_code, pcb->ctx_cb); + return 1; +} + +/******************************************************************** + * + * sifdown - Disable the indicated protocol and config the interface + * down if there are no remaining protocols. + */ +int sifdown(ppp_pcb *pcb) { + + pcb->if4_up = 0; + + if (1 +#if PPP_IPV6_SUPPORT + /* set the interface down if IPv6 is down as well */ + && !pcb->if6_up +#endif /* PPP_IPV6_SUPPORT */ + ) { + /* make sure the netif link callback is called */ + netif_set_link_down(pcb->netif); + } + PPPDEBUG(LOG_DEBUG, ("sifdown[%d]: err_code=%d\n", pcb->netif->num, pcb->err_code)); + return 1; +} + +/******************************************************************** + * + * Return user specified netmask, modified by any mask we might determine + * for address `addr' (in network byte order). + * Here we scan through the system's list of interfaces, looking for + * any non-point-to-point interfaces which might appear to be on the same + * network as `addr'. If we find any, we OR in their netmask to the + * user-specified netmask. + */ +u32_t get_mask(u32_t addr) { +#if 0 + u32_t mask, nmask; + + addr = htonl(addr); + if (IP_CLASSA(addr)) { /* determine network mask for address class */ + nmask = IP_CLASSA_NET; + } else if (IP_CLASSB(addr)) { + nmask = IP_CLASSB_NET; + } else { + nmask = IP_CLASSC_NET; + } + + /* class D nets are disallowed by bad_ip_adrs */ + mask = PP_HTONL(0xffffff00UL) | htonl(nmask); + + /* XXX + * Scan through the system's network interfaces. + * Get each netmask and OR them into our mask. + */ + /* return mask; */ + return mask; +#endif /* 0 */ + LWIP_UNUSED_ARG(addr); + return IPADDR_BROADCAST; +} +#endif /* PPP_IPV4_SUPPORT */ + +#if PPP_IPV6_SUPPORT +#define IN6_LLADDR_FROM_EUI64(ip6, eui64) do { \ + ip6.addr[0] = PP_HTONL(0xfe800000); \ + ip6.addr[1] = 0; \ + eui64_copy(eui64, ip6.addr[2]); \ + } while (0) + +/******************************************************************** + * + * sif6addr - Config the interface with an IPv6 link-local address + */ +int sif6addr(ppp_pcb *pcb, eui64_t our_eui64, eui64_t his_eui64) { + ip6_addr_t ip6; + LWIP_UNUSED_ARG(his_eui64); + + IN6_LLADDR_FROM_EUI64(ip6, our_eui64); + netif_ip6_addr_set(pcb->netif, 0, &ip6); + netif_ip6_addr_set_state(pcb->netif, 0, IP6_ADDR_PREFERRED); + /* FIXME: should we add an IPv6 static neighbor using his_eui64 ? */ + return 1; +} + +/******************************************************************** + * + * cif6addr - Remove IPv6 address from interface + */ +int cif6addr(ppp_pcb *pcb, eui64_t our_eui64, eui64_t his_eui64) { + LWIP_UNUSED_ARG(our_eui64); + LWIP_UNUSED_ARG(his_eui64); + + netif_ip6_addr_set(pcb->netif, 0, IP6_ADDR_ANY6); + netif_ip6_addr_set_state(pcb->netif, 0, IP6_ADDR_INVALID); + return 1; +} + +/* + * sif6up - Config the interface up and enable IPv6 packets to pass. + */ +int sif6up(ppp_pcb *pcb) { + + pcb->if6_up = 1; + pcb->err_code = PPPERR_NONE; + netif_set_link_up(pcb->netif); + + PPPDEBUG(LOG_DEBUG, ("sif6up[%d]: err_code=%d\n", pcb->netif->num, pcb->err_code)); + pcb->link_status_cb(pcb, pcb->err_code, pcb->ctx_cb); + return 1; +} + +/******************************************************************** + * + * sif6down - Disable the indicated protocol and config the interface + * down if there are no remaining protocols. + */ +int sif6down(ppp_pcb *pcb) { + + pcb->if6_up = 0; + + if (1 +#if PPP_IPV4_SUPPORT + /* set the interface down if IPv4 is down as well */ + && !pcb->if4_up +#endif /* PPP_IPV4_SUPPORT */ + ) { + /* make sure the netif link callback is called */ + netif_set_link_down(pcb->netif); + } + PPPDEBUG(LOG_DEBUG, ("sif6down[%d]: err_code=%d\n", pcb->netif->num, pcb->err_code)); + return 1; +} +#endif /* PPP_IPV6_SUPPORT */ + +#if DEMAND_SUPPORT +/* + * sifnpmode - Set the mode for handling packets for a given NP. + */ +int sifnpmode(ppp_pcb *pcb, int proto, enum NPmode mode) { + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(proto); + LWIP_UNUSED_ARG(mode); + return 0; +} +#endif /* DEMAND_SUPPORT */ + +/* + * netif_set_mtu - set the MTU on the PPP network interface. + */ +void netif_set_mtu(ppp_pcb *pcb, int mtu) { + + pcb->netif->mtu = mtu; + PPPDEBUG(LOG_INFO, ("netif_set_mtu[%d]: mtu=%d\n", pcb->netif->num, mtu)); +} + +/* + * netif_get_mtu - get PPP interface MTU + */ +int netif_get_mtu(ppp_pcb *pcb) { + + return pcb->netif->mtu; +} + +#if CCP_SUPPORT +#if 0 /* unused */ +/* + * ccp_test - whether a given compression method is acceptable for use. + */ +int +ccp_test(ppp_pcb *pcb, u_char *opt_ptr, int opt_len, int for_transmit) +{ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(opt_ptr); + LWIP_UNUSED_ARG(opt_len); + LWIP_UNUSED_ARG(for_transmit); + return -1; +} +#endif /* unused */ + +/* + * ccp_set - inform about the current state of CCP. + */ +void +ccp_set(ppp_pcb *pcb, u8_t isopen, u8_t isup, u8_t receive_method, u8_t transmit_method) +{ + LWIP_UNUSED_ARG(isopen); + LWIP_UNUSED_ARG(isup); + pcb->ccp_receive_method = receive_method; + pcb->ccp_transmit_method = transmit_method; + PPPDEBUG(LOG_DEBUG, ("ccp_set[%d]: is_open=%d, is_up=%d, receive_method=%u, transmit_method=%u\n", + pcb->netif->num, isopen, isup, receive_method, transmit_method)); +} + +void +ccp_reset_comp(ppp_pcb *pcb) +{ + switch (pcb->ccp_transmit_method) { +#if MPPE_SUPPORT + case CI_MPPE: + mppe_comp_reset(pcb, &pcb->mppe_comp); + break; +#endif /* MPPE_SUPPORT */ + default: + break; + } +} + +void +ccp_reset_decomp(ppp_pcb *pcb) +{ + switch (pcb->ccp_receive_method) { +#if MPPE_SUPPORT + case CI_MPPE: + mppe_decomp_reset(pcb, &pcb->mppe_decomp); + break; +#endif /* MPPE_SUPPORT */ + default: + break; + } +} + +#if 0 /* unused */ +/* + * ccp_fatal_error - returns 1 if decompression was disabled as a + * result of an error detected after decompression of a packet, + * 0 otherwise. This is necessary because of patent nonsense. + */ +int +ccp_fatal_error(ppp_pcb *pcb) +{ + LWIP_UNUSED_ARG(pcb); + return 1; +} +#endif /* unused */ +#endif /* CCP_SUPPORT */ + +#if PPP_IDLETIMELIMIT +/******************************************************************** + * + * get_idle_time - return how long the link has been idle. + */ +int get_idle_time(ppp_pcb *pcb, struct ppp_idle *ip) { + /* FIXME: add idle time support and make it optional */ + LWIP_UNUSED_ARG(pcb); + LWIP_UNUSED_ARG(ip); + return 1; +} +#endif /* PPP_IDLETIMELIMIT */ + +#if DEMAND_SUPPORT +/******************************************************************** + * + * get_loop_output - get outgoing packets from the ppp device, + * and detect when we want to bring the real link up. + * Return value is 1 if we need to bring up the link, 0 otherwise. + */ +int get_loop_output(void) { + return 0; +} +#endif /* DEMAND_SUPPORT */ + +#if PPP_PROTOCOLNAME +/* List of protocol names, to make our messages a little more informative. */ +struct protocol_list { + u_short proto; + const char *name; +} protocol_list[] = { + { 0x21, "IP" }, + { 0x23, "OSI Network Layer" }, + { 0x25, "Xerox NS IDP" }, + { 0x27, "DECnet Phase IV" }, + { 0x29, "Appletalk" }, + { 0x2b, "Novell IPX" }, + { 0x2d, "VJ compressed TCP/IP" }, + { 0x2f, "VJ uncompressed TCP/IP" }, + { 0x31, "Bridging PDU" }, + { 0x33, "Stream Protocol ST-II" }, + { 0x35, "Banyan Vines" }, + { 0x39, "AppleTalk EDDP" }, + { 0x3b, "AppleTalk SmartBuffered" }, + { 0x3d, "Multi-Link" }, + { 0x3f, "NETBIOS Framing" }, + { 0x41, "Cisco Systems" }, + { 0x43, "Ascom Timeplex" }, + { 0x45, "Fujitsu Link Backup and Load Balancing (LBLB)" }, + { 0x47, "DCA Remote Lan" }, + { 0x49, "Serial Data Transport Protocol (PPP-SDTP)" }, + { 0x4b, "SNA over 802.2" }, + { 0x4d, "SNA" }, + { 0x4f, "IP6 Header Compression" }, + { 0x51, "KNX Bridging Data" }, + { 0x53, "Encryption" }, + { 0x55, "Individual Link Encryption" }, + { 0x57, "IPv6" }, + { 0x59, "PPP Muxing" }, + { 0x5b, "Vendor-Specific Network Protocol" }, + { 0x61, "RTP IPHC Full Header" }, + { 0x63, "RTP IPHC Compressed TCP" }, + { 0x65, "RTP IPHC Compressed non-TCP" }, + { 0x67, "RTP IPHC Compressed UDP 8" }, + { 0x69, "RTP IPHC Compressed RTP 8" }, + { 0x6f, "Stampede Bridging" }, + { 0x73, "MP+" }, + { 0xc1, "NTCITS IPI" }, + { 0xfb, "single-link compression" }, + { 0xfd, "Compressed Datagram" }, + { 0x0201, "802.1d Hello Packets" }, + { 0x0203, "IBM Source Routing BPDU" }, + { 0x0205, "DEC LANBridge100 Spanning Tree" }, + { 0x0207, "Cisco Discovery Protocol" }, + { 0x0209, "Netcs Twin Routing" }, + { 0x020b, "STP - Scheduled Transfer Protocol" }, + { 0x020d, "EDP - Extreme Discovery Protocol" }, + { 0x0211, "Optical Supervisory Channel Protocol" }, + { 0x0213, "Optical Supervisory Channel Protocol" }, + { 0x0231, "Luxcom" }, + { 0x0233, "Sigma Network Systems" }, + { 0x0235, "Apple Client Server Protocol" }, + { 0x0281, "MPLS Unicast" }, + { 0x0283, "MPLS Multicast" }, + { 0x0285, "IEEE p1284.4 standard - data packets" }, + { 0x0287, "ETSI TETRA Network Protocol Type 1" }, + { 0x0289, "Multichannel Flow Treatment Protocol" }, + { 0x2063, "RTP IPHC Compressed TCP No Delta" }, + { 0x2065, "RTP IPHC Context State" }, + { 0x2067, "RTP IPHC Compressed UDP 16" }, + { 0x2069, "RTP IPHC Compressed RTP 16" }, + { 0x4001, "Cray Communications Control Protocol" }, + { 0x4003, "CDPD Mobile Network Registration Protocol" }, + { 0x4005, "Expand accelerator protocol" }, + { 0x4007, "ODSICP NCP" }, + { 0x4009, "DOCSIS DLL" }, + { 0x400B, "Cetacean Network Detection Protocol" }, + { 0x4021, "Stacker LZS" }, + { 0x4023, "RefTek Protocol" }, + { 0x4025, "Fibre Channel" }, + { 0x4027, "EMIT Protocols" }, + { 0x405b, "Vendor-Specific Protocol (VSP)" }, + { 0x8021, "Internet Protocol Control Protocol" }, + { 0x8023, "OSI Network Layer Control Protocol" }, + { 0x8025, "Xerox NS IDP Control Protocol" }, + { 0x8027, "DECnet Phase IV Control Protocol" }, + { 0x8029, "Appletalk Control Protocol" }, + { 0x802b, "Novell IPX Control Protocol" }, + { 0x8031, "Bridging NCP" }, + { 0x8033, "Stream Protocol Control Protocol" }, + { 0x8035, "Banyan Vines Control Protocol" }, + { 0x803d, "Multi-Link Control Protocol" }, + { 0x803f, "NETBIOS Framing Control Protocol" }, + { 0x8041, "Cisco Systems Control Protocol" }, + { 0x8043, "Ascom Timeplex" }, + { 0x8045, "Fujitsu LBLB Control Protocol" }, + { 0x8047, "DCA Remote Lan Network Control Protocol (RLNCP)" }, + { 0x8049, "Serial Data Control Protocol (PPP-SDCP)" }, + { 0x804b, "SNA over 802.2 Control Protocol" }, + { 0x804d, "SNA Control Protocol" }, + { 0x804f, "IP6 Header Compression Control Protocol" }, + { 0x8051, "KNX Bridging Control Protocol" }, + { 0x8053, "Encryption Control Protocol" }, + { 0x8055, "Individual Link Encryption Control Protocol" }, + { 0x8057, "IPv6 Control Protocol" }, + { 0x8059, "PPP Muxing Control Protocol" }, + { 0x805b, "Vendor-Specific Network Control Protocol (VSNCP)" }, + { 0x806f, "Stampede Bridging Control Protocol" }, + { 0x8073, "MP+ Control Protocol" }, + { 0x80c1, "NTCITS IPI Control Protocol" }, + { 0x80fb, "Single Link Compression Control Protocol" }, + { 0x80fd, "Compression Control Protocol" }, + { 0x8207, "Cisco Discovery Protocol Control" }, + { 0x8209, "Netcs Twin Routing" }, + { 0x820b, "STP - Control Protocol" }, + { 0x820d, "EDPCP - Extreme Discovery Protocol Ctrl Prtcl" }, + { 0x8235, "Apple Client Server Protocol Control" }, + { 0x8281, "MPLSCP" }, + { 0x8285, "IEEE p1284.4 standard - Protocol Control" }, + { 0x8287, "ETSI TETRA TNP1 Control Protocol" }, + { 0x8289, "Multichannel Flow Treatment Protocol" }, + { 0xc021, "Link Control Protocol" }, + { 0xc023, "Password Authentication Protocol" }, + { 0xc025, "Link Quality Report" }, + { 0xc027, "Shiva Password Authentication Protocol" }, + { 0xc029, "CallBack Control Protocol (CBCP)" }, + { 0xc02b, "BACP Bandwidth Allocation Control Protocol" }, + { 0xc02d, "BAP" }, + { 0xc05b, "Vendor-Specific Authentication Protocol (VSAP)" }, + { 0xc081, "Container Control Protocol" }, + { 0xc223, "Challenge Handshake Authentication Protocol" }, + { 0xc225, "RSA Authentication Protocol" }, + { 0xc227, "Extensible Authentication Protocol" }, + { 0xc229, "Mitsubishi Security Info Exch Ptcl (SIEP)" }, + { 0xc26f, "Stampede Bridging Authorization Protocol" }, + { 0xc281, "Proprietary Authentication Protocol" }, + { 0xc283, "Proprietary Authentication Protocol" }, + { 0xc481, "Proprietary Node ID Authentication Protocol" }, + { 0, NULL }, +}; + +/* + * protocol_name - find a name for a PPP protocol. + */ +const char * protocol_name(int proto) { + struct protocol_list *lp; + + for (lp = protocol_list; lp->proto != 0; ++lp) { + if (proto == lp->proto) { + return lp->name; + } + } + return NULL; +} +#endif /* PPP_PROTOCOLNAME */ + +#if PPP_STATS_SUPPORT + +/* ---- Note on PPP Stats support ---- + * + * The one willing link stats support should add the get_ppp_stats() + * to fetch statistics from lwIP. + */ + +/* + * reset_link_stats - "reset" stats when link goes up. + */ +void reset_link_stats(int u) { + if (!get_ppp_stats(u, &old_link_stats)) { + return; + } + gettimeofday(&start_time, NULL); +} + +/* + * update_link_stats - get stats at link termination. + */ +void update_link_stats(int u) { + struct timeval now; + char numbuf[32]; + + if (!get_ppp_stats(u, &link_stats) || gettimeofday(&now, NULL) < 0) { + return; + } + link_connect_time = now.tv_sec - start_time.tv_sec; + link_stats_valid = 1; + + link_stats.bytes_in -= old_link_stats.bytes_in; + link_stats.bytes_out -= old_link_stats.bytes_out; + link_stats.pkts_in -= old_link_stats.pkts_in; + link_stats.pkts_out -= old_link_stats.pkts_out; +} + +void print_link_stats() { + /* + * Print connect time and statistics. + */ + if (link_stats_valid) { + int t = (link_connect_time + 5) / 6; /* 1/10ths of minutes */ + info("Connect time %d.%d minutes.", t/10, t%10); + info("Sent %u bytes, received %u bytes.", link_stats.bytes_out, link_stats.bytes_in); + link_stats_valid = 0; + } +} +#endif /* PPP_STATS_SUPPORT */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/netif/ppp/pppcrypt.c b/components/lwip/netif/ppp/pppcrypt.c new file mode 100755 index 000000000..097f702b3 --- /dev/null +++ b/components/lwip/netif/ppp/pppcrypt.c @@ -0,0 +1,66 @@ +/* + * pppcrypt.c - PPP/DES linkage for MS-CHAP and EAP SRP-SHA1 + * + * Extracted from chap_ms.c by James Carlson. + * + * Copyright (c) 1995 Eric Rosenquist. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && MSCHAP_SUPPORT /* don't build if not necessary */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/pppcrypt.h" + + +static u_char pppcrypt_get_7bits(u_char *input, int startBit) { + unsigned int word; + + word = (unsigned)input[startBit / 8] << 8; + word |= (unsigned)input[startBit / 8 + 1]; + + word >>= 15 - (startBit % 8 + 7); + + return word & 0xFE; +} + +/* IN 56 bit DES key missing parity bits + * OUT 64 bit DES key with parity bits added + */ +void pppcrypt_56_to_64_bit_key(u_char *key, u_char * des_key) { + des_key[0] = pppcrypt_get_7bits(key, 0); + des_key[1] = pppcrypt_get_7bits(key, 7); + des_key[2] = pppcrypt_get_7bits(key, 14); + des_key[3] = pppcrypt_get_7bits(key, 21); + des_key[4] = pppcrypt_get_7bits(key, 28); + des_key[5] = pppcrypt_get_7bits(key, 35); + des_key[6] = pppcrypt_get_7bits(key, 42); + des_key[7] = pppcrypt_get_7bits(key, 49); +} + +#endif /* PPP_SUPPORT && MSCHAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/pppoe.c b/components/lwip/netif/ppp/pppoe.c new file mode 100755 index 000000000..586708b5e --- /dev/null +++ b/components/lwip/netif/ppp/pppoe.c @@ -0,0 +1,1250 @@ +/***************************************************************************** +* pppoe.c - PPP Over Ethernet implementation for lwIP. +* +* Copyright (c) 2006 by Marc Boucher, Services Informatiques (MBSI) inc. +* +* The authors hereby grant permission to use, copy, modify, distribute, +* and license this software and its documentation for any purpose, provided +* that existing copyright notices are retained in all copies and that this +* notice and the following disclaimer are included verbatim in any +* distributions. No written agreement, license, or royalty fee is required +* for any of the authorized uses. +* +* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR +* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +* +****************************************************************************** +* REVISION HISTORY +* +* 06-01-01 Marc Boucher +* Ported to lwIP. +*****************************************************************************/ + + + +/* based on NetBSD: if_pppoe.c,v 1.64 2006/01/31 23:50:15 martin Exp */ + +/*- + * Copyright (c) 2002 The NetBSD Foundation, Inc. + * All rights reserved. + * + * This code is derived from software contributed to The NetBSD Foundation + * by Martin Husemann . + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the NetBSD + * Foundation, Inc. and its contributors. + * 4. Neither the name of The NetBSD Foundation nor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS + * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS + * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOE_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#endif /* UNUSED */ + +#include "lwip/timers.h" +#include "lwip/memp.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/lcp.h" +#include "netif/ppp/ipcp.h" +#include "netif/ppp/pppoe.h" + +/* Add a 16 bit unsigned value to a buffer pointed to by PTR */ +#define PPPOE_ADD_16(PTR, VAL) \ + *(PTR)++ = (u8_t)((VAL) / 256); \ + *(PTR)++ = (u8_t)((VAL) % 256) + +/* Add a complete PPPoE header to the buffer pointed to by PTR */ +#define PPPOE_ADD_HEADER(PTR, CODE, SESS, LEN) \ + *(PTR)++ = PPPOE_VERTYPE; \ + *(PTR)++ = (CODE); \ + PPPOE_ADD_16(PTR, SESS); \ + PPPOE_ADD_16(PTR, LEN) + +#define PPPOE_DISC_TIMEOUT (5*1000) /* base for quick timeout calculation */ +#define PPPOE_SLOW_RETRY (60*1000) /* persistent retry interval */ +#define PPPOE_DISC_MAXPADI 4 /* retry PADI four times (quickly) */ +#define PPPOE_DISC_MAXPADR 2 /* retry PADR twice */ + +#ifdef PPPOE_SERVER +#error "PPPOE_SERVER is not yet supported under lwIP!" +/* from if_spppsubr.c */ +#define IFF_PASSIVE IFF_LINK0 /* wait passively for connection */ +#endif + +#define PPPOE_ERRORSTRING_LEN 64 + + +/* callbacks called from PPP core */ +static err_t pppoe_write(ppp_pcb *ppp, void *ctx, struct pbuf *p); +static err_t pppoe_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *p, u_short protocol); +static err_t pppoe_connect(ppp_pcb *ppp, void *ctx); +static void pppoe_disconnect(ppp_pcb *ppp, void *ctx); +static err_t pppoe_destroy(ppp_pcb *ppp, void *ctx); + +/* management routines */ +static void pppoe_abort_connect(struct pppoe_softc *); +#if 0 /* UNUSED */ +static void pppoe_clear_softc(struct pppoe_softc *, const char *); +#endif /* UNUSED */ + +/* internal timeout handling */ +static void pppoe_timeout(void *); + +/* sending actual protocol controll packets */ +static err_t pppoe_send_padi(struct pppoe_softc *); +static err_t pppoe_send_padr(struct pppoe_softc *); +#ifdef PPPOE_SERVER +static err_t pppoe_send_pado(struct pppoe_softc *); +static err_t pppoe_send_pads(struct pppoe_softc *); +#endif +static err_t pppoe_send_padt(struct netif *, u_int, const u8_t *); + +/* internal helper functions */ +static err_t pppoe_xmit(struct pppoe_softc *sc, struct pbuf *pb); +static struct pppoe_softc* pppoe_find_softc_by_session(u_int session, struct netif *rcvif); +static struct pppoe_softc* pppoe_find_softc_by_hunique(u8_t *token, size_t len, struct netif *rcvif); + +/** linked list of created pppoe interfaces */ +static struct pppoe_softc *pppoe_softc_list; + +/* Callbacks structure for PPP core */ +static const struct link_callbacks pppoe_callbacks = { + pppoe_connect, +#if PPP_SERVER + NULL, +#endif /* PPP_SERVER */ + pppoe_disconnect, + pppoe_destroy, + pppoe_write, + pppoe_netif_output, + NULL, + NULL +}; + +/* + * Create a new PPP Over Ethernet (PPPoE) connection. + * + * Return 0 on success, an error code on failure. + */ +ppp_pcb *pppoe_create(struct netif *pppif, + struct netif *ethif, + const char *service_name, const char *concentrator_name, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb) +{ + ppp_pcb *ppp; + struct pppoe_softc *sc; + LWIP_UNUSED_ARG(service_name); + LWIP_UNUSED_ARG(concentrator_name); + + sc = (struct pppoe_softc *)memp_malloc(MEMP_PPPOE_IF); + if (sc == NULL) { + return NULL; + } + + ppp = ppp_new(pppif, &pppoe_callbacks, sc, link_status_cb, ctx_cb); + if (ppp == NULL) { + memp_free(MEMP_PPPOE_IF, sc); + return NULL; + } + + memset(sc, 0, sizeof(struct pppoe_softc)); + /* changed to real address later */ + MEMCPY(&sc->sc_dest, ethbroadcast.addr, sizeof(sc->sc_dest)); + sc->pcb = ppp; + sc->sc_ethif = ethif; + /* put the new interface at the head of the list */ + sc->next = pppoe_softc_list; + pppoe_softc_list = sc; + return ppp; +} + +/* Called by PPP core */ +static err_t pppoe_write(ppp_pcb *ppp, void *ctx, struct pbuf *p) { + struct pppoe_softc *sc = (struct pppoe_softc *)ctx; + struct pbuf *ph; /* Ethernet + PPPoE header */ + err_t ret; +#if MIB2_STATS + u16_t tot_len; +#else /* MIB2_STATS */ + LWIP_UNUSED_ARG(ppp); +#endif /* MIB2_STATS */ + + /* skip address & flags */ + pbuf_header(p, -(s16_t)2); + + ph = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN), PBUF_RAM); + if(!ph) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.proterr); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + pbuf_free(p); + return ERR_MEM; + } + + pbuf_header(ph, -(s16_t)PPPOE_HEADERLEN); /* hide PPPoE header */ + pbuf_cat(ph, p); +#if MIB2_STATS + tot_len = ph->tot_len; +#endif /* MIB2_STATS */ + + ret = pppoe_xmit(sc, ph); + if (ret != ERR_OK) { + LINK_STATS_INC(link.err); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return ret; + } + + MIB2_STATS_NETIF_ADD(ppp->netif, ifoutoctets, (u16_t)tot_len); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutucastpkts); + LINK_STATS_INC(link.xmit); + return ERR_OK; +} + +/* Called by PPP core */ +static err_t pppoe_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *p, u_short protocol) { + struct pppoe_softc *sc = (struct pppoe_softc *)ctx; + struct pbuf *pb; + u8_t *pl; + err_t err; +#if MIB2_STATS + u16_t tot_len; +#else /* MIB2_STATS */ + LWIP_UNUSED_ARG(ppp); +#endif /* MIB2_STATS */ + + /* @todo: try to use pbuf_header() here! */ + pb = pbuf_alloc(PBUF_LINK, PPPOE_HEADERLEN + sizeof(protocol), PBUF_RAM); + if(!pb) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.proterr); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return ERR_MEM; + } + + pbuf_header(pb, -(s16_t)PPPOE_HEADERLEN); + + pl = (u8_t*)pb->payload; + PUTSHORT(protocol, pl); + + pbuf_chain(pb, p); +#if MIB2_STATS + tot_len = pb->tot_len; +#endif /* MIB2_STATS */ + + if( (err = pppoe_xmit(sc, pb)) != ERR_OK) { + LINK_STATS_INC(link.err); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return err; + } + + MIB2_STATS_NETIF_ADD(ppp->netif, ifoutoctets, tot_len); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutucastpkts); + LINK_STATS_INC(link.xmit); + return ERR_OK; +} + +static err_t +pppoe_destroy(ppp_pcb *ppp, void *ctx) +{ + struct pppoe_softc *sc = (struct pppoe_softc *)ctx; + struct pppoe_softc **copp, *freep; + LWIP_UNUSED_ARG(ppp); + + sys_untimeout(pppoe_timeout, sc); + + /* remove interface from list */ + for (copp = &pppoe_softc_list; (freep = *copp); copp = &freep->next) { + if (freep == sc) { + *copp = freep->next; + break; + } + } + +#ifdef PPPOE_TODO + if (sc->sc_concentrator_name) { + mem_free(sc->sc_concentrator_name); + } + if (sc->sc_service_name) { + mem_free(sc->sc_service_name); + } +#endif /* PPPOE_TODO */ + memp_free(MEMP_PPPOE_IF, sc); + + return ERR_OK; +} + +/* + * Find the interface handling the specified session. + * Note: O(number of sessions open), this is a client-side only, mean + * and lean implementation, so number of open sessions typically should + * be 1. + */ +static struct pppoe_softc* pppoe_find_softc_by_session(u_int session, struct netif *rcvif) { + struct pppoe_softc *sc; + + if (session == 0) { + return NULL; + } + + for (sc = pppoe_softc_list; sc != NULL; sc = sc->next) { + if (sc->sc_state == PPPOE_STATE_SESSION + && sc->sc_session == session + && sc->sc_ethif == rcvif) { + return sc; + } + } + return NULL; +} + +/* Check host unique token passed and return appropriate softc pointer, + * or NULL if token is bogus. */ +static struct pppoe_softc* pppoe_find_softc_by_hunique(u8_t *token, size_t len, struct netif *rcvif) { + struct pppoe_softc *sc, *t; + + if (pppoe_softc_list == NULL) { + return NULL; + } + + if (len != sizeof sc) { + return NULL; + } + MEMCPY(&t, token, len); + + for (sc = pppoe_softc_list; sc != NULL; sc = sc->next) { + if (sc == t) { + break; + } + } + + if (sc == NULL) { + PPPDEBUG(LOG_DEBUG, ("pppoe: alien host unique tag, no session found\n")); + return NULL; + } + + /* should be safe to access *sc now */ + if (sc->sc_state < PPPOE_STATE_PADI_SENT || sc->sc_state >= PPPOE_STATE_SESSION) { + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": host unique tag found, but it belongs to a connection in state %d\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, sc->sc_state)); + return NULL; + } + if (sc->sc_ethif != rcvif) { + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": wrong interface, not accepting host unique\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + return NULL; + } + return sc; +} + +/* analyze and handle a single received packet while not in session state */ +void +pppoe_disc_input(struct netif *netif, struct pbuf *pb) +{ + u16_t tag, len; + u16_t session, plen; + struct pppoe_softc *sc; +#if PPP_DEBUG + const char *err_msg = NULL; +#endif /* PPP_DEBUG */ + u8_t *ac_cookie; + u16_t ac_cookie_len; +#ifdef PPPOE_SERVER + u8_t *hunique; + size_t hunique_len; +#endif + struct pppoehdr *ph; + struct pppoetag pt; + int off, err; + struct eth_hdr *ethhdr; + + /* don't do anything if there is not a single PPPoE instance */ + if (pppoe_softc_list == NULL) { + pbuf_free(pb); + return; + } + + pb = ppp_singlebuf(pb); + + if (pb->len < sizeof(*ethhdr)) { + goto done; + } + ethhdr = (struct eth_hdr *)pb->payload; + off = sizeof(*ethhdr); + + ac_cookie = NULL; + ac_cookie_len = 0; +#ifdef PPPOE_SERVER + hunique = NULL; + hunique_len = 0; +#endif + session = 0; + if (pb->len - off < (u16_t)PPPOE_HEADERLEN) { + PPPDEBUG(LOG_DEBUG, ("pppoe: packet too short: %d\n", pb->len)); + goto done; + } + + ph = (struct pppoehdr *) (ethhdr + 1); + if (ph->vertype != PPPOE_VERTYPE) { + PPPDEBUG(LOG_DEBUG, ("pppoe: unknown version/type packet: 0x%x\n", ph->vertype)); + goto done; + } + session = ntohs(ph->session); + plen = ntohs(ph->plen); + off += sizeof(*ph); + + if (plen + off > pb->len) { + PPPDEBUG(LOG_DEBUG, ("pppoe: packet content does not fit: data available = %d, packet size = %u\n", + pb->len - off, plen)); + goto done; + } + if(pb->tot_len == pb->len) { + pb->tot_len = pb->len = (u16_t)off + plen; /* ignore trailing garbage */ + } + tag = 0; + len = 0; + sc = NULL; + while (off + sizeof(pt) <= pb->len) { + MEMCPY(&pt, (u8_t*)pb->payload + off, sizeof(pt)); + tag = ntohs(pt.tag); + len = ntohs(pt.len); + if (off + sizeof(pt) + len > pb->len) { + PPPDEBUG(LOG_DEBUG, ("pppoe: tag 0x%x len 0x%x is too long\n", tag, len)); + goto done; + } + switch (tag) { + case PPPOE_TAG_EOL: + goto breakbreak; + case PPPOE_TAG_SNAME: + break; /* ignored */ + case PPPOE_TAG_ACNAME: + break; /* ignored */ + case PPPOE_TAG_HUNIQUE: + if (sc != NULL) { + break; + } +#ifdef PPPOE_SERVER + hunique = (u8_t*)pb->payload + off + sizeof(pt); + hunique_len = len; +#endif + sc = pppoe_find_softc_by_hunique((u8_t*)pb->payload + off + sizeof(pt), len, netif); + break; + case PPPOE_TAG_ACCOOKIE: + if (ac_cookie == NULL) { + ac_cookie = (u8_t*)pb->payload + off + sizeof(pt); + ac_cookie_len = len; + } + break; +#if PPP_DEBUG + case PPPOE_TAG_SNAME_ERR: + err_msg = "SERVICE NAME ERROR"; + break; + case PPPOE_TAG_ACSYS_ERR: + err_msg = "AC SYSTEM ERROR"; + break; + case PPPOE_TAG_GENERIC_ERR: + err_msg = "GENERIC ERROR"; + break; +#endif /* PPP_DEBUG */ + default: + break; + } +#if PPP_DEBUG + if (err_msg != NULL) { + char error_tmp[PPPOE_ERRORSTRING_LEN]; + u16_t error_len = LWIP_MIN(len, sizeof(error_tmp)-1); + strncpy(error_tmp, (char*)pb->payload + off + sizeof(pt), error_len); + error_tmp[error_len] = '\0'; + if (sc) { + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": %s: %s\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err_msg, error_tmp)); + } else { + PPPDEBUG(LOG_DEBUG, ("pppoe: %s: %s\n", err_msg, error_tmp)); + } + } +#endif /* PPP_DEBUG */ + off += sizeof(pt) + len; + } + +breakbreak:; + switch (ph->code) { + case PPPOE_CODE_PADI: +#ifdef PPPOE_SERVER + /* + * got service name, concentrator name, and/or host unique. + * ignore if we have no interfaces with IFF_PASSIVE|IFF_UP. + */ + if (LIST_EMPTY(&pppoe_softc_list)) { + goto done; + } + LIST_FOREACH(sc, &pppoe_softc_list, sc_list) { + if (!(sc->sc_sppp.pp_if.if_flags & IFF_UP)) { + continue; + } + if (!(sc->sc_sppp.pp_if.if_flags & IFF_PASSIVE)) { + continue; + } + if (sc->sc_state == PPPOE_STATE_INITIAL) { + break; + } + } + if (sc == NULL) { + /* PPPDEBUG(LOG_DEBUG, ("pppoe: free passive interface is not found\n")); */ + goto done; + } + if (hunique) { + if (sc->sc_hunique) { + mem_free(sc->sc_hunique); + } + sc->sc_hunique = mem_malloc(hunique_len); + if (sc->sc_hunique == NULL) { + goto done; + } + sc->sc_hunique_len = hunique_len; + MEMCPY(sc->sc_hunique, hunique, hunique_len); + } + MEMCPY(&sc->sc_dest, eh->ether_shost, sizeof sc->sc_dest); + sc->sc_state = PPPOE_STATE_PADO_SENT; + pppoe_send_pado(sc); + break; +#endif /* PPPOE_SERVER */ + case PPPOE_CODE_PADR: +#ifdef PPPOE_SERVER + /* + * get sc from ac_cookie if IFF_PASSIVE + */ + if (ac_cookie == NULL) { + /* be quiet if there is not a single pppoe instance */ + PPPDEBUG(LOG_DEBUG, ("pppoe: received PADR but not includes ac_cookie\n")); + goto done; + } + sc = pppoe_find_softc_by_hunique(ac_cookie, ac_cookie_len, netif); + if (sc == NULL) { + /* be quiet if there is not a single pppoe instance */ + if (!LIST_EMPTY(&pppoe_softc_list)) { + PPPDEBUG(LOG_DEBUG, ("pppoe: received PADR but could not find request for it\n")); + } + goto done; + } + if (sc->sc_state != PPPOE_STATE_PADO_SENT) { + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": received unexpected PADR\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + goto done; + } + if (hunique) { + if (sc->sc_hunique) { + mem_free(sc->sc_hunique); + } + sc->sc_hunique = mem_malloc(hunique_len); + if (sc->sc_hunique == NULL) { + goto done; + } + sc->sc_hunique_len = hunique_len; + MEMCPY(sc->sc_hunique, hunique, hunique_len); + } + pppoe_send_pads(sc); + sc->sc_state = PPPOE_STATE_SESSION; + ppp_start(sc->pcb); /* notify upper layers */ + break; +#else + /* ignore, we are no access concentrator */ + goto done; +#endif /* PPPOE_SERVER */ + case PPPOE_CODE_PADO: + if (sc == NULL) { + /* be quiet if there is not a single pppoe instance */ + if (pppoe_softc_list != NULL) { + PPPDEBUG(LOG_DEBUG, ("pppoe: received PADO but could not find request for it\n")); + } + goto done; + } + if (sc->sc_state != PPPOE_STATE_PADI_SENT) { + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": received unexpected PADO\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + goto done; + } + if (ac_cookie) { + sc->sc_ac_cookie_len = ac_cookie_len; + MEMCPY(sc->sc_ac_cookie, ac_cookie, ac_cookie_len); + } + MEMCPY(&sc->sc_dest, ethhdr->src.addr, sizeof(sc->sc_dest.addr)); + sys_untimeout(pppoe_timeout, sc); + sc->sc_padr_retried = 0; + sc->sc_state = PPPOE_STATE_PADR_SENT; + if ((err = pppoe_send_padr(sc)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": failed to send PADR, error=%d\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err)); + } + sys_timeout(PPPOE_DISC_TIMEOUT * (1 + sc->sc_padr_retried), pppoe_timeout, sc); + break; + case PPPOE_CODE_PADS: + if (sc == NULL) { + goto done; + } + sc->sc_session = session; + sys_untimeout(pppoe_timeout, sc); + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": session 0x%x connected\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, session)); + sc->sc_state = PPPOE_STATE_SESSION; + ppp_start(sc->pcb); /* notify upper layers */ + break; + case PPPOE_CODE_PADT: + /* Don't disconnect here, we let the LCP Echo/Reply find the fact + * that PPP session is down. Asking the PPP stack to end the session + * require strict checking about the PPP phase to prevent endless + * disconnection loops. + */ +#if 0 /* UNUSED */ + if (sc == NULL) { /* PADT frames are rarely sent with a hunique tag, this is actually almost always true */ + goto done; + } + pppoe_clear_softc(sc, "received PADT"); +#endif /* UNUSED */ + break; + default: + if(sc) { + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": unknown code (0x%"X16_F") session = 0x%"X16_F"\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, + (u16_t)ph->code, session)); + } else { + PPPDEBUG(LOG_DEBUG, ("pppoe: unknown code (0x%"X16_F") session = 0x%"X16_F"\n", (u16_t)ph->code, session)); + } + break; + } + +done: + pbuf_free(pb); + return; +} + +void +pppoe_data_input(struct netif *netif, struct pbuf *pb) +{ + u16_t session, plen; + struct pppoe_softc *sc; + struct pppoehdr *ph; +#ifdef PPPOE_TERM_UNKNOWN_SESSIONS + u8_t shost[ETHER_ADDR_LEN]; +#endif + +#ifdef PPPOE_TERM_UNKNOWN_SESSIONS + MEMCPY(shost, ((struct eth_hdr *)pb->payload)->src.addr, sizeof(shost)); +#endif + if (pbuf_header(pb, -(s16_t)sizeof(struct eth_hdr)) != 0) { + /* bail out */ + PPPDEBUG(LOG_ERR, ("pppoe_data_input: pbuf_header failed\n")); + LINK_STATS_INC(link.lenerr); + goto drop; + } + + if (pb->len < sizeof(*ph)) { + PPPDEBUG(LOG_DEBUG, ("pppoe_data_input: could not get PPPoE header\n")); + goto drop; + } + ph = (struct pppoehdr *)pb->payload; + + if (ph->vertype != PPPOE_VERTYPE) { + PPPDEBUG(LOG_DEBUG, ("pppoe (data): unknown version/type packet: 0x%x\n", ph->vertype)); + goto drop; + } + if (ph->code != 0) { + goto drop; + } + + session = ntohs(ph->session); + sc = pppoe_find_softc_by_session(session, netif); + if (sc == NULL) { +#ifdef PPPOE_TERM_UNKNOWN_SESSIONS + PPPDEBUG(LOG_DEBUG, ("pppoe: input for unknown session 0x%x, sending PADT\n", session)); + pppoe_send_padt(netif, session, shost); +#endif + goto drop; + } + + plen = ntohs(ph->plen); + + if (pbuf_header(pb, -(s16_t)(PPPOE_HEADERLEN)) != 0) { + /* bail out */ + PPPDEBUG(LOG_ERR, ("pppoe_data_input: pbuf_header PPPOE_HEADERLEN failed\n")); + LINK_STATS_INC(link.lenerr); + goto drop; + } + + PPPDEBUG(LOG_DEBUG, ("pppoe_data_input: %c%c%"U16_F": pkthdr.len=%d, pppoe.len=%d\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, + pb->len, plen)); + + if (pb->tot_len < plen) { + goto drop; + } + + /* Dispatch the packet thereby consuming it. */ + ppp_input(sc->pcb, pb); + return; + +drop: + pbuf_free(pb); +} + +static err_t +pppoe_output(struct pppoe_softc *sc, struct pbuf *pb) +{ + struct eth_hdr *ethhdr; + u16_t etype; + err_t res; + + if (!sc->sc_ethif) { + pbuf_free(pb); + return ERR_IF; + } + + /* make room for Ethernet header - should not fail */ + if (pbuf_header(pb, (s16_t)(sizeof(struct eth_hdr))) != 0) { + /* bail out */ + PPPDEBUG(LOG_ERR, ("pppoe: %c%c%"U16_F": pppoe_output: could not allocate room for Ethernet header\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + LINK_STATS_INC(link.lenerr); + pbuf_free(pb); + return ERR_BUF; + } + ethhdr = (struct eth_hdr *)pb->payload; + etype = sc->sc_state == PPPOE_STATE_SESSION ? ETHTYPE_PPPOE : ETHTYPE_PPPOEDISC; + ethhdr->type = htons(etype); + MEMCPY(ðhdr->dest.addr, &sc->sc_dest.addr, sizeof(ethhdr->dest.addr)); + MEMCPY(ðhdr->src.addr, &sc->sc_ethif->hwaddr, sizeof(ethhdr->src.addr)); + + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F" (%x) state=%d, session=0x%x output -> %02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F":%02"X16_F", len=%d\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, etype, + sc->sc_state, sc->sc_session, + sc->sc_dest.addr[0], sc->sc_dest.addr[1], sc->sc_dest.addr[2], sc->sc_dest.addr[3], sc->sc_dest.addr[4], sc->sc_dest.addr[5], + pb->tot_len)); + + res = sc->sc_ethif->linkoutput(sc->sc_ethif, pb); + + pbuf_free(pb); + + return res; +} + +static err_t +pppoe_send_padi(struct pppoe_softc *sc) +{ + struct pbuf *pb; + u8_t *p; + int len; +#ifdef PPPOE_TODO + int l1 = 0, l2 = 0; /* XXX: gcc */ +#endif /* PPPOE_TODO */ + + if (sc->sc_state >PPPOE_STATE_PADI_SENT) { + PPPDEBUG(LOG_ERR, ("ERROR: pppoe_send_padi in state %d", sc->sc_state)); + } + + /* calculate length of frame (excluding ethernet header + pppoe header) */ + len = 2 + 2 + 2 + 2 + sizeof sc; /* service name tag is required, host unique is send too */ +#ifdef PPPOE_TODO + if (sc->sc_service_name != NULL) { + l1 = (int)strlen(sc->sc_service_name); + len += l1; + } + if (sc->sc_concentrator_name != NULL) { + l2 = (int)strlen(sc->sc_concentrator_name); + len += 2 + 2 + l2; + } +#endif /* PPPOE_TODO */ + LWIP_ASSERT("sizeof(struct eth_hdr) + PPPOE_HEADERLEN + len <= 0xffff", + sizeof(struct eth_hdr) + PPPOE_HEADERLEN + len <= 0xffff); + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN + len), PBUF_RAM); + if (!pb) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + PPPOE_ADD_HEADER(p, PPPOE_CODE_PADI, 0, (u16_t)len); + PPPOE_ADD_16(p, PPPOE_TAG_SNAME); +#ifdef PPPOE_TODO + if (sc->sc_service_name != NULL) { + PPPOE_ADD_16(p, l1); + MEMCPY(p, sc->sc_service_name, l1); + p += l1; + } else +#endif /* PPPOE_TODO */ + { + PPPOE_ADD_16(p, 0); + } +#ifdef PPPOE_TODO + if (sc->sc_concentrator_name != NULL) { + PPPOE_ADD_16(p, PPPOE_TAG_ACNAME); + PPPOE_ADD_16(p, l2); + MEMCPY(p, sc->sc_concentrator_name, l2); + p += l2; + } +#endif /* PPPOE_TODO */ + PPPOE_ADD_16(p, PPPOE_TAG_HUNIQUE); + PPPOE_ADD_16(p, sizeof(sc)); + MEMCPY(p, &sc, sizeof sc); + + /* send pkt */ + return pppoe_output(sc, pb); +} + +static void +pppoe_timeout(void *arg) +{ + u32_t retry_wait; + int err; + struct pppoe_softc *sc = (struct pppoe_softc*)arg; + + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": timeout\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + + switch (sc->sc_state) { + case PPPOE_STATE_PADI_SENT: + /* + * We have two basic ways of retrying: + * - Quick retry mode: try a few times in short sequence + * - Slow retry mode: we already had a connection successfully + * established and will try infinitely (without user + * intervention) + * We only enter slow retry mode if IFF_LINK1 (aka autodial) + * is not set. + */ + if (sc->sc_padi_retried < 0xff) { + sc->sc_padi_retried++; + } + if (!sc->pcb->settings.persist && sc->sc_padi_retried >= PPPOE_DISC_MAXPADI) { +#if 0 + if ((sc->sc_sppp.pp_if.if_flags & IFF_LINK1) == 0) { + /* slow retry mode */ + retry_wait = PPPOE_SLOW_RETRY; + } else +#endif + { + pppoe_abort_connect(sc); + return; + } + } + /* initialize for quick retry mode */ + retry_wait = LWIP_MIN(PPPOE_DISC_TIMEOUT * sc->sc_padi_retried, PPPOE_SLOW_RETRY); + if ((err = pppoe_send_padi(sc)) != 0) { + sc->sc_padi_retried--; + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": failed to transmit PADI, error=%d\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err)); + } + sys_timeout(retry_wait, pppoe_timeout, sc); + break; + + case PPPOE_STATE_PADR_SENT: + sc->sc_padr_retried++; + if (sc->sc_padr_retried >= PPPOE_DISC_MAXPADR) { + MEMCPY(&sc->sc_dest, ethbroadcast.addr, sizeof(sc->sc_dest)); + sc->sc_state = PPPOE_STATE_PADI_SENT; + sc->sc_padr_retried = 0; + if ((err = pppoe_send_padi(sc)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": failed to send PADI, error=%d\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err)); + } + sys_timeout(PPPOE_DISC_TIMEOUT * (1 + sc->sc_padi_retried), pppoe_timeout, sc); + return; + } + if ((err = pppoe_send_padr(sc)) != 0) { + sc->sc_padr_retried--; + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": failed to send PADR, error=%d\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err)); + } + sys_timeout(PPPOE_DISC_TIMEOUT * (1 + sc->sc_padr_retried), pppoe_timeout, sc); + break; + default: + return; /* all done, work in peace */ + } +} + +/* Start a connection (i.e. initiate discovery phase) */ +static err_t +pppoe_connect(ppp_pcb *ppp, void *ctx) +{ + int err; + struct pppoe_softc *sc = (struct pppoe_softc *)ctx; + lcp_options *lcp_wo; + lcp_options *lcp_ao; +#if PPP_IPV4_SUPPORT && VJ_SUPPORT + ipcp_options *ipcp_wo; + ipcp_options *ipcp_ao; +#endif /* PPP_IPV4_SUPPORT && VJ_SUPPORT */ + + if (sc->sc_state != PPPOE_STATE_INITIAL) { + return EBUSY; + } + + /* stop any timer */ + sys_untimeout(pppoe_timeout, sc); + sc->sc_session = 0; + sc->sc_padi_retried = 0; + sc->sc_padr_retried = 0; +#ifdef PPPOE_SERVER + /* wait PADI if IFF_PASSIVE */ + if ((sc->sc_sppp.pp_if.if_flags & IFF_PASSIVE)) { + return 0; + } +#endif + + ppp_clear(ppp); + + lcp_wo = &ppp->lcp_wantoptions; + lcp_wo->mru = sc->sc_ethif->mtu-PPPOE_HEADERLEN-2; /* two byte PPP protocol discriminator, then IP data */ + lcp_wo->neg_asyncmap = 0; + lcp_wo->neg_pcompression = 0; + lcp_wo->neg_accompression = 0; + + lcp_ao = &ppp->lcp_allowoptions; + lcp_ao->mru = sc->sc_ethif->mtu-PPPOE_HEADERLEN-2; /* two byte PPP protocol discriminator, then IP data */ + lcp_ao->neg_asyncmap = 0; + lcp_ao->neg_pcompression = 0; + lcp_ao->neg_accompression = 0; + +#if PPP_IPV4_SUPPORT && VJ_SUPPORT + ipcp_wo = &ppp->ipcp_wantoptions; + ipcp_wo->neg_vj = 0; + ipcp_wo->old_vj = 0; + + ipcp_ao = &ppp->ipcp_allowoptions; + ipcp_ao->neg_vj = 0; + ipcp_ao->old_vj = 0; +#endif /* PPP_IPV4_SUPPORT && VJ_SUPPORT */ + + /* save state, in case we fail to send PADI */ + sc->sc_state = PPPOE_STATE_PADI_SENT; + if ((err = pppoe_send_padi(sc)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": failed to send PADI, error=%d\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, err)); + } + sys_timeout(PPPOE_DISC_TIMEOUT, pppoe_timeout, sc); + return err; +} + +/* disconnect */ +static void +pppoe_disconnect(ppp_pcb *ppp, void *ctx) +{ + struct pppoe_softc *sc = (struct pppoe_softc *)ctx; + + if (sc->sc_state < PPPOE_STATE_SESSION) { + return; + } + + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": disconnecting\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + pppoe_send_padt(sc->sc_ethif, sc->sc_session, (const u8_t *)&sc->sc_dest); + + /* cleanup softc */ + sc->sc_state = PPPOE_STATE_INITIAL; + MEMCPY(&sc->sc_dest, ethbroadcast.addr, sizeof(sc->sc_dest)); + sc->sc_ac_cookie_len = 0; +#ifdef PPPOE_SERVER + if (sc->sc_hunique) { + mem_free(sc->sc_hunique); + sc->sc_hunique = NULL; + } + sc->sc_hunique_len = 0; +#endif + sc->sc_session = 0; + sc->sc_padi_retried = 0; + sc->sc_padr_retried = 0; + + ppp_link_end(ppp); /* notify upper layers */ + return; +} + +/* Connection attempt aborted */ +static void +pppoe_abort_connect(struct pppoe_softc *sc) +{ + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": could not establish connection\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + + /* clear connection state */ + sc->sc_state = PPPOE_STATE_INITIAL; + MEMCPY(&sc->sc_dest, ethbroadcast.addr, sizeof(sc->sc_dest)); + sc->sc_ac_cookie_len = 0; + sc->sc_session = 0; + sc->sc_padi_retried = 0; + sc->sc_padr_retried = 0; + + ppp_link_failed(sc->pcb); /* notify upper layers */ +} + +/* Send a PADR packet */ +static err_t +pppoe_send_padr(struct pppoe_softc *sc) +{ + struct pbuf *pb; + u8_t *p; + size_t len; +#ifdef PPPOE_TODO + size_t l1 = 0; /* XXX: gcc */ +#endif /* PPPOE_TODO */ + + if (sc->sc_state != PPPOE_STATE_PADR_SENT) { + return ERR_CONN; + } + + len = 2 + 2 + 2 + 2 + sizeof(sc); /* service name, host unique */ +#ifdef PPPOE_TODO + if (sc->sc_service_name != NULL) { /* service name tag maybe empty */ + l1 = strlen(sc->sc_service_name); + len += l1; + } +#endif /* PPPOE_TODO */ + if (sc->sc_ac_cookie_len > 0) { + len += 2 + 2 + sc->sc_ac_cookie_len; /* AC cookie */ + } + LWIP_ASSERT("sizeof(struct eth_hdr) + PPPOE_HEADERLEN + len <= 0xffff", + sizeof(struct eth_hdr) + PPPOE_HEADERLEN + len <= 0xffff); + pb = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN + len), PBUF_RAM); + if (!pb) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + p = (u8_t*)pb->payload; + PPPOE_ADD_HEADER(p, PPPOE_CODE_PADR, 0, len); + PPPOE_ADD_16(p, PPPOE_TAG_SNAME); +#ifdef PPPOE_TODO + if (sc->sc_service_name != NULL) { + PPPOE_ADD_16(p, l1); + MEMCPY(p, sc->sc_service_name, l1); + p += l1; + } else +#endif /* PPPOE_TODO */ + { + PPPOE_ADD_16(p, 0); + } + if (sc->sc_ac_cookie_len > 0) { + PPPOE_ADD_16(p, PPPOE_TAG_ACCOOKIE); + PPPOE_ADD_16(p, sc->sc_ac_cookie_len); + MEMCPY(p, sc->sc_ac_cookie, sc->sc_ac_cookie_len); + p += sc->sc_ac_cookie_len; + } + PPPOE_ADD_16(p, PPPOE_TAG_HUNIQUE); + PPPOE_ADD_16(p, sizeof(sc)); + MEMCPY(p, &sc, sizeof sc); + + return pppoe_output(sc, pb); +} + +/* send a PADT packet */ +static err_t +pppoe_send_padt(struct netif *outgoing_if, u_int session, const u8_t *dest) +{ + struct pbuf *pb; + struct eth_hdr *ethhdr; + err_t res; + u8_t *p; + + pb = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN), PBUF_RAM); + if (!pb) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + pbuf_header(pb, (s16_t)sizeof(struct eth_hdr)); + ethhdr = (struct eth_hdr *)pb->payload; + ethhdr->type = PP_HTONS(ETHTYPE_PPPOEDISC); + MEMCPY(ðhdr->dest.addr, dest, sizeof(ethhdr->dest.addr)); + MEMCPY(ðhdr->src.addr, &outgoing_if->hwaddr, sizeof(ethhdr->src.addr)); + + p = (u8_t*)(ethhdr + 1); + PPPOE_ADD_HEADER(p, PPPOE_CODE_PADT, session, 0); + + res = outgoing_if->linkoutput(outgoing_if, pb); + + pbuf_free(pb); + + return res; +} + +#ifdef PPPOE_SERVER +static err_t +pppoe_send_pado(struct pppoe_softc *sc) +{ + struct pbuf *pb; + u8_t *p; + size_t len; + + if (sc->sc_state != PPPOE_STATE_PADO_SENT) { + return ERR_CONN; + } + + /* calc length */ + len = 0; + /* include ac_cookie */ + len += 2 + 2 + sizeof(sc); + /* include hunique */ + len += 2 + 2 + sc->sc_hunique_len; + pb = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN + len), PBUF_RAM); + if (!pb) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + p = (u8_t*)pb->payload; + PPPOE_ADD_HEADER(p, PPPOE_CODE_PADO, 0, len); + PPPOE_ADD_16(p, PPPOE_TAG_ACCOOKIE); + PPPOE_ADD_16(p, sizeof(sc)); + MEMCPY(p, &sc, sizeof(sc)); + p += sizeof(sc); + PPPOE_ADD_16(p, PPPOE_TAG_HUNIQUE); + PPPOE_ADD_16(p, sc->sc_hunique_len); + MEMCPY(p, sc->sc_hunique, sc->sc_hunique_len); + return pppoe_output(sc, pb); +} + +static err_t +pppoe_send_pads(struct pppoe_softc *sc) +{ + struct pbuf *pb; + u8_t *p; + size_t len, l1 = 0; /* XXX: gcc */ + + if (sc->sc_state != PPPOE_STATE_PADO_SENT) { + return ERR_CONN; + } + + sc->sc_session = mono_time.tv_sec % 0xff + 1; + /* calc length */ + len = 0; + /* include hunique */ + len += 2 + 2 + 2 + 2 + sc->sc_hunique_len; /* service name, host unique*/ + if (sc->sc_service_name != NULL) { /* service name tag maybe empty */ + l1 = strlen(sc->sc_service_name); + len += l1; + } + pb = pbuf_alloc(PBUF_LINK, (u16_t)(PPPOE_HEADERLEN + len), PBUF_RAM); + if (!pb) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + p = (u8_t*)pb->payload; + PPPOE_ADD_HEADER(p, PPPOE_CODE_PADS, sc->sc_session, len); + PPPOE_ADD_16(p, PPPOE_TAG_SNAME); + if (sc->sc_service_name != NULL) { + PPPOE_ADD_16(p, l1); + MEMCPY(p, sc->sc_service_name, l1); + p += l1; + } else { + PPPOE_ADD_16(p, 0); + } + PPPOE_ADD_16(p, PPPOE_TAG_HUNIQUE); + PPPOE_ADD_16(p, sc->sc_hunique_len); + MEMCPY(p, sc->sc_hunique, sc->sc_hunique_len); + return pppoe_output(sc, pb); +} +#endif + +static err_t +pppoe_xmit(struct pppoe_softc *sc, struct pbuf *pb) +{ + u8_t *p; + size_t len; + + /* are we ready to process data yet? */ + if (sc->sc_state < PPPOE_STATE_SESSION) { + /*sppp_flush(&sc->sc_sppp.pp_if);*/ + pbuf_free(pb); + return ERR_CONN; + } + + len = pb->tot_len; + + /* make room for PPPoE header - should not fail */ + if (pbuf_header(pb, (s16_t)(PPPOE_HEADERLEN)) != 0) { + /* bail out */ + PPPDEBUG(LOG_ERR, ("pppoe: %c%c%"U16_F": pppoe_xmit: could not allocate room for PPPoE header\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + LINK_STATS_INC(link.lenerr); + pbuf_free(pb); + return ERR_BUF; + } + + p = (u8_t*)pb->payload; + PPPOE_ADD_HEADER(p, 0, sc->sc_session, len); + + return pppoe_output(sc, pb); +} + +#if 0 /*def PFIL_HOOKS*/ +static int +pppoe_ifattach_hook(void *arg, struct pbuf **mp, struct netif *ifp, int dir) +{ + struct pppoe_softc *sc; + int s; + + if (mp != (struct pbuf **)PFIL_IFNET_DETACH) { + return 0; + } + + LIST_FOREACH(sc, &pppoe_softc_list, sc_list) { + if (sc->sc_ethif != ifp) { + continue; + } + if (sc->sc_sppp.pp_if.if_flags & IFF_UP) { + sc->sc_sppp.pp_if.if_flags &= ~(IFF_UP|IFF_RUNNING); + PPPDEBUG(LOG_DEBUG, ("%c%c%"U16_F": ethernet interface detached, going down\n", + sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num)); + } + sc->sc_ethif = NULL; + pppoe_clear_softc(sc, "ethernet interface detached"); + } + + return 0; +} +#endif + +#if 0 /* UNUSED */ +static void +pppoe_clear_softc(struct pppoe_softc *sc, const char *message) +{ + LWIP_UNUSED_ARG(message); + + /* stop timer */ + sys_untimeout(pppoe_timeout, sc); + PPPDEBUG(LOG_DEBUG, ("pppoe: %c%c%"U16_F": session 0x%x terminated, %s\n", sc->sc_ethif->name[0], sc->sc_ethif->name[1], sc->sc_ethif->num, sc->sc_session, message)); + /* fix our state */ + sc->sc_state = PPPOE_STATE_INITIAL; + + /* notify upper layers */ + ppp_link_end(sc->pcb); /* /!\ dangerous /!\ */ + + /* clean up softc */ + MEMCPY(&sc->sc_dest, ethbroadcast.addr, sizeof(sc->sc_dest)); + sc->sc_ac_cookie_len = 0; + sc->sc_session = 0; + sc->sc_padi_retried = 0; + sc->sc_padr_retried = 0; +} +#endif /* UNUSED */ +#endif /* PPP_SUPPORT && PPPOE_SUPPORT */ diff --git a/components/lwip/netif/ppp/pppol2tp.c b/components/lwip/netif/ppp/pppol2tp.c new file mode 100755 index 000000000..99b4e5fda --- /dev/null +++ b/components/lwip/netif/ppp/pppol2tp.c @@ -0,0 +1,1151 @@ +/** + * @file + * Network Point to Point Protocol over Layer 2 Tunneling Protocol program file. + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +/* + * L2TP Support status: + * + * Supported: + * - L2TPv2 (PPP over L2TP, a.k.a. UDP tunnels) + * - LAC + * + * Not supported: + * - LNS (require PPP server support) + * - L2TPv3 ethernet pseudowires + * - L2TPv3 VLAN pseudowire + * - L2TPv3 PPP pseudowires + * - L2TPv3 IP encapsulation + * - L2TPv3 IP pseudowire + * - L2TP tunnel switching - http://tools.ietf.org/html/draft-ietf-l2tpext-tunnel-switching-08 + * - Multiple tunnels per UDP socket, as well as multiple sessions per tunnel + * - Hidden AVPs + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOL2TP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include "lwip/err.h" +#include "lwip/memp.h" +#include "lwip/netif.h" +#include "lwip/udp.h" +#include "lwip/snmp.h" + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/lcp.h" +#include "netif/ppp/ipcp.h" +#include "netif/ppp/pppol2tp.h" + +#include "netif/ppp/magic.h" + +#if PPPOL2TP_AUTH_SUPPORT +#if LWIP_INCLUDED_POLARSSL_MD5 +#include "netif/ppp/polarssl/md5.h" +#else +#include "polarssl/md5.h" +#endif +#endif /* PPPOL2TP_AUTH_SUPPORT */ + +/* callbacks called from PPP core */ +static err_t pppol2tp_write(ppp_pcb *ppp, void *ctx, struct pbuf *p); +static err_t pppol2tp_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *p, u_short protocol); +static err_t pppol2tp_destroy(ppp_pcb *ppp, void *ctx); /* Destroy a L2TP control block */ +static err_t pppol2tp_connect(ppp_pcb *ppp, void *ctx); /* Be a LAC, connect to a LNS. */ +static void pppol2tp_disconnect(ppp_pcb *ppp, void *ctx); /* Disconnect */ + + /* Prototypes for procedures local to this file. */ +static void pppol2tp_input(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port); +static void pppol2tp_dispatch_control_packet(pppol2tp_pcb *l2tp, u16_t port, struct pbuf *p, u16_t ns, u16_t nr); +static void pppol2tp_timeout(void *arg); +static void pppol2tp_abort_connect(pppol2tp_pcb *l2tp); +static void pppol2tp_clear(pppol2tp_pcb *l2tp); +static err_t pppol2tp_send_sccrq(pppol2tp_pcb *l2tp); +static err_t pppol2tp_send_scccn(pppol2tp_pcb *l2tp, u16_t ns); +static err_t pppol2tp_send_icrq(pppol2tp_pcb *l2tp, u16_t ns); +static err_t pppol2tp_send_iccn(pppol2tp_pcb *l2tp, u16_t ns); +static err_t pppol2tp_send_zlb(pppol2tp_pcb *l2tp, u16_t ns); +static err_t pppol2tp_send_stopccn(pppol2tp_pcb *l2tp, u16_t ns); +static err_t pppol2tp_xmit(pppol2tp_pcb *l2tp, struct pbuf *pb); +static err_t pppol2tp_udp_send(pppol2tp_pcb *l2tp, struct pbuf *pb); + +/* Callbacks structure for PPP core */ +static const struct link_callbacks pppol2tp_callbacks = { + pppol2tp_connect, +#if PPP_SERVER + NULL, +#endif /* PPP_SERVER */ + pppol2tp_disconnect, + pppol2tp_destroy, + pppol2tp_write, + pppol2tp_netif_output, + NULL, + NULL +}; + + +/* Create a new L2TP session. */ +ppp_pcb *pppol2tp_create(struct netif *pppif, + struct netif *netif, ip_addr_t *ipaddr, u16_t port, + const u8_t *secret, u8_t secret_len, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb) { + ppp_pcb *ppp; + pppol2tp_pcb *l2tp; + struct udp_pcb *udp; + + if (ipaddr == NULL) { + goto ipaddr_check_failed; + } + + l2tp = (pppol2tp_pcb *)memp_malloc(MEMP_PPPOL2TP_PCB); + if (l2tp == NULL) { + goto memp_malloc_l2tp_failed; + } + + udp = udp_new_ip_type(IP_GET_TYPE(ipaddr)); + if (udp == NULL) { + goto udp_new_failed; + } + udp_recv(udp, pppol2tp_input, l2tp); + + ppp = ppp_new(pppif, &pppol2tp_callbacks, l2tp, link_status_cb, ctx_cb); + if (ppp == NULL) { + goto ppp_new_failed; + } + + memset(l2tp, 0, sizeof(pppol2tp_pcb)); + l2tp->phase = PPPOL2TP_STATE_INITIAL; + l2tp->ppp = ppp; + l2tp->udp = udp; + l2tp->netif = netif; + ip_addr_copy(l2tp->remote_ip, *ipaddr); + l2tp->remote_port = port; +#if PPPOL2TP_AUTH_SUPPORT + l2tp->secret = secret; + l2tp->secret_len = secret_len; +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + return ppp; + +ppp_new_failed: + udp_remove(udp); +udp_new_failed: + memp_free(MEMP_PPPOL2TP_PCB, l2tp); +memp_malloc_l2tp_failed: +ipaddr_check_failed: + return NULL; +} + +/* Called by PPP core */ +static err_t pppol2tp_write(ppp_pcb *ppp, void *ctx, struct pbuf *p) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb *)ctx; + struct pbuf *ph; /* UDP + L2TP header */ + err_t ret; +#if MIB2_STATS + u16_t tot_len; +#else /* MIB2_STATS */ + LWIP_UNUSED_ARG(ppp); +#endif /* MIB2_STATS */ + + ph = pbuf_alloc(PBUF_TRANSPORT, (u16_t)(PPPOL2TP_OUTPUT_DATA_HEADER_LEN), PBUF_RAM); + if(!ph) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.proterr); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + pbuf_free(p); + return ERR_MEM; + } + + pbuf_header(ph, -(s16_t)PPPOL2TP_OUTPUT_DATA_HEADER_LEN); /* hide L2TP header */ + pbuf_cat(ph, p); +#if MIB2_STATS + tot_len = ph->tot_len; +#endif /* MIB2_STATS */ + + ret = pppol2tp_xmit(l2tp, ph); + if (ret != ERR_OK) { + LINK_STATS_INC(link.err); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return ret; + } + + MIB2_STATS_NETIF_ADD(ppp->netif, ifoutoctets, (u16_t)tot_len); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutucastpkts); + LINK_STATS_INC(link.xmit); + return ERR_OK; +} + +/* Called by PPP core */ +static err_t pppol2tp_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *p, u_short protocol) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb *)ctx; + struct pbuf *pb; + u8_t *pl; + err_t err; +#if MIB2_STATS + u16_t tot_len; +#else /* MIB2_STATS */ + LWIP_UNUSED_ARG(ppp); +#endif /* MIB2_STATS */ + + /* @todo: try to use pbuf_header() here! */ + pb = pbuf_alloc(PBUF_TRANSPORT, PPPOL2TP_OUTPUT_DATA_HEADER_LEN + sizeof(protocol), PBUF_RAM); + if(!pb) { + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.proterr); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return ERR_MEM; + } + + pbuf_header(pb, -(s16_t)PPPOL2TP_OUTPUT_DATA_HEADER_LEN); + + pl = (u8_t*)pb->payload; + PUTSHORT(protocol, pl); + + pbuf_chain(pb, p); +#if MIB2_STATS + tot_len = pb->tot_len; +#endif /* MIB2_STATS */ + + if( (err = pppol2tp_xmit(l2tp, pb)) != ERR_OK) { + LINK_STATS_INC(link.err); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return err; + } + + MIB2_STATS_NETIF_ADD(ppp->netif, ifoutoctets, tot_len); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutucastpkts); + LINK_STATS_INC(link.xmit); + return ERR_OK; +} + +/* Destroy a L2TP control block */ +static err_t pppol2tp_destroy(ppp_pcb *ppp, void *ctx) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb *)ctx; + LWIP_UNUSED_ARG(ppp); + + sys_untimeout(pppol2tp_timeout, l2tp); + if (l2tp->udp != NULL) { + udp_remove(l2tp->udp); + } + memp_free(MEMP_PPPOL2TP_PCB, l2tp); + return ERR_OK; +} + +/* Be a LAC, connect to a LNS. */ +static err_t pppol2tp_connect(ppp_pcb *ppp, void *ctx) { + err_t err; + pppol2tp_pcb *l2tp = (pppol2tp_pcb *)ctx; + lcp_options *lcp_wo; + lcp_options *lcp_ao; +#if PPP_IPV4_SUPPORT && VJ_SUPPORT + ipcp_options *ipcp_wo; + ipcp_options *ipcp_ao; +#endif /* PPP_IPV4_SUPPORT && VJ_SUPPORT */ + + if (l2tp->phase != PPPOL2TP_STATE_INITIAL) { + return ERR_VAL; + } + + pppol2tp_clear(l2tp); + + ppp_clear(ppp); + + lcp_wo = &ppp->lcp_wantoptions; + lcp_wo->mru = PPPOL2TP_DEFMRU; + lcp_wo->neg_asyncmap = 0; + lcp_wo->neg_pcompression = 0; + lcp_wo->neg_accompression = 0; + + lcp_ao = &ppp->lcp_allowoptions; + lcp_ao->mru = PPPOL2TP_DEFMRU; + lcp_ao->neg_asyncmap = 0; + lcp_ao->neg_pcompression = 0; + lcp_ao->neg_accompression = 0; + +#if PPP_IPV4_SUPPORT && VJ_SUPPORT + ipcp_wo = &ppp->ipcp_wantoptions; + ipcp_wo->neg_vj = 0; + ipcp_wo->old_vj = 0; + + ipcp_ao = &ppp->ipcp_allowoptions; + ipcp_ao->neg_vj = 0; + ipcp_ao->old_vj = 0; +#endif /* PPP_IPV4_SUPPORT && VJ_SUPPORT */ + + /* Listen to a random source port, we need to do that instead of using udp_connect() + * because the L2TP LNS might answer with its own random source port (!= 1701) + */ +#if LWIP_IPV6 + if (IP_IS_V6_VAL(l2tp->udp->local_ip)) { + udp_bind(l2tp->udp, IP6_ADDR_ANY, 0); + } else +#endif /* LWIP_IPV6 */ + udp_bind(l2tp->udp, IP_ADDR_ANY, 0); + +#if PPPOL2TP_AUTH_SUPPORT + /* Generate random vector */ + if (l2tp->secret != NULL) { + magic_random_bytes(l2tp->secret_rv, sizeof(l2tp->secret_rv)); + } +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + do { + l2tp->remote_tunnel_id = magic(); + } while(l2tp->remote_tunnel_id == 0); + /* save state, in case we fail to send SCCRQ */ + l2tp->sccrq_retried = 0; + l2tp->phase = PPPOL2TP_STATE_SCCRQ_SENT; + if ((err = pppol2tp_send_sccrq(l2tp)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send SCCRQ, error=%d\n", err)); + } + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + return err; +} + +/* Disconnect */ +static void pppol2tp_disconnect(ppp_pcb *ppp, void *ctx) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb *)ctx; + + if (l2tp->phase < PPPOL2TP_STATE_DATA) { + return; + } + + l2tp->our_ns++; + pppol2tp_send_stopccn(l2tp, l2tp->our_ns); + + pppol2tp_clear(l2tp); + ppp_link_end(ppp); /* notify upper layers */ +} + +/* UDP Callback for incoming IPv4 L2TP frames */ +static void pppol2tp_input(void *arg, struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *addr, u16_t port) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb*)arg; + u16_t hflags, hlen, len=0, tunnel_id=0, session_id=0, ns=0, nr=0, offset=0; + u8_t *inp; + LWIP_UNUSED_ARG(pcb); + + if (l2tp->phase < PPPOL2TP_STATE_SCCRQ_SENT) { + goto free_and_return; + } + + if (!ip_addr_cmp(&l2tp->remote_ip, addr)) { + goto free_and_return; + } + + /* discard packet if port mismatch, but only if we received a SCCRP */ + if (l2tp->phase > PPPOL2TP_STATE_SCCRQ_SENT && l2tp->tunnel_port != port) { + goto free_and_return; + } + + /* printf("-----------\nL2TP INPUT, %d\n", p->len); */ + + /* L2TP header */ + if (p->len < sizeof(hflags) + sizeof(tunnel_id) + sizeof(session_id) ) { + goto packet_too_short; + } + + inp = (u8_t*)p->payload; + GETSHORT(hflags, inp); + + if (hflags & PPPOL2TP_HEADERFLAG_CONTROL) { + /* check mandatory flags for a control packet */ + if ( (hflags & PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY) != PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY ) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: mandatory header flags for control packet not set\n")); + goto free_and_return; + } + /* check forbidden flags for a control packet */ + if (hflags & PPPOL2TP_HEADERFLAG_CONTROL_FORBIDDEN) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: forbidden header flags for control packet found\n")); + goto free_and_return; + } + } else { + /* check mandatory flags for a data packet */ + if ( (hflags & PPPOL2TP_HEADERFLAG_DATA_MANDATORY) != PPPOL2TP_HEADERFLAG_DATA_MANDATORY) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: mandatory header flags for data packet not set\n")); + goto free_and_return; + } + } + + /* Expected header size */ + hlen = sizeof(hflags) + sizeof(tunnel_id) + sizeof(session_id); + if (hflags & PPPOL2TP_HEADERFLAG_LENGTH) { + hlen += sizeof(len); + } + if (hflags & PPPOL2TP_HEADERFLAG_SEQUENCE) { + hlen += sizeof(ns) + sizeof(nr); + } + if (hflags & PPPOL2TP_HEADERFLAG_OFFSET) { + hlen += sizeof(offset); + } + if (p->len < hlen) { + goto packet_too_short; + } + + if (hflags & PPPOL2TP_HEADERFLAG_LENGTH) { + GETSHORT(len, inp); + if (p->len < len || len < hlen) { + goto packet_too_short; + } + } + GETSHORT(tunnel_id, inp); + GETSHORT(session_id, inp); + if (hflags & PPPOL2TP_HEADERFLAG_SEQUENCE) { + GETSHORT(ns, inp); + GETSHORT(nr, inp); + } + if (hflags & PPPOL2TP_HEADERFLAG_OFFSET) { + GETSHORT(offset, inp) + if (offset > 4096) { /* don't be fooled with large offset which might overflow hlen */ + PPPDEBUG(LOG_DEBUG, ("pppol2tp: strange packet received, offset=%d\n", offset)); + goto free_and_return; + } + hlen += offset; + if (p->len < hlen) { + goto packet_too_short; + } + INCPTR(offset, inp); + } + + /* printf("HLEN = %d\n", hlen); */ + + /* skip L2TP header */ + if (pbuf_header(p, -(s16_t)hlen) != 0) { + goto free_and_return; + } + + /* printf("LEN=%d, TUNNEL_ID=%d, SESSION_ID=%d, NS=%d, NR=%d, OFFSET=%d\n", len, tunnel_id, session_id, ns, nr, offset); */ + PPPDEBUG(LOG_DEBUG, ("pppol2tp: input packet, len=%"U16_F", tunnel=%"U16_F", session=%"U16_F", ns=%"U16_F", nr=%"U16_F"\n", + len, tunnel_id, session_id, ns, nr)); + + /* Control packet */ + if (hflags & PPPOL2TP_HEADERFLAG_CONTROL) { + pppol2tp_dispatch_control_packet(l2tp, port, p, ns, nr); + goto free_and_return; + } + + /* Data packet */ + if(l2tp->phase != PPPOL2TP_STATE_DATA) { + goto free_and_return; + } + if(tunnel_id != l2tp->remote_tunnel_id) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: tunnel ID mismatch, assigned=%d, received=%d\n", l2tp->remote_tunnel_id, tunnel_id)); + goto free_and_return; + } + if(session_id != l2tp->remote_session_id) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: session ID mismatch, assigned=%d, received=%d\n", l2tp->remote_session_id, session_id)); + goto free_and_return; + } + /* + * skip address & flags if necessary + * + * RFC 2661 does not specify whether the PPP frame in the L2TP payload should + * have a HDLC header or not. We handle both cases for compatibility. + */ + if (p->len >= 2) { + GETSHORT(hflags, inp); + if (hflags == 0xff03) { + pbuf_header(p, -(s16_t)2); + } + } + /* Dispatch the packet thereby consuming it. */ + ppp_input(l2tp->ppp, p); + return; + +packet_too_short: + PPPDEBUG(LOG_DEBUG, ("pppol2tp: packet too short: %d\n", p->len)); +free_and_return: + pbuf_free(p); +} + +/* L2TP Control packet entry point */ +static void pppol2tp_dispatch_control_packet(pppol2tp_pcb *l2tp, u16_t port, struct pbuf *p, u16_t ns, u16_t nr) { + u8_t *inp; + u16_t avplen, avpflags, vendorid, attributetype, messagetype=0; + err_t err; +#if PPPOL2TP_AUTH_SUPPORT + md5_context md5_ctx; + u8_t md5_hash[16]; + u8_t challenge_id = 0; +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + l2tp->peer_nr = nr; + l2tp->peer_ns = ns; + /* printf("L2TP CTRL INPUT, ns=%d, nr=%d, len=%d\n", ns, nr, p->len); */ + + /* Handle the special case of the ICCN acknowledge */ + if (l2tp->phase == PPPOL2TP_STATE_ICCN_SENT && l2tp->peer_nr > l2tp->our_ns) { + l2tp->phase = PPPOL2TP_STATE_DATA; + } + + /* ZLB packets */ + if (p->tot_len == 0) { + return; + } + + p = ppp_singlebuf(p); + inp = (u8_t*)p->payload; + /* Decode AVPs */ + while (p->len > 0) { + if (p->len < sizeof(avpflags) + sizeof(vendorid) + sizeof(attributetype) ) { + goto packet_too_short; + } + GETSHORT(avpflags, inp); + avplen = avpflags & PPPOL2TP_AVPHEADERFLAG_LENGTHMASK; + /* printf("AVPLEN = %d\n", avplen); */ + if (p->len < avplen || avplen < sizeof(avpflags) + sizeof(vendorid) + sizeof(attributetype)) { + goto packet_too_short; + } + GETSHORT(vendorid, inp); + GETSHORT(attributetype, inp); + avplen -= sizeof(avpflags) + sizeof(vendorid) + sizeof(attributetype); + + /* Message type must be the first AVP */ + if (messagetype == 0) { + if (attributetype != 0 || vendorid != 0 || avplen != sizeof(messagetype) ) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: message type must be the first AVP\n")); + return; + } + GETSHORT(messagetype, inp); + /* printf("Message type = %d\n", messagetype); */ + switch(messagetype) { + /* Start Control Connection Reply */ + case PPPOL2TP_MESSAGETYPE_SCCRP: + /* Only accept SCCRP packet if we sent a SCCRQ */ + if (l2tp->phase != PPPOL2TP_STATE_SCCRQ_SENT) { + goto send_zlb; + } + break; + /* Incoming Call Reply */ + case PPPOL2TP_MESSAGETYPE_ICRP: + /* Only accept ICRP packet if we sent a IRCQ */ + if (l2tp->phase != PPPOL2TP_STATE_ICRQ_SENT) { + goto send_zlb; + } + break; + /* Stop Control Connection Notification */ + case PPPOL2TP_MESSAGETYPE_STOPCCN: + pppol2tp_send_zlb(l2tp, l2tp->our_ns); /* Ack the StopCCN before we switch to down state */ + if (l2tp->phase < PPPOL2TP_STATE_DATA) { + pppol2tp_abort_connect(l2tp); + } else if (l2tp->phase == PPPOL2TP_STATE_DATA) { + /* Don't disconnect here, we let the LCP Echo/Reply find the fact + * that PPP session is down. Asking the PPP stack to end the session + * require strict checking about the PPP phase to prevent endless + * disconnection loops. + */ + } + return; + default: + break; + } + goto nextavp; + } + + /* Skip proprietary L2TP extensions */ + if (vendorid != 0) { + goto skipavp; + } + + switch (messagetype) { + /* Start Control Connection Reply */ + case PPPOL2TP_MESSAGETYPE_SCCRP: + switch (attributetype) { + case PPPOL2TP_AVPTYPE_TUNNELID: + if (avplen != sizeof(l2tp->source_tunnel_id) ) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: AVP Assign tunnel ID length check failed\n")); + return; + } + GETSHORT(l2tp->source_tunnel_id, inp); + PPPDEBUG(LOG_DEBUG, ("pppol2tp: Assigned tunnel ID %"U16_F"\n", l2tp->source_tunnel_id)); + goto nextavp; +#if PPPOL2TP_AUTH_SUPPORT + case PPPOL2TP_AVPTYPE_CHALLENGE: + if (avplen == 0) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: Challenge length check failed\n")); + return; + } + if (l2tp->secret == NULL) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: Received challenge from peer and no secret key available\n")); + pppol2tp_abort_connect(l2tp); + return; + } + /* Generate hash of ID, secret, challenge */ + md5_starts(&md5_ctx); + challenge_id = PPPOL2TP_MESSAGETYPE_SCCCN; + md5_update(&md5_ctx, &challenge_id, 1); + md5_update(&md5_ctx, l2tp->secret, l2tp->secret_len); + md5_update(&md5_ctx, inp, avplen); + md5_finish(&md5_ctx, l2tp->challenge_hash); + l2tp->send_challenge = 1; + goto skipavp; + case PPPOL2TP_AVPTYPE_CHALLENGERESPONSE: + if (avplen != PPPOL2TP_AVPTYPE_CHALLENGERESPONSE_SIZE) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: AVP Challenge Response length check failed\n")); + return; + } + /* Generate hash of ID, secret, challenge */ + md5_starts(&md5_ctx); + challenge_id = PPPOL2TP_MESSAGETYPE_SCCRP; + md5_update(&md5_ctx, &challenge_id, 1); + md5_update(&md5_ctx, l2tp->secret, l2tp->secret_len); + md5_update(&md5_ctx, l2tp->secret_rv, sizeof(l2tp->secret_rv)); + md5_finish(&md5_ctx, md5_hash); + if ( memcmp(inp, md5_hash, sizeof(md5_hash)) ) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: Received challenge response from peer and secret key do not match\n")); + pppol2tp_abort_connect(l2tp); + return; + } + goto skipavp; +#endif /* PPPOL2TP_AUTH_SUPPORT */ + default: + break; + } + break; + /* Incoming Call Reply */ + case PPPOL2TP_MESSAGETYPE_ICRP: + switch (attributetype) { + case PPPOL2TP_AVPTYPE_SESSIONID: + if (avplen != sizeof(l2tp->source_session_id) ) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: AVP Assign session ID length check failed\n")); + return; + } + GETSHORT(l2tp->source_session_id, inp); + PPPDEBUG(LOG_DEBUG, ("pppol2tp: Assigned session ID %"U16_F"\n", l2tp->source_session_id)); + goto nextavp; + default: + break; + } + break; + default: + break; + } + +skipavp: + INCPTR(avplen, inp); +nextavp: + /* printf("AVP Found, vendor=%d, attribute=%d, len=%d\n", vendorid, attributetype, avplen); */ + /* next AVP */ + if (pbuf_header(p, -(s16_t)(avplen + sizeof(avpflags) + sizeof(vendorid) + sizeof(attributetype)) ) != 0) { + return; + } + } + + switch(messagetype) { + /* Start Control Connection Reply */ + case PPPOL2TP_MESSAGETYPE_SCCRP: + do { + l2tp->remote_session_id = magic(); + } while(l2tp->remote_session_id == 0); + l2tp->tunnel_port = port; /* LNS server might have chosen its own local port */ + l2tp->icrq_retried = 0; + l2tp->phase = PPPOL2TP_STATE_ICRQ_SENT; + l2tp->our_ns++; + if ((err = pppol2tp_send_scccn(l2tp, l2tp->our_ns)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send SCCCN, error=%d\n", err)); + } + l2tp->our_ns++; + if ((err = pppol2tp_send_icrq(l2tp, l2tp->our_ns)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send ICRQ, error=%d\n", err)); + } + sys_untimeout(pppol2tp_timeout, l2tp); + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + break; + /* Incoming Call Reply */ + case PPPOL2TP_MESSAGETYPE_ICRP: + l2tp->iccn_retried = 0; + l2tp->phase = PPPOL2TP_STATE_ICCN_SENT; + l2tp->our_ns++; + ppp_start(l2tp->ppp); /* notify upper layers */ + if ((err = pppol2tp_send_iccn(l2tp, l2tp->our_ns)) != 0) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send ICCN, error=%d\n", err)); + } + sys_untimeout(pppol2tp_timeout, l2tp); + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + break; + /* Unhandled packet, send ZLB ACK */ + default: + goto send_zlb; + } + return; + +send_zlb: + pppol2tp_send_zlb(l2tp, l2tp->our_ns); + return; +packet_too_short: + PPPDEBUG(LOG_DEBUG, ("pppol2tp: packet too short: %d\n", p->len)); +} + +/* L2TP Timeout handler */ +static void pppol2tp_timeout(void *arg) { + pppol2tp_pcb *l2tp = (pppol2tp_pcb*)arg; + err_t err; + u32_t retry_wait; + + PPPDEBUG(LOG_DEBUG, ("pppol2tp: timeout\n")); + + switch (l2tp->phase) { + case PPPOL2TP_STATE_SCCRQ_SENT: + /* backoff wait */ + if (l2tp->sccrq_retried < 0xff) { + l2tp->sccrq_retried++; + } + if (!l2tp->ppp->settings.persist && l2tp->sccrq_retried >= PPPOL2TP_MAXSCCRQ) { + pppol2tp_abort_connect(l2tp); + return; + } + retry_wait = LWIP_MIN(PPPOL2TP_CONTROL_TIMEOUT * l2tp->sccrq_retried, PPPOL2TP_SLOW_RETRY); + PPPDEBUG(LOG_DEBUG, ("pppol2tp: sccrq_retried=%d\n", l2tp->sccrq_retried)); + if ((err = pppol2tp_send_sccrq(l2tp)) != 0) { + l2tp->sccrq_retried--; + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send SCCRQ, error=%d\n", err)); + } + sys_timeout(retry_wait, pppol2tp_timeout, l2tp); + break; + + case PPPOL2TP_STATE_ICRQ_SENT: + l2tp->icrq_retried++; + if (l2tp->icrq_retried >= PPPOL2TP_MAXICRQ) { + pppol2tp_abort_connect(l2tp); + return; + } + PPPDEBUG(LOG_DEBUG, ("pppol2tp: icrq_retried=%d\n", l2tp->icrq_retried)); + if (l2tp->peer_nr <= l2tp->our_ns -1) { /* the SCCCN was not acknowledged */ + if ((err = pppol2tp_send_scccn(l2tp, l2tp->our_ns -1)) != 0) { + l2tp->icrq_retried--; + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send SCCCN, error=%d\n", err)); + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + break; + } + } + if ((err = pppol2tp_send_icrq(l2tp, l2tp->our_ns)) != 0) { + l2tp->icrq_retried--; + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send ICRQ, error=%d\n", err)); + } + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + break; + + case PPPOL2TP_STATE_ICCN_SENT: + l2tp->iccn_retried++; + if (l2tp->iccn_retried >= PPPOL2TP_MAXICCN) { + pppol2tp_abort_connect(l2tp); + return; + } + PPPDEBUG(LOG_DEBUG, ("pppol2tp: iccn_retried=%d\n", l2tp->iccn_retried)); + if ((err = pppol2tp_send_iccn(l2tp, l2tp->our_ns)) != 0) { + l2tp->iccn_retried--; + PPPDEBUG(LOG_DEBUG, ("pppol2tp: failed to send ICCN, error=%d\n", err)); + } + sys_timeout(PPPOL2TP_CONTROL_TIMEOUT, pppol2tp_timeout, l2tp); + break; + + default: + return; /* all done, work in peace */ + } +} + +/* Connection attempt aborted */ +static void pppol2tp_abort_connect(pppol2tp_pcb *l2tp) { + PPPDEBUG(LOG_DEBUG, ("pppol2tp: could not establish connection\n")); + pppol2tp_clear(l2tp); + ppp_link_failed(l2tp->ppp); /* notify upper layers */ +} + +/* Reset L2TP control block to its initial state */ +static void pppol2tp_clear(pppol2tp_pcb *l2tp) { + /* stop any timer */ + sys_untimeout(pppol2tp_timeout, l2tp); + l2tp->phase = PPPOL2TP_STATE_INITIAL; + l2tp->tunnel_port = l2tp->remote_port; + l2tp->our_ns = 0; + l2tp->peer_nr = 0; + l2tp->peer_ns = 0; + l2tp->source_tunnel_id = 0; + l2tp->remote_tunnel_id = 0; + l2tp->source_session_id = 0; + l2tp->remote_session_id = 0; + /* l2tp->*_retried are cleared when used */ +} + +/* Initiate a new tunnel */ +static err_t pppol2tp_send_sccrq(pppol2tp_pcb *l2tp) { + struct pbuf *pb; + u8_t *p; + u16_t len; + + /* calculate UDP packet length */ + len = 12 +8 +8 +10 +10 +6+sizeof(PPPOL2TP_HOSTNAME)-1 +6+sizeof(PPPOL2TP_VENDORNAME)-1 +8 +8; +#if PPPOL2TP_AUTH_SUPPORT + if (l2tp->secret != NULL) { + len += 6 + sizeof(l2tp->secret_rv); + } +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(0, p); /* Tunnel Id */ + PUTSHORT(0, p); /* Session Id */ + PUTSHORT(0, p); /* NS Sequence number - to peer */ + PUTSHORT(0, p); /* NR Sequence number - expected for peer */ + + /* AVP - Message type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_MESSAGE, p); /* Attribute type: Message Type */ + PUTSHORT(PPPOL2TP_MESSAGETYPE_SCCRQ, p); /* Attribute value: Message type: SCCRQ */ + + /* AVP - L2TP Version */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_VERSION, p); /* Attribute type: Version */ + PUTSHORT(PPPOL2TP_VERSION, p); /* Attribute value: L2TP Version */ + + /* AVP - Framing capabilities */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 10, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_FRAMINGCAPABILITIES, p); /* Attribute type: Framing capabilities */ + PUTLONG(PPPOL2TP_FRAMINGCAPABILITIES, p); /* Attribute value: Framing capabilities */ + + /* AVP - Bearer capabilities */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 10, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_BEARERCAPABILITIES, p); /* Attribute type: Bearer capabilities */ + PUTLONG(PPPOL2TP_BEARERCAPABILITIES, p); /* Attribute value: Bearer capabilities */ + + /* AVP - Host name */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 6+sizeof(PPPOL2TP_HOSTNAME)-1, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_HOSTNAME, p); /* Attribute type: Hostname */ + MEMCPY(p, PPPOL2TP_HOSTNAME, sizeof(PPPOL2TP_HOSTNAME)-1); /* Attribute value: Hostname */ + INCPTR(sizeof(PPPOL2TP_HOSTNAME)-1, p); + + /* AVP - Vendor name */ + PUTSHORT(6+sizeof(PPPOL2TP_VENDORNAME)-1, p); /* len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_VENDORNAME, p); /* Attribute type: Vendor name */ + MEMCPY(p, PPPOL2TP_VENDORNAME, sizeof(PPPOL2TP_VENDORNAME)-1); /* Attribute value: Vendor name */ + INCPTR(sizeof(PPPOL2TP_VENDORNAME)-1, p); + + /* AVP - Assign tunnel ID */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_TUNNELID, p); /* Attribute type: Tunnel ID */ + PUTSHORT(l2tp->remote_tunnel_id, p); /* Attribute value: Tunnel ID */ + + /* AVP - Receive window size */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_RECEIVEWINDOWSIZE, p); /* Attribute type: Receive window size */ + PUTSHORT(PPPOL2TP_RECEIVEWINDOWSIZE, p); /* Attribute value: Receive window size */ + +#if PPPOL2TP_AUTH_SUPPORT + /* AVP - Challenge */ + if (l2tp->secret != NULL) { + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 6 + sizeof(l2tp->secret_rv), p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_CHALLENGE, p); /* Attribute type: Challenge */ + MEMCPY(p, l2tp->secret_rv, sizeof(l2tp->secret_rv)); /* Attribute value: Random vector */ + INCPTR(sizeof(l2tp->secret_rv), p); + } +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + return pppol2tp_udp_send(l2tp, pb); +} + +/* Complete tunnel establishment */ +static err_t pppol2tp_send_scccn(pppol2tp_pcb *l2tp, u16_t ns) { + struct pbuf *pb; + u8_t *p; + u16_t len; + + /* calculate UDP packet length */ + len = 12 +8; +#if PPPOL2TP_AUTH_SUPPORT + if (l2tp->send_challenge) { + len += 6 + sizeof(l2tp->challenge_hash); + } +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(0, p); /* Session Id */ + PUTSHORT(ns, p); /* NS Sequence number - to peer */ + PUTSHORT(l2tp->peer_ns+1, p); /* NR Sequence number - expected for peer */ + + /* AVP - Message type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_MESSAGE, p); /* Attribute type: Message Type */ + PUTSHORT(PPPOL2TP_MESSAGETYPE_SCCCN, p); /* Attribute value: Message type: SCCCN */ + +#if PPPOL2TP_AUTH_SUPPORT + /* AVP - Challenge response */ + if (l2tp->send_challenge) { + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 6 + sizeof(l2tp->challenge_hash), p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_CHALLENGERESPONSE, p); /* Attribute type: Challenge response */ + MEMCPY(p, l2tp->challenge_hash, sizeof(l2tp->challenge_hash)); /* Attribute value: Computed challenge */ + INCPTR(sizeof(l2tp->challenge_hash), p); + } +#endif /* PPPOL2TP_AUTH_SUPPORT */ + + return pppol2tp_udp_send(l2tp, pb); +} + +/* Initiate a new session */ +static err_t pppol2tp_send_icrq(pppol2tp_pcb *l2tp, u16_t ns) { + struct pbuf *pb; + u8_t *p; + u16_t len; + u32_t serialnumber; + + /* calculate UDP packet length */ + len = 12 +8 +8 +10; + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(0, p); /* Session Id */ + PUTSHORT(ns, p); /* NS Sequence number - to peer */ + PUTSHORT(l2tp->peer_ns+1, p); /* NR Sequence number - expected for peer */ + + /* AVP - Message type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_MESSAGE, p); /* Attribute type: Message Type */ + PUTSHORT(PPPOL2TP_MESSAGETYPE_ICRQ, p); /* Attribute value: Message type: ICRQ */ + + /* AVP - Assign session ID */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_SESSIONID, p); /* Attribute type: Session ID */ + PUTSHORT(l2tp->remote_session_id, p); /* Attribute value: Session ID */ + + /* AVP - Call Serial Number */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 10, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_CALLSERIALNUMBER, p); /* Attribute type: Serial number */ + serialnumber = magic(); + PUTLONG(serialnumber, p); /* Attribute value: Serial number */ + + return pppol2tp_udp_send(l2tp, pb); +} + +/* Complete tunnel establishment */ +static err_t pppol2tp_send_iccn(pppol2tp_pcb *l2tp, u16_t ns) { + struct pbuf *pb; + u8_t *p; + u16_t len; + + /* calculate UDP packet length */ + len = 12 +8 +10 +10; + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(l2tp->source_session_id, p); /* Session Id */ + PUTSHORT(ns, p); /* NS Sequence number - to peer */ + PUTSHORT(l2tp->peer_ns+1, p); /* NR Sequence number - expected for peer */ + + /* AVP - Message type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_MESSAGE, p); /* Attribute type: Message Type */ + PUTSHORT(PPPOL2TP_MESSAGETYPE_ICCN, p); /* Attribute value: Message type: ICCN */ + + /* AVP - Framing type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 10, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_FRAMINGTYPE, p); /* Attribute type: Framing type */ + PUTLONG(PPPOL2TP_FRAMINGTYPE, p); /* Attribute value: Framing type */ + + /* AVP - TX Connect speed */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 10, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_TXCONNECTSPEED, p); /* Attribute type: TX Connect speed */ + PUTLONG(PPPOL2TP_TXCONNECTSPEED, p); /* Attribute value: TX Connect speed */ + + return pppol2tp_udp_send(l2tp, pb); +} + +/* Send a ZLB ACK packet */ +static err_t pppol2tp_send_zlb(pppol2tp_pcb *l2tp, u16_t ns) { + struct pbuf *pb; + u8_t *p; + u16_t len; + + /* calculate UDP packet length */ + len = 12; + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(0, p); /* Session Id */ + PUTSHORT(ns, p); /* NS Sequence number - to peer */ + PUTSHORT(l2tp->peer_ns+1, p); /* NR Sequence number - expected for peer */ + + return pppol2tp_udp_send(l2tp, pb); +} + +/* Send a StopCCN packet */ +static err_t pppol2tp_send_stopccn(pppol2tp_pcb *l2tp, u16_t ns) { + struct pbuf *pb; + u8_t *p; + u16_t len; + + /* calculate UDP packet length */ + len = 12 +8 +8 +8; + + /* allocate a buffer */ + pb = pbuf_alloc(PBUF_TRANSPORT, len, PBUF_RAM); + if (pb == NULL) { + return ERR_MEM; + } + LWIP_ASSERT("pb->tot_len == pb->len", pb->tot_len == pb->len); + + p = (u8_t*)pb->payload; + /* fill in pkt */ + /* L2TP control header */ + PUTSHORT(PPPOL2TP_HEADERFLAG_CONTROL_MANDATORY, p); + PUTSHORT(len, p); /* Length */ + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(0, p); /* Session Id */ + PUTSHORT(ns, p); /* NS Sequence number - to peer */ + PUTSHORT(l2tp->peer_ns+1, p); /* NR Sequence number - expected for peer */ + + /* AVP - Message type */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_MESSAGE, p); /* Attribute type: Message Type */ + PUTSHORT(PPPOL2TP_MESSAGETYPE_STOPCCN, p); /* Attribute value: Message type: StopCCN */ + + /* AVP - Assign tunnel ID */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_TUNNELID, p); /* Attribute type: Tunnel ID */ + PUTSHORT(l2tp->remote_tunnel_id, p); /* Attribute value: Tunnel ID */ + + /* AVP - Result code */ + PUTSHORT(PPPOL2TP_AVPHEADERFLAG_MANDATORY + 8, p); /* Mandatory flag + len field */ + PUTSHORT(0, p); /* Vendor ID */ + PUTSHORT(PPPOL2TP_AVPTYPE_RESULTCODE, p); /* Attribute type: Result code */ + PUTSHORT(PPPOL2TP_RESULTCODE, p); /* Attribute value: Result code */ + + return pppol2tp_udp_send(l2tp, pb); +} + +static err_t pppol2tp_xmit(pppol2tp_pcb *l2tp, struct pbuf *pb) { + u8_t *p; + + /* are we ready to process data yet? */ + if (l2tp->phase < PPPOL2TP_STATE_DATA) { + pbuf_free(pb); + return ERR_CONN; + } + + /* make room for L2TP header - should not fail */ + if (pbuf_header(pb, (s16_t)PPPOL2TP_OUTPUT_DATA_HEADER_LEN) != 0) { + /* bail out */ + PPPDEBUG(LOG_ERR, ("pppol2tp: pppol2tp_pcb: could not allocate room for L2TP header\n")); + LINK_STATS_INC(link.lenerr); + pbuf_free(pb); + return ERR_BUF; + } + + p = (u8_t*)pb->payload; + PUTSHORT(PPPOL2TP_HEADERFLAG_DATA_MANDATORY, p); + PUTSHORT(l2tp->source_tunnel_id, p); /* Tunnel Id */ + PUTSHORT(l2tp->source_session_id, p); /* Session Id */ + + return pppol2tp_udp_send(l2tp, pb); +} + +static err_t pppol2tp_udp_send(pppol2tp_pcb *l2tp, struct pbuf *pb) { + err_t err; + if (l2tp->netif) { + err = udp_sendto_if(l2tp->udp, pb, &l2tp->remote_ip, l2tp->tunnel_port, l2tp->netif); + } else { + err = udp_sendto(l2tp->udp, pb, &l2tp->remote_ip, l2tp->tunnel_port); + } + pbuf_free(pb); + return err; +} + +#endif /* PPP_SUPPORT && PPPOL2TP_SUPPORT */ diff --git a/components/lwip/netif/ppp/pppos.c b/components/lwip/netif/ppp/pppos.c new file mode 100755 index 000000000..b24e7fa67 --- /dev/null +++ b/components/lwip/netif/ppp/pppos.c @@ -0,0 +1,899 @@ +/** + * @file + * Network Point to Point Protocol over Serial file. + * + */ + +/* + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PPPOS_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#include + +#include "lwip/err.h" +#include "lwip/pbuf.h" +#include "lwip/sys.h" +#include "lwip/memp.h" +#include "lwip/netif.h" +#include "lwip/snmp.h" +#include "lwip/priv/tcpip_priv.h" +#include "lwip/api.h" +#include "lwip/ip4.h" /* for ip4_input() */ + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/pppos.h" +#include "netif/ppp/vj.h" + +/* callbacks called from PPP core */ +static err_t pppos_write(ppp_pcb *ppp, void *ctx, struct pbuf *p); +static err_t pppos_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *pb, u16_t protocol); +static err_t pppos_connect(ppp_pcb *ppp, void *ctx); +#if PPP_SERVER +static err_t pppos_listen(ppp_pcb *ppp, void *ctx, struct ppp_addrs *addrs); +#endif /* PPP_SERVER */ +static void pppos_disconnect(ppp_pcb *ppp, void *ctx); +static err_t pppos_destroy(ppp_pcb *ppp, void *ctx); +static void pppos_send_config(ppp_pcb *ppp, void *ctx, u32_t accm, int pcomp, int accomp); +static void pppos_recv_config(ppp_pcb *ppp, void *ctx, u32_t accm, int pcomp, int accomp); + +/* Prototypes for procedures local to this file. */ +#if PPP_INPROC_IRQ_SAFE +static void pppos_input_callback(void *arg); +#endif /* PPP_INPROC_IRQ_SAFE */ +static void pppos_input_free_current_packet(pppos_pcb *pppos); +static void pppos_input_drop(pppos_pcb *pppos); +static err_t pppos_output_append(pppos_pcb *pppos, err_t err, struct pbuf *nb, u8_t c, u8_t accm, u16_t *fcs); +static err_t pppos_output_last(pppos_pcb *pppos, err_t err, struct pbuf *nb, u16_t *fcs); + +/* Callbacks structure for PPP core */ +static const struct link_callbacks pppos_callbacks = { + pppos_connect, +#if PPP_SERVER + pppos_listen, +#endif /* PPP_SERVER */ + pppos_disconnect, + pppos_destroy, + pppos_write, + pppos_netif_output, + pppos_send_config, + pppos_recv_config +}; + +/* PPP's Asynchronous-Control-Character-Map. The mask array is used + * to select the specific bit for a character. */ +#define ESCAPE_P(accm, c) ((accm)[(c) >> 3] & 1 << (c & 0x07)) + +#if PPP_FCS_TABLE +/* + * FCS lookup table as calculated by genfcstab. + */ +static const u16_t fcstab[256] = { + 0x0000, 0x1189, 0x2312, 0x329b, 0x4624, 0x57ad, 0x6536, 0x74bf, + 0x8c48, 0x9dc1, 0xaf5a, 0xbed3, 0xca6c, 0xdbe5, 0xe97e, 0xf8f7, + 0x1081, 0x0108, 0x3393, 0x221a, 0x56a5, 0x472c, 0x75b7, 0x643e, + 0x9cc9, 0x8d40, 0xbfdb, 0xae52, 0xdaed, 0xcb64, 0xf9ff, 0xe876, + 0x2102, 0x308b, 0x0210, 0x1399, 0x6726, 0x76af, 0x4434, 0x55bd, + 0xad4a, 0xbcc3, 0x8e58, 0x9fd1, 0xeb6e, 0xfae7, 0xc87c, 0xd9f5, + 0x3183, 0x200a, 0x1291, 0x0318, 0x77a7, 0x662e, 0x54b5, 0x453c, + 0xbdcb, 0xac42, 0x9ed9, 0x8f50, 0xfbef, 0xea66, 0xd8fd, 0xc974, + 0x4204, 0x538d, 0x6116, 0x709f, 0x0420, 0x15a9, 0x2732, 0x36bb, + 0xce4c, 0xdfc5, 0xed5e, 0xfcd7, 0x8868, 0x99e1, 0xab7a, 0xbaf3, + 0x5285, 0x430c, 0x7197, 0x601e, 0x14a1, 0x0528, 0x37b3, 0x263a, + 0xdecd, 0xcf44, 0xfddf, 0xec56, 0x98e9, 0x8960, 0xbbfb, 0xaa72, + 0x6306, 0x728f, 0x4014, 0x519d, 0x2522, 0x34ab, 0x0630, 0x17b9, + 0xef4e, 0xfec7, 0xcc5c, 0xddd5, 0xa96a, 0xb8e3, 0x8a78, 0x9bf1, + 0x7387, 0x620e, 0x5095, 0x411c, 0x35a3, 0x242a, 0x16b1, 0x0738, + 0xffcf, 0xee46, 0xdcdd, 0xcd54, 0xb9eb, 0xa862, 0x9af9, 0x8b70, + 0x8408, 0x9581, 0xa71a, 0xb693, 0xc22c, 0xd3a5, 0xe13e, 0xf0b7, + 0x0840, 0x19c9, 0x2b52, 0x3adb, 0x4e64, 0x5fed, 0x6d76, 0x7cff, + 0x9489, 0x8500, 0xb79b, 0xa612, 0xd2ad, 0xc324, 0xf1bf, 0xe036, + 0x18c1, 0x0948, 0x3bd3, 0x2a5a, 0x5ee5, 0x4f6c, 0x7df7, 0x6c7e, + 0xa50a, 0xb483, 0x8618, 0x9791, 0xe32e, 0xf2a7, 0xc03c, 0xd1b5, + 0x2942, 0x38cb, 0x0a50, 0x1bd9, 0x6f66, 0x7eef, 0x4c74, 0x5dfd, + 0xb58b, 0xa402, 0x9699, 0x8710, 0xf3af, 0xe226, 0xd0bd, 0xc134, + 0x39c3, 0x284a, 0x1ad1, 0x0b58, 0x7fe7, 0x6e6e, 0x5cf5, 0x4d7c, + 0xc60c, 0xd785, 0xe51e, 0xf497, 0x8028, 0x91a1, 0xa33a, 0xb2b3, + 0x4a44, 0x5bcd, 0x6956, 0x78df, 0x0c60, 0x1de9, 0x2f72, 0x3efb, + 0xd68d, 0xc704, 0xf59f, 0xe416, 0x90a9, 0x8120, 0xb3bb, 0xa232, + 0x5ac5, 0x4b4c, 0x79d7, 0x685e, 0x1ce1, 0x0d68, 0x3ff3, 0x2e7a, + 0xe70e, 0xf687, 0xc41c, 0xd595, 0xa12a, 0xb0a3, 0x8238, 0x93b1, + 0x6b46, 0x7acf, 0x4854, 0x59dd, 0x2d62, 0x3ceb, 0x0e70, 0x1ff9, + 0xf78f, 0xe606, 0xd49d, 0xc514, 0xb1ab, 0xa022, 0x92b9, 0x8330, + 0x7bc7, 0x6a4e, 0x58d5, 0x495c, 0x3de3, 0x2c6a, 0x1ef1, 0x0f78 +}; +#define PPP_FCS(fcs, c) (((fcs) >> 8) ^ fcstab[((fcs) ^ (c)) & 0xff]) +#else /* PPP_FCS_TABLE */ +/* The HDLC polynomial: X**0 + X**5 + X**12 + X**16 (0x8408) */ +#define PPP_FCS_POLYNOMIAL 0x8408 +static u16_t +ppp_get_fcs(u8_t byte) +{ + unsigned int octet; + int bit; + octet = byte; + for (bit = 8; bit-- > 0; ) { + octet = (octet & 0x01) ? ((octet >> 1) ^ PPP_FCS_POLYNOMIAL) : (octet >> 1); + } + return octet & 0xffff; +} +#define PPP_FCS(fcs, c) (((fcs) >> 8) ^ ppp_get_fcs(((fcs) ^ (c)) & 0xff)) +#endif /* PPP_FCS_TABLE */ + +/* + * Values for FCS calculations. + */ +#define PPP_INITFCS 0xffff /* Initial FCS value */ +#define PPP_GOODFCS 0xf0b8 /* Good final FCS value */ + +#if PPP_INPROC_IRQ_SAFE +#define PPPOS_DECL_PROTECT(lev) SYS_ARCH_DECL_PROTECT(lev) +#define PPPOS_PROTECT(lev) SYS_ARCH_PROTECT(lev) +#define PPPOS_UNPROTECT(lev) SYS_ARCH_UNPROTECT(lev) +#else +#define PPPOS_DECL_PROTECT(lev) +#define PPPOS_PROTECT(lev) +#define PPPOS_UNPROTECT(lev) +#endif /* PPP_INPROC_IRQ_SAFE */ + + +/* + * Create a new PPP connection using the given serial I/O device. + * + * Return 0 on success, an error code on failure. + */ +ppp_pcb *pppos_create(struct netif *pppif, pppos_output_cb_fn output_cb, + ppp_link_status_cb_fn link_status_cb, void *ctx_cb) +{ + pppos_pcb *pppos; + ppp_pcb *ppp; + + pppos = (pppos_pcb *)memp_malloc(MEMP_PPPOS_PCB); + if (pppos == NULL) { + return NULL; + } + + ppp = ppp_new(pppif, &pppos_callbacks, pppos, link_status_cb, ctx_cb); + if (ppp == NULL) { + memp_free(MEMP_PPPOS_PCB, pppos); + return NULL; + } + + memset(pppos, 0, sizeof(pppos_pcb)); + pppos->ppp = ppp; + pppos->output_cb = output_cb; + return ppp; +} + +/* Called by PPP core */ +static err_t +pppos_write(ppp_pcb *ppp, void *ctx, struct pbuf *p) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; + u8_t *s; + struct pbuf *nb; + u16_t n; + u16_t fcs_out; + err_t err; + LWIP_UNUSED_ARG(ppp); + + /* Grab an output buffer. */ + nb = pbuf_alloc(PBUF_RAW, 0, PBUF_POOL); + if (nb == NULL) { + PPPDEBUG(LOG_WARNING, ("pppos_write[%d]: alloc fail\n", ppp->netif->num)); + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + pbuf_free(p); + return ERR_MEM; + } + + /* If the link has been idle, we'll send a fresh flag character to + * flush any noise. */ + err = ERR_OK; + if ((sys_now() - pppos->last_xmit) >= PPP_MAXIDLEFLAG) { + err = pppos_output_append(pppos, err, nb, PPP_FLAG, 0, NULL); + } + + /* Load output buffer. */ + fcs_out = PPP_INITFCS; + s = (u8_t*)p->payload; + n = p->len; + while (n-- > 0) { + err = pppos_output_append(pppos, err, nb, *s++, 1, &fcs_out); + } + + err = pppos_output_last(pppos, err, nb, &fcs_out); + if (err == ERR_OK) { + PPPDEBUG(LOG_INFO, ("pppos_write[%d]: len=%d\n", ppp->netif->num, p->len)); + } else { + PPPDEBUG(LOG_WARNING, ("pppos_write[%d]: output failed len=%d\n", ppp->netif->num, p->len)); + } + pbuf_free(p); + return err; +} + +/* Called by PPP core */ +static err_t +pppos_netif_output(ppp_pcb *ppp, void *ctx, struct pbuf *pb, u16_t protocol) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; + struct pbuf *nb, *p; + u16_t fcs_out; + err_t err; + LWIP_UNUSED_ARG(ppp); + + /* Grab an output buffer. */ + nb = pbuf_alloc(PBUF_RAW, 0, PBUF_POOL); + if (nb == NULL) { + PPPDEBUG(LOG_WARNING, ("pppos_netif_output[%d]: alloc fail\n", ppp->netif->num)); + LINK_STATS_INC(link.memerr); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + return ERR_MEM; + } + + /* If the link has been idle, we'll send a fresh flag character to + * flush any noise. */ + err = ERR_OK; + if ((sys_now() - pppos->last_xmit) >= PPP_MAXIDLEFLAG) { + err = pppos_output_append(pppos, err, nb, PPP_FLAG, 0, NULL); + } + + fcs_out = PPP_INITFCS; + if (!pppos->accomp) { + err = pppos_output_append(pppos, err, nb, PPP_ALLSTATIONS, 1, &fcs_out); + err = pppos_output_append(pppos, err, nb, PPP_UI, 1, &fcs_out); + } + if (!pppos->pcomp || protocol > 0xFF) { + err = pppos_output_append(pppos, err, nb, (protocol >> 8) & 0xFF, 1, &fcs_out); + } + err = pppos_output_append(pppos, err, nb, protocol & 0xFF, 1, &fcs_out); + + /* Load packet. */ + for(p = pb; p; p = p->next) { + u16_t n = p->len; + u8_t *s = (u8_t*)p->payload; + + while (n-- > 0) { + err = pppos_output_append(pppos, err, nb, *s++, 1, &fcs_out); + } + } + + err = pppos_output_last(pppos, err, nb, &fcs_out); + if (err == ERR_OK) { + PPPDEBUG(LOG_INFO, ("pppos_netif_output[%d]: proto=0x%"X16_F", len = %d\n", ppp->netif->num, protocol, pb->tot_len)); + } else { + PPPDEBUG(LOG_WARNING, ("pppos_netif_output[%d]: output failed proto=0x%"X16_F", len = %d\n", ppp->netif->num, protocol, pb->tot_len)); + } + return err; +} + +static err_t +pppos_connect(ppp_pcb *ppp, void *ctx) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; + PPPOS_DECL_PROTECT(lev); + +#if PPP_INPROC_IRQ_SAFE + /* input pbuf left over from last session? */ + pppos_input_free_current_packet(pppos); +#endif /* PPP_INPROC_IRQ_SAFE */ + + ppp_clear(ppp); + /* reset PPPoS control block to its initial state */ + memset(&pppos->last_xmit, 0, sizeof(pppos_pcb) - ( (char*)&((pppos_pcb*)0)->last_xmit - (char*)0 ) ); + + /* + * Default the in and out accm so that escape and flag characters + * are always escaped. + */ + pppos->in_accm[15] = 0x60; /* no need to protect since RX is not running */ + pppos->out_accm[15] = 0x60; + PPPOS_PROTECT(lev); + pppos->open = 1; + PPPOS_UNPROTECT(lev); + + /* + * Start the connection and handle incoming events (packet or timeout). + */ + PPPDEBUG(LOG_INFO, ("pppos_connect: unit %d: connecting\n", ppp->netif->num)); + ppp_start(ppp); /* notify upper layers */ + return ERR_OK; +} + +#if PPP_SERVER +static err_t +pppos_listen(ppp_pcb *ppp, void *ctx, struct ppp_addrs *addrs) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; +#if PPP_IPV4_SUPPORT + ipcp_options *ipcp_wo; +#endif /* PPP_IPV4_SUPPORT */ + lcp_options *lcp_wo; + PPPOS_DECL_PROTECT(lev); + +#if PPP_INPROC_IRQ_SAFE + /* input pbuf left over from last session? */ + pppos_input_free_current_packet(pppos); +#endif /* PPP_INPROC_IRQ_SAFE */ + + ppp_clear(ppp); + /* reset PPPoS control block to its initial state */ + memset(&pppos->last_xmit, 0, sizeof(pppos_pcb) - ( (char*)&((pppos_pcb*)0)->last_xmit - (char*)0 ) ); + + /* Wait passively */ + lcp_wo = &ppp->lcp_wantoptions; + lcp_wo->silent = 1; + +#if PPP_AUTH_SUPPORT + if (ppp->settings.user && ppp->settings.passwd) { + ppp->settings.auth_required = 1; + } +#endif /* PPP_AUTH_SUPPORT */ + +#if PPP_IPV4_SUPPORT + ipcp_wo = &ppp->ipcp_wantoptions; + ipcp_wo->ouraddr = ip4_addr_get_u32(&addrs->our_ipaddr); + ipcp_wo->hisaddr = ip4_addr_get_u32(&addrs->his_ipaddr); +#if LWIP_DNS + ipcp_wo->dnsaddr[0] = ip4_addr_get_u32(&addrs->dns1); + ipcp_wo->dnsaddr[1] = ip4_addr_get_u32(&addrs->dns2); +#endif /* LWIP_DNS */ +#else /* PPP_IPV4_SUPPORT */ + LWIP_UNUSED_ARG(addrs); +#endif /* PPP_IPV4_SUPPORT */ + + /* + * Default the in and out accm so that escape and flag characters + * are always escaped. + */ + pppos->in_accm[15] = 0x60; /* no need to protect since RX is not running */ + pppos->out_accm[15] = 0x60; + PPPOS_PROTECT(lev); + pppos->open = 1; + PPPOS_UNPROTECT(lev); + + /* + * Wait for something to happen. + */ + PPPDEBUG(LOG_INFO, ("pppos_listen: unit %d: listening\n", ppp->netif->num)); + ppp_start(ppp); /* notify upper layers */ + return ERR_OK; +} +#endif /* PPP_SERVER */ + +static void +pppos_disconnect(ppp_pcb *ppp, void *ctx) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; + PPPOS_DECL_PROTECT(lev); + + PPPOS_PROTECT(lev); + pppos->open = 0; + PPPOS_UNPROTECT(lev); + + /* If PPP_INPROC_IRQ_SAFE is used we cannot call + * pppos_input_free_current_packet() here because + * rx IRQ might still call pppos_input(). + */ +#if !PPP_INPROC_IRQ_SAFE + /* input pbuf left ? */ + pppos_input_free_current_packet(pppos); +#endif /* !PPP_INPROC_IRQ_SAFE */ + + ppp_link_end(ppp); /* notify upper layers */ +} + +static err_t +pppos_destroy(ppp_pcb *ppp, void *ctx) +{ + pppos_pcb *pppos = (pppos_pcb *)ctx; + LWIP_UNUSED_ARG(ppp); + +#if PPP_INPROC_IRQ_SAFE + /* input pbuf left ? */ + pppos_input_free_current_packet(pppos); +#endif /* PPP_INPROC_IRQ_SAFE */ + + memp_free(MEMP_PPPOS_PCB, pppos); + return ERR_OK; +} + +#if !NO_SYS && !PPP_INPROC_IRQ_SAFE +/** Pass received raw characters to PPPoS to be decoded through lwIP TCPIP thread. + * + * @param pcb PPP descriptor index, returned by pppos_create() + * @param data received data + * @param len length of received data + */ +err_t +pppos_input_tcpip(ppp_pcb *ppp, u8_t *s, int l) +{ + struct pbuf *p; + err_t err; + + p = pbuf_alloc(PBUF_RAW, l, PBUF_POOL); + if (!p) { + return ERR_MEM; + } + pbuf_take(p, s, l); + + err = tcpip_inpkt(p, ppp_netif(ppp), pppos_input_sys); + if (err != ERR_OK) { + pbuf_free(p); + } + return err; +} + +/* called from TCPIP thread */ +err_t pppos_input_sys(struct pbuf *p, struct netif *inp) { + ppp_pcb *ppp = (ppp_pcb*)inp->state; + struct pbuf *n; + + for (n = p; n; n = n->next) { + pppos_input(ppp, (u8_t*)n->payload, n->len); + } + pbuf_free(p); + return ERR_OK; +} +#endif /* !NO_SYS && !PPP_INPROC_IRQ_SAFE */ + +/** PPPoS input helper struct, must be packed since it is stored + * to pbuf->payload, which might be unaligned. */ +#if PPP_INPROC_IRQ_SAFE +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/bpstruct.h" +#endif +PACK_STRUCT_BEGIN +struct pppos_input_header { + PACK_STRUCT_FIELD(ppp_pcb *ppp); +} PACK_STRUCT_STRUCT; +PACK_STRUCT_END +#ifdef PACK_STRUCT_USE_INCLUDES +# include "arch/epstruct.h" +#endif +#endif /* PPP_INPROC_IRQ_SAFE */ + +/** Pass received raw characters to PPPoS to be decoded. + * + * @param pcb PPP descriptor index, returned by pppos_create() + * @param data received data + * @param len length of received data + */ +void +pppos_input(ppp_pcb *ppp, u8_t *s, int l) +{ + pppos_pcb *pppos = (pppos_pcb *)ppp->link_ctx_cb; + struct pbuf *next_pbuf; + u8_t cur_char; + u8_t escaped; + PPPOS_DECL_PROTECT(lev); + + PPPOS_PROTECT(lev); + if (!pppos->open) { + PPPOS_UNPROTECT(lev); + return; + } + PPPOS_UNPROTECT(lev); + + PPPDEBUG(LOG_DEBUG, ("pppos_input[%d]: got %d bytes\n", ppp->netif->num, l)); + while (l-- > 0) { + cur_char = *s++; + + PPPOS_PROTECT(lev); + escaped = ESCAPE_P(pppos->in_accm, cur_char); + PPPOS_UNPROTECT(lev); + /* Handle special characters. */ + if (escaped) { + /* Check for escape sequences. */ + /* XXX Note that this does not handle an escaped 0x5d character which + * would appear as an escape character. Since this is an ASCII ']' + * and there is no reason that I know of to escape it, I won't complicate + * the code to handle this case. GLL */ + if (cur_char == PPP_ESCAPE) { + pppos->in_escaped = 1; + /* Check for the flag character. */ + } else if (cur_char == PPP_FLAG) { + /* If this is just an extra flag character, ignore it. */ + if (pppos->in_state <= PDADDRESS) { + /* ignore it */; + /* If we haven't received the packet header, drop what has come in. */ + } else if (pppos->in_state < PDDATA) { + PPPDEBUG(LOG_WARNING, + ("pppos_input[%d]: Dropping incomplete packet %d\n", + ppp->netif->num, pppos->in_state)); + LINK_STATS_INC(link.lenerr); + pppos_input_drop(pppos); + /* If the fcs is invalid, drop the packet. */ + } else if (pppos->in_fcs != PPP_GOODFCS) { + PPPDEBUG(LOG_INFO, + ("pppos_input[%d]: Dropping bad fcs 0x%"X16_F" proto=0x%"X16_F"\n", + ppp->netif->num, pppos->in_fcs, pppos->in_protocol)); + /* Note: If you get lots of these, check for UART frame errors or try different baud rate */ + LINK_STATS_INC(link.chkerr); + pppos_input_drop(pppos); + /* Otherwise it's a good packet so pass it on. */ + } else { + struct pbuf *inp; + /* Trim off the checksum. */ + if(pppos->in_tail->len > 2) { + pppos->in_tail->len -= 2; + + pppos->in_tail->tot_len = pppos->in_tail->len; + if (pppos->in_tail != pppos->in_head) { + pbuf_cat(pppos->in_head, pppos->in_tail); + } + } else { + pppos->in_tail->tot_len = pppos->in_tail->len; + if (pppos->in_tail != pppos->in_head) { + pbuf_cat(pppos->in_head, pppos->in_tail); + } + + pbuf_realloc(pppos->in_head, pppos->in_head->tot_len - 2); + } + + /* Dispatch the packet thereby consuming it. */ + inp = pppos->in_head; + /* Packet consumed, release our references. */ + pppos->in_head = NULL; + pppos->in_tail = NULL; +#if IP_FORWARD || LWIP_IPV6_FORWARD + /* hide the room for Ethernet forwarding header */ + pbuf_header(inp, -(s16_t)(PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN)); +#endif /* IP_FORWARD || LWIP_IPV6_FORWARD */ +#if PPP_INPROC_IRQ_SAFE + if(tcpip_callback_with_block(pppos_input_callback, inp, 0) != ERR_OK) { + PPPDEBUG(LOG_ERR, ("pppos_input[%d]: tcpip_callback() failed, dropping packet\n", ppp->netif->num)); + pbuf_free(inp); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(ppp->netif, ifindiscards); + } +#else /* PPP_INPROC_IRQ_SAFE */ + ppp_input(ppp, inp); +#endif /* PPP_INPROC_IRQ_SAFE */ + } + + /* Prepare for a new packet. */ + pppos->in_fcs = PPP_INITFCS; + pppos->in_state = PDADDRESS; + pppos->in_escaped = 0; + /* Other characters are usually control characters that may have + * been inserted by the physical layer so here we just drop them. */ + } else { + PPPDEBUG(LOG_WARNING, + ("pppos_input[%d]: Dropping ACCM char <%d>\n", ppp->netif->num, cur_char)); + } + /* Process other characters. */ + } else { + /* Unencode escaped characters. */ + if (pppos->in_escaped) { + pppos->in_escaped = 0; + cur_char ^= PPP_TRANS; + } + + /* Process character relative to current state. */ + switch(pppos->in_state) { + case PDIDLE: /* Idle state - waiting. */ + /* Drop the character if it's not 0xff + * we would have processed a flag character above. */ + if (cur_char != PPP_ALLSTATIONS) { + break; + } + /* no break */ + /* Fall through */ + + case PDSTART: /* Process start flag. */ + /* Prepare for a new packet. */ + pppos->in_fcs = PPP_INITFCS; + /* no break */ + /* Fall through */ + + case PDADDRESS: /* Process address field. */ + if (cur_char == PPP_ALLSTATIONS) { + pppos->in_state = PDCONTROL; + break; + } + /* no break */ + + /* Else assume compressed address and control fields so + * fall through to get the protocol... */ + case PDCONTROL: /* Process control field. */ + /* If we don't get a valid control code, restart. */ + if (cur_char == PPP_UI) { + pppos->in_state = PDPROTOCOL1; + break; + } + /* no break */ + +#if 0 + else { + PPPDEBUG(LOG_WARNING, + ("pppos_input[%d]: Invalid control <%d>\n", ppp->netif->num, cur_char)); + pppos->in_state = PDSTART; + } +#endif + case PDPROTOCOL1: /* Process protocol field 1. */ + /* If the lower bit is set, this is the end of the protocol + * field. */ + if (cur_char & 1) { + pppos->in_protocol = cur_char; + pppos->in_state = PDDATA; + } else { + pppos->in_protocol = (u16_t)cur_char << 8; + pppos->in_state = PDPROTOCOL2; + } + break; + case PDPROTOCOL2: /* Process protocol field 2. */ + pppos->in_protocol |= cur_char; + pppos->in_state = PDDATA; + break; + case PDDATA: /* Process data byte. */ + /* Make space to receive processed data. */ + if (pppos->in_tail == NULL || pppos->in_tail->len == PBUF_POOL_BUFSIZE) { + u16_t pbuf_alloc_len; + if (pppos->in_tail != NULL) { + pppos->in_tail->tot_len = pppos->in_tail->len; + if (pppos->in_tail != pppos->in_head) { + pbuf_cat(pppos->in_head, pppos->in_tail); + /* give up the in_tail reference now */ + pppos->in_tail = NULL; + } + } + /* If we haven't started a packet, we need a packet header. */ + pbuf_alloc_len = 0; +#if IP_FORWARD || LWIP_IPV6_FORWARD + /* If IP forwarding is enabled we are reserving PBUF_LINK_ENCAPSULATION_HLEN + * + PBUF_LINK_HLEN bytes so the packet is being allocated with enough header + * space to be forwarded (to Ethernet for example). + */ + if (pppos->in_head == NULL) { + pbuf_alloc_len = PBUF_LINK_ENCAPSULATION_HLEN + PBUF_LINK_HLEN; + } +#endif /* IP_FORWARD || LWIP_IPV6_FORWARD */ + next_pbuf = pbuf_alloc(PBUF_RAW, pbuf_alloc_len, PBUF_POOL); + if (next_pbuf == NULL) { + /* No free buffers. Drop the input packet and let the + * higher layers deal with it. Continue processing + * the received pbuf chain in case a new packet starts. */ + PPPDEBUG(LOG_ERR, ("pppos_input[%d]: NO FREE PBUFS!\n", ppp->netif->num)); + LINK_STATS_INC(link.memerr); + pppos_input_drop(pppos); + pppos->in_state = PDSTART; /* Wait for flag sequence. */ + break; + } + if (pppos->in_head == NULL) { + u8_t *payload = ((u8_t*)next_pbuf->payload) + pbuf_alloc_len; +#if PPP_INPROC_IRQ_SAFE + ((struct pppos_input_header*)payload)->ppp = ppp; + payload += sizeof(struct pppos_input_header); + next_pbuf->len += sizeof(struct pppos_input_header); +#endif /* PPP_INPROC_IRQ_SAFE */ + next_pbuf->len += sizeof(pppos->in_protocol); + *(payload++) = pppos->in_protocol >> 8; + *(payload) = pppos->in_protocol & 0xFF; + pppos->in_head = next_pbuf; + } + pppos->in_tail = next_pbuf; + } + /* Load character into buffer. */ + ((u8_t*)pppos->in_tail->payload)[pppos->in_tail->len++] = cur_char; + break; + default: + break; + } + + /* update the frame check sequence number. */ + pppos->in_fcs = PPP_FCS(pppos->in_fcs, cur_char); + } + } /* while (l-- > 0), all bytes processed */ +} + +#if PPP_INPROC_IRQ_SAFE +/* PPPoS input callback using one input pointer + */ +static void pppos_input_callback(void *arg) { + struct pbuf *pb = (struct pbuf*)arg; + ppp_pcb *ppp; + + ppp = ((struct pppos_input_header*)pb->payload)->ppp; + if(pbuf_header(pb, -(s16_t)sizeof(struct pppos_input_header))) { + LWIP_ASSERT("pbuf_header failed\n", 0); + goto drop; + } + + /* Dispatch the packet thereby consuming it. */ + ppp_input(ppp, pb); + return; + +drop: + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(ppp->netif, ifindiscards); + pbuf_free(pb); +} +#endif /* PPP_INPROC_IRQ_SAFE */ + +static void +pppos_send_config(ppp_pcb *ppp, void *ctx, u32_t accm, int pcomp, int accomp) +{ + int i; + pppos_pcb *pppos = (pppos_pcb *)ctx; + LWIP_UNUSED_ARG(ppp); + + pppos->pcomp = pcomp; + pppos->accomp = accomp; + + /* Load the ACCM bits for the 32 control codes. */ + for (i = 0; i < 32/8; i++) { + pppos->out_accm[i] = (u8_t)((accm >> (8 * i)) & 0xFF); + } + + PPPDEBUG(LOG_INFO, ("pppos_send_config[%d]: out_accm=%X %X %X %X\n", + pppos->ppp->netif->num, + pppos->out_accm[0], pppos->out_accm[1], pppos->out_accm[2], pppos->out_accm[3])); +} + +static void +pppos_recv_config(ppp_pcb *ppp, void *ctx, u32_t accm, int pcomp, int accomp) +{ + int i; + pppos_pcb *pppos = (pppos_pcb *)ctx; + PPPOS_DECL_PROTECT(lev); + LWIP_UNUSED_ARG(ppp); + LWIP_UNUSED_ARG(pcomp); + LWIP_UNUSED_ARG(accomp); + + /* Load the ACCM bits for the 32 control codes. */ + PPPOS_PROTECT(lev); + for (i = 0; i < 32 / 8; i++) { + pppos->in_accm[i] = (u8_t)(accm >> (i * 8)); + } + PPPOS_UNPROTECT(lev); + + PPPDEBUG(LOG_INFO, ("pppos_recv_config[%d]: in_accm=%X %X %X %X\n", + pppos->ppp->netif->num, + pppos->in_accm[0], pppos->in_accm[1], pppos->in_accm[2], pppos->in_accm[3])); +} + +/* + * Drop the input packet. + */ +static void +pppos_input_free_current_packet(pppos_pcb *pppos) +{ + if (pppos->in_head != NULL) { + if (pppos->in_tail && (pppos->in_tail != pppos->in_head)) { + pbuf_free(pppos->in_tail); + } + pbuf_free(pppos->in_head); + pppos->in_head = NULL; + } + pppos->in_tail = NULL; +} + +/* + * Drop the input packet and increase error counters. + */ +static void +pppos_input_drop(pppos_pcb *pppos) +{ + if (pppos->in_head != NULL) { +#if 0 + PPPDEBUG(LOG_INFO, ("pppos_input_drop: %d:%.*H\n", pppos->in_head->len, min(60, pppos->in_head->len * 2), pppos->in_head->payload)); +#endif + PPPDEBUG(LOG_INFO, ("pppos_input_drop: pbuf len=%d, addr %p\n", pppos->in_head->len, (void*)pppos->in_head)); + } + pppos_input_free_current_packet(pppos); +#if VJ_SUPPORT && LWIP_TCP + vj_uncompress_err(&pppos->ppp->vj_comp); +#endif /* VJ_SUPPORT && LWIP_TCP */ + + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(pppos->ppp->netif, ifindiscards); +} + +/* + * pppos_output_append - append given character to end of given pbuf. + * If out_accm is not 0 and the character needs to be escaped, do so. + * If pbuf is full, send the pbuf and reuse it. + * Return the current pbuf. + */ +static err_t +pppos_output_append(pppos_pcb *pppos, err_t err, struct pbuf *nb, u8_t c, u8_t accm, u16_t *fcs) +{ + if (err != ERR_OK) { + return err; + } + + /* Make sure there is room for the character and an escape code. + * Sure we don't quite fill the buffer if the character doesn't + * get escaped but is one character worth complicating this? */ + if ((PBUF_POOL_BUFSIZE - nb->len) < 2) { + u32_t l = pppos->output_cb(pppos->ppp, (u8_t*)nb->payload, nb->len, pppos->ppp->ctx_cb); + if (l != nb->len) { + return ERR_IF; + } + nb->len = 0; + } + + /* Update FCS before checking for special characters. */ + if (fcs) { + *fcs = PPP_FCS(*fcs, c); + } + + /* Copy to output buffer escaping special characters. */ + if (accm && ESCAPE_P(pppos->out_accm, c)) { + *((u8_t*)nb->payload + nb->len++) = PPP_ESCAPE; + *((u8_t*)nb->payload + nb->len++) = c ^ PPP_TRANS; + } else { + *((u8_t*)nb->payload + nb->len++) = c; + } + + return ERR_OK; +} + +static err_t +pppos_output_last(pppos_pcb *pppos, err_t err, struct pbuf *nb, u16_t *fcs) +{ + ppp_pcb *ppp = pppos->ppp; + + /* Add FCS and trailing flag. */ + err = pppos_output_append(pppos, err, nb, ~(*fcs) & 0xFF, 1, NULL); + err = pppos_output_append(pppos, err, nb, (~(*fcs) >> 8) & 0xFF, 1, NULL); + err = pppos_output_append(pppos, err, nb, PPP_FLAG, 0, NULL); + + if (err != ERR_OK) { + goto failed; + } + + /* Send remaining buffer if not empty */ + if (nb->len > 0) { + u32_t l = pppos->output_cb(ppp, (u8_t*)nb->payload, nb->len, ppp->ctx_cb); + if (l != nb->len) { + err = ERR_IF; + goto failed; + } + } + + pppos->last_xmit = sys_now(); + MIB2_STATS_NETIF_ADD(ppp->netif, ifoutoctets, nb->tot_len); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutucastpkts); + LINK_STATS_INC(link.xmit); + pbuf_free(nb); + return ERR_OK; + +failed: + pppos->last_xmit = 0; /* prepend PPP_FLAG to next packet */ + LINK_STATS_INC(link.err); + LINK_STATS_INC(link.drop); + MIB2_STATS_NETIF_INC(ppp->netif, ifoutdiscards); + pbuf_free(nb); + return err; +} + +#endif /* PPP_SUPPORT && PPPOS_SUPPORT */ diff --git a/components/lwip/netif/ppp/upap.c b/components/lwip/netif/ppp/upap.c new file mode 100755 index 000000000..470303a21 --- /dev/null +++ b/components/lwip/netif/ppp/upap.c @@ -0,0 +1,677 @@ +/* + * upap.c - User/Password Authentication Protocol. + * + * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. The name "Carnegie Mellon University" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For permission or any legal + * details, please contact + * Office of Technology Transfer + * Carnegie Mellon University + * 5000 Forbes Avenue + * Pittsburgh, PA 15213-3890 + * (412) 268-4387, fax: (412) 268-7395 + * tech-transfer@andrew.cmu.edu + * + * 4. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Computing Services + * at Carnegie Mellon University (http://www.cmu.edu/computing/)." + * + * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE + * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && PAP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +/* + * TODO: + */ + +#if 0 /* UNUSED */ +#include +#include +#endif /* UNUSED */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/upap.h" + +#if PPP_OPTIONS +/* + * Command-line options. + */ +static option_t pap_option_list[] = { + { "hide-password", o_bool, &hide_password, + "Don't output passwords to log", OPT_PRIO | 1 }, + { "show-password", o_bool, &hide_password, + "Show password string in debug log messages", OPT_PRIOSUB | 0 }, + + { "pap-restart", o_int, &upap[0].us_timeouttime, + "Set retransmit timeout for PAP", OPT_PRIO }, + { "pap-max-authreq", o_int, &upap[0].us_maxtransmits, + "Set max number of transmissions for auth-reqs", OPT_PRIO }, + { "pap-timeout", o_int, &upap[0].us_reqtimeout, + "Set time limit for peer PAP authentication", OPT_PRIO }, + + { NULL } +}; +#endif /* PPP_OPTIONS */ + +/* + * Protocol entry points. + */ +static void upap_init(ppp_pcb *pcb); +static void upap_lowerup(ppp_pcb *pcb); +static void upap_lowerdown(ppp_pcb *pcb); +static void upap_input(ppp_pcb *pcb, u_char *inpacket, int l); +static void upap_protrej(ppp_pcb *pcb); +#if PRINTPKT_SUPPORT +static int upap_printpkt(const u_char *p, int plen, void (*printer) (void *, const char *, ...), void *arg); +#endif /* PRINTPKT_SUPPORT */ + +const struct protent pap_protent = { + PPP_PAP, + upap_init, + upap_input, + upap_protrej, + upap_lowerup, + upap_lowerdown, + NULL, + NULL, +#if PRINTPKT_SUPPORT + upap_printpkt, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_DATAINPUT + NULL, +#endif /* PPP_DATAINPUT */ +#if PRINTPKT_SUPPORT + "PAP", + NULL, +#endif /* PRINTPKT_SUPPORT */ +#if PPP_OPTIONS + pap_option_list, + NULL, +#endif /* PPP_OPTIONS */ +#if DEMAND_SUPPORT + NULL, + NULL +#endif /* DEMAND_SUPPORT */ +}; + +static void upap_timeout(void *arg); +#if PPP_SERVER +static void upap_reqtimeout(void *arg); +static void upap_rauthreq(ppp_pcb *pcb, u_char *inp, int id, int len); +#endif /* PPP_SERVER */ +static void upap_rauthack(ppp_pcb *pcb, u_char *inp, int id, int len); +static void upap_rauthnak(ppp_pcb *pcb, u_char *inp, int id, int len); +static void upap_sauthreq(ppp_pcb *pcb); +#if PPP_SERVER +static void upap_sresp(ppp_pcb *pcb, u_char code, u_char id, const char *msg, int msglen); +#endif /* PPP_SERVER */ + + +/* + * upap_init - Initialize a UPAP unit. + */ +static void upap_init(ppp_pcb *pcb) { + pcb->upap.us_user = NULL; + pcb->upap.us_userlen = 0; + pcb->upap.us_passwd = NULL; + pcb->upap.us_passwdlen = 0; + pcb->upap.us_clientstate = UPAPCS_INITIAL; +#if PPP_SERVER + pcb->upap.us_serverstate = UPAPSS_INITIAL; +#endif /* PPP_SERVER */ + pcb->upap.us_id = 0; +} + + +/* + * upap_authwithpeer - Authenticate us with our peer (start client). + * + * Set new state and send authenticate's. + */ +void upap_authwithpeer(ppp_pcb *pcb, const char *user, const char *password) { + + if(!user || !password) + return; + + /* Save the username and password we're given */ + pcb->upap.us_user = user; + pcb->upap.us_userlen = LWIP_MIN(strlen(user), 0xff); + pcb->upap.us_passwd = password; + pcb->upap.us_passwdlen = LWIP_MIN(strlen(password), 0xff); + pcb->upap.us_transmits = 0; + + /* Lower layer up yet? */ + if (pcb->upap.us_clientstate == UPAPCS_INITIAL || + pcb->upap.us_clientstate == UPAPCS_PENDING) { + pcb->upap.us_clientstate = UPAPCS_PENDING; + return; + } + + upap_sauthreq(pcb); /* Start protocol */ +} + +#if PPP_SERVER +/* + * upap_authpeer - Authenticate our peer (start server). + * + * Set new state. + */ +void upap_authpeer(ppp_pcb *pcb) { + + /* Lower layer up yet? */ + if (pcb->upap.us_serverstate == UPAPSS_INITIAL || + pcb->upap.us_serverstate == UPAPSS_PENDING) { + pcb->upap.us_serverstate = UPAPSS_PENDING; + return; + } + + pcb->upap.us_serverstate = UPAPSS_LISTEN; + if (pcb->settings.pap_req_timeout > 0) + TIMEOUT(upap_reqtimeout, pcb, pcb->settings.pap_req_timeout); +} +#endif /* PPP_SERVER */ + +/* + * upap_timeout - Retransmission timer for sending auth-reqs expired. + */ +static void upap_timeout(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (pcb->upap.us_clientstate != UPAPCS_AUTHREQ) + return; + + if (pcb->upap.us_transmits >= pcb->settings.pap_max_transmits) { + /* give up in disgust */ + ppp_error("No response to PAP authenticate-requests"); + pcb->upap.us_clientstate = UPAPCS_BADAUTH; + auth_withpeer_fail(pcb, PPP_PAP); + return; + } + + upap_sauthreq(pcb); /* Send Authenticate-Request */ +} + + +#if PPP_SERVER +/* + * upap_reqtimeout - Give up waiting for the peer to send an auth-req. + */ +static void upap_reqtimeout(void *arg) { + ppp_pcb *pcb = (ppp_pcb*)arg; + + if (pcb->upap.us_serverstate != UPAPSS_LISTEN) + return; /* huh?? */ + + auth_peer_fail(pcb, PPP_PAP); + pcb->upap.us_serverstate = UPAPSS_BADAUTH; +} +#endif /* PPP_SERVER */ + + +/* + * upap_lowerup - The lower layer is up. + * + * Start authenticating if pending. + */ +static void upap_lowerup(ppp_pcb *pcb) { + + if (pcb->upap.us_clientstate == UPAPCS_INITIAL) + pcb->upap.us_clientstate = UPAPCS_CLOSED; + else if (pcb->upap.us_clientstate == UPAPCS_PENDING) { + upap_sauthreq(pcb); /* send an auth-request */ + } + +#if PPP_SERVER + if (pcb->upap.us_serverstate == UPAPSS_INITIAL) + pcb->upap.us_serverstate = UPAPSS_CLOSED; + else if (pcb->upap.us_serverstate == UPAPSS_PENDING) { + pcb->upap.us_serverstate = UPAPSS_LISTEN; + if (pcb->settings.pap_req_timeout > 0) + TIMEOUT(upap_reqtimeout, pcb, pcb->settings.pap_req_timeout); + } +#endif /* PPP_SERVER */ +} + + +/* + * upap_lowerdown - The lower layer is down. + * + * Cancel all timeouts. + */ +static void upap_lowerdown(ppp_pcb *pcb) { + + if (pcb->upap.us_clientstate == UPAPCS_AUTHREQ) /* Timeout pending? */ + UNTIMEOUT(upap_timeout, pcb); /* Cancel timeout */ +#if PPP_SERVER + if (pcb->upap.us_serverstate == UPAPSS_LISTEN && pcb->settings.pap_req_timeout > 0) + UNTIMEOUT(upap_reqtimeout, pcb); +#endif /* PPP_SERVER */ + + pcb->upap.us_clientstate = UPAPCS_INITIAL; +#if PPP_SERVER + pcb->upap.us_serverstate = UPAPSS_INITIAL; +#endif /* PPP_SERVER */ +} + + +/* + * upap_protrej - Peer doesn't speak this protocol. + * + * This shouldn't happen. In any case, pretend lower layer went down. + */ +static void upap_protrej(ppp_pcb *pcb) { + + if (pcb->upap.us_clientstate == UPAPCS_AUTHREQ) { + ppp_error("PAP authentication failed due to protocol-reject"); + auth_withpeer_fail(pcb, PPP_PAP); + } +#if PPP_SERVER + if (pcb->upap.us_serverstate == UPAPSS_LISTEN) { + ppp_error("PAP authentication of peer failed (protocol-reject)"); + auth_peer_fail(pcb, PPP_PAP); + } +#endif /* PPP_SERVER */ + upap_lowerdown(pcb); +} + + +/* + * upap_input - Input UPAP packet. + */ +static void upap_input(ppp_pcb *pcb, u_char *inpacket, int l) { + u_char *inp; + u_char code, id; + int len; + + /* + * Parse header (code, id and length). + * If packet too short, drop it. + */ + inp = inpacket; + if (l < UPAP_HEADERLEN) { + UPAPDEBUG(("pap_input: rcvd short header.")); + return; + } + GETCHAR(code, inp); + GETCHAR(id, inp); + GETSHORT(len, inp); + if (len < UPAP_HEADERLEN) { + UPAPDEBUG(("pap_input: rcvd illegal length.")); + return; + } + if (len > l) { + UPAPDEBUG(("pap_input: rcvd short packet.")); + return; + } + len -= UPAP_HEADERLEN; + + /* + * Action depends on code. + */ + switch (code) { + case UPAP_AUTHREQ: +#if PPP_SERVER + upap_rauthreq(pcb, inp, id, len); +#endif /* PPP_SERVER */ + break; + + case UPAP_AUTHACK: + upap_rauthack(pcb, inp, id, len); + break; + + case UPAP_AUTHNAK: + upap_rauthnak(pcb, inp, id, len); + break; + + default: /* XXX Need code reject */ + break; + } +} + +#if PPP_SERVER +/* + * upap_rauth - Receive Authenticate. + */ +static void upap_rauthreq(ppp_pcb *pcb, u_char *inp, int id, int len) { + u_char ruserlen, rpasswdlen; + char *ruser; + char *rpasswd; + char rhostname[256]; + int retcode; + const char *msg; + int msglen; + + if (pcb->upap.us_serverstate < UPAPSS_LISTEN) + return; + + /* + * If we receive a duplicate authenticate-request, we are + * supposed to return the same status as for the first request. + */ + if (pcb->upap.us_serverstate == UPAPSS_OPEN) { + upap_sresp(pcb, UPAP_AUTHACK, id, "", 0); /* return auth-ack */ + return; + } + if (pcb->upap.us_serverstate == UPAPSS_BADAUTH) { + upap_sresp(pcb, UPAP_AUTHNAK, id, "", 0); /* return auth-nak */ + return; + } + + /* + * Parse user/passwd. + */ + if (len < 1) { + UPAPDEBUG(("pap_rauth: rcvd short packet.")); + return; + } + GETCHAR(ruserlen, inp); + len -= sizeof (u_char) + ruserlen + sizeof (u_char); + if (len < 0) { + UPAPDEBUG(("pap_rauth: rcvd short packet.")); + return; + } + ruser = (char *) inp; + INCPTR(ruserlen, inp); + GETCHAR(rpasswdlen, inp); + if (len < rpasswdlen) { + UPAPDEBUG(("pap_rauth: rcvd short packet.")); + return; + } + + rpasswd = (char *) inp; + + /* + * Check the username and password given. + */ + retcode = UPAP_AUTHNAK; + if (auth_check_passwd(pcb, ruser, ruserlen, rpasswd, rpasswdlen, &msg, &msglen)) { + retcode = UPAP_AUTHACK; + } + BZERO(rpasswd, rpasswdlen); + +#if 0 /* UNUSED */ + /* + * Check remote number authorization. A plugin may have filled in + * the remote number or added an allowed number, and rather than + * return an authenticate failure, is leaving it for us to verify. + */ + if (retcode == UPAP_AUTHACK) { + if (!auth_number()) { + /* We do not want to leak info about the pap result. */ + retcode = UPAP_AUTHNAK; /* XXX exit value will be "wrong" */ + warn("calling number %q is not authorized", remote_number); + } + } + + msglen = strlen(msg); + if (msglen > 255) + msglen = 255; +#endif /* UNUSED */ + + upap_sresp(pcb, retcode, id, msg, msglen); + + /* Null terminate and clean remote name. */ + ppp_slprintf(rhostname, sizeof(rhostname), "%.*v", ruserlen, ruser); + + if (retcode == UPAP_AUTHACK) { + pcb->upap.us_serverstate = UPAPSS_OPEN; + ppp_notice("PAP peer authentication succeeded for %q", rhostname); + auth_peer_success(pcb, PPP_PAP, 0, ruser, ruserlen); + } else { + pcb->upap.us_serverstate = UPAPSS_BADAUTH; + ppp_warn("PAP peer authentication failed for %q", rhostname); + auth_peer_fail(pcb, PPP_PAP); + } + + if (pcb->settings.pap_req_timeout > 0) + UNTIMEOUT(upap_reqtimeout, pcb); +} +#endif /* PPP_SERVER */ + +/* + * upap_rauthack - Receive Authenticate-Ack. + */ +static void upap_rauthack(ppp_pcb *pcb, u_char *inp, int id, int len) { + u_char msglen; + char *msg; + LWIP_UNUSED_ARG(id); + + if (pcb->upap.us_clientstate != UPAPCS_AUTHREQ) /* XXX */ + return; + + /* + * Parse message. + */ + if (len < 1) { + UPAPDEBUG(("pap_rauthack: ignoring missing msg-length.")); + } else { + GETCHAR(msglen, inp); + if (msglen > 0) { + len -= sizeof (u_char); + if (len < msglen) { + UPAPDEBUG(("pap_rauthack: rcvd short packet.")); + return; + } + msg = (char *) inp; + PRINTMSG(msg, msglen); + } + } + + pcb->upap.us_clientstate = UPAPCS_OPEN; + + auth_withpeer_success(pcb, PPP_PAP, 0); +} + + +/* + * upap_rauthnak - Receive Authenticate-Nak. + */ +static void upap_rauthnak(ppp_pcb *pcb, u_char *inp, int id, int len) { + u_char msglen; + char *msg; + LWIP_UNUSED_ARG(id); + + if (pcb->upap.us_clientstate != UPAPCS_AUTHREQ) /* XXX */ + return; + + /* + * Parse message. + */ + if (len < 1) { + UPAPDEBUG(("pap_rauthnak: ignoring missing msg-length.")); + } else { + GETCHAR(msglen, inp); + if (msglen > 0) { + len -= sizeof (u_char); + if (len < msglen) { + UPAPDEBUG(("pap_rauthnak: rcvd short packet.")); + return; + } + msg = (char *) inp; + PRINTMSG(msg, msglen); + } + } + + pcb->upap.us_clientstate = UPAPCS_BADAUTH; + + ppp_error("PAP authentication failed"); + auth_withpeer_fail(pcb, PPP_PAP); +} + + +/* + * upap_sauthreq - Send an Authenticate-Request. + */ +static void upap_sauthreq(ppp_pcb *pcb) { + struct pbuf *p; + u_char *outp; + int outlen; + + outlen = UPAP_HEADERLEN + 2 * sizeof (u_char) + + pcb->upap.us_userlen + pcb->upap.us_passwdlen; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN +outlen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + MAKEHEADER(outp, PPP_PAP); + + PUTCHAR(UPAP_AUTHREQ, outp); + PUTCHAR(++pcb->upap.us_id, outp); + PUTSHORT(outlen, outp); + PUTCHAR(pcb->upap.us_userlen, outp); + MEMCPY(outp, pcb->upap.us_user, pcb->upap.us_userlen); + INCPTR(pcb->upap.us_userlen, outp); + PUTCHAR(pcb->upap.us_passwdlen, outp); + MEMCPY(outp, pcb->upap.us_passwd, pcb->upap.us_passwdlen); + + ppp_write(pcb, p); + + TIMEOUT(upap_timeout, pcb, pcb->settings.pap_timeout_time); + ++pcb->upap.us_transmits; + pcb->upap.us_clientstate = UPAPCS_AUTHREQ; +} + +#if PPP_SERVER +/* + * upap_sresp - Send a response (ack or nak). + */ +static void upap_sresp(ppp_pcb *pcb, u_char code, u_char id, const char *msg, int msglen) { + struct pbuf *p; + u_char *outp; + int outlen; + + outlen = UPAP_HEADERLEN + sizeof (u_char) + msglen; + p = pbuf_alloc(PBUF_RAW, (u16_t)(PPP_HDRLEN +outlen), PPP_CTRL_PBUF_TYPE); + if(NULL == p) + return; + if(p->tot_len != p->len) { + pbuf_free(p); + return; + } + + outp = (u_char*)p->payload; + MAKEHEADER(outp, PPP_PAP); + + PUTCHAR(code, outp); + PUTCHAR(id, outp); + PUTSHORT(outlen, outp); + PUTCHAR(msglen, outp); + MEMCPY(outp, msg, msglen); + + ppp_write(pcb, p); +} +#endif /* PPP_SERVER */ + +#if PRINTPKT_SUPPORT +/* + * upap_printpkt - print the contents of a PAP packet. + */ +static const char* const upap_codenames[] = { + "AuthReq", "AuthAck", "AuthNak" +}; + +static int upap_printpkt(const u_char *p, int plen, void (*printer) (void *, const char *, ...), void *arg) { + int code, id, len; + int mlen, ulen, wlen; + const u_char *user, *pwd, *msg; + const u_char *pstart; + + if (plen < UPAP_HEADERLEN) + return 0; + pstart = p; + GETCHAR(code, p); + GETCHAR(id, p); + GETSHORT(len, p); + if (len < UPAP_HEADERLEN || len > plen) + return 0; + + if (code >= 1 && code <= (int)sizeof(upap_codenames) / (int)sizeof(char *)) + printer(arg, " %s", upap_codenames[code-1]); + else + printer(arg, " code=0x%x", code); + printer(arg, " id=0x%x", id); + len -= UPAP_HEADERLEN; + switch (code) { + case UPAP_AUTHREQ: + if (len < 1) + break; + ulen = p[0]; + if (len < ulen + 2) + break; + wlen = p[ulen + 1]; + if (len < ulen + wlen + 2) + break; + user = (const u_char *) (p + 1); + pwd = (const u_char *) (p + ulen + 2); + p += ulen + wlen + 2; + len -= ulen + wlen + 2; + printer(arg, " user="); + ppp_print_string(user, ulen, printer, arg); + printer(arg, " password="); +/* FIXME: require ppp_pcb struct as printpkt() argument */ +#if 0 + if (!pcb->settings.hide_password) +#endif + ppp_print_string(pwd, wlen, printer, arg); +#if 0 + else + printer(arg, ""); +#endif + break; + case UPAP_AUTHACK: + case UPAP_AUTHNAK: + if (len < 1) + break; + mlen = p[0]; + if (len < mlen + 1) + break; + msg = (const u_char *) (p + 1); + p += mlen + 1; + len -= mlen + 1; + printer(arg, " "); + ppp_print_string(msg, mlen, printer, arg); + break; + default: + break; + } + + /* print the rest of the bytes in the packet */ + for (; len > 0; --len) { + GETCHAR(code, p); + printer(arg, " %.2x", code); + } + + return p - pstart; +} +#endif /* PRINTPKT_SUPPORT */ + +#endif /* PPP_SUPPORT && PAP_SUPPORT */ diff --git a/components/lwip/netif/ppp/utils.c b/components/lwip/netif/ppp/utils.c new file mode 100755 index 000000000..c1d797ae7 --- /dev/null +++ b/components/lwip/netif/ppp/utils.c @@ -0,0 +1,961 @@ +/* + * utils.c - various utility functions used in pppd. + * + * Copyright (c) 1999-2002 Paul Mackerras. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. The name(s) of the authors of this software must not be used to + * endorse or promote products derived from this software without + * prior written permission. + * + * 3. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by Paul Mackerras + * ". + * + * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO + * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY + * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY + * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING + * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ + +#if 0 /* UNUSED */ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#ifdef SVR4 +#include +#endif +#endif /* UNUSED */ + +#include /* isdigit() */ + +#include "netif/ppp/ppp_impl.h" + +#include "netif/ppp/fsm.h" +#include "netif/ppp/lcp.h" + +#if defined(SUNOS4) +extern char *strerror(); +#endif + +static void ppp_logit(int level, const char *fmt, va_list args); +static void ppp_log_write(int level, char *buf); +#if PRINTPKT_SUPPORT +static void ppp_vslp_printer(void *arg, const char *fmt, ...); +static void ppp_format_packet(const u_char *p, int len, + void (*printer) (void *, const char *, ...), void *arg); + +struct buffer_info { + char *ptr; + int len; +}; +#endif /* PRINTPKT_SUPPORT */ + +/* + * ppp_strlcpy - like strcpy/strncpy, doesn't overflow destination buffer, + * always leaves destination null-terminated (for len > 0). + */ +size_t ppp_strlcpy(char *dest, const char *src, size_t len) { + size_t ret = strlen(src); + + if (len != 0) { + if (ret < len) + strcpy(dest, src); + else { + strncpy(dest, src, len - 1); + dest[len-1] = 0; + } + } + return ret; +} + +/* + * ppp_strlcat - like strcat/strncat, doesn't overflow destination buffer, + * always leaves destination null-terminated (for len > 0). + */ +size_t ppp_strlcat(char *dest, const char *src, size_t len) { + size_t dlen = strlen(dest); + + return dlen + ppp_strlcpy(dest + dlen, src, (len > dlen? len - dlen: 0)); +} + + +/* + * ppp_slprintf - format a message into a buffer. Like sprintf except we + * also specify the length of the output buffer, and we handle + * %m (error message), %v (visible string), + * %q (quoted string), %t (current time) and %I (IP address) formats. + * Doesn't do floating-point formats. + * Returns the number of chars put into buf. + */ +int ppp_slprintf(char *buf, int buflen, const char *fmt, ...) { + va_list args; + int n; + + va_start(args, fmt); + n = ppp_vslprintf(buf, buflen, fmt, args); + va_end(args); + return n; +} + +/* + * ppp_vslprintf - like ppp_slprintf, takes a va_list instead of a list of args. + */ +#define OUTCHAR(c) (buflen > 0? (--buflen, *buf++ = (c)): 0) + +int ppp_vslprintf(char *buf, int buflen, const char *fmt, va_list args) { + int c, i, n; + int width, prec, fillch; + int base, len, neg, quoted; + unsigned long val = 0; + const char *f; + char *str, *buf0; + const unsigned char *p; + char num[32]; +#if 0 /* need port */ + time_t t; +#endif /* need port */ + u32_t ip; + static char hexchars[] = "0123456789abcdef"; +#if PRINTPKT_SUPPORT + struct buffer_info bufinfo; +#endif /* PRINTPKT_SUPPORT */ + + buf0 = buf; + --buflen; + while (buflen > 0) { + for (f = fmt; *f != '%' && *f != 0; ++f) + ; + if (f > fmt) { + len = f - fmt; + if (len > buflen) + len = buflen; + memcpy(buf, fmt, len); + buf += len; + buflen -= len; + fmt = f; + } + if (*fmt == 0) + break; + c = *++fmt; + width = 0; + prec = -1; + fillch = ' '; + if (c == '0') { + fillch = '0'; + c = *++fmt; + } + if (c == '*') { + width = va_arg(args, int); + c = *++fmt; + } else { + while (isdigit(c)) { + width = width * 10 + c - '0'; + c = *++fmt; + } + } + if (c == '.') { + c = *++fmt; + if (c == '*') { + prec = va_arg(args, int); + c = *++fmt; + } else { + prec = 0; + while (isdigit(c)) { + prec = prec * 10 + c - '0'; + c = *++fmt; + } + } + } + str = 0; + base = 0; + neg = 0; + ++fmt; + switch (c) { + case 'l': + c = *fmt++; + switch (c) { + case 'd': + val = va_arg(args, long); + if ((long)val < 0) { + neg = 1; + val = (unsigned long)-(long)val; + } + base = 10; + break; + case 'u': + val = va_arg(args, unsigned long); + base = 10; + break; + default: + OUTCHAR('%'); + OUTCHAR('l'); + --fmt; /* so %lz outputs %lz etc. */ + continue; + } + break; + case 'd': + i = va_arg(args, int); + if (i < 0) { + neg = 1; + val = -i; + } else + val = i; + base = 10; + break; + case 'u': + val = va_arg(args, unsigned int); + base = 10; + break; + case 'o': + val = va_arg(args, unsigned int); + base = 8; + break; + case 'x': + case 'X': + val = va_arg(args, unsigned int); + base = 16; + break; + case 'p': + val = (unsigned long) va_arg(args, void *); + base = 16; + neg = 2; + break; + case 's': + str = va_arg(args, char *); + break; + case 'c': + num[0] = va_arg(args, int); + num[1] = 0; + str = num; + break; +#if 0 /* do we always have strerror() in embedded ? */ + case 'm': + str = strerror(errno); + break; +#endif /* do we always have strerror() in embedded ? */ + case 'I': + ip = va_arg(args, u32_t); + ip = ntohl(ip); + ppp_slprintf(num, sizeof(num), "%d.%d.%d.%d", (ip >> 24) & 0xff, + (ip >> 16) & 0xff, (ip >> 8) & 0xff, ip & 0xff); + str = num; + break; +#if 0 /* need port */ + case 't': + time(&t); + str = ctime(&t); + str += 4; /* chop off the day name */ + str[15] = 0; /* chop off year and newline */ + break; +#endif /* need port */ + case 'v': /* "visible" string */ + case 'q': /* quoted string */ + quoted = c == 'q'; + p = va_arg(args, unsigned char *); + if (p == NULL) + p = (const unsigned char *)""; + if (fillch == '0' && prec >= 0) { + n = prec; + } else { + n = strlen((const char *)p); + if (prec >= 0 && n > prec) + n = prec; + } + while (n > 0 && buflen > 0) { + c = *p++; + --n; + if (!quoted && c >= 0x80) { + OUTCHAR('M'); + OUTCHAR('-'); + c -= 0x80; + } + if (quoted && (c == '"' || c == '\\')) + OUTCHAR('\\'); + if (c < 0x20 || (0x7f <= c && c < 0xa0)) { + if (quoted) { + OUTCHAR('\\'); + switch (c) { + case '\t': OUTCHAR('t'); break; + case '\n': OUTCHAR('n'); break; + case '\b': OUTCHAR('b'); break; + case '\f': OUTCHAR('f'); break; + default: + OUTCHAR('x'); + OUTCHAR(hexchars[c >> 4]); + OUTCHAR(hexchars[c & 0xf]); + } + } else { + if (c == '\t') + OUTCHAR(c); + else { + OUTCHAR('^'); + OUTCHAR(c ^ 0x40); + } + } + } else + OUTCHAR(c); + } + continue; +#if PRINTPKT_SUPPORT + case 'P': /* print PPP packet */ + bufinfo.ptr = buf; + bufinfo.len = buflen + 1; + p = va_arg(args, unsigned char *); + n = va_arg(args, int); + ppp_format_packet(p, n, ppp_vslp_printer, &bufinfo); + buf = bufinfo.ptr; + buflen = bufinfo.len - 1; + continue; +#endif /* PRINTPKT_SUPPORT */ + case 'B': + p = va_arg(args, unsigned char *); + for (n = prec; n > 0; --n) { + c = *p++; + if (fillch == ' ') + OUTCHAR(' '); + OUTCHAR(hexchars[(c >> 4) & 0xf]); + OUTCHAR(hexchars[c & 0xf]); + } + continue; + default: + *buf++ = '%'; + if (c != '%') + --fmt; /* so %z outputs %z etc. */ + --buflen; + continue; + } + if (base != 0) { + str = num + sizeof(num); + *--str = 0; + while (str > num + neg) { + *--str = hexchars[val % base]; + val = val / base; + if (--prec <= 0 && val == 0) + break; + } + switch (neg) { + case 1: + *--str = '-'; + break; + case 2: + *--str = 'x'; + *--str = '0'; + break; + default: + break; + } + len = num + sizeof(num) - 1 - str; + } else { + len = strlen(str); + if (prec >= 0 && len > prec) + len = prec; + } + if (width > 0) { + if (width > buflen) + width = buflen; + if ((n = width - len) > 0) { + buflen -= n; + for (; n > 0; --n) + *buf++ = fillch; + } + } + if (len > buflen) + len = buflen; + memcpy(buf, str, len); + buf += len; + buflen -= len; + } + *buf = 0; + return buf - buf0; +} + +#if PRINTPKT_SUPPORT +/* + * vslp_printer - used in processing a %P format + */ +static void ppp_vslp_printer(void *arg, const char *fmt, ...) { + int n; + va_list pvar; + struct buffer_info *bi; + + va_start(pvar, fmt); + bi = (struct buffer_info *) arg; + n = ppp_vslprintf(bi->ptr, bi->len, fmt, pvar); + va_end(pvar); + + bi->ptr += n; + bi->len -= n; +} +#endif /* PRINTPKT_SUPPORT */ + +#if 0 /* UNUSED */ +/* + * log_packet - format a packet and log it. + */ + +void +log_packet(p, len, prefix, level) + u_char *p; + int len; + char *prefix; + int level; +{ + init_pr_log(prefix, level); + ppp_format_packet(p, len, pr_log, &level); + end_pr_log(); +} +#endif /* UNUSED */ + +#if PRINTPKT_SUPPORT +/* + * ppp_format_packet - make a readable representation of a packet, + * calling `printer(arg, format, ...)' to output it. + */ +static void ppp_format_packet(const u_char *p, int len, + void (*printer) (void *, const char *, ...), void *arg) { + int i, n; + u_short proto; + const struct protent *protp; + + if (len >= 2) { + GETSHORT(proto, p); + len -= 2; + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (proto == protp->protocol) + break; + if (protp != NULL) { + printer(arg, "[%s", protp->name); + n = (*protp->printpkt)(p, len, printer, arg); + printer(arg, "]"); + p += n; + len -= n; + } else { + for (i = 0; (protp = protocols[i]) != NULL; ++i) + if (proto == (protp->protocol & ~0x8000)) + break; + if (protp != 0 && protp->data_name != 0) { + printer(arg, "[%s data]", protp->data_name); + if (len > 8) + printer(arg, "%.8B ...", p); + else + printer(arg, "%.*B", len, p); + len = 0; + } else + printer(arg, "[proto=0x%x]", proto); + } + } + + if (len > 32) + printer(arg, "%.32B ...", p); + else + printer(arg, "%.*B", len, p); +} +#endif /* PRINTPKT_SUPPORT */ + +#if 0 /* UNUSED */ +/* + * init_pr_log, end_pr_log - initialize and finish use of pr_log. + */ + +static char line[256]; /* line to be logged accumulated here */ +static char *linep; /* current pointer within line */ +static int llevel; /* level for logging */ + +void +init_pr_log(prefix, level) + const char *prefix; + int level; +{ + linep = line; + if (prefix != NULL) { + ppp_strlcpy(line, prefix, sizeof(line)); + linep = line + strlen(line); + } + llevel = level; +} + +void +end_pr_log() +{ + if (linep != line) { + *linep = 0; + ppp_log_write(llevel, line); + } +} + +/* + * pr_log - printer routine for outputting to log + */ +void +pr_log (void *arg, const char *fmt, ...) +{ + int l, n; + va_list pvar; + char *p, *eol; + char buf[256]; + + va_start(pvar, fmt); + n = ppp_vslprintf(buf, sizeof(buf), fmt, pvar); + va_end(pvar); + + p = buf; + eol = strchr(buf, '\n'); + if (linep != line) { + l = (eol == NULL)? n: eol - buf; + if (linep + l < line + sizeof(line)) { + if (l > 0) { + memcpy(linep, buf, l); + linep += l; + } + if (eol == NULL) + return; + p = eol + 1; + eol = strchr(p, '\n'); + } + *linep = 0; + ppp_log_write(llevel, line); + linep = line; + } + + while (eol != NULL) { + *eol = 0; + ppp_log_write(llevel, p); + p = eol + 1; + eol = strchr(p, '\n'); + } + + /* assumes sizeof(buf) <= sizeof(line) */ + l = buf + n - p; + if (l > 0) { + memcpy(line, p, n); + linep = line + l; + } +} +#endif /* UNUSED */ + +/* + * ppp_print_string - print a readable representation of a string using + * printer. + */ +void ppp_print_string(const u_char *p, int len, void (*printer) (void *, const char *, ...), void *arg) { + int c; + + printer(arg, "\""); + for (; len > 0; --len) { + c = *p++; + if (' ' <= c && c <= '~') { + if (c == '\\' || c == '"') + printer(arg, "\\"); + printer(arg, "%c", c); + } else { + switch (c) { + case '\n': + printer(arg, "\\n"); + break; + case '\r': + printer(arg, "\\r"); + break; + case '\t': + printer(arg, "\\t"); + break; + default: + printer(arg, "\\%.3o", c); + /* no break */ + } + } + } + printer(arg, "\""); +} + +/* + * ppp_logit - does the hard work for fatal et al. + */ +static void ppp_logit(int level, const char *fmt, va_list args) { + char buf[1024]; + + ppp_vslprintf(buf, sizeof(buf), fmt, args); + ppp_log_write(level, buf); +} + +static void ppp_log_write(int level, char *buf) { + LWIP_UNUSED_ARG(level); /* necessary if PPPDEBUG is defined to an empty function */ + LWIP_UNUSED_ARG(buf); + PPPDEBUG(level, ("%s\n", buf) ); +#if 0 + if (log_to_fd >= 0 && (level != LOG_DEBUG || debug)) { + int n = strlen(buf); + + if (n > 0 && buf[n-1] == '\n') + --n; + if (write(log_to_fd, buf, n) != n + || write(log_to_fd, "\n", 1) != 1) + log_to_fd = -1; + } +#endif +} + +/* + * ppp_fatal - log an error message and die horribly. + */ +void ppp_fatal(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_ERR, fmt, pvar); + va_end(pvar); + + LWIP_ASSERT("ppp_fatal", 0); /* as promised */ +} + +/* + * ppp_error - log an error message. + */ +void ppp_error(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_ERR, fmt, pvar); + va_end(pvar); +#if 0 /* UNUSED */ + ++error_count; +#endif /* UNUSED */ +} + +/* + * ppp_warn - log a warning message. + */ +void ppp_warn(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_WARNING, fmt, pvar); + va_end(pvar); +} + +/* + * ppp_notice - log a notice-level message. + */ +void ppp_notice(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_NOTICE, fmt, pvar); + va_end(pvar); +} + +/* + * ppp_info - log an informational message. + */ +void ppp_info(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_INFO, fmt, pvar); + va_end(pvar); +} + +/* + * ppp_dbglog - log a debug message. + */ +void ppp_dbglog(const char *fmt, ...) { + va_list pvar; + + va_start(pvar, fmt); + ppp_logit(LOG_DEBUG, fmt, pvar); + va_end(pvar); +} + +#if PRINTPKT_SUPPORT +/* + * ppp_dump_packet - print out a packet in readable form if it is interesting. + * Assumes len >= PPP_HDRLEN. + */ +void ppp_dump_packet(const char *tag, unsigned char *p, int len) { + int proto; + + /* + * don't print IPv4 and IPv6 packets. + */ + proto = (p[0] << 8) + p[1]; + if (proto == PPP_IP) + return; +#if PPP_IPV6_SUPPORT + if (proto == PPP_IPV6) + return; +#endif + + /* + * don't print LCP echo request/reply packets if the link is up. + */ + if (proto == PPP_LCP && len >= 2 + HEADERLEN) { + unsigned char *lcp = p + 2; + int l = (lcp[2] << 8) + lcp[3]; + + if ((lcp[0] == ECHOREQ || lcp[0] == ECHOREP) + && l >= HEADERLEN && l <= len - 2) + return; + } + + ppp_dbglog("%s %P", tag, p, len); +} +#endif /* PRINTPKT_SUPPORT */ + +#if 0 /* Unused */ + +/* + * complete_read - read a full `count' bytes from fd, + * unless end-of-file or an error other than EINTR is encountered. + */ +ssize_t +complete_read(int fd, void *buf, size_t count) +{ + size_t done; + ssize_t nb; + char *ptr = buf; + + for (done = 0; done < count; ) { + nb = read(fd, ptr, count - done); + if (nb < 0) { + if (errno == EINTR) + continue; + return -1; + } + if (nb == 0) + break; + done += nb; + ptr += nb; + } + return done; +} + +/* Procedures for locking the serial device using a lock file. */ +#ifndef LOCK_DIR +#ifdef __linux__ +#define LOCK_DIR "/var/lock" +#else +#ifdef SVR4 +#define LOCK_DIR "/var/spool/locks" +#else +#define LOCK_DIR "/var/spool/lock" +#endif +#endif +#endif /* LOCK_DIR */ + +static char lock_file[MAXPATHLEN]; + +/* + * lock - create a lock file for the named device + */ +int +lock(dev) + char *dev; +{ +#ifdef LOCKLIB + int result; + + result = mklock (dev, (void *) 0); + if (result == 0) { + ppp_strlcpy(lock_file, dev, sizeof(lock_file)); + return 0; + } + + if (result > 0) + ppp_notice("Device %s is locked by pid %d", dev, result); + else + ppp_error("Can't create lock file %s", lock_file); + return -1; + +#else /* LOCKLIB */ + + char lock_buffer[12]; + int fd, pid, n; + +#ifdef SVR4 + struct stat sbuf; + + if (stat(dev, &sbuf) < 0) { + ppp_error("Can't get device number for %s: %m", dev); + return -1; + } + if ((sbuf.st_mode & S_IFMT) != S_IFCHR) { + ppp_error("Can't lock %s: not a character device", dev); + return -1; + } + ppp_slprintf(lock_file, sizeof(lock_file), "%s/LK.%03d.%03d.%03d", + LOCK_DIR, major(sbuf.st_dev), + major(sbuf.st_rdev), minor(sbuf.st_rdev)); +#else + char *p; + char lockdev[MAXPATHLEN]; + + if ((p = strstr(dev, "dev/")) != NULL) { + dev = p + 4; + strncpy(lockdev, dev, MAXPATHLEN-1); + lockdev[MAXPATHLEN-1] = 0; + while ((p = strrchr(lockdev, '/')) != NULL) { + *p = '_'; + } + dev = lockdev; + } else + if ((p = strrchr(dev, '/')) != NULL) + dev = p + 1; + + ppp_slprintf(lock_file, sizeof(lock_file), "%s/LCK..%s", LOCK_DIR, dev); +#endif + + while ((fd = open(lock_file, O_EXCL | O_CREAT | O_RDWR, 0644)) < 0) { + if (errno != EEXIST) { + ppp_error("Can't create lock file %s: %m", lock_file); + break; + } + + /* Read the lock file to find out who has the device locked. */ + fd = open(lock_file, O_RDONLY, 0); + if (fd < 0) { + if (errno == ENOENT) /* This is just a timing problem. */ + continue; + ppp_error("Can't open existing lock file %s: %m", lock_file); + break; + } +#ifndef LOCK_BINARY + n = read(fd, lock_buffer, 11); +#else + n = read(fd, &pid, sizeof(pid)); +#endif /* LOCK_BINARY */ + close(fd); + fd = -1; + if (n <= 0) { + ppp_error("Can't read pid from lock file %s", lock_file); + break; + } + + /* See if the process still exists. */ +#ifndef LOCK_BINARY + lock_buffer[n] = 0; + pid = atoi(lock_buffer); +#endif /* LOCK_BINARY */ + if (pid == getpid()) + return 1; /* somebody else locked it for us */ + if (pid == 0 + || (kill(pid, 0) == -1 && errno == ESRCH)) { + if (unlink (lock_file) == 0) { + ppp_notice("Removed stale lock on %s (pid %d)", dev, pid); + continue; + } + ppp_warn("Couldn't remove stale lock on %s", dev); + } else + ppp_notice("Device %s is locked by pid %d", dev, pid); + break; + } + + if (fd < 0) { + lock_file[0] = 0; + return -1; + } + + pid = getpid(); +#ifndef LOCK_BINARY + ppp_slprintf(lock_buffer, sizeof(lock_buffer), "%10d\n", pid); + write (fd, lock_buffer, 11); +#else + write(fd, &pid, sizeof (pid)); +#endif + close(fd); + return 0; + +#endif +} + +/* + * relock - called to update our lockfile when we are about to detach, + * thus changing our pid (we fork, the child carries on, and the parent dies). + * Note that this is called by the parent, with pid equal to the pid + * of the child. This avoids a potential race which would exist if + * we had the child rewrite the lockfile (the parent might die first, + * and another process could think the lock was stale if it checked + * between when the parent died and the child rewrote the lockfile). + */ +int +relock(pid) + int pid; +{ +#ifdef LOCKLIB + /* XXX is there a way to do this? */ + return -1; +#else /* LOCKLIB */ + + int fd; + char lock_buffer[12]; + + if (lock_file[0] == 0) + return -1; + fd = open(lock_file, O_WRONLY, 0); + if (fd < 0) { + ppp_error("Couldn't reopen lock file %s: %m", lock_file); + lock_file[0] = 0; + return -1; + } + +#ifndef LOCK_BINARY + ppp_slprintf(lock_buffer, sizeof(lock_buffer), "%10d\n", pid); + write (fd, lock_buffer, 11); +#else + write(fd, &pid, sizeof(pid)); +#endif /* LOCK_BINARY */ + close(fd); + return 0; + +#endif /* LOCKLIB */ +} + +/* + * unlock - remove our lockfile + */ +void +unlock() +{ + if (lock_file[0]) { +#ifdef LOCKLIB + (void) rmlock(lock_file, (void *) 0); +#else + unlink(lock_file); +#endif + lock_file[0] = 0; + } +} + +#endif /* Unused */ + +#endif /* PPP_SUPPORT */ diff --git a/components/lwip/netif/ppp/vj.c b/components/lwip/netif/ppp/vj.c new file mode 100755 index 000000000..19d8a2f8a --- /dev/null +++ b/components/lwip/netif/ppp/vj.c @@ -0,0 +1,670 @@ +/* + * Routines to compress and uncompess tcp packets (for transmission + * over low speed serial lines. + * + * Copyright (c) 1989 Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by the University of California, Berkeley. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. + * + * Van Jacobson (van@helios.ee.lbl.gov), Dec 31, 1989: + * Initial distribution. + * + * Modified June 1993 by Paul Mackerras, paulus@cs.anu.edu.au, + * so that the entire packet being decompressed doesn't have + * to be in contiguous memory (just the compressed header). + * + * Modified March 1998 by Guy Lancaster, glanca@gesn.com, + * for a 16 bit processor. + */ + +#include "lwip/opt.h" +#if PPP_SUPPORT && VJ_SUPPORT && LWIP_TCP /* don't build if not configured for use in lwipopts.h */ + +#include "netif/ppp/ppp_impl.h" +#include "netif/ppp/pppdebug.h" + +#include "netif/ppp/vj.h" + +#include + +#if LINK_STATS +#define INCR(counter) ++comp->stats.counter +#else +#define INCR(counter) +#endif + +void +vj_compress_init(struct vjcompress *comp) +{ + u8_t i; + struct cstate *tstate = comp->tstate; + +#if MAX_SLOTS == 0 + memset((char *)comp, 0, sizeof(*comp)); +#endif + comp->maxSlotIndex = MAX_SLOTS - 1; + comp->compressSlot = 0; /* Disable slot ID compression by default. */ + for (i = MAX_SLOTS - 1; i > 0; --i) { + tstate[i].cs_id = i; + tstate[i].cs_next = &tstate[i - 1]; + } + tstate[0].cs_next = &tstate[MAX_SLOTS - 1]; + tstate[0].cs_id = 0; + comp->last_cs = &tstate[0]; + comp->last_recv = 255; + comp->last_xmit = 255; + comp->flags = VJF_TOSS; +} + + +/* ENCODE encodes a number that is known to be non-zero. ENCODEZ + * checks for zero (since zero has to be encoded in the long, 3 byte + * form). + */ +#define ENCODE(n) { \ + if ((u16_t)(n) >= 256) { \ + *cp++ = 0; \ + cp[1] = (u8_t)(n); \ + cp[0] = (u8_t)((n) >> 8); \ + cp += 2; \ + } else { \ + *cp++ = (u8_t)(n); \ + } \ +} +#define ENCODEZ(n) { \ + if ((u16_t)(n) >= 256 || (u16_t)(n) == 0) { \ + *cp++ = 0; \ + cp[1] = (u8_t)(n); \ + cp[0] = (u8_t)((n) >> 8); \ + cp += 2; \ + } else { \ + *cp++ = (u8_t)(n); \ + } \ +} + +#define DECODEL(f) { \ + if (*cp == 0) {\ + u32_t tmp_ = ntohl(f) + ((cp[1] << 8) | cp[2]); \ + (f) = htonl(tmp_); \ + cp += 3; \ + } else { \ + u32_t tmp_ = ntohl(f) + (u32_t)*cp++; \ + (f) = htonl(tmp_); \ + } \ +} + +#define DECODES(f) { \ + if (*cp == 0) {\ + u16_t tmp_ = ntohs(f) + (((u16_t)cp[1] << 8) | cp[2]); \ + (f) = htons(tmp_); \ + cp += 3; \ + } else { \ + u16_t tmp_ = ntohs(f) + (u16_t)*cp++; \ + (f) = htons(tmp_); \ + } \ +} + +#define DECODEU(f) { \ + if (*cp == 0) {\ + (f) = htons(((u16_t)cp[1] << 8) | cp[2]); \ + cp += 3; \ + } else { \ + (f) = htons((u16_t)*cp++); \ + } \ +} + +/* + * vj_compress_tcp - Attempt to do Van Jacobson header compression on a + * packet. This assumes that nb and comp are not null and that the first + * buffer of the chain contains a valid IP header. + * Return the VJ type code indicating whether or not the packet was + * compressed. + */ +u8_t +vj_compress_tcp(struct vjcompress *comp, struct pbuf **pb) +{ + struct pbuf *np = *pb; + struct ip_hdr *ip = (struct ip_hdr *)np->payload; + struct cstate *cs = comp->last_cs->cs_next; + u16_t ilen = IPH_HL(ip); + u16_t hlen; + struct tcp_hdr *oth; + struct tcp_hdr *th; + u16_t deltaS, deltaA = 0; + u32_t deltaL; + u32_t changes = 0; + u8_t new_seq[16]; + u8_t *cp = new_seq; + + /* + * Check that the packet is IP proto TCP. + */ + if (IPH_PROTO(ip) != IP_PROTO_TCP) { + return (TYPE_IP); + } + + /* + * Bail if this is an IP fragment or if the TCP packet isn't + * `compressible' (i.e., ACK isn't set or some other control bit is + * set). + */ + if ((IPH_OFFSET(ip) & PP_HTONS(0x3fff)) || np->tot_len < 40) { + return (TYPE_IP); + } + th = (struct tcp_hdr *)&((u32_t*)ip)[ilen]; + if ((TCPH_FLAGS(th) & (TCP_SYN|TCP_FIN|TCP_RST|TCP_ACK)) != TCP_ACK) { + return (TYPE_IP); + } + + /* Check that the TCP/IP headers are contained in the first buffer. */ + hlen = ilen + TCPH_HDRLEN(th); + hlen <<= 2; + if (np->len < hlen) { + PPPDEBUG(LOG_INFO, ("vj_compress_tcp: header len %d spans buffers\n", hlen)); + return (TYPE_IP); + } + + /* TCP stack requires that we don't change the packet payload, therefore we copy + * the whole packet before compression. */ + np = pbuf_alloc(PBUF_RAW, np->tot_len, PBUF_POOL); + if (!np) { + return (TYPE_IP); + } + + if (pbuf_copy(np, *pb) != ERR_OK) { + pbuf_free(np); + return (TYPE_IP); + } + + *pb = np; + ip = (struct ip_hdr *)np->payload; + + /* + * Packet is compressible -- we're going to send either a + * COMPRESSED_TCP or UNCOMPRESSED_TCP packet. Either way we need + * to locate (or create) the connection state. Special case the + * most recently used connection since it's most likely to be used + * again & we don't have to do any reordering if it's used. + */ + INCR(vjs_packets); + if (!ip4_addr_cmp(&ip->src, &cs->cs_ip.src) + || !ip4_addr_cmp(&ip->dest, &cs->cs_ip.dest) + || *(u32_t*)th != ((u32_t*)&cs->cs_ip)[IPH_HL(&cs->cs_ip)]) { + /* + * Wasn't the first -- search for it. + * + * States are kept in a circularly linked list with + * last_cs pointing to the end of the list. The + * list is kept in lru order by moving a state to the + * head of the list whenever it is referenced. Since + * the list is short and, empirically, the connection + * we want is almost always near the front, we locate + * states via linear search. If we don't find a state + * for the datagram, the oldest state is (re-)used. + */ + struct cstate *lcs; + struct cstate *lastcs = comp->last_cs; + + do { + lcs = cs; cs = cs->cs_next; + INCR(vjs_searches); + if (ip4_addr_cmp(&ip->src, &cs->cs_ip.src) + && ip4_addr_cmp(&ip->dest, &cs->cs_ip.dest) + && *(u32_t*)th == ((u32_t*)&cs->cs_ip)[IPH_HL(&cs->cs_ip)]) { + goto found; + } + } while (cs != lastcs); + + /* + * Didn't find it -- re-use oldest cstate. Send an + * uncompressed packet that tells the other side what + * connection number we're using for this conversation. + * Note that since the state list is circular, the oldest + * state points to the newest and we only need to set + * last_cs to update the lru linkage. + */ + INCR(vjs_misses); + comp->last_cs = lcs; + goto uncompressed; + + found: + /* + * Found it -- move to the front on the connection list. + */ + if (cs == lastcs) { + comp->last_cs = lcs; + } else { + lcs->cs_next = cs->cs_next; + cs->cs_next = lastcs->cs_next; + lastcs->cs_next = cs; + } + } + + oth = (struct tcp_hdr *)&((u32_t*)&cs->cs_ip)[ilen]; + deltaS = ilen; + + /* + * Make sure that only what we expect to change changed. The first + * line of the `if' checks the IP protocol version, header length & + * type of service. The 2nd line checks the "Don't fragment" bit. + * The 3rd line checks the time-to-live and protocol (the protocol + * check is unnecessary but costless). The 4th line checks the TCP + * header length. The 5th line checks IP options, if any. The 6th + * line checks TCP options, if any. If any of these things are + * different between the previous & current datagram, we send the + * current datagram `uncompressed'. + */ + if (((u16_t*)ip)[0] != ((u16_t*)&cs->cs_ip)[0] + || ((u16_t*)ip)[3] != ((u16_t*)&cs->cs_ip)[3] + || ((u16_t*)ip)[4] != ((u16_t*)&cs->cs_ip)[4] + || TCPH_HDRLEN(th) != TCPH_HDRLEN(oth) + || (deltaS > 5 && BCMP(ip + 1, &cs->cs_ip + 1, (deltaS - 5) << 2)) + || (TCPH_HDRLEN(th) > 5 && BCMP(th + 1, oth + 1, (TCPH_HDRLEN(th) - 5) << 2))) { + goto uncompressed; + } + + /* + * Figure out which of the changing fields changed. The + * receiver expects changes in the order: urgent, window, + * ack, seq (the order minimizes the number of temporaries + * needed in this section of code). + */ + if (TCPH_FLAGS(th) & TCP_URG) { + deltaS = ntohs(th->urgp); + ENCODEZ(deltaS); + changes |= NEW_U; + } else if (th->urgp != oth->urgp) { + /* argh! URG not set but urp changed -- a sensible + * implementation should never do this but RFC793 + * doesn't prohibit the change so we have to deal + * with it. */ + goto uncompressed; + } + + if ((deltaS = (u16_t)(ntohs(th->wnd) - ntohs(oth->wnd))) != 0) { + ENCODE(deltaS); + changes |= NEW_W; + } + + if ((deltaL = ntohl(th->ackno) - ntohl(oth->ackno)) != 0) { + if (deltaL > 0xffff) { + goto uncompressed; + } + deltaA = (u16_t)deltaL; + ENCODE(deltaA); + changes |= NEW_A; + } + + if ((deltaL = ntohl(th->seqno) - ntohl(oth->seqno)) != 0) { + if (deltaL > 0xffff) { + goto uncompressed; + } + deltaS = (u16_t)deltaL; + ENCODE(deltaS); + changes |= NEW_S; + } + + switch(changes) { + case 0: + /* + * Nothing changed. If this packet contains data and the + * last one didn't, this is probably a data packet following + * an ack (normal on an interactive connection) and we send + * it compressed. Otherwise it's probably a retransmit, + * retransmitted ack or window probe. Send it uncompressed + * in case the other side missed the compressed version. + */ + if (IPH_LEN(ip) != IPH_LEN(&cs->cs_ip) && + ntohs(IPH_LEN(&cs->cs_ip)) == hlen) { + break; + } + /* no break */ + /* fall through */ + + case SPECIAL_I: + case SPECIAL_D: + /* + * actual changes match one of our special case encodings -- + * send packet uncompressed. + */ + goto uncompressed; + + case NEW_S|NEW_A: + if (deltaS == deltaA && deltaS == ntohs(IPH_LEN(&cs->cs_ip)) - hlen) { + /* special case for echoed terminal traffic */ + changes = SPECIAL_I; + cp = new_seq; + } + break; + + case NEW_S: + if (deltaS == ntohs(IPH_LEN(&cs->cs_ip)) - hlen) { + /* special case for data xfer */ + changes = SPECIAL_D; + cp = new_seq; + } + break; + default: + break; + } + + deltaS = (u16_t)(ntohs(IPH_ID(ip)) - ntohs(IPH_ID(&cs->cs_ip))); + if (deltaS != 1) { + ENCODEZ(deltaS); + changes |= NEW_I; + } + if (TCPH_FLAGS(th) & TCP_PSH) { + changes |= TCP_PUSH_BIT; + } + /* + * Grab the cksum before we overwrite it below. Then update our + * state with this packet's header. + */ + deltaA = ntohs(th->chksum); + MEMCPY(&cs->cs_ip, ip, hlen); + + /* + * We want to use the original packet as our compressed packet. + * (cp - new_seq) is the number of bytes we need for compressed + * sequence numbers. In addition we need one byte for the change + * mask, one for the connection id and two for the tcp checksum. + * So, (cp - new_seq) + 4 bytes of header are needed. hlen is how + * many bytes of the original packet to toss so subtract the two to + * get the new packet size. + */ + deltaS = (u16_t)(cp - new_seq); + if (!comp->compressSlot || comp->last_xmit != cs->cs_id) { + comp->last_xmit = cs->cs_id; + hlen -= deltaS + 4; + if (pbuf_header(np, -(s16_t)hlen)){ + /* Can we cope with this failing? Just assert for now */ + LWIP_ASSERT("pbuf_header failed\n", 0); + } + cp = (u8_t*)np->payload; + *cp++ = (u8_t)(changes | NEW_C); + *cp++ = cs->cs_id; + } else { + hlen -= deltaS + 3; + if (pbuf_header(np, -(s16_t)hlen)) { + /* Can we cope with this failing? Just assert for now */ + LWIP_ASSERT("pbuf_header failed\n", 0); + } + cp = (u8_t*)np->payload; + *cp++ = (u8_t)changes; + } + *cp++ = (u8_t)(deltaA >> 8); + *cp++ = (u8_t)deltaA; + MEMCPY(cp, new_seq, deltaS); + INCR(vjs_compressed); + return (TYPE_COMPRESSED_TCP); + + /* + * Update connection state cs & send uncompressed packet (that is, + * a regular ip/tcp packet but with the 'conversation id' we hope + * to use on future compressed packets in the protocol field). + */ +uncompressed: + MEMCPY(&cs->cs_ip, ip, hlen); + IPH_PROTO_SET(ip, cs->cs_id); + comp->last_xmit = cs->cs_id; + return (TYPE_UNCOMPRESSED_TCP); +} + +/* + * Called when we may have missed a packet. + */ +void +vj_uncompress_err(struct vjcompress *comp) +{ + comp->flags |= VJF_TOSS; + INCR(vjs_errorin); +} + +/* + * "Uncompress" a packet of type TYPE_UNCOMPRESSED_TCP. + * Return 0 on success, -1 on failure. + */ +int +vj_uncompress_uncomp(struct pbuf *nb, struct vjcompress *comp) +{ + u32_t hlen; + struct cstate *cs; + struct ip_hdr *ip; + + ip = (struct ip_hdr *)nb->payload; + hlen = IPH_HL(ip) << 2; + if (IPH_PROTO(ip) >= MAX_SLOTS + || hlen + sizeof(struct tcp_hdr) > nb->len + || (hlen += TCPH_HDRLEN(((struct tcp_hdr *)&((char *)ip)[hlen])) << 2) + > nb->len + || hlen > MAX_HDR) { + PPPDEBUG(LOG_INFO, ("vj_uncompress_uncomp: bad cid=%d, hlen=%d buflen=%d\n", + IPH_PROTO(ip), hlen, nb->len)); + comp->flags |= VJF_TOSS; + INCR(vjs_errorin); + return -1; + } + cs = &comp->rstate[comp->last_recv = IPH_PROTO(ip)]; + comp->flags &=~ VJF_TOSS; + IPH_PROTO_SET(ip, IP_PROTO_TCP); + MEMCPY(&cs->cs_ip, ip, hlen); + cs->cs_hlen = (u16_t)hlen; + INCR(vjs_uncompressedin); + return 0; +} + +/* + * Uncompress a packet of type TYPE_COMPRESSED_TCP. + * The packet is composed of a buffer chain and the first buffer + * must contain an accurate chain length. + * The first buffer must include the entire compressed TCP/IP header. + * This procedure replaces the compressed header with the uncompressed + * header and returns the length of the VJ header. + */ +int +vj_uncompress_tcp(struct pbuf **nb, struct vjcompress *comp) +{ + u8_t *cp; + struct tcp_hdr *th; + struct cstate *cs; + u16_t *bp; + struct pbuf *n0 = *nb; + u32_t tmp; + u32_t vjlen, hlen, changes; + + INCR(vjs_compressedin); + cp = (u8_t*)n0->payload; + changes = *cp++; + if (changes & NEW_C) { + /* + * Make sure the state index is in range, then grab the state. + * If we have a good state index, clear the 'discard' flag. + */ + if (*cp >= MAX_SLOTS) { + PPPDEBUG(LOG_INFO, ("vj_uncompress_tcp: bad cid=%d\n", *cp)); + goto bad; + } + + comp->flags &=~ VJF_TOSS; + comp->last_recv = *cp++; + } else { + /* + * this packet has an implicit state index. If we've + * had a line error since the last time we got an + * explicit state index, we have to toss the packet. + */ + if (comp->flags & VJF_TOSS) { + PPPDEBUG(LOG_INFO, ("vj_uncompress_tcp: tossing\n")); + INCR(vjs_tossed); + return (-1); + } + } + cs = &comp->rstate[comp->last_recv]; + hlen = IPH_HL(&cs->cs_ip) << 2; + th = (struct tcp_hdr *)&((u8_t*)&cs->cs_ip)[hlen]; + th->chksum = htons((*cp << 8) | cp[1]); + cp += 2; + if (changes & TCP_PUSH_BIT) { + TCPH_SET_FLAG(th, TCP_PSH); + } else { + TCPH_UNSET_FLAG(th, TCP_PSH); + } + + switch (changes & SPECIALS_MASK) { + case SPECIAL_I: + { + u32_t i = ntohs(IPH_LEN(&cs->cs_ip)) - cs->cs_hlen; + /* some compilers can't nest inline assembler.. */ + tmp = ntohl(th->ackno) + i; + th->ackno = htonl(tmp); + tmp = ntohl(th->seqno) + i; + th->seqno = htonl(tmp); + } + break; + + case SPECIAL_D: + /* some compilers can't nest inline assembler.. */ + tmp = ntohl(th->seqno) + ntohs(IPH_LEN(&cs->cs_ip)) - cs->cs_hlen; + th->seqno = htonl(tmp); + break; + + default: + if (changes & NEW_U) { + TCPH_SET_FLAG(th, TCP_URG); + DECODEU(th->urgp); + } else { + TCPH_UNSET_FLAG(th, TCP_URG); + } + if (changes & NEW_W) { + DECODES(th->wnd); + } + if (changes & NEW_A) { + DECODEL(th->ackno); + } + if (changes & NEW_S) { + DECODEL(th->seqno); + } + break; + } + if (changes & NEW_I) { + DECODES(cs->cs_ip._id); + } else { + IPH_ID_SET(&cs->cs_ip, ntohs(IPH_ID(&cs->cs_ip)) + 1); + IPH_ID_SET(&cs->cs_ip, htons(IPH_ID(&cs->cs_ip))); + } + + /* + * At this point, cp points to the first byte of data in the + * packet. Fill in the IP total length and update the IP + * header checksum. + */ + vjlen = (u16_t)(cp - (u8_t*)n0->payload); + if (n0->len < vjlen) { + /* + * We must have dropped some characters (crc should detect + * this but the old slip framing won't) + */ + PPPDEBUG(LOG_INFO, ("vj_uncompress_tcp: head buffer %d too short %d\n", + n0->len, vjlen)); + goto bad; + } + +#if BYTE_ORDER == LITTLE_ENDIAN + tmp = n0->tot_len - vjlen + cs->cs_hlen; + IPH_LEN_SET(&cs->cs_ip, htons((u16_t)tmp)); +#else + IPH_LEN_SET(&cs->cs_ip, htons(n0->tot_len - vjlen + cs->cs_hlen)); +#endif + + /* recompute the ip header checksum */ + bp = (u16_t*) &cs->cs_ip; + IPH_CHKSUM_SET(&cs->cs_ip, 0); + for (tmp = 0; hlen > 0; hlen -= 2) { + tmp += *bp++; + } + tmp = (tmp & 0xffff) + (tmp >> 16); + tmp = (tmp & 0xffff) + (tmp >> 16); + IPH_CHKSUM_SET(&cs->cs_ip, (u16_t)(~tmp)); + + /* Remove the compressed header and prepend the uncompressed header. */ + if (pbuf_header(n0, -(s16_t)vjlen)) { + /* Can we cope with this failing? Just assert for now */ + LWIP_ASSERT("pbuf_header failed\n", 0); + goto bad; + } + + if(LWIP_MEM_ALIGN(n0->payload) != n0->payload) { + struct pbuf *np, *q; + u8_t *bufptr; + +#if IP_FORWARD + /* If IP forwarding is enabled we are using a PBUF_LINK packet type so + * the packet is being allocated with enough header space to be + * forwarded (to Ethernet for example). + */ + np = pbuf_alloc(PBUF_LINK, n0->len + cs->cs_hlen, PBUF_POOL); +#else /* IP_FORWARD */ + np = pbuf_alloc(PBUF_RAW, n0->len + cs->cs_hlen, PBUF_POOL); +#endif /* IP_FORWARD */ + if(!np) { + PPPDEBUG(LOG_WARNING, ("vj_uncompress_tcp: realign failed\n")); + goto bad; + } + + if (pbuf_header(np, -(s16_t)cs->cs_hlen)) { + /* Can we cope with this failing? Just assert for now */ + LWIP_ASSERT("pbuf_header failed\n", 0); + goto bad; + } + + bufptr = (u8_t*)n0->payload; + for(q = np; q != NULL; q = q->next) { + MEMCPY(q->payload, bufptr, q->len); + bufptr += q->len; + } + + if(n0->next) { + pbuf_chain(np, n0->next); + pbuf_dechain(n0); + } + pbuf_free(n0); + n0 = np; + } + + if (pbuf_header(n0, (s16_t)cs->cs_hlen)) { + struct pbuf *np; + + LWIP_ASSERT("vj_uncompress_tcp: cs->cs_hlen <= PBUF_POOL_BUFSIZE", cs->cs_hlen <= PBUF_POOL_BUFSIZE); + np = pbuf_alloc(PBUF_RAW, cs->cs_hlen, PBUF_POOL); + if(!np) { + PPPDEBUG(LOG_WARNING, ("vj_uncompress_tcp: prepend failed\n")); + goto bad; + } + pbuf_cat(np, n0); + n0 = np; + } + LWIP_ASSERT("n0->len >= cs->cs_hlen", n0->len >= cs->cs_hlen); + MEMCPY(n0->payload, &cs->cs_ip, cs->cs_hlen); + + *nb = n0; + + return vjlen; + +bad: + comp->flags |= VJF_TOSS; + INCR(vjs_errorin); + return (-1); +} + +#endif /* PPP_SUPPORT && VJ_SUPPORT && LWIP_TCP */ diff --git a/components/lwip/netif/slipif.c b/components/lwip/netif/slipif.c new file mode 100755 index 000000000..bf02475eb --- /dev/null +++ b/components/lwip/netif/slipif.c @@ -0,0 +1,555 @@ +/** + * @file + * SLIP Interface + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of the Institute nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * This file is built upon the file: src/arch/rtxc/netif/sioslip.c + * + * Author: Magnus Ivarsson + * Simon Goldschmidt + * + * Usage: This netif can be used in three ways: + * 1) For NO_SYS==0, an RX thread can be used which blocks on sio_read() + * until data is received. + * 2) In your main loop, call slipif_poll() to check for new RX bytes, + * completed packets are fed into netif->input(). + * 3) Call slipif_received_byte[s]() from your serial RX ISR and + * slipif_process_rxqueue() from your main loop. ISR level decodes + * packets and puts completed packets on a queue which is fed into + * the stack from the main loop (needs SYS_LIGHTWEIGHT_PROT for + * pbuf_alloc to work on ISR level!). + * + */ + +/* + * This is an arch independent SLIP netif. The specific serial hooks must be + * provided by another file. They are sio_open, sio_read/sio_tryread and sio_send + */ + +#include "netif/slipif.h" +#include "lwip/opt.h" + +#if LWIP_HAVE_SLIPIF + +#include "lwip/def.h" +#include "lwip/pbuf.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" +#include "lwip/sys.h" +#include "lwip/sio.h" + +#define SLIP_END 0xC0 /* 0300: start and end of every packet */ +#define SLIP_ESC 0xDB /* 0333: escape start (one byte escaped data follows) */ +#define SLIP_ESC_END 0xDC /* 0334: following escape: original byte is 0xC0 (END) */ +#define SLIP_ESC_ESC 0xDD /* 0335: following escape: original byte is 0xDB (ESC) */ + +/** Maximum packet size that is received by this netif */ +#ifndef SLIP_MAX_SIZE +#define SLIP_MAX_SIZE 1500 +#endif + +/** Define this to the interface speed for SNMP + * (sio_fd is the sio_fd_t returned by sio_open). + * The default value of zero means 'unknown'. + */ +#ifndef SLIP_SIO_SPEED +#define SLIP_SIO_SPEED(sio_fd) 0 +#endif + +enum slipif_recv_state { + SLIP_RECV_NORMAL, + SLIP_RECV_ESCAPE +}; + +struct slipif_priv { + sio_fd_t sd; + /* q is the whole pbuf chain for a packet, p is the current pbuf in the chain */ + struct pbuf *p, *q; + u8_t state; + u16_t i, recved; +#if SLIP_RX_FROM_ISR + struct pbuf *rxpackets; +#endif +}; + +/** + * Send a pbuf doing the necessary SLIP encapsulation + * + * Uses the serial layer's sio_send() + * + * @param netif the lwip network interface structure for this slipif + * @param p the pbuf chain packet to send + * @return always returns ERR_OK since the serial layer does not provide return values + */ +static err_t +slipif_output(struct netif *netif, struct pbuf *p) +{ + struct slipif_priv *priv; + struct pbuf *q; + u16_t i; + u8_t c; + + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + LWIP_ASSERT("p != NULL", (p != NULL)); + + LWIP_DEBUGF(SLIP_DEBUG, ("slipif_output(%"U16_F"): sending %"U16_F" bytes\n", (u16_t)netif->num, p->tot_len)); + priv = (struct slipif_priv *)netif->state; + + /* Send pbuf out on the serial I/O device. */ + /* Start with packet delimiter. */ + sio_send(SLIP_END, priv->sd); + + for (q = p; q != NULL; q = q->next) { + for (i = 0; i < q->len; i++) { + c = ((u8_t *)q->payload)[i]; + switch (c) { + case SLIP_END: + /* need to escape this byte (0xC0 -> 0xDB, 0xDC) */ + sio_send(SLIP_ESC, priv->sd); + sio_send(SLIP_ESC_END, priv->sd); + break; + case SLIP_ESC: + /* need to escape this byte (0xDB -> 0xDB, 0xDD) */ + sio_send(SLIP_ESC, priv->sd); + sio_send(SLIP_ESC_ESC, priv->sd); + break; + default: + /* normal byte - no need for escaping */ + sio_send(c, priv->sd); + break; + } + } + } + /* End with packet delimiter. */ + sio_send(SLIP_END, priv->sd); + return ERR_OK; +} + +#if LWIP_IPV4 +/** + * Send a pbuf doing the necessary SLIP encapsulation + * + * Uses the serial layer's sio_send() + * + * @param netif the lwip network interface structure for this slipif + * @param p the pbuf chain packet to send + * @param ipaddr the ip address to send the packet to (not used for slipif) + * @return always returns ERR_OK since the serial layer does not provide return values + */ +static err_t +slipif_output_v4(struct netif *netif, struct pbuf *p, const ip4_addr_t *ipaddr) +{ + LWIP_UNUSED_ARG(ipaddr); + return slipif_output(netif, p); +} +#endif /* LWIP_IPV4 */ + +#if LWIP_IPV6 +/** + * Send a pbuf doing the necessary SLIP encapsulation + * + * Uses the serial layer's sio_send() + * + * @param netif the lwip network interface structure for this slipif + * @param p the pbuf chain packet to send + * @param ipaddr the ip address to send the packet to (not used for slipif) + * @return always returns ERR_OK since the serial layer does not provide return values + */ +static err_t +slipif_output_v6(struct netif *netif, struct pbuf *p, const ip6_addr_t *ipaddr) +{ + LWIP_UNUSED_ARG(ipaddr); + return slipif_output(netif, p); +} +#endif /* LWIP_IPV6 */ + +/** + * Handle the incoming SLIP stream character by character + * + * @param netif the lwip network interface structure for this slipif + * @param c received character (multiple calls to this function will + * return a complete packet, NULL is returned before - used for polling) + * @return The IP packet when SLIP_END is received + */ +static struct pbuf* +slipif_rxbyte(struct netif *netif, u8_t c) +{ + struct slipif_priv *priv; + struct pbuf *t; + + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + + priv = (struct slipif_priv *)netif->state; + + switch (priv->state) { + case SLIP_RECV_NORMAL: + switch (c) { + case SLIP_END: + if (priv->recved > 0) { + /* Received whole packet. */ + /* Trim the pbuf to the size of the received packet. */ + pbuf_realloc(priv->q, priv->recved); + + LINK_STATS_INC(link.recv); + + LWIP_DEBUGF(SLIP_DEBUG, ("slipif: Got packet (%"U16_F" bytes)\n", priv->recved)); + t = priv->q; + priv->p = priv->q = NULL; + priv->i = priv->recved = 0; + return t; + } + return NULL; + case SLIP_ESC: + priv->state = SLIP_RECV_ESCAPE; + return NULL; + default: + break; + } /* end switch (c) */ + break; + case SLIP_RECV_ESCAPE: + /* un-escape END or ESC bytes, leave other bytes + (although that would be a protocol error) */ + switch (c) { + case SLIP_ESC_END: + c = SLIP_END; + break; + case SLIP_ESC_ESC: + c = SLIP_ESC; + break; + default: + break; + } + priv->state = SLIP_RECV_NORMAL; + break; + default: + break; + } /* end switch (priv->state) */ + + /* byte received, packet not yet completely received */ + if (priv->p == NULL) { + /* allocate a new pbuf */ + LWIP_DEBUGF(SLIP_DEBUG, ("slipif_input: alloc\n")); + priv->p = pbuf_alloc(PBUF_LINK, (PBUF_POOL_BUFSIZE - PBUF_LINK_HLEN - PBUF_LINK_ENCAPSULATION_HLEN), PBUF_POOL); + + if (priv->p == NULL) { + LINK_STATS_INC(link.drop); + LWIP_DEBUGF(SLIP_DEBUG, ("slipif_input: no new pbuf! (DROP)\n")); + /* don't process any further since we got no pbuf to receive to */ + return NULL; + } + + if (priv->q != NULL) { + /* 'chain' the pbuf to the existing chain */ + pbuf_cat(priv->q, priv->p); + } else { + /* p is the first pbuf in the chain */ + priv->q = priv->p; + } + } + + /* this automatically drops bytes if > SLIP_MAX_SIZE */ + if ((priv->p != NULL) && (priv->recved <= SLIP_MAX_SIZE)) { + ((u8_t *)priv->p->payload)[priv->i] = c; + priv->recved++; + priv->i++; + if (priv->i >= priv->p->len) { + /* on to the next pbuf */ + priv->i = 0; + if (priv->p->next != NULL && priv->p->next->len > 0) { + /* p is a chain, on to the next in the chain */ + priv->p = priv->p->next; + } else { + /* p is a single pbuf, set it to NULL so next time a new + * pbuf is allocated */ + priv->p = NULL; + } + } + } + return NULL; +} + +/** Like slipif_rxbyte, but passes completed packets to netif->input + * + * @param netif The lwip network interface structure for this slipif + * @param data received character + */ +static void +slipif_rxbyte_input(struct netif *netif, u8_t c) +{ + struct pbuf *p; + p = slipif_rxbyte(netif, c); + if (p != NULL) { + if (netif->input(p, netif) != ERR_OK) { + pbuf_free(p); + } + } +} + +#if SLIP_USE_RX_THREAD +/** + * The SLIP input thread. + * + * Feed the IP layer with incoming packets + * + * @param nf the lwip network interface structure for this slipif + */ +static void +slipif_loop_thread(void *nf) +{ + u8_t c; + struct netif *netif = (struct netif *)nf; + struct slipif_priv *priv = (struct slipif_priv *)netif->state; + + while (1) { + if (sio_read(priv->sd, &c, 1) > 0) { + slipif_rxbyte_input(netif, c); + } + } +} +#endif /* SLIP_USE_RX_THREAD */ + +/** + * SLIP netif initialization + * + * Call the arch specific sio_open and remember + * the opened device in the state field of the netif. + * + * @param netif the lwip network interface structure for this slipif + * @return ERR_OK if serial line could be opened, + * ERR_MEM if no memory could be allocated, + * ERR_IF is serial line couldn't be opened + * + * @note netif->num must contain the number of the serial port to open + * (0 by default). If netif->state is != NULL, it is interpreted as an + * u8_t pointer pointing to the serial port number instead of netif->num. + * + */ +err_t +slipif_init(struct netif *netif) +{ + struct slipif_priv *priv; + u8_t sio_num; + + LWIP_DEBUGF(SLIP_DEBUG, ("slipif_init: netif->num=%"U16_F"\n", (u16_t)netif->num)); + + /* Allocate private data */ + priv = (struct slipif_priv *)mem_malloc(sizeof(struct slipif_priv)); + if (!priv) { + return ERR_MEM; + } + + netif->name[0] = 's'; + netif->name[1] = 'l'; +#if LWIP_IPV4 + netif->output = slipif_output_v4; +#endif /* LWIP_IPV4 */ +#if LWIP_IPV6 + netif->output_ip6 = slipif_output_v6; +#endif /* LWIP_IPV6 */ + netif->mtu = SLIP_MAX_SIZE; + + /* netif->state or netif->num contain the port number */ + if (netif->state != NULL) { + sio_num = *(u8_t*)netif->state; + } else { + sio_num = netif->num; + } + /* Try to open the serial port. */ + priv->sd = sio_open(sio_num); + if (!priv->sd) { + /* Opening the serial port failed. */ + mem_free(priv); + return ERR_IF; + } + + /* Initialize private data */ + priv->p = NULL; + priv->q = NULL; + priv->state = SLIP_RECV_NORMAL; + priv->i = 0; + priv->recved = 0; +#if SLIP_RX_FROM_ISR + priv->rxpackets = NULL; +#endif + + netif->state = priv; + + /* initialize the snmp variables and counters inside the struct netif */ + MIB2_INIT_NETIF(netif, snmp_ifType_slip, SLIP_SIO_SPEED(priv->sd)); + +#if SLIP_USE_RX_THREAD + /* Create a thread to poll the serial line. */ + sys_thread_new(SLIPIF_THREAD_NAME, slipif_loop_thread, netif, + SLIPIF_THREAD_STACKSIZE, SLIPIF_THREAD_PRIO); +#endif /* SLIP_USE_RX_THREAD */ + return ERR_OK; +} + +/** + * Polls the serial device and feeds the IP layer with incoming packets. + * + * @param netif The lwip network interface structure for this slipif + */ +void +slipif_poll(struct netif *netif) +{ + u8_t c; + struct slipif_priv *priv; + + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + + priv = (struct slipif_priv *)netif->state; + + while (sio_tryread(priv->sd, &c, 1) > 0) { + slipif_rxbyte_input(netif, c); + } +} + +#if SLIP_RX_FROM_ISR +/** + * Feeds the IP layer with incoming packets that were receive + * + * @param netif The lwip network interface structure for this slipif + */ +void +slipif_process_rxqueue(struct netif *netif) +{ + struct slipif_priv *priv; + SYS_ARCH_DECL_PROTECT(old_level); + + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + + priv = (struct slipif_priv *)netif->state; + + SYS_ARCH_PROTECT(old_level); + while (priv->rxpackets != NULL) { + struct pbuf *p = priv->rxpackets; +#if SLIP_RX_QUEUE + /* dequeue packet */ + struct pbuf *q = p; + while ((q->len != q->tot_len) && (q->next != NULL)) { + q = q->next; + } + priv->rxpackets = q->next; + q->next = NULL; +#else /* SLIP_RX_QUEUE */ + priv->rxpackets = NULL; +#endif /* SLIP_RX_QUEUE */ + SYS_ARCH_UNPROTECT(old_level); + if (netif->input(p, netif) != ERR_OK) { + pbuf_free(p); + } + SYS_ARCH_PROTECT(old_level); + } +} + +/** Like slipif_rxbyte, but queues completed packets. + * + * @param netif The lwip network interface structure for this slipif + * @param data Received serial byte + */ +static void +slipif_rxbyte_enqueue(struct netif *netif, u8_t data) +{ + struct pbuf *p; + struct slipif_priv *priv = (struct slipif_priv *)netif->state; + SYS_ARCH_DECL_PROTECT(old_level); + + p = slipif_rxbyte(netif, data); + if (p != NULL) { + SYS_ARCH_PROTECT(old_level); + if (priv->rxpackets != NULL) { +#if SLIP_RX_QUEUE + /* queue multiple pbufs */ + struct pbuf *q = p; + while (q->next != NULL) { + q = q->next; + } + q->next = p; + } else { +#else /* SLIP_RX_QUEUE */ + pbuf_free(priv->rxpackets); + } + { +#endif /* SLIP_RX_QUEUE */ + priv->rxpackets = p; + } + SYS_ARCH_UNPROTECT(old_level); + } +} + +/** + * Process a received byte, completed packets are put on a queue that is + * fed into IP through slipif_process_rxqueue(). + * + * This function can be called from ISR if SYS_LIGHTWEIGHT_PROT is enabled. + * + * @param netif The lwip network interface structure for this slipif + * @param data received character + */ +void +slipif_received_byte(struct netif *netif, u8_t data) +{ + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + slipif_rxbyte_enqueue(netif, data); +} + +/** + * Process multiple received byte, completed packets are put on a queue that is + * fed into IP through slipif_process_rxqueue(). + * + * This function can be called from ISR if SYS_LIGHTWEIGHT_PROT is enabled. + * + * @param netif The lwip network interface structure for this slipif + * @param data received character + * @param len Number of received characters + */ +void +slipif_received_bytes(struct netif *netif, u8_t *data, u8_t len) +{ + u8_t i; + u8_t *rxdata = data; + LWIP_ASSERT("netif != NULL", (netif != NULL)); + LWIP_ASSERT("netif->state != NULL", (netif->state != NULL)); + + for (i = 0; i < len; i++, rxdata++) { + slipif_rxbyte_enqueue(netif, *rxdata); + } +} +#endif /* SLIP_RX_FROM_ISR */ + +#endif /* LWIP_HAVE_SLIPIF */ diff --git a/components/lwip/port/freertos/sys_arch.c b/components/lwip/port/freertos/sys_arch.c new file mode 100755 index 000000000..caa6d1a3a --- /dev/null +++ b/components/lwip/port/freertos/sys_arch.c @@ -0,0 +1,494 @@ +/* + * Copyright (c) 2001-2003 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +/* lwIP includes. */ + +#include "lwip/debug.h" +#include "lwip/def.h" +#include "lwip/sys.h" +#include "lwip/mem.h" +#include "arch/sys_arch.h" + +/* This is the number of threads that can be started with sys_thread_new() */ +#define SYS_THREAD_MAX 4 + +#if !LWIP_COMPAT_MUTEX +/** Create a new mutex + * @param mutex pointer to the mutex to create + * @return a new mutex */ +err_t +sys_mutex_new(sys_mutex_t *pxMutex) +{ + err_t xReturn = ERR_MEM; + + *pxMutex = xSemaphoreCreateMutex(); + + if (*pxMutex != NULL) { + xReturn = ERR_OK; + } + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mutex_new: m=%p\n", *pxMutex)); + + return xReturn; +} + +/** Lock a mutex + * @param mutex the mutex to lock */ +void +sys_mutex_lock(sys_mutex_t *pxMutex) +{ + while (xSemaphoreTake(*pxMutex, portMAX_DELAY) != pdPASS); +} + +err_t +sys_mutex_trylock(sys_mutex_t *pxMutex) +{ + if (xSemaphoreTake(*pxMutex, 0) == pdPASS) return 0; + else return -1; +} + +/** Unlock a mutex + * @param mutex the mutex to unlock */ +void +sys_mutex_unlock(sys_mutex_t *pxMutex) +{ + xSemaphoreGive(*pxMutex); +} + +/** Delete a semaphore + * @param mutex the mutex to delete */ +void +sys_mutex_free(sys_mutex_t *pxMutex) +{ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mutex_free: m=%p\n", *pxMutex)); + vQueueDelete(*pxMutex); +} +#endif + +/*-----------------------------------------------------------------------------------*/ +// Creates and returns a new semaphore. The "count" argument specifies +// the initial state of the semaphore. TBD finish and test +err_t +sys_sem_new(sys_sem_t *sem, u8_t count) +{ + err_t xReturn = ERR_MEM; + vSemaphoreCreateBinary(*sem); + + if ((*sem) != NULL) { + if (count == 0) { // Means it can't be taken + xSemaphoreTake(*sem, 1); + } + + xReturn = ERR_OK; + } else { + ; // TBD need assert + } + + return xReturn; +} + +/*-----------------------------------------------------------------------------------*/ +// Signals a semaphore +void +sys_sem_signal(sys_sem_t *sem) +{ + xSemaphoreGive(*sem); +} + +/*-----------------------------------------------------------------------------------*/ +/* + Blocks the thread while waiting for the semaphore to be + signaled. If the "timeout" argument is non-zero, the thread should + only be blocked for the specified time (measured in + milliseconds). + + If the timeout argument is non-zero, the return value is the number of + milliseconds spent waiting for the semaphore to be signaled. If the + semaphore wasn't signaled within the specified time, the return value is + SYS_ARCH_TIMEOUT. If the thread didn't have to wait for the semaphore + (i.e., it was already signaled), the function may return zero. + + Notice that lwIP implements a function with a similar name, + sys_sem_wait(), that uses the sys_arch_sem_wait() function. +*/ +u32_t +sys_arch_sem_wait(sys_sem_t *sem, u32_t timeout) +{ + portTickType StartTime, EndTime, Elapsed; + unsigned long ulReturn; + + StartTime = xTaskGetTickCount(); + + if (timeout != 0) { + if (xSemaphoreTake(*sem, timeout / portTICK_RATE_MS) == pdTRUE) { + EndTime = xTaskGetTickCount(); + Elapsed = (EndTime - StartTime) * portTICK_RATE_MS; + + if (Elapsed == 0) { + Elapsed = 1; + } + + ulReturn = Elapsed; + } else { + ulReturn = SYS_ARCH_TIMEOUT; + } + } else { // must block without a timeout + while (xSemaphoreTake(*sem, portMAX_DELAY) != pdTRUE); + + EndTime = xTaskGetTickCount(); + Elapsed = (EndTime - StartTime) * portTICK_RATE_MS; + + if (Elapsed == 0) { + Elapsed = 1; + } + + ulReturn = Elapsed; + } + + return ulReturn ; // return time blocked +} + +/*-----------------------------------------------------------------------------------*/ +// Deallocates a semaphore +void +sys_sem_free(sys_sem_t *sem) +{ + vSemaphoreDelete(*sem); +} + +/*-----------------------------------------------------------------------------------*/ +// Creates an empty mailbox. +err_t +sys_mbox_new(sys_mbox_t *mbox, int size) +{ + *mbox = malloc(sizeof(struct sys_mbox_s)); + if (*mbox == NULL){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("fail to new *mbox\n")); + return ERR_MEM; + } + + (*mbox)->os_mbox = xQueueCreate(size, sizeof(void *)); + + if ((*mbox)->os_mbox == NULL) { + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("fail to new *mbox->os_mbox\n")); + free(*mbox); + return ERR_MEM; + } + + if (sys_mutex_new(&((*mbox)->lock)) != ERR_OK){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("fail to new *mbox->lock\n")); + vQueueDelete((*mbox)->os_mbox); + free(*mbox); + return ERR_MEM; + } + + (*mbox)->alive = true; + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("new *mbox ok\n")); + return ERR_OK; +} + +/*-----------------------------------------------------------------------------------*/ +// Posts the "msg" to the mailbox. +void +sys_mbox_post(sys_mbox_t *mbox, void *msg) +{ + while (xQueueSendToBack((*mbox)->os_mbox, &msg, portMAX_DELAY) != pdTRUE); +} + +/*-----------------------------------------------------------------------------------*/ +err_t +sys_mbox_trypost(sys_mbox_t *mbox, void *msg) +{ + err_t xReturn; + + if (xQueueSend((*mbox)->os_mbox, &msg, (portTickType)0) == pdPASS) { + xReturn = ERR_OK; + } else { + xReturn = ERR_MEM; + } + + return xReturn; +} + +/*-----------------------------------------------------------------------------------*/ +/* + Blocks the thread until a message arrives in the mailbox, but does + not block the thread longer than "timeout" milliseconds (similar to + the sys_arch_sem_wait() function). The "msg" argument is a result + parameter that is set by the function (i.e., by doing "*msg = + ptr"). The "msg" parameter maybe NULL to indicate that the message + should be dropped. + + The return values are the same as for the sys_arch_sem_wait() function: + Number of milliseconds spent waiting or SYS_ARCH_TIMEOUT if there was a + timeout. + + Note that a function with a similar name, sys_mbox_fetch(), is + implemented by lwIP. +*/ +u32_t +sys_arch_mbox_fetch(sys_mbox_t *mbox, void **msg, u32_t timeout) +{ + void *dummyptr; + portTickType StartTime, EndTime, Elapsed; + unsigned long ulReturn; + + StartTime = xTaskGetTickCount(); + if (msg == NULL) { + msg = &dummyptr; + } + + if (*mbox == NULL){ + *msg = NULL; + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_arch_mbox_fetch: null mbox\n")); + return -1; + } + + sys_mutex_lock(&(*mbox)->lock); + + if (timeout != 0) { + if (pdTRUE == xQueueReceive((*mbox)->os_mbox, &(*msg), timeout / portTICK_RATE_MS)) { + EndTime = xTaskGetTickCount(); + Elapsed = (EndTime - StartTime) * portTICK_RATE_MS; + + if (Elapsed == 0) { + Elapsed = 1; + } + + ulReturn = Elapsed; + } else { // timed out blocking for message + *msg = NULL; + ulReturn = SYS_ARCH_TIMEOUT; + } + } else { // block forever for a message. + while (1){ + + if (pdTRUE == xQueueReceive((*mbox)->os_mbox, &(*msg), portMAX_DELAY)){ + break; + } + + if ((*mbox)->alive == false){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_arch_mbox_fetch:mbox not alive\n")); + *msg = NULL; + break; + } + } + + EndTime = xTaskGetTickCount(); + Elapsed = (EndTime - StartTime) * portTICK_RATE_MS; + + if (Elapsed == 0) { + Elapsed = 1; + } + + ulReturn = Elapsed; + } + + sys_mutex_unlock(&(*mbox)->lock); + + return ulReturn ; // return time blocked TBD test +} + +/*-----------------------------------------------------------------------------------*/ +u32_t +sys_arch_mbox_tryfetch(sys_mbox_t *mbox, void **msg) +{ + void *pvDummy; + unsigned long ulReturn; + + if (msg == NULL) { + msg = &pvDummy; + } + + if (pdTRUE == xQueueReceive((*mbox)->os_mbox, &(*msg), 0)) { + ulReturn = ERR_OK; + } else { + ulReturn = SYS_MBOX_EMPTY; + } + + return ulReturn; +} + +/*-----------------------------------------------------------------------------------*/ +/* + Deallocates a mailbox. If there are messages still present in the + mailbox when the mailbox is deallocated, it is an indication of a + programming error in lwIP and the developer should be notified. +*/ +void +sys_mbox_free(sys_mbox_t *mbox) +{ + uint8_t count = 0; + bool post_null = true; + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free: set alive false\n")); + (*mbox)->alive = false; + + while ( count++ < 10 ){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free:try lock=%d\n", count)); + if (!sys_mutex_trylock( &(*mbox)->lock )){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free:get lock ok %d\n", count)); + sys_mutex_unlock( &(*mbox)->lock ); + break; + } + + if (post_null){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free: post null to mbox\n")); + if (sys_mbox_trypost( mbox, NULL) != ERR_OK){ + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free: post null mbox fail\n")); + } else { + post_null = false; + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free: post null mbox ok\n")); + } + } + + if (count == 10){ + printf("WARNING: mbox %p had a consumer who never unblocked. Leaking!\n", (*mbox)->os_mbox); + } + sys_delay_ms(20); + } + + LWIP_DEBUGF(THREAD_SAFE_DEBUG, ("sys_mbox_free:free mbox\n")); + + if (uxQueueMessagesWaiting((*mbox)->os_mbox)) { + xQueueReset((*mbox)->os_mbox); + /* Line for breakpoint. Should never break here! */ + __asm__ volatile ("nop"); + } + + vQueueDelete((*mbox)->os_mbox); + sys_mutex_free(&(*mbox)->lock); + free(*mbox); + *mbox = NULL; +} + +/*-----------------------------------------------------------------------------------*/ +/* + Starts a new thread with priority "prio" that will begin its execution in the + function "thread()". The "arg" argument will be passed as an argument to the + thread() function. The id of the new thread is returned. Both the id and + the priority are system dependent. +*/ +sys_thread_t +sys_thread_new(const char *name, lwip_thread_fn thread, void *arg, int stacksize, int prio) +{ + xTaskHandle CreatedTask; + portBASE_TYPE result; + + result = xTaskCreate(thread, name, stacksize, arg, prio, &CreatedTask); + + if (result == pdPASS) { + return CreatedTask; + } else { + return NULL; + } +} + +/*-----------------------------------------------------------------------------------*/ +// Initialize sys arch +void +sys_init(void) +{ +} + +/*-----------------------------------------------------------------------------------*/ +u32_t +sys_now(void) +{ + return xTaskGetTickCount(); +} + +/* + This optional function does a "fast" critical region protection and returns + the previous protection level. This function is only called during very short + critical regions. An embedded system which supports ISR-based drivers might + want to implement this function by disabling interrupts. Task-based systems + might want to implement this by using a mutex or disabling tasking. This + function should support recursive calls from the same task or interrupt. In + other words, sys_arch_protect() could be called while already protected. In + that case the return value indicates that it is already protected. + + sys_arch_protect() is only required if your port is supporting an operating + system. +*/ +sys_prot_t +sys_arch_protect(void) +{ +// vTaskEnterCritical(); + return (sys_prot_t) 1; +} + +/*-----------------------------------------------------------------------------------*/ +/* + This optional function does a "fast" set of critical region protection to the + value specified by pval. See the documentation for sys_arch_protect() for + more information. This function is only required if your port is supporting + an operating system. +*/ +void +sys_arch_unprotect(sys_prot_t pval) +{ + (void) pval; +// vTaskExitCritical(); +} + +/*-----------------------------------------------------------------------------------*/ +/* + * Prints an assertion messages and aborts execution. + */ +void +sys_arch_assert(const char *file, int line) +{ + printf("\nAssertion: %d in %s\n", line, file); + +// vTaskEnterCritical(); + while(1); +} + +/* This is a super hacky thread-local-storage repository + FreeRTOS 8.2.3 & up have thread local storage in the + OS, which is how we should do this. Once we upgrade FreeRTOS, + we can drop this hacky store and use the FreeRTOS TLS API. +*/ +sys_sem_t* sys_thread_sem(void) +{ + extern void* xTaskGetLwipSem(void); + return (sys_sem_t*)(xTaskGetLwipSem()); +} + +void sys_delay_ms(uint32_t ms) +{ + vTaskDelay(ms/portTICK_RATE_MS); +} + + diff --git a/components/lwip/port/netif/wlanif.c b/components/lwip/port/netif/wlanif.c new file mode 100755 index 000000000..0b87656c8 --- /dev/null +++ b/components/lwip/port/netif/wlanif.c @@ -0,0 +1,284 @@ +/** + * @file + * Ethernet Interface Skeleton + * + */ + +/* + * Copyright (c) 2001-2004 Swedish Institute of Computer Science. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * 3. The name of the author may not be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT + * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT + * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY + * OF SUCH DAMAGE. + * + * This file is part of the lwIP TCP/IP stack. + * + * Author: Adam Dunkels + * + */ + +#include "lwip/opt.h" + +#include "lwip/def.h" +#include "lwip/mem.h" +#include "lwip/pbuf.h" +#include "lwip/stats.h" +#include "lwip/snmp.h" +#include "lwip/ethip6.h" +#include "netif/etharp.h" +#include "netif/wlanif.h" + +#include +#include + +#include "tcpip_adapter.h" + +/* Define those to better describe your network interface. */ +#define IFNAME0 'e' +#define IFNAME1 'n' + +#ifdef LWIP_ESP8266 +//TO_DO +//char *hostname; +//bool default_hostname = 1; + +static char hostname[16]; +#else +static char hostname[16]; +#endif +#ifdef PERF +uint32 g_rx_alloc_pbuf_fail_cnt = 0; +#endif + +/** + * In this function, the hardware should be initialized. + * Called from ethernetif_init(). + * + * @param netif the already initialized lwip network interface structure + * for this ethernetif + */ +static void +low_level_init(struct netif *netif) +{ + + + + + /* set MAC hardware address length */ + netif->hwaddr_len = ETHARP_HWADDR_LEN; + + /* set MAC hardware address */ + + /* maximum transfer unit */ + netif->mtu = 1500; + + /* device capabilities */ + /* don't set NETIF_FLAG_ETHARP if this device is not an ethernet one */ + netif->flags = NETIF_FLAG_BROADCAST | NETIF_FLAG_ETHARP | NETIF_FLAG_LINK_UP; + +#ifdef LWIP_ESP8266 + +#if LWIP_IGMP + + netif->flags |= NETIF_FLAG_IGMP; +#endif + + + #endif + + /* Do whatever else is needed to initialize interface. */ +} + +/** + * This function should do the actual transmission of the packet. The packet is + * contained in the pbuf that is passed to the function. This pbuf + * might be chained. + * + * @param netif the lwip network interface structure for this ethernetif + * @param p the MAC packet to send (e.g. IP packet including MAC addresses and type) + * @return ERR_OK if the packet could be sent + * an err_t value if the packet couldn't be sent + * + * @note Returning ERR_MEM here if a DMA queue of your MAC is full can lead to + * strange results. You might consider waiting for space in the DMA queue + * to become availale since the stack doesn't retry to send a packet + * dropped because of memory failure (except for the TCP timers). + */ +static err_t +low_level_output(struct netif *netif, struct pbuf *p) +{ + struct pbuf *q; + wifi_interface_t wifi_if = tcpip_adapter_get_wifi_if(netif); + + if (wifi_if >= WIFI_IF_MAX) { + return ERR_IF; + } + +#ifdef LWIP_ESP8266 + q = p; + u16_t pbuf_x_len = 0; + pbuf_x_len = q->len; + if(q->next !=NULL) + { + //char cnt = 0; + struct pbuf *tmp = q->next; + while(tmp != NULL) + { + memcpy( (u8_t *)( (u8_t *)(q->payload) + pbuf_x_len), (u8_t *)tmp->payload , tmp->len ); + pbuf_x_len += tmp->len; + //cnt++; + tmp = tmp->next; + } + } + + ieee80211_output(wifi_if, q->payload, pbuf_x_len); + return ERR_OK; + +#else + for(q = p; q != NULL; q = q->next) { + ieee80211_output(wifi_if, q->payload, q->len); + } +#endif + + return ERR_OK; +} + +/** + * This function should be called when a packet is ready to be read + * from the interface. It uses the function low_level_input() that + * should handle the actual reception of bytes from the network + * interface. Then the type of the received packet is determined and + * the appropriate input function is called. + * + * @param netif the lwip network interface structure for this ethernetif + */ +void +#ifdef LWIP_ESP8266 +wlanif_input(struct netif *netif, void *buffer, u16_t len, void* eb) +#else +wlanif_input(struct netif *netif, void *buffer, uint16 len) +#endif +{ + struct pbuf *p; + +#ifdef LWIP_ESP8266 + if(buffer== NULL) + goto _exit; + if(netif == NULL) + goto _exit; +#endif + +#ifdef LWIP_ESP8266 + p = pbuf_alloc(PBUF_RAW, len, PBUF_REF); + if (p == NULL){ +#ifdef PERF + g_rx_alloc_pbuf_fail_cnt++; +#endif + return; + } + p->payload = buffer; + p->eb = eb; +#else + p = pbuf_alloc(PBUF_IP, len, PBUF_POOL); + if (p == NULL) { + return; + } + memcpy(p->payload, buffer, len); +#endif + + + /* full packet send to tcpip_thread to process */ + if (netif->input(p, netif) != ERR_OK) { + LWIP_DEBUGF(NETIF_DEBUG, ("ethernetif_input: IP input error\n")); + pbuf_free(p); + } + +_exit: +; +} + +/** + * Should be called at the beginning of the program to set up the + * network interface. It calls the function low_level_init() to do the + * actual setup of the hardware. + * + * This function should be passed as a parameter to netif_add(). + * + * @param netif the lwip network interface structure for this ethernetif + * @return ERR_OK if the loopif is initialized + * ERR_MEM if private data couldn't be allocated + * any other err_t on error + */ +err_t +wlanif_init(struct netif *netif) +{ + LWIP_ASSERT("netif != NULL", (netif != NULL)); + +#if LWIP_NETIF_HOSTNAME + /* Initialize interface hostname */ + +#ifdef LWIP_ESP8266 +//TO_DO +/* + if ((struct netif *)wifi_get_netif(STATION_IF) == netif) { + if (default_hostname == 1) { + wifi_station_set_default_hostname(netif->hwaddr); + } + netif->hostname = hostname; + } else { + netif->hostname = NULL; + } +*/ + sprintf(hostname, "ESP_%02X%02X%02X", netif->hwaddr[3], netif->hwaddr[4], netif->hwaddr[5]); + netif->hostname = hostname; + +#else + sprintf(hostname, "ESP_%02X%02X%02X", netif->hwaddr[3], netif->hwaddr[4], netif->hwaddr[5]); + netif->hostname = hostname; +#endif + +#endif /* LWIP_NETIF_HOSTNAME */ + + /* + * Initialize the snmp variables and counters inside the struct netif. + * The last argument should be replaced with your link speed, in units + * of bits per second. + */ + NETIF_INIT_SNMP(netif, snmp_ifType_ethernet_csmacd, LINK_SPEED_OF_YOUR_NETIF_IN_BPS); + + netif->name[0] = IFNAME0; + netif->name[1] = IFNAME1; + /* We directly use etharp_output() here to save a function call. + * You can instead declare your own function an call etharp_output() + * from it if you have to do some checks before sending (e.g. if link + * is available...) */ + netif->output = etharp_output; +#if LWIP_IPV6 + netif->output_ip6 = ethip6_output; +#endif /* LWIP_IPV6 */ + netif->linkoutput = low_level_output; + + /* initialize the hardware */ + low_level_init(netif); + + return ERR_OK; +} diff --git a/components/newlib/.gitignore b/components/newlib/.gitignore new file mode 100644 index 000000000..99c1e5325 --- /dev/null +++ b/components/newlib/.gitignore @@ -0,0 +1,2 @@ +.build +*.syms diff --git a/components/newlib/.gitmodules b/components/newlib/.gitmodules new file mode 100644 index 000000000..1a3930d13 --- /dev/null +++ b/components/newlib/.gitmodules @@ -0,0 +1,4 @@ +[submodule "newlib_xtensa-2.2.0"] + path = newlib_xtensa-2.2.0 + url = ssh://git@gitlab.espressif.cn:27227/igrokhotkov/newlib_xtensa-2.2.0.git + ignore = dirty diff --git a/components/newlib/COPYING.NEWLIB b/components/newlib/COPYING.NEWLIB new file mode 100644 index 000000000..0655d3549 --- /dev/null +++ b/components/newlib/COPYING.NEWLIB @@ -0,0 +1,953 @@ +The newlib subdirectory is a collection of software from several sources. + +Each file may have its own copyright/license that is embedded in the source +file. Unless otherwise noted in the body of the source file(s), the following copyright +notices will apply to the contents of the newlib subdirectory: + +(1) Red Hat Incorporated + +Copyright (c) 1994-2009 Red Hat, Inc. All rights reserved. + +This copyrighted material is made available to anyone wishing to use, +modify, copy, or redistribute it subject to the terms and conditions +of the BSD License. This program is distributed in the hope that +it will be useful, but WITHOUT ANY WARRANTY expressed or implied, +including the implied warranties of MERCHANTABILITY or FITNESS FOR +A PARTICULAR PURPOSE. A copy of this license is available at +http://www.opensource.org/licenses. Any Red Hat trademarks that are +incorporated in the source code or documentation are not subject to +the BSD License and may only be used or replicated with the express +permission of Red Hat, Inc. + +(2) University of California, Berkeley + +Copyright (c) 1981-2000 The Regents of the University of California. +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of the University nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, +INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY +OF SUCH DAMAGE. + +(3) David M. Gay (AT&T 1991, Lucent 1998) + +The author of this software is David M. Gay. + +Copyright (c) 1991 by AT&T. + +Permission to use, copy, modify, and distribute this software for any +purpose without fee is hereby granted, provided that this entire notice +is included in all copies of any software which is or includes a copy +or modification of this software and in all copies of the supporting +documentation for such software. + +THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED +WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY +REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY +OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + +------------------------------------------------------------------- + +The author of this software is David M. Gay. + +Copyright (C) 1998-2001 by Lucent Technologies +All Rights Reserved + +Permission to use, copy, modify, and distribute this software and +its documentation for any purpose and without fee is hereby +granted, provided that the above copyright notice appear in all +copies and that both that the copyright notice and this +permission notice and warranty disclaimer appear in supporting +documentation, and that the name of Lucent or any of its entities +not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior +permission. + +LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, +INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. +IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY +SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER +IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, +ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF +THIS SOFTWARE. + + +(4) Advanced Micro Devices + +Copyright 1989, 1990 Advanced Micro Devices, Inc. + +This software is the property of Advanced Micro Devices, Inc (AMD) which +specifically grants the user the right to modify, use and distribute this +software provided this notice is not removed or altered. All other rights +are reserved by AMD. + +AMD MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS +SOFTWARE. IN NO EVENT SHALL AMD BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL +DAMAGES IN CONNECTION WITH OR ARISING FROM THE FURNISHING, PERFORMANCE, OR +USE OF THIS SOFTWARE. + +So that all may benefit from your experience, please report any problems +or suggestions about this software to the 29K Technical Support Center at +800-29-29-AMD (800-292-9263) in the USA, or 0800-89-1131 in the UK, or +0031-11-1129 in Japan, toll free. The direct dial number is 512-462-4118. + +Advanced Micro Devices, Inc. +29K Support Products +Mail Stop 573 +5900 E. Ben White Blvd. +Austin, TX 78741 +800-292-9263 + +(5) + +(6) + +(7) Sun Microsystems + +Copyright (C) 1993 by Sun Microsystems, Inc. All rights reserved. + +Developed at SunPro, a Sun Microsystems, Inc. business. +Permission to use, copy, modify, and distribute this +software is freely granted, provided that this notice is preserved. + +(8) Hewlett Packard + +(c) Copyright 1986 HEWLETT-PACKARD COMPANY + +To anyone who acknowledges that this file is provided "AS IS" +without any express or implied warranty: + permission to use, copy, modify, and distribute this file +for any purpose is hereby granted without fee, provided that +the above copyright notice and this notice appears in all +copies, and that the name of Hewlett-Packard Company not be +used in advertising or publicity pertaining to distribution +of the software without specific, written prior permission. +Hewlett-Packard Company makes no representations about the +suitability of this software for any purpose. + +(9) Hans-Peter Nilsson + +Copyright (C) 2001 Hans-Peter Nilsson + +Permission to use, copy, modify, and distribute this software is +freely granted, provided that the above copyright notice, this notice +and the following disclaimer are preserved with no changes. + +THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. + +(10) Stephane Carrez (m68hc11-elf/m68hc12-elf targets only) + +Copyright (C) 1999, 2000, 2001, 2002 Stephane Carrez (stcarrez@nerim.fr) + +The authors hereby grant permission to use, copy, modify, distribute, +and license this software and its documentation for any purpose, provided +that existing copyright notices are retained in all copies and that this +notice is included verbatim in any distributions. No written agreement, +license, or royalty fee is required for any of the authorized uses. +Modifications to this software may be copyrighted by their authors +and need not follow the licensing terms described here, provided that +the new terms are clearly indicated on the first page of each file where +they apply. + +(11) Christopher G. Demetriou + +Copyright (c) 2001 Christopher G. Demetriou +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. The name of the author may not be used to endorse or promote products + derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(12) SuperH, Inc. + +Copyright 2002 SuperH, Inc. All rights reserved + +This software is the property of SuperH, Inc (SuperH) which specifically +grants the user the right to modify, use and distribute this software +provided this notice is not removed or altered. All other rights are +reserved by SuperH. + +SUPERH MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO +THIS SOFTWARE. IN NO EVENT SHALL SUPERH BE LIABLE FOR INDIRECT, SPECIAL, +INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH OR ARISING FROM +THE FURNISHING, PERFORMANCE, OR USE OF THIS SOFTWARE. + +So that all may benefit from your experience, please report any problems +or suggestions about this software to the SuperH Support Center via +e-mail at softwaresupport@superh.com . + +SuperH, Inc. +405 River Oaks Parkway +San Jose +CA 95134 +USA + +(13) Royal Institute of Technology + +Copyright (c) 1999 Kungliga Tekniska Högskolan +(Royal Institute of Technology, Stockholm, Sweden). +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +3. Neither the name of KTH nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY KTH AND ITS CONTRIBUTORS ``AS IS'' AND ANY +EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL KTH OR ITS CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR +BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(14) Alexey Zelkin + +Copyright (c) 2000, 2001 Alexey Zelkin +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(15) Andrey A. Chernov + +Copyright (C) 1997 by Andrey A. Chernov, Moscow, Russia. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(16) FreeBSD + +Copyright (c) 1997-2002 FreeBSD Project. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(17) S. L. Moshier + +Author: S. L. Moshier. + +Copyright (c) 1984,2000 S.L. Moshier + +Permission to use, copy, modify, and distribute this software for any +purpose without fee is hereby granted, provided that this entire notice +is included in all copies of any software which is or includes a copy +or modification of this software and in all copies of the supporting +documentation for such software. + +THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED +WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION +OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS +SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + +(18) Citrus Project + +Copyright (c)1999 Citrus Project, +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(19) Todd C. Miller + +Copyright (c) 1998 Todd C. Miller +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. The name of the author may not be used to endorse or promote products + derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL +THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(20) DJ Delorie (i386) +Copyright (C) 1991 DJ Delorie +All rights reserved. + +Redistribution, modification, and use in source and binary forms is permitted +provided that the above copyright notice and following paragraph are +duplicated in all such forms. + +This file is distributed WITHOUT ANY WARRANTY; without even the implied +warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +(21) Free Software Foundation LGPL License (*-linux* targets only) + + Copyright (C) 1990-1999, 2000, 2001 Free Software Foundation, Inc. + This file is part of the GNU C Library. + Contributed by Mark Kettenis , 1997. + + The GNU C Library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + The GNU C Library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with the GNU C Library; if not, write to the Free + Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + 02110-1301 USA. + +(22) Xavier Leroy LGPL License (i[3456]86-*-linux* targets only) + +Copyright (C) 1996 Xavier Leroy (Xavier.Leroy@inria.fr) + +This program is free software; you can redistribute it and/or +modify it under the terms of the GNU Library General Public License +as published by the Free Software Foundation; either version 2 +of the License, or (at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU Library General Public License for more details. + +(23) Intel (i960) + +Copyright (c) 1993 Intel Corporation + +Intel hereby grants you permission to copy, modify, and distribute this +software and its documentation. Intel grants this permission provided +that the above copyright notice appears in all copies and that both the +copyright notice and this permission notice appear in supporting +documentation. In addition, Intel grants this permission provided that +you prominently mark as "not part of the original" any modifications +made to this software or documentation, and that the name of Intel +Corporation not be used in advertising or publicity pertaining to +distribution of the software or the documentation without specific, +written prior permission. + +Intel Corporation provides this AS IS, WITHOUT ANY WARRANTY, EXPRESS OR +IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY +OR FITNESS FOR A PARTICULAR PURPOSE. Intel makes no guarantee or +representations regarding the use of, or the results of the use of, +the software and documentation in terms of correctness, accuracy, +reliability, currentness, or otherwise; and you rely on the software, +documentation and results solely at your own risk. + +IN NO EVENT SHALL INTEL BE LIABLE FOR ANY LOSS OF USE, LOSS OF BUSINESS, +LOSS OF PROFITS, INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES +OF ANY KIND. IN NO EVENT SHALL INTEL'S TOTAL LIABILITY EXCEED THE SUM +PAID TO INTEL FOR THE PRODUCT LICENSED HEREUNDER. + +(24) Hewlett-Packard (hppa targets only) + +(c) Copyright 1986 HEWLETT-PACKARD COMPANY + +To anyone who acknowledges that this file is provided "AS IS" +without any express or implied warranty: + permission to use, copy, modify, and distribute this file +for any purpose is hereby granted without fee, provided that +the above copyright notice and this notice appears in all +copies, and that the name of Hewlett-Packard Company not be +used in advertising or publicity pertaining to distribution +of the software without specific, written prior permission. +Hewlett-Packard Company makes no representations about the +suitability of this software for any purpose. + +(25) Henry Spencer (only *-linux targets) + +Copyright 1992, 1993, 1994 Henry Spencer. All rights reserved. +This software is not subject to any license of the American Telephone +and Telegraph Company or of the Regents of the University of California. + +Permission is granted to anyone to use this software for any purpose on +any computer system, and to alter it and redistribute it, subject +to the following restrictions: + +1. The author is not responsible for the consequences of use of this + software, no matter how awful, even if they arise from flaws in it. + +2. The origin of this software must not be misrepresented, either by + explicit claim or by omission. Since few users ever read sources, + credits must appear in the documentation. + +3. Altered versions must be plainly marked as such, and must not be + misrepresented as being the original software. Since few users + ever read sources, credits must appear in the documentation. + +4. This notice may not be removed or altered. + +(26) Mike Barcroft + +Copyright (c) 2001 Mike Barcroft +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(27) Konstantin Chuguev (--enable-newlib-iconv) + +Copyright (c) 1999, 2000 + Konstantin Chuguev. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + + iconv (Charset Conversion Library) v2.0 + +(28) Artem Bityuckiy (--enable-newlib-iconv) + +Copyright (c) 2003, Artem B. Bityuckiy, SoftMine Corporation. +Rights transferred to Franklin Electronic Publishers. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + +(29) IBM, Sony, Toshiba (only spu-* targets) + + (C) Copyright 2001,2006, + International Business Machines Corporation, + Sony Computer Entertainment, Incorporated, + Toshiba Corporation, + + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the names of the copyright holders nor the names of their + contributors may be used to endorse or promote products derived from this + software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + +(30) - Alex Tatmanjants (targets using libc/posix) + + Copyright (c) 1995 Alex Tatmanjants + at Electronni Visti IA, Kiev, Ukraine. + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE + FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + +(31) - M. Warner Losh (targets using libc/posix) + + Copyright (c) 1998, M. Warner Losh + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + +(32) - Andrey A. Chernov (targets using libc/posix) + + Copyright (C) 1996 by Andrey A. Chernov, Moscow, Russia. + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + +(33) - Daniel Eischen (targets using libc/posix) + + Copyright (c) 2001 Daniel Eischen . + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + + +(34) - Jon Beniston (only lm32-* targets) + + Contributed by Jon Beniston + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + SUCH DAMAGE. + + +(35) - ARM Ltd (arm and thumb variant targets only) + + Copyright (c) 2009 ARM Ltd + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + 3. The name of the company may not be used to endorse or promote + products derived from this software without specific prior written + permission. + + THIS SOFTWARE IS PROVIDED BY ARM LTD ``AS IS'' AND ANY EXPRESS OR IMPLIED + WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + IN NO EVENT SHALL ARM LTD BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(36) - Xilinx, Inc. (microblaze-* and powerpc-* targets) + +Copyright (c) 2004, 2009 Xilinx, Inc. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + +1. Redistributions source code must retain the above copyright notice, +this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +3. Neither the name of Xilinx nor the names of its contributors may be +used to endorse or promote products derived from this software without +specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS +IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + +(37) Texas Instruments Incorporated (tic6x-*, *-tirtos targets) + +Copyright (c) 1996-2010,2014 Texas Instruments Incorporated +http://www.ti.com/ + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + Neither the name of Texas Instruments Incorporated nor the names + of its contributors may be used to endorse or promote products + derived from this software without specific prior written + permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(38) National Semiconductor (cr16-* and crx-* targets) + +Copyright (c) 2004 National Semiconductor Corporation + +The authors hereby grant permission to use, copy, modify, distribute, +and license this software and its documentation for any purpose, provided +that existing copyright notices are retained in all copies and that this +notice is included verbatim in any distributions. No written agreement, +license, or royalty fee is required for any of the authorized uses. +Modifications to this software may be copyrighted by their authors +and need not follow the licensing terms described here, provided that +the new terms are clearly indicated on the first page of each file where +they apply. + +(39) - Adapteva, Inc. (epiphany-* targets) + +Copyright (c) 2011, Adapteva, Inc. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Adapteva nor the names of its contributors may be used + to endorse or promote products derived from this software without specific + prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(40) - Altera Corportion (nios2-* targets) + +Copyright (c) 2003 Altera Corporation +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + + o Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + o Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + o Neither the name of Altera Corporation nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY ALTERA CORPORATION, THE COPYRIGHT HOLDER, +AND ITS CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, +INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL +THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS +OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR +TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE +USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +(41) Ed Schouten - Free BSD + +Copyright (c) 2008 Ed Schouten +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + diff --git a/components/newlib/Makefile b/components/newlib/Makefile new file mode 100644 index 000000000..b9913d241 --- /dev/null +++ b/components/newlib/Makefile @@ -0,0 +1,8 @@ +COMPONENT_ADD_LDFLAGS := $(abspath lib/libc.a) $(abspath lib/libm.a) + + +define COMPONENT_BUILDRECIPE + #Nothing to do; this does not generate a library. +endef + +include $(SDK_PATH)/make/component.mk diff --git a/components/newlib/Makefile.old b/components/newlib/Makefile.old new file mode 100644 index 000000000..a8fc8efd9 --- /dev/null +++ b/components/newlib/Makefile.old @@ -0,0 +1,47 @@ + + +TARGET_DIR=$(PWD)/.build +ROM_ELF_FILE ?= /tmp/eagle.pro.rom.out + +all: newlib check_common_syms + +newlib_xtensa-2.2.0: + git submodule update --init + +newlib: newlib_xtensa-2.2.0 + +newlib: + cd newlib_xtensa-2.2.0 && \ + ./configure \ + --with-newlib \ + --enable-multilib \ + --disable-newlib-io-c99-formats \ + --disable-newlib-supplied-syscalls \ + --enable-newlib-nano-formatted-io \ + --enable-newlib-reent-small \ + --enable-target-optspace \ + --program-transform-name="s&^&xtensa-esp108-elf-&" \ + --disable-option-checking \ + --with-target-subdir=xtensa-esp108-elf \ + --target=xtensa-esp108-elf \ + --prefix=$(TARGET_DIR) \ + && CROSS_CFLAGS="-DSIGNAL_PROVIDED -DABORT_PROVIDED -DMALLOC_PROVIDED" make all install || true + cp -r $(TARGET_DIR)/xtensa-esp108-elf/{include,lib} ./ + cp lib/libc.a lib/libc_rom.a + xtensa-esp108-elf-ar d lib/libc_rom.a lib_a-nano-vfprintf_float.o + xtensa-esp108-elf-ar d lib/libc_rom.a lib_a-nano-vfscanf_float.o + while read obj; do xtensa-esp108-elf-ar d lib/libc.a $$obj; done libc.syms + @# get symbols in ROM + @xtensa-esp108-elf-nm $(ROM_ELF_FILE) | grep -v -E '\W+U\W+' | awk '{print $$3}' | sort >rom.syms + @# check that there are no common symbols + @test $$(comm -12 rom.syms libc.syms | tee common.syms | wc -l) -eq 0 + +.PHONY: all clean newlib diff --git a/components/newlib/include/_ansi.h b/components/newlib/include/_ansi.h new file mode 100644 index 000000000..5fb990700 --- /dev/null +++ b/components/newlib/include/_ansi.h @@ -0,0 +1,140 @@ +/* Provide support for both ANSI and non-ANSI environments. */ + +/* Some ANSI environments are "broken" in the sense that __STDC__ cannot be + relied upon to have it's intended meaning. Therefore we must use our own + concoction: _HAVE_STDC. Always use _HAVE_STDC instead of __STDC__ in newlib + sources! + + To get a strict ANSI C environment, define macro __STRICT_ANSI__. This will + "comment out" the non-ANSI parts of the ANSI header files (non-ANSI header + files aren't affected). */ + +#ifndef _ANSIDECL_H_ +#define _ANSIDECL_H_ + +#include +#include + +/* First try to figure out whether we really are in an ANSI C environment. */ +/* FIXME: This probably needs some work. Perhaps sys/config.h can be + prevailed upon to give us a clue. */ + +#ifdef __STDC__ +#define _HAVE_STDC +#endif + +/* ISO C++. */ + +#ifdef __cplusplus +#if !(defined(_BEGIN_STD_C) && defined(_END_STD_C)) +#ifdef _HAVE_STD_CXX +#define _BEGIN_STD_C namespace std { extern "C" { +#define _END_STD_C } } +#else +#define _BEGIN_STD_C extern "C" { +#define _END_STD_C } +#endif +#if __GNUC_PREREQ (3, 3) +#define _NOTHROW __attribute__ ((__nothrow__)) +#else +#define _NOTHROW throw() +#endif +#endif +#else +#define _BEGIN_STD_C +#define _END_STD_C +#define _NOTHROW +#endif + +#ifdef _HAVE_STDC +#define _PTR void * +#define _AND , +#define _NOARGS void +#define _CONST const +#define _VOLATILE volatile +#define _SIGNED signed +#define _DOTS , ... +#define _VOID void +#ifdef __CYGWIN__ +#define _EXFUN_NOTHROW(name, proto) __cdecl name proto _NOTHROW +#define _EXFUN(name, proto) __cdecl name proto +#define _EXPARM(name, proto) (* __cdecl name) proto +#define _EXFNPTR(name, proto) (__cdecl * name) proto +#else +#define _EXFUN_NOTHROW(name, proto) name proto _NOTHROW +#define _EXFUN(name, proto) name proto +#define _EXPARM(name, proto) (* name) proto +#define _EXFNPTR(name, proto) (* name) proto +#endif +#define _DEFUN(name, arglist, args) name(args) +#define _DEFUN_VOID(name) name(_NOARGS) +#define _CAST_VOID (void) +#ifndef _LONG_DOUBLE +#define _LONG_DOUBLE long double +#endif +#ifndef _PARAMS +#define _PARAMS(paramlist) paramlist +#endif +#else +#define _PTR char * +#define _AND ; +#define _NOARGS +#define _CONST +#define _VOLATILE +#define _SIGNED +#define _DOTS +#define _VOID void +#define _EXFUN(name, proto) name() +#define _EXFUN_NOTHROW(name, proto) name() +#define _DEFUN(name, arglist, args) name arglist args; +#define _DEFUN_VOID(name) name() +#define _CAST_VOID +#define _LONG_DOUBLE double +#ifndef _PARAMS +#define _PARAMS(paramlist) () +#endif +#endif + +/* Support gcc's __attribute__ facility. */ + +#ifdef __GNUC__ +#define _ATTRIBUTE(attrs) __attribute__ (attrs) +#else +#define _ATTRIBUTE(attrs) +#endif + +/* The traditional meaning of 'extern inline' for GCC is not + to emit the function body unless the address is explicitly + taken. However this behaviour is changing to match the C99 + standard, which uses 'extern inline' to indicate that the + function body *must* be emitted. Likewise, a function declared + without either 'extern' or 'static' defaults to extern linkage + (C99 6.2.2p5), and the compiler may choose whether to use the + inline version or call the extern linkage version (6.7.4p6). + If we are using GCC, but do not have the new behaviour, we need + to use extern inline; if we are using a new GCC with the + C99-compatible behaviour, or a non-GCC compiler (which we will + have to hope is C99, since there is no other way to achieve the + effect of omitting the function if it isn't referenced) we use + 'static inline', which c99 defines to mean more-or-less the same + as the Gnu C 'extern inline'. */ +#if defined(__GNUC__) && !defined(__GNUC_STDC_INLINE__) +/* We're using GCC, but without the new C99-compatible behaviour. */ +#define _ELIDABLE_INLINE extern __inline__ _ATTRIBUTE ((__always_inline__)) +#else +/* We're using GCC in C99 mode, or an unknown compiler which + we just have to hope obeys the C99 semantics of inline. */ +#define _ELIDABLE_INLINE static __inline__ +#endif + +#if __GNUC_PREREQ (3, 1) +#define _NOINLINE __attribute__ ((__noinline__)) +#define _NOINLINE_STATIC _NOINLINE static +#else +/* On non-GNU compilers and GCC prior to version 3.1 the compiler can't be + trusted not to inline if it is static. */ +#define _NOINLINE +#define _NOINLINE_STATIC +#endif + +#endif /* _ANSIDECL_H_ */ diff --git a/components/newlib/include/_syslist.h b/components/newlib/include/_syslist.h new file mode 100644 index 000000000..271644efa --- /dev/null +++ b/components/newlib/include/_syslist.h @@ -0,0 +1,40 @@ +/* internal use only -- mapping of "system calls" for libraries that lose + and only provide C names, so that we end up in violation of ANSI */ +#ifndef __SYSLIST_H +#define __SYSLIST_H + +#ifdef MISSING_SYSCALL_NAMES +#define _close close +#define _execve execve +#define _fcntl fcntl +#define _fork fork +#define _fstat fstat +#define _getpid getpid +#define _gettimeofday gettimeofday +#define _isatty isatty +#define _kill kill +#define _link link +#define _lseek lseek +#define _mkdir mkdir +#define _open open +#define _read read +#define _sbrk sbrk +#define _stat stat +#define _times times +#define _unlink unlink +#define _wait wait +#define _write write +#endif /* MISSING_SYSCALL_NAMES */ + +#if defined MISSING_SYSCALL_NAMES || !defined HAVE_OPENDIR +/* If the system call interface is missing opendir, readdir, and + closedir, there is an implementation of these functions in + libc/posix that is implemented using open, getdents, and close. + Note, these functions are currently not in the libc/syscalls + directory. */ +#define _opendir opendir +#define _readdir readdir +#define _closedir closedir +#endif /* MISSING_SYSCALL_NAMES || !HAVE_OPENDIR */ + +#endif /* !__SYSLIST_H_ */ diff --git a/components/newlib/include/alloca.h b/components/newlib/include/alloca.h new file mode 100644 index 000000000..2ea0fd9b3 --- /dev/null +++ b/components/newlib/include/alloca.h @@ -0,0 +1,21 @@ +/* libc/include/alloca.h - Allocate memory on stack */ + +/* Written 2000 by Werner Almesberger */ +/* Rearranged for general inclusion by stdlib.h. + 2001, Corinna Vinschen */ + +#ifndef _NEWLIB_ALLOCA_H +#define _NEWLIB_ALLOCA_H + +#include "_ansi.h" +#include + +#undef alloca + +#ifdef __GNUC__ +#define alloca(size) __builtin_alloca(size) +#else +void * _EXFUN(alloca,(size_t)); +#endif + +#endif diff --git a/components/newlib/include/ar.h b/components/newlib/include/ar.h new file mode 100644 index 000000000..ac2e4ca92 --- /dev/null +++ b/components/newlib/include/ar.h @@ -0,0 +1,69 @@ +/* $NetBSD: ar.h,v 1.4 1994/10/26 00:55:43 cgd Exp $ */ + +/*- + * Copyright (c) 1991, 1993 + * The Regents of the University of California. All rights reserved. + * (c) UNIX System Laboratories, Inc. + * All or some portions of this file are derived from material licensed + * to the University of California by American Telephone and Telegraph + * Co. or Unix System Laboratories, Inc. and are reproduced herein with + * the permission of UNIX System Laboratories, Inc. + * + * This code is derived from software contributed to Berkeley by + * Hugh Smith at The University of Guelph. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)ar.h 8.2 (Berkeley) 1/21/94 + */ + +#ifndef _AR_H_ +#define _AR_H_ + +/* Pre-4BSD archives had these magic numbers in them. */ +#define OARMAG1 0177555 +#define OARMAG2 0177545 + +#define ARMAG "!\n" /* ar "magic number" */ +#define SARMAG 8 /* strlen(ARMAG); */ + +#define AR_EFMT1 "#1/" /* extended format #1 */ + +struct ar_hdr { + char ar_name[16]; /* name */ + char ar_date[12]; /* modification time */ + char ar_uid[6]; /* user id */ + char ar_gid[6]; /* group id */ + char ar_mode[8]; /* octal file permissions */ + char ar_size[10]; /* size in bytes */ +#define ARFMAG "`\n" + char ar_fmag[2]; /* consistency check */ +}; + +#endif /* !_AR_H_ */ diff --git a/components/newlib/include/argz.h b/components/newlib/include/argz.h new file mode 100644 index 000000000..02c9adbf3 --- /dev/null +++ b/components/newlib/include/argz.h @@ -0,0 +1,33 @@ +/* Copyright (C) 2002 by Red Hat, Incorporated. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + */ + +#ifndef _ARGZ_H_ +#define _ARGZ_H_ + +#include +#include + +#include "_ansi.h" + +_BEGIN_STD_C + +/* The newlib implementation of these functions assumes that sizeof(char) == 1. */ +error_t argz_create (char *const argv[], char **argz, size_t *argz_len); +error_t argz_create_sep (const char *string, int sep, char **argz, size_t *argz_len); +size_t argz_count (const char *argz, size_t argz_len); +void argz_extract (char *argz, size_t argz_len, char **argv); +void argz_stringify (char *argz, size_t argz_len, int sep); +error_t argz_add (char **argz, size_t *argz_len, const char *str); +error_t argz_add_sep (char **argz, size_t *argz_len, const char *str, int sep); +error_t argz_append (char **argz, size_t *argz_len, const char *buf, size_t buf_len); +error_t argz_delete (char **argz, size_t *argz_len, char *entry); +error_t argz_insert (char **argz, size_t *argz_len, char *before, const char *entry); +char * argz_next (char *argz, size_t argz_len, const char *entry); +error_t argz_replace (char **argz, size_t *argz_len, const char *str, const char *with, unsigned *replace_count); + +_END_STD_C + +#endif /* _ARGZ_H_ */ diff --git a/components/newlib/include/assert.h b/components/newlib/include/assert.h new file mode 100644 index 000000000..91bb040ca --- /dev/null +++ b/components/newlib/include/assert.h @@ -0,0 +1,50 @@ +/* + assert.h +*/ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "_ansi.h" + +#undef assert + +#ifdef NDEBUG /* required by ANSI standard */ +# define assert(__e) ((void)0) +#else +# define assert(__e) ((__e) ? (void)0 : __assert_func (__FILE__, __LINE__, \ + __ASSERT_FUNC, #__e)) + +# ifndef __ASSERT_FUNC + /* Use g++'s demangled names in C++. */ +# if defined __cplusplus && defined __GNUC__ +# define __ASSERT_FUNC __PRETTY_FUNCTION__ + + /* C99 requires the use of __func__. */ +# elif __STDC_VERSION__ >= 199901L +# define __ASSERT_FUNC __func__ + + /* Older versions of gcc don't have __func__ but can use __FUNCTION__. */ +# elif __GNUC__ >= 2 +# define __ASSERT_FUNC __FUNCTION__ + + /* failed to detect __func__ support. */ +# else +# define __ASSERT_FUNC ((char *) 0) +# endif +# endif /* !__ASSERT_FUNC */ +#endif /* !NDEBUG */ + +void _EXFUN(__assert, (const char *, int, const char *) + _ATTRIBUTE ((__noreturn__))); +void _EXFUN(__assert_func, (const char *, int, const char *, const char *) + _ATTRIBUTE ((__noreturn__))); + +#if __STDC_VERSION__ >= 201112L && !defined __cplusplus +# define static_assert _Static_assert +#endif + +#ifdef __cplusplus +} +#endif diff --git a/components/newlib/include/complex.h b/components/newlib/include/complex.h new file mode 100644 index 000000000..969b20e5f --- /dev/null +++ b/components/newlib/include/complex.h @@ -0,0 +1,124 @@ +/* $NetBSD: complex.h,v 1.3 2010/09/15 16:11:30 christos Exp $ */ + +/* + * Written by Matthias Drochner. + * Public domain. + */ + +#ifndef _COMPLEX_H +#define _COMPLEX_H + +#define complex _Complex +#define _Complex_I 1.0fi +#define I _Complex_I + +#include + +__BEGIN_DECLS + +/* 7.3.5 Trigonometric functions */ +/* 7.3.5.1 The cacos functions */ +double complex cacos(double complex); +float complex cacosf(float complex); + +/* 7.3.5.2 The casin functions */ +double complex casin(double complex); +float complex casinf(float complex); + +/* 7.3.5.1 The catan functions */ +double complex catan(double complex); +float complex catanf(float complex); + +/* 7.3.5.1 The ccos functions */ +double complex ccos(double complex); +float complex ccosf(float complex); + +/* 7.3.5.1 The csin functions */ +double complex csin(double complex); +float complex csinf(float complex); + +/* 7.3.5.1 The ctan functions */ +double complex ctan(double complex); +float complex ctanf(float complex); + +/* 7.3.6 Hyperbolic functions */ +/* 7.3.6.1 The cacosh functions */ +double complex cacosh(double complex); +float complex cacoshf(float complex); + +/* 7.3.6.2 The casinh functions */ +double complex casinh(double complex); +float complex casinhf(float complex); + +/* 7.3.6.3 The catanh functions */ +double complex catanh(double complex); +float complex catanhf(float complex); + +/* 7.3.6.4 The ccosh functions */ +double complex ccosh(double complex); +float complex ccoshf(float complex); + +/* 7.3.6.5 The csinh functions */ +double complex csinh(double complex); +float complex csinhf(float complex); + +/* 7.3.6.6 The ctanh functions */ +double complex ctanh(double complex); +float complex ctanhf(float complex); + +/* 7.3.7 Exponential and logarithmic functions */ +/* 7.3.7.1 The cexp functions */ +double complex cexp(double complex); +float complex cexpf(float complex); + +/* 7.3.7.2 The clog functions */ +double complex clog(double complex); +float complex clogf(float complex); + +/* 7.3.8 Power and absolute-value functions */ +/* 7.3.8.1 The cabs functions */ +/*#ifndef __LIBM0_SOURCE__ */ +/* avoid conflict with historical cabs(struct complex) */ +/* double cabs(double complex) __RENAME(__c99_cabs); + float cabsf(float complex) __RENAME(__c99_cabsf); + #endif +*/ +double cabs(double complex) ; +float cabsf(float complex) ; + +/* 7.3.8.2 The cpow functions */ +double complex cpow(double complex, double complex); +float complex cpowf(float complex, float complex); + +/* 7.3.8.3 The csqrt functions */ +double complex csqrt(double complex); +float complex csqrtf(float complex); + +/* 7.3.9 Manipulation functions */ +/* 7.3.9.1 The carg functions */ +double carg(double complex); +float cargf(float complex); + +/* 7.3.9.2 The cimag functions */ +double cimag(double complex); +float cimagf(float complex); +/*long double cimagl(long double complex); */ + +/* 7.3.9.3 The conj functions */ +double complex conj(double complex); +float complex conjf(float complex); +/*long double complex conjl(long double complex); */ + +/* 7.3.9.4 The cproj functions */ +double complex cproj(double complex); +float complex cprojf(float complex); +/*long double complex cprojl(long double complex); */ + +/* 7.3.9.5 The creal functions */ +double creal(double complex); +float crealf(float complex); +/*long double creall(long double complex); */ + +__END_DECLS + +#endif /* ! _COMPLEX_H */ diff --git a/components/newlib/include/config.h b/components/newlib/include/config.h new file mode 100644 index 000000000..69d49adf9 --- /dev/null +++ b/components/newlib/include/config.h @@ -0,0 +1,28 @@ +#ifndef __SYS_CONFIG_H__ +#define __SYS_CONFIG_H__ + +#include /* floating point macros */ +#include /* POSIX defs */ + +#ifndef __EXPORT +#define __EXPORT +#endif + +#ifndef __IMPORT +#define __IMPORT +#endif + +/* Define return type of read/write routines. In POSIX, the return type + for read()/write() is "ssize_t" but legacy newlib code has been using + "int" for some time. If not specified, "int" is defaulted. */ +#ifndef _READ_WRITE_RETURN_TYPE +#define _READ_WRITE_RETURN_TYPE int +#endif +/* Define `count' parameter of read/write routines. In POSIX, the `count' + parameter is "size_t" but legacy newlib code has been using "int" for some + time. If not specified, "int" is defaulted. */ +#ifndef _READ_WRITE_BUFSIZE_TYPE +#define _READ_WRITE_BUFSIZE_TYPE int +#endif + +#endif /* __SYS_CONFIG_H__ */ diff --git a/components/newlib/include/ctype.h b/components/newlib/include/ctype.h new file mode 100644 index 000000000..1eb3f787f --- /dev/null +++ b/components/newlib/include/ctype.h @@ -0,0 +1,113 @@ +#ifndef _CTYPE_H_ +#define _CTYPE_H_ + +#include "_ansi.h" + +_BEGIN_STD_C + +int _EXFUN(isalnum, (int __c)); +int _EXFUN(isalpha, (int __c)); +int _EXFUN(iscntrl, (int __c)); +int _EXFUN(isdigit, (int __c)); +int _EXFUN(isgraph, (int __c)); +int _EXFUN(islower, (int __c)); +int _EXFUN(isprint, (int __c)); +int _EXFUN(ispunct, (int __c)); +int _EXFUN(isspace, (int __c)); +int _EXFUN(isupper, (int __c)); +int _EXFUN(isxdigit,(int __c)); +int _EXFUN(tolower, (int __c)); +int _EXFUN(toupper, (int __c)); + +#if !defined(__STRICT_ANSI__) || defined(__cplusplus) || __STDC_VERSION__ >= 199901L +int _EXFUN(isblank, (int __c)); +#endif + +#ifndef __STRICT_ANSI__ +int _EXFUN(isascii, (int __c)); +int _EXFUN(toascii, (int __c)); +#define _tolower(__c) ((unsigned char)(__c) - 'A' + 'a') +#define _toupper(__c) ((unsigned char)(__c) - 'a' + 'A') +#endif + +#define _U 01 +#define _L 02 +#define _N 04 +#define _S 010 +#define _P 020 +#define _C 040 +#define _X 0100 +#define _B 0200 + +#ifndef _MB_CAPABLE +_CONST +#endif +extern __IMPORT char * _CONST __ctype_ptr__; + +#ifndef __cplusplus +/* These macros are intentionally written in a manner that will trigger + a gcc -Wall warning if the user mistakenly passes a 'char' instead + of an int containing an 'unsigned char'. Note that the sizeof will + always be 1, which is what we want for mapping EOF to __ctype_ptr__[0]; + the use of a raw index inside the sizeof triggers the gcc warning if + __c was of type char, and sizeof masks side effects of the extra __c. + Meanwhile, the real index to __ctype_ptr__+1 must be cast to int, + since isalpha(0x100000001LL) must equal isalpha(1), rather than being + an out-of-bounds reference on a 64-bit machine. */ +#define __ctype_lookup(__c) ((__ctype_ptr__+sizeof(""[__c]))[(int)(__c)]) + +#define isalpha(__c) (__ctype_lookup(__c)&(_U|_L)) +#define isupper(__c) ((__ctype_lookup(__c)&(_U|_L))==_U) +#define islower(__c) ((__ctype_lookup(__c)&(_U|_L))==_L) +#define isdigit(__c) (__ctype_lookup(__c)&_N) +#define isxdigit(__c) (__ctype_lookup(__c)&(_X|_N)) +#define isspace(__c) (__ctype_lookup(__c)&_S) +#define ispunct(__c) (__ctype_lookup(__c)&_P) +#define isalnum(__c) (__ctype_lookup(__c)&(_U|_L|_N)) +#define isprint(__c) (__ctype_lookup(__c)&(_P|_U|_L|_N|_B)) +#define isgraph(__c) (__ctype_lookup(__c)&(_P|_U|_L|_N)) +#define iscntrl(__c) (__ctype_lookup(__c)&_C) + +#if defined(__GNUC__) && \ + (!defined(__STRICT_ANSI__) || __STDC_VERSION__ >= 199901L) +#define isblank(__c) \ + __extension__ ({ __typeof__ (__c) __x = (__c); \ + (__ctype_lookup(__x)&_B) || (int) (__x) == '\t';}) +#endif + + +/* Non-gcc versions will get the library versions, and will be + slightly slower. These macros are not NLS-aware so they are + disabled if the system supports the extended character sets. */ +# if defined(__GNUC__) +# if !defined (_MB_EXTENDED_CHARSETS_ISO) && !defined (_MB_EXTENDED_CHARSETS_WINDOWS) +# define toupper(__c) \ + __extension__ ({ __typeof__ (__c) __x = (__c); \ + islower (__x) ? (int) __x - 'a' + 'A' : (int) __x;}) +# define tolower(__c) \ + __extension__ ({ __typeof__ (__c) __x = (__c); \ + isupper (__x) ? (int) __x - 'A' + 'a' : (int) __x;}) +# else /* _MB_EXTENDED_CHARSETS* */ +/* Allow a gcc warning if the user passed 'char', but defer to the + function. */ +# define toupper(__c) \ + __extension__ ({ __typeof__ (__c) __x = (__c); \ + (void) __ctype_ptr__[__x]; (toupper) (__x);}) +# define tolower(__c) \ + __extension__ ({ __typeof__ (__c) __x = (__c); \ + (void) __ctype_ptr__[__x]; (tolower) (__x);}) +# endif /* _MB_EXTENDED_CHARSETS* */ +# endif /* __GNUC__ */ +#endif /* !__cplusplus */ + +#ifndef __STRICT_ANSI__ +#define isascii(__c) ((unsigned)(__c)<=0177) +#define toascii(__c) ((__c)&0177) +#endif + +/* For C++ backward-compatibility only. */ +extern __IMPORT _CONST char _ctype_[]; + +_END_STD_C + +#endif /* _CTYPE_H_ */ diff --git a/components/newlib/include/dirent.h b/components/newlib/include/dirent.h new file mode 100644 index 000000000..6fefc03cb --- /dev/null +++ b/components/newlib/include/dirent.h @@ -0,0 +1,15 @@ +#ifndef _DIRENT_H_ +#define _DIRENT_H_ +#ifdef __cplusplus +extern "C" { +#endif +#include + +#if !defined(MAXNAMLEN) && !defined(_POSIX_SOURCE) +#define MAXNAMLEN 1024 +#endif + +#ifdef __cplusplus +} +#endif +#endif /*_DIRENT_H_*/ diff --git a/components/newlib/include/envlock.h b/components/newlib/include/envlock.h new file mode 100644 index 000000000..9bb6a813e --- /dev/null +++ b/components/newlib/include/envlock.h @@ -0,0 +1,15 @@ +/* envlock.h -- header file for env routines. */ + +#ifndef _INCLUDE_ENVLOCK_H_ +#define _INCLUDE_ENVLOCK_H_ + +#include <_ansi.h> +#include + +#define ENV_LOCK __env_lock(reent_ptr) +#define ENV_UNLOCK __env_unlock(reent_ptr) + +void _EXFUN(__env_lock,(struct _reent *reent)); +void _EXFUN(__env_unlock,(struct _reent *reent)); + +#endif /* _INCLUDE_ENVLOCK_H_ */ diff --git a/components/newlib/include/envz.h b/components/newlib/include/envz.h new file mode 100644 index 000000000..e6a31c31d --- /dev/null +++ b/components/newlib/include/envz.h @@ -0,0 +1,16 @@ +/* Copyright (C) 2002 by Red Hat, Incorporated. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + */ + +#include +#include + +/* The newlib implementation of these functions assumes that sizeof(char) == 1. */ +char * envz_entry (const char *envz, size_t envz_len, const char *name); +char * envz_get (const char *envz, size_t envz_len, const char *name); +error_t envz_add (char **envz, size_t *envz_len, const char *name, const char *value); +error_t envz_merge (char **envz, size_t *envz_len, const char *envz2, size_t envz2_len, int override); +void envz_remove(char **envz, size_t *envz_len, const char *name); +void envz_strip (char **envz, size_t *envz_len); diff --git a/components/newlib/include/errno.h b/components/newlib/include/errno.h new file mode 100644 index 000000000..7cc2ca86f --- /dev/null +++ b/components/newlib/include/errno.h @@ -0,0 +1,11 @@ +#ifndef __ERRNO_H__ +#define __ERRNO_H__ + +#ifndef __error_t_defined +typedef int error_t; +#define __error_t_defined 1 +#endif + +#include + +#endif /* !__ERRNO_H__ */ diff --git a/components/newlib/include/fastmath.h b/components/newlib/include/fastmath.h new file mode 100644 index 000000000..95eea5f34 --- /dev/null +++ b/components/newlib/include/fastmath.h @@ -0,0 +1,13 @@ +#ifndef _FASTMATH_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _FASTMATH_H_ + +#include +#include + +#ifdef __cplusplus +} +#endif +#endif /* _FASTMATH_H_ */ diff --git a/components/newlib/include/fcntl.h b/components/newlib/include/fcntl.h new file mode 100644 index 000000000..86a916775 --- /dev/null +++ b/components/newlib/include/fcntl.h @@ -0,0 +1 @@ +#include diff --git a/components/newlib/include/fenv.h b/components/newlib/include/fenv.h new file mode 100644 index 000000000..2fa76f758 --- /dev/null +++ b/components/newlib/include/fenv.h @@ -0,0 +1,88 @@ +/* Copyright (c) 2011 Tensilica Inc. ALL RIGHTS RESERVED. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the following + disclaimer in the documentation and/or other materials provided + with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL + TENSILICA INCORPORATED BE LIABLE FOR ANY DIRECT, INDIRECT, + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + OF THE POSSIBILITY OF SUCH DAMAGE. */ + + +#ifndef _FENV_H +#define _FENV_H + +#ifdef __cplusplus +extern "C" { +#endif + +typedef unsigned long fenv_t; +typedef unsigned long fexcept_t; + +#define FE_DIVBYZERO 0x08 +#define FE_INEXACT 0x01 +#define FE_INVALID 0x10 +#define FE_OVERFLOW 0x04 +#define FE_UNDERFLOW 0x02 + +#define FE_ALL_EXCEPT \ + (FE_DIVBYZERO | \ + FE_INEXACT | \ + FE_INVALID | \ + FE_OVERFLOW | \ + FE_UNDERFLOW) + +#define FE_DOWNWARD 0x3 +#define FE_TONEAREST 0x0 +#define FE_TOWARDZERO 0x1 +#define FE_UPWARD 0x2 + +#define FE_DFL_ENV ((const fenv_t *) 0) + +int feclearexcept(int); +int fegetexceptflag(fexcept_t *, int); +int feraiseexcept(int); +int fesetexceptflag(const fexcept_t *, int); +int fetestexcept(int); +int fegetround(void); +int fesetround(int); +int fegetenv(fenv_t *); +int feholdexcept(fenv_t *); +int fesetenv(const fenv_t *); +int feupdateenv(const fenv_t *); + +/* glibc extensions */ +int feenableexcept(int excepts); +int fedisableexcept(int excepts); +int fegetexcept(void); + +#define _FE_EXCEPTION_FLAGS_OFFSET 7 +#define _FE_EXCEPTION_FLAG_MASK (FE_ALL_EXCEPT << _FE_EXCEPTION_FLAGS_OFFSET) +#define _FE_EXCEPTION_ENABLE_OFFSET 2 +#define _FE_EXCEPTION_ENABLE_MASK (FE_ALL_EXCEPT << _FE_EXCEPTION_ENABLE_OFFSET) +#define _FE_ROUND_MODE_OFFSET 0 +#define _FE_ROUND_MODE_MASK (0x3 << _FE_ROUND_MODE_OFFSET) +#define _FE_FLOATING_ENV_MASK (_FE_EXCEPTION_FLAG_MASK | _FE_EXCEPTION_ENABLE_MASK | _FE_ROUND_MODE_MASK) + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/newlib/include/fnmatch.h b/components/newlib/include/fnmatch.h new file mode 100644 index 000000000..06311fc4b --- /dev/null +++ b/components/newlib/include/fnmatch.h @@ -0,0 +1,55 @@ +/*- + * Copyright (c) 1992, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD: src/include/fnmatch.h,v 1.10 2002/03/23 17:24:53 imp Exp $ + * @(#)fnmatch.h 8.1 (Berkeley) 6/2/93 + */ + +#ifndef _FNMATCH_H_ +#define _FNMATCH_H_ + +#define FNM_NOMATCH 1 /* Match failed. */ + +#define FNM_NOESCAPE 0x01 /* Disable backslash escaping. */ +#define FNM_PATHNAME 0x02 /* Slash must be matched by slash. */ +#define FNM_PERIOD 0x04 /* Period must be matched by period. */ + +#if defined(_GNU_SOURCE) || !defined(_ANSI_SOURCE) && !defined(_POSIX_SOURCE) +#define FNM_LEADING_DIR 0x08 /* Ignore / after Imatch. */ +#define FNM_CASEFOLD 0x10 /* Case insensitive search. */ +#define FNM_IGNORECASE FNM_CASEFOLD +#define FNM_FILE_NAME FNM_PATHNAME +#endif + +#include + +__BEGIN_DECLS +int fnmatch(const char *, const char *, int); +__END_DECLS + +#endif /* !_FNMATCH_H_ */ diff --git a/components/newlib/include/getopt.h b/components/newlib/include/getopt.h new file mode 100644 index 000000000..e12d253d4 --- /dev/null +++ b/components/newlib/include/getopt.h @@ -0,0 +1,190 @@ +/**************************************************************************** + +getopt.h - Read command line options + +AUTHOR: Gregory Pietsch +CREATED Thu Jan 09 22:37:00 1997 + +DESCRIPTION: + +The getopt() function parses the command line arguments. Its arguments argc +and argv are the argument count and array as passed to the main() function +on program invocation. The argument optstring is a list of available option +characters. If such a character is followed by a colon (`:'), the option +takes an argument, which is placed in optarg. If such a character is +followed by two colons, the option takes an optional argument, which is +placed in optarg. If the option does not take an argument, optarg is NULL. + +The external variable optind is the index of the next array element of argv +to be processed; it communicates from one call to the next which element to +process. + +The getopt_long() function works like getopt() except that it also accepts +long options started by two dashes `--'. If these take values, it is either +in the form + +--arg=value + + or + +--arg value + +It takes the additional arguments longopts which is a pointer to the first +element of an array of type GETOPT_LONG_OPTION_T, defined below. The last +element of the array has to be filled with NULL for the name field. + +The longind pointer points to the index of the current long option relative +to longopts if it is non-NULL. + +The getopt() function returns the option character if the option was found +successfully, `:' if there was a missing parameter for one of the options, +`?' for an unknown option character, and EOF for the end of the option list. + +The getopt_long() function's return value is described below. + +The function getopt_long_only() is identical to getopt_long(), except that a +plus sign `+' can introduce long options as well as `--'. + +Describe how to deal with options that follow non-option ARGV-elements. + +If the caller did not specify anything, the default is REQUIRE_ORDER if the +environment variable POSIXLY_CORRECT is defined, PERMUTE otherwise. + +REQUIRE_ORDER means don't recognize them as options; stop option processing +when the first non-option is seen. This is what Unix does. This mode of +operation is selected by either setting the environment variable +POSIXLY_CORRECT, or using `+' as the first character of the optstring +parameter. + +PERMUTE is the default. We permute the contents of ARGV as we scan, so that +eventually all the non-options are at the end. This allows options to be +given in any order, even with programs that were not written to expect this. + +RETURN_IN_ORDER is an option available to programs that were written to +expect options and other ARGV-elements in any order and that care about the +ordering of the two. We describe each non-option ARGV-element as if it were +the argument of an option with character code 1. Using `-' as the first +character of the optstring parameter selects this mode of operation. + +The special argument `--' forces an end of option-scanning regardless of the +value of `ordering'. In the case of RETURN_IN_ORDER, only `--' can cause +getopt() and friends to return EOF with optind != argc. + +COPYRIGHT NOTICE AND DISCLAIMER: + +Copyright (C) 1997 Gregory Pietsch + +This file and the accompanying getopt.c implementation file are hereby +placed in the public domain without restrictions. Just give the author +credit, don't claim you wrote it or prevent anyone else from using it. + +Gregory Pietsch's current e-mail address: +gpietsch@comcast.net +****************************************************************************/ + +/* This is a glibc-extension header file. */ + +#ifndef GETOPT_H +#define GETOPT_H + +#include <_ansi.h> + +/* include files needed by this include file */ + +#define no_argument 0 +#define required_argument 1 +#define optional_argument 2 + +#ifdef __cplusplus +extern "C" +{ + +#endif /* __cplusplus */ + +/* types defined by this include file */ + struct option + { + const char *name; /* the name of the long option */ + int has_arg; /* one of the above macros */ + int *flag; /* determines if getopt_long() returns a + * value for a long option; if it is + * non-NULL, 0 is returned as a function + * value and the value of val is stored in + * the area pointed to by flag. Otherwise, + * val is returned. */ + int val; /* determines the value to return if flag is + * NULL. */ + + }; + +/* While getopt.h is a glibc extension, the following are newlib extensions. + * They are optionally included via the __need_getopt_newlib flag. */ + +#ifdef __need_getopt_newlib + + /* macros defined by this include file */ + #define NO_ARG no_argument + #define REQUIRED_ARG required_argument + #define OPTIONAL_ARG optional_argument + + /* The GETOPT_DATA_INITIALIZER macro is used to initialize a statically- + allocated variable of type struct getopt_data. */ + #define GETOPT_DATA_INITIALIZER {0,0,0,0,0} + + /* These #defines are to make accessing the reentrant functions easier. */ + #define getopt_r __getopt_r + #define getopt_long_r __getopt_long_r + #define getopt_long_only_r __getopt_long_only_r + + /* The getopt_data structure is for reentrancy. Its members are similar to + the externally-defined variables. */ + typedef struct getopt_data + { + char *optarg; + int optind, opterr, optopt, optwhere; + } getopt_data; + +#endif /* __need_getopt_newlib */ + + /* externally-defined variables */ + extern char *optarg; + extern int optind; + extern int opterr; + extern int optopt; + + /* function prototypes */ + int _EXFUN (getopt, + (int __argc, char *const __argv[], const char *__optstring)); + + int _EXFUN (getopt_long, + (int __argc, char *const __argv[], const char *__shortopts, + const struct option * __longopts, int *__longind)); + + int _EXFUN (getopt_long_only, + (int __argc, char *const __argv[], const char *__shortopts, + const struct option * __longopts, int *__longind)); + +#ifdef __need_getopt_newlib + int _EXFUN (__getopt_r, + (int __argc, char *const __argv[], const char *__optstring, + struct getopt_data * __data)); + + int _EXFUN (__getopt_long_r, + (int __argc, char *const __argv[], const char *__shortopts, + const struct option * __longopts, int *__longind, + struct getopt_data * __data)); + + int _EXFUN (__getopt_long_only_r, + (int __argc, char *const __argv[], const char *__shortopts, + const struct option * __longopts, int *__longind, + struct getopt_data * __data)); +#endif /* __need_getopt_newlib */ + +#ifdef __cplusplus +}; + +#endif /* __cplusplus */ + +#endif /* GETOPT_H */ + +/* END OF FILE getopt.h */ diff --git a/components/newlib/include/glob.h b/components/newlib/include/glob.h new file mode 100644 index 000000000..7a300e69d --- /dev/null +++ b/components/newlib/include/glob.h @@ -0,0 +1,90 @@ +/* + * Copyright (c) 1989, 1993 + * The Regents of the University of California. All rights reserved. + * + * This code is derived from software contributed to Berkeley by + * Guido van Rossum. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)glob.h 8.1 (Berkeley) 6/2/93 + * $FreeBSD: src/include/glob.h,v 1.6 2002/03/23 17:24:53 imp Exp $ + */ + +#ifndef _GLOB_H_ +#define _GLOB_H_ + +#include + +struct stat; +typedef struct { + int gl_pathc; /* Count of total paths so far. */ + int gl_matchc; /* Count of paths matching pattern. */ + int gl_offs; /* Reserved at beginning of gl_pathv. */ + int gl_flags; /* Copy of flags parameter to glob. */ + char **gl_pathv; /* List of paths matching pattern. */ + /* Copy of errfunc parameter to glob. */ + int (*gl_errfunc)(const char *, int); + + /* + * Alternate filesystem access methods for glob; replacement + * versions of closedir(3), readdir(3), opendir(3), stat(2) + * and lstat(2). + */ + void (*gl_closedir)(void *); + struct dirent *(*gl_readdir)(void *); + void *(*gl_opendir)(const char *); + int (*gl_lstat)(const char *, struct stat *); + int (*gl_stat)(const char *, struct stat *); +} glob_t; + +#define GLOB_APPEND 0x0001 /* Append to output from previous call. */ +#define GLOB_DOOFFS 0x0002 /* Use gl_offs. */ +#define GLOB_ERR 0x0004 /* Return on error. */ +#define GLOB_MARK 0x0008 /* Append / to matching directories. */ +#define GLOB_NOCHECK 0x0010 /* Return pattern itself if nothing matches. */ +#define GLOB_NOSORT 0x0020 /* Don't sort. */ + +#define GLOB_ALTDIRFUNC 0x0040 /* Use alternately specified directory funcs. */ +#define GLOB_BRACE 0x0080 /* Expand braces ala csh. */ +#define GLOB_MAGCHAR 0x0100 /* Pattern had globbing characters. */ +#define GLOB_NOMAGIC 0x0200 /* GLOB_NOCHECK without magic chars (csh). */ +#define GLOB_QUOTE 0x0400 /* Quote special chars with \. */ +#define GLOB_TILDE 0x0800 /* Expand tilde names from the passwd file. */ +#define GLOB_LIMIT 0x1000 /* limit number of returned paths */ + +/* backwards compatibility, this is the old name for this option */ +#define GLOB_MAXPATH GLOB_LIMIT + +#define GLOB_NOSPACE (-1) /* Malloc call failed. */ +#define GLOB_ABEND (-2) /* Unignored error. */ + +__BEGIN_DECLS +int glob(const char *__restrict, int, int (*)(const char *, int), + glob_t *__restrict); +void globfree(glob_t *); +__END_DECLS + +#endif /* !_GLOB_H_ */ diff --git a/components/newlib/include/grp.h b/components/newlib/include/grp.h new file mode 100644 index 000000000..c3a5a676c --- /dev/null +++ b/components/newlib/include/grp.h @@ -0,0 +1,95 @@ +/* $NetBSD: grp.h,v 1.7 1995/04/29 05:30:40 cgd Exp $ */ + +/*- + * Copyright (c) 1989, 1993 + * The Regents of the University of California. All rights reserved. + * (c) UNIX System Laboratories, Inc. + * All or some portions of this file are derived from material licensed + * to the University of California by American Telephone and Telegraph + * Co. or Unix System Laboratories, Inc. and are reproduced herein with + * the permission of UNIX System Laboratories, Inc. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)grp.h 8.2 (Berkeley) 1/21/94 + */ + +#ifndef _GRP_H_ +#define _GRP_H_ + +#include +#include +#ifdef __CYGWIN__ +#include +#endif + +#if !defined(_POSIX_SOURCE) && !defined(_XOPEN_SOURCE) +#define _PATH_GROUP "/etc/group" +#endif + +struct group { + char *gr_name; /* group name */ + char *gr_passwd; /* group password */ + gid_t gr_gid; /* group id */ + char **gr_mem; /* group members */ +}; + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef __INSIDE_CYGWIN__ +struct group *getgrgid (gid_t); +struct group *getgrnam (const char *); +int getgrnam_r (const char *, struct group *, + char *, size_t, struct group **); +int getgrgid_r (gid_t, struct group *, + char *, size_t, struct group **); +#ifndef _POSIX_SOURCE +struct group *getgrent (void); +void setgrent (void); +void endgrent (void); +#ifndef __CYGWIN__ +void setgrfile (const char *); +#endif /* !__CYGWIN__ */ +#ifndef _XOPEN_SOURCE +#ifndef __CYGWIN__ +char *group_from_gid (gid_t, int); +int setgroupent (int); +#endif /* !__CYGWIN__ */ +int initgroups (const char *, gid_t); +#endif /* !_XOPEN_SOURCE */ +#endif /* !_POSIX_SOURCE */ +#endif /* !__INSIDE_CYGWIN__ */ + +#ifdef __cplusplus +} +#endif + +#endif /* !_GRP_H_ */ diff --git a/components/newlib/include/iconv.h b/components/newlib/include/iconv.h new file mode 100644 index 000000000..4c023e9df --- /dev/null +++ b/components/newlib/include/iconv.h @@ -0,0 +1,63 @@ +/* + * Copyright (c) 2003-2004, Artem B. Bityuckiy, SoftMine Corporation. + * Rights transferred to Franklin Electronic Publishers. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ +#ifndef _ICONV_H_ +#define _ICONV_H_ + +#include <_ansi.h> +#include +#include +#include + +/* iconv_t: charset conversion descriptor type */ +typedef _iconv_t iconv_t; + +_BEGIN_STD_C + +#ifndef _REENT_ONLY +iconv_t +_EXFUN(iconv_open, (_CONST char *, _CONST char *)); + +size_t +_EXFUN(iconv, (iconv_t, char **__restrict, size_t *__restrict, + char **__restrict, size_t *__restrict)); + +int +_EXFUN(iconv_close, (iconv_t)); +#endif + +iconv_t +_EXFUN(_iconv_open_r, (struct _reent *, _CONST char *, _CONST char *)); + +size_t +_EXFUN(_iconv_r, (struct _reent *, iconv_t, _CONST char **, + size_t *, char **, size_t *)); + +int +_EXFUN(_iconv_close_r, (struct _reent *, iconv_t)); + +_END_STD_C + +#endif /* #ifndef _ICONV_H_ */ diff --git a/components/newlib/include/ieeefp.h b/components/newlib/include/ieeefp.h new file mode 100644 index 000000000..0b06fb786 --- /dev/null +++ b/components/newlib/include/ieeefp.h @@ -0,0 +1,256 @@ +#ifndef _IEEE_FP_H_ +#define _IEEE_FP_H_ + +#include "_ansi.h" + +#include + +_BEGIN_STD_C + +/* FIXME FIXME FIXME: + Neither of __ieee_{float,double}_shape_tape seem to be used anywhere + except in libm/test. If that is the case, please delete these from here. + If that is not the case, please insert documentation here describing why + they're needed. */ + +#ifdef __IEEE_BIG_ENDIAN + +typedef union +{ + double value; + struct + { + unsigned int sign : 1; + unsigned int exponent: 11; + unsigned int fraction0:4; + unsigned int fraction1:16; + unsigned int fraction2:16; + unsigned int fraction3:16; + + } number; + struct + { + unsigned int sign : 1; + unsigned int exponent: 11; + unsigned int quiet:1; + unsigned int function0:3; + unsigned int function1:16; + unsigned int function2:16; + unsigned int function3:16; + } nan; + struct + { + unsigned long msw; + unsigned long lsw; + } parts; + long aslong[2]; +} __ieee_double_shape_type; + +#endif + +#ifdef __IEEE_LITTLE_ENDIAN + +typedef union +{ + double value; + struct + { +#ifdef __SMALL_BITFIELDS + unsigned int fraction3:16; + unsigned int fraction2:16; + unsigned int fraction1:16; + unsigned int fraction0: 4; +#else + unsigned int fraction1:32; + unsigned int fraction0:20; +#endif + unsigned int exponent :11; + unsigned int sign : 1; + } number; + struct + { +#ifdef __SMALL_BITFIELDS + unsigned int function3:16; + unsigned int function2:16; + unsigned int function1:16; + unsigned int function0:3; +#else + unsigned int function1:32; + unsigned int function0:19; +#endif + unsigned int quiet:1; + unsigned int exponent: 11; + unsigned int sign : 1; + } nan; + struct + { + unsigned long lsw; + unsigned long msw; + } parts; + + long aslong[2]; + +} __ieee_double_shape_type; + +#endif + +#ifdef __IEEE_BIG_ENDIAN + +typedef union +{ + float value; + struct + { + unsigned int sign : 1; + unsigned int exponent: 8; + unsigned int fraction0: 7; + unsigned int fraction1: 16; + } number; + struct + { + unsigned int sign:1; + unsigned int exponent:8; + unsigned int quiet:1; + unsigned int function0:6; + unsigned int function1:16; + } nan; + long p1; + +} __ieee_float_shape_type; + +#endif + +#ifdef __IEEE_LITTLE_ENDIAN + +typedef union +{ + float value; + struct + { + unsigned int fraction0: 7; + unsigned int fraction1: 16; + unsigned int exponent: 8; + unsigned int sign : 1; + } number; + struct + { + unsigned int function1:16; + unsigned int function0:6; + unsigned int quiet:1; + unsigned int exponent:8; + unsigned int sign:1; + } nan; + long p1; + +} __ieee_float_shape_type; + +#endif + + + + + +/* FLOATING ROUNDING */ + +typedef int fp_rnd; +#define FP_RN 0 /* Round to nearest */ +#define FP_RM 1 /* Round down */ +#define FP_RP 2 /* Round up */ +#define FP_RZ 3 /* Round to zero (trunate) */ + +fp_rnd _EXFUN(fpgetround,(void)); +fp_rnd _EXFUN(fpsetround, (fp_rnd)); + +/* EXCEPTIONS */ + +typedef int fp_except; +#define FP_X_INV 0x10 /* Invalid operation */ +#define FP_X_DX 0x80 /* Divide by zero */ +#define FP_X_OFL 0x04 /* Overflow exception */ +#define FP_X_UFL 0x02 /* Underflow exception */ +#define FP_X_IMP 0x01 /* imprecise exception */ + +fp_except _EXFUN(fpgetmask,(void)); +fp_except _EXFUN(fpsetmask,(fp_except)); +fp_except _EXFUN(fpgetsticky,(void)); +fp_except _EXFUN(fpsetsticky, (fp_except)); + +/* INTEGER ROUNDING */ + +typedef int fp_rdi; +#define FP_RDI_TOZ 0 /* Round to Zero */ +#define FP_RDI_RD 1 /* Follow float mode */ + +fp_rdi _EXFUN(fpgetroundtoi,(void)); +fp_rdi _EXFUN(fpsetroundtoi,(fp_rdi)); + +#undef isnan +#undef isinf + +int _EXFUN(isnan, (double)); +int _EXFUN(isinf, (double)); +int _EXFUN(finite, (double)); + + + +int _EXFUN(isnanf, (float)); +int _EXFUN(isinff, (float)); +int _EXFUN(finitef, (float)); + +#define __IEEE_DBL_EXPBIAS 1023 +#define __IEEE_FLT_EXPBIAS 127 + +#define __IEEE_DBL_EXPLEN 11 +#define __IEEE_FLT_EXPLEN 8 + + +#define __IEEE_DBL_FRACLEN (64 - (__IEEE_DBL_EXPLEN + 1)) +#define __IEEE_FLT_FRACLEN (32 - (__IEEE_FLT_EXPLEN + 1)) + +#define __IEEE_DBL_MAXPOWTWO ((double)(1L << 32 - 2) * (1L << (32-11) - 32 + 1)) +#define __IEEE_FLT_MAXPOWTWO ((float)(1L << (32-8) - 1)) + +#define __IEEE_DBL_NAN_EXP 0x7ff +#define __IEEE_FLT_NAN_EXP 0xff + +#ifndef __ieeefp_isnanf +#define __ieeefp_isnanf(x) (((*(long *)&(x) & 0x7f800000L)==0x7f800000L) && \ + ((*(long *)&(x) & 0x007fffffL)!=0000000000L)) +#endif +#define isnanf(x) __ieeefp_isnanf(x) + +#ifndef __ieeefp_isinff +#define __ieeefp_isinff(x) (((*(long *)&(x) & 0x7f800000L)==0x7f800000L) && \ + ((*(long *)&(x) & 0x007fffffL)==0000000000L)) +#endif +#define isinff(x) __ieeefp_isinff(x) + +#ifndef __ieeefp_finitef +#define __ieeefp_finitef(x) (((*(long *)&(x) & 0x7f800000L)!=0x7f800000L)) +#endif +#define finitef(x) __ieeefp_finitef(x) + +#ifdef _DOUBLE_IS_32BITS +#undef __IEEE_DBL_EXPBIAS +#define __IEEE_DBL_EXPBIAS __IEEE_FLT_EXPBIAS + +#undef __IEEE_DBL_EXPLEN +#define __IEEE_DBL_EXPLEN __IEEE_FLT_EXPLEN + +#undef __IEEE_DBL_FRACLEN +#define __IEEE_DBL_FRACLEN __IEEE_FLT_FRACLEN + +#undef __IEEE_DBL_MAXPOWTWO +#define __IEEE_DBL_MAXPOWTWO __IEEE_FLT_MAXPOWTWO + +#undef __IEEE_DBL_NAN_EXP +#define __IEEE_DBL_NAN_EXP __IEEE_FLT_NAN_EXP + +#undef __ieee_double_shape_type +#define __ieee_double_shape_type __ieee_float_shape_type + +#endif /* _DOUBLE_IS_32BITS */ + +_END_STD_C + +#endif /* _IEEE_FP_H_ */ diff --git a/components/newlib/include/inttypes.h b/components/newlib/include/inttypes.h new file mode 100644 index 000000000..39bf13511 --- /dev/null +++ b/components/newlib/include/inttypes.h @@ -0,0 +1,319 @@ +/* + * Copyright (c) 2004, 2005 by + * Ralf Corsepius, Ulm/Germany. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + */ + +/** + * @file inttypes.h + */ + +#ifndef _INTTYPES_H +#define _INTTYPES_H + +#include +#include +#include +#define __need_wchar_t +#include + +#define __STRINGIFY(a) #a + +/* 8-bit types */ +#define __PRI8(x) __STRINGIFY(x) + +/* NOTICE: scanning 8-bit types requires use of the hh specifier + * which is only supported on newlib platforms that + * are built with C99 I/O format support enabled. If the flag in + * newlib.h hasn't been set during configuration to indicate this, the 8-bit + * scanning format macros are disabled here as they result in undefined + * behaviour which can include memory overwrite. Overriding the flag after the + * library has been built is not recommended as it will expose the underlying + * undefined behaviour. + */ + +#if defined(_WANT_IO_C99_FORMATS) + #define __SCN8(x) __STRINGIFY(hh##x) +#endif /* _WANT_IO_C99_FORMATS */ + + +#define PRId8 __PRI8(d) +#define PRIi8 __PRI8(i) +#define PRIo8 __PRI8(o) +#define PRIu8 __PRI8(u) +#define PRIx8 __PRI8(x) +#define PRIX8 __PRI8(X) + +/* Macros below are only enabled for a newlib built with C99 I/O format support. */ +#if defined(_WANT_IO_C99_FORMATS) + +#define SCNd8 __SCN8(d) +#define SCNi8 __SCN8(i) +#define SCNo8 __SCN8(o) +#define SCNu8 __SCN8(u) +#define SCNx8 __SCN8(x) + +#endif /* _WANT_IO_C99_FORMATS */ + + +#define PRIdLEAST8 __PRI8(d) +#define PRIiLEAST8 __PRI8(i) +#define PRIoLEAST8 __PRI8(o) +#define PRIuLEAST8 __PRI8(u) +#define PRIxLEAST8 __PRI8(x) +#define PRIXLEAST8 __PRI8(X) + +/* Macros below are only enabled for a newlib built with C99 I/O format support. */ +#if defined(_WANT_IO_C99_FORMATS) + + #define SCNdLEAST8 __SCN8(d) + #define SCNiLEAST8 __SCN8(i) + #define SCNoLEAST8 __SCN8(o) + #define SCNuLEAST8 __SCN8(u) + #define SCNxLEAST8 __SCN8(x) + +#endif /* _WANT_IO_C99_FORMATS */ + +#define PRIdFAST8 __PRI8(d) +#define PRIiFAST8 __PRI8(i) +#define PRIoFAST8 __PRI8(o) +#define PRIuFAST8 __PRI8(u) +#define PRIxFAST8 __PRI8(x) +#define PRIXFAST8 __PRI8(X) + +/* Macros below are only enabled for a newlib built with C99 I/O format support. */ +#if defined(_WANT_IO_C99_FORMATS) + + #define SCNdFAST8 __SCN8(d) + #define SCNiFAST8 __SCN8(i) + #define SCNoFAST8 __SCN8(o) + #define SCNuFAST8 __SCN8(u) + #define SCNxFAST8 __SCN8(x) + +#endif /* _WANT_IO_C99_FORMATS */ + +/* 16-bit types */ +#define __PRI16(x) __STRINGIFY(x) +#define __SCN16(x) __STRINGIFY(h##x) + + +#define PRId16 __PRI16(d) +#define PRIi16 __PRI16(i) +#define PRIo16 __PRI16(o) +#define PRIu16 __PRI16(u) +#define PRIx16 __PRI16(x) +#define PRIX16 __PRI16(X) + +#define SCNd16 __SCN16(d) +#define SCNi16 __SCN16(i) +#define SCNo16 __SCN16(o) +#define SCNu16 __SCN16(u) +#define SCNx16 __SCN16(x) + + +#define PRIdLEAST16 __PRI16(d) +#define PRIiLEAST16 __PRI16(i) +#define PRIoLEAST16 __PRI16(o) +#define PRIuLEAST16 __PRI16(u) +#define PRIxLEAST16 __PRI16(x) +#define PRIXLEAST16 __PRI16(X) + +#define SCNdLEAST16 __SCN16(d) +#define SCNiLEAST16 __SCN16(i) +#define SCNoLEAST16 __SCN16(o) +#define SCNuLEAST16 __SCN16(u) +#define SCNxLEAST16 __SCN16(x) + + +#define PRIdFAST16 __PRI16(d) +#define PRIiFAST16 __PRI16(i) +#define PRIoFAST16 __PRI16(o) +#define PRIuFAST16 __PRI16(u) +#define PRIxFAST16 __PRI16(x) +#define PRIXFAST16 __PRI16(X) + +#define SCNdFAST16 __SCN16(d) +#define SCNiFAST16 __SCN16(i) +#define SCNoFAST16 __SCN16(o) +#define SCNuFAST16 __SCN16(u) +#define SCNxFAST16 __SCN16(x) + +/* 32-bit types */ +#if __have_long32 +#define __PRI32(x) __STRINGIFY(l##x) +#define __SCN32(x) __STRINGIFY(l##x) +#else +#define __PRI32(x) __STRINGIFY(x) +#define __SCN32(x) __STRINGIFY(x) +#endif + +#define PRId32 __PRI32(d) +#define PRIi32 __PRI32(i) +#define PRIo32 __PRI32(o) +#define PRIu32 __PRI32(u) +#define PRIx32 __PRI32(x) +#define PRIX32 __PRI32(X) + +#define SCNd32 __SCN32(d) +#define SCNi32 __SCN32(i) +#define SCNo32 __SCN32(o) +#define SCNu32 __SCN32(u) +#define SCNx32 __SCN32(x) + + +#define PRIdLEAST32 __PRI32(d) +#define PRIiLEAST32 __PRI32(i) +#define PRIoLEAST32 __PRI32(o) +#define PRIuLEAST32 __PRI32(u) +#define PRIxLEAST32 __PRI32(x) +#define PRIXLEAST32 __PRI32(X) + +#define SCNdLEAST32 __SCN32(d) +#define SCNiLEAST32 __SCN32(i) +#define SCNoLEAST32 __SCN32(o) +#define SCNuLEAST32 __SCN32(u) +#define SCNxLEAST32 __SCN32(x) + + +#define PRIdFAST32 __PRI32(d) +#define PRIiFAST32 __PRI32(i) +#define PRIoFAST32 __PRI32(o) +#define PRIuFAST32 __PRI32(u) +#define PRIxFAST32 __PRI32(x) +#define PRIXFAST32 __PRI32(X) + +#define SCNdFAST32 __SCN32(d) +#define SCNiFAST32 __SCN32(i) +#define SCNoFAST32 __SCN32(o) +#define SCNuFAST32 __SCN32(u) +#define SCNxFAST32 __SCN32(x) + + +/* 64-bit types */ +#if __have_long64 +#define __PRI64(x) __STRINGIFY(l##x) +#define __SCN64(x) __STRINGIFY(l##x) +#elif __have_longlong64 +#define __PRI64(x) __STRINGIFY(ll##x) +#define __SCN64(x) __STRINGIFY(ll##x) +#else +#define __PRI64(x) __STRINGIFY(x) +#define __SCN64(x) __STRINGIFY(x) +#endif + +#define PRId64 __PRI64(d) +#define PRIi64 __PRI64(i) +#define PRIo64 __PRI64(o) +#define PRIu64 __PRI64(u) +#define PRIx64 __PRI64(x) +#define PRIX64 __PRI64(X) + +#define SCNd64 __SCN64(d) +#define SCNi64 __SCN64(i) +#define SCNo64 __SCN64(o) +#define SCNu64 __SCN64(u) +#define SCNx64 __SCN64(x) + +#if __int64_t_defined +#define PRIdLEAST64 __PRI64(d) +#define PRIiLEAST64 __PRI64(i) +#define PRIoLEAST64 __PRI64(o) +#define PRIuLEAST64 __PRI64(u) +#define PRIxLEAST64 __PRI64(x) +#define PRIXLEAST64 __PRI64(X) + +#define SCNdLEAST64 __SCN64(d) +#define SCNiLEAST64 __SCN64(i) +#define SCNoLEAST64 __SCN64(o) +#define SCNuLEAST64 __SCN64(u) +#define SCNxLEAST64 __SCN64(x) + + +#define PRIdFAST64 __PRI64(d) +#define PRIiFAST64 __PRI64(i) +#define PRIoFAST64 __PRI64(o) +#define PRIuFAST64 __PRI64(u) +#define PRIxFAST64 __PRI64(x) +#define PRIXFAST64 __PRI64(X) + +#define SCNdFAST64 __SCN64(d) +#define SCNiFAST64 __SCN64(i) +#define SCNoFAST64 __SCN64(o) +#define SCNuFAST64 __SCN64(u) +#define SCNxFAST64 __SCN64(x) +#endif + +/* max-bit types */ +#if __have_long64 +#define __PRIMAX(x) __STRINGIFY(l##x) +#define __SCNMAX(x) __STRINGIFY(l##x) +#elif __have_longlong64 +#define __PRIMAX(x) __STRINGIFY(ll##x) +#define __SCNMAX(x) __STRINGIFY(ll##x) +#else +#define __PRIMAX(x) __STRINGIFY(x) +#define __SCNMAX(x) __STRINGIFY(x) +#endif + +#define PRIdMAX __PRIMAX(d) +#define PRIiMAX __PRIMAX(i) +#define PRIoMAX __PRIMAX(o) +#define PRIuMAX __PRIMAX(u) +#define PRIxMAX __PRIMAX(x) +#define PRIXMAX __PRIMAX(X) + +#define SCNdMAX __SCNMAX(d) +#define SCNiMAX __SCNMAX(i) +#define SCNoMAX __SCNMAX(o) +#define SCNuMAX __SCNMAX(u) +#define SCNxMAX __SCNMAX(x) + +/* ptr types */ +#if defined(_UINTPTR_EQ_ULONGLONG) +# define __PRIPTR(x) __STRINGIFY(ll##x) +# define __SCNPTR(x) __STRINGIFY(ll##x) +#elif defined(_UINTPTR_EQ_ULONG) +# define __PRIPTR(x) __STRINGIFY(l##x) +# define __SCNPTR(x) __STRINGIFY(l##x) +#else +# define __PRIPTR(x) __STRINGIFY(x) +# define __SCNPTR(x) __STRINGIFY(x) +#endif + +#define PRIdPTR __PRIPTR(d) +#define PRIiPTR __PRIPTR(i) +#define PRIoPTR __PRIPTR(o) +#define PRIuPTR __PRIPTR(u) +#define PRIxPTR __PRIPTR(x) +#define PRIXPTR __PRIPTR(X) + +#define SCNdPTR __SCNPTR(d) +#define SCNiPTR __SCNPTR(i) +#define SCNoPTR __SCNPTR(o) +#define SCNuPTR __SCNPTR(u) +#define SCNxPTR __SCNPTR(x) + + +typedef struct { + intmax_t quot; + intmax_t rem; +} imaxdiv_t; + +#ifdef __cplusplus +extern "C" { +#endif + +extern intmax_t imaxabs(intmax_t j); +extern imaxdiv_t imaxdiv(intmax_t numer, intmax_t denomer); +extern intmax_t strtoimax(const char *__restrict, char **__restrict, int); +extern uintmax_t strtoumax(const char *__restrict, char **__restrict, int); +extern intmax_t wcstoimax(const wchar_t *__restrict, wchar_t **__restrict, int); +extern uintmax_t wcstoumax(const wchar_t *__restrict, wchar_t **__restrict, int); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/newlib/include/langinfo.h b/components/newlib/include/langinfo.h new file mode 100644 index 000000000..9040adeff --- /dev/null +++ b/components/newlib/include/langinfo.h @@ -0,0 +1,316 @@ +/*- + * Copyright (c) 2001 Alexey Zelkin + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD: src/include/langinfo.h,v 1.5 2002/03/23 17:24:53 imp Exp $ + */ + +#ifndef _LANGINFO_H_ +#define _LANGINFO_H_ + +#include +#include +#include + +typedef int nl_item; + +enum __nl_item +{ + /* POSIX and BSD defined items have to stick to the original values + to maintain backward compatibility. */ + _NL_CTYPE_CODESET_NAME = 0, /* codeset name */ +#define CODESET _NL_CTYPE_CODESET_NAME + D_T_FMT, /* string for formatting date and time */ +#define D_T_FMT D_T_FMT + D_FMT, /* date format string */ +#define D_FMT D_FMT + T_FMT, /* time format string */ +#define T_FMT T_FMT + T_FMT_AMPM, /* a.m. or p.m. time formatting string */ +#define T_FMT_AMPM T_FMT_AMPM + AM_STR, /* Ante Meridian affix */ +#define AM_STR AM_STR + PM_STR, /* Post Meridian affix */ +#define PM_STR PM_STR + +/* week day names */ + DAY_1, +#define DAY_1 DAY_1 + DAY_2, +#define DAY_2 DAY_2 + DAY_3, +#define DAY_3 DAY_3 + DAY_4, +#define DAY_4 DAY_4 + DAY_5, +#define DAY_5 DAY_5 + DAY_6, +#define DAY_6 DAY_6 + DAY_7, +#define DAY_7 DAY_7 + +/* abbreviated week day names */ + ABDAY_1, +#define ABDAY_1 ABDAY_1 + ABDAY_2, +#define ABDAY_2 ABDAY_2 + ABDAY_3, +#define ABDAY_3 ABDAY_3 + ABDAY_4, +#define ABDAY_4 ABDAY_4 + ABDAY_5, +#define ABDAY_5 ABDAY_5 + ABDAY_6, +#define ABDAY_6 ABDAY_6 + ABDAY_7, +#define ABDAY_7 ABDAY_7 + +/* month names */ + MON_1, +#define MON_1 MON_1 + MON_2, +#define MON_2 MON_2 + MON_3, +#define MON_3 MON_3 + MON_4, +#define MON_4 MON_4 + MON_5, +#define MON_5 MON_5 + MON_6, +#define MON_6 MON_6 + MON_7, +#define MON_7 MON_7 + MON_8, +#define MON_8 MON_8 + MON_9, +#define MON_9 MON_9 + MON_10, +#define MON_10 MON_10 + MON_11, +#define MON_11 MON_11 + MON_12, +#define MON_12 MON_12 + +/* abbreviated month names */ + ABMON_1, +#define ABMON_1 ABMON_1 + ABMON_2, +#define ABMON_2 ABMON_2 + ABMON_3, +#define ABMON_3 ABMON_3 + ABMON_4, +#define ABMON_4 ABMON_4 + ABMON_5, +#define ABMON_5 ABMON_5 + ABMON_6, +#define ABMON_6 ABMON_6 + ABMON_7, +#define ABMON_7 ABMON_7 + ABMON_8, +#define ABMON_8 ABMON_8 + ABMON_9, +#define ABMON_9 ABMON_9 + ABMON_10, +#define ABMON_10 ABMON_10 + ABMON_11, +#define ABMON_11 ABMON_11 + ABMON_12, +#define ABMON_12 ABMON_12 + + ERA, /* era description segments */ +#define ERA ERA + ERA_D_FMT, /* era date format string */ +#define ERA_D_FMT ERA_D_FMT + ERA_D_T_FMT, /* era date and time format string */ +#define ERA_D_T_FMT ERA_D_T_FMT + ERA_T_FMT, /* era time format string */ +#define ERA_T_FMT ERA_T_FMT + ALT_DIGITS, /* alternative symbols for digits */ +#define ALT_DIGITS ALT_DIGITS + + RADIXCHAR, /* radix char */ +#define RADIXCHAR RADIXCHAR + THOUSEP, /* separator for thousands */ +#define THOUSEP THOUSEP + + YESEXPR, /* affirmative response expression */ +#define YESEXPR YESEXPR + NOEXPR, /* negative response expression */ +#define NOEXPR NOEXPR + YESSTR, /* affirmative response for yes/no queries */ +#define YESSTR YESSTR + NOSTR, /* negative response for yes/no queries */ +#define NOSTR NOSTR + + CRNCYSTR, /* currency symbol */ +#define CRNCYSTR CRNCYSTR + + D_MD_ORDER, /* month/day order (BSD extension) */ +#define D_MD_ORDER D_MD_ORDER + + _NL_TIME_DATE_FMT = 84, /* date fmt used by date(1) (GNU extension) */ +#define _DATE_FMT _NL_TIME_DATE_FMT + +#ifdef __HAVE_LOCALE_INFO__ + _NL_CTYPE_MB_CUR_MAX, + _NL_MESSAGES_CODESET, + +#ifdef __HAVE_LOCALE_INFO_EXTENDED__ + + /* NOTE: + + Always maintain the order and position of existing entries! + Always append new entry to the list, prior to the definition + of _NL_LOCALE_EXTENDED_LAST_ENTRY. */ + + _NL_LOCALE_EXTENDED_FIRST_ENTRY, + + _NL_CTYPE_OUTDIGITS0_MB, + _NL_CTYPE_OUTDIGITS1_MB, + _NL_CTYPE_OUTDIGITS2_MB, + _NL_CTYPE_OUTDIGITS3_MB, + _NL_CTYPE_OUTDIGITS4_MB, + _NL_CTYPE_OUTDIGITS5_MB, + _NL_CTYPE_OUTDIGITS6_MB, + _NL_CTYPE_OUTDIGITS7_MB, + _NL_CTYPE_OUTDIGITS8_MB, + _NL_CTYPE_OUTDIGITS9_MB, + _NL_CTYPE_OUTDIGITS0_WC, + _NL_CTYPE_OUTDIGITS1_WC, + _NL_CTYPE_OUTDIGITS2_WC, + _NL_CTYPE_OUTDIGITS3_WC, + _NL_CTYPE_OUTDIGITS4_WC, + _NL_CTYPE_OUTDIGITS5_WC, + _NL_CTYPE_OUTDIGITS6_WC, + _NL_CTYPE_OUTDIGITS7_WC, + _NL_CTYPE_OUTDIGITS8_WC, + _NL_CTYPE_OUTDIGITS9_WC, + + _NL_TIME_CODESET, + _NL_TIME_WMON_1, + _NL_TIME_WMON_2, + _NL_TIME_WMON_3, + _NL_TIME_WMON_4, + _NL_TIME_WMON_5, + _NL_TIME_WMON_6, + _NL_TIME_WMON_7, + _NL_TIME_WMON_8, + _NL_TIME_WMON_9, + _NL_TIME_WMON_10, + _NL_TIME_WMON_11, + _NL_TIME_WMON_12, + _NL_TIME_WMONTH_1, + _NL_TIME_WMONTH_2, + _NL_TIME_WMONTH_3, + _NL_TIME_WMONTH_4, + _NL_TIME_WMONTH_5, + _NL_TIME_WMONTH_6, + _NL_TIME_WMONTH_7, + _NL_TIME_WMONTH_8, + _NL_TIME_WMONTH_9, + _NL_TIME_WMONTH_10, + _NL_TIME_WMONTH_11, + _NL_TIME_WMONTH_12, + _NL_TIME_WWDAY_1, + _NL_TIME_WWDAY_2, + _NL_TIME_WWDAY_3, + _NL_TIME_WWDAY_4, + _NL_TIME_WWDAY_5, + _NL_TIME_WWDAY_6, + _NL_TIME_WWDAY_7, + _NL_TIME_WWEEKDAY_1, + _NL_TIME_WWEEKDAY_2, + _NL_TIME_WWEEKDAY_3, + _NL_TIME_WWEEKDAY_4, + _NL_TIME_WWEEKDAY_5, + _NL_TIME_WWEEKDAY_6, + _NL_TIME_WWEEKDAY_7, + _NL_TIME_WT_FMT, + _NL_TIME_WD_FMT, + _NL_TIME_WD_T_FMT, + _NL_TIME_WAM_STR, + _NL_TIME_WPM_STR, + _NL_TIME_WDATE_FMT, + _NL_TIME_WT_FMT_AMPM, + _NL_TIME_WERA, + _NL_TIME_WERA_D_FMT, + _NL_TIME_WERA_D_T_FMT, + _NL_TIME_WERA_T_FMT, + _NL_TIME_WALT_DIGITS, + + _NL_NUMERIC_CODESET, + _NL_NUMERIC_GROUPING, + _NL_NUMERIC_DECIMAL_POINT_WC, + _NL_NUMERIC_THOUSANDS_SEP_WC, + + _NL_MONETARY_INT_CURR_SYMBOL, + _NL_MONETARY_CURRENCY_SYMBOL, + _NL_MONETARY_MON_DECIMAL_POINT, + _NL_MONETARY_MON_THOUSANDS_SEP, + _NL_MONETARY_MON_GROUPING, + _NL_MONETARY_POSITIVE_SIGN, + _NL_MONETARY_NEGATIVE_SIGN, + _NL_MONETARY_INT_FRAC_DIGITS, + _NL_MONETARY_FRAC_DIGITS, + _NL_MONETARY_P_CS_PRECEDES, + _NL_MONETARY_P_SEP_BY_SPACE, + _NL_MONETARY_N_CS_PRECEDES, + _NL_MONETARY_N_SEP_BY_SPACE, + _NL_MONETARY_P_SIGN_POSN, + _NL_MONETARY_N_SIGN_POSN, + _NL_MONETARY_INT_P_CS_PRECEDES, + _NL_MONETARY_INT_P_SEP_BY_SPACE, + _NL_MONETARY_INT_N_CS_PRECEDES, + _NL_MONETARY_INT_N_SEP_BY_SPACE, + _NL_MONETARY_INT_P_SIGN_POSN, + _NL_MONETARY_INT_N_SIGN_POSN, + _NL_MONETARY_CODESET, + _NL_MONETARY_WINT_CURR_SYMBOL, + _NL_MONETARY_WCURRENCY_SYMBOL, + _NL_MONETARY_WMON_DECIMAL_POINT, + _NL_MONETARY_WMON_THOUSANDS_SEP, + _NL_MONETARY_WPOSITIVE_SIGN, + _NL_MONETARY_WNEGATIVE_SIGN, + + _NL_MESSAGES_WYESEXPR, + _NL_MESSAGES_WNOEXPR, + _NL_MESSAGES_WYESSTR, + _NL_MESSAGES_WNOSTR, + + _NL_COLLATE_CODESET, + + /* This MUST be the last entry since it's used to check for an array + index in nl_langinfo(). */ + _NL_LOCALE_EXTENDED_LAST_ENTRY + +#endif /* __HAVE_LOCALE_INFO_EXTENDED__ */ +#endif /* __HAVE_LOCALE_INFO__ */ + +}; + +__BEGIN_DECLS +char *nl_langinfo(nl_item); +__END_DECLS + +#endif /* !_LANGINFO_H_ */ diff --git a/components/newlib/include/libgen.h b/components/newlib/include/libgen.h new file mode 100644 index 000000000..abfab0e5c --- /dev/null +++ b/components/newlib/include/libgen.h @@ -0,0 +1,23 @@ +/* + * libgen.h - defined by XPG4 + */ + +#ifndef _LIBGEN_H_ +#define _LIBGEN_H_ + +#include "_ansi.h" +#include + +#ifdef __cplusplus +extern "C" { +#endif + +char *_EXFUN(basename, (char *)); +char *_EXFUN(dirname, (char *)); + +#ifdef __cplusplus +} +#endif + +#endif /* _LIBGEN_H_ */ + diff --git a/components/newlib/include/limits.h b/components/newlib/include/limits.h new file mode 100644 index 000000000..190f1f783 --- /dev/null +++ b/components/newlib/include/limits.h @@ -0,0 +1,146 @@ +#ifndef _LIBC_LIMITS_H_ +# define _LIBC_LIMITS_H_ 1 + +#include + +# ifdef _MB_LEN_MAX +# define MB_LEN_MAX _MB_LEN_MAX +# else +# define MB_LEN_MAX 1 +# endif + +/* Maximum number of positional arguments, if _WANT_IO_POS_ARGS. */ +# ifndef NL_ARGMAX +# define NL_ARGMAX 32 +# endif + +/* if do not have #include_next support, then we + have to define the limits here. */ +# if !defined __GNUC__ || __GNUC__ < 2 + +# ifndef _LIMITS_H +# define _LIMITS_H 1 + +# include + +/* Number of bits in a `char'. */ +# undef CHAR_BIT +# define CHAR_BIT 8 + +/* Minimum and maximum values a `signed char' can hold. */ +# undef SCHAR_MIN +# define SCHAR_MIN (-128) +# undef SCHAR_MAX +# define SCHAR_MAX 127 + +/* Maximum value an `unsigned char' can hold. (Minimum is 0). */ +# undef UCHAR_MAX +# define UCHAR_MAX 255 + +/* Minimum and maximum values a `char' can hold. */ +# ifdef __CHAR_UNSIGNED__ +# undef CHAR_MIN +# define CHAR_MIN 0 +# undef CHAR_MAX +# define CHAR_MAX 255 +# else +# undef CHAR_MIN +# define CHAR_MIN (-128) +# undef CHAR_MAX +# define CHAR_MAX 127 +# endif + +/* Minimum and maximum values a `signed short int' can hold. */ +# undef SHRT_MIN +/* For the sake of 16 bit hosts, we may not use -32768 */ +# define SHRT_MIN (-32767-1) +# undef SHRT_MAX +# define SHRT_MAX 32767 + +/* Maximum value an `unsigned short int' can hold. (Minimum is 0). */ +# undef USHRT_MAX +# define USHRT_MAX 65535 + +/* Minimum and maximum values a `signed int' can hold. */ +# ifndef __INT_MAX__ +# define __INT_MAX__ 2147483647 +# endif +# undef INT_MIN +# define INT_MIN (-INT_MAX-1) +# undef INT_MAX +# define INT_MAX __INT_MAX__ + +/* Maximum value an `unsigned int' can hold. (Minimum is 0). */ +# undef UINT_MAX +# define UINT_MAX (INT_MAX * 2U + 1) + +/* Minimum and maximum values a `signed long int' can hold. + (Same as `int'). */ +# ifndef __LONG_MAX__ +# if defined (__alpha__) || (defined (__sparc__) && defined(__arch64__)) || defined (__sparcv9) +# define __LONG_MAX__ 9223372036854775807L +# else +# define __LONG_MAX__ 2147483647L +# endif /* __alpha__ || sparc64 */ +# endif +# undef LONG_MIN +# define LONG_MIN (-LONG_MAX-1) +# undef LONG_MAX +# define LONG_MAX __LONG_MAX__ + +/* Maximum value an `unsigned long int' can hold. (Minimum is 0). */ +# undef ULONG_MAX +# define ULONG_MAX (LONG_MAX * 2UL + 1) + +# ifndef __LONG_LONG_MAX__ +# define __LONG_LONG_MAX__ 9223372036854775807LL +# endif + +# if (defined (__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +/* Minimum and maximum values a `signed long long int' can hold. */ +# undef LLONG_MIN +# define LLONG_MIN (-LLONG_MAX-1) +# undef LLONG_MAX +# define LLONG_MAX __LONG_LONG_MAX__ + +/* Maximum value an `unsigned long long int' can hold. (Minimum is 0). */ +# undef ULLONG_MAX +# define ULLONG_MAX (LLONG_MAX * 2ULL + 1) +# endif + +# if defined (__GNU_LIBRARY__) ? defined (__USE_GNU) : !defined (__STRICT_ANSI__) +/* Minimum and maximum values a `signed long long int' can hold. */ +# undef LONG_LONG_MIN +# define LONG_LONG_MIN (-LONG_LONG_MAX-1) +# undef LONG_LONG_MAX +# define LONG_LONG_MAX __LONG_LONG_MAX__ + +/* Maximum value an `unsigned long long int' can hold. (Minimum is 0). */ +# undef ULONG_LONG_MAX +# define ULONG_LONG_MAX (LONG_LONG_MAX * 2ULL + 1) +# endif + +# endif /* _LIMITS_H */ +# endif /* GCC 2. */ + +#endif /* !_LIBC_LIMITS_H_ */ + +#if defined __GNUC__ && !defined _GCC_LIMITS_H_ +/* `_GCC_LIMITS_H_' is what GCC's file defines. */ +# include_next +#endif /* __GNUC__ && !_GCC_LIMITS_H_ */ + +#ifndef _POSIX2_RE_DUP_MAX +/* The maximum number of repeated occurrences of a regular expression + * permitted when using the interval notation `\{M,N\}'. */ +#define _POSIX2_RE_DUP_MAX 255 +#endif /* _POSIX2_RE_DUP_MAX */ + +#ifndef ARG_MAX +#define ARG_MAX 4096 +#endif + +#ifndef PATH_MAX +#define PATH_MAX 4096 +#endif diff --git a/components/newlib/include/locale.h b/components/newlib/include/locale.h new file mode 100644 index 000000000..cbd658e41 --- /dev/null +++ b/components/newlib/include/locale.h @@ -0,0 +1,64 @@ +/* + locale.h + Values appropriate for the formatting of monetary and other + numberic quantities. +*/ + +#ifndef _LOCALE_H_ +#define _LOCALE_H_ + +#include "_ansi.h" + +#define __need_NULL +#include + +#define LC_ALL 0 +#define LC_COLLATE 1 +#define LC_CTYPE 2 +#define LC_MONETARY 3 +#define LC_NUMERIC 4 +#define LC_TIME 5 +#define LC_MESSAGES 6 + +_BEGIN_STD_C + +struct lconv +{ + char *decimal_point; + char *thousands_sep; + char *grouping; + char *int_curr_symbol; + char *currency_symbol; + char *mon_decimal_point; + char *mon_thousands_sep; + char *mon_grouping; + char *positive_sign; + char *negative_sign; + char int_frac_digits; + char frac_digits; + char p_cs_precedes; + char p_sep_by_space; + char n_cs_precedes; + char n_sep_by_space; + char p_sign_posn; + char n_sign_posn; + char int_n_cs_precedes; + char int_n_sep_by_space; + char int_n_sign_posn; + char int_p_cs_precedes; + char int_p_sep_by_space; + char int_p_sign_posn; +}; + +#ifndef _REENT_ONLY +char *_EXFUN(setlocale,(int category, const char *locale)); +struct lconv *_EXFUN(localeconv,(void)); +#endif + +struct _reent; +char *_EXFUN(_setlocale_r,(struct _reent *, int category, const char *locale)); +struct lconv *_EXFUN(_localeconv_r,(struct _reent *)); + +_END_STD_C + +#endif /* _LOCALE_H_ */ diff --git a/components/newlib/include/machine/_default_types.h b/components/newlib/include/machine/_default_types.h new file mode 100644 index 000000000..03bdc523e --- /dev/null +++ b/components/newlib/include/machine/_default_types.h @@ -0,0 +1,56 @@ +/* + * _default_types implementation for xtensa lx106 arch + * + * Simplified version of generic _default_types.h, ignores gcc + * built-in standard types. + */ + +#ifndef _MACHINE__DEFAULT_TYPES_H +#define _MACHINE__DEFAULT_TYPES_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +typedef signed char __int8_t ; +typedef unsigned char __uint8_t ; +#define ___int8_t_defined 1 + +typedef signed short __int16_t; +typedef unsigned short __uint16_t; +#define ___int16_t_defined 1 + +typedef signed int __int32_t; +typedef unsigned int __uint32_t; +#define ___int32_t_defined 1 + +typedef signed long long __int64_t; +typedef unsigned long long __uint64_t; +#define ___int64_t_defined 1 + +typedef __int8_t __int_least8_t; +typedef __uint8_t __uint_least8_t; +#define ___int_least8_t_defined + +typedef __int16_t __int_least16_t; +typedef __uint16_t __uint_least16_t; +#define ___int_least16_t_defined + +typedef __int32_t __int_least32_t; +typedef __uint32_t __uint_least32_t; +#define ___int_least32_t_defined + +typedef __int64_t __int_least64_t; +typedef __uint64_t __uint_least64_t; +#define ___int_least64_t_defined + +typedef __INTPTR_TYPE__ __intptr_t; +typedef __UINTPTR_TYPE__ __uintptr_t; + +#ifdef __cplusplus +} +#endif + +#endif /* _MACHINE__DEFAULT_TYPES_H */ diff --git a/components/newlib/include/machine/_types.h b/components/newlib/include/machine/_types.h new file mode 100644 index 000000000..17e6d51e3 --- /dev/null +++ b/components/newlib/include/machine/_types.h @@ -0,0 +1,8 @@ +/* + * $Id$ + */ + +#ifndef _MACHINE__TYPES_H +#define _MACHINE__TYPES_H +#include +#endif diff --git a/components/newlib/include/machine/ansi.h b/components/newlib/include/machine/ansi.h new file mode 100644 index 000000000..737b6d066 --- /dev/null +++ b/components/newlib/include/machine/ansi.h @@ -0,0 +1 @@ +/* dummy header file to support BSD compiler */ diff --git a/components/newlib/include/machine/endian.h b/components/newlib/include/machine/endian.h new file mode 100644 index 000000000..07ebc8f63 --- /dev/null +++ b/components/newlib/include/machine/endian.h @@ -0,0 +1,20 @@ +#ifndef __MACHINE_ENDIAN_H__ + +#include + +#ifndef BIG_ENDIAN +#define BIG_ENDIAN 4321 +#endif +#ifndef LITTLE_ENDIAN +#define LITTLE_ENDIAN 1234 +#endif + +#ifndef BYTE_ORDER +#if defined(__IEEE_LITTLE_ENDIAN) || defined(__IEEE_BYTES_LITTLE_ENDIAN) +#define BYTE_ORDER LITTLE_ENDIAN +#else +#define BYTE_ORDER BIG_ENDIAN +#endif +#endif + +#endif /* __MACHINE_ENDIAN_H__ */ diff --git a/components/newlib/include/machine/fastmath.h b/components/newlib/include/machine/fastmath.h new file mode 100644 index 000000000..b13befa22 --- /dev/null +++ b/components/newlib/include/machine/fastmath.h @@ -0,0 +1,100 @@ +#ifdef __sysvnecv70_target +double EXFUN(fast_sin,(double)); +double EXFUN(fast_cos,(double)); +double EXFUN(fast_tan,(double)); + +double EXFUN(fast_asin,(double)); +double EXFUN(fast_acos,(double)); +double EXFUN(fast_atan,(double)); + +double EXFUN(fast_sinh,(double)); +double EXFUN(fast_cosh,(double)); +double EXFUN(fast_tanh,(double)); + +double EXFUN(fast_asinh,(double)); +double EXFUN(fast_acosh,(double)); +double EXFUN(fast_atanh,(double)); + +double EXFUN(fast_abs,(double)); +double EXFUN(fast_sqrt,(double)); +double EXFUN(fast_exp2,(double)); +double EXFUN(fast_exp10,(double)); +double EXFUN(fast_expe,(double)); +double EXFUN(fast_log10,(double)); +double EXFUN(fast_log2,(double)); +double EXFUN(fast_loge,(double)); + + +#define sin(x) fast_sin(x) +#define cos(x) fast_cos(x) +#define tan(x) fast_tan(x) +#define asin(x) fast_asin(x) +#define acos(x) fast_acos(x) +#define atan(x) fast_atan(x) +#define sinh(x) fast_sinh(x) +#define cosh(x) fast_cosh(x) +#define tanh(x) fast_tanh(x) +#define asinh(x) fast_asinh(x) +#define acosh(x) fast_acosh(x) +#define atanh(x) fast_atanh(x) +#define abs(x) fast_abs(x) +#define sqrt(x) fast_sqrt(x) +#define exp2(x) fast_exp2(x) +#define exp10(x) fast_exp10(x) +#define expe(x) fast_expe(x) +#define log10(x) fast_log10(x) +#define log2(x) fast_log2(x) +#define loge(x) fast_loge(x) + +#ifdef _HAVE_STDC +/* These functions are in assembler, they really do take floats. This + can only be used with a real ANSI compiler */ + +float EXFUN(fast_sinf,(float)); +float EXFUN(fast_cosf,(float)); +float EXFUN(fast_tanf,(float)); + +float EXFUN(fast_asinf,(float)); +float EXFUN(fast_acosf,(float)); +float EXFUN(fast_atanf,(float)); + +float EXFUN(fast_sinhf,(float)); +float EXFUN(fast_coshf,(float)); +float EXFUN(fast_tanhf,(float)); + +float EXFUN(fast_asinhf,(float)); +float EXFUN(fast_acoshf,(float)); +float EXFUN(fast_atanhf,(float)); + +float EXFUN(fast_absf,(float)); +float EXFUN(fast_sqrtf,(float)); +float EXFUN(fast_exp2f,(float)); +float EXFUN(fast_exp10f,(float)); +float EXFUN(fast_expef,(float)); +float EXFUN(fast_log10f,(float)); +float EXFUN(fast_log2f,(float)); +float EXFUN(fast_logef,(float)); +#define sinf(x) fast_sinf(x) +#define cosf(x) fast_cosf(x) +#define tanf(x) fast_tanf(x) +#define asinf(x) fast_asinf(x) +#define acosf(x) fast_acosf(x) +#define atanf(x) fast_atanf(x) +#define sinhf(x) fast_sinhf(x) +#define coshf(x) fast_coshf(x) +#define tanhf(x) fast_tanhf(x) +#define asinhf(x) fast_asinhf(x) +#define acoshf(x) fast_acoshf(x) +#define atanhf(x) fast_atanhf(x) +#define absf(x) fast_absf(x) +#define sqrtf(x) fast_sqrtf(x) +#define exp2f(x) fast_exp2f(x) +#define exp10f(x) fast_exp10f(x) +#define expef(x) fast_expef(x) +#define log10f(x) fast_log10f(x) +#define log2f(x) fast_log2f(x) +#define logef(x) fast_logef(x) +#endif +/* Override the functions defined in math.h */ +#endif /* __sysvnecv70_target */ + diff --git a/components/newlib/include/machine/ieeefp.h b/components/newlib/include/machine/ieeefp.h new file mode 100644 index 000000000..f11dc0535 --- /dev/null +++ b/components/newlib/include/machine/ieeefp.h @@ -0,0 +1,434 @@ +#ifndef __IEEE_BIG_ENDIAN +#ifndef __IEEE_LITTLE_ENDIAN + +/* This file can define macros to choose variations of the IEEE float + format: + + _FLT_LARGEST_EXPONENT_IS_NORMAL + + Defined if the float format uses the largest exponent for finite + numbers rather than NaN and infinity representations. Such a + format cannot represent NaNs or infinities at all, but it's FLT_MAX + is twice the IEEE value. + + _FLT_NO_DENORMALS + + Defined if the float format does not support IEEE denormals. Every + float with a zero exponent is taken to be a zero representation. + + ??? At the moment, there are no equivalent macros above for doubles and + the macros are not fully supported by --enable-newlib-hw-fp. + + __IEEE_BIG_ENDIAN + + Defined if the float format is big endian. This is mutually exclusive + with __IEEE_LITTLE_ENDIAN. + + __IEEE_LITTLE_ENDIAN + + Defined if the float format is little endian. This is mutually exclusive + with __IEEE_BIG_ENDIAN. + + Note that one of __IEEE_BIG_ENDIAN or __IEEE_LITTLE_ENDIAN must be specified for a + platform or error will occur. + + __IEEE_BYTES_LITTLE_ENDIAN + + This flag is used in conjunction with __IEEE_BIG_ENDIAN to describe a situation + whereby multiple words of an IEEE floating point are in big endian order, but the + words themselves are little endian with respect to the bytes. + + _DOUBLE_IS_32BITS + + This is used on platforms that support double by using the 32-bit IEEE + float type. + + _FLOAT_ARG + + This represents what type a float arg is passed as. It is used when the type is + not promoted to double. + +*/ + +#if (defined(__arm__) || defined(__thumb__)) && !defined(__MAVERICK__) +/* ARM traditionally used big-endian words; and within those words the + byte ordering was big or little endian depending upon the target. + Modern floating-point formats are naturally ordered; in this case + __VFP_FP__ will be defined, even if soft-float. */ +#ifdef __VFP_FP__ +# ifdef __ARMEL__ +# define __IEEE_LITTLE_ENDIAN +# else +# define __IEEE_BIG_ENDIAN +# endif +#else +# define __IEEE_BIG_ENDIAN +# ifdef __ARMEL__ +# define __IEEE_BYTES_LITTLE_ENDIAN +# endif +#endif +#endif + +#if defined (__aarch64__) +#if defined (__AARCH64EL__) +#define __IEEE_LITTLE_ENDIAN +#else +#define __IEEE_BIG_ENDIAN +#endif +#endif + +#ifdef __epiphany__ +#define __IEEE_LITTLE_ENDIAN +#define Sudden_Underflow 1 +#endif + +#ifdef __hppa__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __nds32__ +#ifdef __big_endian__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __SPU__ +#define __IEEE_BIG_ENDIAN + +#define isfinite(__y) \ + (__extension__ ({int __cy; \ + (sizeof (__y) == sizeof (float)) ? (1) : \ + (__cy = fpclassify(__y)) != FP_INFINITE && __cy != FP_NAN;})) + +#define isinf(__x) ((sizeof (__x) == sizeof (float)) ? (0) : __isinfd(__x)) +#define isnan(__x) ((sizeof (__x) == sizeof (float)) ? (0) : __isnand(__x)) + +/* + * Macros for use in ieeefp.h. We can't just define the real ones here + * (like those above) as we have name space issues when this is *not* + * included via generic the ieeefp.h. + */ +#define __ieeefp_isnanf(x) 0 +#define __ieeefp_isinff(x) 0 +#define __ieeefp_finitef(x) 1 +#endif + +#ifdef __sparc__ +#ifdef __LITTLE_ENDIAN_DATA__ +#define __IEEE_LITTLE_ENDIAN +#else +#define __IEEE_BIG_ENDIAN +#endif +#endif + +#if defined(__m68k__) || defined(__mc68000__) +#define __IEEE_BIG_ENDIAN +#endif + +#if defined(__mc68hc11__) || defined(__mc68hc12__) || defined(__mc68hc1x__) +#define __IEEE_BIG_ENDIAN +#ifdef __HAVE_SHORT_DOUBLE__ +# define _DOUBLE_IS_32BITS +#endif +#endif + +#if defined (__H8300__) || defined (__H8300H__) || defined (__H8300S__) || defined (__H8500__) || defined (__H8300SX__) +#define __IEEE_BIG_ENDIAN +#define _FLOAT_ARG float +#define _DOUBLE_IS_32BITS +#endif + +#if defined (__xc16x__) || defined (__xc16xL__) || defined (__xc16xS__) +#define __IEEE_LITTLE_ENDIAN +#define _FLOAT_ARG float +#define _DOUBLE_IS_32BITS +#endif + + +#ifdef __sh__ +#ifdef __LITTLE_ENDIAN__ +#define __IEEE_LITTLE_ENDIAN +#else +#define __IEEE_BIG_ENDIAN +#endif +#if defined(__SH2E__) || defined(__SH3E__) || defined(__SH4_SINGLE_ONLY__) || defined(__SH2A_SINGLE_ONLY__) +#define _DOUBLE_IS_32BITS +#endif +#endif + +#ifdef _AM29K +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef _WIN32 +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __i386__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __i960__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __lm32__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __M32R__ +#define __IEEE_BIG_ENDIAN +#endif + +#if defined(_C4x) || defined(_C3x) +#define __IEEE_BIG_ENDIAN +#define _DOUBLE_IS_32BITS +#endif + +#ifdef __TMS320C6X__ +#ifdef _BIG_ENDIAN +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __TIC80__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __MIPSEL__ +#define __IEEE_LITTLE_ENDIAN +#endif +#ifdef __MIPSEB__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __MMIX__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __D30V__ +#define __IEEE_BIG_ENDIAN +#endif + +/* necv70 was __IEEE_LITTLE_ENDIAN. */ + +#ifdef __W65__ +#define __IEEE_LITTLE_ENDIAN +#define _DOUBLE_IS_32BITS +#endif + +#if defined(__Z8001__) || defined(__Z8002__) +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __m88k__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __mn10300__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __mn10200__ +#define __IEEE_LITTLE_ENDIAN +#define _DOUBLE_IS_32BITS +#endif + +#ifdef __v800 +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __v850 +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __D10V__ +#define __IEEE_BIG_ENDIAN +#if __DOUBLE__ == 32 +#define _DOUBLE_IS_32BITS +#endif +#endif + +#ifdef __PPC__ +#if (defined(_BIG_ENDIAN) && _BIG_ENDIAN) || (defined(_AIX) && _AIX) +#define __IEEE_BIG_ENDIAN +#else +#if (defined(_LITTLE_ENDIAN) && _LITTLE_ENDIAN) || (defined(__sun__) && __sun__) || (defined(_WIN32) && _WIN32) +#define __IEEE_LITTLE_ENDIAN +#endif +#endif +#endif + +#ifdef __xstormy16__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __arc__ +#ifdef __big_endian__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __CRX__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __fr30__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __mcore__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __mt__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __frv__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __moxie__ +#ifdef __MOXIE_BIG_ENDIAN__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __ia64__ +#ifdef __BIG_ENDIAN__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __AVR__ +#define __IEEE_LITTLE_ENDIAN +#define _DOUBLE_IS_32BITS +#endif + +#if defined(__or1k__) || defined(__OR1K__) || defined(__OR1KND__) +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __IP2K__ +#define __IEEE_BIG_ENDIAN +#define __SMALL_BITFIELDS +#define _DOUBLE_IS_32BITS +#endif + +#ifdef __iq2000__ +#define __IEEE_BIG_ENDIAN +#endif + +#ifdef __MAVERICK__ +#ifdef __ARMEL__ +# define __IEEE_LITTLE_ENDIAN +#else /* must be __ARMEB__ */ +# define __IEEE_BIG_ENDIAN +#endif /* __ARMEL__ */ +#endif /* __MAVERICK__ */ + +#ifdef __m32c__ +#define __IEEE_LITTLE_ENDIAN +#define __SMALL_BITFIELDS +#endif + +#ifdef __CRIS__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __BFIN__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __x86_64__ +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifdef __mep__ +#ifdef __LITTLE_ENDIAN__ +#define __IEEE_LITTLE_ENDIAN +#else +#define __IEEE_BIG_ENDIAN +#endif +#endif + +#ifdef __MICROBLAZE__ +#ifndef __MICROBLAZEEL__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif +#endif + +#ifdef __MSP430__ +#define __IEEE_LITTLE_ENDIAN +#define __SMALL_BITFIELDS /* 16 Bit INT */ +#endif + +#ifdef __RL78__ +#define __IEEE_LITTLE_ENDIAN +#define __SMALL_BITFIELDS /* 16 Bit INT */ +#ifndef __RL78_64BIT_DOUBLES__ +#define _DOUBLE_IS_32BITS +#endif +#endif + +#ifdef __RX__ + +#ifdef __RX_BIG_ENDIAN__ +#define __IEEE_BIG_ENDIAN +#else +#define __IEEE_LITTLE_ENDIAN +#endif + +#ifndef __RX_64BIT_DOUBLES__ +#define _DOUBLE_IS_32BITS +#endif + +#ifdef __RX_16BIT_INTS__ +#define __SMALL_BITFIELDS +#endif + +#endif + +#if (defined(__CR16__) || defined(__CR16C__) ||defined(__CR16CP__)) +#define __IEEE_LITTLE_ENDIAN +#define __SMALL_BITFIELDS /* 16 Bit INT */ +#endif + +#ifdef __NIOS2__ +# ifdef __nios2_big_endian__ +# define __IEEE_BIG_ENDIAN +# else +# define __IEEE_LITTLE_ENDIAN +# endif +#endif + +#if (defined(__XTENSA__)) +# ifdef __XTENSA_EB__ +# define __IEEE_BIG_ENDIAN +# else +# define __IEEE_LITTLE_ENDIAN +# endif +#endif + +#ifndef __IEEE_BIG_ENDIAN +#ifndef __IEEE_LITTLE_ENDIAN +#error Endianess not declared!! +#endif /* not __IEEE_LITTLE_ENDIAN */ +#endif /* not __IEEE_BIG_ENDIAN */ + +#endif /* not __IEEE_LITTLE_ENDIAN */ +#endif /* not __IEEE_BIG_ENDIAN */ + diff --git a/components/newlib/include/machine/malloc.h b/components/newlib/include/machine/malloc.h new file mode 100644 index 000000000..fdada9ed7 --- /dev/null +++ b/components/newlib/include/machine/malloc.h @@ -0,0 +1,8 @@ +#ifndef _MACHMALLOC_H_ +#define _MACHMALLOC_H_ + +/* place holder so platforms may add malloc.h extensions */ + +#endif /* _MACHMALLOC_H_ */ + + diff --git a/components/newlib/include/machine/param.h b/components/newlib/include/machine/param.h new file mode 100644 index 000000000..bdf8bf70f --- /dev/null +++ b/components/newlib/include/machine/param.h @@ -0,0 +1 @@ +/* Place holder for machine-specific param.h. */ diff --git a/components/newlib/include/machine/setjmp-dj.h b/components/newlib/include/machine/setjmp-dj.h new file mode 100644 index 000000000..6ca5e6526 --- /dev/null +++ b/components/newlib/include/machine/setjmp-dj.h @@ -0,0 +1,43 @@ +/* + * Copyright (C) 1991 DJ Delorie + * All rights reserved. + * + * Redistribution, modification, and use in source and binary forms is permitted + * provided that the above copyright notice and following paragraph are + * duplicated in all such forms. + * + * This file is distributed WITHOUT ANY WARRANTY; without even the implied + * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + */ + +/* Modified to use SETJMP_DJ_H rather than SETJMP_H to avoid + conflicting with setjmp.h. Ian Taylor, Cygnus support, April, + 1993. */ + +#ifndef _SETJMP_DJ_H_ +#define _SETJMP_DJ_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct { + unsigned long eax; + unsigned long ebx; + unsigned long ecx; + unsigned long edx; + unsigned long esi; + unsigned long edi; + unsigned long ebp; + unsigned long esp; + unsigned long eip; +} jmp_buf[1]; + +extern int setjmp(jmp_buf); +extern void longjmp(jmp_buf, int); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/components/newlib/include/machine/setjmp.h b/components/newlib/include/machine/setjmp.h new file mode 100644 index 000000000..9f9d9e49b --- /dev/null +++ b/components/newlib/include/machine/setjmp.h @@ -0,0 +1,453 @@ + +_BEGIN_STD_C + +#if defined(__or1k__) || defined(__or1knd__) +#define _JBLEN 31 /* 32 GPRs - r0 */ +#define _JBTYPE unsigned long +#endif + +#if defined(__arm__) || defined(__thumb__) +/* + * All callee preserved registers: + * v1 - v7, fp, ip, sp, lr, f4, f5, f6, f7 + */ +#define _JBLEN 23 +#endif + +#if defined(__aarch64__) +#define _JBLEN 22 +#define _JBTYPE long long +#endif + +#if defined(__AVR__) +#define _JBLEN 24 +#endif + +#ifdef __sparc__ +/* + * onsstack,sigmask,sp,pc,npc,psr,g1,o0,wbcnt (sigcontext). + * All else recovered by under/over(flow) handling. + */ +#define _JBLEN 13 +#endif + +#ifdef __BFIN__ +#define _JBLEN 40 +#endif + +#ifdef __epiphany__ +/* All callee preserved registers: r4-r10,fp, sp, lr,r15, r32-r39 */ +#define _JBTYPE long long +#define _JBLEN 10 +#endif + +/* necv70 was 9 as well. */ + +#if defined(__m68k__) || defined(__mc68000__) +/* + * onsstack,sigmask,sp,pc,psl,d2-d7,a2-a6, + * fp2-fp7 for 68881. + * All else recovered by under/over(flow) handling. + */ +#define _JBLEN 34 +#endif + +#if defined(__mc68hc11__) || defined(__mc68hc12__) || defined(__mc68hc1x__) +/* + * D, X, Y are not saved. + * Only take into account the pseudo soft registers (max 32). + */ +#define _JBLEN 32 +#endif + +#ifdef __nds32__ +/* 17 words for GPRs, + 1 word for $fpcfg.freg and 30 words for FPUs + Reserved 2 words for aligement-adjustment. When storeing double-precision + floating-point register into memory, the address has to be + double-word-aligned. + Check libc/machine/nds32/setjmp.S for more information. */ +#if __NDS32_EXT_FPU_SP__ || __NDS32_EXT_FPU_DP__ +#define _JBLEN 50 +#else +#define _JBLEN 18 +#endif +#endif + +#if defined(__Z8001__) || defined(__Z8002__) +/* 16 regs + pc */ +#define _JBLEN 20 +#endif + +#ifdef _AM29K +/* + * onsstack,sigmask,sp,pc,npc,psr,g1,o0,wbcnt (sigcontext). + * All else recovered by under/over(flow) handling. + */ +#define _JBLEN 9 +#endif + +#ifdef __i386__ +# if defined(__CYGWIN__) && !defined (_JBLEN) +# define _JBLEN (13 * 4) +# elif defined(__unix__) || defined(__rtems__) +# define _JBLEN 9 +# else +# include "setjmp-dj.h" +# endif +#endif + +#ifdef __x86_64__ +# ifdef __CYGWIN__ +# define _JBTYPE long +# define _JBLEN 32 +# else +# define _JBTYPE long long +# define _JBLEN 8 +# endif +#endif + +#ifdef __i960__ +#define _JBLEN 35 +#endif + +#ifdef __M32R__ +/* Only 8 words are currently needed. 10 gives us some slop if we need + to expand. */ +#define _JBLEN 10 +#endif + +#ifdef __mips__ +# if defined(__mips64) +# define _JBTYPE long long +# endif +# ifdef __mips_soft_float +# define _JBLEN 11 +# else +# define _JBLEN 23 +# endif +#endif + +#ifdef __m88000__ +#define _JBLEN 21 +#endif + +#ifdef __H8300__ +#define _JBLEN 5 +#define _JBTYPE int +#endif + +#ifdef __H8300H__ +/* same as H8/300 but registers are twice as big */ +#define _JBLEN 5 +#define _JBTYPE long +#endif + +#if defined (__H8300S__) || defined (__H8300SX__) +/* same as H8/300 but registers are twice as big */ +#define _JBLEN 5 +#define _JBTYPE long +#endif + +#ifdef __H8500__ +#define _JBLEN 4 +#endif + +#ifdef __sh__ +#if __SH5__ +#define _JBLEN 50 +#define _JBTYPE long long +#else +#define _JBLEN 20 +#endif /* __SH5__ */ +#endif + +#ifdef __v800 +#define _JBLEN 28 +#endif + +#ifdef __PPC__ +#ifdef __ALTIVEC__ +#define _JBLEN 64 +#else +#define _JBLEN 32 +#endif +#define _JBTYPE double +#endif + +#ifdef __MICROBLAZE__ +#define _JBLEN 20 +#define _JBTYPE unsigned int +#endif + +#ifdef __hppa__ +/* %r30, %r2-%r18, %r27, pad, %fr12-%fr15. + Note space exists for the FP registers, but they are not + saved. */ +#define _JBLEN 28 +#endif + +#if defined(__mn10300__) || defined(__mn10200__) +#ifdef __AM33_2__ +#define _JBLEN 26 +#else +/* A guess */ +#define _JBLEN 10 +#endif +#endif + +#ifdef __v850 +/* I think our setjmp is saving 15 regs at the moment. Gives us one word + slop if we need to expand. */ +#define _JBLEN 16 +#endif + +#if defined(_C4x) +#define _JBLEN 10 +#endif +#if defined(_C3x) +#define _JBLEN 9 +#endif + +#ifdef __TMS320C6X__ +#define _JBLEN 13 +#endif + +#ifdef __TIC80__ +#define _JBLEN 13 +#endif + +#ifdef __D10V__ +#define _JBLEN 8 +#endif + +#ifdef __D30V__ +#define _JBLEN ((64 /* GPR */ + (2*2) /* ACs */ + 18 /* CRs */) / 2) +#define _JBTYPE double +#endif + +#ifdef __frv__ +#define _JBLEN (68/2) /* room for 68 32-bit regs */ +#define _JBTYPE double +#endif + +#ifdef __moxie__ +#define _JBLEN 16 +#endif + +#ifdef __CRX__ +#define _JBLEN 9 +#endif + +#if (defined(__CR16__) || defined(__CR16C__) ||defined(__CR16CP__)) +/* r6, r7, r8, r9, r10, r11, r12 (r12L, r12H), + * r13 (r13L, r13H), ra(raL, raH), sp(spL, spH) */ +#define _JBLEN 14 +#define _JBTYPE unsigned short +#endif + +#ifdef __fr30__ +#define _JBLEN 10 +#endif + +#ifdef __iq2000__ +#define _JBLEN 32 +#endif + +#ifdef __mcore__ +#define _JBLEN 16 +#endif + +#ifdef __MMIX__ +/* Using a layout compatible with GCC's built-in. */ +#define _JBLEN 5 +#define _JBTYPE unsigned long +#endif + +#ifdef __mt__ +#define _JBLEN 16 +#endif + +#ifdef __SPU__ +#define _JBLEN 50 +#define _JBTYPE __vector signed int +#endif + +#ifdef __xstormy16__ +/* 4 GPRs plus SP plus PC. */ +#define _JBLEN 8 +#endif + +#ifdef __XTENSA__ +#if __XTENSA_WINDOWED_ABI__ + +/* The jmp_buf structure for Xtensa windowed ABI holds the following + (where "proc" is the procedure that calls setjmp): 4-12 registers + from the window of proc, the 4 words from the save area at proc's $sp + (in case a subsequent alloca in proc moves $sp), and the return + address within proc. Everything else is saved on the stack in the + normal save areas. The jmp_buf structure is: + + struct jmp_buf { + int regs[12]; + int save[4]; + void *return_address; + } + + See the setjmp code for details. */ + +#define _JBLEN 17 /* 12 + 4 + 1 */ + +#else /* __XTENSA_CALL0_ABI__ */ + +#define _JBLEN 6 /* a0, a1, a12, a13, a14, a15 */ + +#endif /* __XTENSA_CALL0_ABI__ */ +#endif /* __XTENSA__ */ + +#ifdef __mep__ +/* 16 GPRs, pc, hi, lo */ +#define _JBLEN 19 +#endif + +#ifdef __CRIS__ +#define _JBLEN 18 +#endif + +#ifdef __lm32__ +#define _JBLEN 19 +#endif + +#ifdef __m32c__ +#if defined(__r8c_cpu__) || defined(__m16c_cpu__) +#define _JBLEN (22/2) +#else +#define _JBLEN (34/2) +#endif +#define _JBTYPE unsigned short +#endif /* __m32c__ */ + +#ifdef __MSP430__ +#define _JBLEN 9 + +#ifdef __MSP430X_LARGE__ +#define _JBTYPE unsigned long +#else +#define _JBTYPE unsigned short +#endif +#endif + +#ifdef __RL78__ +/* Three banks of registers, SP, CS, ES, PC */ +#define _JBLEN (8*3+8) +#define _JBTYPE unsigned char +#endif + +/* + * There are two versions of setjmp()/longjmp(): + * 1) Compiler (gcc) built-in versions. + * 2) Function-call versions. + * + * The built-in versions are used most of the time. When used, gcc replaces + * calls to setjmp()/longjmp() with inline assembly code. The built-in + * versions save/restore a variable number of registers. + + * _JBLEN is set to 40 to be ultra-safe with the built-in versions. + * It only needs to be 12 for the function-call versions + * but this data structure is used by both versions. + */ +#ifdef __NIOS2__ +#define _JBLEN 40 +#define _JBTYPE unsigned long +#endif + +#ifdef __RX__ +#define _JBLEN 0x44 +#endif + +#ifdef _JBLEN +#ifdef _JBTYPE +typedef _JBTYPE jmp_buf[_JBLEN]; +#else +typedef int jmp_buf[_JBLEN]; +#endif +#endif + +_END_STD_C + +#if defined(__CYGWIN__) || defined(__rtems__) +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* POSIX sigsetjmp/siglongjmp macros */ +#ifdef _JBTYPE +typedef _JBTYPE sigjmp_buf[_JBLEN+1+((sizeof (_JBTYPE) + sizeof (sigset_t) - 1) + /sizeof (_JBTYPE))]; +#else +typedef int sigjmp_buf[_JBLEN+1+(sizeof (sigset_t)/sizeof (int))]; +#endif + +#define _SAVEMASK _JBLEN +#define _SIGMASK (_JBLEN+1) + +#ifdef __CYGWIN__ +# define _CYGWIN_WORKING_SIGSETJMP +#endif + +#ifdef _POSIX_THREADS +#define __SIGMASK_FUNC pthread_sigmask +#else +#define __SIGMASK_FUNC sigprocmask +#endif + +#if defined(__GNUC__) + +#define sigsetjmp(env, savemask) \ + __extension__ \ + ({ \ + sigjmp_buf *_sjbuf = &(env); \ + ((*_sjbuf)[_SAVEMASK] = savemask,\ + __SIGMASK_FUNC (SIG_SETMASK, 0, (sigset_t *)((*_sjbuf) + _SIGMASK)),\ + setjmp (*_sjbuf)); \ + }) + +#define siglongjmp(env, val) \ + __extension__ \ + ({ \ + sigjmp_buf *_sjbuf = &(env); \ + ((((*_sjbuf)[_SAVEMASK]) ? \ + __SIGMASK_FUNC (SIG_SETMASK, (sigset_t *)((*_sjbuf) + _SIGMASK), 0)\ + : 0), \ + longjmp (*_sjbuf, val)); \ + }) + +#else /* !__GNUC__ */ + +#define sigsetjmp(env, savemask) ((env)[_SAVEMASK] = savemask,\ + __SIGMASK_FUNC (SIG_SETMASK, 0, (sigset_t *) ((env) + _SIGMASK)),\ + setjmp (env)) + +#define siglongjmp(env, val) ((((env)[_SAVEMASK])?\ + __SIGMASK_FUNC (SIG_SETMASK, (sigset_t *) ((env) + _SIGMASK), 0):0),\ + longjmp (env, val)) + +#endif + +/* POSIX _setjmp/_longjmp, maintained for XSI compatibility. These + are equivalent to sigsetjmp/siglongjmp when not saving the signal mask. + New applications should use sigsetjmp/siglongjmp instead. */ +#ifdef __CYGWIN__ +extern void _longjmp(jmp_buf, int); +extern int _setjmp(jmp_buf); +#else +#define _setjmp(env) sigsetjmp ((env), 0) +#define _longjmp(env, val) siglongjmp ((env), (val)) +#endif + +#ifdef __cplusplus +} +#endif +#endif /* __CYGWIN__ or __rtems__ */ diff --git a/components/newlib/include/machine/stdlib.h b/components/newlib/include/machine/stdlib.h new file mode 100644 index 000000000..fa3f3a139 --- /dev/null +++ b/components/newlib/include/machine/stdlib.h @@ -0,0 +1,8 @@ +#ifndef _MACHSTDLIB_H_ +#define _MACHSTDLIB_H_ + +/* place holder so platforms may add stdlib.h extensions */ + +#endif /* _MACHSTDLIB_H_ */ + + diff --git a/components/newlib/include/machine/termios.h b/components/newlib/include/machine/termios.h new file mode 100644 index 000000000..41fd45938 --- /dev/null +++ b/components/newlib/include/machine/termios.h @@ -0,0 +1 @@ +#define __MAX_BAUD B4000000 diff --git a/components/newlib/include/machine/time.h b/components/newlib/include/machine/time.h new file mode 100644 index 000000000..06e2ccffb --- /dev/null +++ b/components/newlib/include/machine/time.h @@ -0,0 +1,19 @@ +#ifndef _MACHTIME_H_ +#define _MACHTIME_H_ + +#if defined(__rtems__) +#define _CLOCKS_PER_SEC_ sysconf(_SC_CLK_TCK) +#else /* !__rtems__ */ +#if defined(__aarch64__) || defined(__arm__) || defined(__thumb__) +#define _CLOCKS_PER_SEC_ 100 +#endif +#endif /* !__rtems__ */ + +#ifdef __SPU__ +#include +int nanosleep (const struct timespec *, struct timespec *); +#endif + +#endif /* _MACHTIME_H_ */ + + diff --git a/components/newlib/include/machine/types.h b/components/newlib/include/machine/types.h new file mode 100644 index 000000000..40a75faa5 --- /dev/null +++ b/components/newlib/include/machine/types.h @@ -0,0 +1,30 @@ +#ifndef _MACHTYPES_H_ +#define _MACHTYPES_H_ + +/* + * The following section is RTEMS specific and is needed to more + * closely match the types defined in the BSD machine/types.h. + * This is needed to let the RTEMS/BSD TCP/IP stack compile. + */ +#if defined(__rtems__) +#include +#endif + +#define _CLOCK_T_ unsigned long /* clock() */ +#define _TIME_T_ long /* time() */ +#define _CLOCKID_T_ unsigned long +#define _TIMER_T_ unsigned long + +#ifndef _HAVE_SYSTYPES +typedef long int __off_t; +typedef int __pid_t; +#ifdef __GNUC__ +__extension__ typedef long long int __loff_t; +#else +typedef long int __loff_t; +#endif +#endif + +#endif /* _MACHTYPES_H_ */ + + diff --git a/components/newlib/include/malloc.h b/components/newlib/include/malloc.h new file mode 100644 index 000000000..41b5efdc0 --- /dev/null +++ b/components/newlib/include/malloc.h @@ -0,0 +1,169 @@ +/* malloc.h -- header file for memory routines. */ + +#ifndef _INCLUDE_MALLOC_H_ +#define _INCLUDE_MALLOC_H_ + +#include <_ansi.h> +#include + +#define __need_size_t +#include + +/* include any machine-specific extensions */ +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* This version of struct mallinfo must match the one in + libc/stdlib/mallocr.c. */ + +struct mallinfo { + size_t arena; /* total space allocated from system */ + size_t ordblks; /* number of non-inuse chunks */ + size_t smblks; /* unused -- always zero */ + size_t hblks; /* number of mmapped regions */ + size_t hblkhd; /* total space in mmapped regions */ + size_t usmblks; /* unused -- always zero */ + size_t fsmblks; /* unused -- always zero */ + size_t uordblks; /* total allocated space */ + size_t fordblks; /* total non-inuse space */ + size_t keepcost; /* top-most, releasable (via malloc_trim) space */ +}; + +/* The routines. */ + +extern _PTR malloc _PARAMS ((size_t)); +#ifdef __CYGWIN__ +#undef _malloc_r +#define _malloc_r(r, s) malloc (s) +#else +extern _PTR _malloc_r _PARAMS ((struct _reent *, size_t)); +#endif + +extern _VOID free _PARAMS ((_PTR)); +#ifdef __CYGWIN__ +#undef _free_r +#define _free_r(r, p) free (p) +#else +extern _VOID _free_r _PARAMS ((struct _reent *, _PTR)); +#endif + +extern _PTR realloc _PARAMS ((_PTR, size_t)); +#ifdef __CYGWIN__ +#undef _realloc_r +#define _realloc_r(r, p, s) realloc (p, s) +#else +extern _PTR _realloc_r _PARAMS ((struct _reent *, _PTR, size_t)); +#endif + +extern _PTR calloc _PARAMS ((size_t, size_t)); +#ifdef __CYGWIN__ +#undef _calloc_r +#define _calloc_r(r, s1, s2) calloc (s1, s2); +#else +extern _PTR _calloc_r _PARAMS ((struct _reent *, size_t, size_t)); +#endif + +extern _PTR memalign _PARAMS ((size_t, size_t)); +#ifdef __CYGWIN__ +#undef _memalign_r +#define _memalign_r(r, s1, s2) memalign (s1, s2); +#else +extern _PTR _memalign_r _PARAMS ((struct _reent *, size_t, size_t)); +#endif + +extern struct mallinfo mallinfo _PARAMS ((void)); +#ifdef __CYGWIN__ +#undef _mallinfo_r +#define _mallinfo_r(r) mallinfo () +#else +extern struct mallinfo _mallinfo_r _PARAMS ((struct _reent *)); +#endif + +extern void malloc_stats _PARAMS ((void)); +#ifdef __CYGWIN__ +#undef _malloc_stats_r +#define _malloc_stats_r(r) malloc_stats () +#else +extern void _malloc_stats_r _PARAMS ((struct _reent *)); +#endif + +extern int mallopt _PARAMS ((int, int)); +#ifdef __CYGWIN__ +#undef _mallopt_r +#define _mallopt_r(i1, i2) mallopt (i1, i2) +#else +extern int _mallopt_r _PARAMS ((struct _reent *, int, int)); +#endif + +extern size_t malloc_usable_size _PARAMS ((_PTR)); +#ifdef __CYGWIN__ +#undef _malloc_usable_size_r +#define _malloc_usable_size_r(r, p) malloc_usable_size (p) +#else +extern size_t _malloc_usable_size_r _PARAMS ((struct _reent *, _PTR)); +#endif + +/* These aren't too useful on an embedded system, but we define them + anyhow. */ + +extern _PTR valloc _PARAMS ((size_t)); +#ifdef __CYGWIN__ +#undef _valloc_r +#define _valloc_r(r, s) valloc (s) +#else +extern _PTR _valloc_r _PARAMS ((struct _reent *, size_t)); +#endif + +extern _PTR pvalloc _PARAMS ((size_t)); +#ifdef __CYGWIN__ +#undef _pvalloc_r +#define _pvalloc_r(r, s) pvalloc (s) +#else +extern _PTR _pvalloc_r _PARAMS ((struct _reent *, size_t)); +#endif + +extern int malloc_trim _PARAMS ((size_t)); +#ifdef __CYGWIN__ +#undef _malloc_trim_r +#define _malloc_trim_r(r, s) malloc_trim (s) +#else +extern int _malloc_trim_r _PARAMS ((struct _reent *, size_t)); +#endif + +/* A compatibility routine for an earlier version of the allocator. */ + +extern _VOID mstats _PARAMS ((char *)); +#ifdef __CYGWIN__ +#undef _mstats_r +#define _mstats_r(r, p) mstats (p) +#else +extern _VOID _mstats_r _PARAMS ((struct _reent *, char *)); +#endif + +/* SVID2/XPG mallopt options */ + +#define M_MXFAST 1 /* UNUSED in this malloc */ +#define M_NLBLKS 2 /* UNUSED in this malloc */ +#define M_GRAIN 3 /* UNUSED in this malloc */ +#define M_KEEP 4 /* UNUSED in this malloc */ + +/* mallopt options that actually do something */ + +#define M_TRIM_THRESHOLD -1 +#define M_TOP_PAD -2 +#define M_MMAP_THRESHOLD -3 +#define M_MMAP_MAX -4 + +#ifndef __CYGWIN__ +/* Some systems provide this, so do too for compatibility. */ +extern void cfree _PARAMS ((_PTR)); +#endif /* __CYGWIN__ */ + +#ifdef __cplusplus +} +#endif + +#endif /* _INCLUDE_MALLOC_H_ */ diff --git a/components/newlib/include/math.h b/components/newlib/include/math.h new file mode 100644 index 000000000..d16ce3074 --- /dev/null +++ b/components/newlib/include/math.h @@ -0,0 +1,615 @@ +#ifndef _MATH_H_ + +#define _MATH_H_ + +#include +#include +#include "_ansi.h" + +_BEGIN_STD_C + +/* __dmath, __fmath, and __ldmath are only here for backwards compatibility + * in case any code used them. They are no longer used by Newlib, itself, + * other than legacy. */ +union __dmath +{ + double d; + __ULong i[2]; +}; + +union __fmath +{ + float f; + __ULong i[1]; +}; + +#if defined(_HAVE_LONG_DOUBLE) +union __ldmath +{ + long double ld; + __ULong i[4]; +}; +#endif + +/* Natural log of 2 */ +#define _M_LN2 0.693147180559945309417 + +#if __GNUC_PREREQ (3, 3) + /* gcc >= 3.3 implicitly defines builtins for HUGE_VALx values. */ + +# ifndef HUGE_VAL +# define HUGE_VAL (__builtin_huge_val()) +# endif + +# ifndef HUGE_VALF +# define HUGE_VALF (__builtin_huge_valf()) +# endif + +# ifndef HUGE_VALL +# define HUGE_VALL (__builtin_huge_vall()) +# endif + +# ifndef INFINITY +# define INFINITY (__builtin_inff()) +# endif + +# ifndef NAN +# define NAN (__builtin_nanf("")) +# endif + +#else /* !gcc >= 3.3 */ + + /* No builtins. Use fixed defines instead. (All 3 HUGE plus the INFINITY + * and NAN macros are required to be constant expressions. Using a variable-- + * even a static const--does not meet this requirement, as it cannot be + * evaluated at translation time.) + * The infinities are done using numbers that are far in excess of + * something that would be expected to be encountered in a floating-point + * implementation. (A more certain way uses values from float.h, but that is + * avoided because system includes are not supposed to include each other.) + * This method might produce warnings from some compilers. (It does in + * newer GCCs, but not for ones that would hit this #else.) If this happens, + * please report details to the Newlib mailing list. */ + + #ifndef HUGE_VAL + #define HUGE_VAL (1.0e999999999) + #endif + + #ifndef HUGE_VALF + #define HUGE_VALF (1.0e999999999F) + #endif + + #if !defined(HUGE_VALL) && defined(_HAVE_LONG_DOUBLE) + #define HUGE_VALL (1.0e999999999L) + #endif + + #if !defined(INFINITY) + #define INFINITY (HUGE_VALF) + #endif + + #if !defined(NAN) + #if defined(__GNUC__) && defined(__cplusplus) + /* Exception: older g++ versions warn about the divide by 0 used in the + * normal case (even though older gccs do not). This trick suppresses the + * warning, but causes errors for plain gcc, so is only used in the one + * special case. */ + static const union { __ULong __i[1]; float __d; } __Nanf = {0x7FC00000}; + #define NAN (__Nanf.__d) + #else + #define NAN (0.0F/0.0F) + #endif + #endif + +#endif /* !gcc >= 3.3 */ + +/* Reentrant ANSI C functions. */ + +#ifndef __math_68881 +extern double atan _PARAMS((double)); +extern double cos _PARAMS((double)); +extern double sin _PARAMS((double)); +extern double tan _PARAMS((double)); +extern double tanh _PARAMS((double)); +extern double frexp _PARAMS((double, int *)); +extern double modf _PARAMS((double, double *)); +extern double ceil _PARAMS((double)); +extern double fabs _PARAMS((double)); +extern double floor _PARAMS((double)); +#endif /* ! defined (__math_68881) */ + +/* Non reentrant ANSI C functions. */ + +#ifndef _REENT_ONLY +#ifndef __math_68881 +extern double acos _PARAMS((double)); +extern double asin _PARAMS((double)); +extern double atan2 _PARAMS((double, double)); +extern double cosh _PARAMS((double)); +extern double sinh _PARAMS((double)); +extern double exp _PARAMS((double)); +extern double ldexp _PARAMS((double, int)); +extern double log _PARAMS((double)); +extern double log10 _PARAMS((double)); +extern double pow _PARAMS((double, double)); +extern double sqrt _PARAMS((double)); +extern double fmod _PARAMS((double, double)); +#endif /* ! defined (__math_68881) */ +#endif /* ! defined (_REENT_ONLY) */ + +#if !defined(__STRICT_ANSI__) || defined(__cplusplus) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) + +/* ISO C99 types and macros. */ + +/* FIXME: FLT_EVAL_METHOD should somehow be gotten from float.h (which is hard, + * considering that the standard says the includes it defines should not + * include other includes that it defines) and that value used. (This can be + * solved, but autoconf has a bug which makes the solution more difficult, so + * it has been skipped for now.) */ +#if !defined(FLT_EVAL_METHOD) && defined(__FLT_EVAL_METHOD__) + #define FLT_EVAL_METHOD __FLT_EVAL_METHOD__ + #define __TMP_FLT_EVAL_METHOD +#endif /* FLT_EVAL_METHOD */ +#if defined FLT_EVAL_METHOD + #if FLT_EVAL_METHOD == 0 + typedef float float_t; + typedef double double_t; + #elif FLT_EVAL_METHOD == 1 + typedef double float_t; + typedef double double_t; + #elif FLT_EVAL_METHOD == 2 + typedef long double float_t; + typedef long double double_t; + #else + /* Implementation-defined. Assume float_t and double_t have been + * defined previously for this configuration (e.g. config.h). */ + #endif +#else + /* Assume basic definitions. */ + typedef float float_t; + typedef double double_t; +#endif +#if defined(__TMP_FLT_EVAL_METHOD) + #undef FLT_EVAL_METHOD +#endif + +#define FP_NAN 0 +#define FP_INFINITE 1 +#define FP_ZERO 2 +#define FP_SUBNORMAL 3 +#define FP_NORMAL 4 + +#ifndef FP_ILOGB0 +# define FP_ILOGB0 (-INT_MAX) +#endif +#ifndef FP_ILOGBNAN +# define FP_ILOGBNAN INT_MAX +#endif + +#ifndef MATH_ERRNO +# define MATH_ERRNO 1 +#endif +#ifndef MATH_ERREXCEPT +# define MATH_ERREXCEPT 2 +#endif +#ifndef math_errhandling +# define math_errhandling MATH_ERRNO +#endif + +extern int __isinff (float x); +extern int __isinfd (double x); +extern int __isnanf (float x); +extern int __isnand (double x); +extern int __fpclassifyf (float x); +extern int __fpclassifyd (double x); +extern int __signbitf (float x); +extern int __signbitd (double x); + +#define fpclassify(__x) \ + ((sizeof(__x) == sizeof(float)) ? __fpclassifyf(__x) : \ + __fpclassifyd(__x)) + +#ifndef isfinite + #define isfinite(__y) \ + (__extension__ ({int __cy = fpclassify(__y); \ + __cy != FP_INFINITE && __cy != FP_NAN;})) +#endif + +/* Note: isinf and isnan were once functions in newlib that took double + * arguments. C99 specifies that these names are reserved for macros + * supporting multiple floating point types. Thus, they are + * now defined as macros. Implementations of the old functions + * taking double arguments still exist for compatibility purposes + * (prototypes for them are in ). */ +#ifndef isinf + #define isinf(y) (fpclassify(y) == FP_INFINITE) +#endif + +#ifndef isnan + #define isnan(y) (fpclassify(y) == FP_NAN) +#endif + +#define isnormal(y) (fpclassify(y) == FP_NORMAL) +#define signbit(__x) \ + ((sizeof(__x) == sizeof(float)) ? __signbitf(__x) : \ + __signbitd(__x)) + +#define isgreater(x,y) \ + (__extension__ ({__typeof__(x) __x = (x); __typeof__(y) __y = (y); \ + !isunordered(__x,__y) && (__x > __y);})) +#define isgreaterequal(x,y) \ + (__extension__ ({__typeof__(x) __x = (x); __typeof__(y) __y = (y); \ + !isunordered(__x,__y) && (__x >= __y);})) +#define isless(x,y) \ + (__extension__ ({__typeof__(x) __x = (x); __typeof__(y) __y = (y); \ + !isunordered(__x,__y) && (__x < __y);})) +#define islessequal(x,y) \ + (__extension__ ({__typeof__(x) __x = (x); __typeof__(y) __y = (y); \ + !isunordered(__x,__y) && (__x <= __y);})) +#define islessgreater(x,y) \ + (__extension__ ({__typeof__(x) __x = (x); __typeof__(y) __y = (y); \ + !isunordered(__x,__y) && (__x < __y || __x > __y);})) + +#define isunordered(a,b) \ + (__extension__ ({__typeof__(a) __a = (a); __typeof__(b) __b = (b); \ + fpclassify(__a) == FP_NAN || fpclassify(__b) == FP_NAN;})) + +/* Non ANSI double precision functions. */ + +extern double infinity _PARAMS((void)); +extern double nan _PARAMS((const char *)); +extern int finite _PARAMS((double)); +extern double copysign _PARAMS((double, double)); +extern double logb _PARAMS((double)); +extern int ilogb _PARAMS((double)); + +extern double asinh _PARAMS((double)); +extern double cbrt _PARAMS((double)); +extern double nextafter _PARAMS((double, double)); +extern double rint _PARAMS((double)); +extern double scalbn _PARAMS((double, int)); + +extern double exp2 _PARAMS((double)); +extern double scalbln _PARAMS((double, long int)); +extern double tgamma _PARAMS((double)); +extern double nearbyint _PARAMS((double)); +extern long int lrint _PARAMS((double)); +extern long long int llrint _PARAMS((double)); +extern double round _PARAMS((double)); +extern long int lround _PARAMS((double)); +extern long long int llround _PARAMS((double)); +extern double trunc _PARAMS((double)); +extern double remquo _PARAMS((double, double, int *)); +extern double fdim _PARAMS((double, double)); +extern double fmax _PARAMS((double, double)); +extern double fmin _PARAMS((double, double)); +extern double fma _PARAMS((double, double, double)); + +#ifndef __math_68881 +extern double log1p _PARAMS((double)); +extern double expm1 _PARAMS((double)); +#endif /* ! defined (__math_68881) */ + +#ifndef _REENT_ONLY +extern double acosh _PARAMS((double)); +extern double atanh _PARAMS((double)); +extern double remainder _PARAMS((double, double)); +extern double gamma _PARAMS((double)); +extern double lgamma _PARAMS((double)); +extern double erf _PARAMS((double)); +extern double erfc _PARAMS((double)); +extern double log2 _PARAMS((double)); +#if !defined(__cplusplus) +#define log2(x) (log (x) / _M_LN2) +#endif + +#ifndef __math_68881 +extern double hypot _PARAMS((double, double)); +#endif + +#endif /* ! defined (_REENT_ONLY) */ + +/* Single precision versions of ANSI functions. */ + +extern float atanf _PARAMS((float)); +extern float cosf _PARAMS((float)); +extern float sinf _PARAMS((float)); +extern float tanf _PARAMS((float)); +extern float tanhf _PARAMS((float)); +extern float frexpf _PARAMS((float, int *)); +extern float modff _PARAMS((float, float *)); +extern float ceilf _PARAMS((float)); +extern float fabsf _PARAMS((float)); +extern float floorf _PARAMS((float)); + +#ifndef _REENT_ONLY +extern float acosf _PARAMS((float)); +extern float asinf _PARAMS((float)); +extern float atan2f _PARAMS((float, float)); +extern float coshf _PARAMS((float)); +extern float sinhf _PARAMS((float)); +extern float expf _PARAMS((float)); +extern float ldexpf _PARAMS((float, int)); +extern float logf _PARAMS((float)); +extern float log10f _PARAMS((float)); +extern float powf _PARAMS((float, float)); +extern float sqrtf _PARAMS((float)); +extern float fmodf _PARAMS((float, float)); +#endif /* ! defined (_REENT_ONLY) */ + +/* Other single precision functions. */ + +extern float exp2f _PARAMS((float)); +extern float scalblnf _PARAMS((float, long int)); +extern float tgammaf _PARAMS((float)); +extern float nearbyintf _PARAMS((float)); +extern long int lrintf _PARAMS((float)); +extern long long int llrintf _PARAMS((float)); +extern float roundf _PARAMS((float)); +extern long int lroundf _PARAMS((float)); +extern long long int llroundf _PARAMS((float)); +extern float truncf _PARAMS((float)); +extern float remquof _PARAMS((float, float, int *)); +extern float fdimf _PARAMS((float, float)); +extern float fmaxf _PARAMS((float, float)); +extern float fminf _PARAMS((float, float)); +extern float fmaf _PARAMS((float, float, float)); + +extern float infinityf _PARAMS((void)); +extern float nanf _PARAMS((const char *)); +extern int finitef _PARAMS((float)); +extern float copysignf _PARAMS((float, float)); +extern float logbf _PARAMS((float)); +extern int ilogbf _PARAMS((float)); + +extern float asinhf _PARAMS((float)); +extern float cbrtf _PARAMS((float)); +extern float nextafterf _PARAMS((float, float)); +extern float rintf _PARAMS((float)); +extern float scalbnf _PARAMS((float, int)); +extern float log1pf _PARAMS((float)); +extern float expm1f _PARAMS((float)); + +#ifndef _REENT_ONLY +extern float acoshf _PARAMS((float)); +extern float atanhf _PARAMS((float)); +extern float remainderf _PARAMS((float, float)); +extern float gammaf _PARAMS((float)); +extern float lgammaf _PARAMS((float)); +extern float erff _PARAMS((float)); +extern float erfcf _PARAMS((float)); +extern float log2f _PARAMS((float)); +extern float hypotf _PARAMS((float, float)); +#endif /* ! defined (_REENT_ONLY) */ + +/* On platforms where long double equals double. */ +#ifdef _LDBL_EQ_DBL +/* Reentrant ANSI C functions. */ +#ifndef __math_68881 +extern long double atanl _PARAMS((long double)); +extern long double cosl _PARAMS((long double)); +extern long double sinl _PARAMS((long double)); +extern long double tanl _PARAMS((long double)); +extern long double tanhl _PARAMS((long double)); +extern long double frexpl _PARAMS((long double, int *)); +extern long double modfl _PARAMS((long double, long double *)); +extern long double ceill _PARAMS((long double)); +extern long double fabsl _PARAMS((long double)); +extern long double floorl _PARAMS((long double)); +extern long double log1pl _PARAMS((long double)); +extern long double expm1l _PARAMS((long double)); +#endif /* ! defined (__math_68881) */ +/* Non reentrant ANSI C functions. */ +#ifndef _REENT_ONLY +#ifndef __math_68881 +extern long double acosl _PARAMS((long double)); +extern long double asinl _PARAMS((long double)); +extern long double atan2l _PARAMS((long double, long double)); +extern long double coshl _PARAMS((long double)); +extern long double sinhl _PARAMS((long double)); +extern long double expl _PARAMS((long double)); +extern long double ldexpl _PARAMS((long double, int)); +extern long double logl _PARAMS((long double)); +extern long double log10l _PARAMS((long double)); +extern long double powl _PARAMS((long double, long double)); +extern long double sqrtl _PARAMS((long double)); +extern long double fmodl _PARAMS((long double, long double)); +extern long double hypotl _PARAMS((long double, long double)); +#endif /* ! defined (__math_68881) */ +#endif /* ! defined (_REENT_ONLY) */ +extern long double copysignl _PARAMS((long double, long double)); +extern long double nanl _PARAMS((const char *)); +extern int ilogbl _PARAMS((long double)); +extern long double asinhl _PARAMS((long double)); +extern long double cbrtl _PARAMS((long double)); +extern long double nextafterl _PARAMS((long double, long double)); +extern float nexttowardf _PARAMS((float, long double)); +extern double nexttoward _PARAMS((double, long double)); +extern long double nexttowardl _PARAMS((long double, long double)); +extern long double logbl _PARAMS((long double)); +extern long double log2l _PARAMS((long double)); +extern long double rintl _PARAMS((long double)); +extern long double scalbnl _PARAMS((long double, int)); +extern long double exp2l _PARAMS((long double)); +extern long double scalblnl _PARAMS((long double, long)); +extern long double tgammal _PARAMS((long double)); +extern long double nearbyintl _PARAMS((long double)); +extern long int lrintl _PARAMS((long double)); +extern long long int llrintl _PARAMS((long double)); +extern long double roundl _PARAMS((long double)); +extern long lroundl _PARAMS((long double)); +extern long long int llroundl _PARAMS((long double)); +extern long double truncl _PARAMS((long double)); +extern long double remquol _PARAMS((long double, long double, int *)); +extern long double fdiml _PARAMS((long double, long double)); +extern long double fmaxl _PARAMS((long double, long double)); +extern long double fminl _PARAMS((long double, long double)); +extern long double fmal _PARAMS((long double, long double, long double)); +#ifndef _REENT_ONLY +extern long double acoshl _PARAMS((long double)); +extern long double atanhl _PARAMS((long double)); +extern long double remainderl _PARAMS((long double, long double)); +extern long double lgammal _PARAMS((long double)); +extern long double erfl _PARAMS((long double)); +extern long double erfcl _PARAMS((long double)); +#endif /* ! defined (_REENT_ONLY) */ +#else /* !_LDBL_EQ_DBL */ +#ifdef __i386__ +/* Other long double precision functions. */ +extern _LONG_DOUBLE rintl _PARAMS((_LONG_DOUBLE)); +extern long int lrintl _PARAMS((_LONG_DOUBLE)); +extern long long int llrintl _PARAMS((_LONG_DOUBLE)); +#endif /* __i386__ */ +#endif /* !_LDBL_EQ_DBL */ + +#endif /* !defined (__STRICT_ANSI__) || defined(__cplusplus) || (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) */ + +#if !defined (__STRICT_ANSI__) || defined(__cplusplus) + +extern double drem _PARAMS((double, double)); +extern void sincos _PARAMS((double, double *, double *)); +extern double gamma_r _PARAMS((double, int *)); +extern double lgamma_r _PARAMS((double, int *)); + +extern double y0 _PARAMS((double)); +extern double y1 _PARAMS((double)); +extern double yn _PARAMS((int, double)); +extern double j0 _PARAMS((double)); +extern double j1 _PARAMS((double)); +extern double jn _PARAMS((int, double)); + +extern float dremf _PARAMS((float, float)); +extern void sincosf _PARAMS((float, float *, float *)); +extern float gammaf_r _PARAMS((float, int *)); +extern float lgammaf_r _PARAMS((float, int *)); + +extern float y0f _PARAMS((float)); +extern float y1f _PARAMS((float)); +extern float ynf _PARAMS((int, float)); +extern float j0f _PARAMS((float)); +extern float j1f _PARAMS((float)); +extern float jnf _PARAMS((int, float)); + +/* GNU extensions */ +# ifndef exp10 +extern double exp10 _PARAMS((double)); +# endif +# ifndef pow10 +extern double pow10 _PARAMS((double)); +# endif +# ifndef exp10f +extern float exp10f _PARAMS((float)); +# endif +# ifndef pow10f +extern float pow10f _PARAMS((float)); +# endif + +#endif /* !defined (__STRICT_ANSI__) || defined(__cplusplus) */ + +#ifndef __STRICT_ANSI__ + +/* The gamma functions use a global variable, signgam. */ +#ifndef _REENT_ONLY +#define signgam (*__signgam()) +extern int *__signgam _PARAMS((void)); +#endif /* ! defined (_REENT_ONLY) */ + +#define __signgam_r(ptr) _REENT_SIGNGAM(ptr) + +/* The exception structure passed to the matherr routine. */ +/* We have a problem when using C++ since `exception' is a reserved + name in C++. */ +#ifdef __cplusplus +struct __exception +#else +struct exception +#endif +{ + int type; + char *name; + double arg1; + double arg2; + double retval; + int err; +}; + +#ifdef __cplusplus +extern int matherr _PARAMS((struct __exception *e)); +#else +extern int matherr _PARAMS((struct exception *e)); +#endif + +/* Values for the type field of struct exception. */ + +#define DOMAIN 1 +#define SING 2 +#define OVERFLOW 3 +#define UNDERFLOW 4 +#define TLOSS 5 +#define PLOSS 6 + +#endif /* ! defined (__STRICT_ANSI__) */ + +/* Useful constants. */ + +#if !defined(__STRICT_ANSI__) || ((_XOPEN_SOURCE - 0) >= 500) + +#define MAXFLOAT 3.40282347e+38F + +#define M_E 2.7182818284590452354 +#define M_LOG2E 1.4426950408889634074 +#define M_LOG10E 0.43429448190325182765 +#define M_LN2 _M_LN2 +#define M_LN10 2.30258509299404568402 +#define M_PI 3.14159265358979323846 +#define M_PI_2 1.57079632679489661923 +#define M_PI_4 0.78539816339744830962 +#define M_1_PI 0.31830988618379067154 +#define M_2_PI 0.63661977236758134308 +#define M_2_SQRTPI 1.12837916709551257390 +#define M_SQRT2 1.41421356237309504880 +#define M_SQRT1_2 0.70710678118654752440 + +#endif + +#ifndef __STRICT_ANSI__ + +#define M_TWOPI (M_PI * 2.0) +#define M_3PI_4 2.3561944901923448370E0 +#define M_SQRTPI 1.77245385090551602792981 +#define M_LN2LO 1.9082149292705877000E-10 +#define M_LN2HI 6.9314718036912381649E-1 +#define M_SQRT3 1.73205080756887719000 +#define M_IVLN10 0.43429448190325182765 /* 1 / log(10) */ +#define M_LOG2_E _M_LN2 +#define M_INVLN2 1.4426950408889633870E0 /* 1 / log(2) */ + +/* Global control over fdlibm error handling. */ + +enum __fdlibm_version +{ + __fdlibm_ieee = -1, + __fdlibm_svid, + __fdlibm_xopen, + __fdlibm_posix +}; + +#define _LIB_VERSION_TYPE enum __fdlibm_version +#define _LIB_VERSION __fdlib_version + +extern __IMPORT _LIB_VERSION_TYPE _LIB_VERSION; + +#define _IEEE_ __fdlibm_ieee +#define _SVID_ __fdlibm_svid +#define _XOPEN_ __fdlibm_xopen +#define _POSIX_ __fdlibm_posix + +#endif /* ! defined (__STRICT_ANSI__) */ + +_END_STD_C + +#ifdef __FAST_MATH__ +#include +#endif + +#endif /* _MATH_H_ */ diff --git a/components/newlib/include/newlib.h b/components/newlib/include/newlib.h new file mode 100644 index 000000000..e9bf56645 --- /dev/null +++ b/components/newlib/include/newlib.h @@ -0,0 +1,201 @@ +/* newlib.h. Generated from newlib.hin by configure. */ +/* newlib.hin. Manually edited from the output of autoheader to + remove all PACKAGE_ macros which will collide with any user + package using newlib header files and having its own package name, + version, etc... */ +#ifndef __NEWLIB_H__ + +#define __NEWLIB_H__ 1 + +/* EL/IX level */ +/* #undef _ELIX_LEVEL */ + +/* Newlib version */ +#define _NEWLIB_VERSION "2.2.0" + +/* C99 formats support (such as %a, %zu, ...) in IO functions like + * printf/scanf enabled */ +/* #undef _WANT_IO_C99_FORMATS */ + +/* long long type support in IO functions like printf/scanf enabled */ +/* #undef _WANT_IO_LONG_LONG */ + +/* Register application finalization function using atexit. */ +/* #undef _WANT_REGISTER_FINI */ + +/* long double type support in IO functions like printf/scanf enabled */ +/* #undef _WANT_IO_LONG_DOUBLE */ + +/* Positional argument support in printf functions enabled. */ +/* #undef _WANT_IO_POS_ARGS */ + +/* Optional reentrant struct support. Used mostly on platforms with + very restricted storage. */ +#define _WANT_REENT_SMALL 1 + +/* Multibyte supported */ +/* #undef _MB_CAPABLE */ + +/* MB_LEN_MAX */ +#define _MB_LEN_MAX 1 + +/* ICONV enabled */ +/* #undef _ICONV_ENABLED */ + +/* Enable ICONV external CCS files loading capabilities */ +/* #undef _ICONV_ENABLE_EXTERNAL_CCS */ + +/* Define if the linker supports .preinit_array/.init_array/.fini_array + * sections. */ +#define HAVE_INITFINI_ARRAY 1 + +/* True if atexit() may dynamically allocate space for cleanup + functions. */ +#define _ATEXIT_DYNAMIC_ALLOC 1 + +/* True if long double supported. */ +#define _HAVE_LONG_DOUBLE 1 + +/* Define if compiler supports -fno-tree-loop-distribute-patterns. */ +#define _HAVE_CC_INHIBIT_LOOP_TO_LIBCALL 1 + +/* True if long double supported and it is equal to double. */ +#define _LDBL_EQ_DBL 1 + +/* Define if uintptr_t is unsigned long on this architecture */ +/* #undef _UINTPTR_EQ_ULONG */ + +/* Define if uintptr_t is unsigned long long on this architecture */ +/* #undef _UINTPTR_EQ_ULONGLONG */ + +/* Define if ivo supported in streamio. */ +#define _FVWRITE_IN_STREAMIO 1 + +/* Define if fseek functions support seek optimization. */ +#define _FSEEK_OPTIMIZATION 1 + +/* Define if wide char orientation is supported. */ +#define _WIDE_ORIENT 1 + +/* Define if unbuffered stream file optimization is supported. */ +#define _UNBUF_STREAM_OPT 1 + +/* Define if lite version of exit supported. */ +/* #undef _LITE_EXIT */ + +/* Define if declare atexit data as global. */ +/* #undef _REENT_GLOBAL_ATEXIT */ + +/* Define if small footprint nano-formatted-IO implementation used. */ +#define _NANO_FORMATTED_IO 1 + +/* + * Iconv encodings enabled ("to" direction) + */ +/* #undef _ICONV_TO_ENCODING_BIG5 */ +/* #undef _ICONV_TO_ENCODING_CP775 */ +/* #undef _ICONV_TO_ENCODING_CP850 */ +/* #undef _ICONV_TO_ENCODING_CP852 */ +/* #undef _ICONV_TO_ENCODING_CP855 */ +/* #undef _ICONV_TO_ENCODING_CP866 */ +/* #undef _ICONV_TO_ENCODING_EUC_JP */ +/* #undef _ICONV_TO_ENCODING_EUC_TW */ +/* #undef _ICONV_TO_ENCODING_EUC_KR */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_1 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_10 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_11 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_13 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_14 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_15 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_2 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_3 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_4 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_5 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_6 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_7 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_8 */ +/* #undef _ICONV_TO_ENCODING_ISO_8859_9 */ +/* #undef _ICONV_TO_ENCODING_ISO_IR_111 */ +/* #undef _ICONV_TO_ENCODING_KOI8_R */ +/* #undef _ICONV_TO_ENCODING_KOI8_RU */ +/* #undef _ICONV_TO_ENCODING_KOI8_U */ +/* #undef _ICONV_TO_ENCODING_KOI8_UNI */ +/* #undef _ICONV_TO_ENCODING_UCS_2 */ +/* #undef _ICONV_TO_ENCODING_UCS_2_INTERNAL */ +/* #undef _ICONV_TO_ENCODING_UCS_2BE */ +/* #undef _ICONV_TO_ENCODING_UCS_2LE */ +/* #undef _ICONV_TO_ENCODING_UCS_4 */ +/* #undef _ICONV_TO_ENCODING_UCS_4_INTERNAL */ +/* #undef _ICONV_TO_ENCODING_UCS_4BE */ +/* #undef _ICONV_TO_ENCODING_UCS_4LE */ +/* #undef _ICONV_TO_ENCODING_US_ASCII */ +/* #undef _ICONV_TO_ENCODING_UTF_16 */ +/* #undef _ICONV_TO_ENCODING_UTF_16BE */ +/* #undef _ICONV_TO_ENCODING_UTF_16LE */ +/* #undef _ICONV_TO_ENCODING_UTF_8 */ +/* #undef _ICONV_TO_ENCODING_WIN_1250 */ +/* #undef _ICONV_TO_ENCODING_WIN_1251 */ +/* #undef _ICONV_TO_ENCODING_WIN_1252 */ +/* #undef _ICONV_TO_ENCODING_WIN_1253 */ +/* #undef _ICONV_TO_ENCODING_WIN_1254 */ +/* #undef _ICONV_TO_ENCODING_WIN_1255 */ +/* #undef _ICONV_TO_ENCODING_WIN_1256 */ +/* #undef _ICONV_TO_ENCODING_WIN_1257 */ +/* #undef _ICONV_TO_ENCODING_WIN_1258 */ + +/* + * Iconv encodings enabled ("from" direction) + */ +/* #undef _ICONV_FROM_ENCODING_BIG5 */ +/* #undef _ICONV_FROM_ENCODING_CP775 */ +/* #undef _ICONV_FROM_ENCODING_CP850 */ +/* #undef _ICONV_FROM_ENCODING_CP852 */ +/* #undef _ICONV_FROM_ENCODING_CP855 */ +/* #undef _ICONV_FROM_ENCODING_CP866 */ +/* #undef _ICONV_FROM_ENCODING_EUC_JP */ +/* #undef _ICONV_FROM_ENCODING_EUC_TW */ +/* #undef _ICONV_FROM_ENCODING_EUC_KR */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_1 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_10 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_11 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_13 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_14 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_15 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_2 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_3 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_4 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_5 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_6 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_7 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_8 */ +/* #undef _ICONV_FROM_ENCODING_ISO_8859_9 */ +/* #undef _ICONV_FROM_ENCODING_ISO_IR_111 */ +/* #undef _ICONV_FROM_ENCODING_KOI8_R */ +/* #undef _ICONV_FROM_ENCODING_KOI8_RU */ +/* #undef _ICONV_FROM_ENCODING_KOI8_U */ +/* #undef _ICONV_FROM_ENCODING_KOI8_UNI */ +/* #undef _ICONV_FROM_ENCODING_UCS_2 */ +/* #undef _ICONV_FROM_ENCODING_UCS_2_INTERNAL */ +/* #undef _ICONV_FROM_ENCODING_UCS_2BE */ +/* #undef _ICONV_FROM_ENCODING_UCS_2LE */ +/* #undef _ICONV_FROM_ENCODING_UCS_4 */ +/* #undef _ICONV_FROM_ENCODING_UCS_4_INTERNAL */ +/* #undef _ICONV_FROM_ENCODING_UCS_4BE */ +/* #undef _ICONV_FROM_ENCODING_UCS_4LE */ +/* #undef _ICONV_FROM_ENCODING_US_ASCII */ +/* #undef _ICONV_FROM_ENCODING_UTF_16 */ +/* #undef _ICONV_FROM_ENCODING_UTF_16BE */ +/* #undef _ICONV_FROM_ENCODING_UTF_16LE */ +/* #undef _ICONV_FROM_ENCODING_UTF_8 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1250 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1251 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1252 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1253 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1254 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1255 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1256 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1257 */ +/* #undef _ICONV_FROM_ENCODING_WIN_1258 */ + +#endif /* !__NEWLIB_H__ */ + diff --git a/components/newlib/include/paths.h b/components/newlib/include/paths.h new file mode 100644 index 000000000..b1c70f588 --- /dev/null +++ b/components/newlib/include/paths.h @@ -0,0 +1,9 @@ +#ifndef _PATHS_H_ +#define _PATHS_H_ + +#define _PATH_DEV "/dev/" +#define _PATH_DEVNULL "/dev/null" +#define _PATH_DEVZERO "/dev/zero" +#define _PATH_BSHELL "/bin/sh" + +#endif /* _PATHS_H_ */ diff --git a/components/newlib/include/pthread.h b/components/newlib/include/pthread.h new file mode 100644 index 000000000..db1f9c1ca --- /dev/null +++ b/components/newlib/include/pthread.h @@ -0,0 +1,431 @@ +/* pthread.h + * + * Written by Joel Sherrill . + * + * COPYRIGHT (c) 1989-2013. + * On-Line Applications Research Corporation (OAR). + * + * Permission to use, copy, modify, and distribute this software for any + * purpose without fee is hereby granted, provided that this entire notice + * is included in all copies of any software which is or includes a copy + * or modification of this software. + * + * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED + * WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION + * OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS + * SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + * + * $Id$ + */ + +#ifndef __PTHREAD_h +#define __PTHREAD_h + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +#if defined(_POSIX_THREADS) + +#include +#include +#include +#include + +struct _pthread_cleanup_context { + void (*_routine)(void *); + void *_arg; + int _canceltype; + struct _pthread_cleanup_context *_previous; +}; + +/* Register Fork Handlers */ +int _EXFUN(pthread_atfork,(void (*prepare)(void), void (*parent)(void), + void (*child)(void))); + +/* Mutex Initialization Attributes, P1003.1c/Draft 10, p. 81 */ + +int _EXFUN(pthread_mutexattr_init, (pthread_mutexattr_t *__attr)); +int _EXFUN(pthread_mutexattr_destroy, (pthread_mutexattr_t *__attr)); +int _EXFUN(pthread_mutexattr_getpshared, + (_CONST pthread_mutexattr_t *__attr, int *__pshared)); +int _EXFUN(pthread_mutexattr_setpshared, + (pthread_mutexattr_t *__attr, int __pshared)); + +#if defined(_UNIX98_THREAD_MUTEX_ATTRIBUTES) + +/* Single UNIX Specification 2 Mutex Attributes types */ + +int _EXFUN(pthread_mutexattr_gettype, + (_CONST pthread_mutexattr_t *__attr, int *__kind)); +int _EXFUN(pthread_mutexattr_settype, + (pthread_mutexattr_t *__attr, int __kind)); + +#endif + +/* Initializing and Destroying a Mutex, P1003.1c/Draft 10, p. 87 */ + +int _EXFUN(pthread_mutex_init, + (pthread_mutex_t *__mutex, _CONST pthread_mutexattr_t *__attr)); +int _EXFUN(pthread_mutex_destroy, (pthread_mutex_t *__mutex)); + +/* This is used to statically initialize a pthread_mutex_t. Example: + + pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + */ + +#define PTHREAD_MUTEX_INITIALIZER ((pthread_mutex_t) 0xFFFFFFFF) + +/* Locking and Unlocking a Mutex, P1003.1c/Draft 10, p. 93 + NOTE: P1003.4b/D8 adds pthread_mutex_timedlock(), p. 29 */ + +int _EXFUN(pthread_mutex_lock, (pthread_mutex_t *__mutex)); +int _EXFUN(pthread_mutex_trylock, (pthread_mutex_t *__mutex)); +int _EXFUN(pthread_mutex_unlock, (pthread_mutex_t *__mutex)); + +#if defined(_POSIX_TIMEOUTS) + +int _EXFUN(pthread_mutex_timedlock, + (pthread_mutex_t *__mutex, _CONST struct timespec *__timeout)); + +#endif /* _POSIX_TIMEOUTS */ + +/* Condition Variable Initialization Attributes, P1003.1c/Draft 10, p. 96 */ + +int _EXFUN(pthread_condattr_init, (pthread_condattr_t *__attr)); +int _EXFUN(pthread_condattr_destroy, (pthread_condattr_t *__attr)); +int _EXFUN(pthread_condattr_getpshared, + (_CONST pthread_condattr_t *__attr, int *__pshared)); +int _EXFUN(pthread_condattr_setpshared, + (pthread_condattr_t *__attr, int __pshared)); + +/* Initializing and Destroying a Condition Variable, P1003.1c/Draft 10, p. 87 */ + +int _EXFUN(pthread_cond_init, + (pthread_cond_t *__cond, _CONST pthread_condattr_t *__attr)); +int _EXFUN(pthread_cond_destroy, (pthread_cond_t *__mutex)); + +/* This is used to statically initialize a pthread_cond_t. Example: + + pthread_cond_t cond = PTHREAD_COND_INITIALIZER; + */ + +#define PTHREAD_COND_INITIALIZER ((pthread_cond_t) 0xFFFFFFFF) + +/* Broadcasting and Signaling a Condition, P1003.1c/Draft 10, p. 101 */ + +int _EXFUN(pthread_cond_signal, (pthread_cond_t *__cond)); +int _EXFUN(pthread_cond_broadcast, (pthread_cond_t *__cond)); + +/* Waiting on a Condition, P1003.1c/Draft 10, p. 105 */ + +int _EXFUN(pthread_cond_wait, + (pthread_cond_t *__cond, pthread_mutex_t *__mutex)); + +int _EXFUN(pthread_cond_timedwait, + (pthread_cond_t *__cond, pthread_mutex_t *__mutex, + _CONST struct timespec *__abstime)); + +#if defined(_POSIX_THREAD_PRIORITY_SCHEDULING) + +/* Thread Creation Scheduling Attributes, P1003.1c/Draft 10, p. 120 */ + +int _EXFUN(pthread_attr_setscope, + (pthread_attr_t *__attr, int __contentionscope)); +int _EXFUN(pthread_attr_getscope, + (_CONST pthread_attr_t *__attr, int *__contentionscope)); +int _EXFUN(pthread_attr_setinheritsched, + (pthread_attr_t *__attr, int __inheritsched)); +int _EXFUN(pthread_attr_getinheritsched, + (_CONST pthread_attr_t *__attr, int *__inheritsched)); +int _EXFUN(pthread_attr_setschedpolicy, + (pthread_attr_t *__attr, int __policy)); +int _EXFUN(pthread_attr_getschedpolicy, + (_CONST pthread_attr_t *__attr, int *__policy)); + +#endif /* defined(_POSIX_THREAD_PRIORITY_SCHEDULING) */ + +int _EXFUN(pthread_attr_setschedparam, + (pthread_attr_t *__attr, _CONST struct sched_param *__param)); +int _EXFUN(pthread_attr_getschedparam, + (_CONST pthread_attr_t *__attr, struct sched_param *__param)); + +#if defined(_POSIX_THREAD_PRIORITY_SCHEDULING) + +/* Dynamic Thread Scheduling Parameters Access, P1003.1c/Draft 10, p. 124 */ + +int _EXFUN(pthread_getschedparam, + (pthread_t __pthread, int *__policy, struct sched_param *__param)); +int _EXFUN(pthread_setschedparam, + (pthread_t __pthread, int __policy, struct sched_param *__param)); + +#endif /* defined(_POSIX_THREAD_PRIORITY_SCHEDULING) */ + +#if defined(_POSIX_THREAD_PRIO_INHERIT) || defined(_POSIX_THREAD_PRIO_PROTECT) + +/* Mutex Initialization Scheduling Attributes, P1003.1c/Draft 10, p. 128 */ + +int _EXFUN(pthread_mutexattr_setprotocol, + (pthread_mutexattr_t *__attr, int __protocol)); +int _EXFUN(pthread_mutexattr_getprotocol, + (_CONST pthread_mutexattr_t *__attr, int *__protocol)); +int _EXFUN(pthread_mutexattr_setprioceiling, + (pthread_mutexattr_t *__attr, int __prioceiling)); +int _EXFUN(pthread_mutexattr_getprioceiling, + (_CONST pthread_mutexattr_t *__attr, int *__prioceiling)); + +#endif /* _POSIX_THREAD_PRIO_INHERIT || _POSIX_THREAD_PRIO_PROTECT */ + +#if defined(_POSIX_THREAD_PRIO_PROTECT) + +/* Change the Priority Ceiling of a Mutex, P1003.1c/Draft 10, p. 131 */ + +int _EXFUN(pthread_mutex_setprioceiling, + (pthread_mutex_t *__mutex, int __prioceiling, int *__old_ceiling)); +int _EXFUN(pthread_mutex_getprioceiling, + (pthread_mutex_t *__mutex, int *__prioceiling)); + +#endif /* _POSIX_THREAD_PRIO_PROTECT */ + +/* Thread Creation Attributes, P1003.1c/Draft 10, p, 140 */ + +int _EXFUN(pthread_attr_init, (pthread_attr_t *__attr)); +int _EXFUN(pthread_attr_destroy, (pthread_attr_t *__attr)); +int _EXFUN(pthread_attr_setstack, (pthread_attr_t *attr, + void *__stackaddr, size_t __stacksize)); +int _EXFUN(pthread_attr_getstack, (_CONST pthread_attr_t *attr, + void **__stackaddr, size_t *__stacksize)); +int _EXFUN(pthread_attr_getstacksize, + (_CONST pthread_attr_t *__attr, size_t *__stacksize)); +int _EXFUN(pthread_attr_setstacksize, + (pthread_attr_t *__attr, size_t __stacksize)); +int _EXFUN(pthread_attr_getstackaddr, + (_CONST pthread_attr_t *__attr, void **__stackaddr)); +int _EXFUN(pthread_attr_setstackaddr, + (pthread_attr_t *__attr, void *__stackaddr)); +int _EXFUN(pthread_attr_getdetachstate, + (_CONST pthread_attr_t *__attr, int *__detachstate)); +int _EXFUN(pthread_attr_setdetachstate, + (pthread_attr_t *__attr, int __detachstate)); +int _EXFUN(pthread_attr_getguardsize, + (_CONST pthread_attr_t *__attr, size_t *__guardsize)); +int _EXFUN(pthread_attr_setguardsize, + (pthread_attr_t *__attr, size_t __guardsize)); + +/* POSIX thread APIs beyond the POSIX standard but provided + * in GNU/Linux. They may be provided by other OSes for + * compatibility. + */ +#if defined(__GNU_VISIBLE) +#if defined(__rtems__) +int _EXFUN(pthread_attr_setaffinity_np, + (pthread_attr_t *__attr, size_t __cpusetsize, + const cpu_set_t *__cpuset)); +int _EXFUN(pthread_attr_getaffinity_np, + (const pthread_attr_t *__attr, size_t __cpusetsize, + cpu_set_t *__cpuset)); + +int _EXFUN(pthread_setaffinity_np, + (pthread_t __id, size_t __cpusetsize, const cpu_set_t *__cpuset)); +int _EXFUN(pthread_getaffinity_np, + (const pthread_t __id, size_t __cpusetsize, cpu_set_t *__cpuset)); + +int _EXFUN(pthread_getattr_np, + (pthread_t __id, pthread_attr_t *__attr)); +#endif /* defined(__rtems__) */ +#endif /* defined(__GNU_VISIBLE) */ + +/* Thread Creation, P1003.1c/Draft 10, p. 144 */ + +int _EXFUN(pthread_create, + (pthread_t *__pthread, _CONST pthread_attr_t *__attr, + void *(*__start_routine)( void * ), void *__arg)); + +/* Wait for Thread Termination, P1003.1c/Draft 10, p. 147 */ + +int _EXFUN(pthread_join, (pthread_t __pthread, void **__value_ptr)); + +/* Detaching a Thread, P1003.1c/Draft 10, p. 149 */ + +int _EXFUN(pthread_detach, (pthread_t __pthread)); + +/* Thread Termination, p1003.1c/Draft 10, p. 150 */ + +void _EXFUN(pthread_exit, (void *__value_ptr)); + +/* Get Calling Thread's ID, p1003.1c/Draft 10, p. XXX */ + +pthread_t _EXFUN(pthread_self, (void)); + +/* Compare Thread IDs, p1003.1c/Draft 10, p. 153 */ + +int _EXFUN(pthread_equal, (pthread_t __t1, pthread_t __t2)); + +/* Dynamic Package Initialization */ + +/* This is used to statically initialize a pthread_once_t. Example: + + pthread_once_t once = PTHREAD_ONCE_INIT; + + NOTE: This is named inconsistently -- it should be INITIALIZER. */ + +#define PTHREAD_ONCE_INIT { 1, 0 } /* is initialized and not run */ + +int _EXFUN(pthread_once, + (pthread_once_t *__once_control, void (*__init_routine)(void))); + +/* Thread-Specific Data Key Create, P1003.1c/Draft 10, p. 163 */ + +int _EXFUN(pthread_key_create, + (pthread_key_t *__key, void (*__destructor)( void * ))); + +/* Thread-Specific Data Management, P1003.1c/Draft 10, p. 165 */ + +int _EXFUN(pthread_setspecific, + (pthread_key_t __key, _CONST void *__value)); +void * _EXFUN(pthread_getspecific, (pthread_key_t __key)); + +/* Thread-Specific Data Key Deletion, P1003.1c/Draft 10, p. 167 */ + +int _EXFUN(pthread_key_delete, (pthread_key_t __key)); + +/* Execution of a Thread, P1003.1c/Draft 10, p. 181 */ + +#define PTHREAD_CANCEL_ENABLE 0 +#define PTHREAD_CANCEL_DISABLE 1 + +#define PTHREAD_CANCEL_DEFERRED 0 +#define PTHREAD_CANCEL_ASYNCHRONOUS 1 + +#define PTHREAD_CANCELED ((void *) -1) + +int _EXFUN(pthread_cancel, (pthread_t __pthread)); + +/* Setting Cancelability State, P1003.1c/Draft 10, p. 183 */ + +int _EXFUN(pthread_setcancelstate, (int __state, int *__oldstate)); +int _EXFUN(pthread_setcanceltype, (int __type, int *__oldtype)); +void _EXFUN(pthread_testcancel, (void)); + +/* Establishing Cancellation Handlers, P1003.1c/Draft 10, p. 184 */ + +void _EXFUN(_pthread_cleanup_push, + (struct _pthread_cleanup_context *_context, + void (*_routine)(void *), void *_arg)); + +void _EXFUN(_pthread_cleanup_pop, + (struct _pthread_cleanup_context *_context, + int _execute)); + +/* It is intentional to open and close the scope in two different macros */ +#define pthread_cleanup_push(_routine, _arg) \ + do { \ + struct _pthread_cleanup_context _pthread_clup_ctx; \ + _pthread_cleanup_push(&_pthread_clup_ctx, (_routine), (_arg)) + +#define pthread_cleanup_pop(_execute) \ + _pthread_cleanup_pop(&_pthread_clup_ctx, (_execute)); \ + } while (0) + +#if defined(_GNU_SOURCE) +void _EXFUN(_pthread_cleanup_push_defer, + (struct _pthread_cleanup_context *_context, + void (*_routine)(void *), void *_arg)); + +void _EXFUN(_pthread_cleanup_pop_restore, + (struct _pthread_cleanup_context *_context, + int _execute)); + +/* It is intentional to open and close the scope in two different macros */ +#define pthread_cleanup_push_defer_np(_routine, _arg) \ + do { \ + struct _pthread_cleanup_context _pthread_clup_ctx; \ + _pthread_cleanup_push_defer(&_pthread_clup_ctx, (_routine), (_arg)) + +#define pthread_cleanup_pop_restore_np(_execute) \ + _pthread_cleanup_pop_restore(&_pthread_clup_ctx, (_execute)); \ + } while (0) +#endif /* defined(_GNU_SOURCE) */ + +#if defined(_POSIX_THREAD_CPUTIME) + +/* Accessing a Thread CPU-time Clock, P1003.4b/D8, p. 58 */ + +int _EXFUN(pthread_getcpuclockid, + (pthread_t __pthread_id, clockid_t *__clock_id)); + +#endif /* defined(_POSIX_THREAD_CPUTIME) */ + + +#endif /* defined(_POSIX_THREADS) */ + +#if defined(_POSIX_BARRIERS) + +int _EXFUN(pthread_barrierattr_init, (pthread_barrierattr_t *__attr)); +int _EXFUN(pthread_barrierattr_destroy, (pthread_barrierattr_t *__attr)); +int _EXFUN(pthread_barrierattr_getpshared, + (_CONST pthread_barrierattr_t *__attr, int *__pshared)); +int _EXFUN(pthread_barrierattr_setpshared, + (pthread_barrierattr_t *__attr, int __pshared)); + +#define PTHREAD_BARRIER_SERIAL_THREAD -1 + +int _EXFUN(pthread_barrier_init, + (pthread_barrier_t *__barrier, + _CONST pthread_barrierattr_t *__attr, unsigned __count)); +int _EXFUN(pthread_barrier_destroy, (pthread_barrier_t *__barrier)); +int _EXFUN(pthread_barrier_wait,(pthread_barrier_t *__barrier)); + +#endif /* defined(_POSIX_BARRIERS) */ + +#if defined(_POSIX_SPIN_LOCKS) + +int _EXFUN(pthread_spin_init, + (pthread_spinlock_t *__spinlock, int __pshared)); +int _EXFUN(pthread_spin_destroy, (pthread_spinlock_t *__spinlock)); +int _EXFUN(pthread_spin_lock, (pthread_spinlock_t *__spinlock)); +int _EXFUN(pthread_spin_trylock, (pthread_spinlock_t *__spinlock)); +int _EXFUN(pthread_spin_unlock, (pthread_spinlock_t *__spinlock)); + +#endif /* defined(_POSIX_SPIN_LOCKS) */ + +#if defined(_POSIX_READER_WRITER_LOCKS) + +/* This is used to statically initialize a pthread_rwlock_t. Example: + + pthread_mutex_t mutex = PTHREAD_RWLOCK_INITIALIZER; + */ + +#define PTHREAD_RWLOCK_INITIALIZER ((pthread_rwlock_t) 0xFFFFFFFF) + +int _EXFUN(pthread_rwlockattr_init, (pthread_rwlockattr_t *__attr)); +int _EXFUN(pthread_rwlockattr_destroy, (pthread_rwlockattr_t *__attr)); +int _EXFUN(pthread_rwlockattr_getpshared, + (_CONST pthread_rwlockattr_t *__attr, int *__pshared)); +int _EXFUN(pthread_rwlockattr_setpshared, + (pthread_rwlockattr_t *__attr, int __pshared)); + +int _EXFUN(pthread_rwlock_init, + (pthread_rwlock_t *__rwlock, _CONST pthread_rwlockattr_t *__attr)); +int _EXFUN(pthread_rwlock_destroy, (pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_rdlock,(pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_tryrdlock,(pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_timedrdlock, + (pthread_rwlock_t *__rwlock, _CONST struct timespec *__abstime)); +int _EXFUN(pthread_rwlock_unlock,(pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_wrlock,(pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_trywrlock,(pthread_rwlock_t *__rwlock)); +int _EXFUN(pthread_rwlock_timedwrlock, + (pthread_rwlock_t *__rwlock, _CONST struct timespec *__abstime)); + +#endif /* defined(_POSIX_READER_WRITER_LOCKS) */ + + +#ifdef __cplusplus +} +#endif + +#endif +/* end of include file */ diff --git a/components/newlib/include/pwd.h b/components/newlib/include/pwd.h new file mode 100644 index 000000000..3dea4ee2d --- /dev/null +++ b/components/newlib/include/pwd.h @@ -0,0 +1,87 @@ +/*- + * Copyright (c) 1989 The Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)pwd.h 5.13 (Berkeley) 5/28/91 + */ + +#ifndef _PWD_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _PWD_H_ + +#include +#include + +#if __BSD_VISIBLE +#define _PATH_PASSWD "/etc/passwd" + +#define _PASSWORD_LEN 128 /* max length, not counting NULL */ +#endif + +struct passwd { + char *pw_name; /* user name */ + char *pw_passwd; /* encrypted password */ + uid_t pw_uid; /* user uid */ + gid_t pw_gid; /* user gid */ + char *pw_comment; /* comment */ + char *pw_gecos; /* Honeywell login info */ + char *pw_dir; /* home directory */ + char *pw_shell; /* default shell */ +}; + +#ifndef __INSIDE_CYGWIN__ +struct passwd *getpwuid (uid_t); +struct passwd *getpwnam (const char *); + +#if __POSIX_VISIBLE >= 200112 || __XSI_VISIBLE >= 500 +int getpwnam_r (const char *, struct passwd *, + char *, size_t , struct passwd **); +int getpwuid_r (uid_t, struct passwd *, char *, + size_t, struct passwd **); +#endif + +#if __XSI_VISIBLE >= 500 +struct passwd *getpwent (void); +void setpwent (void); +void endpwent (void); +#endif + +#if __BSD_VISIBLE +int setpassent (int); +#endif +#endif /*!__INSIDE_CYGWIN__*/ + +#ifdef __cplusplus +} +#endif +#endif /* _PWD_H_ */ diff --git a/components/newlib/include/reent.h b/components/newlib/include/reent.h new file mode 100644 index 000000000..861be71d3 --- /dev/null +++ b/components/newlib/include/reent.h @@ -0,0 +1,189 @@ +/* This header file provides the reentrancy. */ + +/* The reentrant system calls here serve two purposes: + + 1) Provide reentrant versions of the system calls the ANSI C library + requires. + 2) Provide these system calls in a namespace clean way. + + It is intended that *all* system calls that the ANSI C library needs + be declared here. It documents them all in one place. All library access + to the system is via some form of these functions. + + The target may provide the needed syscalls by any of the following: + + 1) Define the reentrant versions of the syscalls directly. + (eg: _open_r, _close_r, etc.). Please keep the namespace clean. + When you do this, set "syscall_dir" to "syscalls" and add + -DREENTRANT_SYSCALLS_PROVIDED to newlib_cflags in configure.host. + + 2) Define namespace clean versions of the system calls by prefixing + them with '_' (eg: _open, _close, etc.). Technically, there won't be + true reentrancy at the syscall level, but the library will be namespace + clean. + When you do this, set "syscall_dir" to "syscalls" in configure.host. + + 3) Define or otherwise provide the regular versions of the syscalls + (eg: open, close, etc.). The library won't be reentrant nor namespace + clean, but at least it will work. + When you do this, add -DMISSING_SYSCALL_NAMES to newlib_cflags in + configure.host. + + 4) Define or otherwise provide the regular versions of the syscalls, + and do not supply functional interfaces for any of the reentrant + calls. With this method, the reentrant syscalls are redefined to + directly call the regular system call without the reentrancy argument. + When you do this, specify both -DREENTRANT_SYSCALLS_PROVIDED and + -DMISSING_SYSCALL_NAMES via newlib_cflags in configure.host and do + not specify "syscall_dir". + + Stubs of the reentrant versions of the syscalls exist in the libc/reent + source directory and are provided if REENTRANT_SYSCALLS_PROVIDED isn't + defined. These stubs call the native system calls: _open, _close, etc. + if MISSING_SYSCALL_NAMES is *not* defined, otherwise they call the + non-underscored versions: open, close, etc. when MISSING_SYSCALL_NAMES + *is* defined. + + By default, newlib functions call the reentrant syscalls internally, + passing a reentrancy structure as an argument. This reentrancy structure + contains data that is thread-specific. For example, the errno value is + kept in the reentrancy structure. If multiple threads exist, each will + keep a separate errno value which is intuitive since the application flow + cannot check for failure reliably otherwise. + + The reentrant syscalls are either provided by the platform, by the + libc/reent stubs, or in the case of both MISSING_SYSCALL_NAMES and + REENTRANT_SYSCALLS_PROVIDED being defined, the calls are redefined to + simply call the regular syscalls with no reentrancy struct argument. + + A single-threaded application does not need to worry about the reentrancy + structure. It is used internally. + + A multi-threaded application needs either to manually manage reentrancy + structures or use dynamic reentrancy. + + Manually managing reentrancy structures entails calling special reentrant + versions of newlib functions that have an additional reentrancy argument. + For example, _printf_r. By convention, the first argument is the + reentrancy structure. By default, the normal version of the function + uses the default reentrancy structure: _REENT. The reentrancy structure + is passed internally, eventually to the reentrant syscalls themselves. + How the structures are stored and accessed in this model is up to the + application. + + Dynamic reentrancy is specified by the __DYNAMIC_REENT__ flag. This + flag denotes setting up a macro to replace _REENT with a function call + to __getreent(). This function needs to be implemented by the platform + and it is meant to return the reentrancy structure for the current + thread. When the regular C functions (e.g. printf) go to call internal + routines with the default _REENT structure, they end up calling with + the reentrancy structure for the thread. Thus, application code does not + need to call the _r routines nor worry about reentrancy structures. */ + +/* WARNING: All identifiers here must begin with an underscore. This file is + included by stdio.h and others and we therefore must only use identifiers + in the namespace allotted to us. */ + +#ifndef _REENT_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _REENT_H_ + +#include +#include +#include + +#define __need_size_t +#define __need_ptrdiff_t +#include + +/* FIXME: not namespace clean */ +struct stat; +struct tms; +struct timeval; +struct timezone; + +#if defined(REENTRANT_SYSCALLS_PROVIDED) && defined(MISSING_SYSCALL_NAMES) + +#define _close_r(__reent, __fd) close(__fd) +#define _execve_r(__reent, __f, __arg, __env) execve(__f, __arg, __env) +#define _fcntl_r(__reent, __fd, __cmd, __arg) fcntl(__fd, __cmd, __arg) +#define _fork_r(__reent) fork() +#define _fstat_r(__reent, __fdes, __stat) fstat(__fdes, __stat) +#define _getpid_r(__reent) getpid() +#define _isatty_r(__reent, __desc) isatty(__desc) +#define _kill_r(__reent, __pid, __signal) kill(__pid, __signal) +#define _link_r(__reent, __oldpath, __newpath) link(__oldpath, __newpath) +#define _lseek_r(__reent, __fdes, __off, __w) lseek(__fdes, __off, __w) +#define _mkdir_r(__reent, __path, __m) mkdir(__path, __m) +#define _open_r(__reent, __path, __flag, __m) open(__path, __flag, __m) +#define _read_r(__reent, __fd, __buff, __cnt) read(__fd, __buff, __cnt) +#define _rename_r(__reent, __old, __new) rename(__old, __new) +#define _sbrk_r(__reent, __incr) sbrk(__incr) +#define _stat_r(__reent, __path, __buff) stat(__path, __buff) +#define _times_r(__reent, __time) times(__time) +#define _unlink_r(__reent, __path) unlink(__path) +#define _wait_r(__reent, __status) wait(__status) +#define _write_r(__reent, __fd, __buff, __cnt) write(__fd, __buff, __cnt) +#define _gettimeofday_r(__reent, __tp, __tzp) gettimeofday(__tp, __tzp) + +#ifdef __LARGE64_FILES +#define _lseek64_r(__reent, __fd, __off, __w) lseek64(__fd, __off, __w) +#define _fstat64_r(__reent, __fd, __buff) fstat64(__fd, __buff) +#define _open64_r(__reent, __path, __flag, __m) open64(__path, __flag, __m) +#endif + +#else +/* Reentrant versions of system calls. */ + +extern int _close_r _PARAMS ((struct _reent *, int)); +extern int _execve_r _PARAMS ((struct _reent *, const char *, char *const *, char *const *)); +extern int _fcntl_r _PARAMS ((struct _reent *, int, int, int)); +extern int _fork_r _PARAMS ((struct _reent *)); +extern int _fstat_r _PARAMS ((struct _reent *, int, struct stat *)); +extern int _getpid_r _PARAMS ((struct _reent *)); +extern int _isatty_r _PARAMS ((struct _reent *, int)); +extern int _kill_r _PARAMS ((struct _reent *, int, int)); +extern int _link_r _PARAMS ((struct _reent *, const char *, const char *)); +extern _off_t _lseek_r _PARAMS ((struct _reent *, int, _off_t, int)); +extern int _mkdir_r _PARAMS ((struct _reent *, const char *, int)); +extern int _open_r _PARAMS ((struct _reent *, const char *, int, int)); +extern _ssize_t _read_r _PARAMS ((struct _reent *, int, void *, size_t)); +extern int _rename_r _PARAMS ((struct _reent *, const char *, const char *)); +extern void *_sbrk_r _PARAMS ((struct _reent *, ptrdiff_t)); +extern int _stat_r _PARAMS ((struct _reent *, const char *, struct stat *)); +extern _CLOCK_T_ _times_r _PARAMS ((struct _reent *, struct tms *)); +extern int _unlink_r _PARAMS ((struct _reent *, const char *)); +extern int _wait_r _PARAMS ((struct _reent *, int *)); +extern _ssize_t _write_r _PARAMS ((struct _reent *, int, const void *, size_t)); + +/* This one is not guaranteed to be available on all targets. */ +extern int _gettimeofday_r _PARAMS ((struct _reent *, struct timeval *__tp, void *__tzp)); + +#ifdef __LARGE64_FILES + + +#if defined(__CYGWIN__) +#define stat64 stat +#endif +struct stat64; + +extern _off64_t _lseek64_r _PARAMS ((struct _reent *, int, _off64_t, int)); +extern int _fstat64_r _PARAMS ((struct _reent *, int, struct stat64 *)); +extern int _open64_r _PARAMS ((struct _reent *, const char *, int, int)); +extern int _stat64_r _PARAMS ((struct _reent *, const char *, struct stat64 *)); + +/* Don't pollute namespace if not building newlib. */ +#if defined (__CYGWIN__) && !defined (_COMPILING_NEWLIB) +#undef stat64 +#endif + +#endif + +#endif + +#ifdef __cplusplus +} +#endif +#endif /* _REENT_H_ */ diff --git a/components/newlib/include/regdef.h b/components/newlib/include/regdef.h new file mode 100644 index 000000000..8cf144b85 --- /dev/null +++ b/components/newlib/include/regdef.h @@ -0,0 +1,7 @@ +/* regdef.h -- define register names. */ + +/* This is a standard include file for MIPS targets. Other target + probably don't define it, and attempts to include this file will + fail. */ + +#include diff --git a/components/newlib/include/regex.h b/components/newlib/include/regex.h new file mode 100644 index 000000000..fa3e26879 --- /dev/null +++ b/components/newlib/include/regex.h @@ -0,0 +1,103 @@ +/*- + * Copyright (c) 1992 Henry Spencer. + * Copyright (c) 1992, 1993 + * The Regents of the University of California. All rights reserved. + * + * This code is derived from software contributed to Berkeley by + * Henry Spencer of the University of Toronto. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)regex.h 8.2 (Berkeley) 1/3/94 + * $FreeBSD: src/include/regex.h,v 1.4 2002/03/23 17:24:53 imp Exp $ + */ + +#ifndef _REGEX_H_ +#define _REGEX_H_ + +#include + +/* types */ +typedef off_t regoff_t; + +typedef struct { + int re_magic; + size_t re_nsub; /* number of parenthesized subexpressions */ + __const char *re_endp; /* end pointer for REG_PEND */ + struct re_guts *re_g; /* none of your business :-) */ +} regex_t; + +typedef struct { + regoff_t rm_so; /* start of match */ + regoff_t rm_eo; /* end of match */ +} regmatch_t; + +/* regcomp() flags */ +#define REG_BASIC 0000 +#define REG_EXTENDED 0001 +#define REG_ICASE 0002 +#define REG_NOSUB 0004 +#define REG_NEWLINE 0010 +#define REG_NOSPEC 0020 +#define REG_PEND 0040 +#define REG_DUMP 0200 + +/* regerror() flags */ +#define REG_NOMATCH 1 +#define REG_BADPAT 2 +#define REG_ECOLLATE 3 +#define REG_ECTYPE 4 +#define REG_EESCAPE 5 +#define REG_ESUBREG 6 +#define REG_EBRACK 7 +#define REG_EPAREN 8 +#define REG_EBRACE 9 +#define REG_BADBR 10 +#define REG_ERANGE 11 +#define REG_ESPACE 12 +#define REG_BADRPT 13 +#define REG_EMPTY 14 +#define REG_ASSERT 15 +#define REG_INVARG 16 +#define REG_ATOI 255 /* convert name to number (!) */ +#define REG_ITOA 0400 /* convert number to name (!) */ + +/* regexec() flags */ +#define REG_NOTBOL 00001 +#define REG_NOTEOL 00002 +#define REG_STARTEND 00004 +#define REG_TRACE 00400 /* tracing of execution */ +#define REG_LARGE 01000 /* force large representation */ +#define REG_BACKR 02000 /* force use of backref code */ + +__BEGIN_DECLS +int regcomp(regex_t *__restrict, const char *__restrict, int); +size_t regerror(int, const regex_t *__restrict, char *__restrict, size_t); +int regexec(const regex_t *__restrict, const char *__restrict, + size_t, regmatch_t [__restrict], int); +void regfree(regex_t *); +__END_DECLS + +#endif /* !_REGEX_H_ */ diff --git a/components/newlib/include/sched.h b/components/newlib/include/sched.h new file mode 100644 index 000000000..504ad5274 --- /dev/null +++ b/components/newlib/include/sched.h @@ -0,0 +1,97 @@ +/* + * Written by Joel Sherrill . + * + * COPYRIGHT (c) 1989-2010. + * On-Line Applications Research Corporation (OAR). + * + * Permission to use, copy, modify, and distribute this software for any + * purpose without fee is hereby granted, provided that this entire notice + * is included in all copies of any software which is or includes a copy + * or modification of this software. + * + * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED + * WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION + * OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS + * SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + * + * $Id$ + */ + +#ifndef _SCHED_H_ +#define _SCHED_H_ + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#if defined(_POSIX_PRIORITY_SCHEDULING) +/* + * XBD 13 - Set Scheduling Parameters, P1003.1b-2008, p. 1803 + */ +int sched_setparam( + pid_t __pid, + const struct sched_param *__param +); + +/* + * XBD 13 - Set Scheduling Parameters, P1003.1b-2008, p. 1800 + */ +int sched_getparam( + pid_t __pid, + struct sched_param *__param +); + +/* + * XBD 13 - Set Scheduling Policy and Scheduling Parameters, + * P1003.1b-2008, p. 1805 + */ +int sched_setscheduler( + pid_t __pid, + int __policy, + const struct sched_param *__param +); + +/* + * XBD 13 - Get Scheduling Policy, P1003.1b-2008, p. 1801 + */ +int sched_getscheduler( + pid_t __pid +); + +/* + * XBD 13 - Get Scheduling Parameter Limits, P1003.1b-2008, p. 1799 + */ +int sched_get_priority_max( + int __policy +); + +int sched_get_priority_min( + int __policy +); + +/* + * XBD 13 - Get Scheduling Parameter Limits, P1003.1b-2008, p. 1802 + */ +int sched_rr_get_interval( + pid_t __pid, + struct timespec *__interval +); +#endif /* _POSIX_PRIORITY_SCHEDULING */ + +#if defined(_POSIX_THREADS) || defined(_POSIX_PRIORITY_SCHEDULING) + +/* + * XBD 13 - Yield Processor, P1003.1b-2008, p. 1807 + */ +int sched_yield( void ); + +#endif /* _POSIX_THREADS or _POSIX_PRIORITY_SCHEDULING */ + +#ifdef __cplusplus +} +#endif + +#endif /* _SCHED_H_ */ diff --git a/components/newlib/include/search.h b/components/newlib/include/search.h new file mode 100644 index 000000000..ed321b0f6 --- /dev/null +++ b/components/newlib/include/search.h @@ -0,0 +1,64 @@ +/* $NetBSD: search.h,v 1.12 1999/02/22 10:34:28 christos Exp $ */ +/* $FreeBSD: src/include/search.h,v 1.4 2002/03/23 17:24:53 imp Exp $ */ + +/* + * Written by J.T. Conklin + * Public domain. + */ + +#ifndef _SEARCH_H_ +#define _SEARCH_H_ + +#include +#include +#include + +typedef struct entry { + char *key; + void *data; +} ENTRY; + +typedef enum { + FIND, ENTER +} ACTION; + +typedef enum { + preorder, + postorder, + endorder, + leaf +} VISIT; + +#ifdef _SEARCH_PRIVATE +typedef struct node { + char *key; + struct node *llink, *rlink; +} node_t; +#endif + +struct hsearch_data +{ + struct internal_head *htable; + size_t htablesize; +}; + +#ifndef __compar_fn_t_defined +#define __compar_fn_t_defined +typedef int (*__compar_fn_t) (const void *, const void *); +#endif + +__BEGIN_DECLS +int hcreate(size_t); +void hdestroy(void); +ENTRY *hsearch(ENTRY, ACTION); +int hcreate_r(size_t, struct hsearch_data *); +void hdestroy_r(struct hsearch_data *); +int hsearch_r(ENTRY, ACTION, ENTRY **, struct hsearch_data *); +void *tdelete(const void *__restrict, void **__restrict, __compar_fn_t); +void tdestroy (void *, void (*)(void *)); +void *tfind(const void *, void **, __compar_fn_t); +void *tsearch(const void *, void **, __compar_fn_t); +void twalk(const void *, void (*)(const void *, VISIT, int)); +__END_DECLS + +#endif /* !_SEARCH_H_ */ diff --git a/components/newlib/include/setjmp.h b/components/newlib/include/setjmp.h new file mode 100644 index 000000000..3d815d9b9 --- /dev/null +++ b/components/newlib/include/setjmp.h @@ -0,0 +1,27 @@ +/* + setjmp.h + stubs for future use. +*/ + +#ifndef _SETJMP_H_ +#define _SETJMP_H_ + +#include "_ansi.h" +#include + +_BEGIN_STD_C + +#ifdef __GNUC__ +void _EXFUN(longjmp,(jmp_buf __jmpb, int __retval)) + __attribute__ ((__noreturn__)); +#else +void _EXFUN(longjmp,(jmp_buf __jmpb, int __retval)); +#endif +int _EXFUN(setjmp,(jmp_buf __jmpb)); +#define setjmp(env) setjmp(env) + + +_END_STD_C + +#endif /* _SETJMP_H_ */ + diff --git a/components/newlib/include/signal.h b/components/newlib/include/signal.h new file mode 100644 index 000000000..8c50a2eb3 --- /dev/null +++ b/components/newlib/include/signal.h @@ -0,0 +1,32 @@ +#ifndef _SIGNAL_H_ +#define _SIGNAL_H_ + +#include "_ansi.h" +#include + +_BEGIN_STD_C + +typedef int sig_atomic_t; /* Atomic entity type (ANSI) */ +#ifndef _POSIX_SOURCE +typedef _sig_func_ptr sig_t; /* BSD naming */ +typedef _sig_func_ptr sighandler_t; /* glibc naming */ +#endif /* !_POSIX_SOURCE */ + +#define SIG_DFL ((_sig_func_ptr)0) /* Default action */ +#define SIG_IGN ((_sig_func_ptr)1) /* Ignore action */ +#define SIG_ERR ((_sig_func_ptr)-1) /* Error return */ + +struct _reent; + +_sig_func_ptr _EXFUN(_signal_r, (struct _reent *, int, _sig_func_ptr)); +int _EXFUN(_raise_r, (struct _reent *, int)); + +#ifndef _REENT_ONLY +_sig_func_ptr _EXFUN(signal, (int, _sig_func_ptr)); +int _EXFUN(raise, (int)); +void _EXFUN(psignal, (int, const char *)); +#endif + +_END_STD_C + +#endif /* _SIGNAL_H_ */ diff --git a/components/newlib/include/spawn.h b/components/newlib/include/spawn.h new file mode 100644 index 000000000..5a6692f11 --- /dev/null +++ b/components/newlib/include/spawn.h @@ -0,0 +1,119 @@ +/*- + * Copyright (c) 2008 Ed Schouten + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#ifndef _SPAWN_H_ +#define _SPAWN_H_ + +#include <_ansi.h> +#include +#include +#include +#define __need_sigset_t +#include + +struct sched_param; + +typedef struct __posix_spawnattr *posix_spawnattr_t; +typedef struct __posix_spawn_file_actions *posix_spawn_file_actions_t; + +#define POSIX_SPAWN_RESETIDS 0x01 +#define POSIX_SPAWN_SETPGROUP 0x02 +#define POSIX_SPAWN_SETSCHEDPARAM 0x04 +#define POSIX_SPAWN_SETSCHEDULER 0x08 +#define POSIX_SPAWN_SETSIGDEF 0x10 +#define POSIX_SPAWN_SETSIGMASK 0x20 + +_BEGIN_STD_C +/* + * Spawn routines + * + * XXX both arrays should be __restrict, but this does not work when GCC + * is invoked with -std=c99. + */ +int _EXFUN(posix_spawn, (pid_t * __restrict, const char * __restrict, + const posix_spawn_file_actions_t *, const posix_spawnattr_t * __restrict, + char * const [], char * const []) +); +int _EXFUN(posix_spawnp, (pid_t * __restrict, const char * __restrict, + const posix_spawn_file_actions_t *, const posix_spawnattr_t * __restrict, + char * const [], char * const []) +); + +/* + * File descriptor actions + */ +int _EXFUN(posix_spawn_file_actions_init, (posix_spawn_file_actions_t *)); +int _EXFUN(posix_spawn_file_actions_destroy, (posix_spawn_file_actions_t *)); + +int _EXFUN(posix_spawn_file_actions_addopen, + (posix_spawn_file_actions_t * __restrict, int, const char * __restrict, int, mode_t) +); +int _EXFUN(posix_spawn_file_actions_adddup2, + (posix_spawn_file_actions_t *, int, int) +); +int _EXFUN(posix_spawn_file_actions_addclose, + (posix_spawn_file_actions_t *, int) +); + +/* + * Spawn attributes + */ +int _EXFUN(posix_spawnattr_init, (posix_spawnattr_t *)); +int _EXFUN(posix_spawnattr_destroy, (posix_spawnattr_t *)); + +int _EXFUN(posix_spawnattr_getflags, + (const posix_spawnattr_t * __restrict, short * __restrict) +); +int _EXFUN(posix_spawnattr_getpgroup, + (const posix_spawnattr_t * __restrict, pid_t * __restrict)); +int _EXFUN(posix_spawnattr_getschedparam, + (const posix_spawnattr_t * __restrict, struct sched_param * __restrict) +); +int _EXFUN(posix_spawnattr_getschedpolicy, + (const posix_spawnattr_t * __restrict, int * __restrict) +); +int _EXFUN(posix_spawnattr_getsigdefault, + (const posix_spawnattr_t * __restrict, sigset_t * __restrict) +); +int _EXFUN(posix_spawnattr_getsigmask, + (const posix_spawnattr_t * __restrict, sigset_t * __restrict) +); + +int _EXFUN(posix_spawnattr_setflags, (posix_spawnattr_t *, short)); +int _EXFUN(posix_spawnattr_setpgroup, (posix_spawnattr_t *, pid_t)); +int _EXFUN(posix_spawnattr_setschedparam, + (posix_spawnattr_t * __restrict, const struct sched_param * __restrict) +); +int _EXFUN(posix_spawnattr_setschedpolicy, (posix_spawnattr_t *, int)); +int _EXFUN(posix_spawnattr_setsigdefault, + (posix_spawnattr_t * __restrict, const sigset_t * __restrict) +); +int _EXFUN(posix_spawnattr_setsigmask, + (posix_spawnattr_t * __restrict, const sigset_t * __restrict) +); +_END_STD_C + +#endif /* !_SPAWN_H_ */ diff --git a/components/newlib/include/stdatomic.h b/components/newlib/include/stdatomic.h new file mode 100644 index 000000000..09c0cf73e --- /dev/null +++ b/components/newlib/include/stdatomic.h @@ -0,0 +1,413 @@ +/*- + * Copyright (c) 2011 Ed Schouten + * David Chisnall + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _STDATOMIC_H_ +#define _STDATOMIC_H_ + +#include +#include + +#if __has_extension(c_atomic) || __has_extension(cxx_atomic) +#define __CLANG_ATOMICS +#elif __GNUC_PREREQ__(4, 7) +#define __GNUC_ATOMICS +#elif defined(__GNUC__) +#define __SYNC_ATOMICS +#else +#error "stdatomic.h does not support your compiler" +#endif + +/* + * 7.17.1 Atomic lock-free macros. + */ + +#ifdef __GCC_ATOMIC_BOOL_LOCK_FREE +#define ATOMIC_BOOL_LOCK_FREE __GCC_ATOMIC_BOOL_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_CHAR_LOCK_FREE +#define ATOMIC_CHAR_LOCK_FREE __GCC_ATOMIC_CHAR_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_CHAR16_T_LOCK_FREE +#define ATOMIC_CHAR16_T_LOCK_FREE __GCC_ATOMIC_CHAR16_T_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_CHAR32_T_LOCK_FREE +#define ATOMIC_CHAR32_T_LOCK_FREE __GCC_ATOMIC_CHAR32_T_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_WCHAR_T_LOCK_FREE +#define ATOMIC_WCHAR_T_LOCK_FREE __GCC_ATOMIC_WCHAR_T_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_SHORT_LOCK_FREE +#define ATOMIC_SHORT_LOCK_FREE __GCC_ATOMIC_SHORT_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_INT_LOCK_FREE +#define ATOMIC_INT_LOCK_FREE __GCC_ATOMIC_INT_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_LONG_LOCK_FREE +#define ATOMIC_LONG_LOCK_FREE __GCC_ATOMIC_LONG_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_LLONG_LOCK_FREE +#define ATOMIC_LLONG_LOCK_FREE __GCC_ATOMIC_LLONG_LOCK_FREE +#endif +#ifdef __GCC_ATOMIC_POINTER_LOCK_FREE +#define ATOMIC_POINTER_LOCK_FREE __GCC_ATOMIC_POINTER_LOCK_FREE +#endif + +/* + * 7.17.2 Initialization. + */ + +#if defined(__CLANG_ATOMICS) +#define ATOMIC_VAR_INIT(value) (value) +#define atomic_init(obj, value) __c11_atomic_init(obj, value) +#else +#define ATOMIC_VAR_INIT(value) { .__val = (value) } +#define atomic_init(obj, value) ((void)((obj)->__val = (value))) +#endif + +/* + * Clang and recent GCC both provide predefined macros for the memory + * orderings. If we are using a compiler that doesn't define them, use the + * clang values - these will be ignored in the fallback path. + */ + +#ifndef __ATOMIC_RELAXED +#define __ATOMIC_RELAXED 0 +#endif +#ifndef __ATOMIC_CONSUME +#define __ATOMIC_CONSUME 1 +#endif +#ifndef __ATOMIC_ACQUIRE +#define __ATOMIC_ACQUIRE 2 +#endif +#ifndef __ATOMIC_RELEASE +#define __ATOMIC_RELEASE 3 +#endif +#ifndef __ATOMIC_ACQ_REL +#define __ATOMIC_ACQ_REL 4 +#endif +#ifndef __ATOMIC_SEQ_CST +#define __ATOMIC_SEQ_CST 5 +#endif + +/* + * 7.17.3 Order and consistency. + * + * The memory_order_* constants that denote the barrier behaviour of the + * atomic operations. + */ + +typedef enum { + memory_order_relaxed = __ATOMIC_RELAXED, + memory_order_consume = __ATOMIC_CONSUME, + memory_order_acquire = __ATOMIC_ACQUIRE, + memory_order_release = __ATOMIC_RELEASE, + memory_order_acq_rel = __ATOMIC_ACQ_REL, + memory_order_seq_cst = __ATOMIC_SEQ_CST +} memory_order; + +/* + * 7.17.4 Fences. + */ + +static __inline void +atomic_thread_fence(memory_order __order __unused) +{ + +#ifdef __CLANG_ATOMICS + __c11_atomic_thread_fence(__order); +#elif defined(__GNUC_ATOMICS) + __atomic_thread_fence(__order); +#else + __sync_synchronize(); +#endif +} + +static __inline void +atomic_signal_fence(memory_order __order __unused) +{ + +#ifdef __CLANG_ATOMICS + __c11_atomic_signal_fence(__order); +#elif defined(__GNUC_ATOMICS) + __atomic_signal_fence(__order); +#else + __asm volatile ("" ::: "memory"); +#endif +} + +/* + * 7.17.5 Lock-free property. + */ + +#if defined(_KERNEL) +/* Atomics in kernelspace are always lock-free. */ +#define atomic_is_lock_free(obj) \ + ((void)(obj), (_Bool)1) +#elif defined(__CLANG_ATOMICS) +#define atomic_is_lock_free(obj) \ + __atomic_is_lock_free(sizeof(*(obj)), obj) +#elif defined(__GNUC_ATOMICS) +#define atomic_is_lock_free(obj) \ + __atomic_is_lock_free(sizeof((obj)->__val), &(obj)->__val) +#else +#define atomic_is_lock_free(obj) \ + ((void)(obj), sizeof((obj)->__val) <= sizeof(void *)) +#endif + +/* + * 7.17.6 Atomic integer types. + */ + +typedef _Atomic(_Bool) atomic_bool; +typedef _Atomic(char) atomic_char; +typedef _Atomic(signed char) atomic_schar; +typedef _Atomic(unsigned char) atomic_uchar; +typedef _Atomic(short) atomic_short; +typedef _Atomic(unsigned short) atomic_ushort; +typedef _Atomic(int) atomic_int; +typedef _Atomic(unsigned int) atomic_uint; +typedef _Atomic(long) atomic_long; +typedef _Atomic(unsigned long) atomic_ulong; +typedef _Atomic(long long) atomic_llong; +typedef _Atomic(unsigned long long) atomic_ullong; +#if 0 +typedef _Atomic(__char16_t) atomic_char16_t; +typedef _Atomic(__char32_t) atomic_char32_t; +#endif +typedef _Atomic(wchar_t) atomic_wchar_t; +typedef _Atomic(int_least8_t) atomic_int_least8_t; +typedef _Atomic(uint_least8_t) atomic_uint_least8_t; +typedef _Atomic(int_least16_t) atomic_int_least16_t; +typedef _Atomic(uint_least16_t) atomic_uint_least16_t; +typedef _Atomic(int_least32_t) atomic_int_least32_t; +typedef _Atomic(uint_least32_t) atomic_uint_least32_t; +typedef _Atomic(int_least64_t) atomic_int_least64_t; +typedef _Atomic(uint_least64_t) atomic_uint_least64_t; +typedef _Atomic(int_fast8_t) atomic_int_fast8_t; +typedef _Atomic(uint_fast8_t) atomic_uint_fast8_t; +typedef _Atomic(int_fast16_t) atomic_int_fast16_t; +typedef _Atomic(uint_fast16_t) atomic_uint_fast16_t; +typedef _Atomic(int_fast32_t) atomic_int_fast32_t; +typedef _Atomic(uint_fast32_t) atomic_uint_fast32_t; +typedef _Atomic(int_fast64_t) atomic_int_fast64_t; +typedef _Atomic(uint_fast64_t) atomic_uint_fast64_t; +typedef _Atomic(intptr_t) atomic_intptr_t; +typedef _Atomic(uintptr_t) atomic_uintptr_t; +typedef _Atomic(size_t) atomic_size_t; +typedef _Atomic(ptrdiff_t) atomic_ptrdiff_t; +typedef _Atomic(intmax_t) atomic_intmax_t; +typedef _Atomic(uintmax_t) atomic_uintmax_t; + +/* + * 7.17.7 Operations on atomic types. + */ + +/* + * Compiler-specific operations. + */ + +#if defined(__CLANG_ATOMICS) +#define atomic_compare_exchange_strong_explicit(object, expected, \ + desired, success, failure) \ + __c11_atomic_compare_exchange_strong(object, expected, desired, \ + success, failure) +#define atomic_compare_exchange_weak_explicit(object, expected, \ + desired, success, failure) \ + __c11_atomic_compare_exchange_weak(object, expected, desired, \ + success, failure) +#define atomic_exchange_explicit(object, desired, order) \ + __c11_atomic_exchange(object, desired, order) +#define atomic_fetch_add_explicit(object, operand, order) \ + __c11_atomic_fetch_add(object, operand, order) +#define atomic_fetch_and_explicit(object, operand, order) \ + __c11_atomic_fetch_and(object, operand, order) +#define atomic_fetch_or_explicit(object, operand, order) \ + __c11_atomic_fetch_or(object, operand, order) +#define atomic_fetch_sub_explicit(object, operand, order) \ + __c11_atomic_fetch_sub(object, operand, order) +#define atomic_fetch_xor_explicit(object, operand, order) \ + __c11_atomic_fetch_xor(object, operand, order) +#define atomic_load_explicit(object, order) \ + __c11_atomic_load(object, order) +#define atomic_store_explicit(object, desired, order) \ + __c11_atomic_store(object, desired, order) +#elif defined(__GNUC_ATOMICS) +#define atomic_compare_exchange_strong_explicit(object, expected, \ + desired, success, failure) \ + __atomic_compare_exchange_n(&(object)->__val, expected, \ + desired, 0, success, failure) +#define atomic_compare_exchange_weak_explicit(object, expected, \ + desired, success, failure) \ + __atomic_compare_exchange_n(&(object)->__val, expected, \ + desired, 1, success, failure) +#define atomic_exchange_explicit(object, desired, order) \ + __atomic_exchange_n(&(object)->__val, desired, order) +#define atomic_fetch_add_explicit(object, operand, order) \ + __atomic_fetch_add(&(object)->__val, operand, order) +#define atomic_fetch_and_explicit(object, operand, order) \ + __atomic_fetch_and(&(object)->__val, operand, order) +#define atomic_fetch_or_explicit(object, operand, order) \ + __atomic_fetch_or(&(object)->__val, operand, order) +#define atomic_fetch_sub_explicit(object, operand, order) \ + __atomic_fetch_sub(&(object)->__val, operand, order) +#define atomic_fetch_xor_explicit(object, operand, order) \ + __atomic_fetch_xor(&(object)->__val, operand, order) +#define atomic_load_explicit(object, order) \ + __atomic_load_n(&(object)->__val, order) +#define atomic_store_explicit(object, desired, order) \ + __atomic_store_n(&(object)->__val, desired, order) +#else +#define __atomic_apply_stride(object, operand) \ + (((__typeof__((object)->__val))0) + (operand)) +#define atomic_compare_exchange_strong_explicit(object, expected, \ + desired, success, failure) __extension__ ({ \ + __typeof__(expected) __ep = (expected); \ + __typeof__(*__ep) __e = *__ep; \ + (void)(success); (void)(failure); \ + (_Bool)((*__ep = __sync_val_compare_and_swap(&(object)->__val, \ + __e, desired)) == __e); \ +}) +#define atomic_compare_exchange_weak_explicit(object, expected, \ + desired, success, failure) \ + atomic_compare_exchange_strong_explicit(object, expected, \ + desired, success, failure) +#if __has_builtin(__sync_swap) +/* Clang provides a full-barrier atomic exchange - use it if available. */ +#define atomic_exchange_explicit(object, desired, order) \ + ((void)(order), __sync_swap(&(object)->__val, desired)) +#else +/* + * __sync_lock_test_and_set() is only an acquire barrier in theory (although in + * practice it is usually a full barrier) so we need an explicit barrier before + * it. + */ +#define atomic_exchange_explicit(object, desired, order) \ +__extension__ ({ \ + __typeof__(object) __o = (object); \ + __typeof__(desired) __d = (desired); \ + (void)(order); \ + __sync_synchronize(); \ + __sync_lock_test_and_set(&(__o)->__val, __d); \ +}) +#endif +#define atomic_fetch_add_explicit(object, operand, order) \ + ((void)(order), __sync_fetch_and_add(&(object)->__val, \ + __atomic_apply_stride(object, operand))) +#define atomic_fetch_and_explicit(object, operand, order) \ + ((void)(order), __sync_fetch_and_and(&(object)->__val, operand)) +#define atomic_fetch_or_explicit(object, operand, order) \ + ((void)(order), __sync_fetch_and_or(&(object)->__val, operand)) +#define atomic_fetch_sub_explicit(object, operand, order) \ + ((void)(order), __sync_fetch_and_sub(&(object)->__val, \ + __atomic_apply_stride(object, operand))) +#define atomic_fetch_xor_explicit(object, operand, order) \ + ((void)(order), __sync_fetch_and_xor(&(object)->__val, operand)) +#define atomic_load_explicit(object, order) \ + ((void)(order), __sync_fetch_and_add(&(object)->__val, 0)) +#define atomic_store_explicit(object, desired, order) \ + ((void)atomic_exchange_explicit(object, desired, order)) +#endif + +/* + * Convenience functions. + * + * Don't provide these in kernel space. In kernel space, we should be + * disciplined enough to always provide explicit barriers. + */ + +#ifndef _KERNEL +#define atomic_compare_exchange_strong(object, expected, desired) \ + atomic_compare_exchange_strong_explicit(object, expected, \ + desired, memory_order_seq_cst, memory_order_seq_cst) +#define atomic_compare_exchange_weak(object, expected, desired) \ + atomic_compare_exchange_weak_explicit(object, expected, \ + desired, memory_order_seq_cst, memory_order_seq_cst) +#define atomic_exchange(object, desired) \ + atomic_exchange_explicit(object, desired, memory_order_seq_cst) +#define atomic_fetch_add(object, operand) \ + atomic_fetch_add_explicit(object, operand, memory_order_seq_cst) +#define atomic_fetch_and(object, operand) \ + atomic_fetch_and_explicit(object, operand, memory_order_seq_cst) +#define atomic_fetch_or(object, operand) \ + atomic_fetch_or_explicit(object, operand, memory_order_seq_cst) +#define atomic_fetch_sub(object, operand) \ + atomic_fetch_sub_explicit(object, operand, memory_order_seq_cst) +#define atomic_fetch_xor(object, operand) \ + atomic_fetch_xor_explicit(object, operand, memory_order_seq_cst) +#define atomic_load(object) \ + atomic_load_explicit(object, memory_order_seq_cst) +#define atomic_store(object, desired) \ + atomic_store_explicit(object, desired, memory_order_seq_cst) +#endif /* !_KERNEL */ + +/* + * 7.17.8 Atomic flag type and operations. + * + * XXX: Assume atomic_bool can be used as an atomic_flag. Is there some + * kind of compiler built-in type we could use? + */ + +typedef struct { + atomic_bool __flag; +} atomic_flag; + +#define ATOMIC_FLAG_INIT { ATOMIC_VAR_INIT(0) } + +static __inline _Bool +atomic_flag_test_and_set_explicit(volatile atomic_flag *__object, + memory_order __order) +{ + return (atomic_exchange_explicit(&__object->__flag, 1, __order)); +} + +static __inline void +atomic_flag_clear_explicit(volatile atomic_flag *__object, memory_order __order) +{ + + atomic_store_explicit(&__object->__flag, 0, __order); +} + +#ifndef _KERNEL +static __inline _Bool +atomic_flag_test_and_set(volatile atomic_flag *__object) +{ + + return (atomic_flag_test_and_set_explicit(__object, + memory_order_seq_cst)); +} + +static __inline void +atomic_flag_clear(volatile atomic_flag *__object) +{ + + atomic_flag_clear_explicit(__object, memory_order_seq_cst); +} +#endif /* !_KERNEL */ + +#endif /* !_STDATOMIC_H_ */ diff --git a/components/newlib/include/stdint.h b/components/newlib/include/stdint.h new file mode 100644 index 000000000..7386164b9 --- /dev/null +++ b/components/newlib/include/stdint.h @@ -0,0 +1,511 @@ +/* + * Copyright (c) 2004, 2005 by + * Ralf Corsepius, Ulm/Germany. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + */ + +#ifndef _STDINT_H +#define _STDINT_H + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef ___int8_t_defined +typedef __int8_t int8_t ; +typedef __uint8_t uint8_t ; +#define __int8_t_defined 1 +#endif + +#ifdef ___int_least8_t_defined +typedef __int_least8_t int_least8_t; +typedef __uint_least8_t uint_least8_t; +#define __int_least8_t_defined 1 +#endif + +#ifdef ___int16_t_defined +typedef __int16_t int16_t ; +typedef __uint16_t uint16_t ; +#define __int16_t_defined 1 +#endif + +#ifdef ___int_least16_t_defined +typedef __int_least16_t int_least16_t; +typedef __uint_least16_t uint_least16_t; +#define __int_least16_t_defined 1 +#endif + +#ifdef ___int32_t_defined +typedef __int32_t int32_t ; +typedef __uint32_t uint32_t ; +#define __int32_t_defined 1 +#endif + +#ifdef ___int_least32_t_defined +typedef __int_least32_t int_least32_t; +typedef __uint_least32_t uint_least32_t; +#define __int_least32_t_defined 1 +#endif + +#ifdef ___int64_t_defined +typedef __int64_t int64_t ; +typedef __uint64_t uint64_t ; +#define __int64_t_defined 1 +#endif + +#ifdef ___int_least64_t_defined +typedef __int_least64_t int_least64_t; +typedef __uint_least64_t uint_least64_t; +#define __int_least64_t_defined 1 +#endif + +/* + * Fastest minimum-width integer types + * + * Assume int to be the fastest type for all types with a width + * less than __INT_MAX__ rsp. INT_MAX + */ +#ifdef __INT_FAST8_TYPE__ + typedef __INT_FAST8_TYPE__ int_fast8_t; + typedef __UINT_FAST8_TYPE__ uint_fast8_t; +#define __int_fast8_t_defined 1 +#elif __STDINT_EXP(INT_MAX) >= 0x7f + typedef signed int int_fast8_t; + typedef unsigned int uint_fast8_t; +#define __int_fast8_t_defined 1 +#endif + +#ifdef __INT_FAST16_TYPE__ + typedef __INT_FAST16_TYPE__ int_fast16_t; + typedef __UINT_FAST16_TYPE__ uint_fast16_t; +#define __int_fast16_t_defined 1 +#elif __STDINT_EXP(INT_MAX) >= 0x7fff + typedef signed int int_fast16_t; + typedef unsigned int uint_fast16_t; +#define __int_fast16_t_defined 1 +#endif + +#ifdef __INT_FAST32_TYPE__ + typedef __INT_FAST32_TYPE__ int_fast32_t; + typedef __UINT_FAST32_TYPE__ uint_fast32_t; +#define __int_fast32_t_defined 1 +#elif __STDINT_EXP(INT_MAX) >= 0x7fffffff + typedef signed int int_fast32_t; + typedef unsigned int uint_fast32_t; +#define __int_fast32_t_defined 1 +#endif + +#ifdef __INT_FAST64_TYPE__ + typedef __INT_FAST64_TYPE__ int_fast64_t; + typedef __UINT_FAST64_TYPE__ uint_fast64_t; +#define __int_fast64_t_defined 1 +#elif __STDINT_EXP(INT_MAX) > 0x7fffffff + typedef signed int int_fast64_t; + typedef unsigned int uint_fast64_t; +#define __int_fast64_t_defined 1 +#endif + +/* + * Fall back to [u]int_least_t for [u]int_fast_t types + * not having been defined, yet. + * Leave undefined, if [u]int_least_t should not be available. + */ +#if !__int_fast8_t_defined +#if __int_least8_t_defined + typedef int_least8_t int_fast8_t; + typedef uint_least8_t uint_fast8_t; +#define __int_fast8_t_defined 1 +#endif +#endif + +#if !__int_fast16_t_defined +#if __int_least16_t_defined + typedef int_least16_t int_fast16_t; + typedef uint_least16_t uint_fast16_t; +#define __int_fast16_t_defined 1 +#endif +#endif + +#if !__int_fast32_t_defined +#if __int_least32_t_defined + typedef int_least32_t int_fast32_t; + typedef uint_least32_t uint_fast32_t; +#define __int_fast32_t_defined 1 +#endif +#endif + +#if !__int_fast64_t_defined +#if __int_least64_t_defined + typedef int_least64_t int_fast64_t; + typedef uint_least64_t uint_fast64_t; +#define __int_fast64_t_defined 1 +#endif +#endif + +/* Greatest-width integer types */ +/* Modern GCCs provide __INTMAX_TYPE__ */ +#if defined(__INTMAX_TYPE__) + typedef __INTMAX_TYPE__ intmax_t; +#elif __have_longlong64 + typedef signed long long intmax_t; +#else + typedef signed long intmax_t; +#endif + +/* Modern GCCs provide __UINTMAX_TYPE__ */ +#if defined(__UINTMAX_TYPE__) + typedef __UINTMAX_TYPE__ uintmax_t; +#elif __have_longlong64 + typedef unsigned long long uintmax_t; +#else + typedef unsigned long uintmax_t; +#endif + +typedef __intptr_t intptr_t; +typedef __uintptr_t uintptr_t; + +#ifdef __INTPTR_TYPE__ +#define INTPTR_MIN (-__INTPTR_MAX__ - 1) +#define INTPTR_MAX __INTPTR_MAX__ +#define UINTPTR_MAX __UINTPTR_MAX__ +#elif defined(__PTRDIFF_TYPE__) +#define INTPTR_MAX PTRDIFF_MAX +#define INTPTR_MIN PTRDIFF_MIN +#ifdef __UINTPTR_MAX__ +#define UINTPTR_MAX __UINTPTR_MAX__ +#else +#define UINTPTR_MAX (2UL * PTRDIFF_MAX + 1) +#endif +#else +/* + * Fallback to hardcoded values, + * should be valid on cpu's with 32bit int/32bit void* + */ +#define INTPTR_MAX __STDINT_EXP(LONG_MAX) +#define INTPTR_MIN (-__STDINT_EXP(LONG_MAX) - 1) +#define UINTPTR_MAX (__STDINT_EXP(LONG_MAX) * 2UL + 1) +#endif + +/* Limits of Specified-Width Integer Types */ + +#ifdef __INT8_MAX__ +#define INT8_MIN (-__INT8_MAX__ - 1) +#define INT8_MAX __INT8_MAX__ +#define UINT8_MAX __UINT8_MAX__ +#elif defined(__int8_t_defined) +#define INT8_MIN -128 +#define INT8_MAX 127 +#define UINT8_MAX 255 +#endif + +#ifdef __INT_LEAST8_MAX__ +#define INT_LEAST8_MIN (-__INT_LEAST8_MAX__ - 1) +#define INT_LEAST8_MAX __INT_LEAST8_MAX__ +#define UINT_LEAST8_MAX __UINT_LEAST8_MAX__ +#elif defined(__int_least8_t_defined) +#define INT_LEAST8_MIN -128 +#define INT_LEAST8_MAX 127 +#define UINT_LEAST8_MAX 255 +#else +#error required type int_least8_t missing +#endif + +#ifdef __INT16_MAX__ +#define INT16_MIN (-__INT16_MAX__ - 1) +#define INT16_MAX __INT16_MAX__ +#define UINT16_MAX __UINT16_MAX__ +#elif defined(__int16_t_defined) +#define INT16_MIN -32768 +#define INT16_MAX 32767 +#define UINT16_MAX 65535 +#endif + +#ifdef __INT_LEAST16_MAX__ +#define INT_LEAST16_MIN (-__INT_LEAST16_MAX__ - 1) +#define INT_LEAST16_MAX __INT_LEAST16_MAX__ +#define UINT_LEAST16_MAX __UINT_LEAST16_MAX__ +#elif defined(__int_least16_t_defined) +#define INT_LEAST16_MIN -32768 +#define INT_LEAST16_MAX 32767 +#define UINT_LEAST16_MAX 65535 +#else +#error required type int_least16_t missing +#endif + +#ifdef __INT32_MAX__ +#define INT32_MIN (-__INT32_MAX__ - 1) +#define INT32_MAX __INT32_MAX__ +#define UINT32_MAX __UINT32_MAX__ +#elif defined(__int32_t_defined) +#if __have_long32 +#define INT32_MIN (-2147483647L-1) +#define INT32_MAX 2147483647L +#define UINT32_MAX 4294967295UL +#else +#define INT32_MIN (-2147483647-1) +#define INT32_MAX 2147483647 +#define UINT32_MAX 4294967295U +#endif +#endif + +#ifdef __INT_LEAST32_MAX__ +#define INT_LEAST32_MIN (-__INT_LEAST32_MAX__ - 1) +#define INT_LEAST32_MAX __INT_LEAST32_MAX__ +#define UINT_LEAST32_MAX __UINT_LEAST32_MAX__ +#elif defined(__int_least32_t_defined) +#if __have_long32 +#define INT_LEAST32_MIN (-2147483647L-1) +#define INT_LEAST32_MAX 2147483647L +#define UINT_LEAST32_MAX 4294967295UL +#else +#define INT_LEAST32_MIN (-2147483647-1) +#define INT_LEAST32_MAX 2147483647 +#define UINT_LEAST32_MAX 4294967295U +#endif +#else +#error required type int_least32_t missing +#endif + +#ifdef __INT64_MAX__ +#define INT64_MIN (-__INT64_MAX__ - 1) +#define INT64_MAX __INT64_MAX__ +#define UINT64_MAX __UINT64_MAX__ +#elif defined(__int64_t_defined) +#if __have_long64 +#define INT64_MIN (-9223372036854775807L-1L) +#define INT64_MAX 9223372036854775807L +#define UINT64_MAX 18446744073709551615U +#elif __have_longlong64 +#define INT64_MIN (-9223372036854775807LL-1LL) +#define INT64_MAX 9223372036854775807LL +#define UINT64_MAX 18446744073709551615ULL +#endif +#endif + +#ifdef __INT_LEAST64_MAX__ +#define INT_LEAST64_MIN (-__INT_LEAST64_MAX__ - 1) +#define INT_LEAST64_MAX __INT_LEAST64_MAX__ +#define UINT_LEAST64_MAX __UINT_LEAST64_MAX__ +#elif defined(__int_least64_t_defined) +#if __have_long64 +#define INT_LEAST64_MIN (-9223372036854775807L-1L) +#define INT_LEAST64_MAX 9223372036854775807L +#define UINT_LEAST64_MAX 18446744073709551615U +#elif __have_longlong64 +#define INT_LEAST64_MIN (-9223372036854775807LL-1LL) +#define INT_LEAST64_MAX 9223372036854775807LL +#define UINT_LEAST64_MAX 18446744073709551615ULL +#endif +#endif + +#ifdef __INT_FAST8_MAX__ +#define INT_FAST8_MIN (-__INT_FAST8_MAX__ - 1) +#define INT_FAST8_MAX __INT_FAST8_MAX__ +#define UINT_FAST8_MAX __UINT_FAST8_MAX__ +#elif defined(__int_fast8_t_defined) +#if __STDINT_EXP(INT_MAX) >= 0x7f +#define INT_FAST8_MIN (-__STDINT_EXP(INT_MAX)-1) +#define INT_FAST8_MAX __STDINT_EXP(INT_MAX) +#define UINT_FAST8_MAX (__STDINT_EXP(INT_MAX)*2U+1U) +#else +#define INT_FAST8_MIN INT_LEAST8_MIN +#define INT_FAST8_MAX INT_LEAST8_MAX +#define UINT_FAST8_MAX UINT_LEAST8_MAX +#endif +#endif + +#ifdef __INT_FAST16_MAX__ +#define INT_FAST16_MIN (-__INT_FAST16_MAX__ - 1) +#define INT_FAST16_MAX __INT_FAST16_MAX__ +#define UINT_FAST16_MAX __UINT_FAST16_MAX__ +#elif defined(__int_fast16_t_defined) +#if __STDINT_EXP(INT_MAX) >= 0x7fff +#define INT_FAST16_MIN (-__STDINT_EXP(INT_MAX)-1) +#define INT_FAST16_MAX __STDINT_EXP(INT_MAX) +#define UINT_FAST16_MAX (__STDINT_EXP(INT_MAX)*2U+1U) +#else +#define INT_FAST16_MIN INT_LEAST16_MIN +#define INT_FAST16_MAX INT_LEAST16_MAX +#define UINT_FAST16_MAX UINT_LEAST16_MAX +#endif +#endif + +#ifdef __INT_FAST32_MAX__ +#define INT_FAST32_MIN (-__INT_FAST32_MAX__ - 1) +#define INT_FAST32_MAX __INT_FAST32_MAX__ +#define UINT_FAST32_MAX __UINT_FAST32_MAX__ +#elif defined(__int_fast32_t_defined) +#if __STDINT_EXP(INT_MAX) >= 0x7fffffff +#define INT_FAST32_MIN (-__STDINT_EXP(INT_MAX)-1) +#define INT_FAST32_MAX __STDINT_EXP(INT_MAX) +#define UINT_FAST32_MAX (__STDINT_EXP(INT_MAX)*2U+1U) +#else +#define INT_FAST32_MIN INT_LEAST32_MIN +#define INT_FAST32_MAX INT_LEAST32_MAX +#define UINT_FAST32_MAX UINT_LEAST32_MAX +#endif +#endif + +#ifdef __INT_FAST64_MAX__ +#define INT_FAST64_MIN (-__INT_FAST64_MAX__ - 1) +#define INT_FAST64_MAX __INT_FAST64_MAX__ +#define UINT_FAST64_MAX __UINT_FAST64_MAX__ +#elif defined(__int_fast64_t_defined) +#if __STDINT_EXP(INT_MAX) > 0x7fffffff +#define INT_FAST64_MIN (-__STDINT_EXP(INT_MAX)-1) +#define INT_FAST64_MAX __STDINT_EXP(INT_MAX) +#define UINT_FAST64_MAX (__STDINT_EXP(INT_MAX)*2U+1U) +#else +#define INT_FAST64_MIN INT_LEAST64_MIN +#define INT_FAST64_MAX INT_LEAST64_MAX +#define UINT_FAST64_MAX UINT_LEAST64_MAX +#endif +#endif + +#ifdef __INTMAX_MAX__ +#define INTMAX_MAX __INTMAX_MAX__ +#define INTMAX_MIN (-INTMAX_MAX - 1) +#elif defined(__INTMAX_TYPE__) +/* All relevant GCC versions prefer long to long long for intmax_t. */ +#define INTMAX_MAX INT64_MAX +#define INTMAX_MIN INT64_MIN +#endif + +#ifdef __UINTMAX_MAX__ +#define UINTMAX_MAX __UINTMAX_MAX__ +#elif defined(__UINTMAX_TYPE__) +/* All relevant GCC versions prefer long to long long for intmax_t. */ +#define UINTMAX_MAX UINT64_MAX +#endif + +/* This must match size_t in stddef.h, currently long unsigned int */ +#ifdef __SIZE_MAX__ +#define SIZE_MAX __SIZE_MAX__ +#else +#define SIZE_MAX (__STDINT_EXP(LONG_MAX) * 2UL + 1) +#endif + +/* This must match sig_atomic_t in (currently int) */ +#define SIG_ATOMIC_MIN (-__STDINT_EXP(INT_MAX) - 1) +#define SIG_ATOMIC_MAX __STDINT_EXP(INT_MAX) + +/* This must match ptrdiff_t in (currently long int) */ +#ifdef __PTRDIFF_MAX__ +#define PTRDIFF_MAX __PTRDIFF_MAX__ +#else +#define PTRDIFF_MAX __STDINT_EXP(LONG_MAX) +#endif +#define PTRDIFF_MIN (-PTRDIFF_MAX - 1) + +/* This must match definition in */ +#ifndef WCHAR_MIN +#ifdef __WCHAR_MIN__ +#define WCHAR_MIN __WCHAR_MIN__ +#elif defined(__WCHAR_UNSIGNED__) || (L'\0' - 1 > 0) +#define WCHAR_MIN (0 + L'\0') +#else +#define WCHAR_MIN (-0x7fffffff - 1 + L'\0') +#endif +#endif + +/* This must match definition in */ +#ifndef WCHAR_MAX +#ifdef __WCHAR_MAX__ +#define WCHAR_MAX __WCHAR_MAX__ +#elif defined(__WCHAR_UNSIGNED__) || (L'\0' - 1 > 0) +#define WCHAR_MAX (0xffffffffu + L'\0') +#else +#define WCHAR_MAX (0x7fffffff + L'\0') +#endif +#endif + +/* wint_t is unsigned int on almost all GCC targets. */ +#ifdef __WINT_MAX__ +#define WINT_MAX __WINT_MAX__ +#else +#define WINT_MAX (__STDINT_EXP(INT_MAX) * 2U + 1U) +#endif +#ifdef __WINT_MIN__ +#define WINT_MIN __WINT_MIN__ +#else +#define WINT_MIN 0U +#endif + +/** Macros for minimum-width integer constant expressions */ +#ifdef __INT8_C +#define INT8_C(x) __INT8_C(x) +#define UINT8_C(x) __UINT8_C(x) +#else +#define INT8_C(x) x +#if __STDINT_EXP(INT_MAX) > 0x7f +#define UINT8_C(x) x +#else +#define UINT8_C(x) x##U +#endif +#endif + +#ifdef __INT16_C +#define INT16_C(x) __INT16_C(x) +#define UINT16_C(x) __UINT16_C(x) +#else +#define INT16_C(x) x +#if __STDINT_EXP(INT_MAX) > 0x7fff +#define UINT16_C(x) x +#else +#define UINT16_C(x) x##U +#endif +#endif + +#ifdef __INT32_C +#define INT32_C(x) __INT32_C(x) +#define UINT32_C(x) __UINT32_C(x) +#else +#if __have_long32 +#define INT32_C(x) x##L +#define UINT32_C(x) x##UL +#else +#define INT32_C(x) x +#define UINT32_C(x) x##U +#endif +#endif + +#ifdef __INT64_C +#define INT64_C(x) __INT64_C(x) +#define UINT64_C(x) __UINT64_C(x) +#else +#if __int64_t_defined +#if __have_long64 +#define INT64_C(x) x##L +#define UINT64_C(x) x##UL +#else +#define INT64_C(x) x##LL +#define UINT64_C(x) x##ULL +#endif +#endif +#endif + +/** Macros for greatest-width integer constant expression */ +#ifdef __INTMAX_C +#define INTMAX_C(x) __INTMAX_C(x) +#define UINTMAX_C(x) __UINTMAX_C(x) +#else +#if __have_long64 +#define INTMAX_C(x) x##L +#define UINTMAX_C(x) x##UL +#else +#define INTMAX_C(x) x##LL +#define UINTMAX_C(x) x##ULL +#endif +#endif + + +#ifdef __cplusplus +} +#endif + +#endif /* _STDINT_H */ diff --git a/components/newlib/include/stdio.h b/components/newlib/include/stdio.h new file mode 100644 index 000000000..e336ee6eb --- /dev/null +++ b/components/newlib/include/stdio.h @@ -0,0 +1,727 @@ +/* + * Copyright (c) 1990 The Regents of the University of California. + * All rights reserved. + * + * Redistribution and use in source and binary forms are permitted + * provided that the above copyright notice and this paragraph are + * duplicated in all such forms and that any documentation, + * advertising materials, and other materials related to such + * distribution and use acknowledge that the software was developed + * by the University of California, Berkeley. The name of the + * University may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. + * + * @(#)stdio.h 5.3 (Berkeley) 3/15/86 + */ + +/* + * NB: to fit things in six character monocase externals, the + * stdio code uses the prefix `__s' for stdio objects, typically + * followed by a three-character attempt at a mnemonic. + */ + +#ifndef _STDIO_H_ +#define _STDIO_H_ + +#include "_ansi.h" + +#define _FSTDIO /* ``function stdio'' */ + +#define __need_size_t +#define __need_NULL +#include +#include + +#define __need___va_list +#include + +/* + * defines __FILE, _fpos_t. + * They must be defined there because struct _reent needs them (and we don't + * want reent.h to include this file. + */ + +#include +#include + +_BEGIN_STD_C + +typedef __FILE FILE; + +#ifdef __CYGWIN__ +typedef _fpos64_t fpos_t; +#else +typedef _fpos_t fpos_t; +#ifdef __LARGE64_FILES +typedef _fpos64_t fpos64_t; +#endif +#endif /* !__CYGWIN__ */ + +#include + +#define __SLBF 0x0001 /* line buffered */ +#define __SNBF 0x0002 /* unbuffered */ +#define __SRD 0x0004 /* OK to read */ +#define __SWR 0x0008 /* OK to write */ + /* RD and WR are never simultaneously asserted */ +#define __SRW 0x0010 /* open for reading & writing */ +#define __SEOF 0x0020 /* found EOF */ +#define __SERR 0x0040 /* found error */ +#define __SMBF 0x0080 /* _buf is from malloc */ +#define __SAPP 0x0100 /* fdopen()ed in append mode - so must write to end */ +#define __SSTR 0x0200 /* this is an sprintf/snprintf string */ +#define __SOPT 0x0400 /* do fseek() optimisation */ +#define __SNPT 0x0800 /* do not do fseek() optimisation */ +#define __SOFF 0x1000 /* set iff _offset is in fact correct */ +#define __SORD 0x2000 /* true => stream orientation (byte/wide) decided */ +#if defined(__CYGWIN__) +# define __SCLE 0x4000 /* convert line endings CR/LF <-> NL */ +#endif +#define __SL64 0x8000 /* is 64-bit offset large file */ + +/* _flags2 flags */ +#define __SNLK 0x0001 /* stdio functions do not lock streams themselves */ +#define __SWID 0x2000 /* true => stream orientation wide, false => byte, only valid if __SORD in _flags is true */ + +/* + * The following three definitions are for ANSI C, which took them + * from System V, which stupidly took internal interface macros and + * made them official arguments to setvbuf(), without renaming them. + * Hence, these ugly _IOxxx names are *supposed* to appear in user code. + * + * Although these happen to match their counterparts above, the + * implementation does not rely on that (so these could be renumbered). + */ +#define _IOFBF 0 /* setvbuf should set fully buffered */ +#define _IOLBF 1 /* setvbuf should set line buffered */ +#define _IONBF 2 /* setvbuf should set unbuffered */ + +#define EOF (-1) + +#ifdef __BUFSIZ__ +#define BUFSIZ __BUFSIZ__ +#else +#define BUFSIZ 1024 +#endif + +#ifdef __FOPEN_MAX__ +#define FOPEN_MAX __FOPEN_MAX__ +#else +#define FOPEN_MAX 20 +#endif + +#ifdef __FILENAME_MAX__ +#define FILENAME_MAX __FILENAME_MAX__ +#else +#define FILENAME_MAX 1024 +#endif + +#ifdef __L_tmpnam__ +#define L_tmpnam __L_tmpnam__ +#else +#define L_tmpnam FILENAME_MAX +#endif + +#ifndef __STRICT_ANSI__ +#define P_tmpdir "/tmp" +#endif + +#ifndef SEEK_SET +#define SEEK_SET 0 /* set file offset to offset */ +#endif +#ifndef SEEK_CUR +#define SEEK_CUR 1 /* set file offset to current plus offset */ +#endif +#ifndef SEEK_END +#define SEEK_END 2 /* set file offset to EOF plus offset */ +#endif + +#define TMP_MAX 26 + +#define stdin (_REENT->_stdin) +#define stdout (_REENT->_stdout) +#define stderr (_REENT->_stderr) + +#define _stdin_r(x) ((x)->_stdin) +#define _stdout_r(x) ((x)->_stdout) +#define _stderr_r(x) ((x)->_stderr) + +/* + * Functions defined in ANSI C standard. + */ + +#ifndef __VALIST +#ifdef __GNUC__ +#define __VALIST __gnuc_va_list +#else +#define __VALIST char* +#endif +#endif + +FILE * _EXFUN(tmpfile, (void)); +char * _EXFUN(tmpnam, (char *)); +#if __BSD_VISIBLE || __XSI_VISIBLE || __POSIX_VISIBLE >= 200112 +char * _EXFUN(tempnam, (const char *, const char *)); +#endif +int _EXFUN(fclose, (FILE *)); +int _EXFUN(fflush, (FILE *)); +FILE * _EXFUN(freopen, (const char *__restrict, const char *__restrict, FILE *__restrict)); +void _EXFUN(setbuf, (FILE *__restrict, char *__restrict)); +int _EXFUN(setvbuf, (FILE *__restrict, char *__restrict, int, size_t)); +int _EXFUN(fprintf, (FILE *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(fscanf, (FILE *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +int _EXFUN(printf, (const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 1, 2)))); +int _EXFUN(scanf, (const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 1, 2)))); +int _EXFUN(sscanf, (const char *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +int _EXFUN(vfprintf, (FILE *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(vprintf, (const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 1, 0)))); +int _EXFUN(vsprintf, (char *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(fgetc, (FILE *)); +char * _EXFUN(fgets, (char *__restrict, int, FILE *__restrict)); +int _EXFUN(fputc, (int, FILE *)); +int _EXFUN(fputs, (const char *__restrict, FILE *__restrict)); +int _EXFUN(getc, (FILE *)); +int _EXFUN(getchar, (void)); +char * _EXFUN(gets, (char *)); +int _EXFUN(putc, (int, FILE *)); +int _EXFUN(putchar, (int)); +int _EXFUN(puts, (const char *)); +int _EXFUN(ungetc, (int, FILE *)); +size_t _EXFUN(fread, (_PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +size_t _EXFUN(fwrite, (const _PTR __restrict , size_t _size, size_t _n, FILE *)); +#ifdef _COMPILING_NEWLIB +int _EXFUN(fgetpos, (FILE *, _fpos_t *)); +#else +int _EXFUN(fgetpos, (FILE *__restrict, fpos_t *__restrict)); +#endif +int _EXFUN(fseek, (FILE *, long, int)); +#ifdef _COMPILING_NEWLIB +int _EXFUN(fsetpos, (FILE *, const _fpos_t *)); +#else +int _EXFUN(fsetpos, (FILE *, const fpos_t *)); +#endif +long _EXFUN(ftell, ( FILE *)); +void _EXFUN(rewind, (FILE *)); +void _EXFUN(clearerr, (FILE *)); +int _EXFUN(feof, (FILE *)); +int _EXFUN(ferror, (FILE *)); +void _EXFUN(perror, (const char *)); +#ifndef _REENT_ONLY +FILE * _EXFUN(fopen, (const char *__restrict _name, const char *__restrict _type)); +int _EXFUN(sprintf, (char *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(remove, (const char *)); +int _EXFUN(rename, (const char *, const char *)); +#ifdef _COMPILING_NEWLIB +int _EXFUN(_rename, (const char *, const char *)); +#endif +#endif +#if !defined(__STRICT_ANSI__) || defined(__USE_XOPEN2K) +#ifdef _COMPILING_NEWLIB +int _EXFUN(fseeko, (FILE *, _off_t, int)); +_off_t _EXFUN(ftello, ( FILE *)); +#else +int _EXFUN(fseeko, (FILE *, off_t, int)); +off_t _EXFUN(ftello, ( FILE *)); +#endif +#endif +#if __GNU_VISIBLE +int _EXFUN(fcloseall, (_VOID)); +#endif +#if !defined(__STRICT_ANSI__) || (__STDC_VERSION__ >= 199901L) || (__cplusplus >= 201103L) +#ifndef _REENT_ONLY +int _EXFUN(asiprintf, (char **, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +char * _EXFUN(asniprintf, (char *, size_t *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +char * _EXFUN(asnprintf, (char *__restrict, size_t *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(asprintf, (char **__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +#ifndef diprintf +int _EXFUN(diprintf, (int, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +#endif +int _EXFUN(fiprintf, (FILE *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(fiscanf, (FILE *, const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +int _EXFUN(iprintf, (const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 1, 2)))); +int _EXFUN(iscanf, (const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 1, 2)))); +int _EXFUN(siprintf, (char *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(siscanf, (const char *, const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +int _EXFUN(snprintf, (char *__restrict, size_t, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(sniprintf, (char *, size_t, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(vasiprintf, (char **, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +char * _EXFUN(vasniprintf, (char *, size_t *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +char * _EXFUN(vasnprintf, (char *, size_t *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(vasprintf, (char **, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(vdiprintf, (int, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(vfiprintf, (FILE *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(vfiscanf, (FILE *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +int _EXFUN(vfscanf, (FILE *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +int _EXFUN(viprintf, (const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 1, 0)))); +int _EXFUN(viscanf, (const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 1, 0)))); +int _EXFUN(vscanf, (const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 1, 0)))); +int _EXFUN(vsiprintf, (char *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(vsiscanf, (const char *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +int _EXFUN(vsniprintf, (char *, size_t, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(vsnprintf, (char *__restrict, size_t, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(vsscanf, (const char *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +#endif /* !_REENT_ONLY */ +#endif /* !__STRICT_ANSI__ */ + +/* + * Routines in POSIX 1003.1:2001. + */ + +#ifndef __STRICT_ANSI__ +#ifndef _REENT_ONLY +FILE * _EXFUN(fdopen, (int, const char *)); +#endif +int _EXFUN(fileno, (FILE *)); +int _EXFUN(getw, (FILE *)); +int _EXFUN(pclose, (FILE *)); +FILE * _EXFUN(popen, (const char *, const char *)); +int _EXFUN(putw, (int, FILE *)); +void _EXFUN(setbuffer, (FILE *, char *, int)); +int _EXFUN(setlinebuf, (FILE *)); +int _EXFUN(getc_unlocked, (FILE *)); +int _EXFUN(getchar_unlocked, (void)); +void _EXFUN(flockfile, (FILE *)); +int _EXFUN(ftrylockfile, (FILE *)); +void _EXFUN(funlockfile, (FILE *)); +int _EXFUN(putc_unlocked, (int, FILE *)); +int _EXFUN(putchar_unlocked, (int)); +#endif /* ! __STRICT_ANSI__ */ + +/* + * Routines in POSIX 1003.1:200x. + */ + +#ifndef __STRICT_ANSI__ +# ifndef _REENT_ONLY +# ifndef dprintf +int _EXFUN(dprintf, (int, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +# endif +FILE * _EXFUN(fmemopen, (void *__restrict, size_t, const char *__restrict)); +/* getdelim - see __getdelim for now */ +/* getline - see __getline for now */ +FILE * _EXFUN(open_memstream, (char **, size_t *)); +#if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809 +int _EXFUN(renameat, (int, const char *, int, const char *)); +#endif +int _EXFUN(vdprintf, (int, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +# endif +#endif + +/* + * Recursive versions of the above. + */ + +int _EXFUN(_asiprintf_r, (struct _reent *, char **, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +char * _EXFUN(_asniprintf_r, (struct _reent *, char *, size_t *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 4, 5)))); +char * _EXFUN(_asnprintf_r, (struct _reent *, char *__restrict, size_t *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 4, 5)))); +int _EXFUN(_asprintf_r, (struct _reent *, char **__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_diprintf_r, (struct _reent *, int, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_dprintf_r, (struct _reent *, int, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_fclose_r, (struct _reent *, FILE *)); +int _EXFUN(_fcloseall_r, (struct _reent *)); +FILE * _EXFUN(_fdopen_r, (struct _reent *, int, const char *)); +int _EXFUN(_fflush_r, (struct _reent *, FILE *)); +int _EXFUN(_fgetc_r, (struct _reent *, FILE *)); +int _EXFUN(_fgetc_unlocked_r, (struct _reent *, FILE *)); +char * _EXFUN(_fgets_r, (struct _reent *, char *__restrict, int, FILE *__restrict)); +char * _EXFUN(_fgets_unlocked_r, (struct _reent *, char *__restrict, int, FILE *__restrict)); +#ifdef _COMPILING_NEWLIB +int _EXFUN(_fgetpos_r, (struct _reent *, FILE *__restrict, _fpos_t *__restrict)); +int _EXFUN(_fsetpos_r, (struct _reent *, FILE *, const _fpos_t *)); +#else +int _EXFUN(_fgetpos_r, (struct _reent *, FILE *, fpos_t *)); +int _EXFUN(_fsetpos_r, (struct _reent *, FILE *, const fpos_t *)); +#endif +int _EXFUN(_fiprintf_r, (struct _reent *, FILE *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_fiscanf_r, (struct _reent *, FILE *, const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 3, 4)))); +FILE * _EXFUN(_fmemopen_r, (struct _reent *, void *__restrict, size_t, const char *__restrict)); +FILE * _EXFUN(_fopen_r, (struct _reent *, const char *__restrict, const char *__restrict)); +FILE * _EXFUN(_freopen_r, (struct _reent *, const char *__restrict, const char *__restrict, FILE *__restrict)); +int _EXFUN(_fprintf_r, (struct _reent *, FILE *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_fpurge_r, (struct _reent *, FILE *)); +int _EXFUN(_fputc_r, (struct _reent *, int, FILE *)); +int _EXFUN(_fputc_unlocked_r, (struct _reent *, int, FILE *)); +int _EXFUN(_fputs_r, (struct _reent *, const char *__restrict, FILE *__restrict)); +int _EXFUN(_fputs_unlocked_r, (struct _reent *, const char *__restrict, FILE *__restrict)); +size_t _EXFUN(_fread_r, (struct _reent *, _PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +size_t _EXFUN(_fread_unlocked_r, (struct _reent *, _PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +int _EXFUN(_fscanf_r, (struct _reent *, FILE *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 3, 4)))); +int _EXFUN(_fseek_r, (struct _reent *, FILE *, long, int)); +int _EXFUN(_fseeko_r,(struct _reent *, FILE *, _off_t, int)); +long _EXFUN(_ftell_r, (struct _reent *, FILE *)); +_off_t _EXFUN(_ftello_r,(struct _reent *, FILE *)); +void _EXFUN(_rewind_r, (struct _reent *, FILE *)); +size_t _EXFUN(_fwrite_r, (struct _reent *, const _PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +size_t _EXFUN(_fwrite_unlocked_r, (struct _reent *, const _PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +int _EXFUN(_getc_r, (struct _reent *, FILE *)); +int _EXFUN(_getc_unlocked_r, (struct _reent *, FILE *)); +int _EXFUN(_getchar_r, (struct _reent *)); +int _EXFUN(_getchar_unlocked_r, (struct _reent *)); +char * _EXFUN(_gets_r, (struct _reent *, char *)); +int _EXFUN(_iprintf_r, (struct _reent *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(_iscanf_r, (struct _reent *, const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +FILE * _EXFUN(_open_memstream_r, (struct _reent *, char **, size_t *)); +void _EXFUN(_perror_r, (struct _reent *, const char *)); +int _EXFUN(_printf_r, (struct _reent *, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 2, 3)))); +int _EXFUN(_putc_r, (struct _reent *, int, FILE *)); +int _EXFUN(_putc_unlocked_r, (struct _reent *, int, FILE *)); +int _EXFUN(_putchar_unlocked_r, (struct _reent *, int)); +int _EXFUN(_putchar_r, (struct _reent *, int)); +int _EXFUN(_puts_r, (struct _reent *, const char *)); +int _EXFUN(_remove_r, (struct _reent *, const char *)); +int _EXFUN(_rename_r, (struct _reent *, + const char *_old, const char *_new)); +int _EXFUN(_scanf_r, (struct _reent *, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 2, 3)))); +int _EXFUN(_siprintf_r, (struct _reent *, char *, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_siscanf_r, (struct _reent *, const char *, const char *, ...) + _ATTRIBUTE ((__format__ (__scanf__, 3, 4)))); +int _EXFUN(_sniprintf_r, (struct _reent *, char *, size_t, const char *, ...) + _ATTRIBUTE ((__format__ (__printf__, 4, 5)))); +int _EXFUN(_snprintf_r, (struct _reent *, char *__restrict, size_t, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 4, 5)))); +int _EXFUN(_sprintf_r, (struct _reent *, char *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__printf__, 3, 4)))); +int _EXFUN(_sscanf_r, (struct _reent *, const char *__restrict, const char *__restrict, ...) + _ATTRIBUTE ((__format__ (__scanf__, 3, 4)))); +char * _EXFUN(_tempnam_r, (struct _reent *, const char *, const char *)); +FILE * _EXFUN(_tmpfile_r, (struct _reent *)); +char * _EXFUN(_tmpnam_r, (struct _reent *, char *)); +int _EXFUN(_ungetc_r, (struct _reent *, int, FILE *)); +int _EXFUN(_vasiprintf_r, (struct _reent *, char **, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +char * _EXFUN(_vasniprintf_r, (struct _reent*, char *, size_t *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 4, 0)))); +char * _EXFUN(_vasnprintf_r, (struct _reent*, char *, size_t *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 4, 0)))); +int _EXFUN(_vasprintf_r, (struct _reent *, char **, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vdiprintf_r, (struct _reent *, int, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vdprintf_r, (struct _reent *, int, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vfiprintf_r, (struct _reent *, FILE *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vfiscanf_r, (struct _reent *, FILE *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 3, 0)))); +int _EXFUN(_vfprintf_r, (struct _reent *, FILE *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vfscanf_r, (struct _reent *, FILE *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 3, 0)))); +int _EXFUN(_viprintf_r, (struct _reent *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(_viscanf_r, (struct _reent *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +int _EXFUN(_vprintf_r, (struct _reent *, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 2, 0)))); +int _EXFUN(_vscanf_r, (struct _reent *, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 2, 0)))); +int _EXFUN(_vsiprintf_r, (struct _reent *, char *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vsiscanf_r, (struct _reent *, const char *, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 3, 0)))); +int _EXFUN(_vsniprintf_r, (struct _reent *, char *, size_t, const char *, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 4, 0)))); +int _EXFUN(_vsnprintf_r, (struct _reent *, char *__restrict, size_t, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 4, 0)))); +int _EXFUN(_vsprintf_r, (struct _reent *, char *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__printf__, 3, 0)))); +int _EXFUN(_vsscanf_r, (struct _reent *, const char *__restrict, const char *__restrict, __VALIST) + _ATTRIBUTE ((__format__ (__scanf__, 3, 0)))); + +/* Other extensions. */ + +int _EXFUN(fpurge, (FILE *)); +ssize_t _EXFUN(__getdelim, (char **, size_t *, int, FILE *)); +ssize_t _EXFUN(__getline, (char **, size_t *, FILE *)); + +#if __BSD_VISIBLE +void _EXFUN(clearerr_unlocked, (FILE *)); +int _EXFUN(feof_unlocked, (FILE *)); +int _EXFUN(ferror_unlocked, (FILE *)); +int _EXFUN(fileno_unlocked, (FILE *)); +int _EXFUN(fflush_unlocked, (FILE *)); +int _EXFUN(fgetc_unlocked, (FILE *)); +int _EXFUN(fputc_unlocked, (int, FILE *)); +size_t _EXFUN(fread_unlocked, (_PTR __restrict, size_t _size, size_t _n, FILE *__restrict)); +size_t _EXFUN(fwrite_unlocked, (const _PTR __restrict , size_t _size, size_t _n, FILE *)); +#endif + +#if __GNU_VISIBLE +char * _EXFUN(fgets_unlocked, (char *__restrict, int, FILE *__restrict)); +int _EXFUN(fputs_unlocked, (const char *__restrict, FILE *__restrict)); +#endif + +#ifdef __LARGE64_FILES +#if !defined(__CYGWIN__) || defined(_COMPILING_NEWLIB) +FILE * _EXFUN(fdopen64, (int, const char *)); +FILE * _EXFUN(fopen64, (const char *, const char *)); +FILE * _EXFUN(freopen64, (_CONST char *, _CONST char *, FILE *)); +_off64_t _EXFUN(ftello64, (FILE *)); +_off64_t _EXFUN(fseeko64, (FILE *, _off64_t, int)); +int _EXFUN(fgetpos64, (FILE *, _fpos64_t *)); +int _EXFUN(fsetpos64, (FILE *, const _fpos64_t *)); +FILE * _EXFUN(tmpfile64, (void)); + +FILE * _EXFUN(_fdopen64_r, (struct _reent *, int, const char *)); +FILE * _EXFUN(_fopen64_r, (struct _reent *,const char *, const char *)); +FILE * _EXFUN(_freopen64_r, (struct _reent *, _CONST char *, _CONST char *, FILE *)); +_off64_t _EXFUN(_ftello64_r, (struct _reent *, FILE *)); +_off64_t _EXFUN(_fseeko64_r, (struct _reent *, FILE *, _off64_t, int)); +int _EXFUN(_fgetpos64_r, (struct _reent *, FILE *, _fpos64_t *)); +int _EXFUN(_fsetpos64_r, (struct _reent *, FILE *, const _fpos64_t *)); +FILE * _EXFUN(_tmpfile64_r, (struct _reent *)); +#endif /* !__CYGWIN__ */ +#endif /* __LARGE64_FILES */ + +/* + * Routines internal to the implementation. + */ + +int _EXFUN(__srget_r, (struct _reent *, FILE *)); +int _EXFUN(__swbuf_r, (struct _reent *, int, FILE *)); + +/* + * Stdio function-access interface. + */ + +#ifndef __STRICT_ANSI__ +# ifdef __LARGE64_FILES +FILE *_EXFUN(funopen,(const _PTR __cookie, + int (*__readfn)(_PTR __c, char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + int (*__writefn)(_PTR __c, const char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + _fpos64_t (*__seekfn)(_PTR __c, _fpos64_t __off, int __whence), + int (*__closefn)(_PTR __c))); +FILE *_EXFUN(_funopen_r,(struct _reent *, const _PTR __cookie, + int (*__readfn)(_PTR __c, char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + int (*__writefn)(_PTR __c, const char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + _fpos64_t (*__seekfn)(_PTR __c, _fpos64_t __off, int __whence), + int (*__closefn)(_PTR __c))); +# else +FILE *_EXFUN(funopen,(const _PTR __cookie, + int (*__readfn)(_PTR __cookie, char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + int (*__writefn)(_PTR __cookie, const char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + fpos_t (*__seekfn)(_PTR __cookie, fpos_t __off, int __whence), + int (*__closefn)(_PTR __cookie))); +FILE *_EXFUN(_funopen_r,(struct _reent *, const _PTR __cookie, + int (*__readfn)(_PTR __cookie, char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + int (*__writefn)(_PTR __cookie, const char *__buf, + _READ_WRITE_BUFSIZE_TYPE __n), + fpos_t (*__seekfn)(_PTR __cookie, fpos_t __off, int __whence), + int (*__closefn)(_PTR __cookie))); +# endif /* !__LARGE64_FILES */ + +# define fropen(__cookie, __fn) funopen(__cookie, __fn, (int (*)())0, \ + (fpos_t (*)())0, (int (*)())0) +# define fwopen(__cookie, __fn) funopen(__cookie, (int (*)())0, __fn, \ + (fpos_t (*)())0, (int (*)())0) + +typedef ssize_t cookie_read_function_t(void *__cookie, char *__buf, size_t __n); +typedef ssize_t cookie_write_function_t(void *__cookie, const char *__buf, + size_t __n); +# ifdef __LARGE64_FILES +typedef int cookie_seek_function_t(void *__cookie, _off64_t *__off, + int __whence); +# else +typedef int cookie_seek_function_t(void *__cookie, off_t *__off, int __whence); +# endif /* !__LARGE64_FILES */ +typedef int cookie_close_function_t(void *__cookie); +typedef struct +{ + /* These four struct member names are dictated by Linux; hopefully, + they don't conflict with any macros. */ + cookie_read_function_t *read; + cookie_write_function_t *write; + cookie_seek_function_t *seek; + cookie_close_function_t *close; +} cookie_io_functions_t; +FILE *_EXFUN(fopencookie,(void *__cookie, + const char *__mode, cookie_io_functions_t __functions)); +FILE *_EXFUN(_fopencookie_r,(struct _reent *, void *__cookie, + const char *__mode, cookie_io_functions_t __functions)); +#endif /* ! __STRICT_ANSI__ */ + +#ifndef __CUSTOM_FILE_IO__ +/* + * The __sfoo macros are here so that we can + * define function versions in the C library. + */ +#define __sgetc_raw_r(__ptr, __f) (--(__f)->_r < 0 ? __srget_r(__ptr, __f) : (int)(*(__f)->_p++)) + +#ifdef __SCLE +/* For a platform with CR/LF, additional logic is required by + __sgetc_r which would otherwise simply be a macro; therefore we + use an inlined function. The function is only meant to be inlined + in place as used and the function body should never be emitted. + + There are two possible means to this end when compiling with GCC, + one when compiling with a standard C99 compiler, and for other + compilers we're just stuck. At the moment, this issue only + affects the Cygwin target, so we'll most likely be using GCC. */ + +_ELIDABLE_INLINE int __sgetc_r(struct _reent *__ptr, FILE *__p); + +_ELIDABLE_INLINE int __sgetc_r(struct _reent *__ptr, FILE *__p) + { + int __c = __sgetc_raw_r(__ptr, __p); + if ((__p->_flags & __SCLE) && (__c == '\r')) + { + int __c2 = __sgetc_raw_r(__ptr, __p); + if (__c2 == '\n') + __c = __c2; + else + ungetc(__c2, __p); + } + return __c; + } +#else +#define __sgetc_r(__ptr, __p) __sgetc_raw_r(__ptr, __p) +#endif + +#ifdef _never /* __GNUC__ */ +/* If this inline is actually used, then systems using coff debugging + info get hopelessly confused. 21sept93 rich@cygnus.com. */ +_ELIDABLE_INLINE int __sputc_r(struct _reent *_ptr, int _c, FILE *_p) { + if (--_p->_w >= 0 || (_p->_w >= _p->_lbfsize && (char)_c != '\n')) + return (*_p->_p++ = _c); + else + return (__swbuf_r(_ptr, _c, _p)); +} +#else +/* + * This has been tuned to generate reasonable code on the vax using pcc + */ +#define __sputc_raw_r(__ptr, __c, __p) \ + (--(__p)->_w < 0 ? \ + (__p)->_w >= (__p)->_lbfsize ? \ + (*(__p)->_p = (__c)), *(__p)->_p != '\n' ? \ + (int)*(__p)->_p++ : \ + __swbuf_r(__ptr, '\n', __p) : \ + __swbuf_r(__ptr, (int)(__c), __p) : \ + (*(__p)->_p = (__c), (int)*(__p)->_p++)) +#ifdef __SCLE +#define __sputc_r(__ptr, __c, __p) \ + ((((__p)->_flags & __SCLE) && ((__c) == '\n')) \ + ? __sputc_raw_r(__ptr, '\r', (__p)) : 0 , \ + __sputc_raw_r((__ptr), (__c), (__p))) +#else +#define __sputc_r(__ptr, __c, __p) __sputc_raw_r(__ptr, __c, __p) +#endif +#endif + +#define __sfeof(p) ((int)(((p)->_flags & __SEOF) != 0)) +#define __sferror(p) ((int)(((p)->_flags & __SERR) != 0)) +#define __sclearerr(p) ((void)((p)->_flags &= ~(__SERR|__SEOF))) +#define __sfileno(p) ((p)->_file) + +#ifndef _REENT_SMALL +#define feof(p) __sfeof(p) +#define ferror(p) __sferror(p) +#define clearerr(p) __sclearerr(p) + +#if __BSD_VISIBLE +#define feof_unlocked(p) __sfeof(p) +#define ferror_unlocked(p) __sferror(p) +#define clearerr_unlocked(p) __sclearerr(p) +#endif /* __BSD_VISIBLE */ +#endif /* _REENT_SMALL */ + +#if 0 /*ndef __STRICT_ANSI__ - FIXME: must initialize stdio first, use fn */ +#define fileno(p) __sfileno(p) +#endif + +#ifndef __CYGWIN__ +#ifndef lint +#define getc(fp) __sgetc_r(_REENT, fp) +#define putc(x, fp) __sputc_r(_REENT, x, fp) +#endif /* lint */ +#endif /* __CYGWIN__ */ + +#ifndef __STRICT_ANSI__ +/* fast always-buffered version, true iff error */ +#define fast_putc(x,p) (--(p)->_w < 0 ? \ + __swbuf_r(_REENT, (int)(x), p) == EOF : (*(p)->_p = (x), (p)->_p++, 0)) + +#define L_cuserid 9 /* posix says it goes in stdio.h :( */ +#ifdef __CYGWIN__ +#define L_ctermid 16 +#endif +#endif + +#endif /* !__CUSTOM_FILE_IO__ */ + +#define getchar() getc(stdin) +#define putchar(x) putc(x, stdout) + +#ifndef __STRICT_ANSI__ +#define getchar_unlocked() getc_unlocked(stdin) +#define putchar_unlocked(x) putc_unlocked(x, stdout) +#endif + +_END_STD_C + +#endif /* _STDIO_H_ */ diff --git a/components/newlib/include/stdio_ext.h b/components/newlib/include/stdio_ext.h new file mode 100644 index 000000000..029ab0253 --- /dev/null +++ b/components/newlib/include/stdio_ext.h @@ -0,0 +1,79 @@ +/* + * stdio_ext.h + * + * Definitions for I/O internal operations, originally from Solaris. + */ + +#ifndef _STDIO_EXT_H_ +#define _STDIO_EXT_H_ + +#ifdef __rtems__ +#error " not supported" +#endif + +#include + +#define FSETLOCKING_QUERY 0 +#define FSETLOCKING_INTERNAL 1 +#define FSETLOCKING_BYCALLER 2 + +_BEGIN_STD_C + +void _EXFUN(__fpurge,(FILE *)); +int _EXFUN(__fsetlocking,(FILE *, int)); + +/* TODO: + + void _flushlbf (void); +*/ + +#ifdef __GNUC__ + +_ELIDABLE_INLINE size_t +__fbufsize (FILE *__fp) { return (size_t) __fp->_bf._size; } + +_ELIDABLE_INLINE int +__freading (FILE *__fp) { return (__fp->_flags & __SRD) != 0; } + +_ELIDABLE_INLINE int +__fwriting (FILE *__fp) { return (__fp->_flags & __SWR) != 0; } + +_ELIDABLE_INLINE int +__freadable (FILE *__fp) { return (__fp->_flags & (__SRD | __SRW)) != 0; } + +_ELIDABLE_INLINE int +__fwritable (FILE *__fp) { return (__fp->_flags & (__SWR | __SRW)) != 0; } + +_ELIDABLE_INLINE int +__flbf (FILE *__fp) { return (__fp->_flags & __SLBF) != 0; } + +_ELIDABLE_INLINE size_t +__fpending (FILE *__fp) { return __fp->_p - __fp->_bf._base; } + +#else + +size_t _EXFUN(__fbufsize,(FILE *)); +int _EXFUN(__freading,(FILE *)); +int _EXFUN(__fwriting,(FILE *)); +int _EXFUN(__freadable,(FILE *)); +int _EXFUN(__fwritable,(FILE *)); +int _EXFUN(__flbf,(FILE *)); +size_t _EXFUN(__fpending,(FILE *)); + +#ifndef __cplusplus + +#define __fbufsize(__fp) ((size_t) (__fp)->_bf._size) +#define __freading(__fp) (((__fp)->_flags & __SRD) != 0) +#define __fwriting(__fp) (((__fp)->_flags & __SWR) != 0) +#define __freadable(__fp) (((__fp)->_flags & (__SRD | __SRW)) != 0) +#define __fwritable(__fp) (((__fp)->_flags & (__SWR | __SRW)) != 0) +#define __flbf(__fp) (((__fp)->_flags & __SLBF) != 0) +#define __fpending(__fp) ((size_t) ((__fp)->_p - (__fp)->_bf._base)) + +#endif /* __cplusplus */ + +#endif /* __GNUC__ */ + +_END_STD_C + +#endif /* _STDIO_EXT_H_ */ diff --git a/components/newlib/include/stdlib.h b/components/newlib/include/stdlib.h new file mode 100644 index 000000000..254ddd71f --- /dev/null +++ b/components/newlib/include/stdlib.h @@ -0,0 +1,297 @@ +/* + * stdlib.h + * + * Definitions for common types, variables, and functions. + */ + +#ifndef _STDLIB_H_ +#define _STDLIB_H_ + +#include +#include "_ansi.h" + +#define __need_size_t +#define __need_wchar_t +#define __need_NULL +#include + +#include +#include +#include +#ifndef __STRICT_ANSI__ +#include +#endif + +#ifdef __CYGWIN__ +#include +#endif + +_BEGIN_STD_C + +typedef struct +{ + int quot; /* quotient */ + int rem; /* remainder */ +} div_t; + +typedef struct +{ + long quot; /* quotient */ + long rem; /* remainder */ +} ldiv_t; + +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +typedef struct +{ + long long int quot; /* quotient */ + long long int rem; /* remainder */ +} lldiv_t; +#endif + +#ifndef __compar_fn_t_defined +#define __compar_fn_t_defined +typedef int (*__compar_fn_t) (const _PTR, const _PTR); +#endif + +#ifndef NULL +#define NULL 0 +#endif + +#define EXIT_FAILURE 1 +#define EXIT_SUCCESS 0 + +#define RAND_MAX __RAND_MAX + +int _EXFUN(__locale_mb_cur_max,(_VOID)); + +#define MB_CUR_MAX __locale_mb_cur_max() + +_VOID _EXFUN(abort,(_VOID) _ATTRIBUTE ((__noreturn__))); +int _EXFUN(abs,(int)); +int _EXFUN(atexit,(_VOID (*__func)(_VOID))); +double _EXFUN(atof,(const char *__nptr)); +#ifndef __STRICT_ANSI__ +float _EXFUN(atoff,(const char *__nptr)); +#endif +int _EXFUN(atoi,(const char *__nptr)); +int _EXFUN(_atoi_r,(struct _reent *, const char *__nptr)); +long _EXFUN(atol,(const char *__nptr)); +long _EXFUN(_atol_r,(struct _reent *, const char *__nptr)); +_PTR _EXFUN(bsearch,(const _PTR __key, + const _PTR __base, + size_t __nmemb, + size_t __size, + __compar_fn_t _compar)); +_PTR _EXFUN_NOTHROW(calloc,(size_t __nmemb, size_t __size)); +div_t _EXFUN(div,(int __numer, int __denom)); +_VOID _EXFUN(exit,(int __status) _ATTRIBUTE ((__noreturn__))); +_VOID _EXFUN_NOTHROW(free,(_PTR)); +char * _EXFUN(getenv,(const char *__string)); +char * _EXFUN(_getenv_r,(struct _reent *, const char *__string)); +char * _EXFUN(_findenv,(_CONST char *, int *)); +char * _EXFUN(_findenv_r,(struct _reent *, _CONST char *, int *)); +#ifndef __STRICT_ANSI__ +extern char *suboptarg; /* getsubopt(3) external variable */ +int _EXFUN(getsubopt,(char **, char * const *, char **)); +#endif +long _EXFUN(labs,(long)); +ldiv_t _EXFUN(ldiv,(long __numer, long __denom)); +_PTR _EXFUN_NOTHROW(malloc,(size_t __size)); +int _EXFUN(mblen,(const char *, size_t)); +int _EXFUN(_mblen_r,(struct _reent *, const char *, size_t, _mbstate_t *)); +int _EXFUN(mbtowc,(wchar_t *__restrict, const char *__restrict, size_t)); +int _EXFUN(_mbtowc_r,(struct _reent *, wchar_t *__restrict, const char *__restrict, size_t, _mbstate_t *)); +int _EXFUN(wctomb,(char *, wchar_t)); +int _EXFUN(_wctomb_r,(struct _reent *, char *, wchar_t, _mbstate_t *)); +size_t _EXFUN(mbstowcs,(wchar_t *__restrict, const char *__restrict, size_t)); +size_t _EXFUN(_mbstowcs_r,(struct _reent *, wchar_t *__restrict, const char *__restrict, size_t, _mbstate_t *)); +size_t _EXFUN(wcstombs,(char *__restrict, const wchar_t *__restrict, size_t)); +size_t _EXFUN(_wcstombs_r,(struct _reent *, char *__restrict, const wchar_t *__restrict, size_t, _mbstate_t *)); +#ifndef __STRICT_ANSI__ +#ifndef _REENT_ONLY +char * _EXFUN(mkdtemp,(char *)); +int _EXFUN(mkostemp,(char *, int)); +int _EXFUN(mkostemps,(char *, int, int)); +int _EXFUN(mkstemp,(char *)); +int _EXFUN(mkstemps,(char *, int)); +#if (__GNUC__ < 4) || defined(__XTENSA__) +char * _EXFUN(mktemp,(char *)); +#else +char * _EXFUN(mktemp,(char *) _ATTRIBUTE ((__warning__ ("the use of `mktemp' is dangerous; use `mkstemp' instead")))); +#endif +#endif +char * _EXFUN(_mkdtemp_r, (struct _reent *, char *)); +int _EXFUN(_mkostemp_r, (struct _reent *, char *, int)); +int _EXFUN(_mkostemps_r, (struct _reent *, char *, int, int)); +int _EXFUN(_mkstemp_r, (struct _reent *, char *)); +int _EXFUN(_mkstemps_r, (struct _reent *, char *, int)); +#if (__GNUC__ < 4) || defined(__XTENSA__) +char * _EXFUN(_mktemp_r, (struct _reent *, char *)); +#else +char * _EXFUN(_mktemp_r, (struct _reent *, char *) _ATTRIBUTE ((__warning__ ("the use of `mktemp' is dangerous; use `mkstemp' instead")))); +#endif +#endif +_VOID _EXFUN(qsort,(_PTR __base, size_t __nmemb, size_t __size, __compar_fn_t _compar)); +int _EXFUN(rand,(_VOID)); +_PTR _EXFUN_NOTHROW(realloc,(_PTR __r, size_t __size)); +#ifndef __STRICT_ANSI__ +_PTR _EXFUN(reallocf,(_PTR __r, size_t __size)); +char * _EXFUN(realpath, (const char *__restrict path, char *__restrict resolved_path)); +#endif +_VOID _EXFUN(srand,(unsigned __seed)); +double _EXFUN(strtod,(const char *__restrict __n, char **__restrict __end_PTR)); +double _EXFUN(_strtod_r,(struct _reent *,const char *__restrict __n, char **__restrict __end_PTR)); +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +float _EXFUN(strtof,(const char *__restrict __n, char **__restrict __end_PTR)); +#endif +#ifndef __STRICT_ANSI__ +/* the following strtodf interface is deprecated...use strtof instead */ +# ifndef strtodf +# define strtodf strtof +# endif +#endif +long _EXFUN(strtol,(const char *__restrict __n, char **__restrict __end_PTR, int __base)); +long _EXFUN(_strtol_r,(struct _reent *,const char *__restrict __n, char **__restrict __end_PTR, int __base)); +unsigned long _EXFUN(strtoul,(const char *__restrict __n, char **__restrict __end_PTR, int __base)); +unsigned long _EXFUN(_strtoul_r,(struct _reent *,const char *__restrict __n, char **__restrict __end_PTR, int __base)); + +int _EXFUN(system,(const char *__string)); + +#ifndef __STRICT_ANSI__ +long _EXFUN(a64l,(const char *__input)); +char * _EXFUN(l64a,(long __input)); +char * _EXFUN(_l64a_r,(struct _reent *,long __input)); +int _EXFUN(on_exit,(_VOID (*__func)(int, _PTR),_PTR __arg)); +#endif /* ! __STRICT_ANSI__ */ +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +_VOID _EXFUN(_Exit,(int __status) _ATTRIBUTE ((__noreturn__))); +#endif +#ifndef __STRICT_ANSI__ +int _EXFUN(putenv,(char *__string)); +int _EXFUN(_putenv_r,(struct _reent *, char *__string)); +_PTR _EXFUN(_reallocf_r,(struct _reent *, _PTR, size_t)); +int _EXFUN(setenv,(const char *__string, const char *__value, int __overwrite)); +int _EXFUN(_setenv_r,(struct _reent *, const char *__string, const char *__value, int __overwrite)); + +char * _EXFUN(gcvt,(double,int,char *)); +char * _EXFUN(gcvtf,(float,int,char *)); +char * _EXFUN(fcvt,(double,int,int *,int *)); +char * _EXFUN(fcvtf,(float,int,int *,int *)); +char * _EXFUN(ecvt,(double,int,int *,int *)); +char * _EXFUN(ecvtbuf,(double, int, int*, int*, char *)); +char * _EXFUN(fcvtbuf,(double, int, int*, int*, char *)); +char * _EXFUN(ecvtf,(float,int,int *,int *)); +char * _EXFUN(dtoa,(double, int, int, int *, int*, char**)); +#endif +char * _EXFUN(__itoa,(int, char *, int)); +char * _EXFUN(__utoa,(unsigned, char *, int)); +#ifndef __STRICT_ANSI__ +char * _EXFUN(itoa,(int, char *, int)); +char * _EXFUN(utoa,(unsigned, char *, int)); +int _EXFUN(rand_r,(unsigned *__seed)); + +double _EXFUN(drand48,(_VOID)); +double _EXFUN(_drand48_r,(struct _reent *)); +double _EXFUN(erand48,(unsigned short [3])); +double _EXFUN(_erand48_r,(struct _reent *, unsigned short [3])); +long _EXFUN(jrand48,(unsigned short [3])); +long _EXFUN(_jrand48_r,(struct _reent *, unsigned short [3])); +_VOID _EXFUN(lcong48,(unsigned short [7])); +_VOID _EXFUN(_lcong48_r,(struct _reent *, unsigned short [7])); +long _EXFUN(lrand48,(_VOID)); +long _EXFUN(_lrand48_r,(struct _reent *)); +long _EXFUN(mrand48,(_VOID)); +long _EXFUN(_mrand48_r,(struct _reent *)); +long _EXFUN(nrand48,(unsigned short [3])); +long _EXFUN(_nrand48_r,(struct _reent *, unsigned short [3])); +unsigned short * + _EXFUN(seed48,(unsigned short [3])); +unsigned short * + _EXFUN(_seed48_r,(struct _reent *, unsigned short [3])); +_VOID _EXFUN(srand48,(long)); +_VOID _EXFUN(_srand48_r,(struct _reent *, long)); +#endif /* ! __STRICT_ANSI__ */ +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +long long _EXFUN(atoll,(const char *__nptr)); +#endif +#ifndef __STRICT_ANSI__ +long long _EXFUN(_atoll_r,(struct _reent *, const char *__nptr)); +#endif /* ! __STRICT_ANSI__ */ +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +long long _EXFUN(llabs,(long long)); +lldiv_t _EXFUN(lldiv,(long long __numer, long long __denom)); +long long _EXFUN(strtoll,(const char *__restrict __n, char **__restrict __end_PTR, int __base)); +#endif +#ifndef __STRICT_ANSI__ +long long _EXFUN(_strtoll_r,(struct _reent *, const char *__restrict __n, char **__restrict __end_PTR, int __base)); +#endif /* ! __STRICT_ANSI__ */ +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +unsigned long long _EXFUN(strtoull,(const char *__restrict __n, char **__restrict __end_PTR, int __base)); +#endif +#ifndef __STRICT_ANSI__ +unsigned long long _EXFUN(_strtoull_r,(struct _reent *, const char *__restrict __n, char **__restrict __end_PTR, int __base)); + +#ifndef __CYGWIN__ +_VOID _EXFUN(cfree,(_PTR)); +int _EXFUN(unsetenv,(const char *__string)); +int _EXFUN(_unsetenv_r,(struct _reent *, const char *__string)); +#endif + +#ifdef __rtems__ +int _EXFUN(posix_memalign,(void **, size_t, size_t)); +#endif + +#endif /* ! __STRICT_ANSI__ */ + +char * _EXFUN(_dtoa_r,(struct _reent *, double, int, int, int *, int*, char**)); +#ifndef __CYGWIN__ +_PTR _EXFUN_NOTHROW(_malloc_r,(struct _reent *, size_t)); +_PTR _EXFUN_NOTHROW(_calloc_r,(struct _reent *, size_t, size_t)); +_VOID _EXFUN_NOTHROW(_free_r,(struct _reent *, _PTR)); +_PTR _EXFUN_NOTHROW(_realloc_r,(struct _reent *, _PTR, size_t)); +_VOID _EXFUN(_mstats_r,(struct _reent *, char *)); +#endif +int _EXFUN(_system_r,(struct _reent *, const char *)); + +_VOID _EXFUN(__eprintf,(const char *, const char *, unsigned int, const char *)); + +/* There are two common qsort_r variants. If you request + _BSD_SOURCE, you get the BSD version; otherwise you get the GNU + version. We want that #undef qsort_r will still let you + invoke the underlying function, but that requires gcc support. */ +#ifdef _BSD_SOURCE +# ifdef __GNUC__ +_VOID _EXFUN(qsort_r,(_PTR __base, size_t __nmemb, size_t __size, _PTR __thunk, int (*_compar)(_PTR, const _PTR, const _PTR))) + __asm__ (__ASMNAME ("__bsd_qsort_r")); +# else +_VOID _EXFUN(__bsd_qsort_r,(_PTR __base, size_t __nmemb, size_t __size, _PTR __thunk, int (*_compar)(_PTR, const _PTR, const _PTR))); +# define qsort_r __bsd_qsort_r +# endif +#elif __GNU_VISIBLE +_VOID _EXFUN(qsort_r,(_PTR __base, size_t __nmemb, size_t __size, int (*_compar)(const _PTR, const _PTR, _PTR), _PTR __thunk)); +#endif + +/* On platforms where long double equals double. */ +#ifdef _HAVE_LONG_DOUBLE +#if !defined(__STRICT_ANSI__) || \ + (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + (defined(__cplusplus) && __cplusplus >= 201103L) +extern long double strtold (const char *__restrict, char **__restrict); +#endif +#endif /* _HAVE_LONG_DOUBLE */ + +_END_STD_C + +#endif /* _STDLIB_H_ */ diff --git a/components/newlib/include/string.h b/components/newlib/include/string.h new file mode 100644 index 000000000..af5c9da4d --- /dev/null +++ b/components/newlib/include/string.h @@ -0,0 +1,167 @@ +/* + * string.h + * + * Definitions for memory and string functions. + */ + +#ifndef _STRING_H_ +#define _STRING_H_ + +#include "_ansi.h" +#include +#include +#include + +#define __need_size_t +#define __need_NULL +#include + +_BEGIN_STD_C + +_PTR _EXFUN(memchr,(const _PTR, int, size_t)); +int _EXFUN(memcmp,(const _PTR, const _PTR, size_t)); +_PTR _EXFUN(memcpy,(_PTR __restrict, const _PTR __restrict, size_t)); +_PTR _EXFUN(memmove,(_PTR, const _PTR, size_t)); +_PTR _EXFUN(memset,(_PTR, int, size_t)); +char *_EXFUN(strcat,(char *__restrict, const char *__restrict)); +char *_EXFUN(strchr,(const char *, int)); +int _EXFUN(strcmp,(const char *, const char *)); +int _EXFUN(strcoll,(const char *, const char *)); +char *_EXFUN(strcpy,(char *__restrict, const char *__restrict)); +size_t _EXFUN(strcspn,(const char *, const char *)); +char *_EXFUN(strerror,(int)); +size_t _EXFUN(strlen,(const char *)); +char *_EXFUN(strncat,(char *__restrict, const char *__restrict, size_t)); +int _EXFUN(strncmp,(const char *, const char *, size_t)); +char *_EXFUN(strncpy,(char *__restrict, const char *__restrict, size_t)); +char *_EXFUN(strpbrk,(const char *, const char *)); +char *_EXFUN(strrchr,(const char *, int)); +size_t _EXFUN(strspn,(const char *, const char *)); +char *_EXFUN(strstr,(const char *, const char *)); +#ifndef _REENT_ONLY +char *_EXFUN(strtok,(char *__restrict, const char *__restrict)); +#endif +size_t _EXFUN(strxfrm,(char *__restrict, const char *__restrict, size_t)); + +#if __POSIX_VISIBLE +char *_EXFUN(strtok_r,(char *__restrict, const char *__restrict, char **__restrict)); +#endif +#if __BSD_VISIBLE +int _EXFUN(bcmp,(const void *, const void *, size_t)); +void _EXFUN(bcopy,(const void *, void *, size_t)); +void _EXFUN(bzero,(void *, size_t)); +int _EXFUN(ffs,(int)); +char *_EXFUN(index,(const char *, int)); +#endif +#if __BSD_VISIBLE || __XSI_VISIBLE +_PTR _EXFUN(memccpy,(_PTR __restrict, const _PTR __restrict, int, size_t)); +#endif +#if __GNU_VISIBLE +_PTR _EXFUN(mempcpy,(_PTR, const _PTR, size_t)); +_PTR _EXFUN(memmem, (const _PTR, size_t, const _PTR, size_t)); +#endif +_PTR _EXFUN(memrchr,(const _PTR, int, size_t)); +#if __GNU_VISIBLE +_PTR _EXFUN(rawmemchr,(const _PTR, int)); +#endif +#if __BSD_VISIBLE +char *_EXFUN(rindex,(const char *, int)); +#endif +char *_EXFUN(stpcpy,(char *__restrict, const char *__restrict)); +char *_EXFUN(stpncpy,(char *__restrict, const char *__restrict, size_t)); +#if __BSD_VISIBLE || __POSIX_VISIBLE +int _EXFUN(strcasecmp,(const char *, const char *)); +#endif +#if __GNU_VISIBLE +char *_EXFUN(strcasestr,(const char *, const char *)); +char *_EXFUN(strchrnul,(const char *, int)); +#endif +#if __XSI_VISIBLE >= 500 +char *_EXFUN(strdup,(const char *)); +#endif +#ifndef __STRICT_ANSI__ +char *_EXFUN(_strdup_r,(struct _reent *, const char *)); +#endif +#if __XSI_VISIBLE >= 700 +char *_EXFUN(strndup,(const char *, size_t)); +#endif + +#ifndef __STRICT_ANSI__ +char *_EXFUN(_strndup_r,(struct _reent *, const char *, size_t)); +#endif + +#if __GNU_VISIBLE +int _EXFUN(ffsl,(long)); +int _EXFUN(ffsll, (long long)); +#endif + +/* There are two common strerror_r variants. If you request + _GNU_SOURCE, you get the GNU version; otherwise you get the POSIX + version. POSIX requires that #undef strerror_r will still let you + invoke the underlying function, but that requires gcc support. */ +#if __GNU_VISIBLE +char *_EXFUN(strerror_r,(int, char *, size_t)); +#else +# ifdef __GNUC__ +int _EXFUN(strerror_r,(int, char *, size_t)) + __asm__ (__ASMNAME ("__xpg_strerror_r")); +# else +int _EXFUN(__xpg_strerror_r,(int, char *, size_t)); +# define strerror_r __xpg_strerror_r +# endif +#endif + +/* Reentrant version of strerror. */ +char * _EXFUN(_strerror_r, (struct _reent *, int, int, int *)); + +#if __BSD_VISIBLE +size_t _EXFUN(strlcat,(char *, const char *, size_t)); +size_t _EXFUN(strlcpy,(char *, const char *, size_t)); +#endif +#if __BSD_VISIBLE || __POSIX_VISIBLE +int _EXFUN(strncasecmp,(const char *, const char *, size_t)); +#endif +#if !defined(__STRICT_ANSI__) || __POSIX_VISIBLE >= 200809 || \ + __XSI_VISIBLE >= 700 +size_t _EXFUN(strnlen,(const char *, size_t)); +#endif +#if __BSD_VISIBLE +char *_EXFUN(strsep,(char **, const char *)); +#endif + +/* + * The origin of these is unknown to me so I am conditionalizing them + * on __STRICT_ANSI__. Finetuning this is definitely needed. --joel + */ +#if !defined(__STRICT_ANSI__) +char *_EXFUN(strlwr,(char *)); +char *_EXFUN(strupr,(char *)); +#endif + +#ifndef DEFS_H /* Kludge to work around problem compiling in gdb */ +char *_EXFUN(strsignal, (int __signo)); +#endif + +#ifdef __CYGWIN__ +int _EXFUN(strtosigno, (const char *__name)); +#endif + +#if defined _GNU_SOURCE && defined __GNUC__ +#define strdupa(__s) \ + (__extension__ ({const char *__in = (__s); \ + size_t __len = strlen (__in) + 1; \ + char * __out = (char *) __builtin_alloca (__len); \ + (char *) memcpy (__out, __in, __len);})) +#define strndupa(__s, __n) \ + (__extension__ ({const char *__in = (__s); \ + size_t __len = strnlen (__in, (__n)) + 1; \ + char *__out = (char *) __builtin_alloca (__len); \ + __out[__len-1] = '\0'; \ + (char *) memcpy (__out, __in, __len-1);})) +#endif /* _GNU_SOURCE && __GNUC__ */ + +#include + +_END_STD_C + +#endif /* _STRING_H_ */ diff --git a/components/newlib/include/strings.h b/components/newlib/include/strings.h new file mode 100644 index 000000000..131d81d20 --- /dev/null +++ b/components/newlib/include/strings.h @@ -0,0 +1,35 @@ +/* + * strings.h + * + * Definitions for string operations. + */ + +#ifndef _STRINGS_H_ +#define _STRINGS_H_ + +#include "_ansi.h" +#include + +#include /* for size_t */ + +_BEGIN_STD_C + +#if !defined __STRICT_ANSI__ && _POSIX_VERSION < 200809L +/* + * Marked LEGACY in Open Group Base Specifications Issue 6/IEEE Std 1003.1-2004 + * Removed from Open Group Base Specifications Issue 7/IEEE Std 1003.1-2008 + */ +int _EXFUN(bcmp,(const void *, const void *, size_t)); +void _EXFUN(bcopy,(const void *, void *, size_t)); +void _EXFUN(bzero,(void *, size_t)); +char *_EXFUN(index,(const char *, int)); +char *_EXFUN(rindex,(const char *, int)); +#endif /* ! __STRICT_ANSI__ */ + +int _EXFUN(ffs,(int)); +int _EXFUN(strcasecmp,(const char *, const char *)); +int _EXFUN(strncasecmp,(const char *, const char *, size_t)); + +_END_STD_C + +#endif /* _STRINGS_H_ */ diff --git a/components/newlib/include/sys/_default_fcntl.h b/components/newlib/include/sys/_default_fcntl.h new file mode 100644 index 000000000..eb674ae79 --- /dev/null +++ b/components/newlib/include/sys/_default_fcntl.h @@ -0,0 +1,213 @@ + +#ifndef _SYS__DEFAULT_FCNTL_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _SYS__DEFAULT_FCNTL_H_ +#include <_ansi.h> +#include +#define _FOPEN (-1) /* from sys/file.h, kernel use only */ +#define _FREAD 0x0001 /* read enabled */ +#define _FWRITE 0x0002 /* write enabled */ +#define _FAPPEND 0x0008 /* append (writes guaranteed at the end) */ +#define _FMARK 0x0010 /* internal; mark during gc() */ +#define _FDEFER 0x0020 /* internal; defer for next gc pass */ +#define _FASYNC 0x0040 /* signal pgrp when data ready */ +#define _FSHLOCK 0x0080 /* BSD flock() shared lock present */ +#define _FEXLOCK 0x0100 /* BSD flock() exclusive lock present */ +#define _FCREAT 0x0200 /* open with file create */ +#define _FTRUNC 0x0400 /* open with truncation */ +#define _FEXCL 0x0800 /* error on open if file exists */ +#define _FNBIO 0x1000 /* non blocking I/O (sys5 style) */ +#define _FSYNC 0x2000 /* do all writes synchronously */ +#define _FNONBLOCK 0x4000 /* non blocking I/O (POSIX style) */ +#define _FNDELAY _FNONBLOCK /* non blocking I/O (4.2 style) */ +#define _FNOCTTY 0x8000 /* don't assign a ctty on this open */ + +#define O_ACCMODE (O_RDONLY|O_WRONLY|O_RDWR) + +/* + * Flag values for open(2) and fcntl(2) + * The kernel adds 1 to the open modes to turn it into some + * combination of FREAD and FWRITE. + */ +#define O_RDONLY 0 /* +1 == FREAD */ +#define O_WRONLY 1 /* +1 == FWRITE */ +#define O_RDWR 2 /* +1 == FREAD|FWRITE */ +#define O_APPEND _FAPPEND +#define O_CREAT _FCREAT +#define O_TRUNC _FTRUNC +#define O_EXCL _FEXCL +#define O_SYNC _FSYNC +/* O_NDELAY _FNDELAY set in include/fcntl.h */ +/* O_NDELAY _FNBIO set in include/fcntl.h */ +#define O_NONBLOCK _FNONBLOCK +#define O_NOCTTY _FNOCTTY +/* For machines which care - */ +#if defined (__CYGWIN__) +#define _FBINARY 0x10000 +#define _FTEXT 0x20000 +#define _FNOINHERIT 0x40000 +#define _FDIRECT 0x80000 +#define _FNOFOLLOW 0x100000 +#define _FDIRECTORY 0x200000 +#define _FEXECSRCH 0x400000 + +#define O_BINARY _FBINARY +#define O_TEXT _FTEXT +#define O_CLOEXEC _FNOINHERIT +#define O_DIRECT _FDIRECT +#define O_NOFOLLOW _FNOFOLLOW +#define O_DSYNC _FSYNC +#define O_RSYNC _FSYNC +#define O_DIRECTORY _FDIRECTORY +#define O_EXEC _FEXECSRCH +#define O_SEARCH _FEXECSRCH +#endif + +#ifndef _POSIX_SOURCE + +/* + * Flags that work for fcntl(fd, F_SETFL, FXXXX) + */ +#define FAPPEND _FAPPEND +#define FSYNC _FSYNC +#define FASYNC _FASYNC +#define FNBIO _FNBIO +#define FNONBIO _FNONBLOCK /* XXX fix to be NONBLOCK everywhere */ +#define FNDELAY _FNDELAY + +/* + * Flags that are disallowed for fcntl's (FCNTLCANT); + * used for opens, internal state, or locking. + */ +#define FREAD _FREAD +#define FWRITE _FWRITE +#define FMARK _FMARK +#define FDEFER _FDEFER +#define FSHLOCK _FSHLOCK +#define FEXLOCK _FEXLOCK + +/* + * The rest of the flags, used only for opens + */ +#define FOPEN _FOPEN +#define FCREAT _FCREAT +#define FTRUNC _FTRUNC +#define FEXCL _FEXCL +#define FNOCTTY _FNOCTTY + +#endif /* !_POSIX_SOURCE */ + +/* XXX close on exec request; must match UF_EXCLOSE in user.h */ +#define FD_CLOEXEC 1 /* posix */ + +/* fcntl(2) requests */ +#define F_DUPFD 0 /* Duplicate fildes */ +#define F_GETFD 1 /* Get fildes flags (close on exec) */ +#define F_SETFD 2 /* Set fildes flags (close on exec) */ +#define F_GETFL 3 /* Get file flags */ +#define F_SETFL 4 /* Set file flags */ +#ifndef _POSIX_SOURCE +#define F_GETOWN 5 /* Get owner - for ASYNC */ +#define F_SETOWN 6 /* Set owner - for ASYNC */ +#endif /* !_POSIX_SOURCE */ +#define F_GETLK 7 /* Get record-locking information */ +#define F_SETLK 8 /* Set or Clear a record-lock (Non-Blocking) */ +#define F_SETLKW 9 /* Set or Clear a record-lock (Blocking) */ +#ifndef _POSIX_SOURCE +#define F_RGETLK 10 /* Test a remote lock to see if it is blocked */ +#define F_RSETLK 11 /* Set or unlock a remote lock */ +#define F_CNVT 12 /* Convert a fhandle to an open fd */ +#define F_RSETLKW 13 /* Set or Clear remote record-lock(Blocking) */ +#endif /* !_POSIX_SOURCE */ +#ifdef __CYGWIN__ +#define F_DUPFD_CLOEXEC 14 /* As F_DUPFD, but set close-on-exec flag */ +#endif + +/* fcntl(2) flags (l_type field of flock structure) */ +#define F_RDLCK 1 /* read lock */ +#define F_WRLCK 2 /* write lock */ +#define F_UNLCK 3 /* remove lock(s) */ +#ifndef _POSIX_SOURCE +#define F_UNLKSYS 4 /* remove remote locks for a given system */ +#endif /* !_POSIX_SOURCE */ + +#if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809 || defined(__CYGWIN__) +/* Special descriptor value to denote the cwd in calls to openat(2) etc. */ +#define AT_FDCWD -2 + +/* Flag values for faccessat2) et al. */ +#define AT_EACCESS 1 +#define AT_SYMLINK_NOFOLLOW 2 +#define AT_SYMLINK_FOLLOW 4 +#define AT_REMOVEDIR 8 +#endif + +#if __BSD_VISIBLE +/* lock operations for flock(2) */ +#define LOCK_SH 0x01 /* shared file lock */ +#define LOCK_EX 0x02 /* exclusive file lock */ +#define LOCK_NB 0x04 /* don't block when locking */ +#define LOCK_UN 0x08 /* unlock file */ +#endif + +/*#include */ + +#ifndef __CYGWIN__ +/* file segment locking set data type - information passed to system by user */ +struct flock { + short l_type; /* F_RDLCK, F_WRLCK, or F_UNLCK */ + short l_whence; /* flag to choose starting offset */ + long l_start; /* relative offset, in bytes */ + long l_len; /* length, in bytes; 0 means lock to EOF */ + short l_pid; /* returned with F_GETLK */ + short l_xxx; /* reserved for future use */ +}; +#endif /* __CYGWIN__ */ + +#ifndef _POSIX_SOURCE +/* extended file segment locking set data type */ +struct eflock { + short l_type; /* F_RDLCK, F_WRLCK, or F_UNLCK */ + short l_whence; /* flag to choose starting offset */ + long l_start; /* relative offset, in bytes */ + long l_len; /* length, in bytes; 0 means lock to EOF */ + short l_pid; /* returned with F_GETLK */ + short l_xxx; /* reserved for future use */ + long l_rpid; /* Remote process id wanting this lock */ + long l_rsys; /* Remote system id wanting this lock */ +}; +#endif /* !_POSIX_SOURCE */ + +#include +#include /* sigh. for the mode bits for open/creat */ + +extern int open _PARAMS ((const char *, int, ...)); +#if __BSD_VISIBLE || __POSIX_VISIBLE >= 200809 || defined(__CYGWIN__) +extern int openat _PARAMS ((int, const char *, int, ...)); +#endif +extern int creat _PARAMS ((const char *, mode_t)); +extern int fcntl _PARAMS ((int, int, ...)); +#if __BSD_VISIBLE +extern int flock _PARAMS ((int, int)); +#endif +#ifdef __CYGWIN__ +#include +extern int futimesat _PARAMS ((int, const char *, const struct timeval *)); +#endif + +/* Provide _ prototypes for functions provided by some versions + of newlib. */ +#ifdef _COMPILING_NEWLIB +extern int _open _PARAMS ((const char *, int, ...)); +extern int _fcntl _PARAMS ((int, int, ...)); +#ifdef __LARGE64_FILES +extern int _open64 _PARAMS ((const char *, int, ...)); +#endif +#endif + +#ifdef __cplusplus +} +#endif +#endif /* !_SYS__DEFAULT_FCNTL_H_ */ diff --git a/components/newlib/include/sys/_intsup.h b/components/newlib/include/sys/_intsup.h new file mode 100644 index 000000000..fa78426c5 --- /dev/null +++ b/components/newlib/include/sys/_intsup.h @@ -0,0 +1,20 @@ +/* + * Copyright (c) 2004, 2005 by + * Ralf Corsepius, Ulm/Germany. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + * + * Modified for xtensa arch & non-long int32_t, removes automatic setting of __have_long32. + */ + +#ifndef _SYS__INTSUP_H +#define _SYS__INTSUP_H + +#include + +#define __STDINT_EXP(x) __##x##__ + +#define __have_longlong64 1 + +#endif /* _SYS__INTSUP_H */ diff --git a/components/newlib/include/sys/_types.h b/components/newlib/include/sys/_types.h new file mode 100644 index 000000000..07bc27675 --- /dev/null +++ b/components/newlib/include/sys/_types.h @@ -0,0 +1,91 @@ +/* ANSI C namespace clean utility typedefs */ + +/* This file defines various typedefs needed by the system calls that support + the C library. Basically, they're just the POSIX versions with an '_' + prepended. This file lives in the `sys' directory so targets can provide + their own if desired (or they can put target dependant conditionals here). +*/ + +#ifndef _SYS__TYPES_H +#define _SYS__TYPES_H + +#include +#include + +#ifndef __off_t_defined +typedef long _off_t; +#endif + +#ifndef __dev_t_defined +typedef short __dev_t; +#endif + +#ifndef __uid_t_defined +typedef unsigned short __uid_t; +#endif +#ifndef __gid_t_defined +typedef unsigned short __gid_t; +#endif + +#ifndef __off64_t_defined +__extension__ typedef long long _off64_t; +#endif + +/* + * We need fpos_t for the following, but it doesn't have a leading "_", + * so we use _fpos_t instead. + */ +#ifndef __fpos_t_defined +typedef long _fpos_t; /* XXX must match off_t in */ + /* (and must be `long' for now) */ +#endif + +#ifdef __LARGE64_FILES +#ifndef __fpos64_t_defined +typedef _off64_t _fpos64_t; +#endif +#endif + +#ifndef __ssize_t_defined +#ifdef __SIZE_TYPE__ +/* If __SIZE_TYPE__ is defined (gcc) we define ssize_t based on size_t. + We simply change "unsigned" to "signed" for this single definition + to make sure ssize_t and size_t only differ by their signedness. */ +#define unsigned signed +typedef __SIZE_TYPE__ _ssize_t; +#undef unsigned +#else +#if defined(__INT_MAX__) && __INT_MAX__ == 2147483647 +typedef int _ssize_t; +#else +typedef long _ssize_t; +#endif +#endif +#endif + +#define __need_wint_t +#include + +#ifndef __mbstate_t_defined +/* Conversion state information. */ +typedef struct +{ + int __count; + union + { + wint_t __wch; + unsigned char __wchb[4]; + } __value; /* Value so far. */ +} _mbstate_t; +#endif + +#ifndef __flock_t_defined +typedef _LOCK_RECURSIVE_T _flock_t; +#endif + +#ifndef __iconv_t_defined +/* Iconv descriptor type */ +typedef void *_iconv_t; +#endif + +#endif /* _SYS__TYPES_H */ diff --git a/components/newlib/include/sys/cdefs.h b/components/newlib/include/sys/cdefs.h new file mode 100644 index 000000000..a5e613c63 --- /dev/null +++ b/components/newlib/include/sys/cdefs.h @@ -0,0 +1,710 @@ +/* libc/sys/linux/sys/cdefs.h - Helper macros for K&R vs. ANSI C compat. */ + +/* Written 2000 by Werner Almesberger */ + +/*- + * Copyright (c) 1991, 1993 + * The Regents of the University of California. All rights reserved. + * + * This code is derived from software contributed to Berkeley by + * Berkeley Software Design, Inc. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)cdefs.h 8.8 (Berkeley) 1/9/95 + * $FreeBSD$ + */ + +#ifndef _SYS_CDEFS_H_ +#define _SYS_CDEFS_H_ + +#include +#include +#include + +#define __PMT(args) args +#define __DOTS , ... +#define __THROW + +#ifdef __GNUC__ +# define __ASMNAME(cname) __XSTRING (__USER_LABEL_PREFIX__) cname +#endif + +#define __ptr_t void * +#define __long_double_t long double + +#define __attribute_malloc__ +#define __attribute_pure__ +#define __attribute_format_strfmon__(a,b) +#define __flexarr [0] + +#ifndef __BOUNDED_POINTERS__ +# define __bounded /* nothing */ +# define __unbounded /* nothing */ +# define __ptrvalue /* nothing */ +#endif + +/* + * Testing against Clang-specific extensions. + */ + +#ifndef __has_extension +#define __has_extension __has_feature +#endif +#ifndef __has_feature +#define __has_feature(x) 0 +#endif +#ifndef __has_include +#define __has_include(x) 0 +#endif +#ifndef __has_builtin +#define __has_builtin(x) 0 +#endif + +#if defined(__cplusplus) +#define __BEGIN_DECLS extern "C" { +#define __END_DECLS } +#else +#define __BEGIN_DECLS +#define __END_DECLS +#endif + +/* + * This code has been put in place to help reduce the addition of + * compiler specific defines in FreeBSD code. It helps to aid in + * having a compiler-agnostic source tree. + */ + +#if defined(__GNUC__) || defined(__INTEL_COMPILER) + +#if __GNUC__ >= 3 || defined(__INTEL_COMPILER) +#define __GNUCLIKE_ASM 3 +#define __GNUCLIKE_MATH_BUILTIN_CONSTANTS +#else +#define __GNUCLIKE_ASM 2 +#endif +#define __GNUCLIKE___TYPEOF 1 +#define __GNUCLIKE___OFFSETOF 1 +#define __GNUCLIKE___SECTION 1 + +#ifndef __INTEL_COMPILER +# define __GNUCLIKE_CTOR_SECTION_HANDLING 1 +#endif + +#define __GNUCLIKE_BUILTIN_CONSTANT_P 1 +# if defined(__INTEL_COMPILER) && defined(__cplusplus) \ + && __INTEL_COMPILER < 800 +# undef __GNUCLIKE_BUILTIN_CONSTANT_P +# endif + +#if (__GNUC_MINOR__ > 95 || __GNUC__ >= 3) && !defined(__INTEL_COMPILER) +# define __GNUCLIKE_BUILTIN_VARARGS 1 +# define __GNUCLIKE_BUILTIN_STDARG 1 +# define __GNUCLIKE_BUILTIN_VAALIST 1 +#endif + +#if defined(__GNUC__) +# define __GNUC_VA_LIST_COMPATIBILITY 1 +#endif + +/* + * Compiler memory barriers, specific to gcc and clang. + */ +#if defined(__GNUC__) +#define __compiler_membar() __asm __volatile(" " : : : "memory") +#endif + +#ifndef __INTEL_COMPILER +# define __GNUCLIKE_BUILTIN_NEXT_ARG 1 +# define __GNUCLIKE_MATH_BUILTIN_RELOPS +#endif + +#define __GNUCLIKE_BUILTIN_MEMCPY 1 + +/* XXX: if __GNUC__ >= 2: not tested everywhere originally, where replaced */ +#define __CC_SUPPORTS_INLINE 1 +#define __CC_SUPPORTS___INLINE 1 +#define __CC_SUPPORTS___INLINE__ 1 + +#define __CC_SUPPORTS___FUNC__ 1 +#define __CC_SUPPORTS_WARNING 1 + +#define __CC_SUPPORTS_VARADIC_XXX 1 /* see varargs.h */ + +#define __CC_SUPPORTS_DYNAMIC_ARRAY_INIT 1 + +#endif /* __GNUC__ || __INTEL_COMPILER */ + +/* + * The __CONCAT macro is used to concatenate parts of symbol names, e.g. + * with "#define OLD(foo) __CONCAT(old,foo)", OLD(foo) produces oldfoo. + * The __CONCAT macro is a bit tricky to use if it must work in non-ANSI + * mode -- there must be no spaces between its arguments, and for nested + * __CONCAT's, all the __CONCAT's must be at the left. __CONCAT can also + * concatenate double-quoted strings produced by the __STRING macro, but + * this only works with ANSI C. + * + * __XSTRING is like __STRING, but it expands any macros in its argument + * first. It is only available with ANSI C. + */ +#if defined(__STDC__) || defined(__cplusplus) +#define __P(protos) protos /* full-blown ANSI C */ +#define __CONCAT1(x,y) x ## y +#define __CONCAT(x,y) __CONCAT1(x,y) +#define __STRING(x) #x /* stringify without expanding x */ +#define __XSTRING(x) __STRING(x) /* expand x, then stringify */ + +#define __const const /* define reserved names to standard */ +#define __signed signed +#define __volatile volatile +#if defined(__cplusplus) +#define __inline inline /* convert to C++ keyword */ +#else +#if !(defined(__CC_SUPPORTS___INLINE)) +#define __inline /* delete GCC keyword */ +#endif /* ! __CC_SUPPORTS___INLINE */ +#endif /* !__cplusplus */ + +#else /* !(__STDC__ || __cplusplus) */ +#define __P(protos) () /* traditional C preprocessor */ +#define __CONCAT(x,y) x/**/y +#define __STRING(x) "x" + +#if !defined(__CC_SUPPORTS___INLINE) +#define __const /* delete pseudo-ANSI C keywords */ +#define __inline +#define __signed +#define __volatile +/* + * In non-ANSI C environments, new programs will want ANSI-only C keywords + * deleted from the program and old programs will want them left alone. + * When using a compiler other than gcc, programs using the ANSI C keywords + * const, inline etc. as normal identifiers should define -DNO_ANSI_KEYWORDS. + * When using "gcc -traditional", we assume that this is the intent; if + * __GNUC__ is defined but __STDC__ is not, we leave the new keywords alone. + */ +#ifndef NO_ANSI_KEYWORDS +#define const /* delete ANSI C keywords */ +#define inline +#define signed +#define volatile +#endif /* !NO_ANSI_KEYWORDS */ +#endif /* !__CC_SUPPORTS___INLINE */ +#endif /* !(__STDC__ || __cplusplus) */ + +/* + * Compiler-dependent macros to help declare dead (non-returning) and + * pure (no side effects) functions, and unused variables. They are + * null except for versions of gcc that are known to support the features + * properly (old versions of gcc-2 supported the dead and pure features + * in a different (wrong) way). If we do not provide an implementation + * for a given compiler, let the compile fail if it is told to use + * a feature that we cannot live without. + */ +#ifdef lint +#define __dead2 +#define __pure2 +#define __unused +#define __packed +#define __aligned(x) +#define __section(x) +#else +#if !__GNUC_PREREQ__(2, 5) && !defined(__INTEL_COMPILER) +#define __dead2 +#define __pure2 +#define __unused +#endif +#if __GNUC__ == 2 && __GNUC_MINOR__ >= 5 && __GNUC_MINOR__ < 7 && !defined(__INTEL_COMPILER) +#define __dead2 __attribute__((__noreturn__)) +#define __pure2 __attribute__((__const__)) +#define __unused +/* XXX Find out what to do for __packed, __aligned and __section */ +#endif +#if __GNUC_PREREQ__(2, 7) +#define __dead2 __attribute__((__noreturn__)) +#define __pure2 __attribute__((__const__)) +#define __unused __attribute__((__unused__)) +#define __used __attribute__((__used__)) +#define __packed __attribute__((__packed__)) +#define __aligned(x) __attribute__((__aligned__(x))) +#define __section(x) __attribute__((__section__(x))) +#endif +#if defined(__INTEL_COMPILER) +#define __dead2 __attribute__((__noreturn__)) +#define __pure2 __attribute__((__const__)) +#define __unused __attribute__((__unused__)) +#define __used __attribute__((__used__)) +#define __packed __attribute__((__packed__)) +#define __aligned(x) __attribute__((__aligned__(x))) +#define __section(x) __attribute__((__section__(x))) +#endif +#endif + +#if !__GNUC_PREREQ__(2, 95) +#define __alignof(x) __offsetof(struct { char __a; x __b; }, __b) +#endif + +/* + * Keywords added in C11. + */ + +#if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 201112L + +#if !__has_extension(c_alignas) +#if (defined(__cplusplus) && __cplusplus >= 201103L) || \ + __has_extension(cxx_alignas) +#define _Alignas(x) alignas(x) +#else +/* XXX: Only emulates _Alignas(constant-expression); not _Alignas(type-name). */ +#define _Alignas(x) __aligned(x) +#endif +#endif + +#if defined(__cplusplus) && __cplusplus >= 201103L +#define _Alignof(x) alignof(x) +#else +#define _Alignof(x) __alignof(x) +#endif + +#if !__has_extension(c_atomic) && !__has_extension(cxx_atomic) +/* + * No native support for _Atomic(). Place object in structure to prevent + * most forms of direct non-atomic access. + */ +#define _Atomic(T) struct { T volatile __val; } +#endif + +#if defined(__cplusplus) && __cplusplus >= 201103L +#define _Noreturn [[noreturn]] +#else +#define _Noreturn __dead2 +#endif + +#if __GNUC_PREREQ__(4, 6) && !defined(__cplusplus) +/* Do nothing: _Static_assert() works as per C11 */ +#elif !__has_extension(c_static_assert) +#if (defined(__cplusplus) && __cplusplus >= 201103L) || \ + __has_extension(cxx_static_assert) +#define _Static_assert(x, y) static_assert(x, y) +#elif defined(__COUNTER__) +#define _Static_assert(x, y) __Static_assert(x, __COUNTER__) +#define __Static_assert(x, y) ___Static_assert(x, y) +#define ___Static_assert(x, y) typedef char __assert_ ## y[(x) ? 1 : -1] +#else +#define _Static_assert(x, y) struct __hack +#endif +#endif + +#if !__has_extension(c_thread_local) +/* XXX: Change this to test against C++11 when clang in base supports it. */ +#if /* (defined(__cplusplus) && __cplusplus >= 201103L) || */ \ + __has_extension(cxx_thread_local) +#define _Thread_local thread_local +#else +#define _Thread_local __thread +#endif +#endif + +#endif /* __STDC_VERSION__ || __STDC_VERSION__ < 201112L */ + +/* + * Emulation of C11 _Generic(). Unlike the previously defined C11 + * keywords, it is not possible to implement this using exactly the same + * syntax. Therefore implement something similar under the name + * __generic(). Unlike _Generic(), this macro can only distinguish + * between a single type, so it requires nested invocations to + * distinguish multiple cases. + */ + +#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L +#define __generic(expr, t, yes, no) \ + _Generic(expr, t: yes, default: no) +#elif __GNUC_PREREQ__(3, 1) && !defined(__cplusplus) +#define __generic(expr, t, yes, no) \ + __builtin_choose_expr( \ + __builtin_types_compatible_p(__typeof(expr), t), yes, no) +#endif + +#if __GNUC_PREREQ__(2, 96) +#define __malloc_like __attribute__((__malloc__)) +#define __pure __attribute__((__pure__)) +#else +#define __malloc_like +#define __pure +#endif + +#if __GNUC_PREREQ__(3, 1) || (defined(__INTEL_COMPILER) && __INTEL_COMPILER >= 800) +#define __always_inline __attribute__((__always_inline__)) +#else +#define __always_inline +#endif + +#if __GNUC_PREREQ__(3, 1) +#define __noinline __attribute__ ((__noinline__)) +#else +#define __noinline +#endif + +#if __GNUC_PREREQ__(3, 3) +#define __nonnull(x) __attribute__((__nonnull__(x))) +#else +#define __nonnull(x) +#endif + +#if __GNUC_PREREQ__(3, 4) +#define __fastcall __attribute__((__fastcall__)) +#else +#define __fastcall +#endif + +#if __GNUC_PREREQ__(4, 1) +#define __returns_twice __attribute__((__returns_twice__)) +#else +#define __returns_twice +#endif + +/* XXX: should use `#if __STDC_VERSION__ < 199901'. */ +#if !__GNUC_PREREQ__(2, 7) && !defined(__INTEL_COMPILER) +#define __func__ NULL +#endif + +/* + * GCC 2.95 provides `__restrict' as an extension to C90 to support the + * C99-specific `restrict' type qualifier. We happen to use `__restrict' as + * a way to define the `restrict' type qualifier without disturbing older + * software that is unaware of C99 keywords. + */ +#if !(__GNUC__ == 2 && __GNUC_MINOR__ == 95) +#if !defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901 || defined(lint) +#define __restrict +#else +#define __restrict restrict +#endif +#endif + +/* + * GNU C version 2.96 adds explicit branch prediction so that + * the CPU back-end can hint the processor and also so that + * code blocks can be reordered such that the predicted path + * sees a more linear flow, thus improving cache behavior, etc. + * + * The following two macros provide us with a way to utilize this + * compiler feature. Use __predict_true() if you expect the expression + * to evaluate to true, and __predict_false() if you expect the + * expression to evaluate to false. + * + * A few notes about usage: + * + * * Generally, __predict_false() error condition checks (unless + * you have some _strong_ reason to do otherwise, in which case + * document it), and/or __predict_true() `no-error' condition + * checks, assuming you want to optimize for the no-error case. + * + * * Other than that, if you don't know the likelihood of a test + * succeeding from empirical or other `hard' evidence, don't + * make predictions. + * + * * These are meant to be used in places that are run `a lot'. + * It is wasteful to make predictions in code that is run + * seldomly (e.g. at subsystem initialization time) as the + * basic block reordering that this affects can often generate + * larger code. + */ +#if __GNUC_PREREQ__(2, 96) +#define __predict_true(exp) __builtin_expect((exp), 1) +#define __predict_false(exp) __builtin_expect((exp), 0) +#else +#define __predict_true(exp) (exp) +#define __predict_false(exp) (exp) +#endif + +#if __GNUC_PREREQ__(4, 2) +#define __hidden __attribute__((__visibility__("hidden"))) +#define __exported __attribute__((__visibility__("default"))) +#else +#define __hidden +#define __exported +#endif + +#define __offsetof(type, field) offsetof(type, field) +#define __rangeof(type, start, end) \ + (__offsetof(type, end) - __offsetof(type, start)) + +/* + * Given the pointer x to the member m of the struct s, return + * a pointer to the containing structure. When using GCC, we first + * assign pointer x to a local variable, to check that its type is + * compatible with member m. + */ +#if __GNUC_PREREQ__(3, 1) +#define __containerof(x, s, m) ({ \ + const volatile __typeof__(((s *)0)->m) *__x = (x); \ + __DEQUALIFY(s *, (const volatile char *)__x - __offsetof(s, m));\ +}) +#else +#define __containerof(x, s, m) \ + __DEQUALIFY(s *, (const volatile char *)(x) - __offsetof(s, m)) +#endif + +/* + * Compiler-dependent macros to declare that functions take printf-like + * or scanf-like arguments. They are null except for versions of gcc + * that are known to support the features properly (old versions of gcc-2 + * didn't permit keeping the keywords out of the application namespace). + */ +#if !__GNUC_PREREQ__(2, 7) && !defined(__INTEL_COMPILER) +#define __printflike(fmtarg, firstvararg) +#define __scanflike(fmtarg, firstvararg) +#define __format_arg(fmtarg) +#define __strfmonlike(fmtarg, firstvararg) +#define __strftimelike(fmtarg, firstvararg) +#else +#define __printflike(fmtarg, firstvararg) \ + __attribute__((__format__ (__printf__, fmtarg, firstvararg))) +#define __scanflike(fmtarg, firstvararg) \ + __attribute__((__format__ (__scanf__, fmtarg, firstvararg))) +#define __format_arg(fmtarg) __attribute__((__format_arg__ (fmtarg))) +#define __strfmonlike(fmtarg, firstvararg) \ + __attribute__((__format__ (__strfmon__, fmtarg, firstvararg))) +#define __strftimelike(fmtarg, firstvararg) \ + __attribute__((__format__ (__strftime__, fmtarg, firstvararg))) +#endif + +/* Compiler-dependent macros that rely on FreeBSD-specific extensions. */ +#if defined(__FreeBSD_cc_version) && __FreeBSD_cc_version >= 300001 && \ + defined(__GNUC__) && !defined(__INTEL_COMPILER) +#define __printf0like(fmtarg, firstvararg) \ + __attribute__((__format__ (__printf0__, fmtarg, firstvararg))) +#else +#define __printf0like(fmtarg, firstvararg) +#endif + +#if defined(__GNUC__) || defined(__INTEL_COMPILER) +#ifndef __INTEL_COMPILER +#define __strong_reference(sym,aliassym) \ + extern __typeof (sym) aliassym __attribute__ ((__alias__ (#sym))) +#endif +#ifdef __ELF__ +#ifdef __STDC__ +#define __weak_reference(sym,alias) \ + __asm__(".weak " #alias); \ + __asm__(".equ " #alias ", " #sym) +#define __warn_references(sym,msg) \ + __asm__(".section .gnu.warning." #sym); \ + __asm__(".asciz \"" msg "\""); \ + __asm__(".previous") +#define __sym_compat(sym,impl,verid) \ + __asm__(".symver " #impl ", " #sym "@" #verid) +#define __sym_default(sym,impl,verid) \ + __asm__(".symver " #impl ", " #sym "@@" #verid) +#else +#define __weak_reference(sym,alias) \ + __asm__(".weak alias"); \ + __asm__(".equ alias, sym") +#define __warn_references(sym,msg) \ + __asm__(".section .gnu.warning.sym"); \ + __asm__(".asciz \"msg\""); \ + __asm__(".previous") +#define __sym_compat(sym,impl,verid) \ + __asm__(".symver impl, sym@verid") +#define __sym_default(impl,sym,verid) \ + __asm__(".symver impl, sym@@verid") +#endif /* __STDC__ */ +#else /* !__ELF__ */ +#ifdef __STDC__ +#define __weak_reference(sym,alias) \ + __asm__(".stabs \"_" #alias "\",11,0,0,0"); \ + __asm__(".stabs \"_" #sym "\",1,0,0,0") +#define __warn_references(sym,msg) \ + __asm__(".stabs \"" msg "\",30,0,0,0"); \ + __asm__(".stabs \"_" #sym "\",1,0,0,0") +#else +#define __weak_reference(sym,alias) \ + __asm__(".stabs \"_/**/alias\",11,0,0,0"); \ + __asm__(".stabs \"_/**/sym\",1,0,0,0") +#define __warn_references(sym,msg) \ + __asm__(".stabs msg,30,0,0,0"); \ + __asm__(".stabs \"_/**/sym\",1,0,0,0") +#endif /* __STDC__ */ +#endif /* __ELF__ */ +#endif /* __GNUC__ || __INTEL_COMPILER */ + +#ifndef __FBSDID +#define __FBSDID(s) struct __hack +#endif + +#ifndef __RCSID +#define __RCSID(s) struct __hack +#endif + +#ifndef __RCSID_SOURCE +#define __RCSID_SOURCE(s) struct __hack +#endif + +#ifndef __SCCSID +#define __SCCSID(s) struct __hack +#endif + +#ifndef __COPYRIGHT +#define __COPYRIGHT(s) struct __hack +#endif + +#ifndef __DECONST +#define __DECONST(type, var) ((type)(__uintptr_t)(const void *)(var)) +#endif + +#ifndef __DEVOLATILE +#define __DEVOLATILE(type, var) ((type)(__uintptr_t)(volatile void *)(var)) +#endif + +#ifndef __DEQUALIFY +#define __DEQUALIFY(type, var) ((type)(__uintptr_t)(const volatile void *)(var)) +#endif + +/*- + * The following definitions are an extension of the behavior originally + * implemented in , but with a different level of granularity. + * POSIX.1 requires that the macros we test be defined before any standard + * header file is included. + * + * Here's a quick run-down of the versions: + * defined(_POSIX_SOURCE) 1003.1-1988 + * _POSIX_C_SOURCE == 1 1003.1-1990 + * _POSIX_C_SOURCE == 2 1003.2-1992 C Language Binding Option + * _POSIX_C_SOURCE == 199309 1003.1b-1993 + * _POSIX_C_SOURCE == 199506 1003.1c-1995, 1003.1i-1995, + * and the omnibus ISO/IEC 9945-1: 1996 + * _POSIX_C_SOURCE == 200112 1003.1-2001 + * _POSIX_C_SOURCE == 200809 1003.1-2008 + * + * In addition, the X/Open Portability Guide, which is now the Single UNIX + * Specification, defines a feature-test macro which indicates the version of + * that specification, and which subsumes _POSIX_C_SOURCE. + * + * Our macros begin with two underscores to avoid namespace screwage. + */ + +/* Deal with IEEE Std. 1003.1-1990, in which _POSIX_C_SOURCE == 1. */ +#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 1 +#undef _POSIX_C_SOURCE /* Probably illegal, but beyond caring now. */ +#define _POSIX_C_SOURCE 199009 +#endif + +/* Deal with IEEE Std. 1003.2-1992, in which _POSIX_C_SOURCE == 2. */ +#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE == 2 +#undef _POSIX_C_SOURCE +#define _POSIX_C_SOURCE 199209 +#endif + +/* Deal with various X/Open Portability Guides and Single UNIX Spec. */ +#ifdef _XOPEN_SOURCE +#if _XOPEN_SOURCE - 0 >= 700 +#define __XSI_VISIBLE 700 +#undef _POSIX_C_SOURCE +#define _POSIX_C_SOURCE 200809 +#elif _XOPEN_SOURCE - 0 >= 600 +#define __XSI_VISIBLE 600 +#undef _POSIX_C_SOURCE +#define _POSIX_C_SOURCE 200112 +#elif _XOPEN_SOURCE - 0 >= 500 +#define __XSI_VISIBLE 500 +#undef _POSIX_C_SOURCE +#define _POSIX_C_SOURCE 199506 +#endif +#endif + +/* + * Deal with all versions of POSIX. The ordering relative to the tests above is + * important. + */ +#if defined(_POSIX_SOURCE) && !defined(_POSIX_C_SOURCE) +#define _POSIX_C_SOURCE 198808 +#endif +#ifdef _POSIX_C_SOURCE +#if _POSIX_C_SOURCE >= 200809 +#define __POSIX_VISIBLE 200809 +#define __ISO_C_VISIBLE 1999 +#elif _POSIX_C_SOURCE >= 200112 +#define __POSIX_VISIBLE 200112 +#define __ISO_C_VISIBLE 1999 +#elif _POSIX_C_SOURCE >= 199506 +#define __POSIX_VISIBLE 199506 +#define __ISO_C_VISIBLE 1990 +#elif _POSIX_C_SOURCE >= 199309 +#define __POSIX_VISIBLE 199309 +#define __ISO_C_VISIBLE 1990 +#elif _POSIX_C_SOURCE >= 199209 +#define __POSIX_VISIBLE 199209 +#define __ISO_C_VISIBLE 1990 +#elif _POSIX_C_SOURCE >= 199009 +#define __POSIX_VISIBLE 199009 +#define __ISO_C_VISIBLE 1990 +#else +#define __POSIX_VISIBLE 198808 +#define __ISO_C_VISIBLE 0 +#endif /* _POSIX_C_SOURCE */ +#else +/*- + * Deal with _ANSI_SOURCE: + * If it is defined, and no other compilation environment is explicitly + * requested, then define our internal feature-test macros to zero. This + * makes no difference to the preprocessor (undefined symbols in preprocessing + * expressions are defined to have value zero), but makes it more convenient for + * a test program to print out the values. + * + * If a program mistakenly defines _ANSI_SOURCE and some other macro such as + * _POSIX_C_SOURCE, we will assume that it wants the broader compilation + * environment (and in fact we will never get here). + */ +#if defined(_ANSI_SOURCE) /* Hide almost everything. */ +#define __POSIX_VISIBLE 0 +#define __XSI_VISIBLE 0 +#define __BSD_VISIBLE 0 +#define __ISO_C_VISIBLE 1990 +#elif defined(_C99_SOURCE) /* Localism to specify strict C99 env. */ +#define __POSIX_VISIBLE 0 +#define __XSI_VISIBLE 0 +#define __BSD_VISIBLE 0 +#define __ISO_C_VISIBLE 1999 +#elif defined(_C11_SOURCE) /* Localism to specify strict C11 env. */ +#define __POSIX_VISIBLE 0 +#define __XSI_VISIBLE 0 +#define __BSD_VISIBLE 0 +#define __ISO_C_VISIBLE 2011 +#elif defined(_GNU_SOURCE) /* Everything and the kitchen sink. */ +#define __POSIX_VISIBLE 200809 +#define __XSI_VISIBLE 700 +#define __BSD_VISIBLE 1 +#define __ISO_C_VISIBLE 2011 +#define __GNU_VISIBLE 1 +#else /* Default: everything except __GNU_VISIBLE. */ +#define __POSIX_VISIBLE 200809 +#define __XSI_VISIBLE 700 +#define __BSD_VISIBLE 1 +#define __ISO_C_VISIBLE 2011 +#endif +#endif + +#endif /* !_SYS_CDEFS_H_ */ diff --git a/components/newlib/include/sys/config.h b/components/newlib/include/sys/config.h new file mode 100644 index 000000000..b5adfe102 --- /dev/null +++ b/components/newlib/include/sys/config.h @@ -0,0 +1,300 @@ +#ifndef __SYS_CONFIG_H__ +#define __SYS_CONFIG_H__ + +#include /* floating point macros */ +#include /* POSIX defs */ + +#ifdef __aarch64__ +#define MALLOC_ALIGNMENT 16 +#endif + +/* exceptions first */ +#if defined(__H8500__) || defined(__W65__) +#define __SMALL_BITFIELDS +/* ??? This conditional is true for the h8500 and the w65, defining H8300 + in those cases probably isn't the right thing to do. */ +#define H8300 1 +#endif + +/* 16 bit integer machines */ +#if defined(__Z8001__) || defined(__Z8002__) || defined(__H8500__) || defined(__W65__) || defined (__mn10200__) || defined (__AVR__) + +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX 32767 +#define UINT_MAX 65535 +#endif + +#if defined (__H8300__) || defined (__H8300H__) || defined(__H8300S__) || defined (__H8300SX__) +#define __SMALL_BITFIELDS +#define H8300 1 +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX __INT_MAX__ +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#endif + +#if (defined(__CR16__) || defined(__CR16C__) ||defined(__CR16CP__)) +#ifndef __INT32__ +#define __SMALL_BITFIELDS +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX 32767 +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#else /* INT32 */ +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX 2147483647 +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#endif /* INT32 */ + +#endif /* CR16C */ + +#if defined (__xc16x__) || defined (__xc16xL__) || defined (__xc16xS__) +#define __SMALL_BITFIELDS +#endif + +#ifdef __W65__ +#define __SMALL_BITFIELDS +#endif + +#if defined(__D10V__) +#define __SMALL_BITFIELDS +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX __INT_MAX__ +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#define _POINTER_INT short +#endif + +#if defined(__mc68hc11__) || defined(__mc68hc12__) || defined(__mc68hc1x__) +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX __INT_MAX__ +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#define _POINTER_INT short +#endif + +#if defined(__m68k__) || defined(__mc68000__) +#define _READ_WRITE_RETURN_TYPE _ssize_t +#endif + +#ifdef ___AM29K__ +#define _FLOAT_RET double +#endif + +#ifdef __i386__ +#ifndef __unix__ +/* in other words, go32 */ +#define _FLOAT_RET double +#endif +#if defined(__linux__) || defined(__RDOS__) +/* we want the reentrancy structure to be returned by a function */ +#define __DYNAMIC_REENT__ +#define HAVE_GETDATE +#define _HAVE_SYSTYPES +#define _READ_WRITE_RETURN_TYPE _ssize_t +#define __LARGE64_FILES 1 +/* we use some glibc header files so turn on glibc large file feature */ +#define _LARGEFILE64_SOURCE 1 +#endif +#endif + +#ifdef __mn10200__ +#define __SMALL_BITFIELDS +#endif + +#ifdef __AVR__ +#define __SMALL_BITFIELDS +#define _POINTER_INT short +#endif + +#ifdef __v850 +#define __ATTRIBUTE_IMPURE_PTR__ __attribute__((__sda__)) +#endif + +/* For the PowerPC eabi, force the _impure_ptr to be in .sdata */ +#if defined(__PPC__) +#if defined(_CALL_SYSV) +#define __ATTRIBUTE_IMPURE_PTR__ __attribute__((__section__(".sdata"))) +#endif +#ifdef __SPE__ +#define _LONG_DOUBLE double +#endif +#endif + +/* Configure small REENT structure for Xilinx MicroBlaze platforms */ +#if defined (__MICROBLAZE__) +#ifndef _REENT_SMALL +#define _REENT_SMALL +#endif +/* Xilinx XMK uses Unix98 mutex */ +#ifdef __XMK__ +#define _UNIX98_THREAD_MUTEX_ATTRIBUTES +#endif +#endif + +#if defined(__mips__) && !defined(__rtems__) +#define __ATTRIBUTE_IMPURE_PTR__ __attribute__((__section__(".sdata"))) +#endif + +#ifdef __xstormy16__ +#define __SMALL_BITFIELDS +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX __INT_MAX__ +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#define MALLOC_ALIGNMENT 8 +#define _POINTER_INT short +#define __BUFSIZ__ 16 +#define _REENT_SMALL +#endif + +#if defined __MSP430__ +#ifndef _REENT_SMALL +#define _REENT_SMALL +#endif + +#define __SMALL_BITFIELDS + +#ifdef __MSP430X_LARGE__ +#define _POINTER_INT long +#else +#define _POINTER_INT int +#endif +#endif + +#ifdef __m32c__ +#define __SMALL_BITFIELDS +#undef INT_MAX +#undef UINT_MAX +#define INT_MAX __INT_MAX__ +#define UINT_MAX (__INT_MAX__ * 2U + 1) +#define MALLOC_ALIGNMENT 8 +#if defined(__r8c_cpu__) || defined(__m16c_cpu__) +#define _POINTER_INT short +#else +#define _POINTER_INT long +#endif +#define __BUFSIZ__ 16 +#define _REENT_SMALL +#endif /* __m32c__ */ + +#ifdef __SPU__ +#define MALLOC_ALIGNMENT 16 +#define __CUSTOM_FILE_IO__ +#endif + +#ifdef __XTENSA__ +#include +#define MALLOC_ALIGNMENT ((XCHAL_DATA_WIDTH) < 16 ? 16 : (XCHAL_DATA_WIDTH)) +/* esp8266-specific: shrink the default fd buffer size */ +#define __BUFSIZ__ 128 +#ifndef __DYNAMIC_REENT__ +#define __DYNAMIC_REENT__ +#endif +#ifndef _REENT_SMALL +#define _REENT_SMALL +#endif +#define HAVE_GETOPT +#endif + +/* This block should be kept in sync with GCC's limits.h. The point + of having these definitions here is to not include limits.h, which + would pollute the user namespace, while still using types of the + the correct widths when deciding how to define __int32_t and + __int64_t. */ +#ifndef __INT_MAX__ +# ifdef INT_MAX +# define __INT_MAX__ INT_MAX +# else +# define __INT_MAX__ 2147483647 +# endif +#endif + +#ifndef __LONG_MAX__ +# ifdef LONG_MAX +# define __LONG_MAX__ LONG_MAX +# else +# if defined (__alpha__) || (defined (__sparc__) && defined(__arch64__)) \ + || defined (__sparcv9) +# define __LONG_MAX__ 9223372036854775807L +# else +# define __LONG_MAX__ 2147483647L +# endif /* __alpha__ || sparc64 */ +# endif +#endif +/* End of block that should be kept in sync with GCC's limits.h. */ + +#ifndef _POINTER_INT +#define _POINTER_INT long +#endif + +#ifdef __frv__ +#define __ATTRIBUTE_IMPURE_PTR__ __attribute__((__section__(".sdata"))) +#endif +#undef __RAND_MAX +#if __INT_MAX__ == 32767 +#define __RAND_MAX 32767 +#else +#define __RAND_MAX 0x7fffffff +#endif + +#if defined(__CYGWIN__) +#include +#if !defined (__STRICT_ANSI__) || (__STDC_VERSION__ >= 199901L) +#define __USE_XOPEN2K 1 +#endif +#endif + +#if defined(__rtems__) +#define __FILENAME_MAX__ 255 +#define _READ_WRITE_RETURN_TYPE _ssize_t +#define __DYNAMIC_REENT__ +#define _REENT_GLOBAL_ATEXIT +#endif + +#ifndef __EXPORT +#define __EXPORT +#endif + +#ifndef __IMPORT +#define __IMPORT +#endif + +/* Define return type of read/write routines. In POSIX, the return type + for read()/write() is "ssize_t" but legacy newlib code has been using + "int" for some time. If not specified, "int" is defaulted. */ +#ifndef _READ_WRITE_RETURN_TYPE +#define _READ_WRITE_RETURN_TYPE int +#endif +/* Define `count' parameter of read/write routines. In POSIX, the `count' + parameter is "size_t" but legacy newlib code has been using "int" for some + time. If not specified, "int" is defaulted. */ +#ifndef _READ_WRITE_BUFSIZE_TYPE +#define _READ_WRITE_BUFSIZE_TYPE int +#endif + +#ifndef __WCHAR_MAX__ +#if __INT_MAX__ == 32767 || defined (_WIN32) +#define __WCHAR_MAX__ 0xffffu +#endif +#endif + +/* See if small reent asked for at configuration time and + is not chosen by the platform by default. */ +#ifdef _WANT_REENT_SMALL +#ifndef _REENT_SMALL +#define _REENT_SMALL +#endif +#endif + +/* If _MB_EXTENDED_CHARSETS_ALL is set, we want all of the extended + charsets. The extended charsets add a few functions and a couple + of tables of a few K each. */ +#ifdef _MB_EXTENDED_CHARSETS_ALL +#define _MB_EXTENDED_CHARSETS_ISO 1 +#define _MB_EXTENDED_CHARSETS_WINDOWS 1 +#endif + +#endif /* __SYS_CONFIG_H__ */ diff --git a/components/newlib/include/sys/custom_file.h b/components/newlib/include/sys/custom_file.h new file mode 100644 index 000000000..96314fb91 --- /dev/null +++ b/components/newlib/include/sys/custom_file.h @@ -0,0 +1,2 @@ +#error System-specific custom_file.h is missing. + diff --git a/components/newlib/include/sys/dir.h b/components/newlib/include/sys/dir.h new file mode 100644 index 000000000..220150dc9 --- /dev/null +++ b/components/newlib/include/sys/dir.h @@ -0,0 +1,10 @@ +/* BSD predecessor of POSIX.1 and struct dirent */ + +#ifndef _SYS_DIR_H_ +#define _SYS_DIR_H_ + +#include + +#define direct dirent + +#endif /*_SYS_DIR_H_*/ diff --git a/components/newlib/include/sys/dirent.h b/components/newlib/include/sys/dirent.h new file mode 100644 index 000000000..a3fb5c02c --- /dev/null +++ b/components/newlib/include/sys/dirent.h @@ -0,0 +1,13 @@ +/* includes , which is this file. On a + system which supports , this file is overridden by + dirent.h in the libc/sys/.../sys directory. On a system which does + not support , we will get this file which uses #error to force + an error. */ + +#ifdef __cplusplus +extern "C" { +#endif +#error " not supported" +#ifdef __cplusplus +} +#endif diff --git a/components/newlib/include/sys/errno.h b/components/newlib/include/sys/errno.h new file mode 100644 index 000000000..a72c37320 --- /dev/null +++ b/components/newlib/include/sys/errno.h @@ -0,0 +1,192 @@ +/* errno is not a global variable, because that would make using it + non-reentrant. Instead, its address is returned by the function + __errno. */ + +#ifndef _SYS_ERRNO_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _SYS_ERRNO_H_ + +#include + +#ifndef _REENT_ONLY +#define errno (*__errno()) +extern int *__errno _PARAMS ((void)); +#endif + +/* Please don't use these variables directly. + Use strerror instead. */ +extern __IMPORT _CONST char * _CONST _sys_errlist[]; +extern __IMPORT int _sys_nerr; +#ifdef __CYGWIN__ +extern __IMPORT const char * const sys_errlist[]; +extern __IMPORT int sys_nerr; +extern __IMPORT char *program_invocation_name; +extern __IMPORT char *program_invocation_short_name; +#endif + +#define __errno_r(ptr) ((ptr)->_errno) + +#define EPERM 1 /* Not owner */ +#define ENOENT 2 /* No such file or directory */ +#define ESRCH 3 /* No such process */ +#define EINTR 4 /* Interrupted system call */ +#define EIO 5 /* I/O error */ +#define ENXIO 6 /* No such device or address */ +#define E2BIG 7 /* Arg list too long */ +#define ENOEXEC 8 /* Exec format error */ +#define EBADF 9 /* Bad file number */ +#define ECHILD 10 /* No children */ +#define EAGAIN 11 /* No more processes */ +#define ENOMEM 12 /* Not enough space */ +#define EACCES 13 /* Permission denied */ +#define EFAULT 14 /* Bad address */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ENOTBLK 15 /* Block device required */ +#endif +#define EBUSY 16 /* Device or resource busy */ +#define EEXIST 17 /* File exists */ +#define EXDEV 18 /* Cross-device link */ +#define ENODEV 19 /* No such device */ +#define ENOTDIR 20 /* Not a directory */ +#define EISDIR 21 /* Is a directory */ +#define EINVAL 22 /* Invalid argument */ +#define ENFILE 23 /* Too many open files in system */ +#define EMFILE 24 /* File descriptor value too large */ +#define ENOTTY 25 /* Not a character device */ +#define ETXTBSY 26 /* Text file busy */ +#define EFBIG 27 /* File too large */ +#define ENOSPC 28 /* No space left on device */ +#define ESPIPE 29 /* Illegal seek */ +#define EROFS 30 /* Read-only file system */ +#define EMLINK 31 /* Too many links */ +#define EPIPE 32 /* Broken pipe */ +#define EDOM 33 /* Mathematics argument out of domain of function */ +#define ERANGE 34 /* Result too large */ +#define ENOMSG 35 /* No message of desired type */ +#define EIDRM 36 /* Identifier removed */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ECHRNG 37 /* Channel number out of range */ +#define EL2NSYNC 38 /* Level 2 not synchronized */ +#define EL3HLT 39 /* Level 3 halted */ +#define EL3RST 40 /* Level 3 reset */ +#define ELNRNG 41 /* Link number out of range */ +#define EUNATCH 42 /* Protocol driver not attached */ +#define ENOCSI 43 /* No CSI structure available */ +#define EL2HLT 44 /* Level 2 halted */ +#endif +#define EDEADLK 45 /* Deadlock */ +#define ENOLCK 46 /* No lock */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define EBADE 50 /* Invalid exchange */ +#define EBADR 51 /* Invalid request descriptor */ +#define EXFULL 52 /* Exchange full */ +#define ENOANO 53 /* No anode */ +#define EBADRQC 54 /* Invalid request code */ +#define EBADSLT 55 /* Invalid slot */ +#define EDEADLOCK 56 /* File locking deadlock error */ +#define EBFONT 57 /* Bad font file fmt */ +#endif +#define ENOSTR 60 /* Not a stream */ +#define ENODATA 61 /* No data (for no delay io) */ +#define ETIME 62 /* Stream ioctl timeout */ +#define ENOSR 63 /* No stream resources */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ENONET 64 /* Machine is not on the network */ +#define ENOPKG 65 /* Package not installed */ +#define EREMOTE 66 /* The object is remote */ +#endif +#define ENOLINK 67 /* Virtual circuit is gone */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define EADV 68 /* Advertise error */ +#define ESRMNT 69 /* Srmount error */ +#define ECOMM 70 /* Communication error on send */ +#endif +#define EPROTO 71 /* Protocol error */ +#define EMULTIHOP 74 /* Multihop attempted */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ELBIN 75 /* Inode is remote (not really error) */ +#define EDOTDOT 76 /* Cross mount point (not really error) */ +#endif +#define EBADMSG 77 /* Bad message */ +#define EFTYPE 79 /* Inappropriate file type or format */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ENOTUNIQ 80 /* Given log. name not unique */ +#define EBADFD 81 /* f.d. invalid for this operation */ +#define EREMCHG 82 /* Remote address changed */ +#define ELIBACC 83 /* Can't access a needed shared lib */ +#define ELIBBAD 84 /* Accessing a corrupted shared lib */ +#define ELIBSCN 85 /* .lib section in a.out corrupted */ +#define ELIBMAX 86 /* Attempting to link in too many libs */ +#define ELIBEXEC 87 /* Attempting to exec a shared library */ +#endif +#define ENOSYS 88 /* Function not implemented */ +#ifdef __CYGWIN__ +#define ENMFILE 89 /* No more files */ +#endif +#define ENOTEMPTY 90 /* Directory not empty */ +#define ENAMETOOLONG 91 /* File or path name too long */ +#define ELOOP 92 /* Too many symbolic links */ +#define EOPNOTSUPP 95 /* Operation not supported on socket */ +#define EPFNOSUPPORT 96 /* Protocol family not supported */ +#define ECONNRESET 104 /* Connection reset by peer */ +#define ENOBUFS 105 /* No buffer space available */ +#define EAFNOSUPPORT 106 /* Address family not supported by protocol family */ +#define EPROTOTYPE 107 /* Protocol wrong type for socket */ +#define ENOTSOCK 108 /* Socket operation on non-socket */ +#define ENOPROTOOPT 109 /* Protocol not available */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ESHUTDOWN 110 /* Can't send after socket shutdown */ +#endif +#define ECONNREFUSED 111 /* Connection refused */ +#define EADDRINUSE 112 /* Address already in use */ +#define ECONNABORTED 113 /* Software caused connection abort */ +#define ENETUNREACH 114 /* Network is unreachable */ +#define ENETDOWN 115 /* Network interface is not configured */ +#define ETIMEDOUT 116 /* Connection timed out */ +#define EHOSTDOWN 117 /* Host is down */ +#define EHOSTUNREACH 118 /* Host is unreachable */ +#define EINPROGRESS 119 /* Connection already in progress */ +#define EALREADY 120 /* Socket already connected */ +#define EDESTADDRREQ 121 /* Destination address required */ +#define EMSGSIZE 122 /* Message too long */ +#define EPROTONOSUPPORT 123 /* Unknown protocol */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ESOCKTNOSUPPORT 124 /* Socket type not supported */ +#endif +#define EADDRNOTAVAIL 125 /* Address not available */ +#define ENETRESET 126 /* Connection aborted by network */ +#define EISCONN 127 /* Socket is already connected */ +#define ENOTCONN 128 /* Socket is not connected */ +#define ETOOMANYREFS 129 +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define EPROCLIM 130 +#define EUSERS 131 +#endif +#define EDQUOT 132 +#define ESTALE 133 +#define ENOTSUP 134 /* Not supported */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ENOMEDIUM 135 /* No medium (in tape drive) */ +#endif +#ifdef __CYGWIN__ +#define ENOSHARE 136 /* No such host or network path */ +#define ECASECLASH 137 /* Filename exists with different case */ +#endif +#define EILSEQ 138 /* Illegal byte sequence */ +#define EOVERFLOW 139 /* Value too large for defined data type */ +#define ECANCELED 140 /* Operation canceled */ +#define ENOTRECOVERABLE 141 /* State not recoverable */ +#define EOWNERDEAD 142 /* Previous owner died */ +#ifdef __LINUX_ERRNO_EXTENSIONS__ +#define ESTRPIPE 143 /* Streams pipe error */ +#endif +#define EWOULDBLOCK EAGAIN /* Operation would block */ + +#define __ELASTERROR 2000 /* Users can add values starting here */ + +#ifdef __cplusplus +} +#endif +#endif /* _SYS_ERRNO_H */ diff --git a/components/newlib/include/sys/fcntl.h b/components/newlib/include/sys/fcntl.h new file mode 100644 index 000000000..be85f40c1 --- /dev/null +++ b/components/newlib/include/sys/fcntl.h @@ -0,0 +1,4 @@ +#ifndef _SYS_FCNTL_H_ +#define _SYS_FCNTL_H_ +#include +#endif diff --git a/components/newlib/include/sys/features.h b/components/newlib/include/sys/features.h new file mode 100644 index 000000000..1d90921af --- /dev/null +++ b/components/newlib/include/sys/features.h @@ -0,0 +1,235 @@ +/* + * Written by Joel Sherrill . + * + * COPYRIGHT (c) 1989-2000. + * + * On-Line Applications Research Corporation (OAR). + * + * Permission to use, copy, modify, and distribute this software for any + * purpose without fee is hereby granted, provided that this entire notice + * is included in all copies of any software which is or includes a copy + * or modification of this software. + * + * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED + * WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION + * OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS + * SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + * + * $Id$ + */ + +#ifndef _SYS_FEATURES_H +#define _SYS_FEATURES_H + +#ifdef __cplusplus +extern "C" { +#endif + +/* Macros to determine that newlib is being used. Put in this header to + * be similar to where glibc stores its version of these macros. + */ +#define __NEWLIB__ 2 +#define __NEWLIB_MINOR__ 1 + +/* Macro to test version of GCC. Returns 0 for non-GCC or too old GCC. */ +#ifndef __GNUC_PREREQ +# if defined __GNUC__ && defined __GNUC_MINOR__ +# define __GNUC_PREREQ(maj, min) \ + ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min)) +# else +# define __GNUC_PREREQ(maj, min) 0 +# endif +#endif /* __GNUC_PREREQ */ +/* Version with trailing underscores for BSD compatibility. */ +#define __GNUC_PREREQ__(ma, mi) __GNUC_PREREQ(ma, mi) + +/* RTEMS adheres to POSIX -- 1003.1b with some features from annexes. */ + +#ifdef __rtems__ +#define _POSIX_JOB_CONTROL 1 +#define _POSIX_SAVED_IDS 1 +#define _POSIX_VERSION 199309L +#define _POSIX_ASYNCHRONOUS_IO 1 +#define _POSIX_FSYNC 1 +#define _POSIX_MAPPED_FILES 1 +#define _POSIX_MEMLOCK 1 +#define _POSIX_MEMLOCK_RANGE 1 +#define _POSIX_MEMORY_PROTECTION 1 +#define _POSIX_MESSAGE_PASSING 1 +#define _POSIX_MONOTONIC_CLOCK 200112L +#define _POSIX_PRIORITIZED_IO 1 +#define _POSIX_PRIORITY_SCHEDULING 1 +#define _POSIX_REALTIME_SIGNALS 1 +#define _POSIX_SEMAPHORES 1 +/* #define _POSIX_SHARED_MEMORY_OBJECTS 1 */ +#define _POSIX_SYNCHRONIZED_IO 1 +#define _POSIX_TIMERS 1 +#define _POSIX_BARRIERS 200112L +#define _POSIX_READER_WRITER_LOCKS 200112L +#define _POSIX_SPIN_LOCKS 200112L + + +/* In P1003.1b but defined by drafts at least as early as P1003.1c/D10 */ +#define _POSIX_THREADS 1 +#define _POSIX_THREAD_ATTR_STACKADDR 1 +#define _POSIX_THREAD_ATTR_STACKSIZE 1 +#define _POSIX_THREAD_PRIORITY_SCHEDULING 1 +#define _POSIX_THREAD_PRIO_INHERIT 1 +#define _POSIX_THREAD_PRIO_PROTECT 1 +#define _POSIX_THREAD_PROCESS_SHARED 1 +#define _POSIX_THREAD_SAFE_FUNCTIONS 1 + +/* P1003.4b/D8 defines the constants below this comment. */ +#define _POSIX_SPAWN 1 +#define _POSIX_TIMEOUTS 1 +#define _POSIX_CPUTIME 1 +#define _POSIX_THREAD_CPUTIME 1 +#define _POSIX_SPORADIC_SERVER 1 +#define _POSIX_THREAD_SPORADIC_SERVER 1 +#define _POSIX_DEVICE_CONTROL 1 +#define _POSIX_DEVCTL_DIRECTION 1 +#define _POSIX_INTERRUPT_CONTROL 1 +#define _POSIX_ADVISORY_INFO 1 + +/* UNIX98 added some new pthread mutex attributes */ +#define _UNIX98_THREAD_MUTEX_ATTRIBUTES 1 + +#endif + +/* XMK loosely adheres to POSIX -- 1003.1 */ +#ifdef __XMK__ +#define _POSIX_THREADS 1 +#define _POSIX_THREAD_PRIORITY_SCHEDULING 1 +#endif + + +#ifdef __svr4__ +# define _POSIX_JOB_CONTROL 1 +# define _POSIX_SAVED_IDS 1 +# define _POSIX_VERSION 199009L +#endif + +#ifdef __CYGWIN__ + +#if !defined(__STRICT_ANSI__) || defined(__cplusplus) || __STDC_VERSION__ >= 199901L +#define _POSIX_VERSION 200112L +#define _POSIX2_VERSION 200112L +#define _XOPEN_VERSION 600 + +#define _POSIX_ADVISORY_INFO 200112L +/* #define _POSIX_ASYNCHRONOUS_IO -1 */ +/* #define _POSIX_BARRIERS -1 */ +#define _POSIX_CHOWN_RESTRICTED 1 +#define _POSIX_CLOCK_SELECTION 200112L +#define _POSIX_CPUTIME 200112L +#define _POSIX_FSYNC 200112L +#define _POSIX_IPV6 200112L +#define _POSIX_JOB_CONTROL 1 +#define _POSIX_MAPPED_FILES 200112L +/* #define _POSIX_MEMLOCK -1 */ +#define _POSIX_MEMLOCK_RANGE 200112L +#define _POSIX_MEMORY_PROTECTION 200112L +#define _POSIX_MESSAGE_PASSING 200112L +#define _POSIX_MONOTONIC_CLOCK 200112L +#define _POSIX_NO_TRUNC 1 +/* #define _POSIX_PRIORITIZED_IO -1 */ +#define _POSIX_PRIORITY_SCHEDULING 200112L +#define _POSIX_RAW_SOCKETS 200112L +#define _POSIX_READER_WRITER_LOCKS 200112L +#define _POSIX_REALTIME_SIGNALS 200112L +#define _POSIX_REGEXP 1 +#define _POSIX_SAVED_IDS 1 +#define _POSIX_SEMAPHORES 200112L +#define _POSIX_SHARED_MEMORY_OBJECTS 200112L +#define _POSIX_SHELL 1 +/* #define _POSIX_SPAWN -1 */ +#define _POSIX_SPIN_LOCKS 200112L +/* #define _POSIX_SPORADIC_SERVER -1 */ +#define _POSIX_SYNCHRONIZED_IO 200112L +#define _POSIX_THREAD_ATTR_STACKADDR 200112L +#define _POSIX_THREAD_ATTR_STACKSIZE 200112L +#define _POSIX_THREAD_CPUTIME 200112L +/* #define _POSIX_THREAD_PRIO_INHERIT -1 */ +/* #define _POSIX_THREAD_PRIO_PROTECT -1 */ +#define _POSIX_THREAD_PRIORITY_SCHEDULING 200112L +#define _POSIX_THREAD_PROCESS_SHARED 200112L +#define _POSIX_THREAD_SAFE_FUNCTIONS 200112L +/* #define _POSIX_THREAD_SPORADIC_SERVER -1 */ +#define _POSIX_THREADS 200112L +/* #define _POSIX_TIMEOUTS -1 */ +#define _POSIX_TIMERS 1 +/* #define _POSIX_TRACE -1 */ +/* #define _POSIX_TRACE_EVENT_FILTER -1 */ +/* #define _POSIX_TRACE_INHERIT -1 */ +/* #define _POSIX_TRACE_LOG -1 */ +/* #define _POSIX_TYPED_MEMORY_OBJECTS -1 */ +#define _POSIX_VDISABLE '\0' +#define _POSIX2_C_BIND 200112L +#define _POSIX2_C_DEV 200112L +#define _POSIX2_CHAR_TERM 200112L +/* #define _POSIX2_FORT_DEV -1 */ +/* #define _POSIX2_FORT_RUN -1 */ +/* #define _POSIX2_LOCALEDEF -1 */ +/* #define _POSIX2_PBS -1 */ +/* #define _POSIX2_PBS_ACCOUNTING -1 */ +/* #define _POSIX2_PBS_CHECKPOINT -1 */ +/* #define _POSIX2_PBS_LOCATE -1 */ +/* #define _POSIX2_PBS_MESSAGE -1 */ +/* #define _POSIX2_PBS_TRACK -1 */ +#define _POSIX2_SW_DEV 200112L +#define _POSIX2_UPE 200112L +#define _POSIX_V6_ILP32_OFF32 -1 +#ifdef __LP64__ +#define _POSIX_V6_ILP32_OFFBIG -1 +#define _POSIX_V6_LP64_OFF64 1 +#define _POSIX_V6_LPBIG_OFFBIG 1 +#else +#define _POSIX_V6_ILP32_OFFBIG 1 +#define _POSIX_V6_LP64_OFF64 -1 +#define _POSIX_V6_LPBIG_OFFBIG -1 +#endif +#define _XBS5_ILP32_OFF32 _POSIX_V6_ILP32_OFF32 +#define _XBS5_ILP32_OFFBIG _POSIX_V6_ILP32_OFFBIG +#define _XBS5_LP64_OFF64 _POSIX_V6_LP64_OFF64 +#define _XBS5_LPBIG_OFFBIG _POSIX_V6_LPBIG_OFFBIG +#define _XOPEN_CRYPT 1 +#define _XOPEN_ENH_I18N 1 +/* #define _XOPEN_LEGACY -1 */ +/* #define _XOPEN_REALTIME -1 */ +/* #define _XOPEN_REALTIME_THREADS -1 */ +#define _XOPEN_SHM 1 +/* #define _XOPEN_STREAMS -1 */ +/* #define _XOPEN_UNIX -1 */ + +#endif /* !__STRICT_ANSI__ || __cplusplus || __STDC_VERSION__ >= 199901L */ + +/* The value corresponds to UNICODE version 4.0, which is the version + supported by XP. Newlib supports 5.2 (2011) but so far Cygwin needs + the MS conversions for double-byte charsets. */ +#define __STDC_ISO_10646__ 200305L + +#endif /* __CYGWIN__ */ + +/* Per the permission given in POSIX.1-2008 section 2.2.1, define + * _POSIX_C_SOURCE if _XOPEN_SOURCE is defined and _POSIX_C_SOURCE is not. + * (_XOPEN_SOURCE indicates that XSI extensions are desired by an application.) + * This permission is first granted in 2008, but use it for older ones, also. + * Allow for _XOPEN_SOURCE to be empty (from the earliest form of it, before it + * was required to have specific values). + */ +#if !defined(_POSIX_C_SOURCE) && defined(_XOPEN_SOURCE) + #if (_XOPEN_SOURCE - 0) == 700 /* POSIX.1-2008 */ + #define _POSIX_C_SOURCE 200809L + #elif (_XOPEN_SOURCE - 0) == 600 /* POSIX.1-2001 or 2004 */ + #define _POSIX_C_SOURCE 200112L + #elif (_XOPEN_SOURCE - 0) == 500 /* POSIX.1-1995 */ + #define _POSIX_C_SOURCE 199506L + #elif (_XOPEN_SOURCE - 0) < 500 /* really old */ + #define _POSIX_C_SOURCE 2 + #endif +#endif + +#ifdef __cplusplus +} +#endif +#endif /* _SYS_FEATURES_H */ diff --git a/components/newlib/include/sys/file.h b/components/newlib/include/sys/file.h new file mode 100644 index 000000000..be88c6a5a --- /dev/null +++ b/components/newlib/include/sys/file.h @@ -0,0 +1,33 @@ +/* Copyright (c) 2005-2006 Tensilica Inc. ALL RIGHTS RESERVED. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS + IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TENSILICA + INCORPORATED BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ + +#include + +/* Alternate names for values for the WHENCE argument to `lseek'. + These are the same as SEEK_SET, SEEK_CUR, and SEEK_END, respectively. */ +#ifndef L_SET +#define L_SET 0 /* Seek from beginning of file. */ +#define L_INCR 1 /* Seek from current position. */ +#define L_XTND 2 /* Seek from end of file. */ +#endif diff --git a/components/newlib/include/sys/iconvnls.h b/components/newlib/include/sys/iconvnls.h new file mode 100644 index 000000000..09ea18316 --- /dev/null +++ b/components/newlib/include/sys/iconvnls.h @@ -0,0 +1,77 @@ +/* + * Copyright (c) 2003-2004, Artem B. Bityuckiy. + * Rights transferred to Franklin Electronic Publishers. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +/* + * Funtions, macros, etc implimented in iconv library but used by other + * NLS-related subsystems too. + */ +#ifndef __SYS_ICONVNLS_H__ +#define __SYS_ICONVNLS_H__ + +#include <_ansi.h> +#include +#include +#include + +/* Iconv data path environment variable name */ +#define NLS_ENVVAR_NAME "NLSPATH" +/* Default NLSPATH value */ +#define ICONV_DEFAULT_NLSPATH "/usr/locale" +/* Direction markers */ +#define ICONV_NLS_FROM 0 +#define ICONV_NLS_TO 1 + +_VOID +_EXFUN(_iconv_nls_get_state, (iconv_t cd, mbstate_t *ps, int direction)); + +int +_EXFUN(_iconv_nls_set_state, (iconv_t cd, mbstate_t *ps, int direction)); + +int +_EXFUN(_iconv_nls_is_stateful, (iconv_t cd, int direction)); + +int +_EXFUN(_iconv_nls_get_mb_cur_max, (iconv_t cd, int direction)); + +size_t +_EXFUN(_iconv_nls_conv, (struct _reent *rptr, iconv_t cd, + _CONST char **inbuf, size_t *inbytesleft, + char **outbuf, size_t *outbytesleft)); + +_CONST char * +_EXFUN(_iconv_nls_construct_filename, (struct _reent *rptr, _CONST char *file, + _CONST char *dir, _CONST char *ext)); + + +int +_EXFUN(_iconv_nls_open, (struct _reent *rptr, _CONST char *encoding, + iconv_t *towc, iconv_t *fromwc, int flag)); + +char * +_EXFUN(_iconv_resolve_encoding_name, (struct _reent *rptr, _CONST char *ca)); + +#endif /* __SYS_ICONVNLS_H__ */ + diff --git a/components/newlib/include/sys/lock.h b/components/newlib/include/sys/lock.h new file mode 100644 index 000000000..0ff347583 --- /dev/null +++ b/components/newlib/include/sys/lock.h @@ -0,0 +1,50 @@ +#ifndef _XTENSA_LOCK_H__ +#define _XTENSA_LOCK_H__ + +/* generic lock implementation. + + Weak linked stub _lock functions in lock.c, can be + replaced with a lock implementation at link time. + + */ + +typedef int _lock_t; +typedef _lock_t _LOCK_RECURSIVE_T; +typedef _lock_t _LOCK_T; + +#include <_ansi.h> + +/* NOTE: some parts of newlib statically initialise locks via + __LOCK_INIT, some initialise at runtime via __lock_init. So need to + support possibility that a _lock_t is null during first call to + _lock_acquire or _lock_try_acquire. + + Lock functions all take a pointer to the _lock_t entry, so the + value stored there can be manipulated. +*/ +#define __LOCK_INIT(CLASS,NAME) CLASS _lock_t NAME = 0; +#define __LOCK_INIT_RECURSIVE(CLASS,NAME) CLASS _lock_t NAME = 0; + +void _lock_init(_lock_t *lock); +void _lock_init_recursive(_lock_t *lock); +void _lock_close(_lock_t *lock); +void _lock_close_recursive(_lock_t *lock); +void _lock_acquire(_lock_t *lock); +void _lock_acquire_recursive(_lock_t *lock); +int _lock_try_acquire(_lock_t *lock); +int _lock_try_acquire_recursive(_lock_t *lock); +void _lock_release(_lock_t *lock); +void _lock_release_recursive(_lock_t *lock); + +#define __lock_init(lock) _lock_init(&(lock)) +#define __lock_init_recursive(lock) _lock_init_recursive(&(lock)) +#define __lock_close(lock) _lock_close(&(lock)) +#define __lock_close_recursive(lock) _lock_close_recursive(&(lock)) +#define __lock_acquire(lock) _lock_acquire(&(lock)) +#define __lock_acquire_recursive(lock) _lock_acquire_recursive(&(lock)) +#define __lock_try_acquire(lock) _lock_try_acquire(&(lock)) +#define __lock_try_acquire_recursive(lock) _lock_try_acquire_recursive(&(lock)) +#define __lock_release(lock) _lock_release(&(lock)) +#define __lock_release_recursive(lock) _lock_release_recursive(&(lock)) + +#endif /* _XTENSA_LOCK_H__ */ diff --git a/components/newlib/include/sys/param.h b/components/newlib/include/sys/param.h new file mode 100644 index 000000000..ef203d3ec --- /dev/null +++ b/components/newlib/include/sys/param.h @@ -0,0 +1,28 @@ +/* This is a dummy file, not customized for any + particular system. If there is a param.h in libc/sys/SYSDIR/sys, + it will override this one. */ + +#ifndef _SYS_PARAM_H +# define _SYS_PARAM_H + +#include +#include +#include +#include + +#ifndef HZ +# define HZ (60) +#endif +#ifndef NOFILE +# define NOFILE (60) +#endif +#ifndef PATHSIZE +# define PATHSIZE (1024) +#endif + +#define MAXPATHLEN PATH_MAX + +#define MAX(a,b) ((a) > (b) ? (a) : (b)) +#define MIN(a,b) ((a) < (b) ? (a) : (b)) + +#endif diff --git a/components/newlib/include/sys/queue.h b/components/newlib/include/sys/queue.h new file mode 100644 index 000000000..4bc7dac0e --- /dev/null +++ b/components/newlib/include/sys/queue.h @@ -0,0 +1,691 @@ +/*- + * Copyright (c) 1991, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)queue.h 8.5 (Berkeley) 8/20/94 + * $FreeBSD$ + */ + +#ifndef _SYS_QUEUE_H_ +#define _SYS_QUEUE_H_ + +#include + +/* + * This file defines four types of data structures: singly-linked lists, + * singly-linked tail queues, lists and tail queues. + * + * A singly-linked list is headed by a single forward pointer. The elements + * are singly linked for minimum space and pointer manipulation overhead at + * the expense of O(n) removal for arbitrary elements. New elements can be + * added to the list after an existing element or at the head of the list. + * Elements being removed from the head of the list should use the explicit + * macro for this purpose for optimum efficiency. A singly-linked list may + * only be traversed in the forward direction. Singly-linked lists are ideal + * for applications with large datasets and few or no removals or for + * implementing a LIFO queue. + * + * A singly-linked tail queue is headed by a pair of pointers, one to the + * head of the list and the other to the tail of the list. The elements are + * singly linked for minimum space and pointer manipulation overhead at the + * expense of O(n) removal for arbitrary elements. New elements can be added + * to the list after an existing element, at the head of the list, or at the + * end of the list. Elements being removed from the head of the tail queue + * should use the explicit macro for this purpose for optimum efficiency. + * A singly-linked tail queue may only be traversed in the forward direction. + * Singly-linked tail queues are ideal for applications with large datasets + * and few or no removals or for implementing a FIFO queue. + * + * A list is headed by a single forward pointer (or an array of forward + * pointers for a hash table header). The elements are doubly linked + * so that an arbitrary element can be removed without a need to + * traverse the list. New elements can be added to the list before + * or after an existing element or at the head of the list. A list + * may be traversed in either direction. + * + * A tail queue is headed by a pair of pointers, one to the head of the + * list and the other to the tail of the list. The elements are doubly + * linked so that an arbitrary element can be removed without a need to + * traverse the list. New elements can be added to the list before or + * after an existing element, at the head of the list, or at the end of + * the list. A tail queue may be traversed in either direction. + * + * For details on the use of these macros, see the queue(3) manual page. + * + * + * SLIST LIST STAILQ TAILQ + * _HEAD + + + + + * _HEAD_INITIALIZER + + + + + * _ENTRY + + + + + * _INIT + + + + + * _EMPTY + + + + + * _FIRST + + + + + * _NEXT + + + + + * _PREV - + - + + * _LAST - - + + + * _FOREACH + + + + + * _FOREACH_SAFE + + + + + * _FOREACH_REVERSE - - - + + * _FOREACH_REVERSE_SAFE - - - + + * _INSERT_HEAD + + + + + * _INSERT_BEFORE - + - + + * _INSERT_AFTER + + + + + * _INSERT_TAIL - - + + + * _CONCAT - - + + + * _REMOVE_AFTER + - + - + * _REMOVE_HEAD + - + - + * _REMOVE + + + + + * _SWAP + + + + + * + */ +#ifdef QUEUE_MACRO_DEBUG +/* Store the last 2 places the queue element or head was altered */ +struct qm_trace { + unsigned long lastline; + unsigned long prevline; + const char *lastfile; + const char *prevfile; +}; + +#define TRACEBUF struct qm_trace trace; +#define TRACEBUF_INITIALIZER { __FILE__, __LINE__, NULL, 0 } , +#define TRASHIT(x) do {(x) = (void *)-1;} while (0) +#define QMD_SAVELINK(name, link) void **name = (void *)&(link) + +#define QMD_TRACE_HEAD(head) do { \ + (head)->trace.prevline = (head)->trace.lastline; \ + (head)->trace.prevfile = (head)->trace.lastfile; \ + (head)->trace.lastline = __LINE__; \ + (head)->trace.lastfile = __FILE__; \ +} while (0) + +#define QMD_TRACE_ELEM(elem) do { \ + (elem)->trace.prevline = (elem)->trace.lastline; \ + (elem)->trace.prevfile = (elem)->trace.lastfile; \ + (elem)->trace.lastline = __LINE__; \ + (elem)->trace.lastfile = __FILE__; \ +} while (0) + +#else +#define QMD_TRACE_ELEM(elem) +#define QMD_TRACE_HEAD(head) +#define QMD_SAVELINK(name, link) +#define TRACEBUF +#define TRACEBUF_INITIALIZER +#define TRASHIT(x) +#endif /* QUEUE_MACRO_DEBUG */ + +/* + * Singly-linked List declarations. + */ +#define SLIST_HEAD(name, type) \ +struct name { \ + struct type *slh_first; /* first element */ \ +} + +#define SLIST_HEAD_INITIALIZER(head) \ + { NULL } + +#define SLIST_ENTRY(type) \ +struct { \ + struct type *sle_next; /* next element */ \ +} + +/* + * Singly-linked List functions. + */ +#define SLIST_EMPTY(head) ((head)->slh_first == NULL) + +#define SLIST_FIRST(head) ((head)->slh_first) + +#define SLIST_FOREACH(var, head, field) \ + for ((var) = SLIST_FIRST((head)); \ + (var); \ + (var) = SLIST_NEXT((var), field)) + +#define SLIST_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = SLIST_FIRST((head)); \ + (var) && ((tvar) = SLIST_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define SLIST_FOREACH_PREVPTR(var, varp, head, field) \ + for ((varp) = &SLIST_FIRST((head)); \ + ((var) = *(varp)) != NULL; \ + (varp) = &SLIST_NEXT((var), field)) + +#define SLIST_INIT(head) do { \ + SLIST_FIRST((head)) = NULL; \ +} while (0) + +#define SLIST_INSERT_AFTER(slistelm, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_NEXT((slistelm), field); \ + SLIST_NEXT((slistelm), field) = (elm); \ +} while (0) + +#define SLIST_INSERT_HEAD(head, elm, field) do { \ + SLIST_NEXT((elm), field) = SLIST_FIRST((head)); \ + SLIST_FIRST((head)) = (elm); \ +} while (0) + +#define SLIST_NEXT(elm, field) ((elm)->field.sle_next) + +#define SLIST_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.sle_next); \ + if (SLIST_FIRST((head)) == (elm)) { \ + SLIST_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = SLIST_FIRST((head)); \ + while (SLIST_NEXT(curelm, field) != (elm)) \ + curelm = SLIST_NEXT(curelm, field); \ + SLIST_REMOVE_AFTER(curelm, field); \ + } \ + TRASHIT(*oldnext); \ +} while (0) + +#define SLIST_REMOVE_AFTER(elm, field) do { \ + SLIST_NEXT(elm, field) = \ + SLIST_NEXT(SLIST_NEXT(elm, field), field); \ +} while (0) + +#define SLIST_REMOVE_HEAD(head, field) do { \ + SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field); \ +} while (0) + +#define SLIST_SWAP(head1, head2, type) do { \ + struct type *swap_first = SLIST_FIRST(head1); \ + SLIST_FIRST(head1) = SLIST_FIRST(head2); \ + SLIST_FIRST(head2) = swap_first; \ +} while (0) + +/* + * Singly-linked Tail queue declarations. + */ +#define STAILQ_HEAD(name, type) \ +struct name { \ + struct type *stqh_first;/* first element */ \ + struct type **stqh_last;/* addr of last next element */ \ +} + +#define STAILQ_HEAD_INITIALIZER(head) \ + { NULL, &(head).stqh_first } + +#define STAILQ_ENTRY(type) \ +struct { \ + struct type *stqe_next; /* next element */ \ +} + +/* + * Singly-linked Tail queue functions. + */ +#define STAILQ_CONCAT(head1, head2) do { \ + if (!STAILQ_EMPTY((head2))) { \ + *(head1)->stqh_last = (head2)->stqh_first; \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_INIT((head2)); \ + } \ +} while (0) + +#define STAILQ_EMPTY(head) ((head)->stqh_first == NULL) + +#define STAILQ_FIRST(head) ((head)->stqh_first) + +#define STAILQ_FOREACH(var, head, field) \ + for((var) = STAILQ_FIRST((head)); \ + (var); \ + (var) = STAILQ_NEXT((var), field)) + + +#define STAILQ_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = STAILQ_FIRST((head)); \ + (var) && ((tvar) = STAILQ_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define STAILQ_INIT(head) do { \ + STAILQ_FIRST((head)) = NULL; \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ +} while (0) + +#define STAILQ_INSERT_AFTER(head, tqelm, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_NEXT((tqelm), field)) == NULL)\ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_NEXT((tqelm), field) = (elm); \ +} while (0) + +#define STAILQ_INSERT_HEAD(head, elm, field) do { \ + if ((STAILQ_NEXT((elm), field) = STAILQ_FIRST((head))) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ + STAILQ_FIRST((head)) = (elm); \ +} while (0) + +#define STAILQ_INSERT_TAIL(head, elm, field) do { \ + STAILQ_NEXT((elm), field) = NULL; \ + *(head)->stqh_last = (elm); \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ +} while (0) + +#define STAILQ_LAST(head, type, field) \ + (STAILQ_EMPTY((head)) ? NULL : \ + __containerof((head)->stqh_last, struct type, field.stqe_next)) + +#define STAILQ_NEXT(elm, field) ((elm)->field.stqe_next) + +#define STAILQ_REMOVE(head, elm, type, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.stqe_next); \ + if (STAILQ_FIRST((head)) == (elm)) { \ + STAILQ_REMOVE_HEAD((head), field); \ + } \ + else { \ + struct type *curelm = STAILQ_FIRST((head)); \ + while (STAILQ_NEXT(curelm, field) != (elm)) \ + curelm = STAILQ_NEXT(curelm, field); \ + STAILQ_REMOVE_AFTER(head, curelm, field); \ + } \ + TRASHIT(*oldnext); \ +} while (0) + +#define STAILQ_REMOVE_AFTER(head, elm, field) do { \ + if ((STAILQ_NEXT(elm, field) = \ + STAILQ_NEXT(STAILQ_NEXT(elm, field), field)) == NULL) \ + (head)->stqh_last = &STAILQ_NEXT((elm), field); \ +} while (0) + +#define STAILQ_REMOVE_HEAD(head, field) do { \ + if ((STAILQ_FIRST((head)) = \ + STAILQ_NEXT(STAILQ_FIRST((head)), field)) == NULL) \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ +} while (0) + +#define STAILQ_REMOVE_HEAD_UNTIL(head, elm, field) do { \ + if ((STAILQ_FIRST((head)) = STAILQ_NEXT((elm), field)) == NULL) \ + (head)->stqh_last = &STAILQ_FIRST((head)); \ +} while (0) + +#define STAILQ_SWAP(head1, head2, type) do { \ + struct type *swap_first = STAILQ_FIRST(head1); \ + struct type **swap_last = (head1)->stqh_last; \ + STAILQ_FIRST(head1) = STAILQ_FIRST(head2); \ + (head1)->stqh_last = (head2)->stqh_last; \ + STAILQ_FIRST(head2) = swap_first; \ + (head2)->stqh_last = swap_last; \ + if (STAILQ_EMPTY(head1)) \ + (head1)->stqh_last = &STAILQ_FIRST(head1); \ + if (STAILQ_EMPTY(head2)) \ + (head2)->stqh_last = &STAILQ_FIRST(head2); \ +} while (0) + + +/* + * List declarations. + */ +#define LIST_HEAD(name, type) \ +struct name { \ + struct type *lh_first; /* first element */ \ +} + +#define LIST_HEAD_INITIALIZER(head) \ + { NULL } + +#define LIST_ENTRY(type) \ +struct { \ + struct type *le_next; /* next element */ \ + struct type **le_prev; /* address of previous next element */ \ +} + +/* + * List functions. + */ + +#if (defined(_KERNEL) && defined(INVARIANTS)) +#define QMD_LIST_CHECK_HEAD(head, field) do { \ + if (LIST_FIRST((head)) != NULL && \ + LIST_FIRST((head))->field.le_prev != \ + &LIST_FIRST((head))) \ + panic("Bad list head %p first->prev != head", (head)); \ +} while (0) + +#define QMD_LIST_CHECK_NEXT(elm, field) do { \ + if (LIST_NEXT((elm), field) != NULL && \ + LIST_NEXT((elm), field)->field.le_prev != \ + &((elm)->field.le_next)) \ + panic("Bad link elm %p next->prev != elm", (elm)); \ +} while (0) + +#define QMD_LIST_CHECK_PREV(elm, field) do { \ + if (*(elm)->field.le_prev != (elm)) \ + panic("Bad link elm %p prev->next != elm", (elm)); \ +} while (0) +#else +#define QMD_LIST_CHECK_HEAD(head, field) +#define QMD_LIST_CHECK_NEXT(elm, field) +#define QMD_LIST_CHECK_PREV(elm, field) +#endif /* (_KERNEL && INVARIANTS) */ + +#define LIST_EMPTY(head) ((head)->lh_first == NULL) + +#define LIST_FIRST(head) ((head)->lh_first) + +#define LIST_FOREACH(var, head, field) \ + for ((var) = LIST_FIRST((head)); \ + (var); \ + (var) = LIST_NEXT((var), field)) + +#define LIST_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = LIST_FIRST((head)); \ + (var) && ((tvar) = LIST_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define LIST_INIT(head) do { \ + LIST_FIRST((head)) = NULL; \ +} while (0) + +#define LIST_INSERT_AFTER(listelm, elm, field) do { \ + QMD_LIST_CHECK_NEXT(listelm, field); \ + if ((LIST_NEXT((elm), field) = LIST_NEXT((listelm), field)) != NULL)\ + LIST_NEXT((listelm), field)->field.le_prev = \ + &LIST_NEXT((elm), field); \ + LIST_NEXT((listelm), field) = (elm); \ + (elm)->field.le_prev = &LIST_NEXT((listelm), field); \ +} while (0) + +#define LIST_INSERT_BEFORE(listelm, elm, field) do { \ + QMD_LIST_CHECK_PREV(listelm, field); \ + (elm)->field.le_prev = (listelm)->field.le_prev; \ + LIST_NEXT((elm), field) = (listelm); \ + *(listelm)->field.le_prev = (elm); \ + (listelm)->field.le_prev = &LIST_NEXT((elm), field); \ +} while (0) + +#define LIST_INSERT_HEAD(head, elm, field) do { \ + QMD_LIST_CHECK_HEAD((head), field); \ + if ((LIST_NEXT((elm), field) = LIST_FIRST((head))) != NULL) \ + LIST_FIRST((head))->field.le_prev = &LIST_NEXT((elm), field);\ + LIST_FIRST((head)) = (elm); \ + (elm)->field.le_prev = &LIST_FIRST((head)); \ +} while (0) + +#define LIST_NEXT(elm, field) ((elm)->field.le_next) + +#define LIST_PREV(elm, head, type, field) \ + ((elm)->field.le_prev == &LIST_FIRST((head)) ? NULL : \ + __containerof((elm)->field.le_prev, struct type, field.le_next)) + +#define LIST_REMOVE(elm, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.le_next); \ + QMD_SAVELINK(oldprev, (elm)->field.le_prev); \ + QMD_LIST_CHECK_NEXT(elm, field); \ + QMD_LIST_CHECK_PREV(elm, field); \ + if (LIST_NEXT((elm), field) != NULL) \ + LIST_NEXT((elm), field)->field.le_prev = \ + (elm)->field.le_prev; \ + *(elm)->field.le_prev = LIST_NEXT((elm), field); \ + TRASHIT(*oldnext); \ + TRASHIT(*oldprev); \ +} while (0) + +#define LIST_SWAP(head1, head2, type, field) do { \ + struct type *swap_tmp = LIST_FIRST((head1)); \ + LIST_FIRST((head1)) = LIST_FIRST((head2)); \ + LIST_FIRST((head2)) = swap_tmp; \ + if ((swap_tmp = LIST_FIRST((head1))) != NULL) \ + swap_tmp->field.le_prev = &LIST_FIRST((head1)); \ + if ((swap_tmp = LIST_FIRST((head2))) != NULL) \ + swap_tmp->field.le_prev = &LIST_FIRST((head2)); \ +} while (0) + +/* + * Tail queue declarations. + */ +#define TAILQ_HEAD(name, type) \ +struct name { \ + struct type *tqh_first; /* first element */ \ + struct type **tqh_last; /* addr of last next element */ \ + TRACEBUF \ +} + +#define TAILQ_HEAD_INITIALIZER(head) \ + { NULL, &(head).tqh_first, TRACEBUF_INITIALIZER } + +#define TAILQ_ENTRY(type) \ +struct { \ + struct type *tqe_next; /* next element */ \ + struct type **tqe_prev; /* address of previous next element */ \ + TRACEBUF \ +} + +/* + * Tail queue functions. + */ +#if (defined(_KERNEL) && defined(INVARIANTS)) +#define QMD_TAILQ_CHECK_HEAD(head, field) do { \ + if (!TAILQ_EMPTY(head) && \ + TAILQ_FIRST((head))->field.tqe_prev != \ + &TAILQ_FIRST((head))) \ + panic("Bad tailq head %p first->prev != head", (head)); \ +} while (0) + +#define QMD_TAILQ_CHECK_TAIL(head, field) do { \ + if (*(head)->tqh_last != NULL) \ + panic("Bad tailq NEXT(%p->tqh_last) != NULL", (head)); \ +} while (0) + +#define QMD_TAILQ_CHECK_NEXT(elm, field) do { \ + if (TAILQ_NEXT((elm), field) != NULL && \ + TAILQ_NEXT((elm), field)->field.tqe_prev != \ + &((elm)->field.tqe_next)) \ + panic("Bad link elm %p next->prev != elm", (elm)); \ +} while (0) + +#define QMD_TAILQ_CHECK_PREV(elm, field) do { \ + if (*(elm)->field.tqe_prev != (elm)) \ + panic("Bad link elm %p prev->next != elm", (elm)); \ +} while (0) +#else +#define QMD_TAILQ_CHECK_HEAD(head, field) +#define QMD_TAILQ_CHECK_TAIL(head, headname) +#define QMD_TAILQ_CHECK_NEXT(elm, field) +#define QMD_TAILQ_CHECK_PREV(elm, field) +#endif /* (_KERNEL && INVARIANTS) */ + +#define TAILQ_CONCAT(head1, head2, field) do { \ + if (!TAILQ_EMPTY(head2)) { \ + *(head1)->tqh_last = (head2)->tqh_first; \ + (head2)->tqh_first->field.tqe_prev = (head1)->tqh_last; \ + (head1)->tqh_last = (head2)->tqh_last; \ + TAILQ_INIT((head2)); \ + QMD_TRACE_HEAD(head1); \ + QMD_TRACE_HEAD(head2); \ + } \ +} while (0) + +#define TAILQ_EMPTY(head) ((head)->tqh_first == NULL) + +#define TAILQ_FIRST(head) ((head)->tqh_first) + +#define TAILQ_FOREACH(var, head, field) \ + for ((var) = TAILQ_FIRST((head)); \ + (var); \ + (var) = TAILQ_NEXT((var), field)) + +#define TAILQ_FOREACH_SAFE(var, head, field, tvar) \ + for ((var) = TAILQ_FIRST((head)); \ + (var) && ((tvar) = TAILQ_NEXT((var), field), 1); \ + (var) = (tvar)) + +#define TAILQ_FOREACH_REVERSE(var, head, headname, field) \ + for ((var) = TAILQ_LAST((head), headname); \ + (var); \ + (var) = TAILQ_PREV((var), headname, field)) + +#define TAILQ_FOREACH_REVERSE_SAFE(var, head, headname, field, tvar) \ + for ((var) = TAILQ_LAST((head), headname); \ + (var) && ((tvar) = TAILQ_PREV((var), headname, field), 1); \ + (var) = (tvar)) + +#define TAILQ_INIT(head) do { \ + TAILQ_FIRST((head)) = NULL; \ + (head)->tqh_last = &TAILQ_FIRST((head)); \ + QMD_TRACE_HEAD(head); \ +} while (0) + +#define TAILQ_INSERT_AFTER(head, listelm, elm, field) do { \ + QMD_TAILQ_CHECK_NEXT(listelm, field); \ + if ((TAILQ_NEXT((elm), field) = TAILQ_NEXT((listelm), field)) != NULL)\ + TAILQ_NEXT((elm), field)->field.tqe_prev = \ + &TAILQ_NEXT((elm), field); \ + else { \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_HEAD(head); \ + } \ + TAILQ_NEXT((listelm), field) = (elm); \ + (elm)->field.tqe_prev = &TAILQ_NEXT((listelm), field); \ + QMD_TRACE_ELEM(&(elm)->field); \ + QMD_TRACE_ELEM(&listelm->field); \ +} while (0) + +#define TAILQ_INSERT_BEFORE(listelm, elm, field) do { \ + QMD_TAILQ_CHECK_PREV(listelm, field); \ + (elm)->field.tqe_prev = (listelm)->field.tqe_prev; \ + TAILQ_NEXT((elm), field) = (listelm); \ + *(listelm)->field.tqe_prev = (elm); \ + (listelm)->field.tqe_prev = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_ELEM(&(elm)->field); \ + QMD_TRACE_ELEM(&listelm->field); \ +} while (0) + +#define TAILQ_INSERT_HEAD(head, elm, field) do { \ + QMD_TAILQ_CHECK_HEAD(head, field); \ + if ((TAILQ_NEXT((elm), field) = TAILQ_FIRST((head))) != NULL) \ + TAILQ_FIRST((head))->field.tqe_prev = \ + &TAILQ_NEXT((elm), field); \ + else \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + TAILQ_FIRST((head)) = (elm); \ + (elm)->field.tqe_prev = &TAILQ_FIRST((head)); \ + QMD_TRACE_HEAD(head); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_INSERT_TAIL(head, elm, field) do { \ + QMD_TAILQ_CHECK_TAIL(head, field); \ + TAILQ_NEXT((elm), field) = NULL; \ + (elm)->field.tqe_prev = (head)->tqh_last; \ + *(head)->tqh_last = (elm); \ + (head)->tqh_last = &TAILQ_NEXT((elm), field); \ + QMD_TRACE_HEAD(head); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_LAST(head, headname) \ + (*(((struct headname *)((head)->tqh_last))->tqh_last)) + +#define TAILQ_NEXT(elm, field) ((elm)->field.tqe_next) + +#define TAILQ_PREV(elm, headname, field) \ + (*(((struct headname *)((elm)->field.tqe_prev))->tqh_last)) + +#define TAILQ_REMOVE(head, elm, field) do { \ + QMD_SAVELINK(oldnext, (elm)->field.tqe_next); \ + QMD_SAVELINK(oldprev, (elm)->field.tqe_prev); \ + QMD_TAILQ_CHECK_NEXT(elm, field); \ + QMD_TAILQ_CHECK_PREV(elm, field); \ + if ((TAILQ_NEXT((elm), field)) != NULL) \ + TAILQ_NEXT((elm), field)->field.tqe_prev = \ + (elm)->field.tqe_prev; \ + else { \ + (head)->tqh_last = (elm)->field.tqe_prev; \ + QMD_TRACE_HEAD(head); \ + } \ + *(elm)->field.tqe_prev = TAILQ_NEXT((elm), field); \ + TRASHIT(*oldnext); \ + TRASHIT(*oldprev); \ + QMD_TRACE_ELEM(&(elm)->field); \ +} while (0) + +#define TAILQ_SWAP(head1, head2, type, field) do { \ + struct type *swap_first = (head1)->tqh_first; \ + struct type **swap_last = (head1)->tqh_last; \ + (head1)->tqh_first = (head2)->tqh_first; \ + (head1)->tqh_last = (head2)->tqh_last; \ + (head2)->tqh_first = swap_first; \ + (head2)->tqh_last = swap_last; \ + if ((swap_first = (head1)->tqh_first) != NULL) \ + swap_first->field.tqe_prev = &(head1)->tqh_first; \ + else \ + (head1)->tqh_last = &(head1)->tqh_first; \ + if ((swap_first = (head2)->tqh_first) != NULL) \ + swap_first->field.tqe_prev = &(head2)->tqh_first; \ + else \ + (head2)->tqh_last = &(head2)->tqh_first; \ +} while (0) + +#ifdef _KERNEL + +/* + * XXX insque() and remque() are an old way of handling certain queues. + * They bogusly assumes that all queue heads look alike. + */ + +struct quehead { + struct quehead *qh_link; + struct quehead *qh_rlink; +}; + +#ifdef __GNUC__ + +static __inline void +insque(void *a, void *b) +{ + struct quehead *element = (struct quehead *)a, + *head = (struct quehead *)b; + + element->qh_link = head->qh_link; + element->qh_rlink = head; + head->qh_link = element; + element->qh_link->qh_rlink = element; +} + +static __inline void +remque(void *a) +{ + struct quehead *element = (struct quehead *)a; + + element->qh_link->qh_rlink = element->qh_rlink; + element->qh_rlink->qh_link = element->qh_link; + element->qh_rlink = 0; +} + +#else /* !__GNUC__ */ + +void insque(void *a, void *b); +void remque(void *a); + +#endif /* __GNUC__ */ + +#endif /* _KERNEL */ + +#endif /* !_SYS_QUEUE_H_ */ diff --git a/components/newlib/include/sys/reent.h b/components/newlib/include/sys/reent.h new file mode 100644 index 000000000..bb52ae65f --- /dev/null +++ b/components/newlib/include/sys/reent.h @@ -0,0 +1,793 @@ +/* This header file provides the reentrancy. */ + +/* WARNING: All identifiers here must begin with an underscore. This file is + included by stdio.h and others and we therefore must only use identifiers + in the namespace allotted to us. */ + +#ifndef _SYS_REENT_H_ +#ifdef __cplusplus +extern "C" { +#endif +#define _SYS_REENT_H_ + +#include <_ansi.h> +#include +#include + +#define _NULL 0 + +#ifndef __Long +#if __LONG_MAX__ == 2147483647L +#define __Long long +typedef unsigned __Long __ULong; +#elif __INT_MAX__ == 2147483647 +#define __Long int +typedef unsigned __Long __ULong; +#endif +#endif + +#if !defined( __Long) +#include +#endif + +#ifndef __Long +#define __Long __int32_t +typedef __uint32_t __ULong; +#endif + +struct _reent; + +/* + * If _REENT_SMALL is defined, we make struct _reent as small as possible, + * by having nearly everything possible allocated at first use. + */ + +struct _Bigint +{ + struct _Bigint *_next; + int _k, _maxwds, _sign, _wds; + __ULong _x[1]; +}; + +/* needed by reentrant structure */ +struct __tm +{ + int __tm_sec; + int __tm_min; + int __tm_hour; + int __tm_mday; + int __tm_mon; + int __tm_year; + int __tm_wday; + int __tm_yday; + int __tm_isdst; +}; + +/* + * atexit() support. + */ + +#define _ATEXIT_SIZE 32 /* must be at least 32 to guarantee ANSI conformance */ + +struct _on_exit_args { + void * _fnargs[_ATEXIT_SIZE]; /* user fn args */ + void * _dso_handle[_ATEXIT_SIZE]; + /* Bitmask is set if user function takes arguments. */ + __ULong _fntypes; /* type of exit routine - + Must have at least _ATEXIT_SIZE bits */ + /* Bitmask is set if function was registered via __cxa_atexit. */ + __ULong _is_cxa; +}; + +#ifdef _REENT_SMALL +struct _atexit { + struct _atexit *_next; /* next in list */ + int _ind; /* next index in this table */ + void (*_fns[_ATEXIT_SIZE])(void); /* the table itself */ + struct _on_exit_args * _on_exit_args_ptr; +}; +# define _ATEXIT_INIT {_NULL, 0, {_NULL}, _NULL} +#else +struct _atexit { + struct _atexit *_next; /* next in list */ + int _ind; /* next index in this table */ + /* Some entries may already have been called, and will be NULL. */ + void (*_fns[_ATEXIT_SIZE])(void); /* the table itself */ + struct _on_exit_args _on_exit_args; +}; +# define _ATEXIT_INIT {_NULL, 0, {_NULL}, {{_NULL}, {_NULL}, 0, 0}} +#endif + +#ifdef _REENT_GLOBAL_ATEXIT +# define _REENT_INIT_ATEXIT +#else +# define _REENT_INIT_ATEXIT \ + _NULL, _ATEXIT_INIT, +#endif + +/* + * Stdio buffers. + * + * This and __FILE are defined here because we need them for struct _reent, + * but we don't want stdio.h included when stdlib.h is. + */ + +struct __sbuf { + unsigned char *_base; + int _size; +}; + +/* + * Stdio state variables. + * + * The following always hold: + * + * if (_flags&(__SLBF|__SWR)) == (__SLBF|__SWR), + * _lbfsize is -_bf._size, else _lbfsize is 0 + * if _flags&__SRD, _w is 0 + * if _flags&__SWR, _r is 0 + * + * This ensures that the getc and putc macros (or inline functions) never + * try to write or read from a file that is in `read' or `write' mode. + * (Moreover, they can, and do, automatically switch from read mode to + * write mode, and back, on "r+" and "w+" files.) + * + * _lbfsize is used only to make the inline line-buffered output stream + * code as compact as possible. + * + * _ub, _up, and _ur are used when ungetc() pushes back more characters + * than fit in the current _bf, or when ungetc() pushes back a character + * that does not match the previous one in _bf. When this happens, + * _ub._base becomes non-nil (i.e., a stream has ungetc() data iff + * _ub._base!=NULL) and _up and _ur save the current values of _p and _r. + */ + +#ifdef _REENT_SMALL +/* + * struct __sFILE_fake is the start of a struct __sFILE, with only the + * minimal fields allocated. In __sinit() we really allocate the 3 + * standard streams, etc., and point away from this fake. + */ +struct __sFILE_fake { + unsigned char *_p; /* current position in (some) buffer */ + int _r; /* read space left for getc() */ + int _w; /* write space left for putc() */ + short _flags; /* flags, below; this FILE is free if 0 */ + short _file; /* fileno, if Unix descriptor, else -1 */ + struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */ + int _lbfsize; /* 0 or -_bf._size, for inline putc */ + + struct _reent *_data; +}; + +/* Following is needed both in libc/stdio and libc/stdlib so we put it + * here instead of libc/stdio/local.h where it was previously. */ + +extern _VOID _EXFUN(__sinit,(struct _reent *)); + +# define _REENT_SMALL_CHECK_INIT(ptr) \ + do \ + { \ + if ((ptr) && !(ptr)->__sdidinit) \ + __sinit (ptr); \ + } \ + while (0) +#else +# define _REENT_SMALL_CHECK_INIT(ptr) /* nothing */ +#endif + +struct __sFILE { + unsigned char *_p; /* current position in (some) buffer */ + int _r; /* read space left for getc() */ + int _w; /* write space left for putc() */ + short _flags; /* flags, below; this FILE is free if 0 */ + short _file; /* fileno, if Unix descriptor, else -1 */ + struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */ + int _lbfsize; /* 0 or -_bf._size, for inline putc */ + +#ifdef _REENT_SMALL + struct _reent *_data; +#endif + + /* operations */ + _PTR _cookie; /* cookie passed to io functions */ + + _READ_WRITE_RETURN_TYPE _EXFNPTR(_read, (struct _reent *, _PTR, + char *, _READ_WRITE_BUFSIZE_TYPE)); + _READ_WRITE_RETURN_TYPE _EXFNPTR(_write, (struct _reent *, _PTR, + const char *, + _READ_WRITE_BUFSIZE_TYPE)); + _fpos_t _EXFNPTR(_seek, (struct _reent *, _PTR, _fpos_t, int)); + int _EXFNPTR(_close, (struct _reent *, _PTR)); + + /* separate buffer for long sequences of ungetc() */ + struct __sbuf _ub; /* ungetc buffer */ + unsigned char *_up; /* saved _p when _p is doing ungetc data */ + int _ur; /* saved _r when _r is counting ungetc data */ + + /* tricks to meet minimum requirements even when malloc() fails */ + unsigned char _ubuf[3]; /* guarantee an ungetc() buffer */ + unsigned char _nbuf[1]; /* guarantee a getc() buffer */ + + /* separate buffer for fgetline() when line crosses buffer boundary */ + struct __sbuf _lb; /* buffer for fgetline() */ + + /* Unix stdio files get aligned to block boundaries on fseek() */ + int _blksize; /* stat.st_blksize (may be != _bf._size) */ + _off_t _offset; /* current lseek offset */ + +#ifndef _REENT_SMALL + struct _reent *_data; /* Here for binary compatibility? Remove? */ +#endif + +#ifndef __SINGLE_THREAD__ + _flock_t _lock; /* for thread-safety locking */ +#endif + _mbstate_t _mbstate; /* for wide char stdio functions. */ + int _flags2; /* for future use */ +}; + +#ifdef __CUSTOM_FILE_IO__ + +/* Get custom _FILE definition. */ +#include + +#else /* !__CUSTOM_FILE_IO__ */ +#ifdef __LARGE64_FILES +struct __sFILE64 { + unsigned char *_p; /* current position in (some) buffer */ + int _r; /* read space left for getc() */ + int _w; /* write space left for putc() */ + short _flags; /* flags, below; this FILE is free if 0 */ + short _file; /* fileno, if Unix descriptor, else -1 */ + struct __sbuf _bf; /* the buffer (at least 1 byte, if !NULL) */ + int _lbfsize; /* 0 or -_bf._size, for inline putc */ + + struct _reent *_data; + + /* operations */ + _PTR _cookie; /* cookie passed to io functions */ + + _READ_WRITE_RETURN_TYPE _EXFNPTR(_read, (struct _reent *, _PTR, + char *, _READ_WRITE_BUFSIZE_TYPE)); + _READ_WRITE_RETURN_TYPE _EXFNPTR(_write, (struct _reent *, _PTR, + const char *, + _READ_WRITE_BUFSIZE_TYPE)); + _fpos_t _EXFNPTR(_seek, (struct _reent *, _PTR, _fpos_t, int)); + int _EXFNPTR(_close, (struct _reent *, _PTR)); + + /* separate buffer for long sequences of ungetc() */ + struct __sbuf _ub; /* ungetc buffer */ + unsigned char *_up; /* saved _p when _p is doing ungetc data */ + int _ur; /* saved _r when _r is counting ungetc data */ + + /* tricks to meet minimum requirements even when malloc() fails */ + unsigned char _ubuf[3]; /* guarantee an ungetc() buffer */ + unsigned char _nbuf[1]; /* guarantee a getc() buffer */ + + /* separate buffer for fgetline() when line crosses buffer boundary */ + struct __sbuf _lb; /* buffer for fgetline() */ + + /* Unix stdio files get aligned to block boundaries on fseek() */ + int _blksize; /* stat.st_blksize (may be != _bf._size) */ + int _flags2; /* for future use */ + + _off64_t _offset; /* current lseek offset */ + _fpos64_t _EXFNPTR(_seek64, (struct _reent *, _PTR, _fpos64_t, int)); + +#ifndef __SINGLE_THREAD__ + _flock_t _lock; /* for thread-safety locking */ +#endif + _mbstate_t _mbstate; /* for wide char stdio functions. */ +}; +typedef struct __sFILE64 __FILE; +#else +typedef struct __sFILE __FILE; +#endif /* __LARGE64_FILES */ +#endif /* !__CUSTOM_FILE_IO__ */ + +struct _glue +{ + struct _glue *_next; + int _niobs; + __FILE *_iobs; +}; + +/* + * rand48 family support + * + * Copyright (c) 1993 Martin Birgmeier + * All rights reserved. + * + * You may redistribute unmodified or modified versions of this source + * code provided that the above copyright notice and this and the + * following conditions are retained. + * + * This software is provided ``as is'', and comes with no warranties + * of any kind. I shall in no event be liable for anything that happens + * to anyone/anything when using this software. + */ +#define _RAND48_SEED_0 (0x330e) +#define _RAND48_SEED_1 (0xabcd) +#define _RAND48_SEED_2 (0x1234) +#define _RAND48_MULT_0 (0xe66d) +#define _RAND48_MULT_1 (0xdeec) +#define _RAND48_MULT_2 (0x0005) +#define _RAND48_ADD (0x000b) +struct _rand48 { + unsigned short _seed[3]; + unsigned short _mult[3]; + unsigned short _add; +#ifdef _REENT_SMALL + /* Put this in here as well, for good luck. */ + __extension__ unsigned long long _rand_next; +#endif +}; + +/* How big the some arrays are. */ +#define _REENT_EMERGENCY_SIZE 25 +#define _REENT_ASCTIME_SIZE 26 +#define _REENT_SIGNAL_SIZE 24 + +/* + * struct _reent + * + * This structure contains *all* globals needed by the library. + * It's raison d'etre is to facilitate threads by making all library routines + * reentrant. IE: All state information is contained here. + */ + +#ifdef _REENT_SMALL + +struct _mprec +{ + /* used by mprec routines */ + struct _Bigint *_result; + int _result_k; + struct _Bigint *_p5s; + struct _Bigint **_freelist; +}; + + +struct _misc_reent +{ + /* miscellaneous reentrant data */ + char *_strtok_last; + _mbstate_t _mblen_state; + _mbstate_t _wctomb_state; + _mbstate_t _mbtowc_state; + char _l64a_buf[8]; + int _getdate_err; + _mbstate_t _mbrlen_state; + _mbstate_t _mbrtowc_state; + _mbstate_t _mbsrtowcs_state; + _mbstate_t _wcrtomb_state; + _mbstate_t _wcsrtombs_state; +}; + +/* This version of _reent is laid out with "int"s in pairs, to help + * ports with 16-bit int's but 32-bit pointers, align nicely. */ +struct _reent +{ + /* As an exception to the above put _errno first for binary + compatibility with non _REENT_SMALL targets. */ + int _errno; /* local copy of errno */ + + /* FILE is a big struct and may change over time. To try to achieve binary + compatibility with future versions, put stdin,stdout,stderr here. + These are pointers into member __sf defined below. */ + __FILE *_stdin, *_stdout, *_stderr; /* XXX */ + + int _inc; /* used by tmpnam */ + + char *_emergency; + + int __sdidinit; /* 1 means stdio has been init'd */ + + int _current_category; /* unused */ + _CONST char *_current_locale; /* unused */ + + struct _mprec *_mp; + + void _EXFNPTR(__cleanup, (struct _reent *)); + + int _gamma_signgam; + + /* used by some fp conversion routines */ + int _cvtlen; /* should be size_t */ + char *_cvtbuf; + + struct _rand48 *_r48; + struct __tm *_localtime_buf; + char *_asctime_buf; + + /* signal info */ + void (**(_sig_func))(int); + +# ifndef _REENT_GLOBAL_ATEXIT + /* atexit stuff */ + struct _atexit *_atexit; + struct _atexit _atexit0; +# endif + + struct _glue __sglue; /* root of glue chain */ + __FILE *__sf; /* file descriptors */ + struct _misc_reent *_misc; /* strtok, multibyte states */ + char *_signal_buf; /* strsignal */ +}; + +extern const struct __sFILE_fake __sf_fake_stdin; +extern const struct __sFILE_fake __sf_fake_stdout; +extern const struct __sFILE_fake __sf_fake_stderr; + +# define _REENT_INIT(var) \ + { 0, \ + (__FILE *)&__sf_fake_stdin, \ + (__FILE *)&__sf_fake_stdout, \ + (__FILE *)&__sf_fake_stderr, \ + 0, \ + _NULL, \ + 0, \ + 0, \ + "C", \ + _NULL, \ + _NULL, \ + 0, \ + 0, \ + _NULL, \ + _NULL, \ + _NULL, \ + _NULL, \ + _NULL, \ + _REENT_INIT_ATEXIT \ + {_NULL, 0, _NULL}, \ + _NULL, \ + _NULL, \ + _NULL \ + } + +#define _REENT_INIT_PTR(var) \ + { memset((var), 0, sizeof(*(var))); \ + (var)->_stdin = (__FILE *)&__sf_fake_stdin; \ + (var)->_stdout = (__FILE *)&__sf_fake_stdout; \ + (var)->_stderr = (__FILE *)&__sf_fake_stderr; \ + (var)->_current_locale = "C"; \ + } + +/* Only built the assert() calls if we are built with debugging. */ +#if DEBUG +#include +#define __reent_assert(x) assert(x) +#else +#define __reent_assert(x) ((void)0) +#endif + +#ifdef __CUSTOM_FILE_IO__ +#error Custom FILE I/O and _REENT_SMALL not currently supported. +#endif + +/* Generic _REENT check macro. */ +#define _REENT_CHECK(var, what, type, size, init) do { \ + struct _reent *_r = (var); \ + if (_r->what == NULL) { \ + _r->what = (type)malloc(size); \ + __reent_assert(_r->what); \ + init; \ + } \ +} while (0) + +#define _REENT_CHECK_TM(var) \ + _REENT_CHECK(var, _localtime_buf, struct __tm *, sizeof *((var)->_localtime_buf), \ + /* nothing */) + +#define _REENT_CHECK_ASCTIME_BUF(var) \ + _REENT_CHECK(var, _asctime_buf, char *, _REENT_ASCTIME_SIZE, \ + memset((var)->_asctime_buf, 0, _REENT_ASCTIME_SIZE)) + +/* Handle the dynamically allocated rand48 structure. */ +#define _REENT_INIT_RAND48(var) do { \ + struct _reent *_r = (var); \ + _r->_r48->_seed[0] = _RAND48_SEED_0; \ + _r->_r48->_seed[1] = _RAND48_SEED_1; \ + _r->_r48->_seed[2] = _RAND48_SEED_2; \ + _r->_r48->_mult[0] = _RAND48_MULT_0; \ + _r->_r48->_mult[1] = _RAND48_MULT_1; \ + _r->_r48->_mult[2] = _RAND48_MULT_2; \ + _r->_r48->_add = _RAND48_ADD; \ + _r->_r48->_rand_next = 1; \ +} while (0) +#define _REENT_CHECK_RAND48(var) \ + _REENT_CHECK(var, _r48, struct _rand48 *, sizeof *((var)->_r48), _REENT_INIT_RAND48((var))) + +#define _REENT_INIT_MP(var) do { \ + struct _reent *_r = (var); \ + _r->_mp->_result_k = 0; \ + _r->_mp->_result = _r->_mp->_p5s = _NULL; \ + _r->_mp->_freelist = _NULL; \ +} while (0) +#define _REENT_CHECK_MP(var) \ + _REENT_CHECK(var, _mp, struct _mprec *, sizeof *((var)->_mp), _REENT_INIT_MP(var)) + +#define _REENT_CHECK_EMERGENCY(var) \ + _REENT_CHECK(var, _emergency, char *, _REENT_EMERGENCY_SIZE, /* nothing */) + +#define _REENT_INIT_MISC(var) do { \ + struct _reent *_r = (var); \ + _r->_misc->_strtok_last = _NULL; \ + _r->_misc->_mblen_state.__count = 0; \ + _r->_misc->_mblen_state.__value.__wch = 0; \ + _r->_misc->_wctomb_state.__count = 0; \ + _r->_misc->_wctomb_state.__value.__wch = 0; \ + _r->_misc->_mbtowc_state.__count = 0; \ + _r->_misc->_mbtowc_state.__value.__wch = 0; \ + _r->_misc->_mbrlen_state.__count = 0; \ + _r->_misc->_mbrlen_state.__value.__wch = 0; \ + _r->_misc->_mbrtowc_state.__count = 0; \ + _r->_misc->_mbrtowc_state.__value.__wch = 0; \ + _r->_misc->_mbsrtowcs_state.__count = 0; \ + _r->_misc->_mbsrtowcs_state.__value.__wch = 0; \ + _r->_misc->_wcrtomb_state.__count = 0; \ + _r->_misc->_wcrtomb_state.__value.__wch = 0; \ + _r->_misc->_wcsrtombs_state.__count = 0; \ + _r->_misc->_wcsrtombs_state.__value.__wch = 0; \ + _r->_misc->_l64a_buf[0] = '\0'; \ + _r->_misc->_getdate_err = 0; \ +} while (0) +#define _REENT_CHECK_MISC(var) \ + _REENT_CHECK(var, _misc, struct _misc_reent *, sizeof *((var)->_misc), _REENT_INIT_MISC(var)) + +#define _REENT_CHECK_SIGNAL_BUF(var) \ + _REENT_CHECK(var, _signal_buf, char *, _REENT_SIGNAL_SIZE, /* nothing */) + +#define _REENT_SIGNGAM(ptr) ((ptr)->_gamma_signgam) +#define _REENT_RAND_NEXT(ptr) ((ptr)->_r48->_rand_next) +#define _REENT_RAND48_SEED(ptr) ((ptr)->_r48->_seed) +#define _REENT_RAND48_MULT(ptr) ((ptr)->_r48->_mult) +#define _REENT_RAND48_ADD(ptr) ((ptr)->_r48->_add) +#define _REENT_MP_RESULT(ptr) ((ptr)->_mp->_result) +#define _REENT_MP_RESULT_K(ptr) ((ptr)->_mp->_result_k) +#define _REENT_MP_P5S(ptr) ((ptr)->_mp->_p5s) +#define _REENT_MP_FREELIST(ptr) ((ptr)->_mp->_freelist) +#define _REENT_ASCTIME_BUF(ptr) ((ptr)->_asctime_buf) +#define _REENT_TM(ptr) ((ptr)->_localtime_buf) +#define _REENT_EMERGENCY(ptr) ((ptr)->_emergency) +#define _REENT_STRTOK_LAST(ptr) ((ptr)->_misc->_strtok_last) +#define _REENT_MBLEN_STATE(ptr) ((ptr)->_misc->_mblen_state) +#define _REENT_MBTOWC_STATE(ptr)((ptr)->_misc->_mbtowc_state) +#define _REENT_WCTOMB_STATE(ptr)((ptr)->_misc->_wctomb_state) +#define _REENT_MBRLEN_STATE(ptr) ((ptr)->_misc->_mbrlen_state) +#define _REENT_MBRTOWC_STATE(ptr) ((ptr)->_misc->_mbrtowc_state) +#define _REENT_MBSRTOWCS_STATE(ptr) ((ptr)->_misc->_mbsrtowcs_state) +#define _REENT_WCRTOMB_STATE(ptr) ((ptr)->_misc->_wcrtomb_state) +#define _REENT_WCSRTOMBS_STATE(ptr) ((ptr)->_misc->_wcsrtombs_state) +#define _REENT_L64A_BUF(ptr) ((ptr)->_misc->_l64a_buf) +#define _REENT_GETDATE_ERR_P(ptr) (&((ptr)->_misc->_getdate_err)) +#define _REENT_SIGNAL_BUF(ptr) ((ptr)->_signal_buf) + +#else /* !_REENT_SMALL */ + +struct _reent +{ + int _errno; /* local copy of errno */ + + /* FILE is a big struct and may change over time. To try to achieve binary + compatibility with future versions, put stdin,stdout,stderr here. + These are pointers into member __sf defined below. */ + __FILE *_stdin, *_stdout, *_stderr; + + int _inc; /* used by tmpnam */ + char _emergency[_REENT_EMERGENCY_SIZE]; + + int _current_category; /* used by setlocale */ + _CONST char *_current_locale; + + int __sdidinit; /* 1 means stdio has been init'd */ + + void _EXFNPTR(__cleanup, (struct _reent *)); + + /* used by mprec routines */ + struct _Bigint *_result; + int _result_k; + struct _Bigint *_p5s; + struct _Bigint **_freelist; + + /* used by some fp conversion routines */ + int _cvtlen; /* should be size_t */ + char *_cvtbuf; + + union + { + struct + { + unsigned int _unused_rand; + char * _strtok_last; + char _asctime_buf[_REENT_ASCTIME_SIZE]; + struct __tm _localtime_buf; + int _gamma_signgam; + __extension__ unsigned long long _rand_next; + struct _rand48 _r48; + _mbstate_t _mblen_state; + _mbstate_t _mbtowc_state; + _mbstate_t _wctomb_state; + char _l64a_buf[8]; + char _signal_buf[_REENT_SIGNAL_SIZE]; + int _getdate_err; + _mbstate_t _mbrlen_state; + _mbstate_t _mbrtowc_state; + _mbstate_t _mbsrtowcs_state; + _mbstate_t _wcrtomb_state; + _mbstate_t _wcsrtombs_state; + int _h_errno; + } _reent; + /* Two next two fields were once used by malloc. They are no longer + used. They are used to preserve the space used before so as to + allow addition of new reent fields and keep binary compatibility. */ + struct + { +#define _N_LISTS 30 + unsigned char * _nextf[_N_LISTS]; + unsigned int _nmalloc[_N_LISTS]; + } _unused; + } _new; + +# ifndef _REENT_GLOBAL_ATEXIT + /* atexit stuff */ + struct _atexit *_atexit; /* points to head of LIFO stack */ + struct _atexit _atexit0; /* one guaranteed table, required by ANSI */ +# endif + + /* signal info */ + void (**(_sig_func))(int); + + /* These are here last so that __FILE can grow without changing the offsets + of the above members (on the off chance that future binary compatibility + would be broken otherwise). */ + struct _glue __sglue; /* root of glue chain */ + __FILE __sf[3]; /* first three file descriptors */ +}; + +#define _REENT_INIT(var) \ + { 0, \ + &(var).__sf[0], \ + &(var).__sf[1], \ + &(var).__sf[2], \ + 0, \ + "", \ + 0, \ + "C", \ + 0, \ + _NULL, \ + _NULL, \ + 0, \ + _NULL, \ + _NULL, \ + 0, \ + _NULL, \ + { \ + { \ + 0, \ + _NULL, \ + "", \ + {0, 0, 0, 0, 0, 0, 0, 0, 0}, \ + 0, \ + 1, \ + { \ + {_RAND48_SEED_0, _RAND48_SEED_1, _RAND48_SEED_2}, \ + {_RAND48_MULT_0, _RAND48_MULT_1, _RAND48_MULT_2}, \ + _RAND48_ADD \ + }, \ + {0, {0}}, \ + {0, {0}}, \ + {0, {0}}, \ + "", \ + "", \ + 0, \ + {0, {0}}, \ + {0, {0}}, \ + {0, {0}}, \ + {0, {0}}, \ + {0, {0}} \ + } \ + }, \ + _REENT_INIT_ATEXIT \ + _NULL, \ + {_NULL, 0, _NULL} \ + } + +#define _REENT_INIT_PTR(var) \ + { memset((var), 0, sizeof(*(var))); \ + (var)->_stdin = &(var)->__sf[0]; \ + (var)->_stdout = &(var)->__sf[1]; \ + (var)->_stderr = &(var)->__sf[2]; \ + (var)->_current_locale = "C"; \ + (var)->_new._reent._rand_next = 1; \ + (var)->_new._reent._r48._seed[0] = _RAND48_SEED_0; \ + (var)->_new._reent._r48._seed[1] = _RAND48_SEED_1; \ + (var)->_new._reent._r48._seed[2] = _RAND48_SEED_2; \ + (var)->_new._reent._r48._mult[0] = _RAND48_MULT_0; \ + (var)->_new._reent._r48._mult[1] = _RAND48_MULT_1; \ + (var)->_new._reent._r48._mult[2] = _RAND48_MULT_2; \ + (var)->_new._reent._r48._add = _RAND48_ADD; \ + } + +#define _REENT_CHECK_RAND48(ptr) /* nothing */ +#define _REENT_CHECK_MP(ptr) /* nothing */ +#define _REENT_CHECK_TM(ptr) /* nothing */ +#define _REENT_CHECK_ASCTIME_BUF(ptr) /* nothing */ +#define _REENT_CHECK_EMERGENCY(ptr) /* nothing */ +#define _REENT_CHECK_MISC(ptr) /* nothing */ +#define _REENT_CHECK_SIGNAL_BUF(ptr) /* nothing */ + +#define _REENT_SIGNGAM(ptr) ((ptr)->_new._reent._gamma_signgam) +#define _REENT_RAND_NEXT(ptr) ((ptr)->_new._reent._rand_next) +#define _REENT_RAND48_SEED(ptr) ((ptr)->_new._reent._r48._seed) +#define _REENT_RAND48_MULT(ptr) ((ptr)->_new._reent._r48._mult) +#define _REENT_RAND48_ADD(ptr) ((ptr)->_new._reent._r48._add) +#define _REENT_MP_RESULT(ptr) ((ptr)->_result) +#define _REENT_MP_RESULT_K(ptr) ((ptr)->_result_k) +#define _REENT_MP_P5S(ptr) ((ptr)->_p5s) +#define _REENT_MP_FREELIST(ptr) ((ptr)->_freelist) +#define _REENT_ASCTIME_BUF(ptr) ((ptr)->_new._reent._asctime_buf) +#define _REENT_TM(ptr) (&(ptr)->_new._reent._localtime_buf) +#define _REENT_EMERGENCY(ptr) ((ptr)->_emergency) +#define _REENT_STRTOK_LAST(ptr) ((ptr)->_new._reent._strtok_last) +#define _REENT_MBLEN_STATE(ptr) ((ptr)->_new._reent._mblen_state) +#define _REENT_MBTOWC_STATE(ptr)((ptr)->_new._reent._mbtowc_state) +#define _REENT_WCTOMB_STATE(ptr)((ptr)->_new._reent._wctomb_state) +#define _REENT_MBRLEN_STATE(ptr)((ptr)->_new._reent._mbrlen_state) +#define _REENT_MBRTOWC_STATE(ptr)((ptr)->_new._reent._mbrtowc_state) +#define _REENT_MBSRTOWCS_STATE(ptr)((ptr)->_new._reent._mbsrtowcs_state) +#define _REENT_WCRTOMB_STATE(ptr)((ptr)->_new._reent._wcrtomb_state) +#define _REENT_WCSRTOMBS_STATE(ptr)((ptr)->_new._reent._wcsrtombs_state) +#define _REENT_L64A_BUF(ptr) ((ptr)->_new._reent._l64a_buf) +#define _REENT_SIGNAL_BUF(ptr) ((ptr)->_new._reent._signal_buf) +#define _REENT_GETDATE_ERR_P(ptr) (&((ptr)->_new._reent._getdate_err)) + +#endif /* !_REENT_SMALL */ + +/* This value is used in stdlib/misc.c. reent/reent.c has to know it + as well to make sure the freelist is correctly free'd. Therefore + we define it here, rather than in stdlib/misc.c, as before. */ +#define _Kmax (sizeof (size_t) << 3) + +/* + * All references to struct _reent are via this pointer. + * Internally, newlib routines that need to reference it should use _REENT. + */ + +#ifndef __ATTRIBUTE_IMPURE_PTR__ +#define __ATTRIBUTE_IMPURE_PTR__ +#endif + +#if !defined(__DYNAMIC_REENT__) || defined(__SINGLE_THREAD__) +extern struct _reent *_impure_ptr __ATTRIBUTE_IMPURE_PTR__; +#endif + +extern struct _reent *_global_impure_ptr __ATTRIBUTE_IMPURE_PTR__; + +void _reclaim_reent _PARAMS ((struct _reent *)); + +/* #define _REENT_ONLY define this to get only reentrant routines */ + +#if defined(__DYNAMIC_REENT__) && !defined(__SINGLE_THREAD__) +#ifndef __getreent + struct _reent * _EXFUN(__getreent, (void)); +#endif +# define _REENT (__getreent()) +#else /* __SINGLE_THREAD__ || !__DYNAMIC_REENT__ */ +# define _REENT _impure_ptr +#endif /* __SINGLE_THREAD__ || !__DYNAMIC_REENT__ */ + +#define _GLOBAL_REENT _global_impure_ptr + +#ifdef _REENT_GLOBAL_ATEXIT +extern struct _atexit *_global_atexit; /* points to head of LIFO stack */ +# define _GLOBAL_ATEXIT _global_atexit +#else +# define _GLOBAL_ATEXIT (_GLOBAL_REENT->_atexit) +#endif + +#ifdef __cplusplus +} +#endif +#endif /* _SYS_REENT_H_ */ diff --git a/components/newlib/include/sys/resource.h b/components/newlib/include/sys/resource.h new file mode 100644 index 000000000..c35ac2a46 --- /dev/null +++ b/components/newlib/include/sys/resource.h @@ -0,0 +1,17 @@ +#ifndef _SYS_RESOURCE_H_ +#define _SYS_RESOURCE_H_ + +#include + +#define RUSAGE_SELF 0 /* calling process */ +#define RUSAGE_CHILDREN -1 /* terminated child processes */ + +struct rusage { + struct timeval ru_utime; /* user time used */ + struct timeval ru_stime; /* system time used */ +}; + +int _EXFUN(getrusage, (int, struct rusage*)); + +#endif + diff --git a/components/newlib/include/sys/sched.h b/components/newlib/include/sys/sched.h new file mode 100644 index 000000000..58f99d682 --- /dev/null +++ b/components/newlib/include/sys/sched.h @@ -0,0 +1,67 @@ +/* + * Written by Joel Sherrill . + * + * COPYRIGHT (c) 1989-2010. + * On-Line Applications Research Corporation (OAR). + * + * Permission to use, copy, modify, and distribute this software for any + * purpose without fee is hereby granted, provided that this entire notice + * is included in all copies of any software which is or includes a copy + * or modification of this software. + * + * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED + * WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION + * OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS + * SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. + * + * $Id$ + */ + + +#ifndef _SYS_SCHED_H_ +#define _SYS_SCHED_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Scheduling Policies */ +/* Open Group Specifications Issue 6 */ +#if defined(__CYGWIN__) +#define SCHED_OTHER 3 +#else +#define SCHED_OTHER 0 +#endif + +#define SCHED_FIFO 1 +#define SCHED_RR 2 + +#if defined(_POSIX_SPORADIC_SERVER) +#define SCHED_SPORADIC 4 +#endif + +/* Scheduling Parameters */ +/* Open Group Specifications Issue 6 */ + +struct sched_param { + int sched_priority; /* Process execution scheduling priority */ + +#if defined(_POSIX_SPORADIC_SERVER) || defined(_POSIX_THREAD_SPORADIC_SERVER) + int sched_ss_low_priority; /* Low scheduling priority for sporadic */ + /* server */ + struct timespec sched_ss_repl_period; + /* Replenishment period for sporadic server */ + struct timespec sched_ss_init_budget; + /* Initial budget for sporadic server */ + int sched_ss_max_repl; /* Maximum pending replenishments for */ + /* sporadic server */ +#endif +}; + +#ifdef __cplusplus +} +#endif + +#endif +/* end of include file */ + diff --git a/components/newlib/include/sys/signal.h b/components/newlib/include/sys/signal.h new file mode 100644 index 000000000..a29f525c1 --- /dev/null +++ b/components/newlib/include/sys/signal.h @@ -0,0 +1,357 @@ +/* sys/signal.h */ + +#ifndef _SYS_SIGNAL_H +#define _SYS_SIGNAL_H +#ifdef __cplusplus +extern "C" { +#endif + +#include "_ansi.h" +#include +#include + +/* #ifndef __STRICT_ANSI__*/ + +/* Cygwin defines it's own sigset_t in include/cygwin/signal.h */ +#ifndef __CYGWIN__ +typedef unsigned long sigset_t; +#endif + +#if defined(__rtems__) + +#if defined(_POSIX_REALTIME_SIGNALS) + +/* sigev_notify values + NOTE: P1003.1c/D10, p. 34 adds SIGEV_THREAD. */ + +#define SIGEV_NONE 1 /* No asynchronous notification shall be delivered */ + /* when the event of interest occurs. */ +#define SIGEV_SIGNAL 2 /* A queued signal, with an application defined */ + /* value, shall be delivered when the event of */ + /* interest occurs. */ +#define SIGEV_THREAD 3 /* A notification function shall be called to */ + /* perform notification. */ + +/* Signal Generation and Delivery, P1003.1b-1993, p. 63 + NOTE: P1003.1c/D10, p. 34 adds sigev_notify_function and + sigev_notify_attributes to the sigevent structure. */ + +union sigval { + int sival_int; /* Integer signal value */ + void *sival_ptr; /* Pointer signal value */ +}; + +struct sigevent { + int sigev_notify; /* Notification type */ + int sigev_signo; /* Signal number */ + union sigval sigev_value; /* Signal value */ + +#if defined(_POSIX_THREADS) + void (*sigev_notify_function)( union sigval ); + /* Notification function */ + pthread_attr_t *sigev_notify_attributes; /* Notification Attributes */ +#endif +}; + +/* Signal Actions, P1003.1b-1993, p. 64 */ +/* si_code values, p. 66 */ + +#define SI_USER 1 /* Sent by a user. kill(), abort(), etc */ +#define SI_QUEUE 2 /* Sent by sigqueue() */ +#define SI_TIMER 3 /* Sent by expiration of a timer_settime() timer */ +#define SI_ASYNCIO 4 /* Indicates completion of asycnhronous IO */ +#define SI_MESGQ 5 /* Indicates arrival of a message at an empty queue */ + +typedef struct { + int si_signo; /* Signal number */ + int si_code; /* Cause of the signal */ + union sigval si_value; /* Signal value */ +} siginfo_t; +#endif + +/* 3.3.8 Synchronously Accept a Signal, P1003.1b-1993, p. 76 */ + +#define SA_NOCLDSTOP 0x1 /* Do not generate SIGCHLD when children stop */ +#define SA_SIGINFO 0x2 /* Invoke the signal catching function with */ + /* three arguments instead of one. */ +#if __BSD_VISIBLE || __XSI_VISIBLE || __POSIX_VISIBLE >= 200112 +#define SA_ONSTACK 0x4 /* Signal delivery will be on a separate stack. */ +#endif + +/* struct sigaction notes from POSIX: + * + * (1) Routines stored in sa_handler should take a single int as + * their argument although the POSIX standard does not require this. + * This is not longer true since at least POSIX.1-2008 + * (2) The fields sa_handler and sa_sigaction may overlap, and a conforming + * application should not use both simultaneously. + */ + +typedef void (*_sig_func_ptr)(int); + +struct sigaction { + int sa_flags; /* Special flags to affect behavior of signal */ + sigset_t sa_mask; /* Additional set of signals to be blocked */ + /* during execution of signal-catching */ + /* function. */ + union { + _sig_func_ptr _handler; /* SIG_DFL, SIG_IGN, or pointer to a function */ +#if defined(_POSIX_REALTIME_SIGNALS) + void (*_sigaction)( int, siginfo_t *, void * ); +#endif + } _signal_handlers; +}; + +#define sa_handler _signal_handlers._handler +#if defined(_POSIX_REALTIME_SIGNALS) +#define sa_sigaction _signal_handlers._sigaction +#endif + +#if __BSD_VISIBLE || __XSI_VISIBLE || __POSIX_VISIBLE >= 200112 +/* + * Minimum and default signal stack constants. Allow for target overrides + * from . + */ +#ifndef MINSIGSTKSZ +#define MINSIGSTKSZ 2048 +#endif +#ifndef SIGSTKSZ +#define SIGSTKSZ 8192 +#endif + +/* + * Possible values for ss_flags in stack_t below. + */ +#define SS_ONSTACK 0x1 +#define SS_DISABLE 0x2 + +/* + * Structure used in sigaltstack call. + */ +typedef struct sigaltstack { + void *ss_sp; /* Stack base or pointer. */ + int ss_flags; /* Flags. */ + size_t ss_size; /* Stack size. */ +} stack_t; +#endif + +#elif defined(__CYGWIN__) +#include +#else +#define SA_NOCLDSTOP 1 /* only value supported now for sa_flags */ + +typedef void (*_sig_func_ptr)(int); + +struct sigaction +{ + _sig_func_ptr sa_handler; + sigset_t sa_mask; + int sa_flags; +}; +#endif /* defined(__rtems__) */ + +#define SIG_SETMASK 0 /* set mask with sigprocmask() */ +#define SIG_BLOCK 1 /* set of signals to block */ +#define SIG_UNBLOCK 2 /* set of signals to, well, unblock */ + +/* These depend upon the type of sigset_t, which right now + is always a long.. They're in the POSIX namespace, but + are not ANSI. */ +#define sigaddset(what,sig) (*(what) |= (1<<(sig)), 0) +#define sigdelset(what,sig) (*(what) &= ~(1<<(sig)), 0) +#define sigemptyset(what) (*(what) = 0, 0) +#define sigfillset(what) (*(what) = ~(0), 0) +#define sigismember(what,sig) (((*(what)) & (1<<(sig))) != 0) + +int _EXFUN(sigprocmask, (int how, const sigset_t *set, sigset_t *oset)); + +#if defined(_POSIX_THREADS) +int _EXFUN(pthread_sigmask, (int how, const sigset_t *set, sigset_t *oset)); +#endif + +#if defined(__CYGWIN__) || defined(__rtems__) +#undef sigaddset +#undef sigdelset +#undef sigemptyset +#undef sigfillset +#undef sigismember + +#ifdef _COMPILING_NEWLIB +int _EXFUN(_kill, (pid_t, int)); +#endif /* _COMPILING_NEWLIB */ +#endif /* __CYGWIN__ || __rtems__ */ +#if defined(__CYGWIN__) || defined(__rtems__) || defined(__SPU__) +int _EXFUN(kill, (pid_t, int)); +#endif /* __CYGWIN__ || __rtems__ || __SPU__ */ +#if defined(__CYGWIN__) || defined(__rtems__) +int _EXFUN(killpg, (pid_t, int)); +int _EXFUN(sigaction, (int, const struct sigaction *, struct sigaction *)); +int _EXFUN(sigaddset, (sigset_t *, const int)); +int _EXFUN(sigdelset, (sigset_t *, const int)); +int _EXFUN(sigismember, (const sigset_t *, int)); +int _EXFUN(sigfillset, (sigset_t *)); +int _EXFUN(sigemptyset, (sigset_t *)); +int _EXFUN(sigpending, (sigset_t *)); +int _EXFUN(sigsuspend, (const sigset_t *)); +int _EXFUN(sigpause, (int)); + +#ifdef __rtems__ +#if __BSD_VISIBLE || __XSI_VISIBLE || __POSIX_VISIBLE >= 200112 +int _EXFUN(sigaltstack, (const stack_t *__restrict, stack_t *__restrict)); +#endif +#endif + +#if defined(_POSIX_THREADS) +#ifdef __CYGWIN__ +# ifndef _CYGWIN_TYPES_H +# error You need the winsup sources or a cygwin installation to compile the cygwin version of newlib. +# endif +#endif +int _EXFUN(pthread_kill, (pthread_t thread, int sig)); +#endif + +#if defined(_POSIX_REALTIME_SIGNALS) + +/* 3.3.8 Synchronously Accept a Signal, P1003.1b-1993, p. 76 + NOTE: P1003.1c/D10, p. 39 adds sigwait(). */ + +int _EXFUN(sigwaitinfo, (const sigset_t *set, siginfo_t *info)); +int _EXFUN(sigtimedwait, + (const sigset_t *set, siginfo_t *info, const struct timespec *timeout) +); +int _EXFUN(sigwait, (const sigset_t *set, int *sig)); + +/* 3.3.9 Queue a Signal to a Process, P1003.1b-1993, p. 78 */ +int _EXFUN(sigqueue, (pid_t pid, int signo, const union sigval value)); + +#endif /* defined(_POSIX_REALTIME_SIGNALS) */ + +#endif /* defined(__CYGWIN__) || defined(__rtems__) */ + +/* #endif __STRICT_ANSI__ */ + +#if defined(___AM29K__) +/* These all need to be defined for ANSI C, but I don't think they are + meaningful. */ +#define SIGABRT 1 +#define SIGFPE 1 +#define SIGILL 1 +#define SIGINT 1 +#define SIGSEGV 1 +#define SIGTERM 1 +/* These need to be defined for POSIX, and some others do too. */ +#define SIGHUP 1 +#define SIGQUIT 1 +#define NSIG 2 +#elif defined(__GO32__) +#define SIGINT 1 +#define SIGKILL 2 +#define SIGPIPE 3 +#define SIGFPE 4 +#define SIGHUP 5 +#define SIGTERM 6 +#define SIGSEGV 7 +#define SIGTSTP 8 +#define SIGQUIT 9 +#define SIGTRAP 10 +#define SIGILL 11 +#define SIGEMT 12 +#define SIGALRM 13 +#define SIGBUS 14 +#define SIGLOST 15 +#define SIGSTOP 16 +#define SIGABRT 17 +#define SIGUSR1 18 +#define SIGUSR2 19 +#define NSIG 20 +#elif !defined(SIGTRAP) +#define SIGHUP 1 /* hangup */ +#define SIGINT 2 /* interrupt */ +#define SIGQUIT 3 /* quit */ +#define SIGILL 4 /* illegal instruction (not reset when caught) */ +#define SIGTRAP 5 /* trace trap (not reset when caught) */ +#define SIGIOT 6 /* IOT instruction */ +#define SIGABRT 6 /* used by abort, replace SIGIOT in the future */ +#define SIGEMT 7 /* EMT instruction */ +#define SIGFPE 8 /* floating point exception */ +#define SIGKILL 9 /* kill (cannot be caught or ignored) */ +#define SIGBUS 10 /* bus error */ +#define SIGSEGV 11 /* segmentation violation */ +#define SIGSYS 12 /* bad argument to system call */ +#define SIGPIPE 13 /* write on a pipe with no one to read it */ +#define SIGALRM 14 /* alarm clock */ +#define SIGTERM 15 /* software termination signal from kill */ + +#if defined(__rtems__) +#define SIGURG 16 /* urgent condition on IO channel */ +#define SIGSTOP 17 /* sendable stop signal not from tty */ +#define SIGTSTP 18 /* stop signal from tty */ +#define SIGCONT 19 /* continue a stopped process */ +#define SIGCHLD 20 /* to parent on child stop or exit */ +#define SIGCLD 20 /* System V name for SIGCHLD */ +#define SIGTTIN 21 /* to readers pgrp upon background tty read */ +#define SIGTTOU 22 /* like TTIN for output if (tp->t_local<OSTOP) */ +#define SIGIO 23 /* input/output possible signal */ +#define SIGPOLL SIGIO /* System V name for SIGIO */ +#define SIGWINCH 24 /* window changed */ +#define SIGUSR1 25 /* user defined signal 1 */ +#define SIGUSR2 26 /* user defined signal 2 */ + +/* Real-Time Signals Range, P1003.1b-1993, p. 61 + NOTE: By P1003.1b-1993, this should be at least RTSIG_MAX + (which is a minimum of 8) signals. + */ +#define SIGRTMIN 27 +#define SIGRTMAX 31 +#define __SIGFIRSTNOTRT SIGHUP +#define __SIGLASTNOTRT SIGUSR2 + +#define NSIG 32 /* signal 0 implied */ + +#elif defined(__svr4__) +/* svr4 specifics. different signals above 15, and sigaction. */ +#define SIGUSR1 16 +#define SIGUSR2 17 +#define SIGCLD 18 +#define SIGPWR 19 +#define SIGWINCH 20 +#define SIGPOLL 22 /* 20 for x.out binaries!!!! */ +#define SIGSTOP 23 /* sendable stop signal not from tty */ +#define SIGTSTP 24 /* stop signal from tty */ +#define SIGCONT 25 /* continue a stopped process */ +#define SIGTTIN 26 /* to readers pgrp upon background tty read */ +#define SIGTTOU 27 /* like TTIN for output if (tp->t_local<OSTOP) */ +#define NSIG 28 +#else +#define SIGURG 16 /* urgent condition on IO channel */ +#define SIGSTOP 17 /* sendable stop signal not from tty */ +#define SIGTSTP 18 /* stop signal from tty */ +#define SIGCONT 19 /* continue a stopped process */ +#define SIGCHLD 20 /* to parent on child stop or exit */ +#define SIGCLD 20 /* System V name for SIGCHLD */ +#define SIGTTIN 21 /* to readers pgrp upon background tty read */ +#define SIGTTOU 22 /* like TTIN for output if (tp->t_local<OSTOP) */ +#define SIGIO 23 /* input/output possible signal */ +#define SIGPOLL SIGIO /* System V name for SIGIO */ +#define SIGXCPU 24 /* exceeded CPU time limit */ +#define SIGXFSZ 25 /* exceeded file size limit */ +#define SIGVTALRM 26 /* virtual time alarm */ +#define SIGPROF 27 /* profiling time alarm */ +#define SIGWINCH 28 /* window changed */ +#define SIGLOST 29 /* resource lost (eg, record-lock lost) */ +#define SIGUSR1 30 /* user defined signal 1 */ +#define SIGUSR2 31 /* user defined signal 2 */ +#define NSIG 32 /* signal 0 implied */ +#endif +#endif + +#ifdef __cplusplus +} +#endif + +#ifndef _SIGNAL_H_ +/* Some applications take advantage of the fact that + * and are equivalent in glibc. Allow for that here. */ +#include +#endif +#endif /* _SYS_SIGNAL_H */ diff --git a/components/newlib/include/sys/stat.h b/components/newlib/include/sys/stat.h new file mode 100644 index 000000000..11b9d8080 --- /dev/null +++ b/components/newlib/include/sys/stat.h @@ -0,0 +1,192 @@ +#ifndef _SYS_STAT_H +#define _SYS_STAT_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include <_ansi.h> +#include +#include +#include + +/* dj's stat defines _STAT_H_ */ +#ifndef _STAT_H_ + +/* It is intended that the layout of this structure not change when the + sizes of any of the basic types change (short, int, long) [via a compile + time option]. */ + +#ifdef __CYGWIN__ +#include +#ifdef _COMPILING_NEWLIB +#define stat64 stat +#endif +#else +struct stat +{ + dev_t st_dev; + ino_t st_ino; + mode_t st_mode; + nlink_t st_nlink; + uid_t st_uid; + gid_t st_gid; + dev_t st_rdev; + off_t st_size; +#if defined(__rtems__) + struct timespec st_atim; + struct timespec st_mtim; + struct timespec st_ctim; + blksize_t st_blksize; + blkcnt_t st_blocks; +#else + /* SysV/sco doesn't have the rest... But Solaris, eabi does. */ +#if defined(__svr4__) && !defined(__PPC__) && !defined(__sun__) + time_t st_atime; + time_t st_mtime; + time_t st_ctime; +#else + time_t st_atime; + long st_spare1; + time_t st_mtime; + long st_spare2; + time_t st_ctime; + long st_spare3; + long st_blksize; + long st_blocks; + long st_spare4[2]; +#endif +#endif +}; + +#if defined(__rtems__) +#define st_atime st_atim.tv_sec +#define st_ctime st_ctim.tv_sec +#define st_mtime st_mtim.tv_sec +#endif + +#endif + +#define _IFMT 0170000 /* type of file */ +#define _IFDIR 0040000 /* directory */ +#define _IFCHR 0020000 /* character special */ +#define _IFBLK 0060000 /* block special */ +#define _IFREG 0100000 /* regular */ +#define _IFLNK 0120000 /* symbolic link */ +#define _IFSOCK 0140000 /* socket */ +#define _IFIFO 0010000 /* fifo */ + +#define S_BLKSIZE 1024 /* size of a block */ + +#define S_ISUID 0004000 /* set user id on execution */ +#define S_ISGID 0002000 /* set group id on execution */ +#define S_ISVTX 0001000 /* save swapped text even after use */ +#ifndef _POSIX_SOURCE +#define S_IREAD 0000400 /* read permission, owner */ +#define S_IWRITE 0000200 /* write permission, owner */ +#define S_IEXEC 0000100 /* execute/search permission, owner */ +#define S_ENFMT 0002000 /* enforcement-mode locking */ +#endif /* !_POSIX_SOURCE */ + +#define S_IFMT _IFMT +#define S_IFDIR _IFDIR +#define S_IFCHR _IFCHR +#define S_IFBLK _IFBLK +#define S_IFREG _IFREG +#define S_IFLNK _IFLNK +#define S_IFSOCK _IFSOCK +#define S_IFIFO _IFIFO + +#ifdef _WIN32 +/* The Windows header files define _S_ forms of these, so we do too + for easier portability. */ +#define _S_IFMT _IFMT +#define _S_IFDIR _IFDIR +#define _S_IFCHR _IFCHR +#define _S_IFIFO _IFIFO +#define _S_IFREG _IFREG +#define _S_IREAD 0000400 +#define _S_IWRITE 0000200 +#define _S_IEXEC 0000100 +#endif + +#define S_IRWXU (S_IRUSR | S_IWUSR | S_IXUSR) +#define S_IRUSR 0000400 /* read permission, owner */ +#define S_IWUSR 0000200 /* write permission, owner */ +#define S_IXUSR 0000100/* execute/search permission, owner */ +#define S_IRWXG (S_IRGRP | S_IWGRP | S_IXGRP) +#define S_IRGRP 0000040 /* read permission, group */ +#define S_IWGRP 0000020 /* write permission, grougroup */ +#define S_IXGRP 0000010/* execute/search permission, group */ +#define S_IRWXO (S_IROTH | S_IWOTH | S_IXOTH) +#define S_IROTH 0000004 /* read permission, other */ +#define S_IWOTH 0000002 /* write permission, other */ +#define S_IXOTH 0000001/* execute/search permission, other */ + +#ifndef _POSIX_SOURCE +#define ACCESSPERMS (S_IRWXU | S_IRWXG | S_IRWXO) /* 0777 */ +#define ALLPERMS (S_ISUID | S_ISGID | S_ISVTX | S_IRWXU | S_IRWXG | S_IRWXO) /* 07777 */ +#define DEFFILEMODE (S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH) /* 0666 */ +#endif + +#define S_ISBLK(m) (((m)&_IFMT) == _IFBLK) +#define S_ISCHR(m) (((m)&_IFMT) == _IFCHR) +#define S_ISDIR(m) (((m)&_IFMT) == _IFDIR) +#define S_ISFIFO(m) (((m)&_IFMT) == _IFIFO) +#define S_ISREG(m) (((m)&_IFMT) == _IFREG) +#define S_ISLNK(m) (((m)&_IFMT) == _IFLNK) +#define S_ISSOCK(m) (((m)&_IFMT) == _IFSOCK) + +#if defined(__CYGWIN__) +/* Special tv_nsec values for futimens(2) and utimensat(2). */ +#define UTIME_NOW -2L +#define UTIME_OMIT -1L +#endif + +int _EXFUN(chmod,( const char *__path, mode_t __mode )); +int _EXFUN(fchmod,(int __fd, mode_t __mode)); +int _EXFUN(fstat,( int __fd, struct stat *__sbuf )); +int _EXFUN(mkdir,( const char *_path, mode_t __mode )); +int _EXFUN(mkfifo,( const char *__path, mode_t __mode )); +int _EXFUN(stat,( const char *__restrict __path, struct stat *__restrict __sbuf )); +mode_t _EXFUN(umask,( mode_t __mask )); + +#if defined (__SPU__) || defined(__rtems__) || defined(__CYGWIN__) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(lstat,( const char *__restrict __path, struct stat *__restrict __buf )); +int _EXFUN(mknod,( const char *__path, mode_t __mode, dev_t __dev )); +#endif + +#if (__POSIX_VISIBLE >= 200809 || defined (__CYGWIN__)) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(fchmodat, (int, const char *, mode_t, int)); +#endif +#if (__BSD_VISIBLE || __POSIX_VISIBLE >= 200809 || defined (__CYGWIN__)) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(fstatat, (int, const char *__restrict , struct stat *__restrict, int)); +int _EXFUN(mkdirat, (int, const char *, mode_t)); +int _EXFUN(mkfifoat, (int, const char *, mode_t)); +#endif +#if (__BSD_VISIBLE || __XSI_VISIBLE >= 700 || defined (__CYGWIN__)) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(mknodat, (int, const char *, mode_t, dev_t)); +#endif +#if (__BSD_VISIBLE || __POSIX_VISIBLE >= 200809 || defined (__CYGWIN__)) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(utimensat, (int, const char *, const struct timespec *, int)); +int _EXFUN(futimens, (int, const struct timespec *)); +#endif + +/* Provide prototypes for most of the _ names that are + provided in newlib for some compilers. */ +#ifdef _COMPILING_NEWLIB +int _EXFUN(_fstat,( int __fd, struct stat *__sbuf )); +int _EXFUN(_stat,( const char *__restrict __path, struct stat *__restrict __sbuf )); +int _EXFUN(_mkdir,( const char *_path, mode_t __mode )); +#ifdef __LARGE64_FILES +struct stat64; +int _EXFUN(_stat64,( const char *__restrict __path, struct stat64 *__restrict __sbuf )); +int _EXFUN(_fstat64,( int __fd, struct stat64 *__sbuf )); +#endif +#endif + +#endif /* !_STAT_H_ */ +#ifdef __cplusplus +} +#endif +#endif /* _SYS_STAT_H */ diff --git a/components/newlib/include/sys/stdio.h b/components/newlib/include/sys/stdio.h new file mode 100644 index 000000000..0918fe157 --- /dev/null +++ b/components/newlib/include/sys/stdio.h @@ -0,0 +1,27 @@ +#ifndef _NEWLIB_STDIO_H +#define _NEWLIB_STDIO_H + +#include +#include + +/* Internal locking macros, used to protect stdio functions. In the + general case, expand to nothing. Use __SSTR flag in FILE _flags to + detect if FILE is private to sprintf/sscanf class of functions; if + set then do nothing as lock is not initialised. */ +#if !defined(_flockfile) +#ifndef __SINGLE_THREAD__ +# define _flockfile(fp) (((fp)->_flags & __SSTR) ? 0 : __lock_acquire_recursive((fp)->_lock)) +#else +# define _flockfile(fp) (_CAST_VOID 0) +#endif +#endif + +#if !defined(_funlockfile) +#ifndef __SINGLE_THREAD__ +# define _funlockfile(fp) (((fp)->_flags & __SSTR) ? 0 : __lock_release_recursive((fp)->_lock)) +#else +# define _funlockfile(fp) (_CAST_VOID 0) +#endif +#endif + +#endif /* _NEWLIB_STDIO_H */ diff --git a/components/newlib/include/sys/string.h b/components/newlib/include/sys/string.h new file mode 100644 index 000000000..ceedf4be1 --- /dev/null +++ b/components/newlib/include/sys/string.h @@ -0,0 +1,2 @@ +/* This is a dummy used as a placeholder for + systems that need to have a special header file. */ diff --git a/components/newlib/include/sys/syslimits.h b/components/newlib/include/sys/syslimits.h new file mode 100644 index 000000000..ba9dbd667 --- /dev/null +++ b/components/newlib/include/sys/syslimits.h @@ -0,0 +1,65 @@ +/* + * Copyright (c) 1988, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * @(#)syslimits.h 8.1 (Berkeley) 6/2/93 + * $FreeBSD: src/sys/sys/syslimits.h,v 1.10 2001/06/18 20:24:54 wollman Exp $ + */ + +#ifndef _SYS_SYSLIMITS_H_ +#define _SYS_SYSLIMITS_H_ + +#define ARG_MAX 65536 /* max bytes for an exec function */ +#ifndef CHILD_MAX +#define CHILD_MAX 40 /* max simultaneous processes */ +#endif +#define LINK_MAX 32767 /* max file link count */ +#define MAX_CANON 255 /* max bytes in term canon input line */ +#define MAX_INPUT 255 /* max bytes in terminal input */ +#define NAME_MAX 255 /* max bytes in a file name */ +#define NGROUPS_MAX 16 /* max supplemental group id's */ +#ifndef OPEN_MAX +#define OPEN_MAX 64 /* max open files per process */ +#endif +#define PATH_MAX 1024 /* max bytes in pathname */ +#define PIPE_BUF 512 /* max bytes for atomic pipe writes */ +#define IOV_MAX 1024 /* max elements in i/o vector */ + +#define BC_BASE_MAX 99 /* max ibase/obase values in bc(1) */ +#define BC_DIM_MAX 2048 /* max array elements in bc(1) */ +#define BC_SCALE_MAX 99 /* max scale value in bc(1) */ +#define BC_STRING_MAX 1000 /* max const string length in bc(1) */ +#define COLL_WEIGHTS_MAX 0 /* max weights for order keyword */ +#define EXPR_NEST_MAX 32 /* max expressions nested in expr(1) */ +#define LINE_MAX 2048 /* max bytes in an input line */ +#define RE_DUP_MAX 255 /* max RE's in interval notation */ + +#endif diff --git a/components/newlib/include/sys/time.h b/components/newlib/include/sys/time.h new file mode 100644 index 000000000..be16497fc --- /dev/null +++ b/components/newlib/include/sys/time.h @@ -0,0 +1,91 @@ +/* time.h -- An implementation of the standard Unix file. + Written by Geoffrey Noer + Public domain; no rights reserved. */ + +#ifndef _SYS_TIME_H_ +#define _SYS_TIME_H_ + +#include <_ansi.h> +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef _TIMEVAL_DEFINED +#define _TIMEVAL_DEFINED +struct timeval { + time_t tv_sec; + suseconds_t tv_usec; +}; + +/* BSD time macros used by RTEMS code */ +#if defined (__rtems__) || defined (__CYGWIN__) + +/* Convenience macros for operations on timevals. + NOTE: `timercmp' does not work for >= or <=. */ +#define timerisset(tvp) ((tvp)->tv_sec || (tvp)->tv_usec) +#define timerclear(tvp) ((tvp)->tv_sec = (tvp)->tv_usec = 0) +#define timercmp(a, b, CMP) \ + (((a)->tv_sec == (b)->tv_sec) ? \ + ((a)->tv_usec CMP (b)->tv_usec) : \ + ((a)->tv_sec CMP (b)->tv_sec)) +#define timeradd(a, b, result) \ + do { \ + (result)->tv_sec = (a)->tv_sec + (b)->tv_sec; \ + (result)->tv_usec = (a)->tv_usec + (b)->tv_usec; \ + if ((result)->tv_usec >= 1000000) \ + { \ + ++(result)->tv_sec; \ + (result)->tv_usec -= 1000000; \ + } \ + } while (0) +#define timersub(a, b, result) \ + do { \ + (result)->tv_sec = (a)->tv_sec - (b)->tv_sec; \ + (result)->tv_usec = (a)->tv_usec - (b)->tv_usec; \ + if ((result)->tv_usec < 0) { \ + --(result)->tv_sec; \ + (result)->tv_usec += 1000000; \ + } \ + } while (0) +#endif /* defined (__rtems__) || defined (__CYGWIN__) */ +#endif /* !_TIMEVAL_DEFINED */ + +struct timezone { + int tz_minuteswest; + int tz_dsttime; +}; + +#ifdef __CYGWIN__ +#include +#endif /* __CYGWIN__ */ + +#define ITIMER_REAL 0 +#define ITIMER_VIRTUAL 1 +#define ITIMER_PROF 2 + +struct itimerval { + struct timeval it_interval; + struct timeval it_value; +}; + +#ifdef _COMPILING_NEWLIB +int _EXFUN(_gettimeofday, (struct timeval *__p, void *__tz)); +#endif + +int _EXFUN(gettimeofday, (struct timeval *__restrict __p, + void *__restrict __tz)); +#if __BSD_VISIBLE +int _EXFUN(settimeofday, (const struct timeval *, const struct timezone *)); +int _EXFUN(adjtime, (const struct timeval *, struct timeval *)); +#endif +int _EXFUN(utimes, (const char *__path, const struct timeval *__tvp)); +int _EXFUN(getitimer, (int __which, struct itimerval *__value)); +int _EXFUN(setitimer, (int __which, const struct itimerval *__restrict __value, + struct itimerval *__restrict __ovalue)); + +#ifdef __cplusplus +} +#endif +#endif /* _SYS_TIME_H_ */ diff --git a/components/newlib/include/sys/timeb.h b/components/newlib/include/sys/timeb.h new file mode 100644 index 000000000..0a2c3de8b --- /dev/null +++ b/components/newlib/include/sys/timeb.h @@ -0,0 +1,39 @@ +/* timeb.h -- An implementation of the standard Unix file. + Written by Ian Lance Taylor + Public domain; no rights reserved. + + declares the structure used by the ftime function, as + well as the ftime function itself. Newlib does not provide an + implementation of ftime. */ + +#ifndef _SYS_TIMEB_H + +#ifdef __cplusplus +extern "C" { +#endif + +#define _SYS_TIMEB_H + +#include <_ansi.h> +#include + +#ifndef __time_t_defined +typedef _TIME_T_ time_t; +#define __time_t_defined +#endif + +struct timeb +{ + time_t time; + unsigned short millitm; + short timezone; + short dstflag; +}; + +extern int ftime _PARAMS ((struct timeb *)); + +#ifdef __cplusplus +} +#endif + +#endif /* ! defined (_SYS_TIMEB_H) */ diff --git a/components/newlib/include/sys/times.h b/components/newlib/include/sys/times.h new file mode 100644 index 000000000..927812cb8 --- /dev/null +++ b/components/newlib/include/sys/times.h @@ -0,0 +1,31 @@ +#ifndef _SYS_TIMES_H +#ifdef __cplusplus +extern "C" { +#endif +#define _SYS_TIMES_H + +#include <_ansi.h> +#include + +#ifndef __clock_t_defined +typedef _CLOCK_T_ clock_t; +#define __clock_t_defined +#endif + +/* Get Process Times, P1003.1b-1993, p. 92 */ +struct tms { + clock_t tms_utime; /* user time */ + clock_t tms_stime; /* system time */ + clock_t tms_cutime; /* user time, children */ + clock_t tms_cstime; /* system time, children */ +}; + +clock_t _EXFUN(times,(struct tms *)); +#ifdef _COMPILING_NEWLIB +clock_t _EXFUN(_times,(struct tms *)); +#endif + +#ifdef __cplusplus +} +#endif +#endif /* !_SYS_TIMES_H */ diff --git a/components/newlib/include/sys/types.h b/components/newlib/include/sys/types.h new file mode 100644 index 000000000..ed33e0a61 --- /dev/null +++ b/components/newlib/include/sys/types.h @@ -0,0 +1,521 @@ +/* unified sys/types.h: + start with sef's sysvi386 version. + merge go32 version -- a few ifdefs. + h8300hms, h8300xray, and sysvnecv70 disagree on the following types: + + typedef int gid_t; + typedef int uid_t; + typedef int dev_t; + typedef int ino_t; + typedef int mode_t; + typedef int caddr_t; + + however, these aren't "reasonable" values, the sysvi386 ones make far + more sense, and should work sufficiently well (in particular, h8300 + doesn't have a stat, and the necv70 doesn't matter.) -- eichin + */ + +#ifndef _SYS_TYPES_H + +#include <_ansi.h> + +#ifndef __INTTYPES_DEFINED__ +#define __INTTYPES_DEFINED__ + +#include + +#if defined(__rtems__) || defined(__XMK__) +/* + * The following section is RTEMS specific and is needed to more + * closely match the types defined in the BSD sys/types.h. + * This is needed to let the RTEMS/BSD TCP/IP stack compile. + */ + +/* deprecated */ +#if ___int8_t_defined +typedef __uint8_t u_int8_t; +#endif +#if ___int16_t_defined +typedef __uint16_t u_int16_t; +#endif +#if ___int32_t_defined +typedef __uint32_t u_int32_t; +#endif + +#if ___int64_t_defined +typedef __uint64_t u_int64_t; + +/* deprecated */ +typedef __uint64_t u_quad_t; +typedef __int64_t quad_t; +typedef quad_t * qaddr_t; +#endif + +#endif + +#endif /* ! __INTTYPES_DEFINED */ + +#ifndef __need_inttypes + +#define _SYS_TYPES_H +#include + +#ifdef __i386__ +#if defined (GO32) || defined (__MSDOS__) +#define __MS_types__ +#endif +#endif + +# include +# include + +/* To ensure the stat struct's layout doesn't change when sizeof(int), etc. + changes, we assume sizeof short and long never change and have all types + used to define struct stat use them and not int where possible. + Where not possible, _ST_INTxx are used. It would be preferable to not have + such assumptions, but until the extra fluff is necessary, it's avoided. + No 64 bit targets use stat yet. What to do about them is postponed + until necessary. */ +#ifdef __GNUC__ +#define _ST_INT32 __attribute__ ((__mode__ (__SI__))) +#else +#define _ST_INT32 +#endif + +# ifndef _POSIX_SOURCE + +# define physadr physadr_t +# define quad quad_t + +#ifndef _BSDTYPES_DEFINED +/* also defined in mingw/gmon.h and in w32api/winsock[2].h */ +#ifndef __u_char_defined +typedef unsigned char u_char; +#define __u_char_defined +#endif +#ifndef __u_short_defined +typedef unsigned short u_short; +#define __u_short_defined +#endif +#ifndef __u_int_defined +typedef unsigned int u_int; +#define __u_int_defined +#endif +#ifndef __u_long_defined +typedef unsigned long u_long; +#define __u_long_defined +#endif +#define _BSDTYPES_DEFINED +#endif + +typedef unsigned short ushort; /* System V compatibility */ +typedef unsigned int uint; /* System V compatibility */ +typedef unsigned long ulong; /* System V compatibility */ +# endif /*!_POSIX_SOURCE */ + +#ifndef __clock_t_defined +typedef _CLOCK_T_ clock_t; +#define __clock_t_defined +#endif + +#ifndef __time_t_defined +typedef _TIME_T_ time_t; +#define __time_t_defined +#endif + +#ifndef __timespec_defined +#define __timespec_defined +/* Time Value Specification Structures, P1003.1b-1993, p. 261 */ + +struct timespec { + time_t tv_sec; /* Seconds */ + long tv_nsec; /* Nanoseconds */ +}; +#endif + +struct itimerspec { + struct timespec it_interval; /* Timer period */ + struct timespec it_value; /* Timer expiration */ +}; + +#ifndef __daddr_t_defined +typedef long daddr_t; +#define __daddr_t_defined +#endif +#ifndef __caddr_t_defined +typedef char * caddr_t; +#define __caddr_t_defined +#endif + +#ifndef __CYGWIN__ +#if defined(__MS_types__) || defined(__rtems__) || \ + defined(__sparc__) || defined(__SPU__) +typedef unsigned long ino_t; +#else +typedef unsigned short ino_t; +#endif +#endif /*__CYGWIN__*/ + +#ifdef __MS_types__ +typedef unsigned long vm_offset_t; +typedef unsigned long vm_size_t; + +#define __BIT_TYPES_DEFINED__ + +typedef signed char int8_t; +typedef unsigned char u_int8_t; +typedef short int16_t; +typedef unsigned short u_int16_t; +typedef int int32_t; +typedef unsigned int u_int32_t; +typedef long long int64_t; +typedef unsigned long long u_int64_t; +typedef int32_t register_t; +#endif /* __MS_types__ */ + +/* + * All these should be machine specific - right now they are all broken. + * However, for all of Cygnus' embedded targets, we want them to all be + * the same. Otherwise things like sizeof (struct stat) might depend on + * how the file was compiled (e.g. -mint16 vs -mint32, etc.). + */ + +#ifndef __CYGWIN__ /* which defines these types in it's own types.h. */ +typedef _off_t off_t; +typedef __dev_t dev_t; +typedef __uid_t uid_t; +typedef __gid_t gid_t; +#endif + +#if defined(__XMK__) +typedef signed char pid_t; +#else +typedef int pid_t; +#endif + +#if defined(__rtems__) +typedef _mode_t mode_t; +#endif + +#ifndef __CYGWIN__ +typedef long key_t; +#endif +typedef _ssize_t ssize_t; + +#if !defined(__CYGWIN__) && !defined(__rtems__) +#ifdef __MS_types__ +typedef char * addr_t; +typedef int mode_t; +#else +#if defined (__sparc__) && !defined (__sparc_v9__) +#ifdef __svr4__ +typedef unsigned long mode_t; +#else +typedef unsigned short mode_t; +#endif +#else +typedef unsigned int mode_t _ST_INT32; +#endif +#endif /* ! __MS_types__ */ +#endif /*__CYGWIN__*/ + +typedef unsigned short nlink_t; + +/* We don't define fd_set and friends if we are compiling POSIX + source, or if we have included (or may include as indicated + by __USE_W32_SOCKETS) the W32api winsock[2].h header which + defines Windows versions of them. Note that a program which + includes the W32api winsock[2].h header must know what it is doing; + it must not call the cygwin32 select function. +*/ +# if !(defined (_POSIX_SOURCE) || defined (_WINSOCK_H) || defined (_WINSOCKAPI_) || defined (__USE_W32_SOCKETS)) +# define _SYS_TYPES_FD_SET +# define NBBY 8 /* number of bits in a byte */ +/* + * Select uses bit masks of file descriptors in longs. + * These macros manipulate such bit fields (the filesystem macros use chars). + * FD_SETSIZE may be defined by the user, but the default here + * should be >= NOFILE (param.h). + */ +# ifndef FD_SETSIZE +# define FD_SETSIZE 64 +# endif + +typedef long fd_mask; +# define NFDBITS (sizeof (fd_mask) * NBBY) /* bits per mask */ +# ifndef howmany +# define howmany(x,y) (((x)+((y)-1))/(y)) +# endif + +/* We use a macro for fd_set so that including Sockets.h afterwards + can work. */ +typedef struct _types_fd_set { + fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)]; +} _types_fd_set; + +#define fd_set _types_fd_set + +# define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= (1L << ((n) % NFDBITS))) +# define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~(1L << ((n) % NFDBITS))) +# define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & (1L << ((n) % NFDBITS))) +# define FD_ZERO(p) (__extension__ (void)({ \ + size_t __i; \ + char *__tmp = (char *)p; \ + for (__i = 0; __i < sizeof (*(p)); ++__i) \ + *__tmp++ = 0; \ +})) + +# endif /* !(defined (_POSIX_SOURCE) || defined (_WINSOCK_H) || defined (_WINSOCKAPI_) || defined (__USE_W32_SOCKETS)) */ + +#undef __MS_types__ +#undef _ST_INT32 + + +#ifndef __clockid_t_defined +typedef _CLOCKID_T_ clockid_t; +#define __clockid_t_defined +#endif + +#ifndef __timer_t_defined +typedef _TIMER_T_ timer_t; +#define __timer_t_defined +#endif + +typedef unsigned long useconds_t; +typedef long suseconds_t; + +#include + + +/* Cygwin will probably never have full posix compliance due to little things + * like an inability to set the stackaddress. Cygwin is also using void * + * pointers rather than structs to ensure maximum binary compatability with + * previous releases. + * This means that we don't use the types defined here, but rather in + * + */ +#if defined(_POSIX_THREADS) && !defined(__CYGWIN__) + +#include + +/* + * 2.5 Primitive System Data Types, P1003.1c/D10, p. 19. + */ + +#if defined(__XMK__) +typedef unsigned int pthread_t; /* identify a thread */ +#else +typedef __uint32_t pthread_t; /* identify a thread */ +#endif + +/* P1003.1c/D10, p. 118-119 */ +#define PTHREAD_SCOPE_PROCESS 0 +#define PTHREAD_SCOPE_SYSTEM 1 + +/* P1003.1c/D10, p. 111 */ +#define PTHREAD_INHERIT_SCHED 1 /* scheduling policy and associated */ + /* attributes are inherited from */ + /* the calling thread. */ +#define PTHREAD_EXPLICIT_SCHED 2 /* set from provided attribute object */ + +/* P1003.1c/D10, p. 141 */ +#define PTHREAD_CREATE_DETACHED 0 +#define PTHREAD_CREATE_JOINABLE 1 + +#if defined(__rtems__) + #include +#endif + +#if defined(__XMK__) +typedef struct pthread_attr_s { + int contentionscope; + struct sched_param schedparam; + int detachstate; + void *stackaddr; + size_t stacksize; +} pthread_attr_t; + +#define PTHREAD_STACK_MIN 200 + +#else /* !defined(__XMK__) */ +typedef struct { + int is_initialized; + void *stackaddr; + int stacksize; + int contentionscope; + int inheritsched; + int schedpolicy; + struct sched_param schedparam; +#if defined(__rtems__) + size_t guardsize; +#endif + + /* P1003.4b/D8, p. 54 adds cputime_clock_allowed attribute. */ +#if defined(_POSIX_THREAD_CPUTIME) + int cputime_clock_allowed; /* see time.h */ +#endif + int detachstate; +#if defined(__rtems__) + size_t affinitysetsize; + cpu_set_t *affinityset; + cpu_set_t affinitysetpreallocated; +#endif +} pthread_attr_t; + +#endif /* !defined(__XMK__) */ + +#if defined(_POSIX_THREAD_PROCESS_SHARED) +/* NOTE: P1003.1c/D10, p. 81 defines following values for process_shared. */ + +#define PTHREAD_PROCESS_PRIVATE 0 /* visible within only the creating process */ +#define PTHREAD_PROCESS_SHARED 1 /* visible too all processes with access to */ + /* the memory where the resource is */ + /* located */ +#endif + +#if defined(_POSIX_THREAD_PRIO_PROTECT) +/* Mutexes */ + +/* Values for blocking protocol. */ + +#define PTHREAD_PRIO_NONE 0 +#define PTHREAD_PRIO_INHERIT 1 +#define PTHREAD_PRIO_PROTECT 2 +#endif + +#if defined(_UNIX98_THREAD_MUTEX_ATTRIBUTES) + +/* Values for mutex type */ + +/* The following defines are part of the X/Open System Interface (XSI). */ + +/* + * This type of mutex does not detect deadlock. A thread attempting to + * relock this mutex without first unlocking it shall deadlock. Attempting + * to unlock a mutex locked by a different thread results in undefined + * behavior. Attempting to unlock an unlocked mutex results in undefined + * behavior. + */ +#define PTHREAD_MUTEX_NORMAL 0 + +/* + * A thread attempting to relock this mutex without first unlocking + * it shall succeed in locking the mutex. The relocking deadlock which + * can occur with mutexes of type PTHREAD_MUTEX_NORMAL cannot occur with + * this type of mutex. Multiple locks of this mutex shall require the + * same number of unlocks to release the mutex before another thread can + * acquire the mutex. A thread attempting to unlock a mutex which another + * thread has locked shall return with an error. A thread attempting to + * unlock an unlocked mutex shall return with an error. + */ +#define PTHREAD_MUTEX_RECURSIVE 1 + +/* + * This type of mutex provides error checking. A thread attempting + * to relock this mutex without first unlocking it shall return with an + * error. A thread attempting to unlock a mutex which another thread has + * locked shall return with an error. A thread attempting to unlock an + * unlocked mutex shall return with an error. + */ +#define PTHREAD_MUTEX_ERRORCHECK 2 + +/* + * Attempting to recursively lock a mutex of this type results + * in undefined behavior. Attempting to unlock a mutex of this type + * which was not locked by the calling thread results in undefined + * behavior. Attempting to unlock a mutex of this type which is not locked + * results in undefined behavior. An implementation may map this mutex to + * one of the other mutex types. + */ +#define PTHREAD_MUTEX_DEFAULT 3 + +#endif /* !defined(_UNIX98_THREAD_MUTEX_ATTRIBUTES) */ + +#if defined(__XMK__) +typedef unsigned int pthread_mutex_t; /* identify a mutex */ + +typedef struct { + int type; +} pthread_mutexattr_t; + +#else /* !defined(__XMK__) */ +typedef __uint32_t pthread_mutex_t; /* identify a mutex */ + +typedef struct { + int is_initialized; +#if defined(_POSIX_THREAD_PROCESS_SHARED) + int process_shared; /* allow mutex to be shared amongst processes */ +#endif +#if defined(_POSIX_THREAD_PRIO_PROTECT) + int prio_ceiling; + int protocol; +#endif +#if defined(_UNIX98_THREAD_MUTEX_ATTRIBUTES) + int type; +#endif + int recursive; +} pthread_mutexattr_t; +#endif /* !defined(__XMK__) */ + +/* Condition Variables */ + +typedef __uint32_t pthread_cond_t; /* identify a condition variable */ + +typedef struct { + int is_initialized; +#if defined(_POSIX_THREAD_PROCESS_SHARED) + int process_shared; /* allow this to be shared amongst processes */ +#endif +} pthread_condattr_t; /* a condition attribute object */ + +/* Keys */ + +typedef __uint32_t pthread_key_t; /* thread-specific data keys */ + +typedef struct { + int is_initialized; /* is this structure initialized? */ + int init_executed; /* has the initialization routine been run? */ +} pthread_once_t; /* dynamic package initialization */ +#else +#if defined (__CYGWIN__) +#include +#endif +#endif /* defined(_POSIX_THREADS) */ + +/* POSIX Barrier Types */ + +#if defined(_POSIX_BARRIERS) +typedef __uint32_t pthread_barrier_t; /* POSIX Barrier Object */ +typedef struct { + int is_initialized; /* is this structure initialized? */ +#if defined(_POSIX_THREAD_PROCESS_SHARED) + int process_shared; /* allow this to be shared amongst processes */ +#endif +} pthread_barrierattr_t; +#endif /* defined(_POSIX_BARRIERS) */ + +/* POSIX Spin Lock Types */ + +#if !defined (__CYGWIN__) +#if defined(_POSIX_SPIN_LOCKS) +typedef __uint32_t pthread_spinlock_t; /* POSIX Spin Lock Object */ +#endif /* defined(_POSIX_SPIN_LOCKS) */ + +/* POSIX Reader/Writer Lock Types */ + +#if defined(_POSIX_READER_WRITER_LOCKS) +typedef __uint32_t pthread_rwlock_t; /* POSIX RWLock Object */ +typedef struct { + int is_initialized; /* is this structure initialized? */ +#if defined(_POSIX_THREAD_PROCESS_SHARED) + int process_shared; /* allow this to be shared amongst processes */ +#endif +} pthread_rwlockattr_t; +#endif /* defined(_POSIX_READER_WRITER_LOCKS) */ +#endif /* __CYGWIN__ */ + +#endif /* !__need_inttypes */ + +#undef __need_inttypes + +#endif /* _SYS_TYPES_H */ diff --git a/components/newlib/include/sys/unistd.h b/components/newlib/include/sys/unistd.h new file mode 100644 index 000000000..a741383d0 --- /dev/null +++ b/components/newlib/include/sys/unistd.h @@ -0,0 +1,516 @@ +#ifndef _SYS_UNISTD_H +#define _SYS_UNISTD_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include <_ansi.h> +#define __need_size_t +#define __need_ptrdiff_t +#include +#include +#include +#include + +extern char **environ; + +void _EXFUN(_exit, (int __status ) _ATTRIBUTE ((__noreturn__))); + +int _EXFUN(access,(const char *__path, int __amode )); +unsigned _EXFUN(alarm, (unsigned __secs )); +int _EXFUN(chdir, (const char *__path )); +int _EXFUN(chmod, (const char *__path, mode_t __mode )); +#if !defined(__INSIDE_CYGWIN__) +int _EXFUN(chown, (const char *__path, uid_t __owner, gid_t __group )); +#endif +#if defined(__CYGWIN__) || defined(__rtems__) +int _EXFUN(chroot, (const char *__path )); +#endif +int _EXFUN(close, (int __fildes )); +#if defined(__CYGWIN__) +size_t _EXFUN(confstr, (int __name, char *__buf, size_t __len)); +#endif +char * _EXFUN(ctermid, (char *__s )); +char * _EXFUN(cuserid, (char *__s )); +#if defined(__CYGWIN__) +int _EXFUN(daemon, (int nochdir, int noclose)); +#endif +int _EXFUN(dup, (int __fildes )); +int _EXFUN(dup2, (int __fildes, int __fildes2 )); +#if defined(__CYGWIN__) +int _EXFUN(dup3, (int __fildes, int __fildes2, int flags)); +int _EXFUN(eaccess, (const char *__path, int __mode)); +void _EXFUN(endusershell, (void)); +int _EXFUN(euidaccess, (const char *__path, int __mode)); +#endif +int _EXFUN(execl, (const char *__path, const char *, ... )); +int _EXFUN(execle, (const char *__path, const char *, ... )); +int _EXFUN(execlp, (const char *__file, const char *, ... )); +#if defined(__CYGWIN__) +int _EXFUN(execlpe, (const char *__file, const char *, ... )); +#endif +int _EXFUN(execv, (const char *__path, char * const __argv[] )); +int _EXFUN(execve, (const char *__path, char * const __argv[], char * const __envp[] )); +int _EXFUN(execvp, (const char *__file, char * const __argv[] )); +#if defined(__CYGWIN__) +int _EXFUN(execvpe, (const char *__file, char * const __argv[], char * const __envp[] )); +#endif +#if __POSIX_VISIBLE >= 200809 || __BSD_VISIBLE || defined(__CYGWIN__) +int _EXFUN(faccessat, (int __dirfd, const char *__path, int __mode, int __flags)); +#endif +#if defined(__CYGWIN__) || defined(__rtems__) || defined(__SPU__) +int _EXFUN(fchdir, (int __fildes)); +#endif +int _EXFUN(fchmod, (int __fildes, mode_t __mode )); +#if !defined(__INSIDE_CYGWIN__) +int _EXFUN(fchown, (int __fildes, uid_t __owner, gid_t __group )); +#endif +#if __POSIX_VISIBLE >= 200809 || __BSD_VISIBLE || defined(__CYGWIN__) +int _EXFUN(fchownat, (int __dirfd, const char *__path, uid_t __owner, gid_t __group, int __flags)); +#endif +#if defined(__CYGWIN__) +int _EXFUN(fexecve, (int __fd, char * const __argv[], char * const __envp[] )); +#endif +pid_t _EXFUN(fork, (void )); +long _EXFUN(fpathconf, (int __fd, int __name )); +int _EXFUN(fsync, (int __fd)); +int _EXFUN(fdatasync, (int __fd)); +#if defined(__CYGWIN__) +char * _EXFUN(get_current_dir_name, (void)); +#endif +char * _EXFUN(getcwd, (char *__buf, size_t __size )); +#if defined(__CYGWIN__) +int _EXFUN(getdomainname ,(char *__name, size_t __len)); +#endif +#if !defined(__INSIDE_CYGWIN__) +gid_t _EXFUN(getegid, (void )); +uid_t _EXFUN(geteuid, (void )); +gid_t _EXFUN(getgid, (void )); +#endif +int _EXFUN(getgroups, (int __gidsetsize, gid_t __grouplist[] )); +#if defined(__CYGWIN__) +long _EXFUN(gethostid, (void)); +#endif +char * _EXFUN(getlogin, (void )); +#if defined(_POSIX_THREAD_SAFE_FUNCTIONS) +int _EXFUN(getlogin_r, (char *name, size_t namesize) ); +#endif +char * _EXFUN(getpass, (const char *__prompt)); +int _EXFUN(getpagesize, (void)); +#if defined(__CYGWIN__) +int _EXFUN(getpeereid, (int, uid_t *, gid_t *)); +#endif +pid_t _EXFUN(getpgid, (pid_t)); +pid_t _EXFUN(getpgrp, (void )); +pid_t _EXFUN(getpid, (void )); +pid_t _EXFUN(getppid, (void )); +#if defined(__CYGWIN__) || defined(__rtems__) +pid_t _EXFUN(getsid, (pid_t)); +#endif +#if !defined(__INSIDE_CYGWIN__) +uid_t _EXFUN(getuid, (void )); +#endif +#ifdef __CYGWIN__ +char * _EXFUN(getusershell, (void)); +char * _EXFUN(getwd, (char *__buf )); +int _EXFUN(iruserok, (unsigned long raddr, int superuser, const char *ruser, const char *luser)); +#endif +int _EXFUN(isatty, (int __fildes )); +#if !defined(__INSIDE_CYGWIN__) +int _EXFUN(lchown, (const char *__path, uid_t __owner, gid_t __group )); +#endif +int _EXFUN(link, (const char *__path1, const char *__path2 )); +#if __POSIX_VISIBLE >= 200809 || __BSD_VISIBLE || defined(__CYGWIN__) +int _EXFUN(linkat, (int __dirfd1, const char *__path1, int __dirfd2, const char *__path2, int __flags )); +#endif +int _EXFUN(nice, (int __nice_value )); +#if !defined(__INSIDE_CYGWIN__) +off_t _EXFUN(lseek, (int __fildes, off_t __offset, int __whence )); +#endif +#if defined(__SPU__) || defined(__CYGWIN__) +#define F_ULOCK 0 +#define F_LOCK 1 +#define F_TLOCK 2 +#define F_TEST 3 +int _EXFUN(lockf, (int __fd, int __cmd, off_t __len)); +#endif +long _EXFUN(pathconf, (const char *__path, int __name )); +int _EXFUN(pause, (void )); +#ifdef __CYGWIN__ +int _EXFUN(pthread_atfork, (void (*)(void), void (*)(void), void (*)(void))); +#endif +int _EXFUN(pipe, (int __fildes[2] )); +#ifdef __CYGWIN__ +int _EXFUN(pipe2, (int __fildes[2], int flags)); +#endif +ssize_t _EXFUN(pread, (int __fd, void *__buf, size_t __nbytes, off_t __offset)); +ssize_t _EXFUN(pwrite, (int __fd, const void *__buf, size_t __nbytes, off_t __offset)); +_READ_WRITE_RETURN_TYPE _EXFUN(read, (int __fd, void *__buf, size_t __nbyte )); +#if defined(__CYGWIN__) +int _EXFUN(rresvport, (int *__alport)); +int _EXFUN(revoke, (char *__path)); +#endif +int _EXFUN(rmdir, (const char *__path )); +#if defined(__CYGWIN__) +int _EXFUN(ruserok, (const char *rhost, int superuser, const char *ruser, const char *luser)); +#endif +void * _EXFUN(sbrk, (ptrdiff_t __incr)); +#if !defined(__INSIDE_CYGWIN__) +#if defined(__CYGWIN__) || defined(__rtems__) +int _EXFUN(setegid, (gid_t __gid )); +int _EXFUN(seteuid, (uid_t __uid )); +#endif +int _EXFUN(setgid, (gid_t __gid )); +#endif +#if defined(__CYGWIN__) +int _EXFUN(setgroups, (int ngroups, const gid_t *grouplist )); +#endif +#if __BSD_VISIBLE || (defined(_XOPEN_SOURCE) && __XSI_VISIBLE < 500) +int _EXFUN(sethostname, (const char *, size_t)); +#endif +int _EXFUN(setpgid, (pid_t __pid, pid_t __pgid )); +int _EXFUN(setpgrp, (void )); +#if defined(__CYGWIN__) && !defined(__INSIDE_CYGWIN__) +int _EXFUN(setregid, (gid_t __rgid, gid_t __egid)); +int _EXFUN(setreuid, (uid_t __ruid, uid_t __euid)); +#endif +pid_t _EXFUN(setsid, (void )); +#if !defined(__INSIDE_CYGWIN__) +int _EXFUN(setuid, (uid_t __uid )); +#endif +#if defined(__CYGWIN__) +void _EXFUN(setusershell, (void)); +#endif +unsigned _EXFUN(sleep, (unsigned int __seconds )); +void _EXFUN(swab, (const void *__restrict, void *__restrict, ssize_t)); +long _EXFUN(sysconf, (int __name )); +pid_t _EXFUN(tcgetpgrp, (int __fildes )); +int _EXFUN(tcsetpgrp, (int __fildes, pid_t __pgrp_id )); +char * _EXFUN(ttyname, (int __fildes )); +#if defined(__CYGWIN__) || defined(__rtems__) +int _EXFUN(ttyname_r, (int, char *, size_t)); +#endif +int _EXFUN(unlink, (const char *__path )); +int _EXFUN(usleep, (useconds_t __useconds)); +int _EXFUN(vhangup, (void )); +_READ_WRITE_RETURN_TYPE _EXFUN(write, (int __fd, const void *__buf, size_t __nbyte )); + +#ifdef __CYGWIN__ +# define __UNISTD_GETOPT__ +# include +# undef __UNISTD_GETOPT__ +#else +extern char *optarg; /* getopt(3) external variables */ +extern int optind, opterr, optopt; +int getopt(int, char * const [], const char *); +extern int optreset; /* getopt(3) external variable */ +#endif + +#ifndef _POSIX_SOURCE +pid_t _EXFUN(vfork, (void )); +#endif /* _POSIX_SOURCE */ + +#ifdef _COMPILING_NEWLIB +/* Provide prototypes for most of the _ names that are + provided in newlib for some compilers. */ +int _EXFUN(_close, (int __fildes )); +pid_t _EXFUN(_fork, (void )); +pid_t _EXFUN(_getpid, (void )); +int _EXFUN(_isatty, (int __fildes )); +int _EXFUN(_link, (const char *__path1, const char *__path2 )); +_off_t _EXFUN(_lseek, (int __fildes, _off_t __offset, int __whence )); +#ifdef __LARGE64_FILES +_off64_t _EXFUN(_lseek64, (int __filedes, _off64_t __offset, int __whence )); +#endif +_READ_WRITE_RETURN_TYPE _EXFUN(_read, (int __fd, void *__buf, size_t __nbyte )); +void * _EXFUN(_sbrk, (ptrdiff_t __incr)); +int _EXFUN(_unlink, (const char *__path )); +_READ_WRITE_RETURN_TYPE _EXFUN(_write, (int __fd, const void *__buf, size_t __nbyte )); +int _EXFUN(_execve, (const char *__path, char * const __argv[], char * const __envp[] )); +#endif + +#if defined(__CYGWIN__) || defined(__rtems__) || defined(__aarch64__) || defined (__arm__) || defined(__sh__) || defined(__SPU__) +#if !defined(__INSIDE_CYGWIN__) +int _EXFUN(ftruncate, (int __fd, off_t __length)); +int _EXFUN(truncate, (const char *, off_t __length)); +#endif +#endif + +#if defined(__CYGWIN__) || defined(__rtems__) +int _EXFUN(getdtablesize, (void)); +int _EXFUN(setdtablesize, (int)); +useconds_t _EXFUN(ualarm, (useconds_t __useconds, useconds_t __interval)); +#if !(defined (_WINSOCK_H) || defined (_WINSOCKAPI_) || defined (__USE_W32_SOCKETS)) +/* winsock[2].h defines as __stdcall, and with int as 2nd arg */ + int _EXFUN(gethostname, (char *__name, size_t __len)); +#endif +char * _EXFUN(mktemp, (char *)); +#endif + +#if defined(__CYGWIN__) || defined(__SPU__) || defined(__rtems__) +void _EXFUN(sync, (void)); +#endif + +ssize_t _EXFUN(readlink, (const char *__restrict __path, + char *__restrict __buf, size_t __buflen)); +#if __POSIX_VISIBLE >= 200809 || __BSD_VISIBLE || defined(__CYGWIN__) +ssize_t _EXFUN(readlinkat, (int __dirfd1, const char *__restrict __path, + char *__restrict __buf, size_t __buflen)); +#endif +int _EXFUN(symlink, (const char *__name1, const char *__name2)); +#if __POSIX_VISIBLE >= 200809 || __BSD_VISIBLE || defined(__CYGWIN__) +int _EXFUN(symlinkat, (const char *, int, const char *)); +int _EXFUN(unlinkat, (int, const char *, int)); +#endif + +#define F_OK 0 +#define R_OK 4 +#define W_OK 2 +#define X_OK 1 + +# define SEEK_SET 0 +# define SEEK_CUR 1 +# define SEEK_END 2 + +#include + +#define STDIN_FILENO 0 /* standard input file descriptor */ +#define STDOUT_FILENO 1 /* standard output file descriptor */ +#define STDERR_FILENO 2 /* standard error file descriptor */ + +/* + * sysconf values per IEEE Std 1003.1, 2008 Edition + */ + +#define _SC_ARG_MAX 0 +#define _SC_CHILD_MAX 1 +#define _SC_CLK_TCK 2 +#define _SC_NGROUPS_MAX 3 +#define _SC_OPEN_MAX 4 +#define _SC_JOB_CONTROL 5 +#define _SC_SAVED_IDS 6 +#define _SC_VERSION 7 +#define _SC_PAGESIZE 8 +#define _SC_PAGE_SIZE _SC_PAGESIZE +/* These are non-POSIX values we accidentally introduced in 2000 without + guarding them. Keeping them unguarded for backward compatibility. */ +#define _SC_NPROCESSORS_CONF 9 +#define _SC_NPROCESSORS_ONLN 10 +#define _SC_PHYS_PAGES 11 +#define _SC_AVPHYS_PAGES 12 +/* End of non-POSIX values. */ +#define _SC_MQ_OPEN_MAX 13 +#define _SC_MQ_PRIO_MAX 14 +#define _SC_RTSIG_MAX 15 +#define _SC_SEM_NSEMS_MAX 16 +#define _SC_SEM_VALUE_MAX 17 +#define _SC_SIGQUEUE_MAX 18 +#define _SC_TIMER_MAX 19 +#define _SC_TZNAME_MAX 20 +#define _SC_ASYNCHRONOUS_IO 21 +#define _SC_FSYNC 22 +#define _SC_MAPPED_FILES 23 +#define _SC_MEMLOCK 24 +#define _SC_MEMLOCK_RANGE 25 +#define _SC_MEMORY_PROTECTION 26 +#define _SC_MESSAGE_PASSING 27 +#define _SC_PRIORITIZED_IO 28 +#define _SC_REALTIME_SIGNALS 29 +#define _SC_SEMAPHORES 30 +#define _SC_SHARED_MEMORY_OBJECTS 31 +#define _SC_SYNCHRONIZED_IO 32 +#define _SC_TIMERS 33 +#define _SC_AIO_LISTIO_MAX 34 +#define _SC_AIO_MAX 35 +#define _SC_AIO_PRIO_DELTA_MAX 36 +#define _SC_DELAYTIMER_MAX 37 +#define _SC_THREAD_KEYS_MAX 38 +#define _SC_THREAD_STACK_MIN 39 +#define _SC_THREAD_THREADS_MAX 40 +#define _SC_TTY_NAME_MAX 41 +#define _SC_THREADS 42 +#define _SC_THREAD_ATTR_STACKADDR 43 +#define _SC_THREAD_ATTR_STACKSIZE 44 +#define _SC_THREAD_PRIORITY_SCHEDULING 45 +#define _SC_THREAD_PRIO_INHERIT 46 +/* _SC_THREAD_PRIO_PROTECT was _SC_THREAD_PRIO_CEILING in early drafts */ +#define _SC_THREAD_PRIO_PROTECT 47 +#define _SC_THREAD_PRIO_CEILING _SC_THREAD_PRIO_PROTECT +#define _SC_THREAD_PROCESS_SHARED 48 +#define _SC_THREAD_SAFE_FUNCTIONS 49 +#define _SC_GETGR_R_SIZE_MAX 50 +#define _SC_GETPW_R_SIZE_MAX 51 +#define _SC_LOGIN_NAME_MAX 52 +#define _SC_THREAD_DESTRUCTOR_ITERATIONS 53 +#define _SC_ADVISORY_INFO 54 +#define _SC_ATEXIT_MAX 55 +#define _SC_BARRIERS 56 +#define _SC_BC_BASE_MAX 57 +#define _SC_BC_DIM_MAX 58 +#define _SC_BC_SCALE_MAX 59 +#define _SC_BC_STRING_MAX 60 +#define _SC_CLOCK_SELECTION 61 +#define _SC_COLL_WEIGHTS_MAX 62 +#define _SC_CPUTIME 63 +#define _SC_EXPR_NEST_MAX 64 +#define _SC_HOST_NAME_MAX 65 +#define _SC_IOV_MAX 66 +#define _SC_IPV6 67 +#define _SC_LINE_MAX 68 +#define _SC_MONOTONIC_CLOCK 69 +#define _SC_RAW_SOCKETS 70 +#define _SC_READER_WRITER_LOCKS 71 +#define _SC_REGEXP 72 +#define _SC_RE_DUP_MAX 73 +#define _SC_SHELL 74 +#define _SC_SPAWN 75 +#define _SC_SPIN_LOCKS 76 +#define _SC_SPORADIC_SERVER 77 +#define _SC_SS_REPL_MAX 78 +#define _SC_SYMLOOP_MAX 79 +#define _SC_THREAD_CPUTIME 80 +#define _SC_THREAD_SPORADIC_SERVER 81 +#define _SC_TIMEOUTS 82 +#define _SC_TRACE 83 +#define _SC_TRACE_EVENT_FILTER 84 +#define _SC_TRACE_EVENT_NAME_MAX 85 +#define _SC_TRACE_INHERIT 86 +#define _SC_TRACE_LOG 87 +#define _SC_TRACE_NAME_MAX 88 +#define _SC_TRACE_SYS_MAX 89 +#define _SC_TRACE_USER_EVENT_MAX 90 +#define _SC_TYPED_MEMORY_OBJECTS 91 +#define _SC_V7_ILP32_OFF32 92 +#define _SC_V6_ILP32_OFF32 _SC_V7_ILP32_OFF32 +#define _SC_XBS5_ILP32_OFF32 _SC_V7_ILP32_OFF32 +#define _SC_V7_ILP32_OFFBIG 93 +#define _SC_V6_ILP32_OFFBIG _SC_V7_ILP32_OFFBIG +#define _SC_XBS5_ILP32_OFFBIG _SC_V7_ILP32_OFFBIG +#define _SC_V7_LP64_OFF64 94 +#define _SC_V6_LP64_OFF64 _SC_V7_LP64_OFF64 +#define _SC_XBS5_LP64_OFF64 _SC_V7_LP64_OFF64 +#define _SC_V7_LPBIG_OFFBIG 95 +#define _SC_V6_LPBIG_OFFBIG _SC_V7_LPBIG_OFFBIG +#define _SC_XBS5_LPBIG_OFFBIG _SC_V7_LPBIG_OFFBIG +#define _SC_XOPEN_CRYPT 96 +#define _SC_XOPEN_ENH_I18N 97 +#define _SC_XOPEN_LEGACY 98 +#define _SC_XOPEN_REALTIME 99 +#define _SC_STREAM_MAX 100 +#define _SC_PRIORITY_SCHEDULING 101 +#define _SC_XOPEN_REALTIME_THREADS 102 +#define _SC_XOPEN_SHM 103 +#define _SC_XOPEN_STREAMS 104 +#define _SC_XOPEN_UNIX 105 +#define _SC_XOPEN_VERSION 106 +#define _SC_2_CHAR_TERM 107 +#define _SC_2_C_BIND 108 +#define _SC_2_C_DEV 109 +#define _SC_2_FORT_DEV 110 +#define _SC_2_FORT_RUN 111 +#define _SC_2_LOCALEDEF 112 +#define _SC_2_PBS 113 +#define _SC_2_PBS_ACCOUNTING 114 +#define _SC_2_PBS_CHECKPOINT 115 +#define _SC_2_PBS_LOCATE 116 +#define _SC_2_PBS_MESSAGE 117 +#define _SC_2_PBS_TRACK 118 +#define _SC_2_SW_DEV 119 +#define _SC_2_UPE 120 +#define _SC_2_VERSION 121 +#define _SC_THREAD_ROBUST_PRIO_INHERIT 122 +#define _SC_THREAD_ROBUST_PRIO_PROTECT 123 +#define _SC_XOPEN_UUCP 124 + +/* + * pathconf values per IEEE Std 1003.1, 2008 Edition + */ + +#define _PC_LINK_MAX 0 +#define _PC_MAX_CANON 1 +#define _PC_MAX_INPUT 2 +#define _PC_NAME_MAX 3 +#define _PC_PATH_MAX 4 +#define _PC_PIPE_BUF 5 +#define _PC_CHOWN_RESTRICTED 6 +#define _PC_NO_TRUNC 7 +#define _PC_VDISABLE 8 +#define _PC_ASYNC_IO 9 +#define _PC_PRIO_IO 10 +#define _PC_SYNC_IO 11 +#define _PC_FILESIZEBITS 12 +#define _PC_2_SYMLINKS 13 +#define _PC_SYMLINK_MAX 14 +#define _PC_ALLOC_SIZE_MIN 15 +#define _PC_REC_INCR_XFER_SIZE 16 +#define _PC_REC_MAX_XFER_SIZE 17 +#define _PC_REC_MIN_XFER_SIZE 18 +#define _PC_REC_XFER_ALIGN 19 +#define _PC_TIMESTAMP_RESOLUTION 20 +#ifdef __CYGWIN__ +/* Ask for POSIX permission bits support. */ +#define _PC_POSIX_PERMISSIONS 90 +/* Ask for full POSIX permission support including uid/gid settings. */ +#define _PC_POSIX_SECURITY 91 +#endif + +/* + * confstr values per IEEE Std 1003.1, 2004 Edition + */ + +#ifdef __CYGWIN__ /* Only defined on Cygwin for now. */ +#define _CS_PATH 0 +#define _CS_POSIX_V7_ILP32_OFF32_CFLAGS 1 +#define _CS_POSIX_V6_ILP32_OFF32_CFLAGS _CS_POSIX_V7_ILP32_OFF32_CFLAGS +#define _CS_XBS5_ILP32_OFF32_CFLAGS _CS_POSIX_V7_ILP32_OFF32_CFLAGS +#define _CS_POSIX_V7_ILP32_OFF32_LDFLAGS 2 +#define _CS_POSIX_V6_ILP32_OFF32_LDFLAGS _CS_POSIX_V7_ILP32_OFF32_LDFLAGS +#define _CS_XBS5_ILP32_OFF32_LDFLAGS _CS_POSIX_V7_ILP32_OFF32_LDFLAGS +#define _CS_POSIX_V7_ILP32_OFF32_LIBS 3 +#define _CS_POSIX_V6_ILP32_OFF32_LIBS _CS_POSIX_V7_ILP32_OFF32_LIBS +#define _CS_XBS5_ILP32_OFF32_LIBS _CS_POSIX_V7_ILP32_OFF32_LIBS +#define _CS_XBS5_ILP32_OFF32_LINTFLAGS 4 +#define _CS_POSIX_V7_ILP32_OFFBIG_CFLAGS 5 +#define _CS_POSIX_V6_ILP32_OFFBIG_CFLAGS _CS_POSIX_V7_ILP32_OFFBIG_CFLAGS +#define _CS_XBS5_ILP32_OFFBIG_CFLAGS _CS_POSIX_V7_ILP32_OFFBIG_CFLAGS +#define _CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS 6 +#define _CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS _CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS +#define _CS_XBS5_ILP32_OFFBIG_LDFLAGS _CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS +#define _CS_POSIX_V7_ILP32_OFFBIG_LIBS 7 +#define _CS_POSIX_V6_ILP32_OFFBIG_LIBS _CS_POSIX_V7_ILP32_OFFBIG_LIBS +#define _CS_XBS5_ILP32_OFFBIG_LIBS _CS_POSIX_V7_ILP32_OFFBIG_LIBS +#define _CS_XBS5_ILP32_OFFBIG_LINTFLAGS 8 +#define _CS_POSIX_V7_LP64_OFF64_CFLAGS 9 +#define _CS_POSIX_V6_LP64_OFF64_CFLAGS _CS_POSIX_V7_LP64_OFF64_CFLAGS +#define _CS_XBS5_LP64_OFF64_CFLAGS _CS_POSIX_V7_LP64_OFF64_CFLAGS +#define _CS_POSIX_V7_LP64_OFF64_LDFLAGS 10 +#define _CS_POSIX_V6_LP64_OFF64_LDFLAGS _CS_POSIX_V7_LP64_OFF64_LDFLAGS +#define _CS_XBS5_LP64_OFF64_LDFLAGS _CS_POSIX_V7_LP64_OFF64_LDFLAGS +#define _CS_POSIX_V7_LP64_OFF64_LIBS 11 +#define _CS_POSIX_V6_LP64_OFF64_LIBS _CS_POSIX_V7_LP64_OFF64_LIBS +#define _CS_XBS5_LP64_OFF64_LIBS _CS_POSIX_V7_LP64_OFF64_LIBS +#define _CS_XBS5_LP64_OFF64_LINTFLAGS 12 +#define _CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS 13 +#define _CS_POSIX_V6_LPBIG_OFFBIG_CFLAGS _CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS +#define _CS_XBS5_LPBIG_OFFBIG_CFLAGS _CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS +#define _CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS 14 +#define _CS_POSIX_V6_LPBIG_OFFBIG_LDFLAGS _CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS +#define _CS_XBS5_LPBIG_OFFBIG_LDFLAGS _CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS +#define _CS_POSIX_V7_LPBIG_OFFBIG_LIBS 15 +#define _CS_POSIX_V6_LPBIG_OFFBIG_LIBS _CS_POSIX_V7_LPBIG_OFFBIG_LIBS +#define _CS_XBS5_LPBIG_OFFBIG_LIBS _CS_POSIX_V7_LPBIG_OFFBIG_LIBS +#define _CS_XBS5_LPBIG_OFFBIG_LINTFLAGS 16 +#define _CS_POSIX_V7_WIDTH_RESTRICTED_ENVS 17 +#define _CS_POSIX_V6_WIDTH_RESTRICTED_ENVS _CS_POSIX_V7_WIDTH_RESTRICTED_ENVS +#define _CS_XBS5_WIDTH_RESTRICTED_ENVS _CS_POSIX_V7_WIDTH_RESTRICTED_ENVS +#define _CS_POSIX_V7_THREADS_CFLAGS 18 +#define _CS_POSIX_V7_THREADS_LDFLAGS 19 +#define _CS_V7_ENV 20 +#define _CS_V6_ENV _CS_V7_ENV +#endif + +#ifdef __cplusplus +} +#endif +#endif /* _SYS_UNISTD_H */ diff --git a/components/newlib/include/sys/utime.h b/components/newlib/include/sys/utime.h new file mode 100644 index 000000000..5e937f103 --- /dev/null +++ b/components/newlib/include/sys/utime.h @@ -0,0 +1,22 @@ +#ifndef _SYS_UTIME_H +#define _SYS_UTIME_H + +/* This is a dummy file, not customized for any + particular system. If there is a utime.h in libc/sys/SYSDIR/sys, + it will override this one. */ + +#ifdef __cplusplus +extern "C" { +#endif + +struct utimbuf +{ + time_t actime; + time_t modtime; +}; + +#ifdef __cplusplus +}; +#endif + +#endif /* _SYS_UTIME_H */ diff --git a/components/newlib/include/sys/wait.h b/components/newlib/include/sys/wait.h new file mode 100644 index 000000000..73fe37202 --- /dev/null +++ b/components/newlib/include/sys/wait.h @@ -0,0 +1,44 @@ +#ifndef _SYS_WAIT_H +#define _SYS_WAIT_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +#define WNOHANG 1 +#define WUNTRACED 2 + +/* A status looks like: + <2 bytes info> <2 bytes code> + + == 0, child has exited, info is the exit value + == 1..7e, child has exited, info is the signal number. + == 7f, child has stopped, info was the signal number. + == 80, there was a core dump. +*/ + +#define WIFEXITED(w) (((w) & 0xff) == 0) +#define WIFSIGNALED(w) (((w) & 0x7f) > 0 && (((w) & 0x7f) < 0x7f)) +#define WIFSTOPPED(w) (((w) & 0xff) == 0x7f) +#define WEXITSTATUS(w) (((w) >> 8) & 0xff) +#define WTERMSIG(w) ((w) & 0x7f) +#define WSTOPSIG WEXITSTATUS + +pid_t wait (int *); +pid_t waitpid (pid_t, int *, int); + +#ifdef _COMPILING_NEWLIB +pid_t _wait (int *); +#endif + +/* Provide prototypes for most of the _ names that are + provided in newlib for some compilers. */ +pid_t _wait (int *); + +#ifdef __cplusplus +}; +#endif + +#endif diff --git a/components/newlib/include/tar.h b/components/newlib/include/tar.h new file mode 100644 index 000000000..07b06dd7f --- /dev/null +++ b/components/newlib/include/tar.h @@ -0,0 +1,39 @@ +/* + * tar.h + */ + +#ifndef _TAR_H +#define _TAR_H + +/* General definitions */ +#define TMAGIC "ustar" /* ustar plus null byte. */ +#define TMAGLEN 6 /* Length of the above. */ +#define TVERSION "00" /* 00 without a null byte. */ +#define TVERSLEN 2 /* Length of the above. */ + +/* Typeflag field definitions */ +#define REGTYPE '0' /* Regular file. */ +#define AREGTYPE '\0' /* Regular file. */ +#define LNKTYPE '1' /* Link. */ +#define SYMTYPE '2' /* Symbolic link. */ +#define CHRTYPE '3' /* Character special. */ +#define BLKTYPE '4' /* Block special. */ +#define DIRTYPE '5' /* Directory. */ +#define FIFOTYPE '6' /* FIFO special. */ +#define CONTTYPE '7' /* Reserved. */ + +/* Mode field bit definitions (octal) */ +#define TSUID 04000 /* Set UID on execution. */ +#define TSGID 02000 /* Set GID on execution. */ +#define TSVTX 01000 /* On directories, restricted deletion flag. */ +#define TUREAD 00400 /* Read by owner. */ +#define TUWRITE 00200 /* Write by owner. */ +#define TUEXEC 00100 /* Execute/search by owner. */ +#define TGREAD 00040 /* Read by group. */ +#define TGWRITE 00020 /* Write by group. */ +#define TGEXEC 00010 /* Execute/search by group. */ +#define TOREAD 00004 /* Read by other. */ +#define TOWRITE 00002 /* Write by other. */ +#define TOEXEC 00001 /* Execute/search by other. */ + +#endif diff --git a/components/newlib/include/termios.h b/components/newlib/include/termios.h new file mode 100644 index 000000000..ee1820ce0 --- /dev/null +++ b/components/newlib/include/termios.h @@ -0,0 +1,7 @@ +#ifdef __cplusplus +extern "C" { +#endif +#include +#ifdef __cplusplus +} +#endif diff --git a/components/newlib/include/tgmath.h b/components/newlib/include/tgmath.h new file mode 100644 index 000000000..f9c8311cc --- /dev/null +++ b/components/newlib/include/tgmath.h @@ -0,0 +1,184 @@ +/* http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/tgmath.h.html */ +/*- + * Copyright (c) 2004 Stefan Farfeleder. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _TGMATH_H_ +#define _TGMATH_H_ + +#include +#include + +#ifdef log2 +#undef log2 +#endif + +/* + * This implementation of requires two implementation-dependent + * macros to be defined: + * __tg_impl_simple(x, y, z, fn, fnf, fnl, ...) + * Invokes fnl() if the corresponding real type of x, y or z is long + * double, fn() if it is double or any has an integer type, and fnf() + * otherwise. + * __tg_impl_full(x, y, z, fn, fnf, fnl, cfn, cfnf, cfnl, ...) + * Invokes [c]fnl() if the corresponding real type of x, y or z is long + * double, [c]fn() if it is double or any has an integer type, and + * [c]fnf() otherwise. The function with the 'c' prefix is called if + * any of x, y or z is a complex number. + * Both macros call the chosen function with all additional arguments passed + * to them, as given by __VA_ARGS__. + * + * Note that these macros cannot be implemented with C's ?: operator, + * because the return type of the whole expression would incorrectly be long + * double complex regardless of the argument types. + */ + +/* requires GCC >= 3.1 */ +#if !__GNUC_PREREQ (3, 1) +#error " not implemented for this compiler" +#endif + +#define __tg_type(__e, __t) \ + __builtin_types_compatible_p(__typeof__(__e), __t) +#define __tg_type3(__e1, __e2, __e3, __t) \ + (__tg_type(__e1, __t) || __tg_type(__e2, __t) || \ + __tg_type(__e3, __t)) +#define __tg_type_corr(__e1, __e2, __e3, __t) \ + (__tg_type3(__e1, __e2, __e3, __t) || \ + __tg_type3(__e1, __e2, __e3, __t _Complex)) +#define __tg_integer(__e1, __e2, __e3) \ + (((__typeof__(__e1))1.5 == 1) || ((__typeof__(__e2))1.5 == 1) || \ + ((__typeof__(__e3))1.5 == 1)) +#define __tg_is_complex(__e1, __e2, __e3) \ + (__tg_type3(__e1, __e2, __e3, float _Complex) || \ + __tg_type3(__e1, __e2, __e3, double _Complex) || \ + __tg_type3(__e1, __e2, __e3, long double _Complex) || \ + __tg_type3(__e1, __e2, __e3, __typeof__(_Complex_I))) + +#ifdef _LDBL_EQ_DBL +#define __tg_impl_simple(x, y, z, fn, fnf, fnl, ...) \ + __builtin_choose_expr(__tg_type_corr(x, y, z, long double), \ + fnl(__VA_ARGS__), __builtin_choose_expr( \ + __tg_type_corr(x, y, z, double) || __tg_integer(x, y, z),\ + fn(__VA_ARGS__), fnf(__VA_ARGS__))) +#else +#define __tg_impl_simple(__x, __y, __z, __fn, __fnf, __fnl, ...) \ + (__tg_type_corr(__x, __y, __z, double) || __tg_integer(__x, __y, __z)) \ + ? __fn(__VA_ARGS__) : __fnf(__VA_ARGS__) +#endif + +#define __tg_impl_full(__x, __y, __z, __fn, __fnf, __fnl, __cfn, __cfnf, __cfnl, ...) \ + __builtin_choose_expr(__tg_is_complex(__x, __y, __z), \ + __tg_impl_simple(__x, __y, __z, __cfn, __cfnf, __cfnl, __VA_ARGS__), \ + __tg_impl_simple(__x, __y, __z, __fn, __fnf, __fnl, __VA_ARGS__)) + +/* Macros to save lots of repetition below */ +#define __tg_simple(__x, __fn) \ + __tg_impl_simple(__x, __x, __x, __fn, __fn##f, __fn##l, __x) +#define __tg_simple2(__x, __y, __fn) \ + __tg_impl_simple(__x, __x, __y, __fn, __fn##f, __fn##l, __x, __y) +#define __tg_simplev(__x, __fn, ...) \ + __tg_impl_simple(__x, __x, __x, __fn, __fn##f, __fn##l, __VA_ARGS__) +#define __tg_full(__x, __fn) \ + __tg_impl_full(__x, __x, __x, __fn, __fn##f, __fn##l, c##__fn, c##__fn##f, c##__fn##l, __x) + +/* 7.22#4 -- These macros expand to real or complex functions, depending on + * the type of their arguments. */ +#define acos(__x) __tg_full(__x, acos) +#define asin(__x) __tg_full(__x, asin) +#define atan(__x) __tg_full(__x, atan) +#define acosh(__x) __tg_full(__x, acosh) +#define asinh(__x) __tg_full(__x, asinh) +#define atanh(__x) __tg_full(__x, atanh) +#define cos(__x) __tg_full(__x, cos) +#define sin(__x) __tg_full(__x, sin) +#define tan(__x) __tg_full(__x, tan) +#define cosh(__x) __tg_full(__x, cosh) +#define sinh(__x) __tg_full(__x, sinh) +#define tanh(__x) __tg_full(__x, tanh) +#define exp(__x) __tg_full(__x, exp) +#define log(__x) __tg_full(__x, log) +#define pow(__x, __y) __tg_impl_full(__x, __x, __y, pow, powf, powl, \ + cpow, cpowf, cpowl, __x, __y) +#define sqrt(__x) __tg_full(__x, sqrt) + +/* "The corresponding type-generic macro for fabs and cabs is fabs." */ +#define fabs(__x) __tg_impl_full(__x, __x, __x, fabs, fabsf, fabsl, \ + cabs, cabsf, cabsl, __x) + +/* 7.22#5 -- These macros are only defined for arguments with real type. */ +#define atan2(__x, __y) __tg_simple2(__x, __y, atan2) +#define cbrt(__x) __tg_simple(__x, cbrt) +#define ceil(__x) __tg_simple(__x, ceil) +#define copysign(__x, __y) __tg_simple2(__x, __y, copysign) +#define erf(__x) __tg_simple(__x, erf) +#define erfc(__x) __tg_simple(__x, erfc) +#define exp2(__x) __tg_simple(__x, exp2) +#define expm1(__x) __tg_simple(__x, expm1) +#define fdim(__x, __y) __tg_simple2(__x, __y, fdim) +#define floor(__x) __tg_simple(__x, floor) +#define fma(__x, __y, __z) __tg_impl_simple(__x, __y, __z, fma, fmaf, fmal, \ + __x, __y, __z) +#define fmax(__x, __y) __tg_simple2(__x, __y, fmax) +#define fmin(__x, __y) __tg_simple2(__x, __y, fmin) +#define fmod(__x, __y) __tg_simple2(__x, __y, fmod) +#define frexp(__x, __y) __tg_simplev(__x, frexp, __x, __y) +#define hypot(__x, __y) __tg_simple2(__x, __y, hypot) +#define ilogb(__x) __tg_simple(__x, ilogb) +#define ldexp(__x, __y) __tg_simplev(__x, ldexp, __x, __y) +#define lgamma(__x) __tg_simple(__x, lgamma) +#define llrint(__x) __tg_simple(__x, llrint) +#define llround(__x) __tg_simple(__x, llround) +#define log10(__x) __tg_simple(__x, log10) +#define log1p(__x) __tg_simple(__x, log1p) +#define log2(__x) __tg_simple(__x, log2) +#define logb(__x) __tg_simple(__x, logb) +#define lrint(__x) __tg_simple(__x, lrint) +#define lround(__x) __tg_simple(__x, lround) +#define nearbyint(__x) __tg_simple(__x, nearbyint) +#define nextafter(__x, __y) __tg_simple2(__x, __y, nextafter) +/* not yet implemented even for _LDBL_EQ_DBL platforms +#define nexttoward(__x, __y) __tg_simplev(__x, nexttoward, __x, __y) +*/ +#define remainder(__x, __y) __tg_simple2(__x, __y, remainder) +#define remquo(__x, __y, __z) __tg_impl_simple(__x, __x, __y, remquo, remquof, \ + remquol, __x, __y, __z) +#define rint(__x) __tg_simple(__x, rint) +#define round(__x) __tg_simple(__x, round) +#define scalbn(__x, __y) __tg_simplev(__x, scalbn, __x, __y) +#define scalbln(__x, __y) __tg_simplev(__x, scalbln, __x, __y) +#define tgamma(__x) __tg_simple(__x, tgamma) +#define trunc(__x) __tg_simple(__x, trunc) + +/* 7.22#6 -- These macros always expand to complex functions. */ +#define carg(__x) __tg_simple(__x, carg) +#define cimag(__x) __tg_simple(__x, cimag) +#define conj(__x) __tg_simple(__x, conj) +#define cproj(__x) __tg_simple(__x, cproj) +#define creal(__x) __tg_simple(__x, creal) + +#endif /* !_TGMATH_H_ */ diff --git a/components/newlib/include/time.h b/components/newlib/include/time.h new file mode 100644 index 000000000..d7b6612db --- /dev/null +++ b/components/newlib/include/time.h @@ -0,0 +1,291 @@ +/* + * time.h + * + * Struct and function declarations for dealing with time. + */ + +#ifndef _TIME_H_ +#define _TIME_H_ + +#include "_ansi.h" +#include + +#define __need_size_t +#define __need_NULL +#include + +/* Get _CLOCKS_PER_SEC_ */ +#include + +#ifndef _CLOCKS_PER_SEC_ +#define _CLOCKS_PER_SEC_ 1000 +#endif + +#define CLOCKS_PER_SEC _CLOCKS_PER_SEC_ +#define CLK_TCK CLOCKS_PER_SEC + +#include + +_BEGIN_STD_C + +struct tm +{ + int tm_sec; + int tm_min; + int tm_hour; + int tm_mday; + int tm_mon; + int tm_year; + int tm_wday; + int tm_yday; + int tm_isdst; +#ifdef __TM_GMTOFF + long __TM_GMTOFF; +#endif +#ifdef __TM_ZONE + const char *__TM_ZONE; +#endif +}; + +clock_t _EXFUN(clock, (void)); +double _EXFUN(difftime, (time_t _time2, time_t _time1)); +time_t _EXFUN(mktime, (struct tm *_timeptr)); +time_t _EXFUN(time, (time_t *_timer)); +#ifndef _REENT_ONLY +char *_EXFUN(asctime, (const struct tm *_tblock)); +char *_EXFUN(ctime, (const time_t *_time)); +struct tm *_EXFUN(gmtime, (const time_t *_timer)); +struct tm *_EXFUN(localtime,(const time_t *_timer)); +#endif +size_t _EXFUN(strftime, (char *__restrict _s, + size_t _maxsize, const char *__restrict _fmt, + const struct tm *__restrict _t)); + +char *_EXFUN(asctime_r, (const struct tm *__restrict, + char *__restrict)); +char *_EXFUN(ctime_r, (const time_t *, char *)); +struct tm *_EXFUN(gmtime_r, (const time_t *__restrict, + struct tm *__restrict)); +struct tm *_EXFUN(localtime_r, (const time_t *__restrict, + struct tm *__restrict)); + +_END_STD_C + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef __STRICT_ANSI__ +char *_EXFUN(strptime, (const char *__restrict, + const char *__restrict, + struct tm *__restrict)); +_VOID _EXFUN(tzset, (_VOID)); +_VOID _EXFUN(_tzset_r, (struct _reent *)); + +typedef struct __tzrule_struct +{ + char ch; + int m; + int n; + int d; + int s; + time_t change; + long offset; /* Match type of _timezone. */ +} __tzrule_type; + +typedef struct __tzinfo_struct +{ + int __tznorth; + int __tzyear; + __tzrule_type __tzrule[2]; +} __tzinfo_type; + +__tzinfo_type *_EXFUN (__gettzinfo, (_VOID)); + +/* getdate functions */ + +#ifdef HAVE_GETDATE +#ifndef _REENT_ONLY +#define getdate_err (*__getdate_err()) +int *_EXFUN(__getdate_err,(_VOID)); + +struct tm * _EXFUN(getdate, (const char *)); +/* getdate_err is set to one of the following values to indicate the error. + 1 the DATEMSK environment variable is null or undefined, + 2 the template file cannot be opened for reading, + 3 failed to get file status information, + 4 the template file is not a regular file, + 5 an error is encountered while reading the template file, + 6 memory allication failed (not enough memory available), + 7 there is no line in the template that matches the input, + 8 invalid input specification */ +#endif /* !_REENT_ONLY */ + +/* getdate_r returns the error code as above */ +int _EXFUN(getdate_r, (const char *, struct tm *)); +#endif /* HAVE_GETDATE */ + +/* defines for the opengroup specifications Derived from Issue 1 of the SVID. */ +extern __IMPORT long _timezone; +extern __IMPORT int _daylight; +extern __IMPORT char *_tzname[2]; + +/* POSIX defines the external tzname being defined in time.h */ +#ifndef tzname +#define tzname _tzname +#endif +#endif /* !__STRICT_ANSI__ */ + +#ifdef __cplusplus +} +#endif + +#include + +#ifdef __CYGWIN__ +#include +#endif /*__CYGWIN__*/ + +#if defined(_POSIX_TIMERS) + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Clocks, P1003.1b-1993, p. 263 */ + +int _EXFUN(clock_settime, (clockid_t clock_id, const struct timespec *tp)); +int _EXFUN(clock_gettime, (clockid_t clock_id, struct timespec *tp)); +int _EXFUN(clock_getres, (clockid_t clock_id, struct timespec *res)); + +/* Create a Per-Process Timer, P1003.1b-1993, p. 264 */ + +int _EXFUN(timer_create, + (clockid_t clock_id, + struct sigevent *__restrict evp, + timer_t *__restrict timerid)); + +/* Delete a Per_process Timer, P1003.1b-1993, p. 266 */ + +int _EXFUN(timer_delete, (timer_t timerid)); + +/* Per-Process Timers, P1003.1b-1993, p. 267 */ + +int _EXFUN(timer_settime, + (timer_t timerid, int flags, + const struct itimerspec *__restrict value, + struct itimerspec *__restrict ovalue)); +int _EXFUN(timer_gettime, (timer_t timerid, struct itimerspec *value)); +int _EXFUN(timer_getoverrun, (timer_t timerid)); + +/* High Resolution Sleep, P1003.1b-1993, p. 269 */ + +int _EXFUN(nanosleep, (const struct timespec *rqtp, struct timespec *rmtp)); + +#ifdef __cplusplus +} +#endif +#endif /* _POSIX_TIMERS */ + +#if defined(_POSIX_CLOCK_SELECTION) + +#ifdef __cplusplus +extern "C" { +#endif + +int _EXFUN(clock_nanosleep, + (clockid_t clock_id, int flags, const struct timespec *rqtp, + struct timespec *rmtp)); + +#ifdef __cplusplus +} +#endif + +#endif /* _POSIX_CLOCK_SELECTION */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* CPU-time Clock Attributes, P1003.4b/D8, p. 54 */ + +/* values for the clock enable attribute */ + +#define CLOCK_ENABLED 1 /* clock is enabled, i.e. counting execution time */ +#define CLOCK_DISABLED 0 /* clock is disabled */ + +/* values for the pthread cputime_clock_allowed attribute */ + +#define CLOCK_ALLOWED 1 /* If a thread is created with this value a */ + /* CPU-time clock attached to that thread */ + /* shall be accessible. */ +#define CLOCK_DISALLOWED 0 /* If a thread is created with this value, the */ + /* thread shall not have a CPU-time clock */ + /* accessible. */ + +/* Manifest Constants, P1003.1b-1993, p. 262 */ + +#define CLOCK_REALTIME (clockid_t)1 + +/* Flag indicating time is "absolute" with respect to the clock + associated with a time. */ + +#define TIMER_ABSTIME 4 + +/* Manifest Constants, P1003.4b/D8, p. 55 */ + +#if defined(_POSIX_CPUTIME) + +/* When used in a clock or timer function call, this is interpreted as + the identifier of the CPU_time clock associated with the PROCESS + making the function call. */ + +#define CLOCK_PROCESS_CPUTIME_ID (clockid_t)2 + +#endif + +#if defined(_POSIX_THREAD_CPUTIME) + +/* When used in a clock or timer function call, this is interpreted as + the identifier of the CPU_time clock associated with the THREAD + making the function call. */ + +#define CLOCK_THREAD_CPUTIME_ID (clockid_t)3 + +#endif + +#if defined(_POSIX_MONOTONIC_CLOCK) + +/* The identifier for the system-wide monotonic clock, which is defined + * as a clock whose value cannot be set via clock_settime() and which + * cannot have backward clock jumps. */ + +#define CLOCK_MONOTONIC (clockid_t)4 + +#endif + +#if defined(_POSIX_CPUTIME) + +/* Accessing a Process CPU-time CLock, P1003.4b/D8, p. 55 */ + +int _EXFUN(clock_getcpuclockid, (pid_t pid, clockid_t *clock_id)); + +#endif /* _POSIX_CPUTIME */ + +#if defined(_POSIX_CPUTIME) || defined(_POSIX_THREAD_CPUTIME) + +/* CPU-time Clock Attribute Access, P1003.4b/D8, p. 56 */ + +int _EXFUN(clock_setenable_attr, (clockid_t clock_id, int attr)); +int _EXFUN(clock_getenable_attr, (clockid_t clock_id, int *attr)); + +#endif /* _POSIX_CPUTIME or _POSIX_THREAD_CPUTIME */ + +#ifdef __cplusplus +} +#endif + +#endif /* _TIME_H_ */ + diff --git a/components/newlib/include/unctrl.h b/components/newlib/include/unctrl.h new file mode 100644 index 000000000..004075232 --- /dev/null +++ b/components/newlib/include/unctrl.h @@ -0,0 +1,46 @@ +/* From curses.h. */ +/* + * Copyright (c) 1981, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#ifndef _UNCTRL_H_ +#define _UNCTRL_H_ + +#include <_ansi.h> + +#define unctrl(c) __unctrl[(c) & 0xff] +#define unctrllen(ch) __unctrllen[(ch) & 0xff] + +extern __IMPORT _CONST char * _CONST __unctrl[256]; /* Control strings. */ +extern __IMPORT _CONST char __unctrllen[256]; /* Control strings length. */ + +#endif /* _UNCTRL_H_ */ diff --git a/components/newlib/include/unistd.h b/components/newlib/include/unistd.h new file mode 100644 index 000000000..4f6fd29a4 --- /dev/null +++ b/components/newlib/include/unistd.h @@ -0,0 +1,13 @@ +#ifndef _UNISTD_H_ +#define _UNISTD_H_ + +# include + +#ifndef L_SET +/* Old BSD names for the same constants; just for compatibility. */ +#define L_SET SEEK_SET +#define L_INCR SEEK_CUR +#define L_XTND SEEK_END +#endif + +#endif /* _UNISTD_H_ */ diff --git a/components/newlib/include/utime.h b/components/newlib/include/utime.h new file mode 100644 index 000000000..652891aab --- /dev/null +++ b/components/newlib/include/utime.h @@ -0,0 +1,12 @@ +#ifdef __cplusplus +extern "C" { +#endif + +#include <_ansi.h> + +/* The utime function is defined in libc/sys//sys if it exists. */ +#include + +#ifdef __cplusplus +} +#endif diff --git a/components/newlib/include/utmp.h b/components/newlib/include/utmp.h new file mode 100644 index 000000000..88cf6f852 --- /dev/null +++ b/components/newlib/include/utmp.h @@ -0,0 +1,8 @@ +#ifdef __cplusplus +extern "C" { +#endif +#include +#ifdef __cplusplus +} +#endif + diff --git a/components/newlib/include/wchar.h b/components/newlib/include/wchar.h new file mode 100644 index 000000000..810a6c0e3 --- /dev/null +++ b/components/newlib/include/wchar.h @@ -0,0 +1,254 @@ +#ifndef _WCHAR_H_ +#define _WCHAR_H_ + +#include <_ansi.h> + +#include + +#define __need_size_t +#define __need_wchar_t +#define __need_wint_t +#define __need_NULL +#include + +#define __need___va_list +#include + +/* For _mbstate_t definition. */ +#include +#include +/* For __STDC_ISO_10646__ */ +#include + +#ifndef WEOF +# define WEOF ((wint_t)-1) +#endif + +/* This must match definition in */ +#ifndef WCHAR_MIN +#ifdef __WCHAR_MIN__ +#define WCHAR_MIN __WCHAR_MIN__ +#elif defined(__WCHAR_UNSIGNED__) || (L'\0' - 1 > 0) +#define WCHAR_MIN (0 + L'\0') +#else +#define WCHAR_MIN (-0x7fffffff - 1 + L'\0') +#endif +#endif + +/* This must match definition in */ +#ifndef WCHAR_MAX +#ifdef __WCHAR_MAX__ +#define WCHAR_MAX __WCHAR_MAX__ +#elif defined(__WCHAR_UNSIGNED__) || (L'\0' - 1 > 0) +#define WCHAR_MAX (0xffffffffu + L'\0') +#else +#define WCHAR_MAX (0x7fffffff + L'\0') +#endif +#endif + +_BEGIN_STD_C + +/* As in stdio.h, defines __FILE. */ +typedef __FILE FILE; + +/* As required by POSIX.1-2008, declare tm as incomplete type. + The actual definition is in time.h. */ +struct tm; + +#ifndef _MBSTATE_T +#define _MBSTATE_T +typedef _mbstate_t mbstate_t; +#endif /* _MBSTATE_T */ + +wint_t _EXFUN(btowc, (int)); +int _EXFUN(wctob, (wint_t)); +size_t _EXFUN(mbrlen, (const char *__restrict, size_t, mbstate_t *__restrict)); +size_t _EXFUN(mbrtowc, (wchar_t *__restrict, const char *__restrict, size_t, + mbstate_t *__restrict)); +size_t _EXFUN(_mbrtowc_r, (struct _reent *, wchar_t * , const char * , + size_t, mbstate_t *)); +int _EXFUN(mbsinit, (const mbstate_t *)); +size_t _EXFUN(mbsnrtowcs, (wchar_t *__restrict, const char **__restrict, + size_t, size_t, mbstate_t *__restrict)); +size_t _EXFUN(_mbsnrtowcs_r, (struct _reent *, wchar_t * , const char ** , + size_t, size_t, mbstate_t *)); +size_t _EXFUN(mbsrtowcs, (wchar_t *__restrict, const char **__restrict, size_t, + mbstate_t *__restrict)); +size_t _EXFUN(_mbsrtowcs_r, (struct _reent *, wchar_t * , const char ** , size_t, mbstate_t *)); +size_t _EXFUN(wcrtomb, (char *__restrict, wchar_t, mbstate_t *__restrict)); +size_t _EXFUN(_wcrtomb_r, (struct _reent *, char * , wchar_t, mbstate_t *)); +size_t _EXFUN(wcsnrtombs, (char *__restrict, const wchar_t **__restrict, + size_t, size_t, mbstate_t *__restrict)); +size_t _EXFUN(_wcsnrtombs_r, (struct _reent *, char * , const wchar_t ** , + size_t, size_t, mbstate_t *)); +size_t _EXFUN(wcsrtombs, (char *__restrict, const wchar_t **__restrict, + size_t, mbstate_t *__restrict)); +size_t _EXFUN(_wcsrtombs_r, (struct _reent *, char * , const wchar_t ** , + size_t, mbstate_t *)); +int _EXFUN(wcscasecmp, (const wchar_t *, const wchar_t *)); +wchar_t *_EXFUN(wcscat, (wchar_t *__restrict, const wchar_t *__restrict)); +wchar_t *_EXFUN(wcschr, (const wchar_t *, wchar_t)); +int _EXFUN(wcscmp, (const wchar_t *, const wchar_t *)); +int _EXFUN(wcscoll, (const wchar_t *, const wchar_t *)); +wchar_t *_EXFUN(wcscpy, (wchar_t *__restrict, const wchar_t *__restrict)); +wchar_t *_EXFUN(wcpcpy, (wchar_t *__restrict, + const wchar_t *__restrict)); +wchar_t *_EXFUN(wcsdup, (const wchar_t *)); +wchar_t *_EXFUN(_wcsdup_r, (struct _reent *, const wchar_t * )); +size_t _EXFUN(wcscspn, (const wchar_t *, const wchar_t *)); +size_t _EXFUN(wcsftime, (wchar_t *__restrict, size_t, + const wchar_t *__restrict, const struct tm *__restrict)); +size_t _EXFUN(wcslcat, (wchar_t *, const wchar_t *, size_t)); +size_t _EXFUN(wcslcpy, (wchar_t *, const wchar_t *, size_t)); +size_t _EXFUN(wcslen, (const wchar_t *)); +int _EXFUN(wcsncasecmp, (const wchar_t *, const wchar_t *, size_t)); +wchar_t *_EXFUN(wcsncat, (wchar_t *__restrict, + const wchar_t *__restrict, size_t)); +int _EXFUN(wcsncmp, (const wchar_t *, const wchar_t *, size_t)); +wchar_t *_EXFUN(wcsncpy, (wchar_t *__restrict, + const wchar_t *__restrict, size_t)); +wchar_t *_EXFUN(wcpncpy, (wchar_t *__restrict, + const wchar_t *__restrict, size_t)); +size_t _EXFUN(wcsnlen, (const wchar_t *, size_t)); +wchar_t *_EXFUN(wcspbrk, (const wchar_t *, const wchar_t *)); +wchar_t *_EXFUN(wcsrchr, (const wchar_t *, wchar_t)); +size_t _EXFUN(wcsspn, (const wchar_t *, const wchar_t *)); +wchar_t *_EXFUN(wcsstr, (const wchar_t *__restrict, + const wchar_t *__restrict)); +wchar_t *_EXFUN(wcstok, (wchar_t *__restrict, const wchar_t *__restrict, + wchar_t **__restrict)); +double _EXFUN(wcstod, (const wchar_t *__restrict, wchar_t **__restrict)); +double _EXFUN(_wcstod_r, (struct _reent *, const wchar_t *, wchar_t **)); +float _EXFUN(wcstof, (const wchar_t *__restrict, wchar_t **__restrict)); +float _EXFUN(_wcstof_r, (struct _reent *, const wchar_t *, wchar_t **)); +#ifdef _LDBL_EQ_DBL +long double _EXFUN(wcstold, (const wchar_t *, wchar_t **)); +#endif /* _LDBL_EQ_DBL */ +int _EXFUN(wcswidth, (const wchar_t *, size_t)); +size_t _EXFUN(wcsxfrm, (wchar_t *__restrict, const wchar_t *__restrict, + size_t)); +int _EXFUN(wcwidth, (const wchar_t)); +wchar_t *_EXFUN(wmemchr, (const wchar_t *, wchar_t, size_t)); +int _EXFUN(wmemcmp, (const wchar_t *, const wchar_t *, size_t)); +wchar_t *_EXFUN(wmemcpy, (wchar_t *__restrict, const wchar_t *__restrict, + size_t)); +wchar_t *_EXFUN(wmemmove, (wchar_t *, const wchar_t *, size_t)); +wchar_t *_EXFUN(wmemset, (wchar_t *, wchar_t, size_t)); + +long _EXFUN(wcstol, (const wchar_t *__restrict, wchar_t **__restrict, int)); +long long _EXFUN(wcstoll, (const wchar_t *__restrict, wchar_t **__restrict, + int)); +unsigned long _EXFUN(wcstoul, (const wchar_t *__restrict, wchar_t **__restrict, + int)); +unsigned long long _EXFUN(wcstoull, (const wchar_t *__restrict, + wchar_t **__restrict, int)); +long _EXFUN(_wcstol_r, (struct _reent *, const wchar_t *, wchar_t **, int)); +long long _EXFUN(_wcstoll_r, (struct _reent *, const wchar_t *, wchar_t **, int)); +unsigned long _EXFUN(_wcstoul_r, (struct _reent *, const wchar_t *, wchar_t **, int)); +unsigned long long _EXFUN(_wcstoull_r, (struct _reent *, const wchar_t *, wchar_t **, int)); +/* On platforms where long double equals double. */ +#ifdef _LDBL_EQ_DBL +long double _EXFUN(wcstold, (const wchar_t *, wchar_t **)); +#endif /* _LDBL_EQ_DBL */ + +wint_t _EXFUN(fgetwc, (__FILE *)); +wchar_t *_EXFUN(fgetws, (wchar_t *__restrict, int, __FILE *__restrict)); +wint_t _EXFUN(fputwc, (wchar_t, __FILE *)); +int _EXFUN(fputws, (const wchar_t *__restrict, __FILE *__restrict)); +int _EXFUN (fwide, (__FILE *, int)); +wint_t _EXFUN (getwc, (__FILE *)); +wint_t _EXFUN (getwchar, (void)); +wint_t _EXFUN(putwc, (wchar_t, __FILE *)); +wint_t _EXFUN(putwchar, (wchar_t)); +wint_t _EXFUN (ungetwc, (wint_t wc, __FILE *)); + +wint_t _EXFUN(_fgetwc_r, (struct _reent *, __FILE *)); +wint_t _EXFUN(_fgetwc_unlocked_r, (struct _reent *, __FILE *)); +wchar_t *_EXFUN(_fgetws_r, (struct _reent *, wchar_t *, int, __FILE *)); +wchar_t *_EXFUN(_fgetws_unlocked_r, (struct _reent *, wchar_t *, int, __FILE *)); +wint_t _EXFUN(_fputwc_r, (struct _reent *, wchar_t, __FILE *)); +wint_t _EXFUN(_fputwc_unlocked_r, (struct _reent *, wchar_t, __FILE *)); +int _EXFUN(_fputws_r, (struct _reent *, const wchar_t *, __FILE *)); +int _EXFUN(_fputws_unlocked_r, (struct _reent *, const wchar_t *, __FILE *)); +int _EXFUN (_fwide_r, (struct _reent *, __FILE *, int)); +wint_t _EXFUN (_getwc_r, (struct _reent *, __FILE *)); +wint_t _EXFUN (_getwc_unlocked_r, (struct _reent *, __FILE *)); +wint_t _EXFUN (_getwchar_r, (struct _reent *ptr)); +wint_t _EXFUN (_getwchar_unlocked_r, (struct _reent *ptr)); +wint_t _EXFUN(_putwc_r, (struct _reent *, wchar_t, __FILE *)); +wint_t _EXFUN(_putwc_unlocked_r, (struct _reent *, wchar_t, __FILE *)); +wint_t _EXFUN(_putwchar_r, (struct _reent *, wchar_t)); +wint_t _EXFUN(_putwchar_unlocked_r, (struct _reent *, wchar_t)); +wint_t _EXFUN (_ungetwc_r, (struct _reent *, wint_t wc, __FILE *)); + +#if __GNU_VISIBLE +wint_t _EXFUN(fgetwc_unlocked, (__FILE *)); +wchar_t *_EXFUN(fgetws_unlocked, (wchar_t *__restrict, int, __FILE *__restrict)); +wint_t _EXFUN(fputwc_unlocked, (wchar_t, __FILE *)); +int _EXFUN(fputws_unlocked, (const wchar_t *__restrict, __FILE *__restrict)); +wint_t _EXFUN(getwc_unlocked, (__FILE *)); +wint_t _EXFUN(getwchar_unlocked, (void)); +wint_t _EXFUN(putwc_unlocked, (wchar_t, __FILE *)); +wint_t _EXFUN(putwchar_unlocked, (wchar_t)); +#endif + +__FILE *_EXFUN (open_wmemstream, (wchar_t **, size_t *)); +__FILE *_EXFUN (_open_wmemstream_r, (struct _reent *, wchar_t **, size_t *)); + +#ifndef __VALIST +#ifdef __GNUC__ +#define __VALIST __gnuc_va_list +#else +#define __VALIST char* +#endif +#endif + +int _EXFUN(fwprintf, (__FILE *__restrict, const wchar_t *__restrict, ...)); +int _EXFUN(swprintf, (wchar_t *__restrict, size_t, + const wchar_t *__restrict, ...)); +int _EXFUN(vfwprintf, (__FILE *__restrict, const wchar_t *__restrict, + __VALIST)); +int _EXFUN(vswprintf, (wchar_t *__restrict, size_t, + const wchar_t *__restrict, __VALIST)); +int _EXFUN(vwprintf, (const wchar_t *__restrict, __VALIST)); +int _EXFUN(wprintf, (const wchar_t *__restrict, ...)); + +int _EXFUN(_fwprintf_r, (struct _reent *, __FILE *, const wchar_t *, ...)); +int _EXFUN(_swprintf_r, (struct _reent *, wchar_t *, size_t, const wchar_t *, ...)); +int _EXFUN(_vfwprintf_r, (struct _reent *, __FILE *, const wchar_t *, __VALIST)); +int _EXFUN(_vswprintf_r, (struct _reent *, wchar_t *, size_t, const wchar_t *, __VALIST)); +int _EXFUN(_vwprintf_r, (struct _reent *, const wchar_t *, __VALIST)); +int _EXFUN(_wprintf_r, (struct _reent *, const wchar_t *, ...)); + +int _EXFUN(fwscanf, (__FILE *__restrict, const wchar_t *__restrict, ...)); +int _EXFUN(swscanf, (const wchar_t *__restrict, + const wchar_t *__restrict, ...)); +int _EXFUN(vfwscanf, (__FILE *__restrict, const wchar_t *__restrict, + __VALIST)); +int _EXFUN(vswscanf, (const wchar_t *__restrict, const wchar_t *__restrict, + __VALIST)); +int _EXFUN(vwscanf, (const wchar_t *__restrict, __VALIST)); +int _EXFUN(wscanf, (const wchar_t *__restrict, ...)); + +int _EXFUN(_fwscanf_r, (struct _reent *, __FILE *, const wchar_t *, ...)); +int _EXFUN(_swscanf_r, (struct _reent *, const wchar_t *, const wchar_t *, ...)); +int _EXFUN(_vfwscanf_r, (struct _reent *, __FILE *, const wchar_t *, __VALIST)); +int _EXFUN(_vswscanf_r, (struct _reent *, const wchar_t *, const wchar_t *, __VALIST)); +int _EXFUN(_vwscanf_r, (struct _reent *, const wchar_t *, __VALIST)); +int _EXFUN(_wscanf_r, (struct _reent *, const wchar_t *, ...)); + +#define getwc(fp) fgetwc(fp) +#define putwc(wc,fp) fputwc((wc), (fp)) +#define getwchar() fgetwc(_REENT->_stdin) +#define putwchar(wc) fputwc((wc), _REENT->_stdout) + +#if __GNU_VISIBLE +#define getwc_unlocked(fp) fgetwc_unlocked(fp) +#define putwc_unlocked(wc,fp) fputwc_unlocked((wc), (fp)) +#define getwchar_unlocked() fgetwc_unlocked(_REENT->_stdin) +#define putwchar_unlocked(wc) fputwc_unlocked((wc), _REENT->_stdout) +#endif + +_END_STD_C + +#endif /* _WCHAR_H_ */ diff --git a/components/newlib/include/wctype.h b/components/newlib/include/wctype.h new file mode 100644 index 000000000..c72c9decf --- /dev/null +++ b/components/newlib/include/wctype.h @@ -0,0 +1,47 @@ +#ifndef _WCTYPE_H_ +#define _WCTYPE_H_ + +#include <_ansi.h> +#include + +#define __need_wint_t +#include + +#ifndef WEOF +# define WEOF ((wint_t)-1) +#endif + +_BEGIN_STD_C + +#ifndef _WCTYPE_T +#define _WCTYPE_T +typedef int wctype_t; +#endif + +#ifndef _WCTRANS_T +#define _WCTRANS_T +typedef int wctrans_t; +#endif + +int _EXFUN(iswalpha, (wint_t)); +int _EXFUN(iswalnum, (wint_t)); +int _EXFUN(iswblank, (wint_t)); +int _EXFUN(iswcntrl, (wint_t)); +int _EXFUN(iswctype, (wint_t, wctype_t)); +int _EXFUN(iswdigit, (wint_t)); +int _EXFUN(iswgraph, (wint_t)); +int _EXFUN(iswlower, (wint_t)); +int _EXFUN(iswprint, (wint_t)); +int _EXFUN(iswpunct, (wint_t)); +int _EXFUN(iswspace, (wint_t)); +int _EXFUN(iswupper, (wint_t)); +int _EXFUN(iswxdigit, (wint_t)); +wint_t _EXFUN(towctrans, (wint_t, wctrans_t)); +wint_t _EXFUN(towupper, (wint_t)); +wint_t _EXFUN(towlower, (wint_t)); +wctrans_t _EXFUN(wctrans, (const char *)); +wctype_t _EXFUN(wctype, (const char *)); + +_END_STD_C + +#endif /* _WCTYPE_H_ */ diff --git a/components/newlib/include/wordexp.h b/components/newlib/include/wordexp.h new file mode 100644 index 000000000..1f09a64c5 --- /dev/null +++ b/components/newlib/include/wordexp.h @@ -0,0 +1,53 @@ +/* Copyright (C) 2002, 2010 by Red Hat, Incorporated. All rights reserved. + * + * Permission to use, copy, modify, and distribute this software + * is freely granted, provided that this notice is preserved. + */ + +#ifndef _WORDEXP_H_ +#define _WORDEXP_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +struct _wordexp_t +{ + size_t we_wordc; /* Count of words matched by words. */ + char **we_wordv; /* Pointer to list of expanded words. */ + size_t we_offs; /* Slots to reserve at the beginning of we_wordv. */ +}; + +typedef struct _wordexp_t wordexp_t; + +#define WRDE_DOOFFS 0x0001 /* Use we_offs. */ +#define WRDE_APPEND 0x0002 /* Append to output from previous call. */ +#define WRDE_NOCMD 0x0004 /* Don't perform command substitution. */ +#define WRDE_REUSE 0x0008 /* pwordexp points to a wordexp_t struct returned from + a previous successful call to wordexp. */ +#define WRDE_SHOWERR 0x0010 /* Print error messages to stderr. */ +#define WRDE_UNDEF 0x0020 /* Report attempt to expand undefined shell variable. */ + +enum { + WRDE_SUCCESS, + WRDE_NOSPACE, + WRDE_BADCHAR, + WRDE_BADVAL, + WRDE_CMDSUB, + WRDE_SYNTAX, + WRDE_NOSYS +}; + +/* Note: This implementation of wordexp requires a version of bash + that supports the --wordexp and --protected arguments to be present + on the system. It does not support the WRDE_UNDEF flag. */ +int wordexp(const char *__restrict, wordexp_t *__restrict, int); +void wordfree(wordexp_t *); + +#ifdef __cplusplus +} +#endif + +#endif /* _WORDEXP_H_ */ diff --git a/components/newlib/include/xtensa/config/core-isa.h b/components/newlib/include/xtensa/config/core-isa.h new file mode 100644 index 000000000..f3f4e45f0 --- /dev/null +++ b/components/newlib/include/xtensa/config/core-isa.h @@ -0,0 +1,655 @@ +/* + * xtensa/config/core-isa.h -- HAL definitions that are dependent on Xtensa + * processor CORE configuration + * + * See , which includes this file, for more details. + */ + +/* Xtensa processor core configuration information. + + Copyright (c) 1999-2016 Tensilica Inc. + + Permission is hereby granted, free of charge, to any person obtaining + a copy of this software and associated documentation files (the + "Software"), to deal in the Software without restriction, including + without limitation the rights to use, copy, modify, merge, publish, + distribute, sublicense, and/or sell copies of the Software, and to + permit persons to whom the Software is furnished to do so, subject to + the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ + +#ifndef _XTENSA_CORE_CONFIGURATION_H +#define _XTENSA_CORE_CONFIGURATION_H + + +/**************************************************************************** + Parameters Useful for Any Code, USER or PRIVILEGED + ****************************************************************************/ + +/* + * Note: Macros of the form XCHAL_HAVE_*** have a value of 1 if the option is + * configured, and a value of 0 otherwise. These macros are always defined. + */ + + +/*---------------------------------------------------------------------- + ISA + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_BE 0 /* big-endian byte ordering */ +#define XCHAL_HAVE_WINDOWED 1 /* windowed registers option */ +#define XCHAL_NUM_AREGS 64 /* num of physical addr regs */ +#define XCHAL_NUM_AREGS_LOG2 6 /* log2(XCHAL_NUM_AREGS) */ +#define XCHAL_MAX_INSTRUCTION_SIZE 3 /* max instr bytes (3..8) */ +#define XCHAL_HAVE_DEBUG 1 /* debug option */ +#define XCHAL_HAVE_DENSITY 1 /* 16-bit instructions */ +#define XCHAL_HAVE_LOOPS 1 /* zero-overhead loops */ +#define XCHAL_LOOP_BUFFER_SIZE 256 /* zero-ov. loop instr buffer size */ +#define XCHAL_HAVE_NSA 1 /* NSA/NSAU instructions */ +#define XCHAL_HAVE_MINMAX 1 /* MIN/MAX instructions */ +#define XCHAL_HAVE_SEXT 1 /* SEXT instruction */ +#define XCHAL_HAVE_DEPBITS 0 /* DEPBITS instruction */ +#define XCHAL_HAVE_CLAMPS 1 /* CLAMPS instruction */ +#define XCHAL_HAVE_MUL16 1 /* MUL16S/MUL16U instructions */ +#define XCHAL_HAVE_MUL32 1 /* MULL instruction */ +#define XCHAL_HAVE_MUL32_HIGH 1 /* MULUH/MULSH instructions */ +#define XCHAL_HAVE_DIV32 1 /* QUOS/QUOU/REMS/REMU instructions */ +#define XCHAL_HAVE_L32R 1 /* L32R instruction */ +#define XCHAL_HAVE_ABSOLUTE_LITERALS 0 /* non-PC-rel (extended) L32R */ +#define XCHAL_HAVE_CONST16 0 /* CONST16 instruction */ +#define XCHAL_HAVE_ADDX 1 /* ADDX#/SUBX# instructions */ +#define XCHAL_HAVE_WIDE_BRANCHES 0 /* B*.W18 or B*.W15 instr's */ +#define XCHAL_HAVE_PREDICTED_BRANCHES 0 /* B[EQ/EQZ/NE/NEZ]T instr's */ +#define XCHAL_HAVE_CALL4AND12 1 /* (obsolete option) */ +#define XCHAL_HAVE_ABS 1 /* ABS instruction */ +/*#define XCHAL_HAVE_POPC 0*/ /* POPC instruction */ +/*#define XCHAL_HAVE_CRC 0*/ /* CRC instruction */ +#define XCHAL_HAVE_RELEASE_SYNC 1 /* L32AI/S32RI instructions */ +#define XCHAL_HAVE_S32C1I 1 /* S32C1I instruction */ +#define XCHAL_HAVE_SPECULATION 0 /* speculation */ +#define XCHAL_HAVE_FULL_RESET 1 /* all regs/state reset */ +#define XCHAL_NUM_CONTEXTS 1 /* */ +#define XCHAL_NUM_MISC_REGS 4 /* num of scratch regs (0..4) */ +#define XCHAL_HAVE_TAP_MASTER 0 /* JTAG TAP control instr's */ +#define XCHAL_HAVE_PRID 1 /* processor ID register */ +#define XCHAL_HAVE_EXTERN_REGS 1 /* WER/RER instructions */ +#define XCHAL_HAVE_MX 0 /* MX core (Tensilica internal) */ +#define XCHAL_HAVE_MP_INTERRUPTS 0 /* interrupt distributor port */ +#define XCHAL_HAVE_MP_RUNSTALL 0 /* core RunStall control port */ +#define XCHAL_HAVE_PSO 0 /* Power Shut-Off */ +#define XCHAL_HAVE_PSO_CDM 0 /* core/debug/mem pwr domains */ +#define XCHAL_HAVE_PSO_FULL_RETENTION 0 /* all regs preserved on PSO */ +#define XCHAL_HAVE_THREADPTR 1 /* THREADPTR register */ +#define XCHAL_HAVE_BOOLEANS 1 /* boolean registers */ +#define XCHAL_HAVE_CP 1 /* CPENABLE reg (coprocessor) */ +#define XCHAL_CP_MAXCFG 8 /* max allowed cp id plus one */ +#define XCHAL_HAVE_MAC16 1 /* MAC16 package */ + +#define XCHAL_HAVE_FUSION 0 /* Fusion*/ +#define XCHAL_HAVE_FUSION_FP 0 /* Fusion FP option */ +#define XCHAL_HAVE_FUSION_LOW_POWER 0 /* Fusion Low Power option */ +#define XCHAL_HAVE_FUSION_AES 0 /* Fusion BLE/Wifi AES-128 CCM option */ +#define XCHAL_HAVE_FUSION_CONVENC 0 /* Fusion Conv Encode option */ +#define XCHAL_HAVE_FUSION_LFSR_CRC 0 /* Fusion LFSR-CRC option */ +#define XCHAL_HAVE_FUSION_BITOPS 0 /* Fusion Bit Operations Support option */ +#define XCHAL_HAVE_FUSION_AVS 0 /* Fusion AVS option */ +#define XCHAL_HAVE_FUSION_16BIT_BASEBAND 0 /* Fusion 16-bit Baseband option */ +#define XCHAL_HAVE_FUSION_VITERBI 0 /* Fusion Viterbi option */ +#define XCHAL_HAVE_FUSION_SOFTDEMAP 0 /* Fusion Soft Bit Demap option */ +#define XCHAL_HAVE_HIFIPRO 0 /* HiFiPro Audio Engine pkg */ +#define XCHAL_HAVE_HIFI4 0 /* HiFi4 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI4_VFPU 0 /* HiFi4 Audio Engine VFPU option */ +#define XCHAL_HAVE_HIFI3 0 /* HiFi3 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI3_VFPU 0 /* HiFi3 Audio Engine VFPU option */ +#define XCHAL_HAVE_HIFI2 0 /* HiFi2 Audio Engine pkg */ +#define XCHAL_HAVE_HIFI2EP 0 /* HiFi2EP */ +#define XCHAL_HAVE_HIFI_MINI 0 + + +#define XCHAL_HAVE_VECTORFPU2005 0 /* vector or user floating-point pkg */ +#define XCHAL_HAVE_USER_DPFPU 0 /* user DP floating-point pkg */ +#define XCHAL_HAVE_USER_SPFPU 0 /* user DP floating-point pkg */ +#define XCHAL_HAVE_FP 1 /* single prec floating point */ +#define XCHAL_HAVE_FP_DIV 1 /* FP with DIV instructions */ +#define XCHAL_HAVE_FP_RECIP 1 /* FP with RECIP instructions */ +#define XCHAL_HAVE_FP_SQRT 1 /* FP with SQRT instructions */ +#define XCHAL_HAVE_FP_RSQRT 1 /* FP with RSQRT instructions */ +#define XCHAL_HAVE_DFP 0 /* double precision FP pkg */ +#define XCHAL_HAVE_DFP_DIV 0 /* DFP with DIV instructions */ +#define XCHAL_HAVE_DFP_RECIP 0 /* DFP with RECIP instructions*/ +#define XCHAL_HAVE_DFP_SQRT 0 /* DFP with SQRT instructions */ +#define XCHAL_HAVE_DFP_RSQRT 0 /* DFP with RSQRT instructions*/ +#define XCHAL_HAVE_DFP_ACCEL 1 /* double precision FP acceleration pkg */ +#define XCHAL_HAVE_DFP_accel XCHAL_HAVE_DFP_ACCEL /* for backward compatibility */ + +#define XCHAL_HAVE_DFPU_SINGLE_ONLY 1 /* DFPU Coprocessor, single precision only */ +#define XCHAL_HAVE_DFPU_SINGLE_DOUBLE 0 /* DFPU Coprocessor, single and double precision */ +#define XCHAL_HAVE_VECTRA1 0 /* Vectra I pkg */ +#define XCHAL_HAVE_VECTRALX 0 /* Vectra LX pkg */ +#define XCHAL_HAVE_PDX4 0 /* PDX4 */ +#define XCHAL_HAVE_CONNXD2 0 /* ConnX D2 pkg */ +#define XCHAL_HAVE_CONNXD2_DUALLSFLIX 0 /* ConnX D2 & Dual LoadStore Flix */ +#define XCHAL_HAVE_BBE16 0 /* ConnX BBE16 pkg */ +#define XCHAL_HAVE_BBE16_RSQRT 0 /* BBE16 & vector recip sqrt */ +#define XCHAL_HAVE_BBE16_VECDIV 0 /* BBE16 & vector divide */ +#define XCHAL_HAVE_BBE16_DESPREAD 0 /* BBE16 & despread */ +#define XCHAL_HAVE_BBENEP 0 /* ConnX BBENEP pkgs */ +#define XCHAL_HAVE_BSP3 0 /* ConnX BSP3 pkg */ +#define XCHAL_HAVE_BSP3_TRANSPOSE 0 /* BSP3 & transpose32x32 */ +#define XCHAL_HAVE_SSP16 0 /* ConnX SSP16 pkg */ +#define XCHAL_HAVE_SSP16_VITERBI 0 /* SSP16 & viterbi */ +#define XCHAL_HAVE_TURBO16 0 /* ConnX Turbo16 pkg */ +#define XCHAL_HAVE_BBP16 0 /* ConnX BBP16 pkg */ +#define XCHAL_HAVE_FLIX3 0 /* basic 3-way FLIX option */ +#define XCHAL_HAVE_GRIVPEP 0 /* GRIVPEP is General Release of IVPEP */ +#define XCHAL_HAVE_GRIVPEP_HISTOGRAM 0 /* Histogram option on GRIVPEP */ + + +/*---------------------------------------------------------------------- + MISC + ----------------------------------------------------------------------*/ + +#define XCHAL_NUM_LOADSTORE_UNITS 1 /* load/store units */ +#define XCHAL_NUM_WRITEBUFFER_ENTRIES 4 /* size of write buffer */ +#define XCHAL_INST_FETCH_WIDTH 4 /* instr-fetch width in bytes */ +#define XCHAL_DATA_WIDTH 4 /* data width in bytes */ +#define XCHAL_DATA_PIPE_DELAY 2 /* d-side pipeline delay + (1 = 5-stage, 2 = 7-stage) */ +#define XCHAL_CLOCK_GATING_GLOBAL 1 /* global clock gating */ +#define XCHAL_CLOCK_GATING_FUNCUNIT 1 /* funct. unit clock gating */ +/* In T1050, applies to selected core load and store instructions (see ISA): */ +#define XCHAL_UNALIGNED_LOAD_EXCEPTION 0 /* unaligned loads cause exc. */ +#define XCHAL_UNALIGNED_STORE_EXCEPTION 0 /* unaligned stores cause exc.*/ +#define XCHAL_UNALIGNED_LOAD_HW 1 /* unaligned loads work in hw */ +#define XCHAL_UNALIGNED_STORE_HW 1 /* unaligned stores work in hw*/ + +#define XCHAL_SW_VERSION 1100003 /* sw version of this header */ + +#define XCHAL_CORE_ID "esp32_v3_49_prod" /* alphanum core name + (CoreID) set in the Xtensa + Processor Generator */ + +#define XCHAL_BUILD_UNIQUE_ID 0x0005FE96 /* 22-bit sw build ID */ + +/* + * These definitions describe the hardware targeted by this software. + */ +#define XCHAL_HW_CONFIGID0 0xC2BCFFFE /* ConfigID hi 32 bits*/ +#define XCHAL_HW_CONFIGID1 0x1CC5FE96 /* ConfigID lo 32 bits*/ +#define XCHAL_HW_VERSION_NAME "LX6.0.3" /* full version name */ +#define XCHAL_HW_VERSION_MAJOR 2600 /* major ver# of targeted hw */ +#define XCHAL_HW_VERSION_MINOR 3 /* minor ver# of targeted hw */ +#define XCHAL_HW_VERSION 260003 /* major*100+minor */ +#define XCHAL_HW_REL_LX6 1 +#define XCHAL_HW_REL_LX6_0 1 +#define XCHAL_HW_REL_LX6_0_3 1 +#define XCHAL_HW_CONFIGID_RELIABLE 1 +/* If software targets a *range* of hardware versions, these are the bounds: */ +#define XCHAL_HW_MIN_VERSION_MAJOR 2600 /* major v of earliest tgt hw */ +#define XCHAL_HW_MIN_VERSION_MINOR 3 /* minor v of earliest tgt hw */ +#define XCHAL_HW_MIN_VERSION 260003 /* earliest targeted hw */ +#define XCHAL_HW_MAX_VERSION_MAJOR 2600 /* major v of latest tgt hw */ +#define XCHAL_HW_MAX_VERSION_MINOR 3 /* minor v of latest tgt hw */ +#define XCHAL_HW_MAX_VERSION 260003 /* latest targeted hw */ + + +/*---------------------------------------------------------------------- + CACHE + ----------------------------------------------------------------------*/ + +#define XCHAL_ICACHE_LINESIZE 4 /* I-cache line size in bytes */ +#define XCHAL_DCACHE_LINESIZE 4 /* D-cache line size in bytes */ +#define XCHAL_ICACHE_LINEWIDTH 2 /* log2(I line size in bytes) */ +#define XCHAL_DCACHE_LINEWIDTH 2 /* log2(D line size in bytes) */ + +#define XCHAL_ICACHE_SIZE 0 /* I-cache size in bytes or 0 */ +#define XCHAL_DCACHE_SIZE 0 /* D-cache size in bytes or 0 */ + +#define XCHAL_DCACHE_IS_WRITEBACK 0 /* writeback feature */ +#define XCHAL_DCACHE_IS_COHERENT 0 /* MP coherence feature */ + +#define XCHAL_HAVE_PREFETCH 0 /* PREFCTL register */ +#define XCHAL_HAVE_PREFETCH_L1 0 /* prefetch to L1 dcache */ +#define XCHAL_PREFETCH_CASTOUT_LINES 0 /* dcache pref. castout bufsz */ +#define XCHAL_PREFETCH_ENTRIES 0 /* cache prefetch entries */ +#define XCHAL_PREFETCH_BLOCK_ENTRIES 0 /* prefetch block streams */ +#define XCHAL_HAVE_CACHE_BLOCKOPS 0 /* block prefetch for caches */ +#define XCHAL_HAVE_ICACHE_TEST 0 /* Icache test instructions */ +#define XCHAL_HAVE_DCACHE_TEST 0 /* Dcache test instructions */ +#define XCHAL_HAVE_ICACHE_DYN_WAYS 0 /* Icache dynamic way support */ +#define XCHAL_HAVE_DCACHE_DYN_WAYS 0 /* Dcache dynamic way support */ + + + + +/**************************************************************************** + Parameters Useful for PRIVILEGED (Supervisory or Non-Virtualized) Code + ****************************************************************************/ + + +#ifndef XTENSA_HAL_NON_PRIVILEGED_ONLY + +/*---------------------------------------------------------------------- + CACHE + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_PIF 1 /* any outbound PIF present */ +#define XCHAL_HAVE_AXI 0 /* AXI bus */ + +#define XCHAL_HAVE_PIF_WR_RESP 0 /* pif write response */ +#define XCHAL_HAVE_PIF_REQ_ATTR 0 /* pif attribute */ + +/* If present, cache size in bytes == (ways * 2^(linewidth + setwidth)). */ + +/* Number of cache sets in log2(lines per way): */ +#define XCHAL_ICACHE_SETWIDTH 0 +#define XCHAL_DCACHE_SETWIDTH 0 + +/* Cache set associativity (number of ways): */ +#define XCHAL_ICACHE_WAYS 1 +#define XCHAL_DCACHE_WAYS 1 + +/* Cache features: */ +#define XCHAL_ICACHE_LINE_LOCKABLE 0 +#define XCHAL_DCACHE_LINE_LOCKABLE 0 +#define XCHAL_ICACHE_ECC_PARITY 0 +#define XCHAL_DCACHE_ECC_PARITY 0 + +/* Cache access size in bytes (affects operation of SICW instruction): */ +#define XCHAL_ICACHE_ACCESS_SIZE 1 +#define XCHAL_DCACHE_ACCESS_SIZE 1 + +#define XCHAL_DCACHE_BANKS 0 /* number of banks */ + +/* Number of encoded cache attr bits (see for decoded bits): */ +#define XCHAL_CA_BITS 4 + + +/*---------------------------------------------------------------------- + INTERNAL I/D RAM/ROMs and XLMI + ----------------------------------------------------------------------*/ + +#define XCHAL_NUM_INSTROM 1 /* number of core instr. ROMs */ +#define XCHAL_NUM_INSTRAM 2 /* number of core instr. RAMs */ +#define XCHAL_NUM_DATAROM 1 /* number of core data ROMs */ +#define XCHAL_NUM_DATARAM 2 /* number of core data RAMs */ +#define XCHAL_NUM_URAM 0 /* number of core unified RAMs*/ +#define XCHAL_NUM_XLMI 1 /* number of core XLMI ports */ + +/* Instruction ROM 0: */ +#define XCHAL_INSTROM0_VADDR 0x40800000 /* virtual address */ +#define XCHAL_INSTROM0_PADDR 0x40800000 /* physical address */ +#define XCHAL_INSTROM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTROM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Instruction RAM 0: */ +#define XCHAL_INSTRAM0_VADDR 0x40000000 /* virtual address */ +#define XCHAL_INSTRAM0_PADDR 0x40000000 /* physical address */ +#define XCHAL_INSTRAM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTRAM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Instruction RAM 1: */ +#define XCHAL_INSTRAM1_VADDR 0x40400000 /* virtual address */ +#define XCHAL_INSTRAM1_PADDR 0x40400000 /* physical address */ +#define XCHAL_INSTRAM1_SIZE 4194304 /* size in bytes */ +#define XCHAL_INSTRAM1_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +/* Data ROM 0: */ +#define XCHAL_DATAROM0_VADDR 0x3F400000 /* virtual address */ +#define XCHAL_DATAROM0_PADDR 0x3F400000 /* physical address */ +#define XCHAL_DATAROM0_SIZE 4194304 /* size in bytes */ +#define XCHAL_DATAROM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATAROM0_BANKS 1 /* number of banks */ + +/* Data RAM 0: */ +#define XCHAL_DATARAM0_VADDR 0x3FF80000 /* virtual address */ +#define XCHAL_DATARAM0_PADDR 0x3FF80000 /* physical address */ +#define XCHAL_DATARAM0_SIZE 524288 /* size in bytes */ +#define XCHAL_DATARAM0_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATARAM0_BANKS 1 /* number of banks */ + +/* Data RAM 1: */ +#define XCHAL_DATARAM1_VADDR 0x3F800000 /* virtual address */ +#define XCHAL_DATARAM1_PADDR 0x3F800000 /* physical address */ +#define XCHAL_DATARAM1_SIZE 4194304 /* size in bytes */ +#define XCHAL_DATARAM1_ECC_PARITY 0 /* ECC/parity type, 0=none */ +#define XCHAL_DATARAM1_BANKS 1 /* number of banks */ + +/* XLMI Port 0: */ +#define XCHAL_XLMI0_VADDR 0x3FF00000 /* virtual address */ +#define XCHAL_XLMI0_PADDR 0x3FF00000 /* physical address */ +#define XCHAL_XLMI0_SIZE 524288 /* size in bytes */ +#define XCHAL_XLMI0_ECC_PARITY 0 /* ECC/parity type, 0=none */ + +#define XCHAL_HAVE_IMEM_LOADSTORE 1 /* can load/store to IROM/IRAM*/ + + +/*---------------------------------------------------------------------- + INTERRUPTS and TIMERS + ----------------------------------------------------------------------*/ + +#define XCHAL_HAVE_INTERRUPTS 1 /* interrupt option */ +#define XCHAL_HAVE_HIGHPRI_INTERRUPTS 1 /* med/high-pri. interrupts */ +#define XCHAL_HAVE_NMI 1 /* non-maskable interrupt */ +#define XCHAL_HAVE_CCOUNT 1 /* CCOUNT reg. (timer option) */ +#define XCHAL_NUM_TIMERS 3 /* number of CCOMPAREn regs */ +#define XCHAL_NUM_INTERRUPTS 32 /* number of interrupts */ +#define XCHAL_NUM_INTERRUPTS_LOG2 5 /* ceil(log2(NUM_INTERRUPTS)) */ +#define XCHAL_NUM_EXTINTERRUPTS 26 /* num of external interrupts */ +#define XCHAL_NUM_INTLEVELS 6 /* number of interrupt levels + (not including level zero) */ +#define XCHAL_EXCM_LEVEL 3 /* level masked by PS.EXCM */ + /* (always 1 in XEA1; levels 2 .. EXCM_LEVEL are "medium priority") */ + +/* Masks of interrupts at each interrupt level: */ +#define XCHAL_INTLEVEL1_MASK 0x000637FF +#define XCHAL_INTLEVEL2_MASK 0x00380000 +#define XCHAL_INTLEVEL3_MASK 0x28C08800 +#define XCHAL_INTLEVEL4_MASK 0x53000000 +#define XCHAL_INTLEVEL5_MASK 0x84010000 +#define XCHAL_INTLEVEL6_MASK 0x00000000 +#define XCHAL_INTLEVEL7_MASK 0x00004000 + +/* Masks of interrupts at each range 1..n of interrupt levels: */ +#define XCHAL_INTLEVEL1_ANDBELOW_MASK 0x000637FF +#define XCHAL_INTLEVEL2_ANDBELOW_MASK 0x003E37FF +#define XCHAL_INTLEVEL3_ANDBELOW_MASK 0x28FEBFFF +#define XCHAL_INTLEVEL4_ANDBELOW_MASK 0x7BFEBFFF +#define XCHAL_INTLEVEL5_ANDBELOW_MASK 0xFFFFBFFF +#define XCHAL_INTLEVEL6_ANDBELOW_MASK 0xFFFFBFFF +#define XCHAL_INTLEVEL7_ANDBELOW_MASK 0xFFFFFFFF + +/* Level of each interrupt: */ +#define XCHAL_INT0_LEVEL 1 +#define XCHAL_INT1_LEVEL 1 +#define XCHAL_INT2_LEVEL 1 +#define XCHAL_INT3_LEVEL 1 +#define XCHAL_INT4_LEVEL 1 +#define XCHAL_INT5_LEVEL 1 +#define XCHAL_INT6_LEVEL 1 +#define XCHAL_INT7_LEVEL 1 +#define XCHAL_INT8_LEVEL 1 +#define XCHAL_INT9_LEVEL 1 +#define XCHAL_INT10_LEVEL 1 +#define XCHAL_INT11_LEVEL 3 +#define XCHAL_INT12_LEVEL 1 +#define XCHAL_INT13_LEVEL 1 +#define XCHAL_INT14_LEVEL 7 +#define XCHAL_INT15_LEVEL 3 +#define XCHAL_INT16_LEVEL 5 +#define XCHAL_INT17_LEVEL 1 +#define XCHAL_INT18_LEVEL 1 +#define XCHAL_INT19_LEVEL 2 +#define XCHAL_INT20_LEVEL 2 +#define XCHAL_INT21_LEVEL 2 +#define XCHAL_INT22_LEVEL 3 +#define XCHAL_INT23_LEVEL 3 +#define XCHAL_INT24_LEVEL 4 +#define XCHAL_INT25_LEVEL 4 +#define XCHAL_INT26_LEVEL 5 +#define XCHAL_INT27_LEVEL 3 +#define XCHAL_INT28_LEVEL 4 +#define XCHAL_INT29_LEVEL 3 +#define XCHAL_INT30_LEVEL 4 +#define XCHAL_INT31_LEVEL 5 +#define XCHAL_DEBUGLEVEL 6 /* debug interrupt level */ +#define XCHAL_HAVE_DEBUG_EXTERN_INT 1 /* OCD external db interrupt */ +#define XCHAL_NMILEVEL 7 /* NMI "level" (for use with + EXCSAVE/EPS/EPC_n, RFI n) */ + +/* Type of each interrupt: */ +#define XCHAL_INT0_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT1_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT2_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT3_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT4_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT5_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT6_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT7_TYPE XTHAL_INTTYPE_SOFTWARE +#define XCHAL_INT8_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT9_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT10_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT11_TYPE XTHAL_INTTYPE_PROFILING +#define XCHAL_INT12_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT13_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT14_TYPE XTHAL_INTTYPE_NMI +#define XCHAL_INT15_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT16_TYPE XTHAL_INTTYPE_TIMER +#define XCHAL_INT17_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT18_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT19_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT20_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT21_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT22_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT23_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT24_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT25_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT26_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT27_TYPE XTHAL_INTTYPE_EXTERN_LEVEL +#define XCHAL_INT28_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT29_TYPE XTHAL_INTTYPE_SOFTWARE +#define XCHAL_INT30_TYPE XTHAL_INTTYPE_EXTERN_EDGE +#define XCHAL_INT31_TYPE XTHAL_INTTYPE_EXTERN_LEVEL + +/* Masks of interrupts for each type of interrupt: */ +#define XCHAL_INTTYPE_MASK_UNCONFIGURED 0x00000000 +#define XCHAL_INTTYPE_MASK_SOFTWARE 0x20000080 +#define XCHAL_INTTYPE_MASK_EXTERN_EDGE 0x50400400 +#define XCHAL_INTTYPE_MASK_EXTERN_LEVEL 0x8FBE333F +#define XCHAL_INTTYPE_MASK_TIMER 0x00018040 +#define XCHAL_INTTYPE_MASK_NMI 0x00004000 +#define XCHAL_INTTYPE_MASK_WRITE_ERROR 0x00000000 +#define XCHAL_INTTYPE_MASK_PROFILING 0x00000800 + +/* Interrupt numbers assigned to specific interrupt sources: */ +#define XCHAL_TIMER0_INTERRUPT 6 /* CCOMPARE0 */ +#define XCHAL_TIMER1_INTERRUPT 15 /* CCOMPARE1 */ +#define XCHAL_TIMER2_INTERRUPT 16 /* CCOMPARE2 */ +#define XCHAL_TIMER3_INTERRUPT XTHAL_TIMER_UNCONFIGURED +#define XCHAL_NMI_INTERRUPT 14 /* non-maskable interrupt */ +#define XCHAL_PROFILING_INTERRUPT 11 /* profiling interrupt */ + +/* Interrupt numbers for levels at which only one interrupt is configured: */ +#define XCHAL_INTLEVEL7_NUM 14 +/* (There are many interrupts each at level(s) 1, 2, 3, 4, 5.) */ + + +/* + * External interrupt mapping. + * These macros describe how Xtensa processor interrupt numbers + * (as numbered internally, eg. in INTERRUPT and INTENABLE registers) + * map to external BInterrupt pins, for those interrupts + * configured as external (level-triggered, edge-triggered, or NMI). + * See the Xtensa processor databook for more details. + */ + +/* Core interrupt numbers mapped to each EXTERNAL BInterrupt pin number: */ +#define XCHAL_EXTINT0_NUM 0 /* (intlevel 1) */ +#define XCHAL_EXTINT1_NUM 1 /* (intlevel 1) */ +#define XCHAL_EXTINT2_NUM 2 /* (intlevel 1) */ +#define XCHAL_EXTINT3_NUM 3 /* (intlevel 1) */ +#define XCHAL_EXTINT4_NUM 4 /* (intlevel 1) */ +#define XCHAL_EXTINT5_NUM 5 /* (intlevel 1) */ +#define XCHAL_EXTINT6_NUM 8 /* (intlevel 1) */ +#define XCHAL_EXTINT7_NUM 9 /* (intlevel 1) */ +#define XCHAL_EXTINT8_NUM 10 /* (intlevel 1) */ +#define XCHAL_EXTINT9_NUM 12 /* (intlevel 1) */ +#define XCHAL_EXTINT10_NUM 13 /* (intlevel 1) */ +#define XCHAL_EXTINT11_NUM 14 /* (intlevel 7) */ +#define XCHAL_EXTINT12_NUM 17 /* (intlevel 1) */ +#define XCHAL_EXTINT13_NUM 18 /* (intlevel 1) */ +#define XCHAL_EXTINT14_NUM 19 /* (intlevel 2) */ +#define XCHAL_EXTINT15_NUM 20 /* (intlevel 2) */ +#define XCHAL_EXTINT16_NUM 21 /* (intlevel 2) */ +#define XCHAL_EXTINT17_NUM 22 /* (intlevel 3) */ +#define XCHAL_EXTINT18_NUM 23 /* (intlevel 3) */ +#define XCHAL_EXTINT19_NUM 24 /* (intlevel 4) */ +#define XCHAL_EXTINT20_NUM 25 /* (intlevel 4) */ +#define XCHAL_EXTINT21_NUM 26 /* (intlevel 5) */ +#define XCHAL_EXTINT22_NUM 27 /* (intlevel 3) */ +#define XCHAL_EXTINT23_NUM 28 /* (intlevel 4) */ +#define XCHAL_EXTINT24_NUM 30 /* (intlevel 4) */ +#define XCHAL_EXTINT25_NUM 31 /* (intlevel 5) */ +/* EXTERNAL BInterrupt pin numbers mapped to each core interrupt number: */ +#define XCHAL_INT0_EXTNUM 0 /* (intlevel 1) */ +#define XCHAL_INT1_EXTNUM 1 /* (intlevel 1) */ +#define XCHAL_INT2_EXTNUM 2 /* (intlevel 1) */ +#define XCHAL_INT3_EXTNUM 3 /* (intlevel 1) */ +#define XCHAL_INT4_EXTNUM 4 /* (intlevel 1) */ +#define XCHAL_INT5_EXTNUM 5 /* (intlevel 1) */ +#define XCHAL_INT8_EXTNUM 6 /* (intlevel 1) */ +#define XCHAL_INT9_EXTNUM 7 /* (intlevel 1) */ +#define XCHAL_INT10_EXTNUM 8 /* (intlevel 1) */ +#define XCHAL_INT12_EXTNUM 9 /* (intlevel 1) */ +#define XCHAL_INT13_EXTNUM 10 /* (intlevel 1) */ +#define XCHAL_INT14_EXTNUM 11 /* (intlevel 7) */ +#define XCHAL_INT17_EXTNUM 12 /* (intlevel 1) */ +#define XCHAL_INT18_EXTNUM 13 /* (intlevel 1) */ +#define XCHAL_INT19_EXTNUM 14 /* (intlevel 2) */ +#define XCHAL_INT20_EXTNUM 15 /* (intlevel 2) */ +#define XCHAL_INT21_EXTNUM 16 /* (intlevel 2) */ +#define XCHAL_INT22_EXTNUM 17 /* (intlevel 3) */ +#define XCHAL_INT23_EXTNUM 18 /* (intlevel 3) */ +#define XCHAL_INT24_EXTNUM 19 /* (intlevel 4) */ +#define XCHAL_INT25_EXTNUM 20 /* (intlevel 4) */ +#define XCHAL_INT26_EXTNUM 21 /* (intlevel 5) */ +#define XCHAL_INT27_EXTNUM 22 /* (intlevel 3) */ +#define XCHAL_INT28_EXTNUM 23 /* (intlevel 4) */ +#define XCHAL_INT30_EXTNUM 24 /* (intlevel 4) */ +#define XCHAL_INT31_EXTNUM 25 /* (intlevel 5) */ + + +/*---------------------------------------------------------------------- + EXCEPTIONS and VECTORS + ----------------------------------------------------------------------*/ + +#define XCHAL_XEA_VERSION 2 /* Xtensa Exception Architecture + number: 1 == XEA1 (old) + 2 == XEA2 (new) + 0 == XEAX (extern) or TX */ +#define XCHAL_HAVE_XEA1 0 /* Exception Architecture 1 */ +#define XCHAL_HAVE_XEA2 1 /* Exception Architecture 2 */ +#define XCHAL_HAVE_XEAX 0 /* External Exception Arch. */ +#define XCHAL_HAVE_EXCEPTIONS 1 /* exception option */ +#define XCHAL_HAVE_HALT 0 /* halt architecture option */ +#define XCHAL_HAVE_BOOTLOADER 0 /* boot loader (for TX) */ +#define XCHAL_HAVE_MEM_ECC_PARITY 0 /* local memory ECC/parity */ +#define XCHAL_HAVE_VECTOR_SELECT 1 /* relocatable vectors */ +#define XCHAL_HAVE_VECBASE 1 /* relocatable vectors */ +#define XCHAL_VECBASE_RESET_VADDR 0x40000000 /* VECBASE reset value */ +#define XCHAL_VECBASE_RESET_PADDR 0x40000000 +#define XCHAL_RESET_VECBASE_OVERLAP 0 + +#define XCHAL_RESET_VECTOR0_VADDR 0x50000000 +#define XCHAL_RESET_VECTOR0_PADDR 0x50000000 +#define XCHAL_RESET_VECTOR1_VADDR 0x40000400 +#define XCHAL_RESET_VECTOR1_PADDR 0x40000400 +#define XCHAL_RESET_VECTOR_VADDR 0x40000400 +#define XCHAL_RESET_VECTOR_PADDR 0x40000400 +#define XCHAL_USER_VECOFS 0x00000340 +#define XCHAL_USER_VECTOR_VADDR 0x40000340 +#define XCHAL_USER_VECTOR_PADDR 0x40000340 +#define XCHAL_KERNEL_VECOFS 0x00000300 +#define XCHAL_KERNEL_VECTOR_VADDR 0x40000300 +#define XCHAL_KERNEL_VECTOR_PADDR 0x40000300 +#define XCHAL_DOUBLEEXC_VECOFS 0x000003C0 +#define XCHAL_DOUBLEEXC_VECTOR_VADDR 0x400003C0 +#define XCHAL_DOUBLEEXC_VECTOR_PADDR 0x400003C0 +#define XCHAL_WINDOW_OF4_VECOFS 0x00000000 +#define XCHAL_WINDOW_UF4_VECOFS 0x00000040 +#define XCHAL_WINDOW_OF8_VECOFS 0x00000080 +#define XCHAL_WINDOW_UF8_VECOFS 0x000000C0 +#define XCHAL_WINDOW_OF12_VECOFS 0x00000100 +#define XCHAL_WINDOW_UF12_VECOFS 0x00000140 +#define XCHAL_WINDOW_VECTORS_VADDR 0x40000000 +#define XCHAL_WINDOW_VECTORS_PADDR 0x40000000 +#define XCHAL_INTLEVEL2_VECOFS 0x00000180 +#define XCHAL_INTLEVEL2_VECTOR_VADDR 0x40000180 +#define XCHAL_INTLEVEL2_VECTOR_PADDR 0x40000180 +#define XCHAL_INTLEVEL3_VECOFS 0x000001C0 +#define XCHAL_INTLEVEL3_VECTOR_VADDR 0x400001C0 +#define XCHAL_INTLEVEL3_VECTOR_PADDR 0x400001C0 +#define XCHAL_INTLEVEL4_VECOFS 0x00000200 +#define XCHAL_INTLEVEL4_VECTOR_VADDR 0x40000200 +#define XCHAL_INTLEVEL4_VECTOR_PADDR 0x40000200 +#define XCHAL_INTLEVEL5_VECOFS 0x00000240 +#define XCHAL_INTLEVEL5_VECTOR_VADDR 0x40000240 +#define XCHAL_INTLEVEL5_VECTOR_PADDR 0x40000240 +#define XCHAL_INTLEVEL6_VECOFS 0x00000280 +#define XCHAL_INTLEVEL6_VECTOR_VADDR 0x40000280 +#define XCHAL_INTLEVEL6_VECTOR_PADDR 0x40000280 +#define XCHAL_DEBUG_VECOFS XCHAL_INTLEVEL6_VECOFS +#define XCHAL_DEBUG_VECTOR_VADDR XCHAL_INTLEVEL6_VECTOR_VADDR +#define XCHAL_DEBUG_VECTOR_PADDR XCHAL_INTLEVEL6_VECTOR_PADDR +#define XCHAL_NMI_VECOFS 0x000002C0 +#define XCHAL_NMI_VECTOR_VADDR 0x400002C0 +#define XCHAL_NMI_VECTOR_PADDR 0x400002C0 +#define XCHAL_INTLEVEL7_VECOFS XCHAL_NMI_VECOFS +#define XCHAL_INTLEVEL7_VECTOR_VADDR XCHAL_NMI_VECTOR_VADDR +#define XCHAL_INTLEVEL7_VECTOR_PADDR XCHAL_NMI_VECTOR_PADDR + + +/*---------------------------------------------------------------------- + DEBUG MODULE + ----------------------------------------------------------------------*/ + +/* Misc */ +#define XCHAL_HAVE_DEBUG_ERI 1 /* ERI to debug module */ +#define XCHAL_HAVE_DEBUG_APB 1 /* APB to debug module */ +#define XCHAL_HAVE_DEBUG_JTAG 1 /* JTAG to debug module */ + +/* On-Chip Debug (OCD) */ +#define XCHAL_HAVE_OCD 1 /* OnChipDebug option */ +#define XCHAL_NUM_IBREAK 2 /* number of IBREAKn regs */ +#define XCHAL_NUM_DBREAK 2 /* number of DBREAKn regs */ +#define XCHAL_HAVE_OCD_DIR_ARRAY 0 /* faster OCD option (to LX4) */ +#define XCHAL_HAVE_OCD_LS32DDR 1 /* L32DDR/S32DDR (faster OCD) */ + +/* TRAX (in core) */ +#define XCHAL_HAVE_TRAX 1 /* TRAX in debug module */ +#define XCHAL_TRAX_MEM_SIZE 16384 /* TRAX memory size in bytes */ +#define XCHAL_TRAX_MEM_SHAREABLE 1 /* start/end regs; ready sig. */ +#define XCHAL_TRAX_ATB_WIDTH 32 /* ATB width (bits), 0=no ATB */ +#define XCHAL_TRAX_TIME_WIDTH 0 /* timestamp bitwidth, 0=none */ + +/* Perf counters */ +#define XCHAL_NUM_PERF_COUNTERS 2 /* performance counters */ + + +/*---------------------------------------------------------------------- + MMU + ----------------------------------------------------------------------*/ + +/* See core-matmap.h header file for more details. */ + +#define XCHAL_HAVE_TLBS 1 /* inverse of HAVE_CACHEATTR */ +#define XCHAL_HAVE_SPANNING_WAY 1 /* one way maps I+D 4GB vaddr */ +#define XCHAL_SPANNING_WAY 0 /* TLB spanning way number */ +#define XCHAL_HAVE_IDENTITY_MAP 1 /* vaddr == paddr always */ +#define XCHAL_HAVE_CACHEATTR 0 /* CACHEATTR register present */ +#define XCHAL_HAVE_MIMIC_CACHEATTR 1 /* region protection */ +#define XCHAL_HAVE_XLT_CACHEATTR 0 /* region prot. w/translation */ +#define XCHAL_HAVE_PTP_MMU 0 /* full MMU (with page table + [autorefill] and protection) + usable for an MMU-based OS */ +/* If none of the above last 4 are set, it's a custom TLB configuration. */ + +#define XCHAL_MMU_ASID_BITS 0 /* number of bits in ASIDs */ +#define XCHAL_MMU_RINGS 1 /* number of rings (1..4) */ +#define XCHAL_MMU_RING_BITS 0 /* num of bits in RING field */ + +#endif /* !XTENSA_HAL_NON_PRIVILEGED_ONLY */ + + +#endif /* _XTENSA_CORE_CONFIGURATION_H */ + diff --git a/components/newlib/lib/extracted/romsyms b/components/newlib/lib/extracted/romsyms new file mode 100644 index 000000000..61a10cdfb --- /dev/null +++ b/components/newlib/lib/extracted/romsyms @@ -0,0 +1,639 @@ +abort +abs +__adddf3 +__any_on +app_gpio_arg +app_gpio_handler +__ascii_wctomb +asctime +asctime_r +asiprintf +_asiprintf_r +asniprintf +_asniprintf_r +asnprintf +_asnprintf_r +asprintf +_asprintf_r +atoi +_atoi_r +atol +_atol_r +__b2d +_Balloc +_Bfree +_bss_end +_bss_start +btdummy_bss +btdummy_text +bzero +cache_flash_mmu_set +Cache_Flush +Cache_Read_Disable +Cache_Read_Enable +Cache_Read_Init +cache_sram_mmu_set +calloc +_calloc_r +check_pos +_cleanup +_cleanup_r +close +_close_r +__copybits +creat +ctime +ctime_r +__d2b +_data_end +_data_start +_daylight +_DebugExceptionVector +debug_timer +debug_timerfn +div +__divdf3 +__divsi3 +_DoubleExceptionVector +__dummy_lock +__dummy_lock_try +environ +__env_lock +__env_unlock +eprintf +eprintf_init_buf +eprintf_to_host +__eqdf2 +est_get_printf_buf_remain_len +est_reset_printf_buf_len +_etext +ets_aes_crypt +ets_aes_set_endian +ets_aes_setkey_dec +ets_aes_setkey_enc +ets_aes_start +ets_aes_stop +ets_bigint_disable +ets_bigint_enable +ets_bigint_mod_mult_getz +ets_bigint_mod_mult_prepare +ets_bigint_mod_power_getz +ets_bigint_mod_power_prepare +ets_bigint_montgomery_mult_getz +ets_bigint_montgomery_mult_prepare +ets_bigint_mult_getz +ets_bigint_mult_prepare +ets_bigint_wait_finish +ets_delay_us +ets_efuse_get_8M_clock +ets_efuse_get_spiconfig +ets_efuse_program_op +ets_efuse_read_op +ets_efuse_start +ets_efuse_stop +ets_external_printf +ets_get_cpu_frequency +ets_get_detected_xtal_freq +ets_get_xtal_scale +ets_install_external_printf +ets_install_putc1 +ets_install_putc2 +ets_install_uart_printf +ets_intr_count +ets_intr_lock +ets_intr_unlock +ets_isr_attach +ets_isr_mask +ets_isr_unmask +ets_post +ets_printf +ets_readySet_ +ets_run +ets_secure_boot_check +ets_secure_boot_check_finish +ets_secure_boot_check_start +ets_secure_boot_finish +ets_secure_boot_hash +ets_secure_boot_obtain +ets_secure_boot_rd_abstract +ets_secure_boot_rd_iv +ets_secure_boot_start +ets_set_appcpu_boot_addr +ets_set_idle_cb +ets_set_startup_callback +ets_set_user_start +ets_sha_finish +ets_sha_init +ets_sha_start +ets_sha_stop +ets_sha_update +ets_startup_callback +ets_task +ets_timer_arm +ets_timer_arm_us +ets_timer_disarm +ets_timer_done +ets_timer_handler_isr +ets_timer_init +ets_timer_setfn +ets_uart_printf +ets_unpack_flash_code +ets_update_cpu_frequency +ets_waiti0 +_exit_r +fclose +_fclose_r +fflush +_fflush_r +FilePacketSendDeflatedReqMsgProc +FilePacketSendReqMsgProc +_findenv_r +fiprintf +_fiprintf_r +fiscanf +_fiscanf_r +__fixdfsi +__fixunsdfsi +FlashDwnLdDeflatedStartMsgProc +FlashDwnLdParamCfgMsgProc +FlashDwnLdStartMsgProc +FlashDwnLdStopDeflatedReqMsgProc +FlashDwnLdStopReqMsgProc +__floatsidf +__floatunsidf +__fpclassifyd +__fp_lock_all +fprintf +_fprintf_r +__fp_unlock_all +fputwc +__fputwc +_fputwc_r +free +_free_r +fscanf +_fscanf_r +_fstat_r +_fwalk +_fwalk_reent +__gedf2 +_GeneralException +__get_current_time_locale +_getenv_r +__gethex +_getpid_r +__getreent +_gettimeofday_r +__gettzinfo +GetUartDevice +_global_impure_ptr +gmtime +gmtime_r +gpio_init +gpio_input_get +gpio_input_get_high +gpio_intr_ack +gpio_intr_ack_high +gpio_intr_handler_register +gpio_intr_pending +gpio_intr_pending_high +gpio_matrix_in +gpio_matrix_out +gpio_output_set +gpio_output_set_high +gpio_pad_unhold +gpio_pending_mask +gpio_pending_mask_high +gpio_pin_intr_state_set +gpio_pin_wakeup_disable +gpio_pin_wakeup_enable +gpio_register_get +gpio_register_set +__gtdf2 +gTxMsg +__hexdig_fun +__hexnan +__hi0bits +__i2b +intr_matrix_set +iprintf +_iprintf_r +isalnum +isalpha +isascii +_isatty_r +isblank +iscanf +_iscanf_r +iscntrl +isdigit +isgraph +islower +isprint +ispunct +isspace +isupper +itoa +__itoa +_KernelExceptionVector +_kill_r +labs +ldiv +__ledf2 +_Level2FromVector +_Level2Vector +_Level3FromVector +_Level3Vector +_Level4FromVector +_Level4Vector +_Level5FromVector +_Level5Vector +_LevelOneInterrupt +_link_r +lldesc_build_chain +lldesc_num2link +lldesc_set_owner +__lo0bits +__locale_charset +__locale_cjk_lang +localeconv +_localeconv_r +__locale_mb_cur_max +__locale_msgcharset +localtime +localtime_r +_lock_acquire +_lock_acquire_recursive +_lock_close +_lock_close_recursive +_lock_init +_lock_init_recursive +_lock_release +_lock_release_recursive +_lock_try_acquire +_lock_try_acquire_recursive +longjmp +_lseek_r +__lshift +__ltdf2 +main +malloc +_malloc_r +__mcmp +MD5Final +MD5Init +MD5Update +md5_vector +__mdiff +memccpy +memchr +memcmp +memcpy +MemDwnLdStartMsgProc +MemDwnLdStopReqMsgProc +memmove +MemPacketSendReqMsgProc +memrchr +memset +mktime +mmu_init +_mprec_log10 +__muldf3 +__multadd +__multiply +multofup +mz_adler32 +mz_crc32 +mz_free +nanf +__nedf2 +_NMIExceptionVector +open +_open_r +__pow5mult +printf +_printf_common +_printf_float +_printf_i +_printf_r +print_rom_meminfo +qsort +_raise_r +rand +rand_r +__ratio +RcvMsg +read +_read_r +realloc +_realloc_r +RecvBuff +recv_packet +_rename_r +_ResetHandler +_ResetVector +_rom_store +_rom_store_table +roundup2 +rtc_boot_control +rtc_get_reset_reason +rtc_get_wakeup_cause +rtc_select_apb_bridge +__s2b +sbrk +_sbrk_r +scanf +_scanf_chars +_scanf_float +_scanf_i +_scanf_r +__sccl +__sclose +SelectSpiFunction +SelectSpiQIO +SendMsg +send_packet +__seofread +setjmp +setlocale +_setlocale_r +sf_dump +__sflush_r +__sfmoreglue +__sfp +__sfp_lock_acquire +__sfp_lock_release +__sfputs_r +__sfvwrite_r +__sinit +__sinit_lock_acquire +__sinit_lock_release +sip_alloc_to_host_evt +sip_get_ptr +sip_get_state +sip_init_attach +sip_install_rx_ctrl_cb +sip_install_rx_data_cb +sip_post_init +sip_reclaim_from_host_cmd +sip_reclaim_tx_data_pkt +siprintf +_siprintf_r +sip_send +sip_to_host_chain_append +sip_to_host_evt_send_done +siscanf +_siscanf_r +slc_add_credits +slc_enable +slc_from_host_chain_fetch +slc_from_host_chain_recycle +slc_has_pkt_to_host +slc_init_attach +slc_init_credit +slc_reattach +slc_select_tohost_gpio +slc_select_tohost_gpio_mode +slc_send_to_host_chain +slc_set_host_io_max_window +slc_to_host_chain_recycle +__smakebuf_r +sniprintf +_sniprintf_r +snprintf +_snprintf_r +software_reset +software_reset_app_cpu +software_reset_pro_cpu +spi_cache_sram_init +SPIClkConfig +SPI_Common_Command +SPI_Encrypt_Write +SPIEraseArea +SPIEraseBlock +SPIEraseChip +SPIEraseSector +spi_flash_attach +SPILock +SPIMasterReadModeCnfig +SPIParamCfg +SPI_Prepare_Encrypt_Data +SPIRead +SPIReadModeCnfig +SPIUnlock +SPIWrite +SPI_Write_Encrypt_Disable +SPI_Write_Encrypt_Enable +sprintf +_sprintf_r +__sprint_r +srand +__sread +__srefill_r +sscanf +_sscanf_r +__sseek +__ssprint_r +__ssputs_r +__ssrefill_r +__ssvfiscanf_r +__ssvfscanf_r +__stack +__stack_app +_stack_sentry +_stack_sentry_app +_start +start_tb_console +_stat_r +_stext +strcasecmp +strcasestr +strcat +strchr +strcmp +strcoll +strcpy +strcspn +strdup +_strdup_r +strftime +strlcat +strlcpy +strlen +strlwr +strncasecmp +strncat +strncmp +strncpy +strndup +_strndup_r +strnlen +strrchr +strsep +strspn +strstr +strtod +_strtod_r +strtof +__strtok_r +strtok_r +strtol +_strtol_r +strtoul +_strtoul_r +strupr +__subdf3 +__submore +_sungetc_r +_svfiprintf_r +__svfiscanf_r +_svfprintf_r +__svfscanf +__svfscanf_r +__swbuf +__swbuf_r +__swrite +__swsetup_r +_SyscallException +syscall_table_ptr_app +syscall_table_ptr_pro +_system_r +tdefl_compress +tdefl_compress_buffer +tdefl_compress_mem_to_heap +tdefl_compress_mem_to_mem +tdefl_compress_mem_to_output +tdefl_get_adler32 +tdefl_get_prev_return_status +tdefl_init +tdefl_write_image_to_png_file_in_memory +tdefl_write_image_to_png_file_in_memory_ex +time +__time_load_locale +times +_times_r +_timezone +tinfl_decompress +tinfl_decompress_mem_to_callback +tinfl_decompress_mem_to_heap +tinfl_decompress_mem_to_mem +toascii +tolower +toupper +__truncdfsf2 +__tzcalc_limits +__tz_lock +tzset +_tzset_r +__tz_unlock +uartAttach +uart_baudrate_detect +uart_buff_switch +UartConnCheck +UartConnectProc +UartDev +uart_div_modify +UartDwnLdProc +UartGetCmdLn +Uart_Init +UartRegReadProc +UartRegWriteProc +uart_rx_intr_handler +uart_rx_one_char +uart_rx_one_char_block +uart_rx_readbuff +UartRxString +UartSetBaudProc +UartSpiAttachProc +UartSpiReadProc +uart_tx_flush +uart_tx_one_char +uart_tx_one_char2 +uart_tx_switch +uart_tx_wait_idle +__udivdi3 +__ulp +__umoddi3 +ungetc +_ungetc_r +_unlink_r +__unorddf2 +user_code_start +_UserExceptionVector +utoa +__utoa +vasiprintf +_vasiprintf_r +vasniprintf +_vasniprintf_r +vasnprintf +_vasnprintf_r +vasprintf +_vasprintf_r +VerifyFlashMd5Proc +vfiprintf +_vfiprintf_r +vfiscanf +_vfiscanf_r +vfprintf +_vfprintf_r +vfscanf +_vfscanf_r +viprintf +_viprintf_r +viscanf +_viscanf_r +vprintf +_vprintf_r +vscanf +_vscanf_r +vsiprintf +_vsiprintf_r +vsiscanf +_vsiscanf_r +vsniprintf +_vsniprintf_r +vsnprintf +_vsnprintf_r +vsprintf +_vsprintf_r +vsscanf +_vsscanf_r +wcrtomb +_wcrtomb_r +_wctomb_r +_WindowOverflow12 +_WindowOverflow4 +_WindowOverflow8 +_WindowUnderflow12 +_WindowUnderflow4 +_WindowUnderflow8 +write +_write_r +xthal_bcopy +xthal_copy123 +xthal_get_ccompare +xthal_get_ccount +xthal_get_interrupt +xthal_get_intread +xthal_memcpy +xthal_set_ccompare +xthal_set_intclear +_xtos_alloca_handler +_xtos_cause3_handler +_xtos_c_wrapper_handler +_xtos_ints_off +_xtos_ints_on +_xtos_l1int_handler +_xtos_p_none +_xtos_restore_intlevel +_xtos_return_from_exc +_xtos_set_exception_handler +_xtos_set_interrupt_handler +_xtos_set_interrupt_handler_arg +_xtos_set_intlevel +_xtos_set_min_intlevel +_xtos_set_vpri +_xtos_syscall_handler +_xtos_unhandled_exception +_xtos_unhandled_interrupt diff --git a/components/newlib/lib/fixlibc.sh b/components/newlib/lib/fixlibc.sh new file mode 100755 index 000000000..5a9e3fd00 --- /dev/null +++ b/components/newlib/lib/fixlibc.sh @@ -0,0 +1,23 @@ +#!/bin/bash + +ROMELF=~/esp8266/esp32/rom_image/eagle.pro.rom.out + +rm -rf extracted +mkdir extracted +cd extracted +mkdir inrom +ar x ../libc.a +cp ../libc.a ../libc-minusrom.a + +nm $ROMELF | grep -e ' [TB] ' | cut -d ' ' -f 3- > romsyms + +for x in *.o; do + nm $x | grep -e ' [TB] ' | cut -d ' ' -f 3- | while read a; do + if [ -e "$x" ] && cat romsyms | grep -q '^'$a'$'; then + echo "$a found in rom" + mv $x inrom + ar -d ../libc-minusrom.a $x + fi + done +done + diff --git a/components/newlib/lib/libc-minusrom.a b/components/newlib/lib/libc-minusrom.a new file mode 100644 index 0000000000000000000000000000000000000000..6f593d0587f8f120614ce47a1be4908ae5bbb1ff GIT binary patch literal 3675626 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� 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
vMT%>I&g88VSfiq!?45* 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 rFllx4=V+C=`&vto8$ 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%0ATLu?{ylEZ8F| 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 z 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
}6s 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

8vccfXGjur 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 z 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 literal 0 HcmV?d00001 diff --git a/components/newlib/lib/libc.a b/components/newlib/lib/libc.a new file mode 100644 index 0000000000000000000000000000000000000000..263a4d8858e9b21e8e7075b6fcafbf8780c0826b GIT binary patch literal 3699654 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μ`+CiY~8XwS!22+GU-k0Si_hmblIArCHtt5dr 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í&hXp8F? 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 vaHRlr6tFRyG)Nog?@aZSvu@JtyL zm_y|ig{}sa^Fq#>RWbkEa$FQ%asHgDyyE=QGR9*hF6DSZR#h=0uMEc#)lAkA#K1Zu zX|u&KZWx+FTzExQsPjdP*(<21tgM)ii<0LKfngk#khx;H&Nt<1njKR~vF;HL%qc8I z6H|(~VvDcXOCJC8isz!_hFm%>Iw0D!Yp<^7M!R4{+|21HyRtdaF4Lo3M!?}-JhP%p z!Q9faDrRz~J#&b%bWS02VM@EIw7e+K9GO;Df!5qs`MkNfRuSg((@Q`5_WI${CVOr3y+4^fZMh|Mu$%*?-dM<+ z!le$UkKjf-1%wYz!^CM(R(#h|mk2yKNdvc>)aw=Tv^Ft^%%56VaYnT0&#zICN zemUnx9r9ARl=Gt~H#%f|9yju-N=}w@%@3&D=#c5s4*OwnqeEtvDQ9QKCXQEw{b1^_ zy9SSQ=NDFPbjTQ0W8}{(Ia$ujYf4U*w0!`Ua{Cb6+Sy^3TB!r=!J@n=AuDigJX7=J^F*42ff|(5RHZWc8>|N8zF?-ZVys0SIwocBDLfjahEM>)xx)|?f z?6AYGltU3%%J52XKd19JxSQkm!ICfb8Spzf`-uv(?}Oy)q?0oZ>`Wl}Vn+zMe)*xB z8+FKXJ+d!H7G%tCF__&B$d7>~4eSnbo|7L3OCI@UoEvSDQA8#zJ3(@zoGfio3NApV zpYq0FiI+VbDPz1BD;<747CC#$Bb!Et-`=_L7+K^cU`cZ+xDSrgCVO^pqdvJ6T*~>i zo*U)lPH-vbw|H)pljYjv_-(Pzuk#r=PJNEs7CArFOL{tixzP?;>NdMGa-*Cq<-=~G z+$bl@`JD_F`}~YAzXcqFia(PEeq86quw=SS8^85)qn|A2j^FyDkWuF$u-`E|4GGH^ za)$kfS68dx(@Iy|@OA6j&FflORF>bhu&7`z?z<}U%ZutsN@o^VU_7-snqN>*Sv0TS zVccQW^XGrV%4**rD&xm)XBEltx=yPoFX#Pl*9Ck`&F^ZXH7Q$A)wK+_i8h(=%&M%I z#X>lB<5`g{_&->0&6F$*@UFy{~5&@65GuaOod*ihsf>{(@8dSDfPK-HB|pccpmX(tq74{+mwmuRX=T z1%96Et!O>CzTEaxjz4;e|EH(;pE<>U;1vI%Q~a-=;(zxP|0k#T|8|O>chs^mzjF6X z8U3DFI$)aTo?p5S8_*jMG3H%VUS84c!s71mnrCc2GZ&g?u(<_=#XYDsx6A?_@hlic zr&e6Lpb&4mpjTF9&CD#a?sVrbES+bAO?L;>tGLr%LAfV)S*g!GG}>1h@I&nO$K)NzxSUzMysPuE8OFx?=~I>7 z=PtPwl=GGY+e+-db_TsQWd4+6V_oyLH|VV=yUT9_xw)0!OKxGAb7T}uB+va`8|?CSP2l`P5SvM$W6}`nV+ua?GqhOvp>STi1 z=b4-g<_w}_p0dvz(+<1*Q_gDB0BK}8Ct^R(F$W9`CqpL-Iy^@137+D(7r4lAUoa62}}`veYr($gENP zL&qFWw_EWGir-QEH^=cP+`ibE7sks870DC8d~+krc~@9&--o-!@o~66A-k{~gD3hg zIh_yTe(mH_VAF@k6zWU`XE-hdXF4tcUr0t=9LP4T4N>aZM+I$jEX$8imKbja#3FXJ3f1z+iydAY_h z^RiOOZ&UJn$%vPo?0LVyco|pFG2_Zo@*YZlIT>Nu;ht}p7?$xCI%d4Hoen$e-|Xbf z*N+{uOm;YCnf%)6^UcDT1Z$s9l9xGV2mEr!>~_xqc1#1`9Np@e`g~&~>AAyk3G8oh z90mWtaVD6fu4#uO1D8*7uki)TCD1ot|}J>k|U`D({^!d>t9X1Mo~X$%`V?0$E)f*CJ=7v6Hb z6Yl#;{+Z*i;GT4R94`CmGc3FLw;{v+3dqUfwg7DBIi0a^bDYjf$jRY$M#al@I(*AN z&oSTZFLS&G?j4SKPqEH1-;z8*M!aiaiY#km?{zx-4d-t?)5+hQLyj5t7#U&LA}l%F z-lj+9ci`887T6hzsTWyrMp*y>IWBZ~W<}oZQEZAHEl%fi=#b^Q+vMaYASX*b{4wPS%X^9)j`^nkDKg^n z&<2nt@B5t&-}t}km|u_Hb^1Z*ljR(J;^b_r$&#LAgrWUp$jNd&asV&oDUg$;OgcDu z1ah+28Q|p2Aty^ZhfC8k}vYeyaoxB6&WRY)o^3ITxMgB`C&w`vRu-z&0|+c3&uhvk#& znCoaybj-K>)5)+o3}MMq4vU-)zs%hr`f!&k`6kEwvbaSt$Lum*ev#TmhW(MSPZs-6 zIXQoG$>9vtZEOc9M_ArdaoTT&od6xO)ZurXdOCTppdA6k-Y2dwQ2d7g89kQIe^PGGZ~E(WX`uaGj``Jdw_|=iecCahtSqkoUS^-Y0Wb1jf4v_Q~On_8gs0Idu5-w4dS$j(PulnPYxE&2zj0ZV4GSm%=7F z+{xOU=j1hzlf%4`#J1GQS3pjd`?1?8M;h*h%bhk?LWe9iw>$Y7$jOp^4zy-iezo1_ zbk;(LEMX5h9e&N_4B^x#zoGaY#a}t*7vCi8OwW4QB!@fOytJeocKF4Y^Er|EC73&z z&lDpa^Xu;vGVE-C9dfvfwKLu6@T+j8)43NqWYM|C>F{gubxvmsbjWgFeWTL3)9Gx3 z4ms@J9dRxqrj2$Uayr|gLl&LAPKRHM_bL8`V_wTIl98942uqf*Z#elb$jOp6&c@7m z`TW=hJ9$qszNS0o*XXWf*nARU$&z>6MXPx{oOMI2%E8)&}%;(nY$VkuIh?gw&`<)1@Nma^h( z8kC=aoGfJ(p&T~({NBtlpTS!wc^k)_;AT6H!X4w7&*oFfuxdc|Lvs$Hp(y!hC%o z%*R@>$wx{_1JmO>1OKowJ)+-5aUaFmibp8UReYJ^0>u@I=PABQ@iN7$6yKxx2a12J z_$kHDD}G-wpF<>%L6oU5=QR*cSKLuC-;;J1ORSd(km7IJmGQl)PN=LdDlBUZwbM z#m_5#Me#d|`L15l5Qpb~;l_$vEAFhgx8lKy$0(kvxLmR6_384<_x}>_M#Vo?{Dk8D zihrZ{sNz2EX4yA&sKbmV!oq@rC;#_iXT(_bH)7DAYoru+yKwW zBIo-A;ckjAP|SA_qBBl$zG5!1Bs!hZkO}uvJV-IW5r|Hn;)RNrDdu+p(chr>0mXc_ z6`jM1-%l^K zEBRxJf1~(ArT;g@&GFkVX=tms6WOJqr;_(p@&QVoqvWHNe7ut9EBQ>tS1abTlBDMj z#p}r~J)E^obnaL3pD6j$ieFI7XCDdsq2f=-&i)A{r>@AuWOu%LE51{lj8k~KT!Oc;ud&-k+{xPJX!J8iq|UU8fp^u zfZ}6{o8o~)>S24uy%dj8T%x#I@x6+FrubFGUn*|dxGvr-#UmBZRlG(q>$Ln1;#Mfe ztnMO55yqIG*+kw(aYw~n6w5OmL|!i?&sIE0@p#3P6&ENjRyV0lTNOW~_z}gs74KDiK=DDvZzz6C@gEg`r1&evKD0ZM&IHALeik|BuM=*j zxV_@D757nmq2fV`hbrc`alO3esM!3G;`nC&Rq?}$A65KQ#ZM{zrQ%;Jens)? zir-eueh-pchP=91lF^B%>U6m#UO=sc+S5yg)yep>Ofihrf}kmBDd zenT<)c1XM*DCPpbBKP4Ph;X7}zHbqEL~(P)8H%wGTTH*RV)pA0JG~Y2U5&`u7gYFS z#av5Rf#UCmDMDZ7jzfv5;J3Xie1YO@#X}Xd&xzO>r+A{`0>#CO%N6szsMuMknEh8ozD)6Q#j6y5U-3PP zH!0qs_$P{gs`x3zzfjD6Es`Gg{}w*1_)W#{DCT=t(f>s87mB}99Kw4`(N9v`NO2Rz ztrT;)5edsaI>Mb5_fX8fH=@J7H^KuIU!r(~V)oAw{V9s4DW0x)mf|YK*C^&n5n_|? ziiO$NN0@6N39nULtM~_s*?&m%*>6YqQN`@TBl2ey?^n!zJEHSD#q7^7@?(nsr1;N@ zzf}CS;&{A|6+2q#dj&*q~-wu{llgbj9-(U#0ju#r$3)cDNLa@S6XRy*B}~qPqI^tGdr=8cs7G z83d%6WNw;KM380@P!wcFF-=1^&=F{)o52}yLZb;dV=&+pjge>^;z-0LY*KIc{t?Yq*W!j)uD!9$N z7(UeS5r$_OKHBgC!;1_rGrYp^iH1)#{6oX%8@|l&PYhpc_~(XiHvB8Y_Zoh{@Gir@ zHT*Bidu@V$l~G5omUrwu=E_>YEPGyIm} z_Y8k&7(>s{w}pm_3}a^+blMp1Xt;~v0fvVd9$|Qt;X@4{VR(k&IfmyMt~9*V@NtGu zFno&PGYp??_@Q(~%Z1^(6R~r7Q z;q8WhY4}dVI}AT)_)){ZHT;a>mkj^O@EeBTHvFOCPYi!)7#D20{cbp8xP{?XhC3MU zWVnanK86PxKEUuHh7UD7)$mNi-!nYlaJAv3hF2Os-tbz(ryD-k@J7R14PRyWM#Hxl zzSr;rhMzM0wBbF5-!%MJ!yg&`TpWCVeP!hNdZ8lh(?*7y7;bI2o#C#Adl>F-c(CDv z4UaZF(eUAhXBs}raE0M2!^;e>Fnqk>lMSD4c!S|hhA%R_#qc)6KQp}D@U4dLFnq7! z2Mqtl@RNq0HTib2R~tUV@Y#khG5ll0R~r7Q;q8WhY4|R~zc&1k;l~XB z*6=fiUo!kB!*3XV+wg~mKQa8JVO;HoeXZ|e<+!oo_J)fMcQ@SI@F2rO4UaNB&hQb2 zry4%maJk{dhL;#V+3-5U8w{Uo_+rDC8NR~sHHL3Ae2d|`4FB5jZw)_VSdUMmSabRW zT^i@?Idur;`k!rKzsQ6k$9e>mV@*fp*u6I-dm{q&S1ml_cLkPdi}U>j>+!ksy8`Rc zp!59&QziVaz?#a8PWG&+6X$mYxqd2~PcWGG?eMz-7bV?#R2^C9A6 zJRc#(h6?@Z;%d)x#5JCe7O(Vtj2Ig#^zjk6&NJ^Fp5+-of#-R~M<6y-=$|Uy?0KE| zYR~u%#BK_m4dP#VzEFI-XY5aRc)m)E-4yyi6+hLbrDi~sKVeeqYGKN6>PB0(QNg&EJh6WQGJ=i=6${~_++89UZ4 zp7X^$J@a00KhL~FIm~k_@i@=z#gjcBD8|1Ybr`N?f#-w8OFd(|imenn_@=^74veqF zA9$W3zR2@b@m9~%#n*VADaIy>w47gm>G^u`?VhnY-QoFHV*KQwf2WqGJwGab(KGg> zfAWlvsXu#uU;K{e55(9(k`>Xp0O>( z4hlKvzfPXJiLrx1j-6>=&-kVq=()cbn<#XKh(~(HZx!zkA|D|>%roc9BR!82&+G>!zc2nrg6|eJLF2-&OIesS3^Sn^Z`-#XGi#K~d zR*Vf5@@3*{JlBeU?s=scdn$BJ7T@l9op^_5&eIQg-Xwm^Gk&+8@{G?dY_7=XI`K=M zZxFxg`BpLZSLoa!e$Vq=;*UJ<6l05p4)(BLd45ow){i;zhsD@s!H^G1Dh_mulUEFvBSN>Gru9c8;cIV727@I zV->%h$g!Wj)APyVdp+}8@sMZyus-e?o7vxa#%J2|o;k(@A)gw zr-*lWK27|9XU-XqdFDLvl;C?4qxs1Z6$9G*$9%~%$LOn` z@kRC*&wmv2?lXB}oB5Gvj@`d|enb3~=l8_eYoY&7G4DacdD`dAJ*UL2JvR{Jn-?AI zG`n~%68H4nM2zhgI?cp`J+}}azQNyIL{Nr_@1IHj{B26A0a-?^Az#fo~Ma_4k>~zmY`2he9=gIazU8jitqJ&h?w`#(ZP?xG@JIKDE%fOw3od;48)5JY%EU+cP$*{XJhV z#t%07cZo-PeoTC*=f}lIdVW`oe{A$W5c7ULj6G?U=K_sWd~hKz6d&igkr-Pq zJvS3$>xCRU)3ZHu-ujW}w&IICV}JT%&)vjVcUp5J)-!$}j`xg>CpKNA9WOq^Gk))W;F)v7CeQf9yTtR+;>$f_ z?|GGH>^*UPf{Nz3D`6@BCUex(#;y-!* zx%khXIZwRnd58ET&)9YT-Shoo?7PV4X>kM3e->lkg&co+Ej?qi+1B$v#T`92(ip+M z3;iN-Z_oJB8{!%J%@Lkki^q7z2gXFt9P5)kW6L?ib06{1p0Vr1){C-A#fv--5HIyS zNW9uJ=Z2F#G^yy zwqDc|yUvF^|3r+f7jkSof9LrsF}7aFe=6SX8Qag-J##*I+w+a$4?W}451$yMy;V$z zc^KkDVC}Np^AVmm1m7234VM}oZg_&>>4xVSUSfES;nNLoG`z*|b%vS84|UsVc$eW9 z4DT__oO?)%Z|=a%rw7g&W*$7q`xs^(Jjllyo?>{e;l+mWhY-@PHGHn&OAR}JdfImc z=TFb`Jw}JQ=8)$zhF>xKu3_emgTC{p=ksJPILMj*4cx=8|E7Up^YCK zjx-+>b2 zB*1Qg^lan0qr}HUeq)ta`0B7WIX%`rJ(m$t_^e9bf{~34`RR0)%a8hyKQhASy8f|& zZ3KM(s`=lkH&QyJ8K8wgel|pB+Y{w$Tx;4veL}ye zc`jeAT$rT%ZjxPS2%#PGBp^+h7Q*zCG|#AOJ@V77Yc4-*GC~?*^krw=L#VGq2-~Pj zV75KhP1l*Ss|g`&J5>T(?oDUwzM@A`E|;329T$p28uGY77mvk&4`JJn6u0?pxmj~1 zlF<(OJLGqrIHVCqyObZ-tRaMLS4m*=+o}9YB_qG)ejDTOZY?2=FxsR1?3fALup6=Y zeW3hys$lZNUMJM=5iw~fi}1%ux{nNlTXD9r{NAsF-Z2_Lqa+I<=)EL?4%uAziS&l% zV)b=@PcqVk@SOA*Pa%YDZ%Sa>ans|;aY#Gp$Iy4>5(dlq^W$93Gc2qXM)I2@M37Ken zz(9i+J#e)a3Df!>Ov~(X;2=f}9I&RV-aU60Y z&+p~(RT0r=G*Xq|oP(F~_L2X{mSRIHqIEjs6-LK5Uvu9RdDZdpop$HHmzwfPaU$;9 zsKW>J%U25ej`m3y^JK}!hpt+uXke4l=t=b_eXRfS57asF1jP>Z^+J)5SD4~?b6%>! zJ5tHZYtUJ-{8YMH-#5>T3+_i47p`#I(vw|+G!D`73L88rVTud8ybPzsRAaZx=W^oHqQes?5kzI~OdjQfZSQu&A8uXTd~`jG)Eprdji4-1X%HSie(*IPHdWA+zev!yTvYS>TEJ~%yRNHhb440JE z%~EQN;Z&P+-_;UjFak^W1EVJ8$42Q=*Q^ZB#S<>f;QJ`yq6{_)2{&s}z9vfdKUpcW zGN_{Z9{ri!$pe z^&q%eCWeQ@+036vI|6Q#DM5ZP+&vSL)hg>ibqA(Z?nDJFtZ2Aieyq43(~ z{Yf#2I!AGHoPVV!6G_EUVKc2Uv2hLQ7&ZP>I_IXRT_91?W7EMXvzhE>P-rT1FU8E< zEV&v2&$>yxL489`g+J3j7N2F))QyU?XquvP8ne#})3q;&Gvla99jGs{q{S;;{>lff zmUxQ#AiW~)uA;MjDQ8uTLX`a*l{qn~_-8uTcFjIWnho(?iuB0N zByx^R(am*&Cu-CL^j0_D>6L$7413Ssg-4~A#zdt zyta(ZvIo+eW4e7p_7)>}UF)zC6Zi=!I+_B0q6`uqTUi`SjNKb!G5o_IT24 zb6LNuzI;{N8uMg+ar%~7S~V$Gqi%J*-lTj*l)lY%dXw_iQTkV4Vdi2oxSi8MQRXn3 za|hg{N%{PRQTk2{teRyob4cHXew)mlRDTD%seJ|$r1X7^s^ZK$@B=u;>YBNnJRib% zt4D@gzVxHdiu+`6!JmHYuj0}s0RVMNUT~uK`n=iRm~?Ut1L4W{oj2e{jr$_ zl>7U%x?_Bk@+C_9ENLfXen9>&pg$$UB~JRq6ZC(2riiq!@bUWDndeCR+UJtb&G1W{ zejWYFs1+*)No(5EnufG?QRM1POcr#?JW@?-nxZ>h0)~r8;G#YO_i1fN)ilLzU8{4I z4NW)dh+2E~+tGpPl6oDben|p%%A~>W*vd=dSeN>QPoE{g|JT=rS^`Iz_^MVdv0$hblC)or<4Tbre4#{Wi+Cy?Wu*qxEH-y@Twe3h`P zOdsvG6lQOvvU6RMBGnA_mTyR5N_t+5!9cbp+6&xx*P%^5mGS3VrLy?SOINu_QT8Ni zw$Meg*-oe}a_QS=2T{UeS9aGdc4X;lr`99egvj?@q%_M9PWo6E8JcBkAicyz%Ccv$ zWvPoyhzi-+oHAUa8>q_kKwHimZhuN}qqu1bFJ(Y$PXi6x7&ybL(>#DrTZSM z&WXnbBSo_==Dsp4p*;T9ib3NW9;Q zRaJ^&*ORv?>Zr$-&aS7pSb!l_VW((f zOCI_+YH4&c^}0MvD{AWO3mUhK^PALXs7Dm}g-N+6HARV1n>n>~D7U%EOMTK}pQw9V zjoDmYX{w<|9IkSzHhJyiv-Z(e`^4SbCiQKdR(*9G?(bG@*+BYzOX87jljfmGhn2Ot zWVGAXE}g4qo;p!8SD_#BxH&OVZQai(Yiq}|*T+%wxW9@h7HXe>oz9Uoug#{>(&$_g z`I6I=JX~$-lB-Nk#14%*Ybl7PUXYr0K?-K<7DONAf0Ea2t1uV1H;kiMtU7ARi#APX zje085Sj#E5cU$#O@(|Dp;mB^v;Br0E1SGBCRqVIr`0VSpV ze59&&dH>R(eXEu%49ayCD;D*wUbbM#%F3#Kwa3@~7xT9j-7B}{D{8*~uch~0HRwQE z)o;;)1^>FW-=LDAC4>9v5 zJL>1ks)b_hJ9Y4~x|~=Q7VB8i;jBbD*jvQ;aYNk#>3;|PKc!)w{$uJBi?mzIt83=h zM&%2aR4l3;5LH$!SY8*EFP*=nYFT-0T}540RK8@$po;SOD;GxPH47J(Yis%H1&bqX zt*lzHLa|j9OIAv)ycV6>#WgGHin%K)uc)ky%2!m?u3S>5yM)^66RK!}%cZtT+iR;A zEvs0P& zF?HI+nd8c*OP=&k`5_Z0jf=|F;$<}|rK+w{84&e_S1b*);U8dNC0Ona|pSvfsYt|O(ke0iNJrN$?FkFHrw*DR@7wy4*@7NNVCMT~|_YZIx;a zEUwX&XL&h;J6gGnJzrH>ykKz!LUpDa#L@U8W)zPpc1Kom-=&nQy}qQjxbLFkzLT|L zS-7mG@BEe38VuTJ48-{wS@pTqH!@d>YwgnN+6DCmJ5hP98!LPD9sTCUj2|*&?T7T< z`DxU+MlPtSIksADpI_m6pn6GFl(cG5#nPn}ZitICimKMAV^&wH!USk?fAWtD{{|Rk2JL`js^+b?EA_t5{a)3-u#` zoL5v;=#U&;y(sCEiZ!l6?4RSSv@4cXYD=A}SX-w~IJSI=PDF}SRdF0ELk=IO?2fds zx65Zt(w>Uye-iZb5Ki4@4EHl9HuBUsOU?~Ro=a=AKj$wwmeYh<%1EzXrgB#=;It5q z;3e}HCJJPxTdwlT+M4pksv2!xKA5Vr$I2J1T(Lr@#qtF@NEg+t(0PFYpaLayrvOGz zP*OuGT%RRdS1)j9qEKYj(yA4Us+KKK9!b&VweD09jUO{+SaFX9D{5+M>uPG2^gUvH zaeZXjqQ3o02Iyz4@8E%b7Y!P+u>X+Kg?%flSJWNfGa2D-dcIg^Xns~_yC1^xiOUw& zL^Gz1D<3s_+T=+yrjIM1G;#X4siP)M8&TS5)aZ%&FJ%RHmFL%_4v!;?6N8^J{Cpw6bdcN}Y*T zR4lF9OHxhEOOmY>^XIRqTD8|^b@5*D3Js@4ReNW;q$6luKjF(mALQ11bxic(SGf&>e11kv$WMMVbCUer6PQGlzt=1=>AAwM z5BctGQyXXYu|DMEu*-ye_ttE^ARh-LCg=y-#3)bKjwa;qHJizHW^e05e$?6xFeD6u z7GKMOIbP;`Lm+N1J^ZQKoSfacTZdc{VqaZdfJ9tG6X;R=0TN(*rx5nlf*f5K-x?vb z)TIh?%7?k>WQpA+j4sw;cOj#zZ*)9&GORnh2%CEX#mBk}ATTE$nBEDj%j{g9OflO$ zV}F2g90mP;hKCp)Yxpq3Qw`5CJkM~IVMcB!OOLB^yut8!hA%aIgW=l^KWq3k!|xmZ z!Z7c^hC1+0Yv5wT-3<3PJi+jE!}ARP(C}r3dG|Avb+h4L8~%-9CYyr(YleBRGst;o zGcey637j=tY?%4Kpu_u^foBioYhe3Xv;ZqF%!0@GpuQANCfRN9w;a-LhFgyy@LYNNw{EsnwG3@ii|9W83ggR&_<=Fkk`F!||3pzav_c1)s z@BxNL8XjXsPQ5}1`Sp~*=7%qvQpw1V{t5X}AM!^=nCJf2|6?0rm=@~&U3z1s6VeD>evFL} zLjBnPwto1(nIIYU)9}yLZ>HGhw?XmWQxPA+wj&j{`AtxM8`VkV$5k%d=)d_|LK>rkEVLtq=r zO@1Bpey!`{Q9;RXL+?&4?8gwklHSk|(Hb4X<5~g}$ETdxy}4}W1P0#k2d{y#Po@bBEw|I6)ra%24;yUBKq+v{KGTZE~9xtF$E=^nc`iQBzK zoIP3}{zLcP$?jZGpX$4b@k7nR`99fa_31*bJ9)iO%Wu=`E+frJcD(++HfJ|q ze_!_OPEVw^=j~1xm9+b}b-L6lj2<1O_44I)I~tv}rKt3(;zZivgD6^`iO%oTZ2g#M zBK{HPHH&pjXYd13kTdFv;}$B#NhJG0O2D<;NkMy=nrVD)vy{Z-)~^)Ef( z=F-8P)(+gc{(;iN^k!Jzj{IcP`S&$@?y|gk>E=y|{L)Q7-M7Vtb#vmg zn{V#4z2J$w-T6f&ay0Wb(ZT;nCHh0trKR&qi|3V|v$OP)oxQH_b^F74(Xd{!n;F)7 z>gcH5z}cgQEgsf$){wW02ksnRaAvGNoiBOkUem^R`=ls;!04!N12qU+M761U-BMro zlN-JKs|~+7tLr}VAB=DA-gw@_en+<&macx}XU{Kweoj1l-S!4^noqs2*_=*EJwv66 z3J+o5bs1 z+3}7BPo#FIGjIGOzuWJ>dYBVXw7nq7{fS1qGuu;BZu4z>?yfJB!s@d*|GqXl3I^QQ zY_s;rft{YaUi*;jiVl7_4p{OJpWV=kPV#!usC&zT!yA16`x^S&eP0Qb^{x7C`|liDvFnWD1v`fq7Vt~+M$6p~fAN)$p|Me>bGxy9*6^lh>b&|!`&V2aMt?gzYPb8hzu5W4 zz8@Dg+IGXVZM$|pR&o92U1LWVMyy{OFKjoK^Hi#A z!?bfY7g55)`dKg9@9!Eq^WL~X<1dQX7aEfJ?-f-2?5n={oJ!nv?zhi76CCG1b(3dc!6 zkgaePt5k#6l{6R^7pBU{s0~}5#~a$b{}T<&&3}evDON`sWg+c#kqa zqn#S1u97&vs0KV&m}<6>RH^hokzhHN>W(ChtI zc$EI_*3yuF&fFM(Z;c95~irL*z$fH|+$W%#B}> zQo0p=ueNtmR*kobWp2El>~3LeKhT>SyJlr@W0fw23o~bHW5PulrtA{-=EfVe5p&~y zS{Gu|>@HBKx(eE*xXg{4tI!PXOdpWc8;6JKp-D;lb&c3M|R$?XG~8~0Q}GB^GS*|{E@4$2&uEM`z>DswtH%)DCi!p!gB zS$B&uHzudTTlJ5{XW2A$mm)GZrgIwaR{k1E|yX8A|1P_#Beu>6lU2ceoIld8+AU}rD>MsDof_ZYt?z#Y#X|8 zo!inT%jACgG#6=~?MIr^W9(vc=Ek?`6x=n7k4>2yKcq;H>~)lLj!V-g+m;N@bCJ^Q zc((k|l`|+ikS!bI$CYMi7Kd6gH~yU>!?SpZmANt1Da#IE%SG{P+A=oF9+0^)-98~Z zfLdP`)31}V|3>8UxR09sLiQyhKXHAqC(HY@GB*&kem=$}aHSK9lLt48ia`on!+N5*k+1e|n=Hb~}-gE>e)i zp{mS{xoj)S@)Snq#@!T=xiPYPmD*RgWeasD=Egi{&0a|@=EUxdoV{OLWNu8$Q`u`( zbD0~nr7*jh`ptDoFgHfn@+p-vMdrr5dzrnHA{V&v9%b7Qsf^jNsqBTyP3Fc#in5!@ zbfJr6vt5WRa_QS=-z3dqS9aIzGAYa4m^3{SJL2!VNNM&MwjApsL$l+^dWnmaWv3Ha z>LM~XW@mHCaE->?m>y`$dBg2b2{1iwnp!Gx(-dc{wjB9k1ia}sVu0K<)j{!nQXg$}bwHVfSjxDbqIgZnLy;yL8nfx(;LepRxlNigboE8_E|8F3vH zZ@ELa?8UBL=TonEYA08-^T~tI+12iRYF9A*g4B!)QeDPr9K`2S8Yj3euA=8t(Ng7D z>?-TF${@O{tJ!7f=53nY%~j;bWSzHZ`u?iw7I?0bb$6|~9L0@_?q4Uvj`$};3sqWo z*DqU%V$0p*SwSZ)wW@rg`g^u9K%<_W_3s2t{9db#y<~p9D()43FCNe;sBCLL2*Hd;g@W-t%z59|UKp{9f@~S(?+DRZ-OYCT*cd=#4t1 zYnmc;2`{=A+)cLOGB@6GwI;>;xi;<>(@0&iN2RWj`?=#Sp5D*3a=(~nKB=w!Tr-n+ z1Lf7vwR1mrc<--xf7j4%?y4Z3HNdrVf4B82Z5^nFc6Tv8&pyZvkRC3srVc1m4dR}z zV7}7c7t>YO)=mQ2ir+Wdy2`b6wc5(ytZ!>>&#N=o^D9}U@;6N>VAsnEe};V4?a}Ut zk938G>-u=hb48kwaL2`wuIg{8{G?-!bRE-0Cxd>jV~%w7J6iD}?$Akc!t-vaJ2Z}r zIW}}K9N-R(L_Kd)s=w=sIj-DzRu4`Vt+k^rQNjIPAFpv4Ynb+TU3|QcPEUI21m8mH)XLKW;olcyx;59j?r9#}jX%(4@z9Bt53ul>SsB#B0XWlK$J_`md2n z@3$q{%4o!sW2rl{>~QUjXC=M2BlO-7*L%svOQd{Yp8i!UgSV*6Z{jX0e%KVrUet2X zF#Q`gPXFEm`srVPoeqX|6^sSi3izn=uqJ{c4dvk>s}cB!RHu*No8CHA9DJPC9i?&b z2?89ojX1+?nbMPMTw2}S^^MLn^kO{Fo@u5q-jWjznMS>7a@ZBMs(I9No<;|U9X_>k z`=V%7)PGe}TB5U0tCq=_O}R1KU{iEqT=><#QSYTn$3Ap>PXCW)FEXmxXVFMro6^f8 z9NxcB&dH?-hqU|MO8#*Sw|4(f(Rl&wGK^Rn><4nJC0A2iAw{EhX^UP?;iNUPfyQb< zgP030#zy_6PwP=qjYbz~%oYCB?d#;1GWvh7r(_QL&%B-zUQQ`?FXNbZQgn4t{|btJ z>IX&P^%PwIDB@qS(XcJi>o>er)4lCp@3$21{mP2G6o)jt?$WtFb6$7RrB}$FtzGL& zV{5ni@`&zlqEhZ|lojof(HLk^faPG%@NNu|UgqtX-eH4&g>!Gkr~%;>or{xKboxro zzh+bNO=|v4o_@aa>USz%YND!be_uVeDmuVKr99BL#it!)qEa55E7iTSlk~5z+z=JR zPVgxYFj1u(`b{Z)eGlxQ*M-Pyc4m%y&1qOV>hG$45TNr^(uFz;4Pt|`JJ^BhJ96)Q zhr3sq%5p;2hlz01zrKMqI;Xey8%S77#L+ZXM`+29YU8Z{m(X!Eo7L}! z{Af+Q6SgfdW^7a+<%VdN8yU<7fnJkE-qgWl_@MyZ3=Xa8F!@fR2{da-7x6;xu zS`{_?xBXT}owpL@_Ph)>2{R)de?bhwnJ_Gh&9ZlZ9y;nw&TJIm} z0_YpHB~R1^opU`x2U3t49?I+R@0PbUl+^J%O3D?XAB*T)JDu^PvKc$KB&h!`u**Nt zqP@)OZ(4FS;~8LmPYh0aVk;^iYpJi<*Y%P<$kmMN|2wpV*YM!aT%6bNhHZs0Jq_Do zuBVgN^oH$~&qI>O(F|53V{puH8IV95R4*4ObBGhoWW`p!(ntT~HV<=~XR+eKKN)Ax zOt;~v*;*yV&3azA$4RHM!saDES`lvr-cRJLJ_&NFmQ?7dP$IQRa+_Jdb!ON~S%@|6 zgNR#>oldk@9=A!97nN>ho#Z#|DIt@R?&u7eqZ6{CDwA~K5jq%NnVXou9 zz5~doL~`{rD_kPwN1JXs6(EmfZ$P9rdxM1ePBfDhTkYOpbH;6+#cCgiGg)z$lI$3$ zhud&eFRf^T2J}%{RXLo->ib$;F96QkIGVa z8Zxn6Op|yHpy!CJ`05Mwp1Ktptz%OgShY)q4WTena@$=HC6fd2L}`Zj5#l)}Zqwlz zLG@;Z8YRx$8WLy&>E=6~sjMosG>T4)PKeq|vGdmNE1p$_R5zRJFH{2!L{`*3KUy8T zW{{iYtmbLS=md5`)cM4yeV2GE0il|(Rd;qb+wcpn?5OJqt1~`R~ zpANzl>m-BOAp^vuVzyb=7Obc$;?NxK^^zP0=K2lUt6H?fSyBBaN>V^=d%D}Ot)WRx zom_)3Z1{SF_kz?hJYGry@@-nQr&;}6i@US|9&++ItbXI`Ie?X-cS%NugJ_tbN5q-$64VrcS0dhVTd?K=1F zrNqL-O+fOVy597wUbZM<_hzh6`%=>jZl~v88prvC4S9b(uVF|1UnO5g^^)XWcDAM( z%142J)BRMZpS<-R7|l~PZAdqHl$N48WOex;5VFMS>%U|7)?U{xJ`d@%l zc{kci_e57>p3^9DIVUCNJ4txYp1Sd-J*6j{)RuhnTw9X*#Ig`T6Zxr>l%MbOY@U3YeAo7*Ci$kv@?F|An)F72UT4KJ8>)DO7z2?_pOo71L|RG$G%Pb{vyRfxA)t*Jd%Bx^vKB#>3t0g z{ZINm*}HjePsDyKvd?2VO#OZZf_(xrW$4>$#2-q$tgS8&v|a2 z7r3p-ICZ)E-c81)M!4dPO~zwGw=Z3-oYqM$-hetet>bfhr-3U!8L7b+1UV$_vLngn zrdE*;V?o2QAit68g|FAj9UHE^6I`D(a<#A{gSt0xtxLK7%DDew@6!XJz0@hy@Bsba zbh1;*bKQ4}XLfm>>!1QxR7ge^$>Ce*wytr_Ep*jA#Z{-k9bDl+O9o|q2PE>7T&hNH zcqcnHVtp%=OkLCHkVbtflvE=$zq+g}IUQ(~rS<}Bs&gFxHfy_WuUhZ*1I_#pSj{N9cYzV=>y@YPVC3myWjV+HTjVZQTo zU_3h1;ugespU`Xd-X((fui&zD{s!cIV2OSkcx~VNK=4jJyk7&oaW6*)#tQ&HB&6dF8pNf2sF3Vf;UMpDh22{RbH*6wdjKhLnatg$~1dUn>9N z_a)bHi8~MH1jhKbagBCvFcP;n<%`^L?Y+bpmmA(&M7=+jy*zUmKOgljFTyxc$2-3i zIp-ebOTEXA;Ku^b9G-KYaKfN-9yWr9mc(t1Yf9o9hx#wo!Ge^~K-_Rq=g;nfC z=lmt{SAu(poF9;!+ZXFf!}<8}9zgc;io@RLDQNjZe4-?tPbk#6qDj2;$YW5>wMov$ zP;!Xsf8y@uKkX7GapOZtiSHVQuXP=i_^Od_oE6&td%0gp{D*kQBFlAET324B{$af^ zT%8vh^d+SFR#~c0K4{LX|?Bl`z$1ugYehzCr9gLV#Zmp%WmT6i@hn(4LJ^piY zdJelo)+ZPF{=gn)mjM1Ve&!mdMyOx zu-+(h`j2QG%6(K!{m6&OYeHd<#4e*mOg_wcvPOr=$TH8D27SfhzFyAMBY|?^Q0{AD z@rn zIULGmu8x2l4&^fIMxb1He=#Cv-@?9T@{2%PIOMs@=)5l0Y>?BzbZ@-4vzERH6-Wzr z(i%CFa|GnDo?1IOvr7czaOlrfVrA>(Ys6vv;C>*;*NWRnhx{>&A&?Io^nYUHa2P*V zi$hwb+6bhDn`=#;PZ&8I#{BbQb|3mo$L;I&|0WJ~`&b<6@VS_PKHNZS@@I06fE*6x zGC8LkF{i`4DS`dfUffGe8Hb2NSrf$JxLY6&b;GI}S0t3h^ih!Gn>Y0TRwLgg4*A?| zLA}o|IY^!{XqEF_cGOM zCg1~!fkohio9Bi~66gQ_i9V4y`GwF-zyT5haRy8X#5q7iAkHIN9?CtVH9nR2fenG} z<3dDh;#0KngRoX>^mFr{inD#5mJo<94iT-1FW16}op($~zv^q-Pg9%|$qc_eT&R>R z@Ru&S_VSlB;d;J&NnPc_0lJb|SUc<_u8xa za(9cXdT}uj{6x_f3_J*3wZxnW6nbchIdd!UqZxChpirtM-p8SPr!(X;6uD2!1x-j> z2Di{Zg-R_UANn)qjIOXmOYC6zWy7G{9GfaU3_nk zFhvXghInFqv|;i`ezn%8dZsQv@O+8ZS9rcbYs?4GhadFJJ2=n6Dl4V+XPyhS=As8V z-FUR;He!sUk<-lMJQs^Ef|dVuTHo)Php>P0%%kD)+K$e2E%QC|Wb#y4d5%>+>pf2p zUtr`H8~GN`lca-taq{H(6Bi}qL!aH_dAj%&qobkkbY@GQ?|H7c7c4z|#gFvzd6M%i z5jl^#FnSDS)q3XX-HD!;X?>ArE-HTP`G;EH>6u4%zwyjtx@Qdk)iXczpL%{%>wkLY zLERWF)PWzSd7k;fIvrNqPgk8cdO1&iws=PW4$nOKx!3c}TJxZUJbA*?NDItUovh*B zo_VT+pCWX+X?=ueS0BTS59(8-H5`1n^+B$*!?ordh)y%l!JpfqUWa{$i3a*7X^kBV zyk2YK@I0+g_k6w9jC!_w~| zeK^B`pn!1%`dq-z_d2u>&T!x;9P4#1)%palQz|)}@#m%WM(293Ge|mc=r>F*D2tnm zcRX`Lf&Bn=8!CM`w1o%s=yS8s)H62`?O^HC|8QtaC$Gaz!AP%DCLK7`0qX+ta^x@F<&0dF_h@X0$#nOQ@{#<&4*WuWG!0RlL4xI7l*vGsMHx#=)OC@>} zR=LYPXZ(2>dvWA-lEazyXzN?JJ}oyajX0*Hvqo|_)VZTS*0@PI!0Ry9;Lr~|5T_rw zVd055`K*-=9LDexuft6W3;Nv1@Q5GgW`vhIU~W2y!)vv^!ZYUqwjuw8)(?5+rsFBk z+?eo;A02Kk-t){21##prXwA6;=7yrL=Yd+6dgfx7I6B-o@cs~du+|58<~&mtSnIDv$US>nLLm3%(?0q&zvhxg4J&u)NgR;+q1n6HzPa)M(14Vz@cw%@;diu%|f}` zw0^=fHy|&2<_6?d&l6QHarC(vNh=OF*1DUn z3|88)TC;?-6JTHNBy_}FQyyt}HmtOBwPp!v=fOU0rI@r_PjX!nnB$PN9Cs`sEyq|$ z%dv!hdv(w{!%7wfKWRlU{}i}E3(V;7^dw(eym~I9^@w)KGX08hA%aIm0^CfLO%B!e#P*6hW~E3K>ISJZEko!!@Ujj zc2&?HZg`sEa>M+V1^vy2uQB{f!#fN=X82jduNr>O@ZSyd1V5CEZ@Iu74fi&DfMIO$ zfufsl?c?|XMY`CA{;f5y~ zo@sc2;pK);HhhlZOALQ%_@9RJ3+wCF&2XvVgA5;Oc&_0^hEFtnzTrz@9k+xn;_#dD zYvjxbDm-BHpEdj^qqE1z-#2n+M&tXuoAL{J_JX~9kdcouJi+KpHS$@ouk+Dj>dZa; zGNV&xbgnaeC+y38z{npFlMmMwzc)HB!&(Th8u|N%KQlW2F!BbP$qi|FJ1&&l%E;Rp zc{d~PW#og5e3aqoM(2A*z5w?9v&8V3hA)SGKU{0%KNr&vTqFI;=-daZZG?x7{29Z4 zGCF&V{I5p-v5|je(Vcg`}||we+2!ehWCZNPDdl}W#s*ge1u`Xsua@BgMIxg z#nho%b*M8s>ka?F@P&piH~dq>KZkw(H;P04j~bod8UCZuZ=t6(A#GQ~a}A#e`~JMm z@Kc6gGW>;M_JP~iTC2%9)-cI&Q^VXh1$}$p)WyiV8|Gdq=!bhHiK2sye5BzCh9?=G zW_Xri9wLYQ=Nqmzywosr?m_1eGV3@hSP@gS^xkn4~YYqR> z@NI^f`wRLz4L@S|al^ki{G8!G8GhaH+lJpa%(ID5?iYp|=_DTHO$_g2xUJzHhWi+1 zzA@y3&#k~m7@lgFImV!aZ;-%MhWSkma_%<+uQGh5VeUhN4)>vfFEjj8!`B=Bm0|8r zL)s?|bAKA-FB;x$_zlBv8~)hvXNGZ>67tL#Zeh5UVeWr}elNrQ4G%Uv+;Ev;?vX=2 zJP!&y!|)u#^9(bm9Q2Ph%v)nYzQ*uLhEFqmmf?+tFEo6W;cE^5%J5x=A2a-f;b#rM zX!tF|?-~Bs@MnhebUz;2SYWuZ;pT?%5EJyf8y;x*0K;PpGyf3M;#nqex#5L|zi+tC z@EXIX8a~Z1-wg@*|IjdRSOq!r7=iI@6PRy{1ir^Ga~(ncm|^BUg8Ui7FBpEy@Oy^8 zG>r9C$OoTWfis4)hT9nKXt;~vUWQ8yA7J<(!=nu!VtBIQX@-w7{5`{q3?FNl@1cZt ztuoB~OpvcLyumQvObI#{8Rm1(LB7o}e%XQ?FG7LuG`!RBgNAXI81$bq{G8!G7=Fv} zdxrU*OUTE5&jn9GL5{bc!225B&oG{Zg3b`bBMgr+e3;?MhUXi`7f{G^sbPEr1^MZQ zHyFlQQPBCZ;j0W^Yxoz2Z#I0FVdl6(o(~y*%rJhCg3fNk?-~Bk@Mng_;thY8velWr-r{U%)DHvb2G#EstWQhhMAWO z@)E;?4IgN@%Ty1!%VV%yS@cq7KutHpCX^GvebGtXVI)gbM9G53J* z+2WO+c|Lif=S#%vJYOy5n{?=3FFw!n4dM$tGsl3v2RgTjw|eGz<~5%0693#Ya}V4D zqJOXWcF*^VcX)nOj2#F%Pl&MtftlZa%JUxav!34;zvTI2@vEMhhxm)<2HJ-_rz4-n z;*UJzU*_+g+l#;Q%zOj)q3CxKXFM}E-rO_KR9kz-wy1+=<|Mip=AM*%uruoCd8nBC zQ{-i0p8dgN#G^b<5s&xGvsvz2(ZM!}dsP^lrE<^M=v8?>Lwu}fY><P8J=cj3 z_l*73G|$Yz%<;@Te7WaS#oXJH=SD5Zdgk~$&hr-WYR}Baoa`AdCZ~D6MU1@-`P`|6 zmjPhxqc(fS=8BgAkaKdp#xwISKlhBy)Gs}E7T@l@@g#Ml4$)1^~;rzQXC z_j>Lqe#moI@#CKN7yr&Pc4RMjt`z^#GjlC_Jg*nO?fES62c8*s|K=H6uP;4g$Hjdy zb>^9Wq33JGO*}L1vYwf1+1K+u;$qJaiTC%6T^LTS$@69L0MFQh4fTu*l!HCLFCOdp zQ}LmmzYK@I1py z46iYKx?!GWgtS`>UuXDM!#fS{GR!lGkk1~&9~l19aG`!Qjh zVbB?5xXduWe?e!q;Y!2H4fDGd^m%p=_(H?m4Bue*4#N)`{;lDc4ZmslW5fJzg>rEs z8@P?(u7*nu4>#;=v6L@ix{>pn6!OIGH?aF1^7^M6IlnhSXN%$M4Bu*ar{P_O`JD*) z>@oa-VSW#S4!;3`vxbWeGY=nhumKJ{*6!OH3@3Z}yZ;wUMTc3WQ?Cny^q=!v2&#e$n6krV zE+&u7GT7xjg&92Q*~YoK#K%K^4=T=eK?otgo)Xynt{x^^Xw7$#pLTgJKk7sN$OwZ& z#!1v|1C`vpT=`vkW2HxaA@KXTAw;we_2Zt`)^FZu{njZV^;0!-^>cQ%iif~FZ(|<% z`w+^)M%m_f=@{9!%TR#)G=-7NZ@xIB5k^nQX!w_*QD)mp!|0tNgW{7KK}iUCELYT) zd+uai12jv@Wq+}a^%+`18e#N#mnbR*dDx%5cKYp zfc+T4)6yFnB3h$Iz!?P0O)mp2zD{Yt-R7v|dGe)AO%p{4R0^tE=d z?P)DGzmJt4dgRyIZ)3kW&Z&K4jfWU`0j65Ue{ZtsS+IfytUNcz5eVX-}!II zDE9$GKA-nqK~d9n5ucOf!+%PtZN*m>C!#0vcc3q^@D24V zd#2b|kNx~@-)_@k@4wMj?B)sSp!Qn6NzVBGCi(PlkuR5gqLvf`qDg5k|9cc|lam)m z*!VGi^grhQ#Mx85=11EzZi5D2VQOluRVp=B*@bVqrQGM#^dYxHrLGUTsUx*2WX4Ay zayyk(Vfq1tg$>qFz@g-ke9w(r?7X65k#cvQ-|SrUQt4JwN%c}a^1CBR^Ga8$G9D%_ zNaY{;nAQzWkt~1GPe5ix^AATF73$;|y{M%j|J?W7?vrAp!u;{Ev@%?Dw9j@EoJUf3E_Kgybu+> z=k^wI|2;Pze24G3{Z5I(_uQD|4BvCRj*q z(9P&X8r6T#jgir^foje7+)A|04xkC)dv1d%^u&09e&JGC?p1uGFw0AjK2nr@i8_bx zxs9cOQ)4Uwve`SxEqu?dhz!E_+?W~E_uQEL$bHZ4CjE4E&3?j`4e@=7^vK>tIpKS5 z`;kHTp4%L@{Lqy%C_9ub8{7Jn>1VFx0S)0S(MY;T-JQgjr*L& zH>>jcp4<0Sh2(o~uGhcidv17LNZ-!2R#E11s&)q)zUQ_>`8CV@h~oYC+(uB~4t7)f z3~v>s?_*RIXLySz{lM8OvuoyhbRN1x+#}PKJRf~o+$YmV|I?2#w-dhSM*iV@Zq#z` z@44-!+~0jE{jr%M(*C|k-4VX$M%oFPQIzYy=T-r~xK632XEsrXSBfN=ow`5Nb$ zxtU9l+wZwCNLtgL)-dp1qq*LaB+SoKjce;-*aP2Hp}F)zUM~z_Sp?Y!uQ zUaH&+?r_Z$aY+$xDc41NyUHj&ubZNT_PLOlbPZ%nn=~ zpQk&Q{o?YtbU!}2Bs@kRrrIx_n^&ie$;Y`mj#r|BJ1I0=-^5#<@`YZ~M|wT9B!yn$ z3Z0e|dWkD^dQxZ-nbAR4-O&eX3guDKF)E4jY9-%yxawMP7bOi_H*xd` z(RfB@E}(c*q{GdEcam1>b6FIw{^UbX+L?S(u5gijDxIzYQE)p+!xdz_g*{L4SJKeW zwImI_GHGZR_x-RdU1`(1R@6%ITI$(Bd#J;21@zP2d#~F?jFWpvLbta@-3{c{bXW3^ zjZwEl^uOS4m?nI?;{H4f)<>Q={dT`hM{|P$5+$d?Zn^B8j3X^MY;;`{cWcrzli#FW z6Fy(lOm}U0U879qV2N~z=uve_wTi;$gj9}?=tDWGUF$fL;cG>BTxrnQs1?TX#Fj`K zc8Vsp?57LxMlFqQre1fbwiPv1x%$m*sgEDkXV^qa{=-NpHARV1n>n>~D7U%EORa0M zk3K%A6J9Pa_fa0b=I+{{YLnMKK5HLswNK3Fim0!iHBd&I{oSf98xZfC``C{8u#x`) zkREe|dh*4h_Wp}Ssw*G+=}`Z5r2WiClk}mdk!{1Lp1$^_Bt6#%9ZrUw{6~&_hMnub zqtwNetfKhPlkYInb=$j$OH|Lcc@x_@0yLx!L%H0?I^g4DDNQZOf)3I@LIjr9yUDaD%@|Zt#QaZXB=|I)BtwlKmISzv?8C#F2T7hj-IzB%4zND z1@a~>cf$D1uB%x(Kg4hhTU)gtak-pxO^wsps>db1-AOeQunU8$>i@Ej>SdMHi>kFhoI7MWK`#Fv^FWbyA5yxoZ)Nq0y5oBm4=Nd2GT1%bDo%d$quF&; z%W5miCoWr96U~@5u6)$!X_F_-m_Dw2(!}ZGrjD94ZA59KQKKj7KfgH19c5U%A0a2z z#Rj*U3S6;q`N5jtyxD3U)_8>Ke2_!jVlzYFfi9=T7%+(2!pUb55 z;M0_Q2W~>c^l;XQ=qScFV$k0ho}l1mO;N(oGnWFW0mKu*4!^;b&PTt zvtQ65z`=(chcz~4SE$C2RIOFSll$Vn&9MbAc8fEvW(jFaVXr?39Wi+vXt)ekS!1{NFuu@6053l1!3I2qb|?93WswCLsv{K_(C| zfdC-{L_j7p$pivM6e-t0!V?jm5Rnc8h z{=aW^oxbNzW-=4xwF~w6boZ}LojO%rU0q#$>Qoi$5F7oy4&UPNryc&P!_0B8xXf`d z{7Z-bF7|%ftw>f;4!{<88aEir!ox^W*_zMmP#d9pH?>YJ}9e&K= zT74=^ev`u!96rF|gB`{Q!Q!6e@L3KA`^T7{OC0^p4qxZ+haAR!-sIomFmpkS{(!^3 zahSDFjfWv;!Z2apSy+;`N<0bR;&~@Oh1V{PraQFibe+(Su zf78)_;OIXVMn2zY=IomM#~gpHy6Tn|b9N0+07v;pIQjxdKVBI5OC*0ObjihaIsR^k znS*QcnRjdQZ*p|z&Kmub!pP@ae;4#9{~M0~`;Pvw!@qGn{{xQqQmgN?;mP1w&NCc+ zwlL|^Pgnpwrh9_p?{@U_!BPGj9nU8ne!$^J9HzWT3#XR zbNEDu&v3ZiVfy5jANmr8=>r>nox^W)_?-@az~P%6re9%lzU=VV9Hu{PJoG&bKj82~ z4*%L=hDVM6?+*JlsD|kKZaj>V8lLDd_Etup?y#D%e9dE?kv(_+jJ_^@qu(dY93UK4 zS73d*!bVYG`jx+mblQPOBi>v1v52P&GmkRNB@(VtJn&0|8zMelnEnZL-bemXz%Lix zGvbxP%@OlXVQdEv&wNV6mkZB`_>IEYLcw#D@Jl0ptMI&tKPh}{#Jn$yBL1TAsS)2P ze0s#+6vo+lavq1ixA<^lbyyj;INa*+VGhrCnESW5OC1jVjRM$Oq5T7v0iT_+L?@al>tHYeh z+g}7P@8^}d#Gp)ItJpKCmxG~805VN5S``k2>E^f{-PhM z9`TYteSY)&oht0*eN&z>vF%n+9>%|@m$ynU(uK+}@`l7P%CA$0m&e+W6Jp&^P#(6y zVd%9|LcGjHG`LP-KHZ1+lR1$BNtg5p<9dk>izApE+ms~Dfaol2v;1D(wR(^(q9ISF z5xG46V=azga<1gH_i-QB#5ip*$$d`pniUawijvE_K^S?hI&fbbm2I4r`LZy=x9jkH zQ}n{lHKrIw_@{O79L=p3-yHMk3J>mX9ftAWAU^7uISac(1Ya&cJRmDq?t`|}%K1KF zizAraB6+s~qO-8?$nWJnEP1zyhP>Tl7|#t|fYo`yWVMt44+5eyd0bubCyOMAy2^Wv z4AP>!sf%7-v))VUq&br}ZRWw#o1M$&5FFIpJnJBx;(2;&>+IPxo114JG<#0QKJXlZ z&1I#gOz`g08Vz<1!R(IAlE3XM&07-Y4vd*qcS|9IuNitvF+(?{H~;I4Z_e=Qp^bNq z`9R_Gg|FA&QkRkDr?0y7uGbBZlvO6TD`0UV6DnhQAwG9-ylt5`J*AOu zVY=HDI``;k9ENuc_jny%_|x6--i3D&-m!R7$sa~_Jyc1s1jX=RXE;1Pqh`JE={4O7 zSB*_hQTVwb{B-OPhwU3_*n7gK=5yE#(NK9@o6#E1Pp)26H|a$+$*`jp!a@h1iYc70 zIA=%>F*hpanK2wiO~^q?_y)r3HzwyNlU|f2!_E=YyCvjrk!fQPQpu*W8de(_DV`{J z1m#SeK5k3Tg5s(x9ISIwvrhFRxXY0g{z!^^Bt@N!nxa!-B3#^DB%-n^c5M-n`x;4T zGK&6eVRwk6ITA4PdQMsJj|J<3X&r{pz0(=}83h+l53%%M`Y@RDrg62-WUgXJSIlhN z>dbnrKC>)q;Asu1w!Fd&uWf9!DwD#(8-bOaSIudovkBW>Ps@zVQ11_SW@aNSK;`KZ z%Z$NBX2x!#e8_^)S=eY#JWMTaaOdhQ%P20JbQF?5q>HZu@l+MSg;ysF5Xjxjgk*%p z#bPdTF_-w5OL#+qqnW0OtVvq0<4V*tIn`2xEJ|>&?xh17*NpY${jpAttXvP!ktU~e zfxSjANq^C}b5gJp&^`CX%KNDbC07V%PLzwex2UexBs5dIVEEP1efF!Kq}f+rMo`n9 z0+XzyYt6=2wQF~6ceRig z?FZedNjhi+X)(aoUcmFbvy!MPyyu~f1Qh~DCBWu@|0{D%0u#-nEB?v7{ET~=BYd`b zbj5!}FMrJ1 zA+>#Eo57LZBV5*-#0!He!t4~lW~V?W8XjISqM6MC*v9{xBb}EFY;<~<@RMJ#?O!+> zdQ6uxgvZL$_M1F4(zz$F(K{oZ`vaRz#HvW=Uct7<vL;I6T>5eyNTBr4Cc~jK08O>YmYG z?(kU-cRJkT@Fs^hJ4}0IGXL4(H#y8Ni}AeA;SW0e5r;qFFn^>L_b!L;b@+P@|G?n~ z9sY&Gzj65Y4x@>%wEP$jHYP^r7sl{dhsQe{+8IuAv{zQIXs;~pUg9@8b)Nc%n;J2H zcQYdn%8`hX(H8Mu!pB5Ry;vCWOyR{5&lWx{;zNYbikLdGJYxP)QLK=Mm@oYj$rac zF-e*M(OKAL`MtbG_3K(hL!NFam-h}~izArqtqS&bM=*FzjMD~_T&v_gsw?tnD=dFE z2otAO2aXBhUoj!_139+GtMR=`g*#U?bH?{+5qOT~J}bUC=Ft^C+}%11<$rpxiqU`qFlKTy0~^9_X%4Z!G!g}mjI%(ud=sUoMZf(CWNka^ldz zjg7RHl4P?I8)$4~yKZ70f}^wiO`AFAkY?uw8XM72%8ZPC;IWYgDw1w$W=OL#HlneQ z{YM^>-Z4D6rEuIwzn*T<>)Vig=&s8~e(16 zmM*(|jJjHTB`4rgi@bF>RpBTBs@Vrf2{| zXI<($xD<+4g-iVg;uY$Tm9JR17+Tu!&%pyj9hCalil?@OFdW%Pw~Z35flp4_bOlto zA#-&~o2GC+xq(ks7Iw7I&?oTjhK!o4mkg~}>~svAHCHbRKOM+x)G)-=iyAcuaP^W# z4HEPyeAs{KRA}5sXACulli2Wp=$|Ujh%6Qm)u;NrqA{=an)E_1^?8_Up6Si&y;|Dl zO-Gfv3el^~H8V2zj@3;%mASm7ie|jgDa?me%g=P-!!tcOcM)C&DSde-j?s}Rx5y`l`~KQ8;UWVKMLrO9)5`{S~gslrIZKfSi1Qnfn@`W1AbK}eN8H>jE`2~>p(i>p?UkKZb@g1ZF4M!ehmw4D=ib>X$TieG>Ytoxdi5O+FDq9Z zod)m$IwtAh-5(V(Z$1tlu=)gn=R{qR4V@-|4hwN+r6KO=&aUSe z>h4VZ4qZ*(a-Xr+3Qxliaz*Mz1*$Y$k9%uZfucd0C*QEL_ ziTFrek%x{G2R7a67-8e5PilDoh^gMw9sTf#7wO8s75wnbkJw%lbeX(Tr1f0VYaXcl zm`>|Zhvz!Xy%hRkfeh*mXiF>~e)2X0C zGCBP3n6B{)j()ep|KWIk;OGxK{1`ZQ1B%;?l-!~N;@Ryv;54%Z2%oaCsJcJF0jlUbk~Vwtewpy{sA?}F7= zNiaGBt9l39KQQkcD+hw9|NOs$)jJJ)*nsKt&5iW%zC_GBWIC-Qg-xf$`)fL_8Pk<<_!1NQC+6*C`}jb6Y=50KQ;Q} zV-5fP_DNMx{KrcY+A`v_>A+nhd0TZw9?#U|@m!D(4fm$(lAj5~(QY*87>IA4cr1=! zu>a;=Fh{z$-a4wWszmceCx6r}%U@`Jrh4t1^u?NmY#-yw9trI4%Z8~t@RikmAuG|OD%kJY6VT&V}%uzu$1ERCA&GLJB zACiz3(U8Zt)8xHF*y0F=y`GrsXwKj@B6xY}e6-m-M{}2pZ;p9%g%20n@C=6Ym&8XsGiQ8vh~V#I)3D0>u`?YN zbIi7yFkMYvZynWE$%Bt_*u%{A+1mC69Yw=_Gy|>rhN(siT@|H zPjnNcWa1KPMzFt>C%C@!Ls|XI!jDs_)FgkB=l_C!=|A=lU#MNy*eYSDAO657DJsOPOEPK*<-cfMnc8|}hwO`g4s}16n%HFYX z9!Lkoi#kb%eYE&kgXCor! z4`u28r^9~)>lxv~6aeAmXvY{1Xs&lJM+^TZ9jbcwb>}2Xt(tQ$KOfwhkoA#lYug z@~R^iaqRI`;@Rh?x8CDEeIFXd#(x;`;ltmT-orjA3XcC4JL)}tE_q88jy#^1$s;cE zq2X3#m;6i^?ob_kvIgRtCmxF<8066&nX~)tt@oIx|G)WSB7Zy6dt9S%>WDdmz4acf zkHLsN@^+^8_@;PnH(|P(ybTT${1(;KiGb*gZ=L+yQ(L6}Q5BsZBhux0SvmLCd)z8{ z%?dYX@-~a$<+bR=Z4nK5JJWl7SMp9YA>uVid3kyBCGV;zkN4g3*IV!LA_ZJxLZUpp z+au;4aX0FPpPRvOhKHlK-s6|z8;ss#qFxm0nK@+P?$F`y<38Poy&wFQ+I@ufk_gf5 zFL|5HqpQj5t@rr3f%G1?>Sib9u`2nSHfzSg znI0oM4`iD&d(I()w#~V6j1ts~oV6Pjy@$(2pKx|Z@|v2)ng!`AMjl^t%%0MYJihOi z1pA%C?tjne%^AFM&(33$8|yz+`}JZ*c>Ic6>e=)x^VRA7usE+A8l#*$>DXl44~|Ka zAJqij7*q3?Bf2sD)JT(X{Lm}+95d-Jvi;%t_os6~e``9IU+ck8KXguSNL9w`bfU4r znWDGmetD|rFZ0dH=Pwr(N9vb5MU(pFKk%gu@5NVBM2Ro;%MsyH&u3BUmu=xvk0ni* zzx)aD=JS`27uC&QZlLQ{9KMgvIP#Qk+eg_Rau{#~5I6Ke#Y;!LSl;yHA&-fY%~VFY zLn|lm!8$WgH*{?9@}8!rmR`(d%oRGHsiX88yu0IlHQxP^Iu0yK&@rODI?&FjX*iq^wV{o(#l2J^Zweu22HHH)nBM!5 zNb8XtCPowId^K|?#1tA&6F}^@cM!WyAxsATuUu@Eh{jhb{L2cj(-E^W;!@GR6a4J? zBL3Q|m((e+R@13@8r*Q4wmes`um}RlXLFOAMnW71ksAuck)auEI#anQmIw*6mftQA z<|fC8=%cd<%3=O84|61sFa|#^_F|Z{PL4-b2WLE^Fk7oXo!pPyBKBnTM4jr!ljO*7 z;<0DEeHv+b%dB0S<6Lb^RW-fY8)xmV8dq(rRdTjk3T-r7Ev7dQbJkkJ6`(Hcbdmd; z>1^|v`GXu>n^$chZ= z9GvH@WRApxLvx{uB$qXcAnwoH{iQ!4}bHY^(O72Xrnzf!;D@vgH!J$Q^dofAJ0Xi@$ z0l!QKGT@;pHJ(mk9CR=;;YV3R#~b_x9W@bKD+m7zy4NQt1#{1bHS76*#!(IWvbk#} zFgmKze&*2?|BPP#m-O<_>*Zh2%bztr_O82THMXd+A?~XY2{c-h&<0gn=#YZh|M5Ae zcZH*hr{w^{f0E71=01#{VB-&e3;Y+#(Lt!1uT7vF{Ur3lbYZwx@H$=Tw}6-HIx1pb zQ{0h^K(VSP zyqT_fj>AVgywKs39X{RR4u{WiICN;GXTfdMVQFD^V3?mY!*6l;eGcCOR@ve{s>Afu zpA)vYcYqsolDk`n(eHEkr{Ku*kfZ%yX^2K_-X!vlf>hexr|f^ofrCVn;_W zWc>WtnH=;7Mql9QCxGMqb~=2a!&f=H-C;jZ{5y{R2Z!q=+vLvx$NPPm!yOK9cG%Ao zzunQl>#&M5e@49X_Pj{O@Cb*|W*B{v!}~jYpu?y;jDN1f^Btz%8qb*yFLju@YCNkP zMn_`wiyVHv!~g8?n;m|e!zfow&P@*cI{a}*r#>71Z4Q6K;qN$nzr#Oq_&*)~mBXlW zO#a^-M%86>%#94!iD#g(qGngGY`jO&^6?)2O>MlVD14as83(EtJ~CqJ#r%l*=1~9P zq5WJE@hIWbBc?rH8ZlkN6%o@`uZo!OOn1b5XEsI5H=fyd$Ui`MYs9pFS42!b;{AdL z-PGG6UL?FNV!kKWM|_&_jSemLS+3f~%Wr|@SY=DYcoh`WWq5i#G{??ucvu!yT%FPs%`i^TcCu1e1q# zOa??}`8z^>pTBKtD5;O+k9WrMcdD?L*CfyH;4JNq@CGQ*sB9C^*+ddyJh9eeF*0Fai6fo z5lk+ZylsH!ER64qm-ncIz=u3(b#r+mg{{sDCi|!ne-IFz$>Zv(WzwLBPut3SjSSMF zys3*`-nDwq>2I1ddDCXi+@*0cO?jW)9NfTj*l(jEDHFW=yq$fm?>l>La{Z*_-(HmD zi}}9i*yhh&u_X+P-C1*4?YPsgxaa2g|Lgb>ZTH-EOX2ie7u|DP7Wk=JMO^gR=)0+A za_yqUx4oivfN?F#ARE_ePClC7o6r$Gg zUTZMxT6{IdTe;-6#0&5hiXRM@`ZtI(3}(%czplW`s)!#5o;T}U4<#GdY8Wy>xJJ!O z_TbWOn63_8DsMUhh%4={Q##@#d9@Jlyx_S~=ZQKR5tx?ga2=^*7#gi~w|xXVbPQMf zk-S{-Xy`_S)pe8Mq_|Q3mOu;B+lL=2+CR%bH_*-~_9PpUNh7jxt0r2~n-!oulTKZj zE=6GZwyFba|_02qfs@-Yr6ocx-u*o(Mpag5WmD{I z6rwhaX}l&(vd=~#YQomowQ&SPgAYU0l=q%+ucZgG^;fgCT7z~gu2C59lbl#T7(?W| zBr-L9J`nKKT2p81%J#8Bte=wa6n#%_d>!l8n z{YP_DsC~_&EB*s}`DgX=XS#XUIA}?1-y&tLg&ItnCTqUz<%+UQug(X>^y*a3zVz^o zqN8WVaWNe=A2RgDRCFpmJjer^z8akcJiHk6P2nLOu<6N|LRi1$$gV083mhED^>GCAMjD;@rz!xEq0 z3-!$I3lWBS*9=c|n7+8tr#Rf|Fm=y(j&b+|hZj5C;c%D3s~!F)hwFp~(n(^oZsjvZ z7(E^iT|HPmo@7$QynmA;=AD}wF~1fwBc3RX-k!MhEZZVJK-g^7slUfY`mw^er&?c^ zNgepyOxijqD;(_vZK64zJFd5GZJ~4mJj*?G5Fb9;lc~{f^5)5JA7jDzPr9QG`h}9W zN#V$&%uOEoK|VCx+p|l4CJaZJ^6Cu4M}91hVAxxFG9WtA#T}so+@=GE?e=_K$=}X& zYqu%9DK%lnGtwTOm1{&P)UZ{6Ai1q{Xp{b9-5 z8s$+BOfB=3#dTlh-yKxK%0)%9V1V-LU((PuR=5Sn{Y><}BVR+O_lM`PDtVta%l5(w3bW>cY|v-TIB3u| z=uJF$-4ySBf4Vh7q+e?+9$&na^&$_ue@jrSJ@NzFEz2v|nu3CD(XE?v4cle4i%ye9 zt#P*-Yh;dI$RZy<^wdNDdgTp}GQv%o#h*RL{%pxtC?BSC`<=>@=c04kp>z5rov@$A z!HDZq=XM1#YwCw`N$VzrOT*RTmd@=KF1gMvv`dBJ`ym$U-!9Ieb30J}T<1pLq^^L9 ztV-whga}27HnR!c#&Uu~L*HlwFkL*fMPccPm3U4roq=ccMexft1{GU*AHltKWLDxq z!7)b_`CVELV6Q}4*G9e^sqIs$bYB0U}T3#KN`4Z)}A99-|%V?>qCjmyzGYLe;Kam|G0vHDWQ*{dY( zpoOgoqfh@ARBL&A0ySv%w8PRsT03v9*0;j0Vk=vve&VL|zpbS~cX^S^ zT+U9_brt)#!Ds~SfvnlEYE}D+wHwwfw|$|4f-VHd9hmauGcDTLYr2*=&^ za9q`J=FaqYSv!$6Cj`=^f;L0PBprMq=oW)%75L_Wm+PpB*qQ<2KJP4cs|xjbsN>^f zj-wJh8GGGnA$E46PjpBxf2Q-Z*WbVF*^CHe&oaUKTIR01+U+3@_9R88R#4%l8!C~s0(Wy^{Y48od$l(_|%sXs6{Dl}k(&1wr zKEYu+n8yDKhdUhZa=1=-AYGy_PfRULmxw;rbcrvHxF~r{|Ao%GesILRYllZXM);_R z`Hfl-@g!k%Da56teM-cX4V&ab=Y8*r_$cA?BBrhQr-*r{H$;4zFz%_=L(WI0@`GEV z!|+mv1qbDt#ii_4=_;+GfdJ|iuD7o8VHGOnfi8yl@KNukMnBIMM_#Q{f#2lqA8{K* zIo4gcRafNkS7Y*K3L_sH?!(z7KNE&KR0pr@Kz#GWV{rt7Zfi0iI?LY?@`KwVo%Ij6 z7xG8lvi$M9y*%0uY`x7H?5(S8R$+ZtfympLu9AImeq+LPHF+BxCiqjj@g6{Q# ze;4^#Su)VD4-b-orP_d-^;so_~3Mv3l-^ACPXp}Uein7eUf*Z zXylK!%kp=FFmYOS;O@}N{vHz|KagX4yc*vMJ*>H+nKQoLy2^hQ-yCDo6+YbEIt=6g ziTJ2z<}BA=FD?Lvy-}0mvEa=kJCL-HJWDaz3e$;r3Te_XMAs9=6mDeiWEk^tt}LE>r7l^C zEdeH_`^ms5Bw8rF9to$uS@ed|H^48yN%%6A4U!tJ*NG#F98tJYo>3zT6wa_KB&VUc z{<|WTej;hb9$-?UT`6t|@+D`ke4}fW>qm>-X|t~71G$BbDGW(@4vD@xJ*7^$DgUYB zX(<0o#nV{+9(jIEh|^T2(J5Y(u2JEY%iEE*C4`JE|BW~o2haHO1H{>yUMIHZ-P%{L zONy7K*Qj{uThnhUWL}vkP<%&9vCj{B_2N5I%5`CxvHaq@(mi$C z_mzLg{k%Jr!OzPdB+hl|4<+E?@(Fm}6GT6vviyO(!){UL&nbRvk+LwnT{m@WDD~m( z-AVD|q0oo7pPv*z0c;3MyA(e;U%0XKR!r#~WjO{FeTil2dhY-uV9 zexAoPzC?X0eu;B)=`-NlU#&D-O7Dc{t2YZzF71uXJMR^qQrcVR;@2M5xpjE^hR&pT z5AtUUE0o%Ke_rVc=%zDjZbgShicN09D)@GmN1 z+fe-edf_Fd3(3O+e-}Qj^l_f%PyZl%X6bd%e+K{ZWDFN7$?n|G?%c@k!3$lb*`pve znKKnQqCjzm2viprA$Vhi8x%B_SR)EsV829SxOK-4Y4^y!9Ud@6QsGhT?}`wbOl~;5 zThedO73Xl(hu97k|ApI{knXGOjlNl@#^S{EM1_|_>-VC7lk!Y%xFuBBLb;15`-FPmC~hbN*bWu zqS!IJqbI32n~JBVzeD2L6=yI%S%XqS*Y(x`D<`5Pye8V3*{SiE_MY^V|ibMt_YrT`Lo11JH#Jfz8KFr zA?=njKS9Nnfo*d69SAr#cv{O#2{|u#=9H%rvMPAm$_#`SR|n7hq=AP`lM!yZURkCD z_MqJe&r^gOg+~<55P3v_ugD&}`BnqI7XrT;&VLe1;jJpCx|uwYJ+Ic?)nl5HecRJ* z>l)PksSzO^MWss@k82Z4Iy!hx9(R@QEDeoFx@6pWgzOeVP8m;soyZgR5V%lag^s<_ zv$WXKUg;|}xVD$<R6A4Vz zjr~-2FzHCK)xT_K!(r+x`^AO)qC>^#DTaOEc27&CLrX6yVI@~TEZ^cyFGZRz2v+7p zCMF9;Pt#A%(9w>!RNIWj5R$l5K6j@~i5rTguX<#+eY(tT{U!`&VP5P#3yD!#bi9#!`EO!+R6Q>LE_bnM?ca5!OSZ7pn&@rw19G z^(yiHOjWNY7`E)fFk5CS{!}jp(<5E$fh*T6TeV?%*R=H)tbda7``DN+llC0jDlh)E zEKBqRv>(@b*@#~|d!?-x)|;8{o~K9G-KDX!oV;?apz3dKvoEZ-Iy~sw-71^tjgck3 znw>OlU%q~A`#BwJmapnc+F9EsY1fut%V*9>+PlKq6l<1UkhFJbld+XOtx5a&%es5k zuI|)II3nR)AN=bhp`Rf>eZp4++5Hc|Wf`7kzii8r_SKydeg3jaQa<7Kp4IK^yOw49 z?d9v_cyoGnIX0|F+B-YeE1$5RvsRsr_V)E6u3gj4{j{rItxs00?Oxr{le8~eyY{@5 z@UB05)rPK2G6Q?+Dt0TS_7$r-#NEDfefzRa9V)AyxrGy88W|i1DV~>-L2}=zD!T^?6n$!CHsAk z-nMsBC&D&!?Q2%9?Ofm2AZW;(7D@^w(6N45&&t(ZnJ3GpGN}wC=j(PTD{eFv>5 zR*+%VTUoVoeNVDtW%iZ|@Zu~y@u=h47ax7pDT_~DaO%Vvnh?$~txa@D%5%=J2TiCwS31}c5K*1OVM0F_6yZtZ%~4{N4n z%Uor}uUDX>Q+rfOnrdMZv!bE0p0($-uj)`qsb+_kD|>vF7>n1mx1X|b?V7U_p1bN* z7t)ikxu7-yC95HKyt?Oy@(Hh{ieULly?NSHuzl6+nH^c}(u>o+VuS8^S69kvUz3%& z5?Q%k`;LY>*|DlpZEIm!FgdvvZ=T3dBMgX0PJwRb>s797q^ zIy0tW4u9glwXV&{8{xc(%Un00e0s)}8ElgyTWQ4TzYUWI8?VCF(8dcVLg&Xyju*@L8ILr~ucG034jd zR)>SOB$nGYN59eGTOGd5;YS^Q+~Kl*tt=1C4o`7-j>GdDKHuRH{D;N7jdOUi!?PSd z(%~~5Ug_{ghc9;cDu+Mp@Mj&q)8YSc_@@p(=5VdFL6-j}hbK6EfWrqnJkQ~i96rn8 z^Bmsf@Ffoa%;DcU{3o#9AKZTnTYFy62gmX}(qYzbG5U)go&%0@<~n?~!~f*?U*qs~ z4y)J(v?;llwkxJ}pD?x^xF1KXS0(vr#C)%CW|!k}=n=-asDMl+JcDt~Vp1|ywinjh zB)(pS;25I?w*{Z{%KD(T2!}LvC5(9JRlU46`Mtu)d+$?kZ+!NERJBZRL5jMbe6v(hh;5mgldx?ZssZ`v4h<&eA$b zelPDH$>Tlce(7=$M)`H>usDLrR0V$85e#nV#rKffmS!SEXMF4A_vxM~jbMvtq)U31 z?&ZQ3M=+^Ze~s^}IfGk8@bWfGUaM%xlPWlu_f}!z5Qh7$5<5!mp*g}h-V?9JH(i4k zb44>}d^d?extr@2-yHMk3LlP~;~nywACE)}zkl(I>UKjEwI|-nRhJnLMuXwGJUSDpPGD(iSx7AT6%c9WU?U za+1(rHD~gotwg5v8-%UIA&1PI*&N)!YbI@)q|}rN-c{bFzSc|%L4BNLM{!Hd=WDkF zTZ-#PC&x$l<&S(bqa8T(`f_@BDf6sq%&tEweSPTXYn!icuJF_t&xMia>qCE3s)#;t z=;0;ieC2iTf|;dQf8CF424D; zjwTp`4TsD@{zM?A3ekq+G>MiC#}tus8;->!m)UT9iwyK_!%O1-_Rwu;pim)eb{iUMUvTY@VC{!4aY6YfZ1?_5{ot* zA0q>&kZ7TFE)t>*$G?Gh!G>d%hZABp9QTqPv*F+g^lig|9b|69aTgx5 z;kcYQX2Zc|ImKQ!9G58b{n>DYLeFeCfDNT0w-9YO-c8o}u;Dn5aY z+HgenV8a1^ayA_6xvgl!@iFBwx8Vryve|H8-zFOlk|~rI6J=l$;uWy8T=cy7bd zN&05P@m{#ihT~!-m)memL#Wwse1$k>!*Mm9b3)oJZgzN6YP69_yA>DS7I-BFVWiUb2 z#f_gVkdA~tQQir%eNO&e9_=(AtTV9DI2{{}2?YO0)YC)AnKeVcnM{}+X={x3K(hDg zk%ooG5Orxr6nMnVKhml0YvjiIC+Rj4$}%v44DeGk@dBOxEYIGUd;VGM(MCkp1IlTA znJi@Q5mAyC@kiJ2I^+^-cfjtUm|9j-c`{Ryomq$|mRX4C525gag^05dk)6hZ(V30N z+l~y@BiM+zWf;dhlM&fm_ira+1|+HpxqXO}{`O4z#EQwuB+r&D-S{F;GRu;d+^8hC zKv9iQ#n7RJ9Jz!}@(v3*P7Vwwa|!Q8WveVI=;jc*n9Eijg{tWKd5V8Os*=&cW$sAT zyqe@5y^=4Ott^|i|p5%~uABHpQ5r8 zjB_$;7Bwb%tZFP|j%9mg4NcP8*M?oSYzHjnuwN7?*&bRK4aruf9M+5TwSitc1POIv zM!d-^JvpnGRm(NB{}0>7JYxng@kz-v;3=_qS-y6IEDwU^$P0!q|DfT^KsGPI(#Z-u z7$7{O_Ajzb!cr<$Aeop~3}Oan0<%-QmnzeiXT;iNU~{y*QR~|YkpS-v)7+_|O9 zQ)MIbf_cn>H7nL8r<{Cr``jZ>K5^kGOO9?|xM0cAi{~yp`S8}EbB|o0bJiiCi-F5} z92w?p<}q|X__T1vHHgtV$F<*Q$=G%ey)^oGr`6jx}d@t*@d5 z)2SFP3#?@7vbC#M%epU_nso!FuB6m5DVutxu968=?vV*Bx82+6E1bK+bKaUlYQ z?2YrO^ANQ66;f@`)OtVK_=>C5ygm(eb|{+H@l zr=zR`{$q4CN4V=nwPOd`(S!Nsa+$2Q%VKW%ii4^e-}b!O$$B99hrMD+8HJ}LC`X^! zYH>Q9(v)%)9iR!z)S#@)8Ameh6UKxp5Q6jI<{c55n>$C z)~*HHniRac(8(j%_*)~L{DO_2Us?FcJJ@WE7DhVv0X8{HBAt5zo1D%_Z`KuTa@I#W z_X@VX-(C%Uv`*1I75lnzzsQ-QD@Q7f<9=;Cccw7o+Us;Z#Nja3Ou@@F>aa0l#+eLL z;|)`{P38`^Pq8@-_D=DoKmlQKgY8qK&vW$S9A513D;y5CPciOFNAGcXi^G>Xj56Qy zaD&6!9lqD$`yGDB;XgY3gu}u1DdsKMK1CdCpCS&nPZ0;(r-*~?Q^djcDdN|wS+YC_ z+ownmwoefU+oyVfqz@k8=1}hfi=g ze2Y2BHR-VXDhr#O@6&F_`~8`)*?s*oVht%Izl)fm0%pgL4}O{O-Vt*jd<&p26n=5Ue5)D2gno|j!4a<$X3P{ieWJM$GmwCL zs@E9Gqz-&;CT$(D=z|>!_iv86fup|(ZqtE#zxuG7blp=2@d=|3H8uK8-kI`m)nU%$ z?Jt6tH(s62$3;UP&(Y-3cSAlj+ymiUIT42AIjMRN$Tv?s7Dq71YXd}Q`J?{&{Eb!T zZ>wnJPfbOhzf*<1yk>a{7#2lmVJFG&9DK%bPqgv*|+K@EC^N zcj&MxEt9hH0WNERJAu zgXGNzL}y{&k>AT}l|1;6x3l$wej|AgMp;};9#>cV$v2g$%_8z%^S?t{ls9$J-ZjBw zkrJcsnlpK36W6_Ftt{f22VCp?;5i4)9;{8=mE5E+$6+(K3gtumtut_^X6&thHi$ykOpXQR*ofR$(!vnFnK%BBMyI92_ z8?$poEIce>(Z;MsKCkBF146Esm#dfS*yAwp(j_Hxqd*T$?#_S79!)(mx_M45_r%5&1m|Z~JXk+$c=+VaP zv(U}PY@3AUHfC275^c<`Kx$kk=)2I(#%wO4`dugJ5oOG5%tDDp8#DHEFdH-eXU)d! zEbuPam>ntkW@Gk43M8%*^k?L6py&%ST$rot=$xAZF$)XZn2i}vAh$8Q1&^&0bPb|yogfqdxsBNtLd?dDE?BXbjTvi8 z4cf-+Dg;Cuv!5cl4;!<0kbJZ;I~g2p%)SeMv@v@hB^GVW-j2*@WA+#5(Z=i-#N7oO zv#=^uv@xSk)t8MK3yhhK*?I6p8?%p)R(|DtUP5vk zv%e$JY|KtWh}oFEjR$BpW(!EGmyH?bbGeP#?Z`13Gx}+{jae{ev~_|;!)7*SbPaMF zv;9fIY|Mg5o7tG%Ol>wBvwMkSHfBE}i)LeX5g|{PjoF@mQ&M#!iu%yw`1q&W@QtHC zQ-VCAK*KqHJh^?r?&=>|nP*4KsBsm`sPTPRJTY#dVwclXijGHQ?h4hdny`ELE?6XG z3oSgw`w09mSVu<#VD!0n-H0fQ7gop7D-fPXZK+}{q_wPA=1l9|grzvL#ay)JNY$bl zmGvazavx!_5>|R)Wr}=BjBK3_XUY&3v&h$BVL2F9yaAhl(Eh`fj zI|-|FR92tJRyNVPJNdF4w&+BAwi?C`tILE{T9o6kyh~gd#TIpmi(TxnSV>&Z#nv0i z>R#2V9Qk4&Ebx-8wBbxYvPEIS3O0Uaov{3jN;s|+lrQ8_StKZ|YGW(l*cw6YRqMuN zOT=W0iy$Fer6XVQN6Ud|a5P_H#MUW^t9Ilo>11mG5uZha!rg@Bfbzw0vSnH-PlPyDcoMwZS-$V6Kd47>=mW>^Cf7on#q^1$yd3_ z7B;d~k8GJ5o?f;NP}TA>nFWrS-vp+xS_~B@7!k!qX0nBB@@0s4kFcG}*Kew9stU zTfr+^q$)1pW9tY#t1H*o*OIF~k-0O|9KNBnZ8&e+7DuQP|vF7Fbw=e0LqqlRF!Nm1v%&$VaZc`9r%_(x2mQdR2Se4POD zYikAsdx~f)Ar*K&p0k5JMZD=?PZ9ZpJw?R9o+9FTPX2KY2YZUh^9o02jK=b_(%~M5 zw>W&M!&f_egTvb$<|oMH2YZT`hld;;eTeZq;c&30i2Qq~>KIS3r-<|y){;?y$-S_a zOjZsrtR<6`!wYN4WaaQot|jvuwf8nA|9fE@tAE_l8`Uwfb}W1&ILYztvbbeoi_4^V zqhBP92hBfs_I1ao=&N8AQcZjnG0}_|b5wr|YN%MR*f5^Z!G-6o!bDj-k(8%nBtP zneH=ubg6duxZzD2@vmvoLh&yx)v8AL>Bp7bm5 z_0`jOvROKDnonnEch|YQB z9RB6w2V_4-5B;2&_$)_1%;BRPKGxxr96rtAc86CuyxQSzhhGbhovYCQ^xs$iQ4rri zj%Jys9lNlxEw99~nlLf)nRwcK|I`grRur4@`ERwzAuX=c9mWse#enE6-6`@TyDif1 zk>@^P`xX+$^9=fv$is#Hz`@RM@)n6^nBf1?F%}S=g`s!x>AqiOOgf}Xf5g%a&rW`G zLnUCod2}^-=SAEa!xk$5n;LUKj*anZeC!4_*O+1$e0*cchq*_@=gS%%+|@b^<8RS} z;Xce+*p(vq`(@o5yI-oB-7oKpJzHe7%JWV@bS96hvXr}f#P@)F#5Z}AW$%8>hm_D> zqMI{$){j})6S^@2+ULzVXx5Cu_G7N1(%i?0lWfb}txm`1Roq zBIl*=N|^2Ow^Z!5$KUG_Ht0S6-mREsyZ6tMYkT}L1;_UIyA68W<8L3m4z|bN2Xxc6 z$6psX?(ugeapN9;%gJTj_Ka{|^?cUca zo`&+;il?!>okHt#k3VKH<$L_GWT9;LxVQ1;&k(0i+r7I8G21=VF8LmR%(ck(_+v@M z+;%T)A859FOn=I4_rkt-X1n)MLdGuyrKl)TyQ9gC+eoucQ{SjMip zvOXL%zdqb!^5?dD>^Ga+?p?!kvOWHo5SZKU9e~7MwtFvClDX|3i=gGUd%<4R)`xqI zlFQeJ8--A_-TPPK*!plU$76f^9Zg2ec5e*=%yw@kA!fTrzdg6zqqF#r+wM`pRjGQf z54Y!q%3dAgbIC*<>9(o*J#0)k!EMO5mj!4ZUDPFMXTT%Ec6(JTuVqWBP4o%& zyColWz}$bU3fCle>%0qkr?`XFQ>;+>Utmi3@|L%!)o+!Ynhz6V}t) zutr;mEf>}+tQT4hsoutyuo#)vEUB#t3zMZoh6sm+$+ScnhKt@@D6{43FW;!Im+_gb+nh~Qu%8QtbnK$nOO08j*Bk5}d{5C*WVu1y3!Cp%8Byj| zZ~bq+H^63l{cB#cN-ouFcttWp(Pwl~GMN)fUmP}cly-BOc4o_W>HA-~C|SkUchFn# zJ!K1voxN&pr!19Mu3opHyDQl5E?c|2OWIVn+k0VCzQL|K#_uqWtJ?eAnQ0^HWLkZ$ zYTT1aI-bqd#qu!)x5C&i4lE43npjmqJP+&|d9dctZQ79ML}Bb4n=MdR!qI`7!yn!{ z^*Utf-}|M^-p3u7Kbl&IOyJGPl3BZhsE9Q@VyS-@9;wo|Iy(m9Dc#JQiUNG z)~br-e5UHJmGe0czhGOLmDLNjm03BwU|X4$!!v1H`AdCl%w`cgOS6v*YgNVfmr1V1 z6V{~CJB*tKJ@UN7;gcK=W8rZio6n)i;k#yOu{({?e=2OYm=8zH4?649KBk3tj%`&k)A_o~pykyHftM$VhY+c9Q&F-Zhf9MD>XKWqjJ? zbqZS?!Q@wxwcQa6Zs^7LPSx9HB1C6=>*V+8KCB1XA{yzEe@pjrVT&V}d`9vZsWNA9 zs|a3RqsF!Exk>$-%X_OZaawiYKB>gmjl~>c9Pf!&`yoblZx0_ARQKiMqK zF^{hB;XbRwF#dM&xyO-*eL`XWK9=Y{C=beIbPU6Prw%XgY{|2{Dku-TUD(T8DtYiB zPmek;7u{Z7M+K9&OWwBt(OFtt<0~FQ&QYe?M5JA4(m`5WsXO*=2qrh`z3j^-C9`d4 zKN^L~VAdWw=%DF?wr!A=LdXQ~DsPk7Hq4%zG~1SWlx2Um3xt{Nf;|^e(m#owenF>+ zI&d)JWEDVNlkLJjDw2xr!W{WzyRbck73bm0>^o(<@Rks-_(&H01i}jSTkxd~59v~% zg{!$mr;tp#?L$Jv3w25lU=$`@Tu1Uy>$8!Rq~T_HYDWzrSPX+67x60kY)l~TmZH^E zYTcMXT}Aa@??wa~e0)^=LyE})RgYkso7EX=N9M@0xe_;>{7&9yO4Hw$-uo%jpih%g zr(W<-rGx2ft{GP$^r;PhvFX0`)}(1gTaEE)ZkQUTQzP_A?qjm!?kK(#vOFe10Twb) zm2M?VRpg+CtmH6Q%?_wLwSswCZEP!6w7FsJvuY-56`!kWd+tm}#_JGXk)4>)26dG* zPg?kVRWy>_nPu&Y?vB-6RmQY~wY7agFP1$YjZftd3Q#>;7r#D|&h5D7{%*OgE)N(z z80)Z_<2#wR6XCVcg7>`O(b-&Iy7i{N0^3^dusv7j`c78f?4QNY`^Egg=<^)L=G5qm z9e#zwOC3Jj;WZA2{%8DGdX=MZ2FH%eR$==mdXwYX=6LwvT7D>Vv!CXfnH+U#aygGX zdY!6`{aaxZ3%0({uKYJihl#w z{^+yA$9?twS6U?+_I~Cpt=|7i^ChHNfykr3Yw|jUEebBEyAQr{w>|hg)NR?a;H2a9Kqn$7^e*;xhtK#o&78QznUa@xd~A` zAjf;+wN+Of`zOxLU^pA!P4ZFh=GY2&j(K#257+x&2?Ho)F?Ysiee$*#vRzD+2jxP) zQ_+I|PF*dIVDb?Kv;d;Bu-oM)PFtjZ&Xvo~{*}I?NQ3!T!j8UKi4F9x^cB5Fq-W0Z z7yp&?jaWCmRewv-R~LFNGq|s=&?fohvV! zj*C%$V7B2n0+L60CFL@Cng!4nylrpFu9w~3#`Ej%f9xd+v;VP?DiofT&gnOFP8l4S zgkKIuT;+d^Wfm&`V~5M9->VP7Qd4{-zWjfT4}#|DeKCuEHerQ&jPn$MMxmymKz*ty z6h4soP7+IDflld=3q-+@e!7hu6*q~j@(8YOoGxi2uVgk=ubvRTD8JRwuqH{zAz{di zb$X+Yq3P*`?qs@{hUl-|NHyITsS5xjf*O|#6p~>i_9TDxdTqSP&z{?Ov#v5x5PPut zlKv-0)iJczppeL@99I4bhq`~lQkpIZrelp0^)EP0m2B9)*-s()DW*MfMPQbK`qFcC-u2%}E!UL2UD=#PGglg#);0ulCEGi3crabUfT=J9 zoCY(dnjx&brnh&eKXL2Up5N2a`E>rp4f+Qz+u|<&r|V752J-mrma~;AJG2O$eaD|O>~%h zu{p2d9^>QVDcKxT`eBC2r^%ck>}A@XAE91FIpo>mhX3A3pXcbuIUN3bBhM=weW}A| zJG{o>4Gv%E@Wl>a;qaRreg|030{1Q*c3<0t?H~B#;Fz~Bfhjz>J9JpwyM&3$GyS2X z|IT5-Tt3gw(&D`|Ji=kh+~~f{TO6G-H=giJsd#eK4a*z#!+1_`^wWgxU;V6zsi(^$ zM&7v*BV%2}yk{FD=6)%284mR=mbtI1+?VCK)#1Y&p6~DyhnIrm za}gYrYZe!+jzya(Ou3mWL@-WQa9i}Zs*K4ubm9}nJxz^%lQ&O(`-}+&KCZoW2lFLw ztLVt1{7oMDK|VB``o2|;FkEllL4SNlh?h9A=#$ODlXaL=HiBEIv&n{VqYlqU{%|kT z0dCWQyGH`%>&kry=J!F}^76hZ|89<8koVrpD@(D^qd?^G^&yOMrcPQM!Gv|?KLm)* z!d@f4VS=vKjZ;?UENqhqKHbZd*iz9*m)G9XeS@&Y5lrruyk94H%WG7Fu}U=L(O#RpTZDdJ-p)8tV`_6{NA>yr0NKy)ULs~$n_KBX6Vk%;3(p$mXK+6Pt3 zDtQgM*~y}rGkMcy*_t|1Psk0VvzRky#-P{W8P8;S-4tyEsgDmmiQow*=_@{}Iej%- zq9THgW<-{}zHD#1s$y8bQ z=OZc?t@|@XOj`HndPUPRK5VX_b${5hK9e~t|FyB`gfg87{Gw<2_b%1J%1cY$qAJ6i_CIqgdk zck(%6X)F}}Dtf*j4Gq$;f6~e3wBJjppVN-yLTNMPxF5~wV$X16X`RY&@cYqRtC-bu z+OvFr5$SP18nidIA5Cjf_)vHnOE>AJZ9kgj;J6>n267Phqp3qq+>hp`&}~1OuSrC{ z9}SzJ+I}>m=ljt-NNk(a{&xcUozwnr%7D#j4<#1ow09ull&r{3A(=R*{axT)nA5(e zkB0Z4*M2mYi8Y_o{xQz|Dw{q;5euKSn?3}qj?E=h;!P*T=$>BzdRYkWld4@ ze48ab%=6tnc%f^?agT!3WU}|4|^fbz=lZ`38cC0FDjAcg!C zF*`B$5|>SbSN>j@2JffA7x&x4#zCUd+qmj+kbEM%9;zGQ*vlKe^^&l+#zYe4&g#IoGSjO+rqXO3x(Hav;du6*Edo;EcO=Wi< z+qoxhPLu7_lka5pjL&X=a^}nf8VTz|v9qc1JI>y1uk16XTA1yowX37aaVsyjJIZ#% zY7fO<**PrkfVH}_XYKh~R5yEQVV9v5=Xb0+&o&Io>qI*noUthqnS3?TgW{R@}hjzq?nBIMZdc@n7l-)$>99YNFg~2WBTUB6JiIMAIe7d_wc{(F^Tu?{j+r`|l9*gUht1E|uTfHtF9P`o z!^;7N7i{Cdj02YKg%Ex!Y@jDcIa74yNc97TYt>=naWjP(L*y0?ahS0#8+TTA^SP1e z+|AxMj3dYD!}!=kNy|{-ncbHBHVp9KPS-haCQc!!+0ycbLO_IJ}R;GaL@{`Qtr?`TP-w`TP;1 zr8oJT9p3Kn=N!J%;rktC+`;7h$zisFH~I*N$2+{g!|X0@{6{&w$l-GxKHuT34qxr? zyB%h9!{mR;;V_>+mdUpr{U;7T;xKD@njAKvH_XDfhWB%LiNi}B-sJFBhp%#Yo5MFc ze5=E^IsB-@=wvNFWwk?wn;o9waG1{@%VD0QpYQMpHBu&LoWqkHp5^e74xj1pN{2T( ze6hn>pw>-P#XTorY>d>PfkZ+!N zERJB1*9M4=baB|hfZKH7T4a2%Raf$-DxBx(pU!1d~|`{JbL=+|Y~fztk_9NQCH&Z=L);-DY*Ds57KXdY0}b!WKs`8LgM3 z84#U?ZI<85TO@fcq9Kp^Zt~tCY;gpWgCy^N9KqlAv<{x5xf{hd$2_{igS%UYVf+t>&pqBe><)$b za=BCYLHTkY^lj}v?i2R%9+tfMqM5U>?}*^#eOL0}Lmusi$)gW#?}lK~s$ZlB0nwQ} zt~Ex~6&uo}BJy4%19_A;b<-G>B{q zr&zz1C6)LgC7$-Prw}nmE^VjTp3^=VrY$whJ7)dI{Tw~?L1@V2X6Z2g&_9awqa6KMhxtw$ z|7i}lJG{c-)eh6=F};Z3pd9TlPldR+tj)_XXM183Beo~hA0Oqw_h}%$=}xv_NVgjh zouxZPeriEmq>q*7HevhL6UMVTT!+OGOg^AvUqEygwn%=%1l^-!EFd}yJ5GL|?tSu* z4(Za$Te{)7$ZziF0{T?u&g7jZ3fTGuw8m@?U=GN!FWo z$zV8}XzH##3j)3Hs{!h4X?zgY+bE5*HN=zJ;vW?&8q{`*2s%KW%M|9=SzR$hwO0!ryo@aL?pD)}} z)AXh0E$T=$B*zcE=h(&?tWGO7sAKN>`|A$aqyFLHuiLZk?GHCxf7fXl?~KLuszbj!lRiTs}lKq&DU#{-+^pdS1G%h z&1!4-rjvVU<(%G}yjpDs&q3$(zXj3{>xnJSD9Pp!;QJy!)-zRKWR95B7oo$cuEjno zH`%hH22x+-gAg0)Q9Kr?jnS5Mv_hjTE4rrKmKAf?!oyIq{h7KYy0E3hR_#RLjNvowyf8SP&}CWn3Pha zL|fKxK|cg~Lupx2INGxQr*dkxtnUW@fA-D=zK){aqM)}bVtJ@= zMdT_fBI^BpXXn3Xk|rd@0!1^QvuA(vpa1-4c4l^WcK0_kp3C|J;(9LYk>t{IS(*AQ z<+5(VT%4VIfFf4BOS$NZ%Q_ZI#$}z1Qny^z-^-41SzU>FE-UZ$jLW(n3!cmRAb1P7 ztS88haak!l zLNObcl}Eso%j(v5>5|Lp*tEuFW!i_7%bLTQaakRo_>vg@Q}&mFRdb>yy-r=dvC~p=<${^&aedF6%_%cEM$x zMY^8L>Uh_l%X%hx@LbllofgSRhM#E-MMUB*4;T^ zS|7PnmO;VC6mvtx7H!kb@(KasY6*QKH_>bD<^2cD* zxU9bbSn+YA{-|S*-GGsJ!6^5T;yfiE zI%YIoyFuz+oF&ade2PSc_~epyVYk@R=t_n2D)15)p2&EdIb5<&C9=}ijd}%mx`cHS zDxwqUAfdhPyjt?I8SZGTTN7^}MVI}H$v&5vN|*hM$$mV4ERkBJGln2YxMZzO|0kF5 ztWcHHU%wlOJ5^c<3zw)v@hW9Psy3-e`&~~FklCbK#{EMfC1XxTz@K#AuK#h25Gol* zl8Ja%y4BgT(t_mS3z^OfSjl+sQl^i&s|rtfw>>j=gV`(fYH?(7+7c!-8ReO|e!VL= zyLvO0tanuih`wViK#eFcC<|kYG~cQ;R~7Jy6ISoIP?(5zoe~`|+)b(Ja_`o|QVVds zadCg?l=C7qnGgk3rA-0sXx>SHK@`&^!sgXlVCJ>G{|smA zG)qxq@&H_~suel3ez~~As)^e6GgmdV3F}%dPU(_{M&XREbqx(G+f(tYk&f>b#kilJ z@n#3%0giNB+Fvhv^)@=za5w~Ir4{`LDm0lJr^V^-;A53YzSiM#jdp~vocw2nbD9~p zqn(oeIcF!)NyyGhs|#v#ZChh=-BPW4)ZMCJEk68TTpTPZ*=P&b2rIrP-fE0zxQ@$f z>+0XJx=E`PwKj->+SYVNL&61i?BNxwBo##~DVL_U+WNJ1DxY?7YNOi4&C8RLa%M!a z6_wc0Vf$7M+d?LEZSB&A_T)RmtC6C+f9Fq)hzo6}Z2FZz1Z8!jUI$)uZIYHKd&Msw zE}1joy}l)Q(JNSyD=8XUvu3GL6JFV{R{w47t?ez#Yn$uZ#u6fdEYO6QCZ{3n5 zihKOLmX%Ajuuwz0Xz~rU4Xv%O@d~{8bv?W$yV}+Dg0occ-$g=g!lk*2#~NGIp= zmVTxB7kJX!1{<3G4UWC;XsI(cG#w+lA?~fE_LbVy19LL3I6|87=`bn+kE$0vZUhMhlGTz!y$AzxVM(MO^@X2xneq2O)8<5EN5|Ud^H(iVFE@IXvD&7cPmW?&;c} z8sH^h>5~q)!XIOcmlw1LSNP*S6ZsJRdG|*1+?$o|3~g`&!FtEk$8%R1e4ldgm$07) z_%{K5F~I)}a39ZIg(26+b5F{lkLRA0Lm$sQDTlW@&%L0VuyK~gf&F#TtzqZ7)=^Xw z$d3&0$za`UaPJK82LpV4fSI4&?0+|qKOk)PtY0G6hI<<9^YedTpVrF(-a+r?O=s@_ z9}(ci0d5O0X&8^5eu-g{G#v8rx&50QPLE;w9)>3bnC~wp-#@_gB~5-F95u=uyyi>_U7tAxk@tZ4e(*uy-J(K5sc=` z9&?nLv#={92<o5c}~u2$fBfOi)5 zi2R|wb+U&Z_IQLP4EsB1vvWf*s?;;^69Dhb9{Zs9ql}E)Eg|PMHn2x|(-uQ}-x(%u zsAT5Mp66#av^2V99ecsgto8#adgf>5)CR}|=RV^ndg5oMT*>{md;iDgp1yDaQ-E$N zr``{}EIVOvnc9iRW4WI=98cKO@h%7Kv18elPZg<`^1i2Xc=f@Ve$P~d^2r&9p03Qh zn@_Y!;WlsR@hV8lRR3{>(vL^Tw302~g4t>&nSR_# zwSLLXXqNY@*DjM0ZAQKd9ZBTo6)nlp0mw4DZt0+Pf*MkimrC}#vRFDENm-Ku#kSEKN62gqlD%X62hsM^M5uKu&>+)m3@?4dSXFtBDa4zTOliUCvFrapEqxgxRSIj}Vvn0u0jsCFQ ze&B20tAZI34ZdDU!0N=C{{csOMvPjN-xIU%jK87YX(s_T%m11?0otiwu zF2w4bsgOB&>N;h0&cO4rn6@x4|00L*iFmyZdt?5mc&>J3@O1tf)UJtHvgw&T9og)) z&h&GtHEL>mCT==UEdTs@$6_2MY|AoiyT ztLPshm$QV`xV}$XHMwtN|A&jDKPR^@aeuT-_|O6Rk{@M%Ox(G-nWVcB{bO?T!9QIs zydbxVJZy?2S(JlaoPCn(*(td*kUxdKW+-JxtqkROhH@Z7ofo-E^Kk`ft*DI6smXYm~1JZ1TzoIf@3OaNbRI#0yn z$>hRVonKRkSe=wYCVznnDrI&40ku$~)pKx#l7!Xy3U>ZPlJ%~=NBQM=mbgWn zGkNZ8Vs*N^R(>r;8=WVg{|k9u>f(>cAAx6?OS>xHOh%fV+JyXh7&zT|s`DokvfO#5 z=MN&J*?DU6$KhGwJaeP|R5q6kchImpDS_c!H(Y&6z|;W)GxxZXcC1d$d}{$UE|51W z12eUXnY~yAP&SPk+4*T5UD;15BwUlWc*8T&+y$cMQ6Sui_bCVQv8crhMk$hNN=%>}&QthU zMv`Pd74xQL*w2K=ejUN}PB3;c<$i<1RqsY#R!aKg_L8yejiiwj%QzkYOU4|GfIkjj z|GUB~FBzAJUX4Ym=MQ61Dj%7FQH9>jWOqu}wpPh`PnLD7`wfjNDrQ#fTj3Tv+dfe1 zZ>ySZXRDf33=VX2McwI2Vf(@2PZcd`u&gbcM(9AYL2`qfTGkTWAuyuy*>OlTUXQ?o zQ(IYbmG?@@FSdqw)84z&kQf#sibIp7xQ8W+uMH;vagjyo_=+7C{obY1{HGmxk|T@j zz=aG-JvD^0o)$TiV*)B=rHRSHSZ`N(K43UR$g0h`kzFza2DZTl#}2 zE-itCs7Dk>THMaT644hml`6u7$S8zNl*U(=l_fMrv*sv}v7M6J5rPPAc9=>UVS1I^tN1sCh~D zV4b`Uv$@LZTWAi~MqR;P3sS%Ihe4{CiHs@``vxwU?y1Jq~O@A&yhOgKGFf_uEw6;Or^H5+R#;Z*1csn`P4wpo9>a? z(5KH%d@x;gIzC|Q_F$)v`$!>}+kDOtb;bkt@4$U@weF9Jcl@*vbNDBkM|=D{v*Tzr za1;3!W{&W~&7(bj9)8W?=cTVX{1Mkn_4r^XrZ*SZ-l0Fa*#rul*~x{rNJmtRq@T2f z#Kt5yz2Y$rNp#6~PdrA-5xyU;pe-j$kR1FR*bP`F?{wX^!`pboTUky7v2e%++CbfDZ-BW?p-+aU=PriA}B`CkB{@ zarDU>*!YlwTV;-3z2DgC{KE;@q)_GDRnuemoF?a;v*9BGOuIHYl838^o zz!wGh@&JE2z+VjT!vX$9fS(QUp99QXFqXGI{-Fv+?v3Ohmg@wz^3MmDk3%M(9^ium zd|ZHQ1Kb?oGXs1fIk%AuLt;h0e&*T&jfrYQ-FUL;FkkDtY0zRaRJ^Vzy}0) zUVu*v@QMJR72pd4d_{mi8Q{+a_-g^aFTg(zFoXWBtbQNhkWaWsH&WAC4Awmh*C=fK zw6l>ARuczI^W2{e_Rd zxJNyvtRDAxdtu}C(Kle09rQ{66_2ZgjmyV}*g*K^XV%!qc-SN{)&4fTKSMuF-~TSA{IlerIi} z3KvG7volYRvTV|3&g@N;AhdU%>={3cHb5BmrfI`IGTfcXF8wDA$Fqe_jUM&pNXOy` zM*ppC0>C@VAI~OX{vIB#@4u39yt-_p`J+vQ_MVpiM4emaEUYt6ZR%`pByNRM`A&cg1MAUuwDRVMYxaqtL6 z7{|e}SscOWW!YN~@Xo>>kw3I|k?f&|y;tMuy<3Sr;cc-qd+dYak51buiY}F~C!XF5 zO6)yd*emk%YFGDW9>p1ZPOmOF*E3IVPC*IkgrDZp?VhK%w_B5YQ@Ku(_kZl7(-$uC z{Je8TEi`_f$Bv)pu=shEJC+s3iFQYQbjP`?QCNnH&VWMnCsjCgq5t^T0`Yl*eA>s= zxPKLHT=qjjF*pV(nmBh=Zr5*uO1;Rr|xWPU>qHkZ2#W4-3w1@jx`zDiy^=kB*8>N$7M zBA zPC0jUDpStg0Maqe-5;qYEbUo+pc(CW(wUUQT+~5}FP9zVW zbGH`xQ?q5c*POdwEBdy`xjTTv@|?Q|)vi;{ox5rn=WYxKY@EAMMCqAx$E%!_bN3=1 z(&7}AuneD{6WAen5bH|-F<=m|x zedFBSLSr$`-F%E1=k71C_t1Mq9k$Hgz@}>253t2aVG4>_*aIiFbwL7SA8WQv;(EM-LPDtpIZ(wh4Rg z+?d-a>QBYINpRe`F?S=l-U-I+NBQ00aOFDW33qPnUW%W+G2zYiapFX(dkvhpo@W+J zNN~xVf&*ag9X8m_DOj8lFr80O^%_v%#&l-ARc_9D8{2W-Kw5-cL7S(z@!dvH|IYEa zuNEMuhUHz20qw^suq67D&X+zu+Z)Yi)5F!)VYF4nqM&VcLR(@}v+}8F)P@U*zc~c8 z-tb^tiE7>KH;B6C*l_>$v+ea!)N1D)eb5oL#~pmo@yE?SY~jJR3!;=m>DK6}4c1t9 z%>n+~wmqF5B#GM9E1^U*h{Pz~#LAXr!J(}_uU>6OX6b92=(JbU>}}3TYiw#3eR9nb zO$|z&tZ`EuE^S^dVHXqZz1iHer0C!D<;V5b(mD3(7^H4%kj{ARTdA$aTXo&wS6N$1 zlP1Mw7Xsv6Gra0fLEjRVnSfac`q4v$I=iYn!_Tat?yv;n?(_m(Ke~tEV%MSN` zc7z|_$?qs&Nnapji}jj47F-xNr;+)zUMnw*2RisrxPmrb(oNUC3M@I@^htr7Zym@v zQFvAa>*w(6$^TLkef%ty!5P}@yZU(nz9_(#2l&$g?&D{vFy#Ko*Hr7<@mmnOON4C zG5ZQS^eMQ;g5gj7-DCO`{Uk#Ue`*Jh=~E2zcyD2w|BQZ!ajAHZh{};%g zHcv})oC14zAvX1b>&$O@TKow5l<+Nxj~;!h&itmilGSK4XZ9va0Iu-?1@S0u62=~N zWcH>BV;>prqGXr;6Na0qO--vuy*bjcID*dJ1b}yzzs~%o`;@=A(jkAZ#&5b!;eRC~ z-dS3m`Avh=;5MqzvG;2HrkfRbpBa&^!PNmKsdwn4q1~D@y;Tx~<@}74XuG6KeOWo5 zFKlrHqYuhn0pOj5t&=~rH*9q8_)VXez41C<%$dC_I@y~gdzVT^{s#Fl@_Bb}>>JVxsy7Y0S7BkfJgDO!-yFvf zABKOUw$R>pWv^K>a~Af91fji+vWFh_UX9PexaybZQz2`(dub4Iu+5JkvI8jVv zW1Og$kb6!PLko-(^-ty0I8pb2Jtyk7#Pyu0Q^=*~L>)}r17^!wAsWPs!62 zCu%a5j1#p0rEcdT<5|i$QLe;1C(02OJSXb2Sn%_Z(U;j0PE@1p8z<@y6iD}+r~_3N zz2-zYf{^D#ZQ^jZgcHTUnUoXtPm0>+Av=Y`GfvcSDkt%j=f6=5$>nb%PM4f0NQfyX z>c7aCaiYFRNSB#5hsygxEY}YiJb4iE_(Z8Yjxl$Yb-6Wl=Lu z6m^|)qMA53n}=*9ri~L-g2y;fKS0emQLT77aiSp4^_mmqYRz+^T&-;ZCu#`U@|-B> zoW_azI+^mEsQ=>#JtwM`L*D{U)N`~>KM&af#O;C;RZqH}6Xghro)dK~dDz5FaZ&C< z^58j9HzMCMPE?uN%(lpha+Dy?iTacBm~x`rRl_(@M{~f&iJC`A^vsEJb2r*NWO+^* z<3t^ZrzW1Mn#tua#ag$Vs6$ltDJKf9PdX3T)6|)9q8RR#a-u4+*ohOhw~|abQ3cYs zdB{GFwsE4qMq@Ef)VnZhoT$GM$2d_(tvwIf6?d44^VyckkO#G);wej)I|GuTTP3nF0HSBV|iQdp>gZ*wl+q6 zGm$M_*|4P0VJ5PkiC(@6IuT3WINsNP_UfzM@xdBJB5KjZN_{hzEh)TJX<@G`5$p|R ze)Y{pwshLwjl1t%-8gwkQ)~N~6ANy=ara)g;Cdo@j%;sO*;ZG3*viJ1==k{u*Umn0 z{?YS}UvO~kyu%h8eBA7L^Y^RXZuWtP>0c4#Ad}&)4sEbUoQFts<);~Io=kILS*JSW*>TX{~hDivJeO_-Bx z&X^+ikovNEJ71W3G}qfX$=)w}oP)H30ou&oRl=b?<|JFB^TnKnb>{5dCVLyDggu@~ z%-#*c#NoWg{Zfftn@uqPgt6V`_ojD_IBc^eGiQ2tN)XOTcDMAVo09hE;U3Ut82?Ms z>kVg*Im9Smj^ouhdjzh>uy>YLXU^UgvWFh_UX8Q2UiO|aW7?ZN_CfJS%f!X&&75Q} zDX|N>us3z@>U|sq&;RW{ZSQG&&)9R?^gRoOz4p|f|KGj3dhfkO)|;`XUplnV^PFVI z6qKND1k+r)-E;Q-l{v|FeT{RH{jVCN#mZ%}jQ@RI>l8K+nH>mjXNU?^poO z^Y31fdiVUhJEWNM@8Crl|L!rc@$Z)6N%(iyVlG(+bfykF<==7R-=4*njDP1Q=GvTp z_YIjc{@uqo63@T;CdM4@%{rhP71Q{4oR-GF`v=yi&z2;Udl|Xs-<__@gYoa&v{il` zP?pRz{@uOg!1M1|UD5b=1>ze2uD=pa`F9^6|6R;UR=|?+@AgNjTmIc|l>y`5xf1jI zyKBjS=ifQvi09w^0&80^CmAy|8UOA@3Z#4f-8f~X*ZjME$cN|OeT~E268;^F*rxou zKX9bRzk|k;^6yHi9OK{JTnx$O9T%rd{@ovmV{?+-Ova3VcLV8k$-nywA;!PElXQ%K zSAjL--42^#`lS0`7{@wGm zPS3yFnYdl>?;L;7^Y0qTgXiC!M;-l#Nt5v1^J9pJE{@orNu<`E>AWF~tyYHiB{JVZMSmWRAg{LN-sq)L^&qJ+S{#~`o zKIPx7Bo{U(+4rd@gdY;(A}J5Ro%=EGf~!dM4MCxT^;+mj!oe5XR{fU;3?*dbIDx zV*>2HA^Q(A)V=X~b_g)vQ%tVUa;eQeu9gZzu5bOwq#Rf&!rI9x0bUm1_5iO7FcZ34 z-2V>neF6S?fcxerOUk@&ezK$-`sOD~%As$5vZNgNxBDIUNW zZV|jB-2Zs2*UQlp9>b+#r7Co|5C6$yxK#i2xJtOc!qH)VGV%zn7T(!oxKss?;Y%2= zYF}a8o56ufQttV`K>oB*wzz59=%1LQUT~ecPA`Zn!T1HZ7sN-8zR48tH+ysCuhC}C z>~-ckO%kW#CMjW$Ix>6Y2m8oy7bUy&pD-NXW_TRxNpFsHERJBW=O=qq`Quo~-`1F) zY=j!zn=wDxi)!4i?dmwFFDvKsg~M{`?fhg_TQEP_M4cn%EUhafAP+S@U~VtxC)=o# zx83)liHbe8+x(tm#Ld(EU$YbF{!Onl*XaY&ie9kxK0nrUb7j~-t0Xh9NK%jm-Ca&(8>Em7xu6l6n`{AnPN^T&TF0{NNbR`{@Uyu z5{%xj^Sln=9d>Y2_ugYKPjhm+p14lC@80|Q$)fQ}K$+m&@6G&VPECK}K3#N>R$}Ll_vU= zw;TC_>^)XFCW^igMb}lLDLZ8pP6F>L8K-A$=~2(!t>bu%!fYK!RgH7VCTKJH&sFG@ zzy9N0l)rd_d@B-3wAKZv^5U}F1;wSRQWnIeVwF8{sRrmEid?Gi#1fWgZ$>laQoRjf z!lmj*q=ZZLXCe+-hh`@GigwvwDA04Mj#Xf1F4Yl4Naiy8p)7XKrD6_}luHH2#kf>I z02`O;Bs>Y1YBlB(F4ZC(cFLuCM)K`1(4TRsD5fsvGILW(InGphu0`s`rTQi6z2;Kg zs+h*5x|Z_TXSV*MoSRI^bE$rS+;gdJQdJq3$}O|!xm0KC@Qq9LG&%5GssnYv#-%!z zxW=V=Tt-ta)nfAB1((Wk0E|mD7^QBxR8J`b#-(y4=DAdtlY!$os7&s3EO;)}7r|S= zrD8rK<5JyEfppKMdReA>&86ZQ-MCagrQo)NOZ8P{D&j2V~eqomU%m&(nIW?ZUENXNKToA4NyYEL}Ir8^Gsdga5xKz}2%B32E$GB84QZvS-`Y9gcQhgLP<5KO0rxTZ|L5J0AE|se_ z&!uv;wgp_O=g5}lQhkD=@asE5+cYlK|4_z$F0~nT&i!PW?U+_TBLEQ=5zkk#Prv5`7==KmP?gY*{58pgUE$(sXj$L8JEh#%c}NP1;ClYxz!&3P5_lMqP3x2q?VXy zBM0b@C%W${a1`B~cyLU#MS`PwUEQXx3+q0%BABPY^-gfI7J@YKz|1_w9&Zq_ali$w+oygT!I8)}q9#6*ARSlO-)t8&zDRvP5d#tz?<5Qn@)bt%~TtTBF52c`Zac(c^S=^ zf7~^oqmlr2?t#Ju$dkG%p*Wh)&YkDcd<*I^I{KW?N|;@fwj^N?Cz}G;@gR}}2sp zw%2HXWy2cH%RNOx^3CNws5EBCaP!DchNP#6nxkM7Uns+`l4<`>V}u6N`SnX;ZxQaptxi&RjU(PRnZX+Ez5R)klr) zL@ZJv+M3R4Xg_n6R(1^aS@W%vW-W8nX)(wZEefmCYJyENS=+XxX-U&cU`u0Tt#+?M zqay{b01;0bd+gBt zVulIytyhIS`j4Agu0u`r@%?(u_oHRO_dAwWh$JMj*oh|gcJ7Xx|s@mnfuPwRH6>nm-n_u+onq6d-cevoB6WO`k_OupiURp7y zq1-TSF#Nm{cnaw_Kr3yo?k6W3PLm#&? zDF;5q+4;g$8irZc%JB06{#$^{)$KB!Apx!o@YDeJaVwKD@8eb`}HUj_OvfW7=hVY|om z?_abt0PJ-}gZ=$?Tp*tk-~+%uKgR_4lmIUaaC?By5AZbsek8ygo0XML`)PiCfbW`NHQ@cIB>6kt9qTHKEW z_!9yCWPn|tgg-g@URHNho7rKWK$F`%f#^RbIs8;zQllq5Ru8Us2v78w{#3Qcls60o;?jqlQI)Ym58bh(L-9(`NtFSJLy=a|fyy@?WlYka_CGBimMu}8Zyd$a-UA;UeK?9zY2 za5J^h27A(*BOQw)=(@AaW>SKl`9TiEIVBiFK0(U$<;ncgb-!*qEqRZt-5l7CD0 zd|`_t7~Lm(1%P)Jwod-gUSVAFrVD$V_h#=ZVT&UeJtKSdT^z?1K28lva&u(w1?{mn zNSoQaK^S}0+HglG@Qc|5^G_JtZGLZhf7gT6Y{|@--klQoM=}?*zaCHLG9T!F$lw1txj!si+HrT> zSjx*duv{xCH~q)(A!BZilkv-;h!atjWtd7c{b~{TT5tivk$(F|D4{MicY;224MyhE$M^f>I>}2W1oIlQ$HAV4QJfoaf zT!3){23M30*ku6xgh8s-lB%epV*iR#HNR31mBozv`0pqS9mouNjU$G^fFhNl%u^XE z62gH?g)=~(-r2cKMJGA2{wPxlAdVKXQ)>}CQUA{A;^kXYQl1E{0KxZaD~afnY{6G~ z_c`meeU$Iwqq#;Ht8uyo%G%mnn^rDu)0bv<2KX<{V`6sB;$kTkKv&0(?Y(j|(uDbhC3>fR_e%Wq@73)2F*0 zxylN6kv4m7{GhPeybA12p(wgBz=EkhEy?0y+Hm-M&Rx;ul>wd@U~c86rxk1`2 zpLt=^pk{O;=g)~7s5{?MU|o1~3u?MctI zO(J-AjP?`EqrK&CcaLj)*iFjcTw(G@*<1dQSsn!4v*j%S?=0*f`H55GEx2WwN zY)0eC&Ul%~{wT5`@R`n2rNI zj)QBv9Y^Qqqc1ApUWJ=8d+c?Hsas28sS#X@)_!8r{||G1}kQ!@2Hu$&rQZHb{wlX zc6h&M2E1o**_F?fU-#`rQrT1GP*=#8hNQw9Mi}v&CSL%GQ7f%Y0MER8PoVTA`V)I=}eYON|x_QrQ?y5wJ5Oj zm_}ZE_%V&oO1=9rjh~fbI;QbirD$UsIjPbyjSKK3V;Vnzxh}>u(vr8oT7fpE@omas z7h@XvaF&c+EYDrYk+^Y;x!hk+@Aa6*dla*)F^vp~vH9VDpu({+jh|Lk*_g&(DyLaL zrt#z8S+k{?&%HuiKc;aOx!fQ5h}=Trb~&c;Eb`yQn8y9FWMdi`rP}?N#%GiP8`J1Y z%#UewbC&xtjqkyNAJh0f@D_||JVXc5%Q1~~KYBf;k$aYnY5YG9cT2`Jvi3karg0Fl zZA_yZH)vxTUmy*eAO0gnPcDBO)zjse#uup2bKP*9VfhYY8u@zL^_a%*5n^K+ZzLTX z)A$k|8`F3M9vjo>#!=ar#yVPvjcMcyKsu&zCqisYBXymQX=JU4UW{qH0W}-b$VZ24 zr!kGS%6zZKG`d>zV;Wtpy~Z((Ob~2i8m}Nzet!58>e7#CT*aZk#xae@5VwmljWbEt zk7=9__G22|xXMl3I~V0x%OdN?G`@?xJvCdWaj)lxAF4yx7RNLm$zl01jSTir$27XD zhK*_DlU6#WaS~B_9@F>~YBr{E95vYGn8sD8bvveUq{==W(|9tuurZBaqn>O`BV*3e z`QbHKVzV)ghbsMaOyllk#^#6r6xv;mY5V|2ZA@bhPnTmFo5@I*V;WB;5`I#`zc^tq+Hv%|6!PCme5a~&gyD~s zO&r44$-p{o^pxTad|P*eFW*Hz=@gB52yusmddnso2MzWlYY#jHB1SMlWj(|Vqs8;{Geuo_GTtb$}a58$4j6~xY#$7Uw zd?Yc(uP3d(;f#FAvmuAm^<=TrkeK)S3=15ZjTnYFY*)7%P5|Pa)8T)ck236HIHP?M z7}n*0M*nr7y8(^iD8`v8|j28r*rcD9t+~dP$BN+89OA7PZxs$p$f|1kpwb@;#n3rl(!t6N1 zdLF@O4<}NN+SKk#BId`~f^Q{l?Ms?kw)S9=|F98^?%CXZAkqu><;mBfT82*XrAQ4z zWxS-JQCL?hH^L+pH?;`ra;OWIDo@W~zjxyX^)X4$guNK4sDX_rzS>AdHx|*XX}DsU zMkEd_+VAfmBOC`gR7!Xvbm_YoCB)DO$Bh0f+^4RRzEO?Mt2H!^3a_oJf5+-34Q^^} zs9)XM)^tWg@xLqS~gm+WNJ1Q7vbk2FopOUd|{xZ${enXS6R~ z-ROqQwP|Jpjn-^yZEsmq-=-KE*oC0AxnZUG8dqwlu*^2D)F0o^NQfLMs*-R677lD$ z>N2vlZpDf^rz8|9uXP$Y*4ogvy1Bh}xf}ANWLMTQdao9%Zm3p=4|KI!VPV-~XW5O7 zP-c~vF1}uBSj8c)!)V7w&a-HZj)vpoIDNV9q3ovvC`dV~UDMh`aWRnV%!WFR+i+h$ zyC2e6+tw-zZX{z{qg&d50!)U0{7XX{(-L&wHEWw%7Pkc-Hj@l8(oALMYQ8qfzbc*z z=RlLfbZsGN1Nw-!q;{qIPB>+1@yqSh@Y^*FOp9gsE0dZ{&}uXoTrF{>s$b2uRiFAO z%erQYtG>CRZsqD#N~~_}nk8yfen4DXLj%JM>swaSrfbirbB*7br_2;gU94(pBg1NT zD_f%Ec-=@kn)(X0vna{6N>+_}d2MqYYbrFZbXUrxhAh2pV^pI%mGt4Wp{^}Fxoh8A zOARFFxN2>i7}QwcHYZomrk+ab?87>bG~5c=^E$jz+X!tqJ(?ucPwkQO_8J?=Cukd~ z4LMIi>XbVCcI{1vuH7gv=h26B(5DNBV}Rp2?RnrK%sN-t|BoBU*r9SZ`=(Dfx9B$i zX0MMKf$RAje)#1>-JmW0hEJ6h9sQ@!mAWrEMM-IgSz}3WNHI{TR9|a&wlv508v6R? z@b6|G?eXvH{WK=VAgPd+*oY9N|%VaSz8Ra;Xjd z-3(&nzL4DPlA(+4O1F78MyBkx*v+*txhDs=Uzf$6#xL@{G4@5yvDi38zRz?R*T`8c z#|6N~EOKFBtR9X!fn!mvJvzuU+E)c~E)2*yiFq(XpKq|VU@-Rho@khsh(1YxZ9F1* zLx*%mdyMV3c}yPm^q33Ki~t`1mO+jcY-1CT@H$+Wjsr`FbifsSFqAu88|iYvS{2|k zz|yCPz!ko%&hv8e3AV9}??aAp@3saXh2!t-SjKhIrA**VfVo0!Z7vJ>F}}#u0Ph{( zkk>-_n?7Z3_{0F87U1Oprp!&BayEQXfG-d5rvv=O06!eyUj+Es0RK6_u`X?vR^M1g z6^vZpSjMCr`o=OQ<*=h(sn|I(D!{u1_@n?g2Ke0pes6%8xY2B07vR3Jj7gclkz*O_ z%T*V;kKmRH8xQYY$hG0#8{iLuD-!tzu#bDKFmdS%+#Kk939Jow2iWW1A7G|iH2F&b z9;A+=rL{BI#~meX_r5)lD-Ld-K&K|a$AW#H7YBG{fX@o>`vQDjfbR`P%HwDL)LuQV12iKVw+rD!Y zohG?lGhK(wS=g}>g!VSb z-Z~k=9_nUqv9QGv6t7OtfohlLER1V{VZwINxWO-(QV_;7RhaIGs;F1v8ow`lg)Z!^ z>tt`%xa4`1;~3z>D3`0Wh5374_SST999Q@_HQM7&lf758#~#-uE0-IDvBxz5*Py^J zWE0FkVQjbgz3J_=Q`bD(JEccGnma*y)6Jv3<^6#G6Z}Ex(ay}7-n|lp<$TJnN&Db9 zcoksBu~FFK2u4@R-j@O1S=b};hxV4q9(vg0nrimA)>@kvjE+#?69Dhb9{Zs9qe*(6 z?#;Ny$8=-7(u`?u_5$9n)~0Nk+9PkbdavF0=p}FWwkjp0gW}xh)#t16cDv>4if?o- zeBH9?l`wA;j}{m4+}w>FxVa-=NSV1J;ch7hcfQOU*EUa<LjPm^dD!` zZsR9)fK7=cYIFgrpty{7q;*BcC{!HWz1*(fR2@K(gZnGhfjGE#pqZ{K0?W*Ea0e18 z;o$y*h=bOlnaNg2CHpf4dJZnPyUrZkW+Ei(iu^(9-E(k1C&iS5`yGrPHe1O=xd*|v zuE+^^5)Lk0NYBAtpue01svSNWXCwTT(e$fU6Easm0ojjcOf4i-%}QIxgT@5Tf)J;U71QbxH)1Q2X{Bj z8VC2UMNfJDnxZF{e;=jOB?tG9RH$)qzl~{ISLDOQ>2h6>8wfED?&nFzIJoqhQx5I| zLX3mkOrtOk?!kDBgL?vTY+aF;$$@cjsq2)3>-e;`u1G1SZCw$%GU>V^Hxb7;xJTgW z#KB#x%=emu>uSw&a9yo!0SEVQWXrEB!u;dL!M&19c@C~4*n1A{0t#gdIJiH;zF${l z8gaYe;O7Y@GY9wUs2K-$3=P&exJTouiD#;2a``sYy5-<9FeK&RE+H4j z!Tk>PWE|Xcs90N9gk>l?uPbtpl1w?clS$t=xbH^WIJlprvDmsI@4%>Wa9<#fad1z; zW9y2rB39QN+$Ds(2^`$ZR8F3Qd!VvV=C6V}Ho7A5h99Yins9In9XPlJ0;rV{Diimp z_B9Dc(qE6OjCMPUF6BY$u8j6;iHw>f!2&0MU2EcmOuI7=cV&NaEywyi@dn-uIX3Ov zND-C7+x6EX@u zmPJ)OZ5GoBZI%?HD!1-PA4~T2Wyu!T`55WRtDY7+%J{FU=J$%>S~BcI2kL>NP-MG~ z>CATRz>-aftz%OHY`}J{>Sn!;LsaYHma?0xE#a1e4o?EuxsLj)v0dHi(~<4^+U#;F zEJ+e(*Ql*$wkulZ_~ug*eOYIBAKP{F)jXz7n=*aMUbgPXYvlKagfhQ^h^HOsiFWJo zT`O52<6ok?_EV!yDX@@NleIk@d9_Gx9pJP|Jh@d=R;B6xw`nSCLa|$&&KkX@zP)9| zV&i{8>1q?bv^c9vGFwV%>y+Ku#^vWksFsjxp=5 zZvQ?s*0&a2bsOQSsx#&sd-X9=_gZaDof;uE!pK31uX&KHjUIG9hb$mwL^;G^0j z1M#iYLqdnpKc|VN_{^-%( z&yMgDI{EA5x5kG4s!rhv-!!>2h78j!VVqh&CZwLG6w{792X#c!AssF!{}QLvpUphD z!< z4saizQ-vY7huV>qRUe--DU&`vXHpJ*e9ojC#_7gm=g1xbJ|MvJ0(@G4R|NR10ACp3 zD+0XD^Eq|Bz+JAJGxs3w&yL&aueUc!ZXCJhKu_b z?Q9p|UBKSXqySG3@SFf2AK+C1CJoZX(HAj{X~TV-OiCx|Ct01+4YKn2CU1m&89pGq zqsO-H1np##m-CeHzaG;!e9_~f!vFA?zG1m+V5d@;J=;WKcxT|L!c`vAZ=B*WUy_&- z3Z1#a#>qTZ_+T%m@5JY4bm-q5?eSt^+*^TTndG$R{{qLOjlLponl^jT#!s8ab>>nI zQfHm=gWE-X^yqJQ=2Fg+%pQ^jQ+w1EacZ>T7Rla5?XgFDFni<&`^a!#Om^u%VL0lQ zOF~b2bEIQ&1RX!E2H+j(;yQCFtCg|!l9NAOlGFSx6b|jZDF3^3{V-=?v@dMe_<%3V z&>R`U9_oZqezY-*BN(mPPTaUaV6Zcn@>oUw5)r&JJ)RlEbYB`1^@>ZG=_QwP*x2Ox zjN^DUE@hSMEhw?v6_4?XPWhW9dk;#6J)XO)Ty7BNn5wnm*6N~rN$^U6Ft*$L-t@{u zWSlLTIn%pS0_xG+q0*af9_`V?J)q4n{&S?~Z#{U^uzQ8WaxSk*>XYM8l=L`gpch=q8P(IK6`VV5yK@encSszYCCcN}4rTJ$aPm5$RKUE7U(fimiD9#YEExQ=;}l5_7Jv^V*K zs%*+e|M4vX@dlOR*hG>x#^SmXcj&0JuEavwfcsHek{!;jJj>_?tt-Ke zB{N#;B^AnQl=-8gl;mI>WFYO84th6wnd}QlpskdSN0NndB?jaq;j&EW;a}6f-?2oP zcPWqwJ4=s58kNu1AMLk4e|jO8>36vlw<|9_^p6r$+=S7?NIa@wqQ}ysXkeKrvoD^b z;V5OAFgJghU@nsxpu=s<<3+HMqQ@Ug`MMq+WyK;D+OvCK5u7o}*>^YDXTr#rzB>Dak)~6>aeH;0VBqfHJ zWoLqO75D0(v-^SvRh$Qg{~hHkE+Pl}frnL$#m@fV5fx7&KLA{a22l#efvi}lTzC#- zh2&B8aJmocc6gE4#)0gIl5rr*`^!iF!5zrxX!{=sdk$n$VhIPbq8$^*lW3;mR4gPM z$O<=2W(N*r`E@eE=1mUFz?<7~VCJ8Sw*6$;@f^sCyU1euqY8~GI1jR`oqd(@Z21O% zT&ge=3p(EXy`+Cej6#$jNCw^+AFob9CjVg3Q=V@vdUE*|;+*Z`49asdWzUIMW)(mG zKT1=~M634jJ3@O1tI#JMJZOa`9GSL3Fia(};>q$iGReDpY(3JKuh%(yXd*GjQJX8Q}>PcTke|eP4J| zg_~^m{%3@%2k6UllzkBU(}b1FhsfnDVP*6C<7By};&$x+@OkOasd$XM{pcUUhYqN1 zR@@&GcW%W_q`MLQV=AVCf7&Lzpn~<*vYY-Pyr|+R^6(_rnNunpMeZr|H9IIfYGo+L zGn4}v>b%HRn(YeGCG#OgADE#yT?Cp-5W#tUgc}qzj93FR=jwl_^JRuZ57ZG29hca@ zO+n5iMN-sJ>_;VVmrM@Wom(Y|e}LM9zYb-maabecU6uF2m+22?;?WAvyQ|+=hok&X z6hxJ4u$lZ|qKtD5sa(m>x&~&jIe159X;^l@_!Aho4z>Lqj`BapbAa=dD%sa%8tEw$JY1zse6Y@%LCfj9eHq@k;9HB%h_>I>MBh_$+FtxF|X03=;d` zzbh4(iI=It=YKpeZ zu5QvQt-}%@O`FAyXj~;90rC7@)B%#`D0#*xXrwy2(M|G<5?8QI|0k8SN-{9>q)YL9 z;nAf!f--l)S$8AeKomzmJPor4N^OKQd>V%1`ED(#Zwrp(&i^~v8Wo@7?4RuHk2y-> zvMXZx2&g4Z8&gpw10*#2rptWq*PhxbU13VGy(h~Ym1RTYiVD`Aisk9287=*+liVod zWH!tGV>FHBRNW)D8yx6X6m^;XGB;3bUg_F7I4&JfG&sOdkttRlN&`_M)j>`zYw7L~ z*ivckI3yacC&eBl9H=6Xvqu16U{ryPXJIDGfE$OfI(Mq#SI9Xcmrk70QasTc0vQ^i=IIdmN z)>6AnQ{FK_T{2rDl%Z+UHPPIP22D@2vR*R;9;Q)uJHPNTguZP_U?`5VNotK zwDJ8DtS8H@&covSrhVVuJHR|Dn|w}yj|lK_0X{Lnrv|tw!0iD(H^3JJ_(K7{A;7l< z`1=9=d4PWt;1>h@&j9z$tEa+{dn0*R)cTl!OgOY{!NZoSsTW5%6QW87eR(e8)gKu zVdjJ|d|H6l26%mdFAea90N)hgF9-PU05jCr(&C-2;k;gc7%l{OQh=uicus)V1bCn> zQf6nD08a?;UI9KZz^4SbDZpn0_`CpL8sN_b_-g^aFTg(z@RI@lbAU^AW3c=W3h>AP z?-t;F0?c=Ki+gN#Ud)c_TN#gOa)9>$d;R0V zz8%&Ea^~B!`^y^S+He;KI+q3bX0W&Ood6TZ@}p*zVpL5Y@|$?YY4ULa=B=d3={g!d zFu;cd_{abs8(>wb7R1n>9Q_C@2X5_V^PB3=nw+mw@N{rL@>r*Fw9#Yo{RBsw~ufoFPxK_tOIdB}j z3Af|eC>+{rlD)Z-nX|A*Bna)@B75jzPgI)J9*-T?<^`iK$lenG@5~;1f7x;&SLgzF zjD(!m*dQ&+o3;_Lo#z_ugJ%NjZ-M}IJeoJd(G(W+-7%BdCCOmzG_*|G{YU* zlE1y{qF+~)=1NAs@c!$TEq<`^){=80mL0Csw3i>wF52-BwH=4c7A13^IZwQ3kHzDL z_xtsL#Y4)j{B`+t_bf_cRm@pYx^~EOzY!HEn@DciZl8~=t(5MQAKPO{S><(6Vb4Je zpL!{calxj4Mr(&$l&x7)e`|T}vk&!qPaV^%DF+`Na#6hDtGj$=-EMamuDbi?>{UZ< zExW7yA)mk98q3O~Raf18)sT;7Z!J6Ps;jc=?kKGKZei7&yOZc=H7=a?mt0BZA(2ac zK&5i}WHG0cOGmyS&QhX#SII-AzsQVBm`O={?2eoCiV8R3AXU3@MwB%&U8YiQ(hK4S z(oXar@1ydIWBKTC;&zOaz2;~8s*vVq8>cGN{A@Gat{*Ih;{0q-EHppcEoheaYt$~o zLw3neXye&T=17H?R?J4u_w3T#=|CO?GK1cSVkSFEDw)TTj7L&-mJ%pg5@VoWCUf|G z+Ly18EHm#DKrTL+Baue^C+Uw9aXbD>Wvt(SOR=Inb13I#?mmqAsoEX}A9b_zL{vH% z&(Xic!}smXe6GTog(`vUPGcmHq3vX7`*69R3QaV7KvVbPRGH1{c`U{kgI0qcIMwx1%OF8_Co1sJefG^zf7`|q~s1nG^O7Qi>7p?c1ejX07khh$bg@!?fqC-_zB6& zbB^P4!k2|FQrTds|E>CC^Ckyoz9f%mN)*oaN6L<9O1~7&acRxA162y()wA`VksaE_ z_9GOasoIWK3`ec`sMB=RnyZ|mqt<*3Se~0gp8Qm8LxDs40pwJA#?K7wFpsE@Z9`Ccs?f5 zf|f_g|ARyLMEpVJZDal^JXgCicsl=Is9h5uD+ABu=i#~5nT8NWO>N((KM|ttQ9=nJ zs#t4ZnJr765C!zL=BH|Nwbo&(wxHI&ioUP4yIig1{wzuMo6GcH$bEyN`1T7*vnuBn zbiQY_vOXcVk&?XcAmK^53pw=r-!5!~DC`>{id-5YinMBS4`Kg@_0pe{TT0v?wFw&` zinw!gb4b@u)%JGqPuD5dg50?j%qF;ui*hT;!;_KlDLFUM(^IphJ^}=zVZ<7k`7`R5Nu5Iv)DaE!>f;pTOj0C8 z9mPIO0(WWVfZbVKlK6R+_gB2K1svAM_~Xj^;E_rWLezH@o_E*Tu@1{aLD*DndlF@w zYe*2HXk7y{*c?1g`GOF&qk4k*Z=tro!%_Zkcn)x$viz}}KQ-}8Y3K61EJ_Jc{gG8F zw$JWh*n$wEmSC}gT$~uYYkwZ1Y&uoj7nO4nq6jI^_s8NXE((Mwgo6)Ok`SW$sln%` zl778w?@|6eXfKJW*i8PzN?wF0Jh}Y!7;SW(e10sRr7r%6{HYkQsoKtvvItScnUFB5 zPIsQ_ybM8zB4m305KK2aPfh-KJS&`MZq%R3=91wK8bTB$Fr4d#t4|3=3J=UY>`I#Z z)o{*yYXL{Nz?ts7t;tk(Y-*klIMV(F4 z#f@M(mH2GhZ!_MN^2`?a0vLe-U)WSL`i7M zIs(T}R|?r1DY&Hhj4zYf(lKih@TXj#uKx)<1oZn1`Qez7O9wfM#`ChWbR5N&M3``| zq~$}F>7Rlbx>$L1t#2sxA5CaePRiY-kHbi=flkK-Py8?$Eh}}6>{a+{dfY9o5?gHl zic;Cnbl|TgRI{>>#?~*Sv6UC;WV+}Xjcq%lu~mdLwp>vcR@t`9U)xosyGuth*$(lJ zWi`XDJkTvKJtAPO=_!^O@r=YK@2KKjd80edl?PW%HNg_lV*+|xrHLWm6=%ZRoah!_3zy4P}*c~kSdhdK4aR9sd^3bIuZfbwl}P7tDD@= zwrcn4>606p8*RF**L!vEWi2ZjrZ$~Xw{j|sD6#O`rnaqE)v#iWH6hd^vg*h|RyIi!-LB{_`Dj1Ns> z5t``0$s|Q3PT9~~bbFI@ zHzIc*DK4{KWIK1Wn(kX{W$|rhH!L>xGGn`~q$JcuX%ChfVMp zZRpVb-`V4rv^V>7NpTQq!8>WguJt;x^B*@wWXIb759HDEKE&K00bZJz!@rw(w8y`% z_tS#l)z0yLc7)ICe|M-M&PIHsqwkmD2EzVA&yQu+4o5uK*p=AMY_~@=YH(d7I@iSIq+hJQpm3v_G)TgUM?K z;&RnI2`rtw$F^4bX~?CsUi-x!b1cg|<`~-pd=^-CI4-cwt$Br)Q@r2`UoTf9mwm3# zUj!>|!DCxzo!2PHId-tgd9OlT?hL>7_$BS13-BMniaSAju;mACGV)24U^@P7sPTLFfPX8GhBfnf+8 zhW`-Ye+0NfZNzj~%hoXSrWuANVtBs*pB&(&0p?Y{>7Nte_XYTC0sd})9|8{Q`V=fKLc;Z+PX*!eMD$ z6X06{%oI4Lb8mnj3Gk)>GlPWbzZ~F2A( z;Aa9%8Cl)wv`#TuF?q=Mr<-N+kpZp>@Pq*G5#YT8ykCH42l$8pA06O@0j6(hd1wwW z&pIYw6X16S`1}B09NOn=hs(0?#|U4Xw3;I9PuzXN=CfWI5y2Lk-F06!k!Uj_Kt z0Mj3}{Lr=xm+C%lxL<&w0GOON4~EACcwB%d1-LrE`viF307Jc1N^H1 zKO11(B6=LZ@)POXHQ@?o>kyB5ZaC6o##_wynCHP0Jw8sj)??05I8~&(Sa_Ak4Z>?Y zUM_sL$Lod9^Y{Yci#>jyFccWM_reyLilbjN97dkmh1j`N1vFX85!KbB#6m+5l63 zCg=KTm^w2|-5CCIfbS0Qg8|+c;HLxpLVzhFvstckF)VSfTtQkCC+8Awnzm|(lD~|{ zyJ!!t@&51VWa2n?)<%57IPa!-zu8+NKi67wW^bYdp}hs8>aj?VnwFcmw<&Seb%-^Ch$$J{|r!HZdKhE>e-W~G1$i>Jz3p-Z+ z(B5ORH%J-AUVk4(`7PFFaRj4VB%G{rF=t_`B`{3bPX|QN-vWWbRSFB!eNF{`nhJ?@ zNslo0=WDY#g3+UcqNo7y&cfEoAKIHIDtDD+*i#l#dshit9Kq;C>{;amVOI!;_EyOr zix*>0QBr$c-ll9@BTJ0+kV&F!QFr<+H6^l=wXl7v4ml7 z2W>&IMyKmUeL^yGW{-W)jH3T%?@ZwAD60M6J#+8OBy+PsE?GzdHFHmcI(4eLy1H+5_xV*#?kDb_gk0Cyz#i>QU-b6i%v~#)1+(Wk zRa#_e*@zA~RikzrJ+?&Xc#h+%hN?7Gf@`0*i<`=+8q)!fs!IK3cE+iyt5RbGEE-kD znEJ(zEsUv89klyrj=t}OHytZVyrxg2rzK@p)Xz4~iaLM}(ux=Lt(rEpsApacv?v%* zNiybbaG-8c5p6k8w@TKtEH5Qz>psMJ)&I1wjy>(H*qTg|d_N?pQ%17GGq?I@KTQ-MYf6r-KC9H`ZjMGn;KsBe@5 z#gL`UfqD?5lg4vEg~!0gfjWjr#(`Roxr_t#VYNV+1I75Y%U6|X9H<HeB_We(JNsZ!eEK#j+eaiI1_X`>vdmsA1cK!p~I z9H`Gyf$0>QD|{LYkpuNh@MdtJnEqlDIZ%UCl}+YA@#tn8s24cg&EY^X(|DN!^&CfP z9H;{@YaFObPEHo7DPG@_QYfw^PrDo_hQ;~Q((#ZZV4(G5U z2P#$blsQo0u3;RgQ5>*wpqLV86F5-JU{mHmy+On{P=VyyknXAWD-=&AWxtehdiP`l z4iv9-${eVr)WSGWd^{?1pgzNiH4an(i)}bi2kDY6bD&0Z{Tc`AOtkeyOXk{epw7Xl zx`R@R#cCqPftrf}<3OECMHU6MHXNv>q#PGg{-qqKE7eY|IZ#ilb*oM+bD$WUr0Y)8 zSh5WVs(%XyDxF$pKuwi;#(*NrDT-~^!hrfbQDZ>eO~e>bFAy;X6z>PN=edgq(Ec)0 zTCPUS7*KqF9MD_xZKO~a8BhZcl3)i3c9(LUh(N0>Y2ZSoG$>_CNP*X+bakhJXDOjk z3CG5S6(P%NS-&o()CC$8Wk?z+O!d80ej1ocHbP6+@gCe!nC42Qe+z}Ff1ohY8lo`W zB}=ff27FHd3R7L6Fi})9HOnYW572q9OkY)=jKcIdf~$gHhZXd$s{@V{CXPI#FgdOg z2c2=1C^~V}B#wFmY7+D6XVfIBw*fWjb5vjpHR)|kt-XU9e{-lwtr}FiMiTlw&FlG%-x2`qq4+Rt%|sCN+siC=poLsc-2q#;8fnSpvKB$_bz^WeM!K z|FovOND!vo5o3s-g)6iP-k@E$SB2Moie#arT_g`>sncUZSm`#az~NQ_RkEe@!%dMo zj|*m|vO6ch87O8JX9$G=SfI_3hZZWzO)yQ4WOt@E$U|iQOeWU<5GdvCwFft%hqS5o z?06V#-C+GB(e)eTVW)rg$Vi;|@3wG+=5)yF8PR-F^V@XR&Ui!6rry&WArWp`ctcf{ zeFCRuLqyYSnSJ63^VI(WQ&QcpsY&YU!>g9U)LT89 zE{yaz^;9P7m$YfcilxhvxeI5D7Z;`~$C-P{s>MoL+H|63#vVSR<*yZqGjL}z;*Z{k ztMiL~xpLWYjf-b9L;n1wD^FV9q`E9w)I8TJG)10Z zd29qo-Yt9`8o`2=kTe+fm5Cm?U8pR7Vb6q>t-e0$i%DqvmJF5Qy!$xkyCqbHudP1L z*SnTb85j;e?)xR>^=L^Hsw~f>mx(LGSIZWaN_};tCt9F1z8zX1KGY)G6UVQOKyQLS zgAbbp(#uav!o=rVVvHZ#CVsr))*G?6rcJsHNVxra2F~U%a$1joGP<^7b+<#cX&C^y z-{VlTe+uV@TZKYNoAGQA!M7lkw87gLt37uQp*Hzpq$cx$liQ#AOk_%xKcEBdi+dq>QjX#!YA=mTKm&>VzZ`rOGTM@-%3fTb@N zfPjrpvpDK-S6c&?4s`|_H|2^b=lK?F@*9w=EbgY?1S@YTV&lZzkDNkd_*bu;aI4DQ zLmS^L!JM-#{FRK~Wd6cGr%mFG>RE?hb~x3o&~&!&SJW^HTlgzkJ8W!?gf0A)tbMld zSF(0^zwuYD(_q1P8@D)oufvZz{A-6_aQM$){eBT%5$3my@x>d+<9)k^?_P=%x`3np zb`Fnq_(KjK=kPh;XmhQTGcBS0hTe!gmUX|=dBovAfTNu^9PX@&o4lvPJ32hx;aLuQ zo(jiFeF!;ihAGl;H;3iYSeE}Ycqdbxea7fkhhrR`r#iWcKCXSZ*utS4&UuCV>YwN)2rb}9meCz{2_<=sBH2D4&ygq@)Zt;@g)Bg7>nC=$B@_b z|K0qIk*bUFGsXyy*L4GjV65wWxEM zu<Xog0LWx52ZL@iuN2Hr@u;it#phj(9re<+G<9<%yT?x2B8{ru}fG*a4TW#bgO^=)#@F!+UW^dgDgC6@K5jPM~ zn4%wol`@1qp54vfXkqLlBkVxL1&i(}89##^=}nN1<-yEgMH&DxP%fb@e*(V98In`K zYHe1(8N%M)LPb8Q-$@IW)|NjpaeK{|D?`}RPjcDb9AV3YjlbwebW`{fCB4`^S&JZ+QfhtMr3i0>ofxYZNC>gEqqFbRz4u$DXQCws*0x zlcAd=+a1qRqlza{ znaNIhb;h~X2mI~L!IgdYom6>xMKZWYZQYO__w`O5sC>MK^wK}%GR+-2k3HqN&whTZ z(iNqVUn^y@p6C8UREfboK3DnB?R_tOb17gwIXRdQcG z*|$g42fM6*abc-L=Le5q2Vhjs4%B7JOQ>)2eSw6+`$WJi|e zrIxqyY4&b3(=R2j=^jb{*8g<2>XG7Y_vK8IOpr1`E6?yfzOoMd6Fvata@BuRVjj=q ziUZSw5LHw&aMBd8{O0GcZbu~f8A=q(gR-l%(hbAz>N6;A^0hz~Jjor5G^v@Xe@|)a#J@_a zswrEO&RXe)fpzUrj83BPq!tg`+#z2R%q5k#QU0ONk?A@q=BA!1SjbggETw!;2G%k) zKm~QdNnSjUvoW`r)DghA)(w_(wOb(`39hNVLWvnJ)Ur-wh9l48JSD>OV6a|Or+;72 z7OJj-o)8w#1LAQlwao9H)%$3ykIhQrDD!({B|VSzJ;8hz};(qBLn$y;9~7w z=Ilni!U+rg+?*lF+-T$l|JdYWa90(YbfZ3;;{6XL~Tb)WRCR67m-HHc^ z{Gmj0X;M?te!i5#foQE8$Ux$GT#32RV$*<0ZCJEtI)&zHIq>|9>m{$Lh5DU8{7zxk zy1`NnBUZL(vRf_;Tf60GoGvU+DxSyhg=>EyYx$MHY{sbks$gGs=owvhRf2dPA6AZR zt(%~kt#uO=v$bx3HMRRtk4qYb3$>&2!t20YyEe|5FUG=sGS$77p?LmM^n2G%0k6MY z4WqSg`e+BwgJ`y(#_ANcq<9EsKa&1LqrF^lD_Mz=nj#dU7%3E4kVHHW@^mlq6-;a0 z{7JPa7AKH$T1e?#49mHEJVg2x|3=CgX-THbYuyagFJ*nPTGbHGW3(cJi+54ZxgpQc zVjpU7UWkk=%99+P2jz?|epmm+^I+kMvBfKhT#z;>GOoCcJZpnmL-BA@J{^{-nNZ|h zi|4@!o>)8*wa=%V!O6vHOn)K0M0I<-_yWgsX=sCIik0NKEInGLpDoTM&-!4RwQe|5 zUGC98@jQO0g0i)4TF%;k4w9v~)(tS8wQsnycB?yUx4E-+JNoggeJh-`+BYT1-$nl| z)k18{-~GDEtgrnQmAZFlRef-6Smfz}LxqRdepRXY@3JJTt#yNaTkD2e+FCc1)lmBr z?Ei3?^e5C_K;B1B6}Gi*$UCuiI^{l&{*>C_od45vg{Rf7r4CPQqtuzT57A;zaYs9< z_Aca4qc5HZJ5F9Nj;9v~(kn!ft2JLyl5Wm3mDnvubA}9b7ndPKV}>1+)SF!0autF- z*U1cr?$ilG=v|qLh;8~+b`w)Q}?8XAGYDj9jn`e*C_BjmSYjWb@4pHy}!r{4e>lU@?7y3 zs=0U`q|_9d9!oqAvar?-!X8W&1<#|0I(%^j<bOiXGx+1xV1L9^BkEzpPiMmV1m3=!^@`$cGJZrgoWq{?~#%dK?FL0;{aTdkax z-&H$RjiaP(pOoqJE7z(x!d2SRb%XTW)ifuSc`GiM zvK`$1^y@B2NdtE6%kUC4)pqgw8EvV}Aq1n`m6C_I4)k~u< z{EinWaIItmcaU28Cu*bBYigxAT+*EM1~Pn1|D2`N!6SJhv#)kiD|V9L&l1!%2yi;G z1#M^{(g$r#pS&_1DV5%T)(IF?hv2Fp7<8*nsW>4d?!XKkHTw-xo*jqiU-b<@8b7-c zP|;+^mzAMv0;lkja!Nqqu7kYSXv0|)DX7BO($F8rn6t-rnW_wC2k7Y@;UG3m2TdG!Xa9?U)83ci}r54=8d8d zOStxHXq@6lPS+?#;K4_+$Iwi0oSn(vYlXmJZ9M)c` z>=Aem%R2Rxq$+SS((vC_PJs`RN%BGS)KC+zlW{e2v8>vlpZzCq#_*`L+E!)j##G6s z)={DUNVZP23ljaWQ7%`C>F97-Sw^|Ea!s}tj6{-1-*i-lL{iYu_b<&Le8>b~@dQHa1aEzKjG75E{H~S=t zfmYtwn5}!`4>(YAbRbz9WNR|TMOl{2(ODErLv7cJdvI!UCKyd|jwW|ba= zI^>r8Zx|z6R)Y~~X7RG-Hof$%nIm>$0?{XQq$P92*$KTdIdH%I_ACvayJA^$^U7t* z77sh*z*0+O>4IUq3?HR++=lJ8>#zl*$IRbl%*gq}<}F&W@}wc9(Zk0M-z|I_ENQH! zp+YhY4D-{g<*r_T47i zliz}|Ni_Bj<3skO*J#s-I{0AMX}^;;0&?)y+89zW+$A6flZHMcSORjehU7thlJ*4T zV0@6!KSvt@IheAMuh+%^27Hw^0t^x`Iu+XP&^ACDI{4abAMxwjla8G6GJ(7tpylQH zS5I6)XP~hDLLKUzobM0Vp>Def+p*aA8TtEzAE1qX%`+eN_<&%6^o17Dp7@$J@$=inFK-jSnYjAz1nsbYTbuNI z+Qb9*CHvtIYliWQ!-zqg$X37Uj>{ss-R>G~c$eK1`8j5^(b&#bOiEzs@1Z^SGUOaL^G}8`0@ud2q717i{TUr>fNNtLPL4X~X#b&z`Hi68qp!b!&E_oRvD{-L z=C|WQu#`CuVB-qifL!`_Xn&K#w}7S3F@lZb^I+8Bx8o@=2dePAHtf8v{fiF&6)Za( zH`w?-_-!H|DjB#oo_F59Vu$m?yGz5&VT(Tf0$dyWM&GEzdD}5!&J~}9$;&z23*1u~ zWB6C|hOSb%^wl1!54ZuWPBcM#wv-N~Fi~479l~U7=yMO^yc@1URIPssYL2r1GpE6P zp}EWqa~YdWnmE|eegN{$`lm2Vo9XZA@IDS7?C>;)KkV=vhZi}#+~HLYuW=Y39jn9V z9R7mC*EvjoHU0Y?{*A*gIn0>G^yy=U@eMW{#xx9Y6quOI_G{)m>E!R!nmOZj z-?DO#cle_Yf7;>89p2cQIrlo9R~`0i=B(3A(8|5u;aeQO+u>h2{Jg_|b2z7as@dGi z;Smmxb9j=&GaR1l@Cgo|;qV0xU+VCU4&UnVy$(O>@UID!cE|KZ@k^f{|l_^nec$aPdQwnFQcZ@&*2@wcE5G<(ZbZ>D%qTb zT($^JPUmEYFLL-AaI|@olYd<}9GC8w4&gs1Dbn^QBwBzdP z@E~xk!x)G6b@&j6k8rrz;p-f}&EZEJe$wHW9HzbOJnGUfW2$9x-X|DloM70G6Y8CO zu*0Jq9^>#{4v%+us>6J^v$BqHc#gxzJIt8D^iOekjl*jl{*1$nA1v?X4(rm_cL)7b z=&sGqBg1afe@f@xE&^5ib=s-VI~4 zqI3LEd{Bw^#-a2`G$^*<*3iHO$-8}H_HVdLGLBW%1Ioq=SJ}DN`K*qZXB6ByIFH;D`bFGDc!!92W*HgrcEWo`%(DrOhveN!_>hQsPMIDt zQ!L}KhYrsyjS)8p6W*^ppcgrIwFx1dn}}=FE+#KJ%(J}7d44xM*5L^bPjNUarQ`o4 zsVG|#Zy(`(@o1Ng`z@g@=je&;l1*B(Wufv?M+;_ehy>ti_=}mBX1cSYqfEcWPJTLnC-7z3Z?v#xBX-HD8-wa`^gJ4*9 z<_-OJS+F#od%e9=>h%6a6~>-^hRgQm2wNV(q@s&nF{@oHSXy}YG@AZY73ObMjNmD?v)=h4Dd z(i>|L?a?DVsLe3(Ur3LBX2H_#lfWOx^5I##(k{Hiuy%P|*zyP_&&b|UPGIn{n5O|H zg;Qh?J?!zi(d_Y??3y)c(1rS>WERXGd)JMU`hI%1B_Y=}Hn2x~(-*zHqOS9YB(q@l zMvNJ~YsrNUIY%Q$?KUdtcf4lH7YC{|RU*3&Mb1&lYOvvc%=jcybiNxYI)RY$&`;N_ zYemyJP2IXCFlpR6DgPus4r9t34cWC+=G|~S6P$d$8k=_4|MU%klm!5pubpsWwoA08 z%Kd^BY0XfX)0!#`VOPydj+Ql5AmUWi92h!hCF9!3l&#E zPY8=(!-%)Q?IXYYc>PZbZ(=ka*c4IGa z@4`XY*&E!iFq*vkfJ;gDKWYcTW*=qDRydgi4EN(Ce-L=hRs%Se$<$c{8{X>W4<(XI zlTJrVcBquXfrw!9S78xsIEPt_O#>!{OQ^u~@q)R+7qBp6t>iU@j9_!UFa#Scb-F_T z*rLg9x$6|!x?7IM=`u}rM6mghMA^zRD}hNtw~{2kD%h7D`b8Ip`XbmcQp^Z8K{F%R z1jUSC1FR|ZlW|)}lylPlij)a97#LdYi?#EDwKBnmaz+>D(<#nR2P)6l;yy$!NQWpg zuE>*%2sWrS6knzWpAI~n2}RDe2sWJHiN&Lcd_Lt2PA;lvK(Jwv=EsZAaXgoXHh8A^ zEz~Yc@ydU;$iq^8eJ~BdhBMV=iT;UTbGwSm2sSNe?LRq)NU#CMvlbUp31_X?M}JBoBiJyenpU`wIy{jm zb!K4|b$E*V*-?dykw1-oTu6np(u?Ei#ewt+QIge~zfzL!*sm#jw;avclLWep%MhY5 zLpLS$CRexI?@>Qn>KwXLN7O5-Z>ywWk|t@n_j3nFu!L ztL{CX(LV?_w<*0C?y~~}PKx_-z_ySI&wnD=aLGWhp?7u5VY5e_>IK23TEnU0cTw9r z;G|eXhutScs)}QXG^AW$h2qChYqgL{FXfKa?XgX&D_#VfBe3`}YH>sw?)^rvp%rq) zlhjZm*pO0F?2g5wLKX-%2z%_LA|cqkj-4Xq&kg-ODSiU&c_}A0SG+?1MX(9KTE(zr z&-@T67M~~2f{?#oaX%uqkV+)jkY{l5LJS-m@{|cSq>L?2C1r6)X(-MivLr+%CY?Ch z+%m#JL$IL*`f%R}=Tm~Mg|!S%XlZ`0`oO@m9?%dHM}+^4%DL?nRj=wAex(TvKhkyQ zDmi1-44|J90zG8_r%|jLjVY5+jQFf)6|3B)9{jBFxyQF@9{mWlNAzAwkx*QW#mEpkOg5%LuLy$=8 zP`z>)1H;%IVkf9oJ=LSyQ$1>0=o`A~jOx+Zs2;VR>QQLXh3fHtljG6C;_&>A-g3=q zVQ7^39qI+1-O-k~F|ak&B%@@sT0$ff4Js2n@;ml{&7qD!;0aKi2zFcztw|H~@@bg@ zyVV)g{}33^sP`zut47Gi<4ET#u_C!s*W~7tCKfJR(llbx>e)+2;J7NMndTAAOO`h+ zS!GjzXG=A-UJT;I;Pp4Gsd@P>BgYPFT0GyBS86i-Ve&X#ylP(4J4;c>tSw)$?AQ?- zls;_r=sj3VV#I>Eb2m&K5xf>h#9F=63s%Ubk~z`U_IMA8=Ad)Y7-mEl*6pcGrqHPi zF14AsecFWX5aB#m4uqfp72woB4oIOX=t)H0{Ji}RPW_MuG6IBABHk6$fyNcHm(CkK zHu`M2351)LG_6?Bv~+H8YR(*|H7mTw%dYyc;qrdVAbDKlFISRsZ1nsOzuz1e= zY^?=z^(yE0)^LDrZkn4dY7ng8V9ojjP4h~b^YyCWVLeAaUvevx`od+am?FQqqa`BB z)*3fyO^BAs^)=DHT`yq)l$QDRV`qAAEE^HL<>c_L>i>Jl1JU80ddTgb1vy6PytTO8 zZ9oKIg@Sk1>EC(#|6ld-|ED_lM}N-pZ9?9e|5AVd_u7gOWyezJDERgNTb=nCmk`+N z2e2H>nSZb({GPGztgTKPV;=$z@Qivi7z;X+wbwW_=IGqss~t}ynHH)+#g zIOyA02>JWa0lrn!zYqQ2dDbJ)weTn3KE$$rd_z!AD+l6Z%dzYm!=yIxBNeA>PSA!u zUI<$t|0;`UPrN+V(KxW38(L$F(|Ys#u!a&pnVaE9UcNiF`gMyAvlv7o(`9Sj!Pu|Je@8|FVVA-L*VDojxF9Ut*g}*GAx-5*CIv)?_ zqf!k2Y9D3#(jMA)=L@Et-)TQ%+SdG{MmUWBkjZ)LVfcd%ALj584$pG zn(1HY@MR9)=mB}*!+d%( zn?G{+Nr(UF@ZTNgy|Cro#^E}LM>xz>Tc$tBVb!SUq`}Y4}`+KjSd-t(nf39S)Ny#bZ24H#pNd z)8VxaU*_-^9lp=u#~gmb;XgS1n!~;I-r33>tQ_*uxGVEUF`BY{2~=Ib)*U5!3#45sw!h8Zl#}F%k0{-ViZkp@SkmMtEAp zO~N0J_&DL&5i>?IU)7bugmkR-Dtqg=|fa?cdDJc7yPN-P0l zu(UObdwZ|TUcF@4(>aD?$bzL^B!RbAs>`^W*y|qCsOQz%$iqE} zu(NJvOu=b^G`5@K-t_J$ZkiwAKcqL-j71wnA9R@bZrf!23{0@&xKG$0NB4nQ`*Ix0 zQf`;WT^_+?FD0H2h{5bVrntA)PxjEm9`{SqXcr#W?Aj1a9+tf)0Wp|8_OAJpn|jKg zgdO=2Ht0J4s2S7V?76win>T6h^3l7F8e1ZC>__;yT~&|{iff;z;eLrOzEX(1t$$-q zOXdvfQ~lenbGE7a>~CwXxOe7h2_A(jwyBz(Bx}wdxO{c@<;!1w=)Y&3SXwc?YQ>;F zvlf)*H1+vyv5+bDn=_Q3pC!*Yvh!L0^X7H=2ev8P zczv45K6UQn`A2?sXWw5QAa|Z^q+9iHTKmjDsIoe7Ntq4{UQ?{`A?o zOy2i~(+A|Pn4MggelCCOHnSFPmCl_yXeSZGus(1g)wr6qf zuc?3ew|&lTsYlNn{&v8tZ+OB8&Wy6n3gT&+QV7~Jm zQuSRrY}baef8}7w_$|rgrQ~!CTIk>UpDtIKX@6zFkBfkZ2%+71&AaO$^H=I$MR{KH zS&FsHYra;NG_UzJ>{`!jzD#!Gyyk0^8s{~~>9IVoc>^jRQa$3l=8Kfrc3$%@P+T^z zIo^;PpV#~^N-fW8ju)lPYmUE4d0z7eC_kIm{4SMVp4S|TWqDrnJ!PuPqe`}U%~z7T z;k@Q0#3OZ*G|loirJmtJEpzo|cvI#z{~zUSZ(j2ztjBrHpHmq&ulb8ukMo)zpu@?3 zfEskKeOk4)dCe!I6X!J#o_KLy^J|drgMKOL{wfu>dCk8}{o9$>{6DCL&1-%*N*kTm z97?avYaUuG&TF1xVmgK9YN1HmyynoHH)mdR9<^;=^QUF)E#@_!thSKbCH`F<&ucz~ zdc=9np}%g{yyk;-aOHW;kKjmcUh_uG+PvmFadNUqP4RmzDTU(es$=`}njcPz&1>F^ zirKv8+%DUn*SsewHm^Bc^SsS#&dZzfyymBpV)L5guvebf{HsK4UULWt<$29{VlU5Y z&bgM`CAWr&#b(rOUULXj<$2Bj!fCR3&4Z7y&1-%NdD_ft{+Ntz^1SBZti^fF!&%#m zdCjY+<6R~FFV#K=j`NxaZ>u=3`3GsqIIsDg9QtO=YtBnWo7a3jdE1%Sd_LvIdCh|t zU7XkaHX0_*YyNXuInHYiS#C4uHJ_zJcsI^#eiw%o=QW?9<|)r>9_|`8uQ}|-^1SBj z$=DaN{&uhMvh|Oz$B@vs~{28ombYAmGIy2>Y&EYzh=QaNm=gj6c$3L|^ulaH; zwwc%bvnsMYuQ@z_xm_~*d{X=q+U?G3{!5J7yyiy{v3bpJ!hp?dzMhJ-JFofwBjw*P zuQ_u>Wb>M9@@YLdZriu3YEpIWcjL1g6Ium85)3-aJS&?(l`?iv{@2~RGPYe}&PFtyYg6-< z{$3i@Ds{lgYVGu1=Jl@A;5%8TFT$*PIZ!i-uhQc~{dft#CSlzyfqMkThtv;OtU{+^ zg;G{3>XV(X5$PXxChuxGveS{N`PTz4?Nrp-5KpEJ9QE>WbmNKY8DGRgW)f8$dxUDBi zFle#BDxKtk>CqJ{_5Y}fX8r%Lnu-QPckt_6H&>=C$r+|eA6%f%Uljy{@26v59qn{Nq}PjoIz}3MCyu>Sw{J_5&2hf-5J|H+)HxAu4)vXXqLi9#$iVsN#XRz1`u$$? zj%4Q>>6w$jJFD(lM%t)Xh$0V)y>?Nm3ZoBY^Q`ZDf=pH&Kod?TC;yamn0CGAs*oW= zbQqO`Xrip@LncZge+^BP&96QbCi9m0)%C-a9y^lqX;x;*TbC+1;t^vRj^$ zeP^#_bFvRD>$P_6-A|1q*IssXz09>2^jem{jvH@lpI-@+yrgL|l^r)m8DSSl*U40N zb=t@_^)gVsHmS2Sds8pNj)l7f(qtODe`FAQG^nI47N(j0e1UHU#Tn#zHG}NPSDCD? zD4V}X!s|o&%$v2lCxiMQ0ym2@w7Hq$xuZa2(Lu4}0k?Gngu7-?m^LvgsFs;M-9-g- z*(&G;83Q&f{D*F2TV{%%)7mjRbJoTedagMT~t($mzGsT~!nc}N(g*Nx+IH$RrX??3i4$;{x>e>A7Vb1u< zFh6_c@nMGd{&-Dep>hQ?%gZ9O#oLVU+05(NEa@_@oTmLzW}mMzr|W7ab&qyy;(YB{ zt}c>?S=*J0g^vd3?W{IgJw6g7*=+PD2b`6jr>yAg{jpAN-gg}`bGPHvoeQ&O7P)Fe@}`kk9sKKh_%^Uqt|(oTi{+w;mVX<9OOp&Y_D+f6+9YBn?9 zXk+t&#jEfx4;_4?^N(((LwPoh=}Kln&)n%XdwXzY*L>v7O>)duLYM^AJn5Mf)lCdO zf2qhC&GJ}Vs(*OI<3!EOsF_c9m|%L}MGL}&LfC z<$Nu-c};`9w6W>LMJpSz+Q`F2d6IKXyvrt>SKBO&jiVFP%7r}6s7^DygU;le64c&U662gML}ue zvi#S&orlY;or#9uYwqap3NQ3=aYV@8jSmy^Lf7*^7)Y`&X{*yVR$KRo8K@I#w1K;5 zLua}+>>=lKxal)yCLjm%=@R`l+6c(kXq%!9`6Jq@BIX&nLK`}dYwM{Eoj+?-iY+{Ee1H(Ka5b(5TsBP`gAgqVKp#MQ()UY$z$@#)SKn}KY zZ2*q^edlQ(+k`{cGs&Od3?Tli397C~j%6D5;X25$?Wu2&&0REAU3BB%^s z#eE#FgqBblx~GqC-4YRE0PRETS>j1A`eeoR!QF*QeVymE5P^<`U%b!3#Sz}~1dZ%s z867b@(i;FV5I@i&+7su3vq1c4i)c@r7g`pGpJ@^8iGQX|{947sGp6>`_seb4Z)+2e zzZ_*R{xEh6x9WE0inpLie#g+jotG_G<+MR01esP;G~5Mpldy``QKeQt1vMa+$LZo~&`|Ivs~*Z#4H(f@tKk7&BfAarl!Cf6n1AIDDPMcQ|~%!@qI(C5PW|xK{0GbzsIX!vh^2 z>F{n2k9T;c!}Ae7p5NJ*&{16pwR#XT+#MYA_6Ns0>tkkUH^v}4 zIi1~|&P0bl;Do8iF@GsZAEjunP^E-*aF;VBL?_AnjB9)=qoUgYo+hgUj$qQmDp z{2vZ~+F{1hR@Qol8B3e|Mu)%RFpe{(^Bsr3>oDVR)A^CZjKfX-oWp-`_+^J*br>%k z%gdO@Fk@-M@MjGVa(IZtIIoz_J`Nw?@IelTF)IHQx@)s*q$q55o|3-F{~!zpituX0 zyj^)S;!eVym5xqt;jJPbBHSzDvBLN!p~JHmPRn5W)R2fL3Xh1G@$4QEA1cgbr|9#H zwtvJt%X~26g~A_-c(L%|5%YX@bj0+p1re_nUK;Tl;Z+fzF8q;*FA_d2;?D}79q}c? z=S9r;_ri#85WYBKp6M=&_*UVoBmSl^o;Mr|{qCy~-zEHwi0={pR>b!S-yJdi@w*W} zDExzn>6<@}_z~eJB7R)>cM<=`l7iMY(8!!!QChO$y<5aQ7dAx9J()>xvBOxNd1S#nCms_qeR*NT zJP)pj_%Pv9BIenU^^nMWwD2b)<~i}ah!+bJQax{4FpS9hd~b)jPnvwB!{G(D$|BHr zO=p_JvmB;hn$C$1pW*QN4zF|gI)}gR@SP4nGma>)K)Q%RW%`N02=&L=rA;!-rB?;}dtv2$L#xM`fhl8)gl1_?1(S#3FkE9*6ftt!m%a&MYUKD?IJeJ*HvrYHj2hsV#(U?bXX3df4NYGikI7ujO2`CV%R;X`I1FG)R3>_PDOGfj!!r zzUb}UxxM(Fl3B3&jTkd#my!z|u062p=#iVs84M>`mEhXf8^5>B85CEr4J~lS?~=FT z1!^LO7GB_4YLYKiO!?2!X}U|)Bt6f417=;v%)qDad2{*SVkWqO5BzVqfd@SGX59~RCdTwCPWB*#H2+Y7u;r$(;Yeolj_C-|_2OXg6EQ_QQcgu)>zswElnD@s!#kRb^ zmnEB6mY0&9bPuFY>3=#+Wu_Oa=iHV_l5w#Ywafcsq?*4&|5|u|Cn?s#`#W7-L%cuc zjBmsHJ6Luj?+;Q$JfQ=M<}skUb?#~T9wNk^r-gLw@_Th`x^&5 z7->>7Q~#dQ)`@?WNiJ87UwN7Lw=+g3srfXJ+ZBAs*93D(<*k&T@%~_6m3e;^~n1hqr)-Y zU+}aa$1xXcN1_vXf9uhSygz1DX`lD^DeB)2?~m!C%e+4Zs~hM2?W2N>_ZM0$^8Wrz z1tRb7A}q|fUWZ&$%cIif@cvlVa}#-g%qFqPyuabpDf0dX(Ln2Xc<Kl1~uW%rd_ZJpmiM+q7 zIP|y4`#XcY?eP94P;TV?HGzN1YoBSgk5Y%o`+JZUi@d+bkv~01I$Cal9Tc*R#ZprC zULlHH)Rb40luK)v0{`8}`}-<~6?uPqs;Xt)U$|=+?{5VMTpuosT=9IebjW!^IH z?|34{`@4*Y@&1^gYva7X9o3v=-rtw0#StmY%%sT6pfd082da6Q_csfRZFqkds>m|$ zk9oJsyuV+g-7fF%E{q!QuYrj1{=SF-+Nm|~?-*6M>bi>= z#40dON!Jl;!~5$Wcz+~_pJuGTsnTwT^@rB+O4^=Thceb5?+iA^`nz3e1CCW&r}x$k z6JD%$&;t(^_^1F2)Ygluwo3m4xo_YcrF>Q?dt@o;p2@(|CAvi-R;R5`A@|h>a$kKQ z_mO?IWv}~u%s!CE3Q9PqZ3%;ZtCSa&LWw5`M;>1VNAn;DXCt?C-F{NbcznnomU6p1 zK3-?-Fi0(3=J9Ea8Xo+6$v|r!UqM}?yM}_4&Le9b@3{s@Fo>5M@c8NjkB@_E7KX=X zx`Vf&%U+otDytcfZxDj3f?)8CbkwT@9>NFgPTfwBUPjp4X^2Y62zxYccE^H(nC$cu z{mTe@v~gR)-cG!N$OwDSlrz#8y+U-TGG~On=as6$_%+N3dpk{69WugRUWeCHGOZMqg*%i*9t)8({ zdsMtu{Jf0Cw=s5}-l8Pppt0jAI^&>$7)UCC-L!H7==WIyyYPG`{@r1hDN+t!6%tjA zUAVEfu-3?aV@RDr>T?-nhhi&2-5C;OuZCt`A^3G|X_&`WAba_>B8ZL*as7K)8~#eF zGdrFfTNCO~2rpBUY3xwwfKX>opA<1uca$xJy7vX4t{PgIQO3k+YfYcab%M^;K5=fB zPF54;Hy(iYBK$FA=XjFyR*D3+F}g=)0sd5bi4 zK2R)2T`woZMPOLGYVjhmzuuQrxHg@Od&d${Gn2-pO(*KVIMyqd9oM)RcHFy}7Pp1| z#xN|bt=2ec>HKBM^r`zdj^B6cp_8Xi+rM%0q-pyfHh%Kdy+(E(zwaddXV7L}hO)f| zeC1&Dw|YtRcon?n`Knc?ZL~Imo;d^7^J9?j5oPF%*M>cG_SME0P2>!h^_v#(H0=rK zfcYYa&QfgzwQOO3oXTg6W)(}Hoh4X=vnQp8w0P$0$0wi z7SW#go^9e2+r+t2ETBKjBH9z@Rhk9jr)#5UV~6^z)!qW>U$BVw#3NrV8=SQB6R_D7 zwT^#}9ajy~belpq!bvNss_k*ZbRj3kRpX9g>(g*GZW1SrTZ0030@K$g|1wvNS5(G% z8wn;+fjbcVAHpu$;0R68e(#8-G2fSnO_INnc0e1-NGfn|_p2b;}rAy>H%Xn$wK+_{M(NA_UE)3kpS zEIXVxu+^Uzx9Fqu1XwzpGO+R4ev4c>)a`Fz=?smy76%RmUcsWn`KgTU53Y*sKT_%7 z+SnhAZ^n7+i;nVguJ9iOb58m6`tRg@y{tNOUh$U&(}%b4zLMk)+JT>ch5NM`{*A*g zIsAshTXhp%_|7KiV4_?Hep@9^Io&Q-VA-^$?;4v%wqlEX6`p6l=l4xi!h z1rA^8@Qn_?+jw7Ltsn*-3J+^k0-J|w2P{s~a z774FLtZ#Q^eiS~|d8MPnIjoI%M`7bijTXiM5FN&q10w!_@QxAhD?BV>#@o9_JWbfR zQZt12iE=(v8dvHlVO-v@KSy|a#PfuYikN4Rxe+fHUKH^e!pkD&+^&k4b8B3w^Mp@} z^3MyO9q|>y#+ABG_`)dXJR4W)%fgpM`B#OFEA@5Z8>9RdVdF~OCTv`(Zweb%iszoY zqyC-3-;ekK;U7o*pfGDF(hlDjellX7kA4^NbHc`zqVN1A%3l;VuGGuIZ$>%KJ)L#J zu^FCqB2Lv8wu_kOoxu@rEj%h>o^i%SjQ=kyS73+dor5EWD>XG@o_$yV0iChJ1miDx ztjDl&{|wLL(kIaWtly4wc$~u%9j0%Y{w#+VJA9(U^cB-T-(jwOlhY3jbB+z)>F`4i zb6uOxGY)e;O#ZsV{~Ioo%xqF9NsH!>w~6qsV6@AbicgC6@K5jPM~Sh>Ay>)dWDtZq@ZM_sUojBphZ7c9D`WHs74(wiV1%Yzy0 zH2`9;qBkqjjhu=2vwNl)z5$Vc;^WF`fc4s*N@u8 zf~E2MWtg-^{qS;aS}?d=0)HISb`pO_iImIvB8~l-+ANP?a$NT$DFI@zv^9!*d%2<6 zwTQj0F%5ecYqLCp$tPv+C_6bW?IK}sZ?NpKED83MrCh(OW1f-P6MiSJpkHbHZh^Ac zZi;);ySLA#ag(Z4;8-&jZ4l)?>yKk^>Cw+DSlWFO_~W=q7Xt0Taqzoo?Huj_id#59 z3b+hgF!-1R-rgOuhaUF$%3$`k5_Zj+oU04(be;#!nRh|EHyA~t^a8^_22Y6 zsVVGI_MNR&CG;6BoVlpT1 zXT@sAE0V{Pv!c)lWL4$L?rQ`^2jZ1-{%=TjL{fFGtmfvW6NRgDl?O5Us5yg@Ca(p; zh_5^tY0^m-XYg6=%+R%xN~z$74DU(4A&ISP-2D)h2Nqc zbmF31tCd)kduV^{JMl{HEN!9UDrl;($T=|o3+t)N?&I}8Db!+REI3#A0rEY-H3gO` z&hH5>6kb(L^B(|rFF<3;j{_GAzbEfr;NFGl)N*fdzrz0H-3MGsx-&jwQ7*=|g%eVx zOag}fljIKqui0uCmL^l@B;ATpQ~ppQxisl?v}A`$DICc5NtaXwiJSvfBWtl~z@%^u z6_`F=FjqJg3p3VAUQ_rz_;83i=csM4)aeTSV~Zxc<*rj?>uxz3r%R*kh@A5yi3;D9 zwfst8Qqb)q$*&6bWru#zg<-tNITMs4Ta+tkc9qjW{^Fq6webY;Nq{wldKu4O!k4c? z;Rz0R9oWb@Uy-Tqg_9-8Uy6S3!d~F@u$Dy5d00h2&LLXVB?mbNwWJ6IUwoYZ(r_kM z{OM-2#kf?Hlf_ z-RjQTZSJhyj($9A-wJ1~@PZ`yyXe2A!p$_r-M>+p^#yX}?=7n8gA31dgb$1r9$IMR z(7$__@W`&3Bt6MLgyv{r@uD84mg9ugxxPywWk|t@< zQSQAZ2)AYqI9$aQS^Pwc>n=Z^!|I=&uj=)9MgJh@+@|zmxX%s@I4L%8!1bZS=8F51 zWl-oyH7bVQ)h&n39(Af$@BChAb+rrx*3I4l>jIK#k#k6>D(*|9A>C8jg(9<9=;w(C z`|e36WWA&mtJ{OSG~}Ekuy_i!I3f-A{^G4l5jlre$Q1+8@xvjdrq~yYM};f})eQ9> zV^k#MoY%2aqWrm`zbD0u(4LoaVsk})+44;xQYfCH))zU4lw$Gk}gyVCOt`Z6JSO5ehgRBDRk~hq<7N4I{n+ex4>|LlK3Uf z!UGQ0zkMWlT)8ByT%kejcC#c5>L&@z$kaoMDn40?b^pyty)tDouHHWruH!XD{;D9T z3yTk49q_=*kXKbwk$NhZzlOrH7OLm@xMIK*1pJe61~`KrkaESKOr+n;bWqnGwUu4_ zc4bYW?iw#w)F-vIdrPFjM}(?VuA8JPpl6aX16Zl3Dn_)fkH$m2(%M=$1GoXyXpy5p zARwhvnq~_ebsnIVjYh~yZ4akgXwhX>tS&v$%C0Szy2j;_w0se%-KYjey9c$r6}Xi% zqVu-(Hpz~9n(0xtm8Vw4s1%o8+WeK6$}EVm_E4)unEJX^m(+;;++s+I_HS7XX}cEQ z#`ebBP~UK@jR7X6&UJ0qP8zu30!a1cdWo=+5itg}7U{ebO4`I+VE2&>>VF8+^?#-| zt!%_@o;EpBzj+xTTp-C*p%8Qy!gNkjjgsIYpq{9pz7+$xEbs$dk$g=TX`23BXEaq% z8u1RCf8Xgf0aj{djA4tG&Rx7}Uei0fDoEdG#Qj zI9n$u6E9kpEeND*KAhUhhlA_BBQ0nt96gOxsGrEkUPxmu{brjiLvJBt^%}Y8ld&qx zi9~A(>A#k_(V99kQF&@uai>gYC~JnbhBno)|6T9JzxgZMnEU=l=0<;;?);6meogR< z*SzWfn#F56xCx9X_u~#0xM^(E0#|czww||amHe!AGmVNTy zlMB-{HqKqPiX~$jSI-WsH#Ijk9T)FvYTxC{nxX5+3v%hQWbQ(ml15#!NNk1oqVIjU zmf!PB(v+_VPQ|?08si?g-+p_R2G3owthssRvSo{h9dcl)C9-tEuw90a8Z~_6u-$eY zwqW#_`MZo6Ie*x^MJraGG^7-M8N&;oQZ`=LY}b795lY$^b67Cfd`9g2zOiRyQ>Sg9 zHgq-Y%|700j~x1{$$4qsKgt>8TV6&_1oDChXd^E}eFjHh8ycbW{&RV6eHz}!Yq)Us z`HsMM3Jb({wutt`$Hh3^2A}l(Vw@f6hqQ_F+Q0(oOD&>3@s?qseg-#p;gc|;^uKAc z;TBhEXO)(X+|{y5rF>9P;L_Nr@A)=CCDh&4K;fH#`LlEBwptGbfdV^xlL;kl#ft2^ zRXtd8${gzCBcq(llIJ1x=V`C;aL~sT*nG6P4`W;iE&P?r(1WSkdfUTYjkgHs7K}#HN21}p!(_mZ6 zLoi{kCEAB$08?&gb72Byq_RmMe~*Z{-5J)qmUrAgdN4L=c!h8~j(CjXCg0294?4^X zCet~>;aLtJ=kRKWKko234qxc-wGQ9x@FNcY(&6VE{;R`08(Tg3PHni4!}yJud?$y; zJAAOiM>xzxK9-kP{e~}d_(q4n;qcuK|G?p&JN!F`|Kc#evsP9Yhk5gF@<9%da(Ifv z_%50LLWfs6yvE_19KOTh2OP#f$ZXc=A~(#}K*K{F9_ujgeocqT{S5Ox$nau^PjdJy zhc9$^y~AH}_;!bRnQZo-boh@B|J~slUC^e#jl*>gk8pUL!;>7I;qY9CmpjZ{Pgd3i z4u9L>?>YRG!+&)6HHY~wZ8o=dcsqx8a`;Gxd1-2SKjttm$xY6OOT$+<{AGuqboeCQ z;7tEahu1oMnZsXnSW|nJ^FHSA6Au5u;ny7QUEPv*ki(-K-pAp|4$pFUiNhy5e73_E zIefXpUv~JL4nN@Vj~#x>;XgTiuzqZ<4QDz$7p!ZNut3;;Q%**%jc_VB-v2-0I@iPOK@>EGb=zvl2g4*%5QryLIJXv8|y>Lt6?rOP++~;GPKPZf^BHpQW0luy#o2 zQ(hv@b+IwuM1DWaH*sq<7VW10>5~HK&T5?lGD(%s263she-& zt*CFZZ{mL|XM4VhuVB3$-^Al}+c4k6=TuYkO~mENd=tM#4fYzZ*6m$506Wn)u@`yU z^-cT~^>4>Fu@{!iH?apw8}&_mNfj{P#L!~VH}SJnU^W#7c9L^}3OybU$;P2>egzKw6l!+={&I_$Jm-ZuCuT0!QCO+_Upf@Pjh5a6EO0zKQ1}e|o&G zqD}Tq#7XSk=$i-;%zP8?SFbAjCWgC)`6lkc0h@2)7_xNin;5*s%{TE4@|bVpPC(myq&r@J+l@?G$|zXX_ZM{!;c$46m%$LGs2o zaR7kOZ-#1`){hq)qKyUF+W008!X$1bi8UIwm~Y~C2Pv79=yf=N_o4DS z{Ix{E>u^ArZ~v+w7%-N`y*l8!&!L!k9S+=0`SaIg9*0}J3FVF$oeO(zlQMZSE_@m| z;IY_yhp_8I0^)7UE_(l5Z^E_?gmoJ_5DqL?B{&f3loCqXqPJi}1}A7YIfMEiLWBMz zmLj_;+JfUCAoSkyXgGW#=lfO%j)UZ~z^j{zBa4Y<0I}V0f&D8dM!Id+h z&c)kw9js&0-*?<|upn+wwg`*UEuJimzE*0 z*Kb!jyb}(8TgzIVwtcnfM<%=tX4J#mZ{#*~3B&Z^%_l8cIeU&A{517**e^6BAJ5st z7t0HH#q7n&@DS7F+AEXc^JcG{oeZDT+#IFzn&zxpASd40OPX3q7BMsN@GN!qoH;9+ zR<}yljjvUFwq~(k(A3)K;zdhkGc%!jCBx?~Te74{&bGs|amMhhj8M4~S5n((QW3En zmg{iagjTKnKJ@G3-LZx40{twaJ#oIlS|HAMN&>wGzrMD9eE29?KtKBJWpmAT{Hx$x z`@%f2!E?`Ft_zx02Fi!L`7#&2SlIu{Cyx&v3S52omJv$Y@IM=?eLYz6oc2SVd}Ne! z>|pzy_P66IW}{qvHVW9vRdkC#oZ4WuHuG=zxWnf-e4)eFI()Ok zk2t)=A5M*-u*DxPYlkiVa9KNS@rTRWVT(Up)(-DBf4Cp%huVG%e&g_;9rkmLcG8Py z)8~lHw~TRs;f?vX$z7qWgAau1^Xl6$V=Ke>4j5+4VR*d5`#a2Qa?_dV@TT~^F(r}t zy*(t%mqG#`rooI~o{Sj3x8Fz180M9T@q1$e8T9Lgd4C1Q?~Qta86WX!9Xv+36fwuQ zL&W&K^YIoP#xkQKW?ac?p~$BQ6W&dJY*~#u{$HZr+PuFS?P!6%L}=@;wq8y%6D6nb zkRLt9mcwJ*>`hkOp5O$79((#3c^b44o|V0aw8tLj*X+^nu#b#zX|^l>Cyl^&G+ibg z>P?W2!!q#WEL!KjRfA_7fadog*~3w z&0br7wGp!S0bMH=%-%&YPeV+2q?D}~iM{UH%-+?)D5>!?XgF=Pn&O-GX`Ys%W?4dX2qefw{+t?lp3SIx z^R(cCCg(Hy_{MzCc2=7Cp8X!IP5;xu`k!(k&m^vZB0;`q$EeLT%Th0P6`FvDUG)dG zYwiLfU0P0fqOeIu)3f+_Yjn16;;om1uYQFa+*CtK0-*#&df zE0Ry?|7Ls}4O0z_cn4-F(aR`ZPhn<}@*E*rD37&0o4~*ql|17O&Ja03#MIThcUQ(dyYtM=%qDX0vD>(Y$1N(~?yq;)E&L zt}%XF9W`7;^mb-w@w2OhCTyv2t9d0h{w0lEn#UrvS!1I+u%@M2h?2No!|6^n*QF(8 z+hKBp>|dA=q1;pfl+~E+vYlxxninlt+BB~e@@L5?w$7y{53^7FTgm#|0SWANe<=rh zcds9ea7ox+eJ5OC+&}8H+0766`;S=Ps>R-i@882&=gcdVwCSE)4ke+XF-9-peY?GX zN8Fu%8@)W;H5qS28(yo~HH?{!zCWkiD)4+@@4$KX02BCa;Qe+50R@3EhCa>25Fe#WgVhD3%LBOB&jfZ;la>9Zyu;V}KDqjf7TMkm(!N@3mu5U$q- zrayiyV*22>BBt-%9dSwf`y-|g65i=|2$|K6|CcCRn?1KP_Kug3kd2Kud=D^E=d)hv zJeQE4^FhAhF>dx66sNr{phsW?3vSRxm?nD@wZ|T9X!fWN_K^{e%Xa1eq!ISiCKDa% zO^}Y|5e)r(Fdzo2-#&`_`mJ;IOBBYHGG>mQCfL=wFN_)^7; zeUkz5)PAw9BI&vBn}T2HJhxBS-}RmJw@bPlR+H}j>FRwa zC4J91t4nhGVTa|@`}5yK>Y`tT!n~h5cXbdvV`$v`*NJ8(&k(u+IHo)WbB_&c@y^oT)T>zmTepIrsXXHt2u4 zn*`q>u7Dyz?-%$j)a!t=*;V9skdodnT&Y;g`-Q=zmESKcS1i0yNC$sKkbt>#9kD!4 zC@l$9%`5b9xzk;w&#a!ORnxNw4P3o6Nq4?o;8<-*P3}MSzY}rQhL;yLIU=3;_utxT z`Ntz@H8Up{b|W@`8y<8z<-A}2x_nyyDu(gOp;M^aroVOYFB&HGXf-LUrX=_87I^bu zuNw69-}cRey)6B+T23RD~Af@-{1{|DxY2HdW*mX&j*JzIg(xX01smq znmkMpq)7Iw7MdhEf*l_bDwC7a%K*!?rO6SiwaaoHAr!(?{U?$pA7(dOTWxY;a#33I z=C(B>`-OR9S7zz@A3}TYGpskEaGp+1MRJMIX1vdkr_=1kO>gr#-#^vIIbnGSII(fT zie;;oFIu`Fd%rQ42jk5DS$!tlkt%mg<>k)njXWO5dbJ@OUu`gVY4c=8y#vGTA2~ z%VdEh7+|sh34|>Rgmp661KG$VBuJ0|0YX4-5|D_7s&x4NElo(W*U%l*Iay?^U7J^ihxo_e~vy1Ki%Pu0`GqF$k3t&Lui@X{oG zox=Zff;`m;BdeqSCqmw`u$5pr9e1tNw3Kqxnw<^X7KIhr?rw`gQyTAjDZ@*P)lF%A z7b{3lL(5ygNLaGeD(^$Tta+bzD#iB{;r)eNLUK5omaSOc)U>OY9seD#e`1T{9aVT? zQhK2h%J=?nfYOY52h^&4{a=0G!bO6>T4!G|*!vdbw0G9!T6${XYC=E;b6O*(cT7MI z7qlSfIzm7W_tS!WjutLQFjoo!I&hg5oGIzuX1$_RLK`iOF09T4sR<3I#+k z>3v~U_-d{9k4!6H2uFR+E_Cc(4P!5yNn*}~fl-IEXqe-1kfKn6NJZvKXL4G$@t%%-{r7S55spVW=AD4q8Si+q+62~hYpXqpmiCO+VYE$dDr%f$aPx37P+U^zmMEo>$f9w?qqd|!p=Z(yU4WDn#gpaJ4WU> zbd5}#W!5@*4;I%)o+ut1nYKJ4GRI{9$eh!Sk&hK05}7tWIdYSDO5|oSpIKpBTnG3a z80LB~C-Oq^sgYNRS4QSKvnKLt@p+LyAzmN(T=Aum&leMtcpdYcN3QJ>I%_eePK_HJ zk8w=Bn9elEGaWB-Oj%8To#Ty;w>aMBSoncLowT&ut=>D*<}BnQa1VkTV?3|x3j2?o z{G?GggJV2iE`p!m3na5(_GowBUT@i>{Mh4MFnc4!*hfZqAYB#zlSbekM7ejR$F+kz z@el@k#uA4#){`9*e@II`5QFW$Tz*UK23fz=9#|-`gwb zVmeTX*pum^y;H@ON0|AYB6kBZSlZc&8~T*pd!H3s9${v->}_%aL)y8ww@CKBtVHZ_Z#H|k zi^;<|NO(&LbIpk2Aj|f+HofE3V8=>k!So)GKwXJq__Xv!6=S8cKO-4=EIchej=u#< z<67?bqpK=|^M?K4{%HI0qS*2XGe45OyMP!h?Z=9Hd-bx19`-mt%^r1R=Y}wInRe<| zKn!M&wLc$LYbSU=$vuX94)$uawAJG6Ju1O?$t;+?I8KSLMudS%yLvx4dgSn7AN2j? z<2|%B6@qI7XXjq*vC6A=ljmhKQ?@QYu5;-}aMj^W)^y zYV!@1`OZB*TX|uU*?e;*-#LHYzs>DqqH_wqxgY+Ze!PPVSIN0;Txy1lV#&zi5O z7H-|~n$>+nW4L85iJ4rnI=$#~Iw#Gcs;nBB1 zyCY1$1$rl$Qh!@Fkg;Yhnz`~fv?~9EHW~eGO;+O0{8UU@rX@C|^{I{Obu+2&_P52y#LeHuJo{w?OfJ@?QS7zREtDzpXYXy|2Hmf6<1_-&Uxx=x=KT zCZfMB`c39<>t^^v_}k)J^5$>rewE$61-b{ka;*O6UlX$_Z)BYANWc%g? ztD23Tl}y+5ELV8E6sasMFGcc&A>^?yboOEc=Ojy1@r6S8CgZsYo9kS7mOSPKYczS* zCD%)>ZjYwL`b^}7$ql;B^)5^zWqop|BJ~Bjf5k6!{(^{op|c;6%ffa>6u1n^3)WYa zXH?-w9Jfu$Hx(IEzz?guU{RdL!hBM$OrBE8gaSvP=mm?eP|*w4t3<9%_=w|kg(rwy z7wX`Z!YcAypS&OguNL|c*&0mqh0Y%-+P*@CmlrHP61wXzbaK-uk6y6GQMC8)g0+Or z-#1qOJLh@zTYf)>scZg4?E`V;b>CGXRJ6}SFEC(jw?1#1W#yWprSwq@<(V&q@%!(8&(RPhN(22epR~R}cIxcBNa=S7om~PXF+Nb(GQz;au(& zI8&%X%e-JcL!?h=NPMA_)>WOuW^K6t>kFONVqg{(c3|L4VJne?LZqVbJtB<>z2|(P z6OmS4ux?lGSlrq_O9wAlzs2H#Y}mfgc~zo_dBOTC2iCk`-GbUlAxrTKo!`<{@Pf5j z4ZaZE)6EX;JyYn(_RR~{h1y*43!QIZ)VyGwOk{q@-?b3DvY8jGi4?@VV6DP{eW7zC zDdq)hBq{cV&O?Y4ztG9S=8_S1nlE%x16{aogySi}HgR?CM2V|&>N{k*aOPVJ_+dzV zIQ;*ERQ9B6m-HB`{{-&o$(Eya+uuvC`jtRCC3MB z-wFF-Z2u>c{7=EJv1myV8sJSngG!>m4ns9Vghtzn!qY_A%iJJ zis3MkoKUekS_>wpUJs$3&9o%fYaIdwNVnRqG6^d4CDB$FYZaPkX=u0UmSu(p&8DC^ zV~$qo6X=ZP!n0DT{)b?ha+!9OWyLb+H&;{OVL~ljA+~=J8@A9(iDemlQhtbEO*LYB z;nIKbN7HwEp^87F{tx)HW+r@+Fa1?lKgWG=r&hY|g@cgo&F{JV0$bj;OZXj@-&M~E zzpi!&zsaV*(x#GB^UR>{&Uysw@a$9-BlJ5u}GWn|E$MwBIIR}|DVwAq4w|MUI z`E!@dJ~Pu){O;kZ*%~vycow5x`DWp&*?bXF&Yq&+eSWglcf{wVwinL|Uyv;2_tyAW zU(4Lt>Gv6nL)!gl^?&%gm_=*q+b-88(vLA_nijS+&0gIcTte}cz*&n>74ix(ElOdtNj1MJJtJ-o(Q+B zA$I)^-}zkF!mzM(NJ{C0tg{y_ZBfN8p0#4>s@ZnkS+=jPcA@e8U;iMb-Nsq#u3Zc^ z=7OgY?lr7QSI0KIQRFRRPc8Hq2*_c*^bY!TQwYdmI#%c(s>STkJ0cx9{T%{vcy}$x zXK5+Zf}Fk!(!1u>P*2(Qys5zyw33^$JaUj zg5&LuaX@eOpLYB+$FDj5v*QZgPAzY(<9?2(IiBfwwc~Y;H#*+pc$?$99Pe<zT=IKzv%dDjvsaW z1II5p{-fip-uqekYaDlTJizft#}gbMh9Rw zzbZJMM|(K=o=!g0$q#gVxMQ|q_SH0sjA@f|?=$Y=xSQkNj_Vx{bG)D9100Wae7NJI z95dF)%5Z{XUb~u{d$#c^$Gqk;`2~(IcFZeU)49&^HpjO)zSHr&jvsOS9mh{Q{-NWa zIQ}=suR4Cs@n0PO&2d}ZQ>^^$9jloa#{kyAu`SWFGJVEgnS6zqpQs7^k{f=m7O#y= zUx?S|$QiR{W3TGOo1?ss`0B{Ch3g^@5Z@S?zSymi8^nwW!RB!BeUbMSKNOk%+xH@m z7C#r6cJ$N8W5usTo+$oxF4OiY!+ddNWZsq{W8pn(=g9OM z_l~?;tf^E%=WH>-#*li>BbOe5KB_V2jxlv%JjOBmWAbT^XF6Wwm@=9EI>#FwZ*jcM z@m-FEA1K%pBJGVZLQ5`C`p>w(qN?)ZxV2GYdzwSj^m<2bM5wS4TxE8j65A+nX$VGi3;SsGGf$#g<2y8L5X9&PNM|%Oo%+?f!Opj&TCR)0F17ds{b+ zNmU}- zzlgoPFUua|ny|-x$;!7?Odif3LR|-KPkj^%q_KP;lr*B;h$N?B&g_>TGPuyL6|8gQoVY|q|acCOAi zefCiU)?`kyJFh?d|z(wQC>WvEkNKaec3C<2Psb*l_p8AMMEJ z@4Y|wMBB9|?AShh!vz<8t>eYRcdXy>`RxO)uHA5PzU}6Tna$%n>hs=PF5YtR)wN36 zaIro@Em=srP}_T=e0{GCS6~SgdGjvqExxo_quxc z?YVr}MWef{y=KSu+Ktm^Z}{31<*9akuM>Lq??oQ%L$l@>-(OzyKwX-4cDu*-ub|Of zI^yxq9s27^8=ohwRAF(ujz9YA?PYg7)Vb?<4R>4~x8LrC4JqC5$c&!HR-~N%@Ak$m zWy{Xbop;zC`N~O$op)Hr7kZ8RPUm5VbsoL{=mC@VTsA6qA&qwQo>R&*o3}2%YLA09 zZ(ViO9tWSdwfUkekG?&duX-YvTDtVqQM)(nzvB?i2g{A_IeOUR-x*f6$E7W!c0X)< z)r1=+Wb(Dc#uYBq;mMwNSV6Y;zpy-$&rRBY++l@D1I`wFM5C36WO2S)Wu>Vb$ShXzj@TOdmFRJHHLsJoX;GO z4t2#@O`I#A(z3IDAxV9I?ksPVoH72XyrF343SC6P^(WdtNEdys9r~aAP}k$+K`HQU zLc*=_ilecTk1MJ%K8$P8Sjm^dstrTNN@FGY@lazWzkz0Do71(*(d$S(!j6PBKy4CYL+xQLQWgsLkXiUki2w zk3gD^0(wr+j(=GhYjcP)S5@W?&B$o}ER4osljp-n-Xgu6hI0}*>Ssjg*XE}3mN3Vy zsk~zk31sLXZKnNq#Tqtw7RDY?p7J4}Mvk2pheYP`^AIt#X-m^RK}umqx@X#N)P^){l17r&*fcPcKL8Wc#|m@#FJa->YbCGD z{|P?sF7bNR4VK#8u751iWOeRNMRu>wQ914ZDEk^V`7?2zOLO@OFe8_H;+4U^>a+ANoP@RY$u|_KFFeC`?Bk&$DS-`}TusVlVLKxV z;X9rilZTXNRG|mQZBz0cMaC5FAwFiBYkD^W2Hp~s8QfMU4^~o<~;MKydnBE#pGi>tbingy-;WcdXL~SS?HW_NY zL(}q1`Q2l+ja-MORhja8z{>nFn2y6HKTFYC4V%1A_G}3%42VeZP+CCM|5afsS&GBP|7i4 z74v&+t1_AVhK4BzY(1=d<1C&_6oA7Jh!Mcv`+4we%uq%#3{a za_>tS@k#j_BRnYVn;fKD9NhLbCje@DudHC@J*49B+y)3h7gSz7zf#z zT-CWtQQs_ecHOBXvO#lSLx-$XNl8b!eiR23-F*+|q3Wcvz z=J_Fi*TNn|Y}jP@RJF$9D^GplY7FR2jv@_(_4==2lSD=pjv-}Hh%^>v5?LG~6Ekf& z*jzHgPBUzh8tB4xBOFf&7(!W{nr$l zmr6bv&UaYcygHK{0oUaDetB{vMK9#@vY#9U?~y+W`O$F4Opc8u$F$S7_Tt`~+(64E zu+3!4TT18}#&X`kVIXw7Mv&Y3l>r{$iJ+@@a4`nmmnN!)BB{G@r%&A!1rfA<#$ER|#C)2vh zV@cgHLo9X(2-XQ>4~kg*Ykh@rdH4PAXd&_L~h3SS+yj^2>B=e%x}M1vVrgYohssXlI4zaRLM-S#b#B$ZjU$oBpDN_LxM`v%#G?N@YOo@vQ6^si4c9c!hO)lkz+zm3xR zwzLLs5j-iFnwrR-q26b|8zlS%sjmrM7n~JRPtu`L0g?u`)gnD^_U+aG9?a~Zg5Vlw zr8nQ9?js=^T~4RAI`_6(@PNhI?>5szg;-}k*+LskYj#nn+1*r$Jwwed3N@Qd?HTHI zQK;8sT0gp6`^kE5CN9!4`XncZ@|~ojQBAbwA&+QV?J5%5n7e^AtWm93cA?eK=sE%6 zk`tx|WE$R)$;u$5_S597ns7{(EYtR;vHHKMXgA#Eh-xoMX*gF~ZhIpQh@+8S?S@X# zUbV}G9i;ZtBGGU%!)W4d_eqAIucBqUzepFQJ4#j7zBb8rC|T;D)aXiz)N1n`RTI?8 zZG*cxBdW#SQ`gnCMO)>RO3gHsDt@_mk7)XXf5^D6YJ0E2Dj%DD*U<2;t({=`vEX{) zy3<(j?#{)PQtP7CcYh(dN3^O^GQwPsx3&+s#_APEn3Jk#Z#nhWAswon?X%%L4YBRK zX`IA;UC9*fS91MbAI;$uTq*tCfOSO&6kUG3yIlLYf~Z^rT|pEb6n8I{Yp|7z!!X2K z9TQxYHxxyoT2tZBqA+Yd6%H#pAD0ksh+2g120RG%rsV}Fs+qBWl)&T zO6P3Y=Je~K-O~hCmUDVBr_Sl{e)c0QEhhVfZBApw-i0q-0~A1eq5mNeU8O~p$?8lk ztt*obMWwDxQef3iOR50XqzSBcFD58M2;|HMg{iDep;W0T+@&SSOlO6HP!z&B`u}&c zqwp0iWtoQSS*NCsXC*uOJBcFhWR;EyGikLutPa%DdVfRDB`8cE5EWdZ8YNN}ob0UB z&5qfjv(p4t7X&>M<>4>PxWZrmhyks)G#5XCC9r zcoiint2!-G&avheFEJHCXjG={A^$X1(QFOtHbHY5E9_CuY1c#ia;av*iVyb4at&)H zOQuRtx}9mPY%fb^1Y6~|S=AmZQz$k37D?ABYmzyZRp>XA=Blh$>d7H>3M(|qGH2AW zW?rTWR2Ozm|LBlx)1rgIiq{9NE1dIQLIvGvV?fKoZo2W5WnQMRANm{aAHjzTK4Kqm z|J}1({-F;RytgC6#d8-gT{d?~I^D&8q#;gy(S@w|J$D_t@GVfeITYg9t|i4V?pmmW zC|`g0L<}69*$H)2r6JD+saQRzaOAT$CrP$4Ojb#q6ee*hOP0s8FqI{BTbK>gRm#Hu zR9=O%L%pI64iPnfr9v(Y(`hj6ls6kDwwNo#IE6+(bTFF+P243WZP83!Ck}VpDhu+T zewjCUw(_9ZCgidLk(zpIENfdGG*kUljvbjO%DrF5 zilBdXC|tVRsh7xaoD)Rp#Gy1fe9}HnF-q$!{hv-Tvf5>jZ3ArnOR3d#FU#6?ELEve zOBKbOqO{V|{m!=4_f}#hedvBDwwMBFh7$IA(d zoAMrkRo`~dB^K&;0*)7iPfV56rI+@A`c1-NPbZJR@G0w3!W=)8Fj$hgs z&vB(QYaGk8ECH4BbDsbEIzf}pfDN0Bis*J~&t%t2Bt_$JcnUBSUBqqYxv@Ffm zTE--Y)0&!RpT2V8a!qddZQspA)?5s0M00Ou&%Oj$6yhMLJfRK)4{oHkX~5S*2pr&N;wwe%>%? z6u(M+$fU^!XPTF(*!n=u&a=yQnpoD-e8ya9g|;H6o^#dMTwAf-Pj{F3L21)lrp>7- zF8+rnq=m_9s??oa)Gk~)t0lUo4K0+7oXNx^HR^COG=+WB9HlU=l1gZ5X(dX}{-z~- z6kckJbm-y?O!+C+EJmtCXF{0$r=7+Ha?@gc32EtU4sp|L)xZ+{L?YShRdaMw#qWIU zlvGBYVk6770mS%!W+txGHnrAK5hnSichvS(RP#uF6 zOHXTB)T|bzcGsdw_)YVcgieGM_2DDie(6#c50WMV&Y?upC+kyA8IHXg?A#{4SN;+A z+xWE7kkFZ-{e>ci))JV(Iec`KrzjH{C6rQ2Sv&Pt~-9<`CNU(j|-HmGMJP zYol>5pW8eqv}s!N|MeMelVi`Hwfcv}U^CqGzA8L0*xDZH^(HjaQ%gY$GMI-80&$q} zKgfAE$b&d?9=u6IK1mBB6yP~pbh8b-Kx;x}efp5jF9T&-cqAtvU!yhS+mK(Pg|cJ+ zQZ2k)z$UNf8EXOaEX;UZ_-QQ!^kH6&ApeaPv-6s`EXrTk+RDs>G=aP@Yx44NO`vQ% zIBOO1j}e<49Y|(DWn}2b+C23*y?ts*y=>TgB5v!Sbt&L3k4q&Q-&K6Dqsih zr8V+zizx$g9(6ee$QkELKn`17<)w@a9iD&*#NoWw$m^UO=2##fA|?ra9*phy@``;z z)ZxuKIz6@UtV^IyczUG_i0q*hJAZEmWAF<7zi%32IKJ#UA@{C%jGRrS@Luy4IZlKH zTFP|x(bnMfT*`*J=N$S}Os7qR7d|nrRWZEV*R+06b0Hf>!j=T@_B97}ouUQb)6Ai;P$QUa5v_?Y z+$r9&Q~bi6;#+o#e`%-qJv+s}zEk|!o#I@d?0liTf7mHKbf4lI1@1brgCF{kX{QQ| zolt*UVoJaICGozi72UrkG^|rv^hiMup;cGr-48$SdE4emB0eQq*MjZnQ6%@vCzDaR;@*B0(k#`;B|$XwG+F4WJQ{71_wz}&fMHy2!p%s5cA9h#7<|embtyM$mGnrN>t@n3<%uvG zRG@5JlR0}R3d}XXU*tJjuaC^Vkl*6b;ePh2<7sO1$hpTn6q#46Z$^Gw>)jMbhc}$v z9P=vFttz7BMr{F>Hp zMGpN2>QnYPZd~H3V!Pt?J9+6V430W^slcXlSd`aE4p+st$MuT5^cz^^b*R@TXx{8*lu|RjSg*KZPclk4qO%6GcTgip>MGv>I{?)Tov2-r=px=1y{v3 z&kyzN`v}S5s@VSTL@t~3OTHhO_`gQ36aOSK{fS?|vcq`;SH*LOp99E8Kjxjt^kX=` zk;CLC?-=EUtLg*_`yxra5msKx&tiEgx8fd~-Q~#zv#4*<^lON#taK~J`Oy_vVr#L>%@fnV(6U)mr&G>T1T;oiB zhvWMl|Jd=Xj^A>e=opxt@VjKJw@yyp+i`!#`#PTNc!p!HL1urmi8bV-*Oy& zbBksBk&|=XF#ErE{8z`gqck1nG#dAI+~D{C$0s_T@3_VBIgT%J{58klcKnRvUpRi# zF*j5zXM4wcI_~Ef|GB0=*71>!ad>MwD;=Nb_+K1vaeRy8dmKOL_$kLfar|q?e{#%p z0V@xKtc>?|Jj`*EQpGYn6#|L!=^%M2@X z2giFku6Mkz<8h9Ua(t5Gg^tf~e7@t2j$e2DXUD-`fL+HbOJ&BFxs|`k@oA3nC2uroF{Bx)CTPOdElUL|IY2|4rraTK& zhC1Z2JbmC;4+lB@qn-Q&CqG4u9q!L9$fKRrPX9b7-{SZd$6s{%+nxM=IM(4Kj{nu^ z|C^KlTugcBWBdp5Sf0N*{T}T~@}Y3FKM{`mKGn&O6JwLU$71Bs=Gl(VgJa%LI{9WN zzt+ibb9|rUZ#w-a9KQg^a=zoZrm7_0&+$Qyr#U{^@fyb$IR3QbJK(rq_dEFmV(NrG z)xRQ-b@GDK|Fz?{;aGljjrWG5{e2xzbKK(iYR9)be$??(j(_R+w~jR?v$$OiqAYS> z$0HqcuCl)bUFM6d-6}G>VLCk=_i;SXF@18=-{0|pjt_P`$uUEkEbnoS=_{IimSg(W zCZ}I*%+N98^BrI5*!s*8Wwtu`jgG(Qn7*ai{HkO6nI?bI@iUHpPN<2N1u z$uWIY+g7<_`l}{qu%2;G$9)|Say-=W{*HOCZ+4ikV0?^Y`nM)O$?+1$%N?KTm|=95 z_aeuaIHsR$Iy`q9Z*zQ`W1hQB=U&G=hnxHf$Im)`&N0&>O#e5I=~tVaXL4iaO&Ie` zZp<^ZG5u}h?v8PvZ1Mq)2Ro)8ZaQNfPjt+4zUeT%!kBkf#tR)Yx5DI1p)g+S_#(&j z=S}BI$JaRC>i9;-UvT^-#}7Du*zx0zpK|;o$3Jz<6hbT8uN?o*G5*L*hq(mCJYN{M zaa`qicgGza@9h|W_-2PGC&v3a9^<&t@kGay9rMW)vvZu|X2)|KFLJ!hG2ekOJ8K+Y z=y-!;{HB@ym5!M@V{&|`8Q=j{ulA?Q3n~UqJ-hLF!tI{^AiuZ}!L(DrpbhzJ+i9AR=KJqZ}q{ySiM@1elo*tQdEYI)Q znJk_c`A9L>0pv%ETOv;vGY1oSlbGjvc#imj$n>$fCLljeygBkp@zs&(KVKJ_dotGq z^e+_O8u?Q3mm_ZyGw~Q5-s^ll@~z@;MZQh^Xyh-6zZdx{;%6h@CFWXzov(>sjLf~7 z_YBA%6u%bvY4PtPKP!Ga@(;y-jr_70zX#;yUfnJ-@5Y&+i~KDy*9VyUcGt)iYA;+L zkhc>vnGx!UoL(mGWUP3A?Wk29si8*4dUk_-zffRM5d3x z^#uJdirKxNqba z#Y}rf{+jq>kzW@d68UZMF_C%SKO-{l@J@-GRsK1V>1&)Cc{lO0$n-nTh`g70O=N!K zIxljaczxvl;>#ir6kidUYtQwO`Hk%6$n-~;`NzIY)^bPWW5nAdA20q!WUf6AMW#RU zoyh!#_EhBM;vYs{DSja`zpcF#`QzeOBcCmPGxE9O|A@?Q7mO9BZ2W#v5t(PYd}MyF zsEK^Dn2>OBj=?yuxLx!8?-aeAyutAp#}ge-b3D`WBFFxBfpt#4(eW0?+Z=PfvvTfm z{J7)i9KYiD4ae^|u2h>dn_Q2K>l_bsJj(F|$45Kn8Nuv?@jkKcS2+1v$Co<3+A-(3 z+2I^E{<`Bw9Y5=s^U(A;4~;qZjB_fNagF1yj_VzdaNOvabHnV+a6HHHGRJEiuXjw_ zH9I;)A1KsGOS=^MB4ik$Wik+hPL~k)85C{|G5zkpkFJ|yenKTbX`BaxW1PMXVXYSK z;TF&%^w$D6Y9Uk(Ot0J6)8(~jkMdw28DW4y8VzY6?+_}rSn~VnO^^=uEDThJtrpSR z%6CxY#+df(5dA)tF6NhFp1NANodwM-rv^Ps^ zd4!qj-E_@z^=E1HpN!Gde25J1{w-MAG70>4SA0zMq#aHvG9%1H0*~3AF1xvd^0&j1t?7bj8?A63H?A@e=JPle1 z%etx0VvS63(pbJ6*QWPmFZGKgvtW9>o8dTGsOg>lu5NMk2;bFWOnjpBXlE8I?GXw5 zeyq`jopQ4ud&D&2;rgnzg`;I}>w6qu-V1qq>tzo;?C~5x8urvYifvw)d82P8^KU>5 zRzB8lGnr@msV^@9=e3oO`lc<~IV8;V9-x0_#Nm*U!$;P+uqz*aLr3pBVnop2wGY3y z57mZL2+n;*6?F|Gd_v?y{hJ`|$F=Z$@j=6W@?|&m2z?^9U+4bk>XD!_)4yHMUgbCR z;^|;eyC3eKq|){6E?sYQaqjlq{n<1YecX*}&ZO~t<;CsRkKdN9`AXf<57)_D(ZZ;9 zm!6;MjA}Q!tUd`o|JK)T?p$%v!kYElFWr87S;L)m`TWyc%aqMo8@??o$A0A!9#AUJ z#CDgiOLZo;n^ZO^+sZH8V(m}=cJ;lq7mas?aY>9M=q^yQvNjvu?c zN6oAryQQ{IZuj_r3)S?xPB^q(a_Mnh*Bx5k?(s9;<+JYyeD>AdPae*`an-LXZ+K`%Dqi#F&C}XUnN~5nY|`%i*Xe3`X3x=A zXti+I`mxO#yK!Sad-1rn`&~Zzu3}qj8BcxY<;JT-xshXKrGf`m=RS|?S!I9nPTmGyu8rr8K$?1gdRfqp zf5Cm;3Mt|~uS)jwzr_9|jArt`g^#>TDEE2C6FKVFM2284b)VOw$|&zRP&ws3k5>cj z8}(1_^De{~{_D$!fUVr;JuOq_K99#7bDuX@JJia3-lfWk`@G>=x9y>STeO6NYeNip zko&wnv`RgEg{sKpmN%r zS)KcaB66Qc<+MLscH}I)OeWA5|rB4Y0IUZHH4C2VIzfp<^(>hP1wGpg`;j@zc>2a1d-6ez*wpw?J8 zmXs@#Unpflfg>RId6a5m;cS&q?(?YE$%P4+zBa+*+;atn7s-7db?{1I33;whelG*B z7AlEs4W@CQ_lEMe=Y@dW=gm{8QuleG*5Ai{-Wp6t_j!D+p|$(Ghh?uO&zmxHpZBUH z<@a-#y5`4__kjgUt;-*W{J~AyX7BvT6zbs};`;obsL4lP5f9AYgZ;<&kgmDU!@jxC zqm-@P=e5WF_jAfMA^$1zK3&j%`|2=xC+7K8$lT|>20y=6<(Za0h%&s`QIZ+?MU>$s zt}-X(4@Um-Sm{Lfc^te>>`&@NC`3tCZEjGKuC9EWDf;^+(Wwsgjb8a{pR_;69HX4(C>MpV!;sy7o?Cx4I=`w5mNoa@^<5 z)w&R_e!T)m$93jDk9SUTpGQN&eIBi=I)}~Lo+<|J^X|mJzoB+u;7p;f$|Co9Bvcgm z&TY|sUhuNl%6;C0Qi{c`U77G+<=CWL4YkmNYCk>+SLDLUI&ww#dEZqQxz8h|vcP*h zxz8gD?(-1VGFAxpd3?UNFpTZb4(&ZtxQb%VNjR{%!VB5~xz8h#FWisOc_C6LOeQiv z@ZWBT~rFKHC6f=Mvp98 ziqcr+T3=KOgh-{rAy~y+VVk4NK5eSEm}+Lvnl{Ij{Zi2aKlQYk9yk*m4z@YA?BA7; zD?FopYI9uKn~GExj>FW9vOg=r5$>XOb&j2=&QZ$h+-3S-QNdmwU&eOY^Ukt!azc}y zS@PxDvE;-B6s-eZ+fG87%YRPwnw(5AD)YQ{PEKLV`TPKxNt)PjP5x};GubXT_6}O- zu$(kk$;4h0Wii>n$(cN$cU;IFQQLxW?!px*s?a-M1SKaTy(UazwcbAq|K zMRRjX=H`^l&EZ0ZxuBk!JJrmc7R=S{hq-$Y62@ssw!AL8sYAVcuuJF}YTzDh%Qs;t z*nPp01iiKMU&C55wa@N~Kc%+=eY*+d-K|f36!aMupB(XMBe#Alg#j-KY7)V}3m99m&)b4z`XGK^Or{RZYc)mU!C#j)g+Gw& zxf^bLj1Y zvxB1ToT{MDcC*x47;|Z@dQdl?b280~lAv_=$bS2y|d@@uyuon$?tnCu+s7 z8H3+ec5$W)naNYFvu*%+`T*pjBNyx*E*N4N8nD!Woj!lH0%iLAAmXrJ3Dn3wCbOkO zL+Rf#<>8E~ZF5ptxJIZbPbwkVvPk=#Ht=uLz)#U8M}!9cZ5sI1L_6!$Nxseb_!`ll z>RWJg4vEDgr>_1o{4u50ktHuTIhy%(qL&H`z0A8T1^0t^t~jMIBi60|DwoweEe8Z82vP&Ii_eYWY*2Qs8#g%c%avrREuB85Og|c?x+{exQdq48yQOR< zb-?i{{ zDLkU3^)8vzIY2ClisgS?`JUIJ^0VT7rd;}oLLl{zTI7$A6{)Q^@~^v6cv}i(@5*LU zSKTF1vARp5Vu2_D<5*N&RtH4OQ?7?*qzSB^DJE$9A&_&wpfHt{<(wLFemYHH^{|#~ zW<^~E@KlH_ud4veX6evjvtEmKgOw?i4&5G-cGgm!Iqve@<$179OBK;$FV9VvFo$59 zmV6X$szized+m{Kk{}h^-W;kV3aBl!LQ_>@snh_YStMeGMwxcW_Q<pp;?onISx!65SqKgw9x!dx8=N5wvt#$ z(6lYW=GhT0j~*>4XKLT9IfsZ@N@DH?718nGe>lvthD*mp_j>-z6`~G^E(ITz1HyT; zqZ^RaLtAjCm1&7S4AbT>cVu$8)--SBlG!U3%Gsa1gUQL4JpMJvuiI?74qH6Syqm3> z-4fz0QLspE!Ro@lqKmcQQEkzzdBI=ZN948ezv`n9hh_4X_7VFk#H-i5C7E6N*=u#7 zahDyrh&y9N@Hb~p+2n98cz3kwm20`>&bQpWCBX&byxHaiZr&34j>G?-ytM=eDmrw! zjNzWGY23p3;ZV$PUc9(DD2ebi*DQx_slPvcM+*mgtvx(8@wtk3InGP{kF6U7E)RnryVUQYwKWw#^?ZP?eGH zSE${1R=Ya)!;|q)i7?EVimW|mEr#_XNUij-5kE3Yol26p^>$!`f!G)*Xoj= z)xYNl(Ju2%i}oAQ+!U@fI-7#c%zwopV(`lOVcj6kj*h2_u15c#@P)V_cEefIeYaq~ z5ciXS4jb#dmY!P1X(3eBXNoWB(ODCusT{VR|JCAQTFA@ODS^B^9FEdLUY>*q$l)Gh zRch%g;HMPq401d|OxF_mD98L7t-p|$$F-4BX9Yq9Y{GkJODJzys5DmPsDnG>Oxi{kM%M&gmLmiZ3j}LQv5UeuOW?}OY$ooy~(8i9AI+LXX zoBzKVQHMUj2~p>0>A>dyZ(fws-eL3k$M39ccZTG!`TSdjT-&8DakgW|U7~-I^kMS_ z_^qfze}mVnH^Rz`oW=5ToGdTLgS>0BKE^S1N?z)U z#q!RC<96qW$@{q03mq?mm3M{KES7gQ9P_e0@^WuI*YSE-c`wzP#qw^1W8N#!5py5B z#<6}*&LkQXLda_||1QkaFy?Y^+y#y{xpZQaK>a5j0;Yadt5Y6=JTlilV@AXnAMTjG zg2|6}%)l9w(?2ji!!dPY^2;1w?wA21rgMwq`yD^(_!o}fbWEqw?BrFa#>{Ir?&+B8 zfXTTo7&kgT&hc!=OC4Y9_!h@^JAS}1<63N6&pQskTg2n?J1757$9kb#%p1Ph74>^L zIRn|v{>L0M)Y#%#1JcHGDDFvpCv zHT}tsnRjk-hRPVPb^J-kpLUFI3DdvJ@dJ*(=lI8tUv-Rs2(wd`D=}XfH#w6hjQcz0 zBl0F^UbXQVj+rNI@=rTvZnVkoaLiB@lQZwx_=k=w7+({Q(e92lzMv@I&+$0NM>;;i z@h2Vg&1|zj)bW9i4|hDn@p8xKIKI^JHI8p~{E*}CJN~KT-#C8Tab7P1tjt{;_jNqn zaiilS9G~ELzT*{+&vks6PFBQaL+09_IKM$MYO7gLQ2ptPtCM z^J3)Ocoi;l`k!%plhe5yj&{D`_z}lXI)2Xan~wh^rVJCb-3s0RtqgqM*|@Lc;c(pU zNHKYrDDMQPbA;n#9XC0i14lax#Aauelb`4K633r){3XYCim^lg=v&BReSX*RvyOk` z_zgIg=PfaIzAii1FgxuW*E;U%xCb2V^bwmKJ_l{`gB&+GUf}o>jxTk*QH;&URkrJq zYawiN{D|Z4!m&Jjbep_yOaBF@^K-|1dfRON$?-dIw1eY!vr{cL`JRq@IUeKq5IEio zj&btoVrWUxzQggoPX8gtPs4G4fA6?LeOr@v zcUpDbUeWEV8=X1nEkPiCpw<& znCA%7pXGR=y4$IXsg9P`e>^m*@K{7J{m5it2y z#|+#z`JImMbNmg*JO`OR?9G~Zy3Du^C#j`2@sdGSMLe7Iwt`%HeS zV|m&0{`liVA3BM5e5i#u_{l~@kMt)L!f8-yCAB@cJPv+0>$KoGE`Rn2zN2YJ~ zQe@s&Gdmgk^ow4P+)n)G$h>prK%v9?X5Mwcyno(3GVhyt?}40mPWbhNdAHm<@&RIe z4}$;_%lK2tms5?faZ~Ta@!#%@-px z?3nj6=;NZo{Px`@-VxOiMLH6p@vb{YOCqHQ%EBd$I9`&Vx2E}0Z z`b*;N;ggJW4SQM@?NJ`=AtP{q_klFR{#q)v>`HHfbS#fB*xL%kVC6eVabLa#L(*|8 zluxgqisd_2?Co)_xt5257%Yw7TD-j%)M#g_!m!7^i8ShOmKMt+%sjt)>QfXZSlUX* z$oqEGF|nO@Y0JcZyJPgwu}n8cw#)WxyBD}T!ptA_V@VwlgKc-M;@;kE<8(ci40|17 z8g}`e#_|X=9i`BTj4@c+6^eU%PstwFAnet|H0<4^g*>XZ5C-XC>(|z3B_WOF%W-Xb zo%&=lVJYT27$MkF+RM(pj~C41;$kDnaP9=~1tJYx^;rzV4ER`J5?zZndn%tkgz3l1F-jj;t>+45Jiup2m$=b<_R=%v; z8|TT7)~g-PlOL^DOa8BhO=~k$bIIjM3-4Kz){VYVtI>Dy@1cw4*4$nuk6_>0nvs{W z)VRE8;X|v#FqwI|WTurrvHQ!O$f}L(%3sz!+SeQhu0zQ$)^Be2oNZxF&&0f0HX3N^FWR+Artn_SB$rRjdS$Q+7%JO>=R<=1^ ztK4~sF7#C@Y9@!Hoz z$m802b}Bcwd@jfDN97$mBFf2mhURSjL@du$%e1OuhH?22FnX>EyH&*xT;&aLWz{1} zOgUfGrQEotL(}R^`Oq_zh=Yr6T31%---TL2(X}C5naXq3-z2K~qHL9qOv~MmjgCsU zRIbGG(dm}%!214hzA8%zJ_grRy&^m1W8gy7-sl_vcdj}Oode;nRi8k95L}n3p$~!Q zDxP1ezRDIRf$3Lu%MXLs?ly^1Os344WVcgMI*N$;@|A71=D9xXh&)&2wIO+~x)gJv z#-@Rps;^Uk>1;Gt#qYW0$8MIqvWn-j^5Zzbc&@@yRE}Z_|3X}1(*(PDPI}v$BFEKRhui6q)TQuC06IC&X9rT;xdG2%y5&EI+Lq9cdq_-yg+8yb*GMq zJ`FlwR#GrYm6UXp@~i~mlF1H-bE_{hp=uZmY&FFib09i{X_IG1|` z&J>og!@Wa;%@s~0OP|n?@LWafk{2KSucaS>=c;Qlz{8?ESHYP=14rI3K^LB@HmkuGaMLBvRUD;E;a0TgBpldWVXOX^&kYfk45RZxq)-@4WPZrs zweSfHEC}1~UHAe8Ss2vn3!5--YKSxxc(j-2Dol?GewgIBib!K&CTfdAWMZb0gUux) z>@=RMsDUnAH^T9h0Eb)Exf3N$J#ls6%(oWs!;tuJ`2Po~q@Jrra76Z;sv=ZekPM|q zr$7fG*+OhDCR-)v&}Io;c~z2}!!GYnw5Q~0^h8Cw;b>(Y+17+uCb^)G;3h45hcOQq z5>2M>J(g97$P-C-x{~}{y`fSkx15k{I=U`6TB%DNt#t3H^sgxWx{w~6uXNv6GCsZb z%^*8D+wPu(Of51H6nZpD;nz~=ex%^{f}f(wh4UHTR&j zdxx3}(PV0m2PByxV?7@g{JYFh4eU$mi-q4=Gi`37^1dKb>De2u1w^%FQu_R-nthua z*)kQAHiM*7p>N+YC(l4O1H_ z>p{Jw$@NcagB6=Y^QIi-aDXGJ!&sK4WvMaLssa?#S- zFH3aNQjTYlicU#Y)&5l<3$97pw9lBk5bbu7Osd7vMcW>kNwq_&)B}v3O@eM!Nq3ae z^40POqZ?XnlI>73s4uc*E3rPQ7Nu&G*lJBsE4S_L=4_R#PqIg*pB{;8i?)I*l|ocf zv9YBOyam%S+HsGhUzfDJoyt{ST_O91RTmQ2jXjI*Io|D6WG{IYiRHwr2rgQj+mvpt zos8h7#Zo(~m3t>6b@WnjglRcrqu zT_q{gg4}{VfDyk&iDj8bb#{Ju{|pP3E}lDN;Tg?KhA_WFQ+r#6v@BjWckxPdaFBW? zXj;8u?vfVseGnsaTb2!N7&U0_qIssgLbHDdEnG5t(aJeu8YtV61?Jij% zl~lZNsZbXR^s_IKSwln()tz^%YB3%`Q0%@a_XN*}SP` z?(B4ecyJrQ`weDz&z(~jCNqDa$@FR!-XlPmj=Es!N=;kWY^T<<*)=D9>C)2{&LwI7 zqLo^QX;N|0l;)6Y5_`+SGv=m63iGDJi!{x>Zd$xd$#D+3rdPK#&0gIcX1_1gZ0lKz zP759mQhUsX|A*%CH~qIw;V(`SPbY)_*QV}&w6pX>oxRuO{HA$f(){wwA(JK_Eawx; z7p~yQsnwi0x0xfduw}NI%g5)gICEJzr0Nlec@CwRK3R@GGI&*x`-Zt}?;pJMzw35mH#^;NW)IONexbSTSUy)3 zBR3_bQ#L*IKFoyp{|Dy5r_FUv^O<_S89#piy87A6m$tO5Sh{r4pd$~hD@B&fA2f9E zF!@3nwD0gi^GEDAZ|Hsv^9IdXxO~N#{p-R_H~fZCr`wsjCYc$b2hlWX$-JeR=~EAG z8ar<4QIn@nJGg1`q-h6F89RCE0S)cOj+>(o&qOJrM4OG`%+2 zTy5G%Qm20kY^$J)&@`==!4yhiwHBDNpA(s~uZxTtmsfNsJ8W~N*;Q;(Jj#p?+kva% zeo7Ud(fhO6rIPvK!L z1#T!Y@Vf@}PyNEwAxjb->|)!{z7VJv8{62!G5bSa%FJSUDN_>jQV#NN*Lt*Lz0J)e zdV@&NZWQOd(yVR%E5$X|3z(u!nw>9?jj!bRn*M%{xkj0Mf@7{tCZFQ?c*k6?OlP6v z6^_q!e4%6Bo?G6V9DmvI_ZX^@0nNIkDLa$c|l}Z<@pi`#J7$ce+4-5{*Bt-ZF{2zzA8)J1{K#)S&GAgfs~xX%ywUL%$J-p=<#>nV zHypp?xS(s2m8Z@zU#~GaKRFvuaJR`jW!6II1jlovhm-ep@&+g8V=tEXaK}eG{gWM^2FEg7;`n;UI~+ge_@|Ef zJdD|S$8nuH-zFag$9);+=t zZl?~G>Fn;fm*a_!k9SP@?AYlPEHb-la)zcEb00VM_wn9NUhkOxnCTzr_+ZDA9McCg z{U*or9G~iVjpMbBFLHc|airZ{@km@q>=P?U??6=|AmQr*$Ubp8|b0 zYXb$b=`;ApAPMLnLf46O?gyIu=${#L!VZ8 z2%WXqaiN_XH#i>Sm^w8b>d|*%jW;^p;#l~BLY=hK6k3g=ALVl9BJZU& z+!*7F^uVx9OdBIVY1GHy7>~_3d_UoF$t;+?{t|e51zjkvmLcrXhRxmxG4_!W7`yL- zMQPKOT6U#3K{}QPJJ@RkVzBZZq_{8NZF{HBu9Q!=vSRs;6?=QD72)ez7A)-;3B0|A z?)sF23}LTrOr!p0X|X)Q%ujTY9UI#iaZ6k27&%}0c?F2U^f>4IcHh>8V1W|ZF54rG z^#xiik1$iF3wj+8gQcxi+}oR3pFSgFPemx&yGCqzgqfbQckO%Z#}zS8BT5SEWN(Es zVy{Mvm5=ildz?>%Z|WiP>*Xo)pEQ;)$F=F5rS}D6C9`09UzLF4XyNP9^X(oz!gsY8 z6Msv3v@;8q_J{<&Ufxy%r(W3)o^fqIo)cRhVdfp#+Xlp7Y0oI`?d1lP&NpQ#+T&T; z+B_z1?EJyT(XZD{n(I5~H8$85^-Wv!_O6z~_a(Dn<%{F!m#x%qqYR|~0OROKji@8+ z`rF>mYF{Y?=RR*#KIl05{l;c4yV#~0WT`Exb*@bcWK-5<$i0+x^JS)qLnoQxWF zUav3~zBY`7e{hDxFIHyGyS(CsiTSH9F6*h(mrlIF%#jSY6%(d%}mZ`;5erGpXj?rnS@W5 z&QB#p$GZ9k^u5y1S4ul7Ro{Rf5LRvas*+0IfPNuST4nhyXjZnFjmeybKPpx=R*~{| zq+OP$BUb(!GS;jWYB+vDD&=8Ndp{%<3zeu*^Ap8wG;02Stt%NkoSjUEtMXS;&mMs^ z{dnmUf_D51UwdXwXq86I|3QNMODbk|5*ybyl;I<<6Xr7IjJ(bs^{gTqt1O&KH?Vx7 zb~_z2udh94WT-te72}xs{9dH`G4t5X<)4r#``R-vOzdmVZ=>FT&U=iRZ_AK##>|I; zYeP&sjAQ2WTPe#(a_ZxfSQ!Q9@=qck4Oiwrt3zd9duB|VeeL;5cnms)JY(bRYtJJn z<$=h%=8q%qL2zBB=BJp8W9IW8Pn435ndh36u`%<5v1DWB_d&_V%(p#RYDa0KVMjD( z{yA|RGoRL2I%Yo4Tu%GiGczgTnECv7;8tVi+uE47X1}pQuDaU7qi}U&4v%6d1 zIL`Z8#!}bhKQ2l6b?A4_9{_LNAkD6s+8<~WjLs)o;B+c}S9&;R&q}_jZceW7Mk!KR z_*5y9FWf@y*mtG5s%doob2?0g!i(B+@w?IwVA{Sb&5U!6&ey1!(&+rWZaKXR50bJz z>8411;byjD-<5uwh<#W3a3Yt5?TknVq`x9#3P)0c%|WfPpmBbT z&fi}t6AB#b;^=%PkQYbizr`+Go2*mWo+~_0CpEmTa(fMO#DUQwu<57#>l@3R3yE|&>==}7k-G_cWYWIhumVZr>@&{%JV*c9=uM(4Aw#{7fW|2}@rCghJH z@6!v!tw!hP_h-A$p?`FKD*QbCwP|^tPRd`*NHQajhl28#xSpMqKLh#8=*RC$(?~k8 zKb_c-P9aLNYV)T`(iOXn6037mXGaofE-pie#tgjT>P)Wc+;337Nb2mmQ%BS(sxvq~ zn50TdI?9cYxA0wQcKH9WcP?;RRptKQd**#-2Il3W?6@e%3k)zQHxUuZ%S@tz;w3>u zLx*7)E^--U1`yK(#Jp67rg=jpZ+R^%Gp#(SscGstUdps%C%jZvRvxpCS^xb1zH6`b z&NIWn4BkuDXZGyhde*a^wf5R;uf6tuf9u)qD)!%%J~_lS$}i!t`o+BS>rtxWVCUbZ z^u&#`gB*^M{v2@lu5<-i2D^>~JD=XwErZP-1642B`K6kwCC{O@pTqi@gG*+A7b!^& zAW{`ikajNNZE1m>-w9bS<@VL>!OAAs`Nv}MQ`91`^S`H*!gr-NsOANB{%fesbXf}Q z{Jm5p?EHUVX8`5bx&9s{8z_HH%!$n;+}Xs=cXzGiJdDnDktFFtWS-04H#rUi;k(j{ zsK^4RR+*fEffHS1bn+=u7P`pzu%`9jTg@oD)~8JOa~>cmq!3Qg;6S z^jX5r@bC90VX9(%o1*vt@|>itpBg9{q3t1+unRY&_&~CKQ>Z_4(Q}l`bLXQ02TE|6 z1c5W(_>3H%a#4Ik!q;R0*1Hp~mGC|ZOPaIyztt-SB^~q><=N>e4&(RkFv83!-Y`oU zUA<>fZ`-0QXc%EuhA*4i5DrcH_ML({Re_;onX+(oZRaiuGmvK zv)6M7Y2#P?LxQ3Kjy>-=^UR$pey%DN4dwuPIq~4GYNyhYnBvW4IOH>wQ&Q|2dMl)L zJ&Xm?x~iQ?Ddk!FP0*bcao@>^HO8##`T5rix@7Mg{ zO-oqUb6A0}u722xuC8;lyW{*rSohrZL7wg|qW%7TAe>he*yV-qTsAY+-M29LvA+dR z-O$ZHseU7_HoIBcQm!^=oi-(~J4aiZ06H&CU`M}i$?ldQQk|4@Dm!;=yUUjZ_v`pf z?K?${xeJS`DyoKDHA~SoEkzWqyxebn{hb zXoc`=B^E_L(51eeu>QUh*3%aUbvkn}&)*hfU4%!yg-F@!8WP=UF1}ZMarfChJ%PH9 z`-wm|J=*;DZ0&MX{y)bTXd-jXU#CzQ+|2)?pQ)yZ$y-4Vke%ny1r=i~Sg+5akr@g$>jUhoE+J$00Z~3Egh2;+0^mVx{^42>{S9cZT6Mb;8MYk)&-3Rp`x^JDy?!L>ng>T4h z_RYSI(b(HvaS?{Knws=5^^w9RNZ%rjr>!l{cq$TCU29G}yS#%RihDf*v#+4)URjV*@$a`)Na;XF7g(0MF7!KxdXV zWNd4->Dkj^CY1zqz`_27!bRH9XVS^675sH=pu`*|+El(MOMC-&X1r9d2NBm&X5FOn!r$y=(-)PJ;M`nh5?4PAg}atE@|E?LX-;^*jbFeaZv}Zu}zTvd>Vt%wvvarN?WvKNYOJy*&<`dEN|=_d@MAc+61w z6^|JzzY11fju9Nn{hpWSwFd_-{ST2-Ngw_ldFhs2IIRo=={Xs=MDa&!GAXx zKf56>zv~3-{L(PEDvUC6oFN4r+`a`o-QYTdml}MU!RH(7zOCfT`mvF}VDKLee$!z0 z%_X1LeRIjl0 z41U?*KNdZfxt0EsLyo<-2f7X#9A1OTAW9HsC!bDDA*w^C&g%9v}lJI1Y4-uZ` zG0$tz1;{&1xYpxY!t*?yBfQw-CBls!FBM+p@iO6c9ybXG{`o1wki4+JR(PYw=Lp~A z@%h5x8weK)vz870FAM+BV~B7Md(1NeBr%mLqH@S_GlV=&i9(0|q7e;B+a-}X}JP{>P5-MR(ezQW|pc)YXr;3^+~ zMFO7dc<(@d()0+n8Q*?}WZ_knpwnYN%;PE|3Nv)^Tq{G^#tLH}8DSt16GC)? zWM$gg)0-%rkOwpH@u~nmP%eSzU2v5)!ap>)uhX9T>9$;`-*jPXZ;m3r*8L=ekj8Ve zwYPc~@fT$Xd#IB}`_0xC@(4zU=*IJRBM6YOJz(?>?4qCLjUYg-bz5$3h<>3~BIQzE zDECa^kVi0D*foms03SlyYQ?R+pA1dkVPH>L3id7)4tWHl&nfYDMW8f1h=7mV)h-7&uXwVJrl&Ro~npe)*(zG&@DlfosEg%Ijj;M+IVb-gu&P?Jic)hE%~9m;2M2!q5kxlQ#~-4@-ZDQPH_&bH zkdtMB3!X??6i6$8)aVb$8i>hf!x-3Vn9WfP&H|(NWUdoSO z=4jgz?p!xNikER;7@)1M_=$?5_X$P&U894KSCSeZ#TNt}UH)g92lr==8=s7oSweZH zl3!7-0jaC`XyAbo@ZRkeDNE>_$PfIagbz!YbDA@Ynv{ftdY>ylU+KS1t+))HCGRNh zCHGK`Fnx+QoGd+8`8CMbXsd9QUqj{Nse^e?dQ&iessN1n0nUFs1@i7=i093(lZxZb z54oS-b8U=Z$SIuk>l_}sr?j)zb1W%uekhOOMFV(|*o%LvWR3n;%HMcYa=p9na11F` zp1Sp-M$ynm)K*1>%HPPi9~ifE3mZL9XV z9-)Yc_|9&%w)TndXoXO(tF9>eW-Jr&-}PyMSV3vT+aWo=+sGAaouC*r9F1u-cR?Oa>GG)tn}3Dda2`} zmph%JPHlT#-_AR4+cHl z{Db0~Z^?hJT*|ALz=Tgvwev&|n|mc}?i&9og>hqRYaC--%P4B*E?=UC@!39T=J~Sv zM(64N!$CmLb8l0~Yhy|h!n;jCA0)#Awej%7{S?eJi~#vNJo1pX8li$7XFh`D?-pm_ zBgp;cF){>xvthy>0`Xl#M0?^N_i=g?-0z7#&W`jct>SZ9#p!t=pubLA=#AJrHzaCL zI<#vyscf-Is>9Upbm(f2`5lJ1Eik~tjZ$NC`V9_W$M=N$&5v>ly!?QNOyHcr1sScq ze%f~OjP?~qu8Z2qxr%whLLVFaE*UVqBWz+8{9f|95A|j7yA(L^sCn|EKJ&GoY4B{Y zDyE+t-S5_cv)$n395*=du2&()xDW3)?|PBS-CG+RA#jPdciSI0=QQx#Mj1TLV7OjE zhjtG5D1(nRc$UEn4PIgJ83vzi@Rtn!s=@HPLb;C{{0oDBYw%wU=E*$d-OjsK!zgU$ zU8n7^op+tK!*_a?&Eg}F~LFL1o;awm@N zLq{9oM@Ih{ga2S~7flv}&B0)AXOxleAsp_Bj(6?tPciz(8vWS@uQEE8cl~7}zuMq$ z8T?~|e`oOD4dyth8-e*#z#K-v-3%UJ@L+?78_b+6MMqoqHJHCipdkH%s`b$Ml(BdaNI#B0O25 z!`zbZUx49|{XdVHrEe4y|S9#;zY_IRZ5AdhLkT|H)A6Zp&r3Xk)0+H4<>`NiR2 zkEaVC?lE(mX&%oPKF(w2X0tq|E$4WAsxaYSfdib@wEh2ijz^n6<&N`)ECl*I0iGVX zN*m#1J#);`o<|Szla|xQd9wCs`_%u(kP&{8?h5}& zBTUf7u+g60MCpV)g3ewQz=u%3*8JOyI_Wy;P(PlJLjCAZ)*fpBN;^yFLr9}PlBdec z&z8MwWe9s3ZVL8h3x_k zj13`=VD!4|AzsFHUD;!?4gIft?_RUSK{++*u$=A{%EuwnmfY3-PA|xFxs$Z__sC7 z#lUUX-}UG{#*G*Iwj=!8e1!_sh0L`tLc>=1x7*6QwG`VCom=>teymu14;k0RmV8ZD zDXle^7FlBC*XV+#FX(^VU41m>!#*t1BuqXQ|oO^!++-oB5i? zGqLwIog-7qrTr@zyRVjc`I_bu%Kl7=#Y2&ld{T+6eN7)qhSb;e6SBBvU(;7gvEXa^ zUW|G!?Ze=}rJY73<>w{50tj(Yx+f1AaH42i+L`sV}5!r?TJ{Jet|U0a zY2TFT4*Qzs-AwQ`{XB=eEnM2$RjC4(mM?V`xU@TCHu#!;ra4lUe5N^)OB~alLn_SwfNeNuq^C&0yn%+bt_?mV+-{5Q7c|8qWTIU)$aA}#P z7JN;!T)M!e(eeNDTw z_BOe+SI{or*R=EJ?0ro?K}&ir?JN%cZE|U=$lC^&b|B??U(+84dtcKtXqZjh%xC20 zQ3ubZJpuWP)oR@i`vVR!4w1;t6o=f{z_3Hwc){Pp0OUt8H!PoR~vb4{o{T^z8 zOZz&J;Af@jV|^IFr{oJUHdVQpJ=LJLD{y=&Pl^XR`CotS=u-7OAxN5Vz|?0wmL&3XYlO zg?Vz19pW8Js(N4i3700uu`^aaxkr&6Kl+-eo-+C=8n~`X-FB|4$uDz*nklRmttqU{ zuA&RxqldJt_dc$|Lq|sY_i>eS2ZQ5j7xvSCF-X}}X=}+KmB9U~>KUpi2qGouDvP$7 zy-Eu12e#-ac4Ta6zpo_folfp{`d2V7%$%Vpx?RK2c82Qv?3!7OfaM}?sp;RYZ)S}; z?%Wm+@~(*AU5cvQ8_S!sTpi2pvi^&ODkAK5%IWfYov)OLGl8f@P@f_ z@iRPE{2S->_}`Ux`ftN0?GS<1jl?ZG!nX2EKWKjGhs3k7CQ~l3*R8D(GLrXRkZc}t@S9?(hIOI7_KY@JwiwEjt;sDi03T=zeB|Qc%(qRTlfL?S1%?$ zOq|bgzCP3!9DMd3;N_eXaNugfbNC=RnN=!(Z*6cJ!2Axros$_wkJAqRLfy{ERAVS~ zQ6C9y(#PPz29Gg#J0~-3x9yzFv>mo{GShbWD04Eupc!u%L*5HtxcIpU_Wuv8@rdwu z;c$=ZrZ?k(!;P6+UOi*@CgQ=Xz-^Ew*GIaN8k`L=LwkN1AZr5N`Ax$ zc9>%Xe2Bq^8$8S4IR-B@*m5b|+<<=yZa(JQiaAXv>t0RnLmNIK45yLsw8y+B-sG`< z$cTRDG4r_BJ=Ra-Z`*i+{JOSH=&K=xX{<3N_)a{vUj`o z)Q|BY)bBcB>c_Q7SgJwpvTTa^Pa4~8ejoHY>)EebvJisaT@r8}LpW4=<3mJy^azh= z3z+yB(xab+5Yir$z_#=HL20{k9LiESj%S2J9>M5yN?Zr#cOn%D2pChb55M=edB-| ztIyft^H-le`_cKg7Nsfrf0lfT?g)9v)NE`;+M;=zJEq4?)R#m?W-wPRlK{XL%hlB zb*w3GvdX=e;m~i;mK5aq=-V1EIG6e#^DBS+C&kW4CDHd?f;vK6@`Rwi_<3lN~RW z%q}WDGZab5S1>sz#z1K%bI3#5mt8JdX37;n9u6~yAx*yt&&AT2f5kFZiu=a$vdqC; zKRLedk?|DD?%>03lwKyvTu%8%{F2BwD1EA{_!6mPdk&C5hPa1!xldRW%1>jgn$%Ii zsB6taPmj#x{w!00LV2?i1BG%=wQCCsVslh#->Ikmov+PRTm`XmLlnx+Dm3?9 zm5|-5TK}Wm7z*_i%HJa28+lpob*y^|Wp`@uapc`|Ps>1{P)s8tjC>=p06GxrqOU7~zcOd3)Qlz~D?G#Nr; z1$U&!VD{7Tk2Q13BrL7=k+S5w%_+I$zht1`j+EJC_VoBg)gnm-kP;}Azrb{$P(Dk_ zx;T;P{Kxd8Yn1(L+^bC8DETcZXUCO_R3@w&Do`kgQG-CCbcEmYTsdQtpK{FWW=az{E=k$sZW$#a2It4fY1<)ZjNrA$mX*P>8zf+r;>qIQ|Q0YahdO`%uBUsT^hmRK?-Blk1jY{xNE~kFYw|e^ORej+c4aC+eg>F?R)dpKKI9 zxNFTK<^3snC*@9{Tu-4~34V69a!t$KKpi%fOEM$(HCp)v#E)s%t2KYCBn{ppl-MmpbM_>G?qV{ysL!yIl6sS?TjsB*Um$f3-KZn#<<$o( z$(f`{nstPiYG`rmwX3n zEhv-&mD^XhM|G?#K07_0gT*gVi(_Lq_9ra3D^Mt3R?X#(l$5e$4=m1fS#qiw!XC$~ zNGO!0>hQ_Ilwaridz9RV_MDg#n@Mg_m9q6Nl1qM$(YY>?B!>{0=koVWR$yShW8GCG z%*;fg#6V@jtuZTZx+0^K(@9zABIA>zNm=9~RmmJ8i(O<=)QOYLkl_xxR8^)0`Y>*| z^C>|;;cl77T}yMn>cf>EdcdJBaf17QqH<>LRXdf8<&1Qx*U^=g_C8CAxd$aK?E{Q* zT;ruX9WTf@%}bh{x22=;per@Y4R|E#7da=B9m@HZ6k0&QH>v%QRdHx$%segNGLN&;HLapd3!66cyBxQt+ z8da!xjbxuqWzN}Y#TO)8A>s8-I8((AlC#pLU}@mBO20g{9K53*qY4eam;=9;cDX?t z6T5grcj@)jfnLpl&XTAfhk7-K8c!Ya4GC_M#=tuT9*~Ve&NnK>Et6#EpXlJ%#C@gG z`&Yt4-$HP$6AZmy#fb+>V&%co&R);ar9EWW=cQOSARJyVN{=e@I$6a7mZHT!ov;)2 ze^_7XmJXuc7X<^os9-OmQljlEMT?Az2UFQJ@2+=Hm6Bq2Hsc-Q!CiZl7kAycE5yj| zIu%6~QF-}(5-FR9GLz|9;6f^QH>s$}yi8O~)uUHjUM^l{IllpxiKOY7lN!0=I3;Ly z9w27sC}k|~VRUoNx)3_M^oWbQHd~TI%fQeiwHqZS0Rs;vD99j$hXe*NIkY?WL(AK=u%EHkUc&EdxXmXE~ce?8qc&FUI#5-ko zy|$LTPzl_d1CdR6F@S>MoiYS$H9OZLQ+L^C$757W`+X%*Uv_f0)4%YrMVu)?QS^we zoo(lxE?w4e;^th<5i7>-JxUMZqvqAsZJs)6?8xyW_Z+ogN!_C5bL#)qysOS{SX@79 z!HU`?qu`w_Yiej5)wp`LmejB0nA2U&$xZc38f!<4898R;=#Zr3y25cgl0sw3 zI&Ey4GpBy;$oZTn&p_3^sRq_uqof-0osX#$N_jzppf2FKD^@OB&{VI8&R%2FvIR@# zr3o5*+$k@9J&NTW6~1T*-crRQ1;?G_>s0??lYYj@iySTj>nXGY&Q)aqMHx>~Q2}{b zi5RNJnzTw(Vz*}dJEjutB!}I)C3mZRoJ-b}`x@%sCihjh(i+`B>tKVn>3J0@B9y^p zwM*vkQTqDD^~>hfFR7E$!ocyEQ`=M<)vT=3nO!`)rm;!9L!yl?-slC6bn5;sUn1{@ zOX}x13aT$Z(o}mcMe)^p zy5-A0Ixbn&Q0Wx{8MSUj)1vw%X=}GQZEC86CQmuAW^V05HS;?l(dr7M1kOO}Uvg#L z{Ai`f$@Dp{YY`b2)y``iqq9@+8%NQRdTmX5mfZ!Np6pfibb)Q<&~6K3wr0u^2OL^+ z)PV;aebm&+(+{kf<|@K56dEY)hq^j6G1bL2yD@5<->|GHrCd|iD(CaFrqT7(nntFx zH8t*_)cf7_!_lWr%mv{uDK5d9CG{sOZSicC7%mar7F5m>bzt?>W%X)1HC*i?`hVS` z`r0LW>aAH^d$MymnmXRoHB?W3uWMM&gmcdSN=u?8e=Sbw|)b4-L5{p86s;f&ycg;VRsJ z!(5JAZW~h{EH+OIoYJy--CG*%{KyYr&G%_v-}X4Y?zM=1HznxtwZQ4+DJx!PFJ%a{vJrg+oN03)}d71XJJmy6f=K+1rF==4x z2oAnpdB(&}rS`iR%;17PRRssG?`~d)y6oj~mG%dCJV|@{3pN?RK56hVVA-TSz`+OX zBCo?BcNSPWd5;5^nCD<@GWcC$@ReZc)0W_J-<~&nImZPq_ig)an4NmFqofkgU){%{BwhUZSZRb!wn00 z%hg8$##dgz6$axUFUa>bnD2K7`8tie`N4e2J@qL$lF6NECTLt z@LmQVVDOO!A8+u92Cp=Dox$fDe5JuR8+@n14;YN6nNZJH4E~$JB^q3VP7j0g2J`z? z(3xN`zqJH8zh4JjYcN0f2l=NBKHK0820v`@PYwQq!GAM2tLaRz&xafX)|=J>9%e9{ zfuK`w@JR-rWAH@=f5qTi4Zh3ZR}5aK!7h}w-ry??zRBS482p66|6}m)4SvJmtbQB{ zWeqZTw88rte2Brv7`)KnlMO!8;0p}C%HUfJzRTbT4SvetO$PtL;5QAPQPzB1bp|&W z{Aq)&Z`jL?{Hq3k%isqMegdrPobXd&?pcK2A=gGI=GPvN%fS8~u{+r7?1Vi?`SbXqFuY{~%p+I({y=`x^q8<24}6wn-`5sGus2KsYY(5U^JNHo^xI&M z`d}X!p)U~=LX^Hmziv-&qI5zY%wVqy;6tb%FO6*dUhUV+!`1DgP`~NI*4|7-?$S6E zLP+B|&Dv|)C5qmVA&yr=WWnBS;gCl#`j{FOU(6wdwB-^6Oxh=PA+HHaCT*#(EqBq7 zj`6^sl)Zc#_ExvDH+*RNY{+paOW`;!6}I(zO^N@}#&KNO%HEN(7y1Fu)zqDSb)7cs zjn+oEZ3nIMU{LdcG`8FPKInZ-?**#84!fXtmoVosgg;4de28d|9^nyf0TUmp!H|9y zLP&d10^81aR;Kl)U3g^?j^i2OkVh~YC3}oLA%wK2B(V1Gmp$~br>Yk0sTm4=UNHKZ z>^%?gA=qPYnm@Wz&++$2$aRek%A&pLi{Tm)j82xqR{%Z)dwP>zQ#&GkncX2Dw!81% zVIQ_t>H}1QYd?xQ&I8|8{x^i8yUy^#@bpJ&S+;L7fzJ9lb)BTK2 zSX-QK_nqo}s&xvJ+?&*(4NkZ7fVw|A`KbFF+7&q6pH(f|<#g|b(mUdGJ5Q~i)BQBo z-WyIgtL!?==^jlzJg1u#4(}4DdwHluEf%F!WOT)par0GqtI+XKFX8X;Y>)l}?%3 z!!n#kN6DTRG<#8#UPL`5d)I5Fw4H&iM>9|E?zk^sJwI<}VB^NP;Q99ywTKwf?A%k0 zzEgG7Rf-e>&*Gke?XLc2#{fLdZZ$jl=eg`hvE!kqeFk=TG?H?3t~&a52KMZBIn$#W zS2ey(ww)(u|GP7=OVx)9tn8BFV#~nZp_y;Jlkq0Jolz~GqZmOQW>goL+W*cThg(pj zK49i_N+N})^>+Bv{`H@6=eV6wy`52AQ(#orq;8|zVMM=eB6Noc+ul{_yFim}+1sO< z4b7isJ6F|#uQ z>}W7AugMc8VC4PCv7=ix{dOP4?l&fS0)ehG+@bUz@qK-qF4UHfVt!){0e!fVArN1v zEp$Kf^F$E>=_&vDo%k$nv_6YlQ=#qsy!9CI-f^7u`yD}7p5y0&M}u|!P1c^@&fx9p z9eIJvjGRjuIhW=Xj}?vTJf^)!Lx;;5{BClYDSsmNeLZJ*yh!_HV3pg~_v5_5y?sBq!^|NAclco8z#X0}9Js^B2{-z> zF}GahF~9Hy9x-#az$0c}38RT)`MfaU!^-(hYuEn&JjbAoc`1Qs0$vS-K;I^`=Jvj! zpJk>=uAR$|o~GrSaeJA&uh$krus2KsaFtJ(q5{fP5$wS&4ECrG^$UE%mxXO0jW9tQ z!$5m_6QvXK2u9ee0{9T>x4+`He$({8u}(7T2Pc#?j<+?pw^GLEX`Bcll+~Ks`;6>8 zBtzKKkW{cYTR7yw#uqi9bcEacho9(N2F>=hF|Ia!?$Hno-9S3iYI@Q`JYg zkh%7Gd*OUM=Ut@DfAW>=*|^Vo&&#(KRo$N-ecS8Pe;cj7B7ecO5;-ryeQ@@S}3NB0~g$r9e-WMd6 zd(VT_Jo3%_DYq+~qKY;1cv;RP9`8@kEGy+F@yr*cP;_uSK{%T!nJ$Ht$Xl|f3>4=U zN?y`WFw_0>w$;!ADW~Q*1xC}aE<}jqG$IoX4I`hvt zXJ-8>&Y3yoxmPJ>ay6>CH^7JAB$$axP9t)}CPhl3;t1jOV z7LoTcTj<&s|7Q;i?A^LO3BM|zW^V@N++B%W2qA!XxY5U zZW)MRa?VWSbZL+sIcMG^oO@l?vQ5A!r(0ZW=gfnZAR;fTk5lK&PIC*+nfIa|p2)k2 z!)@W5`Fk?eJ$D^tT*)!?&dmpJ{IWFVocR|j0_V&`ldj|r&Y2xk^V9Jon(}0lVp$QZ zmq=N1BL$|BT=ETC=QPJx?4Ej4Jw1L&rzuHxBxQ|D>76`)>EN9Cd!($3KPGDh=ghrz zyQoMWA?56Nm?D+QU6d1uyfk5f$a?}Q=ecsmCM)R_>*G<%Gd?+z$ocV}itLj>>JpKc z>Qp6JQZ9-QQp&`Hb1mo0oZv}G4QiK(Lxywa{+PZZX3_66iMk2SnK|s2l6z6RDn3dE zUQXr{+2~B;oS8G#ktIcwh~t3PXZ zyR(+-MYZmw|K@WKfq(eFDzhSY8ui94TG*(2}hb9US&((0~51$|$oHJuTIA^Ao zEuAy}QI@k$%#r@Y-2UW!vPn2NXD08Y++mdKiM(QNipaZ0xu)gtcb(mYpMx2>^|bN} zjAt`*I5clTbQva?VUb zN%Bb|Rqoc5OD;vNg>z=sjr;2MfFcf&w;qdYsKv3d8~YPHJQRq$=c=JZ#qAhJh1ZWOTBGl!Y!bK3PJ_A{VJjP9w6|MdX~Blg*If4jSjo zv_K!m4R<~z*hRQohQ;{ZGTg8FaOH;{FvTT)-2G?W{7z%kP9-;SmnJY3i8oxW^vg+{*i~a|irU@IKtqFK-LS!#f*K!+K1yeu(un z(y!S8aBCmL%}$5&!JV)=gz+*wu(ikFK`pD1x(BYX!c;VP3m${VszZpc%FfN+Tkuus z{=5s40=qTZS`toCnCTRzvO^(`rs}^7OpDaL6#TU(gh~j@lvv~zUT${?yfqiT?*$!I zzG9cZ4WGbrG+MhXb^Yr+ET$fTHH5hHTwD>$#jc(VpV2 zj)M6g^qX-DcfP4-U!4BRb1$X}?teFP1gzA}WR#e?BkmO8hB%7jnmLUPHS^^a6#tZM zdhhKBmCCo@d*$KxgY)bwimLPH`;lOuc93uik%bd(xSj97dv7bZy3%dE_SVP+F}+mO<&JpXecL?KciYvjb2q*i-_Fs&2OKaVUs<=Tp|P>4p<&U8 z!w=3kN0!VRvHQp|a&kXn&pk%W8#`|9?&C(!9WiIYvZhtT^3K!0du^20DW$M18J6C^Vvi_&D5#}lc_T&#CutkSU zz&(yVSq5rj!bE`a$xJBBcbMbz^C&ts+OVgIeKbp3kn<)o$QKFo>Ky$w+6d@>{bh;3TPYx07i65s89puw^(*BbmqgD*7rDucge@P8QmoWZ{}_%8+*X`l;r=wfhhg9jVD ztHI+8<_&JJbF9Jo&{{!`f0v+hmBBX~{2haTXz+g-{ND!u#^662{FcEv^^s66erW>c zhmnB!25G?i89dWqUegDiCWBWS%tyL{&i4&|$l#wC{2PN4-rI3kR>&JX-r$J_f70L+ z3|?sP$p)Wk@C626W$-Nq-(~QF25&O>4+g(!a48SC{#X)&2N*okU_Krg^d}j7w866t zZZP;%gU>Pe3WI-a@Y4qW(O^9OggWpWbig|r?EF3XK2sxWwWgZDG| zP=jX}yvX2H27lJzFB!bi;9Cv;uE9St_$LNGZ}1-t{=31)>LwhH%W*t)9TMhA9=L?3 zqN9y)DcI{=1NP_QRwMt0aJV1gPa@=f%HU_fKJTx<-sW$G$$OB>dd=v(WpujhHG0tR zWAHezw|TI^Qw^>$_%jB7(O`}<9J?-s0>*TZzY~7tCyX7AGuY%;tAOEb1*~qU7j^ol zz#J$XJM){M^BCj2Z^NGn!xJR%dpcM{QuLz7Oq2fTG4rXvc-&7o_+4c_g+21}GfeQi z${Zv3U1e@X`RG&&b58+J6vjt6nByDi@g!k9@gQdo_6d)f6GJ0GK1+DI$8&{edCVLE z7gFdf6AnDeCgGF3oS$n5|Bk#!9%MtHPZHoyfvdC;M)%Qg$l7yGbxK`YPJ4d#BJR6T zbfoYaZ6O4E!z8fwPL{owB*Py4hcxVs)rLJ}geTHn;Xi4F3EFhowyQT$Iw6l>^b>7W z03Rrqu)j8Nl{UgmRcxL1)K5cNp?=eat-VB%%XNK+5Yo8Dti4S#G*O1IhdOB-?`&-$ zk6`q5y={2a2m<8UEnxJnQs!9zA41wv#cjD21ET`Jj`BjeX9|Zrn0QNxd4LZgZMEXo z-tDqiAsNTf)u&CyH1!qqqPw((x8Yx zpb$u7yUp)|-bg(+RtF`YhTdJ;IFBJTNRRO*1at_GXbYJ5SEWZk3n8RED1kkWO@q?& zNxLXZ;W(ZV4tWHluPbpqz=x3bl;YOjE3$_k_Vk-#!5)u;;o1<4_V3v-USwWI)~hhC zYiv+fcWv}VYwxz+`YBnm5JLT$eV(pt9N91`-!3n5%-&Z@x9UR_&pcjnfjAK#nG zpF3pjfXeAN{9|B6pL{;^+-oviLc=Ov`a(~|PJQj-mn#bu>-Xx2vVO0g`Wk%AwHrTw z?wYl=`CRX{wF7pn9aQrCTTu%hr%0Taoqgha!r^>cRm@P&u8)V;FA;tAz=Avq9G!H>kRLad&9|HXi zvAB${mS>8xPqHh^K8vudR1F#xpC-G-<%5BXm0Fx@0#>8g{UY=-*~3veSM|sYMUsWH zBQhstmt-=BJgI%@O%ylftH43P!;nU0GxYBTZJqd6OjZA`)XpMvc9zldCX7y|@Ti<8 zpUmMr|7W7&zf=AZza`U;q?nm{x?nC-{BtQ~dyYVqDLq)G9LrL4&a*IgE2*P^p3aHo zO!={hM}y1C?^R-obLFeD0ed><7nBH{bFB7d1NH9;ZLaDnh^KJTIce(h$7L(KS6c5Y zu|7U6=`G}YrzH*4tvWjaoGTx!!^wUe+`atwGLYQ|oRohiE4(kbclmSZ><8{!?tHrL z56+8fs)C_&GNmfNU6Jf$VEWOr>>=RQJKRGprch_mIeAf$J%UIkj>_`dvwX!Ji0GUn zRgmbM*I>@I*fd~NJ^>R)Q)s6A`&gKMqvU1fID5+;bC3Q*=fqOkUHZr7O?J!tKoQY7 zX`C*g8 zh*67@#T@FV5Hcvr3VDl8eZ5fm5qWE+OTj_>)SRm~gH|=i~%WN>-zGS;HBg*s9hBwF9Rrrw^; z3G`>}JLat2Y0lbR=B#}eeSg;Oc4w`;FV(u2{+lm{m7e|KKU8K#`Abylf!$Qw%JOxz zaY4=;aBso94Y2nRYR_5+=hS_V2NWmT2`S^u+7G)RA9`IF>*@^s-q=Opi>@+QiC z2K^(;86UFGo+~`9{7&ky>0^@2D0lSW7Z}lImg9gv`y%>tqMq#NB)vGEUK~g-7e%ht z{ELz_IA5wn5%Lsq8R#x1gNynM@H2apt6Qc>u;&Ju;n0mbqF!EocXYrsNwbb}A1#3! zoH<~36&I!PFNU~|;&nPtzxb=FUXQa?D0I%pm7cg!W01p9LU$6KlVUQ-qhuNEI#QX6 zp?7u5V6z944(Ob_Xm*&)=cMiDaFk$QbWRdVlAjW(ayPMD(u>Fe@nU7|9+h!p8!07U z-5$rNIiYhd#p2b};@H@Y{Rt1lqI0HI>Zj60=Om>pnMwU-x-8H+5%zdkr9kKGp$?yX ziz4e>e~*$%B6DI+Y$mx+#f#2KB$sr<=v)^`lJnFyqH~hJZ}I|p=DV^hlIx``IwyH5 z6K-vya}pVyTtv!37a5<_lCsD}s*HJU5!`v|(1D5bO?Fe>Mfq;wb8(B%~}TH2p{ocbk7-+7}VB{!2yU=9>- zcv(~7)Gg~Ot_niGm2zyliiCJ-Klq=k7>VL(yUbOw@n=0iQM$eNliZ!(VwL62@9ELbXX%JbuAs$KM>ji+H+)&?eQBb* zXre~R`_f2v(MT66RZ$KkNwoE3M#=Xw-BVqUzDGNgV8SPH!L8B297Qql+T%)n5rR#DRCq@N#q5 z7`o~p%uOt0!dx$+QldXpeoECU9?Zd}Rq=jpIoR~N*%daj7`mqMD=sfbi62@^DAk~I52IV& ztUF$5xo)zri?c^u+_l+YSMNerRY0j5N|R->yHm@Ca(6Jc)BrnvEE?KJ16;vYmTDwk z$-AR{r`~DH@zdIZrfYe*>VNubU2$33d_}#*+xApj)xSuo{S`H-ay*>2+z#qX0|Hr> zY7aDY-9aHiJ=~a+^})?l-yu?pc8GUZ-l1MehrE9ue9BgC&g30tMR=a2&|SAc?_IB+ zCiX5n2AGt+3)-kn3GD9CmL`CHqD=|x+@oL%LNEgkF9YJ}ICkr_6-VdadAjy4Fcj>p z29W`FJPNiX45RRdHnD`+q0kOt7?lu2Esctzd&m_3U0p3!P#W=eIGfR^rOO&l9Cfl| z1&ye0T)O+{@gwRN%^k5~?B1jFDr3~Vy1LC%M>$^6D19n^(egR8_n`)z)m37OS8Wzvi_pwD3CEDoXjb7jw!tP&z3(5;0 zUl;KZ;Un_7><^C2OkI}MH!hgNVLDoKjr$CDZQV)B7c8@%;r>X_ovm}enhtWG-(#Zl z;@Pfu(KnkZVd}~?v-O#D^|@sW=z29`EU&7sRabfseCjs$>t&l0pO?&D)l}cu2LG8l zE~;OWQsx??cJ4o;(u+YuXyICc_wBAeJq_sMo!uBU&Tm-Ol;;{s4;WIc`YjI=+Nm#V zw=FDceY3uSCY!B#hKpGD8;fS z*4NKT2X&Mhmb?0`s9m&NnUsdJ|{sYxU?U4NK-lbO?<^_1Jy4Z@$h!yY6K)YG{c%l{K$n znHt><63gn{XL7->B*-l(6{l`@ht|lbJ#{+yIeqe}bPn@?$ArL&(Qu=u=J_k8(!XBqX#1ka?I+-G-n4nBMb7p z_4M& z_tpk?4$S+^cbl`%Tin2foM140Cddync$&eVGI+MZ3k+Ur@N$D!8_c*B%DTj0`d^UK zHv;~?!9OziR|dak@IMXa{02Lm-+%`hJlfzr4X!qLhQV_TUTW}_2H#}x9R}ZL@P8Wo zbAx|v@M{MD)8NkPBjH$j84SNN$VVHDzrG-!Y%tu(Aa67nUz0)pIfL;y6XZWK_$h;b zY4B?X_t)E}kQW~)0Uu!S5eDD4L-==sRqw7c(K8!7<`t&7aDwn!TiP<>h`?Be=``TOhIP{ zgY`DOARlJ%o(5MNe3HSZ8GMn!UorSrgYPo<0fXN#7>7Nfo*N9l(cn7_{-MFYF!*-{ z|DVAb{b(8N?_lsKgZD9bvcc00t}}S0!Rrh@-{30^zS-bA4SvAjCk_6k!LJznH-k%b zV-LqQ$KVEoKW*??248OQR}KD_!9OtgNrRsQ>pCZF66XFz_zQAvgdH`Z33clW_VUAx zd>Yv2J=WkQ2A^%P^Rw*re`e&?hjQ1>%{F%w4)@j}$bB8g8oW1{$3caIz~25L!sLBX z@~K8=meD!M;8P5~*y!J2@a+cQWAM)m{$GQKs9vFNhZ;Q7;Kc@W4B=d87${(=6tG>d zz|=YD_cOS{;7WtX7(CA4eGRTQc&fq27<_`kvkh)Ec%{LgF?g-P7aGjGA{@(A247>a zhJpf=vwbWzU z=@gHz7hdi04Z@%GnE5>G`6!q9`~@E0BaE{@5n`?=kpMgK6ua|B}J9X^_*70n>H?vtA!sJthV6*9~iF)Trc1%ZG;Q;5Pq`uJ82_7Xn?k1@#}$M@Cnc_mUV<%M$36b^X=qu$-62k;@JtybLHdv4eCJq`A{`ZVlb zsx9OZjK<4emvC}S+J(Z_UbI_tKTwuJ{jT$QMr%(vu!s6-=wymh7TaxpAM{Sr&9qvw z5Q5%a5^x?v_@?y6hluv*5gySNF!A3>kA4SbxGjtGEt(>G~7= z1GHX$vQdTm^(Wl+w!HoX24i9U$zd4v>rYsnUs!+g6Usm0x2k9Hbt=8E{^UU^71p2N zbD;|_jKca8o#M9EpNv5~da#U@mE$WStUozSZJgqctUvjMa)$LMj3iU*LA=C>O%mlMSbuUTX2bdu9ybc>PrlZil1p8Xx4Hgg ze@HNn{w90dG&-=>rWiBJ*+?Z56TJaPk68?tUswEC9FUBA54e!C*L6w z)}Qdwv9SJR5h-E)3Fo@7{$vGeVf{%3ro;M^w_LON^(U;;D6Bu>-DbAc`jcPEXouII zxU=ThpSZKu#`+U?*4kKqvLki8H?RNs^2fk_{mIX%lwW^xJZy+p$LlUK2}#q}rr{7_hb!ZUPX z{mE0Dr?CFye>t&X{YgC*TdhC2T16JtpM0M3!}^n$NLYVzC!Hm%KXJ>y!upfhln~aR z{3m(B`jd53B&JCVSE?<-`jaOl4(m_&T0radCl5;2-ujcB zbV#k%pS($Fw{S5KnD4|JzT0UF>rY5%wf=-JQ>5!p1}LvzfAWCzI53A*9itT`2!=jJZ@$jq$|GbYT{=QTnWZC@_=`%Hj{KyM z;+BrMs2+r(UO!iYT81M`myT3+rq7$Korb6>cW$|^;@w{<^1iJT35!BntQ6V$ zI*|+109v%c&OLy&SoOj6zrZOR$8M>%7OOtU@iUix6gwWkTCVy);dZAml^qK0tolGD z1lDhFU-dDopGg3})!x|DtV|`E7ki6HcKFZwcjFWNeUhFU{Em+Z^#T2Y|kpFlV zLbS2QBXM~e{R)gNt@ObEd{ZZReU~k}N<+&#wy)AKt27qPp3CA8XyW2#%lT_zwTE5% z0Rg|UzD_HCmdwi+)=J2U^pg5H`IPXz-0{>?+CJ*@8ovigJ(6vP58C==& zU9J@@90?0m#3u~LqC+zj__<5cddyuS+Z+M~K`~TT6#?12<`WC%IUfGJ+Qo}&osy82 z&(zn7o~~Mp(_SOuyNrSfYL)NE(DVYy0Z!ED^7H5eURV&FdO;61yK zPLHp4QH^V#+Qz!31&iy`NO};ekE$2Bby^%h?cm#eO!N-dX883#)@y$Ij7?SzY}GZr zS%&m>mTMHw&GzLNZ7jb?SD+Ny$o1b3$BK-9EvNRay1pAIYCd=;_Z5Ch#a_>#g%DO^ zFb&pZD`KD1Hc%UUjDYtO)w$?9jU551$T)XY9gXoJ+AN^CvYm51@SD{23TzW#4 zHhA*uwLisRxJ1YqR~QGvx`5lg{88;02LiYM9wTQQKu&!b53s{{Hq2wjvr!&1K8*uQ zpJM`twGX@wBQH8r!O~$o0f#jX$0C;w5`+SpqgyfiR< zVEY<`DEdC_z|Bm7^A+%~41Ueve;T}f4T2g&Vfz|{v>mpuK}g$S`x*q_4yDcG$@Vn} zX`6gdYY>jsFFUdBeS`*suP_*|Y+?N0WaKXihx_Im$lXJY?xFf6DByCizmN0=`?C59 zlb1QgV52j}=p1116oVHSeYftw+yAVQUtsVp20w3biSmWI^)i^Ypl$@_UI9}~z}*ZU zVDMmrhZ{WF;A(@Jmj|0u3_jA}*#^%wc(K9E<$@hIhvA=sn=|`kNfZw{P%*-}XpiU5 zu?C+1j>3WG-%A)9aLb1XmwU`{BV%Ju+uLL2qPuv^JTq|qnX3lQ|4iY)`L7WUod0^^ z!1-?y4xE4Hz=89Brtsn3{<*@_JZ26b`2WoDW_dYt+l3y}50`uV6=66t)c+P?{I`O? zDf}gmnbY#sdF1~g{8f*c-$E-v{$t_WJ$_Uecc;ktU6=4t<=&@9-~RtRZKTb2Wye#k zFxj{^39UKvkL$r@mgGE!kRQFAw$_~a8InD#Ereiim;~S|pD?;#xK7_Q@id%bc$X3t@FAovZW3X~s)-xS{0klFM$ovEiLRT&iZ1DSYwp=*9>d4QojA@f*hH;Yk`OVnC5x(L;a7Ttj5m?vY4EZmolL!E_vMT%9iSs z78PaJxm_s}f#Q^-Uz8~wqF7N`_C7SrN>A0!{U}lN^d!M-CWA-w;__%DgTIH68RaWPi0ijtddH$=Ku+0=nxgt zL<`!DYE8l$hdNZWpy{iaqy!jS~6xL#6hedg|Z# z+FZp|P&bt(?tN$Na*S}^|TmHwc}5!M$^Q=p(xyxNnYC`q}-#`KWvUSmyNY2M#xPzarVmKsN+N*+amqcc`Hj zQ>e4P{jeORBZy?;sMCDOm_E7#(YGJQsvvRi@eGl+*fe02gHoM6x>_)kdlU=PnIM+s zcm=9eOR#nM9+=AYrhztq!?z#4D^uNbUy>wyCHlQ{ zEV;{WyhshBZ$Ff12lt+6vOA5nB1SDrSScvF{f~9S%On$I#Yf80Z!)AQx#Z`x&S@@B z_v8RfpB}@&O_F^`S>sZACx68B87|T{d5M&DaU#4kfc@p=Y>Qp8Bl5$aepi(9# zoNICKIl+^Xvr)TDF1`8o!=4m+MT}qmXA)?$`t}2DQ26!(F63WM&L_`CXPR$6aHhI^ zL;u9R#~noa?T6;G_HF9zzx@F8XYD)YtleqO+FjGes;C+w47svZsJw(j2s^p&At!`&&)ka-Cjgr z+VuW!OwuIHI?6p+0yi{s!0sw8O57aFiTGWPcYaN%$I& zxc3vJolEY++5s^aa`&hcvVqF&tJ`B>d-7B!8!&L9i;PZKQ6}y^DdUrwq%3lgs$?ON#V#@_>cq)r z$Z!YEw;yPMK8zdgd`i$yxLf9N*V5dt`f%lk9&o5jHb z?RA5NWK*Klax`e(Eo#JoI7u54w)DO=C@i)je0}&IRG#Vf6 zh~(eE#(9$VXRZ_9iRLZZ@_e>{t6&q6Wl`)d{C_Gk;5-!-e-FihdIWLLyTfIK=aDGB zhl=!5?FJ1{^eD}bDm0X>6druE{?$oPEoBLdS7@#=gra%7HuyS$O9ke*)K3+y2pI=| zUn$>G$|{p@@N+)jmz;2BQIk_|RJlbe9Q9Cynvid63_VfDSMo5`4zsv;!!YSpx)vK6 z(`2KScbIFkp{}Xpsl!~0`Pj5w`I^Jfm^O=#9XwU;}XS(z?@t#ue{VSc5-F8B7trP5aC0+A6hld}oYGkjcozku|d|w$a9suFK z7ysxY`ago#Jf&{1qSew-YqsjpizAFi@BmSEQ?>rn7U`%$wdD>#g%uB`-l@HjKanM| z=3Nik%J&uYY+LLz=HYi!r<`T z1=#)e`wCm(_*eSRKWNne)f?ukM^x3@)ubxATk8)s47Zk3uKfrr3Y`3rTli3e`jm#* zqu9B@EjmW15Y`EaG0*NHZLsU7UIqGbn!t{1X@Vk!kmj5gau!ABAK9F5TF8gEkVRma zwm6#3F0BoBHy5a2YV)XIGmfS;n>-4WOj#sNbENt=DWW52PMvB~A$-Kqv84XDwxVc7 zCL}YgruGUgLX~!LMI6O0udU^JgTBrN77AvZ77_xJ;iBkaOl<#-MD2+8Z$*K7TeR(; zk#K&x_2mc+-SQy5V9C4`i>zF`sMQB0?uhvo1fP5;aUX3s#o!5c}WX3iAp=B=CQI;^Qe`1Os!64`u}~`yPiGIa1k(1bxy9&yz_q7v(|dv^{#il z*S((gWZJctBy}ZmN~l}Prv=W$|LjG3j2AYozw*Y@%e7vgSUp;6RCyXZP}w!KfEhvH zq#_@jR4fbfLfBSl8QY3B%YJoH&UVh7MW&s0Msb}p4Rcx+H_VqS3C$ZHCxo9pzfmLT znM*eef!C0E*%X-9iH4TuMh)O?Vr<)cc%b-OyiR;zJ|?y}%0BkthHbTX(8&L-^guC} zP0&{Vhs_|i$?_rXOu;+C24mBgVpp=&W)2G*7tUUCQrXEv8)FAI7&7&-um#r>Wz&_p z4RdE6-)P1ueo$s=@3Ccz1|9FlrUke}m~{97hcp~<-~mS-F=gUW2R2MiLRV-tC`pYL zw(KloTf9VkF#aL_fu13jE?zpb=|lezva_1qv>2x;z7Ga#re<9JES%-dyO!+6Jm~aI zyo@9VA8^2)r9rcs7q_%5UA(wy*kK2kS|f|*4I4Fl7g-$++illj^G1)EJ8I0xxx?lx zXkL2K;8Jjr6+ZKp^kk(+s%`cUk^ah){@O!%3ucwjM*_X0C9L&El=RiYhgkxTqp-<$ z7o!9DSS`J^ke`?Devy}J&1)@ko?!|0SW6k?ymXt+?}|+)54sgv$ivfW_}rs4PpCX= zBIogxfJFnW*M(4~WO5RRx16+a>C9PL%Oy%!&o|Oc_cMn#$?r|Gy7ll7(`9aHGCbTL zhtFz}x0xWF(>QC{yoR~WGZ!|tkt|p=cd>GZ)S0tpH8-BnCRvxgHu0IdCC`(O8?Ur! z!6NBQRj6Lc@Y#zOF2q60@YD)*c)E>Hjpa+JZ7i;cJgqHZ7u$xo^Ff&X7qm&>_ zE-OrbIl=zY$IYa%d=CuQoALup^scZur(5xUERC(thuoAm;p`#35xSc+)y>2)?VNd= zvPUQ)?@G?}EHqyXydRn^LkZ>-RjAWqHVZm=%XzrMn0zG6kLC(}v@j;0z`HU(Le*zyY`AP;;FZvr?uk`_uxoS>yd^jwfG#70C6z0S{%e6i^GW9%d)zS{8}j_-H;GsiDG=D3^AjM~mv!yn4r&2gRM z!H)T9(#lS9Jk9YO$IM4(`LA~TKkd_j@uId}#)uj-F4UN@pvL<+KGyNJ`gCBvWz)Gi zpAIj&JYDon&hqc%n2Fg;?tMB;cJhxq=64Ruf1+bXotXSW$4u^Ia%O!rzT5G`jv0Vp zd0uh+XUF`GZ+RFyVq9`O%rSHBS)MSV5s#h13AQ66x ze<6Gpxfa4zj<17bU%kc2zv|@Qb@E4?{3$2@mE+eO2VW0SKZ9hgZdoyPq?2xjiGd+}rBiFIIhGt2)g$M3+gZq@Bu zc?cZ!@8$Sl$KFrG94G&j<0~BB>G)yCw2>WOT?Wd`=1tzoF+Zo9yszWIj+uMS^6(~Z z%(JEO{*DiFJk9ZR$Fm*JbG+EGe)lfx=lRpNb(&+IB}~5B@#T)Ma(s(pox$ z_(8|(96#!qXH?Vktm79P|JLz;Iey16zww)%c8)tZW)Onq>EoE+_)R|A@m`MibF9mu zeh<(;1>R4r-}3ltdY)2#lRqcM{(|sQWZfE*-$mA?T)$qXc{ok}99dm6VfYkf^~jwt zN)P57=bZrNRnBZ%`iKWb`9Se5k$HwU8^TS?>?W5 zJXd^TWZrR3jeM&3(~(z-&x=f7`&?xD+9i=M7GD|pGVvE8Um-TzmNjBVEwaD7Cz(CV zm&D(W@>|8{EB$T$h=qekNkTvBT31_d)BDPyr=Lihn#n*y&^MsgplE&$6$=e`c-$w zb&h#Avpjn{p5S<@;~9>d9CKVv569AYm1B;L$!~Ier{lGbA94J&W6pQeBiyP`QZAY* zo{HhS!f01A8@Z>}aD9xA*M*z?*+C2CNuynd$GGX6uXrgQ3t`B|n(MpQw_f_PI)>=e zAuQ{oE)+*bIM?YSZqYr(HCncmZ@eob4EpMU7^o9rKP|p~kCa;Xw>qY=zej1YItY{X ziu{O+P7IdzQN_K!$$j(VveJQ z$CYoaMYJX#;RjlbiMQ8|($6ed+BymRe$?tjpdDxz?l0EP;e1uxLT6=o%_3Txz9+<9 zUoYt+ANu&*W%{-gyJk%)bfP{dnFZ6w+I6Gk1?5{SA?GzZ&{wO4zUcK`-&?jnl36f) z&Q3@3%`6_VW#1ONj2T%XY}vQPO7#IMkzR+QZwspc>(b`!bjHj~>MuF-)QUpIz{@Mv z4NC@gs~t4&kvnd!UOh8&hQ?jiB$sX1N8=VhpPS$9AoZWXRr3dOKTjhV=xkpl`HGwR ztvIuG#fmqdsVNO9$!MqVQHV=}YWvRZF=+dzW>pp{25-MEFK1CTmv47oRDW&;bDZ;o zInMdJuIRh=jJVYc&MysKTi^G=-meX7cdqPi?yed*_Tkclr8Ir)_N86d?y>#Ysv-Rb zS559;>aBx4W?YgcZi9Ud_h-hOCLLStYaUUwds$ve8g+f*c`G_B9ho-Ppe7Wo^UkYwl2Xv#+U8yKcRG4OS4Fvai{LjYj*Lm$e&aU-MUYg zEA*rW(Z1$qs}yUS#q4V?qEncCP4Hl0_BE$b#_VhQkj?CCIM!wR zngwJt`x;&t%l0*|bC}G&hC$l$ZIRm7G!xmtzUE3P-D>-qaMYrGO*m@XU|*A?j?up6 zSvcC)JV~XZeN8aci1sy~V%N99zJ?bcv#&XpvYW84;pN!uYfgiIvO=Y%7IPa6RsL&U-J=m*z9ZOQ)J8bHGd+T+1KpP zDP#6EONi8G_EZ}einow$v-UL%0503te1=+>eGLw;%l0+FX^Gj_?2E}%#|lV$sw z!`Qyr*W5+!IlV6t!vOQP0}6TBww(u;kUk>%(~{= zM9jM8=ZcihS4C3mnm#<`?xtmkl`BO%+fD2y`nit`EHn+$Mk%dCizon0DB6{togNc3~=@_opihghFv!M zn1NxR%|2#OY9GU1XO67|>}zOQ>M8QU|}K&C5RK4=Ne# zV+IFHpGX z$7^6dq^d%;5ldoA52Z=^9|F0_7VB|uiXln=NL`^NlT4%RU0S@Y3RkT4A-TN6Tuh!1 zq9a(npk>RpD&(@jmGeVem4ATui@%SpN>#AJ*lH^knP9xPMT%0fT#=baYrd+=N~}E0 zzGD+MDXD`DTyboTO-df?m7rc0DA7Enax)evS?M$jl++mq7AS@2yaNlDe?c3Q_ia1! zK0Rb?l}$@J8}Phv+hC_XZ=){9y> zm>o%-Bzl+%BZu`{K+;zWuSew7+gUowS8L>ZX(2E2eYEgH2lDw^c;$naYO%6B7@`aL z^;!s&h0%kYCq~vR>$RAiM_B^)B0MhYi9Dp)Qy_Xiv=^ZfEL67nWQ}W%*a~ zR9Kn#Ul7U98*po=47NT#&M|HcmEjjtALmKGHB^RCDn9P}AKTOWnG2QW8P!r@W%%W> zHAAI-Ii!bLU~ByTXMy-oi)c-pUP_=hVb5`Rh^7BXFTat9iGLzZ3jc{8r^R|7I;$hKI7*o}}Yb~Fvygb7I7tGjZRy;M-856tFc`*a7nDwu5t%y@qS?aNPC z2WmYMmOQKVSSP2=k#mMlh)nT@$h7MxVd=SE>-Le6cZj@RYvSZ#`&}LPf~ByiHEcE< z17jZQwQFSRQXiQ*PmMfZYmTke;Zv}5a+QJ2hJ$fR$k`5THWODMSKYXJ-4dCr-5s#< zmm-^#oA{8`5rIlkI4$Ii;$@AzkqUv~VaIzluhg_&OCN@{5Wer^PdfQ?j$d{BhRgpBta}`xLXWxJ z?|8n*i|xAI6;?jN4sguBv*Xc@4|9Ax9Pe=_I5{>Gc5hvUJnFy1<^Q7NZ^3c9-*x;O zm*+2zgPla&ZWldBSsm&eAK>`oj@eJ@M&KFF7D(2V8_E8@9uan$NM`z z$niAC(;d%tJkK%rdaLKjj=Arf{4B>8I=;m58pqc<=DE)F-0qm4XHCxUB*x!&{6oh) z<5`~P9KY=N6~}Ko=2hCt@;j?>7st#1YjS@0HxAEo{8ON>TfgFQ)ADSKjRLARXQRN_ zXU4FzosN-tyTi5;InTX)BM%V|jXY9pel~a>tdDY@2M>;XfcS{WJi{Ly`6#j3D9jf( zM)^YV@sW8ZH+zLM#AdHRzc71+bHrw^@ENh$EBrsP*(-cbd`Z;Fd%(4k={sMJe7%^T zkJ;ZF#b%dqlb9dUk<+Js5cw-Z7J!mSD= z<JI@oMaX( z-#rp=94#~}-&l)iO+La8v=|e=S^4N^7A$R@1ioFa)kU24Wk0&cG~!Qdu`o43x7$Jkv`^MI|e4`2#zD#5wW)u^*(E@8X7Xdy}eGiU36=GYKP|5bbgNd?!R zT-bp)h+SX)GW|Pt$yavl*|AnFSJ66BX1^Xx(dwq>4PVUCPMU7V^dBs!2>oc=X8u$w zCCS2>O`4siS##pB6C>s?Uf4Kd!3i@LjnEg%M*Y0hGNNVSlE#J0Ml5PPQ3c|vA)PTP z&axRJjV((?jT}3yv1zVlR)N_gG|?qnde7f$(cD^-gAY5hbU-=@S83QnejnDHm`yFE zVe?AE4%doh?xMxRW-VLLw3KhPbCxY!cv3@D@Q zoyKY#r?lGiELLsL`HknXva^a^qwBj1Wr+JTlJvH{bK8Hna5t!+pEsJ;P#LaVKHj1H zy8>I@j{3Fsr49Q=`i-x?niL}OjD%I|%=Lz!Hcyd=X1Zw1t4{Pn(V zlY~6)^^fZutsJWruPv=5>V6~y_ApruwZEyNZ|Lk-t8}4&GwhRYJC75ylc^h7EB*&C6xp2JDydH@}`fr-0;4N zNeK6H3#Lz(>4urZbZ1z+q;b*K*xij8IdXJ~uw}cux;?cuZP)Irz1qwsw|Sd8tK<7! z%VzI_>*mjTWbUmMXQ*{*l9@>|?~?4a&Q-Y-tETl0_IW{`nYPQUu2q-5SaaRO)6(qs zXK$^jeIOdr9ok;0&)n?OZ>_jLm*y-~U{|-|gnp0A8(KB%$f~oelilaaqmQM}fB1rR zw;XWyS*7br&sHToL#&y-K68KNtrd@d;Tx%necI2jz-vb`_TdX=r#W>!{QN0zGq)ZG2!^ZK9H^}O792cCE2d5x#moYS-R%!kLH)3ZkEQ)MUpxKMpZ|IW>g z9Z&3;FH4&nJFo6qr5uIo73bA9H+DJm$g1YX9@jlQ{r>901!>6>zc?s`<|C_)czD{a zxdpN9ZjHN|rmlPN-7tc6|0AmgU(!d9NJmx=zCr7w&l>!7tp-0lEO+S(tu48cPp|%R zdLWNp>AA8wpI#SabY5^WIGaOc+e?(nOUY=RY_yvGXKvPYI)efK&r(TpoiY>TZEJxh zgRI;ceu~du*=%){&X{aP^)ak6RnH;J)T~tLY()-tOWB%Sco?p!=6gfsLg}i^tKLZ^ zb2e2L=7U4XSbH9Yvoa2m1Y?ZsKqR@Vq*@k-Y_Cclz1C@6jn|;;q$@!_^<)o4n$%3v zzo)dcfO@g&ccBYW7FgxRF>2Wd;}HXq#njD&0QUsd*8;6gr_C*nk?)aiX^3u(xjo@RzN2<0w-;QSe^Ry1?F|?6 zD{|s};O_bB$g?lpEB`F={oqnkTcZt|&0+p}MWRoyypqd4y)LH~W^;HXnat*}rl=Ub zA?%2JdUex=qRnC2VyVqxK8uPY*=RO@3mQ_J!~C0Y8=J!#469h8%CSPepybu25#fiD}TKtxvRYA91%JQUUD(~D`+ zWOEocTHK9_eL6&X6`7`e(>8}aNHLqk$JoyKq0G=CA1!5bh_;c%Wu%zRVP`s&*&P0s z?U>EsnUpb`!z)NJn?sIu+2(K|+05pU54UBT!%8A%bNCCgnav?{DdaY=Iebb=H)nH5 zy`xVrFdntL+)=yR9ktY_S9;X$C4W3>sZXywr(o^@`fn-!OE|ST%s)z{Qk%nkuzyQ! z4)brZ>sw`W$hPY9ztjI{bC~}rWjD4t%+F!FPm_Og{#5uUr-`TLzd{|JW!j%<`Cvi% zJXf^o`C!lUEAq>y7pqpEUhGKf(+j!IfnVp;Secqeb%tnjNJ6VmuTUUFV}T8QdaY9S zR-axWJECqedw=zqP={8ZUgXin@aYvU&iM2SXK_Uu$J`uU+W=W^=flh}j%IK%_piuW}cPFQM&#%uGdUlNw}r zw2Ia3abhqOYrNF$VedL4_#4Qvjt(%o@ae_A>o{-d)2nj5+9|a;+~Iog?9AEm<&`Ip z%o<`nmuRZ#%(1~0leF||R5N6br62OZ+v_;(VH*8^iuT0V?pTW5rdaQ}NoFS7{)?6! zuUF+WvxsJS;ER?PfK{HgySXTC(^#M>AP@pUl|=PwNm|ND1Cv_XZu3ONqDk^ zrv~A%a+(!4((inwT%wdqH%zI!Oer#EygAiFjrwt1Z&&6Y1lh+c+kYd&##>BV-Gh{A zNq*tV@Hq6O%DnDmZ$(*^+R`dgt0o}d4o)^&vfoO!XOKg6`LO`1n$@i8KsYTMaGDNA)t5QO_L!Pk z^M+z+&v=KP!6WIw&@)0bGbI>dzC)SJ)c%(!b!WD4wE+KMeS`HSM~Y@THXPZ(zvCSK zV&+|yNv$vcis1Sn7|i5nvc4p72rtjM8|eh8_2m$HQDvWf5%5p-<|%e(eQQmsZ=jpa zw!GcK<&>y0kun62xt0Ct2Wi=%lQ}Ow8O~t(Kx(YXjwD0xRZp#28j?8TE@|hZ)J8Rz zqLJg3rj#$;=>>V%DJtHsD#O8x8C36NXH2Wx_u$IRVe1wy<0$GjRR5CUoOIPYXNELT z(VaL@X+?+MrcG84&5XF8X41K@f)>m(5F6xa*yX%71YA{-A z{XCADX`fd6(Z0@pwCq1E(?u^CX`YMr?@kPR(r8*bpj_SjMo!+$w3Pa(24-3sqkn^G zX=cA3!4fvK(1sq>BuqtZ{Hg7&50E1^W0TsX&MXs9R!g*`MwrlSb$=zW;v&=5I#cOk z^sLN5j}uzSDc3;!tgQrA-_VlUt3r3D39L-zlxq|zhr>m3kjBa~Ol^}Pd`V4?WW{zf z$&qaEfKb&VS3<6L=U(~-iDgGgPXVd+Ur8e7CVMEap@(b5#1Q#a)` zM{brux199HFl7$h>h?`{jnES+f0<+|bJ)*fi&~{_of^4f|GKr_+%~Y2t%)jvw&2aJ zq8(PN743?xThRuqWG9>ItpVJ&-F(9j%m_6+|sQ9s)L&_|ujSej+T^r9lo3_i^qBFYp9D1-|F+&~V z^`2^{ZtGHO)s1}Dg$&xMt+h9nDOgLRnxmnGDR&y?&TU%OGM`3i_@{GcM-xypXLh`B z@f=*Q(ZFTfuV#+f*C+pJmg|Iql81&ifJZdr4)?$ZskXD)4=x48MF zv|nz*D^q&mh^IvPveB?@=F91&bejjVEDF7Z24B!J2dnPz6tQ%{!p4S>^1ss=-kkVA z%i2BOrsHHJyYBG1rT@8Lnt z5CqH5>qdttKUHf2dSH{EFQy)Biyz>qFL~Bz(W_vP->J3f3h!hV$$rLfqMSS8CAzNVb}FA z{(Jr6+!{W#sct*|rdCa}PiympaWn^R5I<~#c=<(Ga?10$kU(d|rkb~F3#9W|*#dD+ zC=0|dvWV8izq~>G>l?(sy+QoD8^r&8gE%Li1@!;gB3cvo9fWvi?Fak9$;AF(k70py zY{c#9VB2lP@d7w=4)=eXCZ(mNu~Cmh4K49n9@U3uf);#D#~ahk*`Hjtpt;dKx$-EK zKHKv|wW&K-`9aP-XxMF?CmU^~^?_ugH-Vsaqx;^*x9{>3KwBerHPx2v*lEuUS4ag` zTjj@)??nn+Ofx$K3^oAfuW%^xc()h{_fGSShIdSPEWA_7d&4FDQ>fRHDe0fWcrBTd z{wYk*lIasL_@vDAO?fi%xUH#hzf?XArh*F7wOF1R@BsZ&;HH9YIe}fm{(O|ys6(FB z8Wkqz=7yY$`pHqgM(fKWU#<05BlF>lpLfa6Cio2kJ)E1|Opw#|{00Qm_DdpjQ#&y- zb>Vv#WvQ=zA1pIBX3CbdhRp^ZUF4@MO$<}_p^@1~js^01t@!|t9`+T^$76bMl zz~+~buYQzWqBU&}&(Qi9SbEqFoTmZ`bF?6*FTnZOA6k&BEH`@=m}}EYSox_VoR59x z0_4g=n}0U)H?$^>9R3olvh*)FAN$zd$d%_ot-lwU>(XPe^6wovUlJ(1tcCnY`Kd(W-FJz)=Rn*msGmH306TVWVFIhhpp)M7l&F~`s3;S+nzf0UDd-0>X83mh+X ze7fTc9AD^|es0^n-SIaa|HSc&j$e2Du4DSA>FnmX&hcQ!yE&fZ_(Ok`YE*@9s&86* ze%J96j$d^Ap+CyB-9Ge3nYP0{`W3?Z&xigfW1CdBw#f(Ok8*ZRtIkER&PhVEnEMOi z9OPOE7r^m4|9L0B(#dad@~=5w>p0B65cNFn%D(LK{0@$F_`R6=@C^8t%b#u6S~vYN zQO@t@Ss3BuhdT}vhe!RVIr(LdzwG!C$G>#^hT|}ALe$x_eQSM!f5|8x@8r`QH#uJB z`2WGNtuA%)E5-HC#j@eJ^t69fVS(bNl%sYR5j(Pqu`M!?% zK4J2Sj`@k-H#uJ7_(aE_a{T`s^IT-xy38@pNG89{@g0uuaeTky?>JuX znC}^;^9jd4cl?~=mmR<2m@$KT`W8PIw-sHH&@rjNZCt~>-4{FS_yYVW=d^9!rjgD`1jD3UU3D5uh zQ>fKq=Xgg7kRLF zLgW$RDUo^C#yEj(?Jk}Xxn68@YVhvX9Oaxh%OlSa<8Ftt$B9=)=3F^Hvc^0nt0JE& z{(R&W;x9x#Uwl(!-kWcWyh?m$WX_v=Bl8_&ZRD?r*G1<2`jN=@iXV^sp!n&?oI?z- zr_Srdn8U!2h<_8A_wLssKP~=aHOKT<%TuFv zF=k+`amn#e$73CjcRbngbjRA%R)vyssaW_XLxIs+<^VD1Fow`m|Ka)&lXYjmB>02f zL2=5HrbnEO=7r%NZ$GLDLq67AcfG!(e|lb{PhG97kNTh=8DUTLSszFv?5U+j%a-zu zR~{=P48EZ2ff%S0VLvUtetQqnc`h0C(`!w+e&O4Z;ucO({l?M|G1#^~s<_v;R{Ag& zMxRz?eY3n-;2@JXCwAn5C4rJAI%K1++05hh)_ zBuNQ~!O~VJ-bSAeP@QDxQ&r3QE*D!FVX~|Ab)#SmmUgk?Uf&DS$Mp++wK0wQ-Jpds zBef7dqMQ5Z_zXduG?v@r+VY*I2j+2-S+IOOOL817d|Ua(T10E|5q_Y>nE0QRkA7ys z(zs{({kUDqs5kr3HKq{{*9omHyeoZNvn?3%yz2GcCw=5YAI~+Up-+ds+~x&cF*DXu+tq&;rAT2 z)Ljc(%|8h;A z@#s@ollua~n(D)}%Jx(CieQMEeN{y&3Li(BrF89Sn)-||-KU+(vx;Au!SjNupYL#EDEts+MqiB!D z&fi5Ijh$tFP&RhP6x@uRgE!1*?0hjbh{n!4q9+<+hvX(vXZ?Q5Dt9>l^$c2rLFVDg6m~?$&ew`%?0kV%X^Tw-ll)>T5RIK@ zq2Z|2lGo&KhClXi;&atDXsWqR|5&2RPTBCT&?!sfbQmN(GIoAa>G=nwIJXo`_*9X! z8at0utP78(m>`!_`{Dy^-%OBsNS4*{k-E-ii;uNNYKk1Bm{KSnM;S9g<^m-X#7vNP zCi2;^ozcZk9OhM-dsJp@@y{HE3p3wVWbY#Hd@@0%I`u^ilVpPYm{P_UIRY|4rr9SH z`%~*HGPLWY;wwb1%3##`bn!<-t`2SRLh)S6T$6c53SKVmOyt_2`V}3MpDNm6oGLF9 zujTq2{P{{xw|GvT*#kC)$WF);rKmYk-pk|qa?X#f}CfA z_j8zf_<`4TzbA6sGNA5?jD*yQW%hc`hcf<#GY-m#1A5(Thp79-Kg1jsI zlNOblnrB|h+_SuqP0LTD4$pI)nVxSz?oE(6D&5$hZtO_65M}df&814xC3C%scgoV7 z!Csi|;tGUlEO3L8x>KrC_6+^s{w%3s*Ijl*W`cY>dHPF0leFeh=_e%!mrQmzoLe$M z9;cig)gR(@D95X*Oppht?p?0dKTMDhS9&pA{rUw?ircZnW`fMyuS}3RnQF8ddRM0` zI=gh1a!in~LcvvJ+c$7he2U0^AyQTB%3-L_?5f;_;t`~n+tV6kx2klkZkN9*jtTOA zp>aI5I64!q$VGk&E}J0t)gHhQ%^*yQZc-!(e{ zkvSO-Y__;k|7C(qq);rPbZ&?gi`P@IPY!u5Y_c=c+JeUo`wwsmfLx(5$x&{m>v33(Ha-3ruGT zsvg*C2dd6DTrNLp)%xz2?%#vFJLZy6U4lQ+0O~%aR*TO*&f>H0d)RXJYioL1*Sbke zJNx&J8=aOvI@E7KtA*&mvQ}rVIcPJcn5u3f6Gc|(o6{SaBd$>-1Uf$7X_bN1C@pO* z0qK%k%)nD~CX96wsPVL@Ybww)(|~3Rzsrz*hyHK7_236P4dl|9&GUvWSTwt7*__4^ zEhn|S&uJ#(43v6_n?0h9Hce}I+=z`Pp&WL?=siX-vE;njvo}s1F?#se;k%ih53WY~ zC>vfcXX{Xzy`YX#*bVrs4&QQ_DbIaKe$Td@WdhrS@MP#qFX^9g=0i z`mBIO+a~P7g85g2*?qMdc{RxVVflikBjvYmwx;)7I7?pSBqG`p;w@1S?4-iKvaL(7 znrfOgH|RcbzKq6HZs9ByJ8^ca8m|;fhL*M!@9tPDP<|k&%^*35@VL!B3)3l~tk7GAy!JIJE zd5e}=@my-P%W4Rx7o(*&vdt>@)Bm+TAf4&e23A+;ZZBrPH}?IgV;+pmw#^0P|Ddha zw%JPkPgzMdj~>hA$zPq8?50aduxFby^CZ0)9&o^(r9rcs7q_%5UA(wy*kK2kS|f|* z4I4FlmtBUB9Jbr8!{&`1Gk4UOk#mR5Sa?LX!4Nk>jSuwl}~sRtf0Zqk%}Mz$Zf|3v*yZ_qr=62en$is65lJXpk2 z1UCWJ1dM*{0UEj8>h;{IA23=@TDWwkCRxTMXjsoTlF{AF;Y|ycHa5>}N`{Bnd(A&Q zw|VBm#+WaiV|WWQ66@N~CVP2?;;^arHBGT<8&xh}I{f|3S*-i13;!2=De?kCpnqVu z!uz-dzKQdAX#IuszLuyp>E-8?)+=hbv~rCJpcAEylR_2A#Epbkp(0B7EYK>?ix~$_ zfb%hbPcd@J!TDHrV3eZ+w*126?>*j|w%UX3>g0m;M*V@0_YRNvG>pO+EjIp&PXxx} z9UtQO2**b|{)FQNj+Z(RfMJkBxW2`mref{f2`e39d89DmvIU5@#!(e(Vg-5dmTKEW~bSDOA+j&F1PO~>mU|Jd>Kj{oSmQeXB=f34%*j)yqj-SK$GA9ef*$HzNf z?)WUnzjFMl3Dy~2RS~}@kbrcc0A9qx{v1h(LV*AV{E^8q_FyYo9lMm_wS24N9NZ+SeK9F zsmR-jpNY(U|M|!~r@S1wkNB0yd|D=a&|||=ty}(IV%u6`6NK>w@sTSO=GYOaKU}XR z1P#Eb6Yx_fI)zg2jB^@`iOg)rn}Jveeb5rsPGo1iuNXiw8OT8utqgiofc@_*6@ zdupNEZYke*<*_ot;Gw=Ah=J`AHXQrZr24ItocigsF4u3vu}^m@?V~ymEZDZ_i|DS8 z39m`tYie}#k)1T!ZB*3P@M{jC)vzg9XU4AYwbwO&tdzpmz>&~^K&$n!PVS&>s-@BP|< zuI&f(Z|ODXsI#ip?GT1|rR5&b$Nerndt+f*9LxpwmS6=(LTEp+?H zxo6I-E#%JDeoU;WTB6=seQ5P%2Rw2f!^+ZaUe~4SLd~<>zT%+9WcBsQrRN{|1sSGq z-|@^YRiD(zx#gwiDOG2GBDv$D>d$}q9eMnyeW0{@X6Ll*>OP&1I_9s+e@CCpwco6z z;FasHyFR&Yc2R0qT~S&+rD}Db+BM5mIxU)(JL=}nmyJ^euej{(f!fY@=T~3XuWJ=| zCw5rsAFVF*)?Q2h-1Ze!`z7agS^mU|kF34m;O2g{OUAFg`-$aU)*rAY|MVNz^{ZX` z^R*|heC*t{H{W_tg+`XIy?O1mE7zWU^ErbLy?ObG_e@xE-rDmYS#kc_?^T}HWletn zhsGb=v%2i@q+;+B`**48`;}jo>T3H=sk-i=>4m&GEa}^?N2!$E{_zf}50<34U-9lw zFIh5U$w{@U;jI;qRzH4il2&p+`(ti8K<-nXIIqjURi4wc=XDQ_|5DE`w^p1vb35Nw zXZG3dyeHH!XMW|EE6%Syb4t~clh$s3>3_E#i)V&h*5$-KIu5Elxv!E2SDw`6?4Q2t z`o{$~t5Vg^R~&TQy9X_N_wG+W*r!&_I{C-=eo;fM`_sF3Ke4HO9CU#8a&ToI9sj)c z^qwy1zMlOZok>c$bWTOpx_8Sx^!@o%Dd}8J#}F+O06pY zEu(*7m|$^HGp8$AHgMQ_<&)DDruEMr&fW!& zX=SG?mnu_k`~6i`PFHxj@4$c?jYC|6x@n}20Nad1d`Ze|93mejY#d^6i{i&2UZ+IH zAx_k~26GO6{|!~whNfym8i&Xbu>AAdf{jDmgN?>ae_=MyvwQBSZ%JO0j_vx`kHw5bL{rTV z^^Ya0)Cej?I(N#_I2~q7kH#VD$R+vi=#g6>^w;TM>o`PidL15A{!;GJB}xxt=PnC5 z!`QjYLq)vPmEiIsI$f!wf!a7-;VVvUo(^bES9oU3UHc8yrdQJCzqDe+BhjKpHMEX+ zynrfxD#PK*7WXG5jnou1fv80a#fMa|JmPUGs!z{kRi;?{scN4yrz?3XW+NUSrOe6< z9}&tU9>?kqURV4%Dd%P;Dl(|ZN3imU$D4@Qh(}E5G~$u%j4tx6KqDRxSDCTJi-}yA zIZ~0mi`}Wg>X5CzIFXb~GINzOzR0oGh(`|agkmL;D>59xNyP(DeO2am<$k(2h{)BU z4PGc>^P~}vm{-4CED*UisAj|?N2ab;t~Be;*nam9r4(i-Tu)^`1o|MV(r+y^?hG9->|7l%+YhCxPzb3WR7Z zu$Pj$Q>s%Iw;$VoRoU5fmmQIfcRPqY6s1X8^QiQ35(K9!>~J`Xqtlh^Ev~&dole?2 zbDvgS_K=(rkN>H4F*QE*&{j4VDt%JCsGw)iPhnnI+$ zhzY1hJW@s@9y!=tGQv(X;*l2U!F3}XPYL!Fcgp@=`8s8}U-jV3w;s?G5|0i4KckYB zud4y7PCifDsQiP9R9zWv?*Fa^tGfF%qpKexDWB=668PsO92fzMitX zuxs7(d^4@t6?w1xN05(3UdrFfwsu2amv7QO)r>(tD3804n%&`{`8)K#W-L51KLY)G zuq&gJ8bsd_hGUUQc4$#zbvgi2DM?B7%B(qF&rIpq(dBd>LKr`~oP@I!>-A@CHxtHc zevv3Q)=U_!`4dHZ@1;VS(>SR!NA0*LDo^K>-cE&fWH@kU1<^W1cUqKW&KRo5Yl@UK z-)ZKopJ~S`FI;u{j_ujTIsKJ5LhAe6qMBwJGq;KRN^|&Z^(B33*-@|0N#-+Dlo8zh zh-UR@T4%#g`EEB+!WWgf|KcPwCJgt)YIs16{&iK}r<4@)_v0s=p`pBd!6*+!4^jLt zX`ad!eGeEgL&8}ScGbtxx-i-`79VhmQchLMkdSgrn*Fkv9iKXFvJd1y9TTJspEV@~ zRr#}0vUJ1z112ctdZm0Wq)exwtk8;>bn`|@18-8&!|7Hsqv|vm_C(v%z(cjW&&H&Y zZITA?gA}dvW=IbHf(BeB+4m&tsGiVfPX=&*rbz~Em@<$Ds{?~H-AC1Wa+THkmAH|k zLx!-Cewee+hRPG#PgjM<)GG%4Ovk|P}v$`4ez z>w{qE&8mic=a4vTu5#yYq?OWZ+3;TKhjL0o4{~>_5xrHWeGl%Q^riGR%8sN?X@(u5 zgvvhCN#dV&c)tFRTqb4Jse>HaBUQ+5Cd1BAg(~~gNzxL-_$f4hH+{op8*z=Y6;`pO zhsr5oyF|4a&bASI2=g~1re$35QHQhJRh8i?u!W(|e!TOCzHoMEJ9KzEKdRY{fM#s7 z8v{)gUpO82%1O1!4)Ulj480zhM!-Skec9Mi&fqw>I;zlPVCvo`^_#PE>saccakrFlKY6)P5B6Hk z?TvGflZr<8Tob#b!jWa68<#z5Gvl%ss#|N=HLDd`(qY$7dtG^yz-l)wX#(_xG=UX& zn=}E!Gn7iOT31ehUQH8Nab;>dv|F1BV{zoHh9NoO7Mt*uq8#Rk(OD#tJHv6*^!2;!9dG$%O=KQKj#-Waf4 zytVO0UBeFXW|T=jwyRcOPcd#Mu}1rcb}SxjXqKwvq-1&0>l*mYP|s;rPx{ShEvhFg zzRI=job*UFf`V=}G1#{|qF3ce|07yI^g#6Y^gzV8=f%T=5kc8pKnIF}*fJ5&aV#4Y z=)jo~fzY`na=wTd;;&*#-<2mry_X4IgS71RGJ+91PVTJY15e@v-|qUxZ! zvR!9MDuWeBy8YCTl6h#tMkKV4wvKjctPms8mDn zN7SZ;DncIfl9X5U3&?^R4j()i7_t9E?9U^a&O0brv-(SaiHniI9nz z=`~Kj36p|oCWN~el3J~WT9!7yYf7|5hf%6|%aWPRjk|8abyP#k!kNc6%Akp+oz--FYKp}^hl6v% z(qQXkMjH!fVRt3#E3=@IK~F( ziRPXyhf#|(*+av^nafX{qmw&4>d3iWV>kD+? zEmog5#I|2=iuEoT^8DG!-x7C@az1;TetsP=J-mPu*cQz9 zO19M`-Z3&?HrPkxmx-;;e1aGdeEs zw>mJ8#`dedDnk+S^TW64;Y$FaW>8Z8dQLuj*(d+Mo)uy21nj$7^Iy+*7*`YvoWb-W z3&goHSs=c*MYJY9KE~-?*ccwRLHbb}#20N4U%o+n)dumaHi+|4(gNGR%_3S8|M~{; z2Nb7noVnC*{RZi&p(Ec}w&MA$Wo~#z<#{38z8az@uhz!_bDSF<$v5G@tM#!de+s%FBpDh=fxAzJTaLm= zEg3FP3Zu1T^wFL$R*T8$51H6$>S1mt3iJ!(32-l@8ndIt{Buo)qkJmNrCec}7Slf+ zj(KLlu?}N_wp%{vlSUhW2mMLGNNvB)Jc z-_*&&U@E?B!!Kxkv(_+or-ve+qWu36nL7Ll)^_V8ujY=RcyBFLio?{0>ws}bSovu) zI3N24-GV$Nt@}kDs`ZG-wE6Cld2+#~mHhAluym3i&c{A>1ajq>q4hDa^3d<#JdLBk zu_n)(S}%#rKAr$8Kih@PAK41z%KurdKOLE4dTwO&tcF!~Y-HQk7h)csfbNXUapy-C zbUvx|_abxLi6e)9;y8)Nh$osVSlilL>9F}b>m2hizOZX#`asXfJl*t(%u~;p$UGS_ zdK8`Y(g~ZdG=4{>KIA#Z@#4rlC7leb?0A)ht?Y`JhdPiCJ!`f8T;waX#;z7Q{qVNP z7Oh;u<7T=AoOq^t%j9ns`9|*5AHJLTF}47@g1=8Pg8!_ z`qJGo4^MOaWJp=g(Y29za(^=NPqk*;5P5i-doD6hc`w4!KVA7@t1~vdTc)-97hbp6IdNgSjsKtNK~{68p|;p~4+n zjPG~MeaGa_IOZB>@@kz^#$6nj9PjLStYhZ)x3V8`e3avbj!$xYmgBEE{6T5t#__*7zTfe09RJaAM}2}YJ&e0F z9^iNv$NM^FjIZTC$}wYaP0r9?jgX6C{{+8n(IDXpk z>yF=bT+ldL)8E7K0LOoeefbH@iQ*Z?;QWxajrva9kzEo z%<&}0vmKx2_;ZeLaQuD8FF0nOt^ey*Q)ZgOqF*&}qjQ4h2@AzQH zyuVxiDUSITWb#iqp5^#B$N0^%{L38ktZwoZj#oPVjAP#YE&t~o^DV&SUvP}03zPGW z!1(Kq?{mD?@pm2bj$maO6KedFN&b$MJl}&5loSe5&I!9P_Qibbik9=N(_+ z_B(&=N$75$mF$-xqokIzMx9! zxBE^qkxOFUHz_+nd~D>Q;#rZo#xIOK zTD&y!o?^aRQFfwuMPvqapB;II_=3o@#2iQRb6w|M6<#R5G4d&5-dmBc5Z@8`Y%$-g zke@5YavJ74>USbvCjNfpFNzi8-e5gJRx`;qQt$zVHvke~$d5 zn8rr_A3|(z;Gc;(zA)EyzIVYdiTTC_|5}XY5d5mRF7j*QA(7t{kBa=3cx>di#rsC) zJ}^Eq_koW@=3DOM$b7RsDl*^or$^?VFe@_mf%%d7ev8pOb=yOX9~qeM{U=BMxOhcm z<})}uGT(tOh|G7~)sa6b=6xSMpB7&onQyn(N4`LObL7?H+aq)R{zha*=HC~YYxaYY z`F?{V6ZCWa{$XUk^*$N-UNN@g#>LdSAd{AV* zPk%J>TVlRfP&UyrD{_sPZx_f5S{6m-8}ib~7!#fxnQyZzBJ(|*`5`DfR?7vE_Y|*= zTra*X@)R)+TgZQ;mg^&bOnh@>?i;s9<{E?17Wuh{JP>(?_y>{aiXV^6HRkEad;|MM z>9^6Ip+FqdDc39#PQRPUvSK|*vfLvHLlS)W?Xb!ay-;=_+B0N zcf6BNc0Aqje8)>2uW-z@(&})Tv6N;E!0*av+Vs^I46SE#(`pJXS^+?w|EQ3~ZOMpBA`Y3*luA8(XP0 z_0uQMa{YLh_xg$|^qRg&Sg^E@O5pW1=|S^$eP2RfyO>7%&C+6Jgh{q@l6+0a)q?DHb&mDf7;Jrf~Bn!`~8?SF>P1&gP(LsV?V<6SZfQ+ zsKT?m1=IJ01YX}X=_4Qd7_wpdwiCO*g?AKS=E>eVo_mKp*W*U-bH(9+D)~ z#e&su#O`~HF1fI!ISlt0yZe|l`D z`@*VbcNMFs$Q=?^)rYHMa?i>@|B7riMt&7FIljnM)KqgJ&SrDGzf|PMDUxGmnu+k@ucuPeAv~(tY(!Va`=;q)@!#@->y=` z%Xx=;lo)-x7MKaVjc-@%t}XDoo!c8O z79OGOK5+NKk<@ZuxL1Kk;@p04DXIOHR_5Eauri~R)VC}BCo$iy1JGo?UAvRXe7m-z zi_i_ij%ZFbo^hjZ*R;h_->!ulslbtJG+Vd|4XJO}!W(cK->&VhlRB2DvaN5|Fy~F` z+qLjRs+jtAE%bty1^t?kf_~9~PiC4^jkoZ0PPHc`5X#Z#o66Ivi3_fr&`!(@hep9(;?EU$jtY- zl^AZe&Z$<=V?8;41bbh7tLz$t)KH3k>sfM`@4$BKs*>S>hk z9U-2$za{%QQp2vh?1;L>>^N}^Dru6|JSx4f1mV)m4u`Y2B8@M% zxUTYZ*{$B0RjPZJr}U3G)$UPxF|z4vy$digOeg-O*E$(k*Xq7N@-5DJ(W->o<}zGBHIpGH)V>|?b1G@GhTD5 z9gW77)WW>TzMvG%sYWYgi%j2D_9EL8jnhMsvKQGA+9Y$Ty^Wq8Y=3s>?@94ua?iaoyDE94~LfKe$|6B-+DlO zNE{LVH>hOp4z*L&XpYDZe3z?EGisA`&di!el`~8MHXb7MIzaz2<7vwswe()13S}k` z%}nJ>NV1!jowyfeCeq7!vnlbI_qG)D=`N^Itgj~NS}ImeCrRG#KR8@p%=}W^o$o&V zUP5qv5cE5k#=RkM-ItJ8Rie2+Tgu&-?sxJYvlQt?p|aIiYqnF8&#R!Hx2P&cG)WC@ zkjdwnh=)P*H60S0l}BetCNnWilGDCVGO^1DX~}nSc?+$1$11Hu7fqVbs;Q$=Yts3B zNbN*5*j#PMma`3R=agu_J9kY6>T$G7Syzr)6=NpV7hRf$DyWXp?Ym}hyGq7xIaO3` zIv}iikbt;#mZFVk_Sv>siqg4;bj0H{Kg?dF7Y5w5YTma|+EyQ%T}VgW%|X;}!+C+~ zHlD|)e|f$iRg<}cLMZ9K<~3n;Y>N6{4pT&$afcOMm|0JzTw|$ft7LyInwQ2zJcX!F zDX2@uKtT(9QK?AyjdI&3Lix~{>f)9WEen@4E?j12tEr`ULo{pMWw^ZTS(10}8l03Z z#aL#+qIt5?QS%egR3DE@8iMZJ{WXw+A(aL^5DH@IVjIZ z@qf|X>&8xAw{fz8|3UArHcP{7n`fZmpLl|SO*nupyEtYBh<~^r*kXLdV6FRGIoM1B zJS%gnV$Fj~UoHK#ke7$?IxQw2;pBXa?xThL{0=}MKgBef!`GuVKf}u`Mdm!h0IV{SL z)|!`J3LagGmle6-_p9AD)48pmIDe3#>g9RIuHpE+h6 zmDP>!{KnjfjQ^Q^;MV9Qw0iQ3mGMx=V;%E-(()YPnBOc+-sJcs$BfgnJQq2>*72>5 z?{&-vPb>SJ<5wO3#c_=;LY6m1+a_&LWX=>li^&vLxl z@imTbalFp)6ONyC{5!{QIqt59F57N@$GbS*&+#P3GaN5;e6r(n9AE7C3yyDd{7uK} z9sk(z^N#<^@u9i_+P+M4JPX$Kf`C5{8=HMHaxH|@;n;`Ib8bXXY9-R`& z^)AnCuolAC;F$kD$4|m>TmR|!_m2PSSo4sU^P|`5ukKuC)R~-nx-p-`jr%$t?0A@C zzK&b|101W%Y;o-RlU$$U{xU|EU)c%2iA-C)8JQtM??mP~q(*tkPkmXl)QK5;2J?gF zfXF<142#UYde_K2huFCH1I0G(eS-MVnCB4jl*l}*d@M5eaKb<9c*wMNTmD~SAGC11 z2&1*wdmVB53}M6ZY%k~=`QDNs4KXa!bbG}+}=TuVejOHseTYazE zr?R4&x8KT4)vYR4nW@QXUn(ndJy_M`_${xprut}9_EGkVysDaH-%yc?0+-6{Pbgh` z8u_xh*O7dSq67awduIY?M^Wwn?wLDFa&H#Mg(Q%WNisu*kevVt2AG5(M8jeh7FmYL zWF`q@b7m3NEOq1%0BZ|KGQ|&b?=n z$pV7<{!*Xm>0g~Xb*j3$y1TmXuj(MFI#!8ds*Mq@7E|qR?Q38xRL-V*)bKlBJg$N&XHj^PXL?QLvFinMN$zz-j{6RgvoJSzv7l&S zd+M+=u9{5!S}A?b)4#}7%l}Ndx^dOQVdZ(TF#n%zQaAsf@50ywbb8>b)f!hVR9yvq zP&p%4E&qPyG5??6!Fu%nc^~qrSgg%6EI0q3OzSiMpXY+7p;OF512O-fOm#5-pFc-_ zI68Gn|L{y&-jm_Ld7XIwSiZiU}~c&Y zmT}ecU6_deKhMBI##PHh73|Jct2M4#G})c2Hdc1z|MR<4_ls09=DKOX<(dGk>b;JAV=G#vsf5 z%0{o86RE?aoys*Y&-|{cC;uXRQvO)#@HF?CQ}fK}>gJV`voet58OVVQ3{i?#Yj!C~ zw@lcL{cq+GB5UDQi#%X9u50G}Dcp@prAge`on{vnM z4)~MeFvxy|#U^TD46^GuPv(_#u#T|AAbS$EQ$v;#gRDwL!XR6x4qyBgMYe|io)i}l zS(tKSa~T1wEkp{%JVx6?q*&ZQofn1tLyG$lSsa?9zW4?zvLvWA7T3s(7-U$RP@GE2 zSs^l|IF*#8A<~r5$(DtPymE4~xn+cdhCxOP4CcNO&Zh*o3ir#MB5}W5V32X;TMzht zNW3rn#|vj}xf-B)GG}BjMg-Mw4>c7EgROM^i5dcAP9lD>H##%A|OIxIacoiHpoTO1aBJNC=*QKDb2Rmp=ckzU;o)v(py zC8rHR()DECI}~*iMGYr06n0W5Z0>N>pH|8~3)ov~}TlP|Nx| zrUo*W$XaA%D;=P^G923uNNCDsBs7h^bDn)>RJ6c8tM=@(nlc%T=V)Y~^)mKZZ_hr< zmv!NU6*8LJ{|ORW@aDENS9y^;SD`n_q0xVxxymau%!WCJS)FH(%^J|nKBTnBPa9EE zb57+(Zc9ef8PDED#69DcBn*GWE}O%MGz5BH_5weL9S_HyJKaLd0<)DXk~{VPHLltC zZ9N}M9yev&f#c;gV(F@dZ7MGe3H&R`?Jp`{j{qi?(x?bWMC3#mJ9Lh?_T= zGFz)emkHiIUYhHjvXy@}&X?#NyX-#aC9=4-@|5$kcw4JFI@*@Y>q&_zvwbEP-Y_yU z-wt?OFUiBr%c5`X3W+YeNa&^+@9-t@xYVE9&Z0MO1S2Av4OIJ%WZb4^flrEH$u|=Xtwk&JwCRwt)eTB3` zYRiHJ9rEConaMPMI6?zAJDSbLFh5karwAo7w>7z=i**APQJn>@!yPcM9 zGi6>>X2ASE@Y0pW546<9xK7|aFVPCr!MIM~eAMT6rXnw5F}xDoB3>qr^)WTUwPF z=PI$^GbalV(4|AW@GfguZ<((+FKJh}NHZxnp2#;kJjdaa9X{RRB@TBve1XIN=J1sc z-{SD?4u8|(A3FR~ho5)&uMWS)OHyMf9IyUm=ak>p3@>)L%i*;S-|q0|9e%*!A3D6n zVb&wEvNYSIgjv_$b~pXu<~4qxo>l@8zNFf)|R4&OlyGiBZ| zKN=W*!r^Bfe!<~t-GEG=nWBdM+Trt@{0xWBark0~`SHQ*_;tZ=b@K3gQ@mz3Ir*<0 zX8kI&Q`CLPaGk?r9G>FvOoy4=Z+V%NYj|&m8y!B-;TaB}>hKbWS37)>!&f-`afk1A z_yLE%=kU`G|K8zBeF(Gq_jh=x!=oKO*x|or?eI&Soo5{WrNb|Pb^Q?jEX;F(z@%5> z0Zju(`4VvK1D#HOwy-@@E=R77aHG@tu)|*fM?23rOdhL)x>5DrCk6^IZ1c<@vcevude&?uu z7fVL{bXk<@cY?6D_c6tPh^-W2mRX-{}j_PDoTPZXMxy#>OSM=<$-5?PPeg27c1 z7$)r;T@W)&$)&9n_Q!Gg&?GrSGRozAk;eWKZQkDJWUo##3zoK40&nkG*{hcfdwpXX z_O8=rc?6Rm$R2!W3kI*2z}xG;Pq}{mV;c5u(MBHYOAm=~*QjTL1=84Vk9*VmoyOnO zO(~|Kcb7KKqlJS8>>9sjx%AxWEgj?iGUShArH+Go(=I#W*Q}PkqpcF!Q#ZmR+PuB< zWDh;;?TBCV1=)K_Iu^_xd);nIVM9^lGYPq_xo1%p?M+{_Ye+EpwJJXe5QEt>evN!E zcZgn7w=;gtq={1})rGM0^`bU$UR4RMeVt{!)AbAOa=v2JQ~%Rv^gq2(|2P0bnd3q? z6vt(Nsw$4lzF}AU)gY{zM65RS8*yCTfiPF~gRrZaMp~|hD@(udeowpHkrJgvb@2p_ zjDq|9slQG`MS0Z&|Jze}s{Y}F`8g#pcCyyb>K|$orRsNdYO}zatpTUr(5643(^!@ppX<2dTr`E^Is zg`X(u#x6tL+Ol+MXWiIEbz_gyj;($9im?k;Em_*7X-_>&*7Z}Wv*hffyM1ky8|h_h z^a%jR;+<bENG55IH^XDDeJbTu> zBj-$?J@?QFy{FHZrT*VEO^V3)b?yH7*1{fX;jt`MhP9DZiG4Fv+&bY|(9^vpC9A~Ooo z%N*`-`0ZfG>U zgpFmkUi(s1RLTL07F->pHg zE|Vntg#Z_heUFbsxgo8ahnwD5*!T@UN96a)rM~ zZsQ6Ml1lDwvSwUiKK^aZ6^88;xx&Ao0^8*Z^M$a)6}|ItSD3kokt=*9 z=8P+x*I}2q!h6b8pN&d3uJGf^)dN@f3dDgET$_KF)Qu~=7Gt~275N4XHdQlJBNXXD|{R&#uaWP#kj(O<854F{1244!Z&e7jVsI8MpDa7) z3g3j9afLS%F|IH_Rg}2G^GMk)S9rM2Mu{ujPA!Zp{6)@_afSI&p~Mw_47IJe!hcjL zC9d#~Dbl#Y%t0@4g+ESbF|IJPsY_hp_fco#3Wt?AjVsIqr4m>8CJY!?xS15=3iFMy z#1(EM@~Ux#uT}#@t}vs$>Z{W*pdY4Tb4C$v=XoC%oNPy!(RI(fM7rvuaDInE(rtz37bp1~ zN*%7W2Fl^fisDK7R^|}zgZUYXh5}m!_B917vOz*ClERWvXuN=p#{cHn-JStOQ$B4N*{g}SEQ-%6q;m!IV!Vvve?^Mu*8H0_*i82VTNbb=8m+*-& ztjhOFfBEZb=~y&2QhLYh^VrL@-vdE7v!>5UXKqVM9=m$-)bV;l8^5Tvb=%bOuO4MN zybiuHgyk)wCx^8vwKk;|!PI{U%NbSqEn&^d{<`(`v}R>@!g86Vy!|h#aY4pd`(0); zH@A~RlUsYLhQk9;l^aL;w1RbCvB2Cwo1WOToCx zj2n2MvnSLxmIuPf?cvVA^j~i^$ZjpR&2K|`A#ltcip!xge1Z4z z-OCXnEit`STtBwEP#Io$%7V)9_0`7*mVTY0cfdvVCGgFf;h?=Xkv^iFJ*!=~JT#H2 z^uW#lchY#}Y)w;6dg3Y5`%JDEu@Yw)Y@B6y2F6(i8)unM+Q_j1HhsZYWNk!UFuTlO zrmd!;uS*LYezW2r6v7o6y8!KN{Ic*{T$G33;)^^C^C$y z;lG6kJ;T{~y~F&dWcJ_WFkfd)zR2P5{EdVU#xr&Y zkn@fCv52wpbi|BDSa$~<+W*;z`9MtgXW~=a8w2&Sk9=@rz)ji+8}=;oXmuzdjeLO< zqM@QrDJ&n zcbQLJ&y9_nUqfw1L4^$sNt zt^j4h(pD*In3Qkm!r~Vc3zoK00$=XpeX=zgDVO%OaxW3KJc7w|CDs9Au(Y*`dwcyg zpstq;d%T^Pz3YT6k6_Xwd%tl4gIC8qO(-c$mc28y#~#d75IgY?- z(VqBbZI(wc`MvDX?=4u`BNBLf8)VO}5AG$_F1#n$wSkSpbklhX5QEuc@4Ar|3)?k5 z^-5irW6hZMX3ueuR_qF&dg7!5CQl9|q@DArH}9{4bWmLT`khSgn7sA4K*!il5Etq4 zjh8NXaPe&w7X*%y{=eg@+?3t#&#{={JFcplGNM`y5pX(X(uE@j*KFx~;ehIEw$yI? z@<~~qOF#MSpdp(ts~Dlg1y!%7t&DouuuUR*;zmOJ= zJ9u&7+RDq(Gmj&r3)2rDyY{cC%Ct1UVN<5j7Pgn*3q zd6QS@{V^P?_*Pt7=|_~fB$Fh63|Z8PGGD0_jc@gPu&vE_0g-HN#!pjO<6ANRu*A0teuTfOWaC>gQ?UoW)uS?Ie5>1~ZhWif zP~T;~6;rK@Z?!?kX?&|eSc!bApCgZas}Jf_+1iYmA7S-~q<=p1BMdI)|3Kczw+b|Z z$hSI~yvDbBL8>Lb6)Qyc#J4&GOUAc)Jxbf;+-(c_UvRkV!QK1_=g*a- z>PGYjM|dHT9{mUhp5M;>2=~LZ`4N7e zlpC2{=Yb=$E3nHVv+HW=5LbcB z{0L(|GP^d*aOT4|tO6OLB#S8XxRP{ph71(_2$P^+a(#vnjTyG~BYcU}r*v0GWNQEh zKf+`!`w^xNDhxluwbKRhBkWg!#KWwu0(mZn75xZTROzxaKf>Xzv6UZTipdp^Bg@YH z2ya2n{0I-{k}*HR#}R3Yt3cj>S~q4FUUY30$SFFM9r_W@s&u1jUSf9bjm53}2p^#$ zVRi*S!ec4l{0OsjaEaNqP6t?Gc3pu{TLrQo5%VK_Dh7<%^*%a`tpa%w28`JiR(>^R z*Ab-HDv)!Cl$c#~5&Q_3R)O3_Kf(>NqVwFOto?FjKf<{?bbE<@gd22pk?4f-7H#SJ z1NCAPDPHf?kq|PP7YTC}b5yUlC^}R|!btS%Dv8z9lXN*5-zzkXQSdFwR~I>5!;h5U z(-QD`Lc+>Ujk||0mhd47pZCJ^Bz#=Lz9IW56`f{e#I;Hp8KkGB6Qku}{~c|ZQ5|&f zSIiu}>SsHZx$& z+41T)qMor^sx4!df!>)VuzPnY0d#$qz>bTgI~PrY@R}!A&AjcQAc&M;##EqX7tGT1 zXcKsat3&yJ(56z@{ZU)@`u4EKAj^5PH>eFrAqQ)}lnS#U;<_Ka{#sS+NA%NTX2` zHIzvbXn84qsYTSwByuv{-F8KYOv)?RxIf3X%2ju5&G({cy^oJo0-Z_WsO%N95f=ORU`&n;i5ejAsiRYz;V=X`VP z(zcf6t5(WL%Qq-`A?%U2}XlC6RJ zM$7&4vk0vX%1iTx%T5bgw&}umSMLs-TW4oj*Zo10TQYK>dTVq0DmC;=T?e9hdAPV~ zz#Y*JxeJABhnt34UT2DBga2u1h>dYz#9o7$dAM$v@yma)M^8pe3URYkYkS@ zRMF?Hk5@r3Kg=;MMCW8}{Md|qu{Pc}!HiZ3=z#lcL(V&)*)bv?m}3 z57I{7uV^D62b<0B3iDcs4lj`v5pU6+0PPZt4rw-)#LmAS?Xr6p`4{9}_U5$5Ko{D} zBH9z@Co&7fr^QItg({QRTcY-)AG=k&eXBUr-z=bisW$75@H+X-VuAFGyvcy6+l{E_ zXXVy+s`B$t3$ZWPg2CGxFJWf%B+{Mv{^l4`ewbC@_b~7KJLLyf1#USh z*R?{OHj~$b;|bw5Ve9Ae-dfbPJ3)K$8W$CPlQ%|rt@ga#B44ci`B7fbo|j$Z+*Upk z@sG5>H)3uj+}hBge169^%q@~~IX6qaWfL1< z^GkkI)LE+i@ey;YJvCyEYXMk!X-059w(Sb!D)&6?;Vqy;-N5m0rj9P@4zCNJZZ|3J=QMB!6T|8q|N8xB9|@b4V%r{Ai~e!auf zz|sEeo%{{L_Dnn-xoiv!e5D) zvHdq9W-R}3#GGe-TIYDT2>&SJ{}FyF;@=AsUTF^g(b!ZOgn8NwpW!fVZSr#*zS!X_ z9A5A6tq$Mm@Fs`37R>%;hkxwwuN{8TVb;5{yhVrW93JDavhGr-la{iT<_Js{Zq#NW z7s1wZ4$jcUL3{DqMSk=O+PEIPy;Bwcqc#g>Z$AmZO)=p?+3T%y#9;N~-P+ghv3+)J&cU^^SM5F+Sy^w|%HA1z@xNB% z2aZ>drPA>(5Vkym$&Gp-aeuL3Y25P-llG-PI(8>8xKe5UIR3D&c=<}CT+SD1>@U$~ zc?6UD#ObdC#9(P_75DaTRcEP}413B_vUi=Zem5qte( z8uhzH8+j&ZBYZxhaUEnrDTt1m-TtU zWTFNtPXS^ud+c5FCq)^eA8=h`gR*FE`l7e@6)9XVnFX^K=NznBzG7wDa!oqe*&6N> zryP91LAyBT;M+4*nkvDy&)sO7IR`<$^M9DRQ`>nvR}C8C@n3qxF%^Z1QG@ooKtqMv zWWU}cM&>q-OrER|t^fOnq?z>6-j`o$=(5~xIa`7i-oI>QNy}tszut`pD0kDHb;sXV z*WJdH-j`pLDNgA#3tG})rp@|WF*X>??&ChD3 zkjc+`VcndXskvDfe(d0hNwTImb=~FP8&WxGPPJku*H7J8U6T}!Q1s;blQ&kY3l=Ua zr>!ZjS@$N1Dwj+?d(~; zyD}eRhR(jtyC}xKLf_$ju(h1N)RUZk)|32M$-h&wGa-DpRW#X@X4kUW|AX$2Y5;{? zdY|rV>05OH{5g{(Kaet^BCY;j*wx;q)QXC#2g0s~0iS#k@JoJ0u7=@oMQs(Mvx?f9 zmD=TY2Y>%){jbX9mdILVemZhk`;~<=fhP&(`o9asT-6~`$(^mzbEA+{-;K$IDF$kC zxi>tZeeI_t%gtt7Svwkd4AP|682#fW*PDM@pOMlsa-SNzi;z7N!7#)lvor;vr+qAd+Hy{{Dz9FpcjQT^`o~6EqpRPwrh;n=2kGsk>JV_DFj)sv^*V6>LM3<_xLCNB8XO89RKQbL z)nVWvg+C!b99)<5e^EQ8e!PK_Kb$IM7BDF zlD%0<;XsBZeGXMYn)-1K=0c0j115!$n3z9ZFjx3bESzwI+% zQxuZo$yDI2=^1LoT#*;27^y8jR8A=r_aV>QLZ1Fbo)4Oku||zoEFMF1UJz0S6{lk0 zq7WHUY$VUc=|`njw};3+N!7olx9QnmUz|b8rRf(GX)NL?M-wur&Y0pGG4SpXnNU23 zl=p;kCKq`D(}aw#D9@B)HRt@w^y`XDD{dfVT~KQ(-pv_(U;0C(%q(&SwA3!mesu9D zYJI)P(MdA9xI3nANE>8lbMb#kxiPfCkBfcCb5r_L8Q4<18q*ts>1WlJKT)*L@1&p! z8Ksd^CmlZ92whp6Q=VO8^+l+{#tigF)*LHaWbztjJ!?}#Cn9MxCL#wAtXBk$3L zGbnd6`o|a6f*)NgJg@L|>hNS|teXCMbMFhr57 zHP2U4MOyoACHBkFoFN0<#bpT5nBjIM4I)>++~ugRlNk=(sUsQ~)#(bsBu!G*QSK)s z2sca)I9yv5S$wd?b?<$K!_s1vs@{N&%D{w-H!HmuuH}&dC&iT=z6gLt%JVdIC&k$)!50Q4E$b-2wA)^uNakP>(A%m3KVwm-IYRFPh%@7Xwib`QZ z#trK5#g9{DYv}Lta7tuh%8AVtZYrFc9kOGBio*i2+uh#Z~t;$(Bn2nSuGD$@dk zxo?E?DFMrM_sg|Q+%LydWH490^?;{B;R6A8q=8WV%pqf@srN4weg0H;L zMP+A@@LstSRd#w(y>P!AD^vuvBTUWpr(vy!3n)6I^SxK|pg>zq0`RVEB1kJaj z`3KeNnvy25tnRtz&^&`L$o+Da`rqeH9b7S8@EhU6`Ko)`x>$8j3U84-T{u|cT;WLd zzqE}y))rW@KW(QLg+g$gxrlQ5CpiqIi*HqA?+?j9dKqny9-|kKAuHwDIK7Okb!aH! zvc*aoB8p|y8hS;@FkS!mX-(4il4;m@wPt!HRaaH1-rjZ8{am!tjU}_^md&0U%);9Jr7^6z+^9!Tmn8eWSgSj)0K?aG{Sp2N875$90(KfcZWT%z zE{SmBbpopWv)k1EW>emeerc}`>H0f0WE#yX6Ca?sdj#$h*#7|m)&3E7^T$5MZqAsW zYR7xQxF=@@th^2fHnC&Gyj3#j%V zmD%oX|ClLHdPe4|r&iplZ%?%MceLps6wCVX{q*5CNaujihwta!#&_of!oA{t?iG&^ z4Y!N?xn0!gnivu88259>NKZH*+%oRxmeHuRunhP&DIuLRS)Kn|$Efy4DdE6^4tlk^ z%v`0>vpXc)N3wTG)*fW1q%(C4kto8{Io$?M9hjxx=qQrQF3e4f?CnT%E2C#mdfOO5wR z(^&(M_8y+h8ZcfN^8=i2p{&adu+M1#y~nA36pM0Q zINBlQ<<0fjRHSt1Old1Exjw8szb#4XyqRuGuMaO z-S*AkRWl@JS#_Q1i8_WxHZOgvzZ_B=q3Cq5#q_MXC`?&Iqz45kg`vem8 z(8$VBnKaj=?$hYH9pnM-sAPPyI}Ak+wEAM^ps1?T#1S9tqB^uGrD=KLgiO;}pX$ra zX7n9W5=AWxzpf;7)BL8D>`92VLrYr9npr!{>&zN}RtUNwYM?uZ-HZU|1+o6=QV(>) zie$n~`t>0u&#~m00{Y%YW_CPN)4<#o$OZ_@gJ>>0QkjD{_a=c5j?@1gD)7iZS6laN zCQZYya=}trG(W`kuPi#jMAYCiZK^Ii9-^+gq<$!f=CUKTd%5q}nZm77xMQ1aCUw;< zi%Qiki%Qj{2KQ=Hb=mQ_bk!yG@gSPZj@0he{o>9Po|MARx5;KwSKYFxRNb6fY2@zK?U#(wb^Dh(EsM6+`iwzZF2%$Z_dk&sSHbJv=cZJok8b76*627@yMK|RUC zj4Z*-gbK*SVUAU%tien;`<0(b&0WLW!Ys|oFjKT5&efEoh9u5j?aMsRZ0=}9m_eHT ze`CqrGJ9(kD6=5oH?{LCwGOo^y;#*I~4HHQD z$ILt?0x~;HbH-M7n`@y-d&}B77PT#JU1QxgDbKh(yH%ILvIVxN{n@R|Gu4E{C@4=$ z?LM({>4Nr9`q_(RSCa~tEl{@7+W5LUm^Rp^8Ea>^dh^V9>(r#!vRQsydS&M0#<_{z zj@`}d3q^)WsV`|>Zbw_o!gkGZ{2M0ZGDR@X9p*@x5v-d8=gg+{%~-N1)NE19vSlrr zFSBU55c4uyG$AwdilN`3n4a8yQgSojbh@1wl@(lKFnLs7G!}$1R;*H4+fIShA#G>c zZkT4cu%%1WmA5--S0zzD&M_5kS(?p>Z0T$*dr#=ep-1c+*?gclJ9?68yQr-z&O?<3 zzy9kNhcNwB(aa0O&YXP&EuAaNKpW^{2<_HwB5!CRPHJ=K!X=uG&Fmz71>}tITv)mU zM-a1*JK~MabB;V>{+zk9PB^l8Ub55a<)ueLu%hah&P?lKxhCO?pinmpI-GQ_i8Z*8 zP<66tp|8fQ-(_-4zM?fuD*hYh|5`upX&SIi5q@d2fy=k6I0a1iriDyHoc2ZS@y3`UEc%Al?duXg6axnVH`GhwzV!qxI&;eVW`Td_H_mEl80 zxw}*b&o||6!l#UKsO-k%qddNTltX2yv`ki+Q7K9am4UffiYkBqazv=RrxoI{PeiTC zL?3co*cD$c2RMC7qdQw5euOr<|97-8=l59cEs#FXBH9x_eXICewu40DOoeKLFo@;d!fI7F8Nb9(tea~fC&N1N$~^?+%!j;OOv`?ov%4yQvJd1?EN z5jP2QHDli%H|P*(Pn%OcOxScrfThEE0GrNer$bwz!}$T54vzrj*aml-UoE-*lB1Aw z!%}F~M!Dx|-wu`n=M!u?d=@pGl~IS&0XCiUqnu_3oBRXFWuNQwMzHMHMQl2J;WV9F zqYixpY&xHb@<#2!CVvFE?DOsL`(W9pJ;0{JCrQ(J5-gnw+JjB!cgSUjNAv$WTpiCN zeGqK($@?RhK9AZ#QRissfb+3`)m#DhZ0Ue)zW2B&KVEWhKK5aL-=m)MBnRhX ze{Mpqav2`H-eG?7MW6l-&c{A~O4PYfdvQ=gUWO1KjhOnwqqbxDG+1^{l^t+CUN2vc z@-rj{=j#L%9zi}Z!~7qh&Q8CTiGb-#Y-xO?(QoWt#32pPu@Hu9Gt4>04(E~0@=gFp z{mJMEb6%!8+yqu$8Pgw+Jlf>`W%y8s-{|lhhfj9+bcfG!c(uc{iP?XT!&f=X zJ;Zdlrx?D+;U7A@#o^~24#V+yT>SQKb_P0J@9=&OALuaGn&myoVXifk^IR}|qr+T- zCg)l+{3VCK=`cff)A?_Qf9vpH9M0?9n*Jb%p;MTAg2RV8e2T-19PV`Ze23rVFl=kH z|5b+{ahSO@rt_S`8mg7#P)JQ@FNa4t3{%;3raOGB!>2gB%Hazgey_vp9sY>JpLY1m z4u9L>A2|#q-0Jqf4&#-;1P$>C;)&vN)8hu`ZklsvQZVTV8I@E0BahQohy zxJIu%W@nhg`dzyu*DuK>e1yZtIeekRtnO_#_jULHhnpNe#^FT{cR754!|!qU0}kKi z@cj-y;_#CW|H5I`Ke0OZb$D-w8y!B-;TaAe=kTcxFL8La!xuSxg~Pve_yvdesx8-Z zro+n}zSiN7I2`8E$NS;EPX3U?k2?GlhkxtvpB)~gXPUL!IEQCAJkQ}34!_6Y4?6q> zhkxYoZykOStb0lbz01$IJ%m#pk_vl)qutIDCi0UjWB)za&gv#uwjmI-4DS%Hf|o{3~#@^PI5RsnB@A{tdme4xXJfMXpF6DIGI%KJvAGtc4E9By~`EO4~5 zLfGuQ-N`R=c%8%l;qa%xu@7%@@~;SE^I6sHQRLbPkAtKB7AOCOlmD-izv$%EqS%?8 zJUH4Jl@4Fx@OvEopu=~AV;$~y@~;bX?2MDY=X9O~>v#x1 zaq{OJX8db5`#C%m9P7WY!^b(DGaNqK;maNVu*3i9@cj;d)8Qu^{!+aC4I^XZ`*ByS;;U78tti!){nC}2)^G^;#$u>F6A;Wt(JlJ7K+NOhBD#Hgk z%r_{L^G;#-c!w7_-0m>%^QOPXVYuEVzue&uIDC`CA99#?6Uz&U+weUOf5qVk9Oga6 z^dEQlCl3G2;XgV2SBK$$o1Hxz=KaOwjSj;OH~H%vhQe*~V;!FFFzc0=&KV9bba=VL z9S*N?_-ziu6*rq#IefjtH#+o^#Nq#P_;H7ycKBxw|H9$t z9mW}$l?%(=aNgnF9p2MnnD3@P#^D1TKGOz`~&=CMLw1!J3cZSV-;eIgzs zOut3Wca+f)Hwp6&j-2t~K@lG%JT2m5gl9y2obWLb&lR2*G56XxN6c7}K8(%qT{mLx zyGtYH8*N9#mk6H|G56q$BIX|a&WQQ$az(_9-`*cF-(c29%s6Ue#N3Z>jhJsUACLHp z!nWqlmxVV)Ip1sVkN8R9ha&#D@FNj(pMEsrUkNi6lVjxDEmKOtF9`on#D5n4O~e&C zhyNS#0O3DJJVKZm&g5lsg*aLPbIg89P`od;3Y??R{HDAg8=sf3ua@b1isw0YN$p%^eC6|tX!TKmPau8t}d!N zKn#|)R&j6dRy9<;WZ2`d&E9pwmPasoUiN<7L;bFfd74mCcu@8plpgl_YcqSd2xD)8 zHo}jGs4rTlRh%@o+vDE!>PIHYbjd83-dz%K9xb#14%R49Ds`9kzp!=ii~-eGimEko@Q4k`HM#s1*Y+Q= zA>H_&f4yS#MKxRU*ZjEb6MCEVfOHP<%*=JTJ-^Hwm1gVl6yveptUcJ|pU_F8Kj?qj zr%L@xeIN`DOl;N-z0kK2nEW^2^MNWS{$$Y<`)8i{$Z)qvGN`SkC3|lQHwl z99EqPzL*R7A7gBn{WAYTX3a121F~y=nIYesUuHf(m|y1i>r|Ov=HIHORj;Eq{qvs% zPXib8KO=AS%RHZ29)^5Ko}Xn(ewnLPaLF$-gRh?aGBc~S0M1cF+r z<+@OjzRhPRRo4S+^RubP2aXmlq~@2IVSULj zGw*>hQd|5&Ii*nick=Y;mzj4FEdvw^E#67R%r7$|?4JEH-%X17W&S4Rm|x~PYVhu0 zZ9=h=6!Xixs!9>_%X};m^UJ)NJnK?i{x%gWNio07oNFxugxB<=i!DU1Pmj}Xc5w)% z%`Y=Qt(W{Ve+jjl(%0)bxTSa|kqyB#%K&kv`kbSGyX==aoVDneIh?f~{4#IktbMMb zeAc30W=6kN(J%9lz|k-BC#ckYMU4*{^Za6Kewk0>&|iXI=KrDG=$H9W^7i1Dc>(2a zrf$dQ-wKX?nXjb|(J%8_>Ja@h^L41|8T5DAFY{lO{h!e{W9ajzT}rV+%?QE z^HCgdedw^c;^Ac3xnJh*qGo=XcjuBZzsyZUnxbFk%TU{{U*;oqHcEb(`2eD2fWp1M z$QL3l1H?(l6|dyPo)S`Oi+mH<+As5D6zsy&oy)b<)*!i6Pm;5qcgi-U$ z`~r10zs$!FF~7`LQxWsa{2v%FzswhrVt$#=BE|eNpG)M`^2@vzu7s;^qh$yiwWaI% zF*x(Zd{{SM%!hqZSJ-f=3<>my@NClfJsH{|w}a^s7)j^sqc#eTnOVYp7-OCENUWS8 zRLAg@pNO@5R9GZp#E}xLmEcJ!OBft8*KLsSnoKJQlD+uMQXOvNH!F?7P`aL_-Ge*j zc~t8H$wr21%?tIITYsA*w@Rn(P63=U4-e~843FzmG(1cX`C!U4^~}TaQwVMjf`;Jc z{+58Fhh=IRJuKJjTvZIe5&{2ot)8a;``)jktZ1OfOgxH@!LPYd)(gi=USPtnH85*H zw-poi*189ADG8QAV9klR%mmS)ZUF_og6>mZqrt5@fnuF4t)PD4mV$_mlqZIDIz~F% zGFGoFNw#{#u6a*R4j&xq7ME2}A0Zr|P4m^+ak+J$!!3b#dyIl}draz@AezU{vd_DT z1OnII4()UKd|I0-z>c?t?iJ8`cA{<@tSQyoos#ux zPXPaiO?i(K+_#!U9$vj$b>eK=xK2cA+PKbpX=1tVLNB#1a>t+G0A#pYzI@C#$ zlBeS^!5d9n4p(=ZYu;uu^LD2$|6@E3?`&!^6Ol@uTzht) z$PCS0bvC@s+~n>vjk77n;lo~ZxBPdUX#7gK7hbkvA6^wV}@|3~}%> zZ3J|{yd5B4tqrOcc!Rczh&O6aU}i5vGu~`Svk@0|{^e%&b~{o3g1&y~G#2=cX0S!H zCr(GQK>T$vLT6&0>`Y74p7hyU#TRZBKTmP%eB{4ytMnxM+2`fC_GRc4R+4ymo_(_i zQ}=nXRBvbge8VRKe&|xrt6OQ#D;Kx z=r!NCYJ+dm4s<$&A8IrFQ-_~-_^%EZbi+3N!4B`^@MwppJA918aI4G?{3XLzISkj; zu8WIEq+_=gVv)ZynG=ILvB`#3z<;Rc5%Iefgsr#igY;Vy^QI()mspLdvF zN3A|TbhuVG5tG9~F$_1;@DzvnfNJtN4)fcb$(K63#^HZ+7*3h#Z*cfFhd<{qANEZj z{+HojI{YVxYjvYFojn{L;qZ8eU-ONt3sK=U-?&*j{JS2g)_*?k@GIpT_e4GL?U{0l zusx4fBG*R1n}Okr!12ENZYRG9tm~QZL1FCZGDtq=^gr$N?{@kRI{cKw&w*oEVGduk z&s=nS-t8f5b=wOZ^+$oD{sf1QaylnDywKs54qxCfi_)9@k2uURTf6B}E@7%-azFQF zxRWwzQW-!#^9d<;~Z;e z#yVD?FY*kE?f-RQc(sJ@MNHp#B4UO{%)LN|F(l6~uzuA@{v0u5r5eeQj}V4~18x+C z(*PDFF&P;#?Pq-UgM=qU`H{lR!$AKi;UgnHNqBa|j1}iZ%((ZYh|d>3J>m<67e-8* zt%#U$C2R%kUoCuI#2bV!jQD2ZOC$cUFysaF?-VB3oG_0I$fZN@W5{~NP0leJp62k; z4$pJ=42PFGe2&8xJ4_!i`|BOP)nSgobOd)P)JaRHxf_R<V*Ndto8Rb%*mCJSH?cFAOb&^@Iw6zj= zdr3p~E{nasF%7%dX|p_n$wRVtWe>-3wbH!3dfA(zjM(cR)3A4oHtbE%MmSxG8>%wQ zf6~})k9*Vmi{9I(OJ>3J?vjA>XyNcZca6h)w)E&{7O+RSUzJSfEX<85yic|#j>|aGVF10CJlSsv+ddtOb%D#Q-B!E9(&jPN!=i|pM+f3 z*ub8eH1tJpZ_{A?Oe?tsvp0Uq!~^SG*cpd+>g0naWa?-1KL5zsuTN96M0=dxtxc}3 zQ)#LM*FH~~t^K7Q^zX^j_xAtJy%P%Gx~<}#%7=0%zh%hYr(1UW!*HBymh;f2+vC$VDlOy99v{9fWVOrc zY4Q_wG1Hd%pZ-)J#q-JOnItSCL{gbg`yI7Hu3aal;;58cj<~gB6ce}hK4NJt?`GoG zG6hcD+Rq@Yt!dV-YO1nU=5@IwRX-<7VF~a%g1P?hL@!s>TPjsAC~IyMk{pwz>n*pJf0ZEr3`QfjmMJ&6 zV|fteM0_N2+~bOfs3@>ta@ zVE7&<$Cu!>yYT{AHJdu?JLGVbjw6ywliEGBKSfI6K;-!Hi^Ag8LJrJYY#uPl|0flQ z+}d-na02J5HopmcA~QsBe2Jx6rrohcll^jcDzbaO9F5awvFwOj`=oH5(_YmDO!8b4 zRjW9tob1pu27F(tFkZ)~_QjM#FvcsVKqS|eYH1h$yBw)4US5tAiXWxU#&{h`0q3XC z$BIQ(2&yv1>o3V;jMqEKb8-3~QY$&W+8h; zgYjB{=^Ij(u-RPvDJeIGHu!N7Wiej2$iSB3;Y2nB(=cBDThTsDzZ2v2R8=8!d>L9j zb9~t#OVRNqur|LJ<$PwIa3TL$s`gp1IljDG_WI{nOJa=IVH9`|r)fz3kI3((SJmbD z-c|MGcc{$z{5#OO@6*DK`R8cK2Yw(tCeKX*Zb=$=)5#NdI8Go}%<(xciL^ zI4SZ$u*7&}*0dO}TueB=q<8hpVRL|{b_K_mAHe{NOo{OdPKtZVv>2~Ms*5v;G=)b? zp|}pUBhm%Z>Yvmet{tl&#p=qflf-g-`6n!%L@iEE!yUQ!3C@!-Ugzsj#dsy9wn!fk z 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

  • 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 T7wt`7^!hGSX3TrcnZEx5G`Yi+ literal 0 HcmV?d00001 diff --git a/components/newlib/lib/libc_rom.a b/components/newlib/lib/libc_rom.a new file mode 100644 index 0000000000000000000000000000000000000000..e79ed8a92615942a5609684ff3f3df644665cadf GIT binary patch literal 4870926 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
    Q0r z+;+%YjWgx3KZ?BDftiNwoo);Y&u4`=#?kNeXW=^rop6pY`8e`D0MGjhHr z?rC_z4Brbrb$i3O-H6lm@)ukO>zCKTxv*Tv^T1l(F34lM5+`v#1VPJ-VE`c?$Y|%==#=@J{6M?1u~+^9uMXL1e$C4Ccl9W?Pg#1c>!br(h2ixl~lof|URM{LedmU^L2kd#ca{1-?la2WV4~z4!?Dt~ST-k7U z!B)eq5X0Vdb-%wo52GMM_B2$H9aB#t3MQkhsWgR@87CVKEBW+-1 z&nHM5PZ96H$4yZgPLsgVD>y4}J#Zwl3CH3qLCWh*=_PC&!O+WajM_HQJ0kjSI+ zp|)fNCAliPnc1 z5|oKcCB3e|s!1M<--BL^1r@*kbo?MLnv`e)<@e4O2vKx=F%8Ueo@|4`^2zdB7(vI! zd7eeC@eoRDA$|=$&)kXQ2VNTauU+oIceu*xty{3@YK3aL-Yr>#>k%Wl`oQ%Ft~u~n zXpd1v31fSpa)KbE&1JX9(R+q=cddpL+iaZ`g0d{OjD##QzDLo8{+lcCy^bX;gH;sU zgDoJhF0){AxN2}H@auf?Fas-5>BYgb-r8R{WbJNN1>vrug00EcaQ)`LRXxgaoQ`LV zC!rJdDCz7)JWD_8uW%VKDSVB>HxQ$4>9)hm zyZb)^OF8dT_+er@mKgJxqH``M{6AOtb%oz0_IdTixF-DE%_(?1v2QcwijJgV+1Ng$ zoS09ASnEIVig-}{#Mj8<%kwQ@(N8??G20;DV@T)p^amcZP5#(p7M0ga9!#LjFFj^E z{k6xOWYPUs>naverZ2zE;1CXFOassQp<{pN^@wBL(s2q)Tn$gR6Zd>H&g^GQ&p4(l z_hFG&jqoUVaUw5QZ}BYTtpF3{v7SX9%R~93(bc+Bcw`*iOn5d!;j0IhyZ}QyA6U|m zPQGyj-btF{5hkwo^l^BhTLjGVag1UduXiQ9mUkt>$0~xrQ$g4A+98i`2$TmH%H#D( z8bI^U2>gt|JBiEHTX4(SNMXWR_}YPWzJI~|pb|9Z%ks;0Tna2{01f^#&Xf^&CvjU4 z*77Ez!;J=w^7w8i@@@o{G=S!pkoN|GcM^9U!dl)^$ZH0T^7yI4a-jVJ=|z+ zi@Xe3_&g7wEe;3T~ufWH4CQjmZgP^bDL0kvx zm)CJ1y~V#l9^1V*k@rIow7e%EPx{A!^cHi_@m>;PIEy@8W&H!EBiIaEat`f zW?Pg#1ZX;Ov9k!g6M6RY+wcnw{6nMt2gm(?qcPQfsZj=ZaJ|Kwz7XvD?49Zxjl1*i zy(9Q;{#L7>nAG#Y-()0^TJ#fd6H^@Y6Kto!%Q#%jFdP}_po%yd7YJp-K%Vlj`IV
    h*XjE6OJ9x$Q3viP>)c^=Ux88a{%dB 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�N4cVb`Sk&53-l*61_aDr~mZ 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Μ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

    Tot;*;ll$N`NgN?K0ovDLuEG6w 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

    uMSMu2Lp4zZ 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⩔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

    vUjAU`|v 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 z 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 z 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≺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

    =-Y3dKu;(8trz36dThTn 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 z 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

    hyuaxD!OwVOs?i1#(^g1fPFgQs)At}S9?HwBH zhWlTsy2*W-cl7^)C_!6<8=`QZqH{&=Q*@Q2_TNJ02uTs)$&mT=@c$cTEX6vCRNDjw z9{$l^>GSHtxv5pkCJgwBDw~^%F3Mmf2jb#8H#Pbz#Uv>go+~V_;;(c%{z})82>wcs zMVkffP5hP4pemnLVh|vA9C@Q8A@x^!Jj4c)!Cz@eepJap_z};A*@`LEsQfr>mIhDNMwxUHwS7D3V*}6WYl_ZTQv}8pL@1*)7_(55!5y0FSlZgt z(rHc7;~yXDvMjh31y9i?uck!PT^4wTHchsoYf)0mw27Hx+DrQr9Hgi!g~Jq$PNB6; za5yUF5N^`{zi2B-&RJ75YfTaOQ1O>0H=Ym(9QM(k5Q^!K(|CwBJdF}lS^S3*Q!VJk zvF}w2hG6G|eCqr&ZMo#!*A-E3L=aP3k*(DPLuvgXAk94|pL>qwYSJ$mgre}zA62k$ zlw7m-i@> z+;SvHV=Q$Gs(($!SrozBW{K#%LT*3(7et4j@D~NgoK~uT;E}eO=*TpOqZNUkx)kNV zlS@(dBEjhncXThB)~mP51&67s3zSQG^bP;)r=zP;+=E&jaWb0nr)3M`@uhTXn&!^y z(NlOJN3$E6a^~Id%@pRMd%@rX@$J%@>*$1QUP~QrKBFH=bvW!%<1_fml;&D+vKjqSnrqGIfp7<>kf6Uv%S-e9}dm@^lh9Tew+*V1=Td(J$$Mh(n8N_4?Z za_S~H`gHx9x)8M`Xks@eN=%9FK+zdI5fd0NgL&OCRNLX&C{&bL-@>hutjj|(!38cXs zBXkC^1nA&>6hmixZuMt4Nq`4zb#4$Q3p!)X62+9Y0VVXmJGY@Uh=roRLmk83cJPXs z!0y*6O$V_+J`*|uod%u6Oy@8iNYpHCY+lybe5eK@OBXI`Oi>5N>P`od4rh9Yblx0S zrULsh-9$Psek|b~1};eRCq>M~x;SDk%8S4VQ()oQe1S4GG&<8lqvH<+nOhX^r(*(h zAu=ZiGpRcwVlJ|CBjy6CjhHzrOI+}CgBckyHxy5CnD$|54mvkBrsQCoU4v;WHZW~PcsqQJa?{$QCn~=^v;$8Rg=e)He#v3ZnbEg9 z%)+tJ`#VgZF#5p`Pjh&Wzfd)#!X7=*v>o>7iKgwaM^7|uhrgzt=>H{up|qaqiL%yf zm|MJIub;|z!|05Q3?J<9Sce&l7!P9-!^b+zgvRJ+JA9tQjSeqxxXoe4Lnh}EhgUiL zA&0$hPsTG=_I8Kwa`>|j-|z5)4l}MZIbU=5afdfM%(%$-pK^Gs!!J7g3x|K@@b4Xd z!(qltCclrvgB|AehVk&y#xSoi4C6A$FfVNk&vy7shne&l5AT%?w>!Mt;maMq+Tk@0 z-|8@LWliSi9saVz|L*W6hyTmrCmqH(-DJM(@HU74$6<7SjQ`IL7ijEhbS)-l7{@$D zXMAcH7fFUkIXuSUBOE@;;gcN3hos5jy|m%^4)4ql=La3nr4HjW%H&+6-IgdL04Tqm_m^bRizt!QF9R7vFVcgE20`r!f@(7jMOb*`@Hu?{R zQ8*)@aRDwArayq07rquTbJ#Z`Ms|tv;n`cbZ^Z8r-X~&S(xO!e&k*6E5g#Z#GU7vo z`NTLpsMmj`$d16ye}!t~V>Y#N6jLN6cLCI}tO_csk+&orfPqTqOKr#3=v#JYrr@zZx-fj^9Siyz-5RnSWzL zMSYlGmPO2cv3JCW3RgyanDG7)A1+)KF>}%bBd!)UKcdV{&5!6DVe=#Ue&MN+-{!4v z)dqupWBr+DuHh3Lp5t(>!}JN`U*Yf-4&UG~&rRdM+u;Ws-smvTKI4DdVa~VFUv-#g znbFJCMuu@wWSH}3m~&=$io-J;mdI{}Dsib;Sg@qPByE*|7>Z(yE<3n7rppHAZ4)R@ zUWGQsMP44~!xljWvv=*IBCdw0Fk12+S3z|8)kQLS)CYOc2=|k4!IIoB%Czl@Z-#iR z3}PNoVk962J6`TN{&-(MpnEnd+*==^A~D#$PE*>;n>t9>weHy*Z;zNq`_*f+GJ?rk z*@`eGuwZbh2!_cUufl)S^=!fN7K`BbTRB1s^&+re_D3G^mD;R~U~;eq#8rS8EN`XK zUf%0Ek;6qp9?uGsw^rE72qq^<-ZVQoF7IYxFK<5$vbnb+uW!twes^j^-gs?<>-Lfz z5f7>u$Ya|OW8?cTJ&>kF9wOs=Sh&>D%lAuPR2T_9!Z)=UCVi~<-098oxZnHZxOa5g zt{ex?M{AdGKTz7j$&xqI?Z6<<2`}%9k_R91c*dGMmMvYgCLitJJsXvaBnWxCvQgPA zhN;?z1*@OD<ykRP?9~fO znsW;aSCu4p=LS4@?MEK%kz2gE@9L=w%dtv%YWZzF4|#A^Nv>kxRq9K!NV%;@sY4!Y z`E6}e-)#@dE@QqdQfh0LEWd64o65aK%2h*?RpnTud|6M`io0shTyxQHXFmC8MbDY@ zUTE(3v7U36O7jGoJl&L9 zqO#&UAeNQRMdWa?N1Kwt%8fQ9Qhv$Xl>7$1KSD`uN=}pL&Nd|s{-R9@^O~L8lyK+B zY)W24XtXKW1~!`#3^JlkNh{*arsOmoe`Zs{B&gS=`ZJr71IQh>Sd^reCeoleo&PKwGOhaPQ8X6P)LP07b}&}LJD z+k3MqSxMQWD7#;I4YiCmCI1cGY)Y7qXEr6gfH9jA(KDNp!zp1lC9H7o+@^#vui2D@ z7K=6|8>m3EDPi7hHYLn)cgLorS#r##fMV5@u7v%qFubIhaHz zo03(ke79{%iaCU6Q?it*b>Ta;o!v*9lAi1^+LZh^^k`FZ3v!}O$;I$Qo08XQ$!Jru z9r?TAJM}BbkG@lXOxZ4MN>Cy&o03W3Xj8&m(`-tvr4G?|D)Y|bpKzfyCi@Vf3!i$6 z?4jcOh9q>U$zw2}TV@aK`rT+#vY5k)HYL}pj+sqKxR%YPgo%GXUEr8?P^RBM-+P07LR-)u_o>yi0Ry-vH!Y)VQHYBnVwrOf=?O&UTDtUQ~9 z*_7}SFS9AR2mxkO!gM*aDPc^N*_5!5@y^+lOwb{f+|I%PfdN3YDOsTg%w1ij+7kva z#m`-hP05i;4xATqqfH6Z_T1GYL|>u}o099XDS4DcuqpX4^0{!ZDfwp@&r@R1JPFU; zK;9PeTASu4xf{v-CCOk@5|Sgdvq9K;rn&4}y{MB-$^Hw)P_iCrHjK%w+e-tO!K%+D zDt@ENRRu4wn?l8B4-6IG#2#~VhU8RosQ8EW6nH`BZdmXEJ1qEs9Tt7S4u`pP3=U(1 z<;sYK5*oe1?y+L|i>+9kx7XhIo;`8z0?lVSdwZ3git`0KC~vj`^I*A#b-7h8xt~@Y z^PXad<~_v@bDm;{=fxeAWF=?2lCyouyk}X8F9;=1CpuqSYBK{`sI5RYGsNH5CYzZbDtaM>`C6SWLI}EK z!<1b0=q<=BR3;xpj3i|zLG*;S!sLUw^?;wIbRy&hdS39kB89+vrz^B!m_f{3HJ6-C zM2)11zI{D_qN3Ze3W^W{l^Cn7Bv}zmS-_LD$)<;ho1_-{n~%g|J-zDeHOpT;9HgKwFK{#vu_?3k*z%*&lRb&bCa6^dG_{ z`u8pI1*LPzIbTt4-|smhhJb)o+H_)wV3hgQ9ODFw6au?u?5z$-#N4c7 zzZ)n9-KrFd!asjDg98uLK^7!mL&P3~mcM~P%U|f0xGQUx>*S%hBG{6=J$5Vw9c)p$ zZ^4pTyvS+bCbu&Hf+Q_#`wXgHGDhAeN8`^Sa#asw%nEJ+&LL%KZ@cIIohrG8$zr;fgKRo+X( zlWcoagDjz1=T~KphP^M}nx*wi<#0Iq9v1t8MN8$bwgxZ6-tTcD8WurEey! zCOXlLrZCOzH4Q83g70cslho9=T#(iiV=T1w8cZ%>@PRyefAI<p4(uwMLRXL zG}W~(T`c$1bt{5*=-}pEouR2o?9qm+#(c4h%DGv*sGVM&T2w`QGa8(}pL+TZ#xrIs z6As)QI%i(KIb-q#jbGlH;L^S3^iy=jCLJuaqQP5iI_H(KGKKh%Quaq&~Q6ScMCktl2GF%jfO2h>CzoN3IY;WG^E!d>cv%$PWBCXewS%BYcR>HlYE8`SBEV6rF{uvl#n2icOG*=l& z+Jp2F==usnv{kB$_EtPTVy;ML$I!X*)<6{v&u9)d9JXa`wCgK+q{~}_pj8`LO za;ew-fuG|&FkrMeYVa?6O}?XVls4J6o~&==Tp z+mXeWJrN9iHp(0*9A4 zywc$f4x^uE@*j72k8g5atO_VRSo`pOL&FC-JjdZ$hgUd!g~Pm2H96}X#uuT{A8>f1 z!@L+Zo;MukHIUJ@NSxu(4o`8Im+Hp9$L1tG*L!SE(ssC7!{MAZ!fJ3FDBa@d_c=O_ z&+OUvWnp{vearE0b^Nb5{@*&hcaQwOhB-_#S{C9ZKZU;9?B2+<#N>QSZEJLts%Sd`=LK9S{IiIe5~899o%!IOB1Rv!RJ73U!i*uo zym4ed;K9O-C&AqR21m?`Kh6vEvBHN$%-n_Z0-d=F=K>t&fDv}wyBK~*bZ$$hx;crLGz4QAKKQ7Fe z89CfXpO1Kp@JkVYSNN5PpA!C`h`Fc!A>tQ=w@3Vwt*S`XKDFIgu?8?VvU!@T@V6YNX*Rhetc?ZB9}NyZ)~di$rv=GbwY$iXtAM7+f9G zl>?=QBaHeb<;mmP=lb;WrYdbKmx6(hm}}b0!_H)`3L;P4B9q58jyz}to`XJEl5r9B z-WA^r@mLw;oT5ZEAO`A0I7XYV-!&SXT_GCvD~)*^?-|;>Jf5B7G#<2Id8dis=2qs_F68Fy?!Qj$Pe0Qqw{juLr&iED!`~Bipc!LP+m;Kp(uXJSu zlQT6)tpdbg@>VMC<#pH2WI6Ke`br`q<%b)tbTXKGUF8!Zq-`Zsl_Sg zA9-vWVr+c>y>IvIOb%3Mo}#iAtbX4V!7zF67oWdAERXxEZEAs&lhqP5Q}Vd3k-@%bZ~CH__d_up zE}8|aUuI{rba9)^Om_J#lu6@{m{=9UuD^wH3X>&Of@>c;lR@!oN|S@F#m5Tn=3^e$ ze(BNj-2IPl-MF#x(anF}c-`fzPD}=@UDZQQcmFH{4EpxYzTI(%@>2VYs-RlMv5S&B zPX9R?gvkg2Mnc}sf+3CUEDlyP$j;)Z5S6VC#Nrc4>DwJ4D&+z#EGqtVh)QQeEGp$m zS5!1jw4x$L3(`3LNJw0#|6(X5>-AS~?F#)9s6lSsGx{%;F69WwxmjgP8LAi@CUWLq*cQL|=TMK5nlnb^Ka;zuaCW)%!(t!P1U8 zeq|l?1ACO`PFH8`*;%hI^srvkDVaqSjxw)>28n}^A{o&TZ3S{5MLbNK)ZeOTr4aPk zP$nTgiy%8~VES^2Hm+Hk#AFMG@QVHml27P=x0J8in)Uwpt-b2^?`ieAyk%))Q+PYW zh19^kL9byXUEe&{ahY;aIK<-cUwEKt-&`DYa0-L=%_ZSK)wQ{#N2TOMAGcDnDJd)t z-d|N*+B6*$Wir(OzA&ACnXDJfo!%!?CEh2ewcOoz+(DZq{B_u2mI!b5!(Y0KQ~`uK zy|p&pmA}+*`gW{OzMAa13k4Ie+LPCy$dp0;rtj9R{}ZbhWx?L9)AQ*-#00JgyBdZH z+f@^uZtwE%F8@_N#oVzK|9|(+xssEd1?kjf7|`*{%A|R7oDYRzl;P9;(??1qF;>vf zB?Nko`9)0c4;^nZ@tO|2=Hrn2a%Jp_+?RP*%FX@2h^?2t9q&Q8|95zo$>2bNagWV8 z8KW825GtE%`8C-g(989wFixBC^X}R3Q4Y^=_+*D!hcN!L9jFdKYbc*#9?(YTE@F6;!($vi z%;6&(4(EtJ1^Sj93%%H6l4sc0jl(cHhhZ2whP|B6iEi@0D9oA#;j7xf^iA3dOqKpC zV)nBoVw&;Ei0P}(M@%1iIb!1ixWnTeW=?H9g53&L;>u}@ zO&rG7w4nvV41dAZG2{1|qf$S{S(GP_bmw{g6w$a3STK1Ux0lCvZikD8JlfghG1f;u zG(tlfW&h+6j?~6^*cIOl@mLu_SpYJV$OraII7S<|S{q@cgrA_8`n~BqU->`RX2JG# znh0LrV##BT26+tB$)o-1wOJX#WSJ7H0Wnw}(+I<46{t_16nTg&Z?Ul7?>g;lg=p-T z{n>t*3RoGzgth4^Kn#|*QfV)*QXPJ{Xvkv{Wb)PuTN%NmWhe4(j%BK0QkWun*3Mj~ zChuNhFK@Nv{h9(XSl(Sq`}(bvJUd=34P^4ZC`=iyAHv1zIIJ^S0J1$6W8-^9!lxNi z%!6;UHu{By{foO^H~5hl;I}YKeCi5Wu)JqP@yGFd9S7%&cJ}l9Unp&51e0?lkM^@* zc|R4w%PZ22+uFH*%tJoUKD&kllRG5ubwCUzk65Q53%BV8QY|9SMQdlyAAQ@)ds>Y& zI4hN}d$w+{VqV+AZuqB|H2$#3-CZ}>j{{RBxR-FX@28a)tr=95Z7N7^>XBS~$4w_C z>zW5#bM2b<-uBCtYd2mcE~Q4v7uFfGwvQ>>mEQ*LdA4q_6|7DFxiEI%B3~H@>CF*n z>jqpf1y8b!QdCrmnPgEx=_{miGK3&1n@g&oxPnxfP6bivaYRMM%R^K;jJ%@KXO${0 zx*S@r?EH|pLH{LCN*C#`aP(;X6T&@uU0M5tBzO45DJdzFs(bG6Yn9?jT-K@t?A&I0 zNJ&1)O(l7cHl4G6xe>khE-&mopf{8LzUq$!!;|vzqst4`l?(St3Ztc<>JsTX(qdaa zC`p$ON_Vn+puM}r1Ig~uaq%EjflEe<1VokE_-@jQWazNmdPb{N+DcLiL!K<8g=Xgq zwYx%GSh9E{s?t^>clVOmMfo{azEliVOT=UQ%m^wU0v#W2tkJBL7BAor=OBD>J8-hw z^m0l&4@6ij;L@ugc}dB)upF_tZPEEV+E0yHHt7ho!pF^TXxK4#+@!Hn#vV4#79!r- zbbDt@8sQp`YZ{G>P4m(P32arI#6W z(rmhKBty0FtkJa-XjO{!7!CA;6?3Vg(H@mUYOMMMsBp-Cw?dp^JSn$I&U!1{QYwwu8^* zQ5mj4V^=DFQ-W9+Y!$L>rTxf8 zci9?37&k;ZW3!yfzGVJJle`K4>CN>;S(HwpTlQ3e4fLN4qxDKo5L46%$Ujc zdyB)jgJb$aLBuVNSBeVd+>$|%owz9#GIP_Bj$>%ig+Jk-h{zlB|JXj;lh(5 z=2|0IeYhhS-p^sm7=66MQymU{JNB_TjxN}(P$e!^tHTQJqX&?w=w4fW%^S^c1Sd8?Iv zQJV$JJ5~fQ?_SA6mjrp-@l9T6b1STPv3M?ZX_Gf!G{a>7N{R1v!AE=f{l2KjiS3tL zp6!tsz6&4TfLRs{c~eL#Fuj7c$kgh#X)CcRC3 zwSX8bk2Mf~9ADIN)QZM&=>2ZiE}ho|PSO2jlkzQ?JYqFj7AmQ%h>XR!H?uG9L7mqG zD%G#pp9PaQPCh8dr<45fzbl`WlMWp}c}n2iwJyQbPik+4`89#6@N`X*p&~!AdGqEf ztIRtXPo7pVv~J?Wx^ZI)C+=M`z3$Lib))O+#ThLKaIZ#(pkArnt2 zzbr|%mL;Dl_{{XpU%F|?#EQp`=yB0&EKCd?GVYYZBW6_;{(sD!349ery7s%z(mCWD zNFaw0NPu%f7M1`ZEI~vkMhKvQA%uX411E$4%4PxrDvN*tl^I#Y6(xcSZX+VDBMO2+ z9UPadjymEn4vxEnj^j9r{|P z3Sv10vFw6aVL_}v%jpttakOuVW%U?R5Vp$p|8Z^GiY|>CqJ7u(+ne7f`qaaf(VSyr zTc4jcv7#)NQx?s>IgmcCES7!kn!B$`d$xWZ;@%bQ-QkcM{n`$7S9uUmX0-pH%*3zR`YTmnpZw}p%ckd4^OFY&YKBVA^ACQtB<;6%w ztnY`{d+IK>hMhU~AfVV9HaIh{|9D_uYgqq4^#M;^Z>wRxy&aN1R^B7y!%vlZDw3YV(w4DLgU_advR^3c{(pBTbOX{Yh@RZfhrL-Ql`j^$u1UFm+4wuze zk*7mp2B2=3)o_7bRzHivp%BgiIE$^i3J7bdunVEumetQAZ-v4ofRfX#5_GgKt6xCv zj{%Fg`?%FG+>T)$?J=d5u|ns2E5F}LXMdv=O5d3oY1rF{8PSJjTw4~+A9i2D!X9?s zkg{l>bHiLWfy?@j*~rKM8zg6Sz}??k#p zGS7EP{%KoV$5;)#4_VE_4)+(2u|mG$F?R8o(uVICQNcmqu*&qZ`n2L`e&Jn#h1s5h z`mAEaH3Ww{!RLgmj8#a;^vcxc#>zHXb*O2YizoO)sc(MJ1DTxndc*zdSgty^5Y`b* z;av#}vvDlO{%{{kcsHMukAt4h-Ob`3?kkJ-FDthiavKZp3KrL=EzFY18}6%&_Mho1 zi8P*DIIOZm##R6IV`%$R$KaGKK?a^%sEwYS?g>6TP7d~ka*D@{F0NlRB{Nby=DZED z!jgGE9cH*Mv9l}I-2OsO7{uHW;W4~>U-Ot7bx#eJXBKAKU9W?%yFlwoSHqJ;73PVA(cjj29 zq}H}BOgtP4B{*K|vfaCa)|Bn*c1^U>7aqLvZz125h3ksPTcezi({LFcs9JV?sbwe# z+elWtj3HU6_huB`ySM(1=qvA>9r8E)9p?*5A-}70IB~WgDJZ!J`Sm}29#Tv2G&n|G z6J@bN*M1!eWZ~U`g*hw?=DL{RXIZ_f(k-jHpjDzES64P1FH3dLb2IS-CzO*=*>de& zHTC&5IF)10!>Q!;QJT}zU;N;*qRixwZ$rKP%7~3cMe{4ltAZgH7OtylXO)(p zg?QXZ#+_*JTE+WH58aSZnJ^g1%`M(Hx@=!*(YU>{Tb8~W4f*R5c;Th48l>(RxaiMF z2>C-DXZuIl4H$==I6JYXb!jLuls@mijZ;=PY;KgY>rZ>@U*d5QO=ZH?xvcs{W8#mLrJ&emx5))(!q zvFy9A>Ehnaa9c}0v>YYrD^pNWlD>)#s(7aW_qLjY#}@Y9eeA>5HPM`p(?0pICYp`B zNnf~YhV_0drzVyS%XhENh@0wgC|)LErs9@fw9&fssXuI}ufOGz#eq=n;xw4Lc1_Je zPYn!2vuh68F!M7uCU%F74bg#5y}h-5^S!h&EN;W++DKohOmvJV!#yIm+%p{=a+HnJ zaz6IdY`Rgg2RVHc@nQ(6Hl5-*xlFsWWIN32V0d5$EN4*L2e(b zZap*YqUn{foJ#lfRpazksw1oWne?=QjS+!jgg@N+?X-7ZFOFuv7RxCCcmeO2ly zk3<#MBq31l`yDc)11h8aHbnbRDIR;y&9Jc{)<3m8(14qHX0%^%bU;z%-n&!Z%J4-k ztAro>^Ah4GHFDBP{gFrpwQ!HFTVQ%t1JkFDuL|kIA*SQzo&DEUp1SuMGmCR#Z>L)*x@O{NXY1*UfPQ+I-?+4Ux(VWySo_I0ayHDFK z!L#$)O(Fnp_r=lvxZhv#RsH~9e%8v4$MUT{RsrT_>4$Gh1JGM|AV%YyWffx{h9TBa z3y&6fGdfixhHv0g@s2x9t^b)1ouB&`v3~v^kL#!U`yRo|r2E~j-m?-fD11M`U;Ad< z=4?)R%RzMfQIS9M-7W_T@$Yt1u*1KKdxzQQz`-}XQ4Y;GgOn3^0na@6hIc;<;v3$L z$T)n%>jl%^8i>3Fg$U%us~4sW&nDs$vV5Us#7kkppIlFY&;JayUjqAcDe-TIT~C$G z;EvCK&SAI-y7X9J@fkI zI5z)ic6sqx-ha^Cd2Ao@<`BnT0}T1RzlFz1DC?ClnmTSWhP>2frc@CWnKcP+!lyeirrh z%l*Kq+85!()uO04K&7L9~Lu@q^DHFK<1C@{vq4zLMTR&w2EqB`v^Fo|iyL z9Y|-ZB}db*b;fe;emBR;)inM=&WhlSW5RsFH}Kb~*bPY_cslcZ{O`bPkTId%2{v>0TCKV_IT_8ahY4X>f+8Wkol+?NK-%#Z=2j`K)1^nI-+FSMLTiGkpyH1ODD{0#-)VbUHaw`w)Hvf6TEY#{kI{`tYBC2bBDlPgAejJo@YtO3s%tn3yF~Ax5D&; zmUD>q`+kTjK4#IOUSQ9@ON0N$+Hml4Tc>aoD9p(ThuQN ze#2~fn{C+TLC(hD9Em_OA-I-lexLQsq~NbeEP)WXR_?x;NQXaZcr>I@FtNt2w$jp)^9fbY{dsLOl z16J3T$MxqMKdM4DUOFA^;YfSRKM^40MD0tkKdfrME{d&iJ@znvSKKH5w<7sk>sY~&dlxE+6-GZkB5u210nLV297y`by-kbAj3uQ0pf+lT?rpQbzTZL_}HY zOtE*z^;&j`OqkC}P>F@~9` z)VhYbj+t|j^5lm((Al|Ic?O2}bI&a0DGL9AduA)oa4W!*%_>73bOMsh9B9vaL!D0u zUIZukSbURwyoW9?92cxSGCyh z3;5QwHIsogUW-70uHRnMMp*(>d%@b5&BPE%)C_9~mtB6lHkJE2R_Rq8_c7z&+c z8{bqsl6IO3OLZz_J-nSqAdJ0QDYM^O=UkYx*Qotx<3XuY%{0WcQSF}!f9C=w?0V(j zP5)Yk-=zGUQ!CPw`){y$^xpN$mv#O#^2>h6<{5eb`!Ub_E;|hoWuA97s`ShuL(jJC z%;7^Ppf$U57Ik;o$C0iMEn)k1=F!8-_9gUZAo!NLOX_*ma}hf3!s z8Py+sEW&5NpPLVOnu;hG?Q$K9kh^|Kg)EKfOR3Y;OieTNf(c>ZP zI}N(UYTqQDI3{8J=4DP?sp}LN{3VonT#d}2_Pn3b?(vFN+Vpcu{4zpIPyU?J1g-R^ zpHq57EBR1HyW2m01U-&xrEWi`G#pm~(=__$l-6pc+MiQ8pp|a=Ii+qWnT&4F&nZ=D zrT2eMX^mD&P{rdXvS2fmY7t!*rF4O30dmWff~T~B;Xh-b+e_L2i;xJ6%6B?~rLhhQ zu!iOZt?yd_3VB5fgyYR`R;xd1%M# zza3Mg&GiP__1XA4As&#ojCS%-|bqeyPW#f zu+(;TFvyiEY#eApOVJrMVA~^7C~XnN0M_29UJ_G;Zm>yrAohjWUllo(VtZRP8Ege5 zy_N-)l1!)8WToae@wOJWkiTu(TDj=SlM=V(XEHF(N%fRPvT3WWHm$v>ZSCClZhG7K z)qvYHx8rPk?qK*1Imp2DcsE)<)lV9QYgXxiMGrp0cGUf9wU?`O@KCh3vmTABy%FI> zwH@`jIi(Vw*%cu(aIJL_CZLp+s1K+$icz-l;En-QF;Sk&!M{v?*QSL(x-~8Q(OoS3 z(Zh(To)nzUWoc3hb?@!qr>(buZ7!#yT|>DVvYT3>5a1# zmeCoC4XT@$5r(^RI@-kMlT1{p{pEDHpUXXzZ-GbsI^u5xo8KC@(YG-`q+$ztD>nMZ zZ}ibyjjg4%{?26^ee3J-XY58FMaPhFQVea1IE#)Hmv8h@)Rq;1Faj|}y_$((gd(=0 zG}ESN*r{TQIJu0}h7pRMYbHjzDf;WFVv3Go3yB2cXdvPIG14?_P-No~qnVhZ_NR&| z%4{Y^`Y7U}O3jQ=bmpmIirBg-wPA#!(apq2AVqBBklGMaH0@L|MOU0Ers(QsVnj*N z`etI-ricwX&7!1eM>8>uQ1nnUF^o`j;8Zb1ube8T=>1d06n)rCj3_B$%VDzwQsnWS zBBm&@nHWYWYST=NbW;>PRZLO0Q^gbwI#o>3;AUb(NzsUAVnj*NoKwXV&1)ux5sH>H z6T=8aU!E$a2sJ{pi-D4hurdG23E z_!ygQmDBmc$O*@kd>oy>8#&=yB`>G*y^=3jx`n`&VP%xSbr7*C6`d(czQD7EFx8dQ znW^MR1Yw>lr^ClZWrwgqdFC(OLfC{2DW!80wgeu5Q;@NR9%hjWWimy1kSz5x2Zzw+ z&{|jvmR|2kY{V*3Og(RT*qZ@UoC6M+1&8-AAf5BD1yzhX6b0k32}AU%CJ?Kf4v!u) zhvaV|)MA6FOW~|`k;&fX;@xm|xVRI}BQElu(-j+n@y=1?B5U+I7goTC`|3+LXW(Q4 zP0T9*2e9E0iq7lU60!Io&wfUqoGtY81c!{QfKmw5uNr^3SCxl{kqqXl&su+E$(Gf~ z43B&0bh;?4pu_yZp|ctFd~8tPxpWI@IySF$sb>q}BIQBhB(Nb6X{LjvsC5w1TG#iR zrCUfF;`>N9VpHY_zrh9zbofq#_~|^3&5fUQ2%8E(V3Q;Q(0M~)IUOz~?*%0U5Q1}SWr!E>(F93KFam40adM#wD**_6bg^f|s{WF5&bnae8 zpgjz(qqESh19mSXtX5^{d^)TQmA)}ZBh}bcNi|WL0}0^>)DA)$byVZ%uy`vu%d)O+ zb}kdu&Cd7(yD_Pjzxx;wxpnDVReD)hL;Z;pMiWPWpg!<#dN#My$c_K zv&Y45$Vh(dgu*yD{73?1aXqHa=Y@3KQ(HlYHxwu!UiF&`qpUwrHIIcs)(F6KC{9zs z$FW$~xX6-xm5X#(c)iwwQdNq#x$^tq9CVT8@qHIfWF`iWRj`FouxcUG<);Z0UAF)6 zveFk0FA3lya9G%ZZ@^(`1sb!=T!!QMqWj|q&Q?Qe&}Ho+3`8Ny!G@Fh_%cE-Y$!r> z`YN1AXD~LULMV0Rbo8lzT%P*J#Xh+%50-b@_lspFbwJWD{iz^RoA?$YL`{4Y^MLKNEQb$kt z-j(}N0M(4$)&x4;uqo?f09Dv$y-(5wuYdzFAVq+4cux@@velz4ui23pJ1nuv(;A zNQP^{(}JslworeUsie9?^e0C|fJZCO45om8XaLTc(2LsJ|0}U)=-m)FQd**qC`L z@0;wvkA!GzI1ePpTgj9tVW!GVM_F|9L#=s=eau51gHP;BP-pD#ODR$+8`aS$v|F^$ z!X^vKqPC^afj))~)JCqeXt+7jTOFah;%YpcE-THC3MNm=9h zO>+NJYb=vI8SZMbD$kkvrf@h35bzv%bp{&pK<4gc%1r*aSAx;`v2#nA8_rxeKd0?D z-k?5rj@K>o?n<@px%-{1i!n>Wzn_V`6k7jhAx=7A$Lq*~hkfybJ|%M;ub0+O&Pca3 zoT3Y*ri|1!PqN(n(l}Y$O^2J(AIoeMefR2Zr87~T+JEEn^TaP0bqOMwUbl)-q$&(e zCYw~1p=3=V)P$x==AJY^i$DDTZYq57RP1f4B#PqI1%xJcf1EB?HIytQYUyDV@s{e0 zvx0OhS@&XGr1ah59B10bv@#7a}cTaAe_GBd4b@}@bcj)n59bLlWx=vZWY>2 zRUMAn@6nels{mDwyw_i@l5@;wW}b9F_Y-x>NFMik5%DrRcOkvjEPmZDiw&2oFLDgt^gfxN{e=G8F#f< z+7Zgkd!rWSRhI>P9V^S3_Tc%99H>DKB=$0n;`NFG?bEzt2H@Wxjzxs9AXP(?} znM&jjuFSQyl-H9kv+gmt`RCq*+-t_2gxI}8q{NL+Z^`O&%*N?F(>V-^YOYL=29lzx=PB*4>8P+|UDn)vpWa#li{`XT9QQA#b z%@OKnjkrCe>fbs-VQ+stH<;f%Of6B*iveBLsltwe%xVo$>Wj;#bUeJJp?Kll z3#&EPPPNeg4QoI1K^zk^;VGHRd^cMH-7K|TTdSV!(Utn-_15(g=xQZ!vC{WRlN_Pf zvR=7eYr9KFt0#0sJg;UN7DGN|#cU|eMQrYp=3HKzai6?WIv(cLn&oCmYPDjzS+w0O zk>0dYbbP^aEbFY+e4jIyNscdcjaAlTSn8PpxR|wGAilQRol)x4si_xL&75A_wD5g= z+4cY4gk3-RmWlTjwR$w(fhWra)X|#}xl=onD|OeFj2Jo8T^hTFnQTp7aLIz0+QUwc zX8CZl0zFprMo?%?n?0>&`m{My7hC8-nh(9{a~4eH-dQuT>NO|PX31bCEu2|3e}8nVq?^cQS2nGLt|l{YT6KFej%#xDf;l)C6e}iC z2STPUoH-v|Xt55xdu_OD)K6Bcw4Zc=OrAHthL_P~x3K7C!J8H%=Q-jDsJ(dRJm#il zvKCQcxpFLb9-BQo#+1wfiGs$-!L-r%((-zBb+c0X!l~*|b)uOFb^WSE(sh2SRnWyM z@0GRlWAk}RG3J9;ol26*5qFvMpPPjYZ7{v%D}L2nG%x z+fGJ&i)N~#wE)M2>_Y67%xtrZxv!FiAjq9LRg0`DmAHkva5PQot`utLU+hMtvdF!F zn=fpyl6Bd%nz@)gQJuR=U0|ohP}ofQo;;ryid=~vr#m)l{><6a)cWzLdS=yLW}#$N zPD8M%m(EuiJUg~XEkWP3&b*0!Dh_t~+?vHWbF(g1dE0c%%p|w2wH8cPhoo|!O&RXt zoLptjQDto*j*(}ps&?+=8L>H4$k&;3+>?gX@a)DzslvSgl{pqc;9Akhf@zacha#J+ zR6U@|!t_}SrdgGiokbp|Wq>N#kQsa2K1 zw5o`EEveR;ADfgP+NzPpLeWO4H)R6#4-aRKO1XP!Ol3h=_k{v$^32-FQy0Y$XxcQS z856QqP1beFv}qTkNvBqw09-oiz!uQV|LSab^K`o=U9>sHe`bcfvms#D*Yt%hsf2e+%{kKyu1eKH!xls>=Z^G7+Ewiz!! zxAoB+)d{B#xs{gp26GqX`2dq7M}ZspVG*eR5kZ=PHK$QJ)-z zOFO>>a~I`L0gV2u6yirYIRuyb{Bpw|T1~%#Z0?eMWl(X|5 znk5xe!Nl7ZZ1S@M82^1B~*`$r1UvnVK#CC_!AsZcbqu`HW$tG>T0dp7q>|bHh#%_crPo4+o zVt*#KzkyBK_(9vGjU(BpPdog$VeI39H*N=Q9C7>nzQrH)$Z2phvGo!9{lNS}K{w`>+@^AIq&S@hyO}{H^8Lx0EPI`KH2EAj~{o@{(k_B{r4%vkNRYE#Z@}&&c|KU z{}y2Khn-ybqdwWh%bt5izb)A0PXui8hu!!XjyAgq{XDQq=RmMIUiP9f=^P>SM}i~T z&McwNZ|O##J@QO?mV^6geYI*enCal>q;udhzDBS~Ckr!WOeep>@#_*9ugdDju;k8g zDenq4VY`95Yx!6(?NFbes(7yH=XX^8C?}gdXP>@!n!zT|uMzrWljrQdXY_9an>^nE zHtD$s%y^hicHlGmyTK;U_X>S>K;kDn>a(w&(LVw<>G=fAAMKJ&de|+`=>GsV=?UQC zHR(YsOFTX7m}m6EU{f!#cY?V`u>X&_c1pqc_^Q&zE(=+j*-e5!riX08UJEwyvhM`d zcwFq`K$qKYp~FrOCOz!@&{6BK2Lyk#Pd3NPUJ-`>A#}*;(Dh*B=Slt;mRtmv@=_ru z4~LBDxe5Fi&6gt()5EY!@ux(~4}j0p%oV9=k2-C^k7)UeU~??&_G9w)L$JvccGxj_ z%MozK&Iz!&ck`?E>DuN+ECBd1F0whl3&18Uzk6dag7W_wY|_uK;H@F&F>V$5?8;&C z>KU*}+g`AFCSh+%bB!DU^T#xppO2L~ei3Yn|8LhZn#-sAUU+CN=v9Cje3kd4nS87N zUrYu3e?L3$teKd+Sj||xXnwDsm?~K1FmsE)Q|Aii`D*%k)qP$1burf>&JE176ww<- zGg)Rt24(ciA38xwFG>fBn)rEDnQ9Vvm38UowcYgds_Res+cbGVURA!EL|!%fq4cx7 zHT_Oq|40`tt>TRzoh$I7>}KnIESX#niFX?FW9^{6Cu;%y=a`*v=`U^OAK%RX%Vz%S zX8zgD{3m@ScVEP^`t`~0Yq@W$Ta5+z&%6rP`G89sn33w)Mxi^_Rcn8Zx?d* z&o=V=G&AgHnt69%M%udkLg?zQ<-@?61 z@E*-f1E1bZ8a~u=_WSf>qkZyan)&pyMl-vO@(GDySwlah<6dPIgo_X&$AS zef#({Lp!|gcL-ht!_;R_ysOC2Nrukrf|Ie2I^}TrG-Gt83qGoK_@wcTmNTw@X?X$U z)3MPGpCW2Bv$x!}Le8Fe)Tu&Pj{PO`yhPw9^SaL#oJU5QS#Obpy8aoUb%w&7ubHhV zoc)D%X2D&dc^_PM$)x-Vxc8A^lT{x%sO!LoD2L9Ya39vpv>nj=0^A18e1hWjLwy_9 z;t9=s%ch@lww7R)BE_8RJ3%vB9_XhITVRrm9Bv!UY}w#66VzerO`2xbJ)D+_a<+wY_%xW z%)06V%`v#Y)XcY9`Wcq3K%7ICJR9ysn%OcyKjmye!t|Aj7sI_&Gj*=e%zAX0<~tB( zjpkp&y;d_@Kh|qzU3MpJ`yL)IFLXgnPecz7g-z%sTrK&5Y|A z&CkJoR`W%u1D@B+di{5rSx@{!GauEz)yx*E5d2I7>sSuJA+yCPUvm-MzM9$k#6dXJ z`2zaYn%T<4F(;I>)rcKF$!xJ<$4@d_d-iH(E6{6XTnoIFlY{yh;E!5|tw0RVux#Ps zd`x7v{B*`fW{VAn>yX*1(?c^`d(PI(R+xrT%wts-Rm^7 zHRfu~Y_VCZc|Bb2qaC)u?9j|sn)@_A1eg1$!`7G=HM5oGsAjgVaAXm6*aGu6&1{)T zz&^^^qQaq+WVX7r)NIC4QqIo9DU=8ND?*UV=jj=`gSw(4+919>0Z2g$HG1UAXW z=5MtQZ88k?**bJoGi`oDM%dv9OEzH}wGP8_NDjlcf*aJ#p$>gCb7Vv@8Fog(4%yf_ zSL@IYpVerG&ubhtL8cwfM#`|I2un6$uhTjV%OMohXKU5dWa#s~ifr^bj|_FFPdzeQ zt~m0H%$6vQSR}Kht1bLwwp?`~!zSO)$i`+jtwWprG_%!fq~)Cc2bOV+m^~Z0x{mv2_qts(Q{Q^VyY~4d#!Jn>NzSAFI(6%~8R)d@&ys{@@qFX7iyPKOA11 z*|KfqyloqstahbMo6Yn1@yngjA0+q}f=3BvnK1en2(A=7Q}8^&3j{A0e68Rc1aA|( zLolDiO&SggeogQ(!9NIYf#)g{HdQd6nT@=cU_KKYd6D3ef~N|eEBJE3e1MWmNNS71ZN5EBbd*ZM*m#F69n^l(dg6&=JTPE-z@lU!4C`GEBGbB zoJrK!;anVszZPucqBrtZg3|?e70h-Fqt9nS!{!}oZoy@)L zJFvNz@fph;BipPv0U>{#1!oDJ-a>w+;L(EBf7VZvsS^|A0-%gFhxW#p#``4Ax=A>`#ke!h_N zxy#tOTF9>#^2ddIzmPvKB4Q{vom&lWsP@Mythf~N|eE_jaM8o{dsuMxaa@Qs4+7JRSZJ%aZMeqHce zft7lkCYWv3M$UF=!5FPLq_M$Wck!)FWTGry5f6wKL-jGS}y z8(tuIjo`I{w+QC9LKF5;!EApv@|Og2o_ixdD)=M8-wSRO+y>9vCM>@>8tx{zr{E&N zLj;c(e1YIOg83d{>|Z6A?axNOS#Z5zzEc>T#{{#@*~ot{_|Jkr5X?4cqkmj*5-KAj zPZ69WxVzvp1hXyLge@05LGZ_5w6Idj#(j{Jh{pg4woi!oDr|h~T4wKNtL^V78MRJI4jHAA^x&xL=$( z>4}l23hpSF^DG&i?t(ebl9Bfpe45~5!6kzEt>1(lBY2|VUkaWs_+r5|f-e=!Hh*J( zwcvGvuNQom;Clq`6uevTe!&L?|6cHGg88k&r01~Uqk=yY{4c@$zF@*)y@@#U-Py?b zeZg?L;4Hy>r#3ph1@{#^Nbs40hYB7cxKwbtV1BbOaZMInEtuahjLs#3`7Oi9uMo`l zcOzdd_*%gm1m7U|Ho2KNkGC;I9RL zE12J0Ok7^PFB?u2%x^G8-cE43;7q|eg4woU!uAzBNHE(RjLuNOBLtTU<~JRqKUFaM z;TZWG!8L+c2o45jklLV&-?kG4axQAeVqcS$x9%7iYZyGKUe2(BTg2xG-BzTHoekU_F=Llv$ zDkHyKFuz+Fd7a>23FfyhqjRfZ_N_AVy9M7Xc(-7-)fj#D0yoTd8^in_X82XXZwY=^ z@KM1Z31+*Ev2$E7+ii?IAUH{Iir@}{I|mm1s@iC zRPaZFzZCor!N&!2*nmkh772+n76FMf*LyNLodo9yX8WPhDG)qB@EL;75MiJUnzKv;I)D`3cgYB7Qx#DbG<7Q@1ugB5xigUi-LbI_zl5t z3+8G*#{ORge=hh-!QTl!A(-oM89OP0(*<`HoGZA8;J$(j1)nLnSTNguO}wK7mkXXC zc&gy(g69aX5qz28rGmN6n2C42;F|^CCirf__X>VkFx#$;&8NX;?8bf}KPdPW!LJMc zBiMvJBIHK}bKNr&*S`dN(Rgj-34&V*ZX=lO=SIJ?;2go-1@{r$U+`eTMS_P3K38y= z;0nPP3XTb$A$XQxE|p}`zfkZ}!7Bt`EBHFWHweB(@HWBQ1^-6yF2PR--Xpj{@QZ?9 z75s+a_XNK$_+!DJ3;ss%cY^ty#N>}(a7b{n;P!$$3eFPTRd8>?eFYB|TqJmy;By6+ z3!Wf&vf!zLFA_XQ@It|t3tl0(PVhRx*9*Q~@K(Y13*IT13k#Zj-Y@uff?pQ=rr>u3 z|5@+{fc&T7C-B~u?EBM1<#lIV}-<`3;eTLD59A`8Y#2Jq>ab`a~qc8jEMT9&{ zaK7Mvf(Hs_KUZUOxZsh3O9itJp3z^A?;z%T=w@&mZ2a;23mKmWta~-%720}8Gpc** zDa{e^e$8FLFKEsMzpRctcgQr&eZiTU z2Y}hEV{EkMR0zRsFD)^J%^%^ZK^#f^mebHN-BLcRo?qhMqw1nL z7u-{GH}F8s9B*}|=Dy$&nmKmwJk1<;b-rfSH&ZpU?=8o|Fby1^wMaATo)wxaz-u-0 zJNXToCxYuWUkJWe^As?@f6*rEs;4zqgSosq<*c{3JO`QM5V^=Yc@g+enlA@`ta%Ce zYt75Sjhb1XVVY1C_G)lg^R?hkntu)E_bl3Ho!3kAMsPpP9B0PwS=8b8{36Xez$KbF z295nlsk0Z%aW~{=!4ote1haoB)<8y4lCg6C=G`0UFx`*1C;(#&uB*J%!e z`F)CEQ^A`xv(DS5ISS_YDe7<>_fE~M{~p!MF>Oz2&I3QInf2fEnumhTv^I9;+?NHA8kNsE4H-Wopz6H$hN|fIQ zK0`Cdz@4p`_2MYa4}!;Q=9suj&AY)fG;<6)zaP;i$D*>2EBO$3ndXMGc|Vwch%ej+)FdZ^s#>|?XaF6q?!FAiZpY4 zAHM-nhvWI!KbFj~dmNWUt_07}%zB#NdMM{Ozr~t4&TqNqd0>9uq0R#ETFpzq8#J!~ z-==vjc!y^8t=Ogc9`I9|IYzKS^W)%GG#>!7pDp8J{e46;#}R(2`7Q8QnmLY;-)pFU z7<@uA>vevwp`86D5;cDhPS$LpPD<761$We(0M63P`o6p7Ah?g_mSFa|rG56ZI8$>N z%s#i2w*#M}xf8flGy7arXy(#Z?2AkNuHZ_|J-{$3)4T!vh-QwpWItZ&a6IJ;nr{WatobSMo0{JQ zzpMFe@Q0e;1GBF$?O3R9zSi6U{GDcwwe;hKmO7c>pyso|Z8Wo<=64zD#K2uNv!3p$ zc`3NBX7&p>L-W(%VVd`W`JIJ!_?`a(%?H6T&8#nHX!hWmuGP#slHX7mmi6LF&Hcc? z(mWb`qh^kgyhAg;nct_G^&h{L(9S~e6Ph=G4`|*5eo^zo;8!&t1ph%Zzi;!K2<^NC z{)=YTRUd195BxXH925DS=8wQWw39O|$2KNvPQx{XwaJy7>sImG2X*)@x~t{_Fu!+D zUI;!-a~b#-n)y9>gyy+m_OGTszbB8=%2?7M+9?@Afv-MHw+IE%=t8oe3IZ9g69ifE|`6l zP1u_R-zj*fV9s-4^f^z3VfIfpd_?ePg4vE>bbKgxhLZ)eUBJk@3hpPE@Bc=J@BD`O zZg03sFyGsa{0hPBpKRpU3$7P@zu?CO9}xVC;CBVHPqMN9wO|YHIYu55oF+I+aK2!+ zQ<<>C1(yrv`>N5IC3unGRf5+EW}jpemhX**`A%qfui!(1-xADsKcjz4F#91Jc>vGu zhQop*g86P{bOs9M`vmkVAi_$I-33f?LBDZ$SReqHbp!Ji5KRxsaH zO!|`rX9!lal%m}5*H6fc1dkLvL2#Aed4jJH%(fJhhU*2_3+8)*(Rp0(0l}{bepm2E zg1;7Q;hE3afsG{ISd^9A#H+UO4#%ythWpCWjc;6;L030^07v)~pB;^SlHeJF=L=pgnC%iKET1V2 z-zk{=a*dqNmxiAg{JP*HfJ^s{K zRL!pBKmQwn3U0ByywtBB{?5}(2i1@Iae5zek@8`lt1);-LO@Pu!SLM2=dxbfZ|vO( zKi~h%&)Dk*fwcD)2A7R&<=R7aAGgQ!&^~4St-`y8{Ba+D9LvT-|IhT)+!N3%z{Vf# z4RKNZWwGEk8XIlvVq$UpV-fu3XXI+03L}IYKqhn*esjDPkjdlCin;T)F#m80o+Nu}|7+d@naYvu_3j(%vlCTZ1&x9badLNHt zCpHrXX#E!UrV#Yc?7I(sX>Tv=?S+i?+UR|>w;!7c1GLifk$-siFh8^JX$YjfQ_A*cpaqbuM zGxmBH3>?rW()8=oZ$Q5Rr}gbOux}*Nzc2pizkTxa2Mp*JiS!#Vu&_X>Pf1)hbYzKb z8%s>%FXQQCJnMGh4-&z;iC23^HSf0aH2sMfY_ek{|1aGEXIX1f?oMmH#+#XD^;mPY zcTLKQ=TBUn((%{>o;}_xQ5gr&c6s88uR0#Hp!i)K7V3Y2dnVb zK#!a6@!cFQajdJqUU6W^)vt#JUVU`MfuUFXHdG}SOt3;-uMYS0GVVL<%veT2EIo?4 zIK?T8rIp3HEFaq?zaY6X*1jgzp)!`4pZ|45ioGJ59_b$`nBWw2Z6E0p$(+$XJO@A|y4XJSs`o90+f)Kz%$%7?Y})D5skCH73LjOOgBuUb(*cSHTmuj*%oI=xmu zWANrl*VLhLFPc*p%_&H=dWabV;AOY0z80YnS7HBPS^Ye4-RV|C z)KgZ!00+li=R;@F_>>FlGCVkP9RCN08}}quCwfZSc*b`KLhx)fecGQI>sonML_4Lg zSrO~xJlL4w#h1_{Ln0;n8?8{65>ysv=MRZAJkuD-tk2I}m-*}~4No=V+6&c{#c~^l za*_Iitrk?^&2Z|@LLmIX_pE46$Xk|b7sR@*h-FRsOW~##=T?W>R>rc*VqGhvS!Kw` z0cFo^E1kL$GURVTENcbCD7*tJpWC)Jwc@!GBmJeYi%gH@l*O_`DJ4Ddtl&jlA#Yt* z#1UiMk&FN&m9g9vv1nZ;8VajCB}*F5&COVuTh*yJnwh&TVPO|LuedncrTdWL1IGvY zild#1$6D<8mY_9SWUOqaQx@%XzSl`WiGqPd?)GHXXEoWVjCPvoUE*n|Y(#E{wylWe z7Q~_rIDgC9R7zn@}}1e@ODXub*3(QCAktEWA6gFvn9+pH&v^GH6`c zbH^w6mw3x!$d(eHb?ExCXk_a+RZJu4eRES;NqaC6A zlH*!&YHVvt=HB$aYroRRvs2~b%G8I)XGS{>%0xvFN(p&zLYlFkJHLJjX~YhPPstK53JE3_K*3q!9n`O2|MB5o z#99!|nlg58>6qvlz6RT>9BTzL3-){5*b8Ej>^mEoP2EyoJ5NXLXVlN@sNXs6oMu}l z?(e>@>u(qJ-J9PhTCpvuAq#sla8>-*&)te>Hm=0w18Aur)-B|1Xs6@YKA`iv2UO}h zzT}CYFIJr%r-SYAVPWgO38g!~e%74j`tIsnes67m)Ke0+&FPCg8*z`JBxFZ&aQbwH zZ$gIWB=!terj`}+h$CO`L2hI}8|@a)??L}8K|F5gii^H+8m&VIGNT=fi;=gT(}xtt zI^!Z8G_K^ZCC_ppiuXmC$m5f*x$Ivzp22Ib?$Q&*(N4M7drJPMO{bpoL&;|-3kg*- zaU!q6c`LjturQnF5@&MI5JZAnW4Lc(Cc9hUHqfc8+)A&;Mbl%5doaZ~e{0n7v_+)3 zH+f3lHMYMyUV_eAxNntPnbFQmyy+;Wo$JP(`0t&s`02^ti7T!ByH&VEUh=y+q^`1t zeU@`85{YwTW6+}DX$|~58y1J7-J(nZ5auQpm7U${w zf3ip2k;aPGuda+D*E^u;A;geSk_7-+Hdwbt0c@G!f;&HOAy#Juv#cIg6CanaPWLw+&CKkN-%%f9hHK3Ze z3hHBpPx4M#P+z_M;RyxxiwZl`Kx;)bdgvzijuTpmI=A57W!sN>3hrNq3!o&*^AqiZ zC(;4y3O3@F5^ealk=3t~4b(EIgjP=9Hmc!EcVB4R>TN}JUo=_^t4=F;kcMbsNTiOh z1vge@!xzfQUzHp>d-;HsmC?wcK7}_V7d+6&8&5LtI$kR$$eiQ-^rA-0R!|U)1T%Y} z4vG})Ke219Rk7=f)m0hA(Fh8`us$AVvQ=>41hYEDLYVC7jUA7n(w?+3^SKkd+E`@| z{;Bi=R9N~Jof(UKP}P_b+It|m;;970kASa5qbs7h$qz-It*|l=`fv{!U)3RFRRQi+ zcLq=q;a*jM`(0mDKLfo^D~mV7jz4-c+&b2(b8wvQoi5P)K6j57wdoR%Djc100Js{G zv-U=!(e8K(>f~(u0R`fUuTmdPToFw#NOSTB`0{gB;xUiKz2h;YbdSeLwcNbf>)cgz&z$R6i|agB8iCssr|cE@u`$GT%D;(FQT zjm{5lxIJFx-q^;HEAduh>|~cUI$auZ3OZhd6VS0?7*4X@=bcvC=!|Z(Iv!I?G2>C* zXZg_rl7Kg-7FHtOpF2crX7E z`3}hV{oU1n#rCGS?=<*pA7MM^c)a2C1@PA^=(--CpNms^`Qqw%vk-rMz68$3=zj!% zJj3jBDDouChYt&>|C2sDz;0PSkN-J30sqGo1`@7=%okcl ztOELz>w!L>e=t|kO>@_i_QUt#>CD769;@aJ=E zE%*o7>q}^dz=;9>u(mK7xKVM9prcIXySf++ShB=}oj+O}^N2@@d%@ET&j-Ajs*}T@D4e(U_7ax0<}j za{BNaR@h4N{Q_>FC;sffrjm|`z5-`C{iBF9cm#HxLO0!P)OQBDF(pCAIgK0$PRCW` z3?heu{Mh20PEHQ81Ee#U91iaAgU=wR1z)DlndFQhJNh}lAV;iZ&b%M6o#8RYyp=JG zAgb0K%Q=UVdYsqP5_p(K-q^KmW-5h5alsE$?*(@>ly#0HWjQer}lR)w-+KKeBmw#uRVeA(@lFq z;Z6**M1@HXcSk^HnZ3@B@Zs~BomZ+oY2h9;uu^$4!d)3=mCcSwk+xX3)^h6X188E& z3iBJ0v&Lq3xUOMNpzmCx!sLayqKWe><;f3oxd7+aDxQ8}wxK!e>^~yRz;Kl3ZN2?x zcm{_za?b{(RutxE4ri1774{4X^9(pQ+syXi;qgrMEjIIYWVjzq-)8ee#am%cLFL@8 z^5AH=HN$MNPr$%OVRjC7>XqrwkeA2dZOM+2Gn|KO5K*hiIH=t!*IQu;Wap7=#Nlf- zd730W?91srwYL0 zA_6F{4#4Si(ikeq$0{XtJIwIVg*rv;vR(VHQHRVdY0^RHZ?H#InLJ>1ZFyWjvryMV z{v#|19qr*rUdk>62su&v66_DF+OLaZD_qF~&Qb-|7iJ%QCtDSy0HR^(O7hWW3S0cr zoHOiaXkZLa+L?;2@DX}`p*&8QogJMbb(aZ+9qu{Xo{gZ%R)BXN_UF>cO&N;pOm-^l z)+ngqdZyxhTh++nzhI9uQ7364f;bnbJ%R8Frf-r85<<$Tp2B|TrOp(4H|_94s54cS zcTBWRPnFFR>kGez=$&cG6ABm6XtnZ$!+V(K=_-6im@_dsGgRDJ;p>@@nM$o|_(>YL zNO|(ZE4k-laML0jHx+^08B0 zl8<+h_Pp{<3E;P^B;SYXFZ-2wyCDM-x+bB$wk1y`=8h=>2VX#>0gDCH3P$7X3l>5r zU}Y;wl8-%PJ9saFi5B%*qi@_z@52FIrcCxe-Vb7sY2OfqqH{LJ`?gm z*fO*5Ckc-(UF-`ywfH;HQv*rX4A?PGN%rOo(Po^z7@|wDFNZ4z*<*9o(J9ZJ0}-$0 zkw#}HJlWj2pFrg|0aoS={OPV^Vpep$AL+9ftMk4Cem;2Fn^(6+ch?Vj^o!L2@X4q% z4`8u6fOg2ZZt8ROVwSXLaa-rOz#Uz0Kay-u26ub^jcxwXe6ILPD<%VLw;6wl~?& z!tY(bb7}VnY3~MgoPWpu?$^+Nqw@E_>rQvpZT3ydK1Z)d7tXZoo7IutO7HAS9NR7G z!h9cJeY&Ue$Zu6gJ|PLGcQ?&#wqH}xty$J{D%5XR>d{)@7W;kd*$>U=OnB?v#_7|a`bMIY0x;KWshhUzw9^i01^JzYQP!qlDhd5SW z4nd+)0Ur)%i}M+%Lq6$5vzH6iQgOl177ybB=Te?Bx-BXQC-bVZT77NFU>STB9Hn)glc=Q4yS)U+e+RqRLVHEN->P;VX5Bu|FDu zeVrL%x(>m@eH1e0<5fyFsaZaLj=d@$abH!Lv)fhEC#Tk&994R)f;6r5ve3doG2aGa z7xV2az3WE`VkuO3xE#)Y>fy3uG!xH(?B;Mc=@7*~8sZw%XS_b9sJ-U;FjvphdhgO7 z-Frmu-Tb3_+3}y2_nx%(tCl}56a_O&v`2fcnA z&uLey8!n$@+}PFASpPRr-v^(f8I}*Z=X%r@p)BrU5pTB(VDOyghDMy%BLoJIau7K2r4OD{D(-ikG%)laH#d&HhEWt0b;u z*06$Ur!r01P*E06#s!}^n(V%CHJL}Fg`M3hCFpIH-m10T#z}66CZ;Sa7(6rRg?VqP z|l^eHawUHs3}CiwnwB;+9GO=Na>BDkeDKLF-?%s zSrr6$AO$J**Dc~l7N=Z~=tjS8vZ{lq&Y$5;Kw6${aj+GL(5N zrjt}=1{bB>SgdSeyslC6Ak!nln}!;>-${EjuU=u}O!Yw;x?HouwmfO;i=ma(3!;;( zV&q$&6xzd!7XUiBK?H2$F!^13*}rJtl=hPXVwjxC8V2u<_|-v+g2i7E(8N2b~`A9RT&CI&LeL$6BOZTxXWo zsC%#)I|?#D>c^{Y05-%*XCO8=R?=PW4m#W8I{@l82Y>IthLEnnvYJHY zr;5fJ(GGxm0kF#G_>tjW3(v;{wrsocOYO(tv8}OmwD#tcw8w6d+ElTva%rwSuCNE1 zduhiSx6!vTKsf;3-Ng6U((1%EaF^d5Mo{ zFOorgu4ylkZ7DicM81`2%f!~&i?cxN)Z`_0(Oy_4a>OOWLYa70lb1NE$xEzi@)B(n zQynjngAH}6h%CfIkgNlIZH(gT#HNzUCu%QF`Y7n99%3wk}|^N4+cMc<4W2OTgDjbwZlTLmA7%{ch1P#o;I_j1RFnRt?T!#uhS%(Bo$C z0Mfw*Xs=bXYzyHLm9Vm>;WW5Nhb`esg(EKRRtc`4qXtM=Wsd{Zcn7QEbfo<(Y$h)9 zFl>lx8JsJzd96V17A|}E1~z4t@TE#~g-Nry26?`C5eAW7+<0~_Bcx!%O<*S)Av{~? zNyTPcVj5&}F6&bdve?_n2t>E5j}xty8rSBWj>T`b2%-lK-N z*mQZupSoC3nGLZ2@0PWu(-gPDi{vaE5l+kf%XoO4+(&tMfcGJ#%0qAqU>P0G{;uSN z|3lrI2Uby?|Nk@h-rU@9FAyN?QFFr%frJnsB4P+3BnSc_35!d(*#p_kLIBx}2q?6& zxu9qwxS+L)h;_FCEpAw?TC3K!Xf0~Bm7;C6Rr$W(XU@5K2uMHu{J!5megl*9nrEK# zoMq0OIdhh|Ob4DGs%g=-Zccq0~YCU zy_?b}_^_i!pi}R}Z0{NZZyV^-(J|P&rV%k<8O8mrI)k0a>|J9b)3K)DV+a8qSVM50 zN2%(0#HWrr(f;^JQ;#1$1k{Q4r$L%}8mvQMQ724At`1n0^DFY|fbcbTmzCN=w>Jua zIzfn4g<>w95k^kn+C|FZUJ0wQyR5Vpx;iTktP$xyaMtvrF))KkXG+O@ z$TD$cKIX2*PB!TxGg%CYYyu*id}aZ29@JYi=>Ea6m&NC<_Lm|2Wk`Q_IJ&B7qjl4S zZko~Ucr9;p{LS72_os?Sx6su#W(ym$jg6r=pMo7vPdeu-y!1jiPAOe@I}&;~b`+?6 zaGrONwU+v=O>5ympi^=eveNnpJ9Pg6haZ~(vi=&cif~>!9H%PFGfx>5;O8K9Zs~m1 zWX@wU?-Afvs!qvcebQGI_PGP$uwFrdFpm%faSbHSeVWHHMm|=d!2TQOE>-Qmhn(Bu z2{=v-nb%%1>GXkZrB7gBI!s-&+!Zd&yO6>BdK&WZF*r^uCBGDz#xYe?8P~vZ z8X!3?WJYI|FZuo9IIWC)J}#UXsT^=3k;Ak);f7ln199C4W9M_dj?Z-t;PMM&e6G{w zLj>_04TEE_hxNwc-~#N_qs!VIdM4w_;cYSYus*;1$L1pSXG51?WC)+k!@)f4JZZKp zC{LFbX5t`MTcFElnh232TF%3Kp)t`PB0hkG7JCtJ6JSHe>W%qtHvR~o%WCHBV*eXG zWmq(WJ02D+d(^1J_Wz01B~6tTg^AdU66+g^D{8F7+Pa#>iOU*Fs_R1|OX_P!C#8-o zsVp72H06A%C6*NxoqjekWmM{@v56JcMU{=kC01g2O;t%^#nMo9VrgATNnJxtePVr8 zZAn$53D60*KnIgNDtT1W8LaBqHH7NQMrzxMRiUEtit7KjVbm|L|6is-=BJ7A|5a-k zKP+vkFA7zcj=~r>9=Q$0#U-Vq%2^x=K%vIUhJuFWwI%hCp=eds6fFUvn1rRM&u~$y z8z2V40J7IHFtM<)qOt*5&5mH6!6ZkV!EM@9R355x5Ees~Km^`Y#E=|ueM4PEHSItf zK2cO0MjJ|%RQG2t+wH~!%XYh>BJkJNe?5vLVbA5U-B(4q)G^AeJ3{f(Ym_Ix+R>A9 zn(Rh3Z@VL-0{H8~C!}n*N1KE(XhKJsT!GIF+3x75E=n4OzwRjhU88N$Vkhm>vF=2V z)>kTdgbtgb&QYO`R(|`5n7zxdSlRA-*C^+-BL;|bw19KG6_Hx6Tcyg2M2y1;8{cj- zx#NoRD;*bg5Oc5Fs}kBRsw;H*DK1r!SRIAQvdDmF{5@eu4TSUK)#}VzI|{QR+-sd+ zJ<6vms+-bgL~NA}E}b}r?OY$f&J60fRC0}k88b%fGezfUrlymfT~zW{E4gz~)P->O z6&d{7)#~6O=gbNfSFiH%E63w~&Kb8-lb6X!iMbriZx=I1U1pO?=EKWQ2#-2;UU95G z<{UXiC`zTvltEth2o;*6>g2;J6*H4ROru8?rA|7>Au(5xQBl_t0uKlVLGG~3?L}@g z_guQTp5_-P|C3)o!#y>`c3+OcGlY2U8Wp6Ic$1k-OoU3z>2fCvu5Br6IWTOfZ{>(k# zgyQ^lBI{CDYPBfO9#sxio|_yyYfQX|JL{Y^>Ml_giSdW}g=d|rfp<@Y3ddIIcFMR( zw^J24H5&CfRYg}t?sAzLob=)@X8xJf@cxU`Hd#_Usy0xesQh>CXqBxq^^Rjfve;hlPlBLDDR4AV=UP1VBBM-vy(jhZ$CS(?!(?j;CkR5r1j=5tG z3ANM>(;*frC?zv_?^1ccO4n1&KXo6Pl%T?CzYaZcHiC5|;=(*O*MT>pQ-(y|t5hu3 zSCDBlc}8tjuC<@OQGJyy=UVfuD*q_sP7XNN1vN~^d^shK5vS(ge@s6-tNMYZ$9aS~ zb(y*~RY)uKt%}ljN=T8a%sMrTNAv$Y*KO^CPn1(~`jisyJc*s0cFG0w#nkQ0sR(ri zI>vdiz60UM#97_LebwFW)Ud)2u7i{7EMGqDmxb5V2n;n+Jtdqrf^+o)QF96#iX`nc9VvaZ=nL2?IQ>}NaZkwq5>F5hlJF_pRC863iNHNp>bCoC)JRI`X-mU;U=i6 zppUv(esxowr~Wz*j2PAA38=s4D9s3^xkstPe@zq+m@RBS=F zvZ5ZoadufnLy}b;s;{pot1c;S*A08ESAOdY96?bLqEJ~=T^6VQG*&zQ;<%0oGwDlJ zO-0(fif4Vp5{9Fqq=PAFs4A#0DH4`xP}^ps-NF=qnkx*|BSBOz zufgR0f`WPoYpM&Fjsm;^)LR8bH8o2rs8nB8*{CC{qE}U0had_{D??PPs4pm57D9IN z{Q!n5m#DZG@Ku93TeP%6g;-NsT3>==;V6604}F6rPd9QxjIexzVTOcXd%s^-^f!t)@_= zqo$GZZmg@rYf(WFE^b*(9m)Yxf`~eKdy0XAIu@PcPy@1|x}v7A-fF5SZYZ~uq`thS zt|9JJeWoi^S)lSIRA1CkQB~p`IFWbaVpWw?71b_xUbdK%%m$t9$tV`;l2cw#-&j~x zQ-@1b(NIzssSK#_rAUe3vh*hX8gyPVM z>x9VQxCz9_vIoGqX=cota&bY<)G2v6bF=fO7UW`uD#~P4sG+F5pfprb*@zT{v&|{H zDsP<(RRw_2SY8~$wJE4qnOTsTJ!5M4j&(A}5f!vYMcwQL)g{XiovK1n_V9|1@?4EV zWG=pwV=#}~HB^liG0e55ViZmF&WzGhf}6d)2L-(;rca~26D3i+qr*~7BkytKE$=EC z;6<&isb_3aysK+0C$R8Xxb%taZ}<{?^E2!D%Pwh@Rjv(Bg^7O&Vs|ew7O=b>eygbRy(Bzp;gouGoRE2 zZ@(XlDr;0di5sE1n72!ztc2?utHT*sI~I4n^L)^k$|;xn7Aj~6m7ybZ%9IIlLyPKa z>gyY7YAQ!wGA*wCpt@}2=uye&`WiWQ%*e8oaiycjC6$gWuBdBRKFmpz6+k~s9CmcJ zSo2k%TtRkqX^oXPcWS}p^trQU!e_37bJB!afutxk)f*Oi{Nsj zd=Ylc6I60eTH;1InO`TO&Fippqnvy$cG|xeJ2%E*FWiaPss9o7IPBEH`bw2o^vjVg z+N3-V%=C~scY+&r$V1>#&f!OHl#?%n>%xAAkdtE|qyBy&CmT6ez|tS>ya?{2^^XdD zGG~s_&KF>wqW*D!(f82^HpciI} z2LpEie6U$6k9Kz;C9WoDTe>{Nh_9gf9uqhIn+xD1QqMcgPS4~I+nYhaTPuY*lK{87j` zwrB1g4(^$Fa?G3?ZIVrWk^(k1ISQDJ^9-v@$jiYduNs7$!-OUdoTW$G^t%PjjmPA0 zSru}QEsn)`>VF7!Y5kADCamK^pKR{Ue+d2-Z2WSH1E%LHo16$}@}FN}HTlmu83VKq zM>4rFo@7%8)_{#oj?$St*(3DHDe%Ym{|0RGkY7wS@#hR8ZnRG}_XvkfO1~(p) zP5I$?DmTi>qu?^Ei@+vs9Aq{5&$*1|zAF_v9DyC9{qn2&CZ4;5K8IzwF)XslLr!@# zdH5pOLmmc~=_(d-vbje%ILwU>8KVYD zpYyIv{jeEq>_16GY;?%R&M(0xKCgq#J@N?^vC$!$YxFhPgk=MGnHbMVu*pLo*yKY$ zu(8kS5$3)dC*+(HVdBhREira7z{XC#(4P+;ti$EB32uxh*<6>a!KS=%LLE2ikXbeu zr&e$rT*kjm=#Y*4DA?4K-SB`g_G7^2dBO2lZnRG}dBq8=h9`mPmpU9rHgV%L))9~~ z4xHq`jXLCBa4G*WnDM223mCVvlHVxw$vjUzPCeqrV=|vFl>Y>5@|L6LCeI%O8~Yql zr+z$k&N1LdJ7gp0gadArlZ~CDU}K-d@kaj(u(8h>3PyfX$T?lX$oZ@8#tz5xjs5-r zV~1n>Mt=m@=yP%dbr^p$=*@VV&BFpds(yJ@L#PlgUW$}kZm6!LGBnD(Ige6D=*_`A z0rmDis<6J^8dX>09H_I!C54S;c#jQLmEa70JCX{v#5IQs3+qajo^l#*7N;DC(B)Ky z)veM*C5N)L3B=DDh1Z-abV698oENH5P8cfCWetqA_KpJ#)YqCcx4Xh(TqC^Nk&jS9Unw(&6~F4#&GY9N*vJSk4bXA7A)&RlK_D z&Ygi{#*Q0%YUe_G&l38^@W#px2ZtIJcIcr9zsc)2`!jYpwfCW#?k(M?WL}<~TE=EU z!^ZMw^A5(wt7nTMWV4BY4UId?)|ZY`VQfBfu*G3F%%`#8p=7=aVq;mh=?NRJwaq3P zwiN7!Q^{;5Vw;HFK2M>QCOAWImf#s=9oB5J4l9?e!8{pYq6WK){(W%%fT@&%eoWp63w&VuGhQ=?!)A0 zr_6IQ5%oEZaJ*(dovzSa4EG_;e40Hcm|v)&U&=oh%vmBv?k6KGmW6&o&IR_=;gge7 zRmptI=RyZE*D=i2%r|&0cQEoRgnY4JzL}b^8nvAB{P|{T zM!5HDeiZH>G_#fQ7s20XW_g&3rY6JU983Pz1DSDa)y$U2TbkMW_(1SCn(H9%g2xj5 za#rR<&1{tvY37_{{yqYA*ec;fYBKYO>(a@bg6P9eW*kyAv$Yb^%vL`qTN}TRX=W?+ z6~TWJ?7=zevz6*6 zTH$g=A(@jEIqQ+U0B)mZ=EJR;IoFiS&Z)y518u3GVA*56rL zUJaLZGUbcl7Ls8H(O2x(&yjMZeHCoi+Cw{tXW_j*I zMp&$t$$nkm@?#{_XYb=+%}`Na7NVT_Gm3Kfjf0$Q{PMFT)QN-34*`I23KNXYppu zyWsBB%zRM2rZ|5WWOr&g>sKDrFMCh#)6D0_1DbPj?ttbe;XbCBy@1bX=Ch?uGkf@$ zHrnLp;$G3rI-bXrvxoIpntucLEzPV`c}$(7aNpC+o=zT9J`?*f&3tz8H?}EfPvMuE zzk&M?&FsbGF?D>{Pip3~&V`-wudsK~%;RpF*$dcPGxKVIW|otonn%GMp_z3Qk7u`>9qy}|*|Wl9%HM|jre^jO@>5cjvv>24nmyppHM1x63(bFr z%U)CJv&XcLX7-o{H8WiUHB)zpW~PfPnCO?ir2GvmGJ8+?+rwn`s@9Q__Mxyt_UpDE zdr&FowI=&@J8(Va@XMam>jdv0Lq7@nWWR2ga>hRO*)C|&%r?M-WazVQBpZEB>!BBQ`>bY|w7BeqI((jTIU|{Er?)h-xA<)` z;*bG-vWdg{T8BN&)T0ichh(F}4;s-Xb(k+?_RhMoli6Dw(9B-suA14qJc<=nWaiOlxf zb((L0%ikcQob75JGu%q(lTElcY902_KcbmE>rZQDkNeLxvnT%dWZ0>N9kMBJY=2YE zHX7NKx8sx}4(xsZQt-dD{xay3{c!+nTzy1+w)Z16vz_0a4ErmgLpJ(cqD1{5+;cUv zyz!XwA#ew3W-lg>DQEjOnGBn2VUuji+f1zkvHC4_>az`;r{%OWpA5h2phGtK$xl>K zpE_y;0nGBSQp>M~yG=9gb5T0=IZD6}Uy<2!f2U@S2Hd5YJ^lA-eh4mqLyh|ExqnzQ z-+K-S`O}&Y!Tq^r_UQANemM&9qGpZ^ys7zJxcrTE>hK-veWCNAX4?5o^Ve|yt(hYg zT!cx#92vM!Fym_E^l!LIFvFvq??)Rn^O<$KW{$M*9Cg~@-lv&Mw;#~Vp6RCy!|$&& zABD@++w@DD{C#sW7kaTvl*~~DpJt9c_%(AxB2M#UxLk%z{n2oTY33+IhUVFDr)lQM z!z#^;+ueo{>_Ne=3I0^@H-a(eGaUaxf?>+)f%JIbqG&3PfyWq0ju`Zu};ZwSEe9z&wAx;50J)X29ic{AQ80-x<^a?}f`gTf?YkRb2(g>3ig~ z3~cOawl(ur(=fl#YizRFB-3JZxB}Zq>_&fr;EM#$6r3ygQo)6SD+JdHW`D8?Ypvi- zf^QPMM=1$AlFxI8pEgf~N`26ng^PS*McqcLP-h%o5X5{RLG(1W0#e(Mx<~y6wuM^B4D=_k%g6|Q`_c)`| zCYbMHM*f~)erUh(WuCb{)K|43!W#qSnz7Wn*`q?_-?`b z1-~x%cY^;c_@9D3Xm^=-_7OZtaI#>|`Y`%41oJa4M$TCuhU*2d75pQ?w+g;jFx!5{ zPPE`y!9xY72+k5bS1{XV#%6_J^?e{+R&N*by=2_O+}PGK&lk3x?0_Txz2H9z{qF_4 z@I0hnJ}bL{jo*P}ZGWiNVIS#Op)*PFG{Nk1Hh!-l>-bj)Ionj`*}6>VTtn9J-zJ!! z#4&bu3;Dx>4+?%w@LOaZ2Yy4z*#C>*e+y0y?|6L*fy^y=nelvc%3l0h%OxAfj zhK#bsjUUJ~@-)HI$hut35b|8XmkOOlLS8N8^@5wgEKB@AIKQTD;=D!Z?9e*=4Bfp# z=chvFH-bMCj5ScKLeHwos~+f91!6a0eU*9D&xJOIB`hN$@nmb%JjZ{FLB#1^-*H2W7;B6)$+4;9SAwg4YYaLGYu3 zUl;tP;BI)?FyRgoJVkIw@EXCl3qC0LPlB;REo^_J;3{Uo4GGW2%aim3g`vpHJ z_zA%rr!#gqHfQ*VV2-;P`ELbttj);(Ecow&Ilg9eJjidu9B(sB*D%M_4D&tCFn`*? z@Mytf1*Zwl5IjrpT)~`kVr&))=6Ix$UnzK{;I)D|=fvpWAoy0ncL=^uFvt9i-^T?% zE%*h&uLyoy@Oy&)B=}RoUkUzNFxC)<;}9vhyWn1e)oKg)=Qc>llLV&-zDV#C!Iuc; zw?9ojTrM~yxKePfVE(|K@w-Ow^@4vanD4(vpW~5+_X>VM@MD6X5`0)N$1aT>j!PQ; zK=3DmIYw!8z7+gV!QTsZ;Xz{bI|=6dwUPG}+*dHiH;v99!3lzs1oL;@jQ&KyQw8%q z-RN*U)Nrm~j*lAoBEe;Xmk6#G+$4C7VE%B5v3b4V9}DJ>3K^Z*v05YltKjbh+vsC4IzGW1!!`0A zf_n=dEO@wJ_9+>^V+BtXoF;gh;EM(42+kLLx!{oCa={z}HgTvI+$5O&S4O8Mnueo*kEf}aq~@q3e& z=LNqanElK~=WW673I0GZ$MlW<=Yo$5{-qSIkKkCr{B;eZ zGej`w2N-#>;PVAvD0qfo&L=Q_IbYoHrGm=^R|;+r%=t0KFZ;j^Un6*%;F|=q58UYQ z5zM)XM!rul`^Js@8Nr;dZsact{*_?PGc!8x3qC5Cb0mz;Uj%B8Jq zaBso=1@o7Bjo(DU;{{(Jc#2?-2N}QogE^q0j2yo{8Ri~>dkc;eJW%im!HI%X1y2+_MesDi{ON8JpUVUn3FdF>8l7svb%K`* zUL|;);EjSgCTnbN7ksPWI|Sb?_&&k=1oMY{jZOa0xZxKBza{t`!AAvuB=|GIUkLtI zFej&)uzZ38g8575M&~@i34)UZrwX1ZI9u>c!TjlTW1nNwhN}hF30@(XKNoED`NQaj zw+e0*e3xK!9a%QorraP7k88((jUA3FnelXvD|OfXJgu5BRAAks8LzC?1Da8#TKhF) zINaj668&<{?;*|oz%ObZ0)9>NFz~N6CxCyeIT8GU=Fwn&#fvsmz<<%43jR`a2KXDz z)4}|C9O};kM%=F<~P8PYvy|YXEk%pE7#dkzbE)L&2eC^ zqobU2e&5&3wXPp(=GZmIs;H9({;TGBV9xWTJOuu?X0B)D_!Q+gf}=Fw435_9$2qRM zqYl?o#%ktz)p*TZAIW*4)ZrNKD9!w?K#FFrot&VV-xx^KoCVI*JQF-aGru>GqnY!3 z=WFJ=(JM4_9Jp9>2)tM`ze7-~nPbA7kIJ~!VqdAb4&1Dn>p(YZz6#7SDe7O1o$L6> z>#%eFDw*p~@6^mO4qCS79@hQ!>fDdWD4g8{Jjx%#iiu(L1r?)iU z4dyyN%J0R_F)8x>*pF%ESoG(b9|8YE^Fi>pnx6-|F|I+sZ(;AG`CV`~&F_Ob4n-aQ zbQR~*l0U@GaVYXf*oSNW1e~Oq^#|wNQs)co6E$<}nqyLw{}X$b=6``XCPn$T*mE_r zj^UUTagy)Ni*kY^Vj4k9|q<) z6q##nxn_@?3VuX0=WcTxigJ#Dzo41*&>Nbwz#MO)&P*`Jn8>V$KGn>6=u6FoV2&|S zrv%J#C2~2qtL7>&*920&9Nb^?N^nr~YVZ)vSA$1t-UuF}nRV6qntueoNb?qOrsnP7 z8Jf9nm}5x{_jWMHkH~j}IetX`8Ms#7FLte?1kkUGBuuho1M%=yoh{|UTRGuQau zruhVzbD^ojHNX2bb1m@CG<#5%pVrK}>X2qXm}5rt%ev}K&0H(|o@UNr=Qt5{xIXxp z=HcMaHID?J(9CgljuTNo8T`HG3&5OfP5C5nC(Rk)o|-wv-d{7<8FLOc_4C1rnz`vmSa-|W$AhTfAACgf0Px$Ixi0v9&HP3R$AGBMy5tkhtV{l?nRUrmnz{b?Uz)k*nBzh8 z%QeJ)&0I&^O>;B2zvgSfTzg1;t|R8S51H$W$7#M1oTi!eN~Y%f!5rVAKI@fy%^csp zOf%OXb9{$7FM-Q7zXq<>%rWf-&2NJ_zC(SkUtX*EAK>+xzXxyC9Dy>+HHp+`y~1^f zx+A7z6Z>49O~}{$7^Pt!Fl+UKLsA8 znd8hUnz_z+g63DiX_`5PoT-`h#0<@>Cvr4%9WlplXrE)qoVQQ5QP#>ebNz3%W{wpv z*Ua_BYc-Dnuh-0R;H{c7z?{QRn;ZweQ}Z0~Pc*YW_?c#|DSlcrzsGY(GuHyYsCfza z4b9cycQo_6J%7}^9{gv`924d^3*)d0{145%@4wZ|dp#2GK-75@%&`?R$9sEgJ_HVG z{snlbX0Au(7z*{dPB}&MN8pPzbNz9qX0AEr7z*|O4$jf+LfM(GnQN1;(9HXoYeA{c z`Y97t8dLge=>NpmUH~}X3bnfe23=w;JY*zgSn=FVU>Y7 zhC*Hp{+Z?~@Y9+(mU~EZ9hhS%)L#bXx&tzQ8Tu{FSA*ZvyaCKH6zcFdk&kKSy4ue* zvko|+nfKz?n*Rdk*b4oA3HG2Lp8PeqlV*;osx{k?a~%xFR;c5{^^eue`!8NI$4mLG zA?l=pIkrOPTHzGUT>COXGsi`_-hn!E!53@hy_KW+Qt*7uwP22?P`@5rtho`qSo1P) zt>&x198aPCYVbtV^Dn@MG;>_^Ma^%4f2o;cp>JvC`eu%;(B@I_QO%!#IkrOiXW-8@b1d|P z=I_8?YvvjqH~QhJ&ovz!TOo73P7lppz+A6EImbl@YUaA>;hN*XV>NSJlxsSu&o$E= zHz6m0XKCjBy-+jPRxi>#4!lG&*I!?$nQN@C(mWk}t!A#d-lCafr#ETN1Mkwj0K8i> z@B8~S^ZQ!|G;_T4Y0YcF&uP99{F3I|!LMn40Q_ss9RK{S<`=*pXy(}F$C^I?|3&lP zz#J1{p76U3-)QFj#7}Zk&Tk8NG;=LEH=CVFdNT~K;eI5!?t7q+CkdV?I7@J@;6;Kf z1uql4PB8miY{Z!x`&JC^6?{N&o8TjY-x2(g;Nyb770mt-6IP61_K6sIg5Xra8G<>V z-{@Z^xLk09;I)D`3%*4#zqMs-?i2j9V9w7sI{Yq{;iG~-7yPwg56h0u^Ju}bf`viv_cP#Duj{@J7Kq1h)!izoqf}xM21>82Rgh+1Fs?>_;%n{sO}m-u(;* z1osil_j#kkdF+NK3g-K{k>?6tB$#v5jm|Q`>jd+i+34&NyjSo6!EJ(%2!2QKM}m(F z{#LLL?@lJ%7{PIZIVarcqzdMHsgchX%y&*BFBjY(c&*^gf^QLgm*9PZpBBtME)y2} zwG1B>%>FAQ|5`BL6^%SvaID~=f>Q*i37#Q%zTjfPwSrd)=DVMX!w$i%f*%n4xZvjn zzb^QF!Ji2JO0b3Z3KMQXFyGURe4yYY!JJEMbog#&I9Ko@!IgrS30^07i{M>?`QByh z9}wIo_=w+7yPwg58B+uZ?xc8!9xY72xh;8@jF8>-&Ks9?<$6C z1+NsmQSc7It%5l()Yy4kF#8RR{B^1tlNe^7fME;mSHpbwH{3_CTz8)&KNk`F?Hu`p}Lv%(l2; zw#5yz&22bUaE4&En~lz8g3ARr2xj}(=x-K$i(tO<8Xdmp8s@vLVZP5A<~yw6qk=yt zTO5?pRAM!$HjZO%)JzAD5w-Dij^s3Tgno}a%VOJ(a{A{vwy#I&V`J}W%5<9? z7`8V|a~g%%=3{a0M64sGJv_F<_81@9r;OX5g)JWQ9JdMBne_jpr@nIpJv5QjMtkv^ z=@|J8u(3^f0EwGV(3{DZX*ibovZKPX+8|>(7$1`_SAeCxV%Ur1Pl4#ooa6Yfw3oZs zdGDeiU?i=PyFMW>raumDq1GJK1k9|&NGv|H_fwXrE>`{;Q z`sj1C$2>Ck2GAOwgK;&2-i$rEq8M2*bJ2GNK`i7wu`?_dA5^WU*c*uYU_WGLGxidb zQ&UIBwQr+S#-)rqe@sg1n7FvHWAI1+9i5akZd^)S+_-Vc$*D?xQKvOiXJp#8vBdni z;*>l&zz=;PQLH1-V`jyv-?XyUs>8GV;dNmem_KpY)3KM8mX^MHiJ#7ci!u+eq!s@D4;&; z@vS2}%~-MV>U(eN7Wr|PtjWp2-fl?%$!h0VQ8uog`u6|T~_>@`uHB+rov%Er+l6cFEjkk$@|>*O*!&%b1*${Xqa#1 z3EH-{1t-sN4O=irRTBYs{K49s(8W0iB*rP$)QVW2~I#e!ID6{(zIs!OXQOZAqhpPd`!^9D96jw*}o7=I4aQ<^)r&bM?>5 z38id`zvtRMhgy#yLi>Z0`yFxOw7K8<{T_t6EtoxF=eAHbOdjd6evc>MPM*^caF57X z`Au>tD>;<*Mr+YT?~H|k+Y;_h_(Q^9`2!Ib`Vfni-yk+4)-{JRn`5ls+~PXiU~RZ? zN!cx~^##_3amn)l6Riznqf1|O9Uf;Tq)fZTl{wDJyu|fS=w4)fjPn;+2?wV2ab;$^ z*8lk==2Af8W^2QQP7`-+nCMzR%koZf&3GRE4$reLTSqr&&1irJ?}aWe9vtbd)f8sf z8&VR}Tgx`2bWU$AnfACVbBUFCEwVVhwSwo%EXuNQSc${TX;$V)7Y?q(fj7h2kP?&L zS_58xiJjhBOAp2N;eoF7)<$aYhj1A+Ujo!K>~me~m)I6EX*6ol&2+Z#V$yLJ&EkdZkEg&?!J zuQeijULQ{&Dzme7@rKyzHr&^xX_%dmwaT|Gn8D9fKx^tM-}TqQ$Spn;yPMAcWPR(& zEjwG0?`=D`jL3lO(2K9X@YH83ze?LVH*?p?^wzar%<&9((nDE?f>~`dTGwW5Nq_!z z9P*mcL;CaI!+ZLRuTOjG{lhn$v;yl8)C>=PHPo`$r>uDf`A z4ife0u<>_AHVw2BrsM=OCgkP(;@iCu&7mBpNHqs@N;|nSS6I8}L}x}=pPX}lC}Gn}lX2@G3Qm6`c=3r~+I7Jv=KLjUxm_5tb3$$>N&7>y{&eTb znVk*=FA8+p9h!nGiNx&>&U#@-;i2I87k+XXEF6Ejo0Gnjdb@C8=$i{G=xv2t2VHazNDpJ3s9^PB=dDz?;wpS|5^@xs1+_~gmL zIg0|f&bxnJVe77K2jdQ6qasTX}kFKo??rUnReXRBPQ{DFEwdMRGDJS2$JhJfc z_f5m!&v_wf_rW*_>RRu}Y2AIhcj3YnD>7YHA@0hZcqEL-tBPnk|F}28Dr~)DKeBYm z#7J1E%Xj7EyEl~{YJK+QIkQXK7KMU2!SRKmOBUXAY*1uja9SW@UVd5soq-518U;D6 zrSonXR2WRXr&re_+0DUek>ykR@4U6ti-zkFT)k<5UXdlEM^t$6?f|X2;P|G&(ao)8 z+kz~fkrloAmts0zpy#}MJb^)r^4b=b<+PUNgk~};f-`UT7Iv!(L^j>z^1AGVw+rVq zc-g8!8Nz*wd#W_ecaQOvilB zL{?bob1G3$2L`9lslpAkNL63yp&8As%e*Vk=P0I5c}Fo#ThZ3K{2G+Ruy9qUfVVI-C1EK_Fdo}YKTGKU7;loNx`kCP z?}T&j;}4$n$$h-IN8;yuy_f}z8|e1PfHxCu&BX`y`>omcY}voi>R;M)(-#5H?9wgi z`PR&cK;(Kn<8ad_yc!koJNJweA6P|{dQAwX-QO07XuUJI<<==Vp((2(4&!{l8xH^W zPKe+t@8w>2@Lq-I;n}Ydiz5oFbB+4{z%}Ch80RW=sN7l4W(KVg9*T1s3PUpxSn>;= zX~pNBTDJ}qb^8Cu@DM^^aAa}!&3~VWXG$dwo99$5%7{xxeF;Is;3)rY6pV+~q}?CA z8?xR3&z5Q1)6yD_WXztnz1KS5;9d!X2NxC|te#yvuyd%uDIS`eV-c^?bLw6L;Cc>ej~HGrhI-lh0JcOEwt#n46t3ay zt-;H^nE8O5J<@0W1Q%M=Zaf%pcwuB+a7r_ts(mkyOg|WhXE@5%s!o?j)>h2j-3`}a zTA+Wx+qz`??%=fj!L-Hq2L>-%6218T-Jxl_Ti3Pz1Q|0k|9aH>Sx|`W+WL9hv2*7h z9)!dtbh@wm?%>!>@w;D++Z`IaJDAcRzEbYFel$us+L35bMju)06w41ovrdF&%fk6# zaMp?7Y_u_Zy3oe_@R!GtSNFL-PTUKV$N$>x)9!!%Gc0}>8mo+=g?jzKu-Se`PA}}6 z`+428gf#V<;Mw2$$&+{9=L!thQ5=Doi5LzDn+nHJ#w~yNN?7VO&U2{sotHxuu0Uo* zcQloq-dz!@@d z_sh1*!C|Mz?~Twb8O1k(v+`fQlI9OPIafCFA?93Zw~FqI7dx@s6#qYr=Y%R4+EUgQ z+Zhq_B4UxtyVo(jbuYx#g~rweQ|ex@>yY9N|FeiqD0d=uC1y{#5V1E*#Hu<(EIyph zGhNdBCyP}6rENGiD%+I~BRjk8?0)NxZK1L2|8AZ3zLNj)BB-zD*fE~PB^$=M)*sic zse_{JmH%E~vSnqv0t2(V!{(;=^ygjap|R<~l=SEAbR=?JuhUKUyA-C;TEPQ#+8|#u z?)*<&-r@GP)?>F$7N*#6rltOH&ur-We8*6%*Pn4LCe_;)u}z3r&^?DS$@v8uXnZeI zZ)NvfdxnTypF{u8AIDqa0@t*`&w2N;L2yqmSLS4X$$fzz@X}9Iw zS1fZ%a<)rF0u{=JGeqOoi7*w2tSz0psH82{cdXaM!?8b{j@VO+@71c00*})C;i)i# zJJY!VhCYLv$+=;3tY!@|A$%JZv^utVs^${L<~h{c79vh z)V5gfv6%BS%W=Q`S7mtmU>Fl+_;^OQY~BFVr=D{6xYm15uAi+gXkgI1dwhk+22`XO zmMY-cE>pn6MWc84zD2F>T#Wqd&qG+vt;eqa?}~H3Sa@^Z#14wO1GmWo{~D2z?egcL z>Tn8ZE^f2K===-^Zu(F1U+xVf-dM{&H8ukG`g(qOG{LJcU*X|6r!43?`b^iahm%hs zEPQfJ8}uBqNM+S2`E+dEwTE4(&Jdpk-A81s|N7*n_-(Dv<^(Tc&2)Tfx6HkeAn%48 z>x&nQZNaSgVD^@*xzpq0L)r1cvAvRg>j&V@&ngT~TQs%po|t!Iy=amAH+9nVC?}q# zPEwJC>FMe5s8mB^;}6;Kp_F6IF7F>shI1)=iF&R0$NCs6;A##|f!2^)`W^P2o|nDe z`;OmlQ1{yu=h7m~%qe*1ML-XWF(GPz+ior{a=kqsLXRgBgECgc zZTRDwW>2Tc70Dmx@z~x8%JJP6NnymRFzCJy?Cz(0`XbP3wLHGaJqX49W1das3AgIf z_p|-zK1_Ro>xrBM8xj2z3Oo^<4eySGzlb4}MDXkOu40?sy`G5apTLbg7uF+Ya4laX zKdu%rlTyn!AAi2a9>qUyCSW`~ck)F{i-SG?avIHM;FkX~ z5hTvVU=Mo7-29OPZ?7rv22*J;)tNsn*~dHbcADd|NpB+2>Qb=8@+Q%;$A1(Na@gk| z8s>n1HZs0JcrPNyS8v!7LtlY|A$eE+?X?gq&w}=7gKg z-nmcEoXW9WqUDcf1o9ZD$3Fmmy!k(e+~?=w9`8JUZgnH_hL(I>Bg3+QQ3zbmW&=;=W*OyXU~LM%nnGrOKmDxF}3t~mEDZY z^2D$l=mTHO$28-d3B>pr=T*v2bPT^N>s@2thV;e6%%Fj*)tNpqT#w|vMjgb)@JHdi z>ui4WFs^4oRjuV+Z@I@BJxg0T;Mb@e=mzr8pL%A^Z*ih2)n?Ej8B zWM)ab4t(1Xs49~QR`-_6IljOgqblUuTJJeFm&Elrf#e3fL3<_6$EbUGfMP3#Upn*- zR0Y-(GmuwckSa(%1jEwR)kB*-+K~7@-V5!QX@D!3ypt4LF%QtsMe4vC!!=~yH1)s< z#BgGgcZ$6XDTuawdaED^&+E zF`vMIw@mqujp0WWz2z$GfiZuhp9-ZmH0C>6TdWR}Vn*;_i8@G)d4aL2R0nA>{Mxa% zN*!cbK3;5A87k3{h%$4aFY66;Jt5#qoUWdY5O?+PDbkmBz9|82#Ivi17q6=)9)I1> z;+jSd?FVt^8h8o#tc$_^KOq>O#R6*iw?f5XkN;sM9|W<_awoz-REU?seSlcOr(;(S zm(28Y$3W8Q{xv+w`KghGT^U9LZTb7`VHgu3_V*0|E&to(ehEO2)p<1n3HW2*qS8E` zIEQHYxemsEE(7=YC&7^aJbGZcT8%RvpNAhz^msg1^ZNKai(#gJ8~*qLTe@I8CAQcK zY{{TF7jw8qTuckam?&E(F$>|(VMlUk*yYm2YoS&cM?mUn@ z(9h2R2q2v+%MU)RCC-{>nA5I?We-&BOc?5Zs zKbB!7kQ4o!THSdhImypY&~_e09_`Pgej+*9f0Ud=9^?N7bw-m@{LeA0Wb#;K`y|A! zt7j1Yo}=c-ck?pixSham@7nE0?p_9EyPKCa9=CJ(6%8EoLIim{%{fmi%Xz#Ae{i11 zyRo0Q3c=gmm1Wmf>%1oT!{HnRI)nXDuj-6=t9m9 zu3K6XKHi!(sKT-flzkSZA;s{JgTCOQc7bateysXRpKEIx91lW+W4X6_5Cdx%|JbXQ zKl`7^!Qr(@JZ9DoFIk2FopU1wpj>Gl0O?w#F`&Uv!uhmwwU;I=A1_s8Ko@i`eiD_5 zb($|<;S^sH>|NiXN$y;)RjOf>f@qH_h3!?U2G7OexokS%n5qpt9a5+3kxRRAIHMRAr9%>p6ppU}?Sb*@(m7BKWa4C}ns1$NyLz-%9_x_3>A$6Mgm`I|~6P;VSM?W|Ei{du*0mE4YQ;_t?Xr!EgG+AE5WU zm7aU+@zp_oY{I@r9e>61Y){(vstfAg`peb9Yj79Zd)4{4Xq+F(T=v_K&)9v``F*Pf*DSN_XYHZt@RQZSkC+udSLRPb7O&<sbpIK#44jfi`EFNAfHwEI#ym@(=SDn& z;xwj?$>85)NWa4cL#<4qL}jJ{iw-q)W0 zb+!MqF5? z?%>&!j%cN0XH)8i{Gla3nkhe+1#`4g(%F>0(Mow|Q%Xf#7~G1pDP69WTF$0a3#H|- z^o&wMP0HKQROgd^tWA7)78676)FxC#EWM+x?nZskhfN?KUzzy8)-RH(fygJeIv(OQ z7*owL`tsfrP%u#u!*I-NgkuJ=}d)NF{Z>gkqt zD|~jnh|gd?-<)^UG=AAFx+h;f`E2XW_d~}9pOaSFIrtMDB(rYo&E62}qFVUr;<4$8 zPcr80?5)~{X&wl>mN5WcN)@Ix`6C>5@!C!h>dhLjIrg9~J^b!2 z{kwF-YfChgT>~w@f0EygU~#S7T_*T1@Moh4dbAvsM1+<{Q10z*`~6h1aS+*A`0&|w zb`MIUf>w5qM6^db^$@!Fc(1X});GTA$WUKC7%-oDs`n2LycBy5hmPj z!WOcsdrxZ!p2|JKwjvmf7_Ee8(^gMyS|9f6X%Fe^#J6_@;)}vHSUG)pg8usrMh5op zeM-{xoM5*qyz1S zdnv^npg|2(>85;~-_GmJYcd`wvz(Nro`VGDKtA8UK$$#0!Wylzdjhr5HcrvU6BQr> zE_AYwh9;RT;=x6yCU2s;hG}7;pV!wBP7Vuk(I=wJsjVD;Z7YY)3G5#0OFO4UozZ_# zL0Vobce^KVyN67V=9r8z-0*P_TqlmN2Dgc0V0g;{*;YOsdI3`VE(h^9yg6s*(V+%o zIIo3t4R+g_N9RQN1VC-HTZEl!QS`<%9#^6qBck88lxUt2VOFCG$7Ln8@Dxqk)?9P? zE5LV3ltYK3fNl%#5AysXTX~_Q&+jN*BBuMoZ;Tt+S&@?*1Pa$?sgAF3GP$HFhLPNK`OOz zy(!|CMmvZpD(@hM5sK z{B$uz>|B-Fj5kD$9mFs~(Y2?GDcaIO3?mfn>>!2_itamIOwq%qiz#~XbTLJ*cMu~; ziuhY@UBxACTHdnVLm|hC0^-DW4<&!WE>n*fQgjaL0*kwnp_$|kQ9yW zAck#ClZ5UA^G-f-9`PsIi%?jS~x6!FtcQX685LLI~~ zLQz!*F|;XKb-I|M>rNL_bS;~s;)aJ2igtAnBS?zaIoLs)BK99jF|;Y-E0Pq$Hbs0` zoqFNTBXB+*GyH^*dae;VvyaTmrNhraDLEm=k<;N%>MA)Q){)aWPvLwzSKyhUR0y|X zhe^Wn~t0gvq0&aM5_anC=+?xns1^WWi_nc z;p%kqWWN^1Z?rNsKOYV!$v}}2<#Q28XEF9DjN52GJmeQ^@#NmS#;b)CY*l(;+dRA( zJFL)QlHJzIq!z;Gj{F-q15lMig%8DS2l>R~6ctG6@Yfn$*47MG<5y{>%df6NWj>s8 z2kGpIKz?6#E`i5QTQG_mC1 z%}3bLETnS+dnchGI ztaFggG3-i(!0U*}@G>SkcsU$iCP@E)%P?EzbS|Abg?V(C@lfEm7k`J{gZAR;7SdFY9aLtpCg@zU6~_{!ww5{E>xIHCk?w} zjFgLAc_7Tg4i9uLSC~s@5q8G|soXh1r`9=vh>%$2A&EbNb02nF7#v%NkKBZVA84e5y-7Vs0Xa6s-=I z^*Wqq^ch>a2aq&`a$pVNG3C}Y_+Uvpv?RDXT_PTHZZ^^Z)%r2ng6yJGt_={(-Yl;Bh`kgQAw(UNX zNfFl8$JcE4v10iaRlYtv31q(NL*vbuGM8isqK&6Q))6L zx|=5G@}5GS$y@3Z2YE|ft18vJ_S-0r_sA9MUdS^c@RtJkf&=fjA!U4!0Jo#=`4l^l zb<$T3vKk7ge95E3n#XN5&Q?{>2uD5!&MXI6nUpwa0y81FtmGC3!Ld&=UG+I1E1yH7 ztP^#u$NCIt>MS5@BUUv)W0tu@f6NZLXTG8`!}xnu=(sQjo`Ah)9Gi6Bz>Z@4z#77@ zm3$!`U7{b5CHjGIiI&&(667cgs>>SPVje0kYfOuIs*pJakJlWfEDH{w{z%i6aGD+b zF`Qiv(s8c+0zOpcV`pONR$+&~+u^Wa+txyUq}h4aELe(IGdCivMhj2C_AZ?wo=V5`SvT34j!Z`oc*pi9dVg zoFiq2&ykjd&yj8npCdgMK1cc>e2(PC6Wy^%;tw_9YSZBy4a9L-%M`$+j-1XSNA7DO zup)y#ox89*Q6;_X93k&XpN7wox}kaC1W6j^93lCnOTy_|7Aeb`k#y#e^v zk<;m|9_zTqY}O9#tj?Z0j!LNujzh3jw5so}dDLN)Q* zfzX{QdcG9#Oa7=>eg%i~S%Gx^sBj(~e#T!t8EwS43wEf`>4ja%r8NeCZ24t-qm9Ax ziXy4eUxbfH-(ZJPSIfTv3=o0Q>E_sdYjq2WLBrnLt6NB1qahxk zGrnW?%gI7) zq=`J|T%TJU5uZ=Imf|dL{#M*{A_)F=+H2SmtvBGrtFz&@!96(q*zxcs9Nv(^Z!F@8 z1}8RLc)js4Wi~g&UhM1^Pij|DGp=qxR_wqYL|zQU&UT#HK0>-a#?Iu|A~9w&^1tYG z8~IA;?7@CFc0R?K@&~Y+ZIvpxdl6OJ{x^m>ZEQG)-5xb6vHgEybxBiYMPVZLqQv@! zV$6(7tgWkAoVcu^q`E#dvZTItbW-ZblFHJNOHngE?}3v@8aqmoA@ox!S(T?3|;jnuXi zt3pNP71jT5!>C_g|G!Lw%uf^J|Etze^_Mo))?oo#=_t(cL-pBETwGE*s+{Gr02FGh zY$#}0URzQR8CqYJHAPE6D2!n#UV(5`sv95%!T|EuF)*>Pv7)j8dCfTlma*a}AxJ2p z0GBRps;g)y!2yC_T3S(3Qc_y$93ik!CC@+&c2Qm&ZYnAd)fq7&&)}d^6>2DV2u)6P zU%9shuy6%Gr)9gnSdwGAZN+vJzU1O|MMdCma+C{yFH!PjeYOWAYn0rl{<@+%L9$w% z^{cY-LCNHJXTy7xC#13pTyMjz=*h)N$<6 zCOaV25owW00WqTDgtlUfiVDuQs5o?s=KKFo?UQVfexK)E>s{-sm7Dt2u6_0y>r~a5 z$|RG`5@yn4?)e0BVxsvE_dL_k{QoRq0=ROjB&Vc|WR|yX5SkwTx8Ynde}k#NY>?SsOmOb*~)Pm7C-4|DLCZ(7i5EiL%tW*PPds`Z{$luFc&<_e!N* zf88ed?_ouU{AAVWuiMQ?P&wHgM4VY-s2?jKW-|QK4dD9eCb5qCO$tsok#qy<{`VQV zd)e8_BV@c_AU&oC&Xx7K{qv3MH;#}uFrsb_HJSC<44z~peD}I( z?*{1j3=_smw+^tkDa6jk7shOS{U*L{?c_$murcZ$TlcKY-N={-TU)3v0?0ky1QU%d zw{F~K!sdI)hKp(2$Xr#Y)vQb*UD{5o)fh(Rn_I8^FX{m|HEOQnfW5u_k99@>Wmnaa zZm9k@S2RQKYNNm)NzQh~@cOU4>X{J#HO8=D>MmB&^;u+WDzmKo53c+*^|iT{XbLH3 zlcbi+-N~G_j~qUqxn|FBVT!Dg`A)Zj>kh>jXG~rEUqZ&ak@edYM`OucLWcI(*!X3~OWzdp-@O#Pb=~TTH=7t<>X=lwv0~oDnp;7DPs5BME^0T&rQ$L&TiC2clixNy5N7(v z$}Gl|0Q*QI*Y9c1(Fwe@7@M^ZIOb_xWO9RXA7G5ktr{EIP|=#Iirus8rT*fzbP!Hk1#F$Xdw-7Rsa z**vc{gr}vx(XV-Y|1aVEzw!OQl#SZhxDW3vX7r5}zEd~lEHUY5&Y)zSEslTk#m!CQ z%em&NDKeLac~`W4A(fcYe=3=^VY8aNxtu*zJ#0GupF_oW>ejV+j~e!jJZ@&}pm^}5 zM3sg!O9>u{`BZ5hw`}O(3ZXNhHjjb~3e(b7O#egqfVy10^xJ*d=Y6z}X>D-td0z8? zW?ovY_1Y`Zz1rbFPr={QN?)yY5W|U=Y^Da2)NKZEU!!YcjTjSf_Kw z$~=gA8C~QZYjD4LkTxMiHHqfNNKrvqjx!k(x=V`D(&S){?L;TSwx~!sT82tFSv^ux z9LbwfP#!_^Q<)PnjYCTG0@) zq7pQDMvAf-DG45Sxh0bjg#3vmW$>#or=<86=M3Zd#fU*pNy$wGc@7-rO^jqujg(D{ z=D=Deg2X69%8MeCbE8w~Wf@xbT*-uzNu|!j)14HTFzPs;Q!)uI^9xI&qFqz~F@lp_ zm=|%fqh&B3Da%L0VDb2n`FC2XO+jifWuwKpNZiRex4??)H&%Z7f84OEnw=xjvYhgQ zqC7Vn3rgr`0n#{9mNj_j0OWpdnS&IGAfXUVrEu+)b~%qP)`adBr(XS@e)@Mdc|_9$!2uhb{^W z%1~02pDa+wPzGgUB&RIGQk0jQSLRGE$St1$m&mX(6f6T%P0pbm*ohPrBY?$uQ(ULI z*rDWQcnqMgwhOS*XkSP?syQ<1fFsq>E|yEhxr8*@TkP@-BJB zlZtpv<}hdope@%$C`7i9vrX5HXOW2~(le4jiIK&%zzB&WJg))LAuvo>ozOh^sl;xr{)%L!iC&u=N)Lsb}==S|$TZ(hbOHh2B zT-2scZnQiq>0VOo#?igHoyoQ|M9R3xK?LDI{mSw@2?>C-MX0iwGxk(Xa803#6z5KH za!sJ6x|md40543DkSeu=4g9?DSS9lcDJ#FpTn#ysN=qYUQ;V`o3f(Z7BrmIp4fK(8 z<8h7XOIS)Y9pg5^8wAXwwqg{g<&~D;!ZL*=+g|*q)sjrqsd=UpNiX=>yI4XTFpa2Dr%v!NX`^oP-S^}h#c>Gwe_^F`KfRd z?ghGHMqF~4Ojv#mN#YFb*ROXdIj6LwtgO7Gq_E2s14Fe3#pAnl>zay=&Mp^r?=n8E zM}D^+DfwM;3rfqUp6}Ms9Bbr+@I$|vGsg75Mg|w>mpG$F42WEsIpWHpqec#h3>`dj z!0=0lj_8|G@6yb{_zz`lv2-MRL38X+Hajy5kX>w?0muzK%7!OkpM>A7_;I70+zvm= z*W<^YZ1SV{vA3K2EPm)1H2ggF^pkG))iuSsFW6fxCn07sq*VqkS^>)aO(MZag;A7Oc@jwzLN0cs61}eC!;IY z$did#~*yiIwu&oogO0CuB^dlRW@0I>Z zu&oFD@YKeg(?M+*&H-5a{IsyO-x_T7LttAcaJr|}?+LbX%oI6xW;&=14`+5-{jp$M z&N;P{8+T+Y=iE-KKM8E>t6RY~Je=rh!^vr!R)0D8eAr_;?^gO8Jx_h6*Q-jOpCaxl z`W)`Y4I(r2tv~kEAId=la5iB6*EpS1TQk{cbJt$zYpD8~}NN$TuqeN5CvU z)O%jZIa1uF`FmjN?-8&~^Up-iFn2K5*oJ31*oKF5IBj?qDt&%(n6~-jd<1Kg z)3xli&(8@X%0`Ei6gmiVVgxsahivP;MqukNXG^e3p?%J3uzvLc+kEFV2OItjFjtSE z9_Ku8qkXcymN^f?<{c-kaH9^nE%tQ#h?0|8mc00JaO@?b^BtHny5&TGp(5w-_?qy5 z2a23SQo-D4lRN->hKEDot<7oRERl2gJG?eJoSwmrZpqdyhrwI7 z31BPd5O`aUO=RL@qg%2K&mCa8rJN(-M`6$KaOAtq-;-ebOvq913p{c5Gpf^GAQBiXspUotK?6VA3^#+CB+;53n63vMIK zQSIEQLq-ubZaKc48|7qpZESITJ2%S7w9g;MyxVK`A+QbGZlzCV9Fy>SP07hNz8o%Z zueFO=v0$TLWSj3CM9+PY$nVnCaIoV4kNwN7pmIc+9cw+$bm8^1vD6 z3?ALuAL#Dq{OlS9iE_SJzt;jVa}fmsrFB22W39s+_SgL+s{v zzOS~-z0X`0wGy9soYThvQ?XF;1Ag8=>DMut9Kt#Nu$q~9DFD_SlkJ8H;1bqy>??)mEL@&DA!7SrmEJ*wh6a|t55@p!I1z@Ep8&p2Lr z#_|1U9Irp)c+(ljrwsx(eKc;vTidj5>D{H_l$?f^IJBnaqnRs`ceB|`OL8PqSZ=yqb6of22klILmWc*d00bY;{%7~WW}8o zrzlQSoI#di%Lii1gOm;{agP)g=7EPbBsP{tk5pc~nR(cHfNdCl9zH=~8;PHXZ`RmY z7Cd}%#x@o|PYD08jl<8w8Xg;OPM#3{VVi)TwNpqAQ;LTR{5-5pv6bUzb*7McC&I>Z z1GyA?PI;wHOEA|BBQu+BB}0cZ zUl$7h1$%bBQ_flO4TO2jZJ> z`o;O&xgzfjIX~h+JIUZVqQfa~D}}jY0l%z7w|pSu>M!Jl*xzsE*grvrou07sjmSCA z?+;bBYvG`Gk+)kK&vBAKG zVT8z+VLwH&2X^U}FU$>ui@4_x;qQa+_YygEu2no&m|StlkpVgl)a_YY;%sJ6~L9{x*k|k_>;j?niWu}}jPKQO#FuyO% zFrN|~&OPQ_W$JT&aab{5;H=GQBIiq5g)pZtuM+MHdpm^rvh<3u7t9~+WWe8x$nc9V zLW6}l5qO-EbCxo7SpKKZ^Yw z!t1f;Gb8OFxeW*9es`bJ*(y2+jzbPIVX^JNkKue4`&WhcV}DHeTkO9Qej9sEw5DG} zg@eo#Z2SNe?eMQd2RXWnvQcFwI3W~Uw3W}=;svEMDsPP`l>m2m7~#nf}Lwxx~$9!hF%?J%je!;g=-Lju{?Pz8t?~;jY+s5@rVy zkEz4XJbreJoQ_|bFgwF|OgTFOdkbe^-&eRLbTWl`A08mg4mP@>+pF-q!ZPGMru=IB zMhdg@>>6R-!^aBqo^CoDaeO0w<3-N?r+6_&D~T2#0WA`a+n`J6{X4 zasQ<7f3W{Wm<{5;3u6$cY2~7Q-e&?hCi7VdV=@ght-1;K!9Gp67xr8qiTeC;EjsSm zIeMe;4D5@9*-^^H=cvPu>b1h`5PeU0JNBH9P94*UD9jE>eq)4kc1-dslf2f(Ao%2< zyzg`n9d=C8J@wh?*h83|k$J-GL@W|!N8?0cc0k@G%#Opw!t7jJCT!PTrG0iH@*`?)phLFx zC%^bao9w*g$E?WQ@`dMMUn0zo%u>aZgxL`|Pnge*6~gRjTp`R(&Go|Uq~tmd^ot#w zTqc6dPR;Xij+};lH(@?cULs7t1_-m0a*!}PGP!CY-SU}}=g8UEN0gjj-lUwJl>B~- z)t@iS4$B9HH(>v;FrT%y3$xR4uP{3%_Y1Sb^0+WN8ov-eiT&5Y?4;y5`pZtoSYdWX zwi6zJeHUSNG^Pl%19FHkI}V2lvvYBTFgqP@6lN!4kuW?%6tI7PPQ zu$Sntqmj?z)Mtkx{U)=su!0QxQ{a{yY~$KrYITrDkBiO>oFWI?x;ih34m%6q6lRCw z+rsQ<{Fg902u}*LmH!uEb}q)_nBie(VS+F_5z~d)`IjNg4#IxI>^QtZm>qt(!t4|r zFU-!uIl}Dxn#Y>I|UC4vs3U*VRp{(m^$nTd{>wqd;bz<#~~L~ zqYmFS{;fEGW6Jqn!X+EY>@4JJjAV8SjuWQaJjDxyx%lE8!hBwOUzqPHUkdYmB^E#0 zWG7!6GV*#3vX5+^%`Oz3-q@!L^I3X;Fgpt)!n9vThMoDaL$-Eii_U!PZxyDUJA~PZ z_^9IN$gr~jcF5MwE22ZUbi?qo)A4)70lsI!?IO4(TepoUhd$l55DsI1o-p6nxI!s) z_}(@|m>rhcWY}B`n`CSAX3?R|*~0AXTrEtSkCWkcIoy)1+a01qw=W3uz3@|Ec6R)(Zely9sT`tTH z>CK9tCByB0xFuV+`$dQ8{I)RL9=;c5r?pqwA`ZYU*}4r~VO5xquZxd!G zeU&f=0UQ@*r~Z#*_;mt)k*#0+443t*4&0MDARr{%9{V=Jw3$kVos+Obwsv|d9j>%T zI~)XXH5vN9LZ58)`Oz-wFw8fK&MD}SgY5v=ri%{SSQdy5`$ovt&T^&mSJCl9hivW8 z7N5!d*yD0@pU<#|isONtTT}cz2oJZG_$3JQ5!P}t8Ty^E=g+!LA&Y(*b-*XF@1+>8 zFpeh<|FCiALD}cVon;QVvCO7AYm-e{HVh1phmpY61wX6LerC%Yz+w4v#UmA8r#M^j zc*W(4rz@VL_)f(u6hEl=am7z5W}Bc5=OM)(DE>_`CmLA&M8#pnofY>|oTd0O#aAmX zRy<8H`?{>ZTNUq7d{FUW#cUh2Zcivar8pMl#p>{yupCm{MR9M%S&D}%W;>m=GgI+G z#rG(FQ1K?kA1MA(@lT3l(bi-A;wS4Zvz^iM1&Z1BWaWbuvz^h(**9l-qT-o~&6f`3 zI(k^ipH%#;Vzd6g=pR;cw&hvBeo)L6_pRJ~7gyXiLq%fc?G>|~%E~hok5qiCVzy0L z{dJ1j_GIO3gR=aRVt%^E%0E`jHYqD_g?1jx=PSNc@#TuIQJkmvX2lOH?t@Cr+8?Bt zpF*|rY{hIZvU0WuS!P?1<%bmWL+)0-Tk-pfzfk;>VlUcLtlI{P&BwhZA5)aPui_z! z&ER*@XMd%&d9&hKitkjsO7S|yTNJac$J%V6xP#*EirLp`^@l3vN5QSUKykU^*^2K} zyi)PQiZ?6XrI>9&)~^o~A5;9b;uDHnqpifc?W8zeF~1dLb*@x=o#OF|%M{O6Y`!QW zdACx@xqhj&|AgY5ieFUxmg0{Tf328pLDr@Z&j^+qC~l#+gW~RrFHt;3aSj=EE;qId z+2?^$rNj0k58kc0%~kTdl$_s(w_&?a$=53RCMDmZlELlc$(q`idQIJr+d6qw8?p z=TK1_<`}Y+6Sh@Z`MF9SQt|;xK1|8Wm3+36&sXv#WYh)R*!E=oeMrgK)@0>Rkfls+ zRq~xmzDLQ~Hf7zuq4-^;&$cP6^Qn@5rO& zq+I-ZN9p{gxE1tl7%ovfO7YE#S15i!@kYg8EB4@>-rDc4_;SUiidQP$rTAmT0kkhz zo1GL7Q#?uWy^5bxd`vNx3aYW$Rq+VL?0c~O-luq<;?EVw;YHo*cT+rC@pQ$Nil0^d zsp1hB&}qxkU5eK#-mCZ>#osIDx2~<73l$GjoTqr2VqOC*W8Cl>QNy^M)-W#>s}ok- zPH{KI7b?C~@c_kFDITRbsyI*aRK+tD&sV%a@!g7-DPF61z2Z%ZpH#e4@pFo+6u+#P zZIL#ujw=36@sEnVXcMsd0mbJkZl;*+9#+4d;xxrQ6+pr z@f5|g70*-5u~ydYV#OSPW##J?^E*0L{&&Uu6(3N{F!6HVc~J3r ziaB1(>RhO}m*Sy{hbhic%rQ~c&NRid6faTCHW{nGQ8C9US^0B{IVQ=nsJVC54Omnbe%%=r&ie~#kY6|>#X>TtZ5 z|9#g{3*Qt@cT z*DB6YJYI3J;!?#Nn`^^1OY!ZB?^L{0@e0N36+f!@DaG3qKd1P4#RnC?q4-_J?<+p0 z_zT6~DgIIMDaGu6v2m}XIH)*LF~_{@3{}j294n71&Qr|! ztybq|#nTkeQhb}@g^KT0e81uiia9sd`t_9JZHn3NV|Df`ens)?iVrJhACPr>T=AER z|D*U1#dXlgYuyGFH&WbKaVy1P#mS00EAFm1UGc?=GZhb3e7WM0ipMDCxM&-G_A6Pw zQ8C9=Tlpl#9RF?Qa}>{4e5c~O6|Ycyui{4(Z&Li6;^!5=rudNJ4-|i__@v@r6?3qo zjf-D#oZ@)JA;s+5vTi#oPEpM9*jDEv#T>V7}E7@$HH^*4^4%s+j$oR?hxS%MU4jRPp1Aw<+GK_@Lr96dzX1G4s~1V~W2}d_wU_ z#itZ=X)9}|j^d!=Mv5CNZlyS^I9YLL#oZNitiJX462<)#4^e!DVvgyzZaMeH@;JpD z+i&G1ipvyFQ#?y?h2lFDuU34Y;&qB2QT(LhzboFYc(39EV7q?Qt4jW+;`bDPp!gWr zy8Tkgzg7IZVh{SVZTfJ2f#n8@8!P6V1gpaZ2rVZoPF37Pafaglia9sI+PPBkHHxoS zoU3?(;!?%8D4wHuzT&?qUaEMFV$OrGVS7~Z_%dl?ODSkxpQ;N4K-mCZp#jh)VOYsMaKUVy;;_npyTk-FT{TQcV z!yK!)q2hBDw^STbe7@o?iqjPLRGg_eOYtzpBNgAEI9qX{;)#lbVx8h}r*C?)3yg~8b6mM1h zjN*NYs}#SX_-(}>D*iuL@k=&OIX};G1I3LMH&+~1+)i;<#i@#WE52Cq z0L6n94_7=|@ePWz72l+|MDb+B(-kjLyjbxAiXT$EMe);$cPrkj_<-Vrir-TFuHvJL zk176I@ppCWaC7xJ~-SaEa3Z51agPF37PafagliZ54umEtjq$12WOe52xW#ZwgD zuJ}&H_b6VixKi=MiZ>~KQt>m2cPV~N@gc<@D?YCHTgBfi<_gU=FZ_xV6gN?Pp5i3M z-4tJ_xWD2-imy~WLUFd@e8okIZ&r+<3J%xN}E7@eIX(N8hO( z~W3>w*Y@7%%#;%2#3Kx3#Wlk z3HJbd;UWEE`f;opITKu8cmOz2co4X`a4t9`oDc3K%yi;-Hrgox_Y^J#Uo6b@=r4RL zc!=;k@F?Niz+;8)0%r?90G=Sc9$YN^D0qtSF7Rw&&V{{0ct3c#@GIc^g^z$Y3V#IN zBK$FUx9~CWe&Nr-ob$*yehYq6_#~L~A1VI@{E=`qm~$a1=U7yZmm_oD?GM8B!T%QK zT74WSOr0cf9mS1=lOg9gI_h)-v^3*DZWcm}?Jy zB+PNI$Ay0YbBrJThSK<=C17ZPp_ z?jX!{dAkU=1a}waoZyRvJA(TQb1k|ngww%egnNN=ggI}xKzIw!>GcwoHYao08%=OtQe+S$`_$W9m z%$sP&5BYzIFvq|S5v~g!Cd@g|9Ir?_4Zyj=4Z)n-OL-!g z>%WoPf~O020pBW|0$wD{@v}>XxwhXL;a*^_3r9O#>u;0rCE%xo2ZOf@Ujcqj_$qLf z@Mti{I?~P<@L^$&$^B4x0+{oNsZ$32L73|Yo)Tt#5Wv_!>aY%o7v`FRT;rH>)&U{m z72uA-tPi+u9d)?&;KjnM5Bdu~2EIa=bpzL_qyCfN9O13tB4Mr(T_(&izf*--f6Nhn z9(=nn*W~<*@FDO$!kkC`SK;@;>xDlAa~)=ef#Zdr7XAvnN0@WXUlHcIh;ItBE_qkD zIm$A}Rnkr>_)}r7dHAJpZ}4}*TnF(d;SBI^!dyp@>p#;@Hn@&(E|_cNQO-3H6NI_G zbu-~2aBJZ*FxS(gKI@E5!c)NAgjs*23(o>`tS0s6g9i%V4!&G?DR_kNyWT zag*>I@K#~Yzvoy@+T^v!v6|$&!JOYsUJiaum~-^s7G4eJSWW8idOa%qAow%khr!b3AgAa6|Cth= zE5b9u?+9~!%MXNEH*kC={o?wTTmzB39DG8U+naQ!2w8=W-QsGa)1BJPc=5S%Iqsck))aN>y9AioT z7r0RPdvKZXN$@P;7?ivD!m;4L2y;yLDq+?u4+wLehDU|DPA}Kur(en79m3tg94ARR z*W`Rnm}_-%Y$W9az??fzX8rMn@Mti{KvK^7wiXtIZpg0;lF}8zL9qB1J4$&1TPfk zm~oC{q|SQqeZm{T8-)J`eo~lY$#)8~etJQeWSgzXIku zkJNt^{G0F_;26BjQ+@~>FZ?dJg)r;0_QD^4Q-nVP_ZH^*7F>^#c0LDZ33Clpt_eW- zx8UKzr@&)`xjrh#6H=!sI9Iqi_(tJY;EBRq8}%09HsBe;9B_*aeCC@`0>5MTpRX9;VAe`;Typmk4Jru6X&`IWUdX%F?eLI`N4G$ z$Q&D9EnESvi^dqr7lJv~j=Ttbp71hovM|SwcNb>;*ISrt%4P_2Tshb0q#dpo!tr(F zbzrX5N#+=HuIWjB9DIW?$C&2|KMlT7cptc2_-*hk;SazIgg*l>75);uO88%3uB$-5 zz6U=l{0n%qFzeB$g*kqFmvCM1i^5#P_K+~gjC1T9ZL;qCOt=U5gfQ2(<=8puu)^H&&ITt5PXM1U%r$aTgy(>J2y?C6KEhltm*e8-7sreb5?%tn zLU=iNl<-RMSmD*+Y~eNF0^tY16NMiH^Lre$&$U%%3a8!dxpjEPNNZgYYJBS7FwR zT=Ri$xz_I`!f%5I2%iKG6=vPW@o&`Un!p_MM&=mj@xol2w@8?E*koa@vvRBOWbmEB zGr{)=v#$E9@EY)1;oaa(!d&lnn=seo<+wG5;WO}y!snojbF3QW@!$y8yEGo2?q0eqM6P2lCi zH-qmL<`~j-!gIlY6Rrer5oUScEzC7|_Y3a^zb?!*Oa3AJ4VYue7%z5ed@jtg{Jn4^ z@Grs~v&l6&sGkAmI59HEW}YiN7~EQzV>8h=}p`X?L%MxB*l zuKPh|*|}PnV;-*;J_+X9t<ENZpmw{IabG_XAg-3!p zri=EO&zps>1@9E*dbu3OMV&cdj^iRT58o1A3Fg=>%AWv#D*O?cW3(vedbvLeH^rXg zwJ2wr)xnq_@&#b70ZYCR+*Fv~EovjoF>xJ*qu>jLx#sOf!t=nH!i@Lj!d&xqgfQdB zwPoqo>)>(1hrs#59BX#7@Yi6jB};t=`&q(?*qe{dLe6ny%S7HD`_;l3*mE6Nx*duA zCSk5;%XMfe=UA|3g|o5WFFX@_j{7j2-Efv;jP$zF1#E2?}fQO?JvS# zVDCXk6K$RX2Zg!j?YY7+*tZt0hdtM{r9Sr@PetZBv|P`YoPj;pvnBV#K2wEhTU7390nb;Q!bM56);T70Zk2bl^?F`{9*mL7GY&XlemDKdj zHC5bJaf;$TiU%nksd${?LdEPKwEckd6)#r2M)5|)TNUq7d{FUW#m5w%P<%?USpybn z#Vry27B*}l#hn%RRNPa*X-@<_$w6c;LHU#-=juXwTIHHtSXX8(!{BP<%>pEZWwsKKoiMhZJ{K+*5IX#lsYjRm{E+YqMPO9L4PSv^uL4 zKdgAO;$4c_4`JQDt@xo#6-OU22G(-gBW!MYu)nEi}a&b|c86BW-; zyg>1C#g&R5Q~ZqL{fggEd_?gVicczL-+&EUoZ_a6+bT{`Y}V<;wZv_Zl8;n8PH~}P z_8(Y(=PO>Un0)|NXQN_%!^z6`C_bo|{c%?3nBo(P*#~EJV$p_cIZ-kD-K?B#_m+Dq zW?!3?v(4S|SjB8Zw{o_jTV|h{Www=DUZwb9#hVqg9o*_4Q2e&yql&*#{HtO=+7qoE zwntlTshI82R-UFfL$O&mSjxi~CFgo0)-BtVEwk;|@&d(d7q)V?|5|=b@iU6|D`uOl z)jy*63&kfDJ7~+Z`f-ZcmTKi~6|>*R%KIp0Uyqfuug5ai;;_vA9m`V`&sV%y@fyV& z6>n9%M={$vt$nVWVfmP1_P<#9DaEm9&$4p%vsex(?yR_{;{J+mVeRw# zQz5Q46Hue#VjvYyhbtm8m!J%#d{PVRD4+RF~#gJuy#%!-_X6-lh0};^^K)Y{zl1v zRqRI_mJJWv<1DvS%=UaMPgBe`d@EdCd~vI&iEj~D+dB+)ao0#g{BE{5urkmr;;Q(OStc}}oto>c{ z2-@V5U4K#hYWy|r3)V6AJuh>dkUF;ZRzjxjg7U#6Rjc*~}a52yx)vdkP!E}>? zAGhc@^zp?SH2-*xzkkZ!>WwbIm)AaNy0AO`$^ULCDLs0mg+e{jQc`*v^>OuP4;Y%|@mNa?;|(?8q(8AtbOeHR z6MAEvki)M%ow0@NajhLI`Tuj@<5Fiq!uqBS7xSA_@UJa2fCZQ`92>HmL>+~KJn3G1e#E~zF)QFKJUMrN z|AlYI^;~#t?*0J_{Y!J>Q^z=Q$qN&^_~`e8flc0|=rgI&?Zcy6hew~wj{dzg`gC@5 zw`)JS9#;EJioTc>-k#bh5O$n7Bif{-#;2s5JmQ-h-X6LzlsYDmn%peZCX_UxSzO(v z(Va`9FD#AjSsLBDH2VC~=(9_sJC;UwEsbu=@-Ra(!}~h5MQd_Wbl<^*iaUKN4~1Nx z*4(i+{LGf{_PlSZyVPr6?;Te<`i?&;=J`609GKwE>g`-#uS>ms;eDBvx!IM)b1NtO zP+9OvWno;4q1TMPqXL67!uwKTzI$qPUusKd;4*K;LMJ^fXC>e=C%sq4&X2ta?CzxZ zX>c$ha1+hqxUExF;M@278*%r&*w-8A?qqR1^oC{hFTHo8p)=s7>LO?8LAveWRNdek zyA{r=dO4YuIe>~QoT_Vl9Z@Y@?}<*(N#wT zs8MER$-sn(nUxbMxzq^^@xj)lfe8hfl~V>Llm)VU4iW;%vF`oq-SzV8c`JJR(whe% z*caa3?t|*89=_q>9W6!;kM79&TeZ{D7w|fpM}@MUt9Ihrq>Ks$c2~y@-Glwk>QGW; zO48z_eQyMwsm84)ZhmU?`3l@eqTr3$(dXwzpA8H|wk*M|daVPu$h4NeioQ-S%6lR;nh#wBE(kG=vQ{EYKew5OA`Asir-Eur;% zX7t&LkTWpPTTxnlS$fO4nc>|X@>-^^jh&q2O|5L38Gf#J|IGcTlKn`E;lrIQ%#^8f z*7Mon9R=PBHlC)htur~v)45-*+qvN#3%wN|dl~<@hYm6 zdLOtaF2|+nt*Z0}mU?+^?S7uyS$mf0bEkL17KRpucXy!Olhs_;4n0}z)`oY&LGzuj zN?jJX+v{W`?P<|{O{N>Sb$_caqW!>!)u=0`dXbY$!@J@d#l;SrJFj>C9jmjWJFbsK z?NasSA2WVrq9&vah)-XBeP(#i@bKPYX?s$-h2#7zj!ujIuFbsl)z`yj*AC0QS+~IA z3zeHsraT{78{XUa9f@q?=D$~zARi@Hd!GsvdJiU6jPv%blQj;e>g3Hpo(*^NY+dZ+ zb~?{c=$D4~j`1&^uxDH}e0fZj2OU}?@m=pu5&&dqyZftWA`Bf5HmbPBJJ$r^)c``U z=o#0`#xI}B8sWA6|L3>BFz>MbdonH!k8T@Zb+NZ4u9^70b&mY~zvt(lGjl1g)4k&c z(@bV`KT@Tcc(5To>BvteahS2MdgDKs;|7D(u(vAB8)$*VSi5%rJ{FI0n@=`BXwM^e zs}j5$ws|YMdR2bP^$=+9bwVBX*pxs17n7SQ!BWIK$;3N!ayN?2-hJWyiw;QC@BO)g z-nmDkcl;D+>OJ^EQh3+W@Xi)V!w2KOu?rXc5Y~MaKYARU?LAOFZcIXgpMIU@-Co_- zRHEZh1MTRr+FKQn05%@-dle?~)XAIhU-A<^p^6#gzcz^%G0YDi>9oj4sZ*JmcdIE- z=fcwttGro1dL$zMIhBRUMl7%17ORs+Iw+=DFM3SgeG~J4y5`S%E!N~#%4S@NEsxxT ziwF4;e^Bzuy$;{?1kkx=v&!a^simqO@od=QtvKXS`DCxVmpx8uc!#<4Qfq3rGNfAj zdi5L6y;<_&KNBlHtRDT3d70sz!}~kK!@GC`+7$@?fhWz>%m>G&Z}lcUczx=+IjF=N zMYr`??%u=lN^lR`kk-1-y!0J2`rtm+Z$tNSou5j-*PGSW>HHS=NlrzIGj^UU+R(jT z>dVhPopWPFCtPc(mC^Ja-l}9k{)VSUr&dl$Z(bZ|hrD?9;0oNa;ugR++{98JoxS0> zH}$dExHPiD7!whG7B`ZVUW-$g;a2o))vuVq2RD@U5ZT=DvvKooe`sjc_tnsjduZiD zmj=G8o}714>Jzj=RoqkYti3WX8A%Y=e$H+2asB4>n3o;i*1KE!iiFfn)h%P83GXZT z-0ZXuwsxzz8^IE2cx1l_zck>3yJgLwB!7DET zk1pHSMXFn!$P8~AJ1=SfA6ptZnNNI_aT#hex$h@Mx8+@5-7;>^3-P08)Ik{F@KE^K zx#8#IpA79A?IgYE$1~;CdCgnSPsOeB;n>M-y-AgAQ^U`7?4J7ksh&P8G1(HChr4L= z4iD9t+{V*66F0(+yovVouN`5ggJD3?pH4mELm{5&UHXy-MHqq44DX0IN2ryZn9qnbE3@T-;suqf89_ms=+0MqfS@ zJ@85NrFEBAe-eIacfGmcmk)&xe15Mt(8Jkqab};@8+s-6X|}SrH>;D=`Ms5pcXs;J zEMmiPUoTZidlwIO%=+$xTYG6eM zu-@3glwRayT?UOPxji6{=X*PWEO7D4=A$uQnIIAmQDj?9+skjK) zeS2QRrBBRWJSx6Le&cT&1wUw!R5jQcvTF1r^_MtKFUZ&nuv zk4H!PA8BtL*UQ{EI|Ggr1D)XPH#~|}I+I-$jJ|Ilywol8$kV*;)yPN;S&Zw+3nDHV zk5X}IsF35z@pO)dPh1dNfzySS9d!WxR#HG+lG!zLO>che1E$$e&DJG@DU*oGLBqUUqaX}Tn$^e zTO{p2#gM~6lzMLX+qHHt@kK4Gww^+AWv+MjUE^d7h);Uh>9D+EQh0ygx}p3%$?ilXS-JiN{T<>msF%-!cx6`f0p}N}>7v~<_ zRqwvwW$ATTXC&eI)6^MwwobycbyCv4Q^{VuK$<7-CV9>O{P4WcySfqA50L8^X#6uOh3%Uwkzc!7onRci6^$i9cl(bAs{={Dqq^NW1c|*fP>fa+H#v95w5wMg zSX_Htr(NCZz+=C|kDVQHBi|W#xAt5huTFK~*zdINLl&gouIp;g>s}A(~!)bLQ&uQlrIxIK!(30UrW6CNopFd}m_NxkLdG%9uKpW=8EDACXy7r@|EkC8Y(Ly?=;A5&0V?)dn^;(aF_62HGr8Fn#jD)bKY457$dhZBbUp1}KN z7t85Yes9cd^uGIJV-~^}e{7xIFzvevB3~-)_~?V*d|=#%Rzb%fhc;)N!_^iOUrB*K zW;3&^AhdB7ht1iEny zR3c^s^ZQbH2g%xfeM$_!a}xn;aMH z7z4hD93O1J(DWfE2KfQ+KwomxAQy%RTug2mY!Cy!gdB4CAvE+p1O`Rv^IM2>U@*}M zrjdt`=QM1L3=0fpm>o~Ufjqd92Y!ze+X?%dp=2V`+BxTX7+(|^@i@(y6dOr&f(;pf zQS{Uw>;N}`(OV&p4RWS(;ObYv3y?On6w6Ky{={Sh|I0XN)WFZgIp;0}D>hKZ1u%ju z>9(ARkJvL*lZ<`XVaZ7N9I7V*rJhWvB`$^}aEpfuP9mo-2c~-_BeDF6K8D6Uh)rBZ zGwwlLB1cdKW*Rr~iRh6ZjmXPPFiVw%r02Q3p1<9uMghm+q!=SGSq zI)Mt0nbnv0Io&Mq`~#s%PMpSrJB*voi5xu=xXT=*B=Qq4fxj4k(h{#>s26*9$@NU+ zg!I4?&&N3ElbFHaEH!Ewi61ba_jrE5nf{5)fxv1HlYLO)ARgT7VY&`Ye3Yi|^KhWc z;lyVc?fXp{97|*yZ{PvXA5i!raXb$yjp=WYmRw)toXhcVLg1-Vn5!Q_q_&z=uOBIO z0)KA@eSiJPWGC=6F*dl62DU};KQ8ztBl--ve*H*xz7yE~CQQW#=TK({^_vDcnkTTE z+0-)FnZer2QWXjwqt5g9;cQz|hXh_Y2u=>pW+ojt0qz{+EcU=l^$?|$`jJW5PT(Nz zr-2d5R~gDaUNlE7i=4-4J~ zN#MPEz$1g-Qhqdqu#E}k!S}!?tY^jsFQJ`Jsh{gK=8lD=3FFg*5oux$DMxB@MFqbn z_BG^K13#0~IAC#64$PrAcoCpi3@~1{K!(Gxt7})b`qQ7OrWhPu>Qnu%z<{M zAjQHPmaYbV+Dzcc&8C6A9<&{~GM%fuyebWNb2hn;fq zPAu;{oC__%O*jR2@qy8vhH#QN3g!dXcub9)c!USnN{~3zFmRnY6PtJ+{TgeW#35u< zPv`)f!vfgA3eb4tgf;W2g$vK}OO)4-N~c6TA;9F8hPUM&1r$W@i>uoBOzyMBPWrA@gMd>-Ay!_-;ZR>SX(& z;g9umi2%Rf&sAP<)CWe+NdWf@HseQig3Z9e7Q7Oi;539P*ploIZa~z7t;n&#O8gI= zM~(|Fr%r2fd~gpPg~*A)49dggroq3%|6mfiWpFrx6>LKe1uJN?ExB#5J-Ho|GH zcG{EA58lQk=s@lm9M7;NlRE`tDLXQ*L}x^sM3B@YWN{OL>NlxrOMez_{{^2-8}T=VHj& zho96I|31PSVH?kN-ZK2Z)>{fmTV|Vm&h)I|4DWWFmU;`$wKv~=AJP60jy)qg6hm|& zet)q#n{m*NC!Z%!`5l0hGy(tqBR;V(C0~gY@JuyV&PE*b(bco2KQzwgYBD&(2z-e% ztr>x-CIU^6E9dWE%%^&&IsnJ5qvrJWFqeiQ4f; zI=<~a68xNCLpBYV#nj&%#Q}4+aI2L=9>`a#!)xL@!V#V`8|$~X3%AYIn8;q z9bZN9^xSTaKj86G2#x1%bKC`y>r|9o=6IHPhQnLml5b{p9EW`LEcZ-BKu6&HsZ;i( ze8+Q-XEu&~OEypKh*t~8v%z;RPkJxxtn&Z@lIKGxqS!L``$8mUaf#X?iV)`x* zi?R{7drj4LKHl{^KFC!4tBLt`9C!Ye=GS-@8}Cle>XHNX`;B_I4ETVj5@*^b!cqYa zD?RIR$hjBc{6ZYB^*n~-mv~&5i{pnpT+8$bk9qj8=NTM&@axzb@%5}TMUI~W4%77p z55Mv|0Kd-ZjMXO3+u#_45ZBlZ3|Ljn1vxzPyN6FZU57HQe(_u|pK1DR4Ci}xT|<5$ zCZ*&i$CK)hK>@sg>*RRSVmM7OCEv(n8iUb@$EQdHW(aNH?XSdc5`66VFJ5Si%`xNC zaUc`PJ?0vz9UJp_iJyh3JI01|Y)<{9e!iis;BhX`FEe-cS9r`toIK0Tu?LUW-I_wN z9a?b0rFqEwTVp05F&5xNM}EcBvmmAt=eOcGmA(0iu<#m!+s1Rfr?EJ!sry2m34CPSn9d4NR# zC$%FAI;)(1#?f{DCCg_AY8<5giek^YfZqdw$urK5Ku~y=UwZ%ZS$@xjXYV`fS)BS2^6W2XJDYTooc)tkr^7guktvAvWJKT1kt_Us<@*Xb&|x}G zw!+DwJb4QW=}7;3$oAiH&Pkhsll~>Um^Rn@mu%#ItbdY|(frIbc2W;OpWmdu6Ly$2 zs8CZ=;mK~u9uOI`t1o0sdCq5ql{3O2`)3!|<1AC<9MlzmihJs3 zD5!MX$(%jYx05)_@Nr%)!(5K=72@)v3(md$vv2!x_7Gff_9J}r^n?ma+_kLQobIpV zG(WnX`UT(=V5`x)o@b#RxW%bgUCqSvFIl4t9GcjS`eCh(QhXAw?3K_GI*jNk*K0|* z>%6xx=yJ8BL8m=(t~F{x_=gC=uNpJ((n;m(5#!g_sGON1Yvk;8XFajIO{Fg8TAQkMXj@;|%k zXQuq$aN4B&egIRxVKXXxmQy-IYdm5!78wn*Ec64%yM2$D`%otpHK$6&V_!8_0pxNgeFLLN&MJ{lP}@lI1N2H(KX7q=d-pmy=(o5w#sSGxf+?*{37w2#|G z!+fOBXC8p8-jYiE=d;9FBa!|ts_c5N(>0$anlMUD_%hIhvF+)k^DVmGR0fjI5@*6788-aMuOFKv?qt_|9Ddf$a$*1N)_&Kc&>TIy+6KOyL= z-=cm)Pon@^TfJ?aVDRFg59WQ19bf(4!Ha@}aq;>^jwhEGk;hOTXyOS5spP>yopY3n zSdV9L0;P4s&ftU#@DNuoLFrjr^J4X8w41pkJN0@72$)oF;otjNaJ2_?V={b0RwE(<~*&;1kPx>GSk>>FJ zHAZ+gY2jQCa;h7`(B_W0=&fnG1f$iQwp}4Q%_?5WyCu*?djrtv5QM`<0R}(0tLKtt zwPAN1u5g2Mer*)!yd(TKksNHSbyC5B&Ccp94!hKz#S2e8afufliw$utq~O3L3lF*l zJ)@d1NU1hrJm`)C$Bkv0D__P~UT6vrGPTF);qPP8F}+3@WQMrHo^a;$>gq^z5;)Fw#>tUW`5PgRk86#LxAWw9Y-j-G-VI0J9b2|AY9!r7LipTG7Zqi$++{ zM!?JX!6A2S@A5f#Z6mO!&GlbvzhksVa3|W!PtzX3irQ?nO%;zbQkxrDqp%$c`|yi# zMlJI%izObxuPzTqFY{l$%+Eu*4LVEa%(g-b#-PHCahAnGhZvQ^5zG9FMSJdNTir7~UVTw4k_K?V)9#JN)t369(JD^x5euBa* z%Ea&G5SEE!@tiBlM7GC?GI4zESt8fy6=fo)y~-hx4aee^xVQE!u_kQaxpMbCjPVbEb-ggL*h@hheS5s&@C(v2lBg=V(NO}lG;P!PC0}! z@uk|c#KW~`i6?8%qR5+#mxEkBEm7jzx>pi+Y~jTP%iR_D;evf;HsM-V&fOdl1Sz5j0V9<1&KX%Z$SRN8Fph=}}aB|NYF8Ofn$^GC+U; zlMo;*SxI8p!xA76S+Wr}pG;;+24)HK%w&N`0s^uG1x1V)Nd%Ojs9aeDi5L)BWEI&& zlto0~qO!>%D(~-Gea_5DaJl!s_x=C-Gd=a~)2B{VS65eeSDmg$hegnpaJpx{Pqs9> ztc>^W)f_}y%J=ls6r7&pas_F|iflT;4O+{xJy#RnqP37sC%8>(FvaGbTG1rDC-Jz| zg#7$LSvGbxVVc4sn@&KVc(A}Gr6wW-5r-yjiOv5Zt=q-u2q#X9TqOAqCs3 zArhXZ7Kh1{g|rx_XchiZm-ri6g`4W#=R>W9>;!^L=e>}fNJr+NgeM%V;5eS@8u?kt<{D)>NaMb`J^!s-uIynolKt=r31^MUcZT9rs)HSmE}#i56JXRRr5 zATN<=G+Ar3COJT(rA+z7dY3gvR9D)g>8dKanpZ3XPSo0)jb1yJt!Cp>S_|3nDM&}E zeFXufQ^;l#P%hBDI zyQK{^oxnt`s!9YilU#)W%ue!Y1lDw}SOz?uU`6rm6@kAd@!iYglDDdI-TdR`%O$pJE#+Qse)${ z&X}c&$OD)RpRIt47aN4MloHcYoTXLq2*{!3F2A6Av`R|iH>V8Dq#AFhRZ?2)dr~tvlkf65SCVo*#-wb` z>}l|3_Ox;{$>{oA!3&IQH$U!~|JBQ{=iJP6E3_LI>xguY)-2=j7`0Cu9N-qpZQ20x zYw~!4S6vQpNOoj)?W|eGbz_xfO{^?ymQB!6*vVhhee%i0e3iJ;TDc6M_+^t|S)RL< z%Ye^lRedMmr%94NkXMUY1Pvukj}+(E(d6P3fU|I%k#=*%ypaQ!pLS2?5=Z? z>;QR-d^~|&!z-6DkAYpSE0;0RfL(zrmvK6|ou%kNKV3Vz)>ba-HD>T?Hkcn+Z34ll zxQ~teI-E^lMYu8+;mUNq@t~W`b62$TT-jZocWrcM;0a9HYnK6Qw3cNPR}RHdgLo?Oz7^#Yz*(gsg0%zd3UfCXAfknr=q1Gr49 zE=mF>vrZ9!G^4UrSN}{;ZX35ZW1ByNuIjMYc8;+1gZOR!VFCT`8?w zMyXh7tXsx&sFlFFWjyQIQLkIJUK{u2N4;(tM{OBd7c;UhW@KH=$hz)~Q2lwV)zRIw z3>chSy>;2}9;-J+t2affH$|&AZD94O+-m-QVA;DN8oD7Gx*;06q1(`18`Y-d-vQyn8MRaVoJ!t2&g7R#ZcHuW^n1D+$LT#y zdAJ+R>bV=u>}i^hp-| zzABydrAkWmZ`Cp&zgr$pzzot!4v-(q*7Gh0ewXC43G6Cc)m?k|37fam`I%9r;?K{| zjC)kjKi8_p{AC6Cb zKuA|gF#2eBJ-BqLCv=YTd7jqpgf7s=C0a>{@Jm{Q4X)%tdcfs@itx93WYN_-iIATg zP+cIHpu<7z$?$|6qYcYdd7u1Yj_KJ)h+$q5iz)B3c-+JRM0Wp?EoL~vKyNvZT{@}P z;MHub*D8H15IscQIQKtDn$wBEO+nrtB$;ooy?nF{&IIRkNx@6!^tsHES@~l>|K;Eiiqa4=e>CLKZ{kDj%EhV zWX%?f@SI#sz+~!r(^|F~&?t^_Hlx3S0XZ_CQ=YRKJjQ$`Nv9EP9q{7K|A^aYSQF(};!R z_Cjscy!!f&?;SO6V(Aw{$f$W~1h}w>FMyURc*Qs;Q%~v7@uSG^*6Pps}^f z6U@^sS~6otjvYDrA6T{Ab=Gyv8)3Fbwbs?oZ*Kd4n?`9#>3?_(u{=G;|Et#IYTC4@ zRA1NDG*a%H>PG8qXlQI2IiKoN6xDULbQU|8ENCoAruMI;z5Y~@s#UjC_br{2woZwK zGN9tk4eUF&tGT69Ma@_+d-MgA_UM+jsD6H3M~<>s*U}hRsEoAMbJv7PFB`G1xb%FFwdt53MBPo@4B?0-e#-m+X)Q7Av7Pg&YlO)jrYylz>F zl%@X#+l`s>K1A)^r=R|p_35Sm6=qV#WL`SS}uX0}MMuf@z0 z&$Ea1rAc0CX_M-)Db+D4?lwvOi#%)J$?a)t3#nUQ}BH6 zKAUUDwTt`gte}vT^KvQEkB*>QhOYA5OR+h`&H8Mr|J$VhO)2>^(}9(x1FPusBke8I zk0$V+j26;CI+K~az^d&~(J4y@lb?yc7K?-5Gg#Qp82$VZd!=+!0e2T7dwZv&I5X+z zCnVSD9}3q~p`d?tW=j5hxz_3Fn4Zd`cgwI_p5n*Tl~;*)T5?Hlsf;p8r#_cHe5QWC zqfma!$8-F%JhdO>d-BTFCzMGp$!a@+%l+6T_p^;ksvr_nbW?c` z^|C9W%qsH#ByKfv|5=JEYVG<5DW1EGs+M0V8=T0>bRs`qT>0T$;H9EEMVgA5Q>wA5 zfW34%ak2I4Q=80l`FTB5?ect5ssB~U$WCP{lVzd)6jGL#QdeXrrKke)Ys9Z03f<2I z^|>Nl7pb0m>YT2BntCtgmlkMQy4q5+;_;Mg_T~-6K#UHj`n-<#u~N8RYtXOY z(zoKCACEvgd+Ex~uU+z+TR1b-sXVPSQ;NAfzs~Ywt*}$2oRC8ub)GZIe_5)Th4kN< zlBwvkjsBN^yuSUrGg8ix=V!27DdlZid0rYyy*#f8+E&wPxyhSij?B*@4YhM#DqBmE z=d#jrtmfIv``?}?6w(!6{^@kK^72Y|8n+>HJ?Cso=~r6Cr=|9DM!xcz9nMoaic>Zy z)BK3?qo7sI<7{nZ$`Qr3D7F;&-7jy=^ES7FhRI4Qx22NWAlH?t9;Wl|^8dnFDx`B; zky^5lo0QU0YrQv4smf|RH6%Z#nD@MuD-id;ln+`puAo9XCmWoN4Xz++MrEq!g>*yw z_}QpTSIx#paf-DGs^^}c)DCRjQ>&FWXDL6f{0{5wJo4V@K9xUjMm8c4TS zD$SL->ML2Qk=mk(c`F%HJw`7-^X1mwPhcZUin$e zue?QRZ*`J)rgF|(&H+i17jt{k8JPZWSX+2>J0r>SXVmgOH%sDYATM1?-6e4T6qL8x zy;F*QZ$Q7&o;rBw%+FGO2J+gNw~JMMXuEpb{bpm${F=>EEbEiEsoYEQr=%*o7C3!< z?4F_X9Lm{S$lOAH=S^+A^3!uf6&$t4vUZhIn;(m}5=gFJmM-W`Qsk}DX{fUQnA_1# z2{kxg0I#2!lrHy6m7>cpgml{@Y2A8gxck}zE(clemB#k<>9b3oP21iiT#~6UgPkh7 z&5~)q&62}q$-d`}z2(+W@%G?PN67yf=M}Cj*~uG=k89?8^X4f(RrzCmUQK)1g`D3U zIMP0LL*UUPohm;W|MJ3=l5XC9)8Q8Oe{+decxhWh_U|ujzuMD{pUhZZ3aRnT%OHQ` z+Jr~Pa7?|**Pfo9Cjav3bPg{sOSO0JbYB^i3Zptb-tUkk`Tepc#psv*Zx`ejRj{F& zr+$)R6K~AL&aBwlT&mBCzSZ7VY+T&jS=767DJw4OXzpxOP~X|!I=5KrtYfQK>YCfy z-qDyfwbV(erLj)$&-03>H+Hn^6Src=xQSU^OG~k#UA-5@QuDmFx|SkeHg>hK(b!PS zd?WhezNyrFx-@bt#m0_~w)Xt}n_MlbFLk!JXodli`c;&AN7mF)S6^&sp4Z%2%377t zhQ|8lRvBN=o-9s1`rspr(0355P09aq2UX}kE7q0jJDXb@)0tJK4xKV} zvJRo4MA_E2w=QVW;dK^OWIE?ML!~yAchkJa&PDZ{)MBpR-qciT?9^FLr#Mrul4{=q z?Os@?gP4~U8(SMY<~6p}FUguqi}GUE*S({qF|Vzw9<`R{QYXdSoeZ@~XOq+y6zfaH z1s#p`jSZ@qi<%oc=PRa)v(%_64=hQiO+8pyvAL}wQ{vQ<4xPfb#>KgjSnE`mO3JD# zr&T8+)HR&ar99+^8xw4+Ys*h}k;_Y+Ns3;q@9HSF)-BFD_(;30ab8_#^TNiI{dCwZ zT{_1L#+NchRc)Nt(cZN{S68YXsgOKn+3Km)^jhTy)S3=RrBQ6^;;2;l$**Piu%l+y z9$cF`F>6P(QiGJOmQwAAd9@>sR>0cS);=QjkEzP(TvFxKE2i>kpIb_Gu&H@*R*daL zkwYogx3uT=v!Pk-L9?zWwH+OGEt#Jrt~c2%&Z}!}txHEN3UxVMOL--yH#MEuVrzaq z&77*dri(t7NGcFJv|>}U@>*K7KpkbXAY&F)kX*v*29qm_Y@~9K4k6mp& z6;hRhM!@NhEc8T8&d*DaYV#GiP$H)zl5!vUD*trdnj@tJqnmYRBC{m!d4D zdqiDJ_eI}Ro^|u;bY69hH}}-#`uZkHjB9Yigz6V|s@}?Q-C|mcV#|bab*T|)DxIp& z%(*^N{_9nS^V&PqsLpLUHQgyf`6{u-ANis?Zx?OV|CuS|8%N}FKJVkWa9!^ZEI5Y7j|xN zugkAYRWqH3Ms9N1hOyLo$Z)Zg?n>#<>vez0&v|iPY7L5|JX9ZZXZxu|Wk(rnof|Ie zw){rd)Rykr`LWgJDd(pyuWlP0C>3$R5>=xkySSFL0`Hsj*Rq#r>$KA&reR3a6^s-XL+c4-}9l@=*%eVFw?)ckS@{ zj`otC1ln6h9CcW2&qmw45o1P<)o99y@q3P#H*P}Hm{cbS~L7Z{IQvpJlaL z)n}j0PQyIKDQ!*d+05yaiw7Pw{phJPXG|_moibzcv;(J3-*0r^0}q;_|5DbnHV;xr zd|xVt=fofy{rZIZ05uz`l}}n&kimSYf_!(aELDoT2ccHtj?>C07&?5I!oogSs!2Xa zAq(<3S~dKY&1)(V&~bQ57(IdjUb1In0zyg zXu%Hb$2dw%6y&4D3?B~FdO(m*64#o1j+g~~Sfjs5|J0z5JB!ASk{maA7W83_^d$MB zpubqm{-Iizi&@x)U4DL$!_?EETJiE?K@TQBh*s;LAJ-bOmnTzvu^)YWpS-@^iBJo2 z*z=D&J_~Z#<;=e3_Hkok285wnUlr?XwZv2s*HK4CwzJ81339xixO|8^R;=hLEqwC* zoE|P_ArG)VBTV{r;(^AUVowX#4=R#Ph2@!hzt9*`FXLI)urMw+D}?{1v$U`=wQOJ4)2HuDIWIw=_2(!<10VG_ z=IJtzpXU>w<{hO=9`H_MAujCY&%9nohYn9Hlg zo*!K8SO{P*Lq34>GUV47y$1}AF0jLx@+ zJ)gM!p^JS!YTVrzA0ig^!5lmJ_H_9O#Onaxfv}(t6Qb7`PC9s zLrUJ4itNpgoC(WQJ@1i}r@9!od!;))lHIj3cRg=`T%l*!wu0`ZTz=g<+7@R_ zvmABr1Ij$uH5t!F7u*Jj*~r9=KWx}K#x z-6P^Qʖ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�NMLV{zfwV8mDPob_delMX##L{s4UU25Fd>T|o)&{f_YD z?5AkS`+qOIZ}wa0e_)8JWD5tP-xdy}l)V=Ye1d!*;Wc1x_9oJPe}b?r97x)E*|(Cf zpX6@>`$_&^QO>6(DCGET9c6fi`^<^i7YPq1`ROEMsLvQGGRAo)DPy(f6^hb56&~C0 zG|f4h2)avPvd#B^OWZ%D4)c*9%6`_;weQ$?>YJNq&;Ba3JENpocTb&uV+ex+37+N@CpMkC zQ5Dc6Kc33mlPF#0Jh|LSc$T~L<8r)&CJP6iNkLkj*yP-YQSeUZsmYx}%qh-Oms>zg zoAcD?-i~Lb^Jw8fPBym;S7{awqy={2zTwWN0v-?^o<38-!_z!PcHzpm9`IKe`JCI2 z);|4NH9-04?^Yh^QY9(B#yxW1uGTBRy^ByjER=uwT;OU#zj6tX=T-SvuL16(UHRkt z0wFh+{|pU7@6c{`#jdp)Vq|9vSB%3tdzAfy)K!d!Jy4P@QC%u_J5)HGeU$JCSm4WK zS&OiuiscD+$UcNj^(^7a><_`aqi0z5WaRhQMR-K^%Q`I;(@TYO*`KRm75h=2owF|@ zKZEdb+20agOL$dw0rLA3J~6uo;WG)JoaGxw#R1@bv+vcuq7Gb>eTeV_sY-2>AqYaM zI{~R^*N>CQ<&zYOW7L$|aHZni%8SYGYUBPuM1}|%C)7T=PP^TBFnv;Bg0n<8!7s+B zWgk_xD!0gMc`2Q~`atE9xrAKe%hn;ZN#CIT!8ex8AGHP86~Ui-q6LrZ{a+tzGe#p* z(?`X&2i5Ap34y`Es!b^w)deUSoU_rKx9AuSZb07epMEwPC-LvqWlJIqNxyo3`guA- zOV_IDHFZ;3+Ljro;dQr6VI|ZL7XsqmLZgG>kD_c63x3o8{Rc;N(q%Cz zWaUy3U`}glphDt^6y|IY8T^UqevSF%R4&Px(c?n_@7~WC+)1Qi#nDqqcqNrp~|qjRfTGA?O56s2`Z+*kF2gP{j)y$ zCy?>8uw755ZA*>_jqhkqr**c{lj(BYt}XBZd>YdEiDq)6}j5|3VmuL7bKxQ-Q7v!Gh-!bY^ESf7U+L(U2iSj>dh_iS|m=BxJ5}@sf#N< znV#mF(%nKD+Gf@^#uO%9qz%hft0e~dr@6~U<#zWn^tX03bJkrOy3XKY;??(57u`9i zQm4B!Z)#1E+Q!Z18i=y0JE�=`Y+Glsd;zqmRTHS%pE0hVE`iL!^`6hGZ2relMcR zt3qB;y?eFIcF$kQ=ck0F*XM{{Gfen-XX$b9S3*~+|H~?U0R5rRKiu#+%<-Mw@maV| zHLUU%QpjlWS8$xd{_oaHQNQa`GG}5o6~Tix75_7viW_Ki&mFocz@H27eF0|f#pHh< zU_L8bIIFQ3-YLLU0p`Pw$;=8c|Jzvj;Q?M6;PwEY9^jh;d|QC;4Df>iek{PuBU`>N z2AI#)7M{_K&~Prm)d8Lw;8_8FOMn*z_+0_!cSqBIVSuj)@W%uENPt;n$I|{Xz%K__ zrq2_Z(E;W!F-uz$VE&e|@V5r|xBxc?_+0^he}JzHFpIXB&d&w-8v%YWz>f#`xd8tu zz)X0V&Y=P3KR*lKE5Nk@=66PuSsmc@0lq50HwM_PP35nhuLa?J>ouJ}3@{%-EqtUt z{umw~;Qa$UC&0|@nEVL=ZVB*}0j|-9Ka*$P-0=JW9~7`odG^Oz!wGhssMi?z-bM3 ztUQj#;>*eJQ5HTaz%>DWV}Mz2(BzK}@QDFl5#a6suM6-+0lqT8Hw1WNfbR(K{Q-V7 zz)uDEHv#@zfYbUWY2_ag;Bf(-9Nhel3r^>?N1{qd2?3Z^0*T~9j{30cbex-1@M!NMxtd9k@k<+%YL*ko{qWL-h zm{&|Y)DtMTufBRRX5%xyitOYV%T4uu+5^Y;{P2S$I&gby3-!&Fz8Zz0k9HsqeYM)q zPZ(}-d`R}h;bv*0-2KVTm5ikkEP5T#Zk2DIa{UBXbsav;xBV z-XVP(r3ih9TYZ-bTN=UWVDW!81_1{1c}IU#$E+rScP6(={xILR2|evh`&z!|3R@af zj8bG3z&nduCx57KgY->Q81)EwM_0*jX#}Gg(g&y4oWaW#5bC=#C?Df}E8mU6q@j=C z_EcufOqwH(ZKFS$+%#QCb46S|;0{&`I2P$(6m)@8bN z?2w$Q3a4(>Zl!M(P0%>k!(sY=s;f9mLnI&$)Afqgd^MA0N(w~IQ4vA|qZ-<2U5~CtV29*r=`lMbw^5S5*Z<@-C$U5F zEAlsrQaJ@MJ0y4acrv-x9#3V?Erw_mC2m@Y9TI3e2}S8Uq_OosuO**?c1S)=jM*V^ z)(VWG^dt(5qU08zG&>|P*AhD<&v6#a4#{LnV0K6xFUr>crq$suP>WmjVY%F6FVeB(U@n4q*_@*QMydSom`gu%?`QUowN*&XL{duNRFpXy&aM! z;fhO1H)w|>+G(f;HQT!#lEFnZWg=wStG|e*W=vPLHf#1pS2!$&*j9H#FUm@DbIUS? z>smC@itaS4+cme{9J5+1ShpEngSz%aJ>0w<5X{blgQ3!6CfpH8`X#3fgqHH^ zkx?8gqj(xhXK(t+t3fq+l@`ln?oi!Xlm1)PwtB;V&J}6c3_T=a>V&M26&;=3&V+r; zPzmTD4FlqUyc*Px*S=km;s{L1&C{Ke&G9~BNq9FQYi`y4V$>uwkL{Y^!Ptu%yM0%2 zAI-KQ!Q)jTbm*y=xb1(P%&@e2S9=BaNX%Y3r@7d5F_WvnI(fk0h=YQ4G5NqLr?EtD zd;R*}jnlwl&@PGEV9+iJy&;M|q%LiC0S4`o#BDNYmn3e7LAxYzI}F+-iQ8d&vrB@3 zcH;-Y6@UkTd&*;;b;cWjdw?_kM2MMpG(F6{8=e?ooa9wo5Wu^N{52^4F2) zH|646V5kp%fDI7^ogBx#J+8+iS1*0clcJAyFnzVc=pzibFg_%E;&8LHh5UfNbZIc1skuUDe+Q9YNaLgai(~%sZ5 zdR!gNp{v;uAR4GfxaueKH_lLC8=_sgJM5UmXgL4#S&g5=UKscX& zq2%gJNJr#w%&{8Af0yLks|g-Ci~FK*cz)-p9<&GNm;P$)a=);p5sV&?J}WDJi@RGm z)VDZjmyjQzNuGP+<~4 zbNXj;$dp}2pr6yPlDMDKKUT4RPX8bTZBG9W5>GS7;^*|=E!FvR`lpaxJg5H*1vr9U z82>}hoVc4$c4kL*l;&hkpSc>F(`V?C%;{sx&ClsWQ%>geZ;?l!fN>4?>Hd)4xYmwK@F;UFtTczq_hqYl~ni z&*t;~sU~~Ge z#r&N9k13cpJJNv$Kd0|z)CVx9e~I+ioc`BokiO^i|0U66PT%o0Y)*d!1+Y1NtV4NE zCimVRPh}1pe#zP*z2@|15MyRX{y-X=(|7aD1?Tj!{Flt>^O}{I9Vu1YCv*C4-4mPB zA5V;}Ei#kyW^?+^Ac@WC|C;k-bNZZt!gKn+q`hoT{~d_)--lZIwMCw$Sbk3bGwAVi`i@26*A^LzPCuuAD2+0JIsMzw z@8|RAK0A!fvUpxIH&&+s^#bO;r=9Z z`tDk`IsFoO3d# z&wnM!oc`N5v9`9z0yO5$>0hZVlR5qOkiX68W5cuXoc;oo+MNE=q_H`D{x?X>j$rUL zSzDx?-ez<9^N4x%=k(Kus!Flhk+SPmg!1tz$a6z?SMy~mM((BoKz6J|Dt3H^0bus) zs!hcx>`A7hUHJ{B;)qEK$1xsAZRk>pv3pA@l>y?$U9Mfq5xl&~jkSt#CO6I%$Tzw1 zcPX#>5T`Gu4^&T9xiZ(2O-zMB?-=+n(mH5zW6PP`u(h*AO5JWvZt#~^N%WBRgC;k& z2|b~^Y#m^mGZj`*jng}1Z+|=DENFU%Vs$Ljbo8sbB1+fl zu9l{b_GY(=#WvtGP-_`I@WwN|)r?neFC%QnXq%eD=#SdaeX6WH$XtY*weFDZli0S5 z0=k-8Wo1PxJT%01MQ9=nI{Y^i9o$9f`axjhB5oTQoGF?_5Z~gq)WRz|MO+kMPCU>&&2y3$?-Fw1ek{91~#2kMQB| z2*O(f+#TTc0X{Flmj?L80B;O1pQfw~PXze+0RK6_{|;~^?+w13y9C&++v3Bq1#2>M z0?aQ>7S3zD;qwFR_z_-@<41V>sX*pS0p|Or>2d3}c=;!S@aF@}Kb|Jf&Cu}B0K0Wt zydJl1i^ux~GW=&^X-^FBiU7NHTYTDeLHNc1-x1*Z1I%AQrr+@+ydDhwS~wr04ZC$) zyo_77#bdW_i^nqqdADwh4|nUfc!!HfO-MTG49P_GH9*of%cI&oy z8NT^i`2Pl&ueTQN)@||f<$MS6*zqGg4((dFbz6M+$$|Wu0K0Wtyo_77#p4Zuj9a(G zhr4xKJiarKaqG7D@Rx&dw{D9MXP(f??AC4Z;cnd)kKMX09-kJ-W3buMx^-K;j9a(G zW57Cx-A~Nbz3}k>$Z68_z@nvbz3}k>$Z6OJADeXy8k1< zKXd5a7MRy54Y8gw2*hT_AHXSR3xJAbc^{r#&garw20U1(@`vU)?IfRKvmt zYR|#l1AQ6zh1U2QzxG&{oHM}sTCnG^Mw8HtR~W0P_-;;>`R=LSudeJ|vGyD;kv`_Z z(MLPb=ICP%82yCd7RQHVPaJNRHl4nH<>pGp(g+r9&*4s$Z=U2SpSo>QzI?t0_8dM= zLA^T=>&*8hW`%p~+?@Y%k`NMo~7}wLz zw6EoRuCS#+#qXrA3gDf^t&>00_o(zuR2cOb=Ht+tZ_ia6SeIt5`T&*U+K>9? zf2@z9r!vu$9mc;XDcZWPb!lAt(@4XrBAySltM<;EgR^~qm2VjYaXtJGZqwp_z!nhy z;}*q<|FJ~6#Q$jJkSV){z)Zyw9nuRV?)e`K=sf>pKLm~c@jK)&8sPaKYo$7$|ItNu zG5_O_6rfN32mkLT{ExqpjbC<#Iwt%NY@m7m$A?j8HXT+-DB*vMRh~m{Qnc|u-bn1G z{EweYS+c+vb1raO%PahY1gY&z_V7SI2<^`5(^^Zv2n$Nom6WaO{Ty{Es6^Vf>FWD%qz^hY8Ba_#dvtJpbb!3gG!4 zuxgC|@dNMx_#bCUkMTcX0U7^8mwEoOGryK-!vCnE3da9%KkXa;=9bgBas~Tu+SgKR5#k|6^ZDeRT?}8w+yJ;W7RPH}Zu4Q9&Bxe;kAAJpRXr zB~Uc~<6o%u{ExFJS^@q?8#3Oe1MjWI|M(f;WU8FYI72k$ro;eUJq z{ht5vQ_>dTe;h)-p8s(o*z-SlM>hTk@0G^?IFImw@jrMy+#dNKyha=U<1&>o;eWVm z+4vuIRM_|*O(ZGE|JX%so!E5vBVxw?*q@d+n+{EQ>OKGCCdB&We_$;n;eWsiO!y!7 zaGnaqTq0^@%)6Jz|3{fRM~4s-FWbopr68O(lMuQ9cwHL~o?r!_9#g%xsQ+X}az)TkP!x>j69qL`@>Cm$qfWVaki1Je=N`J+l8Y4j|F!kQ>*X169v zun@|GO&3C`>SG}k9+6rIg#(=+-S0vuNSR~cR}$T;{U9sj)n{e2b~Sc)uif%SBX%t< z8B!XhO4CDzMX4dWv{R{u=B|#06^-r9GT|R*t7Qh7!w^4e>w?@!`_qte8?_l8 zcO%*ox3@NMy*AuE z(r5Fx`sC{3_)y6lC*wE5aPR~|XJflr3e>6WS8lFkEDd@VYnu%4&dQf>kK)fN-#p1M zzpO5nl&=uKfpuieSzeSotnX|!$~?ZtDx5E^#8Ka++ANJ=^iApdco1N4b)H;Pk^BbM z0-#jdVTh-SD>1Ev;2m2>i1l$=1iZA;y19mJLf|C)LMbm|I-cp_ziU&daqeA zR^p!Du%lu0DbZsek#F)-|#JzdVa&h z;3GGXSCoDmo_NiQ7StKP!5L2<%{m*U=?WH28p=8o#&4jR3h*1;gqXK)(I9c-Hynj{ z(fkIMZZLks`&CNgH(=Y|_zhnn-18eolnMJaD}JF$8^7T}@a##F%w?BQ0?%(a7(Jff z;HGtr-|&D$6Mn-nl)nJK0pf1LZzx5mPkzJiQ~={QxEAyL2Dko$=Qp^eJ-mGj{|0z(nu7d>n~AYCE8a~STeIRBJho=V9(au3;8t@me#7&e1>-k3=7aGYI*2iT17{%N zH_#Ijena1DR{V%G#&4*`lgDppQQ?c`H@r-yp5O3RidKN%(1MKTH#mZbw{P)d!acv? z12l!VZ*eb$^85y8E5-90UPAu>>|1;W{hr_8?Aa9HH|$8hp5O2Wu;(|x5;1ct&ZOVhF?t=#*rn!d4$8c~X#eR7Z zHcV84=y7%OlF0qxmHNM7Lp5QZQV7HCRR6QYTiQr|cVp-BDXr~IZL6DGrfF>c3iY?Q zoW@!h+M1^I(zdFziS~b0=@kRE7GO)0PHbU&}RH7=KR{MN39rZtV?e00mWKr~2YNY;j6y%I;p zXl!d(x_X%mF?2OKlMBw%+0wPTO#)i>WX1MvP@)J+693gEB)0Ba8C+71E%7Rtg6RK& z!$ZN}Gu>(5+=>~4b|a=XH+DBhQOl+8U=ew=7+~To*&*%9dUst?kP?A|Knh zbZKYHslB2H?MCPe(>Aah;itvjs1Dx42nKB4f%*1n&c*dy9r2Se;5_*2*ohB>@4z>4 z<2!%{`3{482b*vF6mJQ>lMdR5h_A#!8xe6k4BCi@+hNc~MBEOcjflSZ4$ek|K3(B< z*3tM5)d3D|LChuG9+FC9yas*VN-)tDK2W{`|6o}e_@UM8IXvpIK0QW{d8}zh=eAeA z!yPIh-+h?RRgw8T?B;j*u8Ch$`OeMOKKwp}94?>l@Tm0FC>(vXgXyakMjv6g#qlB8 z6Nj6njZ@v9++4|68o{FZ4r%xalBazA@f{i{hW(vKP&F_`Xsa-{E$(obes@q)6VL1I&;@e1}~rfw$)X zmBjcC?;)+{J7D^(Am8C7DNXnenlvfMcbJDJv*+MufcxY-?4gW|@8DX@^BwM|0G{vg zKC^b~TkEb$sH)S@y!(n7#_8i=r8OC=gQ%_0w4&NnBLB0c=o`mo4dGay7!x$78-(e9k z#&?)bOhLZGQeuqnuz|`M-+?ob@Ewk!)Mn2CTZf4~hd&Tw>v?2JV|<5WQJu$kxLN{5 z^BpFVkLNp_M$roJ9WEn#&v%$fhMw<`Cavc?d=u>X4*x*L^BpSD`3m_CPmr(YJNyVe z1^5oL$k+27-VXMBhjS={U(e%uTFmnu-beVr_zu;|dVAzMTtKxv-{B&aG2uJ7YuWe? zv#GH09hQ@%Am0IwY+}#hCB%&HFpZWszQaj)>OJ4#Q;7A+cNnj;k?RSJu8 zjX{8o7Id^PkC=!9TuSa}IJJ zqG+yK!sg8m4=^8NEc}E353Y})#*iCaA0uvu!SylXb{JeABW{Pm^)cdhC}w?(*9!N6 zpCpa@@DpLMKzbR=I~zO9E5TbTQB{5Ik~d~9q_J8uc@ z!}p|bqS~t%?n5!Q9{wDZZ-n$(Ke$ntb8S3ZISC^{agD!#v3q z!+n6OPz?9sDCx60k+tf>#Zr`u1huQ=8i^co5_3&VE+=uU$KAB#h7<*9JXz#x4J?x@5v-fb8PGEeUr&C`P zNMQltCf_;;;(GWGzg4XG4@XEq{D;pePW%Tfnv4Iy9J}}rHxQVqI8KN3o)Y)`hocqi z`49C7n!Sg=BFF!?p8s&ZROj;_){|Y#fA|Ll=#&4zy6g%6f&X}o|9~0pg#U0A`N#Z+ z>riL>hc*c%{D(c1=TMd%F#f}viQSa{;4CtDdk;X72%W8^(Wd6WQM01M`>0e}Fb%{D%@( zU7`v9VIoy9{sSgG5_=DfLK6N13z&FMWzKOKjQ_9)85sXze`;g=hao61dk@YQK|%h5 zBg&Y)2k7hx|AD1b68^(fVvPT=KQYFC_$yT~dk<~I82(is2YWK`$zA8wF9(fo%Bs^Iw#>nU0R{zE(2d;UW`8G8PMBl&p#!+q%S z{0Ht=#(x-%PS1ZR=Rz2Oy@#)pujfBJhn@ob2WHug|1cBm`47&nzvn;PN_jm0;d079 zF#f|El=b$=f4GcldH%zPRmOz>;I3ukKfHws8~@>5Bq_*$(D0>)|G-lw;XfRR$M_G+ z@fiQ%3ux<;|G*7^MqJElzK)z!17JM2OP>38jIqJajh-}xg4yEt`v zE2mouBk=0wbiBO2^-AR3t;aybgdPJCRe^zs>P-zq?A|-~*)}}XDbs~{3;c#dnR=brjJ%Qaw&qSqgpLSvW2 zy&ky~4DoSv2e=ga?3y^fTWjgz#Nm%*N5WlE8hFH4Rzt|9@WX*P$w2rN{C{hjmPC9#{YCd{Ym-4+5^^_XpxF_YtK2fwg*vqphtjRmO5BXgElzKw}nrSD|*7xeKV*Xp}e*wUaQrO0mt0R~s+$=xX%4%H;^&g53fkM4RO zUKz~S)4rDPxx$tP(Wj-a3gDf^t&>00H(UB9DvWyQ!*HVSDq%|_=&r-R1OWyw_i5@8 zlEc1$^#iUWE8mU6q#+LXk_x|%zU`VLj%}kqnp~9zz;jH<$07G+ZJbAQjgqS~kB-RT zzN5`B{;MPxoZckvKE;LYa*66e`_e8t)k!@b6Atx#T>7l6ib~>s;M3F-D7PVK7e4M< zyNE`TTpP$eB7IK-ytBMG`dg2SxlLcN>lMhn5IWE|LK}UN>(3l($?Rz!9Zg?iW1?eK zOM4MECJwBr^|Xxsc@}@$O&O^WT>D&|y=+W;JX(8c=UpS#j_kavW^JnS{P~S1ysLG6 zXJg5FN4dD5dfbJFKlXU_kM}OSU?g*6=kHy*?_q1JFG#Ja{#wcD7rf{GmmkY~w=@=> zvcvcnl>_IgFMfu*ZfTHVM@4t*#M4gNr+y-k8m0(rMBos__3$$uP+N(g0eM0Ej5`!3 ze#Y5KB7O!-E{LD;83HpE4LYQ2B<}ecD;4Yc8OI@L{EU=D(sjz&^D{8?ozKrWj_hK7 z21JIw`5AwZV8YMX9i`qr#XexOPr)3Z=VzRbI^$YvXZ&1B6Mn{Wm7)+o<5V;m zKVxTv`s8QKRYu0oa4qKf8NZ_do}bZy2G7rMM1=v^r?^RajGyrk4bt~|96PDh2|vS` z*f4%Z6$LQ+6i@beGP(Emcq((hq|62R8LSGD@H6-&H{oaeiI{@?j8YoW_!*9(V)iNi ziUPAwQHRI)86!EJ#?NrG&c@GRiJF9;@oiL_eG1M%!q1pV6PbOAzvD4}#?SB=KjYVE zGk%6M7m>%$xKm1t=4Xtg3Z9>FBSkB~&p4IrJwIbKxqE)b9|-sSjO)?k`58Y!#@naZ z51pQ$!Siw;{EYk2@A(-!khTCnV=wac_9=Lt7(b(#GI)N5v$x{;8Sf-~VEl}Qs>1fj z&-e_T$MZA3qB17@40kOXKVuvfHh#tjNK%lWp~rR)KLZM0!q0FfDU6@-eq!pqeTqlW z)+aw>2c3~#{ET;?G0#55*~&8EXS9;P@iTskwDB`OLT534 z#w?T?KjTi)7(e4mJjTyBfr1!6<7^ZdKVu#-#?N3Zp71k{#Ix1-8UNPVDxVB-f9P?l zLuEy@n;!bviVO#LUH`YK_!T(u>@&TjMG*Fvzd;(v4^D*4fgn)rwu*+a^>=1O-(`2z)}I z+Oa&UJQNm~J$B!e>aj;3RF8$6%jg&mZj{>ZS|Bz=Rf6bfb(oTf$MGQ5 z>N zG>|dcpFL!l!*ryQbV+$>M5Lf>w+$(Gs4NK+?Q=-lg_R1G#HhTqbjYZJRFd8dl7>?o z^*_CSpl?~((z#sJkF}9P+GOiPKiGF;<)H@hhqxd;?2pr$x}3ku(?NPzAiW6&ZA+KM zndNaw$g`_k#w7krNhPlln#k*cAi@PLmd5h-)lKv|*RPA?{P|VQfOqX$=yQ=ieU^IKYTOg}pK8u1ZS#)T_od3|I2cI%EvT&a? z(XWweG+i5?T6fpRCsw8dz&0E~=5@zZp>fQ;9(gK$TF!NXVr_o-TczD=Te`i09)H(x z%~^<}GDR^t^~zZ~^7aNV1qaUZ;w?8>8!~iOHZYy_FtFq`;&OP9$1=!cu{q^I9*Zst zxj`OF+zxy3HOJrB26-%Tn+)<;;&$kZ$MO%2jI7VNHBo&3*-@h+3!f0+eF9ty)^iF6 zr^UD^ED3CBj{s}K9TS9~0rqLn3Gg+6%uN9%z3Jy!Xqe&}9w;B?k9>XdWneXRtcl_w$IXO1?CY|Za=j5!CzQu~C z?Kv07F?6CmDIZ}te$5OWaX8wSa`z`US2C7HFuFt==h&Q;FQ1chkIF~;Qa)ZVtbE4` zhx%@p|64%=S{!XantE-xN`1t=xd=|q*&<1>UXVG1`J9|Xba7Ohkd7v|N;u5-Hj%RF zKh%TvwR)T@Y-t3eX6dT}cxQ3z(v}`xbJ8) zjQ>lL3r=qmm(R($QuUzR)MIm;oNq`U{ob7A^#cWj?Q(S_-t+V;uq;vaD#*SdW3I5~5o^-=UxCi+^*E4F=d zfleT8t9@+yWCW~==F~AwOhIh7-A0425I$iNaRX<%)F+#HGRQW9grZUH?sOgfj zHV&DxYY5C#EYYD9N=a#!nXuBgD7Lh61+WIe5f>ttF8duJBUPI8UWAlh1w4QxWp7n3 zCCw?aE>EZ5`iPDdbIEzZCxF-*Pai>Olv$wN)7plxE2X4Ali&`S^kK{$X8(^IJ>v$t zL;A?iNiH3gUQEQo7f1xhB)zChurgihrd~(yOHjH3%IMHF+KF)kHzqqJRb#?1^JGu7H{(B_J+j4*~M#?4MDfA%uvV2qn7 zXz>4NEsJ z;kSa|+w$b@L zG#q=g!ZX<$z{h<<_yV;JnliU*$L3WIPk&vW9fzlBoT2NaM~s_a31`1b5xap=mb*^R ziZJwyQILFK+{{$zbJbMA7&k-7^o-OgdJ?5`-|q2bax5?5V=8msq|C;+sV0N7Q|IXJ zo6Aii#w?<+noq*Gd61ZMQeTi*)lM=D9+jP!x?PXXi8(iye?jU2c_!!9k;WJ|&*Cx0 z%_KY*yL@VM|H5-g>S3j+%Xy0^Ka^*7ZklQ>#tp@(&)rJpu1Gznn7KL5fEYJ4`@Gz~ zl=|uv?YbcM9G+`aHLCVwId1V{+|UNk<{m@aM^k^4f){cO_R2oyRR2cj?vZ8&wiX%eun$ZiCGANy%;x~l`+(33>6vUykxJ|e4nCp z_nfTA;c1$4G!b-{Ac6A|E}5??YG+anPk%)F(U&Ncst4i(jhPgS--isCCh3t;>R&0q z-7=}LyS7SV|3vev7Uxr~@hPs{Q6JI{#!ZXjbM9K+!{I3BYycVKW*JE)xsH@kHuSFH zX>^X_p~8wVpGU!85Ie}>C`a4KA_@`Zxn?}|se>e4nfoMSholBLK#ke6Rlbemk6J3%@m5jhq$16)1H#ei_VDfKr z{XNP#i!9A4M?T4&qwK`E!Bd&@7E$oza@Uh)xl2DT_bxofxOt1>#kfIia*pw;7&mxo za{Ci=iu2Uv_9v#zdFpd>@vL;7c~ORw%`L-Kx;qTp41syiEXq@J_<>Bs;T0CBZ z@rVSw?IduDzyxOoWr8EfOz;Gmss^rt@={K1^)A{~T*;sy?t)|7GgG7vK;J!BY6ps3ZSkJ8x-$S_r#l3}X*Aj2^Je#LfApuvl}gS-IMh#3>uR%KfHl3elpZv1!^?(dK?Xc5f?= z3?qJvcr0SC=wfBvkeJ8PUWjNndtY#UUeN9m)P?MfT!_%r+1f2*InHoM3rm}@UP(k> z=30r0W1jfyt_bEyyf_axj+n6ZU&uV6irbQT(q%WIwwbk!4bE1Hu9AjjtJ|9fZJlsG z$E7F7M@EU<o4-!*6<4vF4U65a^d zcq7bt89xO4THuGkhq3v=Spl9C;CTUtVQ%tnZpD3mi=vZ)@a6!w2Dm%G{NZ7GE(-9a z0p1Ycn*z+&G)sG5fS(QU9|HW(0P`n|rQIpOy9an$fNKL>AK>Ex+!SE`(KG$m2Kbf$ ze<8qk1^BxGemuaAneW>fvy7(yp8@7WhlTTBm|;GV8Rkoz;Wq|&UVxVcxHG`-4)FT| z{NVuK7vS#)m~Y*dFMpaE{#Sr8kZs{R2bk}d7QSDA-yC56Dl{3^d^gPZ9>aW%HO!w^ zhFL(`F#kvzzAeCa1^A%=KM~*;0?Y>_(^H~162rp-JTAa{2l!0^X8m4Eduo6$4)E0h z#@w{Ye=fjZ4=}$xn#_*^%-2Z^-!Z`Z1bAkE4-W8=0e)M6KM>$a`UGV9rw90;03ROU z;{)6o;IjjKQGl-s@FxO%Pkj3{P!207WDf2D?-ZQ{60$d;9BLe)k051=4 zcYxOi_~HOx6X3rG7$dyKF{ltW-o;qLwc%z3GL8qL>kW4@;r@Qo7GUB`kGe*J5w-Av z@;U~xo(v!DaIchi5vT5dUqv3;bgG?W9@96O^HX=+SZ&~XZMcjIxU-JT8Izv4N^Sh? z7wUuaVZ%{DC&zJbkL&TsRY@Q7;ONsWBhg2B&_@_z^#?DElKI3jQB}!*-b%4=#N0D|; z{-zUY?acYI^LB2Yz9);cb23@;-xHOVcG(=K;-Av@ODlYk*X6>Lp_`-`u6rXJsYK;(j0;>boFl7ryCQyNndJJ}(&EC4El=yfb|q{VmVM z+@Md&^$O&=MhE&vXk*qO)c0(zA5KNr(#}(g;Z)2hem$8Lsw;)y+ShzcZ#ySFoQm}k z+=?P>mALk&Qp2jEBX#nqtM;ic2&85xVuf!R1aT$ID3*MP^HQ2F!xpWm1-GfS#HWC4 zCqBjXiqnkX$x1CgMK^~`nd{7%iX%}mTH>WyRFqUJHs({5Ftkhf6wedMq)W`FC}Zpy zkSOR<6$g{uf@^>bkJCpG8qWa!NMHy%N1}L6f{-ZwrGTs>PRw`x%FVl`kGx62>8Rwx zB19|jV|8dSXR^T7m(f#`)U6^TCOv7@S?wsajth?f`FI(QM7C_ zqDi9o9jpc941h#&GLj2O6sFb#5(NuxNfd+$k4xP`qBxIP%OX+y5b}z>Muz#JsX&jz z*7#k#O{L!dqx(HI$?1C{Kx7&UWh%fTK z$-DUipM}L9nMU#7GJJzGkQd&SK`hT87G#jI(jB#V7Q8|d1*_9UU~^FsjMYZi0`vxX^;(0&V>=lD#?UF?BBq_kSJJS^K4lX#SpQh6klSohP#uH_mXRH zB8lQ8_zQ`G*zt2&;4;%-V}2W>l$(Y`5(QgVQH(N6@Gopg6r|1i|75U(T;h;KK}$Ch z#djGji$rld0@>`AypG5uQT#6@&R{N1bWM-!8$CcL*(?o3Q9+`hPr@HSiHl7Xk|^jH zk|?f4gBKD7?~>!+#n25dZ*0sz180yZXvz2UDYVI0eE+L#I!j%~4@nff17-ffkPi|C z07??!!40 zIsjmV=LKL3q^l5or8?u8%z2dDl%fq}x-=z<6lEBC?@D?BPG4CP+CU7o>h=r&)l- z{w8TCVZyih)I$PoB(g0H^o+DXQGwmErl}2V8+@R{NdOf*~#2ppqX zGo_qw;&?e@qQR6&=nyqCpP?1u3o{m=s8ig{&ex@kp{gxyq7KJx856~1k~Y!sRtK(8 zXHb|UHiEu#AZ#xc^mK{?VV_GQd{;OSoJbN51o6j#1F;YCDeGY~6s}Qtw!$A42V#rL z!<`C0qwwz){34!Vf6?q{7=2 z{*%HkrjaDig$fT-c#OhR6+T4ac?vI9xLM(q3ZJd;28H{w*9$oilIQ-!W(0)EQDQuA zG)8xZ#T6?2OobV)#D+oB2r-+lxbIF51SjKYKB^pu+c6C3D+fXbqbv{Wl4dLp;%Xc; zk3k-1Qn}uOF2ne74Y?8rx_0A+OQ;}@n1+5d{J-X{W?Y)%f=hUoaI@edn4Sx9j3KZ_ z@^>)oI)5By&4wHEhb9^3uR90gbof!HiWo_Y`O)%bLmn5RD32pb`mwxqI3y0B^C)C} zRXGUk>K3lOj~s}b`pALU&_@o$(~wt&ys#V`=}I}S>XyGPedIvAqw>d*vdG(P<*|*> zT!qRSi~dy%>xG9I8{sP9eu@XFMgrL|4A-3l5yddPFC2&i5Ki6R@LoLtnapc74w`Y8 zSmpg>y|DdDIl6No4uw3)D}sgcp0shQ=?GH=c??H+JL5p4A@6xcu!d!&;nj9$#=a1* z71eM=b?=k|aT%V=(I!T45_y>TOx2FZ*C(9t>H`O2`jlxENn?87>!l)zwD2JF+2_-l zwbx6A15t5ra$QJ+U|sKMzZUjWP*iL<5clF?M{VB=#ny44y*BGDL?Nco$vwJrfS`KOk+jq04h{%YBjgnfo0=5+|ZZ)744T;Pfhv zJf85T8_PWpNpnLNF5Gw=6Ul}y|4DqzT?iL*VqEu&&U=#TTo;sf`mQ!MvX zBvkM`FqjcseeyVDicciWQZI2SosAlag!glJih7BoC`_xDxB{MJMjV7|f;ud|fx~1S z3303rW<(Mf?^dKB>Lp&J^r~`Z)q9EVR=vbuDSZar^F6bgY1K;@H4-!F?t8~Fj8!jD zNI3`5z0~8nYg{&Tc?V8pMl4~6di9e*6 zZ`Qj5OTs7r-1_AEZHy!8B_=U}v)nJCDtvzvN*St`Fxmyqc1`8_s~P7UmwFIFX2iYt z2QBm0(`UW=6f9$W^5a7F63r+8!R(@qi*3+ z6Rg@lg+7)8!Xyh>mGn&KkXa(!gZz&Ui8;8&h_p; zA>d`7?{)D_Ml_ib|A4iC+6BOjI28#6%m`EKJ5VoC%OcnfT@GW`vNm*i4DyOSD$Ek~ z5*IVUyLg*Qy?%^)4_j5zbLf8WMo1|0+L^=q9|9iZ{eU&O^)=ve-hGt+AQ$_E8A18N zj9@N>8BvZDtG#EL?&C!WKg+w3ai16oEb1i~ceb~Rd3c)PkM%YXKa&Pt=#j)9-^LH{ z7kRUohZoq-EcX6JcfFwt8_6J+XAlcA$XF>3wRt(b(5LF#r$Oa`{KpxFm{pPqgV=w8Pof4sEUJ`MqS#RiZhQr1 z#1XiZkkd|P#0vQPruQ3du;X9D0*iVHzVd<@!H0>=2)3@G7-g314dGNTaW@5gm68uK z*zx~F%fZHy2 zVG2!V1Z!Xj`weqH;XqXrMX}T2TomKK$PhmH(gOZwJgIP^C^iu1*zKr*oX_#kHOATA zoNLTq?s`;M&h2d2F|tu|?l_l_N@;R_xPkCK2+q0l8p8c>%6VoSAqQkR|4j)6Kf-Bd z?$AmMF}#_;xusJ6oPCEb%A^@rq6 zrF)roEDDl4jqYQ-k#ygmc${}O&bd{@6(0Ap%bm`mR5}Sd%>pzxz;%YQpt)C+<4nU* zle_UM_z!y!Idl_zT4_q(z{yR}2V2?T>|Br22>vsD8z5U7M^Wr#WG?w0@(j)i`-)Ld z0Vl3uGQo3edI3sPvXnc7^-GTW8d-K>Y%gur#K*htYDhu^|7G zLNwWEyU4Dr6eu8>O;1?yDQxw#tj-j#y^Bnqu8xkzw$4;NwisI4-m%7TdqCX@?pH|D zFi|_8{soL5=BA;xvz94$H6v4P&Fyt*2M|8#W$hiE$?SN%*|jZ!%7)r>eP?rPqt)Ml zhC!M`P^utr&MKtEBv|40uCQoJWix~Kr>LiodP7*P&=JzB{*XQpW`g@>3X9T&?3o?x zOoN2YgPgfrnihuDSc4`NWE2l1C}zu3 zEw$JX3vt-ZL2#StRS^T~UC@rul+n*MFeAs$MUUgK-Jr2Ha>E=1H`@Yz$b1@P9z6le z&|$je?Kiez@q&5^ceug*M+JVQceddG1^75=Kik1PCZgmAabr$xB?S? z;yzR1ISQYkaJ|B3DEvi*uTc0#g}sD=1n;W8P$R5lO4#eV_!*P-D$9x=Kh=T8=M z!k6Zw%4I48p@L&KPUR!Z>^2Q|V}iBgu{4Hr`g%^1;b_LOPKW(xXh&ki?>IQ< z^4N9k9d!bPfdvXp3?X*qzJtCK~1_MzBW0t$d6HKI4dp!vtmQe$%zZ=CF@BWaABVJgK|5e3{`@+_V;bA<^gj=O-EpR6I8Nn`Rr136*%7~qD=NZo zLX{a4yo+YsKZhI5dw{ds0pN0hZ=kkoUxwqS%v+8qk`Kf~TT2-3jm9!x&-i20|{jMvtaz zuqMy8o5z!(HGLidNo#r&4j#YV7h2Q(#K-XE4Ya0XX_@x~E#&Bgw5HK0dVC;NnSj>B zKdFK>IDyu*0vGSEh!vkmm_=*4iOvUZQkMYx*G^gw`}D4s2;n{M0~p&FLVvw5CIu150bFq8v+W zx`XaQYkH6w2d(K~L<}^s%pnw76Y<*q{1P}mmwCnlYYr~)d9;w$l!q&cL8c&}HF3Qf zw5AJj32JO1q2ry;3|LyzXDH!>OW~gIHWPpPo4}+sQBs0S>pZN;q8M3rpf#~_3J!rB z(3-deY!$u`iozFGS`2b(a4p$_prkb=k$a!I7(-f9Arn2#Jsy2)%zr3jN%*H`EcyO9 zj3cxrc5@P+jnDtzH52cg0j*1?PZ>5Ox|`y2$k?2}>_-(*CS*7Pe_3;4+hXia3w1+*qp z>pP$|y~nDuw5BR%EsNIlpO7aCU&;}3uoq*3ckwof!WXuxWI!pp_cWwg<}GKK`^m@~ z<2}Nf-1;c+IPXcye~>&Dp*2yy(3+UbY+BQQFmI3l55mv#zR9>xaC;e{H8JjNk8?0W zYnni8X-)H)hi&gd!XmGpd3b^S%wlg5-8HR=cV!UEGl&HlWUS=~irOT%6kX;Eh+Y(9 zbs7#5n~REItTw`CcnxN(qS!i|2c8QtEV>F#Cn2?LVVH6_uu3vv5c?@O7#b4`Y@RJk zYbrz&Fm{w;4vRJ1-3NIuA;XBYrg`x9P473_V8^HGrI6M%hEdAR!$evWTUSwxGDC$g z*HXX_80;XI*zsSd0!OtRjzcgJ5vOM}ZB8!CLECEt%x zXp`~r{m(MbOHKSzpNdaHS`&G^pfxd0sPKiB3V#}XmK&c?;R}62g)g*#*2J65F2fX> zv?kWT5HhgL{e%NI`vETo&cQA~L-^!N3-~YNdA~XT1wn?A(wo!IEr)a(jtbn3N&N2* z^@7#k{0X&M$bJ&A;0W#ylyd_k%h18yNS|Q{-OSLV;5D45Q{g&tAAlE- zcG4<~8TAqza*Mdv4wL}_@4bZgBPVK7-9y*$4v5bwsltoRz`b0OaNH8y$+$BIm%;m( z%Mg0dIin{g-XmQnF~d8+n^O|OXtoq|9kJrJQCEx;Y?(76TNzB&7Ca*}DrJ&NrOc>M zrHsdPXAZ$l44q6?=wu9h=*3c&bQE%EwpTtA5{@)$#!!)Z zq|2msi6isxpvKrHA7sB955^F6viL6_AnzrWZfFM6tr-jNAAm|3d;*6)6O^!Ee;#8a z!;2+qPB(zMLta;Hi=joCF!e3%;Qj4Hd5~!X+@dY$jBzulY06LoKmb}X)#}D+B^&A^ z&5z+^6#oF^x;HS#3p5Fg4P>OrFfstZ0CEq9<_*4Dhvt)@v!~9G%}A#XTGFx z%qY!;{-fz(4gH_l|jTTevM6#Ls}p0kyhr3oEjQp+24or%)+%H zHs9Le$~^g;#I~jc!uZa`{1HF9?K_dbbQGY%n>x>j>DCQ#H}Faa|2U} zgW)M}y25xV#FnTy!LS&zCdn)c=6t?jj_yU~aA3&;^W)kZ^ik&QY*uC2qVS^%KdUfb zS*7f6Da?mY-1GSsg4Z^hAqsQGTip3go8TISk5>3Zg}lOaC!kmnkFlIwi zo1b4O_h%J;N#QpYW?w9F3KSlqaJj;h6+Tws#R@M|xKrV^3U5*PM+$FM_*sQtR+t|w zN}eN_vk_dRFg4wZ`&fmiDSW8HTo;h=rzp%hA#vxNu;5D+=IpMx^Sf@r{H9DW7a;^c zq3~}MepTVWE1ZK4L*kYwta&;MmHQHf`KhhMJxAdU3U5^SCWUWP_$La#uJAhw`{h^NDkFeTmL3h$@z{tC}h_&9|>tMGD#S1Ww3!oOA6=*Yn{L-S|2OCN6Z;+U}& z=ACerets0O?N2_X-1#M<{HGj3cN{cFs4)C;QRLJTTR9yHGmhi|%_qbRD(*!Jk5af? zVgC0?c>ebZ#%*z2o?!StEBWF7tb}=leW0xqavKL&{NEPi@pH&?q&u3X^9PGj4Ci%= z2LS)oV#+4}k>UBD8^M*BV*!44OS}&-&HLrN=>PYblmnSGvvCME4t+Q!83%{0CNo}O z*~IX^&@lhR)i`Kw$KZhFz=ZiKwm zaHBjvvy#8fz>LGTPm?OZsskTLYv{*gi@i#?wRkvdY#3f7+#SHYk7Bq#P?cD4WjLCL za0sUT?+B-EZ|L^`{B$`=!R=r@upAsmOF5nf*77*1zYuO>#P3NsXnA8GkKrh9XS|r> zA@6w+hO5ZqRaHNhlCk;)M?Tja^D`~hH`}5-Lx9eDWS-Bo7?C$|N=4PQWXAN$iesI-i9dPy39c=a9#e0DgoD}7=E$SAlhD^z z*X23JYjDRQ4CEhqC$71)Sgy-Inbr=uE_DbPa$Ua9SaX<|DaedfB5x-MLouOd&P!sj~F zns8mdMR%*h=WgU!xGtoY3)f{XvE{lv&$yQBaw^>qVqKJahRYya7sDM9uFKyU!*X4o zVvHjLt_wdr2)Qn1X?TZRmsgR5a9vD|S+2|N6n8u`5cBR~GM4M|0P(JHT_8cYE*G(i zJIQBoyqY+0mywS})fzaJaHt(}UB1Y4M1@Zt0}I#XMTE7Mgg-fB$@gz%o`vf&jd6tQ z@&;2DuFD@8Ot>z^4AvvpWgvqI*ToQDgzIt~^LCM2j%uz_a$Rnr7ek1Jdkj*W%u!m-^ha$T-MF+Yl2m$O+c%XQg` zVuf56^DGP3#W2D|g%3jQfa}tXdZY>;!*!`=r3%+&1Zz^bE(<82+MUAW{3L^AsqoQU z7tS1nT$f82RJbmSC`7m}+vp=)m+!Dh-MB9QM1YX%asopO*M(!Ykn6$^a-hQJO_MV! zsSCL-943TZmrIy}sPOqMg9+D#vnNpDLje{3ql_b5mwnk!v>2ai|1A2n8p{XIb%`0a ziZ>9M9NO8Mc8YU~_rssQcOUYW)1SN)$Kz&&IRl7eUW)D|#0hUTBIWqR`OYx1=W+&_ z2#CW$oV$@*;g)ix#?2+9G0JQBT04T{D31L{THZ@h>`#!C{3&mKKz12b1)RH)c?)=1 zfsj2Em|da3l(^A^=aJ~b!Sk@4kXbYZ27_izfyvNZMk<<1a(hn8sBHNm%>_wgaQ!}a zPU2TF5y#Bey8kFF0GGvu3kU1&PS*a`q_I}mlHS8(f$D?w#B}S5#?~&o0aIW1VG7oQ zpy44sVb_@~T&7L$P*Kg$9`;Q#sz3r=D$v@IrBfoaylmI=sfxsCA~CudQdVO`Do|*V zS-dyu972u-X)o0I0G@^2d`PPo!4^cQDr`q2>%&&7i{1aG+uAeqLO`ud1(v5pYXuch zs7+S3+t-LHP$0U&=uQcuf6$E+)S-GVcLyz>TP;x?i(OIQZr2^FdT09f8z{|aY39Pb(dlCLXv$K!V|2*iPV(b?>i<9$nSE#sJ10ZY zkv*QYf*0n>W-8F;V)c52WPnU`)6&c;Wf}^9LbV=NaR`)-^uiLb^<{Vhwy_(Lkj12_ zP$p0_#QdkJ?}xx>8tTR!$*hYWam?|_Lz9&gswPZLj&EgN%{@tuUz!|0FC83BZSCXh zx|%^~zd>##kFZlg>kg{c@q3e}ZlRJ{Zol|VyLR^9UnG8=2z=4@_rm$}V7DcX^3 zxvYkyRG?DHC_M>?B};2tTWbx+2?%Y98eniYL7}ipkWeWO6A9AD=30nip6tE76o163 zPBLZAE^bC?43$*bbZwL3tqFKkhcqt@D#t38;T>AjSPS}y*8O4?%~)+$<~9bJaO6IV z=9fVAOsHE3!dlzg9JHjMIfVLhGP-WE)mMc|uJm4ThHny(#6&YrJ)Vm|b&^&>WA#T# zAf#&4=U5drtLjZRWp8ULqpQoRAF>*IKGJ*^jt?=oGvh>Df=R*&={2pLwRPBK3F>;x zb(x@!#+KR%EzO;c9knga1Y<-0+v!X&9nXZiblSQ$G}d*Yd+Mld1u@8k3tXDpn%WWC z_}13dbwH5*)>bMFnh=m)Cj@DjL|1n*w^k%9 zV5hENIlCDSW5j$C^}XcV!m~M$i-PIm&~Sd0Q=4LFH{6u$E;`fYrsRJhh>^uf;rJ5< zFE1evg;;nfm~IbwD8zeozBo=Z>Os~aI~881@OcVfqVQ&gw17GC zhd+YKfSHWGQtD(6eA=FjIEL;xXcnk2M$d~4pQgK&bC$x4BXTfv8Da(%cg-K+ymfDUkjFR& zW7FLcALIpuA&-OeeKhZv#}UNt{hVYPIGBGLu8Z0#Gj^7phLg0!)i`J>F$fuqE7yz} zpMD&la6MPcBS(Yd6)_@jEF84Fxd>DNH_GE!L*y|(lt(w33~sC!&i9MF?i`H> z9vt#R#R$C2#;LX*8&&=|h81~cj08K|2+b?V{5;J2i=jLoTkKWBRbh}^BY~_R!*%Cq ztUUwz?&j(S=nPsKn)pk9`{xHV))o|o<&Ax_tFUEo97Cu9OPChcf4}mozZ{n0m6;>HZ zlBQRV#+3anrK5L_#v+uJnc%a}Pdaz757Ros)!0Rj#-X@*EGy2g(HD0C;8nI}c%x`C z9F1S1yx?d|M*wg%w!#k_jauXl91U)53691O>1g$l%tUa@(U=Ec%h8z5fWpxzK#&+U z;aQHx8i?-B(MU77KpzSJ4|dGa@F6+mXpm(g9F2Tp;b>gJ^aFh)=TV$+G)_UFkfT8Y zRlybT7LLY&^xa+`$!icM9F4UI9^ib>?5fjej>g@HDIATnn9%;^taxt%vDHVi4GzN5 z7=}k(I2yy51G~)Dpu^f$;=q?-$s)Gsjk))ab9`unM%NU}Mq>O=f z$kEsb2?c(}U^yCGm)RAL#`%yV9F1SGLM%sveM>iv#@`S$rad6xIVrqmjw~kl7pTjbj+g(fB9bEl1-&D93U% z{>m_xqv5l-mZQP%aCSu>$y1bXIU3Y=*%L=&3e&Y5jk&~@qp_BGu=+^8#Tv8vNY11C zuIVEgi=;n_9E}YumgQ(%fjovB4f8AuM}rdzp+1s!M(JH2$-4|D9F6^1^TN?+q@~(& zGz_(Eha3$q=7$^&qoPJQ8q}v7ax@0AQ3yw)nhAH~Xq<>7Lym^g+aw%~yBWGieIyAA z6@4VvGS8xqgnGO}jz%LhA{>o2wl?8tEToTcH27W+ax@O4Wp{BjhUTJ3IX~s2M#KMf zcOy448fJ9n=2E8!4Yg%DbRW*~PX)jT%dHq`_CX6+70JDE?{lxEw18C+MBl@z*cDbq zHq9YRCkX!7qk12pj3yB>Dp1XnFi;(#XcQy2r%@!c<$o|V3M$QtIQQecE6PA*G5G`j zM*kD14y4O$(eXZb6kTmtVQ<(aB86Ub{BTu$^v=)Ws(V;BnI&&7=IX_8y8_>Bqo18@ z@w45oJ+e%_`}gYk7$^b>YMh*jfVmND!_yNlfH$GX4S0h6P{Jj0@^NI9pUdPVPt-0= zgUFLvq5FXQkZx=j%hL&0{(~|G+qleAs$9);XE^ja+rwz#L*+dxkDEJlgN+2XM4u5J@ll@ zW2E)xg>#+cM}&W-(*I@p-&EM`Gc3#=js&!tvL5Vu*-;A5SNKGQKdW%F!kr4QQ}{fE zFHv~2!dn!6RN*}w2~-Bm9vvG&J?zo35!AyT9UDPCeB5pgNN(cSjvtR<0&DZUWXTikb*^Y8>GP&hb)`4up^4K&*<##~*f1B3H$ zG#^#Y!)^Wt%XxSh^0@ZPr54r$>zwO4l{ip6;X3Sbz}nD{W(E%4YR0A6Q8@FT9RxAw zg*cBK3k{kDP}qvB)j;%=9GPbGykqw~w5Mt&mrSxGcxcI1ig4kE?BB1YQOQ zT`#Yy{Bc|=`7>i4*qL{li;?;Acz}7PJRV!@Rl?nh2dM^bVkBI5&cj;>*B8#ixIS_o zO8dxpsO%%>VN4%64-I|fJk0JR=V3kC{aC3yTv>lKm_bR^j>k*Gs@mpGY}nE(=b=(4 z61{UCI(H-IVIiI;wke$5TL9eu0Nh|ZV!kZVWH=Acp}gQcOhbUo9xMyd$$;~)jF;>^ zSPn&S%Xy#z1j~7t#DKzi@DU`&od7N8VFg5Y=RBOkT(>ZRZ|gu;2)i#f2IhqsVx;XItrxR&$K!7!Hd@Cx09^YB*) z4LJ|optC2=12KJeV4@oQHdv0n2&#JSAAp!_SF#K`+JWkRzOj z=UE{;<~;lXK|{{NUMzxe9?YV)a2}{lE7VKzm5e3dH|w80avlt?K=e|)%{an&*vfMD z$a#30KEiqUI^&353bUn!a2}4Lk8mE03K8Kvyu~62=izwXXyH73jXuJ8;2r3h^FY0k zA?M)@R-SMkau`QA4|6EG8|UG21n4v8!LVYiUWzlBwO%+6W0|1kJj9qs%X#=7vE@Ac ziD4|~A(t{O=OM}mVHfmLa2`N755K0I9`<129=F1ISU_w!53865%Xzq#HD);vXV87u zI1i;r`lHBsIGe??oQE$Xk0Iy5Jj=p)pe~`1^H9eqy>lLnDi`5AOk~Xq=ixK7R9nu& z*C}m>oCmULLe4`Sb0M4uquWIEQVeFJ5YB_yeySVi;W#82avly~`oekm4%6?E^U#k% zh4Wx^0SV{9aOFfVMGG5DkDP~->GSXBJj8yB^5xu9j)p&UKfv7K*{UU|RdLuVc(}QQ zG=}~_=DeXl)Bp(mA=pP{7YH;L;gJ|IB^LiUg#{;!iDUPW_`7#)FoNDxcw z>nCo%UyJ!>eIh<=Zs}@he4h#mcC;sodChnqswAMZ!K#ul5|(j-z8jmx2 ziXN0od~~=F=5uqdi|&}^&^Nk-t;Ic*h&Ia*33MQUfl!xGupuAMXTGqv+Aw-hF<>-v zyl*1JN00t1)Od=j}3vZNzi2+k{uA;y$*XpEmsYt}o#qpf%lwp%pe_i!Ng za3Ey8aL+y?!6US1pOK&*euMW6X&Za?842oS&psnTJ$#`1jMzW7x5;}jud-OH1{RKj z*>l8(>5qvm(E%}#*oGge@HAo@{t$(kbCHR;vk)_=xbG?-;u#D~BoEI63m<~t#uMWa za;Wv47|XN9d{p@m_hFs%gVX`>9OQ8go9pVV2iEyVi4VbV;b+_Y^~Q%-gmxqbx6_#8 zaAujRjSXA~$Xn6}KEzXy)fYZQS0DKhw<*5C&iD{t=_4QFMaU~dnR??xd>`_-5+_Dr zcRoZyt^0FqD(zr1FypX|(0m=4r|xGl^y9I`UM1Wkc#vu&ko9A@?tF+s@Cf?Chd8{C ze2A((@*$4tBOhXxs+XPVfH<>{e267|@boLKD0$8pVF&6MYU zo$znW%h7ao5_55S9!DNeQRZ|Q66u$S9l;#{JZ|t7vpaYc5+Czjgo`;*s?U$jdzq20 zp|}NU!2DRW1%cuN$I&U4n?#xgHv@wyK^+p_!StO-=oF@wTNXsjGb@0G5s~mNho>+l zzQEv`DRCh@eJqc1nLaTJr;RvF){)SYz+g)3g+#pvkb*EJDk#M=CH_Kp%aj<6PC%Fv zWhjm?B_hOj2agLG*D@v6(cLm7UZcA(CAcz8rUX~sz4frf=MXw(a1cL|cy0grj4_va zcHI8c8E76Yh?^LRD>VR^f{b(u#v>sxC2pWNQ)3GW9gn;72~%PNC7f^*+!LPJ3E|T} z240W4p`^s^IPtI|i(+@fGN35N$|<-2a=?`M1F-iRE2NXq@z|?pv_r6ElyI{@G9|bX zgkQ!Y2veel892>dj(?(<|8B;T@Ndjm^8H7cXJJZ=VghHm=b++!e=2>1DUpK=giMM5 zN1t=t?;%)nFMLwy#LshY$6sfe{}O%HyAQ%L#y20c3sYh+1qf5ZY%6iGNvG1EOrH(z zFA%57|6dm268D#|%=GK&bEyed?f)lzE_Z(qpIJWd0GJZ2_Syat=K5-v^*Yxd%EDdi zR-o8V`&69>rUdKYMcxf%$BZPt}(S%|ZrckKcOsyAU z>Nx(ra!865rdB!e?-M4x$xP=53xM;zb}`UJXouJzF7dl~ zn@YU_jC&7TRnjw>L+-rwB3yqj6eFR-6k>|H>2&6Hpx8N~7oVnGHOE0afUei2^iJ-LZcQH<3&kREI< zDuS`n9bxW-*I>pfid}*8zzuL^(N%Cd4Jr?UKfo}=tddL^#Qp;uOqa<5n`bK$*vrI@ zQe4Vn4R>cEdnI4NiA;$``1|Hr9&NDWAIJjB4j!j6O1WuB2_(bTRTQJl68@=h2aj7R zfd4(v4nger(`h-_SaSTOv{btX!6V=Q9;F@X*1}TkBvv(C#Mcf z3DYC{55gzZ4lx2n1yh1P3I7O6Tx_D`BWH9hIT=ZkDRC3!9LDtPO?!9zpD=WT%NrZ> zZ%6Xj!Go53-|WrPWGueFnQ@ky_@#a)Ey9#AY_nz)Y>fX+3OL1BD*R@M0aJp~s{Cg9 zv=~dZznYd-W5Es{yxHtBOrdj;W!AtD_8aDY!r^Yr(FmX9s4w%bM_xfuPD`<&KYY|Sx^qgnr$yc< zXHLmP{Gs(LQDMDI*edwt7a?7Abl47~Fe4C~NkkLe8)Hrh0~Ik4Q!O^Z;<9T-e*FOUyd^^t-=>6e6_;gQ1~{5 z?@^dLrb<4aRrqCv|Dte&uN?M17AeeS25}#&F!h~^JHK@iyi(zd6~0>GuPgjrh3{7Q z=L-Lq!Z~Aj@)+PK>V%sM5z8j1qa?mtF%%I}V|24s=s$Tcnc$|F{o^zUK zfyt+!dER0?Dh~TMx^p6r=A+89C`AS_ab?!mk!ABg&#}h@<{1a;gJvcU8Isb@x}+J4 zgSZ+84fpQg+IVj~i{nk`%!z5y@c){(nsrFCqj0m}Cvg~V5song)=2)k>z!yo{$?W# z^M|Gvmbd#}8*AbBWoE=0N$WV+b$M@wyuR=(O7gJwAVMHRV3)#7YHJ^P7WtU_lX~X; zVxD+C7l+6ObYAHr&tfLzl_5Oq1v9^)ysLnPBk52^d2Of)RlVa4=in-;U0&)=LxKl zw0O1Mjq$k+^VQXG1WjhAdu_Z0p2a>^7B3<%&^yuD(Ad(5iN4vjw zQ3e*OJI`WTjq~v6{K)Xv7eycbOU^&vTNJ(E+@q#$s=9T3bl|dg*GF%Oe0PkqE#{nX zj%u<`{t)_zU)f>;pyl54}gpjJ34Q@f8ior6NtRN?EC>^qGJY(^>N;NY}w(C zb9CaS==k_Lht!QZ(c!Q2{=Ekib==dPd>1QZ8M6XVcpG0srSN{>?7o1r%ZG`BXc`8j ziMTocWiE-6d5Ofijv9&N-V0ka7Uz6rBxYJ_-O zbH5s#$R6>+6MTLPhx~#waE?r0jx!BQd~D0DEgzMTvV-qysOR zEwEn&J95h0#bXp0kKGQuR}!b_NnViaovdY{=Za>QwPL|aQ(V@Pa>8XIvjaQVu+)-M zLM<(Ms8qcs)-SVWZ5$Tr46oZ^X`gUQC0}T1A4R!yedm7Vsi57nqpE zfd?-Vb3wTN1V?9*39yhC39v8>fQR21XaX!?8)X2bg0nGReu9onRLp14WFyYkVBM7kH*AhvzwCqjzE`?)^L=mHh!57Duugyu zKft)@5#~FZbffV+^o>|mil9~^F*kY^R+ZdnEH77FqfuhxcN&NwZZwfs5c-|PctPxF zL}9K?Q5M3Rm@(R+DkQi>taOHP^Kx*GVsPPF31?b4bT=|#N2O-1eyr?hZ|_{;tYlBw z*51J7E-u?S*bR6E)&aKvyfm|{lqIJF`w1`4?Bi`F$j!-wXOA8vWUJNL$xr5A z&!k8(%%szUYHzJxeOD*M196nzVv4a_G5_GvT;9K`G)>CUH}hVH~1`O=*|K+GsW%(q2`VLw7ccVcwb#(fE{G<08r zBZ7nB>u`vC=`$GSlc!BO>#jL(yvIrq6U`b0qjxg*QG997$yk7*S)+g2|&Oc9LwlMxr5+8!=XOuhtiRsST!RW?dw(?;XQ_dKRnFs!N zip(h%FTr(xi}@tXvY4&EiI@Xz7-HGaoAwe2=aWde#6GS(xZf1bU>q*;M#FztnTr{v zFz>o+hSkCQn9TL`r#lM-!+MZoDdW2;OajeS=FSR;ZCwpg?tHrt_kEN* zIe_9mRk@pQGfmg!I43E0((WX!He#E%GZns?*yaJ*4D-zPA^E4bU_Cd-dn)ewo|Y+h z-ct#~7Z<^7uYwO#c#gsg6#lfrpH;X{;ZB8DD}0v1XDiHCCCS583U5;QMul%x_y-E# zt?*A3eo)~@6n;u!&Ra+xexvYj75;<5|D*6<6#l!y>=H#LS?+@Q)+dfmzqgp}_f?BW;QD8aKZWbt7LUjEU5nW#u|6r2{V~`1h}j<( zTRat*JGs$)I&jkBgMjz7_z>U;79S4G`eb9?}ud9M#9|z2RlSFURt!%HQ`Rrbv6uCuo&RYP2hjN(ggs1PjrctYyOvi5c??H+gRCFraZD*~ z9?&@)jp=y;YeXKexb2}CgK=dA9Qj;R2Ge4Fvn^_Qi|||yhMO3Xhi@J$Ck2!1=G@yi zkCjvUJ{Rv4AT?xy&pt=KLrsYt2XpZ^4Y+W|UD3w(-n(gUg5SOS-c6BhQRkM(I)^jp z!(T_3TOxNwFC0+*&-aGE9^8W+&8L?^y3D8hCas_?;}HqnxnVEs24|P=; z$36icgz!6$U>f}^hnR0MFx?*R;fZG^UpDUK+<1YS8!r?OOwh=89QclipLg`vbLClc z^aIqSJcO6%fM!y?6m=3j;X!+aHEf{7f5j1TZp8V+p6^X}cC@bnQ6KG~*9qT|nGXnp z$yZM329vcBGr8-Ub8cQgxI1QQIBKSH%>*(0P}=N?&0U?e%$k0+)3|yDm-DTCpTFhg zNUFBJvl)8{nt9uvCUiSH8o`cFH}+}vR%(-yo9b;=`Z|OAVa&*4p2*}GYioxdIwLuz zzN0;z?rd*w8GpG(+#CQqJFF@EZl@k=YGHBFjU(KNoHxubK<*rZW6YW`r8 zY|uCsbvCx8Yg2RDn%bS?7aW$VIb^}SxyLU&EH!t|!o%j*%w2F`MZcOu=HQILF!GS_ z%J^brYL>kqA17YJcg0~2Qy&!5I5qh?Wk>A+L(4G zbTqcqPH1SX>sp$^1U%YTfN?vV30R3}ZN$|4gy4&&3C*m@Ajay>2`x}_7+UbL)e01^ zyUD7?_c2$>Dx_i6MzTgB91iHw8tuF(8S}5to$B0EK1W3vv;EvEdTV7kcgp4=rWk-@ zHI{{cdz?FUq~)XU3m96+Z8<7hqt%r7y=K|EYw8jk(s-IOwA?qQU|cmhn^ak%o3xJ*ytaxBNV ztPj5X3uZDh565!Kd>gYanB^2agxJ=Do>yajKF)Kc_o*^+&PK}kD6rJ|Gb+sQ6@F8N z&qXtqxEzHF=I$g?hjWxW=SSsUaE?U6@Lf`Hhr(wO+xq7Q5)#JTNBfAfElC)*CCUGH zl>42)oSUJ!2L~~p5a(wWQ`93Cvt2xCF=ewJ7@qBd^Mb^D)_!L(+t?p1-WS(5Ear3Y z7mN8E(0mwkKS9d9pOefV4*MvY_aQ#3Vgz@eo1sd3)|q*Bab-B#C*aWXs$iGDD8TS9 zajeDFbc7iLc}sAmJl-Rb$7h=I=tgr&a0$=!qnUw&e}TP)n}skE2heH3QB7ctl(+lb z%zEVS9E4&1*lr|$-REX*h97xTVgw!s2ga$k9{Cs|Y=tM~L3Aju4p`za=sdJLK5t?K zcELd~{Z2r^lLXd?-wN1ux=(pQ|HyQCzoZ=J14|r0XC>tQFM&1UcMj}Y-rJD30dADX z{|u3LIWXf?;GkInk1It8?1Vfv*{g(0pdr@4O^k&5CLCDrV&))Rl~{0PI2u0lf@xoe zaAs&k3yk=EA6S=TJt~9s!E*3lSIV&!SmFRW=R;l#fi>cHFYH?0We~=2l*c|q}Ht0GT;)b82A2 z*=*$>XVUI;)n#)GWQ=~O1dy`!r|_O8)Udw4!>P(Y{O@_!OJ?T$29wB zVTOfOg4b@%sfy+emhb$tU%RtjqeX7Z&faiM9wtgqWMQ|^g@Tfryk=!Fllv^^rk3{F z&YkkF@O67#OQW-^(+s^(ts0t_;tkAX$|jI`b^mB^ojB5?;gu~+jJ!~@QL_0+<1{`0 zhxk$q-4X3Ph{C&FKEX!sw=|6eh*j}i;6wC`u_ zY>`TJ;AhDg^bcN4W_=^gEN#U!A?I4V+AM%d*UApsT!TbP+l!bN)!*PgU-fO{}+7pbS zUpS9p+KEkzy_Oh1|#IC!gj3pWd4Bo3gn76;qB7^X|p{k@WU;8+&s4=~K% z3BX$3O|Uuse&iv@!f!atiL)O5(m&p!_rD%jrf`8MI3S629Ht7 zF5y%s9+D%{7q6xhOG&Jhs@YgyRmoH4@1BG29(Ecpt?a zgK#~)r}ADhyqNP4j_pj0_&opz=C#^-Jce?}{{jEk=tuk0I3y0B!|%r>ue6IF=eV@I z=hS_}J3=Ur@0il&0Udr{{yc#-B9B*8S!g!Jq2CaWe6A^jX%*u@GFkFo$AipgP>jg4 z-`_Pgw>9AFyJWK0HUCLf6-i@y|Nf5e%-a*UM7G78hxZ$U zFXYxokE;6o)`a;4?}Vy%bN==oqweS(l+U@mgPwwdu*^8S=i%%wgu~yBL#9K(TK=PO z!rNm5FOm2w=8}6SF7ifdUsJ<(&?6Wm7GGs9xxd22tmRJy2-osEjO7bB=hWbI4UXLK zgkWEVLn80{IAgJ&Euo+KsLp#64w2EOftZ#10CTbb2FBQz-erUZYY7kFUkwe5?`}L9 zEs3yXit%cxrTH39W!`(XPUfKTN1tpPX(M+sYw zZx`f|52hH8Ek&Go>>1!)cuns9>09Olw%lMQvWWCe( z@NL!y|5;Wi%d^X~0)6=kD}4PAzWmC}3+(oftadViWIrymH}OMV>1V^1NeFgj{7dAO z22I1@0$lgT!6%T0?!*Id&|Mx7y7&4KRA=LAES8&{At%(OvzOhQI%-?7?yeT%gLU>` zA-=Y*uA^~fmiKO$rr5#qJ)W72*1n-QQsm8qHd3s|+vXWOn@&00xi-%JmZc+3;%ffsfY~6}80apt_Ixj7 zKV|k%F)(M~kazB{DSW5GKU0{4B?b zgLg7XizGy*#rtd4$!(Zp7~bZGd6N9F)eB~}1naqkA%dt1zIY;t@#YtRgL_Wv+f*DRQ>r-%r!ZQ_~tuSDpOcJ4R`?Katc)!HN zEZ~ruxZ2upOa$+F>^B&ne#|>Zv$RVOx)@j+`q7NT0TI21V;hk;fDYyLl)p)E*ZJdq zO0(g{{PCVh{^+LVodbKDau9f^jZ=*)4S5G!;7NJx?L{8jq{IPq{tSz&90V@y7Vb^7 zgDV)p8VOeiyDrDW`0IEbZcLZ|B9iVZV2K0hd=V9%B(O&OI$+oGeuM|P3~rRi`z7)& z0G2p_&bJ`%{}EUte&@liRS3s>Bu4!Byy|jPqcRwd_t)rOthPUB(1;@KM zTr@C#%ebrQmm&_gcHy@R-48w|JDQ_neaIXY>w|`Fd_2Ux3J(tJjyZb|^6^7~%{lXM zVD5@KMlpAF34AekwHg7yrg#Xp%-j{f>i~b^NOQ>@!b>dvdvnRH!Nts7-GM0K+|_Gv zjmN$Kr<~8>l=~`9??m<^M=;Tfwio#np_9j(5gA8Zk@w%k?6OA3UPGo=Lm-BdzRPp?39tnSu>BO(+@y{$WgZQnyw}=lQe%tBC3$y7p0C<6& z*)aB;z<#;dT_^u~1aq(Y7F=j}&)kji*oC+jw9&Gu#yay>x*K`p3YXyIZdwNinj)6Q z-LxFgT~IVV^usJ%Mpz_VMpJVC!wJi{@0FQJ>~B=bmUqH+z=`x4I}KiO z(}CtN!oM&R7i>0?n?3VJ9RCb;YwUDty*tPJs@ckasZM+2kG`($2qW^DBL#&ADb#`G! z4Dao=pn*7@&8>|F2OOG=by@HXTT0E9E_E1Tg&nh6{KREAG3K<;8SQwMB}ijpMrOT( z=AUXvb*7qHJDn6gQZ^%jr7PXs2JU~5x749oA@C%3E+ge9h*jGl;R2bIxX8#2C(o>U z{-uqbDcQ|IC%HYTrU#PCD*oSKuB6e3ZmAEFU+Anh_S%-tRFJPQQGVJ|+nQR@8n9uu zPo%bWMXQO-?4|J#g%e~MP7j5wYHVE2#M?L{(`0w|Fclb7UuGh0cMy;4J!ox6wRbe& zpWWn**)o;NavRD|dY7jRwSp#fH&Wb-px)HWhdLV<{D}pBX6WrgBQtb-TG4-*rLFq0JCf&rCxc@4ZsGSpb6Ywd_qzRMk3|xnC%bJe+D9qpeJHEwXPf5eSTx{rQ zu$;E%9d-BTTUf^QK9?sqHHfqQw>KP&XUz6`igZKbu$^xx8AClr+C7ff78AyzI;2w$3!smBsgDTj)%pa z<3_>!(-X{c2~H|prtlbr$0^M5uf(lXm}7ErpQ&)Q!m|{ft?*ohk5zb~!iyAMtndC3S3g4{o7KLw9 z_;!VVr0`D^zE9z;3O}syV+uc|@Y4!Er|>p~UsU*IgPbluE0L$Du?>jO7LsnYM^70*>?zWhYtN&jt zHtif?X!P?{2D_xCpPiY?eKxTwFRZOM*KK| zC751+#GLmi8-^G0yAYVNt8vgQ8W7Ceu^em)p40(K(C{NF!-vc}2@R_6eHsl@Gt)A)sFb*B= z9o+mHMzDr{JlKEhNAy7SF?>eEFbvI0I0Vz)g>Y<7V#MzSIOuY`jB@b4vK;I`q+Z?v zmNEy!ay${T9^D4%sM&l;ffIOP44z#5UqtEw*NF*M>Oa2x@5 z9|zMyliY4?p#q7_fx8%yXSt3T^c$*UuUyBfs>u~eV|rg(@R=zTs?sE?zsbY;Lann7 zQ<@3qF88OKEd0vV&U*L4$oY}+iQ%uG{%3x6XX<`O^U3A#59W<4oXxnIEIZEbBLFU@ zq@2-#iy=JF3-iC6d5Fex-$41Jk=zBS%BY*O6@F1SF%o%=M&eU=NyL9h$3(8_khoeN z@l1LJ@Qvhu2A;9MFm^GYbWA!IAV}pUMefkHfF{{z1N9rSz&GrEPSd zPMq-ej|0yj&i9@|PU8m<7kjr6&m{J}Z!!l55)bwcq@06@OTB0u_+a9sQ_SZq;l^hl zjELUZNIpJ?Fc=%ek0f5(zmSsVGS8SRE@Pm1w8Ze@pNA{Ib2bGT=@k4L_`>*t3vmf* zY$2iJUCay|&qQP11(a~YrEpJpzajqgH-XoqZYU{n15P}w$fDRyunZ`Qv2qHyFMA@M zW|_TTL0Y_%(DB$8#Jh}q$f<#?gqy;@9`A6I$i2Uf>92Gd!14J<8$ZoG9(`!c=LD;@ zB>d|$KKcInjB|#GQ|zQvb`0bB=pGf+hD#VV8*b zdF~D9Xv_Ss(PzDTD=cID|71E}G;zlHBPrk_W2x{L(&u86PNhGcJ{#OS5U0w=jJFfN z#QiZWGyM+wTxx<<`}gwxT<$&wpIJWdK>RB72UxuKS>E{7F6(u!&oOxXT6ZXl{j~oF z`dnw~;6?v##<|{o4gy~Gn`qf&M8Ar<{1vPPOOW|x@mr5Y779}+)NQ8L3$Zb6{Ci9z zR+w7l#J^9N@YurRKbQ@i?_I~N-A-Isn5t`X;&=Qfa_zCW7lz0|%aiVK_WdAYVr;}`!CZmM$lZ{Wpk5b}d6D1!xWAKteNb=bD68BOx zc;99E^`^Z${^<b&T~IK@~h{090gHg# zVkg77D8_%0A$;M7@Q=FjzR1kM@m5*Hi<=R|J*5ef93j{xTm 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 z
    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

  • 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Ð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

    |XAEyM{Ji1qhF>=Ps^K>c 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

    XUKTcb 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�hoDmIHcTCQs;OPltmJTacfYcYBEBM>q3S)yOrq z=0`8jkDjfFV_D0p(e-OrHnlN}TRJ~tYr{XDts8>+C7zr3D_fVcv4EQ??HeLAG_BHr z96DuD?X;P-(`HSXH&1iK|DP+|OpFXH>Z|!Pn2Yv5$LhV6Va=-6*0xovnnoXXP`*9UvV8O&W5#QpI(n}?M=zf+aoHXd$1NMZbmf}1 zlSU-{{@ zwH(hEg<(TJPN*0%%JLdXfDWFb7&>pJ1lk!s@f9f@)PbRg&v($ndnR&1;QAOV0yqTb zL*6IA)dv5|UjJ7mmV(YY@4aLsX!=K;_NO;|pSUPh(1=Z_DL1U`94Tr3GN9Z{{MJz< z{+wdC=)4dUG%-^0~V9kaF6YHccKbxL2?DgA{`>92N5e?#f@I>zh3=J9^TAy6Mb<%K}{Ssl0P;2{A2 zpA_F?(%f*5m~?-opEl`HO22H<`T^42q{~G^UX9W`aL~UZJzF>g>R+mKcrcL9uMZ)R ze`=@n2BpIT1OAJBeqOvgXntL*G&rQcqI9)Mw|_+`yngBbUi;cui;jwwt!wHkv?ozv z83c4ITh_Sx*XjNRvt%>xF82Rv@?Nz0rcoWg2#*r&o6jJDgLgpNs=4o76jBba2^7#}ZBO^hHX71HIbQ7mE%K^uwU*daFf0!r(fC z8T%Zaps)&Dnc$N=4-4E6f=49uk9#_c)K7YRo??D1p)MA?SAvHo{MUOri``qm{*3~K zC$5ou2wdjxqaPWb-+G=E;sKZC6Peheg?92oH*!`h3tZ;!yE0F26CGUU@4^0_ev0Ve zz@PW@^`e6VKfi&8HY+RYTb9h{-X7-^a|GK#rcQWvF`vUieW<~7H*&aVIYQZSVAV&M zpo6m1vyZ{mV3lQ#afGrn!M-f>jIz{oxWUXD$}&$lLfIu?UzYKpY_;N*2GhTkr9U}B z*%QIOEPYDZ^@>k7_#Cjxo~M{2lszBp%U%qR@U4n3F?bVLWv@}p5z1Z<_GLd0kMKQ; zzhv-jV3oa7F-ItS7uc7j3}qit{5^vo0;?=^j!^bdurK>dc!Zx;{Di^Jf>rkSiaA2r z7s0;l%kT&j|J~q7bDOfP8#zMRQm`+}vx2hZ^SlUn09a)QE9MAg^I%`L0v_Qe#Ul(J z2Uc00D;%M071)=Z439ADP1dOa&jhRNEX5q5>>RK!J0Bilo)PTz6L2wo!rQk(R!8vd zv4g=fuPV^_7ZPN$OhFD|sE)X|gU*jhkTVH7!W5?H2zaK!vkhKo@X-b@HJJM%$Z0e9 zG=tAG_yU7B8ho?CUo-e;2LHz3mkfTxU^K5ndw9PHn6VC+u@2ZN>G(cz4gQV6FB$y0!92Hv%mD_or$(TUGk8CPKVa~3gIf(g z&ESt3{56BWYw*MW%ig=dc~w>Y|L4qnzca(k7Z~L$7X=-L+kjk#ivo%|ASx&-0wP`k zxhprhC=@0tBAWUj-U|~=jZDkDl4W7u3-g+3S(#c{`IwcJmQVgZ?|t_A&KlIzp8EfK z{=a9x=FEBTwbx!}pMCbZ?eE^}IR1s>c6xxb^6ch#sN?+|@YyC-dB`&os(Y%$GjWinD_He z=L=%;^1OPRlYa}2c^`sf-fd3j2{CzjUj2oW|JHH29{#L8J2>9m@i@l|9AD`83OJVG zS|`6jOc{9Y-GV$GYrg$s{Iuhj;b`Yqu<{aKcl>9^bgi3CC&%@UhdOR@d^{YtHPgxG ziYYVC+e@8%mE&_9Z*Y7S9BpoL^6SOezLgzJEI&Q==e~_M>wA0c#h+Rj+Z!I<9MB8em}4>&?jbmo#PuF z-{SbIj`fI3@A9GVklpM!s46LS*`8Uy4j0?W>XR6f+YN`}FrR zIUN3$_%D%p*XKfs{6R7AkMJX6CaA*n@9r4+NpZ)>&xm)8`~z|K$j^)WME;SuG4hYa zdq)1LnD75$|7YS+k-7HZ83H-;rVfkzTQTpX$bTn3Ci0u&X_5ado)h_P@q)tsjA-5qo9Fr5*O$2jJCWIEFvb4@Y% z3dd_4uXh~!reb+FJ2}?^v$NIlHpjkS^c5$6!|^+gt5lC>lXKYE_f__Fa^DX*+R1$% z<8e+t*YPsPs~vM**>WBZYlZrOk!WSLK-9jz`Kc&GVi* zP4Z|Np5_Fm$Mb>TkNJAQm?T~HgYA<>y_}%MWlyeGLKP2)F<9EsihFxoRRQZ|0DByA zv&S=m!FBg)D|r5bP0?}ds;uLZUthnG|qd!-SHz6ePAiut{%@z+r3b1c`$KF z2k8MZSlT+py}iYwblsMW{b09kKdu#99$|93>|I1+43@?<$J@J9_G;BQD0W61|ztyo<#E$l7sBY%8mL}`X4pLO%_SXWo~Vc%FC()iK8 zu{xiZEtQRH1ie4oe`9sek;$3i7oUBqR@ZN>tMB>{dsb85c-E$MRWDX0lk4AAx-jDFPCpbn5#Tft6UpI&yEQRmBUF$t9Ta8=k+fe9K#mVjo;G$iarQ;K3Pbp zoTs5HM0i=M;%fU#ElI2I=pRdUQj>c^>q6`7S2IkseqI049lt-|ibz+ujo6ES zmn@mSl9^CTmL(r|eEz>;u0p87<^q={m@uE@g9rVSYe1|s4T@{tu~`c>7?8Mz!Z8=Z zrENEPCCp%%p=mbDvPoZTFqET35#DF+ke?KmC6l#fE={CcwsNsv|Nn1J2jB`wV6BE# z3N{^}C<&*8t<`qI3C8uKUJGXs0r`J>SUBI6`JXf#yk(931LMJ|Gz;$?zs=pYIh1E^ z@JfR6aLh_kUDUX9G>7ugd*8S5|RvTg6rv`F2{Lf{$5zT3h(3QXYMz`J>! z)+{i$k8ZGZumRUZJHr2Gzojxq`<~WN1KC(k#3u}3}H5Ty<^&}$p<*5{iOU;pbcBu zXdFPa669$GF*RQk?p>VD@-| z_4X#o-WbWSM;)5IA!6(!Bb=PAO8-eCY~Nq-L3*R5Yk9~wUrPfJgOzVT#eMl0A7JIH zjA`ueWG&v_rHcPniv>$NLIQ8^71^WTiv8toKpOT=)M9yr$=QnB1H@oy%M~{!i7`{$zFHKu*Y4>?1l40aSNZ7 zy=@lJ+U!wZ-rfVUH%T(=aSocj8^q+Hy%XqN5@)cVL>DCFnDo2e?c3HQ! zb#l*y3HkKl{I{Q~N^kq_6F($&>#fTk&bPkx>zkf>?1?A7zJ8Z=65KX6+4fmk-E`H~ z^?fes^2RP#?XphefF^(GFG}fG-Q^9vOmpshQ2)X?O0)h2c9Xi*|FlW}QwCvvo45js z1oba)FI0EHxva|aJ*A}nh0iP2+`rI3TB(0wv0|Y|A#M1Ikbt>#Be6UmPHax7Sh_?n zmwoOdeM%*hqq7JVTq)OfyWb-?NlQ|dyHo#L5m#yGyr{|%spj7gwAApASJ28XN-XR_ ztScA1%*k7;hlQ;#)4#HQbUCyNW&7y84!)ydI}ceJ;ph7n=y|ZN2HhOD?|HBehF00f z&8w~Zp~k$V6`H#o%9Q^-JrF8fn@RzOX)ee@1kz@Q=OcN3Tr51A)9Y%wIlp7B2xSrp{TiX!&A1CWZcu z8N3*8*S*mz)tA}z(o&vp_M@W~hQA#=6x9ZAIj05BJ>@~8BK-eE)W%!Rs-PJg34|o$%zIGgN+|Q>V?Km3|2+5tnn4+Ci^7WX z-P{&~PabK!r&ETvq7~7VMX7@HHngN=N5aBIR(T)0v*rW(R7(96nFo)l;c(!`Vd~W6 zLpnSDv1al2T~)*uhqs^5Vba{863X|%JwRDT^#QeLU;kJ8TewINSnKR71?z7?&K;O_ zUQ4|et|kOzFsC(gt|J8Ga8V0#t|J8Ga4#*$xk7L`g1J%<(1FXeAm_rTnhfay%+B`rMbv%h@$2GTZuOWUG&MI@FYnI)aO&Ye{1h(Bnmt$_{}u-1-u_I_7;j zZKZz-JX_k_D4xxYcXHebjyAi9y-n*&XmI)i9PjCv{WtrEIOazdlZR)Mc&R$U$>+kc z4D-cShBJ}tJ&tg-7UP>7-wQ{ZKXm+4$G?H87==G-F@55;E$ZD^uSg~4N@w!+j(2wK z>%WJS4{9be=)v>6(z0&UNZ1#Qpl zZ+7zA#MWQ6C9=-qZyt$^+3!W>Fg+8QbCKhP9oq7Xk?CvuMdUiIUyEF?_3tBh z*ZQrZJv^Fx2(0l*}9gaii$h29;^C3S#+z@$;xPN5Y@{q_Jlf5Ey zPB%rKEIu$YZG2qhsp1Kdr;C{%$F{f*@H;R(M?5p~Jn>19mx-50<~p+~@(S@;kv}C~ z7x_#vprQL4P??{`okc+@Q2yTk;g03s zk8{E74H07>8R5QcRr*gFfqM|;{xChR9ps6JFxWGeIHa*2=a~2dS{i^DY(EZC-0#OW z?Z+6&*bmBM`w_0!id%S1z;FW#hO~cgkNGTpm54o=F4;RtY7f;>IN1 zsGa3rV8PO8Yks>;I+#^TWV>8YBcd$n3xX|Z!nm@wyT ze;@|47sn~hpFU@47^w7N{gcCo4j%MT`zN<`)y7l^t`VG_yRgS9ulgp>Do-YCT5?p! zwi7m;c2vhM6E;mh>dFBJYR3w#E^Jj8bzm;pa9vfQWBs*NYtv-IjY*+n;jF%Q&mYmb z^{Vd`229wrVy#ZL&NGIW@fFO|cCP)ZYT>4>x6ZBGwD#-++3&6OwJ)x#eWJeZjdgXq z48E>Bo&1UaTEDLDyxfP3c{)RRtxs~I%1V9ef67Pd(l6*AgTDzV64WR8rLd}cP{miD z<59+)(q^k+F8QP{X3$K=LVV zvb-0Pig8NJ%}mFLD|6)s->Y>M)mA=k1NfjUmLG~VY1LQ%9@A3Izj7I?JY9-4Rpkfq zj98e9(XnhiDJ+H$`&Q>zEhRR$N1fx&`l6VR@nNYI zje{kcY@6Gxh(5+g<+T1!u|CH4j8+BOKz

    *fH_)U|)7<7wwq7!6)+Sw7pgZLu30I3r!CiZ2$g&^GmnJgjvrK0}_f zL!@(YIC<8j*GR4OiM;D{o$Fp?#)&?Wce^4DMIQh3i98JSE&hVYg(1>d>_z0Fu$>`A zE`$0+9uudB6@SQayEy%pA|r|eN!bw8nu<(V&?oYqP|D~cM?jy*quR$5c@)wo@~GEw z#aD@3o$}GO=Zc&$`a~Xe@JjJC@?4X?AOo)!dl1;n%(*d$omylH~6}zhePk`T2V}Oq~la zBEOGTRaf91oWGy1Qg<&*N9Vzt#0`ZN)Z`=I6Zb9r3j2?~Dz;DLVc$NHM=9+Sd2Fkx za5wg!d|mpZ3)hnOslSQs6M5tvQ{W1ae-8ceg#qyM%f*ul6Dh-s?A???_>SO9TxE_c zgzp``jJ`gR$BIVMf&J;gj&ul77it&U=BUn)f#%{eglNoggOWOut8MN~ z)X$X}cHOBX>JZg$MF*xznst=>841D#lN}D{R#_Hrqb3mIy7s=wE_O+Ks_gBK(my_t zcev7v;p*2du;w?T)jc%WT=8ilJwij`6M3|*wmEFJ3-^D0A`jmN#S=Mb`vy*mn~3Ze zA{E8&5otag6{#Y}#3KET z1AA;psVZ`9$sZT8@QFOs+kIPG;S+gyEhyg1CTE29o)qhe%uG43x#C*=*C+Cb6pC+P zbasdoi^mh06Y_U1{)jwt!?wE@$54=YL9L;98U{`Zk;dXsQcez$Va1`O%ny;K;(Io}O+TuiO4E;p1&xX{UtFOhHS#(pcv!+GUCAE$xb8I%(G>v-CS*Pi%Zf%dQJz z?1_>fuk@GxFU`>4qrQ}^j|xwYW{+e8ngY5S8c!J)%dR+ z6`FPV+R?xBXO8~PFP*!z{H0SL=e3U-@qr(+_|g!9aO0y)a$=~pk&oUOZJHy zs9%=AiWiV90itOt2P>YzvIOX`EP+*cglzFa9to3!gTh2s01zsl9!WCls7qMXr-IQ3C9IvzMJ)y5<#*NWTPkhBZ?)N%Ycfgp3+&49JF%1N zv7KLtHu%QeC0u3>8TPq^zw^P7@Y#Ui=zMDSp^^9b>0Iq$&O&`EA=JS1r8Am8MDP*5B4XZ* z_4S37v-I_uMd3>eVX{Q&xAOOV<3mkx<~)54WS**CRn8IM(^>Q9@iBz=e9~jPkpLg~ zEe~1!*L}pp96^7auXf1k^rEHgoID;cT$F@?0t*&tv`JPW^YkH!1>q|#+2=$wsAAco zlc&y~PA$w{$gh$*S*gnS5r+@{M905k#6$czNA{hS_x;4i`+QI1r&uNJq}|4uLqlqZZ^RYAMr#e5Mx4f!rQCkpI2$7xU*Wo3&*6 z{G@;Qo`UWpniZ9OVBy52OQZCE)U=wGN9jFdE~u;KQ0^YnkiOq{7n-$65A|6Rz4yBa z9N*^f@xP1U+Zfy9I5&s)em9}moG2|oQz5i~gc0gm@{ zypQ8U98Yk}dx33tn&Xol^Bb<|ob7m><4YWW!SQX5pK$zR$G>v?C&!E%w(S-icXGU| z<35f@IzH6#(T>k`e2L?09Dm92-Hz{f{J3L$wpf{e>G%(hY4WCn&nIL2JQ>p&X*|d= zzM4#qeSwVUhNn^Nv4BuB;!XM|H$#Hj{oSmj1H67ZreKU?6|k%Jsk&Murcp= zClCH#qx>`{U*kCVe~mi9|7+yn|21;({~9^?e~tWk>y96B{C&qSIsTL5a`pRJ`D-0_ zaooo--&8mK(TS;P zN4~4r#$MHlH$-_4@s*Kj3!jVJM|^!`p2cp8+$g>^GQWD=6L}Bu1Ce=t`(EVX;^!jM zj(!q(r1+J{W5mCXJWl*ZECpn(xc)nxGWcq6yuXnuB@n*+&I2L}S zU~h=DH^LAtxj@-Jpw^cF=mi9dfyuE_#ZIujrI#o*bvis*$Cgl)dp&lTdL3bHDsYY;|Uf7I2UBa_)XRZQs?&a2ry%BKuI zX7sb8HLOg6Df=IEXHDn(hnKB-^FTGRB&jdoY2$>3Zc_#ybz9qY?Ix7B@6#}0R8qew zso%f7(#Ce%Sl=+X*Bxyd+8ta!p)8rOfBQoDpixOb4LH+wwv^vecBam_s)PY+GAG$> z<;8V_FF549ZfjNPk92!@OJQ@n)!Vk7e^aKouG{AQH45Gj`|2!*XkBw8M9vkWV&jT5`os`)$~C+7&w;aMq^j z=Uz7cmhwW)W4X-I1t$&Lv2m}h2Wmc8Zg~ChLEFAFsBEVTmJZwT;QebxUpG1_v>P<4 zxK@X!{H%kEvc1>Zy!^9{-D}jr#j$q16*&{G`oo~f zl_PcS-M?{YZSS>(vc^$okG*`L1Z$cOs%`3aN$(rGY6eZuPQCBaddcL9-VgPwsC>ER zieEO{i1nWtytnMJ@*n5)h{Z(e>>Bbx^QdX}HfE7)3;|gcX`LIp@mdTDI3O zrb)tc+xGG%$r{F4aXOTz{hd{dCdi+M)mHv$`Iq_e-HZUYK#jOwd@#ZDCc# zxE76-d?~Cd88X&9R+1kNHCFPQXjWC8qE(Kkj?5!mJ{Lx*l!sxHxjU4;DvZ_C6Gr4hBgYCgXk!GWQo)c8_FASSJP?>A0 zat9?cTHu>3xv?WrEu0M>_C;Y%!#Rl@{!=16*XAZJ2e~!n+jo^f!zLLp*!sI-4V(O= zR)vR@CqDpeF>G=+;y7&b4kg;K$uD3m$m6idGnL4&NhWr*Vq_Mh!a~8dq2G%&Y_eJ# zE!?Rs*s#g3Vtv?1N>_LXc^o#$Xg3=+d9HTZhE38lW5XtIrUY@=B)uXwY_dIhZP;Xu zHq5X|+=mywph$i!Xu~Gq)jPaMDaKJ|4V#>T(&0pM8a7GOJw{4lM>K45y*8v_lQfd7 z#wLMDVINE!IZ~J_d<6@Wua>;3@Mrj_JH!l|#8RtU^p7Q)Y@54X5e=K9a$5gM_BCws zr{V&a=KM17eTPl*bsmOI?yhxl6Wh08lhfGfCsQ8fa>XvnA0t&odI4jkP#i`c8#cKQ z8#^OisY)#taco^0HW`K)+OWwmOmI!g_`cGx$y@Zy(!F>b*4CxpRHUK!G~2OZlS3(i z4Vzp+%0*#2LyB|=YS`oh$}_CkmE(4C`W;0^6mg5LVUrZ6srV2_`m*##N*P_`2x!VL-qpR~%~%VFwVpes0k zAFZmc@DhB#uI(B&8HTVvc&E6b@M&uDk>|yI3yoCDqkj@AVg`{Bzeaa=CIx8DBJkLYWVrp;z@;SYUxGJm??!0l;NdBd|aUx`OE0X zVUrw{4(v|{cBDgylC0W1LrEGo$>4Mid{d-72{ad%Aw**a#zA%@SKHhLsBe%uyYAEx z*`T?vqeE7zq*+I~e=0#3Hpvc$b1M#;>|}9Wd;g1F>5>jq@!H*`3=Eq*M(M?H_3IWm zDX!#z*|13*uWQ&OClkXaXMHf-`QSj1buhE0Yma`9EAl!i?npkxi3B&Di&6XiQDB@4qQ5w>Hn z?RX8Fyjl&uxQ$KD2<<&7a?~_zk^`G7enC5+VUt7(#i1CT9U{fzHz@O*kiTC_ExQle+%(oWsvyjL@N}aU&pPR0Fs@Sqx+sJiOT~rR?;Iz%*S99mq z=PI#dI_5M*3Rh{v=~$X<(uUy?>A|$zTpJBdNYX=&m$<6UtVNQKg9~jIOka_thr+dm z23bxIqv*v#LH5(b;hhS6k{}%qw@-3xEIp!H+uDVDZ+aaqm%ujDjeHWSa~R8c9fyI? zG4n zc^Kk~QJ%Wejfd+6s%zMAdAM8f`%-<_a(RkYIKRE5S z8tbQwR4)3zdeIR&L|gC96?|eS#<6A8#x4g_?~_q1Dv1ZgbmKwQR*cCM1CLq_Vb3OK zJC+q}SUiE4z4nfBGSos8;@}9q*AICsB{|*jQ*Ctp2Aco$o5ORWaiM z?7vpBni zB>V-buL=0D(kDaeaXK_AK-$Q*mP(JCeQP~`_h)ucQE-*B(tW*zJtV~J5*}*X=H5~Z z?z2GqU3p}v5PO(UH_`^Pnw=kNb_Z2reW=;_p=Q&G^`Tzphk8vX_2Q9hPg(EI#6?<0 zkM#IZzT;Fhs)^P-;2~|Rx+0~Gxf@91D%E;bCt3}St^*J*Ibmu*()f-{Rs|`wpCy;8 z3CCo~l2$j2)c=c1cEfFssP>YS#xu3$R@c*jI2zg2Zr}v%Rdp`xAhn+riH4I5qKUWK zJso_uidMeci=^^T=1wB{kILDqZ`w#bR_#QAsrU||RBSIR+K_wLz(Iq1>$sJ7rSdZ) zgZY9=c@OF<6YSAZf_z1JxHf(Cap5g|PG^I}|DPKd-cz-`OaC+*;@zv$c22Mu3vOPo z)Whn>f-Ab+Sn%DPiz}tpMXUMuSnV3EYVbWH%=LO3Hczx;l5~qB%wx2>oOWJW~ys;#bOYyPoGU33IFl;>&4k|exmk@8{gG*Y$8#x;oQqqYI%J(P< zq9q+iLZcRqac9M8m5r&>YNV!v;V}>VzNir<|J0^om_XldksJV zv={mx0@2g7s4`it)Y7std7!A$l}QS$sI7E%YH7K@;mIW^ z9N8x-xI#5aq(^WWpTJ6w*)cnGdX~WIoPfu$;(pk26Bs!$C`@E!MkZbZJ&+}^dQ?l9 zo+VgwQ&$UN)kX&8Gq0!>T~U&pX`CS}?Z@=szF&DOH644RWzVUKc7 zx(4ExOEnW#eYMDPEo&xAW=c@Dok^^0FPqN@w#sj_sy$Yw(A@BsO1ef_(_}KM@Z8Wm zS7n`2j}NI6SfNptoLa~FKLRhQ3p=NOJdkYGqJzSU?t_*U&Ur7Pg6_02pk;wi8hzLtV&9 zQ(tuGY`Tjuj5wEuFdPV>4x)yo;}bD(aAqgeQI&=~7i3~RL4_k;p-Ba>%_rsTV+B1^G^kH6|r!YAwxy@Pv){#t@Z!3R+=4L-U_RdWQB$+16zTR zWZoLfTD1+DnSLh6j!cx~-mhat&_6vCE~}2rOXN4t2%>D_P?nqvg~%opWkt#UXA-Mj z>c%#}=D(6z&GxdaRr}^DRcdoZF|#PEv~0i2Tj_f%v64R(_m#ab3)P-&AS-EBtW2^h z6wxH;XF66mB%g{qM&an3ptu?D6qwoA@t{jA)b9iwF9@HQDyd6v-UI44d{{)=%#Krb zM6qp>Oefn9j&Y8?F>6BXbNsT#c!n#THCv8lR+pa$TgkkBo))-O+^#F3Hbn_(Lsjt@ zXJyk?6xW6D@65+ywhVJcY+9CPYc0m_=E+m1&p2iIyd|17@-LXFb=urn3unmmf)h3O z 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


    MSLG z&3j}{{F>Fn-NvrEdJ13bpI@^J`#1Y>8iU0EI?=%?mmV zk!o%Hnrd_oMyG%6Ds&>hrUCh($cstu|Ix0*uL*wHTj1B6LM@D6Gd82hR{1ro2$YcDP!KfL(hI3uw*DONK_%*yRmiRR< zbDE4_gOhgdhD^$@X(Q5wU-MBJ-EMwOIBSt#6VBQW@N06^G4g9Rfg``>2`Ux&HG!%T z`8Dt7(071e!;6pcYfd5W7Wg&192>vpEbtH3DA&wdUfOb-c%7MD`w3b(@@sg3+d+QK zWc8VUMSjgi99HDl@GZE+uL*YzIPR{1qJ0GIeRAD|Y-ulX70$@n#4(Gug=9D>Cz{F?bHvc#`Bj`EFP^F_4h2dYaK ze$6%X7US3SBVzoTGcjQNnvYPCMZrK9e$Dx$EDkCEP=3vNwNqz)4XoCx50&^e3{EoZ z;G%4UU-K?miiDb(gBV74X4hb0wxoOh0lmPk;kUlMj9v2;BF3)yu_DEbRgsikGni5C zzS_pf$ew%#O4&892n`vcf4gdQG&HhnhMgn9Pzi=#Bf$C($12xQ(N9*G&X9Yf%FxW5 zinbu-yJ1R?+2diF3oe0hiv?qk>Qw)A2TZD$8gk{S;M|B z>vL3-A)5r?#|#bpn4y6mLnYcn1>2N5`Y$S8{Fpx~XW++-4uqMTgJATzbgf$g9&?PC*}GECxRm&`tT$?nW~adZ_~9od=8;;AmG(de#Z zmNA~Wl9E~W_97#*jNJ;EMLjJMnT6dq1AMpsmqPkQBn;(mmN4b4fNs?$jtD!lZBAwx z8x&4rm)hl{P6&L(8mvtu5_S|(rT-nto;QH`kg5t^M@DN2RSBAQ28ud1>VmWS~>w!leA7sy~Kj_u*3ivQwYSJfZF1`l ze3|;yO${)77PU7f(0DplFKbHvF`SYT-6o}D{4ZpabZ%CdQvb*JCI7otyMX^y|Ic6D zVpJS5vDb@QDHxArm?RoZ1gZc5Ub)KUf<-bRb`-jaNQ! zhc?U0zz|!=Z`MX2FBm(>88NbFdqkVb8Ojpii!fZ&h&-g(C=fe4`64ueh00F9eCgK; zn87YomVPBqg_Vi_1rdGTfXksWaD9B7b6gIU;TKaMXQW>amBCBJ$9?~!JiVW}P+6K$ zEfrRVUmnW}mHOq79%_No`2EiU@v#=so;bafKyQN2aeRoS|41*rkq8q%HBActiJzv; zdLQ{$cS%nf80jG4jWR;)LC76DQbV>t0qJ~q_ry%9^rmq>`lbiSUBS2=VEp|Fv@btl z9ijb1u;f|or#Lxnj+`rWdcV89dgx;yVso&bGQ2} zSo+0?&CYkCoMQnSm*U6BIgl9s(VU5mD)#_w_^g4ew7uDDP>jN6yl{CM7~aoe&XdXC z>F|jTpX@N#sp&6vnD3}2KgZ!q9lp}x>mBCYS>6X6{*l8kIQ$2PGrF}|-kqEYHH^Ye z&P3V{J2?|+JM834r0uYiGm*B#);JTNt|{M39|mh9eACIFaPnsy{*A-Gclxh_^^7A_ zXqe0Mj`2la*zViAfu%>-9US%dc6hSG$2q(h9G`J3oE*-CJzFnB9_?T4^grS7e}H4T zUw8PIPUo)<2cASMw~q!=R)=8@AMWsb9p*Tx8-X#LVayrs<*-~_OY$KOk9K&R!}~k@ zc83ph_#F<dYKPZ3e51pR>&(vG4)gP@$@!hc z@HZX)w!@6^Oy?PgUvT(EhhK4+S82=3@2rOVILr*NCg+EL!(lAPKLz@_^(%&(rn4g) z1x#&?qk!)-KJ1j!Gh*KE;8r4M+&d)VF~Vabo+xbVY%m_Ii*m+;M@D?O@QD#KhCeyt zlZ1_N{p zckYPzW?_Cl=6G)vHeSMQ!u*hqoIdrfh(9g--H7iM{?CZ%Uq6ocVd3W@enfan+=cH* z{`;u2Ntj?<0gr2uOOL>Nj$zJ?Va|u)gB+gjFz-;NGuPo3hgUhg*5S(>rtQoQZDjZ! zhu1s2(P6>u3Pow@k|=%om@GU>n}uuyduR`?i}A|_Cdpjk-L;XQG}=#Y%$@AbQT%yr z7R(;^L~rjU*;^<>*sF|b*rPt!M@Fb4;(|pFl&nVEw)Cb+$MRqXdv$;qtbT_o?&~*O zH}|!YQ9r&4kw*Qv#=N~Xim(Qf1xtIE1m51$viG74VNZ{%lD&DtmPau8g&sEVjD3>0 zrE%RFMn1WxzBf35!DUMGPMJ@l~GFQ#D+-+t@!g2}}LwvQjsB11Q-Fs^HCP!{b? zU-b5BbzQEN%!1Xg#1Cj{+rD)?rc6rd0o%b3UOb9}Q^earof}7DqLSpGQ|BANqXnrx#PcE zxCd0Q&l^oSRE9g3kM}73u0YAVP``3t>e@HbZ=_Xee(q5jZYm1gXAE;sG^|@z>AjD4 zD3j}!mt^?ht$?|Vzu$LmlA!Z?|G3Z5%CTDU-crtCXJByDGxOYod}|vXDY+kSOevcR z$n5Q-m|+soV;pb6(#A@F?Yfw-NfnqW%sm-78*LfB18Z+#sQ`H`n7tDuFihHY+H|uk z1xtIUB)(ky$tj0&c|KaX{5D~E1jBcH@>;O8#S(xg#)SW;{lgKnBaLlE+?(D*5>A!O zg6W+tfqza{s_Xf-Mvrj0Hp9fvI)K2+wj0X0P;IZC%#1bbEMr`%RoUxk%VH?{3(EDoy3ub9G>+ z+2pp)xwAUH(Y-i(m)x{)-p1y;D$Y^s)Fcf_vf%3M>|LvJDXf}3B=GZsJTrUJyxpok z^0S(o9-f`5KajnvqW6Q5NOx>^r9OSTPrs|;fn2ItTLG_b&5EHL7mTf%H>>LW>SX_B zt>|Ov3m?8@!<~oUdtULT;-;#EF~qvYM=}po-c|AV$G?!8IJo=53Rdk%raXK}W2&k9 z;fK%oecNtTD;IRT_XsQnhW;meeT24F4&_+=2K&< zzh7JZ+2OmkHT7J%N4_L&YufdS-KwNfTfOF@-fc~N&Ye}&)->Rzhvz&{U3*EIbLA&S zrJ!wA)rk+!zALvVw%uLvP}9^654{#VSPz?3HTvqo8Y0cA9({}UC!aU^^V*GmcwFuy z&zDtdtT^gnaE?$a3v{69)1 z$xTuwXtgco1+Ls1{3M^hvf1h?T`}2;>i4kAR6T<*Q?pjNvlTg(Tgukt!eF?jn(qyj zOJu7uuX-ny%-K{~yAU`A#oiZ@IV*CAB#<$(Ba!4jCevaZQeKr-^xB|(HLC_?kNGH& zPd(XVktQ|A=--pty75oX*=#izba$=j^{NDUR_G*~;yo*1MHLr=%tQ8TkQeNn`YA%pC}>&G*#dcVZ#s9OnN3?!-B)fmp>BO?F<> z>vOUnIfwb*Q^j;muh7SG%Y%Kjc9R36~;~X-VLaqzv z@JSin8t0ID$2Glx@vME(owa-2SxeXSO3&Jt(2r*=UDGSiC764V{#(rd6r6Gn^N&)g zlyjI5{I`^InEwlhzFnL{%Bsu%TK^;GF#kjHZq7N(&!^m{&_5x6Cin+u3D3-bnmTM^ z+Mn6^z#x5=JKCIl;PX6(zSi_&S6KE0AtH*>ol-Kk^M}-}wlyGxqO|NhjSEO-Pdy03w9Ahfu9A2!d zmNp~GeiSCD0koI^e~l-Bf`ME5t&;VL4=Ied^vUFHyJ*A{+`wZk(F ziu6uukg=jwtZttpbtomyA>YkQoWuW8ia3X~LbgC7l-Be*1&duchc~In66f#|$~Vs8 z%V^KfaALEC`}JRIdJ(BD^uuU#h!hH!sclM}!*63?VJLf8;los9QBWIIxC;ZPg~-Ih zd88~3ktu~Gq_l)cUEvHOOG0FNQbQMEO|Nj!JFun~$FB3-bxp6zN7PO!=WzF%f#+w= zk1wx`Kr-uy?ZL7EnNz}2OtLbtNzITsg?`9@ci?F{!Zi9pMfZSgcM91)rP!e6B-23I zf7Q0<&8mE69?{IqJ!i8Ek&4St7}S(x8c7(TQn`VK58VSasxNBblVqAGobT6z8Tb#> zqi%>OhHb(_>-2A&1mmSFVde6tBs^BaX%g}i=@4=HEMP$a?Q#;gXDChNVDSs=--doxI3mFP;H*3Ql zB2Rnr6PJhK&=bn@vXlKK%Bs|sR*~Ln0`zuwvdNPDO0olkY))nhrL81OV8aalI}6v>84Hu&P00aI;iR&^j2EgNx`PDa%ooMRiN zX4d^)v9xErO3z?OIx_T(5Y5a8B+OUIlbJdEYNhT?3D*m-KG=}JzT`~NOs9l1JNnmL z!=K2!raUS8^8X>YIS58G`I*?4B#zrQXT;_$*3aOgC(yy16Eib8-^J}J6`8Ct3%S)K)_-xIzZnkDx zcfV#@zO2itXtn8jZ2!tjrjoioV5Dxw=pcRdc63osChe~qTA46f zEPo!y%-}MAbco}RmexCa}Yv4oBJ{SmjhtYPLa}yx(8D0g$RPDh`2%A%#^W6T{(s zCSvyF)q-$lq9QrKSvX0FAz1d_wRBp`=I^pVTv*aAeBcbfiD|u@`AyAQkxgfcbsU7$CFj>)MB3)a^%@ib+fLwyA zYs0CEl{Hi^U8hYF(Qzw>#8u&7%bpc1v<1yQ!v9RPPg%CA9d>M;xUFHVg_>CV=!gVq zA64FJlUg}D)Htno`oAL7^6XePWo)ivnp#3p$HOtFbxrZv-Dr{2enqfT5ss~Ux4h(M z2K~yI3;SD_l#j65sLix#I1{;WCc4FzO6#DXnKxgluD)?$la@DQt+}v184H`FE31Wd z)cD6zRklE#QkQjFxWunn*BW!$0w@0xOV_<&T5+etbc?RMLAvq(;g#s>n;TnNS(xU{ zSdMO`zM<3OM0nyJ3M-1c<{Ms;ZaY@$+2&$&uj_iSsFmdpc-G@Ri;!PFNxAxP4zoQUrukO zJM74^H1rav$BWwMvv^_{MU+>547Gx1SYEvZ42M`87h9?W-j)|20U=^W%V) zy&K-9eln8rRf^FMd%fx=L$onACg?por3q?}e55vXk&o7<*T5jJ)4mw-T*&_{$Ie@Od6#7}BJEMmSz zp^wd1v{{{T1Ak|fpDJuN=L(OBa=s#2US22&HKWq^oW8=O**gREe9MulW1Dd38jSx= zzc`n}PEK`a|C`=wnuE*D6Z~k7=n_A!OT6?VEIIl4Tu7iZ!l~x%+5+i(R<=N#3(5lV zD=nfu@jJT2Ki?((l`iqGcZq+eOPmYO0``Al5$%cl4nlla9S6t4#l-Qz$FM*;9B~^R z`1>voL?2HV#_f7zW);8&tt(vLZquZ+r;Etex5s;VG#|zU?dh7);lZ@|%7PS^j_tSh zdONSd#p3EQ6c34$!2c?!RltuJrx>X8SL?08Ud777mf|KEgn1Vnc)tpz;3(N zG30xZ0yopl?g0i4fUQ?J7I}PHOau=~btZ%NOz{-(UMW5ZT+}~>I&GPv{wYk;mMQ9= z!gOt!!2yOfDKkS-d;;=V)=cowR6ZL_1r_FKGo88M5&EaVLj`U*fkT3SzK`~pL!Q+h z6DH^3hMb%F=~2E;`)eY;Ui;5P%!e<2-bJ4x_zeO(T$?;hkkj`31_Y+cutRuay{D; zu&qnTS3mMD)1Ed5&(;1tVA-J@aGnY%%-4pTz5ve0{?LwGd3o5gfw?!W1xuegg7dM@ zT!LIWwE3kGe?fcV$ibfkD=+;EoR59%UgXkwNc(R@%zf!Gu=Ed#IA0V{ctIQbuW0|9 zi2tJfAHdSDi`ewDoG9KOThjSm0R;omzP=1qt;_vl`(Pgq|v%BMN`Y=>JMUheP* z!LhAA;^ZF{wlTo1PUmj0+KBLZC;v7$*5N-L{)5xWsT?b77l#KqJl^3W96rtA_dEPy zhd<-+_Z@!G;k?FcR);|j-{=gi^J^>uXGqc5!1&X)G%Xr!hN6-!*4L1 zF#hMCLT_z$jTeMX=eN=~`Co*YGlIZx`(W;?y&{$~Kr$d=-nEBD%*Wwz5f2pJKjI<6 zQzITNJU!wG!ZRY~T^n)&W$iCKH{v>Bn^S{#x3(zfx>*(RTw#{mA@6CzYa`}bxj16^ zJSLY#e5UY+BVHr?@rW-LzAa+jn?DutWy1GF%ysjni207OKH^UcZ-|)p>x~hAN%--I z9}<2lVy+<^?5XnxVdya6jl#c-nD_3NB7REvza##k@GB8NEi4a$koPCTH4$$ThHZk) zXN3z9KQFv{#9V*FBmR}}gouA9ykEqB5k4s5SA-9X_*G$6Cc}P4{pGlbdB2|-akVgu zprOMxIyd40!p#xyA>0!2p2BSr4;E(iE%Ne?bymb9g&{E^=X=1#5%Udz<;jra`1;|9 z>x9=ue1z~#5%X=}wurf=KNT_8^gR*todHizY~qi$KH_HK4H0v#Z;V(=$0UzOyj1w9 zi1}UxH2^!@1D=m~x$rL|=6>+Ui23&LO2ph7Dza%_zD3kT%)Oy!#C&_$HR9`q3IEsU zVc~kP`_=OfzvM9e)pTmqE{1WeHC%Lftiw|rp62ig4$pB|MQv9oN=w?0!_s6OihX@mo{)o9z6-Zbf09>K5{bR8fD>O?qHo3GzNqja51M*XT|8pj*H9cgdj z4ApN62{Bk%?^4{`TQ7T%g|Vky>3HV}TOPsWo}Rj2xMQ|7o*#zMJ3$Y=uR4K2o;jV$ z<-w*#qFky;8vFCKSsuZpPoE?y0%EYVHHvq#rxP?xGVH0UC41KjTOPsWZL-&oj4@c+ zRf>Ci&&wY7FYNV>Y1Ho)ZRDA#jc~Lc?vvvff;eexcgMZyouvWuRLLxu9%D()qlK?X zZ;C~Q`LX*uWm`O<%NYNHDo~h@Qz-Da8#&{(5_3 z!_sCZhS}D-u?OrM>Fe9UUteETL8=7TzFfxjdkAkp<*?t!lhv2EJ=lBoE^QA^T%D=C z;HZX^-?!+TwuXvxbYrSXp31zi%by0b*lHSw`K&z8KG^&52Pf8kM>O%uN3-NuefckT z`9bDo%ZDCqx;1_@^~usWJx>U~`%oifT*@ZreVw+{|IE_@nbY;Jm`cJAS|k}iI$Qk> zwP$5TH6zx_Ox68LtIX6e#;UByVY0F&$J|9@dO_QnDwCnK! z{Szsg0Z2+toB&LE)-R6a=WPBW8B2-KHTe!D8Y%kUG3H6pE0kCeS!R&-HLS6CzP3G^NVaIOQG@JS;nlcJ|8*5`7mLRF?W7rsjQMpZ6S==(FXbU)4(eq4^!6#lIo zsVy+}E>V?-Qoz}nrE0uF;USe-qALFvd5o$&pFC?bH%P6xo0hdna_47m(v5pq;cQYa z%zRFfQH3kXV^rn;A!1Zz22P?XQ_keVE|haw=04?_QW(T}yFBw1MGh()M#>dIt*-Dm zXZq^QV@jD;;0%bWOtVif>_@Gy%h0aJ6#h))V;RV=PZfCC5mlKsc)oBYd2Yx&EdwtU znAS0OV=(=q&dCoI?ZK=GqAH)DD)g+^LERHty{Ehia-SbAOP#37yKo3!oGx)~{u5N~ zUT`Fs-}hz!XANiI^A`%>TooTh>K-ywgHURBI94$FP@{VH=<{#~S#{s8LmEccl?`O}blsxl|9AIH;= z1L+r{!=`;8k&(Z(B=gAC*?$i+(Rrzjo zhD$(`ly#K*2?@e2lLHRdmZ-{8rP)(mAl`>^frCFNGeULmbFcnERX$$ng+R?78gNn= z$N?Kw`BfsrLr1DnG4!rpS#0*%RmPzze+&aR&|rrIoD_Jo6IGdnszQ~@5motZ(ylG= zeq34}wFcQ;Qi|2>(_PI8Rr$AAJf4D2&V)O1;Wo~bQI(I@5sIozN=<=2AgVH1YE?6Y zeg2|SpekRX4qtelA{#@0PYTBpnV;drW(yzDe^Hf*)D{lHXmf}Z3Xf3d1tI^y0%V;M zRhbW2qAHVTRN-t4oE9Pz3)4wi93oQ+jMqg~My;-J9FZj(=yID2^hq(wM z3~XM~kz|T==FE&id$u(xHi}G{_w3mqvh(QCQmnlE?z8tQN;q5tks_nueFO#vLhIm2 zXzi7y!bAQ;&0KR?AdT86CbN!gDbM;)F1W!mFc2p7q0}NXBdx=sp$;=+9j3cF9A$MV z&UQt2r~(j=2OC$qjXqRWNeRO`IQYjyHPY*glKO>9mc~)3<%#`v$?RGcCijaJQ4YAw z7R`DV>06#Ux;Ynf3)E5LiuM;pURzjw)XDZLlRS%MhUj3&5FJwDer`@x9lAN!a#&|| z7?~kV(tpts+0hp}llzdoCsklKXETL?lBh=odD!V6S{C+EVny<(F3lZh|1E4?(llYw ziiV|d8=BfWTH7bIFIm>KWVzAjmNu>AWoT7L)6#Zh*2PFu`?7r|P8rwK(rn5d4Q&g? z{av_r6WUj|ClfR+;b{{#D}CIG$p=hOB_}LsY}`C`!sPK&#_u~J*6IyTT$#24g*28d zCC%yUVWUp15&m>0N`yaM_$5l9?gYl|OT}s^ar-1bD9lZ%MmvPl>1ctvg@lt{IU@4> z#JcMzo>*nKzWTp9FutmFJIhoS0uEe2>A=7{Bk;|#-C(9w2JG~ut&UPZzrD47VZ+k- zEh26N3Rs!@wW2|6hXtPTB}vO7Xa?d$tXkADQH%LCs91_G{PilKy+iDum5tskw1oDiMm6u!1;r8}t9{XerA_mT=?Z?! z0~2CiLwh8kENs>I4G-9)zIACmwXIiUi{jAO+PZiVO6?0;mN%s)L!Fi^Yf};R(Pef~ zdwt`o2DM4Yd^~sOwJc669GqTt1pm9%h}?|JqUyIaElrQU^Qj5ckd(@|)GdqHS&61^ zXxY{(k;d(!&He^L*MgsFVZ<$q?6Lx+#I=NDJiRdGd@=7 zF#ehAKCVb_8Nr3SQFNlEdhO6`w5wLmSN{w*h}D+OpFyzNCdtljtFOnTDmP@y zev=#0{;0lL-@JTjWAb-nQ>ia5oxke!2~?b`&|~X68W!kX@t-)wFkd+c>>0RQ2-6NL z!pMVX40{4}A+UBqZi5VsL-o@~`|2ef4Vs>rP8IeG4awiXVSI}gcWrBENydlR>&;x; z+}5z9De9%O6K`WKW8FqNsh8$94n@783653UXmVA@_$|+N+^NOhf_x#lA%#GXfbYV0 zbPIe-XIN^1_{bPBef$lqHURKh$d1bVDtepA5boB+;8{V~GG$p_BIyeCFEHoztqO#acn<+LB|hTjNS zZ`N@E;w< zm&WSZ%i)0zk9HV88Ph-9;S(G_&Eb^}uXUJ@{buKShwpIsUWXrc7@rf%`%{NsbokE> z^TE>e`Sxdcq{A~Ep6f7^G@AZehc9z@ox`^|e2>HH9e&B-R~#B-q+#79G>IwB8OKv%v_mf|1yU^LReC^KJ$H3@FNeoCysyKD zf^{7d4i`4RMCKjLXd|5GbS`!H4sh%zUvTm-3EOk(JIJ*WydU@oK3K%OlN?6R>Yy%J z!l;_Om&1b{9`5j1hxs~ed3Aa<=a2p=Fjlc+F9@5?54o?#HhEqc|1rWZBi1FIyc99x zi2sh5a$bpel5mCckr!MOG0$#WFKvI}LX`7efA@%w5H3c{b9F?-d}99NbR>fgf$j*5r;DZ6K(?)2KgU2xKX+!dpMm~Nq@b>Byw>J>MpvQi6 z#C1dzE|b0K+GCG%WcFxt>>(qpOLwLJq!A9(MpxaI-Zbf09>HL*4iE$75;&*eI&Flf zRKK;_Q$Jn4rTTUCt$JE%GjvT@u(IAIfwwnDU$UQ4U&bElq|tu!v{@d(WP%3po1DO4 zSKq2$%6u3ZVlcgBiu-aW@0BETC8J!*vvSW9wmgE#yOdZ2#9(P_6!-S7lD%P)VXtRQ z!|t`(ERSIFJ_+}&0Hwjwu2R(7yI1z^kqmoW<5s_0gvrBoO1M>pEy$&q|D>_q9rvc! zqp*FxRmVwhit<{p`h80R!=#-ry?9Fus+P7vF@GE_#k74nj@R?8x>WY)_ZH0F_ayN4 zRu#+Fhq_{^U3j0fJ};O&DSOWVVlaE`UGpdRs#5$c%5{wm%A&pLi{9QS6*f&W3ue!J ztMn;ryVl$~VDiK%#Spf=HptwfN>e2!heEgDTQyY^=;I&tvAI%?vw5y^g2lQfQ7 z)sM5C(&&?0^O*|ghlB1}Ecs0FL(>3lI5;6cRt-ZN>3@bF$upl*YfeZdf!I${*=Oqh zjExE|p@*XX+CejXqNhol8DbjMJmf)Dp~@&(!WZ?2^ya z%S!2i_qF*<{Y<%XoBK>%ia7X2)ucX00oUd~gt6`RnYu*;L0m{;PwX5rTowlAe}mk7rk<3j{5&i~pQ+oyJK!@lN_Na=>OmT0>poMs{g-^E z9;AHpnd(EK<}>wJIZ{)=u`Q<57I;@H`Al)cEBQ>_Ml;*;4o{KCe5UwCeak*myy2C6 zrtowq`Aji}EBQ?AO~ibrdU2Y~XX?+K1@oDLPgC-l3f^(%GsPJw`ApH^C7-DmiI~sS zcZrzK)P>|RpQ*ixbn%&*s>*M-&(!~C?@ZvNDz5#1?{xP}LpLxot$?yLFu;K9pbiFg zKvXbp5mekV?2EF=fTD3hMMc9)6g8rv5~9ZVqVXA%xF#4QF>#4;dzcvas7XwsiSb2a z;{W%pTc^8b072tRe1EA=-+O;`>eQ*_)~#E&`qU}u(nY2-bv~KigwE7-lJ`1OITG|b zQ!hjJI#ZV-$Lma;1drF5VlxrbnaWZ_A3|peZA;UcdX2noLT746(%nGS9g-Uc_BvBX zk_WFdHI6)ZovB9XA5LfL0Y(2L>P)fhN839%ovEu;Jtdtf_bi*vlvCw1ohhe|xn-TH ztB`CuQ%~VBovH1)4Gmsr>QF-Vjv0Pxdxv4VggR4yhip1iW2ko1nZnLSNoT4Djly)M znCWS$Gld1xlFk%UBPE@wWAT{I)G{Sk(wSlgqNFo*EqOMbsUCQ2dxrzai0Mo*nl0%} zeTERznc{n*q%*~2=Kr3~)IwE2rPF)b@z=nWPTwcy>pRglnp0E(oW9c>h@IX1(45ni zsm}9sis$essJWsN)CJuu9D|E^^)m5y{f8%Y)8G5jQ|ea3WkNR;o#MlajKaEUl+j)0 z{TJ(eOhrqTq#jp_rSefyvEfO)nkYTdep*7Fx+|>KtMLttht!~l*3j{?(M~|uOfr8d^h>e<|^e{DHQ%;xv% z;uD>iJJRK^cUdv3PxJgIcJJ#pR=rYF(NvBO=~;1cBXjLzf9N#?;Ar@Rbclh=5FO1G zv1pQ8Wa#fC9Hp~!{0XL}DW?bAJ0zR?eM~s|`rCA~{xRtk8o)TW{w5#%13*Usz?dEz_)8|fKICJ{Esj?{haj8+AG)wZN7t%tT zYST(oGo1FwHdQKV&`6i4xq6thiC)qXa%y2xMVmFn>47u(~M?uZd98)7d(~^S`YF_qVk}j5pGKR?e8AvnALux> zcfRDroH)ZnYcGWNXb~O}U_WXAQ_@`i>?jyp)<=yf- z=sIw31^6AX=ifnt1;a(Km%mSdiEm|LLdh_!hT8?0w2jV0tzl-V45QCrcyxgG4e)^h z{#<~W$F;aK1MJ?*oa7kiSh*Nd82=A6I5hfCg-xG|e*?jq_KlwMnD_ZJ9`oLR(PPFb zuX)^E_;rt&TE>0ccDE9#TRs;_TZgX#r*B~262!L2K=Kc6(BYhPB5DQrtCRSI5s&{W zLU|4H+qZ>aNnT%%8z9QnO5Rvqkw<-+yy3#ggN8dHxs=X?;da+Sv)vNk81Yyf!Dx|= z27q^@i`z>FxIqUFU9V-jl0SxVgi+p>x=*)>_BlNV<}5ARVkqwo$$LYUjy%{+-V|Yr zBN$~g*27MOISX4Xf?>jTQf5vxrXXyAaG37%U1h&cG}0yimhL&ip}dO}SQO2ig)J2! zl(&2Hdl40{(tzw3mFLmz-!+g9x=lVHw-aopms#`n0U z&_{`8&iL*S!4Jn>P@%AOx=#m)k9KAbdARjD!g|RUllr9`jO(o&8-y*6U^GGUX!qtU z>~Rr7c^!-8=R-}WB#-{a+Pq-2TJl~1cxUps2F)m1s!SasBF{B4NQ?TWEr#+Q-64vs zk5W)6?}6^q{H?JoHFWTvwc2UP-)rweGs6a=}B@D-IalbNh4C(d}p7RPn3K^Oezot!K1O zuRlYjKD4H?&-Cpk)*Lcs-NeUNFFv$qwb1%hwA=Lj#MFw#3wx#)9JcO|F-ysXRfNb4!W~$5)>F`RLY*tG@D||0u34R^MA(Ik|ljcV+kXhadHK@!#4#UUOG9 z5wBdo_S$Ie)PlrbctvsL_{x>tt5+{p>?CRu@9-PjuNtKcUa{)EK1%1uv#Qqi+`f{x z69ty|hpX~kRBFke(Ym5?uV{JAlE;_szi!2T3wu^C7_;v7$CuPRu=ncRhCi?ES-tL8 z>rPqr=<;rT1xyuJtCxa6ce#x6a7-31RVyQs>vK&W*lr z%zisn**(u!^nHAEO=XX7Jy)!)?lHb{?S04ObNLlXCVTYkR4k@xAX++VyO zw2u`xDpOT2R_uG+`}@v)|Ms(g*u7fSddQPSWkVIU{(s)T{qaqev2JgbvTv%p?te}t zy`v^6>$yMDlcbQ#rd3p~f4|hIWuL9Neqk^54zk9U^mUulEi9@-NpuJolynQBscR|e z7QWsl>4S8R$Ln^-XQ*NRm+#ArdLE%Pv zh^rAdk#cN)1kfILU>cFSNo7?1SLvb*T|1u?mT$aWj+prnU*JK|i8 zO#ntYXY9!9Au@K)9R7XLvpJ{Rb;Ogx*lt5o_7R;pyhvG{lBa#UG?mk4stO`KMBTY4 z*AY33fXS9YW!r7Ej5a?Me=&2}0);z!W2+pevp04*HJ8{My8@WaorbI{X`=aDEfusH z?Cp(Rg)UQdjs}>y8vc$s#*CRY-&JlpM>T)c1&v3%1!*;uH6B+W_6sq$D_s~(NaD$2 zp2Ix(!hMQZ(s-PJ=riK9;uH$MQ0_CP@t7lHrt$bNahAm_nkrd|tJfR6w(u)LmdE4d zsVlJPucYzl^e4?q9OlWT@klzu3#^Tj#^b??Q(w3Q&qeWJ@{BBCEl(Pcur(CM5prof zLm^`d+-qq(a)ZYfQh2V2xq}B3_D1wo@h#%sP^iOmwX1`d3rk?TCT8o3*9v(&Yn*7T z#BrzET%^oPMRbnNseAm81)i<*e=kD6~g1dHmaM$h#?wZ$lba(9@ch_=GE$m*} zZ!yQ}naq9LDZ90~nPlqz2I0EIy4wTOg!|{drgP>er|WE1;*f7v;>cxlD{<{9_Rp7z ze@u?mX_?2UR>GJOD(B3TPsMtcRy8RyEN6g0|7LbAcFJy2%k|0chGr<{}MYz57;4@ zjj(;;Au3f;=27h9L~xxm1$Ixdti2Oqd zi5p`YkE4mw%QYmd#L>FirIA^)kA!0-ZkRqp3U9-*!BI1X+yIT_monX#v>uw0(x@Ncq9r| z;vm+Xt0d8QtW$$8e4g~Dy7nFwxNFjQe0coM&+1UP6v{p8CQU2$|zN4TTHv%yk}FiQ{I|Ww=6PC5{^C zM8DzgrwDrrw@be%zIJKeSDkqBtp&_+fk(UZ7Zo%0Csjb@DZIv0e^HdmE2-7g&vXwf zZ>M3WQ2DI9<3bVY~{KF!NN)ercrlYkM;s^Q$}Hop^fWOm2f z^lg=E6wY?OTuKdvRzqun9kKg?{>d%HusE@%sSI@t#ha`X1jk& z^n7le1ZR67r>(Own(fKT#_HUT$QiOkxR7fg?of)>F~=Iw>@et^bNfRd4!xMWiL`cs zUYnbvGG%v#UY9!#`flL5ncU;2ilnzoT?xr>prjyu4Urr>*(4yj?z{Nb%`B)bZh6cSqzI zJkl83?20;YycBP(yxrzS@tOVQc|)F}EXBm<{89x=U3B3YU0ajJdA$@kNaDMHQ#p;N z$2SZ2kYqP)^>t0Pbk*l`6n~M7@|N$3H?5&*t+$BRgL%7gBEBN#Uh|`PSEufYk>B1~ zowgV6Qws9@Jz28e-^D*Bt``qcKP&&=5}s6(<^y_95^;)%+iP;P)*0aQ(R-h&kkb^> z&xIV7u&?s$V_LHJ;YJ7 z6m)-*N<5@i%CIL{Qhg3oai8}=gPR5Q<_{@q=Peg}RK-FSe3fWF5v{FSLi2+2ex^$5 zT88vtV6~5_VzwQ$`(lNM1da|5_IuwtqKlKWas#VneQun>;ceDuFDc>UT z>R&2eUlfVYifNs(0{Xeuc~(qc5RdQY8s}N=rpFU@W<~!?lHGHt08c`#6qgt2jD|2J zQYoYU>=%*wTKuXccB~Zc&w~8SwT{sLMr9*&ox=lWh&yvVwUqQ_13Rl7wyKP2LBZQ< zP#48%-HEp+Z7F$;QjiY)b&3XjRspH*#}LFx1)inz;KdSFwa8_i`bY#)%xJ)Q%228o zjUyG*al(CG=Cu}-B${6>Ecx~JZ*zU2b_pN z+KbRI&}AO4^0RYUm%6_%heG!1gmKCNq0~gRdSHp9N=rzCN+g$dLL6Koy2?$6LpGzA zJy*?IYS&zr>PXbCL9NyED1Zw~e3JmsSCarPyls*I&^<{2m-VFp&>xZjF7!;zRlAjx z)5VFS@u=juS8T)wM9EDPilYf!{-C2Gy66zDZ#nWrE<}PXSaLrQilf80z)hluU1RYo zqQTc#L@`;U3)C*Yt|N|)G?FAoR1Ptg>UzD$T)&}18RK%BCv!!x$Xx#6$y_gWf+ujf z!oj1s@a_>am)jF6mj@Cm7Y3M>`d8GSOCss0=L9i~5JyK5eV+sp^?CzvvSQFCoNKyAg5Q2cQ$v2_o@ux zZzDDSTU*)mloJ{M7F2itjTTckveNpmvJv}{EZT0yzN>We<|m5?N|s!8qp)hJB?7vS zC0nn$ac19D(Ail`%)15#U9pr}BI=KzWR-zz=*^yoEm+-T37$MhP!c51>`1D!d3MP5hOqOsjTEC51rYoX(CX zb-HmXtd&nJcDz}weuz_bZZ*V2xKde%<5sPOV<#iAM4RABEf+(ol2d5Losm#saw(Y# zS*g$xU7?iT<-*5G@|C2XSiSx387}!}T*dg4PhGSPdv9lQ*a~D$iV4aJVf%}ze zRikr4vD{OtASGetVB_=(NqPx4b)VFV%e!%lY-LLBeNrol^ftccht*GF^bPjf-#)j~~+8mCP^ z5oTxXR$e6$H72V|KAIh7$(TYnCbP4fv&g*ZHAHk`iSgh~T4SCy`NZimP8(@&jm0wA z_~ETGHHCq2OWYan^xV=dI#e84A$r?1R z+B$jKWUUx%Y~qQMlu}!sF=Ni+rdh67u9~z6&>3S-`juv+q;p9YElI>wvd^MHH3n6M zGvF@!_{zmR-Dz9s=0+n__dl_iN{LNQ5({iqi|8KV;mNI>i`8n4liUrMt0zL_q@8VI zm6hVsL1GP-!5O9ha0{-cEuK5&BW?n)*&(gl7Ql`4%C$FDwK{YD!jq%9)8{7Z!e(P> z-&y*mm7V17sTOAcTzN7;O9lVnc`1!`iK?iTA z1NxmhhzI>{9h%i~^e1%1K?hgsfd6G3mY+WhTe;p6=7R#BcLMsm!tFhsX>XIyzXK+R z4{#i5ftjyF&K%*c9y7B+8KJKduFw^JrXYHI`Z{5>``}@200$3vpsvvQOTg+dFU({s z^p3*JID-cY8_!T-yBBVDLE$1rr|87BhmKPPhIo9FFiDf{&B9h*rjc;a!L*wmI@r?; z=kh6Rb;Z27@+M$9O-ji#3J^wFp1Fg@0ZP|B@E|3tRZFYT;*6 z(j4jEY#v?lf2W22UirxzPcHd;phdWU$1pw(-%gAQLVq$o3kGoR_0`zKI3OGj_^+hR zeMmHxhfQwKzKP*tvrmW8*wK&U>~$V|xg|pp<+e0zbtR1HzUAm4Y;7h_IMew!dWD#i zoH~Rkrh?>n`^3C*7L|<>xeaJkE_>VblOAg8%+b4*NGhM!thvdXQ6GILkBh?0sl$UZ6*Jr5mvy~SS1@m<`#e5X{QvDSdH5f&(ybM}O3woP zU3AcUfyod3fMI$e_^C5+&bJMk1w2JvdwSeo*Fhdr=ev2#$YqZJ?+unr_`x~f#t!v7 zlXN`_EFRh&I7j8kaj!}DEnOFQOc_rEi=TACIo~#xLKpv+bUoW+?&)%mk+Tx4xb+@e zT3_`%jDT+QnETG3EXaI9*PnRIea8l_ zz)l`By6NsQqn=$oW@I!PESU|G1J3#9j{lKK7oMX6Jl|tRNvD7ncZ}kKE$&j!LmuEm z&N^Mc?C}-4{-?*Z!<#*ZpTBgBf4#@Q(3Lg{osrRR0{mBx8Dah1V@6*5O+((sDsSLi zX92lxo_>JGIp2q%tciR^I)`{nevb8+k=Im@PtkQASn>~%9I(mf&miRR9IXV4XM%XZ zIo~g>g02Jks{?#1So{;k54N^+yXRpv$6toT)PJqf%2nC3I8PVgYCKK>FGRA;9OBa4x@mDU}*5K-e-jO^9bdG zwR>RtrPvRpRE*MEMP6yPZjtO7=CO|z7e}+OHGtiPZQcC{rp+18!2v!z zz{duddNlso0bUf~GXlIKz!wF0b%4Jf;9CQHPk?#vSh~*ym_E+vReGij*95p2U`&x3 zPkn&*3Gn^_K0Lq}*0s1N2l$)-e>=cG2=Idec7N9T`|?si=dVnY|F-~F={_5s`)rv0 z!EpZoj|i~)-`A)0xq$xp0MlQXoaF(&B*1F|{LKLK{94@C0{m8hdH))Z`(M`Qry-zE z4Dhr7pAcYHAefvl26$C~uM6<40scXN9}4i(0e&UG3?eP9HUY+-veEklczA$E1^A!< zA06OX0Y>4;WS$jZ%q<&zb%4JS;Cll6+W@~E;I^8AFgfU58txt7p#k1A!07lI|KR~f z_txmB{u;h9z~2q<4+H#2fPWF-HtGaT&UFF)uK<5Pzz+r(`}`L7PXT^Ez}i{4#M3Fj zy#xHu>?g7!kaKx}uMaTWL|Z=B1^D3r|02Mz2KcQ2$Jw%+wgKKLz$XV7qo$UwTaWLb z!7Bp#bpgI5z;^|BeSm)+;AaB-T7cc!e4iFm1D1z;fI9}bHo$`eJTkyz13V$XlL9;^ zz)J$WEWj5Acy)kp2=M&@eiW>J4flkwy>ov9U1i4oPk`S8`?6Q+W5alIU{BvZpzj#a z`viDMz_V*WZwTlI26$4yb6h~5AJ9((`?7o?z-I_kEIO*q8CLfd7U7e^Z#a zuj}3Q{eb_zfakvh{Az&T3-AuA8_V0y0p2ITM+bOufG-U2e+GDcfL{pkUjod&9F}h1 z0Ph>%qXN7TtoXQ71Nu^7>Va|HrOfS(C?ejng>0-R}6&chA? z9uVLI0z5Uqrw91U0lqH4KMnB90jA8>{`IOUVXDLE%w!v8ylOZcuhs_ix&RLi@U8*g zBfz5q{Mi6AjlLY3{MO2tN06n7Iy<`Q-qACBRn%_}T#95a4eG_}c+yuEXTt8{h{5{7`^diDUdP2KWyF{!@UZ zPgvs51eiG>lT#gF-rrl=e=Q~X_TFhL++GKc`4zClxj85>^7?u@ud`tu7lillct_#= zJT40Jy-D2O!bf}DUwDeg^zm~&9xlAdTrb!qhZb4%vnKSF3ielF!QKC@_3c-Pd)yc@S`4oL-;9=ZxiNQ zn7DTfb5FrP6z01a{9|G6FZe;>cRYSVn97F!--4{Y0sm5%`wOODXTA&ksxWh0;NJ+d zatQnf;aZR15bo#kTf##;epk5O{`m?C&vixrcbnobBNrGp~P)$Gj7! zc+7iXmdDKBvS^;XjSyxZ88Gwxr+9p<@KTSlXK=2^%mc6Rn0efl9-ko0_dasY7QWhJ z=5DX`c!ltd9#bf&K?|O`8{@otaXaCS+=5N@@1o`yek9f>n?-L&1Da_h&c<9TY z_ZYo?<`AI&RQPp|9~S^;z9=98G0AU|&k@9r`0hX#+|7T(um=BGdB@w>vzR}eSSF~#GoFmo5s^E&2v z%pCF}k6BE3ipR{&F7=rCaO^`6w_e8zk9QYd>2ZVbDv!qtvtbMThv{I067Uf^ZuFS< z#w{Mx$FOJ%9^N7MdOS(^L62t$Kjtxg%m$B{1AErv<-#v}%zFb91jzi74(3(Byelw* z0lr2@h2}B9U(><A+KP14%1b9|}7X^4} zfaxnO532%vZGdkHFymO`r@u4&M1Y?UF#VD7(7zZ?s~m=_1I#$n=yd@e9$@+i<2fL} z69YUgzzYJ*b8c~Y&JAA@;57ke%wRl>6AUvpFsxg;Rjw#5Re>8z5n;HFSpe_UojAwe zn&1ZK)3{~ltSHvewQve&;Fr@98W|N@fGS0IxLQ0lx`nI-`0IKXJLy)FihC@3Q^R< z3Lk_m5DwGrtjUTszMe^sFs|q52<1I3y?~-<<}7Tf2%)^YM<@CWl%uT=L*C^&ERJCG zj^uq+>6){!OGF6eJui84G_XfrwGTtybvlSMSO@M3P1yX64*>579r9x9yd*GceA=)(eN_IAB~-uatxTNC~4Hu0Ph*92Qj=yPGq4kBbn> zn<#nkArF-elee94aNDC-`fQyI!w2eAzmmsujSS>b-?YV0-iCfrL|)8U{sz_WHl!H1 zA;WhazUzo#!|R6?i@OZd$)AS|9=z+W!;8fc^}Fqwuy5Ih;qV?xO_|`?*CkJ8IQ6B$%d5|t(rG~2nWp1@ZO$&+u?l1S!QQUzRcX|p&hZ-p@z_{{ z!-NvSh^vSz?{=5$Zi-e>k@>8@nu>fQuppSKUMeWlZn0Q0Z$Rk-rE;a@Xm{7K!d2%cl1GiwJo>DpKP}Jj%ZaKIm$}w5-bDIrs^AGB+so)cE6o z4JvlBx2pv4ao*+*1^T^R^EHHqd%GexoxfkAGK0a{{93UmIG_J9?2caDwsA?68FHcm zv8mQY*H$^5&eh>Eu7v&|?Duxf(_LhC8>O=hy&{gN)Ww`+b`tdMa`FS+ME%Iptb zx?OK19YCI=c)N};9gHU(N3CcgGy_)<*;HeU>-Tm|YAo5?HGe%BIBb--)A_5AknHW6 z|1-GR-mb0IN*sq5*)GjkUpCd4ZfnyhIeu@~{3DX)_jb*91}}E0f)gD$7*i^$?;A>R7$ifyCiirI}`~&s&>BPKQ;>i~HNcJK5!dHoNnu}9iP_Kne zwGFyWg@RW5MY5^p5-og-jGgT~oeOMNoLR=g&9Y6kyoM3Ag}Vq@9(R$aF0rq4fs50> z&|T%wF0x1)T&O1pUvlXTPb^to82411`T`$HvZ>Zro{@!JJ@N(e+*sh89m4Md@$KzS!L}OEpJJn{1 zPO_2)A>VAOkxR3wMp_N|2ax~siQ*rV zFB12$S;A&hjksg;eMol${Diry|wb-D;Nmmq@k`Uve5)R9>2(!YcKJc*&`0Xw7) zo_$9JIgwOJnMbkr6v1`P6xcn*6^Va|`PIwMpjchv3zhepr*y)m+8qinxPG>$!%<-@ z1+H}sHeJ|sU{`Y^oiJ#AW2dc9DHqA=*WjT1Xc#-&NX0b|)krE^v@LH!5c4R@GDGaPG*CkBYe}VN{Yd&Up31 z;&dj!#(;30_tq&MLwUOD=(0c=ipS!OComHd?V_U_W0`myt(-5LBE!7*B%pgofvkKz zWTb16uyT5U=so|N+x4~hIpL1X`}BMj!nKajb3ZEgI)`h&4!tsk|xJSfd)+eBuSM^8u` zC;OhZ?ye0_2T4kn+XxoXFju>`jZgs9x@w~zX0 zI9gMZl_6IJ&!qe!OJ=B?Xz%?n8?5h9dKUgnP)w5lz?7j_AUb~xh zA>H-B22szJc7bX)w&T;QWba4W#CDK#MV)2Wgv-$h)Vbuw3(4XR7n(3uPsU$kp{lEB zv<}&&F%qK?wJA9@Des7Ajv1ATi2o=*ydjj2WENzzD?VAbJU~lk=PaH!eNfZMO&@VZ z=_bsMB+?cvoPXTL+ocXTarlTqT5LLK=G3VhhYlJ(uzuh!gM6+&z8q<0Rts2JEQ6tv zsk&ii0Y$f?WC2CpP02=z?w;8%NyxUPs#_!5IDH9rQ1n3Q$#=IqwLbFpEA$N_;|~$$ zIs_|(WPAjoP-Tghpbwy7(;~4kA!|8`o|4Uq#2!T|b(*sPQHi)z74{uAVZ&jQwj0bq zLu1)8gBB<`lMIP1hGY@?M>ELqAFYEI|bOzHVgYpt&^zZ^poxhuEb3g2u*Xb_up%s^DK?p`bA^OhBuU zO$jYLOw15$yvgf_G&V5k<9+LVpq+tF$bPS3dn*|j(2ZdKsaw-$c;Zv!&nqkK5+hPBlPdp{S#k80s> zF_dezzGlaP`LwmqJYTGv!xeQD^w8DoS_>AP z?}GjTo%(>z^Ky`G0!ya<50qS#&c+Z`Om`Wa{_#FfX@x^#Q|Ou;F|(` zXMmaTH2E(C_zwa8TY$6bgpA)=()Z5}`fo;O-qP^M0FMjs;Q^i+-~|CbEx>G-VluxU z;GYKg#Q^^y!0!f_|3*zt`v7+huxv<|c+l4}{uu#2J-`%y{~lo3AuaJE*YdCCT*8PmI`4GD zOoAmkGY#+QB--*MsjJraKota56XTmsc@mJ&9NsW1wXy%OX z4iUJI=8h2`{ee07a1ZJ*jQ# zP9DH#tt=O7Q{FA3QbqtsrpG(RPptjiYsqYv{anUs4S_9OeZec%ry|RRYxMSyVxso%4(GUv!Ybw z=_=Dt6TA9!_|lm_LHRyW`#{MYq(Et^^%t&`rrKS)R-v(wI)LU;#s7S%1EEIQQ999n zTXE7vP`c_iF}9Yb+Mh+pu~ksY@Bhj2n$$t7MNUWQ&)_-uF+9g3Zu~4ksfF#JVkf$4 z67_~c+MKGB*Hz2?MzNads<~q2_^`13Kc|b`_W%4M!Un^$30<`;s$Tr}@3O9hz9#H- z)pB1^9NYgBwPoA?^M2?fkeJOeEVunXS=ML!f1Uy!2~Q!18i?)x$x;W~|MR!d_kyPw zRX>3^?f;2VT5h6p;dRy2-3ohMwfBf^x@xUpGF`PSKJ=4ZL8Pn3`VgG0O2Al=uG}C11^zVnu_j zsPY!plm3Y@rH%?tG3^WSVS0(D3y+Y4#FH&7Dtq#U`NTQR#i=e3QyOIRGKyb7BT^b< z&^i`a`YH`FJe>=Ce@cUljrvNva;{ZJT$|{|ERQj+QCDzUffu+q{R^)lz;@;Ai|0!& zo#BNF(z!6cLviX0f8oAe6#qb;kp;$h(jX%{4TT#Cxio%MA!7>MfszKvYK6egTyB+NH{t^wc+yYTDepk*a61<1o)H(Me^m}Pl#T@e|nftz=G;4EB@Z68( zmb%>S)bRt42=~viv2W%luj#xc4YFR6+>qnFnECl1#6Kp-`l-xg{}67bL6+<*>v!cG zLLQ!OQmhF%)^}x||A+9z+(G2wMf#aza;)iUwks!hr32;ZKtVb9Dr-#Iu+4R2H`5HZ;V;#GNl3L5OLPWue`q*gm^8f0G{#vOglR zfn1md+2!0P+m*AEN?6h$dmgr9T$GXqSw=~sLAFv2zVJtqoa)+pRG5NiTFi}2CkkNG zohM(&A#{fG6bfs|^Gp}NbD=99+m&;FGBVq-)fG;b7-^6pZE#@(A;&vUePIM4bDXCk zQ74=0Jld6$n@yMD3XKLCHPDHE!`)92ZV+ylK3e2wqR4a zo*OHp>5eDgBGNtMlf(^wrCoL?BU0yRdC3R-pIw9eKO`kD+hQo$mZ?gVWV@(@?lwHygbElt^d#G6XoCcHo8aq^?Ir^4 zuhO0;pK_hAjrFxQt=9Dsw76RAl=G4FwiYj3IDMXWJ+U1*K42RhcEj)+Ds-l0>ZnJ?X?q*Y=(ecJ44iF)EjdR%JH(~qY$e@Ya({PX*N zL9t8Qfqeq@iP>0T>l31>rLmiHT=jA;In&f)C_vxO6_>3m4@05bJKo6|*mUyTMU$sU z(`wPe4LNpU$E=(b%OIHjq{Q>ST@v6)hloIH1WGs^6F zGv8_tqlNH3rO;#!-|0^! zJ#RQBuob&wr&s5+;%)5_6w@43% z(^2B1izCh?!g)&U|IFdSHF|WY7rtc;>nrnP*Gt+OU8FIj>u=;|1AJ(Jj|}kV13Wvx zivoORfX@x^MFGApz_$eWkpTZPz^?}QtpL9t;B9(Istmb*rC!o&YRlGsut#KAt4&H6 zyZ%P+9N@kI#>Xh2lNtTE0G|}#WdXh@z*h&D70M=uc~HYFnK#Uz28N#t@aqA7 zC%~2JfQ+A&qJ~4;;S&P-qyR4o@Uj5&=Yz=!?SkJB(B1z{{+V4D(BB9!_Nz=zLH&^7 zVu1SxxIVyR0?gumi_4;1!#f4IF2K74cyxe|3GnOypBUh?1AJkCZw~NX0e&FBPX_qK z0KXmJlqSL~|J4ER65xIT-YvlYjP3Aq0y!@Q_zwYo2h5O4?(f397jP_kH9eq_U{9Y7 z_HCdkpr0gc@01nLb>OZJc)lLs?}NRZmjX;2%Y&Ly3BzjiP(P@9K<^b`-h;-^d(g0M z%NF&3?$rRx%KMNo`a8JCJl3NaZSa^^IVr7WO$Gr$JZTdy+@rf;_3vl;lkjwm5>(l?wb-Krpzt1>X`q5Tl9U zo$)P@KP<Sc|G}7gM5ytf#9TrD0x>NFs0Piepsr;e5*Cnr3G~~7QVaU5&hs6<$ zej$12JDW3ji3p**>aOMdRr@gHU8jRM)|MWY!d;!-3FZjnxW!+M?=KpEk1{472Hzbz zxR2&`)tq&`d31#b_n;2L_~(f)xV@#Y^$H8iu|VY@-_*+o>DQbnd1J+6&eD2Zgizk8 zk_R91K1jdj`;zy93Dec&aaDIya%&12pNYtGO`ko*}{L4P|~Pz&n#?`Zd~T zc%js5id)jJ89HRdP^Vr~+_HYnI_|47!LzTstZzDP$}V(<4)UpU{F2V`)jClCTv^A3 zW+)w(8by(gOK*3{{@4*SL-A!@yOEB|c@Wc?U${%vNW#)pJX!jO_eovS`-l`5)Wjon zWaNVXpF#r&Y7yaoPvxchdv&UymsDl@+E4P2DBM0eDx5Cghxk9jt-@ygwyS$LrQTxm z_R{)ImTUfRELTjj;MOZQORKzsxfyx$GoMb7_A>WHDaCTzXuDHsNBaE^I;^;N(JhBB z4wwsh>f||dnu-Hv76%-x3&)Ik^9M{>JbTU}EqmI;BrkKk)29`aJ-SQlS;opXK4=DO3-eW_`6)kr_2H(bHa#0v?sHt`H=2*qBNaFq zC<}agjGFa6_?tg5AAWDx)-B}gMHIM=_lj-f_H2ZOl(!>)rS{pl$rcihA?fpDI#D_L zRl~dk40i(imq?$0?#50&?k)kHagoK{JHYz~nDK@2Obl>ifM*1FZh#jC_;fJJ>~gML z;X5|z1Czk5IMX$Aw~>QO`tt;HwwBP{V-pWwc-IY6S5%wvh3{*TOY(*U7&?4s1H7|z z`^%5)22X!fo(;mh2cdItKljjKaRj5gbnFK3&cY6n-!MUc($Nv%orQf?{xIDeRL7)4 zx>Y_5zq@z3nrkfq4yZ*vy5LWHoqw*}>;saZYqyx6@(#xQxV0C;EexGGB}_o(=umyh@+ zkGgC*mbpa<6-75^^88q4(eycU7|LvMEHh$gef`#sWnSy1)RaFP%e1t8DV<=nh0jz8 zvQ8mb?17$eGdgvq$|7wmu%*Kh}kL{OnN`DdtKo-6vgWbKS^xU749gO^j$S5?Im|W-X%E6}|{@rYoFNu}iwbJ4jTU zwF)*};b#?V6S~3|LUuaA+1wY!Zo0xt5w_L3!aq?=(-pp388%(vpCP@TGNg0AgYI>O zoi^O=(DS)FlvC3cUIX^J!cI+d4|qD}ipbd$+&T9gIWt}1cSS1c3ZG8?6T6n~jcB^U zZxY*dg$Kd3SzX~DDg&k~>}t&G3bUW0=?bIXX1c;oQ@5F2%MaES?k72>EBtHa{R4D` zSBbTxD|{d6o38L~WWaQV-zs~ug)7RQe1SEnC0$`YvP!zb?8;Hn6@HI6rYn3RaW<(d z%*s_+n@n_tZzPWC3b#d?=?WiAi0KN~5n{T+PRHAHg^wh}bcL_sj+(A8cc7#zd?2|t zUEyj(o38L*2r*sZ8;N7O!Ym`pw9pl1+Iy>Yh3iPi>k6|U!=`kFze4g}SD1Bf8Lumx zC9c;Mz60!ag)fK4>k5B|n)JHD?;!s}=n6kax?WfKY2t1|S9nj--N3_gNbU%**A@N( zdGNZzSoSqt;WMGX1i!3Ja@n%3@J|)}lc+1qb}gnW{AE>7NmtlC%cd(li~^gka5Yi3 ztSfvCY^E!`0gvel^H)VlS9k&;o7ENWuDemv6`nyZOjq~^+$Yl&=1+x^uJALkwa^uQ zSE-bAg3bUHJq$_+Wc{W{PXNl8vg;}6f(iOf20j4Y5NQmhQ zGe=m`6`qdge@$2T5>?v@V<8jCucxR)OC+LN4#pI==^p; zO&7@Y24%q zi83+CMSahwU2Ib!{%7o1I^Er(GugRQMuR@gX<}Wob6Hhb_j8~uQZ~~A?wW~)ID?hl z9MI=baX1u#&DpIisS9sxIc@RIqkha^ zNm4)N;zrcX)Q@S-eG&#PjF_9NAJZ1M$WZGf9Hp~!opo00l+%OhosGruG6=4SZq@li zOc6Shj34*R->1wxru!WHcoddjlX|kVRVmw)GJ>fy3d@PA@(IpnWwpA#P1&q$uCQFz zQr`TGs=M`rX87EDz0tu@;}*1;8(j=3k8WlP_x~GHmfO^t8>cLuf$hwu#dBnEQw?KQ zbdvrkz-%K{IHeaqXY$OZp$eKgeNi&gpV)UiX`wVH6XSj-PoFG3(x5^tUg2gfKQ8x>Tg` zZ{SkygQrYLx!Kpy-@(mEL!ot`iyWrFoHfHi`)ne-hy3OUk4kTLdtoPUZhBJxqD%hvkW$!W%LY8XBlid%S>rQM+VsV1wR(shf7|o+<$SN?*5D8v6N%@ZhB$eg=7EM;WqtcYDb^tYW`M-{Q^8Hz}xI9 zCUx~;?J925Ury?6oBncA58L#YlX_U9zTEnptJAjP{(KMUI&g;sJTt-m zU2sA`Uo33zl=GqMz^x2;zT$a!Z(JAfY|dul_X7U=0y$3x_&Ko8&$|I8Z7T~CMTTKD z{Lkn?j}GMQ8({uaGWnkiFtf8ppBZ5H{`CqUj92Vl@NPDK=I@REQ(@Dme$-<|ff(h1 z&K&bI9wXyLj~S0(cLyHo|8wzfkfvsFIKeyUCj(Y;j<{Re_x< zK#8-k#qt^^!b35#XJLEtNl%SFHhc zt!T*O>%`<;E^KiGqsfx@WcDtbOif>aoLk}vHIOhH!KH8Z%3tKNjSTC2T9Mmu6a5^oz z;@_ad;s{1>OCIgsoP|9uLMU&I!yk`osN>u=UtqxZ@)f`F~jpN&eZp)R7E%(*AG3bXQ!&y+MZQYdD&~(wf9X- z;w=C6>m569IKQHY0;gp5rLLnMVtKL5a_XPDyrEdT&1zLvhm!x^C|deZ^@;;}^xXd3 zs%ZJQZ$JB{ihP&nQI(p}x~)s>M=r7NSLP#uKC`x4RdZpFb*mm^;*Y-@WxqRJ)J(jLiHhz-}GuY*gK<7%Y5G*q$?Q3)TR09w^#otii?1U1%>!PR;C3^)+@f__;R_|Pig)Se^{pOJXi47+ zGwP;q^)}dSGoFbjvCa5hGHd!)tUoO2Te*FNf2?5Bw_>H@CiJbImN3(|x<%}!Z}n%` zw_4wdrBRhsqFu0KWD{;NPl~W_| z`c_90*YvI45o<}`3JZ~&(zn_jNv3bLFHD=&w~AFArf=nH%mbB#avx!*Ad-aS3r>T`tU&fdbc=n2U805i5N(=W zKcGf8xsR|@(zAVpe?|^Wv#YzFkCJBBB0_8*;V)+7v3-Q6;o0Oq!cNa`%linoL$vK9 z{1)Ze>V1S)s92lZN0?e@W(CsSHLuy_?%F1-K)So;HM`thOZE}YRgp)p+4U?q*+)1R z>?54}2X&n6Bb;lZQnqRzVY1nfdzNA+`v~X86L;f%gmZ_HuGj2373?*;oOYSl?7D}KElZNnq37ac0yu{ zeT4T`l4y3heS`;)zU?E7>EM!P*Gd(zq}g>LLd^78x*x&y1b8Y`c`!>ejnjpDxFt! zg84Na@#KBuiJBJyaK2?!jnXacyFN#+CrcUq3)9q~m3`Z8dX~|xG!{g-& zbQ>P`dX@h9+89EwQzTs*9)o-DqL`WMDO|GAaqkYg_Z8iL41tq!bga(3pH$^k^rC19 zxz7S_!=jiQMi!E;f}BNlUni|(6XkHpV9R}zmEUmL;5L($(T>fPwVJ7t1!`v~e+7zX zc)KL3U)Y}PT3&xiNVl@}%3@%>vZQ`SlpYBWuxBX?o6tWitCjWgiO8ntUT*8;-eJ6v z&Io3o5-CtUtJ{p~*&%8;Qa$4`M@OPr2D%^#;PM}(0MHdl02dyT=DKJixX(Oo)y&r( z41!Q`CQJ!hbipJ{jZ)xa&JOASRfkgH@~)2N`Q4Nr99-sJ)FV|9eOu4wHa)n1sp(Fq zr}Hsc?nDtT(~AGm{g%+$&sk85idy9pVzVuwGn=3_+a|g)Rl%0fCQV^bv|3!}w9cs1 zl|p?AY$FXvmFG|-QBcc^*_T?1dI?3FOiN0TS0_EK&5MYe@F;^x8sZe)@}WqTUVbX1 zI|&sORiVjN)?!W4Rc_R>8>cnRZ=5xG-ZabwezXm%x1{O!@hJFhl>*{?HJfnFb>m{E zdNyTplUE~~HGi?x$h5m`)Hr{hwh*7as4>|qdg}c7$IphTY37{8y1MP5Cr>?L@$7}u zrMfnC@xrFrCr(e472Tf1a~Fu}Ro9}%*-ed8mrQoMNwWdwlsU&Iij;nr>2ejgxY`5S zO_X2WWy=<@OC4$hb{XK~Xk)DX9AV%;=%!SuO{2hE#)l4hg*r7YVwmKMI=Y2kmkF2~k6=^8+KU8Wfe> zrqmGmlemWt##p$l4zSVt2qObJ^7um)e!lwn6a@3f9OFWGj?}@Q&CqA*;CmCyXcY$! zxLOBvz6nhZ16Le8VEqr{c)qDC4m!A_4&weu2M#*eWIiFxXCXX%L{@nGnyxt1F2V2+ zW@Aa@eEQTbn>Ue9q26U{Zo79hp&iYmD}MeWGlzeq_asdy742(*x)Od+3;&E3ewM$P zgMYaWYmVr3GR~9F&gxSyKyS1Qa zcd)L+HC_B}6tLn_ zjo_TG+xgIy?y0(>w*U`$1Lu65p95VyHg^F2rf6$C9r@P>_*)*+?cU)rb%md};GYEe zzdfcq{zZVF2P;2CUBQ;;-w8wKeu8tp4g488mE+yN+9vXAN|*bEz7n`nM@*xTQ+7-G zS+o_?)uQPe?gUm`9IsN-d+IK{O{ZAXQgOMiw&@hpO4Mhmy;%EM6yT)+{;)d5+xBWt z>UP^+?MXe{oGG`lZF{x*I#IuF&)xsVUhPw}lJDOIGllJ4a4K{ixC;V&d4R75`?za` ziOV?UKcO=ik^4@-e`mn|V1Sbp;D-YIXn{kk;3P zzw9yh_EL{;6~5AA?(J7S#%AF+J!bs=ZI6E}e22#m3jfGs#`X_-%vk>C9&?}hYn?p2 zCj2Xpe<%Ec$8QVcK5iZSvB*>!xCuH8PYN(~ZS*ApUKZdB1H3xGHw5^$0Iv%$&w|O{ z5a5>s{6>J^3o!PsEN&sd#Q^sYu%d32D~e0eN^1m$3)kr|m-e9LnuAGtIH)f^yNC~8 zUI))ZDDN2g-_>ExbhTbc z^e^Ttj6UBmVLxo6vIhi%3ltWX$0#*rf@h!J zXrna;j=tp+Vs6uM>Xum@hxGWD?|ooJzM@aZzGrHvkd6Ab?$I;7wrBKwh1B|=+C5IF z%UiElZs`2wTk(+li_K-!w_b5}!dTyWL}jpsz{l(P z5#!ZtZM@0R$?;Vcr==gdq9wLhFV`q0V*C+GEle1ByREsSWpvVG-czsZUrp`ZHB%0sJ0q{p50&E1AX(aD7o zD_1<(IW_dqO8Jhg9kI5uD$4II?~%1fuB}uP%%5EjJGpT3%Fl_Enmv5dE*FouwLTs( zM$tz6aHvvxsqIju^inycW_5p0#lxvzrGKCKdu6Y!S&uPVci+}s6ntBu?a&{zq|=r* zMW>x@ivGIjkCo&McJsFKM(g6_SvL89RsX08kW0t+t6z)1paGt5K#_F6&r)NuADmMx`TKlQ| zalna!>FO`Sn9l4jmh?$VJ>3UNEmp6*<@g+%eBiU70<>o%4T#z8AO{RllbTOF#A}<*&yI83%N) zk0`T0cw zCVo`{UMpOJ=rvCC>#ECN%iHEJV$gz&qm@wGMiuHdSL1r1QOD z!ukAvkhR;vei_XjcS>G${yb4Kcf#K>e;f(k!)@xEZ%y2LX;sBMOQkdSohu2o`S;+t z|2x8U`4gzg2c8!0pWmKJ`N^M!2e*~hR+M=N`NM^k%ZJJ3NMU935z=bNzd*V_e@Fad z@_*4e^BAii_G>G%aZ%<;;*QNvBHaz}ACg}RetN0!g#1s*!}B>&Cg%T6jlCENACrF+ z`b+R@K?WBZNe9Z)fr4~!Ug)aLGZa)2Xa7Ti?b1}Ii$HS;A~>&)aEpRE602Q$1?(#& zhN1`TkUDsFnt~Ham6UlD`#BL@he?6mvsID!JDFd7?@JU*#wwM)nzf3+f{ddSUU1KH zPluzz0t#H~8f?1oL!$I@4JoT+XkG2n$gI)mP`&3K@eK$#nwz$#!%<-^p1qu>vhWg~ zhIn^z=L@`;OA9huLAzbCeRga1j@5QDhsWAEc3qEL_>)3pYL{9_7y2n!3o;1F z7Tl`0V_cNHat5*HM@oeS8CR*n7j7oWsjj_ihf_S$Vs31@aEqjAK?a_Dp)*3Yu2G&s z;lETjT985f&IPs+)Pjsr;;t=Ru5c~LfUT}@83K-Tp23CXgdFcY^@T$Snd3YSg+@Gc zoo8&+iknTB;R;=)EK>uW=r`Q`6ajPH?b0(uZkOgQ(upVETEGh~@KJZ>t0Vmf)l=ng z?nwGd<+O4H?Zveb_R4cjRB}2B@0dP9X~z?5h1;dEP~q72HnyN8r`Zc4KJp;PIl(yR zmN?5zIQ>JVAAf#{<2)VCzbaRkl{oPwc~Act&PmK5w@asVZgZOoSBR&)DV#q;d5@>g zQr@Hd38Kf-I*FXl@1yn?PbZJrJSO|&8RR0LcN=HUB%SIgji7ke4f5=Cy#&PPQwQ;Z z`T*&?KwBHf=kv67aY>v%OF^BbV(GcMT<9W<(z)x@DE=~$x(!lo#ut%wWtHshR3z`G zz!k48i9Mw(_7o=;4X^kVDyQ>2&z{IyYVyxSezemCh&$eid$T0&__Da;%i@lwe?gpM zPsE*I;ubn_#ab%H_0$p`jV70?PtnXlcUSuFAQ#ue)xdX<9gpwn3VDZ4gyCD?A(J?ChRtg6PPk^`A&L;~f_sh5(HsC+F9NK@CE;}o9;0@v>_dg{vaSjl*A91Dth_x7iTzZT_ z7GW@w1|z4}&6c64*Et>zxm-ZGe|@9eUu(>LX_xlt5U;*XL#BRMnYfbV?h&{{VCM$} zl>5iI95&z?E{FDiRTsVs20kxguOB$m#Wp z;`_S4$HO5%7f|kRl-TBV|BNvYeM#afM^xOVxhLxTF&!#|d`TN#PaED}Ji}ZYUQge~ zyz?;ESFES6cpR_mF4ogsROy-M;d+eq^ceBs!(5lKo-U(KVa^QrBcu=?I$VwaX9p_x z`zc_Tyb67yn#_2G(Xtnc)>X7GiZ;X1j*iFZp%CeMk#-p_aI?U&gg>=VpDVri>|x?- zmqP^}7FZjE_PJZcXGN5F$F6P$JLE%|Dy$spYGIvNG_j&upf-1P#cmr@?xU2+-CVib z#uPjrznd#|+n9346Lxc@ZX3H|AGVt-cH5Y8$A|a&iNyX<0{c8AKqIM(8!JxK`Sb3P zI9AUwx2Q?yqbYe*zoQsiwL4OA+NDQ{FycC;pRJ6kqF@NJ`#_PauBAe$sN`k#nR?x} zY&xE$c+^$Gf2@4b$nH8-?HupHmb$5KKOmHoQaO%bc0sD@AMepa$)~zgSxN97jqvxP z3<+V+4Z87K<>q?1U}LH2PD_Pw8(ec##4zV~-#-<8q;v;RJ@ykc*V*=-+8 zpk5kDI!cr38rpmrU9&PyS=+zlD2yFMaJ zH(AlQdx_+^5d4`EF<9m|vLsJLr0r4SQq)A+o*~b;8n~QOhp2(>ppKnCD32xe&@4yz$ovICrqlAIQKf{}dg~ zqZu`J|H?T@Wzu2JuTz=JstBaP=mX!CT>+Y-YKVz_mqXhsdP zTPBsVTPBsVOAhYUq3m+ubs1!r&}SWKJQqTnXZHtNVt8H*zuhRBQG@K3Nu}(TNu}(P zgTLuecDelB!6Ug;sB0&0hh76}t3y0om}yG_#N`}9COL-jT+Y%_5iN4pWeJ(fU7pO< zWR#l~GLqCMSn6?f1W6Zls9ao#CTfyuQhk>?(qUXo=wYR{iqOC4P#i8WR74jYV(}5l z%RZ>Jb@Fa-q(iwd@M>Px&Wfy8nw(yN-oa(=bv=C*P7~q7FG1B_na6Fsd}hFj!$%Ba zvCYh>Q#TGBsvprw^Ka;^cXQX2^*A!bS6&25otPQMjDQ z${lIhkNby8gT*M4Qv9^(GX~D$PNC&4q}$TC=;Q^{n}l`eoXPqGx)n)+dXtNH@*KfL zgz7vYOMiae{DfJ98F%+n--~U#hSS_C&6Hay>ehm4t)@0=i2Ul+wyg6^){a)V6{N}e zvyMN_+R@ahZl!42ul5X9qt=w;wsCPk@6#gIX)adk17js=9rux9Jr%iVk;`J*B^E50 z)nZl_wpO&-&Yf8-n=Fbw-SH~EPJg?iUfb`B*eY|EOku^bB2=;(%k}HpJEuA z_7ajMwn)hMd_oC1Lur;u7%Rcaa$sS*c`mofV&T^Ah9&!P#I1B^Z18`r)b@X)_5v&TJhGTMX_bE{JHe;tjBG1&&|iZE_dPd$?o?f-FN2RnMv-=0=Zd9$RwGN09hswLO_gvQ)g*B(<~hdy#?fma9@}`ixHV)jv8@9{V}6Pj6Y`V z=wnCKk4v^Wyu5Tv2v$`6(vg`mQ=cZ`jG)k2^CmaMFM+3Hq;*a#ojPeL)k%kirk^&^ zkZ(>JYLyP74x_-+^N5qZe(tm-S~q914x*i3x<9FaxoS0bxWhe$6I352pEo58DxRW2 zuXFXIiDXL_Pi>%uP19MZ6LXp})=!zYkfr)Xlfp1}s;&Jpe_n%XV(mCR)xu__dsl

    p&PCZ5LS~(PquJoZecK5kcS4g zor8trdH7EqF1-2oNlGUmL)mF#$)O`g>|fn?%7S?f4UO~W&F+8Xq184Q#aoHn;%QvK+;)8{4Q$BwEW zHhk<+W5$mgRX=9*xKYOp8#DI6+LptHkJkURyE-+U>9?~qe_TwzCa;Adn&|E@FKFti zX}Bg5V`oQdK2#GrJc*Hz!zSmEhlCt9Iel{ya=5)F>}0edY)ci(f)8m{X2ZiW$&iy1;0C*v!%9z5t?ZJPiSJy?~$5YV*NN<(46H{Hd+4YCd<6#9_;)6a3OW6rA#hLsM}l!@;O$G}|Al#bSv z*(G4=A5Y;*6EtPI1q@?}GrOid5qY)#DebSzB4c`aL31*!jboqbhxNehvjtJ-Qq9kF ze1X$p9eLUJ*F~-qb2ek&Za3(V*q=70y1UqPdcxA-IKZZ}htpwSp~LZkO@~_ma%{uR z##c+OzvNKlT(Fd;XrkPYX+9m60>=|J9bSu?&itsu;ebu&tSD!d2^_l!DYqyyV{?*UPMwB&F;wqbtX zqn_g=hx4&L*CAKAbPo=3%ul}P)865HZ1X2Zo#mR#2PNdC3vp9q>W?3_ZOa|7?3^S! za6XDspK

    I8VY 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

    H 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 f3#T2oJcwvgzx5i84NRKEJ*VXJLvL8?^6F){} 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

    Qzc$8;$ijEaN&@-Py4))AvyhA;Y2ha386U=1e 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 z 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 U#kKV7KU-~9XZk@cR$boz2mJgL2mk;8 literal 0 HcmV?d00001 diff --git a/components/newlib/lib/libm.a b/components/newlib/lib/libm.a new file mode 100644 index 0000000000000000000000000000000000000000..f3fe6dab3ee9690d048156511abc069802bc84e7 GIT binary patch literal 2227074 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 z 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

    E%1iGtWxXgKNpxqYF)lPFl*Gh zyfQG$)4IH8U{%cllj5O_)8D+8|yd`sZZ2WEv^PyfllEO6`c zmjb^M_?LlM_ty0f4y-P1aj!96gZX$e@8euwSY-VyE3zK-MOKw8GVkv^ZhU`NALP9P zHv}FUczECufg1yl4m=_7#K0#9j^nGdg1kBKyugbBw*+1lcy-__179Eb=D_O%-xhdN z;0FUg9Qe_|PX&H9@Ny_H=yVcaV9dL!OO1K&%6mO@x{F!x3T8~5F-&+L@jB!E#h*9sC%)Twp!hyx=F@)B zc%*o<@mTR=#>a>mw z6|*1-X?{jrXMC%8591Buy^Oh@`xrkVX55mvPm2c{b3G3*{*L%yW8USCG=51u-uM;q z3C6F9&oq8R++_Tw_~XXRnVoN3DPC$^EnZ>F`1(c0oy3fv;=_#(6d!5KyJhA^lD9)-Pc&{6pJsfxc&ah)pU*O$AU@leIk5|k7mLp^ zW~_Rp@pwT{|Ek>I8*`jDjlV1R zFUE`qmsjNaKNB;SOWa?GI~bGp?#6u2!B{Rj+r>SM{~+GaxV_x|#y#Z@G3NV^j~EY> zdzdlHPaR==fZU^v`7Y!*<3_oYj7P~m!}utnk$boCX1VtnZeyne=;$|I?U-m5Gmh zgqX2qn0NG*vM}qLYSHt=hs)j7c#PaVjQNIUFJtB~_AzFRd7v@h&>UdQyvKu$nQus1 z9P4_y#~Ab7%n8QKhdjlYG2qF@%q46xX3pWqjh~S_-}u{dml`u>yu$b;xfdD#R4(J# z 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�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 z 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�OQHvDO_kpoYc{o{yd$gWU+8ow%H`2E1r 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

    Uz$k0JYhIp{qQMeY9nd4=$^1)^= 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�@=QBocxQGihW92z8*jKK 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 z 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 | Full +---> | Active | | Empty | <- states + | #11 | | #12 | | #14 | | | <- sequence numbers + +---+----+ +----+---+ +----+---+ +---+----+ + | | | | + | | | | + | | | | + +---v------+ +-----v----+ +------v---+ +------v---+ + | Sector 3 | | Sector 0 | | Sector 2 | | Sector 1 | <- physical sectors + +----------+ +----------+ +----------+ +----------+ + +Structure of a page +~~~~~~~~~~~~~~~~~~~ + +For now we assume that flash sector size is 4096 bytes and that ESP32 flash encryption hardware operates on 32-byte blocks. It is possible to introduce some settings configurable at compile-time (e.g. via menuconfig) to accommodate flash chips with different sector sizes (although it is not clear if other components in the system, e.g. SPI flash driver and SPI flash cache can support these other sizes). + +Page consists of three parts: header, entry state bitmap, and entries themselves. To be compatible with ESP32 flash encryption, entry size is 32 bytes. For integer types, entry holds one key-value pair. For strings and blobs, an entry holds part of key-value pair (more on that in the entry structure description). + +The following diagram illustrates page structure. Numbers in parentheses indicate size of each part in bytes. :: + + +-----------+--------------+-------------+-----------+ + | State (4) | Seq. no. (4) | Unused (20) | CRC32 (4) | Header (32) + +-----------+--------------+-------------+-----------+ + | Entry state bitmap (32) | + +----------------------------------------------------+ + | Entry 0 (32) | + +----------------------------------------------------+ + | Entry 1 (32) | + +----------------------------------------------------+ + / / + / / + +----------------------------------------------------+ + | Entry 125 (32) | + +----------------------------------------------------+ + +Page header and entry state bitmap are always written to flash unencrypted. Entries are encrypted if flash encryption feature of the ESP32 is used. + +Page state values are defined in such a way that changing state is possible by writing 0 into some of the bits. Therefore it not necessary to erase the page to change page state, unless that is a change to *erased* state. + +CRC32 value in header is calculated over the part which doesn't include state value (bytes 4 to 28). Unused part is currently filled with ``0xff`` bytes. Future versions of the library may store format version there. + +The following sections describe structure of entry state bitmap and entry itself. + +Entry and entry state bitmap +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Each entry can be in one of the following three states. Each state is represented with two bits in the entry state bitmap. Final four bits in the bitmap (256 - 2 * 126) are unused. + +Empty (2'b11) + Nothing is written into the specific entry yet. It is in an uninitialized state (all bytes ``0xff``). + +Written (2'b10) + A key-value pair (or part of key-value pair which spans multiple entries) has been written into the entry. + +Erased (2'b00) + A key-value pair in this entry has been discarded. Contents of this entry will not be parsed anymore. + + +Structure of entry +~~~~~~~~~~~~~~~~~~ + +For values of primitive types (currently integers from 1 to 8 bytes long), entry holds one key-value pair. For string and blob types, entry holds part of the whole key-value pair. In case when a key-value pair spans multiple entries, all entries are stored in the same page. + +:: + + +--------+----------+----------+---------+-----------+---------------+----------+ + | NS (1) | Type (1) | Span (1) | Rsv (1) | CRC32 (4) | Key (16) | Data (8) | + +--------+----------+----------+---------+-----------+---------------+----------+ + + +--------------------------------+ + +-> Fixed length: | Data (8) | + | +--------------------------------+ + Data format ---+ + | +----------+---------+-----------+ + +-> Variable length: | Size (2) | Rsv (2) | CRC32 (4) | + +----------+---------+-----------+ + + +Individual fields in entry structure have the following meanings: + +NS + Namespace index for this entry. See section on namespaces implementation for explanation of this value. + +Type + One byte indicating data type of value. See ``ItemType`` enumeration in ``nvs_types.h`` for possible values. + +Span + Number of entries used by this key-value pair. For integer types, this is equal to 1. For strings and blobs this depends on value length. + +Rsv + Unused field, should be ``0xff``. + +CRC32 + Checksum calculated over all the bytes in this entry, except for the CRC32 field itself. + +Key + Zero-terminated ASCII string containing key name. Maximum string length is 15 bytes, excluding zero terminator. + +Data + For integer types, this field contains the value itself. If the value itself is shorter than 8 bytes it is padded to the right, with unused bytes filled with ``0xff``. For string and blob values, these 8 bytes hold additional data about the value, described next: + +Size + (Only for strings and blobs.) Size, in bytes, of actual data. For strings, this includes zero terminator. + +CRC32 + (Only for strings and blobs.) Checksum calculated over all bytes of data. + +Variable length values (strings and blobs) are written into subsequent entries, 32 bytes per entry. `Span` field of the first entry indicates how many entries are used. + + +Namespaces +~~~~~~~~~~ + +As mentioned above, each key-value pair belongs to one of the namespaces. Namespaces identifiers (strings) are stored as keys of key-value pairs in namespace with index 0. Values corresponding to these keys are indexes of these namespaces. + +:: + + +-------------------------------------------+ + | NS=0 Type=uint8_t Key="wifi" Value=1 | Entry describing namespace "wifi" + +-------------------------------------------+ + | NS=1 Type=uint32_t Key="channel" Value=6 | Key "channel" in namespace "wifi" + +-------------------------------------------+ + | NS=0 Type=uint8_t Key="pwm" Value=2 | Entry describing namespace "pwm" + +-------------------------------------------+ + | NS=0 Type=uint16_t Key="channel" Value=20 | Key "channel" in namespace "pwm" + +-------------------------------------------+ + + diff --git a/components/nvs_flash/include/nvs.h b/components/nvs_flash/include/nvs.h new file mode 100644 index 000000000..084fa7054 --- /dev/null +++ b/components/nvs_flash/include/nvs.h @@ -0,0 +1,212 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef ESP_NVS_H +#define ESP_NVS_H + +#include +#include +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * Opaque pointer type representing non-volatile storage handle + */ +typedef uint32_t nvs_handle; + +#define ESP_ERR_NVS_BASE 0x1100 +#define ESP_ERR_NVS_NOT_INITIALIZED (ESP_ERR_NVS_BASE + 0x01) +#define ESP_ERR_NVS_NOT_FOUND (ESP_ERR_NVS_BASE + 0x02) +#define ESP_ERR_NVS_TYPE_MISMATCH (ESP_ERR_NVS_BASE + 0x03) +#define ESP_ERR_NVS_READ_ONLY (ESP_ERR_NVS_BASE + 0x04) +#define ESP_ERR_NVS_NOT_ENOUGH_SPACE (ESP_ERR_NVS_BASE + 0x05) +#define ESP_ERR_NVS_INVALID_NAME (ESP_ERR_NVS_BASE + 0x06) +#define ESP_ERR_NVS_INVALID_HANDLE (ESP_ERR_NVS_BASE + 0x07) +#define ESP_ERR_NVS_KEY_TOO_LONG (ESP_ERR_NVS_BASE + 0x09) +#define ESP_ERR_NVS_PAGE_FULL (ESP_ERR_NVS_BASE + 0x0a) +#define ESP_ERR_NVS_INVALID_STATE (ESP_ERR_NVS_BASE + 0x0b) +#define ESP_ERR_NVS_INVALID_LENGTH (ESP_ERR_NVS_BASE + 0x0c) + +typedef enum { + NVS_READONLY, + NVS_READWRITE +} nvs_open_mode; + +/** + * @brief Open non-volatile storage with a given namespace + * + * Multiple SDK and application modules can store their key-value pairs in the + * NVS module. In order to reduce possible conflicts on key names, each module + * can use its own namespace. + * + * @param[in] name Namespace name. Maximal length is determined by the + * underlying implementation, but is guaranteed to be + * at least 16 characters. Shouldn't be empty. + * @param[in] open_mode NVS_READWRITE or NVS_READONLY. If NVS_READONLY, will + * open a handle for reading only. All write requests will + * be rejected for this handle. + * @param[out] out_handle If successful (return code is zero), handle will be + * returned in this argument. + * + * @return - ESP_OK if storage handle was opened successfully + * - ESP_ERR_NVS_NOT_INITIALIZED if the storage driver is not initialized + * - ESP_ERR_NVS_NOT_FOUND id namespace doesn't exist yet and + * mode is NVS_READONLY + * - ESP_ERR_NVS_INVALID_NAME if namespace name doesn't satisfy constraints + * - other error codes from the underlying storage driver + */ +esp_err_t nvs_open(const char* name, nvs_open_mode open_mode, nvs_handle *out_handle); + +/** + * @brief nvs_set_X - set value for given key + * + * This family of functions set value for the key, given its name. Note that + * actual storage will not be updated until nvs_commit function is called. + * + * @param[in] handle Handle obtained from nvs_open function. If the handle was + * opened with read_only set to true, nvs_set_X functions will + * fail with ESP_ERR_NVS_READONLY. + * @param[in] key Key name. Maximal length is determined by the underlying + * implementation, but is guaranteed to be at least + * 16 characters. Shouldn't be empty. + * @param[in] value The value to set. + * @param[in] length For nvs_set_blob: length of binary value to set, in bytes. + * + * @return - ESP_OK if value was set successfully + * - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL + * - ESP_ERR_NVS_READ_ONLY if storage handle was opened as read only + * - ESP_ERR_NVS_INVALID_NAME if key name doesn't satisfy constraints + * - ESP_ERR_NVS_NOT_ENOUGH_SPACE if there is not enough space in the + * underlying storage to save the value + */ +esp_err_t nvs_set_i8 (nvs_handle handle, const char* key, int8_t value); +esp_err_t nvs_set_u8 (nvs_handle handle, const char* key, uint8_t value); +esp_err_t nvs_set_i16 (nvs_handle handle, const char* key, int16_t value); +esp_err_t nvs_set_u16 (nvs_handle handle, const char* key, uint16_t value); +esp_err_t nvs_set_i32 (nvs_handle handle, const char* key, int32_t value); +esp_err_t nvs_set_u32 (nvs_handle handle, const char* key, uint32_t value); +esp_err_t nvs_set_i64 (nvs_handle handle, const char* key, int64_t value); +esp_err_t nvs_set_u64 (nvs_handle handle, const char* key, uint64_t value); +esp_err_t nvs_set_str (nvs_handle handle, const char* key, const char* value); +esp_err_t nvs_set_blob(nvs_handle handle, const char* key, const void* value, size_t length); + +/** + * @brief nvs_get_X - get value for given key + * + * These functions retrieve value for the key, given its name. If key does not + * exist, or the requested variable type doesn't match the type which was used + * when setting a value, an error is returned. + * + * In case of any error, out_value is not modified. + * + * All functions expect out_value to be a pointer to an already allocated variable + * of the given type. + * Additionally, nvs_get_str and nvs_get_blob support WinAPI-style length queries. + * To get the size necessary to store the value, call nvs_get_str or nvs_get_blob + * with zero out_value and non-zero pointer to length. Variable pointed to + * by length argument will be set to the required length. For nvs_get_str, + * this length includes the zero terminator. When calling nvs_get_str and + * nvs_get_blob with non-zero out_value, length has to be non-zero and has to + * point to the length available in out_value. + * It is suggested that nvs_get/set_str is used for zero-terminated C strings, and + * nvs_get/set_blob used for arbitrary data structures. + * + * Example of using nvs_get_i32: + * int32_t max_buffer_size = 4096; // default value + * esp_err_t err = nvs_get_i32(my_handle, "max_buffer_size", &max_buffer_size); + * assert(err == ESP_OK || err == ESP_ERR_NVS_NOT_FOUND); + * // if ESP_ERR_NVS_NOT_FOUND was returned, max_buffer_size will still + * // have its default value. + * + * Example (without error checking) of using nvs_get_str to get a string into dynamic array: + * size_t required_size; + * nvs_get_str(my_handle, "server_name", NULL, &required_size); + * char* server_name = malloc(required_size); + * nvs_get_str(my_handle, "server_name", server_name, &required_size); + * + * Example (without error checking) of using nvs_get_blob to get a binary data + * into a static array: + * uint8_t mac_addr[6]; + * size_t size = sizeof(mac_addr); + * nvs_get_blob(my_handle, "dst_mac_addr", mac_addr, &size); + * + * @param[in] handle Handle obtained from nvs_open function. + * @param[in] key Key name. Maximal length is determined by the underlying + * implementation, but is guaranteed to be at least + * 16 characters. Shouldn't be empty. + * @param out_value Pointer to the output value. + * May be NULL for nvs_get_str and nvs_get_blob, in this + * case required length will be returned in length argument. + * @param[inout] length For nvs_get_str and nvs_get_blob, non-zero pointer + * to the variable holding the length of out_value. + * In case out_value a zero, will be set to the length + * required to hold the value. In case out_value is not + * zero, will be set to the actual length of the value + * written. For nvs_get_str this includes zero terminator. + * + * @return - ESP_OK if the value was retrieved successfully + * - ESP_ERR_NVS_NOT_FOUND if the requested key doesn't exist + * - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL + * - ESP_ERR_NVS_INVALID_NAME if key name doesn't satisfy constraints + * - ESP_ERR_NVS_INVALID_LENGTH if length is not sufficient to store data + */ +esp_err_t nvs_get_i8 (nvs_handle handle, const char* key, int8_t* out_value); +esp_err_t nvs_get_u8 (nvs_handle handle, const char* key, uint8_t* out_value); +esp_err_t nvs_get_i16 (nvs_handle handle, const char* key, int16_t* out_value); +esp_err_t nvs_get_u16 (nvs_handle handle, const char* key, uint16_t* out_value); +esp_err_t nvs_get_i32 (nvs_handle handle, const char* key, int32_t* out_value); +esp_err_t nvs_get_u32 (nvs_handle handle, const char* key, uint32_t* out_value); +esp_err_t nvs_get_i64 (nvs_handle handle, const char* key, int64_t* out_value); +esp_err_t nvs_get_u64 (nvs_handle handle, const char* key, uint64_t* out_value); +esp_err_t nvs_get_str (nvs_handle handle, const char* key, char* out_value, size_t* length); +esp_err_t nvs_get_blob(nvs_handle handle, const char* key, void* out_value, size_t* length); + +/** + * @brief Write any pending changes to non-volatile storage + * + * After setting any values, nvs_commit() must be called to ensure changes are written + * to non-volatile storage. Individual implementations may write to storage at other times, + * but this is not guaranteed. + * + * @param[in] handle Storage handle obtained with nvs_open. If handle has to be + * opened as not read only for this call to succeed. + * + * @return - ESP_OK if the changes have been written successfully + * - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL + * - other error codes from the underlying storage driver + */ +esp_err_t nvs_commit(nvs_handle handle); + +/** + * @brief Close the storage handle and free any allocated resources + * + * This function should be called for each handle opened with nvs_open once + * the handle is not in use any more. Closing the handle may not automatically + * write the changes to nonvolatile storage. This has to be done explicitly using + * nvs_commit function. + * Once this function is called on a handle, the handle should no longer be used. + * + * @param[in] handle Storage handle to close + */ +void nvs_close(nvs_handle handle); + + +#ifdef __cplusplus +} // extern "C" +#endif + +#endif //ESP_NVS_H diff --git a/components/nvs_flash/include/nvs_flash.h b/components/nvs_flash/include/nvs_flash.h new file mode 100644 index 000000000..5d9dc7359 --- /dev/null +++ b/components/nvs_flash/include/nvs_flash.h @@ -0,0 +1,29 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_flash_h +#define nvs_flash_h + +#ifdef __cplusplus +extern "C" { +#endif + +esp_err_t nvs_flash_init(uint32_t baseSector, uint32_t sectorCount); + + +#ifdef __cplusplus +} +#endif + + +#endif /* nvs_flash_h */ diff --git a/components/nvs_flash/src/compressed_enum_table.hpp b/components/nvs_flash/src/compressed_enum_table.hpp new file mode 100644 index 000000000..8ee95d9f9 --- /dev/null +++ b/components/nvs_flash/src/compressed_enum_table.hpp @@ -0,0 +1,79 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef compressed_enum_table_h +#define compressed_enum_table_h + +#include +#include +#include + +template +class CompressedEnumTable +{ +public: + uint32_t* data() + { + return mData; + } + + const uint32_t* data() const + { + return mData; + } + + Tenum get(size_t index) + { + assert(index >= 0 && index < Nitems); + size_t wordIndex = index / ITEMS_PER_WORD; + size_t offset = (index % ITEMS_PER_WORD) * Nbits; + + return static_cast((mData[wordIndex] >> offset) & VALUE_MASK); + } + + void set(size_t index, Tenum val) + { + assert(index >= 0 && index < Nitems); + size_t wordIndex = index / ITEMS_PER_WORD; + size_t offset = (index % ITEMS_PER_WORD) * Nbits; + + uint32_t v = static_cast(val) << offset; + mData[wordIndex] = (mData[wordIndex] & ~(VALUE_MASK << offset)) | v; + } + + static constexpr size_t getWordIndex(size_t index) + { + return index / ITEMS_PER_WORD; + } + + static constexpr size_t byteSize() + { + return WORD_COUNT * 4; + } + + static constexpr size_t count() + { + return Nitems; + } + + +protected: + static_assert(32 % Nbits == 0, "Nbits must divide 32"); + static const size_t ITEMS_PER_WORD = 32 / Nbits; + static const size_t WORD_COUNT = ( Nbits * Nitems + 31 ) / 32; + static const uint32_t VALUE_MASK = (1 << Nbits) - 1; + uint32_t mData[WORD_COUNT]; +}; + +#endif /* compressed_enum_table_h */ diff --git a/components/nvs_flash/src/intrusive_list.h b/components/nvs_flash/src/intrusive_list.h new file mode 100644 index 000000000..fc92442cd --- /dev/null +++ b/components/nvs_flash/src/intrusive_list.h @@ -0,0 +1,248 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef intrusive_list_h +#define intrusive_list_h + +#include + +template +class intrusive_list; + +template +class intrusive_list_node +{ +protected: + friend class intrusive_list; + T* mPrev = nullptr; + T* mNext = nullptr; +}; + +template +class intrusive_list +{ + typedef intrusive_list_node TNode; + static_assert(std::is_base_of::value, ""); + +public: + + class iterator : public std::iterator + { + public: + + iterator() : mPos(nullptr) {} + + iterator(T* pos) : mPos(pos) {} + + iterator operator++(int) + { + auto result = *this; + mPos = mPos->mNext; + return result; + } + + iterator operator--(int) + { + auto result = *this; + mPos = mPos->mPrev; + return result; + } + + iterator& operator++() + { + mPos = mPos->mNext; + return *this; + } + + iterator& operator--() + { + mPos = mPos->mPrev; + return *this; + } + + + bool operator==(const iterator& other) const + { + return mPos == other.mPos; + } + + bool operator!=(const iterator& other) const + { + return !(*this == other); + } + + T& operator*() + { + return *mPos; + } + + const T& operator*() const + { + return *mPos; + } + + T* operator->() + { + return mPos; + } + + const T* operator->() const + { + return mPos; + } + + operator T*() + { + return mPos; + } + + operator const T*() const + { + return mPos; + } + + + protected: + T* mPos; + }; + + void push_back(T* node) + { + if (mLast) { + mLast->mNext = node; + } + node->mPrev = mLast; + node->mNext = nullptr; + mLast = node; + if (mFirst == nullptr) { + mFirst = node; + } + ++mSize; + } + + void push_front(T* node) + { + node->mPrev = nullptr; + node->mNext = mFirst; + if (mFirst) { + mFirst->mPrev = node; + } + mFirst = node; + if (mLast == nullptr) { + mLast = node; + } + ++mSize; + } + + T& back() + { + return *mLast; + } + + const T& back() const + { + return *mLast; + } + + T& front() + { + return *mFirst; + } + + const T& front() const + { + return *mFirst; + } + + void pop_front() + { + erase(mFirst); + } + + void pop_back() + { + erase(mLast); + } + + void insert(iterator next, T* node) + { + if (static_cast(next) == nullptr) { + push_back(node); + } else { + auto prev = next->mPrev; + if (!prev) { + push_front(node); + } else { + prev->mNext = node; + next->mPrev = node; + node->mNext = next; + node->mPrev = &(*prev); + ++mSize; + } + } + } + + void erase(iterator it) + { + auto prev = it->mPrev; + auto next = it->mNext; + + if (prev) { + prev->mNext = next; + } else { + mFirst = next; + } + if (next) { + next->mPrev = prev; + } else { + mLast = prev; + } + --mSize; + } + + iterator begin() + { + return iterator(mFirst); + } + + iterator end() + { + return iterator(nullptr); + } + + size_t size() const + { + return mSize; + } + + bool empty() const + { + return mSize == 0; + } + + + void clear() + { + while (mFirst) { + erase(mFirst); + } + } + +protected: + T* mFirst = nullptr; + T* mLast = nullptr; + size_t mSize = 0; +}; + + +#endif /* intrusive_list_h */ diff --git a/components/nvs_flash/src/nvs.hpp b/components/nvs_flash/src/nvs.hpp new file mode 100644 index 000000000..d2f9d3d01 --- /dev/null +++ b/components/nvs_flash/src/nvs.hpp @@ -0,0 +1,25 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_hpp +#define nvs_hpp + + +#include +#include "nvs.h" +#include "nvs_types.hpp" +#include "nvs_page.hpp" +#include "nvs_pagemanager.hpp" +#include "nvs_storage.hpp" + +#endif /* nvs_hpp */ diff --git a/components/nvs_flash/src/nvs_api.cpp b/components/nvs_flash/src/nvs_api.cpp new file mode 100644 index 000000000..655ed24f8 --- /dev/null +++ b/components/nvs_flash/src/nvs_api.cpp @@ -0,0 +1,278 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "nvs.hpp" +#include "nvs_flash.h" +#include "nvs_storage.hpp" +#include "intrusive_list.h" +#include "nvs_platform.hpp" + +class HandleEntry : public intrusive_list_node +{ +public: + HandleEntry(){} + + HandleEntry(nvs_handle handle, bool readOnly, uint8_t nsIndex) : + mHandle(handle), + mReadOnly(readOnly), + mNsIndex(nsIndex) + { + } + + nvs_handle mHandle; + uint8_t mReadOnly; + uint8_t mNsIndex; +}; + +#ifdef ESP_PLATFORM +SemaphoreHandle_t nvs::Lock::mSemaphore = NULL; +#endif + +using namespace std; +using namespace nvs; + +static intrusive_list s_nvs_handles; +static uint32_t s_nvs_next_handle = 1; +static nvs::Storage s_nvs_storage; + +extern "C" esp_err_t nvs_flash_init(uint32_t baseSector, uint32_t sectorCount) +{ + Lock::init(); + Lock lock; + NVS_DEBUGV("%s %d %d\r\n", __func__, baseSector, sectorCount); + return s_nvs_storage.init(baseSector, sectorCount); +} + +static esp_err_t nvs_find_ns_handle(nvs_handle handle, HandleEntry& entry) +{ + auto it = find_if(begin(s_nvs_handles), end(s_nvs_handles), [=](HandleEntry& e) -> bool { + return e.mHandle == handle; + }); + if (it == end(s_nvs_handles)) { + return ESP_ERR_NVS_INVALID_HANDLE; + } + entry = *it; + return ESP_OK; +} + +extern "C" esp_err_t nvs_open(const char* name, nvs_open_mode open_mode, nvs_handle *out_handle) +{ + Lock lock; + NVS_DEBUGV("%s %s %d\r\n", __func__, name, open_mode); + uint8_t nsIndex; + esp_err_t err = s_nvs_storage.createOrOpenNamespace(name, open_mode == NVS_READWRITE, nsIndex); + if (err != ESP_OK) { + return err; + } + + uint32_t handle = s_nvs_next_handle; + ++s_nvs_next_handle; + *out_handle = handle; + + s_nvs_handles.push_back(new HandleEntry(handle, open_mode==NVS_READONLY, nsIndex)); + return ESP_OK; +} + +extern "C" void nvs_close(nvs_handle handle) +{ + Lock lock; + NVS_DEBUGV("%s %d\r\n", __func__, handle); + auto it = find_if(begin(s_nvs_handles), end(s_nvs_handles), [=](HandleEntry& e) -> bool { + return e.mHandle == handle; + }); + if (it == end(s_nvs_handles)) { + return; + } + s_nvs_handles.erase(it); +} + +template +static esp_err_t nvs_set(nvs_handle handle, const char* key, T value) +{ + Lock lock; + NVS_DEBUGV("%s %s %d %d\r\n", __func__, key, sizeof(T), (uint32_t) value); + HandleEntry entry; + auto err = nvs_find_ns_handle(handle, entry); + if (err != ESP_OK) { + return err; + } + if (entry.mReadOnly) { + return ESP_ERR_NVS_READ_ONLY; + } + return s_nvs_storage.writeItem(entry.mNsIndex, key, value); +} + +extern "C" esp_err_t nvs_set_i8 (nvs_handle handle, const char* key, int8_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_u8 (nvs_handle handle, const char* key, uint8_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_i16 (nvs_handle handle, const char* key, int16_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_u16 (nvs_handle handle, const char* key, uint16_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_i32 (nvs_handle handle, const char* key, int32_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_u32 (nvs_handle handle, const char* key, uint32_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_i64 (nvs_handle handle, const char* key, int64_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_set_u64 (nvs_handle handle, const char* key, uint64_t value) +{ + return nvs_set(handle, key, value); +} + +extern "C" esp_err_t nvs_commit(nvs_handle handle) +{ + Lock lock; + // no-op for now, to be used when intermediate cache is added + HandleEntry entry; + return nvs_find_ns_handle(handle, entry); +} + +extern "C" esp_err_t nvs_set_str(nvs_handle handle, const char* key, const char* value) +{ + Lock lock; + NVS_DEBUGV("%s %s %s\r\n", __func__, key, value); + HandleEntry entry; + auto err = nvs_find_ns_handle(handle, entry); + if (err != ESP_OK) { + return err; + } + return s_nvs_storage.writeItem(entry.mNsIndex, nvs::ItemType::SZ, key, value, strlen(value) + 1); +} + +extern "C" esp_err_t nvs_set_blob(nvs_handle handle, const char* key, const void* value, size_t length) +{ + Lock lock; + NVS_DEBUGV("%s %s %d\r\n", __func__, key, length); + HandleEntry entry; + auto err = nvs_find_ns_handle(handle, entry); + if (err != ESP_OK) { + return err; + } + return s_nvs_storage.writeItem(entry.mNsIndex, nvs::ItemType::BLOB, key, value, length); +} + + +template +static esp_err_t nvs_get(nvs_handle handle, const char* key, T* out_value) +{ + Lock lock; + NVS_DEBUGV("%s %s %d\r\n", __func__, key, sizeof(T)); + HandleEntry entry; + auto err = nvs_find_ns_handle(handle, entry); + if (err != ESP_OK) { + return err; + } + return s_nvs_storage.readItem(entry.mNsIndex, key, *out_value); +} + +extern "C" esp_err_t nvs_get_i8 (nvs_handle handle, const char* key, int8_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_u8 (nvs_handle handle, const char* key, uint8_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_i16 (nvs_handle handle, const char* key, int16_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_u16 (nvs_handle handle, const char* key, uint16_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_i32 (nvs_handle handle, const char* key, int32_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_u32 (nvs_handle handle, const char* key, uint32_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_i64 (nvs_handle handle, const char* key, int64_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +extern "C" esp_err_t nvs_get_u64 (nvs_handle handle, const char* key, uint64_t* out_value) +{ + return nvs_get(handle, key, out_value); +} + +static esp_err_t nvs_get_str_or_blob(nvs_handle handle, nvs::ItemType type, const char* key, void* out_value, size_t* length) +{ + Lock lock; + NVS_DEBUGV("%s %s\r\n", __func__, key); + HandleEntry entry; + auto err = nvs_find_ns_handle(handle, entry); + if (err != ESP_OK) { + return err; + } + + size_t dataSize; + err = s_nvs_storage.getItemDataSize(entry.mNsIndex, type, key, dataSize); + if (err != ESP_OK) { + return err; + } + + if (length != nullptr && out_value == nullptr) { + *length = dataSize; + return ESP_OK; + } + + if (length == nullptr || *length < dataSize) { + return ESP_ERR_NVS_INVALID_LENGTH; + } + + return s_nvs_storage.readItem(entry.mNsIndex, type, key, out_value, dataSize); +} + +extern "C" esp_err_t nvs_get_str(nvs_handle handle, const char* key, char* out_value, size_t* length) +{ + return nvs_get_str_or_blob(handle, nvs::ItemType::SZ, key, out_value, length); +} + +extern "C" esp_err_t nvs_get_blob(nvs_handle handle, const char* key, void* out_value, size_t* length) +{ + return nvs_get_str_or_blob(handle, nvs::ItemType::BLOB, key, out_value, length); +} + diff --git a/components/nvs_flash/src/nvs_page.cpp b/components/nvs_flash/src/nvs_page.cpp new file mode 100644 index 000000000..de325a170 --- /dev/null +++ b/components/nvs_flash/src/nvs_page.cpp @@ -0,0 +1,689 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "nvs_page.hpp" +#if defined(ESP_PLATFORM) +#include +#else +#include "crc.h" +#endif + + +namespace nvs +{ + +uint32_t Page::Header::calculateCrc32() +{ + return crc32_le(0xffffffff, + reinterpret_cast(this) + offsetof(Header, mSeqNumber), + offsetof(Header, mCrc32) - offsetof(Header, mSeqNumber)); +} + +esp_err_t Page::load(uint32_t sectorNumber) +{ + mBaseAddress = sectorNumber * SEC_SIZE; + mUsedEntryCount = 0; + mErasedEntryCount = 0; + + Header header; + auto rc = spi_flash_read(mBaseAddress, reinterpret_cast(&header), sizeof(header)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + if (header.mState == PageState::UNINITIALIZED) { + mState = header.mState; + // check if the whole page is really empty + // reading the whole page takes ~40 times less than erasing it + uint32_t line[8]; + for (uint32_t i = 0; i < SPI_FLASH_SEC_SIZE; i += sizeof(line)) { + rc = spi_flash_read(mBaseAddress + i, line, sizeof(line)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + if (std::any_of(line, line + 4, [](uint32_t val) -> bool { return val != 0xffffffff; })) { + // page isn't as empty after all, mark it as corrupted + mState = PageState::CORRUPT; + break; + } + } + } + else if (header.mCrc32 != header.calculateCrc32()) { + header.mState = PageState::CORRUPT; + } + else { + mState = header.mState; + mSeqNumber = header.mSeqNumber; + } + + switch (mState) { + case PageState::UNINITIALIZED: + break; + + case PageState::FULL: + case PageState::ACTIVE: + case PageState::FREEING: + mLoadEntryTable(); + break; + + default: + mState = PageState::CORRUPT; + break; + } + + return ESP_OK; +} + +esp_err_t Page::writeEntry(const Item& item) +{ + auto rc = spi_flash_write(getEntryAddress(mNextFreeEntry), reinterpret_cast(&item), sizeof(item)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + + auto err = alterEntryState(mNextFreeEntry, EntryState::WRITTEN); + if (err != ESP_OK) { + return err; + } + + if (mNextFreeEntry == 0) { + mFirstUsedEntry = 0; + } + + ++mUsedEntryCount; + + if (++mNextFreeEntry == ENTRY_COUNT) { + alterPageState(PageState::FULL); + } + + return ESP_OK; +} + +esp_err_t Page::writeItem(uint8_t nsIndex, ItemType datatype, const char* key, const void* data, size_t dataSize) +{ + Item item; + + esp_err_t err; + if (mState == PageState::UNINITIALIZED) { + err = initialize(); + if (err != ESP_OK) { + return err; + } + } + + if (mState == PageState::FULL) { + return ESP_ERR_NVS_PAGE_FULL; + } + + const size_t keySize = strlen(key); + if (keySize > Item::MAX_KEY_LENGTH) { + return ESP_ERR_NVS_KEY_TOO_LONG; + } + + size_t totalSize = ENTRY_SIZE; + size_t entriesCount = 1; + if (datatype == ItemType::SZ || datatype == ItemType::BLOB) { + size_t roundedSize = (dataSize + ENTRY_SIZE - 1) & ~(ENTRY_SIZE - 1); + totalSize += roundedSize; + entriesCount += roundedSize / ENTRY_SIZE; + } + + // primitive types should fit into one entry + assert(totalSize == ENTRY_SIZE || datatype == ItemType::BLOB || datatype == ItemType::SZ); + + if (mNextFreeEntry + entriesCount > ENTRY_COUNT) { + // page will not fit this amount of data + return ESP_ERR_NVS_PAGE_FULL; + } + + // write first item + + item.nsIndex = nsIndex; + item.datatype = datatype; + item.span = (totalSize + ENTRY_SIZE - 1) / ENTRY_SIZE; + item.reserved = 0xff; + + std::fill_n(reinterpret_cast(item.key), sizeof(item.key) / 4, 0xffffffff); + std::fill_n(reinterpret_cast(item.data), sizeof(item.data) / 4, 0xffffffff); + + strlcpy(item.key, key, Item::MAX_KEY_LENGTH + 1); + + + if (datatype != ItemType::SZ && datatype != ItemType::BLOB) { + memcpy(item.data, data, dataSize); + item.crc32 = item.calculateCrc32(); + err = writeEntry(item); + if (err != ESP_OK) { + return err; + } + } else { + const uint8_t* src = reinterpret_cast(data); + item.varLength.dataCrc32 = Item::calculateCrc32(src, dataSize); + item.varLength.dataSize = dataSize; + item.varLength.reserved2 = 0xffff; + item.crc32 = item.calculateCrc32(); + err = writeEntry(item); + if (err != ESP_OK) { + return err; + } + + size_t left = dataSize; + while (left != 0) { + size_t willWrite = Page::ENTRY_SIZE; + willWrite = (left < willWrite)?left:willWrite; + memcpy(item.rawData, src, willWrite); + src += willWrite; + left -= willWrite; + err = writeEntry(item); + if (err != ESP_OK) { + return err; + } + } + } + return ESP_OK; +} + +esp_err_t Page::readItem(uint8_t nsIndex, ItemType datatype, const char* key, void* data, size_t dataSize) +{ + size_t index = 0; + Item item; + esp_err_t rc = findItem(nsIndex, datatype, key, index, item); + if (rc != ESP_OK) { + return rc; + } + + if (datatype != ItemType::SZ && datatype != ItemType::BLOB) { + if (dataSize != getAlignmentForType(datatype)) { + return ESP_ERR_NVS_TYPE_MISMATCH; + } + + memcpy(data, item.data, dataSize); + return ESP_OK; + } + + if (dataSize < static_cast(item.varLength.dataSize)) { + return ESP_ERR_NVS_INVALID_LENGTH; + } + + uint8_t* dst = reinterpret_cast(data); + size_t left = item.varLength.dataSize; + for (size_t i = index + 1; i < index + item.span; ++i) { + Item ditem; + rc = readEntry(i, ditem); + if (rc != ESP_OK) { + return rc; + } + size_t willCopy = ENTRY_SIZE; + willCopy = (left < willCopy)?left:willCopy; + memcpy(dst, ditem.rawData, willCopy); + left -= willCopy; + dst += willCopy; + } + if (Item::calculateCrc32(reinterpret_cast(data), item.varLength.dataSize) != item.varLength.dataCrc32) { + rc = eraseEntryAndSpan(index); + if (rc != ESP_OK) { + return rc; + } + return ESP_ERR_NVS_NOT_FOUND; + } + return ESP_OK; +} + +esp_err_t Page::eraseItem(uint8_t nsIndex, ItemType datatype, const char* key) +{ + size_t index = 0; + Item item; + esp_err_t rc = findItem(nsIndex, datatype, key, index, item); + if (rc != ESP_OK) { + return rc; + } + if (CachedFindInfo(nsIndex, datatype, key) == mFindInfo) { + invalidateCache(); + } + return eraseEntryAndSpan(index); +} + +esp_err_t Page::findItem(uint8_t nsIndex, ItemType datatype, const char* key) +{ + size_t index = 0; + Item item; + return findItem(nsIndex, datatype, key, index, item); +} + +esp_err_t Page::eraseEntry(size_t index) +{ + auto state = mEntryTable.get(index); + assert(state == EntryState::WRITTEN || state == EntryState::EMPTY); + + auto rc = alterEntryState(index, EntryState::ERASED); + if (rc != ESP_OK) { + return rc; + } + + return ESP_OK; +} + +esp_err_t Page::eraseEntryAndSpan(size_t index) +{ + auto state = mEntryTable.get(index); + assert(state == EntryState::WRITTEN || state == EntryState::EMPTY); + + size_t span = 1; + if (state == EntryState::WRITTEN) { + Item item; + auto rc = readEntry(index, item); + if (rc != ESP_OK) { + return rc; + } + if (item.calculateCrc32() != item.crc32) { + rc = alterEntryState(index, EntryState::ERASED); + if (rc != ESP_OK) { + return rc; + } + } else { + span = item.span; + for (ptrdiff_t i = index + span - 1; i >= static_cast(index); --i) { + rc = alterEntryState(i, EntryState::ERASED); + if (rc != ESP_OK) { + return rc; + } + } + } + } + else { + auto rc = alterEntryState(index, EntryState::ERASED); + if (rc != ESP_OK) { + return rc; + } + } + + if (index == mFirstUsedEntry) { + updateFirstUsedEntry(index, span); + } + + mErasedEntryCount += span; + mUsedEntryCount -= span; + + return ESP_OK; +} + +void Page::updateFirstUsedEntry(size_t index, size_t span) +{ + assert(index == mFirstUsedEntry); + mFirstUsedEntry = INVALID_ENTRY; + for (size_t i = index + span; i < mNextFreeEntry; ++i) { + if (mEntryTable.get(i) == EntryState::WRITTEN) { + mFirstUsedEntry = i; + break; + } + } +} + +esp_err_t Page::moveItem(Page& other) +{ + if (mFirstUsedEntry == INVALID_ENTRY) { + return ESP_ERR_NVS_NOT_FOUND; + } + + if (mFindInfo.itemIndex() == mFirstUsedEntry) { + invalidateCache(); + } + + if (other.mState == PageState::UNINITIALIZED) { + auto err = other.initialize(); + if (err != ESP_OK) { + return err; + } + } + + Item entry; + auto err = readEntry(mFirstUsedEntry, entry); + if (err != ESP_OK) { + return err; + } + err = other.writeEntry(entry); + if (err != ESP_OK) { + return err; + } + err = eraseEntry(mFirstUsedEntry); + if (err != ESP_OK) { + return err; + } + + size_t span = entry.span; + size_t end = mFirstUsedEntry + span; + + assert(mFirstUsedEntry != INVALID_ENTRY || span == 1); + + for (size_t i = mFirstUsedEntry + 1; i < end; ++i) { + readEntry(i, entry); + err = other.writeEntry(entry); + if (err != ESP_OK) { + return err; + } + err = eraseEntry(i); + if (err != ESP_OK) { + return err; + } + } + updateFirstUsedEntry(mFirstUsedEntry, span); + mErasedEntryCount += span; + mUsedEntryCount -= span; + + return ESP_OK; +} + +esp_err_t Page::mLoadEntryTable() +{ + // for states where we actually care about data in the page, read entry state table + if (mState == PageState::ACTIVE || + mState == PageState::FULL || + mState == PageState::FREEING) { + auto rc = spi_flash_read(mBaseAddress + ENTRY_TABLE_OFFSET, mEntryTable.data(), + static_cast(mEntryTable.byteSize())); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + } + + mErasedEntryCount = 0; + mUsedEntryCount = 0; + for (size_t i = 0; i < ENTRY_COUNT; ++i) { + auto s = mEntryTable.get(i); + if (s == EntryState::WRITTEN) { + if (mFirstUsedEntry == INVALID_ENTRY) { + mFirstUsedEntry = i; + } + ++mUsedEntryCount; + } else if (s == EntryState::ERASED) { + ++mErasedEntryCount; + } + } + + // for PageState::ACTIVE, we may have more data written to this page + // as such, we need to figure out where the first unused entry is + if (mState == PageState::ACTIVE) { + for (size_t i = 0; i < ENTRY_COUNT; ++i) { + if (mEntryTable.get(i) == EntryState::EMPTY) { + mNextFreeEntry = i; + break; + } + } + + // however, if power failed after some data was written into the entry. + // but before the entry state table was altered, the entry locacted via + // entry state table may actually be half-written. + // this is easy to check by reading EntryHeader (i.e. first word) + uint32_t entryAddress = mBaseAddress + ENTRY_DATA_OFFSET + + static_cast(mNextFreeEntry) * ENTRY_SIZE; + uint32_t header; + auto rc = spi_flash_read(entryAddress, &header, sizeof(header)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + if (header != 0xffffffff) { + auto err = alterEntryState(mNextFreeEntry, EntryState::ERASED); + if (err != ESP_OK) { + mState = PageState::INVALID; + return err; + } + ++mNextFreeEntry; + } + + // check that all variable-length items are written or erased fully + for (size_t i = 0; i < mNextFreeEntry; ++i) { + if (mEntryTable.get(i) == EntryState::ERASED) { + continue; + } + + Item item; + auto err = readEntry(i, item); + if (err != ESP_OK) { + mState = PageState::INVALID; + return err; + } + + if (item.crc32 != item.calculateCrc32()) { + err = eraseEntryAndSpan(i); + if (err != ESP_OK) { + mState = PageState::INVALID; + return err; + } + continue; + } + + if (item.datatype != ItemType::BLOB && item.datatype != ItemType::SZ) { + continue; + } + + size_t span = item.span; + bool needErase = false; + for (size_t j = i; j < i + span; ++j) { + if (mEntryTable.get(j) != EntryState::WRITTEN) { + needErase = true; + break; + } + } + if (needErase) { + eraseEntryAndSpan(i); + } + i += span - 1; + } + + } + + return ESP_OK; +} + + +esp_err_t Page::initialize() +{ + assert(mState == PageState::UNINITIALIZED); + mState = PageState::ACTIVE; + Header header; + header.mState = mState; + header.mSeqNumber = mSeqNumber; + header.mCrc32 = header.calculateCrc32(); + + auto rc = spi_flash_write(mBaseAddress, reinterpret_cast(&header), sizeof(header)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + + mNextFreeEntry = 0; + std::fill_n(mEntryTable.data(), mEntryTable.byteSize() / sizeof(uint32_t), 0xffffffff); + invalidateCache(); + return ESP_OK; +} + +esp_err_t Page::alterEntryState(size_t index, EntryState state) +{ + assert(index < ENTRY_COUNT); + mEntryTable.set(index, state); + size_t wordToWrite = mEntryTable.getWordIndex(index); + uint32_t word = mEntryTable.data()[wordToWrite]; + auto rc = spi_flash_write(mBaseAddress + ENTRY_TABLE_OFFSET + static_cast(wordToWrite) * 4, &word, 4); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + return ESP_OK; +} + +esp_err_t Page::alterPageState(PageState state) +{ + auto rc = spi_flash_write(mBaseAddress, reinterpret_cast(&state), sizeof(state)); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + mState = (PageState) state; + return ESP_OK; +} + +esp_err_t Page::readEntry(size_t index, Item& dst) +{ + auto rc = spi_flash_read(getEntryAddress(index), reinterpret_cast(&dst), sizeof(dst)); + if (rc != ESP_OK) { + return rc; + } + return ESP_OK; +} + +esp_err_t Page::findItem(uint8_t nsIndex, ItemType datatype, const char* key, size_t &itemIndex, Item& item) +{ + if (mState == PageState::CORRUPT || mState == PageState::INVALID || mState == PageState::UNINITIALIZED) { + return ESP_ERR_NVS_NOT_FOUND; + } + + CachedFindInfo findInfo(nsIndex, datatype, key); + if (mFindInfo == findInfo) { + itemIndex = mFindInfo.itemIndex(); + } + + size_t start = mFirstUsedEntry; + if (itemIndex > mFirstUsedEntry && itemIndex < ENTRY_COUNT) { + start = itemIndex; + } + + size_t next; + for (size_t i = start; i < mNextFreeEntry; i = next) { + next = i + 1; + if (mEntryTable.get(i) != EntryState::WRITTEN) { + continue; + } + + auto rc = readEntry(i, item); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + + auto crc32 = item.calculateCrc32(); + if (item.crc32 != crc32) { + eraseEntryAndSpan(i); + continue; + } + + if (item.datatype == ItemType::BLOB || item.datatype == ItemType::SZ) { + next = i + item.span; + } + + if (nsIndex != NS_ANY && item.nsIndex != nsIndex) { + continue; + } + + if (key != nullptr && strncmp(key, item.key, Item::MAX_KEY_LENGTH) != 0) { + continue; + } + + if (datatype != ItemType::ANY && item.datatype != datatype) { + return ESP_ERR_NVS_TYPE_MISMATCH; + } + + itemIndex = i; + findInfo.setItemIndex(static_cast(itemIndex)); + mFindInfo = findInfo; + + return ESP_OK; + } + + return ESP_ERR_NVS_NOT_FOUND; +} + +esp_err_t Page::getSeqNumber(uint32_t& seqNumber) const +{ + if (mState != PageState::UNINITIALIZED && mState != PageState::INVALID && mState != PageState::CORRUPT) { + seqNumber = mSeqNumber; + return ESP_OK; + } + return ESP_ERR_NVS_NOT_INITIALIZED; +} + + +esp_err_t Page::setSeqNumber(uint32_t seqNumber) +{ + if (mState != PageState::UNINITIALIZED) { + return ESP_ERR_NVS_INVALID_STATE; + } + mSeqNumber = seqNumber; + return ESP_OK; +} + +esp_err_t Page::erase() +{ + auto sector = mBaseAddress / SPI_FLASH_SEC_SIZE; + auto rc = spi_flash_erase_sector(sector); + if (rc != ESP_OK) { + mState = PageState::INVALID; + return rc; + } + return load(sector); +} + +esp_err_t Page::markFreeing() +{ + if (mState != PageState::FULL && mState != PageState::ACTIVE) { + return ESP_ERR_NVS_INVALID_STATE; + } + return alterPageState(PageState::FREEING); +} + +esp_err_t Page::markFull() +{ + if (mState != PageState::ACTIVE) { + return ESP_ERR_NVS_INVALID_STATE; + } + return alterPageState(PageState::FULL); +} + + +void Page::invalidateCache() +{ + mFindInfo = CachedFindInfo(); +} + +void Page::debugDump() +{ + printf("state=%x addr=%x seq=%d\nfirstUsed=%d nextFree=%d used=%d erased=%d\n", mState, mBaseAddress, mSeqNumber, static_cast(mFirstUsedEntry), static_cast(mNextFreeEntry), mUsedEntryCount, mErasedEntryCount); + size_t skip = 0; + for (size_t i = 0; i < ENTRY_COUNT; ++i) { + printf("%3d: ", static_cast(i)); + EntryState state = mEntryTable.get(i); + if (state == EntryState::EMPTY) { + printf("E\n"); + } + else if (state == EntryState::ERASED) { + printf("X\n"); + } + else if (state == EntryState::WRITTEN) { + Item item; + readEntry(i, item); + if (skip == 0) { + printf("W ns=%2u type=%2u span=%3u key=\"%s\"\n", item.nsIndex, static_cast(item.datatype), item.span, item.key); + skip = item.span - 1; + } + else { + printf("D\n"); + skip--; + } + } + } +} + +} // namespace nvs diff --git a/components/nvs_flash/src/nvs_page.hpp b/components/nvs_flash/src/nvs_page.hpp new file mode 100644 index 000000000..f0c69c424 --- /dev/null +++ b/components/nvs_flash/src/nvs_page.hpp @@ -0,0 +1,246 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_page_hpp +#define nvs_page_hpp + +#include "nvs.h" +#include "nvs_types.hpp" +#include +#include +#include +#include +#include "esp_spi_flash.h" +#include "compressed_enum_table.hpp" +#include "intrusive_list.h" + +namespace nvs +{ + +class CachedFindInfo +{ +public: + CachedFindInfo() { } + CachedFindInfo(uint8_t nsIndex, ItemType type, const char* key) : + mKeyPtr(key), + mNsIndex(nsIndex), + mType(type) + { + } + + bool operator==(const CachedFindInfo& other) const + { + return mKeyPtr == other.mKeyPtr && mType == other.mType && mNsIndex == other.mNsIndex; + } + + void setItemIndex(uint32_t index) + { + mItemIndex = index; + } + uint32_t itemIndex() const + { + return mItemIndex; + } + +protected: + uint32_t mItemIndex = 0; + const char* mKeyPtr = nullptr; + uint8_t mNsIndex = 0; + ItemType mType; + +}; + +class Page : public intrusive_list_node +{ +public: + static const uint32_t PSB_INIT = 0x1; + static const uint32_t PSB_FULL = 0x2; + static const uint32_t PSB_FREEING = 0x4; + static const uint32_t PSB_CORRUPT = 0x8; + + static const uint32_t ESB_WRITTEN = 0x1; + static const uint32_t ESB_ERASED = 0x2; + + static const uint32_t SEC_SIZE = SPI_FLASH_SEC_SIZE; + + static const size_t ENTRY_SIZE = 32; + static const size_t ENTRY_COUNT = 126; + static const uint32_t INVALID_ENTRY = 0xffffffff; + + static const uint8_t NS_INDEX = 0; + static const uint8_t NS_ANY = 255; + + enum class PageState : uint32_t { + // All bits set, default state after flash erase. Page has not been initialized yet. + UNINITIALIZED = 0xffffffff, + + // Page is initialized, and will accept writes. + ACTIVE = UNINITIALIZED & ~PSB_INIT, + + // Page is marked as full and will not accept new writes. + FULL = ACTIVE & ~PSB_FULL, + + // Data is being moved from this page to a new one. + FREEING = FULL & ~PSB_FREEING, + + // Page was found to be in a corrupt and unrecoverable state. + // Instead of being erased immediately, it will be kept for diagnostics and data recovery. + // It will be erased once we run out out free pages. + CORRUPT = FREEING & ~PSB_CORRUPT, + + // Page object wasn't loaded from flash memory + INVALID = 0 + }; + + PageState state() const + { + return mState; + } + + esp_err_t load(uint32_t sectorNumber); + + esp_err_t getSeqNumber(uint32_t& seqNumber) const; + + esp_err_t setSeqNumber(uint32_t seqNumber); + + esp_err_t writeItem(uint8_t nsIndex, ItemType datatype, const char* key, const void* data, size_t dataSize); + + esp_err_t readItem(uint8_t nsIndex, ItemType datatype, const char* key, void* data, size_t dataSize); + + esp_err_t eraseItem(uint8_t nsIndex, ItemType datatype, const char* key); + + esp_err_t findItem(uint8_t nsIndex, ItemType datatype, const char* key); + + esp_err_t findItem(uint8_t nsIndex, ItemType datatype, const char* key, size_t &itemIndex, Item& item); + + template + esp_err_t writeItem(uint8_t nsIndex, const char* key, const T& value) + { + return writeItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value)); + } + + template + esp_err_t readItem(uint8_t nsIndex, const char* key, T& value) + { + return readItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value)); + } + + template + esp_err_t eraseItem(uint8_t nsIndex, const char* key) + { + return eraseItem(nsIndex, itemTypeOf(), key); + } + + size_t getUsedEntryCount() const + { + return mUsedEntryCount; + } + + size_t getErasedEntryCount() const + { + return mErasedEntryCount; + } + + + esp_err_t markFull(); + + esp_err_t markFreeing(); + + esp_err_t moveItem(Page& other); + + esp_err_t erase(); + + void invalidateCache(); + + void debugDump(); + +protected: + + class Header { + public: + Header() { + std::fill_n(mReserved, sizeof(mReserved)/sizeof(mReserved[0]), UINT32_MAX); + } + + PageState mState; // page state + uint32_t mSeqNumber; // sequence number of this page + uint32_t mReserved[5]; // unused, must be 0xffffffff + uint32_t mCrc32; // crc of everything except mState + + uint32_t calculateCrc32(); + }; + + enum class EntryState { + EMPTY = 0x3, // 0b11, default state after flash erase + WRITTEN = EMPTY & ~ESB_WRITTEN, // entry was written + ERASED = WRITTEN & ~ESB_ERASED, // entry was written and then erased + INVALID = 0x4 // entry is in inconsistent state (write started but ESB_WRITTEN has not been set yet) + }; + + esp_err_t mLoadEntryTable(); + + esp_err_t initialize(); + + esp_err_t alterEntryState(size_t index, EntryState state); + + esp_err_t alterPageState(PageState state); + + esp_err_t readEntry(size_t index, Item& dst); + + esp_err_t writeEntry(const Item& item); + + esp_err_t eraseEntry(size_t index); + + esp_err_t eraseEntryAndSpan(size_t index); + + void updateFirstUsedEntry(size_t index, size_t span); + + static constexpr size_t getAlignmentForType(ItemType type) + { + return static_cast(type) & 0x0f; + } + + uint32_t getEntryAddress(size_t entry) + { + assert(entry < ENTRY_COUNT); + return mBaseAddress + ENTRY_DATA_OFFSET + static_cast(entry) * ENTRY_SIZE; + } + + +protected: + uint32_t mBaseAddress = 0; + PageState mState = PageState::INVALID; + uint32_t mSeqNumber = UINT32_MAX; + typedef CompressedEnumTable TEntryTable; + TEntryTable mEntryTable; + size_t mNextFreeEntry = INVALID_ENTRY; + size_t mFirstUsedEntry = INVALID_ENTRY; + uint16_t mUsedEntryCount = 0; + uint16_t mErasedEntryCount = 0; + + CachedFindInfo mFindInfo; + + static const uint32_t HEADER_OFFSET = 0; + static const uint32_t ENTRY_TABLE_OFFSET = HEADER_OFFSET + 32; + static const uint32_t ENTRY_DATA_OFFSET = ENTRY_TABLE_OFFSET + 32; + + static_assert(sizeof(Header) == 32, "header size must be 32 bytes"); + static_assert(ENTRY_TABLE_OFFSET % 32 == 0, "entry table offset should be aligned"); + static_assert(ENTRY_DATA_OFFSET % 32 == 0, "entry data offset should be aligned"); + +}; // class Page + +} // namespace nvs + + +#endif /* nvs_page_hpp */ diff --git a/components/nvs_flash/src/nvs_pagemanager.cpp b/components/nvs_flash/src/nvs_pagemanager.cpp new file mode 100644 index 000000000..8fd62430d --- /dev/null +++ b/components/nvs_flash/src/nvs_pagemanager.cpp @@ -0,0 +1,137 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "nvs_pagemanager.hpp" + +namespace nvs +{ +esp_err_t PageManager::load(uint32_t baseSector, uint32_t sectorCount) +{ + mBaseSector = baseSector; + mPageCount = sectorCount; + mPageList.clear(); + mFreePageList.clear(); + mPages.reset(new Page[sectorCount]); + + for (uint32_t i = 0; i < sectorCount; ++i) { + auto err = mPages[i].load(baseSector + i); + if (err != ESP_OK) { + return err; + } + uint32_t seqNumber; + if (mPages[i].getSeqNumber(seqNumber) != ESP_OK) { + mFreePageList.push_back(&mPages[i]); + } else { + auto pos = std::find_if(std::begin(mPageList), std::end(mPageList), [=](const Page& page) -> bool { + uint32_t otherSeqNumber; + return page.getSeqNumber(otherSeqNumber) == ESP_OK && otherSeqNumber > seqNumber; + }); + if (pos == mPageList.end()) { + mPageList.push_back(&mPages[i]); + } else { + mPageList.insert(pos, &mPages[i]); + } + } + } + + if (mPageList.empty()) { + mSeqNumber = 0; + return activatePage(); + } + else { + uint32_t lastSeqNo; + assert(mPageList.back().getSeqNumber(lastSeqNo) == ESP_OK); + mSeqNumber = lastSeqNo + 1; + } + + return ESP_OK; +} + +esp_err_t PageManager::requestNewPage() +{ + if (mFreePageList.empty()) { + return ESP_ERR_NVS_INVALID_STATE; + } + + // do we have at least two free pages? in that case no erasing is required + if (mFreePageList.size() >= 2) { + return activatePage(); + } + + // find the page with the higest number of erased items + TPageListIterator maxErasedItemsPageIt; + size_t maxErasedItems = 0; + for (auto it = begin(); it != end(); ++it) { + auto erased = it->getErasedEntryCount(); + if (erased > maxErasedItems) { + maxErasedItemsPageIt = it; + maxErasedItems = erased; + } + } + + if (maxErasedItems == 0) { + return ESP_ERR_NVS_NOT_ENOUGH_SPACE; + } + + esp_err_t err = activatePage(); + if (err != ESP_OK) { + return err; + } + + Page* newPage = &mPageList.back(); + + Page* erasedPage = maxErasedItemsPageIt; + err = erasedPage->markFreeing(); + if (err != ESP_OK) { + return err; + } + while (true) { + err = erasedPage->moveItem(*newPage); + if (err == ESP_ERR_NVS_NOT_FOUND) { + break; + } else if (err != ESP_OK) { + return err; + } + } + + err = erasedPage->erase(); + if (err != ESP_OK) { + return err; + } + + mPageList.erase(maxErasedItemsPageIt); + mFreePageList.push_back(erasedPage); + + return ESP_OK; +} + +esp_err_t PageManager::activatePage() +{ + if (mFreePageList.empty()) { + return ESP_ERR_NVS_NOT_ENOUGH_SPACE; + } + Page* p = &mFreePageList.front(); + if (p->state() == Page::PageState::CORRUPT) { + auto err = p->erase(); + if (err != ESP_OK) { + return err; + } + } + mFreePageList.pop_front(); + mPageList.push_back(p); + p->setSeqNumber(mSeqNumber); + ++mSeqNumber; + return ESP_OK; +} + +} // namespace nvs diff --git a/components/nvs_flash/src/nvs_pagemanager.hpp b/components/nvs_flash/src/nvs_pagemanager.hpp new file mode 100644 index 000000000..3484e70a1 --- /dev/null +++ b/components/nvs_flash/src/nvs_pagemanager.hpp @@ -0,0 +1,70 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_pagemanager_hpp +#define nvs_pagemanager_hpp + +#include +#include +#include "nvs_types.hpp" +#include "nvs_page.hpp" +#include "nvs_pagemanager.hpp" +#include "intrusive_list.h" + +namespace nvs +{ +class PageManager +{ + using TPageList = intrusive_list; + using TPageListIterator = TPageList::iterator; +public: + + PageManager() {} + + esp_err_t load(uint32_t baseSector, uint32_t sectorCount); + + TPageListIterator begin() + { + return mPageList.begin(); + } + + TPageListIterator end() + { + return mPageList.end(); + } + + Page& back() + { + return mPageList.back(); + } + + esp_err_t requestNewPage(); + +protected: + friend class Iterator; + + esp_err_t activatePage(); + + TPageList mPageList; + TPageList mFreePageList; + std::unique_ptr mPages; + uint32_t mBaseSector; + uint32_t mPageCount; + uint32_t mSeqNumber; +}; // class PageManager + + +} // namespace nvs + + +#endif /* nvs_pagemanager_hpp */ diff --git a/components/nvs_flash/src/nvs_platform.hpp b/components/nvs_flash/src/nvs_platform.hpp new file mode 100644 index 000000000..d0bcae90c --- /dev/null +++ b/components/nvs_flash/src/nvs_platform.hpp @@ -0,0 +1,84 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_platform_h +#define nvs_platform_h + + +#ifdef ESP_PLATFORM +#define NVS_DEBUGV(...) ets_printf(__VA_ARGS__) + +#include "rom/ets_sys.h" +#include "freertos/FreeRTOS.h" +#include "freertos/semphr.h" + +namespace nvs +{ + +class Lock +{ +public: + Lock() + { + assert(mSemaphore); + xSemaphoreTake(mSemaphore, portMAX_DELAY); + } + + ~Lock() + { + assert(mSemaphore); + xSemaphoreGive(mSemaphore); + } + + static esp_err_t init() + { + assert(mSemaphore == nullptr); + mSemaphore = xSemaphoreCreateMutex(); + if (!mSemaphore) { + return ESP_ERR_NO_MEM; + } + return ESP_OK; + } + + static void uninit() + { + vSemaphoreDelete(mSemaphore); + mSemaphore = nullptr; + } + + static SemaphoreHandle_t mSemaphore; +}; +} // namespace nvs + +#else // ESP_PLATFORM +#define NVS_DEBUGV(...) printf(__VA_ARGS__) +namespace nvs +{ +class Lock +{ +public: + Lock() { } + ~Lock() { } + static void init() {} + static void uninit() {} +}; +} // namespace nvs +#endif // ESP_PLATFORM + +#ifndef CONFIG_NVS_DEBUG +#undef NVS_DEBUGV +#define NVS_DEBUGV(...) +#endif + + +#endif /* nvs_platform_h */ diff --git a/components/nvs_flash/src/nvs_storage.cpp b/components/nvs_flash/src/nvs_storage.cpp new file mode 100644 index 000000000..510c52407 --- /dev/null +++ b/components/nvs_flash/src/nvs_storage.cpp @@ -0,0 +1,195 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "nvs_storage.hpp" + +namespace nvs +{ + +Storage::~Storage() +{ + clearNamespaces(); +} + +void Storage::clearNamespaces() +{ + for (auto it = std::begin(mNamespaces); it != std::end(mNamespaces); ) { + auto tmp = it; + ++it; + mNamespaces.erase(tmp); + delete static_cast(tmp); + } +} + +esp_err_t Storage::init(uint32_t baseSector, uint32_t sectorCount) +{ + auto err = mPageManager.load(baseSector, sectorCount); + if (err != ESP_OK) { + mState = StorageState::INVALID; + return err; + } + + clearNamespaces(); + std::fill_n(mNamespaceUsage.data(), mNamespaceUsage.byteSize() / 4, 0); + for (auto it = mPageManager.begin(); it != mPageManager.end(); ++it) { + Page& p = *it; + size_t itemIndex = 0; + Item item; + while(p.findItem(Page::NS_INDEX, ItemType::U8, nullptr, itemIndex, item) == ESP_OK) { + NamespaceEntry* entry = new NamespaceEntry; + item.getKey(entry->mName, sizeof(entry->mName) - 1); + item.getValue(entry->mIndex); + mNamespaces.push_back(entry); + mNamespaceUsage.set(entry->mIndex, true); + } + } + mNamespaceUsage.set(0, true); + mNamespaceUsage.set(255, true); + mState = StorageState::ACTIVE; + return ESP_OK; +} + +esp_err_t Storage::writeItem(uint8_t nsIndex, ItemType datatype, const char* key, const void* data, size_t dataSize) +{ + if (mState != StorageState::ACTIVE) { + return ESP_ERR_NVS_NOT_INITIALIZED; + } + + Page* findPage = nullptr; + Item item; + auto err = findItem(nsIndex, datatype, key, findPage, item); + if (err != ESP_OK && err != ESP_ERR_NVS_NOT_FOUND) { + return err; + } + + Page& page = getCurrentPage(); + err = page.writeItem(nsIndex, datatype, key, data, dataSize); + if (err == ESP_ERR_NVS_PAGE_FULL) { + page.markFull(); + err = mPageManager.requestNewPage(); + if (err != ESP_OK) { + return err; + } + + err = getCurrentPage().writeItem(nsIndex, datatype, key, data, dataSize); + if (err != ESP_OK) { + return err; + } + } + + if (findPage) { + if (findPage->state() == Page::PageState::UNINITIALIZED) { + auto err = findItem(nsIndex, datatype, key, findPage, item); + assert(err == ESP_OK); + } + err = findPage->eraseItem(nsIndex, datatype, key); + if (err != ESP_OK) { + return err; + } + } + + return ESP_OK; +} + +esp_err_t Storage::createOrOpenNamespace(const char* nsName, bool canCreate, uint8_t& nsIndex) +{ + if (mState != StorageState::ACTIVE) { + return ESP_ERR_NVS_NOT_INITIALIZED; + } + auto it = std::find_if(mNamespaces.begin(), mNamespaces.end(), [=] (const NamespaceEntry& e) -> bool { + return strncmp(nsName, e.mName, sizeof(e.mName) - 1) == 0; + }); + if (it == std::end(mNamespaces)) { + if (!canCreate) { + return ESP_ERR_NVS_NOT_FOUND; + } + + uint8_t ns; + for (ns = 1; ns < 255; ++ns) { + if (mNamespaceUsage.get(ns) == false) { + break; + } + } + + if (ns == 255) { + return ESP_ERR_NVS_NOT_ENOUGH_SPACE; + } + + auto err = writeItem(Page::NS_INDEX, ItemType::U8, nsName, &ns, sizeof(ns)); + if (err != ESP_OK) { + return err; + } + mNamespaceUsage.set(ns, true); + nsIndex = ns; + + NamespaceEntry* entry = new NamespaceEntry; + entry->mIndex = ns; + strlcpy(entry->mName, nsName, sizeof(entry->mName)); + mNamespaces.push_back(entry); + + } else { + nsIndex = it->mIndex; + } + return ESP_OK; +} + +esp_err_t Storage::readItem(uint8_t nsIndex, ItemType datatype, const char* key, void* data, size_t dataSize) +{ + if (mState != StorageState::ACTIVE) { + return ESP_ERR_NVS_NOT_INITIALIZED; + } + + Item item; + Page* findPage = nullptr; + auto err = findItem(nsIndex, datatype, key, findPage, item); + if (err != ESP_OK) { + return err; + } + + return findPage->readItem(nsIndex, datatype, key, data, dataSize); +} + +esp_err_t Storage::eraseItem(uint8_t nsIndex, ItemType datatype, const char* key) +{ + if (mState != StorageState::ACTIVE) { + return ESP_ERR_NVS_NOT_INITIALIZED; + } + + Item item; + Page* findPage = nullptr; + auto err = findItem(nsIndex, datatype, key, findPage, item); + if (err != ESP_OK) { + return err; + } + + return findPage->eraseItem(nsIndex, datatype, key); +} + +esp_err_t Storage::getItemDataSize(uint8_t nsIndex, ItemType datatype, const char* key, size_t& dataSize) +{ + if (mState != StorageState::ACTIVE) { + return ESP_ERR_NVS_NOT_INITIALIZED; + } + + Item item; + Page* findPage = nullptr; + auto err = findItem(nsIndex, datatype, key, findPage, item); + if (err != ESP_OK) { + return err; + } + + dataSize = item.varLength.dataSize; + return ESP_OK; +} + +} \ No newline at end of file diff --git a/components/nvs_flash/src/nvs_storage.hpp b/components/nvs_flash/src/nvs_storage.hpp new file mode 100644 index 000000000..d61b219b2 --- /dev/null +++ b/components/nvs_flash/src/nvs_storage.hpp @@ -0,0 +1,114 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_storage_hpp +#define nvs_storage_hpp + +#include +#include +#include +#include "nvs.hpp" +#include "nvs_types.hpp" +#include "nvs_page.hpp" +#include "nvs_pagemanager.hpp" + +//extern void dumpBytes(const uint8_t* data, size_t count); + +namespace nvs +{ + +class Storage +{ + enum class StorageState : uint32_t { + INVALID, + ACTIVE, + }; + + struct NamespaceEntry : public intrusive_list_node { + public: + char mName[Item::MAX_KEY_LENGTH + 1]; + uint8_t mIndex; + }; + + typedef intrusive_list TNamespaces; + +public: + ~Storage(); + + esp_err_t init(uint32_t baseSector, uint32_t sectorCount); + + esp_err_t createOrOpenNamespace(const char* nsName, bool canCreate, uint8_t& nsIndex); + + esp_err_t writeItem(uint8_t nsIndex, ItemType datatype, const char* key, const void* data, size_t dataSize); + + esp_err_t readItem(uint8_t nsIndex, ItemType datatype, const char* key, void* data, size_t dataSize); + + esp_err_t getItemDataSize(uint8_t nsIndex, ItemType datatype, const char* key, size_t& dataSize); + + esp_err_t eraseItem(uint8_t nsIndex, ItemType datatype, const char* key); + + template + esp_err_t writeItem(uint8_t nsIndex, const char* key, const T& value) + { + return writeItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value)); + } + + template + esp_err_t readItem(uint8_t nsIndex, const char* key, T& value) + { + return readItem(nsIndex, itemTypeOf(value), key, &value, sizeof(value)); + } + + template + esp_err_t eraseItem(uint8_t nsIndex, const char* key) + { + return eraseItem(nsIndex, itemTypeOf(), key); + } + + +protected: + + Page& getCurrentPage() + { + return mPageManager.back(); + } + + void clearNamespaces(); + + esp_err_t findItem(uint8_t nsIndex, ItemType datatype, const char* key, Page* &page, Item& item) + { + size_t itemIndex = 0; + for (auto it = std::begin(mPageManager); it != std::end(mPageManager); ++it) { + auto err = it->findItem(nsIndex, datatype, key, itemIndex, item); + if (err == ESP_OK) { + page = it; + return ESP_OK; + } + } + return ESP_ERR_NVS_NOT_FOUND; + } + + +protected: + size_t mPageCount; + PageManager mPageManager; + TNamespaces mNamespaces; + CompressedEnumTable mNamespaceUsage; + StorageState mState = StorageState::INVALID; +}; + +} // namespace nvs + + + +#endif /* nvs_storage_hpp */ diff --git a/components/nvs_flash/src/nvs_types.cpp b/components/nvs_flash/src/nvs_types.cpp new file mode 100644 index 000000000..9884b276b --- /dev/null +++ b/components/nvs_flash/src/nvs_types.cpp @@ -0,0 +1,42 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "nvs_types.hpp" + +#if defined(ESP_PLATFORM) +#include +#else +#include "crc.h" +#endif + +namespace nvs +{ +uint32_t Item::calculateCrc32() +{ + uint32_t result = 0xffffffff; + const uint8_t* p = reinterpret_cast(this); + result = crc32_le(result, p + offsetof(Item, nsIndex), + offsetof(Item, crc32) - offsetof(Item, nsIndex)); + result = crc32_le(result, p + offsetof(Item, key), sizeof(key)); + result = crc32_le(result, p + offsetof(Item, data), sizeof(data)); + return result; +} + +uint32_t Item::calculateCrc32(const uint8_t* data, size_t size) +{ + uint32_t result = 0xffffffff; + result = crc32_le(result, data, size); + return result; +} + +} // namespace nvs diff --git a/components/nvs_flash/src/nvs_types.hpp b/components/nvs_flash/src/nvs_types.hpp new file mode 100644 index 000000000..cc1f86940 --- /dev/null +++ b/components/nvs_flash/src/nvs_types.hpp @@ -0,0 +1,100 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef nvs_types_h +#define nvs_types_h + +#include +#include +#include +#include +#include +#include "nvs.h" +#include "compressed_enum_table.hpp" + + +namespace nvs +{ + +enum class ItemType : uint8_t { + U8 = 0x01, + I8 = 0x11, + U16 = 0x02, + I16 = 0x12, + U32 = 0x04, + I32 = 0x14, + U64 = 0x08, + I64 = 0x18, + SZ = 0x21, + BLOB = 0x41, + ANY = 0xff +}; + +template::value, void*>::type = nullptr> +constexpr ItemType itemTypeOf() +{ + return static_cast(((std::is_signed::value)?0x10:0x00) | sizeof(T)); +} + +template +constexpr ItemType itemTypeOf(const T&) +{ + return itemTypeOf(); +} + +class Item +{ +public: + union { + struct { + uint8_t nsIndex; + ItemType datatype; + uint8_t span; + uint8_t reserved; + uint32_t crc32; + char key[16]; + union { + struct { + uint16_t dataSize; + uint16_t reserved2; + uint32_t dataCrc32; + } varLength; + uint8_t data[8]; + }; + }; + uint8_t rawData[32]; + }; + + static const size_t MAX_KEY_LENGTH = sizeof(key) - 1; + + uint32_t calculateCrc32(); + static uint32_t calculateCrc32(const uint8_t* data, size_t size); + + void getKey(char* dst, size_t dstSize) + { + strncpy(dst, key, (dstSize + void getValue(T& dst) + { + assert(itemTypeOf(dst) == datatype); + dst = *reinterpret_cast(data); + } +}; + +} // namespace nvs + + + +#endif /* nvs_types_h */ diff --git a/components/nvs_flash/test/Makefile b/components/nvs_flash/test/Makefile new file mode 100644 index 000000000..ded1235d7 --- /dev/null +++ b/components/nvs_flash/test/Makefile @@ -0,0 +1,40 @@ +TEST_PROGRAM=test_nvs +all: test + +SOURCE_FILES = \ + $(addprefix ../src/, \ + nvs_types.cpp \ + nvs_api.cpp \ + nvs_page.cpp \ + nvs_pagemanager.cpp \ + nvs_storage.cpp \ + ) \ + spi_flash_emulation.cpp \ + test_compressed_enum_table.cpp \ + test_spi_flash_emulation.cpp \ + test_intrusive_list.cpp \ + test_nvs.cpp \ + crc.cpp \ + main.cpp + +CPPFLAGS += -I../include -I../src -I./ -I../../esp32/include -I ../../spi_flash/include +CXXFLAGS += -std=c++11 -Wall -Werror +LDFLAGS += -lstdc++ + +OBJ_FILES = $(SOURCE_FILES:.cpp=.o) + +$(OBJ_FILES): %.o: %.cpp + +$(TEST_PROGRAM): $(OBJ_FILES) + gcc $(LDFLAGS) -o $(TEST_PROGRAM) $(OBJ_FILES) + +$(OUTPUT_DIR): + mkdir -p $(OUTPUT_DIR) + +test: $(TEST_PROGRAM) + ./$(TEST_PROGRAM) + +clean: + rm -f $(OBJ_FILES) $(TEST_PROGRAM) + +.PHONY: clean all test diff --git a/components/nvs_flash/test/catch.hpp b/components/nvs_flash/test/catch.hpp new file mode 100644 index 000000000..879fc5b1d --- /dev/null +++ b/components/nvs_flash/test/catch.hpp @@ -0,0 +1,10509 @@ +/* + * Catch v1.5.6 + * Generated: 2016-06-09 19:20:41.460328 + * ---------------------------------------------------------- + * This file has been merged from multiple headers. Please don't edit it directly + * Copyright (c) 2012 Two Blue Cubes Ltd. All rights reserved. + * + * Distributed under the Boost Software License, Version 1.0. (See accompanying + * file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) + */ +#ifndef TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED +#define TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED + +#define TWOBLUECUBES_CATCH_HPP_INCLUDED + +#ifdef __clang__ +# pragma clang system_header +#elif defined __GNUC__ +# pragma GCC system_header +#endif + +// #included from: internal/catch_suppress_warnings.h + +#ifdef __clang__ +# ifdef __ICC // icpc defines the __clang__ macro +# pragma warning(push) +# pragma warning(disable: 161 1682) +# else // __ICC +# pragma clang diagnostic ignored "-Wglobal-constructors" +# pragma clang diagnostic ignored "-Wvariadic-macros" +# pragma clang diagnostic ignored "-Wc99-extensions" +# pragma clang diagnostic ignored "-Wunused-variable" +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wpadded" +# pragma clang diagnostic ignored "-Wc++98-compat" +# pragma clang diagnostic ignored "-Wc++98-compat-pedantic" +# pragma clang diagnostic ignored "-Wswitch-enum" +# pragma clang diagnostic ignored "-Wcovered-switch-default" +# endif +#elif defined __GNUC__ +# pragma GCC diagnostic ignored "-Wvariadic-macros" +# pragma GCC diagnostic ignored "-Wunused-variable" +# pragma GCC diagnostic push +# pragma GCC diagnostic ignored "-Wpadded" +#endif +#if defined(CATCH_CONFIG_MAIN) || defined(CATCH_CONFIG_RUNNER) +# define CATCH_IMPL +#endif + +#ifdef CATCH_IMPL +# ifndef CLARA_CONFIG_MAIN +# define CLARA_CONFIG_MAIN_NOT_DEFINED +# define CLARA_CONFIG_MAIN +# endif +#endif + +// #included from: internal/catch_notimplemented_exception.h +#define TWOBLUECUBES_CATCH_NOTIMPLEMENTED_EXCEPTION_H_INCLUDED + +// #included from: catch_common.h +#define TWOBLUECUBES_CATCH_COMMON_H_INCLUDED + +#define INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line ) name##line +#define INTERNAL_CATCH_UNIQUE_NAME_LINE( name, line ) INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line ) +#ifdef CATCH_CONFIG_COUNTER +# define INTERNAL_CATCH_UNIQUE_NAME( name ) INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __COUNTER__ ) +#else +# define INTERNAL_CATCH_UNIQUE_NAME( name ) INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __LINE__ ) +#endif + +#define INTERNAL_CATCH_STRINGIFY2( expr ) #expr +#define INTERNAL_CATCH_STRINGIFY( expr ) INTERNAL_CATCH_STRINGIFY2( expr ) + +#include +#include +#include + +// #included from: catch_compiler_capabilities.h +#define TWOBLUECUBES_CATCH_COMPILER_CAPABILITIES_HPP_INCLUDED + +// Detect a number of compiler features - mostly C++11/14 conformance - by compiler +// The following features are defined: +// +// CATCH_CONFIG_CPP11_NULLPTR : is nullptr supported? +// CATCH_CONFIG_CPP11_NOEXCEPT : is noexcept supported? +// CATCH_CONFIG_CPP11_GENERATED_METHODS : The delete and default keywords for compiler generated methods +// CATCH_CONFIG_CPP11_IS_ENUM : std::is_enum is supported? +// CATCH_CONFIG_CPP11_TUPLE : std::tuple is supported +// CATCH_CONFIG_CPP11_LONG_LONG : is long long supported? +// CATCH_CONFIG_CPP11_OVERRIDE : is override supported? +// CATCH_CONFIG_CPP11_UNIQUE_PTR : is unique_ptr supported (otherwise use auto_ptr) + +// CATCH_CONFIG_CPP11_OR_GREATER : Is C++11 supported? + +// CATCH_CONFIG_VARIADIC_MACROS : are variadic macros supported? +// CATCH_CONFIG_COUNTER : is the __COUNTER__ macro supported? +// **************** +// Note to maintainers: if new toggles are added please document them +// in configuration.md, too +// **************** + +// In general each macro has a _NO_ form +// (e.g. CATCH_CONFIG_CPP11_NO_NULLPTR) which disables the feature. +// Many features, at point of detection, define an _INTERNAL_ macro, so they +// can be combined, en-mass, with the _NO_ forms later. + +// All the C++11 features can be disabled with CATCH_CONFIG_NO_CPP11 + +#ifdef __cplusplus + +# if __cplusplus >= 201103L +# define CATCH_CPP11_OR_GREATER +# endif + +# if __cplusplus >= 201402L +# define CATCH_CPP14_OR_GREATER +# endif + +#endif + +#ifdef __clang__ + +# if __has_feature(cxx_nullptr) +# define CATCH_INTERNAL_CONFIG_CPP11_NULLPTR +# endif + +# if __has_feature(cxx_noexcept) +# define CATCH_INTERNAL_CONFIG_CPP11_NOEXCEPT +# endif + +# if defined(CATCH_CPP11_OR_GREATER) +# define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS _Pragma( "clang diagnostic ignored \"-Wparentheses\"" ) +# endif + +#endif // __clang__ + +//////////////////////////////////////////////////////////////////////////////// +// Borland +#ifdef __BORLANDC__ + +#endif // __BORLANDC__ + +//////////////////////////////////////////////////////////////////////////////// +// EDG +#ifdef __EDG_VERSION__ + +#endif // __EDG_VERSION__ + +//////////////////////////////////////////////////////////////////////////////// +// Digital Mars +#ifdef __DMC__ + +#endif // __DMC__ + +//////////////////////////////////////////////////////////////////////////////// +// GCC +#ifdef __GNUC__ + +# if __GNUC__ == 4 && __GNUC_MINOR__ >= 6 && defined(__GXX_EXPERIMENTAL_CXX0X__) +# define CATCH_INTERNAL_CONFIG_CPP11_NULLPTR +# endif + +# if !defined(CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS) && defined(CATCH_CPP11_OR_GREATER) +# define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS _Pragma( "GCC diagnostic ignored \"-Wparentheses\"" ) +# endif + +// - otherwise more recent versions define __cplusplus >= 201103L +// and will get picked up below + +#endif // __GNUC__ + +//////////////////////////////////////////////////////////////////////////////// +// Visual C++ +#ifdef _MSC_VER + +#if (_MSC_VER >= 1600) +# define CATCH_INTERNAL_CONFIG_CPP11_NULLPTR +# define CATCH_INTERNAL_CONFIG_CPP11_UNIQUE_PTR +#endif + +#if (_MSC_VER >= 1900 ) // (VC++ 13 (VS2015)) +#define CATCH_INTERNAL_CONFIG_CPP11_NOEXCEPT +#define CATCH_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +#endif + +#endif // _MSC_VER + +//////////////////////////////////////////////////////////////////////////////// + +// Use variadic macros if the compiler supports them +#if ( defined _MSC_VER && _MSC_VER > 1400 && !defined __EDGE__) || \ + ( defined __WAVE__ && __WAVE_HAS_VARIADICS ) || \ + ( defined __GNUC__ && __GNUC__ >= 3 ) || \ + ( !defined __cplusplus && __STDC_VERSION__ >= 199901L || __cplusplus >= 201103L ) + +#define CATCH_INTERNAL_CONFIG_VARIADIC_MACROS + +#endif + +// Use __COUNTER__ if the compiler supports it +#if ( defined _MSC_VER && _MSC_VER >= 1300 ) || \ + ( defined __GNUC__ && __GNUC__ >= 4 && __GNUC_MINOR__ >= 3 ) || \ + ( defined __clang__ && __clang_major__ >= 3 ) + +#define CATCH_INTERNAL_CONFIG_COUNTER + +#endif + +//////////////////////////////////////////////////////////////////////////////// +// C++ language feature support + +// catch all support for C++11 +#if defined(CATCH_CPP11_OR_GREATER) + +# if !defined(CATCH_INTERNAL_CONFIG_CPP11_NULLPTR) +# define CATCH_INTERNAL_CONFIG_CPP11_NULLPTR +# endif + +# ifndef CATCH_INTERNAL_CONFIG_CPP11_NOEXCEPT +# define CATCH_INTERNAL_CONFIG_CPP11_NOEXCEPT +# endif + +# ifndef CATCH_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +# define CATCH_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +# endif + +# ifndef CATCH_INTERNAL_CONFIG_CPP11_IS_ENUM +# define CATCH_INTERNAL_CONFIG_CPP11_IS_ENUM +# endif + +# ifndef CATCH_INTERNAL_CONFIG_CPP11_TUPLE +# define CATCH_INTERNAL_CONFIG_CPP11_TUPLE +# endif + +# ifndef CATCH_INTERNAL_CONFIG_VARIADIC_MACROS +# define CATCH_INTERNAL_CONFIG_VARIADIC_MACROS +# endif + +# if !defined(CATCH_INTERNAL_CONFIG_CPP11_LONG_LONG) +# define CATCH_INTERNAL_CONFIG_CPP11_LONG_LONG +# endif + +# if !defined(CATCH_INTERNAL_CONFIG_CPP11_OVERRIDE) +# define CATCH_INTERNAL_CONFIG_CPP11_OVERRIDE +# endif +# if !defined(CATCH_INTERNAL_CONFIG_CPP11_UNIQUE_PTR) +# define CATCH_INTERNAL_CONFIG_CPP11_UNIQUE_PTR +# endif + +#endif // __cplusplus >= 201103L + +// Now set the actual defines based on the above + anything the user has configured +#if defined(CATCH_INTERNAL_CONFIG_CPP11_NULLPTR) && !defined(CATCH_CONFIG_CPP11_NO_NULLPTR) && !defined(CATCH_CONFIG_CPP11_NULLPTR) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_NULLPTR +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_NOEXCEPT) && !defined(CATCH_CONFIG_CPP11_NO_NOEXCEPT) && !defined(CATCH_CONFIG_CPP11_NOEXCEPT) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_NOEXCEPT +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_GENERATED_METHODS) && !defined(CATCH_CONFIG_CPP11_NO_GENERATED_METHODS) && !defined(CATCH_CONFIG_CPP11_GENERATED_METHODS) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_GENERATED_METHODS +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_IS_ENUM) && !defined(CATCH_CONFIG_CPP11_NO_IS_ENUM) && !defined(CATCH_CONFIG_CPP11_IS_ENUM) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_IS_ENUM +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_TUPLE) && !defined(CATCH_CONFIG_CPP11_NO_TUPLE) && !defined(CATCH_CONFIG_CPP11_TUPLE) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_TUPLE +#endif +#if defined(CATCH_INTERNAL_CONFIG_VARIADIC_MACROS) && !defined(CATCH_CONFIG_NO_VARIADIC_MACROS) && !defined(CATCH_CONFIG_VARIADIC_MACROS) +# define CATCH_CONFIG_VARIADIC_MACROS +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_LONG_LONG) && !defined(CATCH_CONFIG_NO_LONG_LONG) && !defined(CATCH_CONFIG_CPP11_LONG_LONG) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_LONG_LONG +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_OVERRIDE) && !defined(CATCH_CONFIG_NO_OVERRIDE) && !defined(CATCH_CONFIG_CPP11_OVERRIDE) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_OVERRIDE +#endif +#if defined(CATCH_INTERNAL_CONFIG_CPP11_UNIQUE_PTR) && !defined(CATCH_CONFIG_NO_UNIQUE_PTR) && !defined(CATCH_CONFIG_CPP11_UNIQUE_PTR) && !defined(CATCH_CONFIG_NO_CPP11) +# define CATCH_CONFIG_CPP11_UNIQUE_PTR +#endif +#if defined(CATCH_INTERNAL_CONFIG_COUNTER) && !defined(CATCH_CONFIG_NO_COUNTER) && !defined(CATCH_CONFIG_COUNTER) +# define CATCH_CONFIG_COUNTER +#endif + +#if !defined(CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS) +# define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS +#endif + +// noexcept support: +#if defined(CATCH_CONFIG_CPP11_NOEXCEPT) && !defined(CATCH_NOEXCEPT) +# define CATCH_NOEXCEPT noexcept +# define CATCH_NOEXCEPT_IS(x) noexcept(x) +#else +# define CATCH_NOEXCEPT throw() +# define CATCH_NOEXCEPT_IS(x) +#endif + +// nullptr support +#ifdef CATCH_CONFIG_CPP11_NULLPTR +# define CATCH_NULL nullptr +#else +# define CATCH_NULL NULL +#endif + +// override support +#ifdef CATCH_CONFIG_CPP11_OVERRIDE +# define CATCH_OVERRIDE override +#else +# define CATCH_OVERRIDE +#endif + +// unique_ptr support +#ifdef CATCH_CONFIG_CPP11_UNIQUE_PTR +# define CATCH_AUTO_PTR( T ) std::unique_ptr +#else +# define CATCH_AUTO_PTR( T ) std::auto_ptr +#endif + +namespace Catch { + + struct IConfig; + + struct CaseSensitive { enum Choice { + Yes, + No + }; }; + + class NonCopyable { +#ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + NonCopyable( NonCopyable const& ) = delete; + NonCopyable( NonCopyable && ) = delete; + NonCopyable& operator = ( NonCopyable const& ) = delete; + NonCopyable& operator = ( NonCopyable && ) = delete; +#else + NonCopyable( NonCopyable const& info ); + NonCopyable& operator = ( NonCopyable const& ); +#endif + + protected: + NonCopyable() {} + virtual ~NonCopyable(); + }; + + class SafeBool { + public: + typedef void (SafeBool::*type)() const; + + static type makeSafe( bool value ) { + return value ? &SafeBool::trueValue : 0; + } + private: + void trueValue() const {} + }; + + template + inline void deleteAll( ContainerT& container ) { + typename ContainerT::const_iterator it = container.begin(); + typename ContainerT::const_iterator itEnd = container.end(); + for(; it != itEnd; ++it ) + delete *it; + } + template + inline void deleteAllValues( AssociativeContainerT& container ) { + typename AssociativeContainerT::const_iterator it = container.begin(); + typename AssociativeContainerT::const_iterator itEnd = container.end(); + for(; it != itEnd; ++it ) + delete it->second; + } + + bool startsWith( std::string const& s, std::string const& prefix ); + bool endsWith( std::string const& s, std::string const& suffix ); + bool contains( std::string const& s, std::string const& infix ); + void toLowerInPlace( std::string& s ); + std::string toLower( std::string const& s ); + std::string trim( std::string const& str ); + bool replaceInPlace( std::string& str, std::string const& replaceThis, std::string const& withThis ); + + struct pluralise { + pluralise( std::size_t count, std::string const& label ); + + friend std::ostream& operator << ( std::ostream& os, pluralise const& pluraliser ); + + std::size_t m_count; + std::string m_label; + }; + + struct SourceLineInfo { + + SourceLineInfo(); + SourceLineInfo( char const* _file, std::size_t _line ); + SourceLineInfo( SourceLineInfo const& other ); +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + SourceLineInfo( SourceLineInfo && ) = default; + SourceLineInfo& operator = ( SourceLineInfo const& ) = default; + SourceLineInfo& operator = ( SourceLineInfo && ) = default; +# endif + bool empty() const; + bool operator == ( SourceLineInfo const& other ) const; + bool operator < ( SourceLineInfo const& other ) const; + + std::string file; + std::size_t line; + }; + + std::ostream& operator << ( std::ostream& os, SourceLineInfo const& info ); + + // This is just here to avoid compiler warnings with macro constants and boolean literals + inline bool isTrue( bool value ){ return value; } + inline bool alwaysTrue() { return true; } + inline bool alwaysFalse() { return false; } + + void throwLogicError( std::string const& message, SourceLineInfo const& locationInfo ); + + void seedRng( IConfig const& config ); + unsigned int rngSeed(); + + // Use this in variadic streaming macros to allow + // >> +StreamEndStop + // as well as + // >> stuff +StreamEndStop + struct StreamEndStop { + std::string operator+() { + return std::string(); + } + }; + template + T const& operator + ( T const& value, StreamEndStop ) { + return value; + } +} + +#define CATCH_INTERNAL_LINEINFO ::Catch::SourceLineInfo( __FILE__, static_cast( __LINE__ ) ) +#define CATCH_INTERNAL_ERROR( msg ) ::Catch::throwLogicError( msg, CATCH_INTERNAL_LINEINFO ); + +#include + +namespace Catch { + + class NotImplementedException : public std::exception + { + public: + NotImplementedException( SourceLineInfo const& lineInfo ); + NotImplementedException( NotImplementedException const& ) {} + + virtual ~NotImplementedException() CATCH_NOEXCEPT {} + + virtual const char* what() const CATCH_NOEXCEPT; + + private: + std::string m_what; + SourceLineInfo m_lineInfo; + }; + +} // end namespace Catch + +/////////////////////////////////////////////////////////////////////////////// +#define CATCH_NOT_IMPLEMENTED throw Catch::NotImplementedException( CATCH_INTERNAL_LINEINFO ) + +// #included from: internal/catch_context.h +#define TWOBLUECUBES_CATCH_CONTEXT_H_INCLUDED + +// #included from: catch_interfaces_generators.h +#define TWOBLUECUBES_CATCH_INTERFACES_GENERATORS_H_INCLUDED + +#include + +namespace Catch { + + struct IGeneratorInfo { + virtual ~IGeneratorInfo(); + virtual bool moveNext() = 0; + virtual std::size_t getCurrentIndex() const = 0; + }; + + struct IGeneratorsForTest { + virtual ~IGeneratorsForTest(); + + virtual IGeneratorInfo& getGeneratorInfo( std::string const& fileInfo, std::size_t size ) = 0; + virtual bool moveNext() = 0; + }; + + IGeneratorsForTest* createGeneratorsForTest(); + +} // end namespace Catch + +// #included from: catch_ptr.hpp +#define TWOBLUECUBES_CATCH_PTR_HPP_INCLUDED + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wpadded" +#endif + +namespace Catch { + + // An intrusive reference counting smart pointer. + // T must implement addRef() and release() methods + // typically implementing the IShared interface + template + class Ptr { + public: + Ptr() : m_p( CATCH_NULL ){} + Ptr( T* p ) : m_p( p ){ + if( m_p ) + m_p->addRef(); + } + Ptr( Ptr const& other ) : m_p( other.m_p ){ + if( m_p ) + m_p->addRef(); + } + ~Ptr(){ + if( m_p ) + m_p->release(); + } + void reset() { + if( m_p ) + m_p->release(); + m_p = CATCH_NULL; + } + Ptr& operator = ( T* p ){ + Ptr temp( p ); + swap( temp ); + return *this; + } + Ptr& operator = ( Ptr const& other ){ + Ptr temp( other ); + swap( temp ); + return *this; + } + void swap( Ptr& other ) { std::swap( m_p, other.m_p ); } + T* get() const{ return m_p; } + T& operator*() const { return *m_p; } + T* operator->() const { return m_p; } + bool operator !() const { return m_p == CATCH_NULL; } + operator SafeBool::type() const { return SafeBool::makeSafe( m_p != CATCH_NULL ); } + + private: + T* m_p; + }; + + struct IShared : NonCopyable { + virtual ~IShared(); + virtual void addRef() const = 0; + virtual void release() const = 0; + }; + + template + struct SharedImpl : T { + + SharedImpl() : m_rc( 0 ){} + + virtual void addRef() const { + ++m_rc; + } + virtual void release() const { + if( --m_rc == 0 ) + delete this; + } + + mutable unsigned int m_rc; + }; + +} // end namespace Catch + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + +#include +#include +#include + +namespace Catch { + + class TestCase; + class Stream; + struct IResultCapture; + struct IRunner; + struct IGeneratorsForTest; + struct IConfig; + + struct IContext + { + virtual ~IContext(); + + virtual IResultCapture* getResultCapture() = 0; + virtual IRunner* getRunner() = 0; + virtual size_t getGeneratorIndex( std::string const& fileInfo, size_t totalSize ) = 0; + virtual bool advanceGeneratorsForCurrentTest() = 0; + virtual Ptr getConfig() const = 0; + }; + + struct IMutableContext : IContext + { + virtual ~IMutableContext(); + virtual void setResultCapture( IResultCapture* resultCapture ) = 0; + virtual void setRunner( IRunner* runner ) = 0; + virtual void setConfig( Ptr const& config ) = 0; + }; + + IContext& getCurrentContext(); + IMutableContext& getCurrentMutableContext(); + void cleanUpContext(); + Stream createStream( std::string const& streamName ); + +} + +// #included from: internal/catch_test_registry.hpp +#define TWOBLUECUBES_CATCH_TEST_REGISTRY_HPP_INCLUDED + +// #included from: catch_interfaces_testcase.h +#define TWOBLUECUBES_CATCH_INTERFACES_TESTCASE_H_INCLUDED + +#include + +namespace Catch { + + class TestSpec; + + struct ITestCase : IShared { + virtual void invoke () const = 0; + protected: + virtual ~ITestCase(); + }; + + class TestCase; + struct IConfig; + + struct ITestCaseRegistry { + virtual ~ITestCaseRegistry(); + virtual std::vector const& getAllTests() const = 0; + virtual std::vector const& getAllTestsSorted( IConfig const& config ) const = 0; + }; + + bool matchTest( TestCase const& testCase, TestSpec const& testSpec, IConfig const& config ); + std::vector filterTests( std::vector const& testCases, TestSpec const& testSpec, IConfig const& config ); + std::vector const& getAllTestCasesSorted( IConfig const& config ); + +} + +namespace Catch { + +template +class MethodTestCase : public SharedImpl { + +public: + MethodTestCase( void (C::*method)() ) : m_method( method ) {} + + virtual void invoke() const { + C obj; + (obj.*m_method)(); + } + +private: + virtual ~MethodTestCase() {} + + void (C::*m_method)(); +}; + +typedef void(*TestFunction)(); + +struct NameAndDesc { + NameAndDesc( const char* _name = "", const char* _description= "" ) + : name( _name ), description( _description ) + {} + + const char* name; + const char* description; +}; + +void registerTestCase + ( ITestCase* testCase, + char const* className, + NameAndDesc const& nameAndDesc, + SourceLineInfo const& lineInfo ); + +struct AutoReg { + + AutoReg + ( TestFunction function, + SourceLineInfo const& lineInfo, + NameAndDesc const& nameAndDesc ); + + template + AutoReg + ( void (C::*method)(), + char const* className, + NameAndDesc const& nameAndDesc, + SourceLineInfo const& lineInfo ) { + + registerTestCase + ( new MethodTestCase( method ), + className, + nameAndDesc, + lineInfo ); + } + + ~AutoReg(); + +private: + AutoReg( AutoReg const& ); + void operator= ( AutoReg const& ); +}; + +void registerTestCaseFunction + ( TestFunction function, + SourceLineInfo const& lineInfo, + NameAndDesc const& nameAndDesc ); + +} // end namespace Catch + +#ifdef CATCH_CONFIG_VARIADIC_MACROS + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_TESTCASE2( TestName, ... ) \ + static void TestName(); \ + namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( &TestName, CATCH_INTERNAL_LINEINFO, Catch::NameAndDesc( __VA_ARGS__ ) ); }\ + static void TestName() + #define INTERNAL_CATCH_TESTCASE( ... ) \ + INTERNAL_CATCH_TESTCASE2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), __VA_ARGS__ ) + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_METHOD_AS_TEST_CASE( QualifiedMethod, ... ) \ + namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( &QualifiedMethod, "&" #QualifiedMethod, Catch::NameAndDesc( __VA_ARGS__ ), CATCH_INTERNAL_LINEINFO ); } + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_TEST_CASE_METHOD2( TestName, ClassName, ... )\ + namespace{ \ + struct TestName : ClassName{ \ + void test(); \ + }; \ + Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar ) ( &TestName::test, #ClassName, Catch::NameAndDesc( __VA_ARGS__ ), CATCH_INTERNAL_LINEINFO ); \ + } \ + void TestName::test() + #define INTERNAL_CATCH_TEST_CASE_METHOD( ClassName, ... ) \ + INTERNAL_CATCH_TEST_CASE_METHOD2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), ClassName, __VA_ARGS__ ) + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_REGISTER_TESTCASE( Function, ... ) \ + Catch::AutoReg( Function, CATCH_INTERNAL_LINEINFO, Catch::NameAndDesc( __VA_ARGS__ ) ); + +#else + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_TESTCASE2( TestName, Name, Desc ) \ + static void TestName(); \ + namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( &TestName, CATCH_INTERNAL_LINEINFO, Catch::NameAndDesc( Name, Desc ) ); }\ + static void TestName() + #define INTERNAL_CATCH_TESTCASE( Name, Desc ) \ + INTERNAL_CATCH_TESTCASE2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), Name, Desc ) + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_METHOD_AS_TEST_CASE( QualifiedMethod, Name, Desc ) \ + namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( &QualifiedMethod, "&" #QualifiedMethod, Catch::NameAndDesc( Name, Desc ), CATCH_INTERNAL_LINEINFO ); } + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_TEST_CASE_METHOD2( TestCaseName, ClassName, TestName, Desc )\ + namespace{ \ + struct TestCaseName : ClassName{ \ + void test(); \ + }; \ + Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar ) ( &TestCaseName::test, #ClassName, Catch::NameAndDesc( TestName, Desc ), CATCH_INTERNAL_LINEINFO ); \ + } \ + void TestCaseName::test() + #define INTERNAL_CATCH_TEST_CASE_METHOD( ClassName, TestName, Desc )\ + INTERNAL_CATCH_TEST_CASE_METHOD2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), ClassName, TestName, Desc ) + + /////////////////////////////////////////////////////////////////////////////// + #define INTERNAL_CATCH_REGISTER_TESTCASE( Function, Name, Desc ) \ + Catch::AutoReg( Function, CATCH_INTERNAL_LINEINFO, Catch::NameAndDesc( Name, Desc ) ); +#endif + +// #included from: internal/catch_capture.hpp +#define TWOBLUECUBES_CATCH_CAPTURE_HPP_INCLUDED + +// #included from: catch_result_builder.h +#define TWOBLUECUBES_CATCH_RESULT_BUILDER_H_INCLUDED + +// #included from: catch_result_type.h +#define TWOBLUECUBES_CATCH_RESULT_TYPE_H_INCLUDED + +namespace Catch { + + // ResultWas::OfType enum + struct ResultWas { enum OfType { + Unknown = -1, + Ok = 0, + Info = 1, + Warning = 2, + + FailureBit = 0x10, + + ExpressionFailed = FailureBit | 1, + ExplicitFailure = FailureBit | 2, + + Exception = 0x100 | FailureBit, + + ThrewException = Exception | 1, + DidntThrowException = Exception | 2, + + FatalErrorCondition = 0x200 | FailureBit + + }; }; + + inline bool isOk( ResultWas::OfType resultType ) { + return ( resultType & ResultWas::FailureBit ) == 0; + } + inline bool isJustInfo( int flags ) { + return flags == ResultWas::Info; + } + + // ResultDisposition::Flags enum + struct ResultDisposition { enum Flags { + Normal = 0x01, + + ContinueOnFailure = 0x02, // Failures fail test, but execution continues + FalseTest = 0x04, // Prefix expression with ! + SuppressFail = 0x08 // Failures are reported but do not fail the test + }; }; + + inline ResultDisposition::Flags operator | ( ResultDisposition::Flags lhs, ResultDisposition::Flags rhs ) { + return static_cast( static_cast( lhs ) | static_cast( rhs ) ); + } + + inline bool shouldContinueOnFailure( int flags ) { return ( flags & ResultDisposition::ContinueOnFailure ) != 0; } + inline bool isFalseTest( int flags ) { return ( flags & ResultDisposition::FalseTest ) != 0; } + inline bool shouldSuppressFailure( int flags ) { return ( flags & ResultDisposition::SuppressFail ) != 0; } + +} // end namespace Catch + +// #included from: catch_assertionresult.h +#define TWOBLUECUBES_CATCH_ASSERTIONRESULT_H_INCLUDED + +#include + +namespace Catch { + + struct AssertionInfo + { + AssertionInfo() {} + AssertionInfo( std::string const& _macroName, + SourceLineInfo const& _lineInfo, + std::string const& _capturedExpression, + ResultDisposition::Flags _resultDisposition ); + + std::string macroName; + SourceLineInfo lineInfo; + std::string capturedExpression; + ResultDisposition::Flags resultDisposition; + }; + + struct AssertionResultData + { + AssertionResultData() : resultType( ResultWas::Unknown ) {} + + std::string reconstructedExpression; + std::string message; + ResultWas::OfType resultType; + }; + + class AssertionResult { + public: + AssertionResult(); + AssertionResult( AssertionInfo const& info, AssertionResultData const& data ); + ~AssertionResult(); +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + AssertionResult( AssertionResult const& ) = default; + AssertionResult( AssertionResult && ) = default; + AssertionResult& operator = ( AssertionResult const& ) = default; + AssertionResult& operator = ( AssertionResult && ) = default; +# endif + + bool isOk() const; + bool succeeded() const; + ResultWas::OfType getResultType() const; + bool hasExpression() const; + bool hasMessage() const; + std::string getExpression() const; + std::string getExpressionInMacro() const; + bool hasExpandedExpression() const; + std::string getExpandedExpression() const; + std::string getMessage() const; + SourceLineInfo getSourceInfo() const; + std::string getTestMacroName() const; + + protected: + AssertionInfo m_info; + AssertionResultData m_resultData; + }; + +} // end namespace Catch + +// #included from: catch_matchers.hpp +#define TWOBLUECUBES_CATCH_MATCHERS_HPP_INCLUDED + +namespace Catch { +namespace Matchers { + namespace Impl { + + namespace Generic { + template class AllOf; + template class AnyOf; + template class Not; + } + + template + struct Matcher : SharedImpl + { + typedef ExpressionT ExpressionType; + + virtual ~Matcher() {} + virtual Ptr clone() const = 0; + virtual bool match( ExpressionT const& expr ) const = 0; + virtual std::string toString() const = 0; + + Generic::AllOf operator && ( Matcher const& other ) const; + Generic::AnyOf operator || ( Matcher const& other ) const; + Generic::Not operator ! () const; + }; + + template + struct MatcherImpl : Matcher { + + virtual Ptr > clone() const { + return Ptr >( new DerivedT( static_cast( *this ) ) ); + } + }; + + namespace Generic { + template + class Not : public MatcherImpl, ExpressionT> { + public: + explicit Not( Matcher const& matcher ) : m_matcher(matcher.clone()) {} + Not( Not const& other ) : m_matcher( other.m_matcher ) {} + + virtual bool match( ExpressionT const& expr ) const CATCH_OVERRIDE { + return !m_matcher->match( expr ); + } + + virtual std::string toString() const CATCH_OVERRIDE { + return "not " + m_matcher->toString(); + } + private: + Ptr< Matcher > m_matcher; + }; + + template + class AllOf : public MatcherImpl, ExpressionT> { + public: + + AllOf() {} + AllOf( AllOf const& other ) : m_matchers( other.m_matchers ) {} + + AllOf& add( Matcher const& matcher ) { + m_matchers.push_back( matcher.clone() ); + return *this; + } + virtual bool match( ExpressionT const& expr ) const + { + for( std::size_t i = 0; i < m_matchers.size(); ++i ) + if( !m_matchers[i]->match( expr ) ) + return false; + return true; + } + virtual std::string toString() const { + std::ostringstream oss; + oss << "( "; + for( std::size_t i = 0; i < m_matchers.size(); ++i ) { + if( i != 0 ) + oss << " and "; + oss << m_matchers[i]->toString(); + } + oss << " )"; + return oss.str(); + } + + AllOf operator && ( Matcher const& other ) const { + AllOf allOfExpr( *this ); + allOfExpr.add( other ); + return allOfExpr; + } + + private: + std::vector > > m_matchers; + }; + + template + class AnyOf : public MatcherImpl, ExpressionT> { + public: + + AnyOf() {} + AnyOf( AnyOf const& other ) : m_matchers( other.m_matchers ) {} + + AnyOf& add( Matcher const& matcher ) { + m_matchers.push_back( matcher.clone() ); + return *this; + } + virtual bool match( ExpressionT const& expr ) const + { + for( std::size_t i = 0; i < m_matchers.size(); ++i ) + if( m_matchers[i]->match( expr ) ) + return true; + return false; + } + virtual std::string toString() const { + std::ostringstream oss; + oss << "( "; + for( std::size_t i = 0; i < m_matchers.size(); ++i ) { + if( i != 0 ) + oss << " or "; + oss << m_matchers[i]->toString(); + } + oss << " )"; + return oss.str(); + } + + AnyOf operator || ( Matcher const& other ) const { + AnyOf anyOfExpr( *this ); + anyOfExpr.add( other ); + return anyOfExpr; + } + + private: + std::vector > > m_matchers; + }; + + } // namespace Generic + + template + Generic::AllOf Matcher::operator && ( Matcher const& other ) const { + Generic::AllOf allOfExpr; + allOfExpr.add( *this ); + allOfExpr.add( other ); + return allOfExpr; + } + + template + Generic::AnyOf Matcher::operator || ( Matcher const& other ) const { + Generic::AnyOf anyOfExpr; + anyOfExpr.add( *this ); + anyOfExpr.add( other ); + return anyOfExpr; + } + + template + Generic::Not Matcher::operator ! () const { + return Generic::Not( *this ); + } + + namespace StdString { + + inline std::string makeString( std::string const& str ) { return str; } + inline std::string makeString( const char* str ) { return str ? std::string( str ) : std::string(); } + + struct CasedString + { + CasedString( std::string const& str, CaseSensitive::Choice caseSensitivity ) + : m_caseSensitivity( caseSensitivity ), + m_str( adjustString( str ) ) + {} + std::string adjustString( std::string const& str ) const { + return m_caseSensitivity == CaseSensitive::No + ? toLower( str ) + : str; + + } + std::string toStringSuffix() const + { + return m_caseSensitivity == CaseSensitive::No + ? " (case insensitive)" + : ""; + } + CaseSensitive::Choice m_caseSensitivity; + std::string m_str; + }; + + struct Equals : MatcherImpl { + Equals( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) + : m_data( str, caseSensitivity ) + {} + Equals( Equals const& other ) : m_data( other.m_data ){} + + virtual ~Equals(); + + virtual bool match( std::string const& expr ) const { + return m_data.m_str == m_data.adjustString( expr );; + } + virtual std::string toString() const { + return "equals: \"" + m_data.m_str + "\"" + m_data.toStringSuffix(); + } + + CasedString m_data; + }; + + struct Contains : MatcherImpl { + Contains( std::string const& substr, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) + : m_data( substr, caseSensitivity ){} + Contains( Contains const& other ) : m_data( other.m_data ){} + + virtual ~Contains(); + + virtual bool match( std::string const& expr ) const { + return m_data.adjustString( expr ).find( m_data.m_str ) != std::string::npos; + } + virtual std::string toString() const { + return "contains: \"" + m_data.m_str + "\"" + m_data.toStringSuffix(); + } + + CasedString m_data; + }; + + struct StartsWith : MatcherImpl { + StartsWith( std::string const& substr, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) + : m_data( substr, caseSensitivity ){} + + StartsWith( StartsWith const& other ) : m_data( other.m_data ){} + + virtual ~StartsWith(); + + virtual bool match( std::string const& expr ) const { + return startsWith( m_data.adjustString( expr ), m_data.m_str ); + } + virtual std::string toString() const { + return "starts with: \"" + m_data.m_str + "\"" + m_data.toStringSuffix(); + } + + CasedString m_data; + }; + + struct EndsWith : MatcherImpl { + EndsWith( std::string const& substr, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) + : m_data( substr, caseSensitivity ){} + EndsWith( EndsWith const& other ) : m_data( other.m_data ){} + + virtual ~EndsWith(); + + virtual bool match( std::string const& expr ) const { + return endsWith( m_data.adjustString( expr ), m_data.m_str ); + } + virtual std::string toString() const { + return "ends with: \"" + m_data.m_str + "\"" + m_data.toStringSuffix(); + } + + CasedString m_data; + }; + } // namespace StdString + } // namespace Impl + + // The following functions create the actual matcher objects. + // This allows the types to be inferred + template + inline Impl::Generic::Not Not( Impl::Matcher const& m ) { + return Impl::Generic::Not( m ); + } + + template + inline Impl::Generic::AllOf AllOf( Impl::Matcher const& m1, + Impl::Matcher const& m2 ) { + return Impl::Generic::AllOf().add( m1 ).add( m2 ); + } + template + inline Impl::Generic::AllOf AllOf( Impl::Matcher const& m1, + Impl::Matcher const& m2, + Impl::Matcher const& m3 ) { + return Impl::Generic::AllOf().add( m1 ).add( m2 ).add( m3 ); + } + template + inline Impl::Generic::AnyOf AnyOf( Impl::Matcher const& m1, + Impl::Matcher const& m2 ) { + return Impl::Generic::AnyOf().add( m1 ).add( m2 ); + } + template + inline Impl::Generic::AnyOf AnyOf( Impl::Matcher const& m1, + Impl::Matcher const& m2, + Impl::Matcher const& m3 ) { + return Impl::Generic::AnyOf().add( m1 ).add( m2 ).add( m3 ); + } + + inline Impl::StdString::Equals Equals( std::string const& str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) { + return Impl::StdString::Equals( str, caseSensitivity ); + } + inline Impl::StdString::Equals Equals( const char* str, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) { + return Impl::StdString::Equals( Impl::StdString::makeString( str ), caseSensitivity ); + } + inline Impl::StdString::Contains Contains( std::string const& substr, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) { + return Impl::StdString::Contains( substr, caseSensitivity ); + } + inline Impl::StdString::Contains Contains( const char* substr, CaseSensitive::Choice caseSensitivity = CaseSensitive::Yes ) { + return Impl::StdString::Contains( Impl::StdString::makeString( substr ), caseSensitivity ); + } + inline Impl::StdString::StartsWith StartsWith( std::string const& substr ) { + return Impl::StdString::StartsWith( substr ); + } + inline Impl::StdString::StartsWith StartsWith( const char* substr ) { + return Impl::StdString::StartsWith( Impl::StdString::makeString( substr ) ); + } + inline Impl::StdString::EndsWith EndsWith( std::string const& substr ) { + return Impl::StdString::EndsWith( substr ); + } + inline Impl::StdString::EndsWith EndsWith( const char* substr ) { + return Impl::StdString::EndsWith( Impl::StdString::makeString( substr ) ); + } + +} // namespace Matchers + +using namespace Matchers; + +} // namespace Catch + +namespace Catch { + + struct TestFailureException{}; + + template class ExpressionLhs; + + struct STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison; + + struct CopyableStream { + CopyableStream() {} + CopyableStream( CopyableStream const& other ) { + oss << other.oss.str(); + } + CopyableStream& operator=( CopyableStream const& other ) { + oss.str(""); + oss << other.oss.str(); + return *this; + } + std::ostringstream oss; + }; + + class ResultBuilder { + public: + ResultBuilder( char const* macroName, + SourceLineInfo const& lineInfo, + char const* capturedExpression, + ResultDisposition::Flags resultDisposition, + char const* secondArg = "" ); + + template + ExpressionLhs operator <= ( T const& operand ); + ExpressionLhs operator <= ( bool value ); + + template + ResultBuilder& operator << ( T const& value ) { + m_stream.oss << value; + return *this; + } + + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator && ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator || ( RhsT const& ); + + ResultBuilder& setResultType( ResultWas::OfType result ); + ResultBuilder& setResultType( bool result ); + ResultBuilder& setLhs( std::string const& lhs ); + ResultBuilder& setRhs( std::string const& rhs ); + ResultBuilder& setOp( std::string const& op ); + + void endExpression(); + + std::string reconstructExpression() const; + AssertionResult build() const; + + void useActiveException( ResultDisposition::Flags resultDisposition = ResultDisposition::Normal ); + void captureResult( ResultWas::OfType resultType ); + void captureExpression(); + void captureExpectedException( std::string const& expectedMessage ); + void captureExpectedException( Matchers::Impl::Matcher const& matcher ); + void handleResult( AssertionResult const& result ); + void react(); + bool shouldDebugBreak() const; + bool allowThrows() const; + + private: + AssertionInfo m_assertionInfo; + AssertionResultData m_data; + struct ExprComponents { + ExprComponents() : testFalse( false ) {} + bool testFalse; + std::string lhs, rhs, op; + } m_exprComponents; + CopyableStream m_stream; + + bool m_shouldDebugBreak; + bool m_shouldThrow; + }; + +} // namespace Catch + +// Include after due to circular dependency: +// #included from: catch_expression_lhs.hpp +#define TWOBLUECUBES_CATCH_EXPRESSION_LHS_HPP_INCLUDED + +// #included from: catch_evaluate.hpp +#define TWOBLUECUBES_CATCH_EVALUATE_HPP_INCLUDED + +#ifdef _MSC_VER +#pragma warning(push) +#pragma warning(disable:4389) // '==' : signed/unsigned mismatch +#endif + +#include + +namespace Catch { +namespace Internal { + + enum Operator { + IsEqualTo, + IsNotEqualTo, + IsLessThan, + IsGreaterThan, + IsLessThanOrEqualTo, + IsGreaterThanOrEqualTo + }; + + template struct OperatorTraits { static const char* getName(){ return "*error*"; } }; + template<> struct OperatorTraits { static const char* getName(){ return "=="; } }; + template<> struct OperatorTraits { static const char* getName(){ return "!="; } }; + template<> struct OperatorTraits { static const char* getName(){ return "<"; } }; + template<> struct OperatorTraits { static const char* getName(){ return ">"; } }; + template<> struct OperatorTraits { static const char* getName(){ return "<="; } }; + template<> struct OperatorTraits{ static const char* getName(){ return ">="; } }; + + template + inline T& opCast(T const& t) { return const_cast(t); } + +// nullptr_t support based on pull request #154 from Konstantin Baumann +#ifdef CATCH_CONFIG_CPP11_NULLPTR + inline std::nullptr_t opCast(std::nullptr_t) { return nullptr; } +#endif // CATCH_CONFIG_CPP11_NULLPTR + + // So the compare overloads can be operator agnostic we convey the operator as a template + // enum, which is used to specialise an Evaluator for doing the comparison. + template + class Evaluator{}; + + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs) { + return bool( opCast( lhs ) == opCast( rhs ) ); + } + }; + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs ) { + return bool( opCast( lhs ) != opCast( rhs ) ); + } + }; + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs ) { + return bool( opCast( lhs ) < opCast( rhs ) ); + } + }; + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs ) { + return bool( opCast( lhs ) > opCast( rhs ) ); + } + }; + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs ) { + return bool( opCast( lhs ) >= opCast( rhs ) ); + } + }; + template + struct Evaluator { + static bool evaluate( T1 const& lhs, T2 const& rhs ) { + return bool( opCast( lhs ) <= opCast( rhs ) ); + } + }; + + template + bool applyEvaluator( T1 const& lhs, T2 const& rhs ) { + return Evaluator::evaluate( lhs, rhs ); + } + + // This level of indirection allows us to specialise for integer types + // to avoid signed/ unsigned warnings + + // "base" overload + template + bool compare( T1 const& lhs, T2 const& rhs ) { + return Evaluator::evaluate( lhs, rhs ); + } + + // unsigned X to int + template bool compare( unsigned int lhs, int rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + template bool compare( unsigned long lhs, int rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + template bool compare( unsigned char lhs, int rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + + // unsigned X to long + template bool compare( unsigned int lhs, long rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + template bool compare( unsigned long lhs, long rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + template bool compare( unsigned char lhs, long rhs ) { + return applyEvaluator( lhs, static_cast( rhs ) ); + } + + // int to unsigned X + template bool compare( int lhs, unsigned int rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( int lhs, unsigned long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( int lhs, unsigned char rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + + // long to unsigned X + template bool compare( long lhs, unsigned int rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( long lhs, unsigned long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( long lhs, unsigned char rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + + // pointer to long (when comparing against NULL) + template bool compare( long lhs, T* rhs ) { + return Evaluator::evaluate( reinterpret_cast( lhs ), rhs ); + } + template bool compare( T* lhs, long rhs ) { + return Evaluator::evaluate( lhs, reinterpret_cast( rhs ) ); + } + + // pointer to int (when comparing against NULL) + template bool compare( int lhs, T* rhs ) { + return Evaluator::evaluate( reinterpret_cast( lhs ), rhs ); + } + template bool compare( T* lhs, int rhs ) { + return Evaluator::evaluate( lhs, reinterpret_cast( rhs ) ); + } + +#ifdef CATCH_CONFIG_CPP11_LONG_LONG + // long long to unsigned X + template bool compare( long long lhs, unsigned int rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( long long lhs, unsigned long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( long long lhs, unsigned long long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( long long lhs, unsigned char rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + + // unsigned long long to X + template bool compare( unsigned long long lhs, int rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( unsigned long long lhs, long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( unsigned long long lhs, long long rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + template bool compare( unsigned long long lhs, char rhs ) { + return applyEvaluator( static_cast( lhs ), rhs ); + } + + // pointer to long long (when comparing against NULL) + template bool compare( long long lhs, T* rhs ) { + return Evaluator::evaluate( reinterpret_cast( lhs ), rhs ); + } + template bool compare( T* lhs, long long rhs ) { + return Evaluator::evaluate( lhs, reinterpret_cast( rhs ) ); + } +#endif // CATCH_CONFIG_CPP11_LONG_LONG + +#ifdef CATCH_CONFIG_CPP11_NULLPTR + // pointer to nullptr_t (when comparing against nullptr) + template bool compare( std::nullptr_t, T* rhs ) { + return Evaluator::evaluate( nullptr, rhs ); + } + template bool compare( T* lhs, std::nullptr_t ) { + return Evaluator::evaluate( lhs, nullptr ); + } +#endif // CATCH_CONFIG_CPP11_NULLPTR + +} // end of namespace Internal +} // end of namespace Catch + +#ifdef _MSC_VER +#pragma warning(pop) +#endif + +// #included from: catch_tostring.h +#define TWOBLUECUBES_CATCH_TOSTRING_H_INCLUDED + +#include +#include +#include +#include +#include + +#ifdef __OBJC__ +// #included from: catch_objc_arc.hpp +#define TWOBLUECUBES_CATCH_OBJC_ARC_HPP_INCLUDED + +#import + +#ifdef __has_feature +#define CATCH_ARC_ENABLED __has_feature(objc_arc) +#else +#define CATCH_ARC_ENABLED 0 +#endif + +void arcSafeRelease( NSObject* obj ); +id performOptionalSelector( id obj, SEL sel ); + +#if !CATCH_ARC_ENABLED +inline void arcSafeRelease( NSObject* obj ) { + [obj release]; +} +inline id performOptionalSelector( id obj, SEL sel ) { + if( [obj respondsToSelector: sel] ) + return [obj performSelector: sel]; + return nil; +} +#define CATCH_UNSAFE_UNRETAINED +#define CATCH_ARC_STRONG +#else +inline void arcSafeRelease( NSObject* ){} +inline id performOptionalSelector( id obj, SEL sel ) { +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Warc-performSelector-leaks" +#endif + if( [obj respondsToSelector: sel] ) + return [obj performSelector: sel]; +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + return nil; +} +#define CATCH_UNSAFE_UNRETAINED __unsafe_unretained +#define CATCH_ARC_STRONG __strong +#endif + +#endif + +#ifdef CATCH_CONFIG_CPP11_TUPLE +#include +#endif + +#ifdef CATCH_CONFIG_CPP11_IS_ENUM +#include +#endif + +namespace Catch { + +// Why we're here. +template +std::string toString( T const& value ); + +// Built in overloads + +std::string toString( std::string const& value ); +std::string toString( std::wstring const& value ); +std::string toString( const char* const value ); +std::string toString( char* const value ); +std::string toString( const wchar_t* const value ); +std::string toString( wchar_t* const value ); +std::string toString( int value ); +std::string toString( unsigned long value ); +std::string toString( unsigned int value ); +std::string toString( const double value ); +std::string toString( const float value ); +std::string toString( bool value ); +std::string toString( char value ); +std::string toString( signed char value ); +std::string toString( unsigned char value ); + +#ifdef CATCH_CONFIG_CPP11_LONG_LONG +std::string toString( long long value ); +std::string toString( unsigned long long value ); +#endif + +#ifdef CATCH_CONFIG_CPP11_NULLPTR +std::string toString( std::nullptr_t ); +#endif + +#ifdef __OBJC__ + std::string toString( NSString const * const& nsstring ); + std::string toString( NSString * CATCH_ARC_STRONG const& nsstring ); + std::string toString( NSObject* const& nsObject ); +#endif + +namespace Detail { + + extern const std::string unprintableString; + + struct BorgType { + template BorgType( T const& ); + }; + + struct TrueType { char sizer[1]; }; + struct FalseType { char sizer[2]; }; + + TrueType& testStreamable( std::ostream& ); + FalseType testStreamable( FalseType ); + + FalseType operator<<( std::ostream const&, BorgType const& ); + + template + struct IsStreamInsertable { + static std::ostream &s; + static T const&t; + enum { value = sizeof( testStreamable(s << t) ) == sizeof( TrueType ) }; + }; + +#if defined(CATCH_CONFIG_CPP11_IS_ENUM) + template::value + > + struct EnumStringMaker + { + static std::string convert( T const& ) { return unprintableString; } + }; + + template + struct EnumStringMaker + { + static std::string convert( T const& v ) + { + return ::Catch::toString( + static_cast::type>(v) + ); + } + }; +#endif + template + struct StringMakerBase { +#if defined(CATCH_CONFIG_CPP11_IS_ENUM) + template + static std::string convert( T const& v ) + { + return EnumStringMaker::convert( v ); + } +#else + template + static std::string convert( T const& ) { return unprintableString; } +#endif + }; + + template<> + struct StringMakerBase { + template + static std::string convert( T const& _value ) { + std::ostringstream oss; + oss << _value; + return oss.str(); + } + }; + + std::string rawMemoryToString( const void *object, std::size_t size ); + + template + inline std::string rawMemoryToString( const T& object ) { + return rawMemoryToString( &object, sizeof(object) ); + } + +} // end namespace Detail + +template +struct StringMaker : + Detail::StringMakerBase::value> {}; + +template +struct StringMaker { + template + static std::string convert( U* p ) { + if( !p ) + return "NULL"; + else + return Detail::rawMemoryToString( p ); + } +}; + +template +struct StringMaker { + static std::string convert( R C::* p ) { + if( !p ) + return "NULL"; + else + return Detail::rawMemoryToString( p ); + } +}; + +namespace Detail { + template + std::string rangeToString( InputIterator first, InputIterator last ); +} + +//template +//struct StringMaker > { +// static std::string convert( std::vector const& v ) { +// return Detail::rangeToString( v.begin(), v.end() ); +// } +//}; + +template +std::string toString( std::vector const& v ) { + return Detail::rangeToString( v.begin(), v.end() ); +} + +#ifdef CATCH_CONFIG_CPP11_TUPLE + +// toString for tuples +namespace TupleDetail { + template< + typename Tuple, + std::size_t N = 0, + bool = (N < std::tuple_size::value) + > + struct ElementPrinter { + static void print( const Tuple& tuple, std::ostream& os ) + { + os << ( N ? ", " : " " ) + << Catch::toString(std::get(tuple)); + ElementPrinter::print(tuple,os); + } + }; + + template< + typename Tuple, + std::size_t N + > + struct ElementPrinter { + static void print( const Tuple&, std::ostream& ) {} + }; + +} + +template +struct StringMaker> { + + static std::string convert( const std::tuple& tuple ) + { + std::ostringstream os; + os << '{'; + TupleDetail::ElementPrinter>::print( tuple, os ); + os << " }"; + return os.str(); + } +}; +#endif // CATCH_CONFIG_CPP11_TUPLE + +namespace Detail { + template + std::string makeString( T const& value ) { + return StringMaker::convert( value ); + } +} // end namespace Detail + +/// \brief converts any type to a string +/// +/// The default template forwards on to ostringstream - except when an +/// ostringstream overload does not exist - in which case it attempts to detect +/// that and writes {?}. +/// Overload (not specialise) this template for custom typs that you don't want +/// to provide an ostream overload for. +template +std::string toString( T const& value ) { + return StringMaker::convert( value ); +} + + namespace Detail { + template + std::string rangeToString( InputIterator first, InputIterator last ) { + std::ostringstream oss; + oss << "{ "; + if( first != last ) { + oss << Catch::toString( *first ); + for( ++first ; first != last ; ++first ) + oss << ", " << Catch::toString( *first ); + } + oss << " }"; + return oss.str(); + } +} + +} // end namespace Catch + +namespace Catch { + +// Wraps the LHS of an expression and captures the operator and RHS (if any) - +// wrapping them all in a ResultBuilder object +template +class ExpressionLhs { + ExpressionLhs& operator = ( ExpressionLhs const& ); +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + ExpressionLhs& operator = ( ExpressionLhs && ) = delete; +# endif + +public: + ExpressionLhs( ResultBuilder& rb, T lhs ) : m_rb( rb ), m_lhs( lhs ) {} +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + ExpressionLhs( ExpressionLhs const& ) = default; + ExpressionLhs( ExpressionLhs && ) = default; +# endif + + template + ResultBuilder& operator == ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + template + ResultBuilder& operator != ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + template + ResultBuilder& operator < ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + template + ResultBuilder& operator > ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + template + ResultBuilder& operator <= ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + template + ResultBuilder& operator >= ( RhsT const& rhs ) { + return captureExpression( rhs ); + } + + ResultBuilder& operator == ( bool rhs ) { + return captureExpression( rhs ); + } + + ResultBuilder& operator != ( bool rhs ) { + return captureExpression( rhs ); + } + + void endExpression() { + bool value = m_lhs ? true : false; + m_rb + .setLhs( Catch::toString( value ) ) + .setResultType( value ) + .endExpression(); + } + + // Only simple binary expressions are allowed on the LHS. + // If more complex compositions are required then place the sub expression in parentheses + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator + ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator - ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator / ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator * ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator && ( RhsT const& ); + template STATIC_ASSERT_Expression_Too_Complex_Please_Rewrite_As_Binary_Comparison& operator || ( RhsT const& ); + +private: + template + ResultBuilder& captureExpression( RhsT const& rhs ) { + return m_rb + .setResultType( Internal::compare( m_lhs, rhs ) ) + .setLhs( Catch::toString( m_lhs ) ) + .setRhs( Catch::toString( rhs ) ) + .setOp( Internal::OperatorTraits::getName() ); + } + +private: + ResultBuilder& m_rb; + T m_lhs; +}; + +} // end namespace Catch + + +namespace Catch { + + template + inline ExpressionLhs ResultBuilder::operator <= ( T const& operand ) { + return ExpressionLhs( *this, operand ); + } + + inline ExpressionLhs ResultBuilder::operator <= ( bool value ) { + return ExpressionLhs( *this, value ); + } + +} // namespace Catch + +// #included from: catch_message.h +#define TWOBLUECUBES_CATCH_MESSAGE_H_INCLUDED + +#include + +namespace Catch { + + struct MessageInfo { + MessageInfo( std::string const& _macroName, + SourceLineInfo const& _lineInfo, + ResultWas::OfType _type ); + + std::string macroName; + SourceLineInfo lineInfo; + ResultWas::OfType type; + std::string message; + unsigned int sequence; + + bool operator == ( MessageInfo const& other ) const { + return sequence == other.sequence; + } + bool operator < ( MessageInfo const& other ) const { + return sequence < other.sequence; + } + private: + static unsigned int globalCount; + }; + + struct MessageBuilder { + MessageBuilder( std::string const& macroName, + SourceLineInfo const& lineInfo, + ResultWas::OfType type ) + : m_info( macroName, lineInfo, type ) + {} + + template + MessageBuilder& operator << ( T const& value ) { + m_stream << value; + return *this; + } + + MessageInfo m_info; + std::ostringstream m_stream; + }; + + class ScopedMessage { + public: + ScopedMessage( MessageBuilder const& builder ); + ScopedMessage( ScopedMessage const& other ); + ~ScopedMessage(); + + MessageInfo m_info; + }; + +} // end namespace Catch + +// #included from: catch_interfaces_capture.h +#define TWOBLUECUBES_CATCH_INTERFACES_CAPTURE_H_INCLUDED + +#include + +namespace Catch { + + class TestCase; + class AssertionResult; + struct AssertionInfo; + struct SectionInfo; + struct SectionEndInfo; + struct MessageInfo; + class ScopedMessageBuilder; + struct Counts; + + struct IResultCapture { + + virtual ~IResultCapture(); + + virtual void assertionEnded( AssertionResult const& result ) = 0; + virtual bool sectionStarted( SectionInfo const& sectionInfo, + Counts& assertions ) = 0; + virtual void sectionEnded( SectionEndInfo const& endInfo ) = 0; + virtual void sectionEndedEarly( SectionEndInfo const& endInfo ) = 0; + virtual void pushScopedMessage( MessageInfo const& message ) = 0; + virtual void popScopedMessage( MessageInfo const& message ) = 0; + + virtual std::string getCurrentTestName() const = 0; + virtual const AssertionResult* getLastResult() const = 0; + + virtual void handleFatalErrorCondition( std::string const& message ) = 0; + }; + + IResultCapture& getResultCapture(); +} + +// #included from: catch_debugger.h +#define TWOBLUECUBES_CATCH_DEBUGGER_H_INCLUDED + +// #included from: catch_platform.h +#define TWOBLUECUBES_CATCH_PLATFORM_H_INCLUDED + +#if defined(__MAC_OS_X_VERSION_MIN_REQUIRED) +#define CATCH_PLATFORM_MAC +#elif defined(__IPHONE_OS_VERSION_MIN_REQUIRED) +#define CATCH_PLATFORM_IPHONE +#elif defined(WIN32) || defined(__WIN32__) || defined(_WIN32) || defined(_MSC_VER) +#define CATCH_PLATFORM_WINDOWS +#endif + +#include + +namespace Catch{ + + bool isDebuggerActive(); + void writeToDebugConsole( std::string const& text ); +} + +#ifdef CATCH_PLATFORM_MAC + + // The following code snippet based on: + // http://cocoawithlove.com/2008/03/break-into-debugger.html + #ifdef DEBUG + #if defined(__ppc64__) || defined(__ppc__) + #define CATCH_BREAK_INTO_DEBUGGER() \ + if( Catch::isDebuggerActive() ) { \ + __asm__("li r0, 20\nsc\nnop\nli r0, 37\nli r4, 2\nsc\nnop\n" \ + : : : "memory","r0","r3","r4" ); \ + } + #else + #define CATCH_BREAK_INTO_DEBUGGER() if( Catch::isDebuggerActive() ) {__asm__("int $3\n" : : );} + #endif + #endif + +#elif defined(_MSC_VER) + #define CATCH_BREAK_INTO_DEBUGGER() if( Catch::isDebuggerActive() ) { __debugbreak(); } +#elif defined(__MINGW32__) + extern "C" __declspec(dllimport) void __stdcall DebugBreak(); + #define CATCH_BREAK_INTO_DEBUGGER() if( Catch::isDebuggerActive() ) { DebugBreak(); } +#endif + +#ifndef CATCH_BREAK_INTO_DEBUGGER +#define CATCH_BREAK_INTO_DEBUGGER() Catch::alwaysTrue(); +#endif + +// #included from: catch_interfaces_runner.h +#define TWOBLUECUBES_CATCH_INTERFACES_RUNNER_H_INCLUDED + +namespace Catch { + class TestCase; + + struct IRunner { + virtual ~IRunner(); + virtual bool aborting() const = 0; + }; +} + +/////////////////////////////////////////////////////////////////////////////// +// In the event of a failure works out if the debugger needs to be invoked +// and/or an exception thrown and takes appropriate action. +// This needs to be done as a macro so the debugger will stop in the user +// source code rather than in Catch library code +#define INTERNAL_CATCH_REACT( resultBuilder ) \ + if( resultBuilder.shouldDebugBreak() ) CATCH_BREAK_INTO_DEBUGGER(); \ + resultBuilder.react(); + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_TEST( expr, resultDisposition, macroName ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, #expr, resultDisposition ); \ + try { \ + CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS \ + ( __catchResult <= expr ).endExpression(); \ + } \ + catch( ... ) { \ + __catchResult.useActiveException( Catch::ResultDisposition::Normal ); \ + } \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::isTrue( false && !!(expr) ) ) // expr here is never evaluated at runtime but it forces the compiler to give it a look + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_IF( expr, resultDisposition, macroName ) \ + INTERNAL_CATCH_TEST( expr, resultDisposition, macroName ); \ + if( Catch::getResultCapture().getLastResult()->succeeded() ) + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_ELSE( expr, resultDisposition, macroName ) \ + INTERNAL_CATCH_TEST( expr, resultDisposition, macroName ); \ + if( !Catch::getResultCapture().getLastResult()->succeeded() ) + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_NO_THROW( expr, resultDisposition, macroName ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, #expr, resultDisposition ); \ + try { \ + expr; \ + __catchResult.captureResult( Catch::ResultWas::Ok ); \ + } \ + catch( ... ) { \ + __catchResult.useActiveException( resultDisposition ); \ + } \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_THROWS( expr, resultDisposition, matcher, macroName ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, #expr, resultDisposition, #matcher ); \ + if( __catchResult.allowThrows() ) \ + try { \ + expr; \ + __catchResult.captureResult( Catch::ResultWas::DidntThrowException ); \ + } \ + catch( ... ) { \ + __catchResult.captureExpectedException( matcher ); \ + } \ + else \ + __catchResult.captureResult( Catch::ResultWas::Ok ); \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_THROWS_AS( expr, exceptionType, resultDisposition, macroName ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, #expr, resultDisposition ); \ + if( __catchResult.allowThrows() ) \ + try { \ + expr; \ + __catchResult.captureResult( Catch::ResultWas::DidntThrowException ); \ + } \ + catch( exceptionType ) { \ + __catchResult.captureResult( Catch::ResultWas::Ok ); \ + } \ + catch( ... ) { \ + __catchResult.useActiveException( resultDisposition ); \ + } \ + else \ + __catchResult.captureResult( Catch::ResultWas::Ok ); \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) + +/////////////////////////////////////////////////////////////////////////////// +#ifdef CATCH_CONFIG_VARIADIC_MACROS + #define INTERNAL_CATCH_MSG( messageType, resultDisposition, macroName, ... ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, "", resultDisposition ); \ + __catchResult << __VA_ARGS__ + ::Catch::StreamEndStop(); \ + __catchResult.captureResult( messageType ); \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) +#else + #define INTERNAL_CATCH_MSG( messageType, resultDisposition, macroName, log ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, "", resultDisposition ); \ + __catchResult << log + ::Catch::StreamEndStop(); \ + __catchResult.captureResult( messageType ); \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) +#endif + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_INFO( log, macroName ) \ + Catch::ScopedMessage INTERNAL_CATCH_UNIQUE_NAME( scopedMessage ) = Catch::MessageBuilder( macroName, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log; + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CHECK_THAT( arg, matcher, resultDisposition, macroName ) \ + do { \ + Catch::ResultBuilder __catchResult( macroName, CATCH_INTERNAL_LINEINFO, #arg ", " #matcher, resultDisposition ); \ + try { \ + std::string matcherAsString = (matcher).toString(); \ + __catchResult \ + .setLhs( Catch::toString( arg ) ) \ + .setRhs( matcherAsString == Catch::Detail::unprintableString ? #matcher : matcherAsString ) \ + .setOp( "matches" ) \ + .setResultType( (matcher).match( arg ) ); \ + __catchResult.captureExpression(); \ + } catch( ... ) { \ + __catchResult.useActiveException( resultDisposition | Catch::ResultDisposition::ContinueOnFailure ); \ + } \ + INTERNAL_CATCH_REACT( __catchResult ) \ + } while( Catch::alwaysFalse() ) + +// #included from: internal/catch_section.h +#define TWOBLUECUBES_CATCH_SECTION_H_INCLUDED + +// #included from: catch_section_info.h +#define TWOBLUECUBES_CATCH_SECTION_INFO_H_INCLUDED + +// #included from: catch_totals.hpp +#define TWOBLUECUBES_CATCH_TOTALS_HPP_INCLUDED + +#include + +namespace Catch { + + struct Counts { + Counts() : passed( 0 ), failed( 0 ), failedButOk( 0 ) {} + + Counts operator - ( Counts const& other ) const { + Counts diff; + diff.passed = passed - other.passed; + diff.failed = failed - other.failed; + diff.failedButOk = failedButOk - other.failedButOk; + return diff; + } + Counts& operator += ( Counts const& other ) { + passed += other.passed; + failed += other.failed; + failedButOk += other.failedButOk; + return *this; + } + + std::size_t total() const { + return passed + failed + failedButOk; + } + bool allPassed() const { + return failed == 0 && failedButOk == 0; + } + bool allOk() const { + return failed == 0; + } + + std::size_t passed; + std::size_t failed; + std::size_t failedButOk; + }; + + struct Totals { + + Totals operator - ( Totals const& other ) const { + Totals diff; + diff.assertions = assertions - other.assertions; + diff.testCases = testCases - other.testCases; + return diff; + } + + Totals delta( Totals const& prevTotals ) const { + Totals diff = *this - prevTotals; + if( diff.assertions.failed > 0 ) + ++diff.testCases.failed; + else if( diff.assertions.failedButOk > 0 ) + ++diff.testCases.failedButOk; + else + ++diff.testCases.passed; + return diff; + } + + Totals& operator += ( Totals const& other ) { + assertions += other.assertions; + testCases += other.testCases; + return *this; + } + + Counts assertions; + Counts testCases; + }; +} + +namespace Catch { + + struct SectionInfo { + SectionInfo + ( SourceLineInfo const& _lineInfo, + std::string const& _name, + std::string const& _description = std::string() ); + + std::string name; + std::string description; + SourceLineInfo lineInfo; + }; + + struct SectionEndInfo { + SectionEndInfo( SectionInfo const& _sectionInfo, Counts const& _prevAssertions, double _durationInSeconds ) + : sectionInfo( _sectionInfo ), prevAssertions( _prevAssertions ), durationInSeconds( _durationInSeconds ) + {} + + SectionInfo sectionInfo; + Counts prevAssertions; + double durationInSeconds; + }; + +} // end namespace Catch + +// #included from: catch_timer.h +#define TWOBLUECUBES_CATCH_TIMER_H_INCLUDED + +#ifdef CATCH_PLATFORM_WINDOWS +typedef unsigned long long uint64_t; +#else +#include +#endif + +namespace Catch { + + class Timer { + public: + Timer() : m_ticks( 0 ) {} + void start(); + unsigned int getElapsedMicroseconds() const; + unsigned int getElapsedMilliseconds() const; + double getElapsedSeconds() const; + + private: + uint64_t m_ticks; + }; + +} // namespace Catch + +#include + +namespace Catch { + + class Section : NonCopyable { + public: + Section( SectionInfo const& info ); + ~Section(); + + // This indicates whether the section should be executed or not + operator bool() const; + + private: + SectionInfo m_info; + + std::string m_name; + Counts m_assertions; + bool m_sectionIncluded; + Timer m_timer; + }; + +} // end namespace Catch + +#ifdef CATCH_CONFIG_VARIADIC_MACROS + #define INTERNAL_CATCH_SECTION( ... ) \ + if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, __VA_ARGS__ ) ) +#else + #define INTERNAL_CATCH_SECTION( name, desc ) \ + if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, name, desc ) ) +#endif + +// #included from: internal/catch_generators.hpp +#define TWOBLUECUBES_CATCH_GENERATORS_HPP_INCLUDED + +#include +#include +#include +#include + +namespace Catch { + +template +struct IGenerator { + virtual ~IGenerator() {} + virtual T getValue( std::size_t index ) const = 0; + virtual std::size_t size () const = 0; +}; + +template +class BetweenGenerator : public IGenerator { +public: + BetweenGenerator( T from, T to ) : m_from( from ), m_to( to ){} + + virtual T getValue( std::size_t index ) const { + return m_from+static_cast( index ); + } + + virtual std::size_t size() const { + return static_cast( 1+m_to-m_from ); + } + +private: + + T m_from; + T m_to; +}; + +template +class ValuesGenerator : public IGenerator { +public: + ValuesGenerator(){} + + void add( T value ) { + m_values.push_back( value ); + } + + virtual T getValue( std::size_t index ) const { + return m_values[index]; + } + + virtual std::size_t size() const { + return m_values.size(); + } + +private: + std::vector m_values; +}; + +template +class CompositeGenerator { +public: + CompositeGenerator() : m_totalSize( 0 ) {} + + // *** Move semantics, similar to auto_ptr *** + CompositeGenerator( CompositeGenerator& other ) + : m_fileInfo( other.m_fileInfo ), + m_totalSize( 0 ) + { + move( other ); + } + + CompositeGenerator& setFileInfo( const char* fileInfo ) { + m_fileInfo = fileInfo; + return *this; + } + + ~CompositeGenerator() { + deleteAll( m_composed ); + } + + operator T () const { + size_t overallIndex = getCurrentContext().getGeneratorIndex( m_fileInfo, m_totalSize ); + + typename std::vector*>::const_iterator it = m_composed.begin(); + typename std::vector*>::const_iterator itEnd = m_composed.end(); + for( size_t index = 0; it != itEnd; ++it ) + { + const IGenerator* generator = *it; + if( overallIndex >= index && overallIndex < index + generator->size() ) + { + return generator->getValue( overallIndex-index ); + } + index += generator->size(); + } + CATCH_INTERNAL_ERROR( "Indexed past end of generated range" ); + return T(); // Suppress spurious "not all control paths return a value" warning in Visual Studio - if you know how to fix this please do so + } + + void add( const IGenerator* generator ) { + m_totalSize += generator->size(); + m_composed.push_back( generator ); + } + + CompositeGenerator& then( CompositeGenerator& other ) { + move( other ); + return *this; + } + + CompositeGenerator& then( T value ) { + ValuesGenerator* valuesGen = new ValuesGenerator(); + valuesGen->add( value ); + add( valuesGen ); + return *this; + } + +private: + + void move( CompositeGenerator& other ) { + std::copy( other.m_composed.begin(), other.m_composed.end(), std::back_inserter( m_composed ) ); + m_totalSize += other.m_totalSize; + other.m_composed.clear(); + } + + std::vector*> m_composed; + std::string m_fileInfo; + size_t m_totalSize; +}; + +namespace Generators +{ + template + CompositeGenerator between( T from, T to ) { + CompositeGenerator generators; + generators.add( new BetweenGenerator( from, to ) ); + return generators; + } + + template + CompositeGenerator values( T val1, T val2 ) { + CompositeGenerator generators; + ValuesGenerator* valuesGen = new ValuesGenerator(); + valuesGen->add( val1 ); + valuesGen->add( val2 ); + generators.add( valuesGen ); + return generators; + } + + template + CompositeGenerator values( T val1, T val2, T val3 ){ + CompositeGenerator generators; + ValuesGenerator* valuesGen = new ValuesGenerator(); + valuesGen->add( val1 ); + valuesGen->add( val2 ); + valuesGen->add( val3 ); + generators.add( valuesGen ); + return generators; + } + + template + CompositeGenerator values( T val1, T val2, T val3, T val4 ) { + CompositeGenerator generators; + ValuesGenerator* valuesGen = new ValuesGenerator(); + valuesGen->add( val1 ); + valuesGen->add( val2 ); + valuesGen->add( val3 ); + valuesGen->add( val4 ); + generators.add( valuesGen ); + return generators; + } + +} // end namespace Generators + +using namespace Generators; + +} // end namespace Catch + +#define INTERNAL_CATCH_LINESTR2( line ) #line +#define INTERNAL_CATCH_LINESTR( line ) INTERNAL_CATCH_LINESTR2( line ) + +#define INTERNAL_CATCH_GENERATE( expr ) expr.setFileInfo( __FILE__ "(" INTERNAL_CATCH_LINESTR( __LINE__ ) ")" ) + +// #included from: internal/catch_interfaces_exception.h +#define TWOBLUECUBES_CATCH_INTERFACES_EXCEPTION_H_INCLUDED + +#include +#include + +// #included from: catch_interfaces_registry_hub.h +#define TWOBLUECUBES_CATCH_INTERFACES_REGISTRY_HUB_H_INCLUDED + +#include + +namespace Catch { + + class TestCase; + struct ITestCaseRegistry; + struct IExceptionTranslatorRegistry; + struct IExceptionTranslator; + struct IReporterRegistry; + struct IReporterFactory; + + struct IRegistryHub { + virtual ~IRegistryHub(); + + virtual IReporterRegistry const& getReporterRegistry() const = 0; + virtual ITestCaseRegistry const& getTestCaseRegistry() const = 0; + virtual IExceptionTranslatorRegistry& getExceptionTranslatorRegistry() = 0; + }; + + struct IMutableRegistryHub { + virtual ~IMutableRegistryHub(); + virtual void registerReporter( std::string const& name, Ptr const& factory ) = 0; + virtual void registerListener( Ptr const& factory ) = 0; + virtual void registerTest( TestCase const& testInfo ) = 0; + virtual void registerTranslator( const IExceptionTranslator* translator ) = 0; + }; + + IRegistryHub& getRegistryHub(); + IMutableRegistryHub& getMutableRegistryHub(); + void cleanUp(); + std::string translateActiveException(); + +} + +namespace Catch { + + typedef std::string(*exceptionTranslateFunction)(); + + struct IExceptionTranslator; + typedef std::vector ExceptionTranslators; + + struct IExceptionTranslator { + virtual ~IExceptionTranslator(); + virtual std::string translate( ExceptionTranslators::const_iterator it, ExceptionTranslators::const_iterator itEnd ) const = 0; + }; + + struct IExceptionTranslatorRegistry { + virtual ~IExceptionTranslatorRegistry(); + + virtual std::string translateActiveException() const = 0; + }; + + class ExceptionTranslatorRegistrar { + template + class ExceptionTranslator : public IExceptionTranslator { + public: + + ExceptionTranslator( std::string(*translateFunction)( T& ) ) + : m_translateFunction( translateFunction ) + {} + + virtual std::string translate( ExceptionTranslators::const_iterator it, ExceptionTranslators::const_iterator itEnd ) const CATCH_OVERRIDE { + try { + if( it == itEnd ) + throw; + else + return (*it)->translate( it+1, itEnd ); + } + catch( T& ex ) { + return m_translateFunction( ex ); + } + } + + protected: + std::string(*m_translateFunction)( T& ); + }; + + public: + template + ExceptionTranslatorRegistrar( std::string(*translateFunction)( T& ) ) { + getMutableRegistryHub().registerTranslator + ( new ExceptionTranslator( translateFunction ) ); + } + }; +} + +/////////////////////////////////////////////////////////////////////////////// +#define INTERNAL_CATCH_TRANSLATE_EXCEPTION2( translatorName, signature ) \ + static std::string translatorName( signature ); \ + namespace{ Catch::ExceptionTranslatorRegistrar INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionRegistrar )( &translatorName ); }\ + static std::string translatorName( signature ) + +#define INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature ) INTERNAL_CATCH_TRANSLATE_EXCEPTION2( INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionTranslator ), signature ) + +// #included from: internal/catch_approx.hpp +#define TWOBLUECUBES_CATCH_APPROX_HPP_INCLUDED + +#include +#include + +namespace Catch { +namespace Detail { + + class Approx { + public: + explicit Approx ( double value ) + : m_epsilon( std::numeric_limits::epsilon()*100 ), + m_scale( 1.0 ), + m_value( value ) + {} + + Approx( Approx const& other ) + : m_epsilon( other.m_epsilon ), + m_scale( other.m_scale ), + m_value( other.m_value ) + {} + + static Approx custom() { + return Approx( 0 ); + } + + Approx operator()( double value ) { + Approx approx( value ); + approx.epsilon( m_epsilon ); + approx.scale( m_scale ); + return approx; + } + + friend bool operator == ( double lhs, Approx const& rhs ) { + // Thanks to Richard Harris for his help refining this formula + return fabs( lhs - rhs.m_value ) < rhs.m_epsilon * (rhs.m_scale + (std::max)( fabs(lhs), fabs(rhs.m_value) ) ); + } + + friend bool operator == ( Approx const& lhs, double rhs ) { + return operator==( rhs, lhs ); + } + + friend bool operator != ( double lhs, Approx const& rhs ) { + return !operator==( lhs, rhs ); + } + + friend bool operator != ( Approx const& lhs, double rhs ) { + return !operator==( rhs, lhs ); + } + + Approx& epsilon( double newEpsilon ) { + m_epsilon = newEpsilon; + return *this; + } + + Approx& scale( double newScale ) { + m_scale = newScale; + return *this; + } + + std::string toString() const { + std::ostringstream oss; + oss << "Approx( " << Catch::toString( m_value ) << " )"; + return oss.str(); + } + + private: + double m_epsilon; + double m_scale; + double m_value; + }; +} + +template<> +inline std::string toString( Detail::Approx const& value ) { + return value.toString(); +} + +} // end namespace Catch + +// #included from: internal/catch_interfaces_tag_alias_registry.h +#define TWOBLUECUBES_CATCH_INTERFACES_TAG_ALIAS_REGISTRY_H_INCLUDED + +// #included from: catch_tag_alias.h +#define TWOBLUECUBES_CATCH_TAG_ALIAS_H_INCLUDED + +#include + +namespace Catch { + + struct TagAlias { + TagAlias( std::string _tag, SourceLineInfo _lineInfo ) : tag( _tag ), lineInfo( _lineInfo ) {} + + std::string tag; + SourceLineInfo lineInfo; + }; + + struct RegistrarForTagAliases { + RegistrarForTagAliases( char const* alias, char const* tag, SourceLineInfo const& lineInfo ); + }; + +} // end namespace Catch + +#define CATCH_REGISTER_TAG_ALIAS( alias, spec ) namespace{ Catch::RegistrarForTagAliases INTERNAL_CATCH_UNIQUE_NAME( AutoRegisterTagAlias )( alias, spec, CATCH_INTERNAL_LINEINFO ); } +// #included from: catch_option.hpp +#define TWOBLUECUBES_CATCH_OPTION_HPP_INCLUDED + +namespace Catch { + + // An optional type + template + class Option { + public: + Option() : nullableValue( CATCH_NULL ) {} + Option( T const& _value ) + : nullableValue( new( storage ) T( _value ) ) + {} + Option( Option const& _other ) + : nullableValue( _other ? new( storage ) T( *_other ) : CATCH_NULL ) + {} + + ~Option() { + reset(); + } + + Option& operator= ( Option const& _other ) { + if( &_other != this ) { + reset(); + if( _other ) + nullableValue = new( storage ) T( *_other ); + } + return *this; + } + Option& operator = ( T const& _value ) { + reset(); + nullableValue = new( storage ) T( _value ); + return *this; + } + + void reset() { + if( nullableValue ) + nullableValue->~T(); + nullableValue = CATCH_NULL; + } + + T& operator*() { return *nullableValue; } + T const& operator*() const { return *nullableValue; } + T* operator->() { return nullableValue; } + const T* operator->() const { return nullableValue; } + + T valueOr( T const& defaultValue ) const { + return nullableValue ? *nullableValue : defaultValue; + } + + bool some() const { return nullableValue != CATCH_NULL; } + bool none() const { return nullableValue == CATCH_NULL; } + + bool operator !() const { return nullableValue == CATCH_NULL; } + operator SafeBool::type() const { + return SafeBool::makeSafe( some() ); + } + + private: + T* nullableValue; + char storage[sizeof(T)]; + }; + +} // end namespace Catch + +namespace Catch { + + struct ITagAliasRegistry { + virtual ~ITagAliasRegistry(); + virtual Option find( std::string const& alias ) const = 0; + virtual std::string expandAliases( std::string const& unexpandedTestSpec ) const = 0; + + static ITagAliasRegistry const& get(); + }; + +} // end namespace Catch + +// These files are included here so the single_include script doesn't put them +// in the conditionally compiled sections +// #included from: internal/catch_test_case_info.h +#define TWOBLUECUBES_CATCH_TEST_CASE_INFO_H_INCLUDED + +#include +#include + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wpadded" +#endif + +namespace Catch { + + struct ITestCase; + + struct TestCaseInfo { + enum SpecialProperties{ + None = 0, + IsHidden = 1 << 1, + ShouldFail = 1 << 2, + MayFail = 1 << 3, + Throws = 1 << 4 + }; + + TestCaseInfo( std::string const& _name, + std::string const& _className, + std::string const& _description, + std::set const& _tags, + SourceLineInfo const& _lineInfo ); + + TestCaseInfo( TestCaseInfo const& other ); + + friend void setTags( TestCaseInfo& testCaseInfo, std::set const& tags ); + + bool isHidden() const; + bool throws() const; + bool okToFail() const; + bool expectedToFail() const; + + std::string name; + std::string className; + std::string description; + std::set tags; + std::set lcaseTags; + std::string tagsAsString; + SourceLineInfo lineInfo; + SpecialProperties properties; + }; + + class TestCase : public TestCaseInfo { + public: + + TestCase( ITestCase* testCase, TestCaseInfo const& info ); + TestCase( TestCase const& other ); + + TestCase withName( std::string const& _newName ) const; + + void invoke() const; + + TestCaseInfo const& getTestCaseInfo() const; + + void swap( TestCase& other ); + bool operator == ( TestCase const& other ) const; + bool operator < ( TestCase const& other ) const; + TestCase& operator = ( TestCase const& other ); + + private: + Ptr test; + }; + + TestCase makeTestCase( ITestCase* testCase, + std::string const& className, + std::string const& name, + std::string const& description, + SourceLineInfo const& lineInfo ); +} + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + + +#ifdef __OBJC__ +// #included from: internal/catch_objc.hpp +#define TWOBLUECUBES_CATCH_OBJC_HPP_INCLUDED + +#import + +#include + +// NB. Any general catch headers included here must be included +// in catch.hpp first to make sure they are included by the single +// header for non obj-usage + +/////////////////////////////////////////////////////////////////////////////// +// This protocol is really only here for (self) documenting purposes, since +// all its methods are optional. +@protocol OcFixture + +@optional + +-(void) setUp; +-(void) tearDown; + +@end + +namespace Catch { + + class OcMethod : public SharedImpl { + + public: + OcMethod( Class cls, SEL sel ) : m_cls( cls ), m_sel( sel ) {} + + virtual void invoke() const { + id obj = [[m_cls alloc] init]; + + performOptionalSelector( obj, @selector(setUp) ); + performOptionalSelector( obj, m_sel ); + performOptionalSelector( obj, @selector(tearDown) ); + + arcSafeRelease( obj ); + } + private: + virtual ~OcMethod() {} + + Class m_cls; + SEL m_sel; + }; + + namespace Detail{ + + inline std::string getAnnotation( Class cls, + std::string const& annotationName, + std::string const& testCaseName ) { + NSString* selStr = [[NSString alloc] initWithFormat:@"Catch_%s_%s", annotationName.c_str(), testCaseName.c_str()]; + SEL sel = NSSelectorFromString( selStr ); + arcSafeRelease( selStr ); + id value = performOptionalSelector( cls, sel ); + if( value ) + return [(NSString*)value UTF8String]; + return ""; + } + } + + inline size_t registerTestMethods() { + size_t noTestMethods = 0; + int noClasses = objc_getClassList( CATCH_NULL, 0 ); + + Class* classes = (CATCH_UNSAFE_UNRETAINED Class *)malloc( sizeof(Class) * noClasses); + objc_getClassList( classes, noClasses ); + + for( int c = 0; c < noClasses; c++ ) { + Class cls = classes[c]; + { + u_int count; + Method* methods = class_copyMethodList( cls, &count ); + for( u_int m = 0; m < count ; m++ ) { + SEL selector = method_getName(methods[m]); + std::string methodName = sel_getName(selector); + if( startsWith( methodName, "Catch_TestCase_" ) ) { + std::string testCaseName = methodName.substr( 15 ); + std::string name = Detail::getAnnotation( cls, "Name", testCaseName ); + std::string desc = Detail::getAnnotation( cls, "Description", testCaseName ); + const char* className = class_getName( cls ); + + getMutableRegistryHub().registerTest( makeTestCase( new OcMethod( cls, selector ), className, name.c_str(), desc.c_str(), SourceLineInfo() ) ); + noTestMethods++; + } + } + free(methods); + } + } + return noTestMethods; + } + + namespace Matchers { + namespace Impl { + namespace NSStringMatchers { + + template + struct StringHolder : MatcherImpl{ + StringHolder( NSString* substr ) : m_substr( [substr copy] ){} + StringHolder( StringHolder const& other ) : m_substr( [other.m_substr copy] ){} + StringHolder() { + arcSafeRelease( m_substr ); + } + + NSString* m_substr; + }; + + struct Equals : StringHolder { + Equals( NSString* substr ) : StringHolder( substr ){} + + virtual bool match( ExpressionType const& str ) const { + return (str != nil || m_substr == nil ) && + [str isEqualToString:m_substr]; + } + + virtual std::string toString() const { + return "equals string: " + Catch::toString( m_substr ); + } + }; + + struct Contains : StringHolder { + Contains( NSString* substr ) : StringHolder( substr ){} + + virtual bool match( ExpressionType const& str ) const { + return (str != nil || m_substr == nil ) && + [str rangeOfString:m_substr].location != NSNotFound; + } + + virtual std::string toString() const { + return "contains string: " + Catch::toString( m_substr ); + } + }; + + struct StartsWith : StringHolder { + StartsWith( NSString* substr ) : StringHolder( substr ){} + + virtual bool match( ExpressionType const& str ) const { + return (str != nil || m_substr == nil ) && + [str rangeOfString:m_substr].location == 0; + } + + virtual std::string toString() const { + return "starts with: " + Catch::toString( m_substr ); + } + }; + struct EndsWith : StringHolder { + EndsWith( NSString* substr ) : StringHolder( substr ){} + + virtual bool match( ExpressionType const& str ) const { + return (str != nil || m_substr == nil ) && + [str rangeOfString:m_substr].location == [str length] - [m_substr length]; + } + + virtual std::string toString() const { + return "ends with: " + Catch::toString( m_substr ); + } + }; + + } // namespace NSStringMatchers + } // namespace Impl + + inline Impl::NSStringMatchers::Equals + Equals( NSString* substr ){ return Impl::NSStringMatchers::Equals( substr ); } + + inline Impl::NSStringMatchers::Contains + Contains( NSString* substr ){ return Impl::NSStringMatchers::Contains( substr ); } + + inline Impl::NSStringMatchers::StartsWith + StartsWith( NSString* substr ){ return Impl::NSStringMatchers::StartsWith( substr ); } + + inline Impl::NSStringMatchers::EndsWith + EndsWith( NSString* substr ){ return Impl::NSStringMatchers::EndsWith( substr ); } + + } // namespace Matchers + + using namespace Matchers; + +} // namespace Catch + +/////////////////////////////////////////////////////////////////////////////// +#define OC_TEST_CASE( name, desc )\ ++(NSString*) INTERNAL_CATCH_UNIQUE_NAME( Catch_Name_test ) \ +{\ +return @ name; \ +}\ ++(NSString*) INTERNAL_CATCH_UNIQUE_NAME( Catch_Description_test ) \ +{ \ +return @ desc; \ +} \ +-(void) INTERNAL_CATCH_UNIQUE_NAME( Catch_TestCase_test ) + +#endif + +#ifdef CATCH_IMPL +// #included from: internal/catch_impl.hpp +#define TWOBLUECUBES_CATCH_IMPL_HPP_INCLUDED + +// Collect all the implementation files together here +// These are the equivalent of what would usually be cpp files + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wweak-vtables" +#endif + +// #included from: ../catch_session.hpp +#define TWOBLUECUBES_CATCH_RUNNER_HPP_INCLUDED + +// #included from: internal/catch_commandline.hpp +#define TWOBLUECUBES_CATCH_COMMANDLINE_HPP_INCLUDED + +// #included from: catch_config.hpp +#define TWOBLUECUBES_CATCH_CONFIG_HPP_INCLUDED + +// #included from: catch_test_spec_parser.hpp +#define TWOBLUECUBES_CATCH_TEST_SPEC_PARSER_HPP_INCLUDED + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wpadded" +#endif + +// #included from: catch_test_spec.hpp +#define TWOBLUECUBES_CATCH_TEST_SPEC_HPP_INCLUDED + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wpadded" +#endif + +// #included from: catch_wildcard_pattern.hpp +#define TWOBLUECUBES_CATCH_WILDCARD_PATTERN_HPP_INCLUDED + +namespace Catch +{ + class WildcardPattern { + enum WildcardPosition { + NoWildcard = 0, + WildcardAtStart = 1, + WildcardAtEnd = 2, + WildcardAtBothEnds = WildcardAtStart | WildcardAtEnd + }; + + public: + + WildcardPattern( std::string const& pattern, CaseSensitive::Choice caseSensitivity ) + : m_caseSensitivity( caseSensitivity ), + m_wildcard( NoWildcard ), + m_pattern( adjustCase( pattern ) ) + { + if( startsWith( m_pattern, "*" ) ) { + m_pattern = m_pattern.substr( 1 ); + m_wildcard = WildcardAtStart; + } + if( endsWith( m_pattern, "*" ) ) { + m_pattern = m_pattern.substr( 0, m_pattern.size()-1 ); + m_wildcard = static_cast( m_wildcard | WildcardAtEnd ); + } + } + virtual ~WildcardPattern(); + virtual bool matches( std::string const& str ) const { + switch( m_wildcard ) { + case NoWildcard: + return m_pattern == adjustCase( str ); + case WildcardAtStart: + return endsWith( adjustCase( str ), m_pattern ); + case WildcardAtEnd: + return startsWith( adjustCase( str ), m_pattern ); + case WildcardAtBothEnds: + return contains( adjustCase( str ), m_pattern ); + } + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wunreachable-code" +#endif + throw std::logic_error( "Unknown enum" ); +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + } + private: + std::string adjustCase( std::string const& str ) const { + return m_caseSensitivity == CaseSensitive::No ? toLower( str ) : str; + } + CaseSensitive::Choice m_caseSensitivity; + WildcardPosition m_wildcard; + std::string m_pattern; + }; +} + +#include +#include + +namespace Catch { + + class TestSpec { + struct Pattern : SharedImpl<> { + virtual ~Pattern(); + virtual bool matches( TestCaseInfo const& testCase ) const = 0; + }; + class NamePattern : public Pattern { + public: + NamePattern( std::string const& name ) + : m_wildcardPattern( toLower( name ), CaseSensitive::No ) + {} + virtual ~NamePattern(); + virtual bool matches( TestCaseInfo const& testCase ) const { + return m_wildcardPattern.matches( toLower( testCase.name ) ); + } + private: + WildcardPattern m_wildcardPattern; + }; + + class TagPattern : public Pattern { + public: + TagPattern( std::string const& tag ) : m_tag( toLower( tag ) ) {} + virtual ~TagPattern(); + virtual bool matches( TestCaseInfo const& testCase ) const { + return testCase.lcaseTags.find( m_tag ) != testCase.lcaseTags.end(); + } + private: + std::string m_tag; + }; + + class ExcludedPattern : public Pattern { + public: + ExcludedPattern( Ptr const& underlyingPattern ) : m_underlyingPattern( underlyingPattern ) {} + virtual ~ExcludedPattern(); + virtual bool matches( TestCaseInfo const& testCase ) const { return !m_underlyingPattern->matches( testCase ); } + private: + Ptr m_underlyingPattern; + }; + + struct Filter { + std::vector > m_patterns; + + bool matches( TestCaseInfo const& testCase ) const { + // All patterns in a filter must match for the filter to be a match + for( std::vector >::const_iterator it = m_patterns.begin(), itEnd = m_patterns.end(); it != itEnd; ++it ) + if( !(*it)->matches( testCase ) ) + return false; + return true; + } + }; + + public: + bool hasFilters() const { + return !m_filters.empty(); + } + bool matches( TestCaseInfo const& testCase ) const { + // A TestSpec matches if any filter matches + for( std::vector::const_iterator it = m_filters.begin(), itEnd = m_filters.end(); it != itEnd; ++it ) + if( it->matches( testCase ) ) + return true; + return false; + } + + private: + std::vector m_filters; + + friend class TestSpecParser; + }; +} + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + +namespace Catch { + + class TestSpecParser { + enum Mode{ None, Name, QuotedName, Tag }; + Mode m_mode; + bool m_exclusion; + std::size_t m_start, m_pos; + std::string m_arg; + TestSpec::Filter m_currentFilter; + TestSpec m_testSpec; + ITagAliasRegistry const* m_tagAliases; + + public: + TestSpecParser( ITagAliasRegistry const& tagAliases ) : m_tagAliases( &tagAliases ) {} + + TestSpecParser& parse( std::string const& arg ) { + m_mode = None; + m_exclusion = false; + m_start = std::string::npos; + m_arg = m_tagAliases->expandAliases( arg ); + for( m_pos = 0; m_pos < m_arg.size(); ++m_pos ) + visitChar( m_arg[m_pos] ); + if( m_mode == Name ) + addPattern(); + return *this; + } + TestSpec testSpec() { + addFilter(); + return m_testSpec; + } + private: + void visitChar( char c ) { + if( m_mode == None ) { + switch( c ) { + case ' ': return; + case '~': m_exclusion = true; return; + case '[': return startNewMode( Tag, ++m_pos ); + case '"': return startNewMode( QuotedName, ++m_pos ); + default: startNewMode( Name, m_pos ); break; + } + } + if( m_mode == Name ) { + if( c == ',' ) { + addPattern(); + addFilter(); + } + else if( c == '[' ) { + if( subString() == "exclude:" ) + m_exclusion = true; + else + addPattern(); + startNewMode( Tag, ++m_pos ); + } + } + else if( m_mode == QuotedName && c == '"' ) + addPattern(); + else if( m_mode == Tag && c == ']' ) + addPattern(); + } + void startNewMode( Mode mode, std::size_t start ) { + m_mode = mode; + m_start = start; + } + std::string subString() const { return m_arg.substr( m_start, m_pos - m_start ); } + template + void addPattern() { + std::string token = subString(); + if( startsWith( token, "exclude:" ) ) { + m_exclusion = true; + token = token.substr( 8 ); + } + if( !token.empty() ) { + Ptr pattern = new T( token ); + if( m_exclusion ) + pattern = new TestSpec::ExcludedPattern( pattern ); + m_currentFilter.m_patterns.push_back( pattern ); + } + m_exclusion = false; + m_mode = None; + } + void addFilter() { + if( !m_currentFilter.m_patterns.empty() ) { + m_testSpec.m_filters.push_back( m_currentFilter ); + m_currentFilter = TestSpec::Filter(); + } + } + }; + inline TestSpec parseTestSpec( std::string const& arg ) { + return TestSpecParser( ITagAliasRegistry::get() ).parse( arg ).testSpec(); + } + +} // namespace Catch + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + +// #included from: catch_interfaces_config.h +#define TWOBLUECUBES_CATCH_INTERFACES_CONFIG_H_INCLUDED + +#include +#include +#include + +namespace Catch { + + struct Verbosity { enum Level { + NoOutput = 0, + Quiet, + Normal + }; }; + + struct WarnAbout { enum What { + Nothing = 0x00, + NoAssertions = 0x01 + }; }; + + struct ShowDurations { enum OrNot { + DefaultForReporter, + Always, + Never + }; }; + struct RunTests { enum InWhatOrder { + InDeclarationOrder, + InLexicographicalOrder, + InRandomOrder + }; }; + struct UseColour { enum YesOrNo { + Auto, + Yes, + No + }; }; + + class TestSpec; + + struct IConfig : IShared { + + virtual ~IConfig(); + + virtual bool allowThrows() const = 0; + virtual std::ostream& stream() const = 0; + virtual std::string name() const = 0; + virtual bool includeSuccessfulResults() const = 0; + virtual bool shouldDebugBreak() const = 0; + virtual bool warnAboutMissingAssertions() const = 0; + virtual int abortAfter() const = 0; + virtual bool showInvisibles() const = 0; + virtual ShowDurations::OrNot showDurations() const = 0; + virtual TestSpec const& testSpec() const = 0; + virtual RunTests::InWhatOrder runOrder() const = 0; + virtual unsigned int rngSeed() const = 0; + virtual UseColour::YesOrNo useColour() const = 0; + }; +} + +// #included from: catch_stream.h +#define TWOBLUECUBES_CATCH_STREAM_H_INCLUDED + +// #included from: catch_streambuf.h +#define TWOBLUECUBES_CATCH_STREAMBUF_H_INCLUDED + +#include + +namespace Catch { + + class StreamBufBase : public std::streambuf { + public: + virtual ~StreamBufBase() CATCH_NOEXCEPT; + }; +} + +#include +#include +#include + +namespace Catch { + + std::ostream& cout(); + std::ostream& cerr(); + + struct IStream { + virtual ~IStream() CATCH_NOEXCEPT; + virtual std::ostream& stream() const = 0; + }; + + class FileStream : public IStream { + mutable std::ofstream m_ofs; + public: + FileStream( std::string const& filename ); + virtual ~FileStream() CATCH_NOEXCEPT; + public: // IStream + virtual std::ostream& stream() const CATCH_OVERRIDE; + }; + + class CoutStream : public IStream { + mutable std::ostream m_os; + public: + CoutStream(); + virtual ~CoutStream() CATCH_NOEXCEPT; + + public: // IStream + virtual std::ostream& stream() const CATCH_OVERRIDE; + }; + + class DebugOutStream : public IStream { + CATCH_AUTO_PTR( StreamBufBase ) m_streamBuf; + mutable std::ostream m_os; + public: + DebugOutStream(); + virtual ~DebugOutStream() CATCH_NOEXCEPT; + + public: // IStream + virtual std::ostream& stream() const CATCH_OVERRIDE; + }; +} + +#include +#include +#include +#include +#include + +#ifndef CATCH_CONFIG_CONSOLE_WIDTH +#define CATCH_CONFIG_CONSOLE_WIDTH 80 +#endif + +namespace Catch { + + struct ConfigData { + + ConfigData() + : listTests( false ), + listTags( false ), + listReporters( false ), + listTestNamesOnly( false ), + showSuccessfulTests( false ), + shouldDebugBreak( false ), + noThrow( false ), + showHelp( false ), + showInvisibles( false ), + filenamesAsTags( false ), + abortAfter( -1 ), + rngSeed( 0 ), + verbosity( Verbosity::Normal ), + warnings( WarnAbout::Nothing ), + showDurations( ShowDurations::DefaultForReporter ), + runOrder( RunTests::InDeclarationOrder ), + useColour( UseColour::Auto ) + {} + + bool listTests; + bool listTags; + bool listReporters; + bool listTestNamesOnly; + + bool showSuccessfulTests; + bool shouldDebugBreak; + bool noThrow; + bool showHelp; + bool showInvisibles; + bool filenamesAsTags; + + int abortAfter; + unsigned int rngSeed; + + Verbosity::Level verbosity; + WarnAbout::What warnings; + ShowDurations::OrNot showDurations; + RunTests::InWhatOrder runOrder; + UseColour::YesOrNo useColour; + + std::string outputFilename; + std::string name; + std::string processName; + + std::vector reporterNames; + std::vector testsOrTags; + }; + + class Config : public SharedImpl { + private: + Config( Config const& other ); + Config& operator = ( Config const& other ); + virtual void dummy(); + public: + + Config() + {} + + Config( ConfigData const& data ) + : m_data( data ), + m_stream( openStream() ) + { + if( !data.testsOrTags.empty() ) { + TestSpecParser parser( ITagAliasRegistry::get() ); + for( std::size_t i = 0; i < data.testsOrTags.size(); ++i ) + parser.parse( data.testsOrTags[i] ); + m_testSpec = parser.testSpec(); + } + } + + virtual ~Config() { + } + + std::string const& getFilename() const { + return m_data.outputFilename ; + } + + bool listTests() const { return m_data.listTests; } + bool listTestNamesOnly() const { return m_data.listTestNamesOnly; } + bool listTags() const { return m_data.listTags; } + bool listReporters() const { return m_data.listReporters; } + + std::string getProcessName() const { return m_data.processName; } + + bool shouldDebugBreak() const { return m_data.shouldDebugBreak; } + + std::vector getReporterNames() const { return m_data.reporterNames; } + + int abortAfter() const { return m_data.abortAfter; } + + TestSpec const& testSpec() const { return m_testSpec; } + + bool showHelp() const { return m_data.showHelp; } + bool showInvisibles() const { return m_data.showInvisibles; } + + // IConfig interface + virtual bool allowThrows() const { return !m_data.noThrow; } + virtual std::ostream& stream() const { return m_stream->stream(); } + virtual std::string name() const { return m_data.name.empty() ? m_data.processName : m_data.name; } + virtual bool includeSuccessfulResults() const { return m_data.showSuccessfulTests; } + virtual bool warnAboutMissingAssertions() const { return m_data.warnings & WarnAbout::NoAssertions; } + virtual ShowDurations::OrNot showDurations() const { return m_data.showDurations; } + virtual RunTests::InWhatOrder runOrder() const { return m_data.runOrder; } + virtual unsigned int rngSeed() const { return m_data.rngSeed; } + virtual UseColour::YesOrNo useColour() const { return m_data.useColour; } + + private: + + IStream const* openStream() { + if( m_data.outputFilename.empty() ) + return new CoutStream(); + else if( m_data.outputFilename[0] == '%' ) { + if( m_data.outputFilename == "%debug" ) + return new DebugOutStream(); + else + throw std::domain_error( "Unrecognised stream: " + m_data.outputFilename ); + } + else + return new FileStream( m_data.outputFilename ); + } + ConfigData m_data; + + CATCH_AUTO_PTR( IStream const ) m_stream; + TestSpec m_testSpec; + }; + +} // end namespace Catch + +// #included from: catch_clara.h +#define TWOBLUECUBES_CATCH_CLARA_H_INCLUDED + +// Use Catch's value for console width (store Clara's off to the side, if present) +#ifdef CLARA_CONFIG_CONSOLE_WIDTH +#define CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH CLARA_CONFIG_CONSOLE_WIDTH +#undef CLARA_CONFIG_CONSOLE_WIDTH +#endif +#define CLARA_CONFIG_CONSOLE_WIDTH CATCH_CONFIG_CONSOLE_WIDTH + +// Declare Clara inside the Catch namespace +#define STITCH_CLARA_OPEN_NAMESPACE namespace Catch { +// #included from: ../external/clara.h + +// Version 0.0.2.4 + +// Only use header guard if we are not using an outer namespace +#if !defined(TWOBLUECUBES_CLARA_H_INCLUDED) || defined(STITCH_CLARA_OPEN_NAMESPACE) + +#ifndef STITCH_CLARA_OPEN_NAMESPACE +#define TWOBLUECUBES_CLARA_H_INCLUDED +#define STITCH_CLARA_OPEN_NAMESPACE +#define STITCH_CLARA_CLOSE_NAMESPACE +#else +#define STITCH_CLARA_CLOSE_NAMESPACE } +#endif + +#define STITCH_TBC_TEXT_FORMAT_OPEN_NAMESPACE STITCH_CLARA_OPEN_NAMESPACE + +// ----------- #included from tbc_text_format.h ----------- + +// Only use header guard if we are not using an outer namespace +#if !defined(TBC_TEXT_FORMAT_H_INCLUDED) || defined(STITCH_TBC_TEXT_FORMAT_OUTER_NAMESPACE) +#ifndef STITCH_TBC_TEXT_FORMAT_OUTER_NAMESPACE +#define TBC_TEXT_FORMAT_H_INCLUDED +#endif + +#include +#include +#include +#include + +// Use optional outer namespace +#ifdef STITCH_TBC_TEXT_FORMAT_OUTER_NAMESPACE +namespace STITCH_TBC_TEXT_FORMAT_OUTER_NAMESPACE { +#endif + +namespace Tbc { + +#ifdef TBC_TEXT_FORMAT_CONSOLE_WIDTH + const unsigned int consoleWidth = TBC_TEXT_FORMAT_CONSOLE_WIDTH; +#else + const unsigned int consoleWidth = 80; +#endif + + struct TextAttributes { + TextAttributes() + : initialIndent( std::string::npos ), + indent( 0 ), + width( consoleWidth-1 ), + tabChar( '\t' ) + {} + + TextAttributes& setInitialIndent( std::size_t _value ) { initialIndent = _value; return *this; } + TextAttributes& setIndent( std::size_t _value ) { indent = _value; return *this; } + TextAttributes& setWidth( std::size_t _value ) { width = _value; return *this; } + TextAttributes& setTabChar( char _value ) { tabChar = _value; return *this; } + + std::size_t initialIndent; // indent of first line, or npos + std::size_t indent; // indent of subsequent lines, or all if initialIndent is npos + std::size_t width; // maximum width of text, including indent. Longer text will wrap + char tabChar; // If this char is seen the indent is changed to current pos + }; + + class Text { + public: + Text( std::string const& _str, TextAttributes const& _attr = TextAttributes() ) + : attr( _attr ) + { + std::string wrappableChars = " [({.,/|\\-"; + std::size_t indent = _attr.initialIndent != std::string::npos + ? _attr.initialIndent + : _attr.indent; + std::string remainder = _str; + + while( !remainder.empty() ) { + if( lines.size() >= 1000 ) { + lines.push_back( "... message truncated due to excessive size" ); + return; + } + std::size_t tabPos = std::string::npos; + std::size_t width = (std::min)( remainder.size(), _attr.width - indent ); + std::size_t pos = remainder.find_first_of( '\n' ); + if( pos <= width ) { + width = pos; + } + pos = remainder.find_last_of( _attr.tabChar, width ); + if( pos != std::string::npos ) { + tabPos = pos; + if( remainder[width] == '\n' ) + width--; + remainder = remainder.substr( 0, tabPos ) + remainder.substr( tabPos+1 ); + } + + if( width == remainder.size() ) { + spliceLine( indent, remainder, width ); + } + else if( remainder[width] == '\n' ) { + spliceLine( indent, remainder, width ); + if( width <= 1 || remainder.size() != 1 ) + remainder = remainder.substr( 1 ); + indent = _attr.indent; + } + else { + pos = remainder.find_last_of( wrappableChars, width ); + if( pos != std::string::npos && pos > 0 ) { + spliceLine( indent, remainder, pos ); + if( remainder[0] == ' ' ) + remainder = remainder.substr( 1 ); + } + else { + spliceLine( indent, remainder, width-1 ); + lines.back() += "-"; + } + if( lines.size() == 1 ) + indent = _attr.indent; + if( tabPos != std::string::npos ) + indent += tabPos; + } + } + } + + void spliceLine( std::size_t _indent, std::string& _remainder, std::size_t _pos ) { + lines.push_back( std::string( _indent, ' ' ) + _remainder.substr( 0, _pos ) ); + _remainder = _remainder.substr( _pos ); + } + + typedef std::vector::const_iterator const_iterator; + + const_iterator begin() const { return lines.begin(); } + const_iterator end() const { return lines.end(); } + std::string const& last() const { return lines.back(); } + std::size_t size() const { return lines.size(); } + std::string const& operator[]( std::size_t _index ) const { return lines[_index]; } + std::string toString() const { + std::ostringstream oss; + oss << *this; + return oss.str(); + } + + inline friend std::ostream& operator << ( std::ostream& _stream, Text const& _text ) { + for( Text::const_iterator it = _text.begin(), itEnd = _text.end(); + it != itEnd; ++it ) { + if( it != _text.begin() ) + _stream << "\n"; + _stream << *it; + } + return _stream; + } + + private: + std::string str; + TextAttributes attr; + std::vector lines; + }; + +} // end namespace Tbc + +#ifdef STITCH_TBC_TEXT_FORMAT_OUTER_NAMESPACE +} // end outer namespace +#endif + +#endif // TBC_TEXT_FORMAT_H_INCLUDED + +// ----------- end of #include from tbc_text_format.h ----------- +// ........... back in clara.h + +#undef STITCH_TBC_TEXT_FORMAT_OPEN_NAMESPACE + +// ----------- #included from clara_compilers.h ----------- + +#ifndef TWOBLUECUBES_CLARA_COMPILERS_H_INCLUDED +#define TWOBLUECUBES_CLARA_COMPILERS_H_INCLUDED + +// Detect a number of compiler features - mostly C++11/14 conformance - by compiler +// The following features are defined: +// +// CLARA_CONFIG_CPP11_NULLPTR : is nullptr supported? +// CLARA_CONFIG_CPP11_NOEXCEPT : is noexcept supported? +// CLARA_CONFIG_CPP11_GENERATED_METHODS : The delete and default keywords for compiler generated methods +// CLARA_CONFIG_CPP11_OVERRIDE : is override supported? +// CLARA_CONFIG_CPP11_UNIQUE_PTR : is unique_ptr supported (otherwise use auto_ptr) + +// CLARA_CONFIG_CPP11_OR_GREATER : Is C++11 supported? + +// CLARA_CONFIG_VARIADIC_MACROS : are variadic macros supported? + +// In general each macro has a _NO_ form +// (e.g. CLARA_CONFIG_CPP11_NO_NULLPTR) which disables the feature. +// Many features, at point of detection, define an _INTERNAL_ macro, so they +// can be combined, en-mass, with the _NO_ forms later. + +// All the C++11 features can be disabled with CLARA_CONFIG_NO_CPP11 + +#ifdef __clang__ + +#if __has_feature(cxx_nullptr) +#define CLARA_INTERNAL_CONFIG_CPP11_NULLPTR +#endif + +#if __has_feature(cxx_noexcept) +#define CLARA_INTERNAL_CONFIG_CPP11_NOEXCEPT +#endif + +#endif // __clang__ + +//////////////////////////////////////////////////////////////////////////////// +// GCC +#ifdef __GNUC__ + +#if __GNUC__ == 4 && __GNUC_MINOR__ >= 6 && defined(__GXX_EXPERIMENTAL_CXX0X__) +#define CLARA_INTERNAL_CONFIG_CPP11_NULLPTR +#endif + +// - otherwise more recent versions define __cplusplus >= 201103L +// and will get picked up below + +#endif // __GNUC__ + +//////////////////////////////////////////////////////////////////////////////// +// Visual C++ +#ifdef _MSC_VER + +#if (_MSC_VER >= 1600) +#define CLARA_INTERNAL_CONFIG_CPP11_NULLPTR +#define CLARA_INTERNAL_CONFIG_CPP11_UNIQUE_PTR +#endif + +#if (_MSC_VER >= 1900 ) // (VC++ 13 (VS2015)) +#define CLARA_INTERNAL_CONFIG_CPP11_NOEXCEPT +#define CLARA_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +#endif + +#endif // _MSC_VER + +//////////////////////////////////////////////////////////////////////////////// +// C++ language feature support + +// catch all support for C++11 +#if defined(__cplusplus) && __cplusplus >= 201103L + +#define CLARA_CPP11_OR_GREATER + +#if !defined(CLARA_INTERNAL_CONFIG_CPP11_NULLPTR) +#define CLARA_INTERNAL_CONFIG_CPP11_NULLPTR +#endif + +#ifndef CLARA_INTERNAL_CONFIG_CPP11_NOEXCEPT +#define CLARA_INTERNAL_CONFIG_CPP11_NOEXCEPT +#endif + +#ifndef CLARA_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +#define CLARA_INTERNAL_CONFIG_CPP11_GENERATED_METHODS +#endif + +#if !defined(CLARA_INTERNAL_CONFIG_CPP11_OVERRIDE) +#define CLARA_INTERNAL_CONFIG_CPP11_OVERRIDE +#endif +#if !defined(CLARA_INTERNAL_CONFIG_CPP11_UNIQUE_PTR) +#define CLARA_INTERNAL_CONFIG_CPP11_UNIQUE_PTR +#endif + +#endif // __cplusplus >= 201103L + +// Now set the actual defines based on the above + anything the user has configured +#if defined(CLARA_INTERNAL_CONFIG_CPP11_NULLPTR) && !defined(CLARA_CONFIG_CPP11_NO_NULLPTR) && !defined(CLARA_CONFIG_CPP11_NULLPTR) && !defined(CLARA_CONFIG_NO_CPP11) +#define CLARA_CONFIG_CPP11_NULLPTR +#endif +#if defined(CLARA_INTERNAL_CONFIG_CPP11_NOEXCEPT) && !defined(CLARA_CONFIG_CPP11_NO_NOEXCEPT) && !defined(CLARA_CONFIG_CPP11_NOEXCEPT) && !defined(CLARA_CONFIG_NO_CPP11) +#define CLARA_CONFIG_CPP11_NOEXCEPT +#endif +#if defined(CLARA_INTERNAL_CONFIG_CPP11_GENERATED_METHODS) && !defined(CLARA_CONFIG_CPP11_NO_GENERATED_METHODS) && !defined(CLARA_CONFIG_CPP11_GENERATED_METHODS) && !defined(CLARA_CONFIG_NO_CPP11) +#define CLARA_CONFIG_CPP11_GENERATED_METHODS +#endif +#if defined(CLARA_INTERNAL_CONFIG_CPP11_OVERRIDE) && !defined(CLARA_CONFIG_NO_OVERRIDE) && !defined(CLARA_CONFIG_CPP11_OVERRIDE) && !defined(CLARA_CONFIG_NO_CPP11) +#define CLARA_CONFIG_CPP11_OVERRIDE +#endif +#if defined(CLARA_INTERNAL_CONFIG_CPP11_UNIQUE_PTR) && !defined(CLARA_CONFIG_NO_UNIQUE_PTR) && !defined(CLARA_CONFIG_CPP11_UNIQUE_PTR) && !defined(CLARA_CONFIG_NO_CPP11) +#define CLARA_CONFIG_CPP11_UNIQUE_PTR +#endif + +// noexcept support: +#if defined(CLARA_CONFIG_CPP11_NOEXCEPT) && !defined(CLARA_NOEXCEPT) +#define CLARA_NOEXCEPT noexcept +# define CLARA_NOEXCEPT_IS(x) noexcept(x) +#else +#define CLARA_NOEXCEPT throw() +# define CLARA_NOEXCEPT_IS(x) +#endif + +// nullptr support +#ifdef CLARA_CONFIG_CPP11_NULLPTR +#define CLARA_NULL nullptr +#else +#define CLARA_NULL NULL +#endif + +// override support +#ifdef CLARA_CONFIG_CPP11_OVERRIDE +#define CLARA_OVERRIDE override +#else +#define CLARA_OVERRIDE +#endif + +// unique_ptr support +#ifdef CLARA_CONFIG_CPP11_UNIQUE_PTR +# define CLARA_AUTO_PTR( T ) std::unique_ptr +#else +# define CLARA_AUTO_PTR( T ) std::auto_ptr +#endif + +#endif // TWOBLUECUBES_CLARA_COMPILERS_H_INCLUDED + +// ----------- end of #include from clara_compilers.h ----------- +// ........... back in clara.h + +#include +#include +#include + +#if defined(WIN32) || defined(__WIN32__) || defined(_WIN32) || defined(_MSC_VER) +#define CLARA_PLATFORM_WINDOWS +#endif + +// Use optional outer namespace +#ifdef STITCH_CLARA_OPEN_NAMESPACE +STITCH_CLARA_OPEN_NAMESPACE +#endif + +namespace Clara { + + struct UnpositionalTag {}; + + extern UnpositionalTag _; + +#ifdef CLARA_CONFIG_MAIN + UnpositionalTag _; +#endif + + namespace Detail { + +#ifdef CLARA_CONSOLE_WIDTH + const unsigned int consoleWidth = CLARA_CONFIG_CONSOLE_WIDTH; +#else + const unsigned int consoleWidth = 80; +#endif + + using namespace Tbc; + + inline bool startsWith( std::string const& str, std::string const& prefix ) { + return str.size() >= prefix.size() && str.substr( 0, prefix.size() ) == prefix; + } + + template struct RemoveConstRef{ typedef T type; }; + template struct RemoveConstRef{ typedef T type; }; + template struct RemoveConstRef{ typedef T type; }; + template struct RemoveConstRef{ typedef T type; }; + + template struct IsBool { static const bool value = false; }; + template<> struct IsBool { static const bool value = true; }; + + template + void convertInto( std::string const& _source, T& _dest ) { + std::stringstream ss; + ss << _source; + ss >> _dest; + if( ss.fail() ) + throw std::runtime_error( "Unable to convert " + _source + " to destination type" ); + } + inline void convertInto( std::string const& _source, std::string& _dest ) { + _dest = _source; + } + inline void convertInto( std::string const& _source, bool& _dest ) { + std::string sourceLC = _source; + std::transform( sourceLC.begin(), sourceLC.end(), sourceLC.begin(), ::tolower ); + if( sourceLC == "y" || sourceLC == "1" || sourceLC == "true" || sourceLC == "yes" || sourceLC == "on" ) + _dest = true; + else if( sourceLC == "n" || sourceLC == "0" || sourceLC == "false" || sourceLC == "no" || sourceLC == "off" ) + _dest = false; + else + throw std::runtime_error( "Expected a boolean value but did not recognise:\n '" + _source + "'" ); + } + + template + struct IArgFunction { + virtual ~IArgFunction() {} +#ifdef CLARA_CONFIG_CPP11_GENERATED_METHODS + IArgFunction() = default; + IArgFunction( IArgFunction const& ) = default; +#endif + virtual void set( ConfigT& config, std::string const& value ) const = 0; + virtual bool takesArg() const = 0; + virtual IArgFunction* clone() const = 0; + }; + + template + class BoundArgFunction { + public: + BoundArgFunction() : functionObj( CLARA_NULL ) {} + BoundArgFunction( IArgFunction* _functionObj ) : functionObj( _functionObj ) {} + BoundArgFunction( BoundArgFunction const& other ) : functionObj( other.functionObj ? other.functionObj->clone() : CLARA_NULL ) {} + BoundArgFunction& operator = ( BoundArgFunction const& other ) { + IArgFunction* newFunctionObj = other.functionObj ? other.functionObj->clone() : CLARA_NULL; + delete functionObj; + functionObj = newFunctionObj; + return *this; + } + ~BoundArgFunction() { delete functionObj; } + + void set( ConfigT& config, std::string const& value ) const { + functionObj->set( config, value ); + } + bool takesArg() const { return functionObj->takesArg(); } + + bool isSet() const { + return functionObj != CLARA_NULL; + } + private: + IArgFunction* functionObj; + }; + + template + struct NullBinder : IArgFunction{ + virtual void set( C&, std::string const& ) const {} + virtual bool takesArg() const { return true; } + virtual IArgFunction* clone() const { return new NullBinder( *this ); } + }; + + template + struct BoundDataMember : IArgFunction{ + BoundDataMember( M C::* _member ) : member( _member ) {} + virtual void set( C& p, std::string const& stringValue ) const { + convertInto( stringValue, p.*member ); + } + virtual bool takesArg() const { return !IsBool::value; } + virtual IArgFunction* clone() const { return new BoundDataMember( *this ); } + M C::* member; + }; + template + struct BoundUnaryMethod : IArgFunction{ + BoundUnaryMethod( void (C::*_member)( M ) ) : member( _member ) {} + virtual void set( C& p, std::string const& stringValue ) const { + typename RemoveConstRef::type value; + convertInto( stringValue, value ); + (p.*member)( value ); + } + virtual bool takesArg() const { return !IsBool::value; } + virtual IArgFunction* clone() const { return new BoundUnaryMethod( *this ); } + void (C::*member)( M ); + }; + template + struct BoundNullaryMethod : IArgFunction{ + BoundNullaryMethod( void (C::*_member)() ) : member( _member ) {} + virtual void set( C& p, std::string const& stringValue ) const { + bool value; + convertInto( stringValue, value ); + if( value ) + (p.*member)(); + } + virtual bool takesArg() const { return false; } + virtual IArgFunction* clone() const { return new BoundNullaryMethod( *this ); } + void (C::*member)(); + }; + + template + struct BoundUnaryFunction : IArgFunction{ + BoundUnaryFunction( void (*_function)( C& ) ) : function( _function ) {} + virtual void set( C& obj, std::string const& stringValue ) const { + bool value; + convertInto( stringValue, value ); + if( value ) + function( obj ); + } + virtual bool takesArg() const { return false; } + virtual IArgFunction* clone() const { return new BoundUnaryFunction( *this ); } + void (*function)( C& ); + }; + + template + struct BoundBinaryFunction : IArgFunction{ + BoundBinaryFunction( void (*_function)( C&, T ) ) : function( _function ) {} + virtual void set( C& obj, std::string const& stringValue ) const { + typename RemoveConstRef::type value; + convertInto( stringValue, value ); + function( obj, value ); + } + virtual bool takesArg() const { return !IsBool::value; } + virtual IArgFunction* clone() const { return new BoundBinaryFunction( *this ); } + void (*function)( C&, T ); + }; + + } // namespace Detail + + inline std::vector argsToVector( int argc, char const* const* const argv ) { + std::vector args( static_cast( argc ) ); + for( std::size_t i = 0; i < static_cast( argc ); ++i ) + args[i] = argv[i]; + + return args; + } + + class Parser { + enum Mode { None, MaybeShortOpt, SlashOpt, ShortOpt, LongOpt, Positional }; + Mode mode; + std::size_t from; + bool inQuotes; + public: + + struct Token { + enum Type { Positional, ShortOpt, LongOpt }; + Token( Type _type, std::string const& _data ) : type( _type ), data( _data ) {} + Type type; + std::string data; + }; + + Parser() : mode( None ), from( 0 ), inQuotes( false ){} + + void parseIntoTokens( std::vector const& args, std::vector& tokens ) { + const std::string doubleDash = "--"; + for( std::size_t i = 1; i < args.size() && args[i] != doubleDash; ++i ) + parseIntoTokens( args[i], tokens); + } + + void parseIntoTokens( std::string const& arg, std::vector& tokens ) { + for( std::size_t i = 0; i <= arg.size(); ++i ) { + char c = arg[i]; + if( c == '"' ) + inQuotes = !inQuotes; + mode = handleMode( i, c, arg, tokens ); + } + } + Mode handleMode( std::size_t i, char c, std::string const& arg, std::vector& tokens ) { + switch( mode ) { + case None: return handleNone( i, c ); + case MaybeShortOpt: return handleMaybeShortOpt( i, c ); + case ShortOpt: + case LongOpt: + case SlashOpt: return handleOpt( i, c, arg, tokens ); + case Positional: return handlePositional( i, c, arg, tokens ); + default: throw std::logic_error( "Unknown mode" ); + } + } + + Mode handleNone( std::size_t i, char c ) { + if( inQuotes ) { + from = i; + return Positional; + } + switch( c ) { + case '-': return MaybeShortOpt; +#ifdef CLARA_PLATFORM_WINDOWS + case '/': from = i+1; return SlashOpt; +#endif + default: from = i; return Positional; + } + } + Mode handleMaybeShortOpt( std::size_t i, char c ) { + switch( c ) { + case '-': from = i+1; return LongOpt; + default: from = i; return ShortOpt; + } + } + Mode handleOpt( std::size_t i, char c, std::string const& arg, std::vector& tokens ) { + if( std::string( ":=\0", 3 ).find( c ) == std::string::npos ) + return mode; + + std::string optName = arg.substr( from, i-from ); + if( mode == ShortOpt ) + for( std::size_t j = 0; j < optName.size(); ++j ) + tokens.push_back( Token( Token::ShortOpt, optName.substr( j, 1 ) ) ); + else if( mode == SlashOpt && optName.size() == 1 ) + tokens.push_back( Token( Token::ShortOpt, optName ) ); + else + tokens.push_back( Token( Token::LongOpt, optName ) ); + return None; + } + Mode handlePositional( std::size_t i, char c, std::string const& arg, std::vector& tokens ) { + if( inQuotes || std::string( "\0", 1 ).find( c ) == std::string::npos ) + return mode; + + std::string data = arg.substr( from, i-from ); + tokens.push_back( Token( Token::Positional, data ) ); + return None; + } + }; + + template + struct CommonArgProperties { + CommonArgProperties() {} + CommonArgProperties( Detail::BoundArgFunction const& _boundField ) : boundField( _boundField ) {} + + Detail::BoundArgFunction boundField; + std::string description; + std::string detail; + std::string placeholder; // Only value if boundField takes an arg + + bool takesArg() const { + return !placeholder.empty(); + } + void validate() const { + if( !boundField.isSet() ) + throw std::logic_error( "option not bound" ); + } + }; + struct OptionArgProperties { + std::vector shortNames; + std::string longName; + + bool hasShortName( std::string const& shortName ) const { + return std::find( shortNames.begin(), shortNames.end(), shortName ) != shortNames.end(); + } + bool hasLongName( std::string const& _longName ) const { + return _longName == longName; + } + }; + struct PositionalArgProperties { + PositionalArgProperties() : position( -1 ) {} + int position; // -1 means non-positional (floating) + + bool isFixedPositional() const { + return position != -1; + } + }; + + template + class CommandLine { + + struct Arg : CommonArgProperties, OptionArgProperties, PositionalArgProperties { + Arg() {} + Arg( Detail::BoundArgFunction const& _boundField ) : CommonArgProperties( _boundField ) {} + + using CommonArgProperties::placeholder; // !TBD + + std::string dbgName() const { + if( !longName.empty() ) + return "--" + longName; + if( !shortNames.empty() ) + return "-" + shortNames[0]; + return "positional args"; + } + std::string commands() const { + std::ostringstream oss; + bool first = true; + std::vector::const_iterator it = shortNames.begin(), itEnd = shortNames.end(); + for(; it != itEnd; ++it ) { + if( first ) + first = false; + else + oss << ", "; + oss << "-" << *it; + } + if( !longName.empty() ) { + if( !first ) + oss << ", "; + oss << "--" << longName; + } + if( !placeholder.empty() ) + oss << " <" << placeholder << ">"; + return oss.str(); + } + }; + + typedef CLARA_AUTO_PTR( Arg ) ArgAutoPtr; + + friend void addOptName( Arg& arg, std::string const& optName ) + { + if( optName.empty() ) + return; + if( Detail::startsWith( optName, "--" ) ) { + if( !arg.longName.empty() ) + throw std::logic_error( "Only one long opt may be specified. '" + + arg.longName + + "' already specified, now attempting to add '" + + optName + "'" ); + arg.longName = optName.substr( 2 ); + } + else if( Detail::startsWith( optName, "-" ) ) + arg.shortNames.push_back( optName.substr( 1 ) ); + else + throw std::logic_error( "option must begin with - or --. Option was: '" + optName + "'" ); + } + friend void setPositionalArg( Arg& arg, int position ) + { + arg.position = position; + } + + class ArgBuilder { + public: + ArgBuilder( Arg* arg ) : m_arg( arg ) {} + + // Bind a non-boolean data member (requires placeholder string) + template + void bind( M C::* field, std::string const& placeholder ) { + m_arg->boundField = new Detail::BoundDataMember( field ); + m_arg->placeholder = placeholder; + } + // Bind a boolean data member (no placeholder required) + template + void bind( bool C::* field ) { + m_arg->boundField = new Detail::BoundDataMember( field ); + } + + // Bind a method taking a single, non-boolean argument (requires a placeholder string) + template + void bind( void (C::* unaryMethod)( M ), std::string const& placeholder ) { + m_arg->boundField = new Detail::BoundUnaryMethod( unaryMethod ); + m_arg->placeholder = placeholder; + } + + // Bind a method taking a single, boolean argument (no placeholder string required) + template + void bind( void (C::* unaryMethod)( bool ) ) { + m_arg->boundField = new Detail::BoundUnaryMethod( unaryMethod ); + } + + // Bind a method that takes no arguments (will be called if opt is present) + template + void bind( void (C::* nullaryMethod)() ) { + m_arg->boundField = new Detail::BoundNullaryMethod( nullaryMethod ); + } + + // Bind a free function taking a single argument - the object to operate on (no placeholder string required) + template + void bind( void (* unaryFunction)( C& ) ) { + m_arg->boundField = new Detail::BoundUnaryFunction( unaryFunction ); + } + + // Bind a free function taking a single argument - the object to operate on (requires a placeholder string) + template + void bind( void (* binaryFunction)( C&, T ), std::string const& placeholder ) { + m_arg->boundField = new Detail::BoundBinaryFunction( binaryFunction ); + m_arg->placeholder = placeholder; + } + + ArgBuilder& describe( std::string const& description ) { + m_arg->description = description; + return *this; + } + ArgBuilder& detail( std::string const& detail ) { + m_arg->detail = detail; + return *this; + } + + protected: + Arg* m_arg; + }; + + class OptBuilder : public ArgBuilder { + public: + OptBuilder( Arg* arg ) : ArgBuilder( arg ) {} + OptBuilder( OptBuilder& other ) : ArgBuilder( other ) {} + + OptBuilder& operator[]( std::string const& optName ) { + addOptName( *ArgBuilder::m_arg, optName ); + return *this; + } + }; + + public: + + CommandLine() + : m_boundProcessName( new Detail::NullBinder() ), + m_highestSpecifiedArgPosition( 0 ), + m_throwOnUnrecognisedTokens( false ) + {} + CommandLine( CommandLine const& other ) + : m_boundProcessName( other.m_boundProcessName ), + m_options ( other.m_options ), + m_positionalArgs( other.m_positionalArgs ), + m_highestSpecifiedArgPosition( other.m_highestSpecifiedArgPosition ), + m_throwOnUnrecognisedTokens( other.m_throwOnUnrecognisedTokens ) + { + if( other.m_floatingArg.get() ) + m_floatingArg.reset( new Arg( *other.m_floatingArg ) ); + } + + CommandLine& setThrowOnUnrecognisedTokens( bool shouldThrow = true ) { + m_throwOnUnrecognisedTokens = shouldThrow; + return *this; + } + + OptBuilder operator[]( std::string const& optName ) { + m_options.push_back( Arg() ); + addOptName( m_options.back(), optName ); + OptBuilder builder( &m_options.back() ); + return builder; + } + + ArgBuilder operator[]( int position ) { + m_positionalArgs.insert( std::make_pair( position, Arg() ) ); + if( position > m_highestSpecifiedArgPosition ) + m_highestSpecifiedArgPosition = position; + setPositionalArg( m_positionalArgs[position], position ); + ArgBuilder builder( &m_positionalArgs[position] ); + return builder; + } + + // Invoke this with the _ instance + ArgBuilder operator[]( UnpositionalTag ) { + if( m_floatingArg.get() ) + throw std::logic_error( "Only one unpositional argument can be added" ); + m_floatingArg.reset( new Arg() ); + ArgBuilder builder( m_floatingArg.get() ); + return builder; + } + + template + void bindProcessName( M C::* field ) { + m_boundProcessName = new Detail::BoundDataMember( field ); + } + template + void bindProcessName( void (C::*_unaryMethod)( M ) ) { + m_boundProcessName = new Detail::BoundUnaryMethod( _unaryMethod ); + } + + void optUsage( std::ostream& os, std::size_t indent = 0, std::size_t width = Detail::consoleWidth ) const { + typename std::vector::const_iterator itBegin = m_options.begin(), itEnd = m_options.end(), it; + std::size_t maxWidth = 0; + for( it = itBegin; it != itEnd; ++it ) + maxWidth = (std::max)( maxWidth, it->commands().size() ); + + for( it = itBegin; it != itEnd; ++it ) { + Detail::Text usage( it->commands(), Detail::TextAttributes() + .setWidth( maxWidth+indent ) + .setIndent( indent ) ); + Detail::Text desc( it->description, Detail::TextAttributes() + .setWidth( width - maxWidth - 3 ) ); + + for( std::size_t i = 0; i < (std::max)( usage.size(), desc.size() ); ++i ) { + std::string usageCol = i < usage.size() ? usage[i] : ""; + os << usageCol; + + if( i < desc.size() && !desc[i].empty() ) + os << std::string( indent + 2 + maxWidth - usageCol.size(), ' ' ) + << desc[i]; + os << "\n"; + } + } + } + std::string optUsage() const { + std::ostringstream oss; + optUsage( oss ); + return oss.str(); + } + + void argSynopsis( std::ostream& os ) const { + for( int i = 1; i <= m_highestSpecifiedArgPosition; ++i ) { + if( i > 1 ) + os << " "; + typename std::map::const_iterator it = m_positionalArgs.find( i ); + if( it != m_positionalArgs.end() ) + os << "<" << it->second.placeholder << ">"; + else if( m_floatingArg.get() ) + os << "<" << m_floatingArg->placeholder << ">"; + else + throw std::logic_error( "non consecutive positional arguments with no floating args" ); + } + // !TBD No indication of mandatory args + if( m_floatingArg.get() ) { + if( m_highestSpecifiedArgPosition > 1 ) + os << " "; + os << "[<" << m_floatingArg->placeholder << "> ...]"; + } + } + std::string argSynopsis() const { + std::ostringstream oss; + argSynopsis( oss ); + return oss.str(); + } + + void usage( std::ostream& os, std::string const& procName ) const { + validate(); + os << "usage:\n " << procName << " "; + argSynopsis( os ); + if( !m_options.empty() ) { + os << " [options]\n\nwhere options are: \n"; + optUsage( os, 2 ); + } + os << "\n"; + } + std::string usage( std::string const& procName ) const { + std::ostringstream oss; + usage( oss, procName ); + return oss.str(); + } + + ConfigT parse( std::vector const& args ) const { + ConfigT config; + parseInto( args, config ); + return config; + } + + std::vector parseInto( std::vector const& args, ConfigT& config ) const { + std::string processName = args[0]; + std::size_t lastSlash = processName.find_last_of( "/\\" ); + if( lastSlash != std::string::npos ) + processName = processName.substr( lastSlash+1 ); + m_boundProcessName.set( config, processName ); + std::vector tokens; + Parser parser; + parser.parseIntoTokens( args, tokens ); + return populate( tokens, config ); + } + + std::vector populate( std::vector const& tokens, ConfigT& config ) const { + validate(); + std::vector unusedTokens = populateOptions( tokens, config ); + unusedTokens = populateFixedArgs( unusedTokens, config ); + unusedTokens = populateFloatingArgs( unusedTokens, config ); + return unusedTokens; + } + + std::vector populateOptions( std::vector const& tokens, ConfigT& config ) const { + std::vector unusedTokens; + std::vector errors; + for( std::size_t i = 0; i < tokens.size(); ++i ) { + Parser::Token const& token = tokens[i]; + typename std::vector::const_iterator it = m_options.begin(), itEnd = m_options.end(); + for(; it != itEnd; ++it ) { + Arg const& arg = *it; + + try { + if( ( token.type == Parser::Token::ShortOpt && arg.hasShortName( token.data ) ) || + ( token.type == Parser::Token::LongOpt && arg.hasLongName( token.data ) ) ) { + if( arg.takesArg() ) { + if( i == tokens.size()-1 || tokens[i+1].type != Parser::Token::Positional ) + errors.push_back( "Expected argument to option: " + token.data ); + else + arg.boundField.set( config, tokens[++i].data ); + } + else { + arg.boundField.set( config, "true" ); + } + break; + } + } + catch( std::exception& ex ) { + errors.push_back( std::string( ex.what() ) + "\n- while parsing: (" + arg.commands() + ")" ); + } + } + if( it == itEnd ) { + if( token.type == Parser::Token::Positional || !m_throwOnUnrecognisedTokens ) + unusedTokens.push_back( token ); + else if( errors.empty() && m_throwOnUnrecognisedTokens ) + errors.push_back( "unrecognised option: " + token.data ); + } + } + if( !errors.empty() ) { + std::ostringstream oss; + for( std::vector::const_iterator it = errors.begin(), itEnd = errors.end(); + it != itEnd; + ++it ) { + if( it != errors.begin() ) + oss << "\n"; + oss << *it; + } + throw std::runtime_error( oss.str() ); + } + return unusedTokens; + } + std::vector populateFixedArgs( std::vector const& tokens, ConfigT& config ) const { + std::vector unusedTokens; + int position = 1; + for( std::size_t i = 0; i < tokens.size(); ++i ) { + Parser::Token const& token = tokens[i]; + typename std::map::const_iterator it = m_positionalArgs.find( position ); + if( it != m_positionalArgs.end() ) + it->second.boundField.set( config, token.data ); + else + unusedTokens.push_back( token ); + if( token.type == Parser::Token::Positional ) + position++; + } + return unusedTokens; + } + std::vector populateFloatingArgs( std::vector const& tokens, ConfigT& config ) const { + if( !m_floatingArg.get() ) + return tokens; + std::vector unusedTokens; + for( std::size_t i = 0; i < tokens.size(); ++i ) { + Parser::Token const& token = tokens[i]; + if( token.type == Parser::Token::Positional ) + m_floatingArg->boundField.set( config, token.data ); + else + unusedTokens.push_back( token ); + } + return unusedTokens; + } + + void validate() const + { + if( m_options.empty() && m_positionalArgs.empty() && !m_floatingArg.get() ) + throw std::logic_error( "No options or arguments specified" ); + + for( typename std::vector::const_iterator it = m_options.begin(), + itEnd = m_options.end(); + it != itEnd; ++it ) + it->validate(); + } + + private: + Detail::BoundArgFunction m_boundProcessName; + std::vector m_options; + std::map m_positionalArgs; + ArgAutoPtr m_floatingArg; + int m_highestSpecifiedArgPosition; + bool m_throwOnUnrecognisedTokens; + }; + +} // end namespace Clara + +STITCH_CLARA_CLOSE_NAMESPACE +#undef STITCH_CLARA_OPEN_NAMESPACE +#undef STITCH_CLARA_CLOSE_NAMESPACE + +#endif // TWOBLUECUBES_CLARA_H_INCLUDED +#undef STITCH_CLARA_OPEN_NAMESPACE + +// Restore Clara's value for console width, if present +#ifdef CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH +#define CLARA_CONFIG_CONSOLE_WIDTH CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH +#undef CATCH_TEMP_CLARA_CONFIG_CONSOLE_WIDTH +#endif + +#include + +namespace Catch { + + inline void abortAfterFirst( ConfigData& config ) { config.abortAfter = 1; } + inline void abortAfterX( ConfigData& config, int x ) { + if( x < 1 ) + throw std::runtime_error( "Value after -x or --abortAfter must be greater than zero" ); + config.abortAfter = x; + } + inline void addTestOrTags( ConfigData& config, std::string const& _testSpec ) { config.testsOrTags.push_back( _testSpec ); } + inline void addReporterName( ConfigData& config, std::string const& _reporterName ) { config.reporterNames.push_back( _reporterName ); } + + inline void addWarning( ConfigData& config, std::string const& _warning ) { + if( _warning == "NoAssertions" ) + config.warnings = static_cast( config.warnings | WarnAbout::NoAssertions ); + else + throw std::runtime_error( "Unrecognised warning: '" + _warning + "'" ); + } + inline void setOrder( ConfigData& config, std::string const& order ) { + if( startsWith( "declared", order ) ) + config.runOrder = RunTests::InDeclarationOrder; + else if( startsWith( "lexical", order ) ) + config.runOrder = RunTests::InLexicographicalOrder; + else if( startsWith( "random", order ) ) + config.runOrder = RunTests::InRandomOrder; + else + throw std::runtime_error( "Unrecognised ordering: '" + order + "'" ); + } + inline void setRngSeed( ConfigData& config, std::string const& seed ) { + if( seed == "time" ) { + config.rngSeed = static_cast( std::time(0) ); + } + else { + std::stringstream ss; + ss << seed; + ss >> config.rngSeed; + if( ss.fail() ) + throw std::runtime_error( "Argment to --rng-seed should be the word 'time' or a number" ); + } + } + inline void setVerbosity( ConfigData& config, int level ) { + // !TBD: accept strings? + config.verbosity = static_cast( level ); + } + inline void setShowDurations( ConfigData& config, bool _showDurations ) { + config.showDurations = _showDurations + ? ShowDurations::Always + : ShowDurations::Never; + } + inline void setUseColour( ConfigData& config, std::string const& value ) { + std::string mode = toLower( value ); + + if( mode == "yes" ) + config.useColour = UseColour::Yes; + else if( mode == "no" ) + config.useColour = UseColour::No; + else if( mode == "auto" ) + config.useColour = UseColour::Auto; + else + throw std::runtime_error( "colour mode must be one of: auto, yes or no" ); + } + inline void forceColour( ConfigData& config ) { + config.useColour = UseColour::Yes; + } + inline void loadTestNamesFromFile( ConfigData& config, std::string const& _filename ) { + std::ifstream f( _filename.c_str() ); + if( !f.is_open() ) + throw std::domain_error( "Unable to load input file: " + _filename ); + + std::string line; + while( std::getline( f, line ) ) { + line = trim(line); + if( !line.empty() && !startsWith( line, "#" ) ) + addTestOrTags( config, "\"" + line + "\"," ); + } + } + + inline Clara::CommandLine makeCommandLineParser() { + + using namespace Clara; + CommandLine cli; + + cli.bindProcessName( &ConfigData::processName ); + + cli["-?"]["-h"]["--help"] + .describe( "display usage information" ) + .bind( &ConfigData::showHelp ); + + cli["-l"]["--list-tests"] + .describe( "list all/matching test cases" ) + .bind( &ConfigData::listTests ); + + cli["-t"]["--list-tags"] + .describe( "list all/matching tags" ) + .bind( &ConfigData::listTags ); + + cli["-s"]["--success"] + .describe( "include successful tests in output" ) + .bind( &ConfigData::showSuccessfulTests ); + + cli["-b"]["--break"] + .describe( "break into debugger on failure" ) + .bind( &ConfigData::shouldDebugBreak ); + + cli["-e"]["--nothrow"] + .describe( "skip exception tests" ) + .bind( &ConfigData::noThrow ); + + cli["-i"]["--invisibles"] + .describe( "show invisibles (tabs, newlines)" ) + .bind( &ConfigData::showInvisibles ); + + cli["-o"]["--out"] + .describe( "output filename" ) + .bind( &ConfigData::outputFilename, "filename" ); + + cli["-r"]["--reporter"] +// .placeholder( "name[:filename]" ) + .describe( "reporter to use (defaults to console)" ) + .bind( &addReporterName, "name" ); + + cli["-n"]["--name"] + .describe( "suite name" ) + .bind( &ConfigData::name, "name" ); + + cli["-a"]["--abort"] + .describe( "abort at first failure" ) + .bind( &abortAfterFirst ); + + cli["-x"]["--abortx"] + .describe( "abort after x failures" ) + .bind( &abortAfterX, "no. failures" ); + + cli["-w"]["--warn"] + .describe( "enable warnings" ) + .bind( &addWarning, "warning name" ); + +// - needs updating if reinstated +// cli.into( &setVerbosity ) +// .describe( "level of verbosity (0=no output)" ) +// .shortOpt( "v") +// .longOpt( "verbosity" ) +// .placeholder( "level" ); + + cli[_] + .describe( "which test or tests to use" ) + .bind( &addTestOrTags, "test name, pattern or tags" ); + + cli["-d"]["--durations"] + .describe( "show test durations" ) + .bind( &setShowDurations, "yes|no" ); + + cli["-f"]["--input-file"] + .describe( "load test names to run from a file" ) + .bind( &loadTestNamesFromFile, "filename" ); + + cli["-#"]["--filenames-as-tags"] + .describe( "adds a tag for the filename" ) + .bind( &ConfigData::filenamesAsTags ); + + // Less common commands which don't have a short form + cli["--list-test-names-only"] + .describe( "list all/matching test cases names only" ) + .bind( &ConfigData::listTestNamesOnly ); + + cli["--list-reporters"] + .describe( "list all reporters" ) + .bind( &ConfigData::listReporters ); + + cli["--order"] + .describe( "test case order (defaults to decl)" ) + .bind( &setOrder, "decl|lex|rand" ); + + cli["--rng-seed"] + .describe( "set a specific seed for random numbers" ) + .bind( &setRngSeed, "'time'|number" ); + + cli["--force-colour"] + .describe( "force colourised output (deprecated)" ) + .bind( &forceColour ); + + cli["--use-colour"] + .describe( "should output be colourised" ) + .bind( &setUseColour, "yes|no" ); + + return cli; + } + +} // end namespace Catch + +// #included from: internal/catch_list.hpp +#define TWOBLUECUBES_CATCH_LIST_HPP_INCLUDED + +// #included from: catch_text.h +#define TWOBLUECUBES_CATCH_TEXT_H_INCLUDED + +#define TBC_TEXT_FORMAT_CONSOLE_WIDTH CATCH_CONFIG_CONSOLE_WIDTH + +#define CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE Catch +// #included from: ../external/tbc_text_format.h +// Only use header guard if we are not using an outer namespace +#ifndef CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE +# ifdef TWOBLUECUBES_TEXT_FORMAT_H_INCLUDED +# ifndef TWOBLUECUBES_TEXT_FORMAT_H_ALREADY_INCLUDED +# define TWOBLUECUBES_TEXT_FORMAT_H_ALREADY_INCLUDED +# endif +# else +# define TWOBLUECUBES_TEXT_FORMAT_H_INCLUDED +# endif +#endif +#ifndef TWOBLUECUBES_TEXT_FORMAT_H_ALREADY_INCLUDED +#include +#include +#include + +// Use optional outer namespace +#ifdef CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE +namespace CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE { +#endif + +namespace Tbc { + +#ifdef TBC_TEXT_FORMAT_CONSOLE_WIDTH + const unsigned int consoleWidth = TBC_TEXT_FORMAT_CONSOLE_WIDTH; +#else + const unsigned int consoleWidth = 80; +#endif + + struct TextAttributes { + TextAttributes() + : initialIndent( std::string::npos ), + indent( 0 ), + width( consoleWidth-1 ), + tabChar( '\t' ) + {} + + TextAttributes& setInitialIndent( std::size_t _value ) { initialIndent = _value; return *this; } + TextAttributes& setIndent( std::size_t _value ) { indent = _value; return *this; } + TextAttributes& setWidth( std::size_t _value ) { width = _value; return *this; } + TextAttributes& setTabChar( char _value ) { tabChar = _value; return *this; } + + std::size_t initialIndent; // indent of first line, or npos + std::size_t indent; // indent of subsequent lines, or all if initialIndent is npos + std::size_t width; // maximum width of text, including indent. Longer text will wrap + char tabChar; // If this char is seen the indent is changed to current pos + }; + + class Text { + public: + Text( std::string const& _str, TextAttributes const& _attr = TextAttributes() ) + : attr( _attr ) + { + std::string wrappableChars = " [({.,/|\\-"; + std::size_t indent = _attr.initialIndent != std::string::npos + ? _attr.initialIndent + : _attr.indent; + std::string remainder = _str; + + while( !remainder.empty() ) { + if( lines.size() >= 1000 ) { + lines.push_back( "... message truncated due to excessive size" ); + return; + } + std::size_t tabPos = std::string::npos; + std::size_t width = (std::min)( remainder.size(), _attr.width - indent ); + std::size_t pos = remainder.find_first_of( '\n' ); + if( pos <= width ) { + width = pos; + } + pos = remainder.find_last_of( _attr.tabChar, width ); + if( pos != std::string::npos ) { + tabPos = pos; + if( remainder[width] == '\n' ) + width--; + remainder = remainder.substr( 0, tabPos ) + remainder.substr( tabPos+1 ); + } + + if( width == remainder.size() ) { + spliceLine( indent, remainder, width ); + } + else if( remainder[width] == '\n' ) { + spliceLine( indent, remainder, width ); + if( width <= 1 || remainder.size() != 1 ) + remainder = remainder.substr( 1 ); + indent = _attr.indent; + } + else { + pos = remainder.find_last_of( wrappableChars, width ); + if( pos != std::string::npos && pos > 0 ) { + spliceLine( indent, remainder, pos ); + if( remainder[0] == ' ' ) + remainder = remainder.substr( 1 ); + } + else { + spliceLine( indent, remainder, width-1 ); + lines.back() += "-"; + } + if( lines.size() == 1 ) + indent = _attr.indent; + if( tabPos != std::string::npos ) + indent += tabPos; + } + } + } + + void spliceLine( std::size_t _indent, std::string& _remainder, std::size_t _pos ) { + lines.push_back( std::string( _indent, ' ' ) + _remainder.substr( 0, _pos ) ); + _remainder = _remainder.substr( _pos ); + } + + typedef std::vector::const_iterator const_iterator; + + const_iterator begin() const { return lines.begin(); } + const_iterator end() const { return lines.end(); } + std::string const& last() const { return lines.back(); } + std::size_t size() const { return lines.size(); } + std::string const& operator[]( std::size_t _index ) const { return lines[_index]; } + std::string toString() const { + std::ostringstream oss; + oss << *this; + return oss.str(); + } + + inline friend std::ostream& operator << ( std::ostream& _stream, Text const& _text ) { + for( Text::const_iterator it = _text.begin(), itEnd = _text.end(); + it != itEnd; ++it ) { + if( it != _text.begin() ) + _stream << "\n"; + _stream << *it; + } + return _stream; + } + + private: + std::string str; + TextAttributes attr; + std::vector lines; + }; + +} // end namespace Tbc + +#ifdef CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE +} // end outer namespace +#endif + +#endif // TWOBLUECUBES_TEXT_FORMAT_H_ALREADY_INCLUDED +#undef CLICHE_TBC_TEXT_FORMAT_OUTER_NAMESPACE + +namespace Catch { + using Tbc::Text; + using Tbc::TextAttributes; +} + +// #included from: catch_console_colour.hpp +#define TWOBLUECUBES_CATCH_CONSOLE_COLOUR_HPP_INCLUDED + +namespace Catch { + + struct Colour { + enum Code { + None = 0, + + White, + Red, + Green, + Blue, + Cyan, + Yellow, + Grey, + + Bright = 0x10, + + BrightRed = Bright | Red, + BrightGreen = Bright | Green, + LightGrey = Bright | Grey, + BrightWhite = Bright | White, + + // By intention + FileName = LightGrey, + Warning = Yellow, + ResultError = BrightRed, + ResultSuccess = BrightGreen, + ResultExpectedFailure = Warning, + + Error = BrightRed, + Success = Green, + + OriginalExpression = Cyan, + ReconstructedExpression = Yellow, + + SecondaryText = LightGrey, + Headers = White + }; + + // Use constructed object for RAII guard + Colour( Code _colourCode ); + Colour( Colour const& other ); + ~Colour(); + + // Use static method for one-shot changes + static void use( Code _colourCode ); + + private: + bool m_moved; + }; + + inline std::ostream& operator << ( std::ostream& os, Colour const& ) { return os; } + +} // end namespace Catch + +// #included from: catch_interfaces_reporter.h +#define TWOBLUECUBES_CATCH_INTERFACES_REPORTER_H_INCLUDED + +#include +#include +#include +#include + +namespace Catch +{ + struct ReporterConfig { + explicit ReporterConfig( Ptr const& _fullConfig ) + : m_stream( &_fullConfig->stream() ), m_fullConfig( _fullConfig ) {} + + ReporterConfig( Ptr const& _fullConfig, std::ostream& _stream ) + : m_stream( &_stream ), m_fullConfig( _fullConfig ) {} + + std::ostream& stream() const { return *m_stream; } + Ptr fullConfig() const { return m_fullConfig; } + + private: + std::ostream* m_stream; + Ptr m_fullConfig; + }; + + struct ReporterPreferences { + ReporterPreferences() + : shouldRedirectStdOut( false ) + {} + + bool shouldRedirectStdOut; + }; + + template + struct LazyStat : Option { + LazyStat() : used( false ) {} + LazyStat& operator=( T const& _value ) { + Option::operator=( _value ); + used = false; + return *this; + } + void reset() { + Option::reset(); + used = false; + } + bool used; + }; + + struct TestRunInfo { + TestRunInfo( std::string const& _name ) : name( _name ) {} + std::string name; + }; + struct GroupInfo { + GroupInfo( std::string const& _name, + std::size_t _groupIndex, + std::size_t _groupsCount ) + : name( _name ), + groupIndex( _groupIndex ), + groupsCounts( _groupsCount ) + {} + + std::string name; + std::size_t groupIndex; + std::size_t groupsCounts; + }; + + struct AssertionStats { + AssertionStats( AssertionResult const& _assertionResult, + std::vector const& _infoMessages, + Totals const& _totals ) + : assertionResult( _assertionResult ), + infoMessages( _infoMessages ), + totals( _totals ) + { + if( assertionResult.hasMessage() ) { + // Copy message into messages list. + // !TBD This should have been done earlier, somewhere + MessageBuilder builder( assertionResult.getTestMacroName(), assertionResult.getSourceInfo(), assertionResult.getResultType() ); + builder << assertionResult.getMessage(); + builder.m_info.message = builder.m_stream.str(); + + infoMessages.push_back( builder.m_info ); + } + } + virtual ~AssertionStats(); + +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + AssertionStats( AssertionStats const& ) = default; + AssertionStats( AssertionStats && ) = default; + AssertionStats& operator = ( AssertionStats const& ) = default; + AssertionStats& operator = ( AssertionStats && ) = default; +# endif + + AssertionResult assertionResult; + std::vector infoMessages; + Totals totals; + }; + + struct SectionStats { + SectionStats( SectionInfo const& _sectionInfo, + Counts const& _assertions, + double _durationInSeconds, + bool _missingAssertions ) + : sectionInfo( _sectionInfo ), + assertions( _assertions ), + durationInSeconds( _durationInSeconds ), + missingAssertions( _missingAssertions ) + {} + virtual ~SectionStats(); +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + SectionStats( SectionStats const& ) = default; + SectionStats( SectionStats && ) = default; + SectionStats& operator = ( SectionStats const& ) = default; + SectionStats& operator = ( SectionStats && ) = default; +# endif + + SectionInfo sectionInfo; + Counts assertions; + double durationInSeconds; + bool missingAssertions; + }; + + struct TestCaseStats { + TestCaseStats( TestCaseInfo const& _testInfo, + Totals const& _totals, + std::string const& _stdOut, + std::string const& _stdErr, + bool _aborting ) + : testInfo( _testInfo ), + totals( _totals ), + stdOut( _stdOut ), + stdErr( _stdErr ), + aborting( _aborting ) + {} + virtual ~TestCaseStats(); + +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + TestCaseStats( TestCaseStats const& ) = default; + TestCaseStats( TestCaseStats && ) = default; + TestCaseStats& operator = ( TestCaseStats const& ) = default; + TestCaseStats& operator = ( TestCaseStats && ) = default; +# endif + + TestCaseInfo testInfo; + Totals totals; + std::string stdOut; + std::string stdErr; + bool aborting; + }; + + struct TestGroupStats { + TestGroupStats( GroupInfo const& _groupInfo, + Totals const& _totals, + bool _aborting ) + : groupInfo( _groupInfo ), + totals( _totals ), + aborting( _aborting ) + {} + TestGroupStats( GroupInfo const& _groupInfo ) + : groupInfo( _groupInfo ), + aborting( false ) + {} + virtual ~TestGroupStats(); + +# ifdef CATCH_CONFIG_CPP11_GENERATED_METHODS + TestGroupStats( TestGroupStats const& ) = default; + TestGroupStats( TestGroupStats && ) = default; + TestGroupStats& operator = ( TestGroupStats const& ) = default; + TestGroupStats& operator = ( TestGroupStats && ) = default; +# endif + + GroupInfo groupInfo; + Totals totals; + bool aborting; + }; + + struct TestRunStats { + TestRunStats( TestRunInfo const& _runInfo, + Totals const& _totals, + bool _aborting ) + : runInfo( _runInfo ), + totals( _totals ), + aborting( _aborting ) + {} + virtual ~TestRunStats(); + +# ifndef CATCH_CONFIG_CPP11_GENERATED_METHODS + TestRunStats( TestRunStats const& _other ) + : runInfo( _other.runInfo ), + totals( _other.totals ), + aborting( _other.aborting ) + {} +# else + TestRunStats( TestRunStats const& ) = default; + TestRunStats( TestRunStats && ) = default; + TestRunStats& operator = ( TestRunStats const& ) = default; + TestRunStats& operator = ( TestRunStats && ) = default; +# endif + + TestRunInfo runInfo; + Totals totals; + bool aborting; + }; + + class MultipleReporters; + + struct IStreamingReporter : IShared { + virtual ~IStreamingReporter(); + + // Implementing class must also provide the following static method: + // static std::string getDescription(); + + virtual ReporterPreferences getPreferences() const = 0; + + virtual void noMatchingTestCases( std::string const& spec ) = 0; + + virtual void testRunStarting( TestRunInfo const& testRunInfo ) = 0; + virtual void testGroupStarting( GroupInfo const& groupInfo ) = 0; + + virtual void testCaseStarting( TestCaseInfo const& testInfo ) = 0; + virtual void sectionStarting( SectionInfo const& sectionInfo ) = 0; + + virtual void assertionStarting( AssertionInfo const& assertionInfo ) = 0; + + // The return value indicates if the messages buffer should be cleared: + virtual bool assertionEnded( AssertionStats const& assertionStats ) = 0; + + virtual void sectionEnded( SectionStats const& sectionStats ) = 0; + virtual void testCaseEnded( TestCaseStats const& testCaseStats ) = 0; + virtual void testGroupEnded( TestGroupStats const& testGroupStats ) = 0; + virtual void testRunEnded( TestRunStats const& testRunStats ) = 0; + + virtual void skipTest( TestCaseInfo const& testInfo ) = 0; + + virtual MultipleReporters* tryAsMulti() { return CATCH_NULL; } + }; + + struct IReporterFactory : IShared { + virtual ~IReporterFactory(); + virtual IStreamingReporter* create( ReporterConfig const& config ) const = 0; + virtual std::string getDescription() const = 0; + }; + + struct IReporterRegistry { + typedef std::map > FactoryMap; + typedef std::vector > Listeners; + + virtual ~IReporterRegistry(); + virtual IStreamingReporter* create( std::string const& name, Ptr const& config ) const = 0; + virtual FactoryMap const& getFactories() const = 0; + virtual Listeners const& getListeners() const = 0; + }; + + Ptr addReporter( Ptr const& existingReporter, Ptr const& additionalReporter ); + +} + +#include +#include + +namespace Catch { + + inline std::size_t listTests( Config const& config ) { + + TestSpec testSpec = config.testSpec(); + if( config.testSpec().hasFilters() ) + Catch::cout() << "Matching test cases:\n"; + else { + Catch::cout() << "All available test cases:\n"; + testSpec = TestSpecParser( ITagAliasRegistry::get() ).parse( "*" ).testSpec(); + } + + std::size_t matchedTests = 0; + TextAttributes nameAttr, tagsAttr; + nameAttr.setInitialIndent( 2 ).setIndent( 4 ); + tagsAttr.setIndent( 6 ); + + std::vector matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config ); + for( std::vector::const_iterator it = matchedTestCases.begin(), itEnd = matchedTestCases.end(); + it != itEnd; + ++it ) { + matchedTests++; + TestCaseInfo const& testCaseInfo = it->getTestCaseInfo(); + Colour::Code colour = testCaseInfo.isHidden() + ? Colour::SecondaryText + : Colour::None; + Colour colourGuard( colour ); + + Catch::cout() << Text( testCaseInfo.name, nameAttr ) << std::endl; + if( !testCaseInfo.tags.empty() ) + Catch::cout() << Text( testCaseInfo.tagsAsString, tagsAttr ) << std::endl; + } + + if( !config.testSpec().hasFilters() ) + Catch::cout() << pluralise( matchedTests, "test case" ) << "\n" << std::endl; + else + Catch::cout() << pluralise( matchedTests, "matching test case" ) << "\n" << std::endl; + return matchedTests; + } + + inline std::size_t listTestsNamesOnly( Config const& config ) { + TestSpec testSpec = config.testSpec(); + if( !config.testSpec().hasFilters() ) + testSpec = TestSpecParser( ITagAliasRegistry::get() ).parse( "*" ).testSpec(); + std::size_t matchedTests = 0; + std::vector matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config ); + for( std::vector::const_iterator it = matchedTestCases.begin(), itEnd = matchedTestCases.end(); + it != itEnd; + ++it ) { + matchedTests++; + TestCaseInfo const& testCaseInfo = it->getTestCaseInfo(); + Catch::cout() << testCaseInfo.name << std::endl; + } + return matchedTests; + } + + struct TagInfo { + TagInfo() : count ( 0 ) {} + void add( std::string const& spelling ) { + ++count; + spellings.insert( spelling ); + } + std::string all() const { + std::string out; + for( std::set::const_iterator it = spellings.begin(), itEnd = spellings.end(); + it != itEnd; + ++it ) + out += "[" + *it + "]"; + return out; + } + std::set spellings; + std::size_t count; + }; + + inline std::size_t listTags( Config const& config ) { + TestSpec testSpec = config.testSpec(); + if( config.testSpec().hasFilters() ) + Catch::cout() << "Tags for matching test cases:\n"; + else { + Catch::cout() << "All available tags:\n"; + testSpec = TestSpecParser( ITagAliasRegistry::get() ).parse( "*" ).testSpec(); + } + + std::map tagCounts; + + std::vector matchedTestCases = filterTests( getAllTestCasesSorted( config ), testSpec, config ); + for( std::vector::const_iterator it = matchedTestCases.begin(), itEnd = matchedTestCases.end(); + it != itEnd; + ++it ) { + for( std::set::const_iterator tagIt = it->getTestCaseInfo().tags.begin(), + tagItEnd = it->getTestCaseInfo().tags.end(); + tagIt != tagItEnd; + ++tagIt ) { + std::string tagName = *tagIt; + std::string lcaseTagName = toLower( tagName ); + std::map::iterator countIt = tagCounts.find( lcaseTagName ); + if( countIt == tagCounts.end() ) + countIt = tagCounts.insert( std::make_pair( lcaseTagName, TagInfo() ) ).first; + countIt->second.add( tagName ); + } + } + + for( std::map::const_iterator countIt = tagCounts.begin(), + countItEnd = tagCounts.end(); + countIt != countItEnd; + ++countIt ) { + std::ostringstream oss; + oss << " " << std::setw(2) << countIt->second.count << " "; + Text wrapper( countIt->second.all(), TextAttributes() + .setInitialIndent( 0 ) + .setIndent( oss.str().size() ) + .setWidth( CATCH_CONFIG_CONSOLE_WIDTH-10 ) ); + Catch::cout() << oss.str() << wrapper << "\n"; + } + Catch::cout() << pluralise( tagCounts.size(), "tag" ) << "\n" << std::endl; + return tagCounts.size(); + } + + inline std::size_t listReporters( Config const& /*config*/ ) { + Catch::cout() << "Available reporters:\n"; + IReporterRegistry::FactoryMap const& factories = getRegistryHub().getReporterRegistry().getFactories(); + IReporterRegistry::FactoryMap::const_iterator itBegin = factories.begin(), itEnd = factories.end(), it; + std::size_t maxNameLen = 0; + for(it = itBegin; it != itEnd; ++it ) + maxNameLen = (std::max)( maxNameLen, it->first.size() ); + + for(it = itBegin; it != itEnd; ++it ) { + Text wrapper( it->second->getDescription(), TextAttributes() + .setInitialIndent( 0 ) + .setIndent( 7+maxNameLen ) + .setWidth( CATCH_CONFIG_CONSOLE_WIDTH - maxNameLen-8 ) ); + Catch::cout() << " " + << it->first + << ":" + << std::string( maxNameLen - it->first.size() + 2, ' ' ) + << wrapper << "\n"; + } + Catch::cout() << std::endl; + return factories.size(); + } + + inline Option list( Config const& config ) { + Option listedCount; + if( config.listTests() ) + listedCount = listedCount.valueOr(0) + listTests( config ); + if( config.listTestNamesOnly() ) + listedCount = listedCount.valueOr(0) + listTestsNamesOnly( config ); + if( config.listTags() ) + listedCount = listedCount.valueOr(0) + listTags( config ); + if( config.listReporters() ) + listedCount = listedCount.valueOr(0) + listReporters( config ); + return listedCount; + } + +} // end namespace Catch + +// #included from: internal/catch_run_context.hpp +#define TWOBLUECUBES_CATCH_RUNNER_IMPL_HPP_INCLUDED + +// #included from: catch_test_case_tracker.hpp +#define TWOBLUECUBES_CATCH_TEST_CASE_TRACKER_HPP_INCLUDED + +#include +#include +#include +#include + +namespace Catch { +namespace TestCaseTracking { + + struct ITracker : SharedImpl<> { + virtual ~ITracker(); + + // static queries + virtual std::string name() const = 0; + + // dynamic queries + virtual bool isComplete() const = 0; // Successfully completed or failed + virtual bool isSuccessfullyCompleted() const = 0; + virtual bool isOpen() const = 0; // Started but not complete + virtual bool hasChildren() const = 0; + + virtual ITracker& parent() = 0; + + // actions + virtual void close() = 0; // Successfully complete + virtual void fail() = 0; + virtual void markAsNeedingAnotherRun() = 0; + + virtual void addChild( Ptr const& child ) = 0; + virtual ITracker* findChild( std::string const& name ) = 0; + virtual void openChild() = 0; + + // Debug/ checking + virtual bool isSectionTracker() const = 0; + virtual bool isIndexTracker() const = 0; + }; + + class TrackerContext { + + enum RunState { + NotStarted, + Executing, + CompletedCycle + }; + + Ptr m_rootTracker; + ITracker* m_currentTracker; + RunState m_runState; + + public: + + static TrackerContext& instance() { + static TrackerContext s_instance; + return s_instance; + } + + TrackerContext() + : m_currentTracker( CATCH_NULL ), + m_runState( NotStarted ) + {} + + ITracker& startRun(); + + void endRun() { + m_rootTracker.reset(); + m_currentTracker = CATCH_NULL; + m_runState = NotStarted; + } + + void startCycle() { + m_currentTracker = m_rootTracker.get(); + m_runState = Executing; + } + void completeCycle() { + m_runState = CompletedCycle; + } + + bool completedCycle() const { + return m_runState == CompletedCycle; + } + ITracker& currentTracker() { + return *m_currentTracker; + } + void setCurrentTracker( ITracker* tracker ) { + m_currentTracker = tracker; + } + }; + + class TrackerBase : public ITracker { + protected: + enum CycleState { + NotStarted, + Executing, + ExecutingChildren, + NeedsAnotherRun, + CompletedSuccessfully, + Failed + }; + class TrackerHasName { + std::string m_name; + public: + TrackerHasName( std::string const& name ) : m_name( name ) {} + bool operator ()( Ptr const& tracker ) { + return tracker->name() == m_name; + } + }; + typedef std::vector > Children; + std::string m_name; + TrackerContext& m_ctx; + ITracker* m_parent; + Children m_children; + CycleState m_runState; + public: + TrackerBase( std::string const& name, TrackerContext& ctx, ITracker* parent ) + : m_name( name ), + m_ctx( ctx ), + m_parent( parent ), + m_runState( NotStarted ) + {} + virtual ~TrackerBase(); + + virtual std::string name() const CATCH_OVERRIDE { + return m_name; + } + virtual bool isComplete() const CATCH_OVERRIDE { + return m_runState == CompletedSuccessfully || m_runState == Failed; + } + virtual bool isSuccessfullyCompleted() const CATCH_OVERRIDE { + return m_runState == CompletedSuccessfully; + } + virtual bool isOpen() const CATCH_OVERRIDE { + return m_runState != NotStarted && !isComplete(); + } + virtual bool hasChildren() const CATCH_OVERRIDE { + return !m_children.empty(); + } + + virtual void addChild( Ptr const& child ) CATCH_OVERRIDE { + m_children.push_back( child ); + } + + virtual ITracker* findChild( std::string const& name ) CATCH_OVERRIDE { + Children::const_iterator it = std::find_if( m_children.begin(), m_children.end(), TrackerHasName( name ) ); + return( it != m_children.end() ) + ? it->get() + : CATCH_NULL; + } + virtual ITracker& parent() CATCH_OVERRIDE { + assert( m_parent ); // Should always be non-null except for root + return *m_parent; + } + + virtual void openChild() CATCH_OVERRIDE { + if( m_runState != ExecutingChildren ) { + m_runState = ExecutingChildren; + if( m_parent ) + m_parent->openChild(); + } + } + + virtual bool isSectionTracker() const CATCH_OVERRIDE { return false; } + virtual bool isIndexTracker() const CATCH_OVERRIDE { return false; } + + void open() { + m_runState = Executing; + moveToThis(); + if( m_parent ) + m_parent->openChild(); + } + + virtual void close() CATCH_OVERRIDE { + + // Close any still open children (e.g. generators) + while( &m_ctx.currentTracker() != this ) + m_ctx.currentTracker().close(); + + switch( m_runState ) { + case NotStarted: + case CompletedSuccessfully: + case Failed: + throw std::logic_error( "Illogical state" ); + + case NeedsAnotherRun: + break;; + + case Executing: + m_runState = CompletedSuccessfully; + break; + case ExecutingChildren: + if( m_children.empty() || m_children.back()->isComplete() ) + m_runState = CompletedSuccessfully; + break; + + default: + throw std::logic_error( "Unexpected state" ); + } + moveToParent(); + m_ctx.completeCycle(); + } + virtual void fail() CATCH_OVERRIDE { + m_runState = Failed; + if( m_parent ) + m_parent->markAsNeedingAnotherRun(); + moveToParent(); + m_ctx.completeCycle(); + } + virtual void markAsNeedingAnotherRun() CATCH_OVERRIDE { + m_runState = NeedsAnotherRun; + } + private: + void moveToParent() { + assert( m_parent ); + m_ctx.setCurrentTracker( m_parent ); + } + void moveToThis() { + m_ctx.setCurrentTracker( this ); + } + }; + + class SectionTracker : public TrackerBase { + public: + SectionTracker( std::string const& name, TrackerContext& ctx, ITracker* parent ) + : TrackerBase( name, ctx, parent ) + {} + virtual ~SectionTracker(); + + virtual bool isSectionTracker() const CATCH_OVERRIDE { return true; } + + static SectionTracker& acquire( TrackerContext& ctx, std::string const& name ) { + SectionTracker* section = CATCH_NULL; + + ITracker& currentTracker = ctx.currentTracker(); + if( ITracker* childTracker = currentTracker.findChild( name ) ) { + assert( childTracker ); + assert( childTracker->isSectionTracker() ); + section = static_cast( childTracker ); + } + else { + section = new SectionTracker( name, ctx, ¤tTracker ); + currentTracker.addChild( section ); + } + if( !ctx.completedCycle() && !section->isComplete() ) { + + section->open(); + } + return *section; + } + }; + + class IndexTracker : public TrackerBase { + int m_size; + int m_index; + public: + IndexTracker( std::string const& name, TrackerContext& ctx, ITracker* parent, int size ) + : TrackerBase( name, ctx, parent ), + m_size( size ), + m_index( -1 ) + {} + virtual ~IndexTracker(); + + virtual bool isIndexTracker() const CATCH_OVERRIDE { return true; } + + static IndexTracker& acquire( TrackerContext& ctx, std::string const& name, int size ) { + IndexTracker* tracker = CATCH_NULL; + + ITracker& currentTracker = ctx.currentTracker(); + if( ITracker* childTracker = currentTracker.findChild( name ) ) { + assert( childTracker ); + assert( childTracker->isIndexTracker() ); + tracker = static_cast( childTracker ); + } + else { + tracker = new IndexTracker( name, ctx, ¤tTracker, size ); + currentTracker.addChild( tracker ); + } + + if( !ctx.completedCycle() && !tracker->isComplete() ) { + if( tracker->m_runState != ExecutingChildren && tracker->m_runState != NeedsAnotherRun ) + tracker->moveNext(); + tracker->open(); + } + + return *tracker; + } + + int index() const { return m_index; } + + void moveNext() { + m_index++; + m_children.clear(); + } + + virtual void close() CATCH_OVERRIDE { + TrackerBase::close(); + if( m_runState == CompletedSuccessfully && m_index < m_size-1 ) + m_runState = Executing; + } + }; + + inline ITracker& TrackerContext::startRun() { + m_rootTracker = new SectionTracker( "{root}", *this, CATCH_NULL ); + m_currentTracker = CATCH_NULL; + m_runState = Executing; + return *m_rootTracker; + } + +} // namespace TestCaseTracking + +using TestCaseTracking::ITracker; +using TestCaseTracking::TrackerContext; +using TestCaseTracking::SectionTracker; +using TestCaseTracking::IndexTracker; + +} // namespace Catch + +// #included from: catch_fatal_condition.hpp +#define TWOBLUECUBES_CATCH_FATAL_CONDITION_H_INCLUDED + +namespace Catch { + + // Report the error condition then exit the process + inline void fatal( std::string const& message, int exitCode ) { + IContext& context = Catch::getCurrentContext(); + IResultCapture* resultCapture = context.getResultCapture(); + resultCapture->handleFatalErrorCondition( message ); + + if( Catch::alwaysTrue() ) // avoids "no return" warnings + exit( exitCode ); + } + +} // namespace Catch + +#if defined ( CATCH_PLATFORM_WINDOWS ) ///////////////////////////////////////// + +namespace Catch { + + struct FatalConditionHandler { + void reset() {} + }; + +} // namespace Catch + +#else // Not Windows - assumed to be POSIX compatible ////////////////////////// + +#include + +namespace Catch { + + struct SignalDefs { int id; const char* name; }; + extern SignalDefs signalDefs[]; + SignalDefs signalDefs[] = { + { SIGINT, "SIGINT - Terminal interrupt signal" }, + { SIGILL, "SIGILL - Illegal instruction signal" }, + { SIGFPE, "SIGFPE - Floating point error signal" }, + { SIGSEGV, "SIGSEGV - Segmentation violation signal" }, + { SIGTERM, "SIGTERM - Termination request signal" }, + { SIGABRT, "SIGABRT - Abort (abnormal termination) signal" } + }; + + struct FatalConditionHandler { + + static void handleSignal( int sig ) { + for( std::size_t i = 0; i < sizeof(signalDefs)/sizeof(SignalDefs); ++i ) + if( sig == signalDefs[i].id ) + fatal( signalDefs[i].name, -sig ); + fatal( "", -sig ); + } + + FatalConditionHandler() : m_isSet( true ) { + for( std::size_t i = 0; i < sizeof(signalDefs)/sizeof(SignalDefs); ++i ) + signal( signalDefs[i].id, handleSignal ); + } + ~FatalConditionHandler() { + reset(); + } + void reset() { + if( m_isSet ) { + for( std::size_t i = 0; i < sizeof(signalDefs)/sizeof(SignalDefs); ++i ) + signal( signalDefs[i].id, SIG_DFL ); + m_isSet = false; + } + } + + bool m_isSet; + }; + +} // namespace Catch + +#endif // not Windows + +#include +#include + +namespace Catch { + + class StreamRedirect { + + public: + StreamRedirect( std::ostream& stream, std::string& targetString ) + : m_stream( stream ), + m_prevBuf( stream.rdbuf() ), + m_targetString( targetString ) + { + stream.rdbuf( m_oss.rdbuf() ); + } + + ~StreamRedirect() { + m_targetString += m_oss.str(); + m_stream.rdbuf( m_prevBuf ); + } + + private: + std::ostream& m_stream; + std::streambuf* m_prevBuf; + std::ostringstream m_oss; + std::string& m_targetString; + }; + + /////////////////////////////////////////////////////////////////////////// + + class RunContext : public IResultCapture, public IRunner { + + RunContext( RunContext const& ); + void operator =( RunContext const& ); + + public: + + explicit RunContext( Ptr const& _config, Ptr const& reporter ) + : m_runInfo( _config->name() ), + m_context( getCurrentMutableContext() ), + m_activeTestCase( CATCH_NULL ), + m_config( _config ), + m_reporter( reporter ) + { + m_context.setRunner( this ); + m_context.setConfig( m_config ); + m_context.setResultCapture( this ); + m_reporter->testRunStarting( m_runInfo ); + } + + virtual ~RunContext() { + m_reporter->testRunEnded( TestRunStats( m_runInfo, m_totals, aborting() ) ); + } + + void testGroupStarting( std::string const& testSpec, std::size_t groupIndex, std::size_t groupsCount ) { + m_reporter->testGroupStarting( GroupInfo( testSpec, groupIndex, groupsCount ) ); + } + void testGroupEnded( std::string const& testSpec, Totals const& totals, std::size_t groupIndex, std::size_t groupsCount ) { + m_reporter->testGroupEnded( TestGroupStats( GroupInfo( testSpec, groupIndex, groupsCount ), totals, aborting() ) ); + } + + Totals runTest( TestCase const& testCase ) { + Totals prevTotals = m_totals; + + std::string redirectedCout; + std::string redirectedCerr; + + TestCaseInfo testInfo = testCase.getTestCaseInfo(); + + m_reporter->testCaseStarting( testInfo ); + + m_activeTestCase = &testCase; + + do { + m_trackerContext.startRun(); + do { + m_trackerContext.startCycle(); + m_testCaseTracker = &SectionTracker::acquire( m_trackerContext, testInfo.name ); + runCurrentTest( redirectedCout, redirectedCerr ); + } + while( !m_testCaseTracker->isSuccessfullyCompleted() && !aborting() ); + } + // !TBD: deprecated - this will be replaced by indexed trackers + while( getCurrentContext().advanceGeneratorsForCurrentTest() && !aborting() ); + + Totals deltaTotals = m_totals.delta( prevTotals ); + if( testInfo.expectedToFail() && deltaTotals.testCases.passed > 0 ) { + deltaTotals.assertions.failed++; + deltaTotals.testCases.passed--; + deltaTotals.testCases.failed++; + } + m_totals.testCases += deltaTotals.testCases; + m_reporter->testCaseEnded( TestCaseStats( testInfo, + deltaTotals, + redirectedCout, + redirectedCerr, + aborting() ) ); + + m_activeTestCase = CATCH_NULL; + m_testCaseTracker = CATCH_NULL; + + return deltaTotals; + } + + Ptr config() const { + return m_config; + } + + private: // IResultCapture + + virtual void assertionEnded( AssertionResult const& result ) { + if( result.getResultType() == ResultWas::Ok ) { + m_totals.assertions.passed++; + } + else if( !result.isOk() ) { + m_totals.assertions.failed++; + } + + if( m_reporter->assertionEnded( AssertionStats( result, m_messages, m_totals ) ) ) + m_messages.clear(); + + // Reset working state + m_lastAssertionInfo = AssertionInfo( "", m_lastAssertionInfo.lineInfo, "{Unknown expression after the reported line}" , m_lastAssertionInfo.resultDisposition ); + m_lastResult = result; + } + + virtual bool sectionStarted ( + SectionInfo const& sectionInfo, + Counts& assertions + ) + { + std::ostringstream oss; + oss << sectionInfo.name << "@" << sectionInfo.lineInfo; + + ITracker& sectionTracker = SectionTracker::acquire( m_trackerContext, oss.str() ); + if( !sectionTracker.isOpen() ) + return false; + m_activeSections.push_back( §ionTracker ); + + m_lastAssertionInfo.lineInfo = sectionInfo.lineInfo; + + m_reporter->sectionStarting( sectionInfo ); + + assertions = m_totals.assertions; + + return true; + } + bool testForMissingAssertions( Counts& assertions ) { + if( assertions.total() != 0 ) + return false; + if( !m_config->warnAboutMissingAssertions() ) + return false; + if( m_trackerContext.currentTracker().hasChildren() ) + return false; + m_totals.assertions.failed++; + assertions.failed++; + return true; + } + + virtual void sectionEnded( SectionEndInfo const& endInfo ) { + Counts assertions = m_totals.assertions - endInfo.prevAssertions; + bool missingAssertions = testForMissingAssertions( assertions ); + + if( !m_activeSections.empty() ) { + m_activeSections.back()->close(); + m_activeSections.pop_back(); + } + + m_reporter->sectionEnded( SectionStats( endInfo.sectionInfo, assertions, endInfo.durationInSeconds, missingAssertions ) ); + m_messages.clear(); + } + + virtual void sectionEndedEarly( SectionEndInfo const& endInfo ) { + if( m_unfinishedSections.empty() ) + m_activeSections.back()->fail(); + else + m_activeSections.back()->close(); + m_activeSections.pop_back(); + + m_unfinishedSections.push_back( endInfo ); + } + + virtual void pushScopedMessage( MessageInfo const& message ) { + m_messages.push_back( message ); + } + + virtual void popScopedMessage( MessageInfo const& message ) { + m_messages.erase( std::remove( m_messages.begin(), m_messages.end(), message ), m_messages.end() ); + } + + virtual std::string getCurrentTestName() const { + return m_activeTestCase + ? m_activeTestCase->getTestCaseInfo().name + : ""; + } + + virtual const AssertionResult* getLastResult() const { + return &m_lastResult; + } + + virtual void handleFatalErrorCondition( std::string const& message ) { + ResultBuilder resultBuilder = makeUnexpectedResultBuilder(); + resultBuilder.setResultType( ResultWas::FatalErrorCondition ); + resultBuilder << message; + resultBuilder.captureExpression(); + + handleUnfinishedSections(); + + // Recreate section for test case (as we will lose the one that was in scope) + TestCaseInfo const& testCaseInfo = m_activeTestCase->getTestCaseInfo(); + SectionInfo testCaseSection( testCaseInfo.lineInfo, testCaseInfo.name, testCaseInfo.description ); + + Counts assertions; + assertions.failed = 1; + SectionStats testCaseSectionStats( testCaseSection, assertions, 0, false ); + m_reporter->sectionEnded( testCaseSectionStats ); + + TestCaseInfo testInfo = m_activeTestCase->getTestCaseInfo(); + + Totals deltaTotals; + deltaTotals.testCases.failed = 1; + m_reporter->testCaseEnded( TestCaseStats( testInfo, + deltaTotals, + "", + "", + false ) ); + m_totals.testCases.failed++; + testGroupEnded( "", m_totals, 1, 1 ); + m_reporter->testRunEnded( TestRunStats( m_runInfo, m_totals, false ) ); + } + + public: + // !TBD We need to do this another way! + bool aborting() const { + return m_totals.assertions.failed == static_cast( m_config->abortAfter() ); + } + + private: + + void runCurrentTest( std::string& redirectedCout, std::string& redirectedCerr ) { + TestCaseInfo const& testCaseInfo = m_activeTestCase->getTestCaseInfo(); + SectionInfo testCaseSection( testCaseInfo.lineInfo, testCaseInfo.name, testCaseInfo.description ); + m_reporter->sectionStarting( testCaseSection ); + Counts prevAssertions = m_totals.assertions; + double duration = 0; + try { + m_lastAssertionInfo = AssertionInfo( "TEST_CASE", testCaseInfo.lineInfo, "", ResultDisposition::Normal ); + + seedRng( *m_config ); + + Timer timer; + timer.start(); + if( m_reporter->getPreferences().shouldRedirectStdOut ) { + StreamRedirect coutRedir( Catch::cout(), redirectedCout ); + StreamRedirect cerrRedir( Catch::cerr(), redirectedCerr ); + invokeActiveTestCase(); + } + else { + invokeActiveTestCase(); + } + duration = timer.getElapsedSeconds(); + } + catch( TestFailureException& ) { + // This just means the test was aborted due to failure + } + catch(...) { + makeUnexpectedResultBuilder().useActiveException(); + } + m_testCaseTracker->close(); + handleUnfinishedSections(); + m_messages.clear(); + + Counts assertions = m_totals.assertions - prevAssertions; + bool missingAssertions = testForMissingAssertions( assertions ); + + if( testCaseInfo.okToFail() ) { + std::swap( assertions.failedButOk, assertions.failed ); + m_totals.assertions.failed -= assertions.failedButOk; + m_totals.assertions.failedButOk += assertions.failedButOk; + } + + SectionStats testCaseSectionStats( testCaseSection, assertions, duration, missingAssertions ); + m_reporter->sectionEnded( testCaseSectionStats ); + } + + void invokeActiveTestCase() { + FatalConditionHandler fatalConditionHandler; // Handle signals + m_activeTestCase->invoke(); + fatalConditionHandler.reset(); + } + + private: + + ResultBuilder makeUnexpectedResultBuilder() const { + return ResultBuilder( m_lastAssertionInfo.macroName.c_str(), + m_lastAssertionInfo.lineInfo, + m_lastAssertionInfo.capturedExpression.c_str(), + m_lastAssertionInfo.resultDisposition ); + } + + void handleUnfinishedSections() { + // If sections ended prematurely due to an exception we stored their + // infos here so we can tear them down outside the unwind process. + for( std::vector::const_reverse_iterator it = m_unfinishedSections.rbegin(), + itEnd = m_unfinishedSections.rend(); + it != itEnd; + ++it ) + sectionEnded( *it ); + m_unfinishedSections.clear(); + } + + TestRunInfo m_runInfo; + IMutableContext& m_context; + TestCase const* m_activeTestCase; + ITracker* m_testCaseTracker; + ITracker* m_currentSectionTracker; + AssertionResult m_lastResult; + + Ptr m_config; + Totals m_totals; + Ptr m_reporter; + std::vector m_messages; + AssertionInfo m_lastAssertionInfo; + std::vector m_unfinishedSections; + std::vector m_activeSections; + TrackerContext m_trackerContext; + }; + + IResultCapture& getResultCapture() { + if( IResultCapture* capture = getCurrentContext().getResultCapture() ) + return *capture; + else + throw std::logic_error( "No result capture instance" ); + } + +} // end namespace Catch + +// #included from: internal/catch_version.h +#define TWOBLUECUBES_CATCH_VERSION_H_INCLUDED + +namespace Catch { + + // Versioning information + struct Version { + Version( unsigned int _majorVersion, + unsigned int _minorVersion, + unsigned int _patchNumber, + std::string const& _branchName, + unsigned int _buildNumber ); + + unsigned int const majorVersion; + unsigned int const minorVersion; + unsigned int const patchNumber; + + // buildNumber is only used if branchName is not null + std::string const branchName; + unsigned int const buildNumber; + + friend std::ostream& operator << ( std::ostream& os, Version const& version ); + + private: + void operator=( Version const& ); + }; + + extern Version libraryVersion; +} + +#include +#include +#include + +namespace Catch { + + Ptr createReporter( std::string const& reporterName, Ptr const& config ) { + Ptr reporter = getRegistryHub().getReporterRegistry().create( reporterName, config.get() ); + if( !reporter ) { + std::ostringstream oss; + oss << "No reporter registered with name: '" << reporterName << "'"; + throw std::domain_error( oss.str() ); + } + return reporter; + } + + Ptr makeReporter( Ptr const& config ) { + std::vector reporters = config->getReporterNames(); + if( reporters.empty() ) + reporters.push_back( "console" ); + + Ptr reporter; + for( std::vector::const_iterator it = reporters.begin(), itEnd = reporters.end(); + it != itEnd; + ++it ) + reporter = addReporter( reporter, createReporter( *it, config ) ); + return reporter; + } + Ptr addListeners( Ptr const& config, Ptr reporters ) { + IReporterRegistry::Listeners listeners = getRegistryHub().getReporterRegistry().getListeners(); + for( IReporterRegistry::Listeners::const_iterator it = listeners.begin(), itEnd = listeners.end(); + it != itEnd; + ++it ) + reporters = addReporter(reporters, (*it)->create( ReporterConfig( config ) ) ); + return reporters; + } + + Totals runTests( Ptr const& config ) { + + Ptr iconfig = config.get(); + + Ptr reporter = makeReporter( config ); + reporter = addListeners( iconfig, reporter ); + + RunContext context( iconfig, reporter ); + + Totals totals; + + context.testGroupStarting( config->name(), 1, 1 ); + + TestSpec testSpec = config->testSpec(); + if( !testSpec.hasFilters() ) + testSpec = TestSpecParser( ITagAliasRegistry::get() ).parse( "~[.]" ).testSpec(); // All not hidden tests + + std::vector const& allTestCases = getAllTestCasesSorted( *iconfig ); + for( std::vector::const_iterator it = allTestCases.begin(), itEnd = allTestCases.end(); + it != itEnd; + ++it ) { + if( !context.aborting() && matchTest( *it, testSpec, *iconfig ) ) + totals += context.runTest( *it ); + else + reporter->skipTest( *it ); + } + + context.testGroupEnded( iconfig->name(), totals, 1, 1 ); + return totals; + } + + void applyFilenamesAsTags( IConfig const& config ) { + std::vector const& tests = getAllTestCasesSorted( config ); + for(std::size_t i = 0; i < tests.size(); ++i ) { + TestCase& test = const_cast( tests[i] ); + std::set tags = test.tags; + + std::string filename = test.lineInfo.file; + std::string::size_type lastSlash = filename.find_last_of( "\\/" ); + if( lastSlash != std::string::npos ) + filename = filename.substr( lastSlash+1 ); + + std::string::size_type lastDot = filename.find_last_of( "." ); + if( lastDot != std::string::npos ) + filename = filename.substr( 0, lastDot ); + + tags.insert( "#" + filename ); + setTags( test, tags ); + } + } + + class Session : NonCopyable { + static bool alreadyInstantiated; + + public: + + struct OnUnusedOptions { enum DoWhat { Ignore, Fail }; }; + + Session() + : m_cli( makeCommandLineParser() ) { + if( alreadyInstantiated ) { + std::string msg = "Only one instance of Catch::Session can ever be used"; + Catch::cerr() << msg << std::endl; + throw std::logic_error( msg ); + } + alreadyInstantiated = true; + } + ~Session() { + Catch::cleanUp(); + } + + void showHelp( std::string const& processName ) { + Catch::cout() << "\nCatch v" << libraryVersion << "\n"; + + m_cli.usage( Catch::cout(), processName ); + Catch::cout() << "For more detail usage please see the project docs\n" << std::endl; + } + + int applyCommandLine( int argc, char const* const* const argv, OnUnusedOptions::DoWhat unusedOptionBehaviour = OnUnusedOptions::Fail ) { + try { + m_cli.setThrowOnUnrecognisedTokens( unusedOptionBehaviour == OnUnusedOptions::Fail ); + m_unusedTokens = m_cli.parseInto( Clara::argsToVector( argc, argv ), m_configData ); + if( m_configData.showHelp ) + showHelp( m_configData.processName ); + m_config.reset(); + } + catch( std::exception& ex ) { + { + Colour colourGuard( Colour::Red ); + Catch::cerr() + << "\nError(s) in input:\n" + << Text( ex.what(), TextAttributes().setIndent(2) ) + << "\n\n"; + } + m_cli.usage( Catch::cout(), m_configData.processName ); + return (std::numeric_limits::max)(); + } + return 0; + } + + void useConfigData( ConfigData const& _configData ) { + m_configData = _configData; + m_config.reset(); + } + + int run( int argc, char const* const* const argv ) { + + int returnCode = applyCommandLine( argc, argv ); + if( returnCode == 0 ) + returnCode = run(); + return returnCode; + } + + int run() { + if( m_configData.showHelp ) + return 0; + + try + { + config(); // Force config to be constructed + + seedRng( *m_config ); + + if( m_configData.filenamesAsTags ) + applyFilenamesAsTags( *m_config ); + + // Handle list request + if( Option listed = list( config() ) ) + return static_cast( *listed ); + + return static_cast( runTests( m_config ).assertions.failed ); + } + catch( std::exception& ex ) { + Catch::cerr() << ex.what() << std::endl; + return (std::numeric_limits::max)(); + } + } + + Clara::CommandLine const& cli() const { + return m_cli; + } + std::vector const& unusedTokens() const { + return m_unusedTokens; + } + ConfigData& configData() { + return m_configData; + } + Config& config() { + if( !m_config ) + m_config = new Config( m_configData ); + return *m_config; + } + private: + Clara::CommandLine m_cli; + std::vector m_unusedTokens; + ConfigData m_configData; + Ptr m_config; + }; + + bool Session::alreadyInstantiated = false; + +} // end namespace Catch + +// #included from: catch_registry_hub.hpp +#define TWOBLUECUBES_CATCH_REGISTRY_HUB_HPP_INCLUDED + +// #included from: catch_test_case_registry_impl.hpp +#define TWOBLUECUBES_CATCH_TEST_CASE_REGISTRY_IMPL_HPP_INCLUDED + +#include +#include +#include +#include +#include + +#ifdef CATCH_CPP14_OR_GREATER +#include +#endif + +namespace Catch { + + struct RandomNumberGenerator { + typedef int result_type; + + result_type operator()( result_type n ) const { return std::rand() % n; } + +#ifdef CATCH_CPP14_OR_GREATER + static constexpr result_type min() { return 0; } + static constexpr result_type max() { return 1000000; } + result_type operator()() const { return std::rand() % max(); } +#endif + template + static void shuffle( V& vector ) { + RandomNumberGenerator rng; +#ifdef CATCH_CPP14_OR_GREATER + std::shuffle( vector.begin(), vector.end(), rng ); +#else + std::random_shuffle( vector.begin(), vector.end(), rng ); +#endif + } + }; + + inline std::vector sortTests( IConfig const& config, std::vector const& unsortedTestCases ) { + + std::vector sorted = unsortedTestCases; + + switch( config.runOrder() ) { + case RunTests::InLexicographicalOrder: + std::sort( sorted.begin(), sorted.end() ); + break; + case RunTests::InRandomOrder: + { + seedRng( config ); + RandomNumberGenerator::shuffle( sorted ); + } + break; + case RunTests::InDeclarationOrder: + // already in declaration order + break; + } + return sorted; + } + bool matchTest( TestCase const& testCase, TestSpec const& testSpec, IConfig const& config ) { + return testSpec.matches( testCase ) && ( config.allowThrows() || !testCase.throws() ); + } + + void enforceNoDuplicateTestCases( std::vector const& functions ) { + std::set seenFunctions; + for( std::vector::const_iterator it = functions.begin(), itEnd = functions.end(); + it != itEnd; + ++it ) { + std::pair::const_iterator, bool> prev = seenFunctions.insert( *it ); + if( !prev.second ) { + std::ostringstream ss; + + ss << Colour( Colour::Red ) + << "error: TEST_CASE( \"" << it->name << "\" ) already defined.\n" + << "\tFirst seen at " << prev.first->getTestCaseInfo().lineInfo << "\n" + << "\tRedefined at " << it->getTestCaseInfo().lineInfo << std::endl; + + throw std::runtime_error(ss.str()); + } + } + } + + std::vector filterTests( std::vector const& testCases, TestSpec const& testSpec, IConfig const& config ) { + std::vector filtered; + filtered.reserve( testCases.size() ); + for( std::vector::const_iterator it = testCases.begin(), itEnd = testCases.end(); + it != itEnd; + ++it ) + if( matchTest( *it, testSpec, config ) ) + filtered.push_back( *it ); + return filtered; + } + std::vector const& getAllTestCasesSorted( IConfig const& config ) { + return getRegistryHub().getTestCaseRegistry().getAllTestsSorted( config ); + } + + class TestRegistry : public ITestCaseRegistry { + public: + TestRegistry() + : m_currentSortOrder( RunTests::InDeclarationOrder ), + m_unnamedCount( 0 ) + {} + virtual ~TestRegistry(); + + virtual void registerTest( TestCase const& testCase ) { + std::string name = testCase.getTestCaseInfo().name; + if( name == "" ) { + std::ostringstream oss; + oss << "Anonymous test case " << ++m_unnamedCount; + return registerTest( testCase.withName( oss.str() ) ); + } + m_functions.push_back( testCase ); + } + + virtual std::vector const& getAllTests() const { + return m_functions; + } + virtual std::vector const& getAllTestsSorted( IConfig const& config ) const { + if( m_sortedFunctions.empty() ) + enforceNoDuplicateTestCases( m_functions ); + + if( m_currentSortOrder != config.runOrder() || m_sortedFunctions.empty() ) { + m_sortedFunctions = sortTests( config, m_functions ); + m_currentSortOrder = config.runOrder(); + } + return m_sortedFunctions; + } + + private: + std::vector m_functions; + mutable RunTests::InWhatOrder m_currentSortOrder; + mutable std::vector m_sortedFunctions; + size_t m_unnamedCount; + std::ios_base::Init m_ostreamInit; // Forces cout/ cerr to be initialised + }; + + /////////////////////////////////////////////////////////////////////////// + + class FreeFunctionTestCase : public SharedImpl { + public: + + FreeFunctionTestCase( TestFunction fun ) : m_fun( fun ) {} + + virtual void invoke() const { + m_fun(); + } + + private: + virtual ~FreeFunctionTestCase(); + + TestFunction m_fun; + }; + + inline std::string extractClassName( std::string const& classOrQualifiedMethodName ) { + std::string className = classOrQualifiedMethodName; + if( startsWith( className, "&" ) ) + { + std::size_t lastColons = className.rfind( "::" ); + std::size_t penultimateColons = className.rfind( "::", lastColons-1 ); + if( penultimateColons == std::string::npos ) + penultimateColons = 1; + className = className.substr( penultimateColons, lastColons-penultimateColons ); + } + return className; + } + + void registerTestCase + ( ITestCase* testCase, + char const* classOrQualifiedMethodName, + NameAndDesc const& nameAndDesc, + SourceLineInfo const& lineInfo ) { + + getMutableRegistryHub().registerTest + ( makeTestCase + ( testCase, + extractClassName( classOrQualifiedMethodName ), + nameAndDesc.name, + nameAndDesc.description, + lineInfo ) ); + } + void registerTestCaseFunction + ( TestFunction function, + SourceLineInfo const& lineInfo, + NameAndDesc const& nameAndDesc ) { + registerTestCase( new FreeFunctionTestCase( function ), "", nameAndDesc, lineInfo ); + } + + /////////////////////////////////////////////////////////////////////////// + + AutoReg::AutoReg + ( TestFunction function, + SourceLineInfo const& lineInfo, + NameAndDesc const& nameAndDesc ) { + registerTestCaseFunction( function, lineInfo, nameAndDesc ); + } + + AutoReg::~AutoReg() {} + +} // end namespace Catch + +// #included from: catch_reporter_registry.hpp +#define TWOBLUECUBES_CATCH_REPORTER_REGISTRY_HPP_INCLUDED + +#include + +namespace Catch { + + class ReporterRegistry : public IReporterRegistry { + + public: + + virtual ~ReporterRegistry() CATCH_OVERRIDE {} + + virtual IStreamingReporter* create( std::string const& name, Ptr const& config ) const CATCH_OVERRIDE { + FactoryMap::const_iterator it = m_factories.find( name ); + if( it == m_factories.end() ) + return CATCH_NULL; + return it->second->create( ReporterConfig( config ) ); + } + + void registerReporter( std::string const& name, Ptr const& factory ) { + m_factories.insert( std::make_pair( name, factory ) ); + } + void registerListener( Ptr const& factory ) { + m_listeners.push_back( factory ); + } + + virtual FactoryMap const& getFactories() const CATCH_OVERRIDE { + return m_factories; + } + virtual Listeners const& getListeners() const CATCH_OVERRIDE { + return m_listeners; + } + + private: + FactoryMap m_factories; + Listeners m_listeners; + }; +} + +// #included from: catch_exception_translator_registry.hpp +#define TWOBLUECUBES_CATCH_EXCEPTION_TRANSLATOR_REGISTRY_HPP_INCLUDED + +#ifdef __OBJC__ +#import "Foundation/Foundation.h" +#endif + +namespace Catch { + + class ExceptionTranslatorRegistry : public IExceptionTranslatorRegistry { + public: + ~ExceptionTranslatorRegistry() { + deleteAll( m_translators ); + } + + virtual void registerTranslator( const IExceptionTranslator* translator ) { + m_translators.push_back( translator ); + } + + virtual std::string translateActiveException() const { + try { +#ifdef __OBJC__ + // In Objective-C try objective-c exceptions first + @try { + return tryTranslators(); + } + @catch (NSException *exception) { + return Catch::toString( [exception description] ); + } +#else + return tryTranslators(); +#endif + } + catch( TestFailureException& ) { + throw; + } + catch( std::exception& ex ) { + return ex.what(); + } + catch( std::string& msg ) { + return msg; + } + catch( const char* msg ) { + return msg; + } + catch(...) { + return "Unknown exception"; + } + } + + std::string tryTranslators() const { + if( m_translators.empty() ) + throw; + else + return m_translators[0]->translate( m_translators.begin()+1, m_translators.end() ); + } + + private: + std::vector m_translators; + }; +} + +namespace Catch { + + namespace { + + class RegistryHub : public IRegistryHub, public IMutableRegistryHub { + + RegistryHub( RegistryHub const& ); + void operator=( RegistryHub const& ); + + public: // IRegistryHub + RegistryHub() { + } + virtual IReporterRegistry const& getReporterRegistry() const CATCH_OVERRIDE { + return m_reporterRegistry; + } + virtual ITestCaseRegistry const& getTestCaseRegistry() const CATCH_OVERRIDE { + return m_testCaseRegistry; + } + virtual IExceptionTranslatorRegistry& getExceptionTranslatorRegistry() CATCH_OVERRIDE { + return m_exceptionTranslatorRegistry; + } + + public: // IMutableRegistryHub + virtual void registerReporter( std::string const& name, Ptr const& factory ) CATCH_OVERRIDE { + m_reporterRegistry.registerReporter( name, factory ); + } + virtual void registerListener( Ptr const& factory ) CATCH_OVERRIDE { + m_reporterRegistry.registerListener( factory ); + } + virtual void registerTest( TestCase const& testInfo ) CATCH_OVERRIDE { + m_testCaseRegistry.registerTest( testInfo ); + } + virtual void registerTranslator( const IExceptionTranslator* translator ) CATCH_OVERRIDE { + m_exceptionTranslatorRegistry.registerTranslator( translator ); + } + + private: + TestRegistry m_testCaseRegistry; + ReporterRegistry m_reporterRegistry; + ExceptionTranslatorRegistry m_exceptionTranslatorRegistry; + }; + + // Single, global, instance + inline RegistryHub*& getTheRegistryHub() { + static RegistryHub* theRegistryHub = CATCH_NULL; + if( !theRegistryHub ) + theRegistryHub = new RegistryHub(); + return theRegistryHub; + } + } + + IRegistryHub& getRegistryHub() { + return *getTheRegistryHub(); + } + IMutableRegistryHub& getMutableRegistryHub() { + return *getTheRegistryHub(); + } + void cleanUp() { + delete getTheRegistryHub(); + getTheRegistryHub() = CATCH_NULL; + cleanUpContext(); + } + std::string translateActiveException() { + return getRegistryHub().getExceptionTranslatorRegistry().translateActiveException(); + } + +} // end namespace Catch + +// #included from: catch_notimplemented_exception.hpp +#define TWOBLUECUBES_CATCH_NOTIMPLEMENTED_EXCEPTION_HPP_INCLUDED + +#include + +namespace Catch { + + NotImplementedException::NotImplementedException( SourceLineInfo const& lineInfo ) + : m_lineInfo( lineInfo ) { + std::ostringstream oss; + oss << lineInfo << ": function "; + oss << "not implemented"; + m_what = oss.str(); + } + + const char* NotImplementedException::what() const CATCH_NOEXCEPT { + return m_what.c_str(); + } + +} // end namespace Catch + +// #included from: catch_context_impl.hpp +#define TWOBLUECUBES_CATCH_CONTEXT_IMPL_HPP_INCLUDED + +// #included from: catch_stream.hpp +#define TWOBLUECUBES_CATCH_STREAM_HPP_INCLUDED + +#include +#include +#include + +namespace Catch { + + template + class StreamBufImpl : public StreamBufBase { + char data[bufferSize]; + WriterF m_writer; + + public: + StreamBufImpl() { + setp( data, data + sizeof(data) ); + } + + ~StreamBufImpl() CATCH_NOEXCEPT { + sync(); + } + + private: + int overflow( int c ) { + sync(); + + if( c != EOF ) { + if( pbase() == epptr() ) + m_writer( std::string( 1, static_cast( c ) ) ); + else + sputc( static_cast( c ) ); + } + return 0; + } + + int sync() { + if( pbase() != pptr() ) { + m_writer( std::string( pbase(), static_cast( pptr() - pbase() ) ) ); + setp( pbase(), epptr() ); + } + return 0; + } + }; + + /////////////////////////////////////////////////////////////////////////// + + FileStream::FileStream( std::string const& filename ) { + m_ofs.open( filename.c_str() ); + if( m_ofs.fail() ) { + std::ostringstream oss; + oss << "Unable to open file: '" << filename << "'"; + throw std::domain_error( oss.str() ); + } + } + + std::ostream& FileStream::stream() const { + return m_ofs; + } + + struct OutputDebugWriter { + + void operator()( std::string const&str ) { + writeToDebugConsole( str ); + } + }; + + DebugOutStream::DebugOutStream() + : m_streamBuf( new StreamBufImpl() ), + m_os( m_streamBuf.get() ) + {} + + std::ostream& DebugOutStream::stream() const { + return m_os; + } + + // Store the streambuf from cout up-front because + // cout may get redirected when running tests + CoutStream::CoutStream() + : m_os( Catch::cout().rdbuf() ) + {} + + std::ostream& CoutStream::stream() const { + return m_os; + } + +#ifndef CATCH_CONFIG_NOSTDOUT // If you #define this you must implement these functions + std::ostream& cout() { + return std::cout; + } + std::ostream& cerr() { + return std::cerr; + } +#endif +} + +namespace Catch { + + class Context : public IMutableContext { + + Context() : m_config( CATCH_NULL ), m_runner( CATCH_NULL ), m_resultCapture( CATCH_NULL ) {} + Context( Context const& ); + void operator=( Context const& ); + + public: // IContext + virtual IResultCapture* getResultCapture() { + return m_resultCapture; + } + virtual IRunner* getRunner() { + return m_runner; + } + virtual size_t getGeneratorIndex( std::string const& fileInfo, size_t totalSize ) { + return getGeneratorsForCurrentTest() + .getGeneratorInfo( fileInfo, totalSize ) + .getCurrentIndex(); + } + virtual bool advanceGeneratorsForCurrentTest() { + IGeneratorsForTest* generators = findGeneratorsForCurrentTest(); + return generators && generators->moveNext(); + } + + virtual Ptr getConfig() const { + return m_config; + } + + public: // IMutableContext + virtual void setResultCapture( IResultCapture* resultCapture ) { + m_resultCapture = resultCapture; + } + virtual void setRunner( IRunner* runner ) { + m_runner = runner; + } + virtual void setConfig( Ptr const& config ) { + m_config = config; + } + + friend IMutableContext& getCurrentMutableContext(); + + private: + IGeneratorsForTest* findGeneratorsForCurrentTest() { + std::string testName = getResultCapture()->getCurrentTestName(); + + std::map::const_iterator it = + m_generatorsByTestName.find( testName ); + return it != m_generatorsByTestName.end() + ? it->second + : CATCH_NULL; + } + + IGeneratorsForTest& getGeneratorsForCurrentTest() { + IGeneratorsForTest* generators = findGeneratorsForCurrentTest(); + if( !generators ) { + std::string testName = getResultCapture()->getCurrentTestName(); + generators = createGeneratorsForTest(); + m_generatorsByTestName.insert( std::make_pair( testName, generators ) ); + } + return *generators; + } + + private: + Ptr m_config; + IRunner* m_runner; + IResultCapture* m_resultCapture; + std::map m_generatorsByTestName; + }; + + namespace { + Context* currentContext = CATCH_NULL; + } + IMutableContext& getCurrentMutableContext() { + if( !currentContext ) + currentContext = new Context(); + return *currentContext; + } + IContext& getCurrentContext() { + return getCurrentMutableContext(); + } + + void cleanUpContext() { + delete currentContext; + currentContext = CATCH_NULL; + } +} + +// #included from: catch_console_colour_impl.hpp +#define TWOBLUECUBES_CATCH_CONSOLE_COLOUR_IMPL_HPP_INCLUDED + +namespace Catch { + namespace { + + struct IColourImpl { + virtual ~IColourImpl() {} + virtual void use( Colour::Code _colourCode ) = 0; + }; + + struct NoColourImpl : IColourImpl { + void use( Colour::Code ) {} + + static IColourImpl* instance() { + static NoColourImpl s_instance; + return &s_instance; + } + }; + + } // anon namespace +} // namespace Catch + +#if !defined( CATCH_CONFIG_COLOUR_NONE ) && !defined( CATCH_CONFIG_COLOUR_WINDOWS ) && !defined( CATCH_CONFIG_COLOUR_ANSI ) +# ifdef CATCH_PLATFORM_WINDOWS +# define CATCH_CONFIG_COLOUR_WINDOWS +# else +# define CATCH_CONFIG_COLOUR_ANSI +# endif +#endif + +#if defined ( CATCH_CONFIG_COLOUR_WINDOWS ) ///////////////////////////////////////// + +#ifndef NOMINMAX +#define NOMINMAX +#endif + +#ifdef __AFXDLL +#include +#else +#include +#endif + +namespace Catch { +namespace { + + class Win32ColourImpl : public IColourImpl { + public: + Win32ColourImpl() : stdoutHandle( GetStdHandle(STD_OUTPUT_HANDLE) ) + { + CONSOLE_SCREEN_BUFFER_INFO csbiInfo; + GetConsoleScreenBufferInfo( stdoutHandle, &csbiInfo ); + originalForegroundAttributes = csbiInfo.wAttributes & ~( BACKGROUND_GREEN | BACKGROUND_RED | BACKGROUND_BLUE | BACKGROUND_INTENSITY ); + originalBackgroundAttributes = csbiInfo.wAttributes & ~( FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE | FOREGROUND_INTENSITY ); + } + + virtual void use( Colour::Code _colourCode ) { + switch( _colourCode ) { + case Colour::None: return setTextAttribute( originalForegroundAttributes ); + case Colour::White: return setTextAttribute( FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE ); + case Colour::Red: return setTextAttribute( FOREGROUND_RED ); + case Colour::Green: return setTextAttribute( FOREGROUND_GREEN ); + case Colour::Blue: return setTextAttribute( FOREGROUND_BLUE ); + case Colour::Cyan: return setTextAttribute( FOREGROUND_BLUE | FOREGROUND_GREEN ); + case Colour::Yellow: return setTextAttribute( FOREGROUND_RED | FOREGROUND_GREEN ); + case Colour::Grey: return setTextAttribute( 0 ); + + case Colour::LightGrey: return setTextAttribute( FOREGROUND_INTENSITY ); + case Colour::BrightRed: return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_RED ); + case Colour::BrightGreen: return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_GREEN ); + case Colour::BrightWhite: return setTextAttribute( FOREGROUND_INTENSITY | FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE ); + + case Colour::Bright: throw std::logic_error( "not a colour" ); + } + } + + private: + void setTextAttribute( WORD _textAttribute ) { + SetConsoleTextAttribute( stdoutHandle, _textAttribute | originalBackgroundAttributes ); + } + HANDLE stdoutHandle; + WORD originalForegroundAttributes; + WORD originalBackgroundAttributes; + }; + + IColourImpl* platformColourInstance() { + static Win32ColourImpl s_instance; + + Ptr config = getCurrentContext().getConfig(); + UseColour::YesOrNo colourMode = config + ? config->useColour() + : UseColour::Auto; + if( colourMode == UseColour::Auto ) + colourMode = !isDebuggerActive() + ? UseColour::Yes + : UseColour::No; + return colourMode == UseColour::Yes + ? &s_instance + : NoColourImpl::instance(); + } + +} // end anon namespace +} // end namespace Catch + +#elif defined( CATCH_CONFIG_COLOUR_ANSI ) ////////////////////////////////////// + +#include + +namespace Catch { +namespace { + + // use POSIX/ ANSI console terminal codes + // Thanks to Adam Strzelecki for original contribution + // (http://github.com/nanoant) + // https://github.com/philsquared/Catch/pull/131 + class PosixColourImpl : public IColourImpl { + public: + virtual void use( Colour::Code _colourCode ) { + switch( _colourCode ) { + case Colour::None: + case Colour::White: return setColour( "[0m" ); + case Colour::Red: return setColour( "[0;31m" ); + case Colour::Green: return setColour( "[0;32m" ); + case Colour::Blue: return setColour( "[0:34m" ); + case Colour::Cyan: return setColour( "[0;36m" ); + case Colour::Yellow: return setColour( "[0;33m" ); + case Colour::Grey: return setColour( "[1;30m" ); + + case Colour::LightGrey: return setColour( "[0;37m" ); + case Colour::BrightRed: return setColour( "[1;31m" ); + case Colour::BrightGreen: return setColour( "[1;32m" ); + case Colour::BrightWhite: return setColour( "[1;37m" ); + + case Colour::Bright: throw std::logic_error( "not a colour" ); + } + } + static IColourImpl* instance() { + static PosixColourImpl s_instance; + return &s_instance; + } + + private: + void setColour( const char* _escapeCode ) { + Catch::cout() << '\033' << _escapeCode; + } + }; + + IColourImpl* platformColourInstance() { + Ptr config = getCurrentContext().getConfig(); + UseColour::YesOrNo colourMode = config + ? config->useColour() + : UseColour::Auto; + if( colourMode == UseColour::Auto ) + colourMode = (!isDebuggerActive() && isatty(STDOUT_FILENO) ) + ? UseColour::Yes + : UseColour::No; + return colourMode == UseColour::Yes + ? PosixColourImpl::instance() + : NoColourImpl::instance(); + } + +} // end anon namespace +} // end namespace Catch + +#else // not Windows or ANSI /////////////////////////////////////////////// + +namespace Catch { + + static IColourImpl* platformColourInstance() { return NoColourImpl::instance(); } + +} // end namespace Catch + +#endif // Windows/ ANSI/ None + +namespace Catch { + + Colour::Colour( Code _colourCode ) : m_moved( false ) { use( _colourCode ); } + Colour::Colour( Colour const& _other ) : m_moved( false ) { const_cast( _other ).m_moved = true; } + Colour::~Colour(){ if( !m_moved ) use( None ); } + + void Colour::use( Code _colourCode ) { + static IColourImpl* impl = platformColourInstance(); + impl->use( _colourCode ); + } + +} // end namespace Catch + +// #included from: catch_generators_impl.hpp +#define TWOBLUECUBES_CATCH_GENERATORS_IMPL_HPP_INCLUDED + +#include +#include +#include + +namespace Catch { + + struct GeneratorInfo : IGeneratorInfo { + + GeneratorInfo( std::size_t size ) + : m_size( size ), + m_currentIndex( 0 ) + {} + + bool moveNext() { + if( ++m_currentIndex == m_size ) { + m_currentIndex = 0; + return false; + } + return true; + } + + std::size_t getCurrentIndex() const { + return m_currentIndex; + } + + std::size_t m_size; + std::size_t m_currentIndex; + }; + + /////////////////////////////////////////////////////////////////////////// + + class GeneratorsForTest : public IGeneratorsForTest { + + public: + ~GeneratorsForTest() { + deleteAll( m_generatorsInOrder ); + } + + IGeneratorInfo& getGeneratorInfo( std::string const& fileInfo, std::size_t size ) { + std::map::const_iterator it = m_generatorsByName.find( fileInfo ); + if( it == m_generatorsByName.end() ) { + IGeneratorInfo* info = new GeneratorInfo( size ); + m_generatorsByName.insert( std::make_pair( fileInfo, info ) ); + m_generatorsInOrder.push_back( info ); + return *info; + } + return *it->second; + } + + bool moveNext() { + std::vector::const_iterator it = m_generatorsInOrder.begin(); + std::vector::const_iterator itEnd = m_generatorsInOrder.end(); + for(; it != itEnd; ++it ) { + if( (*it)->moveNext() ) + return true; + } + return false; + } + + private: + std::map m_generatorsByName; + std::vector m_generatorsInOrder; + }; + + IGeneratorsForTest* createGeneratorsForTest() + { + return new GeneratorsForTest(); + } + +} // end namespace Catch + +// #included from: catch_assertionresult.hpp +#define TWOBLUECUBES_CATCH_ASSERTIONRESULT_HPP_INCLUDED + +namespace Catch { + + AssertionInfo::AssertionInfo( std::string const& _macroName, + SourceLineInfo const& _lineInfo, + std::string const& _capturedExpression, + ResultDisposition::Flags _resultDisposition ) + : macroName( _macroName ), + lineInfo( _lineInfo ), + capturedExpression( _capturedExpression ), + resultDisposition( _resultDisposition ) + {} + + AssertionResult::AssertionResult() {} + + AssertionResult::AssertionResult( AssertionInfo const& info, AssertionResultData const& data ) + : m_info( info ), + m_resultData( data ) + {} + + AssertionResult::~AssertionResult() {} + + // Result was a success + bool AssertionResult::succeeded() const { + return Catch::isOk( m_resultData.resultType ); + } + + // Result was a success, or failure is suppressed + bool AssertionResult::isOk() const { + return Catch::isOk( m_resultData.resultType ) || shouldSuppressFailure( m_info.resultDisposition ); + } + + ResultWas::OfType AssertionResult::getResultType() const { + return m_resultData.resultType; + } + + bool AssertionResult::hasExpression() const { + return !m_info.capturedExpression.empty(); + } + + bool AssertionResult::hasMessage() const { + return !m_resultData.message.empty(); + } + + std::string AssertionResult::getExpression() const { + if( isFalseTest( m_info.resultDisposition ) ) + return "!" + m_info.capturedExpression; + else + return m_info.capturedExpression; + } + std::string AssertionResult::getExpressionInMacro() const { + if( m_info.macroName.empty() ) + return m_info.capturedExpression; + else + return m_info.macroName + "( " + m_info.capturedExpression + " )"; + } + + bool AssertionResult::hasExpandedExpression() const { + return hasExpression() && getExpandedExpression() != getExpression(); + } + + std::string AssertionResult::getExpandedExpression() const { + return m_resultData.reconstructedExpression; + } + + std::string AssertionResult::getMessage() const { + return m_resultData.message; + } + SourceLineInfo AssertionResult::getSourceInfo() const { + return m_info.lineInfo; + } + + std::string AssertionResult::getTestMacroName() const { + return m_info.macroName; + } + +} // end namespace Catch + +// #included from: catch_test_case_info.hpp +#define TWOBLUECUBES_CATCH_TEST_CASE_INFO_HPP_INCLUDED + +namespace Catch { + + inline TestCaseInfo::SpecialProperties parseSpecialTag( std::string const& tag ) { + if( startsWith( tag, "." ) || + tag == "hide" || + tag == "!hide" ) + return TestCaseInfo::IsHidden; + else if( tag == "!throws" ) + return TestCaseInfo::Throws; + else if( tag == "!shouldfail" ) + return TestCaseInfo::ShouldFail; + else if( tag == "!mayfail" ) + return TestCaseInfo::MayFail; + else + return TestCaseInfo::None; + } + inline bool isReservedTag( std::string const& tag ) { + return parseSpecialTag( tag ) == TestCaseInfo::None && tag.size() > 0 && !isalnum( tag[0] ); + } + inline void enforceNotReservedTag( std::string const& tag, SourceLineInfo const& _lineInfo ) { + if( isReservedTag( tag ) ) { + { + Colour colourGuard( Colour::Red ); + Catch::cerr() + << "Tag name [" << tag << "] not allowed.\n" + << "Tag names starting with non alpha-numeric characters are reserved\n"; + } + { + Colour colourGuard( Colour::FileName ); + Catch::cerr() << _lineInfo << std::endl; + } + exit(1); + } + } + + TestCase makeTestCase( ITestCase* _testCase, + std::string const& _className, + std::string const& _name, + std::string const& _descOrTags, + SourceLineInfo const& _lineInfo ) + { + bool isHidden( startsWith( _name, "./" ) ); // Legacy support + + // Parse out tags + std::set tags; + std::string desc, tag; + bool inTag = false; + for( std::size_t i = 0; i < _descOrTags.size(); ++i ) { + char c = _descOrTags[i]; + if( !inTag ) { + if( c == '[' ) + inTag = true; + else + desc += c; + } + else { + if( c == ']' ) { + TestCaseInfo::SpecialProperties prop = parseSpecialTag( tag ); + if( prop == TestCaseInfo::IsHidden ) + isHidden = true; + else if( prop == TestCaseInfo::None ) + enforceNotReservedTag( tag, _lineInfo ); + + tags.insert( tag ); + tag.clear(); + inTag = false; + } + else + tag += c; + } + } + if( isHidden ) { + tags.insert( "hide" ); + tags.insert( "." ); + } + + TestCaseInfo info( _name, _className, desc, tags, _lineInfo ); + return TestCase( _testCase, info ); + } + + void setTags( TestCaseInfo& testCaseInfo, std::set const& tags ) + { + testCaseInfo.tags = tags; + testCaseInfo.lcaseTags.clear(); + + std::ostringstream oss; + for( std::set::const_iterator it = tags.begin(), itEnd = tags.end(); it != itEnd; ++it ) { + oss << "[" << *it << "]"; + std::string lcaseTag = toLower( *it ); + testCaseInfo.properties = static_cast( testCaseInfo.properties | parseSpecialTag( lcaseTag ) ); + testCaseInfo.lcaseTags.insert( lcaseTag ); + } + testCaseInfo.tagsAsString = oss.str(); + } + + TestCaseInfo::TestCaseInfo( std::string const& _name, + std::string const& _className, + std::string const& _description, + std::set const& _tags, + SourceLineInfo const& _lineInfo ) + : name( _name ), + className( _className ), + description( _description ), + lineInfo( _lineInfo ), + properties( None ) + { + setTags( *this, _tags ); + } + + TestCaseInfo::TestCaseInfo( TestCaseInfo const& other ) + : name( other.name ), + className( other.className ), + description( other.description ), + tags( other.tags ), + lcaseTags( other.lcaseTags ), + tagsAsString( other.tagsAsString ), + lineInfo( other.lineInfo ), + properties( other.properties ) + {} + + bool TestCaseInfo::isHidden() const { + return ( properties & IsHidden ) != 0; + } + bool TestCaseInfo::throws() const { + return ( properties & Throws ) != 0; + } + bool TestCaseInfo::okToFail() const { + return ( properties & (ShouldFail | MayFail ) ) != 0; + } + bool TestCaseInfo::expectedToFail() const { + return ( properties & (ShouldFail ) ) != 0; + } + + TestCase::TestCase( ITestCase* testCase, TestCaseInfo const& info ) : TestCaseInfo( info ), test( testCase ) {} + + TestCase::TestCase( TestCase const& other ) + : TestCaseInfo( other ), + test( other.test ) + {} + + TestCase TestCase::withName( std::string const& _newName ) const { + TestCase other( *this ); + other.name = _newName; + return other; + } + + void TestCase::swap( TestCase& other ) { + test.swap( other.test ); + name.swap( other.name ); + className.swap( other.className ); + description.swap( other.description ); + tags.swap( other.tags ); + lcaseTags.swap( other.lcaseTags ); + tagsAsString.swap( other.tagsAsString ); + std::swap( TestCaseInfo::properties, static_cast( other ).properties ); + std::swap( lineInfo, other.lineInfo ); + } + + void TestCase::invoke() const { + test->invoke(); + } + + bool TestCase::operator == ( TestCase const& other ) const { + return test.get() == other.test.get() && + name == other.name && + className == other.className; + } + + bool TestCase::operator < ( TestCase const& other ) const { + return name < other.name; + } + TestCase& TestCase::operator = ( TestCase const& other ) { + TestCase temp( other ); + swap( temp ); + return *this; + } + + TestCaseInfo const& TestCase::getTestCaseInfo() const + { + return *this; + } + +} // end namespace Catch + +// #included from: catch_version.hpp +#define TWOBLUECUBES_CATCH_VERSION_HPP_INCLUDED + +namespace Catch { + + Version::Version + ( unsigned int _majorVersion, + unsigned int _minorVersion, + unsigned int _patchNumber, + std::string const& _branchName, + unsigned int _buildNumber ) + : majorVersion( _majorVersion ), + minorVersion( _minorVersion ), + patchNumber( _patchNumber ), + branchName( _branchName ), + buildNumber( _buildNumber ) + {} + + std::ostream& operator << ( std::ostream& os, Version const& version ) { + os << version.majorVersion << "." + << version.minorVersion << "." + << version.patchNumber; + + if( !version.branchName.empty() ) { + os << "-" << version.branchName + << "." << version.buildNumber; + } + return os; + } + + Version libraryVersion( 1, 5, 6, "", 0 ); + +} + +// #included from: catch_message.hpp +#define TWOBLUECUBES_CATCH_MESSAGE_HPP_INCLUDED + +namespace Catch { + + MessageInfo::MessageInfo( std::string const& _macroName, + SourceLineInfo const& _lineInfo, + ResultWas::OfType _type ) + : macroName( _macroName ), + lineInfo( _lineInfo ), + type( _type ), + sequence( ++globalCount ) + {} + + // This may need protecting if threading support is added + unsigned int MessageInfo::globalCount = 0; + + //////////////////////////////////////////////////////////////////////////// + + ScopedMessage::ScopedMessage( MessageBuilder const& builder ) + : m_info( builder.m_info ) + { + m_info.message = builder.m_stream.str(); + getResultCapture().pushScopedMessage( m_info ); + } + ScopedMessage::ScopedMessage( ScopedMessage const& other ) + : m_info( other.m_info ) + {} + + ScopedMessage::~ScopedMessage() { + getResultCapture().popScopedMessage( m_info ); + } + +} // end namespace Catch + +// #included from: catch_legacy_reporter_adapter.hpp +#define TWOBLUECUBES_CATCH_LEGACY_REPORTER_ADAPTER_HPP_INCLUDED + +// #included from: catch_legacy_reporter_adapter.h +#define TWOBLUECUBES_CATCH_LEGACY_REPORTER_ADAPTER_H_INCLUDED + +namespace Catch +{ + // Deprecated + struct IReporter : IShared { + virtual ~IReporter(); + + virtual bool shouldRedirectStdout() const = 0; + + virtual void StartTesting() = 0; + virtual void EndTesting( Totals const& totals ) = 0; + virtual void StartGroup( std::string const& groupName ) = 0; + virtual void EndGroup( std::string const& groupName, Totals const& totals ) = 0; + virtual void StartTestCase( TestCaseInfo const& testInfo ) = 0; + virtual void EndTestCase( TestCaseInfo const& testInfo, Totals const& totals, std::string const& stdOut, std::string const& stdErr ) = 0; + virtual void StartSection( std::string const& sectionName, std::string const& description ) = 0; + virtual void EndSection( std::string const& sectionName, Counts const& assertions ) = 0; + virtual void NoAssertionsInSection( std::string const& sectionName ) = 0; + virtual void NoAssertionsInTestCase( std::string const& testName ) = 0; + virtual void Aborted() = 0; + virtual void Result( AssertionResult const& result ) = 0; + }; + + class LegacyReporterAdapter : public SharedImpl + { + public: + LegacyReporterAdapter( Ptr const& legacyReporter ); + virtual ~LegacyReporterAdapter(); + + virtual ReporterPreferences getPreferences() const; + virtual void noMatchingTestCases( std::string const& ); + virtual void testRunStarting( TestRunInfo const& ); + virtual void testGroupStarting( GroupInfo const& groupInfo ); + virtual void testCaseStarting( TestCaseInfo const& testInfo ); + virtual void sectionStarting( SectionInfo const& sectionInfo ); + virtual void assertionStarting( AssertionInfo const& ); + virtual bool assertionEnded( AssertionStats const& assertionStats ); + virtual void sectionEnded( SectionStats const& sectionStats ); + virtual void testCaseEnded( TestCaseStats const& testCaseStats ); + virtual void testGroupEnded( TestGroupStats const& testGroupStats ); + virtual void testRunEnded( TestRunStats const& testRunStats ); + virtual void skipTest( TestCaseInfo const& ); + + private: + Ptr m_legacyReporter; + }; +} + +namespace Catch +{ + LegacyReporterAdapter::LegacyReporterAdapter( Ptr const& legacyReporter ) + : m_legacyReporter( legacyReporter ) + {} + LegacyReporterAdapter::~LegacyReporterAdapter() {} + + ReporterPreferences LegacyReporterAdapter::getPreferences() const { + ReporterPreferences prefs; + prefs.shouldRedirectStdOut = m_legacyReporter->shouldRedirectStdout(); + return prefs; + } + + void LegacyReporterAdapter::noMatchingTestCases( std::string const& ) {} + void LegacyReporterAdapter::testRunStarting( TestRunInfo const& ) { + m_legacyReporter->StartTesting(); + } + void LegacyReporterAdapter::testGroupStarting( GroupInfo const& groupInfo ) { + m_legacyReporter->StartGroup( groupInfo.name ); + } + void LegacyReporterAdapter::testCaseStarting( TestCaseInfo const& testInfo ) { + m_legacyReporter->StartTestCase( testInfo ); + } + void LegacyReporterAdapter::sectionStarting( SectionInfo const& sectionInfo ) { + m_legacyReporter->StartSection( sectionInfo.name, sectionInfo.description ); + } + void LegacyReporterAdapter::assertionStarting( AssertionInfo const& ) { + // Not on legacy interface + } + + bool LegacyReporterAdapter::assertionEnded( AssertionStats const& assertionStats ) { + if( assertionStats.assertionResult.getResultType() != ResultWas::Ok ) { + for( std::vector::const_iterator it = assertionStats.infoMessages.begin(), itEnd = assertionStats.infoMessages.end(); + it != itEnd; + ++it ) { + if( it->type == ResultWas::Info ) { + ResultBuilder rb( it->macroName.c_str(), it->lineInfo, "", ResultDisposition::Normal ); + rb << it->message; + rb.setResultType( ResultWas::Info ); + AssertionResult result = rb.build(); + m_legacyReporter->Result( result ); + } + } + } + m_legacyReporter->Result( assertionStats.assertionResult ); + return true; + } + void LegacyReporterAdapter::sectionEnded( SectionStats const& sectionStats ) { + if( sectionStats.missingAssertions ) + m_legacyReporter->NoAssertionsInSection( sectionStats.sectionInfo.name ); + m_legacyReporter->EndSection( sectionStats.sectionInfo.name, sectionStats.assertions ); + } + void LegacyReporterAdapter::testCaseEnded( TestCaseStats const& testCaseStats ) { + m_legacyReporter->EndTestCase + ( testCaseStats.testInfo, + testCaseStats.totals, + testCaseStats.stdOut, + testCaseStats.stdErr ); + } + void LegacyReporterAdapter::testGroupEnded( TestGroupStats const& testGroupStats ) { + if( testGroupStats.aborting ) + m_legacyReporter->Aborted(); + m_legacyReporter->EndGroup( testGroupStats.groupInfo.name, testGroupStats.totals ); + } + void LegacyReporterAdapter::testRunEnded( TestRunStats const& testRunStats ) { + m_legacyReporter->EndTesting( testRunStats.totals ); + } + void LegacyReporterAdapter::skipTest( TestCaseInfo const& ) { + } +} + +// #included from: catch_timer.hpp + +#ifdef __clang__ +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wc++11-long-long" +#endif + +#ifdef CATCH_PLATFORM_WINDOWS +#include +#else +#include +#endif + +namespace Catch { + + namespace { +#ifdef CATCH_PLATFORM_WINDOWS + uint64_t getCurrentTicks() { + static uint64_t hz=0, hzo=0; + if (!hz) { + QueryPerformanceFrequency( reinterpret_cast( &hz ) ); + QueryPerformanceCounter( reinterpret_cast( &hzo ) ); + } + uint64_t t; + QueryPerformanceCounter( reinterpret_cast( &t ) ); + return ((t-hzo)*1000000)/hz; + } +#else + uint64_t getCurrentTicks() { + timeval t; + gettimeofday(&t,CATCH_NULL); + return static_cast( t.tv_sec ) * 1000000ull + static_cast( t.tv_usec ); + } +#endif + } + + void Timer::start() { + m_ticks = getCurrentTicks(); + } + unsigned int Timer::getElapsedMicroseconds() const { + return static_cast(getCurrentTicks() - m_ticks); + } + unsigned int Timer::getElapsedMilliseconds() const { + return static_cast(getElapsedMicroseconds()/1000); + } + double Timer::getElapsedSeconds() const { + return getElapsedMicroseconds()/1000000.0; + } + +} // namespace Catch + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif +// #included from: catch_common.hpp +#define TWOBLUECUBES_CATCH_COMMON_HPP_INCLUDED + +namespace Catch { + + bool startsWith( std::string const& s, std::string const& prefix ) { + return s.size() >= prefix.size() && s.substr( 0, prefix.size() ) == prefix; + } + bool endsWith( std::string const& s, std::string const& suffix ) { + return s.size() >= suffix.size() && s.substr( s.size()-suffix.size(), suffix.size() ) == suffix; + } + bool contains( std::string const& s, std::string const& infix ) { + return s.find( infix ) != std::string::npos; + } + void toLowerInPlace( std::string& s ) { + std::transform( s.begin(), s.end(), s.begin(), ::tolower ); + } + std::string toLower( std::string const& s ) { + std::string lc = s; + toLowerInPlace( lc ); + return lc; + } + std::string trim( std::string const& str ) { + static char const* whitespaceChars = "\n\r\t "; + std::string::size_type start = str.find_first_not_of( whitespaceChars ); + std::string::size_type end = str.find_last_not_of( whitespaceChars ); + + return start != std::string::npos ? str.substr( start, 1+end-start ) : ""; + } + + bool replaceInPlace( std::string& str, std::string const& replaceThis, std::string const& withThis ) { + bool replaced = false; + std::size_t i = str.find( replaceThis ); + while( i != std::string::npos ) { + replaced = true; + str = str.substr( 0, i ) + withThis + str.substr( i+replaceThis.size() ); + if( i < str.size()-withThis.size() ) + i = str.find( replaceThis, i+withThis.size() ); + else + i = std::string::npos; + } + return replaced; + } + + pluralise::pluralise( std::size_t count, std::string const& label ) + : m_count( count ), + m_label( label ) + {} + + std::ostream& operator << ( std::ostream& os, pluralise const& pluraliser ) { + os << pluraliser.m_count << " " << pluraliser.m_label; + if( pluraliser.m_count != 1 ) + os << "s"; + return os; + } + + SourceLineInfo::SourceLineInfo() : line( 0 ){} + SourceLineInfo::SourceLineInfo( char const* _file, std::size_t _line ) + : file( _file ), + line( _line ) + {} + SourceLineInfo::SourceLineInfo( SourceLineInfo const& other ) + : file( other.file ), + line( other.line ) + {} + bool SourceLineInfo::empty() const { + return file.empty(); + } + bool SourceLineInfo::operator == ( SourceLineInfo const& other ) const { + return line == other.line && file == other.file; + } + bool SourceLineInfo::operator < ( SourceLineInfo const& other ) const { + return line < other.line || ( line == other.line && file < other.file ); + } + + void seedRng( IConfig const& config ) { + if( config.rngSeed() != 0 ) + std::srand( config.rngSeed() ); + } + unsigned int rngSeed() { + return getCurrentContext().getConfig()->rngSeed(); + } + + std::ostream& operator << ( std::ostream& os, SourceLineInfo const& info ) { +#ifndef __GNUG__ + os << info.file << "(" << info.line << ")"; +#else + os << info.file << ":" << info.line; +#endif + return os; + } + + void throwLogicError( std::string const& message, SourceLineInfo const& locationInfo ) { + std::ostringstream oss; + oss << locationInfo << ": Internal Catch error: '" << message << "'"; + if( alwaysTrue() ) + throw std::logic_error( oss.str() ); + } +} + +// #included from: catch_section.hpp +#define TWOBLUECUBES_CATCH_SECTION_HPP_INCLUDED + +namespace Catch { + + SectionInfo::SectionInfo + ( SourceLineInfo const& _lineInfo, + std::string const& _name, + std::string const& _description ) + : name( _name ), + description( _description ), + lineInfo( _lineInfo ) + {} + + Section::Section( SectionInfo const& info ) + : m_info( info ), + m_sectionIncluded( getResultCapture().sectionStarted( m_info, m_assertions ) ) + { + m_timer.start(); + } + + Section::~Section() { + if( m_sectionIncluded ) { + SectionEndInfo endInfo( m_info, m_assertions, m_timer.getElapsedSeconds() ); + if( std::uncaught_exception() ) + getResultCapture().sectionEndedEarly( endInfo ); + else + getResultCapture().sectionEnded( endInfo ); + } + } + + // This indicates whether the section should be executed or not + Section::operator bool() const { + return m_sectionIncluded; + } + +} // end namespace Catch + +// #included from: catch_debugger.hpp +#define TWOBLUECUBES_CATCH_DEBUGGER_HPP_INCLUDED + +#include + +#ifdef CATCH_PLATFORM_MAC + + #include + #include + #include + #include + #include + + namespace Catch{ + + // The following function is taken directly from the following technical note: + // http://developer.apple.com/library/mac/#qa/qa2004/qa1361.html + + // Returns true if the current process is being debugged (either + // running under the debugger or has a debugger attached post facto). + bool isDebuggerActive(){ + + int mib[4]; + struct kinfo_proc info; + size_t size; + + // Initialize the flags so that, if sysctl fails for some bizarre + // reason, we get a predictable result. + + info.kp_proc.p_flag = 0; + + // Initialize mib, which tells sysctl the info we want, in this case + // we're looking for information about a specific process ID. + + mib[0] = CTL_KERN; + mib[1] = KERN_PROC; + mib[2] = KERN_PROC_PID; + mib[3] = getpid(); + + // Call sysctl. + + size = sizeof(info); + if( sysctl(mib, sizeof(mib) / sizeof(*mib), &info, &size, CATCH_NULL, 0) != 0 ) { + Catch::cerr() << "\n** Call to sysctl failed - unable to determine if debugger is active **\n" << std::endl; + return false; + } + + // We're being debugged if the P_TRACED flag is set. + + return ( (info.kp_proc.p_flag & P_TRACED) != 0 ); + } + } // namespace Catch + +#elif defined(_MSC_VER) + extern "C" __declspec(dllimport) int __stdcall IsDebuggerPresent(); + namespace Catch { + bool isDebuggerActive() { + return IsDebuggerPresent() != 0; + } + } +#elif defined(__MINGW32__) + extern "C" __declspec(dllimport) int __stdcall IsDebuggerPresent(); + namespace Catch { + bool isDebuggerActive() { + return IsDebuggerPresent() != 0; + } + } +#else + namespace Catch { + inline bool isDebuggerActive() { return false; } + } +#endif // Platform + +#ifdef CATCH_PLATFORM_WINDOWS + extern "C" __declspec(dllimport) void __stdcall OutputDebugStringA( const char* ); + namespace Catch { + void writeToDebugConsole( std::string const& text ) { + ::OutputDebugStringA( text.c_str() ); + } + } +#else + namespace Catch { + void writeToDebugConsole( std::string const& text ) { + // !TBD: Need a version for Mac/ XCode and other IDEs + Catch::cout() << text; + } + } +#endif // Platform + +// #included from: catch_tostring.hpp +#define TWOBLUECUBES_CATCH_TOSTRING_HPP_INCLUDED + +namespace Catch { + +namespace Detail { + + const std::string unprintableString = "{?}"; + + namespace { + const int hexThreshold = 255; + + struct Endianness { + enum Arch { Big, Little }; + + static Arch which() { + union _{ + int asInt; + char asChar[sizeof (int)]; + } u; + + u.asInt = 1; + return ( u.asChar[sizeof(int)-1] == 1 ) ? Big : Little; + } + }; + } + + std::string rawMemoryToString( const void *object, std::size_t size ) + { + // Reverse order for little endian architectures + int i = 0, end = static_cast( size ), inc = 1; + if( Endianness::which() == Endianness::Little ) { + i = end-1; + end = inc = -1; + } + + unsigned char const *bytes = static_cast(object); + std::ostringstream os; + os << "0x" << std::setfill('0') << std::hex; + for( ; i != end; i += inc ) + os << std::setw(2) << static_cast(bytes[i]); + return os.str(); + } +} + +std::string toString( std::string const& value ) { + std::string s = value; + if( getCurrentContext().getConfig()->showInvisibles() ) { + for(size_t i = 0; i < s.size(); ++i ) { + std::string subs; + switch( s[i] ) { + case '\n': subs = "\\n"; break; + case '\t': subs = "\\t"; break; + default: break; + } + if( !subs.empty() ) { + s = s.substr( 0, i ) + subs + s.substr( i+1 ); + ++i; + } + } + } + return "\"" + s + "\""; +} +std::string toString( std::wstring const& value ) { + + std::string s; + s.reserve( value.size() ); + for(size_t i = 0; i < value.size(); ++i ) + s += value[i] <= 0xff ? static_cast( value[i] ) : '?'; + return Catch::toString( s ); +} + +std::string toString( const char* const value ) { + return value ? Catch::toString( std::string( value ) ) : std::string( "{null string}" ); +} + +std::string toString( char* const value ) { + return Catch::toString( static_cast( value ) ); +} + +std::string toString( const wchar_t* const value ) +{ + return value ? Catch::toString( std::wstring(value) ) : std::string( "{null string}" ); +} + +std::string toString( wchar_t* const value ) +{ + return Catch::toString( static_cast( value ) ); +} + +std::string toString( int value ) { + std::ostringstream oss; + oss << value; + if( value > Detail::hexThreshold ) + oss << " (0x" << std::hex << value << ")"; + return oss.str(); +} + +std::string toString( unsigned long value ) { + std::ostringstream oss; + oss << value; + if( value > Detail::hexThreshold ) + oss << " (0x" << std::hex << value << ")"; + return oss.str(); +} + +std::string toString( unsigned int value ) { + return Catch::toString( static_cast( value ) ); +} + +template +std::string fpToString( T value, int precision ) { + std::ostringstream oss; + oss << std::setprecision( precision ) + << std::fixed + << value; + std::string d = oss.str(); + std::size_t i = d.find_last_not_of( '0' ); + if( i != std::string::npos && i != d.size()-1 ) { + if( d[i] == '.' ) + i++; + d = d.substr( 0, i+1 ); + } + return d; +} + +std::string toString( const double value ) { + return fpToString( value, 10 ); +} +std::string toString( const float value ) { + return fpToString( value, 5 ) + "f"; +} + +std::string toString( bool value ) { + return value ? "true" : "false"; +} + +std::string toString( char value ) { + return value < ' ' + ? toString( static_cast( value ) ) + : Detail::makeString( value ); +} + +std::string toString( signed char value ) { + return toString( static_cast( value ) ); +} + +std::string toString( unsigned char value ) { + return toString( static_cast( value ) ); +} + +#ifdef CATCH_CONFIG_CPP11_LONG_LONG +std::string toString( long long value ) { + std::ostringstream oss; + oss << value; + if( value > Detail::hexThreshold ) + oss << " (0x" << std::hex << value << ")"; + return oss.str(); +} +std::string toString( unsigned long long value ) { + std::ostringstream oss; + oss << value; + if( value > Detail::hexThreshold ) + oss << " (0x" << std::hex << value << ")"; + return oss.str(); +} +#endif + +#ifdef CATCH_CONFIG_CPP11_NULLPTR +std::string toString( std::nullptr_t ) { + return "nullptr"; +} +#endif + +#ifdef __OBJC__ + std::string toString( NSString const * const& nsstring ) { + if( !nsstring ) + return "nil"; + return "@" + toString([nsstring UTF8String]); + } + std::string toString( NSString * CATCH_ARC_STRONG const& nsstring ) { + if( !nsstring ) + return "nil"; + return "@" + toString([nsstring UTF8String]); + } + std::string toString( NSObject* const& nsObject ) { + return toString( [nsObject description] ); + } +#endif + +} // end namespace Catch + +// #included from: catch_result_builder.hpp +#define TWOBLUECUBES_CATCH_RESULT_BUILDER_HPP_INCLUDED + +namespace Catch { + + std::string capturedExpressionWithSecondArgument( std::string const& capturedExpression, std::string const& secondArg ) { + return secondArg.empty() || secondArg == "\"\"" + ? capturedExpression + : capturedExpression + ", " + secondArg; + } + ResultBuilder::ResultBuilder( char const* macroName, + SourceLineInfo const& lineInfo, + char const* capturedExpression, + ResultDisposition::Flags resultDisposition, + char const* secondArg ) + : m_assertionInfo( macroName, lineInfo, capturedExpressionWithSecondArgument( capturedExpression, secondArg ), resultDisposition ), + m_shouldDebugBreak( false ), + m_shouldThrow( false ) + {} + + ResultBuilder& ResultBuilder::setResultType( ResultWas::OfType result ) { + m_data.resultType = result; + return *this; + } + ResultBuilder& ResultBuilder::setResultType( bool result ) { + m_data.resultType = result ? ResultWas::Ok : ResultWas::ExpressionFailed; + return *this; + } + ResultBuilder& ResultBuilder::setLhs( std::string const& lhs ) { + m_exprComponents.lhs = lhs; + return *this; + } + ResultBuilder& ResultBuilder::setRhs( std::string const& rhs ) { + m_exprComponents.rhs = rhs; + return *this; + } + ResultBuilder& ResultBuilder::setOp( std::string const& op ) { + m_exprComponents.op = op; + return *this; + } + + void ResultBuilder::endExpression() { + m_exprComponents.testFalse = isFalseTest( m_assertionInfo.resultDisposition ); + captureExpression(); + } + + void ResultBuilder::useActiveException( ResultDisposition::Flags resultDisposition ) { + m_assertionInfo.resultDisposition = resultDisposition; + m_stream.oss << Catch::translateActiveException(); + captureResult( ResultWas::ThrewException ); + } + + void ResultBuilder::captureResult( ResultWas::OfType resultType ) { + setResultType( resultType ); + captureExpression(); + } + void ResultBuilder::captureExpectedException( std::string const& expectedMessage ) { + if( expectedMessage.empty() ) + captureExpectedException( Matchers::Impl::Generic::AllOf() ); + else + captureExpectedException( Matchers::Equals( expectedMessage ) ); + } + + void ResultBuilder::captureExpectedException( Matchers::Impl::Matcher const& matcher ) { + + assert( m_exprComponents.testFalse == false ); + AssertionResultData data = m_data; + data.resultType = ResultWas::Ok; + data.reconstructedExpression = m_assertionInfo.capturedExpression; + + std::string actualMessage = Catch::translateActiveException(); + if( !matcher.match( actualMessage ) ) { + data.resultType = ResultWas::ExpressionFailed; + data.reconstructedExpression = actualMessage; + } + AssertionResult result( m_assertionInfo, data ); + handleResult( result ); + } + + void ResultBuilder::captureExpression() { + AssertionResult result = build(); + handleResult( result ); + } + void ResultBuilder::handleResult( AssertionResult const& result ) + { + getResultCapture().assertionEnded( result ); + + if( !result.isOk() ) { + if( getCurrentContext().getConfig()->shouldDebugBreak() ) + m_shouldDebugBreak = true; + if( getCurrentContext().getRunner()->aborting() || (m_assertionInfo.resultDisposition & ResultDisposition::Normal) ) + m_shouldThrow = true; + } + } + void ResultBuilder::react() { + if( m_shouldThrow ) + throw Catch::TestFailureException(); + } + + bool ResultBuilder::shouldDebugBreak() const { return m_shouldDebugBreak; } + bool ResultBuilder::allowThrows() const { return getCurrentContext().getConfig()->allowThrows(); } + + AssertionResult ResultBuilder::build() const + { + assert( m_data.resultType != ResultWas::Unknown ); + + AssertionResultData data = m_data; + + // Flip bool results if testFalse is set + if( m_exprComponents.testFalse ) { + if( data.resultType == ResultWas::Ok ) + data.resultType = ResultWas::ExpressionFailed; + else if( data.resultType == ResultWas::ExpressionFailed ) + data.resultType = ResultWas::Ok; + } + + data.message = m_stream.oss.str(); + data.reconstructedExpression = reconstructExpression(); + if( m_exprComponents.testFalse ) { + if( m_exprComponents.op == "" ) + data.reconstructedExpression = "!" + data.reconstructedExpression; + else + data.reconstructedExpression = "!(" + data.reconstructedExpression + ")"; + } + return AssertionResult( m_assertionInfo, data ); + } + std::string ResultBuilder::reconstructExpression() const { + if( m_exprComponents.op == "" ) + return m_exprComponents.lhs.empty() ? m_assertionInfo.capturedExpression : m_exprComponents.op + m_exprComponents.lhs; + else if( m_exprComponents.op == "matches" ) + return m_exprComponents.lhs + " " + m_exprComponents.rhs; + else if( m_exprComponents.op != "!" ) { + if( m_exprComponents.lhs.size() + m_exprComponents.rhs.size() < 40 && + m_exprComponents.lhs.find("\n") == std::string::npos && + m_exprComponents.rhs.find("\n") == std::string::npos ) + return m_exprComponents.lhs + " " + m_exprComponents.op + " " + m_exprComponents.rhs; + else + return m_exprComponents.lhs + "\n" + m_exprComponents.op + "\n" + m_exprComponents.rhs; + } + else + return "{can't expand - use " + m_assertionInfo.macroName + "_FALSE( " + m_assertionInfo.capturedExpression.substr(1) + " ) instead of " + m_assertionInfo.macroName + "( " + m_assertionInfo.capturedExpression + " ) for better diagnostics}"; + } + +} // end namespace Catch + +// #included from: catch_tag_alias_registry.hpp +#define TWOBLUECUBES_CATCH_TAG_ALIAS_REGISTRY_HPP_INCLUDED + +// #included from: catch_tag_alias_registry.h +#define TWOBLUECUBES_CATCH_TAG_ALIAS_REGISTRY_H_INCLUDED + +#include + +namespace Catch { + + class TagAliasRegistry : public ITagAliasRegistry { + public: + virtual ~TagAliasRegistry(); + virtual Option find( std::string const& alias ) const; + virtual std::string expandAliases( std::string const& unexpandedTestSpec ) const; + void add( char const* alias, char const* tag, SourceLineInfo const& lineInfo ); + static TagAliasRegistry& get(); + + private: + std::map m_registry; + }; + +} // end namespace Catch + +#include +#include + +namespace Catch { + + TagAliasRegistry::~TagAliasRegistry() {} + + Option TagAliasRegistry::find( std::string const& alias ) const { + std::map::const_iterator it = m_registry.find( alias ); + if( it != m_registry.end() ) + return it->second; + else + return Option(); + } + + std::string TagAliasRegistry::expandAliases( std::string const& unexpandedTestSpec ) const { + std::string expandedTestSpec = unexpandedTestSpec; + for( std::map::const_iterator it = m_registry.begin(), itEnd = m_registry.end(); + it != itEnd; + ++it ) { + std::size_t pos = expandedTestSpec.find( it->first ); + if( pos != std::string::npos ) { + expandedTestSpec = expandedTestSpec.substr( 0, pos ) + + it->second.tag + + expandedTestSpec.substr( pos + it->first.size() ); + } + } + return expandedTestSpec; + } + + void TagAliasRegistry::add( char const* alias, char const* tag, SourceLineInfo const& lineInfo ) { + + if( !startsWith( alias, "[@" ) || !endsWith( alias, "]" ) ) { + std::ostringstream oss; + oss << "error: tag alias, \"" << alias << "\" is not of the form [@alias name].\n" << lineInfo; + throw std::domain_error( oss.str().c_str() ); + } + if( !m_registry.insert( std::make_pair( alias, TagAlias( tag, lineInfo ) ) ).second ) { + std::ostringstream oss; + oss << "error: tag alias, \"" << alias << "\" already registered.\n" + << "\tFirst seen at " << find(alias)->lineInfo << "\n" + << "\tRedefined at " << lineInfo; + throw std::domain_error( oss.str().c_str() ); + } + } + + TagAliasRegistry& TagAliasRegistry::get() { + static TagAliasRegistry instance; + return instance; + + } + + ITagAliasRegistry::~ITagAliasRegistry() {} + ITagAliasRegistry const& ITagAliasRegistry::get() { return TagAliasRegistry::get(); } + + RegistrarForTagAliases::RegistrarForTagAliases( char const* alias, char const* tag, SourceLineInfo const& lineInfo ) { + try { + TagAliasRegistry::get().add( alias, tag, lineInfo ); + } + catch( std::exception& ex ) { + Colour colourGuard( Colour::Red ); + Catch::cerr() << ex.what() << std::endl; + exit(1); + } + } + +} // end namespace Catch + +// #included from: ../reporters/catch_reporter_multi.hpp +#define TWOBLUECUBES_CATCH_REPORTER_MULTI_HPP_INCLUDED + +namespace Catch { + +class MultipleReporters : public SharedImpl { + typedef std::vector > Reporters; + Reporters m_reporters; + +public: + void add( Ptr const& reporter ) { + m_reporters.push_back( reporter ); + } + +public: // IStreamingReporter + + virtual ReporterPreferences getPreferences() const CATCH_OVERRIDE { + return m_reporters[0]->getPreferences(); + } + + virtual void noMatchingTestCases( std::string const& spec ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->noMatchingTestCases( spec ); + } + + virtual void testRunStarting( TestRunInfo const& testRunInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testRunStarting( testRunInfo ); + } + + virtual void testGroupStarting( GroupInfo const& groupInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testGroupStarting( groupInfo ); + } + + virtual void testCaseStarting( TestCaseInfo const& testInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testCaseStarting( testInfo ); + } + + virtual void sectionStarting( SectionInfo const& sectionInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->sectionStarting( sectionInfo ); + } + + virtual void assertionStarting( AssertionInfo const& assertionInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->assertionStarting( assertionInfo ); + } + + // The return value indicates if the messages buffer should be cleared: + virtual bool assertionEnded( AssertionStats const& assertionStats ) CATCH_OVERRIDE { + bool clearBuffer = false; + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + clearBuffer |= (*it)->assertionEnded( assertionStats ); + return clearBuffer; + } + + virtual void sectionEnded( SectionStats const& sectionStats ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->sectionEnded( sectionStats ); + } + + virtual void testCaseEnded( TestCaseStats const& testCaseStats ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testCaseEnded( testCaseStats ); + } + + virtual void testGroupEnded( TestGroupStats const& testGroupStats ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testGroupEnded( testGroupStats ); + } + + virtual void testRunEnded( TestRunStats const& testRunStats ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->testRunEnded( testRunStats ); + } + + virtual void skipTest( TestCaseInfo const& testInfo ) CATCH_OVERRIDE { + for( Reporters::const_iterator it = m_reporters.begin(), itEnd = m_reporters.end(); + it != itEnd; + ++it ) + (*it)->skipTest( testInfo ); + } + + virtual MultipleReporters* tryAsMulti() CATCH_OVERRIDE { + return this; + } + +}; + +Ptr addReporter( Ptr const& existingReporter, Ptr const& additionalReporter ) { + Ptr resultingReporter; + + if( existingReporter ) { + MultipleReporters* multi = existingReporter->tryAsMulti(); + if( !multi ) { + multi = new MultipleReporters; + resultingReporter = Ptr( multi ); + if( existingReporter ) + multi->add( existingReporter ); + } + else + resultingReporter = existingReporter; + multi->add( additionalReporter ); + } + else + resultingReporter = additionalReporter; + + return resultingReporter; +} + +} // end namespace Catch + +// #included from: ../reporters/catch_reporter_xml.hpp +#define TWOBLUECUBES_CATCH_REPORTER_XML_HPP_INCLUDED + +// #included from: catch_reporter_bases.hpp +#define TWOBLUECUBES_CATCH_REPORTER_BASES_HPP_INCLUDED + +#include + +namespace Catch { + + struct StreamingReporterBase : SharedImpl { + + StreamingReporterBase( ReporterConfig const& _config ) + : m_config( _config.fullConfig() ), + stream( _config.stream() ) + { + m_reporterPrefs.shouldRedirectStdOut = false; + } + + virtual ReporterPreferences getPreferences() const CATCH_OVERRIDE { + return m_reporterPrefs; + } + + virtual ~StreamingReporterBase() CATCH_OVERRIDE; + + virtual void noMatchingTestCases( std::string const& ) CATCH_OVERRIDE {} + + virtual void testRunStarting( TestRunInfo const& _testRunInfo ) CATCH_OVERRIDE { + currentTestRunInfo = _testRunInfo; + } + virtual void testGroupStarting( GroupInfo const& _groupInfo ) CATCH_OVERRIDE { + currentGroupInfo = _groupInfo; + } + + virtual void testCaseStarting( TestCaseInfo const& _testInfo ) CATCH_OVERRIDE { + currentTestCaseInfo = _testInfo; + } + virtual void sectionStarting( SectionInfo const& _sectionInfo ) CATCH_OVERRIDE { + m_sectionStack.push_back( _sectionInfo ); + } + + virtual void sectionEnded( SectionStats const& /* _sectionStats */ ) CATCH_OVERRIDE { + m_sectionStack.pop_back(); + } + virtual void testCaseEnded( TestCaseStats const& /* _testCaseStats */ ) CATCH_OVERRIDE { + currentTestCaseInfo.reset(); + } + virtual void testGroupEnded( TestGroupStats const& /* _testGroupStats */ ) CATCH_OVERRIDE { + currentGroupInfo.reset(); + } + virtual void testRunEnded( TestRunStats const& /* _testRunStats */ ) CATCH_OVERRIDE { + currentTestCaseInfo.reset(); + currentGroupInfo.reset(); + currentTestRunInfo.reset(); + } + + virtual void skipTest( TestCaseInfo const& ) CATCH_OVERRIDE { + // Don't do anything with this by default. + // It can optionally be overridden in the derived class. + } + + Ptr m_config; + std::ostream& stream; + + LazyStat currentTestRunInfo; + LazyStat currentGroupInfo; + LazyStat currentTestCaseInfo; + + std::vector m_sectionStack; + ReporterPreferences m_reporterPrefs; + }; + + struct CumulativeReporterBase : SharedImpl { + template + struct Node : SharedImpl<> { + explicit Node( T const& _value ) : value( _value ) {} + virtual ~Node() {} + + typedef std::vector > ChildNodes; + T value; + ChildNodes children; + }; + struct SectionNode : SharedImpl<> { + explicit SectionNode( SectionStats const& _stats ) : stats( _stats ) {} + virtual ~SectionNode(); + + bool operator == ( SectionNode const& other ) const { + return stats.sectionInfo.lineInfo == other.stats.sectionInfo.lineInfo; + } + bool operator == ( Ptr const& other ) const { + return operator==( *other ); + } + + SectionStats stats; + typedef std::vector > ChildSections; + typedef std::vector Assertions; + ChildSections childSections; + Assertions assertions; + std::string stdOut; + std::string stdErr; + }; + + struct BySectionInfo { + BySectionInfo( SectionInfo const& other ) : m_other( other ) {} + BySectionInfo( BySectionInfo const& other ) : m_other( other.m_other ) {} + bool operator() ( Ptr const& node ) const { + return node->stats.sectionInfo.lineInfo == m_other.lineInfo; + } + private: + void operator=( BySectionInfo const& ); + SectionInfo const& m_other; + }; + + typedef Node TestCaseNode; + typedef Node TestGroupNode; + typedef Node TestRunNode; + + CumulativeReporterBase( ReporterConfig const& _config ) + : m_config( _config.fullConfig() ), + stream( _config.stream() ) + { + m_reporterPrefs.shouldRedirectStdOut = false; + } + ~CumulativeReporterBase(); + + virtual ReporterPreferences getPreferences() const CATCH_OVERRIDE { + return m_reporterPrefs; + } + + virtual void testRunStarting( TestRunInfo const& ) CATCH_OVERRIDE {} + virtual void testGroupStarting( GroupInfo const& ) CATCH_OVERRIDE {} + + virtual void testCaseStarting( TestCaseInfo const& ) CATCH_OVERRIDE {} + + virtual void sectionStarting( SectionInfo const& sectionInfo ) CATCH_OVERRIDE { + SectionStats incompleteStats( sectionInfo, Counts(), 0, false ); + Ptr node; + if( m_sectionStack.empty() ) { + if( !m_rootSection ) + m_rootSection = new SectionNode( incompleteStats ); + node = m_rootSection; + } + else { + SectionNode& parentNode = *m_sectionStack.back(); + SectionNode::ChildSections::const_iterator it = + std::find_if( parentNode.childSections.begin(), + parentNode.childSections.end(), + BySectionInfo( sectionInfo ) ); + if( it == parentNode.childSections.end() ) { + node = new SectionNode( incompleteStats ); + parentNode.childSections.push_back( node ); + } + else + node = *it; + } + m_sectionStack.push_back( node ); + m_deepestSection = node; + } + + virtual void assertionStarting( AssertionInfo const& ) CATCH_OVERRIDE {} + + virtual bool assertionEnded( AssertionStats const& assertionStats ) CATCH_OVERRIDE { + assert( !m_sectionStack.empty() ); + SectionNode& sectionNode = *m_sectionStack.back(); + sectionNode.assertions.push_back( assertionStats ); + return true; + } + virtual void sectionEnded( SectionStats const& sectionStats ) CATCH_OVERRIDE { + assert( !m_sectionStack.empty() ); + SectionNode& node = *m_sectionStack.back(); + node.stats = sectionStats; + m_sectionStack.pop_back(); + } + virtual void testCaseEnded( TestCaseStats const& testCaseStats ) CATCH_OVERRIDE { + Ptr node = new TestCaseNode( testCaseStats ); + assert( m_sectionStack.size() == 0 ); + node->children.push_back( m_rootSection ); + m_testCases.push_back( node ); + m_rootSection.reset(); + + assert( m_deepestSection ); + m_deepestSection->stdOut = testCaseStats.stdOut; + m_deepestSection->stdErr = testCaseStats.stdErr; + } + virtual void testGroupEnded( TestGroupStats const& testGroupStats ) CATCH_OVERRIDE { + Ptr node = new TestGroupNode( testGroupStats ); + node->children.swap( m_testCases ); + m_testGroups.push_back( node ); + } + virtual void testRunEnded( TestRunStats const& testRunStats ) CATCH_OVERRIDE { + Ptr node = new TestRunNode( testRunStats ); + node->children.swap( m_testGroups ); + m_testRuns.push_back( node ); + testRunEndedCumulative(); + } + virtual void testRunEndedCumulative() = 0; + + virtual void skipTest( TestCaseInfo const& ) CATCH_OVERRIDE {} + + Ptr m_config; + std::ostream& stream; + std::vector m_assertions; + std::vector > > m_sections; + std::vector > m_testCases; + std::vector > m_testGroups; + + std::vector > m_testRuns; + + Ptr m_rootSection; + Ptr m_deepestSection; + std::vector > m_sectionStack; + ReporterPreferences m_reporterPrefs; + + }; + + template + char const* getLineOfChars() { + static char line[CATCH_CONFIG_CONSOLE_WIDTH] = {0}; + if( !*line ) { + memset( line, C, CATCH_CONFIG_CONSOLE_WIDTH-1 ); + line[CATCH_CONFIG_CONSOLE_WIDTH-1] = 0; + } + return line; + } + + struct TestEventListenerBase : StreamingReporterBase { + TestEventListenerBase( ReporterConfig const& _config ) + : StreamingReporterBase( _config ) + {} + + virtual void assertionStarting( AssertionInfo const& ) CATCH_OVERRIDE {} + virtual bool assertionEnded( AssertionStats const& ) CATCH_OVERRIDE { + return false; + } + }; + +} // end namespace Catch + +// #included from: ../internal/catch_reporter_registrars.hpp +#define TWOBLUECUBES_CATCH_REPORTER_REGISTRARS_HPP_INCLUDED + +namespace Catch { + + template + class LegacyReporterRegistrar { + + class ReporterFactory : public IReporterFactory { + virtual IStreamingReporter* create( ReporterConfig const& config ) const { + return new LegacyReporterAdapter( new T( config ) ); + } + + virtual std::string getDescription() const { + return T::getDescription(); + } + }; + + public: + + LegacyReporterRegistrar( std::string const& name ) { + getMutableRegistryHub().registerReporter( name, new ReporterFactory() ); + } + }; + + template + class ReporterRegistrar { + + class ReporterFactory : public SharedImpl { + + // *** Please Note ***: + // - If you end up here looking at a compiler error because it's trying to register + // your custom reporter class be aware that the native reporter interface has changed + // to IStreamingReporter. The "legacy" interface, IReporter, is still supported via + // an adapter. Just use REGISTER_LEGACY_REPORTER to take advantage of the adapter. + // However please consider updating to the new interface as the old one is now + // deprecated and will probably be removed quite soon! + // Please contact me via github if you have any questions at all about this. + // In fact, ideally, please contact me anyway to let me know you've hit this - as I have + // no idea who is actually using custom reporters at all (possibly no-one!). + // The new interface is designed to minimise exposure to interface changes in the future. + virtual IStreamingReporter* create( ReporterConfig const& config ) const { + return new T( config ); + } + + virtual std::string getDescription() const { + return T::getDescription(); + } + }; + + public: + + ReporterRegistrar( std::string const& name ) { + getMutableRegistryHub().registerReporter( name, new ReporterFactory() ); + } + }; + + template + class ListenerRegistrar { + + class ListenerFactory : public SharedImpl { + + virtual IStreamingReporter* create( ReporterConfig const& config ) const { + return new T( config ); + } + virtual std::string getDescription() const { + return ""; + } + }; + + public: + + ListenerRegistrar() { + getMutableRegistryHub().registerListener( new ListenerFactory() ); + } + }; +} + +#define INTERNAL_CATCH_REGISTER_LEGACY_REPORTER( name, reporterType ) \ + namespace{ Catch::LegacyReporterRegistrar catch_internal_RegistrarFor##reporterType( name ); } + +#define INTERNAL_CATCH_REGISTER_REPORTER( name, reporterType ) \ + namespace{ Catch::ReporterRegistrar catch_internal_RegistrarFor##reporterType( name ); } + +#define INTERNAL_CATCH_REGISTER_LISTENER( listenerType ) \ + namespace{ Catch::ListenerRegistrar catch_internal_RegistrarFor##listenerType; } + +// #included from: ../internal/catch_xmlwriter.hpp +#define TWOBLUECUBES_CATCH_XMLWRITER_HPP_INCLUDED + +#include +#include +#include +#include + +namespace Catch { + + class XmlEncode { + public: + enum ForWhat { ForTextNodes, ForAttributes }; + + XmlEncode( std::string const& str, ForWhat forWhat = ForTextNodes ) + : m_str( str ), + m_forWhat( forWhat ) + {} + + void encodeTo( std::ostream& os ) const { + + // Apostrophe escaping not necessary if we always use " to write attributes + // (see: http://www.w3.org/TR/xml/#syntax) + + for( std::size_t i = 0; i < m_str.size(); ++ i ) { + char c = m_str[i]; + switch( c ) { + case '<': os << "<"; break; + case '&': os << "&"; break; + + case '>': + // See: http://www.w3.org/TR/xml/#syntax + if( i > 2 && m_str[i-1] == ']' && m_str[i-2] == ']' ) + os << ">"; + else + os << c; + break; + + case '\"': + if( m_forWhat == ForAttributes ) + os << """; + else + os << c; + break; + + default: + // Escape control chars - based on contribution by @espenalb in PR #465 + if ( ( c < '\x09' ) || ( c > '\x0D' && c < '\x20') || c=='\x7F' ) + os << "&#x" << std::uppercase << std::hex << static_cast( c ); + else + os << c; + } + } + } + + friend std::ostream& operator << ( std::ostream& os, XmlEncode const& xmlEncode ) { + xmlEncode.encodeTo( os ); + return os; + } + + private: + std::string m_str; + ForWhat m_forWhat; + }; + + class XmlWriter { + public: + + class ScopedElement { + public: + ScopedElement( XmlWriter* writer ) + : m_writer( writer ) + {} + + ScopedElement( ScopedElement const& other ) + : m_writer( other.m_writer ){ + other.m_writer = CATCH_NULL; + } + + ~ScopedElement() { + if( m_writer ) + m_writer->endElement(); + } + + ScopedElement& writeText( std::string const& text, bool indent = true ) { + m_writer->writeText( text, indent ); + return *this; + } + + template + ScopedElement& writeAttribute( std::string const& name, T const& attribute ) { + m_writer->writeAttribute( name, attribute ); + return *this; + } + + private: + mutable XmlWriter* m_writer; + }; + + XmlWriter() + : m_tagIsOpen( false ), + m_needsNewline( false ), + m_os( &Catch::cout() ) + {} + + XmlWriter( std::ostream& os ) + : m_tagIsOpen( false ), + m_needsNewline( false ), + m_os( &os ) + {} + + ~XmlWriter() { + while( !m_tags.empty() ) + endElement(); + } + + XmlWriter& startElement( std::string const& name ) { + ensureTagClosed(); + newlineIfNecessary(); + stream() << m_indent << "<" << name; + m_tags.push_back( name ); + m_indent += " "; + m_tagIsOpen = true; + return *this; + } + + ScopedElement scopedElement( std::string const& name ) { + ScopedElement scoped( this ); + startElement( name ); + return scoped; + } + + XmlWriter& endElement() { + newlineIfNecessary(); + m_indent = m_indent.substr( 0, m_indent.size()-2 ); + if( m_tagIsOpen ) { + stream() << "/>\n"; + m_tagIsOpen = false; + } + else { + stream() << m_indent << "\n"; + } + m_tags.pop_back(); + return *this; + } + + XmlWriter& writeAttribute( std::string const& name, std::string const& attribute ) { + if( !name.empty() && !attribute.empty() ) + stream() << " " << name << "=\"" << XmlEncode( attribute, XmlEncode::ForAttributes ) << "\""; + return *this; + } + + XmlWriter& writeAttribute( std::string const& name, bool attribute ) { + stream() << " " << name << "=\"" << ( attribute ? "true" : "false" ) << "\""; + return *this; + } + + template + XmlWriter& writeAttribute( std::string const& name, T const& attribute ) { + std::ostringstream oss; + oss << attribute; + return writeAttribute( name, oss.str() ); + } + + XmlWriter& writeText( std::string const& text, bool indent = true ) { + if( !text.empty() ){ + bool tagWasOpen = m_tagIsOpen; + ensureTagClosed(); + if( tagWasOpen && indent ) + stream() << m_indent; + stream() << XmlEncode( text ); + m_needsNewline = true; + } + return *this; + } + + XmlWriter& writeComment( std::string const& text ) { + ensureTagClosed(); + stream() << m_indent << ""; + m_needsNewline = true; + return *this; + } + + XmlWriter& writeBlankLine() { + ensureTagClosed(); + stream() << "\n"; + return *this; + } + + void setStream( std::ostream& os ) { + m_os = &os; + } + + private: + XmlWriter( XmlWriter const& ); + void operator=( XmlWriter const& ); + + std::ostream& stream() { + return *m_os; + } + + void ensureTagClosed() { + if( m_tagIsOpen ) { + stream() << ">\n"; + m_tagIsOpen = false; + } + } + + void newlineIfNecessary() { + if( m_needsNewline ) { + stream() << "\n"; + m_needsNewline = false; + } + } + + bool m_tagIsOpen; + bool m_needsNewline; + std::vector m_tags; + std::string m_indent; + std::ostream* m_os; + }; + +} +// #included from: catch_reenable_warnings.h + +#define TWOBLUECUBES_CATCH_REENABLE_WARNINGS_H_INCLUDED + +#ifdef __clang__ +# ifdef __ICC // icpc defines the __clang__ macro +# pragma warning(pop) +# else +# pragma clang diagnostic pop +# endif +#elif defined __GNUC__ +# pragma GCC diagnostic pop +#endif + + +namespace Catch { + class XmlReporter : public StreamingReporterBase { + public: + XmlReporter( ReporterConfig const& _config ) + : StreamingReporterBase( _config ), + m_sectionDepth( 0 ) + { + m_reporterPrefs.shouldRedirectStdOut = true; + } + + virtual ~XmlReporter() CATCH_OVERRIDE; + + static std::string getDescription() { + return "Reports test results as an XML document"; + } + + public: // StreamingReporterBase + + virtual void noMatchingTestCases( std::string const& s ) CATCH_OVERRIDE { + StreamingReporterBase::noMatchingTestCases( s ); + } + + virtual void testRunStarting( TestRunInfo const& testInfo ) CATCH_OVERRIDE { + StreamingReporterBase::testRunStarting( testInfo ); + m_xml.setStream( stream ); + m_xml.startElement( "Catch" ); + if( !m_config->name().empty() ) + m_xml.writeAttribute( "name", m_config->name() ); + } + + virtual void testGroupStarting( GroupInfo const& groupInfo ) CATCH_OVERRIDE { + StreamingReporterBase::testGroupStarting( groupInfo ); + m_xml.startElement( "Group" ) + .writeAttribute( "name", groupInfo.name ); + } + + virtual void testCaseStarting( TestCaseInfo const& testInfo ) CATCH_OVERRIDE { + StreamingReporterBase::testCaseStarting(testInfo); + m_xml.startElement( "TestCase" ).writeAttribute( "name", trim( testInfo.name ) ); + + if ( m_config->showDurations() == ShowDurations::Always ) + m_testCaseTimer.start(); + } + + virtual void sectionStarting( SectionInfo const& sectionInfo ) CATCH_OVERRIDE { + StreamingReporterBase::sectionStarting( sectionInfo ); + if( m_sectionDepth++ > 0 ) { + m_xml.startElement( "Section" ) + .writeAttribute( "name", trim( sectionInfo.name ) ) + .writeAttribute( "description", sectionInfo.description ); + } + } + + virtual void assertionStarting( AssertionInfo const& ) CATCH_OVERRIDE { } + + virtual bool assertionEnded( AssertionStats const& assertionStats ) CATCH_OVERRIDE { + const AssertionResult& assertionResult = assertionStats.assertionResult; + + // Print any info messages in tags. + if( assertionStats.assertionResult.getResultType() != ResultWas::Ok ) { + for( std::vector::const_iterator it = assertionStats.infoMessages.begin(), itEnd = assertionStats.infoMessages.end(); + it != itEnd; + ++it ) { + if( it->type == ResultWas::Info ) { + m_xml.scopedElement( "Info" ) + .writeText( it->message ); + } else if ( it->type == ResultWas::Warning ) { + m_xml.scopedElement( "Warning" ) + .writeText( it->message ); + } + } + } + + // Drop out if result was successful but we're not printing them. + if( !m_config->includeSuccessfulResults() && isOk(assertionResult.getResultType()) ) + return true; + + // Print the expression if there is one. + if( assertionResult.hasExpression() ) { + m_xml.startElement( "Expression" ) + .writeAttribute( "success", assertionResult.succeeded() ) + .writeAttribute( "type", assertionResult.getTestMacroName() ) + .writeAttribute( "filename", assertionResult.getSourceInfo().file ) + .writeAttribute( "line", assertionResult.getSourceInfo().line ); + + m_xml.scopedElement( "Original" ) + .writeText( assertionResult.getExpression() ); + m_xml.scopedElement( "Expanded" ) + .writeText( assertionResult.getExpandedExpression() ); + } + + // And... Print a result applicable to each result type. + switch( assertionResult.getResultType() ) { + case ResultWas::ThrewException: + m_xml.scopedElement( "Exception" ) + .writeAttribute( "filename", assertionResult.getSourceInfo().file ) + .writeAttribute( "line", assertionResult.getSourceInfo().line ) + .writeText( assertionResult.getMessage() ); + break; + case ResultWas::FatalErrorCondition: + m_xml.scopedElement( "Fatal Error Condition" ) + .writeAttribute( "filename", assertionResult.getSourceInfo().file ) + .writeAttribute( "line", assertionResult.getSourceInfo().line ) + .writeText( assertionResult.getMessage() ); + break; + case ResultWas::Info: + m_xml.scopedElement( "Info" ) + .writeText( assertionResult.getMessage() ); + break; + case ResultWas::Warning: + // Warning will already have been written + break; + case ResultWas::ExplicitFailure: + m_xml.scopedElement( "Failure" ) + .writeText( assertionResult.getMessage() ); + break; + default: + break; + } + + if( assertionResult.hasExpression() ) + m_xml.endElement(); + + return true; + } + + virtual void sectionEnded( SectionStats const& sectionStats ) CATCH_OVERRIDE { + StreamingReporterBase::sectionEnded( sectionStats ); + if( --m_sectionDepth > 0 ) { + XmlWriter::ScopedElement e = m_xml.scopedElement( "OverallResults" ); + e.writeAttribute( "successes", sectionStats.assertions.passed ); + e.writeAttribute( "failures", sectionStats.assertions.failed ); + e.writeAttribute( "expectedFailures", sectionStats.assertions.failedButOk ); + + if ( m_config->showDurations() == ShowDurations::Always ) + e.writeAttribute( "durationInSeconds", sectionStats.durationInSeconds ); + + m_xml.endElement(); + } + } + + virtual void testCaseEnded( TestCaseStats const& testCaseStats ) CATCH_OVERRIDE { + StreamingReporterBase::testCaseEnded( testCaseStats ); + XmlWriter::ScopedElement e = m_xml.scopedElement( "OverallResult" ); + e.writeAttribute( "success", testCaseStats.totals.assertions.allOk() ); + + if ( m_config->showDurations() == ShowDurations::Always ) + e.writeAttribute( "durationInSeconds", m_testCaseTimer.getElapsedSeconds() ); + + m_xml.endElement(); + } + + virtual void testGroupEnded( TestGroupStats const& testGroupStats ) CATCH_OVERRIDE { + StreamingReporterBase::testGroupEnded( testGroupStats ); + // TODO: Check testGroupStats.aborting and act accordingly. + m_xml.scopedElement( "OverallResults" ) + .writeAttribute( "successes", testGroupStats.totals.assertions.passed ) + .writeAttribute( "failures", testGroupStats.totals.assertions.failed ) + .writeAttribute( "expectedFailures", testGroupStats.totals.assertions.failedButOk ); + m_xml.endElement(); + } + + virtual void testRunEnded( TestRunStats const& testRunStats ) CATCH_OVERRIDE { + StreamingReporterBase::testRunEnded( testRunStats ); + m_xml.scopedElement( "OverallResults" ) + .writeAttribute( "successes", testRunStats.totals.assertions.passed ) + .writeAttribute( "failures", testRunStats.totals.assertions.failed ) + .writeAttribute( "expectedFailures", testRunStats.totals.assertions.failedButOk ); + m_xml.endElement(); + } + + private: + Timer m_testCaseTimer; + XmlWriter m_xml; + int m_sectionDepth; + }; + + INTERNAL_CATCH_REGISTER_REPORTER( "xml", XmlReporter ) + +} // end namespace Catch + +// #included from: ../reporters/catch_reporter_junit.hpp +#define TWOBLUECUBES_CATCH_REPORTER_JUNIT_HPP_INCLUDED + +#include + +namespace Catch { + + class JunitReporter : public CumulativeReporterBase { + public: + JunitReporter( ReporterConfig const& _config ) + : CumulativeReporterBase( _config ), + xml( _config.stream() ) + { + m_reporterPrefs.shouldRedirectStdOut = true; + } + + virtual ~JunitReporter() CATCH_OVERRIDE; + + static std::string getDescription() { + return "Reports test results in an XML format that looks like Ant's junitreport target"; + } + + virtual void noMatchingTestCases( std::string const& /*spec*/ ) CATCH_OVERRIDE {} + + virtual void testRunStarting( TestRunInfo const& runInfo ) CATCH_OVERRIDE { + CumulativeReporterBase::testRunStarting( runInfo ); + xml.startElement( "testsuites" ); + } + + virtual void testGroupStarting( GroupInfo const& groupInfo ) CATCH_OVERRIDE { + suiteTimer.start(); + stdOutForSuite.str(""); + stdErrForSuite.str(""); + unexpectedExceptions = 0; + CumulativeReporterBase::testGroupStarting( groupInfo ); + } + + virtual bool assertionEnded( AssertionStats const& assertionStats ) CATCH_OVERRIDE { + if( assertionStats.assertionResult.getResultType() == ResultWas::ThrewException ) + unexpectedExceptions++; + return CumulativeReporterBase::assertionEnded( assertionStats ); + } + + virtual void testCaseEnded( TestCaseStats const& testCaseStats ) CATCH_OVERRIDE { + stdOutForSuite << testCaseStats.stdOut; + stdErrForSuite << testCaseStats.stdErr; + CumulativeReporterBase::testCaseEnded( testCaseStats ); + } + + virtual void testGroupEnded( TestGroupStats const& testGroupStats ) CATCH_OVERRIDE { + double suiteTime = suiteTimer.getElapsedSeconds(); + CumulativeReporterBase::testGroupEnded( testGroupStats ); + writeGroup( *m_testGroups.back(), suiteTime ); + } + + virtual void testRunEndedCumulative() CATCH_OVERRIDE { + xml.endElement(); + } + + void writeGroup( TestGroupNode const& groupNode, double suiteTime ) { + XmlWriter::ScopedElement e = xml.scopedElement( "testsuite" ); + TestGroupStats const& stats = groupNode.value; + xml.writeAttribute( "name", stats.groupInfo.name ); + xml.writeAttribute( "errors", unexpectedExceptions ); + xml.writeAttribute( "failures", stats.totals.assertions.failed-unexpectedExceptions ); + xml.writeAttribute( "tests", stats.totals.assertions.total() ); + xml.writeAttribute( "hostname", "tbd" ); // !TBD + if( m_config->showDurations() == ShowDurations::Never ) + xml.writeAttribute( "time", "" ); + else + xml.writeAttribute( "time", suiteTime ); + xml.writeAttribute( "timestamp", "tbd" ); // !TBD + + // Write test cases + for( TestGroupNode::ChildNodes::const_iterator + it = groupNode.children.begin(), itEnd = groupNode.children.end(); + it != itEnd; + ++it ) + writeTestCase( **it ); + + xml.scopedElement( "system-out" ).writeText( trim( stdOutForSuite.str() ), false ); + xml.scopedElement( "system-err" ).writeText( trim( stdErrForSuite.str() ), false ); + } + + void writeTestCase( TestCaseNode const& testCaseNode ) { + TestCaseStats const& stats = testCaseNode.value; + + // All test cases have exactly one section - which represents the + // test case itself. That section may have 0-n nested sections + assert( testCaseNode.children.size() == 1 ); + SectionNode const& rootSection = *testCaseNode.children.front(); + + std::string className = stats.testInfo.className; + + if( className.empty() ) { + if( rootSection.childSections.empty() ) + className = "global"; + } + writeSection( className, "", rootSection ); + } + + void writeSection( std::string const& className, + std::string const& rootName, + SectionNode const& sectionNode ) { + std::string name = trim( sectionNode.stats.sectionInfo.name ); + if( !rootName.empty() ) + name = rootName + "/" + name; + + if( !sectionNode.assertions.empty() || + !sectionNode.stdOut.empty() || + !sectionNode.stdErr.empty() ) { + XmlWriter::ScopedElement e = xml.scopedElement( "testcase" ); + if( className.empty() ) { + xml.writeAttribute( "classname", name ); + xml.writeAttribute( "name", "root" ); + } + else { + xml.writeAttribute( "classname", className ); + xml.writeAttribute( "name", name ); + } + xml.writeAttribute( "time", Catch::toString( sectionNode.stats.durationInSeconds ) ); + + writeAssertions( sectionNode ); + + if( !sectionNode.stdOut.empty() ) + xml.scopedElement( "system-out" ).writeText( trim( sectionNode.stdOut ), false ); + if( !sectionNode.stdErr.empty() ) + xml.scopedElement( "system-err" ).writeText( trim( sectionNode.stdErr ), false ); + } + for( SectionNode::ChildSections::const_iterator + it = sectionNode.childSections.begin(), + itEnd = sectionNode.childSections.end(); + it != itEnd; + ++it ) + if( className.empty() ) + writeSection( name, "", **it ); + else + writeSection( className, name, **it ); + } + + void writeAssertions( SectionNode const& sectionNode ) { + for( SectionNode::Assertions::const_iterator + it = sectionNode.assertions.begin(), itEnd = sectionNode.assertions.end(); + it != itEnd; + ++it ) + writeAssertion( *it ); + } + void writeAssertion( AssertionStats const& stats ) { + AssertionResult const& result = stats.assertionResult; + if( !result.isOk() ) { + std::string elementName; + switch( result.getResultType() ) { + case ResultWas::ThrewException: + case ResultWas::FatalErrorCondition: + elementName = "error"; + break; + case ResultWas::ExplicitFailure: + elementName = "failure"; + break; + case ResultWas::ExpressionFailed: + elementName = "failure"; + break; + case ResultWas::DidntThrowException: + elementName = "failure"; + break; + + // We should never see these here: + case ResultWas::Info: + case ResultWas::Warning: + case ResultWas::Ok: + case ResultWas::Unknown: + case ResultWas::FailureBit: + case ResultWas::Exception: + elementName = "internalError"; + break; + } + + XmlWriter::ScopedElement e = xml.scopedElement( elementName ); + + xml.writeAttribute( "message", result.getExpandedExpression() ); + xml.writeAttribute( "type", result.getTestMacroName() ); + + std::ostringstream oss; + if( !result.getMessage().empty() ) + oss << result.getMessage() << "\n"; + for( std::vector::const_iterator + it = stats.infoMessages.begin(), + itEnd = stats.infoMessages.end(); + it != itEnd; + ++it ) + if( it->type == ResultWas::Info ) + oss << it->message << "\n"; + + oss << "at " << result.getSourceInfo(); + xml.writeText( oss.str(), false ); + } + } + + XmlWriter xml; + Timer suiteTimer; + std::ostringstream stdOutForSuite; + std::ostringstream stdErrForSuite; + unsigned int unexpectedExceptions; + }; + + INTERNAL_CATCH_REGISTER_REPORTER( "junit", JunitReporter ) + +} // end namespace Catch + +// #included from: ../reporters/catch_reporter_console.hpp +#define TWOBLUECUBES_CATCH_REPORTER_CONSOLE_HPP_INCLUDED + +namespace Catch { + + struct ConsoleReporter : StreamingReporterBase { + ConsoleReporter( ReporterConfig const& _config ) + : StreamingReporterBase( _config ), + m_headerPrinted( false ) + {} + + virtual ~ConsoleReporter() CATCH_OVERRIDE; + static std::string getDescription() { + return "Reports test results as plain lines of text"; + } + + virtual void noMatchingTestCases( std::string const& spec ) CATCH_OVERRIDE { + stream << "No test cases matched '" << spec << "'" << std::endl; + } + + virtual void assertionStarting( AssertionInfo const& ) CATCH_OVERRIDE { + } + + virtual bool assertionEnded( AssertionStats const& _assertionStats ) CATCH_OVERRIDE { + AssertionResult const& result = _assertionStats.assertionResult; + + bool printInfoMessages = true; + + // Drop out if result was successful and we're not printing those + if( !m_config->includeSuccessfulResults() && result.isOk() ) { + if( result.getResultType() != ResultWas::Warning ) + return false; + printInfoMessages = false; + } + + lazyPrint(); + + AssertionPrinter printer( stream, _assertionStats, printInfoMessages ); + printer.print(); + stream << std::endl; + return true; + } + + virtual void sectionStarting( SectionInfo const& _sectionInfo ) CATCH_OVERRIDE { + m_headerPrinted = false; + StreamingReporterBase::sectionStarting( _sectionInfo ); + } + virtual void sectionEnded( SectionStats const& _sectionStats ) CATCH_OVERRIDE { + if( _sectionStats.missingAssertions ) { + lazyPrint(); + Colour colour( Colour::ResultError ); + if( m_sectionStack.size() > 1 ) + stream << "\nNo assertions in section"; + else + stream << "\nNo assertions in test case"; + stream << " '" << _sectionStats.sectionInfo.name << "'\n" << std::endl; + } + if( m_headerPrinted ) { + if( m_config->showDurations() == ShowDurations::Always ) + stream << "Completed in " << _sectionStats.durationInSeconds << "s" << std::endl; + m_headerPrinted = false; + } + else { + if( m_config->showDurations() == ShowDurations::Always ) + stream << _sectionStats.sectionInfo.name << " completed in " << _sectionStats.durationInSeconds << "s" << std::endl; + } + StreamingReporterBase::sectionEnded( _sectionStats ); + } + + virtual void testCaseEnded( TestCaseStats const& _testCaseStats ) CATCH_OVERRIDE { + StreamingReporterBase::testCaseEnded( _testCaseStats ); + m_headerPrinted = false; + } + virtual void testGroupEnded( TestGroupStats const& _testGroupStats ) CATCH_OVERRIDE { + if( currentGroupInfo.used ) { + printSummaryDivider(); + stream << "Summary for group '" << _testGroupStats.groupInfo.name << "':\n"; + printTotals( _testGroupStats.totals ); + stream << "\n" << std::endl; + } + StreamingReporterBase::testGroupEnded( _testGroupStats ); + } + virtual void testRunEnded( TestRunStats const& _testRunStats ) CATCH_OVERRIDE { + printTotalsDivider( _testRunStats.totals ); + printTotals( _testRunStats.totals ); + stream << std::endl; + StreamingReporterBase::testRunEnded( _testRunStats ); + } + + private: + + class AssertionPrinter { + void operator= ( AssertionPrinter const& ); + public: + AssertionPrinter( std::ostream& _stream, AssertionStats const& _stats, bool _printInfoMessages ) + : stream( _stream ), + stats( _stats ), + result( _stats.assertionResult ), + colour( Colour::None ), + message( result.getMessage() ), + messages( _stats.infoMessages ), + printInfoMessages( _printInfoMessages ) + { + switch( result.getResultType() ) { + case ResultWas::Ok: + colour = Colour::Success; + passOrFail = "PASSED"; + //if( result.hasMessage() ) + if( _stats.infoMessages.size() == 1 ) + messageLabel = "with message"; + if( _stats.infoMessages.size() > 1 ) + messageLabel = "with messages"; + break; + case ResultWas::ExpressionFailed: + if( result.isOk() ) { + colour = Colour::Success; + passOrFail = "FAILED - but was ok"; + } + else { + colour = Colour::Error; + passOrFail = "FAILED"; + } + if( _stats.infoMessages.size() == 1 ) + messageLabel = "with message"; + if( _stats.infoMessages.size() > 1 ) + messageLabel = "with messages"; + break; + case ResultWas::ThrewException: + colour = Colour::Error; + passOrFail = "FAILED"; + messageLabel = "due to unexpected exception with message"; + break; + case ResultWas::FatalErrorCondition: + colour = Colour::Error; + passOrFail = "FAILED"; + messageLabel = "due to a fatal error condition"; + break; + case ResultWas::DidntThrowException: + colour = Colour::Error; + passOrFail = "FAILED"; + messageLabel = "because no exception was thrown where one was expected"; + break; + case ResultWas::Info: + messageLabel = "info"; + break; + case ResultWas::Warning: + messageLabel = "warning"; + break; + case ResultWas::ExplicitFailure: + passOrFail = "FAILED"; + colour = Colour::Error; + if( _stats.infoMessages.size() == 1 ) + messageLabel = "explicitly with message"; + if( _stats.infoMessages.size() > 1 ) + messageLabel = "explicitly with messages"; + break; + // These cases are here to prevent compiler warnings + case ResultWas::Unknown: + case ResultWas::FailureBit: + case ResultWas::Exception: + passOrFail = "** internal error **"; + colour = Colour::Error; + break; + } + } + + void print() const { + printSourceInfo(); + if( stats.totals.assertions.total() > 0 ) { + if( result.isOk() ) + stream << "\n"; + printResultType(); + printOriginalExpression(); + printReconstructedExpression(); + } + else { + stream << "\n"; + } + printMessage(); + } + + private: + void printResultType() const { + if( !passOrFail.empty() ) { + Colour colourGuard( colour ); + stream << passOrFail << ":\n"; + } + } + void printOriginalExpression() const { + if( result.hasExpression() ) { + Colour colourGuard( Colour::OriginalExpression ); + stream << " "; + stream << result.getExpressionInMacro(); + stream << "\n"; + } + } + void printReconstructedExpression() const { + if( result.hasExpandedExpression() ) { + stream << "with expansion:\n"; + Colour colourGuard( Colour::ReconstructedExpression ); + stream << Text( result.getExpandedExpression(), TextAttributes().setIndent(2) ) << "\n"; + } + } + void printMessage() const { + if( !messageLabel.empty() ) + stream << messageLabel << ":" << "\n"; + for( std::vector::const_iterator it = messages.begin(), itEnd = messages.end(); + it != itEnd; + ++it ) { + // If this assertion is a warning ignore any INFO messages + if( printInfoMessages || it->type != ResultWas::Info ) + stream << Text( it->message, TextAttributes().setIndent(2) ) << "\n"; + } + } + void printSourceInfo() const { + Colour colourGuard( Colour::FileName ); + stream << result.getSourceInfo() << ": "; + } + + std::ostream& stream; + AssertionStats const& stats; + AssertionResult const& result; + Colour::Code colour; + std::string passOrFail; + std::string messageLabel; + std::string message; + std::vector messages; + bool printInfoMessages; + }; + + void lazyPrint() { + + if( !currentTestRunInfo.used ) + lazyPrintRunInfo(); + if( !currentGroupInfo.used ) + lazyPrintGroupInfo(); + + if( !m_headerPrinted ) { + printTestCaseAndSectionHeader(); + m_headerPrinted = true; + } + } + void lazyPrintRunInfo() { + stream << "\n" << getLineOfChars<'~'>() << "\n"; + Colour colour( Colour::SecondaryText ); + stream << currentTestRunInfo->name + << " is a Catch v" << libraryVersion << " host application.\n" + << "Run with -? for options\n\n"; + + if( m_config->rngSeed() != 0 ) + stream << "Randomness seeded to: " << m_config->rngSeed() << "\n\n"; + + currentTestRunInfo.used = true; + } + void lazyPrintGroupInfo() { + if( !currentGroupInfo->name.empty() && currentGroupInfo->groupsCounts > 1 ) { + printClosedHeader( "Group: " + currentGroupInfo->name ); + currentGroupInfo.used = true; + } + } + void printTestCaseAndSectionHeader() { + assert( !m_sectionStack.empty() ); + printOpenHeader( currentTestCaseInfo->name ); + + if( m_sectionStack.size() > 1 ) { + Colour colourGuard( Colour::Headers ); + + std::vector::const_iterator + it = m_sectionStack.begin()+1, // Skip first section (test case) + itEnd = m_sectionStack.end(); + for( ; it != itEnd; ++it ) + printHeaderString( it->name, 2 ); + } + + SourceLineInfo lineInfo = m_sectionStack.front().lineInfo; + + if( !lineInfo.empty() ){ + stream << getLineOfChars<'-'>() << "\n"; + Colour colourGuard( Colour::FileName ); + stream << lineInfo << "\n"; + } + stream << getLineOfChars<'.'>() << "\n" << std::endl; + } + + void printClosedHeader( std::string const& _name ) { + printOpenHeader( _name ); + stream << getLineOfChars<'.'>() << "\n"; + } + void printOpenHeader( std::string const& _name ) { + stream << getLineOfChars<'-'>() << "\n"; + { + Colour colourGuard( Colour::Headers ); + printHeaderString( _name ); + } + } + + // if string has a : in first line will set indent to follow it on + // subsequent lines + void printHeaderString( std::string const& _string, std::size_t indent = 0 ) { + std::size_t i = _string.find( ": " ); + if( i != std::string::npos ) + i+=2; + else + i = 0; + stream << Text( _string, TextAttributes() + .setIndent( indent+i) + .setInitialIndent( indent ) ) << "\n"; + } + + struct SummaryColumn { + + SummaryColumn( std::string const& _label, Colour::Code _colour ) + : label( _label ), + colour( _colour ) + {} + SummaryColumn addRow( std::size_t count ) { + std::ostringstream oss; + oss << count; + std::string row = oss.str(); + for( std::vector::iterator it = rows.begin(); it != rows.end(); ++it ) { + while( it->size() < row.size() ) + *it = " " + *it; + while( it->size() > row.size() ) + row = " " + row; + } + rows.push_back( row ); + return *this; + } + + std::string label; + Colour::Code colour; + std::vector rows; + + }; + + void printTotals( Totals const& totals ) { + if( totals.testCases.total() == 0 ) { + stream << Colour( Colour::Warning ) << "No tests ran\n"; + } + else if( totals.assertions.total() > 0 && totals.testCases.allPassed() ) { + stream << Colour( Colour::ResultSuccess ) << "All tests passed"; + stream << " (" + << pluralise( totals.assertions.passed, "assertion" ) << " in " + << pluralise( totals.testCases.passed, "test case" ) << ")" + << "\n"; + } + else { + + std::vector columns; + columns.push_back( SummaryColumn( "", Colour::None ) + .addRow( totals.testCases.total() ) + .addRow( totals.assertions.total() ) ); + columns.push_back( SummaryColumn( "passed", Colour::Success ) + .addRow( totals.testCases.passed ) + .addRow( totals.assertions.passed ) ); + columns.push_back( SummaryColumn( "failed", Colour::ResultError ) + .addRow( totals.testCases.failed ) + .addRow( totals.assertions.failed ) ); + columns.push_back( SummaryColumn( "failed as expected", Colour::ResultExpectedFailure ) + .addRow( totals.testCases.failedButOk ) + .addRow( totals.assertions.failedButOk ) ); + + printSummaryRow( "test cases", columns, 0 ); + printSummaryRow( "assertions", columns, 1 ); + } + } + void printSummaryRow( std::string const& label, std::vector const& cols, std::size_t row ) { + for( std::vector::const_iterator it = cols.begin(); it != cols.end(); ++it ) { + std::string value = it->rows[row]; + if( it->label.empty() ) { + stream << label << ": "; + if( value != "0" ) + stream << value; + else + stream << Colour( Colour::Warning ) << "- none -"; + } + else if( value != "0" ) { + stream << Colour( Colour::LightGrey ) << " | "; + stream << Colour( it->colour ) + << value << " " << it->label; + } + } + stream << "\n"; + } + + static std::size_t makeRatio( std::size_t number, std::size_t total ) { + std::size_t ratio = total > 0 ? CATCH_CONFIG_CONSOLE_WIDTH * number/ total : 0; + return ( ratio == 0 && number > 0 ) ? 1 : ratio; + } + static std::size_t& findMax( std::size_t& i, std::size_t& j, std::size_t& k ) { + if( i > j && i > k ) + return i; + else if( j > k ) + return j; + else + return k; + } + + void printTotalsDivider( Totals const& totals ) { + if( totals.testCases.total() > 0 ) { + std::size_t failedRatio = makeRatio( totals.testCases.failed, totals.testCases.total() ); + std::size_t failedButOkRatio = makeRatio( totals.testCases.failedButOk, totals.testCases.total() ); + std::size_t passedRatio = makeRatio( totals.testCases.passed, totals.testCases.total() ); + while( failedRatio + failedButOkRatio + passedRatio < CATCH_CONFIG_CONSOLE_WIDTH-1 ) + findMax( failedRatio, failedButOkRatio, passedRatio )++; + while( failedRatio + failedButOkRatio + passedRatio > CATCH_CONFIG_CONSOLE_WIDTH-1 ) + findMax( failedRatio, failedButOkRatio, passedRatio )--; + + stream << Colour( Colour::Error ) << std::string( failedRatio, '=' ); + stream << Colour( Colour::ResultExpectedFailure ) << std::string( failedButOkRatio, '=' ); + if( totals.testCases.allPassed() ) + stream << Colour( Colour::ResultSuccess ) << std::string( passedRatio, '=' ); + else + stream << Colour( Colour::Success ) << std::string( passedRatio, '=' ); + } + else { + stream << Colour( Colour::Warning ) << std::string( CATCH_CONFIG_CONSOLE_WIDTH-1, '=' ); + } + stream << "\n"; + } + void printSummaryDivider() { + stream << getLineOfChars<'-'>() << "\n"; + } + + private: + bool m_headerPrinted; + }; + + INTERNAL_CATCH_REGISTER_REPORTER( "console", ConsoleReporter ) + +} // end namespace Catch + +// #included from: ../reporters/catch_reporter_compact.hpp +#define TWOBLUECUBES_CATCH_REPORTER_COMPACT_HPP_INCLUDED + +namespace Catch { + + struct CompactReporter : StreamingReporterBase { + + CompactReporter( ReporterConfig const& _config ) + : StreamingReporterBase( _config ) + {} + + virtual ~CompactReporter(); + + static std::string getDescription() { + return "Reports test results on a single line, suitable for IDEs"; + } + + virtual ReporterPreferences getPreferences() const { + ReporterPreferences prefs; + prefs.shouldRedirectStdOut = false; + return prefs; + } + + virtual void noMatchingTestCases( std::string const& spec ) { + stream << "No test cases matched '" << spec << "'" << std::endl; + } + + virtual void assertionStarting( AssertionInfo const& ) { + } + + virtual bool assertionEnded( AssertionStats const& _assertionStats ) { + AssertionResult const& result = _assertionStats.assertionResult; + + bool printInfoMessages = true; + + // Drop out if result was successful and we're not printing those + if( !m_config->includeSuccessfulResults() && result.isOk() ) { + if( result.getResultType() != ResultWas::Warning ) + return false; + printInfoMessages = false; + } + + AssertionPrinter printer( stream, _assertionStats, printInfoMessages ); + printer.print(); + + stream << std::endl; + return true; + } + + virtual void testRunEnded( TestRunStats const& _testRunStats ) { + printTotals( _testRunStats.totals ); + stream << "\n" << std::endl; + StreamingReporterBase::testRunEnded( _testRunStats ); + } + + private: + class AssertionPrinter { + void operator= ( AssertionPrinter const& ); + public: + AssertionPrinter( std::ostream& _stream, AssertionStats const& _stats, bool _printInfoMessages ) + : stream( _stream ) + , stats( _stats ) + , result( _stats.assertionResult ) + , messages( _stats.infoMessages ) + , itMessage( _stats.infoMessages.begin() ) + , printInfoMessages( _printInfoMessages ) + {} + + void print() { + printSourceInfo(); + + itMessage = messages.begin(); + + switch( result.getResultType() ) { + case ResultWas::Ok: + printResultType( Colour::ResultSuccess, passedString() ); + printOriginalExpression(); + printReconstructedExpression(); + if ( ! result.hasExpression() ) + printRemainingMessages( Colour::None ); + else + printRemainingMessages(); + break; + case ResultWas::ExpressionFailed: + if( result.isOk() ) + printResultType( Colour::ResultSuccess, failedString() + std::string( " - but was ok" ) ); + else + printResultType( Colour::Error, failedString() ); + printOriginalExpression(); + printReconstructedExpression(); + printRemainingMessages(); + break; + case ResultWas::ThrewException: + printResultType( Colour::Error, failedString() ); + printIssue( "unexpected exception with message:" ); + printMessage(); + printExpressionWas(); + printRemainingMessages(); + break; + case ResultWas::FatalErrorCondition: + printResultType( Colour::Error, failedString() ); + printIssue( "fatal error condition with message:" ); + printMessage(); + printExpressionWas(); + printRemainingMessages(); + break; + case ResultWas::DidntThrowException: + printResultType( Colour::Error, failedString() ); + printIssue( "expected exception, got none" ); + printExpressionWas(); + printRemainingMessages(); + break; + case ResultWas::Info: + printResultType( Colour::None, "info" ); + printMessage(); + printRemainingMessages(); + break; + case ResultWas::Warning: + printResultType( Colour::None, "warning" ); + printMessage(); + printRemainingMessages(); + break; + case ResultWas::ExplicitFailure: + printResultType( Colour::Error, failedString() ); + printIssue( "explicitly" ); + printRemainingMessages( Colour::None ); + break; + // These cases are here to prevent compiler warnings + case ResultWas::Unknown: + case ResultWas::FailureBit: + case ResultWas::Exception: + printResultType( Colour::Error, "** internal error **" ); + break; + } + } + + private: + // Colour::LightGrey + + static Colour::Code dimColour() { return Colour::FileName; } + +#ifdef CATCH_PLATFORM_MAC + static const char* failedString() { return "FAILED"; } + static const char* passedString() { return "PASSED"; } +#else + static const char* failedString() { return "failed"; } + static const char* passedString() { return "passed"; } +#endif + + void printSourceInfo() const { + Colour colourGuard( Colour::FileName ); + stream << result.getSourceInfo() << ":"; + } + + void printResultType( Colour::Code colour, std::string passOrFail ) const { + if( !passOrFail.empty() ) { + { + Colour colourGuard( colour ); + stream << " " << passOrFail; + } + stream << ":"; + } + } + + void printIssue( std::string issue ) const { + stream << " " << issue; + } + + void printExpressionWas() { + if( result.hasExpression() ) { + stream << ";"; + { + Colour colour( dimColour() ); + stream << " expression was:"; + } + printOriginalExpression(); + } + } + + void printOriginalExpression() const { + if( result.hasExpression() ) { + stream << " " << result.getExpression(); + } + } + + void printReconstructedExpression() const { + if( result.hasExpandedExpression() ) { + { + Colour colour( dimColour() ); + stream << " for: "; + } + stream << result.getExpandedExpression(); + } + } + + void printMessage() { + if ( itMessage != messages.end() ) { + stream << " '" << itMessage->message << "'"; + ++itMessage; + } + } + + void printRemainingMessages( Colour::Code colour = dimColour() ) { + if ( itMessage == messages.end() ) + return; + + // using messages.end() directly yields compilation error: + std::vector::const_iterator itEnd = messages.end(); + const std::size_t N = static_cast( std::distance( itMessage, itEnd ) ); + + { + Colour colourGuard( colour ); + stream << " with " << pluralise( N, "message" ) << ":"; + } + + for(; itMessage != itEnd; ) { + // If this assertion is a warning ignore any INFO messages + if( printInfoMessages || itMessage->type != ResultWas::Info ) { + stream << " '" << itMessage->message << "'"; + if ( ++itMessage != itEnd ) { + Colour colourGuard( dimColour() ); + stream << " and"; + } + } + } + } + + private: + std::ostream& stream; + AssertionStats const& stats; + AssertionResult const& result; + std::vector messages; + std::vector::const_iterator itMessage; + bool printInfoMessages; + }; + + // Colour, message variants: + // - white: No tests ran. + // - red: Failed [both/all] N test cases, failed [both/all] M assertions. + // - white: Passed [both/all] N test cases (no assertions). + // - red: Failed N tests cases, failed M assertions. + // - green: Passed [both/all] N tests cases with M assertions. + + std::string bothOrAll( std::size_t count ) const { + return count == 1 ? "" : count == 2 ? "both " : "all " ; + } + + void printTotals( const Totals& totals ) const { + if( totals.testCases.total() == 0 ) { + stream << "No tests ran."; + } + else if( totals.testCases.failed == totals.testCases.total() ) { + Colour colour( Colour::ResultError ); + const std::string qualify_assertions_failed = + totals.assertions.failed == totals.assertions.total() ? + bothOrAll( totals.assertions.failed ) : ""; + stream << + "Failed " << bothOrAll( totals.testCases.failed ) + << pluralise( totals.testCases.failed, "test case" ) << ", " + "failed " << qualify_assertions_failed << + pluralise( totals.assertions.failed, "assertion" ) << "."; + } + else if( totals.assertions.total() == 0 ) { + stream << + "Passed " << bothOrAll( totals.testCases.total() ) + << pluralise( totals.testCases.total(), "test case" ) + << " (no assertions)."; + } + else if( totals.assertions.failed ) { + Colour colour( Colour::ResultError ); + stream << + "Failed " << pluralise( totals.testCases.failed, "test case" ) << ", " + "failed " << pluralise( totals.assertions.failed, "assertion" ) << "."; + } + else { + Colour colour( Colour::ResultSuccess ); + stream << + "Passed " << bothOrAll( totals.testCases.passed ) + << pluralise( totals.testCases.passed, "test case" ) << + " with " << pluralise( totals.assertions.passed, "assertion" ) << "."; + } + } + }; + + INTERNAL_CATCH_REGISTER_REPORTER( "compact", CompactReporter ) + +} // end namespace Catch + +namespace Catch { + // These are all here to avoid warnings about not having any out of line + // virtual methods + NonCopyable::~NonCopyable() {} + IShared::~IShared() {} + IStream::~IStream() CATCH_NOEXCEPT {} + FileStream::~FileStream() CATCH_NOEXCEPT {} + CoutStream::~CoutStream() CATCH_NOEXCEPT {} + DebugOutStream::~DebugOutStream() CATCH_NOEXCEPT {} + StreamBufBase::~StreamBufBase() CATCH_NOEXCEPT {} + IContext::~IContext() {} + IResultCapture::~IResultCapture() {} + ITestCase::~ITestCase() {} + ITestCaseRegistry::~ITestCaseRegistry() {} + IRegistryHub::~IRegistryHub() {} + IMutableRegistryHub::~IMutableRegistryHub() {} + IExceptionTranslator::~IExceptionTranslator() {} + IExceptionTranslatorRegistry::~IExceptionTranslatorRegistry() {} + IReporter::~IReporter() {} + IReporterFactory::~IReporterFactory() {} + IReporterRegistry::~IReporterRegistry() {} + IStreamingReporter::~IStreamingReporter() {} + AssertionStats::~AssertionStats() {} + SectionStats::~SectionStats() {} + TestCaseStats::~TestCaseStats() {} + TestGroupStats::~TestGroupStats() {} + TestRunStats::~TestRunStats() {} + CumulativeReporterBase::SectionNode::~SectionNode() {} + CumulativeReporterBase::~CumulativeReporterBase() {} + + StreamingReporterBase::~StreamingReporterBase() {} + ConsoleReporter::~ConsoleReporter() {} + CompactReporter::~CompactReporter() {} + IRunner::~IRunner() {} + IMutableContext::~IMutableContext() {} + IConfig::~IConfig() {} + XmlReporter::~XmlReporter() {} + JunitReporter::~JunitReporter() {} + TestRegistry::~TestRegistry() {} + FreeFunctionTestCase::~FreeFunctionTestCase() {} + IGeneratorInfo::~IGeneratorInfo() {} + IGeneratorsForTest::~IGeneratorsForTest() {} + WildcardPattern::~WildcardPattern() {} + TestSpec::Pattern::~Pattern() {} + TestSpec::NamePattern::~NamePattern() {} + TestSpec::TagPattern::~TagPattern() {} + TestSpec::ExcludedPattern::~ExcludedPattern() {} + + Matchers::Impl::StdString::Equals::~Equals() {} + Matchers::Impl::StdString::Contains::~Contains() {} + Matchers::Impl::StdString::StartsWith::~StartsWith() {} + Matchers::Impl::StdString::EndsWith::~EndsWith() {} + + void Config::dummy() {} + + namespace TestCaseTracking { + ITracker::~ITracker() {} + TrackerBase::~TrackerBase() {} + SectionTracker::~SectionTracker() {} + IndexTracker::~IndexTracker() {} + } +} + +#ifdef __clang__ +#pragma clang diagnostic pop +#endif + +#endif + +#ifdef CATCH_CONFIG_MAIN +// #included from: internal/catch_default_main.hpp +#define TWOBLUECUBES_CATCH_DEFAULT_MAIN_HPP_INCLUDED + +#ifndef __OBJC__ + +// Standard C/C++ main entry point +int main (int argc, char * argv[]) { + return Catch::Session().run( argc, argv ); +} + +#else // __OBJC__ + +// Objective-C entry point +int main (int argc, char * const argv[]) { +#if !CATCH_ARC_ENABLED + NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init]; +#endif + + Catch::registerTestMethods(); + int result = Catch::Session().run( argc, (char* const*)argv ); + +#if !CATCH_ARC_ENABLED + [pool drain]; +#endif + + return result; +} + +#endif // __OBJC__ + +#endif + +#ifdef CLARA_CONFIG_MAIN_NOT_DEFINED +# undef CLARA_CONFIG_MAIN +#endif + +////// + +// If this config identifier is defined then all CATCH macros are prefixed with CATCH_ +#ifdef CATCH_CONFIG_PREFIX_ALL + +#define CATCH_REQUIRE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::Normal, "CATCH_REQUIRE" ) +#define CATCH_REQUIRE_FALSE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, "CATCH_REQUIRE_FALSE" ) + +#define CATCH_REQUIRE_THROWS( expr ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::Normal, "", "CATCH_REQUIRE_THROWS" ) +#define CATCH_REQUIRE_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( expr, exceptionType, Catch::ResultDisposition::Normal, "CATCH_REQUIRE_THROWS_AS" ) +#define CATCH_REQUIRE_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::Normal, matcher, "CATCH_REQUIRE_THROWS_WITH" ) +#define CATCH_REQUIRE_NOTHROW( expr ) INTERNAL_CATCH_NO_THROW( expr, Catch::ResultDisposition::Normal, "CATCH_REQUIRE_NOTHROW" ) + +#define CATCH_CHECK( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECK" ) +#define CATCH_CHECK_FALSE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, "CATCH_CHECK_FALSE" ) +#define CATCH_CHECKED_IF( expr ) INTERNAL_CATCH_IF( expr, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECKED_IF" ) +#define CATCH_CHECKED_ELSE( expr ) INTERNAL_CATCH_ELSE( expr, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECKED_ELSE" ) +#define CATCH_CHECK_NOFAIL( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, "CATCH_CHECK_NOFAIL" ) + +#define CATCH_CHECK_THROWS( expr ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECK_THROWS" ) +#define CATCH_CHECK_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( expr, exceptionType, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECK_THROWS_AS" ) +#define CATCH_CHECK_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::ContinueOnFailure, matcher, "CATCH_CHECK_THROWS_WITH" ) +#define CATCH_CHECK_NOTHROW( expr ) INTERNAL_CATCH_NO_THROW( expr, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECK_NOTHROW" ) + +#define CHECK_THAT( arg, matcher ) INTERNAL_CHECK_THAT( arg, matcher, Catch::ResultDisposition::ContinueOnFailure, "CATCH_CHECK_THAT" ) +#define CATCH_REQUIRE_THAT( arg, matcher ) INTERNAL_CHECK_THAT( arg, matcher, Catch::ResultDisposition::Normal, "CATCH_REQUIRE_THAT" ) + +#define CATCH_INFO( msg ) INTERNAL_CATCH_INFO( msg, "CATCH_INFO" ) +#define CATCH_WARN( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, "CATCH_WARN", msg ) +#define CATCH_SCOPED_INFO( msg ) INTERNAL_CATCH_INFO( msg, "CATCH_INFO" ) +#define CATCH_CAPTURE( msg ) INTERNAL_CATCH_INFO( #msg " := " << msg, "CATCH_CAPTURE" ) +#define CATCH_SCOPED_CAPTURE( msg ) INTERNAL_CATCH_INFO( #msg " := " << msg, "CATCH_CAPTURE" ) + +#ifdef CATCH_CONFIG_VARIADIC_MACROS + #define CATCH_TEST_CASE( ... ) INTERNAL_CATCH_TESTCASE( __VA_ARGS__ ) + #define CATCH_TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ ) + #define CATCH_METHOD_AS_TEST_CASE( method, ... ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ ) + #define CATCH_REGISTER_TEST_CASE( Function, ... ) INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ ) + #define CATCH_SECTION( ... ) INTERNAL_CATCH_SECTION( __VA_ARGS__ ) + #define CATCH_FAIL( ... ) INTERNAL_CATCH_MSG( Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, "CATCH_FAIL", __VA_ARGS__ ) + #define CATCH_SUCCEED( ... ) INTERNAL_CATCH_MSG( Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, "CATCH_SUCCEED", __VA_ARGS__ ) +#else + #define CATCH_TEST_CASE( name, description ) INTERNAL_CATCH_TESTCASE( name, description ) + #define CATCH_TEST_CASE_METHOD( className, name, description ) INTERNAL_CATCH_TEST_CASE_METHOD( className, name, description ) + #define CATCH_METHOD_AS_TEST_CASE( method, name, description ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, name, description ) + #define CATCH_REGISTER_TEST_CASE( function, name, description ) INTERNAL_CATCH_REGISTER_TESTCASE( function, name, description ) + #define CATCH_SECTION( name, description ) INTERNAL_CATCH_SECTION( name, description ) + #define CATCH_FAIL( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, "CATCH_FAIL", msg ) + #define CATCH_SUCCEED( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, "CATCH_SUCCEED", msg ) +#endif +#define CATCH_ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE( "", "" ) + +#define CATCH_REGISTER_REPORTER( name, reporterType ) INTERNAL_CATCH_REGISTER_REPORTER( name, reporterType ) +#define CATCH_REGISTER_LEGACY_REPORTER( name, reporterType ) INTERNAL_CATCH_REGISTER_LEGACY_REPORTER( name, reporterType ) + +#define CATCH_GENERATE( expr) INTERNAL_CATCH_GENERATE( expr ) + +// "BDD-style" convenience wrappers +#ifdef CATCH_CONFIG_VARIADIC_MACROS +#define CATCH_SCENARIO( ... ) CATCH_TEST_CASE( "Scenario: " __VA_ARGS__ ) +#define CATCH_SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ ) +#else +#define CATCH_SCENARIO( name, tags ) CATCH_TEST_CASE( "Scenario: " name, tags ) +#define CATCH_SCENARIO_METHOD( className, name, tags ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " name, tags ) +#endif +#define CATCH_GIVEN( desc ) CATCH_SECTION( std::string( "Given: ") + desc, "" ) +#define CATCH_WHEN( desc ) CATCH_SECTION( std::string( " When: ") + desc, "" ) +#define CATCH_AND_WHEN( desc ) CATCH_SECTION( std::string( " And: ") + desc, "" ) +#define CATCH_THEN( desc ) CATCH_SECTION( std::string( " Then: ") + desc, "" ) +#define CATCH_AND_THEN( desc ) CATCH_SECTION( std::string( " And: ") + desc, "" ) + +// If CATCH_CONFIG_PREFIX_ALL is not defined then the CATCH_ prefix is not required +#else + +#define REQUIRE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::Normal, "REQUIRE" ) +#define REQUIRE_FALSE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, "REQUIRE_FALSE" ) + +#define REQUIRE_THROWS( expr ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::Normal, "", "REQUIRE_THROWS" ) +#define REQUIRE_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( expr, exceptionType, Catch::ResultDisposition::Normal, "REQUIRE_THROWS_AS" ) +#define REQUIRE_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::Normal, matcher, "REQUIRE_THROWS_WITH" ) +#define REQUIRE_NOTHROW( expr ) INTERNAL_CATCH_NO_THROW( expr, Catch::ResultDisposition::Normal, "REQUIRE_NOTHROW" ) + +#define CHECK( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure, "CHECK" ) +#define CHECK_FALSE( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, "CHECK_FALSE" ) +#define CHECKED_IF( expr ) INTERNAL_CATCH_IF( expr, Catch::ResultDisposition::ContinueOnFailure, "CHECKED_IF" ) +#define CHECKED_ELSE( expr ) INTERNAL_CATCH_ELSE( expr, Catch::ResultDisposition::ContinueOnFailure, "CHECKED_ELSE" ) +#define CHECK_NOFAIL( expr ) INTERNAL_CATCH_TEST( expr, Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, "CHECK_NOFAIL" ) + +#define CHECK_THROWS( expr ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::ContinueOnFailure, "", "CHECK_THROWS" ) +#define CHECK_THROWS_AS( expr, exceptionType ) INTERNAL_CATCH_THROWS_AS( expr, exceptionType, Catch::ResultDisposition::ContinueOnFailure, "CHECK_THROWS_AS" ) +#define CHECK_THROWS_WITH( expr, matcher ) INTERNAL_CATCH_THROWS( expr, Catch::ResultDisposition::ContinueOnFailure, matcher, "CHECK_THROWS_WITH" ) +#define CHECK_NOTHROW( expr ) INTERNAL_CATCH_NO_THROW( expr, Catch::ResultDisposition::ContinueOnFailure, "CHECK_NOTHROW" ) + +#define CHECK_THAT( arg, matcher ) INTERNAL_CHECK_THAT( arg, matcher, Catch::ResultDisposition::ContinueOnFailure, "CHECK_THAT" ) +#define REQUIRE_THAT( arg, matcher ) INTERNAL_CHECK_THAT( arg, matcher, Catch::ResultDisposition::Normal, "REQUIRE_THAT" ) + +#define INFO( msg ) INTERNAL_CATCH_INFO( msg, "INFO" ) +#define WARN( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, "WARN", msg ) +#define SCOPED_INFO( msg ) INTERNAL_CATCH_INFO( msg, "INFO" ) +#define CAPTURE( msg ) INTERNAL_CATCH_INFO( #msg " := " << msg, "CAPTURE" ) +#define SCOPED_CAPTURE( msg ) INTERNAL_CATCH_INFO( #msg " := " << msg, "CAPTURE" ) + +#ifdef CATCH_CONFIG_VARIADIC_MACROS + #define TEST_CASE( ... ) INTERNAL_CATCH_TESTCASE( __VA_ARGS__ ) + #define TEST_CASE_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ ) + #define METHOD_AS_TEST_CASE( method, ... ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ ) + #define REGISTER_TEST_CASE( Function, ... ) INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ ) + #define SECTION( ... ) INTERNAL_CATCH_SECTION( __VA_ARGS__ ) + #define FAIL( ... ) INTERNAL_CATCH_MSG( Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, "FAIL", __VA_ARGS__ ) + #define SUCCEED( ... ) INTERNAL_CATCH_MSG( Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, "SUCCEED", __VA_ARGS__ ) +#else + #define TEST_CASE( name, description ) INTERNAL_CATCH_TESTCASE( name, description ) + #define TEST_CASE_METHOD( className, name, description ) INTERNAL_CATCH_TEST_CASE_METHOD( className, name, description ) + #define METHOD_AS_TEST_CASE( method, name, description ) INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, name, description ) + #define REGISTER_TEST_CASE( method, name, description ) INTERNAL_CATCH_REGISTER_TESTCASE( method, name, description ) + #define SECTION( name, description ) INTERNAL_CATCH_SECTION( name, description ) + #define FAIL( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, "FAIL", msg ) + #define SUCCEED( msg ) INTERNAL_CATCH_MSG( Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, "SUCCEED", msg ) +#endif +#define ANON_TEST_CASE() INTERNAL_CATCH_TESTCASE( "", "" ) + +#define REGISTER_REPORTER( name, reporterType ) INTERNAL_CATCH_REGISTER_REPORTER( name, reporterType ) +#define REGISTER_LEGACY_REPORTER( name, reporterType ) INTERNAL_CATCH_REGISTER_LEGACY_REPORTER( name, reporterType ) + +#define GENERATE( expr) INTERNAL_CATCH_GENERATE( expr ) + +#endif + +#define CATCH_TRANSLATE_EXCEPTION( signature ) INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature ) + +// "BDD-style" convenience wrappers +#ifdef CATCH_CONFIG_VARIADIC_MACROS +#define SCENARIO( ... ) TEST_CASE( "Scenario: " __VA_ARGS__ ) +#define SCENARIO_METHOD( className, ... ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ ) +#else +#define SCENARIO( name, tags ) TEST_CASE( "Scenario: " name, tags ) +#define SCENARIO_METHOD( className, name, tags ) INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " name, tags ) +#endif +#define GIVEN( desc ) SECTION( std::string(" Given: ") + desc, "" ) +#define WHEN( desc ) SECTION( std::string(" When: ") + desc, "" ) +#define AND_WHEN( desc ) SECTION( std::string("And when: ") + desc, "" ) +#define THEN( desc ) SECTION( std::string(" Then: ") + desc, "" ) +#define AND_THEN( desc ) SECTION( std::string(" And: ") + desc, "" ) + +using Catch::Detail::Approx; + +#endif // TWOBLUECUBES_SINGLE_INCLUDE_CATCH_HPP_INCLUDED + diff --git a/components/nvs_flash/test/crc.cpp b/components/nvs_flash/test/crc.cpp new file mode 100644 index 000000000..288b58a32 --- /dev/null +++ b/components/nvs_flash/test/crc.cpp @@ -0,0 +1,38 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include + +extern "C" unsigned long crc32_le(unsigned long crc_in, unsigned char const* data, unsigned int length) +{ + uint32_t i; + bool bit; + uint8_t c; + uint32_t crc = (uint32_t) crc_in; + + while (length--) { + c = *data++; + for (i = 0x80; i > 0; i >>= 1) { + bit = crc & 0x80000000; + if (c & i) { + bit = !bit; + } + crc <<= 1; + if (bit) { + crc ^= 0x04c11db7; + } + } + } + return crc; +} diff --git a/components/nvs_flash/test/crc.h b/components/nvs_flash/test/crc.h new file mode 100644 index 000000000..c752b3030 --- /dev/null +++ b/components/nvs_flash/test/crc.h @@ -0,0 +1,30 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef crc_h +#define crc_h + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +uint32_t crc32_le(uint32_t crc, const uint8_t* buf, size_t len); + +#ifdef __cplusplus +} +#endif + + +#endif /* crc_h */ diff --git a/components/nvs_flash/test/main.cpp b/components/nvs_flash/test/main.cpp new file mode 100644 index 000000000..0c7c351f4 --- /dev/null +++ b/components/nvs_flash/test/main.cpp @@ -0,0 +1,2 @@ +#define CATCH_CONFIG_MAIN +#include "catch.hpp" diff --git a/components/nvs_flash/test/spi_flash_emulation.cpp b/components/nvs_flash/test/spi_flash_emulation.cpp new file mode 100644 index 000000000..5185bd34c --- /dev/null +++ b/components/nvs_flash/test/spi_flash_emulation.cpp @@ -0,0 +1,97 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "esp_spi_flash.h" +#include "spi_flash_emulation.h" + + +static SpiFlashEmulator* s_emulator = nullptr; + +void spi_flash_emulator_set(SpiFlashEmulator* e) +{ + s_emulator = e; +} + +esp_err_t spi_flash_erase_sector(uint16_t sec) +{ + if (!s_emulator) { + return ESP_ERR_FLASH_OP_TIMEOUT; + } + + if (!s_emulator->erase(sec)) { + return ESP_ERR_FLASH_OP_FAIL; + } + + return ESP_OK; +} + +esp_err_t spi_flash_write(uint32_t des_addr, const uint32_t *src_addr, uint32_t size) +{ + if (!s_emulator) { + return ESP_ERR_FLASH_OP_TIMEOUT; + } + + if (!s_emulator->write(des_addr, src_addr, size)) { + return ESP_ERR_FLASH_OP_FAIL; + } + + return ESP_OK; +} + +esp_err_t spi_flash_read(uint32_t src_addr, uint32_t *des_addr, uint32_t size) +{ + if (!s_emulator) { + return ESP_ERR_FLASH_OP_TIMEOUT; + } + + if (!s_emulator->read(des_addr, src_addr, size)) { + return ESP_ERR_FLASH_OP_FAIL; + } + + return ESP_OK; +} + +// timing data for ESP8266, 160MHz CPU frequency, 80MHz flash requency +// all values in microseconds +// values are for block sizes starting at 4 bytes and going up to 4096 bytes +static size_t readTimes[] = {7, 5, 6, 7, 11, 18, 32, 60, 118, 231, 459}; +static size_t writeTimes[] = {19, 23, 35, 57, 106, 205, 417, 814, 1622, 3200, 6367}; +static size_t blockEraseTime = 37142; + + +static size_t timeInterp(uint32_t bytes, size_t* lut) +{ + int lz = __builtin_clz(bytes / 4); + int log_size = 32 - lz; + size_t x2 = 1 << (log_size + 2); + size_t y2 = lut[log_size]; + size_t x1 = 1 << (log_size + 1); + size_t y1 = lut[log_size - 1]; + return (bytes - x1) * (y2 - y1) / (x2 - x1) + y1; +} + +size_t SpiFlashEmulator::getReadOpTime(uint32_t bytes) +{ + return timeInterp(bytes, readTimes); +} + +size_t SpiFlashEmulator::getWriteOpTime(uint32_t bytes) +{ + return timeInterp(bytes, writeTimes); +} + +size_t SpiFlashEmulator::getEraseOpTime() +{ + return blockEraseTime; +} + diff --git a/components/nvs_flash/test/spi_flash_emulation.h b/components/nvs_flash/test/spi_flash_emulation.h new file mode 100644 index 000000000..a321c61b3 --- /dev/null +++ b/components/nvs_flash/test/spi_flash_emulation.h @@ -0,0 +1,198 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#ifndef spi_flash_emulation_h +#define spi_flash_emulation_h + +#include +#include +#include +#include +#include "esp_spi_flash.h" +#include "catch.hpp" + +using std::copy; +using std::begin; +using std::end; +using std::fill_n; + +class SpiFlashEmulator; + +void spi_flash_emulator_set(SpiFlashEmulator*); + +class SpiFlashEmulator +{ +public: + SpiFlashEmulator(size_t sectorCount) : mUpperSectorBound(sectorCount) + { + mData.resize(sectorCount * SPI_FLASH_SEC_SIZE / 4, 0xffffffff); + spi_flash_emulator_set(this); + } + + ~SpiFlashEmulator() + { + spi_flash_emulator_set(nullptr); + } + + bool read(uint32_t* dest, uint32_t srcAddr, size_t size) const + { + if (srcAddr % 4 != 0 || + size % 4 != 0 || + srcAddr + size > mData.size() * 4) { + return false; + } + + copy(begin(mData) + srcAddr / 4, begin(mData) + (srcAddr + size) / 4, dest); + + ++mReadOps; + mReadBytes += size; + mTotalTime += getReadOpTime(static_cast(size)); + return true; + } + + bool write(uint32_t dstAddr, const uint32_t* src, size_t size) + { + uint32_t sectorNumber = dstAddr/SPI_FLASH_SEC_SIZE; + if (sectorNumber < mLowerSectorBound || sectorNumber >= mUpperSectorBound) { + WARN("invalid flash operation detected: erase sector=" << sectorNumber); + return false; + } + + if (dstAddr % 4 != 0 || + size % 4 != 0 || + dstAddr + size > mData.size() * 4) { + return false; + } + + for (size_t i = 0; i < size / 4; ++i) { + uint32_t sv = src[i]; + size_t pos = dstAddr / 4 + i; + uint32_t& dv = mData[pos]; + + if (((~dv) & sv) != 0) { // are we trying to set some 0 bits to 1? + WARN("invalid flash operation detected: dst=" << dstAddr << " size=" << size << " i=" << i); + return false; + } + + dv = sv; + } + ++mWriteOps; + mWriteBytes += size; + mTotalTime += getWriteOpTime(static_cast(size)); + return true; + } + + bool erase(uint32_t sectorNumber) + { + size_t offset = sectorNumber * SPI_FLASH_SEC_SIZE / 4; + if (offset > mData.size()) { + return false; + } + + if (sectorNumber < mLowerSectorBound || sectorNumber >= mUpperSectorBound) { + WARN("invalid flash operation detected: erase sector=" << sectorNumber); + return false; + } + + std::fill_n(begin(mData) + offset, SPI_FLASH_SEC_SIZE / 4, 0xffffffff); + + ++mEraseOps; + mTotalTime += getEraseOpTime(); + return true; + } + + void randomize(uint32_t seed) + { + std::random_device rd; + std::mt19937 gen(rd()); + gen.seed(seed); + std::generate_n(mData.data(), mData.size(), gen); + } + + size_t size() const + { + return mData.size() * 4; + } + + const uint32_t* words() const + { + return mData.data(); + } + + const uint8_t* bytes() const + { + return reinterpret_cast(mData.data()); + } + + void clearStats() + { + mReadBytes = 0; + mWriteBytes = 0; + mEraseOps = 0; + mReadOps = 0; + mWriteOps = 0; + mTotalTime = 0; + } + + size_t getReadOps() const + { + return mReadOps; + } + size_t getWriteOps() const + { + return mWriteOps; + } + size_t getEraseOps() const + { + return mEraseOps; + } + size_t getReadBytes() const + { + return mReadBytes; + } + size_t getWriteBytes() const + { + return mWriteBytes; + } + size_t getTotalTime() const + { + return mTotalTime; + } + + void setBounds(uint32_t lowerSector, uint32_t upperSector) { + mLowerSectorBound = lowerSector; + mUpperSectorBound = upperSector; + } + +protected: + static size_t getReadOpTime(uint32_t bytes); + static size_t getWriteOpTime(uint32_t bytes); + static size_t getEraseOpTime(); + + + std::vector mData; + + mutable size_t mReadOps = 0; + mutable size_t mWriteOps = 0; + mutable size_t mReadBytes = 0; + mutable size_t mWriteBytes = 0; + mutable size_t mEraseOps = 0; + mutable size_t mTotalTime = 0; + size_t mLowerSectorBound = 0; + size_t mUpperSectorBound = 0; + +}; + + + +#endif /* spi_flash_emulation_h */ diff --git a/components/nvs_flash/test/test_compressed_enum_table.cpp b/components/nvs_flash/test/test_compressed_enum_table.cpp new file mode 100644 index 000000000..225a11c27 --- /dev/null +++ b/components/nvs_flash/test/test_compressed_enum_table.cpp @@ -0,0 +1,56 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "catch.hpp" +#include "compressed_enum_table.hpp" +#include + + +TEST_CASE("test if CompressedEnumTable works as expected", "[enumtable]") +{ + + enum class TEnum1 : uint32_t { + ZERO = 0, + ONE = 1, + TWO = 2, + THREE = 3, + }; + CompressedEnumTable table; + memset(table.data(), 0xff, table.byteSize()); + for (size_t i = 0; i < table.count(); ++i) { + CHECK(table.get(i) == TEnum1::THREE); + } + + table.set(0, TEnum1::ONE); + table.set(1, TEnum1::TWO); + table.set(2, TEnum1::ZERO); + table.set(3, TEnum1::ONE); + table.set(4, TEnum1::TWO); + table.set(5, TEnum1::ZERO); + table.set(6, TEnum1::ONE); + table.set(7, TEnum1::TWO); + table.set(8, TEnum1::ZERO); + table.set(9, TEnum1::ZERO); + table.set(10, TEnum1::ONE); + table.set(11, TEnum1::TWO); +// table.set(12, ... + table.set(13, TEnum1::ZERO); + table.set(14, TEnum1::ONE); + table.set(15, TEnum1::TWO); + + // b10010011100100001001001001001001 + // h 9 3 9 0 9 2 4 9 + + CHECK(table.data()[0] == 0x93909249); + +} \ No newline at end of file diff --git a/components/nvs_flash/test/test_intrusive_list.cpp b/components/nvs_flash/test/test_intrusive_list.cpp new file mode 100644 index 000000000..8fc7aa95d --- /dev/null +++ b/components/nvs_flash/test/test_intrusive_list.cpp @@ -0,0 +1,212 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "catch.hpp" +#include +#include +#include "intrusive_list.h" + +struct TestNode : public intrusive_list_node { + TestNode(const char* name_ = "", int num_ = 0) : num(num_) + { + strlcpy(name, name_, sizeof(name)); + } + char name[32]; + int num; +}; + +typedef intrusive_list TestList; + + +TEST_CASE("can add items to the list", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + REQUIRE(list.begin()->num == 1); + REQUIRE(list.front().num == 1); + REQUIRE(list.back().num == 1); + list.push_front(&n2); + REQUIRE(list.begin()->num == 2); + REQUIRE(list.front().num == 2); + REQUIRE(list.back().num == 1); + + list.insert(list.begin(), &n3); + REQUIRE(list.begin()->num == 3); + REQUIRE(list.front().num == 3); + REQUIRE(list.back().num == 1); + + + auto second = ++list.begin(); + REQUIRE(second->num == 2); + + second++; + REQUIRE(second->num == 1); +} + +TEST_CASE("can iterate over items", "[list]") +{ + TestList list; + + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + int val = 1; + for (auto it = std::begin(list); it != std::end(list); ++it) { + REQUIRE(it->num == val); + ++val; + } +} + +TEST_CASE("iterator's prefix and postfix increments and decrements behave as expected", "[list]") +{ + TestList list; + + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + auto it = std::begin(list); + REQUIRE((++it)->num == 2); + REQUIRE(it++->num == 2); + REQUIRE((--it)->num == 2); + REQUIRE(it--->num == 2); +} + +TEST_CASE("can pop_front from the list", "[list]") +{ + TestList list; + + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + list.pop_front(); + list.pop_front(); + list.pop_front(); + + REQUIRE(std::begin(list) == std::end(list)); +} + + +TEST_CASE("can erase first item in the list", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + list.erase(std::begin(list)); + + REQUIRE(list.front().num == 2); + REQUIRE(list.back().num == 3); +} + + +TEST_CASE("can erase last item in the list", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + list.erase(&list.back()); + + REQUIRE(list.front().num == 1); + REQUIRE(list.back().num == 2); +} + +TEST_CASE("can erase item in the middle of the list", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + list.erase(++std::begin(list)); + + REQUIRE(list.front().num == 1); + REQUIRE(list.back().num == 3); +} + +TEST_CASE("can erase all items in the list", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + + list.push_back(&n1); + list.push_back(&n2); + list.push_back(&n3); + + list.erase(std::begin(list)); + list.erase(std::begin(list)); + list.erase(std::begin(list)); + REQUIRE(std::begin(list) == std::end(list)); +} + + +TEST_CASE("can erase all items in the list using clear method", "[list]") +{ + TestList list; + TestNode n1("one", 1); + TestNode n2("two", 2); + TestNode n3("three", 3); + TestNode n4("four", 4); + TestNode n5("five", 5); + TestNode n6("six", 6); + + + list.push_back(&n1); + list.push_back(&n2); + list.insert(++list.begin(), &n3); + list.insert(++list.begin(), &n4); + list.push_front(&n5); + list.insert(list.begin(), &n6); + + list.clear(); + + REQUIRE(std::begin(list) == std::end(list)); +} + diff --git a/components/nvs_flash/test/test_nvs.cpp b/components/nvs_flash/test/test_nvs.cpp new file mode 100644 index 000000000..713513a03 --- /dev/null +++ b/components/nvs_flash/test/test_nvs.cpp @@ -0,0 +1,715 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "catch.hpp" +#include "nvs.hpp" +#include "nvs_flash.h" +#include "spi_flash_emulation.h" +#include +#include + +using namespace std; +using namespace nvs; + +stringstream s_perf; + +void dumpBytes(const uint8_t* data, size_t count) +{ + for (uint32_t i = 0; i < count; ++i) { + if (i % 32 == 0) { + printf("%08x ", i); + } + printf("%02x ", data[i]); + if ((i + 1) % 32 == 0) { + printf("\n"); + } + } +} + +TEST_CASE("crc32 behaves as expected", "[nvs]") +{ + Item item1; + item1.datatype = ItemType::I32; + item1.nsIndex = 1; + item1.crc32 = 0; + item1.reserved = 0xff; + fill_n(item1.key, sizeof(item1.key), 0xbb); + fill_n(item1.data, sizeof(item1.data), 0xaa); + + auto crc32_1 = item1.calculateCrc32(); + + Item item2 = item1; + item2.crc32 = crc32_1; + + CHECK(crc32_1 == item2.calculateCrc32()); + + item2 = item1; + item2.nsIndex = 2; + CHECK(crc32_1 != item2.calculateCrc32()); + + item2 = item1; + item2.datatype = ItemType::U32; + CHECK(crc32_1 != item2.calculateCrc32()); + + item2 = item1; + strlcpy(item2.key, "foo", Item::MAX_KEY_LENGTH); + CHECK(crc32_1 != item2.calculateCrc32()); +} + +TEST_CASE("starting with empty flash, page is in uninitialized state", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.state() == Page::PageState::INVALID); + CHECK(page.load(0) == ESP_OK); + CHECK(page.state() == Page::PageState::UNINITIALIZED); +} + +TEST_CASE("can distinguish namespaces", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + int32_t val1 = 0x12345678; + CHECK(page.writeItem(1, ItemType::I32, "intval1", &val1, sizeof(val1)) == ESP_OK); + int32_t val2 = 0x23456789; + CHECK(page.writeItem(2, ItemType::I32, "intval1", &val2, sizeof(val2)) == ESP_OK); + + int32_t readVal; + CHECK(page.readItem(2, ItemType::I32, "intval1", &readVal, sizeof(readVal)) == ESP_OK); + CHECK(readVal == val2); + +} + +TEST_CASE("reading with different type causes type mismatch error", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + int32_t val = 0x12345678; + CHECK(page.writeItem(1, ItemType::I32, "intval1", &val, sizeof(val)) == ESP_OK); + CHECK(page.readItem(1, ItemType::U32, "intval1", &val, sizeof(val)) == ESP_ERR_NVS_TYPE_MISMATCH); +} + +TEST_CASE("when page is erased, it's state becomes UNITIALIZED", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + int32_t val = 0x12345678; + CHECK(page.writeItem(1, ItemType::I32, "intval1", &val, sizeof(val)) == ESP_OK); + CHECK(page.erase() == ESP_OK); + CHECK(page.state() == Page::PageState::UNINITIALIZED); +} + +TEST_CASE("when writing and erasing, used/erased counts are updated correctly", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + CHECK(page.getUsedEntryCount() == 0); + CHECK(page.getErasedEntryCount() == 0); + uint32_t foo1 = 0; + CHECK(page.writeItem(1, "foo1", foo1) == ESP_OK); + CHECK(page.getUsedEntryCount() == 1); + CHECK(page.writeItem(2, "foo1", foo1) == ESP_OK); + CHECK(page.getUsedEntryCount() == 2); + CHECK(page.eraseItem(2, "foo1") == ESP_OK); + CHECK(page.getUsedEntryCount() == 1); + CHECK(page.getErasedEntryCount() == 1); + for (size_t i = 0; i < Page::ENTRY_COUNT - 2; ++i) { + char name[16]; + snprintf(name, sizeof(name), "i%ld", i); + CHECK(page.writeItem(1, name, i) == ESP_OK); + } + CHECK(page.getUsedEntryCount() == Page::ENTRY_COUNT - 1); + CHECK(page.getErasedEntryCount() == 1); + for (size_t i = 0; i < Page::ENTRY_COUNT - 2; ++i) { + char name[16]; + snprintf(name, sizeof(name), "i%ld", i); + CHECK(page.eraseItem(1, itemTypeOf(), name) == ESP_OK); + } + CHECK(page.getUsedEntryCount() == 1); + CHECK(page.getErasedEntryCount() == Page::ENTRY_COUNT - 1); +} + +TEST_CASE("when page is full, adding an element fails", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + for (size_t i = 0; i < Page::ENTRY_COUNT; ++i) { + char name[16]; + snprintf(name, sizeof(name), "i%ld", i); + CHECK(page.writeItem(1, name, i) == ESP_OK); + } + CHECK(page.state() == Page::PageState::FULL); + CHECK(page.writeItem(1, "foo", 64UL) == ESP_ERR_NVS_PAGE_FULL); + CHECK(page.state() == Page::PageState::FULL); +} + +TEST_CASE("page maintains its seq number") +{ + SpiFlashEmulator emu(1); + { + Page page; + CHECK(page.load(0) == ESP_OK); + CHECK(page.setSeqNumber(123) == ESP_OK); + int32_t val = 42; + CHECK(page.writeItem(1, ItemType::I32, "dummy", &val, sizeof(val)) == ESP_OK); + } + { + Page page; + CHECK(page.load(0) == ESP_OK); + uint32_t seqno; + CHECK(page.getSeqNumber(seqno) == ESP_OK); + CHECK(seqno == 123); + } +} + +TEST_CASE("can write and read variable length data", "[nvs]") +{ + SpiFlashEmulator emu(1); + Page page; + CHECK(page.load(0) == ESP_OK); + const char str[] = "foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234"; + size_t len = strlen(str); + CHECK(page.writeItem(1, "stuff1", 42) == ESP_OK); + CHECK(page.writeItem(1, "stuff2", 1) == ESP_OK); + CHECK(page.writeItem(1, ItemType::SZ, "foobaar", str, len + 1) == ESP_OK); + CHECK(page.writeItem(1, "stuff3", 2) == ESP_OK); + CHECK(page.writeItem(1, ItemType::BLOB, "baz", str, len) == ESP_OK); + CHECK(page.writeItem(1, "stuff4", 0x7abbccdd) == ESP_OK); + + char buf[sizeof(str) + 16]; + int32_t value; + CHECK(page.readItem(1, "stuff1", value) == ESP_OK); + CHECK(value == 42); + CHECK(page.readItem(1, "stuff2", value) == ESP_OK); + CHECK(value == 1); + CHECK(page.readItem(1, "stuff3", value) == ESP_OK); + CHECK(value == 2); + CHECK(page.readItem(1, "stuff4", value) == ESP_OK); + CHECK(value == 0x7abbccdd); + + fill_n(buf, sizeof(buf), 0xff); + CHECK(page.readItem(1, ItemType::SZ, "foobaar", buf, sizeof(buf)) == ESP_OK); + CHECK(memcmp(buf, str, strlen(str) + 1) == 0); + + fill_n(buf, sizeof(buf), 0xff); + CHECK(page.readItem(1, ItemType::BLOB, "baz", buf, sizeof(buf)) == ESP_OK); + CHECK(memcmp(buf, str, strlen(str)) == 0); +} + + +TEST_CASE("can init PageManager in empty flash", "[nvs]") +{ + SpiFlashEmulator emu(4); + PageManager pm; + CHECK(pm.load(0, 4) == ESP_OK); +} + +TEST_CASE("PageManager adds page in the correct order", "[nvs]") +{ + const size_t pageCount = 8; + SpiFlashEmulator emu(pageCount); + uint32_t pageNo[pageCount] = { -1U, 50, 11, -1U, 23, 22, 24, 49}; + + for (uint32_t i = 0; i < pageCount; ++i) { + Page p; + p.load(i); + if (pageNo[i] != -1U) { + p.setSeqNumber(pageNo[i]); + p.writeItem(1, "foo", 10U); + } + } + + PageManager pageManager; + CHECK(pageManager.load(0, pageCount) == ESP_OK); + + uint32_t lastSeqNo = 0; + for (auto it = std::begin(pageManager); it != std::end(pageManager); ++it) { + uint32_t seqNo; + CHECK(it->getSeqNumber(seqNo) == ESP_OK); + CHECK(seqNo > lastSeqNo); + } +} + +TEST_CASE("can init storage in empty flash", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + s_perf << "Time to init empty storage (4 sectors): " << emu.getTotalTime() << " us" << std::endl; +} + +TEST_CASE("storage doesn't add duplicates within one page", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + int bar = 0; + CHECK(storage.writeItem(1, "bar", bar) == ESP_OK); + CHECK(storage.writeItem(1, "bar", bar) == ESP_OK); + + Page page; + page.load(4); + CHECK(page.getUsedEntryCount() == 1); + CHECK(page.getErasedEntryCount() == 1); +} + +TEST_CASE("can write one item a thousand times", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + for (size_t i = 0; i < Page::ENTRY_COUNT * 4 * 2; ++i) { + REQUIRE(storage.writeItem(1, "i", static_cast(i)) == ESP_OK); + } + s_perf << "Time to write one item a thousand times: " << emu.getTotalTime() << " us (" << emu.getEraseOps() << " " << emu.getWriteOps() << " " << emu.getReadOps() << " " << emu.getWriteBytes() << " " << emu.getReadBytes() << ")" << std::endl; +} + +TEST_CASE("storage doesn't add duplicates within multiple pages", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + int bar = 0; + CHECK(storage.writeItem(1, "bar", bar) == ESP_OK); + for (size_t i = 0; i < Page::ENTRY_COUNT; ++i) { + CHECK(storage.writeItem(1, "foo", static_cast(bar)) == ESP_OK); + } + CHECK(storage.writeItem(1, "bar", bar) == ESP_OK); + + Page page; + page.load(4); + CHECK(page.findItem(1, itemTypeOf(), "bar") == ESP_ERR_NVS_NOT_FOUND); + page.load(5); + CHECK(page.findItem(1, itemTypeOf(), "bar") == ESP_OK); +} + +TEST_CASE("can write and read variable length data lots of times", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + const char str[] = "foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234"; + char buf[sizeof(str) + 16]; + size_t len = strlen(str); + for (size_t i = 0; i < Page::ENTRY_COUNT * 4 * 2; ++i) { + CAPTURE(i); + CHECK(storage.writeItem(1, ItemType::SZ, "foobaar", str, len + 1) == ESP_OK); + CHECK(storage.writeItem(1, "foo", static_cast(i)) == ESP_OK); + + uint32_t value; + CHECK(storage.readItem(1, "foo", value) == ESP_OK); + CHECK(value == i); + + fill_n(buf, sizeof(buf), 0xff); + CHECK(storage.readItem(1, ItemType::SZ, "foobaar", buf, sizeof(buf)) == ESP_OK); + CHECK(memcmp(buf, str, strlen(str) + 1) == 0); + } + s_perf << "Time to write one string and one integer a thousand times: " << emu.getTotalTime() << " us (" << emu.getEraseOps() << " " << emu.getWriteOps() << " " << emu.getReadOps() << " " << emu.getWriteBytes() << " " << emu.getReadBytes() << ")" << std::endl; +} + + +TEST_CASE("can get length of variable length data", "[nvs]") +{ + SpiFlashEmulator emu(8); + emu.randomize(200); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + const char str[] = "foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234foobar1234"; + size_t len = strlen(str); + CHECK(storage.writeItem(1, ItemType::SZ, "foobaar", str, len + 1) == ESP_OK); + size_t dataSize; + CHECK(storage.getItemDataSize(1, ItemType::SZ, "foobaar", dataSize) == ESP_OK); + CHECK(dataSize == len + 1); + + CHECK(storage.writeItem(2, ItemType::BLOB, "foobaar", str, len) == ESP_OK); + CHECK(storage.getItemDataSize(2, ItemType::BLOB, "foobaar", dataSize) == ESP_OK); + CHECK(dataSize == len); +} + + +TEST_CASE("can create namespaces", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + uint8_t nsi; + CHECK(storage.createOrOpenNamespace("wifi", false, nsi) == ESP_ERR_NVS_NOT_FOUND); + + CHECK(storage.createOrOpenNamespace("wifi", true, nsi) == ESP_OK); + Page page; + page.load(4); + CHECK(page.findItem(Page::NS_INDEX, ItemType::U8, "wifi") == ESP_OK); +} + +TEST_CASE("storage may become full", "[nvs]") +{ + SpiFlashEmulator emu(8); + Storage storage; + emu.setBounds(4, 8); + CHECK(storage.init(4, 4) == ESP_OK); + for (size_t i = 0; i < Page::ENTRY_COUNT * 3; ++i) { + char name[Item::MAX_KEY_LENGTH + 1]; + snprintf(name, sizeof(name), "key%05d", static_cast(i)); + REQUIRE(storage.writeItem(1, name, static_cast(i)) == ESP_OK); + } + REQUIRE(storage.writeItem(1, "foo", 10) == ESP_ERR_NVS_NOT_ENOUGH_SPACE); +} + +TEST_CASE("can modify an item on a page which will be erased", "[nvs]") +{ + SpiFlashEmulator emu(2); + Storage storage; + CHECK(storage.init(0, 2) == ESP_OK); + for (size_t i = 0; i < Page::ENTRY_COUNT * 3 + 1; ++i) { + REQUIRE(storage.writeItem(1, "foo", 42U) == ESP_OK); + } +} + + +#define TEST_ESP_ERR(rc, res) CHECK((rc) == (res)) +#define TEST_ESP_OK(rc) CHECK((rc) == ESP_OK) + +TEST_CASE("nvs api tests", "[nvs]") +{ + SpiFlashEmulator emu(10); + emu.randomize(100); + + nvs_handle handle_1; + const uint32_t NVS_FLASH_SECTOR = 6; + const uint32_t NVS_FLASH_SECTOR_COUNT_MIN = 3; + emu.setBounds(NVS_FLASH_SECTOR, NVS_FLASH_SECTOR + NVS_FLASH_SECTOR_COUNT_MIN); + + + TEST_ESP_ERR(nvs_open("namespace1", NVS_READWRITE, &handle_1), ESP_ERR_NVS_NOT_INITIALIZED); + for (uint16_t i = NVS_FLASH_SECTOR; i (count)); + + const uint32_t NVS_FLASH_SECTOR = 6; + const uint32_t NVS_FLASH_SECTOR_COUNT_MIN = 3; + emu.setBounds(NVS_FLASH_SECTOR, NVS_FLASH_SECTOR + NVS_FLASH_SECTOR_COUNT_MIN); + + TEST_ESP_OK(nvs_flash_init(NVS_FLASH_SECTOR, NVS_FLASH_SECTOR_COUNT_MIN)); + + nvs_handle handle_1; + TEST_ESP_ERR(nvs_open("namespace1", NVS_READONLY, &handle_1), ESP_ERR_NVS_NOT_FOUND); + + TEST_ESP_OK(nvs_open("namespace1", NVS_READWRITE, &handle_1)); + TEST_ESP_OK(nvs_set_i32(handle_1, "foo", 0x12345678)); + for (size_t i = 0; i < 500; ++i) { + nvs_handle handle_2; + TEST_ESP_OK(nvs_open("namespace2", NVS_READWRITE, &handle_2)); + TEST_ESP_OK(nvs_set_i32(handle_1, "foo", 0x23456789 % (i + 1))); + TEST_ESP_OK(nvs_set_i32(handle_2, "foo", static_cast(i))); + const char* str = "value 0123456789abcdef0123456789abcdef %09d"; + char str_buf[128]; + snprintf(str_buf, sizeof(str_buf), str, i + count * 1024); + TEST_ESP_OK(nvs_set_str(handle_2, "key", str_buf)); + + int32_t v1; + TEST_ESP_OK(nvs_get_i32(handle_1, "foo", &v1)); + CHECK(0x23456789 % (i + 1) == v1); + + int32_t v2; + TEST_ESP_OK(nvs_get_i32(handle_2, "foo", &v2)); + CHECK(static_cast(i) == v2); + + char buf[128]; + size_t buf_len = sizeof(buf); + + TEST_ESP_OK(nvs_get_str(handle_2, "key", buf, &buf_len)); + + CHECK(0 == strcmp(buf, str_buf)); + nvs_close(handle_2); + } + nvs_close(handle_1); + } +} + +template +esp_err_t doRandomThings(nvs_handle handle, TGen gen, size_t count) { + + const char* keys[] = {"foo", "bar", "longkey_0123456", "another key", "param1", "param2", "param3", "param4", "param5"}; + const ItemType types[] = {ItemType::I32, ItemType::I32, ItemType::U64, ItemType::U64, ItemType::SZ, ItemType::SZ, ItemType::SZ, ItemType::SZ, ItemType::SZ}; + + int32_t v1 = 0, v2 = 0; + uint64_t v3 = 0, v4 = 0; + const size_t strBufLen = 1024; + char v5[strBufLen], v6[strBufLen], v7[strBufLen], v8[strBufLen], v9[strBufLen]; + + void* values[] = {&v1, &v2, &v3, &v4, &v5, &v6, &v7, &v8, &v9}; + + const size_t nKeys = sizeof(keys) / sizeof(keys[0]); + static_assert(nKeys == sizeof(types) / sizeof(types[0]), ""); + static_assert(nKeys == sizeof(values) / sizeof(values[0]), ""); + + bool written[nKeys]; + std::fill_n(written, nKeys, false); + + auto generateRandomString = [](char* dst, size_t size) { + size_t len = 0; + }; + + auto randomRead = [&](size_t index) -> esp_err_t { + switch (types[index]) { + case ItemType::I32: + { + int32_t val; + auto err = nvs_get_i32(handle, keys[index], &val); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + if (!written[index]) { + REQUIRE(err == ESP_ERR_NVS_NOT_FOUND); + } + else { + REQUIRE(val == *reinterpret_cast(values[index])); + } + break; + } + + case ItemType::U64: + { + uint64_t val; + auto err = nvs_get_u64(handle, keys[index], &val); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + if (!written[index]) { + REQUIRE(err == ESP_ERR_NVS_NOT_FOUND); + } + else { + REQUIRE(val == *reinterpret_cast(values[index])); + } + break; + } + + case ItemType::SZ: + { + char buf[strBufLen]; + size_t len = strBufLen; + auto err = nvs_get_str(handle, keys[index], buf, &len); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + if (!written[index]) { + REQUIRE(err == ESP_ERR_NVS_NOT_FOUND); + } + else { + REQUIRE(strncmp(buf, reinterpret_cast(values[index]), strBufLen)); + } + break; + } + + default: + assert(0); + } + return ESP_OK; + }; + + auto randomWrite = [&](size_t index) -> esp_err_t { + switch (types[index]) { + case ItemType::I32: + { + int32_t val = static_cast(gen()); + *reinterpret_cast(values[index]) = val; + + auto err = nvs_set_i32(handle, keys[index], val); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + REQUIRE(err == ESP_OK); + written[index] = true; + break; + } + + case ItemType::U64: + { + uint64_t val = static_cast(gen()); + *reinterpret_cast(values[index]) = val; + + auto err = nvs_set_u64(handle, keys[index], val); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + REQUIRE(err == ESP_OK); + written[index] = true; + break; + } + + case ItemType::SZ: + { + char buf[strBufLen]; + size_t len = strBufLen; + + size_t strLen = gen() % (strBufLen - 1); + std::generate_n(buf, strLen, [&]() -> char { + const char c = static_cast(gen() % 127); + return (c < 32) ? 32 : c; + }); + + auto err = nvs_set_str(handle, keys[index], buf); + if (err == ESP_ERR_FLASH_OP_FAIL) { + return err; + } + REQUIRE(err == ESP_OK); + written[index] = true; + break; + } + + default: + assert(0); + } + return ESP_OK; + }; + + + for (size_t i = 0; i < count; ++i) { + size_t index = gen() % nKeys; + switch (gen() % 3) { + case 0: // read, 1/3 + if (randomRead(index) == ESP_ERR_FLASH_OP_FAIL) { + return ESP_ERR_FLASH_OP_FAIL; + } + break; + + default: // write, 2/3 + if (randomWrite(index) == ESP_ERR_FLASH_OP_FAIL) { + return ESP_ERR_FLASH_OP_FAIL; + } + break; + } + } + return ESP_OK; +} + +TEST_CASE("monkey test", "[nvs][monkey]") +{ + std::random_device rd; + std::mt19937 gen(rd()); + uint32_t seed = 3; + gen.seed(seed); + + SpiFlashEmulator emu(10); + emu.randomize(seed); + + const uint32_t NVS_FLASH_SECTOR = 6; + const uint32_t NVS_FLASH_SECTOR_COUNT_MIN = 3; + emu.setBounds(NVS_FLASH_SECTOR, NVS_FLASH_SECTOR + NVS_FLASH_SECTOR_COUNT_MIN); + + TEST_ESP_OK(nvs_flash_init(NVS_FLASH_SECTOR, NVS_FLASH_SECTOR_COUNT_MIN)); + + nvs_handle handle; + TEST_ESP_OK(nvs_open("namespace1", NVS_READWRITE, &handle)); + + CHECK(doRandomThings(handle, gen, 10000) == ESP_OK); + +} + +TEST_CASE("dump all performance data", "[nvs]") +{ + std::cout << "====================" << std::endl << "Dumping benchmarks" << std::endl; + std::cout << s_perf.str() << std::endl; + std::cout << "====================" << std::endl; +} diff --git a/components/nvs_flash/test/test_spi_flash_emulation.cpp b/components/nvs_flash/test/test_spi_flash_emulation.cpp new file mode 100644 index 000000000..ea233da61 --- /dev/null +++ b/components/nvs_flash/test/test_spi_flash_emulation.cpp @@ -0,0 +1,154 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include "catch.hpp" +#include "esp_spi_flash.h" +#include "spi_flash_emulation.h" + +using namespace std; + +template +bool range_empty_n(Tit it_begin, size_t n) +{ + return all_of(it_begin, it_begin + n, bind(equal_to(), placeholders::_1, 0xffffffff)); +} + +TEST_CASE("flash starts with all bytes == 0xff", "[spi_flash_emu]") +{ + SpiFlashEmulator emu(4); + + uint8_t sector[SPI_FLASH_SEC_SIZE]; + + for (int i = 0; i < 4; ++i) { + CHECK(spi_flash_read(0, reinterpret_cast(sector), sizeof(sector)) == ESP_OK); + for (auto v: sector) { + CHECK(v == 0xff); + } + } +} + +TEST_CASE("invalid writes are checked", "[spi_flash_emu]") +{ + SpiFlashEmulator emu(1); + + uint32_t val = 0; + CHECK(spi_flash_write(0, &val, 4) == ESP_OK); + val = 1; + CHECK(spi_flash_write(0, &val, 4) == ESP_ERR_FLASH_OP_FAIL); +} + + +TEST_CASE("out of bounds writes fail", "[spi_flash_emu]") +{ + SpiFlashEmulator emu(4); + uint32_t vals[8]; + std::fill_n(vals, 8, 0); + CHECK(spi_flash_write(0, vals, sizeof(vals)) == ESP_OK); + + CHECK(spi_flash_write(4*4096 - sizeof(vals), vals, sizeof(vals)) == ESP_OK); + + CHECK(spi_flash_write(4*4096 - sizeof(vals) + 4, vals, sizeof(vals)) == ESP_ERR_FLASH_OP_FAIL); +} + + +TEST_CASE("after erase the sector is set to 0xff", "[spi_flash_emu]") +{ + SpiFlashEmulator emu(4); + uint32_t val1 = 0xab00cd12; + CHECK(spi_flash_write(0, &val1, sizeof(val1)) == ESP_OK); + uint32_t val2 = 0x5678efab; + CHECK(spi_flash_write(4096 - 4, &val2, sizeof(val2)) == ESP_OK); + + CHECK(emu.words()[0] == val1); + CHECK(range_empty_n(emu.words() + 1, 4096 / 4 - 2)); + CHECK(emu.words()[4096 / 4 - 1] == val2); + + CHECK(spi_flash_erase_sector(0) == ESP_OK); + + CHECK(emu.words()[0] == 0xffffffff); + CHECK(range_empty_n(emu.words() + 1, 4096 / 4 - 2)); + CHECK(emu.words()[4096 / 4 - 1] == 0xffffffff); +} + +TEST_CASE("read/write/erase operation times are calculated correctly", "[spi_flash_emu]") +{ + SpiFlashEmulator emu(1); + uint32_t data[128]; + spi_flash_read(0, data, 4); + CHECK(emu.getTotalTime() == 7); + CHECK(emu.getReadOps() == 1); + CHECK(emu.getReadBytes() == 4); + emu.clearStats(); + spi_flash_read(0, data, 8); + CHECK(emu.getTotalTime() == 5); + CHECK(emu.getReadOps() == 1); + CHECK(emu.getReadBytes() == 8); + emu.clearStats(); + spi_flash_read(0, data, 16); + CHECK(emu.getTotalTime() == 6); + CHECK(emu.getReadOps() == 1); + CHECK(emu.getReadBytes() == 16); + emu.clearStats(); + spi_flash_read(0, data, 128); + CHECK(emu.getTotalTime() == 18); + CHECK(emu.getReadOps() == 1); + CHECK(emu.getReadBytes() == 128); + emu.clearStats(); + spi_flash_read(0, data, 256); + CHECK(emu.getTotalTime() == 32); + emu.clearStats(); + spi_flash_read(0, data, (128+256)/2); + CHECK(emu.getTotalTime() == (18+32)/2); + emu.clearStats(); + + spi_flash_write(0, data, 4); + CHECK(emu.getTotalTime() == 19); + CHECK(emu.getWriteOps() == 1); + CHECK(emu.getWriteBytes() == 4); + emu.clearStats(); + CHECK(emu.getWriteOps() == 0); + CHECK(emu.getWriteBytes() == 0); + spi_flash_write(0, data, 8); + CHECK(emu.getTotalTime() == 23); + emu.clearStats(); + spi_flash_write(0, data, 16); + CHECK(emu.getTotalTime() == 35); + CHECK(emu.getWriteOps() == 1); + CHECK(emu.getWriteBytes() == 16); + emu.clearStats(); + spi_flash_write(0, data, 128); + CHECK(emu.getTotalTime() == 205); + emu.clearStats(); + spi_flash_write(0, data, 256); + CHECK(emu.getTotalTime() == 417); + emu.clearStats(); + spi_flash_write(0, data, (128+256)/2); + CHECK(emu.getTotalTime() == (205+417)/2); + emu.clearStats(); + + spi_flash_erase_sector(0); + CHECK(emu.getEraseOps() == 1); + CHECK(emu.getTotalTime() == 37142); +} + +TEST_CASE("data is randomized predicatbly", "[spi_flash_emu]") +{ + SpiFlashEmulator emu1(3); + emu1.randomize(0x12345678); + + SpiFlashEmulator emu2(3); + emu2.randomize(0x12345678); + + CHECK(std::equal(emu1.bytes(), emu1.bytes() + emu1.size(), emu2.bytes())); +} + diff --git a/components/partition_table/Kconfig.projbuild b/components/partition_table/Kconfig.projbuild new file mode 100644 index 000000000..fa2685d7a --- /dev/null +++ b/components/partition_table/Kconfig.projbuild @@ -0,0 +1,50 @@ +menu "Partition Table" + +choice + prompt "Partition Table" + default PARTITION_TABLE_SINGLE_APP + help + The partition table to flash to the ESP32. The partition table + determines where apps, data and other resources are expected to + be found. + + The predefined partition table CSV descriptions can be found + in the components/partition_table directory. Otherwise it's + possible to create a new custom partition CSV for your application. + +config PARTITION_TABLE_SINGLE_APP + bool "Single factory app, no OTA" +config PARTITION_TABLE_TWO_OTA + bool "Factory app, two OTA definitions" +config PARTITION_TABLE_CUSTOM + bool "Custom partition table CSV" +endchoice + +config PARTITION_TABLE_CUSTOM_FILENAME + string "Custom partition CSV file" if PARTITION_TABLE_CUSTOM + default partitions.csv + help + Name of the custom partition CSV filename. This path is evaluated + relative to the project root directory. + +config PARTITION_TABLE_CUSTOM_APP_BIN_OFFSET + hex "App offset in flash" if PARTITION_TABLE_CUSTOM + default 0x10000 + help + If using a custom partition table, specify the offset in the flash + where 'make flash' should write the built app. + +config PARTITION_TABLE_FILENAME + string + default partitions_singleapp.csv if PARTITION_TABLE_SINGLE_APP + default partitions_two_ota.csv if PARTITION_TABLE_TWO_OTA + default PARTITION_TABLE_CUSTOM_FILENAME if PARTITION_TABLE_CUSTOM + +config APP_OFFSET + hex + default PARTITION_TABLE_CUSTOM_APP_BIN_OFFSET if PARTITION_TABLE_CUSTOM + default 0x10000 # this is the factory app offset used by the default tables + +endmenu + + diff --git a/components/partition_table/Makefile.projbuild b/components/partition_table/Makefile.projbuild new file mode 100644 index 000000000..99ed60d28 --- /dev/null +++ b/components/partition_table/Makefile.projbuild @@ -0,0 +1,42 @@ +# +# Partition table +# +# The partition table is not a real component that gets linked into +# the project. Instead, it is a standalone project to generate +# the partition table binary as part of the build process. This +# binary is then added to the list of files for esptool.py to flash. +# +.PHONY: partition_table partition_table-flash partition_table-clean + +EXTRA_CLEAN_TARGETS+=partition_table-clean + +# NB: gen_esp32part.py lives in the sdk/bin/ dir not component dir +GEN_ESP32PART := $(PYTHON) $(SDK_PATH)/bin/gen_esp32part.py -q + +# Path to partition CSV file is relative to project path for custom +# partition CSV files, but relative to component dir otherwise.$ +PARTITION_TABLE_ROOT := $(call dequote,$(if $(CONFIG_PARTITION_TABLE_CUSTOM),$(PROJECT_PATH),$(COMPONENT_PATH))) +PARTITION_TABLE_CSV_PATH := $(call dequote,$(abspath $(PARTITION_TABLE_ROOT)/$(subst $(quote),,$(CONFIG_PARTITION_TABLE_FILENAME)))) + +PARTITION_TABLE_BIN := $(BUILD_DIR_BASE)/$(notdir $(PARTITION_TABLE_CSV_PATH:.csv=.bin)) + +$(PARTITION_TABLE_BIN): $(PARTITION_TABLE_CSV_PATH) + @echo "Building partitions from $(PARTITION_TABLE_CSV_PATH)..." + $(Q) $(GEN_ESP32PART) $< $@ + +PARTITION_TABLE_FLASH_CMD = $(ESPTOOLPY_SERIAL) write_flash 0x4000 $(PARTITION_TABLE_BIN) + +partition_table: $(PARTITION_TABLE_BIN) + @echo "Partition table binary generated. Contents:" + @echo $(SEPARATOR) + $(Q) $(GEN_ESP32PART) $< + @echo $(SEPARATOR) + @echo "Partition flashing command:" + @echo "$(PARTITION_TABLE_FLASH_CMD)" + +partition_table-flash: $(PARTITION_TABLE_BIN) + @echo "Flashing partition table..." + $(Q) $(PARTITION_TABLE_FLASH_CMD) + +partition_table-clean: + $(Q) rm -f $(PARTITION_TABLE_BIN) diff --git a/components/partition_table/partitions_singleapp.csv b/components/partition_table/partitions_singleapp.csv new file mode 100644 index 000000000..940b8a76c --- /dev/null +++ b/components/partition_table/partitions_singleapp.csv @@ -0,0 +1,4 @@ +# Name, Type, SubType, Offset, Size +factory, app, factory, 0x10000, 1M +rfdata, data, rf, , 256K +wifidata, data, wifi, , 256K diff --git a/components/partition_table/partitions_two_ota.csv b/components/partition_table/partitions_two_ota.csv new file mode 100644 index 000000000..8e064e14b --- /dev/null +++ b/components/partition_table/partitions_two_ota.csv @@ -0,0 +1,7 @@ +# Name, Type, SubType, Offset, Size +factory, 0, 0, 0x10000, 1M +ota_0, 0, ota_0, , 1M +ota_1, 0, ota_1, , 1M +rfdata, data, rf, , 256K +wifidata, data, wifi, , 256K +otadata, data, ota, , 256K diff --git a/components/partition_table/tests/gen_esp32part_tests.py b/components/partition_table/tests/gen_esp32part_tests.py new file mode 100755 index 000000000..413f1aac9 --- /dev/null +++ b/components/partition_table/tests/gen_esp32part_tests.py @@ -0,0 +1,313 @@ +#!/usr/bin/env python +import unittest +import struct +import csv +import sys +import subprocess +import tempfile +import os +sys.path.append("..") +from gen_esp32part import * + +SIMPLE_CSV = """ +# Name,Type,SubType,Offset,Size +factory,0,2,65536,1048576 +""" + +LONGER_BINARY_TABLE = "" +# type 0x00, subtype 0x00, +# offset 64KB, size 1MB +LONGER_BINARY_TABLE += "\xAA\x50\x00\x00" + \ + "\x00\x00\x01\x00" + \ + "\x00\x00\x10\x00" + \ + "factory\0" + ("\0"*8) + \ + "\x00\x00\x00\x00" +# type 0x01, subtype 0x20, +# offset 0x110000, size 128KB +LONGER_BINARY_TABLE += "\xAA\x50\x01\x20" + \ + "\x00\x00\x11\x00" + \ + "\x00\x02\x00\x00" + \ + "data" + ("\0"*12) + \ + "\x00\x00\x00\x00" +# type 0x10, subtype 0x00, +# offset 0x150000, size 1MB +LONGER_BINARY_TABLE += "\xAA\x50\x10\x00" + \ + "\x00\x00\x15\x00" + \ + "\x00\x10\x00\x00" + \ + "second" + ("\0"*10) + \ + "\x00\x00\x00\x00" + + +class CSVParserTests(unittest.TestCase): + + def test_simple_partition(self): + table = PartitionTable.from_csv(SIMPLE_CSV) + self.assertEqual(len(table), 1) + self.assertEqual(table[0].name, "factory") + self.assertEqual(table[0].type, 0) + self.assertEqual(table[0].subtype, 2) + self.assertEqual(table[0].offset, 65536) + self.assertEqual(table[0].size, 1048576) + + + def test_require_type(self): + csv = """ +# Name,Type, SubType,Offset,Size +ihavenotype, +""" + with self.assertRaisesRegexp(InputError, "type"): + PartitionTable.from_csv(csv) + + + def test_type_subtype_names(self): + csv_magicnumbers = """ +# Name, Type, SubType, Offset, Size +myapp, 0, 0,, 0x100000 +myota_0, 0, 0x10,, 0x100000 +myota_1, 0, 0x11,, 0x100000 +myota_15, 0, 0x1f,, 0x100000 +mytest, 0, 0x20,, 0x100000 +myota_status, 1, 0,, 0x100000 + """ + csv_nomagicnumbers = """ +# Name, Type, SubType, Offset, Size +myapp, app, factory,, 0x100000 +myota_0, app, ota_0,, 0x100000 +myota_1, app, ota_1,, 0x100000 +myota_15, app, ota_15,, 0x100000 +mytest, app, test,, 0x100000 +myota_status, data, ota,, 0x100000 +""" + # make two equivalent partition tables, one using + # magic numbers and one using shortcuts. Ensure they match + magic = PartitionTable.from_csv(csv_magicnumbers) + magic.verify() + nomagic = PartitionTable.from_csv(csv_nomagicnumbers) + nomagic.verify() + + self.assertEqual(nomagic["myapp"].type, 0) + self.assertEqual(nomagic["myapp"].subtype, 0) + self.assertEqual(nomagic["myapp"], magic["myapp"]) + self.assertEqual(nomagic["myota_0"].type, 0) + self.assertEqual(nomagic["myota_0"].subtype, 0x10) + self.assertEqual(nomagic["myota_0"], magic["myota_0"]) + self.assertEqual(nomagic["myota_15"], magic["myota_15"]) + self.assertEqual(nomagic["mytest"], magic["mytest"]) + self.assertEqual(nomagic["myota_status"], magic["myota_status"]) + + #self.assertEqual(nomagic.to_binary(), magic.to_binary()) + + def test_unit_suffixes(self): + csv = """ +# Name, Type, Subtype, Offset, Size +one_megabyte, app, factory, 32k, 1M +""" + t = PartitionTable.from_csv(csv) + t.verify() + self.assertEqual(t[0].offset, 32*1024) + self.assertEqual(t[0].size, 1*1024*1024) + + def test_default_offsets(self): + csv = """ +# Name, Type, Subtype, Offset, Size +first, app, factory,, 1M +second, data, 0x15,, 1M +minidata, data, 0x40,, 32K +otherapp, app, factory,, 1M + """ + t = PartitionTable.from_csv(csv) + # 'first' + self.assertEqual(t[0].offset, 0x010000) # 64KB boundary as it's an app image + self.assertEqual(t[0].size, 0x100000) # Size specified in CSV + # 'second' + self.assertEqual(t[1].offset, 0x110000) # prev offset+size + self.assertEqual(t[1].size, 0x100000) # Size specified in CSV + # 'minidata' + self.assertEqual(t[2].offset, 0x210000) + # 'otherapp' + self.assertEqual(t[3].offset, 0x220000) # 64KB boundary as it's an app image + + def test_negative_size_to_offset(self): + csv = """ +# Name, Type, Subtype, Offset, Size +first, app, factory, 0x10000, -2M +second, data, 0x15, , 1M + """ + t = PartitionTable.from_csv(csv) + t.verify() + # 'first' + self.assertEqual(t[0].offset, 0x10000) # in CSV + self.assertEqual(t[0].size, 0x200000 - t[0].offset) # Up to 2M + # 'second' + self.assertEqual(t[1].offset, 0x200000) # prev offset+size + + def test_overlapping_offsets_fail(self): + csv = """ +first, app, factory, 0x100000, 2M +second, app, ota_0, 0x200000, 1M +""" + t = PartitionTable.from_csv(csv) + with self.assertRaisesRegexp(InputError, "overlap"): + t.verify() + +class BinaryOutputTests(unittest.TestCase): + def test_binary_entry(self): + csv = """ +first, 0x30, 0xEE, 0x100400, 0x300000 +""" + t = PartitionTable.from_csv(csv) + tb = t.to_binary() + self.assertEqual(len(tb), 32) + self.assertEqual('\xAA\x50', tb[0:2]) # magic + self.assertEqual('\x30\xee', tb[2:4]) # type, subtype + eo, es = struct.unpack(" +#include +#include + +#include +#include +#include +#include +#include + +static esp_err_t spi_flash_translate_rc(SpiFlashOpResult rc) +{ + switch (rc) { + case SPI_FLASH_RESULT_OK: + return ESP_OK; + case SPI_FLASH_RESULT_TIMEOUT: + return ESP_ERR_FLASH_OP_TIMEOUT; + case SPI_FLASH_RESULT_ERR: + default: + return ESP_ERR_FLASH_OP_FAIL; + } +} + +extern void Cache_Flush(int); + +static void IRAM_ATTR spi_flash_disable_interrupts_caches_and_app_cpu() +{ + vTaskSuspendAll(); + // SET_PERI_REG_MASK(APPCPU_CTRL_REG_C, DPORT_APPCPU_RUNSTALL); + Cache_Read_Disable(0); + Cache_Read_Disable(1); +} + +static void IRAM_ATTR spi_flash_enable_interrupts_caches_and_app_cpu() +{ + Cache_Read_Enable(0); + Cache_Read_Enable(1); + // CLEAR_PERI_REG_MASK(APPCPU_CTRL_REG_C, DPORT_APPCPU_RUNSTALL); + xTaskResumeAll(); +} + +esp_err_t IRAM_ATTR spi_flash_erase_sector(uint16_t sec) +{ + spi_flash_disable_interrupts_caches_and_app_cpu(); + SpiFlashOpResult rc; + if (xPortGetCoreID() == 1) { + rc = SPI_FLASH_RESULT_ERR; + } + else { + rc = SPIUnlock(); + if (rc == SPI_FLASH_RESULT_OK) { + rc = SPIEraseSector(sec); + } + } + Cache_Flush(0); + Cache_Flush(1); + spi_flash_enable_interrupts_caches_and_app_cpu(); + return spi_flash_translate_rc(rc); +} + +esp_err_t IRAM_ATTR spi_flash_write(uint32_t dest_addr, const uint32_t *src, uint32_t size) +{ + spi_flash_disable_interrupts_caches_and_app_cpu(); + SpiFlashOpResult rc; + if (xPortGetCoreID() == 1) { + rc = SPI_FLASH_RESULT_ERR; + } + else { + rc = SPIUnlock(); + if (rc == SPI_FLASH_RESULT_OK) { + rc = SPIWrite(dest_addr, src, (int32_t) size); + } + } + Cache_Flush(0); + Cache_Flush(1); + spi_flash_enable_interrupts_caches_and_app_cpu(); + return spi_flash_translate_rc(rc); +} + +esp_err_t IRAM_ATTR spi_flash_read(uint32_t src_addr, uint32_t *dest, uint32_t size) +{ + spi_flash_disable_interrupts_caches_and_app_cpu(); + SpiFlashOpResult rc; + if (xPortGetCoreID() == 1) { + rc = SPI_FLASH_RESULT_ERR; + } + else { + rc = SPIRead(src_addr, dest, (int32_t) size); + } + spi_flash_enable_interrupts_caches_and_app_cpu(); + return spi_flash_translate_rc(rc); +} diff --git a/components/spi_flash/include/esp_spi_flash.h b/components/spi_flash/include/esp_spi_flash.h new file mode 100644 index 000000000..aa12b2aa4 --- /dev/null +++ b/components/spi_flash/include/esp_spi_flash.h @@ -0,0 +1,69 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef ESP_SPI_FLASH_H +#define ESP_SPI_FLASH_H + +#include +#include "esp_err.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define ESP_ERR_FLASH_BASE 0x10010 +#define ESP_ERR_FLASH_OP_FAIL (ESP_ERR_FLASH_BASE + 1) +#define ESP_ERR_FLASH_OP_TIMEOUT (ESP_ERR_FLASH_BASE + 2) + +#define SPI_FLASH_SEC_SIZE 4096 /**< SPI Flash sector size */ + +/** + * @brief Erase the Flash sector. + * + * @param uint16 sec : Sector number, the count starts at sector 0, 4KB per sector. + * + * @return esp_err_t + */ +esp_err_t spi_flash_erase_sector(uint16_t sec); + +/** + * @brief Write data to Flash. + * + * @param uint32 des_addr : destination address in Flash. + * @param uint32 *src_addr : source address of the data. + * @param uint32 size : length of data + * + * @return esp_err_t + */ +esp_err_t spi_flash_write(uint32_t des_addr, const uint32_t *src_addr, uint32_t size); + +/** + * @brief Read data from Flash. + * + * @param uint32 src_addr : source address of the data in Flash. + * @param uint32 *des_addr : destination address. + * @param uint32 size : length of data + * + * @return esp_err_t + */ +esp_err_t spi_flash_read(uint32_t src_addr, uint32_t *des_addr, uint32_t size); + + +#ifdef __cplusplus +} +#endif + + +#endif /* ESP_SPI_FLASH_H */ + diff --git a/components/tcpip_adapter/Makefile b/components/tcpip_adapter/Makefile new file mode 100755 index 000000000..6fd5e726d --- /dev/null +++ b/components/tcpip_adapter/Makefile @@ -0,0 +1,12 @@ +# +# Component Makefile +# +# This Makefile should, at the very least, just include $(SDK_PATH)/make/component.mk. By default, +# this will take the sources in this directory, compile them and link them into +# lib(subdirectory_name).a in the build directory. This behaviour is entirely configurable, +# please read the SDK documents if you need to do this. +# + +EXTRA_CFLAGS := -DLWIP_ESP8266 + +include $(SDK_PATH)/make/component.mk diff --git a/components/tcpip_adapter/include/tcpip_adapter.h b/components/tcpip_adapter/include/tcpip_adapter.h new file mode 100644 index 000000000..7996632f3 --- /dev/null +++ b/components/tcpip_adapter/include/tcpip_adapter.h @@ -0,0 +1,100 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. + +#ifndef _TCPIP_ADAPTER_H_ +#define _TCPIP_ADAPTER_H_ + +#include + +#include "esp_wifi.h" + +#define CONFIG_TCPIP_LWIP 1 + +#if CONFIG_TCPIP_LWIP +#include "lwip/ip_addr.h" + +struct ip_info { + ip4_addr_t ip; + ip4_addr_t netmask; + ip4_addr_t gw; +}; +#endif + +#define ESP_ERR_TCPIP_ADAPTER_BASE 0x5000 // base should be moved to esp_err.h + +#define ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS ESP_ERR_TCPIP_ADAPTER_BASE + 0x00 +#define ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY ESP_ERR_TCPIP_ADAPTER_BASE + 0x01 +#define ESP_ERR_TCPIP_ADAPTER_DHCPC_START_FAILED ESP_ERR_TCPIP_ADAPTER_BASE + 0x02 +#define ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STARTED ESP_ERR_TCPIP_ADAPTER_BASE + 0x03 +#define ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STOPED ESP_ERR_TCPIP_ADAPTER_BASE + 0x04 + +/* will add ethernet interface */ +typedef enum { + TCPIP_ADAPTER_IF_STA = 0, /**< ESP32 station interface */ + TCPIP_ADAPTER_IF_AP, /**< ESP32 soft-AP interface */ + TCPIP_ADAPTER_IF_MAX +} tcpip_adapter_if_t; + +typedef enum { + TCPIP_ADAPTER_DHCP_INIT = 0, + TCPIP_ADAPTER_DHCP_STARTED, + TCPIP_ADAPTER_DHCP_STOPED, + TCPIP_ADAPTER_DHCP_STATUS_MAX +} tcpip_adapter_dhcp_status_t; + +void tcpip_adapter_init(void); + +esp_err_t tcpip_adapter_start(tcpip_adapter_if_t tcpip_if, uint8_t *mac, struct ip_info *info); + +esp_err_t tcpip_adapter_stop(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_up(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_down(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_get_ip_info(tcpip_adapter_if_t tcpip_if, struct ip_info *if_ip); + +esp_err_t tcpip_adapter_set_ip_info(tcpip_adapter_if_t tcpip_if, struct ip_info *if_ip); + +#if 0 +esp_err_t tcpip_adapter_get_mac(tcpip_adapter_if_t tcpip_if, uint8_t *mac); + +esp_err_t tcpip_adapter_set_mac(tcpip_adapter_if_t tcpip_if, uint8_t *mac); +#endif + +esp_err_t tcpip_adapter_dhcps_get_status(tcpip_adapter_if_t tcpip_if, tcpip_adapter_dhcp_status_t *status); + +esp_err_t tcpip_adapter_dhcps_start(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_dhcps_stop(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_dhcpc_get_status(tcpip_adapter_if_t tcpip_if, tcpip_adapter_dhcp_status_t *status); + +esp_err_t tcpip_adapter_dhcpc_start(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_dhcpc_stop(tcpip_adapter_if_t tcpip_if); + +esp_err_t tcpip_adapter_sta_input(void *buffer, uint16_t len, void* eb); +esp_err_t tcpip_adapter_ap_input(void *buffer, uint16_t len, void* eb); + +#if 0 +//esp_err_t tcpip_dep_input(wifi_interface_t wifi_if, void *buffer, uint16 len); + +esp_err_t tcpip_adapter_output(tcpip_adapter_if_t tcpip_if, void *buffer, uint16_t len); +#endif + +wifi_interface_t tcpip_adapter_get_wifi_if(void *dev); + +#endif /* _TCPIP_ADAPTER_H_ */ + diff --git a/components/tcpip_adapter/tcpip_adapter_lwip.c b/components/tcpip_adapter/tcpip_adapter_lwip.c new file mode 100644 index 000000000..2bc708857 --- /dev/null +++ b/components/tcpip_adapter/tcpip_adapter_lwip.c @@ -0,0 +1,450 @@ +// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD +// +// 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. +#include +#include + +#include "tcpip_adapter.h" + +#if CONFIG_TCPIP_LWIP + +#include "lwip/inet.h" +#include "lwip/tcpip.h" +#include "lwip/dhcp.h" +#include "lwip/ip_addr.h" + +#include "netif/wlanif.h" + +#include "apps/dhcpserver.h" + +static struct netif *esp_netif[TCPIP_ADAPTER_IF_MAX]; +static struct ip_info esp_ip[TCPIP_ADAPTER_IF_MAX]; + +static tcpip_adapter_dhcp_status_t dhcps_status = TCPIP_ADAPTER_DHCP_INIT; +static tcpip_adapter_dhcp_status_t dhcpc_status = TCPIP_ADAPTER_DHCP_INIT; + + +static esp_err_t tcpip_adapter_addr_change_cb(struct netif *netif); + +#define TCPIP_ADAPTER_DEBUG ets_printf + +void tcpip_adapter_init(void) +{ + static bool tcpip_inited = false; + + if (tcpip_inited == false) { + tcpip_inited = true; + + tcpip_init(NULL, NULL); + + IP4_ADDR(&esp_ip[TCPIP_ADAPTER_IF_AP].ip, 192, 168 , 4, 1); + IP4_ADDR(&esp_ip[TCPIP_ADAPTER_IF_AP].gw, 192, 168 , 4, 1); + IP4_ADDR(&esp_ip[TCPIP_ADAPTER_IF_AP].netmask, 255, 255 , 255, 0); + } + + netif_reg_addr_change_cb(tcpip_adapter_addr_change_cb); +} + +esp_err_t tcpip_adapter_start(tcpip_adapter_if_t tcpip_if, uint8_t *mac, struct ip_info *info) +{ + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX || mac == NULL || info == NULL) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (esp_netif[tcpip_if] == NULL) { + esp_netif[tcpip_if] = malloc(sizeof(struct netif)); + if (esp_netif[tcpip_if] == NULL) { + return ESP_ERR_NO_MEM; + } + memcpy(esp_netif[tcpip_if]->hwaddr, mac, NETIF_MAX_HWADDR_LEN); + netif_add(esp_netif[tcpip_if], &info->ip, &info->netmask, &info->gw, NULL, wlanif_init, tcpip_input); + } + + if (tcpip_if == TCPIP_ADAPTER_IF_AP) { + netif_set_up(esp_netif[tcpip_if]); + + if (dhcps_status == TCPIP_ADAPTER_DHCP_INIT) { + dhcps_start(esp_netif[tcpip_if]); + printf("dhcp server start:(ip: %s, mask: %s, gw: %s)\n", inet_ntoa(info->ip), inet_ntoa(info->netmask), inet_ntoa(info->gw)); + dhcps_status = TCPIP_ADAPTER_DHCP_STARTED; + } + } + + /* if ap is on, choose ap as default if */ + if (esp_netif[TCPIP_ADAPTER_IF_AP]) { + netif_set_default(esp_netif[TCPIP_ADAPTER_IF_AP]); + } else if (esp_netif[TCPIP_ADAPTER_IF_STA]) { + netif_set_default(esp_netif[TCPIP_ADAPTER_IF_STA]); + } + + return ESP_OK; +} + +esp_err_t tcpip_adapter_stop(tcpip_adapter_if_t tcpip_if) +{ + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (esp_netif[tcpip_if] == NULL) { + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + + if (tcpip_if == TCPIP_ADAPTER_IF_AP) { + dhcps_stop(esp_netif[tcpip_if]); // TODO: dhcps checks status by its self + dhcps_status = TCPIP_ADAPTER_DHCP_INIT; + } else if (tcpip_if == TCPIP_ADAPTER_IF_STA) { + dhcp_stop(esp_netif[tcpip_if]); + dhcpc_status = TCPIP_ADAPTER_DHCP_INIT; + } + + netif_remove(esp_netif[tcpip_if]); + + free(esp_netif[tcpip_if]); + esp_netif[tcpip_if] = NULL; + + /* in ap + sta mode, if stop ap, choose sta as default if */ + if (esp_netif[TCPIP_ADAPTER_IF_STA] && tcpip_if == TCPIP_ADAPTER_IF_AP) { + netif_set_default(esp_netif[TCPIP_ADAPTER_IF_STA]); + } + + return ESP_OK; +} + +esp_err_t tcpip_adapter_up(tcpip_adapter_if_t tcpip_if) +{ + if (tcpip_if == TCPIP_ADAPTER_IF_STA) { + if (esp_netif[tcpip_if] == NULL){ + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + + netif_set_up(esp_netif[tcpip_if]); + } + + return ESP_OK; +} + +esp_err_t tcpip_adapter_down(tcpip_adapter_if_t tcpip_if) +{ + if (tcpip_if == TCPIP_ADAPTER_IF_STA) { + if (esp_netif[tcpip_if] == NULL){ + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + + if (esp_netif[tcpip_if]->dhcp != NULL) { + dhcp_release(esp_netif[tcpip_if]); + dhcp_stop(esp_netif[tcpip_if]); + dhcp_cleanup(esp_netif[tcpip_if]); + dhcpc_status = TCPIP_ADAPTER_DHCP_STOPED; + } else { + netif_set_down(esp_netif[tcpip_if]); + netif_set_addr(esp_netif[tcpip_if], IP4_ADDR_ANY, IP4_ADDR_ANY, IP4_ADDR_ANY); + } + } + + return ESP_OK; +} + +esp_err_t tcpip_adapter_get_ip_info(tcpip_adapter_if_t tcpip_if, struct ip_info *if_ip) +{ + struct netif *p_netif; + + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX || if_ip == NULL) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL && netif_is_up(p_netif)) { + ip4_addr_set(&if_ip->ip, ip_2_ip4(&p_netif->ip_addr)); + ip4_addr_set(&if_ip->netmask, ip_2_ip4(&p_netif->netmask)); + ip4_addr_set(&if_ip->gw, ip_2_ip4(&p_netif->gw)); + + return ESP_OK; + } + + ip4_addr_copy(if_ip->ip, esp_ip[tcpip_if].ip); + ip4_addr_copy(if_ip->gw, esp_ip[tcpip_if].gw); + ip4_addr_copy(if_ip->netmask, esp_ip[tcpip_if].netmask); + + return ESP_OK; +} + +esp_err_t tcpip_adapter_addr_change_cb(struct netif *netif) +{ + tcpip_adapter_if_t tcpip_if; + + if (!netif) { + TCPIP_ADAPTER_DEBUG("null netif=%p\n", netif); + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + + if (netif == esp_netif[TCPIP_ADAPTER_IF_STA]) { + tcpip_if = TCPIP_ADAPTER_IF_STA; + } else if (netif == esp_netif[TCPIP_ADAPTER_IF_AP]){ + tcpip_if = TCPIP_ADAPTER_IF_AP; + } else { + TCPIP_ADAPTER_DEBUG("invalid netif=%p\n", netif); + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + + //check whether IP is changed + if ( !ip4_addr_cmp(ip_2_ip4(&netif->ip_addr), &esp_ip[tcpip_if].ip) || + !ip4_addr_cmp(ip_2_ip4(&netif->gw), &esp_ip[tcpip_if].gw) || + !ip4_addr_cmp(ip_2_ip4(&netif->netmask), &esp_ip[tcpip_if].netmask) ) { + + ip4_addr_set(&esp_ip[tcpip_if].ip, ip_2_ip4(&netif->ip_addr)); + ip4_addr_set(&esp_ip[tcpip_if].netmask, ip_2_ip4(&netif->netmask)); + ip4_addr_set(&esp_ip[tcpip_if].gw, ip_2_ip4(&netif->gw)); + + //notify event + printf("ip: %s, ", inet_ntoa(esp_ip[tcpip_if].ip)); + printf("mask: %s, ", inet_ntoa(esp_ip[tcpip_if].netmask)); + printf("gw: %s\n", inet_ntoa(esp_ip[tcpip_if].gw)); + + if (ip_2_ip4(&netif->ip_addr) != IP4_ADDR_ANY) { + } + } else { + TCPIP_ADAPTER_DEBUG("ip unchanged\n"); + } + + return ESP_OK; +} + +esp_err_t tcpip_adapter_set_ip_info(tcpip_adapter_if_t tcpip_if, struct ip_info *if_ip) +{ + struct netif *p_netif; + + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX || if_ip == NULL) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + ip4_addr_copy(esp_ip[tcpip_if].ip, if_ip->ip); + ip4_addr_copy(esp_ip[tcpip_if].gw, if_ip->gw); + ip4_addr_copy(esp_ip[tcpip_if].netmask, if_ip->netmask); + + p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL && netif_is_up(p_netif)) { + netif_set_addr(p_netif, &if_ip->ip, &if_ip->netmask, &if_ip->gw); + } + + return ESP_OK; +} + +#if 0 +esp_err_t tcpip_adapter_get_mac(tcpip_adapter_if_t tcpip_if, uint8_t mac[6]) +{ + struct netif *p_netif; + + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX || mac == NULL) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL) { + memcpy(mac, p_netif->hwaddr, NETIF_MAX_HWADDR_LEN); + + return ESP_OK; + } + + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; +} + +esp_err_t tcpip_adapter_set_mac(tcpip_adapter_if_t tcpip_if, uint8_t mac[6]) +{ + struct netif *p_netif; + + if (tcpip_if >= TCPIP_ADAPTER_IF_MAX || mac == NULL) { + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL) { + memcpy(p_netif->hwaddr, mac, NETIF_MAX_HWADDR_LEN); + + return ESP_OK; + } + + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; +} +#endif + +esp_err_t tcpip_adapter_dhcps_get_status(tcpip_adapter_if_t tcpip_if, tcpip_adapter_dhcp_status_t *status) +{ + *status = dhcps_status; + + return ESP_OK; +} + +esp_err_t tcpip_adapter_dhcps_start(tcpip_adapter_if_t tcpip_if) +{ + /* only support ap now */ + if (tcpip_if != TCPIP_ADAPTER_IF_AP || tcpip_if >= TCPIP_ADAPTER_IF_MAX) { + TCPIP_ADAPTER_DEBUG("dhcp server invalid if=%d\n", tcpip_if); + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (dhcps_status != TCPIP_ADAPTER_DHCP_STARTED) { + struct netif *p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL && netif_is_up(p_netif)) { + dhcps_start(p_netif); + dhcps_status = TCPIP_ADAPTER_DHCP_STARTED; + TCPIP_ADAPTER_DEBUG("dhcp server start successfully\n"); + return ESP_OK; + } else { + TCPIP_ADAPTER_DEBUG("dhcp server re init\n"); + dhcps_status = TCPIP_ADAPTER_DHCP_INIT; + return ESP_OK; + } + } + + TCPIP_ADAPTER_DEBUG("dhcp server already start\n"); + return ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STARTED; +} + +esp_err_t tcpip_adapter_dhcps_stop(tcpip_adapter_if_t tcpip_if) +{ + /* only support ap now */ + if (tcpip_if != TCPIP_ADAPTER_IF_AP || tcpip_if >= TCPIP_ADAPTER_IF_MAX) { + TCPIP_ADAPTER_DEBUG("dhcp server invalid if=%d\n", tcpip_if); + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (dhcps_status == TCPIP_ADAPTER_DHCP_STARTED) { + struct netif *p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL) { + dhcps_stop(p_netif); + } else { + TCPIP_ADAPTER_DEBUG("dhcp server if not ready\n"); + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + } else if (dhcps_status == TCPIP_ADAPTER_DHCP_STOPED) { + TCPIP_ADAPTER_DEBUG("dhcp server already stoped\n"); + return ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STOPED; + } + + TCPIP_ADAPTER_DEBUG("dhcp server stop successfully\n"); + dhcps_status = TCPIP_ADAPTER_DHCP_STOPED; + return ESP_OK; +} + +esp_err_t tcpip_adapter_dhcpc_get_status(tcpip_adapter_if_t tcpip_if, tcpip_adapter_dhcp_status_t *status) +{ + *status = dhcpc_status; + + return ESP_OK; +} + +esp_err_t tcpip_adapter_dhcpc_start(tcpip_adapter_if_t tcpip_if) +{ + /* only support sta now, need to support ethernet */ + if (tcpip_if != TCPIP_ADAPTER_IF_STA || tcpip_if >= TCPIP_ADAPTER_IF_MAX) { + TCPIP_ADAPTER_DEBUG("dhcp client invalid if=%d\n", tcpip_if); + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (dhcpc_status != TCPIP_ADAPTER_DHCP_STARTED) { + struct netif *p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL) { + if (netif_is_up(p_netif)) { + TCPIP_ADAPTER_DEBUG("dhcp client init ip/mask/gw to all-0\n"); + ip_addr_set_zero(&p_netif->ip_addr);; + ip_addr_set_zero(&p_netif->netmask); + ip_addr_set_zero(&p_netif->gw); + } + + if (dhcp_start(p_netif) != ERR_OK) { + TCPIP_ADAPTER_DEBUG("dhcp client start failed\n"); + return ESP_ERR_TCPIP_ADAPTER_DHCPC_START_FAILED; + } + + TCPIP_ADAPTER_DEBUG("dhcp client start successfully\n"); + dhcpc_status = TCPIP_ADAPTER_DHCP_STARTED; + return ESP_OK; + } else { + TCPIP_ADAPTER_DEBUG("dhcp client re init\n"); + dhcpc_status = TCPIP_ADAPTER_DHCP_INIT; + return ESP_OK; + } + } + + TCPIP_ADAPTER_DEBUG("dhcp client already started\n"); + return ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STARTED; +} + +esp_err_t tcpip_dep_dhcpc_stop(tcpip_adapter_if_t tcpip_if) +{ + /* only support sta now, need to support ethernet */ + if (tcpip_if != TCPIP_ADAPTER_IF_STA || tcpip_if >= TCPIP_ADAPTER_IF_MAX) { + TCPIP_ADAPTER_DEBUG("dhcp client invalid if=%d\n", tcpip_if); + return ESP_ERR_TCPIP_ADAPTER_INVALID_PARAMS; + } + + if (dhcpc_status == TCPIP_ADAPTER_DHCP_STARTED) { + struct netif *p_netif = esp_netif[tcpip_if]; + + if (p_netif != NULL) { + dhcp_stop(p_netif); + } else { + TCPIP_ADAPTER_DEBUG("dhcp client if not ready\n"); + return ESP_ERR_TCPIP_ADAPTER_IF_NOT_READY; + } + } else if (dhcps_status == TCPIP_ADAPTER_DHCP_STOPED) { + TCPIP_ADAPTER_DEBUG("dhcp client already stoped\n"); + return ESP_ERR_TCPIP_ADAPTER_DHCP_ALREADY_STOPED; + } + + TCPIP_ADAPTER_DEBUG("dhcp client stop successfully\n"); + dhcpc_status = TCPIP_ADAPTER_DHCP_STOPED; + return ESP_OK; +} + +esp_err_t tcpip_adapter_sta_input(void *buffer, uint16_t len, void* eb) +{ + wlanif_input(esp_netif[TCPIP_ADAPTER_IF_STA], buffer, len, eb); + return ESP_OK; +} + +esp_err_t tcpip_adapter_ap_input(void *buffer, uint16_t len, void* eb) +{ + wlanif_input(esp_netif[TCPIP_ADAPTER_IF_AP], buffer, len, eb); + return ESP_OK; +} + +#if 0 +bool tcpip_dep_output(wifi_interface_t wifi_if, void *buffer, uint16_t len) +{ + + return true; +} +#endif + +wifi_interface_t tcpip_adapter_get_wifi_if(void *dev) +{ + struct netif *p_netif = (struct netif *)dev; + + if (p_netif == esp_netif[TCPIP_ADAPTER_IF_STA]) { + return WIFI_IF_STA; + } else if (p_netif == esp_netif[TCPIP_ADAPTER_IF_AP]) { + return WIFI_IF_AP; + } + + return WIFI_IF_MAX; +} +#endif diff --git a/docs/COPYRIGHT.rst b/docs/COPYRIGHT.rst new file mode 100644 index 000000000..da5f5b204 --- /dev/null +++ b/docs/COPYRIGHT.rst @@ -0,0 +1,103 @@ +Software Copyrights +=================== + +All original source code in this repository is Copyright (C) 2015-2016 +Espressif Systems. This source code is licensed under the Apache +License 2.0 as described in the file LICENSE. + +Additional third party copyrighted code is included under the following licenses: + +* Newlib_ (components/newlib) is licensed under the BSD License and is Copyright of various parties, as described in the file components/newlib/COPYING.NEWLIB. + +* Xtensa header files (components/esp32/include/xtensa) are Copyright (C) 2013 Tensilica Inc and are licensed under the MIT License as reproduce in the individual header files. + +* `esptool.py`_ (bin/esptool.py) is Copyright (C) 2014-2016 Fredrik Ahlberg, Angus Gratton and is licensed under the GNU General Public License v2, as described in the file components/esptool_py/LICENSE. + +* Original parts of FreeRTOS_ (components/freertos) are Copyright (C) 2015 Real Time Engineers Ltd and is licensed under the GNU General Public License V2 with the FreeRTOS Linking Exception, as described in the file components/freertos/license.txt. + +* Original parts of LWIP_ (components/lwip) are Copyright (C) 2001, 2002 Swedish Institute of Computer Science and are licensed under the BSD License as described in the file components/lwip/COPYING. + +* KConfig (tools/kconfig) is Copyright (C) 2002 Roman Zippel and others, and is licensed under the GNU General Public License V2. + +* `wpa_supplicant`_ Copyright (c) 2003-2005 Jouni Malinen and licensed under the BSD license. + +* `FreeBSD net80211`_ Copyright (c) 2004-2008 Sam Leffler, Errno Consulting and licensed under the BSD license. + +Where source code headers specify Copyright & License information, this information takes precedence over the summaries made here. + +ROM Source Code Copyrights +========================== + +ESP32 mask ROM hardware includes binaries compiled from portions of the following third party software: + +* Newlib_, as licensed under the BSD License and Copyright of various parties, as described in the file components/newlib/COPYING.NEWLIB. + +* Xtensa libhal, Copyright (c) Tensilica Inc and licensed under the MIT license (see below). + +* TinyBasic_ Plus, Copyright Mike Field & Scott Lawrence and licensed under the MIT license (see below). + +* miniz_, by Rich Geldreich - placed into the public domain. + +* `wpa_supplicant`_ Copyright (c) 2003-2005 Jouni Malinen and licensed under the BSD license. + +* TJpgDec_ Copyright (C) 2011, ChaN, all right reserved. See below for license. + +Xtensa libhal MIT License +========================= + +Copyright (c) 2003, 2006, 2010 Tensilica Inc. + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be included +in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +TinyBasic Plus MIT License +========================== + +Copyright (c) 2012-2013 + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +TJpgDec License +=============== +TJpgDec - Tiny JPEG Decompressor R0.01 (C)ChaN, 2011 +The TJpgDec is a generic JPEG decompressor module for tiny embedded systems. +This is a free software that opened for education, research and commercial +developments under license policy of following terms. + +Copyright (C) 2011, ChaN, all right reserved. + +* The TJpgDec module is a free software and there is NO WARRANTY. +* No restriction on use. You can use, modify and redistribute it for +personal, non-profit or commercial products UNDER YOUR RESPONSIBILITY. +* Redistributions of source code must retain the above copyright notice. + + +.. _Newlib: https://sourceware.org/newlib/ +.. _FreeRTOS: http://freertos.org/ +.. _esptool.py: https://github.com/themadinventor/esptool +.. _LWIP: http://savannah.nongnu.org/projects/lwip/ +.. _TinyBasic: https://github.com/BleuLlama/TinyBasicPlus +.. _miniz: https://code.google.com/archive/p/miniz/ +.. _wpa_supplicant: http://w1.fi/wpa_supplicant/ +.. _FreeBSD net80211: https://github.com/freebsd/freebsd/tree/master/sys/net80211 +.. _TJpgDec: http://elm-chan.org/fsw/tjpgd/00index.html diff --git a/docs/eclipse-setup.rst b/docs/eclipse-setup.rst new file mode 100644 index 000000000..cbb9425ee --- /dev/null +++ b/docs/eclipse-setup.rst @@ -0,0 +1,75 @@ +Installing Eclipse IDE +====================== + +The Eclipse IDE gives you a graphical integrated development environment for writing, compiling and debugging ESP-IDF projects. + +* Start by installing the SDK for your platform (see Windows, OS X, Linux). + +* Download the Eclipse Installer for your platform from eclipse.org_. + +* When running the Eclipse Installer, choose "Eclipse for C/C++ Development" (in other places you'll see this referred to as CDT.) + +Setting up Eclipse +================== + +Once your new Eclipse installation launches, follow these steps: + +Import New Project +------------------ + +* Eclipse makes use of the Makefile support in ESP-IDF. This means you need to start by creating an ESP-IDF project. You can use the skeleton project from github. + +* Once Eclipse is running, choose File -> Import... + +* In the dialog that pops up, choose "C/C++" -> "EXisting Code as Makefile Project" and click Next. + +* On the next page, enter "Existing Code Location" to be the directory of your SDK project. Don't specify the path to the SDK itself. + +* On the same page, under "Toolchain for Indexer Settings" choose "Cross GCC". Then click Finish. + + +Project Properties +------------------ + +* The new project will appear under Project Explorer. Right-click the project and choose Properties from the context menu. + +* Click on the "Environment" properties page under "C/C++ Build". Click "Add..." and enter name ``V`` and value ``1``. + +* Click "Add..." again, and enter name ``SDK_PATH``. The value should be the full path where the ESP32 SDK is installed. *Windows users: Use forward-slashes not backslashes for this path, ie C:/Users/MyUser/Development/SDK*. + +*Windows users only, follow these two additional steps:* + +* On the same Environment property page, edit the PATH environment variable and append ";C:\msys32\usr\bin;C:\msys32\mingw32\bin;C:\msys32\opt\xtensa-esp32-elf\bin" to the end of the default value. (If you installed msys32 to a different directory then you'll need to change these paths to match.) + +* Click on the "C/C++ Build" top-level properties page then uncheck "Use default build command" and enter this for the custom build command: ``bash ${SDK_PATH}/bin/eclipse_windows_make.sh``. + +*All users, continue with these steps:* + +Navigate to "C/C++ General" -> "Preprocessor Include Paths" property page: + +* Click the "Providers" tab + +* In the list of providers, click "CDT Cross GCC Built-in Compiler Settings". Under "Command to get compiler specs", replace the text ``${COMMAND}`` at the beginning of the line with ``xtensa-esp32-elf-gcc``. This means the full "Command to get compiler specs" should be ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"``. + +* In the list of providers, click "CDT GCC Build Output Parser" and type ``xtensa-esp32-elf-`` at the beginning of the Compiler command pattern. This means the full Compiler command pattern should be ``xtensa-esp32-elf-(g?cc)|([gc]\+\+)|(clang)`` + +* Click OK to close the Properties dialog, and choose Project -> Build to build your project. + +Flash from Eclipse +------------------ + +You can integrate the "make flash" target into your Eclipse project to flash using esptool.py from the Eclipse UI: + +* Right-click the "esp-idf-tests" project in Project Explorer (important to make sure you don't select a subdirectory of the project or Eclipse may find the wrong Makefile.) + +* Select Make Targets -> Create from the context menu. + +* Type "flash" as the target name. Leave the other options as their defaults. + +* Now you can use Project -> Make Target -> Build (Shift+F9) to build the custom flash target, which will compile and flash the project. + +Note that you will need to use "make menuconfig" to set the serial port and other config options for flashing. "make menuconfig" still requires a command line terminal (see the instructions for your platform.) + +Follow the same steps to add ``bootloader`` and ``partition_table`` targets, if necessary. + +.. _eclipse.org: http://www.eclipse.org/ diff --git a/docs/windows-setup.rst b/docs/windows-setup.rst new file mode 100644 index 000000000..aa0fb0d54 --- /dev/null +++ b/docs/windows-setup.rst @@ -0,0 +1,87 @@ +Step 1: Toolchain for Windows: Quick Steps +================================== + +Windows doesn't have a built-in "make" environment, so as well as installing the toolchain you will need a GNU-compatible environment. We use the MSYS2_ environment to provide. + You don't need to use this environment all the time (you can use Eclipse_ or some other front-end), but it runs behind the scenes. + +The quick setup is to download the Windows all-in-one toolchain & MSYS zip file from dl.espressif.com: + +http://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20160816.zip + +Unzip the zip file to C:\ and it will create an "msys32" directory with a pre-prepared environment. + + +Alternative Step 1: Configure toolchain & environment from scratch +================================================================== + +As an alternative to getting a pre-prepared environment, you can set up the environment from scratch: + +* Navigate to the MSYS2_ installer page and download the ``msys2-i686-xxxxxxx.exe`` installer executable (we only support a 32-bit MSYS environment, it works on both 32-bit and 64-bit Windows.) + +* Run through the installer steps, and accept the "Run MSYS2 now" option at the end. A window will open with a MSYS2 terminal. + +* The SDK repository on github contains a script in the tools directory titled ``windows_install_prerequisites.sh``. If you haven't downloaded the SDK yet, that's OK - you can just `download that one file in Raw format from here `_. Save it somewhere on your computer. + +* Type the path to the shell script into the MSYS2 terminal window. You can type it as a normal Windows path, but use forward-slashes instead of back-slashes. ie: ``C:/Users/myuser/Downloads/windows_install_prerequisites.sh``. You can read the script beforehand to check what it does. + +* If you use the 201602 MSYS2 installer, the first time you run ``windows_install_prerequisites.sh`` it will update the MSYS2 core system. At the end of this update, you will be prompted to close the MSYS2 terminal and re-open. When you re-open after the update, re-run ``windows_install_prerequisites.sh``. The next version of MSYS2 (after 201602) will not need this interim step. + +* The ``windows_install_prerequisites.sh`` script will download and install packages for ESP32 SDK support, and the ESP32 toolchain. + +Note: You may encounter a bug where svchost.exe uses 100% CPU in Windows after setup is finished, resulting in the SDK building very slowly. Terminating svchost.exe or restarting Windows will solve this problem. + +Another Alternative Step 1: Just download a toolchain +===================================================== + +If you already have an MSYS2 install or want to do things differently, you can download just the toolchain here: + +http://dl.espressif.com/dl/xtensa-esp32-elf-win32-1.22.0-59.zip + +If you followed one of the above options for Step 1, you won't need this download. + +Important: Just having this toolchain is *not enough* to use ESP-IDF on Windows. You will need GNU make, bash, and sed at minimum. The above environments provide all this, plus a host compiler (required for menuconfig support). + +Step 2: Getting the SDK from github +=================================== + +Option 1: Direct Download +------------------------- + +This is the quick option to get up and running with the SDK, but you'll have to re-download in order to update the SDK. + +Navigate to the github repository and click Download. Unzip the SDK somewhere that you need to use it. + +Option 2: Using git +------------------- + +It takes longer to check out the SDK directly from git, but you'll have the option of using ``git pull`` to update the SDK sources. + +Open an MSYS2 terminal window by running ``C:\msys32\msys2_shell.cmd``. The environment in this window is a bash shell. + +Change to the directory you want to clone the SDK into by typing a command like this one: ``cd "C:/path/to/dir"`` (note the forward-slashes in the path). Then type ``git clone https://github.com/espressif/esp-idf.git`` + +If you'd rather use a Windows UI tool to manage your git repositories, this is also possible. A wide range are available. + +Step 3: Starting a project +========================== + +The SDK by itself does not build a binary to run on the ESP32. The binary "app" comes from a project in a different directory. Multiple projects can share the same ESP32 SDK. + +The easiest way to start a project is to download the Getting Started project from github_. + +The process is the same as for checking out the SDK from github. Change to the parent directory and run ``git clone https://github.com/espressif/esp-idf-template.git``. + +Step 4: Configuring the project +=============================== + +Open an MSYS2 terminal window by running ``C:\msys32\msys2_shell.cmd``. The environment in this window is a bash shell. + +Type a command like this to set the path to ESP-IDF directory: ``export SDK_PATH="C:/path/to/esp-idf"`` (note the forward-slashes not back-slashes for the path). If you don't want to run this command every time you open an MSYS2 window, create a new file in ``C:/msys32/etc/profile.d/`` and paste this line in - then it will be run each time you open an MYS2 terminal. + +Use ``cd`` to change to the project directory (not the SDK directory.) Type ``make menuconfig`` to configure your project, then ``make`` to build it, ``make clean`` to remove built files, and ``make flash`` to flash (use the menuconfig to set the serial port for flashing.) + +If you'd like to use the Eclipse IDE instead of running ``make``, check out the Eclipse setup guide in this directory. + + +.. _MSYS2: https://msys2.github.io/ +.. _github: https://github.com/espressif/esp-idf-template diff --git a/make/common.mk b/make/common.mk new file mode 100644 index 000000000..24d8294b8 --- /dev/null +++ b/make/common.mk @@ -0,0 +1,56 @@ +# Functionality common to both top-level project makefile +# and component makefiles +# + +# Include project config file, if it exists. +# +# (Note that we only rebuild auto.conf automatically for some targets, +# see project_config.mk for details.) +-include $(PROJECT_PATH)/build/include/config/auto.conf + +ifeq ("$(LDFLAGS)","") +LDFLAGS = -nostdlib \ + -L$(SDK_PATH)/lib \ + -L$(SDK_PATH)/ld \ + $(addprefix -L$(BUILD_DIR_BASE)/,$(COMPONENTS) $(SRCDIRS)) \ + -u call_user_start_cpu0 \ + -Wl,--gc-sections \ + -Wl,-static \ + -Wl,--start-group \ + $(COMPONENT_LDFLAGS) \ + -lgcc \ + -Wl,--end-group +endif + +ifeq ("$(CFLAGS)","") +CFLAGS = -DESP_PLATFORM -Og -std=gnu99 -g3 \ + -Wpointer-arith -Werror -Wno-error=unused-function -Wno-error=unused-but-set-variable -Wno-error=unused-variable \ + -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -Wall -ffunction-sections -fdata-sections $(EXTRA_CFLAGS) +endif + +ifeq ("$(CXXFLAGS)","") +CXXFLAGS = -DESP_PLATFORM -Og -std=gnu++11 -g3 \ + -Wpointer-arith -Werror -Wno-error=unused-function -Wno-error=unused-but-set-variable -Wno-error=unused-variable \ + -Wl,-EL -nostdlib -mlongcalls -Wall -ffunction-sections -fdata-sections $(EXTRA_CFLAGS) -fno-exceptions +endif + +#Handling of V=1/VERBOSE=1 flag +V ?= $(VERBOSE) +ifeq ("$(V)","1") +Q := +vecho := @true +else +Q := @ +vecho := @echo +endif + +# General make utilities + +# convenience variable for printing an 80 asterisk wide separator line +SEPARATOR:="*******************************************************************************" + +# macro to remove quotes from an argument, ie $(call dequote (CONFIG_BLAH)) +define dequote +$(subst ",,$(1)) +endef +# " comment kept here to keep syntax highlighting happy diff --git a/make/component.mk b/make/component.mk new file mode 100644 index 000000000..3ee16166d --- /dev/null +++ b/make/component.mk @@ -0,0 +1,111 @@ +# Main SDK Makefile +# This Makefile gets included in the Makefile of all the components to set the correct include paths etc. +# PWD is the build directory of the component and the top Makefile is the one in the +# component source dir. +# +# The way the Makefile differentiates between those two is by looking at the environment +# variable PROJECT_PATH. If this is set (to the basepath of the project), we're building a +# component and its Makefile has included this makefile. If not, we're building the entire project. +# + +# +# This Makefile requires the environment variable SDK_PATH to be set +# to the directory where the SDK (containing the make directory with +# this file) is located +# + +ifeq ("$(PROJECT_PATH)","") +$(error Make was invoked from $(CURDIR). However please do not run make from the sdk or a component directory; invoke make from the project directory. See SDK README for details.) +endif + +# Find the path to the component +COMPONENT_PATH := $(abspath $(dir $(firstword $(MAKEFILE_LIST)))) +export COMPONENT_PATH + +include $(SDK_PATH)/make/common.mk + +#Some of these options are overridable by the components Makefile. + +#Name of the component +COMPONENT_NAME ?= $(lastword $(subst /, ,$(realpath $(COMPONENT_PATH)))) + +#Absolute path of the .a file +COMPONENT_LIBRARY := lib$(COMPONENT_NAME).a + +#Source dirs a component has. Default to root directory of component. +COMPONENT_SRCDIRS ?= . + +#Object files which need to be linked into the library +#By default we take all .c/.S files in the component directory. +ifeq ("$(COMPONENT_OBJS)", "") +#Find all source files in all COMPONENT_SRCDIRS +COMPONENT_OBJS := $(foreach compsrcdir,$(COMPONENT_SRCDIRS),$(patsubst %.c,%.o,$(wildcard $(COMPONENT_PATH)/$(compsrcdir)/*.c))) +COMPONENT_OBJS += $(foreach compsrcdir,$(COMPONENT_SRCDIRS),$(patsubst %.cpp,%.o,$(wildcard $(COMPONENT_PATH)/$(compsrcdir)/*.cpp))) +COMPONENT_OBJS += $(foreach compsrcdir,$(COMPONENT_SRCDIRS),$(patsubst %.S,%.o,$(wildcard $(COMPONENT_PATH)/$(compsrcdir)/*.S))) +#Make relative by removing COMPONENT_PATH from all found object paths +COMPONENT_OBJS := $(patsubst $(COMPONENT_PATH)/%,%,$(COMPONENT_OBJS)) +endif + +#By default, include only the include/ dir. +COMPONENT_ADD_INCLUDEDIRS ?= include +COMPONENT_ADD_LDFLAGS ?= -l$(COMPONENT_NAME) + +#If we're called to compile something, we'll get passed the COMPONENT_INCLUDES +#variable with all the include dirs from all the components in random order. This +#means we can accidentally grab a header from another component before grabbing our own. +#To make sure that does not happen, re-order the includes so ours come first. +OWN_INCLUDES:=$(abspath $(addprefix $(COMPONENT_PATH)/,$(COMPONENT_ADD_INCLUDEDIRS) $(COMPONENT_PRIV_INCLUDEDIRS))) +COMPONENT_INCLUDES := $(OWN_INCLUDES) $(filter-out $(OWN_INCLUDES),$(COMPONENT_INCLUDES)) + +#This target is used to collect variable values from inside the main makefile +get_variable: + @echo "$(GET_VARIABLE)=$(call $(GET_VARIABLE)) " + +#Targets for build/clean. Use builtin recipe if component Makefile +#hasn't defined its own. +ifeq ("$(COMPONENT_OWNBUILDTARGET)", "") +build: $(COMPONENT_LIBRARY) + @mkdir -p $(COMPONENT_SRCDIRS) + +#Build the archive. We remove the archive first, otherwise ar will get confused if we update +#an archive when multiple filenames have the same name (src1/test.o and src2/test.o) +$(COMPONENT_LIBRARY): $(COMPONENT_OBJS) + $(vecho) AR $@ + $(Q) rm -f $@ + $(Q) $(AR) cru $@ $(COMPONENT_OBJS) +endif + +ifeq ("$(COMPONENT_OWNCLEANTARGET)", "") +clean: + $(vecho) RM $(COMPONENT_LIBRARY) $(COMPONENT_OBJS) $(COMPONENT_OBJS:.o=.d) $(COMPONENT_EXTRA_CLEAN) + $(Q) rm -f $(COMPONENT_LIBRARY) $(COMPONENT_OBJS) $(COMPONENT_OBJS:.o=.d) $(COMPONENT_EXTRA_CLEAN) +endif + +#Also generate dependency files +CFLAGS+=-MMD +CXXFLAGS+=-MMD +#Include all dependency files already generated +-include $(COMPONENT_OBJS:.o=.d) + +#This pattern is generated for each COMPONENT_SRCDIR to compile the files in it. +define GenerateCompileTargets +# $(1) - directory containing source files, relative to $(COMPONENT_PATH) +$(1)/%.o: $$(COMPONENT_PATH)/$(1)/%.c | $(1) + $$(vecho) CC $$@ + $$(Q) $$(CC) $$(CFLAGS) $$(addprefix -I ,$$(COMPONENT_INCLUDES)) $$(addprefix -I ,$$(COMPONENT_EXTRA_INCLUDES)) -I$(1) -c $$< -o $$@ + +$(1)/%.o: $$(COMPONENT_PATH)/$(1)/%.cpp | $(1) + $$(vecho) CC $$@ + $$(Q) $$(CXX) $$(CXXFLAGS) $$(addprefix -I,$$(COMPONENT_INCLUDES)) $$(addprefix -I,$$(COMPONENT_EXTRA_INCLUDES)) -I$(1) -c $$< -o $$@ + +$(1)/%.o: $$(COMPONENT_PATH)/$(1)/%.S | $(1) + $$(vecho) CC $$@ + $$(Q) $$(CC) $$(CFLAGS) $$(addprefix -I ,$$(COMPONENT_INCLUDES)) $$(addprefix -I ,$$(COMPONENT_EXTRA_INCLUDES)) -I$(1) -c $$< -o $$@ + +# CWD is build dir, create the build subdirectory if it doesn't exist +$(1): + @mkdir -p $(1) +endef + +#Generate all the compile target recipes +$(foreach srcdir,$(COMPONENT_SRCDIRS), $(eval $(call GenerateCompileTargets,$(srcdir)))) diff --git a/make/project.mk b/make/project.mk new file mode 100644 index 000000000..873c311ec --- /dev/null +++ b/make/project.mk @@ -0,0 +1,185 @@ +# +# Main Project Makefile +# This Makefile is included directly from the user project Makefile in order to call the Makefiles of all the +# components (in a separate make process) to build all the libraries, then links them together +# into the final file. If so, PWD is the project dir (we assume). +# + +# +# This Makefile requires the environment variable SDK_PATH to be set to the directory where this +# Makefile is located. +# + +.PHONY: build-components menuconfig all build clean +all: project + +# disable built-in make rules, makes debugging saner +MAKEFLAGS +=-rR + +# Figure out PROJECT_PATH if not set, check for unacceptable Makefile entry points +ifeq ("$(PROJECT_PATH)","") +#The path to the project: we assume the Makefile including this file resides +#in the root of that directory. +PROJECT_PATH := $(abspath $(dir $(firstword $(MAKEFILE_LIST)))) +export PROJECT_PATH + +#The directory where we put all objects/libraries/binaries. The project Makefile can +#configure this if needed. +BUILD_DIR_BASE ?= $(PROJECT_PATH)/build + +#Component directories. These directories are searched for components. +#The project Makefile can override these component dirs, or define extra component directories. +COMPONENT_DIRS ?= $(PROJECT_PATH)/components $(EXTRA_COMPONENT_DIRS) $(SDK_PATH)/components +export COMPONENT_DIRS + +#The project Makefile can define a list of components, but if it does not do this we just take +#all available components in the component dirs. +ifeq ("$(COMPONENTS)","") +#Find all component names. The component names are the same as the +#directories they're in, so /bla/components/mycomponent/ -> mycomponent. We later use +#the COMPONENT_DIRS bit to find back the component path. +COMPONENTS := $(foreach dir,$(COMPONENT_DIRS),$(wildcard $(dir)/*)) +COMPONENTS := $(sort $(foreach comp,$(COMPONENTS),$(lastword $(subst /, ,$(comp))))) +endif +export COMPONENTS + +#Sources default to only "main" +SRCDIRS ?= main + +#Here, we resolve and add all the components and source paths into absolute paths. +#If a component exists in multiple COMPONENT_DIRS, we take the first match. +#WARNING: These directories paths must be generated WITHOUT a trailing / so we +#can use $(notdir x) to get the component name. +COMPONENT_PATHS := $(foreach comp,$(COMPONENTS),$(firstword $(foreach dir,$(COMPONENT_DIRS),$(wildcard $(dir)/$(comp))))) +COMPONENT_PATHS += $(abspath $(SRCDIRS)) + +#A component is buildable if it has a Makefile; we assume that a 'make -C $(component dir) build' results in a +#lib$(componentname).a. +COMPONENT_PATHS_BUILDABLE := $(foreach cp,$(COMPONENT_PATHS),$(if $(wildcard $(cp)/Makefile),$(cp))) + +# Assemble global list of include dirs (COMPONENT_INCLUDES), and +# LDFLAGS args (COMPONENT_LDFLAGS) supplied by each component. +# +# Also add any inter-component dependencies for each component. + +# Extract a variable from a child make process +# +# $(1) - path to directory to invoke make in +# $(2) - name of variable to print via the getvariable target (passed in GET_VARIABLE) +# +# needs 'sed' processing of stdout because make sometimes echoes other stuff on stdout, +# even if asked not to. +# +# Debugging this? Replace $(shell with $(error and you'll see the full command as-run. +define GetVariable +$(shell "$(MAKE)" -s --no-print-directory -C $(1) get_variable COMPONENT_INCLUDES=dummy COMPONENT_LDFLAGS=dummy PROJECT_PATH=$(PROJECT_PATH) GET_VARIABLE=$(2) | sed -En "s/^$(2)=(.+)/\1/p" ) +endef + +ifeq ("$(COMPONENT_INCLUDES)","") +COMPONENT_INCLUDES := $(abspath $(foreach comp,$(COMPONENT_PATHS_BUILDABLE),$(addprefix $(comp)/, \ + $(call GetVariable,$(comp),COMPONENT_ADD_INCLUDEDIRS)))) +endif + +#Also add project include path, for sdk includes +COMPONENT_INCLUDES += $(PROJECT_PATH)/build/include/ +export COMPONENT_INCLUDES + +#COMPONENT_LDFLAGS has a list of all flags that are needed to link the components together. It's collected +#in the same way as COMPONENT_INCLUDES is. +ifeq ("$(COMPONENT_LDFLAGS)","") +COMPONENT_LDFLAGS := $(foreach comp,$(COMPONENT_PATHS_BUILDABLE), \ + $(call GetVariable,$(comp),COMPONENT_ADD_LDFLAGS)) +export COMPONENT_LDFLAGS +endif + +# Generate component dependency targets from dependencies lists +# each component gains a target of its own -build with dependencies +# of the names of any other components (-build) that need building first +# +# the actual targets (that invoke submakes) are generated below by +# GenerateComponentTarget macro. +define GenerateComponentDependencies +# $(1) = component path +.PHONY: $$(notdir $(1)) +$$(notdir $(1))-build: $(addsuffix -build,$(call GetVariable,$(1),COMPONENT_DEPENDS)) +endef +$(foreach comp,$(COMPONENT_PATHS_BUILDABLE), $(eval $(call GenerateComponentDependencies,$(comp)))) + +#Make sure submakes can also use this. +export PROJECT_PATH + +#Include functionality common to both project & component +-include $(SDK_PATH)/make/common.mk + +#Set host compiler and binutils +HOSTCC := $(CC) +HOSTLD := $(LD) +HOSTAR := $(AR) +HOSTOBJCOPY := $(OBJCOPY) + +#Set target compiler. Defaults to whatever the user has +#configured as prefix + yer olde gcc commands +CC := $(call dequote,$(CONFIG_TOOLPREFIX))gcc +CXX := $(call dequote,$(CONFIG_TOOLPREFIX))c++ +LD := $(call dequote,$(CONFIG_TOOLPREFIX))ld +AR := $(call dequote,$(CONFIG_TOOLPREFIX))ar +OBJCOPY := $(call dequote,$(CONFIG_TOOLPREFIX))objcopy +export CC CXX LD AR OBJCOPY + +PYTHON=$(call dequote,$(CONFIG_PYTHON)) + +PROJECT_ELF:=$(BUILD_DIR_BASE)/$(PROJECT_NAME).elf +PROJECT_BIN:=$(PROJECT_ELF:.elf=.bin) + +# Include any Makefile.projbuild file letting components add +# configuration at the project level +define includeProjBuildMakefile +COMPONENT_PATH := $(1) +-include $(1)/Makefile.projbuild +endef +$(foreach componentpath,$(COMPONENT_PATHS),$(eval $(call includeProjBuildMakefile,$(componentpath)))) + +# ELF depends on the -build target of every component +$(PROJECT_ELF): $(addsuffix -build,$(notdir $(COMPONENT_PATHS_BUILDABLE))) + $(vecho) LD $(notdir $@) + $(Q) $(CC) $(LDFLAGS) -o $@ -Wl,-Map=$(patsubst %.elf,%.map,$@) + +# Generation of $(PROJECT_BIN) from $(PROJECT_ELF) is added by the esptool +# component's Makefile.projbuild + +project: $(PROJECT_BIN) + @echo "App built. Default flash app command is:" + @echo $(PROJECT_FLASH_COMMAND) # PROJECT_FLASH_COMMAND is set in esptool_py's Makefile.projbuild + +$(BUILD_DIR_BASE): + mkdir -p $(BUILD_DIR_BASE) + +define GenerateComponentTarget +# $(1) - path to component dir +# $(2) - target to generate (build, clean) +# $(3) - optional dependencies to add +.PHONY: $(notdir $(1))-$(2) +$(notdir $(1))-$(2): $(3) | $(BUILD_DIR_BASE)/$(notdir $(1)) + @+$(MAKE) -C $(BUILD_DIR_BASE)/$(notdir $(1)) -f $(1)/Makefile COMPONENT_BUILD_DIR=$(BUILD_DIR_BASE)/$(notdir $(1)) $(2) +endef + +define GenerateComponentBuildDirTarget +# $(1) - path to component dir +$(BUILD_DIR_BASE)/$(notdir $(1)): + @mkdir -p $(BUILD_DIR_BASE)/$(notdir $(1)) +endef + +$(foreach component,$(COMPONENT_PATHS_BUILDABLE),$(eval $(call GenerateComponentBuildDirTarget,$(component)))) + +$(foreach component,$(COMPONENT_PATHS_BUILDABLE),$(eval $(call GenerateComponentTarget,$(component),build,$(PROJECT_PATH)/build/include/sdkconfig.h))) +$(foreach component,$(COMPONENT_PATHS_BUILDABLE),$(eval $(call GenerateComponentTarget,$(component),clean))) + +include $(SDK_PATH)/make/project_config.mk + +clean: $(addsuffix -clean,$(notdir $(COMPONENT_PATHS_BUILDABLE))) $(EXTRA_CLEAN_TARGETS) + $(vecho) RM $(PROJECT_ELF) + $(Q) rm -f $(PROJECT_ELF) + $(Q) rm -rf $(PROJECT_PATH)/build/include/config $(PROJECT_PATH)/build/include/sdkconfig.h + +endif + diff --git a/make/project_config.mk b/make/project_config.mk new file mode 100644 index 000000000..2f4d1fa2d --- /dev/null +++ b/make/project_config.mk @@ -0,0 +1,63 @@ +# Makefile support for the menuconfig system + +#Find all Kconfig files for all components +COMPONENT_KCONFIGS := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig)) +COMPONENT_KCONFIGS_PROJBUILD := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig.projbuild)) + +#For doing make menuconfig etc +KCONFIG_TOOL_DIR=$(SDK_PATH)/tools/kconfig + +# clear MAKEFLAGS as the menuconfig makefile uses implicit compile rules +$(KCONFIG_TOOL_DIR)/mconf $(KCONFIG_TOOL_DIR)/conf: + MAKEFLAGS="" \ + CFLAGS="" \ + LDFLAGS="" \ + $(MAKE) -C $(KCONFIG_TOOL_DIR) + +menuconfig: $(KCONFIG_TOOL_DIR)/mconf $(SDK_PATH)/Kconfig $(BUILD_DIR_BASE) + $(vecho) MENUCONFIG + $(Q) KCONFIG_AUTOHEADER=$(PROJECT_PATH)/build/include/sdkconfig.h \ + KCONFIG_CONFIG=$(PROJECT_PATH)/sdkconfig \ + COMPONENT_KCONFIGS="$(COMPONENT_KCONFIGS)" \ + COMPONENT_KCONFIGS_PROJBUILD="$(COMPONENT_KCONFIGS_PROJBUILD)" \ + $(KCONFIG_TOOL_DIR)/mconf $(SDK_PATH)/Kconfig + +ifeq ("$(wildcard $(PROJECT_PATH)/sdkconfig)","") +#No sdkconfig found. Need to run menuconfig to make this if we need it. +$(PROJECT_PATH)/sdkconfig: menuconfig +endif + + +# Work out of whether we have to build the Kconfig makefile +# (auto.conf), or if we're in a situation where we don't need it +NON_CONFIG_TARGETS := clean %-clean get_variable +AUTO_CONF_REGEN_TARGET := $(PROJECT_PATH)/build/include/config/auto.conf + +# disable AUTO_CONF_REGEN_TARGET if all targets are non-config targets +# (and not building default target) +ifneq ("$(MAKECMDGOALS)","") +ifeq ($(filter $(NON_CONFIG_TARGETS), $(MAKECMDGOALS)),$(MAKECMDGOALS)) +AUTO_CONF_REGEN_TARGET := +# dummy target +$(PROJECT_PATH)/build/include/config/auto.conf: +endif +endif + +$(AUTO_CONF_REGEN_TARGET) $(PROJECT_PATH)/build/include/sdkconfig.h: $(PROJECT_PATH)/sdkconfig $(KCONFIG_TOOL_DIR)/conf $(COMPONENT_KCONFIGS) $(COMPONENT_KCONFIGS_PROJBUILD) + $(vecho) GENCONFIG + $(Q) mkdir -p $(PROJECT_PATH)/build/include/config + $(Q) cd build; KCONFIG_AUTOHEADER="$(PROJECT_PATH)/build/include/sdkconfig.h" \ + KCONFIG_CONFIG=$(PROJECT_PATH)/sdkconfig \ + COMPONENT_KCONFIGS="$(COMPONENT_KCONFIGS)" \ + COMPONENT_KCONFIGS_PROJBUILD="$(COMPONENT_KCONFIGS_PROJBUILD)" \ + $(KCONFIG_TOOL_DIR)/conf --silentoldconfig $(SDK_PATH)/Kconfig + $(Q) touch $(AUTO_CONF_REGEN_TARGET) $(PROJECT_PATH)/build/include/sdkconfig.h +# touch to ensure both output files are newer - as 'conf' can also update sdkconfig (a dependency). Without this, +# sometimes you can get an infinite make loop on Windows where sdkconfig always gets regenerated newer +# than the target(!) + +clean: config-clean +.PHONY: config-clean +EXTRA_CLEAN_TARGETS += config-clean +config-clean: + $(MAKE) -C $(KCONFIG_TOOL_DIR) clean diff --git a/tools/gen_esp32part.py b/tools/gen_esp32part.py new file mode 100755 index 000000000..89da74671 --- /dev/null +++ b/tools/gen_esp32part.py @@ -0,0 +1,343 @@ +#!/usr/bin/env python +# +# ESP32 partition table generation tool +# +# Takes partition input from a CSV file of this format: +# +# Name,Type,SubType,Offset,Size +# +# Any row which starts with # is ignored as a comment. Whitespace at beginning/end of field is ignored. +# +# EXAMPLE CSV FILE CONTENTS +# ------------------------- +""" +# Name, Type, SubType, Offset, Size +factory, 0, 0, , 1M +ota_0, 0, 0x11, , 1M +ota_1, 0, 0x12, , 1M +ota_data, 1, 0, 5M, 128K +""" +# +# SAMPLE USAGE +# ------------ +# +# Convert CSV layout to binary: +# gen_esp32part.py table.csv table.bin +# +# Convert binary to CSV, print on stdout: +# gen_esp32part.py table.bin +# +# FIELD DETAILS +# ------------- +# +# Name: Human-readable name of partition. Values longer than 16 bytes will be truncated. +# +# Type: Numeric value for type field, or special keywords 'app' (for 0x00) or 'data' (for 0x01). +# +# SubType: Numeric value for subtype field, or special keywords depending on known types: +# app (0x00) : factory, ota_0 through ota_15, test. +# data (0x01) : ota, rf, wifi +# +# Default is zero if left blank. +# +# +# Offset: Start of partition. Examples: 0x800, 0x10000, 512, 2K, 1M +# - Offset can be left blank, and gen_esp32part will find the next valid offset (aligned to 64KB for app partitions.) +# +# Size: Size of partition. Examples: 0x800, 0x10000, 512, 2K, 1M +# +# SubType: 0 +# +# Offset: End of previous partition, aligned to 64kB if Type = 0 (app) & 4 bytes otherwise. +# +# +# +import struct +import argparse +import sys + +__version__ = '1.0' + +def debug(msg): + """ Print to stderr """ + sys.stderr.write(msg) + sys.stderr.write('\n') + +class PartitionTable(list): + def __init__(self): + super(PartitionTable, self).__init__(self) + + @classmethod + def from_csv(cls, csv_contents): + res = PartitionTable() + lines = csv_contents.split("\n") + for line_no in range(len(lines)): + line = lines[line_no].strip() + if line.startswith("#") or len(line) == 0: + continue + try: + res.append(PartitionDefinition.from_csv(line)) + except InputError as e: + raise InputError("Error at line %d: %s" % (line_no+1, e)) + except Exception: + debug("Unexpected error parsing line %d: %s" % (line_no+1, line)) + raise + + # fix up missing offsets & negative sizes + last_end = 0x5000 # first offset after partition table + for e in res: + if e.offset is None: + pad_to = 0x10000 if e.type == PartitionDefinition.APP_TYPE else 4 + if last_end % pad_to != 0: + last_end += pad_to - (last_end % pad_to) + e.offset = last_end + if e.size < 0: + e.size = -e.size - e.offset + last_end = e.offset + e.size + + return res + + def __getitem__(self, item): + """ Allow partition table access via name as well as by + numeric index. """ + if isinstance(item, str): + for x in self: + if x.name == item: + return x + raise ValueError("No partition entry named '%s'" % item) + else: + return super(PartitionTable, self).__getitem__(item) + + def verify(self): + # verify each partition individually + for p in self: + p.verify() + # check for overlaps + last = None + for p in sorted(self): + if p.offset < 0x5000: + raise InputError("Partition offset 0x%x is below 0x5000" % p.offset) + if last is not None and p.offset < last.offset + last.size: + raise InputError("Partition at 0x%x overlaps 0x%x-0x%x" % (p.offset, last.offset, last.offset+last.size-1)) + last = p + + @classmethod + def from_binary(cls, b): + if len(b) % 32 != 0: + raise InputError("Partition table length must be a multiple of 32 bytes. Got %d bytes." % len(b)) + result = cls() + for o in range(0,len(b),32): + result.append(PartitionDefinition.from_binary(b[o:o+32])) + return result + + def to_binary(self): + return "".join(e.to_binary() for e in self) + + def to_csv(self, simple_formatting=False): + rows = [ "# Espressif ESP32 Partition Table", + "# Name, Type, SubType, Offset, Size" ] + rows += [ x.to_csv(simple_formatting) for x in self ] + return "\n".join(rows) + +class PartitionDefinition(object): + APP_TYPE = 0x00 + DATA_TYPE = 0x01 + TYPES = { + "app" : APP_TYPE, + "data" : DATA_TYPE, + } + + SUBTYPES = { + APP_TYPE : { + "factory" : 0x00, + "test" : 0x20, + }, + DATA_TYPE : { + "ota" : 0x00, + "rf" : 0x01, + "wifi" : 0x02, + }, + } + + MAGIC_BYTES = "\xAA\x50" + + ALIGNMENT = { + APP_TYPE : 0x1000, + DATA_TYPE : 0x04, + } + + # add subtypes for the 16 OTA slot values ("ota_XXX, etc.") + for ota_slot in range(16): + SUBTYPES[TYPES["app"]]["ota_%d" % ota_slot] = 0x10 + ota_slot + + def __init__(self): + self.name = "" + self.type = None + self.subtype = None + self.offset = None + self.size = None + + @classmethod + def from_csv(cls, line): + """ Parse a line from the CSV """ + line_w_defaults = line + ",,," # lazy way to support default fields + fields = [ f.strip() for f in line_w_defaults.split(",") ] + + res = PartitionDefinition() + res.name = fields[0] + res.type = res.parse_type(fields[1]) + res.subtype = res.parse_subtype(fields[2]) + res.offset = res.parse_address(fields[3]) + res.size = res.parse_address(fields[4]) + if res.size is None: + raise InputError("Size field can't be empty") + return res + + def __eq__(self, other): + return self.name == other.name and self.type == other.type \ + and self.subtype == other.subtype and self.offset == other.offset \ + and self.size == other.size + + def __repr__(self): + def maybe_hex(x): + return "0x%x" % x if x is not None else "None" + return "PartitionDefinition('%s', 0x%x, 0x%x, %s, %s)" % (self.name, self.type, self.subtype or 0, + maybe_hex(self.offset), maybe_hex(self.size)) + + def __str__(self): + return "Part '%s' %d/%d @ 0x%x size 0x%x" % (self.name, self.type, self.subtype, self.offset or -1, self.size or -1) + + def __cmp__(self, other): + return self.offset - other.offset + + def parse_type(self, strval): + if strval == "": + raise InputError("Field 'type' can't be left empty.") + return parse_int(strval, self.TYPES) + + def parse_subtype(self, strval): + if strval == "": + return 0 # default + return parse_int(strval, self.SUBTYPES.get(self.type, {})) + + def parse_address(self, strval): + if strval == "": + return None # PartitionTable will fill in default + return parse_int(strval) + + def verify(self): + if self.type is None: + raise ValidationError("Type field is not set") + if self.subtype is None: + raise ValidationError("Subtype field is not set") + if self.offset is None: + raise ValidationError("Offset field is not set") + align = self.ALIGNMENT.get(self.type, 4) + if self.offset % align: + raise ValidationError("%s offset 0x%x is not aligned to 0x%x" % (self.name, self.offset, align)) + if self.size is None: + raise ValidationError("Size field is not set") + + STRUCT_FORMAT = "<2sBBLL16sL" + + @classmethod + def from_binary(cls, b): + if len(b) != 32: + raise InputError("Partition definition length must be exactly 32 bytes. Got %d bytes." % len(b)) + res = cls() + (magic, res.type, res.subtype, res.offset, + res.size, res.name, reserved) = struct.unpack(cls.STRUCT_FORMAT, b) + if "\x00" in res.name: # strip null byte padding from name string + res.name = res.name[:res.name.index("\x00")] + if magic != cls.MAGIC_BYTES: + raise InputError("Invalid magic bytes (%r) for partition definition" % magic) + if reserved != 0: + debug("WARNING: Partition definition had unexpected reserved value 0x%08x. Newer binary format?" % reserved) + return res + + def to_binary(self): + return struct.pack(self.STRUCT_FORMAT, + self.MAGIC_BYTES, + self.type, self.subtype, + self.offset, self.size, + self.name, + 0) # reserved + + def to_csv(self, simple_formatting=False): + def addr_format(a): + if not simple_formatting: + for (val, suffix) in [ (0x100000, "M"), (0x400, "K") ]: + if a % val == 0: + return "%d%s" % (a / val, suffix) + return "0x%x" % a + + def lookup_keyword(t, keywords): + for k,v in keywords.items(): + if simple_formatting == False and t == v: + return k + return "%d" % t + + return ",".join([ self.name, + lookup_keyword(self.type, self.TYPES), + lookup_keyword(self.subtype, self.SUBTYPES), + addr_format(self.offset), + addr_format(self.size) ]) + +class InputError(RuntimeError): + def __init__(self, e): + super(InputError, self).__init__(e) + +def parse_int(v, keywords={}): + """Generic parser for integer fields - int(x,0) with provision for + k/m/K/M suffixes and 'keyword' value lookup. + """ + try: + for letter, multiplier in [ ("k",1024), ("m",1024*1024) ]: + if v.lower().endswith(letter): + return parse_int(v[:-1], keywords) * multiplier + return int(v, 0) + except ValueError: + if len(keywords) == 0: + raise InputError("Invalid field value %s" % v) + try: + return keywords[v.lower()] + except KeyError: + raise InputError("Value '%s' is not valid. Known keywords: %s" % (v, ", ".join(keywords))) + +def main(): + parser = argparse.ArgumentParser(description='ESP32 partition table utility') + + parser.add_argument('--verify', '-v', help='Verify partition table fields', default=True, action='store_false') + + parser.add_argument('input', help='Path to CSV or binary file to parse. Will use stdin if omitted.', type=argparse.FileType('r'), default=sys.stdin) + parser.add_argument('output', help='Path to output converted binary or CSV file. Will use stdout if omitted, unless the --display argument is also passed (in which case only the summary is printed.)', + type=argparse.FileType('w'), nargs='?', + default=sys.stdout) + + args = parser.parse_args() + + input = args.input.read() + input_is_binary = input[0:2] == PartitionDefinition.MAGIC_BYTES + if input_is_binary: + debug("Parsing binary partition input...") + table = PartitionTable.from_binary(input) + else: + debug("Parsing CSV input...") + table = PartitionTable.from_csv(input) + + if args.verify: + debug("Verifying table...") + table.verify() + + if input_is_binary: + output = table.to_csv() + else: + output = table.to_binary() + args.output.write(output) + +if __name__ == '__main__': + try: + main() + except InputError as e: + print(e) + sys.exit(2) diff --git a/tools/kconfig/.gitignore b/tools/kconfig/.gitignore new file mode 100644 index 000000000..be603c4fe --- /dev/null +++ b/tools/kconfig/.gitignore @@ -0,0 +1,22 @@ +# +# Generated files +# +config* +*.lex.c +*.tab.c +*.tab.h +zconf.hash.c +*.moc +gconf.glade.h +*.pot +*.mo + +# +# configuration programs +# +conf +mconf +nconf +qconf +gconf +kxgettext diff --git a/tools/kconfig/Kconfig b/tools/kconfig/Kconfig new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/tools/kconfig/Kconfig @@ -0,0 +1 @@ + diff --git a/tools/kconfig/Makefile b/tools/kconfig/Makefile new file mode 100644 index 000000000..b265e9b38 --- /dev/null +++ b/tools/kconfig/Makefile @@ -0,0 +1,306 @@ +# =========================================================================== +# Kernel configuration targets +# These targets are used from top-level makefile + +PHONY += xconfig gconfig menuconfig config silentoldconfig \ + localmodconfig localyesconfig clean + +ifdef KBUILD_KCONFIG +Kconfig := $(KBUILD_KCONFIG) +else +Kconfig := Kconfig +endif + +ifeq ($(quiet),silent_) +silent := -s +endif + +# We need this, in case the user has it in its environment +unexport CONFIG_ + + +default: mconf conf + +xconfig: qconf + $< $(silent) $(Kconfig) + +gconfig: gconf + $< $(silent) $(Kconfig) + +menuconfig: mconf + $< $(silent) $(Kconfig) + +config: conf + $< $(silent) --oldaskconfig $(Kconfig) + +nconfig: nconf + $< $(silent) $(Kconfig) + +silentoldconfig: conf + $(Q)mkdir -p include/config include/generated + $< $(silent) --$@ $(Kconfig) + +localyesconfig localmodconfig: streamline_config.pl conf + $(Q)mkdir -p include/config include/generated + $(Q)perl $< --$@ . $(Kconfig) > .tmp.config + $(Q)if [ -f .config ]; then \ + cmp -s .tmp.config .config || \ + (mv -f .config .config.old.1; \ + mv -f .tmp.config .config; \ + conf $(silent) --silentoldconfig $(Kconfig); \ + mv -f .config.old.1 .config.old) \ + else \ + mv -f .tmp.config .config; \ + conf $(silent) --silentoldconfig $(Kconfig); \ + fi + $(Q)rm -f .tmp.config + + +# These targets map 1:1 to the commandline options of 'conf' +simple-targets := oldconfig allnoconfig allyesconfig allmodconfig \ + alldefconfig randconfig listnewconfig olddefconfig +PHONY += $(simple-targets) + +$(simple-targets): conf + $< $(silent) --$@ $(Kconfig) + +PHONY += oldnoconfig savedefconfig defconfig + +# oldnoconfig is an alias of olddefconfig, because people already are dependent +# on its behavior (sets new symbols to their default value but not 'n') with the +# counter-intuitive name. +oldnoconfig: olddefconfig + +savedefconfig: conf + $< $(silent) --$@=defconfig $(Kconfig) + +defconfig: conf +ifeq ($(KBUILD_DEFCONFIG),) + $< $(silent) --defconfig $(Kconfig) +else +ifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/configs/$(KBUILD_DEFCONFIG)),) + @$(kecho) "*** Default configuration is based on '$(KBUILD_DEFCONFIG)'" + $(Q)$< $(silent) --defconfig=arch/$(SRCARCH)/configs/$(KBUILD_DEFCONFIG) $(Kconfig) +else + @$(kecho) "*** Default configuration is based on target '$(KBUILD_DEFCONFIG)'" + $(Q) $(MAKE) -f $(srctree)/Makefile $(KBUILD_DEFCONFIG) +endif +endif + +%_defconfig: conf + $(Q)$< $(silent) --defconfig=arch/$(SRCARCH)/configs/$@ $(Kconfig) + +configfiles=$(wildcard $(srctree)/kernel/configs/$@ $(srctree)/arch/$(SRCARCH)/configs/$@) + +%.config: conf + $(if $(call configfiles),, $(error No configuration exists for this target on this architecture)) + $(Q)$(CONFIG_SHELL) $(srctree)/scripts/kconfig/merge_config.sh -m .config $(configfiles) + +$(Q)yes "" | $(MAKE) -f $(srctree)/Makefile oldconfig + +PHONY += kvmconfig +kvmconfig: kvm_guest.config + @: + +PHONY += xenconfig +xenconfig: xen.config + @: + +PHONY += tinyconfig +tinyconfig: + $(Q)$(MAKE) -f $(srctree)/Makefile allnoconfig tiny.config + +# Help text used by make help +help: + @echo ' config - Update current config utilising a line-oriented program' + @echo ' nconfig - Update current config utilising a ncurses menu based' + @echo ' program' + @echo ' menuconfig - Update current config utilising a menu based program' + @echo ' xconfig - Update current config utilising a Qt based front-end' + @echo ' gconfig - Update current config utilising a GTK+ based front-end' + @echo ' oldconfig - Update current config utilising a provided .config as base' + @echo ' localmodconfig - Update current config disabling modules not loaded' + @echo ' localyesconfig - Update current config converting local mods to core' + @echo ' silentoldconfig - Same as oldconfig, but quietly, additionally update deps' + @echo ' defconfig - New config with default from ARCH supplied defconfig' + @echo ' savedefconfig - Save current config as ./defconfig (minimal config)' + @echo ' allnoconfig - New config where all options are answered with no' + @echo ' allyesconfig - New config where all options are accepted with yes' + @echo ' allmodconfig - New config selecting modules when possible' + @echo ' alldefconfig - New config with all symbols set to default' + @echo ' randconfig - New config with random answer to all options' + @echo ' listnewconfig - List new options' + @echo ' olddefconfig - Same as silentoldconfig but sets new symbols to their' + @echo ' default value' + @echo ' kvmconfig - Enable additional options for kvm guest kernel support' + @echo ' xenconfig - Enable additional options for xen dom0 and guest kernel support' + @echo ' tinyconfig - Configure the tiniest possible kernel' + +# lxdialog stuff +check-lxdialog := lxdialog/check-lxdialog.sh + +# Use recursively expanded variables so we do not call gcc unless +# we really need to do so. (Do not call gcc as part of make mrproper) +CFLAGS += $(shell $(CONFIG_SHELL) $(check-lxdialog) -ccflags) \ + -DLOCALE + +# =========================================================================== +# Shared Makefile for the various kconfig executables: +# conf: Used for defconfig, oldconfig and related targets +# nconf: Used for the nconfig target. +# Utilizes ncurses +# mconf: Used for the menuconfig target +# Utilizes the lxdialog package +# qconf: Used for the xconfig target +# Based on Qt which needs to be installed to compile it +# gconf: Used for the gconfig target +# Based on GTK+ which needs to be installed to compile it +# object files used by all kconfig flavours + +lxdialog := lxdialog/checklist.o lxdialog/util.o lxdialog/inputbox.o +lxdialog += lxdialog/textbox.o lxdialog/yesno.o lxdialog/menubox.o + +conf-objs := conf.o zconf.tab.o +mconf-objs := mconf.o zconf.tab.o $(lxdialog) +nconf-objs := nconf.o zconf.tab.o nconf.gui.o +kxgettext-objs := kxgettext.o zconf.tab.o +qconf-cxxobjs := qconf.o +qconf-objs := zconf.tab.o +gconf-objs := gconf.o zconf.tab.o + +hostprogs-y := conf nconf mconf kxgettext qconf gconf + +clean-files := qconf.moc .tmp_qtcheck .tmp_gtkcheck +clean-files += zconf.tab.c zconf.lex.c zconf.hash.c gconf.glade.h +clean-files += $(conf-objs) $(mconf-objs) conf mconf $(lxdialog) + +# Check that we have the required ncurses stuff installed for lxdialog (menuconfig) +PHONY += dochecklxdialog +$(addprefix ,$(lxdialog)): dochecklxdialog +dochecklxdialog: + $(Q)$(CONFIG_SHELL) $(check-lxdialog) -check $(CC) $(CFLAGS) $(LOADLIBES_mconf) + +always := dochecklxdialog + +# Add environment specific flags +EXTRACFLAGS += $(shell $(CONFIG_SHELL) $(srctree)/$(src)/check.sh $(CC) $(CFLAGS)) + +# generated files seem to need this to find local include files +CFLAGS_zconf.lex.o := -I$(src) +CFLAGS_zconf.tab.o := -I$(src) + +LEX_PREFIX_zconf := zconf +YACC_PREFIX_zconf := zconf + +LOADLIBES_qconf = $(KC_QT_LIBS) +CXXFLAGS_qconf.o = $(KC_QT_CFLAGS) + +LOADLIBES_gconf = `pkg-config --libs gtk+-2.0 gmodule-2.0 libglade-2.0` +CFLAGS_gconf.o = `pkg-config --cflags gtk+-2.0 gmodule-2.0 libglade-2.0` \ + -Wno-missing-prototypes + +LOADLIBES_mconf = $(shell $(CONFIG_SHELL) $(check-lxdialog) -ldflags $(CC)) + +LOADLIBES_conf = $(LOADLIBES_mconf) + +LOADLIBES_nconf = $(shell \ + pkg-config --libs menuw panelw ncursesw 2>/dev/null \ + || pkg-config --libs menu panel ncurses 2>/dev/null \ + || echo "-lmenu -lpanel -lncurses" ) + +ifeq ("$(OS)","Windows_NT") +# Windows toolchains don't seem to count libintl +# as a system library +LOADLIBES_mconf += -lintl +LOADLIBES_nconf += -lintl +endif + +qconf.o: .tmp_qtcheck + +ifeq ($(MAKECMDGOALS),xconfig) +.tmp_qtcheck: $(src)/Makefile +-include .tmp_qtcheck + +# Qt needs some extra effort... +.tmp_qtcheck: + @set -e; $(kecho) " CHECK qt"; \ + if pkg-config --exists Qt5Core; then \ + cflags="-std=c++11 -fPIC `pkg-config --cflags Qt5Core Qt5Gui Qt5Widgets`"; \ + libs=`pkg-config --libs Qt5Core Qt5Gui Qt5Widgets`; \ + moc=`pkg-config --variable=host_bins Qt5Core`/moc; \ + elif pkg-config --exists QtCore; then \ + cflags=`pkg-config --cflags QtCore QtGui`; \ + libs=`pkg-config --libs QtCore QtGui`; \ + moc=`pkg-config --variable=moc_location QtCore`; \ + else \ + echo >&2 "*"; \ + echo >&2 "* Could not find Qt via pkg-config."; \ + echo >&2 "* Please install either Qt 4.8 or 5.x. and make sure it's in PKG_CONFIG_PATH"; \ + echo >&2 "*"; \ + exit 1; \ + fi; \ + echo "KC_QT_CFLAGS=$$cflags" > $@; \ + echo "KC_QT_LIBS=$$libs" >> $@; \ + echo "KC_QT_MOC=$$moc" >> $@ +endif + +gconf.o: .tmp_gtkcheck + +ifeq ($(MAKECMDGOALS),gconfig) +-include .tmp_gtkcheck + +# GTK+ needs some extra effort, too... +.tmp_gtkcheck: + @if `pkg-config --exists gtk+-2.0 gmodule-2.0 libglade-2.0`; then \ + if `pkg-config --atleast-version=2.0.0 gtk+-2.0`; then \ + touch $@; \ + else \ + echo >&2 "*"; \ + echo >&2 "* GTK+ is present but version >= 2.0.0 is required."; \ + echo >&2 "*"; \ + false; \ + fi \ + else \ + echo >&2 "*"; \ + echo >&2 "* Unable to find the GTK+ installation. Please make sure that"; \ + echo >&2 "* the GTK+ 2.0 development package is correctly installed..."; \ + echo >&2 "* You need gtk+-2.0, glib-2.0 and libglade-2.0."; \ + echo >&2 "*"; \ + false; \ + fi +endif + +zconf.tab.o: zconf.lex.c zconf.hash.c + +qconf.o: qconf.moc + +quiet_cmd_moc = MOC $@ + cmd_moc = $(KC_QT_MOC) -i $< -o $@ + +%.moc: $(src)/%.h .tmp_qtcheck + $(call cmd,moc) + +# Extract gconf menu items for i18n support +gconf.glade.h: gconf.glade + $(Q)intltool-extract --type=gettext/glade --srcdir=$(srctree) \ + gconf.glade + + +mconf: $(mconf-objs) + $(CC) -o $@ $(mconf-objs) $(LOADLIBES_mconf) + +conf: $(conf-objs) + $(CC) -o $@ $(conf-objs) $(LOADLIBES_conf) + +zconf.tab.c: zconf.lex.c + +zconf.lex.c: zconf.l + flex -L -P zconf -o zconf.lex.c zconf.l + +zconf.hash.c: zconf.gperf + gperf -t --output-file zconf.hash.c -a -C -E -g -k '1,3,$$' -p -t zconf.gperf + +zconf.tab.c: zconf.y + bison -t -l -p zconf -o zconf.tab.c zconf.y + +clean: + rm -f $(clean-files) diff --git a/tools/kconfig/POTFILES.in b/tools/kconfig/POTFILES.in new file mode 100644 index 000000000..967457396 --- /dev/null +++ b/tools/kconfig/POTFILES.in @@ -0,0 +1,12 @@ +scripts/kconfig/lxdialog/checklist.c +scripts/kconfig/lxdialog/inputbox.c +scripts/kconfig/lxdialog/menubox.c +scripts/kconfig/lxdialog/textbox.c +scripts/kconfig/lxdialog/util.c +scripts/kconfig/lxdialog/yesno.c +scripts/kconfig/mconf.c +scripts/kconfig/conf.c +scripts/kconfig/confdata.c +scripts/kconfig/gconf.c +scripts/kconfig/gconf.glade.h +scripts/kconfig/qconf.cc diff --git a/tools/kconfig/check.sh b/tools/kconfig/check.sh new file mode 100755 index 000000000..55b79ba1b --- /dev/null +++ b/tools/kconfig/check.sh @@ -0,0 +1,13 @@ +#!/bin/sh +# Needed for systems without gettext +$* -x c -o /dev/null - > /dev/null 2>&1 << EOF +#include +int main() +{ + gettext(""); + return 0; +} +EOF +if [ ! "$?" -eq "0" ]; then + echo -DKBUILD_NO_NLS; +fi diff --git a/tools/kconfig/conf.c b/tools/kconfig/conf.c new file mode 100644 index 000000000..866369f10 --- /dev/null +++ b/tools/kconfig/conf.c @@ -0,0 +1,723 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "lkc.h" + +static void conf(struct menu *menu); +static void check_conf(struct menu *menu); +static void xfgets(char *str, int size, FILE *in); + +enum input_mode { + oldaskconfig, + silentoldconfig, + oldconfig, + allnoconfig, + allyesconfig, + allmodconfig, + alldefconfig, + randconfig, + defconfig, + savedefconfig, + listnewconfig, + olddefconfig, +} input_mode = oldaskconfig; + +static int indent = 1; +static int tty_stdio; +static int valid_stdin = 1; +static int sync_kconfig; +static int conf_cnt; +static char line[PATH_MAX]; +static struct menu *rootEntry; + +static void print_help(struct menu *menu) +{ + struct gstr help = str_new(); + + menu_get_ext_help(menu, &help); + + printf("\n%s\n", str_get(&help)); + str_free(&help); +} + +static void strip(char *str) +{ + char *p = str; + int l; + + while ((isspace(*p))) + p++; + l = strlen(p); + if (p != str) + memmove(str, p, l + 1); + if (!l) + return; + p = str + l - 1; + while ((isspace(*p))) + *p-- = 0; +} + +static void check_stdin(void) +{ + if (!valid_stdin) { + printf(_("aborted!\n\n")); + printf(_("Console input/output is redirected. ")); + printf(_("Run 'make oldconfig' to update configuration.\n\n")); + exit(1); + } +} + +static int conf_askvalue(struct symbol *sym, const char *def) +{ + enum symbol_type type = sym_get_type(sym); + + if (!sym_has_value(sym)) + printf(_("(NEW) ")); + + line[0] = '\n'; + line[1] = 0; + + if (!sym_is_changable(sym)) { + printf("%s\n", def); + line[0] = '\n'; + line[1] = 0; + return 0; + } + + switch (input_mode) { + case oldconfig: + case silentoldconfig: + if (sym_has_value(sym)) { + printf("%s\n", def); + return 0; + } + check_stdin(); + /* fall through */ + case oldaskconfig: + fflush(stdout); + xfgets(line, sizeof(line), stdin); + if (!tty_stdio) + printf("\n"); + return 1; + default: + break; + } + + switch (type) { + case S_INT: + case S_HEX: + case S_STRING: + printf("%s\n", def); + return 1; + default: + ; + } + printf("%s", line); + return 1; +} + +static int conf_string(struct menu *menu) +{ + struct symbol *sym = menu->sym; + const char *def; + + while (1) { + printf("%*s%s ", indent - 1, "", _(menu->prompt->text)); + printf("(%s) ", sym->name); + def = sym_get_string_value(sym); + if (sym_get_string_value(sym)) + printf("[%s] ", def); + if (!conf_askvalue(sym, def)) + return 0; + switch (line[0]) { + case '\n': + break; + case '?': + /* print help */ + if (line[1] == '\n') { + print_help(menu); + def = NULL; + break; + } + /* fall through */ + default: + line[strlen(line)-1] = 0; + def = line; + } + if (def && sym_set_string_value(sym, def)) + return 0; + } +} + +static int conf_sym(struct menu *menu) +{ + struct symbol *sym = menu->sym; + tristate oldval, newval; + + while (1) { + printf("%*s%s ", indent - 1, "", _(menu->prompt->text)); + if (sym->name) + printf("(%s) ", sym->name); + putchar('['); + oldval = sym_get_tristate_value(sym); + switch (oldval) { + case no: + putchar('N'); + break; + case mod: + putchar('M'); + break; + case yes: + putchar('Y'); + break; + } + if (oldval != no && sym_tristate_within_range(sym, no)) + printf("/n"); + if (oldval != mod && sym_tristate_within_range(sym, mod)) + printf("/m"); + if (oldval != yes && sym_tristate_within_range(sym, yes)) + printf("/y"); + if (menu_has_help(menu)) + printf("/?"); + printf("] "); + if (!conf_askvalue(sym, sym_get_string_value(sym))) + return 0; + strip(line); + + switch (line[0]) { + case 'n': + case 'N': + newval = no; + if (!line[1] || !strcmp(&line[1], "o")) + break; + continue; + case 'm': + case 'M': + newval = mod; + if (!line[1]) + break; + continue; + case 'y': + case 'Y': + newval = yes; + if (!line[1] || !strcmp(&line[1], "es")) + break; + continue; + case 0: + newval = oldval; + break; + case '?': + goto help; + default: + continue; + } + if (sym_set_tristate_value(sym, newval)) + return 0; +help: + print_help(menu); + } +} + +static int conf_choice(struct menu *menu) +{ + struct symbol *sym, *def_sym; + struct menu *child; + bool is_new; + + sym = menu->sym; + is_new = !sym_has_value(sym); + if (sym_is_changable(sym)) { + conf_sym(menu); + sym_calc_value(sym); + switch (sym_get_tristate_value(sym)) { + case no: + return 1; + case mod: + return 0; + case yes: + break; + } + } else { + switch (sym_get_tristate_value(sym)) { + case no: + return 1; + case mod: + printf("%*s%s\n", indent - 1, "", _(menu_get_prompt(menu))); + return 0; + case yes: + break; + } + } + + while (1) { + int cnt, def; + + printf("%*s%s\n", indent - 1, "", _(menu_get_prompt(menu))); + def_sym = sym_get_choice_value(sym); + cnt = def = 0; + line[0] = 0; + for (child = menu->list; child; child = child->next) { + if (!menu_is_visible(child)) + continue; + if (!child->sym) { + printf("%*c %s\n", indent, '*', _(menu_get_prompt(child))); + continue; + } + cnt++; + if (child->sym == def_sym) { + def = cnt; + printf("%*c", indent, '>'); + } else + printf("%*c", indent, ' '); + printf(" %d. %s", cnt, _(menu_get_prompt(child))); + if (child->sym->name) + printf(" (%s)", child->sym->name); + if (!sym_has_value(child->sym)) + printf(_(" (NEW)")); + printf("\n"); + } + printf(_("%*schoice"), indent - 1, ""); + if (cnt == 1) { + printf("[1]: 1\n"); + goto conf_childs; + } + printf("[1-%d", cnt); + if (menu_has_help(menu)) + printf("?"); + printf("]: "); + switch (input_mode) { + case oldconfig: + case silentoldconfig: + if (!is_new) { + cnt = def; + printf("%d\n", cnt); + break; + } + check_stdin(); + /* fall through */ + case oldaskconfig: + fflush(stdout); + xfgets(line, sizeof(line), stdin); + strip(line); + if (line[0] == '?') { + print_help(menu); + continue; + } + if (!line[0]) + cnt = def; + else if (isdigit(line[0])) + cnt = atoi(line); + else + continue; + break; + default: + break; + } + + conf_childs: + for (child = menu->list; child; child = child->next) { + if (!child->sym || !menu_is_visible(child)) + continue; + if (!--cnt) + break; + } + if (!child) + continue; + if (line[0] && line[strlen(line) - 1] == '?') { + print_help(child); + continue; + } + sym_set_choice_value(sym, child->sym); + for (child = child->list; child; child = child->next) { + indent += 2; + conf(child); + indent -= 2; + } + return 1; + } +} + +static void conf(struct menu *menu) +{ + struct symbol *sym; + struct property *prop; + struct menu *child; + + if (!menu_is_visible(menu)) + return; + + sym = menu->sym; + prop = menu->prompt; + if (prop) { + const char *prompt; + + switch (prop->type) { + case P_MENU: + if ((input_mode == silentoldconfig || + input_mode == listnewconfig || + input_mode == olddefconfig) && + rootEntry != menu) { + check_conf(menu); + return; + } + /* fall through */ + case P_COMMENT: + prompt = menu_get_prompt(menu); + if (prompt) + printf("%*c\n%*c %s\n%*c\n", + indent, '*', + indent, '*', _(prompt), + indent, '*'); + default: + ; + } + } + + if (!sym) + goto conf_childs; + + if (sym_is_choice(sym)) { + conf_choice(menu); + if (sym->curr.tri != mod) + return; + goto conf_childs; + } + + switch (sym->type) { + case S_INT: + case S_HEX: + case S_STRING: + conf_string(menu); + break; + default: + conf_sym(menu); + break; + } + +conf_childs: + if (sym) + indent += 2; + for (child = menu->list; child; child = child->next) + conf(child); + if (sym) + indent -= 2; +} + +static void check_conf(struct menu *menu) +{ + struct symbol *sym; + struct menu *child; + + if (!menu_is_visible(menu)) + return; + + sym = menu->sym; + if (sym && !sym_has_value(sym)) { + if (sym_is_changable(sym) || + (sym_is_choice(sym) && sym_get_tristate_value(sym) == yes)) { + if (input_mode == listnewconfig) { + if (sym->name && !sym_is_choice_value(sym)) { + printf("%s%s\n", CONFIG_, sym->name); + } + } else if (input_mode != olddefconfig) { + if (!conf_cnt++) + printf(_("*\n* Restart config...\n*\n")); + rootEntry = menu_get_parent_menu(menu); + conf(rootEntry); + } + } + } + + for (child = menu->list; child; child = child->next) + check_conf(child); +} + +static struct option long_opts[] = { + {"oldaskconfig", no_argument, NULL, oldaskconfig}, + {"oldconfig", no_argument, NULL, oldconfig}, + {"silentoldconfig", no_argument, NULL, silentoldconfig}, + {"defconfig", optional_argument, NULL, defconfig}, + {"savedefconfig", required_argument, NULL, savedefconfig}, + {"allnoconfig", no_argument, NULL, allnoconfig}, + {"allyesconfig", no_argument, NULL, allyesconfig}, + {"allmodconfig", no_argument, NULL, allmodconfig}, + {"alldefconfig", no_argument, NULL, alldefconfig}, + {"randconfig", no_argument, NULL, randconfig}, + {"listnewconfig", no_argument, NULL, listnewconfig}, + {"olddefconfig", no_argument, NULL, olddefconfig}, + /* + * oldnoconfig is an alias of olddefconfig, because people already + * are dependent on its behavior(sets new symbols to their default + * value but not 'n') with the counter-intuitive name. + */ + {"oldnoconfig", no_argument, NULL, olddefconfig}, + {NULL, 0, NULL, 0} +}; + +static void conf_usage(const char *progname) +{ + + printf("Usage: %s [-s] [option] \n", progname); + printf("[option] is _one_ of the following:\n"); + printf(" --listnewconfig List new options\n"); + printf(" --oldaskconfig Start a new configuration using a line-oriented program\n"); + printf(" --oldconfig Update a configuration using a provided .config as base\n"); + printf(" --silentoldconfig Same as oldconfig, but quietly, additionally update deps\n"); + printf(" --olddefconfig Same as silentoldconfig but sets new symbols to their default value\n"); + printf(" --oldnoconfig An alias of olddefconfig\n"); + printf(" --defconfig New config with default defined in \n"); + printf(" --savedefconfig Save the minimal current configuration to \n"); + printf(" --allnoconfig New config where all options are answered with no\n"); + printf(" --allyesconfig New config where all options are answered with yes\n"); + printf(" --allmodconfig New config where all options are answered with mod\n"); + printf(" --alldefconfig New config with all symbols set to default\n"); + printf(" --randconfig New config with random answer to all options\n"); +} + +int main(int ac, char **av) +{ + const char *progname = av[0]; + int opt; + const char *name, *defconfig_file = NULL /* gcc uninit */; + struct stat tmpstat; + + setlocale(LC_ALL, ""); + bindtextdomain(PACKAGE, LOCALEDIR); + textdomain(PACKAGE); + + tty_stdio = isatty(0) && isatty(1) && isatty(2); + + while ((opt = getopt_long(ac, av, "s", long_opts, NULL)) != -1) { + if (opt == 's') { + conf_set_message_callback(NULL); + continue; + } + input_mode = (enum input_mode)opt; + switch (opt) { + case silentoldconfig: + sync_kconfig = 1; + break; + case defconfig: + case savedefconfig: + defconfig_file = optarg; + break; + case randconfig: + { + struct timeval now; + unsigned int seed; + char *seed_env; + + /* + * Use microseconds derived seed, + * compensate for systems where it may be zero + */ + gettimeofday(&now, NULL); + seed = (unsigned int)((now.tv_sec + 1) * (now.tv_usec + 1)); + + seed_env = getenv("KCONFIG_SEED"); + if( seed_env && *seed_env ) { + char *endp; + int tmp = (int)strtol(seed_env, &endp, 0); + if (*endp == '\0') { + seed = tmp; + } + } + fprintf( stderr, "KCONFIG_SEED=0x%X\n", seed ); + srand(seed); + break; + } + case oldaskconfig: + case oldconfig: + case allnoconfig: + case allyesconfig: + case allmodconfig: + case alldefconfig: + case listnewconfig: + case olddefconfig: + break; + case '?': + conf_usage(progname); + exit(1); + break; + } + } + if (ac == optind) { + printf(_("%s: Kconfig file missing\n"), av[0]); + conf_usage(progname); + exit(1); + } + name = av[optind]; + conf_parse(name); + //zconfdump(stdout); + if (sync_kconfig) { + name = conf_get_configname(); + if (stat(name, &tmpstat)) { + fprintf(stderr, _("***\n" + "*** Configuration file \"%s\" not found!\n" + "***\n" + "*** Please run some configurator (e.g. \"make oldconfig\" or\n" + "*** \"make menuconfig\" or \"make xconfig\").\n" + "***\n"), name); + exit(1); + } + } + + switch (input_mode) { + case defconfig: + if (!defconfig_file) + defconfig_file = conf_get_default_confname(); + if (conf_read(defconfig_file)) { + printf(_("***\n" + "*** Can't find default configuration \"%s\"!\n" + "***\n"), defconfig_file); + exit(1); + } + break; + case savedefconfig: + case silentoldconfig: + case oldaskconfig: + case oldconfig: + case listnewconfig: + case olddefconfig: + conf_read(NULL); + break; + case allnoconfig: + case allyesconfig: + case allmodconfig: + case alldefconfig: + case randconfig: + name = getenv("KCONFIG_ALLCONFIG"); + if (!name) + break; + if ((strcmp(name, "") != 0) && (strcmp(name, "1") != 0)) { + if (conf_read_simple(name, S_DEF_USER)) { + fprintf(stderr, + _("*** Can't read seed configuration \"%s\"!\n"), + name); + exit(1); + } + break; + } + switch (input_mode) { + case allnoconfig: name = "allno.config"; break; + case allyesconfig: name = "allyes.config"; break; + case allmodconfig: name = "allmod.config"; break; + case alldefconfig: name = "alldef.config"; break; + case randconfig: name = "allrandom.config"; break; + default: break; + } + if (conf_read_simple(name, S_DEF_USER) && + conf_read_simple("all.config", S_DEF_USER)) { + fprintf(stderr, + _("*** KCONFIG_ALLCONFIG set, but no \"%s\" or \"all.config\" file found\n"), + name); + exit(1); + } + break; + default: + break; + } + + if (sync_kconfig) { + if (conf_get_changed()) { + name = getenv("KCONFIG_NOSILENTUPDATE"); + if (name && *name) { + fprintf(stderr, + _("\n*** The configuration requires explicit update.\n\n")); + return 1; + } + } + valid_stdin = tty_stdio; + } + + switch (input_mode) { + case allnoconfig: + conf_set_all_new_symbols(def_no); + break; + case allyesconfig: + conf_set_all_new_symbols(def_yes); + break; + case allmodconfig: + conf_set_all_new_symbols(def_mod); + break; + case alldefconfig: + conf_set_all_new_symbols(def_default); + break; + case randconfig: + /* Really nothing to do in this loop */ + while (conf_set_all_new_symbols(def_random)) ; + break; + case defconfig: + conf_set_all_new_symbols(def_default); + break; + case savedefconfig: + break; + case oldaskconfig: + rootEntry = &rootmenu; + conf(&rootmenu); + input_mode = silentoldconfig; + /* fall through */ + case oldconfig: + case listnewconfig: + case olddefconfig: + case silentoldconfig: + /* Update until a loop caused no more changes */ + do { + conf_cnt = 0; + check_conf(&rootmenu); + } while (conf_cnt && + (input_mode != listnewconfig && + input_mode != olddefconfig)); + break; + } + + if (sync_kconfig) { + /* silentoldconfig is used during the build so we shall update autoconf. + * All other commands are only used to generate a config. + */ + if (conf_get_changed() && conf_write(NULL)) { + fprintf(stderr, _("\n*** Error during writing of the configuration.\n\n")); + exit(1); + } + if (conf_write_autoconf()) { + fprintf(stderr, _("\n*** Error during update of the configuration.\n\n")); + return 1; + } + } else if (input_mode == savedefconfig) { + if (conf_write_defconfig(defconfig_file)) { + fprintf(stderr, _("n*** Error while saving defconfig to: %s\n\n"), + defconfig_file); + return 1; + } + } else if (input_mode != listnewconfig) { + if (conf_write(NULL)) { + fprintf(stderr, _("\n*** Error during writing of the configuration.\n\n")); + exit(1); + } + } + return 0; +} + +/* + * Helper function to facilitate fgets() by Jean Sacren. + */ +void xfgets(char *str, int size, FILE *in) +{ + if (fgets(str, size, in) == NULL) + fprintf(stderr, "\nError in reading or end of file.\n"); +} diff --git a/tools/kconfig/confdata.c b/tools/kconfig/confdata.c new file mode 100644 index 000000000..dd243d2ab --- /dev/null +++ b/tools/kconfig/confdata.c @@ -0,0 +1,1247 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "lkc.h" + +struct conf_printer { + void (*print_symbol)(FILE *, struct symbol *, const char *, void *); + void (*print_comment)(FILE *, const char *, void *); +}; + +static void conf_warning(const char *fmt, ...) + __attribute__ ((format (printf, 1, 2))); + +static void conf_message(const char *fmt, ...) + __attribute__ ((format (printf, 1, 2))); + +static const char *conf_filename; +static int conf_lineno, conf_warnings, conf_unsaved; + +const char conf_defname[] = "arch/$ARCH/defconfig"; + +static void conf_warning(const char *fmt, ...) +{ + va_list ap; + va_start(ap, fmt); + fprintf(stderr, "%s:%d:warning: ", conf_filename, conf_lineno); + vfprintf(stderr, fmt, ap); + fprintf(stderr, "\n"); + va_end(ap); + conf_warnings++; +} + +static void conf_default_message_callback(const char *fmt, va_list ap) +{ + printf("#\n# "); + vprintf(fmt, ap); + printf("\n#\n"); +} + +static void (*conf_message_callback) (const char *fmt, va_list ap) = + conf_default_message_callback; +void conf_set_message_callback(void (*fn) (const char *fmt, va_list ap)) +{ + conf_message_callback = fn; +} + +static void conf_message(const char *fmt, ...) +{ + va_list ap; + + va_start(ap, fmt); + if (conf_message_callback) + conf_message_callback(fmt, ap); + va_end(ap); +} + +const char *conf_get_configname(void) +{ + char *name = getenv("KCONFIG_CONFIG"); + + return name ? name : ".config"; +} + +const char *conf_get_autoconfig_name(void) +{ + char *name = getenv("KCONFIG_AUTOCONFIG"); + + return name ? name : "include/config/auto.conf"; +} + +static char *conf_expand_value(const char *in) +{ + struct symbol *sym; + const char *src; + static char res_value[SYMBOL_MAXLENGTH]; + char *dst, name[SYMBOL_MAXLENGTH]; + + res_value[0] = 0; + dst = name; + while ((src = strchr(in, '$'))) { + strncat(res_value, in, src - in); + src++; + dst = name; + while (isalnum(*src) || *src == '_') + *dst++ = *src++; + *dst = 0; + sym = sym_lookup(name, 0); + sym_calc_value(sym); + strcat(res_value, sym_get_string_value(sym)); + in = src; + } + strcat(res_value, in); + + return res_value; +} + +char *conf_get_default_confname(void) +{ + struct stat buf; + static char fullname[PATH_MAX+1]; + char *env, *name; + + name = conf_expand_value(conf_defname); + env = getenv(SRCTREE); + if (env) { + sprintf(fullname, "%s/%s", env, name); + if (!stat(fullname, &buf)) + return fullname; + } + return name; +} + +static int conf_set_sym_val(struct symbol *sym, int def, int def_flags, char *p) +{ + char *p2; + + switch (sym->type) { + case S_TRISTATE: + if (p[0] == 'm') { + sym->def[def].tri = mod; + sym->flags |= def_flags; + break; + } + /* fall through */ + case S_BOOLEAN: + if (p[0] == 'y') { + sym->def[def].tri = yes; + sym->flags |= def_flags; + break; + } + if (p[0] == 'n') { + sym->def[def].tri = no; + sym->flags |= def_flags; + break; + } + if (def != S_DEF_AUTO) + conf_warning("symbol value '%s' invalid for %s", + p, sym->name); + return 1; + case S_OTHER: + if (*p != '"') { + for (p2 = p; *p2 && !isspace(*p2); p2++) + ; + sym->type = S_STRING; + goto done; + } + /* fall through */ + case S_STRING: + if (*p++ != '"') + break; + for (p2 = p; (p2 = strpbrk(p2, "\"\\")); p2++) { + if (*p2 == '"') { + *p2 = 0; + break; + } + memmove(p2, p2 + 1, strlen(p2)); + } + if (!p2) { + if (def != S_DEF_AUTO) + conf_warning("invalid string found"); + return 1; + } + /* fall through */ + case S_INT: + case S_HEX: + done: + if (sym_string_valid(sym, p)) { + sym->def[def].val = strdup(p); + sym->flags |= def_flags; + } else { + if (def != S_DEF_AUTO) + conf_warning("symbol value '%s' invalid for %s", + p, sym->name); + return 1; + } + break; + default: + ; + } + return 0; +} + +#define LINE_GROWTH 16 +static int add_byte(int c, char **lineptr, size_t slen, size_t *n) +{ + char *nline; + size_t new_size = slen + 1; + if (new_size > *n) { + new_size += LINE_GROWTH - 1; + new_size *= 2; + nline = realloc(*lineptr, new_size); + if (!nline) + return -1; + + *lineptr = nline; + *n = new_size; + } + + (*lineptr)[slen] = c; + + return 0; +} + +static ssize_t compat_getline(char **lineptr, size_t *n, FILE *stream) +{ + char *line = *lineptr; + size_t slen = 0; + + for (;;) { + int c = getc(stream); + + switch (c) { + case '\n': + if (add_byte(c, &line, slen, n) < 0) + goto e_out; + slen++; + /* fall through */ + case EOF: + if (add_byte('\0', &line, slen, n) < 0) + goto e_out; + *lineptr = line; + if (slen == 0) + return -1; + return slen; + default: + if (add_byte(c, &line, slen, n) < 0) + goto e_out; + slen++; + } + } + +e_out: + line[slen-1] = '\0'; + *lineptr = line; + return -1; +} + +int conf_read_simple(const char *name, int def) +{ + FILE *in = NULL; + char *line = NULL; + size_t line_asize = 0; + char *p, *p2; + struct symbol *sym; + int i, def_flags; + + if (name) { + in = zconf_fopen(name); + } else { + struct property *prop; + + name = conf_get_configname(); + in = zconf_fopen(name); + if (in) + goto load; + sym_add_change_count(1); + if (!sym_defconfig_list) + return 1; + + for_all_defaults(sym_defconfig_list, prop) { + if (expr_calc_value(prop->visible.expr) == no || + prop->expr->type != E_SYMBOL) + continue; + name = conf_expand_value(prop->expr->left.sym->name); + in = zconf_fopen(name); + if (in) { + conf_message(_("using defaults found in %s"), + name); + goto load; + } + } + } + if (!in) + return 1; + +load: + conf_filename = name; + conf_lineno = 0; + conf_warnings = 0; + conf_unsaved = 0; + + def_flags = SYMBOL_DEF << def; + for_all_symbols(i, sym) { + sym->flags |= SYMBOL_CHANGED; + sym->flags &= ~(def_flags|SYMBOL_VALID); + if (sym_is_choice(sym)) + sym->flags |= def_flags; + switch (sym->type) { + case S_INT: + case S_HEX: + case S_STRING: + if (sym->def[def].val) + free(sym->def[def].val); + /* fall through */ + default: + sym->def[def].val = NULL; + sym->def[def].tri = no; + } + } + + while (compat_getline(&line, &line_asize, in) != -1) { + conf_lineno++; + sym = NULL; + if (line[0] == '#') { + if (memcmp(line + 2, CONFIG_, strlen(CONFIG_))) + continue; + p = strchr(line + 2 + strlen(CONFIG_), ' '); + if (!p) + continue; + *p++ = 0; + if (strncmp(p, "is not set", 10)) + continue; + if (def == S_DEF_USER) { + sym = sym_find(line + 2 + strlen(CONFIG_)); + if (!sym) { + sym_add_change_count(1); + goto setsym; + } + } else { + sym = sym_lookup(line + 2 + strlen(CONFIG_), 0); + if (sym->type == S_UNKNOWN) + sym->type = S_BOOLEAN; + } + if (sym->flags & def_flags) { + conf_warning("override: reassigning to symbol %s", sym->name); + } + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + sym->def[def].tri = no; + sym->flags |= def_flags; + break; + default: + ; + } + } else if (memcmp(line, CONFIG_, strlen(CONFIG_)) == 0) { + p = strchr(line + strlen(CONFIG_), '='); + if (!p) + continue; + *p++ = 0; + p2 = strchr(p, '\n'); + if (p2) { + *p2-- = 0; + if (*p2 == '\r') + *p2 = 0; + } + if (def == S_DEF_USER) { + sym = sym_find(line + strlen(CONFIG_)); + if (!sym) { + sym_add_change_count(1); + goto setsym; + } + } else { + sym = sym_lookup(line + strlen(CONFIG_), 0); + if (sym->type == S_UNKNOWN) + sym->type = S_OTHER; + } + if (sym->flags & def_flags) { + conf_warning("override: reassigning to symbol %s", sym->name); + } + if (conf_set_sym_val(sym, def, def_flags, p)) + continue; + } else { + if (line[0] != '\r' && line[0] != '\n') + conf_warning("unexpected data"); + continue; + } +setsym: + if (sym && sym_is_choice_value(sym)) { + struct symbol *cs = prop_get_symbol(sym_get_choice_prop(sym)); + switch (sym->def[def].tri) { + case no: + break; + case mod: + if (cs->def[def].tri == yes) { + conf_warning("%s creates inconsistent choice state", sym->name); + cs->flags &= ~def_flags; + } + break; + case yes: + if (cs->def[def].tri != no) + conf_warning("override: %s changes choice state", sym->name); + cs->def[def].val = sym; + break; + } + cs->def[def].tri = EXPR_OR(cs->def[def].tri, sym->def[def].tri); + } + } + free(line); + fclose(in); + return 0; +} + +int conf_read(const char *name) +{ + struct symbol *sym; + int i; + + sym_set_change_count(0); + + if (conf_read_simple(name, S_DEF_USER)) { + sym_calc_value(modules_sym); + return 1; + } + + sym_calc_value(modules_sym); + + for_all_symbols(i, sym) { + sym_calc_value(sym); + if (sym_is_choice(sym) || (sym->flags & SYMBOL_AUTO)) + continue; + if (sym_has_value(sym) && (sym->flags & SYMBOL_WRITE)) { + /* check that calculated value agrees with saved value */ + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + if (sym->def[S_DEF_USER].tri != sym_get_tristate_value(sym)) + break; + if (!sym_is_choice(sym)) + continue; + /* fall through */ + default: + if (!strcmp(sym->curr.val, sym->def[S_DEF_USER].val)) + continue; + break; + } + } else if (!sym_has_value(sym) && !(sym->flags & SYMBOL_WRITE)) + /* no previous value and not saved */ + continue; + conf_unsaved++; + /* maybe print value in verbose mode... */ + } + + for_all_symbols(i, sym) { + if (sym_has_value(sym) && !sym_is_choice_value(sym)) { + /* Reset values of generates values, so they'll appear + * as new, if they should become visible, but that + * doesn't quite work if the Kconfig and the saved + * configuration disagree. + */ + if (sym->visible == no && !conf_unsaved) + sym->flags &= ~SYMBOL_DEF_USER; + switch (sym->type) { + case S_STRING: + case S_INT: + case S_HEX: + /* Reset a string value if it's out of range */ + if (sym_string_within_range(sym, sym->def[S_DEF_USER].val)) + break; + sym->flags &= ~(SYMBOL_VALID|SYMBOL_DEF_USER); + conf_unsaved++; + break; + default: + break; + } + } + } + + sym_add_change_count(conf_warnings || conf_unsaved); + + return 0; +} + +/* + * Kconfig configuration printer + * + * This printer is used when generating the resulting configuration after + * kconfig invocation and `defconfig' files. Unset symbol might be omitted by + * passing a non-NULL argument to the printer. + * + */ +static void +kconfig_print_symbol(FILE *fp, struct symbol *sym, const char *value, void *arg) +{ + + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + if (*value == 'n') { + bool skip_unset = (arg != NULL); + + if (!skip_unset) + fprintf(fp, "# %s%s is not set\n", + CONFIG_, sym->name); + return; + } + break; + default: + break; + } + + fprintf(fp, "%s%s=%s\n", CONFIG_, sym->name, value); +} + +static void +kconfig_print_comment(FILE *fp, const char *value, void *arg) +{ + const char *p = value; + size_t l; + + for (;;) { + l = strcspn(p, "\n"); + fprintf(fp, "#"); + if (l) { + fprintf(fp, " "); + xfwrite(p, l, 1, fp); + p += l; + } + fprintf(fp, "\n"); + if (*p++ == '\0') + break; + } +} + +static struct conf_printer kconfig_printer_cb = +{ + .print_symbol = kconfig_print_symbol, + .print_comment = kconfig_print_comment, +}; + +/* + * Header printer + * + * This printer is used when generating the `include/generated/autoconf.h' file. + */ +static void +header_print_symbol(FILE *fp, struct symbol *sym, const char *value, void *arg) +{ + + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: { + const char *suffix = ""; + + switch (*value) { + case 'n': + break; + case 'm': + suffix = "_MODULE"; + /* fall through */ + default: + fprintf(fp, "#define %s%s%s 1\n", + CONFIG_, sym->name, suffix); + } + break; + } + case S_HEX: { + const char *prefix = ""; + + if (value[0] != '0' || (value[1] != 'x' && value[1] != 'X')) + prefix = "0x"; + fprintf(fp, "#define %s%s %s%s\n", + CONFIG_, sym->name, prefix, value); + break; + } + case S_STRING: + case S_INT: + fprintf(fp, "#define %s%s %s\n", + CONFIG_, sym->name, value); + break; + default: + break; + } + +} + +static void +header_print_comment(FILE *fp, const char *value, void *arg) +{ + const char *p = value; + size_t l; + + fprintf(fp, "/*\n"); + for (;;) { + l = strcspn(p, "\n"); + fprintf(fp, " *"); + if (l) { + fprintf(fp, " "); + xfwrite(p, l, 1, fp); + p += l; + } + fprintf(fp, "\n"); + if (*p++ == '\0') + break; + } + fprintf(fp, " */\n"); +} + +static struct conf_printer header_printer_cb = +{ + .print_symbol = header_print_symbol, + .print_comment = header_print_comment, +}; + +/* + * Tristate printer + * + * This printer is used when generating the `include/config/tristate.conf' file. + */ +static void +tristate_print_symbol(FILE *fp, struct symbol *sym, const char *value, void *arg) +{ + + if (sym->type == S_TRISTATE && *value != 'n') + fprintf(fp, "%s%s=%c\n", CONFIG_, sym->name, (char)toupper(*value)); +} + +static struct conf_printer tristate_printer_cb = +{ + .print_symbol = tristate_print_symbol, + .print_comment = kconfig_print_comment, +}; + +static void conf_write_symbol(FILE *fp, struct symbol *sym, + struct conf_printer *printer, void *printer_arg) +{ + const char *str; + + switch (sym->type) { + case S_OTHER: + case S_UNKNOWN: + break; + case S_STRING: + str = sym_get_string_value(sym); + str = sym_escape_string_value(str); + printer->print_symbol(fp, sym, str, printer_arg); + free((void *)str); + break; + default: + str = sym_get_string_value(sym); + printer->print_symbol(fp, sym, str, printer_arg); + } +} + +static void +conf_write_heading(FILE *fp, struct conf_printer *printer, void *printer_arg) +{ + char buf[256]; + + snprintf(buf, sizeof(buf), + "\n" + "Automatically generated file; DO NOT EDIT.\n" + "%s\n", + rootmenu.prompt->text); + + printer->print_comment(fp, buf, printer_arg); +} + +/* + * Write out a minimal config. + * All values that has default values are skipped as this is redundant. + */ +int conf_write_defconfig(const char *filename) +{ + struct symbol *sym; + struct menu *menu; + FILE *out; + + out = fopen(filename, "w"); + if (!out) + return 1; + + sym_clear_all_valid(); + + /* Traverse all menus to find all relevant symbols */ + menu = rootmenu.list; + + while (menu != NULL) + { + sym = menu->sym; + if (sym == NULL) { + if (!menu_is_visible(menu)) + goto next_menu; + } else if (!sym_is_choice(sym)) { + sym_calc_value(sym); + if (!(sym->flags & SYMBOL_WRITE)) + goto next_menu; + sym->flags &= ~SYMBOL_WRITE; + /* If we cannot change the symbol - skip */ + if (!sym_is_changable(sym)) + goto next_menu; + /* If symbol equals to default value - skip */ + if (strcmp(sym_get_string_value(sym), sym_get_string_default(sym)) == 0) + goto next_menu; + + /* + * If symbol is a choice value and equals to the + * default for a choice - skip. + * But only if value is bool and equal to "y" and + * choice is not "optional". + * (If choice is "optional" then all values can be "n") + */ + if (sym_is_choice_value(sym)) { + struct symbol *cs; + struct symbol *ds; + + cs = prop_get_symbol(sym_get_choice_prop(sym)); + ds = sym_choice_default(cs); + if (!sym_is_optional(cs) && sym == ds) { + if ((sym->type == S_BOOLEAN) && + sym_get_tristate_value(sym) == yes) + goto next_menu; + } + } + conf_write_symbol(out, sym, &kconfig_printer_cb, NULL); + } +next_menu: + if (menu->list != NULL) { + menu = menu->list; + } + else if (menu->next != NULL) { + menu = menu->next; + } else { + while ((menu = menu->parent)) { + if (menu->next != NULL) { + menu = menu->next; + break; + } + } + } + } + fclose(out); + return 0; +} + +int conf_write(const char *name) +{ + FILE *out; + struct symbol *sym; + struct menu *menu; + const char *basename; + const char *str; + char dirname[PATH_MAX+1], tmpname[PATH_MAX+1], newname[PATH_MAX+1]; + char *env; + + dirname[0] = 0; + if (name && name[0]) { + struct stat st; + char *slash; + + if (!stat(name, &st) && S_ISDIR(st.st_mode)) { + strcpy(dirname, name); + strcat(dirname, "/"); + basename = conf_get_configname(); + } else if ((slash = strrchr(name, '/'))) { + int size = slash - name + 1; + memcpy(dirname, name, size); + dirname[size] = 0; + if (slash[1]) + basename = slash + 1; + else + basename = conf_get_configname(); + } else + basename = name; + } else + basename = conf_get_configname(); + + sprintf(newname, "%s%s", dirname, basename); + env = getenv("KCONFIG_OVERWRITECONFIG"); + if (!env || !*env) { + sprintf(tmpname, "%s.tmpconfig.%d", dirname, (int)getpid()); + out = fopen(tmpname, "w"); + } else { + *tmpname = 0; + out = fopen(newname, "w"); + } + if (!out) + return 1; + + conf_write_heading(out, &kconfig_printer_cb, NULL); + + if (!conf_get_changed()) + sym_clear_all_valid(); + + menu = rootmenu.list; + while (menu) { + sym = menu->sym; + if (!sym) { + if (!menu_is_visible(menu)) + goto next; + str = menu_get_prompt(menu); + fprintf(out, "\n" + "#\n" + "# %s\n" + "#\n", str); + } else if (!(sym->flags & SYMBOL_CHOICE)) { + sym_calc_value(sym); + if (!(sym->flags & SYMBOL_WRITE)) + goto next; + sym->flags &= ~SYMBOL_WRITE; + + conf_write_symbol(out, sym, &kconfig_printer_cb, NULL); + } + +next: + if (menu->list) { + menu = menu->list; + continue; + } + if (menu->next) + menu = menu->next; + else while ((menu = menu->parent)) { + if (menu->next) { + menu = menu->next; + break; + } + } + } + fclose(out); + + if (*tmpname) { + strcat(dirname, basename); + strcat(dirname, ".old"); + rename(newname, dirname); + if (rename(tmpname, newname)) + return 1; + } + + conf_message(_("configuration written to %s"), newname); + + sym_set_change_count(0); + + return 0; +} + +static int conf_split_config(void) +{ + const char *name; + char path[PATH_MAX+1]; + char *s, *d, c; + struct symbol *sym; + struct stat sb; + int res, i, fd; + + name = conf_get_autoconfig_name(); + conf_read_simple(name, S_DEF_AUTO); + sym_calc_value(modules_sym); + + if (chdir("include/config")) + return 1; + + res = 0; + for_all_symbols(i, sym) { + sym_calc_value(sym); + if ((sym->flags & SYMBOL_AUTO) || !sym->name) + continue; + if (sym->flags & SYMBOL_WRITE) { + if (sym->flags & SYMBOL_DEF_AUTO) { + /* + * symbol has old and new value, + * so compare them... + */ + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + if (sym_get_tristate_value(sym) == + sym->def[S_DEF_AUTO].tri) + continue; + break; + case S_STRING: + case S_HEX: + case S_INT: + if (!strcmp(sym_get_string_value(sym), + sym->def[S_DEF_AUTO].val)) + continue; + break; + default: + break; + } + } else { + /* + * If there is no old value, only 'no' (unset) + * is allowed as new value. + */ + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + if (sym_get_tristate_value(sym) == no) + continue; + break; + default: + break; + } + } + } else if (!(sym->flags & SYMBOL_DEF_AUTO)) + /* There is neither an old nor a new value. */ + continue; + /* else + * There is an old value, but no new value ('no' (unset) + * isn't saved in auto.conf, so the old value is always + * different from 'no'). + */ + + /* Replace all '_' and append ".h" */ + s = sym->name; + d = path; + while ((c = *s++)) { + c = tolower(c); + *d++ = (c == '_') ? '/' : c; + } + strcpy(d, ".h"); + + /* Assume directory path already exists. */ + fd = open(path, O_WRONLY | O_CREAT | O_TRUNC, 0644); + if (fd == -1) { + if (errno != ENOENT) { + res = 1; + break; + } + /* + * Create directory components, + * unless they exist already. + */ + d = path; + while ((d = strchr(d, '/'))) { + *d = 0; + if (stat(path, &sb) && mkdir(path, 0755)) { + res = 1; + goto out; + } + *d++ = '/'; + } + /* Try it again. */ + fd = open(path, O_WRONLY | O_CREAT | O_TRUNC, 0644); + if (fd == -1) { + res = 1; + break; + } + } + close(fd); + } +out: + if (chdir("../..")) + return 1; + + return res; +} + +int conf_write_autoconf(void) +{ + struct symbol *sym; + const char *name; + FILE *out, *tristate, *out_h; + int i; + + sym_clear_all_valid(); + + file_write_dep("include/config/auto.conf.cmd"); + + if (conf_split_config()) + return 1; + + out = fopen(".tmpconfig", "w"); + if (!out) + return 1; + + tristate = fopen(".tmpconfig_tristate", "w"); + if (!tristate) { + fclose(out); + return 1; + } + + out_h = fopen(".tmpconfig.h", "w"); + if (!out_h) { + fclose(out); + fclose(tristate); + return 1; + } + + conf_write_heading(out, &kconfig_printer_cb, NULL); + + conf_write_heading(tristate, &tristate_printer_cb, NULL); + + conf_write_heading(out_h, &header_printer_cb, NULL); + + for_all_symbols(i, sym) { + sym_calc_value(sym); + if (!(sym->flags & SYMBOL_WRITE) || !sym->name) + continue; + + /* write symbol to auto.conf, tristate and header files */ + conf_write_symbol(out, sym, &kconfig_printer_cb, (void *)1); + + conf_write_symbol(tristate, sym, &tristate_printer_cb, (void *)1); + + conf_write_symbol(out_h, sym, &header_printer_cb, NULL); + } + fclose(out); + fclose(tristate); + fclose(out_h); + + name = getenv("KCONFIG_AUTOHEADER"); + if (!name) + name = "include/generated/autoconf.h"; + if (rename(".tmpconfig.h", name)) + return 1; + name = getenv("KCONFIG_TRISTATE"); + if (!name) + name = "include/config/tristate.conf"; + if (rename(".tmpconfig_tristate", name)) + return 1; + name = conf_get_autoconfig_name(); + /* + * This must be the last step, kbuild has a dependency on auto.conf + * and this marks the successful completion of the previous steps. + */ + if (rename(".tmpconfig", name)) + return 1; + + return 0; +} + +static int sym_change_count; +static void (*conf_changed_callback)(void); + +void sym_set_change_count(int count) +{ + int _sym_change_count = sym_change_count; + sym_change_count = count; + if (conf_changed_callback && + (bool)_sym_change_count != (bool)count) + conf_changed_callback(); +} + +void sym_add_change_count(int count) +{ + sym_set_change_count(count + sym_change_count); +} + +bool conf_get_changed(void) +{ + return sym_change_count; +} + +void conf_set_changed_callback(void (*fn)(void)) +{ + conf_changed_callback = fn; +} + +static bool randomize_choice_values(struct symbol *csym) +{ + struct property *prop; + struct symbol *sym; + struct expr *e; + int cnt, def; + + /* + * If choice is mod then we may have more items selected + * and if no then no-one. + * In both cases stop. + */ + if (csym->curr.tri != yes) + return false; + + prop = sym_get_choice_prop(csym); + + /* count entries in choice block */ + cnt = 0; + expr_list_for_each_sym(prop->expr, e, sym) + cnt++; + + /* + * find a random value and set it to yes, + * set the rest to no so we have only one set + */ + def = (rand() % cnt); + + cnt = 0; + expr_list_for_each_sym(prop->expr, e, sym) { + if (def == cnt++) { + sym->def[S_DEF_USER].tri = yes; + csym->def[S_DEF_USER].val = sym; + } + else { + sym->def[S_DEF_USER].tri = no; + } + sym->flags |= SYMBOL_DEF_USER; + /* clear VALID to get value calculated */ + sym->flags &= ~SYMBOL_VALID; + } + csym->flags |= SYMBOL_DEF_USER; + /* clear VALID to get value calculated */ + csym->flags &= ~(SYMBOL_VALID); + + return true; +} + +void set_all_choice_values(struct symbol *csym) +{ + struct property *prop; + struct symbol *sym; + struct expr *e; + + prop = sym_get_choice_prop(csym); + + /* + * Set all non-assinged choice values to no + */ + expr_list_for_each_sym(prop->expr, e, sym) { + if (!sym_has_value(sym)) + sym->def[S_DEF_USER].tri = no; + } + csym->flags |= SYMBOL_DEF_USER; + /* clear VALID to get value calculated */ + csym->flags &= ~(SYMBOL_VALID | SYMBOL_NEED_SET_CHOICE_VALUES); +} + +bool conf_set_all_new_symbols(enum conf_def_mode mode) +{ + struct symbol *sym, *csym; + int i, cnt, pby, pty, ptm; /* pby: probability of boolean = y + * pty: probability of tristate = y + * ptm: probability of tristate = m + */ + + pby = 50; pty = ptm = 33; /* can't go as the default in switch-case + * below, otherwise gcc whines about + * -Wmaybe-uninitialized */ + if (mode == def_random) { + int n, p[3]; + char *env = getenv("KCONFIG_PROBABILITY"); + n = 0; + while( env && *env ) { + char *endp; + int tmp = strtol( env, &endp, 10 ); + if( tmp >= 0 && tmp <= 100 ) { + p[n++] = tmp; + } else { + errno = ERANGE; + perror( "KCONFIG_PROBABILITY" ); + exit( 1 ); + } + env = (*endp == ':') ? endp+1 : endp; + if( n >=3 ) { + break; + } + } + switch( n ) { + case 1: + pby = p[0]; ptm = pby/2; pty = pby-ptm; + break; + case 2: + pty = p[0]; ptm = p[1]; pby = pty + ptm; + break; + case 3: + pby = p[0]; pty = p[1]; ptm = p[2]; + break; + } + + if( pty+ptm > 100 ) { + errno = ERANGE; + perror( "KCONFIG_PROBABILITY" ); + exit( 1 ); + } + } + bool has_changed = false; + + for_all_symbols(i, sym) { + if (sym_has_value(sym) || (sym->flags & SYMBOL_VALID)) + continue; + switch (sym_get_type(sym)) { + case S_BOOLEAN: + case S_TRISTATE: + has_changed = true; + switch (mode) { + case def_yes: + sym->def[S_DEF_USER].tri = yes; + break; + case def_mod: + sym->def[S_DEF_USER].tri = mod; + break; + case def_no: + if (sym->flags & SYMBOL_ALLNOCONFIG_Y) + sym->def[S_DEF_USER].tri = yes; + else + sym->def[S_DEF_USER].tri = no; + break; + case def_random: + sym->def[S_DEF_USER].tri = no; + cnt = rand() % 100; + if (sym->type == S_TRISTATE) { + if (cnt < pty) + sym->def[S_DEF_USER].tri = yes; + else if (cnt < (pty+ptm)) + sym->def[S_DEF_USER].tri = mod; + } else if (cnt < pby) + sym->def[S_DEF_USER].tri = yes; + break; + default: + continue; + } + if (!(sym_is_choice(sym) && mode == def_random)) + sym->flags |= SYMBOL_DEF_USER; + break; + default: + break; + } + + } + + sym_clear_all_valid(); + + /* + * We have different type of choice blocks. + * If curr.tri equals to mod then we can select several + * choice symbols in one block. + * In this case we do nothing. + * If curr.tri equals yes then only one symbol can be + * selected in a choice block and we set it to yes, + * and the rest to no. + */ + if (mode != def_random) { + for_all_symbols(i, csym) { + if ((sym_is_choice(csym) && !sym_has_value(csym)) || + sym_is_choice_value(csym)) + csym->flags |= SYMBOL_NEED_SET_CHOICE_VALUES; + } + } + + for_all_symbols(i, csym) { + if (sym_has_value(csym) || !sym_is_choice(csym)) + continue; + + sym_calc_value(csym); + if (mode == def_random) + has_changed = randomize_choice_values(csym); + else { + set_all_choice_values(csym); + has_changed = true; + } + } + + return has_changed; +} diff --git a/tools/kconfig/expr.c b/tools/kconfig/expr.c new file mode 100644 index 000000000..cbf4996dd --- /dev/null +++ b/tools/kconfig/expr.c @@ -0,0 +1,1206 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include + +#include "lkc.h" + +#define DEBUG_EXPR 0 + +static int expr_eq(struct expr *e1, struct expr *e2); +static struct expr *expr_eliminate_yn(struct expr *e); + +struct expr *expr_alloc_symbol(struct symbol *sym) +{ + struct expr *e = xcalloc(1, sizeof(*e)); + e->type = E_SYMBOL; + e->left.sym = sym; + return e; +} + +struct expr *expr_alloc_one(enum expr_type type, struct expr *ce) +{ + struct expr *e = xcalloc(1, sizeof(*e)); + e->type = type; + e->left.expr = ce; + return e; +} + +struct expr *expr_alloc_two(enum expr_type type, struct expr *e1, struct expr *e2) +{ + struct expr *e = xcalloc(1, sizeof(*e)); + e->type = type; + e->left.expr = e1; + e->right.expr = e2; + return e; +} + +struct expr *expr_alloc_comp(enum expr_type type, struct symbol *s1, struct symbol *s2) +{ + struct expr *e = xcalloc(1, sizeof(*e)); + e->type = type; + e->left.sym = s1; + e->right.sym = s2; + return e; +} + +struct expr *expr_alloc_and(struct expr *e1, struct expr *e2) +{ + if (!e1) + return e2; + return e2 ? expr_alloc_two(E_AND, e1, e2) : e1; +} + +struct expr *expr_alloc_or(struct expr *e1, struct expr *e2) +{ + if (!e1) + return e2; + return e2 ? expr_alloc_two(E_OR, e1, e2) : e1; +} + +struct expr *expr_copy(const struct expr *org) +{ + struct expr *e; + + if (!org) + return NULL; + + e = xmalloc(sizeof(*org)); + memcpy(e, org, sizeof(*org)); + switch (org->type) { + case E_SYMBOL: + e->left = org->left; + break; + case E_NOT: + e->left.expr = expr_copy(org->left.expr); + break; + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + e->left.sym = org->left.sym; + e->right.sym = org->right.sym; + break; + case E_AND: + case E_OR: + case E_LIST: + e->left.expr = expr_copy(org->left.expr); + e->right.expr = expr_copy(org->right.expr); + break; + default: + printf("can't copy type %d\n", e->type); + free(e); + e = NULL; + break; + } + + return e; +} + +void expr_free(struct expr *e) +{ + if (!e) + return; + + switch (e->type) { + case E_SYMBOL: + break; + case E_NOT: + expr_free(e->left.expr); + return; + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + break; + case E_OR: + case E_AND: + expr_free(e->left.expr); + expr_free(e->right.expr); + break; + default: + printf("how to free type %d?\n", e->type); + break; + } + free(e); +} + +static int trans_count; + +#define e1 (*ep1) +#define e2 (*ep2) + +static void __expr_eliminate_eq(enum expr_type type, struct expr **ep1, struct expr **ep2) +{ + if (e1->type == type) { + __expr_eliminate_eq(type, &e1->left.expr, &e2); + __expr_eliminate_eq(type, &e1->right.expr, &e2); + return; + } + if (e2->type == type) { + __expr_eliminate_eq(type, &e1, &e2->left.expr); + __expr_eliminate_eq(type, &e1, &e2->right.expr); + return; + } + if (e1->type == E_SYMBOL && e2->type == E_SYMBOL && + e1->left.sym == e2->left.sym && + (e1->left.sym == &symbol_yes || e1->left.sym == &symbol_no)) + return; + if (!expr_eq(e1, e2)) + return; + trans_count++; + expr_free(e1); expr_free(e2); + switch (type) { + case E_OR: + e1 = expr_alloc_symbol(&symbol_no); + e2 = expr_alloc_symbol(&symbol_no); + break; + case E_AND: + e1 = expr_alloc_symbol(&symbol_yes); + e2 = expr_alloc_symbol(&symbol_yes); + break; + default: + ; + } +} + +void expr_eliminate_eq(struct expr **ep1, struct expr **ep2) +{ + if (!e1 || !e2) + return; + switch (e1->type) { + case E_OR: + case E_AND: + __expr_eliminate_eq(e1->type, ep1, ep2); + default: + ; + } + if (e1->type != e2->type) switch (e2->type) { + case E_OR: + case E_AND: + __expr_eliminate_eq(e2->type, ep1, ep2); + default: + ; + } + e1 = expr_eliminate_yn(e1); + e2 = expr_eliminate_yn(e2); +} + +#undef e1 +#undef e2 + +static int expr_eq(struct expr *e1, struct expr *e2) +{ + int res, old_count; + + if (e1->type != e2->type) + return 0; + switch (e1->type) { + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + return e1->left.sym == e2->left.sym && e1->right.sym == e2->right.sym; + case E_SYMBOL: + return e1->left.sym == e2->left.sym; + case E_NOT: + return expr_eq(e1->left.expr, e2->left.expr); + case E_AND: + case E_OR: + e1 = expr_copy(e1); + e2 = expr_copy(e2); + old_count = trans_count; + expr_eliminate_eq(&e1, &e2); + res = (e1->type == E_SYMBOL && e2->type == E_SYMBOL && + e1->left.sym == e2->left.sym); + expr_free(e1); + expr_free(e2); + trans_count = old_count; + return res; + case E_LIST: + case E_RANGE: + case E_NONE: + /* panic */; + } + + if (DEBUG_EXPR) { + expr_fprint(e1, stdout); + printf(" = "); + expr_fprint(e2, stdout); + printf(" ?\n"); + } + + return 0; +} + +static struct expr *expr_eliminate_yn(struct expr *e) +{ + struct expr *tmp; + + if (e) switch (e->type) { + case E_AND: + e->left.expr = expr_eliminate_yn(e->left.expr); + e->right.expr = expr_eliminate_yn(e->right.expr); + if (e->left.expr->type == E_SYMBOL) { + if (e->left.expr->left.sym == &symbol_no) { + expr_free(e->left.expr); + expr_free(e->right.expr); + e->type = E_SYMBOL; + e->left.sym = &symbol_no; + e->right.expr = NULL; + return e; + } else if (e->left.expr->left.sym == &symbol_yes) { + free(e->left.expr); + tmp = e->right.expr; + *e = *(e->right.expr); + free(tmp); + return e; + } + } + if (e->right.expr->type == E_SYMBOL) { + if (e->right.expr->left.sym == &symbol_no) { + expr_free(e->left.expr); + expr_free(e->right.expr); + e->type = E_SYMBOL; + e->left.sym = &symbol_no; + e->right.expr = NULL; + return e; + } else if (e->right.expr->left.sym == &symbol_yes) { + free(e->right.expr); + tmp = e->left.expr; + *e = *(e->left.expr); + free(tmp); + return e; + } + } + break; + case E_OR: + e->left.expr = expr_eliminate_yn(e->left.expr); + e->right.expr = expr_eliminate_yn(e->right.expr); + if (e->left.expr->type == E_SYMBOL) { + if (e->left.expr->left.sym == &symbol_no) { + free(e->left.expr); + tmp = e->right.expr; + *e = *(e->right.expr); + free(tmp); + return e; + } else if (e->left.expr->left.sym == &symbol_yes) { + expr_free(e->left.expr); + expr_free(e->right.expr); + e->type = E_SYMBOL; + e->left.sym = &symbol_yes; + e->right.expr = NULL; + return e; + } + } + if (e->right.expr->type == E_SYMBOL) { + if (e->right.expr->left.sym == &symbol_no) { + free(e->right.expr); + tmp = e->left.expr; + *e = *(e->left.expr); + free(tmp); + return e; + } else if (e->right.expr->left.sym == &symbol_yes) { + expr_free(e->left.expr); + expr_free(e->right.expr); + e->type = E_SYMBOL; + e->left.sym = &symbol_yes; + e->right.expr = NULL; + return e; + } + } + break; + default: + ; + } + return e; +} + +/* + * bool FOO!=n => FOO + */ +struct expr *expr_trans_bool(struct expr *e) +{ + if (!e) + return NULL; + switch (e->type) { + case E_AND: + case E_OR: + case E_NOT: + e->left.expr = expr_trans_bool(e->left.expr); + e->right.expr = expr_trans_bool(e->right.expr); + break; + case E_UNEQUAL: + // FOO!=n -> FOO + if (e->left.sym->type == S_TRISTATE) { + if (e->right.sym == &symbol_no) { + e->type = E_SYMBOL; + e->right.sym = NULL; + } + } + break; + default: + ; + } + return e; +} + +/* + * e1 || e2 -> ? + */ +static struct expr *expr_join_or(struct expr *e1, struct expr *e2) +{ + struct expr *tmp; + struct symbol *sym1, *sym2; + + if (expr_eq(e1, e2)) + return expr_copy(e1); + if (e1->type != E_EQUAL && e1->type != E_UNEQUAL && e1->type != E_SYMBOL && e1->type != E_NOT) + return NULL; + if (e2->type != E_EQUAL && e2->type != E_UNEQUAL && e2->type != E_SYMBOL && e2->type != E_NOT) + return NULL; + if (e1->type == E_NOT) { + tmp = e1->left.expr; + if (tmp->type != E_EQUAL && tmp->type != E_UNEQUAL && tmp->type != E_SYMBOL) + return NULL; + sym1 = tmp->left.sym; + } else + sym1 = e1->left.sym; + if (e2->type == E_NOT) { + if (e2->left.expr->type != E_SYMBOL) + return NULL; + sym2 = e2->left.expr->left.sym; + } else + sym2 = e2->left.sym; + if (sym1 != sym2) + return NULL; + if (sym1->type != S_BOOLEAN && sym1->type != S_TRISTATE) + return NULL; + if (sym1->type == S_TRISTATE) { + if (e1->type == E_EQUAL && e2->type == E_EQUAL && + ((e1->right.sym == &symbol_yes && e2->right.sym == &symbol_mod) || + (e1->right.sym == &symbol_mod && e2->right.sym == &symbol_yes))) { + // (a='y') || (a='m') -> (a!='n') + return expr_alloc_comp(E_UNEQUAL, sym1, &symbol_no); + } + if (e1->type == E_EQUAL && e2->type == E_EQUAL && + ((e1->right.sym == &symbol_yes && e2->right.sym == &symbol_no) || + (e1->right.sym == &symbol_no && e2->right.sym == &symbol_yes))) { + // (a='y') || (a='n') -> (a!='m') + return expr_alloc_comp(E_UNEQUAL, sym1, &symbol_mod); + } + if (e1->type == E_EQUAL && e2->type == E_EQUAL && + ((e1->right.sym == &symbol_mod && e2->right.sym == &symbol_no) || + (e1->right.sym == &symbol_no && e2->right.sym == &symbol_mod))) { + // (a='m') || (a='n') -> (a!='y') + return expr_alloc_comp(E_UNEQUAL, sym1, &symbol_yes); + } + } + if (sym1->type == S_BOOLEAN && sym1 == sym2) { + if ((e1->type == E_NOT && e1->left.expr->type == E_SYMBOL && e2->type == E_SYMBOL) || + (e2->type == E_NOT && e2->left.expr->type == E_SYMBOL && e1->type == E_SYMBOL)) + return expr_alloc_symbol(&symbol_yes); + } + + if (DEBUG_EXPR) { + printf("optimize ("); + expr_fprint(e1, stdout); + printf(") || ("); + expr_fprint(e2, stdout); + printf(")?\n"); + } + return NULL; +} + +static struct expr *expr_join_and(struct expr *e1, struct expr *e2) +{ + struct expr *tmp; + struct symbol *sym1, *sym2; + + if (expr_eq(e1, e2)) + return expr_copy(e1); + if (e1->type != E_EQUAL && e1->type != E_UNEQUAL && e1->type != E_SYMBOL && e1->type != E_NOT) + return NULL; + if (e2->type != E_EQUAL && e2->type != E_UNEQUAL && e2->type != E_SYMBOL && e2->type != E_NOT) + return NULL; + if (e1->type == E_NOT) { + tmp = e1->left.expr; + if (tmp->type != E_EQUAL && tmp->type != E_UNEQUAL && tmp->type != E_SYMBOL) + return NULL; + sym1 = tmp->left.sym; + } else + sym1 = e1->left.sym; + if (e2->type == E_NOT) { + if (e2->left.expr->type != E_SYMBOL) + return NULL; + sym2 = e2->left.expr->left.sym; + } else + sym2 = e2->left.sym; + if (sym1 != sym2) + return NULL; + if (sym1->type != S_BOOLEAN && sym1->type != S_TRISTATE) + return NULL; + + if ((e1->type == E_SYMBOL && e2->type == E_EQUAL && e2->right.sym == &symbol_yes) || + (e2->type == E_SYMBOL && e1->type == E_EQUAL && e1->right.sym == &symbol_yes)) + // (a) && (a='y') -> (a='y') + return expr_alloc_comp(E_EQUAL, sym1, &symbol_yes); + + if ((e1->type == E_SYMBOL && e2->type == E_UNEQUAL && e2->right.sym == &symbol_no) || + (e2->type == E_SYMBOL && e1->type == E_UNEQUAL && e1->right.sym == &symbol_no)) + // (a) && (a!='n') -> (a) + return expr_alloc_symbol(sym1); + + if ((e1->type == E_SYMBOL && e2->type == E_UNEQUAL && e2->right.sym == &symbol_mod) || + (e2->type == E_SYMBOL && e1->type == E_UNEQUAL && e1->right.sym == &symbol_mod)) + // (a) && (a!='m') -> (a='y') + return expr_alloc_comp(E_EQUAL, sym1, &symbol_yes); + + if (sym1->type == S_TRISTATE) { + if (e1->type == E_EQUAL && e2->type == E_UNEQUAL) { + // (a='b') && (a!='c') -> 'b'='c' ? 'n' : a='b' + sym2 = e1->right.sym; + if ((e2->right.sym->flags & SYMBOL_CONST) && (sym2->flags & SYMBOL_CONST)) + return sym2 != e2->right.sym ? expr_alloc_comp(E_EQUAL, sym1, sym2) + : expr_alloc_symbol(&symbol_no); + } + if (e1->type == E_UNEQUAL && e2->type == E_EQUAL) { + // (a='b') && (a!='c') -> 'b'='c' ? 'n' : a='b' + sym2 = e2->right.sym; + if ((e1->right.sym->flags & SYMBOL_CONST) && (sym2->flags & SYMBOL_CONST)) + return sym2 != e1->right.sym ? expr_alloc_comp(E_EQUAL, sym1, sym2) + : expr_alloc_symbol(&symbol_no); + } + if (e1->type == E_UNEQUAL && e2->type == E_UNEQUAL && + ((e1->right.sym == &symbol_yes && e2->right.sym == &symbol_no) || + (e1->right.sym == &symbol_no && e2->right.sym == &symbol_yes))) + // (a!='y') && (a!='n') -> (a='m') + return expr_alloc_comp(E_EQUAL, sym1, &symbol_mod); + + if (e1->type == E_UNEQUAL && e2->type == E_UNEQUAL && + ((e1->right.sym == &symbol_yes && e2->right.sym == &symbol_mod) || + (e1->right.sym == &symbol_mod && e2->right.sym == &symbol_yes))) + // (a!='y') && (a!='m') -> (a='n') + return expr_alloc_comp(E_EQUAL, sym1, &symbol_no); + + if (e1->type == E_UNEQUAL && e2->type == E_UNEQUAL && + ((e1->right.sym == &symbol_mod && e2->right.sym == &symbol_no) || + (e1->right.sym == &symbol_no && e2->right.sym == &symbol_mod))) + // (a!='m') && (a!='n') -> (a='m') + return expr_alloc_comp(E_EQUAL, sym1, &symbol_yes); + + if ((e1->type == E_SYMBOL && e2->type == E_EQUAL && e2->right.sym == &symbol_mod) || + (e2->type == E_SYMBOL && e1->type == E_EQUAL && e1->right.sym == &symbol_mod) || + (e1->type == E_SYMBOL && e2->type == E_UNEQUAL && e2->right.sym == &symbol_yes) || + (e2->type == E_SYMBOL && e1->type == E_UNEQUAL && e1->right.sym == &symbol_yes)) + return NULL; + } + + if (DEBUG_EXPR) { + printf("optimize ("); + expr_fprint(e1, stdout); + printf(") && ("); + expr_fprint(e2, stdout); + printf(")?\n"); + } + return NULL; +} + +static void expr_eliminate_dups1(enum expr_type type, struct expr **ep1, struct expr **ep2) +{ +#define e1 (*ep1) +#define e2 (*ep2) + struct expr *tmp; + + if (e1->type == type) { + expr_eliminate_dups1(type, &e1->left.expr, &e2); + expr_eliminate_dups1(type, &e1->right.expr, &e2); + return; + } + if (e2->type == type) { + expr_eliminate_dups1(type, &e1, &e2->left.expr); + expr_eliminate_dups1(type, &e1, &e2->right.expr); + return; + } + if (e1 == e2) + return; + + switch (e1->type) { + case E_OR: case E_AND: + expr_eliminate_dups1(e1->type, &e1, &e1); + default: + ; + } + + switch (type) { + case E_OR: + tmp = expr_join_or(e1, e2); + if (tmp) { + expr_free(e1); expr_free(e2); + e1 = expr_alloc_symbol(&symbol_no); + e2 = tmp; + trans_count++; + } + break; + case E_AND: + tmp = expr_join_and(e1, e2); + if (tmp) { + expr_free(e1); expr_free(e2); + e1 = expr_alloc_symbol(&symbol_yes); + e2 = tmp; + trans_count++; + } + break; + default: + ; + } +#undef e1 +#undef e2 +} + +struct expr *expr_eliminate_dups(struct expr *e) +{ + int oldcount; + if (!e) + return e; + + oldcount = trans_count; + while (1) { + trans_count = 0; + switch (e->type) { + case E_OR: case E_AND: + expr_eliminate_dups1(e->type, &e, &e); + default: + ; + } + if (!trans_count) + break; + e = expr_eliminate_yn(e); + } + trans_count = oldcount; + return e; +} + +struct expr *expr_transform(struct expr *e) +{ + struct expr *tmp; + + if (!e) + return NULL; + switch (e->type) { + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + case E_SYMBOL: + case E_LIST: + break; + default: + e->left.expr = expr_transform(e->left.expr); + e->right.expr = expr_transform(e->right.expr); + } + + switch (e->type) { + case E_EQUAL: + if (e->left.sym->type != S_BOOLEAN) + break; + if (e->right.sym == &symbol_no) { + e->type = E_NOT; + e->left.expr = expr_alloc_symbol(e->left.sym); + e->right.sym = NULL; + break; + } + if (e->right.sym == &symbol_mod) { + printf("boolean symbol %s tested for 'm'? test forced to 'n'\n", e->left.sym->name); + e->type = E_SYMBOL; + e->left.sym = &symbol_no; + e->right.sym = NULL; + break; + } + if (e->right.sym == &symbol_yes) { + e->type = E_SYMBOL; + e->right.sym = NULL; + break; + } + break; + case E_UNEQUAL: + if (e->left.sym->type != S_BOOLEAN) + break; + if (e->right.sym == &symbol_no) { + e->type = E_SYMBOL; + e->right.sym = NULL; + break; + } + if (e->right.sym == &symbol_mod) { + printf("boolean symbol %s tested for 'm'? test forced to 'y'\n", e->left.sym->name); + e->type = E_SYMBOL; + e->left.sym = &symbol_yes; + e->right.sym = NULL; + break; + } + if (e->right.sym == &symbol_yes) { + e->type = E_NOT; + e->left.expr = expr_alloc_symbol(e->left.sym); + e->right.sym = NULL; + break; + } + break; + case E_NOT: + switch (e->left.expr->type) { + case E_NOT: + // !!a -> a + tmp = e->left.expr->left.expr; + free(e->left.expr); + free(e); + e = tmp; + e = expr_transform(e); + break; + case E_EQUAL: + case E_UNEQUAL: + // !a='x' -> a!='x' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = e->type == E_EQUAL ? E_UNEQUAL : E_EQUAL; + break; + case E_LEQ: + case E_GEQ: + // !a<='x' -> a>'x' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = e->type == E_LEQ ? E_GTH : E_LTH; + break; + case E_LTH: + case E_GTH: + // !a<'x' -> a>='x' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = e->type == E_LTH ? E_GEQ : E_LEQ; + break; + case E_OR: + // !(a || b) -> !a && !b + tmp = e->left.expr; + e->type = E_AND; + e->right.expr = expr_alloc_one(E_NOT, tmp->right.expr); + tmp->type = E_NOT; + tmp->right.expr = NULL; + e = expr_transform(e); + break; + case E_AND: + // !(a && b) -> !a || !b + tmp = e->left.expr; + e->type = E_OR; + e->right.expr = expr_alloc_one(E_NOT, tmp->right.expr); + tmp->type = E_NOT; + tmp->right.expr = NULL; + e = expr_transform(e); + break; + case E_SYMBOL: + if (e->left.expr->left.sym == &symbol_yes) { + // !'y' -> 'n' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = E_SYMBOL; + e->left.sym = &symbol_no; + break; + } + if (e->left.expr->left.sym == &symbol_mod) { + // !'m' -> 'm' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = E_SYMBOL; + e->left.sym = &symbol_mod; + break; + } + if (e->left.expr->left.sym == &symbol_no) { + // !'n' -> 'y' + tmp = e->left.expr; + free(e); + e = tmp; + e->type = E_SYMBOL; + e->left.sym = &symbol_yes; + break; + } + break; + default: + ; + } + break; + default: + ; + } + return e; +} + +int expr_contains_symbol(struct expr *dep, struct symbol *sym) +{ + if (!dep) + return 0; + + switch (dep->type) { + case E_AND: + case E_OR: + return expr_contains_symbol(dep->left.expr, sym) || + expr_contains_symbol(dep->right.expr, sym); + case E_SYMBOL: + return dep->left.sym == sym; + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + return dep->left.sym == sym || + dep->right.sym == sym; + case E_NOT: + return expr_contains_symbol(dep->left.expr, sym); + default: + ; + } + return 0; +} + +bool expr_depends_symbol(struct expr *dep, struct symbol *sym) +{ + if (!dep) + return false; + + switch (dep->type) { + case E_AND: + return expr_depends_symbol(dep->left.expr, sym) || + expr_depends_symbol(dep->right.expr, sym); + case E_SYMBOL: + return dep->left.sym == sym; + case E_EQUAL: + if (dep->left.sym == sym) { + if (dep->right.sym == &symbol_yes || dep->right.sym == &symbol_mod) + return true; + } + break; + case E_UNEQUAL: + if (dep->left.sym == sym) { + if (dep->right.sym == &symbol_no) + return true; + } + break; + default: + ; + } + return false; +} + +struct expr *expr_trans_compare(struct expr *e, enum expr_type type, struct symbol *sym) +{ + struct expr *e1, *e2; + + if (!e) { + e = expr_alloc_symbol(sym); + if (type == E_UNEQUAL) + e = expr_alloc_one(E_NOT, e); + return e; + } + switch (e->type) { + case E_AND: + e1 = expr_trans_compare(e->left.expr, E_EQUAL, sym); + e2 = expr_trans_compare(e->right.expr, E_EQUAL, sym); + if (sym == &symbol_yes) + e = expr_alloc_two(E_AND, e1, e2); + if (sym == &symbol_no) + e = expr_alloc_two(E_OR, e1, e2); + if (type == E_UNEQUAL) + e = expr_alloc_one(E_NOT, e); + return e; + case E_OR: + e1 = expr_trans_compare(e->left.expr, E_EQUAL, sym); + e2 = expr_trans_compare(e->right.expr, E_EQUAL, sym); + if (sym == &symbol_yes) + e = expr_alloc_two(E_OR, e1, e2); + if (sym == &symbol_no) + e = expr_alloc_two(E_AND, e1, e2); + if (type == E_UNEQUAL) + e = expr_alloc_one(E_NOT, e); + return e; + case E_NOT: + return expr_trans_compare(e->left.expr, type == E_EQUAL ? E_UNEQUAL : E_EQUAL, sym); + case E_UNEQUAL: + case E_LTH: + case E_LEQ: + case E_GTH: + case E_GEQ: + case E_EQUAL: + if (type == E_EQUAL) { + if (sym == &symbol_yes) + return expr_copy(e); + if (sym == &symbol_mod) + return expr_alloc_symbol(&symbol_no); + if (sym == &symbol_no) + return expr_alloc_one(E_NOT, expr_copy(e)); + } else { + if (sym == &symbol_yes) + return expr_alloc_one(E_NOT, expr_copy(e)); + if (sym == &symbol_mod) + return expr_alloc_symbol(&symbol_yes); + if (sym == &symbol_no) + return expr_copy(e); + } + break; + case E_SYMBOL: + return expr_alloc_comp(type, e->left.sym, sym); + case E_LIST: + case E_RANGE: + case E_NONE: + /* panic */; + } + return NULL; +} + +enum string_value_kind { + k_string, + k_signed, + k_unsigned, + k_invalid +}; + +union string_value { + unsigned long long u; + signed long long s; +}; + +static enum string_value_kind expr_parse_string(const char *str, + enum symbol_type type, + union string_value *val) +{ + char *tail; + enum string_value_kind kind; + + errno = 0; + switch (type) { + case S_BOOLEAN: + case S_TRISTATE: + return k_string; + case S_INT: + val->s = strtoll(str, &tail, 10); + kind = k_signed; + break; + case S_HEX: + val->u = strtoull(str, &tail, 16); + kind = k_unsigned; + break; + case S_STRING: + case S_UNKNOWN: + val->s = strtoll(str, &tail, 0); + kind = k_signed; + break; + default: + return k_invalid; + } + return !errno && !*tail && tail > str && isxdigit(tail[-1]) + ? kind : k_string; +} + +tristate expr_calc_value(struct expr *e) +{ + tristate val1, val2; + const char *str1, *str2; + enum string_value_kind k1 = k_string, k2 = k_string; + union string_value lval = {}, rval = {}; + int res; + + if (!e) + return yes; + + switch (e->type) { + case E_SYMBOL: + sym_calc_value(e->left.sym); + return e->left.sym->curr.tri; + case E_AND: + val1 = expr_calc_value(e->left.expr); + val2 = expr_calc_value(e->right.expr); + return EXPR_AND(val1, val2); + case E_OR: + val1 = expr_calc_value(e->left.expr); + val2 = expr_calc_value(e->right.expr); + return EXPR_OR(val1, val2); + case E_NOT: + val1 = expr_calc_value(e->left.expr); + return EXPR_NOT(val1); + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + break; + default: + printf("expr_calc_value: %d?\n", e->type); + return no; + } + + sym_calc_value(e->left.sym); + sym_calc_value(e->right.sym); + str1 = sym_get_string_value(e->left.sym); + str2 = sym_get_string_value(e->right.sym); + + if (e->left.sym->type != S_STRING || e->right.sym->type != S_STRING) { + k1 = expr_parse_string(str1, e->left.sym->type, &lval); + k2 = expr_parse_string(str2, e->right.sym->type, &rval); + } + + if (k1 == k_string || k2 == k_string) + res = strcmp(str1, str2); + else if (k1 == k_invalid || k2 == k_invalid) { + if (e->type != E_EQUAL && e->type != E_UNEQUAL) { + printf("Cannot compare \"%s\" and \"%s\"\n", str1, str2); + return no; + } + res = strcmp(str1, str2); + } else if (k1 == k_unsigned || k2 == k_unsigned) + res = (lval.u > rval.u) - (lval.u < rval.u); + else /* if (k1 == k_signed && k2 == k_signed) */ + res = (lval.s > rval.s) - (lval.s < rval.s); + + switch(e->type) { + case E_EQUAL: + return res ? no : yes; + case E_GEQ: + return res >= 0 ? yes : no; + case E_GTH: + return res > 0 ? yes : no; + case E_LEQ: + return res <= 0 ? yes : no; + case E_LTH: + return res < 0 ? yes : no; + case E_UNEQUAL: + return res ? yes : no; + default: + printf("expr_calc_value: relation %d?\n", e->type); + return no; + } +} + +static int expr_compare_type(enum expr_type t1, enum expr_type t2) +{ + if (t1 == t2) + return 0; + switch (t1) { + case E_LEQ: + case E_LTH: + case E_GEQ: + case E_GTH: + if (t2 == E_EQUAL || t2 == E_UNEQUAL) + return 1; + case E_EQUAL: + case E_UNEQUAL: + if (t2 == E_NOT) + return 1; + case E_NOT: + if (t2 == E_AND) + return 1; + case E_AND: + if (t2 == E_OR) + return 1; + case E_OR: + if (t2 == E_LIST) + return 1; + case E_LIST: + if (t2 == 0) + return 1; + default: + return -1; + } + printf("[%dgt%d?]", t1, t2); + return 0; +} + +static inline struct expr * +expr_get_leftmost_symbol(const struct expr *e) +{ + + if (e == NULL) + return NULL; + + while (e->type != E_SYMBOL) + e = e->left.expr; + + return expr_copy(e); +} + +/* + * Given expression `e1' and `e2', returns the leaf of the longest + * sub-expression of `e1' not containing 'e2. + */ +struct expr *expr_simplify_unmet_dep(struct expr *e1, struct expr *e2) +{ + struct expr *ret; + + switch (e1->type) { + case E_OR: + return expr_alloc_and( + expr_simplify_unmet_dep(e1->left.expr, e2), + expr_simplify_unmet_dep(e1->right.expr, e2)); + case E_AND: { + struct expr *e; + e = expr_alloc_and(expr_copy(e1), expr_copy(e2)); + e = expr_eliminate_dups(e); + ret = (!expr_eq(e, e1)) ? e1 : NULL; + expr_free(e); + break; + } + default: + ret = e1; + break; + } + + return expr_get_leftmost_symbol(ret); +} + +void expr_print(struct expr *e, void (*fn)(void *, struct symbol *, const char *), void *data, int prevtoken) +{ + if (!e) { + fn(data, NULL, "y"); + return; + } + + if (expr_compare_type(prevtoken, e->type) > 0) + fn(data, NULL, "("); + switch (e->type) { + case E_SYMBOL: + if (e->left.sym->name) + fn(data, e->left.sym, e->left.sym->name); + else + fn(data, NULL, ""); + break; + case E_NOT: + fn(data, NULL, "!"); + expr_print(e->left.expr, fn, data, E_NOT); + break; + case E_EQUAL: + if (e->left.sym->name) + fn(data, e->left.sym, e->left.sym->name); + else + fn(data, NULL, ""); + fn(data, NULL, "="); + fn(data, e->right.sym, e->right.sym->name); + break; + case E_LEQ: + case E_LTH: + if (e->left.sym->name) + fn(data, e->left.sym, e->left.sym->name); + else + fn(data, NULL, ""); + fn(data, NULL, e->type == E_LEQ ? "<=" : "<"); + fn(data, e->right.sym, e->right.sym->name); + break; + case E_GEQ: + case E_GTH: + if (e->left.sym->name) + fn(data, e->left.sym, e->left.sym->name); + else + fn(data, NULL, ""); + fn(data, NULL, e->type == E_GEQ ? ">=" : ">"); + fn(data, e->right.sym, e->right.sym->name); + break; + case E_UNEQUAL: + if (e->left.sym->name) + fn(data, e->left.sym, e->left.sym->name); + else + fn(data, NULL, ""); + fn(data, NULL, "!="); + fn(data, e->right.sym, e->right.sym->name); + break; + case E_OR: + expr_print(e->left.expr, fn, data, E_OR); + fn(data, NULL, " || "); + expr_print(e->right.expr, fn, data, E_OR); + break; + case E_AND: + expr_print(e->left.expr, fn, data, E_AND); + fn(data, NULL, " && "); + expr_print(e->right.expr, fn, data, E_AND); + break; + case E_LIST: + fn(data, e->right.sym, e->right.sym->name); + if (e->left.expr) { + fn(data, NULL, " ^ "); + expr_print(e->left.expr, fn, data, E_LIST); + } + break; + case E_RANGE: + fn(data, NULL, "["); + fn(data, e->left.sym, e->left.sym->name); + fn(data, NULL, " "); + fn(data, e->right.sym, e->right.sym->name); + fn(data, NULL, "]"); + break; + default: + { + char buf[32]; + sprintf(buf, "", e->type); + fn(data, NULL, buf); + break; + } + } + if (expr_compare_type(prevtoken, e->type) > 0) + fn(data, NULL, ")"); +} + +static void expr_print_file_helper(void *data, struct symbol *sym, const char *str) +{ + xfwrite(str, strlen(str), 1, data); +} + +void expr_fprint(struct expr *e, FILE *out) +{ + expr_print(e, expr_print_file_helper, out, E_NONE); +} + +static void expr_print_gstr_helper(void *data, struct symbol *sym, const char *str) +{ + struct gstr *gs = (struct gstr*)data; + const char *sym_str = NULL; + + if (sym) + sym_str = sym_get_string_value(sym); + + if (gs->max_width) { + unsigned extra_length = strlen(str); + const char *last_cr = strrchr(gs->s, '\n'); + unsigned last_line_length; + + if (sym_str) + extra_length += 4 + strlen(sym_str); + + if (!last_cr) + last_cr = gs->s; + + last_line_length = strlen(gs->s) - (last_cr - gs->s); + + if ((last_line_length + extra_length) > gs->max_width) + str_append(gs, "\\\n"); + } + + str_append(gs, str); + if (sym && sym->type != S_UNKNOWN) + str_printf(gs, " [=%s]", sym_str); +} + +void expr_gstr_print(struct expr *e, struct gstr *gs) +{ + expr_print(e, expr_print_gstr_helper, gs, E_NONE); +} diff --git a/tools/kconfig/expr.h b/tools/kconfig/expr.h new file mode 100644 index 000000000..973b6f733 --- /dev/null +++ b/tools/kconfig/expr.h @@ -0,0 +1,238 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#ifndef EXPR_H +#define EXPR_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include "list.h" +#ifndef __cplusplus +#include +#endif + +struct file { + struct file *next; + struct file *parent; + const char *name; + int lineno; +}; + +typedef enum tristate { + no, mod, yes +} tristate; + +enum expr_type { + E_NONE, E_OR, E_AND, E_NOT, + E_EQUAL, E_UNEQUAL, E_LTH, E_LEQ, E_GTH, E_GEQ, + E_LIST, E_SYMBOL, E_RANGE +}; + +union expr_data { + struct expr *expr; + struct symbol *sym; +}; + +struct expr { + enum expr_type type; + union expr_data left, right; +}; + +#define EXPR_OR(dep1, dep2) (((dep1)>(dep2))?(dep1):(dep2)) +#define EXPR_AND(dep1, dep2) (((dep1)<(dep2))?(dep1):(dep2)) +#define EXPR_NOT(dep) (2-(dep)) + +#define expr_list_for_each_sym(l, e, s) \ + for (e = (l); e && (s = e->right.sym); e = e->left.expr) + +struct expr_value { + struct expr *expr; + tristate tri; +}; + +struct symbol_value { + void *val; + tristate tri; +}; + +enum symbol_type { + S_UNKNOWN, S_BOOLEAN, S_TRISTATE, S_INT, S_HEX, S_STRING, S_OTHER +}; + +/* enum values are used as index to symbol.def[] */ +enum { + S_DEF_USER, /* main user value */ + S_DEF_AUTO, /* values read from auto.conf */ + S_DEF_DEF3, /* Reserved for UI usage */ + S_DEF_DEF4, /* Reserved for UI usage */ + S_DEF_COUNT +}; + +struct symbol { + struct symbol *next; + char *name; + enum symbol_type type; + struct symbol_value curr; + struct symbol_value def[S_DEF_COUNT]; + tristate visible; + int flags; + struct property *prop; + struct expr_value dir_dep; + struct expr_value rev_dep; +}; + +#define for_all_symbols(i, sym) for (i = 0; i < SYMBOL_HASHSIZE; i++) for (sym = symbol_hash[i]; sym; sym = sym->next) if (sym->type != S_OTHER) + +#define SYMBOL_CONST 0x0001 /* symbol is const */ +#define SYMBOL_CHECK 0x0008 /* used during dependency checking */ +#define SYMBOL_CHOICE 0x0010 /* start of a choice block (null name) */ +#define SYMBOL_CHOICEVAL 0x0020 /* used as a value in a choice block */ +#define SYMBOL_VALID 0x0080 /* set when symbol.curr is calculated */ +#define SYMBOL_OPTIONAL 0x0100 /* choice is optional - values can be 'n' */ +#define SYMBOL_WRITE 0x0200 /* write symbol to file (KCONFIG_CONFIG) */ +#define SYMBOL_CHANGED 0x0400 /* ? */ +#define SYMBOL_AUTO 0x1000 /* value from environment variable */ +#define SYMBOL_CHECKED 0x2000 /* used during dependency checking */ +#define SYMBOL_WARNED 0x8000 /* warning has been issued */ + +/* Set when symbol.def[] is used */ +#define SYMBOL_DEF 0x10000 /* First bit of SYMBOL_DEF */ +#define SYMBOL_DEF_USER 0x10000 /* symbol.def[S_DEF_USER] is valid */ +#define SYMBOL_DEF_AUTO 0x20000 /* symbol.def[S_DEF_AUTO] is valid */ +#define SYMBOL_DEF3 0x40000 /* symbol.def[S_DEF_3] is valid */ +#define SYMBOL_DEF4 0x80000 /* symbol.def[S_DEF_4] is valid */ + +/* choice values need to be set before calculating this symbol value */ +#define SYMBOL_NEED_SET_CHOICE_VALUES 0x100000 + +/* Set symbol to y if allnoconfig; used for symbols that hide others */ +#define SYMBOL_ALLNOCONFIG_Y 0x200000 + +#define SYMBOL_MAXLENGTH 256 +#define SYMBOL_HASHSIZE 9973 + +/* A property represent the config options that can be associated + * with a config "symbol". + * Sample: + * config FOO + * default y + * prompt "foo prompt" + * select BAR + * config BAZ + * int "BAZ Value" + * range 1..255 + */ +enum prop_type { + P_UNKNOWN, + P_PROMPT, /* prompt "foo prompt" or "BAZ Value" */ + P_COMMENT, /* text associated with a comment */ + P_MENU, /* prompt associated with a menuconfig option */ + P_DEFAULT, /* default y */ + P_CHOICE, /* choice value */ + P_SELECT, /* select BAR */ + P_RANGE, /* range 7..100 (for a symbol) */ + P_ENV, /* value from environment variable */ + P_SYMBOL, /* where a symbol is defined */ +}; + +struct property { + struct property *next; /* next property - null if last */ + struct symbol *sym; /* the symbol for which the property is associated */ + enum prop_type type; /* type of property */ + const char *text; /* the prompt value - P_PROMPT, P_MENU, P_COMMENT */ + struct expr_value visible; + struct expr *expr; /* the optional conditional part of the property */ + struct menu *menu; /* the menu the property are associated with + * valid for: P_SELECT, P_RANGE, P_CHOICE, + * P_PROMPT, P_DEFAULT, P_MENU, P_COMMENT */ + struct file *file; /* what file was this property defined */ + int lineno; /* what lineno was this property defined */ +}; + +#define for_all_properties(sym, st, tok) \ + for (st = sym->prop; st; st = st->next) \ + if (st->type == (tok)) +#define for_all_defaults(sym, st) for_all_properties(sym, st, P_DEFAULT) +#define for_all_choices(sym, st) for_all_properties(sym, st, P_CHOICE) +#define for_all_prompts(sym, st) \ + for (st = sym->prop; st; st = st->next) \ + if (st->text) + +struct menu { + struct menu *next; + struct menu *parent; + struct menu *list; + struct symbol *sym; + struct property *prompt; + struct expr *visibility; + struct expr *dep; + unsigned int flags; + char *help; + struct file *file; + int lineno; + void *data; +}; + +#define MENU_CHANGED 0x0001 +#define MENU_ROOT 0x0002 + +struct jump_key { + struct list_head entries; + size_t offset; + struct menu *target; + int index; +}; + +#define JUMP_NB 9 + +extern struct file *file_list; +extern struct file *current_file; +struct file *lookup_file(const char *name); + +extern struct symbol symbol_yes, symbol_no, symbol_mod; +extern struct symbol *modules_sym; +extern struct symbol *sym_defconfig_list; +extern int cdebug; +struct expr *expr_alloc_symbol(struct symbol *sym); +struct expr *expr_alloc_one(enum expr_type type, struct expr *ce); +struct expr *expr_alloc_two(enum expr_type type, struct expr *e1, struct expr *e2); +struct expr *expr_alloc_comp(enum expr_type type, struct symbol *s1, struct symbol *s2); +struct expr *expr_alloc_and(struct expr *e1, struct expr *e2); +struct expr *expr_alloc_or(struct expr *e1, struct expr *e2); +struct expr *expr_copy(const struct expr *org); +void expr_free(struct expr *e); +void expr_eliminate_eq(struct expr **ep1, struct expr **ep2); +tristate expr_calc_value(struct expr *e); +struct expr *expr_trans_bool(struct expr *e); +struct expr *expr_eliminate_dups(struct expr *e); +struct expr *expr_transform(struct expr *e); +int expr_contains_symbol(struct expr *dep, struct symbol *sym); +bool expr_depends_symbol(struct expr *dep, struct symbol *sym); +struct expr *expr_trans_compare(struct expr *e, enum expr_type type, struct symbol *sym); +struct expr *expr_simplify_unmet_dep(struct expr *e1, struct expr *e2); + +void expr_fprint(struct expr *e, FILE *out); +struct gstr; /* forward */ +void expr_gstr_print(struct expr *e, struct gstr *gs); + +static inline int expr_is_yes(struct expr *e) +{ + return !e || (e->type == E_SYMBOL && e->left.sym == &symbol_yes); +} + +static inline int expr_is_no(struct expr *e) +{ + return e && (e->type == E_SYMBOL && e->left.sym == &symbol_no); +} + +#ifdef __cplusplus +} +#endif + +#endif /* EXPR_H */ diff --git a/tools/kconfig/gconf.c b/tools/kconfig/gconf.c new file mode 100644 index 000000000..26d208b43 --- /dev/null +++ b/tools/kconfig/gconf.c @@ -0,0 +1,1521 @@ +/* Hey EMACS -*- linux-c -*- */ +/* + * + * Copyright (C) 2002-2003 Romain Lievin + * Released under the terms of the GNU GPL v2.0. + * + */ + +#ifdef HAVE_CONFIG_H +# include +#endif + +#include +#include "lkc.h" +#include "images.c" + +#include +#include +#include +#include + +#include +#include +#include +#include + +//#define DEBUG + +enum { + SINGLE_VIEW, SPLIT_VIEW, FULL_VIEW +}; + +enum { + OPT_NORMAL, OPT_ALL, OPT_PROMPT +}; + +static gint view_mode = FULL_VIEW; +static gboolean show_name = TRUE; +static gboolean show_range = TRUE; +static gboolean show_value = TRUE; +static gboolean resizeable = FALSE; +static int opt_mode = OPT_NORMAL; + +GtkWidget *main_wnd = NULL; +GtkWidget *tree1_w = NULL; // left frame +GtkWidget *tree2_w = NULL; // right frame +GtkWidget *text_w = NULL; +GtkWidget *hpaned = NULL; +GtkWidget *vpaned = NULL; +GtkWidget *back_btn = NULL; +GtkWidget *save_btn = NULL; +GtkWidget *save_menu_item = NULL; + +GtkTextTag *tag1, *tag2; +GdkColor color; + +GtkTreeStore *tree1, *tree2, *tree; +GtkTreeModel *model1, *model2; +static GtkTreeIter *parents[256]; +static gint indent; + +static struct menu *current; // current node for SINGLE view +static struct menu *browsed; // browsed node for SPLIT view + +enum { + COL_OPTION, COL_NAME, COL_NO, COL_MOD, COL_YES, COL_VALUE, + COL_MENU, COL_COLOR, COL_EDIT, COL_PIXBUF, + COL_PIXVIS, COL_BTNVIS, COL_BTNACT, COL_BTNINC, COL_BTNRAD, + COL_NUMBER +}; + +static void display_list(void); +static void display_tree(struct menu *menu); +static void display_tree_part(void); +static void update_tree(struct menu *src, GtkTreeIter * dst); +static void set_node(GtkTreeIter * node, struct menu *menu, gchar ** row); +static gchar **fill_row(struct menu *menu); +static void conf_changed(void); + +/* Helping/Debugging Functions */ + +const char *dbg_sym_flags(int val) +{ + static char buf[256]; + + bzero(buf, 256); + + if (val & SYMBOL_CONST) + strcat(buf, "const/"); + if (val & SYMBOL_CHECK) + strcat(buf, "check/"); + if (val & SYMBOL_CHOICE) + strcat(buf, "choice/"); + if (val & SYMBOL_CHOICEVAL) + strcat(buf, "choiceval/"); + if (val & SYMBOL_VALID) + strcat(buf, "valid/"); + if (val & SYMBOL_OPTIONAL) + strcat(buf, "optional/"); + if (val & SYMBOL_WRITE) + strcat(buf, "write/"); + if (val & SYMBOL_CHANGED) + strcat(buf, "changed/"); + if (val & SYMBOL_AUTO) + strcat(buf, "auto/"); + + buf[strlen(buf) - 1] = '\0'; + + return buf; +} + +void replace_button_icon(GladeXML * xml, GdkDrawable * window, + GtkStyle * style, gchar * btn_name, gchar ** xpm) +{ + GdkPixmap *pixmap; + GdkBitmap *mask; + GtkToolButton *button; + GtkWidget *image; + + pixmap = gdk_pixmap_create_from_xpm_d(window, &mask, + &style->bg[GTK_STATE_NORMAL], + xpm); + + button = GTK_TOOL_BUTTON(glade_xml_get_widget(xml, btn_name)); + image = gtk_image_new_from_pixmap(pixmap, mask); + gtk_widget_show(image); + gtk_tool_button_set_icon_widget(button, image); +} + +/* Main Window Initialization */ +void init_main_window(const gchar * glade_file) +{ + GladeXML *xml; + GtkWidget *widget; + GtkTextBuffer *txtbuf; + GtkStyle *style; + + xml = glade_xml_new(glade_file, "window1", NULL); + if (!xml) + g_error(_("GUI loading failed !\n")); + glade_xml_signal_autoconnect(xml); + + main_wnd = glade_xml_get_widget(xml, "window1"); + hpaned = glade_xml_get_widget(xml, "hpaned1"); + vpaned = glade_xml_get_widget(xml, "vpaned1"); + tree1_w = glade_xml_get_widget(xml, "treeview1"); + tree2_w = glade_xml_get_widget(xml, "treeview2"); + text_w = glade_xml_get_widget(xml, "textview3"); + + back_btn = glade_xml_get_widget(xml, "button1"); + gtk_widget_set_sensitive(back_btn, FALSE); + + widget = glade_xml_get_widget(xml, "show_name1"); + gtk_check_menu_item_set_active((GtkCheckMenuItem *) widget, + show_name); + + widget = glade_xml_get_widget(xml, "show_range1"); + gtk_check_menu_item_set_active((GtkCheckMenuItem *) widget, + show_range); + + widget = glade_xml_get_widget(xml, "show_data1"); + gtk_check_menu_item_set_active((GtkCheckMenuItem *) widget, + show_value); + + save_btn = glade_xml_get_widget(xml, "button3"); + save_menu_item = glade_xml_get_widget(xml, "save1"); + conf_set_changed_callback(conf_changed); + + style = gtk_widget_get_style(main_wnd); + widget = glade_xml_get_widget(xml, "toolbar1"); + + replace_button_icon(xml, main_wnd->window, style, + "button4", (gchar **) xpm_single_view); + replace_button_icon(xml, main_wnd->window, style, + "button5", (gchar **) xpm_split_view); + replace_button_icon(xml, main_wnd->window, style, + "button6", (gchar **) xpm_tree_view); + + txtbuf = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_w)); + tag1 = gtk_text_buffer_create_tag(txtbuf, "mytag1", + "foreground", "red", + "weight", PANGO_WEIGHT_BOLD, + NULL); + tag2 = gtk_text_buffer_create_tag(txtbuf, "mytag2", + /*"style", PANGO_STYLE_OBLIQUE, */ + NULL); + + gtk_window_set_title(GTK_WINDOW(main_wnd), rootmenu.prompt->text); + + gtk_widget_show(main_wnd); +} + +void init_tree_model(void) +{ + gint i; + + tree = tree2 = gtk_tree_store_new(COL_NUMBER, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_POINTER, GDK_TYPE_COLOR, + G_TYPE_BOOLEAN, GDK_TYPE_PIXBUF, + G_TYPE_BOOLEAN, G_TYPE_BOOLEAN, + G_TYPE_BOOLEAN, G_TYPE_BOOLEAN, + G_TYPE_BOOLEAN); + model2 = GTK_TREE_MODEL(tree2); + + for (parents[0] = NULL, i = 1; i < 256; i++) + parents[i] = (GtkTreeIter *) g_malloc(sizeof(GtkTreeIter)); + + tree1 = gtk_tree_store_new(COL_NUMBER, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_STRING, G_TYPE_STRING, + G_TYPE_POINTER, GDK_TYPE_COLOR, + G_TYPE_BOOLEAN, GDK_TYPE_PIXBUF, + G_TYPE_BOOLEAN, G_TYPE_BOOLEAN, + G_TYPE_BOOLEAN, G_TYPE_BOOLEAN, + G_TYPE_BOOLEAN); + model1 = GTK_TREE_MODEL(tree1); +} + +void init_left_tree(void) +{ + GtkTreeView *view = GTK_TREE_VIEW(tree1_w); + GtkCellRenderer *renderer; + GtkTreeSelection *sel; + GtkTreeViewColumn *column; + + gtk_tree_view_set_model(view, model1); + gtk_tree_view_set_headers_visible(view, TRUE); + gtk_tree_view_set_rules_hint(view, TRUE); + + column = gtk_tree_view_column_new(); + gtk_tree_view_append_column(view, column); + gtk_tree_view_column_set_title(column, _("Options")); + + renderer = gtk_cell_renderer_toggle_new(); + gtk_tree_view_column_pack_start(GTK_TREE_VIEW_COLUMN(column), + renderer, FALSE); + gtk_tree_view_column_set_attributes(GTK_TREE_VIEW_COLUMN(column), + renderer, + "active", COL_BTNACT, + "inconsistent", COL_BTNINC, + "visible", COL_BTNVIS, + "radio", COL_BTNRAD, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_column_pack_start(GTK_TREE_VIEW_COLUMN(column), + renderer, FALSE); + gtk_tree_view_column_set_attributes(GTK_TREE_VIEW_COLUMN(column), + renderer, + "text", COL_OPTION, + "foreground-gdk", + COL_COLOR, NULL); + + sel = gtk_tree_view_get_selection(view); + gtk_tree_selection_set_mode(sel, GTK_SELECTION_SINGLE); + gtk_widget_realize(tree1_w); +} + +static void renderer_edited(GtkCellRendererText * cell, + const gchar * path_string, + const gchar * new_text, gpointer user_data); + +void init_right_tree(void) +{ + GtkTreeView *view = GTK_TREE_VIEW(tree2_w); + GtkCellRenderer *renderer; + GtkTreeSelection *sel; + GtkTreeViewColumn *column; + gint i; + + gtk_tree_view_set_model(view, model2); + gtk_tree_view_set_headers_visible(view, TRUE); + gtk_tree_view_set_rules_hint(view, TRUE); + + column = gtk_tree_view_column_new(); + gtk_tree_view_append_column(view, column); + gtk_tree_view_column_set_title(column, _("Options")); + + renderer = gtk_cell_renderer_pixbuf_new(); + gtk_tree_view_column_pack_start(GTK_TREE_VIEW_COLUMN(column), + renderer, FALSE); + gtk_tree_view_column_set_attributes(GTK_TREE_VIEW_COLUMN(column), + renderer, + "pixbuf", COL_PIXBUF, + "visible", COL_PIXVIS, NULL); + renderer = gtk_cell_renderer_toggle_new(); + gtk_tree_view_column_pack_start(GTK_TREE_VIEW_COLUMN(column), + renderer, FALSE); + gtk_tree_view_column_set_attributes(GTK_TREE_VIEW_COLUMN(column), + renderer, + "active", COL_BTNACT, + "inconsistent", COL_BTNINC, + "visible", COL_BTNVIS, + "radio", COL_BTNRAD, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_column_pack_start(GTK_TREE_VIEW_COLUMN(column), + renderer, FALSE); + gtk_tree_view_column_set_attributes(GTK_TREE_VIEW_COLUMN(column), + renderer, + "text", COL_OPTION, + "foreground-gdk", + COL_COLOR, NULL); + + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_insert_column_with_attributes(view, -1, + _("Name"), renderer, + "text", COL_NAME, + "foreground-gdk", + COL_COLOR, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_insert_column_with_attributes(view, -1, + "N", renderer, + "text", COL_NO, + "foreground-gdk", + COL_COLOR, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_insert_column_with_attributes(view, -1, + "M", renderer, + "text", COL_MOD, + "foreground-gdk", + COL_COLOR, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_insert_column_with_attributes(view, -1, + "Y", renderer, + "text", COL_YES, + "foreground-gdk", + COL_COLOR, NULL); + renderer = gtk_cell_renderer_text_new(); + gtk_tree_view_insert_column_with_attributes(view, -1, + _("Value"), renderer, + "text", COL_VALUE, + "editable", + COL_EDIT, + "foreground-gdk", + COL_COLOR, NULL); + g_signal_connect(G_OBJECT(renderer), "edited", + G_CALLBACK(renderer_edited), NULL); + + column = gtk_tree_view_get_column(view, COL_NAME); + gtk_tree_view_column_set_visible(column, show_name); + column = gtk_tree_view_get_column(view, COL_NO); + gtk_tree_view_column_set_visible(column, show_range); + column = gtk_tree_view_get_column(view, COL_MOD); + gtk_tree_view_column_set_visible(column, show_range); + column = gtk_tree_view_get_column(view, COL_YES); + gtk_tree_view_column_set_visible(column, show_range); + column = gtk_tree_view_get_column(view, COL_VALUE); + gtk_tree_view_column_set_visible(column, show_value); + + if (resizeable) { + for (i = 0; i < COL_VALUE; i++) { + column = gtk_tree_view_get_column(view, i); + gtk_tree_view_column_set_resizable(column, TRUE); + } + } + + sel = gtk_tree_view_get_selection(view); + gtk_tree_selection_set_mode(sel, GTK_SELECTION_SINGLE); +} + + +/* Utility Functions */ + + +static void text_insert_help(struct menu *menu) +{ + GtkTextBuffer *buffer; + GtkTextIter start, end; + const char *prompt = _(menu_get_prompt(menu)); + struct gstr help = str_new(); + + menu_get_ext_help(menu, &help); + + buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_w)); + gtk_text_buffer_get_bounds(buffer, &start, &end); + gtk_text_buffer_delete(buffer, &start, &end); + gtk_text_view_set_left_margin(GTK_TEXT_VIEW(text_w), 15); + + gtk_text_buffer_get_end_iter(buffer, &end); + gtk_text_buffer_insert_with_tags(buffer, &end, prompt, -1, tag1, + NULL); + gtk_text_buffer_insert_at_cursor(buffer, "\n\n", 2); + gtk_text_buffer_get_end_iter(buffer, &end); + gtk_text_buffer_insert_with_tags(buffer, &end, str_get(&help), -1, tag2, + NULL); + str_free(&help); +} + + +static void text_insert_msg(const char *title, const char *message) +{ + GtkTextBuffer *buffer; + GtkTextIter start, end; + const char *msg = message; + + buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_w)); + gtk_text_buffer_get_bounds(buffer, &start, &end); + gtk_text_buffer_delete(buffer, &start, &end); + gtk_text_view_set_left_margin(GTK_TEXT_VIEW(text_w), 15); + + gtk_text_buffer_get_end_iter(buffer, &end); + gtk_text_buffer_insert_with_tags(buffer, &end, title, -1, tag1, + NULL); + gtk_text_buffer_insert_at_cursor(buffer, "\n\n", 2); + gtk_text_buffer_get_end_iter(buffer, &end); + gtk_text_buffer_insert_with_tags(buffer, &end, msg, -1, tag2, + NULL); +} + + +/* Main Windows Callbacks */ + +void on_save_activate(GtkMenuItem * menuitem, gpointer user_data); +gboolean on_window1_delete_event(GtkWidget * widget, GdkEvent * event, + gpointer user_data) +{ + GtkWidget *dialog, *label; + gint result; + + if (!conf_get_changed()) + return FALSE; + + dialog = gtk_dialog_new_with_buttons(_("Warning !"), + GTK_WINDOW(main_wnd), + (GtkDialogFlags) + (GTK_DIALOG_MODAL | + GTK_DIALOG_DESTROY_WITH_PARENT), + GTK_STOCK_OK, + GTK_RESPONSE_YES, + GTK_STOCK_NO, + GTK_RESPONSE_NO, + GTK_STOCK_CANCEL, + GTK_RESPONSE_CANCEL, NULL); + gtk_dialog_set_default_response(GTK_DIALOG(dialog), + GTK_RESPONSE_CANCEL); + + label = gtk_label_new(_("\nSave configuration ?\n")); + gtk_container_add(GTK_CONTAINER(GTK_DIALOG(dialog)->vbox), label); + gtk_widget_show(label); + + result = gtk_dialog_run(GTK_DIALOG(dialog)); + switch (result) { + case GTK_RESPONSE_YES: + on_save_activate(NULL, NULL); + return FALSE; + case GTK_RESPONSE_NO: + return FALSE; + case GTK_RESPONSE_CANCEL: + case GTK_RESPONSE_DELETE_EVENT: + default: + gtk_widget_destroy(dialog); + return TRUE; + } + + return FALSE; +} + + +void on_window1_destroy(GtkObject * object, gpointer user_data) +{ + gtk_main_quit(); +} + + +void +on_window1_size_request(GtkWidget * widget, + GtkRequisition * requisition, gpointer user_data) +{ + static gint old_h; + gint w, h; + + if (widget->window == NULL) + gtk_window_get_default_size(GTK_WINDOW(main_wnd), &w, &h); + else + gdk_window_get_size(widget->window, &w, &h); + + if (h == old_h) + return; + old_h = h; + + gtk_paned_set_position(GTK_PANED(vpaned), 2 * h / 3); +} + + +/* Menu & Toolbar Callbacks */ + + +static void +load_filename(GtkFileSelection * file_selector, gpointer user_data) +{ + const gchar *fn; + + fn = gtk_file_selection_get_filename(GTK_FILE_SELECTION + (user_data)); + + if (conf_read(fn)) + text_insert_msg(_("Error"), _("Unable to load configuration !")); + else + display_tree(&rootmenu); +} + +void on_load1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkWidget *fs; + + fs = gtk_file_selection_new(_("Load file...")); + g_signal_connect(GTK_OBJECT(GTK_FILE_SELECTION(fs)->ok_button), + "clicked", + G_CALLBACK(load_filename), (gpointer) fs); + g_signal_connect_swapped(GTK_OBJECT + (GTK_FILE_SELECTION(fs)->ok_button), + "clicked", G_CALLBACK(gtk_widget_destroy), + (gpointer) fs); + g_signal_connect_swapped(GTK_OBJECT + (GTK_FILE_SELECTION(fs)->cancel_button), + "clicked", G_CALLBACK(gtk_widget_destroy), + (gpointer) fs); + gtk_widget_show(fs); +} + + +void on_save_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + if (conf_write(NULL)) + text_insert_msg(_("Error"), _("Unable to save configuration !")); +} + + +static void +store_filename(GtkFileSelection * file_selector, gpointer user_data) +{ + const gchar *fn; + + fn = gtk_file_selection_get_filename(GTK_FILE_SELECTION + (user_data)); + + if (conf_write(fn)) + text_insert_msg(_("Error"), _("Unable to save configuration !")); + + gtk_widget_destroy(GTK_WIDGET(user_data)); +} + +void on_save_as1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkWidget *fs; + + fs = gtk_file_selection_new(_("Save file as...")); + g_signal_connect(GTK_OBJECT(GTK_FILE_SELECTION(fs)->ok_button), + "clicked", + G_CALLBACK(store_filename), (gpointer) fs); + g_signal_connect_swapped(GTK_OBJECT + (GTK_FILE_SELECTION(fs)->ok_button), + "clicked", G_CALLBACK(gtk_widget_destroy), + (gpointer) fs); + g_signal_connect_swapped(GTK_OBJECT + (GTK_FILE_SELECTION(fs)->cancel_button), + "clicked", G_CALLBACK(gtk_widget_destroy), + (gpointer) fs); + gtk_widget_show(fs); +} + + +void on_quit1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + if (!on_window1_delete_event(NULL, NULL, NULL)) + gtk_widget_destroy(GTK_WIDGET(main_wnd)); +} + + +void on_show_name1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkTreeViewColumn *col; + + show_name = GTK_CHECK_MENU_ITEM(menuitem)->active; + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), COL_NAME); + if (col) + gtk_tree_view_column_set_visible(col, show_name); +} + + +void on_show_range1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkTreeViewColumn *col; + + show_range = GTK_CHECK_MENU_ITEM(menuitem)->active; + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), COL_NO); + if (col) + gtk_tree_view_column_set_visible(col, show_range); + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), COL_MOD); + if (col) + gtk_tree_view_column_set_visible(col, show_range); + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), COL_YES); + if (col) + gtk_tree_view_column_set_visible(col, show_range); + +} + + +void on_show_data1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkTreeViewColumn *col; + + show_value = GTK_CHECK_MENU_ITEM(menuitem)->active; + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), COL_VALUE); + if (col) + gtk_tree_view_column_set_visible(col, show_value); +} + + +void +on_set_option_mode1_activate(GtkMenuItem *menuitem, gpointer user_data) +{ + opt_mode = OPT_NORMAL; + gtk_tree_store_clear(tree2); + display_tree(&rootmenu); /* instead of update_tree to speed-up */ +} + + +void +on_set_option_mode2_activate(GtkMenuItem *menuitem, gpointer user_data) +{ + opt_mode = OPT_ALL; + gtk_tree_store_clear(tree2); + display_tree(&rootmenu); /* instead of update_tree to speed-up */ +} + + +void +on_set_option_mode3_activate(GtkMenuItem *menuitem, gpointer user_data) +{ + opt_mode = OPT_PROMPT; + gtk_tree_store_clear(tree2); + display_tree(&rootmenu); /* instead of update_tree to speed-up */ +} + + +void on_introduction1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkWidget *dialog; + const gchar *intro_text = _( + "Welcome to gkc, the GTK+ graphical configuration tool\n" + "For each option, a blank box indicates the feature is disabled, a\n" + "check indicates it is enabled, and a dot indicates that it is to\n" + "be compiled as a module. Clicking on the box will cycle through the three states.\n" + "\n" + "If you do not see an option (e.g., a device driver) that you\n" + "believe should be present, try turning on Show All Options\n" + "under the Options menu.\n" + "Although there is no cross reference yet to help you figure out\n" + "what other options must be enabled to support the option you\n" + "are interested in, you can still view the help of a grayed-out\n" + "option.\n" + "\n" + "Toggling Show Debug Info under the Options menu will show \n" + "the dependencies, which you can then match by examining other options."); + + dialog = gtk_message_dialog_new(GTK_WINDOW(main_wnd), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_MESSAGE_INFO, + GTK_BUTTONS_CLOSE, "%s", intro_text); + g_signal_connect_swapped(GTK_OBJECT(dialog), "response", + G_CALLBACK(gtk_widget_destroy), + GTK_OBJECT(dialog)); + gtk_widget_show_all(dialog); +} + + +void on_about1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkWidget *dialog; + const gchar *about_text = + _("gkc is copyright (c) 2002 Romain Lievin .\n" + "Based on the source code from Roman Zippel.\n"); + + dialog = gtk_message_dialog_new(GTK_WINDOW(main_wnd), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_MESSAGE_INFO, + GTK_BUTTONS_CLOSE, "%s", about_text); + g_signal_connect_swapped(GTK_OBJECT(dialog), "response", + G_CALLBACK(gtk_widget_destroy), + GTK_OBJECT(dialog)); + gtk_widget_show_all(dialog); +} + + +void on_license1_activate(GtkMenuItem * menuitem, gpointer user_data) +{ + GtkWidget *dialog; + const gchar *license_text = + _("gkc is released under the terms of the GNU GPL v2.\n" + "For more information, please see the source code or\n" + "visit http://www.fsf.org/licenses/licenses.html\n"); + + dialog = gtk_message_dialog_new(GTK_WINDOW(main_wnd), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_MESSAGE_INFO, + GTK_BUTTONS_CLOSE, "%s", license_text); + g_signal_connect_swapped(GTK_OBJECT(dialog), "response", + G_CALLBACK(gtk_widget_destroy), + GTK_OBJECT(dialog)); + gtk_widget_show_all(dialog); +} + + +void on_back_clicked(GtkButton * button, gpointer user_data) +{ + enum prop_type ptype; + + current = current->parent; + ptype = current->prompt ? current->prompt->type : P_UNKNOWN; + if (ptype != P_MENU) + current = current->parent; + display_tree_part(); + + if (current == &rootmenu) + gtk_widget_set_sensitive(back_btn, FALSE); +} + + +void on_load_clicked(GtkButton * button, gpointer user_data) +{ + on_load1_activate(NULL, user_data); +} + + +void on_single_clicked(GtkButton * button, gpointer user_data) +{ + view_mode = SINGLE_VIEW; + gtk_widget_hide(tree1_w); + current = &rootmenu; + display_tree_part(); +} + + +void on_split_clicked(GtkButton * button, gpointer user_data) +{ + gint w, h; + view_mode = SPLIT_VIEW; + gtk_widget_show(tree1_w); + gtk_window_get_default_size(GTK_WINDOW(main_wnd), &w, &h); + gtk_paned_set_position(GTK_PANED(hpaned), w / 2); + if (tree2) + gtk_tree_store_clear(tree2); + display_list(); + + /* Disable back btn, like in full mode. */ + gtk_widget_set_sensitive(back_btn, FALSE); +} + + +void on_full_clicked(GtkButton * button, gpointer user_data) +{ + view_mode = FULL_VIEW; + gtk_widget_hide(tree1_w); + if (tree2) + gtk_tree_store_clear(tree2); + display_tree(&rootmenu); + gtk_widget_set_sensitive(back_btn, FALSE); +} + + +void on_collapse_clicked(GtkButton * button, gpointer user_data) +{ + gtk_tree_view_collapse_all(GTK_TREE_VIEW(tree2_w)); +} + + +void on_expand_clicked(GtkButton * button, gpointer user_data) +{ + gtk_tree_view_expand_all(GTK_TREE_VIEW(tree2_w)); +} + + +/* CTree Callbacks */ + +/* Change hex/int/string value in the cell */ +static void renderer_edited(GtkCellRendererText * cell, + const gchar * path_string, + const gchar * new_text, gpointer user_data) +{ + GtkTreePath *path = gtk_tree_path_new_from_string(path_string); + GtkTreeIter iter; + const char *old_def, *new_def; + struct menu *menu; + struct symbol *sym; + + if (!gtk_tree_model_get_iter(model2, &iter, path)) + return; + + gtk_tree_model_get(model2, &iter, COL_MENU, &menu, -1); + sym = menu->sym; + + gtk_tree_model_get(model2, &iter, COL_VALUE, &old_def, -1); + new_def = new_text; + + sym_set_string_value(sym, new_def); + + update_tree(&rootmenu, NULL); + + gtk_tree_path_free(path); +} + +/* Change the value of a symbol and update the tree */ +static void change_sym_value(struct menu *menu, gint col) +{ + struct symbol *sym = menu->sym; + tristate newval; + + if (!sym) + return; + + if (col == COL_NO) + newval = no; + else if (col == COL_MOD) + newval = mod; + else if (col == COL_YES) + newval = yes; + else + return; + + switch (sym_get_type(sym)) { + case S_BOOLEAN: + case S_TRISTATE: + if (!sym_tristate_within_range(sym, newval)) + newval = yes; + sym_set_tristate_value(sym, newval); + if (view_mode == FULL_VIEW) + update_tree(&rootmenu, NULL); + else if (view_mode == SPLIT_VIEW) { + update_tree(browsed, NULL); + display_list(); + } + else if (view_mode == SINGLE_VIEW) + display_tree_part(); //fixme: keep exp/coll + break; + case S_INT: + case S_HEX: + case S_STRING: + default: + break; + } +} + +static void toggle_sym_value(struct menu *menu) +{ + if (!menu->sym) + return; + + sym_toggle_tristate_value(menu->sym); + if (view_mode == FULL_VIEW) + update_tree(&rootmenu, NULL); + else if (view_mode == SPLIT_VIEW) { + update_tree(browsed, NULL); + display_list(); + } + else if (view_mode == SINGLE_VIEW) + display_tree_part(); //fixme: keep exp/coll +} + +static gint column2index(GtkTreeViewColumn * column) +{ + gint i; + + for (i = 0; i < COL_NUMBER; i++) { + GtkTreeViewColumn *col; + + col = gtk_tree_view_get_column(GTK_TREE_VIEW(tree2_w), i); + if (col == column) + return i; + } + + return -1; +} + + +/* User click: update choice (full) or goes down (single) */ +gboolean +on_treeview2_button_press_event(GtkWidget * widget, + GdkEventButton * event, gpointer user_data) +{ + GtkTreeView *view = GTK_TREE_VIEW(widget); + GtkTreePath *path; + GtkTreeViewColumn *column; + GtkTreeIter iter; + struct menu *menu; + gint col; + +#if GTK_CHECK_VERSION(2,1,4) // bug in ctree with earlier version of GTK + gint tx = (gint) event->x; + gint ty = (gint) event->y; + gint cx, cy; + + gtk_tree_view_get_path_at_pos(view, tx, ty, &path, &column, &cx, + &cy); +#else + gtk_tree_view_get_cursor(view, &path, &column); +#endif + if (path == NULL) + return FALSE; + + if (!gtk_tree_model_get_iter(model2, &iter, path)) + return FALSE; + gtk_tree_model_get(model2, &iter, COL_MENU, &menu, -1); + + col = column2index(column); + if (event->type == GDK_2BUTTON_PRESS) { + enum prop_type ptype; + ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN; + + if (ptype == P_MENU && view_mode != FULL_VIEW && col == COL_OPTION) { + // goes down into menu + current = menu; + display_tree_part(); + gtk_widget_set_sensitive(back_btn, TRUE); + } else if ((col == COL_OPTION)) { + toggle_sym_value(menu); + gtk_tree_view_expand_row(view, path, TRUE); + } + } else { + if (col == COL_VALUE) { + toggle_sym_value(menu); + gtk_tree_view_expand_row(view, path, TRUE); + } else if (col == COL_NO || col == COL_MOD + || col == COL_YES) { + change_sym_value(menu, col); + gtk_tree_view_expand_row(view, path, TRUE); + } + } + + return FALSE; +} + +/* Key pressed: update choice */ +gboolean +on_treeview2_key_press_event(GtkWidget * widget, + GdkEventKey * event, gpointer user_data) +{ + GtkTreeView *view = GTK_TREE_VIEW(widget); + GtkTreePath *path; + GtkTreeViewColumn *column; + GtkTreeIter iter; + struct menu *menu; + gint col; + + gtk_tree_view_get_cursor(view, &path, &column); + if (path == NULL) + return FALSE; + + if (event->keyval == GDK_space) { + if (gtk_tree_view_row_expanded(view, path)) + gtk_tree_view_collapse_row(view, path); + else + gtk_tree_view_expand_row(view, path, FALSE); + return TRUE; + } + if (event->keyval == GDK_KP_Enter) { + } + if (widget == tree1_w) + return FALSE; + + gtk_tree_model_get_iter(model2, &iter, path); + gtk_tree_model_get(model2, &iter, COL_MENU, &menu, -1); + + if (!strcasecmp(event->string, "n")) + col = COL_NO; + else if (!strcasecmp(event->string, "m")) + col = COL_MOD; + else if (!strcasecmp(event->string, "y")) + col = COL_YES; + else + col = -1; + change_sym_value(menu, col); + + return FALSE; +} + + +/* Row selection changed: update help */ +void +on_treeview2_cursor_changed(GtkTreeView * treeview, gpointer user_data) +{ + GtkTreeSelection *selection; + GtkTreeIter iter; + struct menu *menu; + + selection = gtk_tree_view_get_selection(treeview); + if (gtk_tree_selection_get_selected(selection, &model2, &iter)) { + gtk_tree_model_get(model2, &iter, COL_MENU, &menu, -1); + text_insert_help(menu); + } +} + + +/* User click: display sub-tree in the right frame. */ +gboolean +on_treeview1_button_press_event(GtkWidget * widget, + GdkEventButton * event, gpointer user_data) +{ + GtkTreeView *view = GTK_TREE_VIEW(widget); + GtkTreePath *path; + GtkTreeViewColumn *column; + GtkTreeIter iter; + struct menu *menu; + + gint tx = (gint) event->x; + gint ty = (gint) event->y; + gint cx, cy; + + gtk_tree_view_get_path_at_pos(view, tx, ty, &path, &column, &cx, + &cy); + if (path == NULL) + return FALSE; + + gtk_tree_model_get_iter(model1, &iter, path); + gtk_tree_model_get(model1, &iter, COL_MENU, &menu, -1); + + if (event->type == GDK_2BUTTON_PRESS) { + toggle_sym_value(menu); + current = menu; + display_tree_part(); + } else { + browsed = menu; + display_tree_part(); + } + + gtk_widget_realize(tree2_w); + gtk_tree_view_set_cursor(view, path, NULL, FALSE); + gtk_widget_grab_focus(tree2_w); + + return FALSE; +} + + +/* Fill a row of strings */ +static gchar **fill_row(struct menu *menu) +{ + static gchar *row[COL_NUMBER]; + struct symbol *sym = menu->sym; + const char *def; + int stype; + tristate val; + enum prop_type ptype; + int i; + + for (i = COL_OPTION; i <= COL_COLOR; i++) + g_free(row[i]); + bzero(row, sizeof(row)); + + row[COL_OPTION] = + g_strdup_printf("%s %s", _(menu_get_prompt(menu)), + sym && !sym_has_value(sym) ? "(NEW)" : ""); + + if (opt_mode == OPT_ALL && !menu_is_visible(menu)) + row[COL_COLOR] = g_strdup("DarkGray"); + else if (opt_mode == OPT_PROMPT && + menu_has_prompt(menu) && !menu_is_visible(menu)) + row[COL_COLOR] = g_strdup("DarkGray"); + else + row[COL_COLOR] = g_strdup("Black"); + + ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN; + switch (ptype) { + case P_MENU: + row[COL_PIXBUF] = (gchar *) xpm_menu; + if (view_mode == SINGLE_VIEW) + row[COL_PIXVIS] = GINT_TO_POINTER(TRUE); + row[COL_BTNVIS] = GINT_TO_POINTER(FALSE); + break; + case P_COMMENT: + row[COL_PIXBUF] = (gchar *) xpm_void; + row[COL_PIXVIS] = GINT_TO_POINTER(FALSE); + row[COL_BTNVIS] = GINT_TO_POINTER(FALSE); + break; + default: + row[COL_PIXBUF] = (gchar *) xpm_void; + row[COL_PIXVIS] = GINT_TO_POINTER(FALSE); + row[COL_BTNVIS] = GINT_TO_POINTER(TRUE); + break; + } + + if (!sym) + return row; + row[COL_NAME] = g_strdup(sym->name); + + sym_calc_value(sym); + sym->flags &= ~SYMBOL_CHANGED; + + if (sym_is_choice(sym)) { // parse childs for getting final value + struct menu *child; + struct symbol *def_sym = sym_get_choice_value(sym); + struct menu *def_menu = NULL; + + row[COL_BTNVIS] = GINT_TO_POINTER(FALSE); + + for (child = menu->list; child; child = child->next) { + if (menu_is_visible(child) + && child->sym == def_sym) + def_menu = child; + } + + if (def_menu) + row[COL_VALUE] = + g_strdup(_(menu_get_prompt(def_menu))); + } + if (sym->flags & SYMBOL_CHOICEVAL) + row[COL_BTNRAD] = GINT_TO_POINTER(TRUE); + + stype = sym_get_type(sym); + switch (stype) { + case S_BOOLEAN: + if (GPOINTER_TO_INT(row[COL_PIXVIS]) == FALSE) + row[COL_BTNVIS] = GINT_TO_POINTER(TRUE); + if (sym_is_choice(sym)) + break; + /* fall through */ + case S_TRISTATE: + val = sym_get_tristate_value(sym); + switch (val) { + case no: + row[COL_NO] = g_strdup("N"); + row[COL_VALUE] = g_strdup("N"); + row[COL_BTNACT] = GINT_TO_POINTER(FALSE); + row[COL_BTNINC] = GINT_TO_POINTER(FALSE); + break; + case mod: + row[COL_MOD] = g_strdup("M"); + row[COL_VALUE] = g_strdup("M"); + row[COL_BTNINC] = GINT_TO_POINTER(TRUE); + break; + case yes: + row[COL_YES] = g_strdup("Y"); + row[COL_VALUE] = g_strdup("Y"); + row[COL_BTNACT] = GINT_TO_POINTER(TRUE); + row[COL_BTNINC] = GINT_TO_POINTER(FALSE); + break; + } + + if (val != no && sym_tristate_within_range(sym, no)) + row[COL_NO] = g_strdup("_"); + if (val != mod && sym_tristate_within_range(sym, mod)) + row[COL_MOD] = g_strdup("_"); + if (val != yes && sym_tristate_within_range(sym, yes)) + row[COL_YES] = g_strdup("_"); + break; + case S_INT: + case S_HEX: + case S_STRING: + def = sym_get_string_value(sym); + row[COL_VALUE] = g_strdup(def); + row[COL_EDIT] = GINT_TO_POINTER(TRUE); + row[COL_BTNVIS] = GINT_TO_POINTER(FALSE); + break; + } + + return row; +} + + +/* Set the node content with a row of strings */ +static void set_node(GtkTreeIter * node, struct menu *menu, gchar ** row) +{ + GdkColor color; + gboolean success; + GdkPixbuf *pix; + + pix = gdk_pixbuf_new_from_xpm_data((const char **) + row[COL_PIXBUF]); + + gdk_color_parse(row[COL_COLOR], &color); + gdk_colormap_alloc_colors(gdk_colormap_get_system(), &color, 1, + FALSE, FALSE, &success); + + gtk_tree_store_set(tree, node, + COL_OPTION, row[COL_OPTION], + COL_NAME, row[COL_NAME], + COL_NO, row[COL_NO], + COL_MOD, row[COL_MOD], + COL_YES, row[COL_YES], + COL_VALUE, row[COL_VALUE], + COL_MENU, (gpointer) menu, + COL_COLOR, &color, + COL_EDIT, GPOINTER_TO_INT(row[COL_EDIT]), + COL_PIXBUF, pix, + COL_PIXVIS, GPOINTER_TO_INT(row[COL_PIXVIS]), + COL_BTNVIS, GPOINTER_TO_INT(row[COL_BTNVIS]), + COL_BTNACT, GPOINTER_TO_INT(row[COL_BTNACT]), + COL_BTNINC, GPOINTER_TO_INT(row[COL_BTNINC]), + COL_BTNRAD, GPOINTER_TO_INT(row[COL_BTNRAD]), + -1); + + g_object_unref(pix); +} + + +/* Add a node to the tree */ +static void place_node(struct menu *menu, char **row) +{ + GtkTreeIter *parent = parents[indent - 1]; + GtkTreeIter *node = parents[indent]; + + gtk_tree_store_append(tree, node, parent); + set_node(node, menu, row); +} + + +/* Find a node in the GTK+ tree */ +static GtkTreeIter found; + +/* + * Find a menu in the GtkTree starting at parent. + */ +GtkTreeIter *gtktree_iter_find_node(GtkTreeIter * parent, + struct menu *tofind) +{ + GtkTreeIter iter; + GtkTreeIter *child = &iter; + gboolean valid; + GtkTreeIter *ret; + + valid = gtk_tree_model_iter_children(model2, child, parent); + while (valid) { + struct menu *menu; + + gtk_tree_model_get(model2, child, 6, &menu, -1); + + if (menu == tofind) { + memcpy(&found, child, sizeof(GtkTreeIter)); + return &found; + } + + ret = gtktree_iter_find_node(child, tofind); + if (ret) + return ret; + + valid = gtk_tree_model_iter_next(model2, child); + } + + return NULL; +} + + +/* + * Update the tree by adding/removing entries + * Does not change other nodes + */ +static void update_tree(struct menu *src, GtkTreeIter * dst) +{ + struct menu *child1; + GtkTreeIter iter, tmp; + GtkTreeIter *child2 = &iter; + gboolean valid; + GtkTreeIter *sibling; + struct symbol *sym; + struct menu *menu1, *menu2; + + if (src == &rootmenu) + indent = 1; + + valid = gtk_tree_model_iter_children(model2, child2, dst); + for (child1 = src->list; child1; child1 = child1->next) { + + sym = child1->sym; + + reparse: + menu1 = child1; + if (valid) + gtk_tree_model_get(model2, child2, COL_MENU, + &menu2, -1); + else + menu2 = NULL; // force adding of a first child + +#ifdef DEBUG + printf("%*c%s | %s\n", indent, ' ', + menu1 ? menu_get_prompt(menu1) : "nil", + menu2 ? menu_get_prompt(menu2) : "nil"); +#endif + + if ((opt_mode == OPT_NORMAL && !menu_is_visible(child1)) || + (opt_mode == OPT_PROMPT && !menu_has_prompt(child1)) || + (opt_mode == OPT_ALL && !menu_get_prompt(child1))) { + + /* remove node */ + if (gtktree_iter_find_node(dst, menu1) != NULL) { + memcpy(&tmp, child2, sizeof(GtkTreeIter)); + valid = gtk_tree_model_iter_next(model2, + child2); + gtk_tree_store_remove(tree2, &tmp); + if (!valid) + return; /* next parent */ + else + goto reparse; /* next child */ + } else + continue; + } + + if (menu1 != menu2) { + if (gtktree_iter_find_node(dst, menu1) == NULL) { // add node + if (!valid && !menu2) + sibling = NULL; + else + sibling = child2; + gtk_tree_store_insert_before(tree2, + child2, + dst, sibling); + set_node(child2, menu1, fill_row(menu1)); + if (menu2 == NULL) + valid = TRUE; + } else { // remove node + memcpy(&tmp, child2, sizeof(GtkTreeIter)); + valid = gtk_tree_model_iter_next(model2, + child2); + gtk_tree_store_remove(tree2, &tmp); + if (!valid) + return; // next parent + else + goto reparse; // next child + } + } else if (sym && (sym->flags & SYMBOL_CHANGED)) { + set_node(child2, menu1, fill_row(menu1)); + } + + indent++; + update_tree(child1, child2); + indent--; + + valid = gtk_tree_model_iter_next(model2, child2); + } +} + + +/* Display the whole tree (single/split/full view) */ +static void display_tree(struct menu *menu) +{ + struct symbol *sym; + struct property *prop; + struct menu *child; + enum prop_type ptype; + + if (menu == &rootmenu) { + indent = 1; + current = &rootmenu; + } + + for (child = menu->list; child; child = child->next) { + prop = child->prompt; + sym = child->sym; + ptype = prop ? prop->type : P_UNKNOWN; + + if (sym) + sym->flags &= ~SYMBOL_CHANGED; + + if ((view_mode == SPLIT_VIEW) + && !(child->flags & MENU_ROOT) && (tree == tree1)) + continue; + + if ((view_mode == SPLIT_VIEW) && (child->flags & MENU_ROOT) + && (tree == tree2)) + continue; + + if ((opt_mode == OPT_NORMAL && menu_is_visible(child)) || + (opt_mode == OPT_PROMPT && menu_has_prompt(child)) || + (opt_mode == OPT_ALL && menu_get_prompt(child))) + place_node(child, fill_row(child)); +#ifdef DEBUG + printf("%*c%s: ", indent, ' ', menu_get_prompt(child)); + printf("%s", child->flags & MENU_ROOT ? "rootmenu | " : ""); + printf("%s", prop_get_type_name(ptype)); + printf(" | "); + if (sym) { + printf("%s", sym_type_name(sym->type)); + printf(" | "); + printf("%s", dbg_sym_flags(sym->flags)); + printf("\n"); + } else + printf("\n"); +#endif + if ((view_mode != FULL_VIEW) && (ptype == P_MENU) + && (tree == tree2)) + continue; +/* + if (((menu != &rootmenu) && !(menu->flags & MENU_ROOT)) + || (view_mode == FULL_VIEW) + || (view_mode == SPLIT_VIEW))*/ + + /* Change paned position if the view is not in 'split mode' */ + if (view_mode == SINGLE_VIEW || view_mode == FULL_VIEW) { + gtk_paned_set_position(GTK_PANED(hpaned), 0); + } + + if (((view_mode == SINGLE_VIEW) && (menu->flags & MENU_ROOT)) + || (view_mode == FULL_VIEW) + || (view_mode == SPLIT_VIEW)) { + indent++; + display_tree(child); + indent--; + } + } +} + +/* Display a part of the tree starting at current node (single/split view) */ +static void display_tree_part(void) +{ + if (tree2) + gtk_tree_store_clear(tree2); + if (view_mode == SINGLE_VIEW) + display_tree(current); + else if (view_mode == SPLIT_VIEW) + display_tree(browsed); + gtk_tree_view_expand_all(GTK_TREE_VIEW(tree2_w)); +} + +/* Display the list in the left frame (split view) */ +static void display_list(void) +{ + if (tree1) + gtk_tree_store_clear(tree1); + + tree = tree1; + display_tree(&rootmenu); + gtk_tree_view_expand_all(GTK_TREE_VIEW(tree1_w)); + tree = tree2; +} + +void fixup_rootmenu(struct menu *menu) +{ + struct menu *child; + static int menu_cnt = 0; + + menu->flags |= MENU_ROOT; + for (child = menu->list; child; child = child->next) { + if (child->prompt && child->prompt->type == P_MENU) { + menu_cnt++; + fixup_rootmenu(child); + menu_cnt--; + } else if (!menu_cnt) + fixup_rootmenu(child); + } +} + + +/* Main */ +int main(int ac, char *av[]) +{ + const char *name; + char *env; + gchar *glade_file; + + bindtextdomain(PACKAGE, LOCALEDIR); + bind_textdomain_codeset(PACKAGE, "UTF-8"); + textdomain(PACKAGE); + + /* GTK stuffs */ + gtk_set_locale(); + gtk_init(&ac, &av); + glade_init(); + + //add_pixmap_directory (PACKAGE_DATA_DIR "/" PACKAGE "/pixmaps"); + //add_pixmap_directory (PACKAGE_SOURCE_DIR "/pixmaps"); + + /* Determine GUI path */ + env = getenv(SRCTREE); + if (env) + glade_file = g_strconcat(env, "/scripts/kconfig/gconf.glade", NULL); + else if (av[0][0] == '/') + glade_file = g_strconcat(av[0], ".glade", NULL); + else + glade_file = g_strconcat(g_get_current_dir(), "/", av[0], ".glade", NULL); + + /* Conf stuffs */ + if (ac > 1 && av[1][0] == '-') { + switch (av[1][1]) { + case 'a': + //showAll = 1; + break; + case 's': + conf_set_message_callback(NULL); + break; + case 'h': + case '?': + printf("%s [-s] \n", av[0]); + exit(0); + } + name = av[2]; + } else + name = av[1]; + + conf_parse(name); + fixup_rootmenu(&rootmenu); + conf_read(NULL); + + /* Load the interface and connect signals */ + init_main_window(glade_file); + init_tree_model(); + init_left_tree(); + init_right_tree(); + + switch (view_mode) { + case SINGLE_VIEW: + display_tree_part(); + break; + case SPLIT_VIEW: + display_list(); + break; + case FULL_VIEW: + display_tree(&rootmenu); + break; + } + + gtk_main(); + + return 0; +} + +static void conf_changed(void) +{ + bool changed = conf_get_changed(); + gtk_widget_set_sensitive(save_btn, changed); + gtk_widget_set_sensitive(save_menu_item, changed); +} diff --git a/tools/kconfig/gconf.glade b/tools/kconfig/gconf.glade new file mode 100644 index 000000000..aa483cb32 --- /dev/null +++ b/tools/kconfig/gconf.glade @@ -0,0 +1,661 @@ + + + + + + True + Gtk Kernel Configurator + GTK_WINDOW_TOPLEVEL + GTK_WIN_POS_NONE + False + 640 + 480 + True + False + True + False + False + GDK_WINDOW_TYPE_HINT_NORMAL + GDK_GRAVITY_NORTH_WEST + + + + + + + True + False + 0 + + + + True + + + + True + _File + True + + + + + + + True + Load a config file + _Load + True + + + + + + True + gtk-open + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + True + Save the config in .config + _Save + True + + + + + + True + gtk-save + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + True + Save the config in a file + Save _as + True + + + + + True + gtk-save-as + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + True + + + + + + True + _Quit + True + + + + + + True + gtk-quit + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + + + + + True + _Options + True + + + + + + + True + Show name + Show _name + True + False + + + + + + + True + Show range (Y/M/N) + Show _range + True + False + + + + + + + True + Show value of the option + Show _data + True + False + + + + + + + True + + + + + + True + Show normal options + Show normal options + True + True + + + + + + + True + Show all options + Show all _options + True + False + set_option_mode1 + + + + + + + True + Show all options with prompts + Show all prompt options + True + False + set_option_mode1 + + + + + + + + + + + + True + _Help + True + + + + + + + True + _Introduction + True + + + + + + True + gtk-dialog-question + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + True + _About + True + + + + + + True + gtk-properties + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + True + _License + True + + + + + True + gtk-justify-fill + 1 + 0.5 + 0.5 + 0 + 0 + + + + + + + + + + + 0 + False + False + + + + + + True + GTK_SHADOW_OUT + GTK_POS_LEFT + GTK_POS_TOP + + + + True + GTK_ORIENTATION_HORIZONTAL + GTK_TOOLBAR_BOTH + True + True + + + + True + Goes up of one level (single view) + Back + True + gtk-undo + True + True + False + + + + False + True + + + + + + True + True + True + False + + + + True + + + + + False + False + + + + + + True + Load a config file + Load + True + gtk-open + True + True + False + + + + False + True + + + + + + True + Save a config file + Save + True + gtk-save + True + True + False + + + + False + True + + + + + + True + True + True + False + + + + True + + + + + False + False + + + + + + True + Single view + Single + True + gtk-missing-image + True + True + False + + + + False + True + + + + + + True + Split view + Split + True + gtk-missing-image + True + True + False + + + + False + True + + + + + + True + Full view + Full + True + gtk-missing-image + True + True + False + + + + False + True + + + + + + True + True + True + False + + + + True + + + + + False + False + + + + + + True + Collapse the whole tree in the right frame + Collapse + True + gtk-remove + True + True + False + + + + False + True + + + + + + True + Expand the whole tree in the right frame + Expand + True + gtk-add + True + True + False + + + + False + True + + + + + + + 0 + False + False + + + + + + 1 + True + True + 0 + + + + True + GTK_POLICY_AUTOMATIC + GTK_POLICY_AUTOMATIC + GTK_SHADOW_IN + GTK_CORNER_TOP_LEFT + + + + True + True + True + False + False + False + + + + + + + + True + False + + + + + + True + True + 0 + + + + True + GTK_POLICY_AUTOMATIC + GTK_POLICY_AUTOMATIC + GTK_SHADOW_IN + GTK_CORNER_TOP_LEFT + + + + True + True + True + True + False + False + False + + + + + + + + True + False + + + + + + True + GTK_POLICY_NEVER + GTK_POLICY_AUTOMATIC + GTK_SHADOW_IN + GTK_CORNER_TOP_LEFT + + + + True + True + False + False + True + GTK_JUSTIFY_LEFT + GTK_WRAP_WORD + True + 0 + 0 + 0 + 0 + 0 + 0 + Sorry, no help available for this option yet. + + + + + True + True + + + + + True + True + + + + + 0 + True + True + + + + + + + diff --git a/tools/kconfig/images.c b/tools/kconfig/images.c new file mode 100644 index 000000000..d4f84bd4a --- /dev/null +++ b/tools/kconfig/images.c @@ -0,0 +1,326 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +static const char *xpm_load[] = { +"22 22 5 1", +". c None", +"# c #000000", +"c c #838100", +"a c #ffff00", +"b c #ffffff", +"......................", +"......................", +"......................", +"............####....#.", +"...........#....##.##.", +"..................###.", +".................####.", +".####...........#####.", +"#abab##########.......", +"#babababababab#.......", +"#ababababababa#.......", +"#babababababab#.......", +"#ababab###############", +"#babab##cccccccccccc##", +"#abab##cccccccccccc##.", +"#bab##cccccccccccc##..", +"#ab##cccccccccccc##...", +"#b##cccccccccccc##....", +"###cccccccccccc##.....", +"##cccccccccccc##......", +"###############.......", +"......................"}; + +static const char *xpm_save[] = { +"22 22 5 1", +". c None", +"# c #000000", +"a c #838100", +"b c #c5c2c5", +"c c #cdb6d5", +"......................", +".####################.", +".#aa#bbbbbbbbbbbb#bb#.", +".#aa#bbbbbbbbbbbb#bb#.", +".#aa#bbbbbbbbbcbb####.", +".#aa#bbbccbbbbbbb#aa#.", +".#aa#bbbccbbbbbbb#aa#.", +".#aa#bbbbbbbbbbbb#aa#.", +".#aa#bbbbbbbbbbbb#aa#.", +".#aa#bbbbbbbbbbbb#aa#.", +".#aa#bbbbbbbbbbbb#aa#.", +".#aaa############aaa#.", +".#aaaaaaaaaaaaaaaaaa#.", +".#aaaaaaaaaaaaaaaaaa#.", +".#aaa#############aa#.", +".#aaa#########bbb#aa#.", +".#aaa#########bbb#aa#.", +".#aaa#########bbb#aa#.", +".#aaa#########bbb#aa#.", +".#aaa#########bbb#aa#.", +"..##################..", +"......................"}; + +static const char *xpm_back[] = { +"22 22 3 1", +". c None", +"# c #000083", +"a c #838183", +"......................", +"......................", +"......................", +"......................", +"......................", +"...........######a....", +"..#......##########...", +"..##...####......##a..", +"..###.###.........##..", +"..######..........##..", +"..#####...........##..", +"..######..........##..", +"..#######.........##..", +"..########.......##a..", +"...............a###...", +"...............###....", +"......................", +"......................", +"......................", +"......................", +"......................", +"......................"}; + +static const char *xpm_tree_view[] = { +"22 22 2 1", +". c None", +"# c #000000", +"......................", +"......................", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......########........", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......########........", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......#...............", +"......########........", +"......................", +"......................"}; + +static const char *xpm_single_view[] = { +"22 22 2 1", +". c None", +"# c #000000", +"......................", +"......................", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"..........#...........", +"......................", +"......................"}; + +static const char *xpm_split_view[] = { +"22 22 2 1", +". c None", +"# c #000000", +"......................", +"......................", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......#......#........", +"......................", +"......................"}; + +static const char *xpm_symbol_no[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" .......... ", +" "}; + +static const char *xpm_symbol_mod[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" . . ", +" . . ", +" . .. . ", +" . .... . ", +" . .... . ", +" . .. . ", +" . . ", +" . . ", +" .......... ", +" "}; + +static const char *xpm_symbol_yes[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" . . ", +" . . ", +" . . . ", +" . .. . ", +" . . .. . ", +" . .... . ", +" . .. . ", +" . . ", +" .......... ", +" "}; + +static const char *xpm_choice_no[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .... ", +" .. .. ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" . . ", +" .. .. ", +" .... ", +" "}; + +static const char *xpm_choice_yes[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .... ", +" .. .. ", +" . . ", +" . .. . ", +" . .... . ", +" . .... . ", +" . .. . ", +" . . ", +" .. .. ", +" .... ", +" "}; + +static const char *xpm_menu[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" . . ", +" . .. . ", +" . .... . ", +" . ...... . ", +" . ...... . ", +" . .... . ", +" . .. . ", +" . . ", +" .......... ", +" "}; + +static const char *xpm_menu_inv[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" .......... ", +" .. ...... ", +" .. .... ", +" .. .. ", +" .. .. ", +" .. .... ", +" .. ...... ", +" .......... ", +" .......... ", +" "}; + +static const char *xpm_menuback[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" .......... ", +" . . ", +" . .. . ", +" . .... . ", +" . ...... . ", +" . ...... . ", +" . .... . ", +" . .. . ", +" . . ", +" .......... ", +" "}; + +static const char *xpm_void[] = { +"12 12 2 1", +" c white", +". c black", +" ", +" ", +" ", +" ", +" ", +" ", +" ", +" ", +" ", +" ", +" ", +" "}; diff --git a/tools/kconfig/kconfig-language.txt b/tools/kconfig/kconfig-language.txt new file mode 100644 index 000000000..c52856da0 --- /dev/null +++ b/tools/kconfig/kconfig-language.txt @@ -0,0 +1,556 @@ +Introduction +------------ + +The configuration database is a collection of configuration options +organized in a tree structure: + + +- Code maturity level options + | +- Prompt for development and/or incomplete code/drivers + +- General setup + | +- Networking support + | +- System V IPC + | +- BSD Process Accounting + | +- Sysctl support + +- Loadable module support + | +- Enable loadable module support + | +- Set version information on all module symbols + | +- Kernel module loader + +- ... + +Every entry has its own dependencies. These dependencies are used +to determine the visibility of an entry. Any child entry is only +visible if its parent entry is also visible. + +Menu entries +------------ + +Most entries define a config option; all other entries help to organize +them. A single configuration option is defined like this: + +config MODVERSIONS + bool "Set version information on all module symbols" + depends on MODULES + help + Usually, modules have to be recompiled whenever you switch to a new + kernel. ... + +Every line starts with a key word and can be followed by multiple +arguments. "config" starts a new config entry. The following lines +define attributes for this config option. Attributes can be the type of +the config option, input prompt, dependencies, help text and default +values. A config option can be defined multiple times with the same +name, but every definition can have only a single input prompt and the +type must not conflict. + +Menu attributes +--------------- + +A menu entry can have a number of attributes. Not all of them are +applicable everywhere (see syntax). + +- type definition: "bool"/"tristate"/"string"/"hex"/"int" + Every config option must have a type. There are only two basic types: + tristate and string; the other types are based on these two. The type + definition optionally accepts an input prompt, so these two examples + are equivalent: + + bool "Networking support" + and + bool + prompt "Networking support" + +- input prompt: "prompt" ["if" ] + Every menu entry can have at most one prompt, which is used to display + to the user. Optionally dependencies only for this prompt can be added + with "if". + +- default value: "default" ["if" ] + A config option can have any number of default values. If multiple + default values are visible, only the first defined one is active. + Default values are not limited to the menu entry where they are + defined. This means the default can be defined somewhere else or be + overridden by an earlier definition. + The default value is only assigned to the config symbol if no other + value was set by the user (via the input prompt above). If an input + prompt is visible the default value is presented to the user and can + be overridden by him. + Optionally, dependencies only for this default value can be added with + "if". + +- type definition + default value: + "def_bool"/"def_tristate" ["if" ] + This is a shorthand notation for a type definition plus a value. + Optionally dependencies for this default value can be added with "if". + +- dependencies: "depends on" + This defines a dependency for this menu entry. If multiple + dependencies are defined, they are connected with '&&'. Dependencies + are applied to all other options within this menu entry (which also + accept an "if" expression), so these two examples are equivalent: + + bool "foo" if BAR + default y if BAR + and + depends on BAR + bool "foo" + default y + +- reverse dependencies: "select" ["if" ] + While normal dependencies reduce the upper limit of a symbol (see + below), reverse dependencies can be used to force a lower limit of + another symbol. The value of the current menu symbol is used as the + minimal value can be set to. If is selected multiple + times, the limit is set to the largest selection. + Reverse dependencies can only be used with boolean or tristate + symbols. + Note: + select should be used with care. select will force + a symbol to a value without visiting the dependencies. + By abusing select you are able to select a symbol FOO even + if FOO depends on BAR that is not set. + In general use select only for non-visible symbols + (no prompts anywhere) and for symbols with no dependencies. + That will limit the usefulness but on the other hand avoid + the illegal configurations all over. + +- limiting menu display: "visible if" + This attribute is only applicable to menu blocks, if the condition is + false, the menu block is not displayed to the user (the symbols + contained there can still be selected by other symbols, though). It is + similar to a conditional "prompt" attribute for individual menu + entries. Default value of "visible" is true. + +- numerical ranges: "range" ["if" ] + This allows to limit the range of possible input values for int + and hex symbols. The user can only input a value which is larger than + or equal to the first symbol and smaller than or equal to the second + symbol. + +- help text: "help" or "---help---" + This defines a help text. The end of the help text is determined by + the indentation level, this means it ends at the first line which has + a smaller indentation than the first line of the help text. + "---help---" and "help" do not differ in behaviour, "---help---" is + used to help visually separate configuration logic from help within + the file as an aid to developers. + +- misc options: "option" [=] + Various less common options can be defined via this option syntax, + which can modify the behaviour of the menu entry and its config + symbol. These options are currently possible: + + - "defconfig_list" + This declares a list of default entries which can be used when + looking for the default configuration (which is used when the main + .config doesn't exists yet.) + + - "modules" + This declares the symbol to be used as the MODULES symbol, which + enables the third modular state for all config symbols. + At most one symbol may have the "modules" option set. + + - "env"= + This imports the environment variable into Kconfig. It behaves like + a default, except that the value comes from the environment, this + also means that the behaviour when mixing it with normal defaults is + undefined at this point. The symbol is currently not exported back + to the build environment (if this is desired, it can be done via + another symbol). + + - "allnoconfig_y" + This declares the symbol as one that should have the value y when + using "allnoconfig". Used for symbols that hide other symbols. + +Menu dependencies +----------------- + +Dependencies define the visibility of a menu entry and can also reduce +the input range of tristate symbols. The tristate logic used in the +expressions uses one more state than normal boolean logic to express the +module state. Dependency expressions have the following syntax: + + ::= (1) + '=' (2) + '!=' (3) + '(' ')' (4) + '!' (5) + '&&' (6) + '||' (7) + +Expressions are listed in decreasing order of precedence. + +(1) Convert the symbol into an expression. Boolean and tristate symbols + are simply converted into the respective expression values. All + other symbol types result in 'n'. +(2) If the values of both symbols are equal, it returns 'y', + otherwise 'n'. +(3) If the values of both symbols are equal, it returns 'n', + otherwise 'y'. +(4) Returns the value of the expression. Used to override precedence. +(5) Returns the result of (2-/expr/). +(6) Returns the result of min(/expr/, /expr/). +(7) Returns the result of max(/expr/, /expr/). + +An expression can have a value of 'n', 'm' or 'y' (or 0, 1, 2 +respectively for calculations). A menu entry becomes visible when its +expression evaluates to 'm' or 'y'. + +There are two types of symbols: constant and non-constant symbols. +Non-constant symbols are the most common ones and are defined with the +'config' statement. Non-constant symbols consist entirely of alphanumeric +characters or underscores. +Constant symbols are only part of expressions. Constant symbols are +always surrounded by single or double quotes. Within the quote, any +other character is allowed and the quotes can be escaped using '\'. + +Menu structure +-------------- + +The position of a menu entry in the tree is determined in two ways. First +it can be specified explicitly: + +menu "Network device support" + depends on NET + +config NETDEVICES + ... + +endmenu + +All entries within the "menu" ... "endmenu" block become a submenu of +"Network device support". All subentries inherit the dependencies from +the menu entry, e.g. this means the dependency "NET" is added to the +dependency list of the config option NETDEVICES. + +The other way to generate the menu structure is done by analyzing the +dependencies. If a menu entry somehow depends on the previous entry, it +can be made a submenu of it. First, the previous (parent) symbol must +be part of the dependency list and then one of these two conditions +must be true: +- the child entry must become invisible, if the parent is set to 'n' +- the child entry must only be visible, if the parent is visible + +config MODULES + bool "Enable loadable module support" + +config MODVERSIONS + bool "Set version information on all module symbols" + depends on MODULES + +comment "module support disabled" + depends on !MODULES + +MODVERSIONS directly depends on MODULES, this means it's only visible if +MODULES is different from 'n'. The comment on the other hand is always +visible when MODULES is visible (the (empty) dependency of MODULES is +also part of the comment dependencies). + + +Kconfig syntax +-------------- + +The configuration file describes a series of menu entries, where every +line starts with a keyword (except help texts). The following keywords +end a menu entry: +- config +- menuconfig +- choice/endchoice +- comment +- menu/endmenu +- if/endif +- source +The first five also start the definition of a menu entry. + +config: + + "config" + + +This defines a config symbol and accepts any of above +attributes as options. + +menuconfig: + "menuconfig" + + +This is similar to the simple config entry above, but it also gives a +hint to front ends, that all suboptions should be displayed as a +separate list of options. + +choices: + + "choice" [symbol] + + + "endchoice" + +This defines a choice group and accepts any of the above attributes as +options. A choice can only be of type bool or tristate, while a boolean +choice only allows a single config entry to be selected, a tristate +choice also allows any number of config entries to be set to 'm'. This +can be used if multiple drivers for a single hardware exists and only a +single driver can be compiled/loaded into the kernel, but all drivers +can be compiled as modules. +A choice accepts another option "optional", which allows to set the +choice to 'n' and no entry needs to be selected. +If no [symbol] is associated with a choice, then you can not have multiple +definitions of that choice. If a [symbol] is associated to the choice, +then you may define the same choice (ie. with the same entries) in another +place. + +comment: + + "comment" + + +This defines a comment which is displayed to the user during the +configuration process and is also echoed to the output files. The only +possible options are dependencies. + +menu: + + "menu" +

    + + "endmenu" + +This defines a menu block, see "Menu structure" above for more +information. The only possible options are dependencies and "visible" +attributes. + +if: + + "if" + + "endif" + +This defines an if block. The dependency expression is appended +to all enclosed menu entries. + +source: + + "source" + +This reads the specified configuration file. This file is always parsed. + +mainmenu: + + "mainmenu" + +This sets the config program's title bar if the config program chooses +to use it. It should be placed at the top of the configuration, before any +other statement. + + +Kconfig hints +------------- +This is a collection of Kconfig tips, most of which aren't obvious at +first glance and most of which have become idioms in several Kconfig +files. + +Adding common features and make the usage configurable +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +It is a common idiom to implement a feature/functionality that are +relevant for some architectures but not all. +The recommended way to do so is to use a config variable named HAVE_* +that is defined in a common Kconfig file and selected by the relevant +architectures. +An example is the generic IOMAP functionality. + +We would in lib/Kconfig see: + +# Generic IOMAP is used to ... +config HAVE_GENERIC_IOMAP + +config GENERIC_IOMAP + depends on HAVE_GENERIC_IOMAP && FOO + +And in lib/Makefile we would see: +obj-$(CONFIG_GENERIC_IOMAP) += iomap.o + +For each architecture using the generic IOMAP functionality we would see: + +config X86 + select ... + select HAVE_GENERIC_IOMAP + select ... + +Note: we use the existing config option and avoid creating a new +config variable to select HAVE_GENERIC_IOMAP. + +Note: the use of the internal config variable HAVE_GENERIC_IOMAP, it is +introduced to overcome the limitation of select which will force a +config option to 'y' no matter the dependencies. +The dependencies are moved to the symbol GENERIC_IOMAP and we avoid the +situation where select forces a symbol equals to 'y'. + +Build as module only +~~~~~~~~~~~~~~~~~~~~ +To restrict a component build to module-only, qualify its config symbol +with "depends on m". E.g.: + +config FOO + depends on BAR && m + +limits FOO to module (=m) or disabled (=n). + +Kconfig recursive dependency limitations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you've hit the Kconfig error: "recursive dependency detected" you've run +into a recursive dependency issue with Kconfig, a recursive dependency can be +summarized as a circular dependency. The kconfig tools need to ensure that +Kconfig files comply with specified configuration requirements. In order to do +that kconfig must determine the values that are possible for all Kconfig +symbols, this is currently not possible if there is a circular relation +between two or more Kconfig symbols. For more details refer to the "Simple +Kconfig recursive issue" subsection below. Kconfig does not do recursive +dependency resolution; this has a few implications for Kconfig file writers. +We'll first explain why this issues exists and then provide an example +technical limitation which this brings upon Kconfig developers. Eager +developers wishing to try to address this limitation should read the next +subsections. + +Simple Kconfig recursive issue +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Read: Documentation/kbuild/Kconfig.recursion-issue-01 + +Test with: + +make KBUILD_KCONFIG=Documentation/kbuild/Kconfig.recursion-issue-01 allnoconfig + +Cumulative Kconfig recursive issue +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Read: Documentation/kbuild/Kconfig.recursion-issue-02 + +Test with: + +make KBUILD_KCONFIG=Documentation/kbuild/Kconfig.recursion-issue-02 allnoconfig + +Practical solutions to kconfig recursive issue +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Developers who run into the recursive Kconfig issue have three options +at their disposal. We document them below and also provide a list of +historical issues resolved through these different solutions. + + a) Remove any superfluous "select FOO" or "depends on FOO" + b) Match dependency semantics: + b1) Swap all "select FOO" to "depends on FOO" or, + b2) Swap all "depends on FOO" to "select FOO" + +The resolution to a) can be tested with the sample Kconfig file +Documentation/kbuild/Kconfig.recursion-issue-01 through the removal +of the "select CORE" from CORE_BELL_A_ADVANCED as that is implicit already +since CORE_BELL_A depends on CORE. At times it may not be possible to remove +some dependency criteria, for such cases you can work with solution b). + +The two different resolutions for b) can be tested in the sample Kconfig file +Documentation/kbuild/Kconfig.recursion-issue-02. + +Below is a list of examples of prior fixes for these types of recursive issues; +all errors appear to involve one or more select's and one or more "depends on". + +commit fix +====== === +06b718c01208 select A -> depends on A +c22eacfe82f9 depends on A -> depends on B +6a91e854442c select A -> depends on A +118c565a8f2e select A -> select B +f004e5594705 select A -> depends on A +c7861f37b4c6 depends on A -> (null) +80c69915e5fb select A -> (null) (1) +c2218e26c0d0 select A -> depends on A (1) +d6ae99d04e1c select A -> depends on A +95ca19cf8cbf select A -> depends on A +8f057d7bca54 depends on A -> (null) +8f057d7bca54 depends on A -> select A +a0701f04846e select A -> depends on A +0c8b92f7f259 depends on A -> (null) +e4e9e0540928 select A -> depends on A (2) +7453ea886e87 depends on A > (null) (1) +7b1fff7e4fdf select A -> depends on A +86c747d2a4f0 select A -> depends on A +d9f9ab51e55e select A -> depends on A +0c51a4d8abd6 depends on A -> select A (3) +e98062ed6dc4 select A -> depends on A (3) +91e5d284a7f1 select A -> (null) + +(1) Partial (or no) quote of error. +(2) That seems to be the gist of that fix. +(3) Same error. + +Future kconfig work +~~~~~~~~~~~~~~~~~~~ + +Work on kconfig is welcomed on both areas of clarifying semantics and on +evaluating the use of a full SAT solver for it. A full SAT solver can be +desirable to enable more complex dependency mappings and / or queries, +for instance on possible use case for a SAT solver could be that of handling +the current known recursive dependency issues. It is not known if this would +address such issues but such evaluation is desirable. If support for a full SAT +solver proves too complex or that it cannot address recursive dependency issues +Kconfig should have at least clear and well defined semantics which also +addresses and documents limitations or requirements such as the ones dealing +with recursive dependencies. + +Further work on both of these areas is welcomed on Kconfig. We elaborate +on both of these in the next two subsections. + +Semantics of Kconfig +~~~~~~~~~~~~~~~~~~~~ + +The use of Kconfig is broad, Linux is now only one of Kconfig's users: +one study has completed a broad analysis of Kconfig use in 12 projects [0]. +Despite its widespread use, and although this document does a reasonable job +in documenting basic Kconfig syntax a more precise definition of Kconfig +semantics is welcomed. One project deduced Kconfig semantics through +the use of the xconfig configurator [1]. Work should be done to confirm if +the deduced semantics matches our intended Kconfig design goals. + +Having well defined semantics can be useful for tools for practical +evaluation of depenencies, for instance one such use known case was work to +express in boolean abstraction of the inferred semantics of Kconfig to +translate Kconfig logic into boolean formulas and run a SAT solver on this to +find dead code / features (always inactive), 114 dead features were found in +Linux using this methodology [1] (Section 8: Threats to validity). + +Confirming this could prove useful as Kconfig stands as one of the the leading +industrial variability modeling languages [1] [2]. Its study would help +evaluate practical uses of such languages, their use was only theoretical +and real world requirements were not well understood. As it stands though +only reverse engineering techniques have been used to deduce semantics from +variability modeling languages such as Kconfig [3]. + +[0] http://www.eng.uwaterloo.ca/~shshe/kconfig_semantics.pdf +[1] http://gsd.uwaterloo.ca/sites/default/files/vm-2013-berger.pdf +[2] http://gsd.uwaterloo.ca/sites/default/files/ase241-berger_0.pdf +[3] http://gsd.uwaterloo.ca/sites/default/files/icse2011.pdf + +Full SAT solver for Kconfig +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Although SAT solvers [0] haven't yet been used by Kconfig directly, as noted in +the previous subsection, work has been done however to express in boolean +abstraction the inferred semantics of Kconfig to translate Kconfig logic into +boolean formulas and run a SAT solver on it [1]. Another known related project +is CADOS [2] (former VAMOS [3]) and the tools, mainly undertaker [4], which has +been introduced first with [5]. The basic concept of undertaker is to exract +variability models from Kconfig, and put them together with a propositional +formula extracted from CPP #ifdefs and build-rules into a SAT solver in order +to find dead code, dead files, and dead symbols. If using a SAT solver is +desirable on Kconfig one approach would be to evaluate repurposing such efforts +somehow on Kconfig. There is enough interest from mentors of existing projects +to not only help advise how to integrate this work upstream but also help +maintain it long term. Interested developers should visit: + +http://kernelnewbies.org/KernelProjects/kconfig-sat + +[0] http://www.cs.cornell.edu/~sabhar/chapters/SATSolvers-KR-Handbook.pdf +[1] http://gsd.uwaterloo.ca/sites/default/files/vm-2013-berger.pdf +[2] https://cados.cs.fau.de +[3] https://vamos.cs.fau.de +[4] https://undertaker.cs.fau.de +[5] https://www4.cs.fau.de/Publications/2011/tartler_11_eurosys.pdf diff --git a/tools/kconfig/kxgettext.c b/tools/kconfig/kxgettext.c new file mode 100644 index 000000000..2858738b2 --- /dev/null +++ b/tools/kconfig/kxgettext.c @@ -0,0 +1,235 @@ +/* + * Arnaldo Carvalho de Melo , 2005 + * + * Released under the terms of the GNU GPL v2.0 + */ + +#include +#include + +#include "lkc.h" + +static char *escape(const char* text, char *bf, int len) +{ + char *bfp = bf; + int multiline = strchr(text, '\n') != NULL; + int eol = 0; + int textlen = strlen(text); + + if ((textlen > 0) && (text[textlen-1] == '\n')) + eol = 1; + + *bfp++ = '"'; + --len; + + if (multiline) { + *bfp++ = '"'; + *bfp++ = '\n'; + *bfp++ = '"'; + len -= 3; + } + + while (*text != '\0' && len > 1) { + if (*text == '"') + *bfp++ = '\\'; + else if (*text == '\n') { + *bfp++ = '\\'; + *bfp++ = 'n'; + *bfp++ = '"'; + *bfp++ = '\n'; + *bfp++ = '"'; + len -= 5; + ++text; + goto next; + } + else if (*text == '\\') { + *bfp++ = '\\'; + len--; + } + *bfp++ = *text++; +next: + --len; + } + + if (multiline && eol) + bfp -= 3; + + *bfp++ = '"'; + *bfp = '\0'; + + return bf; +} + +struct file_line { + struct file_line *next; + const char *file; + int lineno; +}; + +static struct file_line *file_line__new(const char *file, int lineno) +{ + struct file_line *self = malloc(sizeof(*self)); + + if (self == NULL) + goto out; + + self->file = file; + self->lineno = lineno; + self->next = NULL; +out: + return self; +} + +struct message { + const char *msg; + const char *option; + struct message *next; + struct file_line *files; +}; + +static struct message *message__list; + +static struct message *message__new(const char *msg, char *option, + const char *file, int lineno) +{ + struct message *self = malloc(sizeof(*self)); + + if (self == NULL) + goto out; + + self->files = file_line__new(file, lineno); + if (self->files == NULL) + goto out_fail; + + self->msg = strdup(msg); + if (self->msg == NULL) + goto out_fail_msg; + + self->option = option; + self->next = NULL; +out: + return self; +out_fail_msg: + free(self->files); +out_fail: + free(self); + self = NULL; + goto out; +} + +static struct message *mesage__find(const char *msg) +{ + struct message *m = message__list; + + while (m != NULL) { + if (strcmp(m->msg, msg) == 0) + break; + m = m->next; + } + + return m; +} + +static int message__add_file_line(struct message *self, const char *file, + int lineno) +{ + int rc = -1; + struct file_line *fl = file_line__new(file, lineno); + + if (fl == NULL) + goto out; + + fl->next = self->files; + self->files = fl; + rc = 0; +out: + return rc; +} + +static int message__add(const char *msg, char *option, const char *file, + int lineno) +{ + int rc = 0; + char bf[16384]; + char *escaped = escape(msg, bf, sizeof(bf)); + struct message *m = mesage__find(escaped); + + if (m != NULL) + rc = message__add_file_line(m, file, lineno); + else { + m = message__new(escaped, option, file, lineno); + + if (m != NULL) { + m->next = message__list; + message__list = m; + } else + rc = -1; + } + return rc; +} + +static void menu_build_message_list(struct menu *menu) +{ + struct menu *child; + + message__add(menu_get_prompt(menu), NULL, + menu->file == NULL ? "Root Menu" : menu->file->name, + menu->lineno); + + if (menu->sym != NULL && menu_has_help(menu)) + message__add(menu_get_help(menu), menu->sym->name, + menu->file == NULL ? "Root Menu" : menu->file->name, + menu->lineno); + + for (child = menu->list; child != NULL; child = child->next) + if (child->prompt != NULL) + menu_build_message_list(child); +} + +static void message__print_file_lineno(struct message *self) +{ + struct file_line *fl = self->files; + + putchar('\n'); + if (self->option != NULL) + printf("# %s:00000\n", self->option); + + printf("#: %s:%d", fl->file, fl->lineno); + fl = fl->next; + + while (fl != NULL) { + printf(", %s:%d", fl->file, fl->lineno); + fl = fl->next; + } + + putchar('\n'); +} + +static void message__print_gettext_msgid_msgstr(struct message *self) +{ + message__print_file_lineno(self); + + printf("msgid %s\n" + "msgstr \"\"\n", self->msg); +} + +static void menu__xgettext(void) +{ + struct message *m = message__list; + + while (m != NULL) { + /* skip empty lines ("") */ + if (strlen(m->msg) > sizeof("\"\"")) + message__print_gettext_msgid_msgstr(m); + m = m->next; + } +} + +int main(int ac, char **av) +{ + conf_parse(av[1]); + + menu_build_message_list(menu_get_root_menu(NULL)); + menu__xgettext(); + return 0; +} diff --git a/tools/kconfig/list.h b/tools/kconfig/list.h new file mode 100644 index 000000000..2cf23f002 --- /dev/null +++ b/tools/kconfig/list.h @@ -0,0 +1,131 @@ +#ifndef LIST_H +#define LIST_H + +/* + * Copied from include/linux/... + */ + +#undef offsetof +#define offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER) + +/** + * container_of - cast a member of a structure out to the containing structure + * @ptr: the pointer to the member. + * @type: the type of the container struct this is embedded in. + * @member: the name of the member within the struct. + * + */ +#define container_of(ptr, type, member) ({ \ + const typeof( ((type *)0)->member ) *__mptr = (ptr); \ + (type *)( (char *)__mptr - offsetof(type,member) );}) + + +struct list_head { + struct list_head *next, *prev; +}; + + +#define LIST_HEAD_INIT(name) { &(name), &(name) } + +#define LIST_HEAD(name) \ + struct list_head name = LIST_HEAD_INIT(name) + +/** + * list_entry - get the struct for this entry + * @ptr: the &struct list_head pointer. + * @type: the type of the struct this is embedded in. + * @member: the name of the list_head within the struct. + */ +#define list_entry(ptr, type, member) \ + container_of(ptr, type, member) + +/** + * list_for_each_entry - iterate over list of given type + * @pos: the type * to use as a loop cursor. + * @head: the head for your list. + * @member: the name of the list_head within the struct. + */ +#define list_for_each_entry(pos, head, member) \ + for (pos = list_entry((head)->next, typeof(*pos), member); \ + &pos->member != (head); \ + pos = list_entry(pos->member.next, typeof(*pos), member)) + +/** + * list_for_each_entry_safe - iterate over list of given type safe against removal of list entry + * @pos: the type * to use as a loop cursor. + * @n: another type * to use as temporary storage + * @head: the head for your list. + * @member: the name of the list_head within the struct. + */ +#define list_for_each_entry_safe(pos, n, head, member) \ + for (pos = list_entry((head)->next, typeof(*pos), member), \ + n = list_entry(pos->member.next, typeof(*pos), member); \ + &pos->member != (head); \ + pos = n, n = list_entry(n->member.next, typeof(*n), member)) + +/** + * list_empty - tests whether a list is empty + * @head: the list to test. + */ +static inline int list_empty(const struct list_head *head) +{ + return head->next == head; +} + +/* + * Insert a new entry between two known consecutive entries. + * + * This is only for internal list manipulation where we know + * the prev/next entries already! + */ +static inline void __list_add(struct list_head *_new, + struct list_head *prev, + struct list_head *next) +{ + next->prev = _new; + _new->next = next; + _new->prev = prev; + prev->next = _new; +} + +/** + * list_add_tail - add a new entry + * @new: new entry to be added + * @head: list head to add it before + * + * Insert a new entry before the specified head. + * This is useful for implementing queues. + */ +static inline void list_add_tail(struct list_head *_new, struct list_head *head) +{ + __list_add(_new, head->prev, head); +} + +/* + * Delete a list entry by making the prev/next entries + * point to each other. + * + * This is only for internal list manipulation where we know + * the prev/next entries already! + */ +static inline void __list_del(struct list_head *prev, struct list_head *next) +{ + next->prev = prev; + prev->next = next; +} + +#define LIST_POISON1 ((void *) 0x00100100) +#define LIST_POISON2 ((void *) 0x00200200) +/** + * list_del - deletes entry from list. + * @entry: the element to delete from the list. + * Note: list_empty() on entry does not return true after this, the entry is + * in an undefined state. + */ +static inline void list_del(struct list_head *entry) +{ + __list_del(entry->prev, entry->next); + entry->next = (struct list_head*)LIST_POISON1; + entry->prev = (struct list_head*)LIST_POISON2; +} +#endif diff --git a/tools/kconfig/lkc.h b/tools/kconfig/lkc.h new file mode 100644 index 000000000..b1f1cc34a --- /dev/null +++ b/tools/kconfig/lkc.h @@ -0,0 +1,187 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#ifndef LKC_H +#define LKC_H + +#include "expr.h" + +#ifndef KBUILD_NO_NLS +# include +#else +static inline const char *gettext(const char *txt) { return txt; } +static inline void textdomain(const char *domainname) {} +static inline void bindtextdomain(const char *name, const char *dir) {} +static inline char *bind_textdomain_codeset(const char *dn, char *c) { return c; } +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#include "lkc_proto.h" + +#define SRCTREE "srctree" + +#ifndef PACKAGE +#define PACKAGE "linux" +#endif + +#define LOCALEDIR "/usr/share/locale" + +#define _(text) gettext(text) +#define N_(text) (text) + +#ifndef CONFIG_ +#define CONFIG_ "CONFIG_" +#endif +static inline const char *CONFIG_prefix(void) +{ + return getenv( "CONFIG_" ) ?: CONFIG_; +} +#undef CONFIG_ +#define CONFIG_ CONFIG_prefix() + +#define TF_COMMAND 0x0001 +#define TF_PARAM 0x0002 +#define TF_OPTION 0x0004 + +enum conf_def_mode { + def_default, + def_yes, + def_mod, + def_no, + def_random +}; + +#define T_OPT_MODULES 1 +#define T_OPT_DEFCONFIG_LIST 2 +#define T_OPT_ENV 3 +#define T_OPT_ALLNOCONFIG_Y 4 + +struct kconf_id { + int name; + int token; + unsigned int flags; + enum symbol_type stype; +}; + +void zconfdump(FILE *out); +void zconf_starthelp(void); +FILE *zconf_fopen(const char *name); +void zconf_initscan(const char *name); +void zconf_nextfile(const char *name); +void zconf_nextfiles(const char *name); +int zconf_lineno(void); +const char *zconf_curname(void); + +/* confdata.c */ +const char *conf_get_configname(void); +const char *conf_get_autoconfig_name(void); +char *conf_get_default_confname(void); +void sym_set_change_count(int count); +void sym_add_change_count(int count); +bool conf_set_all_new_symbols(enum conf_def_mode mode); +void set_all_choice_values(struct symbol *csym); + +/* confdata.c and expr.c */ +static inline void xfwrite(const void *str, size_t len, size_t count, FILE *out) +{ + assert(len != 0); + + if (fwrite(str, len, count, out) != count) + fprintf(stderr, "Error in writing or end of file.\n"); +} + +/* menu.c */ +void _menu_init(void); +void menu_warn(struct menu *menu, const char *fmt, ...); +struct menu *menu_add_menu(void); +void menu_end_menu(void); +void menu_add_entry(struct symbol *sym); +void menu_end_entry(void); +void menu_add_dep(struct expr *dep); +void menu_add_visibility(struct expr *dep); +struct property *menu_add_prompt(enum prop_type type, char *prompt, struct expr *dep); +void menu_add_expr(enum prop_type type, struct expr *expr, struct expr *dep); +void menu_add_symbol(enum prop_type type, struct symbol *sym, struct expr *dep); +void menu_add_option(int token, char *arg); +void menu_finalize(struct menu *parent); +void menu_set_type(int type); + +/* util.c */ +struct file *file_lookup(const char *name); +int file_write_dep(const char *name); +void *xmalloc(size_t size); +void *xcalloc(size_t nmemb, size_t size); + +struct gstr { + size_t len; + char *s; + /* + * when max_width is not zero long lines in string s (if any) get + * wrapped not to exceed the max_width value + */ + int max_width; +}; +struct gstr str_new(void); +void str_free(struct gstr *gs); +void str_append(struct gstr *gs, const char *s); +void str_printf(struct gstr *gs, const char *fmt, ...); +const char *str_get(struct gstr *gs); + +/* symbol.c */ +extern struct expr *sym_env_list; + +void sym_init(void); +void sym_clear_all_valid(void); +struct symbol *sym_choice_default(struct symbol *sym); +const char *sym_get_string_default(struct symbol *sym); +struct symbol *sym_check_deps(struct symbol *sym); +struct property *prop_alloc(enum prop_type type, struct symbol *sym); +struct symbol *prop_get_symbol(struct property *prop); +struct property *sym_get_env_prop(struct symbol *sym); + +static inline tristate sym_get_tristate_value(struct symbol *sym) +{ + return sym->curr.tri; +} + + +static inline struct symbol *sym_get_choice_value(struct symbol *sym) +{ + return (struct symbol *)sym->curr.val; +} + +static inline bool sym_set_choice_value(struct symbol *ch, struct symbol *chval) +{ + return sym_set_tristate_value(chval, yes); +} + +static inline bool sym_is_choice(struct symbol *sym) +{ + return sym->flags & SYMBOL_CHOICE ? true : false; +} + +static inline bool sym_is_choice_value(struct symbol *sym) +{ + return sym->flags & SYMBOL_CHOICEVAL ? true : false; +} + +static inline bool sym_is_optional(struct symbol *sym) +{ + return sym->flags & SYMBOL_OPTIONAL ? true : false; +} + +static inline bool sym_has_value(struct symbol *sym) +{ + return sym->flags & SYMBOL_DEF_USER ? true : false; +} + +#ifdef __cplusplus +} +#endif + +#endif /* LKC_H */ diff --git a/tools/kconfig/lkc_proto.h b/tools/kconfig/lkc_proto.h new file mode 100644 index 000000000..d5398718e --- /dev/null +++ b/tools/kconfig/lkc_proto.h @@ -0,0 +1,52 @@ +#include + +/* confdata.c */ +void conf_parse(const char *name); +int conf_read(const char *name); +int conf_read_simple(const char *name, int); +int conf_write_defconfig(const char *name); +int conf_write(const char *name); +int conf_write_autoconf(void); +bool conf_get_changed(void); +void conf_set_changed_callback(void (*fn)(void)); +void conf_set_message_callback(void (*fn)(const char *fmt, va_list ap)); + +/* menu.c */ +extern struct menu rootmenu; + +bool menu_is_empty(struct menu *menu); +bool menu_is_visible(struct menu *menu); +bool menu_has_prompt(struct menu *menu); +const char * menu_get_prompt(struct menu *menu); +struct menu * menu_get_root_menu(struct menu *menu); +struct menu * menu_get_parent_menu(struct menu *menu); +bool menu_has_help(struct menu *menu); +const char * menu_get_help(struct menu *menu); +struct gstr get_relations_str(struct symbol **sym_arr, struct list_head *head); +void menu_get_ext_help(struct menu *menu, struct gstr *help); + +/* symbol.c */ +extern struct symbol * symbol_hash[SYMBOL_HASHSIZE]; + +struct symbol * sym_lookup(const char *name, int flags); +struct symbol * sym_find(const char *name); +const char * sym_expand_string_value(const char *in); +const char * sym_escape_string_value(const char *in); +struct symbol ** sym_re_search(const char *pattern); +const char * sym_type_name(enum symbol_type type); +void sym_calc_value(struct symbol *sym); +enum symbol_type sym_get_type(struct symbol *sym); +bool sym_tristate_within_range(struct symbol *sym,tristate tri); +bool sym_set_tristate_value(struct symbol *sym,tristate tri); +tristate sym_toggle_tristate_value(struct symbol *sym); +bool sym_string_valid(struct symbol *sym, const char *newval); +bool sym_string_within_range(struct symbol *sym, const char *str); +bool sym_set_string_value(struct symbol *sym, const char *newval); +bool sym_is_changable(struct symbol *sym); +struct property * sym_get_choice_prop(struct symbol *sym); +const char * sym_get_string_value(struct symbol *sym); + +const char * prop_get_type_name(enum prop_type type); + +/* expr.c */ +void expr_print(struct expr *e, void (*fn)(void *, struct symbol *, const char *), void *data, int prevtoken); diff --git a/tools/kconfig/lxdialog/.gitignore b/tools/kconfig/lxdialog/.gitignore new file mode 100644 index 000000000..90b08ff02 --- /dev/null +++ b/tools/kconfig/lxdialog/.gitignore @@ -0,0 +1,4 @@ +# +# Generated files +# +lxdialog diff --git a/tools/kconfig/lxdialog/BIG.FAT.WARNING b/tools/kconfig/lxdialog/BIG.FAT.WARNING new file mode 100644 index 000000000..a8999d82b --- /dev/null +++ b/tools/kconfig/lxdialog/BIG.FAT.WARNING @@ -0,0 +1,4 @@ +This is NOT the official version of dialog. This version has been +significantly modified from the original. It is for use by the Linux +kernel configuration script. Please do not bother Savio Lam with +questions about this program. diff --git a/tools/kconfig/lxdialog/check-lxdialog.sh b/tools/kconfig/lxdialog/check-lxdialog.sh new file mode 100755 index 000000000..6964d2b0c --- /dev/null +++ b/tools/kconfig/lxdialog/check-lxdialog.sh @@ -0,0 +1,95 @@ +#!/bin/bash +# Check ncurses compatibility + +# What library to link +ldflags() +{ + if [ $(uname -s) == "Darwin" ]; then + #OSX seems to need intl too + echo -n "-lintl " + fi + pkg-config --libs ncursesw 2>/dev/null && exit + pkg-config --libs ncurses 2>/dev/null && exit + for ext in so a dll.a dylib ; do + for lib in ncursesw ncurses curses ; do + $cc -print-file-name=lib${lib}.${ext} $extra_libs | grep -q / + if [ $? -eq 0 ]; then + echo "-l${lib}" + exit + fi + done + done + exit 1 +} + +# Where is ncurses.h? +ccflags() +{ + if pkg-config --cflags ncursesw 2>/dev/null; then + echo '-DCURSES_LOC="" -DNCURSES_WIDECHAR=1' + elif pkg-config --cflags ncurses 2>/dev/null; then + echo '-DCURSES_LOC=""' + elif [ -f /usr/include/ncursesw/curses.h ]; then + echo '-I/usr/include/ncursesw -DCURSES_LOC=""' + echo ' -DNCURSES_WIDECHAR=1' + elif [ -f /usr/include/ncurses/ncurses.h ]; then + echo '-I/usr/include/ncurses -DCURSES_LOC=""' + elif [ -f /usr/include/ncurses/curses.h ]; then + echo '-I/usr/include/ncurses -DCURSES_LOC=""' + elif [ -f /usr/include/ncurses.h ]; then + echo '-DCURSES_LOC=""' + else + echo '-DCURSES_LOC=""' + fi +} + +# Temp file, try to clean up after us +tmp=.lxdialog.tmp +trap "rm -f $tmp" 0 1 2 3 15 + +# Check if we can link to ncurses +check() { + $cc -x c - -o $tmp 2>/dev/null <<'EOF' +#include CURSES_LOC +main() {} +EOF + if [ $? != 0 ]; then + echo " *** Unable to find the ncurses libraries or the" 1>&2 + echo " *** required header files." 1>&2 + echo " *** 'make menuconfig' requires the ncurses libraries." 1>&2 + echo " *** " 1>&2 + echo " *** Install ncurses (ncurses-devel) and try again." 1>&2 + echo " *** " 1>&2 + exit 1 + fi +} + +usage() { + printf "Usage: $0 [-check compiler options|-ccflags|-ldflags compiler options]\n" +} + +if [ $# -eq 0 ]; then + usage + exit 1 +fi + +cc="" +case "$1" in + "-check") + shift + cc="$@" + check + ;; + "-ccflags") + ccflags + ;; + "-ldflags") + shift + cc="$@" + ldflags + ;; + "*") + usage + exit 1 + ;; +esac diff --git a/tools/kconfig/lxdialog/checklist.c b/tools/kconfig/lxdialog/checklist.c new file mode 100644 index 000000000..8d016faa2 --- /dev/null +++ b/tools/kconfig/lxdialog/checklist.c @@ -0,0 +1,332 @@ +/* + * checklist.c -- implements the checklist box + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * Stuart Herbert - S.Herbert@sheffield.ac.uk: radiolist extension + * Alessandro Rubini - rubini@ipvvis.unipv.it: merged the two + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include "dialog.h" + +static int list_width, check_x, item_x; + +/* + * Print list item + */ +static void print_item(WINDOW * win, int choice, int selected) +{ + int i; + char *list_item = malloc(list_width + 1); + + strncpy(list_item, item_str(), list_width - item_x); + list_item[list_width - item_x] = '\0'; + + /* Clear 'residue' of last item */ + wattrset(win, dlg.menubox.atr); + wmove(win, choice, 0); + for (i = 0; i < list_width; i++) + waddch(win, ' '); + + wmove(win, choice, check_x); + wattrset(win, selected ? dlg.check_selected.atr + : dlg.check.atr); + if (!item_is_tag(':')) + wprintw(win, "(%c)", item_is_tag('X') ? 'X' : ' '); + + wattrset(win, selected ? dlg.tag_selected.atr : dlg.tag.atr); + mvwaddch(win, choice, item_x, list_item[0]); + wattrset(win, selected ? dlg.item_selected.atr : dlg.item.atr); + waddstr(win, list_item + 1); + if (selected) { + wmove(win, choice, check_x + 1); + wrefresh(win); + } + free(list_item); +} + +/* + * Print the scroll indicators. + */ +static void print_arrows(WINDOW * win, int choice, int item_no, int scroll, + int y, int x, int height) +{ + wmove(win, y, x); + + if (scroll > 0) { + wattrset(win, dlg.uarrow.atr); + waddch(win, ACS_UARROW); + waddstr(win, "(-)"); + } else { + wattrset(win, dlg.menubox.atr); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + } + + y = y + height + 1; + wmove(win, y, x); + + if ((height < item_no) && (scroll + choice < item_no - 1)) { + wattrset(win, dlg.darrow.atr); + waddch(win, ACS_DARROW); + waddstr(win, "(+)"); + } else { + wattrset(win, dlg.menubox_border.atr); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + } +} + +/* + * Display the termination buttons + */ +static void print_buttons(WINDOW * dialog, int height, int width, int selected) +{ + int x = width / 2 - 11; + int y = height - 2; + + print_button(dialog, gettext("Select"), y, x, selected == 0); + print_button(dialog, gettext(" Help "), y, x + 14, selected == 1); + + wmove(dialog, y, x + 1 + 14 * selected); + wrefresh(dialog); +} + +/* + * Display a dialog box with a list of options that can be turned on or off + * in the style of radiolist (only one option turned on at a time). + */ +int dialog_checklist(const char *title, const char *prompt, int height, + int width, int list_height) +{ + int i, x, y, box_x, box_y; + int key = 0, button = 0, choice = 0, scroll = 0, max_choice; + WINDOW *dialog, *list; + + /* which item to highlight */ + item_foreach() { + if (item_is_tag('X')) + choice = item_n(); + if (item_is_selected()) { + choice = item_n(); + break; + } + } + +do_resize: + if (getmaxy(stdscr) < (height + CHECKLIST_HEIGTH_MIN)) + return -ERRDISPLAYTOOSMALL; + if (getmaxx(stdscr) < (width + CHECKLIST_WIDTH_MIN)) + return -ERRDISPLAYTOOSMALL; + + max_choice = MIN(list_height, item_count()); + + /* center dialog box on screen */ + x = (getmaxx(stdscr) - width) / 2; + y = (getmaxy(stdscr) - height) / 2; + + draw_shadow(stdscr, y, x, height, width); + + dialog = newwin(height, width, y, x); + keypad(dialog, TRUE); + + draw_box(dialog, 0, 0, height, width, + dlg.dialog.atr, dlg.border.atr); + wattrset(dialog, dlg.border.atr); + mvwaddch(dialog, height - 3, 0, ACS_LTEE); + for (i = 0; i < width - 2; i++) + waddch(dialog, ACS_HLINE); + wattrset(dialog, dlg.dialog.atr); + waddch(dialog, ACS_RTEE); + + print_title(dialog, title, width); + + wattrset(dialog, dlg.dialog.atr); + print_autowrap(dialog, prompt, width - 2, 1, 3); + + list_width = width - 6; + box_y = height - list_height - 5; + box_x = (width - list_width) / 2 - 1; + + /* create new window for the list */ + list = subwin(dialog, list_height, list_width, y + box_y + 1, + x + box_x + 1); + + keypad(list, TRUE); + + /* draw a box around the list items */ + draw_box(dialog, box_y, box_x, list_height + 2, list_width + 2, + dlg.menubox_border.atr, dlg.menubox.atr); + + /* Find length of longest item in order to center checklist */ + check_x = 0; + item_foreach() + check_x = MAX(check_x, strlen(item_str()) + 4); + check_x = MIN(check_x, list_width); + + check_x = (list_width - check_x) / 2; + item_x = check_x + 4; + + if (choice >= list_height) { + scroll = choice - list_height + 1; + choice -= scroll; + } + + /* Print the list */ + for (i = 0; i < max_choice; i++) { + item_set(scroll + i); + print_item(list, i, i == choice); + } + + print_arrows(dialog, choice, item_count(), scroll, + box_y, box_x + check_x + 5, list_height); + + print_buttons(dialog, height, width, 0); + + wnoutrefresh(dialog); + wnoutrefresh(list); + doupdate(); + + while (key != KEY_ESC) { + key = wgetch(dialog); + + for (i = 0; i < max_choice; i++) { + item_set(i + scroll); + if (toupper(key) == toupper(item_str()[0])) + break; + } + + if (i < max_choice || key == KEY_UP || key == KEY_DOWN || + key == '+' || key == '-') { + if (key == KEY_UP || key == '-') { + if (!choice) { + if (!scroll) + continue; + /* Scroll list down */ + if (list_height > 1) { + /* De-highlight current first item */ + item_set(scroll); + print_item(list, 0, FALSE); + scrollok(list, TRUE); + wscrl(list, -1); + scrollok(list, FALSE); + } + scroll--; + item_set(scroll); + print_item(list, 0, TRUE); + print_arrows(dialog, choice, item_count(), + scroll, box_y, box_x + check_x + 5, list_height); + + wnoutrefresh(dialog); + wrefresh(list); + + continue; /* wait for another key press */ + } else + i = choice - 1; + } else if (key == KEY_DOWN || key == '+') { + if (choice == max_choice - 1) { + if (scroll + choice >= item_count() - 1) + continue; + /* Scroll list up */ + if (list_height > 1) { + /* De-highlight current last item before scrolling up */ + item_set(scroll + max_choice - 1); + print_item(list, + max_choice - 1, + FALSE); + scrollok(list, TRUE); + wscrl(list, 1); + scrollok(list, FALSE); + } + scroll++; + item_set(scroll + max_choice - 1); + print_item(list, max_choice - 1, TRUE); + + print_arrows(dialog, choice, item_count(), + scroll, box_y, box_x + check_x + 5, list_height); + + wnoutrefresh(dialog); + wrefresh(list); + + continue; /* wait for another key press */ + } else + i = choice + 1; + } + if (i != choice) { + /* De-highlight current item */ + item_set(scroll + choice); + print_item(list, choice, FALSE); + /* Highlight new item */ + choice = i; + item_set(scroll + choice); + print_item(list, choice, TRUE); + wnoutrefresh(dialog); + wrefresh(list); + } + continue; /* wait for another key press */ + } + switch (key) { + case 'H': + case 'h': + case '?': + button = 1; + /* fall-through */ + case 'S': + case 's': + case ' ': + case '\n': + item_foreach() + item_set_selected(0); + item_set(scroll + choice); + item_set_selected(1); + delwin(list); + delwin(dialog); + return button; + case TAB: + case KEY_LEFT: + case KEY_RIGHT: + button = ((key == KEY_LEFT ? --button : ++button) < 0) + ? 1 : (button > 1 ? 0 : button); + + print_buttons(dialog, height, width, button); + wrefresh(dialog); + break; + case 'X': + case 'x': + key = KEY_ESC; + break; + case KEY_ESC: + key = on_key_esc(dialog); + break; + case KEY_RESIZE: + delwin(list); + delwin(dialog); + on_key_resize(); + goto do_resize; + } + + /* Now, update everything... */ + doupdate(); + } + delwin(list); + delwin(dialog); + return key; /* ESC pressed */ +} diff --git a/tools/kconfig/lxdialog/dialog.h b/tools/kconfig/lxdialog/dialog.h new file mode 100644 index 000000000..fcffd5b41 --- /dev/null +++ b/tools/kconfig/lxdialog/dialog.h @@ -0,0 +1,257 @@ +/* + * dialog.h -- common declarations for all dialog modules + * + * AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include +#include +#include +#include +#include +#include +#include + +#ifndef KBUILD_NO_NLS +# include +#else +# define gettext(Msgid) ((const char *) (Msgid)) +#endif + +#ifdef __sun__ +#define CURS_MACROS +#endif +#include CURSES_LOC + +/* + * Colors in ncurses 1.9.9e do not work properly since foreground and + * background colors are OR'd rather than separately masked. This version + * of dialog was hacked to work with ncurses 1.9.9e, making it incompatible + * with standard curses. The simplest fix (to make this work with standard + * curses) uses the wbkgdset() function, not used in the original hack. + * Turn it off if we're building with 1.9.9e, since it just confuses things. + */ +#if defined(NCURSES_VERSION) && defined(_NEED_WRAP) && !defined(GCC_PRINTFLIKE) +#define OLD_NCURSES 1 +#undef wbkgdset +#define wbkgdset(w,p) /*nothing */ +#else +#define OLD_NCURSES 0 +#endif + +#define TR(params) _tracef params + +#define KEY_ESC 27 +#define TAB 9 +#define MAX_LEN 2048 +#define BUF_SIZE (10*1024) +#define MIN(x,y) (x < y ? x : y) +#define MAX(x,y) (x > y ? x : y) + +#ifndef ACS_ULCORNER +#define ACS_ULCORNER '+' +#endif +#ifndef ACS_LLCORNER +#define ACS_LLCORNER '+' +#endif +#ifndef ACS_URCORNER +#define ACS_URCORNER '+' +#endif +#ifndef ACS_LRCORNER +#define ACS_LRCORNER '+' +#endif +#ifndef ACS_HLINE +#define ACS_HLINE '-' +#endif +#ifndef ACS_VLINE +#define ACS_VLINE '|' +#endif +#ifndef ACS_LTEE +#define ACS_LTEE '+' +#endif +#ifndef ACS_RTEE +#define ACS_RTEE '+' +#endif +#ifndef ACS_UARROW +#define ACS_UARROW '^' +#endif +#ifndef ACS_DARROW +#define ACS_DARROW 'v' +#endif + +/* error return codes */ +#define ERRDISPLAYTOOSMALL (KEY_MAX + 1) + +/* + * Color definitions + */ +struct dialog_color { + chtype atr; /* Color attribute */ + int fg; /* foreground */ + int bg; /* background */ + int hl; /* highlight this item */ +}; + +struct subtitle_list { + struct subtitle_list *next; + const char *text; +}; + +struct dialog_info { + const char *backtitle; + struct subtitle_list *subtitles; + struct dialog_color screen; + struct dialog_color shadow; + struct dialog_color dialog; + struct dialog_color title; + struct dialog_color border; + struct dialog_color button_active; + struct dialog_color button_inactive; + struct dialog_color button_key_active; + struct dialog_color button_key_inactive; + struct dialog_color button_label_active; + struct dialog_color button_label_inactive; + struct dialog_color inputbox; + struct dialog_color inputbox_border; + struct dialog_color searchbox; + struct dialog_color searchbox_title; + struct dialog_color searchbox_border; + struct dialog_color position_indicator; + struct dialog_color menubox; + struct dialog_color menubox_border; + struct dialog_color item; + struct dialog_color item_selected; + struct dialog_color tag; + struct dialog_color tag_selected; + struct dialog_color tag_key; + struct dialog_color tag_key_selected; + struct dialog_color check; + struct dialog_color check_selected; + struct dialog_color uarrow; + struct dialog_color darrow; +}; + +/* + * Global variables + */ +extern struct dialog_info dlg; +extern char dialog_input_result[]; +extern int saved_x, saved_y; /* Needed in signal handler in mconf.c */ + +/* + * Function prototypes + */ + +/* item list as used by checklist and menubox */ +void item_reset(void); +void item_make(const char *fmt, ...); +void item_add_str(const char *fmt, ...); +void item_set_tag(char tag); +void item_set_data(void *p); +void item_set_selected(int val); +int item_activate_selected(void); +void *item_data(void); +char item_tag(void); + +/* item list manipulation for lxdialog use */ +#define MAXITEMSTR 200 +struct dialog_item { + char str[MAXITEMSTR]; /* prompt displayed */ + char tag; + void *data; /* pointer to menu item - used by menubox+checklist */ + int selected; /* Set to 1 by dialog_*() function if selected. */ +}; + +/* list of lialog_items */ +struct dialog_list { + struct dialog_item node; + struct dialog_list *next; +}; + +extern struct dialog_list *item_cur; +extern struct dialog_list item_nil; +extern struct dialog_list *item_head; + +int item_count(void); +void item_set(int n); +int item_n(void); +const char *item_str(void); +int item_is_selected(void); +int item_is_tag(char tag); +#define item_foreach() \ + for (item_cur = item_head ? item_head: item_cur; \ + item_cur && (item_cur != &item_nil); item_cur = item_cur->next) + +/* generic key handlers */ +int on_key_esc(WINDOW *win); +int on_key_resize(void); + +/* minimum (re)size values */ +#define CHECKLIST_HEIGTH_MIN 6 /* For dialog_checklist() */ +#define CHECKLIST_WIDTH_MIN 6 +#define INPUTBOX_HEIGTH_MIN 2 /* For dialog_inputbox() */ +#define INPUTBOX_WIDTH_MIN 2 +#define MENUBOX_HEIGTH_MIN 15 /* For dialog_menu() */ +#define MENUBOX_WIDTH_MIN 65 +#define TEXTBOX_HEIGTH_MIN 8 /* For dialog_textbox() */ +#define TEXTBOX_WIDTH_MIN 8 +#define YESNO_HEIGTH_MIN 4 /* For dialog_yesno() */ +#define YESNO_WIDTH_MIN 4 +#define WINDOW_HEIGTH_MIN 19 /* For init_dialog() */ +#define WINDOW_WIDTH_MIN 80 + +int init_dialog(const char *backtitle); +void set_dialog_backtitle(const char *backtitle); +void set_dialog_subtitles(struct subtitle_list *subtitles); +void end_dialog(int x, int y); +void attr_clear(WINDOW * win, int height, int width, chtype attr); +void dialog_clear(void); +void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x); +void print_button(WINDOW * win, const char *label, int y, int x, int selected); +void print_title(WINDOW *dialog, const char *title, int width); +void draw_box(WINDOW * win, int y, int x, int height, int width, chtype box, + chtype border); +void draw_shadow(WINDOW * win, int y, int x, int height, int width); + +int first_alpha(const char *string, const char *exempt); +int dialog_yesno(const char *title, const char *prompt, int height, int width); +int dialog_msgbox(const char *title, const char *prompt, int height, + int width, int pause); + + +typedef void (*update_text_fn)(char *buf, size_t start, size_t end, void + *_data); +int dialog_textbox(const char *title, char *tbuf, int initial_height, + int initial_width, int *keys, int *_vscroll, int *_hscroll, + update_text_fn update_text, void *data); +int dialog_menu(const char *title, const char *prompt, + const void *selected, int *s_scroll); +int dialog_checklist(const char *title, const char *prompt, int height, + int width, int list_height); +int dialog_inputbox(const char *title, const char *prompt, int height, + int width, const char *init); + +/* + * This is the base for fictitious keys, which activate + * the buttons. + * + * Mouse-generated keys are the following: + * -- the first 32 are used as numbers, in addition to '0'-'9' + * -- the lowercase are used to signal mouse-enter events (M_EVENT + 'o') + * -- uppercase chars are used to invoke the button (M_EVENT + 'O') + */ +#define M_EVENT (KEY_MAX+1) diff --git a/tools/kconfig/lxdialog/inputbox.c b/tools/kconfig/lxdialog/inputbox.c new file mode 100644 index 000000000..d58de1dc5 --- /dev/null +++ b/tools/kconfig/lxdialog/inputbox.c @@ -0,0 +1,301 @@ +/* + * inputbox.c -- implements the input box + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include "dialog.h" + +char dialog_input_result[MAX_LEN + 1]; + +/* + * Print the termination buttons + */ +static void print_buttons(WINDOW * dialog, int height, int width, int selected) +{ + int x = width / 2 - 11; + int y = height - 2; + + print_button(dialog, gettext(" Ok "), y, x, selected == 0); + print_button(dialog, gettext(" Help "), y, x + 14, selected == 1); + + wmove(dialog, y, x + 1 + 14 * selected); + wrefresh(dialog); +} + +/* + * Display a dialog box for inputing a string + */ +int dialog_inputbox(const char *title, const char *prompt, int height, int width, + const char *init) +{ + int i, x, y, box_y, box_x, box_width; + int input_x = 0, key = 0, button = -1; + int show_x, len, pos; + char *instr = dialog_input_result; + WINDOW *dialog; + + if (!init) + instr[0] = '\0'; + else + strcpy(instr, init); + +do_resize: + if (getmaxy(stdscr) <= (height - INPUTBOX_HEIGTH_MIN)) + return -ERRDISPLAYTOOSMALL; + if (getmaxx(stdscr) <= (width - INPUTBOX_WIDTH_MIN)) + return -ERRDISPLAYTOOSMALL; + + /* center dialog box on screen */ + x = (getmaxx(stdscr) - width) / 2; + y = (getmaxy(stdscr) - height) / 2; + + draw_shadow(stdscr, y, x, height, width); + + dialog = newwin(height, width, y, x); + keypad(dialog, TRUE); + + draw_box(dialog, 0, 0, height, width, + dlg.dialog.atr, dlg.border.atr); + wattrset(dialog, dlg.border.atr); + mvwaddch(dialog, height - 3, 0, ACS_LTEE); + for (i = 0; i < width - 2; i++) + waddch(dialog, ACS_HLINE); + wattrset(dialog, dlg.dialog.atr); + waddch(dialog, ACS_RTEE); + + print_title(dialog, title, width); + + wattrset(dialog, dlg.dialog.atr); + print_autowrap(dialog, prompt, width - 2, 1, 3); + + /* Draw the input field box */ + box_width = width - 6; + getyx(dialog, y, x); + box_y = y + 2; + box_x = (width - box_width) / 2; + draw_box(dialog, y + 1, box_x - 1, 3, box_width + 2, + dlg.dialog.atr, dlg.border.atr); + + print_buttons(dialog, height, width, 0); + + /* Set up the initial value */ + wmove(dialog, box_y, box_x); + wattrset(dialog, dlg.inputbox.atr); + + len = strlen(instr); + pos = len; + + if (len >= box_width) { + show_x = len - box_width + 1; + input_x = box_width - 1; + for (i = 0; i < box_width - 1; i++) + waddch(dialog, instr[show_x + i]); + } else { + show_x = 0; + input_x = len; + waddstr(dialog, instr); + } + + wmove(dialog, box_y, box_x + input_x); + + wrefresh(dialog); + + while (key != KEY_ESC) { + key = wgetch(dialog); + + if (button == -1) { /* Input box selected */ + switch (key) { + case TAB: + case KEY_UP: + case KEY_DOWN: + break; + case KEY_BACKSPACE: + case 127: + if (pos) { + wattrset(dialog, dlg.inputbox.atr); + if (input_x == 0) { + show_x--; + } else + input_x--; + + if (pos < len) { + for (i = pos - 1; i < len; i++) { + instr[i] = instr[i+1]; + } + } + + pos--; + len--; + instr[len] = '\0'; + wmove(dialog, box_y, box_x); + for (i = 0; i < box_width; i++) { + if (!instr[show_x + i]) { + waddch(dialog, ' '); + break; + } + waddch(dialog, instr[show_x + i]); + } + wmove(dialog, box_y, input_x + box_x); + wrefresh(dialog); + } + continue; + case KEY_LEFT: + if (pos > 0) { + if (input_x > 0) { + wmove(dialog, box_y, --input_x + box_x); + } else if (input_x == 0) { + show_x--; + wmove(dialog, box_y, box_x); + for (i = 0; i < box_width; i++) { + if (!instr[show_x + i]) { + waddch(dialog, ' '); + break; + } + waddch(dialog, instr[show_x + i]); + } + wmove(dialog, box_y, box_x); + } + pos--; + } + continue; + case KEY_RIGHT: + if (pos < len) { + if (input_x < box_width - 1) { + wmove(dialog, box_y, ++input_x + box_x); + } else if (input_x == box_width - 1) { + show_x++; + wmove(dialog, box_y, box_x); + for (i = 0; i < box_width; i++) { + if (!instr[show_x + i]) { + waddch(dialog, ' '); + break; + } + waddch(dialog, instr[show_x + i]); + } + wmove(dialog, box_y, input_x + box_x); + } + pos++; + } + continue; + default: + if (key < 0x100 && isprint(key)) { + if (len < MAX_LEN) { + wattrset(dialog, dlg.inputbox.atr); + if (pos < len) { + for (i = len; i > pos; i--) + instr[i] = instr[i-1]; + instr[pos] = key; + } else { + instr[len] = key; + } + pos++; + len++; + instr[len] = '\0'; + + if (input_x == box_width - 1) { + show_x++; + } else { + input_x++; + } + + wmove(dialog, box_y, box_x); + for (i = 0; i < box_width; i++) { + if (!instr[show_x + i]) { + waddch(dialog, ' '); + break; + } + waddch(dialog, instr[show_x + i]); + } + wmove(dialog, box_y, input_x + box_x); + wrefresh(dialog); + } else + flash(); /* Alarm user about overflow */ + continue; + } + } + } + switch (key) { + case 'O': + case 'o': + delwin(dialog); + return 0; + case 'H': + case 'h': + delwin(dialog); + return 1; + case KEY_UP: + case KEY_LEFT: + switch (button) { + case -1: + button = 1; /* Indicates "Help" button is selected */ + print_buttons(dialog, height, width, 1); + break; + case 0: + button = -1; /* Indicates input box is selected */ + print_buttons(dialog, height, width, 0); + wmove(dialog, box_y, box_x + input_x); + wrefresh(dialog); + break; + case 1: + button = 0; /* Indicates "OK" button is selected */ + print_buttons(dialog, height, width, 0); + break; + } + break; + case TAB: + case KEY_DOWN: + case KEY_RIGHT: + switch (button) { + case -1: + button = 0; /* Indicates "OK" button is selected */ + print_buttons(dialog, height, width, 0); + break; + case 0: + button = 1; /* Indicates "Help" button is selected */ + print_buttons(dialog, height, width, 1); + break; + case 1: + button = -1; /* Indicates input box is selected */ + print_buttons(dialog, height, width, 0); + wmove(dialog, box_y, box_x + input_x); + wrefresh(dialog); + break; + } + break; + case ' ': + case '\n': + delwin(dialog); + return (button == -1 ? 0 : button); + case 'X': + case 'x': + key = KEY_ESC; + break; + case KEY_ESC: + key = on_key_esc(dialog); + break; + case KEY_RESIZE: + delwin(dialog); + on_key_resize(); + goto do_resize; + } + } + + delwin(dialog); + return KEY_ESC; /* ESC pressed */ +} diff --git a/tools/kconfig/lxdialog/menubox.c b/tools/kconfig/lxdialog/menubox.c new file mode 100644 index 000000000..11ae9ad7a --- /dev/null +++ b/tools/kconfig/lxdialog/menubox.c @@ -0,0 +1,437 @@ +/* + * menubox.c -- implements the menu box + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcapw@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +/* + * Changes by Clifford Wolf (god@clifford.at) + * + * [ 1998-06-13 ] + * + * *) A bugfix for the Page-Down problem + * + * *) Formerly when I used Page Down and Page Up, the cursor would be set + * to the first position in the menu box. Now lxdialog is a bit + * smarter and works more like other menu systems (just have a look at + * it). + * + * *) Formerly if I selected something my scrolling would be broken because + * lxdialog is re-invoked by the Menuconfig shell script, can't + * remember the last scrolling position, and just sets it so that the + * cursor is at the bottom of the box. Now it writes the temporary file + * lxdialog.scrltmp which contains this information. The file is + * deleted by lxdialog if the user leaves a submenu or enters a new + * one, but it would be nice if Menuconfig could make another "rm -f" + * just to be sure. Just try it out - you will recognise a difference! + * + * [ 1998-06-14 ] + * + * *) Now lxdialog is crash-safe against broken "lxdialog.scrltmp" files + * and menus change their size on the fly. + * + * *) If for some reason the last scrolling position is not saved by + * lxdialog, it sets the scrolling so that the selected item is in the + * middle of the menu box, not at the bottom. + * + * 02 January 1999, Michael Elizabeth Chastain (mec@shout.net) + * Reset 'scroll' to 0 if the value from lxdialog.scrltmp is bogus. + * This fixes a bug in Menuconfig where using ' ' to descend into menus + * would leave mis-synchronized lxdialog.scrltmp files lying around, + * fscanf would read in 'scroll', and eventually that value would get used. + */ + +#include "dialog.h" + +static int menu_width, item_x; + +/* + * Print menu item + */ +static void do_print_item(WINDOW * win, const char *item, int line_y, + int selected, int hotkey) +{ + int j; + char *menu_item = malloc(menu_width + 1); + + strncpy(menu_item, item, menu_width - item_x); + menu_item[menu_width - item_x] = '\0'; + j = first_alpha(menu_item, "YyNnMmHh"); + + /* Clear 'residue' of last item */ + wattrset(win, dlg.menubox.atr); + wmove(win, line_y, 0); +#if OLD_NCURSES + { + int i; + for (i = 0; i < menu_width; i++) + waddch(win, ' '); + } +#else + wclrtoeol(win); +#endif + wattrset(win, selected ? dlg.item_selected.atr : dlg.item.atr); + mvwaddstr(win, line_y, item_x, menu_item); + if (hotkey) { + wattrset(win, selected ? dlg.tag_key_selected.atr + : dlg.tag_key.atr); + mvwaddch(win, line_y, item_x + j, menu_item[j]); + } + if (selected) { + wmove(win, line_y, item_x + 1); + } + free(menu_item); + wrefresh(win); +} + +#define print_item(index, choice, selected) \ +do { \ + item_set(index); \ + do_print_item(menu, item_str(), choice, selected, !item_is_tag(':')); \ +} while (0) + +/* + * Print the scroll indicators. + */ +static void print_arrows(WINDOW * win, int item_no, int scroll, int y, int x, + int height) +{ + int cur_y, cur_x; + + getyx(win, cur_y, cur_x); + + wmove(win, y, x); + + if (scroll > 0) { + wattrset(win, dlg.uarrow.atr); + waddch(win, ACS_UARROW); + waddstr(win, "(-)"); + } else { + wattrset(win, dlg.menubox.atr); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + } + + y = y + height + 1; + wmove(win, y, x); + wrefresh(win); + + if ((height < item_no) && (scroll + height < item_no)) { + wattrset(win, dlg.darrow.atr); + waddch(win, ACS_DARROW); + waddstr(win, "(+)"); + } else { + wattrset(win, dlg.menubox_border.atr); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + waddch(win, ACS_HLINE); + } + + wmove(win, cur_y, cur_x); + wrefresh(win); +} + +/* + * Display the termination buttons. + */ +static void print_buttons(WINDOW * win, int height, int width, int selected) +{ + int x = width / 2 - 28; + int y = height - 2; + + print_button(win, gettext("Select"), y, x, selected == 0); + print_button(win, gettext(" Exit "), y, x + 12, selected == 1); + print_button(win, gettext(" Help "), y, x + 24, selected == 2); + print_button(win, gettext(" Save "), y, x + 36, selected == 3); + print_button(win, gettext(" Load "), y, x + 48, selected == 4); + + wmove(win, y, x + 1 + 12 * selected); + wrefresh(win); +} + +/* scroll up n lines (n may be negative) */ +static void do_scroll(WINDOW *win, int *scroll, int n) +{ + /* Scroll menu up */ + scrollok(win, TRUE); + wscrl(win, n); + scrollok(win, FALSE); + *scroll = *scroll + n; + wrefresh(win); +} + +/* + * Display a menu for choosing among a number of options + */ +int dialog_menu(const char *title, const char *prompt, + const void *selected, int *s_scroll) +{ + int i, j, x, y, box_x, box_y; + int height, width, menu_height; + int key = 0, button = 0, scroll = 0, choice = 0; + int first_item = 0, max_choice; + WINDOW *dialog, *menu; + +do_resize: + height = getmaxy(stdscr); + width = getmaxx(stdscr); + if (height < MENUBOX_HEIGTH_MIN || width < MENUBOX_WIDTH_MIN) + return -ERRDISPLAYTOOSMALL; + + height -= 4; + width -= 5; + menu_height = height - 10; + + max_choice = MIN(menu_height, item_count()); + + /* center dialog box on screen */ + x = (getmaxx(stdscr) - width) / 2; + y = (getmaxy(stdscr) - height) / 2; + + draw_shadow(stdscr, y, x, height, width); + + dialog = newwin(height, width, y, x); + keypad(dialog, TRUE); + + draw_box(dialog, 0, 0, height, width, + dlg.dialog.atr, dlg.border.atr); + wattrset(dialog, dlg.border.atr); + mvwaddch(dialog, height - 3, 0, ACS_LTEE); + for (i = 0; i < width - 2; i++) + waddch(dialog, ACS_HLINE); + wattrset(dialog, dlg.dialog.atr); + wbkgdset(dialog, dlg.dialog.atr & A_COLOR); + waddch(dialog, ACS_RTEE); + + print_title(dialog, title, width); + + wattrset(dialog, dlg.dialog.atr); + print_autowrap(dialog, prompt, width - 2, 1, 3); + + menu_width = width - 6; + box_y = height - menu_height - 5; + box_x = (width - menu_width) / 2 - 1; + + /* create new window for the menu */ + menu = subwin(dialog, menu_height, menu_width, + y + box_y + 1, x + box_x + 1); + keypad(menu, TRUE); + + /* draw a box around the menu items */ + draw_box(dialog, box_y, box_x, menu_height + 2, menu_width + 2, + dlg.menubox_border.atr, dlg.menubox.atr); + + if (menu_width >= 80) + item_x = (menu_width - 70) / 2; + else + item_x = 4; + + /* Set choice to default item */ + item_foreach() + if (selected && (selected == item_data())) + choice = item_n(); + /* get the saved scroll info */ + scroll = *s_scroll; + if ((scroll <= choice) && (scroll + max_choice > choice) && + (scroll >= 0) && (scroll + max_choice <= item_count())) { + first_item = scroll; + choice = choice - scroll; + } else { + scroll = 0; + } + if ((choice >= max_choice)) { + if (choice >= item_count() - max_choice / 2) + scroll = first_item = item_count() - max_choice; + else + scroll = first_item = choice - max_choice / 2; + choice = choice - scroll; + } + + /* Print the menu */ + for (i = 0; i < max_choice; i++) { + print_item(first_item + i, i, i == choice); + } + + wnoutrefresh(menu); + + print_arrows(dialog, item_count(), scroll, + box_y, box_x + item_x + 1, menu_height); + + print_buttons(dialog, height, width, 0); + wmove(menu, choice, item_x + 1); + wrefresh(menu); + + while (key != KEY_ESC) { + key = wgetch(menu); + + if (key < 256 && isalpha(key)) + key = tolower(key); + + if (strchr("ynmh", key)) + i = max_choice; + else { + for (i = choice + 1; i < max_choice; i++) { + item_set(scroll + i); + j = first_alpha(item_str(), "YyNnMmHh"); + if (key == tolower(item_str()[j])) + break; + } + if (i == max_choice) + for (i = 0; i < max_choice; i++) { + item_set(scroll + i); + j = first_alpha(item_str(), "YyNnMmHh"); + if (key == tolower(item_str()[j])) + break; + } + } + + if (item_count() != 0 && + (i < max_choice || + key == KEY_UP || key == KEY_DOWN || + key == '-' || key == '+' || + key == KEY_PPAGE || key == KEY_NPAGE)) { + /* Remove highligt of current item */ + print_item(scroll + choice, choice, FALSE); + + if (key == KEY_UP || key == '-') { + if (choice < 2 && scroll) { + /* Scroll menu down */ + do_scroll(menu, &scroll, -1); + + print_item(scroll, 0, FALSE); + } else + choice = MAX(choice - 1, 0); + + } else if (key == KEY_DOWN || key == '+') { + print_item(scroll+choice, choice, FALSE); + + if ((choice > max_choice - 3) && + (scroll + max_choice < item_count())) { + /* Scroll menu up */ + do_scroll(menu, &scroll, 1); + + print_item(scroll+max_choice - 1, + max_choice - 1, FALSE); + } else + choice = MIN(choice + 1, max_choice - 1); + + } else if (key == KEY_PPAGE) { + scrollok(menu, TRUE); + for (i = 0; (i < max_choice); i++) { + if (scroll > 0) { + do_scroll(menu, &scroll, -1); + print_item(scroll, 0, FALSE); + } else { + if (choice > 0) + choice--; + } + } + + } else if (key == KEY_NPAGE) { + for (i = 0; (i < max_choice); i++) { + if (scroll + max_choice < item_count()) { + do_scroll(menu, &scroll, 1); + print_item(scroll+max_choice-1, + max_choice - 1, FALSE); + } else { + if (choice + 1 < max_choice) + choice++; + } + } + } else + choice = i; + + print_item(scroll + choice, choice, TRUE); + + print_arrows(dialog, item_count(), scroll, + box_y, box_x + item_x + 1, menu_height); + + wnoutrefresh(dialog); + wrefresh(menu); + + continue; /* wait for another key press */ + } + + switch (key) { + case KEY_LEFT: + case TAB: + case KEY_RIGHT: + button = ((key == KEY_LEFT ? --button : ++button) < 0) + ? 4 : (button > 4 ? 0 : button); + + print_buttons(dialog, height, width, button); + wrefresh(menu); + break; + case ' ': + case 's': + case 'y': + case 'n': + case 'm': + case '/': + case 'h': + case '?': + case 'z': + case '\n': + /* save scroll info */ + *s_scroll = scroll; + delwin(menu); + delwin(dialog); + item_set(scroll + choice); + item_set_selected(1); + switch (key) { + case 'h': + case '?': + return 2; + case 's': + case 'y': + return 5; + case 'n': + return 6; + case 'm': + return 7; + case ' ': + return 8; + case '/': + return 9; + case 'z': + return 10; + case '\n': + return button; + } + return 0; + case 'e': + case 'x': + key = KEY_ESC; + break; + case KEY_ESC: + key = on_key_esc(menu); + break; + case KEY_RESIZE: + on_key_resize(); + delwin(menu); + delwin(dialog); + goto do_resize; + } + } + delwin(menu); + delwin(dialog); + return key; /* ESC pressed */ +} diff --git a/tools/kconfig/lxdialog/textbox.c b/tools/kconfig/lxdialog/textbox.c new file mode 100644 index 000000000..1773319b9 --- /dev/null +++ b/tools/kconfig/lxdialog/textbox.c @@ -0,0 +1,408 @@ +/* + * textbox.c -- implements the text box + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include "dialog.h" + +static void back_lines(int n); +static void print_page(WINDOW *win, int height, int width, update_text_fn + update_text, void *data); +static void print_line(WINDOW *win, int row, int width); +static char *get_line(void); +static void print_position(WINDOW * win); + +static int hscroll; +static int begin_reached, end_reached, page_length; +static char *buf; +static char *page; + +/* + * refresh window content + */ +static void refresh_text_box(WINDOW *dialog, WINDOW *box, int boxh, int boxw, + int cur_y, int cur_x, update_text_fn update_text, + void *data) +{ + print_page(box, boxh, boxw, update_text, data); + print_position(dialog); + wmove(dialog, cur_y, cur_x); /* Restore cursor position */ + wrefresh(dialog); +} + + +/* + * Display text from a file in a dialog box. + * + * keys is a null-terminated array + * update_text() may not add or remove any '\n' or '\0' in tbuf + */ +int dialog_textbox(const char *title, char *tbuf, int initial_height, + int initial_width, int *keys, int *_vscroll, int *_hscroll, + update_text_fn update_text, void *data) +{ + int i, x, y, cur_x, cur_y, key = 0; + int height, width, boxh, boxw; + WINDOW *dialog, *box; + bool done = false; + + begin_reached = 1; + end_reached = 0; + page_length = 0; + hscroll = 0; + buf = tbuf; + page = buf; /* page is pointer to start of page to be displayed */ + + if (_vscroll && *_vscroll) { + begin_reached = 0; + + for (i = 0; i < *_vscroll; i++) + get_line(); + } + if (_hscroll) + hscroll = *_hscroll; + +do_resize: + getmaxyx(stdscr, height, width); + if (height < TEXTBOX_HEIGTH_MIN || width < TEXTBOX_WIDTH_MIN) + return -ERRDISPLAYTOOSMALL; + if (initial_height != 0) + height = initial_height; + else + if (height > 4) + height -= 4; + else + height = 0; + if (initial_width != 0) + width = initial_width; + else + if (width > 5) + width -= 5; + else + width = 0; + + /* center dialog box on screen */ + x = (getmaxx(stdscr) - width) / 2; + y = (getmaxy(stdscr) - height) / 2; + + draw_shadow(stdscr, y, x, height, width); + + dialog = newwin(height, width, y, x); + keypad(dialog, TRUE); + + /* Create window for box region, used for scrolling text */ + boxh = height - 4; + boxw = width - 2; + box = subwin(dialog, boxh, boxw, y + 1, x + 1); + wattrset(box, dlg.dialog.atr); + wbkgdset(box, dlg.dialog.atr & A_COLOR); + + keypad(box, TRUE); + + /* register the new window, along with its borders */ + draw_box(dialog, 0, 0, height, width, + dlg.dialog.atr, dlg.border.atr); + + wattrset(dialog, dlg.border.atr); + mvwaddch(dialog, height - 3, 0, ACS_LTEE); + for (i = 0; i < width - 2; i++) + waddch(dialog, ACS_HLINE); + wattrset(dialog, dlg.dialog.atr); + wbkgdset(dialog, dlg.dialog.atr & A_COLOR); + waddch(dialog, ACS_RTEE); + + print_title(dialog, title, width); + + print_button(dialog, gettext(" Exit "), height - 2, width / 2 - 4, TRUE); + wnoutrefresh(dialog); + getyx(dialog, cur_y, cur_x); /* Save cursor position */ + + /* Print first page of text */ + attr_clear(box, boxh, boxw, dlg.dialog.atr); + refresh_text_box(dialog, box, boxh, boxw, cur_y, cur_x, update_text, + data); + + while (!done) { + key = wgetch(dialog); + switch (key) { + case 'E': /* Exit */ + case 'e': + case 'X': + case 'x': + case 'q': + case '\n': + done = true; + break; + case 'g': /* First page */ + case KEY_HOME: + if (!begin_reached) { + begin_reached = 1; + page = buf; + refresh_text_box(dialog, box, boxh, boxw, + cur_y, cur_x, update_text, + data); + } + break; + case 'G': /* Last page */ + case KEY_END: + + end_reached = 1; + /* point to last char in buf */ + page = buf + strlen(buf); + back_lines(boxh); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case 'K': /* Previous line */ + case 'k': + case KEY_UP: + if (begin_reached) + break; + + back_lines(page_length + 1); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case 'B': /* Previous page */ + case 'b': + case 'u': + case KEY_PPAGE: + if (begin_reached) + break; + back_lines(page_length + boxh); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case 'J': /* Next line */ + case 'j': + case KEY_DOWN: + if (end_reached) + break; + + back_lines(page_length - 1); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case KEY_NPAGE: /* Next page */ + case ' ': + case 'd': + if (end_reached) + break; + + begin_reached = 0; + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case '0': /* Beginning of line */ + case 'H': /* Scroll left */ + case 'h': + case KEY_LEFT: + if (hscroll <= 0) + break; + + if (key == '0') + hscroll = 0; + else + hscroll--; + /* Reprint current page to scroll horizontally */ + back_lines(page_length); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case 'L': /* Scroll right */ + case 'l': + case KEY_RIGHT: + if (hscroll >= MAX_LEN) + break; + hscroll++; + /* Reprint current page to scroll horizontally */ + back_lines(page_length); + refresh_text_box(dialog, box, boxh, boxw, cur_y, + cur_x, update_text, data); + break; + case KEY_ESC: + if (on_key_esc(dialog) == KEY_ESC) + done = true; + break; + case KEY_RESIZE: + back_lines(height); + delwin(box); + delwin(dialog); + on_key_resize(); + goto do_resize; + default: + for (i = 0; keys[i]; i++) { + if (key == keys[i]) { + done = true; + break; + } + } + } + } + delwin(box); + delwin(dialog); + if (_vscroll) { + const char *s; + + s = buf; + *_vscroll = 0; + back_lines(page_length); + while (s < page && (s = strchr(s, '\n'))) { + (*_vscroll)++; + s++; + } + } + if (_hscroll) + *_hscroll = hscroll; + return key; +} + +/* + * Go back 'n' lines in text. Called by dialog_textbox(). + * 'page' will be updated to point to the desired line in 'buf'. + */ +static void back_lines(int n) +{ + int i; + + begin_reached = 0; + /* Go back 'n' lines */ + for (i = 0; i < n; i++) { + if (*page == '\0') { + if (end_reached) { + end_reached = 0; + continue; + } + } + if (page == buf) { + begin_reached = 1; + return; + } + page--; + do { + if (page == buf) { + begin_reached = 1; + return; + } + page--; + } while (*page != '\n'); + page++; + } +} + +/* + * Print a new page of text. + */ +static void print_page(WINDOW *win, int height, int width, update_text_fn + update_text, void *data) +{ + int i, passed_end = 0; + + if (update_text) { + char *end; + + for (i = 0; i < height; i++) + get_line(); + end = page; + back_lines(height); + update_text(buf, page - buf, end - buf, data); + } + + page_length = 0; + for (i = 0; i < height; i++) { + print_line(win, i, width); + if (!passed_end) + page_length++; + if (end_reached && !passed_end) + passed_end = 1; + } + wnoutrefresh(win); +} + +/* + * Print a new line of text. + */ +static void print_line(WINDOW * win, int row, int width) +{ + char *line; + + line = get_line(); + line += MIN(strlen(line), hscroll); /* Scroll horizontally */ + wmove(win, row, 0); /* move cursor to correct line */ + waddch(win, ' '); + waddnstr(win, line, MIN(strlen(line), width - 2)); + + /* Clear 'residue' of previous line */ +#if OLD_NCURSES + { + int x = getcurx(win); + int i; + for (i = 0; i < width - x; i++) + waddch(win, ' '); + } +#else + wclrtoeol(win); +#endif +} + +/* + * Return current line of text. Called by dialog_textbox() and print_line(). + * 'page' should point to start of current line before calling, and will be + * updated to point to start of next line. + */ +static char *get_line(void) +{ + int i = 0; + static char line[MAX_LEN + 1]; + + end_reached = 0; + while (*page != '\n') { + if (*page == '\0') { + end_reached = 1; + break; + } else if (i < MAX_LEN) + line[i++] = *(page++); + else { + /* Truncate lines longer than MAX_LEN characters */ + if (i == MAX_LEN) + line[i++] = '\0'; + page++; + } + } + if (i <= MAX_LEN) + line[i] = '\0'; + if (!end_reached) + page++; /* move past '\n' */ + + return line; +} + +/* + * Print current position + */ +static void print_position(WINDOW * win) +{ + int percent; + + wattrset(win, dlg.position_indicator.atr); + wbkgdset(win, dlg.position_indicator.atr & A_COLOR); + percent = (page - buf) * 100 / strlen(buf); + wmove(win, getmaxy(win) - 3, getmaxx(win) - 9); + wprintw(win, "(%3d%%)", percent); +} diff --git a/tools/kconfig/lxdialog/util.c b/tools/kconfig/lxdialog/util.c new file mode 100644 index 000000000..f7abdeb92 --- /dev/null +++ b/tools/kconfig/lxdialog/util.c @@ -0,0 +1,713 @@ +/* + * util.c + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include + +#include "dialog.h" + +/* Needed in signal handler in mconf.c */ +int saved_x, saved_y; + +struct dialog_info dlg; + +static void set_mono_theme(void) +{ + dlg.screen.atr = A_NORMAL; + dlg.shadow.atr = A_NORMAL; + dlg.dialog.atr = A_NORMAL; + dlg.title.atr = A_BOLD; + dlg.border.atr = A_NORMAL; + dlg.button_active.atr = A_REVERSE; + dlg.button_inactive.atr = A_DIM; + dlg.button_key_active.atr = A_REVERSE; + dlg.button_key_inactive.atr = A_BOLD; + dlg.button_label_active.atr = A_REVERSE; + dlg.button_label_inactive.atr = A_NORMAL; + dlg.inputbox.atr = A_NORMAL; + dlg.inputbox_border.atr = A_NORMAL; + dlg.searchbox.atr = A_NORMAL; + dlg.searchbox_title.atr = A_BOLD; + dlg.searchbox_border.atr = A_NORMAL; + dlg.position_indicator.atr = A_BOLD; + dlg.menubox.atr = A_NORMAL; + dlg.menubox_border.atr = A_NORMAL; + dlg.item.atr = A_NORMAL; + dlg.item_selected.atr = A_REVERSE; + dlg.tag.atr = A_BOLD; + dlg.tag_selected.atr = A_REVERSE; + dlg.tag_key.atr = A_BOLD; + dlg.tag_key_selected.atr = A_REVERSE; + dlg.check.atr = A_BOLD; + dlg.check_selected.atr = A_REVERSE; + dlg.uarrow.atr = A_BOLD; + dlg.darrow.atr = A_BOLD; +} + +#define DLG_COLOR(dialog, f, b, h) \ +do { \ + dlg.dialog.fg = (f); \ + dlg.dialog.bg = (b); \ + dlg.dialog.hl = (h); \ +} while (0) + +static void set_classic_theme(void) +{ + DLG_COLOR(screen, COLOR_CYAN, COLOR_BLUE, true); + DLG_COLOR(shadow, COLOR_BLACK, COLOR_BLACK, true); + DLG_COLOR(dialog, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(title, COLOR_YELLOW, COLOR_WHITE, true); + DLG_COLOR(border, COLOR_WHITE, COLOR_WHITE, true); + DLG_COLOR(button_active, COLOR_WHITE, COLOR_BLUE, true); + DLG_COLOR(button_inactive, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(button_key_active, COLOR_WHITE, COLOR_BLUE, true); + DLG_COLOR(button_key_inactive, COLOR_RED, COLOR_WHITE, false); + DLG_COLOR(button_label_active, COLOR_YELLOW, COLOR_BLUE, true); + DLG_COLOR(button_label_inactive, COLOR_BLACK, COLOR_WHITE, true); + DLG_COLOR(inputbox, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(inputbox_border, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(searchbox, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(searchbox_title, COLOR_YELLOW, COLOR_WHITE, true); + DLG_COLOR(searchbox_border, COLOR_WHITE, COLOR_WHITE, true); + DLG_COLOR(position_indicator, COLOR_YELLOW, COLOR_WHITE, true); + DLG_COLOR(menubox, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(menubox_border, COLOR_WHITE, COLOR_WHITE, true); + DLG_COLOR(item, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(item_selected, COLOR_WHITE, COLOR_BLUE, true); + DLG_COLOR(tag, COLOR_YELLOW, COLOR_WHITE, true); + DLG_COLOR(tag_selected, COLOR_YELLOW, COLOR_BLUE, true); + DLG_COLOR(tag_key, COLOR_YELLOW, COLOR_WHITE, true); + DLG_COLOR(tag_key_selected, COLOR_YELLOW, COLOR_BLUE, true); + DLG_COLOR(check, COLOR_BLACK, COLOR_WHITE, false); + DLG_COLOR(check_selected, COLOR_WHITE, COLOR_BLUE, true); + DLG_COLOR(uarrow, COLOR_GREEN, COLOR_WHITE, true); + DLG_COLOR(darrow, COLOR_GREEN, COLOR_WHITE, true); +} + +static void set_blackbg_theme(void) +{ + DLG_COLOR(screen, COLOR_RED, COLOR_BLACK, true); + DLG_COLOR(shadow, COLOR_BLACK, COLOR_BLACK, false); + DLG_COLOR(dialog, COLOR_WHITE, COLOR_BLACK, false); + DLG_COLOR(title, COLOR_RED, COLOR_BLACK, false); + DLG_COLOR(border, COLOR_BLACK, COLOR_BLACK, true); + + DLG_COLOR(button_active, COLOR_YELLOW, COLOR_RED, false); + DLG_COLOR(button_inactive, COLOR_YELLOW, COLOR_BLACK, false); + DLG_COLOR(button_key_active, COLOR_YELLOW, COLOR_RED, true); + DLG_COLOR(button_key_inactive, COLOR_RED, COLOR_BLACK, false); + DLG_COLOR(button_label_active, COLOR_WHITE, COLOR_RED, false); + DLG_COLOR(button_label_inactive, COLOR_BLACK, COLOR_BLACK, true); + + DLG_COLOR(inputbox, COLOR_YELLOW, COLOR_BLACK, false); + DLG_COLOR(inputbox_border, COLOR_YELLOW, COLOR_BLACK, false); + + DLG_COLOR(searchbox, COLOR_YELLOW, COLOR_BLACK, false); + DLG_COLOR(searchbox_title, COLOR_YELLOW, COLOR_BLACK, true); + DLG_COLOR(searchbox_border, COLOR_BLACK, COLOR_BLACK, true); + + DLG_COLOR(position_indicator, COLOR_RED, COLOR_BLACK, false); + + DLG_COLOR(menubox, COLOR_YELLOW, COLOR_BLACK, false); + DLG_COLOR(menubox_border, COLOR_BLACK, COLOR_BLACK, true); + + DLG_COLOR(item, COLOR_WHITE, COLOR_BLACK, false); + DLG_COLOR(item_selected, COLOR_WHITE, COLOR_RED, false); + + DLG_COLOR(tag, COLOR_RED, COLOR_BLACK, false); + DLG_COLOR(tag_selected, COLOR_YELLOW, COLOR_RED, true); + DLG_COLOR(tag_key, COLOR_RED, COLOR_BLACK, false); + DLG_COLOR(tag_key_selected, COLOR_YELLOW, COLOR_RED, true); + + DLG_COLOR(check, COLOR_YELLOW, COLOR_BLACK, false); + DLG_COLOR(check_selected, COLOR_YELLOW, COLOR_RED, true); + + DLG_COLOR(uarrow, COLOR_RED, COLOR_BLACK, false); + DLG_COLOR(darrow, COLOR_RED, COLOR_BLACK, false); +} + +static void set_bluetitle_theme(void) +{ + set_classic_theme(); + DLG_COLOR(title, COLOR_BLUE, COLOR_WHITE, true); + DLG_COLOR(button_key_active, COLOR_YELLOW, COLOR_BLUE, true); + DLG_COLOR(button_label_active, COLOR_WHITE, COLOR_BLUE, true); + DLG_COLOR(searchbox_title, COLOR_BLUE, COLOR_WHITE, true); + DLG_COLOR(position_indicator, COLOR_BLUE, COLOR_WHITE, true); + DLG_COLOR(tag, COLOR_BLUE, COLOR_WHITE, true); + DLG_COLOR(tag_key, COLOR_BLUE, COLOR_WHITE, true); + +} + +/* + * Select color theme + */ +static int set_theme(const char *theme) +{ + int use_color = 1; + if (!theme) + set_bluetitle_theme(); + else if (strcmp(theme, "classic") == 0) + set_classic_theme(); + else if (strcmp(theme, "bluetitle") == 0) + set_bluetitle_theme(); + else if (strcmp(theme, "blackbg") == 0) + set_blackbg_theme(); + else if (strcmp(theme, "mono") == 0) + use_color = 0; + + return use_color; +} + +static void init_one_color(struct dialog_color *color) +{ + static int pair = 0; + + pair++; + init_pair(pair, color->fg, color->bg); + if (color->hl) + color->atr = A_BOLD | COLOR_PAIR(pair); + else + color->atr = COLOR_PAIR(pair); +} + +static void init_dialog_colors(void) +{ + init_one_color(&dlg.screen); + init_one_color(&dlg.shadow); + init_one_color(&dlg.dialog); + init_one_color(&dlg.title); + init_one_color(&dlg.border); + init_one_color(&dlg.button_active); + init_one_color(&dlg.button_inactive); + init_one_color(&dlg.button_key_active); + init_one_color(&dlg.button_key_inactive); + init_one_color(&dlg.button_label_active); + init_one_color(&dlg.button_label_inactive); + init_one_color(&dlg.inputbox); + init_one_color(&dlg.inputbox_border); + init_one_color(&dlg.searchbox); + init_one_color(&dlg.searchbox_title); + init_one_color(&dlg.searchbox_border); + init_one_color(&dlg.position_indicator); + init_one_color(&dlg.menubox); + init_one_color(&dlg.menubox_border); + init_one_color(&dlg.item); + init_one_color(&dlg.item_selected); + init_one_color(&dlg.tag); + init_one_color(&dlg.tag_selected); + init_one_color(&dlg.tag_key); + init_one_color(&dlg.tag_key_selected); + init_one_color(&dlg.check); + init_one_color(&dlg.check_selected); + init_one_color(&dlg.uarrow); + init_one_color(&dlg.darrow); +} + +/* + * Setup for color display + */ +static void color_setup(const char *theme) +{ + int use_color; + + use_color = set_theme(theme); + if (use_color && has_colors()) { + start_color(); + init_dialog_colors(); + } else + set_mono_theme(); +} + +/* + * Set window to attribute 'attr' + */ +void attr_clear(WINDOW * win, int height, int width, chtype attr) +{ + int i, j; + + wattrset(win, attr); + for (i = 0; i < height; i++) { + wmove(win, i, 0); + for (j = 0; j < width; j++) + waddch(win, ' '); + } + touchwin(win); +} + +void dialog_clear(void) +{ + int lines, columns; + + lines = getmaxy(stdscr); + columns = getmaxx(stdscr); + + attr_clear(stdscr, lines, columns, dlg.screen.atr); + /* Display background title if it exists ... - SLH */ + if (dlg.backtitle != NULL) { + int i, len = 0, skip = 0; + struct subtitle_list *pos; + + wattrset(stdscr, dlg.screen.atr); + mvwaddstr(stdscr, 0, 1, (char *)dlg.backtitle); + + for (pos = dlg.subtitles; pos != NULL; pos = pos->next) { + /* 3 is for the arrow and spaces */ + len += strlen(pos->text) + 3; + } + + wmove(stdscr, 1, 1); + if (len > columns - 2) { + const char *ellipsis = "[...] "; + waddstr(stdscr, ellipsis); + skip = len - (columns - 2 - strlen(ellipsis)); + } + + for (pos = dlg.subtitles; pos != NULL; pos = pos->next) { + if (skip == 0) + waddch(stdscr, ACS_RARROW); + else + skip--; + + if (skip == 0) + waddch(stdscr, ' '); + else + skip--; + + if (skip < strlen(pos->text)) { + waddstr(stdscr, pos->text + skip); + skip = 0; + } else + skip -= strlen(pos->text); + + if (skip == 0) + waddch(stdscr, ' '); + else + skip--; + } + + for (i = len + 1; i < columns - 1; i++) + waddch(stdscr, ACS_HLINE); + } + wnoutrefresh(stdscr); +} + +/* + * Do some initialization for dialog + */ +int init_dialog(const char *backtitle) +{ + int height, width; + + initscr(); /* Init curses */ + + /* Get current cursor position for signal handler in mconf.c */ + getyx(stdscr, saved_y, saved_x); + + getmaxyx(stdscr, height, width); + if (height < WINDOW_HEIGTH_MIN || width < WINDOW_WIDTH_MIN) { + endwin(); + return -ERRDISPLAYTOOSMALL; + } + + dlg.backtitle = backtitle; + color_setup(getenv("MENUCONFIG_COLOR")); + + keypad(stdscr, TRUE); + cbreak(); + noecho(); + dialog_clear(); + + return 0; +} + +void set_dialog_backtitle(const char *backtitle) +{ + dlg.backtitle = backtitle; +} + +void set_dialog_subtitles(struct subtitle_list *subtitles) +{ + dlg.subtitles = subtitles; +} + +/* + * End using dialog functions. + */ +void end_dialog(int x, int y) +{ + /* move cursor back to original position */ + move(y, x); + refresh(); + endwin(); +} + +/* Print the title of the dialog. Center the title and truncate + * tile if wider than dialog (- 2 chars). + **/ +void print_title(WINDOW *dialog, const char *title, int width) +{ + if (title) { + int tlen = MIN(width - 2, strlen(title)); + wattrset(dialog, dlg.title.atr); + mvwaddch(dialog, 0, (width - tlen) / 2 - 1, ' '); + mvwaddnstr(dialog, 0, (width - tlen)/2, title, tlen); + waddch(dialog, ' '); + } +} + +/* + * Print a string of text in a window, automatically wrap around to the + * next line if the string is too long to fit on one line. Newline + * characters '\n' are propperly processed. We start on a new line + * if there is no room for at least 4 nonblanks following a double-space. + */ +void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x) +{ + int newl, cur_x, cur_y; + int prompt_len, room, wlen; + char tempstr[MAX_LEN + 1], *word, *sp, *sp2, *newline_separator = 0; + + strcpy(tempstr, prompt); + + prompt_len = strlen(tempstr); + + if (prompt_len <= width - x * 2) { /* If prompt is short */ + wmove(win, y, (width - prompt_len) / 2); + waddstr(win, tempstr); + } else { + cur_x = x; + cur_y = y; + newl = 1; + word = tempstr; + while (word && *word) { + sp = strpbrk(word, "\n "); + if (sp && *sp == '\n') + newline_separator = sp; + + if (sp) + *sp++ = 0; + + /* Wrap to next line if either the word does not fit, + or it is the first word of a new sentence, and it is + short, and the next word does not fit. */ + room = width - cur_x; + wlen = strlen(word); + if (wlen > room || + (newl && wlen < 4 && sp + && wlen + 1 + strlen(sp) > room + && (!(sp2 = strpbrk(sp, "\n ")) + || wlen + 1 + (sp2 - sp) > room))) { + cur_y++; + cur_x = x; + } + wmove(win, cur_y, cur_x); + waddstr(win, word); + getyx(win, cur_y, cur_x); + + /* Move to the next line if the word separator was a newline */ + if (newline_separator) { + cur_y++; + cur_x = x; + newline_separator = 0; + } else + cur_x++; + + if (sp && *sp == ' ') { + cur_x++; /* double space */ + while (*++sp == ' ') ; + newl = 1; + } else + newl = 0; + word = sp; + } + } +} + +/* + * Print a button + */ +void print_button(WINDOW * win, const char *label, int y, int x, int selected) +{ + int i, temp; + + wmove(win, y, x); + wattrset(win, selected ? dlg.button_active.atr + : dlg.button_inactive.atr); + waddstr(win, "<"); + temp = strspn(label, " "); + label += temp; + wattrset(win, selected ? dlg.button_label_active.atr + : dlg.button_label_inactive.atr); + for (i = 0; i < temp; i++) + waddch(win, ' '); + wattrset(win, selected ? dlg.button_key_active.atr + : dlg.button_key_inactive.atr); + waddch(win, label[0]); + wattrset(win, selected ? dlg.button_label_active.atr + : dlg.button_label_inactive.atr); + waddstr(win, (char *)label + 1); + wattrset(win, selected ? dlg.button_active.atr + : dlg.button_inactive.atr); + waddstr(win, ">"); + wmove(win, y, x + temp + 1); +} + +/* + * Draw a rectangular box with line drawing characters + */ +void +draw_box(WINDOW * win, int y, int x, int height, int width, + chtype box, chtype border) +{ + int i, j; + + wattrset(win, 0); + for (i = 0; i < height; i++) { + wmove(win, y + i, x); + for (j = 0; j < width; j++) + if (!i && !j) + waddch(win, border | ACS_ULCORNER); + else if (i == height - 1 && !j) + waddch(win, border | ACS_LLCORNER); + else if (!i && j == width - 1) + waddch(win, box | ACS_URCORNER); + else if (i == height - 1 && j == width - 1) + waddch(win, box | ACS_LRCORNER); + else if (!i) + waddch(win, border | ACS_HLINE); + else if (i == height - 1) + waddch(win, box | ACS_HLINE); + else if (!j) + waddch(win, border | ACS_VLINE); + else if (j == width - 1) + waddch(win, box | ACS_VLINE); + else + waddch(win, box | ' '); + } +} + +/* + * Draw shadows along the right and bottom edge to give a more 3D look + * to the boxes + */ +void draw_shadow(WINDOW * win, int y, int x, int height, int width) +{ + int i; + + if (has_colors()) { /* Whether terminal supports color? */ + wattrset(win, dlg.shadow.atr); + wmove(win, y + height, x + 2); + for (i = 0; i < width; i++) + waddch(win, winch(win) & A_CHARTEXT); + for (i = y + 1; i < y + height + 1; i++) { + wmove(win, i, x + width); + waddch(win, winch(win) & A_CHARTEXT); + waddch(win, winch(win) & A_CHARTEXT); + } + wnoutrefresh(win); + } +} + +/* + * Return the position of the first alphabetic character in a string. + */ +int first_alpha(const char *string, const char *exempt) +{ + int i, in_paren = 0, c; + + for (i = 0; i < strlen(string); i++) { + c = tolower(string[i]); + + if (strchr("<[(", c)) + ++in_paren; + if (strchr(">])", c) && in_paren > 0) + --in_paren; + + if ((!in_paren) && isalpha(c) && strchr(exempt, c) == 0) + return i; + } + + return 0; +} + +/* + * ncurses uses ESC to detect escaped char sequences. This resutl in + * a small timeout before ESC is actually delivered to the application. + * lxdialog suggest which is correctly translated to two + * times esc. But then we need to ignore the second esc to avoid stepping + * out one menu too much. Filter away all escaped key sequences since + * keypad(FALSE) turn off ncurses support for escape sequences - and thats + * needed to make notimeout() do as expected. + */ +int on_key_esc(WINDOW *win) +{ + int key; + int key2; + int key3; + + nodelay(win, TRUE); + keypad(win, FALSE); + key = wgetch(win); + key2 = wgetch(win); + do { + key3 = wgetch(win); + } while (key3 != ERR); + nodelay(win, FALSE); + keypad(win, TRUE); + if (key == KEY_ESC && key2 == ERR) + return KEY_ESC; + else if (key != ERR && key != KEY_ESC && key2 == ERR) + ungetch(key); + + return -1; +} + +/* redraw screen in new size */ +int on_key_resize(void) +{ + dialog_clear(); + return KEY_RESIZE; +} + +struct dialog_list *item_cur; +struct dialog_list item_nil; +struct dialog_list *item_head; + +void item_reset(void) +{ + struct dialog_list *p, *next; + + for (p = item_head; p; p = next) { + next = p->next; + free(p); + } + item_head = NULL; + item_cur = &item_nil; +} + +void item_make(const char *fmt, ...) +{ + va_list ap; + struct dialog_list *p = malloc(sizeof(*p)); + + if (item_head) + item_cur->next = p; + else + item_head = p; + item_cur = p; + memset(p, 0, sizeof(*p)); + + va_start(ap, fmt); + vsnprintf(item_cur->node.str, sizeof(item_cur->node.str), fmt, ap); + va_end(ap); +} + +void item_add_str(const char *fmt, ...) +{ + va_list ap; + size_t avail; + + avail = sizeof(item_cur->node.str) - strlen(item_cur->node.str); + + va_start(ap, fmt); + vsnprintf(item_cur->node.str + strlen(item_cur->node.str), + avail, fmt, ap); + item_cur->node.str[sizeof(item_cur->node.str) - 1] = '\0'; + va_end(ap); +} + +void item_set_tag(char tag) +{ + item_cur->node.tag = tag; +} +void item_set_data(void *ptr) +{ + item_cur->node.data = ptr; +} + +void item_set_selected(int val) +{ + item_cur->node.selected = val; +} + +int item_activate_selected(void) +{ + item_foreach() + if (item_is_selected()) + return 1; + return 0; +} + +void *item_data(void) +{ + return item_cur->node.data; +} + +char item_tag(void) +{ + return item_cur->node.tag; +} + +int item_count(void) +{ + int n = 0; + struct dialog_list *p; + + for (p = item_head; p; p = p->next) + n++; + return n; +} + +void item_set(int n) +{ + int i = 0; + item_foreach() + if (i++ == n) + return; +} + +int item_n(void) +{ + int n = 0; + struct dialog_list *p; + + for (p = item_head; p; p = p->next) { + if (p == item_cur) + return n; + n++; + } + return 0; +} + +const char *item_str(void) +{ + return item_cur->node.str; +} + +int item_is_selected(void) +{ + return (item_cur->node.selected != 0); +} + +int item_is_tag(char tag) +{ + return (item_cur->node.tag == tag); +} diff --git a/tools/kconfig/lxdialog/yesno.c b/tools/kconfig/lxdialog/yesno.c new file mode 100644 index 000000000..676fb2f82 --- /dev/null +++ b/tools/kconfig/lxdialog/yesno.c @@ -0,0 +1,114 @@ +/* + * yesno.c -- implements the yes/no box + * + * ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk) + * MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com) + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + */ + +#include "dialog.h" + +/* + * Display termination buttons + */ +static void print_buttons(WINDOW * dialog, int height, int width, int selected) +{ + int x = width / 2 - 10; + int y = height - 2; + + print_button(dialog, gettext(" Yes "), y, x, selected == 0); + print_button(dialog, gettext(" No "), y, x + 13, selected == 1); + + wmove(dialog, y, x + 1 + 13 * selected); + wrefresh(dialog); +} + +/* + * Display a dialog box with two buttons - Yes and No + */ +int dialog_yesno(const char *title, const char *prompt, int height, int width) +{ + int i, x, y, key = 0, button = 0; + WINDOW *dialog; + +do_resize: + if (getmaxy(stdscr) < (height + YESNO_HEIGTH_MIN)) + return -ERRDISPLAYTOOSMALL; + if (getmaxx(stdscr) < (width + YESNO_WIDTH_MIN)) + return -ERRDISPLAYTOOSMALL; + + /* center dialog box on screen */ + x = (getmaxx(stdscr) - width) / 2; + y = (getmaxy(stdscr) - height) / 2; + + draw_shadow(stdscr, y, x, height, width); + + dialog = newwin(height, width, y, x); + keypad(dialog, TRUE); + + draw_box(dialog, 0, 0, height, width, + dlg.dialog.atr, dlg.border.atr); + wattrset(dialog, dlg.border.atr); + mvwaddch(dialog, height - 3, 0, ACS_LTEE); + for (i = 0; i < width - 2; i++) + waddch(dialog, ACS_HLINE); + wattrset(dialog, dlg.dialog.atr); + waddch(dialog, ACS_RTEE); + + print_title(dialog, title, width); + + wattrset(dialog, dlg.dialog.atr); + print_autowrap(dialog, prompt, width - 2, 1, 3); + + print_buttons(dialog, height, width, 0); + + while (key != KEY_ESC) { + key = wgetch(dialog); + switch (key) { + case 'Y': + case 'y': + delwin(dialog); + return 0; + case 'N': + case 'n': + delwin(dialog); + return 1; + + case TAB: + case KEY_LEFT: + case KEY_RIGHT: + button = ((key == KEY_LEFT ? --button : ++button) < 0) ? 1 : (button > 1 ? 0 : button); + + print_buttons(dialog, height, width, button); + wrefresh(dialog); + break; + case ' ': + case '\n': + delwin(dialog); + return button; + case KEY_ESC: + key = on_key_esc(dialog); + break; + case KEY_RESIZE: + delwin(dialog); + on_key_resize(); + goto do_resize; + } + } + + delwin(dialog); + return key; /* ESC pressed */ +} diff --git a/tools/kconfig/mconf.c b/tools/kconfig/mconf.c new file mode 100644 index 000000000..315ce2c7c --- /dev/null +++ b/tools/kconfig/mconf.c @@ -0,0 +1,1047 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + * + * Introduced single menu mode (show all sub-menus in one large tree). + * 2002-11-06 Petr Baudis + * + * i18n, 2005, Arnaldo Carvalho de Melo + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "lkc.h" +#include "lxdialog/dialog.h" + +static const char mconf_readme[] = N_( +"Overview\n" +"--------\n" +"This interface lets you select features and parameters for the build.\n" +"Features can either be built-in, modularized, or ignored. Parameters\n" +"must be entered in as decimal or hexadecimal numbers or text.\n" +"\n" +"Menu items beginning with following braces represent features that\n" +" [ ] can be built in or removed\n" +" < > can be built in, modularized or removed\n" +" { } can be built in or modularized (selected by other feature)\n" +" - - are selected by other feature,\n" +"while *, M or whitespace inside braces means to build in, build as\n" +"a module or to exclude the feature respectively.\n" +"\n" +"To change any of these features, highlight it with the cursor\n" +"keys and press to build it in, to make it a module or\n" +" to remove it. You may also press the to cycle\n" +"through the available options (i.e. Y->N->M->Y).\n" +"\n" +"Some additional keyboard hints:\n" +"\n" +"Menus\n" +"----------\n" +"o Use the Up/Down arrow keys (cursor keys) to highlight the item you\n" +" wish to change or the submenu you wish to select and press .\n" +" Submenus are designated by \"--->\", empty ones by \"----\".\n" +"\n" +" Shortcut: Press the option's highlighted letter (hotkey).\n" +" Pressing a hotkey more than once will sequence\n" +" through all visible items which use that hotkey.\n" +"\n" +" You may also use the and keys to scroll\n" +" unseen options into view.\n" +"\n" +"o To exit a menu use the cursor keys to highlight the button\n" +" and press .\n" +"\n" +" Shortcut: Press or or if there is no hotkey\n" +" using those letters. You may press a single , but\n" +" there is a delayed response which you may find annoying.\n" +"\n" +" Also, the and cursor keys will cycle between and\n" +" \n" +"\n" +"\n" +"Data Entry\n" +"-----------\n" +"o Enter the requested information and press \n" +" If you are entering hexadecimal values, it is not necessary to\n" +" add the '0x' prefix to the entry.\n" +"\n" +"o For help, use the or cursor keys to highlight the help option\n" +" and press . You can try as well.\n" +"\n" +"\n" +"Text Box (Help Window)\n" +"--------\n" +"o Use the cursor keys to scroll up/down/left/right. The VI editor\n" +" keys h,j,k,l function here as do , , and for\n" +" those who are familiar with less and lynx.\n" +"\n" +"o Press , , , or to exit.\n" +"\n" +"\n" +"Alternate Configuration Files\n" +"-----------------------------\n" +"Menuconfig supports the use of alternate configuration files for\n" +"those who, for various reasons, find it necessary to switch\n" +"between different configurations.\n" +"\n" +"The button will let you save the current configuration to\n" +"a file of your choosing. Use the button to load a previously\n" +"saved alternate configuration.\n" +"\n" +"Even if you don't use alternate configuration files, but you find\n" +"during a Menuconfig session that you have completely messed up your\n" +"settings, you may use the button to restore your previously\n" +"saved settings from \".config\" without restarting Menuconfig.\n" +"\n" +"Other information\n" +"-----------------\n" +"If you use Menuconfig in an XTERM window, make sure you have your\n" +"$TERM variable set to point to an xterm definition which supports\n" +"color. Otherwise, Menuconfig will look rather bad. Menuconfig will\n" +"not display correctly in an RXVT window because rxvt displays only one\n" +"intensity of color, bright.\n" +"\n" +"Menuconfig will display larger menus on screens or xterms which are\n" +"set to display more than the standard 25 row by 80 column geometry.\n" +"In order for this to work, the \"stty size\" command must be able to\n" +"display the screen's current row and column geometry. I STRONGLY\n" +"RECOMMEND that you make sure you do NOT have the shell variables\n" +"LINES and COLUMNS exported into your environment. Some distributions\n" +"export those variables via /etc/profile. Some ncurses programs can\n" +"become confused when those variables (LINES & COLUMNS) don't reflect\n" +"the true screen size.\n" +"\n" +"Optional personality available\n" +"------------------------------\n" +"If you prefer to have all of the options listed in a single menu,\n" +"rather than the default multimenu hierarchy, run the menuconfig with\n" +"MENUCONFIG_MODE environment variable set to single_menu. Example:\n" +"\n" +"make MENUCONFIG_MODE=single_menu menuconfig\n" +"\n" +" will then unroll the appropriate category, or enfold it if it\n" +"is already unrolled.\n" +"\n" +"Note that this mode can eventually be a little more CPU expensive\n" +"(especially with a larger number of unrolled categories) than the\n" +"default mode.\n" +"\n" +"Different color themes available\n" +"--------------------------------\n" +"It is possible to select different color themes using the variable\n" +"MENUCONFIG_COLOR. To select a theme use:\n" +"\n" +"make MENUCONFIG_COLOR= menuconfig\n" +"\n" +"Available themes are\n" +" mono => selects colors suitable for monochrome displays\n" +" blackbg => selects a color scheme with black background\n" +" classic => theme with blue background. The classic look\n" +" bluetitle => an LCD friendly version of classic. (default)\n" +"\n"), +menu_instructions[] = N_( + "Arrow keys navigate the menu. " + " selects submenus ---> (or empty submenus ----). " + "Highlighted letters are hotkeys. " + "Pressing includes, excludes, modularizes features. " + "Press to exit, for Help, for Search. " + "Legend: [*] built-in [ ] excluded module < > module capable"), +radiolist_instructions[] = N_( + "Use the arrow keys to navigate this window or " + "press the hotkey of the item you wish to select " + "followed by the . " + "Press for additional information about this option."), +inputbox_instructions_int[] = N_( + "Please enter a decimal value. " + "Fractions will not be accepted. " + "Use the key to move from the input field to the buttons below it."), +inputbox_instructions_hex[] = N_( + "Please enter a hexadecimal value. " + "Use the key to move from the input field to the buttons below it."), +inputbox_instructions_string[] = N_( + "Please enter a string value. " + "Use the key to move from the input field to the buttons below it."), +setmod_text[] = N_( + "This feature depends on another which has been configured as a module.\n" + "As a result, this feature will be built as a module."), +load_config_text[] = N_( + "Enter the name of the configuration file you wish to load. " + "Accept the name shown to restore the configuration you " + "last retrieved. Leave blank to abort."), +load_config_help[] = N_( + "\n" + "For various reasons, one may wish to keep several different\n" + "configurations available on a single machine.\n" + "\n" + "If you have saved a previous configuration in a file other than the\n" + "default one, entering its name here will allow you to modify that\n" + "configuration.\n" + "\n" + "If you are uncertain, then you have probably never used alternate\n" + "configuration files. You should therefore leave this blank to abort.\n"), +save_config_text[] = N_( + "Enter a filename to which this configuration should be saved " + "as an alternate. Leave blank to abort."), +save_config_help[] = N_( + "\n" + "For various reasons, one may wish to keep different configurations\n" + "available on a single machine.\n" + "\n" + "Entering a file name here will allow you to later retrieve, modify\n" + "and use the current configuration as an alternate to whatever\n" + "configuration options you have selected at that time.\n" + "\n" + "If you are uncertain what all this means then you should probably\n" + "leave this blank.\n"), +search_help[] = N_( + "\n" + "Search for symbols and display their relations.\n" + "Regular expressions are allowed.\n" + "Example: search for \"^FOO\"\n" + "Result:\n" + "-----------------------------------------------------------------\n" + "Symbol: FOO [=m]\n" + "Type : tristate\n" + "Prompt: Foo bus is used to drive the bar HW\n" + " Location:\n" + " -> Bus options (PCI, PCMCIA, EISA, ISA)\n" + " -> PCI support (PCI [=y])\n" + "(1) -> PCI access mode ( [=y])\n" + " Defined at drivers/pci/Kconfig:47\n" + " Depends on: X86_LOCAL_APIC && X86_IO_APIC || IA64\n" + " Selects: LIBCRC32\n" + " Selected by: BAR [=n]\n" + "-----------------------------------------------------------------\n" + "o The line 'Type:' shows the type of the configuration option for\n" + " this symbol (boolean, tristate, string, ...)\n" + "o The line 'Prompt:' shows the text used in the menu structure for\n" + " this symbol\n" + "o The 'Defined at' line tells at what file / line number the symbol\n" + " is defined\n" + "o The 'Depends on:' line tells what symbols need to be defined for\n" + " this symbol to be visible in the menu (selectable)\n" + "o The 'Location:' lines tells where in the menu structure this symbol\n" + " is located\n" + " A location followed by a [=y] indicates that this is a\n" + " selectable menu item - and the current value is displayed inside\n" + " brackets.\n" + " Press the key in the (#) prefix to jump directly to that\n" + " location. You will be returned to the current search results\n" + " after exiting this new menu.\n" + "o The 'Selects:' line tells what symbols will be automatically\n" + " selected if this symbol is selected (y or m)\n" + "o The 'Selected by' line tells what symbol has selected this symbol\n" + "\n" + "Only relevant lines are shown.\n" + "\n\n" + "Search examples:\n" + "Examples: USB => find all symbols containing USB\n" + " ^USB => find all symbols starting with USB\n" + " USB$ => find all symbols ending with USB\n" + "\n"); + +static int indent; +static struct menu *current_menu; +static int child_count; +static int single_menu_mode; +static int show_all_options; +static int save_and_exit; +static int silent; + +static void conf(struct menu *menu, struct menu *active_menu); +static void conf_choice(struct menu *menu); +static void conf_string(struct menu *menu); +static void conf_load(void); +static void conf_save(void); +static int show_textbox_ext(const char *title, char *text, int r, int c, + int *keys, int *vscroll, int *hscroll, + update_text_fn update_text, void *data); +static void show_textbox(const char *title, const char *text, int r, int c); +static void show_helptext(const char *title, const char *text); +static void show_help(struct menu *menu); + +static char filename[PATH_MAX+1]; +static void set_config_filename(const char *config_filename) +{ + static char menu_backtitle[PATH_MAX+128]; + int size; + + size = snprintf(menu_backtitle, sizeof(menu_backtitle), + "%s - %s", config_filename, rootmenu.prompt->text); + if (size >= sizeof(menu_backtitle)) + menu_backtitle[sizeof(menu_backtitle)-1] = '\0'; + set_dialog_backtitle(menu_backtitle); + + size = snprintf(filename, sizeof(filename), "%s", config_filename); + if (size >= sizeof(filename)) + filename[sizeof(filename)-1] = '\0'; +} + +struct subtitle_part { + struct list_head entries; + const char *text; +}; +static LIST_HEAD(trail); + +static struct subtitle_list *subtitles; +static void set_subtitle(void) +{ + struct subtitle_part *sp; + struct subtitle_list *pos, *tmp; + + for (pos = subtitles; pos != NULL; pos = tmp) { + tmp = pos->next; + free(pos); + } + + subtitles = NULL; + list_for_each_entry(sp, &trail, entries) { + if (sp->text) { + if (pos) { + pos->next = xcalloc(1, sizeof(*pos)); + pos = pos->next; + } else { + subtitles = pos = xcalloc(1, sizeof(*pos)); + } + pos->text = sp->text; + } + } + + set_dialog_subtitles(subtitles); +} + +static void reset_subtitle(void) +{ + struct subtitle_list *pos, *tmp; + + for (pos = subtitles; pos != NULL; pos = tmp) { + tmp = pos->next; + free(pos); + } + subtitles = NULL; + set_dialog_subtitles(subtitles); +} + +struct search_data { + struct list_head *head; + struct menu **targets; + int *keys; +}; + +static void update_text(char *buf, size_t start, size_t end, void *_data) +{ + struct search_data *data = _data; + struct jump_key *pos; + int k = 0; + + list_for_each_entry(pos, data->head, entries) { + if (pos->offset >= start && pos->offset < end) { + char header[4]; + + if (k < JUMP_NB) { + int key = '0' + (pos->index % JUMP_NB) + 1; + + sprintf(header, "(%c)", key); + data->keys[k] = key; + data->targets[k] = pos->target; + k++; + } else { + sprintf(header, " "); + } + + memcpy(buf + pos->offset, header, sizeof(header) - 1); + } + } + data->keys[k] = 0; +} + +static void search_conf(void) +{ + struct symbol **sym_arr; + struct gstr res; + struct gstr title; + char *dialog_input; + int dres, vscroll = 0, hscroll = 0; + bool again; + struct gstr sttext; + struct subtitle_part stpart; + + title = str_new(); + str_printf( &title, _("Enter (sub)string or regexp to search for " + "(with or without \"%s\")"), CONFIG_); + +again: + dialog_clear(); + dres = dialog_inputbox(_("Search Configuration Parameter"), + str_get(&title), + 10, 75, ""); + switch (dres) { + case 0: + break; + case 1: + show_helptext(_("Search Configuration"), search_help); + goto again; + default: + str_free(&title); + return; + } + + /* strip the prefix if necessary */ + dialog_input = dialog_input_result; + if (strncasecmp(dialog_input_result, CONFIG_, strlen(CONFIG_)) == 0) + dialog_input += strlen(CONFIG_); + + sttext = str_new(); + str_printf(&sttext, "Search (%s)", dialog_input_result); + stpart.text = str_get(&sttext); + list_add_tail(&stpart.entries, &trail); + + sym_arr = sym_re_search(dialog_input); + do { + LIST_HEAD(head); + struct menu *targets[JUMP_NB]; + int keys[JUMP_NB + 1], i; + struct search_data data = { + .head = &head, + .targets = targets, + .keys = keys, + }; + struct jump_key *pos, *tmp; + + res = get_relations_str(sym_arr, &head); + set_subtitle(); + dres = show_textbox_ext(_("Search Results"), (char *) + str_get(&res), 0, 0, keys, &vscroll, + &hscroll, &update_text, (void *) + &data); + again = false; + for (i = 0; i < JUMP_NB && keys[i]; i++) + if (dres == keys[i]) { + conf(targets[i]->parent, targets[i]); + again = true; + } + str_free(&res); + list_for_each_entry_safe(pos, tmp, &head, entries) + free(pos); + } while (again); + free(sym_arr); + str_free(&title); + list_del(trail.prev); + str_free(&sttext); +} + +static void build_conf(struct menu *menu) +{ + struct symbol *sym; + struct property *prop; + struct menu *child; + int type, tmp, doint = 2; + tristate val; + char ch; + bool visible; + + /* + * note: menu_is_visible() has side effect that it will + * recalc the value of the symbol. + */ + visible = menu_is_visible(menu); + if (show_all_options && !menu_has_prompt(menu)) + return; + else if (!show_all_options && !visible) + return; + + sym = menu->sym; + prop = menu->prompt; + if (!sym) { + if (prop && menu != current_menu) { + const char *prompt = menu_get_prompt(menu); + switch (prop->type) { + case P_MENU: + child_count++; + prompt = _(prompt); + if (single_menu_mode) { + item_make("%s%*c%s", + menu->data ? "-->" : "++>", + indent + 1, ' ', prompt); + } else + item_make(" %*c%s %s", + indent + 1, ' ', prompt, + menu_is_empty(menu) ? "----" : "--->"); + item_set_tag('m'); + item_set_data(menu); + if (single_menu_mode && menu->data) + goto conf_childs; + return; + case P_COMMENT: + if (prompt) { + child_count++; + item_make(" %*c*** %s ***", indent + 1, ' ', _(prompt)); + item_set_tag(':'); + item_set_data(menu); + } + break; + default: + if (prompt) { + child_count++; + item_make("---%*c%s", indent + 1, ' ', _(prompt)); + item_set_tag(':'); + item_set_data(menu); + } + } + } else + doint = 0; + goto conf_childs; + } + + type = sym_get_type(sym); + if (sym_is_choice(sym)) { + struct symbol *def_sym = sym_get_choice_value(sym); + struct menu *def_menu = NULL; + + child_count++; + for (child = menu->list; child; child = child->next) { + if (menu_is_visible(child) && child->sym == def_sym) + def_menu = child; + } + + val = sym_get_tristate_value(sym); + if (sym_is_changable(sym)) { + switch (type) { + case S_BOOLEAN: + item_make("[%c]", val == no ? ' ' : '*'); + break; + case S_TRISTATE: + switch (val) { + case yes: ch = '*'; break; + case mod: ch = 'M'; break; + default: ch = ' '; break; + } + item_make("<%c>", ch); + break; + } + item_set_tag('t'); + item_set_data(menu); + } else { + item_make(" "); + item_set_tag(def_menu ? 't' : ':'); + item_set_data(menu); + } + + item_add_str("%*c%s", indent + 1, ' ', _(menu_get_prompt(menu))); + if (val == yes) { + if (def_menu) { + item_add_str(" (%s)", _(menu_get_prompt(def_menu))); + item_add_str(" --->"); + if (def_menu->list) { + indent += 2; + build_conf(def_menu); + indent -= 2; + } + } + return; + } + } else { + if (menu == current_menu) { + item_make("---%*c%s", indent + 1, ' ', _(menu_get_prompt(menu))); + item_set_tag(':'); + item_set_data(menu); + goto conf_childs; + } + child_count++; + val = sym_get_tristate_value(sym); + if (sym_is_choice_value(sym) && val == yes) { + item_make(" "); + item_set_tag(':'); + item_set_data(menu); + } else { + switch (type) { + case S_BOOLEAN: + if (sym_is_changable(sym)) + item_make("[%c]", val == no ? ' ' : '*'); + else + item_make("-%c-", val == no ? ' ' : '*'); + item_set_tag('t'); + item_set_data(menu); + break; + case S_TRISTATE: + switch (val) { + case yes: ch = '*'; break; + case mod: ch = 'M'; break; + default: ch = ' '; break; + } + if (sym_is_changable(sym)) { + if (sym->rev_dep.tri == mod) + item_make("{%c}", ch); + else + item_make("<%c>", ch); + } else + item_make("-%c-", ch); + item_set_tag('t'); + item_set_data(menu); + break; + default: + tmp = 2 + strlen(sym_get_string_value(sym)); /* () = 2 */ + item_make("(%s)", sym_get_string_value(sym)); + tmp = indent - tmp + 4; + if (tmp < 0) + tmp = 0; + item_add_str("%*c%s%s", tmp, ' ', _(menu_get_prompt(menu)), + (sym_has_value(sym) || !sym_is_changable(sym)) ? + "" : _(" (NEW)")); + item_set_tag('s'); + item_set_data(menu); + goto conf_childs; + } + } + item_add_str("%*c%s%s", indent + 1, ' ', _(menu_get_prompt(menu)), + (sym_has_value(sym) || !sym_is_changable(sym)) ? + "" : _(" (NEW)")); + if (menu->prompt->type == P_MENU) { + item_add_str(" %s", menu_is_empty(menu) ? "----" : "--->"); + return; + } + } + +conf_childs: + indent += doint; + for (child = menu->list; child; child = child->next) + build_conf(child); + indent -= doint; +} + +static void conf(struct menu *menu, struct menu *active_menu) +{ + struct menu *submenu; + const char *prompt = menu_get_prompt(menu); + struct subtitle_part stpart; + struct symbol *sym; + int res; + int s_scroll = 0; + + if (menu != &rootmenu) + stpart.text = menu_get_prompt(menu); + else + stpart.text = NULL; + list_add_tail(&stpart.entries, &trail); + + while (1) { + item_reset(); + current_menu = menu; + build_conf(menu); + if (!child_count) + break; + set_subtitle(); + dialog_clear(); + res = dialog_menu(prompt ? _(prompt) : _("Main Menu"), + _(menu_instructions), + active_menu, &s_scroll); + if (res == 1 || res == KEY_ESC || res == -ERRDISPLAYTOOSMALL) + break; + if (item_count() != 0) { + if (!item_activate_selected()) + continue; + if (!item_tag()) + continue; + } + submenu = item_data(); + active_menu = item_data(); + if (submenu) + sym = submenu->sym; + else + sym = NULL; + + switch (res) { + case 0: + switch (item_tag()) { + case 'm': + if (single_menu_mode) + submenu->data = (void *) (long) !submenu->data; + else + conf(submenu, NULL); + break; + case 't': + if (sym_is_choice(sym) && sym_get_tristate_value(sym) == yes) + conf_choice(submenu); + else if (submenu->prompt->type == P_MENU) + conf(submenu, NULL); + break; + case 's': + conf_string(submenu); + break; + } + break; + case 2: + if (sym) + show_help(submenu); + else { + reset_subtitle(); + show_helptext(_("README"), _(mconf_readme)); + } + break; + case 3: + reset_subtitle(); + conf_save(); + break; + case 4: + reset_subtitle(); + conf_load(); + break; + case 5: + if (item_is_tag('t')) { + if (sym_set_tristate_value(sym, yes)) + break; + if (sym_set_tristate_value(sym, mod)) + show_textbox(NULL, setmod_text, 6, 74); + } + break; + case 6: + if (item_is_tag('t')) + sym_set_tristate_value(sym, no); + break; + case 7: + if (item_is_tag('t')) + sym_set_tristate_value(sym, mod); + break; + case 8: + if (item_is_tag('t')) + sym_toggle_tristate_value(sym); + else if (item_is_tag('m')) + conf(submenu, NULL); + break; + case 9: + search_conf(); + break; + case 10: + show_all_options = !show_all_options; + break; + } + } + + list_del(trail.prev); +} + +static int show_textbox_ext(const char *title, char *text, int r, int c, int + *keys, int *vscroll, int *hscroll, update_text_fn + update_text, void *data) +{ + dialog_clear(); + return dialog_textbox(title, text, r, c, keys, vscroll, hscroll, + update_text, data); +} + +static void show_textbox(const char *title, const char *text, int r, int c) +{ + show_textbox_ext(title, (char *) text, r, c, (int []) {0}, NULL, NULL, + NULL, NULL); +} + +static void show_helptext(const char *title, const char *text) +{ + show_textbox(title, text, 0, 0); +} + +static void conf_message_callback(const char *fmt, va_list ap) +{ + char buf[PATH_MAX+1]; + + vsnprintf(buf, sizeof(buf), fmt, ap); + if (save_and_exit) { + if (!silent) + printf("%s", buf); + } else { + show_textbox(NULL, buf, 6, 60); + } +} + +static void show_help(struct menu *menu) +{ + struct gstr help = str_new(); + + help.max_width = getmaxx(stdscr) - 10; + menu_get_ext_help(menu, &help); + + show_helptext(_(menu_get_prompt(menu)), str_get(&help)); + str_free(&help); +} + +static void conf_choice(struct menu *menu) +{ + const char *prompt = _(menu_get_prompt(menu)); + struct menu *child; + struct symbol *active; + + active = sym_get_choice_value(menu->sym); + while (1) { + int res; + int selected; + item_reset(); + + current_menu = menu; + for (child = menu->list; child; child = child->next) { + if (!menu_is_visible(child)) + continue; + if (child->sym) + item_make("%s", _(menu_get_prompt(child))); + else { + item_make("*** %s ***", _(menu_get_prompt(child))); + item_set_tag(':'); + } + item_set_data(child); + if (child->sym == active) + item_set_selected(1); + if (child->sym == sym_get_choice_value(menu->sym)) + item_set_tag('X'); + } + dialog_clear(); + res = dialog_checklist(prompt ? _(prompt) : _("Main Menu"), + _(radiolist_instructions), + MENUBOX_HEIGTH_MIN, + MENUBOX_WIDTH_MIN, + CHECKLIST_HEIGTH_MIN); + selected = item_activate_selected(); + switch (res) { + case 0: + if (selected) { + child = item_data(); + if (!child->sym) + break; + + sym_set_tristate_value(child->sym, yes); + } + return; + case 1: + if (selected) { + child = item_data(); + show_help(child); + active = child->sym; + } else + show_help(menu); + break; + case KEY_ESC: + return; + case -ERRDISPLAYTOOSMALL: + return; + } + } +} + +static void conf_string(struct menu *menu) +{ + const char *prompt = menu_get_prompt(menu); + + while (1) { + int res; + const char *heading; + + switch (sym_get_type(menu->sym)) { + case S_INT: + heading = _(inputbox_instructions_int); + break; + case S_HEX: + heading = _(inputbox_instructions_hex); + break; + case S_STRING: + heading = _(inputbox_instructions_string); + break; + default: + heading = _("Internal mconf error!"); + } + dialog_clear(); + res = dialog_inputbox(prompt ? _(prompt) : _("Main Menu"), + heading, 10, 75, + sym_get_string_value(menu->sym)); + switch (res) { + case 0: + if (sym_set_string_value(menu->sym, dialog_input_result)) + return; + show_textbox(NULL, _("You have made an invalid entry."), 5, 43); + break; + case 1: + show_help(menu); + break; + case KEY_ESC: + return; + } + } +} + +static void conf_load(void) +{ + + while (1) { + int res; + dialog_clear(); + res = dialog_inputbox(NULL, load_config_text, + 11, 55, filename); + switch(res) { + case 0: + if (!dialog_input_result[0]) + return; + if (!conf_read(dialog_input_result)) { + set_config_filename(dialog_input_result); + sym_set_change_count(1); + return; + } + show_textbox(NULL, _("File does not exist!"), 5, 38); + break; + case 1: + show_helptext(_("Load Alternate Configuration"), load_config_help); + break; + case KEY_ESC: + return; + } + } +} + +static void conf_save(void) +{ + while (1) { + int res; + dialog_clear(); + res = dialog_inputbox(NULL, save_config_text, + 11, 55, filename); + switch(res) { + case 0: + if (!dialog_input_result[0]) + return; + if (!conf_write(dialog_input_result)) { + set_config_filename(dialog_input_result); + return; + } + show_textbox(NULL, _("Can't create file! Probably a nonexistent directory."), 5, 60); + break; + case 1: + show_helptext(_("Save Alternate Configuration"), save_config_help); + break; + case KEY_ESC: + return; + } + } +} + +static int handle_exit(void) +{ + int res; + + save_and_exit = 1; + reset_subtitle(); + dialog_clear(); + if (conf_get_changed()) + res = dialog_yesno(NULL, + _("Do you wish to save your new configuration?\n" + "(Press to continue kernel configuration.)"), + 6, 60); + else + res = -1; + + end_dialog(saved_x, saved_y); + + switch (res) { + case 0: + if (conf_write(filename)) { + fprintf(stderr, _("\n\n" + "Error while writing of the configuration.\n" + "Your configuration changes were NOT saved." + "\n\n")); + return 1; + } + /* fall through */ + case -1: + if (!silent) + printf(_("\n\n" + "*** End of the configuration.\n" + "*** Execute 'make' to start the build or try 'make help'." + "\n\n")); + res = 0; + break; + default: + if (!silent) + fprintf(stderr, _("\n\n" + "Your configuration changes were NOT saved." + "\n\n")); + if (res != KEY_ESC) + res = 0; + } + + return res; +} + +static void sig_handler(int signo) +{ + exit(handle_exit()); +} + +int main(int ac, char **av) +{ + char *mode; + int res; + + setlocale(LC_ALL, ""); + bindtextdomain(PACKAGE, LOCALEDIR); + textdomain(PACKAGE); + + signal(SIGINT, sig_handler); + + if (ac > 1 && strcmp(av[1], "-s") == 0) { + silent = 1; + /* Silence conf_read() until the real callback is set up */ + conf_set_message_callback(NULL); + av++; + } + conf_parse(av[1]); + conf_read(NULL); + + mode = getenv("MENUCONFIG_MODE"); + if (mode) { + if (!strcasecmp(mode, "single_menu")) + single_menu_mode = 1; + } + + if (init_dialog(NULL)) { + fprintf(stderr, N_("Your display is too small to run Menuconfig!\n")); + fprintf(stderr, N_("It must be at least 19 lines by 80 columns.\n")); + return 1; + } + + set_config_filename(conf_get_configname()); + conf_set_message_callback(conf_message_callback); + do { + conf(&rootmenu, NULL); + res = handle_exit(); + } while (res == KEY_ESC); + + return res; +} diff --git a/tools/kconfig/menu.c b/tools/kconfig/menu.c new file mode 100644 index 000000000..aed678e8a --- /dev/null +++ b/tools/kconfig/menu.c @@ -0,0 +1,697 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include + +#include "lkc.h" + +static const char nohelp_text[] = "There is no help available for this option."; + +struct menu rootmenu; +static struct menu **last_entry_ptr; + +struct file *file_list; +struct file *current_file; + +void menu_warn(struct menu *menu, const char *fmt, ...) +{ + va_list ap; + va_start(ap, fmt); + fprintf(stderr, "%s:%d:warning: ", menu->file->name, menu->lineno); + vfprintf(stderr, fmt, ap); + fprintf(stderr, "\n"); + va_end(ap); +} + +static void prop_warn(struct property *prop, const char *fmt, ...) +{ + va_list ap; + va_start(ap, fmt); + fprintf(stderr, "%s:%d:warning: ", prop->file->name, prop->lineno); + vfprintf(stderr, fmt, ap); + fprintf(stderr, "\n"); + va_end(ap); +} + +void _menu_init(void) +{ + current_entry = current_menu = &rootmenu; + last_entry_ptr = &rootmenu.list; +} + +void menu_add_entry(struct symbol *sym) +{ + struct menu *menu; + + menu = xmalloc(sizeof(*menu)); + memset(menu, 0, sizeof(*menu)); + menu->sym = sym; + menu->parent = current_menu; + menu->file = current_file; + menu->lineno = zconf_lineno(); + + *last_entry_ptr = menu; + last_entry_ptr = &menu->next; + current_entry = menu; + if (sym) + menu_add_symbol(P_SYMBOL, sym, NULL); +} + +void menu_end_entry(void) +{ +} + +struct menu *menu_add_menu(void) +{ + menu_end_entry(); + last_entry_ptr = ¤t_entry->list; + return current_menu = current_entry; +} + +void menu_end_menu(void) +{ + last_entry_ptr = ¤t_menu->next; + current_menu = current_menu->parent; +} + +static struct expr *menu_check_dep(struct expr *e) +{ + if (!e) + return e; + + switch (e->type) { + case E_NOT: + e->left.expr = menu_check_dep(e->left.expr); + break; + case E_OR: + case E_AND: + e->left.expr = menu_check_dep(e->left.expr); + e->right.expr = menu_check_dep(e->right.expr); + break; + case E_SYMBOL: + /* change 'm' into 'm' && MODULES */ + if (e->left.sym == &symbol_mod) + return expr_alloc_and(e, expr_alloc_symbol(modules_sym)); + break; + default: + break; + } + return e; +} + +void menu_add_dep(struct expr *dep) +{ + current_entry->dep = expr_alloc_and(current_entry->dep, menu_check_dep(dep)); +} + +void menu_set_type(int type) +{ + struct symbol *sym = current_entry->sym; + + if (sym->type == type) + return; + if (sym->type == S_UNKNOWN) { + sym->type = type; + return; + } + menu_warn(current_entry, + "ignoring type redefinition of '%s' from '%s' to '%s'", + sym->name ? sym->name : "", + sym_type_name(sym->type), sym_type_name(type)); +} + +static struct property *menu_add_prop(enum prop_type type, char *prompt, struct expr *expr, struct expr *dep) +{ + struct property *prop = prop_alloc(type, current_entry->sym); + + prop->menu = current_entry; + prop->expr = expr; + prop->visible.expr = menu_check_dep(dep); + + if (prompt) { + if (isspace(*prompt)) { + prop_warn(prop, "leading whitespace ignored"); + while (isspace(*prompt)) + prompt++; + } + if (current_entry->prompt && current_entry != &rootmenu) + prop_warn(prop, "prompt redefined"); + + /* Apply all upper menus' visibilities to actual prompts. */ + if(type == P_PROMPT) { + struct menu *menu = current_entry; + + while ((menu = menu->parent) != NULL) { + struct expr *dup_expr; + + if (!menu->visibility) + continue; + /* + * Do not add a reference to the + * menu's visibility expression but + * use a copy of it. Otherwise the + * expression reduction functions + * will modify expressions that have + * multiple references which can + * cause unwanted side effects. + */ + dup_expr = expr_copy(menu->visibility); + + prop->visible.expr + = expr_alloc_and(prop->visible.expr, + dup_expr); + } + } + + current_entry->prompt = prop; + } + prop->text = prompt; + + return prop; +} + +struct property *menu_add_prompt(enum prop_type type, char *prompt, struct expr *dep) +{ + return menu_add_prop(type, prompt, NULL, dep); +} + +void menu_add_visibility(struct expr *expr) +{ + current_entry->visibility = expr_alloc_and(current_entry->visibility, + expr); +} + +void menu_add_expr(enum prop_type type, struct expr *expr, struct expr *dep) +{ + menu_add_prop(type, NULL, expr, dep); +} + +void menu_add_symbol(enum prop_type type, struct symbol *sym, struct expr *dep) +{ + menu_add_prop(type, NULL, expr_alloc_symbol(sym), dep); +} + +void menu_add_option(int token, char *arg) +{ + switch (token) { + case T_OPT_MODULES: + if (modules_sym) + zconf_error("symbol '%s' redefines option 'modules'" + " already defined by symbol '%s'", + current_entry->sym->name, + modules_sym->name + ); + modules_sym = current_entry->sym; + break; + case T_OPT_DEFCONFIG_LIST: + if (!sym_defconfig_list) + sym_defconfig_list = current_entry->sym; + else if (sym_defconfig_list != current_entry->sym) + zconf_error("trying to redefine defconfig symbol"); + break; + case T_OPT_ENV: + prop_add_env(arg); + break; + case T_OPT_ALLNOCONFIG_Y: + current_entry->sym->flags |= SYMBOL_ALLNOCONFIG_Y; + break; + } +} + +static int menu_validate_number(struct symbol *sym, struct symbol *sym2) +{ + return sym2->type == S_INT || sym2->type == S_HEX || + (sym2->type == S_UNKNOWN && sym_string_valid(sym, sym2->name)); +} + +static void sym_check_prop(struct symbol *sym) +{ + struct property *prop; + struct symbol *sym2; + for (prop = sym->prop; prop; prop = prop->next) { + switch (prop->type) { + case P_DEFAULT: + if ((sym->type == S_STRING || sym->type == S_INT || sym->type == S_HEX) && + prop->expr->type != E_SYMBOL) + prop_warn(prop, + "default for config symbol '%s'" + " must be a single symbol", sym->name); + if (prop->expr->type != E_SYMBOL) + break; + sym2 = prop_get_symbol(prop); + if (sym->type == S_HEX || sym->type == S_INT) { + if (!menu_validate_number(sym, sym2)) + prop_warn(prop, + "'%s': number is invalid", + sym->name); + } + break; + case P_SELECT: + sym2 = prop_get_symbol(prop); + if (sym->type != S_BOOLEAN && sym->type != S_TRISTATE) + prop_warn(prop, + "config symbol '%s' uses select, but is " + "not boolean or tristate", sym->name); + else if (sym2->type != S_UNKNOWN && + sym2->type != S_BOOLEAN && + sym2->type != S_TRISTATE) + prop_warn(prop, + "'%s' has wrong type. 'select' only " + "accept arguments of boolean and " + "tristate type", sym2->name); + break; + case P_RANGE: + if (sym->type != S_INT && sym->type != S_HEX) + prop_warn(prop, "range is only allowed " + "for int or hex symbols"); + if (!menu_validate_number(sym, prop->expr->left.sym) || + !menu_validate_number(sym, prop->expr->right.sym)) + prop_warn(prop, "range is invalid"); + break; + default: + ; + } + } +} + +void menu_finalize(struct menu *parent) +{ + struct menu *menu, *last_menu; + struct symbol *sym; + struct property *prop; + struct expr *parentdep, *basedep, *dep, *dep2, **ep; + + sym = parent->sym; + if (parent->list) { + if (sym && sym_is_choice(sym)) { + if (sym->type == S_UNKNOWN) { + /* find the first choice value to find out choice type */ + current_entry = parent; + for (menu = parent->list; menu; menu = menu->next) { + if (menu->sym && menu->sym->type != S_UNKNOWN) { + menu_set_type(menu->sym->type); + break; + } + } + } + /* set the type of the remaining choice values */ + for (menu = parent->list; menu; menu = menu->next) { + current_entry = menu; + if (menu->sym && menu->sym->type == S_UNKNOWN) + menu_set_type(sym->type); + } + parentdep = expr_alloc_symbol(sym); + } else if (parent->prompt) + parentdep = parent->prompt->visible.expr; + else + parentdep = parent->dep; + + for (menu = parent->list; menu; menu = menu->next) { + basedep = expr_transform(menu->dep); + basedep = expr_alloc_and(expr_copy(parentdep), basedep); + basedep = expr_eliminate_dups(basedep); + menu->dep = basedep; + if (menu->sym) + prop = menu->sym->prop; + else + prop = menu->prompt; + for (; prop; prop = prop->next) { + if (prop->menu != menu) + continue; + dep = expr_transform(prop->visible.expr); + dep = expr_alloc_and(expr_copy(basedep), dep); + dep = expr_eliminate_dups(dep); + if (menu->sym && menu->sym->type != S_TRISTATE) + dep = expr_trans_bool(dep); + prop->visible.expr = dep; + if (prop->type == P_SELECT) { + struct symbol *es = prop_get_symbol(prop); + es->rev_dep.expr = expr_alloc_or(es->rev_dep.expr, + expr_alloc_and(expr_alloc_symbol(menu->sym), expr_copy(dep))); + } + } + } + for (menu = parent->list; menu; menu = menu->next) + menu_finalize(menu); + } else if (sym) { + basedep = parent->prompt ? parent->prompt->visible.expr : NULL; + basedep = expr_trans_compare(basedep, E_UNEQUAL, &symbol_no); + basedep = expr_eliminate_dups(expr_transform(basedep)); + last_menu = NULL; + for (menu = parent->next; menu; menu = menu->next) { + dep = menu->prompt ? menu->prompt->visible.expr : menu->dep; + if (!expr_contains_symbol(dep, sym)) + break; + if (expr_depends_symbol(dep, sym)) + goto next; + dep = expr_trans_compare(dep, E_UNEQUAL, &symbol_no); + dep = expr_eliminate_dups(expr_transform(dep)); + dep2 = expr_copy(basedep); + expr_eliminate_eq(&dep, &dep2); + expr_free(dep); + if (!expr_is_yes(dep2)) { + expr_free(dep2); + break; + } + expr_free(dep2); + next: + menu_finalize(menu); + menu->parent = parent; + last_menu = menu; + } + if (last_menu) { + parent->list = parent->next; + parent->next = last_menu->next; + last_menu->next = NULL; + } + + sym->dir_dep.expr = expr_alloc_or(sym->dir_dep.expr, parent->dep); + } + for (menu = parent->list; menu; menu = menu->next) { + if (sym && sym_is_choice(sym) && + menu->sym && !sym_is_choice_value(menu->sym)) { + current_entry = menu; + menu->sym->flags |= SYMBOL_CHOICEVAL; + if (!menu->prompt) + menu_warn(menu, "choice value must have a prompt"); + for (prop = menu->sym->prop; prop; prop = prop->next) { + if (prop->type == P_DEFAULT) + prop_warn(prop, "defaults for choice " + "values not supported"); + if (prop->menu == menu) + continue; + if (prop->type == P_PROMPT && + prop->menu->parent->sym != sym) + prop_warn(prop, "choice value used outside its choice group"); + } + /* Non-tristate choice values of tristate choices must + * depend on the choice being set to Y. The choice + * values' dependencies were propagated to their + * properties above, so the change here must be re- + * propagated. + */ + if (sym->type == S_TRISTATE && menu->sym->type != S_TRISTATE) { + basedep = expr_alloc_comp(E_EQUAL, sym, &symbol_yes); + menu->dep = expr_alloc_and(basedep, menu->dep); + for (prop = menu->sym->prop; prop; prop = prop->next) { + if (prop->menu != menu) + continue; + prop->visible.expr = expr_alloc_and(expr_copy(basedep), + prop->visible.expr); + } + } + menu_add_symbol(P_CHOICE, sym, NULL); + prop = sym_get_choice_prop(sym); + for (ep = &prop->expr; *ep; ep = &(*ep)->left.expr) + ; + *ep = expr_alloc_one(E_LIST, NULL); + (*ep)->right.sym = menu->sym; + } + if (menu->list && (!menu->prompt || !menu->prompt->text)) { + for (last_menu = menu->list; ; last_menu = last_menu->next) { + last_menu->parent = parent; + if (!last_menu->next) + break; + } + last_menu->next = menu->next; + menu->next = menu->list; + menu->list = NULL; + } + } + + if (sym && !(sym->flags & SYMBOL_WARNED)) { + if (sym->type == S_UNKNOWN) + menu_warn(parent, "config symbol defined without type"); + + if (sym_is_choice(sym) && !parent->prompt) + menu_warn(parent, "choice must have a prompt"); + + /* Check properties connected to this symbol */ + sym_check_prop(sym); + sym->flags |= SYMBOL_WARNED; + } + + if (sym && !sym_is_optional(sym) && parent->prompt) { + sym->rev_dep.expr = expr_alloc_or(sym->rev_dep.expr, + expr_alloc_and(parent->prompt->visible.expr, + expr_alloc_symbol(&symbol_mod))); + } +} + +bool menu_has_prompt(struct menu *menu) +{ + if (!menu->prompt) + return false; + return true; +} + +/* + * Determine if a menu is empty. + * A menu is considered empty if it contains no or only + * invisible entries. + */ +bool menu_is_empty(struct menu *menu) +{ + struct menu *child; + + for (child = menu->list; child; child = child->next) { + if (menu_is_visible(child)) + return(false); + } + return(true); +} + +bool menu_is_visible(struct menu *menu) +{ + struct menu *child; + struct symbol *sym; + tristate visible; + + if (!menu->prompt) + return false; + + if (menu->visibility) { + if (expr_calc_value(menu->visibility) == no) + return false; + } + + sym = menu->sym; + if (sym) { + sym_calc_value(sym); + visible = menu->prompt->visible.tri; + } else + visible = menu->prompt->visible.tri = expr_calc_value(menu->prompt->visible.expr); + + if (visible != no) + return true; + + if (!sym || sym_get_tristate_value(menu->sym) == no) + return false; + + for (child = menu->list; child; child = child->next) { + if (menu_is_visible(child)) { + if (sym) + sym->flags |= SYMBOL_DEF_USER; + return true; + } + } + + return false; +} + +const char *menu_get_prompt(struct menu *menu) +{ + if (menu->prompt) + return menu->prompt->text; + else if (menu->sym) + return menu->sym->name; + return NULL; +} + +struct menu *menu_get_root_menu(struct menu *menu) +{ + return &rootmenu; +} + +struct menu *menu_get_parent_menu(struct menu *menu) +{ + enum prop_type type; + + for (; menu != &rootmenu; menu = menu->parent) { + type = menu->prompt ? menu->prompt->type : 0; + if (type == P_MENU) + break; + } + return menu; +} + +bool menu_has_help(struct menu *menu) +{ + return menu->help != NULL; +} + +const char *menu_get_help(struct menu *menu) +{ + if (menu->help) + return menu->help; + else + return ""; +} + +static void get_prompt_str(struct gstr *r, struct property *prop, + struct list_head *head) +{ + int i, j; + struct menu *submenu[8], *menu, *location = NULL; + struct jump_key *jump = NULL; + + str_printf(r, _("Prompt: %s\n"), _(prop->text)); + menu = prop->menu->parent; + for (i = 0; menu != &rootmenu && i < 8; menu = menu->parent) { + bool accessible = menu_is_visible(menu); + + submenu[i++] = menu; + if (location == NULL && accessible) + location = menu; + } + if (head && location) { + jump = xmalloc(sizeof(struct jump_key)); + + if (menu_is_visible(prop->menu)) { + /* + * There is not enough room to put the hint at the + * beginning of the "Prompt" line. Put the hint on the + * last "Location" line even when it would belong on + * the former. + */ + jump->target = prop->menu; + } else + jump->target = location; + + if (list_empty(head)) + jump->index = 0; + else + jump->index = list_entry(head->prev, struct jump_key, + entries)->index + 1; + + list_add_tail(&jump->entries, head); + } + + if (i > 0) { + str_printf(r, _(" Location:\n")); + for (j = 4; --i >= 0; j += 2) { + menu = submenu[i]; + if (jump && menu == location) + jump->offset = strlen(r->s); + str_printf(r, "%*c-> %s", j, ' ', + _(menu_get_prompt(menu))); + if (menu->sym) { + str_printf(r, " (%s [=%s])", menu->sym->name ? + menu->sym->name : _(""), + sym_get_string_value(menu->sym)); + } + str_append(r, "\n"); + } + } +} + +/* + * get property of type P_SYMBOL + */ +static struct property *get_symbol_prop(struct symbol *sym) +{ + struct property *prop = NULL; + + for_all_properties(sym, prop, P_SYMBOL) + break; + return prop; +} + +/* + * head is optional and may be NULL + */ +static void get_symbol_str(struct gstr *r, struct symbol *sym, + struct list_head *head) +{ + bool hit; + struct property *prop; + + if (sym && sym->name) { + str_printf(r, "Symbol: %s [=%s]\n", sym->name, + sym_get_string_value(sym)); + str_printf(r, "Type : %s\n", sym_type_name(sym->type)); + if (sym->type == S_INT || sym->type == S_HEX) { + prop = sym_get_range_prop(sym); + if (prop) { + str_printf(r, "Range : "); + expr_gstr_print(prop->expr, r); + str_append(r, "\n"); + } + } + } + for_all_prompts(sym, prop) + get_prompt_str(r, prop, head); + + prop = get_symbol_prop(sym); + if (prop) { + str_printf(r, _(" Defined at %s:%d\n"), prop->menu->file->name, + prop->menu->lineno); + if (!expr_is_yes(prop->visible.expr)) { + str_append(r, _(" Depends on: ")); + expr_gstr_print(prop->visible.expr, r); + str_append(r, "\n"); + } + } + + hit = false; + for_all_properties(sym, prop, P_SELECT) { + if (!hit) { + str_append(r, " Selects: "); + hit = true; + } else + str_printf(r, " && "); + expr_gstr_print(prop->expr, r); + } + if (hit) + str_append(r, "\n"); + if (sym->rev_dep.expr) { + str_append(r, _(" Selected by: ")); + expr_gstr_print(sym->rev_dep.expr, r); + str_append(r, "\n"); + } + str_append(r, "\n\n"); +} + +struct gstr get_relations_str(struct symbol **sym_arr, struct list_head *head) +{ + struct symbol *sym; + struct gstr res = str_new(); + int i; + + for (i = 0; sym_arr && (sym = sym_arr[i]); i++) + get_symbol_str(&res, sym, head); + if (!i) + str_append(&res, _("No matches found.\n")); + return res; +} + + +void menu_get_ext_help(struct menu *menu, struct gstr *help) +{ + struct symbol *sym = menu->sym; + const char *help_text = nohelp_text; + + if (menu_has_help(menu)) { + if (sym->name) + str_printf(help, "%s%s:\n\n", CONFIG_, sym->name); + help_text = menu_get_help(menu); + } + str_printf(help, "%s\n", _(help_text)); + if (sym) + get_symbol_str(help, sym, NULL); +} diff --git a/tools/kconfig/merge_config.sh b/tools/kconfig/merge_config.sh new file mode 100755 index 000000000..67d131447 --- /dev/null +++ b/tools/kconfig/merge_config.sh @@ -0,0 +1,170 @@ +#!/bin/sh +# merge_config.sh - Takes a list of config fragment values, and merges +# them one by one. Provides warnings on overridden values, and specified +# values that did not make it to the resulting .config file (due to missed +# dependencies or config symbol removal). +# +# Portions reused from kconf_check and generate_cfg: +# http://git.yoctoproject.org/cgit/cgit.cgi/yocto-kernel-tools/tree/tools/kconf_check +# http://git.yoctoproject.org/cgit/cgit.cgi/yocto-kernel-tools/tree/tools/generate_cfg +# +# Copyright (c) 2009-2010 Wind River Systems, Inc. +# Copyright 2011 Linaro +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License version 2 as +# published by the Free Software Foundation. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +# See the GNU General Public License for more details. + +clean_up() { + rm -f $TMP_FILE + exit +} +trap clean_up HUP INT TERM + +usage() { + echo "Usage: $0 [OPTIONS] [CONFIG [...]]" + echo " -h display this help text" + echo " -m only merge the fragments, do not execute the make command" + echo " -n use allnoconfig instead of alldefconfig" + echo " -r list redundant entries when merging fragments" + echo " -O dir to put generated output files. Consider setting \$KCONFIG_CONFIG instead." +} + +RUNMAKE=true +ALLTARGET=alldefconfig +WARNREDUN=false +OUTPUT=. + +while true; do + case $1 in + "-n") + ALLTARGET=allnoconfig + shift + continue + ;; + "-m") + RUNMAKE=false + shift + continue + ;; + "-h") + usage + exit + ;; + "-r") + WARNREDUN=true + shift + continue + ;; + "-O") + if [ -d $2 ];then + OUTPUT=$(echo $2 | sed 's/\/*$//') + else + echo "output directory $2 does not exist" 1>&2 + exit 1 + fi + shift 2 + continue + ;; + *) + break + ;; + esac +done + +if [ "$#" -lt 1 ] ; then + usage + exit +fi + +if [ -z "$KCONFIG_CONFIG" ]; then + if [ "$OUTPUT" != . ]; then + KCONFIG_CONFIG=$(readlink -m -- "$OUTPUT/.config") + else + KCONFIG_CONFIG=.config + fi +fi + +INITFILE=$1 +shift; + +if [ ! -r "$INITFILE" ]; then + echo "The base file '$INITFILE' does not exist. Exit." >&2 + exit 1 +fi + +MERGE_LIST=$* +SED_CONFIG_EXP="s/^\(# \)\{0,1\}\(CONFIG_[a-zA-Z0-9_]*\)[= ].*/\2/p" +TMP_FILE=$(mktemp ./.tmp.config.XXXXXXXXXX) + +echo "Using $INITFILE as base" +cat $INITFILE > $TMP_FILE + +# Merge files, printing warnings on overridden values +for MERGE_FILE in $MERGE_LIST ; do + echo "Merging $MERGE_FILE" + if [ ! -r "$MERGE_FILE" ]; then + echo "The merge file '$MERGE_FILE' does not exist. Exit." >&2 + exit 1 + fi + CFG_LIST=$(sed -n "$SED_CONFIG_EXP" $MERGE_FILE) + + for CFG in $CFG_LIST ; do + grep -q -w $CFG $TMP_FILE || continue + PREV_VAL=$(grep -w $CFG $TMP_FILE) + NEW_VAL=$(grep -w $CFG $MERGE_FILE) + if [ "x$PREV_VAL" != "x$NEW_VAL" ] ; then + echo Value of $CFG is redefined by fragment $MERGE_FILE: + echo Previous value: $PREV_VAL + echo New value: $NEW_VAL + echo + elif [ "$WARNREDUN" = "true" ]; then + echo Value of $CFG is redundant by fragment $MERGE_FILE: + fi + sed -i "/$CFG[ =]/d" $TMP_FILE + done + cat $MERGE_FILE >> $TMP_FILE +done + +if [ "$RUNMAKE" = "false" ]; then + cp -T -- "$TMP_FILE" "$KCONFIG_CONFIG" + echo "#" + echo "# merged configuration written to $KCONFIG_CONFIG (needs make)" + echo "#" + clean_up + exit +fi + +# If we have an output dir, setup the O= argument, otherwise leave +# it blank, since O=. will create an unnecessary ./source softlink +OUTPUT_ARG="" +if [ "$OUTPUT" != "." ] ; then + OUTPUT_ARG="O=$OUTPUT" +fi + + +# Use the merged file as the starting point for: +# alldefconfig: Fills in any missing symbols with Kconfig default +# allnoconfig: Fills in any missing symbols with # CONFIG_* is not set +make KCONFIG_ALLCONFIG=$TMP_FILE $OUTPUT_ARG $ALLTARGET + + +# Check all specified config values took (might have missed-dependency issues) +for CFG in $(sed -n "$SED_CONFIG_EXP" $TMP_FILE); do + + REQUESTED_VAL=$(grep -w -e "$CFG" $TMP_FILE) + ACTUAL_VAL=$(grep -w -e "$CFG" "$KCONFIG_CONFIG") + if [ "x$REQUESTED_VAL" != "x$ACTUAL_VAL" ] ; then + echo "Value requested for $CFG not in final .config" + echo "Requested value: $REQUESTED_VAL" + echo "Actual value: $ACTUAL_VAL" + echo "" + fi +done + +clean_up diff --git a/tools/kconfig/nconf.c b/tools/kconfig/nconf.c new file mode 100644 index 000000000..d42d534a6 --- /dev/null +++ b/tools/kconfig/nconf.c @@ -0,0 +1,1561 @@ +/* + * Copyright (C) 2008 Nir Tzachar +#include + +#include "lkc.h" +#include "nconf.h" +#include + +static const char nconf_global_help[] = N_( +"Help windows\n" +"------------\n" +"o Global help: Unless in a data entry window, pressing will give \n" +" you the global help window, which you are just reading.\n" +"\n" +"o A short version of the global help is available by pressing .\n" +"\n" +"o Local help: To get help related to the current menu entry, use any\n" +" of , or if in a data entry window then press .\n" +"\n" +"\n" +"Menu entries\n" +"------------\n" +"This interface lets you select features and parameters for the kernel\n" +"build. Kernel features can either be built-in, modularized, or removed.\n" +"Parameters must be entered as text or decimal or hexadecimal numbers.\n" +"\n" +"Menu entries beginning with following braces represent features that\n" +" [ ] can be built in or removed\n" +" < > can be built in, modularized or removed\n" +" { } can be built in or modularized, are selected by another feature\n" +" - - are selected by another feature\n" +" XXX cannot be selected. Symbol Info tells you why.\n" +"*, M or whitespace inside braces means to build in, build as a module\n" +"or to exclude the feature respectively.\n" +"\n" +"To change any of these features, highlight it with the movement keys\n" +"listed below and press to build it in, to make it a module or\n" +" to remove it. You may press the key to cycle through the\n" +"available options.\n" +"\n" +"A trailing \"--->\" designates a submenu, a trailing \"----\" an\n" +"empty submenu.\n" +"\n" +"Menu navigation keys\n" +"----------------------------------------------------------------------\n" +"Linewise up \n" +"Linewise down \n" +"Pagewise up \n" +"Pagewise down \n" +"First entry \n" +"Last entry \n" +"Enter a submenu \n" +"Go back to parent menu \n" +"Close a help window \n" +"Close entry window, apply \n" +"Close entry window, forget \n" +"Start incremental, case-insensitive search for STRING in menu entries,\n" +" no regex support, STRING is displayed in upper left corner\n" +" STRING\n" +" Remove last character \n" +" Jump to next hit \n" +" Jump to previous hit \n" +"Exit menu search mode \n" +"Search for configuration variables with or without leading CONFIG_\n" +" RegExpr\n" +"Verbose search help \n" +"----------------------------------------------------------------------\n" +"\n" +"Unless in a data entry window, key <1> may be used instead of ,\n" +"<2> instead of , etc.\n" +"\n" +"\n" +"Radiolist (Choice list)\n" +"-----------------------\n" +"Use the movement keys listed above to select the option you wish to set\n" +"and press .\n" +"\n" +"\n" +"Data entry\n" +"----------\n" +"Enter the requested information and press . Hexadecimal values\n" +"may be entered without the \"0x\" prefix.\n" +"\n" +"\n" +"Text Box (Help Window)\n" +"----------------------\n" +"Use movement keys as listed in table above.\n" +"\n" +"Press any of to exit.\n" +"\n" +"\n" +"Alternate configuration files\n" +"-----------------------------\n" +"nconfig supports switching between different configurations.\n" +"Press to save your current configuration. Press and enter\n" +"a file name to load a previously saved configuration.\n" +"\n" +"\n" +"Terminal configuration\n" +"----------------------\n" +"If you use nconfig in a xterm window, make sure your TERM environment\n" +"variable specifies a terminal configuration which supports at least\n" +"16 colors. Otherwise nconfig will look rather bad.\n" +"\n" +"If the \"stty size\" command reports the current terminalsize correctly,\n" +"nconfig will adapt to sizes larger than the traditional 80x25 \"standard\"\n" +"and display longer menus properly.\n" +"\n" +"\n" +"Single menu mode\n" +"----------------\n" +"If you prefer to have all of the menu entries listed in a single menu,\n" +"rather than the default multimenu hierarchy, run nconfig with\n" +"NCONFIG_MODE environment variable set to single_menu. Example:\n" +"\n" +"make NCONFIG_MODE=single_menu nconfig\n" +"\n" +" will then unfold the appropriate category, or fold it if it\n" +"is already unfolded. Folded menu entries will be designated by a\n" +"leading \"++>\" and unfolded entries by a leading \"-->\".\n" +"\n" +"Note that this mode can eventually be a little more CPU expensive than\n" +"the default mode, especially with a larger number of unfolded submenus.\n" +"\n"), +menu_no_f_instructions[] = N_( +"Legend: [*] built-in [ ] excluded module < > module capable.\n" +"Submenus are designated by a trailing \"--->\", empty ones by \"----\".\n" +"\n" +"Use the following keys to navigate the menus:\n" +"Move up or down with and .\n" +"Enter a submenu with or .\n" +"Exit a submenu to its parent menu with or .\n" +"Pressing includes, excludes, modularizes features.\n" +"Pressing cycles through the available options.\n" +"To search for menu entries press .\n" +" always leaves the current window.\n" +"\n" +"You do not have function keys support.\n" +"Press <1> instead of , <2> instead of , etc.\n" +"For verbose global help use key <1>.\n" +"For help related to the current menu entry press or .\n"), +menu_instructions[] = N_( +"Legend: [*] built-in [ ] excluded module < > module capable.\n" +"Submenus are designated by a trailing \"--->\", empty ones by \"----\".\n" +"\n" +"Use the following keys to navigate the menus:\n" +"Move up or down with or .\n" +"Enter a submenu with or .\n" +"Exit a submenu to its parent menu with or .\n" +"Pressing includes, excludes, modularizes features.\n" +"Pressing cycles through the available options.\n" +"To search for menu entries press .\n" +" always leaves the current window.\n" +"\n" +"Pressing <1> may be used instead of , <2> instead of , etc.\n" +"For verbose global help press .\n" +"For help related to the current menu entry press or .\n"), +radiolist_instructions[] = N_( +"Press , , or to navigate a radiolist, select\n" +"with .\n" +"For help related to the current entry press or .\n" +"For global help press .\n"), +inputbox_instructions_int[] = N_( +"Please enter a decimal value.\n" +"Fractions will not be accepted.\n" +"Press to apply, to cancel."), +inputbox_instructions_hex[] = N_( +"Please enter a hexadecimal value.\n" +"Press to apply, to cancel."), +inputbox_instructions_string[] = N_( +"Please enter a string value.\n" +"Press to apply, to cancel."), +setmod_text[] = N_( +"This feature depends on another feature which has been configured as a\n" +"module. As a result, the current feature will be built as a module too."), +load_config_text[] = N_( +"Enter the name of the configuration file you wish to load.\n" +"Accept the name shown to restore the configuration you last\n" +"retrieved. Leave empty to abort."), +load_config_help[] = N_( +"For various reasons, one may wish to keep several different\n" +"configurations available on a single machine.\n" +"\n" +"If you have saved a previous configuration in a file other than the\n" +"default one, entering its name here will allow you to load and modify\n" +"that configuration.\n" +"\n" +"Leave empty to abort.\n"), +save_config_text[] = N_( +"Enter a filename to which this configuration should be saved\n" +"as an alternate. Leave empty to abort."), +save_config_help[] = N_( +"For various reasons, one may wish to keep several different\n" +"configurations available on a single machine.\n" +"\n" +"Entering a file name here will allow you to later retrieve, modify\n" +"and use the current configuration as an alternate to whatever\n" +"configuration options you have selected at that time.\n" +"\n" +"Leave empty to abort.\n"), +search_help[] = N_( +"Search for symbols (configuration variable names CONFIG_*) and display\n" +"their relations. Regular expressions are supported.\n" +"Example: Search for \"^FOO\".\n" +"Result:\n" +"-----------------------------------------------------------------\n" +"Symbol: FOO [ = m]\n" +"Prompt: Foo bus is used to drive the bar HW\n" +"Defined at drivers/pci/Kconfig:47\n" +"Depends on: X86_LOCAL_APIC && X86_IO_APIC || IA64\n" +"Location:\n" +" -> Bus options (PCI, PCMCIA, EISA, ISA)\n" +" -> PCI support (PCI [ = y])\n" +" -> PCI access mode ( [ = y])\n" +"Selects: LIBCRC32\n" +"Selected by: BAR\n" +"-----------------------------------------------------------------\n" +"o The line 'Prompt:' shows the text displayed for this symbol in\n" +" the menu hierarchy.\n" +"o The 'Defined at' line tells at what file / line number the symbol is\n" +" defined.\n" +"o The 'Depends on:' line lists symbols that need to be defined for\n" +" this symbol to be visible and selectable in the menu.\n" +"o The 'Location:' lines tell, where in the menu structure this symbol\n" +" is located. A location followed by a [ = y] indicates that this is\n" +" a selectable menu item, and the current value is displayed inside\n" +" brackets.\n" +"o The 'Selects:' line tells, what symbol will be automatically selected\n" +" if this symbol is selected (y or m).\n" +"o The 'Selected by' line tells what symbol has selected this symbol.\n" +"\n" +"Only relevant lines are shown.\n" +"\n\n" +"Search examples:\n" +"USB => find all symbols containing USB\n" +"^USB => find all symbols starting with USB\n" +"USB$ => find all symbols ending with USB\n" +"\n"); + +struct mitem { + char str[256]; + char tag; + void *usrptr; + int is_visible; +}; + +#define MAX_MENU_ITEMS 4096 +static int show_all_items; +static int indent; +static struct menu *current_menu; +static int child_count; +static int single_menu_mode; +/* the window in which all information appears */ +static WINDOW *main_window; +/* the largest size of the menu window */ +static int mwin_max_lines; +static int mwin_max_cols; +/* the window in which we show option buttons */ +static MENU *curses_menu; +static ITEM *curses_menu_items[MAX_MENU_ITEMS]; +static struct mitem k_menu_items[MAX_MENU_ITEMS]; +static int items_num; +static int global_exit; +/* the currently selected button */ +const char *current_instructions = menu_instructions; + +static char *dialog_input_result; +static int dialog_input_result_len; + +static void conf(struct menu *menu); +static void conf_choice(struct menu *menu); +static void conf_string(struct menu *menu); +static void conf_load(void); +static void conf_save(void); +static void show_help(struct menu *menu); +static int do_exit(void); +static void setup_windows(void); +static void search_conf(void); + +typedef void (*function_key_handler_t)(int *key, struct menu *menu); +static void handle_f1(int *key, struct menu *current_item); +static void handle_f2(int *key, struct menu *current_item); +static void handle_f3(int *key, struct menu *current_item); +static void handle_f4(int *key, struct menu *current_item); +static void handle_f5(int *key, struct menu *current_item); +static void handle_f6(int *key, struct menu *current_item); +static void handle_f7(int *key, struct menu *current_item); +static void handle_f8(int *key, struct menu *current_item); +static void handle_f9(int *key, struct menu *current_item); + +struct function_keys { + const char *key_str; + const char *func; + function_key key; + function_key_handler_t handler; +}; + +static const int function_keys_num = 9; +struct function_keys function_keys[] = { + { + .key_str = "F1", + .func = "Help", + .key = F_HELP, + .handler = handle_f1, + }, + { + .key_str = "F2", + .func = "SymInfo", + .key = F_SYMBOL, + .handler = handle_f2, + }, + { + .key_str = "F3", + .func = "Help 2", + .key = F_INSTS, + .handler = handle_f3, + }, + { + .key_str = "F4", + .func = "ShowAll", + .key = F_CONF, + .handler = handle_f4, + }, + { + .key_str = "F5", + .func = "Back", + .key = F_BACK, + .handler = handle_f5, + }, + { + .key_str = "F6", + .func = "Save", + .key = F_SAVE, + .handler = handle_f6, + }, + { + .key_str = "F7", + .func = "Load", + .key = F_LOAD, + .handler = handle_f7, + }, + { + .key_str = "F8", + .func = "SymSearch", + .key = F_SEARCH, + .handler = handle_f8, + }, + { + .key_str = "F9", + .func = "Exit", + .key = F_EXIT, + .handler = handle_f9, + }, +}; + +static void print_function_line(void) +{ + int i; + int offset = 1; + const int skip = 1; + int lines = getmaxy(stdscr); + + for (i = 0; i < function_keys_num; i++) { + (void) wattrset(main_window, attributes[FUNCTION_HIGHLIGHT]); + mvwprintw(main_window, lines-3, offset, + "%s", + function_keys[i].key_str); + (void) wattrset(main_window, attributes[FUNCTION_TEXT]); + offset += strlen(function_keys[i].key_str); + mvwprintw(main_window, lines-3, + offset, "%s", + function_keys[i].func); + offset += strlen(function_keys[i].func) + skip; + } + (void) wattrset(main_window, attributes[NORMAL]); +} + +/* help */ +static void handle_f1(int *key, struct menu *current_item) +{ + show_scroll_win(main_window, + _("Global help"), _(nconf_global_help)); + return; +} + +/* symbole help */ +static void handle_f2(int *key, struct menu *current_item) +{ + show_help(current_item); + return; +} + +/* instructions */ +static void handle_f3(int *key, struct menu *current_item) +{ + show_scroll_win(main_window, + _("Short help"), + _(current_instructions)); + return; +} + +/* config */ +static void handle_f4(int *key, struct menu *current_item) +{ + int res = btn_dialog(main_window, + _("Show all symbols?"), + 2, + " ", + ""); + if (res == 0) + show_all_items = 1; + else if (res == 1) + show_all_items = 0; + + return; +} + +/* back */ +static void handle_f5(int *key, struct menu *current_item) +{ + *key = KEY_LEFT; + return; +} + +/* save */ +static void handle_f6(int *key, struct menu *current_item) +{ + conf_save(); + return; +} + +/* load */ +static void handle_f7(int *key, struct menu *current_item) +{ + conf_load(); + return; +} + +/* search */ +static void handle_f8(int *key, struct menu *current_item) +{ + search_conf(); + return; +} + +/* exit */ +static void handle_f9(int *key, struct menu *current_item) +{ + do_exit(); + return; +} + +/* return != 0 to indicate the key was handles */ +static int process_special_keys(int *key, struct menu *menu) +{ + int i; + + if (*key == KEY_RESIZE) { + setup_windows(); + return 1; + } + + for (i = 0; i < function_keys_num; i++) { + if (*key == KEY_F(function_keys[i].key) || + *key == '0' + function_keys[i].key){ + function_keys[i].handler(key, menu); + return 1; + } + } + + return 0; +} + +static void clean_items(void) +{ + int i; + for (i = 0; curses_menu_items[i]; i++) + free_item(curses_menu_items[i]); + bzero(curses_menu_items, sizeof(curses_menu_items)); + bzero(k_menu_items, sizeof(k_menu_items)); + items_num = 0; +} + +typedef enum {MATCH_TINKER_PATTERN_UP, MATCH_TINKER_PATTERN_DOWN, + FIND_NEXT_MATCH_DOWN, FIND_NEXT_MATCH_UP} match_f; + +/* return the index of the matched item, or -1 if no such item exists */ +static int get_mext_match(const char *match_str, match_f flag) +{ + int match_start = item_index(current_item(curses_menu)); + int index; + + if (flag == FIND_NEXT_MATCH_DOWN) + ++match_start; + else if (flag == FIND_NEXT_MATCH_UP) + --match_start; + + index = match_start; + index = (index + items_num) % items_num; + while (true) { + char *str = k_menu_items[index].str; + if (strcasestr(str, match_str) != 0) + return index; + if (flag == FIND_NEXT_MATCH_UP || + flag == MATCH_TINKER_PATTERN_UP) + --index; + else + ++index; + index = (index + items_num) % items_num; + if (index == match_start) + return -1; + } +} + +/* Make a new item. */ +static void item_make(struct menu *menu, char tag, const char *fmt, ...) +{ + va_list ap; + + if (items_num > MAX_MENU_ITEMS-1) + return; + + bzero(&k_menu_items[items_num], sizeof(k_menu_items[0])); + k_menu_items[items_num].tag = tag; + k_menu_items[items_num].usrptr = menu; + if (menu != NULL) + k_menu_items[items_num].is_visible = + menu_is_visible(menu); + else + k_menu_items[items_num].is_visible = 1; + + va_start(ap, fmt); + vsnprintf(k_menu_items[items_num].str, + sizeof(k_menu_items[items_num].str), + fmt, ap); + va_end(ap); + + if (!k_menu_items[items_num].is_visible) + memcpy(k_menu_items[items_num].str, "XXX", 3); + + curses_menu_items[items_num] = new_item( + k_menu_items[items_num].str, + k_menu_items[items_num].str); + set_item_userptr(curses_menu_items[items_num], + &k_menu_items[items_num]); + /* + if (!k_menu_items[items_num].is_visible) + item_opts_off(curses_menu_items[items_num], O_SELECTABLE); + */ + + items_num++; + curses_menu_items[items_num] = NULL; +} + +/* very hackish. adds a string to the last item added */ +static void item_add_str(const char *fmt, ...) +{ + va_list ap; + int index = items_num-1; + char new_str[256]; + char tmp_str[256]; + + if (index < 0) + return; + + va_start(ap, fmt); + vsnprintf(new_str, sizeof(new_str), fmt, ap); + va_end(ap); + snprintf(tmp_str, sizeof(tmp_str), "%s%s", + k_menu_items[index].str, new_str); + strncpy(k_menu_items[index].str, + tmp_str, + sizeof(k_menu_items[index].str)); + + free_item(curses_menu_items[index]); + curses_menu_items[index] = new_item( + k_menu_items[index].str, + k_menu_items[index].str); + set_item_userptr(curses_menu_items[index], + &k_menu_items[index]); +} + +/* get the tag of the currently selected item */ +static char item_tag(void) +{ + ITEM *cur; + struct mitem *mcur; + + cur = current_item(curses_menu); + if (cur == NULL) + return 0; + mcur = (struct mitem *) item_userptr(cur); + return mcur->tag; +} + +static int curses_item_index(void) +{ + return item_index(current_item(curses_menu)); +} + +static void *item_data(void) +{ + ITEM *cur; + struct mitem *mcur; + + cur = current_item(curses_menu); + if (!cur) + return NULL; + mcur = (struct mitem *) item_userptr(cur); + return mcur->usrptr; + +} + +static int item_is_tag(char tag) +{ + return item_tag() == tag; +} + +static char filename[PATH_MAX+1]; +static char menu_backtitle[PATH_MAX+128]; +static const char *set_config_filename(const char *config_filename) +{ + int size; + + size = snprintf(menu_backtitle, sizeof(menu_backtitle), + "%s - %s", config_filename, rootmenu.prompt->text); + if (size >= sizeof(menu_backtitle)) + menu_backtitle[sizeof(menu_backtitle)-1] = '\0'; + + size = snprintf(filename, sizeof(filename), "%s", config_filename); + if (size >= sizeof(filename)) + filename[sizeof(filename)-1] = '\0'; + return menu_backtitle; +} + +/* return = 0 means we are successful. + * -1 means go on doing what you were doing + */ +static int do_exit(void) +{ + int res; + if (!conf_get_changed()) { + global_exit = 1; + return 0; + } + res = btn_dialog(main_window, + _("Do you wish to save your new configuration?\n" + " to cancel and resume nconfig."), + 2, + " ", + ""); + if (res == KEY_EXIT) { + global_exit = 0; + return -1; + } + + /* if we got here, the user really wants to exit */ + switch (res) { + case 0: + res = conf_write(filename); + if (res) + btn_dialog( + main_window, + _("Error during writing of configuration.\n" + "Your configuration changes were NOT saved."), + 1, + ""); + break; + default: + btn_dialog( + main_window, + _("Your configuration changes were NOT saved."), + 1, + ""); + break; + } + global_exit = 1; + return 0; +} + + +static void search_conf(void) +{ + struct symbol **sym_arr; + struct gstr res; + struct gstr title; + char *dialog_input; + int dres; + + title = str_new(); + str_printf( &title, _("Enter (sub)string or regexp to search for " + "(with or without \"%s\")"), CONFIG_); + +again: + dres = dialog_inputbox(main_window, + _("Search Configuration Parameter"), + str_get(&title), + "", &dialog_input_result, &dialog_input_result_len); + switch (dres) { + case 0: + break; + case 1: + show_scroll_win(main_window, + _("Search Configuration"), search_help); + goto again; + default: + str_free(&title); + return; + } + + /* strip the prefix if necessary */ + dialog_input = dialog_input_result; + if (strncasecmp(dialog_input_result, CONFIG_, strlen(CONFIG_)) == 0) + dialog_input += strlen(CONFIG_); + + sym_arr = sym_re_search(dialog_input); + res = get_relations_str(sym_arr, NULL); + free(sym_arr); + show_scroll_win(main_window, + _("Search Results"), str_get(&res)); + str_free(&res); + str_free(&title); +} + + +static void build_conf(struct menu *menu) +{ + struct symbol *sym; + struct property *prop; + struct menu *child; + int type, tmp, doint = 2; + tristate val; + char ch; + + if (!menu || (!show_all_items && !menu_is_visible(menu))) + return; + + sym = menu->sym; + prop = menu->prompt; + if (!sym) { + if (prop && menu != current_menu) { + const char *prompt = menu_get_prompt(menu); + enum prop_type ptype; + ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN; + switch (ptype) { + case P_MENU: + child_count++; + prompt = _(prompt); + if (single_menu_mode) { + item_make(menu, 'm', + "%s%*c%s", + menu->data ? "-->" : "++>", + indent + 1, ' ', prompt); + } else + item_make(menu, 'm', + " %*c%s %s", + indent + 1, ' ', prompt, + menu_is_empty(menu) ? "----" : "--->"); + + if (single_menu_mode && menu->data) + goto conf_childs; + return; + case P_COMMENT: + if (prompt) { + child_count++; + item_make(menu, ':', + " %*c*** %s ***", + indent + 1, ' ', + _(prompt)); + } + break; + default: + if (prompt) { + child_count++; + item_make(menu, ':', "---%*c%s", + indent + 1, ' ', + _(prompt)); + } + } + } else + doint = 0; + goto conf_childs; + } + + type = sym_get_type(sym); + if (sym_is_choice(sym)) { + struct symbol *def_sym = sym_get_choice_value(sym); + struct menu *def_menu = NULL; + + child_count++; + for (child = menu->list; child; child = child->next) { + if (menu_is_visible(child) && child->sym == def_sym) + def_menu = child; + } + + val = sym_get_tristate_value(sym); + if (sym_is_changable(sym)) { + switch (type) { + case S_BOOLEAN: + item_make(menu, 't', "[%c]", + val == no ? ' ' : '*'); + break; + case S_TRISTATE: + switch (val) { + case yes: + ch = '*'; + break; + case mod: + ch = 'M'; + break; + default: + ch = ' '; + break; + } + item_make(menu, 't', "<%c>", ch); + break; + } + } else { + item_make(menu, def_menu ? 't' : ':', " "); + } + + item_add_str("%*c%s", indent + 1, + ' ', _(menu_get_prompt(menu))); + if (val == yes) { + if (def_menu) { + item_add_str(" (%s)", + _(menu_get_prompt(def_menu))); + item_add_str(" --->"); + if (def_menu->list) { + indent += 2; + build_conf(def_menu); + indent -= 2; + } + } + return; + } + } else { + if (menu == current_menu) { + item_make(menu, ':', + "---%*c%s", indent + 1, + ' ', _(menu_get_prompt(menu))); + goto conf_childs; + } + child_count++; + val = sym_get_tristate_value(sym); + if (sym_is_choice_value(sym) && val == yes) { + item_make(menu, ':', " "); + } else { + switch (type) { + case S_BOOLEAN: + if (sym_is_changable(sym)) + item_make(menu, 't', "[%c]", + val == no ? ' ' : '*'); + else + item_make(menu, 't', "-%c-", + val == no ? ' ' : '*'); + break; + case S_TRISTATE: + switch (val) { + case yes: + ch = '*'; + break; + case mod: + ch = 'M'; + break; + default: + ch = ' '; + break; + } + if (sym_is_changable(sym)) { + if (sym->rev_dep.tri == mod) + item_make(menu, + 't', "{%c}", ch); + else + item_make(menu, + 't', "<%c>", ch); + } else + item_make(menu, 't', "-%c-", ch); + break; + default: + tmp = 2 + strlen(sym_get_string_value(sym)); + item_make(menu, 's', " (%s)", + sym_get_string_value(sym)); + tmp = indent - tmp + 4; + if (tmp < 0) + tmp = 0; + item_add_str("%*c%s%s", tmp, ' ', + _(menu_get_prompt(menu)), + (sym_has_value(sym) || + !sym_is_changable(sym)) ? "" : + _(" (NEW)")); + goto conf_childs; + } + } + item_add_str("%*c%s%s", indent + 1, ' ', + _(menu_get_prompt(menu)), + (sym_has_value(sym) || !sym_is_changable(sym)) ? + "" : _(" (NEW)")); + if (menu->prompt && menu->prompt->type == P_MENU) { + item_add_str(" %s", menu_is_empty(menu) ? "----" : "--->"); + return; + } + } + +conf_childs: + indent += doint; + for (child = menu->list; child; child = child->next) + build_conf(child); + indent -= doint; +} + +static void reset_menu(void) +{ + unpost_menu(curses_menu); + clean_items(); +} + +/* adjust the menu to show this item. + * prefer not to scroll the menu if possible*/ +static void center_item(int selected_index, int *last_top_row) +{ + int toprow; + + set_top_row(curses_menu, *last_top_row); + toprow = top_row(curses_menu); + if (selected_index < toprow || + selected_index >= toprow+mwin_max_lines) { + toprow = max(selected_index-mwin_max_lines/2, 0); + if (toprow >= item_count(curses_menu)-mwin_max_lines) + toprow = item_count(curses_menu)-mwin_max_lines; + set_top_row(curses_menu, toprow); + } + set_current_item(curses_menu, + curses_menu_items[selected_index]); + *last_top_row = toprow; + post_menu(curses_menu); + refresh_all_windows(main_window); +} + +/* this function assumes reset_menu has been called before */ +static void show_menu(const char *prompt, const char *instructions, + int selected_index, int *last_top_row) +{ + int maxx, maxy; + WINDOW *menu_window; + + current_instructions = instructions; + + clear(); + (void) wattrset(main_window, attributes[NORMAL]); + print_in_middle(stdscr, 1, 0, getmaxx(stdscr), + menu_backtitle, + attributes[MAIN_HEADING]); + + (void) wattrset(main_window, attributes[MAIN_MENU_BOX]); + box(main_window, 0, 0); + (void) wattrset(main_window, attributes[MAIN_MENU_HEADING]); + mvwprintw(main_window, 0, 3, " %s ", prompt); + (void) wattrset(main_window, attributes[NORMAL]); + + set_menu_items(curses_menu, curses_menu_items); + + /* position the menu at the middle of the screen */ + scale_menu(curses_menu, &maxy, &maxx); + maxx = min(maxx, mwin_max_cols-2); + maxy = mwin_max_lines; + menu_window = derwin(main_window, + maxy, + maxx, + 2, + (mwin_max_cols-maxx)/2); + keypad(menu_window, TRUE); + set_menu_win(curses_menu, menu_window); + set_menu_sub(curses_menu, menu_window); + + /* must reassert this after changing items, otherwise returns to a + * default of 16 + */ + set_menu_format(curses_menu, maxy, 1); + center_item(selected_index, last_top_row); + set_menu_format(curses_menu, maxy, 1); + + print_function_line(); + + /* Post the menu */ + post_menu(curses_menu); + refresh_all_windows(main_window); +} + +static void adj_match_dir(match_f *match_direction) +{ + if (*match_direction == FIND_NEXT_MATCH_DOWN) + *match_direction = + MATCH_TINKER_PATTERN_DOWN; + else if (*match_direction == FIND_NEXT_MATCH_UP) + *match_direction = + MATCH_TINKER_PATTERN_UP; + /* else, do no change.. */ +} + +struct match_state +{ + int in_search; + match_f match_direction; + char pattern[256]; +}; + +/* Return 0 means I have handled the key. In such a case, ans should hold the + * item to center, or -1 otherwise. + * Else return -1 . + */ +static int do_match(int key, struct match_state *state, int *ans) +{ + char c = (char) key; + int terminate_search = 0; + *ans = -1; + if (key == '/' || (state->in_search && key == 27)) { + move(0, 0); + refresh(); + clrtoeol(); + state->in_search = 1-state->in_search; + bzero(state->pattern, sizeof(state->pattern)); + state->match_direction = MATCH_TINKER_PATTERN_DOWN; + return 0; + } else if (!state->in_search) + return 1; + + if (isalnum(c) || isgraph(c) || c == ' ') { + state->pattern[strlen(state->pattern)] = c; + state->pattern[strlen(state->pattern)] = '\0'; + adj_match_dir(&state->match_direction); + *ans = get_mext_match(state->pattern, + state->match_direction); + } else if (key == KEY_DOWN) { + state->match_direction = FIND_NEXT_MATCH_DOWN; + *ans = get_mext_match(state->pattern, + state->match_direction); + } else if (key == KEY_UP) { + state->match_direction = FIND_NEXT_MATCH_UP; + *ans = get_mext_match(state->pattern, + state->match_direction); + } else if (key == KEY_BACKSPACE || key == 127) { + state->pattern[strlen(state->pattern)-1] = '\0'; + adj_match_dir(&state->match_direction); + } else + terminate_search = 1; + + if (terminate_search) { + state->in_search = 0; + bzero(state->pattern, sizeof(state->pattern)); + move(0, 0); + refresh(); + clrtoeol(); + return -1; + } + return 0; +} + +static void conf(struct menu *menu) +{ + struct menu *submenu = 0; + const char *prompt = menu_get_prompt(menu); + struct symbol *sym; + int res; + int current_index = 0; + int last_top_row = 0; + struct match_state match_state = { + .in_search = 0, + .match_direction = MATCH_TINKER_PATTERN_DOWN, + .pattern = "", + }; + + while (!global_exit) { + reset_menu(); + current_menu = menu; + build_conf(menu); + if (!child_count) + break; + + show_menu(prompt ? _(prompt) : _("Main Menu"), + _(menu_instructions), + current_index, &last_top_row); + keypad((menu_win(curses_menu)), TRUE); + while (!global_exit) { + if (match_state.in_search) { + mvprintw(0, 0, + "searching: %s", match_state.pattern); + clrtoeol(); + } + refresh_all_windows(main_window); + res = wgetch(menu_win(curses_menu)); + if (!res) + break; + if (do_match(res, &match_state, ¤t_index) == 0) { + if (current_index != -1) + center_item(current_index, + &last_top_row); + continue; + } + if (process_special_keys(&res, + (struct menu *) item_data())) + break; + switch (res) { + case KEY_DOWN: + menu_driver(curses_menu, REQ_DOWN_ITEM); + break; + case KEY_UP: + menu_driver(curses_menu, REQ_UP_ITEM); + break; + case KEY_NPAGE: + menu_driver(curses_menu, REQ_SCR_DPAGE); + break; + case KEY_PPAGE: + menu_driver(curses_menu, REQ_SCR_UPAGE); + break; + case KEY_HOME: + menu_driver(curses_menu, REQ_FIRST_ITEM); + break; + case KEY_END: + menu_driver(curses_menu, REQ_LAST_ITEM); + break; + case 'h': + case '?': + show_help((struct menu *) item_data()); + break; + } + if (res == 10 || res == 27 || + res == 32 || res == 'n' || res == 'y' || + res == KEY_LEFT || res == KEY_RIGHT || + res == 'm') + break; + refresh_all_windows(main_window); + } + + refresh_all_windows(main_window); + /* if ESC or left*/ + if (res == 27 || (menu != &rootmenu && res == KEY_LEFT)) + break; + + /* remember location in the menu */ + last_top_row = top_row(curses_menu); + current_index = curses_item_index(); + + if (!item_tag()) + continue; + + submenu = (struct menu *) item_data(); + if (!submenu || !menu_is_visible(submenu)) + continue; + sym = submenu->sym; + + switch (res) { + case ' ': + if (item_is_tag('t')) + sym_toggle_tristate_value(sym); + else if (item_is_tag('m')) + conf(submenu); + break; + case KEY_RIGHT: + case 10: /* ENTER WAS PRESSED */ + switch (item_tag()) { + case 'm': + if (single_menu_mode) + submenu->data = + (void *) (long) !submenu->data; + else + conf(submenu); + break; + case 't': + if (sym_is_choice(sym) && + sym_get_tristate_value(sym) == yes) + conf_choice(submenu); + else if (submenu->prompt && + submenu->prompt->type == P_MENU) + conf(submenu); + else if (res == 10) + sym_toggle_tristate_value(sym); + break; + case 's': + conf_string(submenu); + break; + } + break; + case 'y': + if (item_is_tag('t')) { + if (sym_set_tristate_value(sym, yes)) + break; + if (sym_set_tristate_value(sym, mod)) + btn_dialog(main_window, setmod_text, 0); + } + break; + case 'n': + if (item_is_tag('t')) + sym_set_tristate_value(sym, no); + break; + case 'm': + if (item_is_tag('t')) + sym_set_tristate_value(sym, mod); + break; + } + } +} + +static void conf_message_callback(const char *fmt, va_list ap) +{ + char buf[1024]; + + vsnprintf(buf, sizeof(buf), fmt, ap); + btn_dialog(main_window, buf, 1, ""); +} + +static void show_help(struct menu *menu) +{ + struct gstr help; + + if (!menu) + return; + + help = str_new(); + menu_get_ext_help(menu, &help); + show_scroll_win(main_window, _(menu_get_prompt(menu)), str_get(&help)); + str_free(&help); +} + +static void conf_choice(struct menu *menu) +{ + const char *prompt = _(menu_get_prompt(menu)); + struct menu *child = 0; + struct symbol *active; + int selected_index = 0; + int last_top_row = 0; + int res, i = 0; + struct match_state match_state = { + .in_search = 0, + .match_direction = MATCH_TINKER_PATTERN_DOWN, + .pattern = "", + }; + + active = sym_get_choice_value(menu->sym); + /* this is mostly duplicated from the conf() function. */ + while (!global_exit) { + reset_menu(); + + for (i = 0, child = menu->list; child; child = child->next) { + if (!show_all_items && !menu_is_visible(child)) + continue; + + if (child->sym == sym_get_choice_value(menu->sym)) + item_make(child, ':', " %s", + _(menu_get_prompt(child))); + else if (child->sym) + item_make(child, ':', " %s", + _(menu_get_prompt(child))); + else + item_make(child, ':', "*** %s ***", + _(menu_get_prompt(child))); + + if (child->sym == active){ + last_top_row = top_row(curses_menu); + selected_index = i; + } + i++; + } + show_menu(prompt ? _(prompt) : _("Choice Menu"), + _(radiolist_instructions), + selected_index, + &last_top_row); + while (!global_exit) { + if (match_state.in_search) { + mvprintw(0, 0, "searching: %s", + match_state.pattern); + clrtoeol(); + } + refresh_all_windows(main_window); + res = wgetch(menu_win(curses_menu)); + if (!res) + break; + if (do_match(res, &match_state, &selected_index) == 0) { + if (selected_index != -1) + center_item(selected_index, + &last_top_row); + continue; + } + if (process_special_keys( + &res, + (struct menu *) item_data())) + break; + switch (res) { + case KEY_DOWN: + menu_driver(curses_menu, REQ_DOWN_ITEM); + break; + case KEY_UP: + menu_driver(curses_menu, REQ_UP_ITEM); + break; + case KEY_NPAGE: + menu_driver(curses_menu, REQ_SCR_DPAGE); + break; + case KEY_PPAGE: + menu_driver(curses_menu, REQ_SCR_UPAGE); + break; + case KEY_HOME: + menu_driver(curses_menu, REQ_FIRST_ITEM); + break; + case KEY_END: + menu_driver(curses_menu, REQ_LAST_ITEM); + break; + case 'h': + case '?': + show_help((struct menu *) item_data()); + break; + } + if (res == 10 || res == 27 || res == ' ' || + res == KEY_LEFT){ + break; + } + refresh_all_windows(main_window); + } + /* if ESC or left */ + if (res == 27 || res == KEY_LEFT) + break; + + child = item_data(); + if (!child || !menu_is_visible(child) || !child->sym) + continue; + switch (res) { + case ' ': + case 10: + case KEY_RIGHT: + sym_set_tristate_value(child->sym, yes); + return; + case 'h': + case '?': + show_help(child); + active = child->sym; + break; + case KEY_EXIT: + return; + } + } +} + +static void conf_string(struct menu *menu) +{ + const char *prompt = menu_get_prompt(menu); + + while (1) { + int res; + const char *heading; + + switch (sym_get_type(menu->sym)) { + case S_INT: + heading = _(inputbox_instructions_int); + break; + case S_HEX: + heading = _(inputbox_instructions_hex); + break; + case S_STRING: + heading = _(inputbox_instructions_string); + break; + default: + heading = _("Internal nconf error!"); + } + res = dialog_inputbox(main_window, + prompt ? _(prompt) : _("Main Menu"), + heading, + sym_get_string_value(menu->sym), + &dialog_input_result, + &dialog_input_result_len); + switch (res) { + case 0: + if (sym_set_string_value(menu->sym, + dialog_input_result)) + return; + btn_dialog(main_window, + _("You have made an invalid entry."), 0); + break; + case 1: + show_help(menu); + break; + case KEY_EXIT: + return; + } + } +} + +static void conf_load(void) +{ + while (1) { + int res; + res = dialog_inputbox(main_window, + NULL, load_config_text, + filename, + &dialog_input_result, + &dialog_input_result_len); + switch (res) { + case 0: + if (!dialog_input_result[0]) + return; + if (!conf_read(dialog_input_result)) { + set_config_filename(dialog_input_result); + sym_set_change_count(1); + return; + } + btn_dialog(main_window, _("File does not exist!"), 0); + break; + case 1: + show_scroll_win(main_window, + _("Load Alternate Configuration"), + load_config_help); + break; + case KEY_EXIT: + return; + } + } +} + +static void conf_save(void) +{ + while (1) { + int res; + res = dialog_inputbox(main_window, + NULL, save_config_text, + filename, + &dialog_input_result, + &dialog_input_result_len); + switch (res) { + case 0: + if (!dialog_input_result[0]) + return; + res = conf_write(dialog_input_result); + if (!res) { + set_config_filename(dialog_input_result); + return; + } + btn_dialog(main_window, _("Can't create file! " + "Probably a nonexistent directory."), + 1, ""); + break; + case 1: + show_scroll_win(main_window, + _("Save Alternate Configuration"), + save_config_help); + break; + case KEY_EXIT: + return; + } + } +} + +void setup_windows(void) +{ + int lines, columns; + + getmaxyx(stdscr, lines, columns); + + if (main_window != NULL) + delwin(main_window); + + /* set up the menu and menu window */ + main_window = newwin(lines-2, columns-2, 2, 1); + keypad(main_window, TRUE); + mwin_max_lines = lines-7; + mwin_max_cols = columns-6; + + /* panels order is from bottom to top */ + new_panel(main_window); +} + +int main(int ac, char **av) +{ + int lines, columns; + char *mode; + + setlocale(LC_ALL, ""); + bindtextdomain(PACKAGE, LOCALEDIR); + textdomain(PACKAGE); + + if (ac > 1 && strcmp(av[1], "-s") == 0) { + /* Silence conf_read() until the real callback is set up */ + conf_set_message_callback(NULL); + av++; + } + conf_parse(av[1]); + conf_read(NULL); + + mode = getenv("NCONFIG_MODE"); + if (mode) { + if (!strcasecmp(mode, "single_menu")) + single_menu_mode = 1; + } + + /* Initialize curses */ + initscr(); + /* set color theme */ + set_colors(); + + cbreak(); + noecho(); + keypad(stdscr, TRUE); + curs_set(0); + + getmaxyx(stdscr, lines, columns); + if (columns < 75 || lines < 20) { + endwin(); + printf("Your terminal should have at " + "least 20 lines and 75 columns\n"); + return 1; + } + + notimeout(stdscr, FALSE); +#if NCURSES_REENTRANT + set_escdelay(1); +#else + ESCDELAY = 1; +#endif + + /* set btns menu */ + curses_menu = new_menu(curses_menu_items); + menu_opts_off(curses_menu, O_SHOWDESC); + menu_opts_on(curses_menu, O_SHOWMATCH); + menu_opts_on(curses_menu, O_ONEVALUE); + menu_opts_on(curses_menu, O_NONCYCLIC); + menu_opts_on(curses_menu, O_IGNORECASE); + set_menu_mark(curses_menu, " "); + set_menu_fore(curses_menu, attributes[MAIN_MENU_FORE]); + set_menu_back(curses_menu, attributes[MAIN_MENU_BACK]); + set_menu_grey(curses_menu, attributes[MAIN_MENU_GREY]); + + set_config_filename(conf_get_configname()); + setup_windows(); + + /* check for KEY_FUNC(1) */ + if (has_key(KEY_F(1)) == FALSE) { + show_scroll_win(main_window, + _("Instructions"), + _(menu_no_f_instructions)); + } + + conf_set_message_callback(conf_message_callback); + /* do the work */ + while (!global_exit) { + conf(&rootmenu); + if (!global_exit && do_exit() == 0) + break; + } + /* ok, we are done */ + unpost_menu(curses_menu); + free_menu(curses_menu); + delwin(main_window); + clear(); + refresh(); + endwin(); + return 0; +} diff --git a/tools/kconfig/nconf.gui.c b/tools/kconfig/nconf.gui.c new file mode 100644 index 000000000..8275f0e55 --- /dev/null +++ b/tools/kconfig/nconf.gui.c @@ -0,0 +1,656 @@ +/* + * Copyright (C) 2008 Nir Tzachar 0) + win_rows = msg_lines+4; + else + win_rows = msg_lines+2; + + win = newwin(win_rows, total_width+4, y, x); + keypad(win, TRUE); + menu_win = derwin(win, 1, btns_width, win_rows-2, + 1+(total_width+2-btns_width)/2); + menu = new_menu(btns); + msg_win = derwin(win, win_rows-2, msg_width, 1, + 1+(total_width+2-msg_width)/2); + + set_menu_fore(menu, attributes[DIALOG_MENU_FORE]); + set_menu_back(menu, attributes[DIALOG_MENU_BACK]); + + (void) wattrset(win, attributes[DIALOG_BOX]); + box(win, 0, 0); + + /* print message */ + (void) wattrset(msg_win, attributes[DIALOG_TEXT]); + fill_window(msg_win, msg); + + set_menu_win(menu, win); + set_menu_sub(menu, menu_win); + set_menu_format(menu, 1, btn_num); + menu_opts_off(menu, O_SHOWDESC); + menu_opts_off(menu, O_SHOWMATCH); + menu_opts_on(menu, O_ONEVALUE); + menu_opts_on(menu, O_NONCYCLIC); + set_menu_mark(menu, ""); + post_menu(menu); + + + touchwin(win); + refresh_all_windows(main_window); + while ((res = wgetch(win))) { + switch (res) { + case KEY_LEFT: + menu_driver(menu, REQ_LEFT_ITEM); + break; + case KEY_RIGHT: + menu_driver(menu, REQ_RIGHT_ITEM); + break; + case 10: /* ENTER */ + case 27: /* ESCAPE */ + case ' ': + case KEY_F(F_BACK): + case KEY_F(F_EXIT): + break; + } + touchwin(win); + refresh_all_windows(main_window); + + if (res == 10 || res == ' ') { + res = item_index(current_item(menu)); + break; + } else if (res == 27 || res == KEY_F(F_BACK) || + res == KEY_F(F_EXIT)) { + res = KEY_EXIT; + break; + } + } + + unpost_menu(menu); + free_menu(menu); + for (i = 0; i < btn_num; i++) + free_item(btns[i]); + + delwin(win); + return res; +} + +int dialog_inputbox(WINDOW *main_window, + const char *title, const char *prompt, + const char *init, char **resultp, int *result_len) +{ + int prompt_lines = 0; + int prompt_width = 0; + WINDOW *win; + WINDOW *prompt_win; + WINDOW *form_win; + PANEL *panel; + int i, x, y; + int res = -1; + int cursor_position = strlen(init); + int cursor_form_win; + char *result = *resultp; + + if (strlen(init)+1 > *result_len) { + *result_len = strlen(init)+1; + *resultp = result = realloc(result, *result_len); + } + + /* find the widest line of msg: */ + prompt_lines = get_line_no(prompt); + for (i = 0; i < prompt_lines; i++) { + const char *line = get_line(prompt, i); + int len = get_line_length(line); + prompt_width = max(prompt_width, len); + } + + if (title) + prompt_width = max(prompt_width, strlen(title)); + + /* place dialog in middle of screen */ + y = (getmaxy(stdscr)-(prompt_lines+4))/2; + x = (getmaxx(stdscr)-(prompt_width+4))/2; + + strncpy(result, init, *result_len); + + /* create the windows */ + win = newwin(prompt_lines+6, prompt_width+7, y, x); + prompt_win = derwin(win, prompt_lines+1, prompt_width, 2, 2); + form_win = derwin(win, 1, prompt_width, prompt_lines+3, 2); + keypad(form_win, TRUE); + + (void) wattrset(form_win, attributes[INPUT_FIELD]); + + (void) wattrset(win, attributes[INPUT_BOX]); + box(win, 0, 0); + (void) wattrset(win, attributes[INPUT_HEADING]); + if (title) + mvwprintw(win, 0, 3, "%s", title); + + /* print message */ + (void) wattrset(prompt_win, attributes[INPUT_TEXT]); + fill_window(prompt_win, prompt); + + mvwprintw(form_win, 0, 0, "%*s", prompt_width, " "); + cursor_form_win = min(cursor_position, prompt_width-1); + mvwprintw(form_win, 0, 0, "%s", + result + cursor_position-cursor_form_win); + + /* create panels */ + panel = new_panel(win); + + /* show the cursor */ + curs_set(1); + + touchwin(win); + refresh_all_windows(main_window); + while ((res = wgetch(form_win))) { + int len = strlen(result); + switch (res) { + case 10: /* ENTER */ + case 27: /* ESCAPE */ + case KEY_F(F_HELP): + case KEY_F(F_EXIT): + case KEY_F(F_BACK): + break; + case 127: + case KEY_BACKSPACE: + if (cursor_position > 0) { + memmove(&result[cursor_position-1], + &result[cursor_position], + len-cursor_position+1); + cursor_position--; + cursor_form_win--; + len--; + } + break; + case KEY_DC: + if (cursor_position >= 0 && cursor_position < len) { + memmove(&result[cursor_position], + &result[cursor_position+1], + len-cursor_position+1); + len--; + } + break; + case KEY_UP: + case KEY_RIGHT: + if (cursor_position < len) { + cursor_position++; + cursor_form_win++; + } + break; + case KEY_DOWN: + case KEY_LEFT: + if (cursor_position > 0) { + cursor_position--; + cursor_form_win--; + } + break; + case KEY_HOME: + cursor_position = 0; + cursor_form_win = 0; + break; + case KEY_END: + cursor_position = len; + cursor_form_win = min(cursor_position, prompt_width-1); + break; + default: + if ((isgraph(res) || isspace(res))) { + /* one for new char, one for '\0' */ + if (len+2 > *result_len) { + *result_len = len+2; + *resultp = result = realloc(result, + *result_len); + } + /* insert the char at the proper position */ + memmove(&result[cursor_position+1], + &result[cursor_position], + len-cursor_position+1); + result[cursor_position] = res; + cursor_position++; + cursor_form_win++; + len++; + } else { + mvprintw(0, 0, "unknown key: %d\n", res); + } + break; + } + if (cursor_form_win < 0) + cursor_form_win = 0; + else if (cursor_form_win > prompt_width-1) + cursor_form_win = prompt_width-1; + + wmove(form_win, 0, 0); + wclrtoeol(form_win); + mvwprintw(form_win, 0, 0, "%*s", prompt_width, " "); + mvwprintw(form_win, 0, 0, "%s", + result + cursor_position-cursor_form_win); + wmove(form_win, 0, cursor_form_win); + touchwin(win); + refresh_all_windows(main_window); + + if (res == 10) { + res = 0; + break; + } else if (res == 27 || res == KEY_F(F_BACK) || + res == KEY_F(F_EXIT)) { + res = KEY_EXIT; + break; + } else if (res == KEY_F(F_HELP)) { + res = 1; + break; + } + } + + /* hide the cursor */ + curs_set(0); + del_panel(panel); + delwin(prompt_win); + delwin(form_win); + delwin(win); + return res; +} + +/* refresh all windows in the correct order */ +void refresh_all_windows(WINDOW *main_window) +{ + update_panels(); + touchwin(main_window); + refresh(); +} + +/* layman's scrollable window... */ +void show_scroll_win(WINDOW *main_window, + const char *title, + const char *text) +{ + int res; + int total_lines = get_line_no(text); + int x, y, lines, columns; + int start_x = 0, start_y = 0; + int text_lines = 0, text_cols = 0; + int total_cols = 0; + int win_cols = 0; + int win_lines = 0; + int i = 0; + WINDOW *win; + WINDOW *pad; + PANEL *panel; + + getmaxyx(stdscr, lines, columns); + + /* find the widest line of msg: */ + total_lines = get_line_no(text); + for (i = 0; i < total_lines; i++) { + const char *line = get_line(text, i); + int len = get_line_length(line); + total_cols = max(total_cols, len+2); + } + + /* create the pad */ + pad = newpad(total_lines+10, total_cols+10); + (void) wattrset(pad, attributes[SCROLLWIN_TEXT]); + fill_window(pad, text); + + win_lines = min(total_lines+4, lines-2); + win_cols = min(total_cols+2, columns-2); + text_lines = max(win_lines-4, 0); + text_cols = max(win_cols-2, 0); + + /* place window in middle of screen */ + y = (lines-win_lines)/2; + x = (columns-win_cols)/2; + + win = newwin(win_lines, win_cols, y, x); + keypad(win, TRUE); + /* show the help in the help window, and show the help panel */ + (void) wattrset(win, attributes[SCROLLWIN_BOX]); + box(win, 0, 0); + (void) wattrset(win, attributes[SCROLLWIN_HEADING]); + mvwprintw(win, 0, 3, " %s ", title); + panel = new_panel(win); + + /* handle scrolling */ + do { + + copywin(pad, win, start_y, start_x, 2, 2, text_lines, + text_cols, 0); + print_in_middle(win, + text_lines+2, + 0, + text_cols, + "", + attributes[DIALOG_MENU_FORE]); + wrefresh(win); + + res = wgetch(win); + switch (res) { + case KEY_NPAGE: + case ' ': + case 'd': + start_y += text_lines-2; + break; + case KEY_PPAGE: + case 'u': + start_y -= text_lines+2; + break; + case KEY_HOME: + start_y = 0; + break; + case KEY_END: + start_y = total_lines-text_lines; + break; + case KEY_DOWN: + case 'j': + start_y++; + break; + case KEY_UP: + case 'k': + start_y--; + break; + case KEY_LEFT: + case 'h': + start_x--; + break; + case KEY_RIGHT: + case 'l': + start_x++; + break; + } + if (res == 10 || res == 27 || res == 'q' || + res == KEY_F(F_HELP) || res == KEY_F(F_BACK) || + res == KEY_F(F_EXIT)) + break; + if (start_y < 0) + start_y = 0; + if (start_y >= total_lines-text_lines) + start_y = total_lines-text_lines; + if (start_x < 0) + start_x = 0; + if (start_x >= total_cols-text_cols) + start_x = total_cols-text_cols; + } while (res); + + del_panel(panel); + delwin(win); + refresh_all_windows(main_window); +} diff --git a/tools/kconfig/nconf.h b/tools/kconfig/nconf.h new file mode 100644 index 000000000..0d5261705 --- /dev/null +++ b/tools/kconfig/nconf.h @@ -0,0 +1,96 @@ +/* + * Copyright (C) 2008 Nir Tzachar +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include + +#include "ncurses.h" + +#define max(a, b) ({\ + typeof(a) _a = a;\ + typeof(b) _b = b;\ + _a > _b ? _a : _b; }) + +#define min(a, b) ({\ + typeof(a) _a = a;\ + typeof(b) _b = b;\ + _a < _b ? _a : _b; }) + +typedef enum { + NORMAL = 1, + MAIN_HEADING, + MAIN_MENU_BOX, + MAIN_MENU_FORE, + MAIN_MENU_BACK, + MAIN_MENU_GREY, + MAIN_MENU_HEADING, + SCROLLWIN_TEXT, + SCROLLWIN_HEADING, + SCROLLWIN_BOX, + DIALOG_TEXT, + DIALOG_MENU_FORE, + DIALOG_MENU_BACK, + DIALOG_BOX, + INPUT_BOX, + INPUT_HEADING, + INPUT_TEXT, + INPUT_FIELD, + FUNCTION_TEXT, + FUNCTION_HIGHLIGHT, + ATTR_MAX +} attributes_t; +extern attributes_t attributes[]; + +typedef enum { + F_HELP = 1, + F_SYMBOL = 2, + F_INSTS = 3, + F_CONF = 4, + F_BACK = 5, + F_SAVE = 6, + F_LOAD = 7, + F_SEARCH = 8, + F_EXIT = 9, +} function_key; + +void set_colors(void); + +/* this changes the windows attributes !!! */ +void print_in_middle(WINDOW *win, + int starty, + int startx, + int width, + const char *string, + chtype color); +int get_line_length(const char *line); +int get_line_no(const char *text); +const char *get_line(const char *text, int line_no); +void fill_window(WINDOW *win, const char *text); +int btn_dialog(WINDOW *main_window, const char *msg, int btn_num, ...); +int dialog_inputbox(WINDOW *main_window, + const char *title, const char *prompt, + const char *init, char **resultp, int *result_len); +void refresh_all_windows(WINDOW *main_window); +void show_scroll_win(WINDOW *main_window, + const char *title, + const char *text); diff --git a/tools/kconfig/qconf.cc b/tools/kconfig/qconf.cc new file mode 100644 index 000000000..fc5555992 --- /dev/null +++ b/tools/kconfig/qconf.cc @@ -0,0 +1,1870 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Copyright (C) 2015 Boris Barbulovski + * Released under the terms of the GNU GPL v2.0. + */ + +#include + +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +#include "lkc.h" +#include "qconf.h" + +#include "qconf.moc" +#include "images.c" + +#ifdef _ +# undef _ +# define _ qgettext +#endif + +static QApplication *configApp; +static ConfigSettings *configSettings; + +QAction *ConfigMainWindow::saveAction; + +static inline QString qgettext(const char* str) +{ + return QString::fromLocal8Bit(gettext(str)); +} + +static inline QString qgettext(const QString& str) +{ + return QString::fromLocal8Bit(gettext(str.toLatin1())); +} + +ConfigSettings::ConfigSettings() + : QSettings("kernel.org", "qconf") +{ +} + +/** + * Reads a list of integer values from the application settings. + */ +QList ConfigSettings::readSizes(const QString& key, bool *ok) +{ + QList result; + QStringList entryList = value(key).toStringList(); + QStringList::Iterator it; + + for (it = entryList.begin(); it != entryList.end(); ++it) + result.push_back((*it).toInt()); + + return result; +} + +/** + * Writes a list of integer values to the application settings. + */ +bool ConfigSettings::writeSizes(const QString& key, const QList& value) +{ + QStringList stringList; + QList::ConstIterator it; + + for (it = value.begin(); it != value.end(); ++it) + stringList.push_back(QString::number(*it)); + setValue(key, stringList); + + return true; +} + + +/* + * set the new data + * TODO check the value + */ +void ConfigItem::okRename(int col) +{ +} + +/* + * update the displayed of a menu entry + */ +void ConfigItem::updateMenu(void) +{ + ConfigList* list; + struct symbol* sym; + struct property *prop; + QString prompt; + int type; + tristate expr; + + list = listView(); + if (goParent) { + setPixmap(promptColIdx, list->menuBackPix); + prompt = ".."; + goto set_prompt; + } + + sym = menu->sym; + prop = menu->prompt; + prompt = _(menu_get_prompt(menu)); + + if (prop) switch (prop->type) { + case P_MENU: + if (list->mode == singleMode || list->mode == symbolMode) { + /* a menuconfig entry is displayed differently + * depending whether it's at the view root or a child. + */ + if (sym && list->rootEntry == menu) + break; + setPixmap(promptColIdx, list->menuPix); + } else { + if (sym) + break; + setPixmap(promptColIdx, QIcon()); + } + goto set_prompt; + case P_COMMENT: + setPixmap(promptColIdx, QIcon()); + goto set_prompt; + default: + ; + } + if (!sym) + goto set_prompt; + + setText(nameColIdx, QString::fromLocal8Bit(sym->name)); + + type = sym_get_type(sym); + switch (type) { + case S_BOOLEAN: + case S_TRISTATE: + char ch; + + if (!sym_is_changable(sym) && list->optMode == normalOpt) { + setPixmap(promptColIdx, QIcon()); + setText(noColIdx, QString::null); + setText(modColIdx, QString::null); + setText(yesColIdx, QString::null); + break; + } + expr = sym_get_tristate_value(sym); + switch (expr) { + case yes: + if (sym_is_choice_value(sym) && type == S_BOOLEAN) + setPixmap(promptColIdx, list->choiceYesPix); + else + setPixmap(promptColIdx, list->symbolYesPix); + setText(yesColIdx, "Y"); + ch = 'Y'; + break; + case mod: + setPixmap(promptColIdx, list->symbolModPix); + setText(modColIdx, "M"); + ch = 'M'; + break; + default: + if (sym_is_choice_value(sym) && type == S_BOOLEAN) + setPixmap(promptColIdx, list->choiceNoPix); + else + setPixmap(promptColIdx, list->symbolNoPix); + setText(noColIdx, "N"); + ch = 'N'; + break; + } + if (expr != no) + setText(noColIdx, sym_tristate_within_range(sym, no) ? "_" : 0); + if (expr != mod) + setText(modColIdx, sym_tristate_within_range(sym, mod) ? "_" : 0); + if (expr != yes) + setText(yesColIdx, sym_tristate_within_range(sym, yes) ? "_" : 0); + + setText(dataColIdx, QChar(ch)); + break; + case S_INT: + case S_HEX: + case S_STRING: + const char* data; + + data = sym_get_string_value(sym); + + setText(dataColIdx, data); + if (type == S_STRING) + prompt = QString("%1: %2").arg(prompt).arg(data); + else + prompt = QString("(%2) %1").arg(prompt).arg(data); + break; + } + if (!sym_has_value(sym) && visible) + prompt += _(" (NEW)"); +set_prompt: + setText(promptColIdx, prompt); +} + +void ConfigItem::testUpdateMenu(bool v) +{ + ConfigItem* i; + + visible = v; + if (!menu) + return; + + sym_calc_value(menu->sym); + if (menu->flags & MENU_CHANGED) { + /* the menu entry changed, so update all list items */ + menu->flags &= ~MENU_CHANGED; + for (i = (ConfigItem*)menu->data; i; i = i->nextItem) + i->updateMenu(); + } else if (listView()->updateAll) + updateMenu(); +} + + +/* + * construct a menu entry + */ +void ConfigItem::init(void) +{ + if (menu) { + ConfigList* list = listView(); + nextItem = (ConfigItem*)menu->data; + menu->data = this; + + if (list->mode != fullMode) + setExpanded(true); + sym_calc_value(menu->sym); + } + updateMenu(); +} + +/* + * destruct a menu entry + */ +ConfigItem::~ConfigItem(void) +{ + if (menu) { + ConfigItem** ip = (ConfigItem**)&menu->data; + for (; *ip; ip = &(*ip)->nextItem) { + if (*ip == this) { + *ip = nextItem; + break; + } + } + } +} + +ConfigLineEdit::ConfigLineEdit(ConfigView* parent) + : Parent(parent) +{ + connect(this, SIGNAL(editingFinished()), SLOT(hide())); +} + +void ConfigLineEdit::show(ConfigItem* i) +{ + item = i; + if (sym_get_string_value(item->menu->sym)) + setText(QString::fromLocal8Bit(sym_get_string_value(item->menu->sym))); + else + setText(QString::null); + Parent::show(); + setFocus(); +} + +void ConfigLineEdit::keyPressEvent(QKeyEvent* e) +{ + switch (e->key()) { + case Qt::Key_Escape: + break; + case Qt::Key_Return: + case Qt::Key_Enter: + sym_set_string_value(item->menu->sym, text().toLatin1()); + parent()->updateList(item); + break; + default: + Parent::keyPressEvent(e); + return; + } + e->accept(); + parent()->list->setFocus(); + hide(); +} + +ConfigList::ConfigList(ConfigView* p, const char *name) + : Parent(p), + updateAll(false), + symbolYesPix(xpm_symbol_yes), symbolModPix(xpm_symbol_mod), symbolNoPix(xpm_symbol_no), + choiceYesPix(xpm_choice_yes), choiceNoPix(xpm_choice_no), + menuPix(xpm_menu), menuInvPix(xpm_menu_inv), menuBackPix(xpm_menuback), voidPix(xpm_void), + showName(false), showRange(false), showData(false), mode(singleMode), optMode(normalOpt), + rootEntry(0), headerPopup(0) +{ + int i; + + setObjectName(name); + setSortingEnabled(false); + setRootIsDecorated(true); + + setVerticalScrollMode(ScrollPerPixel); + setHorizontalScrollMode(ScrollPerPixel); + + setHeaderLabels(QStringList() << _("Option") << _("Name") << "N" << "M" << "Y" << _("Value")); + + connect(this, SIGNAL(itemSelectionChanged(void)), + SLOT(updateSelection(void))); + + if (name) { + configSettings->beginGroup(name); + showName = configSettings->value("/showName", false).toBool(); + showRange = configSettings->value("/showRange", false).toBool(); + showData = configSettings->value("/showData", false).toBool(); + optMode = (enum optionMode)configSettings->value("/optionMode", 0).toInt(); + configSettings->endGroup(); + connect(configApp, SIGNAL(aboutToQuit()), SLOT(saveSettings())); + } + + addColumn(promptColIdx); + + reinit(); +} + +bool ConfigList::menuSkip(struct menu *menu) +{ + if (optMode == normalOpt && menu_is_visible(menu)) + return false; + if (optMode == promptOpt && menu_has_prompt(menu)) + return false; + if (optMode == allOpt) + return false; + return true; +} + +void ConfigList::reinit(void) +{ + removeColumn(dataColIdx); + removeColumn(yesColIdx); + removeColumn(modColIdx); + removeColumn(noColIdx); + removeColumn(nameColIdx); + + if (showName) + addColumn(nameColIdx); + if (showRange) { + addColumn(noColIdx); + addColumn(modColIdx); + addColumn(yesColIdx); + } + if (showData) + addColumn(dataColIdx); + + updateListAll(); +} + +void ConfigList::saveSettings(void) +{ + if (!objectName().isEmpty()) { + configSettings->beginGroup(objectName()); + configSettings->setValue("/showName", showName); + configSettings->setValue("/showRange", showRange); + configSettings->setValue("/showData", showData); + configSettings->setValue("/optionMode", (int)optMode); + configSettings->endGroup(); + } +} + +ConfigItem* ConfigList::findConfigItem(struct menu *menu) +{ + ConfigItem* item = (ConfigItem*)menu->data; + + for (; item; item = item->nextItem) { + if (this == item->listView()) + break; + } + + return item; +} + +void ConfigList::updateSelection(void) +{ + struct menu *menu; + enum prop_type type; + + if (selectedItems().count() == 0) + return; + + ConfigItem* item = (ConfigItem*)selectedItems().first(); + if (!item) + return; + + menu = item->menu; + emit menuChanged(menu); + if (!menu) + return; + type = menu->prompt ? menu->prompt->type : P_UNKNOWN; + if (mode == menuMode && type == P_MENU) + emit menuSelected(menu); +} + +void ConfigList::updateList(ConfigItem* item) +{ + ConfigItem* last = 0; + + if (!rootEntry) { + if (mode != listMode) + goto update; + QTreeWidgetItemIterator it(this); + ConfigItem* item; + + while (*it) { + item = (ConfigItem*)(*it); + if (!item->menu) + continue; + item->testUpdateMenu(menu_is_visible(item->menu)); + + ++it; + } + return; + } + + if (rootEntry != &rootmenu && (mode == singleMode || + (mode == symbolMode && rootEntry->parent != &rootmenu))) { + item = (ConfigItem *)topLevelItem(0); + if (!item) + item = new ConfigItem(this, 0, true); + last = item; + } + if ((mode == singleMode || (mode == symbolMode && !(rootEntry->flags & MENU_ROOT))) && + rootEntry->sym && rootEntry->prompt) { + item = last ? last->nextSibling() : firstChild(); + if (!item) + item = new ConfigItem(this, last, rootEntry, true); + else + item->testUpdateMenu(true); + + updateMenuList(item, rootEntry); + update(); + resizeColumnToContents(0); + return; + } +update: + updateMenuList(this, rootEntry); + update(); + resizeColumnToContents(0); +} + +void ConfigList::setValue(ConfigItem* item, tristate val) +{ + struct symbol* sym; + int type; + tristate oldval; + + sym = item->menu ? item->menu->sym : 0; + if (!sym) + return; + + type = sym_get_type(sym); + switch (type) { + case S_BOOLEAN: + case S_TRISTATE: + oldval = sym_get_tristate_value(sym); + + if (!sym_set_tristate_value(sym, val)) + return; + if (oldval == no && item->menu->list) + item->setExpanded(true); + parent()->updateList(item); + break; + } +} + +void ConfigList::changeValue(ConfigItem* item) +{ + struct symbol* sym; + struct menu* menu; + int type, oldexpr, newexpr; + + menu = item->menu; + if (!menu) + return; + sym = menu->sym; + if (!sym) { + if (item->menu->list) + item->setExpanded(!item->isExpanded()); + return; + } + + type = sym_get_type(sym); + switch (type) { + case S_BOOLEAN: + case S_TRISTATE: + oldexpr = sym_get_tristate_value(sym); + newexpr = sym_toggle_tristate_value(sym); + if (item->menu->list) { + if (oldexpr == newexpr) + item->setExpanded(!item->isExpanded()); + else if (oldexpr == no) + item->setExpanded(true); + } + if (oldexpr != newexpr) + parent()->updateList(item); + break; + case S_INT: + case S_HEX: + case S_STRING: + parent()->lineEdit->show(item); + break; + } +} + +void ConfigList::setRootMenu(struct menu *menu) +{ + enum prop_type type; + + if (rootEntry == menu) + return; + type = menu && menu->prompt ? menu->prompt->type : P_UNKNOWN; + if (type != P_MENU) + return; + updateMenuList(this, 0); + rootEntry = menu; + updateListAll(); + if (currentItem()) { + currentItem()->setSelected(hasFocus()); + scrollToItem(currentItem()); + } +} + +void ConfigList::setParentMenu(void) +{ + ConfigItem* item; + struct menu *oldroot; + + oldroot = rootEntry; + if (rootEntry == &rootmenu) + return; + setRootMenu(menu_get_parent_menu(rootEntry->parent)); + + QTreeWidgetItemIterator it(this); + while (*it) { + item = (ConfigItem *)(*it); + if (item->menu == oldroot) { + setCurrentItem(item); + scrollToItem(item); + break; + } + + ++it; + } +} + +/* + * update all the children of a menu entry + * removes/adds the entries from the parent widget as necessary + * + * parent: either the menu list widget or a menu entry widget + * menu: entry to be updated + */ +void ConfigList::updateMenuList(ConfigItem *parent, struct menu* menu) +{ + struct menu* child; + ConfigItem* item; + ConfigItem* last; + bool visible; + enum prop_type type; + + if (!menu) { + while (parent->childCount() > 0) + { + delete parent->takeChild(0); + } + + return; + } + + last = parent->firstChild(); + if (last && !last->goParent) + last = 0; + for (child = menu->list; child; child = child->next) { + item = last ? last->nextSibling() : parent->firstChild(); + type = child->prompt ? child->prompt->type : P_UNKNOWN; + + switch (mode) { + case menuMode: + if (!(child->flags & MENU_ROOT)) + goto hide; + break; + case symbolMode: + if (child->flags & MENU_ROOT) + goto hide; + break; + default: + break; + } + + visible = menu_is_visible(child); + if (!menuSkip(child)) { + if (!child->sym && !child->list && !child->prompt) + continue; + if (!item || item->menu != child) + item = new ConfigItem(parent, last, child, visible); + else + item->testUpdateMenu(visible); + + if (mode == fullMode || mode == menuMode || type != P_MENU) + updateMenuList(item, child); + else + updateMenuList(item, 0); + last = item; + continue; + } + hide: + if (item && item->menu == child) { + last = parent->firstChild(); + if (last == item) + last = 0; + else while (last->nextSibling() != item) + last = last->nextSibling(); + delete item; + } + } +} + +void ConfigList::updateMenuList(ConfigList *parent, struct menu* menu) +{ + struct menu* child; + ConfigItem* item; + ConfigItem* last; + bool visible; + enum prop_type type; + + if (!menu) { + while (parent->topLevelItemCount() > 0) + { + delete parent->takeTopLevelItem(0); + } + + return; + } + + last = (ConfigItem*)parent->topLevelItem(0); + if (last && !last->goParent) + last = 0; + for (child = menu->list; child; child = child->next) { + item = last ? last->nextSibling() : (ConfigItem*)parent->topLevelItem(0); + type = child->prompt ? child->prompt->type : P_UNKNOWN; + + switch (mode) { + case menuMode: + if (!(child->flags & MENU_ROOT)) + goto hide; + break; + case symbolMode: + if (child->flags & MENU_ROOT) + goto hide; + break; + default: + break; + } + + visible = menu_is_visible(child); + if (!menuSkip(child)) { + if (!child->sym && !child->list && !child->prompt) + continue; + if (!item || item->menu != child) + item = new ConfigItem(parent, last, child, visible); + else + item->testUpdateMenu(visible); + + if (mode == fullMode || mode == menuMode || type != P_MENU) + updateMenuList(item, child); + else + updateMenuList(item, 0); + last = item; + continue; + } + hide: + if (item && item->menu == child) { + last = (ConfigItem*)parent->topLevelItem(0); + if (last == item) + last = 0; + else while (last->nextSibling() != item) + last = last->nextSibling(); + delete item; + } + } +} + +void ConfigList::keyPressEvent(QKeyEvent* ev) +{ + QTreeWidgetItem* i = currentItem(); + ConfigItem* item; + struct menu *menu; + enum prop_type type; + + if (ev->key() == Qt::Key_Escape && mode != fullMode && mode != listMode) { + emit parentSelected(); + ev->accept(); + return; + } + + if (!i) { + Parent::keyPressEvent(ev); + return; + } + item = (ConfigItem*)i; + + switch (ev->key()) { + case Qt::Key_Return: + case Qt::Key_Enter: + if (item->goParent) { + emit parentSelected(); + break; + } + menu = item->menu; + if (!menu) + break; + type = menu->prompt ? menu->prompt->type : P_UNKNOWN; + if (type == P_MENU && rootEntry != menu && + mode != fullMode && mode != menuMode) { + emit menuSelected(menu); + break; + } + case Qt::Key_Space: + changeValue(item); + break; + case Qt::Key_N: + setValue(item, no); + break; + case Qt::Key_M: + setValue(item, mod); + break; + case Qt::Key_Y: + setValue(item, yes); + break; + default: + Parent::keyPressEvent(ev); + return; + } + ev->accept(); +} + +void ConfigList::mousePressEvent(QMouseEvent* e) +{ + //QPoint p(contentsToViewport(e->pos())); + //printf("contentsMousePressEvent: %d,%d\n", p.x(), p.y()); + Parent::mousePressEvent(e); +} + +void ConfigList::mouseReleaseEvent(QMouseEvent* e) +{ + QPoint p = e->pos(); + ConfigItem* item = (ConfigItem*)itemAt(p); + struct menu *menu; + enum prop_type ptype; + QIcon icon; + int idx, x; + + if (!item) + goto skip; + + menu = item->menu; + x = header()->offset() + p.x(); + idx = header()->logicalIndexAt(x); + switch (idx) { + case promptColIdx: + icon = item->pixmap(promptColIdx); + if (!icon.isNull()) { + int off = header()->sectionPosition(0) + visualRect(indexAt(p)).x() + 4; // 4 is Hardcoded image offset. There might be a way to do it properly. + if (x >= off && x < off + icon.availableSizes().first().width()) { + if (item->goParent) { + emit parentSelected(); + break; + } else if (!menu) + break; + ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN; + if (ptype == P_MENU && rootEntry != menu && + mode != fullMode && mode != menuMode) + emit menuSelected(menu); + else + changeValue(item); + } + } + break; + case noColIdx: + setValue(item, no); + break; + case modColIdx: + setValue(item, mod); + break; + case yesColIdx: + setValue(item, yes); + break; + case dataColIdx: + changeValue(item); + break; + } + +skip: + //printf("contentsMouseReleaseEvent: %d,%d\n", p.x(), p.y()); + Parent::mouseReleaseEvent(e); +} + +void ConfigList::mouseMoveEvent(QMouseEvent* e) +{ + //QPoint p(contentsToViewport(e->pos())); + //printf("contentsMouseMoveEvent: %d,%d\n", p.x(), p.y()); + Parent::mouseMoveEvent(e); +} + +void ConfigList::mouseDoubleClickEvent(QMouseEvent* e) +{ + QPoint p = e->pos(); // TODO: Check if this works(was contentsToViewport). + ConfigItem* item = (ConfigItem*)itemAt(p); + struct menu *menu; + enum prop_type ptype; + + if (!item) + goto skip; + if (item->goParent) { + emit parentSelected(); + goto skip; + } + menu = item->menu; + if (!menu) + goto skip; + ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN; + if (ptype == P_MENU && (mode == singleMode || mode == symbolMode)) + emit menuSelected(menu); + else if (menu->sym) + changeValue(item); + +skip: + //printf("contentsMouseDoubleClickEvent: %d,%d\n", p.x(), p.y()); + Parent::mouseDoubleClickEvent(e); +} + +void ConfigList::focusInEvent(QFocusEvent *e) +{ + struct menu *menu = NULL; + + Parent::focusInEvent(e); + + ConfigItem* item = (ConfigItem *)currentItem(); + if (item) { + item->setSelected(true); + menu = item->menu; + } + emit gotFocus(menu); +} + +void ConfigList::contextMenuEvent(QContextMenuEvent *e) +{ + if (e->y() <= header()->geometry().bottom()) { + if (!headerPopup) { + QAction *action; + + headerPopup = new QMenu(this); + action = new QAction(_("Show Name"), this); + action->setCheckable(true); + connect(action, SIGNAL(toggled(bool)), + parent(), SLOT(setShowName(bool))); + connect(parent(), SIGNAL(showNameChanged(bool)), + action, SLOT(setOn(bool))); + action->setChecked(showName); + headerPopup->addAction(action); + action = new QAction(_("Show Range"), this); + action->setCheckable(true); + connect(action, SIGNAL(toggled(bool)), + parent(), SLOT(setShowRange(bool))); + connect(parent(), SIGNAL(showRangeChanged(bool)), + action, SLOT(setOn(bool))); + action->setChecked(showRange); + headerPopup->addAction(action); + action = new QAction(_("Show Data"), this); + action->setCheckable(true); + connect(action, SIGNAL(toggled(bool)), + parent(), SLOT(setShowData(bool))); + connect(parent(), SIGNAL(showDataChanged(bool)), + action, SLOT(setOn(bool))); + action->setChecked(showData); + headerPopup->addAction(action); + } + headerPopup->exec(e->globalPos()); + e->accept(); + } else + e->ignore(); +} + +ConfigView*ConfigView::viewList; +QAction *ConfigView::showNormalAction; +QAction *ConfigView::showAllAction; +QAction *ConfigView::showPromptAction; + +ConfigView::ConfigView(QWidget* parent, const char *name) + : Parent(parent) +{ + setObjectName(name); + QVBoxLayout *verticalLayout = new QVBoxLayout(this); + verticalLayout->setContentsMargins(0, 0, 0, 0); + + list = new ConfigList(this); + verticalLayout->addWidget(list); + lineEdit = new ConfigLineEdit(this); + lineEdit->hide(); + verticalLayout->addWidget(lineEdit); + + this->nextView = viewList; + viewList = this; +} + +ConfigView::~ConfigView(void) +{ + ConfigView** vp; + + for (vp = &viewList; *vp; vp = &(*vp)->nextView) { + if (*vp == this) { + *vp = nextView; + break; + } + } +} + +void ConfigView::setOptionMode(QAction *act) +{ + if (act == showNormalAction) + list->optMode = normalOpt; + else if (act == showAllAction) + list->optMode = allOpt; + else + list->optMode = promptOpt; + + list->updateListAll(); +} + +void ConfigView::setShowName(bool b) +{ + if (list->showName != b) { + list->showName = b; + list->reinit(); + emit showNameChanged(b); + } +} + +void ConfigView::setShowRange(bool b) +{ + if (list->showRange != b) { + list->showRange = b; + list->reinit(); + emit showRangeChanged(b); + } +} + +void ConfigView::setShowData(bool b) +{ + if (list->showData != b) { + list->showData = b; + list->reinit(); + emit showDataChanged(b); + } +} + +void ConfigList::setAllOpen(bool open) +{ + QTreeWidgetItemIterator it(this); + + while (*it) { + (*it)->setExpanded(open); + + ++it; + } +} + +void ConfigView::updateList(ConfigItem* item) +{ + ConfigView* v; + + for (v = viewList; v; v = v->nextView) + v->list->updateList(item); +} + +void ConfigView::updateListAll(void) +{ + ConfigView* v; + + for (v = viewList; v; v = v->nextView) + v->list->updateListAll(); +} + +ConfigInfoView::ConfigInfoView(QWidget* parent, const char *name) + : Parent(parent), sym(0), _menu(0) +{ + setObjectName(name); + + + if (!objectName().isEmpty()) { + configSettings->beginGroup(objectName()); + _showDebug = configSettings->value("/showDebug", false).toBool(); + configSettings->endGroup(); + connect(configApp, SIGNAL(aboutToQuit()), SLOT(saveSettings())); + } +} + +void ConfigInfoView::saveSettings(void) +{ + if (!objectName().isEmpty()) { + configSettings->beginGroup(objectName()); + configSettings->setValue("/showDebug", showDebug()); + configSettings->endGroup(); + } +} + +void ConfigInfoView::setShowDebug(bool b) +{ + if (_showDebug != b) { + _showDebug = b; + if (_menu) + menuInfo(); + else if (sym) + symbolInfo(); + emit showDebugChanged(b); + } +} + +void ConfigInfoView::setInfo(struct menu *m) +{ + if (_menu == m) + return; + _menu = m; + sym = NULL; + if (!_menu) + clear(); + else + menuInfo(); +} + +void ConfigInfoView::symbolInfo(void) +{ + QString str; + + str += "Symbol: "; + str += print_filter(sym->name); + str += "

    value: "; + str += print_filter(sym_get_string_value(sym)); + str += "
    visibility: "; + str += sym->visible == yes ? "y" : sym->visible == mod ? "m" : "n"; + str += "
    "; + str += debug_info(sym); + + setText(str); +} + +void ConfigInfoView::menuInfo(void) +{ + struct symbol* sym; + QString head, debug, help; + + sym = _menu->sym; + if (sym) { + if (_menu->prompt) { + head += ""; + head += print_filter(_(_menu->prompt->text)); + head += ""; + if (sym->name) { + head += " ("; + if (showDebug()) + head += QString().sprintf("
    ", sym); + head += print_filter(sym->name); + if (showDebug()) + head += ""; + head += ")"; + } + } else if (sym->name) { + head += ""; + if (showDebug()) + head += QString().sprintf("", sym); + head += print_filter(sym->name); + if (showDebug()) + head += ""; + head += ""; + } + head += "

    "; + + if (showDebug()) + debug = debug_info(sym); + + struct gstr help_gstr = str_new(); + menu_get_ext_help(_menu, &help_gstr); + help = print_filter(str_get(&help_gstr)); + str_free(&help_gstr); + } else if (_menu->prompt) { + head += ""; + head += print_filter(_(_menu->prompt->text)); + head += "

    "; + if (showDebug()) { + if (_menu->prompt->visible.expr) { + debug += "  dep: "; + expr_print(_menu->prompt->visible.expr, expr_print_help, &debug, E_NONE); + debug += "

    "; + } + } + } + if (showDebug()) + debug += QString().sprintf("defined at %s:%d

    ", _menu->file->name, _menu->lineno); + + setText(head + debug + help); +} + +QString ConfigInfoView::debug_info(struct symbol *sym) +{ + QString debug; + + debug += "type: "; + debug += print_filter(sym_type_name(sym->type)); + if (sym_is_choice(sym)) + debug += " (choice)"; + debug += "
    "; + if (sym->rev_dep.expr) { + debug += "reverse dep: "; + expr_print(sym->rev_dep.expr, expr_print_help, &debug, E_NONE); + debug += "
    "; + } + for (struct property *prop = sym->prop; prop; prop = prop->next) { + switch (prop->type) { + case P_PROMPT: + case P_MENU: + debug += QString().sprintf("prompt: ", prop->menu); + debug += print_filter(_(prop->text)); + debug += "
    "; + break; + case P_DEFAULT: + case P_SELECT: + case P_RANGE: + case P_ENV: + debug += prop_get_type_name(prop->type); + debug += ": "; + expr_print(prop->expr, expr_print_help, &debug, E_NONE); + debug += "
    "; + break; + case P_CHOICE: + if (sym_is_choice(sym)) { + debug += "choice: "; + expr_print(prop->expr, expr_print_help, &debug, E_NONE); + debug += "
    "; + } + break; + default: + debug += "unknown property: "; + debug += prop_get_type_name(prop->type); + debug += "
    "; + } + if (prop->visible.expr) { + debug += "    dep: "; + expr_print(prop->visible.expr, expr_print_help, &debug, E_NONE); + debug += "
    "; + } + } + debug += "
    "; + + return debug; +} + +QString ConfigInfoView::print_filter(const QString &str) +{ + QRegExp re("[<>&\"\\n]"); + QString res = str; + for (int i = 0; (i = res.indexOf(re, i)) >= 0;) { + switch (res[i].toLatin1()) { + case '<': + res.replace(i, 1, "<"); + i += 4; + break; + case '>': + res.replace(i, 1, ">"); + i += 4; + break; + case '&': + res.replace(i, 1, "&"); + i += 5; + break; + case '"': + res.replace(i, 1, """); + i += 6; + break; + case '\n': + res.replace(i, 1, "
    "); + i += 4; + break; + } + } + return res; +} + +void ConfigInfoView::expr_print_help(void *data, struct symbol *sym, const char *str) +{ + QString* text = reinterpret_cast(data); + QString str2 = print_filter(str); + + if (sym && sym->name && !(sym->flags & SYMBOL_CONST)) { + *text += QString().sprintf("", sym); + *text += str2; + *text += ""; + } else + *text += str2; +} + +QMenu* ConfigInfoView::createStandardContextMenu(const QPoint & pos) +{ + QMenu* popup = Parent::createStandardContextMenu(pos); + QAction* action = new QAction(_("Show Debug Info"), popup); + action->setCheckable(true); + connect(action, SIGNAL(toggled(bool)), SLOT(setShowDebug(bool))); + connect(this, SIGNAL(showDebugChanged(bool)), action, SLOT(setOn(bool))); + action->setChecked(showDebug()); + popup->addSeparator(); + popup->addAction(action); + return popup; +} + +void ConfigInfoView::contextMenuEvent(QContextMenuEvent *e) +{ + Parent::contextMenuEvent(e); +} + +ConfigSearchWindow::ConfigSearchWindow(ConfigMainWindow* parent, const char *name) + : Parent(parent), result(NULL) +{ + setObjectName(name); + setWindowTitle("Search Config"); + + QVBoxLayout* layout1 = new QVBoxLayout(this); + layout1->setContentsMargins(11, 11, 11, 11); + layout1->setSpacing(6); + QHBoxLayout* layout2 = new QHBoxLayout(0); + layout2->setContentsMargins(0, 0, 0, 0); + layout2->setSpacing(6); + layout2->addWidget(new QLabel(_("Find:"), this)); + editField = new QLineEdit(this); + connect(editField, SIGNAL(returnPressed()), SLOT(search())); + layout2->addWidget(editField); + searchButton = new QPushButton(_("Search"), this); + searchButton->setAutoDefault(false); + connect(searchButton, SIGNAL(clicked()), SLOT(search())); + layout2->addWidget(searchButton); + layout1->addLayout(layout2); + + split = new QSplitter(this); + split->setOrientation(Qt::Vertical); + list = new ConfigView(split, name); + list->list->mode = listMode; + info = new ConfigInfoView(split, name); + connect(list->list, SIGNAL(menuChanged(struct menu *)), + info, SLOT(setInfo(struct menu *))); + connect(list->list, SIGNAL(menuChanged(struct menu *)), + parent, SLOT(setMenuLink(struct menu *))); + + layout1->addWidget(split); + + if (name) { + QVariant x, y; + int width, height; + bool ok; + + configSettings->beginGroup(name); + width = configSettings->value("/window width", parent->width() / 2).toInt(); + height = configSettings->value("/window height", parent->height() / 2).toInt(); + resize(width, height); + x = configSettings->value("/window x"); + y = configSettings->value("/window y"); + if ((x.isValid())&&(y.isValid())) + move(x.toInt(), y.toInt()); + QList sizes = configSettings->readSizes("/split", &ok); + if (ok) + split->setSizes(sizes); + configSettings->endGroup(); + connect(configApp, SIGNAL(aboutToQuit()), SLOT(saveSettings())); + } +} + +void ConfigSearchWindow::saveSettings(void) +{ + if (!objectName().isEmpty()) { + configSettings->beginGroup(objectName()); + configSettings->setValue("/window x", pos().x()); + configSettings->setValue("/window y", pos().y()); + configSettings->setValue("/window width", size().width()); + configSettings->setValue("/window height", size().height()); + configSettings->writeSizes("/split", split->sizes()); + configSettings->endGroup(); + } +} + +void ConfigSearchWindow::search(void) +{ + struct symbol **p; + struct property *prop; + ConfigItem *lastItem = NULL; + + free(result); + list->list->clear(); + info->clear(); + + result = sym_re_search(editField->text().toLatin1()); + if (!result) + return; + for (p = result; *p; p++) { + for_all_prompts((*p), prop) + lastItem = new ConfigItem(list->list, lastItem, prop->menu, + menu_is_visible(prop->menu)); + } +} + +/* + * Construct the complete config widget + */ +ConfigMainWindow::ConfigMainWindow(void) + : searchWindow(0) +{ + QMenuBar* menu; + bool ok = true; + QVariant x, y; + int width, height; + char title[256]; + + QDesktopWidget *d = configApp->desktop(); + snprintf(title, sizeof(title), "%s%s", + rootmenu.prompt->text, + "" + ); + setWindowTitle(title); + + width = configSettings->value("/window width", d->width() - 64).toInt(); + height = configSettings->value("/window height", d->height() - 64).toInt(); + resize(width, height); + x = configSettings->value("/window x"); + y = configSettings->value("/window y"); + if ((x.isValid())&&(y.isValid())) + move(x.toInt(), y.toInt()); + + split1 = new QSplitter(this); + split1->setOrientation(Qt::Horizontal); + setCentralWidget(split1); + + menuView = new ConfigView(split1, "menu"); + menuList = menuView->list; + + split2 = new QSplitter(split1); + split2->setOrientation(Qt::Vertical); + + // create config tree + configView = new ConfigView(split2, "config"); + configList = configView->list; + + helpText = new ConfigInfoView(split2, "help"); + + setTabOrder(configList, helpText); + configList->setFocus(); + + menu = menuBar(); + toolBar = new QToolBar("Tools", this); + addToolBar(toolBar); + + backAction = new QAction(QPixmap(xpm_back), _("Back"), this); + connect(backAction, SIGNAL(triggered(bool)), SLOT(goBack())); + backAction->setEnabled(false); + QAction *quitAction = new QAction(_("&Quit"), this); + quitAction->setShortcut(Qt::CTRL + Qt::Key_Q); + connect(quitAction, SIGNAL(triggered(bool)), SLOT(close())); + QAction *loadAction = new QAction(QPixmap(xpm_load), _("&Load"), this); + loadAction->setShortcut(Qt::CTRL + Qt::Key_L); + connect(loadAction, SIGNAL(triggered(bool)), SLOT(loadConfig())); + saveAction = new QAction(QPixmap(xpm_save), _("&Save"), this); + saveAction->setShortcut(Qt::CTRL + Qt::Key_S); + connect(saveAction, SIGNAL(triggered(bool)), SLOT(saveConfig())); + conf_set_changed_callback(conf_changed); + // Set saveAction's initial state + conf_changed(); + QAction *saveAsAction = new QAction(_("Save &As..."), this); + connect(saveAsAction, SIGNAL(triggered(bool)), SLOT(saveConfigAs())); + QAction *searchAction = new QAction(_("&Find"), this); + searchAction->setShortcut(Qt::CTRL + Qt::Key_F); + connect(searchAction, SIGNAL(triggered(bool)), SLOT(searchConfig())); + singleViewAction = new QAction(QPixmap(xpm_single_view), _("Single View"), this); + singleViewAction->setCheckable(true); + connect(singleViewAction, SIGNAL(triggered(bool)), SLOT(showSingleView())); + splitViewAction = new QAction(QPixmap(xpm_split_view), _("Split View"), this); + splitViewAction->setCheckable(true); + connect(splitViewAction, SIGNAL(triggered(bool)), SLOT(showSplitView())); + fullViewAction = new QAction(QPixmap(xpm_tree_view), _("Full View"), this); + fullViewAction->setCheckable(true); + connect(fullViewAction, SIGNAL(triggered(bool)), SLOT(showFullView())); + + QAction *showNameAction = new QAction(_("Show Name"), this); + showNameAction->setCheckable(true); + connect(showNameAction, SIGNAL(toggled(bool)), configView, SLOT(setShowName(bool))); + showNameAction->setChecked(configView->showName()); + QAction *showRangeAction = new QAction(_("Show Range"), this); + showRangeAction->setCheckable(true); + connect(showRangeAction, SIGNAL(toggled(bool)), configView, SLOT(setShowRange(bool))); + QAction *showDataAction = new QAction(_("Show Data"), this); + showDataAction->setCheckable(true); + connect(showDataAction, SIGNAL(toggled(bool)), configView, SLOT(setShowData(bool))); + + QActionGroup *optGroup = new QActionGroup(this); + optGroup->setExclusive(true); + connect(optGroup, SIGNAL(triggered(QAction*)), configView, + SLOT(setOptionMode(QAction *))); + connect(optGroup, SIGNAL(triggered(QAction *)), menuView, + SLOT(setOptionMode(QAction *))); + + configView->showNormalAction = new QAction(_("Show Normal Options"), optGroup); + configView->showAllAction = new QAction(_("Show All Options"), optGroup); + configView->showPromptAction = new QAction(_("Show Prompt Options"), optGroup); + configView->showNormalAction->setCheckable(true); + configView->showAllAction->setCheckable(true); + configView->showPromptAction->setCheckable(true); + + QAction *showDebugAction = new QAction( _("Show Debug Info"), this); + showDebugAction->setCheckable(true); + connect(showDebugAction, SIGNAL(toggled(bool)), helpText, SLOT(setShowDebug(bool))); + showDebugAction->setChecked(helpText->showDebug()); + + QAction *showIntroAction = new QAction( _("Introduction"), this); + connect(showIntroAction, SIGNAL(triggered(bool)), SLOT(showIntro())); + QAction *showAboutAction = new QAction( _("About"), this); + connect(showAboutAction, SIGNAL(triggered(bool)), SLOT(showAbout())); + + // init tool bar + toolBar->addAction(backAction); + toolBar->addSeparator(); + toolBar->addAction(loadAction); + toolBar->addAction(saveAction); + toolBar->addSeparator(); + toolBar->addAction(singleViewAction); + toolBar->addAction(splitViewAction); + toolBar->addAction(fullViewAction); + + // create config menu + QMenu* config = menu->addMenu(_("&File")); + config->addAction(loadAction); + config->addAction(saveAction); + config->addAction(saveAsAction); + config->addSeparator(); + config->addAction(quitAction); + + // create edit menu + QMenu* editMenu = menu->addMenu(_("&Edit")); + editMenu->addAction(searchAction); + + // create options menu + QMenu* optionMenu = menu->addMenu(_("&Option")); + optionMenu->addAction(showNameAction); + optionMenu->addAction(showRangeAction); + optionMenu->addAction(showDataAction); + optionMenu->addSeparator(); + optionMenu->addActions(optGroup->actions()); + optionMenu->addSeparator(); + + // create help menu + menu->addSeparator(); + QMenu* helpMenu = menu->addMenu(_("&Help")); + helpMenu->addAction(showIntroAction); + helpMenu->addAction(showAboutAction); + + connect(configList, SIGNAL(menuChanged(struct menu *)), + helpText, SLOT(setInfo(struct menu *))); + connect(configList, SIGNAL(menuSelected(struct menu *)), + SLOT(changeMenu(struct menu *))); + connect(configList, SIGNAL(parentSelected()), + SLOT(goBack())); + connect(menuList, SIGNAL(menuChanged(struct menu *)), + helpText, SLOT(setInfo(struct menu *))); + connect(menuList, SIGNAL(menuSelected(struct menu *)), + SLOT(changeMenu(struct menu *))); + + connect(configList, SIGNAL(gotFocus(struct menu *)), + helpText, SLOT(setInfo(struct menu *))); + connect(menuList, SIGNAL(gotFocus(struct menu *)), + helpText, SLOT(setInfo(struct menu *))); + connect(menuList, SIGNAL(gotFocus(struct menu *)), + SLOT(listFocusChanged(void))); + connect(helpText, SIGNAL(menuSelected(struct menu *)), + SLOT(setMenuLink(struct menu *))); + + QString listMode = configSettings->value("/listMode", "symbol").toString(); + if (listMode == "single") + showSingleView(); + else if (listMode == "full") + showFullView(); + else /*if (listMode == "split")*/ + showSplitView(); + + // UI setup done, restore splitter positions + QList sizes = configSettings->readSizes("/split1", &ok); + if (ok) + split1->setSizes(sizes); + + sizes = configSettings->readSizes("/split2", &ok); + if (ok) + split2->setSizes(sizes); +} + +void ConfigMainWindow::loadConfig(void) +{ + QString s = QFileDialog::getOpenFileName(this, "", conf_get_configname()); + if (s.isNull()) + return; + if (conf_read(QFile::encodeName(s))) + QMessageBox::information(this, "qconf", _("Unable to load configuration!")); + ConfigView::updateListAll(); +} + +bool ConfigMainWindow::saveConfig(void) +{ + if (conf_write(NULL)) { + QMessageBox::information(this, "qconf", _("Unable to save configuration!")); + return false; + } + return true; +} + +void ConfigMainWindow::saveConfigAs(void) +{ + QString s = QFileDialog::getSaveFileName(this, "", conf_get_configname()); + if (s.isNull()) + return; + saveConfig(); +} + +void ConfigMainWindow::searchConfig(void) +{ + if (!searchWindow) + searchWindow = new ConfigSearchWindow(this, "search"); + searchWindow->show(); +} + +void ConfigMainWindow::changeMenu(struct menu *menu) +{ + configList->setRootMenu(menu); + if (configList->rootEntry->parent == &rootmenu) + backAction->setEnabled(false); + else + backAction->setEnabled(true); +} + +void ConfigMainWindow::setMenuLink(struct menu *menu) +{ + struct menu *parent; + ConfigList* list = NULL; + ConfigItem* item; + + if (configList->menuSkip(menu)) + return; + + switch (configList->mode) { + case singleMode: + list = configList; + parent = menu_get_parent_menu(menu); + if (!parent) + return; + list->setRootMenu(parent); + break; + case symbolMode: + if (menu->flags & MENU_ROOT) { + configList->setRootMenu(menu); + configList->clearSelection(); + list = menuList; + } else { + list = configList; + parent = menu_get_parent_menu(menu->parent); + if (!parent) + return; + item = menuList->findConfigItem(parent); + if (item) { + item->setSelected(true); + menuList->scrollToItem(item); + } + list->setRootMenu(parent); + } + break; + case fullMode: + list = configList; + break; + default: + break; + } + + if (list) { + item = list->findConfigItem(menu); + if (item) { + item->setSelected(true); + list->scrollToItem(item); + list->setFocus(); + } + } +} + +void ConfigMainWindow::listFocusChanged(void) +{ + if (menuList->mode == menuMode) + configList->clearSelection(); +} + +void ConfigMainWindow::goBack(void) +{ + ConfigItem* item, *oldSelection; + + configList->setParentMenu(); + if (configList->rootEntry == &rootmenu) + backAction->setEnabled(false); + + if (menuList->selectedItems().count() == 0) + return; + + item = (ConfigItem*)menuList->selectedItems().first(); + oldSelection = item; + while (item) { + if (item->menu == configList->rootEntry) { + oldSelection->setSelected(false); + item->setSelected(true); + break; + } + item = (ConfigItem*)item->parent(); + } +} + +void ConfigMainWindow::showSingleView(void) +{ + singleViewAction->setEnabled(false); + singleViewAction->setChecked(true); + splitViewAction->setEnabled(true); + splitViewAction->setChecked(false); + fullViewAction->setEnabled(true); + fullViewAction->setChecked(false); + + menuView->hide(); + menuList->setRootMenu(0); + configList->mode = singleMode; + if (configList->rootEntry == &rootmenu) + configList->updateListAll(); + else + configList->setRootMenu(&rootmenu); + configList->setFocus(); +} + +void ConfigMainWindow::showSplitView(void) +{ + singleViewAction->setEnabled(true); + singleViewAction->setChecked(false); + splitViewAction->setEnabled(false); + splitViewAction->setChecked(true); + fullViewAction->setEnabled(true); + fullViewAction->setChecked(false); + + configList->mode = symbolMode; + if (configList->rootEntry == &rootmenu) + configList->updateListAll(); + else + configList->setRootMenu(&rootmenu); + configList->setAllOpen(true); + configApp->processEvents(); + menuList->mode = menuMode; + menuList->setRootMenu(&rootmenu); + menuList->setAllOpen(true); + menuView->show(); + menuList->setFocus(); +} + +void ConfigMainWindow::showFullView(void) +{ + singleViewAction->setEnabled(true); + singleViewAction->setChecked(false); + splitViewAction->setEnabled(true); + splitViewAction->setChecked(false); + fullViewAction->setEnabled(false); + fullViewAction->setChecked(true); + + menuView->hide(); + menuList->setRootMenu(0); + configList->mode = fullMode; + if (configList->rootEntry == &rootmenu) + configList->updateListAll(); + else + configList->setRootMenu(&rootmenu); + configList->setFocus(); +} + +/* + * ask for saving configuration before quitting + * TODO ask only when something changed + */ +void ConfigMainWindow::closeEvent(QCloseEvent* e) +{ + if (!conf_get_changed()) { + e->accept(); + return; + } + QMessageBox mb("qconf", _("Save configuration?"), QMessageBox::Warning, + QMessageBox::Yes | QMessageBox::Default, QMessageBox::No, QMessageBox::Cancel | QMessageBox::Escape); + mb.setButtonText(QMessageBox::Yes, _("&Save Changes")); + mb.setButtonText(QMessageBox::No, _("&Discard Changes")); + mb.setButtonText(QMessageBox::Cancel, _("Cancel Exit")); + switch (mb.exec()) { + case QMessageBox::Yes: + if (saveConfig()) + e->accept(); + else + e->ignore(); + break; + case QMessageBox::No: + e->accept(); + break; + case QMessageBox::Cancel: + e->ignore(); + break; + } +} + +void ConfigMainWindow::showIntro(void) +{ + static const QString str = _("Welcome to the qconf graphical configuration tool.\n\n" + "For each option, a blank box indicates the feature is disabled, a check\n" + "indicates it is enabled, and a dot indicates that it is to be compiled\n" + "as a module. Clicking on the box will cycle through the three states.\n\n" + "If you do not see an option (e.g., a device driver) that you believe\n" + "should be present, try turning on Show All Options under the Options menu.\n" + "Although there is no cross reference yet to help you figure out what other\n" + "options must be enabled to support the option you are interested in, you can\n" + "still view the help of a grayed-out option.\n\n" + "Toggling Show Debug Info under the Options menu will show the dependencies,\n" + "which you can then match by examining other options.\n\n"); + + QMessageBox::information(this, "qconf", str); +} + +void ConfigMainWindow::showAbout(void) +{ + static const QString str = _("qconf is Copyright (C) 2002 Roman Zippel .\n" + "Copyright (C) 2015 Boris Barbulovski .\n\n" + "Bug reports and feature request can also be entered at http://bugzilla.kernel.org/\n"); + + QMessageBox::information(this, "qconf", str); +} + +void ConfigMainWindow::saveSettings(void) +{ + configSettings->setValue("/window x", pos().x()); + configSettings->setValue("/window y", pos().y()); + configSettings->setValue("/window width", size().width()); + configSettings->setValue("/window height", size().height()); + + QString entry; + switch(configList->mode) { + case singleMode : + entry = "single"; + break; + + case symbolMode : + entry = "split"; + break; + + case fullMode : + entry = "full"; + break; + + default: + break; + } + configSettings->setValue("/listMode", entry); + + configSettings->writeSizes("/split1", split1->sizes()); + configSettings->writeSizes("/split2", split2->sizes()); +} + +void ConfigMainWindow::conf_changed(void) +{ + if (saveAction) + saveAction->setEnabled(conf_get_changed()); +} + +void fixup_rootmenu(struct menu *menu) +{ + struct menu *child; + static int menu_cnt = 0; + + menu->flags |= MENU_ROOT; + for (child = menu->list; child; child = child->next) { + if (child->prompt && child->prompt->type == P_MENU) { + menu_cnt++; + fixup_rootmenu(child); + menu_cnt--; + } else if (!menu_cnt) + fixup_rootmenu(child); + } +} + +static const char *progname; + +static void usage(void) +{ + printf(_("%s [-s] \n").toLatin1().constData(), progname); + exit(0); +} + +int main(int ac, char** av) +{ + ConfigMainWindow* v; + const char *name; + + bindtextdomain(PACKAGE, LOCALEDIR); + textdomain(PACKAGE); + + progname = av[0]; + configApp = new QApplication(ac, av); + if (ac > 1 && av[1][0] == '-') { + switch (av[1][1]) { + case 's': + conf_set_message_callback(NULL); + break; + case 'h': + case '?': + usage(); + } + name = av[2]; + } else + name = av[1]; + if (!name) + usage(); + + conf_parse(name); + fixup_rootmenu(&rootmenu); + conf_read(NULL); + //zconfdump(stdout); + + configSettings = new ConfigSettings(); + configSettings->beginGroup("/kconfig/qconf"); + v = new ConfigMainWindow(); + + //zconfdump(stdout); + configApp->connect(configApp, SIGNAL(lastWindowClosed()), SLOT(quit())); + configApp->connect(configApp, SIGNAL(aboutToQuit()), v, SLOT(saveSettings())); + v->show(); + configApp->exec(); + + configSettings->endGroup(); + delete configSettings; + delete v; + delete configApp; + + return 0; +} diff --git a/tools/kconfig/qconf.h b/tools/kconfig/qconf.h new file mode 100644 index 000000000..a40036d1b --- /dev/null +++ b/tools/kconfig/qconf.h @@ -0,0 +1,330 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include "expr.h" + +class ConfigView; +class ConfigList; +class ConfigItem; +class ConfigLineEdit; +class ConfigMainWindow; + +class ConfigSettings : public QSettings { +public: + ConfigSettings(); + QList readSizes(const QString& key, bool *ok); + bool writeSizes(const QString& key, const QList& value); +}; + +enum colIdx { + promptColIdx, nameColIdx, noColIdx, modColIdx, yesColIdx, dataColIdx, colNr +}; +enum listMode { + singleMode, menuMode, symbolMode, fullMode, listMode +}; +enum optionMode { + normalOpt = 0, allOpt, promptOpt +}; + +class ConfigList : public QTreeWidget { + Q_OBJECT + typedef class QTreeWidget Parent; +public: + ConfigList(ConfigView* p, const char *name = 0); + void reinit(void); + ConfigView* parent(void) const + { + return (ConfigView*)Parent::parent(); + } + ConfigItem* findConfigItem(struct menu *); + +protected: + void keyPressEvent(QKeyEvent *e); + void mousePressEvent(QMouseEvent *e); + void mouseReleaseEvent(QMouseEvent *e); + void mouseMoveEvent(QMouseEvent *e); + void mouseDoubleClickEvent(QMouseEvent *e); + void focusInEvent(QFocusEvent *e); + void contextMenuEvent(QContextMenuEvent *e); + +public slots: + void setRootMenu(struct menu *menu); + + void updateList(ConfigItem *item); + void setValue(ConfigItem* item, tristate val); + void changeValue(ConfigItem* item); + void updateSelection(void); + void saveSettings(void); +signals: + void menuChanged(struct menu *menu); + void menuSelected(struct menu *menu); + void parentSelected(void); + void gotFocus(struct menu *); + +public: + void updateListAll(void) + { + updateAll = true; + updateList(NULL); + updateAll = false; + } + ConfigList* listView() + { + return this; + } + ConfigItem* firstChild() const + { + return (ConfigItem *)children().first(); + } + void addColumn(colIdx idx) + { + showColumn(idx); + } + void removeColumn(colIdx idx) + { + hideColumn(idx); + } + void setAllOpen(bool open); + void setParentMenu(void); + + bool menuSkip(struct menu *); + + void updateMenuList(ConfigItem *parent, struct menu*); + void updateMenuList(ConfigList *parent, struct menu*); + + bool updateAll; + + QPixmap symbolYesPix, symbolModPix, symbolNoPix; + QPixmap choiceYesPix, choiceNoPix; + QPixmap menuPix, menuInvPix, menuBackPix, voidPix; + + bool showName, showRange, showData; + enum listMode mode; + enum optionMode optMode; + struct menu *rootEntry; + QPalette disabledColorGroup; + QPalette inactivedColorGroup; + QMenu* headerPopup; +}; + +class ConfigItem : public QTreeWidgetItem { + typedef class QTreeWidgetItem Parent; +public: + ConfigItem(ConfigList *parent, ConfigItem *after, struct menu *m, bool v) + : Parent(parent, after), nextItem(0), menu(m), visible(v), goParent(false) + { + init(); + } + ConfigItem(ConfigItem *parent, ConfigItem *after, struct menu *m, bool v) + : Parent(parent, after), nextItem(0), menu(m), visible(v), goParent(false) + { + init(); + } + ConfigItem(ConfigList *parent, ConfigItem *after, bool v) + : Parent(parent, after), nextItem(0), menu(0), visible(v), goParent(true) + { + init(); + } + ~ConfigItem(void); + void init(void); + void okRename(int col); + void updateMenu(void); + void testUpdateMenu(bool v); + ConfigList* listView() const + { + return (ConfigList*)Parent::treeWidget(); + } + ConfigItem* firstChild() const + { + return (ConfigItem *)Parent::child(0); + } + ConfigItem* nextSibling() + { + ConfigItem *ret = NULL; + ConfigItem *_parent = (ConfigItem *)parent(); + + if(_parent) { + ret = (ConfigItem *)_parent->child(_parent->indexOfChild(this)+1); + } else { + QTreeWidget *_treeWidget = treeWidget(); + ret = (ConfigItem *)_treeWidget->topLevelItem(_treeWidget->indexOfTopLevelItem(this)+1); + } + + return ret; + } + void setText(colIdx idx, const QString& text) + { + Parent::setText(idx, text); + } + QString text(colIdx idx) const + { + return Parent::text(idx); + } + void setPixmap(colIdx idx, const QIcon &icon) + { + Parent::setIcon(idx, icon); + } + const QIcon pixmap(colIdx idx) const + { + return icon(idx); + } + // TODO: Implement paintCell + + ConfigItem* nextItem; + struct menu *menu; + bool visible; + bool goParent; +}; + +class ConfigLineEdit : public QLineEdit { + Q_OBJECT + typedef class QLineEdit Parent; +public: + ConfigLineEdit(ConfigView* parent); + ConfigView* parent(void) const + { + return (ConfigView*)Parent::parent(); + } + void show(ConfigItem *i); + void keyPressEvent(QKeyEvent *e); + +public: + ConfigItem *item; +}; + +class ConfigView : public QWidget { + Q_OBJECT + typedef class QWidget Parent; +public: + ConfigView(QWidget* parent, const char *name = 0); + ~ConfigView(void); + static void updateList(ConfigItem* item); + static void updateListAll(void); + + bool showName(void) const { return list->showName; } + bool showRange(void) const { return list->showRange; } + bool showData(void) const { return list->showData; } +public slots: + void setShowName(bool); + void setShowRange(bool); + void setShowData(bool); + void setOptionMode(QAction *); +signals: + void showNameChanged(bool); + void showRangeChanged(bool); + void showDataChanged(bool); +public: + ConfigList* list; + ConfigLineEdit* lineEdit; + + static ConfigView* viewList; + ConfigView* nextView; + + static QAction *showNormalAction; + static QAction *showAllAction; + static QAction *showPromptAction; +}; + +class ConfigInfoView : public QTextBrowser { + Q_OBJECT + typedef class QTextBrowser Parent; +public: + ConfigInfoView(QWidget* parent, const char *name = 0); + bool showDebug(void) const { return _showDebug; } + +public slots: + void setInfo(struct menu *menu); + void saveSettings(void); + void setShowDebug(bool); + +signals: + void showDebugChanged(bool); + void menuSelected(struct menu *); + +protected: + void symbolInfo(void); + void menuInfo(void); + QString debug_info(struct symbol *sym); + static QString print_filter(const QString &str); + static void expr_print_help(void *data, struct symbol *sym, const char *str); + QMenu *createStandardContextMenu(const QPoint & pos); + void contextMenuEvent(QContextMenuEvent *e); + + struct symbol *sym; + struct menu *_menu; + bool _showDebug; +}; + +class ConfigSearchWindow : public QDialog { + Q_OBJECT + typedef class QDialog Parent; +public: + ConfigSearchWindow(ConfigMainWindow* parent, const char *name = 0); + +public slots: + void saveSettings(void); + void search(void); + +protected: + QLineEdit* editField; + QPushButton* searchButton; + QSplitter* split; + ConfigView* list; + ConfigInfoView* info; + + struct symbol **result; +}; + +class ConfigMainWindow : public QMainWindow { + Q_OBJECT + + static QAction *saveAction; + static void conf_changed(void); +public: + ConfigMainWindow(void); +public slots: + void changeMenu(struct menu *); + void setMenuLink(struct menu *); + void listFocusChanged(void); + void goBack(void); + void loadConfig(void); + bool saveConfig(void); + void saveConfigAs(void); + void searchConfig(void); + void showSingleView(void); + void showSplitView(void); + void showFullView(void); + void showIntro(void); + void showAbout(void); + void saveSettings(void); + +protected: + void closeEvent(QCloseEvent *e); + + ConfigSearchWindow *searchWindow; + ConfigView *menuView; + ConfigList *menuList; + ConfigView *configView; + ConfigList *configList; + ConfigInfoView *helpText; + QToolBar *toolBar; + QAction *backAction; + QAction *singleViewAction; + QAction *splitViewAction; + QAction *fullViewAction; + QSplitter *split1; + QSplitter *split2; +}; diff --git a/tools/kconfig/streamline_config.pl b/tools/kconfig/streamline_config.pl new file mode 100755 index 000000000..f3d3fb42b --- /dev/null +++ b/tools/kconfig/streamline_config.pl @@ -0,0 +1,647 @@ +#!/usr/bin/perl -w +# +# Copyright 2005-2009 - Steven Rostedt +# Licensed under the terms of the GNU GPL License version 2 +# +# It's simple enough to figure out how this works. +# If not, then you can ask me at stripconfig@goodmis.org +# +# What it does? +# +# If you have installed a Linux kernel from a distribution +# that turns on way too many modules than you need, and +# you only want the modules you use, then this program +# is perfect for you. +# +# It gives you the ability to turn off all the modules that are +# not loaded on your system. +# +# Howto: +# +# 1. Boot up the kernel that you want to stream line the config on. +# 2. Change directory to the directory holding the source of the +# kernel that you just booted. +# 3. Copy the configuraton file to this directory as .config +# 4. Have all your devices that you need modules for connected and +# operational (make sure that their corresponding modules are loaded) +# 5. Run this script redirecting the output to some other file +# like config_strip. +# 6. Back up your old config (if you want too). +# 7. copy the config_strip file to .config +# 8. Run "make oldconfig" +# +# Now your kernel is ready to be built with only the modules that +# are loaded. +# +# Here's what I did with my Debian distribution. +# +# cd /usr/src/linux-2.6.10 +# cp /boot/config-2.6.10-1-686-smp .config +# ~/bin/streamline_config > config_strip +# mv .config config_sav +# mv config_strip .config +# make oldconfig +# +use strict; +use Getopt::Long; + +# set the environment variable LOCALMODCONFIG_DEBUG to get +# debug output. +my $debugprint = 0; +$debugprint = 1 if (defined($ENV{LOCALMODCONFIG_DEBUG})); + +sub dprint { + return if (!$debugprint); + print STDERR @_; +} + +my $config = ".config"; + +my $uname = `uname -r`; +chomp $uname; + +my @searchconfigs = ( + { + "file" => ".config", + "exec" => "cat", + }, + { + "file" => "/proc/config.gz", + "exec" => "zcat", + }, + { + "file" => "/boot/config-$uname", + "exec" => "cat", + }, + { + "file" => "/boot/vmlinuz-$uname", + "exec" => "scripts/extract-ikconfig", + "test" => "scripts/extract-ikconfig", + }, + { + "file" => "vmlinux", + "exec" => "scripts/extract-ikconfig", + "test" => "scripts/extract-ikconfig", + }, + { + "file" => "/lib/modules/$uname/kernel/kernel/configs.ko", + "exec" => "scripts/extract-ikconfig", + "test" => "scripts/extract-ikconfig", + }, + { + "file" => "kernel/configs.ko", + "exec" => "scripts/extract-ikconfig", + "test" => "scripts/extract-ikconfig", + }, + { + "file" => "kernel/configs.o", + "exec" => "scripts/extract-ikconfig", + "test" => "scripts/extract-ikconfig", + }, +); + +sub read_config { + foreach my $conf (@searchconfigs) { + my $file = $conf->{"file"}; + + next if ( ! -f "$file"); + + if (defined($conf->{"test"})) { + `$conf->{"test"} $conf->{"file"} 2>/dev/null`; + next if ($?); + } + + my $exec = $conf->{"exec"}; + + print STDERR "using config: '$file'\n"; + + open(my $infile, '-|', "$exec $file") || die "Failed to run $exec $file"; + my @x = <$infile>; + close $infile; + return @x; + } + die "No config file found"; +} + +my @config_file = read_config; + +# Parse options +my $localmodconfig = 0; +my $localyesconfig = 0; + +GetOptions("localmodconfig" => \$localmodconfig, + "localyesconfig" => \$localyesconfig); + +# Get the build source and top level Kconfig file (passed in) +my $ksource = ($ARGV[0] ? $ARGV[0] : '.'); +my $kconfig = $ARGV[1]; +my $lsmod_file = $ENV{'LSMOD'}; + +my @makefiles = `find $ksource -name Makefile -or -name Kbuild 2>/dev/null`; +chomp @makefiles; + +my %depends; +my %selects; +my %prompts; +my %objects; +my $var; +my $iflevel = 0; +my @ifdeps; + +# prevent recursion +my %read_kconfigs; + +sub read_kconfig { + my ($kconfig) = @_; + + my $state = "NONE"; + my $config; + + my $cont = 0; + my $line; + + my $source = "$ksource/$kconfig"; + my $last_source = ""; + + # Check for any environment variables used + while ($source =~ /\$(\w+)/ && $last_source ne $source) { + my $env = $1; + $last_source = $source; + $source =~ s/\$$env/$ENV{$env}/; + } + + open(my $kinfile, '<', $source) || die "Can't open $kconfig"; + while (<$kinfile>) { + chomp; + + # Make sure that lines ending with \ continue + if ($cont) { + $_ = $line . " " . $_; + } + + if (s/\\$//) { + $cont = 1; + $line = $_; + next; + } + + $cont = 0; + + # collect any Kconfig sources + if (/^source\s*"(.*)"/) { + my $kconfig = $1; + # prevent reading twice. + if (!defined($read_kconfigs{$kconfig})) { + $read_kconfigs{$kconfig} = 1; + read_kconfig($kconfig); + } + next; + } + + # configs found + if (/^\s*(menu)?config\s+(\S+)\s*$/) { + $state = "NEW"; + $config = $2; + + # Add depends for 'if' nesting + for (my $i = 0; $i < $iflevel; $i++) { + if ($i) { + $depends{$config} .= " " . $ifdeps[$i]; + } else { + $depends{$config} = $ifdeps[$i]; + } + $state = "DEP"; + } + + # collect the depends for the config + } elsif ($state eq "NEW" && /^\s*depends\s+on\s+(.*)$/) { + $state = "DEP"; + $depends{$config} = $1; + } elsif ($state eq "DEP" && /^\s*depends\s+on\s+(.*)$/) { + $depends{$config} .= " " . $1; + } elsif ($state eq "DEP" && /^\s*def(_(bool|tristate)|ault)\s+(\S.*)$/) { + my $dep = $3; + if ($dep !~ /^\s*(y|m|n)\s*$/) { + $dep =~ s/.*\sif\s+//; + $depends{$config} .= " " . $dep; + dprint "Added default depends $dep to $config\n"; + } + + # Get the configs that select this config + } elsif ($state ne "NONE" && /^\s*select\s+(\S+)/) { + my $conf = $1; + if (defined($selects{$conf})) { + $selects{$conf} .= " " . $config; + } else { + $selects{$conf} = $config; + } + + # configs without prompts must be selected + } elsif ($state ne "NONE" && /^\s*tristate\s\S/) { + # note if the config has a prompt + $prompts{$config} = 1; + + # Check for if statements + } elsif (/^if\s+(.*\S)\s*$/) { + my $deps = $1; + # remove beginning and ending non text + $deps =~ s/^[^a-zA-Z0-9_]*//; + $deps =~ s/[^a-zA-Z0-9_]*$//; + + my @deps = split /[^a-zA-Z0-9_]+/, $deps; + + $ifdeps[$iflevel++] = join ':', @deps; + + } elsif (/^endif/) { + + $iflevel-- if ($iflevel); + + # stop on "help" + } elsif (/^\s*help\s*$/) { + $state = "NONE"; + } + } + close($kinfile); +} + +if ($kconfig) { + read_kconfig($kconfig); +} + +# Makefiles can use variables to define their dependencies +sub convert_vars { + my ($line, %vars) = @_; + + my $process = ""; + + while ($line =~ s/^(.*?)(\$\((.*?)\))//) { + my $start = $1; + my $variable = $2; + my $var = $3; + + if (defined($vars{$var})) { + $process .= $start . $vars{$var}; + } else { + $process .= $start . $variable; + } + } + + $process .= $line; + + return $process; +} + +# Read all Makefiles to map the configs to the objects +foreach my $makefile (@makefiles) { + + my $line = ""; + my %make_vars; + + open(my $infile, '<', $makefile) || die "Can't open $makefile"; + while (<$infile>) { + # if this line ends with a backslash, continue + chomp; + if (/^(.*)\\$/) { + $line .= $1; + next; + } + + $line .= $_; + $_ = $line; + $line = ""; + + my $objs; + + # Convert variables in a line (could define configs) + $_ = convert_vars($_, %make_vars); + + # collect objects after obj-$(CONFIG_FOO_BAR) + if (/obj-\$\((CONFIG_[^\)]*)\)\s*[+:]?=\s*(.*)/) { + $var = $1; + $objs = $2; + + # check if variables are set + } elsif (/^\s*(\S+)\s*[:]?=\s*(.*\S)/) { + $make_vars{$1} = $2; + } + if (defined($objs)) { + foreach my $obj (split /\s+/,$objs) { + $obj =~ s/-/_/g; + if ($obj =~ /(.*)\.o$/) { + # Objects may be enabled by more than one config. + # Store configs in an array. + my @arr; + + if (defined($objects{$1})) { + @arr = @{$objects{$1}}; + } + + $arr[$#arr+1] = $var; + + # The objects have a hash mapping to a reference + # of an array of configs. + $objects{$1} = \@arr; + } + } + } + } + close($infile); +} + +my %modules; +my $linfile; + +if (defined($lsmod_file)) { + if ( ! -f $lsmod_file) { + if ( -f $ENV{'objtree'}."/".$lsmod_file) { + $lsmod_file = $ENV{'objtree'}."/".$lsmod_file; + } else { + die "$lsmod_file not found"; + } + } + + my $otype = ( -x $lsmod_file) ? '-|' : '<'; + open($linfile, $otype, $lsmod_file); + +} else { + + # see what modules are loaded on this system + my $lsmod; + + foreach my $dir ( ("/sbin", "/bin", "/usr/sbin", "/usr/bin") ) { + if ( -x "$dir/lsmod" ) { + $lsmod = "$dir/lsmod"; + last; + } +} + if (!defined($lsmod)) { + # try just the path + $lsmod = "lsmod"; + } + + open($linfile, '-|', $lsmod) || die "Can not call lsmod with $lsmod"; +} + +while (<$linfile>) { + next if (/^Module/); # Skip the first line. + if (/^(\S+)/) { + $modules{$1} = 1; + } +} +close ($linfile); + +# add to the configs hash all configs that are needed to enable +# a loaded module. This is a direct obj-${CONFIG_FOO} += bar.o +# where we know we need bar.o so we add FOO to the list. +my %configs; +foreach my $module (keys(%modules)) { + if (defined($objects{$module})) { + my @arr = @{$objects{$module}}; + foreach my $conf (@arr) { + $configs{$conf} = $module; + dprint "$conf added by direct ($module)\n"; + if ($debugprint) { + my $c=$conf; + $c =~ s/^CONFIG_//; + if (defined($depends{$c})) { + dprint " deps = $depends{$c}\n"; + } else { + dprint " no deps\n"; + } + } + } + } else { + # Most likely, someone has a custom (binary?) module loaded. + print STDERR "$module config not found!!\n"; + } +} + +# Read the current config, and see what is enabled. We want to +# ignore configs that we would not enable anyway. + +my %orig_configs; +my $valid = "A-Za-z_0-9"; + +foreach my $line (@config_file) { + $_ = $line; + + if (/(CONFIG_[$valid]*)=(m|y)/) { + $orig_configs{$1} = $2; + } +} + +my $repeat = 1; + +my $depconfig; + +# +# Note, we do not care about operands (like: &&, ||, !) we want to add any +# config that is in the depend list of another config. This script does +# not enable configs that are not already enabled. If we come across a +# config A that depends on !B, we can still add B to the list of depends +# to keep on. If A was on in the original config, B would not have been +# and B would not be turned on by this script. +# +sub parse_config_depends +{ + my ($p) = @_; + + while ($p =~ /[$valid]/) { + + if ($p =~ /^[^$valid]*([$valid]+)/) { + my $conf = "CONFIG_" . $1; + + $p =~ s/^[^$valid]*[$valid]+//; + + # We only need to process if the depend config is a module + if (!defined($orig_configs{$conf}) || !$orig_configs{conf} eq "m") { + next; + } + + if (!defined($configs{$conf})) { + # We must make sure that this config has its + # dependencies met. + $repeat = 1; # do again + dprint "$conf selected by depend $depconfig\n"; + $configs{$conf} = 1; + } + } else { + die "this should never happen"; + } + } +} + +# Select is treated a bit differently than depends. We call this +# when a config has no prompt and requires another config to be +# selected. We use to just select all configs that selected this +# config, but found that that can balloon into enabling hundreds +# of configs that we do not care about. +# +# The idea is we look at all the configs that select it. If one +# is already in our list of configs to enable, then there's nothing +# else to do. If there isn't, we pick the first config that was +# enabled in the orignal config and use that. +sub parse_config_selects +{ + my ($config, $p) = @_; + + my $next_config; + + while ($p =~ /[$valid]/) { + + if ($p =~ /^[^$valid]*([$valid]+)/) { + my $conf = "CONFIG_" . $1; + + $p =~ s/^[^$valid]*[$valid]+//; + + # Make sure that this config exists in the current .config file + if (!defined($orig_configs{$conf})) { + dprint "$conf not set for $config select\n"; + next; + } + + # Check if something other than a module selects this config + if (defined($orig_configs{$conf}) && $orig_configs{$conf} ne "m") { + dprint "$conf (non module) selects config, we are good\n"; + # we are good with this + return; + } + if (defined($configs{$conf})) { + dprint "$conf selects $config so we are good\n"; + # A set config selects this config, we are good + return; + } + # Set this config to be selected + if (!defined($next_config)) { + $next_config = $conf; + } + } else { + die "this should never happen"; + } + } + + # If no possible config selected this, then something happened. + if (!defined($next_config)) { + print STDERR "WARNING: $config is required, but nothing in the\n"; + print STDERR " current config selects it.\n"; + return; + } + + # If we are here, then we found no config that is set and + # selects this config. Repeat. + $repeat = 1; + # Make this config need to be selected + $configs{$next_config} = 1; + dprint "$next_config selected by select $config\n"; +} + +my %process_selects; + +# loop through all configs, select their dependencies. +sub loop_depend { + $repeat = 1; + + while ($repeat) { + $repeat = 0; + + forloop: + foreach my $config (keys %configs) { + + # If this config is not a module, we do not need to process it + if (defined($orig_configs{$config}) && $orig_configs{$config} ne "m") { + next forloop; + } + + $config =~ s/^CONFIG_//; + $depconfig = $config; + + if (defined($depends{$config})) { + # This config has dependencies. Make sure they are also included + parse_config_depends $depends{$config}; + } + + # If the config has no prompt, then we need to check if a config + # that is enabled selected it. Or if we need to enable one. + if (!defined($prompts{$config}) && defined($selects{$config})) { + $process_selects{$config} = 1; + } + } + } +} + +sub loop_select { + + foreach my $config (keys %process_selects) { + $config =~ s/^CONFIG_//; + + dprint "Process select $config\n"; + + # config has no prompt and must be selected. + parse_config_selects $config, $selects{$config}; + } +} + +while ($repeat) { + # Get the first set of configs and their dependencies. + loop_depend; + + $repeat = 0; + + # Now we need to see if we have to check selects; + loop_select; +} + +my %setconfigs; + +# Finally, read the .config file and turn off any module enabled that +# we could not find a reason to keep enabled. +foreach my $line (@config_file) { + $_ = $line; + + if (/CONFIG_IKCONFIG/) { + if (/# CONFIG_IKCONFIG is not set/) { + # enable IKCONFIG at least as a module + print "CONFIG_IKCONFIG=m\n"; + # don't ask about PROC + print "# CONFIG_IKCONFIG_PROC is not set\n"; + } else { + print; + } + next; + } + + if (/^(CONFIG.*)=(m|y)/) { + if (defined($configs{$1})) { + if ($localyesconfig) { + $setconfigs{$1} = 'y'; + print "$1=y\n"; + next; + } else { + $setconfigs{$1} = $2; + } + } elsif ($2 eq "m") { + print "# $1 is not set\n"; + next; + } + } + print; +} + +# Integrity check, make sure all modules that we want enabled do +# indeed have their configs set. +loop: +foreach my $module (keys(%modules)) { + if (defined($objects{$module})) { + my @arr = @{$objects{$module}}; + foreach my $conf (@arr) { + if (defined($setconfigs{$conf})) { + next loop; + } + } + print STDERR "module $module did not have configs"; + foreach my $conf (@arr) { + print STDERR " " , $conf; + } + print STDERR "\n"; + } +} diff --git a/tools/kconfig/symbol.c b/tools/kconfig/symbol.c new file mode 100644 index 000000000..25cf0c2c0 --- /dev/null +++ b/tools/kconfig/symbol.c @@ -0,0 +1,1378 @@ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include + +#include "lkc.h" + +struct symbol symbol_yes = { + .name = "y", + .curr = { "y", yes }, + .flags = SYMBOL_CONST|SYMBOL_VALID, +}, symbol_mod = { + .name = "m", + .curr = { "m", mod }, + .flags = SYMBOL_CONST|SYMBOL_VALID, +}, symbol_no = { + .name = "n", + .curr = { "n", no }, + .flags = SYMBOL_CONST|SYMBOL_VALID, +}, symbol_empty = { + .name = "", + .curr = { "", no }, + .flags = SYMBOL_VALID, +}; + +struct symbol *sym_defconfig_list; +struct symbol *modules_sym; +tristate modules_val; + +struct expr *sym_env_list; + +static void sym_add_default(struct symbol *sym, const char *def) +{ + struct property *prop = prop_alloc(P_DEFAULT, sym); + + prop->expr = expr_alloc_symbol(sym_lookup(def, SYMBOL_CONST)); +} + +void sym_init(void) +{ + struct symbol *sym; + struct utsname uts; + static bool inited = false; + + if (inited) + return; + inited = true; + + uname(&uts); + + sym = sym_lookup("UNAME_RELEASE", 0); + sym->type = S_STRING; + sym->flags |= SYMBOL_AUTO; + sym_add_default(sym, uts.release); +} + +enum symbol_type sym_get_type(struct symbol *sym) +{ + enum symbol_type type = sym->type; + + if (type == S_TRISTATE) { + if (sym_is_choice_value(sym) && sym->visible == yes) + type = S_BOOLEAN; + else if (modules_val == no) + type = S_BOOLEAN; + } + return type; +} + +const char *sym_type_name(enum symbol_type type) +{ + switch (type) { + case S_BOOLEAN: + return "boolean"; + case S_TRISTATE: + return "tristate"; + case S_INT: + return "integer"; + case S_HEX: + return "hex"; + case S_STRING: + return "string"; + case S_UNKNOWN: + return "unknown"; + case S_OTHER: + break; + } + return "???"; +} + +struct property *sym_get_choice_prop(struct symbol *sym) +{ + struct property *prop; + + for_all_choices(sym, prop) + return prop; + return NULL; +} + +struct property *sym_get_env_prop(struct symbol *sym) +{ + struct property *prop; + + for_all_properties(sym, prop, P_ENV) + return prop; + return NULL; +} + +static struct property *sym_get_default_prop(struct symbol *sym) +{ + struct property *prop; + + for_all_defaults(sym, prop) { + prop->visible.tri = expr_calc_value(prop->visible.expr); + if (prop->visible.tri != no) + return prop; + } + return NULL; +} + +static struct property *sym_get_range_prop(struct symbol *sym) +{ + struct property *prop; + + for_all_properties(sym, prop, P_RANGE) { + prop->visible.tri = expr_calc_value(prop->visible.expr); + if (prop->visible.tri != no) + return prop; + } + return NULL; +} + +static long long sym_get_range_val(struct symbol *sym, int base) +{ + sym_calc_value(sym); + switch (sym->type) { + case S_INT: + base = 10; + break; + case S_HEX: + base = 16; + break; + default: + break; + } + return strtoll(sym->curr.val, NULL, base); +} + +static void sym_validate_range(struct symbol *sym) +{ + struct property *prop; + int base; + long long val, val2; + char str[64]; + + switch (sym->type) { + case S_INT: + base = 10; + break; + case S_HEX: + base = 16; + break; + default: + return; + } + prop = sym_get_range_prop(sym); + if (!prop) + return; + val = strtoll(sym->curr.val, NULL, base); + val2 = sym_get_range_val(prop->expr->left.sym, base); + if (val >= val2) { + val2 = sym_get_range_val(prop->expr->right.sym, base); + if (val <= val2) + return; + } + if (sym->type == S_INT) + sprintf(str, "%lld", val2); + else + sprintf(str, "0x%llx", val2); + sym->curr.val = strdup(str); +} + +static void sym_set_changed(struct symbol *sym) +{ + struct property *prop; + + sym->flags |= SYMBOL_CHANGED; + for (prop = sym->prop; prop; prop = prop->next) { + if (prop->menu) + prop->menu->flags |= MENU_CHANGED; + } +} + +static void sym_set_all_changed(void) +{ + struct symbol *sym; + int i; + + for_all_symbols(i, sym) + sym_set_changed(sym); +} + +static void sym_calc_visibility(struct symbol *sym) +{ + struct property *prop; + tristate tri; + + /* any prompt visible? */ + tri = no; + for_all_prompts(sym, prop) { + prop->visible.tri = expr_calc_value(prop->visible.expr); + tri = EXPR_OR(tri, prop->visible.tri); + } + if (tri == mod && (sym->type != S_TRISTATE || modules_val == no)) + tri = yes; + if (sym->visible != tri) { + sym->visible = tri; + sym_set_changed(sym); + } + if (sym_is_choice_value(sym)) + return; + /* defaulting to "yes" if no explicit "depends on" are given */ + tri = yes; + if (sym->dir_dep.expr) + tri = expr_calc_value(sym->dir_dep.expr); + if (tri == mod) + tri = yes; + if (sym->dir_dep.tri != tri) { + sym->dir_dep.tri = tri; + sym_set_changed(sym); + } + tri = no; + if (sym->rev_dep.expr) + tri = expr_calc_value(sym->rev_dep.expr); + if (tri == mod && sym_get_type(sym) == S_BOOLEAN) + tri = yes; + if (sym->rev_dep.tri != tri) { + sym->rev_dep.tri = tri; + sym_set_changed(sym); + } +} + +/* + * Find the default symbol for a choice. + * First try the default values for the choice symbol + * Next locate the first visible choice value + * Return NULL if none was found + */ +struct symbol *sym_choice_default(struct symbol *sym) +{ + struct symbol *def_sym; + struct property *prop; + struct expr *e; + + /* any of the defaults visible? */ + for_all_defaults(sym, prop) { + prop->visible.tri = expr_calc_value(prop->visible.expr); + if (prop->visible.tri == no) + continue; + def_sym = prop_get_symbol(prop); + if (def_sym->visible != no) + return def_sym; + } + + /* just get the first visible value */ + prop = sym_get_choice_prop(sym); + expr_list_for_each_sym(prop->expr, e, def_sym) + if (def_sym->visible != no) + return def_sym; + + /* failed to locate any defaults */ + return NULL; +} + +static struct symbol *sym_calc_choice(struct symbol *sym) +{ + struct symbol *def_sym; + struct property *prop; + struct expr *e; + int flags; + + /* first calculate all choice values' visibilities */ + flags = sym->flags; + prop = sym_get_choice_prop(sym); + expr_list_for_each_sym(prop->expr, e, def_sym) { + sym_calc_visibility(def_sym); + if (def_sym->visible != no) + flags &= def_sym->flags; + } + + sym->flags &= flags | ~SYMBOL_DEF_USER; + + /* is the user choice visible? */ + def_sym = sym->def[S_DEF_USER].val; + if (def_sym && def_sym->visible != no) + return def_sym; + + def_sym = sym_choice_default(sym); + + if (def_sym == NULL) + /* no choice? reset tristate value */ + sym->curr.tri = no; + + return def_sym; +} + +void sym_calc_value(struct symbol *sym) +{ + struct symbol_value newval, oldval; + struct property *prop; + struct expr *e; + + if (!sym) + return; + + if (sym->flags & SYMBOL_VALID) + return; + + if (sym_is_choice_value(sym) && + sym->flags & SYMBOL_NEED_SET_CHOICE_VALUES) { + sym->flags &= ~SYMBOL_NEED_SET_CHOICE_VALUES; + prop = sym_get_choice_prop(sym); + sym_calc_value(prop_get_symbol(prop)); + } + + sym->flags |= SYMBOL_VALID; + + oldval = sym->curr; + + switch (sym->type) { + case S_INT: + case S_HEX: + case S_STRING: + newval = symbol_empty.curr; + break; + case S_BOOLEAN: + case S_TRISTATE: + newval = symbol_no.curr; + break; + default: + sym->curr.val = sym->name; + sym->curr.tri = no; + return; + } + if (!sym_is_choice_value(sym)) + sym->flags &= ~SYMBOL_WRITE; + + sym_calc_visibility(sym); + + /* set default if recursively called */ + sym->curr = newval; + + switch (sym_get_type(sym)) { + case S_BOOLEAN: + case S_TRISTATE: + if (sym_is_choice_value(sym) && sym->visible == yes) { + prop = sym_get_choice_prop(sym); + newval.tri = (prop_get_symbol(prop)->curr.val == sym) ? yes : no; + } else { + if (sym->visible != no) { + /* if the symbol is visible use the user value + * if available, otherwise try the default value + */ + sym->flags |= SYMBOL_WRITE; + if (sym_has_value(sym)) { + newval.tri = EXPR_AND(sym->def[S_DEF_USER].tri, + sym->visible); + goto calc_newval; + } + } + if (sym->rev_dep.tri != no) + sym->flags |= SYMBOL_WRITE; + if (!sym_is_choice(sym)) { + prop = sym_get_default_prop(sym); + if (prop) { + sym->flags |= SYMBOL_WRITE; + newval.tri = EXPR_AND(expr_calc_value(prop->expr), + prop->visible.tri); + } + } + calc_newval: + if (sym->dir_dep.tri == no && sym->rev_dep.tri != no) { + struct expr *e; + e = expr_simplify_unmet_dep(sym->rev_dep.expr, + sym->dir_dep.expr); + fprintf(stderr, "warning: ("); + expr_fprint(e, stderr); + fprintf(stderr, ") selects %s which has unmet direct dependencies (", + sym->name); + expr_fprint(sym->dir_dep.expr, stderr); + fprintf(stderr, ")\n"); + expr_free(e); + } + newval.tri = EXPR_OR(newval.tri, sym->rev_dep.tri); + } + if (newval.tri == mod && sym_get_type(sym) == S_BOOLEAN) + newval.tri = yes; + break; + case S_STRING: + case S_HEX: + case S_INT: + if (sym->visible != no) { + sym->flags |= SYMBOL_WRITE; + if (sym_has_value(sym)) { + newval.val = sym->def[S_DEF_USER].val; + break; + } + } + prop = sym_get_default_prop(sym); + if (prop) { + struct symbol *ds = prop_get_symbol(prop); + if (ds) { + sym->flags |= SYMBOL_WRITE; + sym_calc_value(ds); + newval.val = ds->curr.val; + } + } + break; + default: + ; + } + + sym->curr = newval; + if (sym_is_choice(sym) && newval.tri == yes) + sym->curr.val = sym_calc_choice(sym); + sym_validate_range(sym); + + if (memcmp(&oldval, &sym->curr, sizeof(oldval))) { + sym_set_changed(sym); + if (modules_sym == sym) { + sym_set_all_changed(); + modules_val = modules_sym->curr.tri; + } + } + + if (sym_is_choice(sym)) { + struct symbol *choice_sym; + + prop = sym_get_choice_prop(sym); + expr_list_for_each_sym(prop->expr, e, choice_sym) { + if ((sym->flags & SYMBOL_WRITE) && + choice_sym->visible != no) + choice_sym->flags |= SYMBOL_WRITE; + if (sym->flags & SYMBOL_CHANGED) + sym_set_changed(choice_sym); + } + } + + if (sym->flags & SYMBOL_AUTO) + sym->flags &= ~SYMBOL_WRITE; + + if (sym->flags & SYMBOL_NEED_SET_CHOICE_VALUES) + set_all_choice_values(sym); +} + +void sym_clear_all_valid(void) +{ + struct symbol *sym; + int i; + + for_all_symbols(i, sym) + sym->flags &= ~SYMBOL_VALID; + sym_add_change_count(1); + sym_calc_value(modules_sym); +} + +bool sym_tristate_within_range(struct symbol *sym, tristate val) +{ + int type = sym_get_type(sym); + + if (sym->visible == no) + return false; + + if (type != S_BOOLEAN && type != S_TRISTATE) + return false; + + if (type == S_BOOLEAN && val == mod) + return false; + if (sym->visible <= sym->rev_dep.tri) + return false; + if (sym_is_choice_value(sym) && sym->visible == yes) + return val == yes; + return val >= sym->rev_dep.tri && val <= sym->visible; +} + +bool sym_set_tristate_value(struct symbol *sym, tristate val) +{ + tristate oldval = sym_get_tristate_value(sym); + + if (oldval != val && !sym_tristate_within_range(sym, val)) + return false; + + if (!(sym->flags & SYMBOL_DEF_USER)) { + sym->flags |= SYMBOL_DEF_USER; + sym_set_changed(sym); + } + /* + * setting a choice value also resets the new flag of the choice + * symbol and all other choice values. + */ + if (sym_is_choice_value(sym) && val == yes) { + struct symbol *cs = prop_get_symbol(sym_get_choice_prop(sym)); + struct property *prop; + struct expr *e; + + cs->def[S_DEF_USER].val = sym; + cs->flags |= SYMBOL_DEF_USER; + prop = sym_get_choice_prop(cs); + for (e = prop->expr; e; e = e->left.expr) { + if (e->right.sym->visible != no) + e->right.sym->flags |= SYMBOL_DEF_USER; + } + } + + sym->def[S_DEF_USER].tri = val; + if (oldval != val) + sym_clear_all_valid(); + + return true; +} + +tristate sym_toggle_tristate_value(struct symbol *sym) +{ + tristate oldval, newval; + + oldval = newval = sym_get_tristate_value(sym); + do { + switch (newval) { + case no: + newval = mod; + break; + case mod: + newval = yes; + break; + case yes: + newval = no; + break; + } + if (sym_set_tristate_value(sym, newval)) + break; + } while (oldval != newval); + return newval; +} + +bool sym_string_valid(struct symbol *sym, const char *str) +{ + signed char ch; + + switch (sym->type) { + case S_STRING: + return true; + case S_INT: + ch = *str++; + if (ch == '-') + ch = *str++; + if (!isdigit(ch)) + return false; + if (ch == '0' && *str != 0) + return false; + while ((ch = *str++)) { + if (!isdigit(ch)) + return false; + } + return true; + case S_HEX: + if (str[0] == '0' && (str[1] == 'x' || str[1] == 'X')) + str += 2; + ch = *str++; + do { + if (!isxdigit(ch)) + return false; + } while ((ch = *str++)); + return true; + case S_BOOLEAN: + case S_TRISTATE: + switch (str[0]) { + case 'y': case 'Y': + case 'm': case 'M': + case 'n': case 'N': + return true; + } + return false; + default: + return false; + } +} + +bool sym_string_within_range(struct symbol *sym, const char *str) +{ + struct property *prop; + long long val; + + switch (sym->type) { + case S_STRING: + return sym_string_valid(sym, str); + case S_INT: + if (!sym_string_valid(sym, str)) + return false; + prop = sym_get_range_prop(sym); + if (!prop) + return true; + val = strtoll(str, NULL, 10); + return val >= sym_get_range_val(prop->expr->left.sym, 10) && + val <= sym_get_range_val(prop->expr->right.sym, 10); + case S_HEX: + if (!sym_string_valid(sym, str)) + return false; + prop = sym_get_range_prop(sym); + if (!prop) + return true; + val = strtoll(str, NULL, 16); + return val >= sym_get_range_val(prop->expr->left.sym, 16) && + val <= sym_get_range_val(prop->expr->right.sym, 16); + case S_BOOLEAN: + case S_TRISTATE: + switch (str[0]) { + case 'y': case 'Y': + return sym_tristate_within_range(sym, yes); + case 'm': case 'M': + return sym_tristate_within_range(sym, mod); + case 'n': case 'N': + return sym_tristate_within_range(sym, no); + } + return false; + default: + return false; + } +} + +bool sym_set_string_value(struct symbol *sym, const char *newval) +{ + const char *oldval; + char *val; + int size; + + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + switch (newval[0]) { + case 'y': case 'Y': + return sym_set_tristate_value(sym, yes); + case 'm': case 'M': + return sym_set_tristate_value(sym, mod); + case 'n': case 'N': + return sym_set_tristate_value(sym, no); + } + return false; + default: + ; + } + + if (!sym_string_within_range(sym, newval)) + return false; + + if (!(sym->flags & SYMBOL_DEF_USER)) { + sym->flags |= SYMBOL_DEF_USER; + sym_set_changed(sym); + } + + oldval = sym->def[S_DEF_USER].val; + size = strlen(newval) + 1; + if (sym->type == S_HEX && (newval[0] != '0' || (newval[1] != 'x' && newval[1] != 'X'))) { + size += 2; + sym->def[S_DEF_USER].val = val = xmalloc(size); + *val++ = '0'; + *val++ = 'x'; + } else if (!oldval || strcmp(oldval, newval)) + sym->def[S_DEF_USER].val = val = xmalloc(size); + else + return true; + + strcpy(val, newval); + free((void *)oldval); + sym_clear_all_valid(); + + return true; +} + +/* + * Find the default value associated to a symbol. + * For tristate symbol handle the modules=n case + * in which case "m" becomes "y". + * If the symbol does not have any default then fallback + * to the fixed default values. + */ +const char *sym_get_string_default(struct symbol *sym) +{ + struct property *prop; + struct symbol *ds; + const char *str; + tristate val; + + sym_calc_visibility(sym); + sym_calc_value(modules_sym); + val = symbol_no.curr.tri; + str = symbol_empty.curr.val; + + /* If symbol has a default value look it up */ + prop = sym_get_default_prop(sym); + if (prop != NULL) { + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + /* The visibility may limit the value from yes => mod */ + val = EXPR_AND(expr_calc_value(prop->expr), prop->visible.tri); + break; + default: + /* + * The following fails to handle the situation + * where a default value is further limited by + * the valid range. + */ + ds = prop_get_symbol(prop); + if (ds != NULL) { + sym_calc_value(ds); + str = (const char *)ds->curr.val; + } + } + } + + /* Handle select statements */ + val = EXPR_OR(val, sym->rev_dep.tri); + + /* transpose mod to yes if modules are not enabled */ + if (val == mod) + if (!sym_is_choice_value(sym) && modules_sym->curr.tri == no) + val = yes; + + /* transpose mod to yes if type is bool */ + if (sym->type == S_BOOLEAN && val == mod) + val = yes; + + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + switch (val) { + case no: return "n"; + case mod: return "m"; + case yes: return "y"; + } + case S_INT: + case S_HEX: + return str; + case S_STRING: + return str; + case S_OTHER: + case S_UNKNOWN: + break; + } + return ""; +} + +const char *sym_get_string_value(struct symbol *sym) +{ + tristate val; + + switch (sym->type) { + case S_BOOLEAN: + case S_TRISTATE: + val = sym_get_tristate_value(sym); + switch (val) { + case no: + return "n"; + case mod: + sym_calc_value(modules_sym); + return (modules_sym->curr.tri == no) ? "n" : "m"; + case yes: + return "y"; + } + break; + default: + ; + } + return (const char *)sym->curr.val; +} + +bool sym_is_changable(struct symbol *sym) +{ + return sym->visible > sym->rev_dep.tri; +} + +static unsigned strhash(const char *s) +{ + /* fnv32 hash */ + unsigned hash = 2166136261U; + for (; *s; s++) + hash = (hash ^ *s) * 0x01000193; + return hash; +} + +struct symbol *sym_lookup(const char *name, int flags) +{ + struct symbol *symbol; + char *new_name; + int hash; + + if (name) { + if (name[0] && !name[1]) { + switch (name[0]) { + case 'y': return &symbol_yes; + case 'm': return &symbol_mod; + case 'n': return &symbol_no; + } + } + hash = strhash(name) % SYMBOL_HASHSIZE; + + for (symbol = symbol_hash[hash]; symbol; symbol = symbol->next) { + if (symbol->name && + !strcmp(symbol->name, name) && + (flags ? symbol->flags & flags + : !(symbol->flags & (SYMBOL_CONST|SYMBOL_CHOICE)))) + return symbol; + } + new_name = strdup(name); + } else { + new_name = NULL; + hash = 0; + } + + symbol = xmalloc(sizeof(*symbol)); + memset(symbol, 0, sizeof(*symbol)); + symbol->name = new_name; + symbol->type = S_UNKNOWN; + symbol->flags |= flags; + + symbol->next = symbol_hash[hash]; + symbol_hash[hash] = symbol; + + return symbol; +} + +struct symbol *sym_find(const char *name) +{ + struct symbol *symbol = NULL; + int hash = 0; + + if (!name) + return NULL; + + if (name[0] && !name[1]) { + switch (name[0]) { + case 'y': return &symbol_yes; + case 'm': return &symbol_mod; + case 'n': return &symbol_no; + } + } + hash = strhash(name) % SYMBOL_HASHSIZE; + + for (symbol = symbol_hash[hash]; symbol; symbol = symbol->next) { + if (symbol->name && + !strcmp(symbol->name, name) && + !(symbol->flags & SYMBOL_CONST)) + break; + } + + return symbol; +} + +/* + * Expand symbol's names embedded in the string given in argument. Symbols' + * name to be expanded shall be prefixed by a '$'. Unknown symbol expands to + * the empty string. + */ +const char *sym_expand_string_value(const char *in) +{ + const char *src; + char *res; + size_t reslen; + + reslen = strlen(in) + 1; + res = xmalloc(reslen); + res[0] = '\0'; + + while ((src = strchr(in, '$'))) { + char *p, name[SYMBOL_MAXLENGTH]; + const char *symval = ""; + struct symbol *sym; + size_t newlen; + + strncat(res, in, src - in); + src++; + + p = name; + while (isalnum(*src) || *src == '_') + *p++ = *src++; + *p = '\0'; + + sym = sym_find(name); + if (sym != NULL) { + sym_calc_value(sym); + symval = sym_get_string_value(sym); + } + + newlen = strlen(res) + strlen(symval) + strlen(src) + 1; + if (newlen > reslen) { + reslen = newlen; + res = realloc(res, reslen); + } + + strcat(res, symval); + in = src; + } + strcat(res, in); + + return res; +} + +const char *sym_escape_string_value(const char *in) +{ + const char *p; + size_t reslen; + char *res; + size_t l; + + reslen = strlen(in) + strlen("\"\"") + 1; + + p = in; + for (;;) { + l = strcspn(p, "\"\\"); + p += l; + + if (p[0] == '\0') + break; + + reslen++; + p++; + } + + res = xmalloc(reslen); + res[0] = '\0'; + + strcat(res, "\""); + + p = in; + for (;;) { + l = strcspn(p, "\"\\"); + strncat(res, p, l); + p += l; + + if (p[0] == '\0') + break; + + strcat(res, "\\"); + strncat(res, p++, 1); + } + + strcat(res, "\""); + return res; +} + +struct sym_match { + struct symbol *sym; + off_t so, eo; +}; + +/* Compare matched symbols as thus: + * - first, symbols that match exactly + * - then, alphabetical sort + */ +static int sym_rel_comp(const void *sym1, const void *sym2) +{ + const struct sym_match *s1 = sym1; + const struct sym_match *s2 = sym2; + int exact1, exact2; + + /* Exact match: + * - if matched length on symbol s1 is the length of that symbol, + * then this symbol should come first; + * - if matched length on symbol s2 is the length of that symbol, + * then this symbol should come first. + * Note: since the search can be a regexp, both symbols may match + * exactly; if this is the case, we can't decide which comes first, + * and we fallback to sorting alphabetically. + */ + exact1 = (s1->eo - s1->so) == strlen(s1->sym->name); + exact2 = (s2->eo - s2->so) == strlen(s2->sym->name); + if (exact1 && !exact2) + return -1; + if (!exact1 && exact2) + return 1; + + /* As a fallback, sort symbols alphabetically */ + return strcmp(s1->sym->name, s2->sym->name); +} + +struct symbol **sym_re_search(const char *pattern) +{ + struct symbol *sym, **sym_arr = NULL; + struct sym_match *sym_match_arr = NULL; + int i, cnt, size; + regex_t re; + regmatch_t match[1]; + + cnt = size = 0; + /* Skip if empty */ + if (strlen(pattern) == 0) + return NULL; + if (regcomp(&re, pattern, REG_EXTENDED|REG_ICASE)) + return NULL; + + for_all_symbols(i, sym) { + if (sym->flags & SYMBOL_CONST || !sym->name) + continue; + if (regexec(&re, sym->name, 1, match, 0)) + continue; + if (cnt >= size) { + void *tmp; + size += 16; + tmp = realloc(sym_match_arr, size * sizeof(struct sym_match)); + if (!tmp) + goto sym_re_search_free; + sym_match_arr = tmp; + } + sym_calc_value(sym); + /* As regexec returned 0, we know we have a match, so + * we can use match[0].rm_[se]o without further checks + */ + sym_match_arr[cnt].so = match[0].rm_so; + sym_match_arr[cnt].eo = match[0].rm_eo; + sym_match_arr[cnt++].sym = sym; + } + if (sym_match_arr) { + qsort(sym_match_arr, cnt, sizeof(struct sym_match), sym_rel_comp); + sym_arr = malloc((cnt+1) * sizeof(struct symbol)); + if (!sym_arr) + goto sym_re_search_free; + for (i = 0; i < cnt; i++) + sym_arr[i] = sym_match_arr[i].sym; + sym_arr[cnt] = NULL; + } +sym_re_search_free: + /* sym_match_arr can be NULL if no match, but free(NULL) is OK */ + free(sym_match_arr); + regfree(&re); + + return sym_arr; +} + +/* + * When we check for recursive dependencies we use a stack to save + * current state so we can print out relevant info to user. + * The entries are located on the call stack so no need to free memory. + * Note insert() remove() must always match to properly clear the stack. + */ +static struct dep_stack { + struct dep_stack *prev, *next; + struct symbol *sym; + struct property *prop; + struct expr *expr; +} *check_top; + +static void dep_stack_insert(struct dep_stack *stack, struct symbol *sym) +{ + memset(stack, 0, sizeof(*stack)); + if (check_top) + check_top->next = stack; + stack->prev = check_top; + stack->sym = sym; + check_top = stack; +} + +static void dep_stack_remove(void) +{ + check_top = check_top->prev; + if (check_top) + check_top->next = NULL; +} + +/* + * Called when we have detected a recursive dependency. + * check_top point to the top of the stact so we use + * the ->prev pointer to locate the bottom of the stack. + */ +static void sym_check_print_recursive(struct symbol *last_sym) +{ + struct dep_stack *stack; + struct symbol *sym, *next_sym; + struct menu *menu = NULL; + struct property *prop; + struct dep_stack cv_stack; + + if (sym_is_choice_value(last_sym)) { + dep_stack_insert(&cv_stack, last_sym); + last_sym = prop_get_symbol(sym_get_choice_prop(last_sym)); + } + + for (stack = check_top; stack != NULL; stack = stack->prev) + if (stack->sym == last_sym) + break; + if (!stack) { + fprintf(stderr, "unexpected recursive dependency error\n"); + return; + } + + for (; stack; stack = stack->next) { + sym = stack->sym; + next_sym = stack->next ? stack->next->sym : last_sym; + prop = stack->prop; + if (prop == NULL) + prop = stack->sym->prop; + + /* for choice values find the menu entry (used below) */ + if (sym_is_choice(sym) || sym_is_choice_value(sym)) { + for (prop = sym->prop; prop; prop = prop->next) { + menu = prop->menu; + if (prop->menu) + break; + } + } + if (stack->sym == last_sym) + fprintf(stderr, "%s:%d:error: recursive dependency detected!\n", + prop->file->name, prop->lineno); + fprintf(stderr, "For a resolution refer to Documentation/kbuild/kconfig-language.txt\n"); + fprintf(stderr, "subsection \"Kconfig recursive dependency limitations\"\n"); + if (stack->expr) { + fprintf(stderr, "%s:%d:\tsymbol %s %s value contains %s\n", + prop->file->name, prop->lineno, + sym->name ? sym->name : "", + prop_get_type_name(prop->type), + next_sym->name ? next_sym->name : ""); + } else if (stack->prop) { + fprintf(stderr, "%s:%d:\tsymbol %s depends on %s\n", + prop->file->name, prop->lineno, + sym->name ? sym->name : "", + next_sym->name ? next_sym->name : ""); + } else if (sym_is_choice(sym)) { + fprintf(stderr, "%s:%d:\tchoice %s contains symbol %s\n", + menu->file->name, menu->lineno, + sym->name ? sym->name : "", + next_sym->name ? next_sym->name : ""); + } else if (sym_is_choice_value(sym)) { + fprintf(stderr, "%s:%d:\tsymbol %s is part of choice %s\n", + menu->file->name, menu->lineno, + sym->name ? sym->name : "", + next_sym->name ? next_sym->name : ""); + } else { + fprintf(stderr, "%s:%d:\tsymbol %s is selected by %s\n", + prop->file->name, prop->lineno, + sym->name ? sym->name : "", + next_sym->name ? next_sym->name : ""); + } + } + + if (check_top == &cv_stack) + dep_stack_remove(); +} + +static struct symbol *sym_check_expr_deps(struct expr *e) +{ + struct symbol *sym; + + if (!e) + return NULL; + switch (e->type) { + case E_OR: + case E_AND: + sym = sym_check_expr_deps(e->left.expr); + if (sym) + return sym; + return sym_check_expr_deps(e->right.expr); + case E_NOT: + return sym_check_expr_deps(e->left.expr); + case E_EQUAL: + case E_GEQ: + case E_GTH: + case E_LEQ: + case E_LTH: + case E_UNEQUAL: + sym = sym_check_deps(e->left.sym); + if (sym) + return sym; + return sym_check_deps(e->right.sym); + case E_SYMBOL: + return sym_check_deps(e->left.sym); + default: + break; + } + printf("Oops! How to check %d?\n", e->type); + return NULL; +} + +/* return NULL when dependencies are OK */ +static struct symbol *sym_check_sym_deps(struct symbol *sym) +{ + struct symbol *sym2; + struct property *prop; + struct dep_stack stack; + + dep_stack_insert(&stack, sym); + + sym2 = sym_check_expr_deps(sym->rev_dep.expr); + if (sym2) + goto out; + + for (prop = sym->prop; prop; prop = prop->next) { + if (prop->type == P_CHOICE || prop->type == P_SELECT) + continue; + stack.prop = prop; + sym2 = sym_check_expr_deps(prop->visible.expr); + if (sym2) + break; + if (prop->type != P_DEFAULT || sym_is_choice(sym)) + continue; + stack.expr = prop->expr; + sym2 = sym_check_expr_deps(prop->expr); + if (sym2) + break; + stack.expr = NULL; + } + +out: + dep_stack_remove(); + + return sym2; +} + +static struct symbol *sym_check_choice_deps(struct symbol *choice) +{ + struct symbol *sym, *sym2; + struct property *prop; + struct expr *e; + struct dep_stack stack; + + dep_stack_insert(&stack, choice); + + prop = sym_get_choice_prop(choice); + expr_list_for_each_sym(prop->expr, e, sym) + sym->flags |= (SYMBOL_CHECK | SYMBOL_CHECKED); + + choice->flags |= (SYMBOL_CHECK | SYMBOL_CHECKED); + sym2 = sym_check_sym_deps(choice); + choice->flags &= ~SYMBOL_CHECK; + if (sym2) + goto out; + + expr_list_for_each_sym(prop->expr, e, sym) { + sym2 = sym_check_sym_deps(sym); + if (sym2) + break; + } +out: + expr_list_for_each_sym(prop->expr, e, sym) + sym->flags &= ~SYMBOL_CHECK; + + if (sym2 && sym_is_choice_value(sym2) && + prop_get_symbol(sym_get_choice_prop(sym2)) == choice) + sym2 = choice; + + dep_stack_remove(); + + return sym2; +} + +struct symbol *sym_check_deps(struct symbol *sym) +{ + struct symbol *sym2; + struct property *prop; + + if (sym->flags & SYMBOL_CHECK) { + sym_check_print_recursive(sym); + return sym; + } + if (sym->flags & SYMBOL_CHECKED) + return NULL; + + if (sym_is_choice_value(sym)) { + struct dep_stack stack; + + /* for choice groups start the check with main choice symbol */ + dep_stack_insert(&stack, sym); + prop = sym_get_choice_prop(sym); + sym2 = sym_check_deps(prop_get_symbol(prop)); + dep_stack_remove(); + } else if (sym_is_choice(sym)) { + sym2 = sym_check_choice_deps(sym); + } else { + sym->flags |= (SYMBOL_CHECK | SYMBOL_CHECKED); + sym2 = sym_check_sym_deps(sym); + sym->flags &= ~SYMBOL_CHECK; + } + + if (sym2 && sym2 == sym) + sym2 = NULL; + + return sym2; +} + +struct property *prop_alloc(enum prop_type type, struct symbol *sym) +{ + struct property *prop; + struct property **propp; + + prop = xmalloc(sizeof(*prop)); + memset(prop, 0, sizeof(*prop)); + prop->type = type; + prop->sym = sym; + prop->file = current_file; + prop->lineno = zconf_lineno(); + + /* append property to the prop list of symbol */ + if (sym) { + for (propp = &sym->prop; *propp; propp = &(*propp)->next) + ; + *propp = prop; + } + + return prop; +} + +struct symbol *prop_get_symbol(struct property *prop) +{ + if (prop->expr && (prop->expr->type == E_SYMBOL || + prop->expr->type == E_LIST)) + return prop->expr->left.sym; + return NULL; +} + +const char *prop_get_type_name(enum prop_type type) +{ + switch (type) { + case P_PROMPT: + return "prompt"; + case P_ENV: + return "env"; + case P_COMMENT: + return "comment"; + case P_MENU: + return "menu"; + case P_DEFAULT: + return "default"; + case P_CHOICE: + return "choice"; + case P_SELECT: + return "select"; + case P_RANGE: + return "range"; + case P_SYMBOL: + return "symbol"; + case P_UNKNOWN: + break; + } + return "unknown"; +} + +static void prop_add_env(const char *env) +{ + struct symbol *sym, *sym2; + struct property *prop; + char *p; + + sym = current_entry->sym; + sym->flags |= SYMBOL_AUTO; + for_all_properties(sym, prop, P_ENV) { + sym2 = prop_get_symbol(prop); + if (strcmp(sym2->name, env)) + menu_warn(current_entry, "redefining environment symbol from %s", + sym2->name); + return; + } + + prop = prop_alloc(P_ENV, sym); + prop->expr = expr_alloc_symbol(sym_lookup(env, SYMBOL_CONST)); + + sym_env_list = expr_alloc_one(E_LIST, sym_env_list); + sym_env_list->right.sym = sym; + + p = getenv(env); + if (p) + sym_add_default(sym, p); + else + menu_warn(current_entry, "environment variable %s undefined", env); +} diff --git a/tools/kconfig/util.c b/tools/kconfig/util.c new file mode 100644 index 000000000..0e7604247 --- /dev/null +++ b/tools/kconfig/util.c @@ -0,0 +1,147 @@ +/* + * Copyright (C) 2002-2005 Roman Zippel + * Copyright (C) 2002-2005 Sam Ravnborg + * + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include "lkc.h" + +/* file already present in list? If not add it */ +struct file *file_lookup(const char *name) +{ + struct file *file; + const char *file_name = sym_expand_string_value(name); + + for (file = file_list; file; file = file->next) { + if (!strcmp(name, file->name)) { + free((void *)file_name); + return file; + } + } + + file = xmalloc(sizeof(*file)); + memset(file, 0, sizeof(*file)); + file->name = file_name; + file->next = file_list; + file_list = file; + return file; +} + +/* write a dependency file as used by kbuild to track dependencies */ +int file_write_dep(const char *name) +{ + struct symbol *sym, *env_sym; + struct expr *e; + struct file *file; + FILE *out; + + if (!name) + name = ".kconfig.d"; + out = fopen("..config.tmp", "w"); + if (!out) + return 1; + fprintf(out, "deps_config := \\\n"); + for (file = file_list; file; file = file->next) { + if (file->next) + fprintf(out, "\t%s \\\n", file->name); + else + fprintf(out, "\t%s\n", file->name); + } + fprintf(out, "\n%s: \\\n" + "\t$(deps_config)\n\n", conf_get_autoconfig_name()); + + expr_list_for_each_sym(sym_env_list, e, sym) { + struct property *prop; + const char *value; + + prop = sym_get_env_prop(sym); + env_sym = prop_get_symbol(prop); + if (!env_sym) + continue; + value = getenv(env_sym->name); + if (!value) + value = ""; + fprintf(out, "ifneq \"$(%s)\" \"%s\"\n", env_sym->name, value); + fprintf(out, "%s: FORCE\n", conf_get_autoconfig_name()); + fprintf(out, "endif\n"); + } + + fprintf(out, "\n$(deps_config): ;\n"); + fclose(out); + rename("..config.tmp", name); + return 0; +} + + +/* Allocate initial growable string */ +struct gstr str_new(void) +{ + struct gstr gs; + gs.s = xmalloc(sizeof(char) * 64); + gs.len = 64; + gs.max_width = 0; + strcpy(gs.s, "\0"); + return gs; +} + +/* Free storage for growable string */ +void str_free(struct gstr *gs) +{ + if (gs->s) + free(gs->s); + gs->s = NULL; + gs->len = 0; +} + +/* Append to growable string */ +void str_append(struct gstr *gs, const char *s) +{ + size_t l; + if (s) { + l = strlen(gs->s) + strlen(s) + 1; + if (l > gs->len) { + gs->s = realloc(gs->s, l); + gs->len = l; + } + strcat(gs->s, s); + } +} + +/* Append printf formatted string to growable string */ +void str_printf(struct gstr *gs, const char *fmt, ...) +{ + va_list ap; + char s[10000]; /* big enough... */ + va_start(ap, fmt); + vsnprintf(s, sizeof(s), fmt, ap); + str_append(gs, s); + va_end(ap); +} + +/* Retrieve value of growable string */ +const char *str_get(struct gstr *gs) +{ + return gs->s; +} + +void *xmalloc(size_t size) +{ + void *p = malloc(size); + if (p) + return p; + fprintf(stderr, "Out of memory.\n"); + exit(1); +} + +void *xcalloc(size_t nmemb, size_t size) +{ + void *p = calloc(nmemb, size); + if (p) + return p; + fprintf(stderr, "Out of memory.\n"); + exit(1); +} diff --git a/tools/kconfig/zconf.gperf b/tools/kconfig/zconf.gperf new file mode 100644 index 000000000..ac498f01b --- /dev/null +++ b/tools/kconfig/zconf.gperf @@ -0,0 +1,49 @@ +%language=ANSI-C +%define hash-function-name kconf_id_hash +%define lookup-function-name kconf_id_lookup +%define string-pool-name kconf_id_strings +%compare-strncmp +%enum +%pic +%struct-type + +struct kconf_id; + +static const struct kconf_id *kconf_id_lookup(register const char *str, register unsigned int len); + +%% +mainmenu, T_MAINMENU, TF_COMMAND +menu, T_MENU, TF_COMMAND +endmenu, T_ENDMENU, TF_COMMAND +source, T_SOURCE, TF_COMMAND +choice, T_CHOICE, TF_COMMAND +endchoice, T_ENDCHOICE, TF_COMMAND +comment, T_COMMENT, TF_COMMAND +config, T_CONFIG, TF_COMMAND +menuconfig, T_MENUCONFIG, TF_COMMAND +help, T_HELP, TF_COMMAND +---help---, T_HELP, TF_COMMAND +if, T_IF, TF_COMMAND|TF_PARAM +endif, T_ENDIF, TF_COMMAND +depends, T_DEPENDS, TF_COMMAND +optional, T_OPTIONAL, TF_COMMAND +default, T_DEFAULT, TF_COMMAND, S_UNKNOWN +prompt, T_PROMPT, TF_COMMAND +tristate, T_TYPE, TF_COMMAND, S_TRISTATE +def_tristate, T_DEFAULT, TF_COMMAND, S_TRISTATE +bool, T_TYPE, TF_COMMAND, S_BOOLEAN +boolean, T_TYPE, TF_COMMAND, S_BOOLEAN +def_bool, T_DEFAULT, TF_COMMAND, S_BOOLEAN +int, T_TYPE, TF_COMMAND, S_INT +hex, T_TYPE, TF_COMMAND, S_HEX +string, T_TYPE, TF_COMMAND, S_STRING +select, T_SELECT, TF_COMMAND +range, T_RANGE, TF_COMMAND +visible, T_VISIBLE, TF_COMMAND +option, T_OPTION, TF_COMMAND +on, T_ON, TF_PARAM +modules, T_OPT_MODULES, TF_OPTION +defconfig_list, T_OPT_DEFCONFIG_LIST,TF_OPTION +env, T_OPT_ENV, TF_OPTION +allnoconfig_y, T_OPT_ALLNOCONFIG_Y,TF_OPTION +%% diff --git a/tools/kconfig/zconf.l b/tools/kconfig/zconf.l new file mode 100644 index 000000000..8c787b509 --- /dev/null +++ b/tools/kconfig/zconf.l @@ -0,0 +1,390 @@ +%option nostdinit noyywrap never-interactive full ecs +%option 8bit nodefault perf-report perf-report +%option noinput +%x COMMAND HELP STRING PARAM +%{ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include +#include + +#include "lkc.h" + +#define START_STRSIZE 16 + +static struct { + struct file *file; + int lineno; +} current_pos; + +static char *text; +static int text_size, text_asize; + +struct buffer { + struct buffer *parent; + YY_BUFFER_STATE state; +}; + +struct buffer *current_buf; + +static int last_ts, first_ts; + +static void zconf_endhelp(void); +static void zconf_endfile(void); + +static void new_string(void) +{ + text = xmalloc(START_STRSIZE); + text_asize = START_STRSIZE; + text_size = 0; + *text = 0; +} + +static void append_string(const char *str, int size) +{ + int new_size = text_size + size + 1; + if (new_size > text_asize) { + new_size += START_STRSIZE - 1; + new_size &= -START_STRSIZE; + text = realloc(text, new_size); + text_asize = new_size; + } + memcpy(text + text_size, str, size); + text_size += size; + text[text_size] = 0; +} + +static void alloc_string(const char *str, int size) +{ + text = xmalloc(size + 1); + memcpy(text, str, size); + text[size] = 0; +} + +static void warn_ignored_character(char chr) +{ + fprintf(stderr, + "%s:%d:warning: ignoring unsupported character '%c'\n", + zconf_curname(), zconf_lineno(), chr); +} +%} + +n [A-Za-z0-9_-] + +%% + int str = 0; + int ts, i; + +[ \t]*#.*\n | +[ \t]*\n { + current_file->lineno++; + return T_EOL; +} +[ \t]*#.* + + +[ \t]+ { + BEGIN(COMMAND); +} + +. { + unput(yytext[0]); + BEGIN(COMMAND); +} + + +{ + {n}+ { + const struct kconf_id *id = kconf_id_lookup(yytext, yyleng); + BEGIN(PARAM); + current_pos.file = current_file; + current_pos.lineno = current_file->lineno; + if (id && id->flags & TF_COMMAND) { + zconflval.id = id; + return id->token; + } + alloc_string(yytext, yyleng); + zconflval.string = text; + return T_WORD; + } + . warn_ignored_character(*yytext); + \n { + BEGIN(INITIAL); + current_file->lineno++; + return T_EOL; + } +} + +{ + "&&" return T_AND; + "||" return T_OR; + "(" return T_OPEN_PAREN; + ")" return T_CLOSE_PAREN; + "!" return T_NOT; + "=" return T_EQUAL; + "!=" return T_UNEQUAL; + "<=" return T_LESS_EQUAL; + ">=" return T_GREATER_EQUAL; + "<" return T_LESS; + ">" return T_GREATER; + \"|\' { + str = yytext[0]; + new_string(); + BEGIN(STRING); + } + \n BEGIN(INITIAL); current_file->lineno++; return T_EOL; + ({n}|[/.])+ { + const struct kconf_id *id = kconf_id_lookup(yytext, yyleng); + if (id && id->flags & TF_PARAM) { + zconflval.id = id; + return id->token; + } + alloc_string(yytext, yyleng); + zconflval.string = text; + return T_WORD; + } + #.* /* comment */ + \\\n current_file->lineno++; + [[:blank:]]+ + . warn_ignored_character(*yytext); + <> { + BEGIN(INITIAL); + } +} + +{ + [^'"\\\n]+/\n { + append_string(yytext, yyleng); + zconflval.string = text; + return T_WORD_QUOTE; + } + [^'"\\\n]+ { + append_string(yytext, yyleng); + } + \\.?/\n { + append_string(yytext + 1, yyleng - 1); + zconflval.string = text; + return T_WORD_QUOTE; + } + \\.? { + append_string(yytext + 1, yyleng - 1); + } + \'|\" { + if (str == yytext[0]) { + BEGIN(PARAM); + zconflval.string = text; + return T_WORD_QUOTE; + } else + append_string(yytext, 1); + } + \n { + printf("%s:%d:warning: multi-line strings not supported\n", zconf_curname(), zconf_lineno()); + current_file->lineno++; + BEGIN(INITIAL); + return T_EOL; + } + <> { + BEGIN(INITIAL); + } +} + +{ + [ \t]+ { + ts = 0; + for (i = 0; i < yyleng; i++) { + if (yytext[i] == '\t') + ts = (ts & ~7) + 8; + else + ts++; + } + last_ts = ts; + if (first_ts) { + if (ts < first_ts) { + zconf_endhelp(); + return T_HELPTEXT; + } + ts -= first_ts; + while (ts > 8) { + append_string(" ", 8); + ts -= 8; + } + append_string(" ", ts); + } + } + [ \t]*\n/[^ \t\n] { + current_file->lineno++; + zconf_endhelp(); + return T_HELPTEXT; + } + [ \t]*\n { + current_file->lineno++; + append_string("\n", 1); + } + [^ \t\n].* { + while (yyleng) { + if ((yytext[yyleng-1] != ' ') && (yytext[yyleng-1] != '\t')) + break; + yyleng--; + } + append_string(yytext, yyleng); + if (!first_ts) + first_ts = last_ts; + } + <> { + zconf_endhelp(); + return T_HELPTEXT; + } +} + +<> { + if (current_file) { + zconf_endfile(); + return T_EOL; + } + fclose(yyin); + yyterminate(); +} + +%% +void zconf_starthelp(void) +{ + new_string(); + last_ts = first_ts = 0; + BEGIN(HELP); +} + +static void zconf_endhelp(void) +{ + zconflval.string = text; + BEGIN(INITIAL); +} + + +/* + * Try to open specified file with following names: + * ./name + * $(srctree)/name + * The latter is used when srctree is separate from objtree + * when compiling the kernel. + * Return NULL if file is not found. + */ +FILE *zconf_fopen(const char *name) +{ + char *env, fullname[PATH_MAX+1]; + FILE *f; + + f = fopen(name, "r"); + if (!f && name != NULL && name[0] != '/') { + env = getenv(SRCTREE); + if (env) { + sprintf(fullname, "%s/%s", env, name); + f = fopen(fullname, "r"); + } + } + return f; +} + +void zconf_initscan(const char *name) +{ + yyin = zconf_fopen(name); + if (!yyin) { + printf("can't find file %s\n", name); + exit(1); + } + + current_buf = xmalloc(sizeof(*current_buf)); + memset(current_buf, 0, sizeof(*current_buf)); + + current_file = file_lookup(name); + current_file->lineno = 1; +} + +void zconf_nextfile(const char *name) +{ + struct file *iter; + struct file *file = file_lookup(name); + struct buffer *buf = xmalloc(sizeof(*buf)); + memset(buf, 0, sizeof(*buf)); + + current_buf->state = YY_CURRENT_BUFFER; + yyin = zconf_fopen(file->name); + if (!yyin) { + printf("%s:%d: can't open file \"%s\"\n", + zconf_curname(), zconf_lineno(), file->name); + exit(1); + } + yy_switch_to_buffer(yy_create_buffer(yyin, YY_BUF_SIZE)); + buf->parent = current_buf; + current_buf = buf; + + for (iter = current_file->parent; iter; iter = iter->parent ) { + if (!strcmp(current_file->name,iter->name) ) { + printf("%s:%d: recursive inclusion detected. " + "Inclusion path:\n current file : '%s'\n", + zconf_curname(), zconf_lineno(), + zconf_curname()); + iter = current_file->parent; + while (iter && \ + strcmp(iter->name,current_file->name)) { + printf(" included from: '%s:%d'\n", + iter->name, iter->lineno-1); + iter = iter->parent; + } + if (iter) + printf(" included from: '%s:%d'\n", + iter->name, iter->lineno+1); + exit(1); + } + } + file->lineno = 1; + file->parent = current_file; + current_file = file; +} + +void zconf_nextfiles(const char *wildcard) +{ + wordexp_t p; + char **w; + int i; + + wordexp(wildcard, &p, 0); + w = p.we_wordv; + + for (i = p.we_wordc - 1; i >= 0; i--) + zconf_nextfile(w[i]); + + wordfree(&p); +} + +static void zconf_endfile(void) +{ + struct buffer *parent; + + current_file = current_file->parent; + + parent = current_buf->parent; + if (parent) { + fclose(yyin); + yy_delete_buffer(YY_CURRENT_BUFFER); + yy_switch_to_buffer(parent->state); + } + free(current_buf); + current_buf = parent; +} + +int zconf_lineno(void) +{ + return current_pos.lineno; +} + +const char *zconf_curname(void) +{ + return current_pos.file ? current_pos.file->name : ""; +} diff --git a/tools/kconfig/zconf.y b/tools/kconfig/zconf.y new file mode 100644 index 000000000..77c713313 --- /dev/null +++ b/tools/kconfig/zconf.y @@ -0,0 +1,745 @@ +%{ +/* + * Copyright (C) 2002 Roman Zippel + * Released under the terms of the GNU GPL v2.0. + */ + +#include +#include +#include +#include +#include +#include + +#include "lkc.h" + +#define printd(mask, fmt...) if (cdebug & (mask)) printf(fmt) + +#define PRINTD 0x0001 +#define DEBUG_PARSE 0x0002 + +int cdebug = PRINTD; + +extern int zconflex(void); +static void zconfprint(const char *err, ...); +static void zconf_error(const char *err, ...); +static void zconferror(const char *err); +static bool zconf_endtoken(const struct kconf_id *id, int starttoken, int endtoken); + +struct symbol *symbol_hash[SYMBOL_HASHSIZE]; + +static struct menu *current_menu, *current_entry; + +%} +%expect 30 + +%union +{ + char *string; + struct file *file; + struct symbol *symbol; + struct expr *expr; + struct menu *menu; + const struct kconf_id *id; +} + +%token T_MAINMENU +%token T_MENU +%token T_ENDMENU +%token T_SOURCE +%token T_CHOICE +%token T_ENDCHOICE +%token T_COMMENT +%token T_CONFIG +%token T_MENUCONFIG +%token T_HELP +%token T_HELPTEXT +%token T_IF +%token T_ENDIF +%token T_DEPENDS +%token T_OPTIONAL +%token T_PROMPT +%token T_TYPE +%token T_DEFAULT +%token T_SELECT +%token T_RANGE +%token T_VISIBLE +%token T_OPTION +%token T_ON +%token T_WORD +%token T_WORD_QUOTE +%token T_UNEQUAL +%token T_LESS +%token T_LESS_EQUAL +%token T_GREATER +%token T_GREATER_EQUAL +%token T_CLOSE_PAREN +%token T_OPEN_PAREN +%token T_EOL + +%left T_OR +%left T_AND +%left T_EQUAL T_UNEQUAL +%left T_LESS T_LESS_EQUAL T_GREATER T_GREATER_EQUAL +%nonassoc T_NOT + +%type prompt +%type symbol +%type expr +%type if_expr +%type end +%type option_name +%type if_entry menu_entry choice_entry +%type symbol_option_arg word_opt + +%destructor { + fprintf(stderr, "%s:%d: missing end statement for this entry\n", + $$->file->name, $$->lineno); + if (current_menu == $$) + menu_end_menu(); +} if_entry menu_entry choice_entry + +%{ +/* Include zconf.hash.c here so it can see the token constants. */ +#include "zconf.hash.c" +%} + +%% +input: nl start | start; + +start: mainmenu_stmt stmt_list | stmt_list; + +stmt_list: + /* empty */ + | stmt_list common_stmt + | stmt_list choice_stmt + | stmt_list menu_stmt + | stmt_list end { zconf_error("unexpected end statement"); } + | stmt_list T_WORD error T_EOL { zconf_error("unknown statement \"%s\"", $2); } + | stmt_list option_name error T_EOL +{ + zconf_error("unexpected option \"%s\"", kconf_id_strings + $2->name); +} + | stmt_list error T_EOL { zconf_error("invalid statement"); } +; + +option_name: + T_DEPENDS | T_PROMPT | T_TYPE | T_SELECT | T_OPTIONAL | T_RANGE | T_DEFAULT | T_VISIBLE +; + +common_stmt: + T_EOL + | if_stmt + | comment_stmt + | config_stmt + | menuconfig_stmt + | source_stmt +; + +option_error: + T_WORD error T_EOL { zconf_error("unknown option \"%s\"", $1); } + | error T_EOL { zconf_error("invalid option"); } +; + + +/* config/menuconfig entry */ + +config_entry_start: T_CONFIG T_WORD T_EOL +{ + struct symbol *sym = sym_lookup($2, 0); + sym->flags |= SYMBOL_OPTIONAL; + menu_add_entry(sym); + printd(DEBUG_PARSE, "%s:%d:config %s\n", zconf_curname(), zconf_lineno(), $2); +}; + +config_stmt: config_entry_start config_option_list +{ + menu_end_entry(); + printd(DEBUG_PARSE, "%s:%d:endconfig\n", zconf_curname(), zconf_lineno()); +}; + +menuconfig_entry_start: T_MENUCONFIG T_WORD T_EOL +{ + struct symbol *sym = sym_lookup($2, 0); + sym->flags |= SYMBOL_OPTIONAL; + menu_add_entry(sym); + printd(DEBUG_PARSE, "%s:%d:menuconfig %s\n", zconf_curname(), zconf_lineno(), $2); +}; + +menuconfig_stmt: menuconfig_entry_start config_option_list +{ + if (current_entry->prompt) + current_entry->prompt->type = P_MENU; + else + zconfprint("warning: menuconfig statement without prompt"); + menu_end_entry(); + printd(DEBUG_PARSE, "%s:%d:endconfig\n", zconf_curname(), zconf_lineno()); +}; + +config_option_list: + /* empty */ + | config_option_list config_option + | config_option_list symbol_option + | config_option_list depends + | config_option_list help + | config_option_list option_error + | config_option_list T_EOL +; + +config_option: T_TYPE prompt_stmt_opt T_EOL +{ + menu_set_type($1->stype); + printd(DEBUG_PARSE, "%s:%d:type(%u)\n", + zconf_curname(), zconf_lineno(), + $1->stype); +}; + +config_option: T_PROMPT prompt if_expr T_EOL +{ + menu_add_prompt(P_PROMPT, $2, $3); + printd(DEBUG_PARSE, "%s:%d:prompt\n", zconf_curname(), zconf_lineno()); +}; + +config_option: T_DEFAULT expr if_expr T_EOL +{ + menu_add_expr(P_DEFAULT, $2, $3); + if ($1->stype != S_UNKNOWN) + menu_set_type($1->stype); + printd(DEBUG_PARSE, "%s:%d:default(%u)\n", + zconf_curname(), zconf_lineno(), + $1->stype); +}; + +config_option: T_SELECT T_WORD if_expr T_EOL +{ + menu_add_symbol(P_SELECT, sym_lookup($2, 0), $3); + printd(DEBUG_PARSE, "%s:%d:select\n", zconf_curname(), zconf_lineno()); +}; + +config_option: T_RANGE symbol symbol if_expr T_EOL +{ + menu_add_expr(P_RANGE, expr_alloc_comp(E_RANGE,$2, $3), $4); + printd(DEBUG_PARSE, "%s:%d:range\n", zconf_curname(), zconf_lineno()); +}; + +symbol_option: T_OPTION symbol_option_list T_EOL +; + +symbol_option_list: + /* empty */ + | symbol_option_list T_WORD symbol_option_arg +{ + const struct kconf_id *id = kconf_id_lookup($2, strlen($2)); + if (id && id->flags & TF_OPTION) + menu_add_option(id->token, $3); + else + zconfprint("warning: ignoring unknown option %s", $2); + free($2); +}; + +symbol_option_arg: + /* empty */ { $$ = NULL; } + | T_EQUAL prompt { $$ = $2; } +; + +/* choice entry */ + +choice: T_CHOICE word_opt T_EOL +{ + struct symbol *sym = sym_lookup($2, SYMBOL_CHOICE); + sym->flags |= SYMBOL_AUTO; + menu_add_entry(sym); + menu_add_expr(P_CHOICE, NULL, NULL); + printd(DEBUG_PARSE, "%s:%d:choice\n", zconf_curname(), zconf_lineno()); +}; + +choice_entry: choice choice_option_list +{ + $$ = menu_add_menu(); +}; + +choice_end: end +{ + if (zconf_endtoken($1, T_CHOICE, T_ENDCHOICE)) { + menu_end_menu(); + printd(DEBUG_PARSE, "%s:%d:endchoice\n", zconf_curname(), zconf_lineno()); + } +}; + +choice_stmt: choice_entry choice_block choice_end +; + +choice_option_list: + /* empty */ + | choice_option_list choice_option + | choice_option_list depends + | choice_option_list help + | choice_option_list T_EOL + | choice_option_list option_error +; + +choice_option: T_PROMPT prompt if_expr T_EOL +{ + menu_add_prompt(P_PROMPT, $2, $3); + printd(DEBUG_PARSE, "%s:%d:prompt\n", zconf_curname(), zconf_lineno()); +}; + +choice_option: T_TYPE prompt_stmt_opt T_EOL +{ + if ($1->stype == S_BOOLEAN || $1->stype == S_TRISTATE) { + menu_set_type($1->stype); + printd(DEBUG_PARSE, "%s:%d:type(%u)\n", + zconf_curname(), zconf_lineno(), + $1->stype); + } else + YYERROR; +}; + +choice_option: T_OPTIONAL T_EOL +{ + current_entry->sym->flags |= SYMBOL_OPTIONAL; + printd(DEBUG_PARSE, "%s:%d:optional\n", zconf_curname(), zconf_lineno()); +}; + +choice_option: T_DEFAULT T_WORD if_expr T_EOL +{ + if ($1->stype == S_UNKNOWN) { + menu_add_symbol(P_DEFAULT, sym_lookup($2, 0), $3); + printd(DEBUG_PARSE, "%s:%d:default\n", + zconf_curname(), zconf_lineno()); + } else + YYERROR; +}; + +choice_block: + /* empty */ + | choice_block common_stmt +; + +/* if entry */ + +if_entry: T_IF expr nl +{ + printd(DEBUG_PARSE, "%s:%d:if\n", zconf_curname(), zconf_lineno()); + menu_add_entry(NULL); + menu_add_dep($2); + $$ = menu_add_menu(); +}; + +if_end: end +{ + if (zconf_endtoken($1, T_IF, T_ENDIF)) { + menu_end_menu(); + printd(DEBUG_PARSE, "%s:%d:endif\n", zconf_curname(), zconf_lineno()); + } +}; + +if_stmt: if_entry if_block if_end +; + +if_block: + /* empty */ + | if_block common_stmt + | if_block menu_stmt + | if_block choice_stmt +; + +/* mainmenu entry */ + +mainmenu_stmt: T_MAINMENU prompt nl +{ + menu_add_prompt(P_MENU, $2, NULL); +}; + +/* menu entry */ + +menu: T_MENU prompt T_EOL +{ + menu_add_entry(NULL); + menu_add_prompt(P_MENU, $2, NULL); + printd(DEBUG_PARSE, "%s:%d:menu\n", zconf_curname(), zconf_lineno()); +}; + +menu_entry: menu visibility_list depends_list +{ + $$ = menu_add_menu(); +}; + +menu_end: end +{ + if (zconf_endtoken($1, T_MENU, T_ENDMENU)) { + menu_end_menu(); + printd(DEBUG_PARSE, "%s:%d:endmenu\n", zconf_curname(), zconf_lineno()); + } +}; + +menu_stmt: menu_entry menu_block menu_end +; + +menu_block: + /* empty */ + | menu_block common_stmt + | menu_block menu_stmt + | menu_block choice_stmt +; + +source_stmt: T_SOURCE prompt T_EOL +{ + printd(DEBUG_PARSE, "%s:%d:source %s\n", zconf_curname(), zconf_lineno(), $2); + zconf_nextfiles($2); +}; + +/* comment entry */ + +comment: T_COMMENT prompt T_EOL +{ + menu_add_entry(NULL); + menu_add_prompt(P_COMMENT, $2, NULL); + printd(DEBUG_PARSE, "%s:%d:comment\n", zconf_curname(), zconf_lineno()); +}; + +comment_stmt: comment depends_list +{ + menu_end_entry(); +}; + +/* help option */ + +help_start: T_HELP T_EOL +{ + printd(DEBUG_PARSE, "%s:%d:help\n", zconf_curname(), zconf_lineno()); + zconf_starthelp(); +}; + +help: help_start T_HELPTEXT +{ + current_entry->help = $2; +}; + +/* depends option */ + +depends_list: + /* empty */ + | depends_list depends + | depends_list T_EOL + | depends_list option_error +; + +depends: T_DEPENDS T_ON expr T_EOL +{ + menu_add_dep($3); + printd(DEBUG_PARSE, "%s:%d:depends on\n", zconf_curname(), zconf_lineno()); +}; + +/* visibility option */ + +visibility_list: + /* empty */ + | visibility_list visible + | visibility_list T_EOL +; + +visible: T_VISIBLE if_expr +{ + menu_add_visibility($2); +}; + +/* prompt statement */ + +prompt_stmt_opt: + /* empty */ + | prompt if_expr +{ + menu_add_prompt(P_PROMPT, $1, $2); +}; + +prompt: T_WORD + | T_WORD_QUOTE +; + +end: T_ENDMENU T_EOL { $$ = $1; } + | T_ENDCHOICE T_EOL { $$ = $1; } + | T_ENDIF T_EOL { $$ = $1; } +; + +nl: + T_EOL + | nl T_EOL +; + +if_expr: /* empty */ { $$ = NULL; } + | T_IF expr { $$ = $2; } +; + +expr: symbol { $$ = expr_alloc_symbol($1); } + | symbol T_LESS symbol { $$ = expr_alloc_comp(E_LTH, $1, $3); } + | symbol T_LESS_EQUAL symbol { $$ = expr_alloc_comp(E_LEQ, $1, $3); } + | symbol T_GREATER symbol { $$ = expr_alloc_comp(E_GTH, $1, $3); } + | symbol T_GREATER_EQUAL symbol { $$ = expr_alloc_comp(E_GEQ, $1, $3); } + | symbol T_EQUAL symbol { $$ = expr_alloc_comp(E_EQUAL, $1, $3); } + | symbol T_UNEQUAL symbol { $$ = expr_alloc_comp(E_UNEQUAL, $1, $3); } + | T_OPEN_PAREN expr T_CLOSE_PAREN { $$ = $2; } + | T_NOT expr { $$ = expr_alloc_one(E_NOT, $2); } + | expr T_OR expr { $$ = expr_alloc_two(E_OR, $1, $3); } + | expr T_AND expr { $$ = expr_alloc_two(E_AND, $1, $3); } +; + +symbol: T_WORD { $$ = sym_lookup($1, 0); free($1); } + | T_WORD_QUOTE { $$ = sym_lookup($1, SYMBOL_CONST); free($1); } +; + +word_opt: /* empty */ { $$ = NULL; } + | T_WORD + +%% + +void conf_parse(const char *name) +{ + struct symbol *sym; + int i; + + zconf_initscan(name); + + sym_init(); + _menu_init(); + rootmenu.prompt = menu_add_prompt(P_MENU, "Linux Kernel Configuration", NULL); + + if (getenv("ZCONF_DEBUG")) + zconfdebug = 1; + zconfparse(); + if (zconfnerrs) + exit(1); + if (!modules_sym) + modules_sym = sym_find( "n" ); + + rootmenu.prompt->text = _(rootmenu.prompt->text); + rootmenu.prompt->text = sym_expand_string_value(rootmenu.prompt->text); + + menu_finalize(&rootmenu); + for_all_symbols(i, sym) { + if (sym_check_deps(sym)) + zconfnerrs++; + } + if (zconfnerrs) + exit(1); + sym_set_change_count(1); +} + +static const char *zconf_tokenname(int token) +{ + switch (token) { + case T_MENU: return "menu"; + case T_ENDMENU: return "endmenu"; + case T_CHOICE: return "choice"; + case T_ENDCHOICE: return "endchoice"; + case T_IF: return "if"; + case T_ENDIF: return "endif"; + case T_DEPENDS: return "depends"; + case T_VISIBLE: return "visible"; + } + return ""; +} + +static bool zconf_endtoken(const struct kconf_id *id, int starttoken, int endtoken) +{ + if (id->token != endtoken) { + zconf_error("unexpected '%s' within %s block", + kconf_id_strings + id->name, zconf_tokenname(starttoken)); + zconfnerrs++; + return false; + } +#if 0 +//Wildcard breaks this somehow, so disabled for now. -JD + if (current_menu->file != current_file) { + zconf_error("'%s' in different file than '%s'", + kconf_id_strings + id->name, zconf_tokenname(starttoken)); + fprintf(stderr, "%s:%d: location of the '%s'\n", + current_menu->file->name, current_menu->lineno, + zconf_tokenname(starttoken)); + zconfnerrs++; + return false; + } +#endif + return true; +} + +static void zconfprint(const char *err, ...) +{ + va_list ap; + + fprintf(stderr, "%s:%d: ", zconf_curname(), zconf_lineno()); + va_start(ap, err); + vfprintf(stderr, err, ap); + va_end(ap); + fprintf(stderr, "\n"); +} + +static void zconf_error(const char *err, ...) +{ + va_list ap; + + zconfnerrs++; + fprintf(stderr, "%s:%d: ", zconf_curname(), zconf_lineno()); + va_start(ap, err); + vfprintf(stderr, err, ap); + va_end(ap); + fprintf(stderr, "\n"); +} + +static void zconferror(const char *err) +{ + fprintf(stderr, "%s:%d: %s\n", zconf_curname(), zconf_lineno() + 1, err); +} + +static void print_quoted_string(FILE *out, const char *str) +{ + const char *p; + int len; + + putc('"', out); + while ((p = strchr(str, '"'))) { + len = p - str; + if (len) + fprintf(out, "%.*s", len, str); + fputs("\\\"", out); + str = p + 1; + } + fputs(str, out); + putc('"', out); +} + +static void print_symbol(FILE *out, struct menu *menu) +{ + struct symbol *sym = menu->sym; + struct property *prop; + + if (sym_is_choice(sym)) + fprintf(out, "\nchoice\n"); + else + fprintf(out, "\nconfig %s\n", sym->name); + switch (sym->type) { + case S_BOOLEAN: + fputs(" boolean\n", out); + break; + case S_TRISTATE: + fputs(" tristate\n", out); + break; + case S_STRING: + fputs(" string\n", out); + break; + case S_INT: + fputs(" integer\n", out); + break; + case S_HEX: + fputs(" hex\n", out); + break; + default: + fputs(" ???\n", out); + break; + } + for (prop = sym->prop; prop; prop = prop->next) { + if (prop->menu != menu) + continue; + switch (prop->type) { + case P_PROMPT: + fputs(" prompt ", out); + print_quoted_string(out, prop->text); + if (!expr_is_yes(prop->visible.expr)) { + fputs(" if ", out); + expr_fprint(prop->visible.expr, out); + } + fputc('\n', out); + break; + case P_DEFAULT: + fputs( " default ", out); + expr_fprint(prop->expr, out); + if (!expr_is_yes(prop->visible.expr)) { + fputs(" if ", out); + expr_fprint(prop->visible.expr, out); + } + fputc('\n', out); + break; + case P_CHOICE: + fputs(" #choice value\n", out); + break; + case P_SELECT: + fputs( " select ", out); + expr_fprint(prop->expr, out); + fputc('\n', out); + break; + case P_RANGE: + fputs( " range ", out); + expr_fprint(prop->expr, out); + fputc('\n', out); + break; + case P_MENU: + fputs( " menu ", out); + print_quoted_string(out, prop->text); + fputc('\n', out); + break; + default: + fprintf(out, " unknown prop %d!\n", prop->type); + break; + } + } + if (menu->help) { + int len = strlen(menu->help); + while (menu->help[--len] == '\n') + menu->help[len] = 0; + fprintf(out, " help\n%s\n", menu->help); + } +} + +void zconfdump(FILE *out) +{ + struct property *prop; + struct symbol *sym; + struct menu *menu; + + menu = rootmenu.list; + while (menu) { + if ((sym = menu->sym)) + print_symbol(out, menu); + else if ((prop = menu->prompt)) { + switch (prop->type) { + case P_COMMENT: + fputs("\ncomment ", out); + print_quoted_string(out, prop->text); + fputs("\n", out); + break; + case P_MENU: + fputs("\nmenu ", out); + print_quoted_string(out, prop->text); + fputs("\n", out); + break; + default: + ; + } + if (!expr_is_yes(prop->visible.expr)) { + fputs(" depends ", out); + expr_fprint(prop->visible.expr, out); + fputc('\n', out); + } + } + + if (menu->list) + menu = menu->list; + else if (menu->next) + menu = menu->next; + else while ((menu = menu->parent)) { + if (menu->prompt && menu->prompt->type == P_MENU) + fputs("\nendmenu\n", out); + if (menu->next) { + menu = menu->next; + break; + } + } + } +} + +#include "zconf.lex.c" +#include "util.c" +#include "confdata.c" +#include "expr.c" +#include "symbol.c" +#include "menu.c" diff --git a/tools/tests/gen_esp32part_tests.py b/tools/tests/gen_esp32part_tests.py new file mode 100755 index 000000000..413f1aac9 --- /dev/null +++ b/tools/tests/gen_esp32part_tests.py @@ -0,0 +1,313 @@ +#!/usr/bin/env python +import unittest +import struct +import csv +import sys +import subprocess +import tempfile +import os +sys.path.append("..") +from gen_esp32part import * + +SIMPLE_CSV = """ +# Name,Type,SubType,Offset,Size +factory,0,2,65536,1048576 +""" + +LONGER_BINARY_TABLE = "" +# type 0x00, subtype 0x00, +# offset 64KB, size 1MB +LONGER_BINARY_TABLE += "\xAA\x50\x00\x00" + \ + "\x00\x00\x01\x00" + \ + "\x00\x00\x10\x00" + \ + "factory\0" + ("\0"*8) + \ + "\x00\x00\x00\x00" +# type 0x01, subtype 0x20, +# offset 0x110000, size 128KB +LONGER_BINARY_TABLE += "\xAA\x50\x01\x20" + \ + "\x00\x00\x11\x00" + \ + "\x00\x02\x00\x00" + \ + "data" + ("\0"*12) + \ + "\x00\x00\x00\x00" +# type 0x10, subtype 0x00, +# offset 0x150000, size 1MB +LONGER_BINARY_TABLE += "\xAA\x50\x10\x00" + \ + "\x00\x00\x15\x00" + \ + "\x00\x10\x00\x00" + \ + "second" + ("\0"*10) + \ + "\x00\x00\x00\x00" + + +class CSVParserTests(unittest.TestCase): + + def test_simple_partition(self): + table = PartitionTable.from_csv(SIMPLE_CSV) + self.assertEqual(len(table), 1) + self.assertEqual(table[0].name, "factory") + self.assertEqual(table[0].type, 0) + self.assertEqual(table[0].subtype, 2) + self.assertEqual(table[0].offset, 65536) + self.assertEqual(table[0].size, 1048576) + + + def test_require_type(self): + csv = """ +# Name,Type, SubType,Offset,Size +ihavenotype, +""" + with self.assertRaisesRegexp(InputError, "type"): + PartitionTable.from_csv(csv) + + + def test_type_subtype_names(self): + csv_magicnumbers = """ +# Name, Type, SubType, Offset, Size +myapp, 0, 0,, 0x100000 +myota_0, 0, 0x10,, 0x100000 +myota_1, 0, 0x11,, 0x100000 +myota_15, 0, 0x1f,, 0x100000 +mytest, 0, 0x20,, 0x100000 +myota_status, 1, 0,, 0x100000 + """ + csv_nomagicnumbers = """ +# Name, Type, SubType, Offset, Size +myapp, app, factory,, 0x100000 +myota_0, app, ota_0,, 0x100000 +myota_1, app, ota_1,, 0x100000 +myota_15, app, ota_15,, 0x100000 +mytest, app, test,, 0x100000 +myota_status, data, ota,, 0x100000 +""" + # make two equivalent partition tables, one using + # magic numbers and one using shortcuts. Ensure they match + magic = PartitionTable.from_csv(csv_magicnumbers) + magic.verify() + nomagic = PartitionTable.from_csv(csv_nomagicnumbers) + nomagic.verify() + + self.assertEqual(nomagic["myapp"].type, 0) + self.assertEqual(nomagic["myapp"].subtype, 0) + self.assertEqual(nomagic["myapp"], magic["myapp"]) + self.assertEqual(nomagic["myota_0"].type, 0) + self.assertEqual(nomagic["myota_0"].subtype, 0x10) + self.assertEqual(nomagic["myota_0"], magic["myota_0"]) + self.assertEqual(nomagic["myota_15"], magic["myota_15"]) + self.assertEqual(nomagic["mytest"], magic["mytest"]) + self.assertEqual(nomagic["myota_status"], magic["myota_status"]) + + #self.assertEqual(nomagic.to_binary(), magic.to_binary()) + + def test_unit_suffixes(self): + csv = """ +# Name, Type, Subtype, Offset, Size +one_megabyte, app, factory, 32k, 1M +""" + t = PartitionTable.from_csv(csv) + t.verify() + self.assertEqual(t[0].offset, 32*1024) + self.assertEqual(t[0].size, 1*1024*1024) + + def test_default_offsets(self): + csv = """ +# Name, Type, Subtype, Offset, Size +first, app, factory,, 1M +second, data, 0x15,, 1M +minidata, data, 0x40,, 32K +otherapp, app, factory,, 1M + """ + t = PartitionTable.from_csv(csv) + # 'first' + self.assertEqual(t[0].offset, 0x010000) # 64KB boundary as it's an app image + self.assertEqual(t[0].size, 0x100000) # Size specified in CSV + # 'second' + self.assertEqual(t[1].offset, 0x110000) # prev offset+size + self.assertEqual(t[1].size, 0x100000) # Size specified in CSV + # 'minidata' + self.assertEqual(t[2].offset, 0x210000) + # 'otherapp' + self.assertEqual(t[3].offset, 0x220000) # 64KB boundary as it's an app image + + def test_negative_size_to_offset(self): + csv = """ +# Name, Type, Subtype, Offset, Size +first, app, factory, 0x10000, -2M +second, data, 0x15, , 1M + """ + t = PartitionTable.from_csv(csv) + t.verify() + # 'first' + self.assertEqual(t[0].offset, 0x10000) # in CSV + self.assertEqual(t[0].size, 0x200000 - t[0].offset) # Up to 2M + # 'second' + self.assertEqual(t[1].offset, 0x200000) # prev offset+size + + def test_overlapping_offsets_fail(self): + csv = """ +first, app, factory, 0x100000, 2M +second, app, ota_0, 0x200000, 1M +""" + t = PartitionTable.from_csv(csv) + with self.assertRaisesRegexp(InputError, "overlap"): + t.verify() + +class BinaryOutputTests(unittest.TestCase): + def test_binary_entry(self): + csv = """ +first, 0x30, 0xEE, 0x100400, 0x300000 +""" + t = PartitionTable.from_csv(csv) + tb = t.to_binary() + self.assertEqual(len(tb), 32) + self.assertEqual('\xAA\x50', tb[0:2]) # magic + self.assertEqual('\x30\xee', tb[2:4]) # type, subtype + eo, es = struct.unpack(" /etc/profile.d/esp32_toolchain.sh << EOF +export PATH="$PATH:/opt/xtensa-esp32-elf/bin" +EOF + +# clean up pacman packages to save some disk space +pacman --noconfirm -R unzip +pacman --noconfirm -Scc + +echo "************************************************" +echo "MSYS2 environment is now ready to use ESP32 SDK." +echo "Run 'source /etc/profile' to add the toolchain to" +echo "your path. Execute 'msys_shell.cmd' to launch an" +echo "MSYS terminal." +echo +echo "Once ESP32 SDK is downloaded/checked out, set the" +echo "environment variable SDK_PATH in /etc/profile to" +echo "point to the directory." +echo "************************************************" +echo +

    39aH9iJ2iINtxN=_Eiq-{Esb_#*CIBlowkM4Lz6Mb7&{zC zCd*q3NBzO*h&e9%Ij)117deyV<=9wWjsba3*PNdUjM;bOW!sr7??gD3J5`MS?V8VW zJRerxM$MTl?-DrXr9AS!ruo^9SHQ}9vF1#ccO@M2UXG5Kd)ifwE6|CZkpj%1Kc$^C z8FQ)|(=^Q{O$3`H_J5{zz%YKs^amo3Ho1NoAL#f9$HzE6-tj4pPjkG;G5f^qU*h;O z$6P~9hii)QJ&u3o_+`g$I}Y9PxLy4AZgx64u5rA(<9!@+u36p*jycy%&V9l7TF0D& zCg)r;{;uO6IHt>PI=^=OrsMY==XGpNzmsF!DNJ7L_&~=eI-cRU!SPv+Kj9c}YqS4- z$4@$DERE^B4k7GQQO=pn&y&cy%{;=a2jvF1H?f4SMpLKkf;|Cl+>3E~# z*Bul8#OmDI@h*=0I^M_eaK}eEKFRSc$BP`F<9Max-#UKRahIy5dX98F*YTB(Z*&~S z(#PxJy-xm^c%0*TjxTZidB@*&{G8)A9lr5OxHvg7HFPlKbKd1AA3rjuXj_)^C=JN`Nx+wgiP z|DG6|uc>ZNBiBUwIUMz0cJkMq{0~n4o|9L|#m?;H;b^CmSM^jt_G@ z#_@@c>m5&be5zx64w5KY=HwSR{)FRe9DmO7*BtXs!0P;f5h4xH~poK@%1+O#g0Gg zc#Y#PIOf^J^5Vp8e2?SrIeySF&nc$=bH~4O{EFj0IsU*g{@-S&yavEp%& zxz?T#nZ6=z7@Og}Ze*^zvm^74c0uIx#7iP`4L&C_*WimH^WJ4;WcqJcMCKjL>d5q? zu8Yj|cwJ=P&3rlXcf=NR=RWcJDCd3c1Cck1AB+5|_{qpzr=O1eJ268s*+$;oGNcrK zSNxmEe-{5wVn#TVm%$bC(F)8pyG>-?%eIfqyV&Z;yw~Mj1bIh@ z`$y*8ENvV4apL_VA1^*QGVf&>K!FawInd7GiQL7OM< zT=Bff^ToXDK+gT)lmK0EU1;tL`#7k@G`ziC_+`6BUEk-3MgiF}EeF&WrjDZV)} z@4CJk`7`2gM7~OVPh{SK@&1Io*NJ}+nX%$Oj(m&wXOVeF&8P6tr(gF{WZpynCh||j zqzor|Ovap_c8>e^&oxe7>-Yf2^m#1rIL8wm&vxwJ_nzzID;=+P%(-OtIe(1TJATyh z2FEWte#7y5j;pj^%x2MXwPUGoSE`m4yP4}MX|SfLfzp53$ozx>*Tv=Q`zA?0W$dD5 z^0SU(LZ8#yyHd;a9W0r>-6in$ek8$RI_}uhtYnY+kR2Imf!d2tW_o`Kt2Av(Z=`fA z4|W=5Z!Hj$)$d>}`}%e2FI{D%ewA?@+k31gZ;$VlzNdb@C0oaD65ig$+EH(-bB{gl zJFLUrWKEVwn6%wFNk-d7xpfO2qj$W15a4=X$!yG*z?ZvBJF2g4dX!6fRxbAo%Ogyl z(n(bf#ANH1Y1!LbryW%z8TQz0vv-x)@(7c+W$%qG)bH|`rw%2hM`iC(>0z&}CbM^g z7<;vvNH2C(TeL>2W!5p>8t0~0(<@1aNoL9P?vjAxXla`ChT4MW=#d`LWX$q4(xaVO zvULwg;P=awBhvlLcJNz`ZN~<&Dj~Aw#Q4+y1`u zougEmD#5w0)*50hE&Jeuv-Iuavw~;`{|%X>+w9PqM|%-ZXs`Aa`%dXFbX13SnW5Rq z?JEj>_RGv))b`mv540nm$UV8U^#Z6W>Cp21inU3h^1#YTX(vXbY?o9G?evKi7iK#2 z`ryhN?mX|7vd1bXJ~?G$i{#f`$|^2RuB^Ff@!GxDuf1{ojWx$!{pSZ>_+aA1?8WE* zSvKZWRva%^unP5thGte|W|n_q#n5&#RQ|zr?JJgFm%QBjf{V%y*(-VJYh@4gNfunc zZ1F{957Zm*Nv}uxkrVrIaJ(oJ^S#T zqwG`I!`oNv^_8<~2e;j8d`02D{mLp%)(GC6UKzD?{6)WAws`$3xuv~dFMsK4nb*tL zlqzZ(9GcyKn4$SMIe}oA&sZ_NW-91N*pQi`?*|C#TGR?uq%&Ef0ISVq@#%jF#HT z4-8G#)qHIF{Jq!D|JeGaHOKz+H|JmU!A$MYp%tH4F|)&knL?WmzkdJOuiR2zxcRY) zbQ3SWXqS)GE?&?1ne4Kt(0!fu=){+%T-kfW_%Ghw|Cy^^y0PzLE$%6QchFUFudT~n z+2fwv)i>Rkv;A^qk9P)r>zVUACqEs~F+K3_4tlIy$Nid??+p5NmzoN-9PN+tS9-iV zC@u8m9#{5$XVAv0)?d~8%G|40U6s40^~%NTpRHtTt(+@+JbU<`E7#Rrz4yxL>sMaA z{;HZ|TfBY#u^(uBVEc+OW!1f^dycQ*GveVoy|wRle@EwV8n3A~X{if3*9HC09FWs> zrhi6*-BU?|B1!R@ei~*~r|A?^yr%QRtnx~&Z;IE%qm1G;J%nae9@tW?U z{4`$E&nP{O*L1B^O7WVw-?w^AD=l8rEY@xwuW1*=wUkj+__5S2UQ;{m*X@tj#1pB- zYg#W`7O&|9tPjO{w(xu8`=uoj(c0oQG2D7f@tQiJ6XP|lMCTy#b}cMGelT3E;3pYX z+~PIy9%oDOnog${7O!b3N?VQB)LR8vyr!_nV!Wm|slfPQVMBg|g&41i$K@S~*L1b) zSiGh;*dZ}q6Sule;x+YBtxNHmj${)oUenoBz~VKHq6X&l-!@bOy)G;x&DP zH5RXFFVL@5$(P$7@=E=@_r66;<0p zye3{RSiC0O2P|F_kLMPzsT}zh;x*NAEMvT;%dx)$@tSz0VDXw}lXna8npRMU4a1~) zbm4RG)62x;3LB}<#=ImG3UoblF<#TJk-vcccE@WPuTA)OjMsD^T1J*F#%rq49x26Z+Jl2;@tUTvVDXx+VxcaxzqAWQUIA=9UK1}oO7WV$ zM=dN~lLp*1#cR5e18eb`c`HvUeiXjr-sl;*&^?^O7WUL zi&4FOQ5A|so{UQIn!bPmi`Vo`tuMuE`aA|s4S8ydH?l@spxMyk7}m@V3w1?)L-}XK zYig5yUym|fS}oN^R#kQ)EK}hv?YPR$A@WcGUzy4->ddKk(CTwqC{%VGkJ333Rdxf@ z$as~z4nwK1i?*e*I~fSo^?{7g8W8D)KgEY&`-j5Yiy^iydMkJ?Se zeot!%_@rWYjl~vt?D8cqPIg(G>`M8Ithzn^tbA|E;#ILM)|{BxpABtLfdjOosopKI zKxB22QHk$wR*B=a=DBF7p;QEKez4I}lL~LYc*}c*FSIAUc$JND4p(XG)Rqa3(Yp^?i7ctGG5C z*rs*KZu=^4Wz8`CXEV|@oGHm}G|Lv9X6iq6-mJWJvZoKTlaqbya`t_JobAb(RuG-E z7Ri4j*yKO7!x3x_?%Wi^rdeDT7s`fUE8UvMW!dx#?Jd*jHo2YDQWOdYO9WPF{)u)M zaHf~VbcDmVqR12kcG+!~0BuU0TKyW`eaPPOdt z%1JRe6dFmr08J``Stm`1duYB#;Mz6J_l|OIFx+kl9m9O7CS_&znJ8w?4?Pl76MnZA zGJ9DQ8JVXQSIF8vTHIaw; zRhmMcM^zTjNEP~sovz$#;IvA|GJ921&;xivRaN;FZmp(@q(SC;u7T6)j+NDrdgwp9 zMcV9ow!Llu1r$E6vWDgu^xaaKN$5j!vb_j!C7=>QgB($#~hWSSZZSNu|tgNu|tg zOQp>2)Kr!%tYUt*ri$bY?crV5!1rm&BquX_KvQ?^$#6H_%57~8O8oGovU!N@rl~^v z{tWGXxWA@Ma{Oq`CImd09ts`>k}~^fz*Cr=r>TP~vW2_%8rFR}s2;Cf6;e@)srgfw zQN-4AHx+*hwV>RsscurI6@Nk1D#FdYmGm;n2_~X}a@c9q%-_?LN$Sx`t6bkyrTV5K z>uJDggRS?b`1MLVxP@l<6tR>l9%qWb7W_ezs?k-&^$bOxz^qTeQ#hwbrpSzDrB=YT zBcvzwKW&E-n9&y1V#hVL$q6*gG}o$eX&(JBEjUziRgYOTTC~;r*+EuF>ORE8WzCWz zq-p)r7|8rdG1@XpTF3G>VgM)r<$q)9{Pi();x7?@Q%oKEIb*Y^I(l4~HFriDVMot& z;dqztozb9PqT5ud9TOskkSrm#PEwXFtI)~{0?3qyz%Lzx&a5VuPNsZ%3x%60@6w{J z{)eC~ z5GjmL^GHNZVTUvhdvU|G#)b14o}C6^sU$rcQV0g4C?poAWzPHs(-h5R`s_(Fv{kbj z>ZdGGJf8Rg?#Z)H3-OoI(dP=+@;AgM3h{d==pPo9D8?e1J9}yft)p$&N=PE@-t;Cw zL;2g{6K!WyA`bWbrO9ILeIo6!58^)GD-A!SCSISmf^CE!+APeF+QANl7or?qu5CGZ zkZkdGZ99SoHSof&e!6`;y}th6H=0lk+|WFX(2m6qnmhZnx$_ni+G*-PJ!nw<^jW$L z)`t*E1U6e7f;fd!zkc?R!IRQ}SPG6sM2acNp+}Cd9+5`TsqR0AtDB<#&2FgfKcl+; zQJOJLpF6MrAFx?{{qRhnSlZ}il}TLgS$;N3N0105cjc~U^mb2AA!+)@+r zk($ahA?IP*>u{L>;1>Cu(dn@f=N}T-eH8CN?`ai>W(0JYf&goV+~zk&we| zBXS-D@gIUKl~I2|hub|*N62}ubeAp(-ocor@UwT6#W;toX7(eY$>Kt>_DjR zSL(UNKt$FtZMqr9zNLzwt!L!xMdCc>4KRuFGx1FYGmGWJKFM%VP~!bXrenaQ+A;gd z;_>u_JL{iPKTW1z3&$Ni*vW@F`EFufWN|IrH!|-Ec_CS(vP#1=p>wq6`Z+4Fe(Flj zjm&k0*O2INU3@w6V95)bkaL|I8ky?>uMCkts`)x6=Q>8YT#tSh<&>3`F8aKFIwUf7 zCOXDr0v+@@Ghps5>}QyJ2)>iX>_eD)27DoWUlcnqjRg~w?yWJ>(?URrTHC^dC&Ee$lP0g4y*ng zGB_XG7%%0p`I_c$!ct&=z_aoW5&Iax1aLDR{#B@yjF79>O2y; zChn8ig1LX592q%INZ6#^!Df^9!07XWb|oww&STi@Ux{23+rBO`+fBj`E~`1m9uCJ^ zoS~zm#Bt3i4~gSvW3zfVt`HN4fu!O~F>mOvW#WaM^UJt19Bp_ z@9uaX$738%a6HxVrH-$4e3Ro4=O!Mn?>hMp96#gu*N)$G{J!Jxvp}@T`C{8!ISz4dqMbfY9^%|Y z`7kFBac-g<-yJK9v0ug^&P~(_ac&}qI5&}RbowFAO_VcE%j|?WH&Gtq+(Zs>ZX)CS zX!;?}O_YZ?H<3e}o5&%~P2>>gCUS^#6ZsrnJj`Z@a}(tu&Q0VmI-L;bCdxyco5&%~ zP2>>gCUS^#6FJ1Wi5%kGL=JIoB8NCPkwcuD$RW;6>gCUS^#6FJ1Wi5%kGL=JIoB8NCPkwcuD$Qxa`Aa0ckvhY%&bvD1yLHr`KHEM{e}6dIAL-x9S=GnmX4{|)p@o2{r9G~QPiesJ`%qBh<#tR+u>|pX` zjxTk5g=6|ErhlE|8y)jZVLD%TOdB=%y^im9{Fvj%9Y5{(Ima(Le%bLGj_D&=xqouZ zOA(V-sE=XX((%rYJ2=KS)%58{84q$ypUUJ1Iv(cuaK}eF=DEi5p5l0#<5`Y*&Ncmo zj?Z+w-0>xj>C0JO#v>SCYdubPY3`6^?lZGx<)AJ3Ho?%XH{Z8uQF$OyAOYu;T+9*Ev4a@ez*ci<+H!$I~63 z>KMNv(_iTLbjQmaU*MR2tmVDbG0w0izsB+B9P@l5KC0Et$0ix*y-S|4k^x;i@i{pnJKj!!;#~U2K?f4zXA2=@84bRHLx!xG( zeq+4sjSq6nKtGco?)W2)869IfCpn(zc!p!17fgSF<3)~f^EaIf9j|nJxnrI$On;4I zh5?xTHph24zQ-}21~>f&9skhrla8Np{By^QH!wSII)2yjpB?A)e#P|VOjP2wj*E^N zz+n1}ZZRI{Sl^s1$-_Gt{weWp$NF8o-?6;m`CaE8=?z_zcaF@p8dj4E4uY^uYmjLw zSC=vT9)!G=n0HGsuNJ#R=DksMWPTsoEpm4;*JSj2h%Khh9%8P^$mv@h5}Cf$M&m9~S>Q z@}uI{BL7hQW@P$b??ir5{C;HK2Q#)9JM_z1M*g+9ZRFR)#DzlV9WkR;VcsG4jLdsq zuF1%E6%UB4aV!b%K#=opfB(os#dVQ+SA0n1gT!MZ*NKmbJX|~>GLE3ck-{ean_QFO z(c)7hA0eI}nfJ|$BJ*zi^vK7EdB;NDiQ*NJ>5E+wd7jwf=?Ij@%JKME`B)j6=L4ikoQWl#nIv2_AjG+wfN=8ybu3vYnA6!Q`n`2*sL$d8H(k$H!=bL1b1yGABPJogCl{#-mDGVg~6N9Mga_X~9X zM?5Mr@4}CYOl-IlBJ*yXdja~q|C=6}KHcod^y#=4pu_cpG0bo$P3K46MSO8&`g)f} z=DKoaWJV-0Fr2)5X}Ui0VDU|nhl+2F%=`5_B99S&D>D7N??&cY!o2{S3pD*8GS`o% zA}IdM7g1mG>jB6=!v!Md$OH@{w;9?;QDV zafitFh)EVZ({p$aAJ_YL_%-N9d9C9E93SR*oa2d(XFFcv_*};;9dq5Za@RS&-SK+I zT;oiCgX0$+zv1{j$5m>Jmbd7*+HpU}T&GN*>y9zk5#y5_&veZ7!gRPs7+>s|^W5au zJLY^g`L`TD==dqe8y$0gTHbdYXLW2%-qvwf$J$lfm8zvB(;7FCroo!gPAsX}hJ^13 zTo;x!@1r&@=DtsU*3lmM{nXo=uVsGkw`BHqm%!V5R`y=hwGMllmF!U;>>(rZjNlXN zNc1PFG}-E{>5Y_*X0PWKuor7nU#%o&ChXN}BK<)P^3F}{vHn&~UhgYCwlAjC8`2w!;h3;NdPI{k%YA#M z?F=T_x(CF5JI)=E?q9Zp-$hx+c7*Gk=9X$@k9QfC%pQF^Z*QgSp@%(wS~q(-?4>p@ zOeWN9Ureb3dZ)jsb6#Tud+cx8qMC3iJ-b`l-!_5OFUFKwJZbi6iYQfGJ!tTd!9(`j zd+^Y`tE>0fTmRz!LAA9*h77K*-f!rTS_zf59aHLi+9ypeAD`CTT>+%{xxc}wNdU$6H0E686%evaAJ;`!h+L!UcoT^)W?7lk$yt{qX% zcV*bO`k$e%lHmf`Bb8{lS(?hSIh?}Fvy~gQf6L1%@f;}6RPaDho~e49rLtU=OqN&W zzJ;)=a*<|Pdd+2d9m*v8Gbxo7P6i)FzwMdmWpkaRlKmE0`yk0RYGrn6rk}VXTYfmt zD3x=`FlHtAIu-aZ(xhsb{?Yzh@J|kE*~%NF*s`kp(6=PW(`_yvP2oxY%kYuh5VA>j z4;GGkf(5$BNSiybfYnK0oa^(hsNo#!sH&+`rD^JHh z<*NKAv@+#F{%ni|owlv(mn6ACi?p(+0pr~?ugdG+`Ik*xZ3|r~J;?ISB5W--!HR zxH@V3N6iTCbFebzdGVVY4F;drBzHKxY^OKLJ%&1KB=|s-j$$F3Nvc|Cew38LhICI_ z@m^2CeJ<84-DBgxB+oeZ+;|Gj=GpMvv6o6-mFJltcifHQ71}pgs=7}9n4-xxS>7k^ ztk@A!ZN)R8g8MurQT|u5mTLr)Jm*1fVX!Yd!?e`yBB>JGr&`-v`%>t~ zGvjrhWs7e&EmReG1d3}4MV|c>+=o1Ei(J?g+-Gi1`HS=z6x@e3or>>~=bW(6wK$VJ z=VsPOt-5{vocT%a{LFQ_A=ea_ux3T(Yg*`AfgFg`W%l{Gk54|j| zZLOg)N$yeX4;HJIk5S75#H!{GdaJCu{7)$N@!v{+WS(cI+!ODM4{fbcJW1}yhMdhGbiQGM*af&3hu*>Bxq342#IM zHygD|m&`|$y-k+g88XmZT!ye1Gu)t6oygTDd$#^}I8SESbf=D}WAD`dty&dKvP+tD zl=~?O!X=Xp4(C=`y4+grAzp`az1Xa7ncYYeIv~ z7R$)eJ2WIBywJMZWU<+9XH|*dKG$GiEouh^PKr;naBx_tC{}V9>N0yvyHMo)Oewfe z6|!5DJ65+{5A9BZ`}_`z)2YSrnQ%oeeuv|9Lab67ZJ~nuu%@c`IBF+_EClyK*zQj% zh2TDys=*h3MUhiNdrykQR#tEy4s5n~gZ?YH4-17N-e?N$!$Prm1$CYg@^>v3S(q8h zt|?+)!F^EcTf71Tr-p^vVm)h43kySw$FgR2Sg0#bV_{BMI4r5+U~|a`8(pa?vj;kJ z-3Z51f^}krhLX5VmWyd;&U|YDKM5=E5C8vHD%lIQ11bh{M7q2#%yjRq;z;xlGOMSm zm%j_&Z_jk6$&$K0tACm9OSL95wi{u1dNqg#O4@C1lBvPKa26I!YmAHIwYckyB-5ML zk{K7us8+-lo&!RA#6U;>sm{L)m80M;MQv;*+{ozN(lg1deorgX8tqSw8YS$yO2;L$ ze_QodVvP>M7QZ-Cql2l@4J?Ejg~dCyNR8@Zjizb2I)recUUY3jy)c=cC$Vyr{+9xt zXmxo_lFuKMFV_P_wnLIe`54_!$1pA^RETzY$4oxIfBr*xT&gQuIkl=xW^_BGEqWxQ z+YQXC&(hB6>hmdPa;Vl7+NdyHg4<=vTQ?chaPaaftdDMoQX7;gwQW$#S-CqoTiVk* zw@>Pf5G?F-OOp#R!t+Eb;w%hF ztt(g}CILSugi|97q6w>Mn+G^X5z&IBU_QxdRyypi!yYGc|>#$;;Tz79lv;JK% zqU*zTASp!vNXH7#nm4&2X_z^0L1T3|;EcXq8b;sNH>87R{}F?p>!-|~HfgRNaO&qw zS`tS6hU-px^$BBq)26F$)iV}(%DjbyMyOvjiC_Tre8FDhvK69$apsC@ICoz1w~T!L z4;=BV12C^ayK)O7okKIx7(Cqvw9C~T=KRZtJ#z!v)(~fP$djI$iYP152ZouD_tivC z3f@-}sY*gRM#yzTNDkGcyJW~q2ght4C1yP~KccClChW}AWHzm*gU&XG-ZoBK(wGdG zI;n9|GGKB;Lo#5&wAqseOr17)p+>kbm^4QbFPvo7-0AbA9o9~oJbA&iMa@?0rrvCM zlI~$MrZqP@d)8dpOid8&bHJ2&bLMb_2c(^(0cjbb&?Sun)Pb4Lc5Is1IhHmbU+dTE z5reLUOXaRxh`2oMSd=ujJ>Hhia#Jb~Z;t&kzm7De^6<9ZFVkyoO63|M>r=TrZ+JIP zqJiwJroj7p8VFByESLIH@nV|J;>jW%YFJcDp>IxU@Sd8}<%a2F)3Jt6)0~C`_tm_c zA)13787@J1@u){lTCL7mQ3#%;BU`_mv#{SyR zv7V;??&I19Vp9)|q#>G&_0v{~+2hk9W+NP?KNgc#Y$m9e=~|eU5+Vm@&m> z^Cib`Ip#`gI;|YzlWg+dj`wnWwBwT;&ve}Ac$s7TKg>RUWyTLW<|iJLzwG#b9rL!( zblN!Py}rqJcRa)~zO|-vv}1g+OupFhxsJp8quA#0k2U?99pgh~^7|b>;h6WJrt_NP zcO6&gNzioKImXAynf-o_ zhdLhVc(LO)yz+~7c5&R-@ji}+J3h(rEXRu+pW}F?<1ahD+wp^rf9&{|j(_jCTs;-5 ze_O}h9Pi2%N_jB_7 z93SR*0<3eAvb#T=Gwv#{N_!-Bq!m%v!Tm97xON=>_(;+n0 zo5~V%e>XYzFXO!(4|jZsW8O`hKKCr+NsgyE=ALCbOB|o&_#DTVI=;g34UTVge5Yf6 zEw{41=lDU#YN~qiqkl^Dsce51#g>=fKTOV#$@uS)xWB-UrCt$SFgzXhE;Yr16E!;abegxK;3lTT~qr8);J*}C&3@b+%6)-T{%i9Mbm&E99kaiXANvyOTJBh803X`+i%fB6n$?P$AyDK?NhT2M~(mC#AGsr$Wh#E5 zb#nL^r2Q=)xg(fWvNj~q{IB_FwGFdBX282VB2k(LbSx-I9+S<1R`*a(!j0)dN~>K60H{ zySa}X4^!qN_Z6v|kKBu>Z?}&eu7Bnu_n`Ki`N%1Pamh#S56GjB+!Z=h<|Fr}YHB`m zcf!#}?iKPzA326)nvWc=$|WDU3Kd-Pk;5f$OFnW8Y%KZ6jYVmzK5~Cj1vA<;*UpO~Bb$hE?evpV;gk;)PLx~_am0-+qH zuF}~P{kpCOtMX&0$7i{N7V?Zc%&mr_U)MGGPPNTnCrR#F^gHDbgx6jq&8|s12A1ND z$71mvw$!}wPQ>iTGvCqOHCyZ?D{-N!`0b`Oh2rPPW8QdsVEU}g1|6niv79yLjmJZ9 z$s3QSdwJt2l6I3f9??N+ig&YSMW&k;`WAx|qIu(0Qv>tHYoG>~gmMNK7pgRQv+DpChCb3}NcwI4lP3BzHZ9_4` z!nI)^yjc7$YHKow$iT}*1`_7h2Ge-saim(|N+@rpeed*g+p7QOMpQQLwy-gWHG zZ}!&zc+~C*M=f8ZTG1QtIrzR`smz-ESE@kK5x9= zQ10Usq(3r$AbFpdDQ@nKH<@yyHy)$m%p31Y>JYv0mQjc3jmK!FX5M%lm5yvr>Wvo` zd#hmW&7W(PF3uk)dz&n~Gq?oNTwI2*7&GvyqZ7H>WPgMDc{0PMJ9R|ni-j{>Fv%`y z(oyb%BnaMkY;bgM3(HGvSz9rk&FYrn-A}u>^bc=50{9feRijtnq{w4Y$s6xrvh)rO z32!`FSDP$0+x1kv@W!iDH>$|cZh7OuNs%#m^2TGKqFBd5UG&Dg5VaARW2MzL3Ep@e zrDWcCqjWUz#ycL1=THmt#v>X-$s2E#c2vn5uRRt|3Rz0tc!O0W-gvya=U~*l@fhGNZ#?pMEq<5<^TxZJikLSZeaMnG9s?*#-gu|6#=P-9 z#zM&(kAux6qvVap9_Y+^v-(Y~P95G3qMedYadSVF68#YL5t%RRRwSpk&GD=1(!e#t=t)nxP zS$&8!Lbb+Gt+OTT6{#+&}|FpMxq~A^5&ZMk2MW*6DU%+5R zdDw@4;ge;m+J8Oxa2D*`KGP?B^Q+5W=fTIbi}T>?B!|nU50rJ+8guoNVs+DJ$$B_< zzMdw=5wTZu@4yY6j(g0m z)70EOP=bW_jQZpiGZcjSUrI|w`sNrj%ijE(V}H>;r_UY1!ZFO!$4)+zriGB`l&RS& zsWr!B&lD{3BI>_>e{wsVF=fiY&3zIF4;VUNAM+pl`*|YrTQ!f~Q*`Ke%ER^EwsHJ`JM}vGAa^iQC_lnbW46 zRzGX*tj2m=$hYnWs5Meb>Qk?c0Rx-d0nM#6ID+z3k$D4c-~W5~0{#^)fa%vzCQbS1 z!dVNZ$-zONglU+iPs99YxCSn2UzTmEE9ef^ASjnNHjo1TFU(?gx?n>LEIURn;$ zj=_%$XVA1}DtAXds8ZTE=Q9{u_`i?mAWnfh;wm_2-c%jIuv_>*$eeI6=Hiy6eJKC( z)9PnW;zJ?R=LSbUcsWrIIM|Ha=@ zG0#HZ1o`lE{Q}&oL#yG7L|bq?{P*xRtcg7s=DKs1lKCIXrvK zc^@rf19@Lfye3DVM;Ml2T(?N*z&srwU!;k5MDSWoWs$GboP_V<^_uf!!#eA6VP~8E zhqGrjPFpZ(c61y3clSnAZDUQh=9<{-K>Y`P_k%`biQi~=5U|8D4apMA{9a9>G4Y*{ zkzpzQ$NDjwEKl8J`E)H?<0Jp_P1cwCo_zJAbSL6M>zC6zlT!%SiP9y)I$R7|so%UO zlJ-zGzy75+CU^IYb<1$ZDrGfgb`BU$Iv(3d;T3^?8zbpCaO>X)i8~i_d?$c}2%pPZ z&AAvLr<@um=Y&Vj33_;BvY!eoFDE<~0CYG8Jg&j$@PY&#%G4{E5_6$Jhq}Y|Z3&jq zr!L(iQ~sWjsV5J8=x{OG&oQrOu*p7v?OPP+Sv`++JSj4DUmkgt=1l0X)%iB%empNYR_!h_Cbj*u=v;Vwf;`f=H(eK7p zy3iW8cihwQK*t9-9_{#8$5R~7cYKE9RgS;y_+iJtbWChht0yrZj4N_YOnf?%@9KCD z$0sOCcl3JBeT|_IA9N zX8mmS~j_(8`%c1#!mtMl(1e^@tplOG4`8bLZyZ2pe( zk!vEI>G&L&o4L{_oqP=(?cmRf9i0Zrmz@3`PXBJF|ES~V9lr&~vi|Jk8FeV_e%D@X z_3Q#i{XTH4Pp#uaolf|^Le!t?{sFKh5MvI-clws^ilf&vSgXXjg5O+?%f>lH+SEt(=q~A)GtEMN z^wf3VECwaV_D)Tf%--%2z;$uO^)l3`ieQiSY4!$-sUI>DeuqBU;{FoqGPO;;kM5R=u9^WN95lTLzjC8K`2oR{jy^NzQ7v=+Xu>yss0_Yn!az16bUC_~sooptQL z$(k&WFv;mchTowjTenaGW7a9KN_b}9RByfnzTCDoa#fOyaw*TsBr zWfFLMN$>Po7JJ@D_9`t~9%1sB?5*0uc5t40d&J+tCm4HN->iN&h_T1Dg>;HmuFa*) zf7UVG8t10>zMk8MNoL9P?vjAxXzAb%TlTqqL<;1wv{-tyGfTGa0SWweoU~iIf7uRR z9oTkk5L+H$a+d6^2V$~yPiooQn<;ziCBq)qX0yjN+s+MPa4Q?P*$ECH_{K_a>8b_ywq3f@ zf_rP1W(pUKo`mKC)7g-Dd8c=J;7r?;hjU_U{yr0T=^_ft(R_!r_&;(OMzDtqV$669aNX!Nc94SeJ}iL-KiWZ|fvYe9~R z!m*9QLN>?qRIWo$>YS~tlBrg>FUhy|bj|WzSvwGv(_d5k$sfp=`PQDHmF8Q^Lsc{1 zTKQ7wh_uP>u6b2Q{kv3CsJaTeTP)vNM)TyqOvU!qHHIrDR$~0g=aBD*yeiLQl=;@) zp-kpm8^ZKO-`e}g8+~g-She84)HUCYya!{aI%)eF<`jSO2uhx>TI5E97Jm|6wi6Ga zxiQpPfw_91bQB9&#h+}i`H4~r8>0A=L}rw4EzW`I9vcTH`LD2>##3lEzXS`%a;&QI z>*3@0Y69^mu~hYC{bPzI+hlLog5poIb6OGKQNFbs#d!{Ut`Xcc{v<7<-A|;7$7?^; zzL;SX%;S|qASc&J6{=0~*G&sm#fzI33dNhKvw6JsqOh|vxQ`W!-&dI>kJsOl$Kp@k zPM&i!H%qM)f0F02nlu9DiV!}sZ*etw%;S}dUdiKi7;7#G`6!Q_S(`^u&~ zULVoI0YwgsJYK0zUGX_K?$aTBRv2XDwsb%x{laFKn@jps`WWFPLpJ=JwVIHsKJuF{KxzXcw zH2m~g$~7)OmpW|Zf;Ax@JTrgEb>^geBk~t|i(~vrj!H+irz0EEF)XrLdvlpqamm!m zHd%IOa8ISVxC~)2X85XBbs|@r>?ifV!z!6!)15jZ^LP9fI=v-emo(`p_eKfAC6f&f z=a%A6a-!fQ8?QszdFF9ywbYT zD3qo6lQ&|350c8`6;6sBWLh4tEL0RnvQQUpErsHxsEx=>mX9u~wVk5^3B6?r(9$14kpKgq%7k`XqV_>=5`&V-!}$5Vpa#ci^DhO|wV zyGUmO$650Y70wFD!gFAhakdMW*38(h)8{BYWf!zE zdmJY1BbC29&wy3|icWoI zd!DG~Q1uL1(Mr!JO6iF0j_jAD7mx7rdJQ{ZhrM1ys7i}l86rsjH*O`rY3{Ol+)5Xj zvYVa^l3km-zQ$;kc&qw&l|7oASbH}2vQ52KdkxsK*XnL6L0+rOXll*9R*{^LDlntZ z++0CV&WV~ukcXN6S_!FQWVn2?C707~neuG#@yxWS zN-_!>DJN0+e#(neo~ZEYc#uj*txTaKQJ_XHT9U3bVb31C%l@o??b5 zyrEHH?G{h*_VI~om^LMKMJ)MV;#D|pYIW+3w=jh1`)`oP7{5?WX)->1|Jopr92$ZX za!$zWZT6%Y4SUJ?Wd}SuXUttVg+`IKzis<(T3kuu9b~Yy_wpO zdaW)FF*;|2c$l+?44#y_80*3iqGu+D9yz{xM0FTiP~CqH7mg{DX3uV@?mwft|52JT zO`kijf4B?VKZ7%!3*Id|%kzwEzBpw7^4>l-J{(4*mq z5&Kv7ow8tFLqp@dd9(W;d1!Uh!rU4C2MyS3uK~6F_u0GujKM>u4;oTCz5mo%3mTX1 zp4LCSz^>L!f`0ad5YoARG!YTUj~!J%Z1~ut#*7~~s(#GqaifkIHfHRBwJnDYAFcmV zR^mk;i8=W#nKvih5ZxC-2ZeQbRU)HbjNE!0RpS3RugXn!*?*v4r8OU#1b&Wmnl14j zoyQt$F0AKa&l2l>Z^>VM>;0wDuA2V-5RI6hB2R{yVk)F5ntWF=zH}rwAN?AKi;ciTNseba=AEP2T;>>G0h52r@q><^a{Q9xw;gLl zT*(fxP|W5oj{7?114X7Y-0@M4Pjbv}Fs6TwJGKG*Tz5-0LeXUE5htjaajt=jSS#EIk+N48yz**D%r z7cApGjt4s)=J-g*giNr!3mq?a{3*w)9e>mD_Z>gw_<6^_bzG*`ZB}j@$6X!o?s$mf z5sr^`e6r(H9WQo#uH#jXz0ceqoxDOfD61#I35<7jyr<(Kj_Y8Zhoq5W^OrgvxhB$O zPAB-u#q0L{PX3UXynUtr9CA&hJTDxg{i5SN;b`Y5$KKC zmTPIOGr!j13q`V6i8`edV)P)VUhhQSN&J3f`WFO-LZ?RDGV*TXwvH`^BKxgtla=W+7Q&Lf-6Pi_RGKP#hiQ&Ij*;05eVHiJEPN-Jxh2XX?XQVuOJ36IbXNLr zdLtzBaZdLarnJ5|MQl6E2p4jpT zlY_Og8i>i(Ez`2MH&ga%B*R|oxDLCU`b*VIxNn(O#ANm^*Rr>FvFzP08TNRtu=?E~ zCQq#<(iJLff$mY3SjTj0oSR-%ar^wGMoVv~8H+Ype8e%!XGu$7tKzXtsxBMPp3py6`SPB7$<7PCOLi3eP{w;os9=j`yl;={z1P?E`mX%E zd|brmvajcQD`?O*Vk55C#-~18btPXeWIV^G^6KOjT}x~h{YX^eSm1`Jz3V)EPTrFHx2>t|t3x)l)UsHMflupx5g>ZXF^%Jmt{g*`S7ObQ#Q!1!UpY~f2- zIQAOJs|s(!$K5W*l?zKPZqYxcXtGWAYg&*i7dxlbMY1DTu3v}?ugF@i5ljmG;f2Az z?9eV+jn)cuEt3suGSO=}9pC)qn^ zggkAF!!dnU<^|QFSnSQ3v%{KB#g}%;dyRD@m;p(+OQ8^EWU`^n#@OJ;N{|( zEUXQtaT?=Dwc?pwPGk40pwwxs>8O33ddH6zgYl?+!yUCd-BG*C9kp+wACKBS;iwe~ z)bZY#l2;dS5Y659hRUodJV~YQ@2;x%Ed&Rq2S}t zuJD5X=N_LT{gH*s$ooWt*qp}5dstyA7LjXjzM@rSieamj3UsH1kb&mnGK9sL0hg{$gc z;oz`Pk$wQUE`xR<4JK+~5?dhasT{Go?GDZ8jF;2cR4mfM4*&l^H&Hbt~XTG(7Bf?4oC$`D*8YFwa z_EW`Rj!2vAOo_X+nx&1bs_evvDGCp3ZDr@l!lW=(^2#nJ3$sb9Raz)icKr@Yw6Mx< zU{cr_-gOvC`jWG_I~h3iv$TE}oE0lRlR-vWuPL+o=@z;ohYurviqnGBmEZX?pQ2!n za<`LJkIbjYmKnFJo<`zABdYkJeF_`bXsNqCQhWt^cWbI%IBQ;#xsoj@TUA#*Yu=(H za~1U{TQ#PK`r6@v38Jy`B>Ax~L{|iarrtlR3Gp zQU3`SNnICc?e1@JrhGm#P3oO~CEh)R`Mo{}cE6XVd_&+p@FC58f!&ZcwLNxIh01$e zkAQzPDgED*S16Ueh6x`s-Hz0&Ba2evcNx_tNf-}$T1yJ@fPQgV3< zF&UeE8d|&BK4HzLp*1X^6faWkY*)9awM3IN2RtoSyG1GYXbL;oGe(M(FC$iaS$s*g zH5YcWw~6ufYZgm#bh~Di?Bgn_g8DXj^X(oBDutxnqqMF0K8jI^u zpVI!4#~-unHKh)H&`s$IX6rRI_wd>BGeD{02OFDXlwgn2Jl3HdX34hYhW&TTE%R= zrix@?SS1XJ%iUkM;p>(2Cz@1eW*am$-!ok$(a9U+VWxj*S-Mv%%aZlFSp3%qvSCvH zy#~mSq?zARv#)ahJ$)d<3!V^Kb4NWO?UUNm7lojH@`lvm(*-&l=km)l_8IImgGXbC zhAEH6)UOdA$5dVxB3lNpM?If!5|OjDOl}&HQx21VS+>=PoMvCKI4e{WeFjs$m0FNT zrs`vBL)6W3);5!5S`gE-a|=8;Tf{9&w?!5)ytW(#tK<_}|9|*X-3l6( zo-ITU-1=9#>$eb`laIQm&Wa_E#}LS~D+cFNFI1 zOA$Wh3&(!e>HIJC4y7+hO1p+B^FP}+YnFEiJpO43u)Kuz4S^^6pra!vjrCqF>U zgD?6#;L>}APuJ8Z^5-=-JM=Plj&dGjv5o$>HI+qPuQ{nobz85wy7FP2^#{rGALpSO zx=w7k(&pbIFHcv*|C@hryke8}dTZm7!jHQpo7wMd}N`UgR2OJPB=wk021ek@kX zYBIlCP9~myNj%?W+6PSE9(72WhqH{H&q>vqGVBB;E*8c*S2cPQX(~5gT`o99o!KKb zuZ0U~`9qzYV}+c$oD^A$3C93A`ObItK9uG@sllFp^4GOByC2? zcZ}v}eq=N|kBj;FzDGO#f2H z*E+t*@g0u8>zGfnnVn}G<9}!JHyyw4m_Qw-)5&p-W8$ru&Vi1JRAKTNjvE}G<@ghh ziQZs&zwh`-$3(L*op!p#8h3Zhk3S|K;rM9BCp$jX@nXm4I_8HFvw5v!zL00~J00Ke z_!o|M^qcq9*(Uq_9q;e>P{-pOPjWoh@y8vnaJ<^_Lymv!_;ts8Hq5p?r}zHGJ2@s; zjmdX+ypQ8)jz8-7LdTzW{5i+BIKIpAYmWJdo7G{Z<7*t>s>j^muJ zsa94m$F+_RbbPqu;~a0#H}5ZX`fD72$?;u|A8`Dn3 z2=Z9gcrj&hn?413v@_G?o#XV+bbOiPuQ`6u@kTh>eAUT+E2iA_DwpqHTRp2_+ZM+I z;8hdoq-x~SbVgkyczh2B3GWb66`p8d- zN&i>k(5`1&v~4?*s->*v5}t#|H&|0YAf{}b@1i+e7nd7#A)77cv6}p>qwNid%d~yc zL`@rjn9SbpTK4uf%HG8?ggx54*`q$#M@AaTf=jl@HIrM}w)93y$MRqXdv!oeRzIG_ zef?&4-@Y*xOJwhLPRN+7EUwYs-W#%qGb7up+g@pVCyOnQFqx*EdV)Kqwr=4jdf(B> zKF(IUb@Ro(+#20z823ZD952=}KTng(p0sP5B-N5xvUSTO@b<>&LQx|b_PE}dy{p8Q zN0{s_d-!5mvUQhB;O)(qy=7X7J!L7`yFpBzT1}*PbU}Nc3t~*HW4blYP4D-5e=#iT zFf+Zo#9Tuy?b}&x!4@<}kMxKpW0vPhk9KCs)^QK>+wsPp>3(H9cz%932$RLK z_b3pPt$R|--rjq%haUEL-DUQ8Pho9dn2eCZ^FT~ykGb3ZNsUhETP5VY#s>D--?T+< z?kOTJr7~0gar+(*ugOr{c{(e+P8;|j8LrHVOZK&l@R83JI6*WSMi&UjW|~_ zHQUnI2>PlVAN|ivP~9{8Y3JONN=k#tn#M+)skIs#aaEXAa`9*y8^P<1zce;N{+>2A zVyg1Tu@MZAE{%;CB9-hYl^(}Na91wdWNZZ9sc~!sFHyEWHsY6BTN)cdcvc%5u`g_6 zBfd-d>DY*`PJi6A@H%CO#zyqi{wa-(_%J)m#zu_Ctc{JJyBHU$igz}x zDHMOt-r3^Vh%o-Z#zu6cVm3B{GdQ=!u@P-qV`C#2-cuSI(T5t?*a(I#mBvP_$Fz-& zz_+$EHexw>Y;44ltg*2X9P8592>Rruu@M6>ZDS)^uwY{&o<+^ZMl51sZS%1akICqE zkBtaNEsl){M{NhjMs%fG_s&!ssxJH#j$dMDVPSV3`+eh!y1B!q|wD zC^wFcSO`D8O!XO8;9IK%ZZ<29jUcjWX>3HeYS`F_ zBiUdZ8*v#~wmmjtcbdPAjabNnjg1IH3+giaYabVi1j0~2-D9=z|JXYd_^OJt|DSWW z+;A=s;IanrvWGPR!locW5J3=?9Yil#E)dOvN!YAPL{zkD0XMK{f?Lt5#jQeJ3a+5k z*0pH0#kIJ+7OSncwetV{=FD^R1Z-*j_y6{N|8+h&neRNao;h>o%$fU~nJnk9ZzD$I zYNWr7_#R6k-$uN_>m=VsyvPeH-$vvz#Y4W0xDNTJzm2$ng^_O~-e>3%^O?dS-$w95 zmh`s~yCfpFyNAJBf8Zre~f<(SBr^bSC z?B;IDMjZ8Z!+Q|==kj%5H}o)HH}Fi{89g}%at>m5+W`3cUpMsn5VeD^8+swQ`MROk zUnsc62zvd9jqz5)IsVrTJQ4rvhTa_z(Ep5~MucryfVOnXXAJi;wQs*#a9ZPY34S&J zC4GJ_(WbTAtNp}QR8GJ{ej==PJ&o0#9u#-ziAww*`_)3@j}dw{e2mcR(2o&v^p^+z zcL%+-NIpjB^EW<5Sc+^2eo&@js>rEO{X>G#M_$=`TZC|}ZAm1>Q7;e?` z?e_ykNxLlbx8Dy0LIJ3~{iELxWT5q?zcYy7s{r*qK%=h(VvZX;&uITg%zybFAOyL5 z+whqSiwdi$poTSA7ga8SraRQyoMdH1GPS(4CW)1^vGi+kW#w6= zDd+I-1HSzZz$}Svbo>89zXSNkbla0luyT9yu(hH86FwO@Xv z6{+R;UtNQx+0ROr6>=Tq1r;?b7N>CQm6ui*lxCSzS?hl_gSYok<> zyVvJ_qmRt~=C%M>PpCK-UzqW8jKe<;_#d()^gpfr|8Ld#PuRf^ZM-U`%{SHg#}LZ= zEHer=ekpOf;^15nU&Y9^I2eY!3I`2!_~mtteljLAKkp2vUQu3CSOi^uG(%%A5`tE9 z;eaxzF;^9qIRlKVhAno0`PywjQFXPImZXZ7U?uRX!tzujNh#OO9^m^H78O;cmNxRn zgQ$_a5FgkrMBDeX@}rfNRv=BEQ7&gdab?ApX zc-VPl$eH$VCFe~`Id8lPmKi;1ne`LrfpnNQvk~r0Mqv7r|DKLL^C`d~<(Y1I5$p;w z(qYO8^Q}%hDhB3Top!$-zSU{>>)~6ScE29J)oJ(Z;XgsAeKUWSvCok^ z$#~AvYz50R_esh*fPr~Nh5x1E17sWbPl`KY8d}otuXu#w;}y?T{2j&2TlAAdidl4# zYrS;-ye9Gq}ud&Rrw&;W}2iID8E%;)~Yzy2Qgz0b$ zzSi;vFwOr4U2eamNB*DS`QWfk$LK>+CWiMo4Rtul1vqFnKrjJz2ONw~KfJaarkgz- zGMV%MnsBsxTP~mjW*^e~5;oJrZ~y7^^1)1>GMWRvmHtmZnxk>BYdli8aR?)EfF`{H zf;Do!qv6))`#N68Rzt?}QKy%FJYTjson9Usm!Q8CBYvkspwpY*3HrrIi0Pr5PN!D{ zmN-D?L3FI#??#OHvF{S5-~Og3ml6mrhM&%NHag)A@MOL$znsTKV2J~Ceg{SC1i>2d ztA$&qcc7>LzRdLgo^Ez?JQS|^n)A5&ko4lcpc-Mz$9_!8cPp4>$iqQ%OAE(&E9^7> z(~rkiYfHF`p~yT2GBFZvI|RIrVxC4gK6}J49L=*hgy}wraBOE{#P2BxbiK^Z@#~lM z(%Sm5zW3sgI6x<(UE}*h{9c5gPOk*%@jhaDe@{32W~BEf!ibUdXshaXR<}pL1|jcj zRHey__06^@_YlyDBftd&Ya~5c|Gv7ouwnrgz(101_K5uad|#FO$hz696UYpO;JyEK zy4gcFJ1f>z?aW%yqH1T}3O9Di#KJjemtIg+7(hw)MV-Cw{uWm%cr3NdEM~e-34$n z(MYK?NHfp3@KdT;M?M(Jcp3E>IvW=zaDv&?Js8NKmT}OHJdChGH_9F3gMn}#TG8;` z6h<>R&86@G94k;iMEE#agI3=EHclPgrP{i0hV85(}|9E5eqPb znT9;Bz8s!;Bji!XgCiRMUV|eRuVtL` zOq{HEH)gQXJtvI#@i&ntmVRey?c$#>&V|O&G0sKsq2A18+S5zF-;GYZd;EI(tZ{z| zM^3zsaV|4)`o)7x?F!?_i}S$(^=9UiAMZq;weFLMGd%tR9qZg@;TRb=8m8+_u!8ub zyrS2*ufu0toL2zq&8+qb@u4jB^;iO!OTUMi^bKxLoc7*02kcO9W*xi}znO9B-2F&k zfBZN)>P^yI`kgB*G@XUQL%n$(O64#8Zfe~u*#7`)!7lwyjC%ZTH2mOnaLn7tqHQDF z1^c%@g!HmJj&Z|3Vfc1lS7!JKFH=YFuaxg(t4erxGo8mTL7v^c^$hdmkHI33SZcx`z;ZFwSXjgxZJ zW-YwXWm1c`d5G0%BCxrr2*zn6+yk$6jMY4J1^%~Lhh%u_DmX=Ld-&-;%rInDNkbUK z-UmUHHwI7G+*<+P&Bf(yKNLEir`5?FgtE7~8~>=@d>Z`YruXY+*opJQIjA=?n^3$v zqx3KhiR*u}bu|w$%~t%@mP^0i&IImbuwxB7@z3cPZ5)w!4_<}>^Jt017tv>|TZE`t zPINS^?TBrQ+lpT&Q@!~wOp%Qm>dmG{j^EGgG}jjCRGcc*o9Ppc|Czz&nJ8TPox)b_ zktNleZ$yKS2bq7dY41+Fn)#Qwys)A8b@-2^-|2|O$1>3c#u1O-&o~QB{El(f7Sx+r z9o^&natP|pjFS^z$pp?cj=VTOOT^Oe^cfx>O`kI3D2Pv?que+qIMG^U#4f{}G?#v7 z4YX&!VXh|x_k){<7DC)S#HUDm-uco3-ZGxgoB#avBYZC^Ad>SZVAJ_XI+o$|iK556 z5}9T=Y@q(4L_UYSqY);<>?Ip@!UNzNDf$?3JCq`s=x=zEH2FB(O}8SUY^v;bVn0ID zaY1@+?%d9W2$*2r!F5|#9+iNw4@M#h4ugjRx|sFK(ca8@<;_Ds zM96l7;o0FMT$JehOoiFz;BYrFYPMNTzAx{zE)W_u=)Nq8JIyagUsI0hwjBLcIR;2M z60;FgvadlQP774y|6Eguu9vX!M1str+b#r*e#kWZ`-&O0Wd?0oKghI&+oM@4FW4-* z8JE1y!Voynu!MQgVly->y>fZjISnW z66ybwS2J&{JlklE@NA`)i%RUMoOpBSgv06Fc)jwY8Z>tkvJyGkgj%4y>*0F2-5M8R zB;GcR8HE2()uqMe)>w&^lDU2WS{yAm4$u)2G#Vo}7XC4mm_hIiIM3m>`*xM=|K3%y z{nx-^TwCX#T_zjqj#wHSS8k-)qP~A=#j(7e%eay)Ji>I?HM2Xp!H``byDbz-gPCpc z|6HSJ8bX)l27RSd3B#qRS7u^8Y^a_##s8pT6&^9sQj#UrmB~eg6(wcR$>f654a-e) zd;6*sG`~{isj7vkisBWH-S8foVNl2^t;ut~;nLH8bIEDuSzU7$)2*p2F9IVcUw^GS zRqPn`&$JFG*ECL*B>Yu>vDLV_4%Ez8!redq2|ZI;eL9`;|Ie#TAFg2cx0jkWE8O~P zj8~}jl+z0?8$Hy2Y-wqGdHkl$Rn4gm486m$!iCj?w4O{-t;f3}Rfx+;l|+YalPZb~ zTCt><4W+DMqN=y8OH7ge^K+elhY8GGtv>g2; z4pS3NpP=8i)T#TLx6oZ)QBt@9nOFOH{O?#pTHPZ5^A$n=o7Fy#tX3@De6qN#(rB=w z309OWNBblL#V@;g8p{w_ehK^n5h2?7|FfpW$pdp7)3D`y&H zkprFoZrwuGk?0nZ`MUeB)-B9sn)U)R58>k!PgH!0;#rE%P@GbHregEkoXx9N$*)kn zUhxfz?@|1);@1@aR`I8bd4tM%aT7)1c8Yr_?xUD1u1I(;=OH{tF{fWdewAWQxQhIT ziXT+Wxo8RVbH%?>%oR^0%%_SEDvoi;ZtJ$a;vS0md#QvuR`EQ=)Dw^})C~}>RZJZK zk#lV~;a!SfQv6%RpDA{6>r32binA4S`5Or{MDcNoxlyQunWvav&Wrp)#cLJcpqP7& zO85sAKcV<}#hg%;@EdlYeB-FqWD6^*_;)#ZL*i*e8poFPf@%`@e;+W6m!Q{# zpD2D>@k@%|RQ$2x0H)O>&E|?bD(ijVs4Bn=`T~fTJbu?zf-K&!j0eo zCF!(O+*xs7#X}VrkZ~W`l4)j8kwZ-)&0Q4tP~1;3CwL_;F7FZ70yX`uE$6%FS6f>C z&@ygmhd;Ve&T+)&mYL6AEe`_ocQu9~a~g%rI%#fs7`U}%&c|n4J|5h~GRGZUeu!~7 zQ{3P3Trm4^%E>hUYMm=T)g%8;FmD{JTN<9D9cCFfuOkihD98mkX!0<*+8s9Qkn!oq zc%1at=@q~&Zxuijj&^U$1$4knM|u-rGd*4-NzaUBtPEBoT`Rho7tPT)*i;#pW|MEF z|4X=WkO1cHa^M}3Z)>^MfSM#3$ITj%=)2J!PDW4_E!^1TQw zae&SUcqRzeh+i$-I=$IPHM9f#JdsXsBUs`9ojFKvXn^D!@w*yMo!+@f?|#TwzAWp< za^8xAad@B7d=Hsbgnj0J`tjImZ3*{Rybp|lOpJuv4gs&Dm}BGrn10k!gtJ|uiOTe7 zp2DHeBQN3CFVExe=|`Q9^w{pjNO~_qpwkCslz z?`%P#PJ!@9`cYrB!5YSr7;H%|cf_FKzP^+H|48~#g9i>7ILHJ&vVPPy{=kou$~XCb z&Dxc!JpU|WeaT(Nt$Hk;cWaj$qEFv3Juh!u?VkGDJL(^awrLgG)}&w4yf=0@!Gf(@ z*G;>~G?9DsVpDy!Fw<_RMWfCT$eor;mPn(unPuTd%q*5_E<)nRLepZ_-0I zcuybw``Sx))UN7s>2Z6amrm_;fNNSNYHPag`b8p96WiEpL}b;jeHWwgb=_45$sdd0 z-hMI8cm1xPu3cLb3;eM(ylU60wTT+W-RZ0tvti6#fsJSPZZYE2IfX@qR_kj^liRyo z;7}hdr^|*@?-=9_9u#zLcSl?>JTsQjcksyYcwF6O<-waGPWIqg9X{=W1{u5}IPCi2 z+q&#>?~3?whh4vXwmY}yO#%LDJFG)_d0=FaZ5cn!BI2+PpEFw9Sg?NBg;xanN0??; z1io}9fW);)c?0o$vukYXBUf=bKfS(A%t}2ZAf&ctfEIg}Sv&8Hj`)0Jj zI(Gddrw3!LRt21Snb)-oudiQx-G=H_0k_}w>)K`Xd-b|@%_1(eKq3JrdsWOsda>-j zt8R)S@9pc5pm#kgtK;Qsc5YjD-N<9sKXZWU&Cc45_4OOquHSv&rl^~}=F*)T@7ca? z_htrvZP(^s{Gw*f&JFi$TldR{Us+o}f9v&ET|Wb7bVXppsh4J6UL7lr1r~R^u+xG0 zRXe<8j|5RfC;OqrXLot;lFzra@awDUnRqNZs>ux*Z$!suJKpbaYVPD*(5pju!Ow}`tdLxQ7Bp3?1 zcXNGx{+gX%tYfpgWAlc4>enP*_*v*cZlc%FD<|zI2BhQy6}z;^-Fhb zX#o|(j7xX=F&59*F{%kF24~lO*6pq7>3a+x7z^|ccCEh|4S7TSx*mb2a-37<>{!@i z&YJw5IRkqRAG)C3@P*e5d9P>docM&o*#l9Ymc7UJ&KMEyT3>`ncLlv4`$^4w=C8QR zHjHUA@vmqV8^+As{pF$g%nKlf<6ZOm^4r?CeI)a);KqCWxK}jUa1SD}{O$Z|*wW;> zxuIC^wQCZOgzpMoy7SgY51z7MN38d3oC6v}tbLnk)|UL9ecJat`ly~A0^^Ty+U^fL zHNsh*v3N})V}Dj;n3FRm);7^=NAI(9&TjKoY|YrJ$K(6EwUf-FSTE?U1OiUukW7on(W)t;-+U}zO3Q2_Tu8N z**Pj>`Pl3q+&(sMS$(X-?X!^2g5F2vguJf3uAMsn1)fXp8j%6M!$@W z_sn0o!_RrcJq!Ch(=UJu=om%*-SBBw# zD3tLwZud|i<3?nRZG#ht7ILH9i#`+xe+(FA(9%2Je$_RyIrLJ#Z0a*eRGLMvovC~NkiURB<6F}I}5>mhQ23*n=nSRG&1mV z#H3~^_12ms2Qj-xhVVVdW8oviSeuUbXQpm7ONUc#HA}BWClRrlr9Z_< zM~-3mERXBMMyzHjH;##nqP(5=1*$w^HA_!q+|iULoU9X&Xw;2Nn8BO}u>2E=zGi9U zL~?D5W0}%qmKo|Z53?92(?QMBqhO~H$eai?OR1@Rd1M+MMz+SL6CH0NPhs@vuoY4?PM8G)q}IO#?_L8mayO>b z(p`;;jK^PLg@|Tp3nn0%rJRw8tacwjFkiDYa9fY&4M$G=2h2w_OZzeb z(JcKF%XX#7CqF)iK5N~dBhK*n3|_Z&?#pnDj6Xu3^(I(B`~XCeYuxu>jf?XNL^ist z_6hNeSnBIt*6ZXr*W``d;O3zqd*jE^aigh&cj7AjPph??hA3SuUQ&-nQY_W!M*o?`*Fd%kUO&)p=fma;;g)M$(q&)0QXF);O6xYV$I9q4)d)qBjq* zI*l4An~REIoHoKk@M_0c%|qAWf1B?k8J@ZdPLb#pKE*ISAYhd=ghA{NATV7fPuSdB z&@APR(p}u>3Zd8HL^`=6QTA59z@>{ty0|IG;->fOX4r|J!wV*wr7t1fNDtGHs9DO^ z)jY&BTa88H?INSx`;)tMEU>2klWI471Pb6nFS#~CVpAwnx zZecnDnSZfq?@oLe^Dl9EVMFo1Ap1zlIAZa$nCJrIfNDA8EHv>u#!KlC&C&!5Qfh+b z#5qS1Iny}u;+)WmoMjxt<9yad%8a8Rels2A#sSSzUTk(5=A@}v${J|Te#2Z(2p$DD z51kEh^AMjR?Rn=*3;4)*{>uFK@IMp{aT}gcC^QQR!^H*HgDVg@W7=F~9OgqVBkA(F z)FBk@ej&~?`&tBbvhPGlH~S`VAbT(b!R#rh^H6pK@^JP^JfCc8Xl7)O#{X#c=?IyX zy$m4}**OT4mwg7Z+2LfrhiJ8~({cPM6PBPLPVVl_K;>rk;FZns__0}LPjYXslzH_c_wj-_ z!OR?TU+;B>?@jLKUBGnuko$YpOusLAfOj{`(2tz!9gqK+{mFSAC(1GhkOz7fGR<7_ zAdizmnR(>F-Y=NWKytpvkA^Y_k%u^)e}P2ZW7#dZqfuc;K@rcmoCI~Q-HGrpyUDtn zw!*th5kv%cYS*)XJ?IV7ZMox~^kc|J8plBEa&cDOmZz+19$hQo;8>!Pjta+}!X&PM z15LXfE>`mpeY^AG)j-IBuDj_YxOxo1Klao;IkCve86(NT$zU!xhJWrNQ?db=uRF@9 zATMHRP=R z!RSFn_pS>Tm%_OQ&hOBfT29}q;B1fNx)#y35v~z%_4yFj#?OI|`EDqesnZp3^fmf~ zH`F00m-6UVo#(j5#SJ04Ra-}~aiGY?iysX2U5l&e-pEp)0qWZgk$vY?aCR%LT56q- z(1|N%f*zy;b#ELTru5~#={v`vklmJ`+{Tm5sqYVvk?*{Po|7H7j@RfD`gO%W-#H2w zkIkTtRs0wosO9>mfcr5E+bxA+8yA<q`^~5CEo_s4 zbp`#eqH8x5>IeLUC28#z<17cf1aG&Gy8)cb_Q3_b7g09NJs)4R_Q*gpD22Som-x3H zM^6cnmj$mMK$6!U@B*P5;B&x0_LXuy;YaR%N5>64I_7%5cIWAFiPV*hV6Y|7S3@Hyk9on z^Fr(DS4NON(HhLTrxP#ooqoV}*Dl2XYL#5Wu-)mK?8v1H0l%QFgPE@dG$^I}a+^ zbjVgA+^c?$fn|qQ?m&(oS?PZ;A^2rLy5a}&_F*pkYM2*g=}O6;TOTl1U+be|eP&}F zZ~c~}WAU35mM|$k>GS!_`YiW-+<`Wud}zj-T0mdMfnD>^l?c&}&%ov(-Ve<~>~Wfh zZl##5dI~%{&jt6VyG+1fH|e{3@1U3y(<&a0tVzMpf1?=tlF7omoaG~~MstaOgS z$bZgv86ns6u)w=VrLF87C)lhb`iPFL++egp-U)TaRp8AxE1esEMv*Wvk81d40|S-; zZm=1H_iEqhJC806fdcp`t*dh4=aFve6Aw7M4{!&zY81Uk*csR=0I!}NE^$k=fL;w5 zO>E^CB&Q)2JOUaQwNYw)kh>}5M3ZJ;y8t{+ky-RpP81cZ)A)f~peniiriML4V{ZjRw; z9|ZRUkI*6pMlc#A?qH#JS`_i~m1%XPQ+y9vDI5`coZO)fXbkR26Tx+6Gc<2bk3oj? z9MpZe)3uI*K{%Q!VYg5nMWeNNh0_&cipCx)j@D5$<4|#^jw1g2p3blu8B#DGM><14 zY&hkVZVS_KH#o=toS^l(BN4mrJp!Fl;@u@pCowy1BKV!Dy|0_6F(pGnL5-`U9j zx5j@KE$hEE?SBHsDV63Vr}2FGIXWupO;|=d%$e3u!fAbN2@wEE8S`iS=O_08C$En7 zC>*#DoNAk7aP|~feD6WSUI?qg;8a@6eJQ`X=PU;TaKiXX98Aq-;JgiZA4kMl;Y7Lx z>d5{HPou>Gh!?r5Noghv@B&T^+e$!aj1(0jmbAACIF%LyLrRM!K>4L0kg`1WzLeGu z96_hbtt0F<^4TxKdf!J{ALBqXck2jW`0@bC5;x_U-3HcZAEjs<+9!-?Y7bba_(*HE z!Q>gR&hwE|gno0K$_vJ?_fcRr$ya^kwVPxb;Z#Y#9_e!>2i7ZXzuc$24D`!)8h!}1 z~hSkN#w_$ziBdxD+1f3-->j=1eOuDcVIE`+Jcui#w14H!jPXD&-M76(q1w+WXvU;%0S*X8tv>vH-P zkX~&=(B6#0bxywp*3&-H`lZ2nzk5|5V{roGaX?CIp21nGVclqO2Cp(t z3!Om-71+j9V!DC9fmHmKF_Ty1*Cyah_DLW4$XU4CjGBOnhPmwl<&ge)V zPInc&f$#%}2|%0oIxl&{eKU>s4I4AXv^$#^c(Yhi{zQgiJpt<_A8D~+n1~H6 zWR__tXdy<<=F-G8mszyfWQ<(SnC;RIPj)2P%R0q2DXb;eF`$n(3b6IRt+Z2ksGC_Ib7?-ALbrki8ZBX<7gJv_Cro zGs){rqvb#3X3^sLsRqh`{wb@mLz|R_9!1vv_ zo%k6n2yG=TMPo4=a6k+!UtE@8fYd+BfS;FKXcRMIo0yx)MGE{{^Y_h?lvonEVmz-1YuuFN9McqBQ*RM0 zSt7Yh<6vk%=90|TV9%WY5);d3|J-VL_3XJZPIKENnX@dL;MY8TU2{$SdXl=K{9JRT zLMD%ZsZ0M10-14>j^tr#1*x=zR8nC(tuiesOI<-pomW=htbXc}hkrZrI{3>v1WZjz zT$aqVyhe52#GGNk+$+*0_-E+1EwHJNYExGs(^f(z-AsFC4Y>yFRbYI5oz6FlQs^`E zOT5ywjif0-H*>b9nfBAm)*MUhw^9FA51IQW+|Z(e^-^R8%`gQz*IqI<=b&niF(vn_ zyzvEPujThfeziUAFOZ>Y&)l&H)CxiUbM@~Ozr~(su6n~=9nNfTiok-%6=KbNT~7iz z&KZw>z3>JepH*071G~%ki!&6jNaFMAqRKM6BnQ_%z={Rarca%I@(Ia_6$`kWfm*4f zVSx@VZBUV{PAyIrA&td_#VKcTvbZ|QXGp3fRo#$AYWbp4Su-KeDJ!n5So(jxnnz^? z)?C0&IQSwSTT7)siD#jBV(F9mrx*A5M;G*9PS_5pI9XDTlJcTd zl~aSA^{TO`3ld8$W+Pfy;rLOB$;Fk`6;3&}+*?>xxnwcM4qS)BFFH?&JA5UNLk*%q zCKnc#mt##9L<2b$xV)&=s#GC%2CGU{b1;KdJh0qB<1PG>{K+}JiiSxDOS&v7GP&Z6 zOUnz(Pz>XN94nU~r^6N|SyZ?*g$rqF3{~NzOKa9?X_UIXHKr6!L9z0OJ5aVrPOV&0 zQIb3-RfS!}%o-+D)r(3OAR~V%lS6Kkiqyiwn$o2yzp|j)TnK!4Rwbf(a+&R zYf`(FRk&6Ko1uO-dJI&8_8l(|Xlna*XSu{neemD0c#JLkj0)V$rr{;AYDucF0#|f0ck|=Te@G{R6IfPa?rpR8Uv-Lm zbtVfdR$y;V^k@wo2a>{_h5HC=@RTh<$A+Nn1JIsvw4W8oY>;x zMJe2V$>Z2woa!YdCFp3P;TH*|3=&<^1uDhRfeje+xg- z8o%$tW?7gPfB%Bkf(ie9*dphzTdi;~E&ldJ!*uu~5EVly=d2bD(;<(*!F+om5&Bc! z8yvTC&eBSmIa5o+Fyub48Mh29aVx-CR?eSgB<_V^yb7D}oZ_QlI%LLWI{dAKvsPp? z{cCxv3Qv|asWwf+bjZ-*Fljxkb?@~>}wxGkwl_(=ZHK z(&QAloFj!&x10@6AS~nZ7c2?SIbs^7Ll!xIES2)e{4K-$=Pi9@s*q<+6Z!^gU$NQH zuxkyN#$}x5U(j?K+RcX2V1iJ$&?aauN`oZmG;45xf~Ju+h=S$@)NVG22Ge*YE5>Kz zX)r<4(6zg*c_h?8MAcrdZPgw2Rvee0>Cw$DMGViK;l$8=oH$_9ec~bR^zXjbf8HVf zsYBcqhq#v<;y!d*T3&=24cX+C#2-V*8-#tifn~6h4~j33fN#D=k+KYp@rKrD)D zs}$7(*v3@6)sN0ONdOaTr_XB^p z_k}&$@;KO~mKVe34{{8{$M9X2`G~#OGSvXKTiyYiKfp0Oe|>8Kn@mlGewK&8o@AMi zG3tIZ3?FrCEb}qh5?wy!d~^-B%wHxSvdl-w;^Z(Q;UX=1ab;CFClq8Y}PfI!@eTRvtgH8<}hxRWe(BSTiyiw7Rz_R zeuB(QV91_rpU;6QN3k5T>~;G&<;eGA*!oSJH;zu&>ZEhkZ-QHce{lusjv8 zYb~>lU1zx-_6?R9?pDhj_T6EbL%OHQHcjfGFf5NhD!C}7?1QX>_2)2-ZINL)bUT`i zbK!kY_Ut{#A4nO7Lo~Ka^3^yNTBd9{8F6{}$Wjmd*q`Cq&g;mwoODypp&^xv7?-y* zS@s&{uk#GUA=(Ev47&odXZwoJY#81nO>i(gnfeN34gouok$wVk$r87_4a4E%K+6c? z6j(k3_7pPWc88qo**`>yUhy@SIrO}jjI#AZzGOMCZ8i*ttveL&Qv7o=;<67WOPSxcVZMU>u4UeY zACnQD{WMwfio%cQ!eM9|%Lron9m+X$>u2R0dgfZ@&~uRG;jo8TW*b$SD7Cl#MKHo9nqz&gTr-v(K8_th@knveeHL zlp{?JbDy=${_}my9NKBht4#u@UBGUJxS*M z#lz)06b$bf7irS4=&}Y^7sYIsjLUYyL*nw4-`M7_$kHjDE>t8UlsHDCHb~i+*NU|Vt&XY;R_V= z*(CB}#r$$k#Tr9g*);{4>R`Dt=cnKSq(be^qRLd9&AuV`NtXOU3xaBP}1Q_&CK=6wg)6y_Y1-9_YM;2P!^R@g&8w6;~<7 zCwb{~E?2x!@okEqQ2e~&Un~Al@fV7*>rXnb_KJHd9;~=P@kxs3Dqg6#M)3uTuT=bf z#eY#8h&GfBnhfc3HdEYQaeu{w6?4@Exi0){T=;m!lN6t-c$VVR6&EWmRa~ifiQ;n= zuT{KB@fOARE8d}apW^ovf28>LivOfIjHwwp_ZEsfDekR!h~hDdPf|QbaZ2&oiqBJg zsp4xCn?1yBA9a_KZ&z&g5Vv8TSMoO$zpwZYie1bl%egmI++J}{#RZDTlhKdUoCuaN z#v;m*2h9@27b;$-_(sJ)RJ@aH(|-~y$or9T&NLzT%V$Q>oUsUqfl>9eJ{+^QmPVuK;wg;+P2k~wpbrnrFD$Z)&kXJv&;}y?Wyh8C0$+&(rPbvOLaS$(o5~j1_!HTCUUZnU! z#ms}(od!)M&A0{AjBL})_c95u-^;oyd5+?diVGBtvd5Y&N=5G{|?=r=gDZWzi zX2rKE-lq6r#XnR0yyABh?^nz@Mk!BNaZEAi7$r=5#hhalIp>^(a};yFQRG7uAFG&i zjuM7*lENn`<|l$8pRbtjdLpk@e2!wyS4tQzq$0dd@dm}46mL;{r{en*Kd6}NuSoho zSNw|N*A&00nD3Yp_hZGsSIp1PBn;m@g)`9hg+0YB74w}`!tfJ4Vb0+T^PNR#heG0@b4==pqOi(NEoUu2xB4AG)M5T5qT5ET$V`WofY#dN|6sx%(-Hb zk5GKPV$L;7m{SyU-dN;Z0ZDkF;tIu8iaDPw;m=dNS~2IACCv8}U!|CHAQI+A#kVTH zT`}iIB>ayRKcbkw=Si4diuWjfS@Eli_bKLYf|AaMihrm0E5!lKnMini3XtZeisOpg zDaHaK>G1r`QPSZYj_?4*LllotT%dTI;z^26R?Nk%B>f`AXDa5J^%8~)N(rw}T&tK1 zwMiJRmL+_h;yT4QE51YV-HN%)mZY;&@ovRGQ~a{xR~5gh_+7;xDL$b1pyD9rm!u4y z;^vCmC^nmdqwl8aqU4-UlXSRBqc9hI6z1xQ!pA5cr+9+mlNC=>JWug_#ax_B(yvy` zIXaPFsQ5C)S1P_nG3W6lZoT4L6yK?MtKtV0Kctw;4NIC&DSl4z3yNP=%(aju?mLS2 zEB>A0PZe{yV2S&cVy>4da(vvA<}Af=#o3CFQp|ZsNvDruE}<#%A&R+roXD|qcA8IC z%;i5N4CgI{&rqCFT&j4nV$N+!T&`0me2L=kDdswI5{3)e33E+Q;jN0fox8{%R=h*; z(~6%}{G#GtD*m=WHd-3l(3Y_)5j=6>n60gW_8hbG}#7|B>SR z6muOz3G55AfFH&5oxLWbKifa{LqWHUtuU5Q4ah>9u6?17y zDd#rDI}|^m_*un2SNu!Gzf$~`;`bE)m*P(pQ|DUB6H@FcZmzhE;tq;?E5@p5=``~d z4_7=<@kxrOE1s>mRB^fD8pX>MuT;$Wc{xX}%PD-VVy@09a?aHY->aDGjEelHiXT_Z z#XTj=D~e?fpJSdkm7HsUO8CDh#-r77(HGNTS}r|5NxcpUUxYD~%zu`HIX6L5Z5gjs z&I-#It~s0^U>Mxq&PA3vpGTcS$}xrNth3BKud~cgByO-w6;RF(Fg#V5ZnsR8{vTOR zfFH2j1N@NXT<}iIgTT*P9u4OF0Mq20AD3PsPXSZEi+l>0^8@6m;Qz8b8~mx|A~2UQ zVwe>8pyf(%7?nXe^)>jrJel)_Z7iPy=KKKV7lCsuUk=W-d<}SrW&Rd(jOClaV=UhS zo?!Vd@D$5i!CYsQ>E8#QYxzMi^~5OO4(9Ls6L)uK0Y*&q2;P1jc;{ ze3|7}z-uk<1z&6VH{eZ{-vr-e`EBqP%kP5kw)|T#^#_>#``||{e+=dv0_6w5T;-EY zy~|%%rmo5>mJfnox6HZHw=8pkqy3g!fvG>nblQSBZ$PF#%U71Edl|wzCgs%2ZD!f% zV_F^sIp+!(hI69bEmL=w^9Gck3eK}!2p(#g`Y&9go?%MC<1JGUbFyXX{Z6&aInmjc zYr$t&raothW$KikY57Vpb5(EK^tX zHOn2roGV~>>W+S3xexd=%hV%1Xn7ErdKwH*J=2)w;b7`)P+ow8a{}bCIH>G zet==9OZ!L5)Rq0xGIeXYqYA_H0!J-V|F)Usd@#3+V3=dUoF5<;fD@L-f_qvX59a&; z!>~^sWSJ{p4Y$mBS?b|1%o$+L50I(5exl`a@F|w7!80v$j+XNS3{Sn>BFpSwxd$%g zmw-7xKwb|%$1-(qYb{f^_F~KIYpL7A@Hc|jTdoIl8yU)P1K(tseef2`?1S&N{3!T- z%TIxSVwpO?J1oBp=9~c2q(0Xk%hV<2oB-w2;oWPQbGOtTqMUs&=LE=Kfj_Y9;C?+| z*#rO4au)bY%k9D3tCw-93l_D^KDe1>>Nay8fMNLEK?lq1j}w-u+skyvp=3?xfIO3fSDKj<6_G-V9o|0S}^AX$Txwnu*`nwq>}#K~Onu{*EJwkwS*DKhKFdA9?^&ikHuv~on*G7tw1=Dv z{=)J=@K=@xgQ>g4Fr0s-aXFZ@MwmZc%Xn4mBzITxJjMKtSi(gRl?^nD-F~?pKo?|KDcNB9BB=Rp6NAXM*IrsMwPAKlDc(`JYS0wx?iuoI^ z$QLQDQCzE-;|~eX-)DtyQOt3M$T^-6-lg~@#rqV0r1%TPA+!rgCrdHM3L-a4oWf0$ zujG98OPI-u`TQ1niQ>hI&sEHCrX)O{)57(N?^L`^F_(js@V`*}y5jwcKU3_W50$tv z#YP_(;b^)md7k2tiYF-MGf&dwyMr*_7liqaAk62MFy94)`Aib#^G5i7#XA)5QM_02 zJBkk|{!(!i{gI>}SDaAXPcfeX5`LWGQxvm*moSSI*C?)4e7R!3=8yb8fgotg4jysF z75I=e69>M;b`}^TtElR7OY3W z=QYzqwWiZ!d6+(BH22y5*LV4TGGNHDc}|p!#UJtiK`(meiNe8D;SS)5uPDT57SlY^oqc`d_Tm51n(;`;e^lrt$IC(f|_V>e>;*j*{ zzZHiLw`Rycwx{-Pgd5I;t&#FQ3%4-6+@XFuv%%7SPeGv1BVOf~o9EHm`tdx>a}~Cj zOr*Dg5v`HDUW8kxmq2<9$Mo7-Kc>g;h*a}%HXn_;hD?m4N85JC#%uL4xQ8L+ecciV z^J0CoE$Z~9<38s-EJo7H9Wf*?q0Eu?)E+T(s11MQJ+(=q#@W%cK)=hrat-Qd7<6m{edgOqrxY}-iTeCz!%NlrDL|Y*zLYL@ck|q zV9*$K){NQKVwbyj;QlUOe$cPUgGcxI8R+%xG4RuJ|R0WzMIqcqb+CeiCvog#?!ZZ!yars2tmE= z!C1#_L2RA8G{Q2{pNI_!$x}5O*qO8(zPWbiXmR%FY z_QYYTD>*pj@qa!TJFe4#7`ON~_tW3nAD8`ihz+1w!hB-~GWT2?TzFqz;Os!6ev=Kk zL%}W;CEs93nDMrS$UeBCjLRSi1~NF}3%U_1dIjBRJ%R=U;j<}>hPmQ>Fq&~4tx%YA zFTqg8GjN4ChZ$_Ml>b8+ycrRfjLV@ITgsI~fFyC1*Jv z6AFxGQDX}rar5xce~NCp5yGa}04$F{(`-5R{4y?gT2pM3W;Vy=%yjcJ9d`&5bmyUF z&H`jr&^3lKrpU|ZZsK6DDYsi2Lt0FL&(#9~mhu~^a?6~8Z*sFA4 z$zS96oDP&~JcDufq!uidadBYYf_uRk7i+i$c3L}OHDVluqa`1z?gW;pKQe5ws06tg zCujOw;Dn6hCOBHMPJL%9w8mCtaB^xXekEWQ(&8LdYkwcCHlJCUb)yEDV>ra|ZiH8; z?Mk>q*Sce1wc|ge-NNnBtd$pRmfeio<7A;v4cJYQ@Kgyl?2i=E`zD2(JD%ALDALp6 zen}a67a^>yU^gwk;b{^ukJk6A|9WHmn zW0cV4ZVO#wZ4#cGu$Hn9RB~$B2?Qp<@*0E_1 zQi1P5i`|bO!=#6QOwu$wXBsUDFs)7pm<|U@M2i8i9=rI?1@Iogem1{>^_GwLZw%Yz zIXGnFhi%{&lpAOao}vy@!fN%jHW{2oYm33zv|jV2ufy`|U>eUl$CPIp&y$nb>vC8On^ z?&-Ad@TI&C{+aWV8uRs;&Z~zfBeEmq+Ps!(11Y$^2F<~73uAQJy=n(qOf8Bo(fpw zfh*Bsjd!3d4v*rh#o^Hbo0AI;=5okfCRtXU20L7^-K%4x=I=qLi%W0RbRfWcyuMG>XDmfR>ZB%k|E{C5`I*MIr z+q%uFuw3Yw+c#k2hKhv=^N)34gKz<2U4`itna%pJHc)ys;KO347W&EBQ~GCD3gtqh zsgi_UkhWpz(1vAT|E;TfO0P>>b-PX|$M1o&V6h9M%|Uio92~CDV60~b798s^%p4p{ zBZ`9^{n0oW{%RZ?9+7{5L&ETh!?z~NA5?Naw^~~{A3IGg^YPQc@@KHamj48s`Rt$E`+a z>x8F{3i;%q0sAk=NepFz=CU;if~ay{JQ_Bv{~y*OY=`s6!@(C$u07ZVEXJIxza>rj zQSvp<2>8ju&3;V2k)yfN;#{1)si5Ow z*C3)Hdp0l5I4}%v$a5@jfz1gA%9(GiW!~f$D*mozSkASU8J=TP#@!10F3Y^ZIP9dH zH~db^4A1us%ICs<%QC~iYndIve#Klrhv8}HN9N5R!a-(dVaEGlb{3{%0JE<8*f6ZC zewNuO(6mC&z?+@*MUKPfA?qOVn!8AchJ#ws-|M0{hm5%WVDpf;d1MQxJ>a1 z#kGpf1QkyXW+M(szg{uhjL7d(yj}566+fx?S;fyQ{-xqK6u+(beZ{|1{0GHfD&{>X zyo%r6(<#&-+68L3MH>5lNRk_=k#lze_sX6jR4To19%zi_dI;O(y6jN73vdpyqXt@(?z7aBfH((RXJ-~ckQ{D?~#_iyKU_QGk z=Xk8E<-uS+$0;8IX8%JT2Ie!JJPLfY<w7eX=*fO69OD)%e&$WCpc$MX=!D}pE3ugbr^f~6b+VU3g^_I7S z+5a%i{ovay^S$6s%MXL^wal?R`yYni34YY_6W}K-KMQ7`!!R84zhs&3HLqEI3%t+r zyWsaMe+Xuu!?>S;|7`hBV7|>$9)gU04w=su{+>$an4kR&nePEzEyuw*mU;aLSmt%+ zc!uHmPQdk$$+_SH%frFrE%P0VI&2JcEO@GAzEjM!JPu4FI+L0?e35%Wzf*Kqa<)YY zGg2|zkjSSip0Bt}G24xV=lDT*t>R6J*(M|m+kx;7#d{R*Rm|~#gg>D8OT|&ti-h6z z5KbuOH4r)LU6^$$j3oadlRzj$Gm}1ykdGroutu2rA>;xp@7L0Q2kQVg2XY{(;JTTY7ma;u}_oqSRO{FjOKim7Tw}J8XU!Oq;TU@9H3K+1PTb& zNcq@b>GIu)`GD1sv3%^Z>BsYBeN?9;F!ZI~4+*US1siDGJN<_zENG6@euV z&{++SQG3(u^s=lU%Xupf#>vA$vkDJ5jy1&4 zkH=PPOSmQ|)EEh5{TOaL4*TdezLOA+ZB-1z(6Emdru#yKV>=Tgetb93=iww8?hnpM zNWGZ;KqABbF4FtD>-(aOQ((i!5`H+=3ocj++Sc-}fKUCKbUFZkaa?}=sy>lD6TU8#f1Uo8 z9#jJP9jXUKSx+V3g9gFti~laaGjo>$`}-1SyzxNghr;|p2HHz}oq!(HF}NJigL(=6 z&}I4)U4bw^FM=KvTNCu4*tvuzAb7y*LF7O+5Iddt3d3ie&v2nI7gq~yW7J-hgqOfG zRO0pnM?%39`97Ob$q19z5NQQG!4p1(z~kqV!HLY= z@$Mi`;lnWGg!rv!@Z=ZhSkL69Eds_up>{a!a2t*ukW^bF)%0d?yKsLF&OCml6V4?% z&9Fgd*eEWAJbq;4bJV*Wo<7GsZf@^$RBB}{tE0zHP{N~`PQuCh3zKuh6GkJV$CuskM54b#Q20c0Z3}+r8J^5CL+2=u zflj6)Eqzb!_zK@<=5DBqT?-M5;Oc0xr8aqTn~BF`#E{m?cg=2 z8>STHD;5u%Wb@D#I9fIjv2vPrK|0ZJHD8Uq_mFV7hUj?gXTwWO`bcLCT&=h)*MV@A zo51_r+a(jf27ZirVieT|B!L&+}Dx7{`eF+>P^xg zp)Oy8v+2<&{G#xEr{J`jC2>;sn_6#%{ZPXXuuenGlFOX%kBL#QH}iRL0yySf!lG>> zH*1zGTHu7Y{|M=2dF7CVf5PzXJdV}FkMJ^e^w^%lJNZB1{e=AZcaUdy?|O!Ll3!Ei zc=xgbJli{tWq6DI%sg)u{5 ziPMG_8%bN9Pg|ZyTjQi0wOIo%beT^hdh-yg(?no%Q4x&OMz|GT?HH?h=mPw2a}ko^ zsjJ`=we8`j&u>gklB|-3Fo^vU1g6X637dN>;Jf*Wr|pNrIXtaSZcmiG)h7Ilg}b<1 zo+)m6zix(|cs@_KyJ@hYcm|{NFbye+Y}mS*hnQw7KAYQxN4YmJ0e;jTKGv`k=hu(n z(Z&&px8h|ea0erFEIx@oV_iNyvYaSocOkYdZY#dQXN70FT=^)zkfoU8njSg6gV$-U zEmBXMVfZxT6OF&YVDn6r7)r+Atv*LCr-bLb>(SujZ!*hb)83uXFrSox+=~TNi zz3^=m`KQ~BpRz_annFJ!(zYa={aZNA?w9cjM}nsC-%uykD#(VZ2O4SXdfw6AF&=-j z&1g`3#qHy|6I)T5*#)YzxfsSbX{Ew?4PmJy8>6Bv`c7!lHfu<*83IL_y01ywT(ohs zOt7%zi}js@&1^7Sw3e-%UhUCv(`kiS4E*S80-@N<5bHpjq^+|}YqwW>zr1b3M%A~S zukqWS9*p0iu`X;QrQ2+%>)HZPd$*%#&@x^prCQrrJfKLOPVR6W-b7=i-7bjbv~UL^ zv93DSNK>wEX_3{@Wv1N+IHTM9r_0kCiRv(>GyX&KlU4#pW5wCNkc`8D0QheVn=u*; z4BC}7;{{-I_A=ny?;?`>7hEkD24cGZu8vu0<-b~Ms|Nei_b;s|E?ZKP%B@~e{SDK% z%94j^MCLB8sys8-Do>`W7Z1!E-al2gp#ReR5xEGQyRf+UaNk_B$#SkO)xWMp(8f&F znD?<_Ry8+mhh`=&MUt9f)nIhY*r~iEwE&DOCmNf+xU>>d+$ZP=%(V@^2(`jP)eot9 zi0g^}P4GWr6$*WYM<_+&HAfT`8PZo^L`Z}~BS@B1S0)z~R+Mm`YHF-ucY3(;hdaqs zd8%q*s-k!Wlmn|vD@w6xbYV?ud1*}^cC;>r-fDSKvbqK$I;)Ml+6o#p-Wn;uymTSo zQRoRW)csv2uCCUK<}6`8_UE@5GpR8?UQ z_hd1y;=;-*Txk@ayWX3#Z+z{l*d|H}YjExr{_gdQDywP|jRWxv3d_u1=E=h9;)eaj z{bHh!D1fsJr^CA9iQ0-C1TS25)BK(B6DJ>!MpaeHw#AFKB2|cbC@-xpcG6mv#sj<4 zORGf4>XK4i6gE`UJ~N<#by+F5JD+^=*h$H$$B&&cb=t(4$0w&Z)Qi!9OsX?7b!~Dr zyR|2)&Gk(Bg~H`zlV{?|>P8~}#!31+(3cmfYm8n6?S>o7OMTq*iN4LEiE(~$HR}cwz#sIr9ca*sPr{S{TgAbEJu^TWlAl_ ze{9HFQ+ZahtdP~Ppu+S!eqEyN;NnXUh4zK63a>uN!V(l!^noG7MNcuGZ`ds!))hBW zX6JoWiGr1~K1>y`>X(_SH#cIkY-oO=-=fgEk_(ogHvd_5*JOo%4UuwbbqOoNT!Dt> zSzK1h4#M_3tc3C+-R&$Mg4>e?EC09ec#m0XV`%dUE=F`?ImYF~f;MI{ovt_%IB2LF zn}FR82g7jWDq&=>z!B)Tx}vNEYyJ^kQ3*@?f8##Y7-k!jz<=t7w(*_jKj)x13>8B+ z--;5}W_UdxO@HZB2B7CtHL%Oz}a*F}L9yIpr_s+gWiR#bXqoqsGa`ZLR#j-#hnAP67y6t@bDP^JeCI&pr3tW$w(}nfIMDeH9+9 z@MMK&DO{s)t-|*x{Bwo3Doh`8Qnwun|5f1#4t~)|S2$bYZVC@j_y~nZD?D4_#R@N1 z_;Q8mUrp-pLxuTIkjNiZ_*sR2ukgDH|3l$aoG`==A215;s_;04rzpHcVg83Lc~>dS zhod52r|^9WZ&LU}g+Ei+$9YKXBo*$VaFN2p6ke=wI!;nzr@g`j3LmWSP=)D7Px4kO zyhvgC(-)mp3e)GE$m#oD@K%LiQ1}gn>7P#YQ*aRyoS|?Bh3RWvbPiFN{^dnZ|8aup zJ6`aq3NKOke1+ds_1b7rmu6!dyB%4C`?;&eZ(*fF{>qV{0$%C9EI~0#;$W*t`K-# zmb&q}EOs8|In&npNnmoS7=CLp4p-+ji!qd)w=CwA<4+dzdj6rsN#MU(+!>g*X_Iq} zxW)X#tGUITdoZ2LP+$hlFBfdC>Cj=|gkS2Mr?8$UaDE~>r3#Nz7;v9L5?W|d0}d1W zPy+W6LwhX5#aI|tViLxB@NY@xXBykV`K7kU`W=Zyg4p9Td2Mei?5%^0_PAffUVmWP zqm1FQU=yyH#xMvAhS^^AhCxU206MF%6cgAW^=r&wnvZAD%b~;i;cyJ=Hvw4Ndm8bl zSrHo~?Rdm#yV%M0Z~(EdB#7R82z0rd zaD%{o!g5)jlzTp~7MtiqmVV*)P4F70W??;kxrg6E)Zbh#b?nz1@lOTEzK*0SdVIK5& zyh@-R!xLBpGk!bt)b0(_wjfQn&Akg-7Wfdn>)z1{;4v7Dr&347x( z6%`c~2AX^4FpcI-EGiL<=iPIdz)xyOSV9)XSz7AQ0oA2VH)Ls26Lh#w_QY2*{lLaI zPn!EXAhXTER(MSOwg>wPYxhNW-7+CiIV$c`AUC=lI1IrpC9s--l5*lm^I)ljYDE%z7iP}maoKjH}=d| z;@eLlU#X5pEnkVQ9z(toxsjHy#32*%l{m)@`AU4bqZ$8v7QWI;$h8~3(j^od?ovE) zBGiSibS8}%`M&U#u0u}YD_w#f5xx>#%L`xWLCP&(X%MdO!dF_4Mhjo5me}%@YFPuz zS87i?majy&)Ie5IeE0>W1^J!bhzRWva^A97557`9>DeZ=!;GS6=L zO21$?3t#C8<`KTqY0R@*zS2^r2w&-R<`KTqtBeR=i8t^eU+M3R2w&+B+;75H8ps+5 zUx^OzL%tICK*(2OhlhNn-!me7rAHVMzLNRJU-(LV)hO18uXGqHzt4Q7ztgnkD=lQz zcEeYyppNA$ea2Q=zS3_gw|u1)lv}>i>8zCHE8WAMw0xycXn#NWN_W$~tOjx<&^IqUx~Nk-$uSt4>rs4l`cm2gnT7)EDK+WHzXln zDZwmz=PU8!ogrW8IYxx9i;%C>oDtzG8M2%3mFCib@RfS8 zio#dw#T4Ny@ge2c$5-OxFUwcDo^Z9H{-8)RQF2#z#T1}D|FLyPB+(LvY|KW@Ewbe* zIqk?=Og+Nn#7xV{!Q!swO>{>-kv*S)=Nf|SJ^)OT%$*|4e1pk+F604?j>s~Ol9f<6 zz&QFE7)O>F)qrudE8oa6hwAx8iYAoY15JnzHNXPmCYW#2BOf9r@F@d!DS{nPKnI(6 zu=+C&g^2SrtPgO4z5z~9*+Tq1hR!Dq0z4n=sV~V2dfc#o$oLTsP#Unfc5AnPTp#?| z|CMlj4lsAVh0GoE$Lqqm9B~!XNptviPAf#0sOCXa#&S92j{IkG5>lz zz{$a@VC;tkRtN_;IYB=h;N%4TaDbB&^uqy8PS6kE1y0VMcsK>PxXF34A2FwS2!{a6 zHD#!hAEPk8_aOQe#P)o9fx@&Uycb@h1yfb9=GB<%7gq>omTK$6Yn$jBj-r+S8q-+e z&pdB29{q;CmN;kGZsoM`w#B^83zw!3FoW=3G&b`GTh{(^V2sgySS6u@YBk`x$V{Et z<=IAnY6Yy3~`yc1BUjxSzJsZ!gko3f-UW_55-=8VA`XM z;q+h=u9?O#2n%-oUiDZX$pdJ0G;EINRJm11TKU?Fw_154s(tuskHgPy4-Pi z)Gqst^_OzbS9t)PmN-a~1U5)nwTNqb%V94MGPa|+O{3lGu}B_3r!VY%pacT1LYlU> z4)(@DMtdBGQoq}PnTK^}$icxy-lYVlak~U*PB_<^UCnUPH*c;bn3Mzk`7{gZV)%)v#vmTIG_QrMT)3^V?fE=@Tu1i%9 z6of|c*oSY4J^Jf0$@{PZ2WI73`1P43yqBf;&hVAdqLy2tbm(*8m9e7SRCJEPZc*R! zI=4;R(fqv3)N6Od*KVE&F?cg8G7~E<%6#!tXMJR2N+9allz$%{XFVIoU{NtSm-tRR#AGA!;a^|-<<=yzVOsYgpwk6%eWTB05;S&x*B zk-*LnQ;(uZ`(+nJ`ldL$&DJvoUui>M?TP1e4$_3rgP~zUE!HcrhUl(B_o4KZ zv9k$JLLCC04-EByp=OUF(eiw}E=<*aiD)u~u zMxjvC5cnl(j)E-DC+M+&=i~i^6&TM#quw2~5b%7wzYsUz`7~Jzb6l*+hJK027qUDb z?=e;};Q4s`XEC z399#i21{1Xz_-acQbEQZBO!W(4 zhD}%M6t%JHbUi&hpi4RtJ}anan0Aj*OxQknWrF zY-fWV{}?tn&kWe8KZaTI%|N0DB#y51C~aouqF(fXl!obF;AiMCgPp)<(BUSM>QCVD zQ|u0cwih@`5=K!I%Gw~et!`!q7l$G|AWfph3t0>Cfb<4Zz$jubME#pk^N>+woH|W5 zSwas;Ls29dMW4}550*d8jCaSsnXQ@ba>qt}UfIAXGFL5s6^+g?5#LW|WTwfV?N6hD zS*Gkf|4LS*(x?^q%V=P>i4^+q`9ek!trhu4Fr~^wiv2N+%rTKtrwMm9PZ_4s^nk=3 zXv_14*`E;bHa|W3sOf25uiEm+ml05G5__9<8FI#cihfG%&pp!aIMfu*gxE_AoQk-s z@v$+>D4N7E%g}xXJ~29p3ETtOx1dJu$;{=B>3|M$dScm%5<2pNvSFDQtfKs z&KF^IB&#I9%;VI$d7!6D8baPnV4 zTO;|bcaWp&oh&Og#q8BDa1DjK$&~spr$z(EO)>q|)Ku*uDouNcir0H;!s$gkL^Tx; zQ3>rK%B$C0dX*HD_MrCd8@VVot<(JfQ?qIpM^f*Z+B^{%3l%7YYrK_N>Y<5{bL zH>eSr4O~)nu6G)hXD!3k)!}XF3MxNz83o@{ffuPRp-9ogy6%A^!2+ViA@j+A6Avl{jV<~0edE(32twqi{EGU?pR2)=*Kql}&egg|i zeH)t{0mRw_&NwmZ5pXcrAU8~mMp3PZ^JAJk;NNOjmn&bZf2*&E#`ZEuYY~1G6L*&4 zvI-FIbvN+>ArL;zX=Sn9$bwWi(4)Jn@bjD|Cnf3i_Ja?6(td^!rZC-p^^@QBgtb)E z2su)MubZ0M1z#)OwT|$tMPY+FHmHxScLUj1SjXKs^qMxS0sfm5rp8Re(K9nzl3fgwrszv}R-dWNZ(_+BfkhJU&mvKZmcEle?v&Gv^pc)&N< zo_<qdvjJTUxz$I`UR=T*GNvwLZSTCEmmIC^U}yjLW=T9f^g$@V*uP#0J~R6t|c? zg<*H3LQL+RTr8Z7G2j-?V3Bu4oHi&gz|sK=^?A35Ikdriaw0mMiFUN|v#{j^kNTXF zGLXPni!Jjq?K&({)-Awd=T;^Ek&>GmM8s*6cYIQZKPVl}HKh)`&Excv`ZBp>TfTE- zNp`G+FZ1nO$;<8kB3IJvblZpwY&mcwFy2if*fP$iDGVIA$fv0%mYqZ`GiHi}m@ ziZ4gJ7Rw4Ow09A<5@^r(SL0kmpL6K>QOAQTp}I7hlae86nrmj@D$|@(cbzlAl3ZQ) zaMlf`6b)UsxqMKBz=KG5o9s*R&&Csn=p>a+p3*Uoo?1bGz_z;hpPzyMsk!{)7J>W2 zwL7JNxE-Zn3uRMLFBVdtl0E zVtbvHGhZDs%87)iGA*6l{5OP92s*oUna3n{t$O7Pj*h zUPKIib}wB14-?uvK*V`>-U;e~m_W45= z^MwDf!vBvLHrXe{(%$E+4le}1BZdyg3$e8KBg#=vULZbI_;X_D7hy{*?FIa=bBSwF zCigFSR>Y}TzG^Np_n+{@dMi9Y;UNlhEQvnHkKjoPPf_?(g*kpipJPVw3Wcv!nBzfo z?p63{g>Tj#hmJuQjWH#C@^$<7i{m6HW%&y8rFfASDLh}U?@C6FfQHAK#DZF0c2Nix^;nx-BXNAPhzZ8x~>*cK!&Q-X#!h;nap)mhe z6Z`y!O7MJz&sO+yg@2*&;|jl_@cRmrRw4Guu@T%-;f@M-SNKGQXDED*!WS!ijlydc zzFXnf6+Rs&IH}M13SXh{8instc#Fc%DZE|b_Z0r8!dYqc<>o8gSK-4I9;xsYh36=I zhQb#re3imCD}1-Y4=KD=;TII<2Suc>K2Z4Bc)fh0!qbRx%rndc7Vhp@lw)DISmEyx zCj$9uVw<-Pn0av+ICm(WpAchV*g$OcA5-`>g+Em|1OJIhS?!2z-j2X>?dwZ9@-Q5t z^oJ=-Ua07dCAM}>0Hz(zO{OUQ*-C$&(yvwcB86{Kc!R=^6WhLeS>bmS{#fBC{`V98 z_6iSB_$YBELrA8x_7;Va^vt|2~B|Zxs126~>{zSD%o-;G99mF!1g;?b;{g z4y(g?{zn#bYW#9wX;jd?_$L&qn?0fUmLmCg3`Y zZw2O`*VMTa_&$rdPad-PXTV!5-T?fR#lHaFW-;gXZ&>^y@Ou`&4g9Iayr0@>@n3;c za1vsm+Dg2?r zpDD}-USiW%7%KY|lF(w;@_1q3J=9=>f>qRF@}-H3ZTzb2;QQUYC1if4;g)Kb_aNp& zCJ*HRjUKn%EG}jQp%f>viP#Uc$Lo&RV|{3!GKM9Ls31|E-{M&IrZ)^al80t!ub99F zmdn6T?MS|t%ALKkdgK>Y#Qr#8y4Ct#KO?7CB|PYz+5wp%RP20 zdcVdAx&$%_qW1s<=>9OIX9dp#L_j@;C$I=+{3z&goJo+hEfDB-6dx4yE8D?GTTEj+ z%<+w_gi)}U6eAD{+4w`v$UqhW~s%;TCi zXpjBPv8e6wAr<$L1hH5D9t7Mk;7y3Vy$3O{U%$S1T>@e6??L!Ul!i+1*yq(V+wfXU z#Ho7fJ^6QhXfL5yv>C71l9tA zb;?U2-V^wn*#vGu!}kQ}D-`buu;=lfz;QGgjRhV-OAv|CF`Io);Fo~mdjjt;@%!jI z`DQet^eAd8XUJ%K4S7rZC%4@krJ z1RDDT^^8Z!UEdR!&rJ3`fxsUq8|!)3q7V1|J%Q^`3wcj~QyqCv;77D>-xGL{a{HbD zZ-3=Ifm_gIc~790*uEz~7yI&_0Eec$C-67QM4Jq-qq~Mz#piW z!A{vHf1oU@*t?td1Am|%zbUaBf1qCA50v_&y)LYSW$y?6KzX^F=pDp5SoVH7d;Cr6 zTlT*BU~v-G1NOd&G8qh9ew-HP(L0gd`U7P`{r8JcMy!pA+6;}qUwk1HehnjmQ$?dr zk#M)~L6Twb*MGm5Iwjd*Av4{VTE-_;YDM z*!$KWC{v33UQ7}8{t!k&_CALQzh7(`y&vB%wgaZ|_lsjS=m6^vG(vbo$lm8fz+F8M zQ-Hu9Xeq}mLpE9QrA%x(-JwYYTvr#z$#DN2fwCu9?rt*+(~_&2a@kz&_6em3m)4Osv`G_)f7z zv8Ou-nH>9Dam-0Qw_Zb&yQ78Y?12{E6}u74Yi`V})6rf-Ibccy1#XVU641km#s&%8 za2nc>H;xIuy)&=_)@os6LVt|&i1QN{g&*K(|Cc%1U#YXvz_sYvWLLw@DA#A>r84Vs zRG85Lk(=yld~Fy)VON7oP4}b?K4V6}(_^3V)RE*4Ho7|8$SbfhB|>T?FdKz-r_ z7V66rG0G2cb=e6vd>6i5+|;&}gN9sL4lW6N4xNvMgGkc*Ng}pPH(c7l^KXN*Pw--i zJ-;_d!FdUB{lQ}4x^mv@+K0Lvj3VdFnvW68y70euVh(ux^OzHec_$I}~_PnQk zl#YU2t|^9-$cr7qES2{(h0i0lc5YOdd4$`=>!@I=3f7#s93|&9TXcAB6I`e;pOTB5 z&r}5uS9pZN=K9DL0_Pyo51cwk-c7s~;M~W+KeNbPVtB@4JmL+%IUED#|5en%Giv8e zi!p65-+85+?fcZqIq#qYIm$T?;d2&ZGe5DIZEa_9Z(w?}q7LUEy)EYaq@TrnCdlwj z^QwYc?0ubNU9s5RU^oKoFA4GtvoT+3dFy(f3iDHs`S{;~wpWa}+?W6wJ#IMBkhI2prR!jCU;MT%ZQ?lhiV+wUxKLr1)ei^pNdz{C-h9Ma z*J3L#z+L1jV77z%OWJWhu;c-B_|4-afen&Yi@3J80rv7BqdolB5!!3aSGpVaig1ib z5PMhIJjFKQ71+BEnD%&1kow&Q%shoy7~aNRa(^E1HZYCLJ$5U4?K1a`uXGahcuY%> z`aJ=GV5VIOJ+*tov@J-}{jv)DHuf*u(aNSV&heq`eINFgKqf)bo`XQ!TMc{Eqdg3r zuwNSUl`?Vid>!c$#2&Y*`<+jqw=aHMhvB&7xm<$S>pgH_ACQm2us6O^pMHh*qsDvZ zE8WAB2oCuErqEsaN>Z0SZ3mRYiKUl1dgihzQ)-@El$^P2LKkPkX3J{Ip4zSHmY6du zvU0$Zl)oL-c75u-b+t7a|J-g}3i&xBkvNTY^`ogPY z6WfTdRp74VC>yyu@sI`iZPVUqzMxg=weQ5&J~}bTv?Ar~RJ?4lK6X(HD`?TB>5%q| z6W6XC;T&~CYO3cXR$P4Hh1b5aB4x_8n?798Vtwky_(d(Qw-l>6O;@zI&Ru!u9g&Mt zZa8DricJ@MyfYUCz0o`u1-(&U(9CNislVCjMRJdFrgYsz5*EkYo;X-dU5q21Seq9* zm*D{d#~aq}1RPiH57DTr1BpXL25_x7&cPAjr)9ylB8e#yNgEE`dY`QSf;PBT8>ksi zymoniZn-Xje+2Jkq0wlmMoZ zP#qCZtqpV! zc;bmV(c4*-QGa6OE>>hLPqxuosKi?LfB>FaJHb%1jll5KdI2`xSf=(SgbT@2ExRh} z#VEE6tREmTz@FC$4Qjx^T8Ts-Oo)EiHp#(iH5OBG6!aD_7+9@PsP`k3APlTwv~C$# zuTgFpSnt#Npb|(tuPYiO3@j4Fg@Khv9qXy}d(=6M`q|z}$`2<_IvMX_Lk8A(mVCX7 zlo5nxRDpp-T-#y>YcY~_##_xpsWgg_sOvPD1sR=mnufqrYat2(18XhKnI0QQ=y--^ zVHsFA)53&xkjK405}!au-U{>$Ej8JI6&GtVJ<9JNw@i<+bDCWb`(R+vi=4+ZZLEgS z*`24>K1fK$u00Vs0#B_*a}SC?>UQ?NJnJK5g zkMpGiPpxD=6#3UOa=CjrB7^-indb_lR_u>t%GK^@qzv=9ufg@=4leacMF-c5dvK(m zLen?8H=u6Y{2gr1O{Ndt^8Ze?HSS~>*x}D(q|TV8r&jK%X7^$RuGiBjDDc!;zt?_R z0!t0JUS_XZu9w+s4Y*!vuUW2_*=rlkUi1FNYCSv)>!kNQ>$~}1C^OG{o0WRBJE~sb zb!UffJr1~scQ>2<7@d!br&ikU-@I%gy8bEFaxgI50RNiREcTwI{b%Mvf0%ax^FDhH zuy|@^-cs*)mb;DmqrKV0FVzB%^KN7vwv)X&(c8pceuL+;$(|uwzDa${_2M9D!}hdc zL)w@qlhK=>APML3!;zRCWp^547Ke+*(v~vb6r(IqgV2O?%g!3Oxo+HQd$DV|bJefnMk15KYHqDsM6X-&D*8DQz)uXWZF1Js{}9{|JTvoR94JAg;x0sj~%= z=p6KL*HjLxTU@$>%_2FntMT=Hs}XelDYW6Rm5Bu}a!{wHuvy&(BY*4%ta`BHyK_** z(+`0lJz9dqgBC#0D>i-1S5(lMXkUnpCHKxyAzjt_NJYrWR*iJG3ob&a?-M zuKA$Ep@|Wh=G)tiNOdYT3x6`JRP=Z!_+k|X9-_&HPG58CquIE>&#m_ktKGTQv-a{8 zYp;ulS;el6UA`9V%Gv7{a{EFru-!u~h(=`6SL{Jriz1ru5ek*J*q))#*yE5xNMZpg zkehrg0kw~42o@x8!yz9e5bX#OxZ%mGAsG-tT#T7>JU8a-R{uP#D@1|a3A7ZX@`;iO zS7Ln~7T1};O^|wmNy2I~mZ!0}#y7Q*)@PW=JDHyasoZS9l7e^h){tiZ29`8@04ce| z$z8+9AFwDhn-C2wPvYh|EUC_7c(Tb}18BlptXYI>{QnryXspjQqOgj5ri$Yn0cQ~# z*a`_G?nlhi+x=%k&R;NZ_O2|Io{Rbq?2T8cde59TZP(P^UxokIT^Wm(8B5q9i4 z^B+INfHkMjuc!{7Aprs6oDG*+bLWLp^nW16Rm1H5ltbK}iECe5&J z;Gz~xN~V%Z>6+AtAy-D=+SO`;ZfX7A;(BI@mGu;q-EI zaPfAdtSo2%JRaAeXqFQ=5OxA{bcM`>;P@s&lTD4SEhWbyQB*r=$$r?1MYD=MH~Hf`QQ#>y6zS1p7(q^F{lxRGHk zf@39Ugkk2g+vY5+LQ+tP>Kf2NPc8cb&$s2%S;}tsr(f>kw#SPnt{KyMTUx2~!GGlO zHay`~4d`E9#@#e+p6R#BnPoE;qQ8$iZhZ2Hq?r*Ud(I*296erDo$NU?*>e;&TxQIj z*K_K^%BmW6+}vPaV~|x=Pv;Oa`>3XJPK7a#>vrH+d|K7K>PExWxSZV84=xPy{$B!UQ>Y`Z1xm~mvht+M+{09Oj|Ioy1HiGysDnZ9hIz)%$?b@Pp`h<>h?Ui zU(cES2h8X*pm0Xd>6Hs=PVW{p%RHq`VzR|4*TkBNxz*)mBj(PS=ZqgaysTvC*ij?L zj~iY#a>TgdV@gJj9a7k|WatR2gV|Y+U}Jb}YRcvac@?(`W^Tu=5LP)&X26Z6nLP8J zE*A^`&f)*=#GLMOHb~4lF9Y?7`5!aoymQ9wguyehW%<;Zg+=7mN?rrp0Soi;4jK;| z4Cbtvfq98JAEgdwt_+kDvpx|l8?f}mLLJVD8K^_d|L`d1O?HOGGMA;!caCt2CN~%t z&R=%28zg)eIJbQABY|Ur<4XeL97_@ym;X^YZphIcA&J;B{rE=lNsZ#u8^x;{#g{jV z^LeZU+9$`i{_?xm%c)W@C$RbpWSPCRg!80&Ca_F6_cTLmG}qt_$8LO?2elR-xja6F zL(F51xAY9=$r}$$1h!B7-1@|LTEW2clgkwX_m7Kb1Pn^DdTjGQr57c8`p7{Q4 zF~}z5lTP}R0$-w?{nHPcW6nA1llYkJQ1#z7gC;;ar7#E6jg#M887F#p>Z{ox9aQMgRuDuqv1_yUEmRQPs}M$4OW{KmE>(EE!c!Gqr0_C@S1Ej>!gnfszrv3w{EWh{Dg0-J z>Elk?5{uVk!wa|Phq+3Ay28teaeOkY0G4ael}g9(#Sv#%ujHGFt^8SqUsw2TVq1p~ zmHe+tzEjDY;|5V|W-FXSZ0+@OVRA!hL+=RLMyPN4*M zP&iNF0)_i3JV0U2Z^TZC!ebTYA3mbPxq;xR3ZJI%LWR##xK?5QT`zVxXApdY!kj;d ze7(Y)V~c!~!jCBYgu=g3_(g?(r|_E!zoRhchf>z33X?$~a{gT|xTV5m@QA#-!gR(X za&ig;mne+W8~&)k3W0M@IYv0=6n)YLMgBf8-&?qp&1F&cDpMhIi%=;304Wth5O*ro&jsfRdEIwnu>Gx8Wu!^iF!g4HvS1G(& z;dKh%r|>3)pHz68!fz@3p~9ajyeEIZN%Wo64eI+8lF&l72Jh1JP&uO(^LCQB*v9iZ z*1ucA{7l2`=PvKkOo2?EIRY9zZh0(fd+T7Y0DasJa_s)lUVmWPr;K4XBPvLA5M*&I zd(#^R9mzv8RfrT2*uXk59F9fT@9AW44QKr@oeAs5=Ly>0Rft@HYoG*4J01dUFDnQ4 z)Tl7+;gTHMn+hy>0G%%A)CG3zF)nGm9to!Wy5_;V5yT9VHXm4*+aDdDVf&f;i)q}R zk45qTIy-P-P7>H4X|;%Jd&3S2o>#CPs6uG(dSJ-|=)`ftC#_q8q+JDpwl@p*q<+W} z+Pe*yc?z*G^v=XPaj^h%%``6e*sbVw#iXJHG6|yh00i8R5@tcKNFvx$kAc@*!Hm~I zkK;^&q-}vfw_^z&q_SVxFT74kKbvD6aS7{SuZI|cP$18_+TL>5qaN+?F`?LN0j#>! zc^(R{LncA&ajS-rvjGS6CJ1?4(+2Iazd07Qy(Jw2fA0{RAofDvzZG*A?UV1{!af6% zChYxPnr%22uo67>d2}}R{Y&Y96288&J??Cb6mCuikluU;l!x++hn1ZBVo&dsWFakh zrzB~ff6+c=_3}dJe(ZGi5!NoL{B9JhQMNZ^u;C>OUeoY)35m1vc8Qz%0dzrJUc*f! z#wi2dHR0?A@0$Dz!YIEC6G`-=bxyn@-pPddSfyl~L-lBEIQ8aYmC}`x*!?I0UVW*P z8cjL+A#BrnV3jg*6(O(JDaTUk#7nT^IBvp~d8g!5fTr=3qdvwq@k>fauy7|ai1;{O z%RCq4rn#}R0KI7R6v#urzQ0F3nzexhZU|`1Vnsno zoJPe41||JJlouOB>?LYg>Y>CLiLS(hiT%V|%sYfQD>0Jt!-%sJgJ|b);-r(&69tQ3 z-^6FkG2(EfI|)AEh#gH_+u}s#5Wl{^Wy8d;Z@dYzj6$+$2;M6BEAm>uzCn)#eti>{ z(A;)V&*EOM#f_^+@sXS(AtXOH^tL1H6upSNB%;`w~`1HZn^ zli`C2RPWdKNtV3Sq-6R0gi&mniDdh4GO}C0zJFmJ@#}jIBNv-IJ^X*O&`V9E&_9_e z;@5WvQ&zbT;EZ16-_D5m^=-%MT;a~err5uejl0@?8fwFQ?t##+@6Q+!zrOi2Eq;CZ zz7XE^U?05YbM}gNJzjx<9X_Y&u{vX#?|S?Wip{#BoIUyVHJ#qPY_Svj8DTteJq_Gn zinW)hrsWO9&6}4^o#DhD_z~=7ByM6qJxKkm#4lL=z^`wjg8C10R3#I9&S(AlChDLW zd-P6JqaZPZ^1!ceViB9MPkwz_R&nA2>IZ&(6P%Op#;QmjqyFeb4a}igi|Iz`DOk3GNInD zugPGdHbY~-zUM>z*A4Ac)W)jcgCtXjdcVFjiNc;oiaBM{udg|_B0;=4>Tlv`#X)RV z2e%7)AoCey3;p_pPhS zid~-Mz2J=~dDkOO8U6a&>SkVtZVUbT@{ujx_29|b30{{t(N^gvOgYJ<#QpnN*~#t) zFvE8}sGj*W6hgngeW)#deL2^|yB;576ZKayrNTr!pHH&!t_M?mpVJGx>v07Rm~4L_ zOPFQK&hw1}54c<{)I?#ot|hNE}n7TTwf=l!J{S`#9_rx0ES(t%LI=K8x(g z{ksOBlRG(5jrB>91(4w7NUYoCq2;M3(X`Af+||q#m>y5lInYZQ(-WB`a{1^E6dBvx zy<+?F(PBGiJx51sN)la^I}JGX6mtYI9=N<_9Z}0K_fmp=Lm@UI6PDY!i3I8R{2M#1 zS;)=Dk>a`|GAV76zQ|Tt^b&HVZ1#dbu%XCwk*BfjOB}>?+QaY7bYKBpZ zNx3bQEp%ARRt_iknW3#1tKnNERGYS1S<^P!nht$~`nHLozStjK%w{*9ehodJZ*hFl zO9}Fh0(L7s{aTm49pya%3xi2c6d3jm{WuIDi`R^(pBU zC~(8cXhVf;NH9E%+-$ItDJ$cD!sv`R<{!ZQ^6ra!fGn5asV-)<|P~;7_ zg||)|p_iaS#42g$jmV8>ac-kybG(o{x0MegOHfMnMiHbu|O@g7~nHuipf{JPo zHt|MzJrNe>sw==h)I8nA)2cz`1kqF|rKU*~8MT3TS}=Zs_6022fRt*uL?p`weZk_vvHY4yr98ISTLJM? zk$?j-{EWF^UCx_ZR`uiPtfxiScScx>VMiO*c0*BFbug-QAM;=_L(Gn_VB9y%hw)_^ zHf`R#Q!7EKomx&}?TktgqXSa&%IXx+i7AlSWz=RURS)PQna&mUhrjb{NlYOAKs2o$DQ&nugS`jS#k zwz286dbW8z)0%rPq?p%$JYTP5&LPNe3FwXdi>p^of+EYSr-j^T;lqEUjOGk`x#kuZ z=`ie$(ac1;-Q{$E3$OTcl{fRiUe%}1sVScd)-NdZW;;vJf{Lp0UR8LPVL^G7)62wa zNcrz&&NjWKR^yamq|+;=F2p%$0mrA7RFb3JD@ZM$I(0$Cq6W#>4-Mkw7(X*B8XB#t zoC}+Q3DnE!HErIUIec%RS1?=X6_jDBv80BzwI&h4Wqm%H+bA^XvF{+)SN?|JXdrhN z)7>y|MDa1J1jg~#Ksb7+Pws6nKamqU4rIve(Nuqux0g%W63#288X@PEqfg|XlA{E} zS;U5=g??~(Z%HmAZ4f7H#d$MHIqeaP-`p-%PTRzy5BQaE9C1(?J3X-FBK$}mUGje$ zpH=feZ1(j)g>g6iU*ks(VOhB8VHk!*@G%PW;j_pmDSV2;l?wB@j_5B{_yUD5SNJxC z?@{>I3csxII|_fI@SgaQZE;XbefViF!QB-m=RoBA1e@SV3SX%3l?ty>_=gJLukdDt zf1@y;bxB$8DEzU)JS~e(GlknKoUd?Sg-0uVz@IJ#3&Ia^;*kE_pzxy#KdUhRt`Plq z73Q}JMb7^{1ZOJDKMh1aPT?sEFHv~8!hA#~dHEqh!Rr*hPvK1pf2iR;dGp=vK3lu(B;h_poR=85(MG7xdc$LC;EBuhcTNQpm;WrfC7p^3I z=SaJ{D}0E;!xTPV;ZqboRpEW{r~4lDajY`@1z5OEpD8=3xQGdlFhOk3+gZdmZ;rx; zDV`D6qQs zb&_RcVcQuvci{X>0{fYPbtW#x!mtfQ0`?s_0L;%c4-23AX?w#Er=A3{$N8PM7svC& zDUi_~`%vt$KD0*}Lrt&=*GyyJpT!s|d(~roBoCmmS4?1o)UPq;W)|wV96GEY4xO-m z6M(h7`w)MK6|q6mjz^rfi>>@!*xQ6or#(KmXBzu&Di+BD=*&anFO@*x!bW<%a1ab- z1{*|gKH|FEyTGBC0vXF?c~b8Az>){hnGbtO0vjZ)7IAIQ!^AxgGTP((SnTotM9Bl_ ztb#qV3?vA=3Ic7f5cbAFMtdBGV(&I!=8>^~?9xo@1C_n}uL z#;grSpHP_bE|~wT-5a)X3(|BumZKf)U$z5>O4yEVz|wX=rx)y%64)SV&mpeut%5!3 z(cTwvZWh7b>(&-GVvpO1l27yljuwyWFXG&+v&Xq)6??t=6c!E)NHk`>SO2wzhZGeW z&AoGOe$JCM4*342(A{%xm;`=Ja;@dnl;aQH)EiS*9{g0wktxpl$WlYd@gf~QZ2#nW zo-=jp=GO3Go3(TBZwsq7ExvBx1%KP=Y)pA7Rb0eg=f2y0MQrwpwQ*tdA6q z-!ytm&ZOu?ZeVML+rFT~hsTUx7n^YOXItLJO##YZAAu1PU{@xR>=NzPouUK@w z3AI?8G0u}4e8?`qvCe&twR<;qmP_UiU!G!E6>OZyNdS=-IlfZ@icd-;Z4nglL2f=X zO9?1GDQ>(DCQ>3Xo_SK@u?S-U#V7JTl#-G-jE1_ve2O=Vki8zwxQOb}7`es~5{RQ+ zDT%#_5+c)G7MmK49?juyC_d4V-zOx+CweTUPJAR*FJfuJ72acxrkw`R6mDZb$2RdO zR?!hGJfQeQkGq``CqiF}(NV7=65-oa(XrKlUNmC9w%t016-9%g)NC|Xp!l2#QQ`qq zEY_RQI*z5~XksE%Vui%<#6LppC4NbDBexWvrN~K&PXV@ZGRiNKjv(!V0GZIsX2NU}Vde4syAJG7>T;@mWVAGK&By} z_+%gsiqEwW1wA&7&`CVPT;o}2G_egju?cjJ8Be@Qd;*Ewr1;QMod580u_n`_KS2bJ zW7#>)j)nzLe0~p{pcC0x4WW}59|K-!?86R6MrMDANb%vDU%uf=Epn;g_#LQxraJ|f z#i&nWv5kZjAEtQzFInfaO`Z(@Xy!TBJslh0|CA*!H7QyCPO2?4k!(MYYRg@6Q9^gF z>v0{=^NkbI749z(De&*4fs0L^9)1>UaH)wD`WG?fGE+|fzya$jm+u}G`Rh@2P<$Ro zWU!xwR)gZh>J5+ykKau-i-hpEJ)5a9T)ru9o6M2cg^iku-3V>4T8s z^9~H`@XuqOI%Ap?pFcpc*-0n|6d!H^cdn+_jT7FVnobWWK7{ea8XCBNEY@Cv+_l&S zVxjmv2zwcc-?Gylq<&W7S=M+XcT;xaa_T?KQI$*_O`Xkjx|)~x0c}1?$A<-pHI#3q z*U27p(As31d^+ECBhI^$A+tY>(X=9?4qc_h*5>A=7 zp_%DXcBjd};i58_sLepmP8M^eN9pmoHBZlMx>Bd8ja7e$I>hXfdL88cJp|^I$p)Ka z3ltw7C~YN<79GxJb#Tdg$s{F(6rU53?whk;XM^DznOb>fz=jkb9x`<2%F&e`rOixI zrAYDN>w*4a?zF=UcKn0blZTr~sy`LwfZ}rqi}U+a?FhFVkqjqJ*#_jc)y;ea-A0Pf zKWXtcs!npv8QGsnBPZG_eZrKJOiJ9}%F0eQSxE7rdS(ms1t~s!@z0-4?P+GbJ3gnD zp!j@_P1JvkDHSH-`7dx}&M=XX;=}yeJ|DM%;=^9g^ZAY{+_};~NbzB$(0>POP<$9E z@()D~K=EOu*uRV^b4&yjAMR|PGEAdM@nH|N<$1&GPY8YjoF1J4ae97ownQOIeZnS}grbk)*cCWD|lL>1f%)sKVZUZwxOKRDYtq^9LmejIV z?$}(@j^(rhdQr|wZ271n3C7apqk~eVtj?SgxJTu}VpdnI(xYr;-cU-166SvjnC7uH z!LGtZaS%9Txaoo=;42Z4G=~IkYQhAfbAkk{!$3l$>x|__bjPl#*X5Pggkr4A zvB05eed>6VgcVCI#^O4Y$6+(az==HgScz2U^3kcC-8E7n)D2P-YO&_&3LDfE) zidqsD;uwxNPvfk$f4)Qw@9G<4GJRv*tuOUa;4k1^l`ROES0Tp=yMrtSu&{993Rze< ziwW}z5XvF*3jd8-eVktLmv!abnT?!?z6cst%=p`kHo=$D;UTm+)^3wH22CUyfhSS; z2L&=-HH{C^coPpA!3WyUu{q(t6M5*JGh#e=20lK;gC}eS7E{i^bf%%T)<$0_V5q@Y zMFB(8D;LmjVPggui4>%%d~-yw`DJ0{cAX={V z7z$Ww`^f>@Z{k-#M=)Oj{<5Z`X=A>fVQ`DtMHqxO#s}KC*qI00OvHTNVBWLjV&RmCfpTI@!;QQ@w)juMVE$P{ z+tew>!ZhZs!NNc}G0UNR5f;jbIhSJ~U9A>d-o8*zCP&o!4mzi7u&cg zjc~Y-kJd>Nv1NMqMsYqOk-&5g(ON9TiqB?F#^D^Hp2Y?ak>Tt>pB=+9NO)a=J%$Fp z9y0?OhpuZY&i1(cBMO0a&~ozF7;qnE{PW>Ra0XkdI)+en@PG5hVS_EX4y6y8QZg$F5Is_-a< zCn$Wf!qXM5RG9lf$~sr!l?q?3@M?wcQTQQ+UsCvOg+Eewr@~Enr^@p`LK}tocALn% zDSWWPBNd*g@N|W*Q1~W=?^O6_3L9RCtpTN zuX77xEDWucJgMaQN`91*k5hOOv9&)(;iU?HU*QeJcKrNG$+rNrp0%jYGfL-WVk`{X zmHa)0|3z%;kcDURV!xNd0~J16;gb|*8PZo6@*!q*MXvdOcnloML3;{up27tR_f>d+ z!ow9Fq3~#h$0>Y@!c!IIA2U+Vg$kdgaIM1p??&{mRQLvkZ&LU+h3`=KrwTuy@K%MN zRQNfCf2%MKFUREy!OS7;KJ^iodXhLG`+5hk@FT^49!{^$CsytO|I=d58|lV|`nkaA z7Iy(|Z87&%w#EH{b1mk+qQ5TYrZEh{634PPy*E`el}MK~8qkg|@4K-*)77QqnhQJrb*zo}Rx51{#8 z`M;GwAkRyJsdou7|B=83Nt=(jF1IMxacYssa#@~~dp@w_0d#7>+e{MJAZfLTYkM0y z<4--vXs@|VquuMVNFG4vD%hhxO9_&86$IMeE3ik_2km9pG}_}ilX(iUFf>Erv{-<- zW*V1!>{j&V<6gQ1G6|yh00i8R5`GN5B8gy2J%%T+2xk0`(Bn9hAZc45(CzpTox*yv z9mo>)Gsmyw0d)R?#7zV?NE*-W+TLfdw+S-Zuk2;iSk>@rs62*c3@CATcP&e4X_n6UEz4fC0bF5Dd{oF2NK7f%yGR*9Xhsz%oW!*) z{=wWMS!X=KYeuC}jDW(~WENxwxsD4c7t33_ZCq2rxS6XQz&qaL4N#3s=9 zTHL#f_=H~qlfp?$O*UY~#hOfy{sIwDIN3SP`oaznbiD81 zjxs^vEP*U5_!#&y6Up|C`?cjRxrQNya|2GbdH!Xzw!(c3kph1O%emO(>EXZ2$fYJy z==WsgGE+`}Kb7UIa({z7MZUv*e!2SsB7^-ym~w?tEB1fNJ$kkKHd2Q9+ykI+vfE32 zoGH=hV5y?hO{wJ%F&w_BMDyG_<|)!c!-z`94;z@iP{Y0WM(l} zdh}YVUjZ|0x>Bd8jaA=59b$G#y$*8!34$g(FxX&oY(;{2p2TtP9mr;Na0jFAnSAMz z6wV5y`)@O$v%!wvf(_0y12*cv&q%%*NThIbbfrgWGZPn2L*e`h4ctxxhq=U#znzi8 zO(fOl3!|WL4nl(GPiBgEX=_5+X5_Hd&E&IHQaEE6sQxe(Jjpd@WdBANkrQo|^3YUJ zIGGanAE4S~lZ6yc3Ns@pk`&H$w8NKLLE+?Ha{QT$On13sqy9=rK;bmk62CQ#&M*<* z{~_x<)8xebk~-6)39QY@F!hNWQAU){ zThsb;=d`1L(zN$nKILKHOu=0}KaM$3b2P{8O~{Z9?q=^rh`3|3XMnuf`z+#d9XM?| z53r+qa-;_9$?l+zhKAWOpl+gc_NaW9J_V|sUSOH;nljtaejC~~^=?C}u)7Y@FBI(G>|CKgckxG@t-=VN!w8YVDswu;?~ zfMH_;wIsZb@fk5M2kswbuX3K#`v7BaUUl#4IrA&#EbMJ*dBLX4QVRR_!lywc2{$Fv zdfShQ8&4$W=ES&4+b_c2?!W$xGnCoQDSb(v3w)-5nrG>8+Vzm}3?!^JaeGwnIVk*Q zYv5oE{>d6S8EWk1Y)?L@Lcd21eN4fe_Krk1ntI(xanRP^E-LYA25d1S4*Gi!SCo+e~^b?O);t6aQ(p^K3Rn`L;e1(NB zokBhsiZH&_#1&N|Us-{ls?fU}eTFq`lcAS2@_l6(V61%b{pp1Z7Qm-a*);5~ne!Il zd&qnKBDG-%2JY4ZuW-8~aA}8j4cK#`=PP>96X#t4+seA$+ruZM>0!tCLfYkH(%AQ3 z+qa^>kjPd!j}GDN0jRwF)qDR6XrMxjv~K7)IxHOuZp;2xzb9Q~JnMZEAC)#<(QqGUz7E~M9bG`D;{Y%|7{5`vn_Q~7#q~K1 zLU-c@oM(HvkekWbcg`DHqrUkL^2_+2B?HF+`Cu|0DC6@|`a82HIpgOnI13xMpA}V= zd@%%l$VY<+v_%dS1F`rbWBjY&I^m|~E9WZ}(5CH#-U<&;n0IobbBw}c6rQ9o|GyLc zQx#sM@KS{@Q}{}S`JbxTxkKTN3U5{TZG}HpSo4)UoD9UK<}2kYd2faLD_pGb2?|eB zm=9aUKJVBC-=XkN6@FM@`mqsx`mPa7e>H;tqVT^J{$KpA>gPBCOS=+yDj_&aVZM|t zay}Uqe7M3R6`rK<425eIzEt5G6y^gQv45Y!4=em@g9hr)kVn9pIvCSEuVakj$U z6ds~5-@KK)ixj?0;TshGfx`DH%#Un{oyQe^QQ=fP$q=2E3U^m{fWku+K2G5i6~0tq zzV|Hl`zU;v!pA5)QQ-v&pR4dng|Aom2MRx;@G}a(rtqH?{#0QPPmZL{Z58gKa6g5M z6+Tws6BVARaE-!C6~0X2?<@Qdg`=3TNZryEZbuwEt#CR53m>GL(&2i>+;PRf%!U)i!=1SY?O;T4N<*f`rQ=EFCJFU!{ma_@beWEogk ze+K@Y!1hWI+?XHnu8(KAP~!i!%uhYW8}lRhpR=A*h`nw$PcgO(pTb@iwzS875PPf- z?Ni2ZY_JK}Ok?14WbV?v=?#O9V<{l8LF(6-ACZAZltPE~!!Qi%Hvw4NTY~tl ztcVSgc0A&=U2NqOVXq3EPJ2zTNPDLOOCGB7d%9OBfxv~0^zLrzI62HN>=OOHe^Q#1=ak8g;)p*uh2;tuN5l`Z{Oj=vqh`o>>F>ij&zI^MhU%&o`^i4ACogcB|Y!rk8na4hl z&Q9hLw26ePj1biWk?|aW<~bd)9ExQa79P80Sa^K>uZ967PT}P_UOd^aZcD`3kg_iF zK;({;_A8Fb?YsH2YYW~ZSp+(($D9{&dOX`TtGO5HnwdCn>kD4n+HT9>7px_|1z6%N z#Xs@!iz30MWw6N&HhqK5P@{JpRj!X;M-^mDJBMYZ4TiN=^gmYu0_?jzMR-Ts=sqJ#*E6*0RT5$Ys_ zmKT!Anw0}q=N{=gUYE)iD|5Z9i(0fF#(zYen{j-xim=tK#jF-yq;Bf6$`-5pdvO@K zsL$ZFU9V~CwQN7ETc0Dr`03-N77VX+D@(exj2xNgtY|T-RhO(&x)dy_EV%%ONrBt` z$@aOAwd&?>ZM8A2ut!}%sxKvy0h>Hbz7TmOk3|gb{dqnp7zScOn5AI z!A#V@@S3`{-JJRNC;#x~&emsqP|(WsQ0w2lzar(2UUPQ*(~odG@cyVqkQcMV#) zF|xX8>$J~}azSJPcKf|uuYIOq_>7iM7PRtu7!!f!lij`CZo>;&4Sv}O3x;>UGe{_C zb#_yTUb%RkwOP<=$8ZRiM7IBF)18ai8#^Ke!x2foziC^}Ss!_+M;?ZHtZP+xCz`Wv z_)AOgyz8mvZnEaoU7I&DJ#wqB~C8w)FO!A{X>`W<(-K_Hs(|TffzGR!Wd~ zY|{<>*QW+pB=_c}+zcvMZi_%r+N!XBU8&U{(sV<=^---qr0Kn#sUOISa=Ldevd!q( zbVJ|uHeZlRNvOJQX_2jA&!+e0rWD?i43tC_vQT&MN8JwY@L|u?_A{P+Dq};l2?u>R zCvw(DU0XL@k+Z2wi)2A{i(czny@FQjqo(iBzg@wG3alO5bi$x`L4NCJW6}^) zX7R0GP^Q_XrRezXc|*mHX;Opc8#`e=3tE*9FYH@al+u3Kh~Y;cf!9DLbpC_~6%VH^ zPwjNpHgyNz?nM^g;H`~Dyxg^qZ}HmHb-i+3t0lv+GuJh3zxa$Z)<&H>4#pwkMZ2`@ z+$A@XTFeiMdC|3xZ}wVV8m&8T*~N9KCZk8Qf8$XSBJz5U_~Z;x#0=Aa8ciWk{^vX}kSCACO)#fH8;eiz`PoK4rXxM8=u zxD-eD;E#(tFT=?I4X@8DV<0!`bUV0Se6x(1f>yKou#X0RJb3Mt&NxfrP+VMBn$~Uj zh}f}_Bh9sbMrvkhtAgQ$!|F<-(8WHD!oRdFj$1sfxOxMgQiN&C*^{5UgOrWLempL_Js5v{tUW|fw& zj8;Z5p3uIDMfn8>ubkE`g&L1$LM>_{@pBp-Oip( z*T+zlIrrb}EOA?8Wndll2M;>=X6^MYktjc<(=|xGV-21ozbJlj+i)dQrQus#*7($#5iYA67z=2 zd2^FfoUX~r>SXzxsg*Mq&RbZWEWoFXs-`EWRwSn&U)SWk1p(;R6qzdLE-J68oGzJr z_C%V~l_~gy&q96~Be|gBw1t%mDyAoAAg2`4)6Bj0#G%Z^?g)HhCPQv`9%RYg$T^oN z*p0ku4|2|Lr{nq**dHC*=XaXBgm&uX$<*D;OZOn34>|9f0{exb{S|wV*EN!l$NVme z{8+nFk>h zVw#b{XMKHoXERm%`Yd5~?{k$6E~MChf>R2&6$Kxx+3 zr}rA{3Q=?n3$;Yi99p+T(Pp?E6{6_tXmZRFMazgSQ8a@!utZTlJrknnk0?L91f_r| z%G&`FMUO@WyoXpq;OmpOEupW^t62;2^;tzF@%3qlqI4!_8UmsyUtzSqK7$?$e0_Sq zX9dQWz-ZK?qbKX@)5AHnk*`m9zYTnST9XZZeO?DU*4L-ko^}FXpI!%6ccHNla#9b( zGWm3`-q$CaAVkp`W)xqarK~{^iTiKWr+EJFSZ5)M4rKx2>$5w%P>7J<&D!I)+h>@GDug@zuY}UAeug`5X-N@JHkI}3>`T8tD84ZY{6*O&$ zqMy=O1EMJXX=Zr$uws@dN^-aL_2~^~UP}~hMtR`t)0@Z|2EIPM&fJ%QuTSqWHhrIb zeX^RxUMt!Ue0_SiGViXwKD{%kV~L_y5x-Q6yyLv?tiyKF1}AzCa6iAnv&>|#kn%T6 zpks-m^hOx?*_;Jo;Ompg7@2hBh*RpZ*jQhmOt`aQ1{1Xz8vFXZ0_ra{RHvwoRX4sq zi9c?jgTm(d-tmMBWUoc27Fx`xfNzCQWpZRqRMoc+Yt=at+sLKHoRS@O+5 zYUJy45ULUS`fP^cLtmfs84+KfY;8ys{S~b>Ad2#OWUHHbiW?9`jjvDslM?#+k@qK;; z1Vqum*XR8-AVksi$O)n-^Az|G)4*&KDfCI{1W}YJMgBCV;8co8_&HxjKok{UpQh3K z;p?*mCb6Fz`}&L?f#I3jpL;ny`Z-P!?V7cQVn$l!;5c^h3UplBsoV#S_XyT$RkRZ| zuOg()p-Q|t=3h=)HRYt*a@*_!to*b~FQEy(E0Oj+4tmGCmv~iRqLStej(gite1JXg zqEIKpX^$Hw%tB`02}9ZMzydsVLe9%k)e##!1vX6@6Wle!kWgT9Oh=B~8)#|`p*sfVhqBUb(BbY6WuoY={vJ&m#UE1f zYUFl0KR|1jx*H+LGYz`bKu!zYOHI|xKS>6{@Mh>`naYo%Hs;d6@xifQT24=)jMqYvrI3W6m zVR(w>V^CB`RD==V4g(B=@^WTSDj$$&YE)=sniOPeSZ0`H>R$`ZXPTK(k&ncrqOwx6 zvhwl&efQbx&YA&aF#Y#pf9|>Gd)8iioqhIs?Q`}zdy|ygRo{nL?RQw*Pt^B(7T2O& z&mu4RGxxGt*Rfbi?0qP|&LW3q=DRHJuQRk_s&?i5=<*>#-`?mxKqTJWeNRF6K^D2p z_M^zJ%jgm*fljy?YR%dER>`hZAW{tFMtM31-R(XwHi2f~2l~oZb^zW~H-X`%b zs^CdCn;+!;siv1GKmQZNr{tX*4C##P&s7UMW73$^4r?Lu@tEw?T(YG9ucK_9lhNq) zu#8+5WT$3^q?t|n)6+i@%Pk`5f4oG$l4x~IUwlw9aJpm}J+utGA?goYW0D^Vx+tpu zbAmpCO(EUM>OVLc_@YJfQ5=!Q`eHL|wpO6{jJ7@`-bp}w-!wk2S&^MBlEaJ0!!0rI zn3I76EuOC{h@TP@Hz|^)`e2!MdLln+iFrAl44h=~(_;Jzm-tMJTo5C_V~M%qB>nG@ zm?C;ArXjcAvoz~tnwMSV&n)t#7+I#1J(RriPKQkt#9H{q)NIF3#@#U6yN=VFCYayOKj9BxRW8&h0$-pwnLS#j>tHQfK1x}!XYTu~_m*LuwIs;W&C*Gz?Na`?vSCWM?`Wm74byT`MNi#D zUt+`T{YPf`IcgeD_sNEkhZAxewxQLAZD_S&FSOdQ7g}xDi+;m4+J@D}4I8NS*@iX5 z4QmLpIxg?0w`ap>>20-P_v<25w2BS07dV;aZ{#-YcOef8avSzL+puu3{mwQl9BjYO zgj&Y&`!0@o+b7e`<0z@Zp{3|%a$&EFGRs%)YQ_6n$OVoi>2dR#9<%v6g z9dO0FlZKmTY7OON_$$QpMvLofYHh?wts+~PPnY?_zn~&1ycgvIO`$8Kt0!IM?{}|s z3)d1Ko;=gI9UpofQ1XH7*v?cPyX=Akbb;E!Yc4ANUdk|7i8o zucITUFmVMD1f5X9LS9n6!c1h66GNQ-bcGInC7FbGdLdNmzeZx>5wQwVKih=&!oWD1sSZ z(5Dg5-UT6o*(gnE1oTiE!EA=IkVZf^a}`S_GW&im0$P_wFeB4x3S}yUmTcFO(XWP# z){?acL)L1^%w3u?N$qT{b8c9DZA=|X>}D-!zyxO4&rhzn<3b<*#SlM(fUJZYfdk=LOSNyQKnX3xFv%j!Yqab zZ<5!)te*L!p-?8FyCm!tTvX~v zT|)?&ofJ|{;y|WURq#Gr3#1VYkZQRt0M~1h2?mt=Xvo6^vcpSKNwKytSeww+8XJi* z4sDqE{lQi(vqu7+%n8R)?+$*HISCl2Nn+N{3Cy_6NvZj_kJ)8V-1fgHj6(CyIvs;fx`Ix@W@Gp_#-?$a-!!LT3>)Q-{OsIj%kn}_ z@;dAka>e$Ak#Azo^EVr}Ca*(}xS^Rif(>iU@6aW+n?Ic#sXR0JJ#sWXmROWYJF7G{ zN)BZ+HAohOtr-yhYr}u4Gca%-c~S1PA=(F|$`AX)+i@K7kdD@q?XX+WPSao|KaBSC zsSCrtvYo*&KrbhuJhHJ=c9kg0QKNmRlG8tH|H_4K#px=4nx@Ni*rla>RrrNkQ@K(E zxpJMBZ&yjq539}(+Yv?`iY0Dakd_d8u^?>sIbrmnlDOTJ`Gp<2=|9bBafdXgY+GI^ z%S>2rx}E8|GQm!!LwD((>#HTTg{JEeYE`_Qi!Ur|DUhj+O*x{rcl^n;xJ1ufKrk{I8{X$!~Su zq+>WyYUz5?yo57Wc|o2DFceJAmWs~DzLwb;}OwS1| zrJKnntVm@qq#EgACK;*nT)E|koY*#!=d^6?s*vWkMP3lLB3xIc$!U`wL+Lh#d}^!H zY`mLT+fzE1R7&Z3Q)@`lGR)J9U1HO6-eRocbc3&RU54n!k=`W^!T)cMB=Z^?XU}hLsGHt6SKW$ifA=KnC&l*n zKcS-%9dT1uOc(akn-ma~stW zi-xn~&^=>L{j9nv^VNNf@83l0V<6PJw2z8bot?xZyl!@V^VD3|Cpwht<}@r&k07o3 zKnd#%LxUxuJCv9Mb!yYlsP*c2Zk(y3n66&xKGaa(sG<1kr>PH&xl`(AHE|ef$d)9m zsBY?v`o<;Pv| z)N9Tx^%E1ix?se+^n6SPy{q8}w>o%Y=C@>uWx5Jx*32f+xML4Hs!qJXedS6b}0&_&Sf`Lmjn*$uP9&|c|*r9-lL?pbxS>Q!RtKAS!# z^!}6{3w7yXmX1tVcl zhb=l+1}FL(qJ7geZKirsn#rj!Vpx4RwOlcTQ?73M{5ew-9l5znd$PT~y2vG{ZqD2} z;h^W>*1aM0^CF|lBZWJ&X&T3t&d2&$%`;~=q$hdW*~^5(Ymc9BOx@UH(hCH|t{-;^ zf0LLuyeVWdnQ-`V$B&(GcvMc$m1*@KO2XNjJ6->|oy6!toKV06d5YY65cDn(rBTqvi#XH)&2lA7+lNmo<@pxHJ|9aj@CM%b0Z{=Z)(?&C%xt z6ajhqQYw}6GOCwk=*SN+lrcJIiu*FNxVV z=xRKUln=pQN`9{F6cl85#38dZ%jL5D$l^b2y{a{e~Td10yd zL_vqwj0Exwqu)oIWH&)*oXJg9Q(YQ zBp`=z%0bS1N&<4YS##vPv?L&hZ9n26V)>jd&Wk!T#8$SnvntymE$=S7im{1r9IJzu ziT8{AsMzeJFAr0lCnRV6=&u*s{^I)!EA!XH1oU9+p#NvbyjUb~Ucekz=<$Y;fV@I% za$YQ&oL7n_=Y68d%_jjnyfid9tj4impLc~OhfQv;1Ie=mt}k&{glmn(Auo+eFm2}q z_#YnYa4xmHD%}7FR}D_88XIQSS50e}GXD%!A*c{~$;>&^=O!_>e##U*Mzo67-JsQS zy&g}_XlQCB+kz-`l@zTi8%fpFxwCm9NvhHsPgT0wkh2BNRkL*WOEaYf^@}+#6ovnz zR4f#{i@vJ#34RD1LU}rfD>Sdv#GGY3IoJj4s*FzRp_-4@q$4QA*J$2yN#-PI3HeD; za*P(aG*1hMXWMw&>1mpLy(RY{KX)Klyjs3p$PX8~7D0YEQT;L}O-pFqlNG0|FFlsK zv?z=6!-?D?$`1#$U+xjwk2qW@pIuZw4Vtr6woKW;w%jBp*z$+d#qdu#FKV-VX`AIw zwOPKZ&GP5lEU#*_d`p|h{x|<%cx4O9IR5wQQFHmS5DeT>@DC zqn7Q|XE{D0sJ^%52l1AtLDiemCz4i=F0E@uvHq8P>`@vXTQuX@Tr=vYn(4>uXezx* z5}tk1DlkGl{%IDT%BaDn)!nq}mpJ&oFm9&la4wmA z9?V5cp;=RAuYkz{ILgm+@`X;m*vT(-@+D5b)XA4Q`PELo+{sru`Snh|%E@nb^3`yK z{uI_|vOM1b$8EXW$=5ph{Z9TcT&X{W$26IpC*Wvjos+M3@@JiVgOhJ`@=b8G|B{ox z?DSuA^4FdI8&1xp*78GDuUz#APJtuga{VcAuYe0QKR$A?=BGw3)qHB?GR@D9O!5Vh zyJ>!5M3VeTq&c)K%1j}Z%l6KQFJWR|N zJn%^I+{g!tUyNKM?y5pXXSA69)UZi4o&MBd8udRN`D)#(Y1Ky#zX&Vs7^Us2W#qK) zkAtJlrYJ|BHgR=J;Ec@e?4laq;I*t|W z@W_YvILvWU8~J3-Pl(Lp+3AtjYF;1tIn5VEu9W>tBJ+rNS!9l{t6=4!Rywe4Bj04O zUhLl(St`lb9pCQw(a5Zek8dsQFP)svHjq>1e{}qMWRBlbP2}f9>A)rNI!`(#9xoX$ z59V>Suj73kkAP)|^By)kd<{Zc9!>e42%X8&flDd`3a291#AE7YSUS@rhf8_~m4r{! zkGR%CfX*z}Kx^5v4lrawN)S4s|>{^?PE zz2vazPmA(ZlEbFo80B0`VAKB?a+M3OD)733x%M)_ygtB>-53XL^1oVkU^~X}mO_Wu z5Z{ShA;xtI{Wa2uEk932`5ltOmY?-eez)YX>Hjjy*GdkX{@)v4x4@TkrK9x`@)#WxR!BmV0(Fu(inMx=JO--%41bzUa8y_ zd9CL6MCNq~ered@l?oo5@(lRzNHaAHQTe)>q8sslY4x4_LD1TXU*w)4P#pu5#Ic)m-MfvNJ!)Bj; zLeYOia@h2bjdJQru-T`4*%n?WeKInyla@#36%wB;qXT~_GOv?viL6y6cR9Y-F=2s6hgl?KLvQOx#$@=T$mSEf;mi_?EnKChLH5}6p zLq}Yx`TmY;VChpPOqO;G9Mg_NM@;;2j!%S@_EgQ8EbU}Crky4x?JUh_I-UnBZL{V~ zmUaOg)1HTpc$wyl9A646?GnwIEbUS_rX>w&U)O%W#_>v6X|LCu$7V5IbjN2oKF9GQ$DefkX~$o1{0+zV zIDW=4`^EA@`5R|chQ^ewaaYHcj`wjq-0?WaCpwXOlne znEJEHUv>PJ;}Y##)9L28(s8xpgB+jYm@&T0PLtyc9n)N6I@Dc_A9DPZ<6k=dqvJ&N z14~Q2(YS|W>W3yD=6ICjV;rC2c)sJ0I{uVn>TG8JCdaos{;p%b8a4gr9RJ4gUmO<{ zwCL~Rcn`<^a=gLu?;L03 zMQ-*xIo{oIf5*ceAL{s6$EP};>G&MS7dc+)`1g)^$!mElb==KyrQ^dKhrY;Td7k3r zXE<(he4*ndj<0t71;_MDZF&2u6F58 zySl*9eh)GBD`lsz(-{Ou`@@|4P{(87XlI-lJELXi1gCSBeT-Pg3{&y#*iOkBaBOLX2cJl5{zK4_d zck+QwzMqpH=;R-CT{O zt&Z<<{9VV7IsTF3Ups!)alV>>E&uvVBA5SN9rtrQ$Z-uE%j5_rKi2V7$Fm%t5683@ zIr$RDD;?kD_%1l6UF+oQ96#sy6~}*bT%uHvVAr~GIBst@G3O)Cquv;Pijs@8oYd?pP+Bc<<}xxS!)u zaLn8Bjz8h}3r>HPliw^RZ#+AH%jw()$Gkn{f~P+lZTbc!(C420XXL2drrRI@h=^}<~UE=VcSv$$2=VF zi; zSI2ufKFl$Clp%plGS+P^#}uW>dpqvyc!1+-$A>yT!tpVVCpfNm+~By`G4J0jKeR_1 zU*z~Rj<0dN(((0zdC-?G4H`_yLb;~Oxw9} z7ss@rn!LB;|8YFX@d(EUI3DeIjN@Y+Pjq~m<9f$49M5umj^htIUgY><$MlkD+jXsD z>We0)9oCpWK#gy8e23$^9e>yHLymv!nD^CTSm@-79n<-w*}2B? z7aiZ=_-l@Dbxd2Z*}2;>ZNMgf*zpsN*E!zk7#|Ny`?BNL9KYe1cX6h#kNk4XdpVQu z=D54#K92i2ru$7x`vJ%JnV9@Y$Gpcg`2@%HjvE}$c6_#D+8xc#d5$k~OdGE0@IKJ^ z(~jvN)Z{lhzQr-^xu$cc<9i&_hHE+xJN|*=ryM`+_-BrP;rQ2%Uw8b5PPg@@Dcl?;+CmjF8@iUHp?wB@cv-vy6uQ-0) z@f(iw^*m!~d9Q0sTeEQw$LggkC-3LD%JC4#2RJ_1@zIWtb9|EH(;PQAp6Qq_Tr8jS z9iQ)bkz;z;HT|m`-{_cLh)sw7ca6W}_;JTiI{v9++OjR}?;XGD_^*!NbWD$&mX{_;APcR%!B69MdLl^68H01k&W^Iljp8#~jmcZu*~he7)mU zj_Eql^uO)+0mqLx7A6_Jry%GtG50*8Dtyikab{D8e2(>cILCU;lVj|dzPCet#-4Xx z7SnYwf%*)r%V<)dIjmO+NvFuzqkRpz9;K2#k+D56au@Ni$h5m25V=BJ6S-1+ROG$I zbVrQMeZ88Re64tWIMDE>|4o5X*Le6yH33_3j16ltfy4~RQO=Gmn@@>62k7SY)tu86!*OuYs9 zCh>sCzY$Z1LH@G%;K;9v=@K0|?a9UmAIo_>++j6EBN=xcGCCKPX-qnKo+bD%d$jd~@XSV(Kc$Cy4Kej6dnOBcCj$ zu7VD2+TV*jT}-rJNTcz75U?0+DVb) zk6IFWg_t%|MF>`iRqRbo+hTQ0#nBy7&1M5nmpeV-`O=boLQbZ-EDj@yCOQ zi?54JUHfa1@fTea`6w~|c<7%f#vc!+XF>euVd~D*ZQ!}$b&(f{pN{+y@rKBkiGLZH zV-ue}(lWXe^&FTwHSf(~{5ju>e2ut3H*(}Rh&x99s<a+MNz#kGXi+rB=bCEe-Rz_YZzA^H} z;+rF1CjLfbjvYRS#pW{ccOzdd{$AuSh#8k1og2jKBh!=K^O0{7|043u;+G=dD*j_+ zdfWSJ0J@GN7JL~$sc-P4Ij&_T@Uc5)-XT+6}pBL{N86VN=$keY# zM1EO(VC2`t_*$^8Ka0mi=6F0N^54a^kvSe2Cmww|NSqv*<8FH73h}JSdx;w(4-hYi zOy7wYL>?_(9C?iR^2m&lh5rWYsuf=q8Gn}Lk!Ojoi_9^#Dsq$fmdK06Ya(+T-4*%c z;kBzbv)TI^-ikUy`SesC#RlgI&V1k{+Z>f2bfNU z;{lFGI_5pI=~E9gKGiYrkWEfK$#|jTC62Fle7)n-j=MRobX@KDK*u~Um>r%Gj3+yu<(T@7=`41<)G>7z(^=(sjpMbBA9GCI z#nNtc{IcUW92e{UYWn4lso$7`(xn7XvJEzWRE{n_LT9a9%ExlYY?g$ilu zP)>A-3t^c43lPL0lOfPF3D<-r)rAD?Z=T;#Cywi1Ra`cEoafw!Etox?`V>`$Xag72ep>Ay4{;)XOPW^g&PSJL#;g|LD%E{KdOl)a{$z6LVNd*vt z#eGW4-rn7_RiBXzd$b{&y>MUBvW2I&V(&{*@b)&y-WbWSr{c-k`(Lr;L74na_82L{ zg2nMZ#M|pXM|I)2y)>Cy{vHyOhWj?*SA*m)*~T96PipddrRsxb6bWJ=j_DaqE_rga z^hQP1f$WWnM#N#M6*^oP>pjdGz5V%zaIv853vpOC$)iHyPG{-kAZ zZ@lcGhdtaD%pPTK=bA9-tIABi8PT#Kb9Y#3d?G!EOTcHm-8EsaOp{KBR`%BGM5Rt) z!En&v>LL48w1mOKMhqLV|IlG0hgMV!AF99jKe)Pj#E4-P6@y3aKO)th-0{N0#~qQ$ zm?iRfdM=-=XA_yxMsdyIi}ErZ`8q5@9`&EW7a+rdy{9HZUO|@b?eYu49?j1y>L=s* znL?GBX2q;3KQDVROU2p!St>5#rCEMKc4w9finyd`#u=sry|v^AZz=1lbyOxLB?p(} zYv<=j>?AEN9cj6e>6Sp5=7mm-HtXeE9}>=?`^1K6p;JD3ldEVYc|W=kOnd!^s|_9L zwR8)(^*-!ED!Q->P&IYCdz%XzxA_+4HaFxX#IpnG`ZRRH=rWj7MWMwUOaHunkyJpptrq&%KZKIE+T%Ss5A5HD+JE`T6%MnMfh0Xg& z^07LWTU`}c_E!^@TOZf?xf)8k2KqemLA?X}MWyF%*%I&3K(Ir#@2ALsZ)$90aUJJu~Qm$#6AJ=1Sb zpiakLiJKj-do31hkM)jvwujQ|mbph-FukKB@auh63#^Cra@5&+!+z1Sg^dF4 zlNQY0SrWijhv2?I-zFA7Cfbjfo8A~*;74iMg6Ul-fj{~$lirr<5N+?#_eyVx8Pgnl z1m=p$h4I>fYqdl@jqPT8w{(v#i{+x|5X_#sAFZn&sFSOyYVM#4-GjGvj~+Z?WVQ4v zDz<%(uGvScQvT9ou)n@B=1hF|VZ^9pQIc#ZP7d8Sb7*DvqK$i`i(`5mT3-0sjb-W5 zsvg&U@5B_3&VR66tDD|&?2(idFVGzzn&dA(k4 zkqz0ku+Mc##n7@z6W=Q2qH^8nWcSf&imQ8E+P&n`%ewz~OePh4qT?OizLuAAVL`Mj ztq!}dx~ao;#Yw-<Ed&pP>K7ob;=eH#g_Zuxs7 z$$mMa}-&wvHxg2EiTdDC7MFk zwIW_^Rc433ty#&(wTA3|X}05n1s8aA^t6%GnRVWhH#FnmrIM zFS&yp90YeO!9^{5Fx<0b*R1#uxFRWgM6=>dcFZA4Skj=?XUBr+9XI&^uf&Q6ERPI0zrokS&TWG&kaCMBE)+4;e~?2OV< z=i8+Ea<(y3q1>1MjP;+BK_MyMgOz?H!|>z<<#Y@i7mCXlwJemD<42c0Kcp!u=K(5v zVP;NN>C6A1b!HcZm~Q1SlIEhY(6gNOx9sA~3aM4>R;Rx8vX^9dA6{AhMPe?^+@^*8 zdo^PlSc)@)0b2GOTA<`Od6oY35F)8Cl*-HnUe`zN3W$%bSV0GN{#* zKgs_2Oy&v2j4o#nWUt9k>|@H=-t6ZxlEulRudk5U9Q{9y5N%qdK%U)SYgCyCz(C=1K!wTP~g@rzF|Ous=+!Tz;Qi9w=5eAMY#6 zH6^!T|A(}`j4ml9?US_b9oeaFmeT%+v|~#8vflORk1shG{%MoAwgi8Y?1s0*Czebn z4?pKRb85+QE$PCHgQP3l)0GYB8WxeOG@BKrOD67)I~P!#ApwVrOAr=g0vflv zk!t6HMf&e@vCOdPP90I#zN!7yiV7wvk`^7MUME4gWU|5G+{#OrJLz}`%i4-@Y*w!f zSHjLTrKIyq)(l(sN?N{A^g&tUP?kfc;OL%s8ETIKlci;LCOIOtMqM z@t%}_n1yK>c5FfU`TEZ`goV=bp%|SW7Rt+UFUXz|()TQ{Vqr#DcV+nrWMpPg>t8+x z180VX>hdFqIV&uTEUzMFR#>PhrxKi<9TvtU#q4Y@8DXP~lx0ewJJ*e{KP8}1ZRY~q z;C3$HF4CPd-;RJEhsX!Q|DU8%z(HL&j6Kq0GWhv)Q?<_UqH6ggs`u|cPaW-M#&OIN zc4v%+%s39*iCXMAHOY+cE4Yz`rX+J5F;8ou7mr1Zdf$u6cz}KeJSuc0YOG04H)u5A zo*q(tF~S~S6I3Y`A6@UMaj~V^ix+-D>j{IO8T?vstkjc=53p_blQFB~WR{aC-IgGrHv!_ z_G%gTb`KjRmv5)`bi?OXVF97ZniRq8VohlT^gT_AU=}LytwuYPFqs|{CNi6)iIfvpKj|?O6z1Ksm(53Rg znRBMjnm?^!P}7H+-lhFH4d*i6M;NfBl{NKae&(Rf26!2G&anMa9(2akshh_R8df#3 zYWSdN=e^5Oc-PjX7r82T2Heqzh1w5wVK@}Ajs+F*w1(+oUHsCwz9zOY5Oq~k8dZHB z*BDqfzF`;_OoP-hE?7Uw(^0fK#BsP74s1aftt`XXcX|kAjI=^Y3mFkEET6*|XrjDA zy+f1 zYW>>Uzl2vcS9j;SDfLZpFryiBRl(I*FcQw4Q^yEjj6I`4TH1_(6^2WytDk!I{F#jn z8p3Ak{Klr4=frWncsZ`;6-hOujt16Ia`ihtbwRxbkDik>VOno%9rc%1 zul?(^UuH}RnV&nK%+7CY)F1+NQ#C}-8FL#o3X`%=2j`o&G}JW?8~M(I^vs+~0|(~> zv(|%TZDD*YIzMmHv(i>az>1ru4O6C*bG0uR(TI~R?u;R659(=)Oc>p2v(c>5L8@}i zAvzu!wOZC1Mn7`HP5EJi{)2~y%8d-QrIDcO!k|xa7%|#mY_unh*0wzZJ-r|8Zs{E> zJg5`G_)M*Q& zH>JlJx%uZcvgsB>YYic^+N2o%3;L%EJeF`TVxHC1N7D#R$n?w+>NR_6j{F2oy6Xiw zm7`9YkW=^4og?s>np;|GVXB`7`9)4n&FFuke6{8T)&=uo37b^02*_dbfZbnfvUO3R zA}}}&wJDyk(XmPrY5(B?VBY5uU)tA1nH$k%+rztrJ;a6+HgCJ6uG$jv!#?-Rg)IxB zZMRM8*~W#<$6w(XX$kqE^~Eo<&sxIfhd!x2L)M+f7Hl%=ZS zAEvF)0?R{fL35UQ{a}IR<2AjkiJaQ_B;4zAx3QKXLAF+V!C{_y^Mt$r&gel ziABOuZp@Kv%)4Elun6SO_qS0d7&Pcg!#KNY$3 zXKBuaPPfRWbAHs}>Pgw5!@hz|=W67#vs&|OVd+#vHk~g=Ir|eXAu|f3L7#mKn?Cyh zo9u`CBahUaeTM#k$fp0JsKfTIk2=+nP3OfZAEr565|5KVMmhFj)Bij2UGx`2XWe?( zzh#zW$;8VV zSu|#ojP<@JXOrX5=g0b@8szl3qgq<7FUF%CALV$0g7oU*Y%$ z$EzJb?)VwUzjFMVW11^1KWc8xad*cwFPYB1jz>8@+VM$_Kj!$;j`?2DY<|`8w;a<4 zis}5oF)dss|CM9Ls4zLz2;-d`^Ua^h`#K)tc)a6N9n+9xX`3A{bc{ct>D=x3VaLxn z-sG5XWi4%9ehcsHxToWN9FK5JpB-ig{|VzW9iQts_^ikCh4wzv|AJ$hg-w2k;|Cl+ z>G*laFFB^&#q7w1Ajh2@@9ntO@npvf94~gf)bVo1s~q#~n&n}w-zu_*}<3>mp_PyF2dhc(~(39iQr$zVgiu-?kZFv?B{s2R;;QS2(`G@hy(O<#?^* z@4<1~*E#umvE3hkhg=ikRj2cJ$DvQ&Xs26;7Mr2(-6$XL$9Te7EDZjvsRTsAC!_EuTMg{0qmwc1%6V^ttaFzv(!m`=-fhQZz1iyu0H) z9qaOt^HnW_<8fZ@?0;MOCVxcC_m%{FpJ3e*!f?hg&j&9=Idx9%@5nzO{#|6AJGj>) zKTQ1B$R~;!<{0^OafisZ&ylk~_lR=p>HQej#*-o>w!0}?oOC2wFyvp$!$7>xw z=6Jp1jgBc7%Y(38p+Z{Pg{^#l*>(#B5q8%cu8GUT^s0%x^2Uku#8JjoahYS2Fi(@c zQDWKb?Gw2Mp~5B^s?q+z9>=8F8z#m+G6HUKKG@;`66(^rO})|5u{79e)TM8ZDfrYqkZ8J5B;`?`GMXAw$?hojA&GiY7}VOm@-5 z9cMKQhVvybCa!EJJ?}e#A?5Gaix*c}EN9kd>*d_EG{R(*UOiO+F<9I}Eqi;Fd&`qS zGPXlWa`vtfTN+_fuSmXSwP10}B=Gje$R5Wr_R3-$`Mg0BX{t35?o=c$PZo${S{>)6 z*P)BH#gt+kdUtAKKU(;p^hVl(=I9W({u{IWQR#7Jtg+`M#~<0*yF9R+2a}8&JAI5i6UPBVlaEmUGXO~y6N1MknSlP>$0e&dmKvv*p3=0%fNH&43u zt)D-#VZ&V)O)7coq3+LJmL2fefzOp*n`+)vwEL=uuE{%M-{dFyuS}*tl6S=3$+xcA z@SskVpfbDTeUGeLd)B8XuWerb#`ileee~07MW;@Gq@=Xq&@s|cd$C$6uKD2+f7b*3 zq|4qaEiWxCz1H%w{IctmmC}{dE}FcudD2(jdh(GCPh5Y|q#kd5tNYI`%PY-$FfUn^ zT@<{;Z~o2heX0*#c}Kyd|9$Hc*}N?8yjOd@T-xEvG09B@pXgY+duhkgWtTktc3AHx zIu`!oZN*A&Yd+i5C(LL2e_-kAKf|$==_3I za<8UYH?N?G(>$*@oO^l2MVGQvkmY<*+*u?jC^|<=1qBO`Ws12?6ck*n|16TidUWbX z2??w_v;5DZqVVowI7ld3p}))s4tgq@MO>*fA@)Hn7Ee`XG9$4vL=naFlFa^%TA;6h z4$lh0N4fyYiCi70g+MD+@e|VyMu3iKa|)BC}6x z%1;(#Rsd-Mo!FAU6Uh-Pmo~Gsh;!G@o{CK`!0BnI#oT!Z|5Qox(%W3-@A9S72da|D zSdw{1e%EmdIaa0JZ)gk87ELiPYxzigO(g@oE6zcsW88!L+6~9 z$||OensV()U32))!v!eBU(lg6*i#0=ayG^Uho7=E$K)!H9Hi@&rH-jKTP1Ua`BT|W z#iG+mEnJ#pd29E%|7b2RSS>%xP-zc?qAt zw)r%+xpAt#KxhibhJ0_f`%By{xUzUhq-`DJ!AHgp%$84wb)e3iJ7->Soe8lm-|(JO zFE@sH|6Kn8-5^3>&e?3i{0DZGfb)ns0XtFKn`2}xt0=;!)DVeF35NIDo_X(Hvf*=JuFFS z`@f^sgQyGt3cdb>2sSzn24J5n#xEk$Fa3_+~(x>IQe}}{+N?L$?EDUn>*Y%=TUR-}iy{@e zJ2}giH;w~iiqe>K)>uzaIqv1S(lPtO^oKZRUznVIVLZz5M8}*{rgOUEDUP}7m`=0f z#f~p^e3j$RIsT&K8ys`~nElm`A9Tz)Wjb7!jDO_#dB-n0{*7a*_!`II+QOegnI=0IxaQlszTxC|i)k|b$JZ6GQ57nG19r~k%9V2s{=X^vyPTV6h_ZGf;Mb5pYIx_c@10r+HA07F_ z;$tFTD6Wmnv43)8?itPatuD4t$R_J$eZ(=pSd*m@CVx^y1rUS9 zE!48NSJ}CJ?PI%T)i1mmkqyITZS0MaJv$D#FIfJ#*OR7N6X8|eJ3eAYvj&sw) zZ)TKa7EJF>3D}Po@QWE~3!0-xcvO=y%fFPKez{k-tALFy*8rkE##s>B%Z;nN8Z-F+V zzho9He`+72+reDeR{PkHAwx!{%G+)q+o)rOOmObA_FeTf%6hqXl284oeH3!zWdjH; zeH7}ZHSD__x1tg1qDi{cp!dy6J~)JnT2moZT>Yy1pW6 zOy6d=>A$blJJ9#zJ#3njcE5(rh$UH)cRSo znv#~+t6P678#axXvbpq>aqf%3f9h9T96jL;>%UMpiMel(^fmT8GT0{QM9PKDzdQ1= zI{U)=&z!oJ{S}G$)@RZ7zw6UQ(uFPdnb<0Rr*Mr##F}>@e{BzqcRb?K`qjU4zl)99 zZtEZN0(d9=Dewqq-%_wl4>H>mxO}tsu|r6&`6=^nM@H|+W*$9%6d3ON_L%%hh(a-PhyLk;AInTimI|_SSSl#mH=SKBVL?xE{)bN^K2tnK z3)$24*E8?i9DiE-1PU`7~6D zlVUQ{U)W)qAd{9+Uc;}n(2;9l-WlYaKq09or2>>ohw3kr1vjreZo}!ORToFOu7gTw zs3~mS4N;NnZb()7Ep&90>!qi4XFh61FxQ^amij8rIN=+*^xR302HP^`1m2J3rM@@q zcjcfS^&UEMyu0e`*7}eMck>U^eRNupCbOv{i0ipU`!SSCerfc&ki&%P?fR5Iqzs+B z(9OVyKh#j)_%1hfvug84S7O+ zyB`?R9^u1U%xKv7IddDEXZ&;BDC{(2u5&9F%#DJ}3WuIugKduDwjKoZHFU$?>bXaTc63|Nx>%A|-e%J+Z2o)@9`G$% zx7NaN&qq+BDU-B~_ca-A#ncK~!nU6ec;(O%TK6h|J-<^~rWVo?@t`T6jdaC|=aat{pl)?>>PyzHkG!)g+Z<}te_(7g+4Bka0DF(z6P@&Cko0yO z>izLJq<&%Tmu#6a@4bv^k2IUSPw_VGo9O;de~{x5jt_E79og(paD0;E$&Sx(JjZd9 z{Cn2 zKDBcGyOU>?mbM}SZ@A!S>K|*TF(awzZT?qCL#uD~>}Quk5*zc32-j#LFh&u_TsTfO zCyr(6?cN^GBk>RwwbET3LplH;{m~M$7DU{R7%Er$-k}lGO?u*hV}_-H)Pr3 z7K^>T#m*jAV6*p`n5J5D0{vM(XhyUQGOdhr)4N``g;A1OFuj{3@OOw`NRMO70(u0V z`Hflbr4v&{oeLIsyCi-)R%tuzc;?D)+wrj2(qN>o>>UWiU~%8ovbVQJ_Ryo8xdxj( zuFZCg3X^)-`ymj6*<-F$kPZ>hGHyVZlQWC-%Ah#8^vuUrrR4ut z^+=aU#=hIy^EG8=&(~a!3EWf3ugULJxlyM2&)g@-%u?wy&@W+pI&D=>^)T!Bw3!#1wKCalMC1@1#0 z#}%N91{+u4K5ev(D{vDW#}#0>ZW~vCE;Vdif!C4SxB{Gmxp4)KC;wX*SD+&)Y+M08 z{Mh=q0*vfn;|hcli{lD}{<@E6XB3p2hJ`q;zzy(rj4Loy8)D-M+)aUOeO!SrN;NmG zz_S#9jVr(fJ~ytwqb&=?l5t#tFi6IBj4QzX&&CyCocJw`E3g~ujpGVb!Es!H)5${|SAg+T zZCrtA$hU7?fftqhUvXT41K6xMt^i%j(T!B|u zuyF%~ z6?l_X+PDHUSg>&gF6LmdaRs_#)W#LKg*@B10*pDE8&}{+GGgNjoPz-yR{$5v+_(ZG zh_P`64rk&08dsnPT|N}9UaEBv!o%?LO5OI;u>|H-DEEY(RH=Bp=|#Pb=aN0rZvB%U z_p49}S7O1c51Hj?_Us#z^yKj;NT{0zI9TvGbVi$GoZzdHBzu0AU6OX-U-1WWcLTQ3 zPCM#9o~O#*7|-5FigY}MK0hKGpF_24(C{7+ZC`3Dm3>L7>iLd-`{ljU`a9QFU(dGf zx4-3cS^DhP2fKsyY_Nyxrhm`eoBi0czG~mC?WaBP_x8e6)W?g)cIJEA5NPbt_o2)} z#kJLEvmAFiP!!_PDjFY_)4w-#ZsjH4)ciTYXvnU)STjdcv-cK0w>m z>wKDSM*2Q9wr;$l_eyE+@|h01iiA!c2L*i z>U_OAQ7_)=P-k(=qK9Sc7=0^^5E_GMdfLOfI!>n}^_KMB8l65jshjo|E3_T> z4>R9&5AnH{h#ft_hjDg8Pw;hNVAi@hGv`h*KdV+vN?Y&MUH&xTXrvSNwDWqk&TO@Z z_pP@xAtaUS40*Hp}{9)91m9Z+j^RopeEme8HwujXdfMi8|yLHXWV? zu}|J%>w6o!$k`6q^pA*gwh1nY+a(PBXOn-{@&C~eH+k5fb!i)6o=D&8?~&Wn&ODm+ z%DIZro;K&xrDysx9XC5((m6n6B(otDFnez?lH)0k&vHB;j_X?F z_*%y|J0`ETE!D-PiMJ*;s|Yhh_#nF`I{v6_BLwy9v!C^Ebcf7yuDIY93NAm zV~<7);wZlC6f!~`1F__*wE&KJZ-y{8oh4r#NTkpkUOCwA^ zE_)R~3>LRg%idnG4){vRu%||foV{zrmPVL-l@l`$N`u8M)1tRGK=x)yhCR+x%U`I= zX}MYx;j268`;KhN{9})4b)1{t3wpdBC7A`&yHf)8qlG?d9H4%00X@Q_nv7XKS$b~w z=HebyoZpVCwH=f%+u?nPIL5ubDYC~oV!`5`lEB-$UiQ$#9?c6@F8CAKxgkt$m%SH& z7|b4XSNzG<(={ug zML+r^y`d!0C+Vl8F1rA|g6!Mq{hp+$Pty5{Z0nPBE(ubfq(75^t@_&TCg_r4K1uf|r{KcegbcYPZDDk znNQMV6v)5tlxZ+cnHqoKF&N^f{lTzp!9FNzbxiK1sKb#(a_{vCzgR=~!jH-9AY> zvkBiCqZO2v+)38%fID@nn=(Dg-uZQzFDp5p)kmMC5v(x!B>e$-^hu(gYd%SzN9TdB zs0jL(bj4=$Nn*^T>~{DhasM-)q;8~r@-6)z*-7n;N%lwNZA?jD)*F42Cc@DtX)$?- zK1nCAH-G*|Sv$4la^&0RlY}44zoJjlL2Op^NqStxobyQv=d$@E9mocoPZFbvwZkWg z!M}1oNhRz-^GO=QLQV8ZnvB|3eUgf`H*!8nbIFDIBt6W2GM}WQ*|Fx6v;nm?K1uzw z%A8NqERvc}(pjwEe3CxH!D2p1hhWrvlGc%D^GP~{g&CQ?(ylDWjWy?!bO{E`Cy7rv zaz05%5Mw?`$FuOh`6S^BRe0-Ct%Jae`;7BR>RX}Q6W+lm={G9E!f#`NM@XtW|CmqG zmF$w}lQd4NFT4@kZGDo4OV-LKi8^KBov7~cNlJE$-v?*McBYS?F1uy+?mo6N%^Y3R z9`(DW9r<@B0`Y&ePZBrryd=DEZvUssJA9G`O_!^H+-jNzHO-#aFnhjzg`9qjTo)a$ zhExrysW4o#0SPI1d|hiBVU=bRB-4dl|+fI+E;GWO@hd+fLxE~4q}r*4Pq(y`-?uRXkOhwD-+ccxi0=cs>% zw4ViCZ%2jE94Z+!IK{Gu+#N=9dSADbT!N-OC)K@qs+5W!Qc#+-` z{uRbq;JrVAM<9HW_6kesUzujK30YuylqP%NL4Tq}YEJwqZI*MsOX)RgvkNu%*3I3R z+?{u`6uBBon=4YfV)IMl0d9wX(+>Y8YnL9u@eofx-;c&i-r?V*!cf@Z z-;|caCcU_ej8bC2+6CF`-@+XjDHg!Fk*9@nDFoH-?UtQ50kYGyc^eM<@_z)t$))S zviGm--?Z*M_HR1zpXA?EsROh+?l=5zsKYbASQGovLVNw2YGtodi8v0n<=e;$IHuKcZhFOPffyy31=DNm-^5tJ z?eT9~B)#_dH*M5*P_AqT*9zN?w*F0*$zH8xPIK}{cuJEmmzQM^J?y=cf75fa_kwgR zm_6pY^yI?Y^7i>RRqMPwE0?Mze|nQtS3fX3I9AOawC(laBy5CZdXtZ{+wRFQl_ zJD9T9e`cj1w6N0nPpC|1&Npd;%2vKf2dH@Eo5YTjZ_=wQ<*Bhzv*PRn2#eEUy^oZ7 z^i86PIQk|%fWG-A(JgQR4cE~(sacV2eUs*pAoWe68>6lJCasiW&Nt~Z7>&M3pNGvi zsXq&;Z_*W*GvB1(2-F4N8x392MW%MTPHetO^wzKi-=u|zV}D5>m%8~TovSizzi$$5 zo#vZ#w+hgFlODu+^iBFL^5~mXrptl(CWStdKG0XOWhG0MYwIuRJaTXl@@^$%*onSL zKSpl8Nq=g?Z_;$qY|%IA9AeBj=_{l$-=t1hGv6dSrp);!^(V%BlU`uInQzib z#F%f=Rm7NY5_=%$n{+g}w*HdJFm1j`efs%~ANiSo6JA9L#XT3lCy-uIe zB~Orc3%*GQv)<^NbOIcGlRiQoqHod%$V2o^T7-Q2e3S41{a5r&>dj_F-=s@aJUQQ_ za4wr~(oiEyzE zlfJ`#GT)>U?cSVk(qpK#@lB$?rkromGpy2llW@Yz`6k`M!D7BiZ*sJlZ_*ML%r_}? zCuhD%IIre>lU88Be3R;kIVBF21^8d!MWe3Pz{^}<`0>YqTRAhUd+Zu@C} zNtG4a6hhDG^O8&@*Tl@kUaD~>4bs^ob4p%QOUFrnk#6A%Oj$i5vmCYENn1_Y-iqs0 zp}z}5>XY*t#e4o(`ylNU39;)Gsp2-3_l`c0qJz=<>Ti@)t?Yo350s4U%)kU&?FT7y zNca3s=;7*=_HeXWPe|IO1l~EQha+a8s@bZCBMy*0sRFY~O$DtKc$1*RBFMu`e`s0w zrB0W;0QMjh3`QHPf9kJRN+hwbX@ zs9nAbbZGFNb%vBWD5yPgN3Tf#E$&3;HfnH(;1yLD1|A8%EG=VggwBTktNS!Er=Zvg zNIQIkyc^s0xd^?xYue^lN`IC6SMmo6*B7oXzRR_F!{yUQpH{Q!)9Rl(G@@#1Au!in zI2Wu#BkuX!z?l>1(8#KV$n9nx?EJTNV$`a@{tNps;yY#n2M2yV`t&vzc>hT4&kh#i zsUun-KK1j-bx?#`PxQ}eOrxwfwV0@tpALo<_@>v!YJsg^9$w`j*TYPB$6ONiwfO(u zFAuBUpY`gDfq6XM(JxPuJWe@8|C$~B@~AKrcG59oWzyYoU&link9T~k;~9>5-EKA) zI%XUali%(5VaLxn-r={B?jw5QwsPCs@eaS0w0w5>t)%6!y?!fQRg1DV-`Kg4t`^pU!!*$G)K6Lm8UAVPfnf zBTNqeEq}xj4$wrtx1~2)I+jKl?9~77*{^q%Dz%d(W4+|x zw&P;4r4c4QbW&9SF<9I}Eqi;#@(rkz414e7Z*qX_(dU!}!(|e9djn*zRx<2y4qECPnS^H`ye;@md+@HP1ifo$}^b zv~x(9j8x`1S1nlnoWF^_a+o`4Tm9*b965AId;Lu+)aMhK;M`X~4|)#k9*DpHZ-0}= zR4^I#@?n&aLS;I0{wA&a!uf{c3bj`I~%<{BObEB!eaMHyMf2R{O$vRv9pVlTc#O-((RP zcn|u*VE`fXH@Tkz*}A{UDyioDO`c-?=5JENCYZm;*89Rak2L0Q(yA|wV#zNZz*C7tT)XH}f|+n;e+G$$jh}^EY7+wRLtL`0RwIPO(rVy?e;er%qB#Clh2d2E%=*oPd9%P-xtoWkZ++coG+58 z=x_1>B^muqdQvFc;cxP7>_>l-H^|!-{7vwZGk=rGaP&9%GX#RizaNvpnaF5qZ0f0G#;O6G5JFfrzDax@F?o4?7uDuBYTFV#8- zRDis{NlRZi_>A;@XMdAPn7Rj3<(jBNIe(METlY7qRtcpY-n8{Mp^mqsf14ftCOQlh zD$`l`-=xzeFIl7i9sVZ&@BSw5S>HB$xAblEt~^fKegy7&vU$%uOaAE&CGB#iNx!h4 zJ+HArUNzHa)zjt7%%-}j3+h8>Ff->QbyH@Yl@1(c-Op^ZTbuvno@`QwA?s@(?V6{4 zR$b`lr@m=w^UT=|=|Vd?w%L{^O6zrnUJtfsysiJ7QMSw@<$ZNUv9@R1w<_=dbnlcM zekuQvgKMdJlM4m^g?=fq=_}`#qF2AU!1G15CVSSvFNL-W3&f|+C$94u--Fc_E)%V< z)6r=qmnOBm!*@mg=qd_p2kb4*sLh2iNRzc!j&OXC8F7Ri}<-(zKRuH(gyuW~O z>6n-KCV$ECUmX|fO^NC3@Lfsw(QvgLTbUf{c!%#wT0T2`SJHBzo?!Q^dwFl9>mA`y zvH7n2FtSd$>_!N+qFgg6U{Fz>;L$rv4UX5F3y@a;DE3YemizO$2?}hKm zdH*EemDk>5-<4Wb=qh8mY|D4$CEE$oH(VyB%xg3e7RX+$=9Dw_aN_U*33V{dIYtQm zbaK_G<-`K^m_q$bbJLqH-;hzJ6m`&R>$~!0>9xmq<$39~$9Ls1ZAW{2SN@N^H-WFB z$oBZVZ*FdGk_#l{62c})h-|WiMMMM*s{v72!VYF3VNsTtgjJM?TVNO`AUeRHM8*YB zW)OA61t)H}fy20s&gcv>Iyx>hjH2TT|KG3b)Xf2P)Oqjy-~0dH>rXoUty8B?RaaNn z?e02V{Wk1p}y`Q{&*@tzVu4r?Zb^UGgqtKk4A0^kT zz`7q5gB>UdozLt_ zeHusz21h)FZFo2njJ%Qf7;+4rOR1OG1^?&>mBfE>EKfBQlf%KYc^*X8)97$!?nUaz z=W&mMUhrfF&i@kwGih$@0^(6fEv+4xGVG{Mw-<&mw1f zDF?8ji^>S*T;L;SIMJN8Ui=7hb?Tc;J(6Yi{M2|VozDP1*OWL5vdK^~JA%(Otp&qH z<)_%#8Y>`rkqc;I+(2M3GL;s_^8-BL$Svdv{LEGj>V}pQci{nb5$-M52?J=2DX;C7Q(ymitT4-A1Ek3X#iAOh%NS+QO751EJ75I-O~*^!Z(( z%w~mi%f0xk{T=wN#CKd6Q{z93K*wk`)2uRSxMA$kJ}pm83g)Adtm4b*pJ>HB)&e&PD| ze}t_nGx8Je{bN@n&z#6?>O65TxMPIANAXX+3hoklpZ1^r2%OuvZ~;EKw2$_CgHg); zEMdg$%}tJ5!K;7*Tl5>ktp+hh5Dl+UCFOjg9{=YppQS8 z49UbuUzXvJ2c8<4O8K9uU+SfE!=uui`_r5|(%b|oM{O=gRKO3@Wv)q()oBv2xu^st zC<%5VDubz-1Xoj?y#se$sZ-Qk)E}e{nN`xDgVcY5z;u}0VRLQ;Y`BFBqwhV5yVb_; zfwHHqz(2aEOh$av^nUFOdr>ooPmXD@!RS}q`;$#W3L_h~t|md+Orx`9M*IMOD-D>h zm7QtWi_#?#Q=%{;6y+T{TvT}R8i^Vo8Rw#sNZD>ENpaKY&qx=Q&uMWWGoIv|9yxlw zkHBOpl8;@5iwa}H(L1R&)g+0aWE7@-fGp{vaw8gi^mojEx@qrTbR+|%#!)jEy%O1B zN)#UDNc1CA2V7Jbh(>D|m}%0tj`FbrTvP@^J105}@t6{YY8|8eS%HfR1G&*t8FP^d z^o^d%7qn z@P>&zVE*$eJy?ng2=(R>X_-juZ%T?R%}>3*>HM(FX>umX$U`WCKX4#8ux3;ndbRMi zij(|lnBn9kf2!XDQ>FO5PeQ-4W)us-k1e;YMAe0!o(5&x>lwJJdE!a znK?Wdlj!^Qn?*@k-te^UNSK_abR!MA{KiqEG(WC!gQdpu1tiQG!q_IvnMPBLTD;3J zRT)7&HErf~Kub@H*@|bWqN4O4cRq>d+$5~9yo{d?G9O-QrDiulCARJztAHOe*$EFc z7T$+rUK4K2CE|BZTjH({nfOm=d;#w+{Qu!@B>1MlgD_T%-F@ct>0giS z{+}@s$hW>UUxjbNbd{+=x>qi#{5OX^^(*-QCD!b?3|<#Tz2hDK(y|%dX5lcnZzbV0 zEHqyyffPNH`8bJ1Ga&#FtrjO1QsA^Z%a02r#$mpaxWvZzzZ_izy-M&O^OxYT7M51d zFPv38uXGOPiZK2U{Kv2FR6xj2-l)$X{r|^l1eb3A=L*7u9Q&vd2lu?fd9&x2RC<-O z=2ui@9{>5H%GopL{hJOT!-kI>>J@&M7l@fCVm=&kY%AlZEJ|mW&Yp)4l@#L3Qf!j^ z`q-S={D{=od_KO97Z6UV*gj34RgBm0)!y3AL&5K42`8&S=El{f(3Txvw5md}ScbyN z<3#p6DV$ff7;$q;)R(Q$Hz0#~_-2s%$`l-nigB7@FN*mkq3LtVis#`vws3Co;zgx! zNRsaiRhIFqV};Y_FW^^)3Ktg7S-^ACewe6yekDtR&koI-@7bL&6-N)IxeMkX$`<9g zPj3C+TqV|5Y5JV`m8i6xzG_Btlo`DoxGI5wvU+07|Jr8Hbbu>H{v z8IMxU%6l&^92aq8L~Ms{>?lhyZb|;r=l|$Pn=CAr@8eH#4)mP<7{%Y_LvfMPS*ZAO z#n&pnPVr5OcPZYZ_z#NTQG7(PkB05a98ug{agO3nig_36(vDO-Q8Dg+V>)XU-=uiE zVm<_RHXl{Y`Hr2O-&b(V*$y3lsF;ttoIDvFnBxq^If`=?4^TWs@l3^)ikBUpx zKdJZy#eY%!kzzitcV%v*nDaP0c?ZS474yM|(>YHu--UAW1&aAycqjjf;!TRTDdq!E zr~jDZ1Bzc){I24EDh}eLcXs#RM@pQd=Q;`0@+P}~w7mb2MjaWBPriqBO%Q*o8z%N1X%_-BgmSG-s83yKda z{y;J3S8`=;thklpj*3rJJV^2Ril-``t$3m0D-_o%{+r^@6bJER<$f>1VE22`nsTgM zvdFG)C*$1XGG56Uc4^TZV$5Vt-b68~%JcaT3xCU;P5z!a{fF5vNnU&x&iOmIZ^_{F z@Lm)-AC|GNqYj<}d4Cjc2Ilhb`Z(Cs-~B(6d0>@YGUJD=2e&wG1pzrvBGzMvIf%kB zXQpQy!`&q8>~Vb9T~`8)9=CkAU)#F{_IM3Id#oR4uQ!U6609x_(EAX!_?zk$hkR7*m~mIaCp60`skm~m&UYdXWG-aPm-#V{+pDl@d$+<~ zCS-1Lan%rLdo{3^0~zh%v24uV2Cz#5^qzpdKP!R5b&@8JN?7iMJy*{>zg+ol1v3rH z&SfhKjStPo7RGViDO;!aYn)&MV_H^+diP`Haf~fZzn?EdU+AgB8{5adFr@3{2=;^Z z%6j3s?Dm5r&&=N~d9dfoN|}p$0j%xuB%&Ve@!_kp$Ns~$d7xJgdv6eAarU^CF3H3c zptH$^5XJnL^Ke{=cF%svEzX|!GR)DJ!WLjE{p#AOU#?J5Un8 z7?JR9V74K6H?Wx{R4~EFpAp}HdhlFIz3@oWr~i0mOWtcZ%Ae-<4?2YHnW2Cm7FL)-R3j{ zJwbdwawPdT*y;E)$SKL2$^FUEG#Qzi9f5ztD`4?&ur+4=8K9n zyd65;zai}W8^q-C{tcW9Li`(&55SuEHzf14j$dHxW4w(mBkhk+jrlh;;Vvxnso+Jk znW^({;H$n82uH7N2t=a0SmsMjnv^ITWX!+eAglRu6O$1=%rsY+K%8ar%N;4VNd>jz}3iU@NpF@82GH^jMZ;9g%CPFeXxr#^g&{4>zCSOJQ zpQ#W325uVs8@MCZzkzbJOb%Y7%jC2Z;@`lC2LA?=zyu}1iT(|>P;c;WFzOUF7j@&` zKyL7Fpbj#le}m~V>EB?^t$+=4nRWnuff?#ADdyNP)$L9c zR?dLq!Mwt<#j~pl;W~r?`swrMUo@Lal`}aeAG7wuyh-dqC^Ea@GvPX#2BZzPn_sy!mN#V#O%uH4WGY()Hr%D);fHU{-yf~PbB(Y#Jo_D zf-URo&M5W>f1|Sr^DTqxiLHr$*XiWjy<{-y!Oku+mHUG{ zQ~oPvBVo0`v#6AgHRDF2EAZH2O6k)BR~j7C+4O%iUO4OlY^lvjUO1;u?_%pdf(BYR zV*%WH&OUEk=HN`@teDw#F1rCZ_ROiw>^d{E>-pGloiT5I*OCRZ=Tx!n&9lx#uqGS8#EyFKIH~XvIZT7qw^CiXNs%~@OrDl^O zfGeJI?)8bwan<$zIe!&ASXK)z3RH;CFWm^36~}q$C&cq9c*7EhxtcM=U=}tR`mgZW zxLZ;HdK`-3b}kZIh8r%Aq{CG|19C|c`>mxqFUPsy`o;5Qci23ADLU@n=-6!*vbmYW zmZB)yG%twpxZdc{2HAaYhqrr7OMB#GRUQ8&zBF&&8D z##qgrg4pS$()LrFubA&hI{RiEP15ou04Fb1JX>*<;^m50D_)~`lj5C>28($h><4YrKd})M@ zFO9JAr4cs1G{VMzMmPmOGOleH{~3{YRPx@6^AwL%JW+9};)@kuLdJQ^h4T-)-;q^H zXB`?FJz+jj`-d>g_@ywfDfnV6)ACvd4_plM8l#bL4w#EC*Cd)* z9#;lFRCdfXj;a5BmP{z2SjYJk$zd?bSjZ(e_YUk8Kt_A4LuaoynD!~-GRtma{~5=H*DX9|-=#MMIxY>+*!!mPo#<24 zAD6KC&}aGZKt5JJb1j6hTWSH_c;IDmd5uO`@9&kc7lt9)qq^JQ60l1H^d3g!`%2(& z!3lcX(ZI5pKo+N0j1|CBk9v3$H{clLIJ znTB=2r5Or;35Lns!Z@yv$=2!B;yz-aQ<6C9?Ze7;;g;V*udfSWOC2tM#Oj#g#Hekz zWG*g_*SC5xK6V&K~b6+&KjF z2EyJEf-KG+x9F;33%>zW1R?J?Ts^0N*|xR4^*GPF#8NesuX~Rky?Yy zlPl`q?W0t{9Yi5|n|$rJf)a*yd$fAA@BQ<|W5+(h`o!H^)~u|lskts^_}aVr1-vgV zzw@nvi;o?v+&MS>uFqEA&7^$>dh6-3RQt;w)hlqUXL?1NK z8{%+dbjH@&jl1f8-DBg%+O=88sCL8Q+Ku&>Y^&Y)^9|D@Nw;qeL223N8*8ws{&kPq z^}8bdH?FVUOx;~if4Oth6?b{wZ{cru|B44{4!p7pItPB2we$7*UE9yuxd$>tSO2}o z&fU8n*u8Ui*1-qs4?X+k!H2GR^cUCFKfB`4?FXKzIrvQK_B-pg*VR9h`tH8kzt$c6 zTV4Hgb@lt}B1sSIyZvX4BCYB=XC64^y4pLgsN0gc>!~x=-aKdfgBv&Aw=Hq)FRrWG zR=@qhR{Pd&UAJ-H{gqFTjdVhek%utAfTh(2RN_zX^dpHox7BUM-h9xiW@WEPc*Ee8 zS9FbQbJ(`~Z}SaX=%ek@PUB3k2O1>XG5-5|A@?T%uP_2QdP2Yjv(oU%E8L{cg#>=(Eh`)oOaQsTMNtnz{FrJ=HNLOt)@0xVs%?JfMP_&fy!torZ4z#7w z5bq%aS!S#@bTK)b91M-d|3Eu(I7A1UKn^()x`jF?lT$+XlG~G`p;Pcb(1Dy08cKOb za%;Tp5AHCR-KcD0{b@=36|n*4Z!RJI-c0!;1e0guV;iUP;)yreUZdcZ=0D5Wc!@z?Of{x@ z6aM3Ea7rn_H~*8p)Fx03W^|_(2R1S5&9_cnfa?i8K&}VQ~TZK z;p2yn6V(g<_?Y~sE*l^f3B74(+9-*_{L+6i7| zG}I0Pmtr`CQdu zf*XlOo!jMlY;MLH@NzeE3qAZzCULn3Yj-1xRRVj9Hbyjs8eI6eiKnni=!)WdF)bE} z?UWVa78b`Xzd&Tb`xL<+JUTyXKE{h?FD#zdox@rfNBwuls{g%Fn{S&;K_2ZER^atT z>?lV{Fm8?AbOYPy?#&nqq^2Tdx`S?Rx`U7z$MzFb&8T&v8QI1&>$sp9uj~&8jpz$AMEbLRcmH%6;T`b8Hk5 zV8*bIvu^VHdZy6jDEOS|7?8wJC@1;gsdR!{#3D>Gz{)Q;$FXZ;oq``a z4ywH_Xq{R8w+?37y8(Mwp!!qqUkzsRNdb!OWn;Y=D}RN^c`$$Z(( z=P5SN2gS}(C9hSyN%2<2_b9Gcyif5fir-XxSn*ei6L6e-98)gIVD~&dopLE>CYcQt zOHU;?7s(=LTXH&VOD-*M(Ve_d$!9A$?^&GwVkN&+$*)oJ)k=PYlK)J}Z&h+L)+_sR zkCNZ7^v!b#(K(=WUQ#+7S8)6Cf#Q=}((;$q@y``+SNsdbyA?mAn9nMlotG59 zuJ{eb?@yCikQ_P1S&OTrHaGa)?{s&IZrz4I}QOx%5U8+H#qk!!A?*8iy<;B_eRuBj@r!$I-%OZSORa>_b>lS% ztHa+h)(`dhThUcG8_eGY$~%Hj7v^u;S;FjhhYII`*>6yPFc^=04G#rR5H0{u6D|W! z7oG)Xy)o^D;Q7MrUl$0oon9h*9r$wL>%r_#n3lh9KNjY1>2<<4f;R}Wjc*pd8O*+g zY1zi_5WW+9moWS3`-J&B%;%HT-vfS3xE}np@Dt$Q2=hE(pF@5AR{ufxUGN*i?91O4 z{shdvi27{r9|?Z}{!Ey!ryLVzzs~nisn6eYPAyL6ac(Qz3EWAz3%HkXckt=Ld`@$g zFwcXb!e@fd5$3f4-~6L}9`gypXM_2&A?3rt(}md_`Q})XtDV02e|MzgsWTl+r*_6R&pLzE}u5W<4kN@ zVr6>9G2BhU&K}Rdg;GC2qsMJ0;XDSg1o30{CAPH3{>0g1S(uzME`L5Z8v7@=Fpld^**d-ZaX~fEDM=jl?#HUfdq0O>-xKs0d=@M9-O>}4#&+fw z7q=GzT`!O0WOwHWb}66Q?PILX1HFe~ z?+t=1&K|d_y1Y90rQ|}$^O`o87wemC(Vas;?*I6zKEeAjqyuRc9w z!1ueyd$-mgGZe!1Lw39uR0+T zy(-cJD^q8jR#D?`$sV?ca=aD=ACvCy9{iL)V*BI=ZEV+sHi!FM?sZD-7+f6f#_%QTt&GVB3EB&phk&G2n{M@@U4=$>= zW(Fkf>&y~9pYDxsp3v&`qStFbY~!W>J^oM|Kl9k&!_`Ns|5lI8x9mT9`0$ZKlf6B` zcW>L@WMvjh@>vgSy=rm^rfS*^As(_JmScLr8JSifsBg`W>8y0G?e zcKxC8fe=m_s7KnDO!IcdMI$Zi?#P@qc+21@)R68_OaIVwpCZrkXaBtdl0~&!n){K{ zwmkD`UEPsk{9(!5IJma)eCAXn)~A?1S8F*c~)OlyDP(65sXHfjhdJ_W=M2@ z(6!WQNvp5k5!e&5>B8!3YAZ6ln!&gA ziBwGVBMB7~1B-Kpp$AP^(r)eEqZLgnSw}HNgl6#$gC=$TVvJK(9tr>h{e04$X;+{B{J_wCk zR9{|xWN#GZ8uZN35&2u9-k!wmTlXhyNd2qS>FY`BQ{VAdcV2d=&EZ|qz|sxnf2-dg zw@`_<{6WM{w&!|X5W`fC1o!PNe^rIKhzz$N4P z6~cv2&4}tDwS%I5`{+wJDl>Ar*i07TC?S)EzGzQU`n!>yEklun)BV092BrA}lCJLH zwL1Iokkk?DpKsv}di?17H;&j^k>RgM3k_=Nt@Kwsa}*YK1op?FX6(+Q()T2dUmDt* z>5a%=8}&ABU6J8$i?3Z@zoFT_K38XTTe8oN_50Emx0IZXe!m&A-xC*U{d)WdA^fU7)N(I>bJsR! z;n6#qD>6ZY+L>cs!(k=Ol5%v?pm(zo!Q72o$|6 zdfVFV8!_zf$Gq9?YDPy|lwWz>mT+`Z$J*_g6Z5y^M^`lSUMW6hYpa@357eUi9&P1~ zs;Nbnv+LQTyIOhAPxMBus*NL(TM@5?|SyjQ4?!-jq``c<&WMyaCq97iz1}Gg@7hS5vzs!yEI&(NUw0ph2CpeN2IuH?DSVG`MA)52YOegjS3T zY`ECg(w?OC7pHIh$J&D6>eKFzL)UYETGtRNh1YPn4mgHU(q$eV2(f=~%liQ9yObM~ zQ^t2dtUNC!e+s`NsN$Hfle5F`r*4hO8|)O}f-FBK&y3mG3OVnQPt5mlyyyKYrr%(P z-*L%~$s6qKgFG!}Cy%};<{A+H{np6CzX6H(VhEQ%$(1s`JI3o$d?e?56dT_in~qJ~ zUF7tkj0hzBi8jSWYb-d>@&ZN#6Ru$(9RCDE;e-L$#AWi|%Qil~DdU3)mm-4EZwd~QKha9S5gLczQ7KOr2B@AncQ@g?ZSpRpR~C9?A4`&R;kUeb_31(=8G z9t1+czu z6F1>&EO=|bpbGX9=dujrMk0ZiIFA{OCkGRmG&F%3gcGMxXCmd1L{2glnnX@Xd>j8m zlgZIU-Y%O31m1 zf5QJzDY4@S)~Zj4!HME#VDZ@`&&h$$dXzizQW~$Iq9-2%)?OGbU zglTg8v>r^ejDe1R+9OoElz}dOS`A~CGmz`26)Y^hs~LF6Pdm(fYIv0E{b=cI?B_~$5wG}O3g-mlDzy~~vK54a7ehC$198=66eXOJ zFfo9<5--8Ogh?#Em$(G~5+;*_iT&_DVG22%IFdS3S?v)ot{ABkrag@unq7i_{u4gS z#N~ag{-$y97y$2$ba2ijb7}qo{`pV(H0O`afDZ(|SZLDu1uZJes$7U!v@C(|-!uLc zB=yI)1V8Jurv34)7Bgm_F;WFd>z|+`{(hf{0&5D|^kHe9Ggj9^)P_BVgzo~L)Di!> z;HSN9E?@wF)6ZpME*=b6v@M5h3}pW_vT1&9rav`MX`(9-eVat5qg0vx*P`!5bR(qf zXQKlPpfoj9<*gYN%4QBQandu;S%@66-T_<#fJz(`cyJy@(L+J*NH(AR`{t}5C`?P zeEX3Ntq3KEwWKPbX(eqtBDx;YOHK5Yz`|GzUu9&>I*Ey;$>J{pW4PmNd3JWGPQzG= zM&^8Qmk<7?&0%+THa2Hx7Rr=v+ENpHVjrD z<6E&RqUL;k2a&B1YGza!YO{p3m~K=->vN>KzE1qF0!rzrmpCYb#9AvrrGM%xP=G;}LFSI#C;bhVfOXmP&IxK0&Z8zp%)< zZ-RoynrrL;wB_8ajPCZ$(F4&07@cpTb%$CjF*Cn8;RA?fhkA{THm3m_gEa1w_95PM zrf&kIGi6)xn$18eze#{6pS#%gHzh<|wWkDlzGJ2%`Atd<*x#fUrkImR()G|D<<4&{F8vq&G^6f@;fvJ>f_P56G5$pB%W7GBm zsIubs8r84;Ud=@`o8tRlw}hNrC9i;%spKsHsbu?$)#+27HecDsjmT^i-`}(*R?A0C z_7pDi$BhkvFyU}G7ahu~QzSb<>rc($8?CcK;BG8S== zvHN$1Iil$g4)9{CG4?Z~f>$j=0?a9}#%ptc(Zfvgd__C7ZBF+=8rw&7Dyn6_`B z;@IBzBNCOzE17A5HF@kJ*W@4f6VdidsD6wzZx~hk1C)Xui9Zrw7}*qj9#Wb^+Z@EO zP4OK%+Kl})Wj%!$`^#(lz7X!r&{R2BVt6uJaii7PC66zgV|qg}?bw^CQ!Ya=@l>9L zY-^2pdNyJ$H=?M~NRZd1KP)9Txg7DKASI{Jeo_W4F<)a|-JqS)5`ALg$>z5^W|JYW z^L|)L?9JZ{o0E~AQcZK|w9M+TmUbXyi`ca{&2=}0GR5O*ZcFyB-YbEnIQ=q-o_bL} ziRs?#NN5j>VLh#4;_``TVe?pN7K3n>Rxm$G%``zN^{91Y=*l zOmXjxq`LP;nj#ai%DEfURGv5r`~aqlMX(th@A;L^uYb)F7sWPacp9fk#2oOkAjT*% zBw63l)TNOL_H0Vq2*oV%>)^CDu*A$RJ`*YM4>6t($X^wUMc2UCeS3=%oI| z>pJbE%=lU;E$2ufC3vz5Vi(#=Atkm$!`nAZ+ffCf+$omp*DJ1bEH1eN-rHf>Ptl^` zX;#=JHZ>&lD1?*DiF#;2T=rqbOF!Jah}BLFNqW~taPxjF0uWpHti|`nakCmLQ;yqA zdca0-<5G^>jDT6T;{PwO;_Vi0?lCw8|INbt@l>pMt%w^Y58$Q<8?$8MKXdTC3HM?1 zoJE$FnvmkZSs45XEB1_=y*M9XXNZZzKStB*!uQ5yq$Jnx;YeGciHr6KtQCg{!dq4DbO01j~(pfg7l{1C0OIUrT%6@naO7oH=JkK$O&|9Q7;yK zg)&yaI;xJPvt=J6MW>jrvSM=qH#t}{V#Vl@v(U?K7qDgO+j?^tmO0-yl)33*a55ik zSgVtrRhr^$C=|J&)ehfgmHXRtk(VCr+R^vY(>7lV<&7q7AvZe>PV9h8dYb$uaYNS$ zyz=F5CXBUmmw6N^n4|AaTNg8ML4Hhenp5O)W9^`3xS0fHG^)HA*m8f!5SxWJj(mOz zRc`LVYR@dvuWST2yw9=`I^`WkVJtT;<=D+6s;h?jEOL3-^oOlMf}5gPgv*d7 zQ;fn`Zm6J+C}V$z6&2nBG3~LkwA|7%#M;iIMsplDFB+W0jmxv4&)owludUFl(&|`a zX`-{lSetx2H&*ci?2oyj!YRqzZ5rN}nB_N6s&hziG#znuH!Xi@j`$nK})P({^+!(wS`rv!UZ- zA;@+GnJeZK#QbJwG%;p$von>{U~01~X)K*H$l^bTOD;4=ZeGG_>xlHWjo{{kSj2HD zks59AIc$zv9w7b6@{z(HY%=Jj`rY-b7~kca!Br zXDQ$oRG${%o)^j#d(ECZo7*V)zoXmCR$i&17$5#cv%q5*_RG8mvyxWt(8i z)(Cdd*>mH{Ga+_ra?-P*Mqwg1+<_)I+8EDRK#SQloS0`b&w_nRQ>~{C-`G&c_PhvGudVkx6DR$M{a5AvcZ9!vw3z&H^vHXKRWVVa0_MH=IZ=&buTSJ6J3;lLzn~AGbGQMFsD|=3XPN3UkY% zs4JlY1gDwkOU%|~95~;ApJ-=KNHJ_R?TiPM+c_8F5*ve;CpO1_JA;Fp#~~q>%32PY zc^v%2*4Q!mG6FIQVHOE%KlXhDnXkdev|g@kZ`+9x%(oQc5)*CV_}@;WU?)k4SMrdV zh{5fWEjkPBrd{Ba61M1e8i`92SzJ5egw?UT;q{X|a7q04NK zm)mPw8!VM;h*r{2=e{%@E9d{^W^xQy159g=SDe{LE1$voWSODOBX^S7w^Wld(Xjnk zhqblT>`%n}4^#iRyX2e6Z7A8 z5=#t6%>PSGsocaYcE2)B8JN56Jlr%dHg}%Bwrwpo7LsE1US+~fOkG#-$e5$i*qrc7 z*%6>7xW~3E@kYE20ZEVQ28F$vvvMZ(CA6r)TVm8&+W8J4|c+}#IHLDXa9j)E-fT>4YgLc{+yN^~g zEaxFxh20B#+}+QMEdyJlF6YahF&Z)zwA38%u=#Hfn(Yj9#ksD+?wI{=Pc54Pt0rI? zQJnlneE;8+bW=FmJny(J#GXR7K{J=jOsqW(1{h8@K7aVP%Bu)DH96tkcIM!ZAzke%b9_G)U~p z?;5M^Xd84Ar76>zt$AzH&1hsb?NMOOC(3@&&T_Sn?zE%6`w42u#WkY_JG#->eYXwW zHbGMo)G4lMXH^xKc=A1hd2@@)D>0Eyx%r|BJqIUv5ZBpT3sJIZ{G%5Bf@Kup=Z~mN8d>x4&Ix)H7 z`p+hrhf6W<+b2r0m)6~nzcOr?R>(|Yq&}ZCV@5GPxK!blnw>Ej7b2f|rG;~fE2|25 zG3b@dt};75XMRO#nVLXoe#wIA7h$Y??9j8%9eQ4Y2d7NxSDMSxa*qWq_ez#jK~l)8 z)WX^GDlthJ0t--#UOiE5{IrUTtt{tvIB+Rzzd&`7DG@81L+Z!X->gDTaYV5xWC?2P z>vJZVqMLZmjaKTFEv_t^X^tM}twJ^1!}s;+oGQzUr}HyWEHUyhx;9i=Hm9r#hn$Cx z#|DS3aQ?y>b4*rqix=ZSnF_%ddGJMo>(iT^Km<4@;1$d85fq%=K)<{>cgYN zn{Ep;A4RlPk1KQ>-+%9><6qC0C3kVQZs0VrpaKOiFXsG|bC*~=5t!vKwMTK*VD=+c}jT@Ffbl?yk1{NiD%y`O~BA7$PIL{fLHGAeP zn|N;7+_|Vu6b^o6CHBC~m{W|S`a@^X;u*n4gB`bRtK8$!LJhfH<=&WM%?657zT89Z z)904|_fE96UT*fe#eHFH`KF1sQV^SswXbNw-^B1qBInpDZbZ#1v>a0CDe@m-OWV}v zz;QRMw8OFKs4z#7d80}B^H_PiN&OeGW?-e91IAp!9W660^<2TJPezp*eU1)0n;b>u zLLKsaY-#h)U`A2S@mp?9Uf^EBoDzZgFfI$=%FJQRxuUa0>F`~KY>{(Jk_*es@yNzt zia1clg*M5V*k)t>1k5NhN6&JFIh>d#dXZ9nOF5tEbD^A^jxFUSU}wJ+?AkL&8MsiN z+#6f!?*zMiIgZd)2Q3(waLFKoe#iVxW9as&$h&JWa0sgV}y)hfn>vm^ufuZfTbf`MEG(va`dd{amQe zXW?zY)c-4(yF;6NBFu$p$pf&Z{1o$~)5^PmnU3;q;9G?G2pfM!{we_r?T~4f`tBJh z<^Ss@0A#~+%fB=KpLv-F2H05#@N>Y2%xrwWk}x*0CC(g*SPmdbz?52U4WN5=88*h zt{QH2+-0M?@H*k<;kc{r<1Wlkyu3T%s#`9lMA~qFbKC{24WMx9y5HWJ=&O3{B0D3x z^>JY*;IqfW!q(?YlVDvqX0*@V9t%5nzqvuv_8n(Z-onar$fDCxaTle-cI52yg3ITx zB$obI9p@fs)f9!|4<$E>%2B@f@=3V>wyMznCm_wTvuvRZW(< zx{@quYsivzHJJ?$OD$HXzm6<*bt*WD_WvBVV}*I)$P3J9WBkKHo7AEFCuEU-C34Pz zbr36c-p7`HaO6j@(lwBLJJuJ3>4(LOFWSk4jlMX)s6)Rc`YJg&ziUQ$5w>*3A=9g- z3sy2Ok~qf?xf8b4WY`=9oAinxPXzB29lA#x5ay5lTS})1!nDH+g5ko{DHP@p{}RPJ z6nDk>%(VQ$K1(sZ0$7GBl;J&*bBvSU(xN_pbYB*xoQIHd9=A;4j@V|CVF$%E?7q*~ zS>$1C$?ltsy(otrwrj3r9=pN9JhtrjXfq=0zS~$SI?rKyi7?aFk)fX=?DV%%4*S&K zC5(-CpD^W*2)~H!<7C)jGbSfXyFDcG3~b5C(uUizT|u9}b7Uu{Ln7swkdu?8J=4{d z<>5`pB4M^kz6eV>Z$j=MBW(`SlAX;k;;F-*G5S`Lc@sjPPRHkwk(S4W?9yH%I=neq zD>_}ELw04`C_21x;<-VaSy@y;TAh68klnsSDTfYkPI#V^d1J$Ko1BMjKj9Z)=R7j<8VNgOmsf%4 z9Dxqq(3qBeL%A?-T9zojOfkPRNSg()Np@wU*B$Nfrl?MsH${8N&}V;7cKUQQqdsqJ zUK8fc&mm#n*nC1p+9ISSyR=6|hy4$~OGrDs;W>j0{ZijT3)-4Ry>i6v^*cVy0k@P$+r~Dw7jmL zt(fhVX{)g1>e8}Zy0mPIOk0Esx?C~a0n@I=ma9w4<~02ygt#Fnc|`wCgozD6A| z?^)hZjG*Vs?PP?EH{-aN7h8mRdFtf+d3HAWlR%qX*k;_^pKLQuzq{f-iqBAN+Jod( zpyb7hXDQ}GNoT)GF^{8@*C<}2_$I|aSG-3t>(<%9bT=_>u9!2II33RQ>i7)BXDc47 zxKOcqdqwvB3MH>qyh-s^#rG(#SG-R#Ce4VIjn_=BoQD;EshHPJPKSMo<4nco-54oz zUnL)+c$DI)if1XlUU8k``xTp)ZzQi5l>DIL&lGdI23O`Z#hHqE?c{X&DLz|qf#PDt z^AwvILZoapO3qgboP9nRcKk=h=9|ls_7f$KL!aXG8!P6!5V7+P?9RK6N~ae&35^#^ zUnMs$_=~(o>HJvf@I3~X@9j$GP9?uj$sZ!4-nl%X*m%l|{8J^zdy_GJUh}xLLlpA? zuq(qHB`*haf8R%5mnfa9$g*F&7IJCVDf!P8?@|1y(%+}#uPWv>kF&}79$a30VC>}o zRPryCJcN$b={Hl{PH{)Fw1J*Vewvc=8q3wyB*n(zT@-!}oGj(ZQgUANIC-v;4^V8rPc8df zOu6tSimz9ECt32kPstwybKiN*uvh8)mMr_udwG}k4JH4FVn5uVA0kU$Cnen6xS$Tqj(Eh^4+22cY#?~yl#9*={!ls z%4MIDzoq0KD~`u#p3`rpxIJ0&?V;p-lzg<}BC_oJY{i!<-m3UX#UCjCL~$4wpsoy@ z9?aQq4mRxseN48}=}MM;=bY3o?S*71+gc^RQOR!x(lf(KSJc) ztK__Yba~Y)ep2zXihr;8kBZ+?{8z=FDgH`v5cd%-->_odH#s?HnsJ=1xV>UdvgUO9 zD;}(v_f}5lJjG)a^QCvE!|$RvE>%2BF`qL#ol6w+nX{8$t(eowIr#>~w<+fLl$_3e ziXT+`jN<1MzpnTV#qTQqo8pfZb1cW@8^Af_IHb6l;ueZ|ujll06!%hmn&LAR4^mvD zxK!~)isvg{sCcR3m5P6?c%9<)il0#YwBiGbUsTL-EVsXZQv4Uie4g)gK2rQo#k}`) zI!TIC6*p7NXZ}u~_ot3ItDs{(+jq=+RmU7-b39D(2*sTE&*^YHz%eHea6DUarQ$`3 zFH^ii@jAup6?57F`;B9 zAWpwZ@nXe%<=*LBp?Iz08x-HD_-4i16muNh+2lBp<9fwUDt=b+^NL?q%x5Of&ijf# zQq1QkPKVD-949GGRm^88PN%hEjz2kh2gMv?a&nF_IX+YIP{qR)bG*svPgOi!@l3_@ z6m#s#rR6x3<4YBDT*}F775`K*=YVxOw<_MIc&B1M^KtqduX0R>LC3#U{E}im^Km){ z6?2wQC;vz>pZPfXQNLUob)2BMvErtRTPSX$I7e|u#oZP6Qru7R znTm%h9S(*DJ15e2d~c74KAhpW+7CUNwx#8!3(|&QP4KxV_@8ihC&LRJ<@#e5FwbU5{|^l7~702NLkdr4UPF2ijn@*>-;!MSyIM?a$Ij7?RiU%s@%(_lzg5nDlmni1cyH02v^2-(fNbye;-=KJ-;w_4AQ_LxTo&ARtKc<+^W1Y@#6u+SO4~qY!m{SJ3v>z$v z_XC~$sA5hj?Bq=qw@}XQz*1&PnX#BNdNTJVEgs#pQ~xR=i4ao#I;* z-=X-Iia9B=E6<~fpH{qI@t+mHt@x5}QpIZ&U$2<+KD+YYp_ubOJNd(kUsC+4;)9CcRQ$2x&lLN3w(RW3D~>2m zQJkT;wPMah?d)_{e464j6c1K>w&JOZixkgPe34>YVtX8ShPI;o-n^@!e@+>V}dk~bDomv_cTVB-?*MA+zZU- zjnwG_E*0i;{R@TZCsi&y0=!W8T<|jC^TB-HNIQJ4Pahj{0r*XamxXJLtbiOdh7WjOUY3VOUKW%a{*2%*39pm#! z%G0sV5Y7T$EZhOi=abawjFtY|FPm=p#y+Jq+O#dayIsULk zI3G;k0?G@p^7$lrJl1=JCxIUjW?xk=d;yq#;MC_h#y(;CuRSk(A(+o9sWS)bAB8!l z!Dp3}UxxKv;cLK$g*m1{UvcWN5BpO1C*S}&X3E!MHIrpx%Xbd=+>&zkXHj9kr_fUP zc5sgHE^udI_F;T($+VAS`v3G7eil4Pn0;Hm@NdEA3G-cp0%4As@SPgk;n>Iw z;Sa#{-J<*xtQErS+xQHV@-MJnCj1rnN?}g1Og}E_uy3msW`D-#nUtRd-XzTaY>V(I zU_Qg74*mP?5zYnkdn=Up0rPn#`Ajf<-N}4ci9TRt_HBHgNj?w!ituPK{lO?N0KX|b z3H+`w`#kz*P^Sd^i7>}o=o>~k`@aBw$jNiTVPW=pjfJlPM}^mdTMBOi^EoHea*UBBf)_(?FIe^UQxaEb7X z;90`#!}$D@I-i2+pGN)yyi}NzDpw1$Z@XGJ1oqO~UNMwg|TeZx!Y{ zCA);#pY0aT1Jmb?Hm8Cg7rp?@XQ7lAfe#2z2fr*_2IjL+>dXWm621`pfiT}kIU-yR zJ|1*9vnE<8{J8@J8Vfn9pNrhyC1b!cD>S-=mykGP{J^fp-hH2R|&_3H-P) z$7-Gt?gl;}+!sv0KH8-J>1)CR!F+y8`4I3s!o$FS6CMdZB0L)WxiH6b_~I+mjtA2Z zkUS9_5$1b5e3najDL6xTCYZj0lwSzuvs^O!&d$OYgL8!|!F_}mg6Ts@{bk@m!W_=w^-wK{1ycNu6xlGIVk`@a;1ino8*WfFK*{7}& zJ^5y|i|!Tv82q3x$BrHmX8+1(ywpDm z-Y@LqynI184*aSxXI=i2Z~~amdzm&7{GKq!n*JfoKA6vYslz__E8$!)pZ8MEK9$dS z$wgrLK$6*Cwi4#J5TEx_z6{(!n0+Ci_fpQju$M6Vywinm0iPwz{*OMB)V~9Kj_?EE z(ZYMc6NDcHPZQ?2&~)Laz~?;?IQ71|Jh14vxn&NtWjvaI!G_+EihV zUo{tIzuQK50=S(p``}K(?1Sk$N}HUL_*CJGz-I{00}m9w7|iF!)V~ybuJCg3SmDdT zlY}|Fa-r~5U_LiyTK3r&39kZQEL;m-Bzyyy&ycBq6Zi_@Tfi%YZwLQGcpLb7VfN)e z6aFRmW?}a0w+r73roSugvyZ=9_yO?!!u4Q2XQmGO_$P#a1AbQcdGK$AUj+Y7nD4~> zL74AobK&zKw>ZWlx7c%)48=K$a~1bjoUgb*agpLVis=*RV_&#jiPdqf;!TRTD!xZ? zz2bd}Us3#~;=_u+R7{^eSB9wKOvPOk^M2mx4^ccy@l?h1wR8HsuXbFmc(vm7if>W8 zQ}IKJpHlpy;)9BLf9vx7RB;f;!O2q;n@yr**d{T1gc<~@?rDN;N~ z@nXeSDy~(`dmd+Jt76{UIC;I|eTrXE{HEf=ioaAG#x<+68C9IAm_A)jr?286ibpBt zy@%7ErMOBl?+u&|eX$&`SA2_NUavcyhZH}hnAhu0=b+;E6@RLj*X2$>MKQXE@3mw? z3#XHZpL?_P#{c!g+#oBn@L4fA&xCN@J_y%4NZ1l#re_@c;BFFj_Smnv38#QDd!2;y zD8w>q2%a6_+Kl#aXk+$R9@?jj3*U>;3*)%-!^)`d(nB`J9yVsV6N%n&0c^P+T+YHu z&cn)uAE0JG!t(KFh;iKC@mO6MfF8%rQ~6L{78f@fVQsJGJX}k|0PP`3%w7rDr2%@k z;>T|tW>wI&jpq??e2lHk5-F{pJ*7oke0m_8TEiSGa z0&TB%1@3_$qdjKt>}>$MG(hiJ*gJ^daksd*br5KK6Jf6-1~Ozi#++dDY$o9%V)(W7s#%!Z{$?>@czoZhQ9g{Ssn zjQ!suH@8op-kF&_PV3#buTd{bT0V5-FyD72WBp!mTpic(bGdiAzo}|g&g!dc`a}|PYwD|KUiZ+)k+{=Sr^O9xf)Bw@tSHG|xW2@T&&wUP zrf6JU@`l>$Qu@Y6I^<5On;5@rZ~20h4XH(CDUoKcC9KFESv}!8`rZ$SpOhLo`O>)Y z!&Fw}zhTbAQX->D!X`jqLDFU~gY<_plG^ye+M~f3{5iEuMdDuim-6 z_QRH5!aLzzp=gKqS`BOJMb6z3IPgkJr157xtmRL8q$eHSJKU=&+1lr+isYKQniMaR zS68>@(d>l>Yf|gC*FBm&a%w49QF4h~GS#0#Wrh8kyfKM`-WroU=q)Gg;m4U2b$0su%f2)|^(H5! zbo=)E5Ony`>o#@on!lsAbyMwSn`+x~pK>Wm*~;9uZ4I@1k6c=Nyq{=zeBz0_Hzo8P z{(8b2(>J35_NzY$XVUVw!si?+kL-(}h+gS-R9ySr^#Qik>@VLoN4a-qZb>+huq$iF zFn3dvmO%i>i$w{`Zn<^lf1F(ZwvJ;sd1uDfyshImP4BxUuqz9W(5BqBompE0xw&n- zGN$w?%$OqSVgJa()XMibB0A>Ztil8KQJP5(*gifmD z$_(OQ>Ph~V6DOxK62X~N9ZsD{`mAo?v{b(R5uD9f^hGE?f*m-DpWyjtK`1du&*A48 ztQ)N26Z=#?0tzl*@|@HkQqe-u8>aCPnLfkiX zDDj2FS*bszo{NZcQr{)Mm^hL;mAINXKXo55=Qd7ZDsRt&HN>M+e@|RXT%5{V*|h%uoix6G6}*fA1>H1?2HWXKcGFH{mUOX*!)}@s zz$$Xm+;n_oJ-C{ezV-Px9M0*M~<7uJIUZW7EQ!WJ4(mp^po$Vab6Hy zPe-Af#v9Av6?BYt(^itRfsSG~t%{DT=$PQ94QFhwX7o$kv@ki>kaNgQdxMV6bUf;& z4WZZ;R*)lZdOg0c9^A^WQ#|iFy}DrY(z%rwWGzSxPCx_$MbvR!EuzvV9d7qdM%zt6 zqs;gPSngc{Sv%dY(_4nzKHp8LzO^`F{u_eU5Z*(W`6~V2EAVP)b?;*^ng2%WK}I!G zj!nIvC6?KTYVS{D50DtV3NcI!lHRY5^mgi?VSnK6eh^cZ{t~4QMv11sM5~k0YNk`7 z)w;^vdV;13Kwk$N2q#PKmBKU#C+Nayb*i zO*8|yL6}jbac|y+h-GsV!BX(D?*Q0Oz}r@KcR7?A#0P8HxCZe_+6;oH@WaP{gI>hX zMuOMz^CN$7~H1U#Hu?+pF} zXukukO=y?6#bmT&-FYR_K*kVPh!@8=;Qbmrene=9TTSvMUKilSUMGGp3fx$lsC78G zSrBwbxu)}Xcc(yOo|MgKsXAK_=e%1G2X~CiJiQa{e4bF?j&)fA?xJB2B5T}Y;XVPb zQy`zjnIQx-dbqo{#}t=~;&&lBJcV9oiljS#coOo+xT^A5$g@=#3kGk8AQQVPo?yv^ zNH-YFvY`)Xz@+g$DE9zkSLd2>%H7ReS4pdv81RWwAwy|Uq0D#q?8!-J;1ETfYCss- z7tu;s!q7wHI3xI)UE&nx2J<+?IvnbTE5te&B3*u*QGZ9A5+@1alZ2F{Uh$o=R$Jub8$H_znvaHWY&=D@M^G^bz>QB zt|MSLWT0Xh8C0oQ3=@VAI3<2~m?^1FsE}~-b^PdrwqZJcnp6G zQ-~uDdZlF|UbTlvzIKHZU;$11s;u}`+3|}XV@kb)aN$r*S`l1Kz=AzQ`MAKK#h57u zkqlAJ0$L`?@uM5nvGth3|5|lrVabHUSxAeaqcNDkt+L~6ezI_v&}tUA zXcw%nDk>C-p`hj(QYJ{lloYMuxOzLQ!inuUiNpN-_U8kM=w7hhM~Tp)lAa<)8y8A? ziRdC))RyA3XC;oyfy#kBVFQTQ= zR2@%oHGGJ96u(N-g>g+6&WicDP|G=-YMhM=IZW#uTtTOO{!k|YK2rus~(r?sE8g@3|hy9u?l^ji3Dd2 zuPXssynj8li{o4nL>P?z+L*gsI+@E4A@zrF9mn-Jt|xFA^Afyy&MHv;-#N3@`dlWz z$S*1$`wvcr?P@HlL-~H{v9LV;2#2^rGIr)GvfDoM6>}#ky}(}_R~;l7P{-)0W7Fgp zD+f3X(Fx&{H3bcihqbBG8Pzdu>TtId%(i$IAP;4`;uNe-93@wsbZQQFL{oKu zogCJNpyX^zs7Va02&tp)s53=0t0Vt11s8^RB%C=nmDme0ZV7TUo-4nJ8uPHZfadaW zy~{;|oJ0zF`np6Yd7{%Ca>s)L%~5?!MOaQ}RLAp~RH$_E$UhSk#@3vD7(ZomCU)bv zfn$=Nfz^^hp%Ak`o!h4l|5QrN33e(;3_u-wnh+WctWFa&g+Un=-DWwzaG+>Tz)hDq zM=(W_WDd2Ywzt&be%qA}xOnVt+{O5B2o1!qI@!?#rRWUMoQ%rSStrN!s-)bYvPK<$ zxk1!^^eje2F((L8ojMRQO^U%BeaU!k5K4e)F_jT85$7E;E7$SY(4oduQcZ>L3`i+i z6)#h)%o|gDEP6$cAIsS$RY4t+sSfl^)cL6r&x|m~&JvppB3H^0C4qkJqh}3v@OZkm z&vfKq{EWZY8EaeKIczzE^zf)IarE3L9pooRz;VflXGK=SwvO?$&hM*lm6Ph6 z_$hS%<;VExllzd4w)km_pW&3g78Z1e^9kqk{S!y?@uW+sG@Y&0^-VanFMcRrt2#7K zpZWK{eh^=Ebz7GXtf@lV6N*ZTCd$%l1XCAIU>0>Yv~<)|SF|*?It%8PS4Yd{ zpEq|wRe3eeeJrnx&YgcoaZ0qT0>5gmQ>ZLFvQz%G(+O$@AB1u&rj6wVxkHS=rokGA z6TvkZS1vBz1ThYz^VWnm=}U3pnTz1dU~?UW^e^Hv@;iaCmLl}qVbjn*F}f?EKMcFS z#+(}mH0I2fcX-sv=`9WY67vq1^uOSuA)R;>F4Bi00(fsxFz4kolp)6QktXB&OKOT&J_za=IsU_%u?nXz%=wr%$rKm-?Qk%Lp7cEH8hkb=KPiNgMjIUbl$Jw zU+57F^PZ0;84<|`9sx`e=iM}!{!PQMh*?!~akT(*4UV`2*uZSAdX zOm$DgA~EJ)IV;WhrTxGEEHpOsxZ$M9HUa5`;*@}#{$sn@ImAr>jX$iNY#KaEtY4fh z&0tUucWw{&m>%vDxJ}cdzUgqARdl+~h1*n7y7k#)GPK8ML;4UhnH*T7gA$NY$(n>% z6N&0-dltavVa~Z?6EK)*c6C;=shcybNHRE!SZ4-rmJK~Zto`O&nEBKfdC29pDvg)I zzFA{-Nng{L-QO`{_Ny>I$3?$f26;zg%8!DZbgox$MTMA)FLQ~tUpaRObnZjF7&c}2 zK(kF_b{{us%r4`b8dK&w8nc^Yw?)4Z*c>W|Ii&F-=5WO)0mMsT^CD)~%mpZ74qYu8 zb6DyiMm$*##O4f^%Snek)3}isGAtirBeR8c@Hy<=Knxj{8?iaF<;$c)hWU9=V-A52 zSooWk%u$UwH1eWf4uQ{U%wg|!VuZzdL2S-Kd5d(&KMgw*;SqBP?5{D0$-x$#52Q`p zq86T`F^5K8l;P00j2Pkeg??faZikj(UVT|(4zc{MC;f8B{3S8`vd$8l^JIRbWjIW7 z&5`mETnlj#v)mgs?u5OQ%l1KR;=J9G*{N|i>@N{RJ_31S zQ;y%zbhamALuVajxMsM;lNhN>EE{6x6)(QiMI&t%@-&PSp9jzk#bt0IG2}T1yci~ zr@w{sEj-S`e23b|pKW1&v%%0mZ{e?4SoZSkwBK*he`?`hTKKmXe%Hd-tQHH4?+%-A z`At^S#)ko$_E>DmOeIc6g@xfaS&iQci+-*}Uu4lQw&;9E*y!o9@H$K8YKy+rqTgiE zWxv196MnuT`lE&LF%&J#JmMW^?>ptDRlUYxLG zo+H*}`hrFO4~zc3Mdy2_!}r}yxW_E|&n+zHwCJ?-#W-ft#kykJ0*W_=IYb#cUpp|E zAmZ${@y3kT57 z4L#Mur&*YD2_utdVa_WIo!`$fc#?&uTDZ)@GcC+zIpgyfc--9%C_LT;ou<%bU{G5efw(x5fe#63? zFBzThTlhl@Ctx08Wbp7XhPmz2(78$1-~tPev@qvaMrNXgxogzWXIuC@3(vRkCw=>$ zn@)|M%PhRn!dF}PdJBKS!uEIlx$D*F{Dy_OE!NPvwbfv5el_@K7Uo`9Lx0o4f3h$h zD#m1bSvb?e{BDfV6R~iDU@46Tn?!h&f z?~fYHxuU@V%&!dYWns=64L!@kd>_rwxx?0A-@;QYe1?TF<-y}^{J?OH!pya}Mq%`j zXE34}!<;4>I;Tno%UTE8HjS-E?lCp}2K3u~H0BsYjB4t9Nn=FO>DHLb2po4P69VQ~ zL(DlB-(M%j5{+|IW3DT3^AG7%ROx0WsU(!y5kq_=v{btb1Hzwncuofbt$Lj*rA#L+1EM9KrP~jq`zD(|9=W?=|MP z5;;~nfzr$2DAI zw#zXZF9j~qnCgOY~eK)zS_duExg;p`z`!{g^yVHgoU5C@UJcWmWA2(ne-;3Z5Z6w!VwFP zws47sWka&g*LfEGA`36KaHoYgT6mj@N)F*ljS!YlGQG7|g!F z;2`2|aGHg4EL>>e2^KE3FvnA)hi%nhwoilGEWF;rTP%FDh1uSWUygSMbBr?>#rT;_ z1X4)0qo;As1mHqk#-NFa;hcxKR9qOBhpJcqa^R+a^4M02wA<*r2=2ELFJp{8&WUV& zPA=vj=qITUR!kq`L;a-DoNIt`3XgCqF3u?p`;+8mK!*B^nFkMT#sS;J?<|c=HE-!K zyuAX<_;F52Ii{CuWwyQ}(03*Uv@twB8?)1UQ32i%MJ7=n=cPtpEwJ$e=zNHEY z!G|Bi6;L012(t2c1NlxFzS_V$B7E=x4p>QYKg$jw@T}q|G%2ym8948Uft;k^1Nco&3NrbjdH8X^K{5IIOiCE)+-7Oe?-%NF$9;f4p)v`q-d6#h_6P|uOt-uHI?&U8CREKaL|oQ1i6ANUdI8%SmKp8d+GH00|I*IV^o;Ff54Ah!UyGC#6+APrSwyQm#vq!d7_?YVl@Fptia~2xj6uYD2vxM$kdzOib&5fYtxPe9 zxSjzYv{(lfgJ`#6&|>vb41kznPl(rNX|dA|IBVDLAu!VMx8xE)O~Um*Fe6y858&b( zu(YM6Ih8~_U45o2)$oHgzq0;WjU^io47 zD8~glD>~h#eR1PC5v6T$WFq$} zYCPVtikbrsx^|eL{PKr&*_i%ddQLt1^8fda=%>CTI<{jiY9rsVsc!6QsVk~Ob@_~aH6gzLm@1N8 zf_n>Y7o0A*Rd8Ry&4T+2ZW26DaHHTsg6$U~)$4omY9M&14n5y*Ti1Y>w7RP0^(5=9 zw2!`C7Wa6{yJXC_2|eDE5@jOKcj!LbD`q!+7mPN*# z2a8u@OY4~0uBPVBrWWU8-fru#-r1|Ju5W0p>1yt*mUpO{Tk&dw^1_&5ZdTL2EFO8% z#x8GN*)X#gqxdc z>&A98)U?+vcRHHZHL%`bs_=jCtt!)F&_+d%8S_>Z`$YCFv}uxY5ub)D7Z*E88q$e* zn@0I^Tr{K;8#+5m8q$dkon0jj>BNT4&XR_7Vnb(lNkclZp|iuJA)PoA7vp34L(+{g zX=MK?xTs_8%FdcvyrI+CuI%Lo$=fh^v8AECrdhw-(uo(r@m5StXN^--+hN|AX>U~& z>-Cw&_L`M=f5xJy_hr<}H8r)hc<1pHc5`dpDejv8OWw)h9EgUQ?O~X;%|HK+j?t#H z1Y{K_t}!61Ft(d>wYUk$Q(D_?S8q-NST*A2)HiO(=gc8)_>N8noKjg}r*l?p4-=~E z>(Rw1|K?frKsfvMRVGDEJ#L)X%ILpG!A0q=OpSGfI z`sHV?=uiAIvM@dUn&<69!814!*bPxyttFV}A#C&pvosCnx{-+k*L{p0>NI;E3oZGv z7G`-EJ!e?B!ouvhjEqe8bX8?}89K|%;8hmB!or&@`~?gDn}r{>@CggQX<_+HpDsH- z^EK(s2R8eE$5?ohg=bi}f>`S@`}LT#g_caUg=I>q<@wBn;ZpuGONP&IO&nye1S=-Y z^`z^3`yw$Lmo_H;tTzUyTKF^z_p>nDmyyr6Fw5G|S=I)Rw=m1v(4!WfZDCIMjSTC6 z!AmS$W8nr1w_3Qv!fek*&y^P5V&QETzRALD`^N8H3*TnpyDfaLg&(%?w=I0k!auMu zmzzvjzq0UeEc`nQzhmLQT9~UgN++yK17Uo_BqlIs=@NNrtTlg*ubFYHY`Jjcr zW#R8x`1=1oEzJD} zM*l$zf6Ky$E&P28b6*bXTZ>3vhc4h{Cf-k(ZXB;Hh%5>s=Y0G9}9E8kC7i_ z;eU4TD&G?_dde)!{XT|%j)fOm*xtv={XRy%!NM&TZnrS^`xyBvEWFvm*ID>R3v=&} z@%vQ^bMKF#-)Z3k7Uo%tMuvNT4Ccza!B1NFX$$kr5+n1ng}L9y(7AAL@Ou{KyHJMC zJw68WL!t)vwlMej82W#QJ+l{B@!_5z6SrCmH(Ge5g}Fb-$gi>RdJA)Zkdfh;4+h_0 z;T;yHIz z%y|&U2+DI#&An~JobTVQ@i5?n8czT|r12!+Z);o*{FuhGfS=HqbDW=O%=?jNHC_h% zg2tTZzM}COV2&M(1Lrk=(0D5_#}3kY&+@*;UjlYOBc1mzi5lMu9M<@DVDfqK-ld<$ z2Y_kJ8C^CGlMXo=`~D&yZbL7&@H7i^zGq~rEWFgh%@$^wjr`RX-fm&0&B*Mx@BjjJ`Tx zTVF98do6;2muNqwuxVyPANPt;AMcTjKHhH_KY$MR8*+YbjNxqp!C>+pK}Oz9CE6Gs z?^{VO)$|D&=u43C43|q9Cfpss#t%i8K_)_=jp2PBZd>0QsA&11Q6I8ArjPC4_yKgT zg+9(DjWN8vAlUlSplBYL)W?+}6TgGN^izzBW*_cHuQp2HCggQk+eWScl{^ZXF-Gn< z2&@;zEQ1{DzA==ek#?-0{O*Aqk`gmU?x&#G=~y}_-rm@+n{>PeZ2VBk9n@zL415VZ zTVFHuQI7fYkM`HxgMsD`kTJ&Sqitos(~ZI}1rcih@mW6@ta6Pq*hU}r*Z9Tp?KP24 z+g~$&q7nb}{WY=(hWgCDgsn3RYkrfWPIy2#c{9U*Ygc;qmf=(W%Hvy*eV=&FNfvl! zkIGSET=;bh@auNq=R>+-C`f}nDldzb+)c|%cvq~XAHgzvRM@e`_NcH0#rLROL{~83 zezB4kBdXZO@+e(y@;6{5yon!o>}>qfFjRMUVoTRb$1OI*q$bDp=@^Pjw#q1HDVz}h z$KQ$nq>UW$?}1z28^;(D-=M+IqbJ3;XwaD)-&{eb7_QpjF)J;}Ts%sTKYB)q$&kY5 z@+=lfU;K$~oITEB$DZP{VygdlJ>mNw|1^*F+dS36xF+qu*c@!wns~7zHhmT8 zpZZO@kAK#s9$@`C%?)evpM9 zBGzd?V$lI(epv=a4@C{elqrVoJRfG!$5?org-b0w!@_edJkP>Xj{JdPeK2WceK7HP z+@e1P%zJX0=W!9U1-+^3Ofqv*szsX$t*Qj&Ur|Zqs8hPi;e4n$fseB|c3~>NP!RLw#%m z#+dlAe2GgnV;bT&8<_E9ew+A_X5s+obmBTrppD^8huhY7HT3cM3H7nxF#4*1jUPZ~ zDje$xv@yJ8a2rh4LvU1U8Cr%{3v7q`C^Bg~XbhKKfC+asu<--vWTO5=2(&RgwqaY} zTy(|xpiv*o%jmlv*!TgI=M5haXk⪻kNa)K_Byg`Z!ZJ`o0KEKdh59J_@?lD1n=h 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�^4C3}Sm`%rMYWJ4Q8cW&x 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�>#9 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%0AcxW4L9+1NC2Q$2@?jbSKTl5#GQo-#=&p1%qs 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

    c83S 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 a>D?)zZn5H8diVEMS86bQznrUL@BaZmCUuMe literal 0 HcmV?d00001 diff --git a/components/newlib/lib/libg.a b/components/newlib/lib/libg.a new file mode 100644 index 0000000000000000000000000000000000000000..f583174f160ba550f0bb1efc68c93a207cd4501a GIT binary patch literal 4921612 zcmeEv3!GdW~KQnu0gQ`$^q?k*EKtI|Zy175S&L_Tdyioq!Ol;M96T4=iiEXbovHO>p*jFOX?*%XXfKkhxpKr{7 zl{?IU%^S^tU9-)AAJl|?;Ftzu{h6w2Wsh$%W&iTL^@Cyq8H5&`flU=_7*dQ{sn~T-%46v)s;0>TRWV8sLoW;zcR-9#Gq zkxn|lajQwtKk&Lq>?u1eKlJkZjP;u~nxXWc-C>6Ayu}Rt>K^C!wV9#t!v-vL{={8o z82vd}GpxJ847+)s8TN%e2lT^FA7S$Rb$6QKpN*K|UoxQ|anmkyFh6qHOcVMKUSdXy z|9H}j+_}Mw{K}nXhtB-Q&)mhVa=4 zU%bnVYME$8W!lWBYkzG<-L%|{LLVFT@J=)8YjtMScQ%_*`+(odn$g7xGkWmLX7sqX z&FD!HGy3En=a+0Wqv^Bt&fj*Q8GX-YGx~+)X7q12SwCjXd}Dq6eP+!35oXMXdP09x zvoS}l+-;6pQ)!O6vD*3V3(ZmVkMDH;3-GPCm~nUSGvhGcjeB{C^M6X3WO>5*Q`Va#ed;Qc?Am9NAKPV;cfOhP-&kyt zKX}a~e_msfe|XA_AH3a+KjuC&etOo7pTFCTU%JGMZ>u>n|Hxu_5S=TEoQ>htKnB(X_?EM!K<~aKAZZyZey~Nav zZE=3#9#cc#)#m)xg{Fr7%L(WIX`-q5-P`8)q9x||hO5l+*X(uv@0OY4pWWd6ua=n; zf~U+0!?rtr$~JSt+&9e$XDxJo^*u~=PP}BNIk9m~ zzTfz^Iq}mI&58H#bN<`Un-hPt*GwGxsPiXpG85_7RXe}&9W(Kst!Cm6cbSQAEHo4U zINMAb^qQGeJ>N{ict2^*Q)beV2hF6^4l}81tC_SO=Z~*3lm6~aGwB~TnMu$6+D!V{ z9y95eJI$ouU1cVZd^_ily~IqOQE4VGc-&0Bu*FPH8#8(JY%_WD4m0`FHTnLzoo2H3 zzeYTK?WkXy+LIRM`^I`x+y2gh{gyIQTj;;qVQQb>WNLr#ys7==C8n;l$J7mNF?AE* zr`>1j&V0($UHFQrYXLnw#?)=yXX?JZ&H5=PmzgQcc9!n`Y|AB4+9%F*Eh+^=9h#K!=}p+6FW2+^uHXQy`kcSM&74Mm$BQ}t z&$G>G@TU)hPrl>)DZ9<-^OE_#<8gDk_FMLt)3tx}K65&J!@Ajde$MF=4gK7UcIWwd zsaH&%zhRA;r~Q5Jn0eZNr^C$C{+;K|Jmu$CuQArYuiDI~&)(_$C*Lvi>7Tg7`8PJ0 z`G2T33(Bu@emd|OWoE(BUz-I@o6LgVq*;JD=Yqf4YZiRE&G{#@W&!*e=e=moSaFFt zW6ksCj2m{DGj8oMXWX;hobgD~obeoJ-ydQ9nPvOTnWMLxGf#NX`Ezi-e2qD?cUQju zd+)-O6SX%?Nf%Pe}|Rp*_=>&8|)L zn#LLR9VXS%*V(x?)!5XHYiw-FAXQ__6@3{5dRMFiZV5pulkV|>o}P4rRX z+YHhg=aRIfJJMMnmtK?YZEW_5+PgAoX3gBX5aUp9x~HSD+4EFd=5};2hrD25;Zm)AUCpc*8v^J}uV~L? z)4eHHIqJLF_}XvGcDJ@7&}|Rx$SvF5&Z^FKcc8BA$p>8sfu`op9vr%R)o2G2{YGmKk*P3c=?`lD9n5K2<-fou2-t<&Qck@bwnj1Sh!Xn{Lx?4*s zO6WtKHiUX}krHg~KwjzIULzpY*F~x67EmbN)w?~SXvizOwkMtH$@ZpF#s^4U)0k_B z44}Y`9qsGVrlq~L)!w?6_ElhP@s%xrGFx&tL!yO*$lk`Tmin3C^9ZDDccU!}foW}C zl|>bqv_Gd-0Dy@{#@U05wmhxIGVlOu*Q)m3?k*GzNUD?2)dJ&PU$7wEmF->YXe-iL z2RhTeE7A`3raQY=dCaEUL$Pwb>F_!{Vq|Y`7w)FJBk48i=2T{FhPN$aT%TUxdUkqE z&y+foYQ-Hv)4;v%#YK56QrPdRcbm1*th%e1j} zTLn1~5~O`lzGD#z!f1T0sG4R*@+?7N5xUBfd_CP69|Ppl2q6p>h{z}rHcxgH%33X% zD?&k9un5Jck=$1M>{jQ*`+_NoX>IRFO`J7>_;OQhRJG zOEorsu&=$BV|Aw0lX@{yHfAh|!*)Nu9I=4Y3Bge$p^3PVyULUcXE2O3u1u#g*%o$q z<{T2b`}hP=gm(4`JVlz>liO2`y}gYbrdr$Auw0ED>C}qe?!F!j&yeSYbu_ME?RBCT z_~z#!h@>=kcdu+uvpRDjA0L)^e9IXvAH;Pi^=UHT#7KxQ^T;!6?3WfPFw>f19%=WGoB=jG%N{7 zM1&pfU1`(Zlf@j1CnV#EogXLsC?R)3$HqN%B#TqsT^;Q7p5%ohfr~8+liQbpO&zH+ zCezmhe&)}h4M zbqYNsuz0J@icULIaVK6%stGsUPgGsNPiHw2cC|3Nr?H)kHrUaa$)gn>v`>&I~;_itY=`Onosi4hd{;YR`5ya?*myf2w;` zE7rK78_)9~EW*2r_FxgAq&H{$rWn{Wcvo@wf6>{u)rabD5e*wcoy9X5EzWS{Yw9=?FIXZrB6Lq3c-E?)qb@oEvhT4b-b z(_%79E~`cSYRS)yPvnuDR!df^!@M}m*iw3sO0{#6YY(X_!a1ZzCe<;co^xTIOb1`% z?9+Qt|8^-f-Z#vxky{8ecD0xXb zWIEo_(%hEj`v_V9UVHG&a(4!!(8^o~?{KB`;yTlr3>sM`Uu0e>6pJlLD%IKDmByH| z_F#!}EItu#VY;`y`594?7_&~d864(@6w#o-7MIYMU>>nqg>EoR8nnOV_~ulb6V zDKtntG@T^e502AeCho?iNroUTwIjUi9w9!{iJ2Tn3>3}Pa`@msNbpE_drc>X5DY2y zgnT-idVLso*G{rQv2UoIO&K?E0d!ds$NyY_GBTR(FgchWvoAq5nS1NSOE-EqVqDOj zdAUNuJ#KFyOO0x@J?$#CxRWV~2gW_uGmSK@8H(@xksSGMG!rSc+D zoh!Q)i^D#`vwIoF3&7c>25{^l$N(`BPgG{umYi)%p;}jD+fWU2F;V9m`&>WxcVeuk zA_n(+Y7>ra?R6NV!H6~_sNKepv%SYYt$VsxPiK%^nYQ*;0$VjW@nsyrz7CG^O;ahk z#is9V%(ioO*V%&yP6~4f-V}@RjN!Xyih2s4d1KdFObv3}?OkhK3ZDc|J1-$@xt$Ij zr~z`e$jidm%V{|8G9a}(#FP2-h}Z^sO*%FS2%?A*@SLFBCdop@RZNT1?)f} zF*cLDf+Mla%{`s+{0x;f+irpjLWgPYFdTZ=P|!=#X{QTxfKN|61fj+9h$r6UKIoR+-F9ab5Y-=I zfGaQz^L>YB1o@`KX*l32o+V4ZE<+cS=BU})gQ<8X19dd0y%;?t5^?Q#0%B0?r1_H|3J^QV-$y;wNVXNYu7cu!o9tRHe`Xq$8)4a$VHuRByGAvMe;cw& z0KuetPHF%gM3bko1r4nmx7b0eA0W-CM9?OwdNrA>ol@Y`#i<2`&Sq%uI0x|%CkM0k z)YjY8*Wr;pc}^}6FolFHvyr4Ns2cjkoy$?z(WT#DwD?4Wft;~{3xP9i6546e4N z=~9IRwwztQ&~hDJk~snIVz#%-OX)%XWf;l?OklE|skK->NHtMy396l2;mq|Sp4{M0 zOpd3IIws2m6msK?M?aWHdYz+Ip>9Fn4zVF*6$}tt!!>J42elfx1 zWm;e;C4rd!>J7faWep#iq5ayX+R@VcJjoG*m|$7HF=K$xSrya-Z^e{CVB3+3J# zNszv2bIiT%rLvtpRFk7f9vPDG@L)Z1GVGv7WCFq9mDj%8<2BO0tY@KW=F51BF9TRZ z?Ba7f#6-g9-=wo%{g8Ef!&G)123NfNwRgJtb9NoChs_PhO&Lsf9Y%j-!ILc=E^8fT zh`6-IwH@s%+H9nI?ja4z(P3YRJccYNxTy5!vj)}2S*Zh_U|*Ung&L_otT3{X+CGfL zeSFWihr&0yRpEjri^WiGLY0d%D#CJw?U70HQut9hM+U!Nd9yjl>Kg(=2MEXdysnZ9 zumW_a32|NoveF$(_p1=Q1YrjQ-8~#^27-mkLdpf@il{DLUAhyqN}e&R!v5_^_Uh&F z<^wvpe;}Gw;Vr=Bs7K!_UC;9H3yI{-<(PY{c`Bsl3YHs9R)xa}lIQ9~#+Fr{6T(%R zu#&+S?emC?n$Kafv8+7tsf4q8Dmlb@awKmk!>Tek0=a$-AxElBx=;DM=g(KS7GsZgdYc&D)& zP~0%gqt||ikh*fpv+0o5&;6cD+|r-0;l`xH>oAu$`rdzPZR{XeN* zP4c6$Cb?lhN0FT}If~k7qlmdJHaVhSJ#kxYa%9;k)1Q*+Q?zhHOg;^>E4wcyN0kjS zIZC)oCP$)s;Q0x|!0vhHb1r)n!rGVyM@e7E&6{>lKyH0X!vV}xZ z{H_p1K?%6$qJV<+Z$+_tD)K37!c7K>4+9YAzKX)2+gzZCPA8)?ASFLb3{LFFXlyE> zAI>zzt|2Q?D|kC5;i9k%oa1v;knr-XsD5o&Cr@+!-QJnUWS4F8C{_)VM{x_Nc_hxa z?R$di87P=rLCxc|N~``9UE{Lwnd7oci_qs{@v@NE*IGc~X1M|q7bpuzTvJpew{EEW zwJf;hm@EY=Z+R5E1eZs#YjOD$KIQT#c6BX}VwdUiDE3t%k77radpmq)R$ zEO`{Srl(1Tl#XWT@$s^y?q-K9faTJ4$O@Pu`PHi&g$qJd{3=m)jR;%!@|mpiUDLu< z9K|OKIC&(#fo1wrbm?W?Msam_<<>lMWOSPDNqB!K9KnTdC(Z@z!tFHb2a0SzKtw;X zo10th`~l+niz+NuPT`&tVO8avH(Bj^j*bDzD!tXv08+s~V8<~mI_4$w3TQ=JW%av? ztGCh4-P$zCtA}&R@cgG*Sn*`AoavT0)s4;A)gP*Ja!E0E;&lR}e;%oz@El;BW>s;u z?oXQC;tEA;9$!x5nop+kRZ+P4qA;n`#409iuAq*#fP&VwA5tEZ)ru;L(gQ1ME7x|Q zzEvcuV6mL5r*Rptf6e2f?p00feY^pl-!Y466`jT(Z`xcs}CO6X{a%BNXXWFE=B zuH{keJiR|f_if0vuXA}^@&cDn>@VMH5c8Ovx-gFfjbK5B+)v$)gqNs-WcIa6(Q;af z0%Ae`#Q@ar`A=FQTYn~O+~wj)tMbdIaQw}q;Q0+LU?B;wr+Fl&7tAAB z&0rqIs^jt~P8pa-vO2*WMU;X$if9LO6w1ZG(WvS@RL3bUub0cC6g(F5G;=w|KCc?f zQF5BDJX+!NLKIetDb(!d(+ckCe(rq#8xO@#zYM*eM+p~=O&+N*yM9dw&(eN97_@>e z21@@fMxxVe4uqDU0`8%%Me z^e12`E-D?4)Wt!`qYMSH4oi%l2hQSH^k+z194p-oVq_tN6~!kYA~F!qYVw^z3CEEVy#}HqEx|KMSTo z|BSHcpbNp?lSVU;zw=%_9#Onu7 z#WA{=Wj4X!+nL3=3`7DG8-VktavD`(JIkPwSz_J9K}gUWC{ZP70-!Kplji+a%3dO5VX(JxH^f22IM+C=|>Fc!as0=~Qu z$Fg_>FJ~8Vd3g$}+|h^r9`Y*Vn^{i}lYd0~VHW=}-lj3}spNlxttuJ+9`Tb`BG2mh z?UecSy}&i`OPF@|3&0cO^H}m{UjwcyPxUpK=<}3c4~$ZNgQc7ejAFhp0TLSG7m)v( zzX1RIINGm?zVt`nGs{yQNc(N3T^R4C{FlkUB%Wcu-{WydQWsMDvMcJ!f zgv7Gw_~2Z`C+z5VjKwA~hFsOQ!A9(ZB|5=2q!_Yc>#B%QX4PB>7!f@+xQzlzSgEI3 zY!X$h$vDqTmfmyqpp*4eW@V zSPstU`+bq_V$5YWCYIRA!Y;E(%1|=0SN$I_EQu};wxGc${+(Gi+xBh}<&@JB@Ww_G zAEunN4U{E5NVZlRNF+v+ZG}xgCNYIMwAs9?6E~2p-LlmrVhmhi19ge-FwIIEn3;H; zqC0G$A@LE$blL!n;_zm3$gme(iXyWHMsnP+_Y;I2z!j0pK(2`JDKe5hUs}L-Y~<7S z_#3d`n|=)2$4;I(#7~PCgSXg2RAFS8DK4KCKPA4X3aNb{%0S8RARcE- zfI#UW#TE;KMOCB@7;hF;)yDB8uTs469PdoTl~o{L3`|u)ad}Q)IhbNDUousYiMdu< zwy5MgSjj?V4;gBX!_2BGloe$$5}pagrmUe}v=0s&8XPy$m3Md)N#_e6r9epinCk@|0U*U@} zDV@QWsxv30J6b2Lsy~^ftXQZO*966-128i$E*el`k1-sB0dX8ZG$4Xw@qi)|z@vIo z?cGh-^V!Nz7N>IiIaZ(X!ihp)t&d++a1US#pLD0N=L5^8_}C`=Y7&|@e$(mpu^~1? z-b@=l-A-~oZ@-+!YG8)n>0nR2cPOLEFW#d(@OKv~!bjk5G>Z+{Wx6);WENp_9PZOKAq*W&81sDc3^sT9j(a?y~p+ zDyqtVg3or^flu$b7l+?awQ_^H-@c5GQ&(j8MY{Wrz}`gG%xcyQ_jo4l!QPzKE;8dL z`SnCw1#E9f>-NkeAwCsCPPs(b_stw_TLj?8$|#6mjfT1yOVQzBUP1@#b&OGPB|s)exC68( z;BG;FadO{MvjaNA5s+j1E=AfMajCiZh>9HqU**`6@UC#DB0B>vm|xp~z29CrKUPAeb*yw7R59S;>bSuUTQH~^kwK@)?_h1o zbmM!zt`>g1*E1cJ$lHy^CZA-Xb+72=mIU5nWMsczz}Uq0Axu^=hx9&H_VxIz(suE; zs~IxE_IN^JXP$ntQvkBc{8%W70WiCUb$V6_ch+o{Hzdr0LTpt*D>TI%P&( z>!g5O7VGH9*rv^A_C&+kNCNfE%awuhIP@A7KQ{PIsa z7AhPaLkf zdd|8qLsPCePs_&mp(>W);bDo`3WgL&u(_+gD^J1PIPAm)zF4fS1e-D(aop2+RS7h~ zB+hhIs7AIv$|vS48-3ubcLXt;EF9;5d^@8X4=w=mn!@bg>P2)c7;Eu@Rt>SQsIA8`1=a~RN=Q2 z<`5_4q+UcYm5YKWC`=Wi(3dE@OyM?#vkI?Qc&EZtKZ{JNn+1Pg;nx)YjlxCfFv4G< z@EC=US9pfP^Auj9@D&QLR(ONLH!1vSg+Hh8E`^^~_$7s@nU?aut}vAuLZ`|_aFxQx zDZEtSrhZB4L@xi zPHTA^5T3+>cqegO5Y_VTgS^?OB+6r(VH~fw30~3wnlC^W)w<#Y!h&NS-$|H9aY0p_ z@b!S8^L-5&ZU&9{GC#@pdSFQdXtqLLlE6EOTaU1ow+0QP8Z^q|TvO!T3M^>=&4ZBl zK}8U_)u(A76Wlh)TaGj3u|JBuyMUR7?VWA{3eRVSIL6WM^k?Ba8J%#BF!?z0Jp|AD zC~h72*jB}nhweFe!3;kDK6QJ;xMvWj>*XC>2kV#D!MU(p$IHN4-ouc`b|p^Yz6FAo z7sCKTKFWiZIFyIvVVeguMVR;hh`>9M$FmVbcX0i>Da#S3E2# z-ZXS?)NE?KzvNoOtq^11baj8AJr74ihU|Gb2^Yj`$1(UVj=@q8+AYBtGSU@AO4+uH zib_vJEH)}oOH&k-aBoCW5PQ+aMPKJBX4_;@taPqT7yYq4m2M?xq?D~P5?O;|G!nUn zQ9iU-8_YN$n|-j2tLw32aR|mu12H&%0G~m@IMV52C*t6O!P3~V3?zGb zyfAhy8OPheMFV$}c05J=4nA(mk~mEQ$DrW-MXP`#k+nFMZvv^PlF}>KID#=Z;25=S zqB17~&+CJ%0HL;I1tC z1>yQi99*UhOC=~1mr4fRh*guK5jV{Ry&MZFe*Nk6kz6#X&;-h_%ohkzbbK)l%mqBz z27~333vOow9UtdK7P-blD6NI~HTWX41IKs0H1eOj+<`B6m2F+OVA0nF)pUznvIy5B z#&h+7>k(XY;IY&mqlyy74nXAuK~9^?Zc(8346XZG4Jr27I{O95Jhq&KJTksy(S`oA zEAYLJB`kwg6x)L>Ag?aBU~;5ta47Jbeey5^D^cmi!L!O*Za8f1Ze9i9uA+jiVc2l} z=D$=u%5j{IXN)JI6ZI(R>_t3FKO3fS5}5JqS<<^Op8N%>O7pAlFHl#?ISL(z+rfBS z;Q%a-^OkBKU^AgE)y*9ok@5Y;KV^7aI!)nt={6*)=rWjy;M8~X+s<%ItS3ja*u-xK@1hG1M1e(vTJd_1vl zGm{k^NyDtypQ7U2j5Hy;7lGm_IJSy{{(z&XW}I8 z84&b!Jc{dJ{qi~vrnmSxdD1@)rni`bj`t%GhO@}y8Mh#G)wp=- zUD>ZWW-%|;H`}80AwZMG#m*-1PUP7Scf&6<@V}7ue3 zn?B3s`DnKaU`OT^M-g|RTBaFK>;W zluh0b^*i$nMc41oXDj;o3SX-5a)nnY+@-Lcb7LMxw+>#)uvy_x60=vreHvcgOYZ>| ze)~+az15gqivBdQPy1s<2MpzKP!O3cir^!C*L@smC9mDU@~-=W$D9Mc!0+~b z6-f`vCBeo1Ebor>z%mE|hPd!ubUo&>GS_B$reSz8yq3rLy`CY6?BhWvZh)uT1bLi; zaPH1}5P2*Q<&j3W*qy>7OB%}PLg32;-bq~HyD0aljTa`Ig|7#gvK!#( z>X2C-&dithOY*%QSkeHRGaxTX;GM*+M_9{S4tdp}Q646~p}fL((N@T#zDAtL+X{k~ zw?UPUeL%{07ckSX>~yE%M)MmUafI|c{aN_8${;A2}AM;^N8-~}^$ z4Bj2t&csPv;k)RAxDM$b2YVMi5%Q$0lqvEG-$fr+^>VOx(aRw3M^ZQ?k8*JfLdX3Z zhqH#>fp)6a38IJSN@1jeSC?@VN`+oQ?`lbz-8Bdt|iykYk zd?Ie;y8X>Qtc(jGrk?M>KJdC`Rae-IBRQe#x zv-k^yNy7J$>b{J99bf=rqD$b$QoZse9mKlFfQi`P~b|2HHO;{rb< z_QnOqk;fYs_&P3Gj0>zKU5pF-9wKO5U^#RCE0iL-h|q02#>Ff%UjJv2 z>0AczadwQGp?kn&F9gN~*tlU_;C_m;HMW${#A_+yLKZj@XB|c_`XcBsvVdds;;-XK z;{ucvqppzNi>!z|ivWxZuyO|NfqWPj;6CB_zd%|vOX${S3XBU}ge+-XU=GfSt;}DH z3(RE!t_-+wG?F+D>3txU_*^cgEO7$Uh;e}_%=~=YVVC8P??P zH-IO`Z^kkDEWXhUjSEn|7#CnE^NkDaWxn6!Hsty74AZ_e4p@u}Fzv$lBIfIj3p5dX z;{s2x4133ca!H({YV=i(Gt1&%BV8L8;LRJ(>lw}q8E%6UkTGiWV~E0-`YA+KL|C1} z7{TVE64)T=;CTj7BbcfpatDsX?go{YuGmSEPs_hao(UkZN^(3%{Tsx@<{*X_Z2Ois zE>J6BT*bez@r(`5MDePQM*viHjmg3UD zj>w50A|^C0@Nr}e;{uF{CDyZi%WM)F7a-Bv9iednezBkU8nbM+?cF5CGSCw6#zqqN zQcl_i$`bdWI$&IYF^NPi11oI$F^NAijTjfW67euDK(?C1rzqeG8>mZM!I+gcFf*~3 zF&#G0;LIy@+5n6T@Md$!uoq3^0<3|N95?L!1mRiWipW(US48*}8Ofe6E#Tj5>y&wj8)9z6VuPdej2oNPHXVxb6^7ucJ=a`YemGQr(oGCP6kchvAf|X9?^^AzW zM*eA}kBR?^^m@{h@dWv&lU^M^n)Df@*TlciGMq#_F@7D6r89}^;@io8GB2gx#7LSC zXm3DZMy*9;Y|8{t=~xZHw!08NnqLVA1K82&#R6yLP{nxiT~ zWs-5hGKR+mmqFt`&a2v!aa=`gGgCeV9@lFb8qOf@F~uBA@y=ZS*Rn$uI>NiL?4S%i z;5B`$GW3ApQMu)Yaca3CS-9N5?T*$BGrVC))f@Uz>zrjR5zD;Qm{FeCcjKQV&0c=e4lj#K3^q$LMFoBHv1YSa6^Pi10q}6Zy~(gIMYi zBLMjZ3UDi!D{qOtYxYl`a^^bxRZKy9an}R$AgGW0TCm0@!u2L@KJ~U4c#+oDhJ1?O z9Dc9wt!~)*%1=ro9p2Q4{R$m9_qD@9fV0B^h;r^{<;q$Hz+dND>kN7JEJE`GG+ZLK z7FgZ>o=mkDXa6uu{@W_Fk6!a1|H^ z*rI#wD4SD-$t|K4L+VOmpU)F68XC3)+#ow+lhLBLswF=*$ z@J$MDQ~0wAKcMh43V&1KHxzzH;TSrCT+2{}lM3@gHsPV-Sn%lzpRF*}ZNkI#LBZ=3 z-l6b=3O}y!^9oaqD022G{HDUxzY9-{b9BEh&vqwxyuy!wUJHdjR^jOi&r$e&3SX*lTH#w1u7eIx+s};Uc z;ZG=hr@~)Q_#YL1Md5!{__qpcyBWiwl$3IE->~2*3ZJI%*$Q8xa9ZJBg|AVVdoM)( ztqR|*a0C+>;i*t~l)@7fu2c9Fh0jp)1LQB5u72c%qEehYMFu#|Ow2vyh zTVZ|!Av}8(eqG_W6^=mJDEyTQk5QQ4EeOv7h0i6%7({mgaFxexq$3Zyjf&@PVn4<* zPWaJvLd-|V06@9G2)e6@rjAnSqZ*}hB`0vZiMPJ#!^pM9GhRjzz=A4B#(aFPn zp7ofTJ-VRGoi!#&l|GK;yvwIy8=*TEnTf3*hAEGJr#}nd zad^>~1DZJDE8OqY2ELiXgfsc*o`V<6@OJRAor#mUXF$;PVv@Q3aj^YPJ0OqOD^BEn z3j{5X79ONt&~(E4HW*miJfL|K@_t0%oygOUV}`vH{b*6y75`^@@W6JnC1y^I zZ=QW~{N7m`FByC;2C8mz7f%%c%)>@vrpfEKK6-6qg$SR4*w+a ziN{K}Jp0l!tcNYne)H6d&8J;=Tk-aL2j6?oN2Y$AU-GzncAz~{tw<-|^8A9>mM?-o zVnG`jgPP$WNk>MyoUIY=P>`>8f|A{g3u1eCDvF+kxZJlq_t|t&%1830jEj{1n@jL2 zPR`ayv=^}CNs{mS0FHFbHP}|Vil=#NNr8*m<;F7@9M52Ln+eWjVpeXf-2@A#0kCBa z;Py)w>|*ezI0TDU;&=x<@PUoQqc6%*Vhkme&vv5DHb_bSvR7y@9Rq2;F_4&AMMJY2 zkhASUW9rtmups7qp6uPoTMw%Q)iGRRnQ@p3pMozkYlLJ!G2?I*H8a+kF}D+rvBBvK z3L6Il`#?39&IMcmADBze#%YOz@5hOvLB-KJcEm~WMW*g{o_S{i^L}!H5Y4Ya03 zuEG8hF*$PefC0d9zoO;VwP=K-h$~vft1W*qKGPC@F-}6xK*Sw#;&$2?`YP-D)e~);?hO~2K4Oa|UXx4Y0b?q=V_eGIk zS_xOZ`Y-3~XQd`j3%#F4Q|s@v{c}>aR1q%2{Ff@9*&{^J%uddp!!sXDN5iwP(P8kh z7~_$ppMo`79FI&BofyEW9br9nfeS*TAiU~j4o8W~C zFIM^(JXK#S_fQpWv$%-k|VCg;}@4uj}>>MZa6&&nx_Z!Vf9@n8GE%^6tid zBKMKQt>pU|Mdy@QbSsok%s#ivV~!YK@tE?S^0*4;uY1gX`J%_;aQ=?RN8|j8$JIFV zUQ_uJz=1{`4rvsLF%)VacvAv%jv+vVBIQcoYOz@cF z0l(uXy$QJ1;}&2#sjD)DM<~o|5S}`PSw5k&9DI*H?0#j-ZQ)6E>@_;?*0r{p>c z^*PT%-ZM<#oyg-Ew={H{Sy&MHqReLwF0K-QrXd0wB>g#VDT3Y|lJ zzcyuN-OR()=QOY|yuUWr8qB#WY`t(SWfYD<8;-#(I7s2_#Ra94L2?F5z4}D!A?zR3 z<+KE+kE8`qrHQZ;cvnj<9|*IKqjHfQr;q&g+BDiqvTwyOoYB|Wxi)1<@AAd_5c|;F zTjr7OTsrjop1+9q#(UjCHUu5)73vWGgcJVrjr*^hBmC2w|BQDd-9y<0bWdbBzf~Uj z|KM z=zMDsU_Q*3j|It>b4y7BXdZxHMBtsotwfl(&eMO7^AjHP#5np@{w#ctf;a~>al&^E z2>Mz22Sn()CLi5R@PZkhj^@eh5GQe)K+xCAJsWbpY-)17h0oGCkf-N|B9CW8h3*vu z_9DdeB9C=h_$+-C_m|IaaUxHir5SIV>`>3rsV7f8>}ToAtVrZ5&(h&|#$jzFIez)U zzwc%{m$i#qiEW`HK|9XDP8>LyqVs*2s}7TKL9jd)#VNOTF@nS(_Fb@I?V_3?*xq6& zR!YJ6F8pWqWG$9K%3BNtv7g`+X>7`vBD>;%kj*OC7R4e&%`}FsJN#t^yR2aU6*ljG zSTSEvALnpBL}$kyb3RYDD)JT%_;TnPfU6cJka{5gd-x)&W;pWc!n;#F?_V3=lyR23 z_N$D?pN|$%B@XR477cO=X6lvST_OG~Gm~7wLftk?co-8FUVNA)rw>0eMfm=WZG~c4 zl=q&_n{AQpQ`)3Gzsot(d*S~C_dm7D8~Y>u_DEx-QLZ>|#O9DFPjSa|=(&|trttd- zj?bh2TuNR{gr9F&IoJO`2Kn^JIqIS18OWTS-r06&4vNL!z_V z2rPO+``)i^rO-K$3yv$yyC!t|Oz@LQKHo)tLh)=@^m~D+m!tbUJh8MoNy~YNV9wP9 z10I&!-yBz6o_}t;#eDV%$=~W9RSwcyjsuP955+eHJd%cDD6fXVJ9#ipM3}h2)8EF^ zW+5=&1xTl79n6E*@>&qS4PKnYod$xI*MR%+4rr9eTO;z$1(q~`c*0@NAc1!h*MzWO zMsWkhc+bO=#C-r*=Q|snlk-^S%aK6xr9Mm20Gd7ok_6sKTqnX>9_<8GgGPC5e*AIOAOuX z6b>Ti;q2QCvM(3T)n7+D<$Vw*@@oCAB&W+d47*J;W*qihy=6RdL;cBIU2F(rmlj`% zlza0}2&`8G3o);6`b_=(ku&ceI`Np3i#~&Y5W|H|FLB_8VW#Qx&#$<%EEo68VAEDy zQ?+RUdUM^;b&sC)oqL1r+m~O9*O{34#=sxM?=N|*$c0L9ANETRj3L*gfv3g~wIAxk zD5bnpY{VeLy2mm2DnRfCF8p49r^rZ`vl;aivVqO0qrd>0QFkB?_D%R-oUj?i&k0~N zYAcDc(sOW%RD<2yjH*Vgw;4sfU}!VyP4bOK&fX-{B@nGlLOp`$(({?!;?0ELWC7ks zsO#2HjJc5 z>F;nFbOR1B3DtvB{4~ba66TqNdJ4kCBvdyd#U#`XWUre5Zf_E56(VU8ivLgmQ%LSF zj$656pLAAXmLx)bS?uCn1td6 zxpTo}F9ar`XiFX@p*G>O1tledyy59 z9SFcA6f0-Y<&XoDP#& zc$hI8treM?#NRNDn1rG&lh7oTwWstqHlO-L8LkZ`p&o*OnF+2>!6ejI5tyAgl`&f^ zTSMYYEY8P*7ZEc*!K#BvC|3Kz1n)RZLa|;KCthRVwqO)4`{l$p82GfUgMEn)G0pA4 zD-iHnVhRJ>t!SEr`X>Yj@$YkC5^4#G;7mf{3^72$utBF4J z_mEc^PcwUO5^69re2lkgOnfitPq0-ba_No*j!Ws8}te8LevPRs)$^R865udQ5-!T@O#Bg4)n1q_oBok~yqDd&Wu8Ig{ zR&ky{lTf!&z_-YDn#CqD6QW@fiV-D=Rt6fpNvMrvn-^S!q?IN%4X69T#m^kWj%M46a`;=~mup_ry7K@BlXLNQR6 zn8%ovHZU_WnK2zU(2zKlfleEMNhscI4jJ~MX%dPxFp}1*?EM5`2QUl;fm{*cBWfgj zzO;bv*vO~t@i$;8jzwrmt2h!V!?hvwQPkTgz6S+muY!y2!|=g2exu~f9F?*0(v5Cx z#)4THW5y#mh7ZS}Yyx1gbj(gL`M`x^VH{~F#bpt96d(TUkmd?_7(Ob_nsFxC>WL^c z8OQUly-UUr4xfl9$U5*&Wyq2B!E)T0ynh?;f#{+t$QvHShidryN+Nc;h+VnTRXnUTBPaRY7riPGC8htm1M}6`3kz!*r!(i%PzO zl`P!LA?_a+t3p{(79-)AP;AN?>P7qDFxob9dI^IR_#A&vRAYxxY3Z6t{?k^vi(N*vz=AxS;=ilrbsoTAWRt*=DY-&rw;a|{f ziwx%-|GyN$2h_o4@dtyGym_M9_on$J7y@Z*xuP%Q|8IikU)%=rRGv|!7X0}H=%{fq zi-Zmh6*p+8XpCs~jufNWJNrmi+l}AFb|1Obcw@hK1dEA91E5sH(d|JerP%I4cd_yp zn2dF4-CtuC4Hyl|l>^ZOK_W>UGwYlv$>>Rb*LG6Qz7ot@!E%?ff0RNq zm;x(e{p=ux>nN^Ows$vW)W-z<>>j0#$k@@J)5g&um!H&7CRUKN@grxYDrfSjE4>Ca zrcE6kv5BJtTQ*AN3}A&uj<~Kxb8vrNOGmf`+3wZNxG)&wGAV2OEwobfU%HjZ&HRkr zM`52D{*f)8jf_W_&k>&KFcGvEa}{$mJf{qFq!UvQKzalGIFC~}Q#N^)!*gw!Jgeb_ zz6O|c2h!aP!{HAjOvki`{A{G7J)7=r>@bsi(;bbI54Hp9y|9{x()yCF$xc4N(w=*g z^V;G1ukGQ1uU!9cM({{ht~gIajTwEotI09-U%TVo%(>!lvxB4cU%TTQXU<_!Jr@8f zwmUX+q{hX3yD#H zF&@i*@KPB-dJ<>iI2Rq@mcx_Ie29g=%hOp;#9~_t@PF+|p$>TOWUcmEg>O*!CWY@( zc&EZIDExhef2#1W73N}z1dmjh-&P3y1cm1){62**Rrn(c->mTM3V%-FFDv|{ z!vCo7_Z9xB!fz?e2b7d~kisJso}lnlg_kJ2OyM?#vkI?Qc&EaTD!g0a?<@S8!ZemI zWiG-nF1SKrDrkg$yuw`X5&ArZmneLN!c-m${|1F`Quxyfe@@|D3O}vzOA7z9!mlg* z?+TaT;VxyUQdrxNTB_*F6<(w828A~(yiMU93O}gu;|jm2@H+}8pfHkhCKaBj@Jxm0 zE4*6a3cd|PuS7Rm;TnafD?C@>WeT?|%)gHinb#@2S>ews{D{K475=uuuPS^X8&Z`} z5lX&e6+S`XlN6q>@OcVfuJB5Q*C>3w!aq^?b%ozj_-%!Y@E{D(ujopEWxvX3(&6b& zP?#3+<+^4oZ0$*T{)#Jv4N*ZXJ2EBXY5Cn{X0Fy{awhxNk+hy31fHOFCJKi2|tZx0=x1;iKv%tt+@JU$ml zXZ7CdG3$xX2+~P>n9mE+j|2XK$DB9u*+DwzHjjDCIS!vAq_fVR^|%3;&lJ+< z0)N|M)*qiQq%Q~lk;klqpLoo75xM~L9C3n4l4~EKaJ9m`kHRxs;e`q>Rd~6=9SXBd zB4>lbn-$)sFyLXiB)D*?cFzzKus+!i#j!opaSlt|08h6K8%KC;T$W{e#<4y)kJa*) zBm7}_aUze3XD#n}$m22z<+06(JeG&@NTYkzox&sI=y<=`rVhn7A3Tx<(CmY+A@Gj* z(wz=Z+yGDaHeOnJ&saVTIbr!YAJ+0XucA#kaT0eP2wGkP8Vtv6${XP0Sbt6Mk_OP+ zg2>M+g2284zBAB?HZg&B!qPE^JRXFPu<=y?is}C>)4re^~&qu zI~n769jtpTZ!_fW08O04eG3FF@6n{=qde+QL>^zoq|F0zn}Ycffp;R0=OQ8EJO+hY z0wVi0Wl$dLn{83c>p;J(1x=jDtDWMvb0wWS)VCV-N3j2k_m+iV-)Ha4?f7zS*Bb88+EqOI{SSX>N6|yYE__c>+3rnWzvAA`?o%WQ|{+}o67LrS3skqcFm8&3PE975oD7RAmug&1x0`Cyv zLG9$1YW7Gb!)pnb*M}Cy;VS56!uxe#+lceN(qW56FGlyTyPfA5mia;)ts8@*8yQ@C zCs7(WF=u#1rWD5`Si8j{>$-RO_00Z0;i-js^orVkYr2zG)t_98uf}RuG≦t*xIt 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±ypM|y#Iw$E&3(ERpz{PmK))zx* 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ÉSbVz@+dr890+f zbA?SvIO`hu*B0&v|Gy6kW0(d>wYTbzBZ?f7yF(5crlE2M@qGaqrlHIQ_C505z@$L` zpI;y3OU^90hV!X84Aa!>oEp~Hkbxm79z>#V%$%uyEm!X7PD}J9mpC953 zE$&MKZ_ae6@`}Y@Q6U$EkdejT6X&Af7+u89nGDn1EVi;?np@Q`HWdFr$Yq&N$T6X~ zg*caoI1`JtDuE2skhjL-QG{F>(wSZyOUPBhvQ1NQ0oU#73|1+QE?!K?HG!?Um?z{N z!G6u0B3D3$X{h$OL8C;5X{guv#b+qOjhTH_?5)Kw;B z@B#Ah;y{)fL2KDY1@{GWzjhG{s_NJdbe5fo%ZaN@7p>{gJv%%c@JBu90I z2s9TLAvj}%+Y~gCSVM9bzmIx$T1OC(-R zF3!$`9=Z5$T&HtlmZ&ZnrXi%ZxEP7&hA0@O!E^W|gbRWz=4>(1> znG=b_Ggc?gH}*}~)YX&fsQbaLp%5&HyEPOm>)A**$~OXBwD z#pTRviH+@>F`ETsYo_YzMauL+%ozu2Y=SO77HBrekN$p){2oaC@+z0;pvUz$Ro>r> ztePe?Y>j>~sw#v6jk}G@_LnTT=D{aZlEDl}QbFUN6U>g;Pm)IPr#J+TzfXMGaU_s> zPdHz`)#rp;TN1Xvx<6P$i^@WO&VMr^zsH))sB{zKowI{M7HrA5eT&gOcQy9!xs7o^ z#q0~;!Z>hXjLS1a*JH10bQ+^A8MU5%EXiPa#tg~GE>1KgQ%T~uQCTex^e`i1Mr7Q# zJ1{j9h=!}}4o*MOkxi~%6#U~~8oba2FRBuJC;rxTto6}PPp2-RM zV%C2k?%kAeQJ;+Ee2f?4ojR1w&+3#)JVPkZA^J~47gj*0^TPL?|Xz7@Y1qWF%=$hQszP7b}z3o1v8#$%8J27?A)JctfY#IHP z4A;D}wzFh4LUv-J@r_h_73&__$I|608@|!ikqwRXdn3Al!R$o3)s>po5Z3ce4JcgW zst1!y)xe;)x*_}zL`zlLt7yNb{`p|LgO9ekCPC$YBdrA+PjQalUDRAThNh4EjqTDkh3g?cdGKi z=Zzsxd5c{wt2~NSUG*A5Eq{X5RTD!QMuyz952&kz2LAMeDcK+mon176(-is7g;>Eq z;V0h?Dz!ZGNqPfuV3G`u2q&tWCW$FZNqNc z_vvle2lFNvPnC@_#k+)31S+-Z%S;Wfw@9$HWXBN7*b;{}zBS zLi1NO{1c0h4JmcP%Vgu_AJ5`X>?Pv0+9mrx+c)cz+QM47rgN!`NVT=EU9USAjhSVg z%hh$zEOaBwc2SqVp{4l0#|Thoa^}JlO0#A!JZ=7&i%uxbpSS3QGiJ?ScueEKS+nQq zKOG-2h=e$6R#hf@8-Rf)PhQTNpd@4Cp;Oqy!mR;u@MpFLXr+e6|jYYok|q zzzl=oY14rpm?0p98_c=@{uk+B4u?NuL(;>a)m`$AKSNORivQy}EDwy1A$Y(PA08Vi z;@_`k#NV6YA{DvEHBbJ(7pMlKZNK>xMq(DMYoQ^8qyFDdC^&AeC9AL%>i_)&T0(^w zX?dy&EwSQL6fH6hM?^R62HQq+qni`_O8}8@ z>&e@56kO`rO>Wz>rGuh0mV2Iru5R10%l5iJlI~&eC{`Wqoart^?Pp?@kXN&7#QkGD zn#z_j_a3%}Ab7yk8+BI9rV~Tz3w(#pr$)R;=Z=W4)OoYR9|lVf`MNV=osw^Zqs(U_ zCY*i*ezE~J`$$|D_-E^UWW=}Ve4N8vD|i;@OrF5E=**-NOdqr&V)~u#i0NytiTK?* zzawJmfXS%IxzYJke*Ed9J{B>3(UIV5?FCb7i@N= zo{0WjE3o-Lg}-Eu)fsxF>H$qq-b{~XvctzXJjdZv96rNguA|9e#lSGv)iBr8@C6QY zjm`gRhi`M3_Gdg_ariq9(=Qm$Zyly%HUBzwTZYkpF^np!VfGXZ&vN)whtGESEe>Dn z@XZdhKVmXJ?eK#R|EI&>ahQEni;Im8!we1#4{~^v!{Z#D>hJ=G&vkf}!`%*VcKA+* zKkM)#4u8ktXC3~X!&!A|mj59Rk9PPFhi5pp5yT84!_pn)ediR_!5VocKD}Y-7^rMF)-c0 zKRBMO9^j@I8Eiet4UKmGW596;_)pHi(fQAG{wF!S$l;|9uLMV#9pISHb;9J6=kFzs z|8mFU?LmFS`QHbQ1H%WM|9?6B3vf*LPYzcPsKhORBhOfer#Va=S$*nOC}X0Tzt<0C ztY!WOIee(YlN@GG&iH3LJkMdqX~uJ=!#q#Te~H7(9bWBlr^9UiS=6JN$cx+4M9y>@FKdhr#ejhYxfZ zH4@`t3)Aonht&;exmSN8#)#IQi^9hLMe&>e*M-rgh0wVItLsmmj2KZrj#$k!c`jnw z*RLaH9Q}ugNe7#a$YD(&r!$y#hy6zISYgzizzxD?cWb=xnCQ=aHz8uiC`pAj+JKa3g31MPH0#IF`!8}Vy|-w^Qe@(<2h2I_VrNTEwe5LUFBfd%)4G`j9BmAj|X}_P3_!eQtB=FoJ{FR7l z%U_T9PT?O!%pBpz5kDaOT*O}x{&mC;3-f*?G9MBCOT>>0qo;@eR^fpWGpE=);vWcO zyAqzKgrS$xrWx1F+UgRA*Eqb%;fo!nel6}6hp9*NzsuqK9e&JV>caS+arjpbKku;M zPEozMbgPtCL8c3H&lu$**iUD0b9C3rgL*+ljQE6UTGyu?Hu@wZlXr+byu5QIkNr*L z>C%?vkssva2OWXKkvV6|kG{e9(Dk;oU^hHR*y7+1-vmG;<2z1naC7t@xxciegvnox z4#FreJJDX=5;>X&$TO0Koi4YRw?y(5ND%U1H+f5iEskJvix&BqlNedpdU+To?4!!e z3C_ddT7~&^?`%l>J<=urmhL6O7Dq7owH6)g0g)_hv)o?Z{RgN0C-UfnP2Tmw7Dq7I zOM!fx(a6HClZTi0jO5W*B5!C6BcHeFAWowWs8M5^i!@#~B8=nCcs9OI?9;bC`aR;~ zIvV{}d`;%i+4A?O!vs$pk+w51WPJ2zz8sBe;N+Wf>>a~!hx=G(qv^;qA@Vf%HDNFB zXvu>Qd5Ti5XNGvLT9czkR{BH*mE|GVHKU|{)Xv#qyGjXeLQo{jU;1t}%YvQZM3hnrg!Dgnl~(SE0D~xjXlghCS&{)j^Q{Gdv?RZwrp}FZ)S+vXk_m>NZ7{ZLh5~ zR5h3Ft>xnMmBOl2T1#msOXqmM&e_x*>iTA$sYvBP(0G zjAKn(N2_7IO`J?x*4f^!FB~P4Qe~M*skj|}S)p`&MoMJUbQ-=(Crcjr-~AGVwV`A7z-n(6G9o@_hRM z=g&MaqvsD4Wcq%-XLY1ZJNReZLJcDaO8b-)^KZ33CSns0pRZ}dxpQqT4r4Efu9%luW=}9@Bl#BQ# zkGkX*ur?)_+%HF8*TX+g*U4H*|IgE@>FZ+k{Xb9VQ#hr&qvz?RVhImbG6`irrN5Wz zd3q8FgzLT=&(rh+DbbeXOJd?Meh{nQ2V^BDyZY>nPt+)2&m(nLAE`a=`MW1$JY-Bd!^hG4x%z-SXZ69?`?*@B=hn_VSNWa*m=n5Uao||2H z?Kw!i-p|#OByVS)tIvq<$r#_{_4Qo+g08Qos%5hL#pi0!e8&jbp64o0HPif$c8Ah= zYNZFF@?OG;>YnH7DorN4Tb3r1UTIU+a{tMVwCA~+uHD%)cF%lO>z|=r?0K$oe?WAV z9RFy~)ydPROiR~u)Bk>-tBsA*rw7*l=d0fxs|t1V)qd@p%!)=$jv08x4VS&{ti{oJ zL6W@Xn*4;})mlG__@HWyCj!n)m^O9nsG6q-Pu;8fT~F8E`oLm&KUtexxL5Vmf4#Y} zY3Sx@2VFRJ)YLPoYo0B5hW&rVcxHQcM%F5f{mW!0rH{0HHzty!j%jCk^%ezq`6j(j7L>R7DF zA1GKgbhDsLg$A<(f5vA#KGoMrsw|DLlT{;2BlqcCdnGB&XY;rAr;=E8D!$18?({F~ z7|36+H1fC@3$irwJ9*Uo2%+;xJgNIR_*FLv=92s-9H)I<4%v4QT=+WRDJph;pJ-=9 zbN^(}O$v;5M(PeA)Y}i!e|Bf+(G*XmN`XM*eMs>s1n;GuQ*E7$p>!Ns~?689MJ z$hsx)919*@H;=f-f$Ni@-`C0PjMTj$qmb0j2<<1ypPbqmnSvyvw1r0(Cyz?mePtGf^hshyF!FM)g585wY^#BoHCJ?)I3^B3)m z)P0dGrglc^*bmOH5AyYbIPGE(TkrMxcg<0ZU>oDz=m7|>lNpY{7;IzQ0IaQRARq6U zCR|td48`37j37SG!{*`QiCqipDdc(tAw_(XfjKZa;ZfVV7zLdc316g zch&B3SM6T-<5jyaT(!FAa z=wCcTxIc>~q}5#aAo9PuSp0M9_(Ep>iB-ZqESl8KB;Bp>FQ{7x{?>ZoMRo5X4^JlY zSzPxv^6*3Yvvcd-i~rN`%c2PfU5-_42Q$So>$t zZyo+e{bAAM9)%Y}KYLKXNfGnuvS>n*xgxs1vS`B1ghdlt*N_}ChmTb_7ENkuBmh-i zSu_DB#gP&%izYa#iznh}&dgLmUGX~D%%aHv{6>f=W_LK&ps;9iHWE={DqA%9j6!75 zB+b&5s;II>6TVL?izY-VTQr%eB(Z4nJaQUHe_3enN%3a5muI-Jxgt+CSu_bxt>R{c zt_Y4|@de_n4Dm-77vfkI(rzfOAtP;pZ9?%P1iUUd8jG(cWOZ;f6^|!mO>i_9&%n_h z9CMQaTx`0GP-rZgPy?grH^TLl$6mrRS`unHSTy0zw-(SG0w;(6l49oXQax2q=Zft6 zE#OwA76uWSE$DRaw?Y<7&ICbdeh0PDJLR!I&zsC*S~9zA2WV81pyGKT`w)8x)XUaL zm++WV^>>gw9#SlMR;^Pa2X@GFX37;jl;`;hANxZt-1{;=6&{Jbq_Mxoyy5r`9Fxo&K3P%+8rbrd;4mjd^|ROB$#_jEhnHpLNxvAGWR?S2 zdq>gHxzFC2@uSj=j>s#cs{8a)XQK!p{=WX3XJw=5gkWzZ<`NSkqbqhpur=Z=ksR<= zjUt9+FcNa0pv;Q^>zz%JXlP_gsIjpzcG-}~L6ef>Mg@U+GK-mz2A`|cl*qWAUb^Z~ zy$;#v;KT^o8BtedBu53Wh58S~z(kEpq~;RI#??3(JY^FeK)bfh)Ykc8FMsK6_LYaV zbu3%6etGNUuJgKfQ+^*N*HdY)EUOvI^fL3h)^%}{l&m(dtFnT16&Uw8&tULKZaiR%Xu>SP zS-OHRtzn%({2P~5;(KW&*$wDwU6z`;528|Y?<+f6m)8d)_NDduJe>>x3M;{p_?!2g|hZy>^gDY{1Zwm zT2@O}NQ>*`U+-1+w$91!&M0-XbuR5n`uGN5#Z*aG+sY2v3<$N<(zUF+t-UpM$Uw&W zHL5Zh9$A%a?9;$RX=Q77utbxPJ((z3*G6mOf}f|`Q`OzpwXE{(KFe8X2%#``-PAD3 z?#}fj+RHSB+Q;%XU1D0et|hiE{_!kFyhyepUZQOmJ<&=s6|+vdYf|IuZe7{A?!4VH zJ+WrS^p>;!vr+ zN%+2R?cp+0658YPmh)a-H3|kJ5NC}z%9NXsLPpyRRyZ@38LQ(U9q?)l9o|AQ|H;n3 zQFwnH@H0Rk6EWj*W%%L;xb-mn)Jv;b#rhi)S)c5Z6>Cx-9w#Z^F zKd}@meVlA(#IYlb5xS#LHV`o>$m|thxWkwPL18|;cZw-b51SDv*NeDIGyI7-VY2|L z*HP4M*Q9d;SpK9l(fKz`#bmSm=h{I$Te)0u2+Y0Eh!cUsxBPN|` z5tAQgNAS=~%yO9Pi_D_V;6f}TGi~_kNtQai3M_u|1}*?1{jJ$wK$b@*O~zwYo;4*$Yo z_5>~ewd%kO@9pqdhbKFXA#dZK=kQq$FLQXU!{x99G>d%aSqRSc!|U94!^W&A!|!$YV-A1D;YS?)hQmK}_?Hf! zs)whQWwFDr1?!%Nu%Te@lW)LZ2lPhA^XAB-=AK-Jf9$uf0qcOU%xyAnaroaHe%Rsf zgQJ{ZI{ascYqXecJi{GsaQG;P$%mCiO}mUq#{3y47-l8k@K}e{9Ln$DFov*l@$5JL z2Y8OeI{dOQo4L@|h^ea|Mm$K^-nVBMz=t2;Cw-xLSfum5I*3mgW6Md=ZSoe#y;g^j$vZ?IUf!LOXYZAA-Ax|(K|X%a z{o%jzM;OH3o|=8Xd~?KOaRh_B34lnJzvJZg`MX=22Xo~|dDT6X^LLi8m-npPb9Fx% zS=j0F@bVB;lpy56P8jt^Te3KU3AQDlbsh%S_u?C=$Ww?A$@r*ypKftXr5vPZ>0Tmi zaS$<2f%Sk$7PeV#FYjE*Ymgu1(86?C-u1#3M=)uVyoI`7j4bRrd3br7CGRo$A#Z35 zBcHeFAWowW=(9@fMm_6{2;;ajo{jJ9V&D4b_lS?{Xmo@4=nssL1wE?6FzzSBM>{jJ zu!rU0%Q1g!dOaxzQ#`^b$5tH{M=<%es6y{*F!Ku z6+ODc6-|0{^TMg-RPk2y=)S3X+(wTMt*fXEIns4db_#gMvGr>0Lmx*DXJ9^FUDnCa1dkdQw0=l?q8{js7LonG8Ogc!q?ZL9^J82%5Lh>Fe1bZ|I@S79qhCo-Tx~3D^ZVbImL>4bYEAiD(lgOUc>b0Mp0nXqdT4` z{p-67n+W(cP(f zih6V?5Lcr(oQ@(gTRx_NMo^?{06}F%x>Sj7d=DkM?};fW(V+upN_0^@Zp=5h9`DQC zub`kFH|9rpygzu1If2@{E#R@Y;h(C<9dx*o%zq$NjoYL4CcU}cPR zmEL;mxsBac&+VZ8l-d}s_EKtN2_%y&)PEpW0n{W!x~n4DAQ$Ht1!j{^tJ&^RYU|@O zRnsRmO*(vXRJD8Y)a+#RCMva+)@z$nwf}!sYa7=~$Lz(?YTKixwwvl`mFwHVrEOjQ zcd4KjwazL^YJI#7?)20`V}GTnsP)h#=v%j7k7im&XOe1p2CXP+>2FapZ3iDe+M|KC zz3(7tNiz`VFshC27efP0%a+Ml9X1jP$dvhCS#Pct!+M5 z{wq`!R+7CN4WbH3iM`?w+MRC=`4m~V4*P&nDsD6vjc_+d2ki!3Gjwf?2>VrxA-`w|d*eAAq^F8`nTtVsc>9(~x+4H@ev`%*BdpUdbwbHuUqpy|L!ybLD zv>yJN`dTGD^i0=inXu^~ZN#4kqUcSIXLID?*?0;5aR~G;U>(qPU_Eo88y)^6IPwR5 zt%#p+{$6+Mznwp_EN?u&4I{$vi=}_Xexl|7E5hhCLEnm)va^GXKl)cckC<`C|3u8V z3mNb*?kGfz{?*bqj=xY!kKE_&;qTA%nmD}brf@OKV^`quW-W>`@9@oX>kssva2VI$-%KwBx?Bl4J z^~*O$JQhbVxk|?bKqM<~Z~drWDSwoO{Ow3T>TZSq4;hJMY4z5RYEmP6MwNuT9qC8? zs{$W3A>uXITR&>OZlImfj~abor5s!@tLICcY{BFMl2;FiWa(~}n>funpyiU+pflxQ z&SLU<>qk8-d3@W?$mCrY<21*B%Ovk&VdODSF?qKM6Nh^Z`k8LnP1@ZtB8=nCcs9Oe z!*@iy!g`xTj%zegR$|GVOIm$%IKu)@e|vks`PKD{3($By))o{_vYM2KYReobyK zZ)APShdedKa=rA{k6NIc_bG)NnLN&}`jhF()LMD=ryuoxEl9MQFr7_awD%bn=Vk7* zUwfZTGme;=s#EoEmu&O?N=P?6_da*0w@Wso1+!vL)+YC5((}Os2VIuAW7y>%x@?S& zDVKlfuz~&QJRK~lsm@bl@;+Tm>RJDp#|1K<6FeyONnnIz;ER{Lt8z7eRQap2H49ah zRhjBfD6A?|%lDG1vUxuJSXG;+rB>C}yh^9sVzFln^Jf#JV1Wtk$6)068KeH1anF5OdO{@f#XAzXW=Trx?Ju86+6{=lBmfNH3&N~QRk_^ zn+!c{hlOGlcsU~92(B%>U+gKaE8LE-;NOSNQ*A+<*kTD;S3;;kN1dkvxy&Dt=KDFM zH>D{(hyRgjO3iuUnc%v@mzC4}QQ)D4yTC_-i-nJngJZxW3)7HuEO>N**BJ80f$Ni@ zf7Z!thZX)sxrjPX>aK*N?XbZ}GM%THFqzI%E#G*<{6#2;Y=?bQIO;s5HJ0i;6|N)$ zXOd{H@Gc~zI!}e4fP3gX)tc?FD6*&Ruwx`A>O2*GOcqnyVFmi~{Q4kYJL9wD8vaSK zqKQ4RwZ%_VLh6cdCC>RF&d?$qk1TqjY*s9O zpEwtUkdZ}(LDED*^ynh*&`1;MX0g@pEjtBC{?g2?dSEsb-$%%0nNP?uq4*%_Tpr>~ zERILO+k>OAxP*`^Lpsxovk18=bC2RQ6^BWtG?6|h$I-=ggj^HYnu`x}ecq9ITp@Fc zT!FGC5}7J%A`L_IjTwwSZ7u$ukefmsJX8F4;@q71t^_<=T!G`3AR3Ea*xVVkM46W+ z(gI~+8;f3~5iNQFYYXT*@JtG^Kc zoI*m}C;p=U9u~a{r@^xo{so0q;BR#aFDhI|9-jP*@Z!QMuI3NvXU;9$fdA9*OB0C` zjbsGn89_lt1SkHg&29y$%lwI=56MxTAp*_CMF`Fq;Wh=0B-W7J1^VCT5{aScjvcQN z<5Kx|DkzAgN-8{x{dIYSE|UU>dn=o|2dh2AeklJcinV{{VC8-Ir}T#=(rF4WhTiX> zfRiF0&XOk5I3<}Y9z>LJp&?<>i`F$Hhs@!u3S-ghMg)8owqpZMioe5gTyRtu-=uV; zi8M{zb;V#(%ruc|@%yM^$LtQDsOm%$>6b`+Gr2HLB;F~JCQ_QEqg2AOCej~aJ2ylr zTl7Nt2u-AG)ZmL5(q9(Zds2K8Ia{9L!sdz$wq?-^M_utSgsupVV)3)YSsCJwF1{7V zs*rX=G3dRv1-1#r^APa5;Aku|+>j;`(wd5s2w4*x%|#Xh+k!+_$^ED;Zid^iVzY z3v*P`nqj;bl@!putJw>jD|E=CW;nRE@J^MirU8 zNAb1W?9~hQm&uSMbF{GqD`0RP$Vlx{f%?p=#U}j{`gtiNai5I+mGFQq@c8S8c^=*nVDDXx{K1N=u`ia*}3b=qfqWT{~f*Yg^T%u|1PZjc|o`5R^cYNzNIo zQ)oSv7ykRwMS{hMVP`h^s{VID7YRcjyQ!Fyes$}x)~>Zv8k-JlU9-YW?EItI*TSUM zu4^H6pSQNPOUAX-!*CHCOf7B&b3wg~ZylMb$_>!Yq3mG|(|=C-MVSHW8hV++N-aC- z>uJj|($d=Ax^87_$1>TNk+B&Wlxmdyq5qrJD|L~wU=!L-F9TTeE6EDX#$~%^25b8& zFeD;NO=%tPhMlak0up)dido)~WvpnB>qWGW6>^UuCM-x{kV}OL&hF*Gl+Nt7mCPJV zD_h#zTLP1iEbO$lNbM;#E>&6`EbH{N2^Q>}^)i1Y6I4rsk*{FhV_PdjGV`?^%UQvo z&+?XT*$CUdF{~HI23CLOuXe_$6<4xLCXQc3>sGXo*r-dXnJyVY!z>&Zs}u~21-ode zr8sV{Qb+41g|#nLotgzWX*s(JWC~as72HxbWtG;4wXBX+KrTibYiCzk8R_XoJvYhOnIlr@GrCM=ow^~sv z8BRh!5pTLzgceb_6}e!qP`g!(<{-{`keA7{h8PxT6qs;UzaP#v1_*Kg;k1By)Y3no zy(#tuAX))BJ?x7a4HaNX#t64`deUcUycL{6j&-Sl-E1|{%FI@ihAL%U8*qWiD`y?1 zYXdH5CIK;+lN>^A?I zCpz5Z@EnIXI?M+KOwN7|PjL8fhi5x{uET8(Z*ce`hp%$@V-A1D;YS?)hQmK}`1cN1 zX*J36Kh)v<9X{0IBOIRN@aYb}*5TC-Z*uq&ho5%%PYzdWm}7avXushD9R4SV4+rah zgN_t7{gFA2=UlK3s0AGPU*~YJV-(x)TkwyVI3`m~sf-CWf3K^eYEClziFh7cTH2B= z^M9ZIHs%4lC#I9~i->h=CBKcBcz=j^tT6Oq=#r$8`v0#dJsq(~VLvujWr$3jK>O(c zH|v1jq`hUuNihmpxUL>^w=b&>}!@~9t^H(eNc_(4n4Q~94T zXr>PG-5=i^@mL%|?Ph4V1rUjJq2qLbn{_~sD}Qr!CVy(q<@}u`?B!h{_wB9%E$s9d zr&(ucr1spo_mRgKkhG{j%4cx|lW7Y4yz?-)z8BwbWn!`r$Pam1nl8)hts62`^8VL^h|l14F;272(DRaK z?ST8s@^_msamYI~S-K%7tIswfjN{IDHoo&T#+_wMF$}(YbZ{Mw?iJt8=!X1SeD3m= z%ki)T`Fd%RegpMOy{PGw%du6M^o{-`d6d`4!oDUCFK>?IS-tE?H)Mv!?oXL8olPF+ ztn(kKj;C3k+}DirNsIcXE!sUKm@HQ24+2Cod1c*@u2w#=-mh-Rl%^whS~mov6J&yW zpSyFYH1|4$@Ya9k`})reR!*cx6sV%Rfm6C0v}WmUur;NP$bS!>`FC@w%^#tN(%rZn zS1$ipIMsY3J)t3}2)F9ww`2TQQgrd%R!q>NOY1ew9WkL%I|Ar$t4^w~I677yHf7S(sgoKHJAB$|n zCp*k@+ISW_Tyl7Y!|e|1ah_z{GfB>ViT;;sMqDWE^HR*eUC%KQTi?7rKI(zzQ-6F@ zoNU36?m9puOLwB&^lZ)1pYN32FKo|x!njs!?^_(fs~n_5x;(cn-EdvxHhM-tkIFKcyw&mn+qfVj2L_RhfE*j*+4#`gnPp5d48Aw( zARk7k?=_i2XLummu3Zb8gbqiZ(8a|pOTsojjD$!TCf!u=qq_vhkz4urzz;!r^`eH4AaO?B8)OT%fTpk-3qQ;VX9(uO|Z z=|7`3(7v6h3`sxmMv=mhO=e>>01gc*m;5Gk#?2u_ zf1`Dz_hH%!@wa9NX6-eb{I}3HU;DdDSYoN37J7T4p+>5vMk6ayUl^i?q$((rsf-cB7;shRy6*b&01>Yqj`-arZ7i1BJ3GRO zZ_Oy#(pvYGtsZg2yAh@^+LYrw9Aysk z!tE;BsE=MYIkb%(H=W6Lg~CpBh@dj1-}?zcm9cka1W!%zX(~VDfBA;Yx?gP8%$aV+ z$o59L%V=kIw*~$k47LA0ts?ZOnSbE@P+CD>`=N~ajTjG=d$06HsN5me)kNmL_Cu=` z#=a*6w*64NY(Eri`=NsWP)Q$M}a$DZ2bki6f1P+fYjlG3!4S%%bIT#$fBkUC$|8Wj4a{QeRlMj>02*EJf zGQ6w%1^=VCmWPbevi*XZh?zg|G7bI=@Sxq@BS>TS|6flUI=C+&=9|`o7QLH{&UKR`QsOA&+`6dE^Iq_(5l+r}95x&`cfV zyFb1;;;}e_;ky760FkV`$H@(Dj{YOH&M;S){P}t5S#o=MZ<3n{iIG9p8@#+FlJ{8! zB9A2u!l=KcIxLQ0ct`nhKqL!WFSlWWzN0oXCh~Byu(iTI-O*~mR?nno>0aXE2qw=< zUOga^$=fWqmp5PX8stYg2FEbuUa!OA2nM5|L!F1g>lEhYt#$bu8pDuxn-1cTcW9y_ zebj`=4dl2po{jHY`M&4%_lVEW>v`3quX+8WQJzkL__#dn%*e7pzvjzvi^@U1sTbC= z2*bTqhs6<0&XGLJD{c$>ny{Dm5mzre+84N7@}5FaB$LNkm$Xc4RQP6j_O~za5fye! zIaVcqZr!28#z22I^`}p5YOD{`|GL9sDoQsp_dfdqJ=PuGtG7izn!O+_Jlt26p3|j= zP`@vTq9{s+X}X6@m}^0l>xL&Rol z4_)}jwTHX#k82NSf#cf4N^o3zpz>_(fv2afJ+Qb^UVC^yj@hgSK$JPN<@FLWfI7?6 z0-=GtOp~dFFSD?qg_2BIE~vWt&Nu7p?%Ewz@Dd$^GOxyOP`WxXmPZ1RULOydj`pY4&tmO)~dZDLb!M$=K zCu5I1n@#0Bxiy7*9!V4WtmGugS`nSH8GYXliYBoJ=Z|CUESzogD;dUtcZm55?e%It)R!M z3d<&ym7Q`zc*n10D+-G&kl6}`H_ zZO3!gZoe>A_=j8F2z`rcA*F5iCvB9ThW|Z&Us%JnK(qtaH>@AWlV{+8fJot)81Hs< zXm;P1*ErM%RPM1Dr>}Jm#u6g`XaV-z5-`JW5#st9h1gzzN88$+%)HRQ0P1H54 z3sVJUxjd)qYt6&@f69~2HIn3zh@0^gEtWjyeoQ^62lyDhGw(sZ^^#`_dm;>)se|WB ze|&SqV{rtN#X2ScB3b@=uX$Xi{LK{)`J+Fv{PkY**sQPzTmlAruX#K!d5}f!oDW#i}wHIH9O-c#Z+GI^ZUl*;sV6~0-X{jGTv)i@6+$ExJd z);y&AR@xa|$f?t(?6j`M0+oRqnR}nRvlui=1nZ3^K<22NFB{sEa%GDCvjQ>Y>rE-c z>_FK*i12!{^K#N!B~GKzf6&*;oFsUD@X*ygQXq2}9dKTiry885zg!OQs$=z+&(tEI z8cerU!=D;lJ{N9;Z0J(jJLDJRpAf=_WyTF2UZ@(p-{7DUS}`nf+^DRc09EOvy`l@z zkQ55XieD+2{f(Mne?zN}+f^MU)oij#|J%&UcW)Bf$Id_dW@@gQ9CI_2XK}ka4bw}{ zh~Z84QYqQ~3^s6S3LEYajbvA8V>(8CNha1IrI&X?sA^5Z*7go2d3|e(uImi1@lOgH z+{;^+u3xG5(WRFIm#%Bwkoe#hz0AH+CTSwanzoKs!(H9$l1a-t+uK_;%bt{~ zB1}rf1^Ju0C#_xA$-U5%tgpm(+j*J~rF-(dDeiF3l?7JC8`V6vwcYQZBE)ADP@$^u zhN^e-G^tQkuqHf^nx=otpNBD&;E zd|;B3Ocai;pJASJh8gpjPU!*8|4?wu>MZAfw!^P=_;p~P2Qm`rZ%yyiS`5!MzP)FZ zcIn#3kq5Xr2Hc?@le*qZ2mTzm>A+p|gcbL0`59RlJ-?TCm*ib6Kjcx3Chufniz68J zl3oRfWMOCs8Ybw^a?qxXENrnne7a3a%*x@%x@*K|agf2hDlBi~5Lwu!h#CJtmx%Ab zQW*Z>*e9gJI9rm zrfc=gy&@51dP)C+jBMIyi^wpf0_<%XEF~_vSDV0G| z|9Y|0j+nmF`%_2L4=58hR^6 zSgn}Va%s?_ux$RlI@P{K9!V`GGBdT^`p+f<(0$De9jAXN^nF{h3L3bgL;lR;p+d{L zm2$2Y)UMHTgNy2D48z4VDD#?ZxBk!7?ht!K>-2w4W~wRy5krWmj3IbvQGeM%q&Ot} zanA>alxr6iS0xsUXF+9k?_|6>?3!GrYH-EASnULHSr#ie z=SbZxmCc(-#*bnnD5|J#v*SadMKpMA^l%Doqu-4lYZyePC&?xY^uNuJa{Gg} zuI}ZU+33l*sU=#TN_SOKD^zjlXu6@rOx3`+nNl`t)pJjvkL`$3lv@hhGnEYub_Dbo zE~opFj1gn;c6G>GDO8Vb5x*f(4hZAi@K@gGD9LEh%C@fV)^#Opd1>qw-)kyIN()zP#BlPmQUMlXsfAGg_3D#Q<;K zjHJBV=brTFxhhoELkoj&yVxmDl~#5vMMBssVSUCZq~5FLSDflSw!O_lRNEiX(pq^> z1Z;aEF#RLhxmlv}+M54Lhu1p%&kkSY@V_|x4u{|4@U0Gi1RMu*cM99y!58q4Q^2Pj z56^hZo4m{XbRQO%YiF48rD4YO_AVi9#nLT0o-l@w`JwE#2hkoeci8JAW{3j49D5Mf zU6Q_G?genO4(NW}-i*gt6Xnh$4ELnyramCX_Wn*Yd56f~%X>`nG-wI(s0WkB*cSQL z`lZA0#`Fehn5^Izn>2kfS zo-Yx$ID!fGx9b6sENrvfUfxF}uR(suv-uHnnU`4{!Q@`a+W?4UVb{s+<*_$o`Qtva z{M{x@9Ks;>Tu|*Y0&?6L&&Kzd1k5s~7zW=xI=GHTgY-C~ts21tJ*vYn?i0jEJ2SGd zhvnhR!2*!oAGCif$5vsBgN#!p&+>}f!oDW#<<&_ZeAM%f_8`ueyr;xtWb!!c5|n9) zZcyfV{p~?qrAnGyj#bIu&St9bBP>(< zMNZlLJcVV``E0hf<^v&K{%2|Q7csQ$v6wV5sdCRAOXik_i2 z6q5wM+A#gB)$~(Wc>u3jX6pt{Q^3I0`jd>xRzU9;BX!%Eg$Pw#*bGp@e%{z))~HWa zlxL0Vace5m#9F5s*kj&#v?i#UYz8I3zFt_gIwYeVIv!*;_?D`v-$I%Yy4Yp2zK->TZjj%gj7&TOBs7n7T!ag(xrPna=5kwLx) zTyWWYN#<#+;fhGc_HP(37*@|)o=fa6Z1asV_-m{LP0(TdlN}DLq*4AH=YNXBXE=Pe z!%G}q>F`>IH#*GwMwW*Q!Evy0sj%gFi}U}uxC#cdPrYwjfP9`iSw%P~%{ z{OE~S#tjY&?iAIFixy0tA;u`_*djQ~xc7Vs+iT<_q#xtp?rXke-4_x~_8}2B<0;xA zdC1~m&I2Fv$Pf9mdC*D1p6u?MDbF~}3c=gso1;*R1LIsBv^OKmU+?+SUCJN49#k(+`p=;{ zNQ*OV$IA=zAo&@Yyvfs#oVH8*b~BFH>G{p`F%vewar<_Sx88q2nBE*V@R&k>-yGaa zneJI4$-p1Cl`(N^7S z2+P$h#4}S%r=NS9{<7gMvi!+}PW!ApAX3e2!Bu?$aQu1thpI2tU+Nr#yQ((FlxatE z9JLOc<0$JrKS<-POC0_ea2!NkD{S+&poWKqr+VH{`TGe1WzniPR-cnjsqj+ z0miGz_*)x&rS7|(t3f?^WFJ6TE|0q>MK|>UG1m8Yu#Hw27J{2~K&vE=`w)5517XPT zJ&!zDex67hnyG{45C#D{Z;x+|!YqzpGGE68KqSjw?|I~AU@I&W;?g>t(70Ln`2m=5?dln zy40_w8}2{3jlL@Z_2$soG@b@K4?u97_N zE9B8Po4nhEi9;B~H%C^O5V?UIcgC~vt(SmV@-s5Nd*s1&G~$D}v{fVcphtBW#{CQN z#cl^@IqYF!^4hEex?kn6`@_#8w<^rb`@JGrUWsR6UlaE79&`1=41zG^_nwy?oZq>9 zw_4qxJG1ZBq)Hm2bc`&2>AOG6+cpF%t2?1j+B9Q&I*;86dna_ty1v}|+?^ve6Q9wN zG+y&WzB=Z^~q@BUeZ`b*+;^upP6}MW>sNaeC(i;C6-qe<92pvDlX1(v4JxaZr z+uu`*MM>06fxT%E+A}m(hi1f_!ll|~M%)k>7IHF%%8a;LzPd@I4|evoxodMkZjNf4 zi?7Xri_Q%`z`4Qo&J89Ji!T_cuZcH&M!yosCfDkJ7bf0uFK_qegWH)bZ%F6Kspxc~ ztjgh*Nvgi1udr4{wN;I%tM&t{xo4`SA15gN=NOtz{bezvR(#G^@fFtZ%zF2VwBspm ztgY9t@7#3*8rz@Sr&2Y$r{cCVjqkZm&{M;8+qD3Rl3CWiHaOkq2$r{Ybhf|ZCepML z(@N#`q}kY+$Di)+@c86jt=GZLXZNjO`iSgrV%_&^VCmalE7rAW9mBuu)z7B)ly4)}D~z0hX$*`-%pbR5!B?zaDdT>d z_xkzpUvmz8q07U291i1H)h%?F4x5WUBy98EFM$~=iN3DG{GW1|FpJB0$1u?h|6k_4 zvz?q19X{RRGaYVmxYgm;JIvh1@^*p4mpFX2!|!mIjwr*QXs8aGZ}Ye}nYTE9hJ7{< z|F?*_V?P}+q8^Bt_Ws3)Y486TG4=PYh==L?gNV5geiSjohMz^uP~(>o*Xs;fK9Osf z`LN+I^oi|(`GWZ$?XciZQN6e_I$|}2arVJ3ChY`bI1Fyq0ew~-18MK0gZPAzU*h7n zp6(oBPlQ1eb@1@$k8g%}ERJAut`6>1Bg@|udHDQ2r~J*8ANkA2F!G0=mv^z;Kha@i zVaLnE%VUp}`8V?D6A44!A{`b-Fj+0f2LX{RY^B_W38GKzi*KpIe7el3e}CwB&-R7>|xcA0D%BuNy6q9K*gY_fL4h`6R0Anw5Vutp$#sG7A&Zx zXtm;o)@lnawpyut|Noqsdncgv?e_NlzVDsiojd<|=9y=nS*N?wm%*?-qu*6co6dCo)icRy3_9^xpGD^ktGTqX8M-)->RomOD1 zGI*{@;KD;@pq+#Htc`iFj;FD2P;Ei_c1+;Ho$f>7$+5jx83%7aT4Qv5bJka9^Yf<% z{ODy@7qnl!?}FeR@7?|VjnPJM@Ut5Wjh+702hJAX@%8b~cT=_?2nFU1`CU55_m91*9pFBk^hOeN9DN8iMO{%N!#i&QU-o_^6VO1Xd^xtmf+go z$H)t%UVrI~iqPzIZ(%$S#knZm-4(G5&Ad?G!2_Q^b7}P)&k8UtOZVi(a)6W`Hii5u5PTpvDKKNt&NoHHo6VuWbMAJK8@Sm_kVo0ZeM@Dj}0u4veP~5 zv$Ka{0x796`+dgNXX^qxQvHon<%r;dJn1GVh%_xVsMQ9Li+bq@_K3Cdb8hN5Kw_ z`$K<=H#J6Z2U6CwAlsTtt5$@Tb@XP6^6u18%A6D0`dr=Iw4CQQ2NDBT))Tj|B2KO_^w34t=`O9g493 zz`uD3`XBR$=#hrW-sZS;)jSHmV0Rt8h|Hd-&rr)ASJeF!X8H~b3I4kg8|#?gpyT&G zOQJuj9FCjE<+!a3!s`&~4$L8(O~$yje_=RT=d$Bi&1Jo4K`xp*=*4Z&@tt>q*G< zio!6gjg+3}r1S^U`w;uBXDGcdalpC++3{XX9A~v4?ni7}ST${U`x7Ty?~{HBajI2A z`T*jf5oaP{zv(TUz?5%*$6G|`+)cd0iC4z+_-OA4>WnXxTtwg`B{^*z$7x# z-e@rl39a*vL&qmeY&;?M?WKqbOw?oDP6@@^LHAp~BA&>zyy{Rkl;q!oKUyg=*7Fm1 zTE%);I4wSde80E)6JYC8Nb}YZ8WyiI?-C&&a@aBwrXtCc-YT;*DWZPtLd9(OkkMQlEJdha$_t|M%| z2KL@#W+B_h>@y6xSCqjAc93xz%s)WD$2QB}+bBeTin2TjZwnq=KF9l5ITC7#EquMZ zMX9&MzM0;~Ga$*+vSgXzeS*+$^`y=t zT_!Uut}U12Pgj2A;xvo7o!JlSCA3C_fH!2$Lbxq@zYYQ$c0MzlE*h-I-p(i)q9OT_ z3|m*MhcXlRw3_VgZ$3r=Wh}5u1UBsN(=$MLeD>?~A(@Ky>>q2Xs`v&#^fj)KZ8fi~BNtnACx7~8Xe3H!V z78&MKqPMtUITXPTc_509vF7F%A*cNe(wJv+Y>>V9Z}1=!N(T5GAkDno%ud5LCL2bl znN!Uid|??yDFIUrlg!O&(U1ad0;1Q26sAup9kKu@(+7?;XXpG7o0KDY8g@kyLK(y% zKsrCgn(yQTa-d~yejM>KzQ^?5p-gjZhRC4f8P^dzvb@7A(sasW4nBARF`RwwGLi2O zSw1Y=&Sgu=;e8pQt_}H_D4P=;W=uv<2d?{Nfj)#lYU1x^1ZzNJ;W&+fLPcYUHIk{4 zXd!PZVtb>@0I;fIpt(6257QTp0tpWtM%Nht=D2PP;5-6<_hkTGImg-e7ydUGJ>CP^ z?5l>0=H@*px{l?QH6XGh`ZsL~`gp2w=IeR?%u$s~1s<$!F9&Cc*nITZOr3x=MoM5Rt?) zDv6&1^dwhAJV~K_5%I2NqONrL!PAJritKO)_*i?_A_-{WuEu+@AUi0w)F6j?4DE0n zfc*D4Y%YJ$2tJH-94-LS0*p>;sBb$Ko71xVtd%zqNwkTxMxWQ=_h0w{D9JD3ukTlg z>-D*L1G+c~tv9-X?}6LkLU3*f6qO{rU4hV9v`0|C{znikCPY#aQ$V8MzA_VPyY-K@ zp2+@;>ex!J*aIlZjBNd*9a;&6)i#dNVjD;39ix9Rwwix14scT;bYM6IQ`<`j2QBEI zkz>`)Lve!5%jwbF4=7%fg^aaw_9aRP%kq-RmP}BapQKw$(bAj9y@iSr$e83T7fp6{ zsBEJ)9ctShsxd|K1x31es!{5pn~Z#|MyD7##sWQ>jOp#vrrC1V_A)wD;Fg#{EN8_* zT-i_|6j|Atrmbx4pvY7+J)%!DsTmPHD79lmN6sVf6xoQAp_vgq8QNL%BD70)Xwyvi zg9PN=kPEthmF7c<_2BK*PAV|T znk-7Zw}m#_3iri}SS;BI8wNsX9=XOMzT)Z=kusnSR{;0zZVYH6Y7cc#lt9wOx}GFa zseT=yV*hhPK+A_64Qm?X=`4liVW{K7lj}*H3hOpDlr#{`6Q1Q}1Hl4V)0jl3TEOu8 zZpJGYr14~=V5EV6VV2{611zRE(76xRIfIqx0VjaYo^SwwFpc;p6JkCAhYW!D7lz&s zU_qkuDXiP5G8+g^IdnQ-2soY&hs=V7V3hFGT-!kKF)UQ3^NFBC4gp7Rpwl@nU^sQg z;!9qaQBzCTkua8#LV|M~o!+qIpvwn{Xe?6Nu)WromYZ4x??_lIb)d5dmYj6&aL9D- zf%O>G9~ccp4+!6tUlk)dG72>(yfFk_YEDlNG!4xvvzVK5E7E ztpVo{cN$EafRBTSc|lDH3|k#8F-)W%K8We3Y>7WZ}(N zS|ie4SYBQ|3;xP776^((WeRzmKWl;Vl`jyf&seyG+jo{PKnlzVlam6G(5x!#{64T^ zw%Fxzc4=iLiUmwSsH|C~Gx=Y=WPT04RWOgubH;t<&)p?-*^D`5NT>!Y{HXGhsw#Bx z*e<1J*6f8|KN(xZ@rI-Jvzlr-f5EOuO$>& zFP&c^N?9G{L=WyYR9cn=N&>kwmO*P)3rkbhVGe?3&#Do3DKxFB3btD|4RQ3lL%`c^ z9My)Q2DRX7QN~%YWCmNLa{({{&u3GcgbFz*Qr_>tTs^Y_?F0Lsl%OF{fpVlLVmgds z`e(_AQG+fm89QXqgt6m_iiebpH$*!Pm$<_uiuv28o>I*o;iit8y1oMrbH!ucppbJ# z3@sWlL^MiXuGFifx*5s2`b)5jD#9wU{4?BAF}OkNUx3D@+6&6Gl$}S(jQO)l7vL>? zNoDEsWi!!)W!YBGngw=TS)y^H?08|}(w)VsShTR3>7#8gSSSxS5M|1%suGRakVmlL3Zti4_m0iM0cbJbVhKArG;VU#ZcFTO*wOc=sU;`H59p-v@SqMmnDu zRT=VWl7@6*%AozZ#(xA@>2?g5amm9cT^hzERysSwdWTM|bZ!SsLw;f8pTM+&bV+pryh7NaNuv0Ts7NqwfP& zaSs4<8e1CdQDD3%7x*|Z4bxHvAJOrm`JY@ce*QTp|CZVA>Tr~Q>!x3_J&E!;e=a;8 zLpAeFdo^?4K^mt+af^l*=}6q-%ND~~i6*Kn3vNDaZ&()|bNj=k@xYpRb3YvJa@c%W zhU@11x%GP0@|75?K4Q+FTd%ZrczC{wZqDCB3~wPdbN*h>dg(F!M2(w%yfxK~Q#uiX z8>Kca;uU2y`yBtGbNtKB@vnq`4{RnHyIA|K4@0zZPP4HQ2Q}5{*}1*4n%|V0Jqbka zb?J*rt7_8mpmFY)4MQ|F;!}6MaPrWJoxPgh&JM|BCBv|NC>$gvK^l|2CyZzh^6tc1 zR`dWd?>aD|O-UZU&$N*s)4WPzrpY&Dq%(=Ph*3^_Gj>{Hb{H*Cjik4Q+g)NF6ERle z<8bFn%nrL&Vs^|o5<`9v@-}Jo2PNkFKYom&e141iP+|C8u%xqtY%4MK=^`;-w&oK{ z`TTT8e!dtjmY8obD<$Tu%WEXQ2`)cxiFD!am6-2H@y1@rgd?ye%e9duaG#4Hs&-T*Flw zzE;D$S1FlyYIwhfU)AuhHGE3LUu)RH&{4@u)^LV~b2L0a!y`02S;OTTUa8?*G|Y+G zD%}S(yj#QjH2jK&f2HA%HT=1TU7m>iSPiFYxU+`2Z=%v?u7;Ot_*MJANepJIh z(eTR}KB{3KzBZ|JTWPq9hI?yxpoTBg@DvT-qTvj5UP^wphA+|Zr5c{3;VKQ+YIvQ7 z>ovSh!_RB@h=zZy;ooZb3k_o~U|8oi8t$m!o*K^A@JJ0$(eP{y*JyZ^hHusI_ci>b zhCLYEsq*Arr3$BNI8(#DG@P&D$r|QfoJ!7W4X-7}wMugfu)2@jr_pz6_yDo&=YOuz zUjt^`RLJ>6qyJIEQJ4g#(&|7g<#g8Q-GC`4A9C_Eo*^2ZLM$H_OEmgCV!oMzS+4Qi zuHj9@GQSUN_#F+u4@@0+-~I#XGA$P#X%%imEcI_sEM;~8W?bIi^ECcTH2#sqys^W~ z(C{LS{~8UiCYEWf)9CdY-byTW*al1;c#nEq+|mvLA=G!&sQ*u$7bpy(kDXK1*)hI2H0v4#g|c&LVlYk0DTIZjjQ z&eZT64fCCa;<-x0t2Mkv!|OGChlane;RX#qqT$Ci{EUX1H2iZ7zoy|gHT-K0f285x zYWNQt{*#6|K2-TNaXl!^v7*8)HJqg36b*9>srWl;nBz%B=lUjv`OZRNF1k^8q=v_6 zc(R5s*YHdY&(Sc)qDp49hOg2v-;F4qTQ$5~|57(*Vzl&@O( zJg)j!Te~g*!*TUK4Y%$vozJ97ezJynzgP62hSN37XLiMttKmEi_tWrc)UVQ$??YN4 zKQw%ALX07}VM)yVv3^OXE_@$C%y(maw?do`%x5LyLBO3QE(GRt6X_#?x#o;`G%%l` zh{pmCk$3{|D2b;6vkj1E2Jj4t%YiE-=KC|gyCKhF;H46CTyeF;?1NWJd@C^DzmWev z;M*jA0+{WDbdD>&FY(jBTO{5K%y*9DX#(CU@d4n+Bt8iIq{QrBx%QC!ZvpdNB=Nhz zhb8_1_?HrY0{phbp8~%x@oC`SNc;uxX^HUx!Qe9>W%6ubKPrtlp7klQ4V)@*GH@q} z`R+Gc;t=q~5_bR|DscwzXo5 zo)t&D6&C9p1il}*oy6>eGbP>yoFnnm!2KlN2Ru|_u2LN>@d4ne67xEnCGip9g%TeH zUMexaiCif$->=Y^?69R#n0>P9CzCatu3`4Qiidry!tDDL9#8lI$KUXzNS*Pg<>XDQ5UOyN5;+^At*Gm3}b5ftXNq3~f1zop@iHGEpby!orR z0b*Rwe~$@*8AU0+wJ}~UEUy=3l(-ZSi1TH@>zRhZ>!BSi<1>ucAD`oNd6VEj4tccRW%N4M?yu*-}!vJYi7@uEtc{M1|?Re)x zd3fazmNyqz#Q`*2$V3;&R7Qne1A@W~>xyUo_f+P!F!pD9x~X~C?-&H8%i*%h$1PeM zK%*t56$A;SQE9QPba@BS*`|X=d3+zB?eGdF*Q`kFSoD zJkhtpugp@&<8}$kD0x2uL6^6(KiUEKD37m2l)NTj#>s-E`5YI*+vmt*_|IT>RUANL z9OUuagEA`YcOdBUHbWlyD6g#yqdb zKQ!@X@(MEz<0jCQQS#*8&~k~&!XDYVy>ol_>6x3C6Abq1*)ypAv$L{#b604%IdEXU zdmpOyx^G)w9hO_b0x<{9n6)(fH#VTaVZ@jlJ?$v!+fuHYm?R6jW z{3iYl^UIJE(k({pJGDh_8C6vp?a)WYth;IX+=IiK#lLN@Yp3Us`~3JU_ix)js5io# z{e4D@Z_Cu0?TV{!6#ZrtGRqtP<|hCq2h*hvC46wP+V{s3b=*X0xT3hE4(BHwL^K?S z)CN&-eo{9&e(z66^hYhE$YEf2S!f1^=M18_0+$p1ma*fmC7;Ke3>MF;jM|A5Zw&%H zGtI8RK974ipWmVuFv194+G4jM_efF=e*yk@jYabh8=rcj9s*;G-#v^i+j@pV; z_~A!0wZqTN2vj@#>?6C_`A6>XBW71%IdwZQ`T4lF23Dw!ggAWyJN)oT-r_4kwZqQ| zN|!tQd_cO~;pcL6H)@BUpF>l%!w(;O)eb*=1W-HtTtqo?ho2zh4q&AOjX0JRcla5A zh}N}8-djW{Ca)Ua;lwNBb0}#9b;f&azRmNFqQ`?Bexl*>d0%7%JN$55jvapZ7~z!I zctXRfqXKe=A7T${l`!(B6KN>8l-nE@GlrnG<}-gMB*U@!NMtJOP`}zu_Hz zE@T3=CU=FgZH`{TJN%qs9JRv_pOdk}PXpM(JN#@#=bmog!;m`jF?cdWW=VztB1k03A3TEpa@%D{iJ#b<2qURG18 z#b*}pKDMf$^(66gT=SW3-9erg9t6&`4zeTWhExOCRH3?eIhSYKI?c*?fne zV@&tR@4!FUYRkB%uf0of0EIi$r7KOLca0$&?& zho4ahw?*&QL14q~$qcIIcCU9)P9e(bifG5ayiNJ>42BNXU z4+DJmFnaRMp5PAH^T;;HEQSX={E)U2Oj6y15Q>vK{QRC0`6>iE{D>ae{weE8?eH@R zIm8Y>4Ds84Aloz%g**I^m~b(Y_!3jGCu>M z1$Q*XSN#k8=rQj_qEQALs9~jrvBxR^kJ{nKa|r@`W$z(w+m(U_YlA%&@rqSz3ull~}?{x~Q7 zaeDgWo%Gv_986#i%<&zDBjRd^3Qhu`%pO9EDbT`5s{&1FMSZ4Xn;>e8Fe9Ats1t~XM`TuWI6@6ol zX8VPtG~c;|`>V(!MYwYb-dKhY2Z8qjSfhPpPZ6?kLlx9Uw%FArr0t`UrULN61W<0e zf(=!qF4*G5*$*TmOp^PC@cVej^EVSg+RpO@Hq_u_h8VUtJBuU_R5ma$&{+!W?BoF; zOe+4-ieThL2t+Pr<{;2zaIE!r?3=*lstffA_NR@`Y8ErC6=`A6*^(f8)CFZ#cQ; zTUT!XvrD%B_Db!gvf*+~_qnUK|JFk7^H*o9ol_u5EjkWrYqbCGUwHlPtIS15)g!WV z%-^>}``g!L|C^3@!o9BKZ>;a0fBv%WVV6w^4ho7rf`Z*DxwXWM()shNgWYBayN!ZF zTfSgnH?ivt*Qo#V3%b8;759Ji6l7ZtGwAYhLK$_S6GvAZozT4iHVu}892zdD=I|y6 zOP)!vibsuL@KAt{0RQA7*je*SyZ_HQ>S;ccD#Fi}b z!II82i7lD#2+|>+*W73gk0pj2{KVWYC4au8Q%7PYAMjst<`%jFA*U-`TGNX^m@HWJ zJv$ee^W<1>eKd?09fm2Jc!1c#9}K@qDJ<58NjkscD4F8>9y=eH5Ud#^pwWX^^0O@| z++V{iPes2}!z@EZpRD04G+d!!KG!M!RT^HS;SCzTU&FgJ{ECKurQwe>d|Jb2H5|Yt zt8{3i;R`g}MZ*Oe<~%PIm-BQLzEQ)sYq&wf4{7+v8h%d0Ki4qlb1C_p|ElmGHO!ld zqPNg+8x3b@I7h>yH9Sqje2P{wYc#x4!@D&6jD`omMx!#~vU(;7aY;a_O@Jq`a!!*2Ai zO8+S3IJBmgVyy z`s7v;|5jpj0b*@G=}_JHtE5v$H)y1D%!9X20tbO(CGH5^T4L&$B5@9INMeo+I!Syn zFuyNS=3wBS67wa09}N$dcm(K|N_-jc7>PMXnkeyf;L9a02Uhdi=L64{^eSK)wZ2`) z0n))o!+a{7u3>%5gK14+oYjM)MQL3I8*UrY|fnqwnGy z3?3B+&}f3qhgC-D$2owyeuFVUydE^_hpr{8Uoo&QkDlAuh^0|sW8l~29e_MP1W_K@ z8OHJ}gH>?=joUEx{9Gd_xa1tZ>k)Y%BS@q87QwHldpL-?1C8l2J(cbaz$y-)u^)j! z0%=s(O89koSs{Gq0*&(cM5yG|1FJZI#tF!q?;>)H3cCYdUEX-e<2QfGV}GLL-4Dz- zybfr_qSIP}d#N%EqunK4#rGl_bAe)#VdQ%fmi4HN9}fe0$^(}?G(Uq?nErh5v7ITS z!uErp=VMx$Q@+dxpEFcGjsdGUfJPw#rxQq{!d`=4mp2FUrh`U#+?7emr;%DJq_c~Lub$Cw!(fvC(fSz^w(!O|K~i@yTDkT*7D5u z)SFfroNt$nty$j7nL;-(DQAiacl8u+&J-63dvd0@S5NT)f_Vcb+fMPU9bP|W&wFaN zUbmS37S3{1=S<>;=un)x{kC~_j^DeLM1RyYIPP??%k%XXAyl5P zmqJE$zTW5L;}i(zd_6DcwQGm!v1vz*WpX3FPsk-Uo{^+FCqf+sh~}R-RPQ!0@=(36 zL9jTLLLI8tjrg($K*phZd}Q#9dYh4!P@Fnc?`AN06GJ3<#OZx4I5`Yc?yiDkUBS>E zgw3Yh#gQxz)mw-_HRWzwm@cQ>twJCV)#HRDKj-yvx}Q)TFI2dS2vhE2puff5OHH}s zN**=k?f~g>${k1bYRVnw38^V}wZ#3IN54MmerIy&LR#^x%(x8IpuCR zQ!axR-XcOZ<&Jn|{9;NPL7g$>jt}PEQS@-ioeg&im_$Y}<&Mh+Fy-zpI8KR;Cp4^6 zRA2&?@mO;yq4*xq{nn$z6L$l1${i*7cjAv$ij4I<1`np(v2a>E2sxN?_YSc2ETnmB z2%Wb-ktug0KuSo4)|_&8AzXV9v!JHjQE5!Mo9=@)_OXb^Z;MHXPDsG!qhff)aNc*@-$=uwC2 z^`z%kkxs51K;AIr?s>$?voVW+Q|?}dr=QKGU6^u5b@FXaj>42X9;7wcITNqmWU&|8 z=(r3Vs>gC2VSh%?JtlYmIA*^}&%L4yKCs2Cj|TH22>95}rszf?np5sRgtx_W$QGvD zO+|9flsi%C-!kRS%Ph!4^%|*KvqSZsg1k7Zn#n(vf&XMHo(b+{HKke~lD>}>6tuX! z+56lYq?v9lC(jE!>?hOeMVSZQ0Pbpa!N2#VKjL3axubkF<&Ii5pK|vMckAYfB!g*GBn~i$|C(96|&25+27Nr`%0JxGj3W4gwo?5;Lr( z+^uJn4AGD{<&Lc@)L#$fIpyvzl*qmbQ|?5MZ2y4uq^8^rKvps3jv;>g3QC+NqHxL`i3wLCeNMT% z2Myllsz^+^V=WmrUln1>9TW1{H{%~u?&t~F*%VqXJhr``ab}D7srK#ks3~{jsYr!j z%e1eifVskxWe;M=JmJZ+`S^k{(%-w^c)0;k{M zNJfxj#ia2zyz*5Gcvl2+5+1fV!oSDw>57y+9?wYR4Zck%x3>4;&v$_H@Mt(dFgIU~ zVL=LJ&&9Lp((wJB7{Ja$NIQI9Fl`2fK)rzBQ=5?olGL8#xb2_^%_(Lf{CsZR>-aG{ z4JproP~VG8Sq)3f&5RJb9HDO$Ob2iQ7-@V+@Xg{yL=j0{;Wg66QNYU-@JkZKbw-5z zUV{G)mB<>Vu!&53#}u~zJr^tiO-nl$EHZ7ZsQGbODcYPhJOZRTr&sagP&;j^8bU5m z$6~dQOic@FGuC(@n4G4T7M_zPP9k$As&)95IccL&wU}~7M+|YB%}HZB{hJJY3L5N4 zz`ro5_(w~Dk*yu5T=<Qy-#2{?4=w+D@DH}aukKM@xoB49 z5_R&BGgqxdo~V%1J*Rt?3KEAYr~{9Tneut>A3F92qRyG7)`}C+1e!hHlI>fi76HfajbxI)`Q%0UmZUZId$Y;cG}3f^T+W0r5kxa(<)7bvsoV)g~nvwRm=8b8`y8JgzAv^yl zkjTuj|L9z?OnFbIi~D)lsJUVsXmE%?mxlAh)S#7gHC*7}^MCrBFkE4?XI0C2Ue4UJ z`4tOh8FC&PwxTz>&sbPliG!4k?#|7)d&PqCg^`(I-#tyNSs5CqIGrPGup~B&3I6BJ z5wp+HPtOhYkv@jjl0I^b|&Vesl*U=EIh60@E2+ZlQI zXqGE6<6R^%#rBn$GB9Qm^SU^M=2Rxe<XUJXB}VewEW^?6pKi?vFU{-#Dhp<%wnReFA{VGHd=(UUctuHh^V^Tn>>pQ>Sg z%UASj4cBV;W(_~B;TJXhnubqk_>US!*Aq^wg@)T|m@93SKDip^ns`OOOv6((yhOwN zc%=Am)9_{u@6hlQ8s=MR6_@+fD9nA@6#hiRf7Y-E9fsnG*YE`z=2ioWr$oc^G<=zlLAa@No@)reXH4O6QguPSJ3thI?svpoT|jc$$VQ zG`v*9*J*gYhEHnv&l>((!)|{>=N81c#%SV!RiB?uIxJ0Rji;OBL6bEGXgq_7dGmxR z*67oSrTqCCzJ^%#T{mj3K#Q8EHH3?_d15+N$R>`A2lusJX zvyKz~XBZ8~MXZPK;u{Pe6$j9G9yXsq8m3Eg?!2qR(C>QCsUI%uuzq5E1-~-*5H9x6 zSALb&7!W8sUj~dvg`Ppfr994cVHnG=3|7SfG=7J`{Te~RCFk(%#zi)P5u{Oki{RJO z9o^p98=vViJ(cbaz$y-)fitL$Ab~V0Y$g1R<;BS`>iICNiUVjAkmw?Ej0$@IUR_>l&{-2gd3;P@7^CiiWgMnOQvl^J!+lX1 zhS5GJUB!1Bz5^5}CK*P)gRpED${Yq?p7OvY56!P(6{g>BJMEU3MulTR zu7j^3H7JoQ63xW^(#*AEs2?6HxmQ^&=7`kBb|U6oN;fA5pk(=h7UqiqrGpmEc;LoY z2RwFQ`pua)?H};fiiXh%gI@!WZWxCqJzqFRD%_?s4z@{K>EPq%#B-?s`~Tlt0=-Ld zS%z=B|fxxh>E?+Qf7 z(U;brJbrrg?^d5Y`S~ZGjy}8kc+=;9IrC-w$)?Z0h&g`z^vRQ_-+brzXHCaq4j=yf z4f9z1;ghG2nJ53+bo_Akn`ciR&IXThHvahUgTINn^ufCx+qudAR>e@f+!(z2z?mC+ zdy0mk>)+&0eBpDGlXnJ~Mp6jh@kwn_FXF4$npUcQ| zCBDWaj6>dT0n9TDnMI|A8!L`fl_pGHoD<3@w$0QSC-og0i`o`-DT*oTTexwLXY)ga zcA#}pih%|_WJ}S7YQAFO#(;OSr*QF6j~TEhEiQ6rm5S@1yF5jT>j(1fe)L*dj>oMOOt%9jKcUlvv2Oehkie-L+Yf`fe*Lb`dq85 z!A(X?{^-UH%x?LX=??~nx{a+5{ccWa)`Lw(+k9i&7AFCS3?x6b+v>TxG-;pE)1iMG z9vQRKeYtf$&!L!IzY6Bx7aaX~&x!0mz7vwM!;R_-g?f2QI{z*~2uV_vrtg)xEX`coY< zlYG2q9_ctJCSVtx>NqaRhi*8KSaE7wQsIhsSBx1MwWgIp*1Uqg7o`j;8Z&21!0z*I z{?Ku20?_g5FV`NKe5(H4`Z1~Lt4kBsL>X6~4kQG8Mei1k>2oSIy$m!L>SgV_YsZX4 zjuP@V27DC>fuXnnmM5Gnk55^)BB5%(y=?c%Jqf|BvPgHh^EPf8ljrWUFYx|dkGb~0 zZX|kpOxC%8(OJ3qJ$KDn!1HRlIelAj(T`<{DHAGVuCcPRLpKjDe(kT@OZP0E zzCXC=mon5BkJ)zxfsE-{)1P?_Lb9gk<`3QFBy_-Y%+AUUImwhd`wxcAV#)-E zOu6O7*L_VbR)-Q3=XmCnE|(XRuEo(Q?oDH!S)2Fni3FGLdq!cwKGBY?!8?6>qXw47 zJJKj6WkTM&`@K-AtTY}U&+7_S!$r4Mu(32gC*&P{ztsFdscK)2C`SVRD`RfD^cqj` zV;+aj96MpR#N1;Y^1ba@UD|eIX^KNz9csHVl(Ma@%Qw#CX){LU_8 zhgRU$QGjD)PgvJ-a%L>X@}j7JQ^;eu4zo6gx+SGs92^Rd&vH(F0=r0nsW6vg!f z4kvy}xm7&y`K$w_uZE%q4l%Zt+K-mDc7pD_sruQF{c5PSo?ayHcMcCu+BbS=(?#j7 zp#u!&b)VKj@cP~wvL6k#)~PIqqSDEW*Bm`-@H&lXzkDCNLMQpG*(>$F;FcI<#!-p7 z>%9naG%{xOfvnZTjFe@UTeI&f+ZYNs2|9^qRjiD}jPxQX^`Ya8^K*Bu{G-EN{XACh zv2J5nYnN}GS?S*Y)mc45%%<=4vjaoPV?%A2vpn<84hfSA0v}Ag&*dA=N%C2}c5O8-waT^-L4;?tCD~=7tm4#Z39@I3vJf}3S zth80YT{vdaBS!}t`4gG~p1Maitr}i8ynd%Ekg^tiyp!jVG5evDkXd-DZq>?#*(=MN zj&3tYFU%edkZ5jtWb~Xt)9ah2*EQ8YGJQhR+ErztxNV7}>rOp$U|T}xz1SyMjSoh~ z9N4ngqkMa|G|ml%d)$gG8$)qBU0E+R?b&khVILn%_H22UBu9@OTd0?Vk&FH@+Y)2< zx)B}SfJ5ycQ+FibJCT{TsdRRIyTzDKzWBx)Tf@CEDt6N&b5^C)r{HF_vD7MSG*^dO z1=?=TTs|mkS>x7Do~lMEqw#^JO{?y{a?zr}oB!O^zo@Qh+oXil1B;e7)je`${griV zAGvZu{VE(7(Xp`AHU3SH)UB#|F_i)J2w1yn(<9s3#6KE}fmZ8Zk`lL;#?-Camh9-d z@<3SEjiJP6>bGy%>vohs`lhR{V9yq-4!L|d&|>Tq7}iTKgR8JTVC;}efFZ51JmA?T~+^>i0l(>+xtx1Q{5xo8$$_Kf4+V~*5raY z`-b{Z#sfp~MFk_>llE;YsN0t^E2X|)>#>DKeZl3PfM@@$M%}5z?QOQTZo$+K$sre7 zqvzpmd+c!49T}`N={meO2w~5v;AcZ^ z>yCh9_kWx;Z(E{g&X}tG*_APC5{#q8#);I#{c%R!k(K4a z;$jatr+dyE-T&oTHo8D6au&Yx>~*6Cos2;AiMF1DPesj+?sw^9y^WL`D`Qp{8TdFm@1~AzEloD83J_0d>U}76e=v+@}o%L&uc#&i-|6$|{V^ zeeF&bEhy*iY%7e*N-uL>u^s%H%$xmI(Qf!LD zW%96Jk3ARhrN?jcd$#lh>^;=^8WAVX9>@f0&6^>|wqK*PRU#zWu40_)geTR0mT|5( zp8*={gc(Uw9>UOJ0C)d80A?r=mt?UyOKQHbUWsXxQpg5Q4U_#Uf7LR=x`+bv3+E2Mmn4?!B9 zmLYX(LCcnWa9`Vm#zL+ory?tAhew+Q&$o}Q zDrj{f{kct$kZxsB!xvrz&a^mr#dqMh`0r{BW1+m{#lN#c%6E|RofT5PL)6k)A?15z z2-3>8a2GUuM=bCUwmLEHtK1&M*_7P(3&t(9R#1my7D0H2I1!#j zP%>l1dhW%4;#QEEb&Z{*q#+LbA@UHjNFqFleF`C>%VdVdwS^T@yihJwenh&4*=lEU zJz>K0h!F6F%=rkn#kJf)V8dqH@}-Lg>#@f&N``1iTp`8Q73-nQ1b)Cu_VqWPqJZC$ z?Gk|vdoo1(1_+POzL6faLaLE$gUo6~#irz3@$xcaOLY@?BvzcS*yM59HXEjIvMG9G zo0Cj@Q>022h~k?nLj3k;tet5h3Rg&xJ>e=OIodbf{1N5MV)`>gdpGQdnEp(Y73;BI zLGr#?!V|EkQfRsG*!Hg(XSRr+YTrT69Fcaq{UT!eDg;}m{Zk5LK1QA08yIJLrv8cK@cFU8*=Afbb4 zczGj?DlvKQYPSGU&GaGQpy6o4++2i@4i}VxOh9wNIO(|n9_~M$$p{l+gIkb4vomk@ zs~EOIdfs7JOJvaO!kf!q8Mat@I)TuBMYZ%%i}q#94fDcLNUg&0&5~X&U};~i0^34w z_*5Xbm1=*bVRmEcSBbC+!|cxV>O~Ne5Wb(o7kUs(7sVS!8djJt1CI5uNSrm!9c*ao zcZpV`23+Rmukn580OTZa+_YcmQ_$d0EnT1bGiOQpmf^#sCaNgO7*3%iwKaiCl@m4}=f7 z622UK*lb^|!fq8l6?QpZum+cg#XL>#`>0GO<{5Z1Q6KNw$dGGsa_5y%jn`U0&-f$9*!@;HPKLE$`TC6k_^G`r~ThOMO z*@}4q0^UHtUq!$)S2Yrv>Z%DRcQwMlM0k5-Db1Yb*|4eB*PP=fa8SvM1;_;lxx*Am|Dfc!#*yz@D$=JGj)XW=LmO0b_cDMU01qlfHVZ}cre zdPmu?xbADg!9M9@M-P$RDME(Py%AxfkU~pb5ozY-W)|{m_C;o!rLjkH@hWP@r4`y6 zl4r8RL>DPRgqZuoRaBFpXbId(V-^;-4x+IuWl#@F+COuVqA`qEzH2gt5fh;@S^aybRlf zu-lPfUlFF1jAW2K7UPZ<;i{YufyxFm)1iu1&BeUT?hTG4p; z&*;gmC;hWHxMv2OmD{=7kwVlBCi^yL;4Q{NIq~RTqi!+jVS9Iis7Mm;^Wx9Q*+gxw z7fkGB9Ht>)GIBWOII2zrv7gg}1~SE)L=d~UNUF|QFo)f7)LIeFE=UV^REuT&n?(*; zi%H}+a@vr3tBA!$sl{>>sz&!5wMK;VVm&9^NxJ7v5EU&Re|UX4&p~H#r*g`w*I%gF zZ9;|?UucC_3}!~l1k2qrr6tc9iA%z*I&vC|`;bhosuzShN- ziE%<|3qzg2g5i31gfXO3n{yVuU(kHfyM8DOiadyg?;>7Nf(u?QY)8dpLwuUH-n~P3 zk-Io}#W@$|&Vg;HM!I(L3nXM{-ekk*sHF~XCoMU6Gqq*+@OF-PF-VDVH1o!z5nTum zPn!{*u4;9Dx5xti?n-g0)FZMyKP!ZS%a*C)G@k)DN(PO;d48Nl`#r-%Z6$whn24M^ ze7$s1Q3B-&gDc;_;(j{fX-PZ=IYId6^fJ>JM`wqCQ|au6bsJUl8wePSr_hXRfJYcy zNn*v8X^h7#H8GXdWmLzd06R&H7i{>;h2`rP)42R{IE!Ju#(b zB@%p2kf+i)2@x+q~)hJkaD6q6}+T4Dis3> zlZJn%N+SbbwmqVq>s5nInNiKa1;&M=Ip5dKW<2mn5I3C|4xd^Qsv z6|*9nV?Um(>7Yt2|}=@F^SG-MJJdb=#%MuuIL0`ICMJM7{m+t z1bMKKLua_66I>?flj+EuY}RwKxmL@`=314L{!o*vq&IQMgzUYupXoOQGWwbCb9wE-Ej5@IG#?EfW@qH zZp()bn$A*Kmcqku-;nqVjI&%mhfX&O){g`?G}ii38|a${8!h}nJXSW)yQmoxeRZ%% zg${R|ib!}Cz87F!Ms@?;FJWVhWsdv~W&{1DxRLl3t${wiPSClI!GA{3q-KaoKUe2O z(pm)HazR-l^{0=o8Y0r~fbT(AAM&`wNNpf~OmL_?)As~yj4B1B#YPbWi^g(&EkOX5 zMM*au7I`m(nn5A7$Xw zG=1y@A|<6-WG-6D0?}G>8t5((xM#x(xa(krK!WwKNHfy9avJzu@;${v@Ug?w7p<-z ztcXic0E@UPO?G)~(%3WRY{NIVZFYT5e+L$V_Cg-&hrp3Hjt*b*i+Urt9u}7iox`xK zLb_sya$}rodf>Pgt?N}-5tD#T&@?8~VXG5#HaM~P%NWOYwH;L_=uZKBsyqb0gGFR6 zJm%XmCL4s?6BcATtZNaMy#%WhbUIFzAy=x(pqnZs)=Y&c(8+XI@InLu_bY@5I?PHl zb%jUiB0O5hd40HRJFgO+5;d}6d+m8;FFVZbdWX4P?=ZKArFMmoTv+6T4sR|{VSO#D z@M~C?k=sC*r^Mo>NT&$aZ7iGLFam&?LtHvP6tI}i5m>=Oa9YsEy^kvS4J^3ndG0gpJ4qMoS^SVH%A{Yaa_fBz_~}jY3ooWpNSeO{v6I14*VL9Thvc6-zzvh`4sl# zyrG(6m@6uXt5C&?Q)3*RldwKx!^&D;`-W#AroAq#iH>aCD{CW-d%|BBEHX7gYg@Z(+2CdSSSi{^F3L$HN5Gf7Xs2}8 z2nAhhjk{~vDeYDvddp`E5bOlIU{Nk~WOH9x%iJtcSyOic5rg`1@=Z9kn^Xd-8x$cb zwNFtCEOFk$=rT7La2Bdj6tU8oSjFQ7#5LB8M|V3c1V3C$@URS^+oS?`VSOwE=*n_? zSii0w)~~CF!`GF#Wuf6Bfz9F;l_^^B1Ufv>R?rDpWhg54KY6f#kuE3P0aF?;8pPUF ztF9hgNW6B=8#S>z_#yi?i?xT zTC-eVOU-y-f(RjSMxB%C{6WzpqswBBE_)%%f}g;-mFVDp0M;+z|P!Iq{Rd)`k>d3~hOdL&OjHkmPp4+Gy z-N0q!zk=!qMTg$45UaA!CM$6bNTE`SRI|aP_DLA|f;f0K1 zj75R;28l&Zmu(3*2z3FFOkG&gAV&&3^8Q30RXv1?=dg*JlZHx0H55`|)&m0if;DDRQWE?iKn^pz{MKD|DP(i7xLWhf0Uz zWJsXHJR*OQtcI_NZ_6ILH|J6u_szPGJ6Ct748tAbgJ@ds!K!x%9Piu;>obaP_e{Lq zvmTf?IpwcMxrRGOReg7$`uG|HZz>MK;fo8O;YMW{4QYs*4vUM84#$dkgOl#l291ri zOyIBzA>h*>8e?NE0Uzqn*y->oPSDlk93Eu(6!(>&FRN|fV0s)Z_~~#^jg&bO;ow)s6$T!EfWy%puBgGNdG;wtW)hq$99RaYLcl2t;W+Il+|i0;I8Nt7SB!X; z!q*@?r>Tc9^@Nqypc+?%!ZzlNAB*Yah%0L%9cPGy0wK6W(2MB|7H}e+(GHc4Gw_^9 zhaD;Or?XzbadbF_avKn*22)^B?dBhA9K)cx$h+!?HT{6E$Kb2jc)sD6krsC;IozD(fxu|N^ zjP7&Lig|)NR@DQe!^56_6$@rN7@sIa3v_oh@!kU4-nwI=U1F14{x23dPW;!3f4A8D zwwAl%I@{#ppPXttTqiCz#Wh?W(;XG9kQwcfG;y-K2(4Ay>^d?8O`P2>k=%qAr@iBJ zctN`s^MxGb`i8g>T8unTp84@aN69!&4qVIuq`BPJid=Z3{ory%TOt=qODin@YUWR* z?g=9|xdrX2FrPb&B6^riLGVRrG10LiJ?iF^n)^F7L@CO0?!j_&_h4GknWa5S{Pz%f z86$AE(gdq02)TW6E5VPPOF2$isJdebn4%n<`gP0trF@-Jsx3gtDYs&PUz}F{typZyPT2{NYUI#(~06ns6whP-O$&`F+-anl#Zj{ z80aKoA|0pnoz#RjXb4VmnW7BL=$3+8FLg%>OTvs!Ixm!*E?LIJsvcOujS%DO8h%5*DE+3e5K%YTC2lzrQoa;JU%T}l;CVB z+OMh=rzBZcs=dp4LOD8`IkktLNS322L56yTET^rC{sJx5sX3?g8S836@rr*Zv{v*4 zPML~+Pv+k#&06+#C~<0bHFaoqWvTXMBXqvtvBm%YVeh=-w5qOtf1a6Vh8dnwKpq7I zbwChM%1}fks34%As3_I?Fie4oQ*dTzme_05h`k1*#u%fq#~!gpBPJSq)Wq1LvBYSM z#`1c9-+k7eSzvN~?|a|-dH=cRGtZpwS!eCF>uLL}y-z%LdP*K^EOMX9q%AU> zbz&T9iozn5n=U+1Y4M7Xi=H8!v5j@sMB2K-byB6zaZw-2qo1|;RFnVdStD9VQ``AJ zJ(gqXAwS5j#_+&kt++gGD`_Zf`fFAUo66CNErXJbWt*PIeI2JMOxtCr<=6t)n{s*% zDY7#IZDsu<2+fjE-Z5;N2FYFNa?El~kDn?)$LpuZY?|7QXe}|U4k%%!m*pRdgho3XCYS)sso*ns152tAw$K4)*rQGh??ds z7|;8}AFsfqD4d7TFHWzIX}c&5nM}(!rY#NWt_I=UpW2FNEiA_RKtG-v(iEf?;8fpR zjzxKEMd%-WFWe0N$+wa8j`W*n)p*aQVzN8o zY-rK{{>(<)J{=*Iq5RS-Q^y%yXF9bu?CK!pjG4AWj@b0*i0PyLi^KJ*C^Rr{Jzlja zxpgHN~J)>CzQX1OZl7_~HrmFCNlznlePzXRXrX3FUCp6M zZCzt~wZ2l(RMWIHX{@W)6X)V3(ra3zN8=SWg|_zUc76Zj|J`>=!dDX-mNu@^M@Cv& z4sB3mRw#=a7Kd^v6xtRyF0(9!OoT$ymnIsk7q=yahPFb@O65UM&JE2;VNv6uA%_K? zx>cS{bxk!(S0(Yo8oSyTUuu@O`!AZ**3~Qx*=`H@Zi^XLIW*Qa$F2J2>Q+2`DtxHq_UXyfgtMtgcmG#@JQOfI3)Q-PBYaltrrVy6Rf~ zx6x~GsKU2P*wS36TiMWFAie^_t=6kXjcrjAQmrh}H#=m$Wtq&@ENgAmZ+!?mHJ?!M2$4+DBhYS%ILR$Y$feyDujAUD=0LhP*kRL6X!frEWPU9dBhi@qTw)I5mS*Fljw=y((*TnU;CLL1EG7{U9s;pXPu|lDy zv97wAx@xLkxk6*ORM~uNqR>`XN1QdPP3n1hHAgE_YIv6QQWti9#XLZkL` zP`0mHTBjIjGcj#xam=0B(!5v)UR}G|d>t_-i&|P+TUO|xr0x`0#?=VP73I1jlxsNc zghs0G9%)BgZG%oRYHEd!kFTVMy#5#Jm#O4--+ON5l*+Lq#*f&(a=1psH7{1#HMUg_ zUtBqSAFcS+H@6I5w5*}AolG{THK!;W+G@!~DD948Ol97pvw3>*DlF5nsxaUD9Lr(L zT3YLL)(D3LN&g@HDhuyBSy-z_vtx;0Wx*vF71lUX576%n{aEyZC9vKp1o_1XwIGLC zqkn~dENsJ@=!YC9;)%u|YR!TU9BqDuPz!Q6+GMf?(#tl!y+vAM6R&Oh{b4+9S;~f_ zJY9_59LYD+8XcyOV8ISNMQh}|Kx07;kJK7DZ_`+i!;}m1SdPfyp(f|OF$;3|7Om08 zlO)>Y6U~@Kr=OTN80g><5z~nq1PeOwV6D;N<$WyAlf}`_DPq0Q2s#%y`GsPQ^9gdC zPgt-C_tqMlYn>d0(JILCRf%cFc`M4{R&8K^sVYc4=7I4HkI?<9$-hFazxTM45`|w32 z52wT1<0!{dUfB#fynAP19~|XN#4*hc;tAT1O*}hT(1*9s8aZ$4S&+lqYK@$C@hr&U zcx*C$JKE>%e1GjnpK;q!&a3*Eo^8b}*nwl)#+{J`IULIeH&GVkaID`0#nC>m@#D3C zF{t_rY2f8L3t?f_q>Xp|ENsKE?s(TkQ4U*`s->fJgtn-4d18{ zqt^QfT77GElfHu1TGv=@pF&H&dX|17t$NX-*1F~E?baREdfV0i;>&9PLiFGMu{9M6 zwGx-?f8l#;p=4!%yOJWgO!%c($1yEH6=I8>_HC;;)M?y@!v*cGb14qjJHOp&32AY# z?)P)P>RgILyZ76iw>lSfrF3qH*8jR1+nn<{m*VxlM8N*d!`(vE;OO8C8yB{>jvHFD z%^5N-Y;%Oih3zSELu zsns{EtW{5!^cve!GtG7Bda-TSHY`trEw&x5EAAUzQ1;{=ztm?BjcJ!g>`_WPEIOZB zLlWE5uC2m1AAdWZ)~$m|>Y?9AH<#+Cq;S%+Ze&$?hkOXE!D&Qx>CtkJei<&KTGr|p!_q!8OsAyfQT;O9wrQcAX2`UbC-uuz>YtWp^ow!5 z09WdtmY4O5@>dVN3r+*zz?Aw!BPrI@4iG z&rI0jo#mLP-c0{AzYE~Xln;U}4GUpQLoIA}mcW*tM%dEB0M?kEcG%kIO4!04>Ey@2 zL(_OqfVmCRatgd%%BRED=Ff6E=fW2DLMOiz9+rl^93GzXRgSNL?fAM59+B$Y==fI0 zcR2lfV6(XvwzmBcJTkTOsMA>oTU<}VRjJN1PW}RHd3+f*`>#5kH(*QW+m7FJ{GsE& zJN^tdn_t55a<1FG7;n}wPWDk=;rKKqox!I+(E0-7E3{r?e4f_t8*_d6+&J{eC|<&H zEEeGI>2+kW$(yxaYVy2vnC1{2n%VKjWn$U}a+>Iw#+-L=GOiR;cjychYah>r*F_XEWGf8}y@l-fjU45z!-@l%f9 zbo_;J7ZvVA{m2XPGNB^8Kupg~WaeF=+|JYb8siVOz74jpjKPcg&zR2pTK|X150cG{ z9#ha+DDH1uD;{XPM7%SsxERQ`oAErY_jcR}%TA;8Ta1^AR~omAaok5|rI>jh;UmSj z8XqHm99CTP$k4lk4(0Hg@d@HLjZYEpSDNaOm$}9Z#fKY{m!piy%UMo-j+0*nD_)%J zxnCe&;>sEmSCx~Gaq>f8g~j2X9wx#PZ>=%$9%ec?>z`qA^7V6L%H$?v%H+4EPtU^a zveZ6Lk_Q{(fZt?{+dTv9NCQ1bKQKn09;29^3yhb@{^iD%;wy~@iWzl{9YzNH+V~l* zUo@sy=pAFaAs9!3J_AQCG^S_g_pr*LpKQKnoEJ0l3w?TO-ZrL(dVT=HB1_*p%OpnG!`XOgzC=T&4?19ES`PVu5<;INRzSo$c2#i1>EIkg4{DB!$ z&`;rEdI|;`PtvSnErT&(QiR7-L%CoLzUW6%#Mlh1ZR5)%sm0|HSw!t-m(@P;31335%Qm09f`< zmmJOw5@;D`I&-w1ZaQa44(GNBD#<+4p_hNTF+KYy8K0~51;*S{Tx3iy$=$HxJy)jS z_-*X_O^0hZ*Lu>)HRpH6gnbKE*b5aF&J9k}6X$o}Z9yOX2+JD+u07~eu5ixo?F%Nq zTyi+qJGFDD$tiC*XZKwzOn!~zaL(@8jyL&rlEXQ>-}`~dZ8zCw9MkZE$sdv&&e`+DC&=~V+9&UjVE<9+ zz&X1gu0Spw-k^*y<_*dOW8Ru9FO2cI;!!wYL_Q%_n6C z&Q)SDeRD!s-kO|XI?qTB$9m*CjSg>Ft}vY!qytAgj8sR5w9C5L0%J{Gys!}b46)A>v~a6Im=F!`5~!?7Ly z9J#`BPjQnmJ@pU3iYw7M0FHTo)O6_a|GhD9kKQ)@tn}enM<1D-b2S{(Q=u@}uaF#$ z$0GxHk$0CIj%6~$AXlIJadrJ<-bk0Doe9_~)z;yaa2aaJEnY>bRIEGz(m7CJ;aErKn|z4maFpL@@?nz0QU18et0aeGIXq|bv692F9Nsed zc*)_I7e+CXPVT3=>qpuqN(YYZWJ{Azk{ph0U?6gZ-B#>BBLu-AvB) z3XbJA6S?eAKJ$$Ej`se>^ztu;Wpk#&!m%8VF&*B_ogDSGKF!ImFy_tTHI5mxOT4_1 zx&xN|S+WmD`wy6$Yc8DYuePma9dd=`o{DL|3A;c#aBRbGoBSZj;aEou5=Vcb?dc@P3yiscKG>MIrv>BFwO#_t z<_WS1=eA94E;soplEXP}B(U*LT*={>eg;|- zmbbQ#n9haLfn(U;nGSDrnIRl~_>Yd?bo`YuZ+yGzM|v)mO*l6!&CBMlgH_ZhW}bD~x$=Jswti-cY=7Y$xZK&Xro9Z#r*F z2aY=IBkX&U!%=>V$v>1Fj`By4D{U-{vxj+${}C)Zf0sTS^|LykBL7TsIF=Q&X(0bn zayXV%9=UAt{NBr$XYf8wKEQZettT5-YCYSSXY+-y>?g7X$F{+o)7a-czr>g~{f9bk zg%y_mS~!M1(&Y5r!cl&{$?3<1qx^d0lHIH|OHZy9T9Yg|uQk7nn1#p7jPzM}wBwr_ zEdBM1JOq~hFs=E;uvM_>k3~mZp|ai4v2L%DjLs1(s-h&r3veyGnT|~NL1Z3lqfH(u zV;V?LW@G)+LVBY9aK{rIPjzL<|n8&QjG&1uVMDFK!sAKv`q7E~TN8a7>A&%)Qi8}O|MCMu*nQKX8&f}3e|3>Cq z8JY7@WRCO59Fvj5y9sL#^p8aO7LK=dOuv292{SlY*nOP5$?+=3Cpup3_%g>&IDXOb zn~v$Lk7+2;^MB+`9B<`#nByHC@8)>6T4Nx_@H%p5yO3J`1*Ehv%}W{}ad8IUSy*qYlqsk)Lw>N5>yH z{?c(y&l)joZ^zp>9_x5V*z!0Jwlr5ed7U_3XAehic|XPR8L)-Dz{xLl@~fTvXHI^n z<7XYe@ASWL+*{Z7n1(@)w}mYYW1W0QC!gZv)17=jC!g=+)lS~*_(;b*E5-C&;P_J5 z(!;E6QRin)ew&j&==dqeJp073?>qhoHv3;XIl57vgRQ=HbiA|EneOCs9WQdsJEUl5 z8Eo+~H+7Vs>G(3o*E+t#@xzXvcKiZt_WuZ5`+UR6-*s}HZKD3CPX48n7wbka+9`w0 zem5uY>$uYC@Qf3~4s&vzaiToT&u#a=dmvZbEc-Z}*F^&&#yxj5mj<0q6 zkmJ`Kf9<%h>Mh3g9mo4Ru5)~n<0~9L>i9j!pE&NL2bdVw_Kpv9e5B(G9rF#f7|kEAMfm{7Lmdxy9G~eVO2#|+WXIDS&v$&F<3*0^9XC5}b$qPj6CI!K_$-c`h>l{Dn_>YcXcl;N}A2|NXaYpBzn9efCJU>S{^Vdc0 z<#@2;?Ho^VytCtJj%PULU3s*BfMY&x8Rbom+a0fTe6r*3JHFI0eWTIlPaOZu@x6|D z=N|Q+cKp2KcO1X(nEss@mcE$CT^#ex5gYQ zp6hsj$M~2{X7hag2Xj)VbC1-Hv(hA9eU%Y2>FJ z|K9N*9KYrGFOGTdAMO0pahaY&qn!8tk$XDk^T<(--$3L+j(G-;az5!C8J~g3J3F4{ zc!p!Xr5g2_`Z+Q_29aAF^Rd+^=lMPInU2qPe2L>Vj<0rnt>ar9-|qOAjvsLRxZ~eC ze$nwOj^A*M-$P74UyY6YmE)`~LQ!7kxQF9S9dGG)fa5WacW}J3<6Rx^=@>tXn1*?d z4{%)Lc(G%?b`it2IzGbj(T-1Ye468P9P`QUX!D1TuW-!B*Qj%Y<6k(w%khJbf93c$ zj(_L)CC7hsjBiJb_dUmaz&FY>>H~>f?wJ0TD9=0Y?YO^VeTc0?f0$$ZI-;E&9n)76 z<@ka|-or895{_~{6&@MikI3J3yuvXb{^*@%J5H;&_c?`q^S!H#xrFF@CgB=UK-uI{vfc zcO5fJb`1NKm=1O~)TN{>bq^9e?FG zt3JJGv&?Z1$Mj)Fovj@YcD$40$&P0@#^)s3nd^9e$BP`-J8p7Jzi70x$}#>cQGSx+ z(;TmMe4gVUI=;g3O^$DK{7c6VIDX7Ael0OQ_Uaysd~PI$#YZRdFvnvY<9icz@V$vV)$yK=_i>DWPSiihagF1}j+Z)a zcYKs%z7!E{(pMZAU!TZ)3n}u2j@LN8(lP!+Q6ImZ$hSMjhbPJ(a{Q=c{C1+wOOEm9 zkMg%1|JCuwjz4$&AC9}IKQ`LQInFz#A3N&c^Anjq?a1RCPjE~>cGTJ3F+M_3KF9IF zj_K2mI^T6n|8|tGaD0U0(;c7Xn11gV_7cZeImTZo>fGq~R>yZczR&Taj@LQHUntsq z-tiwCzvh@(F{1uo9sk4e=Z@*4jrt{yH+H;uWcMdV`~D z@{W%2i;D8y9Pi~ApQxyFfMa~5qMY{#k@2I7ywoxNR8fAE<6|A4=J-s<7dXDe@fD7* zc6@_l{HbER_c+E^FUp^C{H$Z%Yeb#b9KYlEeaHWB%=o4lmao%9?&7$+V|=lq&K8dQ zJH`hq>Wpx_i{mMd_jJ6EG*8N7d!r;5k8Ge39eJ9AEADTE}-gzR&Tm96#>(X~)ky z{)6M!9KYlEeaBxq#?dpDZJFZ=$M~5>o!*YOa=f+U(T>MC-pTP~$9p*5+wok-`#WCf zxYlu#5k8Ge39eJ9P=(dmhCl;Z*qK_<9i&hb^Ms)CmcWH_yx!BIDX&pmyVet zE~c%E*c!@kGay98Y&V)A4M_^BpgCe5m6#$15Bk?f7`d-*@~2 z$LBk~*zpyPuXcRBG)p94>^9+@sp09ar~0wKRSNP@n0PO&G9FWzjVwLY#sIP zIOlj1$D29c!f}7cLmUrtJjU@3j(2mshvWSm&vSf;<3)}e95*>$=6IFkV;rC0_;kl- zIbP%VO2;=izQyrUd+vy&U&- zJkaqF$DlXcrVBE93SAg+HsxZX2-3LS2;e)@d=JkalG2`d5$l2e7WPF zI=_r_%p{}Ixf~Ame>ZmIPUH^@3^ny ztsHOTcw5J#9B=P3)buNFz*ViSA${hFPJ1T?+UE0%;YFzb)AHHSCH#c5#|Jg8E?nDD=<^CoM+5f zw@ZvG#XmA0ApV*0cH-NN$BOaA!VbQfj~VYQe%g4l_!Z+R;y)YjCH|Z7Eb$k{jE7@P z6E>U0-HZJk>@v}nz4)Gbr4~m%)ANeC<#!11CiGOCiPJEm3Q{wxKpAkQ7 z{JI#wDZ;)bW?nV;9q~)XABz8E{E_%w+Ic(8S{tV6mon*`x^Ha_c!LN%fpPBO9>w;^ee^8GXpcX(k{m1#nX)O8^wnTor&Uo zjqxF!Z@ioMVB@{T_)wugN8Dh%zqrNtK=Cr;gT?qzq0bzF#~L&4@ML4=2|UA?IRf#a zLjP#-MaIX9uQF!tK>ViAIYoSv@wwvLjqyLd*Z4{?epBdQEq=`Sr{dolGf&jB#t(|| zn?j#4j(;+KT>NKa#*Z@x4m!*S^|A5G;(r={ApY9;V{wU2Bctly``jNSaom~$I`Q0Vj!>lv1$edD{t9~-X~E#T@w~V*Ik;N5wsi*NJ-> z|3G4qe%yM>%V{w>B_PnH>X5#z6g&PL*6jW-uFUl8(sV&;m3@yR{M7@ypWjE9TY z7>^a>uZ8|NG4lw)TxXbD5@v2u{I%d2;(Lu}iXSxINBo%aeqwyL(61IhYg{XS$r%4! ze7ewCF8;IeD)IZq_~CwRe7g8QjF~g7L^pzjJx`o7zEF%G7xL@Gy^Mb@-op4sF+N@B z+$J7s{HS=O@#Es{jhO@WJH{`H@%19?%VOpif?pNm>jl3iW=fvmr}0tZ`;56(JZ#K7tdASxGy9Y=bEZ9S%sKuQ0v(AV%?0x%zvhDRR$g*?qJGCW!kQUGP5QvyJx^Uu4YOV)%5SQ!W0n@nK@d0wc%Y^B2b7 z6W?omy!b(5&KZvxbDsFE@g-u$4rAvs@vFw1C*Cz?KH5)=9~FOT%)Da7^7$d`b7Fn> zGcfbSb~9$quuY9W7xy)0&MiRi`N>j7600p{gq z+4v7)#y(>c-^`DVId=bP{FeA@|q z#6yiY7UR2xPIvM4#+!)0W1JV`yM+$p?{_!eT)dYt^QFx;-cG!~F~@zuc%-<_c#8N? zV~+L1jHip4dy2R??vFCwTYS9nEb*zvv&BC!o-01j_&_m!T-Ygye`LH!{1apRJ+C)D zQhbZ?_r&;g5tj48ea5GWA2#OP@VN00#Q1cfzgqmfF@B)07&Cv{>&BOf@##Vz-_O4q zbDsFbnE3;~Fuq%yQHKlqzZB!s1v8%;b1B15ihCL}m)n-coIeH`Gsp9G#`uJeGJadU zgYjR)I~l(xo?`rgc!u#uV#a_IFXtZoxZuykwZ>nI83T^Ir`qpf#{I<1e}$ZL48B|N zK=JX$L&c{WZzpEVI69nr&NCh*#&-)j=b;}NGq>DNjG1@tdSlK>_->&;S$wDQRPlYr zyNMZxjt=uEJZ`*)7@scWGsVoE1v7u$E5@_MuN&8i@##VbU(~-EA1?mH_-OGL#`vFR z)X|0hnPPmpV0=+GGCo_})A&L$b84Y;v6!!H!B>a}8RMh6oiRSDql~W=GY>ZUcZqj3 zeoVZF@#Ersjo%Y9KQ{UwiWy%I<4;;=T&i};99+oD#D^Jo731rLyh41Gad$DkUdZt? zJ=K`=)(?#Ph|e>||MU{$LE;}74-x;wm^tw9^};4Tr?(hS6XWZJob%Rw#xukZ8!r$) zZoE|dl=0Ex=Z#Mnzh-=~7{4!Ua$fn^_%88R#>{_SCchwbo)9yi0Q|CeQ)A8teT|vZ zuD|iS;=#rriiaC>ZrH*2Gx1Kw%zcM{7xqilre+v358gh;1H^NU2a56ULZ5jc>Wzns zn~cYZ+l-k9VwEvIp7?YTc6afK#>{*7ePhlItBsix?*iik#g`f5?|G#${+>TIZV}&L z%sJyWWBfhuHf9dJ`;EUZ{+01L;wOxmC+}(FE5-PFk>;O@|7iR(@tek+C*Cu@SNyRt zex3g`en5izqTvg)5#-qhe#$&}Rj5#+PWz0N&CmT-{ zpJ~jTe&-p_6JKI{koZT&%+>c3W9I6+-ndD8i!pQe-D!Nb7+){aiC^c##y=F}>xCR2 z&!>#96yxiK{A%$l#`u1|Zp``MFUB{B|7Ogbe$0tM*jvRc8D56i5?NK&@qUE&4RP*^ zfsU&jPjo!p@f^ns9XC2&>G%Z4XF0yq@imU=$B$`S>v)~x7aYIgm_GLymbtkj)1MwW z@0fn@C?DpSe()%t>UfspgB&k$%zOwj>@ki{cYLAaFrS|4jwQ^eXMB&-p|3gGe8%ys zj^A@k-*MCr^XZvQ`hugJ{@=($9FKK8$uV;jMEwPhYaK6je5B)39G~m>a>v&>zQgfD zj-Pb=vg5ZM|J^Y!>tdQK9QSrS&@uA>ME!}5r#q%EHR>#M+~|0v;}aa8<(PiVXor5x z$n;%CrjIf*eU6doPmIiX{Ky|V{?aky?xRlLaiwG46Gffzj>Fu2DpQtOPJWQ%C63!2 zALE#Qw`iaKwaC1?iA`rxxY(qeZ5_Eb@DfKXaT_e^Auv?zo@hA&$p7p5%C@ z;{}du9WQl!q~lW@hxr4oJTG_h>m1+V_#wwnI)2$P-w23#{JY~s{XtP);kdWsfsU&j zPjo!p@f^ns9XC2&>G%Z4XF0yqF@0e%owqt(>v)~xFz2C_;Tul=q2n(dm#GgZ+Rr-< z^BVNO2Y@l?mN9MfMGZ7y+4A6b+iS}``@a!i*yJx zT0a)-d6VqpH`~@)g$4ilNye;Vx$JE`389uJkI-D>T9Xgb6U#-}3wE^%%S_q3QGTIu ziTPM40bwTT$1>+g^)u>T4|{ra?XZVWMhqiNz8s)u2$gkQ;y%(6nSGB9(tW188Iev#7wTES4*Q2M++%1!dmaut9hh0UHd`2df z2+ldoGTtw-k8EjcTy=7+&Uj_Xsvaxvf1;=%v#S3q#qVcleNvft+Qls87nWxKp9m7=091GH6~ zEoo?OPl__74tFFqz6#ofX~2s2LYkCK*FTzkIsb}DH zvf|xoXt{fk&LHw6HwoVRO8w6!*;mQLJ}>SifzgyU52 zlHn^P%Haf7G7?NSE*zSaRE2EicrTuES&q4nQm)A1qmXjlI=^CoE%R(B|D_)o-Cb`@o7xe$ajRxau4Z$$pp9}cO0>P2kxHB zz!Two?vI4s3GSU6fqZAUU#>THc7ZG9#i)qOG9}Y@Bj!&DF#}9;_$-y|0Uy(26d`7k z<|NaD$-heWVI!MK%DQWfi%rPLR>?-6O6T;F+2=@RdZ8{}5qL$=s!lA^CZ1 zoEE|i%YRLzXM~Na{PyfQGsH7C{}=Y0m07DWBfwMqFOvvFSL zdF`2+rv^$c%24dn^S7{ZafWi8ng2}xOD@acHS|J$7#lwfW$;Fx$>mGdWL}qnxAUtA zb9pfRp33r1+P4vJ=9iS*GGD8W3(C~3q0~1nv?e9Dg+kxBup%k>1z46l9|N~@I;hC) zNp|jlH{Q6gs6HvV69=pAIoupd?n1wJ?oN__FV)m9hYM24{j{pe+`I6DOpG-!cNsPx z#(8T=+{)V_F<@Q7WsZXRo zHP?lBe^;X7*nQ(dqryH**y*|NWBXXUuXDS7d5{hyPoAndDrynaFMIl{j7x#S1s zxDuDVj(%;j87mq|FY?oijPwed$W@xSEa;TEud>!HOL2w(G#3{jY+3-G(|QxCTb9SV z%}$pYvhLIo^)mI_(Sa$FP924QNrG_7B*Wp@DoVHUF0=Dc$u?wbiwur7J%1xB6(#*M z^Rz!7&VE}5PV!r!H83>TY`DIZ3=HIg^ZP5Fl1Z5{M3;Y-I-im`SR37wGGsiUS#oXq(Uh}z2{p}m{qbcgTp|+C)zckz3b4%PHpCMt+ILM$}6c0 z8x{E@Nm+f^$mjc`wm5|Emmfxw zEDxodAF9I66w88-&Qr+hPml zDBTz$@s_R2>$HhqPtodRE4{W1em#|y0vvhzX9`8j^#72e_N0H&VP!=tSY?Yp&dk?3 zDOxVQZdsaZw=4-9a10Hjw3uUOYrLFFi$cAm4VkotT&Dj>QLpfi_?4_4nL!)(%oT6k zcjF$JO-j4>QlbXxJ^#)U=_+q1)$C?T@x~K!-^tDBsn~3zgpJZ(nOu%N8ExoIVy9YJ zCNrZa((?YvjGnyo@7mMp<~ntGnO4y)_!n%{GgG{Ar$N1B!jst-E|zxjyF zE`8GMp-F*F>V3hkVPD^pj&v5O5Y=-P%b|#e6St|oTRLU!-RjiiGD(ljC`C~zRGonR zPm{E$_v&4xFL3`sL*79ex=EN=VWJ}lZ9!!rOC&|pA-#RBkWjs zHq0dRS#70XQL=gtYt*xe+FFNlzpz*TB##SPad}e*Q&Doe{%0~@sJe8cE|%>iGh)QZ z&cBh(bt@Vh7LC-eW@KA?t=7rNB`r;LBO8`iH;=4ut*dKoZ)qFZ*0i*)X<5`x0~J=b z*EP3Q4<9{Z^oXjFwo%u%bX3*&;dPDmQMtXkb@A|q=9X?fZnTXKiU~ z%XhyS`|#yscO+LM7uVE$bMMHpBgT)|ex%v??@N&`ob4^uZSBhzji{lp8(V4)9kE0; zkrdijEv;)4>$IbCuC1#VtL{|5&FvjxC0MLuMTfHj>0sX^Q=BQ+Bar@Yq5t12FVcTp zeKI0dYoVcKQCm`|Z>(P2Hae-Tt6AEf6q*(_)-@N}+N;~^l0xISvDJk|%j%OtOMQJo zdkZUSmL%F+Ti4pEt>x8?%cNFlL#J&?OKW>2Peq05+S;VhTGzI$v0YCIZ4HOlk%eHT ztxo&f8WuNKH>Q?X)U>IYG%ae2k%sgng%zz0Aqg!t)s5{9O?9cZlC`p-y-IP`v@9d4 zLVHu8skVAmQdmq{np$cVkF3e2EJvHIW5CR^CWYpZ!}ORw89+8)AA|oHe=?rq@Wx(wX$Xw zsG?NijSX$efl^Sd?Pk?pOLKt|DdI_t9Q!A)%4oy+8w55&qP}A7brt+>QG~3HUQ4(=mol*=e zY0;f$p+MtKmNirJb+wf>OR5p7Fhe6wcHet$<&?^BWK|AtB39LUV_W6$#g)VN(TZPv zbIb5W%No=eRA)5AMQT}{);crU5lhHzQ$t%#XT(8NXbWv+y|Sa+LYuKBgK2Bh>)TVS z37M>EX*sk(d0$i=N}!>!E=hB>xVovSIy7;ST2b9f70ilS6?oIqRx1@^qk&pvE0ipX zPf2h`U!kqGp|+v9K|31S3NSo>O*S0Lvp{v8Ly1CXOwU&V8*1BpP zlDjr6PRpcvWk?Y9v#L&2(Oj!N?Mh->y9(jZLZePZ+Ni7JIF>;UpP(F$v{>7PxieK$ zN#`X&mxp-jc5Qg1JF#I??JPYvq&AycRG*6)59KtWoYK-8nicPg8cqxG2yR?dpDJKX zk6eY?wwA&YC5=2U-JYaVV}+V!t*tsO7HV{mE^cYnd4UF?2qg@s09sE}QbwvnnWcMI z)PyrpjIyq&u61!;bB%1IQ5V|6sUX>X%9II}Luy)E+S=M%S{jG%y?bTnM)Ts~qehI@ zWo`KOV}>stJFb4zxT^Z$wGFN9tA?g6Jao@j>I}_gbwRig7G^ZpwiPT!xSUsXqr`p!)#$-g;(&@2184=DgBNnx_nY6ZU(K4NhTC1Dt){``l@)7CY z>P3rM>z1##TSdIycD0(*;=1*XHa0ZNW@5{SJ>INj?CYps3Wj;U_n7LC}HrEe1x-fHV#HFWhRge=u%tI%? zOt^*7%{m-zWOVn9j&Xm-da_IKxo08zjGh8m=o61j=|t9Tc85*6n7z%69bgud6!v6vt;czR>Y?j&FDTtmD@lf8h8F$BcoEX<$ri z7_+rP5{fu$l?D&_Cf9;sgrl|j#W5#txIb${>^No?ndB>HG z>Hmv5jK_>T-*JuO7RN_8KH2f@jvsXVTgR_C{;T6J9qZ1$BR!irX3S$uXO&|*4WoPy z$BaFU^1~c|&++#iU+DP9j(Hal?cC=$_{i9C_o9=(<(M&aF)Rmt_M-jCNWbGoO8w2R{yLV}Eh-zr#9aSn$7y=X1ssX2PA1t}n2K-NNy< zj(2c88P<f;Hkp4tGGSsG)Ra0nT;t3R*SM%N#PKl4V;t|`co)Z09IJ{t z=0hT`m}VarFPWnJH)6V{wMxb5=KAr#WGeu6?4Zz*|PN251ynS%N@Gd6F2u7gl8Y=8e!Yf-b8JauDC>d zLnZL`n9HV0GVD=4(H`l+J~Ebt;eY2p_OVRRk92>V-c;$tFv4Juwh@<@KI-46kNIz= zOGf(C{5#S&PwefTqV3<25L@EDeYNfFO_#m1R7lw4E|-0j-y;2D7-4dNcG8C85^{7)<;?LF?fqCx7}^NSN$Pzauk(Fe*vIciTSvWL>i&3g zRI+{O-Kih-7?-c5H$HA?jSkD>`bB1&IptjScI#OSGp>heGx6+GR~mt46eptgQT2pOkUYh2`6QQm!HrC4ysLEn820 zD)IlZo`C<&6a6V}qjwxLIz2MK{kR;`tk_gBX&I)zV%=0>Tb=mszKiSY>tkBd^@m(S zwS0JAy8ci7KW6xpe(%0EZu1y+7wmuA;&sLyn;dt4_fs>+-QWAv9>?9EKehi8+3Sm5 zDXAFI_aDdVR;w&|bh6eh`5Nk#ct7tg-*aO3sU^*Cosr~@+^%8O zsTzbry<0hPRT5qQbbNi^X-2EEPrIBGp_ZFwS&c46(~HW2OnRW{WhUs6@Iu&Q!l)oE+1E?B$mwcFnQNKrCjTlvjQ*lxdFlfGjX zOrEf0!qEBS{!%$+?ZncPGAh$Wk`LH+_U?l|sVE-3YcjlxGK4Rp^3-r_lcoKrt}p-M zlwY4baMMK(Wo{n4(ZWZpqBomR((tRFKELGo{WA-Wy}rx-J@&i5`~LmYbjCzgl?PFXv#q%@Q4H$@4XFl6@upHviS|M1c+J`C|6o1_IY z>8i?mOVa#}&P+;W&mE9Ra?ISS>$7p+x{D_k4cI-oV)x8$^DSiO&bK!2b6o!(*B70d zxwp#`*;h((Z+%rf=yzW~!U-t3zBIM|MAuhx*Jo$lW_f$=t}oNbI?bGYe{UTHqwnv2 zk!obe{?A>jI>cPX&W~gwj`+&Vjj!&nSueT{?peB5m+yX8P5*i;%-u#NxiR}qRnyYLXk!cj~tDcFMlBY5D%u`}Oa! z?%CZk$y=Meq5TTE*|Vi9&Mlpo?YqOSyC=im*j2?_-FHf;*+psCol4H1mh4~sNH*y^ z_pMFd*|D0+2$5r1CU(lM`?1QVsc7AWc&EuW$KAo%iNz;nlF`#hfC8#l9JC1{_*PFYxY?irm0SeB%vec5D8HoqlR~bDg}rTY4X>|Cxy@_spIOIEu)% z93}yae1+>+WxKqtpwYRwEISE9z1i~|_ZD(KUarvcI_611E_AoaPEk?GW30+bekNg- zag@b5RceyGQsUx@7Vvaow)p0{oCf z?1eNbJ3#+l(XX6;!QGho-ny1$cQ27vj!B}jGl)FNHNt!UTqt+rzY+gFZ?N$L%*{Sr zD0kymrBt#RWv{&Vm#K{|7t7uFILzI`-jSfW8;5M=n8vE43NFi?s+}oU;NH2X(b*a9mup473tX9We^o2ojrS$yBbADh8DRPzsbmlM zm>xRO$laJU%crXnrG41Q%H6oH*40u9bs%@+p^8ZE#y`YdD6u)9+<`GMmq@d@6Ru=7UOP=rLtS~kDrwNIZULJfJlRQ-{r{cvrcC)GDZn{yHr%r57MSc)zJ}QLip64!0?#9Qc z@bdZI6ydR9PwzaP`z6PRjehx&ggGIDUu=iF@vS-q56m;irreDm*2a+hHNjjH_a>^U>UGd4elJ!fSeSD5j6Ce)I<@l)EEm}iDqxf_$5N%_(2IWO~?_Ds!F z19CT}*r(@5lj@5zl%h6lgizAks?anjYFxY?#7|eQ+H#qEZ2uD++HoN$nn+Sk~`q&ZhXJ&b(=dxqaXlPZZC|{gO1iiU;w6 zT$X&j#(CzT93zxVUPoW<#;mB7UgW128R-=^k*hRM(k`7VPt{I2jA|nUpt-mJVbcQO zKir#8-LmJPeu2!8b*GM~m#II14os1B>L~PE5`JR7ChTM&j-KWr&+@71LIB_@TJ!}37Qn7y~oRRYn zXph{D$$2*a6Qx}4#_TD}Uqt#23PEr;M%eSWie;AEjTw8Hzmq6yLVHj0z1gVEP_fzk zxw0mAV>T-C7h$wMY~=G>v#~gY@0Wj@FiS$*1M|&Nmb)=whNOPP-whj8`GeVWXxJE^ zpN8qiurVn=hmEGNA$Macn^Q)}H15WfKp)N( zxm&i2{ugDl=couYa!A+6WOELo%-)&R>O$y?i&kcD8fstMh%$TAQu}=>iw9w_KWJ_Q&cLG~N`qtdmDg zipf^DB0gK13HL#nOYhJldu2%1*`zD8U;mJ@v$4T4Af)bWQdc_Xob23lvRhA6JII_( zY@Fb>4hcP*gjUI7Wk_t;D~ITTA!Qe%TeNz?ppcMDFkQ5I&NfQwrSL%tHaO(wG8E6! z<~Hqe?8y9(%`(L{IF!p8Hu2>i@~oi0er-y8s`@+j(Lj@-1N853b^QKBJGYhl_43TN znL{$8x6K?-)S7II5BBOgT4j|Wt(1~k$#(RY+^R4rwTXv)qOvHxhtzTH;?^*8>G^t~ z-Z~V=n-oWh>S{np*qcP2nX`4s!<(q>rF~n6yob$IY<{ZLW!}UjZ&?Q)LTSH8nRnH1 z@a>8w^L~g>o0QE5YX|es4&7#$l22Ucg4~cSb?HrEp{cn`?p?e8_FE~;0Z<{$t zp629cd6H~*qxMiDlt#P4b;}ZZ1Owem@5XGr&COhTl{&>ohCFVWA(OggPpU#Dw+zQy zX3ofv%Plix^EcW%GGsH|?jl-Jrd!#*f%8o9mSs(%)X&uw${mDWGI+@ zL;4QX_PB89q?VX@w<;VO`(`*cbTI4?4vkd3Xmxf}D2n|kMO~nXM};z8 z84RnLjtWJ*$~NburF6KJ(kzPbh_G>+&OSqN1)u;PfPFKSbF0^>7_d_kn)a2 z`qv->?~s^ZXSP=K6J|;FqJH0*pnnsl>EHXnNc|h7)4_y+f~i0s0Uvdqu(6;*O?hH8 zwG(qhs?c}ho8CHA?0lHkTS;T*!v###w$q7W&#a-`}pRU>rv*{o;UX0xHqc3GXAn<@Kx^JKdw zg`*Bb&FTMv)FQ2#I!kt8*pvp3aCrY*meX4k4(V{+O8;>T_X__|(Rl&wNjR}|*%IVf zOYf$*LrNyE(;f{@;iR=o7q!*WE*WmPXd9ikKD{POHQBX7ZLaL|K)3Tf%xaSII>!q$S^{$ZHYgpy=bNcwjG zou|?w)LCdOJ7jL>07~yJ>)V|ehB8g+5QZ{Lg_FNI0%_L{z4b>R;VqF#X0zH`zv84V zvj*T6I+HA5wIIrYh5AX(szJZvWMyUz(5#>2td<7cpA|h&lCru$zhE7>D#&NEx-Q@X zR(I)FoUF>M0bU65*{t3OIFA)~q{Yed%o>1Gl+w;>BmIJPpntkivErDKP)^Zrg!9@vjdQUAk2+Beg$JXxNU|6|J)$$&L%^7y}XvLg9(%%_7YcUcbKs%JKun_0C zAezUDy&BR-`E=}_5O&XJ#f^X3&Y*c=#{mnpN~4?qyzq@6-H#PMFU3h~W)1K`Drfac zl#{eHK?lSbNkwXHUgzFfNixR3u@2@XjK<*HmmRI7fJyL-p0vnRwOCN zJJZ%ts8~ZRYq7kziB2Qv&>~%kDAs7i7cp7lJ%HXLvf`^RqNfzuWfVm>EIoW`!Ct&RY`$Xb0gI1)cp^)#}$ZIU+ec=_kbj zYrd=Pyb`3ed8!*_stK0PpD!@HKK8F?kb;U`0W(^P~5=`c>`cshWatZ{8 z>0}Noz9%A+VHL7BC!>{mlVoLCW(}}Okk4h+E68Ofmcdj7pA}3Tz-n&51Iacy)P;p| zBa|?P;UTU?clatwR)^`A*1uQSMoO_-VYI?AmhC*rVdzW!RC}!UGeh&%KnLo#kuF`G z4>oHM74*{_K&+VBZvzcPJn6UwP9)gVL6~Ko8dwkwASM*O&APW>MN$#R?C`9YS{Tz& zZpi+mpDLUc$=_H(N=fa|@EEoxW~p0{s}aT>8`^b=#q6>Al_m$BlRcQ%OX-6Aa{W}( ztbV3nxU~Tu4)Xn3{W{2x%B%tY9OMVH!dX4&1EedH?9ZxLISq24mwuA7(j9*)2k=sq zoYgKtuEq&W4e~iNw4!u^9iLu=?r1wz@tq%{K7iFF0S_cM!A(9{pu260i#x-x{QEG> z8@)bIc6!S4U1q51z}=)5ji z=ExPssdtP>S5+}EG#!xMF=ky=7sg&nEKH{fNXMybq+dhx;*`V4SfT1t-3y`8i!aP% zip$Cwzg|?nmHsc+Tt=OebSyi2v*ntjz(%?s9rV*t?~&0wTHS`&DGT})L0{I?QJ*P3 zsywUh^71ZWyQp|YIs0?vrTSlrRJOaWr+Y+*u_$O%1j}iR#X%Cs*^@R#+7o-qX=<@s z6!Ma$CnFC5G?5=oOvS}!vqy(K6Vg-^?0Ea#L;4bD|L9;Rqkb(?pXQqX#Ubx$N{U^H z6^F1TXi^%b8s4~BqE%6OFNMmM_tgKA^4|KNDc?l@)0AhhW~GPqGSU~ezgNC-2$ANP z8apK9b?cCp^6)>VmvaC2=_PDTZ(2fWKKLKfTijgUSG<|!68%{7mK)7^KstQtsM``N zFGAFZ+V2}|q;;8=$Wi5#zM6&pr{$j3Zc(U-jI~ATtei3md0$b!xwbb6|BK7}h>r@j zky^}_=OigE?;hmDoz``GNDtq#uy8iBe zAoW_EHEkq0!^y*_d>dNtMw-V7F2aNvwJpsW-M+!F^bIG>_;(W@bc~o^e`13T#?{BU z8ak~oLx7)H!6tQB6y`Z_Gdi>}Er^?aLc{89N(7rF^dWFAFQ9@Fx|!mvoVBeDH@t>ViZLaW*n*c#-s$w5p$1(B3j=> zn5rb5;3J)YWJN=5`;u>;WTEq-oKD2DzE$!cXIxot-j9x%7?|0`=AqD)xn`+mJ)jnt z+#}2n;|GM>+$>>6h&pES2$O8kszbA_SMI`eEg^fc5<|_)=HgLRHs6Gs|H0;D`EQ;- z$W1~KCZAE0QWL1wVc0pB$~WeH=_t5#I*%|3jGNmgWI9ZPkxqM4SR9UPn0o0nl7_YhO}?R5mi2X1Vwn6Tov(!HAv)#(>6rG#Po)v&_^}y4)|(ZF+UG53 zp`JNW(wR?)G)zU4&eEe9gF2=*>6l|EJw)|Co$luUcuJUb8Xsax=dPjo`l*A`xoR{w zPOIvFz3Erd`9o}Ck)^sTZ71ZO8dPCTN@c z=eX9}!Gtd5UiuBtZ?=AfLr!nDUjGF-a|aR*`9l5r>WBUj`bB;EqxH-clp8&V$z2lIJy%>KGp;Dqld22cn_0fpZ>T$Ca3q01vwn!rLT?!IUM7q*NugE;cdi-=zWWIP3IR2 zVc}?Vozr<;tlprYgX`Yz;sN>%N2rCcaDT0l(>ce29M)UwAg6bU1vwncbGcY%gM6hp zwjZV+i1K5^y`_VF9Aj9p14sQIIyoHM&sE|WmaaAy!ooeY#^w`F4#zhCyqM}kpYFKL zP5&ctOxxeZF%6%KSMSUBPSFZSLC&Z?^1|KEG&oSA_$ zFasO`6?8yQR0KpsRMbH+K~YKZKX#a51{fI_VunAaB^Vl-75+;tN;6Hd$Vqq-K^^^%irg{_Il1dGlHNuzjkkTz0N-Sz1Dixv)5jG?X~xQ_F8LK zgsPJH`Tw6dClZaHxq1O7h&lXJ7<2eJLCxXk6)i929@m;VmAJr~BmPkHXpMii7A^>D zv_`&c|CFEjd0NcjUt}Jw@h{Ut!_F8J(y#0l|3Ud_NREr~cB3+Ge!O+jy;r=YvHST_ zdsoYXiMo?n7}n(*weETNc<6~wYVmnO(yi~!Qnk0n)Y&?_@AY@}rSOQWd~q{i^F*;P zbnw89(vs2=$c@pG(sIjj(M-8hkei?--6mid(`kC95FXQVLt|+h;eq;-YtdqQD9@A@ zU9MeA8V@+-n#KvRx?s%Aa;vpiT5fbq=NdTXf4vL8z=gA4d~XjoTMP3I@y7ZT$LJ^g z8m-TYOkO@5`7*6P6Zs2T(|rJW_}h^ggY#op+sbMEO5_@?x#=OCVmu}CP%)jO31>Io z8@WMzDJ=chYkhBIUcx>TnODPyDIS?QTACyCX7VgpI;Ts|*^y_6FLvP{ci|f&&yoz& zi=&hGPu!HChcde}@*MHAPDWKf$egI~%E)uYyTOuUuK0su_&kO4E|G9vbIeF3tImzGB4^5(Lx@$FwKk1 z1#2CweP5?MZ;0W%`Pmp5`P(A%=I2|HzoIoSO3=w0p1xXO-s%(`?;e@AI?Pjq%xJBT ziX8IenEF9}YPE)K4!5y{EA3RRX#x3e;AowJmaX7+U}^xh1d?zCxNuo{R1NNAaEEg`7x4*3!DgYbdErt z8~ElZ!~VeqP8_+#QRZ^3-xp;jC>$=tcIj*GwBpKMsjV>2#i-(JUkIVxF{Rha~ z6v@N3FT9{fo`;3H$UH=B4@;i%hizX*L>V3m4vI33l7TG`^e#Xr4;t-}dAK+qmd+N* z!?y2NL>V3;J{M&cNd_*&w)6{8hI9A6DAO((xDeaehoTG*6hDhBk>mwf+g%p95Zht; zixb|ZaJVoGX?+VfrsaX9FXxnGRx2E~JntCKH6Bv-i89nR*vf$y;*D}I=V5e9X@JapiP*J%Bj$g~5*5&lK3?~lww$D@&XFyS3PGCW+o z7?}qO{DeQLHEjpX1H~SZ_tJVoWNwD>Bg2COk_wcbB6?M$Pw)<-yIs2=hsXgwz~ zI!}&FTXkw=+KMw_mD_ri8*F8JUXh53`?0nM1^(wGN2)5&2#Cyp|-`O_#vljnig_yETTJ3iVmou5qpRLAVQg)er@ zzFYVij?Z;`vE$1ff7UVAEYowZ<7XYe==i@JSLs+<+5wJtaJ;)?Mpv2qRL93UE;;5} zX7X1!zSi-V9pB~nA;&*<{G8(#9sieO-r(DInOn|yN5{K6-p4V0@l2k3PUEGH>ECDJ z=Q_T~@x6|}@AzrQFFO9S<7&0ProZTTgyV6J_jeq=TN}@X(DN#C=*AZLOecSy#U-tl>kN2u{KJ$pFb&+%c7!}nL?el2z3 zXED&#D;gekWA&zG_nPXh|32@BwDPr=>GyPI0)8%BYcYHe> zw|k!p|Be_v+*kb2$@~=7f_u(||JLy2S|IUTK z?80Aj;W-&gEk6St4~OG+cXxb{lR4al9}UNSKhg1W$JfGf-*0x|w}{zy?(x1$c--!z zPX1{Z{)`L%wG02V4an24>`Wv@dJ+k zKUfRy=Pvx;#B7)Q(pL$O`cplBn0%e%?cgZ0qYK~7g^zdP2RP=dN|tsW9P{5ICJ$}O zLzj~|+wq4TU*h;vjz8!4MmXyKlGyY==wyE2_+Om-K)tQ8w4)r)b$kXK%kyiFA9ef_ z$A59mF$l+6YwdEGRZYrV=a}avllRX}JGt;(9P_MX^7gExpk#j+evsoCj%PVO*6|6B zd5LWLn;o|~Ug8*=yUD-L@mj~{IKIH~2FF)8{*>cu9AEGFOOC(l_)f=nJN}O2haEre z_({jlIsRA2*xGD=|Lizbduri%$90bRc7Vxj=a^?13+MU8m`Mwa_ji1d-ajyk2!waagEMn%R{YW!Yq7<5=$HR2ZD-|;q%w{<+m@mR;$8%+;$ zZW$lt_!!677)^$`L5y1+b4|5yo;QtGIzHDi&!Hy6bExqr9DmO74UWI=nCDYV`+dhe zpIZ1+j(_I(-yHwi@ym{1am-{XrnBI9pyR=gdHyx|-5l@fcyGs39XC4W8QJvkKFIhu z$0s?S=NOx^$uD-ys4)v)?f6W`A9Va7#~U19;`p$nhhNf9&`v$G>v? zqT`nxzv8$;&*Qd_RgU{P9^jZ6VoZJ)$9p;6$MGSKu|HT^W|lE7IbPuSG{;?zS35q- z@dq9A-4N6NQOAt1vT*De#>{ME%(q31?{ti3wB- zm~+dx;JD~`sN)?S@8ozl$KxFD<9L6^2RnY3-c2H?{U1)@nXk(55@LtrDN9fa7V7k8pgn<7UUq1!OvxIA(4j3t#7Wy<;XT zGMP_0{;cEc9DmXAR~+Br7#o-Ayx;Ldj+qC^WPaxOMaRE){EFjO9oOr*+4K}0Gog}& z@9miRl`I@Pm@(5W8P9XP(D7o&*uhMGwd1oKf6(y-jyE{I%<(53U*i}%n{De$j=$>o zPRDmUHv5|%nUaTH_~VYBbo`9tUpW4asZ0%-8^9W1z1Ee6V;#KKBhM4_Jc~@bmT8eY#D_)h z5+50v{#VCF#s+gzWbE*z$Y+UpwngU#EsG;_{=GNyM)9i1*kj%wnORIe82PJW`rDxA zb}bABfaxD~MP&M1F&Kbw8pmrRV|TeRGJU4L9C@Vp*2sH^?}~hY_`b*oiyw+SUCdm* z=%+u`k0YNX{z>Fh#Qz$3p7`G*w}}53nR@+~$g9PC_Z6LM#5@bb9~2LW{9&;szzg9U z#PnrE2HOmM9bx)#@+=HrBi<+Sb>age(=Y3g$hV5=V}$(e;-e#Dr{VdR@NbEE=7sMU z^UMp=pNjzo@RQ;*BL7UhHu7`g4@ah7=!KE#=XF`+SH+)+oKt!5oQqESf87*$p!lni zL%-R`y!-f8KLM;;}9IP%WoA4H}f*^`l5#Qzc*Tg&s2&ldkW@`uDPMW){UDKdS% zUX4sYE}o0YGw=LsB3~!&ADMbrjEt>iyU2Hn8zSE?-Z?V;!kE+=oj(;%j7(p!DUq21 z<-o|l6;F@+pW?$Kzb2j?nZ9GkN2YJs+{nYk&5`LtyD0LmV&3(W2l|xpObyeQ?0u2< z7q5v-U$YNIrcQk%GJWbUj*K1UipbQdPeooL#_{gToN+DT+AfawDaNB5^WMb5xsNgC z9>th@5#xD|+a0fVyv{N2GA!*z$JaZ)#qr&azvq~D5T@sO$1gd4)p3okF(zMh+~9bu zW3J66Kix6cV+-fqf$<{8U5?i{zQ8fpV@rFDW3J5>ey8IH9rIqmWS({W8^>ICO(v&f zZd~tpm}9PmCNs%#qhqdrCUc_W7RSpRbKNp|-W?cU;`l1ZUvPYz<8M2D%<)ehzu@>~ z$6U8;yG$Z$Jk;?h#}gb+bsYL)NiS}W3+I|-I_dXo9IiuAew_>FdSfyh9bfPG7RPrx z{+?s56Q<{R$1geNdSEhK1B{D~8ysVYHyQc>8&7vU+wok-iyU`3UgP)z$Co?4#xebS zZM(GT#t%Av-0`!Hf8!Y2xTVdhO*F1|OnYtNV;pBkdCUI|647avsOb%ElKyGm%qa`O z(Ul!;3_i`+tPZ=hQ*?tTJ#n;W3KqU`@E4L&!U2^C%$Mti)d9=3t@yzSy(iEDVyc|g?_g3o5RlA zkC*<@*|zAT?DbuKi2ApyqX7D3!YJ!&7F!x&@`ySOf7y1*#jS9R+y~U5_{_dg=1j*j zdHr@TI9m4r_1ShgUc|9JM~kHqCV$>3Ng9CYEN+ebUf)kk**FyTLtP`v`gq50X@tpk zqjW#yj-AC_64Nvygqx>v5j9!r`*L||M=iE$h^`j@-vksLNzb_0c(v;47+O?ikKvriVldChP^wpFi%y6E+d z(Rq%I#hmGj->_W3utz>FyQObf?m2PdzLOhpTmFXS^}B0p$^_>=qn3t+;m^Ud#lOkZ z!UqufeBO&ywRLL~J}1eC|CCa34Ocg0L621aEcar5w2W5eI6j>C=F>GL_vnd&&n`~* zYSjJy{1bO1W1na~G}(SdVfq8Fz1Doy!fdN;X{|oD*f!v2l`rQ0S{*Z2b=ByLH<7=_ z#~WhyIL@2H!PU?-%2hH2SUIQ4r|;d3? z+gYq?^7j!~Q@xrE9FC6cdu}{pSJW;hl&AB``U{ZDBD3N{74I`(0&+U5B#_zeEM=s;{+;~A>{+`<_Qp)$-j%3RpRW9-~ z!E6M5{&0BBfCXrpMV|E$ggp>C8c$B&a~q=dsS*l1qVKsqE!OwkKA}}sVspTx@GKdK z-*fvo8jj~ayr%Fk@Cn#s`JNk^YHrpaOH^5xW7Ms_=SJc5V-%ad=SF=k{6dQJU7_k0 z)Q~3K-*cm8460VH`JUT2t&0=c1^b@c-fZ-YbiS@|xgyUh(Nj}o5M=b!7JovX?R#$1 z*}z#TJpziw+t6m;bE`#xea{WcpuXpZ@uU1bx0`k88ddxwG3(QNE5C5x&4b`rWZK^`koub zKBGuM=zDII>#SmbRDUWRquqY8_y=M>9m?SO;x|ZhW%_F=c%g`J{;Hsw@44}u)9)+F zyuRo59%Ui>o?9sO&3w;|Sr_uRa<5fe_!L>Y4Yu#O-6ehXg^#iM_&v7+*x+3preOs} z73J@tRy7nD#go79JZ*DS;Ra;xzfC-*FbbUy{!~1+FjoKhhp_F~_uSBL-*Y3EJ-_Gn zGq(GKS0z8aP)ph$)~Yz{dv2tiQJBVd6TIIpDQ3Vne1>lxAZ+X>c=qiYcH;1w}z*al)XV;(I4M) zJ5}+;(E9BZI4K^&4%_$KPAAFeP?7ka8?~!0ht5G$rJV1%-H3wz(x&gZ!ATMOv%cqs zr>b}cp2l>VB5Jd*!yS^g$fNJM5%vuU#q18+QN_vk-2RG2IuPo6ZlOgk^7f$oJ-2Dv zRejHmn403@eMoh7YaarGUBmJ=AdOY?$w>65__uLR0Q>4Fa{2M)+VLtM-WPn8-_tMdX68?-SJ2C zcdn!q;o5}6q$XTYsbTssOok$YWFwk#z*5uFB>blF

  • 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 z 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

  • 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 {64~y)J1VQ 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 z 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ⅈIbSIlpG#pW`_=H0)|!!=5Ni{g6}^BY{T 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阔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

    Hfl_hsejZ$iRFwES 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